Changeset 134 for branches/samba-3.0/docs/manpages/wbinfo.1
- Timestamp:
- May 23, 2008, 6:56:41 AM (17 years ago)
- File:
-
- 1 edited
-
branches/samba-3.0/docs/manpages/wbinfo.1 (modified) (5 diffs)
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.0/docs/manpages/wbinfo.1
r44 r134 1 .\"Generated by db2man.xsl. Don't modify this, modify the source. 2 .de Sh \" Subsection 3 .br 4 .if t .Sp 5 .ne 5 6 .PP 7 \fB\\$1\fR 8 .PP 9 .. 10 .de Sp \" Vertical space (when we can't use .PP) 11 .if t .sp .5v 12 .if n .sp 13 .. 14 .de Ip \" List item 15 .br 16 .ie \\n(.$>=3 .ne \\$3 17 .el .ne 3 18 .IP "\\$1" \\$2 19 .. 20 .TH "WBINFO" 1 "" "" "" 1 .\" Title: wbinfo 2 .\" Author: 3 .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/> 4 .\" Date: 05/21/2008 5 .\" Manual: User Commands 6 .\" Source: Samba 3.0 7 .\" 8 .TH "WBINFO" "1" "05/21/2008" "Samba 3\.0" "User Commands" 9 .\" disable hyphenation 10 .nh 11 .\" disable justification (adjust text to left margin only) 12 .ad l 21 13 .SH "NAME" 22 14 wbinfo - Query information from winbind daemon 23 15 .SH "SYNOPSIS" 24 16 .HP 1 25 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] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [-Y sid]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] 26 18 .SH "DESCRIPTION" 27 19 .PP 28 20 This tool is part of the 29 21 \fBsamba\fR(7) 30 suite .22 suite\. 31 23 .PP 32 24 The … … 34 26 program queries and returns information created and used by the 35 27 \fBwinbindd\fR(8) 36 daemon .28 daemon\. 37 29 .PP 38 30 The … … 40 32 daemon must be configured and running for the 41 33 wbinfo 42 program to be able to return information .34 program to be able to return information\. 43 35 .SH "OPTIONS" 44 36 .PP 45 -a|--authenticate username%password46 .RS 3n47 Attempt to authenticate a user via winbindd . This checks both authenticaion methods and reports its results.37 \-a|\-\-authenticate username%password 38 .RS 4 39 Attempt to authenticate a user via winbindd\. This checks both authenticaion methods and reports its results\. 48 40 .sp 49 41 .it 1 an-trap … … 51 43 .nr an-break-flag 1 52 44 .br 53 \fBNote\fR 54 Do not be tempted to use this functionality for authentication in third -party applications. Instead use55 \fBntlm_auth\fR(1) .56 .RE 57 .PP 58 --allocate-gid59 .RS 3n45 Note 46 Do not be tempted to use this functionality for authentication in third\-party applications\. Instead use 47 \fBntlm_auth\fR(1)\. 48 .RE 49 .PP 50 \-\-allocate\-gid 51 .RS 4 60 52 Get a new GID out of idmap 61 53 .RE 62 54 .PP 63 --allocate-uid64 .RS 3n55 \-\-allocate\-uid 56 .RS 4 65 57 Get a new UID out of idmap 66 58 .RE 67 59 .PP 68 --all-domains69 .RS 3n70 List all domains (trusted and own domain) .71 .RE 72 .PP 73 --domain name74 .RS 3n75 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 the76 \fB --sequence\fR,77 \fB -u\fR, and78 \fB -g\fR79 options honor this parameter .80 .RE 81 .PP 82 -D|--domain-info domain83 .RS 3n84 Show most of the info we have about the domain .85 .RE 86 .PP 87 -g|--domain-groups88 .RS 3n60 \-\-all\-domains 61 .RS 4 62 List all domains (trusted and own domain)\. 63 .RE 64 .PP 65 \-\-domain name 66 .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 the 68 \fB\-\-sequence\fR, 69 \fB\-u\fR, and 70 \fB\-g\fR 71 options honor this parameter\. 72 .RE 73 .PP 74 \-D|\-\-domain\-info domain 75 .RS 4 76 Show most of the info we have about the domain\. 77 .RE 78 .PP 79 \-g|\-\-domain\-groups 80 .RS 4 89 81 This option will list all groups available in the Windows NT domain for which the 90 82 \fBsamba\fR(7) 91 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 by92 \fBwinbindd\fR(8) .93 .RE 94 .PP 95 --get-auth-user96 .RS 3n97 Print username and password used by winbindd during session setup to a domain controller . Username and password can be set using98 \fB --set-auth-user\fR. Only available for root.99 .RE 100 .PP 101 --getdcname domain102 .RS 3n103 Get the DC name for the specified domain .104 .RE 105 .PP 106 -G|--gid-to-sid gid107 .RS 3n108 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.109 .RE 110 .PP 111 -i|--user-info user112 .RS 3n113 Get user info .114 .RE 115 .PP 116 -I|--WINS-by-ip ip117 .RS 3n118 The 119 \fI -I\fR83 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 84 \fBwinbindd\fR(8)\. 85 .RE 86 .PP 87 \-\-get\-auth\-user 88 .RS 4 89 Print username and password used by winbindd during session setup to a domain controller\. Username and password can be set using 90 \fB\-\-set\-auth\-user\fR\. Only available for root\. 91 .RE 92 .PP 93 \-\-getdcname domain 94 .RS 4 95 Get the DC name for the specified domain\. 96 .RE 97 .PP 98 \-G|\-\-gid\-to\-sid gid 99 .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\. 101 .RE 102 .PP 103 \-i|\-\-user\-info user 104 .RS 4 105 Get user info\. 106 .RE 107 .PP 108 \-I|\-\-WINS\-by\-ip ip 109 .RS 4 110 The 111 \fI\-I\fR 120 112 option queries 121 113 \fBwinbindd\fR(8) 122 114 to send a node status request to get the NetBIOS name associated with the IP address specified by the 123 115 \fIip\fR 124 parameter .125 .RE 126 .PP 127 -K|--krb5auth username%password128 .RS 3n129 Attempt to authenticate a user via Kerberos .130 .RE 131 .PP 132 -m|--trusted-domains133 .RS 3n116 parameter\. 117 .RE 118 .PP 119 \-K|\-\-krb5auth username%password 120 .RS 4 121 Attempt to authenticate a user via Kerberos\. 122 .RE 123 .PP 124 \-m|\-\-trusted\-domains 125 .RS 4 134 126 Produce a list of domains trusted by the Windows NT server 135 127 \fBwinbindd\fR(8) 136 contacts when resolving names . This list does not include the Windows NT domain the server is a Primary Domain Controller for.137 .RE 138 .PP 139 -n|--name-to-sid name140 .RS 3n141 The 142 \fI -n\fR128 contacts when resolving names\. This list does not include the Windows NT domain the server is a Primary Domain Controller for\. 129 .RE 130 .PP 131 \-n|\-\-name\-to\-sid name 132 .RS 4 133 The 134 \fI\-n\fR 143 135 option queries 144 136 \fBwinbindd\fR(8) 145 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 the137 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 146 138 \fBsmb.conf\fR(5) 147 139 \fIworkgroup \fR 148 parameter .149 .RE 150 .PP 151 -N|--WINS-by-name name152 .RS 3n153 The 154 \fI -N\fR140 parameter\. 141 .RE 142 .PP 143 \-N|\-\-WINS\-by\-name name 144 .RS 4 145 The 146 \fI\-N\fR 155 147 option queries 156 148 \fBwinbindd\fR(8) 157 149 to query the WINS server for the IP address associated with the NetBIOS name specified by the 158 150 \fIname\fR 159 parameter .160 .RE 161 .PP 162 --own-domain163 .RS 3n164 List own domain .165 .RE 166 .PP 167 -p|--ping168 .RS 3n169 Check whether winbindd is still alive . Prints out either 'succeeded' or 'failed'.170 .RE 171 .PP 172 -r|--user-groups username173 .RS 3n174 Try to obtain the list of UNIX group ids to which the user belongs . This only works for users defined on a Domain Controller.175 .RE 176 .PP 177 -s|--sid-to-name sid178 .RS 3n151 parameter\. 152 .RE 153 .PP 154 \-\-own\-domain 155 .RS 4 156 List own domain\. 157 .RE 158 .PP 159 \-p|\-\-ping 160 .RS 4 161 Check whether winbindd is still alive\. Prints out either \'succeeded\' or \'failed\'\. 162 .RE 163 .PP 164 \-r|\-\-user\-groups username 165 .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\. 167 .RE 168 .PP 169 \-s|\-\-sid\-to\-name sid 170 .RS 4 179 171 Use 180 \fI -s\fR181 to resolve a SID to a name . This is the inverse of the182 \fI -n \fR183 option above . SIDs must be specified as ASCII strings in the traditional Microsoft format. For example, S-1-5-21-1455342024-3071081365-2475485837-500.184 .RE 185 .PP 186 --separator187 .RS 3n188 Get the active winbind separator .189 .RE 190 .PP 191 --sequence192 .RS 3n172 \fI\-s\fR 173 to resolve a SID to a name\. This is the inverse of the 174 \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\. 176 .RE 177 .PP 178 \-\-separator 179 .RS 4 180 Get the active winbind separator\. 181 .RE 182 .PP 183 \-\-sequence 184 .RS 4 193 185 Show sequence numbers of all known domains 194 186 .RE 195 187 .PP 196 --set-auth-user username%password197 .RS 3n198 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 compatiable with Windows 2000 servers only).199 .RE 200 .PP 201 -S|--sid-to-uid sid202 .RS 3n203 Convert a SID to a UNIX user id . If the SID does not correspond to a UNIX user mapped by204 \fBwinbindd\fR(8) 205 then the operation will fail .206 .RE 207 .PP 208 -t|--check-secret209 .RS 3n210 Verify that the workstation trust account created when the Samba server is added to the Windows NT domain is working .211 .RE 212 .PP 213 -u|--domain-users214 .RS 3n188 \-\-set\-auth\-user username%password 189 .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)\. 191 .RE 192 .PP 193 \-S|\-\-sid\-to\-uid sid 194 .RS 4 195 Convert a SID to a UNIX user id\. If the SID does not correspond to a UNIX user mapped by 196 \fBwinbindd\fR(8) 197 then the operation will fail\. 198 .RE 199 .PP 200 \-t|\-\-check\-secret 201 .RS 4 202 Verify that the workstation trust account created when the Samba server is added to the Windows NT domain is working\. 203 .RE 204 .PP 205 \-u|\-\-domain\-users 206 .RS 4 215 207 This option will list all users available in the Windows NT domain for which the 216 208 \fBwinbindd\fR(8) 217 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 218 \fBwinbindd\fR(8) 219 . 220 .RE 221 .PP 222 --user-domgroups SID 223 .RS 3n 224 Get user domain groups. 225 .RE 226 .PP 227 --user-sids SID 228 .RS 3n 229 Get user group SIDs for user. 230 .RE 231 .PP 232 -U|--uid-to-sid uid 233 .RS 3n 234 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. 235 .RE 236 .PP 237 -Y|--sid-to-gid sid 238 .RS 3n 239 Convert a SID to a UNIX group id. If the SID does not correspond to a UNIX group mapped by 240 \fBwinbindd\fR(8) 241 then the operation will fail. 242 .RE 243 .PP 244 -V 245 .RS 3n 246 Prints the program version number. 247 .RE 248 .PP 249 -h|--help 250 .RS 3n 251 Print a summary of command line options. 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 by 210 \fBwinbindd\fR(8) 211 \. 212 .RE 213 .PP 214 \-\-uid\-info UID 215 .RS 4 216 Get user info for the user conencted to user id UID\. 217 .RE 218 .PP 219 \-\-user\-domgroups SID 220 .RS 4 221 Get user domain groups\. 222 .RE 223 .PP 224 \-\-user\-sids SID 225 .RS 4 226 Get user group SIDs for user\. 227 .RE 228 .PP 229 \-U|\-\-uid\-to\-sid uid 230 .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\. 232 .RE 233 .PP 234 \-\-verbose 235 .RS 4 236 Print additional information about the query results\. 237 .RE 238 .PP 239 \-Y|\-\-sid\-to\-gid sid 240 .RS 4 241 Convert a SID to a UNIX group id\. If the SID does not correspond to a UNIX group mapped by 242 \fBwinbindd\fR(8) 243 then the operation will fail\. 244 .RE 245 .PP 246 \-V 247 .RS 4 248 Prints the program version number\. 249 .RE 250 .PP 251 \-h|\-\-help 252 .RS 4 253 Print a summary of command line options\. 252 254 .RE 253 255 .SH "EXIT STATUS" 254 256 .PP 255 The wbinfo program returns 0 if the operation succeeded, or 1 if the operation failed . If the257 The wbinfo program returns 0 if the operation succeeded, or 1 if the operation failed\. If the 256 258 \fBwinbindd\fR(8) 257 259 daemon is not working 258 260 wbinfo 259 will always return failure .261 will always return failure\. 260 262 .SH "VERSION" 261 263 .PP 262 This man page is correct for version 3 .0 of the Samba suite.264 This man page is correct for version 3\.0 of the Samba suite\. 263 265 .SH "SEE ALSO" 264 266 .PP … … 268 270 .SH "AUTHOR" 269 271 .PP 270 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.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\. 271 273 .PP 272 274 wbinfo 273 275 and 274 276 winbindd 275 were written by Tim Potter. 276 .PP 277 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. 278 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\.
Note:
See TracChangeset
for help on using the changeset viewer.
