source/utils/net_help.c

   1 /*
   2    Samba Unix/Linux SMB client library
   3    net help commands
   4    Copyright (C) 2002 Jim McDonough (jmcd@us.ibm.com)
   5
   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.
  10
  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.
  15
  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.
  19 */
  20
  21 #include "includes.h"
  22 #include "utils/net.h"
  23
  24 int net_common_methods_usage(int argc, const char**argv)
  25 {
  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");
  30         d_printf("\n");
  31         return 0;
  32 }
  33
  34 int net_common_flags_usage(int argc, const char **argv)
  35 {
  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");
  40
  41         d_printf("\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");
  52         return -1;
  53 }
  54
  55 static int help_usage(int argc, const char **argv)
  56 {
  57         d_printf(
  58 "\n"\
  59 "Usage: net help <function>\n"\
  60 "\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 "  CHANGESCRETPW\n");
  65         return -1;
  66 }
  67
  68 int net_help_user(int argc, const char **argv)
  69 {
  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
  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");
  84         return -1;
  85 }
  86
  87 int net_help_group(int argc, const char **argv)
  88 {
  89         d_printf("net [<method>] group [misc. options] [targets]"\
  90                  "\n\tList user groups\n\n");
  91         d_printf("net rpc group LIST [global|local|builtin]* [misc. options]"\
  92                  "\n\tList specific user groups\n\n");
  93         d_printf("net [<method>] group DELETE <name> "\
  94                  "[misc. options] [targets]"\
  95                  "\n\tDelete specified group\n");
  96         d_printf("\nnet [<method>] group ADD <name> [-C comment] [-c container]"\
  97                  " [misc. options] [targets]\n\tCreate specified group\n");
  98         d_printf("\nnet rpc group MEMBERS <name>\n\tList Group Members\n\n");
  99         net_common_methods_usage(argc, argv);
 100         net_common_flags_usage(argc, argv);
 101         d_printf("\t-C or --comment=<comment>\tdescriptive comment (for add only)\n");
 102         d_printf("\t-c or --container=<container>\tLDAP container, defaults to cn=Users (for add in ADS only)\n");
 103         d_printf("\t-L or --localgroup\t\tWhen adding groups, create a local group (alias)\n");
 104         return -1;
 105 }
 106
 107 int net_help_join(int argc, const char **argv)
 108 {
 109         d_printf("\nnet [<method>] join [misc. options]\n"
 110                  "\tjoins this server to a domain\n");
 111         d_printf("Valid methods: (auto-detected if not specified)\n");
 112         d_printf("\tads\t\t\t\tActive Directory (LDAP/Kerberos)\n");
 113         d_printf("\trpc\t\t\t\tDCE-RPC\n");
 114         net_common_flags_usage(argc, argv);
 115         return -1;
 116 }
 117
 118 int net_help_share(int argc, const char **argv)
 119 {
 120         d_printf(
 121          "\nnet [<method>] share [misc. options] [targets] \n"
 122          "\tenumerates all exported resources (network shares) "
 123          "on target server\n\n"
 124          "net [<method>] share ADD <name=serverpath> [misc. options] [targets]"
 125         "\n\tadds a share from a server (makes the export active)\n\n"
 126         "net [<method>] share DELETE <sharename> [misc. options] [targets]"
 127         "\n\tdeletes a share from a server (makes the export inactive)\n\n"
 128         "net [<method>] share ALLOWEDUSERS [<filename>] "
 129         "[misc. options] [targets]"
 130         "\n\tshows a list of all shares together with all users allowed to"
 131         "\n\taccess them. This needs the output of 'net usersidlist' on"
 132         "\n\tstdin or in <filename>.\n"
 133          "net [<method>] share MIGRATE FILES <sharename> [misc. options] [targets]"
 134          "\n\tMigrates files from remote to local server\n\n"
 135          "net [<method>] share MIGRATE SHARES <sharename> [misc. options] [targets]"
 136          "\n\tMigrates shares from remote to local server\n\n"
 137 /*       "net [<method>] share MIGRATE SECURITY <sharename> [misc. options] [targets]"
 138          "\n\tMigrates share-ACLs from remote to local server\n\n" */
 139          "net [<method>] share MIGRATE ALL <sharename> [misc. options] [targets]"
 140          "\n\tMigrates shares (including directories, files) from remote\n"
 141          "\tto local server\n\n"
 142         );
 143         net_common_methods_usage(argc, argv);
 144         net_common_flags_usage(argc, argv);
 145         d_printf(
 146          "\t-C or --comment=<comment>\tdescriptive comment (for add only)\n"
 147          "\t-M or --maxusers=<num>\t\tmax users allowed for share\n"
 148          "\t      --acls\t\t\tcopies ACLs as well\n"
 149          "\t      --attrs\t\t\tcopies DOS Attributes as well\n"
 150          "\t      --timestampes\t\tpreserve timestampes while copying files\n"
 151          "\t      --destination\t\tmigration target server (default: localhost)\n"
 152          "\t-e or --exclude\t\t\tlist of shares to be excluded from mirroring\n"
 153          "\t-v or --verbose\t\t\tgive verbose output\n");
 154         return -1;
 155 }
 156
 157 int net_help_file(int argc, const char **argv)
 158 {
 159         d_printf("net [<method>] file [misc. options] [targets]\n"\
 160                  "\tlists all open files on file server\n\n");
 161         d_printf("net [<method>] file USER <username> "\
 162                  "[misc. options] [targets]"\
 163                  "\n\tlists all files opened by username on file server\n\n");
 164         d_printf("net [<method>] file CLOSE <id> [misc. options] [targets]\n"\
 165                  "\tcloses specified file on target server\n\n");
 166         d_printf("net [rap] file INFO <id> [misc. options] [targets]\n"\
 167                  "\tdisplays information about the specified open file\n");
 168
 169         net_common_methods_usage(argc, argv);
 170         net_common_flags_usage(argc, argv);
 171         return -1;
 172 }
 173
 174 int net_help_printer(int argc, const char **argv)
 175 {
 176         d_printf("net rpc printer LIST [printer] [misc. options] [targets]\n"\
 177                  "\tlists all printers on print-server\n\n");
 178         d_printf("net rpc printer DRIVER [printer] [misc. options] [targets]\n"\
 179                  "\tlists all printer-drivers on print-server\n\n");
 180         d_printf("net rpc printer PUBLISH action [printer] [misc. options] [targets]\n"\
 181                  "\tpublishes printer settings in Active Directory\n"
 182                  "\taction can be one of PUBLISH, UPDATE, UNPUBLISH or LIST\n\n");
 183         d_printf("net rpc printer MIGRATE PRINTERS [printer] [misc. options] [targets]"\
 184                  "\n\tmigrates printers from remote to local server\n\n");
 185         d_printf("net rpc printer MIGRATE SETTINGS [printer] [misc. options] [targets]"\
 186                  "\n\tmigrates printer-settings from remote to local server\n\n");
 187         d_printf("net rpc printer MIGRATE DRIVERS [printer] [misc. options] [targets]"\
 188                  "\n\tmigrates printer-drivers from remote to local server\n\n");
 189         d_printf("net rpc printer MIGRATE FORMS [printer] [misc. options] [targets]"\
 190                  "\n\tmigrates printer-forms from remote to local server\n\n");
 191         d_printf("net rpc printer MIGRATE SECURITY [printer] [misc. options] [targets]"\
 192                  "\n\tmigrates printer-ACLs from remote to local server\n\n");
 193         d_printf("net rpc printer MIGRATE ALL [printer] [misc. options] [targets]"\
 194                  "\n\tmigrates drivers, forms, queues, settings and acls from\n"\
 195                  "\tremote to local print-server\n\n");
 196         net_common_methods_usage(argc, argv);
 197         net_common_flags_usage(argc, argv);
 198         d_printf(
 199          "\t-v or --verbose\t\t\tgive verbose output\n"
 200          "\t      --destination\t\tmigration target server (default: localhost)\n");
 201
 202         return -1;
 203 }
 204
 205
 206 int net_help_status(int argc, const char **argv)
 207 {
 208         d_printf("  net status sessions [parseable] "
 209                  "Show list of open sessions\n");
 210         d_printf("  net status shares [parseable]   "
 211                  "Show list of open shares\n");
 212         return -1;
 213 }
 214
 215 static int net_usage(int argc, const char **argv)
 216 {
 217         d_printf("  net time\t\tto view or set time information\n"\
 218                  "  net lookup\t\tto lookup host name or ip address\n"\
 219                  "  net user\t\tto manage users\n"\
 220                  "  net group\t\tto manage groups\n"\
 221                  "  net groupmap\t\tto manage group mappings\n"\
 222                  "  net join\t\tto join a domain\n"\
 223                  "  net cache\t\tto operate on cache tdb file\n"\
 224                  "  net getlocalsid [NAME]\tto get the SID for local name\n"\
 225                  "  net setlocalsid SID\tto set the local domain SID\n"\
 226                  "  net changesecretpw\tto change the machine password in the local secrets database only\n"\
 227                  "                    \tthis requires the -f flag as a safety barrier\n"\
 228                  "  net status\t\tShow server status\n"\
 229                 "  net usersidlist\tto get a list of all users with their SIDs\n"
 230                  "\n"\
 231                  "  net ads <command>\tto run ADS commands\n"\
 232                  "  net rap <command>\tto run RAP (pre-RPC) commands\n"\
 233                  "  net rpc <command>\tto run RPC commands\n"\
 234                  "\n"\
 235                  "Type \"net help <option>\" to get more information on that option\n");
 236         net_common_flags_usage(argc, argv);
 237         return -1;
 238 }
 239
 240 /*
 241   handle "net help *" subcommands
 242 */
 243 int net_help(int argc, const char **argv)
 244 {
 245         struct functable func[] = {
 246                 {"ADS", net_ads_help},
 247                 {"RAP", net_rap_help},
 248                 {"RPC", net_rpc_help},
 249
 250                 {"FILE", net_help_file},
 251                 {"SHARE", net_help_share},
 252                 {"SESSION", net_rap_session_usage},
 253                 {"SERVER", net_rap_server_usage},
 254                 {"DOMAIN", net_rap_domain_usage},
 255                 {"PRINTQ", net_rap_printq_usage},
 256                 {"USER", net_help_user},
 257                 {"GROUP", net_help_group},
 258                 {"GROUPMAP", net_help_groupmap},
 259                 {"JOIN", net_help_join},
 260                 {"VALIDATE", net_rap_validate_usage},
 261                 {"GROUPMEMBER", net_rap_groupmember_usage},
 262                 {"ADMIN", net_rap_admin_usage},
 263                 {"SERVICE", net_rap_service_usage},
 264                 {"PASSWORD", net_rap_password_usage},
 265                 {"TIME", net_time_usage},
 266                 {"LOOKUP", net_lookup_usage},
 267                 {"USERSIDLIST", net_usersidlist_usage},
 268 #ifdef WITH_FAKE_KASERVER
 269                 {"AFSKEY", net_afskey_usage},
 270 #endif
 271
 272                 {"HELP", help_usage},
 273                 {NULL, NULL}};
 274
 275         return net_run_function(argc, argv, func, net_usage);
 276 }