Changeset 231 for branches/samba-3.2.x/docs/manpages/wbinfo.1
- Timestamp:
- May 27, 2009, 9:08:03 AM (16 years ago)
- File:
-
- 1 edited
-
branches/samba-3.2.x/docs/manpages/wbinfo.1 (modified) (11 diffs)
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.2.x/docs/manpages/wbinfo.1
r229 r231 1 1 .\" Title: wbinfo 2 .\" Author: 3 .\" Generator: DocBook XSL Stylesheets v1.7 3.1<http://docbook.sf.net/>4 .\" Date: 12/19/20082 .\" Author: [see the "AUTHOR" section] 3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> 4 .\" Date: 02/03/2009 5 5 .\" Manual: User Commands 6 6 .\" Source: Samba 3.2 7 .\" Language: English 7 8 .\" 8 .TH "WBINFO" "1" "12/19/2008" "Samba 3\.2" "User Commands" 9 .TH "WBINFO" "1" "02/03/2009" "Samba 3\&.2" "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 .. 159 .\" ----------------------------------------------------------------- 160 .\" * set default formatting 161 .\" ----------------------------------------------------------------- 9 162 .\" disable hyphenation 10 163 .nh 11 164 .\" disable justification (adjust text to left margin only) 12 165 .ad l 13 .SH "NAME" 14 wbinfo - Query information from winbind daemon 15 .SH "SYNOPSIS" 16 .HP 1 17 wbinfo [\-a\ user%password] [\-\-all\-domains] [\-\-allocate\-gid] [\-\-allocate\-uid] [\-D\ domain] [\-\-domain\ domain] [\-g] [\-\-getdcname\ domain] [\-\-get\-auth\-user] [\-G\ gid] [\-h] [\-i\ user] [\-I\ ip] [\-K\ user%password] [\-m] [\-n\ name] [\-N\ netbios\-name] [\-\-own\-domain] [\-p] [\-r\ user] [\-s\ sid] [\-\-separator] [\-\-sequence] [\-\-set\-auth\-user\ user%password] [\-S\ sid] [\-t] [\-u] [\-\-uid\-info\ uid] [\-\-user\-domgroups\ sid] [\-\-user\-sids\ sid] [\-U\ uid] [\-V] [\-Y\ sid] [\-\-verbose] 166 .\" ----------------------------------------------------------------- 167 .\" * MAIN CONTENT STARTS HERE * 168 .\" ----------------------------------------------------------------- 169 .SH "Name" 170 wbinfo \- Query information from winbind daemon 171 .SH "Synopsis" 172 .fam C 173 .HP \w'\ 'u 174 \FCwbinfo\F[] [\-a\ user%password] [\-\-all\-domains] [\-\-allocate\-gid] [\-\-allocate\-uid] [\-D\ domain] [\-\-domain\ domain] [\-g] [\-\-getdcname\ domain] [\-\-get\-auth\-user] [\-G\ gid] [\-h] [\-i\ user] [\-I\ ip] [\-K\ user%password] [\-m] [\-n\ name] [\-N\ netbios\-name] [\-\-own\-domain] [\-p] [\-r\ user] [\-s\ sid] [\-\-separator] [\-\-sequence] [\-\-set\-auth\-user\ user%password] [\-S\ sid] [\-t] [\-u] [\-\-uid\-info\ uid] [\-\-user\-domgroups\ sid] [\-\-user\-sids\ sid] [\-U\ uid] [\-V] [\-Y\ sid] [\-\-verbose] 175 .fam 18 176 .SH "DESCRIPTION" 19 177 .PP 20 178 This tool is part of the 21 179 \fBsamba\fR(7) 22 suite\ .180 suite\&. 23 181 .PP 24 182 The 25 wbinfo 183 \FCwbinfo\F[] 26 184 program queries and returns information created and used by the 27 185 \fBwinbindd\fR(8) 28 daemon\ .186 daemon\&. 29 187 .PP 30 188 The 31 189 \fBwinbindd\fR(8) 32 190 daemon must be configured and running for the 33 wbinfo 34 program to be able to return information\ .191 \FCwbinfo\F[] 192 program to be able to return information\&. 35 193 .SH "OPTIONS" 36 194 .PP 37 195 \-a|\-\-authenticate username%password 38 196 .RS 4 39 Attempt to authenticate a user via winbindd\. This checks both authenticaion methods and reports its results\. 197 Attempt to authenticate a user via winbindd\&. This checks both authenticaion methods and reports its results\&. 198 .if n \{\ 40 199 .sp 200 .\} 201 .RS 4 202 .BM yellow 41 203 .it 1 an-trap 42 204 .nr an-no-space-flag 1 43 205 .nr an-break-flag 1 44 206 .br 45 Note 46 Do not be tempted to use this functionality for authentication in third\-party applications\. Instead use 47 \fBntlm_auth\fR(1)\. 207 .ps +1 208 \fBNote\fR 209 .ps -1 210 .br 211 Do not be tempted to use this functionality for authentication in third\-party applications\&. Instead use 212 \fBntlm_auth\fR(1)\&. 213 .sp .5v 214 .EM yellow 215 .RE 48 216 .RE 49 217 .PP … … 60 228 \-\-all\-domains 61 229 .RS 4 62 List all domains (trusted and own domain)\ .230 List all domains (trusted and own domain)\&. 63 231 .RE 64 232 .PP 65 233 \-\-domain name 66 234 .RS 4 67 This parameter sets the domain on which any specified operations will performed\ . If special domain name \'\.\' is used to represent the current domain to which winbindd belongs\. Currently only the235 This parameter sets the domain on which any specified operations will performed\&. If special domain name \'\&.\' is used to represent the current domain to which winbindd belongs\&. Currently only the 68 236 \fB\-\-sequence\fR, 69 237 \fB\-u\fR, and 70 238 \fB\-g\fR 71 options honor this parameter\ .239 options honor this parameter\&. 72 240 .RE 73 241 .PP 74 242 \-D|\-\-domain\-info domain 75 243 .RS 4 76 Show most of the info we have about the domain\ .244 Show most of the info we have about the domain\&. 77 245 .RE 78 246 .PP … … 81 249 This option will list all groups available in the Windows NT domain for which the 82 250 \fBsamba\fR(7) 83 daemon is operating in\ . Groups in all trusted domains will also be listed\. Note that this operation does not assign group ids to any groups that have not already been seen by84 \fBwinbindd\fR(8)\ .251 daemon is operating in\&. Groups in all trusted domains will also be listed\&. Note that this operation does not assign group ids to any groups that have not already been seen by 252 \fBwinbindd\fR(8)\&. 85 253 .RE 86 254 .PP 87 255 \-\-get\-auth\-user 88 256 .RS 4 89 Print username and password used by winbindd during session setup to a domain controller\ . Username and password can be set using90 \fB\-\-set\-auth\-user\fR\ . Only available for root\.257 Print username and password used by winbindd during session setup to a domain controller\&. Username and password can be set using 258 \fB\-\-set\-auth\-user\fR\&. Only available for root\&. 91 259 .RE 92 260 .PP 93 261 \-\-getdcname domain 94 262 .RS 4 95 Get the DC name for the specified domain\ .263 Get the DC name for the specified domain\&. 96 264 .RE 97 265 .PP 98 266 \-G|\-\-gid\-to\-sid gid 99 267 .RS 4 100 Try to convert a UNIX group id to a Windows NT SID\ . If the gid specified does not refer to one within the idmap gid range then the operation will fail\.268 Try to convert a UNIX group id to a Windows NT SID\&. If the gid specified does not refer to one within the idmap gid range then the operation will fail\&. 101 269 .RE 102 270 .PP 103 271 \-i|\-\-user\-info user 104 272 .RS 4 105 Get user info\ .273 Get user info\&. 106 274 .RE 107 275 .PP … … 114 282 to send a node status request to get the NetBIOS name associated with the IP address specified by the 115 283 \fIip\fR 116 parameter\ .284 parameter\&. 117 285 .RE 118 286 .PP 119 287 \-K|\-\-krb5auth username%password 120 288 .RS 4 121 Attempt to authenticate a user via Kerberos\ .289 Attempt to authenticate a user via Kerberos\&. 122 290 .RE 123 291 .PP … … 126 294 Produce a list of domains trusted by the Windows NT server 127 295 \fBwinbindd\fR(8) 128 contacts when resolving names\ . This list does not include the Windows NT domain the server is a Primary Domain Controller for\.296 contacts when resolving names\&. This list does not include the Windows NT domain the server is a Primary Domain Controller for\&. 129 297 .RE 130 298 .PP … … 135 303 option queries 136 304 \fBwinbindd\fR(8) 137 for the SID associated with the name specified\ . Domain names can be specified before the user name by using the winbind separator character\. For example CWDOM1/Administrator refers to the Administrator user in the domain CWDOM1\. If no domain is specified then the domain used is the one specified in the305 for the SID associated with the name specified\&. Domain names can be specified before the user name by using the winbind separator character\&. For example CWDOM1/Administrator refers to the Administrator user in the domain CWDOM1\&. If no domain is specified then the domain used is the one specified in the 138 306 \fBsmb.conf\fR(5) 139 307 \fIworkgroup \fR 140 parameter\ .308 parameter\&. 141 309 .RE 142 310 .PP … … 149 317 to query the WINS server for the IP address associated with the NetBIOS name specified by the 150 318 \fIname\fR 151 parameter\ .319 parameter\&. 152 320 .RE 153 321 .PP 154 322 \-\-own\-domain 155 323 .RS 4 156 List own domain\ .324 List own domain\&. 157 325 .RE 158 326 .PP 159 327 \-p|\-\-ping 160 328 .RS 4 161 Check whether winbindd is still alive\ . Prints out either \'succeeded\' or \'failed\'\.329 Check whether winbindd is still alive\&. Prints out either \'succeeded\' or \'failed\'\&. 162 330 .RE 163 331 .PP 164 332 \-r|\-\-user\-groups username 165 333 .RS 4 166 Try to obtain the list of UNIX group ids to which the user belongs\ . This only works for users defined on a Domain Controller\.334 Try to obtain the list of UNIX group ids to which the user belongs\&. This only works for users defined on a Domain Controller\&. 167 335 .RE 168 336 .PP … … 171 339 Use 172 340 \fI\-s\fR 173 to resolve a SID to a name\ . This is the inverse of the341 to resolve a SID to a name\&. This is the inverse of the 174 342 \fI\-n \fR 175 option above\ . SIDs must be specified as ASCII strings in the traditional Microsoft format\. For example, S\-1\-5\-21\-1455342024\-3071081365\-2475485837\-500\.343 option above\&. SIDs must be specified as ASCII strings in the traditional Microsoft format\&. For example, S\-1\-5\-21\-1455342024\-3071081365\-2475485837\-500\&. 176 344 .RE 177 345 .PP 178 346 \-\-separator 179 347 .RS 4 180 Get the active winbind separator\ .348 Get the active winbind separator\&. 181 349 .RE 182 350 .PP … … 188 356 \-\-set\-auth\-user username%password 189 357 .RS 4 190 Store username and password used by winbindd during session setup to a domain controller\ . This enables winbindd to operate in a Windows 2000 domain with Restrict Anonymous turned on (a\.k\.a\. Permissions compatible with Windows 2000 servers only)\.358 Store username and password used by winbindd during session setup to a domain controller\&. This enables winbindd to operate in a Windows 2000 domain with Restrict Anonymous turned on (a\&.k\&.a\&. Permissions compatible with Windows 2000 servers only)\&. 191 359 .RE 192 360 .PP 193 361 \-S|\-\-sid\-to\-uid sid 194 362 .RS 4 195 Convert a SID to a UNIX user id\ . If the SID does not correspond to a UNIX user mapped by196 \fBwinbindd\fR(8) 197 then the operation will fail\ .363 Convert a SID to a UNIX user id\&. If the SID does not correspond to a UNIX user mapped by 364 \fBwinbindd\fR(8) 365 then the operation will fail\&. 198 366 .RE 199 367 .PP 200 368 \-t|\-\-check\-secret 201 369 .RS 4 202 Verify that the workstation trust account created when the Samba server is added to the Windows NT domain is working\ .370 Verify that the workstation trust account created when the Samba server is added to the Windows NT domain is working\&. 203 371 .RE 204 372 .PP … … 207 375 This option will list all users available in the Windows NT domain for which the 208 376 \fBwinbindd\fR(8) 209 daemon is operating in\ . Users in all trusted domains will also be listed\. Note that this operation does not assign user ids to any users that have not already been seen by210 \fBwinbindd\fR(8) 211 \ .377 daemon is operating in\&. Users in all trusted domains will also be listed\&. Note that this operation does not assign user ids to any users that have not already been seen by 378 \fBwinbindd\fR(8) 379 \&. 212 380 .RE 213 381 .PP 214 382 \-\-uid\-info UID 215 383 .RS 4 216 Get user info for the user conencted to user id UID\ .384 Get user info for the user conencted to user id UID\&. 217 385 .RE 218 386 .PP 219 387 \-\-user\-domgroups SID 220 388 .RS 4 221 Get user domain groups\ .389 Get user domain groups\&. 222 390 .RE 223 391 .PP 224 392 \-\-user\-sids SID 225 393 .RS 4 226 Get user group SIDs for user\ .394 Get user group SIDs for user\&. 227 395 .RE 228 396 .PP 229 397 \-U|\-\-uid\-to\-sid uid 230 398 .RS 4 231 Try to convert a UNIX user id to a Windows NT SID\ . If the uid specified does not refer to one within the idmap uid range then the operation will fail\.399 Try to convert a UNIX user id to a Windows NT SID\&. If the uid specified does not refer to one within the idmap uid range then the operation will fail\&. 232 400 .RE 233 401 .PP 234 402 \-\-verbose 235 403 .RS 4 236 Print additional information about the query results\ .404 Print additional information about the query results\&. 237 405 .RE 238 406 .PP 239 407 \-Y|\-\-sid\-to\-gid sid 240 408 .RS 4 241 Convert a SID to a UNIX group id\ . If the SID does not correspond to a UNIX group mapped by242 \fBwinbindd\fR(8) 243 then the operation will fail\ .409 Convert a SID to a UNIX group id\&. If the SID does not correspond to a UNIX group mapped by 410 \fBwinbindd\fR(8) 411 then the operation will fail\&. 244 412 .RE 245 413 .PP 246 414 \-V 247 415 .RS 4 248 Prints the program version number\ .416 Prints the program version number\&. 249 417 .RE 250 418 .PP 251 419 \-h|\-\-help 252 420 .RS 4 253 Print a summary of command line options\ .421 Print a summary of command line options\&. 254 422 .RE 255 423 .SH "EXIT STATUS" 256 424 .PP 257 The wbinfo program returns 0 if the operation succeeded, or 1 if the operation failed\ . If the425 The wbinfo program returns 0 if the operation succeeded, or 1 if the operation failed\&. If the 258 426 \fBwinbindd\fR(8) 259 427 daemon is not working 260 wbinfo 261 will always return failure\ .428 \FCwbinfo\F[] 429 will always return failure\&. 262 430 .SH "VERSION" 263 431 .PP 264 This man page is correct for version 3 of the Samba suite\ .432 This man page is correct for version 3 of the Samba suite\&. 265 433 .SH "SEE ALSO" 266 434 .PP … … 270 438 .SH "AUTHOR" 271 439 .PP 272 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\.273 .PP 274 wbinfo 440 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\&. 441 .PP 442 \FCwbinfo\F[] 275 443 and 276 winbindd 277 were written by Tim Potter\ .278 .PP 279 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\.444 \FCwinbindd\F[] 445 were written by Tim Potter\&. 446 .PP 447 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\&.
Note:
See TracChangeset
for help on using the changeset viewer.
