(Ftry_completion, Fall_completions): Add a reference to
[emacs.git] / src / process.c
blobdab701a9e7f41c6af495253ffe5a7a5f7785db43
1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 96, 98, 1999
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #define _GNU_SOURCE /* to get strsignal declared with glibc 2 */
24 #include <config.h>
25 #include <signal.h>
27 /* This file is split into two parts by the following preprocessor
28 conditional. The 'then' clause contains all of the support for
29 asynchronous subprocesses. The 'else' clause contains stub
30 versions of some of the asynchronous subprocess routines that are
31 often called elsewhere in Emacs, so we don't have to #ifdef the
32 sections that call them. */
35 #ifdef subprocesses
37 #include <stdio.h>
38 #include <errno.h>
39 #include <setjmp.h>
40 #include <sys/types.h> /* some typedefs are used in sys/file.h */
41 #include <sys/file.h>
42 #include <sys/stat.h>
43 #ifdef HAVE_UNISTD_H
44 #include <unistd.h>
45 #endif
47 #ifdef WINDOWSNT
48 #include <stdlib.h>
49 #include <fcntl.h>
50 #endif /* not WINDOWSNT */
52 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
53 #include <sys/socket.h>
54 #include <netdb.h>
55 #include <netinet/in.h>
56 #include <arpa/inet.h>
57 #ifdef NEED_NET_ERRNO_H
58 #include <net/errno.h>
59 #endif /* NEED_NET_ERRNO_H */
60 #endif /* HAVE_SOCKETS */
62 /* TERM is a poor-man's SLIP, used on GNU/Linux. */
63 #ifdef TERM
64 #include <client.h>
65 #endif
67 /* On some systems, e.g. DGUX, inet_addr returns a 'struct in_addr'. */
68 #ifdef HAVE_BROKEN_INET_ADDR
69 #define IN_ADDR struct in_addr
70 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
71 #else
72 #define IN_ADDR unsigned long
73 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
74 #endif
76 #if defined(BSD_SYSTEM) || defined(STRIDE)
77 #include <sys/ioctl.h>
78 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
79 #include <fcntl.h>
80 #endif /* HAVE_PTYS and no O_NDELAY */
81 #endif /* BSD_SYSTEM || STRIDE */
83 #ifdef BROKEN_O_NONBLOCK
84 #undef O_NONBLOCK
85 #endif /* BROKEN_O_NONBLOCK */
87 #ifdef NEED_BSDTTY
88 #include <bsdtty.h>
89 #endif
91 #ifdef IRIS
92 #include <sys/sysmacros.h> /* for "minor" */
93 #endif /* not IRIS */
95 #include "systime.h"
96 #include "systty.h"
98 #include "lisp.h"
99 #include "window.h"
100 #include "buffer.h"
101 #include "charset.h"
102 #include "coding.h"
103 #include "process.h"
104 #include "termhooks.h"
105 #include "termopts.h"
106 #include "commands.h"
107 #include "frame.h"
108 #include "blockinput.h"
109 #include "keyboard.h"
110 #include "dispextern.h"
111 #include "composite.h"
112 #include "atimer.h"
114 #define max(a, b) ((a) > (b) ? (a) : (b))
116 Lisp_Object Qprocessp;
117 Lisp_Object Qrun, Qstop, Qsignal, Qopen, Qclosed;
118 Lisp_Object Qlast_nonmenu_event;
119 /* Qexit is declared and initialized in eval.c. */
121 /* a process object is a network connection when its childp field is neither
122 Qt nor Qnil but is instead a cons cell (HOSTNAME PORTNUM). */
124 #ifdef HAVE_SOCKETS
125 #define NETCONN_P(p) (GC_CONSP (XPROCESS (p)->childp))
126 #else
127 #define NETCONN_P(p) 0
128 #endif /* HAVE_SOCKETS */
130 /* Define first descriptor number available for subprocesses. */
131 #ifdef VMS
132 #define FIRST_PROC_DESC 1
133 #else /* Not VMS */
134 #define FIRST_PROC_DESC 3
135 #endif
137 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
138 testing SIGCHLD. */
140 #if !defined (SIGCHLD) && defined (SIGCLD)
141 #define SIGCHLD SIGCLD
142 #endif /* SIGCLD */
144 #include "syssignal.h"
146 #include "syswait.h"
148 extern void set_waiting_for_input P_ ((EMACS_TIME *));
150 extern int errno;
151 #ifdef VMS
152 extern char *sys_errlist[];
153 #endif
155 #ifndef HAVE_H_ERRNO
156 extern int h_errno;
157 #endif
159 /* t means use pty, nil means use a pipe,
160 maybe other values to come. */
161 static Lisp_Object Vprocess_connection_type;
163 #ifdef SKTPAIR
164 #ifndef HAVE_SOCKETS
165 #include <sys/socket.h>
166 #endif
167 #endif /* SKTPAIR */
169 /* These next two vars are non-static since sysdep.c uses them in the
170 emulation of `select'. */
171 /* Number of events of change of status of a process. */
172 int process_tick;
173 /* Number of events for which the user or sentinel has been notified. */
174 int update_tick;
176 #include "sysselect.h"
178 extern int keyboard_bit_set P_ ((SELECT_TYPE *));
180 /* If we support a window system, turn on the code to poll periodically
181 to detect C-g. It isn't actually used when doing interrupt input. */
182 #ifdef HAVE_WINDOW_SYSTEM
183 #define POLL_FOR_INPUT
184 #endif
186 /* Mask of bits indicating the descriptors that we wait for input on. */
188 static SELECT_TYPE input_wait_mask;
190 /* Mask that excludes keyboard input descriptor (s). */
192 static SELECT_TYPE non_keyboard_wait_mask;
194 /* Mask that excludes process input descriptor (s). */
196 static SELECT_TYPE non_process_wait_mask;
198 /* The largest descriptor currently in use for a process object. */
199 static int max_process_desc;
201 /* The largest descriptor currently in use for keyboard input. */
202 static int max_keyboard_desc;
204 /* Nonzero means delete a process right away if it exits. */
205 static int delete_exited_processes;
207 /* Indexed by descriptor, gives the process (if any) for that descriptor */
208 Lisp_Object chan_process[MAXDESC];
210 /* Alist of elements (NAME . PROCESS) */
211 Lisp_Object Vprocess_alist;
213 /* Buffered-ahead input char from process, indexed by channel.
214 -1 means empty (no char is buffered).
215 Used on sys V where the only way to tell if there is any
216 output from the process is to read at least one char.
217 Always -1 on systems that support FIONREAD. */
219 /* Don't make static; need to access externally. */
220 int proc_buffered_char[MAXDESC];
222 /* Table of `struct coding-system' for each process. */
223 static struct coding_system *proc_decode_coding_system[MAXDESC];
224 static struct coding_system *proc_encode_coding_system[MAXDESC];
226 static Lisp_Object get_process ();
228 extern EMACS_TIME timer_check ();
229 extern int timers_run;
231 /* Maximum number of bytes to send to a pty without an eof. */
232 static int pty_max_bytes;
234 extern Lisp_Object Vfile_name_coding_system, Vdefault_file_name_coding_system;
236 #ifdef HAVE_PTYS
237 /* The file name of the pty opened by allocate_pty. */
239 static char pty_name[24];
240 #endif
242 /* Compute the Lisp form of the process status, p->status, from
243 the numeric status that was returned by `wait'. */
245 Lisp_Object status_convert ();
247 void
248 update_status (p)
249 struct Lisp_Process *p;
251 union { int i; WAITTYPE wt; } u;
252 u.i = XFASTINT (p->raw_status_low) + (XFASTINT (p->raw_status_high) << 16);
253 p->status = status_convert (u.wt);
254 p->raw_status_low = Qnil;
255 p->raw_status_high = Qnil;
258 /* Convert a process status word in Unix format to
259 the list that we use internally. */
261 Lisp_Object
262 status_convert (w)
263 WAITTYPE w;
265 if (WIFSTOPPED (w))
266 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
267 else if (WIFEXITED (w))
268 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
269 WCOREDUMP (w) ? Qt : Qnil));
270 else if (WIFSIGNALED (w))
271 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
272 WCOREDUMP (w) ? Qt : Qnil));
273 else
274 return Qrun;
277 /* Given a status-list, extract the three pieces of information
278 and store them individually through the three pointers. */
280 void
281 decode_status (l, symbol, code, coredump)
282 Lisp_Object l;
283 Lisp_Object *symbol;
284 int *code;
285 int *coredump;
287 Lisp_Object tem;
289 if (SYMBOLP (l))
291 *symbol = l;
292 *code = 0;
293 *coredump = 0;
295 else
297 *symbol = XCAR (l);
298 tem = XCDR (l);
299 *code = XFASTINT (XCAR (tem));
300 tem = XCDR (tem);
301 *coredump = !NILP (tem);
305 /* Return a string describing a process status list. */
307 Lisp_Object
308 status_message (status)
309 Lisp_Object status;
311 Lisp_Object symbol;
312 int code, coredump;
313 Lisp_Object string, string2;
315 decode_status (status, &symbol, &code, &coredump);
317 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
319 char *signame;
320 synchronize_system_messages_locale ();
321 signame = strsignal (code);
322 if (signame == 0)
323 signame = "unknown";
324 string = build_string (signame);
325 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
326 XSTRING (string)->data[0] = DOWNCASE (XSTRING (string)->data[0]);
327 return concat2 (string, string2);
329 else if (EQ (symbol, Qexit))
331 if (code == 0)
332 return build_string ("finished\n");
333 string = Fnumber_to_string (make_number (code));
334 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
335 return concat2 (build_string ("exited abnormally with code "),
336 concat2 (string, string2));
338 else
339 return Fcopy_sequence (Fsymbol_name (symbol));
342 #ifdef HAVE_PTYS
344 /* Open an available pty, returning a file descriptor.
345 Return -1 on failure.
346 The file name of the terminal corresponding to the pty
347 is left in the variable pty_name. */
350 allocate_pty ()
352 struct stat stb;
353 register int c, i;
354 int fd;
356 /* Some systems name their pseudoterminals so that there are gaps in
357 the usual sequence - for example, on HP9000/S700 systems, there
358 are no pseudoterminals with names ending in 'f'. So we wait for
359 three failures in a row before deciding that we've reached the
360 end of the ptys. */
361 int failed_count = 0;
363 #ifdef PTY_ITERATION
364 PTY_ITERATION
365 #else
366 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
367 for (i = 0; i < 16; i++)
368 #endif
370 #ifdef PTY_NAME_SPRINTF
371 PTY_NAME_SPRINTF
372 #else
373 sprintf (pty_name, "/dev/pty%c%x", c, i);
374 #endif /* no PTY_NAME_SPRINTF */
376 #ifdef PTY_OPEN
377 PTY_OPEN;
378 #else /* no PTY_OPEN */
379 #ifdef IRIS
380 /* Unusual IRIS code */
381 *ptyv = emacs_open ("/dev/ptc", O_RDWR | O_NDELAY, 0);
382 if (fd < 0)
383 return -1;
384 if (fstat (fd, &stb) < 0)
385 return -1;
386 #else /* not IRIS */
387 if (stat (pty_name, &stb) < 0)
389 failed_count++;
390 if (failed_count >= 3)
391 return -1;
393 else
394 failed_count = 0;
395 #ifdef O_NONBLOCK
396 fd = emacs_open (pty_name, O_RDWR | O_NONBLOCK, 0);
397 #else
398 fd = emacs_open (pty_name, O_RDWR | O_NDELAY, 0);
399 #endif
400 #endif /* not IRIS */
401 #endif /* no PTY_OPEN */
403 if (fd >= 0)
405 /* check to make certain that both sides are available
406 this avoids a nasty yet stupid bug in rlogins */
407 #ifdef PTY_TTY_NAME_SPRINTF
408 PTY_TTY_NAME_SPRINTF
409 #else
410 sprintf (pty_name, "/dev/tty%c%x", c, i);
411 #endif /* no PTY_TTY_NAME_SPRINTF */
412 #ifndef UNIPLUS
413 if (access (pty_name, 6) != 0)
415 emacs_close (fd);
416 #if !defined(IRIS) && !defined(__sgi)
417 continue;
418 #else
419 return -1;
420 #endif /* IRIS */
422 #endif /* not UNIPLUS */
423 setup_pty (fd);
424 return fd;
427 return -1;
429 #endif /* HAVE_PTYS */
431 Lisp_Object
432 make_process (name)
433 Lisp_Object name;
435 struct Lisp_Vector *vec;
436 register Lisp_Object val, tem, name1;
437 register struct Lisp_Process *p;
438 char suffix[10];
439 register int i;
441 vec = allocate_vectorlike ((EMACS_INT) VECSIZE (struct Lisp_Process));
442 for (i = 0; i < VECSIZE (struct Lisp_Process); i++)
443 vec->contents[i] = Qnil;
444 vec->size = VECSIZE (struct Lisp_Process);
445 p = (struct Lisp_Process *)vec;
447 XSETINT (p->infd, -1);
448 XSETINT (p->outfd, -1);
449 XSETFASTINT (p->pid, 0);
450 XSETFASTINT (p->tick, 0);
451 XSETFASTINT (p->update_tick, 0);
452 p->raw_status_low = Qnil;
453 p->raw_status_high = Qnil;
454 p->status = Qrun;
455 p->mark = Fmake_marker ();
457 /* If name is already in use, modify it until it is unused. */
459 name1 = name;
460 for (i = 1; ; i++)
462 tem = Fget_process (name1);
463 if (NILP (tem)) break;
464 sprintf (suffix, "<%d>", i);
465 name1 = concat2 (name, build_string (suffix));
467 name = name1;
468 p->name = name;
469 XSETPROCESS (val, p);
470 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
471 return val;
474 void
475 remove_process (proc)
476 register Lisp_Object proc;
478 register Lisp_Object pair;
480 pair = Frassq (proc, Vprocess_alist);
481 Vprocess_alist = Fdelq (pair, Vprocess_alist);
483 deactivate_process (proc);
486 DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
487 "Return t if OBJECT is a process.")
488 (object)
489 Lisp_Object object;
491 return PROCESSP (object) ? Qt : Qnil;
494 DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
495 "Return the process named NAME, or nil if there is none.")
496 (name)
497 register Lisp_Object name;
499 if (PROCESSP (name))
500 return name;
501 CHECK_STRING (name, 0);
502 return Fcdr (Fassoc (name, Vprocess_alist));
505 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
506 "Return the (or a) process associated with BUFFER.\n\
507 BUFFER may be a buffer or the name of one.")
508 (buffer)
509 register Lisp_Object buffer;
511 register Lisp_Object buf, tail, proc;
513 if (NILP (buffer)) return Qnil;
514 buf = Fget_buffer (buffer);
515 if (NILP (buf)) return Qnil;
517 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
519 proc = Fcdr (Fcar (tail));
520 if (PROCESSP (proc) && EQ (XPROCESS (proc)->buffer, buf))
521 return proc;
523 return Qnil;
526 /* This is how commands for the user decode process arguments. It
527 accepts a process, a process name, a buffer, a buffer name, or nil.
528 Buffers denote the first process in the buffer, and nil denotes the
529 current buffer. */
531 static Lisp_Object
532 get_process (name)
533 register Lisp_Object name;
535 register Lisp_Object proc, obj;
536 if (STRINGP (name))
538 obj = Fget_process (name);
539 if (NILP (obj))
540 obj = Fget_buffer (name);
541 if (NILP (obj))
542 error ("Process %s does not exist", XSTRING (name)->data);
544 else if (NILP (name))
545 obj = Fcurrent_buffer ();
546 else
547 obj = name;
549 /* Now obj should be either a buffer object or a process object.
551 if (BUFFERP (obj))
553 proc = Fget_buffer_process (obj);
554 if (NILP (proc))
555 error ("Buffer %s has no process", XSTRING (XBUFFER (obj)->name)->data);
557 else
559 CHECK_PROCESS (obj, 0);
560 proc = obj;
562 return proc;
565 DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
566 "Delete PROCESS: kill it and forget about it immediately.\n\
567 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
568 nil, indicating the current buffer's process.")
569 (process)
570 register Lisp_Object process;
572 process = get_process (process);
573 XPROCESS (process)->raw_status_low = Qnil;
574 XPROCESS (process)->raw_status_high = Qnil;
575 if (NETCONN_P (process))
577 XPROCESS (process)->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
578 XSETINT (XPROCESS (process)->tick, ++process_tick);
580 else if (XINT (XPROCESS (process)->infd) >= 0)
582 Fkill_process (process, Qnil);
583 /* Do this now, since remove_process will make sigchld_handler do nothing. */
584 XPROCESS (process)->status
585 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
586 XSETINT (XPROCESS (process)->tick, ++process_tick);
587 status_notify ();
589 remove_process (process);
590 return Qnil;
593 DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
594 "Return the status of PROCESS.\n\
595 The returned value is one of the following symbols:\n\
596 run -- for a process that is running.\n\
597 stop -- for a process stopped but continuable.\n\
598 exit -- for a process that has exited.\n\
599 signal -- for a process that has got a fatal signal.\n\
600 open -- for a network stream connection that is open.\n\
601 closed -- for a network stream connection that is closed.\n\
602 nil -- if arg is a process name and no such process exists.\n\
603 PROCESS may be a process, a buffer, the name of a process, or\n\
604 nil, indicating the current buffer's process.")
605 (process)
606 register Lisp_Object process;
608 register struct Lisp_Process *p;
609 register Lisp_Object status;
611 if (STRINGP (process))
612 process = Fget_process (process);
613 else
614 process = get_process (process);
616 if (NILP (process))
617 return process;
619 p = XPROCESS (process);
620 if (!NILP (p->raw_status_low))
621 update_status (p);
622 status = p->status;
623 if (CONSP (status))
624 status = XCAR (status);
625 if (NETCONN_P (process))
627 if (EQ (status, Qrun))
628 status = Qopen;
629 else if (EQ (status, Qexit))
630 status = Qclosed;
632 return status;
635 DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
636 1, 1, 0,
637 "Return the exit status of PROCESS or the signal number that killed it.\n\
638 If PROCESS has not yet exited or died, return 0.")
639 (process)
640 register Lisp_Object process;
642 CHECK_PROCESS (process, 0);
643 if (!NILP (XPROCESS (process)->raw_status_low))
644 update_status (XPROCESS (process));
645 if (CONSP (XPROCESS (process)->status))
646 return XCAR (XCDR (XPROCESS (process)->status));
647 return make_number (0);
650 DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
651 "Return the process id of PROCESS.\n\
652 This is the pid of the Unix process which PROCESS uses or talks to.\n\
653 For a network connection, this value is nil.")
654 (process)
655 register Lisp_Object process;
657 CHECK_PROCESS (process, 0);
658 return XPROCESS (process)->pid;
661 DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
662 "Return the name of PROCESS, as a string.\n\
663 This is the name of the program invoked in PROCESS,\n\
664 possibly modified to make it unique among process names.")
665 (process)
666 register Lisp_Object process;
668 CHECK_PROCESS (process, 0);
669 return XPROCESS (process)->name;
672 DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
673 "Return the command that was executed to start PROCESS.\n\
674 This is a list of strings, the first string being the program executed\n\
675 and the rest of the strings being the arguments given to it.\n\
676 For a non-child channel, this is nil.")
677 (process)
678 register Lisp_Object process;
680 CHECK_PROCESS (process, 0);
681 return XPROCESS (process)->command;
684 DEFUN ("process-tty-name", Fprocess_tty_name, Sprocess_tty_name, 1, 1, 0,
685 "Return the name of the terminal PROCESS uses, or nil if none.\n\
686 This is the terminal that the process itself reads and writes on,\n\
687 not the name of the pty that Emacs uses to talk with that terminal.")
688 (process)
689 register Lisp_Object process;
691 CHECK_PROCESS (process, 0);
692 return XPROCESS (process)->tty_name;
695 DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
696 2, 2, 0,
697 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
698 (process, buffer)
699 register Lisp_Object process, buffer;
701 CHECK_PROCESS (process, 0);
702 if (!NILP (buffer))
703 CHECK_BUFFER (buffer, 1);
704 XPROCESS (process)->buffer = buffer;
705 return buffer;
708 DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
709 1, 1, 0,
710 "Return the buffer PROCESS is associated with.\n\
711 Output from PROCESS is inserted in this buffer unless PROCESS has a filter.")
712 (process)
713 register Lisp_Object process;
715 CHECK_PROCESS (process, 0);
716 return XPROCESS (process)->buffer;
719 DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
720 1, 1, 0,
721 "Return the marker for the end of the last output from PROCESS.")
722 (process)
723 register Lisp_Object process;
725 CHECK_PROCESS (process, 0);
726 return XPROCESS (process)->mark;
729 DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
730 2, 2, 0,
731 "Give PROCESS the filter function FILTER; nil means no filter.\n\
732 t means stop accepting output from the process.\n\
733 When a process has a filter, each time it does output\n\
734 the entire string of output is passed to the filter.\n\
735 The filter gets two arguments: the process and the string of output.\n\
736 If the process has a filter, its buffer is not used for output.")
737 (process, filter)
738 register Lisp_Object process, filter;
740 CHECK_PROCESS (process, 0);
741 if (EQ (filter, Qt))
743 FD_CLR (XINT (XPROCESS (process)->infd), &input_wait_mask);
744 FD_CLR (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
746 else if (EQ (XPROCESS (process)->filter, Qt))
748 FD_SET (XINT (XPROCESS (process)->infd), &input_wait_mask);
749 FD_SET (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
751 XPROCESS (process)->filter = filter;
752 return filter;
755 DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
756 1, 1, 0,
757 "Returns the filter function of PROCESS; nil if none.\n\
758 See `set-process-filter' for more info on filter functions.")
759 (process)
760 register Lisp_Object process;
762 CHECK_PROCESS (process, 0);
763 return XPROCESS (process)->filter;
766 DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
767 2, 2, 0,
768 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
769 The sentinel is called as a function when the process changes state.\n\
770 It gets two arguments: the process, and a string describing the change.")
771 (process, sentinel)
772 register Lisp_Object process, sentinel;
774 CHECK_PROCESS (process, 0);
775 XPROCESS (process)->sentinel = sentinel;
776 return sentinel;
779 DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
780 1, 1, 0,
781 "Return the sentinel of PROCESS; nil if none.\n\
782 See `set-process-sentinel' for more info on sentinels.")
783 (process)
784 register Lisp_Object process;
786 CHECK_PROCESS (process, 0);
787 return XPROCESS (process)->sentinel;
790 DEFUN ("set-process-window-size", Fset_process_window_size,
791 Sset_process_window_size, 3, 3, 0,
792 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
793 (process, height, width)
794 register Lisp_Object process, height, width;
796 CHECK_PROCESS (process, 0);
797 CHECK_NATNUM (height, 0);
798 CHECK_NATNUM (width, 0);
799 if (set_window_size (XINT (XPROCESS (process)->infd),
800 XINT (height), XINT (width)) <= 0)
801 return Qnil;
802 else
803 return Qt;
806 DEFUN ("set-process-inherit-coding-system-flag",
807 Fset_process_inherit_coding_system_flag,
808 Sset_process_inherit_coding_system_flag, 2, 2, 0,
809 "Determine whether buffer of PROCESS will inherit coding-system.\n\
810 If the second argument FLAG is non-nil, then the variable\n\
811 `buffer-file-coding-system' of the buffer associated with PROCESS\n\
812 will be bound to the value of the coding system used to decode\n\
813 the process output.\n\
815 This is useful when the coding system specified for the process buffer\n\
816 leaves either the character code conversion or the end-of-line conversion\n\
817 unspecified, or if the coding system used to decode the process output\n\
818 is more appropriate for saving the process buffer.\n\
820 Binding the variable `inherit-process-coding-system' to non-nil before\n\
821 starting the process is an alternative way of setting the inherit flag\n\
822 for the process which will run.")
823 (process, flag)
824 register Lisp_Object process, flag;
826 CHECK_PROCESS (process, 0);
827 XPROCESS (process)->inherit_coding_system_flag = flag;
828 return flag;
831 DEFUN ("process-inherit-coding-system-flag",
832 Fprocess_inherit_coding_system_flag, Sprocess_inherit_coding_system_flag,
833 1, 1, 0,
834 "Return the value of inherit-coding-system flag for PROCESS.\n\
835 If this flag is t, `buffer-file-coding-system' of the buffer\n\
836 associated with PROCESS will inherit the coding system used to decode\n\
837 the process output.")
838 (process)
839 register Lisp_Object process;
841 CHECK_PROCESS (process, 0);
842 return XPROCESS (process)->inherit_coding_system_flag;
845 DEFUN ("process-kill-without-query", Fprocess_kill_without_query,
846 Sprocess_kill_without_query, 1, 2, 0,
847 "Say no query needed if PROCESS is running when Emacs is exited.\n\
848 Optional second argument if non-nil says to require a query.\n\
849 Value is t if a query was formerly required.")
850 (process, value)
851 register Lisp_Object process, value;
853 Lisp_Object tem;
855 CHECK_PROCESS (process, 0);
856 tem = XPROCESS (process)->kill_without_query;
857 XPROCESS (process)->kill_without_query = Fnull (value);
859 return Fnull (tem);
862 DEFUN ("process-contact", Fprocess_contact, Sprocess_contact,
863 1, 1, 0,
864 "Return the contact info of PROCESS; t for a real child.\n\
865 For a net connection, the value is a cons cell of the form (HOST SERVICE).")
866 (process)
867 register Lisp_Object process;
869 CHECK_PROCESS (process, 0);
870 return XPROCESS (process)->childp;
873 #if 0 /* Turned off because we don't currently record this info
874 in the process. Perhaps add it. */
875 DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 1, 1, 0,
876 "Return the connection type of PROCESS.\n\
877 The value is nil for a pipe, t or `pty' for a pty, or `stream' for\n\
878 a socket connection.")
879 (process)
880 Lisp_Object process;
882 return XPROCESS (process)->type;
884 #endif
886 Lisp_Object
887 list_processes_1 ()
889 register Lisp_Object tail, tem;
890 Lisp_Object proc, minspace, tem1;
891 register struct Lisp_Process *p;
892 char tembuf[80];
894 XSETFASTINT (minspace, 1);
896 set_buffer_internal (XBUFFER (Vstandard_output));
897 Fbuffer_disable_undo (Vstandard_output);
899 current_buffer->truncate_lines = Qt;
901 write_string ("\
902 Proc Status Buffer Tty Command\n\
903 ---- ------ ------ --- -------\n", -1);
905 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
907 Lisp_Object symbol;
909 proc = Fcdr (Fcar (tail));
910 p = XPROCESS (proc);
911 if (NILP (p->childp))
912 continue;
914 Finsert (1, &p->name);
915 Findent_to (make_number (13), minspace);
917 if (!NILP (p->raw_status_low))
918 update_status (p);
919 symbol = p->status;
920 if (CONSP (p->status))
921 symbol = XCAR (p->status);
924 if (EQ (symbol, Qsignal))
926 Lisp_Object tem;
927 tem = Fcar (Fcdr (p->status));
928 #ifdef VMS
929 if (XINT (tem) < NSIG)
930 write_string (sys_errlist [XINT (tem)], -1);
931 else
932 #endif
933 Fprinc (symbol, Qnil);
935 else if (NETCONN_P (proc))
937 if (EQ (symbol, Qrun))
938 write_string ("open", -1);
939 else if (EQ (symbol, Qexit))
940 write_string ("closed", -1);
941 else
942 Fprinc (symbol, Qnil);
944 else
945 Fprinc (symbol, Qnil);
947 if (EQ (symbol, Qexit))
949 Lisp_Object tem;
950 tem = Fcar (Fcdr (p->status));
951 if (XFASTINT (tem))
953 sprintf (tembuf, " %d", (int) XFASTINT (tem));
954 write_string (tembuf, -1);
958 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
959 remove_process (proc);
961 Findent_to (make_number (22), minspace);
962 if (NILP (p->buffer))
963 insert_string ("(none)");
964 else if (NILP (XBUFFER (p->buffer)->name))
965 insert_string ("(Killed)");
966 else
967 Finsert (1, &XBUFFER (p->buffer)->name);
969 Findent_to (make_number (37), minspace);
971 if (STRINGP (p->tty_name))
972 Finsert (1, &p->tty_name);
973 else
974 insert_string ("(none)");
976 Findent_to (make_number (49), minspace);
978 if (NETCONN_P (proc))
980 sprintf (tembuf, "(network stream connection to %s)\n",
981 XSTRING (XCAR (p->childp))->data);
982 insert_string (tembuf);
984 else
986 tem = p->command;
987 while (1)
989 tem1 = Fcar (tem);
990 Finsert (1, &tem1);
991 tem = Fcdr (tem);
992 if (NILP (tem))
993 break;
994 insert_string (" ");
996 insert_string ("\n");
999 return Qnil;
1002 DEFUN ("list-processes", Flist_processes, Slist_processes, 0, 0, "",
1003 "Display a list of all processes.\n\
1004 Any process listed as exited or signaled is actually eliminated\n\
1005 after the listing is made.")
1008 internal_with_output_to_temp_buffer ("*Process List*",
1009 list_processes_1, Qnil);
1010 return Qnil;
1013 DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
1014 "Return a list of all processes.")
1017 return Fmapcar (Qcdr, Vprocess_alist);
1020 /* Starting asynchronous inferior processes. */
1022 static Lisp_Object start_process_unwind ();
1024 DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
1025 "Start a program in a subprocess. Return the process object for it.\n\
1026 NAME is name for process. It is modified if necessary to make it unique.\n\
1027 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
1028 Process output goes at end of that buffer, unless you specify\n\
1029 an output stream or filter function to handle the output.\n\
1030 BUFFER may be also nil, meaning that this process is not associated\n\
1031 with any buffer.\n\
1032 Third arg is program file name. It is searched for in PATH.\n\
1033 Remaining arguments are strings to give program as arguments.")
1034 (nargs, args)
1035 int nargs;
1036 register Lisp_Object *args;
1038 Lisp_Object buffer, name, program, proc, current_dir, tem;
1039 #ifdef VMS
1040 register unsigned char *new_argv;
1041 int len;
1042 #else
1043 register unsigned char **new_argv;
1044 #endif
1045 register int i;
1046 int count = specpdl_ptr - specpdl;
1048 buffer = args[1];
1049 if (!NILP (buffer))
1050 buffer = Fget_buffer_create (buffer);
1052 /* Make sure that the child will be able to chdir to the current
1053 buffer's current directory, or its unhandled equivalent. We
1054 can't just have the child check for an error when it does the
1055 chdir, since it's in a vfork.
1057 We have to GCPRO around this because Fexpand_file_name and
1058 Funhandled_file_name_directory might call a file name handling
1059 function. The argument list is protected by the caller, so all
1060 we really have to worry about is buffer. */
1062 struct gcpro gcpro1, gcpro2;
1064 current_dir = current_buffer->directory;
1066 GCPRO2 (buffer, current_dir);
1068 current_dir
1069 = expand_and_dir_to_file (Funhandled_file_name_directory (current_dir),
1070 Qnil);
1071 if (NILP (Ffile_accessible_directory_p (current_dir)))
1072 report_file_error ("Setting current directory",
1073 Fcons (current_buffer->directory, Qnil));
1075 UNGCPRO;
1078 name = args[0];
1079 CHECK_STRING (name, 0);
1081 program = args[2];
1083 CHECK_STRING (program, 2);
1085 #ifdef VMS
1086 /* Make a one member argv with all args concatenated
1087 together separated by a blank. */
1088 len = STRING_BYTES (XSTRING (program)) + 2;
1089 for (i = 3; i < nargs; i++)
1091 tem = args[i];
1092 CHECK_STRING (tem, i);
1093 len += STRING_BYTES (XSTRING (tem)) + 1; /* count the blank */
1095 new_argv = (unsigned char *) alloca (len);
1096 strcpy (new_argv, XSTRING (program)->data);
1097 for (i = 3; i < nargs; i++)
1099 tem = args[i];
1100 CHECK_STRING (tem, i);
1101 strcat (new_argv, " ");
1102 strcat (new_argv, XSTRING (tem)->data);
1104 /* Need to add code here to check for program existence on VMS */
1106 #else /* not VMS */
1107 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1109 /* If program file name is not absolute, search our path for it */
1110 if (!IS_DIRECTORY_SEP (XSTRING (program)->data[0])
1111 && !(XSTRING (program)->size > 1
1112 && IS_DEVICE_SEP (XSTRING (program)->data[1])))
1114 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1116 tem = Qnil;
1117 GCPRO4 (name, program, buffer, current_dir);
1118 openp (Vexec_path, program, EXEC_SUFFIXES, &tem, 1);
1119 UNGCPRO;
1120 if (NILP (tem))
1121 report_file_error ("Searching for program", Fcons (program, Qnil));
1122 tem = Fexpand_file_name (tem, Qnil);
1123 new_argv[0] = XSTRING (tem)->data;
1125 else
1127 if (!NILP (Ffile_directory_p (program)))
1128 error ("Specified program for new process is a directory");
1130 new_argv[0] = XSTRING (program)->data;
1133 for (i = 3; i < nargs; i++)
1135 tem = args[i];
1136 CHECK_STRING (tem, i);
1137 new_argv[i - 2] = XSTRING (tem)->data;
1139 new_argv[i - 2] = 0;
1140 #endif /* not VMS */
1142 proc = make_process (name);
1143 /* If an error occurs and we can't start the process, we want to
1144 remove it from the process list. This means that each error
1145 check in create_process doesn't need to call remove_process
1146 itself; it's all taken care of here. */
1147 record_unwind_protect (start_process_unwind, proc);
1149 XPROCESS (proc)->childp = Qt;
1150 XPROCESS (proc)->command_channel_p = Qnil;
1151 XPROCESS (proc)->buffer = buffer;
1152 XPROCESS (proc)->sentinel = Qnil;
1153 XPROCESS (proc)->filter = Qnil;
1154 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1156 /* Make the process marker point into the process buffer (if any). */
1157 if (!NILP (buffer))
1158 set_marker_both (XPROCESS (proc)->mark, buffer,
1159 BUF_ZV (XBUFFER (buffer)),
1160 BUF_ZV_BYTE (XBUFFER (buffer)));
1163 /* Decide coding systems for communicating with the process. Here
1164 we don't setup the structure coding_system nor pay attention to
1165 unibyte mode. They are done in create_process. */
1167 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
1168 Lisp_Object coding_systems = Qt;
1169 Lisp_Object val, *args2;
1170 struct gcpro gcpro1;
1172 val = Vcoding_system_for_read;
1173 if (NILP (val))
1175 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof *args2);
1176 args2[0] = Qstart_process;
1177 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1178 GCPRO1 (proc);
1179 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1180 UNGCPRO;
1181 if (CONSP (coding_systems))
1182 val = XCAR (coding_systems);
1183 else if (CONSP (Vdefault_process_coding_system))
1184 val = XCAR (Vdefault_process_coding_system);
1186 XPROCESS (proc)->decode_coding_system = val;
1188 val = Vcoding_system_for_write;
1189 if (NILP (val))
1191 if (EQ (coding_systems, Qt))
1193 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof args2);
1194 args2[0] = Qstart_process;
1195 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1196 GCPRO1 (proc);
1197 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1198 UNGCPRO;
1200 if (CONSP (coding_systems))
1201 val = XCDR (coding_systems);
1202 else if (CONSP (Vdefault_process_coding_system))
1203 val = XCDR (Vdefault_process_coding_system);
1205 XPROCESS (proc)->encode_coding_system = val;
1208 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
1209 XPROCESS (proc)->decoding_carryover = make_number (0);
1210 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
1211 XPROCESS (proc)->encoding_carryover = make_number (0);
1213 XPROCESS (proc)->inherit_coding_system_flag
1214 = (NILP (buffer) || !inherit_process_coding_system
1215 ? Qnil : Qt);
1217 create_process (proc, (char **) new_argv, current_dir);
1219 return unbind_to (count, proc);
1222 /* This function is the unwind_protect form for Fstart_process. If
1223 PROC doesn't have its pid set, then we know someone has signaled
1224 an error and the process wasn't started successfully, so we should
1225 remove it from the process list. */
1226 static Lisp_Object
1227 start_process_unwind (proc)
1228 Lisp_Object proc;
1230 if (!PROCESSP (proc))
1231 abort ();
1233 /* Was PROC started successfully? */
1234 if (XINT (XPROCESS (proc)->pid) <= 0)
1235 remove_process (proc);
1237 return Qnil;
1240 void
1241 create_process_1 (timer)
1242 struct atimer *timer;
1244 /* Nothing to do. */
1248 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1249 #ifdef USG
1250 #ifdef SIGCHLD
1251 /* Mimic blocking of signals on system V, which doesn't really have it. */
1253 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1254 int sigchld_deferred;
1256 SIGTYPE
1257 create_process_sigchld ()
1259 signal (SIGCHLD, create_process_sigchld);
1261 sigchld_deferred = 1;
1263 #endif
1264 #endif
1265 #endif
1267 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1268 void
1269 create_process (process, new_argv, current_dir)
1270 Lisp_Object process;
1271 char **new_argv;
1272 Lisp_Object current_dir;
1274 int pid, inchannel, outchannel;
1275 int sv[2];
1276 #ifdef POSIX_SIGNALS
1277 sigset_t procmask;
1278 sigset_t blocked;
1279 struct sigaction sigint_action;
1280 struct sigaction sigquit_action;
1281 #ifdef AIX
1282 struct sigaction sighup_action;
1283 #endif
1284 #else /* !POSIX_SIGNALS */
1285 #if 0
1286 #ifdef SIGCHLD
1287 SIGTYPE (*sigchld)();
1288 #endif
1289 #endif /* 0 */
1290 #endif /* !POSIX_SIGNALS */
1291 /* Use volatile to protect variables from being clobbered by longjmp. */
1292 volatile int forkin, forkout;
1293 volatile int pty_flag = 0;
1294 extern char **environ;
1295 Lisp_Object buffer = XPROCESS (process)->buffer;
1297 inchannel = outchannel = -1;
1299 #ifdef HAVE_PTYS
1300 if (!NILP (Vprocess_connection_type))
1301 outchannel = inchannel = allocate_pty ();
1303 if (inchannel >= 0)
1305 #ifndef USG
1306 /* On USG systems it does not work to open the pty's tty here
1307 and then close and reopen it in the child. */
1308 #ifdef O_NOCTTY
1309 /* Don't let this terminal become our controlling terminal
1310 (in case we don't have one). */
1311 forkout = forkin = emacs_open (pty_name, O_RDWR | O_NOCTTY, 0);
1312 #else
1313 forkout = forkin = emacs_open (pty_name, O_RDWR, 0);
1314 #endif
1315 if (forkin < 0)
1316 report_file_error ("Opening pty", Qnil);
1317 #else
1318 forkin = forkout = -1;
1319 #endif /* not USG */
1320 pty_flag = 1;
1322 else
1323 #endif /* HAVE_PTYS */
1324 #ifdef SKTPAIR
1326 if (socketpair (AF_UNIX, SOCK_STREAM, 0, sv) < 0)
1327 report_file_error ("Opening socketpair", Qnil);
1328 outchannel = inchannel = sv[0];
1329 forkout = forkin = sv[1];
1331 #else /* not SKTPAIR */
1333 int tem;
1334 tem = pipe (sv);
1335 if (tem < 0)
1336 report_file_error ("Creating pipe", Qnil);
1337 inchannel = sv[0];
1338 forkout = sv[1];
1339 tem = pipe (sv);
1340 if (tem < 0)
1342 emacs_close (inchannel);
1343 emacs_close (forkout);
1344 report_file_error ("Creating pipe", Qnil);
1346 outchannel = sv[1];
1347 forkin = sv[0];
1349 #endif /* not SKTPAIR */
1351 #if 0
1352 /* Replaced by close_process_descs */
1353 set_exclusive_use (inchannel);
1354 set_exclusive_use (outchannel);
1355 #endif
1357 /* Stride people say it's a mystery why this is needed
1358 as well as the O_NDELAY, but that it fails without this. */
1359 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1361 int one = 1;
1362 ioctl (inchannel, FIONBIO, &one);
1364 #endif
1366 #ifdef O_NONBLOCK
1367 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1368 fcntl (outchannel, F_SETFL, O_NONBLOCK);
1369 #else
1370 #ifdef O_NDELAY
1371 fcntl (inchannel, F_SETFL, O_NDELAY);
1372 fcntl (outchannel, F_SETFL, O_NDELAY);
1373 #endif
1374 #endif
1376 /* Record this as an active process, with its channels.
1377 As a result, child_setup will close Emacs's side of the pipes. */
1378 chan_process[inchannel] = process;
1379 XSETINT (XPROCESS (process)->infd, inchannel);
1380 XSETINT (XPROCESS (process)->outfd, outchannel);
1381 /* Record the tty descriptor used in the subprocess. */
1382 if (forkin < 0)
1383 XPROCESS (process)->subtty = Qnil;
1384 else
1385 XSETFASTINT (XPROCESS (process)->subtty, forkin);
1386 XPROCESS (process)->pty_flag = (pty_flag ? Qt : Qnil);
1387 XPROCESS (process)->status = Qrun;
1388 if (!proc_decode_coding_system[inchannel])
1389 proc_decode_coding_system[inchannel]
1390 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1391 setup_coding_system (XPROCESS (process)->decode_coding_system,
1392 proc_decode_coding_system[inchannel]);
1393 if (!proc_encode_coding_system[outchannel])
1394 proc_encode_coding_system[outchannel]
1395 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1396 setup_coding_system (XPROCESS (process)->encode_coding_system,
1397 proc_encode_coding_system[outchannel]);
1399 if ((!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters))
1400 || (NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters)))
1402 /* In unibyte mode, character code conversion should not take
1403 place but EOL conversion should. So, setup raw-text or one
1404 of the subsidiary according to the information just setup. */
1405 if (!NILP (XPROCESS (process)->decode_coding_system))
1406 setup_raw_text_coding_system (proc_decode_coding_system[inchannel]);
1407 if (!NILP (XPROCESS (process)->encode_coding_system))
1408 setup_raw_text_coding_system (proc_encode_coding_system[outchannel]);
1411 if (CODING_REQUIRE_ENCODING (proc_encode_coding_system[outchannel]))
1413 /* Here we encode arguments by the coding system used for
1414 sending data to the process. We don't support using
1415 different coding systems for encoding arguments and for
1416 encoding data sent to the process. */
1417 struct gcpro gcpro1;
1418 int i = 1;
1419 struct coding_system *coding = proc_encode_coding_system[outchannel];
1421 coding->mode |= CODING_MODE_LAST_BLOCK;
1422 GCPRO1 (process);
1423 while (new_argv[i] != 0)
1425 int len = strlen (new_argv[i]);
1426 int size = encoding_buffer_size (coding, len);
1427 unsigned char *buf = (unsigned char *) alloca (size);
1429 encode_coding (coding, (unsigned char *)new_argv[i], buf, len, size);
1430 buf[coding->produced] = 0;
1431 /* We don't have to free new_argv[i] because it points to a
1432 Lisp string given as an argument to `start-process'. */
1433 new_argv[i++] = (char *) buf;
1435 UNGCPRO;
1436 coding->mode &= ~CODING_MODE_LAST_BLOCK;
1439 /* Delay interrupts until we have a chance to store
1440 the new fork's pid in its process structure */
1441 #ifdef POSIX_SIGNALS
1442 sigemptyset (&blocked);
1443 #ifdef SIGCHLD
1444 sigaddset (&blocked, SIGCHLD);
1445 #endif
1446 #ifdef HAVE_VFORK
1447 /* On many hosts (e.g. Solaris 2.4), if a vforked child calls `signal',
1448 this sets the parent's signal handlers as well as the child's.
1449 So delay all interrupts whose handlers the child might munge,
1450 and record the current handlers so they can be restored later. */
1451 sigaddset (&blocked, SIGINT ); sigaction (SIGINT , 0, &sigint_action );
1452 sigaddset (&blocked, SIGQUIT); sigaction (SIGQUIT, 0, &sigquit_action);
1453 #ifdef AIX
1454 sigaddset (&blocked, SIGHUP ); sigaction (SIGHUP , 0, &sighup_action );
1455 #endif
1456 #endif /* HAVE_VFORK */
1457 sigprocmask (SIG_BLOCK, &blocked, &procmask);
1458 #else /* !POSIX_SIGNALS */
1459 #ifdef SIGCHLD
1460 #ifdef BSD4_1
1461 sighold (SIGCHLD);
1462 #else /* not BSD4_1 */
1463 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1464 sigsetmask (sigmask (SIGCHLD));
1465 #else /* ordinary USG */
1466 #if 0
1467 sigchld_deferred = 0;
1468 sigchld = signal (SIGCHLD, create_process_sigchld);
1469 #endif
1470 #endif /* ordinary USG */
1471 #endif /* not BSD4_1 */
1472 #endif /* SIGCHLD */
1473 #endif /* !POSIX_SIGNALS */
1475 FD_SET (inchannel, &input_wait_mask);
1476 FD_SET (inchannel, &non_keyboard_wait_mask);
1477 if (inchannel > max_process_desc)
1478 max_process_desc = inchannel;
1480 /* Until we store the proper pid, enable sigchld_handler
1481 to recognize an unknown pid as standing for this process.
1482 It is very important not to let this `marker' value stay
1483 in the table after this function has returned; if it does
1484 it might cause call-process to hang and subsequent asynchronous
1485 processes to get their return values scrambled. */
1486 XSETINT (XPROCESS (process)->pid, -1);
1488 BLOCK_INPUT;
1491 /* child_setup must clobber environ on systems with true vfork.
1492 Protect it from permanent change. */
1493 char **save_environ = environ;
1495 current_dir = ENCODE_FILE (current_dir);
1497 #ifndef WINDOWSNT
1498 pid = vfork ();
1499 if (pid == 0)
1500 #endif /* not WINDOWSNT */
1502 int xforkin = forkin;
1503 int xforkout = forkout;
1505 #if 0 /* This was probably a mistake--it duplicates code later on,
1506 but fails to handle all the cases. */
1507 /* Make sure SIGCHLD is not blocked in the child. */
1508 sigsetmask (SIGEMPTYMASK);
1509 #endif
1511 /* Make the pty be the controlling terminal of the process. */
1512 #ifdef HAVE_PTYS
1513 /* First, disconnect its current controlling terminal. */
1514 #ifdef HAVE_SETSID
1515 /* We tried doing setsid only if pty_flag, but it caused
1516 process_set_signal to fail on SGI when using a pipe. */
1517 setsid ();
1518 /* Make the pty's terminal the controlling terminal. */
1519 if (pty_flag)
1521 #ifdef TIOCSCTTY
1522 /* We ignore the return value
1523 because faith@cs.unc.edu says that is necessary on Linux. */
1524 ioctl (xforkin, TIOCSCTTY, 0);
1525 #endif
1527 #else /* not HAVE_SETSID */
1528 #ifdef USG
1529 /* It's very important to call setpgrp here and no time
1530 afterwards. Otherwise, we lose our controlling tty which
1531 is set when we open the pty. */
1532 setpgrp ();
1533 #endif /* USG */
1534 #endif /* not HAVE_SETSID */
1535 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1536 if (pty_flag && xforkin >= 0)
1538 struct termios t;
1539 tcgetattr (xforkin, &t);
1540 t.c_lflag = LDISC1;
1541 if (tcsetattr (xforkin, TCSANOW, &t) < 0)
1542 emacs_write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1544 #else
1545 #if defined (NTTYDISC) && defined (TIOCSETD)
1546 if (pty_flag && xforkin >= 0)
1548 /* Use new line discipline. */
1549 int ldisc = NTTYDISC;
1550 ioctl (xforkin, TIOCSETD, &ldisc);
1552 #endif
1553 #endif
1554 #ifdef TIOCNOTTY
1555 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1556 can do TIOCSPGRP only to the process's controlling tty. */
1557 if (pty_flag)
1559 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1560 I can't test it since I don't have 4.3. */
1561 int j = emacs_open ("/dev/tty", O_RDWR, 0);
1562 ioctl (j, TIOCNOTTY, 0);
1563 emacs_close (j);
1564 #ifndef USG
1565 /* In order to get a controlling terminal on some versions
1566 of BSD, it is necessary to put the process in pgrp 0
1567 before it opens the terminal. */
1568 #ifdef HAVE_SETPGID
1569 setpgid (0, 0);
1570 #else
1571 setpgrp (0, 0);
1572 #endif
1573 #endif
1575 #endif /* TIOCNOTTY */
1577 #if !defined (RTU) && !defined (UNIPLUS) && !defined (DONT_REOPEN_PTY)
1578 /*** There is a suggestion that this ought to be a
1579 conditional on TIOCSPGRP,
1580 or !(defined (HAVE_SETSID) && defined (TIOCSCTTY)).
1581 Trying the latter gave the wrong results on Debian GNU/Linux 1.1;
1582 that system does seem to need this code, even though
1583 both HAVE_SETSID and TIOCSCTTY are defined. */
1584 /* Now close the pty (if we had it open) and reopen it.
1585 This makes the pty the controlling terminal of the subprocess. */
1586 if (pty_flag)
1588 #ifdef SET_CHILD_PTY_PGRP
1589 int pgrp = getpid ();
1590 #endif
1592 /* I wonder if emacs_close (emacs_open (pty_name, ...))
1593 would work? */
1594 if (xforkin >= 0)
1595 emacs_close (xforkin);
1596 xforkout = xforkin = emacs_open (pty_name, O_RDWR, 0);
1598 if (xforkin < 0)
1600 emacs_write (1, "Couldn't open the pty terminal ", 31);
1601 emacs_write (1, pty_name, strlen (pty_name));
1602 emacs_write (1, "\n", 1);
1603 _exit (1);
1606 #ifdef SET_CHILD_PTY_PGRP
1607 ioctl (xforkin, TIOCSPGRP, &pgrp);
1608 ioctl (xforkout, TIOCSPGRP, &pgrp);
1609 #endif
1611 #endif /* not UNIPLUS and not RTU and not DONT_REOPEN_PTY */
1613 #ifdef SETUP_SLAVE_PTY
1614 if (pty_flag)
1616 SETUP_SLAVE_PTY;
1618 #endif /* SETUP_SLAVE_PTY */
1619 #ifdef AIX
1620 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1621 Now reenable it in the child, so it will die when we want it to. */
1622 if (pty_flag)
1623 signal (SIGHUP, SIG_DFL);
1624 #endif
1625 #endif /* HAVE_PTYS */
1627 signal (SIGINT, SIG_DFL);
1628 signal (SIGQUIT, SIG_DFL);
1630 /* Stop blocking signals in the child. */
1631 #ifdef POSIX_SIGNALS
1632 sigprocmask (SIG_SETMASK, &procmask, 0);
1633 #else /* !POSIX_SIGNALS */
1634 #ifdef SIGCHLD
1635 #ifdef BSD4_1
1636 sigrelse (SIGCHLD);
1637 #else /* not BSD4_1 */
1638 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1639 sigsetmask (SIGEMPTYMASK);
1640 #else /* ordinary USG */
1641 #if 0
1642 signal (SIGCHLD, sigchld);
1643 #endif
1644 #endif /* ordinary USG */
1645 #endif /* not BSD4_1 */
1646 #endif /* SIGCHLD */
1647 #endif /* !POSIX_SIGNALS */
1649 if (pty_flag)
1650 child_setup_tty (xforkout);
1651 #ifdef WINDOWSNT
1652 pid = child_setup (xforkin, xforkout, xforkout,
1653 new_argv, 1, current_dir);
1654 #else /* not WINDOWSNT */
1655 child_setup (xforkin, xforkout, xforkout,
1656 new_argv, 1, current_dir);
1657 #endif /* not WINDOWSNT */
1659 environ = save_environ;
1662 UNBLOCK_INPUT;
1664 /* This runs in the Emacs process. */
1665 if (pid < 0)
1667 if (forkin >= 0)
1668 emacs_close (forkin);
1669 if (forkin != forkout && forkout >= 0)
1670 emacs_close (forkout);
1672 else
1674 /* vfork succeeded. */
1675 XSETFASTINT (XPROCESS (process)->pid, pid);
1677 #ifdef WINDOWSNT
1678 register_child (pid, inchannel);
1679 #endif /* WINDOWSNT */
1681 /* If the subfork execv fails, and it exits,
1682 this close hangs. I don't know why.
1683 So have an interrupt jar it loose. */
1685 struct atimer *timer;
1686 EMACS_TIME offset;
1688 stop_polling ();
1689 EMACS_SET_SECS_USECS (offset, 1, 0);
1690 timer = start_atimer (ATIMER_RELATIVE, offset, create_process_1, 0);
1692 XPROCESS (process)->subtty = Qnil;
1693 if (forkin >= 0)
1694 emacs_close (forkin);
1696 cancel_atimer (timer);
1697 start_polling ();
1700 if (forkin != forkout && forkout >= 0)
1701 emacs_close (forkout);
1703 #ifdef HAVE_PTYS
1704 if (pty_flag)
1705 XPROCESS (process)->tty_name = build_string (pty_name);
1706 else
1707 #endif
1708 XPROCESS (process)->tty_name = Qnil;
1711 /* Restore the signal state whether vfork succeeded or not.
1712 (We will signal an error, below, if it failed.) */
1713 #ifdef POSIX_SIGNALS
1714 #ifdef HAVE_VFORK
1715 /* Restore the parent's signal handlers. */
1716 sigaction (SIGINT, &sigint_action, 0);
1717 sigaction (SIGQUIT, &sigquit_action, 0);
1718 #ifdef AIX
1719 sigaction (SIGHUP, &sighup_action, 0);
1720 #endif
1721 #endif /* HAVE_VFORK */
1722 /* Stop blocking signals in the parent. */
1723 sigprocmask (SIG_SETMASK, &procmask, 0);
1724 #else /* !POSIX_SIGNALS */
1725 #ifdef SIGCHLD
1726 #ifdef BSD4_1
1727 sigrelse (SIGCHLD);
1728 #else /* not BSD4_1 */
1729 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1730 sigsetmask (SIGEMPTYMASK);
1731 #else /* ordinary USG */
1732 #if 0
1733 signal (SIGCHLD, sigchld);
1734 /* Now really handle any of these signals
1735 that came in during this function. */
1736 if (sigchld_deferred)
1737 kill (getpid (), SIGCHLD);
1738 #endif
1739 #endif /* ordinary USG */
1740 #endif /* not BSD4_1 */
1741 #endif /* SIGCHLD */
1742 #endif /* !POSIX_SIGNALS */
1744 /* Now generate the error if vfork failed. */
1745 if (pid < 0)
1746 report_file_error ("Doing vfork", Qnil);
1748 #endif /* not VMS */
1750 #ifdef HAVE_SOCKETS
1752 /* open a TCP network connection to a given HOST/SERVICE. Treated
1753 exactly like a normal process when reading and writing. Only
1754 differences are in status display and process deletion. A network
1755 connection has no PID; you cannot signal it. All you can do is
1756 deactivate and close it via delete-process */
1758 DEFUN ("open-network-stream", Fopen_network_stream, Sopen_network_stream,
1759 4, 4, 0,
1760 "Open a TCP connection for a service to a host.\n\
1761 Returns a subprocess-object to represent the connection.\n\
1762 Input and output work as for subprocesses; `delete-process' closes it.\n\
1763 Args are NAME BUFFER HOST SERVICE.\n\
1764 NAME is name for process. It is modified if necessary to make it unique.\n\
1765 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1766 Process output goes at end of that buffer, unless you specify\n\
1767 an output stream or filter function to handle the output.\n\
1768 BUFFER may be also nil, meaning that this process is not associated\n\
1769 with any buffer\n\
1770 Third arg is name of the host to connect to, or its IP address.\n\
1771 Fourth arg SERVICE is name of the service desired, or an integer\n\
1772 specifying a port number to connect to.")
1773 (name, buffer, host, service)
1774 Lisp_Object name, buffer, host, service;
1776 Lisp_Object proc;
1777 #ifndef HAVE_GETADDRINFO
1778 struct sockaddr_in address;
1779 struct servent *svc_info;
1780 struct hostent *host_info_ptr, host_info;
1781 char *(addr_list[2]);
1782 IN_ADDR numeric_addr;
1783 int port;
1784 #else /* HAVE_GETADDRINFO */
1785 struct addrinfo hints, *res, *lres;
1786 int ret = 0;
1787 int xerrno = 0;
1788 char *portstring, portbuf[128];
1789 #endif /* HAVE_GETADDRINFO */
1790 int s = -1, outch, inch;
1791 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1792 int retry = 0;
1793 int count = specpdl_ptr - specpdl;
1794 int count1;
1796 #ifdef WINDOWSNT
1797 /* Ensure socket support is loaded if available. */
1798 init_winsock (TRUE);
1799 #endif
1801 GCPRO4 (name, buffer, host, service);
1802 CHECK_STRING (name, 0);
1803 CHECK_STRING (host, 0);
1805 #ifdef HAVE_GETADDRINFO
1807 * SERVICE can either be a string or int.
1808 * Convert to a C string for later use by getaddrinfo.
1810 if (INTEGERP (service))
1812 sprintf (portbuf, "%d", XINT (service));
1813 portstring = portbuf;
1815 else
1817 CHECK_STRING (service, 0);
1818 portstring = XSTRING (service)->data;
1820 #else /* ! HAVE_GETADDRINFO */
1821 if (INTEGERP (service))
1822 port = htons ((unsigned short) XINT (service));
1823 else
1825 CHECK_STRING (service, 0);
1826 svc_info = getservbyname (XSTRING (service)->data, "tcp");
1827 if (svc_info == 0)
1828 error ("Unknown service \"%s\"", XSTRING (service)->data);
1829 port = svc_info->s_port;
1831 #endif /* ! HAVE_GETADDRINFO */
1834 /* Slow down polling to every ten seconds.
1835 Some kernels have a bug which causes retrying connect to fail
1836 after a connect. Polling can interfere with gethostbyname too. */
1837 #ifdef POLL_FOR_INPUT
1838 record_unwind_protect (unwind_stop_other_atimers, Qnil);
1839 bind_polling_period (10);
1840 #endif
1842 #ifndef TERM
1843 #ifdef HAVE_GETADDRINFO
1845 immediate_quit = 1;
1846 QUIT;
1847 memset (&hints, 0, sizeof (hints));
1848 hints.ai_flags = 0;
1849 hints.ai_family = AF_UNSPEC;
1850 hints.ai_socktype = SOCK_STREAM;
1851 hints.ai_protocol = 0;
1852 ret = getaddrinfo (XSTRING (host)->data, portstring, &hints, &res);
1853 if (ret)
1855 error ("%s/%s %s", XSTRING (host)->data, portstring,
1856 strerror (ret));
1858 immediate_quit = 0;
1861 s = -1;
1862 count1 = specpdl_ptr - specpdl;
1863 record_unwind_protect (close_file_unwind, make_number (s));
1865 for (lres = res; lres; lres = lres->ai_next)
1867 s = socket (lres->ai_family, lres->ai_socktype, lres->ai_protocol);
1868 if (s < 0)
1869 continue;
1871 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1872 when connect is interrupted. So let's not let it get interrupted.
1873 Note we do not turn off polling, because polling is only used
1874 when not interrupt_input, and thus not normally used on the systems
1875 which have this bug. On systems which use polling, there's no way
1876 to quit if polling is turned off. */
1877 if (interrupt_input)
1878 unrequest_sigio ();
1880 immediate_quit = 1;
1881 QUIT;
1883 ret = connect (s, lres->ai_addr, lres->ai_addrlen);
1884 if (ret == 0)
1885 break;
1886 emacs_close (s);
1887 s = -1;
1890 freeaddrinfo (res);
1891 if (s < 0)
1893 if (interrupt_input)
1894 request_sigio ();
1896 errno = xerrno;
1897 report_file_error ("connection failed",
1898 Fcons (host, Fcons (name, Qnil)));
1900 #else /* ! HAVE_GETADDRINFO */
1902 while (1)
1904 #if 0
1905 #ifdef TRY_AGAIN
1906 h_errno = 0;
1907 #endif
1908 #endif
1909 immediate_quit = 1;
1910 QUIT;
1911 host_info_ptr = gethostbyname (XSTRING (host)->data);
1912 immediate_quit = 0;
1913 #if 0
1914 #ifdef TRY_AGAIN
1915 if (! (host_info_ptr == 0 && h_errno == TRY_AGAIN))
1916 #endif
1917 #endif
1918 break;
1919 Fsleep_for (make_number (1), Qnil);
1921 if (host_info_ptr == 0)
1922 /* Attempt to interpret host as numeric inet address */
1924 numeric_addr = inet_addr ((char *) XSTRING (host)->data);
1925 if (NUMERIC_ADDR_ERROR)
1926 error ("Unknown host \"%s\"", XSTRING (host)->data);
1928 host_info_ptr = &host_info;
1929 host_info.h_name = 0;
1930 host_info.h_aliases = 0;
1931 host_info.h_addrtype = AF_INET;
1932 #ifdef h_addr
1933 /* Older machines have only one address slot called h_addr.
1934 Newer machines have h_addr_list, but #define h_addr to
1935 be its first element. */
1936 host_info.h_addr_list = &(addr_list[0]);
1937 #endif
1938 host_info.h_addr = (char*)(&numeric_addr);
1939 addr_list[1] = 0;
1940 /* numeric_addr isn't null-terminated; it has fixed length. */
1941 host_info.h_length = sizeof (numeric_addr);
1944 bzero (&address, sizeof address);
1945 bcopy (host_info_ptr->h_addr, (char *) &address.sin_addr,
1946 host_info_ptr->h_length);
1947 address.sin_family = host_info_ptr->h_addrtype;
1948 address.sin_port = port;
1950 s = socket (host_info_ptr->h_addrtype, SOCK_STREAM, 0);
1951 if (s < 0)
1952 report_file_error ("error creating socket", Fcons (name, Qnil));
1954 count1 = specpdl_ptr - specpdl;
1955 record_unwind_protect (close_file_unwind, make_number (s));
1957 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1958 when connect is interrupted. So let's not let it get interrupted.
1959 Note we do not turn off polling, because polling is only used
1960 when not interrupt_input, and thus not normally used on the systems
1961 which have this bug. On systems which use polling, there's no way
1962 to quit if polling is turned off. */
1963 if (interrupt_input)
1964 unrequest_sigio ();
1966 loop:
1968 immediate_quit = 1;
1969 QUIT;
1971 if (connect (s, (struct sockaddr *) &address, sizeof address) == -1
1972 && errno != EISCONN)
1974 int xerrno = errno;
1976 immediate_quit = 0;
1978 if (errno == EINTR)
1979 goto loop;
1980 if (errno == EADDRINUSE && retry < 20)
1982 /* A delay here is needed on some FreeBSD systems,
1983 and it is harmless, since this retrying takes time anyway
1984 and should be infrequent. */
1985 Fsleep_for (make_number (1), Qnil);
1986 retry++;
1987 goto loop;
1990 /* Discard the unwind protect. */
1991 specpdl_ptr = specpdl + count1;
1993 emacs_close (s);
1995 if (interrupt_input)
1996 request_sigio ();
1998 errno = xerrno;
1999 report_file_error ("connection failed",
2000 Fcons (host, Fcons (name, Qnil)));
2002 #endif /* ! HAVE_GETADDRINFO */
2004 immediate_quit = 0;
2006 /* Discard the unwind protect. */
2007 specpdl_ptr = specpdl + count1;
2009 #ifdef POLL_FOR_INPUT
2010 unbind_to (count, Qnil);
2011 #endif
2013 if (interrupt_input)
2014 request_sigio ();
2016 #else /* TERM */
2017 s = connect_server (0);
2018 if (s < 0)
2019 report_file_error ("error creating socket", Fcons (name, Qnil));
2020 send_command (s, C_PORT, 0, "%s:%d", XSTRING (host)->data, ntohs (port));
2021 send_command (s, C_DUMB, 1, 0);
2022 #endif /* TERM */
2024 inch = s;
2025 outch = s;
2027 if (!NILP (buffer))
2028 buffer = Fget_buffer_create (buffer);
2029 proc = make_process (name);
2031 chan_process[inch] = proc;
2033 #ifdef O_NONBLOCK
2034 fcntl (inch, F_SETFL, O_NONBLOCK);
2035 #else
2036 #ifdef O_NDELAY
2037 fcntl (inch, F_SETFL, O_NDELAY);
2038 #endif
2039 #endif
2041 XPROCESS (proc)->childp = Fcons (host, Fcons (service, Qnil));
2042 XPROCESS (proc)->command_channel_p = Qnil;
2043 XPROCESS (proc)->buffer = buffer;
2044 XPROCESS (proc)->sentinel = Qnil;
2045 XPROCESS (proc)->filter = Qnil;
2046 XPROCESS (proc)->command = Qnil;
2047 XPROCESS (proc)->pid = Qnil;
2048 XSETINT (XPROCESS (proc)->infd, inch);
2049 XSETINT (XPROCESS (proc)->outfd, outch);
2050 XPROCESS (proc)->status = Qrun;
2051 FD_SET (inch, &input_wait_mask);
2052 FD_SET (inch, &non_keyboard_wait_mask);
2053 if (inch > max_process_desc)
2054 max_process_desc = inch;
2057 /* Setup coding systems for communicating with the network stream. */
2058 struct gcpro gcpro1;
2059 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
2060 Lisp_Object coding_systems = Qt;
2061 Lisp_Object args[5], val;
2063 if (!NILP (Vcoding_system_for_read))
2064 val = Vcoding_system_for_read;
2065 else if ((!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters))
2066 || (NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters)))
2067 /* We dare not decode end-of-line format by setting VAL to
2068 Qraw_text, because the existing Emacs Lisp libraries
2069 assume that they receive bare code including a sequene of
2070 CR LF. */
2071 val = Qnil;
2072 else
2074 args[0] = Qopen_network_stream, args[1] = name,
2075 args[2] = buffer, args[3] = host, args[4] = service;
2076 GCPRO1 (proc);
2077 coding_systems = Ffind_operation_coding_system (5, args);
2078 UNGCPRO;
2079 if (CONSP (coding_systems))
2080 val = XCAR (coding_systems);
2081 else if (CONSP (Vdefault_process_coding_system))
2082 val = XCAR (Vdefault_process_coding_system);
2083 else
2084 val = Qnil;
2086 XPROCESS (proc)->decode_coding_system = val;
2088 if (!NILP (Vcoding_system_for_write))
2089 val = Vcoding_system_for_write;
2090 else if (NILP (current_buffer->enable_multibyte_characters))
2091 val = Qnil;
2092 else
2094 if (EQ (coding_systems, Qt))
2096 args[0] = Qopen_network_stream, args[1] = name,
2097 args[2] = buffer, args[3] = host, args[4] = service;
2098 GCPRO1 (proc);
2099 coding_systems = Ffind_operation_coding_system (5, args);
2100 UNGCPRO;
2102 if (CONSP (coding_systems))
2103 val = XCDR (coding_systems);
2104 else if (CONSP (Vdefault_process_coding_system))
2105 val = XCDR (Vdefault_process_coding_system);
2106 else
2107 val = Qnil;
2109 XPROCESS (proc)->encode_coding_system = val;
2112 if (!proc_decode_coding_system[inch])
2113 proc_decode_coding_system[inch]
2114 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
2115 setup_coding_system (XPROCESS (proc)->decode_coding_system,
2116 proc_decode_coding_system[inch]);
2117 if (!proc_encode_coding_system[outch])
2118 proc_encode_coding_system[outch]
2119 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
2120 setup_coding_system (XPROCESS (proc)->encode_coding_system,
2121 proc_encode_coding_system[outch]);
2123 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
2124 XPROCESS (proc)->decoding_carryover = make_number (0);
2125 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
2126 XPROCESS (proc)->encoding_carryover = make_number (0);
2128 XPROCESS (proc)->inherit_coding_system_flag
2129 = (NILP (buffer) || !inherit_process_coding_system
2130 ? Qnil : Qt);
2132 UNGCPRO;
2133 return proc;
2135 #endif /* HAVE_SOCKETS */
2137 void
2138 deactivate_process (proc)
2139 Lisp_Object proc;
2141 register int inchannel, outchannel;
2142 register struct Lisp_Process *p = XPROCESS (proc);
2144 inchannel = XINT (p->infd);
2145 outchannel = XINT (p->outfd);
2147 if (inchannel >= 0)
2149 /* Beware SIGCHLD hereabouts. */
2150 flush_pending_output (inchannel);
2151 #ifdef VMS
2153 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
2154 sys$dassgn (outchannel);
2155 vs = get_vms_process_pointer (p->pid);
2156 if (vs)
2157 give_back_vms_process_stuff (vs);
2159 #else
2160 emacs_close (inchannel);
2161 if (outchannel >= 0 && outchannel != inchannel)
2162 emacs_close (outchannel);
2163 #endif
2165 XSETINT (p->infd, -1);
2166 XSETINT (p->outfd, -1);
2167 chan_process[inchannel] = Qnil;
2168 FD_CLR (inchannel, &input_wait_mask);
2169 FD_CLR (inchannel, &non_keyboard_wait_mask);
2170 if (inchannel == max_process_desc)
2172 int i;
2173 /* We just closed the highest-numbered process input descriptor,
2174 so recompute the highest-numbered one now. */
2175 max_process_desc = 0;
2176 for (i = 0; i < MAXDESC; i++)
2177 if (!NILP (chan_process[i]))
2178 max_process_desc = i;
2183 /* Close all descriptors currently in use for communication
2184 with subprocess. This is used in a newly-forked subprocess
2185 to get rid of irrelevant descriptors. */
2187 void
2188 close_process_descs ()
2190 #ifndef WINDOWSNT
2191 int i;
2192 for (i = 0; i < MAXDESC; i++)
2194 Lisp_Object process;
2195 process = chan_process[i];
2196 if (!NILP (process))
2198 int in = XINT (XPROCESS (process)->infd);
2199 int out = XINT (XPROCESS (process)->outfd);
2200 if (in >= 0)
2201 emacs_close (in);
2202 if (out >= 0 && in != out)
2203 emacs_close (out);
2206 #endif
2209 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
2210 0, 3, 0,
2211 "Allow any pending output from subprocesses to be read by Emacs.\n\
2212 It is read into the process' buffers or given to their filter functions.\n\
2213 Non-nil arg PROCESS means do not return until some output has been received\n\
2214 from PROCESS.\n\
2215 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
2216 seconds and microseconds to wait; return after that much time whether\n\
2217 or not there is input.\n\
2218 Return non-nil iff we received any output before the timeout expired.")
2219 (process, timeout, timeout_msecs)
2220 register Lisp_Object process, timeout, timeout_msecs;
2222 int seconds;
2223 int useconds;
2225 if (! NILP (process))
2226 CHECK_PROCESS (process, 0);
2228 if (! NILP (timeout_msecs))
2230 CHECK_NUMBER (timeout_msecs, 2);
2231 useconds = XINT (timeout_msecs);
2232 if (!INTEGERP (timeout))
2233 XSETINT (timeout, 0);
2236 int carry = useconds / 1000000;
2238 XSETINT (timeout, XINT (timeout) + carry);
2239 useconds -= carry * 1000000;
2241 /* I think this clause is necessary because C doesn't
2242 guarantee a particular rounding direction for negative
2243 integers. */
2244 if (useconds < 0)
2246 XSETINT (timeout, XINT (timeout) - 1);
2247 useconds += 1000000;
2251 else
2252 useconds = 0;
2254 if (! NILP (timeout))
2256 CHECK_NUMBER (timeout, 1);
2257 seconds = XINT (timeout);
2258 if (seconds < 0 || (seconds == 0 && useconds == 0))
2259 seconds = -1;
2261 else
2263 if (NILP (process))
2264 seconds = -1;
2265 else
2266 seconds = 0;
2269 if (NILP (process))
2270 XSETFASTINT (process, 0);
2272 return
2273 (wait_reading_process_input (seconds, useconds, process, 0)
2274 ? Qt : Qnil);
2277 /* This variable is different from waiting_for_input in keyboard.c.
2278 It is used to communicate to a lisp process-filter/sentinel (via the
2279 function Fwaiting_for_user_input_p below) whether emacs was waiting
2280 for user-input when that process-filter was called.
2281 waiting_for_input cannot be used as that is by definition 0 when
2282 lisp code is being evalled.
2283 This is also used in record_asynch_buffer_change.
2284 For that purpose, this must be 0
2285 when not inside wait_reading_process_input. */
2286 static int waiting_for_user_input_p;
2288 /* This is here so breakpoints can be put on it. */
2289 static void
2290 wait_reading_process_input_1 ()
2294 /* Read and dispose of subprocess output while waiting for timeout to
2295 elapse and/or keyboard input to be available.
2297 TIME_LIMIT is:
2298 timeout in seconds, or
2299 zero for no limit, or
2300 -1 means gobble data immediately available but don't wait for any.
2302 MICROSECS is:
2303 an additional duration to wait, measured in microseconds.
2304 If this is nonzero and time_limit is 0, then the timeout
2305 consists of MICROSECS only.
2307 READ_KBD is a lisp value:
2308 0 to ignore keyboard input, or
2309 1 to return when input is available, or
2310 -1 meaning caller will actually read the input, so don't throw to
2311 the quit handler, or
2312 a cons cell, meaning wait until its car is non-nil
2313 (and gobble terminal input into the buffer if any arrives), or
2314 a process object, meaning wait until something arrives from that
2315 process. The return value is true iff we read some input from
2316 that process.
2318 DO_DISPLAY != 0 means redisplay should be done to show subprocess
2319 output that arrives.
2321 If READ_KBD is a pointer to a struct Lisp_Process, then the
2322 function returns true iff we received input from that process
2323 before the timeout elapsed.
2324 Otherwise, return true iff we received input from any process. */
2327 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
2328 int time_limit, microsecs;
2329 Lisp_Object read_kbd;
2330 int do_display;
2332 register int channel, nfds;
2333 static SELECT_TYPE Available;
2334 int xerrno;
2335 Lisp_Object proc;
2336 EMACS_TIME timeout, end_time;
2337 SELECT_TYPE Atemp;
2338 int wait_channel = -1;
2339 struct Lisp_Process *wait_proc = 0;
2340 int got_some_input = 0;
2341 Lisp_Object *wait_for_cell = 0;
2343 FD_ZERO (&Available);
2345 /* If read_kbd is a process to watch, set wait_proc and wait_channel
2346 accordingly. */
2347 if (PROCESSP (read_kbd))
2349 wait_proc = XPROCESS (read_kbd);
2350 wait_channel = XINT (wait_proc->infd);
2351 XSETFASTINT (read_kbd, 0);
2354 /* If waiting for non-nil in a cell, record where. */
2355 if (CONSP (read_kbd))
2357 wait_for_cell = &XCAR (read_kbd);
2358 XSETFASTINT (read_kbd, 0);
2361 waiting_for_user_input_p = XINT (read_kbd);
2363 /* Since we may need to wait several times,
2364 compute the absolute time to return at. */
2365 if (time_limit || microsecs)
2367 EMACS_GET_TIME (end_time);
2368 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
2369 EMACS_ADD_TIME (end_time, end_time, timeout);
2371 #ifdef hpux
2372 /* AlainF 5-Jul-1996
2373 HP-UX 10.10 seem to have problems with signals coming in
2374 Causes "poll: interrupted system call" messages when Emacs is run
2375 in an X window
2376 Turn off periodic alarms (in case they are in use) */
2377 turn_on_atimers (0);
2378 #endif
2380 while (1)
2382 int timeout_reduced_for_timers = 0;
2384 #ifdef HAVE_X_WINDOWS
2385 if (display_busy_cursor_p)
2386 Fx_hide_busy_cursor (Qnil);
2387 #endif
2389 /* If calling from keyboard input, do not quit
2390 since we want to return C-g as an input character.
2391 Otherwise, do pending quit if requested. */
2392 if (XINT (read_kbd) >= 0)
2393 QUIT;
2395 /* Exit now if the cell we're waiting for became non-nil. */
2396 if (wait_for_cell && ! NILP (*wait_for_cell))
2397 break;
2399 /* Compute time from now till when time limit is up */
2400 /* Exit if already run out */
2401 if (time_limit == -1)
2403 /* -1 specified for timeout means
2404 gobble output available now
2405 but don't wait at all. */
2407 EMACS_SET_SECS_USECS (timeout, 0, 0);
2409 else if (time_limit || microsecs)
2411 EMACS_GET_TIME (timeout);
2412 EMACS_SUB_TIME (timeout, end_time, timeout);
2413 if (EMACS_TIME_NEG_P (timeout))
2414 break;
2416 else
2418 EMACS_SET_SECS_USECS (timeout, 100000, 0);
2421 /* Normally we run timers here.
2422 But not if wait_for_cell; in those cases,
2423 the wait is supposed to be short,
2424 and those callers cannot handle running arbitrary Lisp code here. */
2425 if (! wait_for_cell)
2427 EMACS_TIME timer_delay;
2428 int old_timers_run;
2430 retry:
2431 old_timers_run = timers_run;
2432 timer_delay = timer_check (1);
2433 if (timers_run != old_timers_run && do_display)
2435 redisplay_preserve_echo_area ();
2436 /* We must retry, since a timer may have requeued itself
2437 and that could alter the time_delay. */
2438 goto retry;
2441 /* If there is unread keyboard input, also return. */
2442 if (XINT (read_kbd) != 0
2443 && requeued_events_pending_p ())
2444 break;
2446 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
2448 EMACS_TIME difference;
2449 EMACS_SUB_TIME (difference, timer_delay, timeout);
2450 if (EMACS_TIME_NEG_P (difference))
2452 timeout = timer_delay;
2453 timeout_reduced_for_timers = 1;
2456 /* If time_limit is -1, we are not going to wait at all. */
2457 else if (time_limit != -1)
2459 /* This is so a breakpoint can be put here. */
2460 wait_reading_process_input_1 ();
2464 /* Cause C-g and alarm signals to take immediate action,
2465 and cause input available signals to zero out timeout.
2467 It is important that we do this before checking for process
2468 activity. If we get a SIGCHLD after the explicit checks for
2469 process activity, timeout is the only way we will know. */
2470 if (XINT (read_kbd) < 0)
2471 set_waiting_for_input (&timeout);
2473 /* If status of something has changed, and no input is
2474 available, notify the user of the change right away. After
2475 this explicit check, we'll let the SIGCHLD handler zap
2476 timeout to get our attention. */
2477 if (update_tick != process_tick && do_display)
2479 Atemp = input_wait_mask;
2480 EMACS_SET_SECS_USECS (timeout, 0, 0);
2481 if ((select (max (max_process_desc, max_keyboard_desc) + 1,
2482 &Atemp, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2483 &timeout)
2484 <= 0))
2486 /* It's okay for us to do this and then continue with
2487 the loop, since timeout has already been zeroed out. */
2488 clear_waiting_for_input ();
2489 status_notify ();
2493 /* Don't wait for output from a non-running process. */
2494 if (wait_proc != 0 && !NILP (wait_proc->raw_status_low))
2495 update_status (wait_proc);
2496 if (wait_proc != 0
2497 && ! EQ (wait_proc->status, Qrun))
2499 int nread, total_nread = 0;
2501 clear_waiting_for_input ();
2502 XSETPROCESS (proc, wait_proc);
2504 /* Read data from the process, until we exhaust it. */
2505 while (XINT (wait_proc->infd) >= 0)
2507 nread = read_process_output (proc, XINT (wait_proc->infd));
2509 if (nread == 0)
2510 break;
2512 if (0 < nread)
2513 total_nread += nread;
2514 #ifdef EIO
2515 else if (nread == -1 && EIO == errno)
2516 break;
2517 #endif
2518 #ifdef EAGAIN
2519 else if (nread == -1 && EAGAIN == errno)
2520 break;
2521 #endif
2522 #ifdef EWOULDBLOCK
2523 else if (nread == -1 && EWOULDBLOCK == errno)
2524 break;
2525 #endif
2527 if (total_nread > 0 && do_display)
2528 redisplay_preserve_echo_area ();
2530 break;
2533 /* Wait till there is something to do */
2535 if (wait_for_cell)
2536 Available = non_process_wait_mask;
2537 else if (! XINT (read_kbd))
2538 Available = non_keyboard_wait_mask;
2539 else
2540 Available = input_wait_mask;
2542 /* If frame size has changed or the window is newly mapped,
2543 redisplay now, before we start to wait. There is a race
2544 condition here; if a SIGIO arrives between now and the select
2545 and indicates that a frame is trashed, the select may block
2546 displaying a trashed screen. */
2547 if (frame_garbaged && do_display)
2549 clear_waiting_for_input ();
2550 redisplay_preserve_echo_area ();
2551 if (XINT (read_kbd) < 0)
2552 set_waiting_for_input (&timeout);
2555 if (XINT (read_kbd) && detect_input_pending ())
2557 nfds = 0;
2558 FD_ZERO (&Available);
2560 else
2561 nfds = select (max (max_process_desc, max_keyboard_desc) + 1,
2562 &Available, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2563 &timeout);
2565 xerrno = errno;
2567 /* Make C-g and alarm signals set flags again */
2568 clear_waiting_for_input ();
2570 /* If we woke up due to SIGWINCH, actually change size now. */
2571 do_pending_window_change (0);
2573 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
2574 /* We wanted the full specified time, so return now. */
2575 break;
2576 if (nfds < 0)
2578 if (xerrno == EINTR)
2579 FD_ZERO (&Available);
2580 #ifdef ultrix
2581 /* Ultrix select seems to return ENOMEM when it is
2582 interrupted. Treat it just like EINTR. Bleah. Note
2583 that we want to test for the "ultrix" CPP symbol, not
2584 "__ultrix__"; the latter is only defined under GCC, but
2585 not by DEC's bundled CC. -JimB */
2586 else if (xerrno == ENOMEM)
2587 FD_ZERO (&Available);
2588 #endif
2589 #ifdef ALLIANT
2590 /* This happens for no known reason on ALLIANT.
2591 I am guessing that this is the right response. -- RMS. */
2592 else if (xerrno == EFAULT)
2593 FD_ZERO (&Available);
2594 #endif
2595 else if (xerrno == EBADF)
2597 #ifdef AIX
2598 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
2599 the child's closure of the pts gives the parent a SIGHUP, and
2600 the ptc file descriptor is automatically closed,
2601 yielding EBADF here or at select() call above.
2602 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
2603 in m/ibmrt-aix.h), and here we just ignore the select error.
2604 Cleanup occurs c/o status_notify after SIGCLD. */
2605 FD_ZERO (&Available); /* Cannot depend on values returned */
2606 #else
2607 abort ();
2608 #endif
2610 else
2611 error ("select error: %s", emacs_strerror (xerrno));
2613 #if defined(sun) && !defined(USG5_4)
2614 else if (nfds > 0 && keyboard_bit_set (&Available)
2615 && interrupt_input)
2616 /* System sometimes fails to deliver SIGIO.
2618 David J. Mackenzie says that Emacs doesn't compile under
2619 Solaris if this code is enabled, thus the USG5_4 in the CPP
2620 conditional. "I haven't noticed any ill effects so far.
2621 If you find a Solaris expert somewhere, they might know
2622 better." */
2623 kill (getpid (), SIGIO);
2624 #endif
2626 #if 0 /* When polling is used, interrupt_input is 0,
2627 so get_input_pending should read the input.
2628 So this should not be needed. */
2629 /* If we are using polling for input,
2630 and we see input available, make it get read now.
2631 Otherwise it might not actually get read for a second.
2632 And on hpux, since we turn off polling in wait_reading_process_input,
2633 it might never get read at all if we don't spend much time
2634 outside of wait_reading_process_input. */
2635 if (XINT (read_kbd) && interrupt_input
2636 && keyboard_bit_set (&Available)
2637 && input_polling_used ())
2638 kill (getpid (), SIGALRM);
2639 #endif
2641 /* Check for keyboard input */
2642 /* If there is any, return immediately
2643 to give it higher priority than subprocesses */
2645 if (XINT (read_kbd) != 0
2646 && detect_input_pending_run_timers (do_display))
2648 swallow_events (do_display);
2649 if (detect_input_pending_run_timers (do_display))
2650 break;
2653 /* If there is unread keyboard input, also return. */
2654 if (XINT (read_kbd) != 0
2655 && requeued_events_pending_p ())
2656 break;
2658 /* If we are not checking for keyboard input now,
2659 do process events (but don't run any timers).
2660 This is so that X events will be processed.
2661 Otherwise they may have to wait until polling takes place.
2662 That would causes delays in pasting selections, for example.
2664 (We used to do this only if wait_for_cell.) */
2665 if (XINT (read_kbd) == 0 && detect_input_pending ())
2667 swallow_events (do_display);
2668 #if 0 /* Exiting when read_kbd doesn't request that seems wrong, though. */
2669 if (detect_input_pending ())
2670 break;
2671 #endif
2674 /* Exit now if the cell we're waiting for became non-nil. */
2675 if (wait_for_cell && ! NILP (*wait_for_cell))
2676 break;
2678 #ifdef SIGIO
2679 /* If we think we have keyboard input waiting, but didn't get SIGIO,
2680 go read it. This can happen with X on BSD after logging out.
2681 In that case, there really is no input and no SIGIO,
2682 but select says there is input. */
2684 if (XINT (read_kbd) && interrupt_input
2685 && keyboard_bit_set (&Available))
2686 kill (getpid (), SIGIO);
2687 #endif
2689 if (! wait_proc)
2690 got_some_input |= nfds > 0;
2692 /* If checking input just got us a size-change event from X,
2693 obey it now if we should. */
2694 if (XINT (read_kbd) || wait_for_cell)
2695 do_pending_window_change (0);
2697 /* Check for data from a process. */
2698 /* Really FIRST_PROC_DESC should be 0 on Unix,
2699 but this is safer in the short run. */
2700 for (channel = 0; channel <= max_process_desc; channel++)
2702 if (FD_ISSET (channel, &Available)
2703 && FD_ISSET (channel, &non_keyboard_wait_mask))
2705 int nread;
2707 /* If waiting for this channel, arrange to return as
2708 soon as no more input to be processed. No more
2709 waiting. */
2710 if (wait_channel == channel)
2712 wait_channel = -1;
2713 time_limit = -1;
2714 got_some_input = 1;
2716 proc = chan_process[channel];
2717 if (NILP (proc))
2718 continue;
2720 /* Read data from the process, starting with our
2721 buffered-ahead character if we have one. */
2723 nread = read_process_output (proc, channel);
2724 if (nread > 0)
2726 /* Since read_process_output can run a filter,
2727 which can call accept-process-output,
2728 don't try to read from any other processes
2729 before doing the select again. */
2730 FD_ZERO (&Available);
2732 if (do_display)
2733 redisplay_preserve_echo_area ();
2735 #ifdef EWOULDBLOCK
2736 else if (nread == -1 && errno == EWOULDBLOCK)
2738 #endif
2739 /* ISC 4.1 defines both EWOULDBLOCK and O_NONBLOCK,
2740 and Emacs uses O_NONBLOCK, so what we get is EAGAIN. */
2741 #ifdef O_NONBLOCK
2742 else if (nread == -1 && errno == EAGAIN)
2744 #else
2745 #ifdef O_NDELAY
2746 else if (nread == -1 && errno == EAGAIN)
2748 /* Note that we cannot distinguish between no input
2749 available now and a closed pipe.
2750 With luck, a closed pipe will be accompanied by
2751 subprocess termination and SIGCHLD. */
2752 else if (nread == 0 && !NETCONN_P (proc))
2754 #endif /* O_NDELAY */
2755 #endif /* O_NONBLOCK */
2756 #ifdef HAVE_PTYS
2757 /* On some OSs with ptys, when the process on one end of
2758 a pty exits, the other end gets an error reading with
2759 errno = EIO instead of getting an EOF (0 bytes read).
2760 Therefore, if we get an error reading and errno =
2761 EIO, just continue, because the child process has
2762 exited and should clean itself up soon (e.g. when we
2763 get a SIGCHLD).
2765 However, it has been known to happen that the SIGCHLD
2766 got lost. So raise the signl again just in case.
2767 It can't hurt. */
2768 else if (nread == -1 && errno == EIO)
2769 kill (getpid (), SIGCHLD);
2770 #endif /* HAVE_PTYS */
2771 /* If we can detect process termination, don't consider the process
2772 gone just because its pipe is closed. */
2773 #ifdef SIGCHLD
2774 else if (nread == 0 && !NETCONN_P (proc))
2776 #endif
2777 else
2779 /* Preserve status of processes already terminated. */
2780 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2781 deactivate_process (proc);
2782 if (!NILP (XPROCESS (proc)->raw_status_low))
2783 update_status (XPROCESS (proc));
2784 if (EQ (XPROCESS (proc)->status, Qrun))
2785 XPROCESS (proc)->status
2786 = Fcons (Qexit, Fcons (make_number (256), Qnil));
2789 } /* end for each file descriptor */
2790 } /* end while exit conditions not met */
2792 waiting_for_user_input_p = 0;
2794 /* If calling from keyboard input, do not quit
2795 since we want to return C-g as an input character.
2796 Otherwise, do pending quit if requested. */
2797 if (XINT (read_kbd) >= 0)
2799 /* Prevent input_pending from remaining set if we quit. */
2800 clear_input_pending ();
2801 QUIT;
2803 #ifdef hpux
2804 /* AlainF 5-Jul-1996
2805 HP-UX 10.10 seems to have problems with signals coming in
2806 Causes "poll: interrupted system call" messages when Emacs is run
2807 in an X window
2808 Turn periodic alarms back on */
2809 start_polling ();
2810 #endif
2812 #ifdef HAVE_X_WINDOWS
2813 if (display_busy_cursor_p)
2814 if (!inhibit_busy_cursor)
2815 Fx_show_busy_cursor ();
2816 #endif
2818 return got_some_input;
2821 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
2823 static Lisp_Object
2824 read_process_output_call (fun_and_args)
2825 Lisp_Object fun_and_args;
2827 return apply1 (XCAR (fun_and_args), XCDR (fun_and_args));
2830 static Lisp_Object
2831 read_process_output_error_handler (error)
2832 Lisp_Object error;
2834 cmd_error_internal (error, "error in process filter: ");
2835 Vinhibit_quit = Qt;
2836 update_echo_area ();
2837 Fsleep_for (make_number (2), Qnil);
2838 return Qt;
2841 /* Read pending output from the process channel,
2842 starting with our buffered-ahead character if we have one.
2843 Yield number of decoded characters read.
2845 This function reads at most 1024 characters.
2846 If you want to read all available subprocess output,
2847 you must call it repeatedly until it returns zero.
2849 The characters read are decoded according to PROC's coding-system
2850 for decoding. */
2853 read_process_output (proc, channel)
2854 Lisp_Object proc;
2855 register int channel;
2857 register int nchars, nbytes;
2858 char *chars;
2859 #ifdef VMS
2860 int chars_allocated = 0; /* If 1, `chars' should be freed later. */
2861 #else
2862 char buf[1024];
2863 #endif
2864 register Lisp_Object outstream;
2865 register struct buffer *old = current_buffer;
2866 register struct Lisp_Process *p = XPROCESS (proc);
2867 register int opoint;
2868 struct coding_system *coding = proc_decode_coding_system[channel];
2869 int chars_in_decoding_buf = 0; /* If 1, `chars' points
2870 XSTRING (p->decoding_buf)->data. */
2871 int carryover = XINT (p->decoding_carryover);
2873 #ifdef VMS
2874 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2876 vs = get_vms_process_pointer (p->pid);
2877 if (vs)
2879 if (!vs->iosb[0])
2880 return (0); /* Really weird if it does this */
2881 if (!(vs->iosb[0] & 1))
2882 return -1; /* I/O error */
2884 else
2885 error ("Could not get VMS process pointer");
2886 chars = vs->inputBuffer;
2887 nbytes = clean_vms_buffer (chars, vs->iosb[1]);
2888 if (nbytes <= 0)
2890 start_vms_process_read (vs); /* Crank up the next read on the process */
2891 return 1; /* Nothing worth printing, say we got 1 */
2893 if (carryover > 0)
2895 /* The data carried over in the previous decoding (which are at
2896 the tail of decoding buffer) should be prepended to the new
2897 data read to decode all together. */
2898 char *buf = (char *) xmalloc (nbytes + carryover);
2900 bcopy (XSTRING (p->decoding_buf)->data
2901 + STRING_BYTES (XSTRING (p->decoding_buf)) - carryover,
2902 buf, carryover);
2903 bcopy (chars, buf + carryover, nbytes);
2904 chars = buf;
2905 chars_allocated = 1;
2907 #else /* not VMS */
2909 if (carryover)
2910 /* See the comment above. */
2911 bcopy (XSTRING (p->decoding_buf)->data
2912 + STRING_BYTES (XSTRING (p->decoding_buf)) - carryover,
2913 buf, carryover);
2915 if (proc_buffered_char[channel] < 0)
2916 nbytes = emacs_read (channel, buf + carryover, (sizeof buf) - carryover);
2917 else
2919 buf[carryover] = proc_buffered_char[channel];
2920 proc_buffered_char[channel] = -1;
2921 nbytes = emacs_read (channel, buf + carryover + 1,
2922 (sizeof buf) - carryover - 1);
2923 if (nbytes < 0)
2924 nbytes = 1;
2925 else
2926 nbytes = nbytes + 1;
2928 chars = buf;
2929 #endif /* not VMS */
2931 XSETINT (p->decoding_carryover, 0);
2933 /* At this point, NBYTES holds number of characters just received
2934 (including the one in proc_buffered_char[channel]). */
2935 if (nbytes <= 0)
2937 if (nbytes < 0 || coding->mode & CODING_MODE_LAST_BLOCK)
2938 return nbytes;
2939 coding->mode |= CODING_MODE_LAST_BLOCK;
2942 /* Now set NBYTES how many bytes we must decode. */
2943 nbytes += carryover;
2944 nchars = nbytes;
2946 if (CODING_MAY_REQUIRE_DECODING (coding))
2948 int require = decoding_buffer_size (coding, nbytes);
2949 int result;
2951 if (STRING_BYTES (XSTRING (p->decoding_buf)) < require)
2952 p->decoding_buf = make_uninit_string (require);
2953 result = decode_coding (coding, chars, XSTRING (p->decoding_buf)->data,
2954 nbytes, STRING_BYTES (XSTRING (p->decoding_buf)));
2955 carryover = nbytes - coding->consumed;
2956 if (carryover > 0)
2958 /* Copy the carryover bytes to the end of p->decoding_buf, to
2959 be processed on the next read. Since decoding_buffer_size
2960 asks for an extra amount of space beyond the maximum
2961 expected for the output, there should always be sufficient
2962 space for the carryover (which is by definition a sequence
2963 of bytes that was not long enough to be decoded, and thus
2964 has a bounded length). */
2965 if (STRING_BYTES (XSTRING (p->decoding_buf))
2966 < coding->produced + carryover)
2967 abort ();
2968 bcopy (chars + coding->consumed,
2969 XSTRING (p->decoding_buf)->data
2970 + STRING_BYTES (XSTRING (p->decoding_buf)) - carryover,
2971 carryover);
2972 XSETINT (p->decoding_carryover, carryover);
2975 /* A new coding system might be found by `decode_coding'. */
2976 if (!EQ (p->decode_coding_system, coding->symbol))
2978 p->decode_coding_system = coding->symbol;
2980 /* Don't call setup_coding_system for
2981 proc_decode_coding_system[channel] here. It is done in
2982 detect_coding called via decode_coding above. */
2984 /* If a coding system for encoding is not yet decided, we set
2985 it as the same as coding-system for decoding.
2987 But, before doing that we must check if
2988 proc_encode_coding_system[p->outfd] surely points to a
2989 valid memory because p->outfd will be changed once EOF is
2990 sent to the process. */
2991 if (NILP (p->encode_coding_system)
2992 && proc_encode_coding_system[XINT (p->outfd)])
2994 p->encode_coding_system = coding->symbol;
2995 setup_coding_system (coding->symbol,
2996 proc_encode_coding_system[XINT (p->outfd)]);
3000 #ifdef VMS
3001 /* Now we don't need the contents of `chars'. */
3002 if (chars_allocated)
3003 free (chars);
3004 #endif
3005 if (coding->produced == 0)
3006 return 0;
3007 chars = (char *) XSTRING (p->decoding_buf)->data;
3008 nbytes = coding->produced;
3009 nchars = (coding->fake_multibyte
3010 ? multibyte_chars_in_text (chars, nbytes)
3011 : coding->produced_char);
3012 chars_in_decoding_buf = 1;
3014 else
3016 #ifdef VMS
3017 if (chars_allocated)
3019 /* Although we don't have to decode the received data, we
3020 must move it to an area which we don't have to free. */
3021 if (! STRINGP (p->decoding_buf)
3022 || STRING_BYTES (XSTRING (p->decoding_buf)) < nbytes)
3023 p->decoding_buf = make_uninit_string (nbytes);
3024 bcopy (chars, XSTRING (p->decoding_buf)->data, nbytes);
3025 free (chars);
3026 chars = XSTRING (p->decoding_buf)->data;
3027 chars_in_decoding_buf = 1;
3029 #endif
3030 nchars = multibyte_chars_in_text (chars, nbytes);
3033 Vlast_coding_system_used = coding->symbol;
3035 /* If the caller required, let the process associated buffer
3036 inherit the coding-system used to decode the process output. */
3037 if (! NILP (p->inherit_coding_system_flag)
3038 && !NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
3040 struct buffer *prev_buf = current_buffer;
3042 Fset_buffer (p->buffer);
3043 call1 (intern ("after-insert-file-set-buffer-file-coding-system"),
3044 make_number (nbytes));
3045 set_buffer_internal (prev_buf);
3048 /* Read and dispose of the process output. */
3049 outstream = p->filter;
3050 if (!NILP (outstream))
3052 /* We inhibit quit here instead of just catching it so that
3053 hitting ^G when a filter happens to be running won't screw
3054 it up. */
3055 int count = specpdl_ptr - specpdl;
3056 Lisp_Object odeactivate;
3057 Lisp_Object obuffer, okeymap;
3058 Lisp_Object text;
3059 int outer_running_asynch_code = running_asynch_code;
3060 int waiting = waiting_for_user_input_p;
3062 /* No need to gcpro these, because all we do with them later
3063 is test them for EQness, and none of them should be a string. */
3064 odeactivate = Vdeactivate_mark;
3065 XSETBUFFER (obuffer, current_buffer);
3066 okeymap = current_buffer->keymap;
3068 specbind (Qinhibit_quit, Qt);
3069 specbind (Qlast_nonmenu_event, Qt);
3071 /* In case we get recursively called,
3072 and we already saved the match data nonrecursively,
3073 save the same match data in safely recursive fashion. */
3074 if (outer_running_asynch_code)
3076 Lisp_Object tem;
3077 /* Don't clobber the CURRENT match data, either! */
3078 tem = Fmatch_data (Qnil, Qnil);
3079 restore_match_data ();
3080 record_unwind_protect (Fset_match_data, Fmatch_data (Qnil, Qnil));
3081 Fset_match_data (tem);
3084 /* For speed, if a search happens within this code,
3085 save the match data in a special nonrecursive fashion. */
3086 running_asynch_code = 1;
3088 /* The multibyteness of a string given to the filter is decided
3089 by which coding system we used for decoding. */
3090 if (coding->type == coding_type_no_conversion
3091 || coding->type == coding_type_raw_text)
3092 text = make_unibyte_string (chars, nbytes);
3093 else
3094 text = make_multibyte_string (chars, nchars, nbytes);
3096 internal_condition_case_1 (read_process_output_call,
3097 Fcons (outstream,
3098 Fcons (proc, Fcons (text, Qnil))),
3099 !NILP (Vdebug_on_error) ? Qnil : Qerror,
3100 read_process_output_error_handler);
3102 /* If we saved the match data nonrecursively, restore it now. */
3103 restore_match_data ();
3104 running_asynch_code = outer_running_asynch_code;
3106 /* Handling the process output should not deactivate the mark. */
3107 Vdeactivate_mark = odeactivate;
3109 /* Restore waiting_for_user_input_p as it was
3110 when we were called, in case the filter clobbered it. */
3111 waiting_for_user_input_p = waiting;
3113 #if 0 /* Call record_asynch_buffer_change unconditionally,
3114 because we might have changed minor modes or other things
3115 that affect key bindings. */
3116 if (! EQ (Fcurrent_buffer (), obuffer)
3117 || ! EQ (current_buffer->keymap, okeymap))
3118 #endif
3119 /* But do it only if the caller is actually going to read events.
3120 Otherwise there's no need to make him wake up, and it could
3121 cause trouble (for example it would make Fsit_for return). */
3122 if (waiting_for_user_input_p == -1)
3123 record_asynch_buffer_change ();
3125 #ifdef VMS
3126 start_vms_process_read (vs);
3127 #endif
3128 unbind_to (count, Qnil);
3129 return nchars;
3132 /* If no filter, write into buffer if it isn't dead. */
3133 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
3135 Lisp_Object old_read_only;
3136 int old_begv, old_zv;
3137 int old_begv_byte, old_zv_byte;
3138 Lisp_Object odeactivate;
3139 int before, before_byte;
3140 int opoint_byte;
3142 odeactivate = Vdeactivate_mark;
3144 Fset_buffer (p->buffer);
3145 opoint = PT;
3146 opoint_byte = PT_BYTE;
3147 old_read_only = current_buffer->read_only;
3148 old_begv = BEGV;
3149 old_zv = ZV;
3150 old_begv_byte = BEGV_BYTE;
3151 old_zv_byte = ZV_BYTE;
3153 current_buffer->read_only = Qnil;
3155 /* Insert new output into buffer
3156 at the current end-of-output marker,
3157 thus preserving logical ordering of input and output. */
3158 if (XMARKER (p->mark)->buffer)
3159 SET_PT_BOTH (clip_to_bounds (BEGV, marker_position (p->mark), ZV),
3160 clip_to_bounds (BEGV_BYTE, marker_byte_position (p->mark),
3161 ZV_BYTE));
3162 else
3163 SET_PT_BOTH (ZV, ZV_BYTE);
3164 before = PT;
3165 before_byte = PT_BYTE;
3167 /* If the output marker is outside of the visible region, save
3168 the restriction and widen. */
3169 if (! (BEGV <= PT && PT <= ZV))
3170 Fwiden ();
3172 if (NILP (current_buffer->enable_multibyte_characters))
3173 nchars = nbytes;
3175 /* Insert before markers in case we are inserting where
3176 the buffer's mark is, and the user's next command is Meta-y. */
3177 if (chars_in_decoding_buf)
3179 /* Since multibyteness of p->docoding_buf is corrupted, we
3180 can't use insert_from_string_before_markers. */
3181 char *temp_buf;
3183 temp_buf = (char *) alloca (nbytes);
3184 bcopy (XSTRING (p->decoding_buf)->data, temp_buf, nbytes);
3185 insert_before_markers (temp_buf, nbytes);
3187 else
3189 insert_1_both (chars, nchars, nbytes, 0, 1, 1);
3190 signal_after_change (before, 0, PT - before);
3191 update_compositions (before, PT, CHECK_BORDER);
3193 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
3195 update_mode_lines++;
3197 /* Make sure opoint and the old restrictions
3198 float ahead of any new text just as point would. */
3199 if (opoint >= before)
3201 opoint += PT - before;
3202 opoint_byte += PT_BYTE - before_byte;
3204 if (old_begv > before)
3206 old_begv += PT - before;
3207 old_begv_byte += PT_BYTE - before_byte;
3209 if (old_zv >= before)
3211 old_zv += PT - before;
3212 old_zv_byte += PT_BYTE - before_byte;
3215 /* If the restriction isn't what it should be, set it. */
3216 if (old_begv != BEGV || old_zv != ZV)
3217 Fnarrow_to_region (make_number (old_begv), make_number (old_zv));
3219 /* Handling the process output should not deactivate the mark. */
3220 Vdeactivate_mark = odeactivate;
3222 current_buffer->read_only = old_read_only;
3223 SET_PT_BOTH (opoint, opoint_byte);
3224 set_buffer_internal (old);
3226 #ifdef VMS
3227 start_vms_process_read (vs);
3228 #endif
3229 return nbytes;
3232 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
3233 0, 0, 0,
3234 "Returns non-nil if emacs is waiting for input from the user.\n\
3235 This is intended for use by asynchronous process output filters and sentinels.")
3238 return (waiting_for_user_input_p ? Qt : Qnil);
3241 /* Sending data to subprocess */
3243 jmp_buf send_process_frame;
3245 SIGTYPE
3246 send_process_trap ()
3248 #ifdef BSD4_1
3249 sigrelse (SIGPIPE);
3250 sigrelse (SIGALRM);
3251 #endif /* BSD4_1 */
3252 longjmp (send_process_frame, 1);
3255 /* Send some data to process PROC.
3256 BUF is the beginning of the data; LEN is the number of characters.
3257 OBJECT is the Lisp object that the data comes from.
3259 The data is encoded by PROC's coding-system for encoding before it
3260 is sent. But if the data ends at the middle of multi-byte
3261 representation, that incomplete sequence of bytes are sent without
3262 being encoded. Should we store them in a buffer to prepend them to
3263 the data send later? */
3265 void
3266 send_process (proc, buf, len, object)
3267 volatile Lisp_Object proc;
3268 unsigned char *buf;
3269 int len;
3270 Lisp_Object object;
3272 /* Use volatile to protect variables from being clobbered by longjmp. */
3273 int rv;
3274 volatile unsigned char *procname = XSTRING (XPROCESS (proc)->name)->data;
3275 struct coding_system *coding;
3276 struct gcpro gcpro1;
3277 int carryover = XINT (XPROCESS (proc)->encoding_carryover);
3279 GCPRO1 (object);
3281 #ifdef VMS
3282 struct Lisp_Process *p = XPROCESS (proc);
3283 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
3284 #endif /* VMS */
3286 if (! NILP (XPROCESS (proc)->raw_status_low))
3287 update_status (XPROCESS (proc));
3288 if (! EQ (XPROCESS (proc)->status, Qrun))
3289 error ("Process %s not running", procname);
3290 if (XINT (XPROCESS (proc)->outfd) < 0)
3291 error ("Output file descriptor of %s is closed", procname);
3293 coding = proc_encode_coding_system[XINT (XPROCESS (proc)->outfd)];
3294 Vlast_coding_system_used = coding->symbol;
3296 if (CODING_REQUIRE_ENCODING (coding))
3298 int require = encoding_buffer_size (coding, len);
3299 int offset;
3300 unsigned char *temp_buf = NULL;
3302 /* Remember the offset of data because a string or a buffer may
3303 be relocated. Setting OFFSET to -1 means we don't have to
3304 care about relocation. */
3305 offset = (BUFFERP (object)
3306 ? BUF_PTR_BYTE_POS (XBUFFER (object), buf)
3307 : (STRINGP (object)
3308 ? buf - XSTRING (object)->data
3309 : -1));
3311 if (carryover > 0)
3313 temp_buf = (unsigned char *) xmalloc (len + carryover);
3315 if (offset >= 0)
3317 if (BUFFERP (object))
3318 buf = BUF_BYTE_ADDRESS (XBUFFER (object), offset);
3319 else if (STRINGP (object))
3320 buf = offset + XSTRING (object)->data;
3321 /* Now we don't have to care about relocation. */
3322 offset = -1;
3324 bcopy ((XSTRING (XPROCESS (proc)->encoding_buf)->data
3325 + STRING_BYTES (XSTRING (XPROCESS (proc)->encoding_buf))
3326 - carryover),
3327 temp_buf,
3328 carryover);
3329 bcopy (buf, temp_buf + carryover, len);
3330 buf = temp_buf;
3333 if (STRING_BYTES (XSTRING (XPROCESS (proc)->encoding_buf)) < require)
3335 XPROCESS (proc)->encoding_buf = make_uninit_string (require);
3337 if (offset >= 0)
3339 if (BUFFERP (object))
3340 buf = BUF_BYTE_ADDRESS (XBUFFER (object), offset);
3341 else if (STRINGP (object))
3342 buf = offset + XSTRING (object)->data;
3345 object = XPROCESS (proc)->encoding_buf;
3346 encode_coding (coding, buf, XSTRING (object)->data,
3347 len, STRING_BYTES (XSTRING (object)));
3348 len = coding->produced;
3349 buf = XSTRING (object)->data;
3350 if (temp_buf)
3351 xfree (temp_buf);
3354 #ifdef VMS
3355 vs = get_vms_process_pointer (p->pid);
3356 if (vs == 0)
3357 error ("Could not find this process: %x", p->pid);
3358 else if (write_to_vms_process (vs, buf, len))
3360 #else
3362 if (pty_max_bytes == 0)
3364 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
3365 pty_max_bytes = fpathconf (XFASTINT (XPROCESS (proc)->outfd),
3366 _PC_MAX_CANON);
3367 if (pty_max_bytes < 0)
3368 pty_max_bytes = 250;
3369 #else
3370 pty_max_bytes = 250;
3371 #endif
3372 /* Deduct one, to leave space for the eof. */
3373 pty_max_bytes--;
3376 if (!setjmp (send_process_frame))
3377 while (len > 0)
3379 int this = len;
3380 SIGTYPE (*old_sigpipe)();
3382 /* Decide how much data we can send in one batch.
3383 Long lines need to be split into multiple batches. */
3384 if (!NILP (XPROCESS (proc)->pty_flag))
3386 /* Starting this at zero is always correct when not the first iteration
3387 because the previous iteration ended by sending C-d.
3388 It may not be correct for the first iteration
3389 if a partial line was sent in a separate send_process call.
3390 If that proves worth handling, we need to save linepos
3391 in the process object. */
3392 int linepos = 0;
3393 unsigned char *ptr = buf;
3394 unsigned char *end = buf + len;
3396 /* Scan through this text for a line that is too long. */
3397 while (ptr != end && linepos < pty_max_bytes)
3399 if (*ptr == '\n')
3400 linepos = 0;
3401 else
3402 linepos++;
3403 ptr++;
3405 /* If we found one, break the line there
3406 and put in a C-d to force the buffer through. */
3407 this = ptr - buf;
3410 /* Send this batch, using one or more write calls. */
3411 while (this > 0)
3413 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
3414 rv = emacs_write (XINT (XPROCESS (proc)->outfd), buf, this);
3415 signal (SIGPIPE, old_sigpipe);
3417 if (rv < 0)
3419 if (0
3420 #ifdef EWOULDBLOCK
3421 || errno == EWOULDBLOCK
3422 #endif
3423 #ifdef EAGAIN
3424 || errno == EAGAIN
3425 #endif
3427 /* Buffer is full. Wait, accepting input;
3428 that may allow the program
3429 to finish doing output and read more. */
3431 Lisp_Object zero;
3432 int offset;
3434 /* Running filters might relocate buffers or strings.
3435 Arrange to relocate BUF. */
3436 if (BUFFERP (object))
3437 offset = BUF_PTR_BYTE_POS (XBUFFER (object), buf);
3438 else if (STRINGP (object))
3439 offset = buf - XSTRING (object)->data;
3441 XSETFASTINT (zero, 0);
3442 #ifdef EMACS_HAS_USECS
3443 wait_reading_process_input (0, 20000, zero, 0);
3444 #else
3445 wait_reading_process_input (1, 0, zero, 0);
3446 #endif
3448 if (BUFFERP (object))
3449 buf = BUF_BYTE_ADDRESS (XBUFFER (object), offset);
3450 else if (STRINGP (object))
3451 buf = offset + XSTRING (object)->data;
3453 rv = 0;
3455 else
3456 /* This is a real error. */
3457 report_file_error ("writing to process", Fcons (proc, Qnil));
3459 buf += rv;
3460 len -= rv;
3461 this -= rv;
3464 /* If we sent just part of the string, put in an EOF
3465 to force it through, before we send the rest. */
3466 if (len > 0)
3467 Fprocess_send_eof (proc);
3469 #endif
3470 else
3472 XPROCESS (proc)->raw_status_low = Qnil;
3473 XPROCESS (proc)->raw_status_high = Qnil;
3474 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
3475 XSETINT (XPROCESS (proc)->tick, ++process_tick);
3476 deactivate_process (proc);
3477 #ifdef VMS
3478 error ("Error writing to process %s; closed it", procname);
3479 #else
3480 error ("SIGPIPE raised on process %s; closed it", procname);
3481 #endif
3484 UNGCPRO;
3487 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
3488 3, 3, 0,
3489 "Send current contents of region as input to PROCESS.\n\
3490 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3491 nil, indicating the current buffer's process.\n\
3492 Called from program, takes three arguments, PROCESS, START and END.\n\
3493 If the region is more than 500 characters long,\n\
3494 it is sent in several bunches. This may happen even for shorter regions.\n\
3495 Output from processes can arrive in between bunches.")
3496 (process, start, end)
3497 Lisp_Object process, start, end;
3499 Lisp_Object proc;
3500 int start1, end1;
3502 proc = get_process (process);
3503 validate_region (&start, &end);
3505 if (XINT (start) < GPT && XINT (end) > GPT)
3506 move_gap (XINT (start));
3508 start1 = CHAR_TO_BYTE (XINT (start));
3509 end1 = CHAR_TO_BYTE (XINT (end));
3510 send_process (proc, BYTE_POS_ADDR (start1), end1 - start1,
3511 Fcurrent_buffer ());
3513 return Qnil;
3516 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
3517 2, 2, 0,
3518 "Send PROCESS the contents of STRING as input.\n\
3519 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3520 nil, indicating the current buffer's process.\n\
3521 If STRING is more than 500 characters long,\n\
3522 it is sent in several bunches. This may happen even for shorter strings.\n\
3523 Output from processes can arrive in between bunches.")
3524 (process, string)
3525 Lisp_Object process, string;
3527 Lisp_Object proc;
3528 CHECK_STRING (string, 1);
3529 proc = get_process (process);
3530 send_process (proc, XSTRING (string)->data,
3531 STRING_BYTES (XSTRING (string)), string);
3532 return Qnil;
3535 DEFUN ("process-running-child-p", Fprocess_running_child_p,
3536 Sprocess_running_child_p, 0, 1, 0,
3537 "Return t if PROCESS has given the terminal to a child.\n\
3538 If the operating system does not make it possible to find out,\n\
3539 return t unconditionally.")
3540 (process)
3541 Lisp_Object process;
3543 /* Initialize in case ioctl doesn't exist or gives an error,
3544 in a way that will cause returning t. */
3545 int gid = 0;
3546 Lisp_Object proc;
3547 struct Lisp_Process *p;
3549 proc = get_process (process);
3550 p = XPROCESS (proc);
3552 if (!EQ (p->childp, Qt))
3553 error ("Process %s is not a subprocess",
3554 XSTRING (p->name)->data);
3555 if (XINT (p->infd) < 0)
3556 error ("Process %s is not active",
3557 XSTRING (p->name)->data);
3559 #ifdef TIOCGPGRP
3560 if (!NILP (p->subtty))
3561 ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
3562 else
3563 ioctl (XINT (p->infd), TIOCGPGRP, &gid);
3564 #endif /* defined (TIOCGPGRP ) */
3566 if (gid == XFASTINT (p->pid))
3567 return Qnil;
3568 return Qt;
3571 /* send a signal number SIGNO to PROCESS.
3572 If CURRENT_GROUP is t, that means send to the process group
3573 that currently owns the terminal being used to communicate with PROCESS.
3574 This is used for various commands in shell mode.
3575 If CURRENT_GROUP is lambda, that means send to the process group
3576 that currently owns the terminal, but only if it is NOT the shell itself.
3578 If NOMSG is zero, insert signal-announcements into process's buffers
3579 right away.
3581 If we can, we try to signal PROCESS by sending control characters
3582 down the pty. This allows us to signal inferiors who have changed
3583 their uid, for which killpg would return an EPERM error. */
3585 static void
3586 process_send_signal (process, signo, current_group, nomsg)
3587 Lisp_Object process;
3588 int signo;
3589 Lisp_Object current_group;
3590 int nomsg;
3592 Lisp_Object proc;
3593 register struct Lisp_Process *p;
3594 int gid;
3595 int no_pgrp = 0;
3597 proc = get_process (process);
3598 p = XPROCESS (proc);
3600 if (!EQ (p->childp, Qt))
3601 error ("Process %s is not a subprocess",
3602 XSTRING (p->name)->data);
3603 if (XINT (p->infd) < 0)
3604 error ("Process %s is not active",
3605 XSTRING (p->name)->data);
3607 if (NILP (p->pty_flag))
3608 current_group = Qnil;
3610 /* If we are using pgrps, get a pgrp number and make it negative. */
3611 if (!NILP (current_group))
3613 #ifdef SIGNALS_VIA_CHARACTERS
3614 /* If possible, send signals to the entire pgrp
3615 by sending an input character to it. */
3617 /* TERMIOS is the latest and bestest, and seems most likely to
3618 work. If the system has it, use it. */
3619 #ifdef HAVE_TERMIOS
3620 struct termios t;
3622 switch (signo)
3624 case SIGINT:
3625 tcgetattr (XINT (p->infd), &t);
3626 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3627 return;
3629 case SIGQUIT:
3630 tcgetattr (XINT (p->infd), &t);
3631 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3632 return;
3634 case SIGTSTP:
3635 tcgetattr (XINT (p->infd), &t);
3636 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
3637 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3638 #else
3639 send_process (proc, &t.c_cc[VSUSP], 1, Qnil);
3640 #endif
3641 return;
3644 #else /* ! HAVE_TERMIOS */
3646 /* On Berkeley descendants, the following IOCTL's retrieve the
3647 current control characters. */
3648 #if defined (TIOCGLTC) && defined (TIOCGETC)
3650 struct tchars c;
3651 struct ltchars lc;
3653 switch (signo)
3655 case SIGINT:
3656 ioctl (XINT (p->infd), TIOCGETC, &c);
3657 send_process (proc, &c.t_intrc, 1, Qnil);
3658 return;
3659 case SIGQUIT:
3660 ioctl (XINT (p->infd), TIOCGETC, &c);
3661 send_process (proc, &c.t_quitc, 1, Qnil);
3662 return;
3663 #ifdef SIGTSTP
3664 case SIGTSTP:
3665 ioctl (XINT (p->infd), TIOCGLTC, &lc);
3666 send_process (proc, &lc.t_suspc, 1, Qnil);
3667 return;
3668 #endif /* ! defined (SIGTSTP) */
3671 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3673 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
3674 characters. */
3675 #ifdef TCGETA
3676 struct termio t;
3677 switch (signo)
3679 case SIGINT:
3680 ioctl (XINT (p->infd), TCGETA, &t);
3681 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3682 return;
3683 case SIGQUIT:
3684 ioctl (XINT (p->infd), TCGETA, &t);
3685 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3686 return;
3687 #ifdef SIGTSTP
3688 case SIGTSTP:
3689 ioctl (XINT (p->infd), TCGETA, &t);
3690 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3691 return;
3692 #endif /* ! defined (SIGTSTP) */
3694 #else /* ! defined (TCGETA) */
3695 Your configuration files are messed up.
3696 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
3697 you'd better be using one of the alternatives above! */
3698 #endif /* ! defined (TCGETA) */
3699 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3700 #endif /* ! defined HAVE_TERMIOS */
3701 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
3703 #ifdef TIOCGPGRP
3704 /* Get the pgrp using the tty itself, if we have that.
3705 Otherwise, use the pty to get the pgrp.
3706 On pfa systems, saka@pfu.fujitsu.co.JP writes:
3707 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
3708 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
3709 His patch indicates that if TIOCGPGRP returns an error, then
3710 we should just assume that p->pid is also the process group id. */
3712 int err;
3714 if (!NILP (p->subtty))
3715 err = ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
3716 else
3717 err = ioctl (XINT (p->infd), TIOCGPGRP, &gid);
3719 #ifdef pfa
3720 if (err == -1)
3721 gid = - XFASTINT (p->pid);
3722 #endif /* ! defined (pfa) */
3724 if (gid == -1)
3725 no_pgrp = 1;
3726 else
3727 gid = - gid;
3728 #else /* ! defined (TIOCGPGRP ) */
3729 /* Can't select pgrps on this system, so we know that
3730 the child itself heads the pgrp. */
3731 gid = - XFASTINT (p->pid);
3732 #endif /* ! defined (TIOCGPGRP ) */
3734 /* If current_group is lambda, and the shell owns the terminal,
3735 don't send any signal. */
3736 if (EQ (current_group, Qlambda) && gid == - XFASTINT (p->pid))
3737 return;
3739 else
3740 gid = - XFASTINT (p->pid);
3742 switch (signo)
3744 #ifdef SIGCONT
3745 case SIGCONT:
3746 p->raw_status_low = Qnil;
3747 p->raw_status_high = Qnil;
3748 p->status = Qrun;
3749 XSETINT (p->tick, ++process_tick);
3750 if (!nomsg)
3751 status_notify ();
3752 break;
3753 #endif /* ! defined (SIGCONT) */
3754 case SIGINT:
3755 #ifdef VMS
3756 send_process (proc, "\003", 1, Qnil); /* ^C */
3757 goto whoosh;
3758 #endif
3759 case SIGQUIT:
3760 #ifdef VMS
3761 send_process (proc, "\031", 1, Qnil); /* ^Y */
3762 goto whoosh;
3763 #endif
3764 case SIGKILL:
3765 #ifdef VMS
3766 sys$forcex (&(XFASTINT (p->pid)), 0, 1);
3767 whoosh:
3768 #endif
3769 flush_pending_output (XINT (p->infd));
3770 break;
3773 /* If we don't have process groups, send the signal to the immediate
3774 subprocess. That isn't really right, but it's better than any
3775 obvious alternative. */
3776 if (no_pgrp)
3778 kill (XFASTINT (p->pid), signo);
3779 return;
3782 /* gid may be a pid, or minus a pgrp's number */
3783 #ifdef TIOCSIGSEND
3784 if (!NILP (current_group))
3785 ioctl (XINT (p->infd), TIOCSIGSEND, signo);
3786 else
3788 gid = - XFASTINT (p->pid);
3789 kill (gid, signo);
3791 #else /* ! defined (TIOCSIGSEND) */
3792 EMACS_KILLPG (-gid, signo);
3793 #endif /* ! defined (TIOCSIGSEND) */
3796 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
3797 "Interrupt process PROCESS.\n\
3798 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
3799 nil or no arg means current buffer's process.\n\
3800 Second arg CURRENT-GROUP non-nil means send signal to\n\
3801 the current process-group of the process's controlling terminal\n\
3802 rather than to the process's own process group.\n\
3803 If the process is a shell, this means interrupt current subjob\n\
3804 rather than the shell.\n\
3806 If CURRENT-GROUP is `lambda', and if the shell owns the terminal,\n\
3807 don't send the signal.")
3808 (process, current_group)
3809 Lisp_Object process, current_group;
3811 process_send_signal (process, SIGINT, current_group, 0);
3812 return process;
3815 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
3816 "Kill process PROCESS. May be process or name of one.\n\
3817 See function `interrupt-process' for more details on usage.")
3818 (process, current_group)
3819 Lisp_Object process, current_group;
3821 process_send_signal (process, SIGKILL, current_group, 0);
3822 return process;
3825 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
3826 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
3827 See function `interrupt-process' for more details on usage.")
3828 (process, current_group)
3829 Lisp_Object process, current_group;
3831 process_send_signal (process, SIGQUIT, current_group, 0);
3832 return process;
3835 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
3836 "Stop process PROCESS. May be process or name of one.\n\
3837 See function `interrupt-process' for more details on usage.")
3838 (process, current_group)
3839 Lisp_Object process, current_group;
3841 #ifndef SIGTSTP
3842 error ("no SIGTSTP support");
3843 #else
3844 process_send_signal (process, SIGTSTP, current_group, 0);
3845 #endif
3846 return process;
3849 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
3850 "Continue process PROCESS. May be process or name of one.\n\
3851 See function `interrupt-process' for more details on usage.")
3852 (process, current_group)
3853 Lisp_Object process, current_group;
3855 #ifdef SIGCONT
3856 process_send_signal (process, SIGCONT, current_group, 0);
3857 #else
3858 error ("no SIGCONT support");
3859 #endif
3860 return process;
3863 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
3864 2, 2, "nProcess number: \nnSignal code: ",
3865 "Send the process with process id PID the signal with code SIGCODE.\n\
3866 PID must be an integer. The process need not be a child of this Emacs.\n\
3867 SIGCODE may be an integer, or a symbol whose name is a signal name.")
3868 (pid, sigcode)
3869 Lisp_Object pid, sigcode;
3871 CHECK_NUMBER (pid, 0);
3873 #define handle_signal(NAME, VALUE) \
3874 else if (!strcmp (name, NAME)) \
3875 XSETINT (sigcode, VALUE)
3877 if (INTEGERP (sigcode))
3879 else
3881 unsigned char *name;
3883 CHECK_SYMBOL (sigcode, 1);
3884 name = XSYMBOL (sigcode)->name->data;
3886 if (0)
3888 #ifdef SIGHUP
3889 handle_signal ("SIGHUP", SIGHUP);
3890 #endif
3891 #ifdef SIGINT
3892 handle_signal ("SIGINT", SIGINT);
3893 #endif
3894 #ifdef SIGQUIT
3895 handle_signal ("SIGQUIT", SIGQUIT);
3896 #endif
3897 #ifdef SIGILL
3898 handle_signal ("SIGILL", SIGILL);
3899 #endif
3900 #ifdef SIGABRT
3901 handle_signal ("SIGABRT", SIGABRT);
3902 #endif
3903 #ifdef SIGEMT
3904 handle_signal ("SIGEMT", SIGEMT);
3905 #endif
3906 #ifdef SIGKILL
3907 handle_signal ("SIGKILL", SIGKILL);
3908 #endif
3909 #ifdef SIGFPE
3910 handle_signal ("SIGFPE", SIGFPE);
3911 #endif
3912 #ifdef SIGBUS
3913 handle_signal ("SIGBUS", SIGBUS);
3914 #endif
3915 #ifdef SIGSEGV
3916 handle_signal ("SIGSEGV", SIGSEGV);
3917 #endif
3918 #ifdef SIGSYS
3919 handle_signal ("SIGSYS", SIGSYS);
3920 #endif
3921 #ifdef SIGPIPE
3922 handle_signal ("SIGPIPE", SIGPIPE);
3923 #endif
3924 #ifdef SIGALRM
3925 handle_signal ("SIGALRM", SIGALRM);
3926 #endif
3927 #ifdef SIGTERM
3928 handle_signal ("SIGTERM", SIGTERM);
3929 #endif
3930 #ifdef SIGURG
3931 handle_signal ("SIGURG", SIGURG);
3932 #endif
3933 #ifdef SIGSTOP
3934 handle_signal ("SIGSTOP", SIGSTOP);
3935 #endif
3936 #ifdef SIGTSTP
3937 handle_signal ("SIGTSTP", SIGTSTP);
3938 #endif
3939 #ifdef SIGCONT
3940 handle_signal ("SIGCONT", SIGCONT);
3941 #endif
3942 #ifdef SIGCHLD
3943 handle_signal ("SIGCHLD", SIGCHLD);
3944 #endif
3945 #ifdef SIGTTIN
3946 handle_signal ("SIGTTIN", SIGTTIN);
3947 #endif
3948 #ifdef SIGTTOU
3949 handle_signal ("SIGTTOU", SIGTTOU);
3950 #endif
3951 #ifdef SIGIO
3952 handle_signal ("SIGIO", SIGIO);
3953 #endif
3954 #ifdef SIGXCPU
3955 handle_signal ("SIGXCPU", SIGXCPU);
3956 #endif
3957 #ifdef SIGXFSZ
3958 handle_signal ("SIGXFSZ", SIGXFSZ);
3959 #endif
3960 #ifdef SIGVTALRM
3961 handle_signal ("SIGVTALRM", SIGVTALRM);
3962 #endif
3963 #ifdef SIGPROF
3964 handle_signal ("SIGPROF", SIGPROF);
3965 #endif
3966 #ifdef SIGWINCH
3967 handle_signal ("SIGWINCH", SIGWINCH);
3968 #endif
3969 #ifdef SIGINFO
3970 handle_signal ("SIGINFO", SIGINFO);
3971 #endif
3972 #ifdef SIGUSR1
3973 handle_signal ("SIGUSR1", SIGUSR1);
3974 #endif
3975 #ifdef SIGUSR2
3976 handle_signal ("SIGUSR2", SIGUSR2);
3977 #endif
3978 else
3979 error ("Undefined signal name %s", name);
3982 #undef handle_signal
3984 return make_number (kill (XINT (pid), XINT (sigcode)));
3987 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
3988 "Make PROCESS see end-of-file in its input.\n\
3989 EOF comes after any text already sent to it.\n\
3990 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3991 nil, indicating the current buffer's process.\n\
3992 If PROCESS is a network connection, or is a process communicating\n\
3993 through a pipe (as opposed to a pty), then you cannot send any more\n\
3994 text to PROCESS after you call this function.")
3995 (process)
3996 Lisp_Object process;
3998 Lisp_Object proc;
3999 struct coding_system *coding;
4001 proc = get_process (process);
4002 coding = proc_encode_coding_system[XINT (XPROCESS (proc)->outfd)];
4004 /* Make sure the process is really alive. */
4005 if (! NILP (XPROCESS (proc)->raw_status_low))
4006 update_status (XPROCESS (proc));
4007 if (! EQ (XPROCESS (proc)->status, Qrun))
4008 error ("Process %s not running", XSTRING (XPROCESS (proc)->name)->data);
4010 if (CODING_REQUIRE_FLUSHING (coding))
4012 coding->mode |= CODING_MODE_LAST_BLOCK;
4013 send_process (proc, "", 0, Qnil);
4016 #ifdef VMS
4017 send_process (proc, "\032", 1, Qnil); /* ^z */
4018 #else
4019 if (!NILP (XPROCESS (proc)->pty_flag))
4020 send_process (proc, "\004", 1, Qnil);
4021 else
4023 int old_outfd, new_outfd;
4025 #ifdef HAVE_SHUTDOWN
4026 /* If this is a network connection, or socketpair is used
4027 for communication with the subprocess, call shutdown to cause EOF.
4028 (In some old system, shutdown to socketpair doesn't work.
4029 Then we just can't win.) */
4030 if (NILP (XPROCESS (proc)->pid)
4031 || XINT (XPROCESS (proc)->outfd) == XINT (XPROCESS (proc)->infd))
4032 shutdown (XINT (XPROCESS (proc)->outfd), 1);
4033 /* In case of socketpair, outfd == infd, so don't close it. */
4034 if (XINT (XPROCESS (proc)->outfd) != XINT (XPROCESS (proc)->infd))
4035 emacs_close (XINT (XPROCESS (proc)->outfd));
4036 #else /* not HAVE_SHUTDOWN */
4037 emacs_close (XINT (XPROCESS (proc)->outfd));
4038 #endif /* not HAVE_SHUTDOWN */
4039 new_outfd = emacs_open (NULL_DEVICE, O_WRONLY, 0);
4040 old_outfd = XINT (XPROCESS (proc)->outfd);
4042 if (!proc_encode_coding_system[new_outfd])
4043 proc_encode_coding_system[new_outfd]
4044 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
4045 bcopy (proc_encode_coding_system[old_outfd],
4046 proc_encode_coding_system[new_outfd],
4047 sizeof (struct coding_system));
4048 bzero (proc_encode_coding_system[old_outfd],
4049 sizeof (struct coding_system));
4051 XSETINT (XPROCESS (proc)->outfd, new_outfd);
4053 #endif /* VMS */
4054 return process;
4057 /* Kill all processes associated with `buffer'.
4058 If `buffer' is nil, kill all processes */
4060 void
4061 kill_buffer_processes (buffer)
4062 Lisp_Object buffer;
4064 Lisp_Object tail, proc;
4066 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCDR (tail))
4068 proc = XCDR (XCAR (tail));
4069 if (GC_PROCESSP (proc)
4070 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
4072 if (NETCONN_P (proc))
4073 Fdelete_process (proc);
4074 else if (XINT (XPROCESS (proc)->infd) >= 0)
4075 process_send_signal (proc, SIGHUP, Qnil, 1);
4080 /* On receipt of a signal that a child status has changed,
4081 loop asking about children with changed statuses until
4082 the system says there are no more.
4083 All we do is change the status;
4084 we do not run sentinels or print notifications.
4085 That is saved for the next time keyboard input is done,
4086 in order to avoid timing errors. */
4088 /** WARNING: this can be called during garbage collection.
4089 Therefore, it must not be fooled by the presence of mark bits in
4090 Lisp objects. */
4092 /** USG WARNING: Although it is not obvious from the documentation
4093 in signal(2), on a USG system the SIGCLD handler MUST NOT call
4094 signal() before executing at least one wait(), otherwise the handler
4095 will be called again, resulting in an infinite loop. The relevant
4096 portion of the documentation reads "SIGCLD signals will be queued
4097 and the signal-catching function will be continually reentered until
4098 the queue is empty". Invoking signal() causes the kernel to reexamine
4099 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
4101 SIGTYPE
4102 sigchld_handler (signo)
4103 int signo;
4105 int old_errno = errno;
4106 Lisp_Object proc;
4107 register struct Lisp_Process *p;
4108 extern EMACS_TIME *input_available_clear_time;
4110 #ifdef BSD4_1
4111 extern int sigheld;
4112 sigheld |= sigbit (SIGCHLD);
4113 #endif
4115 while (1)
4117 register int pid;
4118 WAITTYPE w;
4119 Lisp_Object tail;
4121 #ifdef WNOHANG
4122 #ifndef WUNTRACED
4123 #define WUNTRACED 0
4124 #endif /* no WUNTRACED */
4125 /* Keep trying to get a status until we get a definitive result. */
4128 errno = 0;
4129 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
4131 while (pid <= 0 && errno == EINTR);
4133 if (pid <= 0)
4135 /* A real failure. We have done all our job, so return. */
4137 /* USG systems forget handlers when they are used;
4138 must reestablish each time */
4139 #if defined (USG) && !defined (POSIX_SIGNALS)
4140 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
4141 #endif
4142 #ifdef BSD4_1
4143 sigheld &= ~sigbit (SIGCHLD);
4144 sigrelse (SIGCHLD);
4145 #endif
4146 errno = old_errno;
4147 return;
4149 #else
4150 pid = wait (&w);
4151 #endif /* no WNOHANG */
4153 /* Find the process that signaled us, and record its status. */
4155 p = 0;
4156 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
4158 proc = XCDR (XCAR (tail));
4159 p = XPROCESS (proc);
4160 if (EQ (p->childp, Qt) && XFASTINT (p->pid) == pid)
4161 break;
4162 p = 0;
4165 /* Look for an asynchronous process whose pid hasn't been filled
4166 in yet. */
4167 if (p == 0)
4168 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
4170 proc = XCDR (XCAR (tail));
4171 p = XPROCESS (proc);
4172 if (INTEGERP (p->pid) && XINT (p->pid) == -1)
4173 break;
4174 p = 0;
4177 /* Change the status of the process that was found. */
4178 if (p != 0)
4180 union { int i; WAITTYPE wt; } u;
4181 int clear_desc_flag = 0;
4183 XSETINT (p->tick, ++process_tick);
4184 u.wt = w;
4185 XSETINT (p->raw_status_low, u.i & 0xffff);
4186 XSETINT (p->raw_status_high, u.i >> 16);
4188 /* If process has terminated, stop waiting for its output. */
4189 if ((WIFSIGNALED (w) || WIFEXITED (w))
4190 && XINT (p->infd) >= 0)
4191 clear_desc_flag = 1;
4193 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
4194 if (clear_desc_flag)
4196 FD_CLR (XINT (p->infd), &input_wait_mask);
4197 FD_CLR (XINT (p->infd), &non_keyboard_wait_mask);
4200 /* Tell wait_reading_process_input that it needs to wake up and
4201 look around. */
4202 if (input_available_clear_time)
4203 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
4206 /* There was no asynchronous process found for that id. Check
4207 if we have a synchronous process. */
4208 else
4210 synch_process_alive = 0;
4212 /* Report the status of the synchronous process. */
4213 if (WIFEXITED (w))
4214 synch_process_retcode = WRETCODE (w);
4215 else if (WIFSIGNALED (w))
4217 int code = WTERMSIG (w);
4218 char *signame;
4220 synchronize_system_messages_locale ();
4221 signame = strsignal (code);
4223 if (signame == 0)
4224 signame = "unknown";
4226 synch_process_death = signame;
4229 /* Tell wait_reading_process_input that it needs to wake up and
4230 look around. */
4231 if (input_available_clear_time)
4232 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
4235 /* On some systems, we must return right away.
4236 If any more processes want to signal us, we will
4237 get another signal.
4238 Otherwise (on systems that have WNOHANG), loop around
4239 to use up all the processes that have something to tell us. */
4240 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG)) || defined (WINDOWSNT)
4241 #if defined (USG) && ! defined (POSIX_SIGNALS)
4242 signal (signo, sigchld_handler);
4243 #endif
4244 errno = old_errno;
4245 return;
4246 #endif /* USG, but not HPUX with WNOHANG */
4251 static Lisp_Object
4252 exec_sentinel_unwind (data)
4253 Lisp_Object data;
4255 XPROCESS (XCAR (data))->sentinel = XCDR (data);
4256 return Qnil;
4259 static Lisp_Object
4260 exec_sentinel_error_handler (error)
4261 Lisp_Object error;
4263 cmd_error_internal (error, "error in process sentinel: ");
4264 Vinhibit_quit = Qt;
4265 update_echo_area ();
4266 Fsleep_for (make_number (2), Qnil);
4267 return Qt;
4270 static void
4271 exec_sentinel (proc, reason)
4272 Lisp_Object proc, reason;
4274 Lisp_Object sentinel, obuffer, odeactivate, okeymap;
4275 register struct Lisp_Process *p = XPROCESS (proc);
4276 int count = specpdl_ptr - specpdl;
4277 int outer_running_asynch_code = running_asynch_code;
4278 int waiting = waiting_for_user_input_p;
4280 /* No need to gcpro these, because all we do with them later
4281 is test them for EQness, and none of them should be a string. */
4282 odeactivate = Vdeactivate_mark;
4283 XSETBUFFER (obuffer, current_buffer);
4284 okeymap = current_buffer->keymap;
4286 sentinel = p->sentinel;
4287 if (NILP (sentinel))
4288 return;
4290 /* Zilch the sentinel while it's running, to avoid recursive invocations;
4291 assure that it gets restored no matter how the sentinel exits. */
4292 p->sentinel = Qnil;
4293 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
4294 /* Inhibit quit so that random quits don't screw up a running filter. */
4295 specbind (Qinhibit_quit, Qt);
4296 specbind (Qlast_nonmenu_event, Qt);
4298 /* In case we get recursively called,
4299 and we already saved the match data nonrecursively,
4300 save the same match data in safely recursive fashion. */
4301 if (outer_running_asynch_code)
4303 Lisp_Object tem;
4304 tem = Fmatch_data (Qnil, Qnil);
4305 restore_match_data ();
4306 record_unwind_protect (Fset_match_data, Fmatch_data (Qnil, Qnil));
4307 Fset_match_data (tem);
4310 /* For speed, if a search happens within this code,
4311 save the match data in a special nonrecursive fashion. */
4312 running_asynch_code = 1;
4314 internal_condition_case_1 (read_process_output_call,
4315 Fcons (sentinel,
4316 Fcons (proc, Fcons (reason, Qnil))),
4317 !NILP (Vdebug_on_error) ? Qnil : Qerror,
4318 exec_sentinel_error_handler);
4320 /* If we saved the match data nonrecursively, restore it now. */
4321 restore_match_data ();
4322 running_asynch_code = outer_running_asynch_code;
4324 Vdeactivate_mark = odeactivate;
4326 /* Restore waiting_for_user_input_p as it was
4327 when we were called, in case the filter clobbered it. */
4328 waiting_for_user_input_p = waiting;
4330 #if 0
4331 if (! EQ (Fcurrent_buffer (), obuffer)
4332 || ! EQ (current_buffer->keymap, okeymap))
4333 #endif
4334 /* But do it only if the caller is actually going to read events.
4335 Otherwise there's no need to make him wake up, and it could
4336 cause trouble (for example it would make Fsit_for return). */
4337 if (waiting_for_user_input_p == -1)
4338 record_asynch_buffer_change ();
4340 unbind_to (count, Qnil);
4343 /* Report all recent events of a change in process status
4344 (either run the sentinel or output a message).
4345 This is done while Emacs is waiting for keyboard input. */
4347 void
4348 status_notify ()
4350 register Lisp_Object proc, buffer;
4351 Lisp_Object tail, msg;
4352 struct gcpro gcpro1, gcpro2;
4354 tail = Qnil;
4355 msg = Qnil;
4356 /* We need to gcpro tail; if read_process_output calls a filter
4357 which deletes a process and removes the cons to which tail points
4358 from Vprocess_alist, and then causes a GC, tail is an unprotected
4359 reference. */
4360 GCPRO2 (tail, msg);
4362 /* Set this now, so that if new processes are created by sentinels
4363 that we run, we get called again to handle their status changes. */
4364 update_tick = process_tick;
4366 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
4368 Lisp_Object symbol;
4369 register struct Lisp_Process *p;
4371 proc = Fcdr (Fcar (tail));
4372 p = XPROCESS (proc);
4374 if (XINT (p->tick) != XINT (p->update_tick))
4376 XSETINT (p->update_tick, XINT (p->tick));
4378 /* If process is still active, read any output that remains. */
4379 while (! EQ (p->filter, Qt)
4380 && XINT (p->infd) >= 0
4381 && read_process_output (proc, XINT (p->infd)) > 0);
4383 buffer = p->buffer;
4385 /* Get the text to use for the message. */
4386 if (!NILP (p->raw_status_low))
4387 update_status (p);
4388 msg = status_message (p->status);
4390 /* If process is terminated, deactivate it or delete it. */
4391 symbol = p->status;
4392 if (CONSP (p->status))
4393 symbol = XCAR (p->status);
4395 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
4396 || EQ (symbol, Qclosed))
4398 if (delete_exited_processes)
4399 remove_process (proc);
4400 else
4401 deactivate_process (proc);
4404 /* The actions above may have further incremented p->tick.
4405 So set p->update_tick again
4406 so that an error in the sentinel will not cause
4407 this code to be run again. */
4408 XSETINT (p->update_tick, XINT (p->tick));
4409 /* Now output the message suitably. */
4410 if (!NILP (p->sentinel))
4411 exec_sentinel (proc, msg);
4412 /* Don't bother with a message in the buffer
4413 when a process becomes runnable. */
4414 else if (!EQ (symbol, Qrun) && !NILP (buffer))
4416 Lisp_Object ro, tem;
4417 struct buffer *old = current_buffer;
4418 int opoint, opoint_byte;
4419 int before, before_byte;
4421 ro = XBUFFER (buffer)->read_only;
4423 /* Avoid error if buffer is deleted
4424 (probably that's why the process is dead, too) */
4425 if (NILP (XBUFFER (buffer)->name))
4426 continue;
4427 Fset_buffer (buffer);
4429 opoint = PT;
4430 opoint_byte = PT_BYTE;
4431 /* Insert new output into buffer
4432 at the current end-of-output marker,
4433 thus preserving logical ordering of input and output. */
4434 if (XMARKER (p->mark)->buffer)
4435 Fgoto_char (p->mark);
4436 else
4437 SET_PT_BOTH (ZV, ZV_BYTE);
4439 before = PT;
4440 before_byte = PT_BYTE;
4442 tem = current_buffer->read_only;
4443 current_buffer->read_only = Qnil;
4444 insert_string ("\nProcess ");
4445 Finsert (1, &p->name);
4446 insert_string (" ");
4447 Finsert (1, &msg);
4448 current_buffer->read_only = tem;
4449 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
4451 if (opoint >= before)
4452 SET_PT_BOTH (opoint + (PT - before),
4453 opoint_byte + (PT_BYTE - before_byte));
4454 else
4455 SET_PT_BOTH (opoint, opoint_byte);
4457 set_buffer_internal (old);
4460 } /* end for */
4462 update_mode_lines++; /* in case buffers use %s in mode-line-format */
4463 redisplay_preserve_echo_area ();
4465 UNGCPRO;
4469 DEFUN ("set-process-coding-system", Fset_process_coding_system,
4470 Sset_process_coding_system, 1, 3, 0,
4471 "Set coding systems of PROCESS to DECODING and ENCODING.\n\
4472 DECODING will be used to decode subprocess output and ENCODING to\n\
4473 encode subprocess input.")
4474 (proc, decoding, encoding)
4475 register Lisp_Object proc, decoding, encoding;
4477 register struct Lisp_Process *p;
4479 CHECK_PROCESS (proc, 0);
4480 p = XPROCESS (proc);
4481 if (XINT (p->infd) < 0)
4482 error ("Input file descriptor of %s closed", XSTRING (p->name)->data);
4483 if (XINT (p->outfd) < 0)
4484 error ("Output file descriptor of %s closed", XSTRING (p->name)->data);
4486 p->decode_coding_system = Fcheck_coding_system (decoding);
4487 p->encode_coding_system = Fcheck_coding_system (encoding);
4488 setup_coding_system (decoding,
4489 proc_decode_coding_system[XINT (p->infd)]);
4490 setup_coding_system (encoding,
4491 proc_encode_coding_system[XINT (p->outfd)]);
4493 return Qnil;
4496 DEFUN ("process-coding-system",
4497 Fprocess_coding_system, Sprocess_coding_system, 1, 1, 0,
4498 "Return a cons of coding systems for decoding and encoding of PROCESS.")
4499 (proc)
4500 register Lisp_Object proc;
4502 CHECK_PROCESS (proc, 0);
4503 return Fcons (XPROCESS (proc)->decode_coding_system,
4504 XPROCESS (proc)->encode_coding_system);
4507 /* The first time this is called, assume keyboard input comes from DESC
4508 instead of from where we used to expect it.
4509 Subsequent calls mean assume input keyboard can come from DESC
4510 in addition to other places. */
4512 static int add_keyboard_wait_descriptor_called_flag;
4514 void
4515 add_keyboard_wait_descriptor (desc)
4516 int desc;
4518 if (! add_keyboard_wait_descriptor_called_flag)
4519 FD_CLR (0, &input_wait_mask);
4520 add_keyboard_wait_descriptor_called_flag = 1;
4521 FD_SET (desc, &input_wait_mask);
4522 FD_SET (desc, &non_process_wait_mask);
4523 if (desc > max_keyboard_desc)
4524 max_keyboard_desc = desc;
4527 /* From now on, do not expect DESC to give keyboard input. */
4529 void
4530 delete_keyboard_wait_descriptor (desc)
4531 int desc;
4533 int fd;
4534 int lim = max_keyboard_desc;
4536 FD_CLR (desc, &input_wait_mask);
4537 FD_CLR (desc, &non_process_wait_mask);
4539 if (desc == max_keyboard_desc)
4540 for (fd = 0; fd < lim; fd++)
4541 if (FD_ISSET (fd, &input_wait_mask)
4542 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4543 max_keyboard_desc = fd;
4546 /* Return nonzero if *MASK has a bit set
4547 that corresponds to one of the keyboard input descriptors. */
4550 keyboard_bit_set (mask)
4551 SELECT_TYPE *mask;
4553 int fd;
4555 for (fd = 0; fd <= max_keyboard_desc; fd++)
4556 if (FD_ISSET (fd, mask) && FD_ISSET (fd, &input_wait_mask)
4557 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4558 return 1;
4560 return 0;
4563 void
4564 init_process ()
4566 register int i;
4568 #ifdef SIGCHLD
4569 #ifndef CANNOT_DUMP
4570 if (! noninteractive || initialized)
4571 #endif
4572 signal (SIGCHLD, sigchld_handler);
4573 #endif
4575 FD_ZERO (&input_wait_mask);
4576 FD_ZERO (&non_keyboard_wait_mask);
4577 FD_ZERO (&non_process_wait_mask);
4578 max_process_desc = 0;
4580 FD_SET (0, &input_wait_mask);
4582 Vprocess_alist = Qnil;
4583 for (i = 0; i < MAXDESC; i++)
4585 chan_process[i] = Qnil;
4586 proc_buffered_char[i] = -1;
4588 bzero (proc_decode_coding_system, sizeof proc_decode_coding_system);
4589 bzero (proc_encode_coding_system, sizeof proc_encode_coding_system);
4591 Vdefault_process_coding_system
4592 = (NILP (buffer_defaults.enable_multibyte_characters)
4593 ? Fcons (Qraw_text, Qnil)
4594 : Fcons (Qemacs_mule, Qnil));
4597 void
4598 syms_of_process ()
4600 Qprocessp = intern ("processp");
4601 staticpro (&Qprocessp);
4602 Qrun = intern ("run");
4603 staticpro (&Qrun);
4604 Qstop = intern ("stop");
4605 staticpro (&Qstop);
4606 Qsignal = intern ("signal");
4607 staticpro (&Qsignal);
4609 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
4610 here again.
4612 Qexit = intern ("exit");
4613 staticpro (&Qexit); */
4615 Qopen = intern ("open");
4616 staticpro (&Qopen);
4617 Qclosed = intern ("closed");
4618 staticpro (&Qclosed);
4620 Qlast_nonmenu_event = intern ("last-nonmenu-event");
4621 staticpro (&Qlast_nonmenu_event);
4623 staticpro (&Vprocess_alist);
4625 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
4626 "*Non-nil means delete processes immediately when they exit.\n\
4627 nil means don't delete them until `list-processes' is run.");
4629 delete_exited_processes = 1;
4631 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
4632 "Control type of device used to communicate with subprocesses.\n\
4633 Values are nil to use a pipe, or t or `pty' to use a pty.\n\
4634 The value has no effect if the system has no ptys or if all ptys are busy:\n\
4635 then a pipe is used in any case.\n\
4636 The value takes effect when `start-process' is called.");
4637 Vprocess_connection_type = Qt;
4639 defsubr (&Sprocessp);
4640 defsubr (&Sget_process);
4641 defsubr (&Sget_buffer_process);
4642 defsubr (&Sdelete_process);
4643 defsubr (&Sprocess_status);
4644 defsubr (&Sprocess_exit_status);
4645 defsubr (&Sprocess_id);
4646 defsubr (&Sprocess_name);
4647 defsubr (&Sprocess_tty_name);
4648 defsubr (&Sprocess_command);
4649 defsubr (&Sset_process_buffer);
4650 defsubr (&Sprocess_buffer);
4651 defsubr (&Sprocess_mark);
4652 defsubr (&Sset_process_filter);
4653 defsubr (&Sprocess_filter);
4654 defsubr (&Sset_process_sentinel);
4655 defsubr (&Sprocess_sentinel);
4656 defsubr (&Sset_process_window_size);
4657 defsubr (&Sset_process_inherit_coding_system_flag);
4658 defsubr (&Sprocess_inherit_coding_system_flag);
4659 defsubr (&Sprocess_kill_without_query);
4660 defsubr (&Sprocess_contact);
4661 defsubr (&Slist_processes);
4662 defsubr (&Sprocess_list);
4663 defsubr (&Sstart_process);
4664 #ifdef HAVE_SOCKETS
4665 defsubr (&Sopen_network_stream);
4666 #endif /* HAVE_SOCKETS */
4667 defsubr (&Saccept_process_output);
4668 defsubr (&Sprocess_send_region);
4669 defsubr (&Sprocess_send_string);
4670 defsubr (&Sinterrupt_process);
4671 defsubr (&Skill_process);
4672 defsubr (&Squit_process);
4673 defsubr (&Sstop_process);
4674 defsubr (&Scontinue_process);
4675 defsubr (&Sprocess_running_child_p);
4676 defsubr (&Sprocess_send_eof);
4677 defsubr (&Ssignal_process);
4678 defsubr (&Swaiting_for_user_input_p);
4679 /* defsubr (&Sprocess_connection); */
4680 defsubr (&Sset_process_coding_system);
4681 defsubr (&Sprocess_coding_system);
4685 #else /* not subprocesses */
4687 #include <sys/types.h>
4688 #include <errno.h>
4690 #include "lisp.h"
4691 #include "systime.h"
4692 #include "charset.h"
4693 #include "coding.h"
4694 #include "termopts.h"
4695 #include "sysselect.h"
4697 extern int frame_garbaged;
4699 extern EMACS_TIME timer_check ();
4700 extern int timers_run;
4702 /* As described above, except assuming that there are no subprocesses:
4704 Wait for timeout to elapse and/or keyboard input to be available.
4706 time_limit is:
4707 timeout in seconds, or
4708 zero for no limit, or
4709 -1 means gobble data immediately available but don't wait for any.
4711 read_kbd is a Lisp_Object:
4712 0 to ignore keyboard input, or
4713 1 to return when input is available, or
4714 -1 means caller will actually read the input, so don't throw to
4715 the quit handler.
4716 a cons cell, meaning wait until its car is non-nil
4717 (and gobble terminal input into the buffer if any arrives), or
4718 We know that read_kbd will never be a Lisp_Process, since
4719 `subprocesses' isn't defined.
4721 do_display != 0 means redisplay should be done to show subprocess
4722 output that arrives.
4724 Return true iff we received input from any process. */
4727 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
4728 int time_limit, microsecs;
4729 Lisp_Object read_kbd;
4730 int do_display;
4732 register int nfds;
4733 EMACS_TIME end_time, timeout;
4734 SELECT_TYPE waitchannels;
4735 int xerrno;
4736 Lisp_Object *wait_for_cell = 0;
4738 /* If waiting for non-nil in a cell, record where. */
4739 if (CONSP (read_kbd))
4741 wait_for_cell = &XCAR (read_kbd);
4742 XSETFASTINT (read_kbd, 0);
4745 /* What does time_limit really mean? */
4746 if (time_limit || microsecs)
4748 EMACS_GET_TIME (end_time);
4749 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
4750 EMACS_ADD_TIME (end_time, end_time, timeout);
4753 /* Turn off periodic alarms (in case they are in use)
4754 because the select emulator uses alarms. */
4755 turn_on_atimers (0);
4757 while (1)
4759 int timeout_reduced_for_timers = 0;
4761 /* If calling from keyboard input, do not quit
4762 since we want to return C-g as an input character.
4763 Otherwise, do pending quit if requested. */
4764 if (XINT (read_kbd) >= 0)
4765 QUIT;
4767 /* Exit now if the cell we're waiting for became non-nil. */
4768 if (wait_for_cell && ! NILP (*wait_for_cell))
4769 break;
4771 /* Compute time from now till when time limit is up */
4772 /* Exit if already run out */
4773 if (time_limit == -1)
4775 /* -1 specified for timeout means
4776 gobble output available now
4777 but don't wait at all. */
4779 EMACS_SET_SECS_USECS (timeout, 0, 0);
4781 else if (time_limit || microsecs)
4783 EMACS_GET_TIME (timeout);
4784 EMACS_SUB_TIME (timeout, end_time, timeout);
4785 if (EMACS_TIME_NEG_P (timeout))
4786 break;
4788 else
4790 EMACS_SET_SECS_USECS (timeout, 100000, 0);
4793 /* If our caller will not immediately handle keyboard events,
4794 run timer events directly.
4795 (Callers that will immediately read keyboard events
4796 call timer_delay on their own.) */
4797 if (! wait_for_cell)
4799 EMACS_TIME timer_delay;
4800 int old_timers_run;
4802 retry:
4803 old_timers_run = timers_run;
4804 timer_delay = timer_check (1);
4805 if (timers_run != old_timers_run && do_display)
4807 redisplay_preserve_echo_area ();
4808 /* We must retry, since a timer may have requeued itself
4809 and that could alter the time delay. */
4810 goto retry;
4813 /* If there is unread keyboard input, also return. */
4814 if (XINT (read_kbd) != 0
4815 && requeued_events_pending_p ())
4816 break;
4818 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
4820 EMACS_TIME difference;
4821 EMACS_SUB_TIME (difference, timer_delay, timeout);
4822 if (EMACS_TIME_NEG_P (difference))
4824 timeout = timer_delay;
4825 timeout_reduced_for_timers = 1;
4830 /* Cause C-g and alarm signals to take immediate action,
4831 and cause input available signals to zero out timeout. */
4832 if (XINT (read_kbd) < 0)
4833 set_waiting_for_input (&timeout);
4835 /* Wait till there is something to do. */
4837 if (! XINT (read_kbd) && wait_for_cell == 0)
4838 FD_ZERO (&waitchannels);
4839 else
4840 FD_SET (0, &waitchannels);
4842 /* If a frame has been newly mapped and needs updating,
4843 reprocess its display stuff. */
4844 if (frame_garbaged && do_display)
4846 clear_waiting_for_input ();
4847 redisplay_preserve_echo_area ();
4848 if (XINT (read_kbd) < 0)
4849 set_waiting_for_input (&timeout);
4852 if (XINT (read_kbd) && detect_input_pending ())
4854 nfds = 0;
4855 FD_ZERO (&waitchannels);
4857 else
4858 nfds = select (1, &waitchannels, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
4859 &timeout);
4861 xerrno = errno;
4863 /* Make C-g and alarm signals set flags again */
4864 clear_waiting_for_input ();
4866 /* If we woke up due to SIGWINCH, actually change size now. */
4867 do_pending_window_change (0);
4869 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
4870 /* We waited the full specified time, so return now. */
4871 break;
4873 if (nfds == -1)
4875 /* If the system call was interrupted, then go around the
4876 loop again. */
4877 if (xerrno == EINTR)
4878 FD_ZERO (&waitchannels);
4879 else
4880 error ("select error: %s", emacs_strerror (xerrno));
4882 #ifdef sun
4883 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
4884 /* System sometimes fails to deliver SIGIO. */
4885 kill (getpid (), SIGIO);
4886 #endif
4887 #ifdef SIGIO
4888 if (XINT (read_kbd) && interrupt_input && (waitchannels & 1))
4889 kill (getpid (), SIGIO);
4890 #endif
4892 /* Check for keyboard input */
4894 if ((XINT (read_kbd) != 0)
4895 && detect_input_pending_run_timers (do_display))
4897 swallow_events (do_display);
4898 if (detect_input_pending_run_timers (do_display))
4899 break;
4902 /* If there is unread keyboard input, also return. */
4903 if (XINT (read_kbd) != 0
4904 && requeued_events_pending_p ())
4905 break;
4907 /* If wait_for_cell. check for keyboard input
4908 but don't run any timers.
4909 ??? (It seems wrong to me to check for keyboard
4910 input at all when wait_for_cell, but the code
4911 has been this way since July 1994.
4912 Try changing this after version 19.31.) */
4913 if (wait_for_cell
4914 && detect_input_pending ())
4916 swallow_events (do_display);
4917 if (detect_input_pending ())
4918 break;
4921 /* Exit now if the cell we're waiting for became non-nil. */
4922 if (wait_for_cell && ! NILP (*wait_for_cell))
4923 break;
4926 start_polling ();
4928 return 0;
4932 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
4933 /* Don't confuse make-docfile by having two doc strings for this function.
4934 make-docfile does not pay attention to #if, for good reason! */
4936 (name)
4937 register Lisp_Object name;
4939 return Qnil;
4942 DEFUN ("process-inherit-coding-system-flag",
4943 Fprocess_inherit_coding_system_flag, Sprocess_inherit_coding_system_flag,
4944 1, 1, 0,
4945 /* Don't confuse make-docfile by having two doc strings for this function.
4946 make-docfile does not pay attention to #if, for good reason! */
4948 (process)
4949 register Lisp_Object process;
4951 /* Ignore the argument and return the value of
4952 inherit-process-coding-system. */
4953 return inherit_process_coding_system ? Qt : Qnil;
4956 /* Kill all processes associated with `buffer'.
4957 If `buffer' is nil, kill all processes.
4958 Since we have no subprocesses, this does nothing. */
4960 void
4961 kill_buffer_processes (buffer)
4962 Lisp_Object buffer;
4966 void
4967 init_process ()
4971 void
4972 syms_of_process ()
4974 defsubr (&Sget_buffer_process);
4975 defsubr (&Sprocess_inherit_coding_system_flag);
4979 #endif /* not subprocesses */