Start of merging changes with SAMBA_3_0. Fix up some comments so that
[Samba/gebeck_regimport.git] / source / utils / net.c
blobb9081c3e31c3825511d276de66f2ac46b7b67af4
1 /*
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
10 November 2001.
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 /*****************************************************/
29 /* */
30 /* Distributed SMB/CIFS Server Management Utility */
31 /* */
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 */
36 /* systems). */
37 /* */
38 /*****************************************************/
40 #include "includes.h"
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. */
46 /* */
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;
66 int opt_reboot = 0;
67 int opt_force = 0;
68 int opt_port = 0;
69 int opt_maxusers = -1;
70 const char *opt_comment = "";
71 const char *opt_container = "cn=Users";
72 int opt_flags = -1;
73 int opt_timeout = 0;
74 const char *opt_target_workgroup = NULL;
75 int opt_machine_pass = 0;
77 BOOL opt_have_ip = False;
78 struct in_addr opt_dest_ip;
80 extern BOOL AllowDebugChange;
82 uint32 get_sec_channel_type(const char *param)
84 if (!(param && *param)) {
85 return get_default_sec_channel();
86 } else {
87 if (strequal(param, "PDC")) {
88 return SEC_CHAN_BDC;
89 } else if (strequal(param, "BDC")) {
90 return SEC_CHAN_BDC;
91 } else if (strequal(param, "MEMBER")) {
92 return SEC_CHAN_WKSTA;
93 #if 0
94 } else if (strequal(param, "DOMAIN")) {
95 return SEC_CHAN_DOMAIN;
96 #endif
97 } else {
98 return get_default_sec_channel();
104 run a function from a function table. If not found then
105 call the specified usage function
107 int net_run_function(int argc, const char **argv, struct functable *table,
108 int (*usage_fn)(int argc, const char **argv))
110 int i;
112 if (argc < 1) {
113 d_printf("\nUsage: \n");
114 return usage_fn(argc, argv);
116 for (i=0; table[i].funcname; i++) {
117 if (StrCaseCmp(argv[0], table[i].funcname) == 0)
118 return table[i].fn(argc-1, argv+1);
120 d_printf("No command: %s\n", argv[0]);
121 return usage_fn(argc, argv);
125 /****************************************************************************
126 connect to \\server\ipc$
127 ****************************************************************************/
128 NTSTATUS connect_to_ipc(struct cli_state **c, struct in_addr *server_ip,
129 const char *server_name)
131 NTSTATUS nt_status;
133 if (!opt_password && !opt_machine_pass) {
134 char *pass = getpass("Password:");
135 if (pass) {
136 opt_password = strdup(pass);
140 nt_status = cli_full_connection(c, opt_requester_name, server_name,
141 server_ip, opt_port,
142 "IPC$", "IPC",
143 opt_user_name, opt_workgroup,
144 opt_password, 0, Undefined, NULL);
146 if (NT_STATUS_IS_OK(nt_status)) {
147 return nt_status;
148 } else {
149 DEBUG(1,("Cannot connect to server. Error was %s\n",
150 nt_errstr(nt_status)));
152 /* Display a nicer message depending on the result */
154 if (NT_STATUS_V(nt_status) ==
155 NT_STATUS_V(NT_STATUS_LOGON_FAILURE))
156 d_printf("The username or password was not correct.\n");
158 if (NT_STATUS_V(nt_status) ==
159 NT_STATUS_V(NT_STATUS_ACCOUNT_LOCKED_OUT))
160 d_printf("The account was locked out.\n");
162 if (NT_STATUS_V(nt_status) ==
163 NT_STATUS_V(NT_STATUS_ACCOUNT_DISABLED))
164 d_printf("The account was disabled.\n");
166 return nt_status;
170 /****************************************************************************
171 connect to \\server\ipc$ anonymously
172 ****************************************************************************/
173 NTSTATUS connect_to_ipc_anonymous(struct cli_state **c,
174 struct in_addr *server_ip, const char *server_name)
176 NTSTATUS nt_status;
178 nt_status = cli_full_connection(c, opt_requester_name, server_name,
179 server_ip, opt_port,
180 "IPC$", "IPC",
181 "", "",
182 "", 0, Undefined, NULL);
184 if (NT_STATUS_IS_OK(nt_status)) {
185 return nt_status;
186 } else {
187 DEBUG(1,("Cannot connect to server (anonymously). Error was %s\n", nt_errstr(nt_status)));
188 return nt_status;
192 /****************************************************************************
193 Use the local machine's password for this session
194 ****************************************************************************/
195 int net_use_machine_password(void)
197 char *user_name = NULL;
199 if (!secrets_init()) {
200 d_printf("ERROR: Unable to open secrets database\n");
201 exit(1);
204 user_name = NULL;
205 opt_password = secrets_fetch_machine_password(opt_target_workgroup, NULL, NULL);
206 if (asprintf(&user_name, "%s$@%s", global_myname(), lp_realm()) == -1) {
207 return -1;
209 opt_user_name = user_name;
210 return 0;
213 BOOL net_find_server(unsigned flags, struct in_addr *server_ip, char **server_name)
216 if (opt_host) {
217 *server_name = strdup(opt_host);
220 if (opt_have_ip) {
221 *server_ip = opt_dest_ip;
222 if (!*server_name) {
223 *server_name = strdup(inet_ntoa(opt_dest_ip));
225 } else if (*server_name) {
226 /* resolve the IP address */
227 if (!resolve_name(*server_name, server_ip, 0x20)) {
228 DEBUG(1,("Unable to resolve server name\n"));
229 return False;
231 } else if (flags & NET_FLAGS_PDC) {
232 struct in_addr pdc_ip;
234 if (get_pdc_ip(opt_target_workgroup, &pdc_ip)) {
235 fstring dc_name;
237 if (is_zero_ip(pdc_ip))
238 return False;
240 if ( !name_status_find(opt_target_workgroup, 0x1b, 0x20, pdc_ip, dc_name) )
241 return False;
243 *server_name = strdup(dc_name);
244 *server_ip = pdc_ip;
247 } else if (flags & NET_FLAGS_DMB) {
248 struct in_addr msbrow_ip;
249 /* if (!resolve_name(MSBROWSE, &msbrow_ip, 1)) */
250 if (!resolve_name(opt_target_workgroup, &msbrow_ip, 0x1B)) {
251 DEBUG(1,("Unable to resolve domain browser via name lookup\n"));
252 return False;
253 } else {
254 *server_ip = msbrow_ip;
256 *server_name = strdup(inet_ntoa(opt_dest_ip));
257 } else if (flags & NET_FLAGS_MASTER) {
258 struct in_addr brow_ips;
259 if (!resolve_name(opt_target_workgroup, &brow_ips, 0x1D)) {
260 /* go looking for workgroups */
261 DEBUG(1,("Unable to resolve master browser via name lookup\n"));
262 return False;
263 } else {
264 *server_ip = brow_ips;
266 *server_name = strdup(inet_ntoa(opt_dest_ip));
267 } else if (!(flags & NET_FLAGS_LOCALHOST_DEFAULT_INSANE)) {
268 extern struct in_addr loopback_ip;
269 *server_ip = loopback_ip;
270 *server_name = strdup("127.0.0.1");
273 if (!server_name || !*server_name) {
274 DEBUG(1,("no server to connect to\n"));
275 return False;
278 return True;
282 BOOL net_find_pdc(struct in_addr *server_ip, fstring server_name, const char *domain_name)
284 if (get_pdc_ip(domain_name, server_ip)) {
285 if (is_zero_ip(*server_ip))
286 return False;
288 if (!name_status_find(domain_name, 0x1b, 0x20, *server_ip, server_name))
289 return False;
291 return True;
293 else
294 return False;
298 struct cli_state *net_make_ipc_connection(unsigned flags)
300 char *server_name = NULL;
301 struct in_addr server_ip;
302 struct cli_state *cli = NULL;
303 NTSTATUS nt_status;
305 if (!net_find_server(flags, &server_ip, &server_name)) {
306 d_printf("\nUnable to find a suitable server\n");
307 return NULL;
310 if (flags & NET_FLAGS_ANONYMOUS) {
311 nt_status = connect_to_ipc_anonymous(&cli, &server_ip, server_name);
312 } else {
313 nt_status = connect_to_ipc(&cli, &server_ip, server_name);
316 SAFE_FREE(server_name);
317 if (NT_STATUS_IS_OK(nt_status)) {
318 return cli;
319 } else {
320 return NULL;
324 static int net_user(int argc, const char **argv)
326 if (net_ads_check() == 0)
327 return net_ads_user(argc, argv);
329 /* if server is not specified, default to PDC? */
330 if (net_rpc_check(NET_FLAGS_PDC))
331 return net_rpc_user(argc, argv);
333 return net_rap_user(argc, argv);
336 static int net_group(int argc, const char **argv)
338 if (net_ads_check() == 0)
339 return net_ads_group(argc, argv);
341 if (argc == 0 && net_rpc_check(NET_FLAGS_PDC))
342 return net_rpc_group(argc, argv);
344 return net_rap_group(argc, argv);
347 static int net_join(int argc, const char **argv)
349 if (net_ads_check() == 0) {
350 if (net_ads_join(argc, argv) == 0)
351 return 0;
352 else
353 d_printf("ADS join did not work, falling back to RPC...\n");
355 return net_rpc_join(argc, argv);
358 static int net_changetrustpw(int argc, const char **argv)
360 if (net_ads_check() == 0)
361 return net_ads_changetrustpw(argc, argv);
363 return net_rpc_changetrustpw(argc, argv);
366 static int net_changesecretpw(int argc, const char **argv)
368 char *trust_pw;
369 uint32 sec_channel_type = SEC_CHAN_WKSTA;
371 if(opt_force) {
372 trust_pw = getpass("Enter machine password: ");
374 if (!secrets_store_machine_password(trust_pw, lp_workgroup(), sec_channel_type)) {
375 d_printf("Unable to write the machine account password in the secrets database");
376 return 1;
378 else {
379 d_printf("Modified trust account password in secrets database\n");
382 else {
383 d_printf("Machine account password change requires the -f flag.\n");
384 d_printf("Do NOT use this function unless you know what it does!\n");
385 d_printf("This function will change the ADS Domain member machine account password in the secrets.tdb file!\n");
388 return 0;
391 static int net_share(int argc, const char **argv)
393 if (net_rpc_check(0))
394 return net_rpc_share(argc, argv);
395 return net_rap_share(argc, argv);
398 static int net_file(int argc, const char **argv)
400 if (net_rpc_check(0))
401 return net_rpc_file(argc, argv);
402 return net_rap_file(argc, argv);
406 Retrieve our local SID or the SID for the specified name
408 static int net_getlocalsid(int argc, const char **argv)
410 DOM_SID sid;
411 const char *name;
412 fstring sid_str;
414 if (argc >= 1) {
415 name = argv[0];
417 else {
418 name = global_myname();
421 if (!secrets_fetch_domain_sid(name, &sid)) {
422 DEBUG(0, ("Can't fetch domain SID for name: %s\n", name));
423 return 1;
425 sid_to_string(sid_str, &sid);
426 d_printf("SID for domain %s is: %s\n", name, sid_str);
427 return 0;
430 static int net_setlocalsid(int argc, const char **argv)
432 DOM_SID sid;
434 if ( (argc != 1)
435 || (strncmp(argv[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
436 || (!string_to_sid(&sid, argv[0]))
437 || (sid.num_auths != 4)) {
438 d_printf("usage: net setlocalsid S-1-5-21-x-y-z\n");
439 return 1;
442 if (!secrets_store_domain_sid(global_myname(), &sid)) {
443 DEBUG(0,("Can't store domain SID as a pdc/bdc.\n"));
444 return 1;
447 return 0;
450 static int net_getdomainsid(int argc, const char **argv)
452 DOM_SID domain_sid;
453 fstring sid_str;
455 if (!secrets_fetch_domain_sid(global_myname(), &domain_sid)) {
456 d_printf("Could not fetch local SID\n");
457 return 1;
459 sid_to_string(sid_str, &domain_sid);
460 d_printf("SID for domain %s is: %s\n", global_myname(), sid_str);
462 if (!secrets_fetch_domain_sid(opt_workgroup, &domain_sid)) {
463 d_printf("Could not fetch domain SID\n");
464 return 1;
467 sid_to_string(sid_str, &domain_sid);
468 d_printf("SID for domain %s is: %s\n", opt_workgroup, sid_str);
470 return 0;
473 #ifdef WITH_FAKE_KASERVER
475 int net_afskey_usage(int argc, const char **argv)
477 d_printf(" net afskey filename\n"
478 "\tImports a OpenAFS KeyFile into our secrets.tdb\n\n");
479 return -1;
482 static int net_afskey(int argc, const char **argv)
484 int fd;
485 struct afs_keyfile keyfile;
487 if (argc != 2) {
488 d_printf("usage: 'net afskey <keyfile> cell'\n");
489 return -1;
492 if (!secrets_init()) {
493 d_printf("Could not open secrets.tdb\n");
494 return -1;
497 if ((fd = open(argv[0], O_RDONLY, 0)) < 0) {
498 d_printf("Could not open %s\n", argv[0]);
499 return -1;
502 if (read(fd, &keyfile, sizeof(keyfile)) != sizeof(keyfile)) {
503 d_printf("Could not read keyfile\n");
504 return -1;
507 if (!secrets_store_afs_keyfile(argv[1], &keyfile)) {
508 d_printf("Could not write keyfile to secrets.tdb\n");
509 return -1;
512 return 0;
515 #endif /* WITH_FAKE_KASERVER */
517 static uint32 get_maxrid(void)
519 SAM_ACCOUNT *pwd = NULL;
520 uint32 max_rid = 0;
521 GROUP_MAP *map = NULL;
522 int num_entries = 0;
523 int i;
525 if (!pdb_setsampwent(False)) {
526 DEBUG(0, ("load_sampwd_entries: Unable to open passdb.\n"));
527 return 0;
530 for (; (NT_STATUS_IS_OK(pdb_init_sam(&pwd)))
531 && pdb_getsampwent(pwd) == True; pwd=NULL) {
532 uint32 rid;
534 if (!sid_peek_rid(pdb_get_user_sid(pwd), &rid)) {
535 DEBUG(0, ("can't get RID for user '%s'\n",
536 pdb_get_username(pwd)));
537 pdb_free_sam(&pwd);
538 continue;
541 if (rid > max_rid)
542 max_rid = rid;
544 DEBUG(1,("%d is user '%s'\n", rid, pdb_get_username(pwd)));
545 pdb_free_sam(&pwd);
548 pdb_endsampwent();
549 pdb_free_sam(&pwd);
551 if (!pdb_enum_group_mapping(SID_NAME_UNKNOWN, &map, &num_entries,
552 ENUM_ONLY_MAPPED))
553 return max_rid;
555 for (i = 0; i < num_entries; i++) {
556 uint32 rid;
558 if (!sid_peek_check_rid(get_global_sam_sid(), &map[i].sid,
559 &rid)) {
560 DEBUG(3, ("skipping map for group '%s', SID %s\n",
561 map[i].nt_name,
562 sid_string_static(&map[i].sid)));
563 continue;
565 DEBUG(1,("%d is group '%s'\n", rid, map[i].nt_name));
567 if (rid > max_rid)
568 max_rid = rid;
571 SAFE_FREE(map);
573 return max_rid;
576 static int net_maxrid(int argc, const char **argv)
578 uint32 rid;
580 if (argc != 0) {
581 DEBUG(0, ("usage: net maxrid\n"));
582 return 1;
585 if ((rid = get_maxrid()) == 0) {
586 DEBUG(0, ("can't get current maximum rid\n"));
587 return 1;
590 d_printf("Currently used maximum rid: %d\n", rid);
592 return 0;
595 /* main function table */
596 static struct functable net_func[] = {
597 {"RPC", net_rpc},
598 {"RAP", net_rap},
599 {"ADS", net_ads},
601 /* eventually these should auto-choose the transport ... */
602 {"FILE", net_file},
603 {"SHARE", net_share},
604 {"SESSION", net_rap_session},
605 {"SERVER", net_rap_server},
606 {"DOMAIN", net_rap_domain},
607 {"PRINTQ", net_rap_printq},
608 {"USER", net_user},
609 {"GROUP", net_group},
610 {"GROUPMAP", net_groupmap},
611 {"VALIDATE", net_rap_validate},
612 {"GROUPMEMBER", net_rap_groupmember},
613 {"ADMIN", net_rap_admin},
614 {"SERVICE", net_rap_service},
615 {"PASSWORD", net_rap_password},
616 {"CHANGETRUSTPW", net_changetrustpw},
617 {"CHANGESECRETPW", net_changesecretpw},
618 {"TIME", net_time},
619 {"LOOKUP", net_lookup},
620 {"JOIN", net_join},
621 {"CACHE", net_cache},
622 {"GETLOCALSID", net_getlocalsid},
623 {"SETLOCALSID", net_setlocalsid},
624 {"GETDOMAINSID", net_getdomainsid},
625 {"MAXRID", net_maxrid},
626 {"IDMAP", net_idmap},
627 {"STATUS", net_status},
628 #ifdef WITH_FAKE_KASERVER
629 {"AFSKEY", net_afskey},
630 #endif
632 {"HELP", net_help},
633 {NULL, NULL}
637 /****************************************************************************
638 main program
639 ****************************************************************************/
640 int main(int argc, const char **argv)
642 int opt,i;
643 char *p;
644 int rc = 0;
645 int argc_new = 0;
646 const char ** argv_new;
647 poptContext pc;
649 struct poptOption long_options[] = {
650 {"help", 'h', POPT_ARG_NONE, 0, 'h'},
651 {"workgroup", 'w', POPT_ARG_STRING, &opt_target_workgroup},
652 {"user", 'U', POPT_ARG_STRING, &opt_user_name, 'U'},
653 {"ipaddress", 'I', POPT_ARG_STRING, 0,'I'},
654 {"port", 'p', POPT_ARG_INT, &opt_port},
655 {"myname", 'n', POPT_ARG_STRING, &opt_requester_name},
656 {"server", 'S', POPT_ARG_STRING, &opt_host},
657 {"container", 'c', POPT_ARG_STRING, &opt_container},
658 {"comment", 'C', POPT_ARG_STRING, &opt_comment},
659 {"maxusers", 'M', POPT_ARG_INT, &opt_maxusers},
660 {"flags", 'F', POPT_ARG_INT, &opt_flags},
661 {"long", 'l', POPT_ARG_NONE, &opt_long_list_entries},
662 {"reboot", 'r', POPT_ARG_NONE, &opt_reboot},
663 {"force", 'f', POPT_ARG_NONE, &opt_force},
664 {"timeout", 't', POPT_ARG_INT, &opt_timeout},
665 {"machine-pass",'P', POPT_ARG_NONE, &opt_machine_pass},
666 {"myworkgroup", 'W', POPT_ARG_STRING, &opt_workgroup},
667 POPT_COMMON_SAMBA
668 { 0, 0, 0, 0}
671 zero_ip(&opt_dest_ip);
673 /* set default debug level to 0 regardless of what smb.conf sets */
674 DEBUGLEVEL_CLASS[DBGC_ALL] = 0;
675 dbf = x_stderr;
677 pc = poptGetContext(NULL, argc, (const char **) argv, long_options,
678 POPT_CONTEXT_KEEP_FIRST);
680 while((opt = poptGetNextOpt(pc)) != -1) {
681 switch (opt) {
682 case 'h':
683 net_help(argc, argv);
684 exit(0);
685 break;
686 case 'I':
687 opt_dest_ip = *interpret_addr2(poptGetOptArg(pc));
688 if (is_zero_ip(opt_dest_ip))
689 d_printf("\nInvalid ip address specified\n");
690 else
691 opt_have_ip = True;
692 break;
693 case 'U':
694 opt_user_specified = True;
695 opt_user_name = strdup(opt_user_name);
696 p = strchr(opt_user_name,'%');
697 if (p) {
698 *p = 0;
699 opt_password = p+1;
701 break;
702 default:
703 d_printf("\nInvalid option %s: %s\n",
704 poptBadOption(pc, 0), poptStrerror(opt));
705 net_help(argc, argv);
706 exit(1);
711 * Don't load debug level from smb.conf. It should be
712 * set by cmdline arg or remain default (0)
714 AllowDebugChange = False;
715 lp_load(dyn_CONFIGFILE,True,False,False);
717 argv_new = (const char **)poptGetArgs(pc);
719 argc_new = argc;
720 for (i=0; i<argc; i++) {
721 if (argv_new[i] == NULL) {
722 argc_new = i;
723 break;
727 if (!opt_requester_name) {
728 static fstring myname;
729 get_myname(myname);
730 opt_requester_name = myname;
733 if (!opt_user_name && getenv("LOGNAME")) {
734 opt_user_name = getenv("LOGNAME");
737 if (!opt_workgroup) {
738 opt_workgroup = smb_xstrdup(lp_workgroup());
741 if (!opt_target_workgroup) {
742 opt_target_workgroup = smb_xstrdup(lp_workgroup());
745 if (!init_names())
746 exit(1);
748 load_interfaces();
750 /* this makes sure that when we do things like call scripts,
751 that it won't assert becouse we are not root */
752 sec_init();
754 if (opt_machine_pass) {
755 /* it is very useful to be able to make ads queries as the
756 machine account for testing purposes and for domain leave */
758 net_use_machine_password();
761 if (!opt_password) {
762 opt_password = getenv("PASSWD");
765 rc = net_run_function(argc_new-1, argv_new+1, net_func, net_help);
767 DEBUG(2,("return code = %d\n", rc));
768 return rc;