sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2024-12-25 23:21:54 +03:00
Code

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

Browse Source 
Jeremy.
This commit is contained in:
Jeremy Allison 0001-01-01 00:00:00 +00:00
parent eee9bb5e02
commit 889f26a5bc
2 changed files with 31 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/yodldocs/nmbd.8.yo
View File

@ -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.

16
docs/yodldocs/smbd.8.yo
View File

@ -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