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 /* Beginning of internationalization section. Translatable constants */
54 /* should be kept in this area and referenced in the rest of the code. */
56 /* No functions, outside of Samba or LSB (Linux Standards Base) should */
57 /* be used (if possible). */
58 /***********************************************************************/
60 #define YES_STRING "Yes"
61 #define NO_STRING "No"
63 /***********************************************************************/
64 /* end of internationalization section */
65 /***********************************************************************/
67 uint32
get_sec_channel_type(const char *param
)
69 if (!(param
&& *param
)) {
70 return get_default_sec_channel();
72 if (strequal(param
, "PDC")) {
74 } else if (strequal(param
, "BDC")) {
76 } else if (strequal(param
, "MEMBER")) {
77 return SEC_CHAN_WKSTA
;
79 } else if (strequal(param
, "DOMAIN")) {
80 return SEC_CHAN_DOMAIN
;
83 return get_default_sec_channel();
88 static int net_changetrustpw(struct net_context
*c
, int argc
, const char **argv
)
90 if (net_ads_check_our_domain(c
) == 0)
91 return net_ads_changetrustpw(c
, argc
, argv
);
93 return net_rpc_changetrustpw(c
, argc
, argv
);
96 static void set_line_buffering(FILE *f
)
98 setvbuf(f
, NULL
, _IOLBF
, 0);
101 static int net_changesecretpw(struct net_context
*c
, int argc
,
105 uint32 sec_channel_type
= SEC_CHAN_WKSTA
;
109 set_line_buffering(stdin
);
110 set_line_buffering(stdout
);
111 set_line_buffering(stderr
);
114 trust_pw
= get_pass("Enter machine password: ", c
->opt_stdin
);
116 if (!secrets_store_machine_password(trust_pw
, lp_workgroup(), sec_channel_type
)) {
117 d_fprintf(stderr
, "Unable to write the machine account password in the secrets database");
121 d_printf("Modified trust account password in secrets database\n");
125 d_printf("Machine account password change requires the -f flag.\n");
126 d_printf("Do NOT use this function unless you know what it does!\n");
127 d_printf("This function will change the ADS Domain member machine account password in the secrets.tdb file!\n");
134 Retrieve our local SID or the SID for the specified name
136 static int net_getlocalsid(struct net_context
*c
, int argc
, const char **argv
)
146 name
= global_myname();
149 if(!initialize_password_db(false, NULL
)) {
150 DEBUG(0, ("WARNING: Could not open passdb - local sid may not reflect passdb\n"
151 "backend knowledge (such as the sid stored in LDAP)\n"));
154 /* first check to see if we can even access secrets, so we don't
155 panic when we can't. */
157 if (!secrets_init()) {
158 d_fprintf(stderr
, "Unable to open secrets.tdb. Can't fetch domain SID for name: %s\n", name
);
162 /* Generate one, if it doesn't exist */
163 get_global_sam_sid();
165 if (!secrets_fetch_domain_sid(name
, &sid
)) {
166 DEBUG(0, ("Can't fetch domain SID for name: %s\n", name
));
169 sid_to_fstring(sid_str
, &sid
);
170 d_printf("SID for domain %s is: %s\n", name
, sid_str
);
174 static int net_setlocalsid(struct net_context
*c
, int argc
, const char **argv
)
179 || (strncmp(argv
[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
180 || (!string_to_sid(&sid
, argv
[0]))
181 || (sid
.num_auths
!= 4)) {
182 d_printf("usage: net setlocalsid S-1-5-21-x-y-z\n");
186 if (!secrets_store_domain_sid(global_myname(), &sid
)) {
187 DEBUG(0,("Can't store domain SID as a pdc/bdc.\n"));
194 static int net_setdomainsid(struct net_context
*c
, int argc
, const char **argv
)
199 || (strncmp(argv
[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
200 || (!string_to_sid(&sid
, argv
[0]))
201 || (sid
.num_auths
!= 4)) {
202 d_printf("usage: net setdomainsid S-1-5-21-x-y-z\n");
206 if (!secrets_store_domain_sid(lp_workgroup(), &sid
)) {
207 DEBUG(0,("Can't store domain SID.\n"));
214 static int net_getdomainsid(struct net_context
*c
, int argc
, const char **argv
)
220 d_printf("usage: net getdomainsid\n");
224 if(!initialize_password_db(false, NULL
)) {
225 DEBUG(0, ("WARNING: Could not open passdb - domain SID may "
226 "not reflect passdb\n"
227 "backend knowledge (such as the SID stored in "
231 /* first check to see if we can even access secrets, so we don't
232 panic when we can't. */
234 if (!secrets_init()) {
235 d_fprintf(stderr
, "Unable to open secrets.tdb. Can't fetch domain"
236 "SID for name: %s\n", get_global_sam_name());
240 /* Generate one, if it doesn't exist */
241 get_global_sam_sid();
243 if (!secrets_fetch_domain_sid(global_myname(), &domain_sid
)) {
244 d_fprintf(stderr
, "Could not fetch local SID\n");
247 sid_to_fstring(sid_str
, &domain_sid
);
248 d_printf("SID for local machine %s is: %s\n", global_myname(), sid_str
);
250 if (!secrets_fetch_domain_sid(c
->opt_workgroup
, &domain_sid
)) {
251 d_fprintf(stderr
, "Could not fetch domain SID\n");
255 sid_to_fstring(sid_str
, &domain_sid
);
256 d_printf("SID for domain %s is: %s\n", c
->opt_workgroup
, sid_str
);
261 static bool search_maxrid(struct pdb_search
*search
, const char *type
,
264 struct samr_displayentry
*entries
;
265 uint32 i
, num_entries
;
267 if (search
== NULL
) {
268 d_fprintf(stderr
, "get_maxrid: Could not search %s\n", type
);
272 num_entries
= pdb_search_entries(search
, 0, 0xffffffff, &entries
);
273 for (i
=0; i
<num_entries
; i
++)
274 *max_rid
= MAX(*max_rid
, entries
[i
].rid
);
275 pdb_search_destroy(search
);
279 static uint32
get_maxrid(void)
283 if (!search_maxrid(pdb_search_users(0), "users", &max_rid
))
286 if (!search_maxrid(pdb_search_groups(), "groups", &max_rid
))
289 if (!search_maxrid(pdb_search_aliases(get_global_sam_sid()),
290 "aliases", &max_rid
))
296 static int net_maxrid(struct net_context
*c
, int argc
, const char **argv
)
301 DEBUG(0, ("usage: net maxrid\n"));
305 if ((rid
= get_maxrid()) == 0) {
306 DEBUG(0, ("can't get current maximum rid\n"));
310 d_printf("Currently used maximum rid: %d\n", rid
);
315 /* main function table */
316 static struct functable net_func
[] = {
321 "Run functions using RPC transport",
322 " Use 'net help rpc' to get more extensive information about "
323 "'net rpc' commands."
329 "Run functions using RAP transport",
330 " Use 'net help rap' to get more extensive information about "
331 "'net rap' commands."
337 "Run functions using ADS transport",
338 " Use 'net help ads' to get more extensive information about "
339 "'net ads' commands."
342 /* eventually these should auto-choose the transport ... */
346 NET_TRANSPORT_RPC
| NET_TRANSPORT_RAP
,
347 "Functions on remote opened files",
348 " Use 'net help file' to get more information about 'net "
354 NET_TRANSPORT_RPC
| NET_TRANSPORT_RAP
,
355 "Functions on shares",
356 " Use 'net help share' to get more information about 'net "
364 " Use 'net help session' to get more information about 'net "
371 "List servers in workgroup",
372 " Use 'net help server' to get more information about 'net "
379 "List domains/workgroups on network",
380 " Use 'net help domain' to get more information about 'net "
387 "Modify printer queue",
388 " Use 'net help printq' to get more information about 'net "
394 NET_TRANSPORT_ADS
| NET_TRANSPORT_RPC
| NET_TRANSPORT_RAP
,
396 " Use 'net help user' to get more information about 'net "
402 NET_TRANSPORT_ADS
| NET_TRANSPORT_RPC
| NET_TRANSPORT_RAP
,
404 " Use 'net help group' to get more information about 'net "
411 "Manage group mappings",
412 " Use 'net help groupmap' to get more information about 'net "
413 "groupmap' commands."
419 "Functions on the SAM database",
420 " Use 'net help sam' to get more information about 'net sam' "
427 "Validate username and password",
428 " Use 'net help validate' to get more information about 'net "
429 "validate' commands."
435 "Modify group memberships",
436 " Use 'net help groupmember' to get more information about "
437 "'net groupmember' commands."
442 "Execute remote command on a remote OS/2 server",
443 " Use 'net help admin' to get more information about 'net "
449 "List/modify running services",
450 " Use 'net help service' to get more information about 'net "
457 "Change user password on target server",
458 " Use 'net help password' to get more information about 'net "
459 "password' commands."
463 NET_TRANSPORT_ADS
| NET_TRANSPORT_RPC
,
464 "Change the trust password",
465 " Use 'net help changetrustpw' to get more information about "
466 "'net changetrustpw'."
471 "Change the secret password",
472 " net [options] changesecretpw\n"
473 " Change the ADS domain member machine account password in "
475 " Do NOT use this function unless you know what it does.\n"
476 " Requires the -f flag to work."
482 " Use 'net help time' to get more information about 'net "
488 "Look up host names/IP addresses",
489 " Use 'net help lookup' to get more information about 'net "
494 NET_TRANSPORT_ADS
| NET_TRANSPORT_RPC
,
496 " Use 'net help join' to get more information about 'net "
502 "Join/unjoin (remote) machines to/from a domain/AD",
503 " Use 'net help dom' to get more information about 'net dom' "
509 "Operate on the cache tdb file",
510 " Use 'net help cache' to get more information about 'net "
516 "Get the SID for the local domain",
522 "Set the SID for the local domain",
523 " net setlocalsid S-1-5-21-x-y-z"
528 "Set domain SID on member servers",
529 " net setdomainsid S-1-5-21-x-y-z"
534 "Get domain SID on member servers",
540 "Display the maximul RID currently used",
547 " Use 'net help idmap to get more information about 'net "
553 "Display server status",
554 " Use 'net help status' to get more information about 'net "
560 "Manage user-modifiable shares",
561 " Use 'net help usershare to get more information about 'net "
562 "usershare' commands."
567 "Display list of all users with SID",
568 " Use 'net help usersidlist' to get more information about "
574 "Manage Samba registry based configuration",
575 " Use 'net help conf' to get more information about 'net "
581 "Manage the Samba registry",
582 " Use 'net help registry' to get more information about 'net "
583 "registry' commands."
588 "Open a lua interpreter",
589 " Use 'net help lua' to get more information about 'net "
592 #ifdef WITH_FAKE_KASERVER
597 " Use 'net help afs' to get more information about 'net afs' "
605 "Print usage information",
606 " Use 'net help help' to list usage information for 'net' "
609 {NULL
, NULL
, 0, NULL
, NULL
}
613 /****************************************************************************
615 ****************************************************************************/
616 int main(int argc
, const char **argv
)
622 const char ** argv_new
;
624 TALLOC_CTX
*frame
= talloc_stackframe();
625 struct net_context
*c
= talloc_zero(frame
, struct net_context
);
627 struct poptOption long_options
[] = {
628 {"help", 'h', POPT_ARG_NONE
, 0, 'h'},
629 {"workgroup", 'w', POPT_ARG_STRING
, &c
->opt_target_workgroup
},
630 {"user", 'U', POPT_ARG_STRING
, &c
->opt_user_name
, 'U'},
631 {"ipaddress", 'I', POPT_ARG_STRING
, 0,'I'},
632 {"port", 'p', POPT_ARG_INT
, &c
->opt_port
},
633 {"myname", 'n', POPT_ARG_STRING
, &c
->opt_requester_name
},
634 {"server", 'S', POPT_ARG_STRING
, &c
->opt_host
},
635 {"encrypt", 'e', POPT_ARG_NONE
, NULL
, 'e', "Encrypt SMB transport (UNIX extended servers only)" },
636 {"container", 'c', POPT_ARG_STRING
, &c
->opt_container
},
637 {"comment", 'C', POPT_ARG_STRING
, &c
->opt_comment
},
638 {"maxusers", 'M', POPT_ARG_INT
, &c
->opt_maxusers
},
639 {"flags", 'F', POPT_ARG_INT
, &c
->opt_flags
},
640 {"long", 'l', POPT_ARG_NONE
, &c
->opt_long_list_entries
},
641 {"reboot", 'r', POPT_ARG_NONE
, &c
->opt_reboot
},
642 {"force", 'f', POPT_ARG_NONE
, &c
->opt_force
},
643 {"stdin", 'i', POPT_ARG_NONE
, &c
->opt_stdin
},
644 {"timeout", 't', POPT_ARG_INT
, &c
->opt_timeout
},
645 {"machine-pass",'P', POPT_ARG_NONE
, &c
->opt_machine_pass
},
646 {"kerberos", 'k', POPT_ARG_NONE
, &c
->opt_kerberos
},
647 {"myworkgroup", 'W', POPT_ARG_STRING
, &c
->opt_workgroup
},
648 {"verbose", 'v', POPT_ARG_NONE
, &c
->opt_verbose
},
649 {"test", 'T', POPT_ARG_NONE
, &c
->opt_testmode
},
650 /* Options for 'net groupmap set' */
651 {"local", 'L', POPT_ARG_NONE
, &c
->opt_localgroup
},
652 {"domain", 'D', POPT_ARG_NONE
, &c
->opt_domaingroup
},
653 {"ntname", 'N', POPT_ARG_STRING
, &c
->opt_newntname
},
654 {"rid", 'R', POPT_ARG_INT
, &c
->opt_rid
},
655 /* Options for 'net rpc share migrate' */
656 {"acls", 0, POPT_ARG_NONE
, &c
->opt_acls
},
657 {"attrs", 0, POPT_ARG_NONE
, &c
->opt_attrs
},
658 {"timestamps", 0, POPT_ARG_NONE
, &c
->opt_timestamps
},
659 {"exclude", 'X', POPT_ARG_STRING
, &c
->opt_exclude
},
660 {"destination", 0, POPT_ARG_STRING
, &c
->opt_destination
},
661 {"tallocreport", 0, POPT_ARG_NONE
, &c
->do_talloc_report
},
662 /* Options for 'net rpc vampire (keytab)' */
663 {"force-full-repl", 0, POPT_ARG_NONE
, &c
->opt_force_full_repl
},
664 {"single-obj-repl", 0, POPT_ARG_NONE
, &c
->opt_single_obj_repl
},
665 {"clean-old-entries", 0, POPT_ARG_NONE
, &c
->opt_clean_old_entries
},
672 zero_sockaddr(&c
->opt_dest_ip
);
676 /* set default debug level to 0 regardless of what smb.conf sets */
677 DEBUGLEVEL_CLASS
[DBGC_ALL
] = 0;
679 c
->private_data
= net_func
;
681 pc
= poptGetContext(NULL
, argc
, (const char **) argv
, long_options
,
682 POPT_CONTEXT_KEEP_FIRST
);
684 while((opt
= poptGetNextOpt(pc
)) != -1) {
687 c
->display_usage
= true;
690 c
->smb_encrypt
= true;
693 if (!interpret_string_addr(&c
->opt_dest_ip
,
694 poptGetOptArg(pc
), 0)) {
695 d_fprintf(stderr
, "\nInvalid ip address specified\n");
697 c
->opt_have_ip
= true;
701 c
->opt_user_specified
= true;
702 c
->opt_user_name
= SMB_STRDUP(c
->opt_user_name
);
703 p
= strchr(c
->opt_user_name
,'%');
706 c
->opt_password
= p
+1;
710 d_fprintf(stderr
, "\nInvalid option %s: %s\n",
711 poptBadOption(pc
, 0), poptStrerror(opt
));
712 net_help(c
, argc
, argv
);
718 * Don't load debug level from smb.conf. It should be
719 * set by cmdline arg or remain default (0)
721 AllowDebugChange
= false;
722 lp_load(get_dyn_CONFIGFILE(), true, false, false, true);
724 argv_new
= (const char **)poptGetArgs(pc
);
727 for (i
=0; i
<argc
; i
++) {
728 if (argv_new
[i
] == NULL
) {
734 if (c
->do_talloc_report
) {
735 talloc_enable_leak_report();
738 if (c
->opt_requester_name
) {
739 set_global_myname(c
->opt_requester_name
);
742 if (!c
->opt_user_name
&& getenv("LOGNAME")) {
743 c
->opt_user_name
= getenv("LOGNAME");
746 if (!c
->opt_workgroup
) {
747 c
->opt_workgroup
= smb_xstrdup(lp_workgroup());
750 if (!c
->opt_target_workgroup
) {
751 c
->opt_target_workgroup
= smb_xstrdup(lp_workgroup());
759 /* this makes sure that when we do things like call scripts,
760 that it won't assert becouse we are not root */
763 if (c
->opt_machine_pass
) {
764 /* it is very useful to be able to make ads queries as the
765 machine account for testing purposes and for domain leave */
767 net_use_krb_machine_account(c
);
770 if (!c
->opt_password
) {
771 c
->opt_password
= getenv("PASSWD");
774 rc
= net_run_function(c
, argc_new
-1, argv_new
+1, "net", net_func
);
776 DEBUG(2,("return code = %d\n", rc
));
778 libnetapi_free(c
->netapi_ctx
);