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