xref: /unit/src/nxt_runtime.h (revision 234:e0f17b03f52b)
1 
2 /*
3  * Copyright (C) Igor Sysoev
4  * Copyright (C) Valentin V. Bartenev
5  * Copyright (C) NGINX, Inc.
6  */
7 
8 #ifndef _NXT_RUNTIME_H_INCLUDED_
9 #define _NXT_RUNTIME_H_INCLUDED_
10 
11 
12 typedef void (*nxt_runtime_cont_t)(nxt_task_t *task);
13 
14 
15 struct nxt_runtime_s {
16     nxt_mp_t               *mem_pool;
17 
18     nxt_array_t            *inherited_sockets;  /* of nxt_listen_socket_t */
19     nxt_array_t            *listen_sockets;     /* of nxt_listen_socket_t */
20 
21     nxt_array_t            *services;           /* of nxt_service_t */
22     nxt_array_t            *languages;          /* of nxt_app_lang_module_t */
23     void                   *data;
24 
25     nxt_runtime_cont_t     start;
26 
27     nxt_str_t              hostname;
28 
29     nxt_file_name_t        *pid_file;
30 
31     nxt_array_t            *thread_pools;       /* of nxt_thread_pool_t */
32     nxt_runtime_cont_t     continuation;
33 
34     nxt_process_t          *mprocess;
35     size_t                 nprocesses;
36     nxt_thread_mutex_t     processes_mutex;
37     nxt_lvlhsh_t           processes;           /* of nxt_process_t */
38 
39     nxt_port_t             *port_by_type[NXT_PROCESS_MAX];
40     nxt_lvlhsh_t           ports;               /* of nxt_port_t */
41 
42     nxt_list_t             *log_files;          /* of nxt_file_t */
43 
44     uint32_t               last_engine_id;
45 
46     uint32_t               types;         /* bitset of nxt_process_type_t */
47 
48     nxt_timer_t            timer;
49 
50     uint8_t                daemon;
51     uint8_t                batch;
52     uint8_t                master_process;
53     const char             *engine;
54     uint32_t               engine_connections;
55     uint32_t               auxiliary_threads;
56     nxt_user_cred_t        user_cred;
57     const char             *group;
58     const char             *pid;
59     const char             *log;
60     const char             *modules;
61     const char             *control;
62 
63     nxt_queue_t            engines;            /* of nxt_event_engine_t */
64 
65     nxt_sockaddr_t         *controller_listen;
66     nxt_listen_socket_t    *controller_socket;
67     nxt_str_t              upstream;
68 };
69 
70 
71 
72 typedef nxt_int_t (*nxt_module_init_t)(nxt_thread_t *thr, nxt_runtime_t *rt);
73 
74 
75 nxt_int_t nxt_runtime_create(nxt_task_t *task);
76 void nxt_runtime_quit(nxt_task_t *task);
77 
78 void nxt_runtime_event_engine_free(nxt_runtime_t *rt);
79 
80 nxt_int_t nxt_runtime_thread_pool_create(nxt_thread_t *thr, nxt_runtime_t *rt,
81     nxt_uint_t max_threads, nxt_nsec_t timeout);
82 
83 
84 nxt_inline nxt_bool_t
85 nxt_runtime_is_type(nxt_runtime_t *rt, nxt_process_type_t type)
86 {
87     return (rt->types & (1U << type)) != 0;
88 }
89 
90 
91 nxt_inline nxt_bool_t
92 nxt_runtime_is_master(nxt_runtime_t *rt)
93 {
94     return nxt_runtime_is_type(rt, NXT_PROCESS_MASTER);
95 }
96 
97 
98 nxt_process_t *nxt_runtime_process_new(nxt_runtime_t *rt);
99 
100 nxt_process_t *nxt_runtime_process_get(nxt_runtime_t *rt, nxt_pid_t pid);
101 
102 void nxt_runtime_process_add(nxt_runtime_t *rt, nxt_process_t *process);
103 
104 nxt_process_t *nxt_runtime_process_find(nxt_runtime_t *rt, nxt_pid_t pid);
105 
106 void nxt_runtime_process_remove(nxt_runtime_t *rt, nxt_process_t *process);
107 
108 nxt_process_t *nxt_runtime_process_first(nxt_runtime_t *rt,
109     nxt_lvlhsh_each_t *lhe);
110 
111 #define nxt_runtime_process_next(rt, lhe)                                     \
112     nxt_lvlhsh_each(&rt->processes, lhe)
113 
114 
115 void nxt_runtime_port_add(nxt_runtime_t *rt, nxt_port_t *port);
116 
117 void nxt_runtime_port_remove(nxt_runtime_t *rt, nxt_port_t *port);
118 
119 nxt_port_t *nxt_runtime_port_find(nxt_runtime_t *rt, nxt_pid_t pid,
120     nxt_port_id_t port_id);
121 
122 nxt_port_t *nxt_runtime_port_first(nxt_runtime_t *rt,
123     nxt_lvlhsh_each_t *lhe);
124 
125 #define nxt_runtime_port_next(rt, lhe)                                        \
126     nxt_port_hash_next(&rt->ports, lhe)
127 
128 
129 /* STUB */
130 nxt_int_t nxt_runtime_controller_socket(nxt_task_t *task, nxt_runtime_t *rt);
131 
132 nxt_str_t *nxt_current_directory(nxt_mp_t *mp);
133 
134 nxt_listen_socket_t *nxt_runtime_listen_socket_add(nxt_runtime_t *rt,
135     nxt_sockaddr_t *sa);
136 nxt_int_t nxt_runtime_listen_sockets_create(nxt_task_t *task,
137     nxt_runtime_t *rt);
138 nxt_int_t nxt_runtime_listen_sockets_enable(nxt_task_t *task,
139     nxt_runtime_t *rt);
140 nxt_file_t *nxt_runtime_log_file_add(nxt_runtime_t *rt, nxt_str_t *name);
141 
142 /* STUB */
143 void nxt_cdecl nxt_log_time_handler(nxt_uint_t level, nxt_log_t *log,
144     const char *fmt, ...);
145 
146 void nxt_stream_connection_init(nxt_task_t *task, void *obj, void *data);
147 
148 void nxt_port_app_data_handler(nxt_task_t *task, nxt_port_recv_msg_t *msg);
149 
150 
151 #define nxt_runtime_process_each(rt, process)                                 \
152     do {                                                                      \
153         nxt_lvlhsh_each_t  _lhe;                                              \
154         nxt_process_t      *_nxt;                                             \
155                                                                               \
156         for (process = nxt_runtime_process_first(rt, &_lhe);                  \
157              process != NULL;                                                 \
158              process = _nxt) {                                                \
159                                                                               \
160             _nxt = nxt_runtime_process_next(rt, &_lhe);                       \
161 
162 #define nxt_runtime_process_loop                                              \
163         }                                                                     \
164     } while(0)
165 
166 
167 #define nxt_runtime_port_each(rt, port)                                       \
168     do {                                                                      \
169         nxt_lvlhsh_each_t  _lhe;                                              \
170                                                                               \
171         for (port = nxt_runtime_port_first(rt, &_lhe);                        \
172              port != NULL;                                                    \
173              port = nxt_runtime_port_next(rt, &_lhe)) {                       \
174 
175 #define nxt_runtime_port_loop                                                 \
176         }                                                                     \
177     } while(0)
178 
179 
180 extern nxt_module_init_t  nxt_init_modules[];
181 extern nxt_uint_t         nxt_init_modules_n;
182 
183 
184 #endif /* _NXT_RUNTIME_H_INCLIDED_ */
185