smb.conf

There are three special sections, [global], [homes] and [printers], which are - described under special sections. The following notes apply to ordinary section descriptions.

Sections may be designated Sections may be designated guest services, in which case no password is required to access them. A specified - UNIX guest account is used to define access privileges in this case.

The following sample section defines a printable share. The share is readonly, but printable. That is, the only write access permitted is via calls to open, write to and close a - spool file. The guest ok parameter means access will be permitted as the default guest user (specified elsewhere):

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 @@ -462,44 +481,29 @@ 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.

%S: the name of the current service, if any.
%P: the root directory of the current service, - if any.
%u: user name of the current service, if any.
%g: primary group name of %u.
%U: primary group name of %U.
%H: the home directory of the user given - by %u.
%v: the Samba version.
%h
%N: 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.
%p: the path of the service's home directory, - obtained from your NIS auto.map entry. The NIS auto.map entry - is split up as "%N:%p".
%R: the current date and time.
%D: Name of the domain or workgroup of the current user.
%$(

The following substitutes apply only to some configuration options(only those + that are used when a connection has been established):

There are some quite creative things that can be done with these substitutions and other smb.conf options.

NAME MANGLING 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.

By default, Samba 2.2 has the same semantics as a Windows +>By default, Samba 3.0 has the same semantics as a Windows NT server, in that it is case insensitive but case preserving.

NOTE ABOUT USERNAME/PASSWORD VALIDATIONCOMPLETE LIST OF GLOBAL PARAMETERS ldap trust ids COMPLETE LIST OF SERVICE PARAMETERS msdfs proxy EXPLANATION OF EACH PARAMETER abort shutdown script (G)This parameter only exists in the HEAD cvs branch This a full path name to a script called by This command will be run as user. Default: Default: None. Example: Default: Default: none Example: . 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 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 This specifies the major and minor version numbers that nmbd will use when announcing itself as a server. The default - is 4.2. Do not change this parameter unless you have a specific + is 4.9. Do not change this parameter unless you have a specific need to set a Samba server to be a downlevel server. Default: announce version = 4.5announce version = 4.9 Example: 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. This global parameter allows the Samba admin - to limit what interfaces on a machine will serve SMB requests. If + to limit what interfaces on a machine will serve SMB requests. It affects file service interfaces list. IP Source address spoofing - does defeat this simple check, however so it must not be used + does defeat this simple check, however, so it must not be used seriously as a security feature for nmbdbind 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 If this parameter is set and the lock range requested - cannot be immediately satisfied, Samba 2.2 will internally + cannot be immediately satisfied, samba will internally queue the lock request, and periodically attempt to obtain the lock until the timeout period expires. no, then - Samba 2.2 will behave as previous versions of Samba would and + samba will behave as previous versions of Samba would and will fail the lock request immediately if the lock range cannot be obtained. See the discussion in the section NAME MANGLING. . Default: Default: none Example: parameter. Default: Default: No comment string Example: Default: Default: no value Example: not set here will be removed from the modes set on a file when it is created. 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. debug timestamp (G) Samba 2.2 debug log messages are timestamped +>Samba debug log messages are timestamped by default. If you are running at a high See the section on NAME MANGLING. Also note the 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). Example: [global] @@ -6736,6 +6693,9 @@ CLASS="PROGRAMLISTING" [pub] path = /%S This is the full pathname to a script that will - be run AS ROOT by Default: Default: none Example: . Default: Default: none Example: Default: delete user script = <empty string> +>delete user script = <empty string> smbd(8) - AS ROOT. Any 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 @@ -7286,12 +7246,9 @@ NAME="DIRECTORYMASK" calculated according to the mapping from DOS modes to UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may be thought of as a bit-wise MASK for - the UNIX modes of a directory. Any bit not set here will be removed from the modes set on a directory when it is created. 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. @@ -7511,12 +7465,9 @@ NAME="DISABLESPOOLSS" Wizard or by using the NT printer properties dialog window. It will also disable the capability of Windows NT/2000 clients to download print drivers from the Samba host upon demand. - Be very careful about enabling this parameter. workgroup it is in. Samba 2.2 also +> it is in. Samba 2.2 has limited capability to act as a domain controller for Windows NT 4 Domains. For more details on setting up this feature see the Samba-PDC-HOWTO included in the . Experimentation is the best policy :-) Default: Default: none (i.e., all directories are OK to descend) Example: Default: Default: no enumports command Example: 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 @@ -8254,12 +8196,9 @@ NAME="FORCEDIRECTORYMODE" > 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 @@ -8329,12 +8268,9 @@ NAME="FORCEDIRECTORYSECURITYMODE" allows a user to modify all the user/group/world permissions on a directory without restrictions. 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. @@ -8444,12 +8380,9 @@ CLASS="PARAMETER" >. 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. @@ -8563,12 +8493,9 @@ CLASS="PARAMETER" > Default: Default: no forced user Example: lp(1). This paramater does not accept % macros, because +>This parameter does not accept % macros, because many parts of the system require this value to be constant for correct operation. Default: Default: specified at compile time, usually "nobody" Example: . Default: Default: no file are hidden Example: NOTE :A working NIS client is required on the system for this option to work. Default: homedir map = <empty string>homedir map = <empty string> Example: 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: 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: as usual. Note that the setuid bit is Note that the setuid bit is never set via inheritance (the code explicitly prohibits this). . 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 @@ -9685,12 +9570,9 @@ CLASS="PARAMETER" >. Default: Default: no invalid users Example: has oplocked. This allows complete data consistency between - SMB/CIFS, NFS and local file access (and is a very cool feature :-). 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 On = Always use SSL when contacting the - ldap serverOff. = Never use SSL when querying the directory. OffStart_tls = Never use SSL when querying the directory. = Use the LDAPv3 StartTLS extended operation + (RFC2830) for communicating with the directory server. Start_tlsOn = Use the LDAPv3 StartTLS extended operation - (RFC2830) for communicating with the directory server. = + Use SSL on the ldaps port when contacting the + ldap server. Only + available when the backwards-compatiblity --with-ldapsam option is specified + to configure. See passdb backend Default : ldap ssl = onldap ssl = start_tls ldap suffix (G) Default : Specifies where user and machine accounts are added to the tree. Can be overriden by ldap user suffix and ldap machine suffix. It also used as the base dn for all ldap searches. Default : none It specifies where users are added to the tree. Default : Default : none Default : Default : none ldap trust ids (G) Normally, Samba validates each entry + in the LDAP server against getpwnam(). This allows + LDAP to be used for Samba with the unix system using + NIS (for example) and also ensures that Samba does not + present accounts that do not otherwise exist. This option is used to disable this functionality, and + instead to rely on the presence of the appropriate + attributes in LDAP directly, which can result in a + significant performance boost in some situations. + Setting this option to yes effectivly assumes + that the local machine is running nss_ldap against the + same LDAP server. Default: ldap trust ids = No level2 oplocks (S) 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: , 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 smb.conf file. This parameter has been - extended since 2.2.x series, now it allow to specify the debug + extended since the 2.2.x series, now it allow to specify the debug level for multiple debug classes. This is to give greater flexibility in the configuration of the system. 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). This option is only useful if Samba is set up as a logon server. Default: Default: no logon script defined Example: parameter. Default: Default: depends on the setting of printing Example: parameter. Default: Default: depends on the setting of Example 1: Default: magic output = <magic script name>.out +>magic output = <magic script name>.out 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. Default: mangling method = hash2 Example: mangling method = hash mangle prefix (G) controls the number of prefix + characters from the original name used when generating + the mangled names. A larger value will give a weaker + hash and therefore more name collisions. The minimum + value is 1 and the maximum value is 6. Default: mangle prefix = 1 Example: mangling method = hash2mangle prefix = 4 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 @@ -11895,12 +11787,9 @@ HREF="#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 @@ -12174,12 +12060,9 @@ CLASS="CONSTANT" >LANMAN1: First : First modern version of the protocol. Long filename support. 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 @@ -12454,7 +12334,7 @@ CLASS="PARAMETER" >message command = /bin/mail -s 'message from %f on - %m' root < %s; rm %sIf you don't have a message command then the message @@ -12470,12 +12350,9 @@ CLASS="COMMAND" >message command = rm %s Default: Default: no message command Example: msdfs proxy (S) This parameter indicates that the share is a + stand-in for another CIFS share whose location is specified by + the value of the parameter. When clients attempt to connect to + this share, they are redirected to the proxied share using + the SMB-Dfs protocol. Only Dfs roots can act as proxy shares. Take a look at the + msdfs root + and + host msdfs + options to find out how to set up a Dfs root share. Example: msdfs proxy = \otherserver\someshare msdfs root (S) msdfs:serverA\shareA,serverB\shareB - and so on. For more information on setting up a Dfs tree +>msdfs:serverA\shareA,serverB\shareB + and so on. For more information on setting up a Dfs tree on Samba, refer to . Default: Default: empty string (no additional names) Example: . Default: Default: machine DNS name Example: Default: non unix account range = <empty string> +>non unix account range = <empty string> list will be allowed. By default this option is disabled so that a client can supply a username to be used by the server. Enabling - this parameter will force the server to only user the login + this parameter will force the server to only use the login names from the list and is only really useful in shave levelshare level security. 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: 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 @@ -13444,8 +13343,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> Default: panic action = <empty string>panic action = <empty string> Example: This option allows the administrator to chose which backends to retrieve and store passwords with. This allows (for example) both smbpasswd and tdbsam to be used without a recompile. - Multiple backends can be specified, seperated by spaces. The backends will be searched in the order they are specified. New users are always added to the first backend specified. + Multiple backends can be specified, separated by spaces. The backends will be searched in the order they are specified. New users are always added to the first backend specified. Experimental backends must still be selected (eg --with-tdbsam) at configure time. ldap://localhost) Note: In this module, any account without a matching POSIX account is regarded + as 'non unix'. See also non unix account rangenon unix account + range LDAP connections should be secured where + possible. This may be done using either + Start-TLS (see ldap ssl) or by + specifying ldaps:// in + the URL argument. + passwd chat (G)This string controls the This string controls the "chat" conversation that takes places between 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 @@ -13921,12 +13838,9 @@ NAME="PASSWDCHATDEBUG" >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 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 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 @@ -14298,11 +14191,17 @@ 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. If the list of servers contains both names and the '*' + character, the list is treated as a list of preferred + domain controllers, but an auto lookup of all remaining DC's + will be added to the list as well. Samba will not attempt to optimize + this list by locating the closest DC. If the Default: password server = <empty string>password server = <empty string> Example: password server = NT-PDC, NT-BDC1, NT-BDC2 +>password server = NT-PDC, NT-BDC1, NT-BDC2, * if one was specified. Default: Default: none Example: . Default: Default: none (no command executed) Example: postexec = echo \"%u disconnected from %S - from %m (%I)\" >> /tmp/log . Default: Default: none (no command executed) Example: preexec = echo \"%u connected to %S from %m - (%I)\" >> /tmp/log option is easier. Default: Default: no preloaded services Example: 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 print command = echo Printing %s >> +>print command = echo Printing %s >> /tmp/print.log; lpr -P %p %s; rm %s A minimal printcap file would look something like this: print1|My Printer 1 @@ -15094,18 +14984,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 @@ -15222,12 +15109,9 @@ NAME="PRINTERDRIVERFILE" >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 @@ -15280,12 +15164,9 @@ CLASS="PARAMETER" >. 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 @@ -15375,16 +15253,13 @@ NAME="PRINTERNAME" name given will be used for any printable service that does not have its own printer name specified. Default: Default: none (but may be lp on many systems) Example: Default: Default: depends on the setting of Example: Default: Default: depends on the setting of Default: read list = <empty string>read list = <empty string> Example: printable = yes) - will ALWAYS allow writing to the directory (user privileges permitting), but only via spooling operations. Default: remote announce = <empty string> +>remote announce = <empty string> Default: remote browse sync = <empty string> +>remote browse sync = <empty string> restrict anonymous (G)This is a boolean parameter. If it is yes, then - anonymous access to the server will be restricted, namely in the - case where the server is expecting the client to send a username, - but it doesn't. Setting it to yes will force these anonymous - connections to be denied, and the client will be required to always - supply a username and password when connecting. Use of this parameter - is only recommended for homogeneous NT client environments. This parameter makes the use of macro expansions that rely - on the username (%U, %G, etc) consistent. NT 4.0 - likes to use anonymous connections when refreshing the share list, - and this is a way to work around that. When restrict anonymous is This is a integer parameter, and + mirrors as much as possible the functinality the + yes, all anonymous connections - are denied no matter what they are for. This can effect the ability - of a machine to access the Samba Primary Domain Controller to revalidate - its machine account after someone else has logged on the client - interactively. The NT client will display a message saying that - the machine's account in the domain doesn't exist or the password is - bad. The best way to deal with this is to reboot NT client machines - between interactive logons, using "Shutdown and Restart", rather - than "Close all programs and logon as a different user". RestrictAnonymous + registry key does on NT/Win2k. Default: restrict anonymous = norestrict anonymous = 0root 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 @@ -16188,7 +16027,7 @@ CLASS="PARAMETER" >Default: root postexec = <empty string> +>root postexec = <empty string> Default: root preexec = <empty string> +>root preexec = <empty string> 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 @@ -16410,12 +16243,9 @@ CLASS="COMMAND" >Note that smbd ALWAYS uses a valid UNIX user to act on behalf of the client, even in
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. , 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. @@ -16603,19 +16424,13 @@ CLASS="PARAMETER" may change the UNIX user to use on this connection, but only after the user has been successfully authenticated. 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 @@ -16640,20 +16455,17 @@ CLASS="PARAMETER" > 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 @@ -16678,12 +16490,9 @@ 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 @@ -16732,7 +16535,7 @@ CLASS="PARAMETER" > parameter for details on doing this. See also the section NOTE ABOUT USERNAME/PASSWORD VALIDATION. SECURITY = DOMAIN This mode will only work correctly if 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 @@ -16853,12 +16641,9 @@ CLASS="PARAMETER" 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. Note that users who can access the Samba server through other means can easily bypass this restriction, so it is primarily useful for standalone @@ -17099,12 +16881,9 @@ CLASS="CONSTANT" >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. 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. 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 @@ -17330,6 +17100,9 @@ CLASS="PROGRAMLISTING" /sbin/shutdown $3 $4 +$time $1 &
Shutdown does not return so we need to launch it in background.
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 @@ -17566,12 +17336,9 @@ 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
Specifies whether Samba should try - to use unicode on the wire by default. + to use unicode on the wire by default. Note: This does NOT + mean that samba will assume that the unix machine uses unicode!
Default: unix charset = ASCII
Example: unix charset = UTF8
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 @@ -18223,14 +17990,11 @@ CLASS="COMMAND" >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
NOTE: The use of
See the section NOTE ABOUT USERNAME/PASSWORD VALIDATION for more information on how @@ -18436,7 +18197,7 @@ HREF="#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 @@ -18614,12 +18384,9 @@ CLASS="PARAMETER" trouble deleting print jobs as PrintManager under WfWg will think they don't own the print job.
Default: Default: no username map
Example: /var/run/utmp on Linux).
Default: Default: no utmp directory
Example: /var/run/wtmp on Linux).
Default: Default: no wtmp directory
Example:
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 .
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 @@ -18936,6 +18691,9 @@ veto files = /*Security*/*.tmp/*root*/ ; Veto the Apple specific files that a NetAtalk server ; creates. veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/ parameter. Default: Default: No files are vetoed for oplock grants You might want to do this on files that you know will @@ -19026,18 +18781,14 @@ NAME="VFSOBJECT" >vfs object (S) This parameter specifies a shared object file that - is used for Samba VFS I/O operations. By default, normal +>This parameter specifies a shared object files that + are used for Samba VFS I/O operations. By default, normal disk I/O operations are used but these can be overloaded - 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 This parameter allows parameters to be passed - to the vfs layer at initialization time. The Samba VFS layer - is new to Samba 2.2 and must be enabled at compile time - with --with-vfs. See also . 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 @@ -19229,12 +18970,9 @@ 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 yes setting. Default: Default: set at compile time to WORKGROUP Example: 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. @@ -19673,7 +19396,7 @@ CLASS="PARAMETER" > Default: write list = <empty string> +>write list = <empty string> WARNINGS VERSION This man page is correct for version 2.2 of +>This man page is correct for version 3.0 of the Samba suite. SEE ALSO AUTHOR .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMB.CONF" "5" "26 November 2002" "" "" +.TH "SMB.CONF" "5" "27 December 2002" "" "" .SH NAME smb.conf \- The configuration file for the Samba suite .SH "SYNOPSIS" @@ -1271,6 +1271,9 @@ each parameter for details. Note that some are synonyms. \fImin print space\fR .TP 0.2i \(bu +\fImsdfs proxy\fR +.TP 0.2i +\(bu \fImsdfs root\fR .TP 0.2i \(bu @@ -4497,14 +4500,29 @@ is 6 hours (21600 seconds). Default: \fBmin wins ttl = 21600\fR .TP +\fBmsdfs proxy (S)\fR +This parameter indicates that the share is a +stand-in for another CIFS share whose location is specified by +the value of the parameter. When clients attempt to connect to +this share, they are redirected to the proxied share using +the SMB-Dfs protocol. + +Only Dfs roots can act as proxy shares. Take a look at the +\fImsdfs root\fR +and +\fIhost msdfs\fR +options to find out how to set up a Dfs root share. + +Example: \fBmsdfs proxy = \\otherserver\\someshare\fR +.TP \fBmsdfs root (S)\fR This boolean parameter is only available if Samba is configured and compiled with the \fB --with-msdfs\fR option. If set to yes, Samba treats the share as a Dfs root and allows clients to browse the distributed file system tree rooted at the share directory. Dfs links are specified in the share directory by symbolic -links of the form \fImsdfs:serverA\\shareA,serverB\\shareB -\fR and so on. For more information on setting up a Dfs tree +links of the form \fImsdfs:serverA\\shareA,serverB\\shareB\fR +and so on. For more information on setting up a Dfs tree on Samba, refer to msdfs_setup.html @@ -4707,9 +4725,9 @@ This is a boolean option that controls whether connections with usernames not in the \fIuser\fR list will be allowed. By default this option is disabled so that a client can supply a username to be used by the server. Enabling -this parameter will force the server to only user the login +this parameter will force the server to only use the login names from the \fIuser\fR list and is only really -useful in shave level +useful in share level security. Note that this also means Samba won't try to deduce -- cgit