1<HTML> 2<HEAD> 3<TITLE> 4[Chapter 8] 8.5 Recently Added Options</title><META NAME="DC.title" CONTENT=""><META NAME="DC.creator" CONTENT=""><META NAME="DC.publisher" CONTENT="O'Reilly & Associates, Inc."><META NAME="DC.date" CONTENT="1999-11-05T21:35:55Z"><META NAME="DC.type" CONTENT="Text.Monograph"><META NAME="DC.format" CONTENT="text/html" SCHEME="MIME"><META NAME="DC.source" CONTENT="" SCHEME="ISBN"><META NAME="DC.language" CONTENT="en-US"><META NAME="generator" CONTENT="Jade 1.1/O'Reilly DocBook 3.0 to HTML 4.0"></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="ch08_04.html" TITLE="8.4 WinPopup Messages"> 35<IMG SRC="gifs/txtpreva.gif" ALT="Previous: 8.4 WinPopup Messages" BORDER="0"></a></td><TD ALIGN="CENTER" VALIGN="TOP" WIDTH="171"> 36<B> 37<FONT FACE="ARIEL,HELVETICA,HELV,SANSERIF" SIZE="-1"> 38<A CLASS="chapter" REL="up" HREF="ch08_01.html" TITLE="8. Additional Samba Information "> 39Chapter 8<br> 40Additional Samba Information </a></font></b></td><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="172"> 41<A CLASS="sect1" HREF="ch08_06.html" TITLE="8.6 Miscellaneous Options"> 42<IMG SRC="gifs/txtnexta.gif" ALT="Next: 8.6 Miscellaneous Options" BORDER="0"></a></td></tr></table> <hr noshade size=1></center> 43</div> 44<blockquote> 45<div> 46<H2 CLASS="sect1"> 47<A CLASS="title" NAME="ch08-pgfId-958954"> 48 49<!-- 2.0.7 amendments begin, davecb --> 8.5 Recently Added 50Options</a></h2><P CLASS="para">Samba has several options that appeared 51around the time of Samba 2.0, but either were not entirely supported or were 52in the process of being developed. With Samba 2.0.7, several more were 53introduced. We will give you a brief overview of their workings in this 54section. These options are shown in <A CLASS="xref" 55HREF="ch08_05.html#ch08-72538"> 56<!-- end of first addition --> 57 58Table 8.9</a>. </p><br> 59<TABLE CLASS="table" BORDER="1" CELLPADDING="3"> 60<CAPTION CLASS="table"> 61<A CLASS="title" NAME="ch08-72538"> 62Table 8.9: Recently Added Options </a></caption><THEAD CLASS="thead"> 63<TR CLASS="row" VALIGN="TOP"> 64<TH CLASS="entry" ALIGN="LEFT" ROWSPAN="1" COLSPAN="1"> 65<P CLASS="para"> 66Option</p></th><TH CLASS="entry" ALIGN="LEFT" ROWSPAN="1" COLSPAN="1"> 67<P CLASS="para"> 68Parameters</p></th><TH CLASS="entry" ALIGN="LEFT" ROWSPAN="1" COLSPAN="1"> 69<P CLASS="para"> 70Function</p></th><TH CLASS="entry" ALIGN="LEFT" ROWSPAN="1" COLSPAN="1"> 71<P CLASS="para"> 72Default</p></th><TH CLASS="entry" ALIGN="LEFT" ROWSPAN="1" COLSPAN="1"> 73<P CLASS="para"> 74Scope</p></th></tr></thead><TBODY CLASS="tbody"> 75 76<TR CLASS="row" VALIGN="TOP"> 77<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 78<P CLASS="para"> 79<CODE CLASS="literal"> 80change notify timeout</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 81<P CLASS="para"> 82numerical (number of seconds)</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 83<P CLASS="para"> 84Sets the interval between checks when a client asks to wait for a change in a specified directory.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 85<P CLASS="para"> 86<CODE CLASS="literal"> 8760</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 88<P CLASS="para"> 89Global</p></td></tr> 90 91<TR CLASS="row" VALIGN="TOP"> 92<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 93<P CLASS="para"> 94<CODE CLASS="literal"> 95machine password timeout</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 96<P CLASS="para"> 97numerical (number of seconds)</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 98<P CLASS="para"> 99Sets the renewal interval for NT domain machine passwords.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 100<P CLASS="para"> 101<CODE CLASS="literal"> 102604,800</code> (1 week)</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 103<P CLASS="para"> 104Global</p></td></tr><TR CLASS="row" VALIGN="TOP"> 105<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 106<P CLASS="para"> 107<CODE CLASS="literal"> 108stat cache</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 109<P CLASS="para"> 110boolean</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 111<P CLASS="para"> 112If <CODE CLASS="literal"> 113yes</code>, Samba will cache recent name mappings.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 114<P CLASS="para"> 115<CODE CLASS="literal"> 116yes</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 117<P CLASS="para"> 118Global</p></td></tr><TR CLASS="row" VALIGN="TOP"> 119<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 120<P CLASS="para"> 121<CODE CLASS="literal"> 122stat cache size</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 123<P CLASS="para"> 124numerical</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 125<P CLASS="para"> 126Sets the size of the stat cache.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 127<P CLASS="para"> 128<CODE CLASS="literal"> 12950</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 130<P CLASS="para"> 131Global</p></td></tr> 132 133<!-- 2.0.7 table insertions begin --> 134<TR CLASS="row" VALIGN="TOP"> 135<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 136<P CLASS="para"> 137<CODE CLASS="literal"> 138utmp</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 139<P CLASS="para"> 140boolean</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 141<P CLASS="para"> 142Turns on logging of Samba users in the utmp file. Requires --with-utmp. </p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 143<P CLASS="para"> 144<CODE CLASS="literal"> 145no</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 146<P CLASS="para"> 147Share</p></td></tr> 148 149<TR CLASS="row" VALIGN="TOP"> 150<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 151<P CLASS="para"> 152<CODE CLASS="literal"> 153utmp dir</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 154<P CLASS="para"> 155string (pathname)</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 156<P CLASS="para"> 157Sets the directory where Samba expects to find the utmp/utmpx file.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 158<P CLASS="para"> 159<CODE CLASS="literal"> 160None</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 161<P CLASS="para"> 162Share</p></td></tr> 163 164<TR CLASS="row" VALIGN="TOP"> 165<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 166<P CLASS="para"> 167<CODE CLASS="literal"> 168inherit permissions</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 169<P CLASS="para"> 170boolean</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 171<P CLASS="para"> 172Sets the permissions of newly created directories to the same as their parent.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 173<P CLASS="para"> 174<CODE CLASS="literal"> 175no</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 176<P CLASS="para"> 177Share</p></td></tr> 178 179<TR CLASS="row" VALIGN="TOP"> 180<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 181<P CLASS="para"> 182<CODE CLASS="literal"> 183write cache size</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 184<P CLASS="para"> 185numerical (bytes)</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 186<P CLASS="para"> 187Sets the size of a write cache (buffer) used for oplocked files.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 188<P CLASS="para"> 189<CODE CLASS="literal"> 1900</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 191<P CLASS="para"> 192Share</p></td></tr> 193 194<TR CLASS="row" VALIGN="TOP"> 195<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 196<P CLASS="para"> 197<CODE CLASS="literal"> 198source environment</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 199<P CLASS="para"> 200string (pathname)</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 201<P CLASS="para"> 202Sets a file to read environment variable from.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 203<P CLASS="para"> 204<CODE CLASS="literal"> 205None</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 206<P CLASS="para"> 207Global</p></td></tr> 208 209<TR CLASS="row" VALIGN="TOP"> 210<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 211<P CLASS="para"> 212<CODE CLASS="literal"> 213min password length</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 214<P CLASS="para"> 215numerical (number of characters)</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 216<P CLASS="para"> 217Sets the minimum length of a new password which Samba will try to update the password file with .</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 218<P CLASS="para"> 219<CODE CLASS="literal"> 2205</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 221<P CLASS="para"> 222Global</p></td></tr> 223 224 225<TR CLASS="row" VALIGN="TOP"> 226<TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 227<P CLASS="para"> 228<CODE CLASS="literal"> 229netbios scope</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 230<P CLASS="para"> 231string</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 232<P CLASS="para"> 233Sets the NetBIOS scope.</p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 234<P CLASS="para"> 235<CODE CLASS="literal"> 236None</code></p></td><TD CLASS="entry" ROWSPAN="1" COLSPAN="1"> 237<P CLASS="para"> 238Global</p></td></tr> 239<!-- end of 2.0.7 insertions--> 240</tbody></table> 241 242<DIV CLASS="sect2"> 243<H3 CLASS="sect2"> 244<A CLASS="title" NAME="ch08-pgfId-959050"> 2458.5.1 change notify timeout</a></h3><P CLASS="para"> 246The <CODE CLASS="literal"> 247change</code> <CODE CLASS="literal"> 248notify</code> <CODE CLASS="literal"> 249timeout</code> global option emulates a Windows NT SMB feature called <I CLASS="firstterm"> 250change notification</i>. This allows a client to request that a Windows NT server periodically monitor a specific directory on a share for any changes. If any changes occur, the server will notify the client.</p><P CLASS="para"> 251As of version 2.0, Samba will perform this function for its clients. However, performing these checks too often can slow the server down considerably. This option sets the time period that Samba should wait between such checks. The default is one minute (60 seconds); however, you can use this option to specify an alternate time that Samba should wait between performing checks:</p><PRE CLASS="programlisting"> 252[global] 253 change notify timeout = 30</pre></div><DIV CLASS="sect2"> 254<H3 CLASS="sect2"> 255<A CLASS="title" NAME="ch08-pgfId-959054"> 2568.5.2 machine password timeout</a></h3><P CLASS="para"> 257The <CODE CLASS="literal"> 258machine</code> <CODE CLASS="literal"> 259password</code> <CODE CLASS="literal"> 260timeout</code> global option sets a retention period for NT domain machine passwords. The default is currently set to the same time period that Windows NT 4.0 uses: 604,800 seconds (one week). Samba will periodically attempt to change the <I CLASS="firstterm"> 261machine account password</i>, which is a password used specifically by another server to report changes to it. This option specifies the number of seconds that Samba should wait before attempting to change that password. The following example changes it to a single day, by specifying the following:</p><PRE CLASS="programlisting"> 262[global] 263 machine password timeout = 86400</pre></div><DIV CLASS="sect2"> 264<H3 CLASS="sect2"> 265<A CLASS="title" NAME="ch08-pgfId-959058"> 2668.5.3 stat cache</a></h3><P CLASS="para"> 267The <CODE CLASS="literal"> 268stat</code> <CODE CLASS="literal"> 269cache</code> global option turns on caching of recent case-insensitive name mappings. The default is <CODE CLASS="literal"> 270yes</code>. The Samba team recommends that you never change this parameter.</p></div><DIV CLASS="sect2"> 271<H3 CLASS="sect2"> 272<A CLASS="title" NAME="ch08-pgfId-959060"> 2738.5.4 stat cache size</a></h3><P CLASS="para">The <CODE CLASS="literal"> 274stat</code> <CODE CLASS="literal"> 275cache</code> <CODE CLASS="literal"> 276size</code> global option sets the size of the cache entries to be used for the <CODE CLASS="literal"> 277stat</code> <CODE CLASS="literal"> 278cache</code> option. The default here is 50. Again, the Samba team recommends that you never change this parameter.</p> 279 280=== 281 282<H3 CLASS="sect2"> <A CLASS="title" NAME="ch08-pgfId-959060-add1"> 2838.5.5 utmp</a></h3> 284<P CLASS="para">If you specified <CODE CLASS="literal"> 285--with-utmp </CODE> when configuring, this option will turn on utmp logging 286of users: they will appear in the utmp file and you will be able to see if 287they are on with <I>last(1)</I>. It defaults to <CODE 288CLASS="literal">no</code>.</p> 289 290<H3 CLASS="sect2"> <A CLASS="title" NAME="ch08-pgfId-959060-add2"> 2918.5.6 utmp dir</a></h3> 292<P CLASS="para"> 293If <CODE CLASS="literal">utmp</CODE> is set, the utmp dir option will change the directory Samba 294looks in for the utmp files. If it is not set, the default system 295location will be used.</p> 296 297<H3 CLASS="sect2"> <A CLASS="title" NAME="ch08-pgfId-959060-add3"> 2988.5.7 inherit permissions</a></h3> 299<P CLASS="para"> 300This option causes new files and directories to be created with 301the same permissions as the directory they're in. For example, 302subdirectories will inherit setgid bits from their parents. 303This option will override the <CODE CLASS="literal">create 304mask, directory mask, force create mode</CODE> and <CODE CLASS="literal"> 305force directory mode</CODE> options, but not the <CODE CLASS="literal"> 306map archive, map hidden</CODE> and <CODE CLASS="literal">map system</CODE> 307options. It will never set the <CODE CLASS="literal">setuid</CODE> bit. 308This option defaults to off.</p> 309 310<H3 CLASS="sect2"> <A CLASS="title" NAME="ch08-pgfId-959060-add4"> 3118.5.8 write cache size</a></h3> 312<P CLASS="para">The <CODE CLASS="literal">write cache size</code> 313share option sets the size of a cache used by Samba while 314writing oplocked files. The files will be written in <I>cachesize</I> 315blocks, so you can tune Samba's write size to the optimum size for 316your filesystem or RAID disk array.</p> 317 318<p>The caching applies to the first 10 files opened with oplocks if set, 319and defaults to zero (off) initially.</p> 320 321<p>As with all caching schemes, data that hasn't been written 322will be lost if the system crashes.</p> 323 324<H3 CLASS="sect2"> <A CLASS="title" NAME="ch08-pgfId-959060-add5"> 3258.5.9 source environment</a></h3> 326<P CLASS="para"> 327This options specifies a file of environment variables that Samba 328will read on startup. <!-- and when else? When an smb.conf is read? 329when a child server process is started? --> The variables set in this 330files can then be used in smb.conf files as $%<I>name</I>. For example, 331HOME=/home/sofia in the environment file could be used in a smb.conf 332file as "path = "$HOME"</p> 333 334<p>If the pathname begins with a "|" (pipe) symbol, Samba will attempt 335to run it and read its standard output.</p> 336 337<H3 CLASS="sect2"> <A CLASS="title" NAME="ch08-pgfId-959060-add6"> 3388.5.10 min password length</a></h3> 339<P CLASS="para">This option sets the minimum length, in characters, 340of a plain text password that Samba will accept when performing UNIX 341password changing. This is used to tell Samba about system-defined 342minimums, so it can return an appropriate error to the client.</p> 343 344 345<H3 CLASS="sect2"> <A CLASS="title" NAME="ch08-pgfId-959060-add1"> 3468.5.11 netbios scope</a></h3> 347<P CLASS="para"> 348This sets the NetBIOS scope that Samba will operate under: Samba 349will not communicate with any machine with a different scope. 350This should not be set unless every machine on your LAN also sets 351this value. It was a predecessor to workgroups, and the Samba 352team recommends against using it.</p> 353 354<!-- end of 2.0.7 additions. --> 355 356<div></div></div></blockquote> 357 358<center> 359<hr noshade size=1><TABLE WIDTH="515" BORDER="0" CELLSPACING="0" CELLPADDING="0"> 360<TR> 361<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="172"> 362<A CLASS="sect1" HREF="ch08_04.html" TITLE="8.4 WinPopup Messages"> 363<IMG SRC="gifs/txtpreva.gif" ALT="Previous: 8.4 WinPopup Messages" BORDER="0"></a></td><TD ALIGN="CENTER" VALIGN="TOP" WIDTH="171"> 364<A CLASS="book" HREF="index.html" TITLE=""> 365<IMG SRC="gifs/txthome.gif" ALT="" BORDER="0"></a></td><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="172"> 366<A CLASS="sect1" HREF="ch08_06.html" TITLE="8.6 Miscellaneous Options"> 367<IMG SRC="gifs/txtnexta.gif" ALT="Next: 8.6 Miscellaneous Options" BORDER="0"></a></td></tr><TR> 368<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="172"> 3698.4 WinPopup Messages</td><TD ALIGN="CENTER" VALIGN="TOP" WIDTH="171"> 370<A CLASS="index" HREF="inx.html" TITLE="Book Index"> 371<IMG SRC="gifs/index.gif" ALT="Book Index" BORDER="0"></a></td><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="172"> 3728.6 Miscellaneous Options</td></tr></table><hr noshade size=1></center> 373</div> 374 375<!-- End of sample chapter --> 376<CENTER> 377<FONT SIZE="1" FACE="Verdana, Arial, Helvetica"> 378<A HREF="http://www.oreilly.com/"> 379<B>O'Reilly Home</B></A> <B> | </B> 380<A HREF="http://www.oreilly.com/sales/bookstores"> 381<B>O'Reilly Bookstores</B></A> <B> | </B> 382<A HREF="http://www.oreilly.com/order_new/"> 383<B>How to Order</B></A> <B> | </B> 384<A HREF="http://www.oreilly.com/oreilly/contact.html"> 385<B>O'Reilly Contacts<BR></B></A> 386<A HREF="http://www.oreilly.com/international/"> 387<B>International</B></A> <B> | </B> 388<A HREF="http://www.oreilly.com/oreilly/about.html"> 389<B>About O'Reilly</B></A> <B> | </B> 390<A HREF="http://www.oreilly.com/affiliates.html"> 391<B>Affiliated Companies</B></A><p> 392<EM>© 1999, O'Reilly & Associates, Inc.</EM> 393</FONT> 394</CENTER> 395</BODY> 396</html> 397
