Sync up changes to smbd.8.yo and nmbd.8.yo.

Jeremy.
(This used to be commit 889f26a5bceb99dc0c703060e8dbb51776b06492)

diff --git a/docs/yodldocs/nmbd.8.yo b/docs/yodldocs/nmbd.8.yo
index f241af1d0e77cea06a7723150d757f49d13fd411..aadb70febcdbd9abcfb2a2e3846834a2f0f16f1f 100644 (file)
--- a/docs/yodldocs/nmbd.8.yo
+++ b/docs/yodldocs/nmbd.8.yo
@@ -116,8 +116,9 @@ em(/usr/samba/var/log.nmb) or em(/var/log/log.nmb).
 label(minusn)
 dit(bf(-n primary NetBIOS name)) This option allows you to override
 the NetBIOS name that Samba uses for itself. This is identical to
-setting the bf(NetBIOS name) parameter in the smb.conf file
-but will override the setting in the smb.conf file.
+setting the url(bf(NetBIOS name))(smb.conf.5.html#netbiosname) parameter
+in the url(bf(smb.conf))(smb.conf.5.html) file
+but will override the setting in the url(bf(smb.conf))(smb.conf.5.html) file.
 
 label(minusp)
 dit(bf(-p UDP port number)) UDP port number is a positive integer value.
@@ -132,7 +133,7 @@ set at build time, typically as em(/usr/local/samba/lib/smb.conf), but
 this may be changed when Samba is autoconfigured.
 
 The file specified contains the configuration details required by the
-server.  See bf(smb.conf (5)) for more information.
+server. See url(bf(smb.conf (5)))(smb.conf.5.html) for more information.
 
 label(minusi)
 dit(bf(-i scope)) This specifies a NetBIOS scope that the server will use
@@ -168,17 +169,32 @@ This is the default location of the em(smb.conf) server configuration
 file. Other common places that systems install this file are
 em(/usr/samba/lib/smb.conf) and em(/etc/smb.conf).
 
+When run as a bf(WINS) server (see the url(bf(wins support))(smb.conf.5.html#winssupport)
+parameter in the url(bf(smb.conf (5)))(smb.conf.5.html) man page), bf(nmbd) will
+store the WINS database in the file tt(wins.dat) in the tt(var/locks) directory
+configured under wherever Samba was configured to install itself.
+
+If bf(nmbd) is acting as a bf(browse master) (see the url(bf(local master))(smb.conf.5.html#localmaster)
+parameter in the url(bf(smb.conf (5)))(smb.conf.5.html) man page), bf(nmbd) will
+store the browsing database in the file tt(browse.dat) in the tt(var/locks) directory
+configured under wherever Samba was configured to install itself.
+
 label(SIGNALS)
 manpagesection(SIGNALS)
 
+To shut down an nmbd process it is recommended that SIGKILL (-9)
+em(NOT) be used, except as a last resort, as this may leave the name
+database in an inconsistant state. The correct way to terminate
+nmbd is to send it a SIGTERM (-15) signal and wait for it to die on
+its own.
+
 nmbd will accept SIGHUP, which will cause it to dump out it's
 namelists into the file namelist.debug in the
 em(/usr/local/samba/var/locks) directory (or the em(var/locks)
 directory configured under wherever Samba was configured to install
 itself). This will also cause nmbd to dump out it's server database in
-the log.nmb file.  Also new in version 1.9.18 and above is the ability
-to raise the debug log level of nmbd by sending it a SIGUSR1 (tt(kill
--USR1 <nmbd-pid>)) and to lower the nmbd log level by sending it a
+the log.nmb file. In addition, the the debug log level of nmbd may be raised
+by sending it a SIGUSR1 (tt(kill -USR1 <nmbd-pid>)) and lowered by sending it a
 SIGUSR2 (tt(kill -USR2 <nmbd-pid>)). This is to allow transient
 problems to be diagnosed, whilst still running at a normally low log
 level.

diff --git a/docs/yodldocs/smbd.8.yo b/docs/yodldocs/smbd.8.yo
index c5a3f9314d0d999368fc3a9c0011b30ea9902fec..edd3bbb839966d139012dd9c6caf43f0b05efbb8 100644 (file)
--- a/docs/yodldocs/smbd.8.yo
+++ b/docs/yodldocs/smbd.8.yo
@@ -262,8 +262,8 @@ label(RUNNINGTHESERVERASADAEMON)
 manpagesection(RUNNING THE SERVER AS A DAEMON)
 
 To run the server as a daemon from the command line, simply put the
-bf(-D) option on the command line. There is no need to place an
-ampersand at the end of the command line - the bf(-D) option causes
+link(bf(-D))(minusD) option on the command line. There is no need to place an
+ampersand at the end of the command line - the link(bf(-D))(minusD) option causes
 the server to detach itself from the tty anyway.
 
 Any user can run the server as a daemon (execute permissions
@@ -287,7 +287,7 @@ this man page. If the above appears as more than one line, please treat any
 newlines or indentation as a single space or TAB character.)
 
 If the options used at compile time are appropriate for your system,
-all parameters except the desired debug level and bf(-D) may be
+all parameters except the desired debug level and link(bf(-D))(minusD) may be
 omitted. See the section em(OPTIONS) above.
 
 label(RUNNINGTHESERVERONREQUEST)
@@ -300,9 +300,9 @@ machine. If you are experimenting as an ordinary user rather than as
 root, you will need the assistance of your system administrator to
 modify the system files.
 
-You will probably want to set up the NetBIOS name server bf(nmbd) at
+You will probably want to set up the NetBIOS name server url(bf(nmbd))(nmbd.8.html) at
 the same time as bf(smbd). To do this refer to the man page for
-bf(nmbd (8)).
+url(bf(nmbd (8)))(nmbd.8.html).
 
 First, ensure that a port is configured in the file /etc/services. The
 well-known port 139 should be used if possible, though any port may be
@@ -335,7 +335,8 @@ are using a non-standard port number.
 Lastly, edit the configuration file to provide suitable services. To
 start with, the following two services should be all you need:
 
-tt(
+verb(
+
 [homes]
   writable = yes
 
@@ -344,6 +345,7 @@ tt(
  printable = yes
  path = /tmp
  public = yes
+
 )
 
 This will allow you to connect to your home directory and print to any
@@ -399,7 +401,7 @@ memory area in an inconsistant state. The safe way to terminate an
 smbd is to send it a SIGTERM (-15) signal and wait for it to die on
 its own.
 
-In version 1.9.18 and above the debug log level of smbd may be raised
+The debug log level of smbd may be raised
 by sending it a SIGUSR1 tt((kill -USR1 <smbd-pid>)) and lowered by
 sending it a SIGUSR2 tt((kill -USR2 <smbd-pid>)). This is to allow
 transient problems to be diagnosed, whilst still running at a normally