docs/manpages/wbinfo.1

   1 .TH WBINFO 1 "30 Jan 2001" "wbinfo 2.2.0-alpha2"
   2 .PP
   3 .SH "NAME"
   4 wbinfo \- Query information from winbind daemon
   5 .PP
   6 .SH "SYNOPSIS"
   7 .PP
   8 \fBwbinfo\fP -u [-g] [-n name]
   9 [-s sid] [-U uid] [-G gid]
  10 [-S sid] [-Y sid] [-t]
  11 [-m]
  12 .PP
  13 .SH "DESCRIPTION"
  14 .PP
  15 This program is part of the \fBSamba\fP suite version 3\&.0 and describes
  16 functionality not yet implemented in the main version of Samba\&.
  17 .PP
  18 The \fBwbinfo\fP program queries and returns information created and used by
  19 the \fBwinbindd(8)\fP daemon\&.
  20 .PP
  21 The \fBwinbindd(8)\fP daemon must be configured and
  22 running for the \fBwbinfo\fP program to be able to return information\&.
  23 .PP
  24 .SH "OPTIONS"
  25 .PP
  26 The following options are available to the \fBwbinfo\fP program:
  27 .PP
  28 .IP
  29 .IP "\fB-u\fP"
  30 .IP
  31 This option will list all users available in the Windows NT domain for
  32 which the \fBwinbindd(8)\fP daemon is operating in\&.
  33 Users in all trusted domains will also be listed\&.  Note that this operation
  34 does not assign user ids to any users that have not already been seen by
  35 \fBwinbindd(8)\fP\&.
  36 .IP
  37 .IP "\fB-g\fP"
  38 .IP
  39 This option will list all groups available in the Windows NT domain for
  40 which the \fBwinbindd(8)\fP daemon is operating in\&.
  41 Groups in all trusted domains will also be listed\&.  Note that this
  42 operation does not assign group ids to any groups that have not already
  43 been seen by \fBwinbindd(8)\fP\&.
  44 .IP
  45 .IP "\fB-n name\fP"
  46 .IP
  47 The \fB-n\fP option queries \fBwinbindd(8)\fP for the SID
  48 associated with the name specified\&.  Domain names can be specified before
  49 the user name by using the winbind separator character\&.  For example
  50 \f(CWDOM1/Administrator\fP refers to the \f(CWAdministrator\fP user in the domain
  51 \f(CWDOM1\fP\&.  If no domain is specified then the domain used is the one
  52 specified in the \fBsmb\&.conf\fP \fBworkgroup\fP parameter\&.
  53 .IP
  54 .IP "\fB-s sid\fP"
  55 .IP
  56 Use \fB-s\fP to resolve a SID to a name\&.  This is the inverse of the \fB-n\fP
  57 option above\&.  SIDs must be specified as ASCII strings in the traditional
  58 Microsoft format\&. For example
  59 \f(CWS-1-5-21-1455342024-3071081365-2475485837-500\fP\&.
  60 .IP
  61 .IP "\fB-U uid\fP"
  62 .IP
  63 Try to convert a UNIX user id to a Windows NT SID\&.  If the uid specified
  64 does not refer to one within the \fBwinbind uid range\fP then the operation
  65 will fail\&.
  66 .IP
  67 .IP "\fB-G gid\fP"
  68 .IP
  69 Try to convert a UNIX group id to a Windows NT SID\&.  If the gid specified
  70 does not refer to one within the \fBwinbind gid range\fP then the operation
  71 will fail\&.
  72 .IP
  73 .IP "\fB-S sid\fP"
  74 .IP
  75 Convert a SID to a UNIX user id\&.  If the SID does not correspond to a UNIX
  76 user mapped by \fBwinbindd(8)\fP then the operation
  77 will fail\&.
  78 .IP
  79 .IP "\fB-Y sid\fP"
  80 .IP
  81 Convert a SID to a UNIX group id\&.  If the SID does not correspond to a UNIX
  82 group mapped by \fBwinbindd(8)\fP then the operation
  83 will fail\&.
  84 .IP
  85 .IP "\fB-t\fP"
  86 .IP
  87 Verify that the workstation trust account created when the Samba server is
  88 added to the Windows NT domain is working\&.
  89 .IP
  90 .IP "\fB-m\fP"
  91 .IP
  92 Produce a list of domains trusted by the Windows NT server
  93 \fBwinbindd(8)\fP contacts when resolving names\&.  This
  94 list does not include the Windows NT domain the server is a Primary Domain
  95 Controller for\&.
  96 .IP
  97 .PP
  98 .SH "EXIT STATUS"
  99 .PP
 100 The \fBwbinfo\fP program returns 0 if the operation succeeded, or 1 if
 101 the operation failed\&.  If the \fBwinbindd(8)\fP daemon
 102 is not working \fBwbinfo\fP will always return failure\&.
 103 .PP
 104 .SH "SEE ALSO"
 105 .PP
 106 \fBwinbindd(8)\fP
 107 .PP
 108 .SH "AUTHOR"
 109 .PP
 110 The original Samba software and related utilities were created by
 111 Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open
 112 Source project\&.
 113 .PP
 114 \fBwbinfo\fP was written by Tim Potter\&.