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