IPB
>  Man Pages > Unix > FreeBSD 6.2 > Section 1 > nmblookup man page

nmblookup man page

Section 1 - FreeBSD 6.2 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!


NMBLOOKUP(1)							  NMBLOOKUP(1)




NAME

       nmblookup - NetBIOS over TCP/IP client used to lookup NetBIOS names


SYNOPSIS

       nmblookup [-M] [-R] [-S] [-r] [-A] [-h] [-B <broadcast address>]
		 [-U <unicast address>] [-d <debug level>]
		 [-s <smb config file>] [-i <NetBIOS scope>] [-T] [-f] {name}



DESCRIPTION

       This tool is part of the samba(7) suite.


       nmblookup  is  used to query NetBIOS names and map them to IP addresses
       in a network using NetBIOS over TCP/IP queries. The options  allow  the
       name  queries  to be directed at a particular IP broadcast area or to a
       particular machine. All queries are done over UDP.



OPTIONS

       -M     Searches for a master browser by looking	up  the  NetBIOS  name
	      name  with a type of 0x1d. If  name is "-" then it does a lookup
	      on the special name__MSBROWSE__. Please note that  in  order  to
	      use  the	name "-", you need to make sure "-" isn't parsed as an
	      argument, e.g. use :nmblookup -M -- -.


       -R     Set the recursion desired bit in the packet to  do  a  recursive
	      lookup. This is used when sending a name query to a machine run-
	      ning a WINS server and the user wishes to query the names in the
	      WINS server. If this bit is unset the normal (broadcast respond-
	      ing) NetBIOS processing code on a machine is used  instead.  See
	      RFC1001, RFC1002 for details.


       -S     Once  the  name  query has returned an IP address then do a node
	      status query as well. A node status query  returns  the  NetBIOS
	      names registered by a host.


       -r     Try  and bind to UDP port 137 to send and receive UDP datagrams.
	      The reason for this option is a bug in Windows 95 where  it  ig-
	      nores  the source port of the requesting packet and only replies
	      to UDP port 137. Unfortunately, on most UNIX systems root privi-
	      lege  is	needed	to  bind to this port, and in addition, if the
	      nmbd(8) daemon is running on this machine it also binds to  this
	      port.


       -A     Interpret  name  as  an IP Address and do a node status query on
	      this address.


       -n <primary NetBIOS name>
	      This option allows you to override the NetBIOS name  that  Samba
	      uses  for itself. This is identical to setting the  parameter in
	      the smb.conf file. However, a command  line  setting  will  take
	      precedence over settings in smb.conf.


       -i <scope>
	      This specifies a NetBIOS scope that nmblookup will use to commu-
	      nicate with when generating NetBIOS names. For  details  on  the
	      use  of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS
	      scopes are very rarely used, only set this parameter if you  are
	      the  system  administrator  in charge of all the NetBIOS systems
	      you communicate with.


       -W|--workgroup=domain
	      Set the SMB domain of the username. This overrides  the  default
	      domain  which  is  the domain defined in smb.conf. If the domain
	      specified is the same as the servers NetBIOS name, it causes the
	      client  to log on using the servers local SAM (as opposed to the
	      Domain SAM).


       -O socket options
	      TCP socket options to set on the client socket. See  the	socket
	      options  parameter  in  the smb.conf manual page for the list of
	      valid options.


       -h|--help
	      Print a summary of command line options.


       -B <broadcast address>
	      Send the query to the given broadcast address. Without this  op-
	      tion  the  default behavior of nmblookup is to send the query to
	      the broadcast address of the network interfaces  as  either  au-
	      to-detected  or  defined	in  the  interfaces  parameter	of the
	      smb.conf(5) file.


       -U <unicast address>
	      Do a unicast query to the specified address or host unicast  ad-
	      dress. This option (along with the -R option) is needed to query
	      a WINS server.


       -V     Prints the program version number.


       -s <configuration file>
	      The file specified contains the configuration  details  required
	      by the server. The information in this file includes server-spe-
	      cific information such as what printcap file to use, as well  as
	      descriptions  of all the services that the server is to provide.
	      See smb.conf for more  information.  The	default  configuration
	      file name is determined at compile time.


       -d|--debuglevel=level
	      level  is an integer from 0 to 10. The default value if this pa-
	      rameter is not specified is zero.

	      The higher this value, the more detail will be logged to the log
	      files about the activities of the server. At level 0, only crit-
	      ical 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.

	      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.

	      Note  that specifying this parameter here will override the  pa-
	      rameter in the smb.conf file.


       -l|--logfile=logdirectory
	      Base directory name for log/debug files. The  extension  ".prog-
	      name"  will  be appended (e.g. log.smbclient, log.smbd, etc...).
	      The log file is never removed by the client.


       -T     This causes any IP addresses found in the lookup to be looked up
	      via a reverse DNS lookup into a DNS name, and printed out before
	      each

	      IP address .... NetBIOS name

	      pair that is the normal output.


       -f     Show which flags apply to the name that has been looked up. Pos-
	      sible  answers  are  zero  or  more of: Response, Authoritative,
	      Truncated, Recursion_Desired, Recursion_Available, Broadcast.


       name   This is the NetBIOS name being queried. Depending upon the  pre-
	      vious  options  this  may  be a NetBIOS name or IP address. If a
	      NetBIOS name then the different name types may be  specified  by
	      appending  '#<type>'  to	the  name.  This name may also be '*',
	      which will return all registered names within a broadcast  area.



EXAMPLES

       nmblookup  can be used to query a WINS server (in the same way nslookup
       is used to query DNS servers). To query a WINS server,  nmblookup  must
       be called like this:


       nmblookup -U server -R 'name'


       For example, running :


       nmblookup -U samba.org -R 'IRIX#1B'


       would query the WINS server samba.org for the domain master browser (1B
       name type) for the IRIX workgroup.



VERSION

       This man page is correct for version 3.0 of the Samba suite.



SEE ALSO

       nmbd(8), samba(7), and smb.conf(5).



AUTHOR

       The original Samba software and related utilities were created  by  An-
       drew  Tridgell.	Samba  is  now	developed by the Samba Team as an Open
       Source project similar to the way the Linux kernel is developed.


       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 ftp://ftp.icce.rug.nl/pub/unix/) and  up-
       dated  for  the	Samba 2.0 release by Jeremy Allison. The conversion to
       DocBook for Samba 2.2 was done by Gerald Carter. The conversion to Doc-
       Book XML 4.2 for Samba 3.0 was done by Alexander Bokovoy.




								  NMBLOOKUP(1)


Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 19 20:00:09 BST 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

svn man page (5499 hits)
(FreeBSD 6.2)

sqlite3 man page (5423 hits)
(openSUSE 10.2)

adv_cap_autoneg man page (4921 hits)
(Solaris 10 11_06)

CPAN man page (4660 hits)
(Suse Linux 10.1)

ssh man page (4365 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (3081 hits)
(Solaris 10 11_06)

netcat man page (2905 hits)
(Suse Linux 10.1)

signal man page (2757 hits)
(Suse Linux 10.1)

pprosetup man page (2549 hits)
(Solaris 10 11_06)

startproc man page (2549 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: PYRENEES ACTIVITY HOLIDAYS :: PCB Layout Service :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum