Merge from Subversion r50.
[ira/wip.git] / docs / manpages / net.8
1 .\" This manpage has been automatically generated by docbook2man 
2 .\" from a DocBook document.  This tool can be found at:
3 .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
4 .\" Please send any bug reports, improvements, comments, patches, 
5 .\" etc. to Steve Cheng <steve@ggi-project.org>.
6 .TH "NET" "8" "03 april 2003" "" ""
7
8 .SH NAME
9 net \- Tool for administration of Samba and remote CIFS servers.
10 .SH SYNOPSIS
11
12 \fBnet\fR \fB<ads|rap|rpc>\fR [ \fB-h\fR ] [ \fB-w workgroup\fR ] [ \fB-W myworkgroup\fR ] [ \fB-U user\fR ] [ \fB-I ip-address\fR ] [ \fB-p port\fR ] [ \fB-n myname\fR ] [ \fB-s conffile\fR ] [ \fB-S server\fR ] [ \fB-C comment\fR ] [ \fB-M maxusers\fR ] [ \fB-F flags\fR ] [ \fB-j jobid\fR ] [ \fB-l\fR ] [ \fB-r\fR ] [ \fB-f\fR ] [ \fB-t timeout\fR ] [ \fB-P\fR ] [ \fB-D debuglevel\fR ]
13
14 .SH "DESCRIPTION"
15 .PP
16 This tool is part of the \fBSamba\fR(7) suite.
17 .PP
18 The samba net utility is meant to work just like the net utility 
19 available for windows and DOS.
20 .SH "OPTIONS"
21 .TP
22 \fB-h\fR
23 Display summary of all available options.
24 .TP
25 \fB-w target-workgroup\fR
26 Sets target workgroup or domain. You have to specify 
27 either this option or the IP address or the name of a server.
28 .TP
29 \fB-W workgroup\fR
30 Sets client workgroup or domain
31 .TP
32 \fB-U user\fR
33 User name to use
34 .TP
35 \fB-I ip-address\fR
36 IP address of target server to use. You have to
37 specify either this option or a target workgroup or a target server.
38 .TP
39 \fB-p port\fR
40 Port on the target server to connect to.
41 .TP
42 \fB-n myname\fR
43 Sets name of the client.
44 .TP
45 \fB-s conffile\fR
46 Specify alternative configuration file that should be loaded.
47 .TP
48 \fB-S server\fR
49 Name of target server. You should specify either 
50 this option or a target workgroup or a target IP address.
51 .TP
52 \fB-C comment\fR
53 FIXME
54 .TP
55 \fB-M maxusers\fR
56 FIXME
57 .TP
58 \fB-F flags\fR
59 FIXME
60 .TP
61 \fB-j jobid\fR
62 FIXME
63 .TP
64 \fB-l\fR
65 FIXME
66 .TP
67 \fB-r\fR
68 FIXME
69 .TP
70 \fB-f\fR
71 FIXME
72 .TP
73 \fB-t timeout\fR
74 FIXME
75 .TP
76 \fB-P\fR
77 Make queries to the external server using the machine account of the local server.
78 .TP
79 \fB-D debuglevel\fR
80 set the debuglevel. Debug level 0 is the lowest
81 and 100 being the highest. This should be set to 100 if you are
82 planning on submitting a bug report to the Samba team (see
83 \fIBUGS.txt\fR).
84 .SH "TIME"
85 .PP
86 The \fBNET TIME\fR command allows you to view the time on a remote server
87 or synchronise the time on the local server with the time on the remote server.
88 .TP
89 \fB\fR
90 Without any options, the \fBNET TIME\fR command 
91 displays the time on the remote server.
92 .TP
93 \fBSYSTEM\fR
94 Displays the time on the remote server in a format ready for \fB/bin/date\fR
95 .TP
96 \fBSET\fR
97 Tries to set the date and time of the local server to that on 
98 the remote server using \fB/bin/date\fR.
99 .TP
100 \fBZONE\fR
101 Displays the timezone in hours from GMT on the remote computer.
102 .SH "RPC"
103 .PP
104 The \fBNET RPC\fR command allows you to do various 
105 NT4 operations.
106 .TP
107 \fBJOIN -U username[%password] [options]\fR
108 Join a domain with specified username and password. Password 
109 will be prompted if none is specified.
110 .TP
111 \fBJOIN [options except -U]\fR
112 to join a domain created in server manager
113 .TP
114 \fBUSER [misc. options] [targets]\fR
115 List users
116 .TP
117 \fBUSER DELETE <name> [misc options]\fR
118 delete specified user
119 .TP
120 \fBUSER INFO <name> [misc options]\fR
121 list the domain groups of the specified user
122 .TP
123 \fBUSER ADD <name> [password] [-F user flags] [misc. options]\fR
124 Add specified user
125 .TP
126 \fBGROUP [misc options] [targets]\fR
127 List user groups
128 .TP
129 \fBGROUP DELETE <name> [misc. options] [targets]\fR
130 Delete specified group
131 .TP
132 \fBGROUP ADD <name> [-C comment]\fR
133 Create specified group
134 .TP
135 \fBSHARE [misc. options] [targets]\fR
136 enumerates all exported resources (network shares) on target server
137 .TP
138 \fBSHARE ADD <name=serverpath> [misc. options] [targets]\fR
139 Adds a share from a server (makes the export active)
140 .TP
141 \fBSHARE DELETE <sharenam\fR
142 .SH "VERSION"
143 .PP
144 This man page is incomplete for version 3.0 of the Samba 
145 suite.
146 .SH "AUTHOR"
147 .PP
148 The original Samba software and related utilities 
149 were created by Andrew Tridgell. Samba is now developed
150 by the Samba Team as an Open Source project similar 
151 to the way the Linux kernel is developed.
152 .PP
153 The original Samba man pages were written by Karl Auer.
154 The current set of manpages and documentation is maintained
155 by the Samba Team in the same fashion as the Samba source code.