git.maemo.org Git - samba/blob - docs/htmldocs/using_samba/ch11.html

   1 <html>
   2 <body bgcolor="#ffffff">
   3
   4 <img src="samba2_xs.gif" border="0" alt=" " height="100" width="76"
   5 hspace="10" align="left" />
   6
   7 <h1 class="head0">Chapter 11. Additional Samba Information</h1>
   8
   9
  10 <p>This chapter wraps up our coverage of the
  11 <em class="filename">smb.conf</em> configuration file with some
  12 miscellaneous options that can perform a variety of tasks. We talk
  13 briefly about options for time synchronization, internationalization,
  14 messages, and common Windows bugs. For the most part, you will use
  15 these options only in isolated circumstances.</p>
  16
  17
  18
  19 <div class="sect1"><a name="samba2-CHP-11-SECT-1"/>
  20
  21 <h2 class="head1">Time Synchronization</h2>
  22
  23 <p>In a network of computers, the systems on the network must agree on
  24 the current time and also on what time files have been modified. One
  25 example of the importance of synchronization is the
  26 <a name="INDEX-1"/>roaming profiles we covered in
  27 <a href="ch04.html">Chapter 4</a>. It is vital for all clients accessing a
  28 roaming profile to agree on what time it is and which client last
  29 modified the user's profile.</p>
  30
  31 <p><a name="INDEX-2"/>Time synchronization can also be
  32 very important to programmers. A useful group of settings consists of
  33 the following options:</p>
  34
  35 <blockquote><pre class="code">[global]
  36     time server = yes
  37     dos filetimes = yes
  38     fake directory create times = yes
  39     dos filetime resolution = yes
  40     delete readonly = yes</pre></blockquote>
  41
  42 <p>If you set these options, Samba shares will provide compatibility of
  43 file-modification times that Visual C++, <em class="emphasis">nmake</em>,
  44 and other Microsoft programming tools require. Otherwise, PC
  45 <em class="emphasis">make</em> programs might think that all the files in
  46 a directory need to be recompiled every time. Obviously, this is not
  47 the behavior you want.</p>
  48
  49 <p>In <a href="ch04.html">Chapter 4</a>, we showed you how to create a logon
  50 script that used the <em class="emphasis">net
  51 time</em><a name="INDEX-3"/> command to synchronize
  52 clients' clocks automatically when they log on to
  53 the domain. If your network is configured as a workgroup rather than
  54 a domain, you can still make use of <em class="emphasis">net time</em> by
  55 placing the command:</p>
  56
  57 <blockquote><pre class="code">net time \\<em class="replaceable">sambaserver</em> /set /yes</pre></blockquote>
  58
  59 <p>in a startup script on each client that is run when the system boots.
  60 Samba always provides time service&mdash;regardless of whether it is
  61 running as a primary domain controller&mdash;or the
  62 <tt class="literal">time</tt> <tt class="literal">service</tt> configuration file
  63 parameter is set.</p>
  64
  65 <p>Assuming that domain users log on to the domain at least once per day
  66 and workgroup clients reboot frequently, the <em class="emphasis">net
  67 time</em> command can keep client systems'
  68 clocks fairly well synchronized. However, sometimes domain users stay
  69 logged on for longer periods, and workgroup clients can run for days
  70 between reboots. In the meantime, the systems'
  71 hardware clocks can wander enough to become a problem. It might be
  72 possible to work around this, depending on the version of Windows the
  73 client system is running. On Windows 98/Me, you can use the Task
  74 Scheduler to run the <em class="emphasis">net time</em> command at regular
  75 intervals. Likewise, on Windows 2000/XP you can use the MS-DOS
  76 <em class="emphasis">at</em> command. However, a better way to deal with
  77 this issue is to use Network Time Protocol, which we will discuss
  78 shortly.</p>
  79
  80 <p>Proper time synchronization is also important when operating in an
  81 Active Directory domain because Active Directory uses
  82 <a name="INDEX-4"/>Kerberos authentication.
  83 When a Kerberos domain controller creates an authentication ticket
  84 for a client, the time is encoded into the challenge-and-response
  85 exchanges between the client and domain controller. If the
  86 client's clock disagrees with the
  87 server's clock, authentication can fail.</p>
  88
  89 <p>To provide proper time synchronization in <a name="INDEX-5"/>Active Directory domains, Microsoft has
  90 adopted <a name="INDEX-6"/>Network Time Protocol (NTP), using the
  91 name Windows Time Service for its implementation. For further
  92 information, the Microsoft white paper entitled <em class="citetitle">The
  93 Windows Time Service</em> can be downloaded from <a href="http://www.microsoft.com">http://www.microsoft.com</a>.</p>
  94
  95 <p>The nice thing about this is that NTP is the standard method for
  96 synchronizing Unix hosts on a network, so you can synchronize all
  97 your Unix systems (including the Samba server) and Windows systems
  98 with the following method:</p>
  99
 100 <ol><li>
 101 <p>Run NTP on the Unix systems in your network. For more information on
 102 using NTP, refer to <a href="http://www.ntp.org">http://www.ntp.org</a>.</p>
 103 </li><li>
 104 <p>Use one of the Unix systems (such as the Samba host system) as an NTP
 105 server to serve Windows 2000/XP clients.</p>
 106 </li><li>
 107 <p>For other Windows clients, you might have to download an update from
 108 Microsoft to add <a name="INDEX-7"/><a name="INDEX-8"/>Windows Time Service client support or
 109 use a third-party application such as the free
 110 <a name="INDEX-9"/>analogX Atomic TimeSync (<a href="http://www.analogx.com">http://www.analogx.com</a>). Or you can use the
 111 <em class="emphasis">net time</em> command to update the
 112 client's clock periodically, as discussed
 113 previously.</p>
 114 </li></ol>
 115
 116 <div class="sect2"><a name="samba2-CHP-11-SECT-1.1"/>
 117
 118 <h3 class="head2">Time-Synchronization Options</h3>
 119
 120 <p>To support roaming profiles, programmers accessing your Samba server,
 121 and other time-sensitive functions on your network,
 122 you'll want to be aware of the options listed in
 123 <a href="ch11.html#samba2-CHP-11-TABLE-1">Table 11-1</a>.</p>
 124
 125 <a name="samba2-CHP-11-TABLE-1"/><h4 class="head4">Table 11-1. Time-synchronization options</h4><table border="1">
 126
 127
 128
 129
 130
 131
 132 <tr>
 133 <th>
 134 <p>Option</p>
 135 </th>
 136 <th>
 137 <p>Parameters</p>
 138 </th>
 139 <th>
 140 <p>Function</p>
 141 </th>
 142 <th>
 143 <p>Default</p>
 144 </th>
 145 <th>
 146 <p>Scope</p>
 147 </th>
 148 </tr>
 149
 150
 151 <tr>
 152 <td>
 153 <p><tt class="literal">time server</tt></p>
 154 </td>
 155 <td>
 156 <p>Boolean</p>
 157 </td>
 158 <td>
 159 <p>If <tt class="literal">yes</tt>, announces <em class="emphasis">nmbd</em> as an
 160 SMB time service to Windows clients</p>
 161 </td>
 162 <td>
 163 <p><tt class="literal">no</tt></p>
 164 </td>
 165 <td>
 166 <p>Global</p>
 167 </td>
 168 </tr>
 169 <tr>
 170 <td>
 171 <p><tt class="literal">time offset</tt></p>
 172 </td>
 173 <td>
 174 <p>numeric</p>
 175 </td>
 176 <td>
 177 <p>Adds a specified number of minutes to the reported time</p>
 178 </td>
 179 <td>
 180 <p><tt class="literal">0</tt></p>
 181 </td>
 182 <td>
 183 <p>Global</p>
 184 </td>
 185 </tr>
 186 <tr>
 187 <td>
 188 <p><tt class="literal">dos filetimes</tt></p>
 189 </td>
 190 <td>
 191 <p>Boolean</p>
 192 </td>
 193 <td>
 194 <p>Allows non-owners of a file to change its time if they can write to it</p>
 195 </td>
 196 <td>
 197 <p><tt class="literal">no</tt></p>
 198 </td>
 199 <td>
 200 <p>Share</p>
 201 </td>
 202 </tr>
 203 <tr>
 204 <td>
 205 <p><tt class="literal">dos filetime</tt></p>
 206
 207 <p><tt class="literal">resolution</tt></p>
 208 </td>
 209 <td>
 210 <p>Boolean</p>
 211 </td>
 212 <td>
 213 <p>Causes file times to be rounded to the next even second</p>
 214 </td>
 215 <td>
 216 <p><tt class="literal">no</tt></p>
 217 </td>
 218 <td>
 219 <p>Share</p>
 220 </td>
 221 </tr>
 222 <tr>
 223 <td>
 224 <p><tt class="literal">fake directory</tt> <tt class="literal">create times</tt></p>
 225 </td>
 226 <td>
 227 <p>Boolean</p>
 228 </td>
 229 <td>
 230 <p>Sets directory times to avoid an MS <em class="emphasis">nmake</em> bug</p>
 231 </td>
 232 <td>
 233 <p><tt class="literal">no</tt></p>
 234 </td>
 235 <td>
 236 <p>Share</p>
 237 </td>
 238 </tr>
 239
 240 </table>
 241
 242
 243 <div class="sect3"><a name="samba2-CHP-11-SECT-1.1.1"/>
 244
 245 <a name="INDEX-12"/><h3 class="head3">time server</h3>
 246
 247 <p>Samba always operates as an SMB time server, matching the behavior of
 248 Windows systems. However, Samba's default is not to
 249 advertise itself as a time server to the network. When this option is
 250 set to <tt class="literal">yes</tt>, Samba advertises itself as an SMB time
 251 server:</p>
 252
 253 <blockquote><pre class="code">[global]
 254     time service = yes</pre></blockquote>
 255
 256
 257 </div>
 258
 259
 260
 261 <div class="sect3"><a name="samba2-CHP-11-SECT-1.1.2"/>
 262
 263 <a name="INDEX-13"/><h3 class="head3">time offset</h3>
 264
 265 <p>To deal with clients that don't properly process
 266 daylight savings time, Samba provides the <tt class="literal">time</tt>
 267 <tt class="literal">offset</tt> option. If set, it adds the specified
 268 number of minutes to the current time. This is handy if
 269 you're in Newfoundland and Windows
 270 doesn't know about the 30-minute time difference
 271 there:</p>
 272
 273 <blockquote><pre class="code">[global]
 274     time offset = 30</pre></blockquote>
 275
 276
 277 </div>
 278
 279
 280
 281 <div class="sect3"><a name="samba2-CHP-11-SECT-1.1.3"/>
 282
 283 <a name="INDEX-14"/><h3 class="head3">dos filetimes</h3>
 284
 285 <p>Traditionally, only the root user and the owner of a file can change
 286 its last-modified date on a Unix system. The share-level
 287 <tt class="literal">dos</tt> <tt class="literal">filetimes</tt> option allows the
 288 Samba server to mimic the characteristics of a DOS or Windows system:
 289 any user can change the last-modified date on a file in that share if
 290 she has write permission to it. To do this, Samba uses its root
 291 privileges to modify the timestamp on the file.</p>
 292
 293 <p>By default, this option is disabled. Setting this option to
 294 <tt class="literal">yes</tt> is often necessary to allow PC
 295 <em class="emphasis">make</em> programs to work properly. Without it, they
 296 cannot change the last-modified date themselves. This often results
 297 in the program thinking <em class="emphasis">all</em> files need
 298 recompiling when they really don't.</p>
 299
 300
 301 </div>
 302
 303
 304
 305 <div class="sect3"><a name="samba2-CHP-11-SECT-1.1.4"/>
 306
 307 <h3 class="head3">dos filetime resolution</h3>
 308
 309 <p>The <tt class="literal">dos</tt><a name="INDEX-15"/>
 310 <tt class="literal">filetime</tt> <tt class="literal">resolution</tt> parameter
 311 is a share-level option. If set to <tt class="literal">yes</tt>, Samba
 312 rounds file times to the closest 2-second boundary. This option
 313 exists primarily to satisfy a quirk in Windows that prevents Visual
 314 C++ from correctly recognizing that a file has not changed. You can
 315 enable it as follows:</p>
 316
 317 <blockquote><pre class="code">[data]
 318     dos filetime resolution = yes</pre></blockquote>
 319
 320 <p>We recommend using this option only if you are using Microsoft Visual
 321 C++ on a Samba share that supports opportunistic locking.</p>
 322
 323
 324 </div>
 325
 326
 327
 328 <div class="sect3"><a name="samba2-CHP-11-SECT-1.1.5"/>
 329
 330 <h3 class="head3">fake directory create times</h3>
 331
 332 <p>The <tt class="literal">fake</tt><a name="INDEX-16"/>
 333 <tt class="literal">directory</tt> <tt class="literal">create</tt>
 334 <tt class="literal">times</tt> option exists to keep PC
 335 <em class="emphasis">make</em> programs sane. VFAT and NTFS filesystems
 336 record the creation date of a specific directory, while Unix does
 337 not. Without this option, Samba takes the earliest recorded date it
 338 has for the directory (often the last-modified date of a file) and
 339 returns it to the client. If this is not sufficient, set the
 340 following option under a share definition:</p>
 341
 342 <blockquote><pre class="code">[data]
 343     fake directory create times = yes</pre></blockquote>
 344
 345 <p>If set, Samba will adjust the directory create time it reports to the
 346 hardcoded value January 1, 1980. This is primarily used to convince
 347 the Visual C++ <em class="emphasis">nmake</em> program that any object
 348 files in its build directories are indeed younger than the creation
 349 date of the directory itself and need to be recompiled. <a name="INDEX-17"/> <a name="INDEX-18"/><a name="INDEX-19"/></p>
 350
 351
 352 </div>
 353
 354
 355 </div>
 356
 357
 358 </div>
 359
 360
 361
 362 <div class="sect1"><a name="samba2-CHP-11-SECT-2"/>
 363
 364 <h2 class="head1">Magic Scripts</h2>
 365
 366 <p><em class="firstterm">Magic scripts</em> are a method of running programs
 367 on Unix and redirecting the output back to the SMB client. These are
 368 essentially an experimental hack. However, some users and their
 369 programs still rely on these two options for their programs to
 370 function correctly. Magic scripts are not widely trusted, and their
 371 use is highly discouraged by the Samba Team.</p>
 372
 373
 374 <div class="sect2"><a name="samba2-CHP-11-SECT-2.1"/>
 375
 376 <h3 class="head2">Magic Script Options</h3>
 377
 378 <p><a href="ch11.html#samba2-CHP-11-TABLE-2">Table 11-2</a> lists the options that deal with
 379 <a name="INDEX-20"/>magic scripts
 380 on the Samba server.</p>
 381
 382 <a name="samba2-CHP-11-TABLE-2"/><h4 class="head4">Table 11-2. Magic script options</h4><table border="1">
 383
 384
 385
 386
 387
 388
 389 <tr>
 390 <th>
 391 <p>Option</p>
 392 </th>
 393 <th>
 394 <p>Parameters</p>
 395 </th>
 396 <th>
 397 <p>Function</p>
 398 </th>
 399 <th>
 400 <p>Default</p>
 401 </th>
 402 <th>
 403 <p>Scope</p>
 404 </th>
 405 </tr>
 406
 407
 408 <tr>
 409 <td>
 410 <p><tt class="literal">magic</tt> <tt class="literal">script</tt></p>
 411 </td>
 412 <td>
 413 <p>string (filename)</p>
 414 </td>
 415 <td>
 416 <p>File to be executed by Samba, as the logged-on user, when closed</p>
 417 </td>
 418 <td>
 419 <p>None</p>
 420 </td>
 421 <td>
 422 <p>Share</p>
 423 </td>
 424 </tr>
 425 <tr>
 426 <td>
 427 <p><tt class="literal">magic</tt> <tt class="literal">output</tt></p>
 428 </td>
 429 <td>
 430 <p>string (filename)</p>
 431 </td>
 432 <td>
 433 <p>File to log output from the magic file</p>
 434 </td>
 435 <td>
 436 <p><em class="emphasis">scriptname.out</em></p>
 437 </td>
 438 <td>
 439 <p>Share</p>
 440 </td>
 441 </tr>
 442
 443 </table>
 444
 445
 446 <div class="sect3"><a name="samba2-CHP-11-SECT-2.1.1"/>
 447
 448 <h3 class="head3">magic script</h3>
 449
 450 <p>If the <tt class="literal">magic</tt><a name="INDEX-21"/>
 451 <tt class="literal">script</tt> option is set to a filename and the client
 452 creates a file by that name in that share, Samba will run the file as
 453 soon as the user has opened and closed it. For example,
 454 let's assume that the following option was created
 455 in the share <tt class="literal">[accounting]</tt>:</p>
 456
 457 <blockquote><pre class="code">[accounting]
 458     magic script = tally.sh</pre></blockquote>
 459
 460 <p>Samba continually monitors the files in that share. If one by the
 461 name of <em class="emphasis">tally.sh</em> is closed (after being opened)
 462 by a user, Samba will execute the contents of that file locally. The
 463 file will be passed to the shell to execute; it must therefore be a
 464 legal Unix shell script. This means that it must have newline
 465 characters as line endings instead of Windows CRLFs. In addition, you
 466 need to use the <tt class="literal">#!</tt> directive at the beginning of
 467 the file to indicate under which shell or interpreter the script
 468 should run, unless the script is for the default shell on your
 469 system.</p>
 470
 471
 472 </div>
 473
 474
 475
 476 <div class="sect3"><a name="samba2-CHP-11-SECT-2.1.2"/>
 477
 478 <a name="INDEX-22"/><h3 class="head3">magic output</h3>
 479
 480 <p>This option specifies an output file to which the script specified by
 481 the <tt class="literal">magic</tt> <tt class="literal">script</tt> option will
 482 send output. You must specify a filename in a writable directory:</p>
 483
 484 <blockquote><pre class="code">[accounting]
 485     magic script = tally.sh
 486     magic output = /var/log/magicoutput</pre></blockquote>
 487
 488 <p>If this option is omitted, the default output file is the name of the
 489 script (as stated in the <tt class="literal">magic</tt>
 490 <tt class="literal">script</tt> option) with the extension
 491 <em class="emphasis">.out</em> appended onto it.</p>
 492
 493
 494 </div>
 495
 496
 497 </div>
 498
 499
 500 </div>
 501
 502
 503
 504 <div class="sect1"><a name="samba2-CHP-11-SECT-3"/>
 505
 506 <h2 class="head1">Internationalization</h2>
 507
 508 <p><a name="INDEX-23"/><a name="INDEX-24"/>Starting
 509 with Samba 3.0, Samba supports Unicode &quot;on the
 510 wire,&quot; requiring no additional effort on your part
 511 to support filenames and other text containing characters in
 512 international character sets.</p>
 513
 514
 515 <div class="sect2"><a name="samba2-CHP-11-SECT-3.1"/>
 516
 517 <h3 class="head2">Internationalization Options</h3>
 518
 519 <p>Samba 2.2.x has a limited ability to speak foreign tongues: if you
 520 need to support filenames containing characters that
 521 aren't in standard ASCII, some options that can help
 522 you are shown in <a href="ch11.html#samba2-CHP-11-TABLE-3">Table 11-3</a>.</p>
 523
 524 <a name="samba2-CHP-11-TABLE-3"/><h4 class="head4">Table 11-3. Internationalization options</h4><table border="1">
 525
 526
 527
 528
 529
 530
 531 <tr>
 532 <th>
 533 <p>Option</p>
 534 </th>
 535 <th>
 536 <p>Parameters</p>
 537 </th>
 538 <th>
 539 <p>Function</p>
 540 </th>
 541 <th>
 542 <p>Default</p>
 543 </th>
 544 <th>
 545 <p>Scope</p>
 546 </th>
 547 </tr>
 548
 549
 550 <tr>
 551 <td>
 552 <p><tt class="literal">client code</tt> <tt class="literal">page</tt></p>
 553 </td>
 554 <td>
 555 <p>Described in this section</p>
 556 </td>
 557 <td>
 558 <p>Sets a code page to expect from clients</p>
 559 </td>
 560 <td>
 561 <p>850</p>
 562 </td>
 563 <td>
 564 <p>Global</p>
 565 </td>
 566 </tr>
 567 <tr>
 568 <td>
 569 <p><tt class="literal">character set</tt></p>
 570 </td>
 571 <td>
 572 <p>Described in this section</p>
 573 </td>
 574 <td>
 575 <p>Translates code pages into alternate Unix character sets</p>
 576 </td>
 577 <td>
 578 <p>None</p>
 579 </td>
 580 <td>
 581 <p>Global</p>
 582 </td>
 583 </tr>
 584 <tr>
 585 <td>
 586 <p><tt class="literal">coding system</tt></p>
 587 </td>
 588 <td>
 589 <p>Described in this section</p>
 590 </td>
 591 <td>
 592 <p>Translates code page 932 into an Asian character set</p>
 593 </td>
 594 <td>
 595 <p>None</p>
 596 </td>
 597 <td>
 598 <p>Global</p>
 599 </td>
 600 </tr>
 601 <tr>
 602 <td>
 603 <p><tt class="literal">valid chars</tt></p>
 604 </td>
 605 <td>
 606 <p>string (set of characters)</p>
 607 </td>
 608 <td>
 609 <p>Adds individual characters to a code page</p>
 610 </td>
 611 <td>
 612 <p>None</p>
 613 </td>
 614 <td>
 615 <p>Global</p>
 616 </td>
 617 </tr>
 618
 619 </table>
 620
 621
 622 <div class="sect3"><a name="samba2-CHP-11-SECT-3.1.1"/>
 623
 624 <h3 class="head3">client code page</h3>
 625
 626 <p>The character sets on Windows platforms hark back to the original
 627 concept of a <em class="emphasis">code page</em><a name="INDEX-25"/>. These code pages are used by DOS and
 628 Windows clients to determine rules for mapping lowercase letters to
 629 uppercase letters. Samba can be instructed to use a variety of code
 630 pages through the use of the global
 631 <tt class="literal">client</tt><a name="INDEX-26"/> <tt class="literal">code</tt>
 632 <tt class="literal">page</tt> option to match the corresponding code page
 633 in use on the client. This option loads a code page definition file
 634 and can take the values specified in <a href="ch11.html#samba2-CHP-11-TABLE-4">Table 11-4</a>.</p>
 635
 636 <a name="samba2-CHP-11-TABLE-4"/><h4 class="head4">Table 11-4. Valid code pages with Samba 2.0</h4><table border="1">
 637
 638
 639
 640 <tr>
 641 <th>
 642 <p>Code page</p>
 643 </th>
 644 <th>
 645 <p>Definition</p>
 646 </th>
 647 </tr>
 648
 649
 650 <tr>
 651 <td>
 652 <p><tt class="literal">437</tt></p>
 653 </td>
 654 <td>
 655 <p>MS-DOS Latin (United States)</p>
 656 </td>
 657 </tr>
 658 <tr>
 659 <td>
 660 <p><tt class="literal">737</tt></p>
 661 </td>
 662 <td>
 663 <p>Windows 95 Greek</p>
 664 </td>
 665 </tr>
 666 <tr>
 667 <td>
 668 <p><tt class="literal">850</tt></p>
 669 </td>
 670 <td>
 671 <p>MS-DOS Latin 1 (Western European)</p>
 672 </td>
 673 </tr>
 674 <tr>
 675 <td>
 676 <p><tt class="literal">852</tt></p>
 677 </td>
 678 <td>
 679 <p>MS-DOS Latin 2 (Eastern European)</p>
 680 </td>
 681 </tr>
 682 <tr>
 683 <td>
 684 <p><tt class="literal">861</tt></p>
 685 </td>
 686 <td>
 687 <p>MS-DOS Icelandic</p>
 688 </td>
 689 </tr>
 690 <tr>
 691 <td>
 692 <p><tt class="literal">866</tt></p>
 693 </td>
 694 <td>
 695 <p>MS-DOS Cyrillic (Russian)</p>
 696 </td>
 697 </tr>
 698 <tr>
 699 <td>
 700 <p><tt class="literal">932</tt></p>
 701 </td>
 702 <td>
 703 <p>MS-DOS Japanese Shift-JIS</p>
 704 </td>
 705 </tr>
 706 <tr>
 707 <td>
 708 <p><tt class="literal">936</tt></p>
 709 </td>
 710 <td>
 711 <p>MS-DOS Simplified Chinese</p>
 712 </td>
 713 </tr>
 714 <tr>
 715 <td>
 716 <p><tt class="literal">949</tt></p>
 717 </td>
 718 <td>
 719 <p>MS-DOS Korean Hangul</p>
 720 </td>
 721 </tr>
 722 <tr>
 723 <td>
 724 <p><tt class="literal">950</tt></p>
 725 </td>
 726 <td>
 727 <p>MS-DOS Traditional Chinese</p>
 728 </td>
 729 </tr>
 730
 731 </table>
 732
 733 <p>You can set the client code page as follows:</p>
 734
 735 <blockquote><pre class="code">[global]
 736     client code page = 852</pre></blockquote>
 737
 738 <p>The default value of this option is 850, for MS-DOS Latin 1. You can
 739 use the <em class="emphasis">make_smbcodepage</em> tool that comes with
 740 Samba (by default in <em class="filename">/usr/local/samba/bin</em> ) to
 741 create your own SMB code pages, in the event that those listed
 742 earlier are not sufficient.</p>
 743
 744
 745 </div>
 746
 747
 748
 749 <div class="sect3"><a name="samba2-CHP-11-SECT-3.1.2"/>
 750
 751 <h3 class="head3">character set</h3>
 752
 753 <p>The global <tt class="literal">character</tt><a name="INDEX-27"/>
 754 <tt class="literal">set</tt> option can be used to convert filenames
 755 offered through a DOS code page (see the previous section, <a href="ch11.html#samba2-CHP-11-SECT-3.1.1">Section 11.3.1.1</a>) to equivalents that can be
 756 represented by Unix character sets other than those in the United
 757 States. For example, if you want to convert the Western European
 758 MS-DOS character set on the client to a Western European Unix
 759 character set on the server, you can use the following in your
 760 configuration file:</p>
 761
 762 <blockquote><pre class="code">[global]
 763     client code page = 850
 764     character set = ISO8859-1</pre></blockquote>
 765
 766 <p>Note that you must include a <tt class="literal">client</tt>
 767 <tt class="literal">code</tt> <tt class="literal">page</tt> option to specify the
 768 character set from which you are converting. The valid character sets
 769 (and their matching code pages) that Samba accepts are listed in
 770 <a href="ch11.html#samba2-CHP-11-TABLE-5">Table 11-5</a>.</p>
 771
 772 <a name="samba2-CHP-11-TABLE-5"/><h4 class="head4">Table 11-5. Valid character sets</h4><table border="1">
 773
 774
 775
 776
 777 <tr>
 778 <th>
 779 <p>Character set</p>
 780 </th>
 781 <th>
 782 <p>Matching code page</p>
 783 </th>
 784 <th>
 785 <p>Definition</p>
 786 </th>
 787 </tr>
 788
 789
 790 <tr>
 791 <td>
 792 <p><tt class="literal">ISO8859-1</tt></p>
 793 </td>
 794 <td>
 795 <p><tt class="literal">850</tt></p>
 796 </td>
 797 <td>
 798 <p>Western European Unix</p>
 799 </td>
 800 </tr>
 801 <tr>
 802 <td>
 803 <p><tt class="literal">ISO8859-2</tt></p>
 804 </td>
 805 <td>
 806 <p><tt class="literal">852</tt></p>
 807 </td>
 808 <td>
 809 <p>Eastern European Unix</p>
 810 </td>
 811 </tr>
 812 <tr>
 813 <td>
 814 <p><tt class="literal">ISO8859-5</tt></p>
 815 </td>
 816 <td>
 817 <p><tt class="literal">866</tt></p>
 818 </td>
 819 <td>
 820 <p>Russian Cyrillic Unix</p>
 821 </td>
 822 </tr>
 823 <tr>
 824 <td>
 825 <p><tt class="literal">ISO8859-7</tt></p>
 826 </td>
 827 <td>
 828 <p>737</p>
 829 </td>
 830 <td>
 831 <p>Greek Unix</p>
 832 </td>
 833 </tr>
 834 <tr>
 835 <td>
 836 <p><tt class="literal">KOI8-R</tt></p>
 837 </td>
 838 <td>
 839 <p><tt class="literal">866</tt></p>
 840 </td>
 841 <td>
 842 <p>Alternate Russian Cyrillic Unix</p>
 843 </td>
 844 </tr>
 845
 846 </table>
 847
 848 <p>Normally, the <tt class="literal">character</tt> <tt class="literal">set</tt>
 849 option is disabled completely.</p>
 850
 851
 852 </div>
 853
 854
 855
 856 <div class="sect3"><a name="samba2-CHP-11-SECT-3.1.3"/>
 857
 858 <h3 class="head3">coding system</h3>
 859
 860 <p>The <tt class="literal">coding</tt><a name="INDEX-28"/> <tt class="literal">system</tt>
 861 option is similar to the <tt class="literal">character</tt>
 862 <tt class="literal">set</tt> option. However, its purpose is to determine
 863 how to convert a Japanese Shift JIS code page into an appropriate
 864 Unix character set. To use this option, the <tt class="literal">client</tt>
 865 <tt class="literal">code</tt> <tt class="literal">page</tt> option described
 866 previously must be set to page <tt class="literal">932</tt>. The valid
 867 coding systems that Samba accepts are listed in <a href="ch11.html#samba2-CHP-11-TABLE-6">Table 11-6</a>.</p>
 868
 869 <a name="samba2-CHP-11-TABLE-6"/><h4 class="head4">Table 11-6. Valid coding-system parameters</h4><table border="1">
 870
 871
 872
 873 <tr>
 874 <th>
 875 <p>Character set</p>
 876 </th>
 877 <th>
 878 <p>Definition</p>
 879 </th>
 880 </tr>
 881
 882
 883 <tr>
 884 <td>
 885 <p><tt class="literal">SJIS</tt></p>
 886 </td>
 887 <td>
 888 <p>Standard Shift JIS</p>
 889 </td>
 890 </tr>
 891 <tr>
 892 <td>
 893 <p><tt class="literal">JIS8</tt></p>
 894 </td>
 895 <td>
 896 <p>Eight-bit JIS codes</p>
 897 </td>
 898 </tr>
 899 <tr>
 900 <td>
 901 <p><tt class="literal">J8BB</tt></p>
 902 </td>
 903 <td>
 904 <p>Eight-bit JIS codes</p>
 905 </td>
 906 </tr>
 907 <tr>
 908 <td>
 909 <p><tt class="literal">J8BH</tt></p>
 910 </td>
 911 <td>
 912 <p>Eight-bit JIS codes</p>
 913 </td>
 914 </tr>
 915 <tr>
 916 <td>
 917 <p><tt class="literal">J8@B</tt></p>
 918 </td>
 919 <td>
 920 <p>Eight-bit JIS codes</p>
 921 </td>
 922 </tr>
 923 <tr>
 924 <td>
 925 <p><tt class="literal">J8@J</tt></p>
 926 </td>
 927 <td>
 928 <p>Eight-bit JIS codes</p>
 929 </td>
 930 </tr>
 931 <tr>
 932 <td>
 933 <p><tt class="literal">J8@H</tt></p>
 934 </td>
 935 <td>
 936 <p>Eight-bit JIS codes</p>
 937 </td>
 938 </tr>
 939 <tr>
 940 <td>
 941 <p><tt class="literal">JIS7</tt></p>
 942 </td>
 943 <td>
 944 <p>Seven-bit JIS codes</p>
 945 </td>
 946 </tr>
 947 <tr>
 948 <td>
 949 <p><tt class="literal">J7BB</tt></p>
 950 </td>
 951 <td>
 952 <p>Seven-bit JIS codes</p>
 953 </td>
 954 </tr>
 955 <tr>
 956 <td>
 957 <p><tt class="literal">J7BH</tt></p>
 958 </td>
 959 <td>
 960 <p>Seven-bit JIS codes</p>
 961 </td>
 962 </tr>
 963 <tr>
 964 <td>
 965 <p><tt class="literal">J7@B</tt></p>
 966 </td>
 967 <td>
 968 <p>Seven-bit JIS codes</p>
 969 </td>
 970 </tr>
 971 <tr>
 972 <td>
 973 <p><tt class="literal">J7@J</tt></p>
 974 </td>
 975 <td>
 976 <p>Seven-bit JIS codes</p>
 977 </td>
 978 </tr>
 979 <tr>
 980 <td>
 981 <p><tt class="literal">J7@H</tt></p>
 982 </td>
 983 <td>
 984 <p>Seven-bit JIS codes</p>
 985 </td>
 986 </tr>
 987 <tr>
 988 <td>
 989 <p><tt class="literal">JUNET</tt></p>
 990 </td>
 991 <td>
 992 <p>JUNET codes</p>
 993 </td>
 994 </tr>
 995 <tr>
 996 <td>
 997 <p><tt class="literal">JUBB</tt></p>
 998 </td>
 999 <td>
1000 <p>JUNET codes</p>
1001 </td>
1002 </tr>
1003 <tr>
1004 <td>
1005 <p><tt class="literal">JUBH</tt></p>
1006 </td>
1007 <td>
1008 <p>JUNET codes</p>
1009 </td>
1010 </tr>
1011 <tr>
1012 <td>
1013 <p><tt class="literal">JU@B</tt></p>
1014 </td>
1015 <td>
1016 <p>JUNET codes</p>
1017 </td>
1018 </tr>
1019 <tr>
1020 <td>
1021 <p><tt class="literal">JU@J</tt></p>
1022 </td>
1023 <td>
1024 <p>JUNET codes</p>
1025 </td>
1026 </tr>
1027 <tr>
1028 <td>
1029 <p><tt class="literal">JU@H</tt></p>
1030 </td>
1031 <td>
1032 <p>JUNET codes</p>
1033 </td>
1034 </tr>
1035 <tr>
1036 <td>
1037 <p><tt class="literal">EUC</tt></p>
1038 </td>
1039 <td>
1040 <p>EUC codes</p>
1041 </td>
1042 </tr>
1043 <tr>
1044 <td>
1045 <p><tt class="literal">HEX</tt></p>
1046 </td>
1047 <td>
1048 <p>Three-byte hexadecimal code</p>
1049 </td>
1050 </tr>
1051 <tr>
1052 <td>
1053 <p><tt class="literal">CAP</tt></p>
1054 </td>
1055 <td>
1056 <p>Three-byte hexadecimal code (Columbia AppleTalk Program)</p>
1057 </td>
1058 </tr>
1059
1060 </table>
1061
1062
1063 </div>
1064
1065
1066
1067 <div class="sect3"><a name="samba2-CHP-11-SECT-3.1.4"/>
1068
1069 <h3 class="head3">valid chars</h3>
1070
1071 <p>The <tt class="literal">valid</tt><a name="INDEX-29"/> <tt class="literal">chars</tt> option
1072 can be used to add individual characters to a code page. You can use
1073 this option as follows:</p>
1074
1075 <blockquote><pre class="code">valid chars = &Icirc;
1076 valid chars = 0450:0420 0x0A20:0x0A00
1077 valid chars = A:a</pre></blockquote>
1078
1079 <p>Each character in the list specified should be separated by spaces.
1080 If there is a colon between two characters or a numerical equivalent,
1081 the data to the left of the colon is considered an uppercase
1082 character, while the data to the right is considered the lowercase
1083 character. You can represent characters both by literals (if you can
1084 type them) and by octal, hexadecimal, or decimal Unicode equivalents.</p>
1085
1086 <p>If you use this option, it must be listed after the
1087 <tt class="literal">client</tt> <tt class="literal">code</tt>
1088 <tt class="literal">page</tt> to which you wish to add the character.
1089 <a name="INDEX-30"/><a name="INDEX-31"/></p>
1090
1091
1092 </div>
1093
1094
1095 </div>
1096
1097
1098 </div>
1099
1100
1101
1102 <div class="sect1"><a name="samba2-CHP-11-SECT-4"/>
1103
1104 <h2 class="head1">Windows Messenger Service</h2>
1105
1106 <p>One of the odd features of SMB protocol is its ability to send text
1107 messages between computers. Although both the name and functionality
1108 are similar to that of Windows Messenger, the two are not the same.
1109 <a name="INDEX-32"/><a name="INDEX-33"/><a name="INDEX-34"/>Windows Messenger (also called MSN
1110 Messenger) is an Internet-oriented instant messenging service, while
1111 Windows Messenger Service is an older and simpler LAN-oriented
1112 service. Using the Windows Messenger Service, messages can be
1113 addressed to users, individual computers, or entire workgroups on the
1114 network.</p>
1115
1116 <p>The <a name="INDEX-35"/>WinPopup
1117 tool (<em class="filename">Winpopup.exe</em>), shown in <a href="ch11.html#samba2-CHP-11-FIG-1">Figure 11-1</a>, can be used on Windows 95/98/Me to send or
1118 receive messages. WinPopup is a handy tool for sending messages.
1119 However, to receive messages, it must already be running when the
1120 message is sent from the remote system.</p>
1121
1122 <div class="figure"><a name="samba2-CHP-11-FIG-1"/><img src="figs/sam2_1101.gif"/></div><h4 class="head4">Figure 11-1. Sending a message from a Windows 95/98/Me system (left); receiving a message (right)</h4>
1123
1124 <p>On Windows NT/2000/XP, the messenger service lets you receive
1125 messages without having an application already running; messages will
1126 automatically appear in a small dialog box on the screen when
1127 received, as shown in <a href="ch11.html#samba2-CHP-11-FIG-2">Figure 11-2</a>.</p>
1128
1129 <div class="figure"><a name="samba2-CHP-11-FIG-2"/><img src="figs/sam2_1102.gif"/></div><h4 class="head4">Figure 11-2. Receiving a message on a Windows 2000 system</h4>
1130
1131 <p>To send messages, it is necessary to use the <em class="emphasis">net
1132 send</em> command from a command-prompt window, like this:</p>
1133
1134 <blockquote><pre class="code">C:\&gt; <tt class="userinput"><b>net send maya &quot;Who's There?&quot;</b></tt>
1135 The message was successfully sent to MAYA.</pre></blockquote>
1136
1137
1138 <div class="sect2"><a name="samba2-CHP-11-SECT-4.1"/>
1139
1140 <h3 class="head2">Windows Messenger Service Configuration Option</h3>
1141
1142 <p>Samba has a single option to handle Windows Messenger Service,
1143 <tt class="literal">message</tt> <tt class="literal">command</tt>, as shown in
1144 <a href="ch11.html#samba2-CHP-11-TABLE-7">Table 11-7</a>.</p>
1145
1146 <a name="samba2-CHP-11-TABLE-7"/><h4 class="head4">Table 11-7. Windows Messenger Service configuration option</h4><table border="1">
1147
1148
1149
1150
1151
1152
1153 <tr>
1154 <th>
1155 <p>Option</p>
1156 </th>
1157 <th>
1158 <p>Parameter</p>
1159 </th>
1160 <th>
1161 <p>Function</p>
1162 </th>
1163 <th>
1164 <p>Default</p>
1165 </th>
1166 <th>
1167 <p>Scope</p>
1168 </th>
1169 </tr>
1170
1171
1172 <tr>
1173 <td>
1174 <p><tt class="literal">message</tt> <tt class="literal">command</tt></p>
1175 </td>
1176 <td>
1177 <p>string (shell command)</p>
1178 </td>
1179 <td>
1180 <p>Sets a command to run on Unix when a WinPopup message is received</p>
1181 </td>
1182 <td>
1183 <p>None</p>
1184 </td>
1185 <td>
1186 <p>Global</p>
1187 </td>
1188 </tr>
1189
1190 </table>
1191
1192
1193 <div class="sect3"><a name="samba2-CHP-11-SECT-4.1.1"/>
1194
1195 <h3 class="head3">message command</h3>
1196
1197 <p>Samba's
1198 <tt class="literal">message</tt><a name="INDEX-36"/> <tt class="literal">command</tt>
1199 option defines the command that will run on the server when a Windows
1200 Messenger Service message arrives. The command will be executed as
1201 the <tt class="literal">guest</tt> <tt class="literal">account</tt> user. What to
1202 do with messages is questionable because most Samba hosts run as
1203 unattended servers. One solution is to mail the messages to root like
1204 this:</p>
1205
1206 <blockquote><pre class="code">[global]
1207     message command = /bin/mail -s &quot;SMB Message From %f on %m&quot; root &lt;%s; rm %s</pre></blockquote>
1208
1209 <p>Note the use of variables here. The <tt class="literal">%s</tt> variable
1210 will be replaced by the name of the file in which the message
1211 resides. This file should be deleted when the command is finished
1212 with it; otherwise, a buildup of message files will collect on the
1213 Samba server. In addition, the command must either exit quickly or
1214 fork its own process (using an <tt class="literal">&amp;</tt> after the
1215 command); otherwise, the client might suspend and wait for
1216 notification that the command was sent successfully before
1217 continuing.</p>
1218
1219 <p>In addition to the standard variables, <a href="ch11.html#samba2-CHP-11-TABLE-8">Table 11-8</a>
1220 shows the three unique variables that you can use in a
1221 <tt class="literal">message</tt> <tt class="literal">command</tt>.</p>
1222
1223 <a name="samba2-CHP-11-TABLE-8"/><h4 class="head4">Table 11-8. message command variables</h4><table border="1">
1224
1225
1226
1227 <tr>
1228 <th>
1229 <p>Variable</p>
1230 </th>
1231 <th>
1232 <p>Definition</p>
1233 </th>
1234 </tr>
1235
1236
1237 <tr>
1238 <td>
1239 <p><tt class="literal">%s</tt></p>
1240 </td>
1241 <td>
1242 <p>The name of the file in which the message resides</p>
1243 </td>
1244 </tr>
1245 <tr>
1246 <td>
1247 <p><tt class="literal">%f</tt></p>
1248 </td>
1249 <td>
1250 <p>The name of the system that sent the message</p>
1251 </td>
1252 </tr>
1253 <tr>
1254 <td>
1255 <p><tt class="literal">%t</tt></p>
1256 </td>
1257 <td>
1258 <p>The name of the system that is the destination of the message
1259 <a name="INDEX-37"/><a name="INDEX-38"/><a name="INDEX-39"/></p>
1260 </td>
1261 </tr>
1262
1263 </table>
1264
1265
1266 </div>
1267
1268
1269 </div>
1270
1271
1272 </div>
1273
1274
1275
1276 <div class="sect1"><a name="samba2-CHP-11-SECT-5"/>
1277
1278 <h2 class="head1">Miscellaneous Options</h2>
1279
1280 <p>Many Samba options are available to deal with operating system issues
1281 on either Unix or Windows. In particular, some of these options are
1282 used for setting limits for clients' use of
1283 resources on the Unix server. The options shown in <a href="ch11.html#samba2-CHP-11-TABLE-9">Table 11-9</a> deal with some of these issues.</p>
1284
1285 <a name="samba2-CHP-11-TABLE-9"/><h4 class="head4">Table 11-9. Miscellaneous options</h4><table border="1">
1286
1287
1288
1289
1290
1291
1292 <tr>
1293 <th>
1294 <p>Option</p>
1295 </th>
1296 <th>
1297 <p>Parameters</p>
1298 </th>
1299 <th>
1300 <p>Function</p>
1301 </th>
1302 <th>
1303 <p>Default</p>
1304 </th>
1305 <th>
1306 <p>Scope</p>
1307 </th>
1308 </tr>
1309
1310
1311 <tr>
1312 <td>
1313 <p><tt class="literal">deadtime</tt></p>
1314 </td>
1315 <td>
1316 <p>numeric (minutes)</p>
1317 </td>
1318 <td>
1319 <p>Number of minutes of inactivity before a connection should be
1320 terminated.</p>
1321 </td>
1322 <td>
1323 <p><tt class="literal">0</tt></p>
1324 </td>
1325 <td>
1326 <p>Global</p>
1327 </td>
1328 </tr>
1329 <tr>
1330 <td>
1331 <p><tt class="literal">dfree command</tt></p>
1332 </td>
1333 <td>
1334 <p>string (command)</p>
1335 </td>
1336 <td>
1337 <p>Used to specify a command that returns free disk space in a format
1338 recognized by Samba.</p>
1339 </td>
1340 <td>
1341 <p>None</p>
1342 </td>
1343 <td>
1344 <p>Global</p>
1345 </td>
1346 </tr>
1347 <tr>
1348 <td>
1349 <p><tt class="literal">fstype</tt></p>
1350 </td>
1351 <td>
1352 <p><tt class="literal">NTFS</tt>, <tt class="literal">FAT</tt>, or
1353 <tt class="literal">Samba</tt></p>
1354 </td>
1355 <td>
1356 <p>Filesystem type reported by the server to the client.</p>
1357 </td>
1358 <td>
1359 <p><tt class="literal">NTFS</tt></p>
1360 </td>
1361 <td>
1362 <p>Global</p>
1363 </td>
1364 </tr>
1365 <tr>
1366 <td>
1367 <p><tt class="literal">keepalive</tt></p>
1368 </td>
1369 <td>
1370 <p>numeric (seconds)</p>
1371 </td>
1372 <td>
1373 <p>Number of seconds between checks for an inoperative client.</p>
1374 </td>
1375 <td>
1376 <p><tt class="literal">300</tt> (none)</p>
1377 </td>
1378 <td>
1379 <p>Global</p>
1380 </td>
1381 </tr>
1382 <tr>
1383 <td>
1384 <p><tt class="literal">max disk size</tt></p>
1385 </td>
1386 <td>
1387 <p>numeric (MB)</p>
1388 </td>
1389 <td>
1390 <p>Largest disk size to return to a client, some of which have limits.
1391 Does not affect actual operations on the disk.</p>
1392 </td>
1393 <td>
1394 <p><tt class="literal">0</tt> (infinity)</p>
1395 </td>
1396 <td>
1397 <p>Global</p>
1398 </td>
1399 </tr>
1400 <tr>
1401 <td>
1402 <p><tt class="literal">max mux</tt></p>
1403 </td>
1404 <td>
1405 <p>numeric</p>
1406 </td>
1407 <td>
1408 <p>Maximum number of simultaneous SMB operations that clients can make.</p>
1409 </td>
1410 <td>
1411 <p><tt class="literal">50</tt></p>
1412 </td>
1413 <td>
1414 <p>Global</p>
1415 </td>
1416 </tr>
1417 <tr>
1418 <td>
1419 <p><tt class="literal">max open files</tt></p>
1420 </td>
1421 <td>
1422 <p>numeric</p>
1423 </td>
1424 <td>
1425 <p>Limits number of open files to be below Unix limits.</p>
1426 </td>
1427 <td>
1428 <p><tt class="literal">10000</tt></p>
1429 </td>
1430 <td>
1431 <p>Global</p>
1432 </td>
1433 </tr>
1434 <tr>
1435 <td>
1436 <p><tt class="literal">max xmit</tt></p>
1437 </td>
1438 <td>
1439 <p>numeric</p>
1440 </td>
1441 <td>
1442 <p>Specifies the maximum packet size that Samba will send.</p>
1443 </td>
1444 <td>
1445 <p><tt class="literal">65535</tt> or <tt class="literal">16644</tt></p>
1446 </td>
1447 <td>
1448 <p>Global</p>
1449 </td>
1450 </tr>
1451 <tr>
1452 <td>
1453 <p><tt class="literal">nt pipe support</tt></p>
1454 </td>
1455 <td>
1456 <p>Boolean</p>
1457 </td>
1458 <td>
1459 <p>Turns off an NT/2000/XP support feature; for benchmarking or in case
1460 of an error.</p>
1461 </td>
1462 <td>
1463 <p><tt class="literal">yes</tt></p>
1464 </td>
1465 <td>
1466 <p>Global</p>
1467 </td>
1468 </tr>
1469 <tr>
1470 <td>
1471 <p><tt class="literal">nt smb support</tt></p>
1472 </td>
1473 <td>
1474 <p>Boolean</p>
1475 </td>
1476 <td>
1477 <p>Turns off an NT/2000/XP support feature; for benchmarking or in case
1478 of an error.</p>
1479 </td>
1480 <td>
1481 <p><tt class="literal">yes</tt></p>
1482 </td>
1483 <td>
1484 <p>Global</p>
1485 </td>
1486 </tr>
1487 <tr>
1488 <td>
1489 <p><tt class="literal">ole locking</tt> <tt class="literal">compatibility</tt></p>
1490 </td>
1491 <td>
1492 <p>Boolean</p>
1493 </td>
1494 <td>
1495 <p>Remaps out-of-range lock requests used on Windows to fit in allowable
1496 range on Unix. Turning it off causes Unix lock errors.</p>
1497 </td>
1498 <td>
1499 <p><tt class="literal">yes</tt></p>
1500 </td>
1501 <td>
1502 <p>Global</p>
1503 </td>
1504 </tr>
1505 <tr>
1506 <td>
1507 <p><tt class="literal">panic action</tt></p>
1508 </td>
1509 <td>
1510 <p>string</p>
1511 </td>
1512 <td>
1513 <p>Command to run if Samba server fails; for debugging.</p>
1514 </td>
1515 <td>
1516 <p>None</p>
1517 </td>
1518 <td>
1519 <p>Global</p>
1520 </td>
1521 </tr>
1522 <tr>
1523 <td>
1524 <p><tt class="literal">set directory</tt></p>
1525 </td>
1526 <td>
1527 <p>Boolean</p>
1528 </td>
1529 <td>
1530 <p>If <tt class="literal">yes</tt>, allows VMS clients to issue
1531 <tt class="literal">set</tt> <tt class="literal">dir</tt> commands.</p>
1532 </td>
1533 <td>
1534 <p><tt class="literal">no</tt></p>
1535 </td>
1536 <td>
1537 <p>Global</p>
1538 </td>
1539 </tr>
1540 <tr>
1541 <td>
1542 <p><tt class="literal">status</tt></p>
1543 </td>
1544 <td>
1545 <p>Boolean</p>
1546 </td>
1547 <td>
1548 <p>If <tt class="literal">yes</tt>, allows Samba to monitor status for
1549 <tt class="literal">smbstatus</tt> command.</p>
1550 </td>
1551 <td>
1552 <p><tt class="literal">yes</tt></p>
1553 </td>
1554 <td>
1555 <p>Global</p>
1556 </td>
1557 </tr>
1558 <tr>
1559 <td>
1560 <p><tt class="literal">strict sync</tt></p>
1561 </td>
1562 <td>
1563 <p>Boolean</p>
1564 </td>
1565 <td>
1566 <p>If <tt class="literal">no</tt>, ignores Windows application requests to
1567 perform a sync-to-disk.</p>
1568 </td>
1569 <td>
1570 <p><tt class="literal">no</tt></p>
1571 </td>
1572 <td>
1573 <p>Global</p>
1574 </td>
1575 </tr>
1576 <tr>
1577 <td>
1578 <p><tt class="literal">sync always</tt></p>
1579 </td>
1580 <td>
1581 <p>Boolean</p>
1582 </td>
1583 <td>
1584 <p>If <tt class="literal">yes</tt>, forces all client writes to be committed
1585 to disk before returning from the call.</p>
1586 </td>
1587 <td>
1588 <p><tt class="literal">no</tt></p>
1589 </td>
1590 <td>
1591 <p>Global</p>
1592 </td>
1593 </tr>
1594 <tr>
1595 <td>
1596 <p><tt class="literal">strip dot</tt></p>
1597 </td>
1598 <td>
1599 <p>Boolean</p>
1600 </td>
1601 <td>
1602 <p>If <tt class="literal">yes</tt>, strips trailing dots from Unix filenames.</p>
1603 </td>
1604 <td>
1605 <p><tt class="literal">no</tt></p>
1606 </td>
1607 <td>
1608 <p>Global</p>
1609 </td>
1610 </tr>
1611 <tr>
1612 <td>
1613 <p><tt class="literal">change notify timeout</tt></p>
1614 </td>
1615 <td>
1616 <p>numeric (seconds)</p>
1617 </td>
1618 <td>
1619 <p>Interval between checks when a client asks to wait for a change in a
1620 specified directory.</p>
1621 </td>
1622 <td>
1623 <p><tt class="literal">60</tt></p>
1624 </td>
1625 <td>
1626 <p>Global</p>
1627 </td>
1628 </tr>
1629 <tr>
1630 <td>
1631 <p><tt class="literal">stat cache</tt></p>
1632 </td>
1633 <td>
1634 <p>Boolean</p>
1635 </td>
1636 <td>
1637 <p>If <tt class="literal">yes</tt>, Samba will cache recent name mappings.</p>
1638 </td>
1639 <td>
1640 <p><tt class="literal">yes</tt></p>
1641 </td>
1642 <td>
1643 <p>Global</p>
1644 </td>
1645 </tr>
1646 <tr>
1647 <td>
1648 <p><tt class="literal">stat cache size</tt></p>
1649 </td>
1650 <td>
1651 <p>numeric</p>
1652 </td>
1653 <td>
1654 <p>Number of entries in the stat cache.</p>
1655 </td>
1656 <td>
1657 <p><tt class="literal">50</tt></p>
1658 </td>
1659 <td>
1660 <p>Global</p>
1661 </td>
1662 </tr>
1663
1664 </table>
1665
1666
1667 <div class="sect2"><a name="samba2-CHP-11-SECT-5.1"/>
1668
1669 <a name="INDEX-40"/><h3 class="head2">deadtime</h3>
1670
1671 <p>This global option sets the number of minutes that Samba will wait
1672 for an inactive client before closing its session with the Samba
1673 server. A client is considered inactive when it has no open files and
1674 no data is being sent from it. The default value for this option is
1675 0, which means that Samba never closes any connection, regardless of
1676 how long they have been inactive. This can lead to unnecessary
1677 consumption of the server's resources by inactive
1678 clients. We recommend that you override the default as follows:</p>
1679
1680 <blockquote><pre class="code">[global]
1681     deadtime = 10</pre></blockquote>
1682
1683 <p>This tells Samba to terminate any inactive client sessions after 10
1684 minutes. For most networks, setting this option as such will not
1685 inconvenience users because reconnections from the client are
1686 generally performed transparently to the user. See also the
1687 <tt class="literal">keepalive</tt> parameter.</p>
1688
1689
1690 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.1"/>
1691
1692 <a name="INDEX-41"/><h3 class="head3">dfree command</h3>
1693
1694 <p>This global option is used on systems that incorrectly determine the
1695 free space left on the disk. So far, the only confirmed system that
1696 needs this option set is Ultrix. There is no default value for this
1697 option, which means that Samba already knows how to compute the free
1698 disk space on its own and the results are considered reliable. You
1699 can override it as follows:</p>
1700
1701 <blockquote><pre class="code">[global]
1702     dfree command = /usr/local/bin/dfree</pre></blockquote>
1703
1704 <p>This option should point to a script that returns the total disk
1705 space in a block and the number of available blocks. The Samba
1706 documentation recommends the following as a usable script:</p>
1707
1708 <blockquote><pre class="code">#!/bin/sh
1709 df $1 | tail -1 | awk '{print $2&quot; &quot;$4}'</pre></blockquote>
1710
1711 <p>On System V machines, the following will work:</p>
1712
1713 <blockquote><pre class="code">#!/bin/sh
1714 /usr/bin/df $1 | tail -1 | awk '{print $3&quot; &quot;$5}'</pre></blockquote>
1715
1716
1717 </div>
1718
1719
1720
1721 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.2"/>
1722
1723 <a name="INDEX-42"/><h3 class="head3">fstype</h3>
1724
1725 <p>This share-level option sets the type of filesystem that Samba
1726 reports when queried by the client. Three strings can be used as a
1727 value to this configuration option, as listed in <a href="ch11.html#samba2-CHP-11-TABLE-10">Table 11-10</a>.</p>
1728
1729 <a name="samba2-CHP-11-TABLE-10"/><h4 class="head4">Table 11-10. Filesystem types</h4><table border="1">
1730
1731
1732
1733 <tr>
1734 <th>
1735 <p>Value</p>
1736 </th>
1737 <th>
1738 <p>Definition</p>
1739 </th>
1740 </tr>
1741
1742
1743 <tr>
1744 <td>
1745 <p>NTFS</p>
1746 </td>
1747 <td>
1748 <p>Microsoft Windows NT filesystem</p>
1749 </td>
1750 </tr>
1751 <tr>
1752 <td>
1753 <p>FAT</p>
1754 </td>
1755 <td>
1756 <p>DOS FAT filesystem</p>
1757 </td>
1758 </tr>
1759 <tr>
1760 <td>
1761 <p>Samba</p>
1762 </td>
1763 <td>
1764 <p>Samba filesystem</p>
1765 </td>
1766 </tr>
1767
1768 </table>
1769
1770 <p>The default value for this option is <tt class="literal">NTFS</tt>, which
1771 represents a Windows NT filesystem. There probably
1772 isn't a need to specify any other type of
1773 filesystem. However, if you need to, you can override the default
1774 value per share as follows:</p>
1775
1776 <blockquote><pre class="code">[data]
1777     fstype = FAT</pre></blockquote>
1778
1779
1780 </div>
1781
1782
1783
1784 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.3"/>
1785
1786 <a name="INDEX-43"/><h3 class="head3">keepalive</h3>
1787
1788 <p>This global option specifies the number of seconds that Samba waits
1789 between sending NetBIOS <em class="emphasis">keepalive packets</em>. These
1790 packets are used to ping a client to detect whether it is still alive
1791 and on the network. The default value for this option is
1792 <tt class="literal">300</tt> (5 minutes), which you can override as
1793 follows:</p>
1794
1795 <blockquote><pre class="code">[global]
1796     keepalive = 600</pre></blockquote>
1797
1798 <p>The value of <tt class="literal">600</tt> (10 minutes) is good for networks
1799 populated by reliable clients. If your network contains relatively
1800 unreliable clients, you might prefer to set
1801 <tt class="literal">keepalive</tt> to a lower value, such as
1802 <tt class="literal">30</tt>. If <tt class="literal">keepalive</tt> is set to 0,
1803 no NetBIOS keepalive packets will be sent. See also the
1804 <tt class="literal">deadtime</tt> parameter.</p>
1805
1806
1807 </div>
1808
1809
1810
1811 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.4"/>
1812
1813 <a name="INDEX-44"/><h3 class="head3">max disk size</h3>
1814
1815 <p>This global option specifies an illusory limit, in megabytes, for
1816 each share that Samba is offering. It only affects how much disk
1817 space Samba reports the share as having and does not prevent more
1818 disk space from actually being available for use. You would typically
1819 set this option to prevent clients with older operating
1820 systems&mdash;or running buggy applications&mdash;from being confused
1821 by large disk spaces. For example, some older Windows applications
1822 become confused when they encounter a share larger than 1 gigabyte.
1823 To work around this problem, <tt class="literal">max</tt>
1824 <tt class="literal">disk</tt> <tt class="literal">size</tt> can be set as
1825 follows:</p>
1826
1827 <blockquote><pre class="code">[global]
1828     max disk size = 1000</pre></blockquote>
1829
1830 <p>The default value for this option is <tt class="literal">0</tt>, which
1831 means there is no upper limit.</p>
1832
1833
1834 </div>
1835
1836
1837
1838 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.5"/>
1839
1840 <a name="INDEX-45"/><h3 class="head3">max mux</h3>
1841
1842 <p>This global option specifies the maximum number of concurrent SMB
1843 operations Samba allows. The default value for this option is
1844 <tt class="literal">50</tt>. You can override it as follows:</p>
1845
1846 <blockquote><pre class="code">[global]
1847     max mux = 100</pre></blockquote>
1848
1849
1850 </div>
1851
1852
1853
1854 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.6"/>
1855
1856 <a name="INDEX-46"/><h3 class="head3">max open files</h3>
1857
1858 <p>This global option specifies the maximum number of open files that
1859 Samba should allow at any given time for all processes. This value
1860 must be equal to or less than the amount allowed by the operating
1861 system, which varies from system to system. The default value for
1862 this option is <tt class="literal">10000</tt>. You can override it as
1863 follows:</p>
1864
1865 <blockquote><pre class="code">[global]
1866     max open files = 8000</pre></blockquote>
1867
1868
1869 </div>
1870
1871
1872
1873 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.7"/>
1874
1875 <a name="INDEX-47"/><h3 class="head3">max xmit</h3>
1876
1877 <p>This global option sets the maximum size of packets that Samba
1878 exchanges with a client. In rare cases, setting a smaller maximum
1879 packet size can increase performance, especially with Windows for
1880 Workgroups. In Samba versions up to 2.2.5, the default value for this
1881 option is <tt class="literal">65535</tt>. In 2.2.7 and later versions, the
1882 default was changed to <tt class="literal">16644</tt> to match the behavior
1883 of Windows 2000 and improve support for Windows NT 4.0. You can
1884 override the default as follows:</p>
1885
1886 <blockquote><pre class="code">[global]
1887     max xmit = 4096</pre></blockquote>
1888
1889
1890 </div>
1891
1892
1893
1894 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.8"/>
1895
1896 <a name="INDEX-48"/><h3 class="head3">nt pipe support</h3>
1897
1898 <p>This global option is used by developers to allow or disallow Windows
1899 NT/2000/XP clients the ability to make connections to
1900 <a name="INDEX-49"/>NT-specific SMB IPC$ pipes. As a user, you
1901 should never need to override the default:</p>
1902
1903 <blockquote><pre class="code">[global]
1904     nt pipe support = yes</pre></blockquote>
1905
1906
1907 </div>
1908
1909
1910
1911 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.9"/>
1912
1913 <a name="INDEX-50"/><h3 class="head3">nt smb support</h3>
1914
1915 <p>This global option is used by developers to negotiate NT-specific SMB
1916 options with Windows NT/2000/XP clients. The Samba Team has
1917 discovered that slightly better performance comes from setting this
1918 value to <tt class="literal">no</tt>. However, as a user, you should
1919 probably not override the default:</p>
1920
1921 <blockquote><pre class="code">[global]
1922     nt smb support = yes</pre></blockquote>
1923
1924
1925 </div>
1926
1927
1928
1929 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.10"/>
1930
1931 <a name="INDEX-51"/><h3 class="head3">ole locking compatibility</h3>
1932
1933 <p>This global option turns off Samba's internal
1934 byte-range locking manipulation in files, which gives compatibility
1935 with Object Linking and Embedding (OLE) applications that use high
1936 byte-range locks as a method of interprocess communication. The
1937 default value for this option is <tt class="literal">yes</tt>. If you trust
1938 your Unix locking mechanisms, you can override it as follows:</p>
1939
1940 <blockquote><pre class="code">[global]
1941     ole locking compatibility = no</pre></blockquote>
1942
1943
1944 </div>
1945
1946
1947
1948 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.11"/>
1949
1950 <a name="INDEX-52"/><h3 class="head3">panic action</h3>
1951
1952 <p>This global option specifies a command to execute in the event that
1953 Samba encounters a fatal error when loading or running. There is no
1954 default value for this option. You can specify an action as follows:</p>
1955
1956 <blockquote><pre class="code">[global]
1957     panic action = /bin/csh -c
1958           'xedit &lt;&lt;: &quot;Samba has shutdown unexpectedly&quot;;:'</pre></blockquote>
1959
1960
1961 </div>
1962
1963
1964
1965 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.12"/>
1966
1967 <a name="INDEX-53"/><h3 class="head3">set directory</h3>
1968
1969 <p>This Boolean share-level option allows <a name="INDEX-54"/>Digital Pathworks clients to
1970 use the <em class="emphasis">setdir</em> command to change directories on
1971 the server. If you are not using the Digital Pathworks client, you
1972 should not need to alter this option. The default value for this
1973 option is <tt class="literal">no</tt>. You can override it per share as
1974 follows:</p>
1975
1976 <blockquote><pre class="code">[data]
1977     set directory = yes</pre></blockquote>
1978
1979
1980 </div>
1981
1982
1983
1984 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.13"/>
1985
1986 <a name="INDEX-55"/><h3 class="head3">status</h3>
1987
1988 <p>This global option indicates whether Samba should log all active
1989 connections to a status file. This file is used only by the
1990 <em class="emphasis">smbstatus</em> command. If you have no intentions of
1991 using this command, you can set this option to <tt class="literal">no</tt>,
1992 which can result in a small increase of speed on the server. The
1993 default value for this option is <tt class="literal">yes</tt>. You can
1994 override it as follows:</p>
1995
1996 <blockquote><pre class="code">[global]
1997     status = no</pre></blockquote>
1998
1999
2000 </div>
2001
2002
2003
2004 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.14"/>
2005
2006 <a name="INDEX-56"/><h3 class="head3">strict sync</h3>
2007
2008 <p>This share-level option determines whether Samba honors all requests
2009 to perform a disk sync when requested to do so by a client. Many
2010 Windows clients request a disk sync when they are really just trying
2011 to flush data to their own open files. In this case, a disk sync is
2012 generally unnecessary on Unix due to its high reliability, and it
2013 mostly has the effect of substantially reducing the performance of
2014 the Samba host system. The default value for this option is
2015 <tt class="literal">no</tt>, which allows the superfluous disk sync
2016 requests to be ignored. You can override the default as follows:</p>
2017
2018 <blockquote><pre class="code">[data]
2019     strict sync = yes</pre></blockquote>
2020
2021
2022 </div>
2023
2024
2025
2026 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.15"/>
2027
2028 <a name="INDEX-57"/><h3 class="head3">sync always</h3>
2029
2030 <p>This share-level option decides whether every write to disk should be
2031 followed by a disk synchronization before the write call returns
2032 control to the client. Even if the value of this option is
2033 <tt class="literal">no</tt>, clients can request a disk synchronization;
2034 see the earlier <tt class="literal">strict</tt> <tt class="literal">sync</tt>
2035 option. The default value for this option is <tt class="literal">no</tt>.
2036 You can override it per share as follows:</p>
2037
2038 <blockquote><pre class="code">[data]
2039     sync always = yes</pre></blockquote>
2040
2041
2042 </div>
2043
2044
2045
2046 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.16"/>
2047
2048 <a name="INDEX-58"/><h3 class="head3">strip dot</h3>
2049
2050 <p>This global option determines whether to remove the trailing dot from
2051 Unix filenames that are formatted with a dot at the end. The default
2052 value for this option is <tt class="literal">no</tt>. You can override it
2053 per share as follows:</p>
2054
2055 <blockquote><pre class="code">[global]
2056     strip dot = yes</pre></blockquote>
2057
2058
2059 </div>
2060
2061
2062
2063 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.17"/>
2064
2065 <h3 class="head3">change notify timeout</h3>
2066
2067 <p>The <tt class="literal">change</tt><a name="INDEX-59"/>
2068 <tt class="literal">notify</tt> <tt class="literal">timeout</tt> global option
2069 emulates a Windows NT/2000 SMB feature called <em class="firstterm">change
2070 notification</em><a name="INDEX-60"/>. This allows a client to request
2071 that a Windows NT/2000 server periodically monitor a specific
2072 directory on a share for any changes. If changes occur, the server
2073 will notify the client.</p>
2074
2075 <p>Samba performs this function for its clients at an interval that
2076 defaults to 1 minute (60 seconds). Performing these checks too often
2077 can slow down the server considerably; however, you can use this
2078 option to specify an alternate time that Samba should wait between
2079 performing checks:</p>
2080
2081 <blockquote><pre class="code">[global]
2082     change notify timeout = 30</pre></blockquote>
2083
2084
2085 </div>
2086
2087
2088
2089 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.18"/>
2090
2091 <h3 class="head3">stat cache</h3>
2092
2093 <p>The <tt class="literal">stat</tt><a name="INDEX-61"/> <tt class="literal">cache</tt> global
2094 option turns on caching of recent case-insensitive name mappings. The
2095 default is <tt class="literal">yes</tt>. The Samba Team recommends that you
2096 never change this parameter.</p>
2097
2098
2099 </div>
2100
2101
2102
2103 <div class="sect3"><a name="samba2-CHP-11-SECT-5.1.19"/>
2104
2105 <h3 class="head3">stat cache size</h3>
2106
2107 <p>The <tt class="literal">stat</tt><a name="INDEX-62"/> <tt class="literal">cache</tt>
2108 <tt class="literal">size</tt> global option sets the number of cache
2109 entries to be used for the <tt class="literal">stat</tt>
2110 <tt class="literal">cache</tt> option. The default here is
2111 <tt class="literal">50</tt>. Again, the Samba Team recommends that you
2112 never change this parameter.</p>
2113
2114
2115 </div>
2116
2117
2118 </div>
2119
2120
2121 </div>
2122
2123 <hr/><h4 class="head4"><a href="toc.html">TOC</a></h4></body></html>