(Fexecute_kbd_macro): Clear prefix arg here, not in command_loop_1.
[emacs.git] / src / process.c
blob3f93cd807eb7341597e75994d10e7f9c1b7ca2ef
1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
9 any later version.
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #include <signal.h>
23 #include <config.h>
25 /* This file is split into two parts by the following preprocessor
26 conditional. The 'then' clause contains all of the support for
27 asynchronous subprocesses. The 'else' clause contains stub
28 versions of some of the asynchronous subprocess routines that are
29 often called elsewhere in Emacs, so we don't have to #ifdef the
30 sections that call them. */
33 #ifdef subprocesses
35 #include <stdio.h>
36 #include <errno.h>
37 #include <setjmp.h>
38 #include <sys/types.h> /* some typedefs are used in sys/file.h */
39 #include <sys/file.h>
40 #include <sys/stat.h>
41 #ifdef HAVE_UNISTD_H
42 #include <unistd.h>
43 #endif
45 #ifdef WINDOWSNT
46 #include <stdlib.h>
47 #include <fcntl.h>
48 #endif /* not WINDOWSNT */
50 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
51 #include <sys/socket.h>
52 #include <netdb.h>
53 #include <netinet/in.h>
54 #include <arpa/inet.h>
55 #endif /* HAVE_SOCKETS */
57 /* TERM is a poor-man's SLIP, used on Linux. */
58 #ifdef TERM
59 #include <client.h>
60 #endif
62 /* On some systems, e.g. DGUX, inet_addr returns a 'struct in_addr'. */
63 #ifdef HAVE_BROKEN_INET_ADDR
64 #define IN_ADDR struct in_addr
65 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
66 #else
67 #define IN_ADDR unsigned long
68 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
69 #endif
71 #if defined(BSD) || defined(STRIDE)
72 #include <sys/ioctl.h>
73 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
74 #include <fcntl.h>
75 #endif /* HAVE_PTYS and no O_NDELAY */
76 #endif /* BSD or STRIDE */
78 #ifdef BROKEN_O_NONBLOCK
79 #undef O_NONBLOCK
80 #endif /* BROKEN_O_NONBLOCK */
82 #ifdef NEED_BSDTTY
83 #include <bsdtty.h>
84 #endif
86 #ifdef IRIS
87 #include <sys/sysmacros.h> /* for "minor" */
88 #endif /* not IRIS */
90 #include "systime.h"
91 #include "systty.h"
93 #include "lisp.h"
94 #include "window.h"
95 #include "buffer.h"
96 #include "process.h"
97 #include "termhooks.h"
98 #include "termopts.h"
99 #include "commands.h"
100 #include "frame.h"
102 Lisp_Object Qprocessp;
103 Lisp_Object Qrun, Qstop, Qsignal, Qopen, Qclosed;
104 Lisp_Object Qlast_nonmenu_event;
105 /* Qexit is declared and initialized in eval.c. */
107 /* a process object is a network connection when its childp field is neither
108 Qt nor Qnil but is instead a string (name of foreign host we
109 are connected to + name of port we are connected to) */
111 #ifdef HAVE_SOCKETS
112 static Lisp_Object stream_process;
114 #define NETCONN_P(p) (GC_STRINGP (XPROCESS (p)->childp))
115 #else
116 #define NETCONN_P(p) 0
117 #endif /* HAVE_SOCKETS */
119 /* Define first descriptor number available for subprocesses. */
120 #ifdef VMS
121 #define FIRST_PROC_DESC 1
122 #else /* Not VMS */
123 #define FIRST_PROC_DESC 3
124 #endif
126 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
127 testing SIGCHLD. */
129 #if !defined (SIGCHLD) && defined (SIGCLD)
130 #define SIGCHLD SIGCLD
131 #endif /* SIGCLD */
133 #include "syssignal.h"
135 #include "syswait.h"
137 extern int errno;
138 extern char *strerror ();
139 #ifdef VMS
140 extern char *sys_errlist[];
141 #endif
143 #ifndef HAVE_H_ERRNO
144 extern int h_errno;
145 #endif
147 #ifndef SYS_SIGLIST_DECLARED
148 #ifndef VMS
149 #ifndef BSD4_1
150 #ifndef WINDOWSNT
151 #ifndef LINUX
152 extern char *sys_siglist[];
153 #endif /* not LINUX */
154 #else /* BSD4_1 */
155 char *sys_siglist[] =
157 "bum signal!!",
158 "hangup",
159 "interrupt",
160 "quit",
161 "illegal instruction",
162 "trace trap",
163 "iot instruction",
164 "emt instruction",
165 "floating point exception",
166 "kill",
167 "bus error",
168 "segmentation violation",
169 "bad argument to system call",
170 "write on a pipe with no one to read it",
171 "alarm clock",
172 "software termination signal from kill",
173 "status signal",
174 "sendable stop signal not from tty",
175 "stop signal from tty",
176 "continue a stopped process",
177 "child status has changed",
178 "background read attempted from control tty",
179 "background write attempted from control tty",
180 "input record available at control tty",
181 "exceeded CPU time limit",
182 "exceeded file size limit"
184 #endif /* not WINDOWSNT */
185 #endif
186 #endif /* VMS */
187 #endif /* ! SYS_SIGLIST_DECLARED */
189 /* t means use pty, nil means use a pipe,
190 maybe other values to come. */
191 static Lisp_Object Vprocess_connection_type;
193 #ifdef SKTPAIR
194 #ifndef HAVE_SOCKETS
195 #include <sys/socket.h>
196 #endif
197 #endif /* SKTPAIR */
199 /* These next two vars are non-static since sysdep.c uses them in the
200 emulation of `select'. */
201 /* Number of events of change of status of a process. */
202 int process_tick;
203 /* Number of events for which the user or sentinel has been notified. */
204 int update_tick;
206 #include "sysselect.h"
208 /* If we support X Windows, turn on the code to poll periodically
209 to detect C-g. It isn't actually used when doing interrupt input. */
210 #ifdef HAVE_X_WINDOWS
211 #define POLL_FOR_INPUT
212 #endif
214 /* Mask of bits indicating the descriptors that we wait for input on. */
216 static SELECT_TYPE input_wait_mask;
218 /* Mask that excludes keyboard input descriptor (s). */
220 static SELECT_TYPE non_keyboard_wait_mask;
222 /* The largest descriptor currently in use for a process object. */
223 static int max_process_desc;
225 /* The largest descriptor currently in use for keyboard input. */
226 static int max_keyboard_desc;
228 /* Nonzero means delete a process right away if it exits. */
229 static int delete_exited_processes;
231 /* Indexed by descriptor, gives the process (if any) for that descriptor */
232 Lisp_Object chan_process[MAXDESC];
234 /* Alist of elements (NAME . PROCESS) */
235 Lisp_Object Vprocess_alist;
237 /* Buffered-ahead input char from process, indexed by channel.
238 -1 means empty (no char is buffered).
239 Used on sys V where the only way to tell if there is any
240 output from the process is to read at least one char.
241 Always -1 on systems that support FIONREAD. */
243 /* Don't make static; need to access externally. */
244 int proc_buffered_char[MAXDESC];
246 static Lisp_Object get_process ();
248 /* Maximum number of bytes to send to a pty without an eof. */
249 static int pty_max_bytes;
251 /* Open an available pty, returning a file descriptor.
252 Return -1 on failure.
253 The file name of the terminal corresponding to the pty
254 is left in the variable pty_name. */
256 static char pty_name[24];
258 /* Compute the Lisp form of the process status, p->status, from
259 the numeric status that was returned by `wait'. */
261 Lisp_Object status_convert ();
263 update_status (p)
264 struct Lisp_Process *p;
266 union { int i; WAITTYPE wt; } u;
267 u.i = XFASTINT (p->raw_status_low) + (XFASTINT (p->raw_status_high) << 16);
268 p->status = status_convert (u.wt);
269 p->raw_status_low = Qnil;
270 p->raw_status_high = Qnil;
273 /* Convert a process status word in Unix format to
274 the list that we use internally. */
276 Lisp_Object
277 status_convert (w)
278 WAITTYPE w;
280 if (WIFSTOPPED (w))
281 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
282 else if (WIFEXITED (w))
283 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
284 WCOREDUMP (w) ? Qt : Qnil));
285 else if (WIFSIGNALED (w))
286 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
287 WCOREDUMP (w) ? Qt : Qnil));
288 else
289 return Qrun;
292 /* Given a status-list, extract the three pieces of information
293 and store them individually through the three pointers. */
295 void
296 decode_status (l, symbol, code, coredump)
297 Lisp_Object l;
298 Lisp_Object *symbol;
299 int *code;
300 int *coredump;
302 Lisp_Object tem;
304 if (SYMBOLP (l))
306 *symbol = l;
307 *code = 0;
308 *coredump = 0;
310 else
312 *symbol = XCONS (l)->car;
313 tem = XCONS (l)->cdr;
314 *code = XFASTINT (XCONS (tem)->car);
315 tem = XCONS (tem)->cdr;
316 *coredump = !NILP (tem);
320 /* Return a string describing a process status list. */
322 Lisp_Object
323 status_message (status)
324 Lisp_Object status;
326 Lisp_Object symbol;
327 int code, coredump;
328 Lisp_Object string, string2;
330 decode_status (status, &symbol, &code, &coredump);
332 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
334 char *signame = 0;
335 if (code < NSIG)
337 #ifndef VMS
338 /* Cast to suppress warning if the table has const char *. */
339 signame = (char *) sys_siglist[code];
340 #else
341 signame = sys_errlist[code];
342 #endif
344 if (signame == 0)
345 signame = "unknown";
346 string = build_string (signame);
347 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
348 XSTRING (string)->data[0] = DOWNCASE (XSTRING (string)->data[0]);
349 return concat2 (string, string2);
351 else if (EQ (symbol, Qexit))
353 if (code == 0)
354 return build_string ("finished\n");
355 string = Fnumber_to_string (make_number (code));
356 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
357 return concat2 (build_string ("exited abnormally with code "),
358 concat2 (string, string2));
360 else
361 return Fcopy_sequence (Fsymbol_name (symbol));
364 #ifdef HAVE_PTYS
367 allocate_pty ()
369 struct stat stb;
370 register c, i;
371 int fd;
373 /* Some systems name their pseudoterminals so that there are gaps in
374 the usual sequence - for example, on HP9000/S700 systems, there
375 are no pseudoterminals with names ending in 'f'. So we wait for
376 three failures in a row before deciding that we've reached the
377 end of the ptys. */
378 int failed_count = 0;
380 #ifdef PTY_ITERATION
381 PTY_ITERATION
382 #else
383 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
384 for (i = 0; i < 16; i++)
385 #endif
387 #ifdef PTY_NAME_SPRINTF
388 PTY_NAME_SPRINTF
389 #else
390 sprintf (pty_name, "/dev/pty%c%x", c, i);
391 #endif /* no PTY_NAME_SPRINTF */
393 #ifdef PTY_OPEN
394 PTY_OPEN;
395 #else /* no PTY_OPEN */
396 #ifdef IRIS
397 /* Unusual IRIS code */
398 *ptyv = open ("/dev/ptc", O_RDWR | O_NDELAY, 0);
399 if (fd < 0)
400 return -1;
401 if (fstat (fd, &stb) < 0)
402 return -1;
403 #else /* not IRIS */
404 if (stat (pty_name, &stb) < 0)
406 failed_count++;
407 if (failed_count >= 3)
408 return -1;
410 else
411 failed_count = 0;
412 #ifdef O_NONBLOCK
413 fd = open (pty_name, O_RDWR | O_NONBLOCK, 0);
414 #else
415 fd = open (pty_name, O_RDWR | O_NDELAY, 0);
416 #endif
417 #endif /* not IRIS */
418 #endif /* no PTY_OPEN */
420 if (fd >= 0)
422 /* check to make certain that both sides are available
423 this avoids a nasty yet stupid bug in rlogins */
424 #ifdef PTY_TTY_NAME_SPRINTF
425 PTY_TTY_NAME_SPRINTF
426 #else
427 sprintf (pty_name, "/dev/tty%c%x", c, i);
428 #endif /* no PTY_TTY_NAME_SPRINTF */
429 #ifndef UNIPLUS
430 if (access (pty_name, 6) != 0)
432 close (fd);
433 #if !defined(IRIS) && !defined(__sgi)
434 continue;
435 #else
436 return -1;
437 #endif /* IRIS */
439 #endif /* not UNIPLUS */
440 setup_pty (fd);
441 return fd;
444 return -1;
446 #endif /* HAVE_PTYS */
448 Lisp_Object
449 make_process (name)
450 Lisp_Object name;
452 struct Lisp_Vector *vec;
453 register Lisp_Object val, tem, name1;
454 register struct Lisp_Process *p;
455 char suffix[10];
456 register int i;
458 vec = allocate_vectorlike ((EMACS_INT) VECSIZE (struct Lisp_Process));
459 for (i = 0; i < VECSIZE (struct Lisp_Process); i++)
460 vec->contents[i] = Qnil;
461 vec->size = VECSIZE (struct Lisp_Process);
462 p = (struct Lisp_Process *)vec;
464 XSETINT (p->infd, -1);
465 XSETINT (p->outfd, -1);
466 XSETFASTINT (p->pid, 0);
467 XSETFASTINT (p->tick, 0);
468 XSETFASTINT (p->update_tick, 0);
469 p->raw_status_low = Qnil;
470 p->raw_status_high = Qnil;
471 p->status = Qrun;
472 p->mark = Fmake_marker ();
474 /* If name is already in use, modify it until it is unused. */
476 name1 = name;
477 for (i = 1; ; i++)
479 tem = Fget_process (name1);
480 if (NILP (tem)) break;
481 sprintf (suffix, "<%d>", i);
482 name1 = concat2 (name, build_string (suffix));
484 name = name1;
485 p->name = name;
486 XSETPROCESS (val, p);
487 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
488 return val;
491 remove_process (proc)
492 register Lisp_Object proc;
494 register Lisp_Object pair;
496 pair = Frassq (proc, Vprocess_alist);
497 Vprocess_alist = Fdelq (pair, Vprocess_alist);
498 Fset_marker (XPROCESS (proc)->mark, Qnil, Qnil);
500 deactivate_process (proc);
503 DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
504 "Return t if OBJECT is a process.")
505 (obj)
506 Lisp_Object obj;
508 return PROCESSP (obj) ? Qt : Qnil;
511 DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
512 "Return the process named NAME, or nil if there is none.")
513 (name)
514 register Lisp_Object name;
516 if (PROCESSP (name))
517 return name;
518 CHECK_STRING (name, 0);
519 return Fcdr (Fassoc (name, Vprocess_alist));
522 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
523 "Return the (or, a) process associated with BUFFER.\n\
524 BUFFER may be a buffer or the name of one.")
525 (name)
526 register Lisp_Object name;
528 register Lisp_Object buf, tail, proc;
530 if (NILP (name)) return Qnil;
531 buf = Fget_buffer (name);
532 if (NILP (buf)) return Qnil;
534 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
536 proc = Fcdr (Fcar (tail));
537 if (PROCESSP (proc) && EQ (XPROCESS (proc)->buffer, buf))
538 return proc;
540 return Qnil;
543 /* This is how commands for the user decode process arguments. It
544 accepts a process, a process name, a buffer, a buffer name, or nil.
545 Buffers denote the first process in the buffer, and nil denotes the
546 current buffer. */
548 static Lisp_Object
549 get_process (name)
550 register Lisp_Object name;
552 register Lisp_Object proc, obj;
553 if (STRINGP (name))
555 obj = Fget_process (name);
556 if (NILP (obj))
557 obj = Fget_buffer (name);
558 if (NILP (obj))
559 error ("Process %s does not exist", XSTRING (name)->data);
561 else if (NILP (name))
562 obj = Fcurrent_buffer ();
563 else
564 obj = name;
566 /* Now obj should be either a buffer object or a process object.
568 if (BUFFERP (obj))
570 proc = Fget_buffer_process (obj);
571 if (NILP (proc))
572 error ("Buffer %s has no process", XSTRING (XBUFFER (obj)->name)->data);
574 else
576 CHECK_PROCESS (obj, 0);
577 proc = obj;
579 return proc;
582 DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
583 "Delete PROCESS: kill it and forget about it immediately.\n\
584 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
585 nil, indicating the current buffer's process.")
586 (proc)
587 register Lisp_Object proc;
589 proc = get_process (proc);
590 XPROCESS (proc)->raw_status_low = Qnil;
591 XPROCESS (proc)->raw_status_high = Qnil;
592 if (NETCONN_P (proc))
594 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
595 XSETINT (XPROCESS (proc)->tick, ++process_tick);
597 else if (XINT (XPROCESS (proc)->infd) >= 0)
599 Fkill_process (proc, Qnil);
600 /* Do this now, since remove_process will make sigchld_handler do nothing. */
601 XPROCESS (proc)->status
602 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
603 XSETINT (XPROCESS (proc)->tick, ++process_tick);
604 status_notify ();
606 remove_process (proc);
607 return Qnil;
610 DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
611 "Return the status of PROCESS: a symbol, one of these:\n\
612 run -- for a process that is running.\n\
613 stop -- for a process stopped but continuable.\n\
614 exit -- for a process that has exited.\n\
615 signal -- for a process that has got a fatal signal.\n\
616 open -- for a network stream connection that is open.\n\
617 closed -- for a network stream connection that is closed.\n\
618 nil -- if arg is a process name and no such process exists.\n\
619 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
620 nil, indicating the current buffer's process.")
621 (proc)
622 register Lisp_Object proc;
624 register struct Lisp_Process *p;
625 register Lisp_Object status;
627 if (STRINGP (proc))
628 proc = Fget_process (proc);
629 else
630 proc = get_process (proc);
632 if (NILP (proc))
633 return proc;
635 p = XPROCESS (proc);
636 if (!NILP (p->raw_status_low))
637 update_status (p);
638 status = p->status;
639 if (CONSP (status))
640 status = XCONS (status)->car;
641 if (NETCONN_P (proc))
643 if (EQ (status, Qrun))
644 status = Qopen;
645 else if (EQ (status, Qexit))
646 status = Qclosed;
648 return status;
651 DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
652 1, 1, 0,
653 "Return the exit status of PROCESS or the signal number that killed it.\n\
654 If PROCESS has not yet exited or died, return 0.")
655 (proc)
656 register Lisp_Object proc;
658 CHECK_PROCESS (proc, 0);
659 if (!NILP (XPROCESS (proc)->raw_status_low))
660 update_status (XPROCESS (proc));
661 if (CONSP (XPROCESS (proc)->status))
662 return XCONS (XCONS (XPROCESS (proc)->status)->cdr)->car;
663 return make_number (0);
666 DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
667 "Return the process id of PROCESS.\n\
668 This is the pid of the Unix process which PROCESS uses or talks to.\n\
669 For a network connection, this value is nil.")
670 (proc)
671 register Lisp_Object proc;
673 CHECK_PROCESS (proc, 0);
674 return XPROCESS (proc)->pid;
677 DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
678 "Return the name of PROCESS, as a string.\n\
679 This is the name of the program invoked in PROCESS,\n\
680 possibly modified to make it unique among process names.")
681 (proc)
682 register Lisp_Object proc;
684 CHECK_PROCESS (proc, 0);
685 return XPROCESS (proc)->name;
688 DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
689 "Return the command that was executed to start PROCESS.\n\
690 This is a list of strings, the first string being the program executed\n\
691 and the rest of the strings being the arguments given to it.\n\
692 For a non-child channel, this is nil.")
693 (proc)
694 register Lisp_Object proc;
696 CHECK_PROCESS (proc, 0);
697 return XPROCESS (proc)->command;
700 DEFUN ("process-tty-name", Fprocess_tty_name, Sprocess_tty_name, 1, 1, 0,
701 "Return the name of the terminal PROCESS uses, or nil if none.\n\
702 This is the terminal that the process itself reads and writes on,\n\
703 not the name of the pty that Emacs uses to talk with that terminal.")
704 (proc)
705 register Lisp_Object proc;
707 CHECK_PROCESS (proc, 0);
708 return XPROCESS (proc)->tty_name;
711 DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
712 2, 2, 0,
713 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
714 (proc, buffer)
715 register Lisp_Object proc, buffer;
717 CHECK_PROCESS (proc, 0);
718 if (!NILP (buffer))
719 CHECK_BUFFER (buffer, 1);
720 XPROCESS (proc)->buffer = buffer;
721 return buffer;
724 DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
725 1, 1, 0,
726 "Return the buffer PROCESS is associated with.\n\
727 Output from PROCESS is inserted in this buffer\n\
728 unless PROCESS has a filter.")
729 (proc)
730 register Lisp_Object proc;
732 CHECK_PROCESS (proc, 0);
733 return XPROCESS (proc)->buffer;
736 DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
737 1, 1, 0,
738 "Return the marker for the end of the last output from PROCESS.")
739 (proc)
740 register Lisp_Object proc;
742 CHECK_PROCESS (proc, 0);
743 return XPROCESS (proc)->mark;
746 DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
747 2, 2, 0,
748 "Give PROCESS the filter function FILTER; nil means no filter.\n\
749 t means stop accepting output from the process.\n\
750 When a process has a filter, each time it does output\n\
751 the entire string of output is passed to the filter.\n\
752 The filter gets two arguments: the process and the string of output.\n\
753 If the process has a filter, its buffer is not used for output.")
754 (proc, filter)
755 register Lisp_Object proc, filter;
757 CHECK_PROCESS (proc, 0);
758 if (EQ (filter, Qt))
760 FD_CLR (XINT (XPROCESS (proc)->infd), &input_wait_mask);
761 FD_CLR (XINT (XPROCESS (proc)->infd), &non_keyboard_wait_mask);
763 else if (EQ (XPROCESS (proc)->filter, Qt))
765 FD_SET (XINT (XPROCESS (proc)->infd), &input_wait_mask);
766 FD_SET (XINT (XPROCESS (proc)->infd), &non_keyboard_wait_mask);
768 XPROCESS (proc)->filter = filter;
769 return filter;
772 DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
773 1, 1, 0,
774 "Returns the filter function of PROCESS; nil if none.\n\
775 See `set-process-filter' for more info on filter functions.")
776 (proc)
777 register Lisp_Object proc;
779 CHECK_PROCESS (proc, 0);
780 return XPROCESS (proc)->filter;
783 DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
784 2, 2, 0,
785 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
786 The sentinel is called as a function when the process changes state.\n\
787 It gets two arguments: the process, and a string describing the change.")
788 (proc, sentinel)
789 register Lisp_Object proc, sentinel;
791 CHECK_PROCESS (proc, 0);
792 XPROCESS (proc)->sentinel = sentinel;
793 return sentinel;
796 DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
797 1, 1, 0,
798 "Return the sentinel of PROCESS; nil if none.\n\
799 See `set-process-sentinel' for more info on sentinels.")
800 (proc)
801 register Lisp_Object proc;
803 CHECK_PROCESS (proc, 0);
804 return XPROCESS (proc)->sentinel;
807 DEFUN ("set-process-window-size", Fset_process_window_size,
808 Sset_process_window_size, 3, 3, 0,
809 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
810 (proc, height, width)
811 register Lisp_Object proc, height, width;
813 CHECK_PROCESS (proc, 0);
814 CHECK_NATNUM (height, 0);
815 CHECK_NATNUM (width, 0);
816 if (set_window_size (XINT (XPROCESS (proc)->infd),
817 XINT (height), XINT(width)) <= 0)
818 return Qnil;
819 else
820 return Qt;
823 DEFUN ("process-kill-without-query", Fprocess_kill_without_query,
824 Sprocess_kill_without_query, 1, 2, 0,
825 "Say no query needed if PROCESS is running when Emacs is exited.\n\
826 Optional second argument if non-nil says to require a query.\n\
827 Value is t if a query was formerly required.")
828 (proc, value)
829 register Lisp_Object proc, value;
831 Lisp_Object tem;
833 CHECK_PROCESS (proc, 0);
834 tem = XPROCESS (proc)->kill_without_query;
835 XPROCESS (proc)->kill_without_query = Fnull (value);
837 return Fnull (tem);
840 #if 0 /* Turned off because we don't currently record this info
841 in the process. Perhaps add it. */
842 DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 1, 1, 0,
843 "Return the connection type of `PROCESS'.\n\
844 The value is `nil' for a pipe,\n\
845 `t' or `pty' for a pty, or `stream' for a socket connection.")
846 (process)
847 Lisp_Object process;
849 return XPROCESS (process)->type;
851 #endif
853 Lisp_Object
854 list_processes_1 ()
856 register Lisp_Object tail, tem;
857 Lisp_Object proc, minspace, tem1;
858 register struct buffer *old = current_buffer;
859 register struct Lisp_Process *p;
860 register int state;
861 char tembuf[80];
863 XSETFASTINT (minspace, 1);
865 set_buffer_internal (XBUFFER (Vstandard_output));
866 Fbuffer_disable_undo (Vstandard_output);
868 current_buffer->truncate_lines = Qt;
870 write_string ("\
871 Proc Status Buffer Tty Command\n\
872 ---- ------ ------ --- -------\n", -1);
874 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
876 Lisp_Object symbol;
878 proc = Fcdr (Fcar (tail));
879 p = XPROCESS (proc);
880 if (NILP (p->childp))
881 continue;
883 Finsert (1, &p->name);
884 Findent_to (make_number (13), minspace);
886 if (!NILP (p->raw_status_low))
887 update_status (p);
888 symbol = p->status;
889 if (CONSP (p->status))
890 symbol = XCONS (p->status)->car;
893 if (EQ (symbol, Qsignal))
895 Lisp_Object tem;
896 tem = Fcar (Fcdr (p->status));
897 #ifdef VMS
898 if (XINT (tem) < NSIG)
899 write_string (sys_errlist [XINT (tem)], -1);
900 else
901 #endif
902 Fprinc (symbol, Qnil);
904 else if (NETCONN_P (proc))
906 if (EQ (symbol, Qrun))
907 write_string ("open", -1);
908 else if (EQ (symbol, Qexit))
909 write_string ("closed", -1);
910 else
911 Fprinc (symbol, Qnil);
913 else
914 Fprinc (symbol, Qnil);
916 if (EQ (symbol, Qexit))
918 Lisp_Object tem;
919 tem = Fcar (Fcdr (p->status));
920 if (XFASTINT (tem))
922 sprintf (tembuf, " %d", XFASTINT (tem));
923 write_string (tembuf, -1);
927 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
928 remove_process (proc);
930 Findent_to (make_number (22), minspace);
931 if (NILP (p->buffer))
932 insert_string ("(none)");
933 else if (NILP (XBUFFER (p->buffer)->name))
934 insert_string ("(Killed)");
935 else
936 Finsert (1, &XBUFFER (p->buffer)->name);
938 Findent_to (make_number (37), minspace);
940 if (STRINGP (p->tty_name))
941 Finsert (1, &p->tty_name);
942 else
943 insert_string ("(none)");
945 Findent_to (make_number (49), minspace);
947 if (NETCONN_P (proc))
949 sprintf (tembuf, "(network stream connection to %s)\n",
950 XSTRING (p->childp)->data);
951 insert_string (tembuf);
953 else
955 tem = p->command;
956 while (1)
958 tem1 = Fcar (tem);
959 Finsert (1, &tem1);
960 tem = Fcdr (tem);
961 if (NILP (tem))
962 break;
963 insert_string (" ");
965 insert_string ("\n");
968 return Qnil;
971 DEFUN ("list-processes", Flist_processes, Slist_processes, 0, 0, "",
972 "Display a list of all processes.\n\
973 \(Any processes listed as Exited or Signaled are actually eliminated\n\
974 after the listing is made.)")
977 internal_with_output_to_temp_buffer ("*Process List*",
978 list_processes_1, Qnil);
979 return Qnil;
982 DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
983 "Return a list of all processes.")
986 return Fmapcar (Qcdr, Vprocess_alist);
989 /* Starting asynchronous inferior processes. */
991 static Lisp_Object start_process_unwind ();
993 DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
994 "Start a program in a subprocess. Return the process object for it.\n\
995 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
996 NAME is name for process. It is modified if necessary to make it unique.\n\
997 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
998 Process output goes at end of that buffer, unless you specify\n\
999 an output stream or filter function to handle the output.\n\
1000 BUFFER may be also nil, meaning that this process is not associated\n\
1001 with any buffer\n\
1002 Third arg is program file name. It is searched for as in the shell.\n\
1003 Remaining arguments are strings to give program as arguments.")
1004 (nargs, args)
1005 int nargs;
1006 register Lisp_Object *args;
1008 Lisp_Object buffer, name, program, proc, current_dir, tem;
1009 #ifdef VMS
1010 register unsigned char *new_argv;
1011 int len;
1012 #else
1013 register unsigned char **new_argv;
1014 #endif
1015 register int i;
1016 int count = specpdl_ptr - specpdl;
1018 buffer = args[1];
1019 if (!NILP (buffer))
1020 buffer = Fget_buffer_create (buffer);
1022 /* Make sure that the child will be able to chdir to the current
1023 buffer's current directory, or its unhandled equivalent. We
1024 can't just have the child check for an error when it does the
1025 chdir, since it's in a vfork.
1027 We have to GCPRO around this because Fexpand_file_name and
1028 Funhandled_file_name_directory might call a file name handling
1029 function. The argument list is protected by the caller, so all
1030 we really have to worry about is buffer. */
1032 struct gcpro gcpro1, gcpro2;
1034 current_dir = current_buffer->directory;
1036 GCPRO2 (buffer, current_dir);
1038 current_dir =
1039 expand_and_dir_to_file
1040 (Funhandled_file_name_directory (current_dir), Qnil);
1041 if (NILP (Ffile_accessible_directory_p (current_dir)))
1042 report_file_error ("Setting current directory",
1043 Fcons (current_buffer->directory, Qnil));
1045 UNGCPRO;
1048 name = args[0];
1049 CHECK_STRING (name, 0);
1051 program = args[2];
1053 CHECK_STRING (program, 2);
1055 #ifdef VMS
1056 /* Make a one member argv with all args concatenated
1057 together separated by a blank. */
1058 len = XSTRING (program)->size + 2;
1059 for (i = 3; i < nargs; i++)
1061 tem = args[i];
1062 CHECK_STRING (tem, i);
1063 len += XSTRING (tem)->size + 1; /* count the blank */
1065 new_argv = (unsigned char *) alloca (len);
1066 strcpy (new_argv, XSTRING (program)->data);
1067 for (i = 3; i < nargs; i++)
1069 tem = args[i];
1070 CHECK_STRING (tem, i);
1071 strcat (new_argv, " ");
1072 strcat (new_argv, XSTRING (tem)->data);
1074 /* Need to add code here to check for program existence on VMS */
1076 #else /* not VMS */
1077 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1079 /* If program file name is not absolute, search our path for it */
1080 if (!IS_DIRECTORY_SEP (XSTRING (program)->data[0])
1081 && !(XSTRING (program)->size > 1
1082 && IS_DEVICE_SEP (XSTRING (program)->data[1])))
1084 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1086 tem = Qnil;
1087 GCPRO4 (name, program, buffer, current_dir);
1088 openp (Vexec_path, program, EXEC_SUFFIXES, &tem, 1);
1089 UNGCPRO;
1090 if (NILP (tem))
1091 report_file_error ("Searching for program", Fcons (program, Qnil));
1092 new_argv[0] = XSTRING (tem)->data;
1094 else
1095 new_argv[0] = XSTRING (program)->data;
1097 for (i = 3; i < nargs; i++)
1099 tem = args[i];
1100 CHECK_STRING (tem, i);
1101 new_argv[i - 2] = XSTRING (tem)->data;
1103 new_argv[i - 2] = 0;
1104 #endif /* not VMS */
1106 proc = make_process (name);
1107 /* If an error occurs and we can't start the process, we want to
1108 remove it from the process list. This means that each error
1109 check in create_process doesn't need to call remove_process
1110 itself; it's all taken care of here. */
1111 record_unwind_protect (start_process_unwind, proc);
1113 XPROCESS (proc)->childp = Qt;
1114 XPROCESS (proc)->command_channel_p = Qnil;
1115 XPROCESS (proc)->buffer = buffer;
1116 XPROCESS (proc)->sentinel = Qnil;
1117 XPROCESS (proc)->filter = Qnil;
1118 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1120 create_process (proc, new_argv, current_dir);
1122 return unbind_to (count, proc);
1125 /* This function is the unwind_protect form for Fstart_process. If
1126 PROC doesn't have its pid set, then we know someone has signalled
1127 an error and the process wasn't started successfully, so we should
1128 remove it from the process list. */
1129 static Lisp_Object
1130 start_process_unwind (proc)
1131 Lisp_Object proc;
1133 if (!PROCESSP (proc))
1134 abort ();
1136 /* Was PROC started successfully? */
1137 if (XINT (XPROCESS (proc)->pid) <= 0)
1138 remove_process (proc);
1140 return Qnil;
1144 SIGTYPE
1145 create_process_1 (signo)
1146 int signo;
1148 #ifdef USG
1149 /* USG systems forget handlers when they are used;
1150 must reestablish each time */
1151 signal (signo, create_process_1);
1152 #endif /* USG */
1155 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1156 #ifdef USG
1157 #ifdef SIGCHLD
1158 /* Mimic blocking of signals on system V, which doesn't really have it. */
1160 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1161 int sigchld_deferred;
1163 SIGTYPE
1164 create_process_sigchld ()
1166 signal (SIGCHLD, create_process_sigchld);
1168 sigchld_deferred = 1;
1170 #endif
1171 #endif
1172 #endif
1174 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1175 create_process (process, new_argv, current_dir)
1176 Lisp_Object process;
1177 char **new_argv;
1178 Lisp_Object current_dir;
1180 int pid, inchannel, outchannel, forkin, forkout;
1181 int sv[2];
1182 #ifdef SIGCHLD
1183 SIGTYPE (*sigchld)();
1184 #endif
1185 int pty_flag = 0;
1186 extern char **environ;
1188 inchannel = outchannel = -1;
1190 #ifdef HAVE_PTYS
1191 if (!NILP (Vprocess_connection_type))
1192 outchannel = inchannel = allocate_pty ();
1194 if (inchannel >= 0)
1196 #ifndef USG
1197 /* On USG systems it does not work to open the pty's tty here
1198 and then close and reopen it in the child. */
1199 #ifdef O_NOCTTY
1200 /* Don't let this terminal become our controlling terminal
1201 (in case we don't have one). */
1202 forkout = forkin = open (pty_name, O_RDWR | O_NOCTTY, 0);
1203 #else
1204 forkout = forkin = open (pty_name, O_RDWR, 0);
1205 #endif
1206 if (forkin < 0)
1207 report_file_error ("Opening pty", Qnil);
1208 #else
1209 forkin = forkout = -1;
1210 #endif /* not USG */
1211 pty_flag = 1;
1213 else
1214 #endif /* HAVE_PTYS */
1215 #ifdef SKTPAIR
1217 if (socketpair (AF_UNIX, SOCK_STREAM, 0, sv) < 0)
1218 report_file_error ("Opening socketpair", Qnil);
1219 outchannel = inchannel = sv[0];
1220 forkout = forkin = sv[1];
1222 #else /* not SKTPAIR */
1224 #ifdef WINDOWSNT
1225 pipe_with_inherited_out (sv);
1226 inchannel = sv[0];
1227 forkout = sv[1];
1229 pipe_with_inherited_in (sv);
1230 forkin = sv[0];
1231 outchannel = sv[1];
1232 #else /* not WINDOWSNT */
1233 pipe (sv);
1234 inchannel = sv[0];
1235 forkout = sv[1];
1236 pipe (sv);
1237 outchannel = sv[1];
1238 forkin = sv[0];
1239 #endif /* not WINDOWSNT */
1241 #endif /* not SKTPAIR */
1243 #if 0
1244 /* Replaced by close_process_descs */
1245 set_exclusive_use (inchannel);
1246 set_exclusive_use (outchannel);
1247 #endif
1249 /* Stride people say it's a mystery why this is needed
1250 as well as the O_NDELAY, but that it fails without this. */
1251 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1253 int one = 1;
1254 ioctl (inchannel, FIONBIO, &one);
1256 #endif
1258 #ifdef O_NONBLOCK
1259 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1260 #else
1261 #ifdef O_NDELAY
1262 fcntl (inchannel, F_SETFL, O_NDELAY);
1263 #endif
1264 #endif
1266 /* Record this as an active process, with its channels.
1267 As a result, child_setup will close Emacs's side of the pipes. */
1268 chan_process[inchannel] = process;
1269 XSETINT (XPROCESS (process)->infd, inchannel);
1270 XSETINT (XPROCESS (process)->outfd, outchannel);
1271 /* Record the tty descriptor used in the subprocess. */
1272 if (forkin < 0)
1273 XPROCESS (process)->subtty = Qnil;
1274 else
1275 XSETFASTINT (XPROCESS (process)->subtty, forkin);
1276 XPROCESS (process)->pty_flag = (pty_flag ? Qt : Qnil);
1277 XPROCESS (process)->status = Qrun;
1279 /* Delay interrupts until we have a chance to store
1280 the new fork's pid in its process structure */
1281 #ifdef SIGCHLD
1282 #ifdef BSD4_1
1283 sighold (SIGCHLD);
1284 #else /* not BSD4_1 */
1285 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1286 sigsetmask (sigmask (SIGCHLD));
1287 #else /* ordinary USG */
1288 #if 0
1289 sigchld_deferred = 0;
1290 sigchld = signal (SIGCHLD, create_process_sigchld);
1291 #endif
1292 #endif /* ordinary USG */
1293 #endif /* not BSD4_1 */
1294 #endif /* SIGCHLD */
1296 FD_SET (inchannel, &input_wait_mask);
1297 FD_SET (inchannel, &non_keyboard_wait_mask);
1298 if (inchannel > max_process_desc)
1299 max_process_desc = inchannel;
1301 /* Until we store the proper pid, enable sigchld_handler
1302 to recognize an unknown pid as standing for this process.
1303 It is very important not to let this `marker' value stay
1304 in the table after this function has returned; if it does
1305 it might cause call-process to hang and subsequent asynchronous
1306 processes to get their return values scrambled. */
1307 XSETINT (XPROCESS (process)->pid, -1);
1310 /* child_setup must clobber environ on systems with true vfork.
1311 Protect it from permanent change. */
1312 char **save_environ = environ;
1314 #ifndef WINDOWSNT
1315 pid = vfork ();
1316 if (pid == 0)
1317 #endif /* not WINDOWSNT */
1319 int xforkin = forkin;
1320 int xforkout = forkout;
1322 #if 0 /* This was probably a mistake--it duplicates code later on,
1323 but fails to handle all the cases. */
1324 /* Make sure SIGCHLD is not blocked in the child. */
1325 sigsetmask (SIGEMPTYMASK);
1326 #endif
1328 /* Make the pty be the controlling terminal of the process. */
1329 #ifdef HAVE_PTYS
1330 /* First, disconnect its current controlling terminal. */
1331 #ifdef HAVE_SETSID
1332 /* We tried doing setsid only if pty_flag, but it caused
1333 process_set_signal to fail on SGI when using a pipe. */
1334 setsid ();
1335 /* Make the pty's terminal the controlling terminal. */
1336 if (pty_flag)
1338 #ifdef TIOCSCTTY
1339 /* We ignore the return value
1340 because faith@cs.unc.edu says that is necessary on Linux. */
1341 ioctl (xforkin, TIOCSCTTY, 0);
1342 #endif
1344 #else /* not HAVE_SETSID */
1345 #ifdef USG
1346 /* It's very important to call setpgrp here and no time
1347 afterwards. Otherwise, we lose our controlling tty which
1348 is set when we open the pty. */
1349 setpgrp ();
1350 #endif /* USG */
1351 #endif /* not HAVE_SETSID */
1352 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1353 if (pty_flag && xforkin >= 0)
1355 struct termios t;
1356 tcgetattr (xforkin, &t);
1357 t.c_lflag = LDISC1;
1358 if (tcsetattr (xforkin, TCSANOW, &t) < 0)
1359 write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1361 #else
1362 #if defined (NTTYDISC) && defined (TIOCSETD)
1363 if (pty_flag && xforkin >= 0)
1365 /* Use new line discipline. */
1366 int ldisc = NTTYDISC;
1367 ioctl (xforkin, TIOCSETD, &ldisc);
1369 #endif
1370 #endif
1371 #ifdef TIOCNOTTY
1372 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1373 can do TIOCSPGRP only to the process's controlling tty. */
1374 if (pty_flag)
1376 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1377 I can't test it since I don't have 4.3. */
1378 int j = open ("/dev/tty", O_RDWR, 0);
1379 ioctl (j, TIOCNOTTY, 0);
1380 close (j);
1381 #ifndef USG
1382 /* In order to get a controlling terminal on some versions
1383 of BSD, it is necessary to put the process in pgrp 0
1384 before it opens the terminal. */
1385 #ifdef OSF1
1386 setpgid (0, 0);
1387 #else
1388 setpgrp (0, 0);
1389 #endif
1390 #endif
1392 #endif /* TIOCNOTTY */
1394 #if !defined (RTU) && !defined (UNIPLUS)
1395 /*** There is a suggestion that this ought to be a
1396 conditional on TIOCSPGRP. */
1397 /* Now close the pty (if we had it open) and reopen it.
1398 This makes the pty the controlling terminal of the subprocess. */
1399 if (pty_flag)
1401 #ifdef SET_CHILD_PTY_PGRP
1402 int pgrp = getpid ();
1403 #endif
1405 /* I wonder if close (open (pty_name, ...)) would work? */
1406 if (xforkin >= 0)
1407 close (xforkin);
1408 xforkout = xforkin = open (pty_name, O_RDWR, 0);
1410 #ifdef SET_CHILD_PTY_PGRP
1411 ioctl (xforkin, TIOCSPGRP, &pgrp);
1412 ioctl (xforkout, TIOCSPGRP, &pgrp);
1413 #endif
1415 if (xforkin < 0)
1416 abort ();
1418 #endif /* not UNIPLUS and not RTU */
1419 #ifdef SETUP_SLAVE_PTY
1420 if (pty_flag)
1422 SETUP_SLAVE_PTY;
1424 #endif /* SETUP_SLAVE_PTY */
1425 #ifdef AIX
1426 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1427 Now reenable it in the child, so it will die when we want it to. */
1428 if (pty_flag)
1429 signal (SIGHUP, SIG_DFL);
1430 #endif
1431 #endif /* HAVE_PTYS */
1433 #ifdef SIGCHLD
1434 #ifdef BSD4_1
1435 sigrelse (SIGCHLD);
1436 #else /* not BSD4_1 */
1437 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1438 sigsetmask (SIGEMPTYMASK);
1439 #else /* ordinary USG */
1440 #if 0
1441 signal (SIGCHLD, sigchld);
1442 #endif
1443 #endif /* ordinary USG */
1444 #endif /* not BSD4_1 */
1445 #endif /* SIGCHLD */
1447 signal (SIGINT, SIG_DFL);
1448 signal (SIGQUIT, SIG_DFL);
1450 if (pty_flag)
1451 child_setup_tty (xforkout);
1452 #ifdef WINDOWSNT
1453 pid = child_setup (xforkin, xforkout, xforkout,
1454 new_argv, 1, current_dir);
1455 #else /* not WINDOWSNT */
1456 child_setup (xforkin, xforkout, xforkout,
1457 new_argv, 1, current_dir);
1458 #endif /* not WINDOWSNT */
1460 environ = save_environ;
1463 if (pid < 0)
1465 if (forkin >= 0)
1466 close (forkin);
1467 if (forkin != forkout && forkout >= 0)
1468 close (forkout);
1469 report_file_error ("Doing vfork", Qnil);
1472 XSETFASTINT (XPROCESS (process)->pid, pid);
1474 #ifdef WINDOWSNT
1475 register_child (pid, inchannel);
1476 #endif /* WINDOWSNT */
1478 /* If the subfork execv fails, and it exits,
1479 this close hangs. I don't know why.
1480 So have an interrupt jar it loose. */
1481 stop_polling ();
1482 signal (SIGALRM, create_process_1);
1483 alarm (1);
1484 XPROCESS (process)->subtty = Qnil;
1485 if (forkin >= 0)
1486 close (forkin);
1487 alarm (0);
1488 start_polling ();
1489 if (forkin != forkout && forkout >= 0)
1490 close (forkout);
1492 XPROCESS (process)->tty_name = build_string (pty_name);
1494 #ifdef SIGCHLD
1495 #ifdef BSD4_1
1496 sigrelse (SIGCHLD);
1497 #else /* not BSD4_1 */
1498 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1499 sigsetmask (SIGEMPTYMASK);
1500 #else /* ordinary USG */
1501 #if 0
1502 signal (SIGCHLD, sigchld);
1503 /* Now really handle any of these signals
1504 that came in during this function. */
1505 if (sigchld_deferred)
1506 kill (getpid (), SIGCHLD);
1507 #endif
1508 #endif /* ordinary USG */
1509 #endif /* not BSD4_1 */
1510 #endif /* SIGCHLD */
1512 #endif /* not VMS */
1514 #ifdef HAVE_SOCKETS
1516 /* open a TCP network connection to a given HOST/SERVICE. Treated
1517 exactly like a normal process when reading and writing. Only
1518 differences are in status display and process deletion. A network
1519 connection has no PID; you cannot signal it. All you can do is
1520 deactivate and close it via delete-process */
1522 DEFUN ("open-network-stream", Fopen_network_stream, Sopen_network_stream,
1523 4, 4, 0,
1524 "Open a TCP connection for a service to a host.\n\
1525 Returns a subprocess-object to represent the connection.\n\
1526 Input and output work as for subprocesses; `delete-process' closes it.\n\
1527 Args are NAME BUFFER HOST SERVICE.\n\
1528 NAME is name for process. It is modified if necessary to make it unique.\n\
1529 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1530 Process output goes at end of that buffer, unless you specify\n\
1531 an output stream or filter function to handle the output.\n\
1532 BUFFER may be also nil, meaning that this process is not associated\n\
1533 with any buffer\n\
1534 Third arg is name of the host to connect to, or its IP address.\n\
1535 Fourth arg SERVICE is name of the service desired, or an integer\n\
1536 specifying a port number to connect to.")
1537 (name, buffer, host, service)
1538 Lisp_Object name, buffer, host, service;
1540 Lisp_Object proc;
1541 register int i;
1542 struct sockaddr_in address;
1543 struct servent *svc_info;
1544 struct hostent *host_info_ptr, host_info;
1545 char *(addr_list[2]);
1546 IN_ADDR numeric_addr;
1547 int s, outch, inch;
1548 char errstring[80];
1549 int port;
1550 struct hostent host_info_fixed;
1551 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1552 int retry = 0;
1553 int count = specpdl_ptr - specpdl;
1555 GCPRO4 (name, buffer, host, service);
1556 CHECK_STRING (name, 0);
1557 CHECK_STRING (host, 0);
1558 if (INTEGERP (service))
1559 port = htons ((unsigned short) XINT (service));
1560 else
1562 CHECK_STRING (service, 0);
1563 svc_info = getservbyname (XSTRING (service)->data, "tcp");
1564 if (svc_info == 0)
1565 error ("Unknown service \"%s\"", XSTRING (service)->data);
1566 port = svc_info->s_port;
1569 #ifndef TERM
1570 while (1)
1572 #ifdef TRY_AGAIN
1573 h_errno = 0;
1574 #endif
1575 host_info_ptr = gethostbyname (XSTRING (host)->data);
1576 #ifdef TRY_AGAIN
1577 if (! (host_info_ptr == 0 && h_errno == TRY_AGAIN))
1578 #endif
1579 break;
1580 Fsleep_for (make_number (1), Qnil);
1582 if (host_info_ptr == 0)
1583 /* Attempt to interpret host as numeric inet address */
1585 numeric_addr = inet_addr ((char *) XSTRING (host)->data);
1586 if (NUMERIC_ADDR_ERROR)
1587 error ("Unknown host \"%s\"", XSTRING (host)->data);
1589 host_info_ptr = &host_info;
1590 host_info.h_name = 0;
1591 host_info.h_aliases = 0;
1592 host_info.h_addrtype = AF_INET;
1593 #ifdef h_addr
1594 /* Older machines have only one address slot called h_addr.
1595 Newer machines have h_addr_list, but #define h_addr to
1596 be its first element. */
1597 host_info.h_addr_list = &(addr_list[0]);
1598 #endif
1599 host_info.h_addr = (char*)(&numeric_addr);
1600 addr_list[1] = 0;
1601 host_info.h_length = strlen (addr_list[0]);
1604 bzero (&address, sizeof address);
1605 bcopy (host_info_ptr->h_addr, (char *) &address.sin_addr,
1606 host_info_ptr->h_length);
1607 address.sin_family = host_info_ptr->h_addrtype;
1608 address.sin_port = port;
1610 s = socket (host_info_ptr->h_addrtype, SOCK_STREAM, 0);
1611 if (s < 0)
1612 report_file_error ("error creating socket", Fcons (name, Qnil));
1614 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1615 when connect is interrupted. So let's not let it get interrupted.
1616 Note we do not turn off polling, because polling is only used
1617 when not interrupt_input, and thus not normally used on the systems
1618 which have this bug. On systems which use polling, there's no way
1619 to quit if polling is turned off. */
1620 if (interrupt_input)
1621 unrequest_sigio ();
1623 /* Slow down polling to every ten seconds.
1624 Some kernels have a bug which causes retrying connect to fail
1625 after a connect. */
1626 #ifdef POLL_FOR_INPUT
1627 bind_polling_period (10);
1628 #endif
1630 loop:
1631 if (connect (s, (struct sockaddr *) &address, sizeof address) == -1
1632 && errno != EISCONN)
1634 int xerrno = errno;
1636 if (errno == EINTR)
1637 goto loop;
1638 if (errno == EADDRINUSE && retry < 20)
1640 retry++;
1641 goto loop;
1644 close (s);
1646 if (interrupt_input)
1647 request_sigio ();
1649 errno = xerrno;
1650 report_file_error ("connection failed",
1651 Fcons (host, Fcons (name, Qnil)));
1654 #ifdef POLL_FOR_INPUT
1655 unbind_to (count, Qnil);
1656 #endif
1658 if (interrupt_input)
1659 request_sigio ();
1661 #else /* TERM */
1662 s = connect_server (0);
1663 if (s < 0)
1664 report_file_error ("error creating socket", Fcons (name, Qnil));
1665 send_command (s, C_PORT, 0, "%s:%d", XSTRING (host)->data, ntohs (port));
1666 send_command (s, C_DUMB, 1, 0);
1667 #endif /* TERM */
1669 inch = s;
1670 outch = dup (s);
1671 if (outch < 0)
1672 report_file_error ("error duplicating socket", Fcons (name, Qnil));
1674 if (!NILP (buffer))
1675 buffer = Fget_buffer_create (buffer);
1676 proc = make_process (name);
1678 chan_process[inch] = proc;
1680 #ifdef O_NONBLOCK
1681 fcntl (inch, F_SETFL, O_NONBLOCK);
1682 #else
1683 #ifdef O_NDELAY
1684 fcntl (inch, F_SETFL, O_NDELAY);
1685 #endif
1686 #endif
1688 XPROCESS (proc)->childp = host;
1689 XPROCESS (proc)->command_channel_p = Qnil;
1690 XPROCESS (proc)->buffer = buffer;
1691 XPROCESS (proc)->sentinel = Qnil;
1692 XPROCESS (proc)->filter = Qnil;
1693 XPROCESS (proc)->command = Qnil;
1694 XPROCESS (proc)->pid = Qnil;
1695 XSETINT (XPROCESS (proc)->infd, s);
1696 XSETINT (XPROCESS (proc)->outfd, outch);
1697 XPROCESS (proc)->status = Qrun;
1698 FD_SET (inch, &input_wait_mask);
1699 FD_SET (inch, &non_keyboard_wait_mask);
1700 if (inch > max_process_desc)
1701 max_process_desc = inch;
1703 UNGCPRO;
1704 return proc;
1706 #endif /* HAVE_SOCKETS */
1708 deactivate_process (proc)
1709 Lisp_Object proc;
1711 register int inchannel, outchannel;
1712 register struct Lisp_Process *p = XPROCESS (proc);
1714 inchannel = XINT (p->infd);
1715 outchannel = XINT (p->outfd);
1717 if (inchannel >= 0)
1719 /* Beware SIGCHLD hereabouts. */
1720 flush_pending_output (inchannel);
1721 #ifdef VMS
1723 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
1724 sys$dassgn (outchannel);
1725 vs = get_vms_process_pointer (p->pid);
1726 if (vs)
1727 give_back_vms_process_stuff (vs);
1729 #else
1730 close (inchannel);
1731 if (outchannel >= 0 && outchannel != inchannel)
1732 close (outchannel);
1733 #endif
1735 XSETINT (p->infd, -1);
1736 XSETINT (p->outfd, -1);
1737 chan_process[inchannel] = Qnil;
1738 FD_CLR (inchannel, &input_wait_mask);
1739 FD_CLR (inchannel, &non_keyboard_wait_mask);
1740 if (inchannel == max_process_desc)
1742 int i;
1743 /* We just closed the highest-numbered process input descriptor,
1744 so recompute the highest-numbered one now. */
1745 max_process_desc = 0;
1746 for (i = 0; i < MAXDESC; i++)
1747 if (!NILP (chan_process[i]))
1748 max_process_desc = i;
1753 /* Close all descriptors currently in use for communication
1754 with subprocess. This is used in a newly-forked subprocess
1755 to get rid of irrelevant descriptors. */
1757 close_process_descs ()
1759 #ifndef WINDOWSNT
1760 int i;
1761 for (i = 0; i < MAXDESC; i++)
1763 Lisp_Object process;
1764 process = chan_process[i];
1765 if (!NILP (process))
1767 int in = XINT (XPROCESS (process)->infd);
1768 int out = XINT (XPROCESS (process)->outfd);
1769 if (in >= 0)
1770 close (in);
1771 if (out >= 0 && in != out)
1772 close (out);
1775 #endif
1778 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
1779 0, 3, 0,
1780 "Allow any pending output from subprocesses to be read by Emacs.\n\
1781 It is read into the process' buffers or given to their filter functions.\n\
1782 Non-nil arg PROCESS means do not return until some output has been received\n\
1783 from PROCESS.\n\
1784 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1785 seconds and microseconds to wait; return after that much time whether\n\
1786 or not there is input.\n\
1787 Return non-nil iff we received any output before the timeout expired.")
1788 (proc, timeout, timeout_msecs)
1789 register Lisp_Object proc, timeout, timeout_msecs;
1791 int seconds;
1792 int useconds;
1794 if (! NILP (timeout_msecs))
1796 CHECK_NUMBER (timeout_msecs, 2);
1797 useconds = XINT (timeout_msecs);
1798 if (!INTEGERP (timeout))
1799 XSETINT (timeout, 0);
1802 int carry = useconds / 1000000;
1804 XSETINT (timeout, XINT (timeout) + carry);
1805 useconds -= carry * 1000000;
1807 /* I think this clause is necessary because C doesn't
1808 guarantee a particular rounding direction for negative
1809 integers. */
1810 if (useconds < 0)
1812 XSETINT (timeout, XINT (timeout) - 1);
1813 useconds += 1000000;
1817 else
1818 useconds = 0;
1820 if (! NILP (timeout))
1822 CHECK_NUMBER (timeout, 1);
1823 seconds = XINT (timeout);
1824 if (seconds <= 0)
1825 seconds = -1;
1827 else
1829 if (NILP (proc))
1830 seconds = -1;
1831 else
1832 seconds = 0;
1835 if (NILP (proc))
1836 XSETFASTINT (proc, 0);
1838 return
1839 (wait_reading_process_input (seconds, useconds, proc, 0)
1840 ? Qt : Qnil);
1843 /* This variable is different from waiting_for_input in keyboard.c.
1844 It is used to communicate to a lisp process-filter/sentinel (via the
1845 function Fwaiting_for_user_input_p below) whether emacs was waiting
1846 for user-input when that process-filter was called.
1847 waiting_for_input cannot be used as that is by definition 0 when
1848 lisp code is being evalled.
1849 This is also used in record_asynch_buffer_change.
1850 For that purpose, this must be 0
1851 when not inside wait_reading_process_input. */
1852 static int waiting_for_user_input_p;
1854 /* Read and dispose of subprocess output while waiting for timeout to
1855 elapse and/or keyboard input to be available.
1857 TIME_LIMIT is:
1858 timeout in seconds, or
1859 zero for no limit, or
1860 -1 means gobble data immediately available but don't wait for any.
1862 MICROSECS is:
1863 an additional duration to wait, measured in microseconds.
1864 If this is nonzero and time_limit is 0, then the timeout
1865 consists of MICROSECS only.
1867 READ_KBD is a lisp value:
1868 0 to ignore keyboard input, or
1869 1 to return when input is available, or
1870 -1 meaning caller will actually read the input, so don't throw to
1871 the quit handler, or
1872 a cons cell, meaning wait until its car is non-nil
1873 (and gobble terminal input into the buffer if any arrives), or
1874 a process object, meaning wait until something arrives from that
1875 process. The return value is true iff we read some input from
1876 that process.
1878 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1879 output that arrives.
1881 If READ_KBD is a pointer to a struct Lisp_Process, then the
1882 function returns true iff we received input from that process
1883 before the timeout elapsed.
1884 Otherwise, return true iff we received input from any process. */
1886 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
1887 int time_limit, microsecs;
1888 Lisp_Object read_kbd;
1889 int do_display;
1891 register int channel, nfds, m;
1892 static SELECT_TYPE Available;
1893 int xerrno;
1894 Lisp_Object proc;
1895 EMACS_TIME timeout, end_time, garbage;
1896 SELECT_TYPE Atemp;
1897 int wait_channel = -1;
1898 struct Lisp_Process *wait_proc = 0;
1899 int got_some_input = 0;
1900 Lisp_Object *wait_for_cell = 0;
1902 FD_ZERO (&Available);
1904 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1905 accordingly. */
1906 if (PROCESSP (read_kbd))
1908 wait_proc = XPROCESS (read_kbd);
1909 wait_channel = XINT (wait_proc->infd);
1910 XSETFASTINT (read_kbd, 0);
1913 /* If waiting for non-nil in a cell, record where. */
1914 if (CONSP (read_kbd))
1916 wait_for_cell = &XCONS (read_kbd)->car;
1917 XSETFASTINT (read_kbd, 0);
1920 waiting_for_user_input_p = XINT (read_kbd);
1922 /* Since we may need to wait several times,
1923 compute the absolute time to return at. */
1924 if (time_limit || microsecs)
1926 EMACS_GET_TIME (end_time);
1927 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
1928 EMACS_ADD_TIME (end_time, end_time, timeout);
1931 /* It would not be safe to call this below,
1932 where we call redisplay_preserve_echo_area. */
1933 if (do_display && frame_garbaged)
1934 prepare_menu_bars ();
1936 while (1)
1938 /* If calling from keyboard input, do not quit
1939 since we want to return C-g as an input character.
1940 Otherwise, do pending quit if requested. */
1941 if (XINT (read_kbd) >= 0)
1942 QUIT;
1944 /* Exit now if the cell we're waiting for became non-nil. */
1945 if (wait_for_cell && ! NILP (*wait_for_cell))
1946 break;
1948 /* Compute time from now till when time limit is up */
1949 /* Exit if already run out */
1950 if (time_limit == -1)
1952 /* -1 specified for timeout means
1953 gobble output available now
1954 but don't wait at all. */
1956 EMACS_SET_SECS_USECS (timeout, 0, 0);
1958 else if (time_limit || microsecs)
1960 EMACS_GET_TIME (timeout);
1961 EMACS_SUB_TIME (timeout, end_time, timeout);
1962 if (EMACS_TIME_NEG_P (timeout))
1963 break;
1965 else
1967 EMACS_SET_SECS_USECS (timeout, 100000, 0);
1970 /* Cause C-g and alarm signals to take immediate action,
1971 and cause input available signals to zero out timeout.
1973 It is important that we do this before checking for process
1974 activity. If we get a SIGCHLD after the explicit checks for
1975 process activity, timeout is the only way we will know. */
1976 if (XINT (read_kbd) < 0)
1977 set_waiting_for_input (&timeout);
1979 /* If status of something has changed, and no input is
1980 available, notify the user of the change right away. After
1981 this explicit check, we'll let the SIGCHLD handler zap
1982 timeout to get our attention. */
1983 if (update_tick != process_tick && do_display)
1985 Atemp = input_wait_mask;
1986 EMACS_SET_SECS_USECS (timeout, 0, 0);
1987 if (select (MAXDESC, &Atemp, 0, 0, &timeout) <= 0)
1989 /* It's okay for us to do this and then continue with
1990 the loop, since timeout has already been zeroed out. */
1991 clear_waiting_for_input ();
1992 status_notify ();
1996 /* Don't wait for output from a non-running process. */
1997 if (wait_proc != 0 && !NILP (wait_proc->raw_status_low))
1998 update_status (wait_proc);
1999 if (wait_proc != 0
2000 && ! EQ (wait_proc->status, Qrun))
2002 clear_waiting_for_input ();
2003 break;
2006 /* Wait till there is something to do */
2008 if (! XINT (read_kbd) && wait_for_cell == 0)
2009 Available = non_keyboard_wait_mask;
2010 else
2011 Available = input_wait_mask;
2013 /* If frame size has changed or the window is newly mapped,
2014 redisplay now, before we start to wait. There is a race
2015 condition here; if a SIGIO arrives between now and the select
2016 and indicates that a frame is trashed, the select may block
2017 displaying a trashed screen. */
2018 if (frame_garbaged && do_display)
2019 redisplay_preserve_echo_area ();
2021 if (XINT (read_kbd) && detect_input_pending ())
2023 nfds = 0;
2024 FD_ZERO (&Available);
2026 else
2027 nfds = select (MAXDESC, &Available, 0, 0, &timeout);
2029 xerrno = errno;
2031 /* Make C-g and alarm signals set flags again */
2032 clear_waiting_for_input ();
2034 /* If we woke up due to SIGWINCH, actually change size now. */
2035 do_pending_window_change ();
2037 if (time_limit && nfds == 0) /* timeout elapsed */
2038 break;
2039 if (nfds < 0)
2041 if (xerrno == EINTR)
2042 FD_ZERO (&Available);
2043 #ifdef ultrix
2044 /* Ultrix select seems to return ENOMEM when it is
2045 interrupted. Treat it just like EINTR. Bleah. Note
2046 that we want to test for the "ultrix" CPP symbol, not
2047 "__ultrix__"; the latter is only defined under GCC, but
2048 not by DEC's bundled CC. -JimB */
2049 else if (xerrno == ENOMEM)
2050 FD_ZERO (&Available);
2051 #endif
2052 #ifdef ALLIANT
2053 /* This happens for no known reason on ALLIANT.
2054 I am guessing that this is the right response. -- RMS. */
2055 else if (xerrno == EFAULT)
2056 FD_ZERO (&Available);
2057 #endif
2058 else if (xerrno == EBADF)
2060 #ifdef AIX
2061 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
2062 the child's closure of the pts gives the parent a SIGHUP, and
2063 the ptc file descriptor is automatically closed,
2064 yielding EBADF here or at select() call above.
2065 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
2066 in m/ibmrt-aix.h), and here we just ignore the select error.
2067 Cleanup occurs c/o status_notify after SIGCLD. */
2068 FD_ZERO (&Available); /* Cannot depend on values returned */
2069 #else
2070 abort ();
2071 #endif
2073 else
2074 error("select error: %s", strerror (xerrno));
2076 #if defined(sun) && !defined(USG5_4)
2077 else if (nfds > 0 && keyboard_bit_set (&Available)
2078 && interrupt_input)
2079 /* System sometimes fails to deliver SIGIO.
2081 David J. Mackenzie says that Emacs doesn't compile under
2082 Solaris if this code is enabled, thus the USG5_4 in the CPP
2083 conditional. "I haven't noticed any ill effects so far.
2084 If you find a Solaris expert somewhere, they might know
2085 better." */
2086 kill (getpid (), SIGIO);
2087 #endif
2089 /* Check for keyboard input */
2090 /* If there is any, return immediately
2091 to give it higher priority than subprocesses */
2093 /* We used to do this if wait_for_cell,
2094 but that caused infinite recursion in selection request events. */
2095 if ((XINT (read_kbd) || wait_for_cell)
2096 && detect_input_pending ())
2098 swallow_events ();
2099 if (detect_input_pending ())
2100 break;
2103 /* Exit now if the cell we're waiting for became non-nil. */
2104 if (wait_for_cell && ! NILP (*wait_for_cell))
2105 break;
2107 #ifdef SIGIO
2108 /* If we think we have keyboard input waiting, but didn't get SIGIO
2109 go read it. This can happen with X on BSD after logging out.
2110 In that case, there really is no input and no SIGIO,
2111 but select says there is input. */
2113 if (XINT (read_kbd) && interrupt_input
2114 && (keyboard_bit_set (&Available)))
2115 kill (0, SIGIO);
2116 #endif
2118 if (! wait_proc)
2119 got_some_input |= nfds > 0;
2121 /* If checking input just got us a size-change event from X,
2122 obey it now if we should. */
2123 if (XINT (read_kbd) || wait_for_cell)
2124 do_pending_window_change ();
2126 /* Check for data from a process. */
2127 /* Really FIRST_PROC_DESC should be 0 on Unix,
2128 but this is safer in the short run. */
2129 for (channel = 0; channel <= max_process_desc; channel++)
2131 if (FD_ISSET (channel, &Available)
2132 && FD_ISSET (channel, &non_keyboard_wait_mask))
2134 int nread;
2136 /* If waiting for this channel, arrange to return as
2137 soon as no more input to be processed. No more
2138 waiting. */
2139 if (wait_channel == channel)
2141 wait_channel = -1;
2142 time_limit = -1;
2143 got_some_input = 1;
2145 proc = chan_process[channel];
2146 if (NILP (proc))
2147 continue;
2149 /* Read data from the process, starting with our
2150 buffered-ahead character if we have one. */
2152 nread = read_process_output (proc, channel);
2153 if (nread > 0)
2155 /* Since read_process_output can run a filter,
2156 which can call accept-process-output,
2157 don't try to read from any other processes
2158 before doing the select again. */
2159 FD_ZERO (&Available);
2161 if (do_display)
2162 redisplay_preserve_echo_area ();
2164 #ifdef EWOULDBLOCK
2165 else if (nread == -1 && errno == EWOULDBLOCK)
2167 #else
2168 #ifdef O_NONBLOCK
2169 else if (nread == -1 && errno == EAGAIN)
2171 #else
2172 #ifdef O_NDELAY
2173 else if (nread == -1 && errno == EAGAIN)
2175 /* Note that we cannot distinguish between no input
2176 available now and a closed pipe.
2177 With luck, a closed pipe will be accompanied by
2178 subprocess termination and SIGCHLD. */
2179 else if (nread == 0 && !NETCONN_P (proc))
2181 #endif /* O_NDELAY */
2182 #endif /* O_NONBLOCK */
2183 #endif /* EWOULDBLOCK */
2184 #ifdef HAVE_PTYS
2185 /* On some OSs with ptys, when the process on one end of
2186 a pty exits, the other end gets an error reading with
2187 errno = EIO instead of getting an EOF (0 bytes read).
2188 Therefore, if we get an error reading and errno =
2189 EIO, just continue, because the child process has
2190 exited and should clean itself up soon (e.g. when we
2191 get a SIGCHLD). */
2192 else if (nread == -1 && errno == EIO)
2194 #endif /* HAVE_PTYS */
2195 /* If we can detect process termination, don't consider the process
2196 gone just because its pipe is closed. */
2197 #ifdef SIGCHLD
2198 else if (nread == 0 && !NETCONN_P (proc))
2200 #endif
2201 else
2203 /* Preserve status of processes already terminated. */
2204 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2205 deactivate_process (proc);
2206 if (!NILP (XPROCESS (proc)->raw_status_low))
2207 update_status (XPROCESS (proc));
2208 if (EQ (XPROCESS (proc)->status, Qrun))
2209 XPROCESS (proc)->status
2210 = Fcons (Qexit, Fcons (make_number (256), Qnil));
2213 } /* end for each file descriptor */
2214 } /* end while exit conditions not met */
2216 waiting_for_user_input_p = 0;
2218 /* If calling from keyboard input, do not quit
2219 since we want to return C-g as an input character.
2220 Otherwise, do pending quit if requested. */
2221 if (XINT (read_kbd) >= 0)
2223 /* Prevent input_pending from remaining set if we quit. */
2224 clear_input_pending ();
2225 QUIT;
2228 return got_some_input;
2231 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
2233 static Lisp_Object
2234 read_process_output_call (fun_and_args)
2235 Lisp_Object fun_and_args;
2237 return apply1 (XCONS (fun_and_args)->car, XCONS (fun_and_args)->cdr);
2240 static Lisp_Object
2241 read_process_output_error_handler (error)
2242 Lisp_Object error;
2244 cmd_error_internal (error, "error in process filter: ");
2245 Vinhibit_quit = Qt;
2246 update_echo_area ();
2247 Fsleep_for (make_number (2));
2250 /* Read pending output from the process channel,
2251 starting with our buffered-ahead character if we have one.
2252 Yield number of characters read.
2254 This function reads at most 1024 characters.
2255 If you want to read all available subprocess output,
2256 you must call it repeatedly until it returns zero. */
2258 read_process_output (proc, channel)
2259 Lisp_Object proc;
2260 register int channel;
2262 register int nchars;
2263 #ifdef VMS
2264 char *chars;
2265 #else
2266 char chars[1024];
2267 #endif
2268 register Lisp_Object outstream;
2269 register struct buffer *old = current_buffer;
2270 register struct Lisp_Process *p = XPROCESS (proc);
2271 register int opoint;
2273 #ifdef VMS
2274 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2276 vs = get_vms_process_pointer (p->pid);
2277 if (vs)
2279 if (!vs->iosb[0])
2280 return(0); /* Really weird if it does this */
2281 if (!(vs->iosb[0] & 1))
2282 return -1; /* I/O error */
2284 else
2285 error ("Could not get VMS process pointer");
2286 chars = vs->inputBuffer;
2287 nchars = clean_vms_buffer (chars, vs->iosb[1]);
2288 if (nchars <= 0)
2290 start_vms_process_read (vs); /* Crank up the next read on the process */
2291 return 1; /* Nothing worth printing, say we got 1 */
2293 #else /* not VMS */
2295 if (proc_buffered_char[channel] < 0)
2296 #ifdef WINDOWSNT
2297 nchars = read_child_output (channel, chars, sizeof (chars));
2298 #else
2299 nchars = read (channel, chars, sizeof chars);
2300 #endif
2301 else
2303 chars[0] = proc_buffered_char[channel];
2304 proc_buffered_char[channel] = -1;
2305 #ifdef WINDOWSNT
2306 nchars = read_child_output (channel, chars + 1, sizeof (chars) - 1);
2307 #else
2308 nchars = read (channel, chars + 1, sizeof chars - 1);
2309 #endif
2310 if (nchars < 0)
2311 nchars = 1;
2312 else
2313 nchars = nchars + 1;
2315 #endif /* not VMS */
2317 if (nchars <= 0) return nchars;
2319 outstream = p->filter;
2320 if (!NILP (outstream))
2322 /* We inhibit quit here instead of just catching it so that
2323 hitting ^G when a filter happens to be running won't screw
2324 it up. */
2325 int count = specpdl_ptr - specpdl;
2326 Lisp_Object odeactivate;
2327 Lisp_Object obuffer;
2329 odeactivate = Vdeactivate_mark;
2330 obuffer = Fcurrent_buffer ();
2332 specbind (Qinhibit_quit, Qt);
2333 specbind (Qlast_nonmenu_event, Qt);
2335 running_asynch_code = 1;
2336 internal_condition_case_1 (read_process_output_call,
2337 Fcons (outstream,
2338 Fcons (proc,
2339 Fcons (make_string (chars,
2340 nchars),
2341 Qnil))),
2342 !NILP (Vdebug_on_error) ? Qnil : Qerror,
2343 read_process_output_error_handler);
2344 running_asynch_code = 0;
2345 restore_match_data ();
2347 /* Handling the process output should not deactivate the mark. */
2348 Vdeactivate_mark = odeactivate;
2350 if (! EQ (Fcurrent_buffer (), obuffer))
2351 record_asynch_buffer_change ();
2353 if (waiting_for_user_input_p)
2354 prepare_menu_bars ();
2356 #ifdef VMS
2357 start_vms_process_read (vs);
2358 #endif
2359 unbind_to (count, Qnil);
2360 return nchars;
2363 /* If no filter, write into buffer if it isn't dead. */
2364 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
2366 Lisp_Object old_read_only;
2367 Lisp_Object old_begv, old_zv;
2368 Lisp_Object odeactivate;
2370 odeactivate = Vdeactivate_mark;
2372 Fset_buffer (p->buffer);
2373 opoint = point;
2374 old_read_only = current_buffer->read_only;
2375 XSETFASTINT (old_begv, BEGV);
2376 XSETFASTINT (old_zv, ZV);
2378 current_buffer->read_only = Qnil;
2380 /* Insert new output into buffer
2381 at the current end-of-output marker,
2382 thus preserving logical ordering of input and output. */
2383 if (XMARKER (p->mark)->buffer)
2384 SET_PT (clip_to_bounds (BEGV, marker_position (p->mark), ZV));
2385 else
2386 SET_PT (ZV);
2388 /* If the output marker is outside of the visible region, save
2389 the restriction and widen. */
2390 if (! (BEGV <= point && point <= ZV))
2391 Fwiden ();
2393 /* Make sure opoint floats ahead of any new text, just as point
2394 would. */
2395 if (point <= opoint)
2396 opoint += nchars;
2398 /* Insert after old_begv, but before old_zv. */
2399 if (point < XFASTINT (old_begv))
2400 XSETFASTINT (old_begv, XFASTINT (old_begv) + nchars);
2401 if (point <= XFASTINT (old_zv))
2402 XSETFASTINT (old_zv, XFASTINT (old_zv) + nchars);
2404 /* Insert before markers in case we are inserting where
2405 the buffer's mark is, and the user's next command is Meta-y. */
2406 insert_before_markers (chars, nchars);
2407 Fset_marker (p->mark, make_number (point), p->buffer);
2409 update_mode_lines++;
2411 /* If the restriction isn't what it should be, set it. */
2412 if (XFASTINT (old_begv) != BEGV || XFASTINT (old_zv) != ZV)
2413 Fnarrow_to_region (old_begv, old_zv);
2415 /* Handling the process output should not deactivate the mark. */
2416 Vdeactivate_mark = odeactivate;
2418 current_buffer->read_only = old_read_only;
2419 SET_PT (opoint);
2420 set_buffer_internal (old);
2422 #ifdef VMS
2423 start_vms_process_read (vs);
2424 #endif
2425 return nchars;
2428 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
2429 0, 0, 0,
2430 "Returns non-nil if emacs is waiting for input from the user.\n\
2431 This is intended for use by asynchronous process output filters and sentinels.")
2434 return (waiting_for_user_input_p ? Qt : Qnil);
2437 /* Sending data to subprocess */
2439 jmp_buf send_process_frame;
2441 SIGTYPE
2442 send_process_trap ()
2444 #ifdef BSD4_1
2445 sigrelse (SIGPIPE);
2446 sigrelse (SIGALRM);
2447 #endif /* BSD4_1 */
2448 longjmp (send_process_frame, 1);
2451 /* Send some data to process PROC.
2452 BUF is the beginning of the data; LEN is the number of characters.
2453 OBJECT is the Lisp object that the data comes from. */
2455 send_process (proc, buf, len, object)
2456 Lisp_Object proc;
2457 char *buf;
2458 int len;
2459 Lisp_Object object;
2461 /* Don't use register vars; longjmp can lose them. */
2462 int rv;
2463 unsigned char *procname = XSTRING (XPROCESS (proc)->name)->data;
2465 #ifdef VMS
2466 struct Lisp_Process *p = XPROCESS (proc);
2467 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2468 #endif /* VMS */
2470 if (! NILP (XPROCESS (proc)->raw_status_low))
2471 update_status (XPROCESS (proc));
2472 if (! EQ (XPROCESS (proc)->status, Qrun))
2473 error ("Process %s not running", procname);
2475 #ifdef VMS
2476 vs = get_vms_process_pointer (p->pid);
2477 if (vs == 0)
2478 error ("Could not find this process: %x", p->pid);
2479 else if (write_to_vms_process (vs, buf, len))
2481 #else
2483 if (pty_max_bytes == 0)
2485 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2486 pty_max_bytes = fpathconf (XFASTINT (XPROCESS (proc)->outfd),
2487 _PC_MAX_CANON);
2488 if (pty_max_bytes < 0)
2489 pty_max_bytes = 250;
2490 #else
2491 pty_max_bytes = 250;
2492 #endif
2493 /* Deduct one, to leave space for the eof. */
2494 pty_max_bytes--;
2497 if (!setjmp (send_process_frame))
2498 while (len > 0)
2500 int this = len;
2501 SIGTYPE (*old_sigpipe)();
2502 int flush_pty = 0;
2504 /* Decide how much data we can send in one batch.
2505 Long lines need to be split into multiple batches. */
2506 if (!NILP (XPROCESS (proc)->pty_flag))
2508 /* Starting this at zero is always correct when not the first iteration
2509 because the previous iteration ended by sending C-d.
2510 It may not be correct for the first iteration
2511 if a partial line was sent in a separate send_process call.
2512 If that proves worth handling, we need to save linepos
2513 in the process object. */
2514 int linepos = 0;
2515 char *ptr = buf;
2516 char *end = buf + len;
2518 /* Scan through this text for a line that is too long. */
2519 while (ptr != end && linepos < pty_max_bytes)
2521 if (*ptr == '\n')
2522 linepos = 0;
2523 else
2524 linepos++;
2525 ptr++;
2527 /* If we found one, break the line there
2528 and put in a C-d to force the buffer through. */
2529 this = ptr - buf;
2532 /* Send this batch, using one or more write calls. */
2533 while (this > 0)
2535 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
2536 rv = write (XINT (XPROCESS (proc)->outfd), buf, this);
2537 signal (SIGPIPE, old_sigpipe);
2539 if (rv < 0)
2541 if (0
2542 #ifdef EWOULDBLOCK
2543 || errno == EWOULDBLOCK
2544 #endif
2545 #ifdef EAGAIN
2546 || errno == EAGAIN
2547 #endif
2549 /* Buffer is full. Wait, accepting input;
2550 that may allow the program
2551 to finish doing output and read more. */
2553 Lisp_Object zero;
2554 int offset;
2556 /* Running filters might relocate buffers or strings.
2557 Arrange to relocate BUF. */
2558 if (BUFFERP (object))
2559 offset = BUF_PTR_CHAR_POS (XBUFFER (object),
2560 (unsigned char *) buf);
2561 else if (STRINGP (object))
2562 offset = buf - (char *) XSTRING (object)->data;
2564 XSETFASTINT (zero, 0);
2565 wait_reading_process_input (1, 0, zero, 0);
2567 if (BUFFERP (object))
2568 buf = (char *) BUF_CHAR_ADDRESS (XBUFFER (object), offset);
2569 else if (STRINGP (object))
2570 buf = offset + (char *) XSTRING (object)->data;
2572 rv = 0;
2574 else
2575 /* This is a real error. */
2576 report_file_error ("writing to process", Fcons (proc, Qnil));
2578 buf += rv;
2579 len -= rv;
2580 this -= rv;
2583 /* If we sent just part of the string, put in an EOF
2584 to force it through, before we send the rest. */
2585 if (len > 0)
2586 Fprocess_send_eof (proc);
2588 #endif
2589 else
2591 XPROCESS (proc)->raw_status_low = Qnil;
2592 XPROCESS (proc)->raw_status_high = Qnil;
2593 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
2594 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2595 deactivate_process (proc);
2596 #ifdef VMS
2597 error ("Error writing to process %s; closed it", procname);
2598 #else
2599 error ("SIGPIPE raised on process %s; closed it", procname);
2600 #endif
2604 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
2605 3, 3, 0,
2606 "Send current contents of region as input to PROCESS.\n\
2607 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2608 nil, indicating the current buffer's process.\n\
2609 Called from program, takes three arguments, PROCESS, START and END.\n\
2610 If the region is more than 500 characters long,\n\
2611 it is sent in several bunches. This may happen even for shorter regions.\n\
2612 Output from processes can arrive in between bunches.")
2613 (process, start, end)
2614 Lisp_Object process, start, end;
2616 Lisp_Object proc;
2617 int start1;
2619 proc = get_process (process);
2620 validate_region (&start, &end);
2622 if (XINT (start) < GPT && XINT (end) > GPT)
2623 move_gap (start);
2625 start1 = XINT (start);
2626 send_process (proc, &FETCH_CHAR (start1), XINT (end) - XINT (start),
2627 Fcurrent_buffer ());
2629 return Qnil;
2632 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
2633 2, 2, 0,
2634 "Send PROCESS the contents of STRING as input.\n\
2635 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2636 nil, indicating the current buffer's process.\n\
2637 If STRING is more than 500 characters long,\n\
2638 it is sent in several bunches. This may happen even for shorter strings.\n\
2639 Output from processes can arrive in between bunches.")
2640 (process, string)
2641 Lisp_Object process, string;
2643 Lisp_Object proc;
2644 CHECK_STRING (string, 1);
2645 proc = get_process (process);
2646 send_process (proc, XSTRING (string)->data, XSTRING (string)->size, string);
2647 return Qnil;
2650 /* send a signal number SIGNO to PROCESS.
2651 CURRENT_GROUP means send to the process group that currently owns
2652 the terminal being used to communicate with PROCESS.
2653 This is used for various commands in shell mode.
2654 If NOMSG is zero, insert signal-announcements into process's buffers
2655 right away.
2657 If we can, we try to signal PROCESS by sending control characters
2658 down the pty. This allows us to signal inferiors who have changed
2659 their uid, for which killpg would return an EPERM error. */
2661 static void
2662 process_send_signal (process, signo, current_group, nomsg)
2663 Lisp_Object process;
2664 int signo;
2665 Lisp_Object current_group;
2666 int nomsg;
2668 Lisp_Object proc;
2669 register struct Lisp_Process *p;
2670 int gid;
2671 int no_pgrp = 0;
2673 proc = get_process (process);
2674 p = XPROCESS (proc);
2676 if (!EQ (p->childp, Qt))
2677 error ("Process %s is not a subprocess",
2678 XSTRING (p->name)->data);
2679 if (XINT (p->infd) < 0)
2680 error ("Process %s is not active",
2681 XSTRING (p->name)->data);
2683 if (NILP (p->pty_flag))
2684 current_group = Qnil;
2686 /* If we are using pgrps, get a pgrp number and make it negative. */
2687 if (!NILP (current_group))
2689 #ifdef SIGNALS_VIA_CHARACTERS
2690 /* If possible, send signals to the entire pgrp
2691 by sending an input character to it. */
2693 /* TERMIOS is the latest and bestest, and seems most likely to
2694 work. If the system has it, use it. */
2695 #ifdef HAVE_TERMIOS
2696 struct termios t;
2698 switch (signo)
2700 case SIGINT:
2701 tcgetattr (XINT (p->infd), &t);
2702 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
2703 return;
2705 case SIGQUIT:
2706 tcgetattr (XINT (p->infd), &t);
2707 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
2708 return;
2710 case SIGTSTP:
2711 tcgetattr (XINT (p->infd), &t);
2712 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
2713 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
2714 #else
2715 send_process (proc, &t.c_cc[VSUSP], 1, Qnil);
2716 #endif
2717 return;
2720 #else /* ! HAVE_TERMIOS */
2722 /* On Berkeley descendants, the following IOCTL's retrieve the
2723 current control characters. */
2724 #if defined (TIOCGLTC) && defined (TIOCGETC)
2726 struct tchars c;
2727 struct ltchars lc;
2729 switch (signo)
2731 case SIGINT:
2732 ioctl (XINT (p->infd), TIOCGETC, &c);
2733 send_process (proc, &c.t_intrc, 1, Qnil);
2734 return;
2735 case SIGQUIT:
2736 ioctl (XINT (p->infd), TIOCGETC, &c);
2737 send_process (proc, &c.t_quitc, 1, Qnil);
2738 return;
2739 #ifdef SIGTSTP
2740 case SIGTSTP:
2741 ioctl (XINT (p->infd), TIOCGLTC, &lc);
2742 send_process (proc, &lc.t_suspc, 1, Qnil);
2743 return;
2744 #endif /* ! defined (SIGTSTP) */
2747 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2749 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2750 characters. */
2751 #ifdef TCGETA
2752 struct termio t;
2753 switch (signo)
2755 case SIGINT:
2756 ioctl (XINT (p->infd), TCGETA, &t);
2757 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
2758 return;
2759 case SIGQUIT:
2760 ioctl (XINT (p->infd), TCGETA, &t);
2761 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
2762 return;
2763 #ifdef SIGTSTP
2764 case SIGTSTP:
2765 ioctl (XINT (p->infd), TCGETA, &t);
2766 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
2767 return;
2768 #endif /* ! defined (SIGTSTP) */
2770 #else /* ! defined (TCGETA) */
2771 Your configuration files are messed up.
2772 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2773 you'd better be using one of the alternatives above! */
2774 #endif /* ! defined (TCGETA) */
2775 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2776 #endif /* ! defined HAVE_TERMIOS */
2777 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2779 #ifdef TIOCGPGRP
2780 /* Get the pgrp using the tty itself, if we have that.
2781 Otherwise, use the pty to get the pgrp.
2782 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2783 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2784 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2785 His patch indicates that if TIOCGPGRP returns an error, then
2786 we should just assume that p->pid is also the process group id. */
2788 int err;
2790 if (!NILP (p->subtty))
2791 err = ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
2792 else
2793 err = ioctl (XINT (p->infd), TIOCGPGRP, &gid);
2795 #ifdef pfa
2796 if (err == -1)
2797 gid = - XFASTINT (p->pid);
2798 #endif /* ! defined (pfa) */
2800 if (gid == -1)
2801 no_pgrp = 1;
2802 else
2803 gid = - gid;
2804 #else /* ! defined (TIOCGPGRP ) */
2805 /* Can't select pgrps on this system, so we know that
2806 the child itself heads the pgrp. */
2807 gid = - XFASTINT (p->pid);
2808 #endif /* ! defined (TIOCGPGRP ) */
2810 else
2811 gid = - XFASTINT (p->pid);
2813 switch (signo)
2815 #ifdef SIGCONT
2816 case SIGCONT:
2817 p->raw_status_low = Qnil;
2818 p->raw_status_high = Qnil;
2819 p->status = Qrun;
2820 XSETINT (p->tick, ++process_tick);
2821 if (!nomsg)
2822 status_notify ();
2823 break;
2824 #endif /* ! defined (SIGCONT) */
2825 case SIGINT:
2826 #ifdef VMS
2827 send_process (proc, "\003", 1, Qnil); /* ^C */
2828 goto whoosh;
2829 #endif
2830 case SIGQUIT:
2831 #ifdef VMS
2832 send_process (proc, "\031", 1, Qnil); /* ^Y */
2833 goto whoosh;
2834 #endif
2835 case SIGKILL:
2836 #ifdef VMS
2837 sys$forcex (&(XFASTINT (p->pid)), 0, 1);
2838 whoosh:
2839 #endif
2840 flush_pending_output (XINT (p->infd));
2841 break;
2844 /* If we don't have process groups, send the signal to the immediate
2845 subprocess. That isn't really right, but it's better than any
2846 obvious alternative. */
2847 if (no_pgrp)
2849 kill (XFASTINT (p->pid), signo);
2850 return;
2853 /* gid may be a pid, or minus a pgrp's number */
2854 #ifdef TIOCSIGSEND
2855 if (!NILP (current_group))
2856 ioctl (XINT (p->infd), TIOCSIGSEND, signo);
2857 else
2859 gid = - XFASTINT (p->pid);
2860 kill (gid, signo);
2862 #else /* ! defined (TIOCSIGSEND) */
2863 EMACS_KILLPG (-gid, signo);
2864 #endif /* ! defined (TIOCSIGSEND) */
2867 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
2868 "Interrupt process PROCESS. May be process or name of one.\n\
2869 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2870 nil or no arg means current buffer's process.\n\
2871 Second arg CURRENT-GROUP non-nil means send signal to\n\
2872 the current process-group of the process's controlling terminal\n\
2873 rather than to the process's own process group.\n\
2874 If the process is a shell, this means interrupt current subjob\n\
2875 rather than the shell.")
2876 (process, current_group)
2877 Lisp_Object process, current_group;
2879 process_send_signal (process, SIGINT, current_group, 0);
2880 return process;
2883 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
2884 "Kill process PROCESS. May be process or name of one.\n\
2885 See function `interrupt-process' for more details on usage.")
2886 (process, current_group)
2887 Lisp_Object process, current_group;
2889 process_send_signal (process, SIGKILL, current_group, 0);
2890 return process;
2893 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
2894 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2895 See function `interrupt-process' for more details on usage.")
2896 (process, current_group)
2897 Lisp_Object process, current_group;
2899 process_send_signal (process, SIGQUIT, current_group, 0);
2900 return process;
2903 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
2904 "Stop process PROCESS. May be process or name of one.\n\
2905 See function `interrupt-process' for more details on usage.")
2906 (process, current_group)
2907 Lisp_Object process, current_group;
2909 #ifndef SIGTSTP
2910 error ("no SIGTSTP support");
2911 #else
2912 process_send_signal (process, SIGTSTP, current_group, 0);
2913 #endif
2914 return process;
2917 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
2918 "Continue process PROCESS. May be process or name of one.\n\
2919 See function `interrupt-process' for more details on usage.")
2920 (process, current_group)
2921 Lisp_Object process, current_group;
2923 #ifdef SIGCONT
2924 process_send_signal (process, SIGCONT, current_group, 0);
2925 #else
2926 error ("no SIGCONT support");
2927 #endif
2928 return process;
2931 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
2932 2, 2, "nProcess number: \nnSignal code: ",
2933 "Send the process with number PID the signal with code CODE.\n\
2934 Both PID and CODE are integers.")
2935 (pid, sig)
2936 Lisp_Object pid, sig;
2938 CHECK_NUMBER (pid, 0);
2939 CHECK_NUMBER (sig, 1);
2940 #ifdef WINDOWSNT
2941 /* Only works for kill-type signals */
2942 return make_number (win32_kill_process (XINT (pid), XINT (sig)));
2943 #else
2944 return make_number (kill (XINT (pid), XINT (sig)));
2945 #endif
2948 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
2949 "Make PROCESS see end-of-file in its input.\n\
2950 Eof comes after any text already sent to it.\n\
2951 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2952 nil, indicating the current buffer's process.\n\
2953 If PROCESS is a network connection, or is a process communicating\n\
2954 through a pipe (as opposed to a pty), then you cannot send any more\n\
2955 text to PROCESS after you call this function.")
2956 (process)
2957 Lisp_Object process;
2959 Lisp_Object proc;
2961 proc = get_process (process);
2963 /* Make sure the process is really alive. */
2964 if (! NILP (XPROCESS (proc)->raw_status_low))
2965 update_status (XPROCESS (proc));
2966 if (! EQ (XPROCESS (proc)->status, Qrun))
2967 error ("Process %s not running", XSTRING (XPROCESS (proc)->name)->data);
2969 #ifdef VMS
2970 send_process (proc, "\032", 1, Qnil); /* ^z */
2971 #else
2972 if (!NILP (XPROCESS (proc)->pty_flag))
2973 send_process (proc, "\004", 1, Qnil);
2974 else
2976 close (XINT (XPROCESS (proc)->outfd));
2977 XSETINT (XPROCESS (proc)->outfd, open (NULL_DEVICE, O_WRONLY));
2979 #endif /* VMS */
2980 return process;
2983 /* Kill all processes associated with `buffer'.
2984 If `buffer' is nil, kill all processes */
2986 kill_buffer_processes (buffer)
2987 Lisp_Object buffer;
2989 Lisp_Object tail, proc;
2991 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCONS (tail)->cdr)
2993 proc = XCONS (XCONS (tail)->car)->cdr;
2994 if (GC_PROCESSP (proc)
2995 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
2997 if (NETCONN_P (proc))
2998 Fdelete_process (proc);
2999 else if (XINT (XPROCESS (proc)->infd) >= 0)
3000 process_send_signal (proc, SIGHUP, Qnil, 1);
3005 /* On receipt of a signal that a child status has changed,
3006 loop asking about children with changed statuses until
3007 the system says there are no more.
3008 All we do is change the status;
3009 we do not run sentinels or print notifications.
3010 That is saved for the next time keyboard input is done,
3011 in order to avoid timing errors. */
3013 /** WARNING: this can be called during garbage collection.
3014 Therefore, it must not be fooled by the presence of mark bits in
3015 Lisp objects. */
3017 /** USG WARNING: Although it is not obvious from the documentation
3018 in signal(2), on a USG system the SIGCLD handler MUST NOT call
3019 signal() before executing at least one wait(), otherwise the handler
3020 will be called again, resulting in an infinite loop. The relevant
3021 portion of the documentation reads "SIGCLD signals will be queued
3022 and the signal-catching function will be continually reentered until
3023 the queue is empty". Invoking signal() causes the kernel to reexamine
3024 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
3026 SIGTYPE
3027 sigchld_handler (signo)
3028 int signo;
3030 int old_errno = errno;
3031 Lisp_Object proc;
3032 register struct Lisp_Process *p;
3033 extern EMACS_TIME *input_available_clear_time;
3035 #ifdef BSD4_1
3036 extern int sigheld;
3037 sigheld |= sigbit (SIGCHLD);
3038 #endif
3040 while (1)
3042 register int pid;
3043 WAITTYPE w;
3044 Lisp_Object tail;
3046 #ifdef WNOHANG
3047 #ifndef WUNTRACED
3048 #define WUNTRACED 0
3049 #endif /* no WUNTRACED */
3050 /* Keep trying to get a status until we get a definitive result. */
3053 errno = 0;
3054 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
3056 while (pid <= 0 && errno == EINTR);
3058 if (pid <= 0)
3060 /* A real failure. We have done all our job, so return. */
3062 /* USG systems forget handlers when they are used;
3063 must reestablish each time */
3064 #ifdef USG
3065 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
3066 #endif
3067 #ifdef BSD4_1
3068 sigheld &= ~sigbit (SIGCHLD);
3069 sigrelse (SIGCHLD);
3070 #endif
3071 errno = old_errno;
3072 return;
3074 #else
3075 pid = wait (&w);
3076 #endif /* no WNOHANG */
3078 /* Find the process that signaled us, and record its status. */
3080 p = 0;
3081 for (tail = Vprocess_alist; XSYMBOL (tail) != XSYMBOL (Qnil); tail = XCONS (tail)->cdr)
3083 proc = XCONS (XCONS (tail)->car)->cdr;
3084 p = XPROCESS (proc);
3085 if (EQ (p->childp, Qt) && XFASTINT (p->pid) == pid)
3086 break;
3087 p = 0;
3090 /* Look for an asynchronous process whose pid hasn't been filled
3091 in yet. */
3092 if (p == 0)
3093 for (tail = Vprocess_alist; XSYMBOL (tail) != XSYMBOL (Qnil); tail = XCONS (tail)->cdr)
3095 proc = XCONS (XCONS (tail)->car)->cdr;
3096 p = XPROCESS (proc);
3097 if (INTEGERP (p->pid) && XINT (p->pid) == -1)
3098 break;
3099 p = 0;
3102 /* Change the status of the process that was found. */
3103 if (p != 0)
3105 union { int i; WAITTYPE wt; } u;
3106 int clear_desc_flag = 0;
3108 XSETINT (p->tick, ++process_tick);
3109 u.wt = w;
3110 XSETFASTINT (p->raw_status_low, u.i & 0xffff);
3111 XSETFASTINT (p->raw_status_high, u.i >> 16);
3113 /* If process has terminated, stop waiting for its output. */
3114 if ((WIFSIGNALED (w) || WIFEXITED (w))
3115 && XINT (p->infd) >= 0)
3116 clear_desc_flag = 1;
3118 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
3119 if (clear_desc_flag)
3121 FD_CLR (XINT (p->infd), &input_wait_mask);
3122 FD_CLR (XINT (p->infd), &non_keyboard_wait_mask);
3125 /* Tell wait_reading_process_input that it needs to wake up and
3126 look around. */
3127 if (input_available_clear_time)
3128 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
3131 /* There was no asynchronous process found for that id. Check
3132 if we have a synchronous process. */
3133 else
3135 synch_process_alive = 0;
3137 /* Report the status of the synchronous process. */
3138 if (WIFEXITED (w))
3139 synch_process_retcode = WRETCODE (w);
3140 else if (WIFSIGNALED (w))
3142 int code = WTERMSIG (w);
3143 char *signame = 0;
3145 if (code < NSIG)
3147 #ifndef VMS
3148 /* Suppress warning if the table has const char *. */
3149 signame = (char *) sys_siglist[code];
3150 #else
3151 signame = sys_errlist[code];
3152 #endif
3154 if (signame == 0)
3155 signame = "unknown";
3157 synch_process_death = signame;
3160 /* Tell wait_reading_process_input that it needs to wake up and
3161 look around. */
3162 if (input_available_clear_time)
3163 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
3166 /* On some systems, we must return right away.
3167 If any more processes want to signal us, we will
3168 get another signal.
3169 Otherwise (on systems that have WNOHANG), loop around
3170 to use up all the processes that have something to tell us. */
3171 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG)) || defined (WINDOWSNT)
3172 #ifdef USG
3173 signal (signo, sigchld_handler);
3174 #endif
3175 errno = old_errno;
3176 return;
3177 #endif /* USG, but not HPUX with WNOHANG */
3182 static Lisp_Object
3183 exec_sentinel_unwind (data)
3184 Lisp_Object data;
3186 XPROCESS (XCONS (data)->car)->sentinel = XCONS (data)->cdr;
3187 return Qnil;
3190 static Lisp_Object
3191 exec_sentinel_error_handler (error)
3192 Lisp_Object error;
3194 cmd_error_internal (error, "error in process sentinel: ");
3195 Vinhibit_quit = Qt;
3196 update_echo_area ();
3197 Fsleep_for (make_number (2));
3200 static void
3201 exec_sentinel (proc, reason)
3202 Lisp_Object proc, reason;
3204 Lisp_Object sentinel, obuffer, odeactivate;
3205 register struct Lisp_Process *p = XPROCESS (proc);
3206 int count = specpdl_ptr - specpdl;
3208 odeactivate = Vdeactivate_mark;
3209 obuffer = Fcurrent_buffer ();
3210 sentinel = p->sentinel;
3211 if (NILP (sentinel))
3212 return;
3214 /* Zilch the sentinel while it's running, to avoid recursive invocations;
3215 assure that it gets restored no matter how the sentinel exits. */
3216 p->sentinel = Qnil;
3217 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
3218 /* Inhibit quit so that random quits don't screw up a running filter. */
3219 specbind (Qinhibit_quit, Qt);
3220 specbind (Qlast_nonmenu_event, Qt);
3222 running_asynch_code = 1;
3223 internal_condition_case_1 (read_process_output_call,
3224 Fcons (sentinel,
3225 Fcons (proc, Fcons (reason, Qnil))),
3226 !NILP (Vdebug_on_error) ? Qnil : Qerror,
3227 exec_sentinel_error_handler);
3228 running_asynch_code = 0;
3229 restore_match_data ();
3231 Vdeactivate_mark = odeactivate;
3232 if (! EQ (Fcurrent_buffer (), obuffer))
3233 record_asynch_buffer_change ();
3235 if (waiting_for_user_input_p)
3236 prepare_menu_bars ();
3237 unbind_to (count, Qnil);
3240 /* Report all recent events of a change in process status
3241 (either run the sentinel or output a message).
3242 This is done while Emacs is waiting for keyboard input. */
3244 status_notify ()
3246 register Lisp_Object proc, buffer;
3247 Lisp_Object tail, msg;
3248 struct gcpro gcpro1, gcpro2;
3250 tail = Qnil;
3251 msg = Qnil;
3252 /* We need to gcpro tail; if read_process_output calls a filter
3253 which deletes a process and removes the cons to which tail points
3254 from Vprocess_alist, and then causes a GC, tail is an unprotected
3255 reference. */
3256 GCPRO2 (tail, msg);
3258 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
3260 Lisp_Object symbol;
3261 register struct Lisp_Process *p;
3263 proc = Fcdr (Fcar (tail));
3264 p = XPROCESS (proc);
3266 if (XINT (p->tick) != XINT (p->update_tick))
3268 XSETINT (p->update_tick, XINT (p->tick));
3270 /* If process is still active, read any output that remains. */
3271 if (XINT (p->infd) >= 0)
3272 while (! EQ (p->filter, Qt)
3273 && read_process_output (proc, XINT (p->infd)) > 0);
3275 buffer = p->buffer;
3277 /* Get the text to use for the message. */
3278 if (!NILP (p->raw_status_low))
3279 update_status (p);
3280 msg = status_message (p->status);
3282 /* If process is terminated, deactivate it or delete it. */
3283 symbol = p->status;
3284 if (CONSP (p->status))
3285 symbol = XCONS (p->status)->car;
3287 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
3288 || EQ (symbol, Qclosed))
3290 if (delete_exited_processes)
3291 remove_process (proc);
3292 else
3293 deactivate_process (proc);
3296 /* Now output the message suitably. */
3297 if (!NILP (p->sentinel))
3298 exec_sentinel (proc, msg);
3299 /* Don't bother with a message in the buffer
3300 when a process becomes runnable. */
3301 else if (!EQ (symbol, Qrun) && !NILP (buffer))
3303 Lisp_Object ro, tem;
3304 struct buffer *old = current_buffer;
3305 int opoint;
3307 ro = XBUFFER (buffer)->read_only;
3309 /* Avoid error if buffer is deleted
3310 (probably that's why the process is dead, too) */
3311 if (NILP (XBUFFER (buffer)->name))
3312 continue;
3313 Fset_buffer (buffer);
3314 opoint = point;
3315 /* Insert new output into buffer
3316 at the current end-of-output marker,
3317 thus preserving logical ordering of input and output. */
3318 if (XMARKER (p->mark)->buffer)
3319 SET_PT (marker_position (p->mark));
3320 else
3321 SET_PT (ZV);
3322 if (point <= opoint)
3323 opoint += XSTRING (msg)->size + XSTRING (p->name)->size + 10;
3325 tem = current_buffer->read_only;
3326 current_buffer->read_only = Qnil;
3327 insert_string ("\nProcess ");
3328 Finsert (1, &p->name);
3329 insert_string (" ");
3330 Finsert (1, &msg);
3331 current_buffer->read_only = tem;
3332 Fset_marker (p->mark, make_number (point), p->buffer);
3334 SET_PT (opoint);
3335 set_buffer_internal (old);
3338 } /* end for */
3340 update_mode_lines++; /* in case buffers use %s in mode-line-format */
3341 redisplay_preserve_echo_area ();
3343 update_tick = process_tick;
3345 UNGCPRO;
3348 /* The first time this is called, assume keyboard input comes from DESC
3349 instead of from where we used to expect it.
3350 Subsequent calls mean assume input keyboard can come from DESC
3351 in addition to other places. */
3353 static int add_keyboard_wait_descriptor_called_flag;
3355 void
3356 add_keyboard_wait_descriptor (desc)
3357 int desc;
3359 if (! add_keyboard_wait_descriptor_called_flag)
3360 FD_CLR (0, &input_wait_mask);
3361 add_keyboard_wait_descriptor_called_flag = 1;
3362 FD_SET (desc, &input_wait_mask);
3363 if (desc > max_keyboard_desc)
3364 max_keyboard_desc = desc;
3367 /* From now on, do not expect DESC to give keyboard input. */
3369 void
3370 delete_keyboard_wait_descriptor (desc)
3371 int desc;
3373 int fd;
3374 int lim = max_keyboard_desc;
3376 FD_CLR (desc, &input_wait_mask);
3378 if (desc == max_keyboard_desc)
3379 for (fd = 0; fd < lim; fd++)
3380 if (FD_ISSET (fd, &input_wait_mask)
3381 && !FD_ISSET (fd, &non_keyboard_wait_mask))
3382 max_keyboard_desc = fd;
3385 /* Return nonzero if *MASK has a bit set
3386 that corresponds to one of the keyboard input descriptors. */
3389 keyboard_bit_set (mask)
3390 SELECT_TYPE *mask;
3392 int fd;
3394 for (fd = 0; fd < max_keyboard_desc; fd++)
3395 if (FD_ISSET (fd, mask) && FD_ISSET (fd, &input_wait_mask)
3396 && !FD_ISSET (fd, &non_keyboard_wait_mask))
3397 return 1;
3399 return 0;
3402 init_process ()
3404 register int i;
3406 #ifdef SIGCHLD
3407 #ifndef CANNOT_DUMP
3408 if (! noninteractive || initialized)
3409 #endif
3410 signal (SIGCHLD, sigchld_handler);
3411 #endif
3413 FD_ZERO (&input_wait_mask);
3414 FD_ZERO (&non_keyboard_wait_mask);
3415 max_process_desc = 0;
3417 FD_SET (0, &input_wait_mask);
3419 Vprocess_alist = Qnil;
3420 for (i = 0; i < MAXDESC; i++)
3422 chan_process[i] = Qnil;
3423 proc_buffered_char[i] = -1;
3427 syms_of_process ()
3429 #ifdef HAVE_SOCKETS
3430 stream_process = intern ("stream");
3431 #endif
3432 Qprocessp = intern ("processp");
3433 staticpro (&Qprocessp);
3434 Qrun = intern ("run");
3435 staticpro (&Qrun);
3436 Qstop = intern ("stop");
3437 staticpro (&Qstop);
3438 Qsignal = intern ("signal");
3439 staticpro (&Qsignal);
3441 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3442 here again.
3444 Qexit = intern ("exit");
3445 staticpro (&Qexit); */
3447 Qopen = intern ("open");
3448 staticpro (&Qopen);
3449 Qclosed = intern ("closed");
3450 staticpro (&Qclosed);
3452 Qlast_nonmenu_event = intern ("last-nonmenu-event");
3453 staticpro (&Qlast_nonmenu_event);
3455 staticpro (&Vprocess_alist);
3457 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
3458 "*Non-nil means delete processes immediately when they exit.\n\
3459 nil means don't delete them until `list-processes' is run.");
3461 delete_exited_processes = 1;
3463 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
3464 "Control type of device used to communicate with subprocesses.\n\
3465 Values are nil to use a pipe, or t or `pty' to use a pty.\n\
3466 The value has no effect if the system has no ptys or if all ptys are busy:\n\
3467 then a pipe is used in any case.\n\
3468 The value takes effect when `start-process' is called.");
3469 Vprocess_connection_type = Qt;
3471 defsubr (&Sprocessp);
3472 defsubr (&Sget_process);
3473 defsubr (&Sget_buffer_process);
3474 defsubr (&Sdelete_process);
3475 defsubr (&Sprocess_status);
3476 defsubr (&Sprocess_exit_status);
3477 defsubr (&Sprocess_id);
3478 defsubr (&Sprocess_name);
3479 defsubr (&Sprocess_tty_name);
3480 defsubr (&Sprocess_command);
3481 defsubr (&Sset_process_buffer);
3482 defsubr (&Sprocess_buffer);
3483 defsubr (&Sprocess_mark);
3484 defsubr (&Sset_process_filter);
3485 defsubr (&Sprocess_filter);
3486 defsubr (&Sset_process_sentinel);
3487 defsubr (&Sset_process_window_size);
3488 defsubr (&Sprocess_sentinel);
3489 defsubr (&Sprocess_kill_without_query);
3490 defsubr (&Slist_processes);
3491 defsubr (&Sprocess_list);
3492 defsubr (&Sstart_process);
3493 #ifdef HAVE_SOCKETS
3494 defsubr (&Sopen_network_stream);
3495 #endif /* HAVE_SOCKETS */
3496 defsubr (&Saccept_process_output);
3497 defsubr (&Sprocess_send_region);
3498 defsubr (&Sprocess_send_string);
3499 defsubr (&Sinterrupt_process);
3500 defsubr (&Skill_process);
3501 defsubr (&Squit_process);
3502 defsubr (&Sstop_process);
3503 defsubr (&Scontinue_process);
3504 defsubr (&Sprocess_send_eof);
3505 defsubr (&Ssignal_process);
3506 defsubr (&Swaiting_for_user_input_p);
3507 /* defsubr (&Sprocess_connection); */
3511 #else /* not subprocesses */
3513 #include <sys/types.h>
3514 #include <errno.h>
3516 #include "lisp.h"
3517 #include "systime.h"
3518 #include "termopts.h"
3520 extern int frame_garbaged;
3523 /* As described above, except assuming that there are no subprocesses:
3525 Wait for timeout to elapse and/or keyboard input to be available.
3527 time_limit is:
3528 timeout in seconds, or
3529 zero for no limit, or
3530 -1 means gobble data immediately available but don't wait for any.
3532 read_kbd is a Lisp_Object:
3533 0 to ignore keyboard input, or
3534 1 to return when input is available, or
3535 -1 means caller will actually read the input, so don't throw to
3536 the quit handler.
3537 We know that read_kbd will never be a Lisp_Process, since
3538 `subprocesses' isn't defined.
3540 do_display != 0 means redisplay should be done to show subprocess
3541 output that arrives.
3543 Return true iff we received input from any process. */
3546 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
3547 int time_limit, microsecs;
3548 Lisp_Object read_kbd;
3549 int do_display;
3551 EMACS_TIME end_time, timeout, *timeout_p;
3552 int waitchannels;
3554 /* What does time_limit really mean? */
3555 if (time_limit || microsecs)
3557 /* It's not infinite. */
3558 timeout_p = &timeout;
3560 if (time_limit == -1)
3561 /* In fact, it's zero. */
3562 EMACS_SET_SECS_USECS (timeout, 0, 0);
3563 else
3564 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
3566 /* How far in the future is that? */
3567 EMACS_GET_TIME (end_time);
3568 EMACS_ADD_TIME (end_time, end_time, timeout);
3570 else
3571 /* It's infinite. */
3572 timeout_p = 0;
3574 /* This must come before stop_polling. */
3575 prepare_menu_bars ();
3577 /* Turn off periodic alarms (in case they are in use)
3578 because the select emulator uses alarms. */
3579 stop_polling ();
3581 for (;;)
3583 int nfds;
3585 waitchannels = XINT (read_kbd) ? 1 : 0;
3587 /* If calling from keyboard input, do not quit
3588 since we want to return C-g as an input character.
3589 Otherwise, do pending quit if requested. */
3590 if (XINT (read_kbd) >= 0)
3591 QUIT;
3593 if (timeout_p)
3595 EMACS_GET_TIME (*timeout_p);
3596 EMACS_SUB_TIME (*timeout_p, end_time, *timeout_p);
3597 if (EMACS_TIME_NEG_P (*timeout_p))
3598 break;
3601 /* Cause C-g and alarm signals to take immediate action,
3602 and cause input available signals to zero out timeout. */
3603 if (XINT (read_kbd) < 0)
3604 set_waiting_for_input (&timeout);
3606 /* If a frame has been newly mapped and needs updating,
3607 reprocess its display stuff. */
3608 if (frame_garbaged && do_display)
3609 redisplay_preserve_echo_area ();
3611 if (XINT (read_kbd) && detect_input_pending ())
3612 nfds = 0;
3613 else
3614 nfds = select (1, &waitchannels, 0, 0, timeout_p);
3616 /* Make C-g and alarm signals set flags again */
3617 clear_waiting_for_input ();
3619 /* If we woke up due to SIGWINCH, actually change size now. */
3620 do_pending_window_change ();
3622 if (nfds == -1)
3624 /* If the system call was interrupted, then go around the
3625 loop again. */
3626 if (errno == EINTR)
3627 waitchannels = 0;
3629 #ifdef sun
3630 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
3631 /* System sometimes fails to deliver SIGIO. */
3632 kill (getpid (), SIGIO);
3633 #endif
3634 #ifdef SIGIO
3635 if (XINT (read_kbd) && interrupt_input && (waitchannels & 1))
3636 kill (0, SIGIO);
3637 #endif
3639 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3640 we should exit. */
3641 if (nfds >= 0)
3642 break;
3645 start_polling ();
3647 return 0;
3651 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
3652 /* Don't confuse make-docfile by having two doc strings for this function.
3653 make-docfile does not pay attention to #if, for good reason! */
3655 (name)
3656 register Lisp_Object name;
3658 return Qnil;
3661 /* Kill all processes associated with `buffer'.
3662 If `buffer' is nil, kill all processes.
3663 Since we have no subprocesses, this does nothing. */
3665 kill_buffer_processes (buffer)
3666 Lisp_Object buffer;
3670 init_process ()
3674 syms_of_process ()
3676 defsubr (&Sget_buffer_process);
3680 #endif /* not subprocesses */