7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
27 >nmbd -- NetBIOS name server to provide NetBIOS
28 over IP naming services to clients</DIV
30 CLASS="REFSYNOPSISDIV"
40 > [-D] [-a] [-i] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]</P
50 >This program is part of the Samba suite.</P
55 > is a server that understands
56 and can reply to NetBIOS over IP name service requests, like
57 those produced by SMB/CIFS clients such as Windows 95/98/ME,
58 Windows NT, Windows 2000, and LanManager clients. It also
59 participates in the browsing protocols which make up the
60 Windows "Network Neighborhood" view.</P
62 >SMB/CIFS clients, when they start up, may wish to
63 locate an SMB/CIFS server. That is, they wish to know what
64 IP number a specified host is using.</P
66 >Amongst other services, <B
70 listen for such requests, and if its own NetBIOS name is
71 specified it will respond with the IP number of the host it
72 is running on. Its "own NetBIOS name" is by
73 default the primary DNS name of the host it is running on,
74 but this can be overridden with the <EM
77 option (see OPTIONS below). Thus <B
81 reply to broadcast queries for its own name(s). Additional
85 > to respond on can be set
86 via parameters in the <A
87 HREF="smb.conf.5.html"
93 > configuration file.</P
98 > can also be used as a WINS
99 (Windows Internet Name Server) server. What this basically means
100 is that it will act as a WINS database server, creating a
101 database from name registration requests that it receives and
102 replying to queries from clients for these names.</P
108 proxy, relaying broadcast queries from clients that do
109 not understand how to talk the WINS protocol to a WIN
128 >If specified, this parameter causes
132 > to operate as a daemon. That is,
133 it detaches itself and runs in the background, fielding
134 requests on the appropriate port. By default, <B
138 will operate as a daemon if launched from a command shell.
139 nmbd can also be operated from the <B
143 meta-daemon, although this is not recommended.
150 >If this parameter is specified, each new
151 connection will append log messages to the log file.
152 This is the default.</P
158 >If this parameter is specified it causes the
159 server to run "interactively", not as a daemon, even if the
160 server is executed on the command line of a shell. Setting this
161 parameter negates the implicit deamon mode when run from the
169 >If this parameter is specified, the
170 log files will be overwritten when opened. By default,
174 > will append entries to the log
181 >Prints the help information (usage)
188 >-H <filename></DT
191 >NetBIOS lmhosts file. The lmhosts
192 file is a list of NetBIOS names to IP addresses that
193 is loaded by the nmbd server and used via the name
194 resolution mechanism <A
195 HREF="smb.conf.5.html#nameresolveorder"
197 > name resolve order</A
199 HREF="smb.conf.5.html"
206 to resolve any NetBIOS name queries needed by the server. Note
207 that the contents of this file are <EM
213 > to answer any name queries.
214 Adding a line to this file affects name NetBIOS resolution
219 >The default path to this file is compiled into
220 Samba as part of the build process. Common defaults
223 >/usr/local/samba/lib/lmhosts</TT
227 >/usr/samba/lib/lmhosts</TT
233 HREF="lmhosts.5.html"
239 > man page for details on the
240 contents of this file.</P
246 >Prints the version number for
253 >-d <debug level></DT
256 >debuglevel is an integer
257 from 0 to 10. The default value if this parameter is
258 not specified is zero.</P
260 >The higher this value, the more detail will
261 be logged to the log files about the activities of the
262 server. At level 0, only critical errors and serious
263 warnings will be logged. Level 1 is a reasonable level for
264 day to day running - it generates a small amount of
265 information about operations carried out.</P
267 >Levels above 1 will generate considerable amounts
268 of log data, and should only be used when investigating
269 a problem. Levels above 3 are designed for use only by developers
270 and generate HUGE amounts of log data, most of which is extremely
273 >Note that specifying this parameter here will override
275 HREF="smb.conf.5.html#loglevel"
280 HREF="smb.conf.5.html"
289 >-l <log directory></DT
292 >The -l parameter specifies a directory
293 into which the "log.nmbd" log file will be created
294 for operational data from the running
300 >The default log directory is compiled into Samba
301 as part of the build process. Common defaults are <TT
303 > /usr/local/samba/var/log.nmb</TT
306 > /usr/samba/var/log.nmb</TT
310 >/var/log/log.nmb</TT
314 >-n <primary NetBIOS name></DT
317 >This option allows you to override
318 the NetBIOS name that Samba uses for itself. This is identical
320 HREF="smb.conf.5.html#netbiosname"
323 > parameter in the <A
324 HREF="smb.conf.5.html"
331 > file. However, a command
332 line setting will take precedence over settings in
339 >-p <UDP port number></DT
342 >UDP port number is a positive integer value.
343 This option changes the default UDP port number (normally 137)
347 > responds to name queries on. Don't
348 use this option unless you are an expert, in which case you
352 >-s <configuration file></DT
355 >The default configuration file name
356 is set at build time, typically as <TT
358 > /usr/local/samba/lib/smb.conf</TT
360 this may be changed when Samba is autoconfigured.</P
362 >The file specified contains the configuration details
363 required by the server. See <A
364 HREF="smb.conf.5.html"
371 > for more information.
396 >If the server is to be run by the
400 > meta-daemon, this file
401 must contain suitable startup information for the
402 meta-daemon. See the <A
403 HREF="UNIX_INSTALL.html"
405 >UNIX_INSTALL.html</A
417 >or whatever initialization script your
420 >If running the server as a daemon at startup,
421 this file will need to contain an appropriate startup
422 sequence for the server. See the <A
423 HREF="UNIX_INSTALL.html"
425 >UNIX_INSTALL.html</A
436 >If running the server via the
441 must contain a mapping of service name (e.g., netbios-ssn)
442 to service port (e.g., 139) and protocol type (e.g., tcp).
444 HREF="UNIX_INSTALL.html"
446 >UNIX_INSTALL.html</A
448 document for details.</P
453 >/usr/local/samba/lib/smb.conf</TT
457 >This is the default location of the
459 HREF="smb.conf.5.html"
466 server configuration file. Other common places that systems
467 install this file are <TT
469 >/usr/samba/lib/smb.conf</TT
476 >When run as a WINS server (see the
478 HREF="smb.conf.5.html#WINSSUPPORT"
490 will store the WINS database in the file <TT
497 > directory configured under
498 wherever Samba was configured to install itself.</P
506 HREF="smb.conf.5.html#LOCALMASTER"
518 will store the browsing database in the file <TT
526 configured under wherever Samba was configured to install itself.
543 > process it is recommended
544 that SIGKILL (-9) <EM
546 > be used, except as a last
547 resort, as this may leave the name database in an inconsistent state.
548 The correct way to terminate <B
552 a SIGTERM (-15) signal and wait for it to die on its own.</P
557 > will accept SIGHUP, which will cause
558 it to dump out its namelists into the file <TT
564 >/usr/local/samba/var/locks</TT
566 directory (or the <TT
569 > directory configured
570 under wherever Samba was configured to install itself). This will also
574 > to dump out its server database in
580 >The debug log level of nmbd may be raised or lowered using
582 HREF="smbcontrol.1.html"
589 > (SIGUSR[1|2] signals are no longer used in Samba 2.2). This is
590 to allow transient problems to be diagnosed, whilst still running
591 at a normally low log level.</P
601 >This man page is correct for version 2.2 of
624 HREF="smb.conf.5.html"
632 HREF="smbclient.1.html"
640 HREF="testparm.1.html"
647 HREF="testprns.1.html"
653 >, and the Internet RFC's
661 In addition the CIFS (formerly SMB) specification is available
662 as a link from the Web page <A
663 HREF="http://samba.org/cifs/"
666 http://samba.org/cifs/</A
677 >The original Samba software and related utilities
678 were created by Andrew Tridgell. Samba is now developed
679 by the Samba Team as an Open Source project similar
680 to the way the Linux kernel is developed.</P
682 >The original Samba man pages were written by Karl Auer.
683 The man page sources were converted to YODL format (another
684 excellent piece of Open Source software, available at
686 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
688 > ftp://ftp.icce.rug.nl/pub/unix/</A
689 >) and updated for the Samba 2.0
690 release by Jeremy Allison. The conversion to DocBook for
691 Samba 2.2 was done by Gerald Carter</P