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;
70 int opt_maxusers = -1;
71 const char *opt_comment = "";
72 const char *opt_container = NULL;
75 const char *opt_target_workgroup = NULL;
76 int opt_machine_pass = 0;
77 BOOL opt_localgroup = False;
78 BOOL opt_domaingroup = False;
79 const char *opt_newntname = "";
83 int opt_timestamps = 0;
84 const char *opt_exclude = NULL;
85 const char *opt_destination = NULL;
87 BOOL opt_have_ip = False;
88 struct in_addr opt_dest_ip;
90 extern struct in_addr loopback_ip;
91 extern BOOL AllowDebugChange;
93 uint32 get_sec_channel_type(const char *param)
95 if (!(param && *param)) {
96 return get_default_sec_channel();
98 if (strequal(param, "PDC")) {
100 } else if (strequal(param, "BDC")) {
102 } else if (strequal(param, "MEMBER")) {
103 return SEC_CHAN_WKSTA;
105 } else if (strequal(param, "DOMAIN")) {
106 return SEC_CHAN_DOMAIN;
109 return get_default_sec_channel();
115 run a function from a function table. If not found then
116 call the specified usage function
118 int net_run_function(int argc, const char **argv, struct functable *table,
119 int (*usage_fn)(int argc, const char **argv))
124 d_printf("\nUsage: \n");
125 return usage_fn(argc, argv);
127 for (i=0; table[i].funcname; i++) {
128 if (StrCaseCmp(argv[0], table[i].funcname) == 0)
129 return table[i].fn(argc-1, argv+1);
131 d_fprintf(stderr, "No command: %s\n", argv[0]);
132 return usage_fn(argc, argv);
136 * run a function from a function table.
138 int net_run_function2(int argc, const char **argv, const char *whoami,
139 struct functable2 *table)
144 for (i=0; table[i].funcname; i++) {
145 if (StrCaseCmp(argv[0], table[i].funcname) == 0)
146 return table[i].fn(argc-1, argv+1);
150 for (i=0; table[i].funcname != NULL; i++) {
151 d_printf("%s %-15s %s\n", whoami, table[i].funcname,
158 /****************************************************************************
159 connect to \\server\service
160 ****************************************************************************/
161 NTSTATUS connect_to_service(struct cli_state **c, struct in_addr *server_ip,
162 const char *server_name,
163 const char *service_name,
164 const char *service_type)
168 if (!opt_password && !opt_machine_pass) {
169 char *pass = getpass("Password:");
171 opt_password = SMB_STRDUP(pass);
175 nt_status = cli_full_connection(c, NULL, server_name,
177 service_name, service_type,
178 opt_user_name, opt_workgroup,
179 opt_password, 0, Undefined, NULL);
181 if (NT_STATUS_IS_OK(nt_status)) {
184 d_fprintf(stderr, "Could not connect to server %s\n", server_name);
186 /* Display a nicer message depending on the result */
188 if (NT_STATUS_V(nt_status) ==
189 NT_STATUS_V(NT_STATUS_LOGON_FAILURE))
190 d_fprintf(stderr, "The username or password was not correct.\n");
192 if (NT_STATUS_V(nt_status) ==
193 NT_STATUS_V(NT_STATUS_ACCOUNT_LOCKED_OUT))
194 d_fprintf(stderr, "The account was locked out.\n");
196 if (NT_STATUS_V(nt_status) ==
197 NT_STATUS_V(NT_STATUS_ACCOUNT_DISABLED))
198 d_fprintf(stderr, "The account was disabled.\n");
205 /****************************************************************************
206 connect to \\server\ipc$
207 ****************************************************************************/
208 NTSTATUS connect_to_ipc(struct cli_state **c, struct in_addr *server_ip,
209 const char *server_name)
211 return connect_to_service(c, server_ip, server_name, "IPC$", "IPC");
214 /****************************************************************************
215 connect to \\server\ipc$ anonymously
216 ****************************************************************************/
217 NTSTATUS connect_to_ipc_anonymous(struct cli_state **c,
218 struct in_addr *server_ip, const char *server_name)
222 nt_status = cli_full_connection(c, opt_requester_name, server_name,
226 "", 0, Undefined, NULL);
228 if (NT_STATUS_IS_OK(nt_status)) {
231 DEBUG(1,("Cannot connect to server (anonymously). Error was %s\n", nt_errstr(nt_status)));
237 * Connect a server and open a given pipe
239 * @param cli_dst A cli_state
240 * @param pipe The pipe to open
241 * @param got_pipe boolean that stores if we got a pipe
243 * @return Normal NTSTATUS return.
245 NTSTATUS connect_dst_pipe(struct cli_state **cli_dst, struct rpc_pipe_client **pp_pipe_hnd, int pipe_num)
248 char *server_name = SMB_STRDUP("127.0.0.1");
249 struct cli_state *cli_tmp = NULL;
250 struct rpc_pipe_client *pipe_hnd = NULL;
253 server_name = SMB_STRDUP(opt_destination);
255 /* make a connection to a named pipe */
256 nt_status = connect_to_ipc(&cli_tmp, NULL, server_name);
257 if (!NT_STATUS_IS_OK(nt_status)) {
261 pipe_hnd = cli_rpc_pipe_open_noauth(cli_tmp, pipe_num, &nt_status);
263 DEBUG(0, ("couldn't not initialize pipe\n"));
264 cli_shutdown(cli_tmp);
269 *pp_pipe_hnd = pipe_hnd;
274 /****************************************************************************
275 Use the local machine's password for this session.
276 ****************************************************************************/
278 int net_use_machine_password(void)
280 char *user_name = NULL;
282 if (!secrets_init()) {
283 d_fprintf(stderr, "ERROR: Unable to open secrets database\n");
288 opt_password = secrets_fetch_machine_password(opt_target_workgroup, NULL, NULL);
289 if (asprintf(&user_name, "%s$@%s", global_myname(), lp_realm()) == -1) {
292 opt_user_name = user_name;
296 BOOL net_find_server(unsigned flags, struct in_addr *server_ip, char **server_name)
300 *server_name = SMB_STRDUP(opt_host);
304 *server_ip = opt_dest_ip;
306 *server_name = SMB_STRDUP(inet_ntoa(opt_dest_ip));
308 } else if (*server_name) {
309 /* resolve the IP address */
310 if (!resolve_name(*server_name, server_ip, 0x20)) {
311 DEBUG(1,("Unable to resolve server name\n"));
314 } else if (flags & NET_FLAGS_PDC) {
315 struct in_addr pdc_ip;
317 if (get_pdc_ip(opt_target_workgroup, &pdc_ip)) {
320 if (is_zero_ip(pdc_ip))
323 if ( !name_status_find(opt_target_workgroup, 0x1b, 0x20, pdc_ip, dc_name) )
326 *server_name = SMB_STRDUP(dc_name);
330 } else if (flags & NET_FLAGS_DMB) {
331 struct in_addr msbrow_ip;
332 /* if (!resolve_name(MSBROWSE, &msbrow_ip, 1)) */
333 if (!resolve_name(opt_target_workgroup, &msbrow_ip, 0x1B)) {
334 DEBUG(1,("Unable to resolve domain browser via name lookup\n"));
337 *server_ip = msbrow_ip;
339 *server_name = SMB_STRDUP(inet_ntoa(opt_dest_ip));
340 } else if (flags & NET_FLAGS_MASTER) {
341 struct in_addr brow_ips;
342 if (!resolve_name(opt_target_workgroup, &brow_ips, 0x1D)) {
343 /* go looking for workgroups */
344 DEBUG(1,("Unable to resolve master browser via name lookup\n"));
347 *server_ip = brow_ips;
349 *server_name = SMB_STRDUP(inet_ntoa(opt_dest_ip));
350 } else if (!(flags & NET_FLAGS_LOCALHOST_DEFAULT_INSANE)) {
351 *server_ip = loopback_ip;
352 *server_name = SMB_STRDUP("127.0.0.1");
355 if (!server_name || !*server_name) {
356 DEBUG(1,("no server to connect to\n"));
364 BOOL net_find_pdc(struct in_addr *server_ip, fstring server_name, const char *domain_name)
366 if (get_pdc_ip(domain_name, server_ip)) {
367 if (is_zero_ip(*server_ip))
370 if (!name_status_find(domain_name, 0x1b, 0x20, *server_ip, server_name))
380 struct cli_state *net_make_ipc_connection(unsigned flags)
382 char *server_name = NULL;
383 struct in_addr server_ip;
384 struct cli_state *cli = NULL;
387 if (!net_find_server(flags, &server_ip, &server_name)) {
388 d_fprintf(stderr, "\nUnable to find a suitable server\n");
392 if (flags & NET_FLAGS_ANONYMOUS) {
393 nt_status = connect_to_ipc_anonymous(&cli, &server_ip, server_name);
395 nt_status = connect_to_ipc(&cli, &server_ip, server_name);
398 SAFE_FREE(server_name);
399 if (NT_STATUS_IS_OK(nt_status)) {
402 d_fprintf(stderr, "Connection failed: %s\n",
403 nt_errstr(nt_status));
408 static int net_user(int argc, const char **argv)
410 if (net_ads_check() == 0)
411 return net_ads_user(argc, argv);
413 /* if server is not specified, default to PDC? */
414 if (net_rpc_check(NET_FLAGS_PDC))
415 return net_rpc_user(argc, argv);
417 return net_rap_user(argc, argv);
420 static int net_group(int argc, const char **argv)
422 if (net_ads_check() == 0)
423 return net_ads_group(argc, argv);
425 if (argc == 0 && net_rpc_check(NET_FLAGS_PDC))
426 return net_rpc_group(argc, argv);
428 return net_rap_group(argc, argv);
431 static int net_join(int argc, const char **argv)
433 if (net_ads_check() == 0) {
434 if (net_ads_join(argc, argv) == 0)
437 d_fprintf(stderr, "ADS join did not work, falling back to RPC...\n");
439 return net_rpc_join(argc, argv);
442 static int net_changetrustpw(int argc, const char **argv)
444 if (net_ads_check() == 0)
445 return net_ads_changetrustpw(argc, argv);
447 return net_rpc_changetrustpw(argc, argv);
450 static int net_changesecretpw(int argc, const char **argv)
453 uint32 sec_channel_type = SEC_CHAN_WKSTA;
456 trust_pw = getpass("Enter machine password: ");
458 if (!secrets_store_machine_password(trust_pw, lp_workgroup(), sec_channel_type)) {
459 d_fprintf(stderr, "Unable to write the machine account password in the secrets database");
463 d_printf("Modified trust account password in secrets database\n");
467 d_printf("Machine account password change requires the -f flag.\n");
468 d_printf("Do NOT use this function unless you know what it does!\n");
469 d_printf("This function will change the ADS Domain member machine account password in the secrets.tdb file!\n");
475 static int net_share(int argc, const char **argv)
477 if (net_rpc_check(0))
478 return net_rpc_share(argc, argv);
479 return net_rap_share(argc, argv);
482 static int net_file(int argc, const char **argv)
484 if (net_rpc_check(0))
485 return net_rpc_file(argc, argv);
486 return net_rap_file(argc, argv);
490 Retrieve our local SID or the SID for the specified name
492 static int net_getlocalsid(int argc, const char **argv)
502 name = global_myname();
505 if(!initialize_password_db(False)) {
506 DEBUG(0, ("WARNING: Could not open passdb - local sid may not reflect passdb\n"
507 "backend knowlege (such as the sid stored in LDAP)\n"));
510 /* first check to see if we can even access secrets, so we don't
511 panic when we can't. */
513 if (!secrets_init()) {
514 d_fprintf(stderr, "Unable to open secrets.tdb. Can't fetch domain SID for name: %s\n", name);
518 /* Generate one, if it doesn't exist */
519 get_global_sam_sid();
521 if (!secrets_fetch_domain_sid(name, &sid)) {
522 DEBUG(0, ("Can't fetch domain SID for name: %s\n", name));
525 sid_to_string(sid_str, &sid);
526 d_printf("SID for domain %s is: %s\n", name, sid_str);
530 static int net_setlocalsid(int argc, const char **argv)
535 || (strncmp(argv[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
536 || (!string_to_sid(&sid, argv[0]))
537 || (sid.num_auths != 4)) {
538 d_printf("usage: net setlocalsid S-1-5-21-x-y-z\n");
542 if (!secrets_store_domain_sid(global_myname(), &sid)) {
543 DEBUG(0,("Can't store domain SID as a pdc/bdc.\n"));
550 static int net_getdomainsid(int argc, const char **argv)
555 if(!initialize_password_db(False)) {
556 DEBUG(0, ("WARNING: Could not open passdb - domain sid may not reflect passdb\n"
557 "backend knowlege (such as the sid stored in LDAP)\n"));
560 /* Generate one, if it doesn't exist */
561 get_global_sam_sid();
563 if (!secrets_fetch_domain_sid(global_myname(), &domain_sid)) {
564 d_fprintf(stderr, "Could not fetch local SID\n");
567 sid_to_string(sid_str, &domain_sid);
568 d_printf("SID for domain %s is: %s\n", global_myname(), sid_str);
570 if (!secrets_fetch_domain_sid(opt_workgroup, &domain_sid)) {
571 d_fprintf(stderr, "Could not fetch domain SID\n");
575 sid_to_string(sid_str, &domain_sid);
576 d_printf("SID for domain %s is: %s\n", opt_workgroup, sid_str);
581 #ifdef WITH_FAKE_KASERVER
583 int net_help_afs(int argc, const char **argv)
585 d_printf(" net afs key filename\n"
586 "\tImports a OpenAFS KeyFile into our secrets.tdb\n\n");
587 d_printf(" net afs impersonate <user> <cell>\n"
588 "\tCreates a token for user@cell\n\n");
592 static int net_afs_key(int argc, const char **argv)
595 struct afs_keyfile keyfile;
598 d_printf("usage: 'net afs key <keyfile> cell'\n");
602 if (!secrets_init()) {
603 d_fprintf(stderr, "Could not open secrets.tdb\n");
607 if ((fd = open(argv[0], O_RDONLY, 0)) < 0) {
608 d_fprintf(stderr, "Could not open %s\n", argv[0]);
612 if (read(fd, &keyfile, sizeof(keyfile)) != sizeof(keyfile)) {
613 d_fprintf(stderr, "Could not read keyfile\n");
617 if (!secrets_store_afs_keyfile(argv[1], &keyfile)) {
618 d_fprintf(stderr, "Could not write keyfile to secrets.tdb\n");
625 static int net_afs_impersonate(int argc, const char **argv)
630 fprintf(stderr, "Usage: net afs impersonate <user> <cell>\n");
634 token = afs_createtoken_str(argv[0], argv[1]);
637 fprintf(stderr, "Could not create token\n");
641 if (!afs_settoken_str(token)) {
642 fprintf(stderr, "Could not set token into kernel\n");
646 printf("Success: %s@%s\n", argv[0], argv[1]);
650 static int net_afs(int argc, const char **argv)
652 struct functable func[] = {
653 {"key", net_afs_key},
654 {"impersonate", net_afs_impersonate},
655 {"help", net_help_afs},
658 return net_run_function(argc, argv, func, net_help_afs);
661 #endif /* WITH_FAKE_KASERVER */
663 static BOOL search_maxrid(struct pdb_search *search, const char *type,
666 struct samr_displayentry *entries;
667 uint32 i, num_entries;
669 if (search == NULL) {
670 d_fprintf(stderr, "get_maxrid: Could not search %s\n", type);
674 num_entries = pdb_search_entries(search, 0, 0xffffffff, &entries);
675 for (i=0; i<num_entries; i++)
676 *max_rid = MAX(*max_rid, entries[i].rid);
677 pdb_search_destroy(search);
681 static uint32 get_maxrid(void)
685 if (!search_maxrid(pdb_search_users(0), "users", &max_rid))
688 if (!search_maxrid(pdb_search_groups(), "groups", &max_rid))
691 if (!search_maxrid(pdb_search_aliases(get_global_sam_sid()),
692 "aliases", &max_rid))
698 static int net_maxrid(int argc, const char **argv)
703 DEBUG(0, ("usage: net maxrid\n"));
707 if ((rid = get_maxrid()) == 0) {
708 DEBUG(0, ("can't get current maximum rid\n"));
712 d_printf("Currently used maximum rid: %d\n", rid);
717 /* main function table */
718 static struct functable net_func[] = {
723 /* eventually these should auto-choose the transport ... */
725 {"SHARE", net_share},
726 {"SESSION", net_rap_session},
727 {"SERVER", net_rap_server},
728 {"DOMAIN", net_rap_domain},
729 {"PRINTQ", net_rap_printq},
731 {"GROUP", net_group},
732 {"GROUPMAP", net_groupmap},
734 {"VALIDATE", net_rap_validate},
735 {"GROUPMEMBER", net_rap_groupmember},
736 {"ADMIN", net_rap_admin},
737 {"SERVICE", net_rap_service},
738 {"PASSWORD", net_rap_password},
739 {"CHANGETRUSTPW", net_changetrustpw},
740 {"CHANGESECRETPW", net_changesecretpw},
742 {"LOOKUP", net_lookup},
744 {"CACHE", net_cache},
745 {"GETLOCALSID", net_getlocalsid},
746 {"SETLOCALSID", net_setlocalsid},
747 {"GETDOMAINSID", net_getdomainsid},
748 {"MAXRID", net_maxrid},
749 {"IDMAP", net_idmap},
750 {"STATUS", net_status},
751 {"USERSHARE", net_usershare},
752 {"USERSIDLIST", net_usersidlist},
753 #ifdef WITH_FAKE_KASERVER
762 /****************************************************************************
764 ****************************************************************************/
765 int main(int argc, const char **argv)
771 const char ** argv_new;
774 struct poptOption long_options[] = {
775 {"help", 'h', POPT_ARG_NONE, 0, 'h'},
776 {"workgroup", 'w', POPT_ARG_STRING, &opt_target_workgroup},
777 {"user", 'U', POPT_ARG_STRING, &opt_user_name, 'U'},
778 {"ipaddress", 'I', POPT_ARG_STRING, 0,'I'},
779 {"port", 'p', POPT_ARG_INT, &opt_port},
780 {"myname", 'n', POPT_ARG_STRING, &opt_requester_name},
781 {"server", 'S', POPT_ARG_STRING, &opt_host},
782 {"container", 'c', POPT_ARG_STRING, &opt_container},
783 {"comment", 'C', POPT_ARG_STRING, &opt_comment},
784 {"maxusers", 'M', POPT_ARG_INT, &opt_maxusers},
785 {"flags", 'F', POPT_ARG_INT, &opt_flags},
786 {"long", 'l', POPT_ARG_NONE, &opt_long_list_entries},
787 {"reboot", 'r', POPT_ARG_NONE, &opt_reboot},
788 {"force", 'f', POPT_ARG_NONE, &opt_force},
789 {"timeout", 't', POPT_ARG_INT, &opt_timeout},
790 {"machine-pass",'P', POPT_ARG_NONE, &opt_machine_pass},
791 {"myworkgroup", 'W', POPT_ARG_STRING, &opt_workgroup},
792 {"verbose", 'v', POPT_ARG_NONE, &opt_verbose},
793 /* Options for 'net groupmap set' */
794 {"local", 'L', POPT_ARG_NONE, &opt_localgroup},
795 {"domain", 'D', POPT_ARG_NONE, &opt_domaingroup},
796 {"ntname", 'N', POPT_ARG_STRING, &opt_newntname},
797 {"rid", 'R', POPT_ARG_INT, &opt_rid},
798 /* Options for 'net rpc share migrate' */
799 {"acls", 0, POPT_ARG_NONE, &opt_acls},
800 {"attrs", 0, POPT_ARG_NONE, &opt_attrs},
801 {"timestamps", 0, POPT_ARG_NONE, &opt_timestamps},
802 {"exclude", 'e', POPT_ARG_STRING, &opt_exclude},
803 {"destination", 0, POPT_ARG_STRING, &opt_destination},
809 zero_ip(&opt_dest_ip);
813 /* set default debug level to 0 regardless of what smb.conf sets */
814 DEBUGLEVEL_CLASS[DBGC_ALL] = 0;
817 pc = poptGetContext(NULL, argc, (const char **) argv, long_options,
818 POPT_CONTEXT_KEEP_FIRST);
820 while((opt = poptGetNextOpt(pc)) != -1) {
823 net_help(argc, argv);
827 opt_dest_ip = *interpret_addr2(poptGetOptArg(pc));
828 if (is_zero_ip(opt_dest_ip))
829 d_fprintf(stderr, "\nInvalid ip address specified\n");
834 opt_user_specified = True;
835 opt_user_name = SMB_STRDUP(opt_user_name);
836 p = strchr(opt_user_name,'%');
843 d_fprintf(stderr, "\nInvalid option %s: %s\n",
844 poptBadOption(pc, 0), poptStrerror(opt));
845 net_help(argc, argv);
851 * Don't load debug level from smb.conf. It should be
852 * set by cmdline arg or remain default (0)
854 AllowDebugChange = False;
855 lp_load(dyn_CONFIGFILE,True,False,False,True);
857 argv_new = (const char **)poptGetArgs(pc);
860 for (i=0; i<argc; i++) {
861 if (argv_new[i] == NULL) {
867 if (opt_requester_name) {
868 set_global_myname(opt_requester_name);
871 if (!opt_user_name && getenv("LOGNAME")) {
872 opt_user_name = getenv("LOGNAME");
875 if (!opt_workgroup) {
876 opt_workgroup = smb_xstrdup(lp_workgroup());
879 if (!opt_target_workgroup) {
880 opt_target_workgroup = smb_xstrdup(lp_workgroup());
888 /* this makes sure that when we do things like call scripts,
889 that it won't assert becouse we are not root */
892 if (opt_machine_pass) {
893 /* it is very useful to be able to make ads queries as the
894 machine account for testing purposes and for domain leave */
896 net_use_machine_password();
900 opt_password = getenv("PASSWD");
903 rc = net_run_function(argc_new-1, argv_new+1, net_func, net_help);
905 DEBUG(2,("return code = %d\n", rc));