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>\t\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>\t\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"\
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");
80 net_common_methods_usage(argc
, argv
);
81 net_common_flags_usage(argc
, argv
);
82 d_printf("\t-C or --comment=<comment>\tdescriptive comment (for add only)\n");
83 d_printf("\t-c or --container=<container>\tLDAP container, defaults to cn=Users (for add in ADS only)\n");
87 int net_help_group(int argc
, const char **argv
)
89 d_printf("net [<method>] group [misc. options] [targets]"\
90 "\n\tList user groups\n\n");
91 d_printf("net [<method>] group DELETE <name> "\
92 "[misc. options] [targets]"\
93 "\n\tDelete specified group\n");
94 d_printf("\nnet [<method>] group ADD <name> [-C comment] [-c container]"\
95 " [misc. options] [targets]\n\tCreate specified group\n");
96 net_common_methods_usage(argc
, argv
);
97 net_common_flags_usage(argc
, argv
);
98 d_printf("\t-C or --comment=<comment>\tdescriptive comment (for add only)\n");
99 d_printf("\t-c or --container=<container>\tLDAP container, defaults to cn=Users (for add in ADS only)\n");
103 int net_help_join(int argc
, const char **argv
)
105 d_printf("\nnet [<method>] join [misc. options]\n"
106 "\tjoins this server to a domain\n");
107 d_printf("Valid methods: (auto-detected if not specified)\n");
108 d_printf("\tads\t\t\t\tActive Directory (LDAP/Kerberos)\n");
109 d_printf("\trpc\t\t\t\tDCE-RPC\n");
110 net_common_flags_usage(argc
, argv
);
114 int net_help_share(int argc
, const char **argv
)
117 "\nnet [<method>] share [misc. options] [targets] \n"
118 "\tenumerates all exported resources (network shares) "
119 "on target server\n\n"
120 "net [<method>] share ADD <name=serverpath> [misc. options] [targets]"
121 "\n\tAdds a share from a server (makes the export active)\n\n"
122 "net [<method>] share DELETE <sharename> [misc. options] [targets]\n"
123 "\n\tDeletes a share from a server (makes the export inactive)\n");
124 net_common_methods_usage(argc
, argv
);
125 net_common_flags_usage(argc
, argv
);
127 "\t-C or --comment=<comment>\tdescriptive comment (for add only)\n"
128 "\t-M or --maxusers=<num>\t\tmax users allowed for share\n");
132 int net_help_file(int argc
, const char **argv
)
134 d_printf("net [<method>] file [misc. options] [targets]\n"\
135 "\tlists all open files on file server\n\n");
136 d_printf("net [<method>] file USER <username> "\
137 "[misc. options] [targets]"\
138 "\n\tlists all files opened by username on file server\n\n");
139 d_printf("net [<method>] file CLOSE <id> [misc. options] [targets]\n"\
140 "\tcloses specified file on target server\n\n");
141 d_printf("net [rap] file INFO <id> [misc. options] [targets]\n"\
142 "\tdisplays information about the specified open file\n");
144 net_common_methods_usage(argc
, argv
);
145 net_common_flags_usage(argc
, argv
);
149 static int net_usage(int argc
, const char **argv
)
151 d_printf(" net time\t\tto view or set time information\n"\
152 " net lookup\t\tto lookup host name or ip address\n"\
153 " net user\t\tto manage users\n"\
154 " net group\t\tto manage groups\n"\
155 " net groupmap\t\tto manage group mappings\n"\
156 " net join\t\tto join a domain\n"\
157 " net cache\t\tto operate on cache tdb file\n"\
158 " net getlocalsid [NAME]\tto get the SID for local name\n"\
159 " net setlocalsid SID\tto set the local domain SID\n"\
160 " net changesecretpw\tto change the machine password in the local secrets database only\n"\
161 " \tthis requires the -f flag as a safety barrier\n"\
163 " net ads <command>\tto run ADS commands\n"\
164 " net rap <command>\tto run RAP (pre-RPC) commands\n"\
165 " net rpc <command>\tto run RPC commands\n"\
167 "Type \"net help <option>\" to get more information on that option\n");
168 net_common_flags_usage(argc
, argv
);
173 handle "net help *" subcommands
175 int net_help(int argc
, const char **argv
)
177 struct functable func
[] = {
178 {"ADS", net_ads_help
},
179 {"RAP", net_rap_help
},
180 {"RPC", net_rpc_help
},
182 {"FILE", net_help_file
},
183 {"SHARE", net_help_share
},
184 {"SESSION", net_rap_session_usage
},
185 {"SERVER", net_rap_server_usage
},
186 {"DOMAIN", net_rap_domain_usage
},
187 {"PRINTQ", net_rap_printq_usage
},
188 {"USER", net_help_user
},
189 {"GROUP", net_help_group
},
190 {"GROUPMAP", net_help_groupmap
},
191 {"JOIN", net_help_join
},
192 {"VALIDATE", net_rap_validate_usage
},
193 {"GROUPMEMBER", net_rap_groupmember_usage
},
194 {"ADMIN", net_rap_admin_usage
},
195 {"SERVICE", net_rap_service_usage
},
196 {"PASSWORD", net_rap_password_usage
},
197 {"TIME", net_time_usage
},
198 {"LOOKUP", net_lookup_usage
},
199 #ifdef WITH_FAKE_KASERVER
200 {"AFSKEY", net_afskey_usage
},
203 {"HELP", help_usage
},
206 return net_run_function(argc
, argv
, func
, net_usage
);