2
Samba Unix/Linux SMB client library
4
Copyright (C) 2002 Jim McDonough (jmcd@us.ibm.com)
6
This program is free software; you can redistribute it and/or modify
7
it under the terms of the GNU General Public License as published by
8
the Free Software Foundation; either version 2 of the License, or
9
(at your option) any later version.
11
This program is distributed in the hope that it will be useful,
12
but WITHOUT ANY WARRANTY; without even the implied warranty of
13
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14
GNU General Public License for more details.
16
You should have received a copy of the GNU General Public License
17
along with this program; if not, write to the Free Software
18
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22
#include "utils/net.h"
24
int net_common_methods_usage(int argc, const char**argv)
26
d_printf("Valid methods: (auto-detected if not specified)\n");
27
d_printf("\tads\t\t\t\tActive Directory (LDAP/Kerberos)\n");
28
d_printf("\trpc\t\t\t\tDCE-RPC\n");
29
d_printf("\trap\t\t\t\tRAP (older systems)\n");
34
int net_common_flags_usage(int argc, const char **argv)
36
d_printf("Valid targets: choose one (none defaults to localhost)\n");
37
d_printf("\t-S or --server=<server>\t\tserver name\n");
38
d_printf("\t-I or --ipaddress=<ipaddr>\taddress of target server\n");
39
d_printf("\t-w or --workgroup=<wg>\t\ttarget workgroup or domain\n");
42
d_printf("Valid miscellaneous options are:\n"); /* misc options */
43
d_printf("\t-p or --port=<port>\t\tconnection port on target\n");
44
d_printf("\t-W or --myworkgroup=<wg>\tclient workgroup\n");
45
d_printf("\t-d or --debuglevel=<level>\tdebug level (0-10)\n");
46
d_printf("\t-n or --myname=<name>\t\tclient name\n");
47
d_printf("\t-U or --user=<name>\t\tuser name\n");
48
d_printf("\t-s or --configfile=<path>\tpathname of smb.conf file\n");
49
d_printf("\t-l or --long\t\t\tDisplay full information\n");
50
d_printf("\t-V or --version\t\t\tPrint samba version information\n");
51
d_printf("\t-P or --machine-pass\t\tAuthenticate as machine account\n");
55
static int help_usage(int argc, const char **argv)
59
"Usage: net help <function>\n"\
61
"Valid functions are:\n"\
62
" RPC RAP ADS FILE SHARE SESSION SERVER DOMAIN PRINTQ USER GROUP VALIDATE\n"\
63
" GROUPMEMBER ADMIN SERVICE PASSWORD TIME LOOKUP GETLOCALSID SETLOCALSID\n"\
64
" SETDOMAINSID CHANGESCRETPW LOOKUP SAM\n");
68
int net_help_user(int argc, const char **argv)
70
d_printf("\nnet [<method>] user [misc. options] [targets]"\
71
"\n\tList users\n\n");
72
d_printf("net [<method>] user DELETE <name> [misc. options] [targets]"\
73
"\n\tDelete specified user\n");
74
d_printf("\nnet [<method>] user INFO <name> [misc. options] [targets]"\
75
"\n\tList the domain groups of the specified user\n");
76
d_printf("\nnet [<method>] user ADD <name> [password] [-c container] "\
77
"[-F user flags] [misc. options]"\
78
" [targets]\n\tAdd specified user\n");
79
d_printf("\nnet [<method>] user RENAME <oldusername> <newusername>"\
80
" [targets]\n\tRename specified user\n\n");
83
net_common_methods_usage(argc, argv);
84
net_common_flags_usage(argc, argv);
85
d_printf("\t-C or --comment=<comment>\tdescriptive comment (for add only)\n");
86
d_printf("\t-c or --container=<container>\tLDAP container, defaults to cn=Users (for add in ADS only)\n");
90
int net_help_group(int argc, const char **argv)
92
d_printf("net [<method>] group [misc. options] [targets]"\
93
"\n\tList user groups\n\n");
94
d_printf("net rpc group LIST [global|local|builtin]* [misc. options]"\
95
"\n\tList specific user groups\n\n");
96
d_printf("net [<method>] group DELETE <name> "\
97
"[misc. options] [targets]"\
98
"\n\tDelete specified group\n");
99
d_printf("\nnet [<method>] group ADD <name> [-C comment] [-c container]"\
100
" [misc. options] [targets]\n\tCreate specified group\n");
101
d_printf("\nnet rpc group MEMBERS <name>\n\tList Group Members\n\n");
102
d_printf("\nnet rpc group ADDMEM <group> <member>\n\tAdd Group Members\n\n");
103
d_printf("\nnet rpc group DELMEM <group> <member>\n\tDelete Group Members\n\n");
104
net_common_methods_usage(argc, argv);
105
net_common_flags_usage(argc, argv);
106
d_printf("\t-C or --comment=<comment>\tdescriptive comment (for add only)\n");
107
d_printf("\t-c or --container=<container>\tLDAP container, defaults to cn=Users (for add in ADS only)\n");
108
d_printf("\t-L or --localgroup\t\tWhen adding groups, create a local group (alias)\n");
112
int net_help_join(int argc, const char **argv)
114
d_printf("\nnet [<method>] join [misc. options]\n"
115
"\tjoins this server to a domain\n");
116
d_printf("Valid methods: (auto-detected if not specified)\n");
117
d_printf("\tads\t\t\t\tActive Directory (LDAP/Kerberos)\n");
118
d_printf("\trpc\t\t\t\tDCE-RPC\n");
119
net_common_flags_usage(argc, argv);
123
int net_help_share(int argc, const char **argv)
126
"\nnet [<method>] share [misc. options] [targets] \n"
127
"\tenumerates all exported resources (network shares) "
128
"on target server\n\n"
129
"net [<method>] share ADD <name=serverpath> [misc. options] [targets]"
130
"\n\tadds a share from a server (makes the export active)\n\n"
131
"net [<method>] share DELETE <sharename> [misc. options] [targets]"
132
"\n\tdeletes a share from a server (makes the export inactive)\n\n"
133
"net [<method>] share ALLOWEDUSERS [<filename>] "
134
"[misc. options] [targets]"
135
"\n\tshows a list of all shares together with all users allowed to"
136
"\n\taccess them. This needs the output of 'net usersidlist' on"
137
"\n\tstdin or in <filename>.\n\n"
138
"net [<method>] share MIGRATE FILES <sharename> [misc. options] [targets]"
139
"\n\tMigrates files from remote to local server\n\n"
140
"net [<method>] share MIGRATE SHARES <sharename> [misc. options] [targets]"
141
"\n\tMigrates shares from remote to local server\n\n"
142
"net [<method>] share MIGRATE SECURITY <sharename> [misc. options] [targets]"
143
"\n\tMigrates share-ACLs from remote to local server\n\n"
144
"net [<method>] share MIGRATE ALL <sharename> [misc. options] [targets]"
145
"\n\tMigrates shares (including directories, files) from remote\n"
146
"\tto local server\n\n"
148
net_common_methods_usage(argc, argv);
149
net_common_flags_usage(argc, argv);
151
"\t-C or --comment=<comment>\tdescriptive comment (for add only)\n"
152
"\t-M or --maxusers=<num>\t\tmax users allowed for share\n"
153
"\t --acls\t\t\tcopies ACLs as well\n"
154
"\t --attrs\t\t\tcopies DOS Attributes as well\n"
155
"\t --timestamps\t\tpreserve timestamps while copying files\n"
156
"\t --destination\t\tmigration target server (default: localhost)\n"
157
"\t-e or --exclude\t\t\tlist of shares to be excluded from mirroring\n"
158
"\t-v or --verbose\t\t\tgive verbose output\n");
162
int net_help_file(int argc, const char **argv)
164
d_printf("net [<method>] file [misc. options] [targets]\n"\
165
"\tlists all open files on file server\n\n");
166
d_printf("net [<method>] file USER <username> "\
167
"[misc. options] [targets]"\
168
"\n\tlists all files opened by username on file server\n\n");
169
d_printf("net [<method>] file CLOSE <id> [misc. options] [targets]\n"\
170
"\tcloses specified file on target server\n\n");
171
d_printf("net [rap] file INFO <id> [misc. options] [targets]\n"\
172
"\tdisplays information about the specified open file\n");
174
net_common_methods_usage(argc, argv);
175
net_common_flags_usage(argc, argv);
179
int net_help_printer(int argc, const char **argv)
181
d_printf("net rpc printer LIST [printer] [misc. options] [targets]\n"\
182
"\tlists all printers on print-server\n\n");
183
d_printf("net rpc printer DRIVER [printer] [misc. options] [targets]\n"\
184
"\tlists all printer-drivers on print-server\n\n");
185
d_printf("net rpc printer PUBLISH action [printer] [misc. options] [targets]\n"\
186
"\tpublishes printer settings in Active Directory\n"
187
"\taction can be one of PUBLISH, UPDATE, UNPUBLISH or LIST\n\n");
188
d_printf("net rpc printer MIGRATE PRINTERS [printer] [misc. options] [targets]"\
189
"\n\tmigrates printers from remote to local server\n\n");
190
d_printf("net rpc printer MIGRATE SETTINGS [printer] [misc. options] [targets]"\
191
"\n\tmigrates printer-settings from remote to local server\n\n");
192
d_printf("net rpc printer MIGRATE DRIVERS [printer] [misc. options] [targets]"\
193
"\n\tmigrates printer-drivers from remote to local server\n\n");
194
d_printf("net rpc printer MIGRATE FORMS [printer] [misc. options] [targets]"\
195
"\n\tmigrates printer-forms from remote to local server\n\n");
196
d_printf("net rpc printer MIGRATE SECURITY [printer] [misc. options] [targets]"\
197
"\n\tmigrates printer-ACLs from remote to local server\n\n");
198
d_printf("net rpc printer MIGRATE ALL [printer] [misc. options] [targets]"\
199
"\n\tmigrates drivers, forms, queues, settings and acls from\n"\
200
"\tremote to local print-server\n\n");
201
net_common_methods_usage(argc, argv);
202
net_common_flags_usage(argc, argv);
204
"\t-v or --verbose\t\t\tgive verbose output\n"
205
"\t --destination\t\tmigration target server (default: localhost)\n");
211
int net_help_status(int argc, const char **argv)
213
d_printf(" net status sessions [parseable] "
214
"Show list of open sessions\n");
215
d_printf(" net status shares [parseable] "
216
"Show list of open shares\n");
220
static int net_usage(int argc, const char **argv)
222
d_printf(" net time\t\tto view or set time information\n"\
223
" net lookup\t\tto lookup host name or ip address\n"\
224
" net user\t\tto manage users\n"\
225
" net group\t\tto manage groups\n"\
226
" net sam\t\tto edit the local user database directly\n"\
227
" net lookup\t\tto look up various things\n"\
228
" net groupmap\t\tto manage group mappings\n"\
229
" net join\t\tto join a domain\n"\
230
" net cache\t\tto operate on cache tdb file\n"\
231
" net getlocalsid [NAME]\tto get the SID for local name\n"\
232
" net setlocalsid SID\tto set the local domain SID\n"\
233
" net setdomainsid SID\tto set the domain SID on member servers\n"\
234
" net changesecretpw\tto change the machine password in the local secrets database only\n"\
235
" \tthis requires the -f flag as a safety barrier\n"\
236
" net status\t\tShow server status\n"\
237
" net usersidlist\tto get a list of all users with their SIDs\n"
238
" net usershare\t\tto add, delete and list locally user-modifiable shares\n"
240
" net ads <command>\tto run ADS commands\n"\
241
" net rap <command>\tto run RAP (pre-RPC) commands\n"\
242
" net rpc <command>\tto run RPC commands\n"\
244
"Type \"net help <option>\" to get more information on that option\n");
245
net_common_flags_usage(argc, argv);
250
handle "net help *" subcommands
252
int net_help(int argc, const char **argv)
254
struct functable func[] = {
255
{"ADS", net_ads_help},
256
{"RAP", net_rap_help},
257
{"RPC", net_rpc_help},
259
{"FILE", net_help_file},
260
{"SHARE", net_help_share},
261
{"SESSION", net_rap_session_usage},
262
{"SERVER", net_rap_server_usage},
263
{"DOMAIN", net_rap_domain_usage},
264
{"PRINTQ", net_rap_printq_usage},
265
{"USER", net_help_user},
266
{"GROUP", net_help_group},
267
{"GROUPMAP", net_help_groupmap},
268
{"JOIN", net_help_join},
269
{"VALIDATE", net_rap_validate_usage},
270
{"GROUPMEMBER", net_rap_groupmember_usage},
271
{"ADMIN", net_rap_admin_usage},
272
{"SERVICE", net_rap_service_usage},
273
{"PASSWORD", net_rap_password_usage},
274
{"TIME", net_time_usage},
275
{"LOOKUP", net_lookup_usage},
276
{"USERSHARE", net_usershare_usage},
277
{"USERSIDLIST", net_usersidlist_usage},
278
#ifdef WITH_FAKE_KASERVER
279
{"AFS", net_help_afs},
282
{"HELP", help_usage},
285
return net_run_function(argc, argv, func, net_usage);