diff options
author | Jeremy Allison <jra@samba.org> | 1998-11-02 21:25:00 +0000 |
---|---|---|
committer | Jeremy Allison <jra@samba.org> | 1998-11-02 21:25:00 +0000 |
commit | 47f2e19adf2917e994b7eeddf1c24f96c5e6fe19 (patch) | |
tree | d2c0da8185bc941f0e5c2395a9a7023cb159407b /docs/yodldocs/nmblookup.1.yo | |
parent | c082539152eefb90a752277b3917403f613c3a3a (diff) | |
download | samba-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.yo | 138 |
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. + |