Doc fix.
[bpt/emacs.git] / src / process.c
CommitLineData
d0d6b7c5 1/* Asynchronous subprocess control for GNU Emacs.
1dc77cc3 2 Copyright (C) 1985, 1986, 1987, 1988, 1992, 1993 Free Software Foundation, Inc.
d0d6b7c5
JB
3
4This file is part of GNU Emacs.
5
6GNU Emacs is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
1dc77cc3 8the Free Software Foundation; either version 2, or (at your option)
d0d6b7c5
JB
9any later version.
10
11GNU Emacs is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with GNU Emacs; see the file COPYING. If not, write to
18the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
19
20
21#include <signal.h>
22
23#include "config.h"
24
6720a7fb
JB
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. */
31
32\f
d0d6b7c5 33#ifdef subprocesses
d0d6b7c5
JB
34
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
42#ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
43#include <sys/socket.h>
44#include <netdb.h>
45#include <netinet/in.h>
46#include <arpa/inet.h>
47#endif /* HAVE_SOCKETS */
48
49#if defined(BSD) || defined(STRIDE)
50#include <sys/ioctl.h>
0ad77c54 51#if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
d0d6b7c5
JB
52#include <fcntl.h>
53#endif /* HAVE_PTYS and no O_NDELAY */
54#endif /* BSD or STRIDE */
d0d6b7c5
JB
55
56#ifdef NEED_BSDTTY
57#include <bsdtty.h>
58#endif
59
d0d6b7c5
JB
60#ifdef IRIS
61#include <sys/sysmacros.h> /* for "minor" */
62#endif /* not IRIS */
63
64#include "systime.h"
36ebaafa 65#include "systty.h"
d0d6b7c5
JB
66
67#include "lisp.h"
68#include "window.h"
69#include "buffer.h"
70#include "process.h"
71#include "termhooks.h"
72#include "termopts.h"
73#include "commands.h"
1dc77cc3 74#include "frame.h"
d0d6b7c5
JB
75
76Lisp_Object Qrun, Qstop, Qsignal, Qopen, Qclosed;
77/* Qexit is declared and initialized in eval.c. */
78
79/* a process object is a network connection when its childp field is neither
80 Qt nor Qnil but is instead a string (name of foreign host we
81 are connected to + name of port we are connected to) */
82
83#ifdef HAVE_SOCKETS
84static Lisp_Object stream_process;
85
86#define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
87#else
88#define NETCONN_P(p) 0
89#endif /* HAVE_SOCKETS */
90
91/* Define first descriptor number available for subprocesses. */
92#ifdef VMS
93#define FIRST_PROC_DESC 1
94#else /* Not VMS */
95#define FIRST_PROC_DESC 3
96#endif
97
98/* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
99 testing SIGCHLD. */
100
101#if !defined (SIGCHLD) && defined (SIGCLD)
102#define SIGCHLD SIGCLD
103#endif /* SIGCLD */
104
105#include "syssignal.h"
106
107/* Define the structure that the wait system call stores.
108 On many systems, there is a structure defined for this.
109 But on vanilla-ish USG systems there is not. */
110
111#ifndef VMS
112#ifndef WAITTYPE
113#if !defined (BSD) && !defined (UNIPLUS) && !defined (STRIDE) && !(defined (HPUX) && !defined (NOMULTIPLEJOBS)) && !defined (HAVE_WAIT_HEADER)
d0d6b7c5
JB
114#define WAITTYPE int
115#define WIFSTOPPED(w) ((w&0377) == 0177)
116#define WIFSIGNALED(w) ((w&0377) != 0177 && (w&~0377) == 0)
117#define WIFEXITED(w) ((w&0377) == 0)
118#define WRETCODE(w) (w >> 8)
119#define WSTOPSIG(w) (w >> 8)
d0d6b7c5 120#define WTERMSIG(w) (w & 0377)
ce4c9c90
RS
121#ifndef WCOREDUMP
122#define WCOREDUMP(w) ((w&0200) != 0)
123#endif
d0d6b7c5
JB
124#else
125#ifdef BSD4_1
126#include <wait.h>
127#else
128#include <sys/wait.h>
129#endif /* not BSD 4.1 */
130
131#define WAITTYPE union wait
132#define WRETCODE(w) w.w_retcode
133#define WCOREDUMP(w) w.w_coredump
134
135#ifdef HPUX
136/* HPUX version 7 has broken definitions of these. */
137#undef WTERMSIG
138#undef WSTOPSIG
139#undef WIFSTOPPED
140#undef WIFSIGNALED
141#undef WIFEXITED
142#endif
143
144#ifndef WTERMSIG
145#define WTERMSIG(w) w.w_termsig
146#endif
147#ifndef WSTOPSIG
148#define WSTOPSIG(w) w.w_stopsig
149#endif
150#ifndef WIFSTOPPED
151#define WIFSTOPPED(w) (WTERMSIG (w) == 0177)
152#endif
153#ifndef WIFSIGNALED
154#define WIFSIGNALED(w) (WTERMSIG (w) != 0177 && (WSTOPSIG (w)) == 0)
155#endif
156#ifndef WIFEXITED
157#define WIFEXITED(w) (WTERMSIG (w) == 0)
158#endif
159#endif /* BSD or UNIPLUS or STRIDE */
160#endif /* no WAITTYPE */
161#else /* VMS */
b0310da4 162#define WAITTYPE int
c6c6865d
JB
163#define WIFSTOPPED(w) 0
164#define WIFSIGNALED(w) 0
165#define WIFEXITED(w) ((w) != -1)
166#define WRETCODE(w) (w)
167#define WSTOPSIG(w) (w)
168#define WCOREDUMP(w) 0
169#define WTERMSIG(w) (w)
d0d6b7c5
JB
170#include <ssdef.h>
171#include <iodef.h>
172#include <clidef.h>
173#include "vmsproc.h"
174#endif /* VMS */
175
176extern errno;
177extern sys_nerr;
178extern char *sys_errlist[];
179
180#ifndef VMS
181#ifndef BSD4_1
182extern char *sys_siglist[];
183#else
184char *sys_siglist[] =
185 {
186 "bum signal!!",
187 "hangup",
188 "interrupt",
189 "quit",
190 "illegal instruction",
191 "trace trap",
192 "iot instruction",
193 "emt instruction",
194 "floating point exception",
195 "kill",
196 "bus error",
197 "segmentation violation",
198 "bad argument to system call",
199 "write on a pipe with no one to read it",
200 "alarm clock",
201 "software termination signal from kill",
202 "status signal",
203 "sendable stop signal not from tty",
204 "stop signal from tty",
205 "continue a stopped process",
206 "child status has changed",
207 "background read attempted from control tty",
208 "background write attempted from control tty",
209 "input record available at control tty",
210 "exceeded CPU time limit",
211 "exceeded file size limit"
212 };
213#endif
214#endif /* VMS */
215
d0d6b7c5
JB
216/* t means use pty, nil means use a pipe,
217 maybe other values to come. */
218Lisp_Object Vprocess_connection_type;
219
220#ifdef SKTPAIR
221#ifndef HAVE_SOCKETS
222#include <sys/socket.h>
223#endif
224#endif /* SKTPAIR */
225
226/* Number of events of change of status of a process. */
227int process_tick;
228
229/* Number of events for which the user or sentinel has been notified. */
230int update_tick;
231
232#ifdef FD_SET
233/* We could get this from param.h, but better not to depend on finding that.
234 And better not to risk that it might define other symbols used in this
235 file. */
236#define MAXDESC 64
237#define SELECT_TYPE fd_set
238#else /* no FD_SET */
239#define MAXDESC 32
240#define SELECT_TYPE int
241
242/* Define the macros to access a single-int bitmap of descriptors. */
243#define FD_SET(n, p) (*(p) |= (1 << (n)))
244#define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
245#define FD_ISSET(n, p) (*(p) & (1 << (n)))
246#define FD_ZERO(p) (*(p) = 0)
247#endif /* no FD_SET */
248
249/* Mask of bits indicating the descriptors that we wait for input on */
250
251SELECT_TYPE input_wait_mask;
252
253int delete_exited_processes;
254
255/* Indexed by descriptor, gives the process (if any) for that descriptor */
256Lisp_Object chan_process[MAXDESC];
257
258/* Alist of elements (NAME . PROCESS) */
259Lisp_Object Vprocess_alist;
260
261Lisp_Object Qprocessp;
262
263Lisp_Object get_process ();
264
265/* Buffered-ahead input char from process, indexed by channel.
266 -1 means empty (no char is buffered).
267 Used on sys V where the only way to tell if there is any
268 output from the process is to read at least one char.
269 Always -1 on systems that support FIONREAD. */
270
271int proc_buffered_char[MAXDESC];
272\f
273/* Compute the Lisp form of the process status, p->status, from
274 the numeric status that was returned by `wait'. */
275
f9738840
JB
276Lisp_Object status_convert ();
277
d0d6b7c5
JB
278update_status (p)
279 struct Lisp_Process *p;
280{
281 union { int i; WAITTYPE wt; } u;
282 u.i = XFASTINT (p->raw_status_low) + (XFASTINT (p->raw_status_high) << 16);
283 p->status = status_convert (u.wt);
284 p->raw_status_low = Qnil;
285 p->raw_status_high = Qnil;
286}
287
288/* Convert a process status work in Unix format to
289 the list that we use internally. */
290
291Lisp_Object
292status_convert (w)
293 WAITTYPE w;
294{
295 if (WIFSTOPPED (w))
296 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
297 else if (WIFEXITED (w))
298 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
299 WCOREDUMP (w) ? Qt : Qnil));
300 else if (WIFSIGNALED (w))
301 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
302 WCOREDUMP (w) ? Qt : Qnil));
303 else
304 return Qrun;
305}
306
307/* Given a status-list, extract the three pieces of information
308 and store them individually through the three pointers. */
309
310void
311decode_status (l, symbol, code, coredump)
312 Lisp_Object l;
313 Lisp_Object *symbol;
314 int *code;
315 int *coredump;
316{
317 Lisp_Object tem;
318
319 if (XTYPE (l) == Lisp_Symbol)
320 {
321 *symbol = l;
322 *code = 0;
323 *coredump = 0;
324 }
325 else
326 {
327 *symbol = XCONS (l)->car;
328 tem = XCONS (l)->cdr;
329 *code = XFASTINT (XCONS (tem)->car);
f9738840 330 tem = XCONS (tem)->cdr;
d0d6b7c5
JB
331 *coredump = !NILP (tem);
332 }
333}
334
335/* Return a string describing a process status list. */
336
337Lisp_Object
338status_message (status)
339 Lisp_Object status;
340{
341 Lisp_Object symbol;
342 int code, coredump;
343 Lisp_Object string, string2;
344
345 decode_status (status, &symbol, &code, &coredump);
346
347 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
348 {
b0310da4 349#ifndef VMS
d0d6b7c5 350 string = build_string (code < NSIG ? sys_siglist[code] : "unknown");
b0310da4
JB
351#else
352 string = build_string (code < NSIG ? sys_errlist[code] : "unknown");
353#endif
d0d6b7c5
JB
354 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
355 XSTRING (string)->data[0] = DOWNCASE (XSTRING (string)->data[0]);
356 return concat2 (string, string2);
357 }
358 else if (EQ (symbol, Qexit))
359 {
360 if (code == 0)
361 return build_string ("finished\n");
f2980264 362 string = Fnumber_to_string (make_number (code));
d0d6b7c5
JB
363 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
364 return concat2 (build_string ("exited abnormally with code "),
365 concat2 (string, string2));
366 }
367 else
368 return Fcopy_sequence (Fsymbol_name (symbol));
369}
370\f
371#ifdef HAVE_PTYS
d0d6b7c5
JB
372
373/* Open an available pty, returning a file descriptor.
374 Return -1 on failure.
375 The file name of the terminal corresponding to the pty
376 is left in the variable pty_name. */
377
378char pty_name[24];
379
380int
381allocate_pty ()
382{
383 struct stat stb;
384 register c, i;
385 int fd;
386
32676c08
JB
387 /* Some systems name their pseudoterminals so that there are gaps in
388 the usual sequence - for example, on HP9000/S700 systems, there
389 are no pseudoterminals with names ending in 'f'. So we wait for
390 three failures in a row before deciding that we've reached the
391 end of the ptys. */
392 int failed_count = 0;
393
d0d6b7c5
JB
394#ifdef PTY_ITERATION
395 PTY_ITERATION
396#else
397 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
398 for (i = 0; i < 16; i++)
399#endif
400 {
401#ifdef PTY_NAME_SPRINTF
402 PTY_NAME_SPRINTF
d0d6b7c5
JB
403#else
404 sprintf (pty_name, "/dev/pty%c%x", c, i);
d0d6b7c5
JB
405#endif /* no PTY_NAME_SPRINTF */
406
4d7c105e
RS
407#ifdef PTY_OPEN
408 PTY_OPEN;
409#else /* no PTY_OPEN */
32676c08
JB
410#ifdef IRIS
411 /* Unusual IRIS code */
412 *ptyv = open ("/dev/ptc", O_RDWR | O_NDELAY, 0);
413 if (fd < 0)
414 return -1;
415 if (fstat (fd, &stb) < 0)
d0d6b7c5 416 return -1;
4d7c105e 417#else /* not IRIS */
32676c08
JB
418 if (stat (pty_name, &stb) < 0)
419 {
420 failed_count++;
421 if (failed_count >= 3)
422 return -1;
423 }
424 else
425 failed_count = 0;
d0d6b7c5
JB
426#ifdef O_NONBLOCK
427 fd = open (pty_name, O_RDWR | O_NONBLOCK, 0);
428#else
429 fd = open (pty_name, O_RDWR | O_NDELAY, 0);
430#endif
4d7c105e
RS
431#endif /* not IRIS */
432#endif /* no PTY_OPEN */
d0d6b7c5
JB
433
434 if (fd >= 0)
435 {
436 /* check to make certain that both sides are available
437 this avoids a nasty yet stupid bug in rlogins */
438#ifdef PTY_TTY_NAME_SPRINTF
439 PTY_TTY_NAME_SPRINTF
d0d6b7c5
JB
440#else
441 sprintf (pty_name, "/dev/tty%c%x", c, i);
d0d6b7c5
JB
442#endif /* no PTY_TTY_NAME_SPRINTF */
443#ifndef UNIPLUS
444 if (access (pty_name, 6) != 0)
445 {
446 close (fd);
447#ifndef IRIS
448 continue;
449#else
450 return -1;
451#endif /* IRIS */
452 }
453#endif /* not UNIPLUS */
454 setup_pty (fd);
455 return fd;
456 }
457 }
458 return -1;
459}
460#endif /* HAVE_PTYS */
461\f
462Lisp_Object
463make_process (name)
464 Lisp_Object name;
465{
466 register Lisp_Object val, tem, name1;
467 register struct Lisp_Process *p;
468 char suffix[10];
469 register int i;
470
471 /* size of process structure includes the vector header,
472 so deduct for that. But struct Lisp_Vector includes the first
473 element, thus deducts too much, so add it back. */
474 val = Fmake_vector (make_number ((sizeof (struct Lisp_Process)
475 - sizeof (struct Lisp_Vector)
476 + sizeof (Lisp_Object))
477 / sizeof (Lisp_Object)),
478 Qnil);
479 XSETTYPE (val, Lisp_Process);
480
481 p = XPROCESS (val);
482 XFASTINT (p->infd) = 0;
483 XFASTINT (p->outfd) = 0;
484 XFASTINT (p->pid) = 0;
485 XFASTINT (p->tick) = 0;
486 XFASTINT (p->update_tick) = 0;
487 p->raw_status_low = Qnil;
488 p->raw_status_high = Qnil;
489 p->status = Qrun;
490 p->mark = Fmake_marker ();
491
492 /* If name is already in use, modify it until it is unused. */
493
494 name1 = name;
495 for (i = 1; ; i++)
496 {
497 tem = Fget_process (name1);
498 if (NILP (tem)) break;
499 sprintf (suffix, "<%d>", i);
500 name1 = concat2 (name, build_string (suffix));
501 }
502 name = name1;
503 p->name = name;
504 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
505 return val;
506}
507
508remove_process (proc)
509 register Lisp_Object proc;
510{
511 register Lisp_Object pair;
512
513 pair = Frassq (proc, Vprocess_alist);
514 Vprocess_alist = Fdelq (pair, Vprocess_alist);
515 Fset_marker (XPROCESS (proc)->mark, Qnil, Qnil);
516
517 deactivate_process (proc);
518}
519\f
520DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
521 "Return t if OBJECT is a process.")
522 (obj)
523 Lisp_Object obj;
524{
525 return XTYPE (obj) == Lisp_Process ? Qt : Qnil;
526}
527
528DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
529 "Return the process named NAME, or nil if there is none.")
530 (name)
531 register Lisp_Object name;
532{
533 if (XTYPE (name) == Lisp_Process)
534 return name;
535 CHECK_STRING (name, 0);
536 return Fcdr (Fassoc (name, Vprocess_alist));
537}
538
539DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
540 "Return the (or, a) process associated with BUFFER.\n\
541BUFFER may be a buffer or the name of one.")
542 (name)
543 register Lisp_Object name;
544{
545 register Lisp_Object buf, tail, proc;
546
547 if (NILP (name)) return Qnil;
548 buf = Fget_buffer (name);
549 if (NILP (buf)) return Qnil;
550
551 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
552 {
553 proc = Fcdr (Fcar (tail));
554 if (XTYPE (proc) == Lisp_Process && EQ (XPROCESS (proc)->buffer, buf))
555 return proc;
556 }
557 return Qnil;
558}
559
ebb9e16f
JB
560/* This is how commands for the user decode process arguments. It
561 accepts a process, a process name, a buffer, a buffer name, or nil.
562 Buffers denote the first process in the buffer, and nil denotes the
563 current buffer. */
d0d6b7c5
JB
564
565Lisp_Object
566get_process (name)
567 register Lisp_Object name;
568{
569 register Lisp_Object proc;
570 if (NILP (name))
571 proc = Fget_buffer_process (Fcurrent_buffer ());
572 else
573 {
574 proc = Fget_process (name);
575 if (NILP (proc))
576 proc = Fget_buffer_process (Fget_buffer (name));
577 }
578
579 if (!NILP (proc))
580 return proc;
581
582 if (NILP (name))
583 error ("Current buffer has no process");
584 else
585 error ("Process %s does not exist", XSTRING (name)->data);
586 /* NOTREACHED */
587}
588
589DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
590 "Delete PROCESS: kill it and forget about it immediately.\n\
ebb9e16f
JB
591PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
592nil, indicating the current buffer's process.")
d0d6b7c5
JB
593 (proc)
594 register Lisp_Object proc;
595{
596 proc = get_process (proc);
597 XPROCESS (proc)->raw_status_low = Qnil;
598 XPROCESS (proc)->raw_status_high = Qnil;
599 if (NETCONN_P (proc))
600 {
601 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
602 XSETINT (XPROCESS (proc)->tick, ++process_tick);
603 }
604 else if (XFASTINT (XPROCESS (proc)->infd))
605 {
606 Fkill_process (proc, Qnil);
607 /* Do this now, since remove_process will make sigchld_handler do nothing. */
608 XPROCESS (proc)->status
609 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
610 XSETINT (XPROCESS (proc)->tick, ++process_tick);
611 status_notify ();
612 }
613 remove_process (proc);
614 return Qnil;
615}
616\f
617DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
618 "Return the status of PROCESS: a symbol, one of these:\n\
619run -- for a process that is running.\n\
620stop -- for a process stopped but continuable.\n\
621exit -- for a process that has exited.\n\
622signal -- for a process that has got a fatal signal.\n\
623open -- for a network stream connection that is open.\n\
624closed -- for a network stream connection that is closed.\n\
ebb9e16f
JB
625nil -- if arg is a process name and no such process exists.\n\
626PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
627nil, indicating the current buffer's process.")
d0d6b7c5
JB
628/* command -- for a command channel opened to Emacs by another process.\n\
629 external -- for an i/o channel opened to Emacs by another process.\n\ */
630 (proc)
631 register Lisp_Object proc;
632{
633 register struct Lisp_Process *p;
634 register Lisp_Object status;
ebb9e16f 635 proc = get_process (proc);
d0d6b7c5
JB
636 if (NILP (proc))
637 return proc;
638 p = XPROCESS (proc);
639 if (!NILP (p->raw_status_low))
640 update_status (p);
641 status = p->status;
642 if (XTYPE (status) == Lisp_Cons)
643 status = XCONS (status)->car;
644 if (NETCONN_P (proc))
645 {
646 if (EQ (status, Qrun))
647 status = Qopen;
648 else if (EQ (status, Qexit))
649 status = Qclosed;
650 }
651 return status;
652}
653
654DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
655 1, 1, 0,
656 "Return the exit status of PROCESS or the signal number that killed it.\n\
657If PROCESS has not yet exited or died, return 0.")
658 (proc)
659 register Lisp_Object proc;
660{
661 CHECK_PROCESS (proc, 0);
662 if (!NILP (XPROCESS (proc)->raw_status_low))
663 update_status (XPROCESS (proc));
664 if (XTYPE (XPROCESS (proc)->status) == Lisp_Cons)
665 return XCONS (XCONS (XPROCESS (proc)->status)->cdr)->car;
666 return make_number (0);
667}
668
669DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
670 "Return the process id of PROCESS.\n\
671This is the pid of the Unix process which PROCESS uses or talks to.\n\
672For a network connection, this value is nil.")
673 (proc)
674 register Lisp_Object proc;
675{
676 CHECK_PROCESS (proc, 0);
677 return XPROCESS (proc)->pid;
678}
679
680DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
681 "Return the name of PROCESS, as a string.\n\
682This is the name of the program invoked in PROCESS,\n\
683possibly modified to make it unique among process names.")
684 (proc)
685 register Lisp_Object proc;
686{
687 CHECK_PROCESS (proc, 0);
688 return XPROCESS (proc)->name;
689}
690
691DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
692 "Return the command that was executed to start PROCESS.\n\
693This is a list of strings, the first string being the program executed\n\
694and the rest of the strings being the arguments given to it.\n\
695For a non-child channel, this is nil.")
696 (proc)
697 register Lisp_Object proc;
698{
699 CHECK_PROCESS (proc, 0);
700 return XPROCESS (proc)->command;
701}
702
703DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
704 2, 2, 0,
705 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
706 (proc, buffer)
707 register Lisp_Object proc, buffer;
708{
709 CHECK_PROCESS (proc, 0);
710 if (!NILP (buffer))
711 CHECK_BUFFER (buffer, 1);
712 XPROCESS (proc)->buffer = buffer;
713 return buffer;
714}
715
716DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
717 1, 1, 0,
718 "Return the buffer PROCESS is associated with.\n\
719Output from PROCESS is inserted in this buffer\n\
720unless PROCESS has a filter.")
721 (proc)
722 register Lisp_Object proc;
723{
724 CHECK_PROCESS (proc, 0);
725 return XPROCESS (proc)->buffer;
726}
727
728DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
729 1, 1, 0,
730 "Return the marker for the end of the last output from PROCESS.")
731 (proc)
732 register Lisp_Object proc;
733{
734 CHECK_PROCESS (proc, 0);
735 return XPROCESS (proc)->mark;
736}
737
738DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
739 2, 2, 0,
740 "Give PROCESS the filter function FILTER; nil means no filter.\n\
741When a process has a filter, each time it does output\n\
742the entire string of output is passed to the filter.\n\
743The filter gets two arguments: the process and the string of output.\n\
744If the process has a filter, its buffer is not used for output.")
745 (proc, filter)
746 register Lisp_Object proc, filter;
747{
748 CHECK_PROCESS (proc, 0);
749 XPROCESS (proc)->filter = filter;
750 return filter;
751}
752
753DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
754 1, 1, 0,
755 "Returns the filter function of PROCESS; nil if none.\n\
756See `set-process-filter' for more info on filter functions.")
757 (proc)
758 register Lisp_Object proc;
759{
760 CHECK_PROCESS (proc, 0);
761 return XPROCESS (proc)->filter;
762}
763
764DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
765 2, 2, 0,
766 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
767The sentinel is called as a function when the process changes state.\n\
768It gets two arguments: the process, and a string describing the change.")
769 (proc, sentinel)
770 register Lisp_Object proc, sentinel;
771{
772 CHECK_PROCESS (proc, 0);
773 XPROCESS (proc)->sentinel = sentinel;
774 return sentinel;
775}
776
777DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
778 1, 1, 0,
779 "Return the sentinel of PROCESS; nil if none.\n\
780See `set-process-sentinel' for more info on sentinels.")
781 (proc)
782 register Lisp_Object proc;
783{
784 CHECK_PROCESS (proc, 0);
785 return XPROCESS (proc)->sentinel;
786}
787
788DEFUN ("process-kill-without-query", Fprocess_kill_without_query,
789 Sprocess_kill_without_query, 1, 2, 0,
790 "Say no query needed if PROCESS is running when Emacs is exited.\n\
791Optional second argument if non-nill says to require a query.\n\
792Value is t if a query was formerly required.")
793 (proc, value)
794 register Lisp_Object proc, value;
795{
796 Lisp_Object tem;
797
798 CHECK_PROCESS (proc, 0);
799 tem = XPROCESS (proc)->kill_without_query;
800 XPROCESS (proc)->kill_without_query = Fnull (value);
801
802 return Fnull (tem);
803}
804\f
805Lisp_Object
806list_processes_1 ()
807{
808 register Lisp_Object tail, tem;
809 Lisp_Object proc, minspace, tem1;
810 register struct buffer *old = current_buffer;
811 register struct Lisp_Process *p;
812 register int state;
813 char tembuf[80];
814
815 XFASTINT (minspace) = 1;
816
817 set_buffer_internal (XBUFFER (Vstandard_output));
818 Fbuffer_disable_undo (Vstandard_output);
819
820 current_buffer->truncate_lines = Qt;
821
822 write_string ("\
823Proc Status Buffer Command\n\
824---- ------ ------ -------\n", -1);
825
826 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
827 {
828 Lisp_Object symbol;
829
830 proc = Fcdr (Fcar (tail));
831 p = XPROCESS (proc);
832 if (NILP (p->childp))
833 continue;
834
835 Finsert (1, &p->name);
836 Findent_to (make_number (13), minspace);
837
838 if (!NILP (p->raw_status_low))
839 update_status (p);
840 symbol = p->status;
841 if (XTYPE (p->status) == Lisp_Cons)
842 symbol = XCONS (p->status)->car;
843
844
845 if (EQ (symbol, Qsignal))
846 {
847 Lisp_Object tem;
848 tem = Fcar (Fcdr (p->status));
849#ifdef VMS
850 if (XINT (tem) < NSIG)
b0310da4 851 write_string (sys_errlist [XINT (tem)], -1);
d0d6b7c5
JB
852 else
853#endif
854 Fprinc (symbol, Qnil);
855 }
856 else if (NETCONN_P (proc))
857 {
858 if (EQ (symbol, Qrun))
859 write_string ("open", -1);
860 else if (EQ (symbol, Qexit))
861 write_string ("closed", -1);
862 else
863 Fprinc (symbol, Qnil);
864 }
865 else
866 Fprinc (symbol, Qnil);
867
868 if (EQ (symbol, Qexit))
869 {
870 Lisp_Object tem;
871 tem = Fcar (Fcdr (p->status));
872 if (XFASTINT (tem))
873 {
874 sprintf (tembuf, " %d", XFASTINT (tem));
875 write_string (tembuf, -1);
876 }
877 }
878
879 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
880 remove_process (proc);
881
882 Findent_to (make_number (22), minspace);
883 if (NILP (p->buffer))
884 insert_string ("(none)");
885 else if (NILP (XBUFFER (p->buffer)->name))
886 insert_string ("(Killed)");
887 else
888 Finsert (1, &XBUFFER (p->buffer)->name);
889
890 Findent_to (make_number (37), minspace);
891
892 if (NETCONN_P (proc))
893 {
894 sprintf (tembuf, "(network stream connection to %s)\n",
895 XSTRING (p->childp)->data);
896 insert_string (tembuf);
897 }
898 else
899 {
900 tem = p->command;
901 while (1)
902 {
903 tem1 = Fcar (tem);
904 Finsert (1, &tem1);
905 tem = Fcdr (tem);
906 if (NILP (tem))
907 break;
908 insert_string (" ");
909 }
910 insert_string ("\n");
911 }
912 }
913 return Qnil;
914}
915
916DEFUN ("list-processes", Flist_processes, Slist_processes, 0, 0, "",
917 "Display a list of all processes.\n\
918\(Any processes listed as Exited or Signaled are actually eliminated\n\
919after the listing is made.)")
920 ()
921{
922 internal_with_output_to_temp_buffer ("*Process List*",
923 list_processes_1, Qnil);
924 return Qnil;
925}
926
927DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
928 "Return a list of all processes.")
929 ()
930{
931 return Fmapcar (Qcdr, Vprocess_alist);
932}
933\f
b0310da4
JB
934/* Starting asynchronous inferior processes. */
935
936static Lisp_Object start_process_unwind ();
937
d0d6b7c5
JB
938DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
939 "Start a program in a subprocess. Return the process object for it.\n\
940Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
941NAME is name for process. It is modified if necessary to make it unique.\n\
942BUFFER is the buffer or (buffer-name) to associate with the process.\n\
943 Process output goes at end of that buffer, unless you specify\n\
944 an output stream or filter function to handle the output.\n\
945 BUFFER may be also nil, meaning that this process is not associated\n\
946 with any buffer\n\
947Third arg is program file name. It is searched for as in the shell.\n\
948Remaining arguments are strings to give program as arguments.")
949 (nargs, args)
950 int nargs;
951 register Lisp_Object *args;
952{
1e30af70 953 Lisp_Object buffer, name, program, proc, current_dir, tem;
d0d6b7c5
JB
954#ifdef VMS
955 register unsigned char *new_argv;
956 int len;
957#else
958 register unsigned char **new_argv;
959#endif
960 register int i;
b0310da4 961 int count = specpdl_ptr - specpdl;
d0d6b7c5
JB
962
963 buffer = args[1];
964 if (!NILP (buffer))
965 buffer = Fget_buffer_create (buffer);
966
1e30af70
JB
967 /* Make sure that the child will be able to chdir to the current
968 buffer's current directory, or its unhandled equivalent. We
969 can't just have the child check for an error when it does the
970 chdir, since it's in a vfork.
971
972 We have to GCPRO around this because Fexpand_file_name and
973 Funhandled_file_name_directory might call a file name handling
974 function. The argument list is protected by the caller, so all
975 we really have to worry about is buffer. */
976 {
977 struct gcpro gcpro1, gcpro2;
978
979 current_dir = current_buffer->directory;
980
981 GCPRO2 (buffer, current_dir);
982
983 current_dir =
984 expand_and_dir_to_file
82df4891 985 (Funhandled_file_name_directory (current_dir), Qnil);
1e30af70
JB
986 if (NILP (Ffile_accessible_directory_p (current_dir)))
987 report_file_error ("Setting current directory",
988 Fcons (current_buffer->directory, Qnil));
989
990 UNGCPRO;
991 }
992
d0d6b7c5
JB
993 name = args[0];
994 CHECK_STRING (name, 0);
995
996 program = args[2];
997
998 CHECK_STRING (program, 2);
999
1000#ifdef VMS
1001 /* Make a one member argv with all args concatenated
1002 together separated by a blank. */
1003 len = XSTRING (program)->size + 2;
1004 for (i = 3; i < nargs; i++)
1005 {
1006 tem = args[i];
1007 CHECK_STRING (tem, i);
1008 len += XSTRING (tem)->size + 1; /* count the blank */
1009 }
1010 new_argv = (unsigned char *) alloca (len);
1011 strcpy (new_argv, XSTRING (program)->data);
1012 for (i = 3; i < nargs; i++)
1013 {
1014 tem = args[i];
1015 CHECK_STRING (tem, i);
1016 strcat (new_argv, " ");
1017 strcat (new_argv, XSTRING (tem)->data);
1018 }
b0310da4
JB
1019 /* Need to add code here to check for program existence on VMS */
1020
d0d6b7c5
JB
1021#else /* not VMS */
1022 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1023
1024 for (i = 3; i < nargs; i++)
1025 {
1026 tem = args[i];
1027 CHECK_STRING (tem, i);
1028 new_argv[i - 2] = XSTRING (tem)->data;
1029 }
1030 new_argv[i - 2] = 0;
1031 new_argv[0] = XSTRING (program)->data;
1032
1033 /* If program file name is not absolute, search our path for it */
1034 if (new_argv[0][0] != '/')
1035 {
1036 tem = Qnil;
5437e9f9 1037 openp (Vexec_path, program, EXEC_SUFFIXES, &tem, 1);
d0d6b7c5
JB
1038 if (NILP (tem))
1039 report_file_error ("Searching for program", Fcons (program, Qnil));
1040 new_argv[0] = XSTRING (tem)->data;
1041 }
1042#endif /* not VMS */
1043
1044 proc = make_process (name);
b0310da4
JB
1045 /* If an error occurs and we can't start the process, we want to
1046 remove it from the process list. This means that each error
1047 check in create_process doesn't need to call remove_process
1048 itself; it's all taken care of here. */
1049 record_unwind_protect (start_process_unwind, proc);
d0d6b7c5
JB
1050
1051 XPROCESS (proc)->childp = Qt;
1052 XPROCESS (proc)->command_channel_p = Qnil;
1053 XPROCESS (proc)->buffer = buffer;
1054 XPROCESS (proc)->sentinel = Qnil;
1055 XPROCESS (proc)->filter = Qnil;
1056 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1057
1e30af70 1058 create_process (proc, new_argv, current_dir);
d0d6b7c5 1059
b0310da4 1060 return unbind_to (count, proc);
d0d6b7c5
JB
1061}
1062
b0310da4
JB
1063/* This function is the unwind_protect form for Fstart_process. If
1064 PROC doesn't have its pid set, then we know someone has signalled
1065 an error and the process wasn't started successfully, so we should
1066 remove it from the process list. */
1067static Lisp_Object
1068start_process_unwind (proc)
1069 Lisp_Object proc;
1070{
1071 if (XTYPE (proc) != Lisp_Process)
1072 abort ();
1073
1074 /* Was PROC started successfully? */
1075 if (XPROCESS (proc)->pid <= 0)
1076 remove_process (proc);
1077
1078 return Qnil;
1079}
1080
1081
d0d6b7c5
JB
1082SIGTYPE
1083create_process_1 (signo)
1084 int signo;
1085{
1086#ifdef USG
1087 /* USG systems forget handlers when they are used;
1088 must reestablish each time */
1089 signal (signo, create_process_1);
1090#endif /* USG */
1091}
1092
1093#if 0 /* This doesn't work; see the note before sigchld_handler. */
1094#ifdef USG
1095#ifdef SIGCHLD
1096/* Mimic blocking of signals on system V, which doesn't really have it. */
1097
1098/* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1099int sigchld_deferred;
1100
1101SIGTYPE
1102create_process_sigchld ()
1103{
1104 signal (SIGCHLD, create_process_sigchld);
1105
1106 sigchld_deferred = 1;
1107}
1108#endif
1109#endif
1110#endif
1111
1112#ifndef VMS /* VMS version of this function is in vmsproc.c. */
1e30af70 1113create_process (process, new_argv, current_dir)
d0d6b7c5
JB
1114 Lisp_Object process;
1115 char **new_argv;
1e30af70 1116 Lisp_Object current_dir;
d0d6b7c5
JB
1117{
1118 int pid, inchannel, outchannel, forkin, forkout;
1119 int sv[2];
1120#ifdef SIGCHLD
1121 SIGTYPE (*sigchld)();
1122#endif
1123 int pty_flag = 0;
d0d6b7c5
JB
1124 extern char **environ;
1125
d0d6b7c5
JB
1126 inchannel = outchannel = -1;
1127
1128#ifdef HAVE_PTYS
1129 if (EQ (Vprocess_connection_type, Qt))
1130 outchannel = inchannel = allocate_pty ();
1131
d0d6b7c5
JB
1132 if (inchannel >= 0)
1133 {
1134#ifndef USG
1135 /* On USG systems it does not work to open the pty's tty here
1136 and then close and reopen it in the child. */
1137#ifdef O_NOCTTY
1138 /* Don't let this terminal become our controlling terminal
1139 (in case we don't have one). */
1140 forkout = forkin = open (pty_name, O_RDWR | O_NOCTTY, 0);
1141#else
1142 forkout = forkin = open (pty_name, O_RDWR, 0);
1143#endif
1144 if (forkin < 0)
1145 report_file_error ("Opening pty", Qnil);
1146#else
1147 forkin = forkout = -1;
1148#endif /* not USG */
1149 pty_flag = 1;
1150 }
1151 else
1152#endif /* HAVE_PTYS */
1153#ifdef SKTPAIR
1154 {
1155 if (socketpair (AF_UNIX, SOCK_STREAM, 0, sv) < 0)
1156 report_file_error ("Opening socketpair", Qnil);
1157 outchannel = inchannel = sv[0];
1158 forkout = forkin = sv[1];
1159 }
1160#else /* not SKTPAIR */
1161 {
1162 pipe (sv);
1163 inchannel = sv[0];
1164 forkout = sv[1];
1165 pipe (sv);
1166 outchannel = sv[1];
1167 forkin = sv[0];
1168 }
1169#endif /* not SKTPAIR */
1170
1171#if 0
1172 /* Replaced by close_process_descs */
1173 set_exclusive_use (inchannel);
1174 set_exclusive_use (outchannel);
1175#endif
1176
1177/* Stride people say it's a mystery why this is needed
1178 as well as the O_NDELAY, but that it fails without this. */
1179#if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1180 {
1181 int one = 1;
1182 ioctl (inchannel, FIONBIO, &one);
1183 }
1184#endif
1185
1186#ifdef O_NONBLOCK
1187 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1188#else
1189#ifdef O_NDELAY
1190 fcntl (inchannel, F_SETFL, O_NDELAY);
1191#endif
1192#endif
1193
1194 /* Record this as an active process, with its channels.
1195 As a result, child_setup will close Emacs's side of the pipes. */
1196 chan_process[inchannel] = process;
1197 XFASTINT (XPROCESS (process)->infd) = inchannel;
1198 XFASTINT (XPROCESS (process)->outfd) = outchannel;
1199 /* Record the tty descriptor used in the subprocess. */
1200 if (forkin < 0)
1201 XPROCESS (process)->subtty = Qnil;
1202 else
1203 XFASTINT (XPROCESS (process)->subtty) = forkin;
1204 XPROCESS (process)->pty_flag = (pty_flag ? Qt : Qnil);
1205 XPROCESS (process)->status = Qrun;
1206
1207 /* Delay interrupts until we have a chance to store
1208 the new fork's pid in its process structure */
1209#ifdef SIGCHLD
1210#ifdef BSD4_1
1211 sighold (SIGCHLD);
1212#else /* not BSD4_1 */
1213#if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1214 sigsetmask (sigmask (SIGCHLD));
1215#else /* ordinary USG */
1216#if 0
1217 sigchld_deferred = 0;
1218 sigchld = signal (SIGCHLD, create_process_sigchld);
1219#endif
1220#endif /* ordinary USG */
1221#endif /* not BSD4_1 */
1222#endif /* SIGCHLD */
1223
1224 /* Until we store the proper pid, enable sigchld_handler
1225 to recognize an unknown pid as standing for this process.
1226 It is very important not to let this `marker' value stay
1227 in the table after this function has returned; if it does
1228 it might cause call-process to hang and subsequent asynchronous
1229 processes to get their return values scrambled. */
1230 XSETINT (XPROCESS (process)->pid, -1);
1231
1232 {
1233 /* child_setup must clobber environ on systems with true vfork.
1234 Protect it from permanent change. */
1235 char **save_environ = environ;
1236
1237 pid = vfork ();
1238 if (pid == 0)
1239 {
1240 int xforkin = forkin;
1241 int xforkout = forkout;
1242
1243#if 0 /* This was probably a mistake--it duplicates code later on,
1244 but fails to handle all the cases. */
1245 /* Make sure SIGCHLD is not blocked in the child. */
1246 sigsetmask (SIGEMPTYMASK);
1247#endif
1248
1249 /* Make the pty be the controlling terminal of the process. */
1250#ifdef HAVE_PTYS
1251 /* First, disconnect its current controlling terminal. */
1252#ifdef HAVE_SETSID
1253 setsid ();
ce4c9c90
RS
1254#ifdef TIOCSCTTY
1255 /* Make the pty's terminal the controlling terminal. */
1256 if (pty_flag && (ioctl (xforkin, TIOCSCTTY, 0) < 0))
1257 abort ();
1258#endif
d0d6b7c5
JB
1259#else /* not HAVE_SETSID */
1260#ifdef USG
1261 /* It's very important to call setpgrp() here and no time
1262 afterwards. Otherwise, we lose our controlling tty which
1263 is set when we open the pty. */
1264 setpgrp ();
1265#endif /* USG */
1266#endif /* not HAVE_SETSID */
1267#ifdef TIOCNOTTY
1268 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1269 can do TIOCSPGRP only to the process's controlling tty. */
1270 if (pty_flag)
1271 {
1272 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1273 I can't test it since I don't have 4.3. */
1274 int j = open ("/dev/tty", O_RDWR, 0);
1275 ioctl (j, TIOCNOTTY, 0);
1276 close (j);
1277#ifndef USG
1278 /* In order to get a controlling terminal on some versions
1279 of BSD, it is necessary to put the process in pgrp 0
1280 before it opens the terminal. */
1281 setpgrp (0, 0);
1282#endif
1283 }
1284#endif /* TIOCNOTTY */
1285
1286#if !defined (RTU) && !defined (UNIPLUS)
1287/*** There is a suggestion that this ought to be a
1288 conditional on TIOCSPGRP. */
1289 /* Now close the pty (if we had it open) and reopen it.
1290 This makes the pty the controlling terminal of the subprocess. */
1291 if (pty_flag)
1292 {
1293 /* I wonder if close (open (pty_name, ...)) would work? */
1294 if (xforkin >= 0)
1295 close (xforkin);
1296 xforkout = xforkin = open (pty_name, O_RDWR, 0);
1297
1298 if (xforkin < 0)
1299 abort ();
1300 }
1301#endif /* not UNIPLUS and not RTU */
1302#ifdef SETUP_SLAVE_PTY
1303 SETUP_SLAVE_PTY;
1304#endif /* SETUP_SLAVE_PTY */
1305#ifdef AIX
1306 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1307 Now reenable it in the child, so it will die when we want it to. */
1308 if (pty_flag)
1309 signal (SIGHUP, SIG_DFL);
1310#endif
1311#endif /* HAVE_PTYS */
1312
1313#ifdef SIGCHLD
1314#ifdef BSD4_1
1315 sigrelse (SIGCHLD);
1316#else /* not BSD4_1 */
1317#if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1318 sigsetmask (SIGEMPTYMASK);
1319#else /* ordinary USG */
63528b78 1320#if 0
d0d6b7c5 1321 signal (SIGCHLD, sigchld);
63528b78 1322#endif
d0d6b7c5
JB
1323#endif /* ordinary USG */
1324#endif /* not BSD4_1 */
1325#endif /* SIGCHLD */
1326
1327 child_setup_tty (xforkout);
1328 child_setup (xforkin, xforkout, xforkout,
e065a56e 1329 new_argv, 1, current_dir);
d0d6b7c5
JB
1330 }
1331 environ = save_environ;
1332 }
1333
1334 if (pid < 0)
b0310da4
JB
1335 report_file_error ("Doing vfork", Qnil);
1336
d0d6b7c5
JB
1337 XFASTINT (XPROCESS (process)->pid) = pid;
1338
1339 FD_SET (inchannel, &input_wait_mask);
1340
1341 /* If the subfork execv fails, and it exits,
1342 this close hangs. I don't know why.
1343 So have an interrupt jar it loose. */
1344 stop_polling ();
1345 signal (SIGALRM, create_process_1);
1346 alarm (1);
1347#ifdef SYSV4_PTYS
1348 /* OK to close only if it's not a pty. Otherwise we need to leave
1349 it open for ioctl to get pgrp when signals are sent, or to send
1350 the interrupt characters through if that's how we're signalling
1351 subprocesses. Alternately if you are concerned about running out
1352 of file descriptors, you could just save the tty name and open
1353 just to do the ioctl. */
1354 if (NILP (XFASTINT (XPROCESS (process)->pty_flag)))
1355#endif
1356 {
1357 XPROCESS (process)->subtty = Qnil;
1358 if (forkin >= 0)
1359 close (forkin);
1360 }
1361 alarm (0);
1362 start_polling ();
1363 if (forkin != forkout && forkout >= 0)
1364 close (forkout);
1365
1366#ifdef SIGCHLD
1367#ifdef BSD4_1
1368 sigrelse (SIGCHLD);
1369#else /* not BSD4_1 */
1370#if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1371 sigsetmask (SIGEMPTYMASK);
1372#else /* ordinary USG */
1373#if 0
1374 signal (SIGCHLD, sigchld);
1375 /* Now really handle any of these signals
1376 that came in during this function. */
1377 if (sigchld_deferred)
1378 kill (getpid (), SIGCHLD);
1379#endif
1380#endif /* ordinary USG */
1381#endif /* not BSD4_1 */
1382#endif /* SIGCHLD */
1383}
1384#endif /* not VMS */
1385
1386#ifdef HAVE_SOCKETS
1387
1388/* open a TCP network connection to a given HOST/SERVICE. Treated
1389 exactly like a normal process when reading and writing. Only
1390 differences are in status display and process deletion. A network
1391 connection has no PID; you cannot signal it. All you can do is
1392 deactivate and close it via delete-process */
1393
1394DEFUN ("open-network-stream", Fopen_network_stream, Sopen_network_stream,
1395 4, 4, 0,
1396 "Open a TCP connection for a service to a host.\n\
1397Returns a subprocess-object to represent the connection.\n\
1398Input and output work as for subprocesses; `delete-process' closes it.\n\
1399Args are NAME BUFFER HOST SERVICE.\n\
1400NAME is name for process. It is modified if necessary to make it unique.\n\
1401BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1402 Process output goes at end of that buffer, unless you specify\n\
1403 an output stream or filter function to handle the output.\n\
1404 BUFFER may be also nil, meaning that this process is not associated\n\
1405 with any buffer\n\
1406Third arg is name of the host to connect to, or its IP address.\n\
1407Fourth arg SERVICE is name of the service desired, or an integer\n\
1408 specifying a port number to connect to.")
1409 (name, buffer, host, service)
1410 Lisp_Object name, buffer, host, service;
1411{
1412 Lisp_Object proc;
1413 register int i;
1414 struct sockaddr_in address;
1415 struct servent *svc_info;
1416 struct hostent *host_info_ptr, host_info;
1417 char *(addr_list[2]);
1418 unsigned long numeric_addr;
1419 int s, outch, inch;
1420 char errstring[80];
1421 int port;
1422 struct hostent host_info_fixed;
1423 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1424
1425 GCPRO4 (name, buffer, host, service);
1426 CHECK_STRING (name, 0);
1427 CHECK_STRING (host, 0);
1428 if (XTYPE(service) == Lisp_Int)
1429 port = htons ((unsigned short) XINT (service));
1430 else
1431 {
1432 CHECK_STRING (service, 0);
1433 svc_info = getservbyname (XSTRING (service)->data, "tcp");
1434 if (svc_info == 0)
1435 error ("Unknown service \"%s\"", XSTRING (service)->data);
1436 port = svc_info->s_port;
1437 }
1438
1439 host_info_ptr = gethostbyname (XSTRING (host)->data);
1440 if (host_info_ptr == 0)
1441 /* Attempt to interpret host as numeric inet address */
1442 {
1443 numeric_addr = inet_addr (XSTRING (host)->data);
1444 if (numeric_addr == -1)
1445 error ("Unknown host \"%s\"", XSTRING (host)->data);
1446
1447 host_info_ptr = &host_info;
1448 host_info.h_name = 0;
1449 host_info.h_aliases = 0;
1450 host_info.h_addrtype = AF_INET;
1451 host_info.h_addr_list = &(addr_list[0]);
1452 addr_list[0] = (char*)(&numeric_addr);
1453 addr_list[1] = 0;
1454 host_info.h_length = strlen (addr_list[0]);
1455 }
1456
1457 bzero (&address, sizeof address);
1458 bcopy (host_info_ptr->h_addr, (char *) &address.sin_addr,
1459 host_info_ptr->h_length);
1460 address.sin_family = host_info_ptr->h_addrtype;
1461 address.sin_port = port;
1462
1463 s = socket (host_info_ptr->h_addrtype, SOCK_STREAM, 0);
1464 if (s < 0)
1465 report_file_error ("error creating socket", Fcons (name, Qnil));
1466
1467 loop:
1468 if (connect (s, &address, sizeof address) == -1)
1469 {
1470 int xerrno = errno;
1471 if (errno == EINTR)
1472 goto loop;
1473 close (s);
1474 errno = xerrno;
1475 report_file_error ("connection failed",
1476 Fcons (host, Fcons (name, Qnil)));
1477 }
1478
1479 inch = s;
1480 outch = dup (s);
1481 if (outch < 0)
1482 report_file_error ("error duplicating socket", Fcons (name, Qnil));
1483
1484 if (!NILP (buffer))
1485 buffer = Fget_buffer_create (buffer);
1486 proc = make_process (name);
1487
1488 chan_process[inch] = proc;
1489
1490#ifdef O_NONBLOCK
1491 fcntl (inch, F_SETFL, O_NONBLOCK);
1492#else
1493#ifdef O_NDELAY
1494 fcntl (inch, F_SETFL, O_NDELAY);
1495#endif
1496#endif
1497
1498 XPROCESS (proc)->childp = host;
1499 XPROCESS (proc)->command_channel_p = Qnil;
1500 XPROCESS (proc)->buffer = buffer;
1501 XPROCESS (proc)->sentinel = Qnil;
1502 XPROCESS (proc)->filter = Qnil;
1503 XPROCESS (proc)->command = Qnil;
1504 XPROCESS (proc)->pid = Qnil;
1505 XFASTINT (XPROCESS (proc)->infd) = s;
1506 XFASTINT (XPROCESS (proc)->outfd) = outch;
1507 XPROCESS (proc)->status = Qrun;
1508 FD_SET (inch, &input_wait_mask);
1509
1510 UNGCPRO;
1511 return proc;
1512}
1513#endif /* HAVE_SOCKETS */
1514
1515deactivate_process (proc)
1516 Lisp_Object proc;
1517{
1518 register int inchannel, outchannel;
1519 register struct Lisp_Process *p = XPROCESS (proc);
1520
1521 inchannel = XFASTINT (p->infd);
1522 outchannel = XFASTINT (p->outfd);
1523
1524 if (inchannel)
1525 {
1526 /* Beware SIGCHLD hereabouts. */
1527 flush_pending_output (inchannel);
1528#ifdef VMS
1529 {
1530 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
1531 sys$dassgn (outchannel);
c6c6865d 1532 vs = get_vms_process_pointer (p->pid);
d0d6b7c5
JB
1533 if (vs)
1534 give_back_vms_process_stuff (vs);
1535 }
1536#else
1537 close (inchannel);
1538 if (outchannel && outchannel != inchannel)
1539 close (outchannel);
1540#endif
1541
1542 XFASTINT (p->infd) = 0;
1543 XFASTINT (p->outfd) = 0;
1544 chan_process[inchannel] = Qnil;
1545 FD_CLR (inchannel, &input_wait_mask);
1546 }
1547}
1548
1549/* Close all descriptors currently in use for communication
1550 with subprocess. This is used in a newly-forked subprocess
1551 to get rid of irrelevant descriptors. */
1552
1553close_process_descs ()
1554{
1555 int i;
1556 for (i = 0; i < MAXDESC; i++)
1557 {
1558 Lisp_Object process;
1559 process = chan_process[i];
1560 if (!NILP (process))
1561 {
1562 int in = XFASTINT (XPROCESS (process)->infd);
1563 int out = XFASTINT (XPROCESS (process)->outfd);
1564 if (in)
1565 close (in);
1566 if (out && in != out)
1567 close (out);
1568 }
1569 }
1570}
1571\f
1572DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
1573 0, 3, 0,
1574 "Allow any pending output from subprocesses to be read by Emacs.\n\
1575It is read into the process' buffers or given to their filter functions.\n\
1576Non-nil arg PROCESS means do not return until some output has been received\n\
1577from PROCESS.\n\
1578Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1579seconds and microseconds to wait; return after that much time whether\n\
1580or not there is input.\n\
1581Return non-nil iff we received any output before the timeout expired.")
1582 (proc, timeout, timeout_msecs)
1583 register Lisp_Object proc, timeout, timeout_msecs;
1584{
1585 int seconds;
1586 int useconds;
1587
1588 if (! NILP (timeout_msecs))
1589 {
1590 CHECK_NUMBER (timeout_msecs, 2);
1591 useconds = XINT (timeout_msecs);
1592 if (XTYPE (timeout) != Lisp_Int)
1593 XSET (timeout, Lisp_Int, 0);
1594
1595 {
1596 int carry = useconds / 1000000;
1597
1598 XSETINT (timeout, XINT (timeout) + carry);
1599 useconds -= carry * 1000000;
1600
1601 /* I think this clause is necessary because C doesn't
1602 guarantee a particular rounding direction for negative
1603 integers. */
1604 if (useconds < 0)
1605 {
1606 XSETINT (timeout, XINT (timeout) - 1);
1607 useconds += 1000000;
1608 }
1609 }
1610 }
de946e5a
RS
1611 else
1612 useconds = 0;
d0d6b7c5
JB
1613
1614 if (! NILP (timeout))
1615 {
1616 CHECK_NUMBER (timeout, 1);
1617 seconds = XINT (timeout);
1618 if (seconds <= 0)
1619 seconds = -1;
1620 }
1621 else
1622 {
1623 if (NILP (proc))
1624 seconds = -1;
1625 else
1626 seconds = 0;
1627 }
1628
f76475ad
JB
1629 if (NILP (proc))
1630 XFASTINT (proc) = 0;
1631
d0d6b7c5 1632 return
f76475ad 1633 (wait_reading_process_input (seconds, useconds, proc, 0)
d0d6b7c5
JB
1634 ? Qt : Qnil);
1635}
1636
1637/* This variable is different from waiting_for_input in keyboard.c.
1638 It is used to communicate to a lisp process-filter/sentinel (via the
1639 function Fwaiting_for_user_input_p below) whether emacs was waiting
1640 for user-input when that process-filter was called.
1641 waiting_for_input cannot be used as that is by definition 0 when
1642 lisp code is being evalled */
1643static int waiting_for_user_input_p;
1644
1645/* Read and dispose of subprocess output while waiting for timeout to
1646 elapse and/or keyboard input to be available.
1647
1648 time_limit is:
1649 timeout in seconds, or
1650 zero for no limit, or
1651 -1 means gobble data immediately available but don't wait for any.
1652
6e4f3667
JB
1653 microsecs is:
1654 an additional duration to wait (if time_limit is greater than
1655 zero), specified in millisec.
1656
f76475ad 1657 read_kbd is a lisp value:
d0d6b7c5
JB
1658 0 to ignore keyboard input, or
1659 1 to return when input is available, or
84aa3ace 1660 -1 meaning caller will actually read the input, so don't throw to
d0d6b7c5 1661 the quit handler, or
84aa3ace 1662 a cons cell, meaning wait wait until its car is non-nil, or
f76475ad
JB
1663 a process object, meaning wait until something arrives from that
1664 process. The return value is true iff we read some input from
1665 that process.
d0d6b7c5
JB
1666
1667 do_display != 0 means redisplay should be done to show subprocess
1668 output that arrives.
1669
1670 If read_kbd is a pointer to a struct Lisp_Process, then the
1671 function returns true iff we received input from that process
1672 before the timeout elapsed.
1673 Otherwise, return true iff we recieved input from any process. */
1674
1675wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
f76475ad
JB
1676 int time_limit, microsecs;
1677 Lisp_Object read_kbd;
1678 int do_display;
d0d6b7c5
JB
1679{
1680 register int channel, nfds, m;
1681 static SELECT_TYPE Available;
1682 int xerrno;
1683 Lisp_Object proc;
1684 EMACS_TIME timeout, end_time, garbage;
1685 SELECT_TYPE Atemp;
1686 int wait_channel = 0;
1687 struct Lisp_Process *wait_proc = 0;
1688 int got_some_input = 0;
84aa3ace 1689 Lisp_Object *wait_for_cell = 0;
d0d6b7c5
JB
1690
1691 FD_ZERO (&Available);
1692
f76475ad
JB
1693 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1694 accordingly. */
1695 if (XTYPE (read_kbd) == Lisp_Process)
d0d6b7c5 1696 {
f76475ad 1697 wait_proc = XPROCESS (read_kbd);
d0d6b7c5 1698 wait_channel = XFASTINT (wait_proc->infd);
f76475ad 1699 XFASTINT (read_kbd) = 0;
d0d6b7c5
JB
1700 }
1701
84aa3ace
RS
1702 /* If waiting for non-nil in a cell, record where. */
1703 if (XTYPE (read_kbd) == Lisp_Cons)
1704 {
1705 wait_for_cell = &XCONS (read_kbd)->car;
1706 XFASTINT (read_kbd) = 0;
1707 }
1708
f76475ad 1709 waiting_for_user_input_p = XINT (read_kbd);
d0d6b7c5
JB
1710
1711 /* Since we may need to wait several times,
1712 compute the absolute time to return at. */
1713 if (time_limit || microsecs)
1714 {
1715 EMACS_GET_TIME (end_time);
1716 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
1717 EMACS_ADD_TIME (end_time, end_time, timeout);
1718 }
1719
d0d6b7c5
JB
1720 while (1)
1721 {
1722 /* If calling from keyboard input, do not quit
1723 since we want to return C-g as an input character.
1724 Otherwise, do pending quit if requested. */
f76475ad 1725 if (XINT (read_kbd) >= 0)
d0d6b7c5
JB
1726 QUIT;
1727
d0d6b7c5
JB
1728 /* Compute time from now till when time limit is up */
1729 /* Exit if already run out */
1730 if (time_limit == -1)
1731 {
1732 /* -1 specified for timeout means
1733 gobble output available now
1734 but don't wait at all. */
1735
1736 EMACS_SET_SECS_USECS (timeout, 0, 0);
1737 }
1738 else if (time_limit || microsecs)
1739 {
1740 EMACS_GET_TIME (timeout);
1741 EMACS_SUB_TIME (timeout, end_time, timeout);
1742 if (EMACS_TIME_NEG_P (timeout))
1743 break;
1744 }
1745 else
1746 {
1747 EMACS_SET_SECS_USECS (timeout, 100000, 0);
1748 }
1749
6be429b1
JB
1750 /* If status of something has changed, and no input is
1751 available, notify the user of the change right away. After
1752 this explicit check, we'll let the SIGCHLD handler zap
1753 timeout to get our attention. */
1754 if (update_tick != process_tick && do_display)
1755 {
1756 Atemp = input_wait_mask;
1757 EMACS_SET_SECS_USECS (timeout, 0, 0);
1758 if (select (MAXDESC, &Atemp, 0, 0, &timeout) <= 0)
1759 status_notify ();
1760 }
1761
68a75220
RS
1762 /* Cause C-g and alarm signals to take immediate action,
1763 and cause input available signals to zero out timeout.
1764
1765 It is important that we do this before checking for process
1766 activity. If we get a SIGCHLD after the explicit checks for
1767 process activity, timeout is the only way we will know. */
1768 if (XINT (read_kbd) < 0)
1769 set_waiting_for_input (&timeout);
1770
6be429b1
JB
1771 /* Don't wait for output from a non-running process. */
1772 if (wait_proc != 0 && !NILP (wait_proc->raw_status_low))
1773 update_status (wait_proc);
1774 if (wait_proc != 0
1775 && ! EQ (wait_proc->status, Qrun))
1776 break;
1777
d0d6b7c5
JB
1778 /* Wait till there is something to do */
1779
1780 Available = input_wait_mask;
f76475ad 1781 if (! XINT (read_kbd))
d0d6b7c5
JB
1782 FD_CLR (0, &Available);
1783
ff11dfa1 1784 /* If frame size has changed or the window is newly mapped,
ffd56f97
JB
1785 redisplay now, before we start to wait. There is a race
1786 condition here; if a SIGIO arrives between now and the select
016899c0
JB
1787 and indicates that a frame is trashed, the select may block
1788 displaying a trashed screen. */
ff11dfa1 1789 if (frame_garbaged)
ffd56f97
JB
1790 redisplay_preserve_echo_area ();
1791
f76475ad 1792 if (XINT (read_kbd) && detect_input_pending ())
d0d6b7c5
JB
1793 nfds = 0;
1794 else
d0d6b7c5 1795 nfds = select (MAXDESC, &Available, 0, 0, &timeout);
6720a7fb 1796
d0d6b7c5
JB
1797 xerrno = errno;
1798
1799 /* Make C-g and alarm signals set flags again */
1800 clear_waiting_for_input ();
1801
1802 /* If we woke up due to SIGWINCH, actually change size now. */
1803 do_pending_window_change ();
1804
ffd56f97 1805 if (time_limit && nfds == 0) /* timeout elapsed */
d0d6b7c5
JB
1806 break;
1807 if (nfds < 0)
1808 {
1809 if (xerrno == EINTR)
1810 FD_ZERO (&Available);
b0310da4
JB
1811#ifdef ultrix
1812 /* Ultrix select seems to return ENOMEM when it is
1813 interrupted. Treat it just like EINTR. Bleah. Note
1814 that we want to test for the "ultrix" CPP symbol, not
1815 "__ultrix__"; the latter is only defined under GCC, but
1816 not by DEC's bundled CC. -JimB */
8058415c
JB
1817 else if (xerrno == ENOMEM)
1818 FD_ZERO (&Available);
1819#endif
d0d6b7c5
JB
1820#ifdef ALLIANT
1821 /* This happens for no known reason on ALLIANT.
1822 I am guessing that this is the right response. -- RMS. */
1823 else if (xerrno == EFAULT)
1824 FD_ZERO (&Available);
1825#endif
1826 else if (xerrno == EBADF)
1827 {
1828#ifdef AIX
1829 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1830 the child's closure of the pts gives the parent a SIGHUP, and
1831 the ptc file descriptor is automatically closed,
1832 yielding EBADF here or at select() call above.
1833 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1834 in m-ibmrt-aix.h), and here we just ignore the select error.
1835 Cleanup occurs c/o status_notify after SIGCLD. */
ffd56f97 1836 FD_ZERO (&Available); /* Cannot depend on values returned */
d0d6b7c5
JB
1837#else
1838 abort ();
1839#endif
1840 }
1841 else
1842 error("select error: %s", sys_errlist[xerrno]);
1843 }
26ec91de 1844#if defined(sun) && !defined(USG5_4)
d0d6b7c5 1845 else if (nfds > 0 && FD_ISSET (0, &Available) && interrupt_input)
e0109153
JB
1846 /* System sometimes fails to deliver SIGIO.
1847
1848 David J. Mackenzie says that Emacs doesn't compile under
1849 Solaris if this code is enabled, thus the USG5_4 in the CPP
1850 conditional. "I haven't noticed any ill effects so far.
1851 If you find a Solaris expert somewhere, they might know
1852 better." */
d0d6b7c5
JB
1853 kill (getpid (), SIGIO);
1854#endif
1855
1856 /* Check for keyboard input */
1857 /* If there is any, return immediately
1858 to give it higher priority than subprocesses */
1859
f76475ad 1860 if (XINT (read_kbd) && detect_input_pending ())
d0d6b7c5
JB
1861 break;
1862
84aa3ace
RS
1863 /* Exit now if the cell we're waiting for became non-nil. */
1864 if (wait_for_cell && ! NILP (*wait_for_cell))
1865 break;
1866
4746118a 1867#ifdef SIGIO
d0d6b7c5
JB
1868 /* If we think we have keyboard input waiting, but didn't get SIGIO
1869 go read it. This can happen with X on BSD after logging out.
1870 In that case, there really is no input and no SIGIO,
1871 but select says there is input. */
1872
f76475ad 1873 if (XINT (read_kbd) && interrupt_input && (FD_ISSET (fileno (stdin), &Available)))
d0d6b7c5 1874 kill (0, SIGIO);
4746118a 1875#endif
d0d6b7c5 1876
d0d6b7c5
JB
1877 if (! wait_proc)
1878 got_some_input |= nfds > 0;
1879
32676c08
JB
1880 /* If checking input just got us a size-change event from X,
1881 obey it now if we should. */
f76475ad 1882 if (XINT (read_kbd))
32676c08
JB
1883 do_pending_window_change ();
1884
d0d6b7c5
JB
1885 /* Check for data from a process or a command channel */
1886 for (channel = FIRST_PROC_DESC; channel < MAXDESC; channel++)
1887 {
1888 if (FD_ISSET (channel, &Available))
1889 {
1890 int nread;
1891
1892 /* If waiting for this channel, arrange to return as
1893 soon as no more input to be processed. No more
1894 waiting. */
1895 if (wait_channel == channel)
1896 {
1897 wait_channel = 0;
1898 time_limit = -1;
1899 got_some_input = 1;
1900 }
1901 proc = chan_process[channel];
1902 if (NILP (proc))
1903 continue;
1904
d0d6b7c5
JB
1905 /* Read data from the process, starting with our
1906 buffered-ahead character if we have one. */
1907
1908 nread = read_process_output (proc, channel);
1909 if (nread > 0)
1910 {
1911 /* Since read_process_output can run a filter,
1912 which can call accept-process-output,
1913 don't try to read from any other processes
1914 before doing the select again. */
1915 FD_ZERO (&Available);
1916
1917 if (do_display)
1918 redisplay_preserve_echo_area ();
1919 }
1920#ifdef EWOULDBLOCK
1921 else if (nread == -1 && errno == EWOULDBLOCK)
1922 ;
1923#else
1924#ifdef O_NONBLOCK
1925 else if (nread == -1 && errno == EAGAIN)
1926 ;
1927#else
1928#ifdef O_NDELAY
1929 else if (nread == -1 && errno == EAGAIN)
1930 ;
1931 /* Note that we cannot distinguish between no input
1932 available now and a closed pipe.
1933 With luck, a closed pipe will be accompanied by
1934 subprocess termination and SIGCHLD. */
1935 else if (nread == 0 && !NETCONN_P (proc))
1936 ;
ffd56f97
JB
1937#endif /* O_NDELAY */
1938#endif /* O_NONBLOCK */
1939#endif /* EWOULDBLOCK */
d0d6b7c5
JB
1940#ifdef HAVE_PTYS
1941 /* On some OSs with ptys, when the process on one end of
1942 a pty exits, the other end gets an error reading with
1943 errno = EIO instead of getting an EOF (0 bytes read).
1944 Therefore, if we get an error reading and errno =
1945 EIO, just continue, because the child process has
1946 exited and should clean itself up soon (e.g. when we
1947 get a SIGCHLD). */
1948 else if (nread == -1 && errno == EIO)
1949 ;
ffd56f97
JB
1950#endif /* HAVE_PTYS */
1951 /* If we can detect process termination, don't consider the process
1952 gone just because its pipe is closed. */
d0d6b7c5
JB
1953#ifdef SIGCHLD
1954 else if (nread == 0 && !NETCONN_P (proc))
1955 ;
1956#endif
1957 else
1958 {
1959 /* Preserve status of processes already terminated. */
1960 XSETINT (XPROCESS (proc)->tick, ++process_tick);
1961 deactivate_process (proc);
1962 if (!NILP (XPROCESS (proc)->raw_status_low))
1963 update_status (XPROCESS (proc));
1964 if (EQ (XPROCESS (proc)->status, Qrun))
1965 XPROCESS (proc)->status
1966 = Fcons (Qexit, Fcons (make_number (256), Qnil));
1967 }
1968 }
ffd56f97
JB
1969 } /* end for each file descriptor */
1970 } /* end while exit conditions not met */
d0d6b7c5 1971
ffd56f97
JB
1972 /* If calling from keyboard input, do not quit
1973 since we want to return C-g as an input character.
1974 Otherwise, do pending quit if requested. */
f76475ad 1975 if (XINT (read_kbd) >= 0)
ffd56f97
JB
1976 {
1977 /* Prevent input_pending from remaining set if we quit. */
1978 clear_input_pending ();
1979 QUIT;
1980 }
d0d6b7c5
JB
1981
1982 return got_some_input;
1983}
1984\f
1985/* Read pending output from the process channel,
1986 starting with our buffered-ahead character if we have one.
1987 Yield number of characters read.
1988
1989 This function reads at most 1024 characters.
1990 If you want to read all available subprocess output,
1991 you must call it repeatedly until it returns zero. */
1992
1993read_process_output (proc, channel)
1994 Lisp_Object proc;
1995 register int channel;
1996{
1997 register int nchars;
1998#ifdef VMS
1999 char *chars;
2000#else
2001 char chars[1024];
2002#endif
2003 register Lisp_Object outstream;
2004 register struct buffer *old = current_buffer;
2005 register struct Lisp_Process *p = XPROCESS (proc);
2006 register int opoint;
2007
2008#ifdef VMS
2009 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2010
2011 vs = get_vms_process_pointer (p->pid);
2012 if (vs)
2013 {
2014 if (!vs->iosb[0])
2015 return(0); /* Really weird if it does this */
2016 if (!(vs->iosb[0] & 1))
2017 return -1; /* I/O error */
2018 }
2019 else
2020 error ("Could not get VMS process pointer");
2021 chars = vs->inputBuffer;
2022 nchars = clean_vms_buffer (chars, vs->iosb[1]);
2023 if (nchars <= 0)
2024 {
2025 start_vms_process_read (vs); /* Crank up the next read on the process */
2026 return 1; /* Nothing worth printing, say we got 1 */
2027 }
2028#else /* not VMS */
2029
2030 if (proc_buffered_char[channel] < 0)
2031 nchars = read (channel, chars, sizeof chars);
2032 else
2033 {
2034 chars[0] = proc_buffered_char[channel];
2035 proc_buffered_char[channel] = -1;
2036 nchars = read (channel, chars + 1, sizeof chars - 1);
2037 if (nchars < 0)
2038 nchars = 1;
2039 else
2040 nchars = nchars + 1;
2041 }
2042#endif /* not VMS */
2043
2044 if (nchars <= 0) return nchars;
2045
2046 outstream = p->filter;
2047 if (!NILP (outstream))
2048 {
2049 /* We inhibit quit here instead of just catching it so that
2050 hitting ^G when a filter happens to be running won't screw
2051 it up. */
2052 int count = specpdl_ptr - specpdl;
2053 specbind (Qinhibit_quit, Qt);
2054 call2 (outstream, proc, make_string (chars, nchars));
2055
2056#ifdef VMS
2057 start_vms_process_read (vs);
2058#endif
2059 unbind_to (count);
2060 return nchars;
2061 }
2062
2063 /* If no filter, write into buffer if it isn't dead. */
2064 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
2065 {
b0310da4
JB
2066 Lisp_Object old_read_only;
2067 Lisp_Object old_begv, old_zv;
d0d6b7c5
JB
2068
2069 Fset_buffer (p->buffer);
2070 opoint = point;
b0310da4
JB
2071 old_read_only = current_buffer->read_only;
2072 XFASTINT (old_begv) = BEGV;
2073 XFASTINT (old_zv) = ZV;
2074
2075 current_buffer->read_only = Qnil;
d0d6b7c5
JB
2076
2077 /* Insert new output into buffer
2078 at the current end-of-output marker,
2079 thus preserving logical ordering of input and output. */
2080 if (XMARKER (p->mark)->buffer)
2081 SET_PT (marker_position (p->mark));
2082 else
2083 SET_PT (ZV);
b0310da4
JB
2084
2085 /* If the output marker is outside of the visible region, save
2086 the restriction and widen. */
2087 if (! (BEGV <= point && point <= ZV))
2088 Fwiden ();
2089
2090 /* Make sure opoint floats ahead of any new text, just as point
2091 would. */
d0d6b7c5
JB
2092 if (point <= opoint)
2093 opoint += nchars;
2094
b0310da4
JB
2095 /* Insert after old_begv, but before old_zv. */
2096 if (point < XFASTINT (old_begv))
2097 XFASTINT (old_begv) += nchars;
2098 if (point <= XFASTINT (old_zv))
2099 XFASTINT (old_zv) += nchars;
2100
d0d6b7c5
JB
2101 /* Insert before markers in case we are inserting where
2102 the buffer's mark is, and the user's next command is Meta-y. */
2103 insert_before_markers (chars, nchars);
d0d6b7c5 2104 Fset_marker (p->mark, make_number (point), p->buffer);
b0310da4 2105
d0d6b7c5
JB
2106 update_mode_lines++;
2107
b0310da4
JB
2108 /* If the restriction isn't what it should be, set it. */
2109 if (XFASTINT (old_begv) != BEGV || XFASTINT (old_zv) != ZV)
2110 Fnarrow_to_region (old_begv, old_zv);
2111
2112 current_buffer->read_only = old_read_only;
d0d6b7c5
JB
2113 SET_PT (opoint);
2114 set_buffer_internal (old);
2115 }
2116#ifdef VMS
2117 start_vms_process_read (vs);
2118#endif
2119 return nchars;
2120}
2121
2122DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
2123 0, 0, 0,
2124 "Returns non-NIL if emacs is waiting for input from the user.\n\
2125This is intended for use by asynchronous process output filters and sentinels.")
2126 ()
2127{
2128 return ((waiting_for_user_input_p) ? Qt : Qnil);
2129}
2130\f
2131/* Sending data to subprocess */
2132
2133jmp_buf send_process_frame;
2134
2135SIGTYPE
2136send_process_trap ()
2137{
2138#ifdef BSD4_1
2139 sigrelse (SIGPIPE);
2140 sigrelse (SIGALRM);
2141#endif /* BSD4_1 */
2142 longjmp (send_process_frame, 1);
2143}
2144
2145send_process (proc, buf, len)
2146 Lisp_Object proc;
2147 char *buf;
2148 int len;
2149{
2150 /* Don't use register vars; longjmp can lose them. */
2151 int rv;
2152 unsigned char *procname = XSTRING (XPROCESS (proc)->name)->data;
2153
2154
2155#ifdef VMS
2156 struct Lisp_Process *p = XPROCESS (proc);
2157 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2158#endif /* VMS */
2159
2160 if (! NILP (XPROCESS (proc)->raw_status_low))
2161 update_status (XPROCESS (proc));
2162 if (! EQ (XPROCESS (proc)->status, Qrun))
2163 error ("Process %s not running", procname);
2164
2165#ifdef VMS
2166 vs = get_vms_process_pointer (p->pid);
2167 if (vs == 0)
2168 error ("Could not find this process: %x", p->pid);
2169 else if (write_to_vms_process (vs, buf, len))
2170 ;
2171#else
2172 if (!setjmp (send_process_frame))
2173 while (len > 0)
2174 {
2175 int this = len;
4746118a
JB
2176 SIGTYPE (*old_sigpipe)();
2177
d0d6b7c5
JB
2178 /* Don't send more than 500 bytes at a time. */
2179 if (this > 500)
2180 this = 500;
508b171c 2181 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
d0d6b7c5 2182 rv = write (XFASTINT (XPROCESS (proc)->outfd), buf, this);
4746118a 2183 signal (SIGPIPE, old_sigpipe);
d0d6b7c5
JB
2184 if (rv < 0)
2185 {
2186 if (0
2187#ifdef EWOULDBLOCK
2188 || errno == EWOULDBLOCK
2189#endif
2190#ifdef EAGAIN
2191 || errno == EAGAIN
2192#endif
2193 )
2194 {
2195 /* It would be nice to accept process output here,
2196 but that is difficult. For example, it could
2197 garbage what we are sending if that is from a buffer. */
2198 immediate_quit = 1;
2199 QUIT;
2200 sleep (1);
2201 immediate_quit = 0;
2202 continue;
2203 }
2204 report_file_error ("writing to process", Fcons (proc, Qnil));
2205 }
2206 buf += rv;
2207 len -= rv;
2208 /* Allow input from processes between bursts of sending.
2209 Otherwise things may get stopped up. */
2210 if (len > 0)
f76475ad
JB
2211 {
2212 Lisp_Object zero;
2213
2214 XFASTINT (zero) = 0;
2215 wait_reading_process_input (-1, 0, zero, 0);
2216 }
d0d6b7c5
JB
2217 }
2218#endif
2219 else
2220 {
2221 XPROCESS (proc)->raw_status_low = Qnil;
2222 XPROCESS (proc)->raw_status_high = Qnil;
2223 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
2224 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2225 deactivate_process (proc);
2226#ifdef VMS
2227 error ("Error writing to process %s; closed it", procname);
2228#else
2229 error ("SIGPIPE raised on process %s; closed it", procname);
2230#endif
2231 }
2232}
2233
2234DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
2235 3, 3, 0,
2236 "Send current contents of region as input to PROCESS.\n\
ebb9e16f
JB
2237PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2238nil, indicating the current buffer's process.\n\
d0d6b7c5
JB
2239Called from program, takes three arguments, PROCESS, START and END.\n\
2240If the region is more than 500 characters long,\n\
2241it is sent in several bunches. This may happen even for shorter regions.\n\
2242Output from processes can arrive in between bunches.")
2243 (process, start, end)
2244 Lisp_Object process, start, end;
2245{
2246 Lisp_Object proc;
2247 int start1;
2248
2249 proc = get_process (process);
2250 validate_region (&start, &end);
2251
2252 if (XINT (start) < GPT && XINT (end) > GPT)
2253 move_gap (start);
2254
2255 start1 = XINT (start);
2256 send_process (proc, &FETCH_CHAR (start1), XINT (end) - XINT (start));
2257
2258 return Qnil;
2259}
2260
2261DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
2262 2, 2, 0,
2263 "Send PROCESS the contents of STRING as input.\n\
ebb9e16f
JB
2264PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2265nil, indicating the current buffer's process.\n\
d0d6b7c5
JB
2266If STRING is more than 500 characters long,\n\
2267it is sent in several bunches. This may happen even for shorter strings.\n\
2268Output from processes can arrive in between bunches.")
2269 (process, string)
2270 Lisp_Object process, string;
2271{
2272 Lisp_Object proc;
2273 CHECK_STRING (string, 1);
2274 proc = get_process (process);
2275 send_process (proc, XSTRING (string)->data, XSTRING (string)->size);
2276 return Qnil;
2277}
2278\f
2279/* send a signal number SIGNO to PROCESS.
2280 CURRENT_GROUP means send to the process group that currently owns
2281 the terminal being used to communicate with PROCESS.
2282 This is used for various commands in shell mode.
2283 If NOMSG is zero, insert signal-announcements into process's buffers
b0310da4
JB
2284 right away.
2285
2286 If we can, we try to signal PROCESS by sending control characters
2287 down the pipe. This allows us to signal inferiors who have changed
2288 their uid, for which killpg would return an EPERM error. */
d0d6b7c5 2289
f9738840 2290static void
d0d6b7c5
JB
2291process_send_signal (process, signo, current_group, nomsg)
2292 Lisp_Object process;
2293 int signo;
2294 Lisp_Object current_group;
2295 int nomsg;
2296{
2297 Lisp_Object proc;
2298 register struct Lisp_Process *p;
2299 int gid;
2300 int no_pgrp = 0;
2301
2302 proc = get_process (process);
2303 p = XPROCESS (proc);
2304
2305 if (!EQ (p->childp, Qt))
2306 error ("Process %s is not a subprocess",
2307 XSTRING (p->name)->data);
2308 if (!XFASTINT (p->infd))
2309 error ("Process %s is not active",
2310 XSTRING (p->name)->data);
2311
2312 if (NILP (p->pty_flag))
2313 current_group = Qnil;
2314
d0d6b7c5
JB
2315 /* If we are using pgrps, get a pgrp number and make it negative. */
2316 if (!NILP (current_group))
2317 {
b0310da4 2318#ifdef SIGNALS_VIA_CHARACTERS
d0d6b7c5
JB
2319 /* If possible, send signals to the entire pgrp
2320 by sending an input character to it. */
b0310da4 2321
6be429b1
JB
2322 /* TERMIOS is the latest and bestest, and seems most likely to
2323 work. If the system has it, use it. */
2324#ifdef HAVE_TERMIOS
2325 struct termios t;
2326
2327 switch (signo)
2328 {
2329 case SIGINT:
2330 tcgetattr (XFASTINT (p->infd), &t);
2331 send_process (proc, &t.c_cc[VINTR], 1);
a87b802f 2332 return;
6be429b1
JB
2333
2334 case SIGQUIT:
2335 tcgetattr (XFASTINT (p->infd), &t);
2336 send_process (proc, &t.c_cc[VQUIT], 1);
a87b802f 2337 return;
6be429b1
JB
2338
2339 case SIGTSTP:
2340 tcgetattr (XFASTINT (p->infd), &t);
2341#ifdef VSWTCH
2342 send_process (proc, &t.c_cc[VSWTCH], 1);
2343#else
2344 send_process (proc, &t.c_cc[VSUSP], 1);
2345#endif
a87b802f 2346 return;
6be429b1
JB
2347 }
2348
2349#else /* ! HAVE_TERMIOS */
2350
b0310da4
JB
2351 /* On Berkeley descendants, the following IOCTL's retrieve the
2352 current control characters. */
d0d6b7c5 2353#if defined (TIOCGLTC) && defined (TIOCGETC)
b0310da4 2354
d0d6b7c5
JB
2355 struct tchars c;
2356 struct ltchars lc;
2357
2358 switch (signo)
2359 {
2360 case SIGINT:
2361 ioctl (XFASTINT (p->infd), TIOCGETC, &c);
2362 send_process (proc, &c.t_intrc, 1);
f9738840 2363 return;
d0d6b7c5
JB
2364 case SIGQUIT:
2365 ioctl (XFASTINT (p->infd), TIOCGETC, &c);
2366 send_process (proc, &c.t_quitc, 1);
f9738840 2367 return;
0ad77c54 2368#ifdef SIGTSTP
d0d6b7c5
JB
2369 case SIGTSTP:
2370 ioctl (XFASTINT (p->infd), TIOCGLTC, &lc);
2371 send_process (proc, &lc.t_suspc, 1);
f9738840 2372 return;
b0310da4 2373#endif /* ! defined (SIGTSTP) */
d0d6b7c5 2374 }
b0310da4
JB
2375
2376#else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2377
2378 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2379 characters. */
2380#ifdef TCGETA
d0d6b7c5
JB
2381 struct termio t;
2382 switch (signo)
2383 {
2384 case SIGINT:
2385 ioctl (XFASTINT (p->infd), TCGETA, &t);
2386 send_process (proc, &t.c_cc[VINTR], 1);
f9738840 2387 return;
d0d6b7c5
JB
2388 case SIGQUIT:
2389 ioctl (XFASTINT (p->infd), TCGETA, &t);
2390 send_process (proc, &t.c_cc[VQUIT], 1);
f9738840 2391 return;
7d79e3b4 2392#ifdef SIGTSTP
d0d6b7c5
JB
2393 case SIGTSTP:
2394 ioctl (XFASTINT (p->infd), TCGETA, &t);
2395 send_process (proc, &t.c_cc[VSWTCH], 1);
f9738840 2396 return;
b0310da4 2397#endif /* ! defined (SIGTSTP) */
d0d6b7c5 2398 }
b0310da4
JB
2399#else /* ! defined (TCGETA) */
2400 Your configuration files are messed up.
2401 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2402 you'd better be using one of the alternatives above! */
2403#endif /* ! defined (TCGETA) */
2404#endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
6be429b1 2405#endif /* ! defined HAVE_TERMIOS */
b0310da4 2406#endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
d0d6b7c5 2407
301c3fe4 2408#ifdef TIOCGPGRP
d0d6b7c5
JB
2409 /* Get the pgrp using the tty itself, if we have that.
2410 Otherwise, use the pty to get the pgrp.
2411 On pfa systems, saka@pfu.fujitsu.co.JP writes:
b0310da4
JB
2412 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2413 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
d0d6b7c5
JB
2414 His patch indicates that if TIOCGPGRP returns an error, then
2415 we should just assume that p->pid is also the process group id. */
2416 {
2417 int err;
2418
2419 if (!NILP (p->subtty))
2420 err = ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
2421 else
2422 err = ioctl (XFASTINT (p->infd), TIOCGPGRP, &gid);
2423
2424#ifdef pfa
2425 if (err == -1)
2426 gid = - XFASTINT (p->pid);
301c3fe4 2427#endif /* ! defined (pfa) */
d0d6b7c5
JB
2428 }
2429 if (gid == -1)
2430 no_pgrp = 1;
2431 else
2432 gid = - gid;
b0310da4 2433#else /* ! defined (TIOCGPGRP ) */
301c3fe4
JB
2434 /* Can't select pgrps on this system, so we know that
2435 the child itself heads the pgrp. */
2436 gid = - XFASTINT (p->pid);
2437#endif /* ! defined (TIOCGPGRP ) */
d0d6b7c5
JB
2438 }
2439 else
2440 gid = - XFASTINT (p->pid);
d0d6b7c5
JB
2441
2442 switch (signo)
2443 {
2444#ifdef SIGCONT
2445 case SIGCONT:
2446 p->raw_status_low = Qnil;
2447 p->raw_status_high = Qnil;
2448 p->status = Qrun;
2449 XSETINT (p->tick, ++process_tick);
2450 if (!nomsg)
2451 status_notify ();
2452 break;
301c3fe4 2453#endif /* ! defined (SIGCONT) */
d0d6b7c5
JB
2454 case SIGINT:
2455#ifdef VMS
2456 send_process (proc, "\003", 1); /* ^C */
2457 goto whoosh;
2458#endif
2459 case SIGQUIT:
2460#ifdef VMS
2461 send_process (proc, "\031", 1); /* ^Y */
2462 goto whoosh;
2463#endif
2464 case SIGKILL:
2465#ifdef VMS
2466 sys$forcex (&(XFASTINT (p->pid)), 0, 1);
2467 whoosh:
2468#endif
2469 flush_pending_output (XFASTINT (p->infd));
2470 break;
2471 }
2472
2473 /* If we don't have process groups, send the signal to the immediate
2474 subprocess. That isn't really right, but it's better than any
2475 obvious alternative. */
2476 if (no_pgrp)
2477 {
2478 kill (XFASTINT (p->pid), signo);
2479 return;
2480 }
2481
2482 /* gid may be a pid, or minus a pgrp's number */
2483#ifdef TIOCSIGSEND
2484 if (!NILP (current_group))
2485 ioctl (XFASTINT (p->infd), TIOCSIGSEND, signo);
2486 else
2487 {
2488 gid = - XFASTINT (p->pid);
2489 kill (gid, signo);
2490 }
301c3fe4 2491#else /* ! defined (TIOCSIGSEND) */
d0d6b7c5 2492 EMACS_KILLPG (-gid, signo);
301c3fe4 2493#endif /* ! defined (TIOCSIGSEND) */
d0d6b7c5
JB
2494}
2495
2496DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
2497 "Interrupt process PROCESS. May be process or name of one.\n\
ebb9e16f 2498PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
d0d6b7c5
JB
2499Nil or no arg means current buffer's process.\n\
2500Second arg CURRENT-GROUP non-nil means send signal to\n\
2501the current process-group of the process's controlling terminal\n\
2502rather than to the process's own process group.\n\
2503If the process is a shell, this means interrupt current subjob\n\
2504rather than the shell.")
2505 (process, current_group)
2506 Lisp_Object process, current_group;
2507{
2508 process_send_signal (process, SIGINT, current_group, 0);
2509 return process;
2510}
2511
2512DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
2513 "Kill process PROCESS. May be process or name of one.\n\
2514See function `interrupt-process' for more details on usage.")
2515 (process, current_group)
2516 Lisp_Object process, current_group;
2517{
2518 process_send_signal (process, SIGKILL, current_group, 0);
2519 return process;
2520}
2521
2522DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
2523 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2524See function `interrupt-process' for more details on usage.")
2525 (process, current_group)
2526 Lisp_Object process, current_group;
2527{
2528 process_send_signal (process, SIGQUIT, current_group, 0);
2529 return process;
2530}
2531
2532DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
2533 "Stop process PROCESS. May be process or name of one.\n\
2534See function `interrupt-process' for more details on usage.")
2535 (process, current_group)
2536 Lisp_Object process, current_group;
2537{
2538#ifndef SIGTSTP
2539 error ("no SIGTSTP support");
2540#else
2541 process_send_signal (process, SIGTSTP, current_group, 0);
2542#endif
2543 return process;
2544}
2545
2546DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
2547 "Continue process PROCESS. May be process or name of one.\n\
2548See function `interrupt-process' for more details on usage.")
2549 (process, current_group)
2550 Lisp_Object process, current_group;
2551{
2552#ifdef SIGCONT
2553 process_send_signal (process, SIGCONT, current_group, 0);
2554#else
2555 error ("no SIGCONT support");
2556#endif
2557 return process;
2558}
2559
2560DEFUN ("signal-process", Fsignal_process, Ssignal_process,
2561 2, 2, "nProcess number: \nnSignal code: ",
2562 "Send the process with number PID the signal with code CODE.\n\
2563Both PID and CODE are integers.")
2564 (pid, sig)
2565 Lisp_Object pid, sig;
2566{
2567 CHECK_NUMBER (pid, 0);
2568 CHECK_NUMBER (sig, 1);
2569 return make_number (kill (XINT (pid), XINT (sig)));
2570}
2571
2572DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
2573 "Make PROCESS see end-of-file in its input.\n\
2574Eof comes after any text already sent to it.\n\
ebb9e16f
JB
2575PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2576nil, indicating the current buffer's process.")
d0d6b7c5
JB
2577 (process)
2578 Lisp_Object process;
2579{
2580 Lisp_Object proc;
2581
2582 proc = get_process (process);
577d03d5
RS
2583
2584 /* Make sure the process is really alive. */
2585 if (! NILP (XPROCESS (proc)->raw_status_low))
2586 update_status (XPROCESS (proc));
2587 if (! EQ (XPROCESS (proc)->status, Qrun))
dcf970e6 2588 error ("Process %s not running", XSTRING (XPROCESS (proc)->name)->data);
577d03d5 2589
d0d6b7c5
JB
2590 /* Sending a zero-length record is supposed to mean eof
2591 when TIOCREMOTE is turned on. */
2592#ifdef DID_REMOTE
2593 {
2594 char buf[1];
2595 write (XFASTINT (XPROCESS (proc)->outfd), buf, 0);
2596 }
2597#else /* did not do TOICREMOTE */
2598#ifdef VMS
2599 send_process (proc, "\032", 1); /* ^z */
2600#else
2601 if (!NILP (XPROCESS (proc)->pty_flag))
2602 send_process (proc, "\004", 1);
2603 else
2604 {
2605 close (XPROCESS (proc)->outfd);
5437e9f9 2606 XFASTINT (XPROCESS (proc)->outfd) = open (NULL_DEVICE, O_WRONLY);
d0d6b7c5
JB
2607 }
2608#endif /* VMS */
2609#endif /* did not do TOICREMOTE */
2610 return process;
2611}
2612
2613/* Kill all processes associated with `buffer'.
2614 If `buffer' is nil, kill all processes */
2615
2616kill_buffer_processes (buffer)
2617 Lisp_Object buffer;
2618{
2619 Lisp_Object tail, proc;
2620
2621 for (tail = Vprocess_alist; XGCTYPE (tail) == Lisp_Cons;
2622 tail = XCONS (tail)->cdr)
2623 {
2624 proc = XCONS (XCONS (tail)->car)->cdr;
2625 if (XGCTYPE (proc) == Lisp_Process
2626 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
2627 {
2628 if (NETCONN_P (proc))
2629 deactivate_process (proc);
2630 else if (XFASTINT (XPROCESS (proc)->infd))
2631 process_send_signal (proc, SIGHUP, Qnil, 1);
2632 }
2633 }
2634}
2635\f
2636/* On receipt of a signal that a child status has changed,
2637 loop asking about children with changed statuses until
2638 the system says there are no more.
2639 All we do is change the status;
2640 we do not run sentinels or print notifications.
2641 That is saved for the next time keyboard input is done,
2642 in order to avoid timing errors. */
2643
2644/** WARNING: this can be called during garbage collection.
2645 Therefore, it must not be fooled by the presence of mark bits in
2646 Lisp objects. */
2647
2648/** USG WARNING: Although it is not obvious from the documentation
2649 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2650 signal() before executing at least one wait(), otherwise the handler
2651 will be called again, resulting in an infinite loop. The relevant
2652 portion of the documentation reads "SIGCLD signals will be queued
2653 and the signal-catching function will be continually reentered until
2654 the queue is empty". Invoking signal() causes the kernel to reexamine
2655 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2656
2657SIGTYPE
2658sigchld_handler (signo)
2659 int signo;
2660{
2661 int old_errno = errno;
2662 Lisp_Object proc;
2663 register struct Lisp_Process *p;
6be429b1 2664 extern EMACS_TIME *input_available_clear_time;
d0d6b7c5
JB
2665
2666#ifdef BSD4_1
2667 extern int sigheld;
2668 sigheld |= sigbit (SIGCHLD);
2669#endif
2670
2671 while (1)
2672 {
2673 register int pid;
2674 WAITTYPE w;
2675 Lisp_Object tail;
2676
2677#ifdef WNOHANG
2678#ifndef WUNTRACED
2679#define WUNTRACED 0
2680#endif /* no WUNTRACED */
2681 /* Keep trying to get a status until we get a definitive result. */
2682 do
2683 {
2684 errno = 0;
2685 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
2686 }
2687 while (pid <= 0 && errno == EINTR);
2688
2689 if (pid <= 0)
2690 {
2691 /* A real failure. We have done all our job, so return. */
2692
2693 /* USG systems forget handlers when they are used;
2694 must reestablish each time */
2695#ifdef USG
2696 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
2697#endif
2698#ifdef BSD4_1
2699 sigheld &= ~sigbit (SIGCHLD);
2700 sigrelse (SIGCHLD);
2701#endif
2702 errno = old_errno;
2703 return;
2704 }
2705#else
2706 pid = wait (&w);
2707#endif /* no WNOHANG */
2708
2709 /* Find the process that signaled us, and record its status. */
2710
2711 p = 0;
2712 for (tail = Vprocess_alist; XSYMBOL (tail) != XSYMBOL (Qnil); tail = XCONS (tail)->cdr)
2713 {
2714 proc = XCONS (XCONS (tail)->car)->cdr;
2715 p = XPROCESS (proc);
2716 if (EQ (p->childp, Qt) && XFASTINT (p->pid) == pid)
2717 break;
2718 p = 0;
2719 }
2720
2721 /* Look for an asynchronous process whose pid hasn't been filled
2722 in yet. */
2723 if (p == 0)
2724 for (tail = Vprocess_alist; XSYMBOL (tail) != XSYMBOL (Qnil); tail = XCONS (tail)->cdr)
2725 {
2726 proc = XCONS (XCONS (tail)->car)->cdr;
2727 p = XPROCESS (proc);
2728 if (XTYPE (p->pid) == Lisp_Int && XINT (p->pid) == -1)
2729 break;
2730 p = 0;
2731 }
2732
2733 /* Change the status of the process that was found. */
2734 if (p != 0)
2735 {
2736 union { int i; WAITTYPE wt; } u;
2737
2738 XSETINT (p->tick, ++process_tick);
2739 u.wt = w;
2740 XFASTINT (p->raw_status_low) = u.i & 0xffff;
2741 XFASTINT (p->raw_status_high) = u.i >> 16;
2742
2743 /* If process has terminated, stop waiting for its output. */
2744 if (WIFSIGNALED (w) || WIFEXITED (w))
f9738840
JB
2745 if (XFASTINT (p->infd))
2746 FD_CLR (XFASTINT (p->infd), &input_wait_mask);
6be429b1
JB
2747
2748 /* Tell wait_reading_process_input that it needs to wake up and
2749 look around. */
2750 if (input_available_clear_time)
2751 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
d0d6b7c5
JB
2752 }
2753
2754 /* There was no asynchronous process found for that id. Check
2755 if we have a synchronous process. */
2756 else
2757 {
2758 synch_process_alive = 0;
2759
2760 /* Report the status of the synchronous process. */
2761 if (WIFEXITED (w))
2762 synch_process_retcode = WRETCODE (w);
2763 else if (WIFSIGNALED (w))
b0310da4 2764#ifndef VMS
d0d6b7c5 2765 synch_process_death = sys_siglist[WTERMSIG (w)];
b0310da4
JB
2766#else
2767 synch_process_death = sys_errlist[WTERMSIG (w)];
2768#endif
6be429b1
JB
2769
2770 /* Tell wait_reading_process_input that it needs to wake up and
2771 look around. */
2772 if (input_available_clear_time)
2773 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
d0d6b7c5
JB
2774 }
2775
2776 /* On some systems, we must return right away.
2777 If any more processes want to signal us, we will
2778 get another signal.
2779 Otherwise (on systems that have WNOHANG), loop around
2780 to use up all the processes that have something to tell us. */
2781#if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2782#ifdef USG
2783 signal (signo, sigchld_handler);
2784#endif
2785 errno = old_errno;
2786 return;
2787#endif /* USG, but not HPUX with WNOHANG */
2788 }
2789}
2790\f
2791
2792static Lisp_Object
2793exec_sentinel_unwind (data)
2794 Lisp_Object data;
2795{
2796 XPROCESS (XCONS (data)->car)->sentinel = XCONS (data)->cdr;
2797 return Qnil;
2798}
2799
2800static void
2801exec_sentinel (proc, reason)
2802 Lisp_Object proc, reason;
2803{
2804 Lisp_Object sentinel;
2805 register struct Lisp_Process *p = XPROCESS (proc);
2806 int count = specpdl_ptr - specpdl;
2807
2808 sentinel = p->sentinel;
2809 if (NILP (sentinel))
2810 return;
2811
2812 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2813 assure that it gets restored no matter how the sentinel exits. */
2814 p->sentinel = Qnil;
2815 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
2816 /* Inhibit quit so that random quits don't screw up a running filter. */
2817 specbind (Qinhibit_quit, Qt);
2818 call2 (sentinel, proc, reason);
2819 unbind_to (count);
2820}
2821
2822/* Report all recent events of a change in process status
2823 (either run the sentinel or output a message).
2824 This is done while Emacs is waiting for keyboard input. */
2825
2826status_notify ()
2827{
2828 register Lisp_Object proc, buffer;
2829 Lisp_Object tail = Qnil;
2830 Lisp_Object msg = Qnil;
2831 struct gcpro gcpro1, gcpro2;
2832
2833 /* We need to gcpro tail; if read_process_output calls a filter
2834 which deletes a process and removes the cons to which tail points
2835 from Vprocess_alist, and then causes a GC, tail is an unprotected
2836 reference. */
2837 GCPRO2 (tail, msg);
2838
2839 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
2840 {
2841 Lisp_Object symbol;
2842 register struct Lisp_Process *p;
2843
2844 proc = Fcdr (Fcar (tail));
2845 p = XPROCESS (proc);
2846
2847 if (XINT (p->tick) != XINT (p->update_tick))
2848 {
2849 XSETINT (p->update_tick, XINT (p->tick));
2850
2851 /* If process is still active, read any output that remains. */
2852 if (XFASTINT (p->infd))
2853 while (read_process_output (proc, XFASTINT (p->infd)) > 0);
2854
2855 buffer = p->buffer;
2856
2857 /* Get the text to use for the message. */
2858 if (!NILP (p->raw_status_low))
2859 update_status (p);
2860 msg = status_message (p->status);
2861
2862 /* If process is terminated, deactivate it or delete it. */
2863 symbol = p->status;
2864 if (XTYPE (p->status) == Lisp_Cons)
2865 symbol = XCONS (p->status)->car;
2866
2867 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
2868 || EQ (symbol, Qclosed))
2869 {
2870 if (delete_exited_processes)
2871 remove_process (proc);
2872 else
2873 deactivate_process (proc);
2874 }
2875
2876 /* Now output the message suitably. */
2877 if (!NILP (p->sentinel))
2878 exec_sentinel (proc, msg);
2879 /* Don't bother with a message in the buffer
2880 when a process becomes runnable. */
2881 else if (!EQ (symbol, Qrun) && !NILP (buffer))
2882 {
2883 Lisp_Object ro = XBUFFER (buffer)->read_only;
2884 Lisp_Object tem;
2885 struct buffer *old = current_buffer;
2886 int opoint;
2887
2888 /* Avoid error if buffer is deleted
2889 (probably that's why the process is dead, too) */
2890 if (NILP (XBUFFER (buffer)->name))
2891 continue;
2892 Fset_buffer (buffer);
2893 opoint = point;
2894 /* Insert new output into buffer
2895 at the current end-of-output marker,
2896 thus preserving logical ordering of input and output. */
2897 if (XMARKER (p->mark)->buffer)
2898 SET_PT (marker_position (p->mark));
2899 else
2900 SET_PT (ZV);
2901 if (point <= opoint)
2902 opoint += XSTRING (msg)->size + XSTRING (p->name)->size + 10;
2903
2904 tem = current_buffer->read_only;
2905 current_buffer->read_only = Qnil;
2906 insert_string ("\nProcess ");
2907 Finsert (1, &p->name);
2908 insert_string (" ");
2909 Finsert (1, &msg);
2910 current_buffer->read_only = tem;
2911 Fset_marker (p->mark, make_number (point), p->buffer);
2912
2913 SET_PT (opoint);
2914 set_buffer_internal (old);
2915 }
2916 }
2917 } /* end for */
2918
2919 update_mode_lines++; /* in case buffers use %s in mode-line-format */
2920 redisplay_preserve_echo_area ();
2921
2922 update_tick = process_tick;
2923
2924 UNGCPRO;
2925}
2926\f
2927init_process ()
2928{
2929 register int i;
2930
2931#ifdef SIGCHLD
2932#ifndef CANNOT_DUMP
2933 if (! noninteractive || initialized)
2934#endif
2935 signal (SIGCHLD, sigchld_handler);
2936#endif
2937
2938 FD_ZERO (&input_wait_mask);
2939 FD_SET (0, &input_wait_mask);
2940 Vprocess_alist = Qnil;
2941 for (i = 0; i < MAXDESC; i++)
2942 {
2943 chan_process[i] = Qnil;
2944 proc_buffered_char[i] = -1;
2945 }
2946}
08564963 2947#if 0
d0d6b7c5
JB
2948DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 0, 1, 0,
2949 "Return the connection type of `PROCESS'. This can be nil (pipe),\n\
2950t or pty (pty) or stream (socket connection).")
2951 (process)
2952 Lisp_Object process;
2953{
2954 return XPROCESS (process)->type;
2955}
2956#endif
2957syms_of_process ()
2958{
d0d6b7c5
JB
2959#ifdef HAVE_SOCKETS
2960 stream_process = intern ("stream");
2961#endif
2962 Qprocessp = intern ("processp");
2963 staticpro (&Qprocessp);
2964 Qrun = intern ("run");
2965 staticpro (&Qrun);
2966 Qstop = intern ("stop");
2967 staticpro (&Qstop);
2968 Qsignal = intern ("signal");
2969 staticpro (&Qsignal);
2970
2971 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
2972 here again.
2973
2974 Qexit = intern ("exit");
2975 staticpro (&Qexit); */
2976
2977 Qopen = intern ("open");
2978 staticpro (&Qopen);
2979 Qclosed = intern ("closed");
2980 staticpro (&Qclosed);
2981
2982 staticpro (&Vprocess_alist);
2983
2984 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
2985 "*Non-nil means delete processes immediately when they exit.\n\
2986nil means don't delete them until `list-processes' is run.");
2987
2988 delete_exited_processes = 1;
2989
2990 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
2991 "Control type of device used to communicate with subprocesses.\n\
2992Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
2993pty's are not available, this variable will be ignored. The value takes\n\
2994effect when `start-process' is called.");
2995 Vprocess_connection_type = Qt;
2996
2997 defsubr (&Sprocessp);
2998 defsubr (&Sget_process);
2999 defsubr (&Sget_buffer_process);
3000 defsubr (&Sdelete_process);
3001 defsubr (&Sprocess_status);
3002 defsubr (&Sprocess_exit_status);
3003 defsubr (&Sprocess_id);
3004 defsubr (&Sprocess_name);
3005 defsubr (&Sprocess_command);
3006 defsubr (&Sset_process_buffer);
3007 defsubr (&Sprocess_buffer);
3008 defsubr (&Sprocess_mark);
3009 defsubr (&Sset_process_filter);
3010 defsubr (&Sprocess_filter);
3011 defsubr (&Sset_process_sentinel);
3012 defsubr (&Sprocess_sentinel);
3013 defsubr (&Sprocess_kill_without_query);
3014 defsubr (&Slist_processes);
3015 defsubr (&Sprocess_list);
3016 defsubr (&Sstart_process);
3017#ifdef HAVE_SOCKETS
3018 defsubr (&Sopen_network_stream);
3019#endif /* HAVE_SOCKETS */
3020 defsubr (&Saccept_process_output);
3021 defsubr (&Sprocess_send_region);
3022 defsubr (&Sprocess_send_string);
3023 defsubr (&Sinterrupt_process);
3024 defsubr (&Skill_process);
3025 defsubr (&Squit_process);
3026 defsubr (&Sstop_process);
3027 defsubr (&Scontinue_process);
3028 defsubr (&Sprocess_send_eof);
3029 defsubr (&Ssignal_process);
3030 defsubr (&Swaiting_for_user_input_p);
3031/* defsubr (&Sprocess_connection); */
3032}
3033
6720a7fb
JB
3034\f
3035#else /* not subprocesses */
3036
3037#include <sys/types.h>
3038#include <errno.h>
3039
3040#include "lisp.h"
3041#include "systime.h"
3042#include "termopts.h"
3043
ff11dfa1 3044extern int frame_garbaged;
6720a7fb
JB
3045
3046
3047/* As described above, except assuming that there are no subprocesses:
3048
3049 Wait for timeout to elapse and/or keyboard input to be available.
3050
3051 time_limit is:
3052 timeout in seconds, or
3053 zero for no limit, or
3054 -1 means gobble data immediately available but don't wait for any.
3055
f76475ad 3056 read_kbd is a Lisp_Object:
6720a7fb
JB
3057 0 to ignore keyboard input, or
3058 1 to return when input is available, or
3059 -1 means caller will actually read the input, so don't throw to
3060 the quit handler.
3061 We know that read_kbd will never be a Lisp_Process, since
3062 `subprocesses' isn't defined.
3063
3064 do_display != 0 means redisplay should be done to show subprocess
3065 output that arrives. This version of the function ignores it.
3066
f76475ad 3067 Return true iff we recieved input from any process. */
6720a7fb
JB
3068
3069int
3070wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
f76475ad
JB
3071 int time_limit, microsecs;
3072 Lisp_Object read_kbd;
3073 int do_display;
6720a7fb
JB
3074{
3075 EMACS_TIME end_time, timeout, *timeout_p;
3076 int waitchannels;
3077
3078 /* What does time_limit really mean? */
3079 if (time_limit || microsecs)
3080 {
3081 /* It's not infinite. */
3082 timeout_p = &timeout;
3083
3084 if (time_limit == -1)
3085 /* In fact, it's zero. */
3086 EMACS_SET_SECS_USECS (timeout, 0, 0);
3087 else
3088 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
3089
3090 /* How far in the future is that? */
3091 EMACS_GET_TIME (end_time);
3092 EMACS_ADD_TIME (end_time, end_time, timeout);
3093 }
3094 else
3095 /* It's infinite. */
3096 timeout_p = 0;
3097
3098 /* Turn off periodic alarms (in case they are in use)
3099 because the select emulator uses alarms. */
3100 stop_polling ();
3101
3102 for (;;)
3103 {
3104 int nfds;
3105
f76475ad 3106 waitchannels = XINT (read_kbd) ? 1 : 0;
6720a7fb
JB
3107
3108 /* If calling from keyboard input, do not quit
3109 since we want to return C-g as an input character.
3110 Otherwise, do pending quit if requested. */
f76475ad 3111 if (XINT (read_kbd) >= 0)
6720a7fb
JB
3112 QUIT;
3113
3114 if (timeout_p)
3115 {
3116 EMACS_GET_TIME (*timeout_p);
3117 EMACS_SUB_TIME (*timeout_p, end_time, *timeout_p);
3118 if (EMACS_TIME_NEG_P (*timeout_p))
3119 break;
3120 }
3121
3122 /* Cause C-g and alarm signals to take immediate action,
3123 and cause input available signals to zero out timeout. */
f76475ad 3124 if (XINT (read_kbd) < 0)
6720a7fb
JB
3125 set_waiting_for_input (&timeout);
3126
ff11dfa1 3127 /* If a frame has been newly mapped and needs updating,
6720a7fb 3128 reprocess its display stuff. */
ff11dfa1 3129 if (frame_garbaged)
6720a7fb
JB
3130 redisplay_preserve_echo_area ();
3131
f76475ad 3132 if (XINT (read_kbd) && detect_input_pending ())
6720a7fb
JB
3133 nfds = 0;
3134 else
3135 nfds = select (1, &waitchannels, 0, 0, timeout_p);
3136
3137 /* Make C-g and alarm signals set flags again */
3138 clear_waiting_for_input ();
3139
3140 /* If we woke up due to SIGWINCH, actually change size now. */
3141 do_pending_window_change ();
3142
3143 if (nfds == -1)
3144 {
3145 /* If the system call was interrupted, then go around the
3146 loop again. */
3147 if (errno == EINTR)
3148 waitchannels = 0;
3149 }
3150#ifdef sun
3151 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
3152 /* System sometimes fails to deliver SIGIO. */
3153 kill (getpid (), SIGIO);
3154#endif
f76475ad 3155 if (XINT (read_kbd) && interrupt_input && (waitchannels & 1))
6720a7fb
JB
3156 kill (0, SIGIO);
3157
3158 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3159 we should exit. */
3160 if (nfds >= 0)
3161 break;
3162 }
3163
a87b802f
JB
3164 start_polling ();
3165
6720a7fb
JB
3166 return 0;
3167}
3168
3169
3170DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
3171 "Return the (or, a) process associated with BUFFER.\n\
3172This copy of Emacs has not been built to support subprocesses, so this\n\
3173function always returns nil.")
3174 (name)
3175 register Lisp_Object name;
3176{
3177 return Qnil;
3178}
3179
3180/* Kill all processes associated with `buffer'.
3181 If `buffer' is nil, kill all processes.
3182 Since we have no subprocesses, this does nothing. */
3183
3184kill_buffer_processes (buffer)
3185 Lisp_Object buffer;
3186{
3187}
3188
3189init_process ()
3190{
3191}
3192
3193syms_of_process ()
3194{
3195 defsubr (&Sget_buffer_process);
3196}
3197
3198\f
3199#endif /* not subprocesses */