2 Unix SMB/CIFS implementation.
4 process model: standard (1 process per client connection)
6 Copyright (C) Andrew Tridgell 1992-2005
7 Copyright (C) James J Myers 2003 <myersjj@samba.org>
8 Copyright (C) Stefan (metze) Metzmacher 2004
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
25 #include "lib/events/events.h"
26 #include "smbd/process_model.h"
27 #include "system/filesys.h"
28 #include "cluster/cluster.h"
29 #include "param/param.h"
31 #include "lib/messaging/messaging.h"
32 #include "lib/util/debug.h"
33 #include "source3/lib/messages_dgm.h"
35 static unsigned connections_active
= 0;
36 static unsigned smbd_max_processes
= 0;
38 struct standard_child_state
{
43 struct tevent_fd
*from_child_fde
;
46 NTSTATUS
process_model_standard_init(TALLOC_CTX
*);
47 struct process_context
{
50 bool inhibit_fork_on_accept
;
51 bool forked_on_accept
;
55 called when the process model is selected
57 static void standard_model_init(void)
61 static void sighup_signal_handler(struct tevent_context
*ev
,
62 struct tevent_signal
*se
,
63 int signum
, int count
, void *siginfo
,
66 debug_schedule_reopen_logs();
69 static void sigterm_signal_handler(struct tevent_context
*ev
,
70 struct tevent_signal
*se
,
71 int signum
, int count
, void *siginfo
,
75 if (getpgrp() == getpid()) {
77 * We're the process group leader, send
78 * SIGTERM to our process group.
80 DBG_ERR("SIGTERM: killing children\n");
81 kill(-getpgrp(), SIGTERM
);
84 DBG_ERR("Exiting pid %u on SIGTERM\n", (unsigned int)getpid());
90 handle EOF on the parent-to-all-children pipe in the child
92 static void standard_pipe_handler(struct tevent_context
*event_ctx
, struct tevent_fd
*fde
,
93 uint16_t flags
, void *private_data
)
95 DBG_DEBUG("Child %d exiting\n", (int)getpid());
96 talloc_free(event_ctx
);
101 handle EOF on the child pipe in the parent, so we know when a
102 process terminates without using SIGCHLD or waiting on all possible pids.
104 We need to ensure we do not ignore SIGCHLD because we need it to
105 work to get a valid error code from samba_runcmd_*().
107 static void standard_child_pipe_handler(struct tevent_context
*ev
,
108 struct tevent_fd
*fde
,
112 struct standard_child_state
*state
113 = talloc_get_type_abort(private_data
, struct standard_child_state
);
117 messaging_dgm_cleanup(state
->pid
);
119 /* the child has closed the pipe, assume its dead */
121 pid
= waitpid(state
->pid
, &status
, 0);
123 if (pid
!= state
->pid
) {
124 if (errno
== ECHILD
) {
126 * this happens when the
127 * parent has set SIGCHLD to
128 * SIG_IGN. In that case we
130 * information for the child
131 * via its logging. We should
132 * stop using SIG_IGN on
133 * SIGCHLD in the standard
136 DBG_ERR("Error in waitpid() unexpectedly got ECHILD "
137 "for child %d (%s) - %s, someone has set SIGCHLD "
139 (int)state
->pid
, state
->name
,
144 DBG_ERR("Error in waitpid() for child %d (%s) - %s \n",
145 (int)state
->pid
, state
->name
, strerror(errno
));
151 if (WIFEXITED(status
)) {
152 status
= WEXITSTATUS(status
);
154 DBG_ERR("Child %d (%s) exited with status %d\n",
155 (int)state
->pid
, state
->name
, status
);
157 } else if (WIFSIGNALED(status
)) {
158 status
= WTERMSIG(status
);
159 DBG_ERR("Child %d (%s) terminated with signal %d\n",
160 (int)state
->pid
, state
->name
, status
);
164 if (smbd_max_processes
> 0) {
165 if (connections_active
< 1) {
166 DBG_ERR("Number of active connections "
167 "less than 1 (%d)\n",
169 connections_active
= 1;
171 connections_active
--;
176 static struct standard_child_state
*setup_standard_child_pipe(struct tevent_context
*ev
,
179 struct standard_child_state
*state
;
180 int parent_child_pipe
[2];
184 * Prepare a pipe to allow us to know when the child exits,
185 * because it will trigger a read event on this private
188 * We do all this before the accept and fork(), so we can
189 * clean up if it fails.
191 state
= talloc_zero(ev
, struct standard_child_state
);
200 state
->name
= talloc_strdup(state
, name
);
201 if (state
->name
== NULL
) {
206 ret
= pipe(parent_child_pipe
);
208 DBG_ERR("Failed to create parent-child pipe to handle "
209 "SIGCHLD to track new process for socket\n");
214 smb_set_close_on_exec(parent_child_pipe
[0]);
215 smb_set_close_on_exec(parent_child_pipe
[1]);
217 state
->from_child_fd
= parent_child_pipe
[0];
218 state
->to_parent_fd
= parent_child_pipe
[1];
221 * The basic purpose of calling this handler is to ensure we
222 * call waitpid() and so avoid zombies (now that we no longer
223 * user SIGIGN on for SIGCHLD), but it also allows us to clean
224 * up other resources in the future.
226 state
->from_child_fde
= tevent_add_fd(ev
, state
,
227 state
->from_child_fd
,
229 standard_child_pipe_handler
,
231 if (state
->from_child_fde
== NULL
) {
235 tevent_fd_set_auto_close(state
->from_child_fde
);
241 called when a listening socket becomes readable.
243 static void standard_accept_connection(
244 struct tevent_context
*ev
,
245 struct loadparm_context
*lp_ctx
,
246 struct socket_context
*sock
,
247 void (*new_conn
)(struct tevent_context
*,
248 struct loadparm_context
*,
249 struct socket_context
*,
254 void *process_context
)
257 struct socket_context
*sock2
;
259 struct socket_address
*c
, *s
;
260 struct standard_child_state
*state
;
261 struct tevent_fd
*fde
= NULL
;
262 struct tevent_signal
*se
= NULL
;
263 struct process_context
*proc_ctx
= NULL
;
266 /* accept an incoming connection. */
267 status
= socket_accept(sock
, &sock2
);
268 if (!NT_STATUS_IS_OK(status
)) {
269 DBG_DEBUG("standard_accept_connection: accept: %s\n",
271 /* this looks strange, but is correct. We need to throttle
272 * things until the system clears enough resources to handle
279 proc_ctx
= talloc_get_type_abort(process_context
,
280 struct process_context
);
282 if (proc_ctx
->inhibit_fork_on_accept
) {
285 * Service does not support forking a new process on a
286 * new connection, either it's maintaining shared
287 * state or the overhead of forking a new process is a
288 * significant fraction of the response time.
290 talloc_steal(private_data
, sock2
);
291 new_conn(ev
, lp_ctx
, sock2
,
292 cluster_id(pid
, socket_get_fd(sock2
)), private_data
,
297 if (smbd_max_processes
> 0) {
298 if (connections_active
>= smbd_max_processes
) {
299 DBG_ERR("(%d) connections already active, "
300 "maximum is (%d). Dropping request\n",
304 * Drop the connection as we're overloaded at the moment
309 connections_active
++;
312 state
= setup_standard_child_pipe(ev
, NULL
);
319 close(state
->to_parent_fd
);
320 state
->to_parent_fd
= -1;
328 /* parent or error code ... */
330 /* go back to the event loop */
334 /* this leaves state->to_parent_fd open */
337 /* Now in the child code so indicate that we forked
338 * so the terminate code knows what to do
340 proc_ctx
->forked_on_accept
= true;
343 setproctitle("task[%s] standard worker", proc_ctx
->name
);
345 /* This is now the child code. We need a completely new event_context to work with */
347 if (tevent_re_initialise(ev
) != 0) {
348 smb_panic("Failed to re-initialise tevent after fork");
351 /* this will free all the listening sockets and all state that
352 is not associated with this new connection */
355 /* we don't care if the dup fails, as its only a select()
356 speed optimisation */
359 /* tdb needs special fork handling */
360 ldb_wrap_fork_hook();
362 /* Must be done after a fork() to reset messaging contexts. */
363 status
= imessaging_reinit_all();
364 if (!NT_STATUS_IS_OK(status
)) {
365 smb_panic("Failed to re-initialise imessaging after fork");
368 fde
= tevent_add_fd(ev
, ev
, proc_ctx
->from_parent_fd
, TEVENT_FD_READ
,
369 standard_pipe_handler
, NULL
);
371 smb_panic("Failed to add fd handler after fork");
374 se
= tevent_add_signal(ev
,
378 sighup_signal_handler
,
381 smb_panic("Failed to add SIGHUP handler after fork");
384 se
= tevent_add_signal(ev
,
388 sigterm_signal_handler
,
391 smb_panic("Failed to add SIGTERM handler after fork");
394 /* setup the process title */
395 c
= socket_get_peer_addr(sock2
, ev
);
396 s
= socket_get_my_addr(sock2
, ev
);
398 setproctitle("conn c[%s:%u] s[%s:%u] server_id[%d]",
399 c
->addr
, c
->port
, s
->addr
, s
->port
, (int)pid
);
404 /* setup this new connection. Cluster ID is PID based for this process model */
405 new_conn(ev
, lp_ctx
, sock2
, cluster_id(pid
, 0), private_data
,
408 /* we can't return to the top level here, as that event context is gone,
409 so we now process events in the new event context until there are no
411 tevent_loop_wait(ev
);
418 called to create a new server task
420 static void standard_new_task(struct tevent_context
*ev
,
421 struct loadparm_context
*lp_ctx
,
422 const char *service_name
,
423 struct task_server
*(*new_task
)(struct tevent_context
*, struct loadparm_context
*lp_ctx
, struct server_id
, void *, void *),
425 const struct service_details
*service_details
,
430 struct standard_child_state
*state
;
431 struct tevent_fd
*fde
= NULL
;
432 struct tevent_signal
*se
= NULL
;
433 struct process_context
*proc_ctx
= NULL
;
434 struct task_server
* task
= NULL
;
436 state
= setup_standard_child_pipe(ev
, service_name
);
444 close(state
->to_parent_fd
);
445 state
->to_parent_fd
= -1;
453 /* parent or error code ... go back to the event loop */
457 /* this leaves state->to_parent_fd open */
462 /* this will free all the listening sockets and all state that
463 is not associated with this new connection */
464 if (tevent_re_initialise(ev
) != 0) {
465 smb_panic("Failed to re-initialise tevent after fork");
468 /* ldb/tdb need special fork handling */
469 ldb_wrap_fork_hook();
471 /* Must be done after a fork() to reset messaging contexts. */
472 status
= imessaging_reinit_all();
473 if (!NT_STATUS_IS_OK(status
)) {
474 smb_panic("Failed to re-initialise imessaging after fork");
477 fde
= tevent_add_fd(ev
, ev
, from_parent_fd
, TEVENT_FD_READ
,
478 standard_pipe_handler
, NULL
);
480 smb_panic("Failed to add fd handler after fork");
483 se
= tevent_add_signal(ev
,
487 sighup_signal_handler
,
490 smb_panic("Failed to add SIGHUP handler after fork");
493 se
= tevent_add_signal(ev
,
497 sigterm_signal_handler
,
500 smb_panic("Failed to add SIGTERM handler after fork");
503 setproctitle("task[%s]", service_name
);
506 * Set up the process context to be passed through to the terminate
507 * and accept_connection functions
509 proc_ctx
= talloc(ev
, struct process_context
);
510 proc_ctx
->name
= talloc_strdup(ev
, service_name
);
511 proc_ctx
->from_parent_fd
= from_parent_fd
;
512 proc_ctx
->inhibit_fork_on_accept
=
513 service_details
->inhibit_fork_on_accept
;
514 proc_ctx
->forked_on_accept
= false;
516 smbd_max_processes
= lpcfg_max_smbd_processes(lp_ctx
);
518 /* setup this new task. Cluster ID is PID based for this process model */
519 task
= new_task(ev
, lp_ctx
, cluster_id(pid
, 0), private_data
, proc_ctx
);
521 * Currently we don't support the post_fork functionality in the
522 * standard model, i.e. it is only called here not after a new process
523 * is forked in standard_accept_connection.
525 if (task
!= NULL
&& service_details
->post_fork
!= NULL
) {
526 struct process_details pd
= initial_process_details
;
527 service_details
->post_fork(task
, &pd
);
531 /* we can't return to the top level here, as that event context is gone,
532 so we now process events in the new event context until there are no
534 tevent_loop_wait(ev
);
541 /* called when a task goes down */
542 static void standard_terminate_task(struct tevent_context
*ev
,
543 struct loadparm_context
*lp_ctx
,
546 void *process_context
)
554 /* called when a connection terminates*/
555 static void standard_terminate_connection(struct tevent_context
*ev
,
556 struct loadparm_context
*lp_ctx
,
558 void *process_context
)
560 struct process_context
*proc_ctx
= NULL
;
562 DBG_DEBUG("connection terminating reason[%s]\n", reason
);
563 if (process_context
== NULL
) {
564 smb_panic("Panicking process_context is NULL");
567 proc_ctx
= talloc_get_type(process_context
, struct process_context
);
568 if (proc_ctx
->forked_on_accept
== false) {
570 * The current task was not forked on accept, so it needs to
571 * keep running and process requests from other connections
576 * The current process was forked on accept to handle a single
577 * connection/request. That request has now finished and the process
581 /* this reload_charcnv() has the effect of freeing the iconv context memory,
582 which makes leak checking easier */
583 reload_charcnv(lp_ctx
);
585 /* Always free event context last before exit. */
588 /* terminate this process */
591 /* called to set a title of a task or connection */
592 static void standard_set_title(struct tevent_context
*ev
, const char *title
)
595 setproctitle("%s", title
);
601 static const struct model_ops standard_ops
= {
603 .model_init
= standard_model_init
,
604 .accept_connection
= standard_accept_connection
,
605 .new_task
= standard_new_task
,
606 .terminate_task
= standard_terminate_task
,
607 .terminate_connection
= standard_terminate_connection
,
608 .set_title
= standard_set_title
,
612 initialise the standard process model, registering ourselves with the process model subsystem
614 NTSTATUS
process_model_standard_init(TALLOC_CTX
*ctx
)
616 return register_process_model(&standard_ops
);