Penguin
Recent Changes
Annotated edit history of nmbd(8) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 NMBD
2 !!!NMBD
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 FILES
8 SIGNALS
9 VERSION
10 SEE ALSO
11 AUTHOR
12 ----
13 !!NAME
14
15
16 nmbd - NetBIOS name server to provide NetBIOS over IP naming services to clients
17 !!SYNOPSIS
18
19
20 __nmbd__ [[ __-D__ ] [[ __-a__ ] [[ __-i__ ] [[
21 __-o__ ] [[ __-P__ ] [[ __-h__ ] [[ __-V__ ] [[
22 __-d __ ] [[ __-H
23 __ ] [[ __-l __ ] [[ __-n
24 __ ] [[ __-p
25 __ ] [[ __-s __
26 ]
27 !!DESCRIPTION
28
29
30 This program is part of the Samba suite.
31
32
33 __nmbd__ is a server that understands and can reply to
34 NetBIOS over IP name service requests, like those produced
35 by SMB/CIFS clients such as Windows 95/98/ME, Windows NT,
2 perry 36 Windows 2000, and !LanManager clients. It also participates
1 perry 37 in the browsing protocols which make up the Windows
38 __
39
40
41 SMB/CIFS clients, when they start up, may wish to locate an
42 SMB/CIFS server. That is, they wish to know what IP number a
43 specified host is using.
44
45
46 Amongst other services, __nmbd__ will listen for such
47 requests, and if its own NetBIOS name is specified it will
48 respond with the IP number of the host it is running on. Its
49 __-n__ option (see OPTIONS below).
50 Thus __nmbd__ will reply to broadcast queries for its own
51 name(s). Additional names for __nmbd__ to respond on can
52 be set via parameters in the ''smb.conf(5)''configuration
53 file.
54
55
56 __nmbd__ can also be used as a WINS (Windows Internet
57 Name Server) server. What this basically means is that it
58 will act as a WINS database server, creating a database from
59 name registration requests that it receives and replying to
60 queries from clients for these names.
61
62
63 In addition, __nmbd__ can act as a WINS proxy, relaying
64 broadcast queries from clients that do not understand how to
65 talk the WINS protocol to a WIN server.
66 !!OPTIONS
67
68
69 __-D__
70
71
72 If specified, this parameter causes __nmbd__ to operate
73 as a daemon. That is, it detaches itself and runs in the
74 background, fielding requests on the appropriate port. By
75 default, __nmbd__ will operate as a daemon if launched
76 from a command shell. nmbd can also be operated from the
77 __inetd__ meta-daemon, although this is not
78 recommended.
79
80
81 __-a__
82
83
84 If this parameter is specified, each new connection will
85 append log messages to the log file. This is the
86 default.
87
88
89 __-i__
90
91
92 If this parameter is specified it causes the server to run
93
94
95 __-o__
96
97
98 If this parameter is specified, the log files will be
99 overwritten when opened. By default, __smbd__ will append
100 entries to the log files.
101
102
103 __-h__
104
105
106 Prints the help information (usage) for
107 __nmbd__.
108
109
110 __-H __
111
112
113 NetBIOS lmhosts file. The lmhosts file is a list of NetBIOS
114 names to IP addresses that is loaded by the nmbd server and
115 used via the name resolution mechanism name resolve order to
116 resolve any NetBIOS name queries needed by the server. Note
117 that the contents of this file are __NOT__ used by
118 __nmbd__ to answer any name queries. Adding a line to
119 this file affects name NetBIOS resolution from this host
120 __ONLY__.
121
122
123 The default path to this file is compiled into Samba as part
124 of the build process. Common defaults are
125 ''/usr/local/samba/lib/lmhosts'',
126 ''/usr/samba/lib/lmhosts'' or ''/etc/lmhosts''. See
127 the ''lmhosts(5)''man page for details on the contents of
128 this file.
129
130
131 __-V__
132
133
134 Prints the version number for __nmbd__.
135
136
137 __-d __
138
139
140 debuglevel is an integer from 0 to 10. The default value if
141 this parameter is not specified is zero.
142
143
144 The higher this value, the more detail will be logged to the
145 log files about the activities of the server. At level 0,
146 only critical errors and serious warnings will be logged.
147 Level 1 is a reasonable level for day to day running - it
148 generates a small amount of information about operations
149 carried out.
150
151
152 Levels above 1 will generate considerable amounts of log
153 data, and should only be used when investigating a problem.
154 Levels above 3 are designed for use only by developers and
155 generate HUGE amounts of log data, most of which is
156 extremely cryptic.
157
158
159 Note that specifying this parameter here will override the
160 log level parameter in the ''smb.conf''file.
161
162
163 __-l __
164
165
166 The -l parameter specifies a directory into which the
167 nmbd__
168 server.
169
170
171 The default log directory is compiled into Samba as part of
172 the build process. Common defaults are
173 ''/usr/local/samba/var/log.nmb'',
174 ''/usr/samba/var/log.nmb'' or
175 ''/var/log/log.nmb''.
176
177
178 __-n __
179
180
181 This option allows you to override the NetBIOS name that
182 Samba uses for itself. This is identical to setting the
183 NetBIOS nameparameter in the ''smb.conf''file. However, a
184 command line setting will take precedence over settings in
185 ''smb.conf''.
186
187
188 __-p __
189
190
191 UDP port number is a positive integer value. This option
192 changes the default UDP port number (normally 137) that
193 __nmbd__ responds to name queries on. Don't use this
194 option unless you are an expert, in which case you won't
195 need help!
196
197
198 __-s __
199
200
201 The default configuration file name is set at build time,
202 typically as ''/usr/local/samba/lib/smb.conf'', but this
203 may be changed when Samba is autoconfigured.
204
205
206 The file specified contains the configuration details
207 required by the server. See ''smb.conf(5)''for more
208 information.
209 !!FILES
210
211
212 ''/etc/inetd.conf''
213
214
215 If the server is to be run by the __inetd__ meta-daemon,
216 this file must contain suitable startup information for the
217 meta-daemon. See the UNIX_INSTALL.htmldocument for
218 details.
219
220
221 ''/etc/rc''
222
223
224 or whatever initialization script your system
225 uses).
226
227
228 If running the server as a daemon at startup, this file will
229 need to contain an appropriate startup sequence for the
230 server. See the UNIX_INSTALL.htmldocument for
231 details.
232
233
234 ''/etc/services''
235
236
237 If running the server via the meta-daemon __inetd__, this
238 file must contain a mapping of service name (e.g.,
239 netbios-ssn) to service port (e.g., 139) and protocol type
240 (e.g., tcp). See the UNIX_INSTALL.html document for
241 details.
242
243
244 ''/usr/local/samba/lib/smb.conf''
245
246
247 This is the default location of the ''smb.conf'' server
248 configuration file. Other common places that systems install
249 this file are ''/usr/samba/lib/smb.conf'' and
250 ''/etc/smb.conf''.
251
252
253 When run as a WINS server (see the wins support parameter in
254 the ''smb.conf(5)'' man page), __nmbd__ will store the
255 WINS database in the file ''wins.dat'' in the
256 ''var/locks'' directory configured under wherever Samba
257 was configured to install itself.
258
259
260 If __nmbd__ is acting as a __browse master__ (see the
261 local master parameter in the ''smb.conf(5)'' man page,
262 __nmbd__ will store the browsing database in the file
263 ''browse.dat'' in the ''var/locks'' directory
264 configured under wherever Samba was configured to install
265 itself.
266 !!SIGNALS
267
268
269 To shut down an __nmbd__ process it is recommended that
270 SIGKILL (-9) __NOT__ be used, except as a last resort, as
271 this may leave the name database in an inconsistent state.
272 The correct way to terminate __nmbd__ is to send it a
273 SIGTERM (-15) signal and wait for it to die on its
274 own.
275
276
277 __nmbd__ will accept SIGHUP, which will cause it to dump
278 out its namelists into the file ''namelist.debug'' in the
279 ''/usr/local/samba/var/locks'' directory (or the
280 ''var/locks'' directory configured under wherever Samba
281 was configured to install itself). This will also cause
282 __nmbd__ to dump out its server database in the
283 ''log.nmb'' file.
284
285
286 The debug log level of nmbd may be raised or lowered using
287 __smbcontrol(1)__ (SIGUSR[[1|2] signals are no longer used
288 in Samba 2.2). This is to allow transient problems to be
289 diagnosed, whilst still running at a normally low log
290 level.
291 !!VERSION
292
293
294 This man page is correct for version 2.2 of the Samba
295 suite.
296 !!SEE ALSO
297
298
299 __inetd(8)__, __smbd(8)__, ''smb.conf(5)'' ,
300 __smbclient(1)__ , and the Internet RFC's
301 ''rfc1001.txt'', ''rfc1002.txt''. In addition the CIFS
302 (formerly SMB) specification is available as a link from the
303 Web page http://samba.org/cifs/
304 ''
305 !!AUTHOR
306
307
308 The original Samba software and related utilities were
309 created by Andrew Tridgell. Samba is now developed by the
310 Samba Team as an Open Source project similar to the way the
311 Linux kernel is developed.
312
313
314 The original Samba man pages were written by Karl Auer. The
315 man page sources were converted to YODL format (another
316 excellent piece of Open Source software, available at
317 ftp://ftp.icce.rug.nl/pub/unix/
318 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.