1<HTML> 2<HEAD> 3<TITLE>[Appendix C] Samba Configuration Option Quick Reference</title> 4</head> 5<BODY BGCOLOR="#FFFFFF" TEXT="#000000" link="#990000" vlink="#0000CC"> 6<table BORDER="0" CELLPADDING="0" CELLSPACING="0" width="90%"> 7<tr> 8<td width="25%" valign="TOP"> 9<img hspace=10 vspace=10 src="gifs/samba.s.gif" 10alt="Using Samba" align=left valign=top border=0> 11</td> 12<td height="105" valign="TOP"> 13<br> 14<H2>Using Samba</H2> 15<font size="-1"> 16Robert Eckstein, David Collier-Brown, Peter Kelly 17<br>1st Edition November 1999 18<br>1-56592-449-5, Order Number: 4495 19<br>416 pages, $34.95 20</font> 21<p> <a href="http://www.oreilly.com/catalog/samba/">Buy the hardcopy</a> 22<p><a href="index.html">Table of Contents</a> 23</td> 24</tr> 25</table> 26<hr size=1 noshade> 27<!--sample chapter begins --> 28 29<center> 30<DIV CLASS="htmlnav"> 31<TABLE WIDTH="515" BORDER="0" CELLSPACING="0" CELLPADDING="0"> 32<TR> 33<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="172"> 34<A CLASS="sect1" HREF="appb_03.html" TITLE="B.3 Sizing Samba Servers"> 35<IMG SRC="gifs/txtpreva.gif" ALT="Previous: B.3 Sizing Samba Servers" BORDER="0"></a></td><TD ALIGN="CENTER" VALIGN="TOP" WIDTH="171"> 36<B> 37<FONT FACE="ARIEL,HELVETICA,HELV,SANSERIF" SIZE="-1"> 38Appendix C</font></b></td><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="172"> 39<A CLASS="appendix" HREF="appd_01.html" TITLE="D. Downloading Samba with CVS"> 40<IMG SRC="gifs/txtnexta.gif" ALT="Next: D. Downloading Samba with CVS" BORDER="0"></a></td></tr></table> <hr noshade size=1></center> 41</div> 42<blockquote> 43<div class="samplechapter"> 44<H1 CLASS="appendix"> 45<A CLASS="title" NAME="appc-23653"> 46C. Samba Configuration Option Quick Reference</a></h1><P CLASS="para">The following pages list each of the Samba configuration options. If an option is applicable only to the global section, "[global]" will appear before its name. Any lists mentioned are space separated, except where noted. A glossary of terms follows the options.</p> 47 48<DIV CLASS="refentry"> 49<DIV CLASS="refnamediv"><b><i>admin users = user list</i></b> 50<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 51<DIV CLASS="refsynopsisdiv"> 52<P CLASS="para">Allowable values: user list</p> 53 54<P CLASS="para"> 55List of users who will be granted root permissions on the share by Samba.</p> 56</div> 57</blockquote> 58</div> 59<p> </p> 60 61<DIV CLASS="refentry"> 62<DIV CLASS="refnamediv"><b><i>allow hosts = host list</i></b> 63<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 64<DIV CLASS="refsynopsisdiv"> 65<P CLASS="para">Allowable values: any</p> 66 67<P CLASS="para"> 68Synonym for <CODE CLASS="literal"> 69hosts allow</code>. List of machines that may connect to a share.</p> 70</div> 71</blockquote> 72</div> 73<p> </p> 74 75<DIV CLASS="refentry"> 76<DIV CLASS="refnamediv"><b><i>alternate permissions = boolean</i></b> 77<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 78<DIV CLASS="refsynopsisdiv"> 79<P CLASS="para">Allowable values: YES, NO</p> 80 81<P CLASS="para"> 82Obsolete. Has no effect in Samba 2. Files will be shown as read-only if the owner can't write them. In Samba 1.9 and earlier, setting this option would set the DOS filesystem read-only attribute on any file the user couldn't read. This in turn required the <CODE CLASS="literal"> 83delete readonly</code> option.</p> 84</div> 85</blockquote> 86</div> 87<p> </p> 88 89<DIV CLASS="refentry"> 90<DIV CLASS="refnamediv"><b><i>[global] announce as = system type</i></b> 91<P CLASS="refpurpose">Default: NT</p></div><BLOCKQUOTE> 92<DIV CLASS="refsynopsisdiv"> 93<P CLASS="para">Allowable values: NT, Win95, WfW</p> 94 95<P CLASS="para"> 96Have Samba announce itself as something other than an NT server. Discouraged because it interferes with serving browse lists.</p> 97</div> 98</blockquote> 99</div> 100<p> </p> 101 102<DIV CLASS="refentry"> 103<DIV CLASS="refnamediv"><b><i>[global] announce version = number.number</i></b> 104<P CLASS="refpurpose">Default: 4.2</p></div><BLOCKQUOTE> 105<DIV CLASS="refsynopsisdiv"> 106<P CLASS="para">Allowable values: any</p> 107 108<P CLASS="para"> 109Instructs Samba to announce itself as an older version SMB server. Discouraged.</p> 110</div> 111</blockquote> 112</div> 113<p> </p> 114 115<DIV CLASS="refentry"> 116<DIV CLASS="refnamediv"><b><i>[global] auto services = share list</i></b> 117<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 118<DIV CLASS="refsynopsisdiv"> 119<P CLASS="para">Allowable values: any shares</p> 120 121<P CLASS="para"> 122List of shares that will always appear in browse lists. A synonym is <CODE CLASS="literal"> 123preload</code>.</p> 124</div> 125</blockquote> 126</div> 127<p> </p> 128 129<DIV CLASS="refentry"> 130<DIV CLASS="refnamediv"><b><i>available = boolean</i></b> 131<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 132<DIV CLASS="refsynopsisdiv"> 133<P CLASS="para">Allowable values: YES, NO</p> 134 135<P CLASS="para"> 136If set to NO, denies access to a share. Doesn't affect browsing.</p> 137</div> 138</blockquote> 139</div> 140<p> </p> 141 142<DIV CLASS="refentry"> 143<DIV CLASS="refnamediv"><b><i>[global] bind interfaces only = boolean</i></b> 144<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 145<DIV CLASS="refsynopsisdiv"> 146<P CLASS="para">Allowable values: YES, NO</p> 147 148<P CLASS="para"> 149If set to YES, shares and browsing will be provided only on interfaces in an interfaces list (see <CODE CLASS="literal"> 150interfaces</code>). New in Samba 1.9.18. If you set this option to YES, be sure to add 127.0.0.1 to the interfaces list to allow <EM CLASS="emphasis"> 151smbpasswd</em> to connect to the local machine to change passwords. This is a convienence option; it does not improve security.</p> 152</div> 153</blockquote> 154</div> 155<p> </p> 156 157<DIV CLASS="refentry"> 158<DIV CLASS="refnamediv"><b><i>browsable = boolean</i></b> 159<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 160<DIV CLASS="refsynopsisdiv"> 161<P CLASS="para">Allowable values: YES, NO</p> 162 163<P CLASS="para"> 164Allows a share to be announced in browse lists.</p> 165</div> 166</blockquote> 167</div> 168<p> </p> 169 170<DIV CLASS="refentry"> 171<DIV CLASS="refnamediv"><b><i>blocking locks = boolean</i></b> 172<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 173<DIV CLASS="refsynopsisdiv"> 174<P CLASS="para">Allowable values: YES, NO</p> 175 176<P CLASS="para"> 177If YES, honors byte range lock requests with time limits for queuing the request and retrying it until the time period expires. New in Samba 2.0.</p> 178</div> 179</blockquote> 180</div> 181<p> </p> 182 183<DIV CLASS="refentry"> 184<DIV CLASS="refnamediv"><b><i>[global] browse list = boolean</i></b> 185<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 186<DIV CLASS="refsynopsisdiv"> 187<P CLASS="para">Allowable values: YES, NO</p> 188 189<P CLASS="para"> 190Turns on/off <CODE CLASS="literal"> 191browse</code> <CODE CLASS="literal"> 192list</code> from this server. Avoid changing.</p> 193</div> 194</blockquote> 195</div> 196<p> </p> 197 198<DIV CLASS="refentry"> 199<DIV CLASS="refnamediv"><b><i>[global] case sensitive = boolean</i></b> 200<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 201<DIV CLASS="refsynopsisdiv"> 202<P CLASS="para">Allowable values: YES, NO</p> 203 204<P CLASS="para"> 205If YES, uses exactly the case the client supplied when trying to resolve a filename. If NO, matches either upper- or lowercase name. Avoid changing.</p> 206</div> 207</blockquote> 208</div> 209<p> </p> 210 211<DIV CLASS="refentry"> 212<DIV CLASS="refnamediv"><b><i>[global] case sig names = boolean</i></b> 213<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 214<DIV CLASS="refsynopsisdiv"> 215<P CLASS="para">Allowable values: YES, NO</p> 216 217<P CLASS="para"> 218Synonym for <CODE CLASS="literal"> 219case sensitive</code>.</p> 220</div> 221</blockquote> 222</div> 223<p> </p> 224 225<DIV CLASS="refentry"> 226<DIV CLASS="refnamediv"><b><i>[global] change notify timeout = number</i></b> 227<P CLASS="refpurpose">Default: 60</p></div><BLOCKQUOTE> 228<DIV CLASS="refsynopsisdiv"> 229<P CLASS="para">Allowable values: positive number</p> 230 231<P CLASS="para"> 232Sets the number of seconds between checks when a client asks for notification of changes in a directory. Introduced in Samba 2.0 to limit the performance cost of the checks. Avoid lowering.</p> 233</div> 234</blockquote> 235</div> 236<p> </p> 237 238<DIV CLASS="refentry"> 239<DIV CLASS="refnamediv"><b><i>character set = name</i></b> 240<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 241<DIV CLASS="refsynopsisdiv"> 242<P CLASS="para">Allowable values: ISO8859-1, ISO8859-2, ISO8859-5, KOI8-R</p> 243 244<P CLASS="para"> 245If set, translates from DOS code pages to the Western European (ISO8859-1), Eastern European (ISO8859-2), Russian Cyrillic (ISO8859-5), or Alternate Russian (KOI8-R) character set. The <CODE CLASS="literal"> 246client code page</code> must be set to 850.</p> 247</div> 248</blockquote> 249</div> 250<p> </p> 251 252<DIV CLASS="refentry"> 253<DIV CLASS="refnamediv"><b><i>client code page = name</i></b> 254<P CLASS="refpurpose">Default: 437 (US MS-DOS)</p></div><BLOCKQUOTE> 255<DIV CLASS="refsynopsisdiv"> 256<P CLASS="para">Allowable values: See <a href="ch08_03.html#ch08-20815"><b>Table 8.4</b></a></p> 257 258<P CLASS="para"> 259Sets the DOS code page explicitly, overriding any previous <CODE CLASS="literal"> 260valid chars</code> settings. Examples of values are 850 for European, 437 is the US standard, and 932 for Japanese Shift-JIS. Introduced in Samba 1.9.19.</p> 261</div> 262</blockquote> 263</div> 264<p> </p> 265 266<DIV CLASS="refentry"> 267<DIV CLASS="refnamediv"><b><i>coding system = code</i></b> 268<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 269<DIV CLASS="refsynopsisdiv"> 270<P CLASS="para">Allowable values: euc, cap, hex, hexN, sjis, j8bb, j8bj, jis8, j8bh, j8@b, j8@j, j8@h, j7bb, j7bj, jis7, j7bh, j7@b, j7@j, j7@h, jubb, jubj, junet, jubh, ju@b, ju@j, ju@h</p> 271 272<P CLASS="para"> 273Sets the coding system used, notably for Kanji. This is employed for filenames and should correspond to the code page in use. The <CODE CLASS="literal"> 274client code page</code> option must be set to 932 (Japanese Shift-JIS). Introduced in Samba 2.0.</p> 275</div> 276</blockquote> 277</div> 278<p> </p> 279 280<DIV CLASS="refentry"> 281<DIV CLASS="refnamediv"><b><i>comment = text</i></b> 282<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 283<DIV CLASS="refsynopsisdiv"> 284<P CLASS="para">Allowable values: a text string or NULL</p> 285 286<P CLASS="para"> 287Sets the comment that appears beside a share in a NET VIEW or the details list of a Microsoft directory window. See also the <CODE CLASS="literal"> 288server string</code> configuration option.</p> 289</div> 290</blockquote> 291</div> 292<p> </p> 293 294<DIV CLASS="refentry"> 295<DIV CLASS="refnamediv"><b><i>[global] config file = pathname</i></b> 296<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 297<DIV CLASS="refsynopsisdiv"> 298<P CLASS="para">Allowable values: Unix pathname</p> 299 300<P CLASS="para"> 301Selects an additional Samba configuration file to read instead of the current one. Used to relocate the configuration file, or used with %-variables to select custom configuration files for some users or machines. </p> 302</div> 303</blockquote> 304</div> 305<p> </p> 306 307<DIV CLASS="refentry"> 308<DIV CLASS="refnamediv"><b><i>copy = section name</i></b> 309<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 310<DIV CLASS="refsynopsisdiv"> 311<P CLASS="para">Allowable values: existing section's name</p> 312 313<P CLASS="para"> 314Copies the configuration of a previously seen share into the share where it appears. Used with %-variables to select custom configurations for machines, architectures and users. The copied section must be earlier in the configuration file. Copied options are of lesser priority than those explicitly listed in the section.</p> 315</div> 316</blockquote> 317</div> 318<p> </p> 319 320<DIV CLASS="refentry"> 321<DIV CLASS="refnamediv"><b><i>create mask = octal value</i></b> 322<P CLASS="refpurpose">Default: 0744</p></div><BLOCKQUOTE> 323<DIV CLASS="refsynopsisdiv"> 324<P CLASS="para">Allowable values: octal permission bits, 0-0777</p> 325 326<P CLASS="para"> 327Also called <CODE CLASS="literal"> 328create mode</code>. Sets the maximum allowable permissions for new files (e.g., 0755). See also <CODE CLASS="literal"> 329directory mask</code>. To require certain permissions to be set, see <CODE CLASS="literal"> 330force create mask/force directory mask</code>. This option stopped affecting directories in Samba 1.9.17, and the default value changed in Samba 2.0.</p> 331</div> 332</blockquote> 333</div> 334<p> </p> 335 336<DIV CLASS="refentry"> 337<DIV CLASS="refnamediv"><b><i>create mode = octal permission bits</i></b> 338<P CLASS="refpurpose">Default: 0744</p></div><BLOCKQUOTE> 339<DIV CLASS="refsynopsisdiv"> 340<P CLASS="para">Allowable values: octal permission bits, 0-0777</p> 341 342<P CLASS="para"> 343Synonym for <CODE CLASS="literal"> 344create mask</code>.</p> 345</div> 346</blockquote> 347</div> 348<p> </p> 349 350<DIV CLASS="refentry"> 351<DIV CLASS="refnamediv"><b><i>[global] deadtime = minutes</i></b> 352<P CLASS="refpurpose">Default: 0 </p></div><BLOCKQUOTE> 353<DIV CLASS="refsynopsisdiv"> 354<P CLASS="para">Allowable values: minutes</p> 355 356<P CLASS="para"> 357The time in minutes before an unused connection will be terminated. Zero means forever. Used to keep clients from tying up server resources forever. If used, clients will have to auto-reconnect after minutes of inactivity. See also <CODE CLASS="literal"> 358keepalive</code>.</p> 359</div> 360</blockquote> 361</div> 362<p> </p> 363 364<DIV CLASS="refentry"> 365<DIV CLASS="refnamediv"><b><i>[global] debug level = number</i></b> 366<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 367<DIV CLASS="refsynopsisdiv"> 368<P CLASS="para">Allowable values: number</p> 369 370<P CLASS="para"> 371Sets the logging level used. Values of 3 or more slow Samba noticeably. A synonym is <CODE CLASS="literal"> 372log level</code>. Recommended value: 1.</p> 373</div> 374</blockquote> 375</div> 376<p> </p> 377 378<DIV CLASS="refentry"> 379<DIV CLASS="refnamediv"><b><i>[global] debug timestamp = boolean</i></b> 380<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 381<DIV CLASS="refsynopsisdiv"> 382<P CLASS="para">Allowable values: YES, NO</p> 383 384<P CLASS="para"> 385Timestamps all log messages. Can be turned off when it's not useful (e.g., in debugging). New in Samba 2.0.</p> 386</div> 387</blockquote> 388</div> 389<p> </p> 390 391<DIV CLASS="refentry"> 392<DIV CLASS="refnamediv"><b><i>[global] default = name</i></b> 393<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 394<DIV CLASS="refsynopsisdiv"> 395<P CLASS="para">Allowable values: share name</p> 396 397<P CLASS="para"> 398Also called <CODE CLASS="literal"> 399default service</code>. The name of a service (share) to provide if someone requests a service they don't have permission to use or which doesn't exist. As of Samba 1.9.14, the path will be set from the name the client specified, with any "_" characters changed to "/" characters, allowing access to any directory on the Samba server. Use is strongly discouraged.</p> 400</div> 401</blockquote> 402</div> 403<p> </p> 404 405<DIV CLASS="refentry"> 406<DIV CLASS="refnamediv"><b><i>default case = case</i></b> 407<P CLASS="refpurpose">Default: LOWER</p></div><BLOCKQUOTE> 408<DIV CLASS="refsynopsisdiv"> 409<P CLASS="para">Allowable values: LOWER, UPPER</p> 410 411<P CLASS="para"> 412Sets the case in which to store new filenames. LOWER indicates mixed case, UPPER indicates uppercase letters.</p> 413</div> 414</blockquote> 415</div> 416<p> </p> 417 418<DIV CLASS="refentry"> 419<DIV CLASS="refnamediv"><b><i>[global] default service = share name</i></b> 420<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 421<DIV CLASS="refsynopsisdiv"> 422<P CLASS="para">Allowable values: share name</p> 423 424<P CLASS="para"> 425Synonym for <CODE CLASS="literal"> 426default</code>.</p> 427</div> 428</blockquote> 429</div> 430<p> </p> 431 432<DIV CLASS="refentry"> 433<DIV CLASS="refnamediv"><b><i>delete readonly = boolean</i></b> 434<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 435<DIV CLASS="refsynopsisdiv"> 436<P CLASS="para">Allowable values: NO, YES</p> 437 438<P CLASS="para"> 439Allow delete requests to remove read-only files. This is not allowed in DOS/Windows, but is normal in Unix, which has separate directory permissions. Used with programs like RCS, or with the older <CODE CLASS="literal"> 440alternate permissions</code> option.</p> 441</div> 442</blockquote> 443</div> 444<p> </p> 445 446<DIV CLASS="refentry"> 447<DIV CLASS="refnamediv"><b><i>delete veto files = boolean</i></b> 448<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 449<DIV CLASS="refsynopsisdiv"> 450<P CLASS="para">Allowable values: NO, YES</p> 451 452<P CLASS="para"> 453Allow delete requests for a directory containing files or subdirectories the user can't see due to the <CODE CLASS="literal"> 454veto files</code> option. If set to NO, the directory will not be deleted and will still contain invisible files.</p> 455</div> 456</blockquote> 457</div> 458<p> </p> 459 460<DIV CLASS="refentry"> 461<DIV CLASS="refnamediv"><b><i>deny hosts = host list</i></b> 462<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 463<DIV CLASS="refsynopsisdiv"> 464<P CLASS="para">Allowable values: host list</p> 465 466<P CLASS="para"> 467A synonym is <CODE CLASS="literal"> 468hosts deny</code>. Specifies a list of machines from which to refuse connections or shares.</p> 469</div> 470</blockquote> 471</div> 472<p> </p> 473 474<DIV CLASS="refentry"> 475<DIV CLASS="refnamediv"><b><i>[global] dfree command = command</i></b> 476<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 477<DIV CLASS="refsynopsisdiv"> 478<P CLASS="para">Allowable values: shell command</p> 479 480<P CLASS="para"> 481A command to run on the server to return disk free space. Not needed unless the OS command does not work properly.</p> 482</div> 483</blockquote> 484</div> 485<p> </p> 486 487<DIV CLASS="refentry"> 488<DIV CLASS="refnamediv"><b><i>directory = pathname</i></b> 489<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 490<DIV CLASS="refsynopsisdiv"> 491<P CLASS="para">Allowable values: pathname</p> 492 493<P CLASS="para"> 494Synonym for <CODE CLASS="literal"> 495path</code>. A directory provided by a file share, or used by a printer share. Set automatically in the <CODE CLASS="literal"> 496[homes]</code> share to user's home directory, otherwise defaults to<I CLASS="filename"> 497 /tmp</i>. </p> 498</div> 499</blockquote> 500</div> 501<p> </p> 502 503<DIV CLASS="refentry"> 504<DIV CLASS="refnamediv"><b><i>directory mask = octal permission bits</i></b> 505<P CLASS="refpurpose">Default: 0755</p></div><BLOCKQUOTE> 506<DIV CLASS="refsynopsisdiv"> 507<P CLASS="para">Allowable values: octal value from 0 to 0777</p> 508 509<P CLASS="para"> 510Also called <CODE CLASS="literal"> 511directory mode</code>. Sets the maximum allowable permissions for newly created directories. To require certain permissions be set, see the <CODE CLASS="literal"> 512force create mask</code> and <CODE CLASS="literal"> 513force directory mask</code> options.</p> 514</div> 515</blockquote> 516</div> 517<p> </p> 518 519<DIV CLASS="refentry"> 520<DIV CLASS="refnamediv"><b><i>directory mode = octal permission bits</i></b> 521<P CLASS="refpurpose">Default: 0755</p></div><BLOCKQUOTE> 522<DIV CLASS="refsynopsisdiv"> 523<P CLASS="para">Allowable values: octal value from 0 to 0777</p> 524 525<P CLASS="para"> 526Synonym for <CODE CLASS="literal"> 527directory mask</code>.</p> 528</div> 529</blockquote> 530</div> 531<p> </p> 532 533<DIV CLASS="refentry"> 534<DIV CLASS="refnamediv"><b><i>[global] dns proxy = boolean</i></b> 535<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 536<DIV CLASS="refsynopsisdiv"> 537<P CLASS="para">Allowable values: YES, NO</p> 538 539<P CLASS="para"> 540If set to YES, and if <CODE CLASS="literal"> 541wins server = YES</code>, look up hostnames in DNS if they are not found using WINS.</p> 542</div> 543</blockquote> 544</div> 545<p> </p> 546 547<DIV CLASS="refentry"> 548<DIV CLASS="refnamediv"><b><i>[global] domain logons = boolean</i></b> 549<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 550<DIV CLASS="refsynopsisdiv"> 551<P CLASS="para">Allowable values: YES, NO</p> 552 553<P CLASS="para"> 554Allow Windows 95/98 or NT clients to log on to an NT-like domain.</p> 555</div> 556</blockquote> 557</div> 558<p> </p> 559 560<DIV CLASS="refentry"> 561<DIV CLASS="refnamediv"><b><i>[global] domain master = boolean</i></b> 562<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 563<DIV CLASS="refsynopsisdiv"> 564<P CLASS="para">Allowable values: YES, NO</p> 565 566<P CLASS="para"> 567Become a domain master browser list collector if possible for the entire workgroup/domain. </p> 568</div> 569</blockquote> 570</div> 571<p> </p> 572 573<DIV CLASS="refentry"> 574<DIV CLASS="refnamediv"><b><i>dont descend = comma-list</i></b> 575<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 576<DIV CLASS="refsynopsisdiv"> 577<P CLASS="para">Allowable values: comma-separated list of paths</p> 578 579<P CLASS="para"> 580Does not allow a change directory or search in the directories specified. This is a browsing convenience option; it doesn't provide any extra security.</p> 581</div> 582</blockquote> 583</div> 584<p> </p> 585 586<DIV CLASS="refentry"> 587<DIV CLASS="refnamediv"><b><i>dos filetimes = boolean</i></b> 588<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 589<DIV CLASS="refsynopsisdiv"> 590<P CLASS="para">Allowable values: YES, NO</p> 591 592<P CLASS="para"> 593Allow non-owners to change file times if they can write to the file. See also <CODE CLASS="literal"> 594dos filetime resolution</code>.</p> 595</div> 596</blockquote> 597</div> 598<p> </p> 599 600<DIV CLASS="refentry"> 601<DIV CLASS="refnamediv"><b><i>dos filetime resolution = boolean</i></b> 602<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 603<DIV CLASS="refsynopsisdiv"> 604<P CLASS="para">Allowable values: YES, NO</p> 605 606<P CLASS="para"> 607Set file times on Unix to match DOS standards (round to next even second). Recommended if using Visual C++ or a PC <EM CLASS="emphasis"> 608make</em> program to avoid remaking the programs unnecesarily. Use with the <CODE CLASS="literal"> 609dos filetimes</code> option.</p> 610</div> 611</blockquote> 612</div> 613<p> </p> 614 615<DIV CLASS="refentry"> 616<DIV CLASS="refnamediv"><b><i>[global] encrypt passwords = boolean</i></b> 617<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 618<DIV CLASS="refsynopsisdiv"> 619<P CLASS="para">Allowable values: YES, NO</p> 620 621<P CLASS="para"> 622Uses Windows NT-style password encryption. Requires an <I CLASS="filename"> 623smbpasswd</i> on the Samba server.</p> 624</div> 625</blockquote> 626</div> 627<p> </p> 628 629<DIV CLASS="refentry"> 630<DIV CLASS="refnamediv"><b><i>exec = command</i></b> 631<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 632<DIV CLASS="refsynopsisdiv"> 633<P CLASS="para">Allowable values: shell command</p> 634 635<P CLASS="para"> 636Synonym of <CODE CLASS="literal"> 637preexec</code>, a command to run as the user just before connecting to the share.</p> 638</div> 639</blockquote> 640</div> 641<p> </p> 642 643<DIV CLASS="refentry"> 644<DIV CLASS="refnamediv"><b><i>fake directory create times = boolean</i></b> 645<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 646<DIV CLASS="refsynopsisdiv"> 647<P CLASS="para">Allowable values: YES, NO</p> 648 649<P CLASS="para"> 650Bug fix for users of Microsoft <EM CLASS="emphasis"> 651nmake</em>. If set, Samba will set directory create times such that <EM CLASS="emphasis"> 652nmake</em> won't remake all files every time.</p> 653</div> 654</blockquote> 655</div> 656<p> </p> 657 658<DIV CLASS="refentry"> 659<DIV CLASS="refnamediv"><b><i>fake oplocks = boolean</i></b> 660<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 661<DIV CLASS="refsynopsisdiv"> 662<P CLASS="para">Allowable values: YES, NO</p> 663 664<P CLASS="para"> 665Return YES whenever a client asks if it can lock a file and cache it locally, but does not enforce lock on the server. Use only for read-only disks, as Samba now supports real <CODE CLASS="literal"> 666oplocks</code> and has per-file overrides. See also <CODE CLASS="literal"> 667oplocks</code> and <CODE CLASS="literal"> 668veto oplock files</code>.</p> 669</div> 670</blockquote> 671</div> 672<p> </p> 673 674<DIV CLASS="refentry"> 675<DIV CLASS="refnamediv"><b><i>follow symlinks = boolean</i></b> 676<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 677<DIV CLASS="refsynopsisdiv"> 678<P CLASS="para">Allowable values: YES, NO</p> 679 680<P CLASS="para"> 681If YES, Samba will follow symlinks in a file share or shares. See the <CODE CLASS="literal"> 682wide links</code> option if you want to restrict symlinks to just the current share.</p> 683</div> 684</blockquote> 685</div> 686<p> </p> 687 688<DIV CLASS="refentry"> 689<DIV CLASS="refnamediv"><b><i>force create mask = octal permission bits</i></b> 690<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 691<DIV CLASS="refsynopsisdiv"> 692<P CLASS="para">Allowable values: octal value from 0 to 0777</p> 693 694<P CLASS="para"> 695Provides bits that will be <CODE CLASS="literal"> 696OR</code>ed into the permissions of newly created files. Used with the <CODE CLASS="literal"> 697create mode</code> configuration option.</p> 698</div> 699</blockquote> 700</div> 701<p> </p> 702 703<DIV CLASS="refentry"> 704<DIV CLASS="refnamediv"><b><i>force create mode = octal permission bits</i></b> 705<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 706<DIV CLASS="refsynopsisdiv"> 707<P CLASS="para">Allowable values: octal value from 0 to 0777</p> 708 709<P CLASS="para"> 710Synonym for <CODE CLASS="literal"> 711force create mask</code>.</p> 712</div> 713</blockquote> 714</div> 715<p> </p> 716 717<DIV CLASS="refentry"> 718<DIV CLASS="refnamediv"><b><i>force directory mask = octal permission bits</i></b> 719<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 720<DIV CLASS="refsynopsisdiv"> 721<P CLASS="para">Allowable values: octal value from 0 to 0777</p> 722 723<P CLASS="para"> 724Provides bits that will be <CODE CLASS="literal"> 725OR</code>ed into the permissions of newly created directories, forcing those bits to be set. Used with <CODE CLASS="literal"> 726directory mode</code>.</p> 727</div> 728</blockquote> 729</div> 730<p> </p> 731 732<DIV CLASS="refentry"> 733<DIV CLASS="refnamediv"><b><i>force directory mode = octal permission bits</i></b> 734<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 735<DIV CLASS="refsynopsisdiv"> 736<P CLASS="para">Allowable values: octal value from 0 to 0777</p> 737 738<P CLASS="para"> 739Synonym for <CODE CLASS="literal"> 740force</code> <CODE CLASS="literal"> 741directory</code> <CODE CLASS="literal"> 742mask</code>.</p> 743</div> 744</blockquote> 745</div> 746<p> </p> 747 748<DIV CLASS="refentry"> 749<DIV CLASS="refnamediv"><b><i>force group = unix group</i></b> 750<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 751<DIV CLASS="refsynopsisdiv"> 752<P CLASS="para">Allowable values: group</p> 753 754<P CLASS="para"> 755Sets the effective group name assigned to all users accessing a share. Used to override user's normal groups.</p> 756</div> 757</blockquote> 758</div> 759<p> </p> 760 761<DIV CLASS="refentry"> 762<DIV CLASS="refnamediv"><b><i>force user = name</i></b> 763<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 764<DIV CLASS="refsynopsisdiv"> 765<P CLASS="para">Allowable values: username</p> 766 767<P CLASS="para"> 768Sets the effective username assigned to all users accessing a share. Discouraged.</p> 769</div> 770</blockquote> 771</div> 772<p> </p> 773 774<DIV CLASS="refentry"> 775<DIV CLASS="refnamediv"><b><i>fstype = string</i></b> 776<P CLASS="refpurpose">Default: NTFS</p></div><BLOCKQUOTE> 777<DIV CLASS="refsynopsisdiv"> 778<P CLASS="para">Allowable values: NTFS, FAT, Samba</p> 779 780<P CLASS="para"> 781Sets the filesystem type reported to the client. </p> 782</div> 783</blockquote> 784</div> 785<p> </p> 786 787<DIV CLASS="refentry"> 788<DIV CLASS="refnamediv"><b><i>[global] getwd cache = boolean</i></b> 789<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 790<DIV CLASS="refsynopsisdiv"> 791<P CLASS="para">Allowable values: YES, NO</p> 792 793<P CLASS="para"> 794Cache current directory for performance. Recommended with the <CODE CLASS="literal"> 795wide links</code> option.</p> 796</div> 797</blockquote> 798</div> 799<p> </p> 800 801<DIV CLASS="refentry"> 802<DIV CLASS="refnamediv"><b><i>group = group</i></b> 803<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 804<DIV CLASS="refsynopsisdiv"> 805<P CLASS="para">Allowable values: unix group</p> 806 807<P CLASS="para"> 808An obsolete form of <CODE CLASS="literal"> 809force group</code>. </p> 810</div> 811</blockquote> 812</div> 813<p> </p> 814 815<DIV CLASS="refentry"> 816<DIV CLASS="refnamediv"><b><i>guest account = user</i></b> 817<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 818<DIV CLASS="refsynopsisdiv"> 819<P CLASS="para">Allowable values: username</p> 820 821<P CLASS="para"> 822Sets the name of the unprivileged Unix account to use for tasks like printing and for accessing shares marked with <CODE CLASS="literal"> 823guest ok</code>.</p> 824</div> 825</blockquote> 826</div> 827<p> </p> 828 829<DIV CLASS="refentry"> 830<DIV CLASS="refnamediv"><b><i>guest ok = boolean</i></b> 831<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 832<DIV CLASS="refsynopsisdiv"> 833<P CLASS="para">Allowable values: YES, NO</p> 834 835<P CLASS="para"> 836If YES, passwords are not needed for this share. Synonym of <CODE CLASS="literal"> 837public</code>.</p> 838</div> 839</blockquote> 840</div> 841<p> </p> 842 843<DIV CLASS="refentry"> 844<DIV CLASS="refnamediv"><b><i>guest only = boolean</i></b> 845<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 846<DIV CLASS="refsynopsisdiv"> 847<P CLASS="para">Allowable values: YES, NO</p> 848 849<P CLASS="para"> 850Forces user of a share to do so as the guest account. Requires <CODE CLASS="literal"> 851guest</code> <CODE CLASS="literal"> 852ok</code> or <CODE CLASS="literal"> 853public</code> to be <CODE CLASS="literal"> 854yes</code>.</p> 855</div> 856</blockquote> 857</div> 858<p> </p> 859 860<DIV CLASS="refentry"> 861<DIV CLASS="refnamediv"><b><i>hide dot files = boolean</i></b> 862<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 863<DIV CLASS="refsynopsisdiv"> 864<P CLASS="para">Allowable values: YES, NO</p> 865 866<P CLASS="para"> 867Treats files beginning with a dot in a share as if they had the DOS/Windows hidden attribute set.</p> 868</div> 869</blockquote> 870</div> 871<p> </p> 872 873<DIV CLASS="refentry"> 874<DIV CLASS="refnamediv"><b><i>hide files = slash-separated list</i></b> 875<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 876<DIV CLASS="refsynopsisdiv"> 877<P CLASS="para">Allowable values: list of patterns, separated by <CODE CLASS="literal"> 878/</code> characters</p> 879 880<P CLASS="para"> 881List of file or directory names to set the DOS hidden attribute on. Names may contain <CODE CLASS="literal"> 882?</code> or <CODE CLASS="literal"> 883*</code> pattern-characters and <CODE CLASS="literal"> 884%</code>-variables. See also <CODE CLASS="literal"> 885hide</code> <CODE CLASS="literal"> 886dot</code> <CODE CLASS="literal"> 887files</code> and <CODE CLASS="literal"> 888veto</code> <CODE CLASS="literal"> 889files</code>. </p> 890</div> 891</blockquote> 892</div> 893<p> </p> 894 895<DIV CLASS="refentry"> 896<DIV CLASS="refnamediv"><b><i>[global] homedir map = NIS map name</i></b> 897<P CLASS="refpurpose">Default: auto.home</p></div><BLOCKQUOTE> 898<DIV CLASS="refsynopsisdiv"> 899<P CLASS="para">Allowable values: NIS map name</p> 900 901<P CLASS="para"> 902Used with <CODE CLASS="literal"> 903nis homedir</code> to locate user's Unix home directory from Sun NIS (not NIS+).</p> 904</div> 905</blockquote> 906</div> 907<p> </p> 908 909<DIV CLASS="refentry"> 910<DIV CLASS="refnamediv"><b><i>hosts allow = host list</i></b> 911<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 912<DIV CLASS="refsynopsisdiv"> 913<P CLASS="para">Allowable values: list of hostnames</p> 914 915<P CLASS="para"> 916Synonym of <CODE CLASS="literal"> 917allow hosts</code>, a list of machines that can access a share or shares. If NULL (the default) any machine can access the share unless there is a <CODE CLASS="literal"> 918hosts deny</code> option. </p> 919</div> 920</blockquote> 921</div> 922<p> </p> 923 924<DIV CLASS="refentry"> 925<DIV CLASS="refnamediv"><b><i>hosts deny = host list</i></b> 926<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 927<DIV CLASS="refsynopsisdiv"> 928<P CLASS="para">Allowable values: list of hostnames</p> 929 930<P CLASS="para"> 931Synonym of <CODE CLASS="literal"> 932deny hosts</code>, a list of machines that cannot connect to a share or shares. </p> 933</div> 934</blockquote> 935</div> 936<p> </p> 937 938<DIV CLASS="refentry"> 939<DIV CLASS="refnamediv"><b><i>[global] hosts equiv = pathname</i></b> 940<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 941<DIV CLASS="refsynopsisdiv"> 942<P CLASS="para">Allowable values: pathname</p> 943 944<P CLASS="para"> 945Path to a file of trusted machines from which password-less logins are allowed. Strongly discouraged, because Windows/NT users can always override the user name, the only security in this scheme.</p> 946</div> 947</blockquote> 948</div> 949<p> </p> 950 951<DIV CLASS="refentry"> 952<DIV CLASS="refnamediv"><b><i>include = pathname</i></b> 953<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 954<DIV CLASS="refsynopsisdiv"> 955<P CLASS="para">Allowable values: pathname</p> 956 957<P CLASS="para"> 958Include the named file in <I CLASS="filename"> 959smb.conf</i> at the line where it appears. This option does not understand the variables <CODE CLASS="literal"> 960%u</code> (user), <CODE CLASS="literal"> 961%P</code> (current share's root directory), or <CODE CLASS="literal"> 962%S</code> (current share name), because they are not set at the time the file is read.</p> 963</div> 964</blockquote> 965</div> 966<p> </p> 967 968<!-- added for 2.0.7,. davecb --> 969 970<DIV CLASS="refentry"> 971<DIV CLASS="refnamediv"><b><i>inherit permissions = boolean</i></b> 972<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 973<DIV CLASS="refsynopsisdiv"> 974<P CLASS="para">Allowable values: YES, NO</p> 975 976<P CLASS="para"> 977If set, subdirectories will be created with the same permissions 978as the directory they are in. This overrides 979<CODE CLASS="literal">create mask, directory mask, force create mode 980</CODE> and <CODE CLASS="literal"> force directory mode</CODE>, but 981not <CODE CLASS="literal">map archive, map hidden </CODE> and <CODE CLASS="literal"> 982map system</CODE>. Will never set the <CODE CLASS="literal">setuid 983</CODE> bit. New in 2.0.7, this is a means of ensuring Unix permissions 984can be propagated to subdirectories, especially in [homes].<p> 985 986</div> 987</blockquote> 988</div> 989<p> </p> 990<!-- end of 2.0.7 --> 991 992<DIV CLASS="refentry"> 993<DIV CLASS="refnamediv"><b><i>[global] interfaces = interface list</i></b> 994<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 995<DIV CLASS="refsynopsisdiv"> 996<P CLASS="para">Allowable values: IP addresses separated by spaces</p> 997 998<P CLASS="para"> 999Sets the interfaces to which Samba will respond. The default is the machine's primary interface only. Recommended on multihomed machines or to override erroneous addresses and netmasks.</p> 1000</div> 1001</blockquote> 1002</div> 1003<p> </p> 1004 1005<DIV CLASS="refentry"> 1006<DIV CLASS="refnamediv"><b><i>invalid users = user list</i></b> 1007<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1008<DIV CLASS="refsynopsisdiv"> 1009<P CLASS="para">Allowable values: list of users</p> 1010 1011<P CLASS="para"> 1012List of users that will not be permitted access to a share or shares. </p> 1013</div> 1014</blockquote> 1015</div> 1016<p> </p> 1017 1018<DIV CLASS="refentry"> 1019<DIV CLASS="refnamediv"><b><i>[global] keepalive = number</i></b> 1020<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 1021<DIV CLASS="refsynopsisdiv"> 1022<P CLASS="para">Allowable values: number of seconds</p> 1023 1024<P CLASS="para"> 1025Number of seconds between checks for a crashed client. The default of 0 causes no checks to be performed. Recommended if you want checks more often than every four hours. 3600 (10 minutes) is reasonable. See also <CODE CLASS="literal"> 1026socket options</code> for another approach.</p> 1027</div> 1028</blockquote> 1029</div> 1030<p> </p> 1031 1032<DIV CLASS="refentry"> 1033<DIV CLASS="refnamediv"><b><i>[global] kernel oplocks = boolean</i></b> 1034<P CLASS="refpurpose">Default: automatic</p></div><BLOCKQUOTE> 1035<DIV CLASS="refsynopsisdiv"> 1036<P CLASS="para">Allowable values: YES, NO</p> 1037 1038<P CLASS="para"> 1039Break oplock when a Unix process accesses an <EM CLASS="emphasis"> 1040oplocked</em> file, preventing corruption. Set to YES on operating systems supporting this, otherwise set to NO. New in Samba 2.0; supported on SGI, and hopefully soon on Linux and BSD. Avoid changing.</p> 1041</div> 1042</blockquote> 1043</div> 1044<p> </p> 1045 1046<DIV CLASS="refentry"> 1047<DIV CLASS="refnamediv"><b><i>[global] ldap filter = various</i></b> 1048<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 1049<DIV CLASS="refsynopsisdiv"> 1050<P CLASS="para">Allowable values: various</p> 1051 1052<P CLASS="para"> 1053Options beginning with <CODE CLASS="literal"> 1054ldap</code> are part of an experimental (circa Samba 2.0) use of the Lightweight Directory Access Protocol (LDAP) general directory/distributed database for user, name, and host information. This option is reserved for future use.</p> 1055</div> 1056</blockquote> 1057</div> 1058<p> </p> 1059 1060<DIV CLASS="refentry"> 1061<DIV CLASS="refnamediv"><b><i>[global] ldap port = various</i></b> 1062<P CLASS="refpurpose">Default: various</p></div><BLOCKQUOTE> 1063<DIV CLASS="refsynopsisdiv"> 1064<P CLASS="para">Allowable values: various</p> 1065 1066<P CLASS="para"> 1067Options beginning with <CODE CLASS="literal"> 1068ldap</code> are part of an experimental (circa Samba 2.0) use of the Lightweight Directory Access Protocol (LDAP) general directory/distributed database for user, name, and host information. This option is reserved for future use.</p> 1069</div> 1070</blockquote> 1071</div> 1072<p> </p> 1073 1074<DIV CLASS="refentry"> 1075<DIV CLASS="refnamediv"><b><i>[global] ldap root = various</i></b> 1076<P CLASS="refpurpose">Default: various</p></div><BLOCKQUOTE> 1077<DIV CLASS="refsynopsisdiv"> 1078<P CLASS="para">Allowable values: various</p> 1079 1080<P CLASS="para"> 1081Options beginning with <CODE CLASS="literal"> 1082ldap</code> are part of an experimental (circa Samba 2.0) use of the Lightweight Directory Access Protocol (LDAP) general directory/distributed database for user, name, and host information. This option is reserved for future use.</p> 1083</div> 1084</blockquote> 1085</div> 1086<p> </p> 1087 1088<DIV CLASS="refentry"> 1089<DIV CLASS="refnamediv"><b><i>[global] ldap server = various</i></b> 1090<P CLASS="refpurpose">Default: various</p></div><BLOCKQUOTE> 1091<DIV CLASS="refsynopsisdiv"> 1092<P CLASS="para">Allowable values: various</p> 1093 1094<P CLASS="para"> 1095Options beginning with <CODE CLASS="literal"> 1096ldap</code> are part of an experimental (circa Samba 2.0) use of the Lightweight Directory Access Protocol (LDAP) general directory/distributed database for user, name, and host information. This option is reserved for future use.</p> 1097</div> 1098</blockquote> 1099</div> 1100<p> </p> 1101 1102<DIV CLASS="refentry"> 1103<DIV CLASS="refnamediv"><b><i>[global] ldap suffix = various</i></b> 1104<P CLASS="refpurpose">Default: various</p></div><BLOCKQUOTE> 1105<DIV CLASS="refsynopsisdiv"> 1106<P CLASS="para">Allowable values: various</p> 1107 1108<P CLASS="para"> 1109Options beginning with <CODE CLASS="literal"> 1110ldap</code> are part of an experimental (circa Samba 2.0) use of the Lightweight Directory Access Protocol (LDAP) general directory/distributed database for user, name, and host information. This option is reserved for future use.</p> 1111</div> 1112</blockquote> 1113</div> 1114<p> </p> 1115 1116<DIV CLASS="refentry"> 1117<DIV CLASS="refnamediv"><b><i>[global] load printers = boolean</i></b> 1118<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1119<DIV CLASS="refsynopsisdiv"> 1120<P CLASS="para">Allowable values: YES, NO</p> 1121 1122<P CLASS="para"> 1123Load all printer names from the system printer capabilities into browse list. Uses configuration options from the <CODE CLASS="literal"> 1124[printers]</code> section.</p> 1125</div> 1126</blockquote> 1127</div> 1128<p> </p> 1129 1130<DIV CLASS="refentry"> 1131<DIV CLASS="refnamediv"><b><i>[global] local master = boolean</i></b> 1132<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1133<DIV CLASS="refsynopsisdiv"> 1134<P CLASS="para">Allowable values: YES, NO</p> 1135 1136<P CLASS="para"> 1137Stands for election as the local master browser. See also <CODE CLASS="literal"> 1138domain master</code> and <CODE CLASS="literal"> 1139os level</code>.</p> 1140</div> 1141</blockquote> 1142</div> 1143<p> </p> 1144 1145<DIV CLASS="refentry"> 1146<DIV CLASS="refnamediv"><b><i>[global] lm announce = value</i></b> 1147<P CLASS="refpurpose">Default: AUTO</p></div><BLOCKQUOTE> 1148<DIV CLASS="refsynopsisdiv"> 1149<P CLASS="para">Allowable values: AUTO, YES, NO</p> 1150 1151<P CLASS="para"> 1152Produce OS/2 SMB broadcasts at an interval specified by the <CODE CLASS="literal"> 1153lm interval</code> option. YES/NO turns them on/off unconditionally. AUTO causes the Samba server to wait for a LAN Manager announcement from another client before sending one out. Required for OS/2 client browsing.</p> 1154</div> 1155</blockquote> 1156</div> 1157<p> </p> 1158 1159<DIV CLASS="refentry"> 1160<DIV CLASS="refnamediv"><b><i>[global] lm interval = seconds</i></b> 1161<P CLASS="refpurpose">Default: 60</p></div><BLOCKQUOTE> 1162<DIV CLASS="refsynopsisdiv"> 1163<P CLASS="para">Allowable values: number</p> 1164 1165<P CLASS="para"> 1166Sets the time period, in seconds, between OS/2 SMB broadcast announcements.</p> 1167</div> 1168</blockquote> 1169</div> 1170<p> </p> 1171 1172<DIV CLASS="refentry"> 1173<DIV CLASS="refnamediv"><b><i>[global] lock directory = pathname</i></b> 1174<P CLASS="refpurpose">Default: <EM CLASS="emphasis"> 1175/usr/local/samba/var/locks</em></p></div><BLOCKQUOTE> 1176<DIV CLASS="refsynopsisdiv"> 1177<P CLASS="para">Allowable values: pathname</p> 1178 1179<P CLASS="para"> 1180Set a directory to keep lock files in. The directory must be writable by Samba, readable by everyone.</p> 1181</div> 1182</blockquote> 1183</div> 1184<p> </p> 1185 1186<DIV CLASS="refentry"> 1187<DIV CLASS="refnamediv"><b><i>locking = boolean</i></b> 1188<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1189<DIV CLASS="refsynopsisdiv"> 1190<P CLASS="para">Allowable values: YES, NO</p> 1191 1192<P CLASS="para"> 1193Perform file locking. If set to NO, Samba will accept lock requests but will not actually lock resources. Recommended only for read-only file systems.</p> 1194</div> 1195</blockquote> 1196</div> 1197<p> </p> 1198 1199<DIV CLASS="refentry"> 1200<DIV CLASS="refnamediv"><b><i>[global] log file = pathname</i></b> 1201<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 1202<DIV CLASS="refsynopsisdiv"> 1203<P CLASS="para">Allowable values: pathname</p> 1204 1205<P CLASS="para"> 1206Set name and location of the log file. Allows all %-variables.</p> 1207</div> 1208</blockquote> 1209</div> 1210<p> </p> 1211 1212<DIV CLASS="refentry"> 1213<DIV CLASS="refnamediv"><b><i>[global] log level = number</i></b> 1214<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 1215<DIV CLASS="refsynopsisdiv"> 1216<P CLASS="para">Allowable values: number</p> 1217 1218<P CLASS="para"> 1219A synonym of <CODE CLASS="literal"> 1220debug level</code>. Sets the logging level used. Values of 3 or more slow the system noticeably.</p> 1221</div> 1222</blockquote> 1223</div> 1224<p> </p> 1225 1226<DIV CLASS="refentry"> 1227<DIV CLASS="refnamediv"><b><i>[global] logon drive = drive</i></b> 1228<P CLASS="refpurpose">Default: None</p></div><BLOCKQUOTE> 1229<DIV CLASS="refsynopsisdiv"> 1230<P CLASS="para">Allowable values: DOS drive name</p> 1231 1232<P CLASS="para"> 1233Sets the drive on Windows NT (only) of the <CODE CLASS="literal"> 1234logon path</code>.</p> 1235</div> 1236</blockquote> 1237</div> 1238<p> </p> 1239 1240<DIV CLASS="refentry"> 1241<DIV CLASS="refnamediv"><b><i>[global] logon home = path</i></b> 1242<P CLASS="refpurpose">Default: <EM CLASS="emphasis"> 1243\\</em><CODE CLASS="replaceable"><I>%</i></code></p></div><BLOCKQUOTE> 1244<DIV CLASS="refsynopsisdiv"> 1245<P CLASS="para">Allowable values: Unix pathname</p> 1246 1247<P CLASS="para"> 1248Sets the home directory of a Windows 95/98 or NT Workstation user. Allows <CODE CLASS="literal"> 1249NET</code> <CODE CLASS="literal"> 1250USE</code> <CODE CLASS="literal"> 1251H:/HOME</code> from the command prompt.</p> 1252</div> 1253</blockquote> 1254</div> 1255<p> </p> 1256 1257<DIV CLASS="refentry"> 1258<DIV CLASS="refnamediv"><b><i>[global] logon path = pathname</i></b> 1259<P CLASS="refpurpose">Default: <EM CLASS="emphasis"> 1260\\</em><CODE CLASS="replaceable"><I>N</i></code><EM CLASS="emphasis">\</em><CODE CLASS="replaceable"><I>%U</i></code><EM CLASS="emphasis">\profile</em></p></div><BLOCKQUOTE> 1261<DIV CLASS="refsynopsisdiv"> 1262<P CLASS="para">Allowable values: Windows pathname</p> 1263 1264<P CLASS="para"> 1265Sets path to Windows profile directory. This contains <EM CLASS="emphasis"> 1266USER.MAN</em> and/or <EM CLASS="emphasis"> 1267USER.DAT</em> profile files and the Windows 95 Desktop, Start Menu, Network Neighborhood, and programs folders. </p> 1268</div> 1269</blockquote> 1270</div> 1271<p> </p> 1272 1273<DIV CLASS="refentry"> 1274<DIV CLASS="refnamediv"><b><i>[global] logon script = pathname</i></b> 1275<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1276<DIV CLASS="refsynopsisdiv"> 1277<P CLASS="para">Allowable values: pathname</p> 1278 1279<P CLASS="para"> 1280Sets pathname relative to <CODE CLASS="literal"> 1281[netlogin]</code> share of a DOS/NT script to run on the client at login time. Allows all %-variables.</p> 1282</div> 1283</blockquote> 1284</div> 1285<p> </p> 1286 1287<DIV CLASS="refentry"> 1288<DIV CLASS="refnamediv"><b><i>lppause command = /absolute_ path/command</i></b> 1289<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 1290<DIV CLASS="refsynopsisdiv"> 1291<P CLASS="para">Allowable values: fully-qualfied Unix shell command</p> 1292 1293<P CLASS="para"> 1294Sets the command to pause a print job. Honors the <CODE CLASS="literal"> 1295%p</code> (printer name) and <CODE CLASS="literal"> 1296%j</code> (job number) variables. </p> 1297</div> 1298</blockquote> 1299</div> 1300<p> </p> 1301 1302<DIV CLASS="refentry"> 1303<DIV CLASS="refnamediv"><b><i>lpresume command = /absolute_ path/command</i></b> 1304<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 1305<DIV CLASS="refsynopsisdiv"> 1306<P CLASS="para">Allowable values: fully-qualified Unix shell command</p> 1307 1308<P CLASS="para"> 1309Sets the command to resume a paused print job. Honors the <CODE CLASS="literal"> 1310%p</code> (printer name) and <CODE CLASS="literal"> 1311%j</code> (job number) variables. </p> 1312</div> 1313</blockquote> 1314</div> 1315<p> </p> 1316 1317<DIV CLASS="refentry"> 1318<DIV CLASS="refnamediv"><b><i>[global] lpq cache time = seconds</i></b> 1319<P CLASS="refpurpose">Default: 10</p></div><BLOCKQUOTE> 1320<DIV CLASS="refsynopsisdiv"> 1321<P CLASS="para">Allowable values: number of seconds</p> 1322 1323<P CLASS="para"> 1324Sets how long to keep print queue (<CODE CLASS="literal">lpq</code>) status is cached, in seconds.</p> 1325</div> 1326</blockquote> 1327</div> 1328<p> </p> 1329 1330<DIV CLASS="refentry"> 1331<DIV CLASS="refnamediv"><b><i>lpq command = /absolute_ path/command</i></b> 1332<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 1333<DIV CLASS="refsynopsisdiv"> 1334<P CLASS="para">Allowable values: fully-qualfied Unix shell command</p> 1335 1336<P CLASS="para"> 1337Sets the command used to get printer status. Usually initialized to a default value by the <CODE CLASS="literal"> 1338printing</code> option. Honors the <CODE CLASS="literal"> 1339%p</code> (printer name) variable.</p> 1340</div> 1341</blockquote> 1342</div> 1343<p> </p> 1344 1345<DIV CLASS="refentry"> 1346<DIV CLASS="refnamediv"><b><i>lprm command = /absolute_ path/command</i></b> 1347<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 1348<DIV CLASS="refsynopsisdiv"> 1349<P CLASS="para">Allowable values: fully-qualified Unix shell command</p> 1350 1351<P CLASS="para"> 1352Sets the command to delete a print job. Usually initialized to a default value by the <CODE CLASS="literal"> 1353printing</code> option. Honors the <CODE CLASS="literal"> 1354%p</code> (printer name) and <CODE CLASS="literal"> 1355%j</code> (job number) variables.</p> 1356</div> 1357</blockquote> 1358</div> 1359<p> </p> 1360 1361<DIV CLASS="refentry"> 1362<DIV CLASS="refnamediv"><b><i>machine password timeout = seconds</i></b> 1363<P CLASS="refpurpose">Default: 604,800</p></div><BLOCKQUOTE> 1364<DIV CLASS="refsynopsisdiv"> 1365<P CLASS="para">Allowable values: number of seconds</p> 1366 1367<P CLASS="para"> 1368Sets the period between (NT domain) machine password changes. Default is 1 week, or 604,800 seconds.</p> 1369</div> 1370</blockquote> 1371</div> 1372<p> </p> 1373 1374<DIV CLASS="refentry"> 1375<DIV CLASS="refnamediv"><b><i>magic output = pathname</i></b> 1376<P CLASS="refpurpose">Default: <EM CLASS="emphasis"> 1377script.out</em></p></div><BLOCKQUOTE> 1378<DIV CLASS="refsynopsisdiv"> 1379<P CLASS="para">Allowable values: Unix pathname</p> 1380 1381<P CLASS="para"> 1382Sets the output file for the discouraged <CODE CLASS="literal"> 1383magic scripts</code> option. Default is the script name, followed by the extension <EM CLASS="emphasis"> 1384.out</em>.</p> 1385</div> 1386</blockquote> 1387</div> 1388<p> </p> 1389 1390<DIV CLASS="refentry"> 1391<DIV CLASS="refnamediv"><b><i>magic script = pathname</i></b> 1392<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1393<DIV CLASS="refsynopsisdiv"> 1394<P CLASS="para">Allowable values: Unix pathname</p> 1395 1396<P CLASS="para"> 1397Sets a filename for execution via a shell whenever the file is closed from the client, to allow clients to run commands on the server. </p> 1398</div> 1399</blockquote> 1400</div> 1401<p> </p> 1402 1403<DIV CLASS="refentry"> 1404<DIV CLASS="refnamediv"><b><i>mangle case = boolean</i></b> 1405<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1406<DIV CLASS="refsynopsisdiv"> 1407<P CLASS="para">Allowable values: allowable values: YES, NO</p> 1408 1409<P CLASS="para"> 1410Mangle a name if it is in mixed case.</p> 1411</div> 1412</blockquote> 1413</div> 1414<p> </p> 1415 1416<DIV CLASS="refentry"> 1417<DIV CLASS="refnamediv"><b><i>mangled map = map list</i></b> 1418<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1419<DIV CLASS="refsynopsisdiv"> 1420<P CLASS="para">Allowable values: list of to-from pairs</p> 1421 1422<P CLASS="para"> 1423Set up a table of names to remap (e.g., <EM CLASS="emphasis"> 1424.html</em> to <EM CLASS="emphasis"> 1425.htm</em>). </p> 1426</div> 1427</blockquote> 1428</div> 1429<p> </p> 1430 1431<DIV CLASS="refentry"> 1432<DIV CLASS="refnamediv"><b><i>mangled names = boolean</i></b> 1433<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1434<DIV CLASS="refsynopsisdiv"> 1435<P CLASS="para">Allowable values: YES, NO</p> 1436 1437<P CLASS="para"> 1438Sets Samba to abbreviate names that are too long or have unsupported characters to the DOS 8.3 style. </p> 1439</div> 1440</blockquote> 1441</div> 1442<p> </p> 1443 1444<DIV CLASS="refentry"> 1445<DIV CLASS="refnamediv"><b><i>mangling char = character</i></b> 1446<P CLASS="refpurpose">Default: ~</p></div><BLOCKQUOTE> 1447<DIV CLASS="refsynopsisdiv"> 1448<P CLASS="para">Allowable values: character</p> 1449 1450<P CLASS="para"> 1451Sets the unique mangling character used in all mangled names.</p> 1452</div> 1453</blockquote> 1454</div> 1455<p> </p> 1456 1457<DIV CLASS="refentry"> 1458<DIV CLASS="refnamediv"><b><i>[global] mangled stack = number</i></b> 1459<P CLASS="refpurpose">Default: 50</p></div><BLOCKQUOTE> 1460<DIV CLASS="refsynopsisdiv"> 1461<P CLASS="para">Allowable values: number</p> 1462 1463<P CLASS="para"> 1464Sets the size of a cache of recently-mangled filenames.</p> 1465</div> 1466</blockquote> 1467</div> 1468<p> </p> 1469 1470<DIV CLASS="refentry"> 1471<DIV CLASS="refnamediv"><b><i>map aliasname = pathname</i></b> 1472<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1473<DIV CLASS="refsynopsisdiv"> 1474<P CLASS="para">Allowable values: Unix pathname</p> 1475 1476<P CLASS="para"> 1477Points to a file of Unix group/NT group pairs, one per line. This is used to map NT aliases to Unix group names. See also the configuration options <CODE CLASS="literal"> 1478username</code> <CODE CLASS="literal"> 1479map</code> and <CODE CLASS="literal"> 1480map</code> <CODE CLASS="literal"> 1481groupname</code>. Introduced in Samba 2.0.</p> 1482</div> 1483</blockquote> 1484</div> 1485<p> </p> 1486 1487<DIV CLASS="refentry"> 1488<DIV CLASS="refnamediv"><b><i>map archive = boolean</i></b> 1489<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1490<DIV CLASS="refsynopsisdiv"> 1491<P CLASS="para">Allowable values: YES, NO</p> 1492 1493<P CLASS="para"> 1494If YES, Samba sets the executable-by-user (0100) bit on Unix files if the DOS archive attribute is set. Recommended: if used, the <CODE CLASS="literal"> 1495create mask</code> must contain the 0100 bit.</p> 1496</div> 1497</blockquote> 1498</div> 1499<p> </p> 1500 1501<DIV CLASS="refentry"> 1502<DIV CLASS="refnamediv"><b><i>map hidden = boolean</i></b> 1503<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1504<DIV CLASS="refsynopsisdiv"> 1505<P CLASS="para">Allowable values: YES, NO</p> 1506 1507<P CLASS="para"> 1508If YES, sets executable-by-other (0001) bit on Unix files if the DOS hidden attribute is set. If used, the <CODE CLASS="literal"> 1509create mask</code> option must contain the 0001 bit.</p> 1510</div> 1511</blockquote> 1512</div> 1513<p> </p> 1514 1515<DIV CLASS="refentry"> 1516<DIV CLASS="refnamediv"><b><i>map groupname = pathname</i></b> 1517<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1518<DIV CLASS="refsynopsisdiv"> 1519<P CLASS="para">Allowable values: pathname</p> 1520 1521<P CLASS="para"> 1522Points to a file of Unix group/NT group, one per line. This is used to map NT group names to Unix group names. See also the configuration options <CODE CLASS="literal"> 1523username</code> <CODE CLASS="literal"> 1524map</code> and <CODE CLASS="literal"> 1525map</code> <CODE CLASS="literal"> 1526aliasname</code>. Introduced in Samba 2.0.</p> 1527</div> 1528</blockquote> 1529</div> 1530<p> </p> 1531 1532<DIV CLASS="refentry"> 1533<DIV CLASS="refnamediv"><b><i>map system = boolean</i></b> 1534<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1535<DIV CLASS="refsynopsisdiv"> 1536<P CLASS="para">Allowable values: YES, NO</p> 1537 1538<P CLASS="para"> 1539If YES, Samba sets the executable-by-group (0010) bit on Unix files if the DOS system attribute is set. If used, the <CODE CLASS="literal"> 1540create mask</code> must contain the 0010 bit.</p> 1541</div> 1542</blockquote> 1543</div> 1544<p> </p> 1545 1546<DIV CLASS="refentry"> 1547<DIV CLASS="refnamediv"><b><i>max connections = number</i></b> 1548<P CLASS="refpurpose">Default: 0 (infinity)</p></div><BLOCKQUOTE> 1549<DIV CLASS="refsynopsisdiv"> 1550<P CLASS="para">Allowable values: number</p> 1551 1552<P CLASS="para"> 1553Set maximum number of connections allowed to a share from each individual client machine.</p> 1554</div> 1555</blockquote> 1556</div> 1557<p> </p> 1558 1559<DIV CLASS="refentry"> 1560<DIV CLASS="refnamediv"><b><i>[global] max disk size = number</i></b> 1561<P CLASS="refpurpose">Default: 0 (unchanged)</p></div><BLOCKQUOTE> 1562<DIV CLASS="refsynopsisdiv"> 1563<P CLASS="para">Allowable values: size in MB</p> 1564 1565<P CLASS="para"> 1566Sets maximum disk size/free-space size (in megabytes) to return to client. Some clients or applications can't understand large maximum disk sizes.</p> 1567</div> 1568</blockquote> 1569</div> 1570<p> </p> 1571 1572<DIV CLASS="refentry"> 1573<DIV CLASS="refnamediv"><b><i>[global] max log size = number</i></b> 1574<P CLASS="refpurpose">Default: 5000</p></div><BLOCKQUOTE> 1575<DIV CLASS="refsynopsisdiv"> 1576<P CLASS="para">Allowable values: size in KB</p> 1577 1578<P CLASS="para"> 1579Sets the size (in kilobytes) at which Samba will start a new log file. The current log file will be renamed with an <EM CLASS="emphasis"> 1580.old</em> extension, replacing any previous file with that name. </p> 1581</div> 1582</blockquote> 1583</div> 1584<p> </p> 1585 1586<DIV CLASS="refentry"> 1587<DIV CLASS="refnamediv"><b><i>[global] max mux = number</i></b> 1588<P CLASS="refpurpose">Default: 50</p></div><BLOCKQUOTE> 1589<DIV CLASS="refsynopsisdiv"> 1590<P CLASS="para">Allowable values: number</p> 1591 1592<P CLASS="para"> 1593Sets the number of simultaneous operations that Samba clients may make. Avoid changing.</p> 1594</div> 1595</blockquote> 1596</div> 1597<p> </p> 1598 1599<DIV CLASS="refentry"> 1600<DIV CLASS="refnamediv"><b><i>[global] max packet = number</i></b> 1601<P CLASS="refpurpose">Default: N/A</p></div><BLOCKQUOTE> 1602<DIV CLASS="refsynopsisdiv"> 1603<P CLASS="para">Allowable values: number</p> 1604 1605<P CLASS="para"> 1606Synonym for <CODE CLASS="literal"> 1607packet size</code>. Obsolete as of Samba 1.7. Use <CODE CLASS="literal"> 1608max xmit</code> instead.</p> 1609</div> 1610</blockquote> 1611</div> 1612<p> </p> 1613 1614<DIV CLASS="refentry"> 1615<DIV CLASS="refnamediv"><b><i>[global] max open files = number</i></b> 1616<P CLASS="refpurpose">Default: 10,000</p></div><BLOCKQUOTE> 1617<DIV CLASS="refsynopsisdiv"> 1618<P CLASS="para">Allowable values: number</p> 1619 1620<P CLASS="para"> 1621Limits the number of files a Samba process will try to keep open at one time. Samba allows you to set this to less than the Unix maximum. This option is a workaround for a separate problem. Avoid changing. This option was introduced in Samba 2.0.</p> 1622</div> 1623</blockquote> 1624</div> 1625<p> </p> 1626 1627<DIV CLASS="refentry"> 1628<DIV CLASS="refnamediv"><b><i>[global] max ttl = seconds</i></b> 1629<P CLASS="refpurpose">Default: 14400 (4 hrs)</p></div><BLOCKQUOTE> 1630<DIV CLASS="refsynopsisdiv"> 1631<P CLASS="para">Allowable values: time in seconds</p> 1632 1633<P CLASS="para"> 1634Sets the time to keep NetBIOS names in <EM CLASS="emphasis"> 1635nmbd</em> cache while trying to perform a lookup on it. Avoid changing.</p> 1636</div> 1637</blockquote> 1638</div> 1639<p> </p> 1640 1641<DIV CLASS="refentry"> 1642<DIV CLASS="refnamediv"><b><i>[global] max wins ttl = seconds</i></b> 1643<P CLASS="refpurpose">Default: 259200 (3 days)</p></div><BLOCKQUOTE> 1644<DIV CLASS="refsynopsisdiv"> 1645<P CLASS="para">Allowable values: time in seconds</p> 1646 1647<P CLASS="para"> 1648Limits time-to-live of a NetBIOS name in <EM CLASS="emphasis"> 1649nmbd</em> WINS cache, in seconds. Avoid changing.</p> 1650</div> 1651</blockquote> 1652</div> 1653<p> </p> 1654 1655<DIV CLASS="refentry"> 1656<DIV CLASS="refnamediv"><b><i>[global] max xmit = bytes</i></b> 1657<P CLASS="refpurpose">Default: 65535</p></div><BLOCKQUOTE> 1658<DIV CLASS="refsynopsisdiv"> 1659<P CLASS="para">Allowable values: size in bytes</p> 1660 1661<P CLASS="para"> 1662Sets maximum packet size that will be negotiated by Samba. Tuning parameter for slow links and older client bugs. Values less than 2048 are discouraged.</p> 1663</div> 1664</blockquote> 1665</div> 1666<p> </p> 1667 1668<DIV CLASS="refentry"> 1669<DIV CLASS="refnamediv"><b><i>[global] message command = /absolute_ path/command</i></b> 1670<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1671<DIV CLASS="refsynopsisdiv"> 1672<P CLASS="para">Allowable values: shell command</p> 1673 1674<P CLASS="para"> 1675Sets the command on the server to run when a WinPopup message arrives from a client. The command must end in "<CODE CLASS="literal">&</code>" to allow immediate return. Honors all %-variables except <CODE CLASS="literal"> 1676%u</code> (user), and supports the extra variables <CODE CLASS="literal"> 1677%s</code> (filename the message is in), <CODE CLASS="literal"> 1678%t</code> (destination machine), and <CODE CLASS="literal"> 1679%f</code> (from).</p> 1680</div> 1681</blockquote> 1682</div> 1683<p> </p> 1684 1685<DIV CLASS="refentry"> 1686<DIV CLASS="refnamediv"><b><i>min print space = kilobytes</i></b> 1687<P CLASS="refpurpose">Default: 0 (unlimited)</p></div><BLOCKQUOTE> 1688<DIV CLASS="refsynopsisdiv"> 1689<P CLASS="para">Allowable values: space in KB</p> 1690 1691<P CLASS="para"> 1692Sets minimum spool space required before accepting a print request.</p> 1693</div> 1694</blockquote> 1695</div> 1696<p> </p> 1697 1698<!-- 2.0.7, davecb --> 1699<DIV CLASS="refentry"> 1700<DIV CLASS="refnamediv"><b><i>min password length = characters</i></b> 1701<P CLASS="refpurpose">Default: 5</p></div><BLOCKQUOTE> 1702<DIV CLASS="refsynopsisdiv"> 1703<P CLASS="para">Allowable values: decimal number of characters</p> 1704 1705<P CLASS="para"> 1706Sets the shortest password Samba will pass to the Unix passwd command. 1707</div> 1708</blockquote> 1709</div> 1710<p> </p> 1711<!-- sne 2.0.7 --> 1712 1713<DIV CLASS="refentry"> 1714<DIV CLASS="refnamediv"><b><i>[global] min wins ttl = seconds</i></b> 1715<P CLASS="refpurpose">Default: 21600 (6 hrs)</p></div><BLOCKQUOTE> 1716<DIV CLASS="refsynopsisdiv"> 1717<P CLASS="para">Allowable values: time in seconds</p> 1718 1719<P CLASS="para"> 1720Sets minimum time-to-live of a NetBIOS name in <EM CLASS="emphasis"> 1721nmbd</em> WINS cache, in seconds. Avoid changing.</p> 1722</div> 1723</blockquote> 1724</div> 1725<p> </p> 1726 1727<DIV CLASS="refentry"> 1728<DIV CLASS="refnamediv"><b><i>name resolve order = list</i></b> 1729<P CLASS="refpurpose">Default: lmhosts wins hosts bcast</p></div><BLOCKQUOTE> 1730<DIV CLASS="refsynopsisdiv"> 1731<P CLASS="para">Allowable values: list of lmhosts, wins, hosts and bcast</p> 1732 1733<P CLASS="para"> 1734Sets order of lookup when trying to get IP address from names. The <CODE CLASS="literal"> 1735hosts</code> parameter carrries out a regular name look up using the server's normal sources: <EM CLASS="emphasis"> 1736/etc/hosts</em>, DNS, NIS, or a combination of them. Introduced in Samba 1.9.18p4.</p> 1737</div> 1738</blockquote> 1739</div> 1740<p> </p> 1741 1742<DIV CLASS="refentry"> 1743<DIV CLASS="refnamediv"><b><i>[global] netbios aliases = list</i></b> 1744<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1745<DIV CLASS="refsynopsisdiv"> 1746<P CLASS="para">Allowable values: list of netbios names</p> 1747 1748<P CLASS="para"> 1749Adds additional NetBIOS names by which a Samba server will advertise itself.</p> 1750</div> 1751</blockquote> 1752</div> 1753<p> </p> 1754 1755<DIV CLASS="refentry"> 1756<DIV CLASS="refnamediv"><b><i>netbios name = hostname</i></b> 1757<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 1758<DIV CLASS="refsynopsisdiv"> 1759<P CLASS="para">Allowable values: host name</p> 1760 1761<P CLASS="para"> 1762Sets the NetBIOS name by which a Samba server is known, or primary name if NetBIOS aliases exist. </p> 1763</div> 1764</blockquote> 1765</div> 1766<p> </p> 1767 1768<!-- 2.0.7, davecb --> 1769 1770<DIV CLASS="refentry"> 1771<DIV CLASS="refnamediv"><b><i>netbios scope = string</i></b> 1772<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1773<DIV CLASS="refsynopsisdiv"> 1774<P CLASS="para">Allowable values: string</p> 1775 1776<P CLASS="para"> 1777Sets the NetBIOS scope string. Samba will not communicate with a machine 1778with a different scope. This was an early predecessor of workgroups: avoid 1779setting it. Added in 2.0.7. <!-- why was it added, anyway? --> 1780</div> 1781</blockquote> 1782</div> 1783<p> </p> 1784<!-- end 2.0.7 --> 1785 1786<DIV CLASS="refentry"> 1787<DIV CLASS="refnamediv"><b><i>[global] networkstation user login = boolean</i></b> 1788<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1789<DIV CLASS="refsynopsisdiv"> 1790<P CLASS="para">Allowable values: YES, NO</p> 1791 1792<P CLASS="para"> 1793If set to NO, clients will not do a full login when <CODE CLASS="literal"> 1794security = server</code>. Avoid changing. Turning it off is a temporary workaround (introduced in Samba 1.9.18p3) for NT trusted domains bug. Automatic correction was introduced in Samba 1.9.18p10; the parameter may eventually be removed.</p> 1795</div> 1796</blockquote> 1797</div> 1798<p> </p> 1799 1800<DIV CLASS="refentry"> 1801<DIV CLASS="refnamediv"><b><i>[global] nis homedir = boolean</i></b> 1802<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1803<DIV CLASS="refsynopsisdiv"> 1804<P CLASS="para">Allowable values: YES, NO</p> 1805 1806<P CLASS="para"> 1807If YES, the <CODE CLASS="literal"> 1808homedir map</code> will be used to look up the user's home-directory server name and return it to the client. The client will contact that machine to connect to the share. This avoids mounting from a machine that doesn't actually have the disk. The machine with the home directories must be an SMB server.</p> 1809</div> 1810</blockquote> 1811</div> 1812<p> </p> 1813 1814<DIV CLASS="refentry"> 1815<DIV CLASS="refnamediv"><b><i>[global] nt pipe support = boolean</i></b> 1816<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1817<DIV CLASS="refsynopsisdiv"> 1818<P CLASS="para">Allowable values: YES, NO</p> 1819 1820<P CLASS="para"> 1821Allows turning off NT-specific pipe calls. This is a developer/benchmarking option and may be removed in the future. Avoid changing.</p> 1822</div> 1823</blockquote> 1824</div> 1825<p> </p> 1826 1827<DIV CLASS="refentry"> 1828<DIV CLASS="refnamediv"><b><i>[global] nt smb support = boolean</i></b> 1829<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1830<DIV CLASS="refsynopsisdiv"> 1831<P CLASS="para">Allowable values: YES, NO</p> 1832 1833<P CLASS="para"> 1834If YES, allow NT-specific SMBs to be used. This is a developer/benchmarking option and may be removed in the future. Avoid changing.</p> 1835</div> 1836</blockquote> 1837</div> 1838<p> </p> 1839 1840<DIV CLASS="refentry"> 1841<DIV CLASS="refnamediv"><b><i>[global] null passwords = boolean</i></b> 1842<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1843<DIV CLASS="refsynopsisdiv"> 1844<P CLASS="para">Allowable values: YES, NO</p> 1845 1846<P CLASS="para"> 1847If YES, allows access to accounts that have null passwords. Strongly discouraged.</p> 1848</div> 1849</blockquote> 1850</div> 1851<p> </p> 1852 1853<DIV CLASS="refentry"> 1854<DIV CLASS="refnamediv"><b><i>ole locking compatibility = boolean</i></b> 1855<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1856<DIV CLASS="refsynopsisdiv"> 1857<P CLASS="para">Allowable values: YES, NO</p> 1858 1859<P CLASS="para"> 1860If YES, locking ranges will be mapped to avoid Unix locks crashing when Windows uses locks above 32KB. You should avoid changing this option. Introduced in Samba 1.9.18p10. </p> 1861</div> 1862</blockquote> 1863</div> 1864<p> </p> 1865 1866<DIV CLASS="refentry"> 1867<DIV CLASS="refnamediv"><b><i>only guest = boolean</i></b> 1868<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1869<DIV CLASS="refsynopsisdiv"> 1870<P CLASS="para">Allowable values: YES, NO</p> 1871 1872<P CLASS="para"> 1873A synonym for <CODE CLASS="literal"> 1874guest only</code>. Forces user of a share to login as the guest account. </p> 1875</div> 1876</blockquote> 1877</div> 1878<p> </p> 1879 1880<DIV CLASS="refentry"> 1881<DIV CLASS="refnamediv"><b><i>only user = boolean</i></b> 1882<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1883<DIV CLASS="refsynopsisdiv"> 1884<P CLASS="para">Allowable values: YES, NO</p> 1885 1886<P CLASS="para"> 1887Requires that users of the share be on a <CODE CLASS="literal"> 1888username =</code> list. </p> 1889</div> 1890</blockquote> 1891</div> 1892<p> </p> 1893 1894<DIV CLASS="refentry"> 1895<DIV CLASS="refnamediv"><b><i>oplocks = boolean</i></b> 1896<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 1897<DIV CLASS="refsynopsisdiv"> 1898<P CLASS="para">Allowable values: YES, NO</p> 1899 1900<P CLASS="para"> 1901If YES, support local caching of <EM CLASS="emphasis"> 1902opportunistic</em> locked files on client. This option is recommended because it improves performance by about 30%. See also <CODE CLASS="literal"> 1903fake</code> <CODE CLASS="literal"> 1904oplocks</code> and <CODE CLASS="literal"> 1905veto</code> <CODE CLASS="literal"> 1906oplock</code> <CODE CLASS="literal"> 1907files</code>. </p> 1908</div> 1909</blockquote> 1910</div> 1911<p> </p> 1912 1913<DIV CLASS="refentry"> 1914<DIV CLASS="refnamediv"><b><i>[global] os level = number</i></b> 1915<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 1916<DIV CLASS="refsynopsisdiv"> 1917<P CLASS="para">Allowable values: number</p> 1918 1919<P CLASS="para"> 1920Sets the candidacy of the server when electing a browse master. Used with the <CODE CLASS="literal"> 1921domain</code> <CODE CLASS="literal"> 1922master</code> or <CODE CLASS="literal"> 1923local</code> <CODE CLASS="literal"> 1924master</code> options. You can set a higher value than a competing operating system if you want Samba to win. Windows for Workgroups and Windows 95 use 1, Windows NT client uses 17, and Windows NT Server uses 33.</p> 1925</div> 1926</blockquote> 1927</div> 1928<p> </p> 1929 1930<DIV CLASS="refentry"> 1931<DIV CLASS="refnamediv"><b><i>[global] packet size = bytes</i></b> 1932<P CLASS="refpurpose">Default: 65535</p></div><BLOCKQUOTE> 1933<DIV CLASS="refsynopsisdiv"> 1934<P CLASS="para">Allowable values: number in bytes</p> 1935 1936<P CLASS="para"> 1937Obsolete. Discouraged synonym of <CODE CLASS="literal"> 1938max packet</code>. See <CODE CLASS="literal"> 1939max xmit</code>.</p> 1940</div> 1941</blockquote> 1942</div> 1943<p> </p> 1944 1945<DIV CLASS="refentry"> 1946<DIV CLASS="refnamediv"><b><i>[global] passwd chat debug = boolean</i></b> 1947<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 1948<DIV CLASS="refsynopsisdiv"> 1949<P CLASS="para">Allowable values: YES, NO</p> 1950 1951<P CLASS="para"> 1952Logs an entire password chat, including passwords passed, with a log level of 100. For debugging only. Introduced in Samba 1.9.18p5.</p> 1953</div> 1954</blockquote> 1955</div> 1956<p> </p> 1957 1958<DIV CLASS="refentry"> 1959<DIV CLASS="refnamediv"><b><i>[global] passwd chat = command sequence</i></b> 1960<P CLASS="refpurpose">Default: compiled-in value</p></div><BLOCKQUOTE> 1961<DIV CLASS="refsynopsisdiv"> 1962<P CLASS="para">Allowable values: Unix server commands</p> 1963 1964<P CLASS="para"> 1965Sets the command used to change passwords on the server. Supports the variables <CODE CLASS="literal"> 1966%o</code> (old password) and <CODE CLASS="literal"> 1967%n</code> (new password) and allows <CODE CLASS="literal"> 1968\r</code> <CODE CLASS="literal"> 1969\n</code> <CODE CLASS="literal"> 1970\t</code> and <CODE CLASS="literal"> 1971\s</code> (space) escapes in the sequence.</p> 1972</div> 1973</blockquote> 1974</div> 1975<p> </p> 1976 1977<DIV CLASS="refentry"> 1978<DIV CLASS="refnamediv"><b><i>[global] passwd program = program</i></b> 1979<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 1980<DIV CLASS="refsynopsisdiv"> 1981<P CLASS="para">Allowable values: Unix server program</p> 1982 1983<P CLASS="para"> 1984Sets the command used to change user's password. Will be run as <CODE CLASS="literal"> 1985root</code>. Supports <CODE CLASS="literal"> 1986%u</code> (user).</p> 1987</div> 1988</blockquote> 1989</div> 1990<p> </p> 1991 1992<DIV CLASS="refentry"> 1993<DIV CLASS="refnamediv"><b><i>[global] password level = number</i></b> 1994<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 1995<DIV CLASS="refsynopsisdiv"> 1996<P CLASS="para">Allowable values: number</p> 1997 1998<P CLASS="para"> 1999Specifies the number of uppercase letter permutations used to match passwords. Workaround for clients that change passwords to a single case before sending them to the Samba server. Causes repeated login attempts with passwords in different cases, which can trigger account lockouts. </p> 2000</div> 2001</blockquote> 2002</div> 2003<p> </p> 2004 2005<DIV CLASS="refentry"> 2006<DIV CLASS="refnamediv"><b><i>[global] password server = netbios names</i></b> 2007<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2008<DIV CLASS="refsynopsisdiv"> 2009<P CLASS="para">Allowable values: list of NetBIOS names</p> 2010 2011<P CLASS="para"> 2012A list of SMB servers that will validate passwords for you. Used with an NT password server (PDC or BDC) and the <CODE CLASS="literal"> 2013security</code> <CODE CLASS="literal"> 2014=</code> <CODE CLASS="literal"> 2015server</code> or <CODE CLASS="literal"> 2016security</code> <CODE CLASS="literal"> 2017=</code> <CODE CLASS="literal"> 2018domain</code> configuration options. Caution: an NT password server must allow logins from the Samba server.</p> 2019</div> 2020</blockquote> 2021</div> 2022<p> </p> 2023 2024<DIV CLASS="refentry"> 2025<DIV CLASS="refnamediv"><b><i>panic action = /absolute_ path/command</i></b> 2026<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2027<DIV CLASS="refsynopsisdiv"> 2028<P CLASS="para">Allowable values: fully-qualfied Unix shell command</p> 2029 2030<P CLASS="para"> 2031Sets the command to run when Samba panics. For Samba developers and testers, <CODE CLASS="literal"> 2032/usr/bin/X11/xterm -display :0 -e gdb /samba/bin/smbd %d</code> is a possible value.</p> 2033</div> 2034</blockquote> 2035</div> 2036<p> </p> 2037 2038<DIV CLASS="refentry"> 2039<DIV CLASS="refnamediv"><b><i>path = pathname</i></b> 2040<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 2041<DIV CLASS="refsynopsisdiv"> 2042<P CLASS="para">Allowable values: pathname</p> 2043 2044<P CLASS="para"> 2045Sets the path to the directory provided by a file share or used by a printer share. Set automatically in <CODE CLASS="literal"> 2046[homes]</code> share to user's home directory, otherwise defaults to<I CLASS="filename"> 2047 /tmp</i>. Honors the <CODE CLASS="literal"> 2048%u</code> (user) and <CODE CLASS="literal"> 2049%m</code> (machine) variables.</p> 2050</div> 2051</blockquote> 2052</div> 2053<p> </p> 2054 2055<DIV CLASS="refentry"> 2056<DIV CLASS="refnamediv"><b><i>postexec = /absolute_ path/command</i></b> 2057<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2058<DIV CLASS="refsynopsisdiv"> 2059<P CLASS="para">Allowable values: fully-qualified Unix shell command</p> 2060 2061<P CLASS="para"> 2062Sets a command to run as the user after disconnecting from the share. See also the options <CODE CLASS="literal"> 2063preexec</code>, <CODE CLASS="literal"> 2064root preexec</code>, and <CODE CLASS="literal"> 2065root postexec</code>.</p> 2066</div> 2067</blockquote> 2068</div> 2069<p> </p> 2070 2071<DIV CLASS="refentry"> 2072<DIV CLASS="refnamediv"><b><i>postscript = boolean</i></b> 2073<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2074<DIV CLASS="refsynopsisdiv"> 2075<P CLASS="para">Allowable values: YES, NO</p> 2076 2077<P CLASS="para"> 2078Flags a printer as PostScript to avoid a Windows bug by inserting <CODE CLASS="literal"> 2079%!</code> as the first line. Works only if printer actually is PostScript compatible.</p> 2080</div> 2081</blockquote> 2082</div> 2083<p> </p> 2084 2085<DIV CLASS="refentry"> 2086<DIV CLASS="refnamediv"><b><i>preexec = /absolute_ path/command</i></b> 2087<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2088<DIV CLASS="refsynopsisdiv"> 2089<P CLASS="para">Allowable values: fully-qualified Unix shell command</p> 2090 2091<P CLASS="para"> 2092Sets a command to run as the user before connecting to the share. See also the options <CODE CLASS="literal"> 2093postexec</code>, <CODE CLASS="literal"> 2094root preexec</code>, and <CODE CLASS="literal"> 2095root postexec</code>.</p> 2096</div> 2097</blockquote> 2098</div> 2099<p> </p> 2100 2101<DIV CLASS="refentry"> 2102<DIV CLASS="refnamediv"><b><i>[global] preferred master = boolean</i></b> 2103<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2104<DIV CLASS="refsynopsisdiv"> 2105<P CLASS="para">Allowable values: YES, NO</p> 2106 2107<P CLASS="para"> 2108If YES, Samba is preferred to become the master browser. Causes Samba to call a browsing election when it comes online.</p> 2109</div> 2110</blockquote> 2111</div> 2112<p> </p> 2113 2114<DIV CLASS="refentry"> 2115<DIV CLASS="refnamediv"><b><i>preload = share list</i></b> 2116<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2117<DIV CLASS="refsynopsisdiv"> 2118<P CLASS="para">Allowable values: list of services</p> 2119 2120<P CLASS="para"> 2121Synonym of <CODE CLASS="literal"> 2122auto</code> <CODE CLASS="literal"> 2123services</code>. Specifies a list of shares that will always appear in browse lists.</p> 2124</div> 2125</blockquote> 2126</div> 2127<p> </p> 2128 2129<DIV CLASS="refentry"> 2130<DIV CLASS="refnamediv"><b><i>preserve case = boolean</i></b> 2131<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2132<DIV CLASS="refsynopsisdiv"> 2133<P CLASS="para">Allowable values: YES, NO</p> 2134 2135<P CLASS="para"> 2136If set to YES, this option leaves filenames in the case sent by client. If no, it forces filenames to the case specified by the <CODE CLASS="literal"> 2137default</code> <CODE CLASS="literal"> 2138case</code> option. See also <CODE CLASS="literal"> 2139short preserve case</code>.</p> 2140</div> 2141</blockquote> 2142</div> 2143<p> </p> 2144 2145<DIV CLASS="refentry"> 2146<DIV CLASS="refnamediv"><b><i>print command = /absolute_ path/command</i></b> 2147<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 2148<DIV CLASS="refsynopsisdiv"> 2149<P CLASS="para">Allowable values: fully-qualified Unix shell command</p> 2150 2151<P CLASS="para"> 2152Sets the command used to send a spooled file to the printer. Usually initialized to a default value by the <CODE CLASS="literal"> 2153printing</code> option. This option honors the <CODE CLASS="literal"> 2154%p</code> (printer name), <CODE CLASS="literal"> 2155%s</code> (spool file) and <CODE CLASS="literal"> 2156%f</code> (spool file as a relative path) variables. Note that the command in the value of the option must include file deletion of the spool file.</p> 2157</div> 2158</blockquote> 2159</div> 2160<p> </p> 2161 2162<DIV CLASS="refentry"> 2163<DIV CLASS="refnamediv"><b><i>print ok = boolean</i></b> 2164<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2165<DIV CLASS="refsynopsisdiv"> 2166<P CLASS="para">Allowable values: YES, NO</p> 2167 2168<P CLASS="para"> 2169Synonym of <CODE CLASS="literal"> 2170printable</code>.</p> 2171</div> 2172</blockquote> 2173</div> 2174<p> </p> 2175 2176<DIV CLASS="refentry"> 2177<DIV CLASS="refnamediv"><b><i>printable = boolean</i></b> 2178<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2179<DIV CLASS="refsynopsisdiv"> 2180<P CLASS="para">Allowable values: YES, NO</p> 2181 2182<P CLASS="para"> 2183Sets a share to be a print share. Required for all printers.</p> 2184</div> 2185</blockquote> 2186</div> 2187<p> </p> 2188 2189<DIV CLASS="refentry"> 2190<DIV CLASS="refnamediv"><b><i>[global] printcap name = pathname</i></b> 2191<P CLASS="refpurpose">Default: <EM CLASS="emphasis"> 2192/etc/printcap</em></p></div><BLOCKQUOTE> 2193<DIV CLASS="refsynopsisdiv"> 2194<P CLASS="para">Allowable values: pathname</p> 2195 2196<P CLASS="para"> 2197Sets the path to the printer capabilities file used by the <CODE CLASS="literal"> 2198[printers]</code> share. The default value changes to <I CLASS="filename"> 2199/etc/qconfig</i> under AIX and <I CLASS="filename"> 2200lpstat</i> on System V.</p> 2201</div> 2202</blockquote> 2203</div> 2204<p> </p> 2205 2206<DIV CLASS="refentry"> 2207<DIV CLASS="refnamediv"><b><i>printer = name</i></b> 2208<P CLASS="refpurpose">Default: <CODE CLASS="literal"> 2209lp</code></p></div><BLOCKQUOTE> 2210<DIV CLASS="refsynopsisdiv"> 2211<P CLASS="para">Allowable values: printer name</p> 2212 2213<P CLASS="para"> 2214Sets the name of the Unix printer.</p> 2215</div> 2216</blockquote> 2217</div> 2218<p> </p> 2219 2220<DIV CLASS="refentry"> 2221<DIV CLASS="refnamediv"><b><i>printer driver = printer driver name</i></b> 2222<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2223<DIV CLASS="refsynopsisdiv"> 2224<P CLASS="para">Allowable values: exact printer driver string used by Windows</p> 2225 2226<P CLASS="para"> 2227Sets the string to pass to Windows when asked what driver to use to prepare files for a printer share. Note that the value is case sensitive.</p> 2228</div> 2229</blockquote> 2230</div> 2231<p> </p> 2232 2233<DIV CLASS="refentry"> 2234<DIV CLASS="refnamediv"><b><i>[global] printer driver file = path</i></b> 2235<P CLASS="refpurpose">Default: <EM CLASS="emphasis"> 2236samba-lib/printers.def</em></p></div><BLOCKQUOTE> 2237<DIV CLASS="refsynopsisdiv"> 2238<P CLASS="para">Allowable values: Unix pathname</p> 2239 2240<P CLASS="para"> 2241Sets the location of a<EM CLASS="emphasis"> 2242 msprint.def</em> file, usable by Windows 95/98.</p> 2243</div> 2244</blockquote> 2245</div> 2246<p> </p> 2247 2248<DIV CLASS="refentry"> 2249<DIV CLASS="refnamediv"><b><i>printer driver location = path</i></b> 2250<P CLASS="refpurpose">Default: <EM CLASS="emphasis"> 2251\\</em><CODE CLASS="replaceable"><I>server</i></code><EM CLASS="emphasis">\PRINTER$</em></p></div><BLOCKQUOTE> 2252<DIV CLASS="refsynopsisdiv"> 2253<P CLASS="para">Allowable values: Windows network path</p> 2254 2255<P CLASS="para"> 2256Sets the location of the driver for a particular printer. The value is a pathname for a share that stores the printer driver files.</p> 2257</div> 2258</blockquote> 2259</div> 2260<p> </p> 2261 2262<DIV CLASS="refentry"> 2263<DIV CLASS="refnamediv"><b><i>printer name = name</i></b> 2264<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2265<DIV CLASS="refsynopsisdiv"> 2266<P CLASS="para">Allowable values: name</p> 2267 2268<P CLASS="para"> 2269Synonym of <CODE CLASS="literal"> 2270printer</code>.</p> 2271</div> 2272</blockquote> 2273</div> 2274<p> </p> 2275 2276<DIV CLASS="refentry"> 2277<DIV CLASS="refnamediv"><b><i>printing = style</i></b> 2278<P CLASS="refpurpose">Default: bsd</p></div><BLOCKQUOTE> 2279<DIV CLASS="refsynopsisdiv"> 2280<P CLASS="para">Allowable values: bsd, sysv, hpux, aix, qnx, plp, lprng</p> 2281 2282<P CLASS="para"> 2283Sets printing style to one of the above, instead of the compiled-in value. This sets initial values of at least the <CODE CLASS="literal"> 2284print</code> <CODE CLASS="literal"> 2285command</code>, <CODE CLASS="literal"> 2286print</code> <CODE CLASS="literal"> 2287command</code>, <CODE CLASS="literal"> 2288lpq</code> <CODE CLASS="literal"> 2289command</code>, and <CODE CLASS="literal"> 2290lprm</code> <CODE CLASS="literal"> 2291command</code>.</p> 2292</div> 2293</blockquote> 2294</div> 2295<p> </p> 2296 2297<DIV CLASS="refentry"> 2298<DIV CLASS="refnamediv"><b><i>[global] protocol = protocol</i></b> 2299<P CLASS="refpurpose">Default: NT1</p></div><BLOCKQUOTE> 2300<DIV CLASS="refsynopsisdiv"> 2301<P CLASS="para">Allowable values: NT1, LANMAN2, LANMAN1, COREPLUS, CORE</p> 2302 2303<P CLASS="para"> 2304Sets SMB protocol version to one of the allowable values. Resetting is highly discouraged. Only for backwards compatibility with older-client bugs.</p> 2305</div> 2306</blockquote> 2307</div> 2308<p> </p> 2309 2310<DIV CLASS="refentry"> 2311<DIV CLASS="refnamediv"><b><i>public = boolean</i></b> 2312<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2313<DIV CLASS="refsynopsisdiv"> 2314<P CLASS="para">Allowable values: YES, NO</p> 2315 2316<P CLASS="para"> 2317If YES, passwords are not needed for this share. A synonym is <CODE CLASS="literal"> 2318guest ok</code>.</p> 2319</div> 2320</blockquote> 2321</div> 2322<p> </p> 2323 2324<DIV CLASS="refentry"> 2325<DIV CLASS="refnamediv"><b><i>queuepause command = /absolute_ path/command</i></b> 2326<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 2327<DIV CLASS="refsynopsisdiv"> 2328<P CLASS="para">Allowable values: valid Unix command</p> 2329 2330<P CLASS="para"> 2331Sets the command used to pause a print queue. Usually initialized to a default value by the <CODE CLASS="literal"> 2332printing</code> option. Introduced in Samba 1.9.18p10.</p> 2333</div> 2334</blockquote> 2335</div> 2336<p> </p> 2337 2338<DIV CLASS="refentry"> 2339<DIV CLASS="refnamediv"><b><i>queueresume command = /absolute_ path/command</i></b> 2340<P CLASS="refpurpose">Default: varies</p></div><BLOCKQUOTE> 2341<DIV CLASS="refsynopsisdiv"> 2342<P CLASS="para">Allowable values: valid Unix command</p> 2343 2344<P CLASS="para"> 2345Sets the command used to resume a print queue. Usually initialized to a default value by the <CODE CLASS="literal"> 2346printing</code> option. Introduced in Samba 1.9.18p10.</p> 2347</div> 2348</blockquote> 2349</div> 2350<p> </p> 2351 2352<DIV CLASS="refentry"> 2353<DIV CLASS="refnamediv"><b><i>read bmpx = boolean</i></b> 2354<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2355<DIV CLASS="refsynopsisdiv"> 2356<P CLASS="para">Allowable values: YES, NO</p> 2357 2358<P CLASS="para"> 2359Obsolete. Do not change.</p> 2360</div> 2361</blockquote> 2362</div> 2363<p> </p> 2364 2365<DIV CLASS="refentry"> 2366<DIV CLASS="refnamediv"><b><i>read list = comma-separated list</i></b> 2367<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2368<DIV CLASS="refsynopsisdiv"> 2369<P CLASS="para">Allowable values: comma-separated list of users</p> 2370 2371<P CLASS="para"> 2372Specifies a list of users given read-only access to a writeable share. </p> 2373</div> 2374</blockquote> 2375</div> 2376<p> </p> 2377 2378<DIV CLASS="refentry"> 2379<DIV CLASS="refnamediv"><b><i>read only = boolean</i></b> 2380<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2381<DIV CLASS="refsynopsisdiv"> 2382<P CLASS="para">Allowable values: YES, NO</p> 2383 2384<P CLASS="para"> 2385Sets a share to read-only. Antonym of <CODE CLASS="literal"> 2386writable</code> and <CODE CLASS="literal"> 2387write ok</code>.</p> 2388</div> 2389</blockquote> 2390</div> 2391<p> </p> 2392 2393<DIV CLASS="refentry"> 2394<DIV CLASS="refnamediv"><b><i>[global] read prediction = boolean</i></b> 2395<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2396<DIV CLASS="refsynopsisdiv"> 2397<P CLASS="para">Allowable values: YES, NO</p> 2398 2399<P CLASS="para"> 2400Reads ahead data for read-only files. Obsolete; removed in Samba 2.0.</p> 2401</div> 2402</blockquote> 2403</div> 2404<p> </p> 2405 2406<DIV CLASS="refentry"> 2407<DIV CLASS="refnamediv"><b><i>[global] read raw = boolean</i></b> 2408<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 2409<DIV CLASS="refsynopsisdiv"> 2410<P CLASS="para">Allowable values: YES, NO</p> 2411 2412<P CLASS="para"> 2413Allows fast streaming reads over TCP using 64K buffers. Recommended.</p> 2414</div> 2415</blockquote> 2416</div> 2417<p> </p> 2418 2419<DIV CLASS="refentry"> 2420<DIV CLASS="refnamediv"><b><i>[global] read size = bytes</i></b> 2421<P CLASS="refpurpose">Default: 2048</p></div><BLOCKQUOTE> 2422<DIV CLASS="refsynopsisdiv"> 2423<P CLASS="para">Allowable values: size in bytes</p> 2424 2425<P CLASS="para"> 2426Sets a buffering option for servers with mismatched disk and network speeds. Requires experimentation. Avoid changing. Should not exceed 65536.</p> 2427</div> 2428</blockquote> 2429</div> 2430<p> </p> 2431 2432<DIV CLASS="refentry"> 2433<DIV CLASS="refnamediv"><b><i>[global] remote announce = remote list</i></b> 2434<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2435<DIV CLASS="refsynopsisdiv"> 2436<P CLASS="para">Allowable values: list of remote addresses</p> 2437 2438<P CLASS="para"> 2439Adds workgroups to the list on which the Samba server will announce itself. Specified as IP address/workgroup (for instance, 192.168.220.215/SIMPLE) with multiple groups separated by spaces. Allows directed broadcasts. The server will appear on those workgroup's browse lists. Does not require WINS.</p> 2440</div> 2441</blockquote> 2442</div> 2443<p> </p> 2444 2445<DIV CLASS="refentry"> 2446<DIV CLASS="refnamediv"><b><i>[global] remote browse sync = address list</i></b> 2447<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2448<DIV CLASS="refsynopsisdiv"> 2449<P CLASS="para">Allowable values: IP-address list</p> 2450 2451<P CLASS="para"> 2452Enables Samba-only browse list synchronization with other Samba local master browsers. Addresses can be specific addresses or directed broadcasts (i.e., ###.###.###.255). The latter will cause Samba to hunt down the local master.</p> 2453</div> 2454</blockquote> 2455</div> 2456<p> </p> 2457 2458<DIV CLASS="refentry"> 2459<DIV CLASS="refnamediv"><b><i>revalidate = boolean</i></b> 2460<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2461<DIV CLASS="refsynopsisdiv"> 2462<P CLASS="para">Allowable values: YES, NO</p> 2463 2464<P CLASS="para"> 2465If set to YES, requires users to re-enter passwords even after a successful initial logon to a share with a password.</p> 2466</div> 2467</blockquote> 2468</div> 2469<p> </p> 2470 2471<DIV CLASS="refentry"> 2472<DIV CLASS="refnamediv"><b><i>[global] root = pathname</i></b> 2473<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2474<DIV CLASS="refsynopsisdiv"> 2475<P CLASS="para">Allowable values: Unix pathname</p> 2476 2477<P CLASS="para"> 2478Synonym for <CODE CLASS="literal"> 2479root directory</code>.</p> 2480</div> 2481</blockquote> 2482</div> 2483<p> </p> 2484 2485<DIV CLASS="refentry"> 2486<DIV CLASS="refnamediv"><b><i>[global] root dir = pathname</i></b> 2487<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2488<DIV CLASS="refsynopsisdiv"> 2489<P CLASS="para">Allowable values: Unix pathname</p> 2490 2491<P CLASS="para"> 2492Synonym for <CODE CLASS="literal"> 2493root directory</code>.</p> 2494</div> 2495</blockquote> 2496</div> 2497<p> </p> 2498 2499<DIV CLASS="refentry"> 2500<DIV CLASS="refnamediv"><b><i>[global] root directory = pathname</i></b> 2501<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2502<DIV CLASS="refsynopsisdiv"> 2503<P CLASS="para">Allowable values: Unix pathname</p> 2504 2505<P CLASS="para"> 2506Specifies a directory to <CODE CLASS="literal"> 2507chroot()</code> to before starting daemons. Prevents any access below that directory tree. See also the <CODE CLASS="literal"> 2508wide links</code> configuration option.</p> 2509</div> 2510</blockquote> 2511</div> 2512<p> </p> 2513 2514<DIV CLASS="refentry"> 2515<DIV CLASS="refnamediv"><b><i>root postexec = /absolute_ path/command</i></b> 2516<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2517<DIV CLASS="refsynopsisdiv"> 2518<P CLASS="para">Allowable values: fully-qualified Unix shell command</p> 2519 2520<P CLASS="para"> 2521Sets a command to run as root after disconnecting from the share. See also <CODE CLASS="literal"> 2522preexec</code>, <CODE CLASS="literal"> 2523postexec</code>, and <CODE CLASS="literal"> 2524root</code> <CODE CLASS="literal"> 2525preexec</code> configuration options. Runs after the user's <CODE CLASS="literal"> 2526postexec</code> command. Use with caution.</p> 2527</div> 2528</blockquote> 2529</div> 2530<p> </p> 2531 2532<DIV CLASS="refentry"> 2533<DIV CLASS="refnamediv"><b><i>root preexec = /absolute_ path/command</i></b> 2534<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2535<DIV CLASS="refsynopsisdiv"> 2536<P CLASS="para">Allowable values: fully-qualified Unix shell command</p> 2537 2538<P CLASS="para"> 2539Sets a command to run as root before connecting to the share. See also <CODE CLASS="literal"> 2540preexec</code>, <CODE CLASS="literal"> 2541postexec</code>, and <CODE CLASS="literal"> 2542root</code> <CODE CLASS="literal"> 2543postexec</code> configuration options. Runs before the user's <CODE CLASS="literal"> 2544preexec</code> command. Use with caution.</p> 2545</div> 2546</blockquote> 2547</div> 2548<p> </p> 2549 2550<DIV CLASS="refentry"> 2551<DIV CLASS="refnamediv"><b><i>[global] security = value</i></b> 2552<P CLASS="refpurpose">Default: share in Samba 1.0, user in 2.0</p></div><BLOCKQUOTE> 2553<DIV CLASS="refsynopsisdiv"> 2554<P CLASS="para">Allowable values: share, user, server, domain</p> 2555 2556<P CLASS="para"> 2557Sets password-security policy. If <CODE CLASS="literal"> 2558security</code> <CODE CLASS="literal"> 2559=</code> <CODE CLASS="literal"> 2560share</code>, services have a shared password, available to everyone. If <CODE CLASS="literal"> 2561security</code> <CODE CLASS="literal"> 2562=</code> <CODE CLASS="literal"> 2563user</code>, users have (Unix) accounts and passwords. If <CODE CLASS="literal"> 2564security</code> <CODE CLASS="literal"> 2565=</code> <CODE CLASS="literal"> 2566server</code>, users have accounts and passwords and a separate machine authenticates them for Samba. If <CODE CLASS="literal"> 2567security</code> <CODE CLASS="literal"> 2568=</code> <CODE CLASS="literal"> 2569domain</code>, full NT-domain authentication is done. See also the <CODE CLASS="literal"> 2570password server</code> and <CODE CLASS="literal"> 2571encrypted passwords</code> configuration options. </p> 2572</div> 2573</blockquote> 2574</div> 2575<p> </p> 2576 2577<DIV CLASS="refentry"> 2578<DIV CLASS="refnamediv"><b><i>[global] server string = text</i></b> 2579<P CLASS="refpurpose">Default: Samba <CODE CLASS="literal"> 2580%v</code> in 2.0</p></div><BLOCKQUOTE> 2581<DIV CLASS="refsynopsisdiv"> 2582<P CLASS="para">Allowable values: string</p> 2583 2584<P CLASS="para"> 2585Sets the name that appears beside a server in browse lists. Honors the <CODE CLASS="literal"> 2586%v</code> (Samba version number) and <CODE CLASS="literal"> 2587%h</code> (hostname) variables.</p> 2588</div> 2589</blockquote> 2590</div> 2591<p> </p> 2592 2593<DIV CLASS="refentry"> 2594<DIV CLASS="refnamediv"><b><i>set directory = boolean</i></b> 2595<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2596<DIV CLASS="refsynopsisdiv"> 2597<P CLASS="para">Allowable values: YES, NO</p> 2598 2599<P CLASS="para"> 2600Allows DEC Pathworks client to use the <EM CLASS="emphasis"> 2601set dir</em> command.</p> 2602</div> 2603</blockquote> 2604</div> 2605<p> </p> 2606 2607<DIV CLASS="refentry"> 2608<DIV CLASS="refnamediv"><b><i>[global] shared file entries = number</i></b> 2609<P CLASS="refpurpose">Default: 113</p></div><BLOCKQUOTE> 2610<DIV CLASS="refsynopsisdiv"> 2611<P CLASS="para">Allowable values: number</p> 2612 2613<P CLASS="para"> 2614Obsolete; do not use.</p> 2615</div> 2616</blockquote> 2617</div> 2618<p> </p> 2619 2620<DIV CLASS="refentry"> 2621<DIV CLASS="refnamediv"><b><i>shared mem size = bytes</i></b> 2622<P CLASS="refpurpose">Default: 102400</p></div><BLOCKQUOTE> 2623<DIV CLASS="refsynopsisdiv"> 2624<P CLASS="para">Allowable values: size in bytes</p> 2625 2626<P CLASS="para"> 2627If compiled with FAST_SHARE_MODES (mmap), sets the shared memory size in bytes. Avoid changing.</p> 2628</div> 2629</blockquote> 2630</div> 2631<p> </p> 2632 2633<DIV CLASS="refentry"> 2634<DIV CLASS="refnamediv"><b><i>[global] smb passwd file = path</i></b> 2635<P CLASS="refpurpose">Default: <I CLASS="filename"> 2636/usr/local/samba/private/smbpasswd</i></p></div><BLOCKQUOTE> 2637<DIV CLASS="refsynopsisdiv"> 2638<P CLASS="para">Allowable values: Unix pathname</p> 2639 2640<P CLASS="para"> 2641Overrides compiled-in path to password file if <CODE CLASS="literal"> 2642encrypted passwords</code> <CODE CLASS="literal"> 2643=</code> <CODE CLASS="literal"> 2644yes</code>. </p> 2645</div> 2646</blockquote> 2647</div> 2648<p> </p> 2649 2650<DIV CLASS="refentry"> 2651<DIV CLASS="refnamediv"><b><i>[global] smbrun = /absolute_ path/command</i></b> 2652<P CLASS="refpurpose">Default: compiled-in value</p></div><BLOCKQUOTE> 2653<DIV CLASS="refsynopsisdiv"> 2654<P CLASS="para">Allowable values: smbrun command</p> 2655 2656<P CLASS="para"> 2657Overrides compiled-in path to <I CLASS="filename"> 2658smbrun</i> binary. Avoid changing.</p> 2659</div> 2660</blockquote> 2661</div> 2662<p> </p> 2663 2664<DIV CLASS="refentry"> 2665<DIV CLASS="refnamediv"><b><i>share modes = boolean</i></b> 2666<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 2667<DIV CLASS="refsynopsisdiv"> 2668<P CLASS="para">Allowable values: YES, NO</p> 2669 2670<P CLASS="para"> 2671If set to YES, this option supports Windows-style whole-file (deny mode) locks.</p> 2672</div> 2673</blockquote> 2674</div> 2675<p> </p> 2676 2677<DIV CLASS="refentry"> 2678<DIV CLASS="refnamediv"><b><i>short preserve case = boolean</i></b> 2679<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2680<DIV CLASS="refsynopsisdiv"> 2681<P CLASS="para">Allowable values: YES, NO</p> 2682 2683<P CLASS="para"> 2684If set to YES, leaves mangled 8.3-style filenames in the case sent by client. If no, it forces the case to that specified by the <CODE CLASS="literal"> 2685default case</code> option. See also <CODE CLASS="literal"> 2686preserve case</code>.</p> 2687</div> 2688</blockquote> 2689</div> 2690<p> </p> 2691 2692<DIV CLASS="refentry"> 2693<DIV CLASS="refnamediv"><b><i>[global] socket address = IP address</i></b> 2694<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2695<DIV CLASS="refsynopsisdiv"> 2696<P CLASS="para">Allowable values: IP address</p> 2697 2698<P CLASS="para"> 2699Sets address on which to listen for connections. Default is to listen to all addresses. Used to support multiple virtual interfaces on one server. Highly discouraged. </p> 2700</div> 2701</blockquote> 2702</div> 2703<p> </p> 2704 2705<DIV CLASS="refentry"> 2706<DIV CLASS="refnamediv"><b><i>[global] socket options = socket option list</i></b> 2707<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2708<DIV CLASS="refsynopsisdiv"> 2709<P CLASS="para">Allowable values: list</p> 2710 2711<P CLASS="para"> 2712Sets OS-specific socket options. <CODE CLASS="literal"> 2713SO_KEEPALIVE</code> has TCP check clients every 4 hours to see if they are still accessible. <CODE CLASS="literal"> 2714TCP_NODELAY</code> sends even tiny packets to keep delay low. Recommended wherever the operating system supports them. See <a href="appb_01.html"><b>Appendix B, <CITE CLASS="appendix">Samba Performance Tuning</cite></b></a>, for more information.</p> 2715</div> 2716</blockquote> 2717</div> 2718<p> </p> 2719 2720<!-- 2.0.7, davecb --> 2721 2722<DIV CLASS="refentry"> 2723<DIV CLASS="refnamediv"><b><i>[global] source environment = string</i></b> 2724<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2725<DIV CLASS="refsynopsisdiv"> 2726<P CLASS="para">Allowable values: pathname</p> 2727 2728<P CLASS="para"> 2729This pathname parameter causes Samba to read a list of environment 2730variables from a named file on startup. This can be useful in setting 2731up Samba in a clustered environment. This is new in 2.0.7.</p> 2732 2733<p> The file must be owned by root and not be world writable, 2734and if the filename begins with a "|" (pipe) character, it must point to 2735a command which is neither world writable nor resides 2736in a world writable directory.</p> 2737 2738<p> The data should be in the form of lines such as 2739<CODE CLASS="literal">SAMBA_NETBIOS_NAME=myhostname</CODE>. 2740This variable will then be available in the smb.conf files as $%SAMBA_NETBIOS_NAME.</p> 2741 2742</div> 2743</blockquote> 2744</div> 2745<p> </p> 2746<!-- end of 2.0.7 --> 2747 2748<DIV CLASS="refentry"> 2749<DIV CLASS="refnamediv"><b><i>[global] status = boolean</i></b> 2750<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 2751<DIV CLASS="refsynopsisdiv"> 2752<P CLASS="para">Allowable values: YES, NO</p> 2753 2754<P CLASS="para"> 2755If YES, logs connections to a file (or shared memory) accessible to <I CLASS="filename"> 2756smbstatus</i>.</p> 2757</div> 2758</blockquote> 2759</div> 2760<p> </p> 2761 2762<DIV CLASS="refentry"> 2763<DIV CLASS="refnamediv"><b><i>strict sync = boolean</i></b> 2764<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2765<DIV CLASS="refsynopsisdiv"> 2766<P CLASS="para">Allowable values: YES, NO</p> 2767 2768<P CLASS="para"> 2769If set to YES, Samba will synchronize to disk whenever the client sets the sync bit in a packet. If set to NO, Samba flushes data to disk whenever buffers fill. Defaults to NO because Windows 98 Explorer sets the bit (incorrectly) in all packets. Introduced in Samba 1.9.18p10.</p> 2770</div> 2771</blockquote> 2772</div> 2773<p> </p> 2774 2775<DIV CLASS="refentry"> 2776<DIV CLASS="refnamediv"><b><i>strict locking = boolean</i></b> 2777<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2778<DIV CLASS="refsynopsisdiv"> 2779<P CLASS="para">Allowable values: YES, NO</p> 2780 2781<P CLASS="para"> 2782If set to YES, Samba checks locks on every access, not just on demand and at open time. Not recommended.</p> 2783</div> 2784</blockquote> 2785</div> 2786<p> </p> 2787 2788<DIV CLASS="refentry"> 2789<DIV CLASS="refnamediv"><b><i>[global] strip dot = boolean</i></b> 2790<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2791<DIV CLASS="refsynopsisdiv"> 2792<P CLASS="para">Allowable values: YES, NO</p> 2793 2794<P CLASS="para"> 2795Removes trailing dots from filenames. Use <CODE CLASS="literal"> 2796mangled map</code> instead.</p> 2797</div> 2798</blockquote> 2799</div> 2800<p> </p> 2801 2802<DIV CLASS="refentry"> 2803<DIV CLASS="refnamediv"><b><i>[global] syslog = number</i></b> 2804<P CLASS="refpurpose">Default: 1</p></div><BLOCKQUOTE> 2805<DIV CLASS="refsynopsisdiv"> 2806<P CLASS="para">Allowable values: number</p> 2807 2808<P CLASS="para"> 2809Sets number of Samba log messages to send to <I CLASS="filename"> 2810syslog</i>. Higher is more verbose. The <I CLASS="filename"> 2811syslog.conf</i> file must have suitable logging enabled.</p> 2812</div> 2813</blockquote> 2814</div> 2815<p> </p> 2816 2817<DIV CLASS="refentry"> 2818<DIV CLASS="refnamediv"><b><i>[global] syslog only = boolean</i></b> 2819<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2820<DIV CLASS="refsynopsisdiv"> 2821<P CLASS="para">Allowable values: YES, NO</p> 2822 2823<P CLASS="para"> 2824If set to YES, log only to <EM CLASS="emphasis"> 2825syslog, </em>not standard Samba log files.</p> 2826</div> 2827</blockquote> 2828</div> 2829<p> </p> 2830 2831<DIV CLASS="refentry"> 2832<DIV CLASS="refnamediv"><b><i>sync always = boolean</i></b> 2833<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2834<DIV CLASS="refsynopsisdiv"> 2835<P CLASS="para">Allowable values: YES, NO</p> 2836 2837<P CLASS="para"> 2838If set to YES, Samba calls<EM CLASS="emphasis"> 2839 fsync</em>(3) after every write. Avoid except for debugging crashing servers.</p> 2840</div> 2841</blockquote> 2842</div> 2843<p> </p> 2844 2845<DIV CLASS="refentry"> 2846<DIV CLASS="refnamediv"><b><i>[global] time offset = minutes</i></b> 2847<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 2848<DIV CLASS="refsynopsisdiv"> 2849<P CLASS="para">Allowable values: minutes</p> 2850 2851<P CLASS="para"> 2852Sets number of minutes to add to system time zone calculation. Provided to fix a client daylight-savings bug; not recommended.</p> 2853</div> 2854</blockquote> 2855</div> 2856<p> </p> 2857 2858<DIV CLASS="refentry"> 2859<DIV CLASS="refnamediv"><b><i>[global] time server = boolean</i></b> 2860<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2861<DIV CLASS="refsynopsisdiv"> 2862<P CLASS="para">Allowable values: YES, NO</p> 2863 2864<P CLASS="para"> 2865If YES, <EM CLASS="emphasis"> 2866nmbd</em> will provide time service to its clients.</p> 2867</div> 2868</blockquote> 2869</div> 2870<p> </p> 2871 2872<DIV CLASS="refentry"> 2873<DIV CLASS="refnamediv"><b><i>unix password sync = boolean</i></b> 2874<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2875<DIV CLASS="refsynopsisdiv"> 2876<P CLASS="para">Allowable values: YES, NO</p> 2877 2878<P CLASS="para"> 2879If set, will attempt to change the user's Unix password whenever the user changes his or her SMB password. Used to ease synchronization of Unix and Microsoft password databases. Added in Samba 1.9.18p4. See also <CODE CLASS="literal"> 2880passwd chat</code>.</p> 2881</div> 2882</blockquote> 2883</div> 2884<p> </p> 2885 2886<DIV CLASS="refentry"> 2887<DIV CLASS="refnamediv"><b><i>unix realname = boolean</i></b> 2888<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2889<DIV CLASS="refsynopsisdiv"> 2890<P CLASS="para">Allowable values: YES, NO</p> 2891 2892<P CLASS="para"> 2893If set, will provide the GCOS field of <I CLASS="filename"> 2894/etc/passwd</i> to the client as the user's full name.</p> 2895</div> 2896</blockquote> 2897</div> 2898<p> </p> 2899 2900<DIV CLASS="refentry"> 2901<DIV CLASS="refnamediv"><b><i>update encrypted = boolean</i></b> 2902<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2903<DIV CLASS="refsynopsisdiv"> 2904<P CLASS="para">Allowable values: YES, NO</p> 2905 2906<P CLASS="para"> 2907Updates the Microsoft-format password file when a user logs in with unencrypted passwords. Provided to ease conversion to encryped passwords for Windows 95/98 and NT. Added in Samba 1.9.18p5.</p> 2908</div> 2909</blockquote> 2910</div> 2911<p> </p> 2912 2913<DIV CLASS="refentry"> 2914<DIV CLASS="refnamediv"><b><i>user = comma-separated list</i></b> 2915<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2916<DIV CLASS="refsynopsisdiv"> 2917<P CLASS="para">Allowable values: comma-separated list of user names</p> 2918 2919<P CLASS="para"> 2920Synonym for <CODE CLASS="literal"> 2921username</code>.</p> 2922</div> 2923</blockquote> 2924</div> 2925<p> </p> 2926 2927<DIV CLASS="refentry"> 2928<DIV CLASS="refnamediv"><b><i>username = comma-separated list</i></b> 2929<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2930<DIV CLASS="refsynopsisdiv"> 2931<P CLASS="para">Allowable values: comma-separated list of user names</p> 2932 2933<P CLASS="para"> 2934Sets a list of users to try to log in as for a share or shares with share-level security. Synonyms are <CODE CLASS="literal"> 2935user</code> and <CODE CLASS="literal"> 2936users</code>. Discouraged. Use <CODE CLASS="literal"> 2937NET USE \\</code><CODE CLASS="replaceable"><I>server</i></code><CODE CLASS="literal">\</code><CODE CLASS="replaceable"><I>share </i></code><CODE CLASS="literal">%</code><CODE CLASS="replaceable"><I>user</i></code> from the client instead.</p> 2938</div> 2939</blockquote> 2940</div> 2941<p> </p> 2942 2943<DIV CLASS="refentry"> 2944<DIV CLASS="refnamediv"><b><i>username level = number</i></b> 2945<P CLASS="refpurpose">Default: 0</p></div><BLOCKQUOTE> 2946<DIV CLASS="refsynopsisdiv"> 2947<P CLASS="para">Allowable values: number</p> 2948 2949<P CLASS="para"> 2950Number of uppercase letter permutations allowed to match Unix usernames. Workaround for Windows feature (single-case usernames). Use is discouraged.</p> 2951</div> 2952</blockquote> 2953</div> 2954<p> </p> 2955 2956<DIV CLASS="refentry"> 2957<DIV CLASS="refnamediv"><b><i>[global] username map = pathname</i></b> 2958<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2959<DIV CLASS="refsynopsisdiv"> 2960<P CLASS="para">Allowable values: pathname</p> 2961 2962<P CLASS="para"> 2963Names a file of Unix-to-Windows name pairs; used to map different spellings of account names and those Windows usernames longer than eight characters.</p> 2964</div> 2965</blockquote> 2966</div> 2967<p> </p> 2968 2969<!-- 2.0.7 --> 2970<DIV CLASS="refentry"> 2971<DIV CLASS="refnamediv"><b><i>[global] utmp = boolean</i></b> 2972<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 2973<DIV CLASS="refsynopsisdiv"> 2974<P CLASS="para">Allowable values: YES, NO</p> 2975 2976<P CLASS="para"> 2977This is available if Samba has been configured with the option 2978<CODE CLASS="literal"> --with-utmp</CODE>. 2979If set, Samba will add utmp/utmpx records whenever a 2980connection is made to a Samba server. New in 2.0.7, sites may use this 2981to record the user connecting to a Samba share. 2982</p> 2983</div> 2984</blockquote> 2985</div> 2986<p> </p> 2987 2988 2989<DIV CLASS="refentry"> 2990<DIV CLASS="refnamediv"><b><i>[global] utmp directory = string</i></b> 2991<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 2992<DIV CLASS="refsynopsisdiv"> 2993<P CLASS="para">Allowable values: pathname</p> 2994 2995<P CLASS="para"> 2996This is available if Samba has been configured with the option 2997<CODE CLASS="literal">--with-utmp</CODE>. If it and <CODE CLASS="literal"> 2998utmp </CODE> are set, Samba will look in the specified directory 2999insteqad of the default system directory for utmp/utmpx files. 3000New in 2.0.7, also called <CODE CLASS="literal"> utmp dir</CODE>. 3001</p> 3002</div> 3003</blockquote> 3004</div> 3005<p> </p> 3006<!-- end of 2.0.7 -> 3007 3008<DIV CLASS="refentry"> 3009<DIV CLASS="refnamediv"><b><i>valid chars = list</i></b> 3010<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 3011<DIV CLASS="refsynopsisdiv"> 3012<P CLASS="para">Allowable values: list of numeric values</p> 3013 3014<P CLASS="para"> 3015Semi-obsolete. Adds national characters to a character set map. Overridden by <CODE CLASS="literal"> 3016client code page</code>. </p> 3017</div> 3018</blockquote> 3019</div> 3020<p> </p> 3021 3022<DIV CLASS="refentry"> 3023<DIV CLASS="refnamediv"><b><i>valid users = user list</i></b> 3024<P CLASS="refpurpose">Default: NULL (everyone)</p></div><BLOCKQUOTE> 3025<DIV CLASS="refsynopsisdiv"> 3026<P CLASS="para">Allowable values: list of users</p> 3027 3028<P CLASS="para"> 3029List of users that can log in to a share. </p> 3030</div> 3031</blockquote> 3032</div> 3033<p> </p> 3034 3035<DIV CLASS="refentry"> 3036<DIV CLASS="refnamediv"><b><i>veto files = slash-list</i></b> 3037<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 3038<DIV CLASS="refsynopsisdiv"> 3039<P CLASS="para">Allowable values: slash-separated list of filenames</p> 3040 3041<P CLASS="para"> 3042List of files not to allow the client to see when listing a directory's contents. See also <CODE CLASS="literal"> 3043delete veto files</code>.</p> 3044</div> 3045</blockquote> 3046</div> 3047<p> </p> 3048 3049<DIV CLASS="refentry"> 3050<DIV CLASS="refnamediv"><b><i>veto oplock files = slash-list</i></b> 3051<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 3052<DIV CLASS="refsynopsisdiv"> 3053<P CLASS="para">Allowable values: slash-separated list of filenames</p> 3054 3055<P CLASS="para"> 3056List of files not to oplock (and cache on clients). See also <CODE CLASS="literal"> 3057oplocks</code> and <CODE CLASS="literal"> 3058fake oplocks</code>.</p> 3059</div> 3060</blockquote> 3061</div> 3062<p> </p> 3063 3064<DIV CLASS="refentry"> 3065<DIV CLASS="refnamediv"><b><i>volume = share name</i></b> 3066<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 3067<DIV CLASS="refsynopsisdiv"> 3068<P CLASS="para">Allowable values: string</p> 3069 3070<P CLASS="para"> 3071Sets the volume label of a disk share, notably a CD-ROM.</p> 3072</div> 3073</blockquote> 3074</div> 3075<p> </p> 3076 3077<DIV CLASS="refentry"> 3078<DIV CLASS="refnamediv"><b><i>wide links = boolean</i></b> 3079<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 3080<DIV CLASS="refsynopsisdiv"> 3081<P CLASS="para">Allowable values: YES, NO</p> 3082 3083<P CLASS="para"> 3084If set to YES, Samba will follow symlinks out of the current disk share(s). See also the <CODE CLASS="literal"> 3085root dir</code> and <CODE CLASS="literal"> 3086follow symlinks</code> options.</p> 3087</div> 3088</blockquote> 3089</div> 3090<p> </p> 3091 3092<DIV CLASS="refentry"> 3093<DIV CLASS="refnamediv"><b><i>[global] wins proxy = boolean</i></b> 3094<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 3095<DIV CLASS="refsynopsisdiv"> 3096<P CLASS="para">Allowable values: YES, NO</p> 3097 3098<P CLASS="para"> 3099If set to YES, <EM CLASS="emphasis"> 3100nmbd</em> will proxy resolution requests to WINS servers on behalf of old clients, which use broadcasts. WINS server is typically on another subnet.</p> 3101</div> 3102</blockquote> 3103</div> 3104<p> </p> 3105 3106<DIV CLASS="refentry"> 3107<DIV CLASS="refnamediv"><b><i>[global] wins server = host</i></b> 3108<P CLASS="refpurpose">Default: NULL</p></div><BLOCKQUOTE> 3109<DIV CLASS="refsynopsisdiv"> 3110<P CLASS="para">Allowable values: hostname</p> 3111 3112<P CLASS="para"> 3113Sets the DNS name or IP address of the WINS server.</p> 3114</div> 3115</blockquote> 3116</div> 3117<p> </p> 3118 3119<DIV CLASS="refentry"> 3120<DIV CLASS="refnamediv"><b><i>[global] wins support = boolean</i></b> 3121<P CLASS="refpurpose">Default: NO</p></div><BLOCKQUOTE> 3122<DIV CLASS="refsynopsisdiv"> 3123<P CLASS="para">Allowable values: YES, NO</p> 3124 3125<P CLASS="para"> 3126If set to YES, Samba activates WINS service. The <CODE CLASS="literal"> 3127wins server</code> option must not be set if <CODE CLASS="literal"> 3128wins support = yes</code>.</p> 3129</div> 3130</blockquote> 3131</div> 3132<p> </p> 3133 3134<DIV CLASS="refentry"> 3135<DIV CLASS="refnamediv"><b><i>[global] workgroup = name</i></b> 3136<P CLASS="refpurpose">Default: compiled-in</p></div><BLOCKQUOTE> 3137<DIV CLASS="refsynopsisdiv"> 3138<P CLASS="para">Allowable values: workgroup name</p> 3139 3140<P CLASS="para"> 3141Sets the workgroup to which things will be served. Overrides compiled-in value. Choosing a name other than <CODE CLASS="literal"> 3142WORKGROUP</code> is strongly recommended.</p> 3143</div> 3144</blockquote> 3145</div> 3146<p> </p> 3147 3148<DIV CLASS="refentry"> 3149<DIV CLASS="refnamediv"><b><i>writable = boolean</i></b> 3150<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 3151<DIV CLASS="refsynopsisdiv"> 3152<P CLASS="para">Allowable values: YES, NO</p> 3153 3154<P CLASS="para"> 3155Antonym for <CODE CLASS="literal"> 3156read only</code>; synonym of <CODE CLASS="literal"> 3157write ok</code>.</p> 3158</div> 3159</blockquote> 3160</div> 3161<p> </p> 3162 3163<DIV CLASS="refentry"> 3164<DIV CLASS="refnamediv"><b><i>write list = comma-separated list</i></b> 3165<P CLASS="refpurpose">Default: NULL (everyone)</p></div><BLOCKQUOTE> 3166<DIV CLASS="refsynopsisdiv"> 3167<P CLASS="para">Allowable values: comma-separated list of users</p> 3168 3169<P CLASS="para"> 3170List of users that are given read-write access to a read-only share. See also <CODE CLASS="literal"> 3171read list</code>.</p> 3172</div> 3173</blockquote> 3174</div> 3175<p> </p> 3176 3177<!-- 2.0.7 addendum, davecb --> 3178<DIV CLASS="refentry"> 3179<DIV CLASS="refnamediv"><b><i>write cache size = decimal number</i></b> 3180<P CLASS="refpurpose">Default: 0 (Disabled)</p></div><BLOCKQUOTE> 3181<DIV CLASS="refsynopsisdiv"> 3182<P CLASS="para">Allowable values: decimal number of bytes</p> 3183 3184<P CLASS="para"> 3185Sets the size of a write buffer that Samba uses to pre-accumulate 3186write into, so as to write with a particular size that's optimal for 3187a given filesystem. Typically this is used with RAID drives, which 3188have a preferred write size, systems with large memory and slow disks, etc.</p> 3189 3190<p> As of Samba 2.0.7, this applies to the first 10 oplocked files, 3191which are also found in shares where this option is set. 3192</p> 3193</div> 3194</blockquote> 3195</div> 3196<p> </p> 3197<!-- end of 2.0.7 addendum --> 3198 3199<DIV CLASS="refentry"> 3200<DIV CLASS="refnamediv"><b><i>write ok = boolean</i></b> 3201<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 3202<DIV CLASS="refsynopsisdiv"> 3203<P CLASS="para">Allowable values: YES, NO</p> 3204 3205<P CLASS="para"> 3206Synonym of the <CODE CLASS="literal"> 3207writable</code> configuration option.</p> 3208</div> 3209</blockquote> 3210</div> 3211<p> </p> 3212 3213<DIV CLASS="refentry"> 3214<DIV CLASS="refnamediv"><b><i>[global] write raw = boolean</i></b> 3215<P CLASS="refpurpose">Default: YES</p></div><BLOCKQUOTE> 3216<DIV CLASS="refsynopsisdiv"> 3217<P CLASS="para">Allowable values: YES, NO</p> 3218 3219<P CLASS="para"> 3220Allows fast streaming writes over TCP, using 64KB buffers. Recommended.</p> 3221</div> 3222</blockquote> 3223 3224<DIV CLASS="refsect1"><h2>Glossary of Configuration Values</h2> 3225<DL CLASS="variablelist"> 3226<DT CLASS="term">Address list</dt><DD CLASS="listitem"> 3227<P CLASS="para"> 3228A space-separated list of IP addresses in ###.###.###.### format.</p></dd><DT CLASS="term"> 3229Comma-separated list</dt><DD CLASS="listitem"> 3230<P CLASS="para"> 3231A list of items separated by commas.</p></dd><DT CLASS="term"> 3232Command</dt><DD CLASS="listitem"> 3233<P CLASS="para"> 3234A Unix command, with full path and parameters.</p></dd><DT CLASS="term"> 3235Host list</dt><DD CLASS="listitem"> 3236<P CLASS="para"> 3237A space-separated list of hosts. Allows IP addresses, address masks, domain names, ALL, and EXCEPT</p></dd><DT CLASS="term"> 3238Interface list</dt><DD CLASS="listitem"> 3239<P CLASS="para"> 3240A space-separated list of interfaces, in either address/netmask or address/n-bits format. For example, 192.168.2.10/24 or 192.168.2.10/255.255.255.0</p></dd><DT CLASS="term"> 3241Map list</dt><DD CLASS="listitem"> 3242<P CLASS="para"> 3243A space-separated list of file-remapping strings such as <CODE CLASS="literal"> 3244(*.html</code> <CODE CLASS="literal"> 3245*.htm)</code>.</p></dd><DT CLASS="term"> 3246Remote list</dt><DD CLASS="listitem"> 3247<P CLASS="para"> 3248A space-separated list of subnet-broadcast-address/workgroup pairs. For example, 192.168.2.255/SERVERS 192.168.4.255/STAFF.</p></dd><DT CLASS="term"> 3249Service (share) list</dt><DD CLASS="listitem"> 3250<P CLASS="para"> 3251A space-separated list of share names, without the enclosing square brackets.</p></dd><DT CLASS="term"> 3252Slash-list</dt><DD CLASS="listitem"> 3253<P CLASS="para"> 3254A list of filenames, separated by "/" characters to allow embedded spaces. For example, <CODE CLASS="literal"> 3255/.*/fred</code> <CODE CLASS="literal"> 3256flintstone/*.frk/</code>.</p></dd><DT CLASS="term"> 3257Text</dt><DD CLASS="listitem"> 3258<P CLASS="para"> 3259One line of text. </p></dd><DT CLASS="term"> 3260User list</dt><DD CLASS="listitem"> 3261<P CLASS="para"> 3262A space-separated list of usernames. In Samba 1.9, <CODE CLASS="literal"> 3263@group-name</code> will include everyone in Unix group <CODE CLASS="literal"> 3264group-name</code>. In Samba 2.0, <CODE CLASS="literal"> 3265@group-name</code> includes whomever is in the NIS netgroup <CODE CLASS="literal"> 3266group_name</code> if one exists, otherwise whomever is in the Unix group <CODE CLASS="literal"> 3267group_name</code>. In addition, +<CODE CLASS="literal"> 3268group_name</code> is a Unix group, &<CODE CLASS="literal"> 3269group_name</code> is an NIS netgroup, and &+ and +& cause an ordered search of both Unix and NIS groups.</p></dd></dl></div> 3270<DIV CLASS="refsect1"> 3271<h2>Configuration File Variables</h2> 3272<P CLASS="para"> 3273<A CLASS="xref" HREF="appc_01.html#appc-88529"> 3274Table C.1</a> lists of Samba configuration file variables. </p><br> 3275<TABLE CLASS="table" BORDER="1" CELLPADDING="3"> 3276<CAPTION CLASS="table"> 3277<A CLASS="title" NAME="appc-88529"> 3278Table C.1: Variables in Alphabetic Order </a></caption><THEAD CLASS="thead"> 3279<TR CLASS="row" VALIGN="TOP"> 3280<TH CLASS="entry" ALIGN="LEFT" ROWSPAN="1" COLSPAN="1"> 3281<P CLASS="para"> 3282Name</p></th><TH CLASS="entry" ALIGN="LEFT" ROWSPAN="1" COLSPAN="1"> 3283<P CLASS="para"> 3284Meaning</p></th></tr></thead><TBODY CLASS="tbody"> 3285<TR CLASS="row" VALIGN="TOP"> 3286<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3287<P CLASS="para"> 3288<CODE CLASS="literal"> 3289%a</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3290<P CLASS="para"> 3291Client's architecture (one of Samba, WfWg, WinNT, Win95, or UNKNOWN)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3292<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3293<P CLASS="para"> 3294<CODE CLASS="literal"> 3295%d</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3296<P CLASS="para"> 3297Current server process's processID </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3298<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3299<P CLASS="para"> 3300<CODE CLASS="literal"> 3301%f</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3302<P CLASS="para"> 3303Print-spool file as a relative path (printing only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3304<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3305<P CLASS="para"> 3306<CODE CLASS="literal"> 3307%f</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3308<P CLASS="para"> 3309User from which a message was sent (messages only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3310<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3311<P CLASS="para"> 3312<CODE CLASS="literal"> 3313%G</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3314<P CLASS="para"> 3315Primary group name of <CODE CLASS="literal"> 3316%U</code> (requested username) </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3317<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3318<P CLASS="para"> 3319<CODE CLASS="literal"> 3320%g</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3321<P CLASS="para"> 3322Primary group name of <CODE CLASS="literal"> 3323%u</code> (actual username)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3324<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3325<P CLASS="para"> 3326<CODE CLASS="literal"> 3327%H</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3328<P CLASS="para"> 3329Home directory of <CODE CLASS="literal"> 3330%u</code> (actual username)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3331<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3332<P CLASS="para"> 3333<CODE CLASS="literal"> 3334%h</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3335<P CLASS="para"> 3336Samba server's (Internet) hostname</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3337<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3338<P CLASS="para"> 3339<CODE CLASS="literal"> 3340%I</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3341<P CLASS="para"> 3342Client's IP address </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3343<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3344<P CLASS="para"> 3345<CODE CLASS="literal"> 3346%j</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3347<P CLASS="para"> 3348Print job number (printing only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3349<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3350<P CLASS="para"> 3351<CODE CLASS="literal"> 3352%L</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3353<P CLASS="para"> 3354Samba server's NetBIOS name (virtual servers have multiple names)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3355<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3356<P CLASS="para"> 3357<CODE CLASS="literal"> 3358%M</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3359<P CLASS="para"> 3360Client's (Internet) hostname </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3361<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3362<P CLASS="para"> 3363<CODE CLASS="literal"> 3364%m</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3365<P CLASS="para"> 3366Client's NetBIOS name </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3367<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3368<P CLASS="para"> 3369<CODE CLASS="literal"> 3370%n</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3371<P CLASS="para"> 3372New password (password change only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3373<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3374<P CLASS="para"> 3375<CODE CLASS="literal"> 3376%N</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3377<P CLASS="para"> 3378Name of the NIS home directory server (without NIS, same as <CODE CLASS="literal"> 3379%L</code>)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3380<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3381<P CLASS="para"> 3382<CODE CLASS="literal"> 3383%o</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3384<P CLASS="para"> 3385Old password (password change only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3386<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3387<P CLASS="para"> 3388<CODE CLASS="literal"> 3389%P</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3390<P CLASS="para"> 3391Current share's root directory (actual)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3392<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3393<P CLASS="para"> 3394<CODE CLASS="literal"> 3395%p</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3396<P CLASS="para"> 3397Current share's root directory (in an NIS homedir map)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3398<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3399<P CLASS="para"> 3400<CODE CLASS="literal"> 3401%p</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3402<P CLASS="para"> 3403Print filename (printing only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3404<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3405<P CLASS="para"> 3406<CODE CLASS="literal"> 3407%R</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3408<P CLASS="para"> 3409Protocol level in use (one of CORE, COREPLUS, LANMAN1, LANMAN2, or NT1)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3410<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3411<P CLASS="para"> 3412<CODE CLASS="literal"> 3413%S</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3414<P CLASS="para"> 3415Current share's name </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3416<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3417<P CLASS="para"> 3418<CODE CLASS="literal"> 3419%s</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3420<P CLASS="para"> 3421Filename the message is in (messages only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3422<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3423<P CLASS="para"> 3424<CODE CLASS="literal"> 3425%s</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3426<P CLASS="para"> 3427Print-spool file name (printing only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3428<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3429<P CLASS="para"> 3430<CODE CLASS="literal"> 3431%T</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3432<P CLASS="para"> 3433Current date and time </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3434<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3435<P CLASS="para"> 3436<CODE CLASS="literal"> 3437%t</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3438<P CLASS="para"> 3439Destination machine (messages only)</p></td></tr><TR CLASS="row" VALIGN="TOP"> 3440<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3441<P CLASS="para"> 3442<CODE CLASS="literal"> 3443%u</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3444<P CLASS="para"> 3445Current share's username </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3446<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3447<P CLASS="para"> 3448<CODE CLASS="literal"> 3449%U</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3450<P CLASS="para"> 3451Requested username for current share </p></td></tr><TR CLASS="row" VALIGN="TOP"> 3452<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3453<P CLASS="para"> 3454<CODE CLASS="literal"> 3455%v</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 3456<P CLASS="para"> 3457Samba version</p></td></tr></tbody></table></div></blockquote></div></div></blockquote> 3458<div> 3459<center> 3460<hr noshade size=1><TABLE WIDTH="515" BORDER="0" CELLSPACING="0" CELLPADDING="0"> 3461<TR> 3462<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="172"> 3463<A CLASS="sect1" HREF="appb_03.html" TITLE="B.3 Sizing Samba Servers"> 3464<IMG SRC="gifs/txtpreva.gif" ALT="Previous: B.3 Sizing Samba Servers" BORDER="0"></a></td><TD ALIGN="CENTER" VALIGN="TOP" WIDTH="171"> 3465<A CLASS="book" HREF="index.html" TITLE=""> 3466<IMG SRC="gifs/txthome.gif" ALT="" BORDER="0"></a></td><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="172"> 3467<A CLASS="appendix" HREF="appd_01.html" TITLE="D. Summary of Samba Daemons and Commands"> 3468<IMG SRC="gifs/txtnexta.gif" ALT="Next: D. Summary of Samba Daemons and Commands" BORDER="0"></a></td></tr><TR> 3469<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="172"> 3470B.3 Sizing Samba Servers</td><TD ALIGN="CENTER" VALIGN="TOP" WIDTH="171"> 3471<A CLASS="index" HREF="inx.html" TITLE="Book Index"> 3472<IMG SRC="gifs/index.gif" ALT="Book Index" BORDER="0"></a></td><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="172"> 3473D. Summary of Samba Daemons and Commands</td></tr></table><hr noshade size=1></center> 3474</div> 3475 3476<!-- End of sample chapter --> 3477<CENTER> 3478<FONT SIZE="1" FACE="Verdana, Arial, Helvetica"> 3479<A HREF="http://www.oreilly.com/"> 3480<B>O'Reilly Home</B></A> <B> | </B> 3481<A HREF="http://www.oreilly.com/sales/bookstores"> 3482<B>O'Reilly Bookstores</B></A> <B> | </B> 3483<A HREF="http://www.oreilly.com/order_new/"> 3484<B>How to Order</B></A> <B> | </B> 3485<A HREF="http://www.oreilly.com/oreilly/contact.html"> 3486<B>O'Reilly Contacts<BR></B></A> 3487<A HREF="http://www.oreilly.com/international/"> 3488<B>International</B></A> <B> | </B> 3489<A HREF="http://www.oreilly.com/oreilly/about.html"> 3490<B>About O'Reilly</B></A> <B> | </B> 3491<A HREF="http://www.oreilly.com/affiliates.html"> 3492<B>Affiliated Companies</B></A><p> 3493<EM>© 1999, O'Reilly & Associates, Inc.</EM> 3494</FONT> 3495</CENTER> 3496</BODY> 3497</html> 3498