raw/man1/wbinfo.1

   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 "" "" ""
  21 .SH NAME
  22 wbinfo \- Query information from winbind daemon
  23 .SH "SYNOPSIS"
  24
  25 .nf
  26 \fBwbinfo\fR [-a user%password] [-c username] [-C groupname] [--domain domain] [-I ip] [-s sid] [-u] [-U uid] [-g] [--get-auth-user] [-G gid] [-m] [-n name] [-N netbios-name] [-o user:group] [-O user:group] [-p] [-r user] [--set-auth-user user%password] [--sequence] [-S sid] [-t] [-x username] [-X groupname] [-Y sid]
  27
  28 .fi
  29
  30 .SH "DESCRIPTION"
  31
  32 .PP
  33 This tool is part of the \fBSamba\fR(7) suite\&.
  34
  35 .PP
  36 The \fBwbinfo\fR program queries and returns information created and used by the \fBwinbindd\fR(8) daemon\&.
  37
  38 .PP
  39 The \fBwinbindd\fR(8) daemon must be configured and running for the \fBwbinfo\fR program to be able to return information\&.
  40
  41 .SH "OPTIONS"
  42
  43 .TP
  44 -a username%password
  45 Attempt to authenticate a user via winbindd\&. This checks both authenticaion methods and reports its results\&.
  46
  47
  48 .TP
  49 -c user
  50 Create a local winbind user\&.
  51
  52
  53 .TP
  54 -C group
  55 Create a local winbindd group\&.
  56
  57
  58 .TP
  59 --domain name
  60 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 \fB--sequence\fR, \fB-u\fR, and \fB-g\fR options honor this parameter\&.
  61
  62
  63 .TP
  64 -g
  65 This option will list all groups available in the Windows NT domain for which the \fBSamba\fR(7) 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 \fBwinbindd\fR(8)\&.
  66
  67
  68 .TP
  69 --get-auth-user
  70 Print username and password used by winbindd during session setup to a domain controller\&. Username and password can be set using '-A'\&. Only available for root\&.
  71
  72
  73 .TP
  74 -G gid
  75 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\&.
  76
  77
  78 .TP
  79 -I ip
  80 The \fI-I\fR option queries \fBwinbindd\fR(8) to send a node status request to get the NetBIOS name associated with the IP address specified by the \fIip\fR parameter\&.
  81
  82
  83 .TP
  84 -m
  85 Produce a list of domains trusted by the Windows NT server \fBwinbindd\fR(8) contacts when resolving names\&. This list does not include the Windows NT domain the server is a Primary Domain Controller for\&.
  86
  87
  88 .TP
  89 -n name
  90 The \fI-n\fR option queries \fBwinbindd\fR(8) 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 \fBsmb.conf\fR(5) \fIworkgroup \fR parameter\&.
  91
  92
  93 .TP
  94 -N name
  95 The \fI-N\fR option queries \fBwinbindd\fR(8) to query the WINS server for the IP address associated with the NetBIOS name specified by the \fIname\fR parameter\&.
  96
  97
  98 .TP
  99 -o user:group
 100 Add a winbindd local group as a secondary group for the specified winbindd local user\&.
 101
 102
 103 .TP
 104 -O user:group
 105 Remove a winbindd local group as a secondary group for the specified winbindd local user\&.
 106
 107
 108 .TP
 109 -p
 110 Check whether winbindd is still alive\&. Prints out either 'succeeded' or 'failed'\&.
 111
 112
 113 .TP
 114 -r username
 115 Try to obtain the list of UNIX group ids to which the user belongs\&. This only works for users defined on a Domain Controller\&.
 116
 117
 118 .TP
 119 -s sid
 120 Use \fI-s\fR to resolve a SID to a name\&. This is the inverse of the \fI-n \fR option above\&. SIDs must be specified as ASCII strings in the traditional Microsoft format\&. For example, S-1-5-21-1455342024-3071081365-2475485837-500\&.
 121
 122
 123 .TP
 124 --set-auth-user username%password
 125 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)\&.
 126
 127
 128 .TP
 129 --sequence
 130 Show sequence numbers of all known domains
 131
 132
 133 .TP
 134 -S sid
 135 Convert a SID to a UNIX user id\&. If the SID does not correspond to a UNIX user mapped by \fBwinbindd\fR(8) then the operation will fail\&.
 136
 137
 138 .TP
 139 -t
 140 Verify that the workstation trust account created when the Samba server is added to the Windows NT domain is working\&.
 141
 142
 143 .TP
 144 -u
 145 This option will list all users available in the Windows NT domain for which the \fBwinbindd\fR(8) 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 \fBwinbindd\fR(8) \&.
 146
 147
 148 .TP
 149 -U uid
 150 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\&.
 151
 152
 153 .TP
 154 -x user
 155 Delete an existing local winbind user\&.
 156
 157
 158 .TP
 159 -X group
 160 Delete an existing local winbindd group\&.
 161
 162
 163 .TP
 164 -Y sid
 165 Convert a SID to a UNIX group id\&. If the SID does not correspond to a UNIX group mapped by \fBwinbindd\fR(8) then the operation will fail\&.
 166
 167
 168 .TP
 169 -V
 170 Prints the program version number\&.
 171
 172
 173 .TP
 174 -h|--help
 175 Print a summary of command line options\&.
 176
 177
 178 .SH "EXIT STATUS"
 179
 180 .PP
 181 The wbinfo program returns 0 if the operation succeeded, or 1 if the operation failed\&. If the \fBwinbindd\fR(8) daemon is not working \fBwbinfo\fR will always return failure\&.
 182
 183 .SH "VERSION"
 184
 185 .PP
 186 This man page is correct for version 3\&.0 of the Samba suite\&.
 187
 188 .SH "SEE ALSO"
 189
 190 .PP
 191 \fBwinbindd\fR(8)
 192
 193 .SH "AUTHOR"
 194
 195 .PP
 196 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\&.
 197
 198 .PP
 199 \fBwbinfo\fR and \fBwinbindd\fR were written by Tim Potter\&.
 200
 201 .PP
 202 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\&.
 203