Ignore:
Timestamp:
Jan 15, 2010, 8:21:06 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update Samba 3.3 to 3.3.10 (docs)

File:
1 edited

Legend:

Unmodified
Added
Removed

  • branches/samba-3.3.x/docs/manpages/rpcclient.1

    r342 r368  
     1'\" t
    12.\"     Title: rpcclient
    23.\"    Author: [see the "AUTHOR" section]
    3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
    4 .\"      Date: 10/12/2009
     4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
     5.\"      Date: 01/14/2010
    56.\"    Manual: User Commands
    67.\"    Source: Samba 3.3
    78.\"  Language: English
    89.\"
    9 .TH "RPCCLIENT" "1" "10/12/2009" "Samba 3\&.3" "User Commands"
    10 .\" -----------------------------------------------------------------
    11 .\" * (re)Define some macros
    12 .\" -----------------------------------------------------------------
    13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    14 .\" toupper - uppercase a string (locale-aware)
    15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    16 .de toupper
    17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
    18 \\$*
    19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
    20 ..
    21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    22 .\" SH-xref - format a cross-reference to an SH section
    23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    24 .de SH-xref
    25 .ie n \{\
    26 .\}
    27 .toupper \\$*
    28 .el \{\
    29 \\$*
    30 .\}
    31 ..
    32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    33 .\" SH - level-one heading that works better for non-TTY output
    34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    35 .de1 SH
    36 .\" put an extra blank line of space above the head in non-TTY output
    37 .if t \{\
    38 .sp 1
    39 .\}
    40 .sp \\n[PD]u
    41 .nr an-level 1
    42 .set-an-margin
    43 .nr an-prevailing-indent \\n[IN]
    44 .fi
    45 .in \\n[an-margin]u
    46 .ti 0
    47 .HTML-TAG ".NH \\n[an-level]"
    48 .it 1 an-trap
    49 .nr an-no-space-flag 1
    50 .nr an-break-flag 1
    51 \." make the size of the head bigger
    52 .ps +3
    53 .ft B
    54 .ne (2v + 1u)
    55 .ie n \{\
    56 .\" if n (TTY output), use uppercase
    57 .toupper \\$*
    58 .\}
    59 .el \{\
    60 .nr an-break-flag 0
    61 .\" if not n (not TTY), use normal case (not uppercase)
    62 \\$1
    63 .in \\n[an-margin]u
    64 .ti 0
    65 .\" if not n (not TTY), put a border/line under subheading
    66 .sp -.6
    67 \l'\n(.lu'
    68 .\}
    69 ..
    70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    71 .\" SS - level-two heading that works better for non-TTY output
    72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    73 .de1 SS
    74 .sp \\n[PD]u
    75 .nr an-level 1
    76 .set-an-margin
    77 .nr an-prevailing-indent \\n[IN]
    78 .fi
    79 .in \\n[IN]u
    80 .ti \\n[SN]u
    81 .it 1 an-trap
    82 .nr an-no-space-flag 1
    83 .nr an-break-flag 1
    84 .ps \\n[PS-SS]u
    85 \." make the size of the head bigger
    86 .ps +2
    87 .ft B
    88 .ne (2v + 1u)
    89 .if \\n[.$] \&\\$*
    90 ..
    91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    92 .\" BB/BE - put background/screen (filled box) around block of text
    93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    94 .de BB
    95 .if t \{\
    96 .sp -.5
    97 .br
    98 .in +2n
    99 .ll -2n
    100 .gcolor red
    101 .di BX
    102 .\}
    103 ..
    104 .de EB
    105 .if t \{\
    106 .if "\\$2"adjust-for-leading-newline" \{\
    107 .sp -1
    108 .\}
    109 .br
    110 .di
    111 .in
    112 .ll
    113 .gcolor
    114 .nr BW \\n(.lu-\\n(.i
    115 .nr BH \\n(dn+.5v
    116 .ne \\n(BHu+.5v
    117 .ie "\\$2"adjust-for-leading-newline" \{\
    118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
    119 .\}
    120 .el \{\
    121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
    122 .\}
    123 .in 0
    124 .sp -.5v
    125 .nf
    126 .BX
    127 .in
    128 .sp .5v
    129 .fi
    130 .\}
    131 ..
    132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    133 .\" BM/EM - put colored marker in margin next to block of text
    134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    135 .de BM
    136 .if t \{\
    137 .br
    138 .ll -2n
    139 .gcolor red
    140 .di BX
    141 .\}
    142 ..
    143 .de EM
    144 .if t \{\
    145 .br
    146 .di
    147 .ll
    148 .gcolor
    149 .nr BH \\n(dn
    150 .ne \\n(BHu
    151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
    152 .in 0
    153 .nf
    154 .BX
    155 .in
    156 .fi
    157 .\}
    158 ..
     10.TH "RPCCLIENT" "1" "01/14/2010" "Samba 3\&.3" "User Commands"
    15911.\" -----------------------------------------------------------------
    16012.\" * set default formatting
    … …  
    16719.\" * MAIN CONTENT STARTS HERE *
    16820.\" -----------------------------------------------------------------
    169 .SH "Name"
     21.SH "NAME"
    17022rpcclient \- tool for executing client side MS\-RPC functions
    171 .SH "Synopsis"
    172 .fam C
     23.SH "SYNOPSIS"
    17324.HP \w'\ 'u
    174 \FCrpcclient\F[] [\-A\ authfile] [\-c\ <command\ string>] [\-d\ debuglevel] [\-h] [\-l\ logdir] [\-N] [\-s\ <smb\ config\ file>] [\-U\ username[%password]] [\-W\ workgroup] [\-N] [\-I\ destinationIP] {server}
    175 .fam
     25rpcclient [\-A\ authfile] [\-c\ <command\ string>] [\-d\ debuglevel] [\-h] [\-l\ logdir] [\-N] [\-s\ <smb\ config\ file>] [\-U\ username[%password]] [\-W\ workgroup] [\-N] [\-I\ destinationIP] {server}
    17626.SH "DESCRIPTION"
    17727.PP
    … …  
    18030suite\&.
    18131.PP
    182 \FCrpcclient\F[]
     32rpcclient
    18333is 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\&.
    18434.SH "OPTIONS"
    … …  
    21969.sp
    22070Note that specifying this parameter here will override the
    221 \m[blue]\fBlog level\fR\m[]
     71\m[blue]\fB\%smb.conf.5.html#\fR\m[]
    22272parameter in the
    223 \FCsmb\&.conf\F[]
     73smb\&.conf
    22474file\&.
    22575.RE
    22676.PP
    227 \-V
     77\-V|\-\-version
    22878.RS 4
    22979Prints the program version number\&.
    23080.RE
    23181.PP
    232 \-s <configuration file>
     82\-s|\-\-configfile <configuration file>
    23383.RS 4
    23484The 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
    235 \FCsmb\&.conf\F[]
     85smb\&.conf
    23686for more information\&. The default configuration file name is determined at compile time\&.
    23787.RE
    … …  
    24494.RE
    24595.PP
    246 \-N
     96\-N|\-\-no\-pass
    24797.RS 4
    24898If 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\&.
    … …  
    253103.RE
    254104.PP
    255 \-k
     105\-k|\-\-kerberos
    256106.RS 4
    257107Try to authenticate with kerberos\&. Only useful in an Active Directory environment\&.
    … …  
    265115.RS 4
    266116.\}
    267 .fam C
    268 .ps -1
    269117.nf
    270 .if t \{\
    271 .sp -1
    272 .\}
    273 .BB lightgray adjust-for-leading-newline
    274 .sp -1
    275 
    276118username = <value>
    277119password = <value>
    278120domain   = <value>
    279 .EB lightgray adjust-for-leading-newline
    280 .if t \{\
    281 .sp 1
    282 .\}
    283121.fi
    284 .fam
    285 .ps +1
    286122.if n \{\
    287123.RE
    … …  
    308144.sp
    309145Be cautious about including passwords in scripts\&. Also, on many systems the command line of a running process may be seen via the
    310 \FCps\F[]
     146ps
    311147command\&. To be safe always allow
    312 \FCrpcclient\F[]
     148rpcclient
    313149to prompt for a password and type it in directly\&.
    314150.RE
    315151.PP
    316 \-n <primary NetBIOS name>
     152\-n|\-\-netbiosname <primary NetBIOS name>
    317153.RS 4
    318154This option allows you to override the NetBIOS name that Samba uses for itself\&. This is identical to setting the
    319 \m[blue]\fBnetbios name\fR\m[]
     155\m[blue]\fB\%smb.conf.5.html#\fR\m[]
    320156parameter in the
    321 \FCsmb\&.conf\F[]
     157smb\&.conf
    322158file\&. However, a command line setting will take precedence over settings in
    323 \FCsmb\&.conf\F[]\&.
    324 .RE
    325 .PP
    326 \-i <scope>
     159smb\&.conf\&.
     160.RE
     161.PP
     162\-i|\-\-scope <scope>
    327163.RS 4
    328164This specifies a NetBIOS scope that
    329 \FCnmblookup\F[]
     165nmblookup
    330166will 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
    331167\fIvery\fR
    … …  
    338174.RE
    339175.PP
    340 \-O socket options
     176\-O|\-\-socket\-options socket options
    341177.RS 4
    342178TCP socket options to set on the client socket\&. See the socket options parameter in the
    343 \FCsmb\&.conf\F[]
     179smb\&.conf
    344180manual page for the list of valid options\&.
    345181.RE
    … …  
    578414.RS 4
    579415Execute 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
    580 \FCgetdriverdir\F[]\&. Possible values for
     416getdriverdir\&. Possible values for
    581417\fIarch\fR
    582418are the same as those for the
    583 \FCgetdriverdir\F[]
     419getdriverdir
    584420command\&. The
    585421\fIconfig\fR
    … …  
    589425.RS 4
    590426.\}
    591 .fam C
    592 .ps -1
    593427.nf
    594 .if t \{\
    595 .sp -1
    596 .\}
    597 .BB lightgray adjust-for-leading-newline
    598 .sp -1
    599 
    600428Long Printer Name:\e
    601429Driver File Name:\e
    … …  
    606434Default Data Type:\e
    607435Comma Separated list of Files
    608 .EB lightgray adjust-for-leading-newline
    609 .if t \{\
    610 .sp 1
    611 .\}
    612436.fi
    613 .fam
    614 .ps +1
    615437.if n \{\
    616438.RE
    … …  
    629451.RS 4
    630452Add 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
    631 \FCadddriver\F[]) and the
     453adddriver) and the
    632454\fIport\fRmust be a valid port name (see
    633 \FCenumports\F[]\&.
     455enumports\&.
    634456.RE
    635457.PP
    … …  
    682504.RS 4
    683505Retrieve the data for a given printer setting\&. See the
    684 \FCenumdata\F[]
     506enumdata
    685507command for more information\&. This command corresponds to the GetPrinterData() MS Platform SDK function\&.
    686508.RE
    … …  
    723545.sp
    724546See also the
    725 \FCenumprinters\F[]
     547enumprinters
    726548and
    727 \FCenumdrivers\F[]
     549enumdrivers
    728550commands for obtaining a list of of installed printers and drivers\&.
    729551.RE
    … …  
    814636.RS 4
    815637Exit
    816 \FCrpcclient \F[]\&.
     638rpcclient\&.
    817639.RE
    818640.SH "BUGS"
    819641.PP
    820 \FCrpcclient\F[]
     642rpcclient
    821643is 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\&.
    822644.PP
Note: See TracChangeset for help on using the changeset viewer.