diff options
author | Jelmer Vernooij <jelmer@samba.org> | 2003-03-24 14:14:10 +0000 |
---|---|---|
committer | Jelmer Vernooij <jelmer@samba.org> | 2003-03-24 14:14:10 +0000 |
commit | e5ae6d548ff3c11a1be5ce3509da278b09994a34 (patch) | |
tree | a029925c7ca8a04c269beb6e73c2d9afd7d7170d /docs/docbook/manpages/smbclient.1.sgml | |
parent | 9ae249c6f10d3d548a6f1f19b34acf27e237f638 (diff) | |
download | samba-e5ae6d548ff3c11a1be5ce3509da278b09994a34.tar.gz samba-e5ae6d548ff3c11a1be5ce3509da278b09994a34.tar.bz2 samba-e5ae6d548ff3c11a1be5ce3509da278b09994a34.zip |
Document common arguments with entities
(This used to be commit adafcbb9af4a22db0fefb70966564d8591b5baed)
Diffstat (limited to 'docs/docbook/manpages/smbclient.1.sgml')
-rw-r--r-- | docs/docbook/manpages/smbclient.1.sgml | 167 |
1 files changed, 7 insertions, 160 deletions
diff --git a/docs/docbook/manpages/smbclient.1.sgml b/docs/docbook/manpages/smbclient.1.sgml index a08f6999e4..cd513398b9 100644 --- a/docs/docbook/manpages/smbclient.1.sgml +++ b/docs/docbook/manpages/smbclient.1.sgml @@ -1,4 +1,6 @@ -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ +<!ENTITY % globalentities SYSTEM '../global.ent'> %globalentities; +]> <refentry id="smbclient.1"> <refmeta> @@ -116,23 +118,6 @@ </varlistentry> <varlistentry> - <term>-s smb.conf</term> - <listitem><para>Specifies the location of the all - important <citerefentry><refentrytitle>smb.conf</refentrytitle> - <manvolnum>5</manvolnum></citerefentry> file. </para></listitem> - </varlistentry> - - <varlistentry> - <term>-O socket options</term> - <listitem><para>TCP socket options to set on the client - socket. See the socket options parameter in - the <citerefentry><refentrytitle>smb.conf</refentrytitle> - <manvolnum>5</manvolnum></citerefentry> manual page for the list of valid - options. </para></listitem> - </varlistentry> - - - <varlistentry> <term>-R <name resolve order></term> <listitem><para>This option is used by the programs in the Samba suite to determine what naming services and in what order to resolve @@ -225,70 +210,6 @@ </varlistentry> <varlistentry> - <term>-i scope</term> - <listitem><para>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 <filename>rfc1001.txt</filename> - and <filename>rfc1002.txt</filename>. - NetBIOS scopes are <emphasis>very</emphasis> rarely used, only set - this parameter if you are the system administrator in charge of all - the NetBIOS systems you communicate with. </para></listitem> - </varlistentry> - - - <varlistentry> - <term>-N</term> - <listitem><para>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. </para> - - <para>Unless a password is specified on the command line or - this parameter is specified, the client will request a - password.</para></listitem> - </varlistentry> - - - - <varlistentry> - <term>-n NetBIOS name</term> - <listitem><para>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. </para></listitem> - </varlistentry> - - - <varlistentry> - <term>-d debuglevel</term> - <listitem><para><replaceable>debuglevel</replaceable> is an integer from 0 to 10, or - the letter 'A'. </para> - - <para>The default value if this parameter is not specified - is zero. </para> - - <para>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. </para> - - <para>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 <replaceable>debuglevel</replaceable> is set to the letter 'A', then <emphasis>all - </emphasis> debug messages will be printed. This setting - is for developers only (and people who <emphasis>really</emphasis> want - to know how the code works internally). </para> - - <para>Note that specifying this parameter here will override - the log level parameter in the <filename>smb.conf (5)</filename> - file. </para></listitem> - </varlistentry> - - - <varlistentry> <term>-p port</term> <listitem><para>This number is the TCP port number that will be used when making connections to the server. The standard (well-known) @@ -314,13 +235,7 @@ </varlistentry> - - <varlistentry> - <term>-h</term><listitem> - <para>Print the usage message for the client. </para></listitem> - </varlistentry> - - + &stdarg.help; <varlistentry> <term>-I IP-address</term> @@ -354,59 +269,6 @@ <varlistentry> - <term>-U username[%pass]</term> - <listitem><para>Sets the SMB username or username and password. - If %pass is not specified, The user will be prompted. The client - will first check the <envar>USER</envar> environment variable, then the - <envar>LOGNAME</envar> 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 <constant>GUEST</constant> - is used. </para> - - <para>If the password is not included in these environment - variables (using the %pass syntax), <command>smbclient</command> will look for - a <envar>PASSWD</envar> environment variable from which - to read the password. </para> - - <para>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 - <parameter>-A</parameter> for more details. </para> - - <para>Be cautious about including passwords in scripts or in - the <envar>PASSWD</envar> environment variable. Also, on - many systems the command line of a running process may be seen - via the <command>ps</command> command to be safe always allow - <command>smbclient</command> to prompt for a password and type - it in directly. </para></listitem> - </varlistentry> - - - <varlistentry> - <term>-A filename</term><listitem><para>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 - </para> - -<para><programlisting> -username = <value> -password = <value> -domain = <value> -</programlisting></para> - - - <para>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. </para></listitem> - </varlistentry> - - - - <varlistentry> <term>-L</term> <listitem><para>This option allows you to look at what services are available on a server. You use it as <command>smbclient -L @@ -443,16 +305,9 @@ domain = <value> </para></listitem> </varlistentry> - - - <varlistentry> - <term>-W WORKGROUP</term> - <listitem><para>Override the default workgroup (domain) specified - in the workgroup parameter of the <citerefentry><refentrytitle>smb.conf</refentrytitle> - <manvolnum>5</manvolnum></citerefentry> file for this connection. This may be - needed to connect to some servers. </para></listitem> - </varlistentry> - + &popt.common.samba; + &popt.common.credentials; + &popt.common.connection; <varlistentry> <term>-T tar options</term> @@ -588,14 +443,6 @@ domain = <value> <para>This is particularly useful in scripts and for printing stdin to the server, e.g. <command>-c 'print -'</command>. </para></listitem> </varlistentry> - - <varlistentry> - <term>-k</term> - <listitem><para> - Try to authenticate with kerberos. Only useful in - an Active Directory environment. - </para></listitem> - </varlistentry> </variablelist> </refsect1> |