global change from samba.anu.edu.au to samba.org
[tprouty/samba.git] / docs / yodldocs / nmblookup.1.yo
index af04e6b1e948b64ac78f67cadd8dc658602cdd52..6293fd01e5e028cd195d41817473ca4fb4804401 100644 (file)
@@ -1,6 +1,6 @@
-mailto(samba-bugs@samba.anu.edu.au
+mailto(samba-bugs@samba.org
 
-manpage(nmblookup)(1)(23 Oct 1998)(Samba)(SAMBA)
+manpage(nmblookup htmlcommand((1)))(1)(23 Oct 1998)(Samba)(SAMBA)
 
 label(NAME)
 manpagename(nmblookup)(NetBIOS over TCP/IP client used to lookup NetBIOS names)
@@ -17,7 +17,7 @@ This program is part of the bf(Samba) suite.
 
 bf(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 particlar IP broadcast area
+allow the name queries to be directed at a particular IP broadcast area
 or to a particular machine. All queries are done over UDP.
 
 label(OPTIONS)
@@ -39,13 +39,14 @@ rfc1002 for details.
 
 label(minusS)
 dit(bf(-S)) Once the name query has returned an IP address then do a
-node status query as well.
+node status query as well. A node status query returns the NetBIOS names 
+registered by a host.
 
 label(minusr)
 dit(bf(-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
 ignores the source port of the requesting packet and only replies to
-UDP port 137. Unfortunately, on most UNIX systems root privillage is
+UDP port 137. Unfortunately, on most UNIX systems root privilage is
 needed to bind to this port, and in addition, if the
 url(bf(nmbd))(nmbd.8.html) daemon is running on this machine it also
 binds to this port.
@@ -90,12 +91,12 @@ level))(smb.conf.5.html#loglevel) parameter in the url(bf(smb.conf
 
 label(minuss)
 dit(bf(-s smb.conf)) This parameter specifies the pathname to the
-Samba configuration file, smb.conf. This file controls all aspects of
-the Samba setup on the machine and smbclient also needs to read this
-file.
+Samba configuration file, url(bf(smb.conf))(smb.conf.5.html). 
+This file controls all aspects of
+the Samba setup on the machine.
 
 label(minusi)
-dit(bf(-i scope)) This specifies a NetBIOS scope that smbclient will use
+dit(bf(-i scope)) This specifies a NetBIOS scope that bf(nmblookup) will use
 to communicate with when generating NetBIOS names. For details on the
 use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes
 are em(very) rarely used, only set this parameter if you are the
@@ -106,24 +107,25 @@ label(name)
 dit(bf(name)) This is the NetBIOS name being queried. Depending upon
 the previous options this may be a NetBIOS name or IP address. If a
 NetBIOS name then the different name types may be specified by
-appending tt(#<type>) to the name.
+appending tt(#<type>) to the name. This name may also be tt("*"),
+which will return all registered names within a broadcast area.
 
 enddit()
 
 label(EXAMPLES)
 manpagesection(EXAMPLES)
 
-bf(nmblookup) can be used to query a WINS server (in the same way .B
-nslookup is used to query DNS servers). To query a WINS server,
-nmblookup must be called like this:
+bf(nmblookup) can be used to query a WINS server (in the same way
+bf(nslookup) is used to query DNS servers). To query a WINS server,
+bf(nmblookup) must be called like this:
 
 tt(nmblookup -U server -R 'name')
 
 For example, running :
 
-tt(nmblookup -U samba.anu.edu.au -R IRIX#1B')
+tt(nmblookup -U samba.org -R IRIX#1B')
 
-would query the WINS server samba.anu.edu.au for the domain master
+would query the WINS server samba.org for the domain master
 browser (1B name type) for the IRIX workgroup.
 
 label(VERSION)
@@ -141,14 +143,16 @@ label(AUTHOR)
 manpageauthor()
 
 The original Samba software and related utilities were created by
-Andrew Tridgell (samba-bugs@samba.anu.edu.au). Samba is now developed
+Andrew Tridgell email(samba-bugs@samba.org). 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) and updated for the Samba2.0 release by Jeremy
-Allison, email(samba-bugs@samba.anu.edu.au).
+Source software, available at
+url(bf(ftp://ftp.icce.rug.nl/pub/unix/))(ftp://ftp.icce.rug.nl/pub/unix/))
+and updated for the Samba2.0 release by Jeremy Allison.
+email(samba-bugs@samba.org).
 
 See url(bf(samba (7)))(samba.7.html) to find out how to get a full
 list of contributors and details on how to submit bug reports,