Changes from APPLIANCE_HEAD:
[ira/wip.git] / docs / yodldocs / smb.conf.5.yo
index 31adf6dadafc6710dacee2dfee2455457b69bbd5..a8574cc4d0a8363dcefaf5f1d12e199fd2c0c03d 100644 (file)
@@ -451,8 +451,7 @@ the connection is allowed as the corresponding user.
 
 eit() Step 4: If the client has previously validated a
 username/password pair with the server and the client has passed the
-validation token then that username is used. This step is skipped if
-link(bf("revalidate = yes"))(revalidate) for this service.
+validation token then that username is used. 
 
 eit() Step 5: If a link(bf("user = "))(user) field is given in the
 smb.conf file for the service and the client has supplied a password,
@@ -542,6 +541,8 @@ it() link(bf(encrypt passwords))(encryptpasswords)
 
 it() link(bf(getwd cache))(getwdcache)
 
+it() link(bf(hide local users))(hidelocalusers)
+
 it() link(bf(homedir map))(homedirmap)
 
 it() link(bf(hosts equiv))(hostsequiv)
@@ -670,6 +671,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)
@@ -746,6 +749,10 @@ it() link(bf(syslog))(syslog)
 
 it() link(bf(syslog only))(syslogonly)
 
+it() link(bf(template homedir))(templatehomedir)
+
+it() link(bf(template shell))(templateshell)
+
 it() link(bf(time offset))(timeoffset)
 
 it() link(bf(time server))(timeserver)
@@ -768,6 +775,12 @@ it() link(bf(utmp directory))(utmpdirectory)
 
 it() link(bf(valid chars))(validchars)
 
+it() link(bf(winbind cache time))(winbindcachetime)
+
+it() link(bf(winbind gid))(winbindgid)
+
+it() link(bf(winbind uid))(winbinduid)
+
 it() link(bf(wins hook))(winshook)
 
 it() link(bf(wins proxy))(winsproxy)
@@ -946,6 +959,8 @@ it() link(bf(printable))(printable)
 
 it() link(bf(printer))(printer)
 
+it() link(bf(printer admin))(printer admin)
+
 it() link(bf(printer driver))(printerdriver)
 
 it() link(bf(printer driver location))(printerdriverlocation)
@@ -964,8 +979,6 @@ it() link(bf(read list))(readlist)
 
 it() link(bf(read only))(readonly)
 
-it() link(bf(revalidate))(revalidate)
-
 it() link(bf(root postexec))(rootpostexec)
 
 it() link(bf(root preexec))(rootpreexec)
@@ -1993,8 +2006,8 @@ This is an bf(EXPERIMENTAL) parameter that is part of the unfinished
 Samba NT Domain Controller Code. It may be removed in a later release.
 To work with the latest code builds that may have more support for
 Samba NT Domain Controller functionality please subscribe to the
-mailing list bf(Samba-ntdom) available by sending email to
-email(listproc@samba.org)
+mailing list bf(Samba-ntdom) available by visiting the web page at
+url(http://lists.samba.org/)(http://lists.samba.org/)
 
 label(domainadminusers) 
 dit(bf(domain admin users (G)))
@@ -2003,8 +2016,8 @@ This is an bf(EXPERIMENTAL) parameter that is part of the unfinished
 Samba NT Domain Controller Code. It may be removed in a later release.
 To work with the latest code builds that may have more support for
 Samba NT Domain Controller functionality please subscribe to the
-mailing list bf(Samba-ntdom) available by sending email to
-email(listproc@samba.org)
+mailing list bf(Samba-ntdom) available by visiting the web page at
+url(http://lists.samba.org/)(http://lists.samba.org/)
 
 label(domaingroups)
 dit(bf(domain groups (G)))
@@ -2013,8 +2026,8 @@ This is an bf(EXPERIMENTAL) parameter that is part of the unfinished
 Samba NT Domain Controller Code. It may be removed in a later release.
 To work with the latest code builds that may have more support for
 Samba NT Domain Controller functionality please subscribe to the
-mailing list bf(Samba-ntdom) available by sending email to
-email(listproc@samba.org)
+mailing list bf(Samba-ntdom) available by visiting the web page at
+url(http://lists.samba.org/)(http://lists.samba.org/)
 
 label(domainguestgroup)
 dit(bf(domain guest group (G)))
@@ -2023,8 +2036,8 @@ This is an bf(EXPERIMENTAL) parameter that is part of the unfinished
 Samba NT Domain Controller Code. It may be removed in a later release.
 To work with the latest code builds that may have more support for
 Samba NT Domain Controller functionality please subscribe to the
-mailing list bf(Samba-ntdom) available by sending email to
-email(listproc@samba.org)
+mailing list bf(Samba-ntdom) available by visiting the web page at 
+url(http://lists.samba.org/)(http://lists.samba.org/)
 
 label(domainguestusers)
 dit(bf(domain guest users (G)))
@@ -2033,8 +2046,8 @@ This is an bf(EXPERIMENTAL) parameter that is part of the unfinished
 Samba NT Domain Controller Code. It may be removed in a later release.
 To work with the latest code builds that may have more support for
 Samba NT Domain Controller functionality please subscribe to the
-mailing list bf(Samba-ntdom) available by sending email to
-email(listproc@samba.org)
+mailing list bf(Samba-ntdom) available by visiting the web page at
+url(http://lists.samba.org/)(http://lists.samba.org/)
 
 label(domainlogons)
 dit(bf(domain logons (G)))
@@ -2563,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
 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)
 dit(bf(homedir map (G)))
 
@@ -4732,6 +4757,19 @@ dit(bf(printcap (G)))
 
 Synonym for link(bf(printcapname))(printcapname).
 
+label(printer admin)
+dit(bf(printer admin (S)))
+
+This is a list of users that can do anything to printers via the
+remote administration interfaces offered by MSRPC (usually using a NT
+workstation). Note that the root user always has admin rights.
+
+  bf(Default:)
+tt(     printer admin = <empty string>)
+
+  bf(Example:)
+tt(    printer admin = admin, @staff)
+
 label(printcapname)
 dit(bf(printcap name (G)))
 
@@ -4817,7 +4855,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.
@@ -4870,10 +4908,10 @@ command"))(lprmcommand) if specified in the link(bf([global]))(global)
 section.
 
 Currently eight printing styles are supported. They are
-bf("printing=BSD"), bf("printing=AIX"), bf("printing=LPRNG"),
-bf("printing=PLP"),
-bf("printing=SYSV"),bf("printing="HPUX"),bf("printing=QNX") and
-bf("printing=SOFTQ").
+bf("printing=BSD"), bf("printing=AIX"), 
+bf("printing=LPRNG"), bf("printing=PLP"), bf("printing=SYSV"), 
+bf("printing="HPUX"), bf("printing=QNX"), bf("printing=SOFTQ"),
+and bf("printing=CUPS").
 
 To see what the defaults are for the other print commands when using
 the various options use the url(bf("testparm"))(testparm.1.html) program.
@@ -4882,6 +4920,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)))
 
@@ -5170,28 +5224,6 @@ tt(     restrict anonymous = false)
   bf(Example:)
 tt(     restrict anonymous = true)
 
-label(revalidate)
-dit(bf(revalidate (S)))
-
-Note that this option only works with
-link(bf("security=share"))(securityequalshare) and will be ignored if
-this is not the case.
-
-This option controls whether Samba will allow a previously validated
-username/password pair to be used to attach to a share. Thus if you
-connect to tt(\\server\share1) then to tt(\\server\share2) it won't
-automatically allow the client to request connection to the second
-share as the same username as the first without a password.
-
-If bf("revalidate") is tt("True") then the client will be denied
-automatic access as the same username.
-
-  bf(Default:)
-tt(    revalidate = False)
-
-  bf(Example:)
-tt(    revalidate = True)
-
 label(root)
 dit(bf(root (G)))
 
@@ -6153,6 +6185,32 @@ system syslog only, and not to the debug log files.
   bf(Default:)
 tt(    syslog only = no)
 
+label(templatehomedir)
+dit(bf(template homedir (G)))
+
+NOTE: this parameter is only available in Samba 3.0.
+
+When filling out the user information for a Windows NT user, the
+url(bf(winbindd))(winbindd.8.html) daemon uses this parameter to fill in
+the home directory for that user.  If the string tt(%D) is present it is
+substituted with the user's Windows NT domain name.  If the string tt(%U)
+is present it is substituted with the user's Windows NT user name.
+
+  bf(Default:)
+tt(     template homedir = /home/%D/%U)
+
+label(templateshell)
+dit(bf(template shell (G)))
+
+NOTE: this parameter is only available in Samba 3.0.
+
+When filling out the user information for a Windows NT user, the
+url(bf(winbindd))(winbindd.8.html) daemon uses this parameter to fill in
+the login shell for that user.
+
+  bf(Default:)
+tt(     template shell = /bin/false)
+
 label(timeoffset)
 dit(bf(time offset (G)))
 
@@ -6479,6 +6537,50 @@ tt(no utmp directory)
   bf(Example:)
 tt(utmp directory = /var/adm/)
 
+label(winbindcachetime)
+dit(winbind cache time)
+
+NOTE: this parameter is only available in Samba 3.0.
+
+This parameter specifies the number of seconds the
+url(bf(winbindd))(winbindd.8.html) daemon will cache user and group
+information before querying a Windows NT server again.
+
+  bf(Default:)
+tt(     winbind cache type = 15)
+
+label(winbindgid)
+dit(winbind gid)
+
+NOTE: this parameter is only available in Samba 3.0.
+
+The winbind gid parameter specifies the range of group ids that are
+allocated by the url(bf(winbindd))(winbindd.8.html) daemon.  This range of
+group ids should have no existing local or nis groups within it as strange
+conflicts can occur otherwise.
+
+  bf(Default:)
+tt(     winbind gid = <empty string>)
+
+  bf(Example:)
+tt(     winbind gid = 10000-20000)
+
+label(winbinduid)
+dit(winbind uid)
+
+NOTE: this parameter is only available in Samba 3.0.
+
+The winbind uid parameter specifies the range of user ids that are
+allocated by the url(bf(winbindd))(winbindd.8.html) daemon.  This range of
+ids should have no existing local or nis users within it as strange
+conflicts can occur otherwise.
+
+  bf(Default:)
+tt(     winbind uid = <empty string>)
+
+  bf(Example:)
+tt(     winbind uid = 10000-20000)
+
 label(validchars)
 dit(bf(valid chars (G)))