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