diff options
Diffstat (limited to 'docs/htmldocs/smbclient.1.html')
| -rw-r--r-- | docs/htmldocs/smbclient.1.html | 924 |
1 files changed, 485 insertions, 439 deletions
diff --git a/docs/htmldocs/smbclient.1.html b/docs/htmldocs/smbclient.1.html index 9ea84de950..ca8cafd312 100644 --- a/docs/htmldocs/smbclient.1.html +++ b/docs/htmldocs/smbclient.1.html @@ -5,7 +5,7 @@ >smbclient</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD +CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" @@ -15,7 +15,7 @@ VLINK="#840084" ALINK="#0000FF" ><H1 ><A -NAME="SMBCLIENT.1" +NAME="SMBCLIENT" ></A >smbclient</H1 ><DIV @@ -38,22 +38,20 @@ NAME="AEN8" ><B CLASS="COMMAND" >smbclient</B -> {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]</P +> {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]</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN34" +NAME="AEN33" ></A ><H2 >DESCRIPTION</H2 ><P ->This tool is part of the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->Samba</SPAN ->(7)</SPAN +>This tool is part of the <A +HREF="samba.7.html" +TARGET="_top" +> Samba</A > suite.</P ><P ><B @@ -61,12 +59,9 @@ CLASS="COMMAND" >smbclient</B > is a client that can 'talk' to an SMB/CIFS server. It offers an interface - similar to that of the ftp program (see <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->ftp</SPAN ->(1)</SPAN + similar to that of the ftp program (see <B +CLASS="COMMAND" +>ftp(1)</B >). Operations include things like getting files from the server to the local machine, putting files from the local machine to @@ -76,7 +71,7 @@ CLASS="REFENTRYTITLE" ><DIV CLASS="REFSECT1" ><A -NAME="AEN45" +NAME="AEN40" ></A ><H2 >OPTIONS</H2 @@ -94,14 +89,18 @@ CLASS="VARIABLELIST" <TT CLASS="FILENAME" >//server/service</TT -> where <VAR +> where <TT CLASS="PARAMETER" +><I >server - </VAR + </I +></TT > is the NetBIOS name of the SMB/CIFS server - offering the desired service and <VAR + offering the desired service and <TT CLASS="PARAMETER" ->service</VAR +><I +>service</I +></TT > is the name of the service offered. Thus to connect to the service "printer" on the SMB/CIFS server "smbserver", @@ -118,20 +117,18 @@ CLASS="FILENAME" </P ><P >The server name is looked up according to either - the <VAR + the <TT CLASS="PARAMETER" ->-R</VAR +><I +>-R</I +></TT > parameter to <B CLASS="COMMAND" >smbclient</B > or - using the name resolve order parameter in - the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN + using the name resolve order parameter in the <TT +CLASS="FILENAME" +>smb.conf</TT > file, allowing an administrator to change the order and methods by which server names are looked up. </P @@ -142,21 +139,27 @@ CLASS="REFENTRYTITLE" ><P >The password required to access the specified service on the specified server. If this parameter is - supplied, the <VAR + supplied, the <TT CLASS="PARAMETER" ->-N</VAR +><I +>-N</I +></TT > option (suppress password prompt) is assumed. </P ><P >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 <VAR + a password to the <TT CLASS="PARAMETER" ->-U</VAR +><I +>-U</I +></TT > option (see - below)) and the <VAR + below)) and the <TT CLASS="PARAMETER" ->-N</VAR +><I +>-N</I +></TT > option is not specified, the client will prompt for a password, even if the desired service does not require one. (If no password is @@ -172,7 +175,28 @@ CLASS="PARAMETER" </P ></DD ><DT ->-R <name resolve order></DT +>-s smb.conf</DT +><DD +><P +>Specifies the location of the all important + <TT +CLASS="FILENAME" +>smb.conf</TT +> file. </P +></DD +><DT +>-O socket options</DT +><DD +><P +>TCP socket options to set on the client + socket. See the socket options parameter in the <TT +CLASS="FILENAME" +> smb.conf (5)</TT +> manpage for the list of valid + options. </P +></DD +><DT +>-R <name resolve order></DT ><DD ><P >This option is used by the programs in the Samba @@ -181,33 +205,30 @@ CLASS="PARAMETER" string of different name resolution options.</P ><P >The options are :"lmhosts", "host", "wins" and "bcast". They - cause names to be resolved as follows:</P + cause names to be resolved as follows :</P ><P ></P ><UL ><LI ><P -><CODE +><TT CLASS="CONSTANT" ->lmhosts</CODE ->: Lookup an IP +>lmhosts</TT +> : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has - no name type attached to the NetBIOS name (see - the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->lmhosts</SPAN ->(5)</SPAN + no name type attached to the NetBIOS name (see the <A +HREF="lmhosts.5.html" +TARGET="_top" +>lmhosts(5)</A > for details) then any name type matches for lookup.</P ></LI ><LI ><P -><CODE +><TT CLASS="CONSTANT" ->host</CODE ->: Do a standard host +>host</TT +> : Do a standard host name to IP address resolution, using the system <TT CLASS="FILENAME" >/etc/hosts @@ -224,27 +245,31 @@ CLASS="FILENAME" ></LI ><LI ><P -><CODE +><TT CLASS="CONSTANT" ->wins</CODE ->: Query a name with - the IP address listed in the <VAR +>wins</TT +> : Query a name with + the IP address listed in the <TT CLASS="PARAMETER" ->wins server</VAR +><I +>wins server</I +></TT > parameter. If no WINS server has been specified this method will be ignored.</P ></LI ><LI ><P -><CODE +><TT CLASS="CONSTANT" ->bcast</CODE ->: Do a broadcast on +>bcast</TT +> : Do a broadcast on each of the known local interfaces listed in the - <VAR + <TT CLASS="PARAMETER" ->interfaces</VAR +><I +>interfaces</I +></TT > parameter. This is the least reliable of the name resolution methods as it depends on the target host being on a locally @@ -253,26 +278,22 @@ CLASS="PARAMETER" ></UL ><P >If this parameter is not set then the name resolve order - defined in the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN + defined in the <TT +CLASS="FILENAME" +>smb.conf</TT > file parameter (name resolve order) will be used. </P ><P >The default order is lmhosts, host, wins, bcast and without - this parameter or any entry in the <VAR + this parameter or any entry in the <TT CLASS="PARAMETER" +><I >name resolve order - </VAR -> parameter of the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN + </I +></TT +> parameter of the <TT +CLASS="FILENAME" +>smb.conf</TT > file the name resolution methods will be attempted in this order. </P ></DD @@ -308,25 +329,23 @@ CLASS="FILENAME" > to the machine FRED. </P ><P ->You may also find the <VAR +>You may also find the <TT CLASS="PARAMETER" ->-U</VAR +><I +>-U</I +></TT > and - <VAR + <TT CLASS="PARAMETER" ->-I</VAR +><I +>-I</I +></TT > options useful, as they allow you to control the FROM and TO parts of the message. </P ><P ->See the <VAR -CLASS="PARAMETER" ->message command</VAR -> parameter in the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN +>See the message command parameter in the <TT +CLASS="FILENAME" +> smb.conf(5)</TT > for a description of how to handle incoming WinPopup messages in Samba. </P ><P @@ -341,6 +360,106 @@ CLASS="EMPHASIS" messages. </P ></DD ><DT +>-i scope</DT +><DD +><P +>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 <TT +CLASS="FILENAME" +>rfc1001.txt</TT +> + and <TT +CLASS="FILENAME" +>rfc1002.txt</TT +>. + NetBIOS scopes are <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>very</I +></SPAN +> rarely used, only set + this parameter if you are the system administrator in charge of all + the NetBIOS systems you communicate with. </P +></DD +><DT +>-N</DT +><DD +><P +>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. </P +><P +>Unless a password is specified on the command line or + this parameter is specified, the client will request a + password.</P +></DD +><DT +>-n NetBIOS name</DT +><DD +><P +>By default, the client will use the local + machine's hostname (in uppercase) as its NetBIOS name. This parameter + allows you to override the host name and use whatever NetBIOS + name you wish. </P +></DD +><DT +>-d debuglevel</DT +><DD +><P +><TT +CLASS="REPLACEABLE" +><I +>debuglevel</I +></TT +> is an integer from 0 to 10, or + the letter 'A'. </P +><P +>The default value if this parameter is not specified + is zero. </P +><P +>The higher this value, the more detail will be logged to + the log files about the activities of the + client. 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. </P +><P +>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. If <TT +CLASS="REPLACEABLE" +><I +>debuglevel</I +></TT +> is set to the letter 'A', then <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>all + </I +></SPAN +> debug messages will be printed. This setting + is for developers only (and people who <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>really</I +></SPAN +> want + to know how the code works internally). </P +><P +>Note that specifying this parameter here will override + the log level parameter in the <TT +CLASS="FILENAME" +>smb.conf (5)</TT +> + file. </P +></DD +><DT >-p port</DT ><DD ><P @@ -353,9 +472,11 @@ CLASS="EMPHASIS" >-l logfilename</DT ><DD ><P ->If specified, <VAR +>If specified, <TT CLASS="REPLACEABLE" ->logfilename</VAR +><I +>logfilename</I +></TT > specifies a base filename into which operational data from the running client will be logged. </P @@ -373,26 +494,30 @@ CLASS="FILENAME" </P ></DD ><DT ->-h|--help</DT +>-h</DT ><DD ><P ->Print a summary of command line options.</P +>Print the usage message for the client. </P ></DD ><DT >-I IP-address</DT ><DD ><P -><VAR +><TT CLASS="REPLACEABLE" ->IP address</VAR +><I +>IP address</I +></TT > is the address of the server to connect to. It should be specified in standard "a.b.c.d" notation. </P ><P >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 <VAR + mechanism described above in the <TT CLASS="PARAMETER" ->name resolve order</VAR +><I +>name resolve order</I +></TT > parameter above. Using this parameter will force the client to assume that the server is on the machine with the specified IP @@ -415,6 +540,89 @@ CLASS="PARAMETER" - typically the user's tty. </P ></DD ><DT +>-U username[%pass]</DT +><DD +><P +>Sets the SMB username or username and password. + If %pass is not specified, The user will be prompted. The client + will first check the <TT +CLASS="ENVAR" +>USER</TT +> environment variable, then the + <TT +CLASS="ENVAR" +>LOGNAME</TT +> 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 <TT +CLASS="CONSTANT" +>GUEST</TT +> + is used. </P +><P +>If the password is not included in these environment + variables (using the %pass syntax), <B +CLASS="COMMAND" +>smbclient</B +> will look for + a <TT +CLASS="ENVAR" +>PASSWD</TT +> environment variable from which + to read the password. </P +><P +>A third option is to use a credentials file which + contains the plaintext of the domain name, username and password. This + option is mainly provided for scripts where the admin doesn't + 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 + <TT +CLASS="PARAMETER" +><I +>-A</I +></TT +> for more details. </P +><P +>Be cautious about including passwords in scripts or in + the <TT +CLASS="ENVAR" +>PASSWD</TT +> environment variable. Also, on + many systems the command line of a running process may be seen + via the <B +CLASS="COMMAND" +>ps</B +> command to be safe always allow + <B +CLASS="COMMAND" +>smbclient</B +> to prompt for a password and type + it in directly. </P +></DD +><DT +>-A filename</DT +><DD +><P +>This option allows + you to specify a file from which to read the username, domain name, and + password used in the connection. The format of the file is + </P +><P +><PRE +CLASS="PROGRAMLISTING" +>username = <value> +password = <value> +domain = <value> + </PRE +></P +><P +>If the domain parameter is missing the current workgroup name + is used instead. Make certain that the permissions on the file restrict + access from unwanted users. </P +></DD +><DT >-L</DT ><DD ><P @@ -423,10 +631,12 @@ CLASS="PARAMETER" CLASS="COMMAND" >smbclient -L host</B -> and a list should appear. The <VAR +> and a list should appear. The <TT CLASS="PARAMETER" +><I >-I - </VAR + </I +></TT > 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. </P @@ -476,241 +686,16 @@ CLASS="COMMAND" </P ></DD ><DT ->-V</DT +>-W WORKGROUP</DT ><DD ><P ->Prints the version number for -<B -CLASS="COMMAND" ->smbd</B ->.</P -></DD -><DT ->-s <configuration file></DT -><DD -><P ->The file specified contains the -configuration details required by the server. The -information in this file includes server-specific -information such as what printcap file to use, as well -as descriptions of all the services that the server is -to provide. See <A -HREF="smb.conf.5.html" -TARGET="_top" -><TT -CLASS="FILENAME" ->smb.conf(5)</TT -></A -> for more information. -The default configuration file name is determined at -compile time.</P -></DD -><DT ->-d|--debug=debuglevel</DT -><DD -><P -><VAR -CLASS="REPLACEABLE" ->debuglevel</VAR -> is an integer -from 0 to 10. The default value if this parameter is -not specified is zero.</P -><P ->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.</P -><P ->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.</P -><P ->Note that specifying this parameter here will -override the <A -HREF="smb.conf.5.html#loglevel" -TARGET="_top" ->log -level</A -> parameter in the <A -HREF="smb.conf.5.html" -TARGET="_top" -><TT +>Override the default workgroup (domain) specified + in the workgroup parameter of the <TT CLASS="FILENAME" ->smb.conf(5)</TT -></A -> file.</P -></DD -><DT ->-l|--logfile=logbasename</DT -><DD -><P ->File name for log/debug files. The extension -<CODE -CLASS="CONSTANT" ->".client"</CODE -> will be appended. The log file is -never removed by the client.</P -></DD -><DT ->-N</DT -><DD -><P ->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. </P -><P ->Unless a password is specified on the command line or -this parameter is specified, the client will request a -password.</P -></DD -><DT ->-k</DT -><DD -><P ->Try to authenticate with kerberos. Only useful in -an Active Directory environment.</P -></DD -><DT ->-A|--authfile=filename</DT -><DD -><P ->This option allows -you to specify a file from which to read the username and -password used in the connection. The format of the file is</P -><P -><PRE -CLASS="PROGRAMLISTING" ->username = <value> -password = <value> -domain = <value></PRE -></P -><P ->Make certain that the permissions on the file restrict -access from unwanted users. </P -></DD -><DT ->-U|--user=username[%password]</DT -><DD -><P ->Sets the SMB username or username and password. </P -><P ->If %password is not specified, the user will be prompted. The -client will first check the <VAR -CLASS="ENVAR" ->USER</VAR -> environment variable, then the -<VAR -CLASS="ENVAR" ->LOGNAME</VAR -> variable and if either exists, the -string is uppercased. If these environmental variables are not -found, the username <CODE -CLASS="CONSTANT" ->GUEST</CODE -> is used. </P -><P ->A third option is to use a credentials file which -contains the plaintext 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 -<VAR -CLASS="PARAMETER" ->-A</VAR -> for more details. </P -><P ->Be cautious about including passwords in scripts. Also, on -many systems the command line of a running process may be seen -via the <B -CLASS="COMMAND" ->ps</B -> command. To be safe always allow -<B -CLASS="COMMAND" ->rpcclient</B -> to prompt for a password and type -it in directly. </P -></DD -><DT ->-n <primary NetBIOS name></DT -><DD -><P ->This option allows you to override -the NetBIOS name that Samba uses for itself. This is identical -to setting the <A -HREF="smb.conf.5.html#netbiosname" -TARGET="_top" -><VAR -CLASS="PARAMETER" ->NetBIOS -name</VAR -></A -> parameter in the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN -> file. However, a command -line setting will take precedence over settings in -<SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN ->.</P -></DD -><DT ->-i <scope></DT -><DD -><P ->This specifies a NetBIOS scope that -<B -CLASS="COMMAND" ->nmblookup</B -> 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 -<SPAN -CLASS="emphasis" -><I -CLASS="EMPHASIS" ->very</I -></SPAN -> rarely used, only set this parameter -if you are the system administrator in charge of all the -NetBIOS systems you communicate with.</P -></DD -><DT ->-W|--workgroup=domain</DT -><DD -><P ->Set the SMB domain of the username. This -overrides the default domain which is the domain defined in -smb.conf. If the domain specified is the same as the servers -NetBIOS name, it causes the client to log on using the servers local -SAM (as opposed to the Domain SAM). </P -></DD -><DT ->-O socket options</DT -><DD -><P ->TCP socket options to set on the client -socket. See the socket options parameter in -the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN -> manual page for the list of valid -options. </P +>smb.conf</TT +> + file for this connection. This may be needed to connect to some + servers. </P ></DD ><DT >-T tar options</DT @@ -728,31 +713,39 @@ CLASS="COMMAND" ><UL ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->c</VAR +><I +>c</I +></TT > - 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 - <VAR + <TT CLASS="PARAMETER" ->x</VAR +><I +>x</I +></TT > flag. </P ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->x</VAR +><I +>x</I +></TT > - 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 <VAR + input. Mutually exclusive with the <TT CLASS="PARAMETER" ->c</VAR +><I +>c</I +></TT > flag. Restored files have their creation times (mtime) set to the date saved in the tar file. Directories currently do not get @@ -760,9 +753,11 @@ CLASS="PARAMETER" ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->I</VAR +><I +>I</I +></TT > - 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 @@ -771,22 +766,28 @@ CLASS="PARAMETER" ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->X</VAR +><I +>X</I +></TT > - 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 <VAR + See <TT CLASS="PARAMETER" ->r</VAR +><I +>r</I +></TT > below. </P ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->b</VAR +><I +>b</I +></TT > - 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. @@ -794,30 +795,38 @@ CLASS="PARAMETER" ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->g</VAR +><I +>g</I +></TT > - Incremental. Only back up files that have the archive bit set. Useful only with the - <VAR + <TT CLASS="PARAMETER" ->c</VAR +><I +>c</I +></TT > flag. </P ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->q</VAR +><I +>q</I +></TT > - Quiet. Keeps tar from printing diagnostics as it works. This is the same as tarmode quiet. </P ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->r</VAR +><I +>r</I +></TT > - Regular expression include or exclude. Uses regular expression matching for excluding or excluding files if compiled with HAVE_REGEX_H. @@ -827,31 +836,41 @@ CLASS="PARAMETER" ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->N</VAR +><I +>N</I +></TT > - 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 - <VAR + <TT CLASS="PARAMETER" ->c</VAR +><I +>c</I +></TT > flag. </P ></LI ><LI ><P -><VAR +><TT CLASS="PARAMETER" ->a</VAR +><I +>a</I +></TT > - Set archive bit. Causes the archive bit to be reset when a file is backed up. Useful with the - <VAR + <TT CLASS="PARAMETER" ->g</VAR -> and <VAR +><I +>g</I +></TT +> and <TT CLASS="PARAMETER" ->c</VAR +><I +>c</I +></TT > flags. </P ></LI @@ -886,7 +905,7 @@ CLASS="EMPHASIS" ></SPAN ></P ><P ->All file names can be given as DOS path names (with '\\' +>All file names can be given as DOS path names (with '\' as the component separator) or as UNIX path names (with '/' as the component separator). </P ><P @@ -963,12 +982,16 @@ CLASS="COMMAND" ><DD ><P >command string is a semicolon-separated list of - commands to be executed instead of prompting from stdin. <VAR + commands to be executed instead of prompting from stdin. <TT CLASS="PARAMETER" -> -N</VAR -> is implied by <VAR +><I +> -N</I +></TT +> is implied by <TT CLASS="PARAMETER" ->-c</VAR +><I +>-c</I +></TT >.</P ><P >This is particularly useful in scripts and for printing stdin @@ -983,7 +1006,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN344" +NAME="AEN310" ></A ><H2 >OPERATIONS</H2 @@ -991,12 +1014,12 @@ NAME="AEN344" >Once the client is running, the user is presented with a prompt : </P ><P -><SAMP +><TT CLASS="PROMPT" ->smb:\> </SAMP +>smb:\> </TT ></P ><P ->The backslash ("\\") indicates the current working directory +>The backslash ("\") indicates the current working directory on the server, and will change if the current working directory is changed. </P ><P @@ -1013,7 +1036,7 @@ CLASS="PROMPT" ><P >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. </P ><P >Note that all commands operating on the server are actually @@ -1031,9 +1054,11 @@ CLASS="VARIABLELIST" >? [command]</DT ><DD ><P ->If <VAR +>If <TT CLASS="REPLACEABLE" ->command</VAR +><I +>command</I +></TT > 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 @@ -1043,9 +1068,11 @@ CLASS="REPLACEABLE" >! [shell command]</DT ><DD ><P ->If <VAR +>If <TT CLASS="REPLACEABLE" ->shell command</VAR +><I +>shell command</I +></TT > 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. @@ -1100,23 +1127,27 @@ CLASS="REPLACEABLE" directory on the server will be reported. </P ></DD ><DT ->del <mask></DT +>del <mask></DT ><DD ><P >The client will request that the server attempt - to delete all files matching <VAR + to delete all files matching <TT CLASS="REPLACEABLE" ->mask</VAR +><I +>mask</I +></TT > from the current working directory on the server. </P ></DD ><DT ->dir <mask></DT +>dir <mask></DT ><DD ><P ->A list of the files matching <VAR +>A list of the files matching <TT CLASS="REPLACEABLE" ->mask</VAR +><I +>mask</I +></TT > in the current working directory on the server will be retrieved from the server and displayed. </P @@ -1129,7 +1160,7 @@ CLASS="REPLACEABLE" from the program. </P ></DD ><DT ->get <remote file name> [local file name]</DT +>get <remote file name> [local file name]</DT ><DD ><P >Copy the file called <TT @@ -1157,9 +1188,11 @@ CLASS="COMMAND" >lcd [directory name]</DT ><DD ><P ->If <VAR +>If <TT CLASS="REPLACEABLE" ->directory name</VAR +><I +>directory name</I +></TT > is specified, the current working directory on the local machine will be changed to the directory specified. This operation will fail if for any @@ -1192,13 +1225,13 @@ CLASS="REPLACEABLE" lowercase filenames are the norm on UNIX systems. </P ></DD ><DT ->ls <mask></DT +>ls <mask></DT ><DD ><P >See the dir command above. </P ></DD ><DT ->mask <mask></DT +>mask <mask></DT ><DD ><P >This command allows the user to set up a mask @@ -1224,24 +1257,28 @@ CLASS="REPLACEABLE" mask back to "*" after using the mget or mput commands. </P ></DD ><DT ->md <directory name></DT +>md <directory name></DT ><DD ><P >See the mkdir command. </P ></DD ><DT ->mget <mask></DT +>mget <mask></DT ><DD ><P ->Copy all files matching <VAR +>Copy all files matching <TT CLASS="REPLACEABLE" ->mask</VAR +><I +>mask</I +></TT > from the server to the machine running the client. </P ><P ->Note that <VAR +>Note that <TT CLASS="REPLACEABLE" ->mask</VAR +><I +>mask</I +></TT > 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 @@ -1251,26 +1288,30 @@ CLASS="COMMAND" > are binary. See also the lowercase command. </P ></DD ><DT ->mkdir <directory name></DT +>mkdir <directory name></DT ><DD ><P >Create a new directory on the server (user access privileges permitting) with the specified name. </P ></DD ><DT ->mput <mask></DT +>mput <mask></DT ><DD ><P ->Copy all files matching <VAR +>Copy all files matching <TT CLASS="REPLACEABLE" ->mask</VAR +><I +>mask</I +></TT > in the current working directory on the local machine to the current working directory on the server. </P ><P ->Note that <VAR +>Note that <TT CLASS="REPLACEABLE" ->mask</VAR +><I +>mask</I +></TT > 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 <B @@ -1280,7 +1321,7 @@ CLASS="COMMAND" are binary. </P ></DD ><DT ->print <file name></DT +>print <file name></DT ><DD ><P >Print the specified file from the local machine @@ -1289,7 +1330,7 @@ CLASS="COMMAND" >See also the printmode command.</P ></DD ><DT ->printmode <graphics or text></DT +>printmode <graphics or text></DT ><DD ><P >Set the print mode to suit either binary data @@ -1309,7 +1350,7 @@ CLASS="COMMAND" </P ></DD ><DT ->put <local file name> [remote file name]</DT +>put <local file name> [remote file name]</DT ><DD ><P >Copy the file called <TT @@ -1341,7 +1382,7 @@ CLASS="COMMAND" >See the exit command. </P ></DD ><DT ->rd <directory name></DT +>rd <directory name></DT ><DD ><P >See the rmdir command. </P @@ -1366,24 +1407,26 @@ CLASS="COMMAND" using the mask command will be ignored. </P ></DD ><DT ->rm <mask></DT +>rm <mask></DT ><DD ><P ->Remove all files matching <VAR +>Remove all files matching <TT CLASS="REPLACEABLE" ->mask</VAR +><I +>mask</I +></TT > from the current working directory on the server. </P ></DD ><DT ->rmdir <directory name></DT +>rmdir <directory name></DT ><DD ><P >Remove the specified directory (user access privileges permitting) from the server. </P ></DD ><DT ->setmode <filename> <perm=[+|\-]rsha></DT +>setmode <filename> <perm=[+|\-]rsha></DT ><DD ><P >A version of the DOS attrib command to set @@ -1408,13 +1451,15 @@ CLASS="COMMAND" </P ></DD ><DT ->tar <c|x>[IXbgNa]</DT +>tar <c|x>[IXbgNa]</DT ><DD ><P ->Performs a tar operation - see the <VAR +>Performs a tar operation - see the <TT CLASS="PARAMETER" +><I >-T - </VAR + </I +></TT > 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 @@ -1422,18 +1467,20 @@ CLASS="PARAMETER" </P ></DD ><DT ->blocksize <blocksize></DT +>blocksize <blocksize></DT ><DD ><P >Blocksize. Must be followed by a valid (greater than zero) blocksize. Causes tar file to be written out in - <VAR + <TT CLASS="REPLACEABLE" ->blocksize</VAR +><I +>blocksize</I +></TT >*TBLOCK (usually 512 byte) blocks. </P ></DD ><DT ->tarmode <full|inc|reset|noreset></DT +>tarmode <full|inc|reset|noreset></DT ><DD ><P >Changes tar's behavior with regard to archive @@ -1449,7 +1496,7 @@ CLASS="REPLACEABLE" ><DIV CLASS="REFSECT1" ><A -NAME="AEN535" +NAME="AEN501" ></A ><H2 >NOTES</H2 @@ -1470,30 +1517,30 @@ NAME="AEN535" ><DIV CLASS="REFSECT1" ><A -NAME="AEN540" +NAME="AEN506" ></A ><H2 >ENVIRONMENT VARIABLES</H2 ><P ->The variable <VAR +>The variable <TT CLASS="ENVAR" ->USER</VAR +>USER</TT > 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.</P ><P ->The variable <VAR +>The variable <TT CLASS="ENVAR" ->PASSWD</VAR +>PASSWD</TT > 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. </P ><P ->The variable <VAR +>The variable <TT CLASS="ENVAR" ->LIBSMB_PROG</VAR +>LIBSMB_PROG</TT > may contain the path, executed with system(), which the client should connect to instead of connecting to a server. This functionality is primarily @@ -1503,7 +1550,7 @@ CLASS="ENVAR" ><DIV CLASS="REFSECT1" ><A -NAME="AEN548" +NAME="AEN514" ></A ><H2 >INSTALLATION</H2 @@ -1534,12 +1581,10 @@ CLASS="EMPHASIS" and writeable only by the user. </P ><P >To test the client, you will need to know the name of a - running SMB/CIFS server. It is possible to run <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbd</SPAN ->(8)</SPAN + running SMB/CIFS server. It is possible to run <B +CLASS="COMMAND" +>smbd(8) + </B > as an ordinary user - running that server as a daemon on a user-accessible port (typically any port number over 1024) would provide a suitable test server. </P @@ -1547,7 +1592,7 @@ CLASS="REFENTRYTITLE" ><DIV CLASS="REFSECT1" ><A -NAME="AEN560" +NAME="AEN524" ></A ><H2 >DIAGNOSTICS</H2 @@ -1563,17 +1608,18 @@ NAME="AEN560" ><DIV CLASS="REFSECT1" ><A -NAME="AEN564" +NAME="AEN528" ></A ><H2 >VERSION</H2 ><P ->This man page is correct for version 2.2 of the Samba suite.</P +>This man page is correct for version 2.2 of + the Samba suite.</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN567" +NAME="AEN531" ></A ><H2 >AUTHOR</H2 @@ -1585,14 +1631,14 @@ NAME="AEN567" ><P >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, available at <A + excellent piece of Open Source software, available at + <A HREF="ftp://ftp.icce.rug.nl/pub/unix/" TARGET="_top" > ftp://ftp.icce.rug.nl/pub/unix/</A >) and updated for the Samba 2.0 release by Jeremy Allison. The conversion to DocBook for - Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0 - was done by Alexander Bokovoy.</P + Samba 2.2 was done by Gerald Carter</P ></DIV ></BODY ></HTML |