docs/yodldocs/wbinfo.1.yo

   1 mailto(samba-bugs@samba.org)
   2 manpage(wbinfo htmlcommand((1)))(1)(13 Jun 2000)(Samba)(SAMBA)
   3
   4 label(NAME)
   5 manpagename(wbinfo)(Query information from winbind daemon)
   6
   7 label(SYNOPSIS)
   8 manpagesynopsis()
   9
  10 bf(wbinfo) link(-u)(minusu) [link(-g)(minusg)] [link(-n name)(minusn)]
  11 [link(-s sid)(minuss)] [link(-U uid)(minusU)] [link(-G gid)(minusG)]
  12 [link(-S sid)(minusS)] [link(-Y sid)(minusY)] [link(-t)(minust)]
  13 [link(-m)(minusm)]
  14
  15 label(DESCRIPTION)
  16 manpagedescription()
  17
  18 This program is part of the bf(Samba) suite version 3.0 and describes
  19 functionality not yet implemented in the main version of Samba.
  20
  21 The bf(wbinfo) program queries and returns information created and used by
  22 the url(bf(winbindd(8)))(winbindd.8.html) daemon.
  23
  24 The url(bf(winbindd(8)))(winbindd.8.html) daemon must be configured and
  25 running for the bf(wbinfo) program to be able to return information.
  26
  27 label(OPTIONS)
  28 manpageoptions()
  29
  30 The following options are available to the bf(wbinfo) program:
  31
  32 startdit()
  33
  34 label(minusu)
  35 dit(bf(-u))
  36
  37 This option will list all users available in the Windows NT domain for
  38 which the url(bf(winbindd(8)))(winbindd.8.html) daemon is operating in.
  39 Users in all trusted domains will also be listed.  Note that this operation
  40 does not assign user ids to any users that have not already been seen by
  41 url(bf(winbindd(8)))(winbindd.8.html).
  42
  43 label(minusg)
  44 dit(bf(-g))
  45
  46 This option will list all groups available in the Windows NT domain for
  47 which the url(bf(winbindd(8)))(winbindd.8.html) daemon is operating in.
  48 Groups in all trusted domains will also be listed.  Note that this
  49 operation does not assign group ids to any groups that have not already
  50 been seen by url(bf(winbindd(8)))(winbindd.8.html).
  51
  52 label(minusn)
  53 dit(bf(-n name))
  54
  55 The bf(-n) option queries url(bf(winbindd(8)))(winbindd.8.html) for the SID
  56 associated with the name specified.  Domain names can be specified before
  57 the user name by using the winbind separator character.  For example
  58 tt(DOM1/Administrator) refers to the tt(Administrator) user in the domain
  59 tt(DOM1).  If no domain is specified then the domain used is the one
  60 specified in the bf(smb.conf) bf(workgroup) parameter.
  61
  62 label(minuss)
  63 dit(bf(-s sid))
  64
  65 Use bf(-s) to resolve a SID to a name.  This is the inverse of the bf(-n)
  66 option above.  SIDs must be specified as ASCII strings in the traditional
  67 Microsoft format. For example
  68 tt(S-1-5-21-1455342024-3071081365-2475485837-500).
  69
  70 label(minusU)
  71 dit(bf(-U uid))
  72
  73 Try to convert a UNIX user id to a Windows NT SID.  If the uid specified
  74 does not refer to one within the bf(winbind uid range) then the operation
  75 will fail.
  76
  77 label(minusG)
  78 dit(bf(-G gid))
  79
  80 Try to convert a UNIX group id to a Windows NT SID.  If the gid specified
  81 does not refer to one within the bf(winbind gid range) then the operation
  82 will fail.
  83
  84 label(minusS)
  85 dit(bf(-S sid))
  86
  87 Convert a SID to a UNIX user id.  If the SID does not correspond to a UNIX
  88 user mapped by url(bf(winbindd(8)))(winbindd.8.html) then the operation
  89 will fail.
  90
  91 label(minusY)
  92 dit(bf(-Y sid))
  93
  94 Convert a SID to a UNIX group id.  If the SID does not correspond to a UNIX
  95 group mapped by url(bf(winbindd(8)))(winbindd.8.html) then the operation
  96 will fail.
  97
  98 label(minust)
  99 dit(bf(-t))
 100
 101 Verify that the workstation trust account created when the Samba server is
 102 added to the Windows NT domain is working.
 103
 104 label(minusm)
 105 dit(bf(-m))
 106
 107 Produce a list of domains trusted by the Windows NT server
 108 url(bf(winbindd(8)))(winbindd.8.html) contacts when resolving names.  This
 109 list does not include the Windows NT domain the server is a Primary Domain
 110 Controller for.
 111
 112 enddit()
 113
 114 label(EXIT STATUS)
 115 manpagesection(EXIT STATUS)
 116
 117 The bf(wbinfo) program returns 0 if the operation succeeded, or 1 if
 118 the operation failed.  If the url(bf(winbindd(8)))(winbindd.8.html) daemon
 119 is not working bf(wbinfo) will always return failure.
 120
 121 label(SEEALSO)
 122 manpageseealso()
 123
 124 url(bf(winbindd(8)))(winbindd.8.html)
 125
 126 label(AUTHOR)
 127 manpageauthor()
 128
 129 The original Samba software and related utilities were created by
 130 Andrew Tridgell. Samba is now developed by the Samba Team as an Open
 131 Source project.
 132
 133 bf(wbinfo) was written by Tim Potter.