(create_process): Call setsid only if pty_flag.
[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 /* Make the pty's terminal the controlling terminal. */
1278 if (pty_flag)
1279 {
1280 setsid ();
1281 #ifdef TIOCSCTTY
1282 /* We ignore the return value
1283 because faith@cs.unc.edu says that is necessary on Linux. */
1284 ioctl (xforkin, TIOCSCTTY, 0);
1285 #endif
1286 }
1287 #else /* not HAVE_SETSID */
1288 #ifdef USG
1289 /* It's very important to call setpgrp here and no time
1290 afterwards. Otherwise, we lose our controlling tty which
1291 is set when we open the pty. */
1292 setpgrp ();
1293 #endif /* USG */
1294 #endif /* not HAVE_SETSID */
1295 #if defined (NTTYDISC) && defined (TIOCSETD)
1296 if (pty_flag && xforkin >= 0)
1297 {
1298 /* Use new line discipline. */
1299 int ldisc = NTTYDISC;
1300 if (ioctl (xforkin, TIOCSETD, &ldisc) < 0)
1301 write (1, "create_process/TIOCSETD failed\n", 31);
1302 }
1303 #endif
1304 #ifdef TIOCNOTTY
1305 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1306 can do TIOCSPGRP only to the process's controlling tty. */
1307 if (pty_flag)
1308 {
1309 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1310 I can't test it since I don't have 4.3. */
1311 int j = open ("/dev/tty", O_RDWR, 0);
1312 ioctl (j, TIOCNOTTY, 0);
1313 close (j);
1314 #ifndef USG
1315 /* In order to get a controlling terminal on some versions
1316 of BSD, it is necessary to put the process in pgrp 0
1317 before it opens the terminal. */
1318 setpgrp (0, 0);
1319 #endif
1320 }
1321 #endif /* TIOCNOTTY */
1322
1323 #if !defined (RTU) && !defined (UNIPLUS)
1324 /*** There is a suggestion that this ought to be a
1325 conditional on TIOCSPGRP. */
1326 /* Now close the pty (if we had it open) and reopen it.
1327 This makes the pty the controlling terminal of the subprocess. */
1328 if (pty_flag)
1329 {
1330 #ifdef SET_CHILD_PTY_PGRP
1331 int pgrp = getpid ();
1332 #endif
1333
1334 /* I wonder if close (open (pty_name, ...)) would work? */
1335 if (xforkin >= 0)
1336 close (xforkin);
1337 xforkout = xforkin = open (pty_name, O_RDWR, 0);
1338
1339 #ifdef SET_CHILD_PTY_PGRP
1340 ioctl (xforkin, TIOCSPGRP, &pgrp);
1341 ioctl (xforkout, TIOCSPGRP, &pgrp);
1342 #endif
1343
1344 if (xforkin < 0)
1345 abort ();
1346 }
1347 #endif /* not UNIPLUS and not RTU */
1348 #ifdef SETUP_SLAVE_PTY
1349 SETUP_SLAVE_PTY;
1350 #endif /* SETUP_SLAVE_PTY */
1351 #ifdef AIX
1352 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1353 Now reenable it in the child, so it will die when we want it to. */
1354 if (pty_flag)
1355 signal (SIGHUP, SIG_DFL);
1356 #endif
1357 #endif /* HAVE_PTYS */
1358
1359 #ifdef SIGCHLD
1360 #ifdef BSD4_1
1361 sigrelse (SIGCHLD);
1362 #else /* not BSD4_1 */
1363 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1364 sigsetmask (SIGEMPTYMASK);
1365 #else /* ordinary USG */
1366 #if 0
1367 signal (SIGCHLD, sigchld);
1368 #endif
1369 #endif /* ordinary USG */
1370 #endif /* not BSD4_1 */
1371 #endif /* SIGCHLD */
1372
1373 child_setup_tty (xforkout);
1374 child_setup (xforkin, xforkout, xforkout,
1375 new_argv, 1, current_dir);
1376 }
1377 environ = save_environ;
1378 }
1379
1380 if (pid < 0)
1381 report_file_error ("Doing vfork", Qnil);
1382
1383 XFASTINT (XPROCESS (process)->pid) = pid;
1384
1385 FD_SET (inchannel, &input_wait_mask);
1386
1387 /* If the subfork execv fails, and it exits,
1388 this close hangs. I don't know why.
1389 So have an interrupt jar it loose. */
1390 stop_polling ();
1391 signal (SIGALRM, create_process_1);
1392 alarm (1);
1393 XPROCESS (process)->subtty = Qnil;
1394 if (forkin >= 0)
1395 close (forkin);
1396 alarm (0);
1397 start_polling ();
1398 if (forkin != forkout && forkout >= 0)
1399 close (forkout);
1400
1401 #ifdef SIGCHLD
1402 #ifdef BSD4_1
1403 sigrelse (SIGCHLD);
1404 #else /* not BSD4_1 */
1405 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1406 sigsetmask (SIGEMPTYMASK);
1407 #else /* ordinary USG */
1408 #if 0
1409 signal (SIGCHLD, sigchld);
1410 /* Now really handle any of these signals
1411 that came in during this function. */
1412 if (sigchld_deferred)
1413 kill (getpid (), SIGCHLD);
1414 #endif
1415 #endif /* ordinary USG */
1416 #endif /* not BSD4_1 */
1417 #endif /* SIGCHLD */
1418 }
1419 #endif /* not VMS */
1420
1421 #ifdef HAVE_SOCKETS
1422
1423 /* open a TCP network connection to a given HOST/SERVICE. Treated
1424 exactly like a normal process when reading and writing. Only
1425 differences are in status display and process deletion. A network
1426 connection has no PID; you cannot signal it. All you can do is
1427 deactivate and close it via delete-process */
1428
1429 DEFUN ("open-network-stream", Fopen_network_stream, Sopen_network_stream,
1430 4, 4, 0,
1431 "Open a TCP connection for a service to a host.\n\
1432 Returns a subprocess-object to represent the connection.\n\
1433 Input and output work as for subprocesses; `delete-process' closes it.\n\
1434 Args are NAME BUFFER HOST SERVICE.\n\
1435 NAME is name for process. It is modified if necessary to make it unique.\n\
1436 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1437 Process output goes at end of that buffer, unless you specify\n\
1438 an output stream or filter function to handle the output.\n\
1439 BUFFER may be also nil, meaning that this process is not associated\n\
1440 with any buffer\n\
1441 Third arg is name of the host to connect to, or its IP address.\n\
1442 Fourth arg SERVICE is name of the service desired, or an integer\n\
1443 specifying a port number to connect to.")
1444 (name, buffer, host, service)
1445 Lisp_Object name, buffer, host, service;
1446 {
1447 Lisp_Object proc;
1448 register int i;
1449 struct sockaddr_in address;
1450 struct servent *svc_info;
1451 struct hostent *host_info_ptr, host_info;
1452 char *(addr_list[2]);
1453 IN_ADDR numeric_addr;
1454 int s, outch, inch;
1455 char errstring[80];
1456 int port;
1457 struct hostent host_info_fixed;
1458 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1459
1460 GCPRO4 (name, buffer, host, service);
1461 CHECK_STRING (name, 0);
1462 CHECK_STRING (host, 0);
1463 if (XTYPE(service) == Lisp_Int)
1464 port = htons ((unsigned short) XINT (service));
1465 else
1466 {
1467 CHECK_STRING (service, 0);
1468 svc_info = getservbyname (XSTRING (service)->data, "tcp");
1469 if (svc_info == 0)
1470 error ("Unknown service \"%s\"", XSTRING (service)->data);
1471 port = svc_info->s_port;
1472 }
1473
1474 #ifndef TERM
1475 host_info_ptr = gethostbyname (XSTRING (host)->data);
1476 if (host_info_ptr == 0)
1477 /* Attempt to interpret host as numeric inet address */
1478 {
1479 numeric_addr = inet_addr ((char *) XSTRING (host)->data);
1480 if (NUMERIC_ADDR_ERROR)
1481 error ("Unknown host \"%s\"", XSTRING (host)->data);
1482
1483 host_info_ptr = &host_info;
1484 host_info.h_name = 0;
1485 host_info.h_aliases = 0;
1486 host_info.h_addrtype = AF_INET;
1487 #ifdef h_addr
1488 /* Older machines have only one address slot called h_addr.
1489 Newer machines have h_addr_list, but #define h_addr to
1490 be its first element. */
1491 host_info.h_addr_list = &(addr_list[0]);
1492 #endif
1493 host_info.h_addr = (char*)(&numeric_addr);
1494 addr_list[1] = 0;
1495 host_info.h_length = strlen (addr_list[0]);
1496 }
1497
1498 bzero (&address, sizeof address);
1499 bcopy (host_info_ptr->h_addr, (char *) &address.sin_addr,
1500 host_info_ptr->h_length);
1501 address.sin_family = host_info_ptr->h_addrtype;
1502 address.sin_port = port;
1503
1504 s = socket (host_info_ptr->h_addrtype, SOCK_STREAM, 0);
1505 if (s < 0)
1506 report_file_error ("error creating socket", Fcons (name, Qnil));
1507
1508 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1509 when connect is interrupted. So let's not let it get interrupted.
1510 Note we do not turn off polling, because polling is only used
1511 when not interrupt_input, and thus not normally used on the systems
1512 which have this bug. On systems which use polling, there's no way
1513 to quit if polling is turned off. */
1514 if (interrupt_input)
1515 unrequest_sigio ();
1516
1517 loop:
1518 if (connect (s, (struct sockaddr *) &address, sizeof address) == -1)
1519 {
1520 int xerrno = errno;
1521 if (errno == EINTR)
1522 goto loop;
1523 close (s);
1524
1525 if (interrupt_input)
1526 request_sigio ();
1527
1528 errno = xerrno;
1529 report_file_error ("connection failed",
1530 Fcons (host, Fcons (name, Qnil)));
1531 }
1532
1533 if (interrupt_input)
1534 request_sigio ();
1535
1536 #else /* TERM */
1537 s = connect_server (0);
1538 if (s < 0)
1539 report_file_error ("error creating socket", Fcons (name, Qnil));
1540 send_command (s, C_PORT, 0, "%s:%d", XSTRING (host)->data, ntohs (port));
1541 send_command (s, C_DUMB, 1, 0);
1542 #endif /* TERM */
1543
1544 inch = s;
1545 outch = dup (s);
1546 if (outch < 0)
1547 report_file_error ("error duplicating socket", Fcons (name, Qnil));
1548
1549 if (!NILP (buffer))
1550 buffer = Fget_buffer_create (buffer);
1551 proc = make_process (name);
1552
1553 chan_process[inch] = proc;
1554
1555 #ifdef O_NONBLOCK
1556 fcntl (inch, F_SETFL, O_NONBLOCK);
1557 #else
1558 #ifdef O_NDELAY
1559 fcntl (inch, F_SETFL, O_NDELAY);
1560 #endif
1561 #endif
1562
1563 XPROCESS (proc)->childp = host;
1564 XPROCESS (proc)->command_channel_p = Qnil;
1565 XPROCESS (proc)->buffer = buffer;
1566 XPROCESS (proc)->sentinel = Qnil;
1567 XPROCESS (proc)->filter = Qnil;
1568 XPROCESS (proc)->command = Qnil;
1569 XPROCESS (proc)->pid = Qnil;
1570 XSET (XPROCESS (proc)->infd, Lisp_Int, s);
1571 XSET (XPROCESS (proc)->outfd, Lisp_Int, outch);
1572 XPROCESS (proc)->status = Qrun;
1573 FD_SET (inch, &input_wait_mask);
1574
1575 UNGCPRO;
1576 return proc;
1577 }
1578 #endif /* HAVE_SOCKETS */
1579
1580 deactivate_process (proc)
1581 Lisp_Object proc;
1582 {
1583 register int inchannel, outchannel;
1584 register struct Lisp_Process *p = XPROCESS (proc);
1585
1586 inchannel = XINT (p->infd);
1587 outchannel = XINT (p->outfd);
1588
1589 if (inchannel >= 0)
1590 {
1591 /* Beware SIGCHLD hereabouts. */
1592 flush_pending_output (inchannel);
1593 #ifdef VMS
1594 {
1595 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
1596 sys$dassgn (outchannel);
1597 vs = get_vms_process_pointer (p->pid);
1598 if (vs)
1599 give_back_vms_process_stuff (vs);
1600 }
1601 #else
1602 close (inchannel);
1603 if (outchannel >= 0 && outchannel != inchannel)
1604 close (outchannel);
1605 #endif
1606
1607 XSET (p->infd, Lisp_Int, -1);
1608 XSET (p->outfd, Lisp_Int, -1);
1609 chan_process[inchannel] = Qnil;
1610 FD_CLR (inchannel, &input_wait_mask);
1611 }
1612 }
1613
1614 /* Close all descriptors currently in use for communication
1615 with subprocess. This is used in a newly-forked subprocess
1616 to get rid of irrelevant descriptors. */
1617
1618 close_process_descs ()
1619 {
1620 int i;
1621 for (i = 0; i < MAXDESC; i++)
1622 {
1623 Lisp_Object process;
1624 process = chan_process[i];
1625 if (!NILP (process))
1626 {
1627 int in = XINT (XPROCESS (process)->infd);
1628 int out = XINT (XPROCESS (process)->outfd);
1629 if (in >= 0)
1630 close (in);
1631 if (out >= 0 && in != out)
1632 close (out);
1633 }
1634 }
1635 }
1636 \f
1637 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
1638 0, 3, 0,
1639 "Allow any pending output from subprocesses to be read by Emacs.\n\
1640 It is read into the process' buffers or given to their filter functions.\n\
1641 Non-nil arg PROCESS means do not return until some output has been received\n\
1642 from PROCESS.\n\
1643 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1644 seconds and microseconds to wait; return after that much time whether\n\
1645 or not there is input.\n\
1646 Return non-nil iff we received any output before the timeout expired.")
1647 (proc, timeout, timeout_msecs)
1648 register Lisp_Object proc, timeout, timeout_msecs;
1649 {
1650 int seconds;
1651 int useconds;
1652
1653 if (! NILP (timeout_msecs))
1654 {
1655 CHECK_NUMBER (timeout_msecs, 2);
1656 useconds = XINT (timeout_msecs);
1657 if (XTYPE (timeout) != Lisp_Int)
1658 XSET (timeout, Lisp_Int, 0);
1659
1660 {
1661 int carry = useconds / 1000000;
1662
1663 XSETINT (timeout, XINT (timeout) + carry);
1664 useconds -= carry * 1000000;
1665
1666 /* I think this clause is necessary because C doesn't
1667 guarantee a particular rounding direction for negative
1668 integers. */
1669 if (useconds < 0)
1670 {
1671 XSETINT (timeout, XINT (timeout) - 1);
1672 useconds += 1000000;
1673 }
1674 }
1675 }
1676 else
1677 useconds = 0;
1678
1679 if (! NILP (timeout))
1680 {
1681 CHECK_NUMBER (timeout, 1);
1682 seconds = XINT (timeout);
1683 if (seconds <= 0)
1684 seconds = -1;
1685 }
1686 else
1687 {
1688 if (NILP (proc))
1689 seconds = -1;
1690 else
1691 seconds = 0;
1692 }
1693
1694 if (NILP (proc))
1695 XFASTINT (proc) = 0;
1696
1697 return
1698 (wait_reading_process_input (seconds, useconds, proc, 0)
1699 ? Qt : Qnil);
1700 }
1701
1702 /* This variable is different from waiting_for_input in keyboard.c.
1703 It is used to communicate to a lisp process-filter/sentinel (via the
1704 function Fwaiting_for_user_input_p below) whether emacs was waiting
1705 for user-input when that process-filter was called.
1706 waiting_for_input cannot be used as that is by definition 0 when
1707 lisp code is being evalled */
1708 static int waiting_for_user_input_p;
1709
1710 /* Read and dispose of subprocess output while waiting for timeout to
1711 elapse and/or keyboard input to be available.
1712
1713 TIME_LIMIT is:
1714 timeout in seconds, or
1715 zero for no limit, or
1716 -1 means gobble data immediately available but don't wait for any.
1717
1718 MICROSECS is:
1719 an additional duration to wait, measured in microseconds.
1720 If this is nonzero and time_limit is 0, then the timeout
1721 consists of MICROSECS only.
1722
1723 READ_KBD is a lisp value:
1724 0 to ignore keyboard input, or
1725 1 to return when input is available, or
1726 -1 meaning caller will actually read the input, so don't throw to
1727 the quit handler, or
1728 a cons cell, meaning wait until its car is non-nil
1729 (and gobble terminal input into the buffer if any arrives), or
1730 a process object, meaning wait until something arrives from that
1731 process. The return value is true iff we read some input from
1732 that process.
1733
1734 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1735 output that arrives.
1736
1737 If READ_KBD is a pointer to a struct Lisp_Process, then the
1738 function returns true iff we received input from that process
1739 before the timeout elapsed.
1740 Otherwise, return true iff we received input from any process. */
1741
1742 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
1743 int time_limit, microsecs;
1744 Lisp_Object read_kbd;
1745 int do_display;
1746 {
1747 register int channel, nfds, m;
1748 static SELECT_TYPE Available;
1749 int xerrno;
1750 Lisp_Object proc;
1751 EMACS_TIME timeout, end_time, garbage;
1752 SELECT_TYPE Atemp;
1753 int wait_channel = -1;
1754 struct Lisp_Process *wait_proc = 0;
1755 int got_some_input = 0;
1756 Lisp_Object *wait_for_cell = 0;
1757
1758 FD_ZERO (&Available);
1759
1760 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1761 accordingly. */
1762 if (XTYPE (read_kbd) == Lisp_Process)
1763 {
1764 wait_proc = XPROCESS (read_kbd);
1765 wait_channel = XINT (wait_proc->infd);
1766 XFASTINT (read_kbd) = 0;
1767 }
1768
1769 /* If waiting for non-nil in a cell, record where. */
1770 if (XTYPE (read_kbd) == Lisp_Cons)
1771 {
1772 wait_for_cell = &XCONS (read_kbd)->car;
1773 XFASTINT (read_kbd) = 0;
1774 }
1775
1776 waiting_for_user_input_p = XINT (read_kbd);
1777
1778 /* Since we may need to wait several times,
1779 compute the absolute time to return at. */
1780 if (time_limit || microsecs)
1781 {
1782 EMACS_GET_TIME (end_time);
1783 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
1784 EMACS_ADD_TIME (end_time, end_time, timeout);
1785 }
1786
1787 /* It would not be safe to call this below,
1788 where we call redisplay_preserve_echo_area. */
1789 prepare_menu_bars ();
1790
1791 while (1)
1792 {
1793 /* If calling from keyboard input, do not quit
1794 since we want to return C-g as an input character.
1795 Otherwise, do pending quit if requested. */
1796 if (XINT (read_kbd) >= 0)
1797 QUIT;
1798
1799 /* Exit now if the cell we're waiting for became non-nil. */
1800 if (wait_for_cell && ! NILP (*wait_for_cell))
1801 break;
1802
1803 /* Compute time from now till when time limit is up */
1804 /* Exit if already run out */
1805 if (time_limit == -1)
1806 {
1807 /* -1 specified for timeout means
1808 gobble output available now
1809 but don't wait at all. */
1810
1811 EMACS_SET_SECS_USECS (timeout, 0, 0);
1812 }
1813 else if (time_limit || microsecs)
1814 {
1815 EMACS_GET_TIME (timeout);
1816 EMACS_SUB_TIME (timeout, end_time, timeout);
1817 if (EMACS_TIME_NEG_P (timeout))
1818 break;
1819 }
1820 else
1821 {
1822 EMACS_SET_SECS_USECS (timeout, 100000, 0);
1823 }
1824
1825 /* Cause C-g and alarm signals to take immediate action,
1826 and cause input available signals to zero out timeout.
1827
1828 It is important that we do this before checking for process
1829 activity. If we get a SIGCHLD after the explicit checks for
1830 process activity, timeout is the only way we will know. */
1831 if (XINT (read_kbd) < 0)
1832 set_waiting_for_input (&timeout);
1833
1834 /* If status of something has changed, and no input is
1835 available, notify the user of the change right away. After
1836 this explicit check, we'll let the SIGCHLD handler zap
1837 timeout to get our attention. */
1838 if (update_tick != process_tick && do_display)
1839 {
1840 Atemp = input_wait_mask;
1841 EMACS_SET_SECS_USECS (timeout, 0, 0);
1842 if (select (MAXDESC, &Atemp, 0, 0, &timeout) <= 0)
1843 {
1844 /* It's okay for us to do this and then continue with
1845 the loop, since timeout has already been zeroed out. */
1846 clear_waiting_for_input ();
1847 status_notify ();
1848 }
1849 }
1850
1851 /* Don't wait for output from a non-running process. */
1852 if (wait_proc != 0 && !NILP (wait_proc->raw_status_low))
1853 update_status (wait_proc);
1854 if (wait_proc != 0
1855 && ! EQ (wait_proc->status, Qrun))
1856 {
1857 clear_waiting_for_input ();
1858 break;
1859 }
1860
1861 /* Wait till there is something to do */
1862
1863 Available = input_wait_mask;
1864 /* We used to have && wait_for_cell == 0
1865 but that led to lossage handling selection_request events:
1866 within one, we would start to handle another. */
1867 if (! XINT (read_kbd))
1868 FD_CLR (keyboard_descriptor, &Available);
1869
1870 /* If frame size has changed or the window is newly mapped,
1871 redisplay now, before we start to wait. There is a race
1872 condition here; if a SIGIO arrives between now and the select
1873 and indicates that a frame is trashed, the select may block
1874 displaying a trashed screen. */
1875 if (frame_garbaged && do_display)
1876 redisplay_preserve_echo_area ();
1877
1878 if (XINT (read_kbd) && detect_input_pending ())
1879 {
1880 nfds = 0;
1881 FD_ZERO (&Available);
1882 }
1883 else
1884 nfds = select (MAXDESC, &Available, 0, 0, &timeout);
1885
1886 xerrno = errno;
1887
1888 /* Make C-g and alarm signals set flags again */
1889 clear_waiting_for_input ();
1890
1891 /* If we woke up due to SIGWINCH, actually change size now. */
1892 do_pending_window_change ();
1893
1894 if (time_limit && nfds == 0) /* timeout elapsed */
1895 break;
1896 if (nfds < 0)
1897 {
1898 if (xerrno == EINTR)
1899 FD_ZERO (&Available);
1900 #ifdef ultrix
1901 /* Ultrix select seems to return ENOMEM when it is
1902 interrupted. Treat it just like EINTR. Bleah. Note
1903 that we want to test for the "ultrix" CPP symbol, not
1904 "__ultrix__"; the latter is only defined under GCC, but
1905 not by DEC's bundled CC. -JimB */
1906 else if (xerrno == ENOMEM)
1907 FD_ZERO (&Available);
1908 #endif
1909 #ifdef ALLIANT
1910 /* This happens for no known reason on ALLIANT.
1911 I am guessing that this is the right response. -- RMS. */
1912 else if (xerrno == EFAULT)
1913 FD_ZERO (&Available);
1914 #endif
1915 else if (xerrno == EBADF)
1916 {
1917 #ifdef AIX
1918 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1919 the child's closure of the pts gives the parent a SIGHUP, and
1920 the ptc file descriptor is automatically closed,
1921 yielding EBADF here or at select() call above.
1922 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1923 in m/ibmrt-aix.h), and here we just ignore the select error.
1924 Cleanup occurs c/o status_notify after SIGCLD. */
1925 FD_ZERO (&Available); /* Cannot depend on values returned */
1926 #else
1927 abort ();
1928 #endif
1929 }
1930 else
1931 error("select error: %s", strerror (xerrno));
1932 }
1933 #if defined(sun) && !defined(USG5_4)
1934 else if (nfds > 0 && FD_ISSET (keyboard_descriptor, &Available)
1935 && interrupt_input)
1936 /* System sometimes fails to deliver SIGIO.
1937
1938 David J. Mackenzie says that Emacs doesn't compile under
1939 Solaris if this code is enabled, thus the USG5_4 in the CPP
1940 conditional. "I haven't noticed any ill effects so far.
1941 If you find a Solaris expert somewhere, they might know
1942 better." */
1943 kill (getpid (), SIGIO);
1944 #endif
1945
1946 /* Check for keyboard input */
1947 /* If there is any, return immediately
1948 to give it higher priority than subprocesses */
1949
1950 /* We used to do this if wait_for_cell,
1951 but that caused infinite recursion in selection request events. */
1952 if ((XINT (read_kbd))
1953 && detect_input_pending ())
1954 {
1955 swallow_events ();
1956 if (detect_input_pending ())
1957 break;
1958 }
1959
1960 /* Exit now if the cell we're waiting for became non-nil. */
1961 if (wait_for_cell && ! NILP (*wait_for_cell))
1962 break;
1963
1964 #ifdef SIGIO
1965 /* If we think we have keyboard input waiting, but didn't get SIGIO
1966 go read it. This can happen with X on BSD after logging out.
1967 In that case, there really is no input and no SIGIO,
1968 but select says there is input. */
1969
1970 if (XINT (read_kbd) && interrupt_input
1971 && (FD_ISSET (keyboard_descriptor, &Available)))
1972 kill (0, SIGIO);
1973 #endif
1974
1975 if (! wait_proc)
1976 got_some_input |= nfds > 0;
1977
1978 /* If checking input just got us a size-change event from X,
1979 obey it now if we should. */
1980 if (XINT (read_kbd) || wait_for_cell)
1981 do_pending_window_change ();
1982
1983 /* Check for data from a process. */
1984 /* Really FIRST_PROC_DESC should be 0 on Unix,
1985 but this is safer in the short run. */
1986 for (channel = keyboard_descriptor == 0 ? FIRST_PROC_DESC : 0;
1987 channel < MAXDESC; channel++)
1988 {
1989 if (FD_ISSET (channel, &Available))
1990 {
1991 int nread;
1992
1993 /* If waiting for this channel, arrange to return as
1994 soon as no more input to be processed. No more
1995 waiting. */
1996 if (wait_channel == channel)
1997 {
1998 wait_channel = -1;
1999 time_limit = -1;
2000 got_some_input = 1;
2001 }
2002 proc = chan_process[channel];
2003 if (NILP (proc))
2004 continue;
2005
2006 /* Read data from the process, starting with our
2007 buffered-ahead character if we have one. */
2008
2009 nread = read_process_output (proc, channel);
2010 if (nread > 0)
2011 {
2012 /* Since read_process_output can run a filter,
2013 which can call accept-process-output,
2014 don't try to read from any other processes
2015 before doing the select again. */
2016 FD_ZERO (&Available);
2017
2018 if (do_display)
2019 redisplay_preserve_echo_area ();
2020 }
2021 #ifdef EWOULDBLOCK
2022 else if (nread == -1 && errno == EWOULDBLOCK)
2023 ;
2024 #else
2025 #ifdef O_NONBLOCK
2026 else if (nread == -1 && errno == EAGAIN)
2027 ;
2028 #else
2029 #ifdef O_NDELAY
2030 else if (nread == -1 && errno == EAGAIN)
2031 ;
2032 /* Note that we cannot distinguish between no input
2033 available now and a closed pipe.
2034 With luck, a closed pipe will be accompanied by
2035 subprocess termination and SIGCHLD. */
2036 else if (nread == 0 && !NETCONN_P (proc))
2037 ;
2038 #endif /* O_NDELAY */
2039 #endif /* O_NONBLOCK */
2040 #endif /* EWOULDBLOCK */
2041 #ifdef HAVE_PTYS
2042 /* On some OSs with ptys, when the process on one end of
2043 a pty exits, the other end gets an error reading with
2044 errno = EIO instead of getting an EOF (0 bytes read).
2045 Therefore, if we get an error reading and errno =
2046 EIO, just continue, because the child process has
2047 exited and should clean itself up soon (e.g. when we
2048 get a SIGCHLD). */
2049 else if (nread == -1 && errno == EIO)
2050 ;
2051 #endif /* HAVE_PTYS */
2052 /* If we can detect process termination, don't consider the process
2053 gone just because its pipe is closed. */
2054 #ifdef SIGCHLD
2055 else if (nread == 0 && !NETCONN_P (proc))
2056 ;
2057 #endif
2058 else
2059 {
2060 /* Preserve status of processes already terminated. */
2061 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2062 deactivate_process (proc);
2063 if (!NILP (XPROCESS (proc)->raw_status_low))
2064 update_status (XPROCESS (proc));
2065 if (EQ (XPROCESS (proc)->status, Qrun))
2066 XPROCESS (proc)->status
2067 = Fcons (Qexit, Fcons (make_number (256), Qnil));
2068 }
2069 }
2070 } /* end for each file descriptor */
2071 } /* end while exit conditions not met */
2072
2073 /* If calling from keyboard input, do not quit
2074 since we want to return C-g as an input character.
2075 Otherwise, do pending quit if requested. */
2076 if (XINT (read_kbd) >= 0)
2077 {
2078 /* Prevent input_pending from remaining set if we quit. */
2079 clear_input_pending ();
2080 QUIT;
2081 }
2082
2083 return got_some_input;
2084 }
2085 \f
2086 /* Read pending output from the process channel,
2087 starting with our buffered-ahead character if we have one.
2088 Yield number of characters read.
2089
2090 This function reads at most 1024 characters.
2091 If you want to read all available subprocess output,
2092 you must call it repeatedly until it returns zero. */
2093
2094 read_process_output (proc, channel)
2095 Lisp_Object proc;
2096 register int channel;
2097 {
2098 register int nchars;
2099 #ifdef VMS
2100 char *chars;
2101 #else
2102 char chars[1024];
2103 #endif
2104 register Lisp_Object outstream;
2105 register struct buffer *old = current_buffer;
2106 register struct Lisp_Process *p = XPROCESS (proc);
2107 register int opoint;
2108
2109 #ifdef VMS
2110 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2111
2112 vs = get_vms_process_pointer (p->pid);
2113 if (vs)
2114 {
2115 if (!vs->iosb[0])
2116 return(0); /* Really weird if it does this */
2117 if (!(vs->iosb[0] & 1))
2118 return -1; /* I/O error */
2119 }
2120 else
2121 error ("Could not get VMS process pointer");
2122 chars = vs->inputBuffer;
2123 nchars = clean_vms_buffer (chars, vs->iosb[1]);
2124 if (nchars <= 0)
2125 {
2126 start_vms_process_read (vs); /* Crank up the next read on the process */
2127 return 1; /* Nothing worth printing, say we got 1 */
2128 }
2129 #else /* not VMS */
2130
2131 if (proc_buffered_char[channel] < 0)
2132 nchars = read (channel, chars, sizeof chars);
2133 else
2134 {
2135 chars[0] = proc_buffered_char[channel];
2136 proc_buffered_char[channel] = -1;
2137 nchars = read (channel, chars + 1, sizeof chars - 1);
2138 if (nchars < 0)
2139 nchars = 1;
2140 else
2141 nchars = nchars + 1;
2142 }
2143 #endif /* not VMS */
2144
2145 if (nchars <= 0) return nchars;
2146
2147 outstream = p->filter;
2148 if (!NILP (outstream))
2149 {
2150 /* We inhibit quit here instead of just catching it so that
2151 hitting ^G when a filter happens to be running won't screw
2152 it up. */
2153 int count = specpdl_ptr - specpdl;
2154 Lisp_Object odeactivate;
2155 Lisp_Object obuffer;
2156
2157 odeactivate = Vdeactivate_mark;
2158 obuffer = Fcurrent_buffer ();
2159
2160 specbind (Qinhibit_quit, Qt);
2161 call2 (outstream, proc, make_string (chars, nchars));
2162
2163 /* Handling the process output should not deactivate the mark. */
2164 Vdeactivate_mark = odeactivate;
2165
2166 if (! EQ (Fcurrent_buffer (), obuffer))
2167 record_asynch_buffer_change ();
2168
2169 #ifdef VMS
2170 start_vms_process_read (vs);
2171 #endif
2172 unbind_to (count, Qnil);
2173 return nchars;
2174 }
2175
2176 /* If no filter, write into buffer if it isn't dead. */
2177 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
2178 {
2179 Lisp_Object old_read_only;
2180 Lisp_Object old_begv, old_zv;
2181 Lisp_Object odeactivate;
2182
2183 odeactivate = Vdeactivate_mark;
2184
2185 Fset_buffer (p->buffer);
2186 opoint = point;
2187 old_read_only = current_buffer->read_only;
2188 XFASTINT (old_begv) = BEGV;
2189 XFASTINT (old_zv) = ZV;
2190
2191 current_buffer->read_only = Qnil;
2192
2193 /* Insert new output into buffer
2194 at the current end-of-output marker,
2195 thus preserving logical ordering of input and output. */
2196 if (XMARKER (p->mark)->buffer)
2197 SET_PT (clip_to_bounds (BEGV, marker_position (p->mark), ZV));
2198 else
2199 SET_PT (ZV);
2200
2201 /* If the output marker is outside of the visible region, save
2202 the restriction and widen. */
2203 if (! (BEGV <= point && point <= ZV))
2204 Fwiden ();
2205
2206 /* Make sure opoint floats ahead of any new text, just as point
2207 would. */
2208 if (point <= opoint)
2209 opoint += nchars;
2210
2211 /* Insert after old_begv, but before old_zv. */
2212 if (point < XFASTINT (old_begv))
2213 XFASTINT (old_begv) += nchars;
2214 if (point <= XFASTINT (old_zv))
2215 XFASTINT (old_zv) += nchars;
2216
2217 /* Insert before markers in case we are inserting where
2218 the buffer's mark is, and the user's next command is Meta-y. */
2219 insert_before_markers (chars, nchars);
2220 Fset_marker (p->mark, make_number (point), p->buffer);
2221
2222 update_mode_lines++;
2223
2224 /* If the restriction isn't what it should be, set it. */
2225 if (XFASTINT (old_begv) != BEGV || XFASTINT (old_zv) != ZV)
2226 Fnarrow_to_region (old_begv, old_zv);
2227
2228 /* Handling the process output should not deactivate the mark. */
2229 Vdeactivate_mark = odeactivate;
2230
2231 current_buffer->read_only = old_read_only;
2232 SET_PT (opoint);
2233 set_buffer_internal (old);
2234 }
2235 #ifdef VMS
2236 start_vms_process_read (vs);
2237 #endif
2238 return nchars;
2239 }
2240
2241 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
2242 0, 0, 0,
2243 "Returns non-NIL if emacs is waiting for input from the user.\n\
2244 This is intended for use by asynchronous process output filters and sentinels.")
2245 ()
2246 {
2247 return ((waiting_for_user_input_p) ? Qt : Qnil);
2248 }
2249 \f
2250 /* Sending data to subprocess */
2251
2252 jmp_buf send_process_frame;
2253
2254 SIGTYPE
2255 send_process_trap ()
2256 {
2257 #ifdef BSD4_1
2258 sigrelse (SIGPIPE);
2259 sigrelse (SIGALRM);
2260 #endif /* BSD4_1 */
2261 longjmp (send_process_frame, 1);
2262 }
2263
2264 send_process (proc, buf, len)
2265 Lisp_Object proc;
2266 char *buf;
2267 int len;
2268 {
2269 /* Don't use register vars; longjmp can lose them. */
2270 int rv;
2271 unsigned char *procname = XSTRING (XPROCESS (proc)->name)->data;
2272
2273
2274 #ifdef VMS
2275 struct Lisp_Process *p = XPROCESS (proc);
2276 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2277 #endif /* VMS */
2278
2279 if (! NILP (XPROCESS (proc)->raw_status_low))
2280 update_status (XPROCESS (proc));
2281 if (! EQ (XPROCESS (proc)->status, Qrun))
2282 error ("Process %s not running", procname);
2283
2284 #ifdef VMS
2285 vs = get_vms_process_pointer (p->pid);
2286 if (vs == 0)
2287 error ("Could not find this process: %x", p->pid);
2288 else if (write_to_vms_process (vs, buf, len))
2289 ;
2290 #else
2291 if (!setjmp (send_process_frame))
2292 while (len > 0)
2293 {
2294 int this = len;
2295 SIGTYPE (*old_sigpipe)();
2296 int flush_pty = 0;
2297
2298 if (pty_max_bytes == 0)
2299 {
2300 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2301 pty_max_bytes = fpathconf (XFASTINT (XPROCESS (proc)->outfd),
2302 _PC_MAX_CANON);
2303 #else
2304 pty_max_bytes = 250;
2305 #endif
2306 }
2307
2308 /* Don't send more than pty_max_bytes bytes at a time. */
2309 /* Subtract 1 to leave room for the EOF. */
2310 if (this >= pty_max_bytes && !NILP (XPROCESS (proc)->pty_flag))
2311 this = pty_max_bytes - 1;
2312
2313 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
2314 rv = write (XINT (XPROCESS (proc)->outfd), buf, this);
2315
2316 /* If we sent just part of the string, put in an EOF
2317 to force it through, before we send the rest. */
2318 if (this < len)
2319 Fprocess_send_eof (proc);
2320
2321 signal (SIGPIPE, old_sigpipe);
2322 if (rv < 0)
2323 {
2324 if (0
2325 #ifdef EWOULDBLOCK
2326 || errno == EWOULDBLOCK
2327 #endif
2328 #ifdef EAGAIN
2329 || errno == EAGAIN
2330 #endif
2331 )
2332 {
2333 /* It would be nice to accept process output here,
2334 but that is difficult. For example, it could
2335 garbage what we are sending if that is from a buffer. */
2336 immediate_quit = 1;
2337 QUIT;
2338 sleep (1);
2339 immediate_quit = 0;
2340 continue;
2341 }
2342 report_file_error ("writing to process", Fcons (proc, Qnil));
2343 }
2344 buf += rv;
2345 len -= rv;
2346 /* Allow input from processes between bursts of sending.
2347 Otherwise things may get stopped up. */
2348 if (len > 0)
2349 {
2350 Lisp_Object zero;
2351
2352 XFASTINT (zero) = 0;
2353 wait_reading_process_input (-1, 0, zero, 0);
2354 }
2355 }
2356 #endif
2357 else
2358 {
2359 XPROCESS (proc)->raw_status_low = Qnil;
2360 XPROCESS (proc)->raw_status_high = Qnil;
2361 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
2362 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2363 deactivate_process (proc);
2364 #ifdef VMS
2365 error ("Error writing to process %s; closed it", procname);
2366 #else
2367 error ("SIGPIPE raised on process %s; closed it", procname);
2368 #endif
2369 }
2370 }
2371
2372 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
2373 3, 3, 0,
2374 "Send current contents of region as input to PROCESS.\n\
2375 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2376 nil, indicating the current buffer's process.\n\
2377 Called from program, takes three arguments, PROCESS, START and END.\n\
2378 If the region is more than 500 characters long,\n\
2379 it is sent in several bunches. This may happen even for shorter regions.\n\
2380 Output from processes can arrive in between bunches.")
2381 (process, start, end)
2382 Lisp_Object process, start, end;
2383 {
2384 Lisp_Object proc;
2385 int start1;
2386
2387 proc = get_process (process);
2388 validate_region (&start, &end);
2389
2390 if (XINT (start) < GPT && XINT (end) > GPT)
2391 move_gap (start);
2392
2393 start1 = XINT (start);
2394 send_process (proc, &FETCH_CHAR (start1), XINT (end) - XINT (start));
2395
2396 return Qnil;
2397 }
2398
2399 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
2400 2, 2, 0,
2401 "Send PROCESS the contents of STRING as input.\n\
2402 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2403 nil, indicating the current buffer's process.\n\
2404 If STRING is more than 500 characters long,\n\
2405 it is sent in several bunches. This may happen even for shorter strings.\n\
2406 Output from processes can arrive in between bunches.")
2407 (process, string)
2408 Lisp_Object process, string;
2409 {
2410 Lisp_Object proc;
2411 CHECK_STRING (string, 1);
2412 proc = get_process (process);
2413 send_process (proc, XSTRING (string)->data, XSTRING (string)->size);
2414 return Qnil;
2415 }
2416 \f
2417 /* send a signal number SIGNO to PROCESS.
2418 CURRENT_GROUP means send to the process group that currently owns
2419 the terminal being used to communicate with PROCESS.
2420 This is used for various commands in shell mode.
2421 If NOMSG is zero, insert signal-announcements into process's buffers
2422 right away.
2423
2424 If we can, we try to signal PROCESS by sending control characters
2425 down the pipe. This allows us to signal inferiors who have changed
2426 their uid, for which killpg would return an EPERM error. */
2427
2428 static void
2429 process_send_signal (process, signo, current_group, nomsg)
2430 Lisp_Object process;
2431 int signo;
2432 Lisp_Object current_group;
2433 int nomsg;
2434 {
2435 Lisp_Object proc;
2436 register struct Lisp_Process *p;
2437 int gid;
2438 int no_pgrp = 0;
2439
2440 proc = get_process (process);
2441 p = XPROCESS (proc);
2442
2443 if (!EQ (p->childp, Qt))
2444 error ("Process %s is not a subprocess",
2445 XSTRING (p->name)->data);
2446 if (XINT (p->infd) < 0)
2447 error ("Process %s is not active",
2448 XSTRING (p->name)->data);
2449
2450 if (NILP (p->pty_flag))
2451 current_group = Qnil;
2452
2453 /* If we are using pgrps, get a pgrp number and make it negative. */
2454 if (!NILP (current_group))
2455 {
2456 #ifdef SIGNALS_VIA_CHARACTERS
2457 /* If possible, send signals to the entire pgrp
2458 by sending an input character to it. */
2459
2460 /* TERMIOS is the latest and bestest, and seems most likely to
2461 work. If the system has it, use it. */
2462 #ifdef HAVE_TERMIOS
2463 struct termios t;
2464
2465 switch (signo)
2466 {
2467 case SIGINT:
2468 tcgetattr (XINT (p->infd), &t);
2469 send_process (proc, &t.c_cc[VINTR], 1);
2470 return;
2471
2472 case SIGQUIT:
2473 tcgetattr (XINT (p->infd), &t);
2474 send_process (proc, &t.c_cc[VQUIT], 1);
2475 return;
2476
2477 case SIGTSTP:
2478 tcgetattr (XINT (p->infd), &t);
2479 #if defined (VSWTCH) && !defined (IRIX5)
2480 send_process (proc, &t.c_cc[VSWTCH], 1);
2481 #else
2482 send_process (proc, &t.c_cc[VSUSP], 1);
2483 #endif
2484 return;
2485 }
2486
2487 #else /* ! HAVE_TERMIOS */
2488
2489 /* On Berkeley descendants, the following IOCTL's retrieve the
2490 current control characters. */
2491 #if defined (TIOCGLTC) && defined (TIOCGETC)
2492
2493 struct tchars c;
2494 struct ltchars lc;
2495
2496 switch (signo)
2497 {
2498 case SIGINT:
2499 ioctl (XINT (p->infd), TIOCGETC, &c);
2500 send_process (proc, &c.t_intrc, 1);
2501 return;
2502 case SIGQUIT:
2503 ioctl (XINT (p->infd), TIOCGETC, &c);
2504 send_process (proc, &c.t_quitc, 1);
2505 return;
2506 #ifdef SIGTSTP
2507 case SIGTSTP:
2508 ioctl (XINT (p->infd), TIOCGLTC, &lc);
2509 send_process (proc, &lc.t_suspc, 1);
2510 return;
2511 #endif /* ! defined (SIGTSTP) */
2512 }
2513
2514 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2515
2516 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2517 characters. */
2518 #ifdef TCGETA
2519 struct termio t;
2520 switch (signo)
2521 {
2522 case SIGINT:
2523 ioctl (XINT (p->infd), TCGETA, &t);
2524 send_process (proc, &t.c_cc[VINTR], 1);
2525 return;
2526 case SIGQUIT:
2527 ioctl (XINT (p->infd), TCGETA, &t);
2528 send_process (proc, &t.c_cc[VQUIT], 1);
2529 return;
2530 #ifdef SIGTSTP
2531 case SIGTSTP:
2532 ioctl (XINT (p->infd), TCGETA, &t);
2533 send_process (proc, &t.c_cc[VSWTCH], 1);
2534 return;
2535 #endif /* ! defined (SIGTSTP) */
2536 }
2537 #else /* ! defined (TCGETA) */
2538 Your configuration files are messed up.
2539 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2540 you'd better be using one of the alternatives above! */
2541 #endif /* ! defined (TCGETA) */
2542 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2543 #endif /* ! defined HAVE_TERMIOS */
2544 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2545
2546 #ifdef TIOCGPGRP
2547 /* Get the pgrp using the tty itself, if we have that.
2548 Otherwise, use the pty to get the pgrp.
2549 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2550 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2551 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2552 His patch indicates that if TIOCGPGRP returns an error, then
2553 we should just assume that p->pid is also the process group id. */
2554 {
2555 int err;
2556
2557 if (!NILP (p->subtty))
2558 err = ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
2559 else
2560 err = ioctl (XINT (p->infd), TIOCGPGRP, &gid);
2561
2562 #ifdef pfa
2563 if (err == -1)
2564 gid = - XFASTINT (p->pid);
2565 #endif /* ! defined (pfa) */
2566 }
2567 if (gid == -1)
2568 no_pgrp = 1;
2569 else
2570 gid = - gid;
2571 #else /* ! defined (TIOCGPGRP ) */
2572 /* Can't select pgrps on this system, so we know that
2573 the child itself heads the pgrp. */
2574 gid = - XFASTINT (p->pid);
2575 #endif /* ! defined (TIOCGPGRP ) */
2576 }
2577 else
2578 gid = - XFASTINT (p->pid);
2579
2580 switch (signo)
2581 {
2582 #ifdef SIGCONT
2583 case SIGCONT:
2584 p->raw_status_low = Qnil;
2585 p->raw_status_high = Qnil;
2586 p->status = Qrun;
2587 XSETINT (p->tick, ++process_tick);
2588 if (!nomsg)
2589 status_notify ();
2590 break;
2591 #endif /* ! defined (SIGCONT) */
2592 case SIGINT:
2593 #ifdef VMS
2594 send_process (proc, "\003", 1); /* ^C */
2595 goto whoosh;
2596 #endif
2597 case SIGQUIT:
2598 #ifdef VMS
2599 send_process (proc, "\031", 1); /* ^Y */
2600 goto whoosh;
2601 #endif
2602 case SIGKILL:
2603 #ifdef VMS
2604 sys$forcex (&(XFASTINT (p->pid)), 0, 1);
2605 whoosh:
2606 #endif
2607 flush_pending_output (XINT (p->infd));
2608 break;
2609 }
2610
2611 /* If we don't have process groups, send the signal to the immediate
2612 subprocess. That isn't really right, but it's better than any
2613 obvious alternative. */
2614 if (no_pgrp)
2615 {
2616 kill (XFASTINT (p->pid), signo);
2617 return;
2618 }
2619
2620 /* gid may be a pid, or minus a pgrp's number */
2621 #ifdef TIOCSIGSEND
2622 if (!NILP (current_group))
2623 ioctl (XINT (p->infd), TIOCSIGSEND, signo);
2624 else
2625 {
2626 gid = - XFASTINT (p->pid);
2627 kill (gid, signo);
2628 }
2629 #else /* ! defined (TIOCSIGSEND) */
2630 EMACS_KILLPG (-gid, signo);
2631 #endif /* ! defined (TIOCSIGSEND) */
2632 }
2633
2634 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
2635 "Interrupt process PROCESS. May be process or name of one.\n\
2636 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2637 Nil or no arg means current buffer's process.\n\
2638 Second arg CURRENT-GROUP non-nil means send signal to\n\
2639 the current process-group of the process's controlling terminal\n\
2640 rather than to the process's own process group.\n\
2641 If the process is a shell, this means interrupt current subjob\n\
2642 rather than the shell.")
2643 (process, current_group)
2644 Lisp_Object process, current_group;
2645 {
2646 process_send_signal (process, SIGINT, current_group, 0);
2647 return process;
2648 }
2649
2650 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
2651 "Kill process PROCESS. May be process or name of one.\n\
2652 See function `interrupt-process' for more details on usage.")
2653 (process, current_group)
2654 Lisp_Object process, current_group;
2655 {
2656 process_send_signal (process, SIGKILL, current_group, 0);
2657 return process;
2658 }
2659
2660 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
2661 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2662 See function `interrupt-process' for more details on usage.")
2663 (process, current_group)
2664 Lisp_Object process, current_group;
2665 {
2666 process_send_signal (process, SIGQUIT, current_group, 0);
2667 return process;
2668 }
2669
2670 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
2671 "Stop process PROCESS. May be process or name of one.\n\
2672 See function `interrupt-process' for more details on usage.")
2673 (process, current_group)
2674 Lisp_Object process, current_group;
2675 {
2676 #ifndef SIGTSTP
2677 error ("no SIGTSTP support");
2678 #else
2679 process_send_signal (process, SIGTSTP, current_group, 0);
2680 #endif
2681 return process;
2682 }
2683
2684 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
2685 "Continue process PROCESS. May be process or name of one.\n\
2686 See function `interrupt-process' for more details on usage.")
2687 (process, current_group)
2688 Lisp_Object process, current_group;
2689 {
2690 #ifdef SIGCONT
2691 process_send_signal (process, SIGCONT, current_group, 0);
2692 #else
2693 error ("no SIGCONT support");
2694 #endif
2695 return process;
2696 }
2697
2698 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
2699 2, 2, "nProcess number: \nnSignal code: ",
2700 "Send the process with number PID the signal with code CODE.\n\
2701 Both PID and CODE are integers.")
2702 (pid, sig)
2703 Lisp_Object pid, sig;
2704 {
2705 CHECK_NUMBER (pid, 0);
2706 CHECK_NUMBER (sig, 1);
2707 return make_number (kill (XINT (pid), XINT (sig)));
2708 }
2709
2710 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
2711 "Make PROCESS see end-of-file in its input.\n\
2712 Eof comes after any text already sent to it.\n\
2713 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2714 nil, indicating the current buffer's process.")
2715 (process)
2716 Lisp_Object process;
2717 {
2718 Lisp_Object proc;
2719
2720 proc = get_process (process);
2721
2722 /* Make sure the process is really alive. */
2723 if (! NILP (XPROCESS (proc)->raw_status_low))
2724 update_status (XPROCESS (proc));
2725 if (! EQ (XPROCESS (proc)->status, Qrun))
2726 error ("Process %s not running", XSTRING (XPROCESS (proc)->name)->data);
2727
2728 /* Sending a zero-length record is supposed to mean eof
2729 when TIOCREMOTE is turned on. */
2730 #ifdef DID_REMOTE
2731 {
2732 char buf[1];
2733 write (XINT (XPROCESS (proc)->outfd), buf, 0);
2734 }
2735 #else /* did not do TOICREMOTE */
2736 #ifdef VMS
2737 send_process (proc, "\032", 1); /* ^z */
2738 #else
2739 if (!NILP (XPROCESS (proc)->pty_flag))
2740 send_process (proc, "\004", 1);
2741 else
2742 {
2743 close (XINT (XPROCESS (proc)->outfd));
2744 XSET (XPROCESS (proc)->outfd, Lisp_Int, open (NULL_DEVICE, O_WRONLY));
2745 }
2746 #endif /* VMS */
2747 #endif /* did not do TOICREMOTE */
2748 return process;
2749 }
2750
2751 /* Kill all processes associated with `buffer'.
2752 If `buffer' is nil, kill all processes */
2753
2754 kill_buffer_processes (buffer)
2755 Lisp_Object buffer;
2756 {
2757 Lisp_Object tail, proc;
2758
2759 for (tail = Vprocess_alist; XGCTYPE (tail) == Lisp_Cons;
2760 tail = XCONS (tail)->cdr)
2761 {
2762 proc = XCONS (XCONS (tail)->car)->cdr;
2763 if (XGCTYPE (proc) == Lisp_Process
2764 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
2765 {
2766 if (NETCONN_P (proc))
2767 deactivate_process (proc);
2768 else if (XINT (XPROCESS (proc)->infd) >= 0)
2769 process_send_signal (proc, SIGHUP, Qnil, 1);
2770 }
2771 }
2772 }
2773 \f
2774 /* On receipt of a signal that a child status has changed,
2775 loop asking about children with changed statuses until
2776 the system says there are no more.
2777 All we do is change the status;
2778 we do not run sentinels or print notifications.
2779 That is saved for the next time keyboard input is done,
2780 in order to avoid timing errors. */
2781
2782 /** WARNING: this can be called during garbage collection.
2783 Therefore, it must not be fooled by the presence of mark bits in
2784 Lisp objects. */
2785
2786 /** USG WARNING: Although it is not obvious from the documentation
2787 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2788 signal() before executing at least one wait(), otherwise the handler
2789 will be called again, resulting in an infinite loop. The relevant
2790 portion of the documentation reads "SIGCLD signals will be queued
2791 and the signal-catching function will be continually reentered until
2792 the queue is empty". Invoking signal() causes the kernel to reexamine
2793 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2794
2795 SIGTYPE
2796 sigchld_handler (signo)
2797 int signo;
2798 {
2799 int old_errno = errno;
2800 Lisp_Object proc;
2801 register struct Lisp_Process *p;
2802 extern EMACS_TIME *input_available_clear_time;
2803
2804 #ifdef BSD4_1
2805 extern int sigheld;
2806 sigheld |= sigbit (SIGCHLD);
2807 #endif
2808
2809 while (1)
2810 {
2811 register int pid;
2812 WAITTYPE w;
2813 Lisp_Object tail;
2814
2815 #ifdef WNOHANG
2816 #ifndef WUNTRACED
2817 #define WUNTRACED 0
2818 #endif /* no WUNTRACED */
2819 /* Keep trying to get a status until we get a definitive result. */
2820 do
2821 {
2822 errno = 0;
2823 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
2824 }
2825 while (pid <= 0 && errno == EINTR);
2826
2827 if (pid <= 0)
2828 {
2829 /* A real failure. We have done all our job, so return. */
2830
2831 /* USG systems forget handlers when they are used;
2832 must reestablish each time */
2833 #ifdef USG
2834 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
2835 #endif
2836 #ifdef BSD4_1
2837 sigheld &= ~sigbit (SIGCHLD);
2838 sigrelse (SIGCHLD);
2839 #endif
2840 errno = old_errno;
2841 return;
2842 }
2843 #else
2844 pid = wait (&w);
2845 #endif /* no WNOHANG */
2846
2847 /* Find the process that signaled us, and record its status. */
2848
2849 p = 0;
2850 for (tail = Vprocess_alist; XSYMBOL (tail) != XSYMBOL (Qnil); tail = XCONS (tail)->cdr)
2851 {
2852 proc = XCONS (XCONS (tail)->car)->cdr;
2853 p = XPROCESS (proc);
2854 if (EQ (p->childp, Qt) && XFASTINT (p->pid) == pid)
2855 break;
2856 p = 0;
2857 }
2858
2859 /* Look for an asynchronous process whose pid hasn't been filled
2860 in yet. */
2861 if (p == 0)
2862 for (tail = Vprocess_alist; XSYMBOL (tail) != XSYMBOL (Qnil); tail = XCONS (tail)->cdr)
2863 {
2864 proc = XCONS (XCONS (tail)->car)->cdr;
2865 p = XPROCESS (proc);
2866 if (XTYPE (p->pid) == Lisp_Int && XINT (p->pid) == -1)
2867 break;
2868 p = 0;
2869 }
2870
2871 /* Change the status of the process that was found. */
2872 if (p != 0)
2873 {
2874 union { int i; WAITTYPE wt; } u;
2875
2876 XSETINT (p->tick, ++process_tick);
2877 u.wt = w;
2878 XFASTINT (p->raw_status_low) = u.i & 0xffff;
2879 XFASTINT (p->raw_status_high) = u.i >> 16;
2880
2881 /* If process has terminated, stop waiting for its output. */
2882 if (WIFSIGNALED (w) || WIFEXITED (w))
2883 if (XINT (p->infd) >= 0)
2884 FD_CLR (XINT (p->infd), &input_wait_mask);
2885
2886 /* Tell wait_reading_process_input that it needs to wake up and
2887 look around. */
2888 if (input_available_clear_time)
2889 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
2890 }
2891
2892 /* There was no asynchronous process found for that id. Check
2893 if we have a synchronous process. */
2894 else
2895 {
2896 synch_process_alive = 0;
2897
2898 /* Report the status of the synchronous process. */
2899 if (WIFEXITED (w))
2900 synch_process_retcode = WRETCODE (w);
2901 else if (WIFSIGNALED (w))
2902 {
2903 int code = WTERMSIG (w);
2904 char *signame = 0;
2905
2906 if (code < NSIG)
2907 {
2908 #ifndef VMS
2909 signame = sys_siglist[code];
2910 #else
2911 signame = sys_errlist[code];
2912 #endif
2913 }
2914 if (signame == 0)
2915 signame = "unknown";
2916
2917 synch_process_death = signame;
2918 }
2919
2920 /* Tell wait_reading_process_input that it needs to wake up and
2921 look around. */
2922 if (input_available_clear_time)
2923 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
2924 }
2925
2926 /* On some systems, we must return right away.
2927 If any more processes want to signal us, we will
2928 get another signal.
2929 Otherwise (on systems that have WNOHANG), loop around
2930 to use up all the processes that have something to tell us. */
2931 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2932 #ifdef USG
2933 signal (signo, sigchld_handler);
2934 #endif
2935 errno = old_errno;
2936 return;
2937 #endif /* USG, but not HPUX with WNOHANG */
2938 }
2939 }
2940 \f
2941
2942 static Lisp_Object
2943 exec_sentinel_unwind (data)
2944 Lisp_Object data;
2945 {
2946 XPROCESS (XCONS (data)->car)->sentinel = XCONS (data)->cdr;
2947 return Qnil;
2948 }
2949
2950 static void
2951 exec_sentinel (proc, reason)
2952 Lisp_Object proc, reason;
2953 {
2954 Lisp_Object sentinel;
2955 register struct Lisp_Process *p = XPROCESS (proc);
2956 int count = specpdl_ptr - specpdl;
2957
2958 sentinel = p->sentinel;
2959 if (NILP (sentinel))
2960 return;
2961
2962 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2963 assure that it gets restored no matter how the sentinel exits. */
2964 p->sentinel = Qnil;
2965 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
2966 /* Inhibit quit so that random quits don't screw up a running filter. */
2967 specbind (Qinhibit_quit, Qt);
2968 call2 (sentinel, proc, reason);
2969 unbind_to (count, Qnil);
2970 }
2971
2972 /* Report all recent events of a change in process status
2973 (either run the sentinel or output a message).
2974 This is done while Emacs is waiting for keyboard input. */
2975
2976 status_notify ()
2977 {
2978 register Lisp_Object proc, buffer;
2979 Lisp_Object tail, msg;
2980 struct gcpro gcpro1, gcpro2;
2981
2982 tail = Qnil;
2983 msg = Qnil;
2984 /* We need to gcpro tail; if read_process_output calls a filter
2985 which deletes a process and removes the cons to which tail points
2986 from Vprocess_alist, and then causes a GC, tail is an unprotected
2987 reference. */
2988 GCPRO2 (tail, msg);
2989
2990 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
2991 {
2992 Lisp_Object symbol;
2993 register struct Lisp_Process *p;
2994
2995 proc = Fcdr (Fcar (tail));
2996 p = XPROCESS (proc);
2997
2998 if (XINT (p->tick) != XINT (p->update_tick))
2999 {
3000 XSETINT (p->update_tick, XINT (p->tick));
3001
3002 /* If process is still active, read any output that remains. */
3003 if (XINT (p->infd) >= 0)
3004 while (! EQ (p->filter, Qt)
3005 && read_process_output (proc, XINT (p->infd)) > 0);
3006
3007 buffer = p->buffer;
3008
3009 /* Get the text to use for the message. */
3010 if (!NILP (p->raw_status_low))
3011 update_status (p);
3012 msg = status_message (p->status);
3013
3014 /* If process is terminated, deactivate it or delete it. */
3015 symbol = p->status;
3016 if (XTYPE (p->status) == Lisp_Cons)
3017 symbol = XCONS (p->status)->car;
3018
3019 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
3020 || EQ (symbol, Qclosed))
3021 {
3022 if (delete_exited_processes)
3023 remove_process (proc);
3024 else
3025 deactivate_process (proc);
3026 }
3027
3028 /* Now output the message suitably. */
3029 if (!NILP (p->sentinel))
3030 exec_sentinel (proc, msg);
3031 /* Don't bother with a message in the buffer
3032 when a process becomes runnable. */
3033 else if (!EQ (symbol, Qrun) && !NILP (buffer))
3034 {
3035 Lisp_Object ro, tem;
3036 struct buffer *old = current_buffer;
3037 int opoint;
3038
3039 ro = XBUFFER (buffer)->read_only;
3040
3041 /* Avoid error if buffer is deleted
3042 (probably that's why the process is dead, too) */
3043 if (NILP (XBUFFER (buffer)->name))
3044 continue;
3045 Fset_buffer (buffer);
3046 opoint = point;
3047 /* Insert new output into buffer
3048 at the current end-of-output marker,
3049 thus preserving logical ordering of input and output. */
3050 if (XMARKER (p->mark)->buffer)
3051 SET_PT (marker_position (p->mark));
3052 else
3053 SET_PT (ZV);
3054 if (point <= opoint)
3055 opoint += XSTRING (msg)->size + XSTRING (p->name)->size + 10;
3056
3057 tem = current_buffer->read_only;
3058 current_buffer->read_only = Qnil;
3059 insert_string ("\nProcess ");
3060 Finsert (1, &p->name);
3061 insert_string (" ");
3062 Finsert (1, &msg);
3063 current_buffer->read_only = tem;
3064 Fset_marker (p->mark, make_number (point), p->buffer);
3065
3066 SET_PT (opoint);
3067 set_buffer_internal (old);
3068 }
3069 }
3070 } /* end for */
3071
3072 update_mode_lines++; /* in case buffers use %s in mode-line-format */
3073 redisplay_preserve_echo_area ();
3074
3075 update_tick = process_tick;
3076
3077 UNGCPRO;
3078 }
3079 \f
3080 init_process ()
3081 {
3082 register int i;
3083
3084 #ifdef SIGCHLD
3085 #ifndef CANNOT_DUMP
3086 if (! noninteractive || initialized)
3087 #endif
3088 signal (SIGCHLD, sigchld_handler);
3089 #endif
3090
3091 FD_ZERO (&input_wait_mask);
3092
3093 keyboard_descriptor = 0;
3094 FD_SET (keyboard_descriptor, &input_wait_mask);
3095
3096 Vprocess_alist = Qnil;
3097 for (i = 0; i < MAXDESC; i++)
3098 {
3099 chan_process[i] = Qnil;
3100 proc_buffered_char[i] = -1;
3101 }
3102 }
3103
3104 /* From now on, assume keyboard input comes from descriptor DESC. */
3105
3106 void
3107 change_keyboard_wait_descriptor (desc)
3108 int desc;
3109 {
3110 FD_CLR (keyboard_descriptor, &input_wait_mask);
3111 keyboard_descriptor = desc;
3112 FD_SET (keyboard_descriptor, &input_wait_mask);
3113 }
3114
3115 syms_of_process ()
3116 {
3117 #ifdef HAVE_SOCKETS
3118 stream_process = intern ("stream");
3119 #endif
3120 Qprocessp = intern ("processp");
3121 staticpro (&Qprocessp);
3122 Qrun = intern ("run");
3123 staticpro (&Qrun);
3124 Qstop = intern ("stop");
3125 staticpro (&Qstop);
3126 Qsignal = intern ("signal");
3127 staticpro (&Qsignal);
3128
3129 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3130 here again.
3131
3132 Qexit = intern ("exit");
3133 staticpro (&Qexit); */
3134
3135 Qopen = intern ("open");
3136 staticpro (&Qopen);
3137 Qclosed = intern ("closed");
3138 staticpro (&Qclosed);
3139
3140 staticpro (&Vprocess_alist);
3141
3142 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
3143 "*Non-nil means delete processes immediately when they exit.\n\
3144 nil means don't delete them until `list-processes' is run.");
3145
3146 delete_exited_processes = 1;
3147
3148 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
3149 "Control type of device used to communicate with subprocesses.\n\
3150 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3151 pty's are not available, this variable will be ignored. The value takes\n\
3152 effect when `start-process' is called.");
3153 Vprocess_connection_type = Qt;
3154
3155 defsubr (&Sprocessp);
3156 defsubr (&Sget_process);
3157 defsubr (&Sget_buffer_process);
3158 defsubr (&Sdelete_process);
3159 defsubr (&Sprocess_status);
3160 defsubr (&Sprocess_exit_status);
3161 defsubr (&Sprocess_id);
3162 defsubr (&Sprocess_name);
3163 defsubr (&Sprocess_command);
3164 defsubr (&Sset_process_buffer);
3165 defsubr (&Sprocess_buffer);
3166 defsubr (&Sprocess_mark);
3167 defsubr (&Sset_process_filter);
3168 defsubr (&Sprocess_filter);
3169 defsubr (&Sset_process_sentinel);
3170 defsubr (&Sset_process_window_size);
3171 defsubr (&Sprocess_sentinel);
3172 defsubr (&Sprocess_kill_without_query);
3173 defsubr (&Slist_processes);
3174 defsubr (&Sprocess_list);
3175 defsubr (&Sstart_process);
3176 #ifdef HAVE_SOCKETS
3177 defsubr (&Sopen_network_stream);
3178 #endif /* HAVE_SOCKETS */
3179 defsubr (&Saccept_process_output);
3180 defsubr (&Sprocess_send_region);
3181 defsubr (&Sprocess_send_string);
3182 defsubr (&Sinterrupt_process);
3183 defsubr (&Skill_process);
3184 defsubr (&Squit_process);
3185 defsubr (&Sstop_process);
3186 defsubr (&Scontinue_process);
3187 defsubr (&Sprocess_send_eof);
3188 defsubr (&Ssignal_process);
3189 defsubr (&Swaiting_for_user_input_p);
3190 /* defsubr (&Sprocess_connection); */
3191 }
3192
3193 \f
3194 #else /* not subprocesses */
3195
3196 #include <sys/types.h>
3197 #include <errno.h>
3198
3199 #include "lisp.h"
3200 #include "systime.h"
3201 #include "termopts.h"
3202
3203 extern int frame_garbaged;
3204
3205
3206 /* As described above, except assuming that there are no subprocesses:
3207
3208 Wait for timeout to elapse and/or keyboard input to be available.
3209
3210 time_limit is:
3211 timeout in seconds, or
3212 zero for no limit, or
3213 -1 means gobble data immediately available but don't wait for any.
3214
3215 read_kbd is a Lisp_Object:
3216 0 to ignore keyboard input, or
3217 1 to return when input is available, or
3218 -1 means caller will actually read the input, so don't throw to
3219 the quit handler.
3220 We know that read_kbd will never be a Lisp_Process, since
3221 `subprocesses' isn't defined.
3222
3223 do_display != 0 means redisplay should be done to show subprocess
3224 output that arrives.
3225
3226 Return true iff we received input from any process. */
3227
3228 int
3229 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
3230 int time_limit, microsecs;
3231 Lisp_Object read_kbd;
3232 int do_display;
3233 {
3234 EMACS_TIME end_time, timeout, *timeout_p;
3235 int waitchannels;
3236
3237 /* What does time_limit really mean? */
3238 if (time_limit || microsecs)
3239 {
3240 /* It's not infinite. */
3241 timeout_p = &timeout;
3242
3243 if (time_limit == -1)
3244 /* In fact, it's zero. */
3245 EMACS_SET_SECS_USECS (timeout, 0, 0);
3246 else
3247 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
3248
3249 /* How far in the future is that? */
3250 EMACS_GET_TIME (end_time);
3251 EMACS_ADD_TIME (end_time, end_time, timeout);
3252 }
3253 else
3254 /* It's infinite. */
3255 timeout_p = 0;
3256
3257 /* This must come before stop_polling. */
3258 prepare_menu_bars ();
3259
3260 /* Turn off periodic alarms (in case they are in use)
3261 because the select emulator uses alarms. */
3262 stop_polling ();
3263
3264 for (;;)
3265 {
3266 int nfds;
3267
3268 waitchannels = XINT (read_kbd) ? 1 : 0;
3269
3270 /* If calling from keyboard input, do not quit
3271 since we want to return C-g as an input character.
3272 Otherwise, do pending quit if requested. */
3273 if (XINT (read_kbd) >= 0)
3274 QUIT;
3275
3276 if (timeout_p)
3277 {
3278 EMACS_GET_TIME (*timeout_p);
3279 EMACS_SUB_TIME (*timeout_p, end_time, *timeout_p);
3280 if (EMACS_TIME_NEG_P (*timeout_p))
3281 break;
3282 }
3283
3284 /* Cause C-g and alarm signals to take immediate action,
3285 and cause input available signals to zero out timeout. */
3286 if (XINT (read_kbd) < 0)
3287 set_waiting_for_input (&timeout);
3288
3289 /* If a frame has been newly mapped and needs updating,
3290 reprocess its display stuff. */
3291 if (frame_garbaged && do_display)
3292 redisplay_preserve_echo_area ();
3293
3294 if (XINT (read_kbd) && detect_input_pending ())
3295 nfds = 0;
3296 else
3297 nfds = select (1, &waitchannels, 0, 0, timeout_p);
3298
3299 /* Make C-g and alarm signals set flags again */
3300 clear_waiting_for_input ();
3301
3302 /* If we woke up due to SIGWINCH, actually change size now. */
3303 do_pending_window_change ();
3304
3305 if (nfds == -1)
3306 {
3307 /* If the system call was interrupted, then go around the
3308 loop again. */
3309 if (errno == EINTR)
3310 waitchannels = 0;
3311 }
3312 #ifdef sun
3313 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
3314 /* System sometimes fails to deliver SIGIO. */
3315 kill (getpid (), SIGIO);
3316 #endif
3317 #ifdef SIGIO
3318 if (XINT (read_kbd) && interrupt_input && (waitchannels & 1))
3319 kill (0, SIGIO);
3320 #endif
3321
3322 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3323 we should exit. */
3324 if (nfds >= 0)
3325 break;
3326 }
3327
3328 start_polling ();
3329
3330 return 0;
3331 }
3332
3333
3334 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
3335 /* Don't confuse make-docfile by having two doc strings for this function.
3336 make-docfile does not pay attention to #if, for good reason! */
3337 0)
3338 (name)
3339 register Lisp_Object name;
3340 {
3341 return Qnil;
3342 }
3343
3344 /* Kill all processes associated with `buffer'.
3345 If `buffer' is nil, kill all processes.
3346 Since we have no subprocesses, this does nothing. */
3347
3348 kill_buffer_processes (buffer)
3349 Lisp_Object buffer;
3350 {
3351 }
3352
3353 init_process ()
3354 {
3355 }
3356
3357 syms_of_process ()
3358 {
3359 defsubr (&Sget_buffer_process);
3360 }
3361
3362 \f
3363 #endif /* not subprocesses */