Ignore:
Timestamp:
May 27, 2007, 12:26:26 AM (18 years ago)
Author:
Paul Smedley
Message:

Upgrade source to 3.0.25a

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/samba/docs/manpages/rpcclient.1

    r26 r39  
    1919..
    2020.TH "RPCCLIENT" 1 "" "" ""
    21 .SH NAME
    22 rpcclient \- tool for executing client side MS-RPC functions
     21.SH "NAME"
     22rpcclient - tool for executing client side MS-RPC functions
    2323.SH "SYNOPSIS"
    24 .ad l
    25 .hy 0
    2624.HP 10
    27 \fBrpcclient\fR [\-A\ authfile] [\-c\ <command\ string>] [\-d\ debuglevel] [\-h] [\-l\ logdir] [\-N] [\-s\ <smb\ config\ file>] [\-U\ username[%password]] [\-W\ workgroup] [\-N] [\-I\ destinationIP] {server}
    28 .ad
    29 .hy
    30 
     25\fBrpcclient\fR [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logdir] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}
    3126.SH "DESCRIPTION"
    32 
    33 .PP
    34 This tool is part of the \fBsamba\fR(7) suite\&.
    35 
    36 .PP
    37 \fBrpcclient\fR 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\&.
    38 
     27.PP
     28This tool is part of the
     29\fBsamba\fR(7)
     30suite.
     31.PP
     32\fBrpcclient\fR
     33is 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.
    3934.SH "OPTIONS"
    40 
    41 .TP
     35.PP
    4236server
    43 NetBIOS name of Server to which to connect\&. The server can be any SMB/CIFS server\&. The name is resolved using the name resolve order line from \fBsmb\&.conf\fR(5)\&.
    44 
    45 .TP
    46 \-c|\-\-command='command string'
     37.RS 3n
     38NetBIOS name of Server to which to connect. The server can be any SMB/CIFS server. The name is resolved using the
     39name resolve order line from
     40\fBsmb.conf\fR(5).
     41.RE
     42.PP
     43-c|--command='command string'
     44.RS 3n
    4745execute semicolon separated commands (listed below))
    48 
    49 .TP
    50 \-I IP\-address
    51 \fIIP address\fR is the address of the server to connect to\&. It should be specified in standard "a\&.b\&.c\&.d" notation\&.
    52 
    53 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 \fIname resolve order\fR 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\&.
    54 
    55 There is no default for this parameter\&. If not supplied, it will be determined automatically by the client as described above\&.
    56 
    57 .TP
    58 \-V
    59 Prints the program version number\&.
    60 
    61 .TP
    62 \-s <configuration file>
    63 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 \fIsmb\&.conf\fR for more information\&. The default configuration file name is determined at compile time\&.
    64 
    65 .TP
    66 \-d|\-\-debuglevel=level
    67 \fIlevel\fR is an integer from 0 to 10\&. The default value if this parameter is not specified is zero\&.
    68 
    69 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\&.
    70 
    71 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\&.
    72 
    73 Note that specifying this parameter here will override the  parameter in the \fIsmb\&.conf\fR file\&.
    74 
    75 .TP
    76 \-l|\-\-logfile=logdirectory
    77 Base directory name for log/debug files\&. The extension \fB"\&.progname"\fR will be appended (e\&.g\&. log\&.smbclient, log\&.smbd, etc\&.\&.\&.)\&. The log file is never removed by the client\&.
    78 
    79 .TP
    80 \-N
    81 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\&.
    82 
    83 Unless a password is specified on the command line or this parameter is specified, the client will request a password\&.
    84 
    85 If a password is specified on the command line and this option is also defined the password on the command line will be silently ingnored and no password will be used\&.
    86 
    87 .TP
    88 \-k
    89 Try to authenticate with kerberos\&. Only useful in an Active Directory environment\&.
    90 
    91 .TP
    92 \-A|\-\-authentication\-file=filename
    93 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
    94 
    95 
     46.RE
     47.PP
     48-I IP-address
     49.RS 3n
     50\fIIP address\fR
     51is the address of the server to connect to. It should be specified in standard "a.b.c.d" notation.
     52.sp
     53Normally 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
     54\fIname resolve order\fR
     55parameter 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.
     56.sp
     57There is no default for this parameter. If not supplied, it will be determined automatically by the client as described above.
     58.RE
     59.PP
     60-V
     61.RS 3n
     62Prints the program version number.
     63.RE
     64.PP
     65-s <configuration file>
     66.RS 3n
     67The 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
     68\fIsmb.conf\fR
     69for more information. The default configuration file name is determined at compile time.
     70.RE
     71.PP
     72-d|--debuglevel=level
     73.RS 3n
     74\fIlevel\fR
     75is an integer from 0 to 10. The default value if this parameter is not specified is zero.
     76.sp
     77The 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.
     78.sp
     79Levels 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.
     80.sp
     81Note that specifying this parameter here will override the
     82
     83parameter in the
     84\fIsmb.conf\fR
     85file.
     86.RE
     87.PP
     88-l|--logfile=logdirectory
     89.RS 3n
     90Base directory name for log/debug files. The extension
     91\fB".progname"\fR
     92will be appended (e.g. log.smbclient, log.smbd, etc...). The log file is never removed by the client.
     93.RE
     94.PP
     95-N
     96.RS 3n
     97If 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.
     98.sp
     99Unless a password is specified on the command line or this parameter is specified, the client will request a password.
     100.sp
     101If a password is specified on the command line and this option is also defined the password on the command line will be silently ingnored and no password will be used.
     102.RE
     103.PP
     104-k
     105.RS 3n
     106Try to authenticate with kerberos. Only useful in an Active Directory environment.
     107.RE
     108.PP
     109-A|--authentication-file=filename
     110.RS 3n
     111This 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
     112.sp
     113
     114.sp
    96115
    97116.nf
     
    103122.fi
    104123
    105 
    106 Make certain that the permissions on the file restrict access from unwanted users\&.
    107 
    108 .TP
    109 \-U|\-\-user=username[%password]
    110 Sets the SMB username or username and password\&.
    111 
    112 If %password is not specified, the user will be prompted\&. The client will first check the \fBUSER\fR environment variable, then the \fBLOGNAME\fR variable and if either exists, the string is uppercased\&. If these environmental variables are not found, the username \fBGUEST\fR is used\&.
    113 
    114 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 \fI\-A\fR for more details\&.
    115 
    116 Be cautious about including passwords in scripts\&. Also, on many systems the command line of a running process may be seen via the \fBps\fR command\&. To be safe always allow \fBrpcclient\fR to prompt for a password and type it in directly\&.
    117 
    118 .TP
    119 \-n <primary NetBIOS name>
    120 This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the  parameter in the \fIsmb\&.conf\fR file\&. However, a command line setting will take precedence over settings in \fIsmb\&.conf\fR\&.
    121 
    122 .TP
    123 \-i <scope>
    124 This specifies a NetBIOS scope that \fBnmblookup\fR 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 \fBvery\fR rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with\&.
    125 
    126 .TP
    127 \-W|\-\-workgroup=domain
    128 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)\&.
    129 
    130 .TP
    131 \-O socket options
    132 TCP socket options to set on the client socket\&. See the socket options parameter in the \fIsmb\&.conf\fR manual page for the list of valid options\&.
    133 
    134 .TP
    135 \-h|\-\-help
    136 Print a summary of command line options\&.
    137 
     124.sp
     125Make certain that the permissions on the file restrict access from unwanted users.
     126.RE
     127.PP
     128-U|--user=username[%password]
     129.RS 3n
     130Sets the SMB username or username and password.
     131.sp
     132If %password is not specified, the user will be prompted. The client will first check the
     133\fBUSER\fR
     134environment variable, then the
     135\fBLOGNAME\fR
     136variable and if either exists, the string is uppercased. If these environmental variables are not found, the username
     137\fBGUEST\fR
     138is used.
     139.sp
     140A 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
     141\fI-A\fR
     142for more details.
     143.sp
     144Be cautious about including passwords in scripts. Also, on many systems the command line of a running process may be seen via the
     145\fBps\fR
     146command. To be safe always allow
     147\fBrpcclient\fR
     148to prompt for a password and type it in directly.
     149.RE
     150.PP
     151-n <primary NetBIOS name>
     152.RS 3n
     153This option allows you to override the NetBIOS name that Samba uses for itself. This is identical to setting the
     154
     155parameter in the
     156\fIsmb.conf\fR
     157file. However, a command line setting will take precedence over settings in
     158\fIsmb.conf\fR.
     159.RE
     160.PP
     161-i <scope>
     162.RS 3n
     163This specifies a NetBIOS scope that
     164\fBnmblookup\fR
     165will 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
     166\fBvery\fR
     167rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.
     168.RE
     169.PP
     170-W|--workgroup=domain
     171.RS 3n
     172Set 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).
     173.RE
     174.PP
     175-O socket options
     176.RS 3n
     177TCP socket options to set on the client socket. See the socket options parameter in the
     178\fIsmb.conf\fR
     179manual page for the list of valid options.
     180.RE
     181.PP
     182-h|--help
     183.RS 3n
     184Print a summary of command line options.
     185.RE
    138186.SH "COMMANDS"
    139 
    140187.SS "LSARPC"
    141 
    142 .TP
     188.PP
    143189lsaquery
     190.RS 3n
    144191Query info policy
    145 
    146 .TP
     192.RE
     193.PP
    147194lookupsids
    148 Resolve a list of SIDs to usernames\&.
    149 
    150 .TP
     195.RS 3n
     196Resolve a list of SIDs to usernames.
     197.RE
     198.PP
    151199lookupnames
    152 Resolve a list of usernames to SIDs\&.
    153 
    154 .TP
     200.RS 3n
     201Resolve a list of usernames to SIDs.
     202.RE
     203.PP
    155204enumtrusts
     205.RS 3n
    156206Enumerate trusted domains
    157 
    158 .TP
     207.RE
     208.PP
    159209enumprivs
     210.RS 3n
    160211Enumerate privileges
    161 
    162 .TP
     212.RE
     213.PP
    163214getdispname
     215.RS 3n
    164216Get the privilege name
    165 
    166 .TP
     217.RE
     218.PP
    167219lsaenumsid
     220.RS 3n
    168221Enumerate the LSA SIDS
    169 
    170 .TP
     222.RE
     223.PP
    171224lsaenumprivsaccount
     225.RS 3n
    172226Enumerate the privileges of an SID
    173 
    174 .TP
     227.RE
     228.PP
    175229lsaenumacctrights
     230.RS 3n
    176231Enumerate the rights of an SID
    177 
    178 .TP
     232.RE
     233.PP
    179234lsaenumacctwithright
     235.RS 3n
    180236Enumerate accounts with a right
    181 
    182 .TP
     237.RE
     238.PP
    183239lsaaddacctrights
     240.RS 3n
    184241Add rights to an account
    185 
    186 .TP
     242.RE
     243.PP
    187244lsaremoveacctrights
     245.RS 3n
    188246Remove rights from an account
    189 
    190 .TP
     247.RE
     248.PP
    191249lsalookupprivvalue
     250.RS 3n
    192251Get a privilege value given its name
    193 
    194 .TP
     252.RE
     253.PP
    195254lsaquerysecobj
     255.RS 3n
    196256Query LSA security object
    197 
     257.RE
    198258.SS "LSARPC-DS"
    199 
    200 .TP
     259.PP
    201260dsroledominfo
     261.RS 3n
    202262Get Primary Domain Information
    203 
    204 .PP
    205 
     263.RE
     264.PP
    206265
    207266.PP
    208267\fBDFS\fR
    209 
    210 .TP
     268.PP
    211269dfsexist
     270.RS 3n
    212271Query DFS support
    213 
    214 .TP
     272.RE
     273.PP
    215274dfsadd
     275.RS 3n
    216276Add a DFS share
    217 
    218 .TP
     277.RE
     278.PP
    219279dfsremove
     280.RS 3n
    220281Remove a DFS share
    221 
    222 .TP
     282.RE
     283.PP
    223284dfsgetinfo
     285.RS 3n
    224286Query DFS share info
    225 
    226 .TP
     287.RE
     288.PP
    227289dfsenum
     290.RS 3n
    228291Enumerate dfs shares
    229 
     292.RE
    230293.SS "REG"
    231 
    232 .TP
     294.PP
    233295shutdown
     296.RS 3n
    234297Remote Shutdown
    235 
    236 .TP
     298.RE
     299.PP
    237300abortshutdown
     301.RS 3n
    238302Abort Shutdown
    239 
     303.RE
    240304.SS "SRVSVC"
    241 
    242 .TP
     305.PP
    243306srvinfo
     307.RS 3n
    244308Server query info
    245 
    246 .TP
     309.RE
     310.PP
    247311netshareenum
     312.RS 3n
    248313Enumerate shares
    249 
    250 .TP
     314.RE
     315.PP
    251316netfileenum
     317.RS 3n
    252318Enumerate open files
    253 
    254 .TP
     319.RE
     320.PP
    255321netremotetod
     322.RS 3n
    256323Fetch remote time of day
    257 
     324.RE
    258325.SS "SAMR"
    259 
    260 .TP
     326.PP
    261327queryuser
     328.RS 3n
    262329Query user info
    263 
    264 .TP
     330.RE
     331.PP
    265332querygroup
     333.RS 3n
    266334Query group info
    267 
    268 .TP
     335.RE
     336.PP
    269337queryusergroups
     338.RS 3n
    270339Query user groups
    271 
    272 .TP
     340.RE
     341.PP
    273342querygroupmem
     343.RS 3n
    274344Query group membership
    275 
    276 .TP
     345.RE
     346.PP
    277347queryaliasmem
     348.RS 3n
    278349Query alias membership
    279 
    280 .TP
     350.RE
     351.PP
    281352querydispinfo
     353.RS 3n
    282354Query display info
    283 
    284 .TP
     355.RE
     356.PP
    285357querydominfo
     358.RS 3n
    286359Query domain info
    287 
    288 .TP
     360.RE
     361.PP
    289362enumdomusers
     363.RS 3n
    290364Enumerate domain users
    291 
    292 .TP
     365.RE
     366.PP
    293367enumdomgroups
     368.RS 3n
    294369Enumerate domain groups
    295 
    296 .TP
     370.RE
     371.PP
    297372enumalsgroups
     373.RS 3n
    298374Enumerate alias groups
    299 
    300 .TP
     375.RE
     376.PP
    301377createdomuser
     378.RS 3n
    302379Create domain user
    303 
    304 .TP
     380.RE
     381.PP
    305382samlookupnames
     383.RS 3n
    306384Look up names
    307 
    308 .TP
     385.RE
     386.PP
    309387samlookuprids
     388.RS 3n
    310389Look up names
    311 
    312 .TP
     390.RE
     391.PP
    313392deletedomuser
     393.RS 3n
    314394Delete domain user
    315 
    316 .TP
     395.RE
     396.PP
    317397samquerysecobj
     398.RS 3n
    318399Query SAMR security object
    319 
    320 .TP
     400.RE
     401.PP
    321402getdompwinfo
     403.RS 3n
    322404Retrieve domain password info
    323 
    324 .TP
     405.RE
     406.PP
    325407lookupdomain
     408.RS 3n
    326409Look up domain
    327 
     410.RE
    328411.SS "SPOOLSS"
    329 
    330 .TP
     412.PP
    331413adddriver <arch> <config> [<version>]
    332 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\fBgetdriverdir\fR\&. Possible values for\fIarch\fR are the same as those for the \fBgetdriverdir\fR command\&. The \fIconfig\fR parameter is defined as follows:
    333 
    334 
     414.RS 3n
     415Execute 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
     416\fBgetdriverdir\fR. Possible values for
     417\fIarch\fR
     418are the same as those for the
     419\fBgetdriverdir\fR
     420command. The
     421\fIconfig\fR
     422parameter is defined as follows:
     423.sp
     424
     425.sp
    335426
    336427.nf
    337428
    338 Long Printer Name:\\
    339 Driver File Name:\\
    340 Data File Name:\\
    341 Config File Name:\\
    342 Help File Name:\\
    343 Language Monitor Name:\\
    344 Default Data Type:\\
     429Long Printer Name:\
     430Driver File Name:\
     431Data File Name:\
     432Config File Name:\
     433Help File Name:\
     434Language Monitor Name:\
     435Default Data Type:\
    345436Comma Separated list of Files
    346437
    347438.fi
    348439
    349 
    350 Any empty fields should be enter as the string "NULL"\&.
    351 
    352 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\&.
    353 
    354 The \fIversion\fR parameter lets you specify the printer driver version number\&. If omitted, the default driver version for the specified architecture will be used\&. This option can be used to upload Windows 2000 (version 3) printer drivers\&.
    355 
    356 .TP
     440.sp
     441Any empty fields should be enter as the string "NULL".
     442.sp
     443Samba 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.
     444.sp
     445The
     446\fIversion\fR
     447parameter lets you specify the printer driver version number. If omitted, the default driver version for the specified architecture will be used. This option can be used to upload Windows 2000 (version 3) printer drivers.
     448.RE
     449.PP
    357450addprinter <printername> <sharename> <drivername> <port>
    358 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 \fBadddriver\fR) and the \fIport\fRmust be a valid port name (see\fBenumports\fR\&.
    359 
    360 .TP
     451.RS 3n
     452Add 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
     453\fBadddriver\fR) and the
     454\fIport\fRmust be a valid port name (see
     455\fBenumports\fR.
     456.RE
     457.PP
    361458deldriver
    362 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\&.
    363 
    364 .TP
     459.RS 3n
     460Delete 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.
     461.RE
     462.PP
    365463deldriverex <driver> [architecture] [version]
    366 Delete the specified printer driver including driver files\&. You can limit this action to a specific architecture and a specific version\&. If no architecure is given, all driver files of that driver will be deleted\&.
    367 
    368 .TP
     464.RS 3n
     465Delete the specified printer driver including driver files. You can limit this action to a specific architecture and a specific version. If no architecure is given, all driver files of that driver will be deleted.
     466.RE
     467.PP
    369468enumdata
    370 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)\&.
    371 
    372 .TP
     469.RS 3n
     470Enumerate 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).
     471.RE
     472.PP
    373473enumdataex
     474.RS 3n
    374475Enumerate printer data for a key
    375 
    376 .TP
     476.RE
     477.PP
    377478enumjobs <printer>
    378 List the jobs and status of a given printer\&. This command corresponds to the MS Platform SDK EnumJobs() function
    379 
    380 .TP
     479.RS 3n
     480List the jobs and status of a given printer. This command corresponds to the MS Platform SDK EnumJobs() function
     481.RE
     482.PP
    381483enumkey
     484.RS 3n
    382485Enumerate printer keys
    383 
    384 .TP
     486.RE
     487.PP
    385488enumports [level]
    386 Executes an EnumPorts() call using the specified info level\&. Currently only info levels 1 and 2 are supported\&.
    387 
    388 .TP
     489.RS 3n
     490Executes an EnumPorts() call using the specified info level. Currently only info levels 1 and 2 are supported.
     491.RE
     492.PP
    389493enumdrivers [level]
    390 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\&.
    391 
    392 .TP
     494.RS 3n
     495Execute 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.
     496.RE
     497.PP
    393498enumprinters [level]
    394 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 1, 2 and 5\&.
    395 
    396 .TP
     499.RS 3n
     500Execute 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 1, 2 and 5.
     501.RE
     502.PP
    397503getdata <printername> <valuename;>
    398 Retrieve the data for a given printer setting\&. See the \fBenumdata\fR command for more information\&. This command corresponds to the GetPrinterData() MS Platform SDK function\&.
    399 
    400 .TP
     504.RS 3n
     505Retrieve the data for a given printer setting. See the
     506\fBenumdata\fR
     507command for more information. This command corresponds to the GetPrinterData() MS Platform SDK function.
     508.RE
     509.PP
    401510getdataex
     511.RS 3n
    402512Get printer driver data with keyname
    403 
    404 .TP
     513.RE
     514.PP
    405515getdriver <printername>
    406 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\&.
    407 
    408 .TP
     516.RS 3n
     517Retrieve 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.
     518.RE
     519.PP
    409520getdriverdir <arch>
    410 Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for storing printer driver files for a given architecture\&. Possible values for \fIarch\fR are "Windows 4\&.0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000"\&.
    411 
    412 .TP
     521.RS 3n
     522Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for storing printer driver files for a given architecture. Possible values for
     523\fIarch\fR
     524are "Windows 4.0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", and "Windows NT R4000".
     525.RE
     526.PP
    413527getprinter <printername>
    414 Retrieve the current printer information\&. This command corresponds to the GetPrinter() MS Platform SDK function\&.
    415 
    416 .TP
     528.RS 3n
     529Retrieve the current printer information. This command corresponds to the GetPrinter() MS Platform SDK function.
     530.RE
     531.PP
    417532getprintprocdir
     533.RS 3n
    418534Get print processor directory
    419 
    420 .TP
     535.RE
     536.PP
    421537openprinter <printername>
    422 Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer\&.
    423 
    424 .TP
     538.RS 3n
     539Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer.
     540.RE
     541.PP
    425542setdriver <printername> <drivername>
    426 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\&.
    427 
    428 See also the \fBenumprinters\fR and\fBenumdrivers\fR commands for obtaining a list of of installed printers and drivers\&.
    429 
    430 .TP
     543.RS 3n
     544Execute 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.
     545.sp
     546See also the
     547\fBenumprinters\fR
     548and
     549\fBenumdrivers\fR
     550commands for obtaining a list of of installed printers and drivers.
     551.RE
     552.PP
    431553addform
     554.RS 3n
    432555Add form
    433 
    434 .TP
     556.RE
     557.PP
    435558setform
     559.RS 3n
    436560Set form
    437 
    438 .TP
     561.RE
     562.PP
    439563getform
     564.RS 3n
    440565Get form
    441 
    442 .TP
     566.RE
     567.PP
    443568deleteform
     569.RS 3n
    444570Delete form
    445 
    446 .TP
     571.RE
     572.PP
    447573enumforms
     574.RS 3n
    448575Enumerate form
    449 
    450 .TP
     576.RE
     577.PP
    451578setprinter
     579.RS 3n
    452580Set printer comment
    453 
    454 .TP
     581.RE
     582.PP
    455583setprinterdata
     584.RS 3n
    456585Set REG_SZ printer data
    457 
    458 .TP
     586.RE
     587.PP
    459588setprintername <printername> <newprintername>
     589.RS 3n
    460590Set printer name
    461 
    462 .TP
     591.RE
     592.PP
    463593rffpcnex
     594.RS 3n
    464595Rffpcnex test
    465 
     596.RE
    466597.SS "NETLOGON"
    467 
    468 .TP
     598.PP
    469599logonctrl2
     600.RS 3n
    470601Logon Control 2
    471 
    472 .TP
     602.RE
     603.PP
    473604logonctrl
     605.RS 3n
    474606Logon Control
    475 
    476 .TP
     607.RE
     608.PP
    477609samsync
     610.RS 3n
    478611Sam Synchronisation
    479 
    480 .TP
     612.RE
     613.PP
    481614samdeltas
     615.RS 3n
    482616Query Sam Deltas
    483 
    484 .TP
     617.RE
     618.PP
    485619samlogon
     620.RS 3n
    486621Sam Logon
    487 
     622.RE
    488623.SS "GENERAL COMMANDS"
    489 
    490 .TP
     624.PP
    491625debuglevel
    492 Set the current debug level used to log information\&.
    493 
    494 .TP
     626.RS 3n
     627Set the current debug level used to log information.
     628.RE
     629.PP
    495630help (?)
    496 Print a listing of all known commands or extended help on a particular command\&.
    497 
    498 .TP
     631.RS 3n
     632Print a listing of all known commands or extended help on a particular command.
     633.RE
     634.PP
    499635quit (exit)
    500 Exit \fBrpcclient \fR\&.
    501 
     636.RS 3n
     637Exit
     638\fBrpcclient \fR.
     639.RE
    502640.SH "BUGS"
    503 
    504 .PP
    505 \fBrpcclient\fR 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\&.
    506 
     641.PP
     642\fBrpcclient\fR
     643is 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.
    507644.PP
    508645From Luke Leighton's original rpcclient man page:
    509 
    510 .PP
    511 \fBWARNING!\fR 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\&.
    512 
    513 .PP
    514 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 \fBsmbd\fR(8) and \fBrpcclient\fR(1) 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\&.
    515 
     646.PP
     647\fBWARNING!\fR
     648The 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.
     649.PP
     650The 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
     651\fBsmbd\fR(8)
     652and
     653\fBrpcclient\fR(1)
     654that 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.
    516655.SH "VERSION"
    517 
    518 .PP
    519 This man page is correct for version 3\&.0 of the Samba suite\&.
    520 
     656.PP
     657This man page is correct for version 3.0 of the Samba suite.
    521658.SH "AUTHOR"
    522 
    523 .PP
    524 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\&.
    525 
    526 .PP
    527 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\&.
    528 
     659.PP
     660The 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.
     661.PP
     662The 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.
     663
Note: See TracChangeset for help on using the changeset viewer.