From 20967627378194121bc48bf387838b8bd7682478 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Tue, 18 Mar 2003 16:48:14 +0000 Subject: Regenerate (This used to be commit 25db62e3101dbcae8e9daee3cb16430297afa223) --- docs/htmldocs/smbclient.1.html | 404 ++++++++++++++++------------------------- 1 file changed, 152 insertions(+), 252 deletions(-) (limited to 'docs/htmldocs/smbclient.1.html') diff --git a/docs/htmldocs/smbclient.1.html b/docs/htmldocs/smbclient.1.html index 8ae4f84fe3..4a287acf1d 100644 --- a/docs/htmldocs/smbclient.1.html +++ b/docs/htmldocs/smbclient.1.html @@ -5,7 +5,7 @@ >smbclientsmbclient {servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan] [-k]

{servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan] [-k]

//server/service where where server - is the NetBIOS name of the SMB/CIFS server - offering the desired service and serviceservice is the name of the service offered. Thus to connect to the service "printer" on the SMB/CIFS server "smbserver", @@ -122,11 +118,9 @@ CLASS="FILENAME"

The server name is looked up according to either - the -R-R parameter to smbclient

The password required to access the specified service on the specified server. If this parameter is - supplied, the -N-N option (suppress password prompt) is assumed.

There is no default password. If no password is supplied on the command line (either by using this parameter or adding - a password to the -U-U option (see - below)) and the -N-N option is not specified, the client will prompt for a password, even if the desired service does not require one. (If no password is @@ -212,7 +200,7 @@ CLASS="REFENTRYTITLE" options.

-R <name resolve order>
-R <name resolve order>

This option is used by the programs in the Samba @@ -227,9 +215,9 @@ CLASS="REFENTRYTITLE" >

  • lmhostslmhosts: Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has no name type attached to the NetBIOS name (see @@ -244,9 +232,9 @@ CLASS="REFENTRYTITLE" >

  • hosthost: Do a standard host name to IP address resolution, using the system

  • winswins: Query a name with - the IP address listed in the wins serverwins server parameter. If no WINS server has been specified this method will be ignored.

  • bcastbcast: Do a broadcast on each of the known local interfaces listed in the - interfacesinterfaces parameter. This is the least reliable of the name resolution methods as it depends on the target host being on a locally @@ -307,12 +291,10 @@ CLASS="REFENTRYTITLE" (name resolve order) will be used.

    The default order is lmhosts, host, wins, bcast and without - this parameter or any entry in the name resolve order - parameter of the to the machine FRED.

    You may also find the You may also find the -U-U and - -I-I options useful, as they allow you to control the FROM and TO parts of the message.

    See the See the message commandmessage command parameter in the -d debuglevel

    debugleveldebuglevel is an integer from 0 to 10, or the letter 'A'.

    debugleveldebuglevel is set to the letter 'A', then -l logfilename

    If specified, If specified, logfilenamelogfilename specifies a base filename into which operational data from the running client will be logged.

    -I IP-address

    IP addressIP address is the address of the server to connect to. It should be specified in standard "a.b.c.d" notation.

    Normally the client would attempt to locate a named SMB/CIFS server by looking it up via the NetBIOS name resolution - mechanism described above in the name resolve ordername resolve order parameter above. Using this parameter will force the client to assume that the server is on the machine with the specified IP @@ -578,19 +544,19 @@ CLASS="PARAMETER" >

    Sets the SMB username or username and password. If %pass is not specified, The user will be prompted. The client - will first check the USERUSER environment variable, then the - LOGNAMELOGNAME variable and if either exists, the string is uppercased. Anything in these variables following a '%' sign will be treated as the password. If these environment - variables are not found, the username GUESTGUEST is used.

    smbclient will look for - a PASSWDPASSWD environment variable from which to read the password.

    -A-A for more details.

    Be cautious about including passwords in scripts or in - the PASSWDPASSWD environment variable. Also, on many systems the command line of a running process may be seen via the

    username = <value> 
    -password = <value>
    -domain = <value>
    username = <value> +password = <value> +domain = <value>

    If the domain parameter is missing the current workgroup name @@ -663,12 +627,10 @@ domain = <value>smbclient -L host and a list should appear. The and a list should appear. The -I - option may be useful if your NetBIOS names don't match your TCP/IP DNS host names or if you are trying to reach a host on another network.

    • cc - Create a tar file on UNIX. Must be followed by the name of a tar file, tape device or "-" for standard output. If using standard output you must turn the log level to its lowest value -d0 to avoid corrupting your tar file. This flag is mutually exclusive with the - xx flag.

    • xx - Extract (restore) a local tar file back to a share. Unless the -D option is given, the tar files will be restored from the top level of the share. Must be followed by the name of the tar file, device or "-" for standard - input. Mutually exclusive with the cc flag. Restored files have their creation times (mtime) set to the date saved in the tar file. Directories currently do not get @@ -787,11 +741,9 @@ CLASS="PARAMETER" >

    • II - Include files and directories. Is the default behavior when filenames are specified above. Causes tar files to be included in an extract or create (and therefore @@ -800,28 +752,22 @@ CLASS="PARAMETER" >

    • XX - Exclude files and directories. Causes tar files to be excluded from an extract or create. See example below. Filename globbing works in one of two ways now. - See rr below.

    • bb - Blocksize. Must be followed by a valid (greater than zero) blocksize. Causes tar file to be written out in blocksize*TBLOCK (usually 512 byte) blocks. @@ -829,38 +775,30 @@ CLASS="PARAMETER" >

    • gg - Incremental. Only back up files that have the archive bit set. Useful only with the - cc flag.

    • qq - Quiet. Keeps tar from printing diagnostics as it works. This is the same as tarmode quiet.

    • rr - Regular expression include or exclude. Uses regular expression matching for excluding or excluding files if compiled with HAVE_REGEX_H. @@ -870,41 +808,31 @@ CLASS="PARAMETER" >

    • NN - Newer than. Must be followed by the name of a file whose date is compared against files found on the share during a create. Only files newer than the file specified are backed up to the tar file. Useful only with the - cc flag.

    • aa - Set archive bit. Causes the archive bit to be reset when a file is backed up. Useful with the - g and g and cc flags.

    • command string is a semicolon-separated list of - commands to be executed instead of prompting from stdin. -N is implied by -N is implied by -c-c.

      This is particularly useful in scripts and for printing stdin @@ -1056,9 +980,9 @@ NAME="AEN336" >Once the client is running, the user is presented with a prompt :

      smb:\> smb:\>

      The backslash ("\\") indicates the current working directory @@ -1078,7 +1002,7 @@ CLASS="PROMPT" >

      Parameters shown in square brackets (e.g., "[parameter]") are optional. If not given, the command will use suitable defaults. Parameters - shown in angle brackets (e.g., "<parameter>") are required. + shown in angle brackets (e.g., "<parameter>") are required.

      Note that all commands operating on the server are actually @@ -1096,11 +1020,9 @@ CLASS="VARIABLELIST" >? [command]

      If If commandcommand is specified, the ? command will display a brief informative message about the specified command. If no command is specified, a list of available commands will @@ -1110,11 +1032,9 @@ CLASS="REPLACEABLE" >! [shell command]

      If If shell commandshell command is specified, the ! command will execute a shell locally and run the specified shell command. If no command is specified, a local shell will be run. @@ -1169,27 +1089,23 @@ CLASS="REPLACEABLE" directory on the server will be reported.

      del <mask>
      del <mask>

      The client will request that the server attempt - to delete all files matching maskmask from the current working directory on the server.

      dir <mask>
      dir <mask>

      A list of the files matching A list of the files matching maskmask in the current working directory on the server will be retrieved from the server and displayed.

      get <remote file name> [local file name]
      get <remote file name> [local file name]

      Copy the file called lcd [directory name]

      If If directory namedirectory name is specified, the current working directory on the local machine will be changed to the directory specified. This operation will fail if for any @@ -1267,13 +1181,13 @@ CLASS="REPLACEABLE" lowercase filenames are the norm on UNIX systems.

      ls <mask>
      ls <mask>

      See the dir command above.

      mask <mask>
      mask <mask>

      This command allows the user to set up a mask @@ -1299,28 +1213,24 @@ CLASS="REPLACEABLE" mask back to "*" after using the mget or mput commands.

      md <directory name>
      md <directory name>

      See the mkdir command.

      mget <mask>
      mget <mask>

      Copy all files matching Copy all files matching maskmask from the server to the machine running the client.

      Note that Note that maskmask is interpreted differently during recursive operation and non-recursive operation - refer to the recurse and mask commands for more information. Note that all transfers in @@ -1330,30 +1240,26 @@ CLASS="COMMAND" > are binary. See also the lowercase command.

      mkdir <directory name>
      mkdir <directory name>

      Create a new directory on the server (user access privileges permitting) with the specified name.

      mput <mask>
      mput <mask>

      Copy all files matching Copy all files matching maskmask in the current working directory on the local machine to the current working directory on the server.

      Note that Note that maskmask is interpreted differently during recursive operation and non-recursive operation - refer to the recurse and mask commands for more information. Note that all transfers in

      print <file name>
      print <file name>

      Print the specified file from the local machine @@ -1372,7 +1278,7 @@ CLASS="COMMAND" >See also the printmode command.

      printmode <graphics or text>
      printmode <graphics or text>

      Set the print mode to suit either binary data @@ -1392,7 +1298,7 @@ CLASS="COMMAND"

      put <local file name> [remote file name]
      put <local file name> [remote file name]

      Copy the file called See the exit command.

      rd <directory name>
      rd <directory name>

      See the rmdir command.

      rm <mask>
      rm <mask>

      Remove all files matching Remove all files matching maskmask from the current working directory on the server.

      rmdir <directory name>
      rmdir <directory name>

      Remove the specified directory (user access privileges permitting) from the server.

      setmode <filename> <perm=[+|\-]rsha>
      setmode <filename> <perm=[+|\-]rsha>

      A version of the DOS attrib command to set @@ -1493,15 +1397,13 @@ CLASS="COMMAND"

      tar <c|x>[IXbgNa]
      tar <c|x>[IXbgNa]

      Performs a tar operation - see the Performs a tar operation - see the -T - command line option above. Behavior may be affected by the tarmode command (see below). Using g (incremental) and N (newer) will affect tarmode settings. Note that using the "-" option @@ -1509,20 +1411,18 @@ CLASS="PARAMETER"

      blocksize <blocksize>
      blocksize <blocksize>

      Blocksize. Must be followed by a valid (greater than zero) blocksize. Causes tar file to be written out in - blocksizeblocksize*TBLOCK (usually 512 byte) blocks.

      tarmode <full|inc|reset|noreset>
      tarmode <full|inc|reset|noreset>

      Changes tar's behavior with regard to archive @@ -1564,25 +1464,25 @@ NAME="AEN532" >

      ENVIRONMENT VARIABLES

      The variable The variable USERUSER may contain the username of the person using the client. This information is used only if the protocol level is high enough to support session-level passwords.

      The variable The variable PASSWDPASSWD may contain the password of the person using the client. This information is used only if the protocol level is high enough to support session-level passwords.

      The variable The variable LIBSMB_PROGLIBSMB_PROG may contain the path, executed with system(), which the client should connect to instead of connecting to a server. This functionality is primarily -- cgit