~zulcss/samba/server-dailies-3.4

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>wbinfo</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="wbinfo.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2>wbinfo — Query information from winbind daemon</div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><code class="literal">wbinfo</code> [-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] [--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] [-t] [-u] [--uid-info uid] [--user-domgroups sid] [--user-sids sid] [-U uid] [-V] [-Y sid] [--verbose]</div></div><div class="refsect1" lang="en"><a name="id2483696"></a><h2>DESCRIPTION</h2>This tool is part of the <a class="citerefentry" href="samba.7.html">samba(7)</a> suite.The <code class="literal">wbinfo</code> program queries and returns information

created and used by the <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> daemon. The <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> daemon must be configured

and running for the <code class="literal">wbinfo</code> program to be able

to return information.</div><div class="refsect1" lang="en"><a name="id2483752"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt>-a|--authenticate <code>username%password</code></dt><dd>Attempt to authenticate a user via <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a>.

This checks both authentication methods and reports its results.

<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>Do not be tempted to use this

functionality for authentication in third-party

applications. Instead use <a class="citerefentry" href="ntlm_auth.1.html">ntlm_auth(1)</a>.</div></dd><dt>--allocate-gid</dt><dd>Get a new GID out of idmap

</dd><dt>--allocate-uid</dt><dd>Get a new UID out of idmap

</dd><dt>--all-domains</dt><dd>List all domains (trusted and

own domain).

</dd><dt>--domain <code>name</code></dt><dd>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 <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> belongs. Currently only the

<code class="option">--sequence</code>,

<code class="option">-u</code>, and <code class="option">-g</code> options honor this parameter.

</dd><dt>-D|--domain-info <code>domain</code></dt><dd>Show most of the info we have about the

specified domain.

</dd><dt>-g|--domain-groups</dt><dd>This option will list all groups available

in the Windows NT domain for which the <a class="citerefentry" href="samba.7.html">samba(7)</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 class="citerefentry" href="winbindd.8.html">winbindd(8)</a>. </dd><dt>--get-auth-user</dt><dd>Print username and password used by <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a>

during session setup to a domain controller. Username

and password can be set using <code class="option">--set-auth-user</code>.

Only available for root.</dd><dt>--getdcname <code>domain</code></dt><dd>Get the DC name for the specified domain.

</dd><dt>-G|--gid-to-sid <code>gid</code></dt><dd>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. </dd><dt>-i|--user-info <code>user</code></dt><dd>Get user info.

</dd><dt>-I|--WINS-by-ip <code>ip</code></dt><dd>The <code>-I</code> option

queries <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> to send a node status

request to get the NetBIOS name associated with the IP address

specified by the <code>ip</code> parameter.

</dd><dt>-K|--krb5auth <code>username%password</code></dt><dd>Attempt to authenticate a user via Kerberos.

</dd><dt>-m|--trusted-domains</dt><dd>Produce a list of domains trusted by the

Windows NT server <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> contacts

when resolving names. This list does not include the Windows

NT domain the server is a Primary Domain Controller for.

</dd><dt>-n|--name-to-sid <code>name</code></dt><dd>The <code>-n</code> option

queries <a class="citerefentry" href="winbindd.8.html">winbindd(8)</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 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 <a class="citerefentry" href="smb.conf.5.html">smb.conf(5)</a> <code>workgroup

</code> parameter. </dd><dt>-N|--WINS-by-name <code>name</code></dt><dd>The <code>-N</code> option

queries <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> to query the WINS

server for the IP address associated with the NetBIOS name

specified by the <code>name</code> parameter.

</dd><dt>--own-domain</dt><dd>List own domain.

</dd><dt>-p|--ping</dt><dd>Check whether <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> is still alive.

Prints out either 'succeeded' or 'failed'.

</dd><dt>-r|--user-groups <code>username</code></dt><dd>Try to obtain the list of UNIX group ids

to which the user belongs. This only works for users

defined on a Domain Controller.

</dd><dt>-s|--sid-to-name <code>sid</code></dt><dd>Use <code>-s</code> to resolve

a SID to a name. This is the inverse of the <code>-n

</code> option above. SIDs must be specified as ASCII strings

in the traditional Microsoft format. For example,

S-1-5-21-1455342024-3071081365-2475485837-500. </dd><dt>--separator</dt><dd>Get the active winbind separator.

</dd><dt>--sequence</dt><dd>Show sequence numbers of all known domains.

</dd><dt>--set-auth-user <code>username%password</code></dt><dd>Store username and password used by <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> 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).

</dd><dt>-S|--sid-to-uid <code>sid</code></dt><dd>Convert a SID to a UNIX user id. If the SID

does not correspond to a UNIX user mapped by <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> then the operation will fail. </dd><dt>-t|--check-secret</dt><dd>Verify that the workstation trust account

created when the Samba server is added to the Windows NT

domain is working. </dd><dt>-u|--domain-users</dt><dd>This option will list all users available

in the Windows NT domain for which the <a class="citerefentry" href="winbindd.8.html">winbindd(8)</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 class="citerefentry" href="winbindd.8.html">winbindd(8)</a>

.</dd><dt>--uid-info <code>uid</code></dt><dd>Get user info for the user connected to

user id UID.</dd><dt>--user-domgroups <code>sid</code></dt><dd>Get user domain groups.

</dd><dt>--user-sids <code>sid</code></dt><dd>Get user group SIDs for user.

</dd><dt>-U|--uid-to-sid <code>uid</code></dt><dd>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. </dd><dt>--verbose</dt><dd>

Print additional information about the query results.

</dd><dt>-Y|--sid-to-gid <code>sid</code></dt><dd>Convert a SID to a UNIX group id. If the SID

does not correspond to a UNIX group mapped by <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> then

the operation will fail. </dd><dt>--remove-uid-mapping uid,sid</dt><dd>Remove an existing uid to sid mapping

entry from the IDmap backend.</dd><dt>--remove-gid-mapping gid,sid</dt><dd>Remove an existing gid to sid

mapping entry from the IDmap backend.</dd><dt>--set-uid-mapping uid,sid</dt><dd>Create a new or modify an existing uid to sid

mapping in the IDmap backend.</dd><dt>--set-gid-mapping gid,sid</dt><dd>Create a new or modify an existing gid to sid

mapping in the IDmap backend.</dd><dt>-V|--version</dt><dd>Prints the program version number.

</dd><dt>-h|--help</dt><dd>Print a summary of command line options.

</dd></dl></div></div><div class="refsect1" lang="en"><a name="id2532629"></a><h2>EXIT STATUS</h2>The wbinfo program returns 0 if the operation

succeeded, or 1 if the operation failed. If the <a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> daemon is not working <code class="literal">wbinfo</code> will always return

failure. </div><div class="refsect1" lang="en"><a name="id2532654"></a><h2>VERSION</h2>This man page is correct for version 3 of

the Samba suite.</div><div class="refsect1" lang="en"><a name="id2532665"></a><h2>SEE ALSO</h2><a class="citerefentry" href="winbindd.8.html">winbindd(8)</a> and <a class="citerefentry" href="ntlm_auth.1.html">ntlm_auth(1)</a></div><div class="refsect1" lang="en"><a name="id2532688"></a><h2>AUTHOR</h2>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.<code class="literal">wbinfo</code> and <code class="literal">winbindd</code>

were written by Tim Potter.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.</div></div></body></html>