2 Unix SMB/CIFS implementation.
4 Send messages to other Samba daemons
6 Copyright (C) Tim Potter 2003
7 Copyright (C) Andrew Tridgell 1994-1998
8 Copyright (C) Martin Pool 2001-2002
9 Copyright (C) Simo Sorce 2002
10 Copyright (C) James Peach 2006
12 This program is free software; you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation; either version 3 of the License, or
15 (at your option) any later version.
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with this program. If not, see <http://www.gnu.org/licenses/>.
27 #include "system/filesys.h"
28 #include "popt_common.h"
29 #include "librpc/gen_ndr/spoolss.h"
30 #include "nt_printing.h"
31 #include "printing/notify.h"
32 #include "libsmb/nmblib.h"
35 #include "../lib/util/pidfile.h"
39 #include <libunwind.h>
42 #if HAVE_LIBUNWIND_PTRACE_H
43 #include <libunwind-ptrace.h>
47 #include <sys/ptrace.h>
50 /* Default timeout value when waiting for replies (in seconds) */
52 #define DEFAULT_TIMEOUT 10
54 static int timeout
= DEFAULT_TIMEOUT
;
55 static int num_replies
; /* Used by message callback fns */
57 /* Send a message to a destination pid. Zero means broadcast smbd. */
59 static bool send_message(struct messaging_context
*msg_ctx
,
60 struct server_id pid
, int msg_type
,
61 const void *buf
, int len
)
66 if (procid_to_pid(&pid
) != 0)
67 return NT_STATUS_IS_OK(
68 messaging_send_buf(msg_ctx
, pid
, msg_type
,
69 (const uint8
*)buf
, len
));
71 ret
= message_send_all(msg_ctx
, msg_type
, buf
, len
, &n_sent
);
72 DEBUG(10,("smbcontrol/send_message: broadcast message to "
73 "%d processes\n", n_sent
));
78 static void smbcontrol_timeout(struct tevent_context
*event_ctx
,
79 struct tevent_timer
*te
,
83 bool *timed_out
= (bool *)private_data
;
88 /* Wait for one or more reply messages */
90 static void wait_replies(struct tevent_context
*ev_ctx
,
91 struct messaging_context
*msg_ctx
,
92 bool multiple_replies
)
94 struct tevent_timer
*te
;
95 bool timed_out
= False
;
97 te
= tevent_add_timer(ev_ctx
, NULL
,
98 timeval_current_ofs(timeout
, 0),
99 smbcontrol_timeout
, (void *)&timed_out
);
101 DEBUG(0, ("tevent_add_timer failed\n"));
107 if (num_replies
> 0 && !multiple_replies
)
109 ret
= tevent_loop_once(ev_ctx
);
116 /* Message handler callback that displays the PID and a string on stdout */
118 static void print_pid_string_cb(struct messaging_context
*msg
,
121 struct server_id pid
,
126 pidstr
= server_id_str(talloc_tos(), &pid
);
127 printf("PID %s: %.*s", pidstr
, (int)data
->length
,
128 (const char *)data
->data
);
133 /* Message handler callback that displays a string on stdout */
135 static void print_string_cb(struct messaging_context
*msg
,
138 struct server_id pid
,
141 printf("%*s", (int)data
->length
, (const char *)data
->data
);
145 /* Send no message. Useful for testing. */
147 static bool do_noop(struct tevent_context
*ev_ctx
,
148 struct messaging_context
*msg_ctx
,
149 const struct server_id pid
,
150 const int argc
, const char **argv
)
153 fprintf(stderr
, "Usage: smbcontrol <dest> noop\n");
157 /* Move along, nothing to see here */
162 /* Send a debug string */
164 static bool do_debug(struct tevent_context
*ev_ctx
,
165 struct messaging_context
*msg_ctx
,
166 const struct server_id pid
,
167 const int argc
, const char **argv
)
170 fprintf(stderr
, "Usage: smbcontrol <dest> debug "
175 return send_message(msg_ctx
, pid
, MSG_DEBUG
, argv
[1],
176 strlen(argv
[1]) + 1);
180 static bool do_idmap(struct tevent_context
*ev
,
181 struct messaging_context
*msg_ctx
,
182 const struct server_id pid
,
183 const int argc
, const char **argv
)
185 static const char* usage
= "Usage: "
186 "smbcontrol <dest> idmap <cmd> [arg]\n"
188 "\tdelete \"UID <uid>\"|\"GID <gid>\"|<sid>\n"
189 "\t\tkill \"UID <uid>\"|\"GID <gid>\"|<sid>\n";
190 const char* arg
= NULL
;
199 arglen
= strlen(arg
) + 1;
202 fprintf(stderr
, "%s", usage
);
206 if (strcmp(argv
[1], "delete") == 0) {
207 msg_type
= ID_CACHE_DELETE
;
209 else if (strcmp(argv
[1], "kill") == 0) {
210 msg_type
= ID_CACHE_KILL
;
212 else if (strcmp(argv
[1], "help") == 0) {
213 fprintf(stdout
, "%s", usage
);
217 fprintf(stderr
, "%s", usage
);
221 return send_message(msg_ctx
, pid
, msg_type
, arg
, arglen
);
225 #if defined(HAVE_LIBUNWIND_PTRACE) && defined(HAVE_LINUX_PTRACE)
227 /* Return the name of a process given it's PID. This will only work on Linux,
228 * but that's probably moot since this whole stack tracing implementatino is
229 * Linux-specific anyway.
231 static const char * procname(pid_t pid
, char * buf
, size_t bufsz
)
236 snprintf(path
, sizeof(path
), "/proc/%llu/cmdline",
237 (unsigned long long)pid
);
238 if ((fp
= fopen(path
, "r")) == NULL
) {
242 fgets(buf
, bufsz
, fp
);
248 static void print_stack_trace(pid_t pid
, int * count
)
251 unw_addr_space_t aspace
= NULL
;
260 if (ptrace(PTRACE_ATTACH
, pid
, NULL
, NULL
) < 0) {
262 "Failed to attach to process %llu: %s\n",
263 (unsigned long long)pid
, strerror(errno
));
267 /* Wait until the attach is complete. */
268 waitpid(pid
, NULL
, 0);
270 if (((pinfo
= _UPT_create(pid
)) == NULL
) ||
271 ((aspace
= unw_create_addr_space(&_UPT_accessors
, 0)) == NULL
)) {
272 /* Probably out of memory. */
274 "Unable to initialize stack unwind for process %llu\n",
275 (unsigned long long)pid
);
279 if ((ret
= unw_init_remote(&cursor
, aspace
, pinfo
))) {
281 "Unable to unwind stack for process %llu: %s\n",
282 (unsigned long long)pid
, unw_strerror(ret
));
290 if (procname(pid
, nbuf
, sizeof(nbuf
))) {
291 printf("Stack trace for process %llu (%s):\n",
292 (unsigned long long)pid
, nbuf
);
294 printf("Stack trace for process %llu:\n",
295 (unsigned long long)pid
);
298 while (unw_step(&cursor
) > 0) {
300 unw_get_reg(&cursor
, UNW_REG_IP
, &ip
);
301 unw_get_reg(&cursor
, UNW_REG_SP
, &sp
);
303 ret
= unw_get_proc_name(&cursor
, nbuf
, sizeof(nbuf
), &off
);
304 if (ret
!= 0 && ret
!= -UNW_ENOMEM
) {
305 snprintf(nbuf
, sizeof(nbuf
), "<unknown symbol>");
307 printf(" %s + %#llx [ip=%#llx] [sp=%#llx]\n",
308 nbuf
, (long long)off
, (long long)ip
,
316 unw_destroy_addr_space(aspace
);
323 ptrace(PTRACE_DETACH
, pid
, NULL
, NULL
);
326 static int stack_trace_server(const struct server_id
*id
,
330 if (id
->vnn
== get_my_vnn()) {
331 print_stack_trace(procid_to_pid(id
), (int *)priv
);
336 static bool do_daemon_stack_trace(struct tevent_context
*ev_ctx
,
337 struct messaging_context
*msg_ctx
,
338 const struct server_id pid
,
339 const int argc
, const char **argv
)
345 fprintf(stderr
, "Usage: smbcontrol <dest> stacktrace\n");
349 dest
= procid_to_pid(&pid
);
352 /* It would be nice to be able to make sure that this PID is
353 * the PID of a smbd/winbind/nmbd process, not some random PID
354 * the user liked the look of. It doesn't seem like it's worth
355 * the effort at the moment, however.
357 print_stack_trace(dest
, &count
);
359 serverid_traverse_read(stack_trace_server
, &count
);
365 #else /* defined(HAVE_LIBUNWIND_PTRACE) && defined(HAVE_LINUX_PTRACE) */
367 static bool do_daemon_stack_trace(struct tevent_context
*ev_ctx
,
368 struct messaging_context
*msg_ctx
,
369 const struct server_id pid
,
370 const int argc
, const char **argv
)
373 "Daemon stack tracing is not supported on this platform\n");
377 #endif /* defined(HAVE_LIBUNWIND_PTRACE) && defined(HAVE_LINUX_PTRACE) */
379 /* Inject a fault (fatal signal) into a running smbd */
381 static bool do_inject_fault(struct tevent_context
*ev_ctx
,
382 struct messaging_context
*msg_ctx
,
383 const struct server_id pid
,
384 const int argc
, const char **argv
)
387 fprintf(stderr
, "Usage: smbcontrol <dest> inject "
388 "<bus|hup|term|internal|segv>\n");
393 fprintf(stderr
, "Fault injection is only available in "
394 "developer builds\n");
396 #else /* DEVELOPER */
400 if (strcmp(argv
[1], "bus") == 0) {
402 } else if (strcmp(argv
[1], "hup") == 0) {
404 } else if (strcmp(argv
[1], "term") == 0) {
406 } else if (strcmp(argv
[1], "segv") == 0) {
408 } else if (strcmp(argv
[1], "internal") == 0) {
409 /* Force an internal error, ie. an unclean exit. */
412 fprintf(stderr
, "Unknown signal name '%s'\n", argv
[1]);
416 return send_message(msg_ctx
, pid
, MSG_SMB_INJECT_FAULT
,
419 #endif /* DEVELOPER */
422 /* Force a browser election */
424 static bool do_election(struct tevent_context
*ev_ctx
,
425 struct messaging_context
*msg_ctx
,
426 const struct server_id pid
,
427 const int argc
, const char **argv
)
430 fprintf(stderr
, "Usage: smbcontrol <dest> force-election\n");
434 return send_message(msg_ctx
, pid
, MSG_FORCE_ELECTION
, NULL
, 0);
437 /* Ping a samba daemon process */
439 static void pong_cb(struct messaging_context
*msg
,
442 struct server_id pid
,
445 char *src_string
= server_id_str(NULL
, &pid
);
446 printf("PONG from pid %s\n", src_string
);
447 TALLOC_FREE(src_string
);
451 static bool do_ping(struct tevent_context
*ev_ctx
,
452 struct messaging_context
*msg_ctx
,
453 const struct server_id pid
,
454 const int argc
, const char **argv
)
457 fprintf(stderr
, "Usage: smbcontrol <dest> ping\n");
461 /* Send a message and register our interest in a reply */
463 if (!send_message(msg_ctx
, pid
, MSG_PING
, NULL
, 0))
466 messaging_register(msg_ctx
, NULL
, MSG_PONG
, pong_cb
);
468 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
470 /* No replies were received within the timeout period */
472 if (num_replies
== 0)
473 printf("No replies received\n");
475 messaging_deregister(msg_ctx
, MSG_PONG
, NULL
);
480 /* Set profiling options */
482 static bool do_profile(struct tevent_context
*ev_ctx
,
483 struct messaging_context
*msg_ctx
,
484 const struct server_id pid
,
485 const int argc
, const char **argv
)
490 fprintf(stderr
, "Usage: smbcontrol <dest> profile "
491 "<off|count|on|flush>\n");
495 if (strcmp(argv
[1], "off") == 0) {
497 } else if (strcmp(argv
[1], "count") == 0) {
499 } else if (strcmp(argv
[1], "on") == 0) {
501 } else if (strcmp(argv
[1], "flush") == 0) {
504 fprintf(stderr
, "Unknown profile command '%s'\n", argv
[1]);
508 return send_message(msg_ctx
, pid
, MSG_PROFILE
, &v
, sizeof(int));
511 /* Return the profiling level */
513 static void profilelevel_cb(struct messaging_context
*msg_ctx
,
516 struct server_id pid
,
524 if (data
->length
!= sizeof(int)) {
525 fprintf(stderr
, "invalid message length %ld returned\n",
526 (unsigned long)data
->length
);
530 memcpy(&level
, data
->data
, sizeof(int));
543 s
= "count and time";
550 printf("Profiling %s on pid %u\n",s
,(unsigned int)procid_to_pid(&pid
));
553 static void profilelevel_rqst(struct messaging_context
*msg_ctx
,
556 struct server_id pid
,
561 /* Send back a dummy reply */
563 send_message(msg_ctx
, pid
, MSG_PROFILELEVEL
, &v
, sizeof(int));
566 static bool do_profilelevel(struct tevent_context
*ev_ctx
,
567 struct messaging_context
*msg_ctx
,
568 const struct server_id pid
,
569 const int argc
, const char **argv
)
572 fprintf(stderr
, "Usage: smbcontrol <dest> profilelevel\n");
576 /* Send a message and register our interest in a reply */
578 if (!send_message(msg_ctx
, pid
, MSG_REQ_PROFILELEVEL
, NULL
, 0))
581 messaging_register(msg_ctx
, NULL
, MSG_PROFILELEVEL
, profilelevel_cb
);
582 messaging_register(msg_ctx
, NULL
, MSG_REQ_PROFILELEVEL
,
585 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
587 /* No replies were received within the timeout period */
589 if (num_replies
== 0)
590 printf("No replies received\n");
592 messaging_deregister(msg_ctx
, MSG_PROFILE
, NULL
);
597 /* Display debug level settings */
599 static bool do_debuglevel(struct tevent_context
*ev_ctx
,
600 struct messaging_context
*msg_ctx
,
601 const struct server_id pid
,
602 const int argc
, const char **argv
)
605 fprintf(stderr
, "Usage: smbcontrol <dest> debuglevel\n");
609 /* Send a message and register our interest in a reply */
611 if (!send_message(msg_ctx
, pid
, MSG_REQ_DEBUGLEVEL
, NULL
, 0))
614 messaging_register(msg_ctx
, NULL
, MSG_DEBUGLEVEL
, print_pid_string_cb
);
616 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
618 /* No replies were received within the timeout period */
620 if (num_replies
== 0)
621 printf("No replies received\n");
623 messaging_deregister(msg_ctx
, MSG_DEBUGLEVEL
, NULL
);
628 /* Send a print notify message */
630 static bool do_printnotify(struct tevent_context
*ev_ctx
,
631 struct messaging_context
*msg_ctx
,
632 const struct server_id pid
,
633 const int argc
, const char **argv
)
637 /* Check for subcommand */
640 fprintf(stderr
, "Must specify subcommand:\n");
641 fprintf(stderr
, "\tqueuepause <printername>\n");
642 fprintf(stderr
, "\tqueueresume <printername>\n");
643 fprintf(stderr
, "\tjobpause <printername> <unix jobid>\n");
644 fprintf(stderr
, "\tjobresume <printername> <unix jobid>\n");
645 fprintf(stderr
, "\tjobdelete <printername> <unix jobid>\n");
646 fprintf(stderr
, "\tprinter <printername> <comment|port|"
647 "driver> <value>\n");
654 if (strcmp(cmd
, "queuepause") == 0) {
657 fprintf(stderr
, "Usage: smbcontrol <dest> printnotify"
658 " queuepause <printername>\n");
662 notify_printer_status_byname(ev_ctx
, msg_ctx
, argv
[2],
663 PRINTER_STATUS_PAUSED
);
667 } else if (strcmp(cmd
, "queueresume") == 0) {
670 fprintf(stderr
, "Usage: smbcontrol <dest> printnotify"
671 " queuereume <printername>\n");
675 notify_printer_status_byname(ev_ctx
, msg_ctx
, argv
[2],
680 } else if (strcmp(cmd
, "jobpause") == 0) {
684 fprintf(stderr
, "Usage: smbcontrol <dest> printnotify"
685 " jobpause <printername> <unix-jobid>\n");
689 jobid
= atoi(argv
[3]);
691 notify_job_status_byname(
693 argv
[2], jobid
, JOB_STATUS_PAUSED
,
694 SPOOLSS_NOTIFY_MSG_UNIX_JOBID
);
698 } else if (strcmp(cmd
, "jobresume") == 0) {
702 fprintf(stderr
, "Usage: smbcontrol <dest> printnotify"
703 " jobpause <printername> <unix-jobid>\n");
707 jobid
= atoi(argv
[3]);
709 notify_job_status_byname(
711 argv
[2], jobid
, JOB_STATUS_QUEUED
,
712 SPOOLSS_NOTIFY_MSG_UNIX_JOBID
);
716 } else if (strcmp(cmd
, "jobdelete") == 0) {
720 fprintf(stderr
, "Usage: smbcontrol <dest> printnotify"
721 " jobpause <printername> <unix-jobid>\n");
725 jobid
= atoi(argv
[3]);
727 notify_job_status_byname(
729 argv
[2], jobid
, JOB_STATUS_DELETING
,
730 SPOOLSS_NOTIFY_MSG_UNIX_JOBID
);
732 notify_job_status_byname(
734 argv
[2], jobid
, JOB_STATUS_DELETING
|
736 SPOOLSS_NOTIFY_MSG_UNIX_JOBID
);
740 } else if (strcmp(cmd
, "printer") == 0) {
744 fprintf(stderr
, "Usage: smbcontrol <dest> printnotify "
745 "printer <printername> <comment|port|driver> "
750 if (strcmp(argv
[3], "comment") == 0) {
751 attribute
= PRINTER_NOTIFY_FIELD_COMMENT
;
752 } else if (strcmp(argv
[3], "port") == 0) {
753 attribute
= PRINTER_NOTIFY_FIELD_PORT_NAME
;
754 } else if (strcmp(argv
[3], "driver") == 0) {
755 attribute
= PRINTER_NOTIFY_FIELD_DRIVER_NAME
;
757 fprintf(stderr
, "Invalid printer command '%s'\n",
762 notify_printer_byname(ev_ctx
, msg_ctx
, argv
[2], attribute
,
763 discard_const_p(char, argv
[4]));
768 fprintf(stderr
, "Invalid subcommand '%s'\n", cmd
);
772 print_notify_send_messages(msg_ctx
, 0);
778 static bool do_closeshare(struct tevent_context
*ev_ctx
,
779 struct messaging_context
*msg_ctx
,
780 const struct server_id pid
,
781 const int argc
, const char **argv
)
784 fprintf(stderr
, "Usage: smbcontrol <dest> close-share "
789 return send_message(msg_ctx
, pid
, MSG_SMB_FORCE_TDIS
, argv
[1],
790 strlen(argv
[1]) + 1);
793 /* Kill a client by IP address */
794 static bool do_kill_client_by_ip(struct tevent_context
*ev_ctx
,
795 struct messaging_context
*msg_ctx
,
796 const struct server_id pid
,
797 const int argc
, const char **argv
)
800 fprintf(stderr
, "Usage: smbcontrol <dest> kill-client-ip "
805 if (!is_ipaddress_v4(argv
[1]) && !is_ipaddress_v6(argv
[1])) {
806 fprintf(stderr
, "%s is not a valid IP address!\n", argv
[1]);
810 return send_message(msg_ctx
, pid
, MSG_SMB_KILL_CLIENT_IP
,
811 argv
[1], strlen(argv
[1]) + 1);
814 /* Tell winbindd an IP got dropped */
816 static bool do_ip_dropped(struct tevent_context
*ev_ctx
,
817 struct messaging_context
*msg_ctx
,
818 const struct server_id pid
,
819 const int argc
, const char **argv
)
822 fprintf(stderr
, "Usage: smbcontrol <dest> ip-dropped "
827 return send_message(msg_ctx
, pid
, MSG_WINBIND_IP_DROPPED
, argv
[1],
828 strlen(argv
[1]) + 1);
831 /* force a blocking lock retry */
833 static bool do_lockretry(struct tevent_context
*ev_ctx
,
834 struct messaging_context
*msg_ctx
,
835 const struct server_id pid
,
836 const int argc
, const char **argv
)
839 fprintf(stderr
, "Usage: smbcontrol <dest> lockretry\n");
843 return send_message(msg_ctx
, pid
, MSG_SMB_UNLOCK
, NULL
, 0);
846 /* force a validation of all brl entries, including re-sends. */
848 static bool do_brl_revalidate(struct tevent_context
*ev_ctx
,
849 struct messaging_context
*msg_ctx
,
850 const struct server_id pid
,
851 const int argc
, const char **argv
)
854 fprintf(stderr
, "Usage: smbcontrol <dest> brl-revalidate\n");
858 return send_message(msg_ctx
, pid
, MSG_SMB_BRL_VALIDATE
, NULL
, 0);
861 /* Display talloc pool usage */
863 static bool do_poolusage(struct tevent_context
*ev_ctx
,
864 struct messaging_context
*msg_ctx
,
865 const struct server_id pid
,
866 const int argc
, const char **argv
)
869 fprintf(stderr
, "Usage: smbcontrol <dest> pool-usage\n");
873 messaging_register(msg_ctx
, NULL
, MSG_POOL_USAGE
, print_string_cb
);
875 /* Send a message and register our interest in a reply */
877 if (!send_message(msg_ctx
, pid
, MSG_REQ_POOL_USAGE
, NULL
, 0))
880 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
882 /* No replies were received within the timeout period */
884 if (num_replies
== 0)
885 printf("No replies received\n");
887 messaging_deregister(msg_ctx
, MSG_POOL_USAGE
, NULL
);
892 /* Perform a dmalloc mark */
894 static bool do_dmalloc_mark(struct tevent_context
*ev_ctx
,
895 struct messaging_context
*msg_ctx
,
896 const struct server_id pid
,
897 const int argc
, const char **argv
)
900 fprintf(stderr
, "Usage: smbcontrol <dest> dmalloc-mark\n");
904 return send_message(msg_ctx
, pid
, MSG_REQ_DMALLOC_MARK
, NULL
, 0);
907 /* Perform a dmalloc changed */
909 static bool do_dmalloc_changed(struct tevent_context
*ev_ctx
,
910 struct messaging_context
*msg_ctx
,
911 const struct server_id pid
,
912 const int argc
, const char **argv
)
915 fprintf(stderr
, "Usage: smbcontrol <dest> "
916 "dmalloc-log-changed\n");
920 return send_message(msg_ctx
, pid
, MSG_REQ_DMALLOC_LOG_CHANGED
,
924 static void print_uint32_cb(struct messaging_context
*msg
, void *private_data
,
925 uint32_t msg_type
, struct server_id pid
,
928 uint32_t num_children
;
930 if (data
->length
!= sizeof(uint32_t)) {
931 printf("Invalid response: %d bytes long\n",
935 num_children
= IVAL(data
->data
, 0);
936 printf("%u children\n", (unsigned)num_children
);
941 static bool do_num_children(struct tevent_context
*ev_ctx
,
942 struct messaging_context
*msg_ctx
,
943 const struct server_id pid
,
944 const int argc
, const char **argv
)
947 fprintf(stderr
, "Usage: smbcontrol <dest> num-children\n");
951 messaging_register(msg_ctx
, NULL
, MSG_SMB_NUM_CHILDREN
,
954 /* Send a message and register our interest in a reply */
956 if (!send_message(msg_ctx
, pid
, MSG_SMB_TELL_NUM_CHILDREN
, NULL
, 0))
959 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
961 /* No replies were received within the timeout period */
963 if (num_replies
== 0)
964 printf("No replies received\n");
966 messaging_deregister(msg_ctx
, MSG_SMB_NUM_CHILDREN
, NULL
);
971 /* Shutdown a server process */
973 static bool do_shutdown(struct tevent_context
*ev_ctx
,
974 struct messaging_context
*msg_ctx
,
975 const struct server_id pid
,
976 const int argc
, const char **argv
)
979 fprintf(stderr
, "Usage: smbcontrol <dest> shutdown\n");
983 return send_message(msg_ctx
, pid
, MSG_SHUTDOWN
, NULL
, 0);
986 /* Notify a driver upgrade */
988 static bool do_drvupgrade(struct tevent_context
*ev_ctx
,
989 struct messaging_context
*msg_ctx
,
990 const struct server_id pid
,
991 const int argc
, const char **argv
)
994 fprintf(stderr
, "Usage: smbcontrol <dest> drvupgrade "
999 return send_message(msg_ctx
, pid
, MSG_PRINTER_DRVUPGRADE
, argv
[1],
1000 strlen(argv
[1]) + 1);
1003 static bool do_winbind_online(struct tevent_context
*ev_ctx
,
1004 struct messaging_context
*msg_ctx
,
1005 const struct server_id pid
,
1006 const int argc
, const char **argv
)
1011 fprintf(stderr
, "Usage: smbcontrol winbindd online\n");
1015 /* Remove the entry in the winbindd_cache tdb to tell a later
1016 starting winbindd that we're online. */
1018 tdb
= tdb_open_log(state_path("winbindd_cache.tdb"), 0, TDB_DEFAULT
, O_RDWR
, 0600);
1020 fprintf(stderr
, "Cannot open the tdb %s for writing.\n",
1021 state_path("winbindd_cache.tdb"));
1025 tdb_delete_bystring(tdb
, "WINBINDD_OFFLINE");
1028 return send_message(msg_ctx
, pid
, MSG_WINBIND_ONLINE
, NULL
, 0);
1031 static bool do_winbind_offline(struct tevent_context
*ev_ctx
,
1032 struct messaging_context
*msg_ctx
,
1033 const struct server_id pid
,
1034 const int argc
, const char **argv
)
1041 fprintf(stderr
, "Usage: smbcontrol winbindd offline\n");
1045 /* Create an entry in the winbindd_cache tdb to tell a later
1046 starting winbindd that we're offline. We may actually create
1049 tdb
= tdb_open_log(state_path("winbindd_cache.tdb"),
1050 WINBINDD_CACHE_TDB_DEFAULT_HASH_SIZE
,
1051 TDB_DEFAULT
|TDB_INCOMPATIBLE_HASH
/* TDB_CLEAR_IF_FIRST */,
1052 O_RDWR
|O_CREAT
, 0600);
1055 fprintf(stderr
, "Cannot open the tdb %s for writing.\n",
1056 state_path("winbindd_cache.tdb"));
1060 /* There's a potential race condition that if a child
1061 winbindd detects a domain is online at the same time
1062 we're trying to tell it to go offline that it might
1063 delete the record we add between us adding it and
1064 sending the message. Minimize this by retrying up to
1067 for (retry
= 0; retry
< 5; retry
++) {
1073 SIVAL(buf
, 0, time(NULL
));
1077 tdb_store_bystring(tdb
, "WINBINDD_OFFLINE", d
, TDB_INSERT
);
1079 ret
= send_message(msg_ctx
, pid
, MSG_WINBIND_OFFLINE
,
1082 /* Check that the entry "WINBINDD_OFFLINE" still exists. */
1083 d
= tdb_fetch_bystring( tdb
, "WINBINDD_OFFLINE" );
1085 if (!d
.dptr
|| d
.dsize
!= 4) {
1087 DEBUG(10,("do_winbind_offline: offline state not set - retrying.\n"));
1098 static bool do_winbind_onlinestatus(struct tevent_context
*ev_ctx
,
1099 struct messaging_context
*msg_ctx
,
1100 const struct server_id pid
,
1101 const int argc
, const char **argv
)
1103 struct server_id myid
;
1105 myid
= messaging_server_id(msg_ctx
);
1108 fprintf(stderr
, "Usage: smbcontrol winbindd onlinestatus\n");
1112 messaging_register(msg_ctx
, NULL
, MSG_WINBIND_ONLINESTATUS
,
1113 print_pid_string_cb
);
1115 if (!send_message(msg_ctx
, pid
, MSG_WINBIND_ONLINESTATUS
, &myid
,
1119 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
1121 /* No replies were received within the timeout period */
1123 if (num_replies
== 0)
1124 printf("No replies received\n");
1126 messaging_deregister(msg_ctx
, MSG_WINBIND_ONLINESTATUS
, NULL
);
1131 static bool do_dump_event_list(struct tevent_context
*ev_ctx
,
1132 struct messaging_context
*msg_ctx
,
1133 const struct server_id pid
,
1134 const int argc
, const char **argv
)
1137 fprintf(stderr
, "Usage: smbcontrol <dest> dump-event-list\n");
1141 return send_message(msg_ctx
, pid
, MSG_DUMP_EVENT_LIST
, NULL
, 0);
1144 static bool do_winbind_dump_domain_list(struct tevent_context
*ev_ctx
,
1145 struct messaging_context
*msg_ctx
,
1146 const struct server_id pid
,
1147 const int argc
, const char **argv
)
1149 const char *domain
= NULL
;
1151 struct server_id myid
;
1152 uint8_t *buf
= NULL
;
1155 myid
= messaging_server_id(msg_ctx
);
1157 if (argc
< 1 || argc
> 2) {
1158 fprintf(stderr
, "Usage: smbcontrol <dest> dump-domain-list "
1165 domain_len
= strlen(argv
[1]) + 1;
1168 messaging_register(msg_ctx
, NULL
, MSG_WINBIND_DUMP_DOMAIN_LIST
,
1169 print_pid_string_cb
);
1171 buf_len
= sizeof(myid
)+domain_len
;
1172 buf
= SMB_MALLOC_ARRAY(uint8_t, buf_len
);
1177 memcpy(buf
, &myid
, sizeof(myid
));
1178 memcpy(&buf
[sizeof(myid
)], domain
, domain_len
);
1180 if (!send_message(msg_ctx
, pid
, MSG_WINBIND_DUMP_DOMAIN_LIST
,
1187 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
1189 /* No replies were received within the timeout period */
1192 if (num_replies
== 0) {
1193 printf("No replies received\n");
1196 messaging_deregister(msg_ctx
, MSG_WINBIND_DUMP_DOMAIN_LIST
, NULL
);
1201 static void winbind_validate_cache_cb(struct messaging_context
*msg
,
1204 struct server_id pid
,
1207 char *src_string
= server_id_str(NULL
, &pid
);
1208 printf("Winbindd cache is %svalid. (answer from pid %s)\n",
1209 (*(data
->data
) == 0 ? "" : "NOT "), src_string
);
1210 TALLOC_FREE(src_string
);
1214 static bool do_winbind_validate_cache(struct tevent_context
*ev_ctx
,
1215 struct messaging_context
*msg_ctx
,
1216 const struct server_id pid
,
1217 const int argc
, const char **argv
)
1219 struct server_id myid
;
1221 myid
= messaging_server_id(msg_ctx
);
1224 fprintf(stderr
, "Usage: smbcontrol winbindd validate-cache\n");
1228 messaging_register(msg_ctx
, NULL
, MSG_WINBIND_VALIDATE_CACHE
,
1229 winbind_validate_cache_cb
);
1231 if (!send_message(msg_ctx
, pid
, MSG_WINBIND_VALIDATE_CACHE
, &myid
,
1236 wait_replies(ev_ctx
, msg_ctx
, procid_to_pid(&pid
) == 0);
1238 if (num_replies
== 0) {
1239 printf("No replies received\n");
1242 messaging_deregister(msg_ctx
, MSG_WINBIND_VALIDATE_CACHE
, NULL
);
1247 static bool do_reload_config(struct tevent_context
*ev_ctx
,
1248 struct messaging_context
*msg_ctx
,
1249 const struct server_id pid
,
1250 const int argc
, const char **argv
)
1253 fprintf(stderr
, "Usage: smbcontrol <dest> reload-config\n");
1257 return send_message(msg_ctx
, pid
, MSG_SMB_CONF_UPDATED
, NULL
, 0);
1260 static bool do_reload_printers(struct tevent_context
*ev_ctx
,
1261 struct messaging_context
*msg_ctx
,
1262 const struct server_id pid
,
1263 const int argc
, const char **argv
)
1266 fprintf(stderr
, "Usage: smbcontrol <dest> reload-printers\n");
1270 return send_message(msg_ctx
, pid
, MSG_PRINTER_PCAP
, NULL
, 0);
1273 static void my_make_nmb_name( struct nmb_name
*n
, const char *name
, int type
)
1276 memset( (char *)n
, '\0', sizeof(struct nmb_name
) );
1277 fstrcpy(unix_name
, name
);
1278 (void)strupper_m(unix_name
);
1279 push_ascii(n
->name
, unix_name
, sizeof(n
->name
), STR_TERMINATE
);
1280 n
->name_type
= (unsigned int)type
& 0xFF;
1281 push_ascii(n
->scope
, lp_netbios_scope(), 64, STR_TERMINATE
);
1284 static bool do_nodestatus(struct tevent_context
*ev_ctx
,
1285 struct messaging_context
*msg_ctx
,
1286 const struct server_id pid
,
1287 const int argc
, const char **argv
)
1289 struct packet_struct p
;
1292 fprintf(stderr
, "Usage: smbcontrol nmbd nodestatus <ip>\n");
1298 p
.ip
= interpret_addr2(argv
[1]);
1300 p
.packet_type
= NMB_PACKET
;
1302 p
.packet
.nmb
.header
.name_trn_id
= 10;
1303 p
.packet
.nmb
.header
.opcode
= 0;
1304 p
.packet
.nmb
.header
.response
= False
;
1305 p
.packet
.nmb
.header
.nm_flags
.bcast
= False
;
1306 p
.packet
.nmb
.header
.nm_flags
.recursion_available
= False
;
1307 p
.packet
.nmb
.header
.nm_flags
.recursion_desired
= False
;
1308 p
.packet
.nmb
.header
.nm_flags
.trunc
= False
;
1309 p
.packet
.nmb
.header
.nm_flags
.authoritative
= False
;
1310 p
.packet
.nmb
.header
.rcode
= 0;
1311 p
.packet
.nmb
.header
.qdcount
= 1;
1312 p
.packet
.nmb
.header
.ancount
= 0;
1313 p
.packet
.nmb
.header
.nscount
= 0;
1314 p
.packet
.nmb
.header
.arcount
= 0;
1315 my_make_nmb_name(&p
.packet
.nmb
.question
.question_name
, "*", 0x00);
1316 p
.packet
.nmb
.question
.question_type
= 0x21;
1317 p
.packet
.nmb
.question
.question_class
= 0x1;
1319 return send_message(msg_ctx
, pid
, MSG_SEND_PACKET
, &p
, sizeof(p
));
1322 static bool do_notify_cleanup(struct tevent_context
*ev_ctx
,
1323 struct messaging_context
*msg_ctx
,
1324 const struct server_id pid
,
1325 const int argc
, const char **argv
)
1328 fprintf(stderr
, "Usage: smbcontrol smbd notify-cleanup\n");
1331 return send_message(msg_ctx
, pid
, MSG_SMB_NOTIFY_CLEANUP
, NULL
, 0);
1334 /* A list of message type supported */
1336 static const struct {
1337 const char *name
; /* Option name */
1338 bool (*fn
)(struct tevent_context
*ev_ctx
,
1339 struct messaging_context
*msg_ctx
,
1340 const struct server_id pid
,
1341 const int argc
, const char **argv
);
1342 const char *help
; /* Short help text */
1344 { "debug", do_debug
, "Set debuglevel" },
1345 { "idmap", do_idmap
, "Manipulate idmap cache" },
1346 { "force-election", do_election
,
1347 "Force a browse election" },
1348 { "ping", do_ping
, "Elicit a response" },
1349 { "profile", do_profile
, "" },
1350 { "inject", do_inject_fault
,
1351 "Inject a fatal signal into a running smbd"},
1352 { "stacktrace", do_daemon_stack_trace
,
1353 "Display a stack trace of a daemon" },
1354 { "profilelevel", do_profilelevel
, "" },
1355 { "debuglevel", do_debuglevel
, "Display current debuglevels" },
1356 { "printnotify", do_printnotify
, "Send a print notify message" },
1357 { "close-share", do_closeshare
, "Forcibly disconnect a share" },
1358 { "kill-client-ip", do_kill_client_by_ip
,
1359 "Forcibly disconnect a client with a specific IP address" },
1360 { "ip-dropped", do_ip_dropped
, "Tell winbind that an IP got dropped" },
1361 { "lockretry", do_lockretry
, "Force a blocking lock retry" },
1362 { "brl-revalidate", do_brl_revalidate
, "Revalidate all brl entries" },
1363 { "pool-usage", do_poolusage
, "Display talloc memory usage" },
1364 { "dmalloc-mark", do_dmalloc_mark
, "" },
1365 { "dmalloc-log-changed", do_dmalloc_changed
, "" },
1366 { "shutdown", do_shutdown
, "Shut down daemon" },
1367 { "drvupgrade", do_drvupgrade
, "Notify a printer driver has changed" },
1368 { "reload-config", do_reload_config
, "Force smbd or winbindd to reload config file"},
1369 { "reload-printers", do_reload_printers
, "Force smbd to reload printers"},
1370 { "nodestatus", do_nodestatus
, "Ask nmbd to do a node status request"},
1371 { "online", do_winbind_online
, "Ask winbind to go into online state"},
1372 { "offline", do_winbind_offline
, "Ask winbind to go into offline state"},
1373 { "onlinestatus", do_winbind_onlinestatus
, "Request winbind online status"},
1374 { "dump-event-list", do_dump_event_list
, "Dump event list"},
1375 { "validate-cache" , do_winbind_validate_cache
,
1376 "Validate winbind's credential cache" },
1377 { "dump-domain-list", do_winbind_dump_domain_list
, "Dump winbind domain list"},
1378 { "notify-cleanup", do_notify_cleanup
},
1379 { "num-children", do_num_children
,
1380 "Print number of smbd child processes" },
1381 { "noop", do_noop
, "Do nothing" },
1385 /* Display usage information */
1387 static void usage(poptContext pc
)
1391 poptPrintHelp(pc
, stderr
, 0);
1393 fprintf(stderr
, "\n");
1394 fprintf(stderr
, "<destination> is one of \"nmbd\", \"smbd\", \"winbindd\" or a "
1397 fprintf(stderr
, "\n");
1398 fprintf(stderr
, "<message-type> is one of:\n");
1400 for (i
= 0; msg_types
[i
].name
; i
++)
1401 fprintf(stderr
, "\t%-30s%s\n", msg_types
[i
].name
,
1404 fprintf(stderr
, "\n");
1409 /* Return the pid number for a string destination */
1411 static struct server_id
parse_dest(struct messaging_context
*msg
,
1414 struct server_id result
= {-1};
1417 /* Zero is a special return value for broadcast to all processes */
1419 if (strequal(dest
, "all")) {
1420 return interpret_pid(MSG_BROADCAST_PID_STR
);
1423 /* Try self - useful for testing */
1425 if (strequal(dest
, "self")) {
1426 return messaging_server_id(msg
);
1429 /* Fix winbind typo. */
1430 if (strequal(dest
, "winbind")) {
1434 /* Check for numeric pid number */
1435 result
= interpret_pid(dest
);
1437 /* Zero isn't valid if not "all". */
1438 if (result
.pid
&& procid_valid(&result
)) {
1442 /* Look up other destinations in pidfile directory */
1444 if ((pid
= pidfile_pid(lp_pid_directory(), dest
)) != 0) {
1445 return pid_to_procid(pid
);
1448 fprintf(stderr
,"Can't find pid for destination '%s'\n", dest
);
1453 /* Execute smbcontrol command */
1455 static bool do_command(struct tevent_context
*ev_ctx
,
1456 struct messaging_context
*msg_ctx
,
1457 int argc
, const char **argv
)
1459 const char *dest
= argv
[0], *command
= argv
[1];
1460 struct server_id pid
;
1463 /* Check destination */
1465 pid
= parse_dest(msg_ctx
, dest
);
1466 if (!procid_valid(&pid
)) {
1472 for (i
= 0; msg_types
[i
].name
; i
++) {
1473 if (strequal(command
, msg_types
[i
].name
))
1474 return msg_types
[i
].fn(ev_ctx
, msg_ctx
, pid
,
1475 argc
- 1, argv
+ 1);
1478 fprintf(stderr
, "smbcontrol: unknown command '%s'\n", command
);
1483 static void smbcontrol_help(poptContext pc
,
1484 enum poptCallbackReason preason
,
1485 struct poptOption
* poption
,
1489 if (poption
->shortName
!= '?') {
1490 poptPrintUsage(pc
, stdout
, 0);
1498 struct poptOption help_options
[] = {
1499 { NULL
, '\0', POPT_ARG_CALLBACK
, (void *)&smbcontrol_help
, '\0',
1501 { "help", '?', 0, NULL
, '?', "Show this help message", NULL
},
1502 { "usage", '\0', 0, NULL
, 'u', "Display brief usage message", NULL
},
1508 int main(int argc
, const char **argv
)
1512 struct tevent_context
*evt_ctx
;
1513 struct messaging_context
*msg_ctx
;
1515 static struct poptOption long_options
[] = {
1517 { NULL
, '\0', POPT_ARG_INCLUDE_TABLE
, help_options
,
1518 0, "Help options:", NULL
},
1519 { "timeout", 't', POPT_ARG_INT
, &timeout
, 't',
1520 "Set timeout value in seconds", "TIMEOUT" },
1525 TALLOC_CTX
*frame
= talloc_stackframe();
1530 setup_logging(argv
[0], DEBUG_STDOUT
);
1532 /* Parse command line arguments using popt */
1534 pc
= poptGetContext(
1535 "smbcontrol", argc
, (const char **)argv
, long_options
, 0);
1537 poptSetOtherOptionHelp(pc
, "[OPTION...] <destination> <message-type> "
1543 while ((opt
= poptGetNextOpt(pc
)) != -1) {
1545 case 't': /* --timeout */
1548 fprintf(stderr
, "Invalid option\n");
1549 poptPrintHelp(pc
, stderr
, 0);
1554 /* We should now have the remaining command line arguments in
1555 argv. The argc parameter should have been decremented to the
1556 correct value in the above switch statement. */
1558 argv
= (const char **)poptGetArgs(pc
);
1561 while (argv
[argc
] != NULL
) {
1569 lp_load_global(get_dyn_CONFIGFILE());
1571 /* Need to invert sense of return code -- samba
1572 * routines mostly return True==1 for success, but
1575 if (!(evt_ctx
= samba_tevent_context_init(NULL
)) ||
1576 !(msg_ctx
= messaging_init(NULL
, evt_ctx
))) {
1577 fprintf(stderr
, "could not init messaging context\n");
1582 ret
= !do_command(evt_ctx
, msg_ctx
, argc
, argv
);