1 /* Definitions for asynchronous process control in GNU Emacs.
2 Copyright (C) 1985, 1994, 2001-2021 Free Software Foundation, Inc.
3
4 This file is part of GNU Emacs.
5
6 GNU Emacs is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or (at
9 your option) any later version.
10
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
18
19 #ifndef EMACS_PROCESS_H
20 #define EMACS_PROCESS_H
21
22 #ifdef HAVE_SYS_TYPES_H
23 #include <sys/types.h>
24 #endif
25
26 #include <unistd.h>
27 #include <sys/signal.h>
28
29 #ifdef HAVE_GNUTLS
30 #include "gnutls.h"
31 #endif
32
33 INLINE_HEADER_BEGIN
34
35 /* Bound on number of file descriptors opened on behalf of a process,
36 that need to be closed. */
37
38 enum { PROCESS_OPEN_FDS = 6 };
39
40 /* This structure records information about a subprocess
41 or network connection. */
42
43 struct Lisp_Process
44 {
45 union vectorlike_header header;
46
47 /* Name of subprocess terminal. */
48 Lisp_Object tty_name;
49
50 /* Name of this process. */
51 Lisp_Object name;
52
53 /* List of command arguments that this process was run with.
54 Is set to t for a stopped network process; nil otherwise. */
55 Lisp_Object command;
56
57 /* (funcall FILTER PROC STRING) (if FILTER is non-nil)
58 to dispose of a bunch of chars from the process all at once. */
59 Lisp_Object filter;
60
61 /* (funcall SENTINEL PROCESS) when process state changes. */
62 Lisp_Object sentinel;
63
64 /* (funcall LOG SERVER CLIENT MESSAGE) when a server process
65 accepts a connection from a client. */
66 Lisp_Object log;
67
68 /* Buffer that output is going to. */
69 Lisp_Object buffer;
70
71 /* t if this is a real child process. For a network or serial
72 connection, it is a plist based on the arguments to
73 make-network-process or make-serial-process. */
74
75 Lisp_Object childp;
76
77 /* Plist for programs to keep per-process state information, parameters, etc. */
78 Lisp_Object plist;
79
80 /* Symbol indicating the type of process: real, network, serial. */
81 Lisp_Object type;
82
83 /* Marker set to end of last buffer-inserted output from this process. */
84 Lisp_Object mark;
85
86 /* Symbol indicating status of process.
87 This may be a symbol: run, open, closed, listen, or failed.
88 Or it may be a pair (connect . ADDRINFOS) where ADDRINFOS is
89 a list of remaining (PROTOCOL . ADDRINFO) pairs to try.
90 Or it may be (failed ERR) where ERR is an integer, string or symbol.
91 Or it may be a list, whose car is stop, exit or signal
92 and whose cdr is a pair (EXIT_CODE . COREDUMP_FLAG)
93 or (SIGNAL_NUMBER . COREDUMP_FLAG). */
94 Lisp_Object status;
95
96 /* Coding-system for decoding the input from this process. */
97 Lisp_Object decode_coding_system;
98
99 /* Working buffer for decoding. */
100 Lisp_Object decoding_buf;
101
102 /* Coding-system for encoding the output to this process. */
103 Lisp_Object encode_coding_system;
104
105 /* Working buffer for encoding. */
106 Lisp_Object encoding_buf;
107
108 /* Queue for storing waiting writes. */
109 Lisp_Object write_queue;
110
111 #ifdef HAVE_GNUTLS
112 Lisp_Object gnutls_cred_type;
113 Lisp_Object gnutls_boot_parameters;
114 #endif
115
116 /* Pipe process attached to the standard error of this process. */
117 Lisp_Object stderrproc;
118
119 /* The thread a process is linked to, or nil for any thread. */
120 Lisp_Object thread;
121 /* After this point, there are no Lisp_Objects. */
122
123 /* Process ID. A positive value is a child process ID.
124 Zero is for pseudo-processes such as network or serial connections,
125 or for processes that have not been fully created yet.
126 -1 is for a process that was not created successfully.
127 -2 is for a pty with no process, e.g., for GDB. */
128 pid_t pid;
129 /* Descriptor by which we read from this process. */
130 int infd;
131 /* Byte-count modulo (UINTMAX_MAX + 1) for process output read from `infd'. */
132 uintmax_t nbytes_read;
133 /* Descriptor by which we write to this process. */
134 int outfd;
135 /* Descriptors that were created for this process and that need
136 closing. Unused entries are negative. */
137 int open_fd[PROCESS_OPEN_FDS];
138 /* Event-count of last event in which this process changed status. */
139 EMACS_INT tick;
140 /* Event-count of last such event reported. */
141 EMACS_INT update_tick;
142 /* Size of carryover in decoding. */
143 int decoding_carryover;
144 /* Hysteresis to try to read process output in larger blocks.
145 On some systems, e.g. GNU/Linux, Emacs is seen as
146 an interactive app also when reading process output, meaning
147 that process output can be read in as little as 1 byte at a
148 time. Value is nanoseconds to delay reading output from
149 this process. Range is 0 .. 50 * 1000 * 1000. */
150 int read_output_delay;
151 /* Should we delay reading output from this process.
152 Initialized from `Vprocess_adaptive_read_buffering'.
153 0 = nil, 1 = t, 2 = other. */
154 unsigned int adaptive_read_buffering : 2;
155 /* Skip reading this process on next read. */
156 bool_bf read_output_skip : 1;
157 /* True means kill silently if Emacs is exited.
158 This is the inverse of the `query-on-exit' flag. */
159 bool_bf kill_without_query : 1;
160 /* True if communicating through a pty. */
161 bool_bf pty_flag : 1;
162 /* Flag to set coding-system of the process buffer from the
163 coding_system used to decode process output. */
164 bool_bf inherit_coding_system_flag : 1;
165 /* Whether the process is alive, i.e., can be waited for. Running
166 processes can be waited for, but exited and fake processes cannot. */
167 bool_bf alive : 1;
168 /* Record the process status in the raw form in which it comes from `wait'.
169 This is to avoid consing in a signal handler. The `raw_status_new'
170 flag indicates that `raw_status' contains a new status that still
171 needs to be synced to `status'. */
172 bool_bf raw_status_new : 1;
173 /* Whether this is a nonblocking socket. */
174 bool_bf is_non_blocking_client : 1;
175 /* Whether this is a server or a client socket. */
176 bool_bf is_server : 1;
177 int raw_status;
178 /* The length of the socket backlog. */
179 int backlog;
180 /* The port number. */
181 int port;
182 /* The socket type. */
183 int socktype;
184
185 #ifdef HAVE_GETADDRINFO_A
186 /* Whether the socket is waiting for response from an asynchronous
187 DNS call. */
188 struct gaicb *dns_request;
189 #endif
190
191 #ifdef HAVE_GNUTLS
192 gnutls_initstage_t gnutls_initstage;
193 gnutls_session_t gnutls_state;
194 gnutls_certificate_client_credentials gnutls_x509_cred;
195 gnutls_anon_client_credentials_t gnutls_anon_cred;
196 gnutls_x509_crt_t *gnutls_certificates;
197 int gnutls_certificates_length;
198 unsigned int gnutls_peer_verification;
199 unsigned int gnutls_extra_peer_verification;
200 int gnutls_log_level;
201 int gnutls_handshakes_tried;
202 bool_bf gnutls_p : 1;
203 bool_bf gnutls_complete_negotiation_p : 1;
204 #endif
205 } GCALIGNED_STRUCT;
206
207 INLINE bool
PROCESSP(Lisp_Object a)208 PROCESSP (Lisp_Object a)
209 {
210 return PSEUDOVECTORP (a, PVEC_PROCESS);
211 }
212
213 INLINE void
CHECK_PROCESS(Lisp_Object x)214 CHECK_PROCESS (Lisp_Object x)
215 {
216 CHECK_TYPE (PROCESSP (x), Qprocessp, x);
217 }
218
219 INLINE struct Lisp_Process *
XPROCESS(Lisp_Object a)220 XPROCESS (Lisp_Object a)
221 {
222 eassert (PROCESSP (a));
223 return XUNTAG (a, Lisp_Vectorlike, struct Lisp_Process);
224 }
225
226 /* Every field in the preceding structure except for the first two
227 must be a Lisp_Object, for GC's sake. */
228
229 #define ChannelMask(n) (1 << (n))
230
231 /* Most code should use these functions to set Lisp fields in struct
232 process. */
233
234 INLINE void
pset_childp(struct Lisp_Process * p,Lisp_Object val)235 pset_childp (struct Lisp_Process *p, Lisp_Object val)
236 {
237 p->childp = val;
238 }
239
240 INLINE void
pset_status(struct Lisp_Process * p,Lisp_Object val)241 pset_status (struct Lisp_Process *p, Lisp_Object val)
242 {
243 p->status = val;
244 }
245
246 #ifdef HAVE_GNUTLS
247 INLINE void
pset_gnutls_cred_type(struct Lisp_Process * p,Lisp_Object val)248 pset_gnutls_cred_type (struct Lisp_Process *p, Lisp_Object val)
249 {
250 p->gnutls_cred_type = val;
251 }
252 #endif
253
254 /* True means don't run process sentinels. This is used
255 when exiting. */
256 extern bool inhibit_sentinels;
257
258 /* Exit statuses for GNU programs that exec other programs. */
259 enum
260 {
261 EXIT_CANCELED = 125, /* Internal error prior to exec attempt. */
262 EXIT_CANNOT_INVOKE = 126, /* Program located, but not usable. */
263 EXIT_ENOENT = 127 /* Could not find program to exec. */
264 };
265
266 /* Defined in callproc.c. */
267
268 extern Lisp_Object get_current_directory (bool);
269 extern void record_kill_process (struct Lisp_Process *, Lisp_Object);
270
271 /* Defined in sysdep.c. */
272
273 extern Lisp_Object list_system_processes (void);
274 extern Lisp_Object system_process_attributes (Lisp_Object);
275
276 /* Defined in process.c. */
277
278 extern void record_deleted_pid (pid_t, Lisp_Object);
279 struct sockaddr;
280 extern Lisp_Object conv_sockaddr_to_lisp (struct sockaddr *, ptrdiff_t);
281 extern void hold_keyboard_input (void);
282 extern void unhold_keyboard_input (void);
283 extern bool kbd_on_hold_p (void);
284
285 typedef void (*fd_callback) (int fd, void *data);
286
287 extern void add_read_fd (int fd, fd_callback func, void *data);
288 extern void add_non_keyboard_read_fd (int fd, fd_callback func, void *data);
289 extern void delete_read_fd (int fd);
290 extern void add_write_fd (int fd, fd_callback func, void *data);
291 extern void delete_write_fd (int fd);
292 extern void catch_child_signal (void);
293 extern void restore_nofile_limit (void);
294
295 #ifdef WINDOWSNT
296 extern Lisp_Object network_interface_list (bool full, unsigned short match);
297 extern Lisp_Object network_interface_info (Lisp_Object);
298 #endif
299
300 extern Lisp_Object remove_slash_colon (Lisp_Object);
301
302 extern void update_processes_for_thread_death (Lisp_Object);
303 extern void dissociate_controlling_tty (void);
304
305 extern int open_channel_for_module (Lisp_Object);
306
307 INLINE_HEADER_END
308
309 #endif /* EMACS_PROCESS_H */
310