1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1993 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
25 /* This file is split into two parts by the following preprocessor
26 conditional. The 'then' clause contains all of the support for
27 asynchronous subprocesses. The 'else' clause contains stub
28 versions of some of the asynchronous subprocess routines that are
29 often called elsewhere in Emacs, so we don't have to #ifdef the
30 sections that call them. */
38 #include <sys/types.h> /* some typedefs are used in sys/file.h */
42 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
43 #include <sys/socket.h>
45 #include <netinet/in.h>
46 #include <arpa/inet.h>
47 #endif /* HAVE_SOCKETS */
49 #if defined(BSD) || defined(STRIDE)
50 #include <sys/ioctl.h>
51 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
53 #endif /* HAVE_PTYS and no O_NDELAY */
54 #endif /* BSD or STRIDE */
61 #include <sys/sysmacros.h> /* for "minor" */
71 #include "termhooks.h"
76 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
77 /* Qexit is declared and initialized in eval.c. */
79 /* a process object is a network connection when its childp field is neither
80 Qt nor Qnil but is instead a string (name of foreign host we
81 are connected to + name of port we are connected to) */
84 static Lisp_Object stream_process
;
86 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
88 #define NETCONN_P(p) 0
89 #endif /* HAVE_SOCKETS */
91 /* Define first descriptor number available for subprocesses. */
93 #define FIRST_PROC_DESC 1
95 #define FIRST_PROC_DESC 3
98 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
101 #if !defined (SIGCHLD) && defined (SIGCLD)
102 #define SIGCHLD SIGCLD
105 #include "syssignal.h"
107 /* Define the structure that the wait system call stores.
108 On many systems, there is a structure defined for this.
109 But on vanilla-ish USG systems there is not. */
113 #if (!defined (BSD) && !defined (UNIPLUS) && !defined (STRIDE) && !(defined (HPUX) && !defined (NOMULTIPLEJOBS)) && !defined (HAVE_WAIT_HEADER)) || defined (LINUX)
115 #define WIFSTOPPED(w) ((w&0377) == 0177)
116 #define WIFSIGNALED(w) ((w&0377) != 0177 && (w&~0377) == 0)
117 #define WIFEXITED(w) ((w&0377) == 0)
118 #define WRETCODE(w) (w >> 8)
119 #define WSTOPSIG(w) (w >> 8)
120 #define WTERMSIG(w) (w & 0377)
122 #define WCOREDUMP(w) ((w&0200) != 0)
128 #include <sys/wait.h>
129 #endif /* not BSD 4.1 */
131 #define WAITTYPE union wait
132 #define WRETCODE(w) w.w_retcode
133 #define WCOREDUMP(w) w.w_coredump
136 /* HPUX version 7 has broken definitions of these. */
145 #define WTERMSIG(w) w.w_termsig
148 #define WSTOPSIG(w) w.w_stopsig
151 #define WIFSTOPPED(w) (WTERMSIG (w) == 0177)
154 #define WIFSIGNALED(w) (WTERMSIG (w) != 0177 && (WSTOPSIG (w)) == 0)
157 #define WIFEXITED(w) (WTERMSIG (w) == 0)
159 #endif /* BSD or UNIPLUS or STRIDE */
160 #endif /* no WAITTYPE */
163 #define WIFSTOPPED(w) 0
164 #define WIFSIGNALED(w) 0
165 #define WIFEXITED(w) ((w) != -1)
166 #define WRETCODE(w) (w)
167 #define WSTOPSIG(w) (w)
168 #define WCOREDUMP(w) 0
169 #define WTERMSIG(w) (w)
178 extern char *sys_errlist
[];
183 extern char *sys_siglist
[];
186 char *sys_siglist
[] =
192 "illegal instruction",
196 "floating point exception",
199 "segmentation violation",
200 "bad argument to system call",
201 "write on a pipe with no one to read it",
203 "software termination signal from kill",
205 "sendable stop signal not from tty",
206 "stop signal from tty",
207 "continue a stopped process",
208 "child status has changed",
209 "background read attempted from control tty",
210 "background write attempted from control tty",
211 "input record available at control tty",
212 "exceeded CPU time limit",
213 "exceeded file size limit"
218 /* t means use pty, nil means use a pipe,
219 maybe other values to come. */
220 Lisp_Object Vprocess_connection_type
;
224 #include <sys/socket.h>
228 /* Number of events of change of status of a process. */
231 /* Number of events for which the user or sentinel has been notified. */
235 /* We could get this from param.h, but better not to depend on finding that.
236 And better not to risk that it might define other symbols used in this
239 #define MAXDESC FD_SETSIZE
243 #define SELECT_TYPE fd_set
244 #else /* no FD_SET */
246 #define SELECT_TYPE int
248 /* Define the macros to access a single-int bitmap of descriptors. */
249 #define FD_SET(n, p) (*(p) |= (1 << (n)))
250 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
251 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
252 #define FD_ZERO(p) (*(p) = 0)
253 #endif /* no FD_SET */
255 /* Mask of bits indicating the descriptors that we wait for input on */
257 SELECT_TYPE input_wait_mask
;
259 int delete_exited_processes
;
261 /* Indexed by descriptor, gives the process (if any) for that descriptor */
262 Lisp_Object chan_process
[MAXDESC
];
264 /* Alist of elements (NAME . PROCESS) */
265 Lisp_Object Vprocess_alist
;
267 Lisp_Object Qprocessp
;
269 Lisp_Object
get_process ();
271 /* Buffered-ahead input char from process, indexed by channel.
272 -1 means empty (no char is buffered).
273 Used on sys V where the only way to tell if there is any
274 output from the process is to read at least one char.
275 Always -1 on systems that support FIONREAD. */
277 int proc_buffered_char
[MAXDESC
];
279 /* Compute the Lisp form of the process status, p->status, from
280 the numeric status that was returned by `wait'. */
282 Lisp_Object
status_convert ();
285 struct Lisp_Process
*p
;
287 union { int i
; WAITTYPE wt
; } u
;
288 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
289 p
->status
= status_convert (u
.wt
);
290 p
->raw_status_low
= Qnil
;
291 p
->raw_status_high
= Qnil
;
294 /* Convert a process status word in Unix format to
295 the list that we use internally. */
302 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
303 else if (WIFEXITED (w
))
304 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
305 WCOREDUMP (w
) ? Qt
: Qnil
));
306 else if (WIFSIGNALED (w
))
307 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
308 WCOREDUMP (w
) ? Qt
: Qnil
));
313 /* Given a status-list, extract the three pieces of information
314 and store them individually through the three pointers. */
317 decode_status (l
, symbol
, code
, coredump
)
325 if (XTYPE (l
) == Lisp_Symbol
)
333 *symbol
= XCONS (l
)->car
;
334 tem
= XCONS (l
)->cdr
;
335 *code
= XFASTINT (XCONS (tem
)->car
);
336 tem
= XCONS (tem
)->cdr
;
337 *coredump
= !NILP (tem
);
341 /* Return a string describing a process status list. */
344 status_message (status
)
349 Lisp_Object string
, string2
;
351 decode_status (status
, &symbol
, &code
, &coredump
);
353 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
356 string
= build_string (code
< NSIG
? sys_siglist
[code
] : "unknown");
358 string
= build_string (code
< NSIG
? sys_errlist
[code
] : "unknown");
360 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
361 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
362 return concat2 (string
, string2
);
364 else if (EQ (symbol
, Qexit
))
367 return build_string ("finished\n");
368 string
= Fnumber_to_string (make_number (code
));
369 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
370 return concat2 (build_string ("exited abnormally with code "),
371 concat2 (string
, string2
));
374 return Fcopy_sequence (Fsymbol_name (symbol
));
379 /* Open an available pty, returning a file descriptor.
380 Return -1 on failure.
381 The file name of the terminal corresponding to the pty
382 is left in the variable pty_name. */
393 /* Some systems name their pseudoterminals so that there are gaps in
394 the usual sequence - for example, on HP9000/S700 systems, there
395 are no pseudoterminals with names ending in 'f'. So we wait for
396 three failures in a row before deciding that we've reached the
398 int failed_count
= 0;
403 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
404 for (i
= 0; i
< 16; i
++)
407 #ifdef PTY_NAME_SPRINTF
410 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
411 #endif /* no PTY_NAME_SPRINTF */
415 #else /* no PTY_OPEN */
417 /* Unusual IRIS code */
418 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
421 if (fstat (fd
, &stb
) < 0)
424 if (stat (pty_name
, &stb
) < 0)
427 if (failed_count
>= 3)
433 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
435 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
437 #endif /* not IRIS */
438 #endif /* no PTY_OPEN */
442 /* check to make certain that both sides are available
443 this avoids a nasty yet stupid bug in rlogins */
444 #ifdef PTY_TTY_NAME_SPRINTF
447 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
448 #endif /* no PTY_TTY_NAME_SPRINTF */
450 if (access (pty_name
, 6) != 0)
453 #if !defined(IRIS) && !defined(__sgi)
459 #endif /* not UNIPLUS */
466 #endif /* HAVE_PTYS */
472 register Lisp_Object val
, tem
, name1
;
473 register struct Lisp_Process
*p
;
477 /* size of process structure includes the vector header,
478 so deduct for that. But struct Lisp_Vector includes the first
479 element, thus deducts too much, so add it back. */
480 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
481 - sizeof (struct Lisp_Vector
)
482 + sizeof (Lisp_Object
))
483 / sizeof (Lisp_Object
)),
485 XSETTYPE (val
, Lisp_Process
);
488 XFASTINT (p
->infd
) = 0;
489 XFASTINT (p
->outfd
) = 0;
490 XFASTINT (p
->pid
) = 0;
491 XFASTINT (p
->tick
) = 0;
492 XFASTINT (p
->update_tick
) = 0;
493 p
->raw_status_low
= Qnil
;
494 p
->raw_status_high
= Qnil
;
496 p
->mark
= Fmake_marker ();
498 /* If name is already in use, modify it until it is unused. */
503 tem
= Fget_process (name1
);
504 if (NILP (tem
)) break;
505 sprintf (suffix
, "<%d>", i
);
506 name1
= concat2 (name
, build_string (suffix
));
510 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
514 remove_process (proc
)
515 register Lisp_Object proc
;
517 register Lisp_Object pair
;
519 pair
= Frassq (proc
, Vprocess_alist
);
520 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
521 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
523 deactivate_process (proc
);
526 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
527 "Return t if OBJECT is a process.")
531 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
534 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
535 "Return the process named NAME, or nil if there is none.")
537 register Lisp_Object name
;
539 if (XTYPE (name
) == Lisp_Process
)
541 CHECK_STRING (name
, 0);
542 return Fcdr (Fassoc (name
, Vprocess_alist
));
545 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
546 "Return the (or, a) process associated with BUFFER.\n\
547 BUFFER may be a buffer or the name of one.")
549 register Lisp_Object name
;
551 register Lisp_Object buf
, tail
, proc
;
553 if (NILP (name
)) return Qnil
;
554 buf
= Fget_buffer (name
);
555 if (NILP (buf
)) return Qnil
;
557 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
559 proc
= Fcdr (Fcar (tail
));
560 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
566 /* This is how commands for the user decode process arguments. It
567 accepts a process, a process name, a buffer, a buffer name, or nil.
568 Buffers denote the first process in the buffer, and nil denotes the
573 register Lisp_Object name
;
575 register Lisp_Object proc
;
577 proc
= Fget_buffer_process (Fcurrent_buffer ());
580 proc
= Fget_process (name
);
582 proc
= Fget_buffer_process (Fget_buffer (name
));
589 error ("Current buffer has no process");
591 error ("Process %s does not exist", XSTRING (name
)->data
);
595 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
596 "Delete PROCESS: kill it and forget about it immediately.\n\
597 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
598 nil, indicating the current buffer's process.")
600 register Lisp_Object proc
;
602 proc
= get_process (proc
);
603 XPROCESS (proc
)->raw_status_low
= Qnil
;
604 XPROCESS (proc
)->raw_status_high
= Qnil
;
605 if (NETCONN_P (proc
))
607 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
608 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
610 else if (XFASTINT (XPROCESS (proc
)->infd
))
612 Fkill_process (proc
, Qnil
);
613 /* Do this now, since remove_process will make sigchld_handler do nothing. */
614 XPROCESS (proc
)->status
615 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
616 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
619 remove_process (proc
);
623 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
624 "Return the status of PROCESS: a symbol, one of these:\n\
625 run -- for a process that is running.\n\
626 stop -- for a process stopped but continuable.\n\
627 exit -- for a process that has exited.\n\
628 signal -- for a process that has got a fatal signal.\n\
629 open -- for a network stream connection that is open.\n\
630 closed -- for a network stream connection that is closed.\n\
631 nil -- if arg is a process name and no such process exists.\n\
632 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
633 nil, indicating the current buffer's process.")
634 /* command -- for a command channel opened to Emacs by another process.\n\
635 external -- for an i/o channel opened to Emacs by another process.\n\ */
637 register Lisp_Object proc
;
639 register struct Lisp_Process
*p
;
640 register Lisp_Object status
;
641 proc
= get_process (proc
);
645 if (!NILP (p
->raw_status_low
))
648 if (XTYPE (status
) == Lisp_Cons
)
649 status
= XCONS (status
)->car
;
650 if (NETCONN_P (proc
))
652 if (EQ (status
, Qrun
))
654 else if (EQ (status
, Qexit
))
660 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
662 "Return the exit status of PROCESS or the signal number that killed it.\n\
663 If PROCESS has not yet exited or died, return 0.")
665 register Lisp_Object proc
;
667 CHECK_PROCESS (proc
, 0);
668 if (!NILP (XPROCESS (proc
)->raw_status_low
))
669 update_status (XPROCESS (proc
));
670 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
671 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
672 return make_number (0);
675 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
676 "Return the process id of PROCESS.\n\
677 This is the pid of the Unix process which PROCESS uses or talks to.\n\
678 For a network connection, this value is nil.")
680 register Lisp_Object proc
;
682 CHECK_PROCESS (proc
, 0);
683 return XPROCESS (proc
)->pid
;
686 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
687 "Return the name of PROCESS, as a string.\n\
688 This is the name of the program invoked in PROCESS,\n\
689 possibly modified to make it unique among process names.")
691 register Lisp_Object proc
;
693 CHECK_PROCESS (proc
, 0);
694 return XPROCESS (proc
)->name
;
697 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
698 "Return the command that was executed to start PROCESS.\n\
699 This is a list of strings, the first string being the program executed\n\
700 and the rest of the strings being the arguments given to it.\n\
701 For a non-child channel, this is nil.")
703 register Lisp_Object proc
;
705 CHECK_PROCESS (proc
, 0);
706 return XPROCESS (proc
)->command
;
709 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
711 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
713 register Lisp_Object proc
, buffer
;
715 CHECK_PROCESS (proc
, 0);
717 CHECK_BUFFER (buffer
, 1);
718 XPROCESS (proc
)->buffer
= buffer
;
722 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
724 "Return the buffer PROCESS is associated with.\n\
725 Output from PROCESS is inserted in this buffer\n\
726 unless PROCESS has a filter.")
728 register Lisp_Object proc
;
730 CHECK_PROCESS (proc
, 0);
731 return XPROCESS (proc
)->buffer
;
734 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
736 "Return the marker for the end of the last output from PROCESS.")
738 register Lisp_Object proc
;
740 CHECK_PROCESS (proc
, 0);
741 return XPROCESS (proc
)->mark
;
744 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
746 "Give PROCESS the filter function FILTER; nil means no filter.\n\
747 When a process has a filter, each time it does output\n\
748 the entire string of output is passed to the filter.\n\
749 The filter gets two arguments: the process and the string of output.\n\
750 If the process has a filter, its buffer is not used for output.")
752 register Lisp_Object proc
, filter
;
754 CHECK_PROCESS (proc
, 0);
755 XPROCESS (proc
)->filter
= filter
;
759 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
761 "Returns the filter function of PROCESS; nil if none.\n\
762 See `set-process-filter' for more info on filter functions.")
764 register Lisp_Object proc
;
766 CHECK_PROCESS (proc
, 0);
767 return XPROCESS (proc
)->filter
;
770 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
772 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
773 The sentinel is called as a function when the process changes state.\n\
774 It gets two arguments: the process, and a string describing the change.")
776 register Lisp_Object proc
, sentinel
;
778 CHECK_PROCESS (proc
, 0);
779 XPROCESS (proc
)->sentinel
= sentinel
;
783 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
785 "Return the sentinel of PROCESS; nil if none.\n\
786 See `set-process-sentinel' for more info on sentinels.")
788 register Lisp_Object proc
;
790 CHECK_PROCESS (proc
, 0);
791 return XPROCESS (proc
)->sentinel
;
794 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
795 Sprocess_kill_without_query
, 1, 2, 0,
796 "Say no query needed if PROCESS is running when Emacs is exited.\n\
797 Optional second argument if non-nill says to require a query.\n\
798 Value is t if a query was formerly required.")
800 register Lisp_Object proc
, value
;
804 CHECK_PROCESS (proc
, 0);
805 tem
= XPROCESS (proc
)->kill_without_query
;
806 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
811 #if 0 /* Turned off because we don't currently record this info
812 in the process. Perhaps add it. */
813 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
814 "Return the connection type of `PROCESS'.\n\
815 The value is `nil' for a pipe,\n\
816 `t' or `pty' for a pty, or `stream' for a socket connection.")
820 return XPROCESS (process
)->type
;
827 register Lisp_Object tail
, tem
;
828 Lisp_Object proc
, minspace
, tem1
;
829 register struct buffer
*old
= current_buffer
;
830 register struct Lisp_Process
*p
;
834 XFASTINT (minspace
) = 1;
836 set_buffer_internal (XBUFFER (Vstandard_output
));
837 Fbuffer_disable_undo (Vstandard_output
);
839 current_buffer
->truncate_lines
= Qt
;
842 Proc Status Buffer Command\n\
843 ---- ------ ------ -------\n", -1);
845 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
849 proc
= Fcdr (Fcar (tail
));
851 if (NILP (p
->childp
))
854 Finsert (1, &p
->name
);
855 Findent_to (make_number (13), minspace
);
857 if (!NILP (p
->raw_status_low
))
860 if (XTYPE (p
->status
) == Lisp_Cons
)
861 symbol
= XCONS (p
->status
)->car
;
864 if (EQ (symbol
, Qsignal
))
867 tem
= Fcar (Fcdr (p
->status
));
869 if (XINT (tem
) < NSIG
)
870 write_string (sys_errlist
[XINT (tem
)], -1);
873 Fprinc (symbol
, Qnil
);
875 else if (NETCONN_P (proc
))
877 if (EQ (symbol
, Qrun
))
878 write_string ("open", -1);
879 else if (EQ (symbol
, Qexit
))
880 write_string ("closed", -1);
882 Fprinc (symbol
, Qnil
);
885 Fprinc (symbol
, Qnil
);
887 if (EQ (symbol
, Qexit
))
890 tem
= Fcar (Fcdr (p
->status
));
893 sprintf (tembuf
, " %d", XFASTINT (tem
));
894 write_string (tembuf
, -1);
898 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
899 remove_process (proc
);
901 Findent_to (make_number (22), minspace
);
902 if (NILP (p
->buffer
))
903 insert_string ("(none)");
904 else if (NILP (XBUFFER (p
->buffer
)->name
))
905 insert_string ("(Killed)");
907 Finsert (1, &XBUFFER (p
->buffer
)->name
);
909 Findent_to (make_number (37), minspace
);
911 if (NETCONN_P (proc
))
913 sprintf (tembuf
, "(network stream connection to %s)\n",
914 XSTRING (p
->childp
)->data
);
915 insert_string (tembuf
);
929 insert_string ("\n");
935 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
936 "Display a list of all processes.\n\
937 \(Any processes listed as Exited or Signaled are actually eliminated\n\
938 after the listing is made.)")
941 internal_with_output_to_temp_buffer ("*Process List*",
942 list_processes_1
, Qnil
);
946 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
947 "Return a list of all processes.")
950 return Fmapcar (Qcdr
, Vprocess_alist
);
953 /* Starting asynchronous inferior processes. */
955 static Lisp_Object
start_process_unwind ();
957 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
958 "Start a program in a subprocess. Return the process object for it.\n\
959 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
960 NAME is name for process. It is modified if necessary to make it unique.\n\
961 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
962 Process output goes at end of that buffer, unless you specify\n\
963 an output stream or filter function to handle the output.\n\
964 BUFFER may be also nil, meaning that this process is not associated\n\
966 Third arg is program file name. It is searched for as in the shell.\n\
967 Remaining arguments are strings to give program as arguments.")
970 register Lisp_Object
*args
;
972 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
974 register unsigned char *new_argv
;
977 register unsigned char **new_argv
;
980 int count
= specpdl_ptr
- specpdl
;
984 buffer
= Fget_buffer_create (buffer
);
986 /* Make sure that the child will be able to chdir to the current
987 buffer's current directory, or its unhandled equivalent. We
988 can't just have the child check for an error when it does the
989 chdir, since it's in a vfork.
991 We have to GCPRO around this because Fexpand_file_name and
992 Funhandled_file_name_directory might call a file name handling
993 function. The argument list is protected by the caller, so all
994 we really have to worry about is buffer. */
996 struct gcpro gcpro1
, gcpro2
;
998 current_dir
= current_buffer
->directory
;
1000 GCPRO2 (buffer
, current_dir
);
1003 expand_and_dir_to_file
1004 (Funhandled_file_name_directory (current_dir
), Qnil
);
1005 if (NILP (Ffile_accessible_directory_p (current_dir
)))
1006 report_file_error ("Setting current directory",
1007 Fcons (current_buffer
->directory
, Qnil
));
1013 CHECK_STRING (name
, 0);
1017 CHECK_STRING (program
, 2);
1020 /* Make a one member argv with all args concatenated
1021 together separated by a blank. */
1022 len
= XSTRING (program
)->size
+ 2;
1023 for (i
= 3; i
< nargs
; i
++)
1026 CHECK_STRING (tem
, i
);
1027 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1029 new_argv
= (unsigned char *) alloca (len
);
1030 strcpy (new_argv
, XSTRING (program
)->data
);
1031 for (i
= 3; i
< nargs
; i
++)
1034 CHECK_STRING (tem
, i
);
1035 strcat (new_argv
, " ");
1036 strcat (new_argv
, XSTRING (tem
)->data
);
1038 /* Need to add code here to check for program existence on VMS */
1041 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1043 for (i
= 3; i
< nargs
; i
++)
1046 CHECK_STRING (tem
, i
);
1047 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1049 new_argv
[i
- 2] = 0;
1050 new_argv
[0] = XSTRING (program
)->data
;
1052 /* If program file name is not absolute, search our path for it */
1053 if (new_argv
[0][0] != '/')
1056 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1058 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1059 new_argv
[0] = XSTRING (tem
)->data
;
1061 #endif /* not VMS */
1063 proc
= make_process (name
);
1064 /* If an error occurs and we can't start the process, we want to
1065 remove it from the process list. This means that each error
1066 check in create_process doesn't need to call remove_process
1067 itself; it's all taken care of here. */
1068 record_unwind_protect (start_process_unwind
, proc
);
1070 XPROCESS (proc
)->childp
= Qt
;
1071 XPROCESS (proc
)->command_channel_p
= Qnil
;
1072 XPROCESS (proc
)->buffer
= buffer
;
1073 XPROCESS (proc
)->sentinel
= Qnil
;
1074 XPROCESS (proc
)->filter
= Qnil
;
1075 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1077 create_process (proc
, new_argv
, current_dir
);
1079 return unbind_to (count
, proc
);
1082 /* This function is the unwind_protect form for Fstart_process. If
1083 PROC doesn't have its pid set, then we know someone has signalled
1084 an error and the process wasn't started successfully, so we should
1085 remove it from the process list. */
1087 start_process_unwind (proc
)
1090 if (XTYPE (proc
) != Lisp_Process
)
1093 /* Was PROC started successfully? */
1094 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1095 remove_process (proc
);
1102 create_process_1 (signo
)
1106 /* USG systems forget handlers when they are used;
1107 must reestablish each time */
1108 signal (signo
, create_process_1
);
1112 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1115 /* Mimic blocking of signals on system V, which doesn't really have it. */
1117 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1118 int sigchld_deferred
;
1121 create_process_sigchld ()
1123 signal (SIGCHLD
, create_process_sigchld
);
1125 sigchld_deferred
= 1;
1131 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1132 create_process (process
, new_argv
, current_dir
)
1133 Lisp_Object process
;
1135 Lisp_Object current_dir
;
1137 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1140 SIGTYPE (*sigchld
)();
1143 extern char **environ
;
1145 inchannel
= outchannel
= -1;
1148 if (EQ (Vprocess_connection_type
, Qt
))
1149 outchannel
= inchannel
= allocate_pty ();
1154 /* On USG systems it does not work to open the pty's tty here
1155 and then close and reopen it in the child. */
1157 /* Don't let this terminal become our controlling terminal
1158 (in case we don't have one). */
1159 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1161 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1164 report_file_error ("Opening pty", Qnil
);
1166 forkin
= forkout
= -1;
1167 #endif /* not USG */
1171 #endif /* HAVE_PTYS */
1174 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1175 report_file_error ("Opening socketpair", Qnil
);
1176 outchannel
= inchannel
= sv
[0];
1177 forkout
= forkin
= sv
[1];
1179 #else /* not SKTPAIR */
1188 #endif /* not SKTPAIR */
1191 /* Replaced by close_process_descs */
1192 set_exclusive_use (inchannel
);
1193 set_exclusive_use (outchannel
);
1196 /* Stride people say it's a mystery why this is needed
1197 as well as the O_NDELAY, but that it fails without this. */
1198 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1201 ioctl (inchannel
, FIONBIO
, &one
);
1206 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1209 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1213 /* Record this as an active process, with its channels.
1214 As a result, child_setup will close Emacs's side of the pipes. */
1215 chan_process
[inchannel
] = process
;
1216 XFASTINT (XPROCESS (process
)->infd
) = inchannel
;
1217 XFASTINT (XPROCESS (process
)->outfd
) = outchannel
;
1218 /* Record the tty descriptor used in the subprocess. */
1220 XPROCESS (process
)->subtty
= Qnil
;
1222 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1223 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1224 XPROCESS (process
)->status
= Qrun
;
1226 /* Delay interrupts until we have a chance to store
1227 the new fork's pid in its process structure */
1231 #else /* not BSD4_1 */
1232 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1233 sigsetmask (sigmask (SIGCHLD
));
1234 #else /* ordinary USG */
1236 sigchld_deferred
= 0;
1237 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1239 #endif /* ordinary USG */
1240 #endif /* not BSD4_1 */
1241 #endif /* SIGCHLD */
1243 /* Until we store the proper pid, enable sigchld_handler
1244 to recognize an unknown pid as standing for this process.
1245 It is very important not to let this `marker' value stay
1246 in the table after this function has returned; if it does
1247 it might cause call-process to hang and subsequent asynchronous
1248 processes to get their return values scrambled. */
1249 XSETINT (XPROCESS (process
)->pid
, -1);
1252 /* child_setup must clobber environ on systems with true vfork.
1253 Protect it from permanent change. */
1254 char **save_environ
= environ
;
1259 int xforkin
= forkin
;
1260 int xforkout
= forkout
;
1262 #if 0 /* This was probably a mistake--it duplicates code later on,
1263 but fails to handle all the cases. */
1264 /* Make sure SIGCHLD is not blocked in the child. */
1265 sigsetmask (SIGEMPTYMASK
);
1268 /* Make the pty be the controlling terminal of the process. */
1270 /* First, disconnect its current controlling terminal. */
1274 /* Make the pty's terminal the controlling terminal. */
1276 /* We ignore the return value
1277 because faith@cs.unc.edu says that is necessary on Linux. */
1278 ioctl (xforkin
, TIOCSCTTY
, 0);
1280 #else /* not HAVE_SETSID */
1281 #if defined (USG) && !defined (IRIX)
1282 /* It's very important to call setpgrp() here and no time
1283 afterwards. Otherwise, we lose our controlling tty which
1284 is set when we open the pty. */
1287 #endif /* not HAVE_SETSID */
1289 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1290 can do TIOCSPGRP only to the process's controlling tty. */
1293 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1294 I can't test it since I don't have 4.3. */
1295 int j
= open ("/dev/tty", O_RDWR
, 0);
1296 ioctl (j
, TIOCNOTTY
, 0);
1299 /* In order to get a controlling terminal on some versions
1300 of BSD, it is necessary to put the process in pgrp 0
1301 before it opens the terminal. */
1305 #endif /* TIOCNOTTY */
1307 #if !defined (RTU) && !defined (UNIPLUS)
1308 /*** There is a suggestion that this ought to be a
1309 conditional on TIOCSPGRP. */
1310 /* Now close the pty (if we had it open) and reopen it.
1311 This makes the pty the controlling terminal of the subprocess. */
1314 /* I wonder if close (open (pty_name, ...)) would work? */
1317 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1322 #endif /* not UNIPLUS and not RTU */
1323 #ifdef SETUP_SLAVE_PTY
1325 #endif /* SETUP_SLAVE_PTY */
1327 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1328 Now reenable it in the child, so it will die when we want it to. */
1330 signal (SIGHUP
, SIG_DFL
);
1332 #endif /* HAVE_PTYS */
1337 #else /* not BSD4_1 */
1338 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1339 sigsetmask (SIGEMPTYMASK
);
1340 #else /* ordinary USG */
1342 signal (SIGCHLD
, sigchld
);
1344 #endif /* ordinary USG */
1345 #endif /* not BSD4_1 */
1346 #endif /* SIGCHLD */
1348 child_setup_tty (xforkout
);
1349 child_setup (xforkin
, xforkout
, xforkout
,
1350 new_argv
, 1, current_dir
);
1352 environ
= save_environ
;
1356 report_file_error ("Doing vfork", Qnil
);
1358 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1360 FD_SET (inchannel
, &input_wait_mask
);
1362 /* If the subfork execv fails, and it exits,
1363 this close hangs. I don't know why.
1364 So have an interrupt jar it loose. */
1366 signal (SIGALRM
, create_process_1
);
1369 /* OK to close only if it's not a pty. Otherwise we need to leave
1370 it open for ioctl to get pgrp when signals are sent, or to send
1371 the interrupt characters through if that's how we're signalling
1372 subprocesses. Alternately if you are concerned about running out
1373 of file descriptors, you could just save the tty name and open
1374 just to do the ioctl. */
1375 if (NILP (XFASTINT (XPROCESS (process
)->pty_flag
)))
1378 XPROCESS (process
)->subtty
= Qnil
;
1384 if (forkin
!= forkout
&& forkout
>= 0)
1390 #else /* not BSD4_1 */
1391 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1392 sigsetmask (SIGEMPTYMASK
);
1393 #else /* ordinary USG */
1395 signal (SIGCHLD
, sigchld
);
1396 /* Now really handle any of these signals
1397 that came in during this function. */
1398 if (sigchld_deferred
)
1399 kill (getpid (), SIGCHLD
);
1401 #endif /* ordinary USG */
1402 #endif /* not BSD4_1 */
1403 #endif /* SIGCHLD */
1405 #endif /* not VMS */
1409 /* open a TCP network connection to a given HOST/SERVICE. Treated
1410 exactly like a normal process when reading and writing. Only
1411 differences are in status display and process deletion. A network
1412 connection has no PID; you cannot signal it. All you can do is
1413 deactivate and close it via delete-process */
1415 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1417 "Open a TCP connection for a service to a host.\n\
1418 Returns a subprocess-object to represent the connection.\n\
1419 Input and output work as for subprocesses; `delete-process' closes it.\n\
1420 Args are NAME BUFFER HOST SERVICE.\n\
1421 NAME is name for process. It is modified if necessary to make it unique.\n\
1422 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1423 Process output goes at end of that buffer, unless you specify\n\
1424 an output stream or filter function to handle the output.\n\
1425 BUFFER may be also nil, meaning that this process is not associated\n\
1427 Third arg is name of the host to connect to, or its IP address.\n\
1428 Fourth arg SERVICE is name of the service desired, or an integer\n\
1429 specifying a port number to connect to.")
1430 (name
, buffer
, host
, service
)
1431 Lisp_Object name
, buffer
, host
, service
;
1435 struct sockaddr_in address
;
1436 struct servent
*svc_info
;
1437 struct hostent
*host_info_ptr
, host_info
;
1438 char *(addr_list
[2]);
1439 unsigned long numeric_addr
;
1443 struct hostent host_info_fixed
;
1444 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1446 GCPRO4 (name
, buffer
, host
, service
);
1447 CHECK_STRING (name
, 0);
1448 CHECK_STRING (host
, 0);
1449 if (XTYPE(service
) == Lisp_Int
)
1450 port
= htons ((unsigned short) XINT (service
));
1453 CHECK_STRING (service
, 0);
1454 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1456 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1457 port
= svc_info
->s_port
;
1460 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1461 if (host_info_ptr
== 0)
1462 /* Attempt to interpret host as numeric inet address */
1464 numeric_addr
= inet_addr (XSTRING (host
)->data
);
1465 if (numeric_addr
== -1)
1466 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1468 host_info_ptr
= &host_info
;
1469 host_info
.h_name
= 0;
1470 host_info
.h_aliases
= 0;
1471 host_info
.h_addrtype
= AF_INET
;
1473 /* Older machines have only one address slot called h_addr.
1474 Newer machines have h_addr_list, but #define h_addr to
1475 be its first element. */
1476 host_info
.h_addr_list
= &(addr_list
[0]);
1478 host_info
.h_addr
= (char*)(&numeric_addr
);
1480 host_info
.h_length
= strlen (addr_list
[0]);
1483 bzero (&address
, sizeof address
);
1484 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1485 host_info_ptr
->h_length
);
1486 address
.sin_family
= host_info_ptr
->h_addrtype
;
1487 address
.sin_port
= port
;
1489 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1491 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1494 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1501 report_file_error ("connection failed",
1502 Fcons (host
, Fcons (name
, Qnil
)));
1508 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1511 buffer
= Fget_buffer_create (buffer
);
1512 proc
= make_process (name
);
1514 chan_process
[inch
] = proc
;
1517 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1520 fcntl (inch
, F_SETFL
, O_NDELAY
);
1524 XPROCESS (proc
)->childp
= host
;
1525 XPROCESS (proc
)->command_channel_p
= Qnil
;
1526 XPROCESS (proc
)->buffer
= buffer
;
1527 XPROCESS (proc
)->sentinel
= Qnil
;
1528 XPROCESS (proc
)->filter
= Qnil
;
1529 XPROCESS (proc
)->command
= Qnil
;
1530 XPROCESS (proc
)->pid
= Qnil
;
1531 XFASTINT (XPROCESS (proc
)->infd
) = s
;
1532 XFASTINT (XPROCESS (proc
)->outfd
) = outch
;
1533 XPROCESS (proc
)->status
= Qrun
;
1534 FD_SET (inch
, &input_wait_mask
);
1539 #endif /* HAVE_SOCKETS */
1541 deactivate_process (proc
)
1544 register int inchannel
, outchannel
;
1545 register struct Lisp_Process
*p
= XPROCESS (proc
);
1547 inchannel
= XFASTINT (p
->infd
);
1548 outchannel
= XFASTINT (p
->outfd
);
1552 /* Beware SIGCHLD hereabouts. */
1553 flush_pending_output (inchannel
);
1556 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1557 sys$
dassgn (outchannel
);
1558 vs
= get_vms_process_pointer (p
->pid
);
1560 give_back_vms_process_stuff (vs
);
1564 if (outchannel
&& outchannel
!= inchannel
)
1568 XFASTINT (p
->infd
) = 0;
1569 XFASTINT (p
->outfd
) = 0;
1570 chan_process
[inchannel
] = Qnil
;
1571 FD_CLR (inchannel
, &input_wait_mask
);
1575 /* Close all descriptors currently in use for communication
1576 with subprocess. This is used in a newly-forked subprocess
1577 to get rid of irrelevant descriptors. */
1579 close_process_descs ()
1582 for (i
= 0; i
< MAXDESC
; i
++)
1584 Lisp_Object process
;
1585 process
= chan_process
[i
];
1586 if (!NILP (process
))
1588 int in
= XFASTINT (XPROCESS (process
)->infd
);
1589 int out
= XFASTINT (XPROCESS (process
)->outfd
);
1592 if (out
&& in
!= out
)
1598 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1600 "Allow any pending output from subprocesses to be read by Emacs.\n\
1601 It is read into the process' buffers or given to their filter functions.\n\
1602 Non-nil arg PROCESS means do not return until some output has been received\n\
1604 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1605 seconds and microseconds to wait; return after that much time whether\n\
1606 or not there is input.\n\
1607 Return non-nil iff we received any output before the timeout expired.")
1608 (proc
, timeout
, timeout_msecs
)
1609 register Lisp_Object proc
, timeout
, timeout_msecs
;
1614 if (! NILP (timeout_msecs
))
1616 CHECK_NUMBER (timeout_msecs
, 2);
1617 useconds
= XINT (timeout_msecs
);
1618 if (XTYPE (timeout
) != Lisp_Int
)
1619 XSET (timeout
, Lisp_Int
, 0);
1622 int carry
= useconds
/ 1000000;
1624 XSETINT (timeout
, XINT (timeout
) + carry
);
1625 useconds
-= carry
* 1000000;
1627 /* I think this clause is necessary because C doesn't
1628 guarantee a particular rounding direction for negative
1632 XSETINT (timeout
, XINT (timeout
) - 1);
1633 useconds
+= 1000000;
1640 if (! NILP (timeout
))
1642 CHECK_NUMBER (timeout
, 1);
1643 seconds
= XINT (timeout
);
1656 XFASTINT (proc
) = 0;
1659 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1663 /* This variable is different from waiting_for_input in keyboard.c.
1664 It is used to communicate to a lisp process-filter/sentinel (via the
1665 function Fwaiting_for_user_input_p below) whether emacs was waiting
1666 for user-input when that process-filter was called.
1667 waiting_for_input cannot be used as that is by definition 0 when
1668 lisp code is being evalled */
1669 static int waiting_for_user_input_p
;
1671 /* Read and dispose of subprocess output while waiting for timeout to
1672 elapse and/or keyboard input to be available.
1675 timeout in seconds, or
1676 zero for no limit, or
1677 -1 means gobble data immediately available but don't wait for any.
1680 an additional duration to wait, measured in microseconds.
1681 If this is nonzero and time_limit is 0, then the timeout
1682 consists of MICROSECS only.
1684 READ_KBD is a lisp value:
1685 0 to ignore keyboard input, or
1686 1 to return when input is available, or
1687 -1 meaning caller will actually read the input, so don't throw to
1688 the quit handler, or
1689 a cons cell, meaning wait wait until its car is non-nil
1690 (and gobble terminal input into the buffer if any arrives), or
1691 a process object, meaning wait until something arrives from that
1692 process. The return value is true iff we read some input from
1695 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1696 output that arrives.
1698 If READ_KBD is a pointer to a struct Lisp_Process, then the
1699 function returns true iff we received input from that process
1700 before the timeout elapsed.
1701 Otherwise, return true iff we received input from any process. */
1703 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1704 int time_limit
, microsecs
;
1705 Lisp_Object read_kbd
;
1708 register int channel
, nfds
, m
;
1709 static SELECT_TYPE Available
;
1712 EMACS_TIME timeout
, end_time
, garbage
;
1714 int wait_channel
= 0;
1715 struct Lisp_Process
*wait_proc
= 0;
1716 int got_some_input
= 0;
1717 Lisp_Object
*wait_for_cell
= 0;
1719 FD_ZERO (&Available
);
1721 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1723 if (XTYPE (read_kbd
) == Lisp_Process
)
1725 wait_proc
= XPROCESS (read_kbd
);
1726 wait_channel
= XFASTINT (wait_proc
->infd
);
1727 XFASTINT (read_kbd
) = 0;
1730 /* If waiting for non-nil in a cell, record where. */
1731 if (XTYPE (read_kbd
) == Lisp_Cons
)
1733 wait_for_cell
= &XCONS (read_kbd
)->car
;
1734 XFASTINT (read_kbd
) = 0;
1737 waiting_for_user_input_p
= XINT (read_kbd
);
1739 /* Since we may need to wait several times,
1740 compute the absolute time to return at. */
1741 if (time_limit
|| microsecs
)
1743 EMACS_GET_TIME (end_time
);
1744 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1745 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1750 /* If calling from keyboard input, do not quit
1751 since we want to return C-g as an input character.
1752 Otherwise, do pending quit if requested. */
1753 if (XINT (read_kbd
) >= 0)
1756 /* Compute time from now till when time limit is up */
1757 /* Exit if already run out */
1758 if (time_limit
== -1)
1760 /* -1 specified for timeout means
1761 gobble output available now
1762 but don't wait at all. */
1764 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1766 else if (time_limit
|| microsecs
)
1768 EMACS_GET_TIME (timeout
);
1769 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1770 if (EMACS_TIME_NEG_P (timeout
))
1775 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1778 /* Cause C-g and alarm signals to take immediate action,
1779 and cause input available signals to zero out timeout.
1781 It is important that we do this before checking for process
1782 activity. If we get a SIGCHLD after the explicit checks for
1783 process activity, timeout is the only way we will know. */
1784 if (XINT (read_kbd
) < 0)
1785 set_waiting_for_input (&timeout
);
1787 /* If status of something has changed, and no input is
1788 available, notify the user of the change right away. After
1789 this explicit check, we'll let the SIGCHLD handler zap
1790 timeout to get our attention. */
1791 if (update_tick
!= process_tick
&& do_display
)
1793 Atemp
= input_wait_mask
;
1794 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1795 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1797 /* It's okay for us to do this and then continue with
1798 the loop, since timeout has already been zeroed out. */
1799 clear_waiting_for_input ();
1804 /* Don't wait for output from a non-running process. */
1805 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1806 update_status (wait_proc
);
1808 && ! EQ (wait_proc
->status
, Qrun
))
1810 clear_waiting_for_input ();
1814 /* Wait till there is something to do */
1816 Available
= input_wait_mask
;
1817 if (! XINT (read_kbd
) && wait_for_cell
== 0)
1818 FD_CLR (0, &Available
);
1820 /* If frame size has changed or the window is newly mapped,
1821 redisplay now, before we start to wait. There is a race
1822 condition here; if a SIGIO arrives between now and the select
1823 and indicates that a frame is trashed, the select may block
1824 displaying a trashed screen. */
1826 redisplay_preserve_echo_area ();
1828 if (XINT (read_kbd
) && detect_input_pending ())
1831 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1835 /* Make C-g and alarm signals set flags again */
1836 clear_waiting_for_input ();
1838 /* If we woke up due to SIGWINCH, actually change size now. */
1839 do_pending_window_change ();
1841 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1845 if (xerrno
== EINTR
)
1846 FD_ZERO (&Available
);
1848 /* Ultrix select seems to return ENOMEM when it is
1849 interrupted. Treat it just like EINTR. Bleah. Note
1850 that we want to test for the "ultrix" CPP symbol, not
1851 "__ultrix__"; the latter is only defined under GCC, but
1852 not by DEC's bundled CC. -JimB */
1853 else if (xerrno
== ENOMEM
)
1854 FD_ZERO (&Available
);
1857 /* This happens for no known reason on ALLIANT.
1858 I am guessing that this is the right response. -- RMS. */
1859 else if (xerrno
== EFAULT
)
1860 FD_ZERO (&Available
);
1862 else if (xerrno
== EBADF
)
1865 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1866 the child's closure of the pts gives the parent a SIGHUP, and
1867 the ptc file descriptor is automatically closed,
1868 yielding EBADF here or at select() call above.
1869 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1870 in m-ibmrt-aix.h), and here we just ignore the select error.
1871 Cleanup occurs c/o status_notify after SIGCLD. */
1872 FD_ZERO (&Available
); /* Cannot depend on values returned */
1878 error("select error: %s", sys_errlist
[xerrno
]);
1880 #if defined(sun) && !defined(USG5_4)
1881 else if (nfds
> 0 && FD_ISSET (0, &Available
) && interrupt_input
)
1882 /* System sometimes fails to deliver SIGIO.
1884 David J. Mackenzie says that Emacs doesn't compile under
1885 Solaris if this code is enabled, thus the USG5_4 in the CPP
1886 conditional. "I haven't noticed any ill effects so far.
1887 If you find a Solaris expert somewhere, they might know
1889 kill (getpid (), SIGIO
);
1892 /* Check for keyboard input */
1893 /* If there is any, return immediately
1894 to give it higher priority than subprocesses */
1896 if ((XINT (read_kbd
) || wait_for_cell
)
1897 && detect_input_pending ())
1900 if (detect_input_pending ())
1904 /* Exit now if the cell we're waiting for became non-nil. */
1905 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1909 /* If we think we have keyboard input waiting, but didn't get SIGIO
1910 go read it. This can happen with X on BSD after logging out.
1911 In that case, there really is no input and no SIGIO,
1912 but select says there is input. */
1914 if (XINT (read_kbd
) && interrupt_input
&& (FD_ISSET (fileno (stdin
), &Available
)))
1919 got_some_input
|= nfds
> 0;
1921 /* If checking input just got us a size-change event from X,
1922 obey it now if we should. */
1923 if (XINT (read_kbd
) || wait_for_cell
)
1924 do_pending_window_change ();
1926 /* Check for data from a process or a command channel */
1927 for (channel
= FIRST_PROC_DESC
; channel
< MAXDESC
; channel
++)
1929 if (FD_ISSET (channel
, &Available
))
1933 /* If waiting for this channel, arrange to return as
1934 soon as no more input to be processed. No more
1936 if (wait_channel
== channel
)
1942 proc
= chan_process
[channel
];
1946 /* Read data from the process, starting with our
1947 buffered-ahead character if we have one. */
1949 nread
= read_process_output (proc
, channel
);
1952 /* Since read_process_output can run a filter,
1953 which can call accept-process-output,
1954 don't try to read from any other processes
1955 before doing the select again. */
1956 FD_ZERO (&Available
);
1959 redisplay_preserve_echo_area ();
1962 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1966 else if (nread
== -1 && errno
== EAGAIN
)
1970 else if (nread
== -1 && errno
== EAGAIN
)
1972 /* Note that we cannot distinguish between no input
1973 available now and a closed pipe.
1974 With luck, a closed pipe will be accompanied by
1975 subprocess termination and SIGCHLD. */
1976 else if (nread
== 0 && !NETCONN_P (proc
))
1978 #endif /* O_NDELAY */
1979 #endif /* O_NONBLOCK */
1980 #endif /* EWOULDBLOCK */
1982 /* On some OSs with ptys, when the process on one end of
1983 a pty exits, the other end gets an error reading with
1984 errno = EIO instead of getting an EOF (0 bytes read).
1985 Therefore, if we get an error reading and errno =
1986 EIO, just continue, because the child process has
1987 exited and should clean itself up soon (e.g. when we
1989 else if (nread
== -1 && errno
== EIO
)
1991 #endif /* HAVE_PTYS */
1992 /* If we can detect process termination, don't consider the process
1993 gone just because its pipe is closed. */
1995 else if (nread
== 0 && !NETCONN_P (proc
))
2000 /* Preserve status of processes already terminated. */
2001 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2002 deactivate_process (proc
);
2003 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2004 update_status (XPROCESS (proc
));
2005 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2006 XPROCESS (proc
)->status
2007 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2010 } /* end for each file descriptor */
2011 } /* end while exit conditions not met */
2013 /* If calling from keyboard input, do not quit
2014 since we want to return C-g as an input character.
2015 Otherwise, do pending quit if requested. */
2016 if (XINT (read_kbd
) >= 0)
2018 /* Prevent input_pending from remaining set if we quit. */
2019 clear_input_pending ();
2023 return got_some_input
;
2026 /* Read pending output from the process channel,
2027 starting with our buffered-ahead character if we have one.
2028 Yield number of characters read.
2030 This function reads at most 1024 characters.
2031 If you want to read all available subprocess output,
2032 you must call it repeatedly until it returns zero. */
2034 read_process_output (proc
, channel
)
2036 register int channel
;
2038 register int nchars
;
2044 register Lisp_Object outstream
;
2045 register struct buffer
*old
= current_buffer
;
2046 register struct Lisp_Process
*p
= XPROCESS (proc
);
2047 register int opoint
;
2050 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2052 vs
= get_vms_process_pointer (p
->pid
);
2056 return(0); /* Really weird if it does this */
2057 if (!(vs
->iosb
[0] & 1))
2058 return -1; /* I/O error */
2061 error ("Could not get VMS process pointer");
2062 chars
= vs
->inputBuffer
;
2063 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2066 start_vms_process_read (vs
); /* Crank up the next read on the process */
2067 return 1; /* Nothing worth printing, say we got 1 */
2071 if (proc_buffered_char
[channel
] < 0)
2072 nchars
= read (channel
, chars
, sizeof chars
);
2075 chars
[0] = proc_buffered_char
[channel
];
2076 proc_buffered_char
[channel
] = -1;
2077 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2081 nchars
= nchars
+ 1;
2083 #endif /* not VMS */
2085 if (nchars
<= 0) return nchars
;
2087 outstream
= p
->filter
;
2088 if (!NILP (outstream
))
2090 /* We inhibit quit here instead of just catching it so that
2091 hitting ^G when a filter happens to be running won't screw
2093 int count
= specpdl_ptr
- specpdl
;
2094 Lisp_Object odeactivate
;
2096 odeactivate
= Vdeactivate_mark
;
2098 specbind (Qinhibit_quit
, Qt
);
2099 call2 (outstream
, proc
, make_string (chars
, nchars
));
2101 /* Handling the process output should not deactivate the mark. */
2102 Vdeactivate_mark
= odeactivate
;
2105 start_vms_process_read (vs
);
2111 /* If no filter, write into buffer if it isn't dead. */
2112 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2114 Lisp_Object old_read_only
;
2115 Lisp_Object old_begv
, old_zv
;
2116 Lisp_Object odeactivate
;
2118 odeactivate
= Vdeactivate_mark
;
2120 Fset_buffer (p
->buffer
);
2122 old_read_only
= current_buffer
->read_only
;
2123 XFASTINT (old_begv
) = BEGV
;
2124 XFASTINT (old_zv
) = ZV
;
2126 current_buffer
->read_only
= Qnil
;
2128 /* Insert new output into buffer
2129 at the current end-of-output marker,
2130 thus preserving logical ordering of input and output. */
2131 if (XMARKER (p
->mark
)->buffer
)
2132 SET_PT (marker_position (p
->mark
));
2136 /* If the output marker is outside of the visible region, save
2137 the restriction and widen. */
2138 if (! (BEGV
<= point
&& point
<= ZV
))
2141 /* Make sure opoint floats ahead of any new text, just as point
2143 if (point
<= opoint
)
2146 /* Insert after old_begv, but before old_zv. */
2147 if (point
< XFASTINT (old_begv
))
2148 XFASTINT (old_begv
) += nchars
;
2149 if (point
<= XFASTINT (old_zv
))
2150 XFASTINT (old_zv
) += nchars
;
2152 /* Insert before markers in case we are inserting where
2153 the buffer's mark is, and the user's next command is Meta-y. */
2154 insert_before_markers (chars
, nchars
);
2155 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2157 update_mode_lines
++;
2159 /* If the restriction isn't what it should be, set it. */
2160 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2161 Fnarrow_to_region (old_begv
, old_zv
);
2163 /* Handling the process output should not deactivate the mark. */
2164 Vdeactivate_mark
= odeactivate
;
2166 current_buffer
->read_only
= old_read_only
;
2168 set_buffer_internal (old
);
2171 start_vms_process_read (vs
);
2176 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2178 "Returns non-NIL if emacs is waiting for input from the user.\n\
2179 This is intended for use by asynchronous process output filters and sentinels.")
2182 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2185 /* Sending data to subprocess */
2187 jmp_buf send_process_frame
;
2190 send_process_trap ()
2196 longjmp (send_process_frame
, 1);
2199 send_process (proc
, buf
, len
)
2204 /* Don't use register vars; longjmp can lose them. */
2206 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2210 struct Lisp_Process
*p
= XPROCESS (proc
);
2211 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2214 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2215 update_status (XPROCESS (proc
));
2216 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2217 error ("Process %s not running", procname
);
2220 vs
= get_vms_process_pointer (p
->pid
);
2222 error ("Could not find this process: %x", p
->pid
);
2223 else if (write_to_vms_process (vs
, buf
, len
))
2226 if (!setjmp (send_process_frame
))
2230 SIGTYPE (*old_sigpipe
)();
2232 /* Don't send more than 500 bytes at a time. */
2235 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2236 rv
= write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, this);
2237 signal (SIGPIPE
, old_sigpipe
);
2242 || errno
== EWOULDBLOCK
2249 /* It would be nice to accept process output here,
2250 but that is difficult. For example, it could
2251 garbage what we are sending if that is from a buffer. */
2258 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2262 /* Allow input from processes between bursts of sending.
2263 Otherwise things may get stopped up. */
2268 XFASTINT (zero
) = 0;
2269 wait_reading_process_input (-1, 0, zero
, 0);
2275 XPROCESS (proc
)->raw_status_low
= Qnil
;
2276 XPROCESS (proc
)->raw_status_high
= Qnil
;
2277 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2278 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2279 deactivate_process (proc
);
2281 error ("Error writing to process %s; closed it", procname
);
2283 error ("SIGPIPE raised on process %s; closed it", procname
);
2288 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2290 "Send current contents of region as input to PROCESS.\n\
2291 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2292 nil, indicating the current buffer's process.\n\
2293 Called from program, takes three arguments, PROCESS, START and END.\n\
2294 If the region is more than 500 characters long,\n\
2295 it is sent in several bunches. This may happen even for shorter regions.\n\
2296 Output from processes can arrive in between bunches.")
2297 (process
, start
, end
)
2298 Lisp_Object process
, start
, end
;
2303 proc
= get_process (process
);
2304 validate_region (&start
, &end
);
2306 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2309 start1
= XINT (start
);
2310 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2315 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2317 "Send PROCESS the contents of STRING as input.\n\
2318 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2319 nil, indicating the current buffer's process.\n\
2320 If STRING is more than 500 characters long,\n\
2321 it is sent in several bunches. This may happen even for shorter strings.\n\
2322 Output from processes can arrive in between bunches.")
2324 Lisp_Object process
, string
;
2327 CHECK_STRING (string
, 1);
2328 proc
= get_process (process
);
2329 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2333 /* send a signal number SIGNO to PROCESS.
2334 CURRENT_GROUP means send to the process group that currently owns
2335 the terminal being used to communicate with PROCESS.
2336 This is used for various commands in shell mode.
2337 If NOMSG is zero, insert signal-announcements into process's buffers
2340 If we can, we try to signal PROCESS by sending control characters
2341 down the pipe. This allows us to signal inferiors who have changed
2342 their uid, for which killpg would return an EPERM error. */
2345 process_send_signal (process
, signo
, current_group
, nomsg
)
2346 Lisp_Object process
;
2348 Lisp_Object current_group
;
2352 register struct Lisp_Process
*p
;
2356 proc
= get_process (process
);
2357 p
= XPROCESS (proc
);
2359 if (!EQ (p
->childp
, Qt
))
2360 error ("Process %s is not a subprocess",
2361 XSTRING (p
->name
)->data
);
2362 if (!XFASTINT (p
->infd
))
2363 error ("Process %s is not active",
2364 XSTRING (p
->name
)->data
);
2366 if (NILP (p
->pty_flag
))
2367 current_group
= Qnil
;
2369 /* If we are using pgrps, get a pgrp number and make it negative. */
2370 if (!NILP (current_group
))
2372 #ifdef SIGNALS_VIA_CHARACTERS
2373 /* If possible, send signals to the entire pgrp
2374 by sending an input character to it. */
2376 /* TERMIOS is the latest and bestest, and seems most likely to
2377 work. If the system has it, use it. */
2384 tcgetattr (XFASTINT (p
->infd
), &t
);
2385 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2389 tcgetattr (XFASTINT (p
->infd
), &t
);
2390 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2394 tcgetattr (XFASTINT (p
->infd
), &t
);
2396 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2398 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2403 #else /* ! HAVE_TERMIOS */
2405 /* On Berkeley descendants, the following IOCTL's retrieve the
2406 current control characters. */
2407 #if defined (TIOCGLTC) && defined (TIOCGETC)
2415 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2416 send_process (proc
, &c
.t_intrc
, 1);
2419 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2420 send_process (proc
, &c
.t_quitc
, 1);
2424 ioctl (XFASTINT (p
->infd
), TIOCGLTC
, &lc
);
2425 send_process (proc
, &lc
.t_suspc
, 1);
2427 #endif /* ! defined (SIGTSTP) */
2430 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2432 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2439 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2440 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2443 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2444 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2448 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2449 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2451 #endif /* ! defined (SIGTSTP) */
2453 #else /* ! defined (TCGETA) */
2454 Your configuration files are messed up
.
2455 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2456 you'd better be using one of the alternatives above! */
2457 #endif /* ! defined (TCGETA) */
2458 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2459 #endif /* ! defined HAVE_TERMIOS */
2460 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2463 /* Get the pgrp using the tty itself, if we have that.
2464 Otherwise, use the pty to get the pgrp.
2465 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2466 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2467 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2468 His patch indicates that if TIOCGPGRP returns an error, then
2469 we should just assume that p->pid is also the process group id. */
2473 if (!NILP (p
->subtty
))
2474 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2476 err
= ioctl (XFASTINT (p
->infd
), TIOCGPGRP
, &gid
);
2480 gid
= - XFASTINT (p
->pid
);
2481 #endif /* ! defined (pfa) */
2487 #else /* ! defined (TIOCGPGRP ) */
2488 /* Can't select pgrps on this system, so we know that
2489 the child itself heads the pgrp. */
2490 gid
= - XFASTINT (p
->pid
);
2491 #endif /* ! defined (TIOCGPGRP ) */
2494 gid
= - XFASTINT (p
->pid
);
2500 p
->raw_status_low
= Qnil
;
2501 p
->raw_status_high
= Qnil
;
2503 XSETINT (p
->tick
, ++process_tick
);
2507 #endif /* ! defined (SIGCONT) */
2510 send_process (proc
, "\003", 1); /* ^C */
2515 send_process (proc
, "\031", 1); /* ^Y */
2520 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2523 flush_pending_output (XFASTINT (p
->infd
));
2527 /* If we don't have process groups, send the signal to the immediate
2528 subprocess. That isn't really right, but it's better than any
2529 obvious alternative. */
2532 kill (XFASTINT (p
->pid
), signo
);
2536 /* gid may be a pid, or minus a pgrp's number */
2538 if (!NILP (current_group
))
2539 ioctl (XFASTINT (p
->infd
), TIOCSIGSEND
, signo
);
2542 gid
= - XFASTINT (p
->pid
);
2545 #else /* ! defined (TIOCSIGSEND) */
2546 EMACS_KILLPG (-gid
, signo
);
2547 #endif /* ! defined (TIOCSIGSEND) */
2550 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2551 "Interrupt process PROCESS. May be process or name of one.\n\
2552 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2553 Nil or no arg means current buffer's process.\n\
2554 Second arg CURRENT-GROUP non-nil means send signal to\n\
2555 the current process-group of the process's controlling terminal\n\
2556 rather than to the process's own process group.\n\
2557 If the process is a shell, this means interrupt current subjob\n\
2558 rather than the shell.")
2559 (process
, current_group
)
2560 Lisp_Object process
, current_group
;
2562 process_send_signal (process
, SIGINT
, current_group
, 0);
2566 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2567 "Kill process PROCESS. May be process or name of one.\n\
2568 See function `interrupt-process' for more details on usage.")
2569 (process
, current_group
)
2570 Lisp_Object process
, current_group
;
2572 process_send_signal (process
, SIGKILL
, current_group
, 0);
2576 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2577 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2578 See function `interrupt-process' for more details on usage.")
2579 (process
, current_group
)
2580 Lisp_Object process
, current_group
;
2582 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2586 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2587 "Stop process PROCESS. May be process or name of one.\n\
2588 See function `interrupt-process' for more details on usage.")
2589 (process
, current_group
)
2590 Lisp_Object process
, current_group
;
2593 error ("no SIGTSTP support");
2595 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2600 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2601 "Continue process PROCESS. May be process or name of one.\n\
2602 See function `interrupt-process' for more details on usage.")
2603 (process
, current_group
)
2604 Lisp_Object process
, current_group
;
2607 process_send_signal (process
, SIGCONT
, current_group
, 0);
2609 error ("no SIGCONT support");
2614 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2615 2, 2, "nProcess number: \nnSignal code: ",
2616 "Send the process with number PID the signal with code CODE.\n\
2617 Both PID and CODE are integers.")
2619 Lisp_Object pid
, sig
;
2621 CHECK_NUMBER (pid
, 0);
2622 CHECK_NUMBER (sig
, 1);
2623 return make_number (kill (XINT (pid
), XINT (sig
)));
2626 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2627 "Make PROCESS see end-of-file in its input.\n\
2628 Eof comes after any text already sent to it.\n\
2629 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2630 nil, indicating the current buffer's process.")
2632 Lisp_Object process
;
2636 proc
= get_process (process
);
2638 /* Make sure the process is really alive. */
2639 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2640 update_status (XPROCESS (proc
));
2641 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2642 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2644 /* Sending a zero-length record is supposed to mean eof
2645 when TIOCREMOTE is turned on. */
2649 write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, 0);
2651 #else /* did not do TOICREMOTE */
2653 send_process (proc
, "\032", 1); /* ^z */
2655 if (!NILP (XPROCESS (proc
)->pty_flag
))
2656 send_process (proc
, "\004", 1);
2659 close (XPROCESS (proc
)->outfd
);
2660 XFASTINT (XPROCESS (proc
)->outfd
) = open (NULL_DEVICE
, O_WRONLY
);
2663 #endif /* did not do TOICREMOTE */
2667 /* Kill all processes associated with `buffer'.
2668 If `buffer' is nil, kill all processes */
2670 kill_buffer_processes (buffer
)
2673 Lisp_Object tail
, proc
;
2675 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2676 tail
= XCONS (tail
)->cdr
)
2678 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2679 if (XGCTYPE (proc
) == Lisp_Process
2680 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2682 if (NETCONN_P (proc
))
2683 deactivate_process (proc
);
2684 else if (XFASTINT (XPROCESS (proc
)->infd
))
2685 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2690 /* On receipt of a signal that a child status has changed,
2691 loop asking about children with changed statuses until
2692 the system says there are no more.
2693 All we do is change the status;
2694 we do not run sentinels or print notifications.
2695 That is saved for the next time keyboard input is done,
2696 in order to avoid timing errors. */
2698 /** WARNING: this can be called during garbage collection.
2699 Therefore, it must not be fooled by the presence of mark bits in
2702 /** USG WARNING: Although it is not obvious from the documentation
2703 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2704 signal() before executing at least one wait(), otherwise the handler
2705 will be called again, resulting in an infinite loop. The relevant
2706 portion of the documentation reads "SIGCLD signals will be queued
2707 and the signal-catching function will be continually reentered until
2708 the queue is empty". Invoking signal() causes the kernel to reexamine
2709 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2712 sigchld_handler (signo
)
2715 int old_errno
= errno
;
2717 register struct Lisp_Process
*p
;
2718 extern EMACS_TIME
*input_available_clear_time
;
2722 sigheld
|= sigbit (SIGCHLD
);
2734 #endif /* no WUNTRACED */
2735 /* Keep trying to get a status until we get a definitive result. */
2739 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2741 while (pid
<= 0 && errno
== EINTR
);
2745 /* A real failure. We have done all our job, so return. */
2747 /* USG systems forget handlers when they are used;
2748 must reestablish each time */
2750 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2753 sigheld
&= ~sigbit (SIGCHLD
);
2761 #endif /* no WNOHANG */
2763 /* Find the process that signaled us, and record its status. */
2766 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2768 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2769 p
= XPROCESS (proc
);
2770 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2775 /* Look for an asynchronous process whose pid hasn't been filled
2778 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2780 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2781 p
= XPROCESS (proc
);
2782 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2787 /* Change the status of the process that was found. */
2790 union { int i
; WAITTYPE wt
; } u
;
2792 XSETINT (p
->tick
, ++process_tick
);
2794 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2795 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2797 /* If process has terminated, stop waiting for its output. */
2798 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2799 if (XFASTINT (p
->infd
))
2800 FD_CLR (XFASTINT (p
->infd
), &input_wait_mask
);
2802 /* Tell wait_reading_process_input that it needs to wake up and
2804 if (input_available_clear_time
)
2805 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2808 /* There was no asynchronous process found for that id. Check
2809 if we have a synchronous process. */
2812 synch_process_alive
= 0;
2814 /* Report the status of the synchronous process. */
2816 synch_process_retcode
= WRETCODE (w
);
2817 else if (WIFSIGNALED (w
))
2819 synch_process_death
= (char *) sys_siglist
[WTERMSIG (w
)];
2821 synch_process_death
= sys_errlist
[WTERMSIG (w
)];
2824 /* Tell wait_reading_process_input that it needs to wake up and
2826 if (input_available_clear_time
)
2827 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2830 /* On some systems, we must return right away.
2831 If any more processes want to signal us, we will
2833 Otherwise (on systems that have WNOHANG), loop around
2834 to use up all the processes that have something to tell us. */
2835 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2837 signal (signo
, sigchld_handler
);
2841 #endif /* USG, but not HPUX with WNOHANG */
2847 exec_sentinel_unwind (data
)
2850 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2855 exec_sentinel (proc
, reason
)
2856 Lisp_Object proc
, reason
;
2858 Lisp_Object sentinel
;
2859 register struct Lisp_Process
*p
= XPROCESS (proc
);
2860 int count
= specpdl_ptr
- specpdl
;
2862 sentinel
= p
->sentinel
;
2863 if (NILP (sentinel
))
2866 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2867 assure that it gets restored no matter how the sentinel exits. */
2869 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2870 /* Inhibit quit so that random quits don't screw up a running filter. */
2871 specbind (Qinhibit_quit
, Qt
);
2872 call2 (sentinel
, proc
, reason
);
2876 /* Report all recent events of a change in process status
2877 (either run the sentinel or output a message).
2878 This is done while Emacs is waiting for keyboard input. */
2882 register Lisp_Object proc
, buffer
;
2883 Lisp_Object tail
= Qnil
;
2884 Lisp_Object msg
= Qnil
;
2885 struct gcpro gcpro1
, gcpro2
;
2887 /* We need to gcpro tail; if read_process_output calls a filter
2888 which deletes a process and removes the cons to which tail points
2889 from Vprocess_alist, and then causes a GC, tail is an unprotected
2893 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2896 register struct Lisp_Process
*p
;
2898 proc
= Fcdr (Fcar (tail
));
2899 p
= XPROCESS (proc
);
2901 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2903 XSETINT (p
->update_tick
, XINT (p
->tick
));
2905 /* If process is still active, read any output that remains. */
2906 if (XFASTINT (p
->infd
))
2907 while (read_process_output (proc
, XFASTINT (p
->infd
)) > 0);
2911 /* Get the text to use for the message. */
2912 if (!NILP (p
->raw_status_low
))
2914 msg
= status_message (p
->status
);
2916 /* If process is terminated, deactivate it or delete it. */
2918 if (XTYPE (p
->status
) == Lisp_Cons
)
2919 symbol
= XCONS (p
->status
)->car
;
2921 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2922 || EQ (symbol
, Qclosed
))
2924 if (delete_exited_processes
)
2925 remove_process (proc
);
2927 deactivate_process (proc
);
2930 /* Now output the message suitably. */
2931 if (!NILP (p
->sentinel
))
2932 exec_sentinel (proc
, msg
);
2933 /* Don't bother with a message in the buffer
2934 when a process becomes runnable. */
2935 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2937 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2939 struct buffer
*old
= current_buffer
;
2942 /* Avoid error if buffer is deleted
2943 (probably that's why the process is dead, too) */
2944 if (NILP (XBUFFER (buffer
)->name
))
2946 Fset_buffer (buffer
);
2948 /* Insert new output into buffer
2949 at the current end-of-output marker,
2950 thus preserving logical ordering of input and output. */
2951 if (XMARKER (p
->mark
)->buffer
)
2952 SET_PT (marker_position (p
->mark
));
2955 if (point
<= opoint
)
2956 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2958 tem
= current_buffer
->read_only
;
2959 current_buffer
->read_only
= Qnil
;
2960 insert_string ("\nProcess ");
2961 Finsert (1, &p
->name
);
2962 insert_string (" ");
2964 current_buffer
->read_only
= tem
;
2965 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2968 set_buffer_internal (old
);
2973 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
2974 redisplay_preserve_echo_area ();
2976 update_tick
= process_tick
;
2987 if (! noninteractive
|| initialized
)
2989 signal (SIGCHLD
, sigchld_handler
);
2992 FD_ZERO (&input_wait_mask
);
2993 FD_SET (0, &input_wait_mask
);
2994 Vprocess_alist
= Qnil
;
2995 for (i
= 0; i
< MAXDESC
; i
++)
2997 chan_process
[i
] = Qnil
;
2998 proc_buffered_char
[i
] = -1;
3005 stream_process
= intern ("stream");
3007 Qprocessp
= intern ("processp");
3008 staticpro (&Qprocessp
);
3009 Qrun
= intern ("run");
3011 Qstop
= intern ("stop");
3013 Qsignal
= intern ("signal");
3014 staticpro (&Qsignal
);
3016 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3019 Qexit = intern ("exit");
3020 staticpro (&Qexit); */
3022 Qopen
= intern ("open");
3024 Qclosed
= intern ("closed");
3025 staticpro (&Qclosed
);
3027 staticpro (&Vprocess_alist
);
3029 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3030 "*Non-nil means delete processes immediately when they exit.\n\
3031 nil means don't delete them until `list-processes' is run.");
3033 delete_exited_processes
= 1;
3035 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3036 "Control type of device used to communicate with subprocesses.\n\
3037 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3038 pty's are not available, this variable will be ignored. The value takes\n\
3039 effect when `start-process' is called.");
3040 Vprocess_connection_type
= Qt
;
3042 defsubr (&Sprocessp
);
3043 defsubr (&Sget_process
);
3044 defsubr (&Sget_buffer_process
);
3045 defsubr (&Sdelete_process
);
3046 defsubr (&Sprocess_status
);
3047 defsubr (&Sprocess_exit_status
);
3048 defsubr (&Sprocess_id
);
3049 defsubr (&Sprocess_name
);
3050 defsubr (&Sprocess_command
);
3051 defsubr (&Sset_process_buffer
);
3052 defsubr (&Sprocess_buffer
);
3053 defsubr (&Sprocess_mark
);
3054 defsubr (&Sset_process_filter
);
3055 defsubr (&Sprocess_filter
);
3056 defsubr (&Sset_process_sentinel
);
3057 defsubr (&Sprocess_sentinel
);
3058 defsubr (&Sprocess_kill_without_query
);
3059 defsubr (&Slist_processes
);
3060 defsubr (&Sprocess_list
);
3061 defsubr (&Sstart_process
);
3063 defsubr (&Sopen_network_stream
);
3064 #endif /* HAVE_SOCKETS */
3065 defsubr (&Saccept_process_output
);
3066 defsubr (&Sprocess_send_region
);
3067 defsubr (&Sprocess_send_string
);
3068 defsubr (&Sinterrupt_process
);
3069 defsubr (&Skill_process
);
3070 defsubr (&Squit_process
);
3071 defsubr (&Sstop_process
);
3072 defsubr (&Scontinue_process
);
3073 defsubr (&Sprocess_send_eof
);
3074 defsubr (&Ssignal_process
);
3075 defsubr (&Swaiting_for_user_input_p
);
3076 /* defsubr (&Sprocess_connection); */
3080 #else /* not subprocesses */
3082 #include <sys/types.h>
3086 #include "systime.h"
3087 #include "termopts.h"
3089 extern int frame_garbaged
;
3092 /* As described above, except assuming that there are no subprocesses:
3094 Wait for timeout to elapse and/or keyboard input to be available.
3097 timeout in seconds, or
3098 zero for no limit, or
3099 -1 means gobble data immediately available but don't wait for any.
3101 read_kbd is a Lisp_Object:
3102 0 to ignore keyboard input, or
3103 1 to return when input is available, or
3104 -1 means caller will actually read the input, so don't throw to
3106 We know that read_kbd will never be a Lisp_Process, since
3107 `subprocesses' isn't defined.
3109 do_display != 0 means redisplay should be done to show subprocess
3110 output that arrives. This version of the function ignores it.
3112 Return true iff we received input from any process. */
3115 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3116 int time_limit
, microsecs
;
3117 Lisp_Object read_kbd
;
3120 EMACS_TIME end_time
, timeout
, *timeout_p
;
3123 /* What does time_limit really mean? */
3124 if (time_limit
|| microsecs
)
3126 /* It's not infinite. */
3127 timeout_p
= &timeout
;
3129 if (time_limit
== -1)
3130 /* In fact, it's zero. */
3131 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3133 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3135 /* How far in the future is that? */
3136 EMACS_GET_TIME (end_time
);
3137 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3140 /* It's infinite. */
3143 /* Turn off periodic alarms (in case they are in use)
3144 because the select emulator uses alarms. */
3151 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3153 /* If calling from keyboard input, do not quit
3154 since we want to return C-g as an input character.
3155 Otherwise, do pending quit if requested. */
3156 if (XINT (read_kbd
) >= 0)
3161 EMACS_GET_TIME (*timeout_p
);
3162 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3163 if (EMACS_TIME_NEG_P (*timeout_p
))
3167 /* Cause C-g and alarm signals to take immediate action,
3168 and cause input available signals to zero out timeout. */
3169 if (XINT (read_kbd
) < 0)
3170 set_waiting_for_input (&timeout
);
3172 /* If a frame has been newly mapped and needs updating,
3173 reprocess its display stuff. */
3175 redisplay_preserve_echo_area ();
3177 if (XINT (read_kbd
) && detect_input_pending ())
3180 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3182 /* Make C-g and alarm signals set flags again */
3183 clear_waiting_for_input ();
3185 /* If we woke up due to SIGWINCH, actually change size now. */
3186 do_pending_window_change ();
3190 /* If the system call was interrupted, then go around the
3196 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3197 /* System sometimes fails to deliver SIGIO. */
3198 kill (getpid (), SIGIO
);
3201 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3205 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3217 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3218 /* Don't confused make-docfile by having two doc strings for this function.
3219 make-docfile does not pay attention to #if, for good reason! */
3222 register Lisp_Object name
;
3227 /* Kill all processes associated with `buffer'.
3228 If `buffer' is nil, kill all processes.
3229 Since we have no subprocesses, this does nothing. */
3231 kill_buffer_processes (buffer
)
3242 defsubr (&Sget_buffer_process
);
3246 #endif /* not subprocesses */