

NMBD(8)                                                   NMBD(8)


NNAAMMEE
       nmbd - provide netbios nameserver support to clients

SSYYNNOOPPSSIISS
       nnmmbbdd  [ --DD ] [ --HH _n_e_t_b_i_o_s _h_o_s_t_s _f_i_l_e ] [ --dd _d_e_b_u_g_l_e_v_e_l ] [
       --ll _l_o_g _b_a_s_e_n_a_m_e ] [ --nn _n_e_t_b_i_o_s _n_a_m_e ] [ --pp _p_o_r_t _n_u_m_b_e_r ] [
       --ss _c_o_n_f_i_g_u_r_a_t_i_o_n _f_i_l_e ]

DDEESSCCRRIIPPTTIIOONN
       This program is part of the Samba suite.

       nnmmbbdd is a server that understands and can reply to netbios
       name service requests, like those produced  by  LanManager
       clients. It also controls browsing.

       LanManager clients, when they start up, may wish to locate
       a LanManager server.  That is, they wish to know  what  IP
       number a specified host is using.

       This  program simply listens for such requests, and if its
       own name is specified it will respond with the  IP  number
       of the host it is running on. "Its own name" is by default
       the name of the host it is running on,  but  this  can  be
       overriden  with the --nn option (see "OPTIONS" below). Using
       the

       Nmbd can also be used as a  WINS  (Windows  Internet  Name
       Server)  server. It will do this automatically by default.
       What this basically means is that it will respond  to  all
       name requests that it receives that are not broadcasts, as
       long as it can resolve the name.

OOPPTTIIOONNSS
       --BB

          This option is  obsolete.  Please  use  the  interfaces
          option in smb.conf
       --II

          This  option  is  obsolete.  Please  use the interfaces
          option in smb.conf

       --DD

          If specified, this parameter causes the server to oper-
          ate  as  a daemon. That is, it detaches itself and runs
          in the background, fielding requests on the appropriate
          port.

          By default, the server will NOT operate as a daemon.

       --CC ccoommmmeenntt ssttrriinngg

          This option is obsolete. Please use the "server string"


nmbd                           nmbd                             1


NMBD(8)                                                   NMBD(8)


          option in smb.conf

       --GG

          This option is obsolete.  Please  use  the  "workgroup"
          option in smb.conf

       --HH _n_e_t_b_i_o_s _h_o_s_t_s _f_i_l_e

          It may be useful in some situations to be able to spec-
          ify a list of netbios names for which the server should
          send  a  reply if queried. This option allows that. The
          syntax is similar to the standard /etc/hosts file  for-
          mat, but has some extensions.

          The file contains three columns. Lines beginning with a
          # are ignored as comments. The first column  is  an  IP
          address,  or a hostname. If it is a hostname then it is
          interpreted as the IP address  returned  by  gethostby-
          name()  when  read.  Any  IP address of 0.0.0.0 will be
          interpreted as the server's own IP address.

          The second column is a netbios name. This is  the  name
          that  the  server will respond to. It must be less than
          20 characters long.

          The third column  is  optional,  and  is  intended  for
          flags. Currently the only flag supported is M.

          An  M  means that this name is the default netbios name
          for this machine. This has the same affect as  specify-
          ing the --nn option to nnmmbbdd.

          NOTE:  The  G  and  S  flags  are  now obsolete and are
          replaced by  the  "interfaces"  and  "remote  announce"
          options in smb.conf.

          After  startup  the  server waits for queries, and will
          answer queries to any name known to it.  This  includes
          all  names  in  the netbios hosts file (if any) and its
          own name.

          The primary intention of the --HH option is  to  allow  a
          mapping from netbios names to internet domain names.

          EExxaammppllee::

                  # This is a sample netbios hosts file

                  # DO NOT USE THIS FILE AS-IS
                  # YOU MAY INCONVENIENCE THE OWNERS OF THESE IPs
                  # if you want to include a name with a space in
          it then
                  # use double quotes.


nmbd                           nmbd                             2


NMBD(8)                                                   NMBD(8)


                  # next add a netbios alias for a faraway host
                  arvidsjaur.anu.edu.au ARVIDSJAUR

                  # finally put in an IP for a hard to find host
                  130.45.3.213 FREDDY

       --NN

          This  option  is  obsolete. Please use the "interfaces"
          option in smb.conf instead.

       --dd _d_e_b_u_g_l_e_v_e_l
          This option sets the debug level. See ssmmbb..ccoonnff(5).

       --ll _l_o_g _f_i_l_e

          If specified, _l_o_g _f_i_l_e specifies a base  filename  into
          which  operational data from the running server will be
          logged.

          The default base name is specified at compile time.

          The base name is  used  to  generate  actual  log  file
          names.  For  example,  if  the name specified was "log"
          then the file log.nmb would contain debug info.

       --nn _n_e_t_b_i_o_s _n_a_m_e

          This option allows you to  override  the  Netbios  name
          that Samba uses for itself.

       --pp _p_o_r_t _n_u_m_b_e_r

          port number is a positive integer value.

          Don't  use  this  option  unless  you are an expert, in
          which case you won't need help!

          --ss _c_o_n_f_i_g_u_r_a_t_i_o_n _f_i_l_e

             The default configuration file name is determined at
             compile time.

             The   file   specified  contains  the  configuration
             details required by the server.  See ssmmbb..ccoonnff(5) for
             more information.

VVEERRSSIIOONN
       This  man  page  is (mostly) correct for version 1.9.16 of
       the Samba suite, plus some of the recent  patches  to  it.
       These notes will necessarily lag behind development of the
       software, so it is  possible  that  your  version  of  the
       server  has  extensions or parameter semantics that differ
       from or are not covered by this man  page.  Please  notify


nmbd                           nmbd                             3


NMBD(8)                                                   NMBD(8)


       these to the address below for rectification.

SSEEEE AALLSSOO
       iinneettdd(8), ssmmbbdd(8), ssmmbb..ccoonnff(5), ssmmbbcclliieenntt(1), tteessttppaarrmm(1),
       tteessttpprrnnss(1)

CCRREEDDIITTSS
       The original Samba software  and  related  utilities  were
       created  by Andrew Tridgell (samba-bugs@samba.anu.edu.au).
       Andrew is also the Keeper of the Source for this  project.


nmbd                           nmbd                             4