mirror of
https://github.com/samba-team/samba.git
synced 2025-02-22 05:57:43 +03:00
1186 lines
20 KiB
HTML
1186 lines
20 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>rpcclient</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
|
|
><BODY
|
|
CLASS="REFENTRY"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><H1
|
|
><A
|
|
NAME="RPCCLIENT.1"
|
|
></A
|
|
>rpcclient</H1
|
|
><DIV
|
|
CLASS="REFNAMEDIV"
|
|
><A
|
|
NAME="AEN5"
|
|
></A
|
|
><H2
|
|
>Name</H2
|
|
>rpcclient -- tool for executing client side
|
|
MS-RPC functions</DIV
|
|
><DIV
|
|
CLASS="REFSYNOPSISDIV"
|
|
><A
|
|
NAME="AEN8"
|
|
></A
|
|
><H2
|
|
>Synopsis</H2
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>rpcclient</B
|
|
> [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN23"
|
|
></A
|
|
><H2
|
|
>DESCRIPTION</H2
|
|
><P
|
|
>This tool is part of the <SPAN
|
|
CLASS="CITEREFENTRY"
|
|
><SPAN
|
|
CLASS="REFENTRYTITLE"
|
|
>Samba</SPAN
|
|
>(7)</SPAN
|
|
> suite.</P
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>rpcclient</B
|
|
> is a utility initially developed
|
|
to test MS-RPC functionality in Samba itself. It has undergone
|
|
several stages of development and stability. Many system administrators
|
|
have now written scripts around it to manage Windows NT clients from
|
|
their UNIX workstation. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN31"
|
|
></A
|
|
><H2
|
|
>OPTIONS</H2
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>server</DT
|
|
><DD
|
|
><P
|
|
>NetBIOS name of Server to which to connect.
|
|
The server can be any SMB/CIFS server. The name is
|
|
resolved using the <A
|
|
HREF="smb.conf.5.html#NAMERESOLVEORDER"
|
|
TARGET="_top"
|
|
> <VAR
|
|
CLASS="PARAMETER"
|
|
>name resolve order</VAR
|
|
></A
|
|
> line from <SPAN
|
|
CLASS="CITEREFENTRY"
|
|
><SPAN
|
|
CLASS="REFENTRYTITLE"
|
|
>smb.conf</SPAN
|
|
>(5)</SPAN
|
|
>.</P
|
|
></DD
|
|
><DT
|
|
>-c|--command='command string'</DT
|
|
><DD
|
|
><P
|
|
>execute semicolon separated commands (listed
|
|
below)) </P
|
|
></DD
|
|
><DT
|
|
>-I IP-address</DT
|
|
><DD
|
|
><P
|
|
><VAR
|
|
CLASS="REPLACEABLE"
|
|
>IP address</VAR
|
|
> 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
|
|
CLASS="PARAMETER"
|
|
>name resolve order</VAR
|
|
>
|
|
parameter above. Using this parameter will force the client
|
|
to assume that the server is on the machine with the specified IP
|
|
address and the NetBIOS name component of the resource being
|
|
connected to will be ignored. </P
|
|
><P
|
|
>There is no default for this parameter. If not supplied,
|
|
it will be determined automatically by the client as described
|
|
above. </P
|
|
></DD
|
|
><DT
|
|
>-V</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
|
|
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
|
|
></DD
|
|
><DT
|
|
>-h|--help</DT
|
|
><DD
|
|
><P
|
|
>Print a summary of command line options.</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN144"
|
|
></A
|
|
><H2
|
|
>COMMANDS</H2
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN146"
|
|
></A
|
|
><H3
|
|
>LSARPC</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>lsaquery</DT
|
|
><DD
|
|
><P
|
|
>Query info policy</P
|
|
></DD
|
|
><DT
|
|
>lookupsids</DT
|
|
><DD
|
|
><P
|
|
>Resolve a list
|
|
of SIDs to usernames.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>lookupnames</DT
|
|
><DD
|
|
><P
|
|
>Resolve a list
|
|
of usernames to SIDs.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>enumtrusts</DT
|
|
><DD
|
|
><P
|
|
>Enumerate trusted domains</P
|
|
></DD
|
|
><DT
|
|
>enumprivs</DT
|
|
><DD
|
|
><P
|
|
>Enumerate privileges</P
|
|
></DD
|
|
><DT
|
|
>getdispname</DT
|
|
><DD
|
|
><P
|
|
>Get the privilege name</P
|
|
></DD
|
|
><DT
|
|
>lsaenumsid</DT
|
|
><DD
|
|
><P
|
|
>Enumerate the LSA SIDS</P
|
|
></DD
|
|
><DT
|
|
>lsaenumprivsaccount</DT
|
|
><DD
|
|
><P
|
|
>Enumerate the privileges of an SID</P
|
|
></DD
|
|
><DT
|
|
>lsaenumacctrights</DT
|
|
><DD
|
|
><P
|
|
>Enumerate the rights of an SID</P
|
|
></DD
|
|
><DT
|
|
>lsaenumacctwithright</DT
|
|
><DD
|
|
><P
|
|
>Enumerate accounts with a right</P
|
|
></DD
|
|
><DT
|
|
>lsaaddacctrights</DT
|
|
><DD
|
|
><P
|
|
>Add rights to an account</P
|
|
></DD
|
|
><DT
|
|
>lsaremoveacctrights</DT
|
|
><DD
|
|
><P
|
|
>Remove rights from an account</P
|
|
></DD
|
|
><DT
|
|
>lsalookupprivvalue</DT
|
|
><DD
|
|
><P
|
|
>Get a privilege value given its name</P
|
|
></DD
|
|
><DT
|
|
>lsaquerysecobj</DT
|
|
><DD
|
|
><P
|
|
>Query LSA security object</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN205"
|
|
></A
|
|
><H3
|
|
>LSARPC-DS</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>dsroledominfo</DT
|
|
><DD
|
|
><P
|
|
>Get Primary Domain Information</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
><P
|
|
> </P
|
|
><P
|
|
><SPAN
|
|
CLASS="emphasis"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>DFS</I
|
|
></SPAN
|
|
></P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>dfsexist</DT
|
|
><DD
|
|
><P
|
|
>Query DFS support</P
|
|
></DD
|
|
><DT
|
|
>dfsadd</DT
|
|
><DD
|
|
><P
|
|
>Add a DFS share</P
|
|
></DD
|
|
><DT
|
|
>dfsremove</DT
|
|
><DD
|
|
><P
|
|
>Remove a DFS share</P
|
|
></DD
|
|
><DT
|
|
>dfsgetinfo</DT
|
|
><DD
|
|
><P
|
|
>Query DFS share info</P
|
|
></DD
|
|
><DT
|
|
>dfsenum</DT
|
|
><DD
|
|
><P
|
|
>Enumerate dfs shares</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN236"
|
|
></A
|
|
><H3
|
|
>REG</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>shutdown</DT
|
|
><DD
|
|
><P
|
|
>Remote Shutdown</P
|
|
></DD
|
|
><DT
|
|
>abortshutdown</DT
|
|
><DD
|
|
><P
|
|
>Abort Shutdown</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN247"
|
|
></A
|
|
><H3
|
|
>SRVSVC</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>srvinfo</DT
|
|
><DD
|
|
><P
|
|
>Server query info</P
|
|
></DD
|
|
><DT
|
|
>netshareenum</DT
|
|
><DD
|
|
><P
|
|
>Enumerate shares</P
|
|
></DD
|
|
><DT
|
|
>netfileenum</DT
|
|
><DD
|
|
><P
|
|
>Enumerate open files</P
|
|
></DD
|
|
><DT
|
|
>netremotetod</DT
|
|
><DD
|
|
><P
|
|
>Fetch remote time of day</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN266"
|
|
></A
|
|
><H3
|
|
>SAMR</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>queryuser</DT
|
|
><DD
|
|
><P
|
|
>Query user info</P
|
|
></DD
|
|
><DT
|
|
>querygroup</DT
|
|
><DD
|
|
><P
|
|
>Query group info</P
|
|
></DD
|
|
><DT
|
|
>queryusergroups</DT
|
|
><DD
|
|
><P
|
|
>Query user groups</P
|
|
></DD
|
|
><DT
|
|
>querygroupmem</DT
|
|
><DD
|
|
><P
|
|
>Query group membership</P
|
|
></DD
|
|
><DT
|
|
>queryaliasmem</DT
|
|
><DD
|
|
><P
|
|
>Query alias membership</P
|
|
></DD
|
|
><DT
|
|
>querydispinfo</DT
|
|
><DD
|
|
><P
|
|
>Query display info</P
|
|
></DD
|
|
><DT
|
|
>querydominfo</DT
|
|
><DD
|
|
><P
|
|
>Query domain info</P
|
|
></DD
|
|
><DT
|
|
>enumdomusers</DT
|
|
><DD
|
|
><P
|
|
>Enumerate domain users</P
|
|
></DD
|
|
><DT
|
|
>enumdomgroups</DT
|
|
><DD
|
|
><P
|
|
>Enumerate domain groups</P
|
|
></DD
|
|
><DT
|
|
>enumalsgroups</DT
|
|
><DD
|
|
><P
|
|
>Enumerate alias groups</P
|
|
></DD
|
|
><DT
|
|
>createdomuser</DT
|
|
><DD
|
|
><P
|
|
>Create domain user</P
|
|
></DD
|
|
><DT
|
|
>samlookupnames</DT
|
|
><DD
|
|
><P
|
|
>Look up names</P
|
|
></DD
|
|
><DT
|
|
>samlookuprids</DT
|
|
><DD
|
|
><P
|
|
>Look up names</P
|
|
></DD
|
|
><DT
|
|
>deletedomuser</DT
|
|
><DD
|
|
><P
|
|
>Delete domain user</P
|
|
></DD
|
|
><DT
|
|
>samquerysecobj</DT
|
|
><DD
|
|
><P
|
|
>Query SAMR security object</P
|
|
></DD
|
|
><DT
|
|
>getdompwinfo</DT
|
|
><DD
|
|
><P
|
|
>Retrieve domain password info</P
|
|
></DD
|
|
><DT
|
|
>lookupdomain</DT
|
|
><DD
|
|
><P
|
|
>Look up domain</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN337"
|
|
></A
|
|
><H3
|
|
>SPOOLSS</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>adddriver <arch> <config></DT
|
|
><DD
|
|
><P
|
|
> Execute an AddPrinterDriver() RPC to install the printer driver
|
|
information on the server. Note that the driver files should
|
|
already exist in the directory returned by
|
|
<B
|
|
CLASS="COMMAND"
|
|
>getdriverdir</B
|
|
>. Possible values for
|
|
<VAR
|
|
CLASS="PARAMETER"
|
|
>arch</VAR
|
|
> are the same as those for
|
|
the <B
|
|
CLASS="COMMAND"
|
|
>getdriverdir</B
|
|
> command.
|
|
The <VAR
|
|
CLASS="PARAMETER"
|
|
>config</VAR
|
|
> 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
|
|
></P
|
|
><P
|
|
>Any empty fields should be enter as the string "NULL". </P
|
|
><P
|
|
>Samba does not need to support the concept of Print Monitors
|
|
since these only apply to local printers whose driver can make
|
|
use of a bi-directional link for communication. This field should
|
|
be "NULL". On a remote NT print server, the Print Monitor for a
|
|
driver must already be installed prior to adding the driver or
|
|
else the RPC will fail. </P
|
|
></DD
|
|
><DT
|
|
>addprinter <printername>
|
|
<sharename> <drivername> <port></DT
|
|
><DD
|
|
><P
|
|
> Add a printer on the remote server. This printer
|
|
will be automatically shared. Be aware that the printer driver
|
|
must already be installed on the server (see <B
|
|
CLASS="COMMAND"
|
|
>adddriver</B
|
|
>)
|
|
and the <VAR
|
|
CLASS="PARAMETER"
|
|
>port</VAR
|
|
>must be a valid port name (see
|
|
<B
|
|
CLASS="COMMAND"
|
|
>enumports</B
|
|
>.</P
|
|
></DD
|
|
><DT
|
|
>deldriver</DT
|
|
><DD
|
|
><P
|
|
>Delete the
|
|
specified printer driver for all architectures. This
|
|
does not delete the actual driver files from the server,
|
|
only the entry from the server's list of drivers.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>enumdata</DT
|
|
><DD
|
|
><P
|
|
>Enumerate all
|
|
printer setting data stored on the server. On Windows NT clients,
|
|
these values are stored in the registry, while Samba servers
|
|
store them in the printers TDB. This command corresponds
|
|
to the MS Platform SDK GetPrinterData() function (* This
|
|
command is currently unimplemented).</P
|
|
></DD
|
|
><DT
|
|
>enumdataex</DT
|
|
><DD
|
|
><P
|
|
>Enumerate printer data for a key</P
|
|
></DD
|
|
><DT
|
|
>enumjobs <printer></DT
|
|
><DD
|
|
><P
|
|
>List the jobs and status of a given printer.
|
|
This command corresponds to the MS Platform SDK EnumJobs()
|
|
function </P
|
|
></DD
|
|
><DT
|
|
>enumkey</DT
|
|
><DD
|
|
><P
|
|
>Enumerate printer keys</P
|
|
></DD
|
|
><DT
|
|
>enumports [level]</DT
|
|
><DD
|
|
><P
|
|
> Executes an EnumPorts() call using the specified
|
|
info level. Currently only info levels 1 and 2 are supported.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>enumdrivers [level]</DT
|
|
><DD
|
|
><P
|
|
> Execute an EnumPrinterDrivers() call. This lists the various installed
|
|
printer drivers for all architectures. Refer to the MS Platform SDK
|
|
documentation for more details of the various flags and calling
|
|
options. Currently supported info levels are 1, 2, and 3.</P
|
|
></DD
|
|
><DT
|
|
>enumprinters [level]</DT
|
|
><DD
|
|
><P
|
|
>Execute an EnumPrinters() call. This lists the various installed
|
|
and share printers. Refer to the MS Platform SDK documentation for
|
|
more details of the various flags and calling options. Currently
|
|
supported info levels are 0, 1, and 2.</P
|
|
></DD
|
|
><DT
|
|
>getdata <printername> <valuename;></DT
|
|
><DD
|
|
><P
|
|
>Retrieve the data for a given printer setting. See
|
|
the <B
|
|
CLASS="COMMAND"
|
|
>enumdata</B
|
|
> command for more information.
|
|
This command corresponds to the GetPrinterData() MS Platform
|
|
SDK function. </P
|
|
></DD
|
|
><DT
|
|
>getdataex</DT
|
|
><DD
|
|
><P
|
|
>Get printer driver data with keyname</P
|
|
></DD
|
|
><DT
|
|
>getdriver <printername></DT
|
|
><DD
|
|
><P
|
|
> Retrieve the printer driver information (such as driver file,
|
|
config file, dependent files, etc...) for
|
|
the given printer. This command corresponds to the GetPrinterDriver()
|
|
MS Platform SDK function. Currently info level 1, 2, and 3 are supported.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>getdriverdir <arch></DT
|
|
><DD
|
|
><P
|
|
> 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
|
|
CLASS="PARAMETER"
|
|
>arch</VAR
|
|
> are "Windows 4.0"
|
|
(for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows
|
|
Alpha_AXP", and "Windows NT R4000". </P
|
|
></DD
|
|
><DT
|
|
>getprinter <printername></DT
|
|
><DD
|
|
><P
|
|
>Retrieve the current printer information. This command
|
|
corresponds to the GetPrinter() MS Platform SDK function.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>getprintprocdir</DT
|
|
><DD
|
|
><P
|
|
>Get print processor directory</P
|
|
></DD
|
|
><DT
|
|
>openprinter <printername></DT
|
|
><DD
|
|
><P
|
|
>Execute an OpenPrinterEx() and ClosePrinter() RPC
|
|
against a given printer. </P
|
|
></DD
|
|
><DT
|
|
>setdriver <printername>
|
|
<drivername></DT
|
|
><DD
|
|
><P
|
|
>Execute a SetPrinter() command to update the printer driver
|
|
associated with an installed printer. The printer driver must
|
|
already be correctly installed on the print server. </P
|
|
><P
|
|
>See also the <B
|
|
CLASS="COMMAND"
|
|
>enumprinters</B
|
|
> and
|
|
<B
|
|
CLASS="COMMAND"
|
|
>enumdrivers</B
|
|
> commands for obtaining a list of
|
|
of installed printers and drivers.</P
|
|
></DD
|
|
><DT
|
|
>addform</DT
|
|
><DD
|
|
><P
|
|
>Add form</P
|
|
></DD
|
|
><DT
|
|
>setform</DT
|
|
><DD
|
|
><P
|
|
>Set form</P
|
|
></DD
|
|
><DT
|
|
>getform</DT
|
|
><DD
|
|
><P
|
|
>Get form</P
|
|
></DD
|
|
><DT
|
|
>deleteform</DT
|
|
><DD
|
|
><P
|
|
>Delete form</P
|
|
></DD
|
|
><DT
|
|
>enumforms</DT
|
|
><DD
|
|
><P
|
|
>Enumerate form</P
|
|
></DD
|
|
><DT
|
|
>setprinter</DT
|
|
><DD
|
|
><P
|
|
>Set printer comment</P
|
|
></DD
|
|
><DT
|
|
>setprinterdata</DT
|
|
><DD
|
|
><P
|
|
>Set REG_SZ printer data</P
|
|
></DD
|
|
><DT
|
|
>rffpcnex</DT
|
|
><DD
|
|
><P
|
|
>Rffpcnex test</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN460"
|
|
></A
|
|
><H3
|
|
>NETLOGON</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>logonctrl2</DT
|
|
><DD
|
|
><P
|
|
>Logon Control 2</P
|
|
></DD
|
|
><DT
|
|
>logonctrl</DT
|
|
><DD
|
|
><P
|
|
>Logon Control</P
|
|
></DD
|
|
><DT
|
|
>samsync</DT
|
|
><DD
|
|
><P
|
|
>Sam Synchronisation</P
|
|
></DD
|
|
><DT
|
|
>samdeltas</DT
|
|
><DD
|
|
><P
|
|
>Query Sam Deltas</P
|
|
></DD
|
|
><DT
|
|
>samlogon</DT
|
|
><DD
|
|
><P
|
|
>Sam Logon</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN483"
|
|
></A
|
|
><H3
|
|
>GENERAL COMMANDS</H3
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>debuglevel</DT
|
|
><DD
|
|
><P
|
|
>Set the current
|
|
debug level used to log information.</P
|
|
></DD
|
|
><DT
|
|
>help (?)</DT
|
|
><DD
|
|
><P
|
|
>Print a listing of all
|
|
known commands or extended help on a particular command.
|
|
</P
|
|
></DD
|
|
><DT
|
|
>quit (exit)</DT
|
|
><DD
|
|
><P
|
|
>Exit <B
|
|
CLASS="COMMAND"
|
|
>rpcclient
|
|
</B
|
|
>.</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN499"
|
|
></A
|
|
><H2
|
|
>BUGS</H2
|
|
><P
|
|
><B
|
|
CLASS="COMMAND"
|
|
>rpcclient</B
|
|
> is designed as a developer testing tool
|
|
and may not be robust in certain areas (such as command line parsing).
|
|
It has been known to generate a core dump upon failures when invalid
|
|
parameters where passed to the interpreter. </P
|
|
><P
|
|
>From Luke Leighton's original rpcclient man page:</P
|
|
><P
|
|
><SPAN
|
|
CLASS="emphasis"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>WARNING!</I
|
|
></SPAN
|
|
> The MSRPC over SMB code has
|
|
been developed from examining Network traces. No documentation is
|
|
available from the original creators (Microsoft) on how MSRPC over
|
|
SMB works, or how the individual MSRPC services work. Microsoft's
|
|
implementation of these services has been demonstrated (and reported)
|
|
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,
|
|
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
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN513"
|
|
></A
|
|
><H2
|
|
>VERSION</H2
|
|
><P
|
|
>This man page is correct for version 3.0 of the Samba
|
|
suite.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN516"
|
|
></A
|
|
><H2
|
|
>AUTHOR</H2
|
|
><P
|
|
>The original Samba software and related utilities
|
|
were created by Andrew Tridgell. Samba is now developed
|
|
by the Samba Team as an Open Source project similar
|
|
to the way the Linux kernel is developed.</P
|
|
><P
|
|
>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
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |