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

added documentation for 'private dir' parameter

Browse Source
This commit is contained in:
Gerald Carter -
parent a89957e205
commit aa9c9fec9d
3 changed files with 2359 additions and 2310 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4539
docs/htmldocs/smb.conf.5.html
View File

File diff suppressed because it is too large Load Diff

110
docs/manpages/smb.conf.5
View File

@ -86,7 +86,7 @@ write access to the path \f(CW/home/bar\fP\&. The share is accessed via
the share name "foo":
.PP
.nf
.DS
@ -95,7 +95,7 @@ the share name "foo":
writeable = true
.fi
.DE
.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):
.PP
.nf
.DS
[aprinter]
@ -115,7 +115,7 @@ as the default guest user (specified elsewhere):
printable = true
guest ok = true
.fi
.DE
.PP
@ -175,13 +175,13 @@ section can specify, though some make more sense than others\&. The
following is a typical and suitable [homes] section:
.IP
.nf
.DS
[homes]
writeable = yes
.fi
.DE
.IP
@ -237,7 +237,7 @@ directory with the sticky bit set on it\&. A typical \fB[printers]\fP entry
would look like this:
.IP
.nf
.DS
[printers]
@ -245,7 +245,7 @@ would look like this:
guest ok = yes
printable = yes
.fi
.DE
.IP
@ -256,10 +256,10 @@ pseudo-printcap\&. This is a file consisting of one or more lines like
this:
.IP
.nf
.DS
alias|alias|alias|alias\&.\&.\&.
.fi
.DE
.IP
@ -377,7 +377,7 @@ negotiation\&. It can be one of CORE, COREPLUS, LANMAN1, LANMAN2 or NT1\&.
machine\&. Only some are recognized, and those may not be 100%
reliable\&. It currently recognizes Samba, WfWg, WinNT and
Win95\&. Anything else will be known as "UNKNOWN"\&. If it gets it wrong
then sending a level 3 log to samba@samba\&.org
then sending a level 3 log to \fIsamba@samba\&.org\fP
should allow it to be fixed\&.
.IP
.IP o
@ -777,6 +777,9 @@ parameter for details\&. Note that some are synonyms\&.
\fBprinter driver file\fP
.IP
.IP o
\fBprivate dir\fP
.IP
.IP o
\fBprotocol\fP
.IP
.IP o
@ -1992,7 +1995,7 @@ interesting things\&.
.IP
\fBExample:\fP
.nf
.DS
default service = pub
@ -2000,7 +2003,7 @@ interesting things\&.
[pub]
path = /%S
.fi
.DE
.IP
@ -2137,26 +2140,26 @@ and remaining space will be used\&.\fP
Where the script dfree (which must be made executable) could be:
.IP
.nf
.DS
#!/bin/sh
df $1 | tail -1 | awk \'{print $2" "$4}\'
.fi
.DE
.IP
or perhaps (on Sys V based systems):
.IP
.nf
.DS
#!/bin/sh
/usr/bin/df -k $1 | tail -1 | awk \'{print $3" "$5}\'
.fi
.DE
.IP
@ -2795,13 +2798,13 @@ files"\fP and \fB"case sensitive"\fP\&.
.IP
\fBDefault\fP
.nf
.DS
No files or directories are hidden by this option (dot files are
hidden by default because of the "hide dot files" option)\&.
.fi
.DE
.IP
@ -4479,20 +4482,20 @@ debug"\fP\&.
.IP
\fBExample:\fP
.nf
.DS
passwd chat = "*Enter OLD password*" %o\en "*Enter NEW password*" %n\en "*Reenter NEW password*" %n\en "*Password changed*"
.fi
.DE
.IP
\fBDefault:\fP
.nf
.DS
passwd chat = *old*password* %o\en *new*password* %n\en *new*password* %n\en *changed*
.fi
.DE
.IP
@ -4744,12 +4747,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:
.IP
.nf
.DS
preexec = csh -c \'echo \e"Welcome to %S!\e" | /usr/local/samba/bin/smbclient -M %m -I %I\' &
.fi
.DE
.IP
@ -4934,7 +4937,7 @@ to obtain a printer list\&.
A minimal printcap file would look something like this:
.IP
.nf
.DS
print1|My Printer 1
@ -4943,7 +4946,7 @@ A minimal printcap file would look something like this:
print4|My Printer 4
print5|My Printer 5
.fi
.DE
.IP
@ -5003,7 +5006,7 @@ this is not set, the default is :
.IP
\f(CWSAMBA_INSTALL_DIRECTORY/lib/printers\&.def\fP
.IP
This file is created from Windows 95 \f(CW"msprint\&.def"\fP files found on
This file is created from Windows 95 \f(CW"msprint\&.inf"\fP files found on
the Windows 95 client system\&. For more details on setting up serving
of printer drivers to Windows 95 clients, see the documentation file
in the docs/ directory, PRINTER_DRIVER\&.txt\&.
@ -5065,6 +5068,21 @@ This option can be set on a per printer basis
.IP
See also the discussion in the \fB[printers]\fP section\&.
.IP
.IP "\fBprivate dir(G)\fP"
.IP
The \fBprivate dir\fP parameter allows an administator to define a
directory path used to hold the various databases Samba will use
to store things like a the machine trust account information
when acting as a domain member (i\&.e\&. where the secrets\&.tdb file will
be located), where the passdb\&.tbd file will stored in the case
of using the experiemental tdbsam support, etc\&.\&.\&.
.IP
\fBDefault:\fP
\f(CW private dir = <compile time location of smbpasswd>\fP
.IP
\fBExample:\fP
\f(CW private dir = /etc/smbprivate\fP
.IP
.IP "\fBprotocol (G)\fP"
.IP
The value of the parameter (a string) is the highest protocol level
@ -5797,7 +5815,7 @@ You may find that on some systems Samba will say "Unknown socket
option" when you supply an option\&. This means you either incorrectly
typed it or you need to add an include file to includes\&.h for your OS\&.
If the latter is the case please send the patch to
samba@samba\&.org\&.
\fIsamba@samba\&.org\fP\&.
.IP
Any of the supported socket options may be combined in any way you
like, as long as your OS allows it\&.
@ -6464,13 +6482,13 @@ information on how this parameter determines access to the services\&.
.IP
\fBExamples:\fP
.nf
.DS
username = fred
username = fred, mary, jack, jane, @users, @pcgroup
.fi
.DE
.IP
@ -6554,13 +6572,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\&.
.IP
.nf
.DS
!sys = mary fred
guest = *
.fi
.DE
.IP
@ -6676,14 +6694,14 @@ is a pointless thing to do as it\'s already there) you could do one of
the following
.IP
.nf
.DS
valid chars = Z
valid chars = z:Z
valid chars = 0132:0172
.fi
.DE
.IP
@ -6700,13 +6718,13 @@ See also the \fB"client code page"\fP parameter\&.
.IP
\fBDefault:\fP
.nf
.DS
Samba defaults to using a reasonable set of valid characters
for English systems
.fi
.DE
.IP
@ -6718,7 +6736,7 @@ them\&.
.IP
NOTE: It is actually quite difficult to correctly produce a \fB"valid
chars"\fP line for a particular system\&. To automate the process
tino@augsburg\&.net has written a package called \fB"validchars"\fP
\fItino@augsburg\&.net\fP has written a package called \fB"validchars"\fP
which will automatically produce a complete \fB"valid chars"\fP line for
a given client system\&. Look in the examples/validchars/ subdirectory
of your Samba source code distribution for this package\&.
@ -6782,7 +6800,7 @@ sensitive"\fP\&.
Example 1\&.
.IP
.nf
.DS
@ -6792,14 +6810,14 @@ Example 1\&.
veto files = /*Security*/*\&.tmp/*root*/
.fi
.DE
.IP
Example 2\&.
.IP
.nf
.DS
Veto the Apple specific files that a NetAtalk server
@ -6807,7 +6825,7 @@ Example 2\&.
veto files = /\&.AppleDouble/\&.bin/\&.AppleDesktop/Network Trash Folder/
.fi
.DE
.IP
@ -7027,14 +7045,14 @@ permitting), but only via spooling operations\&.
.IP
\fBExamples:\fP
.nf
.DS
read only = no
writeable = yes
write ok = yes
.fi
.DE
.IP
@ -7073,7 +7091,7 @@ This man page is correct for version 2\&.0 of the Samba suite\&.
.SH "AUTHOR"
.PP
The original Samba software and related utilities were created by
Andrew Tridgell samba@samba\&.org\&. Samba is now developed
Andrew Tridgell \fIsamba@samba\&.org\fP\&. Samba is now developed
by the Samba Team as an Open Source project similar to the way the
Linux kernel is developed\&.
.PP
@ -7082,7 +7100,7 @@ sources were converted to YODL format (another excellent piece of Open
Source software, available at
\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
and updated for the Samba2\&.0 release by Jeremy Allison\&.
samba@samba\&.org\&.
\fIsamba@samba\&.org\fP\&.
.PP
See \fBsamba (7)\fP to find out how to get a full
list of contributors and details on how to submit bug reports,

20
docs/yodldocs/smb.conf.5.yo
View File

@ -669,6 +669,8 @@ it() link(bf(printcap name))(printcapname)
it() link(bf(printer driver file))(printerdriverfile)
it() link(bf(private dir))(privatedir)
it() link(bf(protocol))(protocol)
it() link(bf(read bmpx))(readbmpx)
@ -4839,7 +4841,7 @@ this is not set, the default is :
tt(SAMBA_INSTALL_DIRECTORY/lib/printers.def)
This file is created from Windows 95 tt("msprint.def") files found on
This file is created from Windows 95 tt("msprint.inf") files found on
the Windows 95 client system. For more details on setting up serving
of printer drivers to Windows 95 clients, see the documentation file
in the docs/ directory, PRINTER_DRIVER.txt.
@ -4904,6 +4906,22 @@ This option can be set on a per printer basis
See also the discussion in the link(bf([printers]))(printers) section.
label(privatedir)
dit(bf(private dir(G)))
The bf(private dir) parameter allows an administator to define a
directory path used to hold the various databases Samba will use
to store things like a the machine trust account information
when acting as a domain member (i.e. where the secrets.tdb file will
be located), where the passdb.tbd file will stored in the case
of using the experiemental tdbsam support, etc...
bf(Default:)
tt( private dir = <compile time location of smbpasswd>)
bf(Example:)
tt( private dir = /etc/smbprivate)
label(protocol)
dit(bf(protocol (G)))