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)
9 Originally written by Steve and Jim. Largely rewritten by tridge in
12 Reworked again by abartlet in December 2001
14 This program is free software; you can redistribute it and/or modify
15 it under the terms of the GNU General Public License as published by
16 the Free Software Foundation; either version 2 of the License, or
17 (at your option) any later version.
19 This program is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 GNU General Public License for more details.
24 You should have received a copy of the GNU General Public License
25 along with this program; if not, write to the Free Software
26 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
28 /*****************************************************/
30 /* Distributed SMB/CIFS Server Management Utility */
32 /* The intent was to make the syntax similar */
33 /* to the NET utility (first developed in DOS */
34 /* with additional interesting & useful functions */
35 /* added in later SMB server network operating */
38 /*****************************************************/
41 #include "../utils/net.h"
43 /***********************************************************************/
44 /* Beginning of internationalization section. Translatable constants */
45 /* should be kept in this area and referenced in the rest of the code. */
47 /* No functions, outside of Samba or LSB (Linux Standards Base) should */
48 /* be used (if possible). */
49 /***********************************************************************/
51 #define YES_STRING "Yes"
52 #define NO_STRING "No"
54 /************************************************************************************/
55 /* end of internationalization section */
56 /************************************************************************************/
58 /* Yes, these buggers are globals.... */
59 const char *opt_requester_name = NULL;
60 const char *opt_host = NULL;
61 const char *opt_password = NULL;
62 const char *opt_user_name = NULL;
63 BOOL opt_user_specified = False;
64 const char *opt_workgroup = NULL;
65 int opt_long_list_entries = 0;
69 int opt_maxusers = -1;
70 const char *opt_comment = "";
71 const char *opt_container = "cn=Users";
74 const char *opt_target_workgroup = NULL;
75 static int opt_machine_pass = 0;
77 BOOL opt_have_ip = False;
78 struct in_addr opt_dest_ip;
80 extern BOOL AllowDebugChange;
82 /**************************************************************************************************/
83 /* Utility function to prompt for password from stdin. Password entered must end with a newline. */
84 /**************************************************************************************************/
85 static char *stdin_new_passwd(void)
87 static fstring new_pw;
93 * if no error is reported from fgets() and string at least contains
94 * the newline that ends the password, then replace the newline with
97 if ( fgets(new_pw, sizeof(new_pw), stdin) != NULL) {
98 if ((len = strlen(new_pw)) > 0) {
99 if(new_pw[len-1] == '\n')
106 uint32 get_sec_channel_type(const char *param)
108 if (!(param && *param)) {
109 return get_default_sec_channel();
111 if (strcasecmp(param, "PDC")==0) {
113 } else if (strcasecmp(param, "BDC")==0) {
115 } else if (strcasecmp(param, "MEMBER")==0) {
116 return SEC_CHAN_WKSTA;
118 } else if (strcasecmp(param, "DOMAIN")==0) {
119 return SEC_CHAN_DOMAIN;
122 return get_default_sec_channel();
128 run a function from a function table. If not found then
129 call the specified usage function
131 int net_run_function(int argc, const char **argv, struct functable *table,
132 int (*usage_fn)(int argc, const char **argv))
137 d_printf("\nUsage: \n");
138 return usage_fn(argc, argv);
140 for (i=0; table[i].funcname; i++) {
141 if (StrCaseCmp(argv[0], table[i].funcname) == 0)
142 return table[i].fn(argc-1, argv+1);
144 d_printf("No command: %s\n", argv[0]);
145 return usage_fn(argc, argv);
149 /****************************************************************************
150 connect to \\server\ipc$
151 ****************************************************************************/
152 NTSTATUS connect_to_ipc(struct cli_state **c, struct in_addr *server_ip,
153 const char *server_name)
158 char *pass = getpass("Password:");
160 opt_password = strdup(pass);
164 nt_status = cli_full_connection(c, opt_requester_name, server_name,
167 opt_user_name, opt_workgroup,
168 opt_password, 0, Undefined, NULL);
170 if (NT_STATUS_IS_OK(nt_status)) {
173 DEBUG(1,("Cannot connect to server. Error was %s\n",
174 nt_errstr(nt_status)));
176 /* Display a nicer message depending on the result */
178 if (NT_STATUS_V(nt_status) ==
179 NT_STATUS_V(NT_STATUS_LOGON_FAILURE))
180 d_printf("The username or password was not correct.\n");
186 /****************************************************************************
187 connect to \\server\ipc$ anonymously
188 ****************************************************************************/
189 NTSTATUS connect_to_ipc_anonymous(struct cli_state **c,
190 struct in_addr *server_ip, const char *server_name)
194 nt_status = cli_full_connection(c, opt_requester_name, server_name,
198 "", 0, Undefined, NULL);
200 if (NT_STATUS_IS_OK(nt_status)) {
203 DEBUG(1,("Cannot connect to server (anonymously). Error was %s\n", nt_errstr(nt_status)));
208 /****************************************************************************
209 Use the local machine's password for this session
210 ****************************************************************************/
211 int net_use_machine_password(void)
213 char *user_name = NULL;
215 if (!secrets_init()) {
216 d_printf("ERROR: Unable to open secrets database\n");
221 opt_password = secrets_fetch_machine_password(opt_target_workgroup, NULL, NULL);
222 if (asprintf(&user_name, "%s$@%s", global_myname(), lp_realm()) == -1) {
225 opt_user_name = user_name;
229 BOOL net_find_server(unsigned flags, struct in_addr *server_ip, char **server_name)
233 *server_name = strdup(opt_host);
237 *server_ip = opt_dest_ip;
239 *server_name = strdup(inet_ntoa(opt_dest_ip));
241 } else if (*server_name) {
242 /* resolve the IP address */
243 if (!resolve_name(*server_name, server_ip, 0x20)) {
244 DEBUG(1,("Unable to resolve server name\n"));
247 } else if (flags & NET_FLAGS_PDC) {
248 struct in_addr pdc_ip;
250 if (get_pdc_ip(opt_target_workgroup, &pdc_ip)) {
253 if (is_zero_ip(pdc_ip))
256 if ( !name_status_find(opt_target_workgroup, 0x1b, 0x20, pdc_ip, dc_name) )
259 *server_name = strdup(dc_name);
263 } else if (flags & NET_FLAGS_DMB) {
264 struct in_addr msbrow_ip;
265 /* if (!resolve_name(MSBROWSE, &msbrow_ip, 1)) */
266 if (!resolve_name(opt_target_workgroup, &msbrow_ip, 0x1B)) {
267 DEBUG(1,("Unable to resolve domain browser via name lookup\n"));
270 *server_ip = msbrow_ip;
272 *server_name = strdup(inet_ntoa(opt_dest_ip));
273 } else if (flags & NET_FLAGS_MASTER) {
274 struct in_addr brow_ips;
275 if (!resolve_name(opt_target_workgroup, &brow_ips, 0x1D)) {
276 /* go looking for workgroups */
277 DEBUG(1,("Unable to resolve master browser via name lookup\n"));
280 *server_ip = brow_ips;
282 *server_name = strdup(inet_ntoa(opt_dest_ip));
283 } else if (!(flags & NET_FLAGS_LOCALHOST_DEFAULT_INSANE)) {
284 extern struct in_addr loopback_ip;
285 *server_ip = loopback_ip;
286 *server_name = strdup("127.0.0.1");
289 if (!server_name || !*server_name) {
290 DEBUG(1,("no server to connect to\n"));
298 BOOL net_find_pdc(struct in_addr *server_ip, fstring server_name, const char *domain_name)
300 if (get_pdc_ip(domain_name, server_ip)) {
301 if (is_zero_ip(*server_ip))
304 if (!name_status_find(domain_name, 0x1b, 0x20, *server_ip, server_name))
314 struct cli_state *net_make_ipc_connection(unsigned flags)
316 char *server_name = NULL;
317 struct in_addr server_ip;
318 struct cli_state *cli = NULL;
321 if (!net_find_server(flags, &server_ip, &server_name)) {
322 d_printf("\nUnable to find a suitable server\n");
326 if (flags & NET_FLAGS_ANONYMOUS) {
327 nt_status = connect_to_ipc_anonymous(&cli, &server_ip, server_name);
329 nt_status = connect_to_ipc(&cli, &server_ip, server_name);
332 SAFE_FREE(server_name);
333 if (NT_STATUS_IS_OK(nt_status)) {
340 static int net_user(int argc, const char **argv)
342 if (net_ads_check() == 0)
343 return net_ads_user(argc, argv);
345 /* if server is not specified, default to PDC? */
346 if (net_rpc_check(NET_FLAGS_PDC))
347 return net_rpc_user(argc, argv);
349 return net_rap_user(argc, argv);
352 static int net_group(int argc, const char **argv)
354 if (net_ads_check() == 0)
355 return net_ads_group(argc, argv);
357 if (argc == 0 && net_rpc_check(NET_FLAGS_PDC))
358 return net_rpc_group(argc, argv);
360 return net_rap_group(argc, argv);
363 static int net_join(int argc, const char **argv)
365 if (net_ads_check() == 0) {
366 if (net_ads_join(argc, argv) == 0)
369 d_printf("ADS join did not work, falling back to RPC...\n");
371 return net_rpc_join(argc, argv);
374 static int net_changetrustpw(int argc, const char **argv)
376 if (net_ads_check() == 0)
377 return net_ads_changetrustpw(argc, argv);
379 return net_rpc_changetrustpw(argc, argv);
382 static int net_changesecretpw(int argc, const char **argv)
385 char trust_pw_hash[16];
386 uint32 sec_channel_type = SEC_CHAN_WKSTA;
390 trust_pw = getpass("Enter machine password: ");
392 if (!secrets_store_machine_password(trust_pw, lp_workgroup(), sec_channel_type)) {
393 d_printf("Unable to write the machine account password in the secrets database");
397 d_printf("Modified trust account password in secrets database\n");
401 d_printf("Machine account password change requires the -f flag.\n");
402 d_printf("Do NOT use this function unless you know what it does!\n");
403 d_printf("This function will change the ADS Domain member machine account password in the secrets.tdb file!\n");
409 static int net_share(int argc, const char **argv)
411 if (net_rpc_check(0))
412 return net_rpc_share(argc, argv);
413 return net_rap_share(argc, argv);
416 static int net_file(int argc, const char **argv)
418 if (net_rpc_check(0))
419 return net_rpc_file(argc, argv);
420 return net_rap_file(argc, argv);
424 Retrieve our local SID or the SID for the specified name
426 static int net_getlocalsid(int argc, const char **argv)
436 name = global_myname();
439 if (!secrets_fetch_domain_sid(name, &sid)) {
440 DEBUG(0, ("Can't fetch domain SID for name: %s\n", name));
443 sid_to_string(sid_str, &sid);
444 d_printf("SID for domain %s is: %s\n", name, sid_str);
448 static int net_setlocalsid(int argc, const char **argv)
453 || (strncmp(argv[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
454 || (!string_to_sid(&sid, argv[0]))
455 || (sid.num_auths != 4)) {
456 d_printf("usage: net setlocalsid S-1-5-21-x-y-z\n");
460 if (!secrets_store_domain_sid(global_myname(), &sid)) {
461 DEBUG(0,("Can't store domain SID as a pdc/bdc.\n"));
468 static int net_getdomainsid(int argc, const char **argv)
473 if (!secrets_fetch_domain_sid(global_myname(), &domain_sid)) {
474 d_printf("Could not fetch local SID\n");
477 sid_to_string(sid_str, &domain_sid);
478 d_printf("SID for domain %s is: %s\n", global_myname(), sid_str);
480 if (!secrets_fetch_domain_sid(opt_workgroup, &domain_sid)) {
481 d_printf("Could not fetch domain SID\n");
485 sid_to_string(sid_str, &domain_sid);
486 d_printf("SID for domain %s is: %s\n", opt_workgroup, sid_str);
491 static uint32 get_maxrid(void)
493 SAM_ACCOUNT *pwd = NULL;
495 GROUP_MAP *map = NULL;
499 if (!pdb_setsampwent(False)) {
500 DEBUG(0, ("load_sampwd_entries: Unable to open passdb.\n"));
504 for (; (NT_STATUS_IS_OK(pdb_init_sam(&pwd)))
505 && pdb_getsampwent(pwd) == True; pwd=NULL) {
508 if (!sid_peek_rid(pdb_get_user_sid(pwd), &rid)) {
509 DEBUG(0, ("can't get RID for user '%s'\n",
510 pdb_get_username(pwd)));
518 DEBUG(1,("%d is user '%s'\n", rid, pdb_get_username(pwd)));
525 if (!pdb_enum_group_mapping(SID_NAME_UNKNOWN, &map, &num_entries,
529 for (i = 0; i < num_entries; i++) {
532 if (!sid_peek_check_rid(get_global_sam_sid(), &map[i].sid,
534 DEBUG(3, ("skipping map for group '%s', SID %s\n",
536 sid_string_static(&map[i].sid)));
539 DEBUG(1,("%d is group '%s'\n", rid, map[i].nt_name));
550 static int net_maxrid(int argc, const char **argv)
555 DEBUG(0, ("usage: net maxrid\n"));
559 if ((rid = get_maxrid()) == 0) {
560 DEBUG(0, ("can't get current maximum rid\n"));
564 d_printf("Currently used maximum rid: %d\n", rid);
569 /* main function table */
570 static struct functable net_func[] = {
575 /* eventually these should auto-choose the transport ... */
577 {"SHARE", net_share},
578 {"SESSION", net_rap_session},
579 {"SERVER", net_rap_server},
580 {"DOMAIN", net_rap_domain},
581 {"PRINTQ", net_rap_printq},
583 {"GROUP", net_group},
584 {"GROUPMAP", net_groupmap},
585 {"VALIDATE", net_rap_validate},
586 {"GROUPMEMBER", net_rap_groupmember},
587 {"ADMIN", net_rap_admin},
588 {"SERVICE", net_rap_service},
589 {"PASSWORD", net_rap_password},
590 {"CHANGETRUSTPW", net_changetrustpw},
591 {"CHANGESECRETPW", net_changesecretpw},
593 {"LOOKUP", net_lookup},
595 {"CACHE", net_cache},
596 {"GETLOCALSID", net_getlocalsid},
597 {"SETLOCALSID", net_setlocalsid},
598 {"GETDOMAINSID", net_getdomainsid},
599 {"MAXRID", net_maxrid},
600 {"IDMAP", net_idmap},
607 /****************************************************************************
609 ****************************************************************************/
610 int main(int argc, const char **argv)
616 const char ** argv_new;
619 struct poptOption long_options[] = {
620 {"help", 'h', POPT_ARG_NONE, 0, 'h'},
621 {"workgroup", 'w', POPT_ARG_STRING, &opt_target_workgroup},
622 {"user", 'U', POPT_ARG_STRING, &opt_user_name, 'U'},
623 {"ipaddress", 'I', POPT_ARG_STRING, 0,'I'},
624 {"port", 'p', POPT_ARG_INT, &opt_port},
625 {"myname", 'n', POPT_ARG_STRING, &opt_requester_name},
626 {"server", 'S', POPT_ARG_STRING, &opt_host},
627 {"container", 'c', POPT_ARG_STRING, &opt_container},
628 {"comment", 'C', POPT_ARG_STRING, &opt_comment},
629 {"maxusers", 'M', POPT_ARG_INT, &opt_maxusers},
630 {"flags", 'F', POPT_ARG_INT, &opt_flags},
631 {"long", 'l', POPT_ARG_NONE, &opt_long_list_entries},
632 {"reboot", 'r', POPT_ARG_NONE, &opt_reboot},
633 {"force", 'f', POPT_ARG_NONE, &opt_force},
634 {"timeout", 't', POPT_ARG_INT, &opt_timeout},
635 {"machine-pass",'P', POPT_ARG_NONE, &opt_machine_pass},
636 {"myworkgroup", 'W', POPT_ARG_STRING, &opt_workgroup},
641 zero_ip(&opt_dest_ip);
643 /* set default debug level to 0 regardless of what smb.conf sets */
644 DEBUGLEVEL_CLASS[DBGC_ALL] = 0;
647 pc = poptGetContext(NULL, argc, (const char **) argv, long_options,
648 POPT_CONTEXT_KEEP_FIRST);
650 while((opt = poptGetNextOpt(pc)) != -1) {
653 net_help(argc, argv);
657 opt_dest_ip = *interpret_addr2(poptGetOptArg(pc));
658 if (is_zero_ip(opt_dest_ip))
659 d_printf("\nInvalid ip address specified\n");
664 opt_user_specified = True;
665 opt_user_name = strdup(opt_user_name);
666 p = strchr(opt_user_name,'%');
673 d_printf("\nInvalid option %s: %s\n",
674 poptBadOption(pc, 0), poptStrerror(opt));
675 net_help(argc, argv);
681 * Don't load debug level from smb.conf. It should be
682 * set by cmdline arg or remain default (0)
684 AllowDebugChange = False;
685 lp_load(dyn_CONFIGFILE,True,False,False);
687 argv_new = (const char **)poptGetArgs(pc);
690 for (i=0; i<argc; i++) {
691 if (argv_new[i] == NULL) {
697 if (!opt_requester_name) {
698 static fstring myname;
700 opt_requester_name = myname;
703 if (!opt_user_name && getenv("LOGNAME")) {
704 opt_user_name = getenv("LOGNAME");
707 if (!opt_workgroup) {
708 opt_workgroup = smb_xstrdup(lp_workgroup());
711 if (!opt_target_workgroup) {
712 opt_target_workgroup = smb_xstrdup(lp_workgroup());
720 /* this makes sure that when we do things like call scripts,
721 that it won't assert becouse we are not root */
724 if (opt_machine_pass) {
725 /* it is very useful to be able to make ads queries as the
726 machine account for testing purposes and for domain leave */
728 net_use_machine_password();
732 opt_password = getenv("PASSWD");
735 rc = net_run_function(argc_new-1, argv_new+1, net_func, net_help);
737 DEBUG(2,("return code = %d\n", rc));