Comment change.
[emacs.git] / src / process.c
blob7d84a7ce74cafbd6877cc3d2cfa03740afaf2613
1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 1996
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #include <signal.h>
25 #include <config.h>
27 /* This file is split into two parts by the following preprocessor
28 conditional. The 'then' clause contains all of the support for
29 asynchronous subprocesses. The 'else' clause contains stub
30 versions of some of the asynchronous subprocess routines that are
31 often called elsewhere in Emacs, so we don't have to #ifdef the
32 sections that call them. */
35 #ifdef subprocesses
37 #include <stdio.h>
38 #include <errno.h>
39 #include <setjmp.h>
40 #include <sys/types.h> /* some typedefs are used in sys/file.h */
41 #include <sys/file.h>
42 #include <sys/stat.h>
43 #ifdef HAVE_UNISTD_H
44 #include <unistd.h>
45 #endif
47 #ifdef WINDOWSNT
48 #include <stdlib.h>
49 #include <fcntl.h>
50 #endif /* not WINDOWSNT */
52 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
53 #include <sys/socket.h>
54 #include <netdb.h>
55 #include <netinet/in.h>
56 #include <arpa/inet.h>
57 #ifdef NEED_NET_ERRNO_H
58 #include <net/errno.h>
59 #endif /* NEED_NET_ERRNO_H */
60 #endif /* HAVE_SOCKETS */
62 /* TERM is a poor-man's SLIP, used on Linux. */
63 #ifdef TERM
64 #include <client.h>
65 #endif
67 /* On some systems, e.g. DGUX, inet_addr returns a 'struct in_addr'. */
68 #ifdef HAVE_BROKEN_INET_ADDR
69 #define IN_ADDR struct in_addr
70 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
71 #else
72 #define IN_ADDR unsigned long
73 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
74 #endif
76 #if defined(BSD_SYSTEM) || defined(STRIDE)
77 #include <sys/ioctl.h>
78 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
79 #include <fcntl.h>
80 #endif /* HAVE_PTYS and no O_NDELAY */
81 #endif /* BSD_SYSTEM || STRIDE */
83 #ifdef BROKEN_O_NONBLOCK
84 #undef O_NONBLOCK
85 #endif /* BROKEN_O_NONBLOCK */
87 #ifdef NEED_BSDTTY
88 #include <bsdtty.h>
89 #endif
91 #ifdef IRIS
92 #include <sys/sysmacros.h> /* for "minor" */
93 #endif /* not IRIS */
95 #include "systime.h"
96 #include "systty.h"
98 #include "lisp.h"
99 #include "window.h"
100 #include "buffer.h"
101 #include "charset.h"
102 #include "coding.h"
103 #include "process.h"
104 #include "termhooks.h"
105 #include "termopts.h"
106 #include "commands.h"
107 #include "frame.h"
108 #include "blockinput.h"
110 #define max(a, b) ((a) > (b) ? (a) : (b))
112 Lisp_Object Qprocessp;
113 Lisp_Object Qrun, Qstop, Qsignal, Qopen, Qclosed;
114 Lisp_Object Qlast_nonmenu_event;
115 /* Qexit is declared and initialized in eval.c. */
117 /* a process object is a network connection when its childp field is neither
118 Qt nor Qnil but is instead a cons cell (HOSTNAME PORTNUM). */
120 #ifdef HAVE_SOCKETS
121 #define NETCONN_P(p) (GC_CONSP (XPROCESS (p)->childp))
122 #else
123 #define NETCONN_P(p) 0
124 #endif /* HAVE_SOCKETS */
126 /* Define first descriptor number available for subprocesses. */
127 #ifdef VMS
128 #define FIRST_PROC_DESC 1
129 #else /* Not VMS */
130 #define FIRST_PROC_DESC 3
131 #endif
133 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
134 testing SIGCHLD. */
136 #if !defined (SIGCHLD) && defined (SIGCLD)
137 #define SIGCHLD SIGCLD
138 #endif /* SIGCLD */
140 #include "syssignal.h"
142 #include "syswait.h"
144 extern int errno;
145 extern char *strerror ();
146 #ifdef VMS
147 extern char *sys_errlist[];
148 #endif
150 #ifndef HAVE_H_ERRNO
151 extern int h_errno;
152 #endif
154 #ifndef SYS_SIGLIST_DECLARED
155 #ifndef VMS
156 #ifndef BSD4_1
157 #ifndef WINDOWSNT
158 #ifndef LINUX
159 extern char *sys_siglist[];
160 #endif /* not LINUX */
161 #else /* BSD4_1 */
162 char *sys_siglist[] =
164 "bum signal!!",
165 "hangup",
166 "interrupt",
167 "quit",
168 "illegal instruction",
169 "trace trap",
170 "iot instruction",
171 "emt instruction",
172 "floating point exception",
173 "kill",
174 "bus error",
175 "segmentation violation",
176 "bad argument to system call",
177 "write on a pipe with no one to read it",
178 "alarm clock",
179 "software termination signal from kill",
180 "status signal",
181 "sendable stop signal not from tty",
182 "stop signal from tty",
183 "continue a stopped process",
184 "child status has changed",
185 "background read attempted from control tty",
186 "background write attempted from control tty",
187 "input record available at control tty",
188 "exceeded CPU time limit",
189 "exceeded file size limit"
191 #endif /* not WINDOWSNT */
192 #endif
193 #endif /* VMS */
194 #endif /* ! SYS_SIGLIST_DECLARED */
196 /* t means use pty, nil means use a pipe,
197 maybe other values to come. */
198 static Lisp_Object Vprocess_connection_type;
200 #ifdef SKTPAIR
201 #ifndef HAVE_SOCKETS
202 #include <sys/socket.h>
203 #endif
204 #endif /* SKTPAIR */
206 /* These next two vars are non-static since sysdep.c uses them in the
207 emulation of `select'. */
208 /* Number of events of change of status of a process. */
209 int process_tick;
210 /* Number of events for which the user or sentinel has been notified. */
211 int update_tick;
213 #include "sysselect.h"
215 /* If we support a window system, turn on the code to poll periodically
216 to detect C-g. It isn't actually used when doing interrupt input. */
217 #ifdef HAVE_WINDOW_SYSTEM
218 #define POLL_FOR_INPUT
219 #endif
221 /* Mask of bits indicating the descriptors that we wait for input on. */
223 static SELECT_TYPE input_wait_mask;
225 /* Mask that excludes keyboard input descriptor (s). */
227 static SELECT_TYPE non_keyboard_wait_mask;
229 /* Mask that excludes process input descriptor (s). */
231 static SELECT_TYPE non_process_wait_mask;
233 /* The largest descriptor currently in use for a process object. */
234 static int max_process_desc;
236 /* The largest descriptor currently in use for keyboard input. */
237 static int max_keyboard_desc;
239 /* Nonzero means delete a process right away if it exits. */
240 static int delete_exited_processes;
242 /* Indexed by descriptor, gives the process (if any) for that descriptor */
243 Lisp_Object chan_process[MAXDESC];
245 /* Alist of elements (NAME . PROCESS) */
246 Lisp_Object Vprocess_alist;
248 /* Buffered-ahead input char from process, indexed by channel.
249 -1 means empty (no char is buffered).
250 Used on sys V where the only way to tell if there is any
251 output from the process is to read at least one char.
252 Always -1 on systems that support FIONREAD. */
254 /* Don't make static; need to access externally. */
255 int proc_buffered_char[MAXDESC];
257 /* Table of `struct coding-system' for each process. */
258 static struct coding_system *proc_decode_coding_system[MAXDESC];
259 static struct coding_system *proc_encode_coding_system[MAXDESC];
261 static Lisp_Object get_process ();
263 extern EMACS_TIME timer_check ();
264 extern int timers_run;
266 /* Maximum number of bytes to send to a pty without an eof. */
267 static int pty_max_bytes;
269 #ifdef HAVE_PTYS
270 /* The file name of the pty opened by allocate_pty. */
272 static char pty_name[24];
273 #endif
275 /* Compute the Lisp form of the process status, p->status, from
276 the numeric status that was returned by `wait'. */
278 Lisp_Object status_convert ();
280 update_status (p)
281 struct Lisp_Process *p;
283 union { int i; WAITTYPE wt; } u;
284 u.i = XFASTINT (p->raw_status_low) + (XFASTINT (p->raw_status_high) << 16);
285 p->status = status_convert (u.wt);
286 p->raw_status_low = Qnil;
287 p->raw_status_high = Qnil;
290 /* Convert a process status word in Unix format to
291 the list that we use internally. */
293 Lisp_Object
294 status_convert (w)
295 WAITTYPE w;
297 if (WIFSTOPPED (w))
298 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
299 else if (WIFEXITED (w))
300 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
301 WCOREDUMP (w) ? Qt : Qnil));
302 else if (WIFSIGNALED (w))
303 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
304 WCOREDUMP (w) ? Qt : Qnil));
305 else
306 return Qrun;
309 /* Given a status-list, extract the three pieces of information
310 and store them individually through the three pointers. */
312 void
313 decode_status (l, symbol, code, coredump)
314 Lisp_Object l;
315 Lisp_Object *symbol;
316 int *code;
317 int *coredump;
319 Lisp_Object tem;
321 if (SYMBOLP (l))
323 *symbol = l;
324 *code = 0;
325 *coredump = 0;
327 else
329 *symbol = XCONS (l)->car;
330 tem = XCONS (l)->cdr;
331 *code = XFASTINT (XCONS (tem)->car);
332 tem = XCONS (tem)->cdr;
333 *coredump = !NILP (tem);
337 /* Return a string describing a process status list. */
339 Lisp_Object
340 status_message (status)
341 Lisp_Object status;
343 Lisp_Object symbol;
344 int code, coredump;
345 Lisp_Object string, string2;
347 decode_status (status, &symbol, &code, &coredump);
349 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
351 char *signame = 0;
352 if (code < NSIG)
354 #ifndef VMS
355 /* Cast to suppress warning if the table has const char *. */
356 signame = (char *) sys_siglist[code];
357 #else
358 signame = sys_errlist[code];
359 #endif
361 if (signame == 0)
362 signame = "unknown";
363 string = build_string (signame);
364 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
365 XSTRING (string)->data[0] = DOWNCASE (XSTRING (string)->data[0]);
366 return concat2 (string, string2);
368 else if (EQ (symbol, Qexit))
370 if (code == 0)
371 return build_string ("finished\n");
372 string = Fnumber_to_string (make_number (code));
373 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
374 return concat2 (build_string ("exited abnormally with code "),
375 concat2 (string, string2));
377 else
378 return Fcopy_sequence (Fsymbol_name (symbol));
381 #ifdef HAVE_PTYS
383 /* Open an available pty, returning a file descriptor.
384 Return -1 on failure.
385 The file name of the terminal corresponding to the pty
386 is left in the variable pty_name. */
389 allocate_pty ()
391 struct stat stb;
392 register c, i;
393 int fd;
395 /* Some systems name their pseudoterminals so that there are gaps in
396 the usual sequence - for example, on HP9000/S700 systems, there
397 are no pseudoterminals with names ending in 'f'. So we wait for
398 three failures in a row before deciding that we've reached the
399 end of the ptys. */
400 int failed_count = 0;
402 #ifdef PTY_ITERATION
403 PTY_ITERATION
404 #else
405 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
406 for (i = 0; i < 16; i++)
407 #endif
409 #ifdef PTY_NAME_SPRINTF
410 PTY_NAME_SPRINTF
411 #else
412 sprintf (pty_name, "/dev/pty%c%x", c, i);
413 #endif /* no PTY_NAME_SPRINTF */
415 #ifdef PTY_OPEN
416 PTY_OPEN;
417 #else /* no PTY_OPEN */
418 #ifdef IRIS
419 /* Unusual IRIS code */
420 *ptyv = open ("/dev/ptc", O_RDWR | O_NDELAY, 0);
421 if (fd < 0)
422 return -1;
423 if (fstat (fd, &stb) < 0)
424 return -1;
425 #else /* not IRIS */
426 if (stat (pty_name, &stb) < 0)
428 failed_count++;
429 if (failed_count >= 3)
430 return -1;
432 else
433 failed_count = 0;
434 #ifdef O_NONBLOCK
435 fd = open (pty_name, O_RDWR | O_NONBLOCK, 0);
436 #else
437 fd = open (pty_name, O_RDWR | O_NDELAY, 0);
438 #endif
439 #endif /* not IRIS */
440 #endif /* no PTY_OPEN */
442 if (fd >= 0)
444 /* check to make certain that both sides are available
445 this avoids a nasty yet stupid bug in rlogins */
446 #ifdef PTY_TTY_NAME_SPRINTF
447 PTY_TTY_NAME_SPRINTF
448 #else
449 sprintf (pty_name, "/dev/tty%c%x", c, i);
450 #endif /* no PTY_TTY_NAME_SPRINTF */
451 #ifndef UNIPLUS
452 if (access (pty_name, 6) != 0)
454 close (fd);
455 #if !defined(IRIS) && !defined(__sgi)
456 continue;
457 #else
458 return -1;
459 #endif /* IRIS */
461 #endif /* not UNIPLUS */
462 setup_pty (fd);
463 return fd;
466 return -1;
468 #endif /* HAVE_PTYS */
470 Lisp_Object
471 make_process (name)
472 Lisp_Object name;
474 struct Lisp_Vector *vec;
475 register Lisp_Object val, tem, name1;
476 register struct Lisp_Process *p;
477 char suffix[10];
478 register int i;
480 vec = allocate_vectorlike ((EMACS_INT) VECSIZE (struct Lisp_Process));
481 for (i = 0; i < VECSIZE (struct Lisp_Process); i++)
482 vec->contents[i] = Qnil;
483 vec->size = VECSIZE (struct Lisp_Process);
484 p = (struct Lisp_Process *)vec;
486 XSETINT (p->infd, -1);
487 XSETINT (p->outfd, -1);
488 XSETFASTINT (p->pid, 0);
489 XSETFASTINT (p->tick, 0);
490 XSETFASTINT (p->update_tick, 0);
491 p->raw_status_low = Qnil;
492 p->raw_status_high = Qnil;
493 p->status = Qrun;
494 p->mark = Fmake_marker ();
496 /* If name is already in use, modify it until it is unused. */
498 name1 = name;
499 for (i = 1; ; i++)
501 tem = Fget_process (name1);
502 if (NILP (tem)) break;
503 sprintf (suffix, "<%d>", i);
504 name1 = concat2 (name, build_string (suffix));
506 name = name1;
507 p->name = name;
508 XSETPROCESS (val, p);
509 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
510 return val;
513 remove_process (proc)
514 register Lisp_Object proc;
516 register Lisp_Object pair;
518 pair = Frassq (proc, Vprocess_alist);
519 Vprocess_alist = Fdelq (pair, Vprocess_alist);
521 deactivate_process (proc);
524 DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
525 "Return t if OBJECT is a process.")
526 (object)
527 Lisp_Object object;
529 return PROCESSP (object) ? Qt : Qnil;
532 DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
533 "Return the process named NAME, or nil if there is none.")
534 (name)
535 register Lisp_Object name;
537 if (PROCESSP (name))
538 return name;
539 CHECK_STRING (name, 0);
540 return Fcdr (Fassoc (name, Vprocess_alist));
543 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
544 "Return the (or, a) process associated with BUFFER.\n\
545 BUFFER may be a buffer or the name of one.")
546 (buffer)
547 register Lisp_Object buffer;
549 register Lisp_Object buf, tail, proc;
551 if (NILP (buffer)) return Qnil;
552 buf = Fget_buffer (buffer);
553 if (NILP (buf)) return Qnil;
555 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
557 proc = Fcdr (Fcar (tail));
558 if (PROCESSP (proc) && EQ (XPROCESS (proc)->buffer, buf))
559 return proc;
561 return Qnil;
564 /* This is how commands for the user decode process arguments. It
565 accepts a process, a process name, a buffer, a buffer name, or nil.
566 Buffers denote the first process in the buffer, and nil denotes the
567 current buffer. */
569 static Lisp_Object
570 get_process (name)
571 register Lisp_Object name;
573 register Lisp_Object proc, obj;
574 if (STRINGP (name))
576 obj = Fget_process (name);
577 if (NILP (obj))
578 obj = Fget_buffer (name);
579 if (NILP (obj))
580 error ("Process %s does not exist", XSTRING (name)->data);
582 else if (NILP (name))
583 obj = Fcurrent_buffer ();
584 else
585 obj = name;
587 /* Now obj should be either a buffer object or a process object.
589 if (BUFFERP (obj))
591 proc = Fget_buffer_process (obj);
592 if (NILP (proc))
593 error ("Buffer %s has no process", XSTRING (XBUFFER (obj)->name)->data);
595 else
597 CHECK_PROCESS (obj, 0);
598 proc = obj;
600 return proc;
603 DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
604 "Delete PROCESS: kill it and forget about it immediately.\n\
605 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
606 nil, indicating the current buffer's process.")
607 (process)
608 register Lisp_Object process;
610 process = get_process (process);
611 XPROCESS (process)->raw_status_low = Qnil;
612 XPROCESS (process)->raw_status_high = Qnil;
613 if (NETCONN_P (process))
615 XPROCESS (process)->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
616 XSETINT (XPROCESS (process)->tick, ++process_tick);
618 else if (XINT (XPROCESS (process)->infd) >= 0)
620 Fkill_process (process, Qnil);
621 /* Do this now, since remove_process will make sigchld_handler do nothing. */
622 XPROCESS (process)->status
623 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
624 XSETINT (XPROCESS (process)->tick, ++process_tick);
625 status_notify ();
627 remove_process (process);
628 return Qnil;
631 DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
632 "Return the status of PROCESS: a symbol, one of these:\n\
633 run -- for a process that is running.\n\
634 stop -- for a process stopped but continuable.\n\
635 exit -- for a process that has exited.\n\
636 signal -- for a process that has got a fatal signal.\n\
637 open -- for a network stream connection that is open.\n\
638 closed -- for a network stream connection that is closed.\n\
639 nil -- if arg is a process name and no such process exists.\n\
640 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
641 nil, indicating the current buffer's process.")
642 (process)
643 register Lisp_Object process;
645 register struct Lisp_Process *p;
646 register Lisp_Object status;
648 if (STRINGP (process))
649 process = Fget_process (process);
650 else
651 process = get_process (process);
653 if (NILP (process))
654 return process;
656 p = XPROCESS (process);
657 if (!NILP (p->raw_status_low))
658 update_status (p);
659 status = p->status;
660 if (CONSP (status))
661 status = XCONS (status)->car;
662 if (NETCONN_P (process))
664 if (EQ (status, Qrun))
665 status = Qopen;
666 else if (EQ (status, Qexit))
667 status = Qclosed;
669 return status;
672 DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
673 1, 1, 0,
674 "Return the exit status of PROCESS or the signal number that killed it.\n\
675 If PROCESS has not yet exited or died, return 0.")
676 (process)
677 register Lisp_Object process;
679 CHECK_PROCESS (process, 0);
680 if (!NILP (XPROCESS (process)->raw_status_low))
681 update_status (XPROCESS (process));
682 if (CONSP (XPROCESS (process)->status))
683 return XCONS (XCONS (XPROCESS (process)->status)->cdr)->car;
684 return make_number (0);
687 DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
688 "Return the process id of PROCESS.\n\
689 This is the pid of the Unix process which PROCESS uses or talks to.\n\
690 For a network connection, this value is nil.")
691 (process)
692 register Lisp_Object process;
694 CHECK_PROCESS (process, 0);
695 return XPROCESS (process)->pid;
698 DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
699 "Return the name of PROCESS, as a string.\n\
700 This is the name of the program invoked in PROCESS,\n\
701 possibly modified to make it unique among process names.")
702 (process)
703 register Lisp_Object process;
705 CHECK_PROCESS (process, 0);
706 return XPROCESS (process)->name;
709 DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
710 "Return the command that was executed to start PROCESS.\n\
711 This is a list of strings, the first string being the program executed\n\
712 and the rest of the strings being the arguments given to it.\n\
713 For a non-child channel, this is nil.")
714 (process)
715 register Lisp_Object process;
717 CHECK_PROCESS (process, 0);
718 return XPROCESS (process)->command;
721 DEFUN ("process-tty-name", Fprocess_tty_name, Sprocess_tty_name, 1, 1, 0,
722 "Return the name of the terminal PROCESS uses, or nil if none.\n\
723 This is the terminal that the process itself reads and writes on,\n\
724 not the name of the pty that Emacs uses to talk with that terminal.")
725 (process)
726 register Lisp_Object process;
728 CHECK_PROCESS (process, 0);
729 return XPROCESS (process)->tty_name;
732 DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
733 2, 2, 0,
734 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
735 (process, buffer)
736 register Lisp_Object process, buffer;
738 CHECK_PROCESS (process, 0);
739 if (!NILP (buffer))
740 CHECK_BUFFER (buffer, 1);
741 XPROCESS (process)->buffer = buffer;
742 return buffer;
745 DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
746 1, 1, 0,
747 "Return the buffer PROCESS is associated with.\n\
748 Output from PROCESS is inserted in this buffer\n\
749 unless PROCESS has a filter.")
750 (process)
751 register Lisp_Object process;
753 CHECK_PROCESS (process, 0);
754 return XPROCESS (process)->buffer;
757 DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
758 1, 1, 0,
759 "Return the marker for the end of the last output from PROCESS.")
760 (process)
761 register Lisp_Object process;
763 CHECK_PROCESS (process, 0);
764 return XPROCESS (process)->mark;
767 DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
768 2, 2, 0,
769 "Give PROCESS the filter function FILTER; nil means no filter.\n\
770 t means stop accepting output from the process.\n\
771 When a process has a filter, each time it does output\n\
772 the entire string of output is passed to the filter.\n\
773 The filter gets two arguments: the process and the string of output.\n\
774 If the process has a filter, its buffer is not used for output.")
775 (process, filter)
776 register Lisp_Object process, filter;
778 CHECK_PROCESS (process, 0);
779 if (EQ (filter, Qt))
781 FD_CLR (XINT (XPROCESS (process)->infd), &input_wait_mask);
782 FD_CLR (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
784 else if (EQ (XPROCESS (process)->filter, Qt))
786 FD_SET (XINT (XPROCESS (process)->infd), &input_wait_mask);
787 FD_SET (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
789 XPROCESS (process)->filter = filter;
790 return filter;
793 DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
794 1, 1, 0,
795 "Returns the filter function of PROCESS; nil if none.\n\
796 See `set-process-filter' for more info on filter functions.")
797 (process)
798 register Lisp_Object process;
800 CHECK_PROCESS (process, 0);
801 return XPROCESS (process)->filter;
804 DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
805 2, 2, 0,
806 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
807 The sentinel is called as a function when the process changes state.\n\
808 It gets two arguments: the process, and a string describing the change.")
809 (process, sentinel)
810 register Lisp_Object process, sentinel;
812 CHECK_PROCESS (process, 0);
813 XPROCESS (process)->sentinel = sentinel;
814 return sentinel;
817 DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
818 1, 1, 0,
819 "Return the sentinel of PROCESS; nil if none.\n\
820 See `set-process-sentinel' for more info on sentinels.")
821 (process)
822 register Lisp_Object process;
824 CHECK_PROCESS (process, 0);
825 return XPROCESS (process)->sentinel;
828 DEFUN ("set-process-window-size", Fset_process_window_size,
829 Sset_process_window_size, 3, 3, 0,
830 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
831 (process, height, width)
832 register Lisp_Object process, height, width;
834 CHECK_PROCESS (process, 0);
835 CHECK_NATNUM (height, 0);
836 CHECK_NATNUM (width, 0);
837 if (set_window_size (XINT (XPROCESS (process)->infd),
838 XINT (height), XINT(width)) <= 0)
839 return Qnil;
840 else
841 return Qt;
844 DEFUN ("process-kill-without-query", Fprocess_kill_without_query,
845 Sprocess_kill_without_query, 1, 2, 0,
846 "Say no query needed if PROCESS is running when Emacs is exited.\n\
847 Optional second argument if non-nil says to require a query.\n\
848 Value is t if a query was formerly required.")
849 (process, value)
850 register Lisp_Object process, value;
852 Lisp_Object tem;
854 CHECK_PROCESS (process, 0);
855 tem = XPROCESS (process)->kill_without_query;
856 XPROCESS (process)->kill_without_query = Fnull (value);
858 return Fnull (tem);
861 DEFUN ("process-contact", Fprocess_contact, Sprocess_contact,
862 1, 1, 0,
863 "Return the contact info of PROCESS; t for a real child.\n\
864 For a net connection, the value is a cons cell of the form (HOST SERVICE).")
865 (process)
866 register Lisp_Object process;
868 CHECK_PROCESS (process, 0);
869 return XPROCESS (process)->childp;
872 #if 0 /* Turned off because we don't currently record this info
873 in the process. Perhaps add it. */
874 DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 1, 1, 0,
875 "Return the connection type of `PROCESS'.\n\
876 The value is `nil' for a pipe,\n\
877 `t' or `pty' for a pty, or `stream' for a socket connection.")
878 (process)
879 Lisp_Object process;
881 return XPROCESS (process)->type;
883 #endif
885 Lisp_Object
886 list_processes_1 ()
888 register Lisp_Object tail, tem;
889 Lisp_Object proc, minspace, tem1;
890 register struct buffer *old = current_buffer;
891 register struct Lisp_Process *p;
892 register int state;
893 char tembuf[80];
895 XSETFASTINT (minspace, 1);
897 set_buffer_internal (XBUFFER (Vstandard_output));
898 Fbuffer_disable_undo (Vstandard_output);
900 current_buffer->truncate_lines = Qt;
902 write_string ("\
903 Proc Status Buffer Tty Command\n\
904 ---- ------ ------ --- -------\n", -1);
906 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
908 Lisp_Object symbol;
910 proc = Fcdr (Fcar (tail));
911 p = XPROCESS (proc);
912 if (NILP (p->childp))
913 continue;
915 Finsert (1, &p->name);
916 Findent_to (make_number (13), minspace);
918 if (!NILP (p->raw_status_low))
919 update_status (p);
920 symbol = p->status;
921 if (CONSP (p->status))
922 symbol = XCONS (p->status)->car;
925 if (EQ (symbol, Qsignal))
927 Lisp_Object tem;
928 tem = Fcar (Fcdr (p->status));
929 #ifdef VMS
930 if (XINT (tem) < NSIG)
931 write_string (sys_errlist [XINT (tem)], -1);
932 else
933 #endif
934 Fprinc (symbol, Qnil);
936 else if (NETCONN_P (proc))
938 if (EQ (symbol, Qrun))
939 write_string ("open", -1);
940 else if (EQ (symbol, Qexit))
941 write_string ("closed", -1);
942 else
943 Fprinc (symbol, Qnil);
945 else
946 Fprinc (symbol, Qnil);
948 if (EQ (symbol, Qexit))
950 Lisp_Object tem;
951 tem = Fcar (Fcdr (p->status));
952 if (XFASTINT (tem))
954 sprintf (tembuf, " %d", (int) XFASTINT (tem));
955 write_string (tembuf, -1);
959 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
960 remove_process (proc);
962 Findent_to (make_number (22), minspace);
963 if (NILP (p->buffer))
964 insert_string ("(none)");
965 else if (NILP (XBUFFER (p->buffer)->name))
966 insert_string ("(Killed)");
967 else
968 Finsert (1, &XBUFFER (p->buffer)->name);
970 Findent_to (make_number (37), minspace);
972 if (STRINGP (p->tty_name))
973 Finsert (1, &p->tty_name);
974 else
975 insert_string ("(none)");
977 Findent_to (make_number (49), minspace);
979 if (NETCONN_P (proc))
981 sprintf (tembuf, "(network stream connection to %s)\n",
982 XSTRING (XCONS (p->childp)->car)->data);
983 insert_string (tembuf);
985 else
987 tem = p->command;
988 while (1)
990 tem1 = Fcar (tem);
991 Finsert (1, &tem1);
992 tem = Fcdr (tem);
993 if (NILP (tem))
994 break;
995 insert_string (" ");
997 insert_string ("\n");
1000 return Qnil;
1003 DEFUN ("list-processes", Flist_processes, Slist_processes, 0, 0, "",
1004 "Display a list of all processes.\n\
1005 \(Any processes listed as Exited or Signaled are actually eliminated\n\
1006 after the listing is made.)")
1009 internal_with_output_to_temp_buffer ("*Process List*",
1010 list_processes_1, Qnil);
1011 return Qnil;
1014 DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
1015 "Return a list of all processes.")
1018 return Fmapcar (Qcdr, Vprocess_alist);
1021 /* Starting asynchronous inferior processes. */
1023 static Lisp_Object start_process_unwind ();
1025 DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
1026 "Start a program in a subprocess. Return the process object for it.\n\
1027 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
1028 NAME is name for process. It is modified if necessary to make it unique.\n\
1029 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
1030 Process output goes at end of that buffer, unless you specify\n\
1031 an output stream or filter function to handle the output.\n\
1032 BUFFER may be also nil, meaning that this process is not associated\n\
1033 with any buffer.\n\
1034 Third arg is program file name. It is searched for as in the shell.\n\
1035 Remaining arguments are strings to give program as arguments.")
1036 (nargs, args)
1037 int nargs;
1038 register Lisp_Object *args;
1040 Lisp_Object buffer, name, program, proc, current_dir, tem;
1041 #ifdef VMS
1042 register unsigned char *new_argv;
1043 int len;
1044 #else
1045 register unsigned char **new_argv;
1046 #endif
1047 register int i;
1048 int count = specpdl_ptr - specpdl;
1050 buffer = args[1];
1051 if (!NILP (buffer))
1052 buffer = Fget_buffer_create (buffer);
1054 /* Make sure that the child will be able to chdir to the current
1055 buffer's current directory, or its unhandled equivalent. We
1056 can't just have the child check for an error when it does the
1057 chdir, since it's in a vfork.
1059 We have to GCPRO around this because Fexpand_file_name and
1060 Funhandled_file_name_directory might call a file name handling
1061 function. The argument list is protected by the caller, so all
1062 we really have to worry about is buffer. */
1064 struct gcpro gcpro1, gcpro2;
1066 current_dir = current_buffer->directory;
1068 GCPRO2 (buffer, current_dir);
1070 current_dir
1071 = expand_and_dir_to_file (Funhandled_file_name_directory (current_dir),
1072 Qnil);
1073 if (NILP (Ffile_accessible_directory_p (current_dir)))
1074 report_file_error ("Setting current directory",
1075 Fcons (current_buffer->directory, Qnil));
1077 UNGCPRO;
1080 name = args[0];
1081 CHECK_STRING (name, 0);
1083 program = args[2];
1085 CHECK_STRING (program, 2);
1087 #ifdef VMS
1088 /* Make a one member argv with all args concatenated
1089 together separated by a blank. */
1090 len = XSTRING (program)->size + 2;
1091 for (i = 3; i < nargs; i++)
1093 tem = args[i];
1094 CHECK_STRING (tem, i);
1095 len += XSTRING (tem)->size + 1; /* count the blank */
1097 new_argv = (unsigned char *) alloca (len);
1098 strcpy (new_argv, XSTRING (program)->data);
1099 for (i = 3; i < nargs; i++)
1101 tem = args[i];
1102 CHECK_STRING (tem, i);
1103 strcat (new_argv, " ");
1104 strcat (new_argv, XSTRING (tem)->data);
1106 /* Need to add code here to check for program existence on VMS */
1108 #else /* not VMS */
1109 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1111 /* If program file name is not absolute, search our path for it */
1112 if (!IS_DIRECTORY_SEP (XSTRING (program)->data[0])
1113 && !(XSTRING (program)->size > 1
1114 && IS_DEVICE_SEP (XSTRING (program)->data[1])))
1116 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1118 tem = Qnil;
1119 GCPRO4 (name, program, buffer, current_dir);
1120 openp (Vexec_path, program, EXEC_SUFFIXES, &tem, 1);
1121 UNGCPRO;
1122 if (NILP (tem))
1123 report_file_error ("Searching for program", Fcons (program, Qnil));
1124 tem = Fexpand_file_name (tem, Qnil);
1125 new_argv[0] = XSTRING (tem)->data;
1127 else
1129 if (!NILP (Ffile_directory_p (program)))
1130 error ("Specified program for new process is a directory");
1132 new_argv[0] = XSTRING (program)->data;
1135 for (i = 3; i < nargs; i++)
1137 tem = args[i];
1138 CHECK_STRING (tem, i);
1139 new_argv[i - 2] = XSTRING (tem)->data;
1141 new_argv[i - 2] = 0;
1142 #endif /* not VMS */
1144 proc = make_process (name);
1145 /* If an error occurs and we can't start the process, we want to
1146 remove it from the process list. This means that each error
1147 check in create_process doesn't need to call remove_process
1148 itself; it's all taken care of here. */
1149 record_unwind_protect (start_process_unwind, proc);
1151 XPROCESS (proc)->childp = Qt;
1152 XPROCESS (proc)->command_channel_p = Qnil;
1153 XPROCESS (proc)->buffer = buffer;
1154 XPROCESS (proc)->sentinel = Qnil;
1155 XPROCESS (proc)->filter = Qnil;
1156 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1158 /* Make the process marker point into the process buffer (if any). */
1159 if (!NILP (buffer))
1160 Fset_marker (XPROCESS (proc)->mark,
1161 make_number (BUF_ZV (XBUFFER (buffer))), buffer);
1163 if (!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters)
1164 || NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters))
1166 XPROCESS (proc)->decode_coding_system = Qnil;
1167 XPROCESS (proc)->encode_coding_system = Qnil;
1169 else
1171 /* Setup coding systems for communicating with the process. */
1172 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
1173 Lisp_Object coding_systems = Qt;
1174 Lisp_Object val, *args2;
1175 struct gcpro gcpro1;
1177 if (!NILP (Vcoding_system_for_read))
1178 val = Vcoding_system_for_read;
1179 else if (NILP (current_buffer->enable_multibyte_characters))
1180 val = Qemacs_mule;
1181 else
1183 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof *args2);
1184 args2[0] = Qstart_process;
1185 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1186 GCPRO1 (proc);
1187 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1188 UNGCPRO;
1189 if (CONSP (coding_systems))
1190 val = XCONS (coding_systems)->car;
1191 else if (CONSP (Vdefault_process_coding_system))
1192 val = XCONS (Vdefault_process_coding_system)->car;
1193 else
1194 val = Qnil;
1196 XPROCESS (proc)->decode_coding_system = val;
1198 if (!NILP (Vcoding_system_for_write))
1199 val = Vcoding_system_for_write;
1200 else if (NILP (current_buffer->enable_multibyte_characters))
1201 val = Qnil;
1202 else
1204 if (EQ (coding_systems, Qt))
1206 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof args2);
1207 args2[0] = Qstart_process;
1208 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1209 GCPRO1 (proc);
1210 coding_systems =
1211 Ffind_operation_coding_system (nargs + 1, args2);
1212 UNGCPRO;
1214 if (CONSP (coding_systems))
1215 val = XCONS (coding_systems)->cdr;
1216 else if (CONSP (Vdefault_process_coding_system))
1217 val = XCONS (Vdefault_process_coding_system)->cdr;
1218 else
1219 val = Qnil;
1221 XPROCESS (proc)->encode_coding_system = val;
1224 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
1225 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
1227 create_process (proc, new_argv, current_dir);
1229 return unbind_to (count, proc);
1232 /* This function is the unwind_protect form for Fstart_process. If
1233 PROC doesn't have its pid set, then we know someone has signaled
1234 an error and the process wasn't started successfully, so we should
1235 remove it from the process list. */
1236 static Lisp_Object
1237 start_process_unwind (proc)
1238 Lisp_Object proc;
1240 if (!PROCESSP (proc))
1241 abort ();
1243 /* Was PROC started successfully? */
1244 if (XINT (XPROCESS (proc)->pid) <= 0)
1245 remove_process (proc);
1247 return Qnil;
1251 SIGTYPE
1252 create_process_1 (signo)
1253 int signo;
1255 #if defined (USG) && !defined (POSIX_SIGNALS)
1256 /* USG systems forget handlers when they are used;
1257 must reestablish each time */
1258 signal (signo, create_process_1);
1259 #endif /* USG */
1262 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1263 #ifdef USG
1264 #ifdef SIGCHLD
1265 /* Mimic blocking of signals on system V, which doesn't really have it. */
1267 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1268 int sigchld_deferred;
1270 SIGTYPE
1271 create_process_sigchld ()
1273 signal (SIGCHLD, create_process_sigchld);
1275 sigchld_deferred = 1;
1277 #endif
1278 #endif
1279 #endif
1281 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1282 create_process (process, new_argv, current_dir)
1283 Lisp_Object process;
1284 char **new_argv;
1285 Lisp_Object current_dir;
1287 int pid, inchannel, outchannel;
1288 int sv[2];
1289 #ifdef POSIX_SIGNALS
1290 sigset_t procmask;
1291 sigset_t blocked;
1292 struct sigaction sigint_action;
1293 struct sigaction sigquit_action;
1294 #ifdef AIX
1295 struct sigaction sighup_action;
1296 #endif
1297 #else /* !POSIX_SIGNALS */
1298 #ifdef SIGCHLD
1299 SIGTYPE (*sigchld)();
1300 #endif
1301 #endif /* !POSIX_SIGNALS */
1302 /* Use volatile to protect variables from being clobbered by longjmp. */
1303 volatile int forkin, forkout;
1304 volatile int pty_flag = 0;
1305 extern char **environ;
1307 inchannel = outchannel = -1;
1309 #ifdef HAVE_PTYS
1310 if (!NILP (Vprocess_connection_type))
1311 outchannel = inchannel = allocate_pty ();
1313 if (inchannel >= 0)
1315 #ifndef USG
1316 /* On USG systems it does not work to open the pty's tty here
1317 and then close and reopen it in the child. */
1318 #ifdef O_NOCTTY
1319 /* Don't let this terminal become our controlling terminal
1320 (in case we don't have one). */
1321 forkout = forkin = open (pty_name, O_RDWR | O_NOCTTY, 0);
1322 #else
1323 forkout = forkin = open (pty_name, O_RDWR, 0);
1324 #endif
1325 if (forkin < 0)
1326 report_file_error ("Opening pty", Qnil);
1327 #else
1328 forkin = forkout = -1;
1329 #endif /* not USG */
1330 pty_flag = 1;
1332 else
1333 #endif /* HAVE_PTYS */
1334 #ifdef SKTPAIR
1336 if (socketpair (AF_UNIX, SOCK_STREAM, 0, sv) < 0)
1337 report_file_error ("Opening socketpair", Qnil);
1338 outchannel = inchannel = sv[0];
1339 forkout = forkin = sv[1];
1341 #else /* not SKTPAIR */
1343 pipe (sv);
1344 inchannel = sv[0];
1345 forkout = sv[1];
1346 pipe (sv);
1347 outchannel = sv[1];
1348 forkin = sv[0];
1350 #endif /* not SKTPAIR */
1352 #if 0
1353 /* Replaced by close_process_descs */
1354 set_exclusive_use (inchannel);
1355 set_exclusive_use (outchannel);
1356 #endif
1358 /* Stride people say it's a mystery why this is needed
1359 as well as the O_NDELAY, but that it fails without this. */
1360 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1362 int one = 1;
1363 ioctl (inchannel, FIONBIO, &one);
1365 #endif
1367 #ifdef O_NONBLOCK
1368 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1369 fcntl (outchannel, F_SETFL, O_NONBLOCK);
1370 #else
1371 #ifdef O_NDELAY
1372 fcntl (inchannel, F_SETFL, O_NDELAY);
1373 fcntl (outchannel, F_SETFL, O_NDELAY);
1374 #endif
1375 #endif
1377 /* Record this as an active process, with its channels.
1378 As a result, child_setup will close Emacs's side of the pipes. */
1379 chan_process[inchannel] = process;
1380 XSETINT (XPROCESS (process)->infd, inchannel);
1381 XSETINT (XPROCESS (process)->outfd, outchannel);
1382 /* Record the tty descriptor used in the subprocess. */
1383 if (forkin < 0)
1384 XPROCESS (process)->subtty = Qnil;
1385 else
1386 XSETFASTINT (XPROCESS (process)->subtty, forkin);
1387 XPROCESS (process)->pty_flag = (pty_flag ? Qt : Qnil);
1388 XPROCESS (process)->status = Qrun;
1389 if (!proc_decode_coding_system[inchannel])
1390 proc_decode_coding_system[inchannel]
1391 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1392 setup_coding_system (XPROCESS (process)->decode_coding_system,
1393 proc_decode_coding_system[inchannel]);
1394 if (!proc_encode_coding_system[outchannel])
1395 proc_encode_coding_system[outchannel]
1396 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1397 setup_coding_system (XPROCESS (process)->encode_coding_system,
1398 proc_encode_coding_system[outchannel]);
1400 /* Delay interrupts until we have a chance to store
1401 the new fork's pid in its process structure */
1402 #ifdef POSIX_SIGNALS
1403 sigemptyset (&blocked);
1404 #ifdef SIGCHLD
1405 sigaddset (&blocked, SIGCHLD);
1406 #endif
1407 #ifdef HAVE_VFORK
1408 /* On many hosts (e.g. Solaris 2.4), if a vforked child calls `signal',
1409 this sets the parent's signal handlers as well as the child's.
1410 So delay all interrupts whose handlers the child might munge,
1411 and record the current handlers so they can be restored later. */
1412 sigaddset (&blocked, SIGINT ); sigaction (SIGINT , 0, &sigint_action );
1413 sigaddset (&blocked, SIGQUIT); sigaction (SIGQUIT, 0, &sigquit_action);
1414 #ifdef AIX
1415 sigaddset (&blocked, SIGHUP ); sigaction (SIGHUP , 0, &sighup_action );
1416 #endif
1417 #endif /* HAVE_VFORK */
1418 sigprocmask (SIG_BLOCK, &blocked, &procmask);
1419 #else /* !POSIX_SIGNALS */
1420 #ifdef SIGCHLD
1421 #ifdef BSD4_1
1422 sighold (SIGCHLD);
1423 #else /* not BSD4_1 */
1424 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1425 sigsetmask (sigmask (SIGCHLD));
1426 #else /* ordinary USG */
1427 #if 0
1428 sigchld_deferred = 0;
1429 sigchld = signal (SIGCHLD, create_process_sigchld);
1430 #endif
1431 #endif /* ordinary USG */
1432 #endif /* not BSD4_1 */
1433 #endif /* SIGCHLD */
1434 #endif /* !POSIX_SIGNALS */
1436 FD_SET (inchannel, &input_wait_mask);
1437 FD_SET (inchannel, &non_keyboard_wait_mask);
1438 if (inchannel > max_process_desc)
1439 max_process_desc = inchannel;
1441 /* Until we store the proper pid, enable sigchld_handler
1442 to recognize an unknown pid as standing for this process.
1443 It is very important not to let this `marker' value stay
1444 in the table after this function has returned; if it does
1445 it might cause call-process to hang and subsequent asynchronous
1446 processes to get their return values scrambled. */
1447 XSETINT (XPROCESS (process)->pid, -1);
1449 BLOCK_INPUT;
1452 /* child_setup must clobber environ on systems with true vfork.
1453 Protect it from permanent change. */
1454 char **save_environ = environ;
1456 #ifndef WINDOWSNT
1457 pid = vfork ();
1458 if (pid == 0)
1459 #endif /* not WINDOWSNT */
1461 int xforkin = forkin;
1462 int xforkout = forkout;
1464 #if 0 /* This was probably a mistake--it duplicates code later on,
1465 but fails to handle all the cases. */
1466 /* Make sure SIGCHLD is not blocked in the child. */
1467 sigsetmask (SIGEMPTYMASK);
1468 #endif
1470 /* Make the pty be the controlling terminal of the process. */
1471 #ifdef HAVE_PTYS
1472 /* First, disconnect its current controlling terminal. */
1473 #ifdef HAVE_SETSID
1474 /* We tried doing setsid only if pty_flag, but it caused
1475 process_set_signal to fail on SGI when using a pipe. */
1476 setsid ();
1477 /* Make the pty's terminal the controlling terminal. */
1478 if (pty_flag)
1480 #ifdef TIOCSCTTY
1481 /* We ignore the return value
1482 because faith@cs.unc.edu says that is necessary on Linux. */
1483 ioctl (xforkin, TIOCSCTTY, 0);
1484 #endif
1486 #else /* not HAVE_SETSID */
1487 #ifdef USG
1488 /* It's very important to call setpgrp here and no time
1489 afterwards. Otherwise, we lose our controlling tty which
1490 is set when we open the pty. */
1491 setpgrp ();
1492 #endif /* USG */
1493 #endif /* not HAVE_SETSID */
1494 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1495 if (pty_flag && xforkin >= 0)
1497 struct termios t;
1498 tcgetattr (xforkin, &t);
1499 t.c_lflag = LDISC1;
1500 if (tcsetattr (xforkin, TCSANOW, &t) < 0)
1501 write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1503 #else
1504 #if defined (NTTYDISC) && defined (TIOCSETD)
1505 if (pty_flag && xforkin >= 0)
1507 /* Use new line discipline. */
1508 int ldisc = NTTYDISC;
1509 ioctl (xforkin, TIOCSETD, &ldisc);
1511 #endif
1512 #endif
1513 #ifdef TIOCNOTTY
1514 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1515 can do TIOCSPGRP only to the process's controlling tty. */
1516 if (pty_flag)
1518 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1519 I can't test it since I don't have 4.3. */
1520 int j = open ("/dev/tty", O_RDWR, 0);
1521 ioctl (j, TIOCNOTTY, 0);
1522 close (j);
1523 #ifndef USG
1524 /* In order to get a controlling terminal on some versions
1525 of BSD, it is necessary to put the process in pgrp 0
1526 before it opens the terminal. */
1527 #ifdef HAVE_SETPGID
1528 setpgid (0, 0);
1529 #else
1530 setpgrp (0, 0);
1531 #endif
1532 #endif
1534 #endif /* TIOCNOTTY */
1536 #if !defined (RTU) && !defined (UNIPLUS) && !defined (DONT_REOPEN_PTY)
1537 /*** There is a suggestion that this ought to be a
1538 conditional on TIOCSPGRP,
1539 or !(defined (HAVE_SETSID) && defined (TIOCSCTTY)).
1540 Trying the latter gave the wrong results on Debian GNU/Linux 1.1;
1541 that system does seem to need this code, even though
1542 both HAVE_SETSID and TIOCSCTTY are defined. */
1543 /* Now close the pty (if we had it open) and reopen it.
1544 This makes the pty the controlling terminal of the subprocess. */
1545 if (pty_flag)
1547 #ifdef SET_CHILD_PTY_PGRP
1548 int pgrp = getpid ();
1549 #endif
1551 /* I wonder if close (open (pty_name, ...)) would work? */
1552 if (xforkin >= 0)
1553 close (xforkin);
1554 xforkout = xforkin = open (pty_name, O_RDWR, 0);
1556 if (xforkin < 0)
1558 write (1, "Couldn't open the pty terminal ", 31);
1559 write (1, pty_name, strlen (pty_name));
1560 write (1, "\n", 1);
1561 _exit (1);
1564 #ifdef SET_CHILD_PTY_PGRP
1565 ioctl (xforkin, TIOCSPGRP, &pgrp);
1566 ioctl (xforkout, TIOCSPGRP, &pgrp);
1567 #endif
1569 #endif /* not UNIPLUS and not RTU and not DONT_REOPEN_PTY */
1571 #ifdef SETUP_SLAVE_PTY
1572 if (pty_flag)
1574 SETUP_SLAVE_PTY;
1576 #endif /* SETUP_SLAVE_PTY */
1577 #ifdef AIX
1578 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1579 Now reenable it in the child, so it will die when we want it to. */
1580 if (pty_flag)
1581 signal (SIGHUP, SIG_DFL);
1582 #endif
1583 #endif /* HAVE_PTYS */
1585 signal (SIGINT, SIG_DFL);
1586 signal (SIGQUIT, SIG_DFL);
1588 /* Stop blocking signals in the child. */
1589 #ifdef POSIX_SIGNALS
1590 sigprocmask (SIG_SETMASK, &procmask, 0);
1591 #else /* !POSIX_SIGNALS */
1592 #ifdef SIGCHLD
1593 #ifdef BSD4_1
1594 sigrelse (SIGCHLD);
1595 #else /* not BSD4_1 */
1596 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1597 sigsetmask (SIGEMPTYMASK);
1598 #else /* ordinary USG */
1599 #if 0
1600 signal (SIGCHLD, sigchld);
1601 #endif
1602 #endif /* ordinary USG */
1603 #endif /* not BSD4_1 */
1604 #endif /* SIGCHLD */
1605 #endif /* !POSIX_SIGNALS */
1607 if (pty_flag)
1608 child_setup_tty (xforkout);
1609 #ifdef WINDOWSNT
1610 pid = child_setup (xforkin, xforkout, xforkout,
1611 new_argv, 1, current_dir);
1612 #else /* not WINDOWSNT */
1613 child_setup (xforkin, xforkout, xforkout,
1614 new_argv, 1, current_dir);
1615 #endif /* not WINDOWSNT */
1617 environ = save_environ;
1620 UNBLOCK_INPUT;
1622 /* This runs in the Emacs process. */
1623 if (pid < 0)
1625 if (forkin >= 0)
1626 close (forkin);
1627 if (forkin != forkout && forkout >= 0)
1628 close (forkout);
1630 else
1632 /* vfork succeeded. */
1633 XSETFASTINT (XPROCESS (process)->pid, pid);
1635 #ifdef WINDOWSNT
1636 register_child (pid, inchannel);
1637 #endif /* WINDOWSNT */
1639 /* If the subfork execv fails, and it exits,
1640 this close hangs. I don't know why.
1641 So have an interrupt jar it loose. */
1642 stop_polling ();
1643 signal (SIGALRM, create_process_1);
1644 alarm (1);
1645 XPROCESS (process)->subtty = Qnil;
1646 if (forkin >= 0)
1647 close (forkin);
1648 alarm (0);
1649 start_polling ();
1650 if (forkin != forkout && forkout >= 0)
1651 close (forkout);
1653 #ifdef HAVE_PTYS
1654 if (pty_flag)
1655 XPROCESS (process)->tty_name = build_string (pty_name);
1656 else
1657 #endif
1658 XPROCESS (process)->tty_name = Qnil;
1661 /* Restore the signal state whether vfork succeeded or not.
1662 (We will signal an error, below, if it failed.) */
1663 #ifdef POSIX_SIGNALS
1664 #ifdef HAVE_VFORK
1665 /* Restore the parent's signal handlers. */
1666 sigaction (SIGINT, &sigint_action, 0);
1667 sigaction (SIGQUIT, &sigquit_action, 0);
1668 #ifdef AIX
1669 sigaction (SIGHUP, &sighup_action, 0);
1670 #endif
1671 #endif /* HAVE_VFORK */
1672 /* Stop blocking signals in the parent. */
1673 sigprocmask (SIG_SETMASK, &procmask, 0);
1674 #else /* !POSIX_SIGNALS */
1675 #ifdef SIGCHLD
1676 #ifdef BSD4_1
1677 sigrelse (SIGCHLD);
1678 #else /* not BSD4_1 */
1679 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1680 sigsetmask (SIGEMPTYMASK);
1681 #else /* ordinary USG */
1682 #if 0
1683 signal (SIGCHLD, sigchld);
1684 /* Now really handle any of these signals
1685 that came in during this function. */
1686 if (sigchld_deferred)
1687 kill (getpid (), SIGCHLD);
1688 #endif
1689 #endif /* ordinary USG */
1690 #endif /* not BSD4_1 */
1691 #endif /* SIGCHLD */
1692 #endif /* !POSIX_SIGNALS */
1694 /* Now generate the error if vfork failed. */
1695 if (pid < 0)
1696 report_file_error ("Doing vfork", Qnil);
1698 #endif /* not VMS */
1700 #ifdef HAVE_SOCKETS
1702 /* open a TCP network connection to a given HOST/SERVICE. Treated
1703 exactly like a normal process when reading and writing. Only
1704 differences are in status display and process deletion. A network
1705 connection has no PID; you cannot signal it. All you can do is
1706 deactivate and close it via delete-process */
1708 DEFUN ("open-network-stream", Fopen_network_stream, Sopen_network_stream,
1709 4, 4, 0,
1710 "Open a TCP connection for a service to a host.\n\
1711 Returns a subprocess-object to represent the connection.\n\
1712 Input and output work as for subprocesses; `delete-process' closes it.\n\
1713 Args are NAME BUFFER HOST SERVICE.\n\
1714 NAME is name for process. It is modified if necessary to make it unique.\n\
1715 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1716 Process output goes at end of that buffer, unless you specify\n\
1717 an output stream or filter function to handle the output.\n\
1718 BUFFER may be also nil, meaning that this process is not associated\n\
1719 with any buffer\n\
1720 Third arg is name of the host to connect to, or its IP address.\n\
1721 Fourth arg SERVICE is name of the service desired, or an integer\n\
1722 specifying a port number to connect to.")
1723 (name, buffer, host, service)
1724 Lisp_Object name, buffer, host, service;
1726 Lisp_Object proc;
1727 register int i;
1728 struct sockaddr_in address;
1729 struct servent *svc_info;
1730 struct hostent *host_info_ptr, host_info;
1731 char *(addr_list[2]);
1732 IN_ADDR numeric_addr;
1733 int s, outch, inch;
1734 char errstring[80];
1735 int port;
1736 struct hostent host_info_fixed;
1737 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1738 int retry = 0;
1739 int count = specpdl_ptr - specpdl;
1741 #ifdef WINDOWSNT
1742 /* Ensure socket support is loaded if available. */
1743 init_winsock (TRUE);
1744 #endif
1746 GCPRO4 (name, buffer, host, service);
1747 CHECK_STRING (name, 0);
1748 CHECK_STRING (host, 0);
1749 if (INTEGERP (service))
1750 port = htons ((unsigned short) XINT (service));
1751 else
1753 CHECK_STRING (service, 0);
1754 svc_info = getservbyname (XSTRING (service)->data, "tcp");
1755 if (svc_info == 0)
1756 error ("Unknown service \"%s\"", XSTRING (service)->data);
1757 port = svc_info->s_port;
1760 /* Slow down polling to every ten seconds.
1761 Some kernels have a bug which causes retrying connect to fail
1762 after a connect. Polling can interfere with gethostbyname too. */
1763 #ifdef POLL_FOR_INPUT
1764 bind_polling_period (10);
1765 #endif
1767 #ifndef TERM
1768 while (1)
1770 #ifdef TRY_AGAIN
1771 h_errno = 0;
1772 #endif
1773 immediate_quit = 1;
1774 QUIT;
1775 host_info_ptr = gethostbyname (XSTRING (host)->data);
1776 immediate_quit = 0;
1777 #ifdef TRY_AGAIN
1778 if (! (host_info_ptr == 0 && h_errno == TRY_AGAIN))
1779 #endif
1780 break;
1781 Fsleep_for (make_number (1), Qnil);
1783 if (host_info_ptr == 0)
1784 /* Attempt to interpret host as numeric inet address */
1786 numeric_addr = inet_addr ((char *) XSTRING (host)->data);
1787 if (NUMERIC_ADDR_ERROR)
1788 error ("Unknown host \"%s\"", XSTRING (host)->data);
1790 host_info_ptr = &host_info;
1791 host_info.h_name = 0;
1792 host_info.h_aliases = 0;
1793 host_info.h_addrtype = AF_INET;
1794 #ifdef h_addr
1795 /* Older machines have only one address slot called h_addr.
1796 Newer machines have h_addr_list, but #define h_addr to
1797 be its first element. */
1798 host_info.h_addr_list = &(addr_list[0]);
1799 #endif
1800 host_info.h_addr = (char*)(&numeric_addr);
1801 addr_list[1] = 0;
1802 /* numeric_addr isn't null-terminated; it has fixed length. */
1803 host_info.h_length = sizeof (numeric_addr);
1806 bzero (&address, sizeof address);
1807 bcopy (host_info_ptr->h_addr, (char *) &address.sin_addr,
1808 host_info_ptr->h_length);
1809 address.sin_family = host_info_ptr->h_addrtype;
1810 address.sin_port = port;
1812 s = socket (host_info_ptr->h_addrtype, SOCK_STREAM, 0);
1813 if (s < 0)
1814 report_file_error ("error creating socket", Fcons (name, Qnil));
1816 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1817 when connect is interrupted. So let's not let it get interrupted.
1818 Note we do not turn off polling, because polling is only used
1819 when not interrupt_input, and thus not normally used on the systems
1820 which have this bug. On systems which use polling, there's no way
1821 to quit if polling is turned off. */
1822 if (interrupt_input)
1823 unrequest_sigio ();
1825 loop:
1827 immediate_quit = 1;
1828 QUIT;
1830 if (connect (s, (struct sockaddr *) &address, sizeof address) == -1
1831 && errno != EISCONN)
1833 int xerrno = errno;
1835 immediate_quit = 0;
1837 if (errno == EINTR)
1838 goto loop;
1839 if (errno == EADDRINUSE && retry < 20)
1841 /* A delay here is needed on some FreeBSD systems,
1842 and it is harmless, since this retrying takes time anyway
1843 and should be infrequent. */
1844 Fsleep_for (make_number (1), Qnil);
1845 retry++;
1846 goto loop;
1849 close (s);
1851 if (interrupt_input)
1852 request_sigio ();
1854 errno = xerrno;
1855 report_file_error ("connection failed",
1856 Fcons (host, Fcons (name, Qnil)));
1859 immediate_quit = 0;
1861 #ifdef POLL_FOR_INPUT
1862 unbind_to (count, Qnil);
1863 #endif
1865 if (interrupt_input)
1866 request_sigio ();
1868 #else /* TERM */
1869 s = connect_server (0);
1870 if (s < 0)
1871 report_file_error ("error creating socket", Fcons (name, Qnil));
1872 send_command (s, C_PORT, 0, "%s:%d", XSTRING (host)->data, ntohs (port));
1873 send_command (s, C_DUMB, 1, 0);
1874 #endif /* TERM */
1876 inch = s;
1877 outch = s;
1879 if (!NILP (buffer))
1880 buffer = Fget_buffer_create (buffer);
1881 proc = make_process (name);
1883 chan_process[inch] = proc;
1885 #ifdef O_NONBLOCK
1886 fcntl (inch, F_SETFL, O_NONBLOCK);
1887 #else
1888 #ifdef O_NDELAY
1889 fcntl (inch, F_SETFL, O_NDELAY);
1890 #endif
1891 #endif
1893 XPROCESS (proc)->childp = Fcons (host, Fcons (service, Qnil));
1894 XPROCESS (proc)->command_channel_p = Qnil;
1895 XPROCESS (proc)->buffer = buffer;
1896 XPROCESS (proc)->sentinel = Qnil;
1897 XPROCESS (proc)->filter = Qnil;
1898 XPROCESS (proc)->command = Qnil;
1899 XPROCESS (proc)->pid = Qnil;
1900 XSETINT (XPROCESS (proc)->infd, inch);
1901 XSETINT (XPROCESS (proc)->outfd, outch);
1902 XPROCESS (proc)->status = Qrun;
1903 FD_SET (inch, &input_wait_mask);
1904 FD_SET (inch, &non_keyboard_wait_mask);
1905 if (inch > max_process_desc)
1906 max_process_desc = inch;
1908 if (!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters)
1909 || NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters))
1911 XPROCESS (proc)->decode_coding_system = Qnil;
1912 XPROCESS (proc)->encode_coding_system = Qnil;
1914 else
1916 /* Setup coding systems for communicating with the network stream. */
1917 struct gcpro gcpro1;
1918 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
1919 Lisp_Object coding_systems = Qt;
1920 Lisp_Object args[5], val;
1922 if (!NILP (Vcoding_system_for_read))
1923 val = Vcoding_system_for_read;
1924 else if (NILP (current_buffer->enable_multibyte_characters))
1925 /* We dare not decode end-of-line format by setting VAL to
1926 Qemacs_mule, because the existing Emacs Lisp libraries
1927 assume that they receive bare code including a sequene of
1928 CR LF. */
1929 val = Qnil;
1930 else
1932 args[0] = Qopen_network_stream, args[1] = name,
1933 args[2] = buffer, args[3] = host, args[4] = service;
1934 GCPRO1 (proc);
1935 coding_systems = Ffind_operation_coding_system (5, args);
1936 UNGCPRO;
1937 if (CONSP (coding_systems))
1938 val = XCONS (coding_systems)->car;
1939 else if (CONSP (Vdefault_process_coding_system))
1940 val = XCONS (Vdefault_process_coding_system)->car;
1941 else
1942 val = Qnil;
1944 XPROCESS (proc)->decode_coding_system = val;
1946 if (!NILP (Vcoding_system_for_write))
1947 val = Vcoding_system_for_write;
1948 else if (NILP (current_buffer->enable_multibyte_characters))
1949 val = Qnil;
1950 else
1952 if (EQ (coding_systems, Qt))
1954 args[0] = Qopen_network_stream, args[1] = name,
1955 args[2] = buffer, args[3] = host, args[4] = service;
1956 GCPRO1 (proc);
1957 coding_systems = Ffind_operation_coding_system (5, args);
1958 UNGCPRO;
1960 if (CONSP (coding_systems))
1961 val = XCONS (coding_systems)->cdr;
1962 else if (CONSP (Vdefault_process_coding_system))
1963 val = XCONS (Vdefault_process_coding_system)->cdr;
1964 else
1965 val = Qnil;
1967 XPROCESS (proc)->encode_coding_system = val;
1970 if (!proc_decode_coding_system[inch])
1971 proc_decode_coding_system[inch]
1972 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1973 setup_coding_system (XPROCESS (proc)->decode_coding_system,
1974 proc_decode_coding_system[inch]);
1975 if (!proc_encode_coding_system[outch])
1976 proc_encode_coding_system[outch]
1977 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1978 setup_coding_system (XPROCESS (proc)->encode_coding_system,
1979 proc_encode_coding_system[outch]);
1981 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
1982 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
1984 UNGCPRO;
1985 return proc;
1987 #endif /* HAVE_SOCKETS */
1989 deactivate_process (proc)
1990 Lisp_Object proc;
1992 register int inchannel, outchannel;
1993 register struct Lisp_Process *p = XPROCESS (proc);
1995 inchannel = XINT (p->infd);
1996 outchannel = XINT (p->outfd);
1998 if (inchannel >= 0)
2000 /* Beware SIGCHLD hereabouts. */
2001 flush_pending_output (inchannel);
2002 #ifdef VMS
2004 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
2005 sys$dassgn (outchannel);
2006 vs = get_vms_process_pointer (p->pid);
2007 if (vs)
2008 give_back_vms_process_stuff (vs);
2010 #else
2011 close (inchannel);
2012 if (outchannel >= 0 && outchannel != inchannel)
2013 close (outchannel);
2014 #endif
2016 XSETINT (p->infd, -1);
2017 XSETINT (p->outfd, -1);
2018 chan_process[inchannel] = Qnil;
2019 FD_CLR (inchannel, &input_wait_mask);
2020 FD_CLR (inchannel, &non_keyboard_wait_mask);
2021 if (inchannel == max_process_desc)
2023 int i;
2024 /* We just closed the highest-numbered process input descriptor,
2025 so recompute the highest-numbered one now. */
2026 max_process_desc = 0;
2027 for (i = 0; i < MAXDESC; i++)
2028 if (!NILP (chan_process[i]))
2029 max_process_desc = i;
2034 /* Close all descriptors currently in use for communication
2035 with subprocess. This is used in a newly-forked subprocess
2036 to get rid of irrelevant descriptors. */
2038 close_process_descs ()
2040 #ifndef WINDOWSNT
2041 int i;
2042 for (i = 0; i < MAXDESC; i++)
2044 Lisp_Object process;
2045 process = chan_process[i];
2046 if (!NILP (process))
2048 int in = XINT (XPROCESS (process)->infd);
2049 int out = XINT (XPROCESS (process)->outfd);
2050 if (in >= 0)
2051 close (in);
2052 if (out >= 0 && in != out)
2053 close (out);
2056 #endif
2059 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
2060 0, 3, 0,
2061 "Allow any pending output from subprocesses to be read by Emacs.\n\
2062 It is read into the process' buffers or given to their filter functions.\n\
2063 Non-nil arg PROCESS means do not return until some output has been received\n\
2064 from PROCESS.\n\
2065 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
2066 seconds and microseconds to wait; return after that much time whether\n\
2067 or not there is input.\n\
2068 Return non-nil iff we received any output before the timeout expired.")
2069 (process, timeout, timeout_msecs)
2070 register Lisp_Object process, timeout, timeout_msecs;
2072 int seconds;
2073 int useconds;
2075 if (! NILP (timeout_msecs))
2077 CHECK_NUMBER (timeout_msecs, 2);
2078 useconds = XINT (timeout_msecs);
2079 if (!INTEGERP (timeout))
2080 XSETINT (timeout, 0);
2083 int carry = useconds / 1000000;
2085 XSETINT (timeout, XINT (timeout) + carry);
2086 useconds -= carry * 1000000;
2088 /* I think this clause is necessary because C doesn't
2089 guarantee a particular rounding direction for negative
2090 integers. */
2091 if (useconds < 0)
2093 XSETINT (timeout, XINT (timeout) - 1);
2094 useconds += 1000000;
2098 else
2099 useconds = 0;
2101 if (! NILP (timeout))
2103 CHECK_NUMBER (timeout, 1);
2104 seconds = XINT (timeout);
2105 if (seconds < 0 || (seconds == 0 && useconds == 0))
2106 seconds = -1;
2108 else
2110 if (NILP (process))
2111 seconds = -1;
2112 else
2113 seconds = 0;
2116 if (NILP (process))
2117 XSETFASTINT (process, 0);
2119 return
2120 (wait_reading_process_input (seconds, useconds, process, 0)
2121 ? Qt : Qnil);
2124 /* This variable is different from waiting_for_input in keyboard.c.
2125 It is used to communicate to a lisp process-filter/sentinel (via the
2126 function Fwaiting_for_user_input_p below) whether emacs was waiting
2127 for user-input when that process-filter was called.
2128 waiting_for_input cannot be used as that is by definition 0 when
2129 lisp code is being evalled.
2130 This is also used in record_asynch_buffer_change.
2131 For that purpose, this must be 0
2132 when not inside wait_reading_process_input. */
2133 static int waiting_for_user_input_p;
2135 /* This is here so breakpoints can be put on it. */
2136 static
2137 wait_reading_process_input_1 ()
2141 /* Read and dispose of subprocess output while waiting for timeout to
2142 elapse and/or keyboard input to be available.
2144 TIME_LIMIT is:
2145 timeout in seconds, or
2146 zero for no limit, or
2147 -1 means gobble data immediately available but don't wait for any.
2149 MICROSECS is:
2150 an additional duration to wait, measured in microseconds.
2151 If this is nonzero and time_limit is 0, then the timeout
2152 consists of MICROSECS only.
2154 READ_KBD is a lisp value:
2155 0 to ignore keyboard input, or
2156 1 to return when input is available, or
2157 -1 meaning caller will actually read the input, so don't throw to
2158 the quit handler, or
2159 a cons cell, meaning wait until its car is non-nil
2160 (and gobble terminal input into the buffer if any arrives), or
2161 a process object, meaning wait until something arrives from that
2162 process. The return value is true iff we read some input from
2163 that process.
2165 DO_DISPLAY != 0 means redisplay should be done to show subprocess
2166 output that arrives.
2168 If READ_KBD is a pointer to a struct Lisp_Process, then the
2169 function returns true iff we received input from that process
2170 before the timeout elapsed.
2171 Otherwise, return true iff we received input from any process. */
2173 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
2174 int time_limit, microsecs;
2175 Lisp_Object read_kbd;
2176 int do_display;
2178 register int channel, nfds, m;
2179 static SELECT_TYPE Available;
2180 int xerrno;
2181 Lisp_Object proc;
2182 EMACS_TIME timeout, end_time, garbage;
2183 SELECT_TYPE Atemp;
2184 int wait_channel = -1;
2185 struct Lisp_Process *wait_proc = 0;
2186 int got_some_input = 0;
2187 Lisp_Object *wait_for_cell = 0;
2189 FD_ZERO (&Available);
2191 /* If read_kbd is a process to watch, set wait_proc and wait_channel
2192 accordingly. */
2193 if (PROCESSP (read_kbd))
2195 wait_proc = XPROCESS (read_kbd);
2196 wait_channel = XINT (wait_proc->infd);
2197 XSETFASTINT (read_kbd, 0);
2200 /* If waiting for non-nil in a cell, record where. */
2201 if (CONSP (read_kbd))
2203 wait_for_cell = &XCONS (read_kbd)->car;
2204 XSETFASTINT (read_kbd, 0);
2207 waiting_for_user_input_p = XINT (read_kbd);
2209 /* Since we may need to wait several times,
2210 compute the absolute time to return at. */
2211 if (time_limit || microsecs)
2213 EMACS_GET_TIME (end_time);
2214 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
2215 EMACS_ADD_TIME (end_time, end_time, timeout);
2217 #ifdef hpux
2218 /* AlainF 5-Jul-1996
2219 HP-UX 10.10 seem to have problems with signals coming in
2220 Causes "poll: interrupted system call" messages when Emacs is run
2221 in an X window
2222 Turn off periodic alarms (in case they are in use) */
2223 stop_polling ();
2224 #endif
2226 while (1)
2228 int timeout_reduced_for_timers = 0;
2230 /* If calling from keyboard input, do not quit
2231 since we want to return C-g as an input character.
2232 Otherwise, do pending quit if requested. */
2233 if (XINT (read_kbd) >= 0)
2234 QUIT;
2236 /* Exit now if the cell we're waiting for became non-nil. */
2237 if (wait_for_cell && ! NILP (*wait_for_cell))
2238 break;
2240 /* Compute time from now till when time limit is up */
2241 /* Exit if already run out */
2242 if (time_limit == -1)
2244 /* -1 specified for timeout means
2245 gobble output available now
2246 but don't wait at all. */
2248 EMACS_SET_SECS_USECS (timeout, 0, 0);
2250 else if (time_limit || microsecs)
2252 EMACS_GET_TIME (timeout);
2253 EMACS_SUB_TIME (timeout, end_time, timeout);
2254 if (EMACS_TIME_NEG_P (timeout))
2255 break;
2257 else
2259 EMACS_SET_SECS_USECS (timeout, 100000, 0);
2262 /* Normally we run timers here.
2263 But not if wait_for_cell; in those cases,
2264 the wait is supposed to be short,
2265 and those callers cannot handle running arbitrary Lisp code here. */
2266 if (! wait_for_cell)
2268 EMACS_TIME timer_delay;
2269 int old_timers_run;
2271 retry:
2272 old_timers_run = timers_run;
2273 timer_delay = timer_check (1);
2274 if (timers_run != old_timers_run && do_display)
2276 redisplay_preserve_echo_area ();
2277 /* We must retry, since a timer may have requeued itself
2278 and that could alter the time_delay. */
2279 goto retry;
2282 /* If there is unread keyboard input, also return. */
2283 if (XINT (read_kbd) != 0
2284 && requeued_events_pending_p ())
2285 break;
2287 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
2289 EMACS_TIME difference;
2290 EMACS_SUB_TIME (difference, timer_delay, timeout);
2291 if (EMACS_TIME_NEG_P (difference))
2293 timeout = timer_delay;
2294 timeout_reduced_for_timers = 1;
2297 /* If time_limit is -1, we are not going to wait at all. */
2298 else if (time_limit != -1)
2300 /* This is so a breakpoint can be put here. */
2301 wait_reading_process_input_1 ();
2305 /* Cause C-g and alarm signals to take immediate action,
2306 and cause input available signals to zero out timeout.
2308 It is important that we do this before checking for process
2309 activity. If we get a SIGCHLD after the explicit checks for
2310 process activity, timeout is the only way we will know. */
2311 if (XINT (read_kbd) < 0)
2312 set_waiting_for_input (&timeout);
2314 /* If status of something has changed, and no input is
2315 available, notify the user of the change right away. After
2316 this explicit check, we'll let the SIGCHLD handler zap
2317 timeout to get our attention. */
2318 if (update_tick != process_tick && do_display)
2320 Atemp = input_wait_mask;
2321 EMACS_SET_SECS_USECS (timeout, 0, 0);
2322 if ((select (max (max_process_desc, max_keyboard_desc) + 1,
2323 &Atemp, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2324 &timeout)
2325 <= 0))
2327 /* It's okay for us to do this and then continue with
2328 the loop, since timeout has already been zeroed out. */
2329 clear_waiting_for_input ();
2330 status_notify ();
2334 /* Don't wait for output from a non-running process. */
2335 if (wait_proc != 0 && !NILP (wait_proc->raw_status_low))
2336 update_status (wait_proc);
2337 if (wait_proc != 0
2338 && ! EQ (wait_proc->status, Qrun))
2340 int nread, total_nread = 0;
2342 clear_waiting_for_input ();
2343 XSETPROCESS (proc, wait_proc);
2345 /* Read data from the process, until we exhaust it. */
2346 while (XINT (wait_proc->infd) >= 0
2347 && (nread
2348 = read_process_output (proc, XINT (wait_proc->infd))))
2350 if (0 < nread)
2351 total_nread += nread;
2352 #ifdef EIO
2353 else if (nread == -1 && EIO == errno)
2354 break;
2355 #endif
2357 if (total_nread > 0 && do_display)
2358 redisplay_preserve_echo_area ();
2360 break;
2363 /* Wait till there is something to do */
2365 if (wait_for_cell)
2366 Available = non_process_wait_mask;
2367 else if (! XINT (read_kbd))
2368 Available = non_keyboard_wait_mask;
2369 else
2370 Available = input_wait_mask;
2372 /* If frame size has changed or the window is newly mapped,
2373 redisplay now, before we start to wait. There is a race
2374 condition here; if a SIGIO arrives between now and the select
2375 and indicates that a frame is trashed, the select may block
2376 displaying a trashed screen. */
2377 if (frame_garbaged && do_display)
2379 clear_waiting_for_input ();
2380 redisplay_preserve_echo_area ();
2381 if (XINT (read_kbd) < 0)
2382 set_waiting_for_input (&timeout);
2385 if (XINT (read_kbd) && detect_input_pending ())
2387 nfds = 0;
2388 FD_ZERO (&Available);
2390 else
2391 nfds = select (max (max_process_desc, max_keyboard_desc) + 1,
2392 &Available, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2393 &timeout);
2395 xerrno = errno;
2397 /* Make C-g and alarm signals set flags again */
2398 clear_waiting_for_input ();
2400 /* If we woke up due to SIGWINCH, actually change size now. */
2401 do_pending_window_change ();
2403 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
2404 /* We wanted the full specified time, so return now. */
2405 break;
2406 if (nfds < 0)
2408 if (xerrno == EINTR)
2409 FD_ZERO (&Available);
2410 #ifdef ultrix
2411 /* Ultrix select seems to return ENOMEM when it is
2412 interrupted. Treat it just like EINTR. Bleah. Note
2413 that we want to test for the "ultrix" CPP symbol, not
2414 "__ultrix__"; the latter is only defined under GCC, but
2415 not by DEC's bundled CC. -JimB */
2416 else if (xerrno == ENOMEM)
2417 FD_ZERO (&Available);
2418 #endif
2419 #ifdef ALLIANT
2420 /* This happens for no known reason on ALLIANT.
2421 I am guessing that this is the right response. -- RMS. */
2422 else if (xerrno == EFAULT)
2423 FD_ZERO (&Available);
2424 #endif
2425 else if (xerrno == EBADF)
2427 #ifdef AIX
2428 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
2429 the child's closure of the pts gives the parent a SIGHUP, and
2430 the ptc file descriptor is automatically closed,
2431 yielding EBADF here or at select() call above.
2432 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
2433 in m/ibmrt-aix.h), and here we just ignore the select error.
2434 Cleanup occurs c/o status_notify after SIGCLD. */
2435 FD_ZERO (&Available); /* Cannot depend on values returned */
2436 #else
2437 abort ();
2438 #endif
2440 else
2441 error ("select error: %s", strerror (xerrno));
2443 #if defined(sun) && !defined(USG5_4)
2444 else if (nfds > 0 && keyboard_bit_set (&Available)
2445 && interrupt_input)
2446 /* System sometimes fails to deliver SIGIO.
2448 David J. Mackenzie says that Emacs doesn't compile under
2449 Solaris if this code is enabled, thus the USG5_4 in the CPP
2450 conditional. "I haven't noticed any ill effects so far.
2451 If you find a Solaris expert somewhere, they might know
2452 better." */
2453 kill (getpid (), SIGIO);
2454 #endif
2456 #if 0 /* When polling is used, interrupt_input is 0,
2457 so get_input_pending should read the input.
2458 So this should not be needed. */
2459 /* If we are using polling for input,
2460 and we see input available, make it get read now.
2461 Otherwise it might not actually get read for a second.
2462 And on hpux, since we turn off polling in wait_reading_process_input,
2463 it might never get read at all if we don't spend much time
2464 outside of wait_reading_process_input. */
2465 if (XINT (read_kbd) && interrupt_input
2466 && keyboard_bit_set (&Available)
2467 && input_polling_used ())
2468 kill (getpid (), SIGALRM);
2469 #endif
2471 /* Check for keyboard input */
2472 /* If there is any, return immediately
2473 to give it higher priority than subprocesses */
2475 if (XINT (read_kbd) != 0
2476 && detect_input_pending_run_timers (do_display))
2478 swallow_events (do_display);
2479 if (detect_input_pending_run_timers (do_display))
2480 break;
2483 /* If there is unread keyboard input, also return. */
2484 if (XINT (read_kbd) != 0
2485 && requeued_events_pending_p ())
2486 break;
2488 /* If we are not checking for keyboard input now,
2489 do process events (but don't run any timers).
2490 This is so that X events will be processed.
2491 Otherwise they may have to wait until polling takes place.
2492 That would causes delays in pasting selections, for example.
2494 (We used to do this only if wait_for_cell.) */
2495 if (XINT (read_kbd) == 0 && detect_input_pending ())
2497 swallow_events (do_display);
2498 #if 0 /* Exiting when read_kbd doesn't request that seems wrong, though. */
2499 if (detect_input_pending ())
2500 break;
2501 #endif
2504 /* Exit now if the cell we're waiting for became non-nil. */
2505 if (wait_for_cell && ! NILP (*wait_for_cell))
2506 break;
2508 #ifdef SIGIO
2509 /* If we think we have keyboard input waiting, but didn't get SIGIO,
2510 go read it. This can happen with X on BSD after logging out.
2511 In that case, there really is no input and no SIGIO,
2512 but select says there is input. */
2514 if (XINT (read_kbd) && interrupt_input
2515 && keyboard_bit_set (&Available))
2516 kill (getpid (), SIGIO);
2517 #endif
2519 if (! wait_proc)
2520 got_some_input |= nfds > 0;
2522 /* If checking input just got us a size-change event from X,
2523 obey it now if we should. */
2524 if (XINT (read_kbd) || wait_for_cell)
2525 do_pending_window_change ();
2527 /* Check for data from a process. */
2528 /* Really FIRST_PROC_DESC should be 0 on Unix,
2529 but this is safer in the short run. */
2530 for (channel = 0; channel <= max_process_desc; channel++)
2532 if (FD_ISSET (channel, &Available)
2533 && FD_ISSET (channel, &non_keyboard_wait_mask))
2535 int nread;
2537 /* If waiting for this channel, arrange to return as
2538 soon as no more input to be processed. No more
2539 waiting. */
2540 if (wait_channel == channel)
2542 wait_channel = -1;
2543 time_limit = -1;
2544 got_some_input = 1;
2546 proc = chan_process[channel];
2547 if (NILP (proc))
2548 continue;
2550 /* Read data from the process, starting with our
2551 buffered-ahead character if we have one. */
2553 nread = read_process_output (proc, channel);
2554 if (nread > 0)
2556 /* Since read_process_output can run a filter,
2557 which can call accept-process-output,
2558 don't try to read from any other processes
2559 before doing the select again. */
2560 FD_ZERO (&Available);
2562 if (do_display)
2563 redisplay_preserve_echo_area ();
2565 #ifdef EWOULDBLOCK
2566 else if (nread == -1 && errno == EWOULDBLOCK)
2568 #endif
2569 /* ISC 4.1 defines both EWOULDBLOCK and O_NONBLOCK,
2570 and Emacs uses O_NONBLOCK, so what we get is EAGAIN. */
2571 #ifdef O_NONBLOCK
2572 else if (nread == -1 && errno == EAGAIN)
2574 #else
2575 #ifdef O_NDELAY
2576 else if (nread == -1 && errno == EAGAIN)
2578 /* Note that we cannot distinguish between no input
2579 available now and a closed pipe.
2580 With luck, a closed pipe will be accompanied by
2581 subprocess termination and SIGCHLD. */
2582 else if (nread == 0 && !NETCONN_P (proc))
2584 #endif /* O_NDELAY */
2585 #endif /* O_NONBLOCK */
2586 #ifdef HAVE_PTYS
2587 /* On some OSs with ptys, when the process on one end of
2588 a pty exits, the other end gets an error reading with
2589 errno = EIO instead of getting an EOF (0 bytes read).
2590 Therefore, if we get an error reading and errno =
2591 EIO, just continue, because the child process has
2592 exited and should clean itself up soon (e.g. when we
2593 get a SIGCHLD). */
2594 else if (nread == -1 && errno == EIO)
2596 #endif /* HAVE_PTYS */
2597 /* If we can detect process termination, don't consider the process
2598 gone just because its pipe is closed. */
2599 #ifdef SIGCHLD
2600 else if (nread == 0 && !NETCONN_P (proc))
2602 #endif
2603 else
2605 /* Preserve status of processes already terminated. */
2606 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2607 deactivate_process (proc);
2608 if (!NILP (XPROCESS (proc)->raw_status_low))
2609 update_status (XPROCESS (proc));
2610 if (EQ (XPROCESS (proc)->status, Qrun))
2611 XPROCESS (proc)->status
2612 = Fcons (Qexit, Fcons (make_number (256), Qnil));
2615 } /* end for each file descriptor */
2616 } /* end while exit conditions not met */
2618 waiting_for_user_input_p = 0;
2620 /* If calling from keyboard input, do not quit
2621 since we want to return C-g as an input character.
2622 Otherwise, do pending quit if requested. */
2623 if (XINT (read_kbd) >= 0)
2625 /* Prevent input_pending from remaining set if we quit. */
2626 clear_input_pending ();
2627 QUIT;
2629 #ifdef hpux
2630 /* AlainF 5-Jul-1996
2631 HP-UX 10.10 seems to have problems with signals coming in
2632 Causes "poll: interrupted system call" messages when Emacs is run
2633 in an X window
2634 Turn periodic alarms back on */
2635 start_polling ();
2636 #endif
2638 return got_some_input;
2641 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
2643 static Lisp_Object
2644 read_process_output_call (fun_and_args)
2645 Lisp_Object fun_and_args;
2647 return apply1 (XCONS (fun_and_args)->car, XCONS (fun_and_args)->cdr);
2650 static Lisp_Object
2651 read_process_output_error_handler (error)
2652 Lisp_Object error;
2654 cmd_error_internal (error, "error in process filter: ");
2655 Vinhibit_quit = Qt;
2656 update_echo_area ();
2657 Fsleep_for (make_number (2), Qnil);
2660 /* Read pending output from the process channel,
2661 starting with our buffered-ahead character if we have one.
2662 Yield number of decoded characters read.
2664 This function reads at most 1024 characters.
2665 If you want to read all available subprocess output,
2666 you must call it repeatedly until it returns zero.
2668 The characters read are decoded according to PROC's coding-system
2669 for decoding. */
2671 read_process_output (proc, channel)
2672 Lisp_Object proc;
2673 register int channel;
2675 register int nchars;
2676 char *chars;
2677 #ifdef VMS
2678 int chars_allocated = 0; /* If 1, `chars' should be freed later. */
2679 #else
2680 char buf[1024];
2681 #endif
2682 register Lisp_Object outstream;
2683 register struct buffer *old = current_buffer;
2684 register struct Lisp_Process *p = XPROCESS (proc);
2685 register int opoint;
2686 struct coding_system *coding = proc_decode_coding_system[channel];
2687 int chars_in_decoding_buf = 0; /* If 1, `chars' points
2688 XSTRING (p->decoding_buf)->data. */
2690 #ifdef VMS
2691 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2693 vs = get_vms_process_pointer (p->pid);
2694 if (vs)
2696 if (!vs->iosb[0])
2697 return(0); /* Really weird if it does this */
2698 if (!(vs->iosb[0] & 1))
2699 return -1; /* I/O error */
2701 else
2702 error ("Could not get VMS process pointer");
2703 chars = vs->inputBuffer;
2704 nchars = clean_vms_buffer (chars, vs->iosb[1]);
2705 if (nchars <= 0)
2707 start_vms_process_read (vs); /* Crank up the next read on the process */
2708 return 1; /* Nothing worth printing, say we got 1 */
2710 if (coding->carryover_size)
2712 /* The data carried over in the previous decoding should be
2713 prepended to the new data read to decode all together. */
2714 char *buf = (char *) xmalloc (nchars + coding->carryover_size);
2716 bcopy (coding->carryover, buf, coding->carryover_size);
2717 bcopy (chars, buf + coding->carryover_size, nchars);
2718 chars = buf;
2719 chars_allocated = 1;
2721 #else /* not VMS */
2723 if (coding->carryover_size)
2724 /* The data carried over in the previous decoding should be
2725 prepended to the new data read to decode all together. */
2726 bcopy (coding->carryover, buf, coding->carryover_size);
2728 if (proc_buffered_char[channel] < 0)
2729 nchars = read (channel, buf + coding->carryover_size,
2730 (sizeof buf) - coding->carryover_size);
2731 else
2733 buf[coding->carryover_size] = proc_buffered_char[channel];
2734 proc_buffered_char[channel] = -1;
2735 nchars = read (channel, buf + coding->carryover_size + 1,
2736 (sizeof buf) - coding->carryover_size - 1);
2737 if (nchars < 0)
2738 nchars = 1;
2739 else
2740 nchars = nchars + 1;
2742 chars = buf;
2743 #endif /* not VMS */
2745 /* At this point, NCHARS holds number of characters just received
2746 (including the one in proc_buffered_char[channel]). */
2747 if (nchars <= 0) return nchars;
2749 /* Now set NCHARS how many bytes we must decode. */
2750 nchars += coding->carryover_size;
2752 if (! CODING_REQUIRE_NO_CONVERSION (coding))
2754 int require = decoding_buffer_size (coding, nchars);
2755 int consumed, produced;
2757 if (XSTRING (p->decoding_buf)->size < require)
2758 p->decoding_buf = make_uninit_string (require);
2759 produced = decode_coding (coding, chars, XSTRING (p->decoding_buf)->data,
2760 nchars, XSTRING (p->decoding_buf)->size,
2761 &consumed);
2763 /* New coding-system might be found by `decode_coding'. */
2764 if (!EQ (p->decode_coding_system, coding->symbol))
2766 p->decode_coding_system = coding->symbol;
2768 /* Don't call setup_coding_system for
2769 proc_decode_coding_system[channel] here. It is done in
2770 detect_coding called via decode_coding above. */
2772 /* If coding-system for encoding is not yet decided, we set it
2773 as the same as coding-system for decoding. */
2774 if (NILP (p->encode_coding_system))
2776 p->encode_coding_system = coding->symbol;
2777 setup_coding_system (coding->symbol,
2778 proc_encode_coding_system[p->outfd]);
2781 #ifdef VMS
2782 /* Now we don't need the contents of `chars'. */
2783 if (chars_allocated)
2784 free (chars);
2785 #endif
2786 if (produced == 0)
2787 return 0;
2788 chars = (char *) XSTRING (p->decoding_buf)->data;
2789 nchars = produced;
2790 chars_in_decoding_buf = 1;
2792 #ifdef VMS
2793 else if (chars_allocated)
2795 /* Although we don't have to decode the received data, we must
2796 move it to an area which we don't have to free. */
2797 if (! STRINGP (p->decoding_buf)
2798 || XSTRING (p->decoding_buf)->size < nchars)
2799 p->decoding_buf = make_uninit_string (nchars);
2800 bcopy (chars, XSTRING (p->decoding_buf)->data, nchars);
2801 free (chars);
2802 chars = XSTRING (p->decoding_buf)->data;
2803 chars_in_decoding_buf = 1;
2805 #endif
2807 outstream = p->filter;
2808 if (!NILP (outstream))
2810 /* We inhibit quit here instead of just catching it so that
2811 hitting ^G when a filter happens to be running won't screw
2812 it up. */
2813 int count = specpdl_ptr - specpdl;
2814 Lisp_Object odeactivate;
2815 Lisp_Object obuffer, okeymap;
2816 int outer_running_asynch_code = running_asynch_code;
2818 /* No need to gcpro these, because all we do with them later
2819 is test them for EQness, and none of them should be a string. */
2820 odeactivate = Vdeactivate_mark;
2821 XSETBUFFER (obuffer, current_buffer);
2822 okeymap = current_buffer->keymap;
2824 specbind (Qinhibit_quit, Qt);
2825 specbind (Qlast_nonmenu_event, Qt);
2827 /* In case we get recursively called,
2828 and we already saved the match data nonrecursively,
2829 save the same match data in safely recursive fashion. */
2830 if (outer_running_asynch_code)
2832 Lisp_Object tem;
2833 /* Don't clobber the CURRENT match data, either! */
2834 tem = Fmatch_data (Qnil, Qnil);
2835 restore_match_data ();
2836 record_unwind_protect (Fstore_match_data, Fmatch_data (Qnil, Qnil));
2837 Fstore_match_data (tem);
2840 /* For speed, if a search happens within this code,
2841 save the match data in a special nonrecursive fashion. */
2842 running_asynch_code = 1;
2844 /* Read and dispose of the process output. */
2845 internal_condition_case_1 (read_process_output_call,
2846 Fcons (outstream,
2847 Fcons (proc,
2848 Fcons (make_string (chars,
2849 nchars),
2850 Qnil))),
2851 !NILP (Vdebug_on_error) ? Qnil : Qerror,
2852 read_process_output_error_handler);
2854 /* If we saved the match data nonrecursively, restore it now. */
2855 restore_match_data ();
2856 running_asynch_code = outer_running_asynch_code;
2858 /* Handling the process output should not deactivate the mark. */
2859 Vdeactivate_mark = odeactivate;
2861 #if 0 /* Call record_asynch_buffer_change unconditionally,
2862 because we might have changed minor modes or other things
2863 that affect key bindings. */
2864 if (! EQ (Fcurrent_buffer (), obuffer)
2865 || ! EQ (current_buffer->keymap, okeymap))
2866 #endif
2867 /* But do it only if the caller is actually going to read events.
2868 Otherwise there's no need to make him wake up, and it could
2869 cause trouble (for example it would make Fsit_for return). */
2870 if (waiting_for_user_input_p == -1)
2871 record_asynch_buffer_change ();
2873 #ifdef VMS
2874 start_vms_process_read (vs);
2875 #endif
2876 unbind_to (count, Qnil);
2877 return nchars;
2880 /* If no filter, write into buffer if it isn't dead. */
2881 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
2883 Lisp_Object old_read_only;
2884 int old_begv, old_zv;
2885 Lisp_Object odeactivate;
2886 int before;
2888 odeactivate = Vdeactivate_mark;
2890 Fset_buffer (p->buffer);
2891 opoint = PT;
2892 old_read_only = current_buffer->read_only;
2893 old_begv = BEGV;
2894 old_zv = ZV;
2896 current_buffer->read_only = Qnil;
2898 /* Insert new output into buffer
2899 at the current end-of-output marker,
2900 thus preserving logical ordering of input and output. */
2901 if (XMARKER (p->mark)->buffer)
2902 SET_PT (clip_to_bounds (BEGV, marker_position (p->mark), ZV));
2903 else
2904 SET_PT (ZV);
2905 before = PT;
2907 /* If the output marker is outside of the visible region, save
2908 the restriction and widen. */
2909 if (! (BEGV <= PT && PT <= ZV))
2910 Fwiden ();
2912 /* Insert before markers in case we are inserting where
2913 the buffer's mark is, and the user's next command is Meta-y. */
2914 if (chars_in_decoding_buf)
2915 insert_from_string_before_markers (p->decoding_buf, 0, nchars, 0);
2916 else
2917 insert_before_markers (chars, nchars);
2918 Fset_marker (p->mark, make_number (PT), p->buffer);
2920 update_mode_lines++;
2922 /* Make sure opoint and the old restrictions
2923 float ahead of any new text just as point would. */
2924 if (opoint >= before)
2925 opoint += PT - before;
2926 if (old_begv > before)
2927 old_begv += PT - before;
2928 if (old_zv >= before)
2929 old_zv += PT - before;
2931 /* If the restriction isn't what it should be, set it. */
2932 if (old_begv != BEGV || old_zv != ZV)
2933 Fnarrow_to_region (make_number (old_begv), make_number (old_zv));
2935 /* Handling the process output should not deactivate the mark. */
2936 Vdeactivate_mark = odeactivate;
2938 current_buffer->read_only = old_read_only;
2939 SET_PT (opoint);
2940 set_buffer_internal (old);
2942 #ifdef VMS
2943 start_vms_process_read (vs);
2944 #endif
2945 return nchars;
2948 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
2949 0, 0, 0,
2950 "Returns non-nil if emacs is waiting for input from the user.\n\
2951 This is intended for use by asynchronous process output filters and sentinels.")
2954 return (waiting_for_user_input_p ? Qt : Qnil);
2957 /* Sending data to subprocess */
2959 jmp_buf send_process_frame;
2961 SIGTYPE
2962 send_process_trap ()
2964 #ifdef BSD4_1
2965 sigrelse (SIGPIPE);
2966 sigrelse (SIGALRM);
2967 #endif /* BSD4_1 */
2968 longjmp (send_process_frame, 1);
2971 /* Send some data to process PROC.
2972 BUF is the beginning of the data; LEN is the number of characters.
2973 OBJECT is the Lisp object that the data comes from.
2975 The data is encoded by PROC's coding-system for encoding before it
2976 is sent. But if the data ends at the middle of multi-byte
2977 representation, that incomplete sequence of bytes are sent without
2978 being encoded. Should we store them in a buffer to prepend them to
2979 the data send later? */
2981 send_process (proc, buf, len, object)
2982 volatile Lisp_Object proc;
2983 unsigned char *buf;
2984 int len;
2985 Lisp_Object object;
2987 /* Use volatile to protect variables from being clobbered by longjmp. */
2988 int rv;
2989 volatile unsigned char *procname = XSTRING (XPROCESS (proc)->name)->data;
2990 struct coding_system *coding;
2991 struct gcpro gcpro1;
2993 GCPRO1 (object);
2995 #ifdef VMS
2996 struct Lisp_Process *p = XPROCESS (proc);
2997 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2998 #endif /* VMS */
3000 if (! NILP (XPROCESS (proc)->raw_status_low))
3001 update_status (XPROCESS (proc));
3002 if (! EQ (XPROCESS (proc)->status, Qrun))
3003 error ("Process %s not running", procname);
3004 if (XINT (XPROCESS (proc)->outfd) < 0)
3005 error ("Output file descriptor of %s is closed", procname);
3007 coding = proc_encode_coding_system[XINT (XPROCESS (proc)->outfd)];
3008 if (! CODING_MAY_REQUIRE_NO_CONVERSION (coding))
3010 int require = encoding_buffer_size (coding, len);
3011 int offset, dummy;
3012 unsigned char *temp_buf = NULL;
3014 /* Remember the offset of data because a string or a buffer may
3015 be relocated. Setting OFFSET to -1 means we don't have to
3016 care relocation. */
3017 offset = (BUFFERP (object)
3018 ? BUF_PTR_CHAR_POS (XBUFFER (object), buf)
3019 : (STRINGP (object)
3020 ? offset = buf - XSTRING (object)->data
3021 : -1));
3023 if (coding->carryover_size > 0)
3025 temp_buf = (unsigned char *) xmalloc (len + coding->carryover_size);
3027 if (offset >= 0)
3029 if (BUFFERP (object))
3030 buf = BUF_CHAR_ADDRESS (XBUFFER (object), offset);
3031 else if (STRINGP (object))
3032 buf = offset + XSTRING (object)->data;
3033 /* Now we don't have to care relocation. */
3034 offset = -1;
3036 bcopy (coding->carryover, temp_buf, coding->carryover_size);
3037 bcopy (buf, temp_buf + coding->carryover_size, len);
3038 buf = temp_buf;
3041 if (XSTRING (XPROCESS (proc)->encoding_buf)->size < require)
3043 XPROCESS (proc)->encoding_buf = make_uninit_string (require);
3045 if (offset >= 0)
3047 if (BUFFERP (object))
3048 buf = BUF_CHAR_ADDRESS (XBUFFER (object), offset);
3049 else if (STRINGP (object))
3050 buf = offset + XSTRING (object)->data;
3053 object = XPROCESS (proc)->encoding_buf;
3054 len = encode_coding (coding, buf, XSTRING (object)->data,
3055 len, XSTRING (object)->size, &dummy);
3056 buf = XSTRING (object)->data;
3057 if (temp_buf)
3058 xfree (temp_buf);
3061 #ifdef VMS
3062 vs = get_vms_process_pointer (p->pid);
3063 if (vs == 0)
3064 error ("Could not find this process: %x", p->pid);
3065 else if (write_to_vms_process (vs, buf, len))
3067 #else
3069 if (pty_max_bytes == 0)
3071 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
3072 pty_max_bytes = fpathconf (XFASTINT (XPROCESS (proc)->outfd),
3073 _PC_MAX_CANON);
3074 if (pty_max_bytes < 0)
3075 pty_max_bytes = 250;
3076 #else
3077 pty_max_bytes = 250;
3078 #endif
3079 /* Deduct one, to leave space for the eof. */
3080 pty_max_bytes--;
3083 if (!setjmp (send_process_frame))
3084 while (len > 0)
3086 int this = len;
3087 SIGTYPE (*old_sigpipe)();
3088 int flush_pty = 0;
3090 /* Decide how much data we can send in one batch.
3091 Long lines need to be split into multiple batches. */
3092 if (!NILP (XPROCESS (proc)->pty_flag))
3094 /* Starting this at zero is always correct when not the first iteration
3095 because the previous iteration ended by sending C-d.
3096 It may not be correct for the first iteration
3097 if a partial line was sent in a separate send_process call.
3098 If that proves worth handling, we need to save linepos
3099 in the process object. */
3100 int linepos = 0;
3101 unsigned char *ptr = buf;
3102 unsigned char *end = buf + len;
3104 /* Scan through this text for a line that is too long. */
3105 while (ptr != end && linepos < pty_max_bytes)
3107 if (*ptr == '\n')
3108 linepos = 0;
3109 else
3110 linepos++;
3111 ptr++;
3113 /* If we found one, break the line there
3114 and put in a C-d to force the buffer through. */
3115 this = ptr - buf;
3118 /* Send this batch, using one or more write calls. */
3119 while (this > 0)
3121 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
3122 rv = write (XINT (XPROCESS (proc)->outfd), buf, this);
3123 signal (SIGPIPE, old_sigpipe);
3125 if (rv < 0)
3127 if (0
3128 #ifdef EWOULDBLOCK
3129 || errno == EWOULDBLOCK
3130 #endif
3131 #ifdef EAGAIN
3132 || errno == EAGAIN
3133 #endif
3135 /* Buffer is full. Wait, accepting input;
3136 that may allow the program
3137 to finish doing output and read more. */
3139 Lisp_Object zero;
3140 int offset;
3142 /* Running filters might relocate buffers or strings.
3143 Arrange to relocate BUF. */
3144 if (BUFFERP (object))
3145 offset = BUF_PTR_CHAR_POS (XBUFFER (object), buf);
3146 else if (STRINGP (object))
3147 offset = buf - XSTRING (object)->data;
3149 XSETFASTINT (zero, 0);
3150 #ifdef EMACS_HAS_USECS
3151 wait_reading_process_input (0, 20000, zero, 0);
3152 #else
3153 wait_reading_process_input (1, 0, zero, 0);
3154 #endif
3156 if (BUFFERP (object))
3157 buf = BUF_CHAR_ADDRESS (XBUFFER (object), offset);
3158 else if (STRINGP (object))
3159 buf = offset + XSTRING (object)->data;
3161 rv = 0;
3163 else
3164 /* This is a real error. */
3165 report_file_error ("writing to process", Fcons (proc, Qnil));
3167 buf += rv;
3168 len -= rv;
3169 this -= rv;
3172 /* If we sent just part of the string, put in an EOF
3173 to force it through, before we send the rest. */
3174 if (len > 0)
3175 Fprocess_send_eof (proc);
3177 #endif
3178 else
3180 XPROCESS (proc)->raw_status_low = Qnil;
3181 XPROCESS (proc)->raw_status_high = Qnil;
3182 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
3183 XSETINT (XPROCESS (proc)->tick, ++process_tick);
3184 deactivate_process (proc);
3185 #ifdef VMS
3186 error ("Error writing to process %s; closed it", procname);
3187 #else
3188 error ("SIGPIPE raised on process %s; closed it", procname);
3189 #endif
3192 UNGCPRO;
3195 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
3196 3, 3, 0,
3197 "Send current contents of region as input to PROCESS.\n\
3198 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3199 nil, indicating the current buffer's process.\n\
3200 Called from program, takes three arguments, PROCESS, START and END.\n\
3201 If the region is more than 500 characters long,\n\
3202 it is sent in several bunches. This may happen even for shorter regions.\n\
3203 Output from processes can arrive in between bunches.")
3204 (process, start, end)
3205 Lisp_Object process, start, end;
3207 Lisp_Object proc;
3208 int start1;
3210 proc = get_process (process);
3211 validate_region (&start, &end);
3213 if (XINT (start) < GPT && XINT (end) > GPT)
3214 move_gap (XINT (start));
3216 start1 = XINT (start);
3217 send_process (proc, POS_ADDR (start1), XINT (end) - XINT (start),
3218 Fcurrent_buffer ());
3220 return Qnil;
3223 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
3224 2, 2, 0,
3225 "Send PROCESS the contents of STRING as input.\n\
3226 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3227 nil, indicating the current buffer's process.\n\
3228 If STRING is more than 500 characters long,\n\
3229 it is sent in several bunches. This may happen even for shorter strings.\n\
3230 Output from processes can arrive in between bunches.")
3231 (process, string)
3232 Lisp_Object process, string;
3234 Lisp_Object proc;
3235 CHECK_STRING (string, 1);
3236 proc = get_process (process);
3237 send_process (proc, XSTRING (string)->data, XSTRING (string)->size, string);
3238 return Qnil;
3241 /* send a signal number SIGNO to PROCESS.
3242 CURRENT_GROUP means send to the process group that currently owns
3243 the terminal being used to communicate with PROCESS.
3244 This is used for various commands in shell mode.
3245 If NOMSG is zero, insert signal-announcements into process's buffers
3246 right away.
3248 If we can, we try to signal PROCESS by sending control characters
3249 down the pty. This allows us to signal inferiors who have changed
3250 their uid, for which killpg would return an EPERM error. */
3252 static void
3253 process_send_signal (process, signo, current_group, nomsg)
3254 Lisp_Object process;
3255 int signo;
3256 Lisp_Object current_group;
3257 int nomsg;
3259 Lisp_Object proc;
3260 register struct Lisp_Process *p;
3261 int gid;
3262 int no_pgrp = 0;
3264 proc = get_process (process);
3265 p = XPROCESS (proc);
3267 if (!EQ (p->childp, Qt))
3268 error ("Process %s is not a subprocess",
3269 XSTRING (p->name)->data);
3270 if (XINT (p->infd) < 0)
3271 error ("Process %s is not active",
3272 XSTRING (p->name)->data);
3274 if (NILP (p->pty_flag))
3275 current_group = Qnil;
3277 /* If we are using pgrps, get a pgrp number and make it negative. */
3278 if (!NILP (current_group))
3280 #ifdef SIGNALS_VIA_CHARACTERS
3281 /* If possible, send signals to the entire pgrp
3282 by sending an input character to it. */
3284 /* TERMIOS is the latest and bestest, and seems most likely to
3285 work. If the system has it, use it. */
3286 #ifdef HAVE_TERMIOS
3287 struct termios t;
3289 switch (signo)
3291 case SIGINT:
3292 tcgetattr (XINT (p->infd), &t);
3293 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3294 return;
3296 case SIGQUIT:
3297 tcgetattr (XINT (p->infd), &t);
3298 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3299 return;
3301 case SIGTSTP:
3302 tcgetattr (XINT (p->infd), &t);
3303 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
3304 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3305 #else
3306 send_process (proc, &t.c_cc[VSUSP], 1, Qnil);
3307 #endif
3308 return;
3311 #else /* ! HAVE_TERMIOS */
3313 /* On Berkeley descendants, the following IOCTL's retrieve the
3314 current control characters. */
3315 #if defined (TIOCGLTC) && defined (TIOCGETC)
3317 struct tchars c;
3318 struct ltchars lc;
3320 switch (signo)
3322 case SIGINT:
3323 ioctl (XINT (p->infd), TIOCGETC, &c);
3324 send_process (proc, &c.t_intrc, 1, Qnil);
3325 return;
3326 case SIGQUIT:
3327 ioctl (XINT (p->infd), TIOCGETC, &c);
3328 send_process (proc, &c.t_quitc, 1, Qnil);
3329 return;
3330 #ifdef SIGTSTP
3331 case SIGTSTP:
3332 ioctl (XINT (p->infd), TIOCGLTC, &lc);
3333 send_process (proc, &lc.t_suspc, 1, Qnil);
3334 return;
3335 #endif /* ! defined (SIGTSTP) */
3338 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3340 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
3341 characters. */
3342 #ifdef TCGETA
3343 struct termio t;
3344 switch (signo)
3346 case SIGINT:
3347 ioctl (XINT (p->infd), TCGETA, &t);
3348 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3349 return;
3350 case SIGQUIT:
3351 ioctl (XINT (p->infd), TCGETA, &t);
3352 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3353 return;
3354 #ifdef SIGTSTP
3355 case SIGTSTP:
3356 ioctl (XINT (p->infd), TCGETA, &t);
3357 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3358 return;
3359 #endif /* ! defined (SIGTSTP) */
3361 #else /* ! defined (TCGETA) */
3362 Your configuration files are messed up.
3363 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
3364 you'd better be using one of the alternatives above! */
3365 #endif /* ! defined (TCGETA) */
3366 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3367 #endif /* ! defined HAVE_TERMIOS */
3368 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
3370 #ifdef TIOCGPGRP
3371 /* Get the pgrp using the tty itself, if we have that.
3372 Otherwise, use the pty to get the pgrp.
3373 On pfa systems, saka@pfu.fujitsu.co.JP writes:
3374 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
3375 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
3376 His patch indicates that if TIOCGPGRP returns an error, then
3377 we should just assume that p->pid is also the process group id. */
3379 int err;
3381 if (!NILP (p->subtty))
3382 err = ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
3383 else
3384 err = ioctl (XINT (p->infd), TIOCGPGRP, &gid);
3386 #ifdef pfa
3387 if (err == -1)
3388 gid = - XFASTINT (p->pid);
3389 #endif /* ! defined (pfa) */
3391 if (gid == -1)
3392 no_pgrp = 1;
3393 else
3394 gid = - gid;
3395 #else /* ! defined (TIOCGPGRP ) */
3396 /* Can't select pgrps on this system, so we know that
3397 the child itself heads the pgrp. */
3398 gid = - XFASTINT (p->pid);
3399 #endif /* ! defined (TIOCGPGRP ) */
3401 else
3402 gid = - XFASTINT (p->pid);
3404 switch (signo)
3406 #ifdef SIGCONT
3407 case SIGCONT:
3408 p->raw_status_low = Qnil;
3409 p->raw_status_high = Qnil;
3410 p->status = Qrun;
3411 XSETINT (p->tick, ++process_tick);
3412 if (!nomsg)
3413 status_notify ();
3414 break;
3415 #endif /* ! defined (SIGCONT) */
3416 case SIGINT:
3417 #ifdef VMS
3418 send_process (proc, "\003", 1, Qnil); /* ^C */
3419 goto whoosh;
3420 #endif
3421 case SIGQUIT:
3422 #ifdef VMS
3423 send_process (proc, "\031", 1, Qnil); /* ^Y */
3424 goto whoosh;
3425 #endif
3426 case SIGKILL:
3427 #ifdef VMS
3428 sys$forcex (&(XFASTINT (p->pid)), 0, 1);
3429 whoosh:
3430 #endif
3431 flush_pending_output (XINT (p->infd));
3432 break;
3435 /* If we don't have process groups, send the signal to the immediate
3436 subprocess. That isn't really right, but it's better than any
3437 obvious alternative. */
3438 if (no_pgrp)
3440 kill (XFASTINT (p->pid), signo);
3441 return;
3444 /* gid may be a pid, or minus a pgrp's number */
3445 #ifdef TIOCSIGSEND
3446 if (!NILP (current_group))
3447 ioctl (XINT (p->infd), TIOCSIGSEND, signo);
3448 else
3450 gid = - XFASTINT (p->pid);
3451 kill (gid, signo);
3453 #else /* ! defined (TIOCSIGSEND) */
3454 EMACS_KILLPG (-gid, signo);
3455 #endif /* ! defined (TIOCSIGSEND) */
3458 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
3459 "Interrupt process PROCESS. May be process or name of one.\n\
3460 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
3461 nil or no arg means current buffer's process.\n\
3462 Second arg CURRENT-GROUP non-nil means send signal to\n\
3463 the current process-group of the process's controlling terminal\n\
3464 rather than to the process's own process group.\n\
3465 If the process is a shell, this means interrupt current subjob\n\
3466 rather than the shell.")
3467 (process, current_group)
3468 Lisp_Object process, current_group;
3470 process_send_signal (process, SIGINT, current_group, 0);
3471 return process;
3474 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
3475 "Kill process PROCESS. May be process or name of one.\n\
3476 See function `interrupt-process' for more details on usage.")
3477 (process, current_group)
3478 Lisp_Object process, current_group;
3480 process_send_signal (process, SIGKILL, current_group, 0);
3481 return process;
3484 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
3485 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
3486 See function `interrupt-process' for more details on usage.")
3487 (process, current_group)
3488 Lisp_Object process, current_group;
3490 process_send_signal (process, SIGQUIT, current_group, 0);
3491 return process;
3494 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
3495 "Stop process PROCESS. May be process or name of one.\n\
3496 See function `interrupt-process' for more details on usage.")
3497 (process, current_group)
3498 Lisp_Object process, current_group;
3500 #ifndef SIGTSTP
3501 error ("no SIGTSTP support");
3502 #else
3503 process_send_signal (process, SIGTSTP, current_group, 0);
3504 #endif
3505 return process;
3508 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
3509 "Continue process PROCESS. May be process or name of one.\n\
3510 See function `interrupt-process' for more details on usage.")
3511 (process, current_group)
3512 Lisp_Object process, current_group;
3514 #ifdef SIGCONT
3515 process_send_signal (process, SIGCONT, current_group, 0);
3516 #else
3517 error ("no SIGCONT support");
3518 #endif
3519 return process;
3522 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
3523 2, 2, "nProcess number: \nnSignal code: ",
3524 "Send the process with process id PID the signal with code SIGCODE.\n\
3525 PID must be an integer. The process need not be a child of this Emacs.\n\
3526 SIGCODE may be an integer, or a symbol whose name is a signal name.")
3527 (pid, sigcode)
3528 Lisp_Object pid, sigcode;
3530 CHECK_NUMBER (pid, 0);
3532 #define handle_signal(NAME, VALUE) \
3533 else if (!strcmp (name, NAME)) \
3534 XSETINT (sigcode, VALUE)
3536 if (INTEGERP (sigcode))
3538 else
3540 unsigned char *name;
3542 CHECK_SYMBOL (sigcode, 1);
3543 name = XSYMBOL (sigcode)->name->data;
3545 if (0)
3547 #ifdef SIGHUP
3548 handle_signal ("SIGHUP", SIGHUP);
3549 #endif
3550 #ifdef SIGINT
3551 handle_signal ("SIGINT", SIGINT);
3552 #endif
3553 #ifdef SIGQUIT
3554 handle_signal ("SIGQUIT", SIGQUIT);
3555 #endif
3556 #ifdef SIGILL
3557 handle_signal ("SIGILL", SIGILL);
3558 #endif
3559 #ifdef SIGABRT
3560 handle_signal ("SIGABRT", SIGABRT);
3561 #endif
3562 #ifdef SIGEMT
3563 handle_signal ("SIGEMT", SIGEMT);
3564 #endif
3565 #ifdef SIGKILL
3566 handle_signal ("SIGKILL", SIGKILL);
3567 #endif
3568 #ifdef SIGFPE
3569 handle_signal ("SIGFPE", SIGFPE);
3570 #endif
3571 #ifdef SIGBUS
3572 handle_signal ("SIGBUS", SIGBUS);
3573 #endif
3574 #ifdef SIGSEGV
3575 handle_signal ("SIGSEGV", SIGSEGV);
3576 #endif
3577 #ifdef SIGSYS
3578 handle_signal ("SIGSYS", SIGSYS);
3579 #endif
3580 #ifdef SIGPIPE
3581 handle_signal ("SIGPIPE", SIGPIPE);
3582 #endif
3583 #ifdef SIGALRM
3584 handle_signal ("SIGALRM", SIGALRM);
3585 #endif
3586 #ifdef SIGTERM
3587 handle_signal ("SIGTERM", SIGTERM);
3588 #endif
3589 #ifdef SIGURG
3590 handle_signal ("SIGURG", SIGURG);
3591 #endif
3592 #ifdef SIGSTOP
3593 handle_signal ("SIGSTOP", SIGSTOP);
3594 #endif
3595 #ifdef SIGTSTP
3596 handle_signal ("SIGTSTP", SIGTSTP);
3597 #endif
3598 #ifdef SIGCONT
3599 handle_signal ("SIGCONT", SIGCONT);
3600 #endif
3601 #ifdef SIGCHLD
3602 handle_signal ("SIGCHLD", SIGCHLD);
3603 #endif
3604 #ifdef SIGTTIN
3605 handle_signal ("SIGTTIN", SIGTTIN);
3606 #endif
3607 #ifdef SIGTTOU
3608 handle_signal ("SIGTTOU", SIGTTOU);
3609 #endif
3610 #ifdef SIGIO
3611 handle_signal ("SIGIO", SIGIO);
3612 #endif
3613 #ifdef SIGXCPU
3614 handle_signal ("SIGXCPU", SIGXCPU);
3615 #endif
3616 #ifdef SIGXFSZ
3617 handle_signal ("SIGXFSZ", SIGXFSZ);
3618 #endif
3619 #ifdef SIGVTALRM
3620 handle_signal ("SIGVTALRM", SIGVTALRM);
3621 #endif
3622 #ifdef SIGPROF
3623 handle_signal ("SIGPROF", SIGPROF);
3624 #endif
3625 #ifdef SIGWINCH
3626 handle_signal ("SIGWINCH", SIGWINCH);
3627 #endif
3628 #ifdef SIGINFO
3629 handle_signal ("SIGINFO", SIGINFO);
3630 #endif
3631 #ifdef SIGUSR1
3632 handle_signal ("SIGUSR1", SIGUSR1);
3633 #endif
3634 #ifdef SIGUSR2
3635 handle_signal ("SIGUSR2", SIGUSR2);
3636 #endif
3637 else
3638 error ("Undefined signal name %s", name);
3641 #undef handle_signal
3643 return make_number (kill (XINT (pid), XINT (sigcode)));
3646 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
3647 "Make PROCESS see end-of-file in its input.\n\
3648 Eof comes after any text already sent to it.\n\
3649 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3650 nil, indicating the current buffer's process.\n\
3651 If PROCESS is a network connection, or is a process communicating\n\
3652 through a pipe (as opposed to a pty), then you cannot send any more\n\
3653 text to PROCESS after you call this function.")
3654 (process)
3655 Lisp_Object process;
3657 Lisp_Object proc;
3659 proc = get_process (process);
3661 /* Make sure the process is really alive. */
3662 if (! NILP (XPROCESS (proc)->raw_status_low))
3663 update_status (XPROCESS (proc));
3664 if (! EQ (XPROCESS (proc)->status, Qrun))
3665 error ("Process %s not running", XSTRING (XPROCESS (proc)->name)->data);
3667 #ifdef VMS
3668 send_process (proc, "\032", 1, Qnil); /* ^z */
3669 #else
3670 if (!NILP (XPROCESS (proc)->pty_flag))
3671 send_process (proc, "\004", 1, Qnil);
3672 else
3674 #ifdef HAVE_SHUTDOWN
3675 /* If this is a network connection, or socketpair is used
3676 for communication with the subprocess, call shutdown to cause EOF.
3677 (In some old system, shutdown to socketpair doesn't work.
3678 Then we just can't win.) */
3679 if (NILP (XPROCESS (proc)->pid)
3680 || XINT (XPROCESS (proc)->outfd) == XINT (XPROCESS (proc)->infd))
3681 shutdown (XINT (XPROCESS (proc)->outfd), 1);
3682 /* In case of socketpair, outfd == infd, so don't close it. */
3683 if (XINT (XPROCESS (proc)->outfd) != XINT (XPROCESS (proc)->infd))
3684 close (XINT (XPROCESS (proc)->outfd));
3685 #else /* not HAVE_SHUTDOWN */
3686 close (XINT (XPROCESS (proc)->outfd));
3687 #endif /* not HAVE_SHUTDOWN */
3688 XSETINT (XPROCESS (proc)->outfd, open (NULL_DEVICE, O_WRONLY));
3690 #endif /* VMS */
3691 return process;
3694 /* Kill all processes associated with `buffer'.
3695 If `buffer' is nil, kill all processes */
3697 kill_buffer_processes (buffer)
3698 Lisp_Object buffer;
3700 Lisp_Object tail, proc;
3702 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCONS (tail)->cdr)
3704 proc = XCONS (XCONS (tail)->car)->cdr;
3705 if (GC_PROCESSP (proc)
3706 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
3708 if (NETCONN_P (proc))
3709 Fdelete_process (proc);
3710 else if (XINT (XPROCESS (proc)->infd) >= 0)
3711 process_send_signal (proc, SIGHUP, Qnil, 1);
3716 /* On receipt of a signal that a child status has changed,
3717 loop asking about children with changed statuses until
3718 the system says there are no more.
3719 All we do is change the status;
3720 we do not run sentinels or print notifications.
3721 That is saved for the next time keyboard input is done,
3722 in order to avoid timing errors. */
3724 /** WARNING: this can be called during garbage collection.
3725 Therefore, it must not be fooled by the presence of mark bits in
3726 Lisp objects. */
3728 /** USG WARNING: Although it is not obvious from the documentation
3729 in signal(2), on a USG system the SIGCLD handler MUST NOT call
3730 signal() before executing at least one wait(), otherwise the handler
3731 will be called again, resulting in an infinite loop. The relevant
3732 portion of the documentation reads "SIGCLD signals will be queued
3733 and the signal-catching function will be continually reentered until
3734 the queue is empty". Invoking signal() causes the kernel to reexamine
3735 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
3737 SIGTYPE
3738 sigchld_handler (signo)
3739 int signo;
3741 int old_errno = errno;
3742 Lisp_Object proc;
3743 register struct Lisp_Process *p;
3744 extern EMACS_TIME *input_available_clear_time;
3746 #ifdef BSD4_1
3747 extern int sigheld;
3748 sigheld |= sigbit (SIGCHLD);
3749 #endif
3751 while (1)
3753 register int pid;
3754 WAITTYPE w;
3755 Lisp_Object tail;
3757 #ifdef WNOHANG
3758 #ifndef WUNTRACED
3759 #define WUNTRACED 0
3760 #endif /* no WUNTRACED */
3761 /* Keep trying to get a status until we get a definitive result. */
3764 errno = 0;
3765 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
3767 while (pid <= 0 && errno == EINTR);
3769 if (pid <= 0)
3771 /* A real failure. We have done all our job, so return. */
3773 /* USG systems forget handlers when they are used;
3774 must reestablish each time */
3775 #if defined (USG) && !defined (POSIX_SIGNALS)
3776 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
3777 #endif
3778 #ifdef BSD4_1
3779 sigheld &= ~sigbit (SIGCHLD);
3780 sigrelse (SIGCHLD);
3781 #endif
3782 errno = old_errno;
3783 return;
3785 #else
3786 pid = wait (&w);
3787 #endif /* no WNOHANG */
3789 /* Find the process that signaled us, and record its status. */
3791 p = 0;
3792 for (tail = Vprocess_alist; CONSP (tail); tail = XCONS (tail)->cdr)
3794 proc = XCONS (XCONS (tail)->car)->cdr;
3795 p = XPROCESS (proc);
3796 if (EQ (p->childp, Qt) && XFASTINT (p->pid) == pid)
3797 break;
3798 p = 0;
3801 /* Look for an asynchronous process whose pid hasn't been filled
3802 in yet. */
3803 if (p == 0)
3804 for (tail = Vprocess_alist; CONSP (tail); tail = XCONS (tail)->cdr)
3806 proc = XCONS (XCONS (tail)->car)->cdr;
3807 p = XPROCESS (proc);
3808 if (INTEGERP (p->pid) && XINT (p->pid) == -1)
3809 break;
3810 p = 0;
3813 /* Change the status of the process that was found. */
3814 if (p != 0)
3816 union { int i; WAITTYPE wt; } u;
3817 int clear_desc_flag = 0;
3819 XSETINT (p->tick, ++process_tick);
3820 u.wt = w;
3821 XSETINT (p->raw_status_low, u.i & 0xffff);
3822 XSETINT (p->raw_status_high, u.i >> 16);
3824 /* If process has terminated, stop waiting for its output. */
3825 if ((WIFSIGNALED (w) || WIFEXITED (w))
3826 && XINT (p->infd) >= 0)
3827 clear_desc_flag = 1;
3829 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
3830 if (clear_desc_flag)
3832 FD_CLR (XINT (p->infd), &input_wait_mask);
3833 FD_CLR (XINT (p->infd), &non_keyboard_wait_mask);
3836 /* Tell wait_reading_process_input that it needs to wake up and
3837 look around. */
3838 if (input_available_clear_time)
3839 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
3842 /* There was no asynchronous process found for that id. Check
3843 if we have a synchronous process. */
3844 else
3846 synch_process_alive = 0;
3848 /* Report the status of the synchronous process. */
3849 if (WIFEXITED (w))
3850 synch_process_retcode = WRETCODE (w);
3851 else if (WIFSIGNALED (w))
3853 int code = WTERMSIG (w);
3854 char *signame = 0;
3856 if (code < NSIG)
3858 #ifndef VMS
3859 /* Suppress warning if the table has const char *. */
3860 signame = (char *) sys_siglist[code];
3861 #else
3862 signame = sys_errlist[code];
3863 #endif
3865 if (signame == 0)
3866 signame = "unknown";
3868 synch_process_death = signame;
3871 /* Tell wait_reading_process_input that it needs to wake up and
3872 look around. */
3873 if (input_available_clear_time)
3874 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
3877 /* On some systems, we must return right away.
3878 If any more processes want to signal us, we will
3879 get another signal.
3880 Otherwise (on systems that have WNOHANG), loop around
3881 to use up all the processes that have something to tell us. */
3882 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG)) || defined (WINDOWSNT)
3883 #if defined (USG) && ! defined (POSIX_SIGNALS)
3884 signal (signo, sigchld_handler);
3885 #endif
3886 errno = old_errno;
3887 return;
3888 #endif /* USG, but not HPUX with WNOHANG */
3893 static Lisp_Object
3894 exec_sentinel_unwind (data)
3895 Lisp_Object data;
3897 XPROCESS (XCONS (data)->car)->sentinel = XCONS (data)->cdr;
3898 return Qnil;
3901 static Lisp_Object
3902 exec_sentinel_error_handler (error)
3903 Lisp_Object error;
3905 cmd_error_internal (error, "error in process sentinel: ");
3906 Vinhibit_quit = Qt;
3907 update_echo_area ();
3908 Fsleep_for (make_number (2), Qnil);
3911 static void
3912 exec_sentinel (proc, reason)
3913 Lisp_Object proc, reason;
3915 Lisp_Object sentinel, obuffer, odeactivate, okeymap;
3916 register struct Lisp_Process *p = XPROCESS (proc);
3917 int count = specpdl_ptr - specpdl;
3918 int outer_running_asynch_code = running_asynch_code;
3920 /* No need to gcpro these, because all we do with them later
3921 is test them for EQness, and none of them should be a string. */
3922 odeactivate = Vdeactivate_mark;
3923 XSETBUFFER (obuffer, current_buffer);
3924 okeymap = current_buffer->keymap;
3926 sentinel = p->sentinel;
3927 if (NILP (sentinel))
3928 return;
3930 /* Zilch the sentinel while it's running, to avoid recursive invocations;
3931 assure that it gets restored no matter how the sentinel exits. */
3932 p->sentinel = Qnil;
3933 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
3934 /* Inhibit quit so that random quits don't screw up a running filter. */
3935 specbind (Qinhibit_quit, Qt);
3936 specbind (Qlast_nonmenu_event, Qt);
3938 /* In case we get recursively called,
3939 and we already saved the match data nonrecursively,
3940 save the same match data in safely recursive fashion. */
3941 if (outer_running_asynch_code)
3943 Lisp_Object tem;
3944 tem = Fmatch_data (Qnil, Qnil);
3945 restore_match_data ();
3946 record_unwind_protect (Fstore_match_data, Fmatch_data (Qnil, Qnil));
3947 Fstore_match_data (tem);
3950 /* For speed, if a search happens within this code,
3951 save the match data in a special nonrecursive fashion. */
3952 running_asynch_code = 1;
3954 internal_condition_case_1 (read_process_output_call,
3955 Fcons (sentinel,
3956 Fcons (proc, Fcons (reason, Qnil))),
3957 !NILP (Vdebug_on_error) ? Qnil : Qerror,
3958 exec_sentinel_error_handler);
3960 /* If we saved the match data nonrecursively, restore it now. */
3961 restore_match_data ();
3962 running_asynch_code = outer_running_asynch_code;
3964 Vdeactivate_mark = odeactivate;
3965 #if 0
3966 if (! EQ (Fcurrent_buffer (), obuffer)
3967 || ! EQ (current_buffer->keymap, okeymap))
3968 #endif
3969 /* But do it only if the caller is actually going to read events.
3970 Otherwise there's no need to make him wake up, and it could
3971 cause trouble (for example it would make Fsit_for return). */
3972 if (waiting_for_user_input_p == -1)
3973 record_asynch_buffer_change ();
3975 unbind_to (count, Qnil);
3978 /* Report all recent events of a change in process status
3979 (either run the sentinel or output a message).
3980 This is done while Emacs is waiting for keyboard input. */
3982 status_notify ()
3984 register Lisp_Object proc, buffer;
3985 Lisp_Object tail, msg;
3986 struct gcpro gcpro1, gcpro2;
3988 tail = Qnil;
3989 msg = Qnil;
3990 /* We need to gcpro tail; if read_process_output calls a filter
3991 which deletes a process and removes the cons to which tail points
3992 from Vprocess_alist, and then causes a GC, tail is an unprotected
3993 reference. */
3994 GCPRO2 (tail, msg);
3996 /* Set this now, so that if new processes are created by sentinels
3997 that we run, we get called again to handle their status changes. */
3998 update_tick = process_tick;
4000 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
4002 Lisp_Object symbol;
4003 register struct Lisp_Process *p;
4005 proc = Fcdr (Fcar (tail));
4006 p = XPROCESS (proc);
4008 if (XINT (p->tick) != XINT (p->update_tick))
4010 XSETINT (p->update_tick, XINT (p->tick));
4012 /* If process is still active, read any output that remains. */
4013 while (! EQ (p->filter, Qt)
4014 && XINT (p->infd) >= 0
4015 && read_process_output (proc, XINT (p->infd)) > 0);
4017 buffer = p->buffer;
4019 /* Get the text to use for the message. */
4020 if (!NILP (p->raw_status_low))
4021 update_status (p);
4022 msg = status_message (p->status);
4024 /* If process is terminated, deactivate it or delete it. */
4025 symbol = p->status;
4026 if (CONSP (p->status))
4027 symbol = XCONS (p->status)->car;
4029 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
4030 || EQ (symbol, Qclosed))
4032 if (delete_exited_processes)
4033 remove_process (proc);
4034 else
4035 deactivate_process (proc);
4038 /* The actions above may have further incremented p->tick.
4039 So set p->update_tick again
4040 so that an error in the sentinel will not cause
4041 this code to be run again. */
4042 XSETINT (p->update_tick, XINT (p->tick));
4043 /* Now output the message suitably. */
4044 if (!NILP (p->sentinel))
4045 exec_sentinel (proc, msg);
4046 /* Don't bother with a message in the buffer
4047 when a process becomes runnable. */
4048 else if (!EQ (symbol, Qrun) && !NILP (buffer))
4050 Lisp_Object ro, tem;
4051 struct buffer *old = current_buffer;
4052 int opoint;
4053 int before;
4055 ro = XBUFFER (buffer)->read_only;
4057 /* Avoid error if buffer is deleted
4058 (probably that's why the process is dead, too) */
4059 if (NILP (XBUFFER (buffer)->name))
4060 continue;
4061 Fset_buffer (buffer);
4063 opoint = PT;
4064 /* Insert new output into buffer
4065 at the current end-of-output marker,
4066 thus preserving logical ordering of input and output. */
4067 if (XMARKER (p->mark)->buffer)
4068 SET_PT (marker_position (p->mark));
4069 else
4070 SET_PT (ZV);
4072 before = PT;
4074 tem = current_buffer->read_only;
4075 current_buffer->read_only = Qnil;
4076 insert_string ("\nProcess ");
4077 Finsert (1, &p->name);
4078 insert_string (" ");
4079 Finsert (1, &msg);
4080 current_buffer->read_only = tem;
4081 Fset_marker (p->mark, make_number (PT), p->buffer);
4083 if (opoint >= before)
4084 SET_PT (opoint + (PT - before));
4085 else
4086 SET_PT (opoint);
4088 set_buffer_internal (old);
4091 } /* end for */
4093 update_mode_lines++; /* in case buffers use %s in mode-line-format */
4094 redisplay_preserve_echo_area ();
4096 UNGCPRO;
4100 DEFUN ("set-process-coding-system", Fset_process_coding_system,
4101 Sset_process_coding_system, 1, 3, 0,
4102 "Set coding systems of PROCESS to DECODING (input from the process) and\n\
4103 ENCODING (output to the process).")
4104 (proc, decoding, encoding)
4105 register Lisp_Object proc, decoding, encoding;
4107 register struct Lisp_Process *p;
4109 CHECK_PROCESS (proc, 0);
4110 p = XPROCESS (proc);
4111 if (XINT (p->infd) < 0)
4112 error ("Input file descriptor of %s closed", XSTRING (p->name)->data);
4113 if (XINT (p->outfd) < 0)
4114 error ("Output file descriptor of %s closed", XSTRING (p->name)->data);
4116 p->decode_coding_system = Fcheck_coding_system (decoding);
4117 p->encode_coding_system = Fcheck_coding_system (encoding);
4118 setup_coding_system (decoding,
4119 proc_decode_coding_system[XINT (p->infd)]);
4120 setup_coding_system (encoding,
4121 proc_encode_coding_system[XINT (p->outfd)]);
4123 return Qnil;
4126 DEFUN ("process-coding-system",
4127 Fprocess_coding_system, Sprocess_coding_system, 1, 1, 0,
4128 "Return a cons of coding systems for decoding and encoding of PROCESS.")
4129 (proc)
4130 register Lisp_Object proc;
4132 CHECK_PROCESS (proc, 0);
4133 return Fcons (XPROCESS (proc)->decode_coding_system,
4134 XPROCESS (proc)->encode_coding_system);
4137 /* The first time this is called, assume keyboard input comes from DESC
4138 instead of from where we used to expect it.
4139 Subsequent calls mean assume input keyboard can come from DESC
4140 in addition to other places. */
4142 static int add_keyboard_wait_descriptor_called_flag;
4144 void
4145 add_keyboard_wait_descriptor (desc)
4146 int desc;
4148 if (! add_keyboard_wait_descriptor_called_flag)
4149 FD_CLR (0, &input_wait_mask);
4150 add_keyboard_wait_descriptor_called_flag = 1;
4151 FD_SET (desc, &input_wait_mask);
4152 FD_SET (desc, &non_process_wait_mask);
4153 if (desc > max_keyboard_desc)
4154 max_keyboard_desc = desc;
4157 /* From now on, do not expect DESC to give keyboard input. */
4159 void
4160 delete_keyboard_wait_descriptor (desc)
4161 int desc;
4163 int fd;
4164 int lim = max_keyboard_desc;
4166 FD_CLR (desc, &input_wait_mask);
4167 FD_CLR (desc, &non_process_wait_mask);
4169 if (desc == max_keyboard_desc)
4170 for (fd = 0; fd < lim; fd++)
4171 if (FD_ISSET (fd, &input_wait_mask)
4172 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4173 max_keyboard_desc = fd;
4176 /* Return nonzero if *MASK has a bit set
4177 that corresponds to one of the keyboard input descriptors. */
4180 keyboard_bit_set (mask)
4181 SELECT_TYPE *mask;
4183 int fd;
4185 for (fd = 0; fd <= max_keyboard_desc; fd++)
4186 if (FD_ISSET (fd, mask) && FD_ISSET (fd, &input_wait_mask)
4187 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4188 return 1;
4190 return 0;
4193 init_process ()
4195 register int i;
4197 #ifdef SIGCHLD
4198 #ifndef CANNOT_DUMP
4199 if (! noninteractive || initialized)
4200 #endif
4201 signal (SIGCHLD, sigchld_handler);
4202 #endif
4204 FD_ZERO (&input_wait_mask);
4205 FD_ZERO (&non_keyboard_wait_mask);
4206 FD_ZERO (&non_process_wait_mask);
4207 max_process_desc = 0;
4209 FD_SET (0, &input_wait_mask);
4211 Vprocess_alist = Qnil;
4212 for (i = 0; i < MAXDESC; i++)
4214 chan_process[i] = Qnil;
4215 proc_buffered_char[i] = -1;
4217 bzero (proc_decode_coding_system, sizeof proc_decode_coding_system);
4218 bzero (proc_encode_coding_system, sizeof proc_encode_coding_system);
4221 syms_of_process ()
4223 Qprocessp = intern ("processp");
4224 staticpro (&Qprocessp);
4225 Qrun = intern ("run");
4226 staticpro (&Qrun);
4227 Qstop = intern ("stop");
4228 staticpro (&Qstop);
4229 Qsignal = intern ("signal");
4230 staticpro (&Qsignal);
4232 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
4233 here again.
4235 Qexit = intern ("exit");
4236 staticpro (&Qexit); */
4238 Qopen = intern ("open");
4239 staticpro (&Qopen);
4240 Qclosed = intern ("closed");
4241 staticpro (&Qclosed);
4243 Qlast_nonmenu_event = intern ("last-nonmenu-event");
4244 staticpro (&Qlast_nonmenu_event);
4246 staticpro (&Vprocess_alist);
4248 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
4249 "*Non-nil means delete processes immediately when they exit.\n\
4250 nil means don't delete them until `list-processes' is run.");
4252 delete_exited_processes = 1;
4254 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
4255 "Control type of device used to communicate with subprocesses.\n\
4256 Values are nil to use a pipe, or t or `pty' to use a pty.\n\
4257 The value has no effect if the system has no ptys or if all ptys are busy:\n\
4258 then a pipe is used in any case.\n\
4259 The value takes effect when `start-process' is called.");
4260 Vprocess_connection_type = Qt;
4262 defsubr (&Sprocessp);
4263 defsubr (&Sget_process);
4264 defsubr (&Sget_buffer_process);
4265 defsubr (&Sdelete_process);
4266 defsubr (&Sprocess_status);
4267 defsubr (&Sprocess_exit_status);
4268 defsubr (&Sprocess_id);
4269 defsubr (&Sprocess_name);
4270 defsubr (&Sprocess_tty_name);
4271 defsubr (&Sprocess_command);
4272 defsubr (&Sset_process_buffer);
4273 defsubr (&Sprocess_buffer);
4274 defsubr (&Sprocess_mark);
4275 defsubr (&Sset_process_filter);
4276 defsubr (&Sprocess_filter);
4277 defsubr (&Sset_process_sentinel);
4278 defsubr (&Sprocess_sentinel);
4279 defsubr (&Sset_process_window_size);
4280 defsubr (&Sprocess_kill_without_query);
4281 defsubr (&Sprocess_contact);
4282 defsubr (&Slist_processes);
4283 defsubr (&Sprocess_list);
4284 defsubr (&Sstart_process);
4285 #ifdef HAVE_SOCKETS
4286 defsubr (&Sopen_network_stream);
4287 #endif /* HAVE_SOCKETS */
4288 defsubr (&Saccept_process_output);
4289 defsubr (&Sprocess_send_region);
4290 defsubr (&Sprocess_send_string);
4291 defsubr (&Sinterrupt_process);
4292 defsubr (&Skill_process);
4293 defsubr (&Squit_process);
4294 defsubr (&Sstop_process);
4295 defsubr (&Scontinue_process);
4296 defsubr (&Sprocess_send_eof);
4297 defsubr (&Ssignal_process);
4298 defsubr (&Swaiting_for_user_input_p);
4299 /* defsubr (&Sprocess_connection); */
4300 defsubr (&Sset_process_coding_system);
4301 defsubr (&Sprocess_coding_system);
4305 #else /* not subprocesses */
4307 #include <sys/types.h>
4308 #include <errno.h>
4310 #include "lisp.h"
4311 #include "systime.h"
4312 #include "termopts.h"
4313 #include "sysselect.h"
4315 extern int frame_garbaged;
4317 extern EMACS_TIME timer_check ();
4318 extern int timers_run;
4320 /* As described above, except assuming that there are no subprocesses:
4322 Wait for timeout to elapse and/or keyboard input to be available.
4324 time_limit is:
4325 timeout in seconds, or
4326 zero for no limit, or
4327 -1 means gobble data immediately available but don't wait for any.
4329 read_kbd is a Lisp_Object:
4330 0 to ignore keyboard input, or
4331 1 to return when input is available, or
4332 -1 means caller will actually read the input, so don't throw to
4333 the quit handler.
4334 a cons cell, meaning wait until its car is non-nil
4335 (and gobble terminal input into the buffer if any arrives), or
4336 We know that read_kbd will never be a Lisp_Process, since
4337 `subprocesses' isn't defined.
4339 do_display != 0 means redisplay should be done to show subprocess
4340 output that arrives.
4342 Return true iff we received input from any process. */
4345 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
4346 int time_limit, microsecs;
4347 Lisp_Object read_kbd;
4348 int do_display;
4350 EMACS_TIME end_time, timeout;
4351 SELECT_TYPE waitchannels;
4352 int xerrno;
4353 Lisp_Object *wait_for_cell = 0;
4355 /* If waiting for non-nil in a cell, record where. */
4356 if (CONSP (read_kbd))
4358 wait_for_cell = &XCONS (read_kbd)->car;
4359 XSETFASTINT (read_kbd, 0);
4362 /* What does time_limit really mean? */
4363 if (time_limit || microsecs)
4365 if (time_limit == -1)
4366 /* In fact, it's zero. */
4367 EMACS_SET_SECS_USECS (timeout, 0, 0);
4368 else
4369 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
4371 /* How far in the future is that? */
4372 EMACS_GET_TIME (end_time);
4373 EMACS_ADD_TIME (end_time, end_time, timeout);
4375 else
4376 /* It's infinite. */
4377 EMACS_SET_SECS_USECS (timeout, 100000, 0);
4379 /* Turn off periodic alarms (in case they are in use)
4380 because the select emulator uses alarms. */
4381 stop_polling ();
4383 for (;;)
4385 int nfds;
4386 int timeout_reduced_for_timers = 0;
4388 /* If calling from keyboard input, do not quit
4389 since we want to return C-g as an input character.
4390 Otherwise, do pending quit if requested. */
4391 if (XINT (read_kbd) >= 0)
4392 QUIT;
4394 /* Exit now if the cell we're waiting for became non-nil. */
4395 if (wait_for_cell && ! NILP (*wait_for_cell))
4396 break;
4398 /* Compute time from now till when time limit is up */
4399 /* Exit if already run out */
4400 if (time_limit > 0 || microsecs)
4402 EMACS_GET_TIME (timeout);
4403 EMACS_SUB_TIME (timeout, end_time, timeout);
4404 if (EMACS_TIME_NEG_P (timeout))
4405 break;
4408 /* If our caller will not immediately handle keyboard events,
4409 run timer events directly.
4410 (Callers that will immediately read keyboard events
4411 call timer_delay on their own.) */
4412 if (! wait_for_cell)
4414 EMACS_TIME timer_delay;
4415 int old_timers_run;
4417 retry:
4418 old_timers_run = timers_run;
4419 timer_delay = timer_check (1);
4420 if (timers_run != old_timers_run && do_display)
4422 redisplay_preserve_echo_area ();
4423 /* We must retry, since a timer may have requeued itself
4424 and that could alter the time delay. */
4425 goto retry;
4428 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
4430 EMACS_TIME difference;
4431 EMACS_SUB_TIME (difference, timer_delay, timeout);
4432 if (EMACS_TIME_NEG_P (difference))
4434 timeout = timer_delay;
4435 timeout_reduced_for_timers = 1;
4440 /* Cause C-g and alarm signals to take immediate action,
4441 and cause input available signals to zero out timeout. */
4442 if (XINT (read_kbd) < 0)
4443 set_waiting_for_input (&timeout);
4445 /* Wait till there is something to do. */
4447 if (! XINT (read_kbd) && wait_for_cell == 0)
4448 FD_ZERO (&waitchannels);
4449 else
4450 FD_SET (0, &waitchannels);
4452 /* If a frame has been newly mapped and needs updating,
4453 reprocess its display stuff. */
4454 if (frame_garbaged && do_display)
4456 clear_waiting_for_input ();
4457 redisplay_preserve_echo_area ();
4458 if (XINT (read_kbd) < 0)
4459 set_waiting_for_input (&timeout);
4462 if (XINT (read_kbd) && detect_input_pending ())
4464 nfds = 0;
4465 FD_ZERO (&waitchannels);
4467 else
4468 nfds = select (1, &waitchannels, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
4469 &timeout);
4471 xerrno = errno;
4473 /* Make C-g and alarm signals set flags again */
4474 clear_waiting_for_input ();
4476 /* If we woke up due to SIGWINCH, actually change size now. */
4477 do_pending_window_change ();
4479 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
4480 /* We waited the full specified time, so return now. */
4481 break;
4483 if (nfds == -1)
4485 /* If the system call was interrupted, then go around the
4486 loop again. */
4487 if (xerrno == EINTR)
4488 FD_ZERO (&waitchannels);
4489 else
4490 error ("select error: %s", strerror (xerrno));
4492 #ifdef sun
4493 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
4494 /* System sometimes fails to deliver SIGIO. */
4495 kill (getpid (), SIGIO);
4496 #endif
4497 #ifdef SIGIO
4498 if (XINT (read_kbd) && interrupt_input && (waitchannels & 1))
4499 kill (getpid (), SIGIO);
4500 #endif
4502 /* Check for keyboard input */
4504 if ((XINT (read_kbd) != 0)
4505 && detect_input_pending_run_timers (do_display))
4507 swallow_events (do_display);
4508 if (detect_input_pending_run_timers (do_display))
4509 break;
4512 /* If wait_for_cell. check for keyboard input
4513 but don't run any timers.
4514 ??? (It seems wrong to me to check for keyboard
4515 input at all when wait_for_cell, but the code
4516 has been this way since July 1994.
4517 Try changing this after version 19.31.) */
4518 if (wait_for_cell
4519 && detect_input_pending ())
4521 swallow_events (do_display);
4522 if (detect_input_pending ())
4523 break;
4526 /* Exit now if the cell we're waiting for became non-nil. */
4527 if (wait_for_cell && ! NILP (*wait_for_cell))
4528 break;
4531 start_polling ();
4533 return 0;
4537 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
4538 /* Don't confuse make-docfile by having two doc strings for this function.
4539 make-docfile does not pay attention to #if, for good reason! */
4541 (name)
4542 register Lisp_Object name;
4544 return Qnil;
4547 /* Kill all processes associated with `buffer'.
4548 If `buffer' is nil, kill all processes.
4549 Since we have no subprocesses, this does nothing. */
4551 kill_buffer_processes (buffer)
4552 Lisp_Object buffer;
4556 init_process ()
4560 syms_of_process ()
4562 defsubr (&Sget_buffer_process);
4566 #endif /* not subprocesses */