diff options
| author | Jeremy Allison <jra@samba.org> | 1998-11-11 01:23:43 +0000 |
|---|---|---|
| committer | Jeremy Allison <jra@samba.org> | 1998-11-11 01:23:43 +0000 |
| commit | af60ba31e124e87473aaa2822997f989dd52f876 (patch) | |
| tree | 1b267c21c5de74b798fa543c36c4f0f71d03c60a /docs/htmldocs/nmblookup.1.html | |
| parent | 26552543ff2960ab9c483240a27adfe15cf9c813 (diff) | |
| download | samba-af60ba31e124e87473aaa2822997f989dd52f876.tar.gz samba-af60ba31e124e87473aaa2822997f989dd52f876.tar.bz2 samba-af60ba31e124e87473aaa2822997f989dd52f876.zip | |
First version of HTML docs generated from YODL source.
Jeremy.
(This used to be commit 8f5f0bffc6af97e1f382cb3baa03ccecb0f151c4)
Diffstat (limited to 'docs/htmldocs/nmblookup.1.html')
| -rw-r--r-- | docs/htmldocs/nmblookup.1.html | 143 |
1 files changed, 143 insertions, 0 deletions
diff --git a/docs/htmldocs/nmblookup.1.html b/docs/htmldocs/nmblookup.1.html new file mode 100644 index 0000000000..90120a9ec6 --- /dev/null +++ b/docs/htmldocs/nmblookup.1.html @@ -0,0 +1,143 @@ + + + + + +<html><head><title>nmblookup</title> + +<link rev="made" href="mailto:samba-bugs@samba.anu.edu.au"> +</head> +<body> + +<hr> + +<h1>nmblookup</h1> +<h2>Samba</h2> +<h2>23 Oct 1998</h2> + + + + +<p><br><a name="NAME"></a> +<h2>NAME</h2> + nmblookup - NetBIOS over TCP/IP client used to lookup NetBIOS names +<p><br><a name="SYNOPSIS"></a> +<h2>SYNOPSIS</h2> + +<p><br><strong>nmblookup</strong> [<a href="nmblookup.1.html#minusM">-M</a>] [<a href="nmblookup.1.html#minusR">-R</a>] [<a href="nmblookup.1.html#minusS">-S</a>] [<a href="nmblookup.1.html#minusr">-r</a>] [<a href="nmblookup.1.html#minusA">-A</a>] [<a href="nmblookup.1.html#minush">-h</a>] [<a href="nmblookup.1.html#minusB">-B broadcast address</a>] [<a href="nmblookup.1.html#minusU">-U unicast address</a>] [<a href="nmblookup.1.html#minusd">-d debuglevel</a>] [<a href="nmblookup.1.html#minuss">-s smb config file</a>] [<a href="nmblookup.1.html#minusi">-i NetBIOS scope</a>] <a href="nmblookup.1.html#name">name</a> +<p><br><a name="DESCRIPTION"></a> +<h2>DESCRIPTION</h2> + +<p><br>This program is part of the <strong>Samba</strong> suite. +<p><br><strong>nmblookup</strong> 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. +<p><br><a name="OPTIONS"></a> +<h2>OPTIONS</h2> + +<p><br><ul> +<p><br><a name="minusM"></a> +<li><strong><strong>-M</strong></strong> Searches for a master browser. This is done by doing a +broadcast lookup on the special name <code>__MSBROWSE__</code>. +<p><br><a name="minusR"></a> +<li><strong><strong>-R</strong></strong> 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. +<p><br><a name="minusS"></a> +<li><strong><strong>-S</strong></strong> Once the name query has returned an IP address then do a +node status query as well. +<p><br><a name="minusr"></a> +<li><strong><strong>-r</strong></strong> 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 +<a href="nmbd.8.html"><strong>nmbd</strong></a> daemon is running on this machine it also +binds to this port. +<p><br><a name="minusA"></a> +<li><strong><strong>-A</strong></strong> Interpret <name> as an IP Address and do a node status +query on this address. +<p><br><a name="minush"></a> +<li><strong><strong>-h</strong></strong> Print a help (usage) message. +<p><br><a name="minusB"></a> +<li><strong><strong>-B broadcast address</strong></strong> 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 +<a href="smb.conf.5.html#interfaces"><strong>interfaces</strong></a> parameter of the +<a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a> file. +<p><br><a name="minusU"></a> +<li><strong><strong>-U unicast address</strong></strong> Do a unicast query to the specified +address or host <code>"unicast address"</code>. This option (along with the +<a href="nmblookup.1.html#minusR"><strong>-R</strong></a> option) is needed to query a WINS server. +<p><br><a name="minusd"></a> +<li><strong><strong>-d debuglevel</strong></strong> debuglevel is an integer from 0 to 10. +<p><br>The default value if this parameter is not specified is zero. +<p><br>The higher this value, the more detail will be logged about the +activities of <strong>nmblookup</strong>. At level 0, only critical errors and +serious warnings will be logged. +<p><br>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. +<p><br>Note that specifying this parameter here will override the <a href="smb.conf.5.html#loglevel"><strong>log +level</strong></a> parameter in the <a href="smb.conf.5.html"><strong>smb.conf +(5)</strong></a> file. +<p><br><a name="minuss"></a> +<li><strong><strong>-s smb.conf</strong></strong> 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. +<p><br><a name="minusi"></a> +<li><strong><strong>-i scope</strong></strong> 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</em> rarely used, only set this parameter if you are the +system administrator in charge of all the NetBIOS systems you +communicate with. +<p><br><a name="name"></a> +<li><strong><strong>name</strong></strong> 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 <code>#<type></code> to the name. +<p><br></ul> +<p><br><a name="EXAMPLES"></a> +<h2>EXAMPLES</h2> + +<p><br><strong>nmblookup</strong> 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: +<p><br><code>nmblookup -U server -R 'name'</code> +<p><br>For example, running : +<p><br><code>nmblookup -U samba.anu.edu.au -R IRIX#1B'</code> +<p><br>would query the WINS server samba.anu.edu.au for the domain master +browser (1B name type) for the IRIX workgroup. +<p><br><a name="VERSION"></a> +<h2>VERSION</h2> + +<p><br>This man page is correct for version 2.0 of the Samba suite. +<p><br><a name="SEEALSO"></a> +<h2>SEE ALSO</h2> + +<p><br><a href="samba.7.html"><strong>samba (7)</strong></a>, <a href="nmbd.8.html"><strong>nmbd (8)</strong></a>, +<a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a> +<p><br><a name="AUTHOR"></a> +<h2>AUTHOR</h2> + +<p><br>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. +<p><br>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, <a href="mailto:samba-bugs@samba.anu.edu.au"><em>samba-bugs@samba.anu.edu.au</em></a>. +<p><br>See <a href="samba.7.html"><strong>samba (7)</strong></a> to find out how to get a full +list of contributors and details on how to submit bug reports, +comments etc. +<p><br></body> +</html> |