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