summaryrefslogtreecommitdiff
path: root/docs/htmldocs/rpcclient.1.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/htmldocs/rpcclient.1.html')
-rw-r--r--docs/htmldocs/rpcclient.1.html200
1 files changed, 106 insertions, 94 deletions
diff --git a/docs/htmldocs/rpcclient.1.html b/docs/htmldocs/rpcclient.1.html
index 6e71ddeb14..e695663c8a 100644
--- a/docs/htmldocs/rpcclient.1.html
+++ b/docs/htmldocs/rpcclient.1.html
@@ -5,7 +5,7 @@
>rpcclient</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="RPCCLIENT.1"
+NAME="RPCCLIENT"
></A
>rpcclient</H1
><DIV
@@ -38,7 +38,7 @@ NAME="AEN8"
><B
CLASS="COMMAND"
>rpcclient</B
-> [-A authfile] [-c &#60;command string&#62;] [-d debuglevel] [-h] [-l logfile] [-N] [-s &#60;smb config file&#62;] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}</P
+> [-A authfile] [-c &lt;command string&gt;] [-d debuglevel] [-h] [-l logfile] [-N] [-s &lt;smb config file&gt;] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}</P
></DIV
><DIV
CLASS="REFSECT1"
@@ -48,12 +48,10 @@ NAME="AEN23"
><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
@@ -68,7 +66,7 @@ CLASS="COMMAND"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN31"
+NAME="AEN29"
></A
><H2
>OPTIONS</H2
@@ -86,16 +84,16 @@ CLASS="VARIABLELIST"
resolved using the <A
HREF="smb.conf.5.html#NAMERESOLVEORDER"
TARGET="_top"
-> <VAR
+> <TT
CLASS="PARAMETER"
->name resolve order</VAR
+><I
+>name resolve order</I
+></TT
></A
-> line from <SPAN
-CLASS="CITEREFENTRY"
-><SPAN
-CLASS="REFENTRYTITLE"
->smb.conf</SPAN
->(5)</SPAN
+> line from
+ <TT
+CLASS="FILENAME"
+>smb.conf(5)</TT
>.</P
></DD
><DT
@@ -109,9 +107,10 @@ CLASS="REFENTRYTITLE"
><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
>Make certain that the permissions on the file restrict
@@ -125,18 +124,14 @@ domain = &#60;value&#62;</PRE
below)) </P
></DD
><DT
->-h|--help</DT
-><DD
-><P
->Print a summary of command line options.</P
-></DD
-><DT
>-d|--debug=debuglevel</DT
><DD
><P
-><VAR
+><TT
CLASS="REPLACEABLE"
->debuglevel</VAR
+><I
+>debuglevel</I
+></TT
> is an integer
from 0 to 10. The default value if this parameter is
not specified is zero.</P
@@ -170,20 +165,30 @@ CLASS="FILENAME"
> file.</P
></DD
><DT
+>-h|--help</DT
+><DD
+><P
+>Print a summary of command line options.</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
@@ -199,9 +204,9 @@ CLASS="PARAMETER"
><DD
><P
>File name for log/debug files. The extension
- <CODE
+ <TT
CLASS="CONSTANT"
->'.client'</CODE
+>'.client'</TT
> will be appended. The log file is
never removed by the client.
</P
@@ -218,9 +223,11 @@ CLASS="COMMAND"
CLASS="COMMAND"
>rpcclient</B
> will
- prompt for a password. See also the <VAR
+ prompt for a password. See also the <TT
CLASS="PARAMETER"
->-U</VAR
+><I
+>-U</I
+></TT
>
option.</P
></DD
@@ -241,18 +248,18 @@ CLASS="FILENAME"
>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
+ client 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. If these environmental variables are not
- found, the username <CODE
+ found, the username <TT
CLASS="CONSTANT"
->GUEST</CODE
+>GUEST</TT
> is used. </P
><P
>A third option is to use a credentials file which
@@ -261,9 +268,11 @@ CLASS="CONSTANT"
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. Also, on
@@ -294,7 +303,7 @@ CLASS="COMMAND"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN111"
+NAME="AEN107"
></A
><H2
>COMMANDS</H2
@@ -429,7 +438,7 @@ CLASS="EMPHASIS"
><P
><B
CLASS="COMMAND"
->adddriver &#60;arch&#62; &#60;config&#62;</B
+>adddriver &lt;arch&gt; &lt;config&gt;</B
>
- Execute an AddPrinterDriver() RPC to install the printer driver
information on the server. Note that the driver files should
@@ -438,30 +447,35 @@ CLASS="COMMAND"
CLASS="COMMAND"
>getdriverdir</B
>. Possible values for
- <VAR
+ <TT
CLASS="PARAMETER"
->arch</VAR
+><I
+>arch</I
+></TT
> are the same as those for
the <B
CLASS="COMMAND"
>getdriverdir</B
> command.
- The <VAR
+ The <TT
CLASS="PARAMETER"
->config</VAR
+><I
+>config</I
+></TT
> parameter is defined as
follows: </P
><P
><PRE
CLASS="PROGRAMLISTING"
->Long Printer Name:\
-Driver File Name:\
-Data File Name:\
-Config File Name:\
-Help File Name:\
-Language Monitor Name:\
-Default Data Type:\
-Comma Separated list of Files</PRE
+> Long Printer Name:\
+ Driver File Name:\
+ Data File Name:\
+ Config File Name:\
+ Help File Name:\
+ Language Monitor Name:\
+ Default Data Type:\
+ Comma Separated list of Files
+ </PRE
></P
><P
>Any empty fields should be enter as the string "NULL". </P
@@ -477,8 +491,8 @@ Comma Separated list of Files</PRE
><P
><B
CLASS="COMMAND"
->addprinter &#60;printername&#62;
- &#60;sharename&#62; &#60;drivername&#62; &#60;port&#62;</B
+>addprinter &lt;printername&gt;
+ &lt;sharename&gt; &lt;drivername&gt; &lt;port&gt;</B
>
- Add a printer on the remote server. This printer
will be automatically shared. Be aware that the printer driver
@@ -486,9 +500,11 @@ CLASS="COMMAND"
CLASS="COMMAND"
>adddriver</B
>)
- and the <VAR
+ and the <TT
CLASS="PARAMETER"
->port</VAR
+><I
+>port</I
+></TT
>must be a valid port name (see
<B
CLASS="COMMAND"
@@ -522,7 +538,7 @@ CLASS="COMMAND"
><P
><B
CLASS="COMMAND"
->enumjobs &#60;printer&#62;</B
+>enumjobs &lt;printer&gt;</B
>
- List the jobs and status of a given printer.
This command corresponds to the MS Platform SDK EnumJobs()
@@ -564,7 +580,7 @@ CLASS="COMMAND"
><P
><B
CLASS="COMMAND"
->getdata &#60;printername&#62;</B
+>getdata &lt;printername&gt;</B
>
- Retrieve the data for a given printer setting. See
the <B
@@ -578,7 +594,7 @@ CLASS="COMMAND"
><P
><B
CLASS="COMMAND"
->getdriver &#60;printername&#62;</B
+>getdriver &lt;printername&gt;</B
>
- Retrieve the printer driver information (such as driver file,
config file, dependent files, etc...) for
@@ -590,14 +606,16 @@ CLASS="COMMAND"
><P
><B
CLASS="COMMAND"
->getdriverdir &#60;arch&#62;</B
+>getdriverdir &lt;arch&gt;</B
>
- Execute a GetPrinterDriverDirectory()
RPC to retrieve the SMB share name and subdirectory for
storing printer driver files for a given architecture. Possible
- values for <VAR
+ values for <TT
CLASS="PARAMETER"
->arch</VAR
+><I
+>arch</I
+></TT
> are "Windows 4.0"
(for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows
Alpha_AXP", and "Windows NT R4000". </P
@@ -606,7 +624,7 @@ CLASS="PARAMETER"
><P
><B
CLASS="COMMAND"
->getprinter &#60;printername&#62;</B
+>getprinter &lt;printername&gt;</B
>
- Retrieve the current printer information. This command
corresponds to the GetPrinter() MS Platform SDK function.
@@ -616,7 +634,7 @@ CLASS="COMMAND"
><P
><B
CLASS="COMMAND"
->openprinter &#60;printername&#62;</B
+>openprinter &lt;printername&gt;</B
>
- Execute an OpenPrinterEx() and ClosePrinter() RPC
against a given printer. </P
@@ -625,8 +643,8 @@ CLASS="COMMAND"
><P
><B
CLASS="COMMAND"
->setdriver &#60;printername&#62;
- &#60;drivername&#62;</B
+>setdriver &lt;printername&gt;
+ &lt;drivername&gt;</B
>
- Execute a SetPrinter() command to update the printer driver
associated with an installed printer. The printer driver must
@@ -687,7 +705,7 @@ CLASS="COMMAND"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN231"
+NAME="AEN227"
></A
><H2
>BUGS</H2
@@ -706,7 +724,7 @@ CLASS="COMMAND"
CLASS="emphasis"
><I
CLASS="EMPHASIS"
->WARNING!</I
+>"WARNING!</I
></SPAN
> The MSRPC over SMB code has
been developed from examining Network traces. No documentation is
@@ -716,28 +734,23 @@ CLASS="EMPHASIS"
to be... a bit flaky in places. </P
><P
>The development of Samba's implementation is also a bit rough,
- and as more of the services are understood, it can even result in
- versions of <SPAN
-CLASS="CITEREFENTRY"
-><SPAN
-CLASS="REFENTRYTITLE"
->smbd</SPAN
->(8)</SPAN
-> and <SPAN
-CLASS="CITEREFENTRY"
-><SPAN
-CLASS="REFENTRYTITLE"
->rpcclient</SPAN
->(1)</SPAN
-> that are incompatible for some commands or services. Additionally,
+ and as more of the services are understood, it can even result in
+ versions of <B
+CLASS="COMMAND"
+>smbd(8)</B
+> and <B
+CLASS="COMMAND"
+>rpcclient(1)</B
+>
+ that are incompatible for some commands or services. Additionally,
the developers are sending reports to Microsoft, and problems found
or reported to Microsoft are fixed in Service Packs, which may
- result in incompatibilities.</P
+ result in incompatibilities." </P
></DIV
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN245"
+NAME="AEN237"
></A
><H2
>VERSION</H2
@@ -748,7 +761,7 @@ NAME="AEN245"
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN248"
+NAME="AEN240"
></A
><H2
>AUTHOR</H2
@@ -761,8 +774,7 @@ NAME="AEN248"
>The original rpcclient man page was written by Matthew
Geddes, Luke Kenneth Casson Leighton, and rewritten by Gerald Carter.
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
+ Carter.</P
></DIV
></BODY
></HTML