| 1 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbtree</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="smbtree"><a name="smbtree.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbtree — A text based smb network browser
|
|---|
| 2 | </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbtree</code> [-b] [-D] [-S]</p></div></div><div class="refsect1" title="DESCRIPTION"><a name="id266363"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbtree</code> is a smb browser program
|
|---|
| 3 | in text mode. It is similar to the "Network Neighborhood" found
|
|---|
| 4 | on Windows computers. It prints a tree with all
|
|---|
| 5 | the known domains, the servers in those domains and
|
|---|
| 6 | the shares on the servers.
|
|---|
| 7 | </p></div><div class="refsect1" title="OPTIONS"><a name="id266846"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-b|--broadcast</span></dt><dd><p>Query network nodes by sending requests
|
|---|
| 8 | as broadcasts instead of querying the local master browser.
|
|---|
| 9 | </p></dd><dt><span class="term">-D|--domains</span></dt><dd><p>Only print a list of all
|
|---|
| 10 | the domains known on broadcast or by the
|
|---|
| 11 | master browser</p></dd><dt><span class="term">-S|--servers</span></dt><dd><p>Only print a list of
|
|---|
| 12 | all the domains and servers responding on broadcast or
|
|---|
| 13 | known by the master browser.
|
|---|
| 14 | </p></dd><dt><span class="term">-d|--debuglevel=level</span></dt><dd><p><em class="replaceable"><code>level</code></em> is an integer
|
|---|
| 15 | from 0 to 10. The default value if this parameter is
|
|---|
| 16 | not specified is 0.</p><p>The higher this value, the more detail will be
|
|---|
| 17 | logged to the log files about the activities of the
|
|---|
| 18 | server. At level 0, only critical errors and serious
|
|---|
| 19 | warnings will be logged. Level 1 is a reasonable level for
|
|---|
| 20 | day-to-day running - it generates a small amount of
|
|---|
| 21 | information about operations carried out.</p><p>Levels above 1 will generate considerable
|
|---|
| 22 | amounts of log data, and should only be used when
|
|---|
| 23 | investigating a problem. Levels above 3 are designed for
|
|---|
| 24 | use only by developers and generate HUGE amounts of log
|
|---|
| 25 | data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
|
|---|
| 26 | override the <a class="link" href="smb.conf.5.html#" target="_top"></a> parameter
|
|---|
| 27 | in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V|--version</span></dt><dd><p>Prints the program version number.
|
|---|
| 28 | </p></dd><dt><span class="term">-s|--configfile <configuration file></span></dt><dd><p>The file specified contains the
|
|---|
| 29 | configuration details required by the server. The
|
|---|
| 30 | information in this file includes server-specific
|
|---|
| 31 | information such as what printcap file to use, as well
|
|---|
| 32 | as descriptions of all the services that the server is
|
|---|
| 33 | to provide. See <code class="filename">smb.conf</code> for more information.
|
|---|
| 34 | The default configuration file name is determined at
|
|---|
| 35 | compile time.</p></dd><dt><span class="term">-l|--log-basename=logdirectory</span></dt><dd><p>Base directory name for log/debug files. The extension
|
|---|
| 36 | <code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
|
|---|
| 37 | log.smbd, etc...). The log file is never removed by the client.
|
|---|
| 38 | </p></dd><dt><span class="term">-N|--no-pass</span></dt><dd><p>If specified, this parameter suppresses the normal
|
|---|
| 39 | password prompt from the client to the user. This is useful when
|
|---|
| 40 | accessing a service that does not require a password. </p><p>Unless a password is specified on the command line or
|
|---|
| 41 | this parameter is specified, the client will request a
|
|---|
| 42 | password.</p><p>If a password is specified on the command line and this
|
|---|
| 43 | option is also defined the password on the command line will
|
|---|
| 44 | be silently ingnored and no password will be used.</p></dd><dt><span class="term">-k|--kerberos</span></dt><dd><p>
|
|---|
| 45 | Try to authenticate with kerberos. Only useful in
|
|---|
| 46 | an Active Directory environment.
|
|---|
| 47 | </p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
|
|---|
| 48 | Try to use the credentials cached by winbind.
|
|---|
| 49 | </p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
|
|---|
| 50 | you to specify a file from which to read the username and
|
|---|
| 51 | password used in the connection. The format of the file is
|
|---|
| 52 | </p><pre class="programlisting">
|
|---|
| 53 | username = <value>
|
|---|
| 54 | password = <value>
|
|---|
| 55 | domain = <value>
|
|---|
| 56 | </pre><p>Make certain that the permissions on the file restrict
|
|---|
| 57 | access from unwanted users. </p></dd><dt><span class="term">-U|--user=username[%password]</span></dt><dd><p>Sets the SMB username or username and password. </p><p>If %password is not specified, the user will be prompted. The
|
|---|
| 58 | client will first check the <code class="envar">USER</code> environment variable, then the
|
|---|
| 59 | <code class="envar">LOGNAME</code> variable and if either exists, the
|
|---|
| 60 | string is uppercased. If these environmental variables are not
|
|---|
| 61 | found, the username <code class="constant">GUEST</code> is used. </p><p>A third option is to use a credentials file which
|
|---|
| 62 | contains the plaintext of the username and password. This
|
|---|
| 63 | option is mainly provided for scripts where the admin does not
|
|---|
| 64 | wish to pass the credentials on the command line or via environment
|
|---|
| 65 | variables. If this method is used, make certain that the permissions
|
|---|
| 66 | on the file restrict access from unwanted users. See the
|
|---|
| 67 | <em class="parameter"><code>-A</code></em> for more details. </p><p>Be cautious about including passwords in scripts. Also, on
|
|---|
| 68 | many systems the command line of a running process may be seen
|
|---|
| 69 | via the <code class="literal">ps</code> command. To be safe always allow
|
|---|
| 70 | <code class="literal">rpcclient</code> to prompt for a password and type
|
|---|
| 71 | it in directly. </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
|
|---|
| 72 | </p></dd></dl></div></div><div class="refsect1" title="VERSION"><a name="id307072"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
|
|---|
| 73 | suite.</p></div><div class="refsect1" title="AUTHOR"><a name="id307082"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
|
|---|
| 74 | were created by Andrew Tridgell. Samba is now developed
|
|---|
| 75 | by the Samba Team as an Open Source project similar
|
|---|
| 76 | to the way the Linux kernel is developed.</p><p>The smbtree man page was written by Jelmer Vernooij. </p></div></div></body></html>
|
|---|
