summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/yodldocs/nmbd.8.yo28
-rw-r--r--docs/yodldocs/smbd.8.yo16
2 files changed, 31 insertions, 13 deletions
diff --git a/docs/yodldocs/nmbd.8.yo b/docs/yodldocs/nmbd.8.yo
index f241af1d0e..aadb70febc 100644
--- 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 c5a3f9314d..edd3bbb839 100644
--- 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