summaryrefslogtreecommitdiff
path: root/docs/yodldocs/nmblookup.1.yo
diff options
context:
space:
mode:
authorJeremy Allison <jra@samba.org>1998-11-02 21:25:00 +0000
committerJeremy Allison <jra@samba.org>1998-11-02 21:25:00 +0000
commit47f2e19adf2917e994b7eeddf1c24f96c5e6fe19 (patch)
treed2c0da8185bc941f0e5c2395a9a7023cb159407b /docs/yodldocs/nmblookup.1.yo
parentc082539152eefb90a752277b3917403f613c3a3a (diff)
downloadsamba-47f2e19adf2917e994b7eeddf1c24f96c5e6fe19.tar.gz
samba-47f2e19adf2917e994b7eeddf1c24f96c5e6fe19.tar.bz2
samba-47f2e19adf2917e994b7eeddf1c24f96c5e6fe19.zip
Fixed up html links - docs look better now (getting the hang of this).
Added nmblookup.1.yo. Jeremy. (This used to be commit 8eb78a1fe5ff65f575cc1773b301e18be714d652)
Diffstat (limited to 'docs/yodldocs/nmblookup.1.yo')
-rw-r--r--docs/yodldocs/nmblookup.1.yo138
1 files changed, 138 insertions, 0 deletions
diff --git a/docs/yodldocs/nmblookup.1.yo b/docs/yodldocs/nmblookup.1.yo
new file mode 100644
index 0000000000..9de3372e4f
--- /dev/null
+++ b/docs/yodldocs/nmblookup.1.yo
@@ -0,0 +1,138 @@
+mailto(samba-bugs@samba.anu.edu.au)
+
+manpage(nmblookup)(1)(23 Oct 1998)(Samba)(SAMBA)
+
+label(NAME)
+manpagename(nmblookup)(NetBIOS over TCP/IP client used to lookup NetBIOS names)
+
+label(SYNOPSIS)
+manpagesynopsis()
+
+bf(nmblookup) [-M] [-R] [-S] [-r] [-A] [-h] [-B broadcast address] [-U unicast address] [-d debuglevel] [-s smb config file] [-i NetBIOS scope] name
+
+label(DESCRIPTION)
+manpagedescription()
+
+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
+or to a particular machine. All queries are done over UDP.
+
+label(OPTIONS)
+manpageoptions()
+
+startdit()
+
+dit(bf(-M)) Searches for a master browser. This is done by doing a
+broadcast lookup on the special name tt(__MSBROWSE__).
+
+dit(bf(-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
+running a WINS server and the user wishes to query the names in the
+WINS server. If this bit is unset the normal (broadcast responding)
+NetBIOS processing code on a machine is used instead. See rfc1001,
+rfc1002 for details.
+
+dit(bf(-S)) Once the name query has returned an IP address then do a
+node status query as well.
+
+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
+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.
+
+dit(bf(-A)) Interpret <name> as an IP Address and do a node status
+query on this address.
+
+dit(bf(-h)) Print a help (usage) message.
+
+dit(bf(-B broadcast address)) Send the query to the given broadcast
+address. Without this option the default behavior of nmblookup is to
+send the query to the broadcast address of the primary network
+interface as either auto-detected or defined in the url(bf(smb.conf
+(5)))(smb.conf.5.html) file.
+
+dit(bf(-U unicast address)) Do a unicast query to the specified
+address or host tt("unicast address"). This option (along with the
+bf(-R) option) is needed to query a WINS server.
+
+dit(bf(-d debuglevel)) debuglevel is an integer from 0 to 10.
+
+The default value if this parameter is not specified is zero.
+
+The higher this value, the more detail will be logged about the
+activities of bf(nmblookup). At level 0, only critical errors and
+serious warnings will be logged.
+
+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
+data, most of which is extremely cryptic.
+
+dit(bf(-i scope)) This specifies a NetBIOS scope that smbclient 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
+system administrator in charge of all the NetBIOS systems you
+communicate with.
+
+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.
+
+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:
+
+tt(nmblookup -U server -R 'name')
+
+For example, running :
+
+tt(nmblookup -U samba.anu.edu.au -R IRIX#1B')
+
+would query the WINS server samba.anu.edu.au for the domain master
+browser (1B name type) for the IRIX workgroup.
+
+label(VERSION)
+manpagesection(VERSION)
+
+This man page is (mostly) correct for version 2.0 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 these
+to the address below for rectification.
+
+label(SEEALSO)
+manpageseealso()
+
+url(bf(samba (7)))(samba.7.html), url(bf(nmbd (8)))(nmbd.8.html), url(bf(smb.conf (5)))(smb.conf.5.html)
+
+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
+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).
+
+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,
+comments etc.
+