2 Samba Unix/Linux SMB client library
3 Distributed SMB/CIFS Server Management Utility
4 Copyright (C) 2001 Steve French (sfrench@us.ibm.com)
5 Copyright (C) 2001 Jim McDonough (jmcd@us.ibm.com)
6 Copyright (C) 2001 Andrew Tridgell (tridge@samba.org)
7 Copyright (C) 2001 Andrew Bartlett (abartlet@samba.org)
8 Copyright (C) 2008 Kai Blin (kai@samba.org)
10 Originally written by Steve and Jim. Largely rewritten by tridge in
13 Reworked again by abartlet in December 2001
15 Another overhaul, moving functionality into plug-ins loaded on demand by Kai
18 This program is free software; you can redistribute it and/or modify
19 it under the terms of the GNU General Public License as published by
20 the Free Software Foundation; either version 3 of the License, or
21 (at your option) any later version.
23 This program is distributed in the hope that it will be useful,
24 but WITHOUT ANY WARRANTY; without even the implied warranty of
25 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 GNU General Public License for more details.
28 You should have received a copy of the GNU General Public License
29 along with this program. If not, see <http://www.gnu.org/licenses/>. */
31 /*****************************************************/
33 /* Distributed SMB/CIFS Server Management Utility */
35 /* The intent was to make the syntax similar */
36 /* to the NET utility (first developed in DOS */
37 /* with additional interesting & useful functions */
38 /* added in later SMB server network operating */
41 /*****************************************************/
44 #include "utils/net.h"
46 extern bool AllowDebugChange;
48 #ifdef WITH_FAKE_KASERVER
49 #include "utils/net_afs.h"
52 /***********************************************************************/
53 /* end of internationalization section */
54 /***********************************************************************/
56 uint32 get_sec_channel_type(const char *param)
58 if (!(param && *param)) {
59 return get_default_sec_channel();
61 if (strequal(param, "PDC")) {
63 } else if (strequal(param, "BDC")) {
65 } else if (strequal(param, "MEMBER")) {
66 return SEC_CHAN_WKSTA;
68 } else if (strequal(param, "DOMAIN")) {
69 return SEC_CHAN_DOMAIN;
72 return get_default_sec_channel();
77 static int net_changetrustpw(struct net_context *c, int argc, const char **argv)
79 if (net_ads_check_our_domain(c) == 0)
80 return net_ads_changetrustpw(c, argc, argv);
82 return net_rpc_changetrustpw(c, argc, argv);
85 static void set_line_buffering(FILE *f)
87 setvbuf(f, NULL, _IOLBF, 0);
90 static int net_changesecretpw(struct net_context *c, int argc,
94 uint32 sec_channel_type = SEC_CHAN_WKSTA;
98 set_line_buffering(stdin);
99 set_line_buffering(stdout);
100 set_line_buffering(stderr);
103 trust_pw = get_pass(_("Enter machine password: "), c->opt_stdin);
105 if (!secrets_store_machine_password(trust_pw, lp_workgroup(), sec_channel_type)) {
107 _("Unable to write the machine account password in the secrets database"));
111 d_printf(_("Modified trust account password in secrets database\n"));
115 d_printf(_("Machine account password change requires the -f flag.\n"
116 "Do NOT use this function unless you know what it does!\n"
117 "This function will change the ADS Domain member "
118 "machine account password in the secrets.tdb file!\n"));
125 Retrieve our local SID or the SID for the specified name
127 static int net_getlocalsid(struct net_context *c, int argc, const char **argv)
137 name = global_myname();
140 if(!initialize_password_db(false, NULL)) {
141 DEBUG(0, ("WARNING: Could not open passdb - local sid may not reflect passdb\n"
142 "backend knowledge (such as the sid stored in LDAP)\n"));
145 /* first check to see if we can even access secrets, so we don't
146 panic when we can't. */
148 if (!secrets_init()) {
150 _("Unable to open secrets.tdb. Can't fetch domain "
151 "SID for name: %s\n"), name);
155 /* Generate one, if it doesn't exist */
156 get_global_sam_sid();
158 if (!secrets_fetch_domain_sid(name, &sid)) {
159 DEBUG(0, ("Can't fetch domain SID for name: %s\n", name));
162 sid_to_fstring(sid_str, &sid);
163 d_printf(_("SID for domain %s is: %s\n"), name, sid_str);
167 static int net_setlocalsid(struct net_context *c, int argc, const char **argv)
172 || (strncmp(argv[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
173 || (!string_to_sid(&sid, argv[0]))
174 || (sid.num_auths != 4)) {
175 d_printf(_("usage: net setlocalsid S-1-5-21-x-y-z\n"));
179 if (!secrets_store_domain_sid(global_myname(), &sid)) {
180 DEBUG(0,("Can't store domain SID as a pdc/bdc.\n"));
187 static int net_setdomainsid(struct net_context *c, int argc, const char **argv)
192 || (strncmp(argv[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
193 || (!string_to_sid(&sid, argv[0]))
194 || (sid.num_auths != 4)) {
195 d_printf(_("usage: net setdomainsid S-1-5-21-x-y-z\n"));
199 if (!secrets_store_domain_sid(lp_workgroup(), &sid)) {
200 DEBUG(0,("Can't store domain SID.\n"));
207 static int net_getdomainsid(struct net_context *c, int argc, const char **argv)
213 d_printf(_("usage: net getdomainsid\n"));
217 if(!initialize_password_db(false, NULL)) {
218 DEBUG(0, ("WARNING: Could not open passdb - domain SID may "
219 "not reflect passdb\n"
220 "backend knowledge (such as the SID stored in "
224 /* first check to see if we can even access secrets, so we don't
225 panic when we can't. */
227 if (!secrets_init()) {
228 d_fprintf(stderr, _("Unable to open secrets.tdb. Can't fetch "
229 "domain SID for name: %s\n"),
230 get_global_sam_name());
234 /* Generate one, if it doesn't exist */
235 get_global_sam_sid();
237 if (!secrets_fetch_domain_sid(global_myname(), &domain_sid)) {
238 d_fprintf(stderr, _("Could not fetch local SID\n"));
241 sid_to_fstring(sid_str, &domain_sid);
242 d_printf(_("SID for local machine %s is: %s\n"),
243 global_myname(), sid_str);
245 if (!secrets_fetch_domain_sid(c->opt_workgroup, &domain_sid)) {
246 d_fprintf(stderr, _("Could not fetch domain SID\n"));
250 sid_to_fstring(sid_str, &domain_sid);
251 d_printf(_("SID for domain %s is: %s\n"), c->opt_workgroup, sid_str);
256 static bool search_maxrid(struct pdb_search *search, const char *type,
259 struct samr_displayentry *entries;
260 uint32 i, num_entries;
262 if (search == NULL) {
263 d_fprintf(stderr, _("get_maxrid: Could not search %s\n"), type);
267 num_entries = pdb_search_entries(search, 0, 0xffffffff, &entries);
268 for (i=0; i<num_entries; i++)
269 *max_rid = MAX(*max_rid, entries[i].rid);
274 static uint32 get_maxrid(void)
278 if (!search_maxrid(pdb_search_users(talloc_tos(), 0), "users", &max_rid))
281 if (!search_maxrid(pdb_search_groups(talloc_tos()), "groups", &max_rid))
284 if (!search_maxrid(pdb_search_aliases(talloc_tos(),
285 get_global_sam_sid()),
286 "aliases", &max_rid))
292 static int net_maxrid(struct net_context *c, int argc, const char **argv)
297 d_fprintf(stderr, _("usage: net maxrid\n"));
301 if ((rid = get_maxrid()) == 0) {
302 d_fprintf(stderr, _("can't get current maximum rid\n"));
306 d_printf(_("Currently used maximum rid: %d\n"), rid);
311 /* main function table */
312 static struct functable net_func[] = {
317 N_("Run functions using RPC transport"),
318 N_(" Use 'net help rpc' to get more extensive information "
319 "about 'net rpc' commands.")
325 N_("Run functions using RAP transport"),
326 N_(" Use 'net help rap' to get more extensive information "
327 "about 'net rap' commands.")
333 N_("Run functions using ADS transport"),
334 N_(" Use 'net help ads' to get more extensive information "
335 "about 'net ads' commands.")
338 /* eventually these should auto-choose the transport ... */
342 NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
343 N_("Functions on remote opened files"),
344 N_(" Use 'net help file' to get more information about 'net "
350 NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
351 N_("Functions on shares"),
352 N_(" Use 'net help share' to get more information about 'net "
359 N_("Manage sessions"),
360 N_(" Use 'net help session' to get more information about "
361 "'net session' commands.")
367 N_("List servers in workgroup"),
368 N_(" Use 'net help server' to get more information about 'net "
375 N_("List domains/workgroups on network"),
376 N_(" Use 'net help domain' to get more information about 'net "
383 N_("Modify printer queue"),
384 N_(" Use 'net help printq' to get more information about 'net "
390 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
392 N_(" Use 'net help user' to get more information about 'net "
398 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
400 N_(" Use 'net help group' to get more information about 'net "
407 N_("Manage group mappings"),
408 N_(" Use 'net help groupmap' to get more information about "
409 "'net groupmap' commands.")
415 N_("Functions on the SAM database"),
416 N_(" Use 'net help sam' to get more information about 'net "
423 N_("Validate username and password"),
424 N_(" Use 'net help validate' to get more information about "
425 "'net validate' commands.")
431 N_("Modify group memberships"),
432 N_(" Use 'net help groupmember' to get more information about "
433 "'net groupmember' commands.")
438 N_("Execute remote command on a remote OS/2 server"),
439 N_(" Use 'net help admin' to get more information about 'net "
445 N_("List/modify running services"),
446 N_(" Use 'net help service' to get more information about "
447 "'net service' commands.")
453 N_("Change user password on target server"),
454 N_(" Use 'net help password' to get more information about "
455 "'net password' commands.")
459 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC,
460 N_("Change the trust password"),
461 N_(" Use 'net help changetrustpw' to get more information "
462 "about 'net changetrustpw'.")
467 N_("Change the secret password"),
468 N_(" net [options] changesecretpw\n"
469 " Change the ADS domain member machine account password "
471 " Do NOT use this function unless you know what it does.\n"
472 " Requires the -f flag to work.")
478 N_(" Use 'net help time' to get more information about 'net "
484 N_("Look up host names/IP addresses"),
485 N_(" Use 'net help lookup' to get more information about 'net "
490 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC,
491 N_("Join a domain/AD"),
492 N_(" Use 'net help join' to get more information about 'net "
498 N_("Join/unjoin (remote) machines to/from a domain/AD"),
499 N_(" Use 'net help dom' to get more information about 'net "
505 N_("Operate on the cache tdb file"),
506 N_(" Use 'net help cache' to get more information about 'net "
512 N_("Get the SID for the local domain"),
513 N_(" net getlocalsid")
518 N_("Set the SID for the local domain"),
519 N_(" net setlocalsid S-1-5-21-x-y-z")
524 N_("Set domain SID on member servers"),
525 N_(" net setdomainsid S-1-5-21-x-y-z")
530 N_("Get domain SID on member servers"),
531 N_(" net getdomainsid")
536 N_("Display the maximul RID currently used"),
542 N_("IDmap functions"),
543 N_(" Use 'net help idmap to get more information about 'net "
549 N_("Display server status"),
550 N_(" Use 'net help status' to get more information about 'net "
556 N_("Manage user-modifiable shares"),
557 N_(" Use 'net help usershare to get more information about "
558 "'net usershare' commands.")
563 N_("Display list of all users with SID"),
564 N_(" Use 'net help usersidlist' to get more information about "
565 "'net usersidlist'.")
570 N_("Manage Samba registry based configuration"),
571 N_(" Use 'net help conf' to get more information about 'net "
577 N_("Manage the Samba registry"),
578 N_(" Use 'net help registry' to get more information about "
579 "'net registry' commands.")
584 N_("Open a lua interpreter"),
585 N_(" Use 'net help lua' to get more information about 'net "
591 N_("Process Win32 *.evt eventlog files"),
592 N_(" Use 'net help eventlog' to get more information about "
593 "'net eventlog' commands.")
596 #ifdef WITH_FAKE_KASERVER
600 N_("Manage AFS tokens"),
601 N_(" Use 'net help afs' to get more information about 'net "
609 N_("Print usage information"),
610 N_(" Use 'net help help' to list usage information for 'net' "
613 {NULL, NULL, 0, NULL, NULL}
617 /****************************************************************************
619 ****************************************************************************/
620 int main(int argc, const char **argv)
626 const char ** argv_new;
628 TALLOC_CTX *frame = talloc_stackframe();
629 struct net_context *c = talloc_zero(frame, struct net_context);
631 struct poptOption long_options[] = {
632 {"help", 'h', POPT_ARG_NONE, 0, 'h'},
633 {"workgroup", 'w', POPT_ARG_STRING, &c->opt_target_workgroup},
634 {"user", 'U', POPT_ARG_STRING, &c->opt_user_name, 'U'},
635 {"ipaddress", 'I', POPT_ARG_STRING, 0,'I'},
636 {"port", 'p', POPT_ARG_INT, &c->opt_port},
637 {"myname", 'n', POPT_ARG_STRING, &c->opt_requester_name},
638 {"server", 'S', POPT_ARG_STRING, &c->opt_host},
639 {"encrypt", 'e', POPT_ARG_NONE, NULL, 'e', N_("Encrypt SMB transport (UNIX extended servers only)") },
640 {"container", 'c', POPT_ARG_STRING, &c->opt_container},
641 {"comment", 'C', POPT_ARG_STRING, &c->opt_comment},
642 {"maxusers", 'M', POPT_ARG_INT, &c->opt_maxusers},
643 {"flags", 'F', POPT_ARG_INT, &c->opt_flags},
644 {"long", 'l', POPT_ARG_NONE, &c->opt_long_list_entries},
645 {"reboot", 'r', POPT_ARG_NONE, &c->opt_reboot},
646 {"force", 'f', POPT_ARG_NONE, &c->opt_force},
647 {"stdin", 'i', POPT_ARG_NONE, &c->opt_stdin},
648 {"timeout", 't', POPT_ARG_INT, &c->opt_timeout},
649 {"request-timeout",0,POPT_ARG_INT, &c->opt_request_timeout},
650 {"machine-pass",'P', POPT_ARG_NONE, &c->opt_machine_pass},
651 {"kerberos", 'k', POPT_ARG_NONE, &c->opt_kerberos},
652 {"myworkgroup", 'W', POPT_ARG_STRING, &c->opt_workgroup},
653 {"verbose", 'v', POPT_ARG_NONE, &c->opt_verbose},
654 {"test", 'T', POPT_ARG_NONE, &c->opt_testmode},
655 /* Options for 'net groupmap set' */
656 {"local", 'L', POPT_ARG_NONE, &c->opt_localgroup},
657 {"domain", 'D', POPT_ARG_NONE, &c->opt_domaingroup},
658 {"ntname", 'N', POPT_ARG_STRING, &c->opt_newntname},
659 {"rid", 'R', POPT_ARG_INT, &c->opt_rid},
660 /* Options for 'net rpc share migrate' */
661 {"acls", 0, POPT_ARG_NONE, &c->opt_acls},
662 {"attrs", 0, POPT_ARG_NONE, &c->opt_attrs},
663 {"timestamps", 0, POPT_ARG_NONE, &c->opt_timestamps},
664 {"exclude", 'X', POPT_ARG_STRING, &c->opt_exclude},
665 {"destination", 0, POPT_ARG_STRING, &c->opt_destination},
666 {"tallocreport", 0, POPT_ARG_NONE, &c->do_talloc_report},
667 /* Options for 'net rpc vampire (keytab)' */
668 {"force-full-repl", 0, POPT_ARG_NONE, &c->opt_force_full_repl},
669 {"single-obj-repl", 0, POPT_ARG_NONE, &c->opt_single_obj_repl},
670 {"clean-old-entries", 0, POPT_ARG_NONE, &c->opt_clean_old_entries},
676 zero_sockaddr(&c->opt_dest_ip);
680 setlocale(LC_ALL, "");
681 bindtextdomain(MODULE_NAME, dyn_LOCALEDIR);
682 textdomain(MODULE_NAME);
684 /* set default debug level to 0 regardless of what smb.conf sets */
685 DEBUGLEVEL_CLASS[DBGC_ALL] = 0;
687 c->private_data = net_func;
689 pc = poptGetContext(NULL, argc, (const char **) argv, long_options,
690 POPT_CONTEXT_KEEP_FIRST);
692 while((opt = poptGetNextOpt(pc)) != -1) {
695 c->display_usage = true;
698 c->smb_encrypt = true;
701 if (!interpret_string_addr(&c->opt_dest_ip,
702 poptGetOptArg(pc), 0)) {
703 d_fprintf(stderr, _("\nInvalid ip address specified\n"));
705 c->opt_have_ip = true;
709 c->opt_user_specified = true;
710 c->opt_user_name = SMB_STRDUP(c->opt_user_name);
711 p = strchr(c->opt_user_name,'%');
714 c->opt_password = p+1;
718 d_fprintf(stderr, _("\nInvalid option %s: %s\n"),
719 poptBadOption(pc, 0), poptStrerror(opt));
720 net_help(c, argc, argv);
726 * Don't load debug level from smb.conf. It should be
727 * set by cmdline arg or remain default (0)
729 AllowDebugChange = false;
730 lp_load(get_dyn_CONFIGFILE(), true, false, false, true);
732 argv_new = (const char **)poptGetArgs(pc);
735 for (i=0; i<argc; i++) {
736 if (argv_new[i] == NULL) {
742 if (c->do_talloc_report) {
743 talloc_enable_leak_report();
746 if (c->opt_requester_name) {
747 set_global_myname(c->opt_requester_name);
750 if (!c->opt_user_name && getenv("LOGNAME")) {
751 c->opt_user_name = getenv("LOGNAME");
754 if (!c->opt_workgroup) {
755 c->opt_workgroup = smb_xstrdup(lp_workgroup());
758 if (!c->opt_target_workgroup) {
759 c->opt_target_workgroup = smb_xstrdup(lp_workgroup());
767 /* this makes sure that when we do things like call scripts,
768 that it won't assert becouse we are not root */
771 if (c->opt_machine_pass) {
772 /* it is very useful to be able to make ads queries as the
773 machine account for testing purposes and for domain leave */
775 net_use_krb_machine_account(c);
778 if (!c->opt_password) {
779 c->opt_password = getenv("PASSWD");
782 rc = net_run_function(c, argc_new-1, argv_new+1, "net", net_func);
784 DEBUG(2,("return code = %d\n", rc));
786 gencache_stabilize();
788 libnetapi_free(c->netapi_ctx);