smb.conf

If you decide to use a If you decide to use a path = line in your [homes] section then you may find it useful to use the %S macro. For example :

An important point is that if guest access is specified in the [homes] section, all home directories will be - visible to all clients without a password. In the very unlikely event that this is actually desirable, it - would be wise to also specify read only access.

Note that the Note that the browseable flag for auto home directories will be inherited from the global browseable flag, not the [homes] browseable flag. This is useful as - it means setting browseable = no in the [homes] section will hide the [homes] share but make any auto home directories visible.

All aliases given for a printer in the printcap file are legitimate printer names as far as the server is concerned. If your printing subsystem doesn't work like that, you will have to set up a pseudo-printcap. This is a file consisting of one or more lines like this:

Each alias should be an acceptable printer name for your printing subsystem. In the [global] section, specify @@ -479,29 +462,44 @@ NAME="AEN102" >parameters define the specific attributes of sections.

Some parameters are specific to the [global] section - (e.g., security). Some parameters are usable - in all sections (e.g., create mode). All others are permissible only in normal sections. For the purposes of the following descriptions the [homes] and [printers] - sections will be considered normal. The letter G in parentheses indicates that a parameter is specific to the - [global] section. The letter S indicates that a parameter can be specified in a service specific - section. Note that all S parameters can also be specified in the [global] section - in which case they will define the default behavior for all services.

the name of your NIS home directory server. This is obtained from your NIS auto.map entry. If you have - not compiled Samba with the --with-automount option then this value will be the same as %L.

controls if names that have characters that aren't of the "default" case are mangled. For example, if this is yes then a name like "Mail" would be mangled. - Default no.
controls whether filenames are case sensitive. If they aren't then Samba must do a filename search and match on passed - names. Default no.
controls what the default case is for new - filenames. Default lower.
controls if new files are created with the case that the client passes, or if they are forced to be the - "default" case. Default yes.
yes.

abort shutdown script (G)
This parameter only exists in the HEAD cvs branch This a full path name to a script called by that should stop a shutdown procedure issued by the
This command will be run as user.
Default: Default: None.
Example: will return an ACCESS_DENIED error to the client.
See also , ,
Default: Default: none
Example:
This parameter is only used for add file shares. To add printer shares, see the
See also , .
Default: Default: none
Example:
Default: add machine script = <empty string> +>add machine script = <empty string>
This is the full pathname to a script that will - be run AS ROOT by smbd to create the required UNIX users - ON DEMAND when a user accesses the Samba server.
In order to use this option, smbd - must NOT be set to smbd will - call the specified script AS ROOT, expanding any
See also , ,
Default: add user script = <empty string> +>add user script = <empty string>
This is the full pathname to a script that will - be run AS ROOT by
Default: Default: no admin users
Example: smbd(8) - AS ROOT. Any
Synonym for
This option only takes effect when the
This is a synonym for the smbd will use when authenticating a user. This option defaults to sensible values based on
Default: auth methods = <empty string>auth methods = <empty string>
Example: available = no, then , then ALL attempts to connect to the service will fail. Such failures are logged.
nmbd to bind to ports 137 and 138 on the interfaces listed in the interfaces parameter. smbd(8) to bind only to the interface list given in the interfaces parameter. This restricts the networks that bind interfaces only is set then - unless the network address 127.0.0.1 is added to the smbpasswd - by default connects to the localhost - 127.0.0.1 address as an SMB client to issue the password change request. If bind interfaces only is set then unless the - network address 127.0.0.1 is added to the nmbd at the address - 127.0.0.1 to determine if they are running. - Not adding 127.0.0.1 will cause smbd
See the
See the discussion in the section NAME MANGLING.
Synonym for case sensitive.
See also , .
Default: Default: none
Example:
If you want to set the string that is displayed next to the machine name then see the parameter.
Default: Default: No comment string
Example:
Default: Default: no value
Example:
A synonym for this parameter is not set here will be removed from the modes set on a file when it is created.
Following this Samba will bit-wise 'OR' the UNIX mode created from this parameter with the value of the
This parameter does not affect directory modes. See the parameter for details.
See also the parameter for forcing particular mode bits to be set on created files. See also the parameter for masking mode bits on created directories. See also the Note that this parameter does not apply to permissions set by Windows NT/2000 ACL editors. If the administrator wishes to enforce a mask on access control lists also, they need to set the
This is a synonym for csc policy (S)
This stands for This stands for client-side caching policy, and specifies how clients capable of offline caching will cache the files in the share. The valid values are: manual, documents, programs, disable.
Note that the parameter
Note that the parameter
Samba 2.2 debug log messages are timestamped by default. If you are running at a high
Note that the parameter
Synonym for
A synonym for
See the section on NAME MANGLING. Also note the
This parameter is only applicable to printable services. When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba @@ -6599,9 +6681,12 @@ NAME="DEFAULTSERVICE" >
This parameter specifies the name of a service which will be connected to if the service actually requested cannot - be found. Note that the square brackets are NOT given in the parameter value (see example below).
Typically the default service would be a ,
Example:
[global] @@ -6657,9 +6736,6 @@ CLASS="PROGRAMLISTING" [pub] path = /%S
This is the full pathname to a script that will - be run AS ROOT by will return an ACCESS_DENIED error to the client.
See also , ,
Default: Default: none
Example:
This parameter is only used to remove file shares. To delete printer shares, see the
See also , .
Default: Default: none
Example:
Default: delete user script = <empty string> +>delete user script = <empty string>
smbd(8) - AS ROOT. Any This option is used when Samba is attempting to delete a directory that contains one or more vetoed directories (see the
See also the
Synonym for
Note: Your script should Note: Your script should NOT be setuid or setgid and should be owned by (and writeable only by) root!
Default: Default: By default internal routines for determining the disk capacity and remaining space will be used.
Example:
Where the script dfree (which must be made executable) could be:
#!/bin/sh df $1 | tail -1 | awk '{print $2" "$4}'
or perhaps (on Sys V based systems):
#!/bin/sh /usr/bin/df -k $1 | tail -1 | awk '{print $3" "$5}'
Note that you may have to replace the command names @@ -7185,7 +7261,7 @@ NAME="DIRECTORY" >
Synonym for not set here will be removed from the modes set on a directory when it is created.
Following this Samba will bit-wise 'OR' the UNIX mode created from this parameter with the value of the Note that this parameter does not apply to permissions set by Windows NT/2000 ACL editors. If the administrator wishes to enforce a mask on access control lists also, they need to set the .
See the
See also the parameter for masking mode bits on created files, and the parameter.
Also refer to the
Synonym for
Note that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone "appliance" systems. @@ -7351,7 +7433,7 @@ CLASS="CONSTANT" >.
See also the , , Be very careful about enabling this parameter.
See also use client driver
See also the parameter yes, the Samba server will serve Windows 95/98 Domain logons for the to claim a special domain specific NetBIOS name that identifies it as a domain master browser for its given
If domain logons = yes. Experimentation is the best policy :-)
Default: Default: none (i.e., all directories are OK to descend)
Example: program for information on how to set up and maintain this file), or set the security = [server|domain|ads] parameter which causes
Default: Default: no enumports command
Example:
This is a synonym for
It is generally much better to use the real
This parameter specifies a set of UNIX mode bit - permissions that will always be set on a file created by Samba. This is done by bitwise 'OR'ing these bits onto the mode bits of a file that is being created or having its @@ -8117,7 +8211,7 @@ CLASS="PARAMETER" parameter is applied.
See also the parameter for details on masking mode bits on files.
See also the
This parameter specifies a set of UNIX mode bit - permissions that will always be set on a directory created by Samba. This is done by bitwise 'OR'ing these bits onto the mode bits of a directory that is being created. The default for this @@ -8177,7 +8274,7 @@ CLASS="PARAMETER" applied.
See also the parameter
See also the
Note that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone "appliance" systems. @@ -8242,7 +8342,7 @@ CLASS="EMPHASIS" it set as 0000.
See also the , ,
If the .
See also .
Default: Default: no forced group
Example:
Note that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone "appliance" systems. @@ -8386,7 +8492,7 @@ CLASS="EMPHASIS" this set to 0000.
See also the , ,
See also
Default: Default: no forced user
Example:
Synonym for
This is a username which will be used for access to services which are specified as
Default: Default: specified at compile time, usually "nobody"
Example: for a service, then no password is required to connect to the service. Privileges will be those of the .
See the section below on for a service, then only guest connections to the service are permitted. This parameter will have no effect if is not set for the service.
See the section below on
See also , and .
Default: Default: no file are hidden
Example:
If
NOTE :A working NIS client is required on the system for this option to work.
See also ,
Default: homedir map = <empty string>homedir map = <empty string>
Example:
See also the
Note that the localhost address 127.0.0.1 will always be allowed access unless specifically denied by a
You can also specify hosts by network/netmask pairs and by netgroup names if your system supports netgroups. The - EXCEPT keyword can also be used to limit a wildcard list. The following examples may provide some help:
for a way of testing your host access to see if it does what you expect.
Default: Default: none (i.e., all hosts permitted access)
Example: hosts allow - - hosts listed here are NOT permitted access to services unless the specific services have their own lists to override this one. Where the lists conflict, the list takes precedence.
Default: Default: none (i.e., no hosts specifically excluded)
Example:
This is not be confused with may be useful for NT clients which will not supply passwords to Samba.
NOTE : The use of option be only used if you really know what you are doing, or perhaps on a home network where you trust - your spouse and kids. And only if you really trust them :-).
Default: Default: no host equivalences
Example: .
Default: Default: no file included
Example:
The permissions on new files and directories are normally governed by , , and New files inherit their read/write bits from the parent directory. Their execute bits continue to be determined by , and as usual.
Note that the setuid bit is Note that the setuid bit is never set via inheritance (the code explicitly prohibits this).
See also , , and
See also .
Default: Default: all active interfaces except 127.0.0.1 that are broadcast capable
This is a list of users that should not be allowed - to login to this service. This is really a paranoid check to absolutely ensure an improper setting does not breach your security.
+&group+&group means check the UNIX group database, followed by the NIS netgroup database, and @@ -9524,7 +9675,7 @@ CLASS="PARAMETER" This is useful in the [homes] section. See also . Default: Default: no invalid users Example: Keepalives should, in general, not be needed if the socket being used has the SO_KEEPALIVE attribute set on it (see
For UNIXes that support kernel based has oplocked. This allows complete data consistency between - SMB/CIFS, NFS and local file access (and is a very cool feature :-).
See also the and
Default : Default : none
Default : ldap filter = (&(uid=%u)(objectclass=sambaAccount))ldap filter = (&(uid=%u)(objectclass=sambaAccount))
This option is used to define whether or not Samba should use SSL when connecting to the ldap server - This is NOT related to Samba's previous SSL support which was enabled by specifying the ldap suffix (G)
Default : Default : none
It specifies where users are added to the tree. Default : Default : none
Default : Default : none
For more discussions on level2 oplocks see the CIFS spec.Currently, if yes). Note also, the See also the and . See also If Samba is set to produce Lanman announce broadcasts needed by OS/2 clients (see the See also A boolean variable that controls whether all printers in the printcap will be loaded for browsing by default. See the printers section for more details. yes doesn't - mean that Samba will become the local master browser on a subnet, just that nmbd will will participate in elections for local master browser.Setting this value to nmbd - never to become a local master browser. Default:
Synonym for This option specifies the directory where lock files will be placed. The lock files are used to implement the The time in microseconds that smbd should pause before attempting to gain a failed lock. See , real locking will be performed by the server.
This option This option may be useful for read-only - filesystems which may not need locking (such as CDROM drives), although setting this parameter of
This parameter specifies the local path to which the home directory will be connected (see
Note that in prior versions of Samba, the Thereafter, the directories and any of the contents can, if required, be made read-only. It is not advisable that the NTuser.dat file be made read-only - rename it to NTuser.man to - achieve the desired effect (a MANdatory profile).
The script must be a relative path to the [netlogon] service. If the [netlogon] service specifies a This option is only useful if Samba is set up as a logon server.
Default: Default: no logon script defined
Example:
See also the A value of 0 will disable caching completely.
See also the
See also the parameter.
Default: Default: depends on the setting of printing
Example: This command should be a program or script which takes a printer name and job number to resume the print job. See also the
See also the
See also the parameter.
Default: Default: depends on the setting of
Example 1:
If a Samba server is a member of a Windows NT Domain (see the security = domain) parameter) then periodically a running , and the security = domain) parameter.
This parameter specifies the name of a file which will contain output created by a magic script (see the
Default: magic output = <magic script name>.out +>magic output = <magic script name>.out
If the script generates output, output will be sent to the file specified by the Note that some shells are unable to interpret scripts containing CR/LF instead of CR as the end-of-line marker. Magic scripts must be executable - as is on the host, which for some hosts and some shells will require filtering at the DOS end.
Magic scripts are Magic scripts are EXPERIMENTAL and - should NOT be relied upon.
Default: Default: None. Magic scripts disabled.
Example:
See the section on NAME MANGLING
off the ends of filenames on some CDROMs (only visible under some UNIXes). To do this use a map of (*;1 *;).
Default: Default: no mangled map
Example:
See the section on NAME MANGLING for details on how to control the mangling process.
Note that the character to use may be specified using the
This controls what character is used as - the magic character in name mangling. The default is a '~' but this may interfere with some software. Use this option to set @@ -11517,7 +11734,7 @@ CLASS="PARAMETER" > parameter to be set such that owner execute bit is not masked out (i.e. it must include 100). See the parameter to be set such that the world execute bit is not masked out (i.e. it must include 001). See the parameter to be set such that the group execute bit is not masked out (i.e. it must include 010). See the parameter
This parameter is only useful in security modes other than - Means user logins with an invalid password are treated as a guest login and mapped into the guest account. Note that this can cause problems as it means that any user incorrectly typing @@ -11678,9 +11895,12 @@ HREF="r1.html#GUESTACCOUNT" will not know the reason they cannot access files they think they should - there will have been no message given to them that they got their password wrong. Helpdesk services will - hate you if you set the modes other than share. This is because in these modes the name of the resource being - requested is not sent to the server until after the server has successfully authenticated the client so the server cannot make authentication decisions at the correct time (connection @@ -11743,7 +11966,7 @@ CLASS="PARAMETER" >
Record lock files are used to implement this feature. The lock files will be stored in the directory specified by the will remote "Out of Space" to the client. See all LANMAN1: First : First modern version of the protocol. Long filename support.
See also nmbd(8) when acting as a WINS server (
See also the xedit, then - removes it afterwards. NOTE THAT IT IS VERY IMPORTANT THAT THIS COMMAND RETURN IMMEDIATELY. That's why I have the '&' on the end. If it doesn't return immediately then your PCs may freeze when sending messages (they should recover @@ -12225,7 +12454,7 @@ CLASS="PARAMETER" >message command = /bin/mail -s 'message from %f on - %m' root < %s; rm %s
If you don't have a message command then the message @@ -12241,9 +12470,12 @@ CLASS="COMMAND" >message command = rm %s
Default: Default: no message command
Example:
Synonym for
See also , and
See also the The value of the parameter (a string) is the lowest SMB protocol dialect than Samba will support. Please refer to the
If you are viewing this parameter as a security measure, you should also refer to the nmbd(8) when acting as a WINS server (.
See also wins : Query a name with the IP address listed in the bcast : Do a broadcast on each of the known local interfaces listed in the
See also .
Default: Default: empty string (no additional names)
Example:
See also .
Default: Default: machine DNS name
Example:
Default: non unix account range = <empty string> +>non unix account range = <empty string>
list and is only really useful in shave level security.
See also the
A synonym for
DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ AND UNDERSTOOD THE SAMBA OPLOCK CODE.
Default: oplock contention limit (S)
This is a This is a very advanced to behave in a similar way to Windows NT.
DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ AND UNDERSTOOD THE SAMBA OPLOCK CODE.
Default:
Oplocks may be selectively turned off on certain files with a share. See the parameter for details.
See also the and in the local broadcast area.
Note :By default, Samba will win a local master browsing election over all Microsoft operating systems except a Windows NT 4.0/2000 Domain Controller. This @@ -13194,8 +13444,8 @@ NAME="OS2DRIVERMAP" path to a file containing a mapping of Windows NT printer driver names to OS/2 printer driver names. The format is:
<nt driver name> = <os2 driver - name>.<device name>
<nt driver name> = <os2 driver + name>.<device name> For example, a valid entry using the HP LaserJet 5 printer driver would appear as Default: os2 driver map = <empty string> +>os2 driver map = <empty string>
. It should be possible to enable this without changing your Default: panic action = <empty string>panic action = <empty string> Example: See also - The TDB based password storage backend. Takes a path to the TDB as an optional argument (defaults to passdb.tdb in the - The TDB based password storage backend, with non unix account support. Takes a path to the TDB as an optional argument (defaults to passdb.tdb in the directory. See also ) See also passwd chat (G) This string controls the This string controls the "chat" conversation that takes places between smbd(8) uses to determine what to send to the Note that this parameter only is only used if the yes. This - sequence is then called AS ROOT when the SMB password in the smbpasswd file is being changed, without access to the old password cleartext. This means that root must be able to reset the user's password without knowing the text of the previous password. In the presence of NIS/YP, this means that the passwd program must be executed on the NIS master. @@ -13593,7 +13849,7 @@ CLASS="CONSTANT" if the expect string is a full stop then no string is expected. If the See also , , and This boolean specifies if the passwd chat script - parameter is run in debug mode. In this mode the strings passed to and received from the passwd chat are printed in the smbd(8) log with a and should be turned off after this has been done. This option has no effect if the See also , , Also note that many passwd programs insist in Also note that many passwd programs insist in reasonable passwords, such as a minimum length, or the inclusion of mixed case chars and digits. This can pose a problem as some clients (such as Windows for Workgroups) uppercase the password before sending it. Note that if the yes then this program is called then this program is called AS ROOT before the SMB password in the unix password sync parameter - is set this parameter MUST USE ABSOLUTE PATHS - for ALL programs called, and must be examined for security implications. Note that by default . See also The name of the password server is looked up using the parameter NOTE: Using a password server means your UNIX box (running Samba) is only as secure as your - password server. DO NOT CHOOSE A PASSWORD SERVER THAT YOU DON'T COMPLETELY TRUST. Never point a Samba server at itself for password @@ -14018,7 +14298,7 @@ CLASS="PARAMETER" Primary or Backup Domain controllers to authenticate against by doing a query for the name WORKGROUP<1C>WORKGROUP<1C> and then contacting each server returned in the list of IP addresses from the name resolution source. See also the Default: password server = <empty string>password server = <empty string> Note that this path will be based on if one was specified. Default: Default: none Example: See also . Default: Default: none (no command executed) Example: postexec = echo \"%u disconnected from %S - from %m (%I)\" >> /tmp/log Of course, this could get annoying after a while :-)See also and . Default: Default: none (no command executed) Example: preexec = echo \"%u connected to %S from %m - (%I)\" >> /tmp/log This boolean option controls whether a non-zero return code from See also Synonym for Note that if you just want all printers in your printcap file loaded then the option is easier. Default: Default: no preloaded services Example: This controls if new filenames are created with the case that the client passes, or if they are forced to be the See the section on NAME MANGLING for a fuller discussion. %z - the size of the spooled print job (in bytes) The print command The print command MUST contain at least one occurrence of nobody account. If this happens then create an alternative guest account that can print and set the print command = echo Printing %s >> +>print command = echo Printing %s >> /tmp/print.log; lpr -P %p %s; rm %s You may have to vary this command considerably depending on how you normally print files on your system. The default for the parameter varies depending on the setting of the For printing = CUPS : If SAMBA is compiled against libcups, then printcap = cups uses the CUPS API to @@ -14671,7 +14966,7 @@ NAME="PRINTOK" > Synonym for Note that a printable service will ALWAYS allow writing to the service path (user privileges permitting) via the spooling of print data. The Synonym for /etc/printcap). See the discussion of the [printers] section above for reasons why you might want to do this. . This should be supplemented by an addtional setting printing = cups in the [global] section. A minimal printcap file would look something like this: print1|My Printer 1 @@ -14805,18 +15094,18 @@ CLASS="PROGRAMLISTING" print4|My Printer 4 print5|My Printer 5 where the '|' separates aliases of a printer. The fact that the second alias has a space in it gives a hint to Samba that it's a comment. NOTE: Under AIX the default printcap name is Default: printer admin = <empty string>printer admin = <empty string> printer driver (S) Note :This is a deprecated parameter and will be removed in the next major release following version 2.2. Please see the instructions in @@ -14896,7 +15188,7 @@ TARGET="_top" sensitive) that describes the appropriate printer driver for your system. If you don't know the exact string to use then you should first try with no See also printer driver file (G) Note :This is a deprecated parameter and will be removed in the next major release following version 2.2. Please see the instructions in @@ -14976,7 +15271,7 @@ CLASS="FILENAME" >. See also . Default: Default: None (set in compile). Example: printer driver location (S) Note :This is a deprecated parameter and will be removed in the next major release following version 2.2. Please see the instructions in @@ -15040,7 +15341,7 @@ CLASS="FILENAME" >. See also Default: Default: none (but may be lp on many systems) Example: Synonym for This option can be set on a per printer basis See also the discussion in the [printers] section. Synonym for Synonym for Default: Default: depends on the setting of Example: Default: Default: depends on the setting of This is a list of users that are given read-only access to a service. If the connecting user is in this list then they will not be given write access, no matter what the option is set to. The list can include group names using the syntax described in the parameter. See also the parameter and the Default: read list = <empty string>read list = <empty string> Example: An inverted synonym is printable = yes) - will ALWAYS allow writing to the directory (user privileges permitting), but only via spooling operations. In general this parameter should be viewed as a system tuning tool and left severely alone. See also Default: remote announce = <empty string> +>remote announce = <empty string> Default: remote browse sync = <empty string> +>remote browse sync = <empty string> Synonym for Synonym for root directory - option, including some files needed for complete operation of the server. To maintain full operability of the server you will need to mirror some system files @@ -15861,7 +16177,7 @@ CLASS="PARAMETER" (such as CDROMs) after a connection is closed. See also Default: root postexec = <empty string> +>root postexec = <empty string> See also and Default: root preexec = <empty string> +>root preexec = <empty string> parameter except that the command is run as root.See also and security = user, see the It is possible to use smbd in a in a hybrid mode where it is offers both user and share level security under different SECURITY = SHARE When clients connect to a share level security server they @@ -16088,9 +16410,12 @@ CLASS="COMMAND" >Note that smbd ALWAYS uses a valid UNIX user to act on behalf of the client, even in If the parameter is set, then all the other stages are missed and only the Is a username is sent with the share connection request, then this username (after mapping - see If the client did a previous If the client did a previous logon request (the SessionSetup SMB call) then the username sent in this SMB will be added as a potential username. Any users on the , then this guest user will be used, otherwise access is denied. Note that it can be Note that it can be very confusing in share-level security as to which UNIX username will eventually be used in granting access. See also the section NOTE ABOUT USERNAME/PASSWORD VALIDATION. SECURITY = USER This is the default security setting in Samba 2.2. With user-level security a client must first "log-on" with a valid username and password (which can be mapped using the parameter). Encrypted passwords (see the parameter) can also be used in this security mode. Parameters such as and Note that the name of the resource being - requested is not sent to the server until after the server has successfully authenticated the client. This is why guest shares don't work in user level security without allowing the server to automatically map unknown users into the . See the parameter for details on doing this. See also the section NOTE ABOUT USERNAME/PASSWORD VALIDATION. SECURITY = SERVER In this mode Samba will try to validate the username/password @@ -16335,9 +16678,12 @@ CLASS="FILENAME" > for details on how to set this up. Note that from the client's point of view Note that the name of the resource being - requested is not sent to the server until after the server has successfully authenticated the client. This is why guest shares don't work in user level security without allowing the server to automatically map unknown users into the . See the parameter for details on doing this. See also the section NOTE ABOUT USERNAME/PASSWORD VALIDATION. See also the parameter and the SECURITY = DOMAIN This mode will only work correctly if smbpasswd(8) has been used to add this machine into a Windows NT Domain. It expects the Note that a valid UNIX user must still exist as well as the account on the Domain Controller to allow Samba to have a valid UNIX account to map file access to. Note that from the client's point of view . It only affects how the server deals with the authentication, it does not in any way affect what the client sees. Note that the name of the resource being - requested is not sent to the server until after the server has successfully authenticated the client. This is why guest shares don't work in user level security without allowing the server to automatically map unknown users into the . See the parameter for details on doing this. BUG: There is currently a bug in the implementation of See also the section NOTE ABOUT USERNAME/PASSWORD VALIDATION. See also the parameter and the Note that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone @@ -16570,7 +16943,7 @@ CLASS="CONSTANT" >. See also the , , This option gives full share compatibility and enabled by default. You should You should NEVER turn this parameter off as many Windows applications will break if you do so. . This option can be use with preserve case = yes See the section on NAME MANGLING. parameter will always cause the OpenPrinterEx() on the server - to fail. Thus the APW icon will never be displayed. Note :This does not prevent the same user from having administrative privilege on an individual printer. See also , , shutdown script (G) This parameter only exists in the HEAD cvs branch This a full path name to a script called by %r will be substituted with the - switch -r. It means reboot after shutdown for NT. %f will be substituted with the - switch -f. It means force the shutdown even if applications do not respond for NT. Default: Default: None. Example: Shutdown script example: - #!/bin/bash @@ -16945,15 +17330,12 @@ CLASS="PROGRAMLISTING" /sbin/shutdown $3 $4 +$time $1 & Shutdown does not return so we need to launch it in background. See also Those marked with a Those marked with a '*' take an integer argument. The others can optionally take a 1 or 0 argument to enable or disable the option, by default they will be enabled if you @@ -17181,9 +17566,12 @@ CLASS="COMMAND" >SAMBA_NETBIOS_NAME = myhostname Default: Default: No default value Examples: This variable controls controls whether samba will try to use Simple and Protected NEGOciation (as specified by rfc2478) with WindowsXP and Windows2000sp2 clients to agree upon an authentication mechanism. As of samba 3.0alpha it must be set to "no" for these clients to join a samba domain controller. It can be set to "yes" to allow samba to participate in an AD domain controlled by a Windows2000 domain controller. Default: Default: use spnego = yes See also the See also the Synonym for passwd programparameter is called parameter is called AS ROOT - to allow the new UNIX password to be set without access to the old UNIX password (as the SMB password change code has no access to the old password cleartext, only the new). See also , . In order for this parameter to work correctly the If this parameter is enabled for a printer, then any attempt to open the printer with the PRINTER_ACCESS_ADMINISTER right is mapped to PRINTER_ACCESS_USE instead. Thus allowing the OpenPrinterEx() - call to succeed. This parameter MUST not be able enabled on a print share which has valid print driver installed on the Samba server. See also disable spoolss NOTE: The use of Synonym for Synonym for To restrict a service to a particular set of users you can use the See the section NOTE ABOUT USERNAME/PASSWORD VALIDATION for more information on how @@ -18036,7 +18436,7 @@ HREF="r1.html#AEN236" >Default: The guest account if a guest service, - else <empty string>. Examples: !sys = mary fred guest = * Note that the remapping is applied to all occurrences @@ -18207,7 +18598,7 @@ CLASS="CONSTANT" >fred. The only exception to this is the username passed to the Default: Default: no username map Example: See also the . It specifies a directory pathname that is used to store the utmp or utmpx files (depending on the UNIX system) that record user connections to a Samba server. See also the /var/run/utmp on Linux). Default: Default: no utmp directory Example: /var/run/wtmp on Linux). Default: Default: no wtmp directory Example: . This is useful in the [homes] section. See also Default: Default: No valid users list (anyone can login) Example: Each entry must be a unix path, not a DOS path and - must not include the unix directory separator '/'. fail unless you also set the See also and . Default: Default: No files or directories are vetoed. Examples:Examples:; Veto any files containing the word Security, ; any ending in .tmp, and any directory containing the @@ -18530,9 +18936,6 @@ veto files = /*Security*/*.tmp/*root*/ ; Veto the Apple specific files that a NetAtalk server ; creates. veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/ This parameter is only valid when the parameter. Default: Default: No files are vetoed for oplock grants You might want to do this on files that you know will @@ -18626,9 +19032,12 @@ NAME="VFSOBJECT" with a VFS object. The Samba VFS layer is new to Samba 2.2 and must be enabled at compile time with --with-vfs. Default : Default : no value . Default : Default : no value Default: Default: the name of the share system call will not return any data. Warning: Turning off user enumeration may cause some programs to behave oddly. For example, the finger program relies on having access to the @@ -18811,9 +19229,12 @@ CLASS="COMMAND" > system call will not return any data. Warning: Turning off group enumeration may cause some programs to behave oddly. Default: winbind gid = <empty string> +>winbind gid = <empty string> Default: winbind uid = <empty string> +>winbind uid = <empty string> Default: winbind use default domain = <no> +>winbind use default domain = <no> You should point this at your WINS server if you have a multi-subnetted network. NOTE. You need to set up Samba to point to a WINS server if you have multiple subnets and wish cross-subnet browsing to work correctly. in the docs/ directory of your Samba source distribution. Default: Default: not enabled Example: nmbd to be your WINS server. - Note that you should NEVER set this to yesThis controls what workgroup your server will appear to be in when queried by clients. Note that this parameter also controls the Domain name used with the security = domain setting. Default: Default: set at compile time to WORKGROUP Example: Synonym for If this integer parameter is set to non-zero value, Samba will create an in-memory cache for each oplocked file - (it does not do this for non-oplocked files). All writes that the client does not request to be flushed directly to disk will be stored in this cache if possible. @@ -19210,7 +19646,7 @@ NAME="WRITELIST" >This is a list of users that are given read-write access to a service. If the connecting user is in this list then they will be given write access, no matter what the See also the Default: write list = <empty string> +>write list = <empty string> Inverted synonym for Inverted synonym for