Bug 2648 - net ads join confusingly documented
Summary: net ads join confusingly documented
Status: RESOLVED FIXED
Alias: None
Product: Samba 3.0
Classification: Unclassified
Component: Docs (show other bugs)
Version: 3.0.20
Hardware: All All
: P3 normal
Target Milestone: none
Assignee: Samba Bugzilla Account
QA Contact: Samba Documentation QA Contact~
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-04-25 20:25 UTC by James Peach
Modified: 2014-06-13 12:30 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description James Peach 2005-04-25 20:25:46 UTC
The net(8) man page described the "ads join" command either poorly 
or inaccurately.

chug 59# man net
...
   [RPC|ADS] JOIN [TYPE] [-U username[%password]] [options]
     Join a domain. If the account already exists on the server, and [TYPE] is
     MEMBER, the machine will attempt to join automatically. (Assuming that
     the machine has been created in server manager) Otherwise, a password
     will be prompted for, and a new account may be created.

     [TYPE] may be PDC, BDC or MEMBER to specify the type of server joining
     the domain.

chug 60# /usr/samba/bin/net help ads
...
net ads join <org_unit>
        joins the local machine to a ADS realm

In reality, it looks like the org_unit is the distinguished name that is
used to bind (in the LDAP sense?) to the ADS.
Comment 1 John H Terpstra (mail address dead( 2005-10-17 09:53:34 UTC
(In reply to comment #0)
> The net(8) man page described the "ads join" command either poorly 
> or inaccurately.
> 
> chug 59# man net
> ...
>    [RPC|ADS] JOIN [TYPE] [-U username[%password]] [options]
>      Join a domain. If the account already exists on the server, and [TYPE] is
>      MEMBER, the machine will attempt to join automatically. (Assuming that
>      the machine has been created in server manager) Otherwise, a password
>      will be prompted for, and a new account may be created.
> 
>      [TYPE] may be PDC, BDC or MEMBER to specify the type of server joining
>      the domain.
> 
> chug 60# /usr/samba/bin/net help ads
> ...
> net ads join <org_unit>
>         joins the local machine to a ADS realm
> 
> In reality, it looks like the org_unit is the distinguished name that is
> used to bind (in the LDAP sense?) to the ADS.

James,

Please could you give me a documentation patch, or else make appropriate changes
to the net command sources.

- John T.
Comment 2 Gerald (Jerry) Carter (dead mail address) 2006-04-08 07:43:41 UTC
Cleaning up versions.  There was no 3.0.15 so leaving it in bugzilla 
is causing some confusion.  Moving these nuder 3.0.20.
Originally files against 3.0.15preX.
Comment 3 Björn Jacke 2014-06-13 12:30:42 UTC
looks like the syntax (and documentation) was cleared long time ago