summaryrefslogtreecommitdiff
path: root/docs/htmldocs/wbinfo.1.html
blob: 5a71611c636ca6aca892c706f89b54ac28dd07d0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121





<html><head><title>wbinfo (1)</title>

<link rev="made" href="mailto:samba-bugs@samba.org">
</head>
<body>

<hr>

<h1>wbinfo (1)</h1>
<h2>Samba</h2>
<h2>13 Jun 2000</h2>


    
<p><a name="NAME"></a>
<h2>NAME</h2>
    wbinfo - Query information from winbind daemon
<p><a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
     
<p><strong>wbinfo</strong> <a href="wbinfo.1.html#minusu">-u</a> [<a href="wbinfo.1.html#minusg">-g</a>] [<a href="wbinfo.1.html#minusn">-n name</a>]
[<a href="wbinfo.1.html#minuss">-s sid</a>] [<a href="wbinfo.1.html#minusU">-U uid</a>] [<a href="wbinfo.1.html#minusG">-G gid</a>]
[<a href="wbinfo.1.html#minusS">-S sid</a>] [<a href="wbinfo.1.html#minusY">-Y sid</a>] [<a href="wbinfo.1.html#minust">-t</a>]
[<a href="wbinfo.1.html#minusm">-m</a>]
<p><a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
    
<p>This program is part of the <strong>Samba</strong> suite version 3.0 and describes
functionality not yet implemented in the main version of Samba.
<p>The <strong>wbinfo</strong> program queries and returns information created and used by
the <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> daemon.
<p>The <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> daemon must be configured and
running for the <strong>wbinfo</strong> program to be able to return information.
<p><a name="OPTIONS"></a>
<h2>OPTIONS</h2>
    
<p>The following options are available to the <strong>wbinfo</strong> program:
<p><dl>
<p><a name="minusu"></a>
<p></p><dt><strong><strong>-u</strong></strong><dd>
<p>This option will list all users available in the Windows NT domain for
which the <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> 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
<a href="winbindd.8.html"><strong>winbindd(8)</strong></a>.
<p><a name="minusg"></a>
<p></p><dt><strong><strong>-g</strong></strong><dd>
<p>This option will list all groups available in the Windows NT domain for
which the <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> 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 <a href="winbindd.8.html"><strong>winbindd(8)</strong></a>.
<p><a name="minusn"></a>
<p></p><dt><strong><strong>-n name</strong></strong><dd>
<p>The <strong>-n</strong> option queries <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> 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
<code>DOM1/Administrator</code> refers to the <code>Administrator</code> user in the domain
<code>DOM1</code>.  If no domain is specified then the domain used is the one
specified in the <strong>smb.conf</strong> <strong>workgroup</strong> parameter.
<p><a name="minuss"></a>
<p></p><dt><strong><strong>-s sid</strong></strong><dd>
<p>Use <strong>-s</strong> to resolve a SID to a name.  This is the inverse of the <strong>-n</strong>
option above.  SIDs must be specified as ASCII strings in the traditional
Microsoft format. For example
<code>S-1-5-21-1455342024-3071081365-2475485837-500</code>.
<p><a name="minusU"></a>
<p></p><dt><strong><strong>-U uid</strong></strong><dd>
<p>Try to convert a UNIX user id to a Windows NT SID.  If the uid specified
does not refer to one within the <strong>winbind uid range</strong> then the operation
will fail.
<p><a name="minusG"></a>
<p></p><dt><strong><strong>-G gid</strong></strong><dd>
<p>Try to convert a UNIX group id to a Windows NT SID.  If the gid specified
does not refer to one within the <strong>winbind gid range</strong> then the operation
will fail.
<p><a name="minusS"></a>
<p></p><dt><strong><strong>-S sid</strong></strong><dd>
<p>Convert a SID to a UNIX user id.  If the SID does not correspond to a UNIX
user mapped by <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> then the operation
will fail.
<p><a name="minusY"></a>
<p></p><dt><strong><strong>-Y sid</strong></strong><dd>
<p>Convert a SID to a UNIX group id.  If the SID does not correspond to a UNIX
group mapped by <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> then the operation
will fail.
<p><a name="minust"></a>
<p></p><dt><strong><strong>-t</strong></strong><dd>
<p>Verify that the workstation trust account created when the Samba server is
added to the Windows NT domain is working.
<p><a name="minusm"></a>
<p></p><dt><strong><strong>-m</strong></strong><dd>
<p>Produce a list of domains trusted by the Windows NT server
<a href="winbindd.8.html"><strong>winbindd(8)</strong></a> contacts when resolving names.  This
list does not include the Windows NT domain the server is a Primary Domain
Controller for.
<p></dl>
<p><a name="EXITSTATUS"></a>
<h2>EXIT STATUS</h2>
    
<p>The <strong>wbinfo</strong> program returns 0 if the operation succeeded, or 1 if
the operation failed.  If the <a href="winbindd.8.html"><strong>winbindd(8)</strong></a> daemon
is not working <strong>wbinfo</strong> will always return failure.
<p><a name="SEEALSO"></a>
<h2>SEE ALSO</h2>
    
<p><a href="winbindd.8.html"><strong>winbindd(8)</strong></a>
<p><a name="AUTHOR"></a>
<h2>AUTHOR</h2>
    
<p>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.
<p><strong>wbinfo</strong> was written by Tim Potter.
</body>
</html>