Ignore:
Timestamp:
Jan 15, 2010, 8:21:06 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update Samba 3.3 to 3.3.10 (docs)

File:
1 edited

Legend:

Unmodified
Added
Removed

  • branches/samba-3.3.x/docs/manpages/nmbd.8

    r342 r368  
     1'\" t
    12.\"     Title: nmbd
    23.\"    Author: [see the "AUTHOR" section]
    3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
    4 .\"      Date: 10/12/2009
     4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
     5.\"      Date: 01/14/2010
    56.\"    Manual: System Administration tools
    67.\"    Source: Samba 3.3
    78.\"  Language: English
    89.\"
    9 .TH "NMBD" "8" "10/12/2009" "Samba 3\&.3" "System Administration tools"
    10 .\" -----------------------------------------------------------------
    11 .\" * (re)Define some macros
    12 .\" -----------------------------------------------------------------
    13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    14 .\" toupper - uppercase a string (locale-aware)
    15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    16 .de toupper
    17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
    18 \\$*
    19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
    20 ..
    21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    22 .\" SH-xref - format a cross-reference to an SH section
    23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    24 .de SH-xref
    25 .ie n \{\
    26 .\}
    27 .toupper \\$*
    28 .el \{\
    29 \\$*
    30 .\}
    31 ..
    32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    33 .\" SH - level-one heading that works better for non-TTY output
    34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    35 .de1 SH
    36 .\" put an extra blank line of space above the head in non-TTY output
    37 .if t \{\
    38 .sp 1
    39 .\}
    40 .sp \\n[PD]u
    41 .nr an-level 1
    42 .set-an-margin
    43 .nr an-prevailing-indent \\n[IN]
    44 .fi
    45 .in \\n[an-margin]u
    46 .ti 0
    47 .HTML-TAG ".NH \\n[an-level]"
    48 .it 1 an-trap
    49 .nr an-no-space-flag 1
    50 .nr an-break-flag 1
    51 \." make the size of the head bigger
    52 .ps +3
    53 .ft B
    54 .ne (2v + 1u)
    55 .ie n \{\
    56 .\" if n (TTY output), use uppercase
    57 .toupper \\$*
    58 .\}
    59 .el \{\
    60 .nr an-break-flag 0
    61 .\" if not n (not TTY), use normal case (not uppercase)
    62 \\$1
    63 .in \\n[an-margin]u
    64 .ti 0
    65 .\" if not n (not TTY), put a border/line under subheading
    66 .sp -.6
    67 \l'\n(.lu'
    68 .\}
    69 ..
    70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    71 .\" SS - level-two heading that works better for non-TTY output
    72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    73 .de1 SS
    74 .sp \\n[PD]u
    75 .nr an-level 1
    76 .set-an-margin
    77 .nr an-prevailing-indent \\n[IN]
    78 .fi
    79 .in \\n[IN]u
    80 .ti \\n[SN]u
    81 .it 1 an-trap
    82 .nr an-no-space-flag 1
    83 .nr an-break-flag 1
    84 .ps \\n[PS-SS]u
    85 \." make the size of the head bigger
    86 .ps +2
    87 .ft B
    88 .ne (2v + 1u)
    89 .if \\n[.$] \&\\$*
    90 ..
    91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    92 .\" BB/BE - put background/screen (filled box) around block of text
    93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    94 .de BB
    95 .if t \{\
    96 .sp -.5
    97 .br
    98 .in +2n
    99 .ll -2n
    100 .gcolor red
    101 .di BX
    102 .\}
    103 ..
    104 .de EB
    105 .if t \{\
    106 .if "\\$2"adjust-for-leading-newline" \{\
    107 .sp -1
    108 .\}
    109 .br
    110 .di
    111 .in
    112 .ll
    113 .gcolor
    114 .nr BW \\n(.lu-\\n(.i
    115 .nr BH \\n(dn+.5v
    116 .ne \\n(BHu+.5v
    117 .ie "\\$2"adjust-for-leading-newline" \{\
    118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
    119 .\}
    120 .el \{\
    121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
    122 .\}
    123 .in 0
    124 .sp -.5v
    125 .nf
    126 .BX
    127 .in
    128 .sp .5v
    129 .fi
    130 .\}
    131 ..
    132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    133 .\" BM/EM - put colored marker in margin next to block of text
    134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    135 .de BM
    136 .if t \{\
    137 .br
    138 .ll -2n
    139 .gcolor red
    140 .di BX
    141 .\}
    142 ..
    143 .de EM
    144 .if t \{\
    145 .br
    146 .di
    147 .ll
    148 .gcolor
    149 .nr BH \\n(dn
    150 .ne \\n(BHu
    151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
    152 .in 0
    153 .nf
    154 .BX
    155 .in
    156 .fi
    157 .\}
    158 ..
     10.TH "NMBD" "8" "01/14/2010" "Samba 3\&.3" "System Administration tools"
    15911.\" -----------------------------------------------------------------
    16012.\" * set default formatting
    … …  
    16719.\" * MAIN CONTENT STARTS HERE *
    16820.\" -----------------------------------------------------------------
    169 .SH "Name"
     21.SH "NAME"
    17022nmbd \- NetBIOS name server to provide NetBIOS over IP naming services to clients
    171 .SH "Synopsis"
    172 .fam C
     23.SH "SYNOPSIS"
    17324.HP \w'\ 'u
    174 \FCnmbd\F[] [\-D] [\-F] [\-S] [\-a] [\-i] [\-o] [\-h] [\-V] [\-d\ <debug\ level>] [\-H\ <lmhosts\ file>] [\-l\ <log\ directory>] [\-p\ <port\ number>] [\-s\ <configuration\ file>]
    175 .fam
     25nmbd [\-D] [\-F] [\-S] [\-a] [\-i] [\-o] [\-h] [\-V] [\-d\ <debug\ level>] [\-H\ <lmhosts\ file>] [\-l\ <log\ directory>] [\-p\ <port\ number>] [\-s\ <configuration\ file>]
    17626.SH "DESCRIPTION"
    17727.PP
    … …  
    18030suite\&.
    18131.PP
    182 \FCnmbd\F[]
     32nmbd
    18333is a server that understands and can reply to NetBIOS over IP name service requests, like those produced by SMB/CIFS clients such as Windows 95/98/ME, Windows NT, Windows 2000, Windows XP and LanManager clients\&. It also participates in the browsing protocols which make up the Windows "Network Neighborhood" view\&.
    18434.PP
    … …  
    18636.PP
    18737Amongst other services,
    188 \FCnmbd\F[]
     38nmbd
    18939will 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 by the
    19040\m[blue]\fBnetbios name\fR\m[]
    19141in
    192 \FCsmb\&.conf\F[]\&. Thus
    193 \FCnmbd\F[]
     42smb\&.conf\&. Thus
     43nmbd
    19444will reply to broadcast queries for its own name(s)\&. Additional names for
    195 \FCnmbd\F[]
     45nmbd
    19646to respond on can be set via parameters in the
    19747\fBsmb.conf\fR(5)
    19848configuration file\&.
    19949.PP
    200 \FCnmbd\F[]
     50nmbd
    20151can 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\&.
    20252.PP
    20353In addition,
    204 \FCnmbd\F[]
     54nmbd
    20555can act as a WINS proxy, relaying broadcast queries from clients that do not understand how to talk the WINS protocol to a WINS server\&.
    20656.SH "OPTIONS"
    … …  
    20959.RS 4
    21060If specified, this parameter causes
    211 \FCnmbd\F[]
     61nmbd
    21262to operate as a daemon\&. That is, it detaches itself and runs in the background, fielding requests on the appropriate port\&. By default,
    213 \FCnmbd\F[]
     63nmbd
    21464will operate as a daemon if launched from a command shell\&. nmbd can also be operated from the
    215 \FCinetd\F[]
     65inetd
    21666meta\-daemon, although this is not recommended\&.
    21767.RE
    … …  
    22070.RS 4
    22171If specified, this parameter causes the main
    222 \FCnmbd\F[]
     72nmbd
    22373process to not daemonize, i\&.e\&. double\-fork and disassociate with the terminal\&. Child processes are still created as normal to service each connection request, but the main process does not exit\&. This operation mode is suitable for running
    224 \FCnmbd\F[]
     74nmbd
    22575under process supervisors such as
    226 \FCsupervise\F[]
     76supervise
    22777and
    228 \FCsvscan\F[]
     78svscan
    22979from Daniel J\&. Bernstein\'s
    230 \FCdaemontools\F[]
     80daemontools
    23181package, or the AIX process monitor\&.
    23282.RE
    … …  
    23585.RS 4
    23686If specified, this parameter causes
    237 \FCnmbd\F[]
     87nmbd
    23888to log to standard output rather than a file\&.
    23989.RE
    … …  
    24292.RS 4
    24393If this parameter is specified it causes the server to run "interactively", not as a daemon, even if the server is executed on the command line of a shell\&. Setting this parameter negates the implicit daemon mode when run from the command line\&.
    244 \FCnmbd\F[]
     94nmbd
    24595also logs to standard output, as if the
    24696\fB\-S\fR
    … …  
    262112\fINOT\fR
    263113used by
    264 \FCnmbd\F[]
     114nmbd
    265115to answer any name queries\&. Adding a line to this file affects name NetBIOS resolution from this host
    266116\fIONLY\fR\&.
    267117.sp
    268118The default path to this file is compiled into Samba as part of the build process\&. Common defaults are
    269 \FC/usr/local/samba/lib/lmhosts\F[],
    270 \FC/usr/samba/lib/lmhosts\F[]
     119/usr/local/samba/lib/lmhosts,
     120/usr/samba/lib/lmhosts
    271121or
    272 \FC/etc/samba/lmhosts\F[]\&. See the
     122/etc/samba/lmhosts\&. See the
    273123\fBlmhosts\fR(5)
    274124man page for details on the contents of this file\&.
    … …  
    285135.sp
    286136Note that specifying this parameter here will override the
    287 \m[blue]\fBlog level\fR\m[]
     137\m[blue]\fB\%smb.conf.5.html#\fR\m[]
    288138parameter in the
    289 \FCsmb\&.conf\F[]
     139smb\&.conf
    290140file\&.
    291141.RE
    292142.PP
    293 \-V
     143\-V|\-\-version
    294144.RS 4
    295145Prints the program version number\&.
    296146.RE
    297147.PP
    298 \-s <configuration file>
     148\-s|\-\-configfile <configuration file>
    299149.RS 4
    300150The file specified contains the configuration details required by the server\&. The information in this file includes server\-specific information such as what printcap file to use, as well as descriptions of all the services that the server is to provide\&. See
    301 \FCsmb\&.conf\F[]
     151smb\&.conf
    302152for more information\&. The default configuration file name is determined at compile time\&.
    303153.RE
    … …  
    313163.RS 4
    314164UDP port number is a positive integer value\&. This option changes the default UDP port number (normally 137) that
    315 \FCnmbd\F[]
     165nmbd
    316166responds to name queries on\&. Don\'t use this option unless you are an expert, in which case you won\'t need help!
    317167.RE
    318168.SH "FILES"
    319169.PP
    320 \FC/etc/inetd\&.conf\F[]
     170/etc/inetd\&.conf
    321171.RS 4
    322172If the server is to be run by the
    323 \FCinetd\F[]
     173inetd
    324174meta\-daemon, this file must contain suitable startup information for the meta\-daemon\&.
    325175.RE
    326176.PP
    327 \FC/etc/rc\F[]
     177/etc/rc
    328178.RS 4
    329179or whatever initialization script your system uses)\&.
    … …  
    332182.RE
    333183.PP
    334 \FC/etc/services\F[]
     184/etc/services
    335185.RS 4
    336186If running the server via the meta\-daemon
    337 \FCinetd\F[], 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)\&.
    338 .RE
    339 .PP
    340 \FC/usr/local/samba/lib/smb\&.conf\F[]
     187inetd, 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)\&.
     188.RE
     189.PP
     190/usr/local/samba/lib/smb\&.conf
    341191.RS 4
    342192This is the default location of the
    343193\fBsmb.conf\fR(5)
    344194server configuration file\&. Other common places that systems install this file are
    345 \FC/usr/samba/lib/smb\&.conf\F[]
     195/usr/samba/lib/smb\&.conf
    346196and
    347 \FC/etc/samba/smb\&.conf\F[]\&.
     197/etc/samba/smb\&.conf\&.
    348198.sp
    349199When run as a WINS server (see the
    … …  
    352202\fBsmb.conf\fR(5)
    353203man page),
    354 \FCnmbd\F[]
     204nmbd
    355205will store the WINS database in the file
    356 \FCwins\&.dat\F[]
     206wins\&.dat
    357207in the
    358 \FCvar/locks\F[]
     208var/locks
    359209directory configured under wherever Samba was configured to install itself\&.
    360210.sp
    361211If
    362 \FCnmbd\F[]
     212nmbd
    363213is acting as a
    364214\fI browse master\fR
    … …  
    368218\fBsmb.conf\fR(5)
    369219man page,
    370 \FCnmbd\F[]
     220nmbd
    371221will store the browsing database in the file
    372 \FCbrowse\&.dat \F[]
     222browse\&.dat
    373223in the
    374 \FCvar/locks\F[]
     224var/locks
    375225directory configured under wherever Samba was configured to install itself\&.
    376226.RE
    … …  
    378228.PP
    379229To shut down an
    380 \FCnmbd\F[]
     230nmbd
    381231process it is recommended that SIGKILL (\-9)
    382232\fINOT\fR
    383233be used, except as a last resort, as this may leave the name database in an inconsistent state\&. The correct way to terminate
    384 \FCnmbd\F[]
     234nmbd
    385235is to send it a SIGTERM (\-15) signal and wait for it to die on its own\&.
    386236.PP
    387 \FCnmbd\F[]
     237nmbd
    388238will accept SIGHUP, which will cause it to dump out its namelists into the file
    389 \FCnamelist\&.debug \F[]
     239namelist\&.debug
    390240in the
    391 \FC/usr/local/samba/var/locks\F[]
     241/usr/local/samba/var/locks
    392242directory (or the
    393 \FCvar/locks\F[]
     243var/locks
    394244directory configured under wherever Samba was configured to install itself)\&. This will also cause
    395 \FCnmbd\F[]
     245nmbd
    396246to dump out its server database in the
    397 \FClog\&.nmb\F[]
     247log\&.nmb
    398248file\&.
    399249.PP
    … …  
    413263\fBtestparm\fR(1),
    414264\fBtestprns\fR(1), and the Internet RFC\'s
    415 \FCrfc1001\&.txt\F[],
    416 \FCrfc1002\&.txt\F[]\&. In addition the CIFS (formerly SMB) specification is available as a link from the Web page
     265rfc1001\&.txt,
     266rfc1002\&.txt\&. In addition the CIFS (formerly SMB) specification is available as a link from the Web page
    417267http://samba\&.org/cifs/\&.
    418268.SH "AUTHOR"
Note: See TracChangeset for help on using the changeset viewer.