1
0
mirror of https://github.com/samba-team/samba.git synced 2025-01-15 23:24:37 +03:00

Changes from APPLIANCE_HEAD:

source/docs/yodldocs/smb.conf.5.yo
    source/docs/manpages/smb.conf.5
    source/docs/htmldocs/smb.conf.5.html
		- add documentation for "hide local users" config option.
This commit is contained in:
David O'Neill -
parent 44dc339fe7
commit a578bdb669
3 changed files with 2341 additions and 2317 deletions

File diff suppressed because it is too large Load Diff

View File

@ -1,4 +1,4 @@
.TH "smb\&.conf " "5" "23 Oct 1998" "Samba" "SAMBA" .TH "smb\&.conf " "5" "10 Jan 2001" "Samba" "SAMBA"
.PP .PP
.SH "NAME" .SH "NAME"
smb\&.conf \- The configuration file for the Samba suite smb\&.conf \- The configuration file for the Samba suite
@ -86,7 +86,7 @@ write access to the path \f(CW/home/bar\fP\&. The share is accessed via
the share name "foo": the share name "foo":
.PP .PP
.DS .nf
@ -95,7 +95,7 @@ the share name "foo":
writeable = true writeable = true
.DE .fi
.PP .PP
@ -106,7 +106,7 @@ is via calls to open, write to and close a spool file\&. The
as the default guest user (specified elsewhere): as the default guest user (specified elsewhere):
.PP .PP
.DS .nf
[aprinter] [aprinter]
@ -115,7 +115,7 @@ as the default guest user (specified elsewhere):
printable = true printable = true
guest ok = true guest ok = true
.DE .fi
.PP .PP
@ -175,13 +175,13 @@ section can specify, though some make more sense than others\&. The
following is a typical and suitable [homes] section: following is a typical and suitable [homes] section:
.IP .IP
.DS .nf
[homes] [homes]
writeable = yes writeable = yes
.DE .fi
.IP .IP
@ -237,7 +237,7 @@ directory with the sticky bit set on it\&. A typical \fB[printers]\fP entry
would look like this: would look like this:
.IP .IP
.DS .nf
[printers] [printers]
@ -245,7 +245,7 @@ would look like this:
guest ok = yes guest ok = yes
printable = yes printable = yes
.DE .fi
.IP .IP
@ -256,10 +256,10 @@ pseudo-printcap\&. This is a file consisting of one or more lines like
this: this:
.IP .IP
.DS .nf
alias|alias|alias|alias\&.\&.\&. alias|alias|alias|alias\&.\&.\&.
.DE .fi
.IP .IP
@ -585,6 +585,9 @@ parameter for details\&. Note that some are synonyms\&.
\fBgetwd cache\fP \fBgetwd cache\fP
.IP .IP
.IP o .IP o
\fBhide local users\fP
.IP
.IP o
\fBhomedir map\fP \fBhomedir map\fP
.IP .IP
.IP o .IP o
@ -1995,7 +1998,7 @@ interesting things\&.
.IP .IP
\fBExample:\fP \fBExample:\fP
.DS .nf
default service = pub default service = pub
@ -2003,7 +2006,7 @@ interesting things\&.
[pub] [pub]
path = /%S path = /%S
.DE .fi
.IP .IP
@ -2140,26 +2143,26 @@ and remaining space will be used\&.\fP
Where the script dfree (which must be made executable) could be: Where the script dfree (which must be made executable) could be:
.IP .IP
.DS .nf
#!/bin/sh #!/bin/sh
df $1 | tail -1 | awk \'{print $2" "$4}\' df $1 | tail -1 | awk \'{print $2" "$4}\'
.DE .fi
.IP .IP
or perhaps (on Sys V based systems): or perhaps (on Sys V based systems):
.IP .IP
.DS .nf
#!/bin/sh #!/bin/sh
/usr/bin/df -k $1 | tail -1 | awk \'{print $3" "$5}\' /usr/bin/df -k $1 | tail -1 | awk \'{print $3" "$5}\'
.DE .fi
.IP .IP
@ -2798,13 +2801,13 @@ files"\fP and \fB"case sensitive"\fP\&.
.IP .IP
\fBDefault\fP \fBDefault\fP
.DS .nf
No files or directories are hidden by this option (dot files are No files or directories are hidden by this option (dot files are
hidden by default because of the "hide dot files" option)\&. hidden by default because of the "hide dot files" option)\&.
.DE .fi
.IP .IP
@ -2815,6 +2818,17 @@ The above example is based on files that the Macintosh SMB client
(DAVE) available from \fBThursby\fP creates for (DAVE) available from \fBThursby\fP creates for
internal use, and also still hides all files beginning with a dot\&. internal use, and also still hides all files beginning with a dot\&.
.IP .IP
.IP "\fBhide local users(G)\fP"
.IP
This parameter toggles the hiding of local UNIX users (root, wheel, floppy, etc)
from remote clients\&.
.IP
\fBDefault:\fP
\f(CW hide local users = No\fP
.IP
\fBExample:\fP
\f(CW hide local users = Yes\fP
.IP
.IP "\fBhomedir map (G)\fP" .IP "\fBhomedir map (G)\fP"
.IP .IP
If \fB"nis homedir"\fP is true, and If \fB"nis homedir"\fP is true, and
@ -4482,20 +4496,20 @@ debug"\fP\&.
.IP .IP
\fBExample:\fP \fBExample:\fP
.DS .nf
passwd chat = "*Enter OLD password*" %o\en "*Enter NEW password*" %n\en "*Reenter NEW password*" %n\en "*Password changed*" passwd chat = "*Enter OLD password*" %o\en "*Enter NEW password*" %n\en "*Reenter NEW password*" %n\en "*Password changed*"
.DE .fi
.IP .IP
\fBDefault:\fP \fBDefault:\fP
.DS .nf
passwd chat = *old*password* %o\en *new*password* %n\en *new*password* %n\en *changed* passwd chat = *old*password* %o\en *new*password* %n\en *new*password* %n\en *changed*
.DE .fi
.IP .IP
@ -4747,12 +4761,12 @@ An interesting example is to send the users a welcome message every
time they log in\&. Maybe a message of the day? Here is an example: time they log in\&. Maybe a message of the day? Here is an example:
.IP .IP
.DS .nf
preexec = csh -c \'echo \e"Welcome to %S!\e" | /usr/local/samba/bin/smbclient -M %m -I %I\' & preexec = csh -c \'echo \e"Welcome to %S!\e" | /usr/local/samba/bin/smbclient -M %m -I %I\' &
.DE .fi
.IP .IP
@ -4937,7 +4951,7 @@ to obtain a printer list\&.
A minimal printcap file would look something like this: A minimal printcap file would look something like this:
.IP .IP
.DS .nf
print1|My Printer 1 print1|My Printer 1
@ -4946,7 +4960,7 @@ A minimal printcap file would look something like this:
print4|My Printer 4 print4|My Printer 4
print5|My Printer 5 print5|My Printer 5
.DE .fi
.IP .IP
@ -6482,13 +6496,13 @@ information on how this parameter determines access to the services\&.
.IP .IP
\fBExamples:\fP \fBExamples:\fP
.DS .nf
username = fred username = fred
username = fred, mary, jack, jane, @users, @pcgroup username = fred, mary, jack, jane, @users, @pcgroup
.DE .fi
.IP .IP
@ -6572,13 +6586,13 @@ and map the rest to guest\&. Note the use of the \f(CW\'!\'\fP to tell Samba
to stop processing if it gets a match on that line\&. to stop processing if it gets a match on that line\&.
.IP .IP
.DS .nf
!sys = mary fred !sys = mary fred
guest = * guest = *
.DE .fi
.IP .IP
@ -6694,14 +6708,14 @@ is a pointless thing to do as it\'s already there) you could do one of
the following the following
.IP .IP
.DS .nf
valid chars = Z valid chars = Z
valid chars = z:Z valid chars = z:Z
valid chars = 0132:0172 valid chars = 0132:0172
.DE .fi
.IP .IP
@ -6718,13 +6732,13 @@ See also the \fB"client code page"\fP parameter\&.
.IP .IP
\fBDefault:\fP \fBDefault:\fP
.DS .nf
Samba defaults to using a reasonable set of valid characters Samba defaults to using a reasonable set of valid characters
for English systems for English systems
.DE .fi
.IP .IP
@ -6800,7 +6814,7 @@ sensitive"\fP\&.
Example 1\&. Example 1\&.
.IP .IP
.DS .nf
@ -6810,14 +6824,14 @@ Example 1\&.
veto files = /*Security*/*\&.tmp/*root*/ veto files = /*Security*/*\&.tmp/*root*/
.DE .fi
.IP .IP
Example 2\&. Example 2\&.
.IP .IP
.DS .nf
Veto the Apple specific files that a NetAtalk server Veto the Apple specific files that a NetAtalk server
@ -6825,7 +6839,7 @@ Example 2\&.
veto files = /\&.AppleDouble/\&.bin/\&.AppleDesktop/Network Trash Folder/ veto files = /\&.AppleDouble/\&.bin/\&.AppleDesktop/Network Trash Folder/
.DE .fi
.IP .IP
@ -7045,14 +7059,14 @@ permitting), but only via spooling operations\&.
.IP .IP
\fBExamples:\fP \fBExamples:\fP
.DS .nf
read only = no read only = no
writeable = yes writeable = yes
write ok = yes write ok = yes
.DE .fi
.IP .IP

View File

@ -541,6 +541,8 @@ it() link(bf(encrypt passwords))(encryptpasswords)
it() link(bf(getwd cache))(getwdcache) it() link(bf(getwd cache))(getwdcache)
it() link(bf(hide local users))(hidelocalusers)
it() link(bf(homedir map))(homedirmap) it() link(bf(homedir map))(homedirmap)
it() link(bf(hosts equiv))(hostsequiv) it() link(bf(hosts equiv))(hostsequiv)
@ -2574,6 +2576,18 @@ The above example is based on files that the Macintosh SMB client
(DAVE) available from url(bf(Thursby))(http://www.thursby.com) creates for (DAVE) available from url(bf(Thursby))(http://www.thursby.com) creates for
internal use, and also still hides all files beginning with a dot. internal use, and also still hides all files beginning with a dot.
label(hidelocalusers)
dit(bf(hide local users(G)))
This parameter toggles the hiding of local UNIX users (root, wheel, floppy, etc)
from remote clients.
bf(Default:)
tt( hide local users = No)
bf(Example:)
tt( hide local users = Yes)
label(homedirmap) label(homedirmap)
dit(bf(homedir map (G))) dit(bf(homedir map (G)))