blob: 35e3f519154c718d26fdd765901bf3a5187e9c52 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
/*
Unix SMB/CIFS implementation.
SERVER SERVICE code
Copyright (C) Andrew Tridgell 2003-2005
Copyright (C) Stefan (metze) Metzmacher 2004
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __SERVICE_H__
#define __SERVICE_H__
#include "samba/service_stream.h"
#include "samba/service_task.h"
struct process_details {
unsigned int instances;
};
static const struct process_details initial_process_details = {
.instances = 0
};
struct service_details {
/*
* Prevent the standard process model from forking a new worker
* process when accepting a new connection. Do this when the service
* relies on shared state, or the over-head of forking would be a
* significant part of the response time
*/
bool inhibit_fork_on_accept;
/*
* Prevent the pre-fork process model from pre-forking any worker
* processes. In this mode pre-fork is equivalent to standard with
* inhibit_fork_on_accept set.
*/
bool inhibit_pre_fork;
/*
* Initialise the server task.
*/
NTSTATUS (*task_init) (struct task_server *);
/*
* post fork processing this is called:
* - standard process model
* immediately after the task_init.
*
* - single process model
* immediately after the task_init
*
* - prefork process model, inhibit_pre_fork = true
* immediately after the task_init
*
* - prefork process model, inhibit_pre_fork = false
* after each service worker has forked. It is not run on the
* service master process.
*
* The post fork hook is not called in the standard model if a new
* process is forked on a new connection. It is instead called
* immediately after the task_init.
*/
void (*post_fork) (struct task_server *, struct process_details *);
/*
* This is called before entering the tevent_loop_wait():
*
* Note that task_server->msg_ctx, task_server->event_ctx
* and maybe other fields might have changed compared to
* task_init()/post_fork(). The struct task_server pointer
* may also change!
*
* before loop processing this is called in this order:
* - standard process model
* task_init() -> post_fork() -> before_loop()
*
* - single process model
* task_init() -> post_fork() -> before_loop()
*
* - prefork process model, inhibit_pre_fork = true
* task_init() -> post_fork() -> before_loop()
*
* - prefork process model, inhibit_pre_fork = false
* In the service master process:
* task_init(master) -> before_loop(master)
*
* After each service worker has forked:
* post_fork(worker) -> before_loop(worker)
*
* This gives the service a chance to register messaging
* and/or event handlers on the correct contexts.
*/
void (*before_loop) (struct task_server *);
};
NTSTATUS samba_service_init(void);
#include "samba/service_proto.h"
#endif /* __SERVICE_H__ */
|
