mirror of
https://github.com/samba-team/samba.git
synced 2025-01-25 06:04:04 +03:00
merge from HEAD
(This used to be commit c72db22a3f2d823b5ac30066ed53f5edb2b69495)
This commit is contained in:
parent
33640a7484
commit
61fec246b6
@ -16,7 +16,6 @@
|
||||
<refsynopsisdiv>
|
||||
<cmdsynopsis>
|
||||
<command>rpcclient</command>
|
||||
<arg choice="req">server</arg>
|
||||
<arg choice="opt">-A authfile</arg>
|
||||
<arg choice="opt">-c <command string></arg>
|
||||
<arg choice="opt">-d debuglevel</arg>
|
||||
@ -27,6 +26,7 @@
|
||||
<arg choice="opt">-U username[%password]</arg>
|
||||
<arg choice="opt">-W workgroup</arg>
|
||||
<arg choice="opt">-N</arg>
|
||||
<arg choice="req">server</arg>
|
||||
</cmdsynopsis>
|
||||
</refsynopsisdiv>
|
||||
|
||||
|
@ -37,7 +37,7 @@ NAME="AEN8"
|
||||
><B
|
||||
CLASS="COMMAND"
|
||||
>rpcclient</B
|
||||
> {server} [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N]</P
|
||||
> [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] {server}</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="REFSECT1"
|
||||
@ -96,7 +96,7 @@ CLASS="FILENAME"
|
||||
>.</P
|
||||
></DD
|
||||
><DT
|
||||
>-A filename</DT
|
||||
>-A|--authfile=filename</DT
|
||||
><DD
|
||||
><P
|
||||
>This option allows
|
||||
@ -125,14 +125,14 @@ CLASS="PROGRAMLISTING"
|
||||
access from unwanted users. </P
|
||||
></DD
|
||||
><DT
|
||||
>-c 'command string'</DT
|
||||
>-c|--command='command string'</DT
|
||||
><DD
|
||||
><P
|
||||
>execute semicolon separated commands (listed
|
||||
below)) </P
|
||||
></DD
|
||||
><DT
|
||||
>-d debuglevel</DT
|
||||
>-d|--debug=debuglevel</DT
|
||||
><DD
|
||||
><P
|
||||
>set the debuglevel. Debug level 0 is the lowest
|
||||
@ -144,14 +144,14 @@ CLASS="FILENAME"
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>-h</DT
|
||||
>-h|--help</DT
|
||||
><DD
|
||||
><P
|
||||
>Print a summary of command line options.
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>-l logbasename</DT
|
||||
>-l|--logfile=logbasename</DT
|
||||
><DD
|
||||
><P
|
||||
>File name for log/debug files. The extension
|
||||
@ -163,7 +163,7 @@ CLASS="CONSTANT"
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>-N</DT
|
||||
>-N|--nopass</DT
|
||||
><DD
|
||||
><P
|
||||
>instruct <B
|
||||
@ -182,7 +182,7 @@ CLASS="PARAMETER"
|
||||
> option.</P
|
||||
></DD
|
||||
><DT
|
||||
>-s smb.conf</DT
|
||||
>-s|--conf=smb.conf</DT
|
||||
><DD
|
||||
><P
|
||||
>Specifies the location of the all important
|
||||
@ -192,7 +192,7 @@ CLASS="FILENAME"
|
||||
> file. </P
|
||||
></DD
|
||||
><DT
|
||||
>-U username[%password]</DT
|
||||
>-U|--user=username[%password]</DT
|
||||
><DD
|
||||
><P
|
||||
>Sets the SMB username or username and password. </P
|
||||
@ -238,7 +238,7 @@ CLASS="COMMAND"
|
||||
it in directly. </P
|
||||
></DD
|
||||
><DT
|
||||
>-W domain</DT
|
||||
>-W|--workgroup=domain</DT
|
||||
><DD
|
||||
><P
|
||||
>Set the SMB domain of the username. This
|
||||
@ -693,7 +693,7 @@ NAME="AEN222"
|
||||
><H2
|
||||
>VERSION</H2
|
||||
><P
|
||||
>This man page is correct for version 2.2 of the Samba
|
||||
>This man page is correct for version 3.0 of the Samba
|
||||
suite.</P
|
||||
></DIV
|
||||
><DIV
|
||||
|
@ -18435,14 +18435,18 @@ CLASS="FILENAME"
|
||||
> modules for UNIX services.
|
||||
</P
|
||||
><P
|
||||
>Please note that setting this parameter to + causes problems
|
||||
with group membership at least on glibc systems, as the character +
|
||||
is used as a special character for NIS in /etc/group.</P
|
||||
><P
|
||||
>Example: <B
|
||||
CLASS="COMMAND"
|
||||
>winbind separator = \</B
|
||||
>winbind separator = \\</B
|
||||
></P
|
||||
><P
|
||||
>Example: <B
|
||||
CLASS="COMMAND"
|
||||
>winbind separator = +</B
|
||||
>winbind separator = /</B
|
||||
></P
|
||||
></DD
|
||||
><DT
|
||||
@ -18869,7 +18873,7 @@ CLASS="COMMAND"
|
||||
><DIV
|
||||
CLASS="REFSECT1"
|
||||
><A
|
||||
NAME="AEN5973"
|
||||
NAME="AEN5974"
|
||||
></A
|
||||
><H2
|
||||
>WARNINGS</H2
|
||||
@ -18899,7 +18903,7 @@ TARGET="_top"
|
||||
><DIV
|
||||
CLASS="REFSECT1"
|
||||
><A
|
||||
NAME="AEN5979"
|
||||
NAME="AEN5980"
|
||||
></A
|
||||
><H2
|
||||
>VERSION</H2
|
||||
@ -18910,7 +18914,7 @@ NAME="AEN5979"
|
||||
><DIV
|
||||
CLASS="REFSECT1"
|
||||
><A
|
||||
NAME="AEN5982"
|
||||
NAME="AEN5983"
|
||||
></A
|
||||
><H2
|
||||
>SEE ALSO</H2
|
||||
@ -18989,7 +18993,7 @@ CLASS="COMMAND"
|
||||
><DIV
|
||||
CLASS="REFSECT1"
|
||||
><A
|
||||
NAME="AEN6002"
|
||||
NAME="AEN6003"
|
||||
></A
|
||||
><H2
|
||||
>AUTHOR</H2
|
||||
|
@ -1,43 +1,43 @@
|
||||
.\" This manpage has been automatically generated by docbook2man
|
||||
.\" from a DocBook document. This tool can be found at:
|
||||
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
|
||||
.\" This manpage has been automatically generated by docbook2man-spec
|
||||
.\" from a DocBook document. docbook2man-spec can be found at:
|
||||
.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
|
||||
.\" Please send any bug reports, improvements, comments, patches,
|
||||
.\" etc. to Steve Cheng <steve@ggi-project.org>.
|
||||
.TH "RPCCLIENT" "1" "28 March 2002" "" ""
|
||||
.TH "RPCCLIENT" "1" "16 April 2002" "" ""
|
||||
.SH NAME
|
||||
rpcclient \- tool for executing client side MS-RPC functions
|
||||
.SH SYNOPSIS
|
||||
|
||||
\fBrpcclient\fR \fBserver\fR [ \fB-A authfile\fR] [ \fB-c <command string>\fR] [ \fB-d debuglevel\fR] [ \fB-h\fR] [ \fB-l logfile\fR] [ \fB-N\fR] [ \fB-s <smb config file>\fR] [ \fB-U username[%password]\fR] [ \fB-W workgroup\fR] [ \fB-N\fR]
|
||||
|
||||
.sp
|
||||
\fBrpcclient\fR [ \fB-A authfile\fR ] [ \fB-c <command string>\fR ] [ \fB-d debuglevel\fR ] [ \fB-h\fR ] [ \fB-l logfile\fR ] [ \fB-N\fR ] [ \fB-s <smb config file>\fR ] [ \fB-U username[%password]\fR ] [ \fB-W workgroup\fR ] [ \fB-N\fR ] \fBserver\fR
|
||||
.SH "DESCRIPTION"
|
||||
.PP
|
||||
This tool is part of the Sambasuite.
|
||||
.PP
|
||||
\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
|
||||
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.
|
||||
.SH "OPTIONS"
|
||||
.TP
|
||||
\fBserver\fR
|
||||
NetBIOS name of Server to which to connect.
|
||||
The server can be any SMB/CIFS server. The name is
|
||||
resolved using the \fIname resolve order\fRline from
|
||||
The server can be any SMB/CIFS server. The name is
|
||||
resolved using the \fIname resolve order\fRline from
|
||||
\fIsmb.conf(5)\fR.
|
||||
.TP
|
||||
\fB-A|--authfile=filename\fR
|
||||
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
|
||||
|
||||
password used in the connection. The format of the file is
|
||||
|
||||
.sp
|
||||
.nf
|
||||
username = <value>
|
||||
password = <value>
|
||||
domain = <value>
|
||||
|
||||
.sp
|
||||
.fi
|
||||
|
||||
Make certain that the permissions on the file restrict
|
||||
@ -57,13 +57,13 @@ Print a summary of command line options.
|
||||
.TP
|
||||
\fB-l|--logfile=logbasename\fR
|
||||
File name for log/debug files. The extension
|
||||
\&'.client' will be appended. The log file is never removed
|
||||
\&'.client' will be appended. The log file is never removed
|
||||
by the client.
|
||||
.TP
|
||||
\fB-N|--nopass\fR
|
||||
instruct \fBrpcclient\fR not to ask
|
||||
for a password. By default, \fBrpcclient\fR will prompt
|
||||
for a password. See also the \fI-U\fR option.
|
||||
for a password. By default, \fBrpcclient\fR will prompt
|
||||
for a password. See also the \fI-U\fR option.
|
||||
.TP
|
||||
\fB-s|--conf=smb.conf\fR
|
||||
Specifies the location of the all important
|
||||
@ -79,24 +79,24 @@ string is uppercased. If these environmental variables are not
|
||||
found, the username GUEST is used.
|
||||
|
||||
A third option is to use a credentials file which
|
||||
contains the plaintext of the username and password. This
|
||||
contains the plaintext of the username and password. This
|
||||
option is mainly provided for scripts where the admin doesn't
|
||||
desire 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
|
||||
on the file restrict access from unwanted users. See the
|
||||
\fI-A\fR for more details.
|
||||
|
||||
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
|
||||
via the \fBps\fR command. To be safe always allow
|
||||
\fBrpcclient\fR to prompt for a password and type
|
||||
it in directly.
|
||||
.TP
|
||||
\fB-W|--workgroup=domain\fR
|
||||
Set the SMB domain of the username. This
|
||||
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 server's NetBIOS name,
|
||||
it causes the client to log on using the server's local SAM (as
|
||||
smb.conf. If the domain specified is the same as the server's NetBIOS name,
|
||||
it causes the client to log on using the server's local SAM (as
|
||||
opposed to the Domain SAM).
|
||||
.SH "COMMANDS"
|
||||
.PP
|
||||
@ -117,7 +117,9 @@ of usernames to SIDs.
|
||||
\fBenumtrusts\fR
|
||||
.PP
|
||||
.PP
|
||||
.PP
|
||||
\fBSAMR\fR
|
||||
.PP
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBqueryuser\fR
|
||||
@ -144,20 +146,22 @@ of usernames to SIDs.
|
||||
\fBenumdomgroups\fR
|
||||
.PP
|
||||
.PP
|
||||
.PP
|
||||
\fBSPOOLSS\fR
|
||||
.PP
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBadddriver <arch> <config>\fR
|
||||
- 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
|
||||
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:
|
||||
|
||||
|
||||
.sp
|
||||
.nf
|
||||
Long Printer Name:\\
|
||||
Driver File Name:\\
|
||||
@ -168,43 +172,44 @@ follows:
|
||||
Default Data Type:\\
|
||||
Comma Separated list of Files
|
||||
|
||||
.sp
|
||||
.fi
|
||||
|
||||
Any empty fields should be enter as the string "NULL".
|
||||
|
||||
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
|
||||
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.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBaddprinter <printername>
|
||||
<sharename> <drivername> <port>\fR
|
||||
- Add a printer on the remote server. This printer
|
||||
will be automatically shared. Be aware that the printer driver
|
||||
- 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.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBdeldriver\fR - Delete the
|
||||
specified printer driver for all architectures. This
|
||||
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.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBenumdata\fR - 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
|
||||
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).
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBenumjobs <printer>\fR
|
||||
- List the jobs and status of a given printer.
|
||||
- List the jobs and status of a given printer.
|
||||
This command corresponds to the MS Platform SDK EnumJobs()
|
||||
function (* This command is currently unimplemented).
|
||||
.TP 0.2i
|
||||
@ -215,22 +220,22 @@ info level. Currently only info levels 1 and 2 are supported.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBenumdrivers [level]\fR
|
||||
- Execute an EnumPrinterDrivers() call. This lists the various installed
|
||||
printer drivers for all architectures. Refer to the MS Platform SDK
|
||||
- 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.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBenumprinters [level]\fR
|
||||
- Execute an EnumPrinters() call. This lists the various installed
|
||||
and share printers. Refer to the MS Platform SDK documentation for
|
||||
- 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.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBgetdata <printername>\fR
|
||||
- Retrieve the data for a given printer setting. See
|
||||
the \fBenumdata\fR command for more information.
|
||||
- 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 (* This command is currently unimplemented).
|
||||
.TP 0.2i
|
||||
@ -239,20 +244,20 @@ SDK function (* This command is currently unimplemented).
|
||||
- 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.
|
||||
MS Platform SDK function. Currently info level 1, 2, and 3 are supported.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBgetdriverdir <arch>\fR
|
||||
- Execute a GetPrinterDriverDirectory()
|
||||
RPC to retreive the SMB share name and subdirectory for
|
||||
storing printer driver files for a given architecture. Possible
|
||||
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".
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBgetprinter <printername>\fR
|
||||
- Retrieve the current printer information. This command
|
||||
- Retrieve the current printer information. This command
|
||||
corresponds to the GetPrinter() MS Platform SDK function.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
@ -263,14 +268,15 @@ against a given printer.
|
||||
\(bu
|
||||
\fBsetdriver <printername> <drivername>\fR
|
||||
- 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.
|
||||
with an installed printer. The printer driver must already be correctly
|
||||
installed on the print server.
|
||||
|
||||
See also the \fBenumprinters\fR and
|
||||
\fBenumdrivers\fR commands for obtaining a list of
|
||||
of installed printers and drivers.
|
||||
.PP
|
||||
\fBGENERAL OPTIONS\fR
|
||||
.PP
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBdebuglevel\fR - Set the current debug level
|
||||
@ -278,33 +284,33 @@ used to log information.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBhelp (?)\fR - Print a listing of all
|
||||
known commands or extended help on a particular command.
|
||||
known commands or extended help on a particular command.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\fBquit (exit)\fR - Exit \fBrpcclient
|
||||
\fR.
|
||||
\fR\&.
|
||||
.SH "BUGS"
|
||||
.PP
|
||||
\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
|
||||
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.
|
||||
.PP
|
||||
From Luke Leighton's original rpcclient man page:
|
||||
.PP
|
||||
\fB"WARNING!\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)
|
||||
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.
|
||||
.PP
|
||||
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(8)\fR and \fBrpcclient(1)\fR
|
||||
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
|
||||
and as more of the services are understood, it can even result in
|
||||
versions of \fBsmbd(8)\fR and \fBrpcclient(1)\fR
|
||||
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."
|
||||
.SH "VERSION"
|
||||
.PP
|
||||
@ -318,6 +324,6 @@ by the Samba Team as an Open Source project similar
|
||||
to the way the Linux kernel is developed.
|
||||
.PP
|
||||
The original rpcclient man page was written by Matthew
|
||||
Geddes, Luke Kenneth Casson Leighton, and rewritten by Gerald Carter.
|
||||
Geddes, Luke Kenneth Casson Leighton, and rewritten by Gerald Carter.
|
||||
The conversion to DocBook for Samba 2.2 was done by Gerald
|
||||
Carter.
|
||||
|
@ -3,7 +3,7 @@
|
||||
.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
|
||||
.\" Please send any bug reports, improvements, comments, patches,
|
||||
.\" etc. to Steve Cheng <steve@ggi-project.org>.
|
||||
.TH "SMB.CONF" "5" "01 April 2002" "" ""
|
||||
.TH "SMB.CONF" "5" "16 April 2002" "" ""
|
||||
.SH NAME
|
||||
smb.conf \- The configuration file for the Samba suite
|
||||
.SH "SYNOPSIS"
|
||||
@ -7016,9 +7016,13 @@ used when listing a username of the form of \fIDOMAIN
|
||||
is only applicable when using the \fIpam_winbind.so\fR
|
||||
and \fInss_winbind.so\fR modules for UNIX services.
|
||||
|
||||
Example: \fBwinbind separator = \\\fR
|
||||
Please note that setting this parameter to + causes problems
|
||||
with group membership at least on glibc systems, as the character +
|
||||
is used as a special character for NIS in /etc/group.
|
||||
|
||||
Example: \fBwinbind separator = +\fR
|
||||
Example: \fBwinbind separator = \\\\\fR
|
||||
|
||||
Example: \fBwinbind separator = /\fR
|
||||
.TP
|
||||
\fBwinbind uid\fR
|
||||
The winbind gid parameter specifies the range of group
|
||||
|
Loading…
x
Reference in New Issue
Block a user