mirror of
https://github.com/samba-team/samba.git
synced 2024-12-29 11:21:54 +03:00
682 lines
13 KiB
HTML
682 lines
13 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>nmbd</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
|
|
><BODY
|
|
CLASS="REFENTRY"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><H1
|
|
><A
|
|
NAME="NMBD"
|
|
>nmbd</A
|
|
></H1
|
|
><DIV
|
|
CLASS="REFNAMEDIV"
|
|
><A
|
|
NAME="AEN5"
|
|
></A
|
|
><H2
|
|
>Name</H2
|
|
>nmbd -- NetBIOS name server to provide NetBIOS
|
|
over IP naming services to clients</DIV
|
|
><DIV
|
|
CLASS="REFSYNOPSISDIV"
|
|
><A
|
|
NAME="AEN8"
|
|
></A
|
|
><H2
|
|
>Synopsis</H2
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>smbd</B
|
|
> [-D] [-a] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log file>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN23"
|
|
></A
|
|
><H2
|
|
>DESCRIPTION</H2
|
|
><P
|
|
>This program is part of the Samba suite.</P
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> is a server that understands
|
|
and can reply to NetBIOS over IP name service requests, like
|
|
those produced by SMBD/CIFS clients such as Windows 95/98/ME,
|
|
Windows NT, Windows 2000, and LanManager clients. It also
|
|
participates in the browsing protocols which make up the
|
|
Windows "Network Neighborhood" view.</P
|
|
><P
|
|
>SMB/CIFS clients, when they start up, may wish to
|
|
locate an SMB/CIFS server. That is, they wish to know what
|
|
IP number a specified host is using.</P
|
|
><P
|
|
>Amongst other services, <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> will
|
|
listen for such requests, and if its own NetBIOS name is
|
|
specified it will respond with the IP number of the host it
|
|
is running on. Its "own NetBIOS name" is by
|
|
default the primary DNS name of the host it is running on,
|
|
but this can be overridden with the <I
|
|
CLASS="EMPHASIS"
|
|
>-n</I
|
|
>
|
|
option (see OPTIONS below). Thus <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> will
|
|
reply to broadcast queries for its own name(s). Additional
|
|
names for <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> to respond on can be set
|
|
via parameters in the <A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
><TT
|
|
CLASS="FILENAME"
|
|
> smb.conf(5)</TT
|
|
></A
|
|
> configuration file.</P
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> can also be used as a WINS
|
|
(Windows Internet Name Server) server. What this basically means
|
|
is that it will act as a WINS database server, creating a
|
|
database from name registration requests that it receives and
|
|
replying to queries from clients for these names.</P
|
|
><P
|
|
>In addition, <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> can act as a WINS
|
|
proxy, relaying broadcast queries from clients that do
|
|
not understand how to talk the WINS protocol to a WIN
|
|
server.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN40"
|
|
></A
|
|
><H2
|
|
>OPTIONS</H2
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>-D</DT
|
|
><DD
|
|
><P
|
|
>If specified, this parameter causes
|
|
<B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> to operate as a daemon. That is,
|
|
it detaches itself and runs in the background, fielding
|
|
requests on the appropriate port. By default, <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
>
|
|
will operate as a daemon if launched from a command shell.
|
|
nmbd can also be operated from the <B
|
|
CLASS="COMMAND"
|
|
>inetd</B
|
|
>
|
|
meta-daemon, although this is not recommended.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>-a</DT
|
|
><DD
|
|
><P
|
|
>If this parameter is specified, each new
|
|
connection will append log messages to the log file.
|
|
This is the default.</P
|
|
></DD
|
|
><DT
|
|
>-o</DT
|
|
><DD
|
|
><P
|
|
>If this parameter is specified, the
|
|
log files will be overwritten when opened. By default,
|
|
<B
|
|
CLASS="COMMAND"
|
|
>smbd</B
|
|
> will append entries to the log
|
|
files.</P
|
|
></DD
|
|
><DT
|
|
>-h</DT
|
|
><DD
|
|
><P
|
|
>Prints the help information (usage)
|
|
for <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
>.</P
|
|
></DD
|
|
><DT
|
|
>-H <filename></DT
|
|
><DD
|
|
><P
|
|
>NetBIOS lmhosts file. The lmhosts
|
|
file is a list of NetBIOS names to IP addresses that
|
|
is loaded by the nmbd server and used via the name
|
|
resolution mechanism <A
|
|
HREF="smb.conf.5.html#nameresolveorder"
|
|
TARGET="_top"
|
|
> name resolve order</A
|
|
> described in <A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
> <TT
|
|
CLASS="FILENAME"
|
|
>smb.conf(5)</TT
|
|
></A
|
|
>
|
|
to resolve any NetBIOS name queries needed by the server. Note
|
|
that the contents of this file are <I
|
|
CLASS="EMPHASIS"
|
|
>NOT</I
|
|
>
|
|
used by <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> to answer any name queries.
|
|
Adding a line to this file affects name NetBIOS resolution
|
|
from this host <I
|
|
CLASS="EMPHASIS"
|
|
>ONLY</I
|
|
>.</P
|
|
><P
|
|
>The default path to this file is compiled into
|
|
Samba as part of the build process. Common defaults
|
|
are <TT
|
|
CLASS="FILENAME"
|
|
>/usr/local/samba/lib/lmhosts</TT
|
|
>,
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>/usr/samba/lib/lmhosts</TT
|
|
> or
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>/etc/lmhosts</TT
|
|
>. See the <A
|
|
HREF="lmhosts.5.html"
|
|
TARGET="_top"
|
|
> <TT
|
|
CLASS="FILENAME"
|
|
>lmhosts(5)</TT
|
|
></A
|
|
> man page for details on the
|
|
contents of this file.</P
|
|
></DD
|
|
><DT
|
|
>-V</DT
|
|
><DD
|
|
><P
|
|
>Prints the version number for
|
|
<B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
>.</P
|
|
></DD
|
|
><DT
|
|
>-d <debug level></DT
|
|
><DD
|
|
><P
|
|
>debuglevel is an integer
|
|
from 0 to 10. The default value if this parameter is
|
|
not specified is zero.</P
|
|
><P
|
|
>The higher this value, the more detail will
|
|
be logged to the log files about the activities of the
|
|
server. At level 0, only critical errors and serious
|
|
warnings will be logged. Level 1 is a reasonable level for
|
|
day to day running - it generates a small amount of
|
|
information about operations carried out.</P
|
|
><P
|
|
>Levels above 1 will generate considerable amounts
|
|
of log data, and should only be used when investigating
|
|
a problem. Levels above 3 are designed for use only by developers
|
|
and generate HUGE amounts of log data, most of which is extremely
|
|
cryptic.</P
|
|
><P
|
|
>Note that specifying this parameter here will override
|
|
the <A
|
|
HREF="smb.conf.5.html#loglevel"
|
|
TARGET="_top"
|
|
>log level</A
|
|
>
|
|
parameter in the <A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
><TT
|
|
CLASS="FILENAME"
|
|
> smb.conf</TT
|
|
></A
|
|
> file.</P
|
|
></DD
|
|
><DT
|
|
>-l <log file></DT
|
|
><DD
|
|
><P
|
|
>The -l parameter specifies a path
|
|
and base filename into which operational data from
|
|
the running <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> server will
|
|
be logged. The actual log file name is generated by
|
|
appending the extension ".nmb" to the specified base
|
|
name. For example, if the name specified was "log"
|
|
then the file log.nmb would contain the debugging data.</P
|
|
><P
|
|
>The default log file path is compiled into Samba as
|
|
part of the build process. Common defaults are <TT
|
|
CLASS="FILENAME"
|
|
> /usr/local/samba/var/log.nmb</TT
|
|
>, <TT
|
|
CLASS="FILENAME"
|
|
> /usr/samba/var/log.nmb</TT
|
|
> or
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>/var/log/log.nmb</TT
|
|
>.</P
|
|
></DD
|
|
><DT
|
|
>-n <primary NetBIOS name></DT
|
|
><DD
|
|
><P
|
|
>This option allows you to override
|
|
the NetBIOS name that Samba uses for itself. This is identical
|
|
to setting the <A
|
|
HREF="smb.conf.5.html#netbiosname"
|
|
TARGET="_top"
|
|
> NetBIOS name</A
|
|
> parameter in the <A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
>
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>smb.conf</TT
|
|
></A
|
|
> file. However, a command
|
|
line setting will take precedence over settings in
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>smb.conf</TT
|
|
>.</P
|
|
></DD
|
|
><DT
|
|
>-p <UDP port number></DT
|
|
><DD
|
|
><P
|
|
>UDP port number is a positive integer value.
|
|
This option changes the default UDP port number (normally 137)
|
|
that <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> responds to name queries on. Don't
|
|
use this option unless you are an expert, in which case you
|
|
won't need help!</P
|
|
></DD
|
|
><DT
|
|
>-s <configuration file></DT
|
|
><DD
|
|
><P
|
|
>The default configuration file name
|
|
is set at build time, typically as <TT
|
|
CLASS="FILENAME"
|
|
> /usr/local/samba/lib/smb.conf</TT
|
|
>, but
|
|
this may be changed when Samba is autoconfigured.</P
|
|
><P
|
|
>The file specified contains the configuration details
|
|
required by the server. See <A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
>
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>smb.conf(5)</TT
|
|
></A
|
|
> for more information.
|
|
</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN125"
|
|
></A
|
|
><H2
|
|
>FILES</H2
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>/etc/inetd.conf</TT
|
|
></DT
|
|
><DD
|
|
><P
|
|
>If the server is to be run by the
|
|
<B
|
|
CLASS="COMMAND"
|
|
>inetd</B
|
|
> meta-daemon, this file
|
|
must contain suitable startup information for the
|
|
meta-daemon. See the section INSTALLATION below.
|
|
</P
|
|
></DD
|
|
><DT
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>/etc/rc</TT
|
|
></DT
|
|
><DD
|
|
><P
|
|
>or whatever initialization script your
|
|
system uses).</P
|
|
><P
|
|
>If running the server as a daemon at startup,
|
|
this file will need to contain an appropriate startup
|
|
sequence for the server. See the section INSTALLATION
|
|
below.</P
|
|
></DD
|
|
><DT
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>/etc/services</TT
|
|
></DT
|
|
><DD
|
|
><P
|
|
>If running the server via the
|
|
meta-daemon <B
|
|
CLASS="COMMAND"
|
|
>inetd</B
|
|
>, this file
|
|
must contain a mapping of service name (e.g., netbios-ssn)
|
|
to service port (e.g., 139) and protocol type (e.g., tcp).
|
|
See the section INSTALLATION below.</P
|
|
></DD
|
|
><DT
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>/usr/local/samba/lib/smb.conf</TT
|
|
></DT
|
|
><DD
|
|
><P
|
|
>This is the default location of the
|
|
<A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>smb.conf</TT
|
|
></A
|
|
>
|
|
server configuration file. Other common places that systems
|
|
install this file are <TT
|
|
CLASS="FILENAME"
|
|
>/usr/samba/lib/smb.conf</TT
|
|
>
|
|
and <TT
|
|
CLASS="FILENAME"
|
|
>/etc/smb.conf</TT
|
|
>.</P
|
|
><P
|
|
>When run as a WINS server (see the
|
|
<A
|
|
HREF="smb.conf.5.html#winssupport"
|
|
TARGET="_top"
|
|
>wins support</A
|
|
>
|
|
parameter in the <A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
><TT
|
|
CLASS="FILENAME"
|
|
> smb.conf(5)</TT
|
|
></A
|
|
> man page), <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
>
|
|
will store the WINS database in the file <TT
|
|
CLASS="FILENAME"
|
|
>wins.dat</TT
|
|
>
|
|
in the <TT
|
|
CLASS="FILENAME"
|
|
>var/locks</TT
|
|
> directory configured under
|
|
wherever Samba was configured to install itself.</P
|
|
><P
|
|
>If <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> is acting as a <I
|
|
CLASS="EMPHASIS"
|
|
> browse master</I
|
|
> (see the <A
|
|
HREF="smb.conf.5.html#localmaster"
|
|
TARGET="_top"
|
|
>local master</A
|
|
>
|
|
parameter in the <A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
><TT
|
|
CLASS="FILENAME"
|
|
> smb.conf(5)</TT
|
|
></A
|
|
> man page), <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
>
|
|
will store the browsing database in the file <TT
|
|
CLASS="FILENAME"
|
|
>browse.dat
|
|
</TT
|
|
> in the <TT
|
|
CLASS="FILENAME"
|
|
>var/locks</TT
|
|
> directory
|
|
configured under wherever Samba was configured to install itself.
|
|
</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN171"
|
|
></A
|
|
><H2
|
|
>SIGNALS</H2
|
|
><P
|
|
>To shut down an <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> process it is recommended
|
|
that SIGKILL (-9) <I
|
|
CLASS="EMPHASIS"
|
|
>NOT</I
|
|
> be used, except as a last
|
|
resort, as this may leave the name database in an inconsistent state.
|
|
The correct way to terminate <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> is to send it
|
|
a SIGTERM (-15) signal and wait for it to die on its own.</P
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> will accept SIGHUP, which will cause
|
|
it to dump out it's namelists into the file <TT
|
|
CLASS="FILENAME"
|
|
>namelist.debug
|
|
</TT
|
|
> in the <TT
|
|
CLASS="FILENAME"
|
|
>/usr/local/samba/var/locks</TT
|
|
>
|
|
directory (or the <TT
|
|
CLASS="FILENAME"
|
|
>var/locks</TT
|
|
> directory configured
|
|
under wherever Samba was configured to install itself). This will also
|
|
cause <B
|
|
CLASS="COMMAND"
|
|
>nmbd</B
|
|
> to dump out it's server database in
|
|
the <TT
|
|
CLASS="FILENAME"
|
|
>log.nmb</TT
|
|
> file. In addition, the debug log level
|
|
of nmbd may be raised by sending it a SIGUSR1 (<B
|
|
CLASS="COMMAND"
|
|
>kill -USR1
|
|
<nmbd-pid></B
|
|
>) and lowered by sending it a
|
|
SIGUSR2 (<B
|
|
CLASS="COMMAND"
|
|
>kill -USR2 <nmbd-pid></B
|
|
>). This is to
|
|
allow transient problems to be diagnosed, whilst still running at a
|
|
normally low log level.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN186"
|
|
></A
|
|
><H2
|
|
>VERSION</H2
|
|
><P
|
|
>This man page is correct for version 2.2 of
|
|
the Samba suite.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN189"
|
|
></A
|
|
><H2
|
|
>SEE ALSO</H2
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>inetd(8)</B
|
|
>, <A
|
|
HREF="smbd.8.html"
|
|
TARGET="_top"
|
|
><B
|
|
CLASS="COMMAND"
|
|
>smbd(8)</B
|
|
></A
|
|
>,
|
|
<A
|
|
HREF="smb.conf.5.html"
|
|
TARGET="_top"
|
|
><TT
|
|
CLASS="FILENAME"
|
|
>smb.conf(5)</TT
|
|
>
|
|
</A
|
|
>, <A
|
|
HREF="smbclient.1.html"
|
|
TARGET="_top"
|
|
><B
|
|
CLASS="COMMAND"
|
|
>smbclient(1)
|
|
</B
|
|
></A
|
|
>, <A
|
|
HREF="testparm.1.html"
|
|
TARGET="_top"
|
|
><B
|
|
CLASS="COMMAND"
|
|
> testparm(1)</B
|
|
></A
|
|
>, <A
|
|
HREF="testprns.1.html"
|
|
TARGET="_top"
|
|
> <B
|
|
CLASS="COMMAND"
|
|
>testprns(1)</B
|
|
></A
|
|
>, and the Internet RFC's
|
|
<TT
|
|
CLASS="FILENAME"
|
|
>rfc1001.txt</TT
|
|
>, <TT
|
|
CLASS="FILENAME"
|
|
>rfc1002.txt</TT
|
|
>.
|
|
In addition the CIFS (formerly SMB) specification is available
|
|
as a link from the Web page <A
|
|
HREF="http://samba.org/cifs/"
|
|
TARGET="_top"
|
|
>
|
|
http://samba.org/cifs/</A
|
|
>.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN206"
|
|
></A
|
|
><H2
|
|
>AUTHOR</H2
|
|
><P
|
|
>The original Samba software and related utilities
|
|
were created by Andrew Tridgell. Samba is now developed
|
|
by the Samba Team as an Open Source project similar
|
|
to the way the Linux kernel is developed.</P
|
|
><P
|
|
>The original Samba man pages were written by Karl Auer.
|
|
The man page sources were converted to YODL format (another
|
|
excellent piece of Open Source software, available at
|
|
<A
|
|
HREF="ftp://ftp.icce.rug.nl/pub/unix/"
|
|
TARGET="_top"
|
|
> ftp://ftp.icce.rug.nl/pub/unix/</A
|
|
>) and updated for the Samba 2.0
|
|
release by Jeremy Allison. The conversion to DocBook for
|
|
Samba 2.2 was done by Gerald Carter</P
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |