summaryrefslogtreecommitdiff
path: root/docs/htmldocs/smbclient.1.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/htmldocs/smbclient.1.html')
-rw-r--r--docs/htmldocs/smbclient.1.html567
1 files changed, 312 insertions, 255 deletions
diff --git a/docs/htmldocs/smbclient.1.html b/docs/htmldocs/smbclient.1.html
index 4a287acf1d..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 &#60;buffer size&#62;] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M &#60;netbios name&#62;] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L &#60;netbios name&#62;] [-I destinationIP] [-E] [-c &#60;command string&#62;] [-i scope] [-O &#60;socket options&#62;] [-p port] [-R &#60;name resolve order&#62;] [-s &#60;smb config file&#62;] [-T&#60;c|x&#62;IXFqgbNan] [-k]</P
+> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L &lt;netbios name&gt;] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;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
@@ -175,13 +178,10 @@ CLASS="PARAMETER"
>-s smb.conf</DT
><DD
><P
->Specifies the location of the all
- important <SPAN
-CLASS="CITEREFENTRY"
-><SPAN
-CLASS="REFENTRYTITLE"
->smb.conf</SPAN
->(5)</SPAN
+>Specifies the location of the all important
+ <TT
+CLASS="FILENAME"
+>smb.conf</TT
> file. </P
></DD
><DT
@@ -189,18 +189,14 @@ CLASS="REFENTRYTITLE"
><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
+ 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 &#60;name resolve order&#62;</DT
+>-R &lt;name resolve order&gt;</DT
><DD
><P
>This option is used by the programs in the Samba
@@ -209,33 +205,30 @@ CLASS="REFENTRYTITLE"
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
@@ -252,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
@@ -281,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
@@ -336,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
@@ -417,9 +408,11 @@ CLASS="EMPHASIS"
>-d debuglevel</DT
><DD
><P
-><VAR
+><TT
CLASS="REPLACEABLE"
->debuglevel</VAR
+><I
+>debuglevel</I
+></TT
> is an integer from 0 to 10, or
the letter 'A'. </P
><P
@@ -437,9 +430,11 @@ CLASS="REPLACEABLE"
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 <VAR
+ cryptic. If <TT
CLASS="REPLACEABLE"
->debuglevel</VAR
+><I
+>debuglevel</I
+></TT
> is set to the letter 'A', then <SPAN
CLASS="emphasis"
><I
@@ -477,9 +472,11 @@ CLASS="FILENAME"
>-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
@@ -506,17 +503,21 @@ CLASS="FILENAME"
>-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
@@ -544,19 +545,19 @@ CLASS="PARAMETER"
><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 <VAR
+ will first check the <TT
CLASS="ENVAR"
->USER</VAR
+>USER</TT
> environment variable, then the
- <VAR
+ <TT
CLASS="ENVAR"
->LOGNAME</VAR
+>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 <CODE
+ variables are not found, the username <TT
CLASS="CONSTANT"
->GUEST</CODE
+>GUEST</TT
>
is used. </P
><P
@@ -565,9 +566,9 @@ CLASS="CONSTANT"
CLASS="COMMAND"
>smbclient</B
> will look for
- a <VAR
+ a <TT
CLASS="ENVAR"
->PASSWD</VAR
+>PASSWD</TT
> environment variable from which
to read the password. </P
><P
@@ -577,15 +578,17 @@ CLASS="ENVAR"
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
+ <TT
CLASS="PARAMETER"
->-A</VAR
+><I
+>-A</I
+></TT
> for more details. </P
><P
>Be cautious about including passwords in scripts or in
- the <VAR
+ the <TT
CLASS="ENVAR"
->PASSWD</VAR
+>PASSWD</TT
> environment variable. Also, on
many systems the command line of a running process may be seen
via the <B
@@ -609,9 +612,10 @@ CLASS="COMMAND"
><P
><PRE
CLASS="PROGRAMLISTING"
->username = &#60;value&#62;
-password = &#60;value&#62;
-domain = &#60;value&#62;</PRE
+>username = &lt;value&gt;
+password = &lt;value&gt;
+domain = &lt;value&gt;
+ </PRE
></P
><P
>If the domain parameter is missing the current workgroup name
@@ -627,10 +631,12 @@ domain = &#60;value&#62;</PRE
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
@@ -684,14 +690,12 @@ CLASS="COMMAND"
><DD
><P
>Override the default workgroup (domain) specified
- in the workgroup parameter of the <SPAN
-CLASS="CITEREFENTRY"
-><SPAN
-CLASS="REFENTRYTITLE"
->smb.conf</SPAN
->(5)</SPAN
-> file for this connection. This may be
- needed to connect to some servers. </P
+ in the workgroup parameter of the <TT
+CLASS="FILENAME"
+>smb.conf</TT
+>
+ file for this connection. This may be needed to connect to some
+ servers. </P
></DD
><DT
>-T tar options</DT
@@ -709,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
@@ -741,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
@@ -752,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.
@@ -775,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.
@@ -808,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
@@ -867,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
@@ -944,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
@@ -958,21 +1000,13 @@ CLASS="COMMAND"
>-c 'print -'</B
>. </P
></DD
-><DT
->-k</DT
-><DD
-><P
-> Try to authenticate with kerberos. Only useful in
- an Active Directory environment.
- </P
-></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN336"
+NAME="AEN310"
></A
><H2
>OPERATIONS</H2
@@ -980,12 +1014,12 @@ NAME="AEN336"
>Once the client is running, the user is presented with
a prompt : </P
><P
-><SAMP
+><TT
CLASS="PROMPT"
->smb:\&#62; </SAMP
+>smb:\&gt; </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
@@ -1002,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., "&#60;parameter&#62;") are required.
+ shown in angle brackets (e.g., "&lt;parameter&gt;") are required.
</P
><P
>Note that all commands operating on the server are actually
@@ -1020,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
@@ -1032,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.
@@ -1089,23 +1127,27 @@ CLASS="REPLACEABLE"
directory on the server will be reported. </P
></DD
><DT
->del &#60;mask&#62;</DT
+>del &lt;mask&gt;</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 &#60;mask&#62;</DT
+>dir &lt;mask&gt;</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
@@ -1118,7 +1160,7 @@ CLASS="REPLACEABLE"
from the program. </P
></DD
><DT
->get &#60;remote file name&#62; [local file name]</DT
+>get &lt;remote file name&gt; [local file name]</DT
><DD
><P
>Copy the file called <TT
@@ -1146,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
@@ -1181,13 +1225,13 @@ CLASS="REPLACEABLE"
lowercase filenames are the norm on UNIX systems. </P
></DD
><DT
->ls &#60;mask&#62;</DT
+>ls &lt;mask&gt;</DT
><DD
><P
>See the dir command above. </P
></DD
><DT
->mask &#60;mask&#62;</DT
+>mask &lt;mask&gt;</DT
><DD
><P
>This command allows the user to set up a mask
@@ -1213,24 +1257,28 @@ CLASS="REPLACEABLE"
mask back to "*" after using the mget or mput commands. </P
></DD
><DT
->md &#60;directory name&#62;</DT
+>md &lt;directory name&gt;</DT
><DD
><P
>See the mkdir command. </P
></DD
><DT
->mget &#60;mask&#62;</DT
+>mget &lt;mask&gt;</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
@@ -1240,26 +1288,30 @@ CLASS="COMMAND"
> are binary. See also the lowercase command. </P
></DD
><DT
->mkdir &#60;directory name&#62;</DT
+>mkdir &lt;directory name&gt;</DT
><DD
><P
>Create a new directory on the server (user access
privileges permitting) with the specified name. </P
></DD
><DT
->mput &#60;mask&#62;</DT
+>mput &lt;mask&gt;</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
@@ -1269,7 +1321,7 @@ CLASS="COMMAND"
are binary. </P
></DD
><DT
->print &#60;file name&#62;</DT
+>print &lt;file name&gt;</DT
><DD
><P
>Print the specified file from the local machine
@@ -1278,7 +1330,7 @@ CLASS="COMMAND"
>See also the printmode command.</P
></DD
><DT
->printmode &#60;graphics or text&#62;</DT
+>printmode &lt;graphics or text&gt;</DT
><DD
><P
>Set the print mode to suit either binary data
@@ -1298,7 +1350,7 @@ CLASS="COMMAND"
</P
></DD
><DT
->put &#60;local file name&#62; [remote file name]</DT
+>put &lt;local file name&gt; [remote file name]</DT
><DD
><P
>Copy the file called <TT
@@ -1330,7 +1382,7 @@ CLASS="COMMAND"
>See the exit command. </P
></DD
><DT
->rd &#60;directory name&#62;</DT
+>rd &lt;directory name&gt;</DT
><DD
><P
>See the rmdir command. </P
@@ -1355,24 +1407,26 @@ CLASS="COMMAND"
using the mask command will be ignored. </P
></DD
><DT
->rm &#60;mask&#62;</DT
+>rm &lt;mask&gt;</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 &#60;directory name&#62;</DT
+>rmdir &lt;directory name&gt;</DT
><DD
><P
>Remove the specified directory (user access
privileges permitting) from the server. </P
></DD
><DT
->setmode &#60;filename&#62; &#60;perm=[+|\-]rsha&#62;</DT
+>setmode &lt;filename&gt; &lt;perm=[+|\-]rsha&gt;</DT
><DD
><P
>A version of the DOS attrib command to set
@@ -1397,13 +1451,15 @@ CLASS="COMMAND"
</P
></DD
><DT
->tar &#60;c|x&#62;[IXbgNa]</DT
+>tar &lt;c|x&gt;[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
@@ -1411,18 +1467,20 @@ CLASS="PARAMETER"
</P
></DD
><DT
->blocksize &#60;blocksize&#62;</DT
+>blocksize &lt;blocksize&gt;</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 &#60;full|inc|reset|noreset&#62;</DT
+>tarmode &lt;full|inc|reset|noreset&gt;</DT
><DD
><P
>Changes tar's behavior with regard to archive
@@ -1438,7 +1496,7 @@ CLASS="REPLACEABLE"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN527"
+NAME="AEN501"
></A
><H2
>NOTES</H2
@@ -1459,30 +1517,30 @@ NAME="AEN527"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN532"
+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
@@ -1492,7 +1550,7 @@ CLASS="ENVAR"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN540"
+NAME="AEN514"
></A
><H2
>INSTALLATION</H2
@@ -1523,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
@@ -1536,7 +1592,7 @@ CLASS="REFENTRYTITLE"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN552"
+NAME="AEN524"
></A
><H2
>DIAGNOSTICS</H2
@@ -1552,17 +1608,18 @@ NAME="AEN552"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN556"
+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="AEN559"
+NAME="AEN531"
></A
><H2
>AUTHOR</H2
@@ -1574,14 +1631,14 @@ NAME="AEN559"
><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