Changeset 272 for branches/samba-3.2.x/docs/manpages/net.8

Timestamp:

Jun 16, 2009, 5:52:30 PM (16 years ago)

Author:

Herwig Bauernfeind

Message:

Update 3.2 to 3.2.12

File:

• branches/samba-3.2.x/docs/manpages/net.8 (modified) (4 diffs)

branches/samba-3.2.x/docs/manpages/net.8

@@ -2 +2 @@
 .\"    Author: [see the "AUTHOR" section]
 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
-.\"      Date: 04/17/2009
+.\"      Date: 06/16/2009
 .\"    Manual: System Administration tools
 .\"    Source: Samba 3.2
 .\"  Language: English
 .\"
-.TH "NET" "8" "04/17/2009" "Samba 3\&.2" "System Administration tools"
+.TH "NET" "8" "06/16/2009" "Samba 3\&.2" "System Administration tools"
 .\" -----------------------------------------------------------------
 .\" * (re)Define some macros
@@ -172 +172 @@
 .fam C
 .HP \w'\ 'u
-\FCnet\F[] {<ads|rap|rpc>} [\-h] [\-w\ workgroup] [\-W\ myworkgroup] [\-U\ user] [\-I\ ip\-address] [\-p\ port] [\-n\ myname] [\-s\ conffile] [\-S\ server] [\-l] [\-P] [\-d\ debuglevel] [\-V]
+\FCnet\F[] {<ads|rap|rpc>} [\-h] [\-w\ workgroup] [\-W\ myworkgroup] [\-U\ user] [\-I\ ip\-address] [\-p\ port] [\-n\ myname] [\-s\ conffile] [\-S\ server] [\-l] [\-P] [\-d\ debuglevel] [\-V] [\-\-request\-timeout\ seconds]
 .fam
 .SH "DESCRIPTION"
@@ -243 +243 @@
 .RS 4
 Make queries to the external server using the machine account of the local server\&.
+.RE
+.PP
+\-\-request\-timeout 30
+.RS 4
+Let client requests timeout after 30 seconds the default is 10 seconds\&.
 .RE
 .PP
@@ -1057 +1062 @@
 .PP
 Delete the list of includes from the provided section (global or share)\&.
+.SS "DOM"
+.PP
+Starting with version 3\&.2\&.0 Samba has support for remote join and unjoin APIs, both client and server\-side\&. Windows supports remote join capabilities since Windows 2000\&.
+.PP
+In order for Samba to be joined or unjoined remotely an account must be used that is either member of the Domain Admins group, a member of the local Administrators group or a user that is granted the SeMachineAccountPrivilege privilege\&.
+.PP
+The client side support for remote join is implemented in the net dom commands which are:
+.RS 4
+net dom join \- Join a remote computer into a domain\&.
+.RE
+.RS 4
+net dom unjoin \- Unjoin a remote computer from a domain\&.
+.RE
+.SS "DOM JOIN   domain=DOMAIN ou=OU account=ACCOUNT password=PASSWORD reboot"
+.PP
+Joins a computer into a domain\&. This command supports the following additional parameters:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIDOMAIN\fR
+can be a NetBIOS domain name (also known as short domain name) or a DNS domain name for Active Directory Domains\&. As in Windows, it is also possible to control which Domain Controller to use\&. This can be achieved by appending the DC name using the \e separator character\&. Example: MYDOM\eMYDC\&. The
+\fIDOMAIN\fR
+parameter cannot be NULL\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIOU\fR
+can be set to a RFC 1779 LDAP DN, like
+\fIou=mymachines,cn=Users,dc=example,dc=com\fR
+in order to create the machine account in a non\-default LDAP containter\&. This optional parameter is only supported when joining Active Directory Domains\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIACCOUNT\fR
+defines a domain account that will be used to join the machine to the domain\&. This domain account needs to have sufficient privileges to join machines\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIPASSWORD\fR
+defines the password for the domain account defined with
+\fIACCOUNT\fR\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIREBOOT\fR
+is an optional parameter that can be set to reboot the remote machine after successful join to the domain\&.
+.sp
+.RE
+.PP
+Note that you also need to use standard net paramters to connect and authenticate to the remote machine that you want to join\&. These additional parameters include: \-S computer and \-U user\&.
+.PP
+Example: net dom join \-S xp \-U XP\e\eadministrator%secret domain=MYDOM account=MYDOM\e\eadministrator password=topsecret reboot\&.
+.PP
+This example would connect to a computer named XP as the local administrator using password secret, and join the computer into a domain called MYDOM using the MYDOM domain administrator account and password topsecret\&. After successful join, the computer would reboot\&.
+.SS "DOM UNJOIN account=ACCOUNT password=PASSWORD reboot"
+.PP
+Unjoins a computer from a domain\&. This command supports the following additional parameters:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIACCOUNT\fR
+defines a domain account that will be used to unjoin the machine from the domain\&. This domain account needs to have sufficient privileges to unjoin machines\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIPASSWORD\fR
+defines the password for the domain account defined with
+\fIACCOUNT\fR\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+\fIREBOOT\fR
+is an optional parameter that can be set to reboot the remote machine after successful unjoin from the domain\&.
+.sp
+.RE
+.PP
+Note that you also need to use standard net paramters to connect and authenticate to the remote machine that you want to unjoin\&. These additional parameters include: \-S computer and \-U user\&.
+.PP
+Example: net dom unjoin \-S xp \-U XP\e\eadministrator%secret account=MYDOM\e\eadministrator password=topsecret reboot\&.
+.PP
+This example would connect to a computer named XP as the local administrator using password secret, and unjoin the computer from the domain using the MYDOM domain administrator account and password topsecret\&. After successful unjoin, the computer would reboot\&.
 .SS "HELP [COMMAND]"
 .PP