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_printf("No command: %s\n", argv
[0]);
132 return usage_fn(argc
, argv
);
135 /****************************************************************************
136 connect to \\server\service
137 ****************************************************************************/
138 NTSTATUS
connect_to_service(struct cli_state
**c
, struct in_addr
*server_ip
,
139 const char *server_name
,
140 const char *service_name
,
141 const char *service_type
)
145 if (!opt_password
&& !opt_machine_pass
) {
146 char *pass
= getpass("Password:");
148 opt_password
= SMB_STRDUP(pass
);
152 nt_status
= cli_full_connection(c
, NULL
, server_name
,
154 service_name
, service_type
,
155 opt_user_name
, opt_workgroup
,
156 opt_password
, 0, Undefined
, NULL
);
158 if (NT_STATUS_IS_OK(nt_status
)) {
161 d_printf("Could not connect to server %s\n", server_name
);
163 /* Display a nicer message depending on the result */
165 if (NT_STATUS_V(nt_status
) ==
166 NT_STATUS_V(NT_STATUS_LOGON_FAILURE
))
167 d_printf("The username or password was not correct.\n");
169 if (NT_STATUS_V(nt_status
) ==
170 NT_STATUS_V(NT_STATUS_ACCOUNT_LOCKED_OUT
))
171 d_printf("The account was locked out.\n");
173 if (NT_STATUS_V(nt_status
) ==
174 NT_STATUS_V(NT_STATUS_ACCOUNT_DISABLED
))
175 d_printf("The account was disabled.\n");
182 /****************************************************************************
183 connect to \\server\ipc$
184 ****************************************************************************/
185 NTSTATUS
connect_to_ipc(struct cli_state
**c
, struct in_addr
*server_ip
,
186 const char *server_name
)
188 return connect_to_service(c
, server_ip
, server_name
, "IPC$", "IPC");
191 /****************************************************************************
192 connect to \\server\ipc$ anonymously
193 ****************************************************************************/
194 NTSTATUS
connect_to_ipc_anonymous(struct cli_state
**c
,
195 struct in_addr
*server_ip
, const char *server_name
)
199 nt_status
= cli_full_connection(c
, opt_requester_name
, server_name
,
203 "", 0, Undefined
, NULL
);
205 if (NT_STATUS_IS_OK(nt_status
)) {
208 DEBUG(1,("Cannot connect to server (anonymously). Error was %s\n", nt_errstr(nt_status
)));
214 * Connect a server and open a given pipe
216 * @param cli_dst A cli_state
217 * @param pipe The pipe to open
218 * @param got_pipe boolean that stores if we got a pipe
220 * @return Normal NTSTATUS return.
222 NTSTATUS
connect_dst_pipe(struct cli_state
**cli_dst
, struct rpc_pipe_client
**pp_pipe_hnd
, int pipe_num
)
225 char *server_name
= SMB_STRDUP("127.0.0.1");
226 struct cli_state
*cli_tmp
= NULL
;
227 struct rpc_pipe_client
*pipe_hnd
= NULL
;
230 server_name
= SMB_STRDUP(opt_destination
);
232 /* make a connection to a named pipe */
233 nt_status
= connect_to_ipc(&cli_tmp
, NULL
, server_name
);
234 if (!NT_STATUS_IS_OK(nt_status
)) {
238 pipe_hnd
= cli_rpc_pipe_open_noauth(cli_tmp
, pipe_num
, &nt_status
);
240 DEBUG(0, ("couldn't not initialize pipe\n"));
241 cli_shutdown(cli_tmp
);
246 *pp_pipe_hnd
= pipe_hnd
;
251 /****************************************************************************
252 Use the local machine's password for this session.
253 ****************************************************************************/
255 int net_use_machine_password(void)
257 char *user_name
= NULL
;
259 if (!secrets_init()) {
260 d_printf("ERROR: Unable to open secrets database\n");
265 opt_password
= secrets_fetch_machine_password(opt_target_workgroup
, NULL
, NULL
);
266 if (asprintf(&user_name
, "%s$@%s", global_myname(), lp_realm()) == -1) {
269 opt_user_name
= user_name
;
273 BOOL
net_find_server(unsigned flags
, struct in_addr
*server_ip
, char **server_name
)
277 *server_name
= SMB_STRDUP(opt_host
);
281 *server_ip
= opt_dest_ip
;
283 *server_name
= SMB_STRDUP(inet_ntoa(opt_dest_ip
));
285 } else if (*server_name
) {
286 /* resolve the IP address */
287 if (!resolve_name(*server_name
, server_ip
, 0x20)) {
288 DEBUG(1,("Unable to resolve server name\n"));
291 } else if (flags
& NET_FLAGS_PDC
) {
292 struct in_addr pdc_ip
;
294 if (get_pdc_ip(opt_target_workgroup
, &pdc_ip
)) {
297 if (is_zero_ip(pdc_ip
))
300 if ( !name_status_find(opt_target_workgroup
, 0x1b, 0x20, pdc_ip
, dc_name
) )
303 *server_name
= SMB_STRDUP(dc_name
);
307 } else if (flags
& NET_FLAGS_DMB
) {
308 struct in_addr msbrow_ip
;
309 /* if (!resolve_name(MSBROWSE, &msbrow_ip, 1)) */
310 if (!resolve_name(opt_target_workgroup
, &msbrow_ip
, 0x1B)) {
311 DEBUG(1,("Unable to resolve domain browser via name lookup\n"));
314 *server_ip
= msbrow_ip
;
316 *server_name
= SMB_STRDUP(inet_ntoa(opt_dest_ip
));
317 } else if (flags
& NET_FLAGS_MASTER
) {
318 struct in_addr brow_ips
;
319 if (!resolve_name(opt_target_workgroup
, &brow_ips
, 0x1D)) {
320 /* go looking for workgroups */
321 DEBUG(1,("Unable to resolve master browser via name lookup\n"));
324 *server_ip
= brow_ips
;
326 *server_name
= SMB_STRDUP(inet_ntoa(opt_dest_ip
));
327 } else if (!(flags
& NET_FLAGS_LOCALHOST_DEFAULT_INSANE
)) {
328 *server_ip
= loopback_ip
;
329 *server_name
= SMB_STRDUP("127.0.0.1");
332 if (!server_name
|| !*server_name
) {
333 DEBUG(1,("no server to connect to\n"));
341 BOOL
net_find_pdc(struct in_addr
*server_ip
, fstring server_name
, const char *domain_name
)
343 if (get_pdc_ip(domain_name
, server_ip
)) {
344 if (is_zero_ip(*server_ip
))
347 if (!name_status_find(domain_name
, 0x1b, 0x20, *server_ip
, server_name
))
357 struct cli_state
*net_make_ipc_connection(unsigned flags
)
359 char *server_name
= NULL
;
360 struct in_addr server_ip
;
361 struct cli_state
*cli
= NULL
;
364 if (!net_find_server(flags
, &server_ip
, &server_name
)) {
365 d_printf("\nUnable to find a suitable server\n");
369 if (flags
& NET_FLAGS_ANONYMOUS
) {
370 nt_status
= connect_to_ipc_anonymous(&cli
, &server_ip
, server_name
);
372 nt_status
= connect_to_ipc(&cli
, &server_ip
, server_name
);
375 SAFE_FREE(server_name
);
376 if (NT_STATUS_IS_OK(nt_status
)) {
383 static int net_user(int argc
, const char **argv
)
385 if (net_ads_check() == 0)
386 return net_ads_user(argc
, argv
);
388 /* if server is not specified, default to PDC? */
389 if (net_rpc_check(NET_FLAGS_PDC
))
390 return net_rpc_user(argc
, argv
);
392 return net_rap_user(argc
, argv
);
395 static int net_group(int argc
, const char **argv
)
397 if (net_ads_check() == 0)
398 return net_ads_group(argc
, argv
);
400 if (argc
== 0 && net_rpc_check(NET_FLAGS_PDC
))
401 return net_rpc_group(argc
, argv
);
403 return net_rap_group(argc
, argv
);
406 static int net_join(int argc
, const char **argv
)
408 if (net_ads_check() == 0) {
409 if (net_ads_join(argc
, argv
) == 0)
412 d_printf("ADS join did not work, falling back to RPC...\n");
414 return net_rpc_join(argc
, argv
);
417 static int net_changetrustpw(int argc
, const char **argv
)
419 if (net_ads_check() == 0)
420 return net_ads_changetrustpw(argc
, argv
);
422 return net_rpc_changetrustpw(argc
, argv
);
425 static int net_changesecretpw(int argc
, const char **argv
)
428 uint32 sec_channel_type
= SEC_CHAN_WKSTA
;
431 trust_pw
= getpass("Enter machine password: ");
433 if (!secrets_store_machine_password(trust_pw
, lp_workgroup(), sec_channel_type
)) {
434 d_printf("Unable to write the machine account password in the secrets database");
438 d_printf("Modified trust account password in secrets database\n");
442 d_printf("Machine account password change requires the -f flag.\n");
443 d_printf("Do NOT use this function unless you know what it does!\n");
444 d_printf("This function will change the ADS Domain member machine account password in the secrets.tdb file!\n");
450 static int net_share(int argc
, const char **argv
)
452 if (net_rpc_check(0))
453 return net_rpc_share(argc
, argv
);
454 return net_rap_share(argc
, argv
);
457 static int net_file(int argc
, const char **argv
)
459 if (net_rpc_check(0))
460 return net_rpc_file(argc
, argv
);
461 return net_rap_file(argc
, argv
);
465 Retrieve our local SID or the SID for the specified name
467 static int net_getlocalsid(int argc
, const char **argv
)
477 name
= global_myname();
480 if(!initialize_password_db(False
)) {
481 DEBUG(0, ("WARNING: Could not open passdb - local sid may not reflect passdb\n"
482 "backend knowlege (such as the sid stored in LDAP)\n"));
485 /* first check to see if we can even access secrets, so we don't
486 panic when we can't. */
488 if (!secrets_init()) {
489 d_printf("Unable to open secrets.tdb. Can't fetch domain SID for name: %s\n", name
);
493 /* Generate one, if it doesn't exist */
494 get_global_sam_sid();
496 if (!secrets_fetch_domain_sid(name
, &sid
)) {
497 DEBUG(0, ("Can't fetch domain SID for name: %s\n", name
));
500 sid_to_string(sid_str
, &sid
);
501 d_printf("SID for domain %s is: %s\n", name
, sid_str
);
505 static int net_setlocalsid(int argc
, const char **argv
)
510 || (strncmp(argv
[0], "S-1-5-21-", strlen("S-1-5-21-")) != 0)
511 || (!string_to_sid(&sid
, argv
[0]))
512 || (sid
.num_auths
!= 4)) {
513 d_printf("usage: net setlocalsid S-1-5-21-x-y-z\n");
517 if (!secrets_store_domain_sid(global_myname(), &sid
)) {
518 DEBUG(0,("Can't store domain SID as a pdc/bdc.\n"));
525 static int net_getdomainsid(int argc
, const char **argv
)
530 if(!initialize_password_db(False
)) {
531 DEBUG(0, ("WARNING: Could not open passdb - domain sid may not reflect passdb\n"
532 "backend knowlege (such as the sid stored in LDAP)\n"));
535 /* Generate one, if it doesn't exist */
536 get_global_sam_sid();
538 if (!secrets_fetch_domain_sid(global_myname(), &domain_sid
)) {
539 d_printf("Could not fetch local SID\n");
542 sid_to_string(sid_str
, &domain_sid
);
543 d_printf("SID for domain %s is: %s\n", global_myname(), sid_str
);
545 if (!secrets_fetch_domain_sid(opt_workgroup
, &domain_sid
)) {
546 d_printf("Could not fetch domain SID\n");
550 sid_to_string(sid_str
, &domain_sid
);
551 d_printf("SID for domain %s is: %s\n", opt_workgroup
, sid_str
);
556 #ifdef WITH_FAKE_KASERVER
558 int net_help_afs(int argc
, const char **argv
)
560 d_printf(" net afs key filename\n"
561 "\tImports a OpenAFS KeyFile into our secrets.tdb\n\n");
562 d_printf(" net afs impersonate <user> <cell>\n"
563 "\tCreates a token for user@cell\n\n");
567 static int net_afs_key(int argc
, const char **argv
)
570 struct afs_keyfile keyfile
;
573 d_printf("usage: 'net afs key <keyfile> cell'\n");
577 if (!secrets_init()) {
578 d_printf("Could not open secrets.tdb\n");
582 if ((fd
= open(argv
[0], O_RDONLY
, 0)) < 0) {
583 d_printf("Could not open %s\n", argv
[0]);
587 if (read(fd
, &keyfile
, sizeof(keyfile
)) != sizeof(keyfile
)) {
588 d_printf("Could not read keyfile\n");
592 if (!secrets_store_afs_keyfile(argv
[1], &keyfile
)) {
593 d_printf("Could not write keyfile to secrets.tdb\n");
600 static int net_afs_impersonate(int argc
, const char **argv
)
605 fprintf(stderr
, "Usage: net afs impersonate <user> <cell>\n");
609 token
= afs_createtoken_str(argv
[0], argv
[1]);
612 fprintf(stderr
, "Could not create token\n");
616 if (!afs_settoken_str(token
)) {
617 fprintf(stderr
, "Could not set token into kernel\n");
621 printf("Success: %s@%s\n", argv
[0], argv
[1]);
625 static int net_afs(int argc
, const char **argv
)
627 struct functable func
[] = {
628 {"key", net_afs_key
},
629 {"impersonate", net_afs_impersonate
},
630 {"help", net_help_afs
},
633 return net_run_function(argc
, argv
, func
, net_help_afs
);
636 #endif /* WITH_FAKE_KASERVER */
638 static BOOL
search_maxrid(struct pdb_search
*search
, const char *type
,
641 struct samr_displayentry
*entries
;
642 uint32 i
, num_entries
;
644 if (search
== NULL
) {
645 d_printf("get_maxrid: Could not search %s\n", type
);
649 num_entries
= pdb_search_entries(search
, 0, 0xffffffff, &entries
);
650 for (i
=0; i
<num_entries
; i
++)
651 *max_rid
= MAX(*max_rid
, entries
[i
].rid
);
652 pdb_search_destroy(search
);
656 static uint32
get_maxrid(void)
660 if (!search_maxrid(pdb_search_users(0), "users", &max_rid
))
663 if (!search_maxrid(pdb_search_groups(), "groups", &max_rid
))
666 if (!search_maxrid(pdb_search_aliases(get_global_sam_sid()),
667 "aliases", &max_rid
))
673 static int net_maxrid(int argc
, const char **argv
)
678 DEBUG(0, ("usage: net maxrid\n"));
682 if ((rid
= get_maxrid()) == 0) {
683 DEBUG(0, ("can't get current maximum rid\n"));
687 d_printf("Currently used maximum rid: %d\n", rid
);
692 /* main function table */
693 static struct functable net_func
[] = {
698 /* eventually these should auto-choose the transport ... */
700 {"SHARE", net_share
},
701 {"SESSION", net_rap_session
},
702 {"SERVER", net_rap_server
},
703 {"DOMAIN", net_rap_domain
},
704 {"PRINTQ", net_rap_printq
},
706 {"GROUP", net_group
},
707 {"GROUPMAP", net_groupmap
},
708 {"VALIDATE", net_rap_validate
},
709 {"GROUPMEMBER", net_rap_groupmember
},
710 {"ADMIN", net_rap_admin
},
711 {"SERVICE", net_rap_service
},
712 {"PASSWORD", net_rap_password
},
713 {"CHANGETRUSTPW", net_changetrustpw
},
714 {"CHANGESECRETPW", net_changesecretpw
},
716 {"LOOKUP", net_lookup
},
718 {"CACHE", net_cache
},
719 {"GETLOCALSID", net_getlocalsid
},
720 {"SETLOCALSID", net_setlocalsid
},
721 {"GETDOMAINSID", net_getdomainsid
},
722 {"MAXRID", net_maxrid
},
723 {"IDMAP", net_idmap
},
724 {"STATUS", net_status
},
725 {"USERSIDLIST", net_usersidlist
},
726 #ifdef WITH_FAKE_KASERVER
735 /****************************************************************************
737 ****************************************************************************/
738 int main(int argc
, const char **argv
)
744 const char ** argv_new
;
747 struct poptOption long_options
[] = {
748 {"help", 'h', POPT_ARG_NONE
, 0, 'h'},
749 {"workgroup", 'w', POPT_ARG_STRING
, &opt_target_workgroup
},
750 {"user", 'U', POPT_ARG_STRING
, &opt_user_name
, 'U'},
751 {"ipaddress", 'I', POPT_ARG_STRING
, 0,'I'},
752 {"port", 'p', POPT_ARG_INT
, &opt_port
},
753 {"myname", 'n', POPT_ARG_STRING
, &opt_requester_name
},
754 {"server", 'S', POPT_ARG_STRING
, &opt_host
},
755 {"container", 'c', POPT_ARG_STRING
, &opt_container
},
756 {"comment", 'C', POPT_ARG_STRING
, &opt_comment
},
757 {"maxusers", 'M', POPT_ARG_INT
, &opt_maxusers
},
758 {"flags", 'F', POPT_ARG_INT
, &opt_flags
},
759 {"long", 'l', POPT_ARG_NONE
, &opt_long_list_entries
},
760 {"reboot", 'r', POPT_ARG_NONE
, &opt_reboot
},
761 {"force", 'f', POPT_ARG_NONE
, &opt_force
},
762 {"timeout", 't', POPT_ARG_INT
, &opt_timeout
},
763 {"machine-pass",'P', POPT_ARG_NONE
, &opt_machine_pass
},
764 {"myworkgroup", 'W', POPT_ARG_STRING
, &opt_workgroup
},
765 {"verbose", 'v', POPT_ARG_NONE
, &opt_verbose
},
766 /* Options for 'net groupmap set' */
767 {"local", 'L', POPT_ARG_NONE
, &opt_localgroup
},
768 {"domain", 'D', POPT_ARG_NONE
, &opt_domaingroup
},
769 {"ntname", 'N', POPT_ARG_STRING
, &opt_newntname
},
770 {"rid", 'R', POPT_ARG_INT
, &opt_rid
},
771 /* Options for 'net rpc share migrate' */
772 {"acls", 0, POPT_ARG_NONE
, &opt_acls
},
773 {"attrs", 0, POPT_ARG_NONE
, &opt_attrs
},
774 {"timestamps", 0, POPT_ARG_NONE
, &opt_timestamps
},
775 {"exclude", 'e', POPT_ARG_STRING
, &opt_exclude
},
776 {"destination", 0, POPT_ARG_STRING
, &opt_destination
},
782 zero_ip(&opt_dest_ip
);
784 /* set default debug level to 0 regardless of what smb.conf sets */
785 DEBUGLEVEL_CLASS
[DBGC_ALL
] = 0;
788 pc
= poptGetContext(NULL
, argc
, (const char **) argv
, long_options
,
789 POPT_CONTEXT_KEEP_FIRST
);
791 while((opt
= poptGetNextOpt(pc
)) != -1) {
794 net_help(argc
, argv
);
798 opt_dest_ip
= *interpret_addr2(poptGetOptArg(pc
));
799 if (is_zero_ip(opt_dest_ip
))
800 d_printf("\nInvalid ip address specified\n");
805 opt_user_specified
= True
;
806 opt_user_name
= SMB_STRDUP(opt_user_name
);
807 p
= strchr(opt_user_name
,'%');
814 d_printf("\nInvalid option %s: %s\n",
815 poptBadOption(pc
, 0), poptStrerror(opt
));
816 net_help(argc
, argv
);
822 * Don't load debug level from smb.conf. It should be
823 * set by cmdline arg or remain default (0)
825 AllowDebugChange
= False
;
826 lp_load(dyn_CONFIGFILE
,True
,False
,False
);
828 argv_new
= (const char **)poptGetArgs(pc
);
831 for (i
=0; i
<argc
; i
++) {
832 if (argv_new
[i
] == NULL
) {
838 if (opt_requester_name
) {
839 set_global_myname(opt_requester_name
);
842 if (!opt_user_name
&& getenv("LOGNAME")) {
843 opt_user_name
= getenv("LOGNAME");
846 if (!opt_workgroup
) {
847 opt_workgroup
= smb_xstrdup(lp_workgroup());
850 if (!opt_target_workgroup
) {
851 opt_target_workgroup
= smb_xstrdup(lp_workgroup());
859 /* this makes sure that when we do things like call scripts,
860 that it won't assert becouse we are not root */
863 if (opt_machine_pass
) {
864 /* it is very useful to be able to make ads queries as the
865 machine account for testing purposes and for domain leave */
867 net_use_machine_password();
871 opt_password
= getenv("PASSWD");
874 rc
= net_run_function(argc_new
-1, argv_new
+1, net_func
, net_help
);
876 DEBUG(2,("return code = %d\n", rc
));