| 1 | <html>
|
|---|
| 2 | <body bgcolor="#ffffff">
|
|---|
| 3 |
|
|---|
| 4 | <img src="samba2_xs.gif" border="0" alt=" " height="100" width="76"
|
|---|
| 5 | hspace="10" align="left" />
|
|---|
| 6 |
|
|---|
| 7 | <h1 class="head0">Appendix B. Samba Configuration Option Quick Reference</h1>
|
|---|
| 8 |
|
|---|
| 9 |
|
|---|
| 10 | <p>The first section of this appendix lists each option that can be used
|
|---|
| 11 | in a Samba configuration file, which is usually named
|
|---|
| 12 | <em class="filename">smb.conf</em>. Most configuration files contain a
|
|---|
| 13 | global section of options that apply to all services (shares) and a
|
|---|
| 14 | separate section for various individual shares. If an option applies
|
|---|
| 15 | only to the global section, <tt class="literal">[global]</tt> appears to
|
|---|
| 16 | the right of its name in the following reference section.</p>
|
|---|
| 17 |
|
|---|
| 18 | <p>Except where noted, when specifying elements of a list, the elements
|
|---|
| 19 | can be separated by spaces, tabs, commas, semicolons, escaped
|
|---|
| 20 | newlines, or escaped carriage returns.</p>
|
|---|
| 21 |
|
|---|
| 22 | <p>Following this reference section is a glossary of value types, and a
|
|---|
| 23 | list of variables Samba recognizes.</p>
|
|---|
| 24 |
|
|---|
| 25 |
|
|---|
| 26 |
|
|---|
| 27 | <div class="sect1"><a name="samba2-APP-B-SECT-1"/>
|
|---|
| 28 |
|
|---|
| 29 | <h2 class="head1">Configuration File Options</h2>
|
|---|
| 30 |
|
|---|
| 31 | </div>
|
|---|
| 32 |
|
|---|
| 33 |
|
|---|
| 34 | <a name="INDEX-1"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>abort shutdown script = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 35 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that stops the shutdown procedure started by
|
|---|
| 36 | <tt class="literal">shutdown script</tt>. The command will be run with the
|
|---|
| 37 | UID of the connected user. New in Samba 3.0.</p></div>
|
|---|
| 38 | <a name="INDEX-2"/><a name="INDEX-3"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>add printer command = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 39 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that creates a new
|
|---|
| 40 | <a name="INDEX-3"/>printer on the system hosting the Samba
|
|---|
| 41 | server. This command runs as <tt class="literal">root</tt> when the Windows
|
|---|
| 42 | NT/2000/XP Add Printer Wizard is run. The command will be passed a
|
|---|
| 43 | printer name, share name, port name, driver name, Windows NT/2000/XP
|
|---|
| 44 | driver location, and Windows 95/98/Me driver location, in that order.
|
|---|
| 45 | It will need to add the printer to the system and a share definition
|
|---|
| 46 | for the printer to <em class="filename">smb.conf.</em> See also
|
|---|
| 47 | <tt class="literal">add printer wizard</tt>, <tt class="literal">printing</tt>,
|
|---|
| 48 | and <tt class="literal">show add printer wizard</tt>.</p></div>
|
|---|
| 49 | <a name="INDEX-4"/><a name="INDEX-5"/><a name="INDEX-6"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>add machine script = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 50 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that adds a computer to the Samba
|
|---|
| 51 | server's <a name="INDEX-5"/><a name="INDEX-6"/>domain. New in Samba 3.0.</p></div>
|
|---|
| 52 | <a name="INDEX-7"/><a name="INDEX-8"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>add share command = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 53 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that creates a new
|
|---|
| 54 | <a name="INDEX-8"/>share on the Samba server. This command
|
|---|
| 55 | runs as <tt class="literal">root</tt> when a share is created using the
|
|---|
| 56 | Windows NT/2000/XP Server Manager. The client user must be logged on
|
|---|
| 57 | as the <tt class="literal">root</tt> user. The command will be passed the
|
|---|
| 58 | name of the Samba configuration file, the name of the share to be
|
|---|
| 59 | created, the full pathname of a directory on the Samba server (which
|
|---|
| 60 | must already exist), and a string to use as a comment for the share,
|
|---|
| 61 | in that order. The command must add a share definition for the share
|
|---|
| 62 | to <em class="filename">smb.conf.</em> See also <tt class="literal">add printer
|
|---|
| 63 | command</tt>, for adding a print share.</p></div>
|
|---|
| 64 | <a name="INDEX-9"/><a name="INDEX-10"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>add user script = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 65 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that creates a new
|
|---|
| 66 | <a name="INDEX-10"/>user on the system hosting the Samba
|
|---|
| 67 | server. This command runs as <tt class="literal">root</tt> when access to a
|
|---|
| 68 | Samba share is attempted by a Windows user who does not have an
|
|---|
| 69 | account on the hosting system, but does have an account maintained by
|
|---|
| 70 | a primary domain controller on a different system. The command should
|
|---|
| 71 | accept the name of the user as a single argument that matches the
|
|---|
| 72 | behavior of typical <em class="emphasis">adduser</em> commands. Samba
|
|---|
| 73 | honors the <tt class="literal">%u</tt> value (username) as the argument to
|
|---|
| 74 | the command. Requires <tt class="literal">security</tt>
|
|---|
| 75 | <tt class="literal">=</tt> <tt class="literal">server</tt> or
|
|---|
| 76 | <tt class="literal">security</tt> <tt class="literal">=</tt>
|
|---|
| 77 | <tt class="literal">domain</tt>. See also <tt class="literal">delete user</tt>
|
|---|
| 78 | <tt class="literal">script</tt>.</p></div>
|
|---|
| 79 | <a name="INDEX-11"/><a name="INDEX-12"/><a name="INDEX-13"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>admin users = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p><a name="INDEX-12"/>Specifies users who will be granted
|
|---|
| 80 | <a name="INDEX-13"/><tt class="literal">root</tt>
|
|---|
| 81 | permissions on the share by Samba.</p></div>
|
|---|
| 82 | <a name="INDEX-14"/><a name="INDEX-15"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ads server = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 83 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: DNS hostname or IP address</p><p><b class="emphasis-bold">Default</b>: NONE</p><p>Specifies the <a name="INDEX-15"/>Active Directory server, used by
|
|---|
| 84 | Samba 3.0 for authenticating clients. Requires
|
|---|
| 85 | <tt class="literal">security</tt> <tt class="literal">= ads</tt>. New in Samba
|
|---|
| 86 | 3.0.</p></div>
|
|---|
| 87 | <a name="INDEX-16"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>algorithmic rid base = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 88 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: positive integer</p><p><b class="emphasis-bold">Default</b>: 1000</p><p>Specifies the base value that Samba uses when calculating Windows
|
|---|
| 89 | domain security identifier equivalents to Unix UIDs. See also
|
|---|
| 90 | <tt class="literal">non unix account range</tt>. New in Samba 3.0.</p></div>
|
|---|
| 91 | <a name="INDEX-17"/><a name="INDEX-18"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>allow hosts = host list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of hosts or networks</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies systems that can connect to the share or
|
|---|
| 92 | <a name="INDEX-18"/>shares. If NULL, any
|
|---|
| 93 | system can access the share unless there is a <tt class="literal">hosts
|
|---|
| 94 | deny</tt> option. Synonym for <tt class="literal">hosts</tt>
|
|---|
| 95 | <tt class="literal">allow</tt>.</p></div>
|
|---|
| 96 | <a name="INDEX-19"/><a name="INDEX-20"/><a name="INDEX-21"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>allow trusted domains = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 97 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Allows access to users who lack accounts on the Samba server but have
|
|---|
| 98 | accounts in another, trusted <a name="INDEX-20"/><a name="INDEX-21"/>domain.
|
|---|
| 99 | Requires <tt class="literal">security</tt> <tt class="literal">= server</tt> or
|
|---|
| 100 | <tt class="literal">security</tt> <tt class="literal">=</tt>
|
|---|
| 101 | <tt class="literal">domain</tt>.</p></div>
|
|---|
| 102 | <a name="INDEX-22"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>announce as = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 103 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: NT, Win95, Wf W</p><p><b class="emphasis-bold">Default</b>: NT</p><p>Has Samba announce itself as something other than an NT server.
|
|---|
| 104 | Discouraged because it interferes with serving browse lists.</p></div>
|
|---|
| 105 | <a name="INDEX-23"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>announce version = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 106 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: two numbers separated by a dot character</p><p><b class="emphasis-bold">Default</b>: 4.5</p><p>Instructs Samba to announce itself as a different version SMB server.
|
|---|
| 107 | Discouraged.</p></div>
|
|---|
| 108 | <a name="INDEX-24"/><a name="INDEX-25"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>auth methods = list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 109 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: guest, sam, ntdomain</p><p><b class="emphasis-bold">Default</b>: NONE</p><p>Specifies what methods Samba tries in turn to
|
|---|
| 110 | <a name="INDEX-25"/>authenticate users. New in Samba
|
|---|
| 111 | 3.0.</p></div>
|
|---|
| 112 | <a name="INDEX-26"/><a name="INDEX-27"/><a name="INDEX-28"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>auto services = service list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 113 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: service list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of <a name="INDEX-27"/><a name="INDEX-28"/>shares that always appear in
|
|---|
| 114 | browse lists. Also called <tt class="literal">preload</tt>.</p></div>
|
|---|
| 115 | <a name="INDEX-29"/><a name="INDEX-30"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>available = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to NO, denies access to a share. The
|
|---|
| 116 | <a name="INDEX-30"/>share appears in the browse list, but
|
|---|
| 117 | attempts to access it will fail.</p></div>
|
|---|
| 118 | <a name="INDEX-31"/><a name="INDEX-32"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>bind interfaces only = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 119 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, shares and browsing are provided only on interfaces in
|
|---|
| 120 | an <a name="INDEX-32"/>interfaces list (see
|
|---|
| 121 | <tt class="literal">interfaces</tt>). If you set this option to YES, be
|
|---|
| 122 | sure to add 127.0.0.1 to the interfaces list to allow
|
|---|
| 123 | <em class="emphasis">smbpasswd</em> to connect to the local system to
|
|---|
| 124 | change passwords. This is a convenience option; it does not improve
|
|---|
| 125 | security.</p></div>
|
|---|
| 126 | <a name="INDEX-33"/><a name="INDEX-34"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>block size = number</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: integer</p><p><b class="emphasis-bold">Default</b>: 1024</p><p>Sets the size of disk blocks as reported by <em class="emphasis">smbd</em>
|
|---|
| 127 | to the client. <a name="INDEX-34"/>Obsolete
|
|---|
| 128 | starting with Samba 3.0.</p></div>
|
|---|
| 129 | <a name="INDEX-35"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>blocking locks = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If YES, honors byte range lock requests with time limits. Samba will
|
|---|
| 130 | queue the requests and retry them until the time period expires.</p></div>
|
|---|
| 131 | <a name="INDEX-36"/><a name="INDEX-37"/><a name="INDEX-38"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>browsable = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p><a name="INDEX-37"/><a name="INDEX-38"/>Allows a share to be announced
|
|---|
| 132 | in browse lists. Also called <tt class="literal">browseable</tt>.</p></div>
|
|---|
| 133 | <a name="INDEX-39"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>browse list = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 134 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If YES, serves the browse list to other systems on the network. Avoid
|
|---|
| 135 | changing.</p></div>
|
|---|
| 136 | <a name="INDEX-40"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>browseable = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Synonym for <tt class="literal">browsable</tt>.</p></div>
|
|---|
| 137 | <a name="INDEX-41"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>case sensitive = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 138 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If YES, uses the exact case the client supplied when trying to
|
|---|
| 139 | resolve a filename. If NO, matches either upper- or lowercase name.
|
|---|
| 140 | Avoid changing. Also called <tt class="literal">casesignames</tt>.</p></div>
|
|---|
| 141 | <a name="INDEX-42"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>casesignames = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 142 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Synonym for <tt class="literal">case</tt> <tt class="literal">sensitive</tt>.</p></div>
|
|---|
| 143 | <a name="INDEX-43"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>change notify timeout = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 144 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: positive number</p><p><b class="emphasis-bold">Default</b>: 60</p><p>Sets the number of seconds between checks when a client asks for
|
|---|
| 145 | notification of changes in a directory. Avoid lowering.</p></div>
|
|---|
| 146 | <a name="INDEX-44"/><a name="INDEX-45"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>change share command = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 147 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that modifies a
|
|---|
| 148 | <a name="INDEX-45"/>share
|
|---|
| 149 | definition on the Samba server. This command runs as
|
|---|
| 150 | <tt class="literal">root</tt> when a share is created using the Windows
|
|---|
| 151 | NT/2000/XP Server Manager. The client user must be logged on as the
|
|---|
| 152 | <tt class="literal">root</tt> user. The command is passed the name of the
|
|---|
| 153 | Samba configuration file, the name of the share to be modified, the
|
|---|
| 154 | full pathname of a directory on the Samba server (which must already
|
|---|
| 155 | exist), and a string to use as a comment for the share, in that
|
|---|
| 156 | order. The command modifies the share definition for the share in
|
|---|
| 157 | <em class="filename">smb.conf.</em> See also <tt class="literal">add share
|
|---|
| 158 | command</tt> and <tt class="literal">delete share command</tt>.</p></div>
|
|---|
| 159 | <a name="INDEX-46"/><a name="INDEX-47"/><a name="INDEX-48"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>character set = name</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: ISO8859-1, ISO8859-2, ISO8859-5, KOI8-R</p><p><b class="emphasis-bold">Default</b>: NULL</p><p><a name="INDEX-47"/>If set, translates from DOS code
|
|---|
| 160 | pages to the Western European (ISO8859-1), Eastern European
|
|---|
| 161 | (ISO8859-2), Russian Cyrillic (ISO8859-5), or Alternate Russian
|
|---|
| 162 | (KOI8-R) character set. The <tt class="literal">client</tt>
|
|---|
| 163 | <tt class="literal">code</tt> <tt class="literal">page</tt> option must be set to
|
|---|
| 164 | 850. <a name="INDEX-48"/>Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 165 | <a name="INDEX-49"/><a name="INDEX-50"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>client code page = name</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: see <a href="ch11.html#samba2-CHP-11-TABLE-4">Table 11-4</a> in <a href="ch11.html">Chapter 11</a></p><p><b class="emphasis-bold">Default</b>: 850 (MS-DOS Latin 1)</p><p>Sets the DOS code page explicitly, overriding any previous
|
|---|
| 166 | <tt class="literal">valid</tt> <tt class="literal">chars</tt> settings. Examples
|
|---|
| 167 | of values are 850 for Western European, 437 for the U.S. standard,
|
|---|
| 168 | and 932 for Japanese Shift-JIS. <a name="INDEX-50"/>Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 169 | <a name="INDEX-51"/><a name="INDEX-52"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>code page directory = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 170 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full directory name</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/samba/lib/codepages</em></p><p>Specifies the directory that stores code pages.
|
|---|
| 171 | <a name="INDEX-52"/>Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 172 | <a name="INDEX-53"/><a name="INDEX-54"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>coding system = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 173 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: euc, cap, hex, hexN, sjis, j8bb, j8bj, jis8, j8bh,
|
|---|
| 174 | j8@b, j8@j,j8@h, j7bb, j7bj, jis7, j7bh, j7@b, j7@j, j7@h, jubb,
|
|---|
| 175 | jubj, junet, jubh, ju@b, ju@j, ju@h</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the coding system used, notably for Kanji. This is employed for
|
|---|
| 176 | filenames and should correspond to the code page in use. The
|
|---|
| 177 | <tt class="literal">client</tt> <tt class="literal">code</tt>
|
|---|
| 178 | <tt class="literal">page</tt> option must be set to 932 ( Japanese
|
|---|
| 179 | Shift-JIS). <a name="INDEX-54"/>Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 180 | <a name="INDEX-55"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>comment = string</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: string</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the comment corresponding to a share. The comment appears in
|
|---|
| 181 | places such as a <em class="emphasis">net view</em> listing or through the
|
|---|
| 182 | Network Neighborhood. See also the <tt class="literal">server</tt>
|
|---|
| 183 | <tt class="literal">string</tt> configuration option.</p></div>
|
|---|
| 184 | <a name="INDEX-56"/><a name="INDEX-57"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>config file = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 185 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: \filename</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Selects a new Samba <a name="INDEX-57"/>configuration file to read instead of the
|
|---|
| 186 | current one. Used to relocate the configuration file or used with
|
|---|
| 187 | <tt class="literal">%</tt> variables to select custom configuration files
|
|---|
| 188 | for some users or systems.</p></div>
|
|---|
| 189 | <a name="INDEX-58"/><a name="INDEX-59"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>copy = section name</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: existing section's name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Copies the configuration of an already defined share into the
|
|---|
| 190 | <a name="INDEX-59"/>share in which this option
|
|---|
| 191 | appears. Used with <tt class="literal">%</tt> variables to select custom
|
|---|
| 192 | configurations for systems, architectures, and users. Each option
|
|---|
| 193 | specified or copied takes precedence over earlier specifications of
|
|---|
| 194 | the option.</p></div>
|
|---|
| 195 | <a name="INDEX-60"/><a name="INDEX-61"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>create mask = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: 0744</p><p>Sets the maximum allowable <a name="INDEX-61"/>permissions for new files (e.g.,
|
|---|
| 196 | 0755). See also <tt class="literal">directory</tt> <tt class="literal">mask</tt>.
|
|---|
| 197 | To require certain permissions to be set, see
|
|---|
| 198 | <tt class="literal">force</tt> <tt class="literal">create</tt>
|
|---|
| 199 | <tt class="literal">mask</tt> and <tt class="literal">force</tt>
|
|---|
| 200 | <tt class="literal">directory</tt> <tt class="literal">mask</tt>. Also called
|
|---|
| 201 | <tt class="literal">create</tt> <tt class="literal">mode</tt>.</p></div>
|
|---|
| 202 | <a name="INDEX-62"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>create mode = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: 0744</p><p>Synonym for <tt class="literal">create</tt> <tt class="literal">mask</tt>.</p></div>
|
|---|
| 203 | <a name="INDEX-63"/><a name="INDEX-64"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>csc policy = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: manual, documents, programs, or disable</p><p><b class="emphasis-bold">Default</b>: manual</p><p>Sets the client-side <a name="INDEX-64"/>caching policy, telling them how to
|
|---|
| 204 | cache files offline if they are capable of doing so.</p></div>
|
|---|
| 205 | <a name="INDEX-65"/><a name="INDEX-66"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>deadtime = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 206 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Specifies the time in minutes before an unused
|
|---|
| 207 | <a name="INDEX-66"/>connection will be
|
|---|
| 208 | terminated. Zero means never. Used to keep clients from tying up
|
|---|
| 209 | server resources for long periods of time. If used, clients must
|
|---|
| 210 | autoreconnect after the specified period of inactivity. See also
|
|---|
| 211 | <tt class="literal">keepalive</tt>.</p></div>
|
|---|
| 212 | <a name="INDEX-67"/><a name="INDEX-68"/><a name="INDEX-69"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>debug hires timestamp = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 213 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Changes the <a name="INDEX-68"/><a name="INDEX-69"/>timestamps in log entries from seconds
|
|---|
| 214 | to microseconds. Useful for measuring performance.</p></div>
|
|---|
| 215 | <a name="INDEX-70"/><a name="INDEX-71"/><a name="INDEX-72"/><a name="INDEX-73"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>debug pid = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 216 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Adds the process ID of the Samba server to <a name="INDEX-71"/><a name="INDEX-72"/><a name="INDEX-73"/>log lines, making it easier to
|
|---|
| 217 | debug a particular server. Requires debug <tt class="literal">timestamp =
|
|---|
| 218 | yes</tt> to work.</p></div>
|
|---|
| 219 | <a name="INDEX-74"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>debug timestamp = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 220 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Timestamps all log messages. Can be turned off when
|
|---|
| 221 | it's not useful (e.g., in debugging ). Also called
|
|---|
| 222 | <tt class="literal">timestamp</tt> <tt class="literal">logs</tt>.</p></div>
|
|---|
| 223 | <a name="INDEX-75"/><a name="INDEX-76"/><a name="INDEX-77"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>debug uid = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 224 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p><a name="INDEX-76"/><a name="INDEX-77"/>Adds the real and effective
|
|---|
| 225 | user ID and group ID of the user being served to the logs, making it
|
|---|
| 226 | easier to debug one particular user.</p></div>
|
|---|
| 227 | <a name="INDEX-78"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>debuglevel = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 228 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Sets the logging level used. Values of 3 or more slow Samba
|
|---|
| 229 | noticeably. Also called <tt class="literal">log</tt>
|
|---|
| 230 | <tt class="literal">level</tt>. Recommended value is 1.</p></div>
|
|---|
| 231 | <a name="INDEX-79"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>default = service name</i></b></font></td><td align="right"><i>[global]
|
|---|
| 232 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: share name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies the name of a service (share) to provide if someone
|
|---|
| 233 | requests a service he doesn't have permission to use
|
|---|
| 234 | or that doesn't exist. The path is set from the name
|
|---|
| 235 | the client specified, with any underscore ( _ ) characters changed to
|
|---|
| 236 | slash ( / ) characters, allowing access to any directory on the Samba
|
|---|
| 237 | server. Use is discouraged. See also <tt class="literal">load
|
|---|
| 238 | printers</tt>. Also called <tt class="literal">default service</tt>.</p></div>
|
|---|
| 239 | <a name="INDEX-80"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>default case = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: LOWER, UPPER</p><p><b class="emphasis-bold">Default</b>: LOWER</p><p>Sets the case in which to store new filenames. LOWER indicates
|
|---|
| 240 | lowercase, and UPPER indicates uppercase.</p></div>
|
|---|
| 241 | <a name="INDEX-81"/><a name="INDEX-82"/><a name="INDEX-83"/><a name="INDEX-84"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>default devmode = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Used with printer shares being accessed by Windows NT/2000/XP clients
|
|---|
| 242 | to set a default device mode for the
|
|---|
| 243 | <a name="INDEX-82"/><a name="INDEX-83"/><a name="INDEX-84"/>printer. Can be
|
|---|
| 244 | problematic. Use with care.</p></div>
|
|---|
| 245 | <a name="INDEX-85"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>default service = share name</i></b></font></td><td align="right"><i>[global]
|
|---|
| 246 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: share name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Synonym for <tt class="literal">default</tt>.</p></div>
|
|---|
| 247 | <a name="INDEX-86"/><a name="INDEX-87"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>delete printer command = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 248 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that removes a
|
|---|
| 249 | <a name="INDEX-87"/>printer from the system hosting the
|
|---|
| 250 | Samba server and deletes its service definition from
|
|---|
| 251 | <em class="filename">smb.conf</em>. The command is passed a printer name
|
|---|
| 252 | as its only argument. See also <tt class="literal">add printer
|
|---|
| 253 | command</tt>, <tt class="literal">printing</tt>, and <tt class="literal">show add
|
|---|
| 254 | printer wizard</tt>.</p></div>
|
|---|
| 255 | <a name="INDEX-88"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>delete readonly = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: NO, YES</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, allows delete requests to remove read-only files. This
|
|---|
| 256 | is not allowed in MS-DOS/Windows, but it is normal in Unix, which has
|
|---|
| 257 | separate directory permissions. Used with programs such as RCS.</p></div>
|
|---|
| 258 | <a name="INDEX-89"/><a name="INDEX-90"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>delete share command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command that deletes a
|
|---|
| 259 | <a name="INDEX-90"/>share
|
|---|
| 260 | from the Samba server. The command runs when a user logged in as the
|
|---|
| 261 | <tt class="literal">root</tt> user on a Windows NT/2000/XP system deletes a
|
|---|
| 262 | share using Server Manager. The command is passed the name of the
|
|---|
| 263 | Samba configuration file and the name of the share to be deleted. The
|
|---|
| 264 | command must remove the definition of the share from the
|
|---|
| 265 | configuration file. See also <tt class="literal">add share command</tt> and
|
|---|
| 266 | <tt class="literal">change share command</tt>.</p></div>
|
|---|
| 267 | <a name="INDEX-91"/><a name="INDEX-92"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>delete user script = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 268 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full path to script</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the command to run as <tt class="literal">root</tt> when a user
|
|---|
| 269 | connects who no longer has an account on the
|
|---|
| 270 | domain's PDC. Honors <tt class="literal">%u</tt>. Can be
|
|---|
| 271 | used to delete the
|
|---|
| 272 | <a name="INDEX-92"/>user account automatically from
|
|---|
| 273 | the Samba server's host. Requires
|
|---|
| 274 | <tt class="literal">security</tt> <tt class="literal">=</tt>
|
|---|
| 275 | <tt class="literal">domain</tt> or <tt class="literal">security = user</tt>. Use
|
|---|
| 276 | with caution. See also <tt class="literal">add user script</tt>.</p></div>
|
|---|
| 277 | <a name="INDEX-93"/><a name="INDEX-94"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>delete veto files = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: NO, YES</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, allows delete requests for a
|
|---|
| 278 | <a name="INDEX-94"/>directory containing
|
|---|
| 279 | files or subdirectories the user can't see due to
|
|---|
| 280 | the <tt class="literal">veto</tt> <tt class="literal">files</tt> option. If set
|
|---|
| 281 | to NO, the directory is not deleted and still contains invisible
|
|---|
| 282 | files.</p></div>
|
|---|
| 283 | <a name="INDEX-95"/><a name="INDEX-96"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>deny hosts = host list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: hosts or networks</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of systems from which to refuse
|
|---|
| 284 | <a name="INDEX-96"/>connections.
|
|---|
| 285 | Also called <tt class="literal">hosts</tt> <tt class="literal">deny</tt>.</p></div>
|
|---|
| 286 | <a name="INDEX-97"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>dfree command = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 287 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Specifies a command to run on the server to return free disk space.
|
|---|
| 288 | Not needed unless the Samba host system's
|
|---|
| 289 | <em class="emphasis">dfree</em> command does not work properly.</p></div>
|
|---|
| 290 | <a name="INDEX-98"/><a name="INDEX-99"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>directory = directory</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: Unix directory name</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the path to the
|
|---|
| 291 | <a name="INDEX-99"/>directory provided by a file share or
|
|---|
| 292 | used by a printer share. If the option is omitted in the
|
|---|
| 293 | <tt class="literal">[homes]</tt> share, it is set automatically to the
|
|---|
| 294 | user's home directory; otherwise, it defaults
|
|---|
| 295 | to<em class="filename"> /tmp</em>. For a printer share, the directory is
|
|---|
| 296 | used to spool printer files. Honors the <tt class="literal">%u</tt> (user)
|
|---|
| 297 | and <tt class="literal">%m</tt> (machine) variables. Synonym for
|
|---|
| 298 | <tt class="literal">path</tt>.</p></div>
|
|---|
| 299 | <a name="INDEX-100"/><a name="INDEX-101"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>directory mask = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: 0755</p><p>Sets the maximum allowable permissions for newly created
|
|---|
| 300 | <a name="INDEX-101"/>directories. To require
|
|---|
| 301 | that certain permissions be set, see the <tt class="literal">force</tt>
|
|---|
| 302 | <tt class="literal">create</tt> <tt class="literal">mask</tt> and
|
|---|
| 303 | <tt class="literal">force</tt> <tt class="literal">directory</tt>
|
|---|
| 304 | <tt class="literal">mask</tt> options. Also called
|
|---|
| 305 | <tt class="literal">directory</tt> <tt class="literal">mode</tt>.</p></div>
|
|---|
| 306 | <a name="INDEX-102"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>directory mode = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: 0755</p><p>Synonym for <tt class="literal">directory</tt> <tt class="literal">mask</tt>.</p></div>
|
|---|
| 307 | <a name="INDEX-103"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>directory security mask = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: same as <tt class="literal">directory</tt> <tt class="literal">mode</tt></p><p>Controls which permission bits can be changed if a user edits the
|
|---|
| 308 | Unix permissions of directories on the Samba server from a Windows
|
|---|
| 309 | system. Any bit that is set in the mask can be changed by the user;
|
|---|
| 310 | any bit that is clear remains the same on the directory even if the
|
|---|
| 311 | user tries to change it. Requires <tt class="literal">nt</tt>
|
|---|
| 312 | <tt class="literal">acl</tt> <tt class="literal">support</tt>
|
|---|
| 313 | <tt class="literal">=</tt> <tt class="literal">YES</tt>.</p></div>
|
|---|
| 314 | <a name="INDEX-104"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>disable spools = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 315 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, Windows NT/2000/XP systems will downgrade to
|
|---|
| 316 | Lanman-style printing. Prevents printer driver uploading and
|
|---|
| 317 | downloading from working. Use with care. See also <tt class="literal">use client
|
|---|
| 318 | driver</tt>.</p></div>
|
|---|
| 319 | <a name="INDEX-105"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>dns proxy = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 320 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to YES and if <tt class="literal">wins</tt>
|
|---|
| 321 | <tt class="literal">server</tt> <tt class="literal">=</tt>
|
|---|
| 322 | <tt class="literal">YES</tt>, looks up hostnames in DNS when they are not
|
|---|
| 323 | found using WINS.</p></div>
|
|---|
| 324 | <a name="INDEX-106"/><a name="INDEX-107"/><a name="INDEX-108"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>domain admin group = user list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 325 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: usernames and/or group names</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies users who are in the <a name="INDEX-107"/>Domain Admins group and have
|
|---|
| 326 | <a name="INDEX-108"/>domain
|
|---|
| 327 | administrator authority when Samba is the PDC. See also
|
|---|
| 328 | <tt class="literal">domain guest group</tt> and <tt class="literal">domain
|
|---|
| 329 | logons</tt>. Useful in Samba 2.2 only. Obsolete in Samba 3.0.</p></div>
|
|---|
| 330 | <a name="INDEX-109"/><a name="INDEX-110"/><a name="INDEX-111"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>domain guest group = user/group list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 331 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of usernames and/or group names</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies users who are in the <a name="INDEX-110"/>Domain Guest group when Samba is the PDC.
|
|---|
| 332 | See also <tt class="literal">domain admin group</tt> and <tt class="literal">domain
|
|---|
| 333 | logons</tt>. Useful in Samba 2.2 only. <a name="INDEX-111"/>Obsolete in Samba 3.0.</p></div>
|
|---|
| 334 | <a name="INDEX-112"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>domain logons = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 335 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Causes Samba to serve domain logons. This is one of the basic
|
|---|
| 336 | functions required when Samba is acting as the PDC.</p></div>
|
|---|
| 337 | <a name="INDEX-113"/><a name="INDEX-114"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>domain master = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 338 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: automatic</p><p>Makes Samba a <a name="INDEX-114"/>domain master browser for its domain. When
|
|---|
| 339 | domain logons are enabled, <tt class="literal">domain master</tt> defaults
|
|---|
| 340 | to YES. Otherwise, it defaults to NO.</p></div>
|
|---|
| 341 | <a name="INDEX-115"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>dont descend = list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of directories</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Prohibits a change directory or search in the directories specified.
|
|---|
| 342 | This is a browsing-convenience option; it doesn't
|
|---|
| 343 | provide any extra security.</p></div>
|
|---|
| 344 | <a name="INDEX-116"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>dos filemode = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Allows anyone with write permissions to change permissions on a file,
|
|---|
| 345 | as allowed by MS-DOS.</p></div>
|
|---|
| 346 | <a name="INDEX-117"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>dos filetime resolution = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Sets file times on Unix to match MS-DOS standards (rounding to the
|
|---|
| 347 | next even second). Recommended if using Visual C++ or a PC
|
|---|
| 348 | <em class="emphasis">make</em> program to avoid remaking the programs
|
|---|
| 349 | unnecessarily. Use with the <tt class="literal">dos</tt>
|
|---|
| 350 | <tt class="literal">filetimes</tt> option.</p></div>
|
|---|
| 351 | <a name="INDEX-118"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>dos filetimes = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Allows nonowners to change file times if they can write to the files,
|
|---|
| 352 | matching the behavior of MS-DOS and Windows. See also
|
|---|
| 353 | <tt class="literal">dos</tt> <tt class="literal">filetime</tt>
|
|---|
| 354 | <tt class="literal">resolution</tt>.</p></div>
|
|---|
| 355 | <a name="INDEX-119"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>encrypt passwords = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 356 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO in Samba 2.2, YES in Samba 3.0</p><p>If enabled, Samba will use password encryption. Requires an
|
|---|
| 357 | <em class="filename">smbpasswd</em> file on the Samba server.</p></div>
|
|---|
| 358 | <a name="INDEX-120"/><a name="INDEX-121"/><a name="INDEX-122"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>enhanced browsing = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 359 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Automatically synchronizes <a name="INDEX-121"/><a name="INDEX-122"/>browse lists with all domain master
|
|---|
| 360 | browsers known to the WINS server. Makes cross-subnet browsing more
|
|---|
| 361 | reliable, but also can cause empty workgroups to persist forever in
|
|---|
| 362 | browse lists.</p></div>
|
|---|
| 363 | <a name="INDEX-123"/><a name="INDEX-124"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>enumports command = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 364 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Allows for a command to provide clients with customized
|
|---|
| 365 | MS-DOS/Windows <a name="INDEX-124"/>port names (e.g., PRN:) corresponding
|
|---|
| 366 | to printers. Samba's default behavior is to return
|
|---|
| 367 | <tt class="literal">Samba Printer Port</tt>. The command must return a
|
|---|
| 368 | series of lines, with one port name per line.</p></div>
|
|---|
| 369 | <a name="INDEX-125"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>exec = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets a command to run as the user before connecting to the share.
|
|---|
| 370 | Synonym for <tt class="literal">preexec</tt>. See also the
|
|---|
| 371 | <tt class="literal">postexec</tt>, <tt class="literal">root</tt>
|
|---|
| 372 | <tt class="literal">preexec</tt>, and <tt class="literal">root postexec</tt>
|
|---|
| 373 | options.</p></div>
|
|---|
| 374 | <a name="INDEX-126"/><a name="INDEX-127"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>fake directory create times = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>A bug fix for users of Microsoft
|
|---|
| 375 | <em class="emphasis">nmake</em><a name="INDEX-127"/>. If YES, Samba sets directory create
|
|---|
| 376 | times such that <em class="emphasis">nmake</em> won't
|
|---|
| 377 | remake all files every time.</p></div>
|
|---|
| 378 | <a name="INDEX-128"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>fake oplocks = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set, returns YES whenever a client asks if it can lock a file and
|
|---|
| 379 | cache it locally but does not enforce the lock on the server. Results
|
|---|
| 380 | in performance improvement for read-only shares. <em class="emphasis">Never use
|
|---|
| 381 | with read/write shares!</em> See also
|
|---|
| 382 | <tt class="literal">oplocks</tt> and <tt class="literal">veto</tt>
|
|---|
| 383 | <tt class="literal">oplock</tt> <tt class="literal">files</tt>.</p></div>
|
|---|
| 384 | <a name="INDEX-129"/><a name="INDEX-130"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>follow symlinks = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to YES, Samba follows <a name="INDEX-130"/>symlinks in a file share(s). See the
|
|---|
| 385 | <tt class="literal">wide</tt> <tt class="literal">links</tt> option if you want
|
|---|
| 386 | to restrict symlinks to just the current share.</p></div>
|
|---|
| 387 | <a name="INDEX-131"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>force create mode = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Takes effect when a user on a Windows client creates a file that
|
|---|
| 388 | resides on the Samba server. This option ensures that bits set in
|
|---|
| 389 | this mask will always be set on the new file. Used with the
|
|---|
| 390 | <tt class="literal">create mask</tt> configuration option.</p></div>
|
|---|
| 391 | <a name="INDEX-132"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>force directory mode = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Takes effect when a user on a Windows client creates a directory on
|
|---|
| 392 | the Samba server. This option ensures that bits set in the mask will
|
|---|
| 393 | be set on every newly created directory. Used with <tt class="literal">directory
|
|---|
| 394 | mask</tt>.</p></div>
|
|---|
| 395 | <a name="INDEX-133"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>force directory security mode = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: same as <tt class="literal">force</tt>
|
|---|
| 396 | <tt class="literal">directory</tt> <tt class="literal">mode</tt></p><p>Takes effect when a user on a Windows client edits the Unix
|
|---|
| 397 | permissions of a directory on the Samba server. This option ensures
|
|---|
| 398 | that bits set in this mask will be set on the directory. Requires
|
|---|
| 399 | <tt class="literal">nt</tt> <tt class="literal">acl</tt>
|
|---|
| 400 | <tt class="literal">support</tt> <tt class="literal">=</tt>
|
|---|
| 401 | <tt class="literal">YES</tt>.</p></div>
|
|---|
| 402 | <a name="INDEX-134"/><a name="INDEX-135"/><a name="INDEX-136"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>force group = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: a Unix group name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the effective group name assigned to all users accessing a
|
|---|
| 403 | share. Used to override a
|
|---|
| 404 | <a name="INDEX-135"/><a name="INDEX-136"/>user's
|
|---|
| 405 | normal group memberships.</p></div>
|
|---|
| 406 | <a name="INDEX-137"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>force security mode = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: same as <tt class="literal">force</tt> <tt class="literal">create</tt>
|
|---|
| 407 | <tt class="literal">mode</tt></p><p>Takes effect when a user on a Windows client edits the Unix
|
|---|
| 408 | permissions of a file on the Samba server. This option ensures that
|
|---|
| 409 | bits set in the mask will always be set on the file. Requires
|
|---|
| 410 | <tt class="literal">nt</tt> <tt class="literal">acl</tt>
|
|---|
| 411 | <tt class="literal">support</tt> <tt class="literal">=</tt>
|
|---|
| 412 | <tt class="literal">YES</tt>. See also <tt class="literal">force directory security
|
|---|
| 413 | mode</tt> for directories.</p></div>
|
|---|
| 414 | <a name="INDEX-138"/><a name="INDEX-139"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>force unknown acl user = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>When set, unknown users or groups in Windows NT ACLs will be mapped
|
|---|
| 415 | to the user or group of the connected user. <a name="INDEX-139"/>Obsolete starting with Samba
|
|---|
| 416 | 3.0.</p></div>
|
|---|
| 417 | <a name="INDEX-140"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>force user = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: a single username</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the effective username assigned to all users accessing a share.
|
|---|
| 418 | Discouraged.</p></div>
|
|---|
| 419 | <a name="INDEX-141"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>fstype = string</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: NTFS, FAT, Samba</p><p><b class="emphasis-bold">Default</b>: NTFS</p><p>Sets the filesystem type reported to the client. Avoid changing.</p></div>
|
|---|
| 420 | <a name="INDEX-142"/><a name="INDEX-143"/><a name="INDEX-144"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>getwd cache = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 421 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Caches the current <a name="INDEX-143"/><a name="INDEX-144"/>directory for performance.
|
|---|
| 422 | Recommended with the <tt class="literal">wide</tt> <tt class="literal">links</tt>
|
|---|
| 423 | option.</p></div>
|
|---|
| 424 | <a name="INDEX-145"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>group = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: a Unix group name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Synonym for <tt class="literal">force</tt> <tt class="literal">group</tt>.</p></div>
|
|---|
| 425 | <a name="INDEX-146"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>guest account = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: a single username</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the name of the unprivileged Unix account to use for tasks such
|
|---|
| 426 | as printing and for accessing shares marked with
|
|---|
| 427 | <tt class="literal">guest</tt> <tt class="literal">ok</tt>. The default is
|
|---|
| 428 | specified at compile time and is usually set to
|
|---|
| 429 | <tt class="literal">nobody</tt>.</p></div>
|
|---|
| 430 | <a name="INDEX-147"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>guest ok = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, doesn't need passwords for this
|
|---|
| 431 | share. Used with <tt class="literal">security = share</tt>. Synonym for
|
|---|
| 432 | <tt class="literal">public</tt>.</p></div>
|
|---|
| 433 | <a name="INDEX-148"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>guest only = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Forces users of a share to log on as the guest account. Requires
|
|---|
| 434 | <tt class="literal">guest</tt> <tt class="literal">ok</tt> or
|
|---|
| 435 | <tt class="literal">public</tt> to be YES. Also called
|
|---|
| 436 | <tt class="literal">only</tt> <tt class="literal">guest</tt>.</p></div>
|
|---|
| 437 | <a name="INDEX-149"/><a name="INDEX-150"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>hide dot files = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Treats files with names beginning with a dot as if they had the
|
|---|
| 438 | MS-DOS <a name="INDEX-150"/>hidden
|
|---|
| 439 | attribute set. The files are either not displayed on a Windows client
|
|---|
| 440 | or appear grayed-out, depending on the settings on the client.</p></div>
|
|---|
| 441 | <a name="INDEX-151"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>hide files = slash-separated list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: patterns, separated by <tt class="literal">/</tt>
|
|---|
| 442 | characters</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of file or directory names on which to set the
|
|---|
| 443 | MS-DOS hidden attribute. Names can contain <tt class="literal">?</tt> or
|
|---|
| 444 | <tt class="literal">*</tt> pattern characters and <tt class="literal">%</tt>
|
|---|
| 445 | variables. See also <tt class="literal">hide</tt> <tt class="literal">dot</tt>
|
|---|
| 446 | <tt class="literal">files</tt> and <tt class="literal">veto</tt>
|
|---|
| 447 | <tt class="literal">files</tt>.</p></div>
|
|---|
| 448 | <a name="INDEX-152"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>hide local users = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 449 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, hides Unix-specific dummy accounts
|
|---|
| 450 | (<tt class="literal">root</tt>, <tt class="literal">wheel</tt>,
|
|---|
| 451 | <tt class="literal">floppy</tt>, etc.) from clients.</p></div>
|
|---|
| 452 | <a name="INDEX-153"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>hide unreadable = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, hides all unreadable files.</p></div>
|
|---|
| 453 | <a name="INDEX-154"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>homedir map = name</i></b></font></td><td align="right"><i>[global]
|
|---|
| 454 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: NIS map name</p><p><b class="emphasis-bold">Default</b>: NONE</p><p>Used with <tt class="literal">nis</tt> <tt class="literal">homedir</tt> to locate
|
|---|
| 455 | a user's Unix home directory from Sun NIS (not
|
|---|
| 456 | NIS+).</p></div>
|
|---|
| 457 | <a name="INDEX-155"/><a name="INDEX-156"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>host msdfs = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 458 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p><a name="INDEX-156"/>If set to YES and Samba was
|
|---|
| 459 | configured with the <tt class="literal">--with-msdfs</tt> option, provides
|
|---|
| 460 | Microsoft Distributed filesystem (Dfs) service, allowing Dfs-capable
|
|---|
| 461 | clients to browse Dfs trees on the Samba server. See also
|
|---|
| 462 | <tt class="literal">msdfs root</tt>.</p></div>
|
|---|
| 463 | <a name="INDEX-157"/><a name="INDEX-158"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>hosts allow = host list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of hosts or networks</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of systems that can access the
|
|---|
| 464 | <a name="INDEX-158"/>share. If NULL, any system can access
|
|---|
| 465 | the share unless there is a <tt class="literal">hosts</tt>
|
|---|
| 466 | <tt class="literal">deny</tt> option. Synonym for <tt class="literal">allow</tt>
|
|---|
| 467 | <tt class="literal">hosts</tt>.</p></div>
|
|---|
| 468 | <a name="INDEX-159"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>hosts deny = host list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of hosts or networks</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of systems that cannot connect to the share. Synonym
|
|---|
| 469 | for <tt class="literal">deny</tt> <tt class="literal">hosts</tt>.</p></div>
|
|---|
| 470 | <a name="INDEX-160"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>hosts equiv = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 471 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies the path to a file of trusted systems from which
|
|---|
| 472 | passwordless logons are allowed. Strongly discouraged because Windows
|
|---|
| 473 | NT/2000/XP users can always override the username—the only
|
|---|
| 474 | security in this scheme.</p></div>
|
|---|
| 475 | <a name="INDEX-161"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>include = filename</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Includes the named file in <em class="filename">smb.conf</em> at the line
|
|---|
| 476 | where it appears. This option accepts most variables, but not
|
|---|
| 477 | <tt class="literal">%u</tt> (user), <tt class="literal">%P</tt> (current
|
|---|
| 478 | share's <tt class="literal">root</tt> directory), or
|
|---|
| 479 | <tt class="literal">%S</tt> (current share's name) because
|
|---|
| 480 | they are not set at the time the file is read.</p></div>
|
|---|
| 481 | <a name="INDEX-162"/><a name="INDEX-163"/><a name="INDEX-164"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>inherit acls = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set, files and subdirectories are created with the same
|
|---|
| 482 | <a name="INDEX-163"/>ACLs
|
|---|
| 483 | as their parent directories. Directories are given Unix permissions
|
|---|
| 484 | of 0777 (full permissions) ensuring that the ACL on the directory
|
|---|
| 485 | will govern the actual permissions given to clients. Requires
|
|---|
| 486 | <a name="INDEX-164"/>POSIX ACL
|
|---|
| 487 | support to be provided on the Samba host system.</p></div>
|
|---|
| 488 | <a name="INDEX-165"/><a name="INDEX-166"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>inherit permissions = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set, files and subdirectories are created with the same
|
|---|
| 489 | <a name="INDEX-166"/>permissions as their parent
|
|---|
| 490 | directories. This allows Unix directory permissions to be propagated
|
|---|
| 491 | automatically to new files and subdirectories, especially in the
|
|---|
| 492 | <tt class="literal">[homes]</tt> share. This option overrides
|
|---|
| 493 | <tt class="literal">create</tt> <tt class="literal">mask</tt>,
|
|---|
| 494 | <tt class="literal">directory</tt> <tt class="literal">mask</tt>,
|
|---|
| 495 | <tt class="literal">force</tt> <tt class="literal">create</tt>
|
|---|
| 496 | <tt class="literal">mode</tt>, and <tt class="literal">force</tt>
|
|---|
| 497 | <tt class="literal">directory</tt> <tt class="literal">mode</tt>, but not
|
|---|
| 498 | <tt class="literal">map</tt> <tt class="literal">archive</tt>,
|
|---|
| 499 | <tt class="literal">map</tt> <tt class="literal">hidden</tt>, or
|
|---|
| 500 | <tt class="literal">map</tt> <tt class="literal">system</tt>. Samba never sets
|
|---|
| 501 | the <tt class="literal">setuid</tt> bit when creating a file or directory.</p></div>
|
|---|
| 502 | <a name="INDEX-167"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>interfaces = interface list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 503 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: interface list</p><p><b class="emphasis-bold">Default</b>: NULL (all interfaces except 127.0.0.1)</p><p>Sets the interfaces to which Samba will respond. The default is the
|
|---|
| 504 | system's primary interface only. Recommended on
|
|---|
| 505 | multihomed systems or to override erroneous addresses and netmasks.
|
|---|
| 506 | Allows interface names such as <tt class="literal">eth0</tt>, DNS names,
|
|---|
| 507 | address/netmask pairs, and broadcast/netmask pairs. See also
|
|---|
| 508 | <tt class="literal">bind interfaces only</tt>.</p></div>
|
|---|
| 509 | <a name="INDEX-168"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>invalid users = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of users not permitted access to the share.</p></div>
|
|---|
| 510 | <a name="INDEX-169"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>keepalive = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 511 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 300</p><p>Sets the number of seconds between checks for a crashed client. The
|
|---|
| 512 | value of 0 causes no checks to be performed. Setting
|
|---|
| 513 | <tt class="literal">keepalive = 3600</tt> will turn on checks every hour. A
|
|---|
| 514 | value of 600 (every 10 minutes) is recommended if you want more
|
|---|
| 515 | frequent checks. See also <tt class="literal">socket</tt>
|
|---|
| 516 | <tt class="literal">options</tt> for another approach.</p></div>
|
|---|
| 517 | <a name="INDEX-170"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>kernel oplocks = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 518 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Breaks the oplock when a local Unix process or NFS operation accesses
|
|---|
| 519 | an oplocked file, thus preventing corruption. This works only on
|
|---|
| 520 | operating systems that support kernel-based oplocks, such as Linux
|
|---|
| 521 | 2.4 and Irix. Avoid changing. See also <tt class="literal">oplocks</tt> and
|
|---|
| 522 | <tt class="literal">level2</tt> <tt class="literal">oplocks</tt>.</p></div>
|
|---|
| 523 | <a name="INDEX-171"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lanman auth = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 524 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to YES, allows clients to use the (weak) LANMAN password hash
|
|---|
| 525 | used by Windows 95/98/Me. If set to NO, allows only the better NT1
|
|---|
| 526 | hash used by Windows NT/2000/XP.</p></div>
|
|---|
| 527 | <a name="INDEX-172"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>large readwrite = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 528 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO in Samba 2.2, YES in Samba 3.0</p><p>If set to YES, allows Windows 2000/XP to read and write 64KB at a
|
|---|
| 529 | time to improve performance. Requires Samba to be hosted by a 64-bit
|
|---|
| 530 | OS, such as Linux 2.4, Irix, or Solaris. Somewhat experimental.</p></div>
|
|---|
| 531 | <a name="INDEX-173"/><a name="INDEX-174"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ldap admin dn = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 532 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: Distinguished Name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the Distinguished Name used by Samba when contacting the LDAP
|
|---|
| 533 | server. Requires Samba to be configured with the
|
|---|
| 534 | <tt class="literal">--with-ldapsam</tt> configuration option. Experimental
|
|---|
| 535 | option added in Samba 2.2.3 and <a name="INDEX-174"/>obsolete in Samba 3.0.</p></div>
|
|---|
| 536 | <a name="INDEX-175"/><a name="INDEX-176"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ldap filter = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 537 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: LDAP search filter</p><p><b class="emphasis-bold">Default</b>: <tt class="literal">(&(uid=%u)(objectclass=sambaAccount))</tt></p><p>Sets the LDAP search filter. Requires that Samba be configured with
|
|---|
| 538 | the <tt class="literal">--with-ldapsam</tt> configuration option.
|
|---|
| 539 | Experimental option added in Samba 2.2.3 and
|
|---|
| 540 | <a name="INDEX-176"/>obsolete in Samba 3.0.</p></div>
|
|---|
| 541 | <a name="INDEX-177"/><a name="INDEX-178"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ldap port = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 542 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: positive integer</p><p><b class="emphasis-bold">Default</b>: In Samba 2.2, 636 if <tt class="literal">ldap ssl = on</tt>;
|
|---|
| 543 | otherwise 389</p><p>Sets the TCP port number for contacting the LDAP server. Requires
|
|---|
| 544 | that Samba be configured with the <tt class="literal">--with-ldapsam</tt>
|
|---|
| 545 | configuration option. Experimental option added in Samba 2.2.3 and
|
|---|
| 546 | <a name="INDEX-178"/>obsolete
|
|---|
| 547 | starting with Samba 3.0. See also <tt class="literal">ldap ssl</tt>.</p></div>
|
|---|
| 548 | <a name="INDEX-179"/><a name="INDEX-180"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ldap server = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 549 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: fully qualified domain name</p><p><b class="emphasis-bold">Default</b>: localhost</p><p>Sets the domain name of the LDAP server. Requires that Samba be
|
|---|
| 550 | configured with the <tt class="literal">--with-ldapsam</tt> configuration
|
|---|
| 551 | option. Experimental option added in Samba 2.2.3 and
|
|---|
| 552 | <a name="INDEX-180"/>obsolete starting with Samba 3.0.</p></div>
|
|---|
| 553 | <a name="INDEX-181"/><a name="INDEX-182"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ldap ssl = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 554 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: ON, OFF, START TLS</p><p><b class="emphasis-bold">Default</b>: ON</p><p>Sets whether Samba uses SSL to contact the LDAP server. ON and OFF
|
|---|
| 555 | turn SSL encryption on or off. The START TLS setting causes Samba to
|
|---|
| 556 | use LDAPv3 StartTLS extended operation. Requires that Samba be
|
|---|
| 557 | configured with the <tt class="literal">--with-ldapsam</tt> configuration
|
|---|
| 558 | option. Experimental option added in Samba 2.2.3 and
|
|---|
| 559 | <a name="INDEX-182"/>obsolete
|
|---|
| 560 | in Samba 3.0.</p></div>
|
|---|
| 561 | <a name="INDEX-183"/><a name="INDEX-184"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ldap suffix = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 562 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: Distinguished Name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the base Distinguished Name to use for LDAP searches. Requires
|
|---|
| 563 | that Samba be configured with the <tt class="literal">--with-ldapsam</tt>
|
|---|
| 564 | configuration option. Experimental option added in Samba 2.2.3 and
|
|---|
| 565 | <a name="INDEX-184"/>obsolete in Samba 3.0.</p></div>
|
|---|
| 566 | <a name="INDEX-185"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>level2 oplocks = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Allows files to be cached read-only on the client when multiple
|
|---|
| 567 | clients have opened the file. This allows executables to be cached
|
|---|
| 568 | locally, improving performance.</p></div>
|
|---|
| 569 | <a name="INDEX-186"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lm announce = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 570 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: AUTO, YES, NO</p><p><b class="emphasis-bold">Default</b>: AUTO</p><p>Produces OS/2 SMB broadcasts at an interval specified by the
|
|---|
| 571 | <tt class="literal">lm</tt> <tt class="literal">interval</tt> option. YES/NO
|
|---|
| 572 | turns them on/off unconditionally. AUTO causes the Samba server to
|
|---|
| 573 | wait for a LAN manager announcement from another client before
|
|---|
| 574 | sending one out. Required for OS/2 client browsing.</p></div>
|
|---|
| 575 | <a name="INDEX-187"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lm interval = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 576 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 60</p><p>Sets the time period, in seconds, between OS/2 SMB broadcast
|
|---|
| 577 | announcements.</p></div>
|
|---|
| 578 | <a name="INDEX-188"/><a name="INDEX-189"/><a name="INDEX-190"/><a name="INDEX-191"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>load printers = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 579 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Loads all printer names from the system's
|
|---|
| 580 | <em class="emphasis">printcap</em><a name="INDEX-189"/> file into the
|
|---|
| 581 | <a name="INDEX-190"/><a name="INDEX-191"/>browse
|
|---|
| 582 | list. Uses configuration options from the
|
|---|
| 583 | <tt class="literal">[printers]</tt> section.</p></div>
|
|---|
| 584 | <a name="INDEX-192"/><a name="INDEX-193"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>local master = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 585 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Allows Samba to participate in <a name="INDEX-193"/>elections for the local master
|
|---|
| 586 | browser. See also <tt class="literal">domain</tt> <tt class="literal">master</tt>
|
|---|
| 587 | and <tt class="literal">os</tt> <tt class="literal">level</tt>.</p></div>
|
|---|
| 588 | <a name="INDEX-194"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lock dir = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 589 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: <em class="emphasis">/usr/local/samba/var/locks</em></p><p>Synonym for <tt class="literal">lock</tt> <tt class="literal">directory</tt>.</p></div>
|
|---|
| 590 | <a name="INDEX-195"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lock directory = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 591 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: <em class="emphasis">/usr/local/samba/var/locks</em></p><p>Sets a directory in which to keep lock files. The directory must be
|
|---|
| 592 | writable by Samba and readable by everyone. Also called
|
|---|
| 593 | <tt class="literal">lock</tt> <tt class="literal">dir</tt>.</p></div>
|
|---|
| 594 | <a name="INDEX-196"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lock spin count = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 595 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: positive integer</p><p><b class="emphasis-bold">Default</b>: 2</p><p>Sets the number of attempts to attain a byte range lock. See also
|
|---|
| 596 | <tt class="literal">lock spin time</tt>.</p></div>
|
|---|
| 597 | <a name="INDEX-197"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lock spin time = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 598 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of microseconds</p><p><b class="emphasis-bold">Default</b>: 10</p><p>Sets the number of microseconds between attempts to attain a lock.
|
|---|
| 599 | See also <tt class="literal">lock</tt> <tt class="literal">spin</tt>
|
|---|
| 600 | <tt class="literal">count</tt>.</p></div>
|
|---|
| 601 | <a name="INDEX-198"/><a name="INDEX-199"/><a name="INDEX-200"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>locking = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Performs <a name="INDEX-199"/><a name="INDEX-200"/>file locking. If set to NO, Samba
|
|---|
| 602 | accepts lock requests but won't actually lock
|
|---|
| 603 | resources. Turn off for read-only filesystems.</p></div>
|
|---|
| 604 | <a name="INDEX-201"/><a name="INDEX-202"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>log file = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 605 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the name and location of the <a name="INDEX-202"/>log file. Allows all <tt class="literal">%</tt>
|
|---|
| 606 | variables.</p></div>
|
|---|
| 607 | <a name="INDEX-203"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>log level = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 608 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Sets the logging level used. Values of 3 or more slow the system
|
|---|
| 609 | noticeably. Recommended value is 1. Synonym for
|
|---|
| 610 | <tt class="literal">debug</tt> <tt class="literal">level</tt>.</p></div>
|
|---|
| 611 | <a name="INDEX-204"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>logon drive = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 612 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: MS-DOS drive name</p><p><b class="emphasis-bold">Default</b>: Z:</p><p>Sets the drive to be used as a home directory for domain logons by
|
|---|
| 613 | Windows NT/2000/XP clients. See also <tt class="literal">logon</tt>
|
|---|
| 614 | <tt class="literal">home</tt>.</p></div>
|
|---|
| 615 | <a name="INDEX-205"/><a name="INDEX-206"/><a name="INDEX-207"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>logon home = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 616 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: UNC of shared directory</p><p><b class="emphasis-bold">Default</b>: <em class="filename">\\ %N \ %U</em></p><p>Sets the home <a name="INDEX-206"/><a name="INDEX-207"/>directory of a Windows 95/98/Me or
|
|---|
| 617 | NT/2000/XP user. Allows <tt class="literal">NET</tt> <tt class="literal">USE</tt>
|
|---|
| 618 | <tt class="literal">H:/HOME</tt> from the command prompt if Samba is acting
|
|---|
| 619 | as a logon server. Append <tt class="literal">\profile</tt> or other
|
|---|
| 620 | directory to the value of this parameter if storing Windows 95/98/Me
|
|---|
| 621 | profiles in a subdirectory of the user's home
|
|---|
| 622 | directory. See <tt class="literal">logon path</tt> for Windows NT/2000/XP
|
|---|
| 623 | roaming profiles.</p></div>
|
|---|
| 624 | <a name="INDEX-208"/><a name="INDEX-209"/><a name="INDEX-210"/><a name="INDEX-211"/><a name="INDEX-212"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>logon path = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 625 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: UNC of shared directory</p><p><b class="emphasis-bold">Default</b>: <em class="filename">\\ %N \ %U \ profile</em></p><p>Sets the path to the directory where Windows NT/2000/XP
|
|---|
| 626 | <a name="INDEX-209"/><a name="INDEX-210"/><a name="INDEX-211"/><a name="INDEX-212"/>roaming profiles are stored. See
|
|---|
| 627 | also <tt class="literal">logon home</tt> for Windows 95/98/Me roaming
|
|---|
| 628 | profiles.</p></div>
|
|---|
| 629 | <a name="INDEX-213"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>logon script = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 630 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: UNC of shared file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the pathname (relative to the <tt class="literal">[netlogon]</tt>
|
|---|
| 631 | share) of an MS-DOS/NT command to run on the client at logon time.
|
|---|
| 632 | Allows all <tt class="literal">%</tt> variables.</p></div>
|
|---|
| 633 | <a name="INDEX-214"/><a name="INDEX-215"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lppause command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the command to pause a <a name="INDEX-215"/>print job.
|
|---|
| 634 | Honors the <tt class="literal">%p</tt> (printer name) and
|
|---|
| 635 | <tt class="literal">%j</tt> (job number) variables.</p></div>
|
|---|
| 636 | <a name="INDEX-216"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lpq cache time = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 637 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 10</p><p>Sets how long to keep print queue status cached, in seconds.</p></div>
|
|---|
| 638 | <a name="INDEX-217"/><a name="INDEX-218"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lpq command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the command used to get <a name="INDEX-218"/>printer status. Usually
|
|---|
| 639 | initialized to a default value by the <tt class="literal">printing</tt>
|
|---|
| 640 | option. Honors the <tt class="literal">%p</tt> (printer name) variable.</p></div>
|
|---|
| 641 | <a name="INDEX-219"/><a name="INDEX-220"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lpresume command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the command to resume a paused <a name="INDEX-220"/>print job.
|
|---|
| 642 | Honors the <tt class="literal">%p</tt> (printer name) and
|
|---|
| 643 | <tt class="literal">%j</tt> ( job number) variables.</p></div>
|
|---|
| 644 | <a name="INDEX-221"/><a name="INDEX-222"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>lprm command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the command to delete a <a name="INDEX-222"/>print job.
|
|---|
| 645 | Usually initialized to a default value by the
|
|---|
| 646 | <tt class="literal">printing</tt> option. Honors the <tt class="literal">%p</tt>
|
|---|
| 647 | (printer name) and <tt class="literal">%j</tt> (job number) variables.</p></div>
|
|---|
| 648 | <a name="INDEX-223"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>machine password timeout = number</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 604800 (1 week)</p><p>Sets the period between (NT domain) computer account password changes.</p></div>
|
|---|
| 649 | <a name="INDEX-224"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>magic output = filename</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: <em class="replaceable">command</em><em class="emphasis">.out</em></p><p>Sets the output file for the <tt class="literal">magic</tt>
|
|---|
| 650 | <tt class="literal">scripts</tt> option. Default is the command name,
|
|---|
| 651 | followed by the <em class="emphasis">.out</em> extension.</p></div>
|
|---|
| 652 | <a name="INDEX-225"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>magic script = filename</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets a filename for execution via a shell whenever the file is closed
|
|---|
| 653 | from the client, allowing clients to run commands on the server. The
|
|---|
| 654 | scripts will be deleted on completion, if permissions allow. Use is
|
|---|
| 655 | discouraged.</p></div>
|
|---|
| 656 | <a name="INDEX-226"/><a name="INDEX-227"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>mangle case = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p><a name="INDEX-227"/>Mangles a
|
|---|
| 657 | name if it is in mixed case.</p></div>
|
|---|
| 658 | <a name="INDEX-228"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>mangled map = map list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of to/from pairs</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets up a table of names to remap (e.g., <em class="emphasis">.html</em>
|
|---|
| 659 | to <em class="emphasis">.htm</em>).</p></div>
|
|---|
| 660 | <a name="INDEX-229"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>mangled names = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Sets Samba to abbreviate to the MS-DOS 8.3 style names that are too
|
|---|
| 661 | long or have unsupported characters.</p></div>
|
|---|
| 662 | <a name="INDEX-230"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>mangled stack = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 663 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 50</p><p>Sets the size of the cache of recently mangled filenames.</p></div>
|
|---|
| 664 | <a name="INDEX-231"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>mangling char = character</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: character</p><p><b class="emphasis-bold">Default</b>: ~</p><p>Sets the unique mangling character used in all mangled names.</p></div>
|
|---|
| 665 | <a name="INDEX-232"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>mangling method = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 666 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: hash, hash2</p><p><b class="emphasis-bold">Default</b>: hash</p><p>Sets the algorithm used to mangle filenames. The
|
|---|
| 667 | <tt class="literal">hash2</tt> method is a newer method introduced in Samba
|
|---|
| 668 | 2.2.x, and it creates different filenames than the
|
|---|
| 669 | <tt class="literal">hash</tt> method.</p></div>
|
|---|
| 670 | <a name="INDEX-233"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>map archive = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If YES, Samba sets the executable-by-user (0100) bit on Unix files if
|
|---|
| 671 | the MS-DOS archive attribute is set. If used, the
|
|---|
| 672 | <tt class="literal">create</tt> <tt class="literal">mask</tt> must contain the
|
|---|
| 673 | 0100 bit.</p></div>
|
|---|
| 674 | <a name="INDEX-234"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>map hidden = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If YES, Samba sets the executable-by-other (0001) bit on Unix files
|
|---|
| 675 | if the MS-DOS hidden attribute is set. If used, the <tt class="literal">create
|
|---|
| 676 | mask</tt> option must contain the 0001 bit.</p></div>
|
|---|
| 677 | <a name="INDEX-235"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>map system = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If YES, Samba sets the executable-by-group (0010) bit on Unix files
|
|---|
| 678 | if the MS-DOS system attribute is set. If used, the
|
|---|
| 679 | <tt class="literal">create</tt> <tt class="literal">mask</tt> must contain the
|
|---|
| 680 | 0010 bit.</p></div>
|
|---|
| 681 | <a name="INDEX-236"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>map to guest = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 682 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: Never, Bad User, Bad Password</p><p><b class="emphasis-bold">Default</b>: Never</p><p>If set to Bad User, allows users without accounts on the Samba system
|
|---|
| 683 | to log in and be assigned the guest account. This option can be used
|
|---|
| 684 | as part of making public shares for anyone to use. If set to Bad
|
|---|
| 685 | Password, users who mistype their passwords will be logged in to the
|
|---|
| 686 | guest account instead of their own. Because no warning is given, the
|
|---|
| 687 | Bad Password value can be extremely confusing: we recommend against
|
|---|
| 688 | it. The default setting of Never prevents users without accounts from
|
|---|
| 689 | logging in.</p></div>
|
|---|
| 690 | <a name="INDEX-237"/><a name="INDEX-238"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max connections = number</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0 (infinity)</p><p>Sets the maximum number of
|
|---|
| 691 | <a name="INDEX-238"/>share connections allowed from each
|
|---|
| 692 | client system.</p></div>
|
|---|
| 693 | <a name="INDEX-239"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max disk size = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 694 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: size in MB</p><p><b class="emphasis-bold">Default</b>: 0 (no limit)</p><p>Sets the maximum disk size/free-space size (in megabytes) to return
|
|---|
| 695 | to the client. Some clients or applications can't
|
|---|
| 696 | understand large maximum disk sizes.</p></div>
|
|---|
| 697 | <a name="INDEX-240"/><a name="INDEX-241"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max log size = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 698 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: size in KB</p><p><b class="emphasis-bold">Default</b>: 5000</p><p>Sets the size (in kilobytes) at which Samba will start a new
|
|---|
| 699 | <a name="INDEX-241"/>log file. The current log file will be
|
|---|
| 700 | renamed with a <em class="emphasis">.old</em> extension, replacing any
|
|---|
| 701 | existing file with that name.</p></div>
|
|---|
| 702 | <a name="INDEX-242"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max mux = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 703 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 50</p><p>Sets the number of simultaneous SMB operations that Samba clients can
|
|---|
| 704 | make. Avoid changing.</p></div>
|
|---|
| 705 | <a name="INDEX-243"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max open files = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 706 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 10000</p><p>Limits the number of files a Samba process will try to keep open at
|
|---|
| 707 | one time. Samba allows you to set this to less than the maximum
|
|---|
| 708 | imposed by the Unix host operating system. Avoid changing.</p></div>
|
|---|
| 709 | <a name="INDEX-244"/><a name="INDEX-245"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max print jobs = number</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: positive integer</p><p><b class="emphasis-bold">Default</b>: 1000</p><p>Limits the number of jobs that can be in the queue for this
|
|---|
| 710 | <a name="INDEX-245"/>printer share at any one time. The printer
|
|---|
| 711 | will report <tt class="literal">out of space</tt> if the limit is exceeded.
|
|---|
| 712 | See also <tt class="literal">total print jobs</tt>.</p></div>
|
|---|
| 713 | <a name="INDEX-246"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max protocol = name</i></b></font></td><td align="right"><i>[global]
|
|---|
| 714 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: CORE, COREPLUS, LANMAN1, LANMAN2, NT1</p><p><b class="emphasis-bold">Default</b>: NT1</p><p>If set, limits the negotiation to the protocol specified, or older.
|
|---|
| 715 | See <tt class="literal">min protocol</tt>. Avoid using.</p></div>
|
|---|
| 716 | <a name="INDEX-247"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max smbd processes = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 717 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: integer</p><p><b class="emphasis-bold">Default</b>: 0 (no limit)</p><p>Limits the number of users who can connect to the server. Used to
|
|---|
| 718 | prevent degraded service under an overload, at the cost of refusing
|
|---|
| 719 | services entirely.</p></div>
|
|---|
| 720 | <a name="INDEX-248"/><a name="INDEX-249"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max ttl = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 721 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 259200 (3 days)</p><p>Sets the <a name="INDEX-249"/>time to live (TTL) of NetBIOS names in the
|
|---|
| 722 | <em class="emphasis">nmbd</em> WINS cache. Avoid changing.</p></div>
|
|---|
| 723 | <a name="INDEX-250"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max wins ttl = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 724 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 518400 (6 days)</p><p>Limits the TTL, in seconds, of a NetBIOS name in the
|
|---|
| 725 | <em class="emphasis">nmbd</em> WINS cache. Avoid changing. See also
|
|---|
| 726 | <tt class="literal">min wins ttl</tt>.</p></div>
|
|---|
| 727 | <a name="INDEX-251"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>max xmit = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 728 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: size in bytes</p><p><b class="emphasis-bold">Default</b>: 65535</p><p>Sets the maximum packet size negotiated by Samba. This is a tuning
|
|---|
| 729 | parameter for slow links and bugs in older clients. Values less than
|
|---|
| 730 | 2048 are discouraged.</p></div>
|
|---|
| 731 | <a name="INDEX-252"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>message command = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 732 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the command to run on the server when a WinPopup message arrives
|
|---|
| 733 | from a client. If it does not complete quickly, the command must end
|
|---|
| 734 | in <tt class="literal">&</tt> to allow immediate return. Honors all
|
|---|
| 735 | <tt class="literal">%</tt> variables except <tt class="literal">%u</tt> (user)
|
|---|
| 736 | and supports the extra variables <tt class="literal">%s</tt> (filename the
|
|---|
| 737 | message is in), <tt class="literal">%t</tt> (destination system), and
|
|---|
| 738 | <tt class="literal">%f</tt> (from).</p></div>
|
|---|
| 739 | <a name="INDEX-253"/><a name="INDEX-254"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>min passwd length = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 740 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: integer</p><p><b class="emphasis-bold">Default</b>: 5</p><p><a name="INDEX-254"/>Synonym for <tt class="literal">min</tt>
|
|---|
| 741 | <tt class="literal">password</tt> <tt class="literal">length</tt>.</p></div>
|
|---|
| 742 | <a name="INDEX-255"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>min password length = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 743 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: integer</p><p><b class="emphasis-bold">Default</b>: 5</p><p>Sets the shortest Unix password allowed by Samba when updating a
|
|---|
| 744 | user's password on its system. Also called
|
|---|
| 745 | <tt class="literal">min</tt> <tt class="literal">passwd</tt>
|
|---|
| 746 | <tt class="literal">length</tt>.</p></div>
|
|---|
| 747 | <a name="INDEX-256"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>min print space = number</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: space in kilobytes</p><p><b class="emphasis-bold">Default</b>: 0 (unlimited)</p><p>Sets the minimum spool space required before accepting a print
|
|---|
| 748 | request.</p></div>
|
|---|
| 749 | <a name="INDEX-257"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>min protocol = name</i></b></font></td><td align="right"><i>[global]
|
|---|
| 750 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: CORE, COREPLUS, LANMAN1, LANMAN2, NT1</p><p><b class="emphasis-bold">Default</b>: CORE</p><p>If set, prevents use of old (less secure) protocols. Using NT1
|
|---|
| 751 | disables MS-DOS clients. See also <tt class="literal">lanman auth</tt>.</p></div>
|
|---|
| 752 | <a name="INDEX-258"/><a name="INDEX-259"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>min wins ttl = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 753 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 21600 (6 hours)</p><p>Sets the minimum <a name="INDEX-259"/>TTL, in seconds, of a NetBIOS name in the
|
|---|
| 754 | <em class="emphasis">nmbd</em> WINS cache. Avoid changing.</p></div>
|
|---|
| 755 | <a name="INDEX-260"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>msdfs root = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Makes the share a Dfs <tt class="literal">root</tt>. Requires the
|
|---|
| 756 | <tt class="literal">--with-msdfs</tt> configure option. Any symbolic links
|
|---|
| 757 | of the form <tt class="literal">msdfs:server\share</tt> will be seen as Dfs
|
|---|
| 758 | links. See also <tt class="literal">host msdfs</tt>.</p></div>
|
|---|
| 759 | <a name="INDEX-261"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>name resolve order = list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 760 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: lmhosts, wins, host, bcast</p><p><b class="emphasis-bold">Default</b>: lmhosts, host, wins, bcast</p><p>Sets the order of lookup when trying to get IP addresses from names.
|
|---|
| 761 | The host parameter carries out a regular name lookup using the
|
|---|
| 762 | server's normal sources:
|
|---|
| 763 | <em class="emphasis">/etc/hosts</em>, DNS, NIS, or a combination of these.</p></div>
|
|---|
| 764 | <a name="INDEX-262"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>netbios aliases = list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 765 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of NetBIOS names</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Adds additional NetBIOS names by which the Samba server will
|
|---|
| 766 | advertise itself.</p></div>
|
|---|
| 767 | <a name="INDEX-263"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>netbios name = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: local hostname</p><p><b class="emphasis-bold">Default</b>: DNS name of system</p><p>Sets the NetBIOS name by which a Samba server is known, or the
|
|---|
| 768 | primary name if NetBIOS aliases exist. See also <tt class="literal">netbios
|
|---|
| 769 | aliases</tt>.</p></div>
|
|---|
| 770 | <a name="INDEX-264"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>netbios scope = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 771 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: string</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the NetBIOS scope string, an early predecessor of workgroups.
|
|---|
| 772 | Samba will not communicate with a system with a different scope. This
|
|---|
| 773 | option is not recommended.</p></div>
|
|---|
| 774 | <a name="INDEX-265"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>nis homedir = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 775 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If YES, the <tt class="literal">homedir</tt> <tt class="literal">map</tt> is used
|
|---|
| 776 | to look up the server hosting the user's home
|
|---|
| 777 | directory and return it to the client. The client will contact that
|
|---|
| 778 | system to connect to the share. This avoids mounting from a system
|
|---|
| 779 | that doesn't actually have the directory, which
|
|---|
| 780 | would cause the data to be transmitted twice. The system with the
|
|---|
| 781 | home directories must be an SMB server.</p></div>
|
|---|
| 782 | <a name="INDEX-266"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>non unix account range = numeric range</i></b></font></td><td align="right"><i>[global]
|
|---|
| 783 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: range of positive integers</p><p><b class="emphasis-bold">Default</b>: NONE</p><p>Specifies a range of Unix UIDs for Samba to use for user accounts and
|
|---|
| 784 | computer accounts that are maintained outside of
|
|---|
| 785 | <em class="filename">/etc/passwd</em>. The UIDs in this range must not
|
|---|
| 786 | overlap those of regular Unix users in
|
|---|
| 787 | <em class="filename">/etc/passwd</em>. See also <tt class="literal">algorithmic rid
|
|---|
| 788 | base</tt>. New in Samba 3.0.</p></div>
|
|---|
| 789 | <a name="INDEX-267"/><a name="INDEX-268"/><a name="INDEX-269"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>nt acl support = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Causes the Samba server to map Unix
|
|---|
| 790 | <a name="INDEX-268"/><a name="INDEX-269"/>permissions to Windows NT
|
|---|
| 791 | ACLs.</p></div>
|
|---|
| 792 | <a name="INDEX-270"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>nt pipe support = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 793 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Allows turning off of NT-specific pipe calls. This is a
|
|---|
| 794 | developer/benchmarking option and might be removed in the future.
|
|---|
| 795 | Avoid changing.</p></div>
|
|---|
| 796 | <a name="INDEX-271"/><a name="INDEX-272"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>nt smb support = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 797 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If YES, allows the use of NT-specific SMBs. This is a
|
|---|
| 798 | developer/benchmarking option that is <a name="INDEX-272"/>obsolete in Samba 3.0. Avoid changing.</p></div>
|
|---|
| 799 | <a name="INDEX-273"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>nt status support = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 800 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If YES, allows the use of NT-specific status messages. This is a
|
|---|
| 801 | developer/benchmarking option and might be removed in the future.
|
|---|
| 802 | Avoid changing.</p></div>
|
|---|
| 803 | <a name="INDEX-274"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>null passwords = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 804 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If YES, allows access to accounts that have null passwords. Strongly
|
|---|
| 805 | discouraged.</p></div>
|
|---|
| 806 | <a name="INDEX-275"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>obey pam restrictions = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 807 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set, Samba will adhere to the PAM's account and
|
|---|
| 808 | session restrictions. Requires <tt class="literal">--with-pam</tt>
|
|---|
| 809 | configuration option.</p></div>
|
|---|
| 810 | <a name="INDEX-276"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>only guest = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Forces users of a share to log on as the guest account. Synonym for
|
|---|
| 811 | <tt class="literal">guest</tt> <tt class="literal">only</tt>. Requires
|
|---|
| 812 | <tt class="literal">guest</tt> <tt class="literal">ok</tt> or
|
|---|
| 813 | <tt class="literal">public</tt> to be YES.</p></div>
|
|---|
| 814 | <a name="INDEX-277"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>only user = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Requires that users of the share be in the list specified by the
|
|---|
| 815 | <tt class="literal">user</tt> option.</p></div>
|
|---|
| 816 | <a name="INDEX-278"/><a name="INDEX-279"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>oplock break wait time = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 817 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0</p><p><a name="INDEX-279"/>This is an advanced tuning parameter and
|
|---|
| 818 | is recommended only for experts who know how Samba handles oplocks.
|
|---|
| 819 | This option might need to be set if a Windows system fails to release
|
|---|
| 820 | an oplock in response to a break request from the Samba server. Due
|
|---|
| 821 | to bugs on some Windows systems, they might fail to respond if Samba
|
|---|
| 822 | responds too quickly; the default on this option can be lengthened in
|
|---|
| 823 | such cases.</p></div>
|
|---|
| 824 | <a name="INDEX-280"/><a name="INDEX-281"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>oplock contention limit = number</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of milliseconds</p><p><b class="emphasis-bold">Default</b>: 2</p><p><a name="INDEX-281"/>This is an advanced tuning
|
|---|
| 825 | parameter and is recommended only for experts who know how Samba
|
|---|
| 826 | handles oplocks. It causes Samba to refuse to grant an oplock if the
|
|---|
| 827 | number of clients contending for a file exceeds the specified value.</p></div>
|
|---|
| 828 | <a name="INDEX-282"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>oplocks = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If YES, supports local caching of oplocked files on the client. This
|
|---|
| 829 | option is recommended because it improves performance by about 30%.
|
|---|
| 830 | See also <tt class="literal">fake</tt> <tt class="literal">oplocks</tt> and
|
|---|
| 831 | <tt class="literal">veto</tt> <tt class="literal">oplock</tt>
|
|---|
| 832 | <tt class="literal">files</tt>.</p></div>
|
|---|
| 833 | <a name="INDEX-283"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>os level = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 834 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: integer</p><p><b class="emphasis-bold">Default</b>: 20</p><p>Sets the candidacy of the server when electing a browse master. Used
|
|---|
| 835 | with the <tt class="literal">domain</tt> <tt class="literal">master</tt> or
|
|---|
| 836 | <tt class="literal">local</tt> <tt class="literal">master</tt> options. You can
|
|---|
| 837 | set a higher value than a competing operating system if you want
|
|---|
| 838 | Samba to win. Windows for Workgroups and Windows 95/98/Me use 1.
|
|---|
| 839 | Windows NT/2000/XP, when not acting as a PDC, use 16 and, when acting
|
|---|
| 840 | as a PDC, use 32. Warning: this can override non-Samba browse masters
|
|---|
| 841 | unexpectedly.</p></div>
|
|---|
| 842 | <a name="INDEX-284"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>os2 driver map = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 843 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a file containing mappings of Windows NT printer driver
|
|---|
| 844 | names to OS/2 printer driver names.</p></div>
|
|---|
| 845 | <a name="INDEX-285"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>pam password change = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 846 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If YES, and if Samba is configured with
|
|---|
| 847 | <tt class="literal">--with-pam</tt>, PAM is allowed to handle password
|
|---|
| 848 | changes from clients, instead of using the program defined by the
|
|---|
| 849 | <tt class="literal">passwd</tt> <tt class="literal">program</tt> parameter.</p></div>
|
|---|
| 850 | <a name="INDEX-286"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>panic action = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 851 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the command to run when Samba panics. Honors all
|
|---|
| 852 | <tt class="literal">%</tt> variables. For Samba developers and testers,
|
|---|
| 853 | <tt class="literal">/usr/bin/X11/xterm</tt> <tt class="literal">-display</tt>
|
|---|
| 854 | <tt class="literal">:0</tt> <tt class="literal">-e</tt> <tt class="literal">gdb</tt>
|
|---|
| 855 | <tt class="literal">/samba/bin/smbd</tt> <tt class="literal">%d</tt> is a
|
|---|
| 856 | possible value.</p></div>
|
|---|
| 857 | <a name="INDEX-287"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>passdb backend = list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 858 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: smbpasswd, smbpasswd_nua, tdbsam, tdbsam_nua, plugin</p><p><b class="emphasis-bold">Default</b>: smbpasswd</p><p>Specifies methods Samba uses to store and retrieve passwords when
|
|---|
| 859 | using a method other than the Unix system's
|
|---|
| 860 | <em class="filename">/etc/passwd</em>. See also <tt class="literal">non unix account
|
|---|
| 861 | range</tt>. New in Samba 3.0.</p></div>
|
|---|
| 862 | <a name="INDEX-288"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>passwd chat = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 863 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: sequence of strings</p><p><b class="emphasis-bold">Default</b>: compiled-in value</p><p>Sets the chat strings used to change passwords on the server.
|
|---|
| 864 | Supports the variables <tt class="literal">%o</tt> (old password) and
|
|---|
| 865 | <tt class="literal">%n</tt> (new password) and allows the escapes
|
|---|
| 866 | <tt class="literal">\r</tt>, <tt class="literal">\n</tt>, <tt class="literal">\t</tt>,
|
|---|
| 867 | and <tt class="literal">\s</tt> (space) in the sequence. See also
|
|---|
| 868 | <tt class="literal">unix password sync</tt>, <tt class="literal">passwd
|
|---|
| 869 | program</tt>, <tt class="literal">passwd chat debug</tt>, and
|
|---|
| 870 | <tt class="literal">pam</tt> <tt class="literal">password change</tt>.</p></div>
|
|---|
| 871 | <a name="INDEX-289"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>passwd chat debug = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 872 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Logs an entire password chat, including passwords passed, with a log
|
|---|
| 873 | level of 100. For debugging only. See also <tt class="literal">passwd
|
|---|
| 874 | chat</tt>, <tt class="literal">pam password change</tt>, and
|
|---|
| 875 | <tt class="literal">passwd program</tt>.</p></div>
|
|---|
| 876 | <a name="INDEX-290"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>passwd program = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 877 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/bin/passwd</em></p><p>Sets the command used to change a user's password.
|
|---|
| 878 | Will be run as <tt class="literal">root</tt>. Supports
|
|---|
| 879 | <tt class="literal">%u</tt> (user). See also <tt class="literal">unix password
|
|---|
| 880 | sync</tt>.</p></div>
|
|---|
| 881 | <a name="INDEX-291"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>password level = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 882 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Specifies the number of uppercase-letter permutations used to match
|
|---|
| 883 | passwords. A workaround for clients that change passwords to a single
|
|---|
| 884 | case before sending them to the Samba server. Causes repeated login
|
|---|
| 885 | attempts with mixed-case passwords, which can trigger account
|
|---|
| 886 | lockouts. Required for Windows 95/98/Me, plain-text passwords, and
|
|---|
| 887 | mixed-case passwords. Try to avoid using.</p></div>
|
|---|
| 888 | <a name="INDEX-292"/><a name="INDEX-293"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>password server = list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of NetBIOS names</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of SMB servers that validate
|
|---|
| 889 | <a name="INDEX-293"/>passwords. Used with a Windows
|
|---|
| 890 | NT/2000 password server (PDC or BDC) and the
|
|---|
| 891 | <tt class="literal">security</tt> <tt class="literal">=</tt>
|
|---|
| 892 | <tt class="literal">server</tt> or <tt class="literal">security</tt>
|
|---|
| 893 | <tt class="literal">=</tt> <tt class="literal">domain</tt> configuration options.
|
|---|
| 894 | Caution: a Windows NT/2000 password server must allow logins from the
|
|---|
| 895 | Samba server. If set to <tt class="literal">*</tt>, Samba will look up the
|
|---|
| 896 | PDC by resolving the NetBIOS name WORKGROUP<1C>.</p></div>
|
|---|
| 897 | <a name="INDEX-294"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>path = directory</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the path to the directory provided by a file share or used by a
|
|---|
| 898 | printer share. If the option is omitted, it is set automatically in
|
|---|
| 899 | the <tt class="literal">[homes]</tt> share to the user's
|
|---|
| 900 | home directory; otherwise, defaults to<em class="filename"> /tmp</em>.
|
|---|
| 901 | Honors the <tt class="literal">%u</tt> (user) and <tt class="literal">%m</tt>
|
|---|
| 902 | (machine) variables.</p></div>
|
|---|
| 903 | <a name="INDEX-295"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>pid directory = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 904 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/samba/var/locks</em></p><p>Sets the path to the directory where PID files are located.</p></div>
|
|---|
| 905 | <a name="INDEX-296"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>posix locking = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to YES, Samba will map file locks owned by SMB clients to
|
|---|
| 906 | POSIX locks. Avoid changing.</p></div>
|
|---|
| 907 | <a name="INDEX-297"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>postexec = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets a command to run as the user after disconnecting from the share.
|
|---|
| 908 | See also the <tt class="literal">preexec</tt>, <tt class="literal">root</tt>
|
|---|
| 909 | <tt class="literal">preexec</tt>, and <tt class="literal">root</tt>
|
|---|
| 910 | <tt class="literal">postexec</tt> options.</p></div>
|
|---|
| 911 | <a name="INDEX-298"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>postscript = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Forces a printer to recognize a file as PostScript by inserting
|
|---|
| 912 | <tt class="literal">%!</tt> as the first line. Works only if the printer is
|
|---|
| 913 | actually PostScript-compatible.</p></div>
|
|---|
| 914 | <a name="INDEX-299"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>preexec = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets a command to run as the user before connecting to the share.
|
|---|
| 915 | Synonym for <tt class="literal">exec</tt>. See also the
|
|---|
| 916 | <tt class="literal">postexec</tt>, <tt class="literal">root</tt>
|
|---|
| 917 | <tt class="literal">preexec</tt>, and <tt class="literal">root</tt>
|
|---|
| 918 | <tt class="literal">postexec</tt> options.</p></div>
|
|---|
| 919 | <a name="INDEX-300"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>preexec close = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set, allows the <tt class="literal">preexec</tt> command to decide if
|
|---|
| 920 | the share can be accessed by the user. If the command returns a
|
|---|
| 921 | nonzero return code, the user is denied permission to connect.</p></div>
|
|---|
| 922 | <a name="INDEX-301"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>preferred master = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 923 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: auto</p><p>If YES, Samba is the preferred master browser. Causes Samba to call a
|
|---|
| 924 | browsing election when it comes online. See also <tt class="literal">os
|
|---|
| 925 | level</tt>.</p></div>
|
|---|
| 926 | <a name="INDEX-302"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>prefered master = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 927 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: auto</p><p>Synonym for <tt class="literal">preferred master</tt>.</p></div>
|
|---|
| 928 | <a name="INDEX-303"/><a name="INDEX-304"/><a name="INDEX-305"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>preload = service list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of shares</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of shares that always appears in
|
|---|
| 929 | <a name="INDEX-304"/><a name="INDEX-305"/>browse lists. Synonym for
|
|---|
| 930 | <tt class="literal">auto</tt> <tt class="literal">services</tt>. See also
|
|---|
| 931 | <tt class="literal">load printers</tt>.</p></div>
|
|---|
| 932 | <a name="INDEX-306"/><a name="INDEX-307"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>preserve case = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p><a name="INDEX-307"/>Leaves filenames in the case
|
|---|
| 933 | sent by the client. If NO, it forces filenames to the case specified
|
|---|
| 934 | by the <tt class="literal">default</tt> <tt class="literal">case</tt> option. See
|
|---|
| 935 | also <tt class="literal">short</tt> <tt class="literal">preserve</tt>
|
|---|
| 936 | <tt class="literal">case</tt>.</p></div>
|
|---|
| 937 | <a name="INDEX-308"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printable = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Sets a share to be a print share. Required for all printers. Synonym
|
|---|
| 938 | for <tt class="literal">print</tt> <tt class="literal">ok</tt>.</p></div>
|
|---|
| 939 | <a name="INDEX-309"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printcap name = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 940 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: <em class="emphasis">/etc/printcap</em></p><p>Sets the path to the printer capabilities file used by the
|
|---|
| 941 | <tt class="literal">[printers]</tt> share. The default value changes to
|
|---|
| 942 | <em class="filename">/etc/qconfig</em> under AIX and
|
|---|
| 943 | <em class="filename">lpstat</em> on System V. Also called
|
|---|
| 944 | <tt class="literal">printcap</tt>.</p></div>
|
|---|
| 945 | <a name="INDEX-310"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>print command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the command used to send a spooled file to the printer. Usually
|
|---|
| 946 | initialized to a default value corresponding to the
|
|---|
| 947 | <tt class="literal">printing</tt> option. This option honors the
|
|---|
| 948 | <tt class="literal">%p</tt> (printer name), <tt class="literal">%s</tt> (spool
|
|---|
| 949 | file), and <tt class="literal">%f</tt> (spool file as a relative path)
|
|---|
| 950 | variables. The command must delete the spool file.</p></div>
|
|---|
| 951 | <a name="INDEX-311"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printer = name</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: printer name</p><p><b class="emphasis-bold">Default</b>: lp</p><p>Sets the name of the Unix printer used by the share. Also called
|
|---|
| 952 | <tt class="literal">printer</tt> <tt class="literal">name</tt>.</p></div>
|
|---|
| 953 | <a name="INDEX-312"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printer admin = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies users who can administer a printer using the remote printer
|
|---|
| 954 | administration interface on a Windows system. The
|
|---|
| 955 | <tt class="literal">root</tt> user always has these privileges.</p></div>
|
|---|
| 956 | <a name="INDEX-313"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printer driver = name</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: exact printer driver string used by Windows</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the string to pass to Windows when asked which driver to use to
|
|---|
| 957 | prepare files for a printer share. Note that the value is
|
|---|
| 958 | case-sensitive. Part of pre-2.2 printing system. Deprecated.</p></div>
|
|---|
| 959 | <a name="INDEX-314"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printer driver file = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 960 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: <em class="emphasis">/usr/local/samba/printers/printers.def</em></p><p>Sets the location of a <em class="emphasis">msprint.def</em> file. Usable
|
|---|
| 961 | by Windows 95/98/Me. Part of pre-2.2 printing system. Deprecated.</p></div>
|
|---|
| 962 | <a name="INDEX-315"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printer driver location = directory</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: UNC of shared directory</p><p><b class="emphasis-bold">Default</b>: <em class="filename">\\ server\ PRINTER$</em></p><p>Sets the location of the driver for a particular printer. The value
|
|---|
| 963 | is the pathname of the share that stores the printer driver files.
|
|---|
| 964 | Part of pre-2.2 printing system. Deprecated.</p></div>
|
|---|
| 965 | <a name="INDEX-316"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printer name = name</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Synonym for <tt class="literal">printer</tt>.</p></div>
|
|---|
| 966 | <a name="INDEX-317"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>printing = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: bsd, sysv, hpux, aix, qnx, plp, softq, lprng, cups</p><p><b class="emphasis-bold">Default</b>: bsd</p><p>Sets the printing style to a value other than that in which
|
|---|
| 967 | you've compiled. This sets initial values of at
|
|---|
| 968 | least <tt class="literal">print</tt> <tt class="literal">command</tt> ,
|
|---|
| 969 | <tt class="literal">lpq</tt> <tt class="literal">command</tt> , and
|
|---|
| 970 | <tt class="literal">lprm</tt> <tt class="literal">command</tt>.</p></div>
|
|---|
| 971 | <a name="INDEX-318"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>print ok = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Synonym for <tt class="literal">printable</tt>.</p></div>
|
|---|
| 972 | <a name="INDEX-319"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>private directory = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 973 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/samba/private</em></p><p>Specifies the directory used for storing security-sensitive files
|
|---|
| 974 | such as <em class="filename">smbpasswd</em> and
|
|---|
| 975 | <em class="filename">secrets.tdb</em>. New in Samba 3.0.</p></div>
|
|---|
| 976 | <a name="INDEX-320"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>protocol = name</i></b></font></td><td align="right"><i>[global]
|
|---|
| 977 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: NT1, LANMAN2, LANMAN1, COREPLUS, CORE</p><p><b class="emphasis-bold">Default</b>: NT1</p><p>Synonym for <tt class="literal">max protocol</tt>.</p></div>
|
|---|
| 978 | <a name="INDEX-321"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>public = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If YES, passwords are not needed for this share. Also called
|
|---|
| 979 | <tt class="literal">guest</tt> <tt class="literal">ok</tt>.</p></div>
|
|---|
| 980 | <a name="INDEX-322"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>queuepause command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full path to script</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the command used to pause a print queue. Usually initialized to
|
|---|
| 981 | a default value by the <tt class="literal">printing</tt> option.</p></div>
|
|---|
| 982 | <a name="INDEX-323"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>queueresume command = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full path to script</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Sets the command used to resume a print queue. Usually initialized to
|
|---|
| 983 | a default value by the <tt class="literal">printing</tt> option.</p></div>
|
|---|
| 984 | <a name="INDEX-324"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>read bmpx = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, supports the "Read Block
|
|---|
| 985 | Multiplex" message. Avoid changing.</p></div>
|
|---|
| 986 | <a name="INDEX-325"/><a name="INDEX-326"/><a name="INDEX-327"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>read list = list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of user and/or group names</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of <a name="INDEX-326"/><a name="INDEX-327"/>users given read-only access
|
|---|
| 987 | to a writable share.</p></div>
|
|---|
| 988 | <a name="INDEX-328"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>read only = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Sets a share to read-only. Antonym of <tt class="literal">writable</tt>,
|
|---|
| 989 | <tt class="literal">writeable</tt>, and <tt class="literal">write ok</tt>.</p></div>
|
|---|
| 990 | <a name="INDEX-329"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>read raw = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 991 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Allows clients to read data using a 64K packet size. Recommended.</p></div>
|
|---|
| 992 | <a name="INDEX-330"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>read size = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 993 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: positive integer</p><p><b class="emphasis-bold">Default</b>: 16384</p><p>Allows disk reads and writes to overlap network reads and writes. A
|
|---|
| 994 | tuning parameter. Do not set larger than the default.</p></div>
|
|---|
| 995 | <a name="INDEX-331"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>realm = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 996 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: Kerberos realm name</p><p><b class="emphasis-bold">Default</b>: NONE</p><p>Specifies the realm name for Kerberos 5 authentication. Requires the
|
|---|
| 997 | <tt class="literal">--with-krb5</tt> configure option. New in Samba 3.0.</p></div>
|
|---|
| 998 | <a name="INDEX-332"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>remote announce = remote list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 999 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of remote addresses</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Adds workgroups to the list on which the Samba server will announce
|
|---|
| 1000 | itself. Specified as an IP address and optional workgroup (for
|
|---|
| 1001 | instance, 192.168.220.215/SIMPLE) with multiple entries separated by
|
|---|
| 1002 | spaces. Addresses can be the specific address of the browse master on
|
|---|
| 1003 | a subnet or on directed broadcasts (i.e., ###.###.###.255). The
|
|---|
| 1004 | server will appear on those workgroups' browse
|
|---|
| 1005 | lists. Does not require WINS.</p></div>
|
|---|
| 1006 | <a name="INDEX-333"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>remote browse sync = list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1007 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: IP addresses</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Perform browse list synchronization with other Samba local master
|
|---|
| 1008 | browsers. Addresses can be specific addresses or directed broadcasts
|
|---|
| 1009 | (i.e., ###.###.###.255). The latter causes Samba to locate the local
|
|---|
| 1010 | master browser on that subnet.</p></div>
|
|---|
| 1011 | <a name="INDEX-334"/><a name="INDEX-335"/><a name="INDEX-336"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>restrict anonymous = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1012 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p><a name="INDEX-335"/><a name="INDEX-336"/>Denies access to users who do not
|
|---|
| 1013 | supply a username. This is disabled by default because when the Samba
|
|---|
| 1014 | server acts as the domain's PDC, the option can keep
|
|---|
| 1015 | a client from revalidating its computer account when someone new logs
|
|---|
| 1016 | in. Use of the option is recommended only when all clients are
|
|---|
| 1017 | Windows NT/2000/XP systems.</p></div>
|
|---|
| 1018 | <a name="INDEX-337"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>root = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1019 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Synonym for <tt class="literal">root</tt> <tt class="literal">directory</tt>.</p></div>
|
|---|
| 1020 | <a name="INDEX-338"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>root dir = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1021 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Synonym for <tt class="literal">root</tt> <tt class="literal">directory</tt>.</p></div>
|
|---|
| 1022 | <a name="INDEX-339"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>root directory = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1023 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: /</p><p>Specifies a directory to <em class="emphasis">chroot( )</em> before
|
|---|
| 1024 | starting daemons. Prevents any access outside that directory tree.
|
|---|
| 1025 | See also the <tt class="literal">wide</tt> <tt class="literal">links</tt>
|
|---|
| 1026 | configuration option. Also called <tt class="literal">root</tt> and
|
|---|
| 1027 | <tt class="literal">root</tt> <tt class="literal">dir</tt>.</p></div>
|
|---|
| 1028 | <a name="INDEX-340"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>root postexec = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets a command to run as <tt class="literal">root</tt> after disconnecting
|
|---|
| 1029 | from the share. See also the <tt class="literal">preexec</tt>,
|
|---|
| 1030 | <tt class="literal">postexec</tt>, and <tt class="literal">root</tt>
|
|---|
| 1031 | <tt class="literal">preexec</tt> configuration options. Runs after the
|
|---|
| 1032 | user's <tt class="literal">postexec</tt> command. Use with
|
|---|
| 1033 | caution.</p></div>
|
|---|
| 1034 | <a name="INDEX-341"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>root preexec = command</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets a command to run as <tt class="literal">root</tt> before connecting to
|
|---|
| 1035 | the share. See also the <tt class="literal">preexec</tt>,
|
|---|
| 1036 | <tt class="literal">postexec</tt>, and <tt class="literal">root</tt>
|
|---|
| 1037 | <tt class="literal">postexec</tt> configuration options. Runs before the
|
|---|
| 1038 | user's <tt class="literal">preexec</tt> command. Use with
|
|---|
| 1039 | caution.</p></div>
|
|---|
| 1040 | <a name="INDEX-342"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>root preexec close = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set, allows the <tt class="literal">root</tt> <tt class="literal">preexec</tt>
|
|---|
| 1041 | command to decide if the share can be accessed by the user. If the
|
|---|
| 1042 | command returns a nonzero return code, the user will be denied
|
|---|
| 1043 | permission to connect.</p></div>
|
|---|
| 1044 | <a name="INDEX-343"/><a name="INDEX-344"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>security = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1045 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: share, user, server, domain</p><p><b class="emphasis-bold">Default</b>: user</p><p>Sets the client
|
|---|
| 1046 | <a name="INDEX-344"/>authentication method. If
|
|---|
| 1047 | <tt class="literal">security</tt> <tt class="literal">=</tt>
|
|---|
| 1048 | <tt class="literal">share</tt>, services are password-protected, available
|
|---|
| 1049 | to everyone who knows the password. If <tt class="literal">security</tt>
|
|---|
| 1050 | <tt class="literal">=</tt> <tt class="literal">user</tt>, users have accounts and
|
|---|
| 1051 | passwords, and are required to authenticate with the server before
|
|---|
| 1052 | accessing services. If <tt class="literal">security</tt>
|
|---|
| 1053 | <tt class="literal">=</tt> <tt class="literal">server</tt>, users have accounts
|
|---|
| 1054 | and passwords as with <tt class="literal">security = user</tt>, and a
|
|---|
| 1055 | separate system authenticates them for Samba. If
|
|---|
| 1056 | <tt class="literal">security</tt> <tt class="literal">=</tt>
|
|---|
| 1057 | <tt class="literal">domain</tt>, Windows NT domain authentication is
|
|---|
| 1058 | implemented using a Windows NT/2000 or other Samba server to validate
|
|---|
| 1059 | accounts. See also the <tt class="literal">password server</tt> and
|
|---|
| 1060 | <tt class="literal">encrypted</tt> <tt class="literal">passwords</tt>
|
|---|
| 1061 | configuration options.</p></div>
|
|---|
| 1062 | <a name="INDEX-345"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>security mask = value</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: octal value from 0 to 0777</p><p><b class="emphasis-bold">Default</b>: 0777</p><p>Controls which permission bits can be changed if a user on a Windows
|
|---|
| 1063 | NT/2000/XP system edits the Unix permissions of files on the Samba
|
|---|
| 1064 | server using the Windows system's ACL editing dialog
|
|---|
| 1065 | box. Any bit that is set in the mask can be changed by the user; any
|
|---|
| 1066 | bit that is clear remains the same on the file even if the user tries
|
|---|
| 1067 | to change it. Requires <tt class="literal">nt</tt> <tt class="literal">acl</tt>
|
|---|
| 1068 | <tt class="literal">support</tt> <tt class="literal">=</tt>
|
|---|
| 1069 | <tt class="literal">YES</tt>. Note that some rarely used bits map to the
|
|---|
| 1070 | DOS system, hidden, and archive bits in the file attributes in a
|
|---|
| 1071 | nonintuitive way.</p></div>
|
|---|
| 1072 | <a name="INDEX-346"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>server string = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1073 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: string</p><p><b class="emphasis-bold">Default</b>: Samba <tt class="literal">%v</tt></p><p>Sets the name that corresponds to the Samba server in browse lists.
|
|---|
| 1074 | Honors the <tt class="literal">%v</tt> (Samba version number) and
|
|---|
| 1075 | <tt class="literal">%h</tt> (hostname) variables.</p></div>
|
|---|
| 1076 | <a name="INDEX-347"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>set directory = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Allows the DEC Pathworks client to use the <em class="emphasis">set
|
|---|
| 1077 | dir</em> command.</p></div>
|
|---|
| 1078 | <a name="INDEX-348"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>share modes = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Directs Samba to support Windows-style whole-file (deny mode) locks.
|
|---|
| 1079 | Do not change.</p></div>
|
|---|
| 1080 | <a name="INDEX-349"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>short preserve case = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to YES, leaves mangled 8.3-style filenames in the case sent by
|
|---|
| 1081 | the client. If NO, forces the case to that specified by the
|
|---|
| 1082 | <tt class="literal">default</tt> <tt class="literal">case</tt> option. See also
|
|---|
| 1083 | <tt class="literal">preserve</tt> <tt class="literal">case</tt>.</p></div>
|
|---|
| 1084 | <a name="INDEX-350"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>show add printer wizard = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1085 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set, tells clients that the Add Printer Wizard can be used to add
|
|---|
| 1086 | a Samba printer from Windows NT/2000/XP clients. See also
|
|---|
| 1087 | <tt class="literal">add printer command</tt>, <tt class="literal">delete
|
|---|
| 1088 | printer</tt> <tt class="literal">comamnd</tt>, and <tt class="literal">printer
|
|---|
| 1089 | admin</tt>.</p></div>
|
|---|
| 1090 | <a name="INDEX-351"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>shutdown script = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1091 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: command</p><p><b class="emphasis-bold">Default</b>: NONE</p><p>Specifies a command that initiates a system shutdown. The command is
|
|---|
| 1092 | run with the UID of the connected user. The <tt class="literal">%m</tt>
|
|---|
| 1093 | (message), <tt class="literal">%t</tt> (delay time), <tt class="literal">%r</tt>
|
|---|
| 1094 | (reboot), and <tt class="literal">%f</tt> (force) options are supported.
|
|---|
| 1095 | See also <tt class="literal">abort shutdown script</tt>. New in Samba 3.0.</p></div>
|
|---|
| 1096 | <a name="INDEX-352"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>smb passwd file = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1097 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/samba/private/smbpasswd</em></p><p>Overrides the compiled-in path to the encrypted password file. See
|
|---|
| 1098 | also <tt class="literal">encrypted</tt> <tt class="literal">passwords</tt> and
|
|---|
| 1099 | <tt class="literal">private dir</tt>.</p></div>
|
|---|
| 1100 | <a name="INDEX-353"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>socket address = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1101 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: IP address</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the address on which to listen for connections. Default is to
|
|---|
| 1102 | listen to all addresses.</p></div>
|
|---|
| 1103 | <a name="INDEX-354"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>socket options = list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1104 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: socket option list</p><p><b class="emphasis-bold">Default</b>: TCP_NODELAY</p><p>Sets OS-specific socket options. SO_KEEPALIVE makes TCP check clients
|
|---|
| 1105 | every four hours to see if they are still accessible. TCP_NODELAY
|
|---|
| 1106 | sends even tiny packets to keep delay low. Both are recommended
|
|---|
| 1107 | wherever the operating system supports them.</p></div>
|
|---|
| 1108 | <a name="INDEX-355"/><a name="INDEX-356"/><a name="INDEX-357"/><a name="INDEX-358"/><a name="INDEX-359"/><a name="INDEX-360"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>source environment = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1109 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Causes Samba to read a list of <a name="INDEX-356"/>environment variables from a file upon
|
|---|
| 1110 | startup. This can be useful when setting up Samba in a
|
|---|
| 1111 | <a name="INDEX-357"/><a name="INDEX-358"/><a name="INDEX-359"/><a name="INDEX-360"/>clustered environment. The
|
|---|
| 1112 | filename can begin with a "|"
|
|---|
| 1113 | (pipe) character, in which case it causes Samba to run the file as a
|
|---|
| 1114 | command to obtain the variables.</p><p>The file must be owned by <tt class="literal">root</tt> and must not be
|
|---|
| 1115 | world-writable. If the filename begins with a
|
|---|
| 1116 | "|" character, it must point to a
|
|---|
| 1117 | command that is neither world-writable nor resides in a
|
|---|
| 1118 | world-writable directory.</p><p>The data should be in the form of lines such as
|
|---|
| 1119 | SAMBA_NETBIOS_NAME=<em class="replaceable">myhostname</em>. This value
|
|---|
| 1120 | will then be available in the <em class="filename">smb.conf</em> files as
|
|---|
| 1121 | %$SAMBA_NETBIOS_NAME.</p></div>
|
|---|
| 1122 | <a name="INDEX-361"/><a name="INDEX-362"/><a name="INDEX-363"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1123 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p><a name="INDEX-362"/><a name="INDEX-363"/>Makes
|
|---|
| 1124 | Samba use SSL for data exchange with some or all hosts. Requires
|
|---|
| 1125 | <tt class="literal">--with-ssl</tt> configure option.Obsolete starting with
|
|---|
| 1126 | Samba 3.0.</p></div>
|
|---|
| 1127 | <a name="INDEX-364"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl CA certDir = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1128 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/ssl/certs</em></p><p>Specifies a directory containing a file for each Certification
|
|---|
| 1129 | Authority (CA) that the Samba server trusts so that Samba can verify
|
|---|
| 1130 | client certificates. Part of SSL support. Requires
|
|---|
| 1131 | <tt class="literal">--with-ssl</tt> configure option. Obsolete starting
|
|---|
| 1132 | with Samba 3.0.</p></div>
|
|---|
| 1133 | <a name="INDEX-365"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl CA certFile = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1134 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/ssl/certs/trustedCAs.pem</em></p><p>Specifies a file that contains information for each CA that the Samba
|
|---|
| 1135 | server trusts so that Samba can verify client certificates. Part of
|
|---|
| 1136 | SSL support. Requires <tt class="literal">--with-ssl</tt> configure option.
|
|---|
| 1137 | Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 1138 | <a name="INDEX-366"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl ciphers = list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1139 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of ciphers</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies which ciphers should be offered during SSL negotiation. Not
|
|---|
| 1140 | recommended. Requires <tt class="literal">--with-ssl</tt> configure option.
|
|---|
| 1141 | Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 1142 | <a name="INDEX-367"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl client cert = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1143 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/ssl/certs/smbclient.pem</em></p><p>Specifies a file containing the server's SSL
|
|---|
| 1144 | certificate, for use by <em class="emphasis">smbclient</em> if
|
|---|
| 1145 | certificates are required in this environment. Requires
|
|---|
| 1146 | <tt class="literal">--with-ssl</tt> configure option. Obsolete starting
|
|---|
| 1147 | with Samba 3.0.</p></div>
|
|---|
| 1148 | <a name="INDEX-368"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl client key = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1149 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/usr/local/ssl/private/smbclient.pem</em></p><p>Specifies a file containing the server's private SSL
|
|---|
| 1150 | key, for use by <em class="emphasis">smbclient</em>. Requires
|
|---|
| 1151 | <tt class="literal">--with-ssl</tt> configure option. Obsolete starting
|
|---|
| 1152 | with Samba 3.0.</p></div>
|
|---|
| 1153 | <a name="INDEX-369"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl compatibility = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1154 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Determines whether SSLeay should be configured for bug compatibility
|
|---|
| 1155 | with other SSL implementations. Not recommended. Requires
|
|---|
| 1156 | <tt class="literal">--with-ssl</tt> configure option. Obsolete starting
|
|---|
| 1157 | with Samba 3.0.</p></div>
|
|---|
| 1158 | <a name="INDEX-370"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl hosts = host list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1159 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of hosts or networks</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Requires that SSL be used with the hosts listed. By default, if the
|
|---|
| 1160 | <tt class="literal">ssl</tt> option is set, the server requires SSL with
|
|---|
| 1161 | all hosts. Requires <tt class="literal">--with-ssl</tt> configure option.
|
|---|
| 1162 | Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 1163 | <a name="INDEX-371"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl hosts resign = host list</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1164 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of hosts or networks</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Suppresses the use of SSL with the hosts listed. By default, if the
|
|---|
| 1165 | <tt class="literal">ssl</tt> option is set, the server requires SSL with
|
|---|
| 1166 | all hosts. Requires <tt class="literal">--with-ssl</tt> configure option.
|
|---|
| 1167 | Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 1168 | <a name="INDEX-372"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl require clientcert = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1169 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Requires clients to use certificates when SSL is in use. This option
|
|---|
| 1170 | is recommended if SSL is used. Requires <tt class="literal">--with-ssl</tt>
|
|---|
| 1171 | configure option. Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 1172 | <a name="INDEX-373"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl require servercert = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1173 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>When SSL is in use, <em class="emphasis">smbclient</em> requires servers
|
|---|
| 1174 | to use certificates. This option is recommended if SSL is used.
|
|---|
| 1175 | Requires <tt class="literal">--with-ssl</tt> configure option. Obsolete
|
|---|
| 1176 | starting with Samba 3.0.</p></div>
|
|---|
| 1177 | <a name="INDEX-374"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl server cert = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1178 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a file containing the server's SSL
|
|---|
| 1179 | certificate. Requires <tt class="literal">--with-ssl</tt> configure option.
|
|---|
| 1180 | Obsolete starting with Samba 3.0.</p></div>
|
|---|
| 1181 | <a name="INDEX-375"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl server key = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1182 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a file containing the server's private SSL
|
|---|
| 1183 | key. If no file is specified and SSL is in use, the server looks up
|
|---|
| 1184 | its key in its server certificate. Requires
|
|---|
| 1185 | <tt class="literal">--with-ssl</tt> configure option. Obsolete starting
|
|---|
| 1186 | with Samba 3.0.</p></div>
|
|---|
| 1187 | <a name="INDEX-376"/><a name="INDEX-377"/><a name="INDEX-378"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>ssl version = string</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1188 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: "ssl2",
|
|---|
| 1189 | "ssl3",
|
|---|
| 1190 | "ssl2or3",
|
|---|
| 1191 | "tls1"</p><p><b class="emphasis-bold">Default</b>: "ssl2or3"</p><p>Defines which versions of the SSL protocol the server can use:
|
|---|
| 1192 | Version 2 only ("ssl2"), Version 3
|
|---|
| 1193 | only ("ssl3"), Version 2 or 3
|
|---|
| 1194 | dynamically negotiated ("ssl2or3"),
|
|---|
| 1195 | or Transport Layer Security
|
|---|
| 1196 | ("tls1"). Requires
|
|---|
| 1197 | <tt class="literal">--with-ssl</tt> configure option. Obsolete starting
|
|---|
| 1198 | with Samba 3.0.<a name="INDEX-377"/><a name="INDEX-378"/></p></div>
|
|---|
| 1199 | <a name="INDEX-379"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>stat cache = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1200 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Makes the Samba server cache client names for faster resolution.
|
|---|
| 1201 | Should not be changed.</p></div>
|
|---|
| 1202 | <a name="INDEX-380"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>stat cache size = number </i></b></font></td><td align="right"><i>[global]
|
|---|
| 1203 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 50</p><p>Determines the number of client names cached for faster resolution.
|
|---|
| 1204 | Should not be changed.</p></div>
|
|---|
| 1205 | <a name="INDEX-381"/><a name="INDEX-382"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>status = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1206 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to YES, logs connections to a file (or shared memory)
|
|---|
| 1207 | accessible to <em class="filename">smbstatus</em>.
|
|---|
| 1208 | <a name="INDEX-382"/>Obsolete
|
|---|
| 1209 | starting with Samba 3.0.</p></div>
|
|---|
| 1210 | <a name="INDEX-383"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>strict allocate = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, allocates all disk blocks when creating or extending
|
|---|
| 1211 | the size of files, instead of using the normal sparse file allocation
|
|---|
| 1212 | used on Unix. This slows the server, but results in behavior that
|
|---|
| 1213 | matches that of Windows and helps Samba correctly report
|
|---|
| 1214 | "out of quota" messages.</p></div>
|
|---|
| 1215 | <a name="INDEX-384"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>strict locking = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, checks locks on every access, not just on demand and
|
|---|
| 1216 | at open time. Not recommended.</p></div>
|
|---|
| 1217 | <a name="INDEX-385"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>strict sync = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, Samba synchronizes to disk whenever the client sets
|
|---|
| 1218 | the sync bit in a packet. If set to NO, Samba flushes data to disk
|
|---|
| 1219 | whenever buffers fill. Defaults to NO because Windows 98 Explorer
|
|---|
| 1220 | sets the bit (incorrectly) in all packets.</p></div>
|
|---|
| 1221 | <a name="INDEX-386"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>strip dot = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1222 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Removes trailing dots from filenames. Dysfunctional in Samba 2.2; use
|
|---|
| 1223 | <tt class="literal">mangled</tt> <tt class="literal">map</tt> instead.</p></div>
|
|---|
| 1224 | <a name="INDEX-387"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>sync always = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, Samba forces the data to disk through <em class="emphasis">fsync</em>
|
|---|
| 1225 | (3) after every write. Avoid except to debug crashing
|
|---|
| 1226 | servers.</p></div>
|
|---|
| 1227 | <a name="INDEX-388"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>syslog = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1228 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 1</p><p>Sets the level of Samba log messages to send to
|
|---|
| 1229 | <em class="filename">syslog</em>. Higher is more verbose. The
|
|---|
| 1230 | <em class="filename">syslog.conf</em> file must have suitable logging
|
|---|
| 1231 | enabled.</p></div>
|
|---|
| 1232 | <a name="INDEX-389"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>syslog only = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1233 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, logs only to <em class="emphasis">syslog</em> instead of
|
|---|
| 1234 | the standard Samba log files.</p></div>
|
|---|
| 1235 | <a name="INDEX-390"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>template homedir = path</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1236 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full path to directory</p><p><b class="emphasis-bold">Default</b>: /home/<tt class="literal">%D</tt>/<tt class="literal">%U</tt></p><p>Sets the home directory for Unix login sessions for users
|
|---|
| 1237 | authenticated through winbind. <tt class="literal">%D</tt> will be replaced
|
|---|
| 1238 | with user's domain name; <tt class="literal">%U</tt> by
|
|---|
| 1239 | the username.</p></div>
|
|---|
| 1240 | <a name="INDEX-391"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>template shell = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1241 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full path to shell</p><p><b class="emphasis-bold">Default</b>: <em class="filename">/bin/false</em></p><p>Sets the shell for Unix login sessions for users authenticated
|
|---|
| 1242 | through winbind. The default value prevents all Windows domain user
|
|---|
| 1243 | logins.</p></div>
|
|---|
| 1244 | <a name="INDEX-392"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>time offset = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1245 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of minutes</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Sets the number of minutes to add to the system time-zone
|
|---|
| 1246 | calculation. Provided to fix a client daylight-savings bug. Not
|
|---|
| 1247 | recommended.</p></div>
|
|---|
| 1248 | <a name="INDEX-393"/><a name="INDEX-394"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>time server = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1249 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, <em class="emphasis">nmbd</em><a name="INDEX-394"/>
|
|---|
| 1250 | advertises itself as a provider of SMB time service to clients. This
|
|---|
| 1251 | option only affects whether the time service is advertised. It does
|
|---|
| 1252 | not enable or disable time service.</p></div>
|
|---|
| 1253 | <a name="INDEX-395"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>timestamp logs = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1254 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Synonym for <tt class="literal">debug</tt> <tt class="literal">timestamp</tt>.</p></div>
|
|---|
| 1255 | <a name="INDEX-396"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>total print jobs = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1256 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0 (no limit)</p><p>Limits total number of current print jobs on server. See also
|
|---|
| 1257 | <tt class="literal">max print jobs</tt>.</p></div>
|
|---|
| 1258 | <a name="INDEX-397"/><a name="INDEX-398"/><a name="INDEX-399"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>unix extensions = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1259 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, supports
|
|---|
| 1260 | <a name="INDEX-398"/>CIFS Unix extensions, providing
|
|---|
| 1261 | better filesystem support for Unix clients. <a name="INDEX-399"/>Obsolete in Samba 3.0, which always
|
|---|
| 1262 | offers support.</p></div>
|
|---|
| 1263 | <a name="INDEX-400"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>unix password sync = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1264 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, attempts to change the user's Unix
|
|---|
| 1265 | password whenever the user changes her SMB password. Used to ease
|
|---|
| 1266 | synchronization of Unix and Microsoft password databases. See also
|
|---|
| 1267 | <tt class="literal">password program</tt> and <tt class="literal">passwd</tt>
|
|---|
| 1268 | <tt class="literal">chat</tt>.</p></div>
|
|---|
| 1269 | <a name="INDEX-401"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>update encrypted = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1270 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Updates the encrypted password file when a user logs on with an
|
|---|
| 1271 | unencrypted password. Provided to ease conversion from unencrypted to
|
|---|
| 1272 | encrypted passwords.</p></div>
|
|---|
| 1273 | <a name="INDEX-402"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>use client driver = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1274 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>Used for avoiding <tt class="literal">Access Denied; Unable to connect</tt>
|
|---|
| 1275 | messages when connecting to a Samba printer from Windows NT/2000/XP
|
|---|
| 1276 | clients. Necessary only when the client has a local printer driver
|
|---|
| 1277 | for the Samba printer.</p></div>
|
|---|
| 1278 | <a name="INDEX-403"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>use mmap = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1279 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: varies</p><p>Tells Samba whether the <em class="emphasis">mmap( )</em> system call
|
|---|
| 1280 | works correctly on the Samba host. Default is automatically set
|
|---|
| 1281 | correctly. Do not change.</p></div>
|
|---|
| 1282 | <a name="INDEX-404"/><a name="INDEX-405"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>use rhosts = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1283 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, users' <em class="filename">~/.rhosts</em>
|
|---|
| 1284 | files will be used to identify systems from which users can connect
|
|---|
| 1285 | without providing a password. Discouraged. <a name="INDEX-405"/>Obsolete
|
|---|
| 1286 | in Samba 3.0.</p></div>
|
|---|
| 1287 | <a name="INDEX-406"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>use sendfile = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If yes, Samba will perform some data transfers for exclusively
|
|---|
| 1288 | oplocked files using the <em class="emphasis">sendfile( )</em> system
|
|---|
| 1289 | call, which results in significant performance improvements. This is
|
|---|
| 1290 | available if Samba has been configured with the
|
|---|
| 1291 | <tt class="literal">--with-sendfile-support</tt> option. This is an
|
|---|
| 1292 | experimental option and is new in Samba 2.2.5.</p></div>
|
|---|
| 1293 | <a name="INDEX-407"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>user = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Synonym for <tt class="literal">username</tt>.</p></div>
|
|---|
| 1294 | <a name="INDEX-408"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>username = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets a list of users that are tried when logging on with share-level
|
|---|
| 1295 | security in effect. Also called <tt class="literal">user</tt> or
|
|---|
| 1296 | <tt class="literal">users</tt>. Discouraged. Use <tt class="literal">NET</tt>
|
|---|
| 1297 | <tt class="literal">USE</tt>
|
|---|
| 1298 | <tt class="literal">\\</tt><em class="replaceable">server</em><tt class="literal">\</tt><em class="replaceable">share
|
|---|
| 1299 | </em><tt class="literal">%</tt><em class="replaceable">user</em>
|
|---|
| 1300 | from the client instead.</p></div>
|
|---|
| 1301 | <a name="INDEX-409"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>username level = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1302 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number</p><p><b class="emphasis-bold">Default</b>: 0</p><p>Specifies the number of uppercase-letter permutations allowed to
|
|---|
| 1303 | match Unix usernames. A workaround for Windows'
|
|---|
| 1304 | single-case usernames. Use is discouraged.</p></div>
|
|---|
| 1305 | <a name="INDEX-410"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>username map = filename</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1306 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of file</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Names a file of Unix-to-Windows name pairs; used to map different
|
|---|
| 1307 | spellings of account names and Windows usernames longer than eight
|
|---|
| 1308 | characters.</p></div>
|
|---|
| 1309 | <a name="INDEX-411"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>users = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Synonym for <tt class="literal">username</tt>.</p></div>
|
|---|
| 1310 | <a name="INDEX-412"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>utmp = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1311 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>This is available if Samba has been configured with the
|
|---|
| 1312 | <tt class="literal">--with-utmp</tt> option. If set, Samba adds
|
|---|
| 1313 | <em class="emphasis">utmp</em>/<em class="emphasis">utmpx</em> records whenever
|
|---|
| 1314 | a connection is made to a Samba server. Sites can use this option to
|
|---|
| 1315 | record each connection to a Samba share as a system login.</p></div>
|
|---|
| 1316 | <a name="INDEX-413"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>utmp directory = directory</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1317 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: name of directory</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>This is available if Samba has been configured with the
|
|---|
| 1318 | <tt class="literal">--with-utmp</tt> option. If this option and
|
|---|
| 1319 | <tt class="literal">utmp</tt> are set, Samba will look in the specified
|
|---|
| 1320 | directory rather than the default system directory for
|
|---|
| 1321 | <em class="filename">utmp</em>/<em class="filename">utmpx</em> files.</p></div>
|
|---|
| 1322 | <a name="INDEX-414"/><a name="INDEX-415"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>valid chars = list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: list of numeric values</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Adds national characters to a character set map. See also
|
|---|
| 1323 | <tt class="literal">client</tt> <tt class="literal">code</tt>
|
|---|
| 1324 | <tt class="literal">page</tt>. <a name="INDEX-415"/>Obsolete in Samba 3.0.</p></div>
|
|---|
| 1325 | <a name="INDEX-416"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>valid users = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL (allows everyone)</p><p>Specifies a list of users that can connect to a share. See also
|
|---|
| 1326 | <tt class="literal">invalid users</tt>.</p></div>
|
|---|
| 1327 | <a name="INDEX-417"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>veto files = slash-separated list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: slash-separated list of filenames</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of files that the client will not see when listing a
|
|---|
| 1328 | directory's contents. See also
|
|---|
| 1329 | <tt class="literal">delete</tt> <tt class="literal">veto</tt>
|
|---|
| 1330 | <tt class="literal">files</tt> and <tt class="literal">hide files</tt>.</p></div>
|
|---|
| 1331 | <a name="INDEX-418"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>veto oplock files = slash-separated list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: slash-separated list of filenames</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of files not to oplock (and cache on clients). See
|
|---|
| 1332 | also <tt class="literal">oplocks</tt> and <tt class="literal">fake</tt>
|
|---|
| 1333 | <tt class="literal">oplocks</tt>.</p></div>
|
|---|
| 1334 | <a name="INDEX-419"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>vfs object = filename</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full path to shared library</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies the shared library to use for Samba's
|
|---|
| 1335 | Virtual File System (VFS). Requires the <tt class="literal">--with-vfs</tt>
|
|---|
| 1336 | configure option.</p></div>
|
|---|
| 1337 | <a name="INDEX-420"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>vfs options = string</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: space-separated list of options</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies parameters to the VFS. Requires the
|
|---|
| 1338 | <tt class="literal">--with-vfs</tt> configure option. See <tt class="literal">vfs
|
|---|
| 1339 | object</tt>.</p></div>
|
|---|
| 1340 | <a name="INDEX-421"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>volume = string</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: share name</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the volume label of a disk share. Especially useful with shared
|
|---|
| 1341 | CD-ROMs.</p></div>
|
|---|
| 1342 | <a name="INDEX-422"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>wide links = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set, Samba follows symlinks out of the disk share. See also the
|
|---|
| 1343 | <tt class="literal">root</tt> <tt class="literal">dir</tt> and
|
|---|
| 1344 | <tt class="literal">follow</tt> <tt class="literal">symlinks</tt> options.</p></div>
|
|---|
| 1345 | <a name="INDEX-423"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>winbind cache time = number</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1346 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: number of seconds</p><p><b class="emphasis-bold">Default</b>: 15</p><p>Sets the amount of time that the <em class="emphasis">winbindd</em> daemon
|
|---|
| 1347 | caches user and group information.</p></div>
|
|---|
| 1348 | <a name="INDEX-424"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>winbind enum users = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1349 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES/NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to NO, enumeration of users is suppressed by winbind.
|
|---|
| 1350 | Discouraged.</p></div>
|
|---|
| 1351 | <a name="INDEX-425"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>winbind enum groups = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1352 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES/NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>If set to NO, enumeration of groups is suppressed by winbind.
|
|---|
| 1353 | Discouraged.</p></div>
|
|---|
| 1354 | <a name="INDEX-426"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>winbind gid = numeric range</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1355 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: integer-integer</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies the group ID range winbind uses for Windows NT domain users
|
|---|
| 1356 | connecting to Samba.</p></div>
|
|---|
| 1357 | <a name="INDEX-427"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>winbind separator = character</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1358 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: ASCII character</p><p><b class="emphasis-bold">Default</b>: \</p><p>Specifies the character winbind uses to separate a domain name and
|
|---|
| 1359 | username.</p></div>
|
|---|
| 1360 | <a name="INDEX-428"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>winbind uid = numeric range</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1361 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: integer-integer</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies the user ID range winbind will use for Windows NT domain
|
|---|
| 1362 | users connecting to Samba.</p></div>
|
|---|
| 1363 | <a name="INDEX-429"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>wins hook = command</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1364 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: full path to script</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a command to run whenever the WINS server updates its
|
|---|
| 1365 | database. Allows WINS to be synchronized with DNS or other services.
|
|---|
| 1366 | The command is passed one of the arguments <tt class="literal">add</tt>,
|
|---|
| 1367 | <tt class="literal">delete</tt>, or <tt class="literal">refresh</tt>, followed by
|
|---|
| 1368 | the NetBIOS name, the name type (two hexadecimal digits), the TTL in
|
|---|
| 1369 | seconds, and the IP addresses corresponding to the NetBIOS name.
|
|---|
| 1370 | Requires <tt class="literal">wins</tt> <tt class="literal">service</tt>
|
|---|
| 1371 | <tt class="literal">=</tt> <tt class="literal">YES</tt>.</p></div>
|
|---|
| 1372 | <a name="INDEX-430"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>wins proxy = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1373 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, <em class="emphasis">nmbd</em> proxies resolution requests
|
|---|
| 1374 | to WINS servers on behalf of old clients, which use broadcasts. The
|
|---|
| 1375 | WINS server is typically on another subnet.</p></div>
|
|---|
| 1376 | <a name="INDEX-431"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>wins server = value</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1377 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: hostname or IP address</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Sets the DNS name or IP address of the WINS server.</p></div>
|
|---|
| 1378 | <a name="INDEX-432"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>wins support = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1379 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: NO</p><p>If set to YES, activates the WINS service. The
|
|---|
| 1380 | <tt class="literal">wins</tt> <tt class="literal">server</tt> option must not be
|
|---|
| 1381 | set if <tt class="literal">wins</tt> <tt class="literal">support</tt>
|
|---|
| 1382 | <tt class="literal">=</tt> <tt class="literal">YES</tt>.</p></div>
|
|---|
| 1383 | <a name="INDEX-433"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>workgroup = name</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1384 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: workgroup name</p><p><b class="emphasis-bold">Default</b>: compiled-in</p><p>Sets the workgroup or domain to which the Samba server belongs.
|
|---|
| 1385 | Overrides the compiled-in default of WORKGROUP. Choosing a name other
|
|---|
| 1386 | than WORKGROUP is highly recommended.</p></div>
|
|---|
| 1387 | <a name="INDEX-434"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>writable = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Antonym for <tt class="literal">read</tt> <tt class="literal">only</tt>;
|
|---|
| 1388 | <tt class="literal">writeable</tt> and <tt class="literal">write</tt>
|
|---|
| 1389 | <tt class="literal">ok</tt> are synonyms.</p></div>
|
|---|
| 1390 | <a name="INDEX-435"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>writeable = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Antonym for <tt class="literal">read</tt> <tt class="literal">only</tt>;
|
|---|
| 1391 | <tt class="literal">writable</tt> and <tt class="literal">write</tt>
|
|---|
| 1392 | <tt class="literal">ok</tt> are synonyms.</p></div>
|
|---|
| 1393 | <a name="INDEX-436"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>write cache size = number</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: decimal number of bytes</p><p><b class="emphasis-bold">Default</b>: 0 (disabled)</p><p>Allocates a write buffer of the specified size in which Samba
|
|---|
| 1394 | accumulates data before a write to disk. This option can be used to
|
|---|
| 1395 | ensure that each write has the optimal size for a given filesystem.
|
|---|
| 1396 | It is typically used with RAID drives, which have a preferred write
|
|---|
| 1397 | size, and with systems that have large memory and slow disks.</p></div>
|
|---|
| 1398 | <a name="INDEX-437"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>write list = user list</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: user list</p><p><b class="emphasis-bold">Default</b>: NULL</p><p>Specifies a list of users that are given read/write access to a
|
|---|
| 1399 | read-only share. See also <tt class="literal">read</tt>
|
|---|
| 1400 | <tt class="literal">list</tt>.</p></div>
|
|---|
| 1401 | <a name="INDEX-438"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>write ok = boolean</i></b></font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Synonym for <tt class="literal">writable</tt>.</p></div>
|
|---|
| 1402 | <a name="INDEX-439"/><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b><i>write raw = boolean</i></b></font></td><td align="right"><i>[global]
|
|---|
| 1403 | </i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black"/><table width="515" border="0" cellpadding="5"><tr><td align="left"/><td align="right"/></tr></table><p><b class="emphasis-bold">Allowable values</b>: YES, NO</p><p><b class="emphasis-bold">Default</b>: YES</p><p>Allows fast-streaming writes over TCP using 64KB buffers. Recommended.</p></div>
|
|---|
| 1404 |
|
|---|
| 1405 |
|
|---|
| 1406 |
|
|---|
| 1407 | <div class="sect1"><a name="samba2-APP-B-SECT-2"/>
|
|---|
| 1408 |
|
|---|
| 1409 | <h2 class="head1">Glossary of Configuration Value Types</h2>
|
|---|
| 1410 |
|
|---|
| 1411 | <dl>
|
|---|
| 1412 | <dt><b><a name="INDEX-440"/><em class="emphasis">boolean</em></b></dt>
|
|---|
| 1413 | <dd>
|
|---|
| 1414 | <p>One of two values, either YES or NO.</p>
|
|---|
| 1415 | </dd>
|
|---|
| 1416 |
|
|---|
| 1417 |
|
|---|
| 1418 |
|
|---|
| 1419 | <dt><b>character</b></dt>
|
|---|
| 1420 | <dd>
|
|---|
| 1421 | <p>A single ASCII character.</p>
|
|---|
| 1422 | </dd>
|
|---|
| 1423 |
|
|---|
| 1424 |
|
|---|
| 1425 |
|
|---|
| 1426 | <dt><b>command</b></dt>
|
|---|
| 1427 | <dd>
|
|---|
| 1428 | <p>A Unix script or compiled program, with an absolute path specified
|
|---|
| 1429 | for the executable and parameters.</p>
|
|---|
| 1430 | </dd>
|
|---|
| 1431 |
|
|---|
| 1432 |
|
|---|
| 1433 |
|
|---|
| 1434 | <dt><b>directory</b></dt>
|
|---|
| 1435 | <dd>
|
|---|
| 1436 | <p>An absolute path specification to a directory. For example:</p>
|
|---|
| 1437 |
|
|---|
| 1438 | <blockquote><pre class="code">/usr/local/samba/lib</pre></blockquote>
|
|---|
| 1439 | </dd>
|
|---|
| 1440 |
|
|---|
| 1441 | </dl>
|
|---|
| 1442 |
|
|---|
| 1443 | <dl>
|
|---|
| 1444 | <dt><b>filename</b></dt>
|
|---|
| 1445 | <dd>
|
|---|
| 1446 | <p>An absolute path specification to a file. For example:</p>
|
|---|
| 1447 |
|
|---|
| 1448 | <blockquote><pre class="code">/etc/printcap</pre></blockquote>
|
|---|
| 1449 | </dd>
|
|---|
| 1450 |
|
|---|
| 1451 |
|
|---|
| 1452 | <dt><b>host list</b></dt>
|
|---|
| 1453 | <dd>
|
|---|
| 1454 | <p>A list of hosts. Allows IP addresses, address masks, domain names,
|
|---|
| 1455 | ALL, and EXCEPT.</p>
|
|---|
| 1456 | </dd>
|
|---|
| 1457 |
|
|---|
| 1458 |
|
|---|
| 1459 |
|
|---|
| 1460 | <dt><b>interface list</b></dt>
|
|---|
| 1461 | <dd>
|
|---|
| 1462 | <p>A list of interfaces, in either address/netmask or address/n-bits
|
|---|
| 1463 | format. For example:</p>
|
|---|
| 1464 |
|
|---|
| 1465 |
|
|---|
| 1466 | <blockquote><pre class="code">192.168.2.10/255.255.255.0, 192.168.2.10/24</pre></blockquote>
|
|---|
| 1467 | </dd>
|
|---|
| 1468 |
|
|---|
| 1469 |
|
|---|
| 1470 | <dt><b>map list</b></dt>
|
|---|
| 1471 | <dd>
|
|---|
| 1472 | <p>A list of filename remapping strings such as
|
|---|
| 1473 | <tt class="literal">(*.html</tt> <tt class="literal">*.htm)</tt>.</p>
|
|---|
| 1474 | </dd>
|
|---|
| 1475 |
|
|---|
| 1476 |
|
|---|
| 1477 |
|
|---|
| 1478 | <dt><b>name</b></dt>
|
|---|
| 1479 | <dd>
|
|---|
| 1480 | <p>A single name of a type of object, as specified in the
|
|---|
| 1481 | option's description.</p>
|
|---|
| 1482 | </dd>
|
|---|
| 1483 |
|
|---|
| 1484 |
|
|---|
| 1485 |
|
|---|
| 1486 | <dt><b>number</b></dt>
|
|---|
| 1487 | <dd>
|
|---|
| 1488 | <p>A positive integer.</p>
|
|---|
| 1489 | </dd>
|
|---|
| 1490 |
|
|---|
| 1491 |
|
|---|
| 1492 |
|
|---|
| 1493 | <dt><b>numeric range</b></dt>
|
|---|
| 1494 | <dd>
|
|---|
| 1495 | <p>Two numbers separated by a dash, specifying a minimum and a maximum
|
|---|
| 1496 | value. For example:</p>
|
|---|
| 1497 |
|
|---|
| 1498 |
|
|---|
| 1499 | <blockquote><pre class="code">100-250</pre></blockquote>
|
|---|
| 1500 | </dd>
|
|---|
| 1501 |
|
|---|
| 1502 |
|
|---|
| 1503 | <dt><b>remote list</b></dt>
|
|---|
| 1504 | <dd>
|
|---|
| 1505 | <p>A list of subnet-broadcast-address/workgroup pairs. For example:</p>
|
|---|
| 1506 |
|
|---|
| 1507 | <blockquote><pre class="code">192.168.2.255/SERVERS 192.168.4.255/STAFF</pre></blockquote>
|
|---|
| 1508 | </dd>
|
|---|
| 1509 |
|
|---|
| 1510 |
|
|---|
| 1511 | <dt><b>service (share) list</b></dt>
|
|---|
| 1512 | <dd>
|
|---|
| 1513 | <p>A list of service (share) names, without the enclosing parentheses.</p>
|
|---|
| 1514 | </dd>
|
|---|
| 1515 |
|
|---|
| 1516 |
|
|---|
| 1517 |
|
|---|
| 1518 | <dt><b>slash-separated list</b></dt>
|
|---|
| 1519 | <dd>
|
|---|
| 1520 | <p>A list of filenames, separated by
|
|---|
| 1521 | "/" characters to allow embedded
|
|---|
| 1522 | spaces. For example:</p>
|
|---|
| 1523 |
|
|---|
| 1524 |
|
|---|
| 1525 | <blockquote><pre class="code">/.*/My Documents/*.doc/</pre></blockquote>
|
|---|
| 1526 | </dd>
|
|---|
| 1527 |
|
|---|
| 1528 |
|
|---|
| 1529 | <dt><b>string</b></dt>
|
|---|
| 1530 | <dd>
|
|---|
| 1531 | <p>One line of arbitrary text.</p>
|
|---|
| 1532 | </dd>
|
|---|
| 1533 |
|
|---|
| 1534 |
|
|---|
| 1535 |
|
|---|
| 1536 | <dt><b>user list</b></dt>
|
|---|
| 1537 | <dd>
|
|---|
| 1538 | <p>A list of usernames and/or group names.
|
|---|
| 1539 | <tt class="literal">@</tt><em class="replaceable">group_name</em> includes
|
|---|
| 1540 | whomever is in the NIS netgroup
|
|---|
| 1541 | <em class="replaceable">group_name</em>, if one exists, or otherwise
|
|---|
| 1542 | whomever is in the Unix group <em class="replaceable">group_name</em>.
|
|---|
| 1543 | In addition,
|
|---|
| 1544 | <tt class="literal">+</tt><em class="replaceable">group_name</em> is a Unix
|
|---|
| 1545 | group, <tt class="literal">&</tt><em class="replaceable">group_name</em>
|
|---|
| 1546 | is an NIS netgroup, and <tt class="literal">&+</tt> and
|
|---|
| 1547 | <tt class="literal">+&</tt> cause an ordered search of both Unix and
|
|---|
| 1548 | NIS groups.</p>
|
|---|
| 1549 | </dd>
|
|---|
| 1550 |
|
|---|
| 1551 |
|
|---|
| 1552 |
|
|---|
| 1553 | <dt><b>value</b></dt>
|
|---|
| 1554 | <dd>
|
|---|
| 1555 | <p>A value of some miscellaneous type, as specified in the
|
|---|
| 1556 | option's description.<a name="INDEX-441"/></p>
|
|---|
| 1557 | </dd>
|
|---|
| 1558 |
|
|---|
| 1559 | </dl>
|
|---|
| 1560 |
|
|---|
| 1561 |
|
|---|
| 1562 | </div>
|
|---|
| 1563 |
|
|---|
| 1564 |
|
|---|
| 1565 |
|
|---|
| 1566 | <div class="sect1"><a name="samba2-APP-B-SECT-3"/>
|
|---|
| 1567 |
|
|---|
| 1568 | <h2 class="head1">Configuration File Variables</h2>
|
|---|
| 1569 |
|
|---|
| 1570 | <p><a href="appb.html#samba2-APP-B-TABLE-1">Table B-1</a> lists the Samba configuration file
|
|---|
| 1571 | variables.</p>
|
|---|
| 1572 |
|
|---|
| 1573 | <a name="samba2-APP-B-TABLE-1"/><h4 class="head4">Table B-1. Configuration file variables</h4><table border="1">
|
|---|
| 1574 |
|
|---|
| 1575 |
|
|---|
| 1576 |
|
|---|
| 1577 | <tr>
|
|---|
| 1578 | <th>
|
|---|
| 1579 | <p>Name</p>
|
|---|
| 1580 | </th>
|
|---|
| 1581 | <th>
|
|---|
| 1582 | <p>Meaning</p>
|
|---|
| 1583 | </th>
|
|---|
| 1584 | </tr>
|
|---|
| 1585 |
|
|---|
| 1586 |
|
|---|
| 1587 | <tr>
|
|---|
| 1588 | <td>
|
|---|
| 1589 | <p><tt class="literal">%a</tt></p>
|
|---|
| 1590 | </td>
|
|---|
| 1591 | <td>
|
|---|
| 1592 | <p>Client's architecture (Samba, WfWg, WinNT, Win95, or
|
|---|
| 1593 | UNKNOWN)</p>
|
|---|
| 1594 | </td>
|
|---|
| 1595 | </tr>
|
|---|
| 1596 | <tr>
|
|---|
| 1597 | <td>
|
|---|
| 1598 | <p><tt class="literal">%d</tt></p>
|
|---|
| 1599 | </td>
|
|---|
| 1600 | <td>
|
|---|
| 1601 | <p>Current server process's process ID</p>
|
|---|
| 1602 | </td>
|
|---|
| 1603 | </tr>
|
|---|
| 1604 | <tr>
|
|---|
| 1605 | <td>
|
|---|
| 1606 | <p><tt class="literal">%D</tt></p>
|
|---|
| 1607 | </td>
|
|---|
| 1608 | <td>
|
|---|
| 1609 | <p>User's Windows NT Domain</p>
|
|---|
| 1610 | </td>
|
|---|
| 1611 | </tr>
|
|---|
| 1612 | <tr>
|
|---|
| 1613 | <td>
|
|---|
| 1614 | <p><tt class="literal">%f</tt></p>
|
|---|
| 1615 | </td>
|
|---|
| 1616 | <td>
|
|---|
| 1617 | <p>Printer spool file as a relative path (printing only)</p>
|
|---|
| 1618 | </td>
|
|---|
| 1619 | </tr>
|
|---|
| 1620 | <tr>
|
|---|
| 1621 | <td>
|
|---|
| 1622 | <p><tt class="literal">%f</tt></p>
|
|---|
| 1623 | </td>
|
|---|
| 1624 | <td>
|
|---|
| 1625 | <p>User from which a message was sent (messages only)</p>
|
|---|
| 1626 | </td>
|
|---|
| 1627 | </tr>
|
|---|
| 1628 | <tr>
|
|---|
| 1629 | <td>
|
|---|
| 1630 | <p><tt class="literal">%G</tt></p>
|
|---|
| 1631 | </td>
|
|---|
| 1632 | <td>
|
|---|
| 1633 | <p>Primary group name of <tt class="literal">%U</tt> (requested username)</p>
|
|---|
| 1634 | </td>
|
|---|
| 1635 | </tr>
|
|---|
| 1636 | <tr>
|
|---|
| 1637 | <td>
|
|---|
| 1638 | <p><tt class="literal">%g</tt></p>
|
|---|
| 1639 | </td>
|
|---|
| 1640 | <td>
|
|---|
| 1641 | <p>Primary group name of <tt class="literal">%u</tt> (actual username)</p>
|
|---|
| 1642 | </td>
|
|---|
| 1643 | </tr>
|
|---|
| 1644 | <tr>
|
|---|
| 1645 | <td>
|
|---|
| 1646 | <p><tt class="literal">%H</tt></p>
|
|---|
| 1647 | </td>
|
|---|
| 1648 | <td>
|
|---|
| 1649 | <p>Home directory of <tt class="literal">%u</tt> (actual username)</p>
|
|---|
| 1650 | </td>
|
|---|
| 1651 | </tr>
|
|---|
| 1652 | <tr>
|
|---|
| 1653 | <td>
|
|---|
| 1654 | <p><tt class="literal">%h</tt></p>
|
|---|
| 1655 | </td>
|
|---|
| 1656 | <td>
|
|---|
| 1657 | <p>Samba server's (Internet) hostname</p>
|
|---|
| 1658 | </td>
|
|---|
| 1659 | </tr>
|
|---|
| 1660 | <tr>
|
|---|
| 1661 | <td>
|
|---|
| 1662 | <p><tt class="literal">%I</tt></p>
|
|---|
| 1663 | </td>
|
|---|
| 1664 | <td>
|
|---|
| 1665 | <p>Client's IP address</p>
|
|---|
| 1666 | </td>
|
|---|
| 1667 | </tr>
|
|---|
| 1668 | <tr>
|
|---|
| 1669 | <td>
|
|---|
| 1670 | <p><tt class="literal">%j</tt></p>
|
|---|
| 1671 | </td>
|
|---|
| 1672 | <td>
|
|---|
| 1673 | <p>Print job number (printing only)</p>
|
|---|
| 1674 | </td>
|
|---|
| 1675 | </tr>
|
|---|
| 1676 | <tr>
|
|---|
| 1677 | <td>
|
|---|
| 1678 | <p><tt class="literal">%L</tt></p>
|
|---|
| 1679 | </td>
|
|---|
| 1680 | <td>
|
|---|
| 1681 | <p>Samba server's NetBIOS name (virtual servers have
|
|---|
| 1682 | multiple names)</p>
|
|---|
| 1683 | </td>
|
|---|
| 1684 | </tr>
|
|---|
| 1685 | <tr>
|
|---|
| 1686 | <td>
|
|---|
| 1687 | <p><tt class="literal">%M</tt></p>
|
|---|
| 1688 | </td>
|
|---|
| 1689 | <td>
|
|---|
| 1690 | <p>Client's (Internet) hostname</p>
|
|---|
| 1691 | </td>
|
|---|
| 1692 | </tr>
|
|---|
| 1693 | <tr>
|
|---|
| 1694 | <td>
|
|---|
| 1695 | <p><tt class="literal">%m</tt></p>
|
|---|
| 1696 | </td>
|
|---|
| 1697 | <td>
|
|---|
| 1698 | <p>Client's NetBIOS name</p>
|
|---|
| 1699 | </td>
|
|---|
| 1700 | </tr>
|
|---|
| 1701 | <tr>
|
|---|
| 1702 | <td>
|
|---|
| 1703 | <p><tt class="literal">%N</tt></p>
|
|---|
| 1704 | </td>
|
|---|
| 1705 | <td>
|
|---|
| 1706 | <p>Name of the NIS home directory server (without NIS, same as
|
|---|
| 1707 | <tt class="literal">%L</tt>)</p>
|
|---|
| 1708 | </td>
|
|---|
| 1709 | </tr>
|
|---|
| 1710 | <tr>
|
|---|
| 1711 | <td>
|
|---|
| 1712 | <p><tt class="literal">%n</tt></p>
|
|---|
| 1713 | </td>
|
|---|
| 1714 | <td>
|
|---|
| 1715 | <p>New password (password change only)</p>
|
|---|
| 1716 | </td>
|
|---|
| 1717 | </tr>
|
|---|
| 1718 | <tr>
|
|---|
| 1719 | <td>
|
|---|
| 1720 | <p><tt class="literal">%o</tt></p>
|
|---|
| 1721 | </td>
|
|---|
| 1722 | <td>
|
|---|
| 1723 | <p>Old password (password change only)</p>
|
|---|
| 1724 | </td>
|
|---|
| 1725 | </tr>
|
|---|
| 1726 | <tr>
|
|---|
| 1727 | <td>
|
|---|
| 1728 | <p><tt class="literal">%P</tt></p>
|
|---|
| 1729 | </td>
|
|---|
| 1730 | <td>
|
|---|
| 1731 | <p>Current share's root directory (actual)</p>
|
|---|
| 1732 | </td>
|
|---|
| 1733 | </tr>
|
|---|
| 1734 | <tr>
|
|---|
| 1735 | <td>
|
|---|
| 1736 | <p><tt class="literal">%p</tt></p>
|
|---|
| 1737 | </td>
|
|---|
| 1738 | <td>
|
|---|
| 1739 | <p>Current share's root directory (in an NIS homedir
|
|---|
| 1740 | map)</p>
|
|---|
| 1741 | </td>
|
|---|
| 1742 | </tr>
|
|---|
| 1743 | <tr>
|
|---|
| 1744 | <td>
|
|---|
| 1745 | <p><tt class="literal">%p</tt></p>
|
|---|
| 1746 | </td>
|
|---|
| 1747 | <td>
|
|---|
| 1748 | <p>Print filename (printing only)</p>
|
|---|
| 1749 | </td>
|
|---|
| 1750 | </tr>
|
|---|
| 1751 | <tr>
|
|---|
| 1752 | <td>
|
|---|
| 1753 | <p><tt class="literal">%R</tt></p>
|
|---|
| 1754 | </td>
|
|---|
| 1755 | <td>
|
|---|
| 1756 | <p>Protocol level in use (CORE, COREPLUS, LANMAN1, LANMAN2, or NT1)</p>
|
|---|
| 1757 | </td>
|
|---|
| 1758 | </tr>
|
|---|
| 1759 | <tr>
|
|---|
| 1760 | <td>
|
|---|
| 1761 | <p><tt class="literal">%S</tt></p>
|
|---|
| 1762 | </td>
|
|---|
| 1763 | <td>
|
|---|
| 1764 | <p>Current share's name</p>
|
|---|
| 1765 | </td>
|
|---|
| 1766 | </tr>
|
|---|
| 1767 | <tr>
|
|---|
| 1768 | <td>
|
|---|
| 1769 | <p><tt class="literal">%s</tt></p>
|
|---|
| 1770 | </td>
|
|---|
| 1771 | <td>
|
|---|
| 1772 | <p>Name of the file in which the message resides (messages only)</p>
|
|---|
| 1773 | </td>
|
|---|
| 1774 | </tr>
|
|---|
| 1775 | <tr>
|
|---|
| 1776 | <td>
|
|---|
| 1777 | <p><tt class="literal">%s</tt></p>
|
|---|
| 1778 | </td>
|
|---|
| 1779 | <td>
|
|---|
| 1780 | <p>Printer spool filename (printing only)</p>
|
|---|
| 1781 | </td>
|
|---|
| 1782 | </tr>
|
|---|
| 1783 | <tr>
|
|---|
| 1784 | <td>
|
|---|
| 1785 | <p><tt class="literal">%T</tt></p>
|
|---|
| 1786 | </td>
|
|---|
| 1787 | <td>
|
|---|
| 1788 | <p>Current date and time</p>
|
|---|
| 1789 | </td>
|
|---|
| 1790 | </tr>
|
|---|
| 1791 | <tr>
|
|---|
| 1792 | <td>
|
|---|
| 1793 | <p><tt class="literal">%t</tt></p>
|
|---|
| 1794 | </td>
|
|---|
| 1795 | <td>
|
|---|
| 1796 | <p>Destination system (messages only)</p>
|
|---|
| 1797 | </td>
|
|---|
| 1798 | </tr>
|
|---|
| 1799 | <tr>
|
|---|
| 1800 | <td>
|
|---|
| 1801 | <p><tt class="literal">%U</tt></p>
|
|---|
| 1802 | </td>
|
|---|
| 1803 | <td>
|
|---|
| 1804 | <p>Requested username for current share</p>
|
|---|
| 1805 | </td>
|
|---|
| 1806 | </tr>
|
|---|
| 1807 | <tr>
|
|---|
| 1808 | <td>
|
|---|
| 1809 | <p><tt class="literal">%u</tt></p>
|
|---|
| 1810 | </td>
|
|---|
| 1811 | <td>
|
|---|
| 1812 | <p>Current share's username</p>
|
|---|
| 1813 | </td>
|
|---|
| 1814 | </tr>
|
|---|
| 1815 | <tr>
|
|---|
| 1816 | <td>
|
|---|
| 1817 | <p><tt class="literal">%v</tt></p>
|
|---|
| 1818 | </td>
|
|---|
| 1819 | <td>
|
|---|
| 1820 | <p>Samba version</p>
|
|---|
| 1821 | </td>
|
|---|
| 1822 | </tr>
|
|---|
| 1823 | <tr>
|
|---|
| 1824 | <td>
|
|---|
| 1825 | <p>%$<em class="replaceable">name</em></p>
|
|---|
| 1826 | </td>
|
|---|
| 1827 | <td>
|
|---|
| 1828 | <p>Value of environment variable <em class="replaceable">name</em></p>
|
|---|
| 1829 | </td>
|
|---|
| 1830 | </tr>
|
|---|
| 1831 |
|
|---|
| 1832 | </table>
|
|---|
| 1833 |
|
|---|
| 1834 |
|
|---|
| 1835 | </div>
|
|---|
| 1836 |
|
|---|
| 1837 |
|
|---|
| 1838 | <hr/><h4 class="head4"><a href="toc.html">TOC</a></h4>
|
|---|
| 1839 |
|
|---|
| 1840 | </body></html>
|
|---|
