summaryrefslogtreecommitdiff
path: root/docs/docbook/manpages/wbinfo.1.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/manpages/wbinfo.1.xml')
-rw-r--r--docs/docbook/manpages/wbinfo.1.xml325
1 files changed, 0 insertions, 325 deletions
diff --git a/docs/docbook/manpages/wbinfo.1.xml b/docs/docbook/manpages/wbinfo.1.xml
deleted file mode 100644
index 728e4f166a..0000000000
--- a/docs/docbook/manpages/wbinfo.1.xml
+++ /dev/null
@@ -1,325 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
-
-<!ENTITY % globalentities SYSTEM '../global.ent'> %globalentities;
-]>
-<refentry id="wbinfo.1">
-
-<refmeta>
- <refentrytitle>wbinfo</refentrytitle>
- <manvolnum>1</manvolnum>
-</refmeta>
-
-
-<refnamediv>
- <refname>wbinfo</refname>
- <refpurpose>Query information from winbind daemon</refpurpose>
-</refnamediv>
-
-<refsynopsisdiv>
- <cmdsynopsis>
- <command>wbinfo</command>
- <arg choice="opt">-a user%password</arg>
- <arg choice="opt">-c username</arg>
- <arg choice="opt">-C groupname</arg>
- <arg choice="opt">--domain domain</arg>
- <arg choice="opt">-I ip</arg>
- <arg choice="opt">-s sid</arg>
- <arg choice="opt">-u</arg>
- <arg choice="opt">-U uid</arg>
- <arg choice="opt">-g</arg>
- <arg choice="opt">--get-auth-user</arg>
- <arg choice="opt">-G gid</arg>
- <arg choice="opt">-m</arg>
- <arg choice="opt">-n name</arg>
- <arg choice="opt">-N netbios-name</arg>
- <arg choice="opt">-o user:group</arg>
- <arg choice="opt">-O user:group</arg>
- <arg choice="opt">-p</arg>
- <arg choice="opt">-r user</arg>
- <arg choice="opt">--set-auth-user user%password</arg>
- <arg choice="opt">--sequence</arg>
- <arg choice="opt">-S sid</arg>
- <arg choice="opt">-t</arg>
- <arg choice="opt">-x username</arg>
- <arg choice="opt">-X groupname</arg>
- <arg choice="opt">-Y sid</arg>
- </cmdsynopsis>
-</refsynopsisdiv>
-
-<refsect1>
- <title>DESCRIPTION</title>
-
- <para>This tool is part of the <citerefentry><refentrytitle>Samba</refentrytitle>
- <manvolnum>7</manvolnum></citerefentry> suite.</para>
-
- <para>The <command>wbinfo</command> program queries and returns information
- created and used by the <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> daemon. </para>
-
- <para>The <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> daemon must be configured
- and running for the <command>wbinfo</command> program to be able
- to return information.</para>
-</refsect1>
-
-<refsect1>
- <title>OPTIONS</title>
-
- <variablelist>
- <varlistentry>
- <term>-a username%password</term>
- <listitem><para>Attempt to authenticate a user via winbindd.
- This checks both authenticaion methods and reports its results.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-c user</term>
- <listitem><para>Create a local winbind user.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-C group</term>
- <listitem><para>Create a local winbindd group.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--domain name</term>
- <listitem><para>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
- <option>--sequence</option>,
- <option>-u</option>, and <option>-g</option> options honor this parameter.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-g</term>
- <listitem><para>This option will list all groups available
- in the Windows NT domain for which the <citerefentry><refentrytitle>Samba</refentrytitle>
- <manvolnum>7</manvolnum></citerefentry> 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 <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry>. </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--get-auth-user</term>
- <listitem><para>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.</para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-G gid</term>
- <listitem><para>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. </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-I ip</term>
- <listitem><para>The <parameter>-I</parameter> option
- queries <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> to send a node status
- request to get the NetBIOS name associated with the IP address
- specified by the <parameter>ip</parameter> parameter.
- </para></listitem>
- </varlistentry>
-
-
- <varlistentry>
- <term>-m</term>
- <listitem><para>Produce a list of domains trusted by the
- Windows NT server <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> contacts
- when resolving names. This list does not include the Windows
- NT domain the server is a Primary Domain Controller for.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-n name</term>
- <listitem><para>The <parameter>-n</parameter> option
- queries <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> 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 <citerefentry><refentrytitle>smb.conf</refentrytitle>
- <manvolnum>5</manvolnum></citerefentry> <parameter>workgroup
- </parameter> parameter. </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-N name</term>
- <listitem><para>The <parameter>-N</parameter> option
- queries <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> to query the WINS
- server for the IP address associated with the NetBIOS name
- specified by the <parameter>name</parameter> parameter.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-o user:group</term>
- <listitem><para>Add a winbindd local group as a secondary group
- for the specified winbindd local user.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-O user:group</term>
- <listitem><para>Remove a winbindd local group as a secondary group
- for the specified winbindd local user.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-p</term>
- <listitem><para>Check whether winbindd is still alive.
- Prints out either 'succeeded' or 'failed'.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-r username</term>
- <listitem><para>Try to obtain the list of UNIX group ids
- to which the user belongs. This only works for users
- defined on a Domain Controller.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-s sid</term>
- <listitem><para>Use <parameter>-s</parameter> to resolve
- a SID to a name. This is the inverse of the <parameter>-n
- </parameter> option above. SIDs must be specified as ASCII strings
- in the traditional Microsoft format. For example,
- S-1-5-21-1455342024-3071081365-2475485837-500. </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--set-auth-user username%password</term>
- <listitem><para>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).
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>--sequence</term>
- <listitem><para>Show sequence numbers of
- all known domains</para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-S sid</term>
- <listitem><para>Convert a SID to a UNIX user id. If the SID
- does not correspond to a UNIX user mapped by <citerefentry>
- <refentrytitle>winbindd</refentrytitle><manvolnum>8</manvolnum>
- </citerefentry> then the operation will fail. </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-t</term>
- <listitem><para>Verify that the workstation trust account
- created when the Samba server is added to the Windows NT
- domain is working. </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-u</term>
- <listitem><para>This option will list all users available
- in the Windows NT domain for which the <citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry> 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 <citerefentry>
- <refentrytitle>winbindd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
- .</para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-U uid</term>
- <listitem><para>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. </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-x user</term>
- <listitem><para>Delete an existing local winbind user.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-X group</term>
- <listitem><para>Delete an existing local winbindd group.
- </para></listitem>
- </varlistentry>
-
- <varlistentry>
- <term>-Y sid</term>
- <listitem><para>Convert a SID to a UNIX group id. If the SID
- does not correspond to a UNIX group mapped by <citerefentry>
- <refentrytitle>winbindd</refentrytitle><manvolnum>8</manvolnum></citerefentry> then
- the operation will fail. </para></listitem>
- </varlistentry>
-
-
- &stdarg.version;
- &stdarg.help;
-
- </variablelist>
-</refsect1>
-
-
-<refsect1>
- <title>EXIT STATUS</title>
-
- <para>The wbinfo program returns 0 if the operation
- succeeded, or 1 if the operation failed. If the <citerefentry>
- <refentrytitle>winbindd</refentrytitle><manvolnum>8</manvolnum>
- </citerefentry> daemon is not working <command>wbinfo</command> will always return
- failure. </para>
-</refsect1>
-
-
-<refsect1>
- <title>VERSION</title>
-
- <para>This man page is correct for version 3.0 of
- the Samba suite.</para>
-</refsect1>
-
-<refsect1>
- <title>SEE ALSO</title>
- <para><citerefentry><refentrytitle>winbindd</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry></para>
-</refsect1>
-
-<refsect1>
- <title>AUTHOR</title>
-
- <para>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.</para>
-
- <para><command>wbinfo</command> and <command>winbindd</command>
- were written by Tim Potter.</para>
-
- <para>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.</para>
-</refsect1>
-
-</refentry>