source: trunk/server/docs/manpages/wbinfo.1@ 620

Last change on this file since 620 was 620, checked in by Herwig Bauernfeind, 14 years ago

Samba 3.5: Update trunk to 3.5.11

File size: 10.7 KB
Line 
1'\" t
2.\" Title: wbinfo
3.\" Author: [see the "AUTHOR" section]
4.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5.\" Date: 08/02/2011
6.\" Manual: User Commands
7.\" Source: Samba 3.5
8.\" Language: English
9.\"
10.TH "WBINFO" "1" "08/02/2011" "Samba 3\&.5" "User Commands"
11.\" -----------------------------------------------------------------
12.\" * set default formatting
13.\" -----------------------------------------------------------------
14.\" disable hyphenation
15.nh
16.\" disable justification (adjust text to left margin only)
17.ad l
18.\" -----------------------------------------------------------------
19.\" * MAIN CONTENT STARTS HERE *
20.\" -----------------------------------------------------------------
21.SH "NAME"
22wbinfo \- Query information from winbind daemon
23.SH "SYNOPSIS"
24.HP \w'\ 'u
25wbinfo [\-a\ user%password] [\-\-all\-domains] [\-\-allocate\-gid] [\-\-allocate\-uid] [\-c] [\-\-ccache\-save] [\-\-change\-user\-password] [\-D\ domain] [\-\-domain\ domain] [\-\-dsgetdcname\ domain] [\-g] [\-\-getdcname\ domain] [\-\-get\-auth\-user] [\-G\ gid] [\-\-gid\-info] [\-\-group\-info] [\-\-help|\-?] [\-i\ user] [\-I\ ip] [\-K\ user%password] [\-\-lanman] [\-m] [\-n\ name] [\-N\ netbios\-name] [\-\-ntlmv2] [\-\-online\-status] [\-\-own\-domain] [\-p] [\-P|\-\-ping\-dc] [\-r\ user] [\-R|\-\-lookup\-rids] [\-\-remove\-uid\-mapping\ uid,sid] [\-\-remove\-gid\-mapping\ gid,sid] [\-s\ sid] [\-\-separator] [\-\-sequence] [\-\-set\-auth\-user\ user%password] [\-\-set\-uid\-mapping\ uid,sid] [\-\-set\-gid\-mapping\ gid,sid] [\-S\ sid] [\-\-sid\-aliases] [\-\-sid\-to\-fullname] [\-t] [\-u] [\-\-uid\-info\ uid] [\-\-usage] [\-\-user\-domgroups\ sid] [\-\-user\-sids\ sid] [\-U\ uid] [\-V] [\-\-verbose] [\-Y\ sid]
26.SH "DESCRIPTION"
27.PP
28This tool is part of the
29\fBsamba\fR(7)
30suite\&.
31.PP
32The
33wbinfo
34program queries and returns information created and used by the
35\fBwinbindd\fR(8)
36daemon\&.
37.PP
38The
39\fBwinbindd\fR(8)
40daemon must be configured and running for the
41wbinfo
42program to be able to return information\&.
43.SH "OPTIONS"
44.PP
45\-a|\-\-authenticate \fIusername%password\fR
46.RS 4
47Attempt to authenticate a user via
48\fBwinbindd\fR(8)\&. This checks both authentication methods and reports its results\&.
49.if n \{\
50.sp
51.\}
52.RS 4
53.it 1 an-trap
54.nr an-no-space-flag 1
55.nr an-break-flag 1
56.br
57.ps +1
58\fBNote\fR
59.ps -1
60.br
61Do not be tempted to use this functionality for authentication in third\-party applications\&. Instead use
62\fBntlm_auth\fR(1)\&.
63.sp .5v
64.RE
65.RE
66.PP
67\-\-allocate\-gid
68.RS 4
69Get a new GID out of idmap
70.RE
71.PP
72\-\-allocate\-uid
73.RS 4
74Get a new UID out of idmap
75.RE
76.PP
77\-\-all\-domains
78.RS 4
79List all domains (trusted and own domain)\&.
80.RE
81.PP
82\-c|\-\-change\-secret
83.RS 4
84Change the trust account password\&. May be used in conjunction with
85\fBdomain\fR
86in order to change interdomain trust account passwords\&.
87.RE
88.PP
89\-\-ccache\-save \fIusername%password\fR
90.RS 4
91Store user and password for ccache\&.
92.RE
93.PP
94\-\-change\-user\-password \fIusername\fR
95.RS 4
96Change the password of a user\&. The old and new password will be prompted\&.
97.RE
98.PP
99\-\-domain \fIname\fR
100.RS 4
101This parameter sets the domain on which any specified operations will performed\&. If special domain name \'\&.\' is used to represent the current domain to which
102\fBwinbindd\fR(8)
103belongs\&. Currently only the
104\fB\-\-sequence\fR,
105\fB\-u\fR, and
106\fB\-g\fR
107options honor this parameter\&.
108.RE
109.PP
110\-D|\-\-domain\-info \fIdomain\fR
111.RS 4
112Show most of the info we have about the specified domain\&.
113.RE
114.PP
115\-\-dsgetdcname \fIdomain\fR
116.RS 4
117Find a DC for a domain\&.
118.RE
119.PP
120\-\-gid\-info \fIgid\fR
121.RS 4
122Get group info from gid\&.
123.RE
124.PP
125\-\-group\-info \fIuser\fR
126.RS 4
127Get group info for user\&.
128.RE
129.PP
130\-g|\-\-domain\-groups
131.RS 4
132This option will list all groups available in the Windows NT domain for which the
133\fBsamba\fR(7)
134daemon 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
135\fBwinbindd\fR(8)\&.
136.RE
137.PP
138\-\-get\-auth\-user
139.RS 4
140Print username and password used by
141\fBwinbindd\fR(8)
142during session setup to a domain controller\&. Username and password can be set using
143\fB\-\-set\-auth\-user\fR\&. Only available for root\&.
144.RE
145.PP
146\-\-getdcname \fIdomain\fR
147.RS 4
148Get the DC name for the specified domain\&.
149.RE
150.PP
151\-G|\-\-gid\-to\-sid \fIgid\fR
152.RS 4
153Try 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\&.
154.RE
155.PP
156\-?
157.RS 4
158Print brief help overview\&.
159.RE
160.PP
161\-i|\-\-user\-info \fIuser\fR
162.RS 4
163Get user info\&.
164.RE
165.PP
166\-I|\-\-WINS\-by\-ip \fIip\fR
167.RS 4
168The
169\fI\-I\fR
170option queries
171\fBwinbindd\fR(8)
172to send a node status request to get the NetBIOS name associated with the IP address specified by the
173\fIip\fR
174parameter\&.
175.RE
176.PP
177\-K|\-\-krb5auth \fIusername%password\fR
178.RS 4
179Attempt to authenticate a user via Kerberos\&.
180.RE
181.PP
182\-\-lanman
183.RS 4
184Use lanman cryptography for user authentication\&.
185.RE
186.PP
187\-m|\-\-trusted\-domains
188.RS 4