Index Index for
Section 1
Index Alphabetical
listing for S
Bottom of page Bottom of
page		 

SMBTREE(1)


NAME

  smbtree - A text based smb network browser


SYNOPSIS

  smbtree [-b] [-D] [-S]


DESCRIPTION

  This tool is part of the samba(7) suite.

  smbtree is a smb browser program in text mode. It is similar to  the	"Net-
  work	Neighborhood"  found  on Windows computers. It prints a tree with all
  the known domains, the servers in those  domains  and	 the  shares  on  the
  servers.


OPTIONS

  -b   Query network nodes by  sending	requests  as  broadcasts  instead  of
       querying the local master browser.

  -D   Only print a list of all the domains known on broadcast or by the mas-
       ter browser

  -S   Only print a list of all the domains and servers responding on  broad-
       cast or known by the master browser.

  -V   Prints the program version number.

  -s <configuration file>
       The file specified contains the configuration details required by  the
       server. The information in this file includes server-specific informa-
       tion such as what printcap file to use, as well as descriptions of all
       the  services that the server is to provide. See smb.conf for more in-
       formation. The default configuration file name is determined  at	 com-
       pile time.

  -d|--debug=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 to the log files
       about  the  activities of the server. At level 0, only critical errors
       and serious warnings will be logged. Level 1 is a reasonable level for
       day-to-day  running - it generates a small amount of information about
       operations carried out.

       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  log
       data, most of which is extremely cryptic.

       Note that specifying this parameter here will override the   parameter
       in the smb.conf file.

  -l|--logfile=logdirectory
       Base directory name for log/debug  files.  The  extension  ".progname"
       will  be appended (e.g. log.smbclient, log.smbd, etc...). The log file
       is never removed by the client.

  -N   If specified, this parameter suppresses	the  normal  password  prompt
       from  the  client to the user. This is useful when accessing a service
       that does not require a password.

       Unless a password is specified on the command line or  this  parameter
       is specified, the client will request a password.

  -k   Try to authenticate with kerberos. Only useful in an Active  Directory
       environment.

  -A|--authentication-file=filename
       This option allows you to specify a file from which to read the	user-
       name and password used in the connection. The format of the file is

       username = <value>
       password = <value>
       domain	= <value>

       Make certain that the permissions on the	 file  restrict	 access	 from
       unwanted users.

  -U|--user=username[%password]
       Sets the SMB username or username and password.

       If %password is not specified, the user will be prompted.  The  client
       will first check the USER environment variable, then the LOGNAME vari-
       able and if either exists, the string is uppercased. If these environ-
       mental variables are not found, the username GUEST is used.

       A third option is to use a credentials file which contains the  plain-
       text  of the username and password. This option is mainly provided for
       scripts where the admin does not wish to pass the credentials  on  the
       command	line  or  via  environment variables. If this method is used,
       make certain that the permissions on the	 file  restrict	 access	 from
       unwanted users. See the -A for more details.

       Be cautious about including passwords in scripts. Also, on  many	 sys-
       tems the command line of a running process may be seen via the ps com-
       mand. To be safe always allow rpcclient to prompt for a	password  and
       type it in directly.

  -h|--help
       Print a summary of command line options.


VERSION

  This man page is correct for version 3.0 of the Samba suite.


AUTHOR

  The original Samba software and related utilities were  created  by  Andrew
  Tridgell.  Samba  is now developed by the Samba Team as an Open Source pro-
  ject similar to the way the Linux kernel is developed.

  The smbtree man page was written by Jelmer Vernooij.

Index Index for
Section 1
Index Alphabetical
listing for S
Top of page Top of
page