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 "popt_common.h"
45 #include "utils/net.h"
47 #include "lib/netapi/netapi.h"
48 #include "../libcli/security/security.h"
51 #ifdef WITH_FAKE_KASERVER
52 #include "utils/net_afs.h"
55 /***********************************************************************/
56 /* end of internationalization section */
57 /***********************************************************************/
59 enum netr_SchannelType get_sec_channel_type(const char *param)
61 if (!(param && *param)) {
62 return get_default_sec_channel();
64 if (strequal(param, "PDC")) {
66 } else if (strequal(param, "BDC")) {
68 } else if (strequal(param, "MEMBER")) {
69 return SEC_CHAN_WKSTA;
71 } else if (strequal(param, "DOMAIN")) {
72 return SEC_CHAN_DOMAIN;
75 return get_default_sec_channel();
80 static int net_changetrustpw(struct net_context *c, int argc, const char **argv)
82 if (net_ads_check_our_domain(c) == 0)
83 return net_ads_changetrustpw(c, argc, argv);
85 return net_rpc_changetrustpw(c, argc, argv);
88 static void set_line_buffering(FILE *f)
90 setvbuf(f, NULL, _IOLBF, 0);
93 static int net_changesecretpw(struct net_context *c, int argc,
97 enum netr_SchannelType sec_channel_type = SEC_CHAN_WKSTA;
101 set_line_buffering(stdin);
102 set_line_buffering(stdout);
103 set_line_buffering(stderr);
106 trust_pw = get_pass(_("Enter machine password: "), c->opt_stdin);
108 if (!secrets_store_machine_password(trust_pw, lp_workgroup(), sec_channel_type)) {
110 _("Unable to write the machine account password in the secrets database"));
114 d_printf(_("Modified trust account password in secrets database\n"));
118 d_printf(_("Machine account password change requires the -f flag.\n"
119 "Do NOT use this function unless you know what it does!\n"
120 "This function will change the ADS Domain member "
121 "machine account password in the secrets.tdb file!\n"));
128 * @brief Set the authorised user for winbindd access in secrets.tdb
130 static int net_setauthuser(struct net_context *c, int argc, const char **argv)
132 const char *password = NULL;
134 if (!secrets_init()) {
135 d_fprintf(stderr, _("Failed to open secrets.tdb.\n"));
139 /* Delete the settings. */
141 if (strncmp(argv[0], "delete", 6) != 0) {
142 d_fprintf(stderr,_("Usage:\n"));
144 _(" net setauthuser -U user[%%password] \n"
145 " Set the auth user account to user"
146 "password. Prompt for password if not "
149 _(" net setauthuser delete\n"
150 " Delete the auth user setting.\n"));
153 secrets_delete(SECRETS_AUTH_USER);
154 secrets_delete(SECRETS_AUTH_DOMAIN);
155 secrets_delete(SECRETS_AUTH_PASSWORD);
159 if (!c->opt_user_specified) {
160 d_fprintf(stderr, _("Usage:\n"));
162 _(" net setauthuser -U user[%%password]\n"
163 " Set the auth user account to user"
164 "password. Prompt for password if not "
167 _(" net setauthuser delete\n"
168 " Delete the auth user setting.\n"));
172 password = net_prompt_pass(c, _("the auth user"));
173 if (password == NULL) {
174 d_fprintf(stderr,_("Failed to get the auth users password.\n"));
178 if (!secrets_store(SECRETS_AUTH_USER, c->opt_user_name,
179 strlen(c->opt_user_name) + 1)) {
180 d_fprintf(stderr, _("error storing auth user name\n"));
184 if (!secrets_store(SECRETS_AUTH_DOMAIN, c->opt_workgroup,
185 strlen(c->opt_workgroup) + 1)) {
186 d_fprintf(stderr, _("error storing auth user domain\n"));
190 if (!secrets_store(SECRETS_AUTH_PASSWORD, password,
191 strlen(password) + 1)) {
192 d_fprintf(stderr, _("error storing auth user password\n"));
200 * @brief Get the auth user settings
202 static int net_getauthuser(struct net_context *c, int argc, const char **argv)
204 char *user, *domain, *password;
206 /* Lift data from secrets file */
208 secrets_fetch_ipc_userpass(&user, &domain, &password);
210 if ((!user || !*user) && (!domain || !*domain ) &&
211 (!password || !*password)){
216 d_printf(_("No authorised user configured\n"));
220 /* Pretty print authorised user info */
222 d_printf("%s%s%s%s%s\n", domain ? domain : "",
223 domain ? lp_winbind_separator(): "", user,
224 password ? "%" : "", password ? password : "");
233 Retrieve our local SID or the SID for the specified name
235 static int net_getlocalsid(struct net_context *c, int argc, const char **argv)
245 name = global_myname();
248 if(!initialize_password_db(false, NULL)) {
249 DEBUG(0, ("WARNING: Could not open passdb - local sid may not reflect passdb\n"
250 "backend knowledge (such as the sid stored in LDAP)\n"));
253 /* first check to see if we can even access secrets, so we don't
254 panic when we can't. */
256 if (!secrets_init()) {
258 _("Unable to open secrets.tdb. Can't fetch domain "
259 "SID for name: %s\n"), name);
263 /* Generate one, if it doesn't exist */
264 get_global_sam_sid();
266 if (!secrets_fetch_domain_sid(name, &sid)) {
267 DEBUG(0, ("Can't fetch domain SID for name: %s\n", name));
270 sid_to_fstring(sid_str, &sid);
271 d_printf(_("SID for domain %s is: %s\n"), name, sid_str);
275 static int net_setlocalsid(struct net_context *c, int argc, const char **argv)
280 || (strncmp(argv[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
281 || (!string_to_sid(&sid, argv[0]))
282 || (sid.num_auths != 4)) {
283 d_printf(_("Usage:"));
284 d_printf(" net setlocalsid S-1-5-21-x-y-z\n");
288 if (!secrets_store_domain_sid(global_myname(), &sid)) {
289 DEBUG(0,("Can't store domain SID as a pdc/bdc.\n"));
296 static int net_setdomainsid(struct net_context *c, int argc, const char **argv)
301 || (strncmp(argv[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
302 || (!string_to_sid(&sid, argv[0]))
303 || (sid.num_auths != 4)) {
304 d_printf(_("Usage:"));
305 d_printf(" net setdomainsid S-1-5-21-x-y-z\n");
309 if (!secrets_store_domain_sid(lp_workgroup(), &sid)) {
310 DEBUG(0,("Can't store domain SID.\n"));
317 static int net_getdomainsid(struct net_context *c, int argc, const char **argv)
319 struct dom_sid domain_sid;
323 d_printf(_("Usage:"));
324 d_printf(" net getdomainsid\n");
328 if(!initialize_password_db(false, NULL)) {
329 DEBUG(0, ("WARNING: Could not open passdb - domain SID may "
330 "not reflect passdb\n"
331 "backend knowledge (such as the SID stored in "
335 /* first check to see if we can even access secrets, so we don't
336 panic when we can't. */
338 if (!secrets_init()) {
339 d_fprintf(stderr, _("Unable to open secrets.tdb. Can't fetch "
340 "domain SID for name: %s\n"),
341 get_global_sam_name());
345 /* Generate one, if it doesn't exist */
346 get_global_sam_sid();
348 if (!secrets_fetch_domain_sid(global_myname(), &domain_sid)) {
349 d_fprintf(stderr, _("Could not fetch local SID\n"));
352 sid_to_fstring(sid_str, &domain_sid);
353 d_printf(_("SID for local machine %s is: %s\n"),
354 global_myname(), sid_str);
356 if (!secrets_fetch_domain_sid(c->opt_workgroup, &domain_sid)) {
357 d_fprintf(stderr, _("Could not fetch domain SID\n"));
361 sid_to_fstring(sid_str, &domain_sid);
362 d_printf(_("SID for domain %s is: %s\n"), c->opt_workgroup, sid_str);
367 static bool search_maxrid(struct pdb_search *search, const char *type,
370 struct samr_displayentry *entries;
371 uint32 i, num_entries;
373 if (search == NULL) {
374 d_fprintf(stderr, _("get_maxrid: Could not search %s\n"), type);
378 num_entries = pdb_search_entries(search, 0, 0xffffffff, &entries);
379 for (i=0; i<num_entries; i++)
380 *max_rid = MAX(*max_rid, entries[i].rid);
385 static uint32 get_maxrid(void)
389 if (!search_maxrid(pdb_search_users(talloc_tos(), 0), "users", &max_rid))
392 if (!search_maxrid(pdb_search_groups(talloc_tos()), "groups", &max_rid))
395 if (!search_maxrid(pdb_search_aliases(talloc_tos(),
396 get_global_sam_sid()),
397 "aliases", &max_rid))
403 static int net_maxrid(struct net_context *c, int argc, const char **argv)
408 d_fprintf(stderr, "%s net maxrid\n", _("Usage:"));
412 if ((rid = get_maxrid()) == 0) {
413 d_fprintf(stderr, _("can't get current maximum rid\n"));
417 d_printf(_("Currently used maximum rid: %d\n"), rid);
422 /* main function table */
423 static struct functable net_func[] = {
428 N_("Run functions using RPC transport"),
429 N_(" Use 'net help rpc' to get more extensive information "
430 "about 'net rpc' commands.")
436 N_("Run functions using RAP transport"),
437 N_(" Use 'net help rap' to get more extensive information "
438 "about 'net rap' commands.")
444 N_("Run functions using ADS transport"),
445 N_(" Use 'net help ads' to get more extensive information "
446 "about 'net ads' commands.")
449 /* eventually these should auto-choose the transport ... */
453 NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
454 N_("Functions on remote opened files"),
455 N_(" Use 'net help file' to get more information about 'net "
461 NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
462 N_("Functions on shares"),
463 N_(" Use 'net help share' to get more information about 'net "
470 N_("Manage sessions"),
471 N_(" Use 'net help session' to get more information about "
472 "'net session' commands.")
478 N_("List servers in workgroup"),
479 N_(" Use 'net help server' to get more information about 'net "
486 N_("List domains/workgroups on network"),
487 N_(" Use 'net help domain' to get more information about 'net "
494 N_("Modify printer queue"),
495 N_(" Use 'net help printq' to get more information about 'net "
501 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
503 N_(" Use 'net help user' to get more information about 'net "
509 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC | NET_TRANSPORT_RAP,
511 N_(" Use 'net help group' to get more information about 'net "
518 N_("Manage group mappings"),
519 N_(" Use 'net help groupmap' to get more information about "
520 "'net groupmap' commands.")
526 N_("Functions on the SAM database"),
527 N_(" Use 'net help sam' to get more information about 'net "
534 N_("Validate username and password"),
535 N_(" Use 'net help validate' to get more information about "
536 "'net validate' commands.")
542 N_("Modify group memberships"),
543 N_(" Use 'net help groupmember' to get more information about "
544 "'net groupmember' commands.")
549 N_("Execute remote command on a remote OS/2 server"),
550 N_(" Use 'net help admin' to get more information about 'net "
556 N_("List/modify running services"),
557 N_(" Use 'net help service' to get more information about "
558 "'net service' commands.")
564 N_("Change user password on target server"),
565 N_(" Use 'net help password' to get more information about "
566 "'net password' commands.")
570 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC,
571 N_("Change the trust password"),
572 N_(" Use 'net help changetrustpw' to get more information "
573 "about 'net changetrustpw'.")
578 N_("Change the secret password"),
579 N_(" net [options] changesecretpw\n"
580 " Change the ADS domain member machine account password "
582 " Do NOT use this function unless you know what it does.\n"
583 " Requires the -f flag to work.")
589 N_("Set the winbind auth user"),
590 N_(" net -U user[%%password] [-W domain] setauthuser\n"
591 " Set the auth user, password (and optionally domain\n"
592 " Will prompt for password if not given.\n"
593 " net setauthuser delete\n"
594 " Delete the existing auth user settings.")
600 N_("Get the winbind auth user settings"),
601 N_(" net getauthuser\n"
602 " Get the current winbind auth user settings.")
608 N_(" Use 'net help time' to get more information about 'net "
614 N_("Look up host names/IP addresses"),
615 N_(" Use 'net help lookup' to get more information about 'net "
621 N_("Manipulate the global lock table"),
622 N_(" Use 'net help g_lock' to get more information about "
623 "'net g_lock' commands.")
627 NET_TRANSPORT_ADS | NET_TRANSPORT_RPC,
628 N_("Join a domain/AD"),
629 N_(" Use 'net help join' to get more information about 'net "
635 N_("Join/unjoin (remote) machines to/from a domain/AD"),
636 N_(" Use 'net help dom' to get more information about 'net "
642 N_("Operate on the cache tdb file"),
643 N_(" Use 'net help cache' to get more information about 'net "
649 N_("Get the SID for the local domain"),
650 N_(" net getlocalsid")
655 N_("Set the SID for the local domain"),
656 N_(" net setlocalsid S-1-5-21-x-y-z")
661 N_("Set domain SID on member servers"),
662 N_(" net setdomainsid S-1-5-21-x-y-z")
667 N_("Get domain SID on member servers"),
668 N_(" net getdomainsid")
673 N_("Display the maximum RID currently used"),
679 N_("IDmap functions"),
680 N_(" Use 'net help idmap to get more information about 'net "
686 N_("Display server status"),
687 N_(" Use 'net help status' to get more information about 'net "
693 N_("Manage user-modifiable shares"),
694 N_(" Use 'net help usershare to get more information about "
695 "'net usershare' commands.")
700 N_("Display list of all users with SID"),
701 N_(" Use 'net help usersidlist' to get more information about "
702 "'net usersidlist'.")
707 N_("Manage Samba registry based configuration"),
708 N_(" Use 'net help conf' to get more information about 'net "
714 N_("Manage the Samba registry"),
715 N_(" Use 'net help registry' to get more information about "
716 "'net registry' commands.")
721 N_("Process Win32 *.evt eventlog files"),
722 N_(" Use 'net help eventlog' to get more information about "
723 "'net eventlog' commands.")
728 N_("Process tdb printer files"),
729 N_(" Use 'net help printing' to get more information about "
730 "'net printing' commands.")
736 N_("Manage the serverid tdb"),
737 N_(" Use 'net help serverid' to get more information about "
738 "'net serverid' commands.")
741 #ifdef WITH_FAKE_KASERVER
745 N_("Manage AFS tokens"),
746 N_(" Use 'net help afs' to get more information about 'net "
754 N_("Print usage information"),
755 N_(" Use 'net help help' to list usage information for 'net' "
758 {NULL, NULL, 0, NULL, NULL}
762 /****************************************************************************
764 ****************************************************************************/
765 int main(int argc, const char **argv)
771 const char ** argv_new;
773 TALLOC_CTX *frame = talloc_stackframe();
774 struct net_context *c = talloc_zero(frame, struct net_context);
776 struct poptOption long_options[] = {
777 {"help", 'h', POPT_ARG_NONE, 0, 'h'},
778 {"workgroup", 'w', POPT_ARG_STRING, &c->opt_target_workgroup},
779 {"user", 'U', POPT_ARG_STRING, &c->opt_user_name, 'U'},
780 {"ipaddress", 'I', POPT_ARG_STRING, 0,'I'},
781 {"port", 'p', POPT_ARG_INT, &c->opt_port},
782 {"myname", 'n', POPT_ARG_STRING, &c->opt_requester_name},
783 {"server", 'S', POPT_ARG_STRING, &c->opt_host},
784 {"encrypt", 'e', POPT_ARG_NONE, NULL, 'e', N_("Encrypt SMB transport (UNIX extended servers only)") },
785 {"container", 'c', POPT_ARG_STRING, &c->opt_container},
786 {"comment", 'C', POPT_ARG_STRING, &c->opt_comment},
787 {"maxusers", 'M', POPT_ARG_INT, &c->opt_maxusers},
788 {"flags", 'F', POPT_ARG_INT, &c->opt_flags},
789 {"long", 'l', POPT_ARG_NONE, &c->opt_long_list_entries},
790 {"reboot", 'r', POPT_ARG_NONE, &c->opt_reboot},
791 {"force", 'f', POPT_ARG_NONE, &c->opt_force},
792 {"stdin", 'i', POPT_ARG_NONE, &c->opt_stdin},
793 {"timeout", 't', POPT_ARG_INT, &c->opt_timeout},
794 {"request-timeout",0,POPT_ARG_INT, &c->opt_request_timeout},
795 {"machine-pass",'P', POPT_ARG_NONE, &c->opt_machine_pass},
796 {"kerberos", 'k', POPT_ARG_NONE, &c->opt_kerberos},
797 {"myworkgroup", 'W', POPT_ARG_STRING, &c->opt_workgroup},
798 {"use-ccache", 0, POPT_ARG_NONE, &c->opt_ccache},
799 {"verbose", 'v', POPT_ARG_NONE, &c->opt_verbose},
800 {"test", 'T', POPT_ARG_NONE, &c->opt_testmode},
801 /* Options for 'net groupmap set' */
802 {"local", 'L', POPT_ARG_NONE, &c->opt_localgroup},
803 {"domain", 'D', POPT_ARG_NONE, &c->opt_domaingroup},
804 {"ntname", 'N', POPT_ARG_STRING, &c->opt_newntname},
805 {"rid", 'R', POPT_ARG_INT, &c->opt_rid},
806 /* Options for 'net rpc share migrate' */
807 {"acls", 0, POPT_ARG_NONE, &c->opt_acls},
808 {"attrs", 0, POPT_ARG_NONE, &c->opt_attrs},
809 {"timestamps", 0, POPT_ARG_NONE, &c->opt_timestamps},
810 {"exclude", 'X', POPT_ARG_STRING, &c->opt_exclude},
811 {"destination", 0, POPT_ARG_STRING, &c->opt_destination},
812 {"tallocreport", 0, POPT_ARG_NONE, &c->do_talloc_report},
813 /* Options for 'net rpc vampire (keytab)' */
814 {"force-full-repl", 0, POPT_ARG_NONE, &c->opt_force_full_repl},
815 {"single-obj-repl", 0, POPT_ARG_NONE, &c->opt_single_obj_repl},
816 {"clean-old-entries", 0, POPT_ARG_NONE, &c->opt_clean_old_entries},
817 /* Options for 'net idmap'*/
818 {"db", 0, POPT_ARG_STRING, &c->opt_db},
823 zero_sockaddr(&c->opt_dest_ip);
825 setup_logging(argv[0], DEBUG_STDERR);
829 setlocale(LC_ALL, "");
830 #if defined(HAVE_BINDTEXTDOMAIN)
831 bindtextdomain(MODULE_NAME, dyn_LOCALEDIR);
833 #if defined(HAVE_TEXTDOMAIN)
834 textdomain(MODULE_NAME);
837 /* set default debug level to 0 regardless of what smb.conf sets */
838 lp_set_cmdline("log level", "0");
839 c->private_data = net_func;
841 pc = poptGetContext(NULL, argc, (const char **) argv, long_options,
842 POPT_CONTEXT_KEEP_FIRST);
844 while((opt = poptGetNextOpt(pc)) != -1) {
847 c->display_usage = true;
850 c->smb_encrypt = true;
853 if (!interpret_string_addr(&c->opt_dest_ip,
854 poptGetOptArg(pc), 0)) {
855 d_fprintf(stderr, _("\nInvalid ip address specified\n"));
857 c->opt_have_ip = true;
861 c->opt_user_specified = true;
862 c->opt_user_name = SMB_STRDUP(c->opt_user_name);
863 p = strchr(c->opt_user_name,'%');
866 c->opt_password = p+1;
870 d_fprintf(stderr, _("\nInvalid option %s: %s\n"),
871 poptBadOption(pc, 0), poptStrerror(opt));
872 net_help(c, argc, argv);
877 lp_load(get_dyn_CONFIGFILE(), true, false, false, true);
879 argv_new = (const char **)poptGetArgs(pc);
882 for (i=0; i<argc; i++) {
883 if (argv_new[i] == NULL) {
889 if (c->do_talloc_report) {
890 talloc_enable_leak_report();
893 if (c->opt_requester_name) {
894 set_global_myname(c->opt_requester_name);
897 if (!c->opt_user_name && getenv("LOGNAME")) {
898 c->opt_user_name = getenv("LOGNAME");
901 if (!c->opt_workgroup) {
902 c->opt_workgroup = smb_xstrdup(lp_workgroup());
905 if (!c->opt_target_workgroup) {
906 c->opt_target_workgroup = smb_xstrdup(lp_workgroup());
914 /* this makes sure that when we do things like call scripts,
915 that it won't assert because we are not root */
918 if (c->opt_machine_pass) {
919 /* it is very useful to be able to make ads queries as the
920 machine account for testing purposes and for domain leave */
922 net_use_krb_machine_account(c);
925 if (!c->opt_password) {
926 c->opt_password = getenv("PASSWD");
929 /* Failing to init the msg_ctx isn't a fatal error. Only
930 root-level things (joining/leaving domains etc.) will be denied. */
932 c->msg_ctx = messaging_init(c, procid_self(),
933 event_context_init(c));
935 rc = net_run_function(c, argc_new-1, argv_new+1, "net", net_func);
937 DEBUG(2,("return code = %d\n", rc));
939 gencache_stabilize();
941 libnetapi_free(c->netapi_ctx);