1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94 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 */
45 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
46 #include <sys/socket.h>
48 #include <netinet/in.h>
49 #include <arpa/inet.h>
50 #endif /* HAVE_SOCKETS */
52 /* TERM is a poor-man's SLIP, used on Linux. */
57 /* DGUX inet_addr returns a 'struct in_addr'. */
59 #define IN_ADDR struct in_addr
60 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
62 #define IN_ADDR unsigned long
63 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
66 #if defined(BSD) || defined(STRIDE)
67 #include <sys/ioctl.h>
68 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
70 #endif /* HAVE_PTYS and no O_NDELAY */
71 #endif /* BSD or STRIDE */
73 #ifdef BROKEN_O_NONBLOCK
75 #endif /* BROKEN_O_NONBLOCK */
82 #include <sys/sysmacros.h> /* for "minor" */
92 #include "termhooks.h"
97 Lisp_Object Qprocessp
;
98 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
99 /* Qexit is declared and initialized in eval.c. */
101 /* a process object is a network connection when its childp field is neither
102 Qt nor Qnil but is instead a string (name of foreign host we
103 are connected to + name of port we are connected to) */
106 static Lisp_Object stream_process
;
108 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
110 #define NETCONN_P(p) 0
111 #endif /* HAVE_SOCKETS */
113 /* Define first descriptor number available for subprocesses. */
115 #define FIRST_PROC_DESC 1
117 #define FIRST_PROC_DESC 3
120 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
123 #if !defined (SIGCHLD) && defined (SIGCLD)
124 #define SIGCHLD SIGCLD
127 #include "syssignal.h"
132 extern char *strerror ();
134 extern char *sys_errlist
[];
137 #ifndef SYS_SIGLIST_DECLARED
141 extern char *sys_siglist
[];
142 #endif /* not LINUX */
144 char *sys_siglist
[] =
150 "illegal instruction",
154 "floating point exception",
157 "segmentation violation",
158 "bad argument to system call",
159 "write on a pipe with no one to read it",
161 "software termination signal from kill",
163 "sendable stop signal not from tty",
164 "stop signal from tty",
165 "continue a stopped process",
166 "child status has changed",
167 "background read attempted from control tty",
168 "background write attempted from control tty",
169 "input record available at control tty",
170 "exceeded CPU time limit",
171 "exceeded file size limit"
175 #endif /* ! SYS_SIGLIST_DECLARED */
177 /* t means use pty, nil means use a pipe,
178 maybe other values to come. */
179 static Lisp_Object Vprocess_connection_type
;
183 #include <sys/socket.h>
187 /* Number of events of change of status of a process. */
188 static int process_tick
;
190 /* Number of events for which the user or sentinel has been notified. */
191 static int update_tick
;
194 /* We could get this from param.h, but better not to depend on finding that.
195 And better not to risk that it might define other symbols used in this
198 #define MAXDESC FD_SETSIZE
202 #define SELECT_TYPE fd_set
203 #else /* no FD_SET */
205 #define SELECT_TYPE int
207 /* Define the macros to access a single-int bitmap of descriptors. */
208 #define FD_SET(n, p) (*(p) |= (1 << (n)))
209 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
210 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
211 #define FD_ZERO(p) (*(p) = 0)
212 #endif /* no FD_SET */
214 /* Mask of bits indicating the descriptors that we wait for input on */
216 static SELECT_TYPE input_wait_mask
;
218 /* Descriptor to use for keyboard input. */
219 static int keyboard_descriptor
;
221 /* Nonzero means delete a process right away if it exits. */
222 static int delete_exited_processes
;
224 /* Indexed by descriptor, gives the process (if any) for that descriptor */
225 Lisp_Object chan_process
[MAXDESC
];
227 /* Alist of elements (NAME . PROCESS) */
228 Lisp_Object Vprocess_alist
;
230 /* Buffered-ahead input char from process, indexed by channel.
231 -1 means empty (no char is buffered).
232 Used on sys V where the only way to tell if there is any
233 output from the process is to read at least one char.
234 Always -1 on systems that support FIONREAD. */
236 static int proc_buffered_char
[MAXDESC
];
238 static Lisp_Object
get_process ();
240 /* Maximum number of bytes to send to a pty without an eof. */
241 static int pty_max_bytes
;
243 /* Compute the Lisp form of the process status, p->status, from
244 the numeric status that was returned by `wait'. */
246 Lisp_Object
status_convert ();
249 struct Lisp_Process
*p
;
251 union { int i
; WAITTYPE wt
; } u
;
252 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
253 p
->status
= status_convert (u
.wt
);
254 p
->raw_status_low
= Qnil
;
255 p
->raw_status_high
= Qnil
;
258 /* Convert a process status word in Unix format to
259 the list that we use internally. */
266 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
267 else if (WIFEXITED (w
))
268 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
269 WCOREDUMP (w
) ? Qt
: Qnil
));
270 else if (WIFSIGNALED (w
))
271 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
272 WCOREDUMP (w
) ? Qt
: Qnil
));
277 /* Given a status-list, extract the three pieces of information
278 and store them individually through the three pointers. */
281 decode_status (l
, symbol
, code
, coredump
)
289 if (XTYPE (l
) == Lisp_Symbol
)
297 *symbol
= XCONS (l
)->car
;
298 tem
= XCONS (l
)->cdr
;
299 *code
= XFASTINT (XCONS (tem
)->car
);
300 tem
= XCONS (tem
)->cdr
;
301 *coredump
= !NILP (tem
);
305 /* Return a string describing a process status list. */
308 status_message (status
)
313 Lisp_Object string
, string2
;
315 decode_status (status
, &symbol
, &code
, &coredump
);
317 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
323 signame
= sys_siglist
[code
];
325 signame
= sys_errlist
[code
];
330 string
= build_string (signame
);
331 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
332 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
333 return concat2 (string
, string2
);
335 else if (EQ (symbol
, Qexit
))
338 return build_string ("finished\n");
339 string
= Fnumber_to_string (make_number (code
));
340 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
341 return concat2 (build_string ("exited abnormally with code "),
342 concat2 (string
, string2
));
345 return Fcopy_sequence (Fsymbol_name (symbol
));
350 /* Open an available pty, returning a file descriptor.
351 Return -1 on failure.
352 The file name of the terminal corresponding to the pty
353 is left in the variable pty_name. */
364 /* Some systems name their pseudoterminals so that there are gaps in
365 the usual sequence - for example, on HP9000/S700 systems, there
366 are no pseudoterminals with names ending in 'f'. So we wait for
367 three failures in a row before deciding that we've reached the
369 int failed_count
= 0;
374 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
375 for (i
= 0; i
< 16; i
++)
378 #ifdef PTY_NAME_SPRINTF
381 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
382 #endif /* no PTY_NAME_SPRINTF */
386 #else /* no PTY_OPEN */
388 /* Unusual IRIS code */
389 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
392 if (fstat (fd
, &stb
) < 0)
395 if (stat (pty_name
, &stb
) < 0)
398 if (failed_count
>= 3)
404 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
406 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
408 #endif /* not IRIS */
409 #endif /* no PTY_OPEN */
413 /* check to make certain that both sides are available
414 this avoids a nasty yet stupid bug in rlogins */
415 #ifdef PTY_TTY_NAME_SPRINTF
418 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
419 #endif /* no PTY_TTY_NAME_SPRINTF */
421 if (access (pty_name
, 6) != 0)
424 #if !defined(IRIS) && !defined(__sgi)
430 #endif /* not UNIPLUS */
437 #endif /* HAVE_PTYS */
443 register Lisp_Object val
, tem
, name1
;
444 register struct Lisp_Process
*p
;
448 /* size of process structure includes the vector header,
449 so deduct for that. But struct Lisp_Vector includes the first
450 element, thus deducts too much, so add it back. */
451 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
452 - sizeof (struct Lisp_Vector
)
453 + sizeof (Lisp_Object
))
454 / sizeof (Lisp_Object
)),
456 XSETTYPE (val
, Lisp_Process
);
459 XSET (p
->infd
, Lisp_Int
, -1);
460 XSET (p
->outfd
, Lisp_Int
, -1);
461 XFASTINT (p
->pid
) = 0;
462 XFASTINT (p
->tick
) = 0;
463 XFASTINT (p
->update_tick
) = 0;
464 p
->raw_status_low
= Qnil
;
465 p
->raw_status_high
= Qnil
;
467 p
->mark
= Fmake_marker ();
469 /* If name is already in use, modify it until it is unused. */
474 tem
= Fget_process (name1
);
475 if (NILP (tem
)) break;
476 sprintf (suffix
, "<%d>", i
);
477 name1
= concat2 (name
, build_string (suffix
));
481 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
485 remove_process (proc
)
486 register Lisp_Object proc
;
488 register Lisp_Object pair
;
490 pair
= Frassq (proc
, Vprocess_alist
);
491 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
492 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
494 deactivate_process (proc
);
497 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
498 "Return t if OBJECT is a process.")
502 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
505 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
506 "Return the process named NAME, or nil if there is none.")
508 register Lisp_Object name
;
510 if (XTYPE (name
) == Lisp_Process
)
512 CHECK_STRING (name
, 0);
513 return Fcdr (Fassoc (name
, Vprocess_alist
));
516 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
517 "Return the (or, a) process associated with BUFFER.\n\
518 BUFFER may be a buffer or the name of one.")
520 register Lisp_Object name
;
522 register Lisp_Object buf
, tail
, proc
;
524 if (NILP (name
)) return Qnil
;
525 buf
= Fget_buffer (name
);
526 if (NILP (buf
)) return Qnil
;
528 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
530 proc
= Fcdr (Fcar (tail
));
531 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
537 /* This is how commands for the user decode process arguments. It
538 accepts a process, a process name, a buffer, a buffer name, or nil.
539 Buffers denote the first process in the buffer, and nil denotes the
544 register Lisp_Object name
;
546 register Lisp_Object proc
, obj
;
549 obj
= Fget_process (name
);
551 obj
= Fget_buffer (name
);
553 error ("Process %s does not exist", XSTRING (name
)->data
);
555 else if (NILP (name
))
556 obj
= Fcurrent_buffer ();
560 /* Now obj should be either a buffer object or a process object.
564 proc
= Fget_buffer_process (obj
);
566 error ("Buffer %s has no process", XSTRING (XBUFFER (obj
)->name
)->data
);
570 CHECK_PROCESS (obj
, 0);
576 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
577 "Delete PROCESS: kill it and forget about it immediately.\n\
578 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
579 nil, indicating the current buffer's process.")
581 register Lisp_Object proc
;
583 proc
= get_process (proc
);
584 XPROCESS (proc
)->raw_status_low
= Qnil
;
585 XPROCESS (proc
)->raw_status_high
= Qnil
;
586 if (NETCONN_P (proc
))
588 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
589 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
591 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
593 Fkill_process (proc
, Qnil
);
594 /* Do this now, since remove_process will make sigchld_handler do nothing. */
595 XPROCESS (proc
)->status
596 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
597 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
600 remove_process (proc
);
604 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
605 "Return the status of PROCESS: a symbol, one of these:\n\
606 run -- for a process that is running.\n\
607 stop -- for a process stopped but continuable.\n\
608 exit -- for a process that has exited.\n\
609 signal -- for a process that has got a fatal signal.\n\
610 open -- for a network stream connection that is open.\n\
611 closed -- for a network stream connection that is closed.\n\
612 nil -- if arg is a process name and no such process exists.\n\
613 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
614 nil, indicating the current buffer's process.")
616 register Lisp_Object proc
;
618 register struct Lisp_Process
*p
;
619 register Lisp_Object status
;
620 proc
= get_process (proc
);
624 if (!NILP (p
->raw_status_low
))
627 if (XTYPE (status
) == Lisp_Cons
)
628 status
= XCONS (status
)->car
;
629 if (NETCONN_P (proc
))
631 if (EQ (status
, Qrun
))
633 else if (EQ (status
, Qexit
))
639 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
641 "Return the exit status of PROCESS or the signal number that killed it.\n\
642 If PROCESS has not yet exited or died, return 0.")
644 register Lisp_Object proc
;
646 CHECK_PROCESS (proc
, 0);
647 if (!NILP (XPROCESS (proc
)->raw_status_low
))
648 update_status (XPROCESS (proc
));
649 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
650 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
651 return make_number (0);
654 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
655 "Return the process id of PROCESS.\n\
656 This is the pid of the Unix process which PROCESS uses or talks to.\n\
657 For a network connection, this value is nil.")
659 register Lisp_Object proc
;
661 CHECK_PROCESS (proc
, 0);
662 return XPROCESS (proc
)->pid
;
665 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
666 "Return the name of PROCESS, as a string.\n\
667 This is the name of the program invoked in PROCESS,\n\
668 possibly modified to make it unique among process names.")
670 register Lisp_Object proc
;
672 CHECK_PROCESS (proc
, 0);
673 return XPROCESS (proc
)->name
;
676 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
677 "Return the command that was executed to start PROCESS.\n\
678 This is a list of strings, the first string being the program executed\n\
679 and the rest of the strings being the arguments given to it.\n\
680 For a non-child channel, this is nil.")
682 register Lisp_Object proc
;
684 CHECK_PROCESS (proc
, 0);
685 return XPROCESS (proc
)->command
;
688 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
690 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
692 register Lisp_Object proc
, buffer
;
694 CHECK_PROCESS (proc
, 0);
696 CHECK_BUFFER (buffer
, 1);
697 XPROCESS (proc
)->buffer
= buffer
;
701 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
703 "Return the buffer PROCESS is associated with.\n\
704 Output from PROCESS is inserted in this buffer\n\
705 unless PROCESS has a filter.")
707 register Lisp_Object proc
;
709 CHECK_PROCESS (proc
, 0);
710 return XPROCESS (proc
)->buffer
;
713 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
715 "Return the marker for the end of the last output from PROCESS.")
717 register Lisp_Object proc
;
719 CHECK_PROCESS (proc
, 0);
720 return XPROCESS (proc
)->mark
;
723 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
725 "Give PROCESS the filter function FILTER; nil means no filter.\n\
726 t means stop accepting output from the process.\n\
727 When a process has a filter, each time it does output\n\
728 the entire string of output is passed to the filter.\n\
729 The filter gets two arguments: the process and the string of output.\n\
730 If the process has a filter, its buffer is not used for output.")
732 register Lisp_Object proc
, filter
;
734 CHECK_PROCESS (proc
, 0);
736 FD_CLR (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
737 else if (EQ (XPROCESS (proc
)->filter
, Qt
))
738 FD_SET (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
739 XPROCESS (proc
)->filter
= filter
;
743 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
745 "Returns the filter function of PROCESS; nil if none.\n\
746 See `set-process-filter' for more info on filter functions.")
748 register Lisp_Object proc
;
750 CHECK_PROCESS (proc
, 0);
751 return XPROCESS (proc
)->filter
;
754 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
756 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
757 The sentinel is called as a function when the process changes state.\n\
758 It gets two arguments: the process, and a string describing the change.")
760 register Lisp_Object proc
, sentinel
;
762 CHECK_PROCESS (proc
, 0);
763 XPROCESS (proc
)->sentinel
= sentinel
;
767 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
769 "Return the sentinel of PROCESS; nil if none.\n\
770 See `set-process-sentinel' for more info on sentinels.")
772 register Lisp_Object proc
;
774 CHECK_PROCESS (proc
, 0);
775 return XPROCESS (proc
)->sentinel
;
778 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
779 Sprocess_kill_without_query
, 1, 2, 0,
780 "Say no query needed if PROCESS is running when Emacs is exited.\n\
781 Optional second argument if non-nil says to require a query.\n\
782 Value is t if a query was formerly required.")
784 register Lisp_Object proc
, value
;
788 CHECK_PROCESS (proc
, 0);
789 tem
= XPROCESS (proc
)->kill_without_query
;
790 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
795 #if 0 /* Turned off because we don't currently record this info
796 in the process. Perhaps add it. */
797 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
798 "Return the connection type of `PROCESS'.\n\
799 The value is `nil' for a pipe,\n\
800 `t' or `pty' for a pty, or `stream' for a socket connection.")
804 return XPROCESS (process
)->type
;
811 register Lisp_Object tail
, tem
;
812 Lisp_Object proc
, minspace
, tem1
;
813 register struct buffer
*old
= current_buffer
;
814 register struct Lisp_Process
*p
;
818 XFASTINT (minspace
) = 1;
820 set_buffer_internal (XBUFFER (Vstandard_output
));
821 Fbuffer_disable_undo (Vstandard_output
);
823 current_buffer
->truncate_lines
= Qt
;
826 Proc Status Buffer Command\n\
827 ---- ------ ------ -------\n", -1);
829 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
833 proc
= Fcdr (Fcar (tail
));
835 if (NILP (p
->childp
))
838 Finsert (1, &p
->name
);
839 Findent_to (make_number (13), minspace
);
841 if (!NILP (p
->raw_status_low
))
844 if (XTYPE (p
->status
) == Lisp_Cons
)
845 symbol
= XCONS (p
->status
)->car
;
848 if (EQ (symbol
, Qsignal
))
851 tem
= Fcar (Fcdr (p
->status
));
853 if (XINT (tem
) < NSIG
)
854 write_string (sys_errlist
[XINT (tem
)], -1);
857 Fprinc (symbol
, Qnil
);
859 else if (NETCONN_P (proc
))
861 if (EQ (symbol
, Qrun
))
862 write_string ("open", -1);
863 else if (EQ (symbol
, Qexit
))
864 write_string ("closed", -1);
866 Fprinc (symbol
, Qnil
);
869 Fprinc (symbol
, Qnil
);
871 if (EQ (symbol
, Qexit
))
874 tem
= Fcar (Fcdr (p
->status
));
877 sprintf (tembuf
, " %d", XFASTINT (tem
));
878 write_string (tembuf
, -1);
882 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
883 remove_process (proc
);
885 Findent_to (make_number (22), minspace
);
886 if (NILP (p
->buffer
))
887 insert_string ("(none)");
888 else if (NILP (XBUFFER (p
->buffer
)->name
))
889 insert_string ("(Killed)");
891 Finsert (1, &XBUFFER (p
->buffer
)->name
);
893 Findent_to (make_number (37), minspace
);
895 if (NETCONN_P (proc
))
897 sprintf (tembuf
, "(network stream connection to %s)\n",
898 XSTRING (p
->childp
)->data
);
899 insert_string (tembuf
);
913 insert_string ("\n");
919 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
920 "Display a list of all processes.\n\
921 \(Any processes listed as Exited or Signaled are actually eliminated\n\
922 after the listing is made.)")
925 internal_with_output_to_temp_buffer ("*Process List*",
926 list_processes_1
, Qnil
);
930 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
931 "Return a list of all processes.")
934 return Fmapcar (Qcdr
, Vprocess_alist
);
937 /* Starting asynchronous inferior processes. */
939 static Lisp_Object
start_process_unwind ();
941 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
942 "Start a program in a subprocess. Return the process object for it.\n\
943 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
944 NAME is name for process. It is modified if necessary to make it unique.\n\
945 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
946 Process output goes at end of that buffer, unless you specify\n\
947 an output stream or filter function to handle the output.\n\
948 BUFFER may be also nil, meaning that this process is not associated\n\
950 Third arg is program file name. It is searched for as in the shell.\n\
951 Remaining arguments are strings to give program as arguments.")
954 register Lisp_Object
*args
;
956 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
958 register unsigned char *new_argv
;
961 register unsigned char **new_argv
;
964 int count
= specpdl_ptr
- specpdl
;
968 buffer
= Fget_buffer_create (buffer
);
970 /* Make sure that the child will be able to chdir to the current
971 buffer's current directory, or its unhandled equivalent. We
972 can't just have the child check for an error when it does the
973 chdir, since it's in a vfork.
975 We have to GCPRO around this because Fexpand_file_name and
976 Funhandled_file_name_directory might call a file name handling
977 function. The argument list is protected by the caller, so all
978 we really have to worry about is buffer. */
980 struct gcpro gcpro1
, gcpro2
;
982 current_dir
= current_buffer
->directory
;
984 GCPRO2 (buffer
, current_dir
);
987 expand_and_dir_to_file
988 (Funhandled_file_name_directory (current_dir
), Qnil
);
989 if (NILP (Ffile_accessible_directory_p (current_dir
)))
990 report_file_error ("Setting current directory",
991 Fcons (current_buffer
->directory
, Qnil
));
997 CHECK_STRING (name
, 0);
1001 CHECK_STRING (program
, 2);
1004 /* Make a one member argv with all args concatenated
1005 together separated by a blank. */
1006 len
= XSTRING (program
)->size
+ 2;
1007 for (i
= 3; i
< nargs
; i
++)
1010 CHECK_STRING (tem
, i
);
1011 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1013 new_argv
= (unsigned char *) alloca (len
);
1014 strcpy (new_argv
, XSTRING (program
)->data
);
1015 for (i
= 3; i
< nargs
; i
++)
1018 CHECK_STRING (tem
, i
);
1019 strcat (new_argv
, " ");
1020 strcat (new_argv
, XSTRING (tem
)->data
);
1022 /* Need to add code here to check for program existence on VMS */
1025 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1027 /* If program file name is not absolute, search our path for it */
1028 if (XSTRING (program
)->data
[0] != '/')
1030 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1033 GCPRO4 (name
, program
, buffer
, current_dir
);
1034 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1037 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1038 new_argv
[0] = XSTRING (tem
)->data
;
1041 new_argv
[0] = XSTRING (program
)->data
;
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 #endif /* not VMS */
1052 proc
= make_process (name
);
1053 /* If an error occurs and we can't start the process, we want to
1054 remove it from the process list. This means that each error
1055 check in create_process doesn't need to call remove_process
1056 itself; it's all taken care of here. */
1057 record_unwind_protect (start_process_unwind
, proc
);
1059 XPROCESS (proc
)->childp
= Qt
;
1060 XPROCESS (proc
)->command_channel_p
= Qnil
;
1061 XPROCESS (proc
)->buffer
= buffer
;
1062 XPROCESS (proc
)->sentinel
= Qnil
;
1063 XPROCESS (proc
)->filter
= Qnil
;
1064 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1066 create_process (proc
, new_argv
, current_dir
);
1068 return unbind_to (count
, proc
);
1071 /* This function is the unwind_protect form for Fstart_process. If
1072 PROC doesn't have its pid set, then we know someone has signalled
1073 an error and the process wasn't started successfully, so we should
1074 remove it from the process list. */
1076 start_process_unwind (proc
)
1079 if (XTYPE (proc
) != Lisp_Process
)
1082 /* Was PROC started successfully? */
1083 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1084 remove_process (proc
);
1091 create_process_1 (signo
)
1095 /* USG systems forget handlers when they are used;
1096 must reestablish each time */
1097 signal (signo
, create_process_1
);
1101 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1104 /* Mimic blocking of signals on system V, which doesn't really have it. */
1106 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1107 int sigchld_deferred
;
1110 create_process_sigchld ()
1112 signal (SIGCHLD
, create_process_sigchld
);
1114 sigchld_deferred
= 1;
1120 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1121 create_process (process
, new_argv
, current_dir
)
1122 Lisp_Object process
;
1124 Lisp_Object current_dir
;
1126 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1129 SIGTYPE (*sigchld
)();
1132 extern char **environ
;
1134 inchannel
= outchannel
= -1;
1137 if (EQ (Vprocess_connection_type
, Qt
))
1138 outchannel
= inchannel
= allocate_pty ();
1143 /* On USG systems it does not work to open the pty's tty here
1144 and then close and reopen it in the child. */
1146 /* Don't let this terminal become our controlling terminal
1147 (in case we don't have one). */
1148 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1150 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1153 report_file_error ("Opening pty", Qnil
);
1155 forkin
= forkout
= -1;
1156 #endif /* not USG */
1160 #endif /* HAVE_PTYS */
1163 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1164 report_file_error ("Opening socketpair", Qnil
);
1165 outchannel
= inchannel
= sv
[0];
1166 forkout
= forkin
= sv
[1];
1168 #else /* not SKTPAIR */
1177 #endif /* not SKTPAIR */
1180 /* Replaced by close_process_descs */
1181 set_exclusive_use (inchannel
);
1182 set_exclusive_use (outchannel
);
1185 /* Stride people say it's a mystery why this is needed
1186 as well as the O_NDELAY, but that it fails without this. */
1187 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1190 ioctl (inchannel
, FIONBIO
, &one
);
1195 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1198 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1202 /* Record this as an active process, with its channels.
1203 As a result, child_setup will close Emacs's side of the pipes. */
1204 chan_process
[inchannel
] = process
;
1205 XSET (XPROCESS (process
)->infd
, Lisp_Int
, inchannel
);
1206 XSET (XPROCESS (process
)->outfd
, Lisp_Int
, outchannel
);
1207 /* Record the tty descriptor used in the subprocess. */
1209 XPROCESS (process
)->subtty
= Qnil
;
1211 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1212 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1213 XPROCESS (process
)->status
= Qrun
;
1215 /* Delay interrupts until we have a chance to store
1216 the new fork's pid in its process structure */
1220 #else /* not BSD4_1 */
1221 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1222 sigsetmask (sigmask (SIGCHLD
));
1223 #else /* ordinary USG */
1225 sigchld_deferred
= 0;
1226 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1228 #endif /* ordinary USG */
1229 #endif /* not BSD4_1 */
1230 #endif /* SIGCHLD */
1232 /* Until we store the proper pid, enable sigchld_handler
1233 to recognize an unknown pid as standing for this process.
1234 It is very important not to let this `marker' value stay
1235 in the table after this function has returned; if it does
1236 it might cause call-process to hang and subsequent asynchronous
1237 processes to get their return values scrambled. */
1238 XSETINT (XPROCESS (process
)->pid
, -1);
1241 /* child_setup must clobber environ on systems with true vfork.
1242 Protect it from permanent change. */
1243 char **save_environ
= environ
;
1248 int xforkin
= forkin
;
1249 int xforkout
= forkout
;
1251 #if 0 /* This was probably a mistake--it duplicates code later on,
1252 but fails to handle all the cases. */
1253 /* Make sure SIGCHLD is not blocked in the child. */
1254 sigsetmask (SIGEMPTYMASK
);
1257 /* Make the pty be the controlling terminal of the process. */
1259 /* First, disconnect its current controlling terminal. */
1263 /* Make the pty's terminal the controlling terminal. */
1265 /* We ignore the return value
1266 because faith@cs.unc.edu says that is necessary on Linux. */
1267 ioctl (xforkin
, TIOCSCTTY
, 0);
1269 #else /* not HAVE_SETSID */
1271 /* It's very important to call setpgrp here and no time
1272 afterwards. Otherwise, we lose our controlling tty which
1273 is set when we open the pty. */
1276 #endif /* not HAVE_SETSID */
1278 if (pty_flag
&& xforkin
>= 0)
1280 /* Use new line discipline. */
1281 int ldisc
= NTTYDISC
;
1282 if (ioctl (xforkin
, TIOCSETD
, &ldisc
) < 0)
1283 write (1, "create_process/TIOCSETD failed\n", 31);
1287 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1288 can do TIOCSPGRP only to the process's controlling tty. */
1291 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1292 I can't test it since I don't have 4.3. */
1293 int j
= open ("/dev/tty", O_RDWR
, 0);
1294 ioctl (j
, TIOCNOTTY
, 0);
1297 /* In order to get a controlling terminal on some versions
1298 of BSD, it is necessary to put the process in pgrp 0
1299 before it opens the terminal. */
1303 #endif /* TIOCNOTTY */
1305 #if !defined (RTU) && !defined (UNIPLUS)
1306 /*** There is a suggestion that this ought to be a
1307 conditional on TIOCSPGRP. */
1308 /* Now close the pty (if we had it open) and reopen it.
1309 This makes the pty the controlling terminal of the subprocess. */
1312 #ifdef SET_CHILD_PTY_PGRP
1313 int pgrp
= getpid ();
1316 /* I wonder if close (open (pty_name, ...)) would work? */
1319 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1321 #ifdef SET_CHILD_PTY_PGRP
1322 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1323 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1329 #endif /* not UNIPLUS and not RTU */
1330 #ifdef SETUP_SLAVE_PTY
1332 #endif /* SETUP_SLAVE_PTY */
1334 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1335 Now reenable it in the child, so it will die when we want it to. */
1337 signal (SIGHUP
, SIG_DFL
);
1339 #endif /* HAVE_PTYS */
1344 #else /* not BSD4_1 */
1345 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1346 sigsetmask (SIGEMPTYMASK
);
1347 #else /* ordinary USG */
1349 signal (SIGCHLD
, sigchld
);
1351 #endif /* ordinary USG */
1352 #endif /* not BSD4_1 */
1353 #endif /* SIGCHLD */
1355 child_setup_tty (xforkout
);
1356 child_setup (xforkin
, xforkout
, xforkout
,
1357 new_argv
, 1, current_dir
);
1359 environ
= save_environ
;
1363 report_file_error ("Doing vfork", Qnil
);
1365 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1367 FD_SET (inchannel
, &input_wait_mask
);
1369 /* If the subfork execv fails, and it exits,
1370 this close hangs. I don't know why.
1371 So have an interrupt jar it loose. */
1373 signal (SIGALRM
, create_process_1
);
1375 XPROCESS (process
)->subtty
= Qnil
;
1380 if (forkin
!= forkout
&& forkout
>= 0)
1386 #else /* not BSD4_1 */
1387 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1388 sigsetmask (SIGEMPTYMASK
);
1389 #else /* ordinary USG */
1391 signal (SIGCHLD
, sigchld
);
1392 /* Now really handle any of these signals
1393 that came in during this function. */
1394 if (sigchld_deferred
)
1395 kill (getpid (), SIGCHLD
);
1397 #endif /* ordinary USG */
1398 #endif /* not BSD4_1 */
1399 #endif /* SIGCHLD */
1401 #endif /* not VMS */
1405 /* open a TCP network connection to a given HOST/SERVICE. Treated
1406 exactly like a normal process when reading and writing. Only
1407 differences are in status display and process deletion. A network
1408 connection has no PID; you cannot signal it. All you can do is
1409 deactivate and close it via delete-process */
1411 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1413 "Open a TCP connection for a service to a host.\n\
1414 Returns a subprocess-object to represent the connection.\n\
1415 Input and output work as for subprocesses; `delete-process' closes it.\n\
1416 Args are NAME BUFFER HOST SERVICE.\n\
1417 NAME is name for process. It is modified if necessary to make it unique.\n\
1418 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1419 Process output goes at end of that buffer, unless you specify\n\
1420 an output stream or filter function to handle the output.\n\
1421 BUFFER may be also nil, meaning that this process is not associated\n\
1423 Third arg is name of the host to connect to, or its IP address.\n\
1424 Fourth arg SERVICE is name of the service desired, or an integer\n\
1425 specifying a port number to connect to.")
1426 (name
, buffer
, host
, service
)
1427 Lisp_Object name
, buffer
, host
, service
;
1431 struct sockaddr_in address
;
1432 struct servent
*svc_info
;
1433 struct hostent
*host_info_ptr
, host_info
;
1434 char *(addr_list
[2]);
1435 IN_ADDR numeric_addr
;
1439 struct hostent host_info_fixed
;
1440 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1442 GCPRO4 (name
, buffer
, host
, service
);
1443 CHECK_STRING (name
, 0);
1444 CHECK_STRING (host
, 0);
1445 if (XTYPE(service
) == Lisp_Int
)
1446 port
= htons ((unsigned short) XINT (service
));
1449 CHECK_STRING (service
, 0);
1450 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1452 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1453 port
= svc_info
->s_port
;
1457 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1458 if (host_info_ptr
== 0)
1459 /* Attempt to interpret host as numeric inet address */
1461 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1462 if (NUMERIC_ADDR_ERROR
)
1463 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1465 host_info_ptr
= &host_info
;
1466 host_info
.h_name
= 0;
1467 host_info
.h_aliases
= 0;
1468 host_info
.h_addrtype
= AF_INET
;
1470 /* Older machines have only one address slot called h_addr.
1471 Newer machines have h_addr_list, but #define h_addr to
1472 be its first element. */
1473 host_info
.h_addr_list
= &(addr_list
[0]);
1475 host_info
.h_addr
= (char*)(&numeric_addr
);
1477 host_info
.h_length
= strlen (addr_list
[0]);
1480 bzero (&address
, sizeof address
);
1481 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1482 host_info_ptr
->h_length
);
1483 address
.sin_family
= host_info_ptr
->h_addrtype
;
1484 address
.sin_port
= port
;
1486 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1488 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1490 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1491 when connect is interrupted. So let's not let it get interrupted.
1492 Note we do not turn off polling, because polling is only used
1493 when not interrupt_input, and thus not normally used on the systems
1494 which have this bug. On systems which use polling, there's no way
1495 to quit if polling is turned off. */
1496 if (interrupt_input
)
1500 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1507 if (interrupt_input
)
1511 report_file_error ("connection failed",
1512 Fcons (host
, Fcons (name
, Qnil
)));
1515 if (interrupt_input
)
1519 s
= connect_server (0);
1521 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1522 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1523 send_command (s
, C_DUMB
, 1, 0);
1529 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1532 buffer
= Fget_buffer_create (buffer
);
1533 proc
= make_process (name
);
1535 chan_process
[inch
] = proc
;
1538 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1541 fcntl (inch
, F_SETFL
, O_NDELAY
);
1545 XPROCESS (proc
)->childp
= host
;
1546 XPROCESS (proc
)->command_channel_p
= Qnil
;
1547 XPROCESS (proc
)->buffer
= buffer
;
1548 XPROCESS (proc
)->sentinel
= Qnil
;
1549 XPROCESS (proc
)->filter
= Qnil
;
1550 XPROCESS (proc
)->command
= Qnil
;
1551 XPROCESS (proc
)->pid
= Qnil
;
1552 XSET (XPROCESS (proc
)->infd
, Lisp_Int
, s
);
1553 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, outch
);
1554 XPROCESS (proc
)->status
= Qrun
;
1555 FD_SET (inch
, &input_wait_mask
);
1560 #endif /* HAVE_SOCKETS */
1562 deactivate_process (proc
)
1565 register int inchannel
, outchannel
;
1566 register struct Lisp_Process
*p
= XPROCESS (proc
);
1568 inchannel
= XINT (p
->infd
);
1569 outchannel
= XINT (p
->outfd
);
1573 /* Beware SIGCHLD hereabouts. */
1574 flush_pending_output (inchannel
);
1577 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1578 sys$
dassgn (outchannel
);
1579 vs
= get_vms_process_pointer (p
->pid
);
1581 give_back_vms_process_stuff (vs
);
1585 if (outchannel
>= 0 && outchannel
!= inchannel
)
1589 XSET (p
->infd
, Lisp_Int
, -1);
1590 XSET (p
->outfd
, Lisp_Int
, -1);
1591 chan_process
[inchannel
] = Qnil
;
1592 FD_CLR (inchannel
, &input_wait_mask
);
1596 /* Close all descriptors currently in use for communication
1597 with subprocess. This is used in a newly-forked subprocess
1598 to get rid of irrelevant descriptors. */
1600 close_process_descs ()
1603 for (i
= 0; i
< MAXDESC
; i
++)
1605 Lisp_Object process
;
1606 process
= chan_process
[i
];
1607 if (!NILP (process
))
1609 int in
= XINT (XPROCESS (process
)->infd
);
1610 int out
= XINT (XPROCESS (process
)->outfd
);
1613 if (out
>= 0 && in
!= out
)
1619 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1621 "Allow any pending output from subprocesses to be read by Emacs.\n\
1622 It is read into the process' buffers or given to their filter functions.\n\
1623 Non-nil arg PROCESS means do not return until some output has been received\n\
1625 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1626 seconds and microseconds to wait; return after that much time whether\n\
1627 or not there is input.\n\
1628 Return non-nil iff we received any output before the timeout expired.")
1629 (proc
, timeout
, timeout_msecs
)
1630 register Lisp_Object proc
, timeout
, timeout_msecs
;
1635 if (! NILP (timeout_msecs
))
1637 CHECK_NUMBER (timeout_msecs
, 2);
1638 useconds
= XINT (timeout_msecs
);
1639 if (XTYPE (timeout
) != Lisp_Int
)
1640 XSET (timeout
, Lisp_Int
, 0);
1643 int carry
= useconds
/ 1000000;
1645 XSETINT (timeout
, XINT (timeout
) + carry
);
1646 useconds
-= carry
* 1000000;
1648 /* I think this clause is necessary because C doesn't
1649 guarantee a particular rounding direction for negative
1653 XSETINT (timeout
, XINT (timeout
) - 1);
1654 useconds
+= 1000000;
1661 if (! NILP (timeout
))
1663 CHECK_NUMBER (timeout
, 1);
1664 seconds
= XINT (timeout
);
1677 XFASTINT (proc
) = 0;
1680 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1684 /* This variable is different from waiting_for_input in keyboard.c.
1685 It is used to communicate to a lisp process-filter/sentinel (via the
1686 function Fwaiting_for_user_input_p below) whether emacs was waiting
1687 for user-input when that process-filter was called.
1688 waiting_for_input cannot be used as that is by definition 0 when
1689 lisp code is being evalled */
1690 static int waiting_for_user_input_p
;
1692 /* Read and dispose of subprocess output while waiting for timeout to
1693 elapse and/or keyboard input to be available.
1696 timeout in seconds, or
1697 zero for no limit, or
1698 -1 means gobble data immediately available but don't wait for any.
1701 an additional duration to wait, measured in microseconds.
1702 If this is nonzero and time_limit is 0, then the timeout
1703 consists of MICROSECS only.
1705 READ_KBD is a lisp value:
1706 0 to ignore keyboard input, or
1707 1 to return when input is available, or
1708 -1 meaning caller will actually read the input, so don't throw to
1709 the quit handler, or
1710 a cons cell, meaning wait until its car is non-nil
1711 (and gobble terminal input into the buffer if any arrives), or
1712 a process object, meaning wait until something arrives from that
1713 process. The return value is true iff we read some input from
1716 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1717 output that arrives.
1719 If READ_KBD is a pointer to a struct Lisp_Process, then the
1720 function returns true iff we received input from that process
1721 before the timeout elapsed.
1722 Otherwise, return true iff we received input from any process. */
1724 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1725 int time_limit
, microsecs
;
1726 Lisp_Object read_kbd
;
1729 register int channel
, nfds
, m
;
1730 static SELECT_TYPE Available
;
1733 EMACS_TIME timeout
, end_time
, garbage
;
1735 int wait_channel
= -1;
1736 struct Lisp_Process
*wait_proc
= 0;
1737 int got_some_input
= 0;
1738 Lisp_Object
*wait_for_cell
= 0;
1740 FD_ZERO (&Available
);
1742 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1744 if (XTYPE (read_kbd
) == Lisp_Process
)
1746 wait_proc
= XPROCESS (read_kbd
);
1747 wait_channel
= XINT (wait_proc
->infd
);
1748 XFASTINT (read_kbd
) = 0;
1751 /* If waiting for non-nil in a cell, record where. */
1752 if (XTYPE (read_kbd
) == Lisp_Cons
)
1754 wait_for_cell
= &XCONS (read_kbd
)->car
;
1755 XFASTINT (read_kbd
) = 0;
1758 waiting_for_user_input_p
= XINT (read_kbd
);
1760 /* Since we may need to wait several times,
1761 compute the absolute time to return at. */
1762 if (time_limit
|| microsecs
)
1764 EMACS_GET_TIME (end_time
);
1765 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1766 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1769 /* It would not be safe to call this below,
1770 where we call redisplay_preserve_echo_area. */
1771 prepare_menu_bars ();
1775 /* If calling from keyboard input, do not quit
1776 since we want to return C-g as an input character.
1777 Otherwise, do pending quit if requested. */
1778 if (XINT (read_kbd
) >= 0)
1781 /* Exit now if the cell we're waiting for became non-nil. */
1782 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1785 /* Compute time from now till when time limit is up */
1786 /* Exit if already run out */
1787 if (time_limit
== -1)
1789 /* -1 specified for timeout means
1790 gobble output available now
1791 but don't wait at all. */
1793 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1795 else if (time_limit
|| microsecs
)
1797 EMACS_GET_TIME (timeout
);
1798 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1799 if (EMACS_TIME_NEG_P (timeout
))
1804 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1807 /* Cause C-g and alarm signals to take immediate action,
1808 and cause input available signals to zero out timeout.
1810 It is important that we do this before checking for process
1811 activity. If we get a SIGCHLD after the explicit checks for
1812 process activity, timeout is the only way we will know. */
1813 if (XINT (read_kbd
) < 0)
1814 set_waiting_for_input (&timeout
);
1816 /* If status of something has changed, and no input is
1817 available, notify the user of the change right away. After
1818 this explicit check, we'll let the SIGCHLD handler zap
1819 timeout to get our attention. */
1820 if (update_tick
!= process_tick
&& do_display
)
1822 Atemp
= input_wait_mask
;
1823 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1824 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1826 /* It's okay for us to do this and then continue with
1827 the loop, since timeout has already been zeroed out. */
1828 clear_waiting_for_input ();
1833 /* Don't wait for output from a non-running process. */
1834 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1835 update_status (wait_proc
);
1837 && ! EQ (wait_proc
->status
, Qrun
))
1839 clear_waiting_for_input ();
1843 /* Wait till there is something to do */
1845 Available
= input_wait_mask
;
1846 /* We used to have && wait_for_cell == 0
1847 but that led to lossage handling selection_request events:
1848 within one, we would start to handle another. */
1849 if (! XINT (read_kbd
))
1850 FD_CLR (keyboard_descriptor
, &Available
);
1852 /* If frame size has changed or the window is newly mapped,
1853 redisplay now, before we start to wait. There is a race
1854 condition here; if a SIGIO arrives between now and the select
1855 and indicates that a frame is trashed, the select may block
1856 displaying a trashed screen. */
1857 if (frame_garbaged
&& do_display
)
1858 redisplay_preserve_echo_area ();
1860 if (XINT (read_kbd
) && detect_input_pending ())
1863 FD_ZERO (&Available
);
1866 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1870 /* Make C-g and alarm signals set flags again */
1871 clear_waiting_for_input ();
1873 /* If we woke up due to SIGWINCH, actually change size now. */
1874 do_pending_window_change ();
1876 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1880 if (xerrno
== EINTR
)
1881 FD_ZERO (&Available
);
1883 /* Ultrix select seems to return ENOMEM when it is
1884 interrupted. Treat it just like EINTR. Bleah. Note
1885 that we want to test for the "ultrix" CPP symbol, not
1886 "__ultrix__"; the latter is only defined under GCC, but
1887 not by DEC's bundled CC. -JimB */
1888 else if (xerrno
== ENOMEM
)
1889 FD_ZERO (&Available
);
1892 /* This happens for no known reason on ALLIANT.
1893 I am guessing that this is the right response. -- RMS. */
1894 else if (xerrno
== EFAULT
)
1895 FD_ZERO (&Available
);
1897 else if (xerrno
== EBADF
)
1900 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1901 the child's closure of the pts gives the parent a SIGHUP, and
1902 the ptc file descriptor is automatically closed,
1903 yielding EBADF here or at select() call above.
1904 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1905 in m/ibmrt-aix.h), and here we just ignore the select error.
1906 Cleanup occurs c/o status_notify after SIGCLD. */
1907 FD_ZERO (&Available
); /* Cannot depend on values returned */
1913 error("select error: %s", strerror (xerrno
));
1915 #if defined(sun) && !defined(USG5_4)
1916 else if (nfds
> 0 && FD_ISSET (keyboard_descriptor
, &Available
)
1918 /* System sometimes fails to deliver SIGIO.
1920 David J. Mackenzie says that Emacs doesn't compile under
1921 Solaris if this code is enabled, thus the USG5_4 in the CPP
1922 conditional. "I haven't noticed any ill effects so far.
1923 If you find a Solaris expert somewhere, they might know
1925 kill (getpid (), SIGIO
);
1928 /* Check for keyboard input */
1929 /* If there is any, return immediately
1930 to give it higher priority than subprocesses */
1932 /* We used to do this if wait_for_cell,
1933 but that caused infinite recursion in selection request events. */
1934 if ((XINT (read_kbd
))
1935 && detect_input_pending ())
1938 if (detect_input_pending ())
1942 /* Exit now if the cell we're waiting for became non-nil. */
1943 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1947 /* If we think we have keyboard input waiting, but didn't get SIGIO
1948 go read it. This can happen with X on BSD after logging out.
1949 In that case, there really is no input and no SIGIO,
1950 but select says there is input. */
1952 if (XINT (read_kbd
) && interrupt_input
1953 && (FD_ISSET (keyboard_descriptor
, &Available
)))
1958 got_some_input
|= nfds
> 0;
1960 /* If checking input just got us a size-change event from X,
1961 obey it now if we should. */
1962 if (XINT (read_kbd
) || wait_for_cell
)
1963 do_pending_window_change ();
1965 /* Check for data from a process. */
1966 /* Really FIRST_PROC_DESC should be 0 on Unix,
1967 but this is safer in the short run. */
1968 for (channel
= keyboard_descriptor
== 0 ? FIRST_PROC_DESC
: 0;
1969 channel
< MAXDESC
; channel
++)
1971 if (FD_ISSET (channel
, &Available
))
1975 /* If waiting for this channel, arrange to return as
1976 soon as no more input to be processed. No more
1978 if (wait_channel
== channel
)
1984 proc
= chan_process
[channel
];
1988 /* Read data from the process, starting with our
1989 buffered-ahead character if we have one. */
1991 nread
= read_process_output (proc
, channel
);
1994 /* Since read_process_output can run a filter,
1995 which can call accept-process-output,
1996 don't try to read from any other processes
1997 before doing the select again. */
1998 FD_ZERO (&Available
);
2001 redisplay_preserve_echo_area ();
2004 else if (nread
== -1 && errno
== EWOULDBLOCK
)
2008 else if (nread
== -1 && errno
== EAGAIN
)
2012 else if (nread
== -1 && errno
== EAGAIN
)
2014 /* Note that we cannot distinguish between no input
2015 available now and a closed pipe.
2016 With luck, a closed pipe will be accompanied by
2017 subprocess termination and SIGCHLD. */
2018 else if (nread
== 0 && !NETCONN_P (proc
))
2020 #endif /* O_NDELAY */
2021 #endif /* O_NONBLOCK */
2022 #endif /* EWOULDBLOCK */
2024 /* On some OSs with ptys, when the process on one end of
2025 a pty exits, the other end gets an error reading with
2026 errno = EIO instead of getting an EOF (0 bytes read).
2027 Therefore, if we get an error reading and errno =
2028 EIO, just continue, because the child process has
2029 exited and should clean itself up soon (e.g. when we
2031 else if (nread
== -1 && errno
== EIO
)
2033 #endif /* HAVE_PTYS */
2034 /* If we can detect process termination, don't consider the process
2035 gone just because its pipe is closed. */
2037 else if (nread
== 0 && !NETCONN_P (proc
))
2042 /* Preserve status of processes already terminated. */
2043 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2044 deactivate_process (proc
);
2045 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2046 update_status (XPROCESS (proc
));
2047 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2048 XPROCESS (proc
)->status
2049 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2052 } /* end for each file descriptor */
2053 } /* end while exit conditions not met */
2055 /* If calling from keyboard input, do not quit
2056 since we want to return C-g as an input character.
2057 Otherwise, do pending quit if requested. */
2058 if (XINT (read_kbd
) >= 0)
2060 /* Prevent input_pending from remaining set if we quit. */
2061 clear_input_pending ();
2065 return got_some_input
;
2068 /* Read pending output from the process channel,
2069 starting with our buffered-ahead character if we have one.
2070 Yield number of characters read.
2072 This function reads at most 1024 characters.
2073 If you want to read all available subprocess output,
2074 you must call it repeatedly until it returns zero. */
2076 read_process_output (proc
, channel
)
2078 register int channel
;
2080 register int nchars
;
2086 register Lisp_Object outstream
;
2087 register struct buffer
*old
= current_buffer
;
2088 register struct Lisp_Process
*p
= XPROCESS (proc
);
2089 register int opoint
;
2092 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2094 vs
= get_vms_process_pointer (p
->pid
);
2098 return(0); /* Really weird if it does this */
2099 if (!(vs
->iosb
[0] & 1))
2100 return -1; /* I/O error */
2103 error ("Could not get VMS process pointer");
2104 chars
= vs
->inputBuffer
;
2105 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2108 start_vms_process_read (vs
); /* Crank up the next read on the process */
2109 return 1; /* Nothing worth printing, say we got 1 */
2113 if (proc_buffered_char
[channel
] < 0)
2114 nchars
= read (channel
, chars
, sizeof chars
);
2117 chars
[0] = proc_buffered_char
[channel
];
2118 proc_buffered_char
[channel
] = -1;
2119 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2123 nchars
= nchars
+ 1;
2125 #endif /* not VMS */
2127 if (nchars
<= 0) return nchars
;
2129 outstream
= p
->filter
;
2130 if (!NILP (outstream
))
2132 /* We inhibit quit here instead of just catching it so that
2133 hitting ^G when a filter happens to be running won't screw
2135 int count
= specpdl_ptr
- specpdl
;
2136 Lisp_Object odeactivate
;
2137 Lisp_Object obuffer
;
2139 odeactivate
= Vdeactivate_mark
;
2140 obuffer
= Fcurrent_buffer ();
2142 specbind (Qinhibit_quit
, Qt
);
2143 call2 (outstream
, proc
, make_string (chars
, nchars
));
2145 /* Handling the process output should not deactivate the mark. */
2146 Vdeactivate_mark
= odeactivate
;
2148 if (! EQ (Fcurrent_buffer (), obuffer
))
2149 record_asynch_buffer_change ();
2152 start_vms_process_read (vs
);
2154 unbind_to (count
, Qnil
);
2158 /* If no filter, write into buffer if it isn't dead. */
2159 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2161 Lisp_Object old_read_only
;
2162 Lisp_Object old_begv
, old_zv
;
2163 Lisp_Object odeactivate
;
2165 odeactivate
= Vdeactivate_mark
;
2167 Fset_buffer (p
->buffer
);
2169 old_read_only
= current_buffer
->read_only
;
2170 XFASTINT (old_begv
) = BEGV
;
2171 XFASTINT (old_zv
) = ZV
;
2173 current_buffer
->read_only
= Qnil
;
2175 /* Insert new output into buffer
2176 at the current end-of-output marker,
2177 thus preserving logical ordering of input and output. */
2178 if (XMARKER (p
->mark
)->buffer
)
2179 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2183 /* If the output marker is outside of the visible region, save
2184 the restriction and widen. */
2185 if (! (BEGV
<= point
&& point
<= ZV
))
2188 /* Make sure opoint floats ahead of any new text, just as point
2190 if (point
<= opoint
)
2193 /* Insert after old_begv, but before old_zv. */
2194 if (point
< XFASTINT (old_begv
))
2195 XFASTINT (old_begv
) += nchars
;
2196 if (point
<= XFASTINT (old_zv
))
2197 XFASTINT (old_zv
) += nchars
;
2199 /* Insert before markers in case we are inserting where
2200 the buffer's mark is, and the user's next command is Meta-y. */
2201 insert_before_markers (chars
, nchars
);
2202 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2204 update_mode_lines
++;
2206 /* If the restriction isn't what it should be, set it. */
2207 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2208 Fnarrow_to_region (old_begv
, old_zv
);
2210 /* Handling the process output should not deactivate the mark. */
2211 Vdeactivate_mark
= odeactivate
;
2213 current_buffer
->read_only
= old_read_only
;
2215 set_buffer_internal (old
);
2218 start_vms_process_read (vs
);
2223 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2225 "Returns non-NIL if emacs is waiting for input from the user.\n\
2226 This is intended for use by asynchronous process output filters and sentinels.")
2229 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2232 /* Sending data to subprocess */
2234 jmp_buf send_process_frame
;
2237 send_process_trap ()
2243 longjmp (send_process_frame
, 1);
2246 send_process (proc
, buf
, len
)
2251 /* Don't use register vars; longjmp can lose them. */
2253 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2257 struct Lisp_Process
*p
= XPROCESS (proc
);
2258 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2261 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2262 update_status (XPROCESS (proc
));
2263 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2264 error ("Process %s not running", procname
);
2267 vs
= get_vms_process_pointer (p
->pid
);
2269 error ("Could not find this process: %x", p
->pid
);
2270 else if (write_to_vms_process (vs
, buf
, len
))
2273 if (!setjmp (send_process_frame
))
2277 SIGTYPE (*old_sigpipe
)();
2280 if (pty_max_bytes
== 0)
2282 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2283 pty_max_bytes
= fpathconf (XFASTINT (XPROCESS (proc
)->outfd
),
2286 pty_max_bytes
= 250;
2290 /* Don't send more than pty_max_bytes bytes at a time. */
2291 /* Subtract 1 to leave room for the EOF. */
2292 if (this >= pty_max_bytes
&& XPROCESS (proc
)->pty_flag
!= 0)
2293 this = pty_max_bytes
- 1;
2295 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2296 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
2298 /* If we sent just part of the string, put in an EOF
2299 to force it through, before we send the rest. */
2301 Fprocess_send_eof (proc
);
2303 signal (SIGPIPE
, old_sigpipe
);
2308 || errno
== EWOULDBLOCK
2315 /* It would be nice to accept process output here,
2316 but that is difficult. For example, it could
2317 garbage what we are sending if that is from a buffer. */
2324 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2328 /* Allow input from processes between bursts of sending.
2329 Otherwise things may get stopped up. */
2334 XFASTINT (zero
) = 0;
2335 wait_reading_process_input (-1, 0, zero
, 0);
2341 XPROCESS (proc
)->raw_status_low
= Qnil
;
2342 XPROCESS (proc
)->raw_status_high
= Qnil
;
2343 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2344 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2345 deactivate_process (proc
);
2347 error ("Error writing to process %s; closed it", procname
);
2349 error ("SIGPIPE raised on process %s; closed it", procname
);
2354 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2356 "Send current contents of region as input to PROCESS.\n\
2357 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2358 nil, indicating the current buffer's process.\n\
2359 Called from program, takes three arguments, PROCESS, START and END.\n\
2360 If the region is more than 500 characters long,\n\
2361 it is sent in several bunches. This may happen even for shorter regions.\n\
2362 Output from processes can arrive in between bunches.")
2363 (process
, start
, end
)
2364 Lisp_Object process
, start
, end
;
2369 proc
= get_process (process
);
2370 validate_region (&start
, &end
);
2372 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2375 start1
= XINT (start
);
2376 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2381 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2383 "Send PROCESS the contents of STRING as input.\n\
2384 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2385 nil, indicating the current buffer's process.\n\
2386 If STRING is more than 500 characters long,\n\
2387 it is sent in several bunches. This may happen even for shorter strings.\n\
2388 Output from processes can arrive in between bunches.")
2390 Lisp_Object process
, string
;
2393 CHECK_STRING (string
, 1);
2394 proc
= get_process (process
);
2395 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2399 /* send a signal number SIGNO to PROCESS.
2400 CURRENT_GROUP means send to the process group that currently owns
2401 the terminal being used to communicate with PROCESS.
2402 This is used for various commands in shell mode.
2403 If NOMSG is zero, insert signal-announcements into process's buffers
2406 If we can, we try to signal PROCESS by sending control characters
2407 down the pipe. This allows us to signal inferiors who have changed
2408 their uid, for which killpg would return an EPERM error. */
2411 process_send_signal (process
, signo
, current_group
, nomsg
)
2412 Lisp_Object process
;
2414 Lisp_Object current_group
;
2418 register struct Lisp_Process
*p
;
2422 proc
= get_process (process
);
2423 p
= XPROCESS (proc
);
2425 if (!EQ (p
->childp
, Qt
))
2426 error ("Process %s is not a subprocess",
2427 XSTRING (p
->name
)->data
);
2428 if (XINT (p
->infd
) < 0)
2429 error ("Process %s is not active",
2430 XSTRING (p
->name
)->data
);
2432 if (NILP (p
->pty_flag
))
2433 current_group
= Qnil
;
2435 /* If we are using pgrps, get a pgrp number and make it negative. */
2436 if (!NILP (current_group
))
2438 #ifdef SIGNALS_VIA_CHARACTERS
2439 /* If possible, send signals to the entire pgrp
2440 by sending an input character to it. */
2442 /* TERMIOS is the latest and bestest, and seems most likely to
2443 work. If the system has it, use it. */
2450 tcgetattr (XINT (p
->infd
), &t
);
2451 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2455 tcgetattr (XINT (p
->infd
), &t
);
2456 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2460 tcgetattr (XINT (p
->infd
), &t
);
2461 #if defined (VSWTCH) && !defined (IRIX5)
2462 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2464 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2469 #else /* ! HAVE_TERMIOS */
2471 /* On Berkeley descendants, the following IOCTL's retrieve the
2472 current control characters. */
2473 #if defined (TIOCGLTC) && defined (TIOCGETC)
2481 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2482 send_process (proc
, &c
.t_intrc
, 1);
2485 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2486 send_process (proc
, &c
.t_quitc
, 1);
2490 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
2491 send_process (proc
, &lc
.t_suspc
, 1);
2493 #endif /* ! defined (SIGTSTP) */
2496 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2498 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2505 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2506 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2509 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2510 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2514 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2515 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2517 #endif /* ! defined (SIGTSTP) */
2519 #else /* ! defined (TCGETA) */
2520 Your configuration files are messed up
.
2521 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2522 you'd better be using one of the alternatives above! */
2523 #endif /* ! defined (TCGETA) */
2524 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2525 #endif /* ! defined HAVE_TERMIOS */
2526 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2529 /* Get the pgrp using the tty itself, if we have that.
2530 Otherwise, use the pty to get the pgrp.
2531 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2532 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2533 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2534 His patch indicates that if TIOCGPGRP returns an error, then
2535 we should just assume that p->pid is also the process group id. */
2539 if (!NILP (p
->subtty
))
2540 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2542 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
2546 gid
= - XFASTINT (p
->pid
);
2547 #endif /* ! defined (pfa) */
2553 #else /* ! defined (TIOCGPGRP ) */
2554 /* Can't select pgrps on this system, so we know that
2555 the child itself heads the pgrp. */
2556 gid
= - XFASTINT (p
->pid
);
2557 #endif /* ! defined (TIOCGPGRP ) */
2560 gid
= - XFASTINT (p
->pid
);
2566 p
->raw_status_low
= Qnil
;
2567 p
->raw_status_high
= Qnil
;
2569 XSETINT (p
->tick
, ++process_tick
);
2573 #endif /* ! defined (SIGCONT) */
2576 send_process (proc
, "\003", 1); /* ^C */
2581 send_process (proc
, "\031", 1); /* ^Y */
2586 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2589 flush_pending_output (XINT (p
->infd
));
2593 /* If we don't have process groups, send the signal to the immediate
2594 subprocess. That isn't really right, but it's better than any
2595 obvious alternative. */
2598 kill (XFASTINT (p
->pid
), signo
);
2602 /* gid may be a pid, or minus a pgrp's number */
2604 if (!NILP (current_group
))
2605 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
2608 gid
= - XFASTINT (p
->pid
);
2611 #else /* ! defined (TIOCSIGSEND) */
2612 EMACS_KILLPG (-gid
, signo
);
2613 #endif /* ! defined (TIOCSIGSEND) */
2616 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2617 "Interrupt process PROCESS. May be process or name of one.\n\
2618 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2619 Nil or no arg means current buffer's process.\n\
2620 Second arg CURRENT-GROUP non-nil means send signal to\n\
2621 the current process-group of the process's controlling terminal\n\
2622 rather than to the process's own process group.\n\
2623 If the process is a shell, this means interrupt current subjob\n\
2624 rather than the shell.")
2625 (process
, current_group
)
2626 Lisp_Object process
, current_group
;
2628 process_send_signal (process
, SIGINT
, current_group
, 0);
2632 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2633 "Kill process PROCESS. May be process or name of one.\n\
2634 See function `interrupt-process' for more details on usage.")
2635 (process
, current_group
)
2636 Lisp_Object process
, current_group
;
2638 process_send_signal (process
, SIGKILL
, current_group
, 0);
2642 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2643 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2644 See function `interrupt-process' for more details on usage.")
2645 (process
, current_group
)
2646 Lisp_Object process
, current_group
;
2648 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2652 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2653 "Stop process PROCESS. May be process or name of one.\n\
2654 See function `interrupt-process' for more details on usage.")
2655 (process
, current_group
)
2656 Lisp_Object process
, current_group
;
2659 error ("no SIGTSTP support");
2661 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2666 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2667 "Continue process PROCESS. May be process or name of one.\n\
2668 See function `interrupt-process' for more details on usage.")
2669 (process
, current_group
)
2670 Lisp_Object process
, current_group
;
2673 process_send_signal (process
, SIGCONT
, current_group
, 0);
2675 error ("no SIGCONT support");
2680 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2681 2, 2, "nProcess number: \nnSignal code: ",
2682 "Send the process with number PID the signal with code CODE.\n\
2683 Both PID and CODE are integers.")
2685 Lisp_Object pid
, sig
;
2687 CHECK_NUMBER (pid
, 0);
2688 CHECK_NUMBER (sig
, 1);
2689 return make_number (kill (XINT (pid
), XINT (sig
)));
2692 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2693 "Make PROCESS see end-of-file in its input.\n\
2694 Eof comes after any text already sent to it.\n\
2695 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2696 nil, indicating the current buffer's process.")
2698 Lisp_Object process
;
2702 proc
= get_process (process
);
2704 /* Make sure the process is really alive. */
2705 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2706 update_status (XPROCESS (proc
));
2707 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2708 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2710 /* Sending a zero-length record is supposed to mean eof
2711 when TIOCREMOTE is turned on. */
2715 write (XINT (XPROCESS (proc
)->outfd
), buf
, 0);
2717 #else /* did not do TOICREMOTE */
2719 send_process (proc
, "\032", 1); /* ^z */
2721 if (!NILP (XPROCESS (proc
)->pty_flag
))
2722 send_process (proc
, "\004", 1);
2725 close (XINT (XPROCESS (proc
)->outfd
));
2726 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, open (NULL_DEVICE
, O_WRONLY
));
2729 #endif /* did not do TOICREMOTE */
2733 /* Kill all processes associated with `buffer'.
2734 If `buffer' is nil, kill all processes */
2736 kill_buffer_processes (buffer
)
2739 Lisp_Object tail
, proc
;
2741 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2742 tail
= XCONS (tail
)->cdr
)
2744 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2745 if (XGCTYPE (proc
) == Lisp_Process
2746 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2748 if (NETCONN_P (proc
))
2749 deactivate_process (proc
);
2750 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
2751 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2756 /* On receipt of a signal that a child status has changed,
2757 loop asking about children with changed statuses until
2758 the system says there are no more.
2759 All we do is change the status;
2760 we do not run sentinels or print notifications.
2761 That is saved for the next time keyboard input is done,
2762 in order to avoid timing errors. */
2764 /** WARNING: this can be called during garbage collection.
2765 Therefore, it must not be fooled by the presence of mark bits in
2768 /** USG WARNING: Although it is not obvious from the documentation
2769 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2770 signal() before executing at least one wait(), otherwise the handler
2771 will be called again, resulting in an infinite loop. The relevant
2772 portion of the documentation reads "SIGCLD signals will be queued
2773 and the signal-catching function will be continually reentered until
2774 the queue is empty". Invoking signal() causes the kernel to reexamine
2775 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2778 sigchld_handler (signo
)
2781 int old_errno
= errno
;
2783 register struct Lisp_Process
*p
;
2784 extern EMACS_TIME
*input_available_clear_time
;
2788 sigheld
|= sigbit (SIGCHLD
);
2800 #endif /* no WUNTRACED */
2801 /* Keep trying to get a status until we get a definitive result. */
2805 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2807 while (pid
<= 0 && errno
== EINTR
);
2811 /* A real failure. We have done all our job, so return. */
2813 /* USG systems forget handlers when they are used;
2814 must reestablish each time */
2816 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2819 sigheld
&= ~sigbit (SIGCHLD
);
2827 #endif /* no WNOHANG */
2829 /* Find the process that signaled us, and record its status. */
2832 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2834 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2835 p
= XPROCESS (proc
);
2836 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2841 /* Look for an asynchronous process whose pid hasn't been filled
2844 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2846 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2847 p
= XPROCESS (proc
);
2848 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2853 /* Change the status of the process that was found. */
2856 union { int i
; WAITTYPE wt
; } u
;
2858 XSETINT (p
->tick
, ++process_tick
);
2860 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2861 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2863 /* If process has terminated, stop waiting for its output. */
2864 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2865 if (XINT (p
->infd
) >= 0)
2866 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
2868 /* Tell wait_reading_process_input that it needs to wake up and
2870 if (input_available_clear_time
)
2871 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2874 /* There was no asynchronous process found for that id. Check
2875 if we have a synchronous process. */
2878 synch_process_alive
= 0;
2880 /* Report the status of the synchronous process. */
2882 synch_process_retcode
= WRETCODE (w
);
2883 else if (WIFSIGNALED (w
))
2885 int code
= WTERMSIG (w
);
2891 signame
= sys_siglist
[code
];
2893 signame
= sys_errlist
[code
];
2897 signame
= "unknown";
2899 synch_process_death
= signame
;
2902 /* Tell wait_reading_process_input that it needs to wake up and
2904 if (input_available_clear_time
)
2905 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2908 /* On some systems, we must return right away.
2909 If any more processes want to signal us, we will
2911 Otherwise (on systems that have WNOHANG), loop around
2912 to use up all the processes that have something to tell us. */
2913 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2915 signal (signo
, sigchld_handler
);
2919 #endif /* USG, but not HPUX with WNOHANG */
2925 exec_sentinel_unwind (data
)
2928 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2933 exec_sentinel (proc
, reason
)
2934 Lisp_Object proc
, reason
;
2936 Lisp_Object sentinel
;
2937 register struct Lisp_Process
*p
= XPROCESS (proc
);
2938 int count
= specpdl_ptr
- specpdl
;
2940 sentinel
= p
->sentinel
;
2941 if (NILP (sentinel
))
2944 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2945 assure that it gets restored no matter how the sentinel exits. */
2947 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2948 /* Inhibit quit so that random quits don't screw up a running filter. */
2949 specbind (Qinhibit_quit
, Qt
);
2950 call2 (sentinel
, proc
, reason
);
2951 unbind_to (count
, Qnil
);
2954 /* Report all recent events of a change in process status
2955 (either run the sentinel or output a message).
2956 This is done while Emacs is waiting for keyboard input. */
2960 register Lisp_Object proc
, buffer
;
2961 Lisp_Object tail
, msg
;
2962 struct gcpro gcpro1
, gcpro2
;
2966 /* We need to gcpro tail; if read_process_output calls a filter
2967 which deletes a process and removes the cons to which tail points
2968 from Vprocess_alist, and then causes a GC, tail is an unprotected
2972 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2975 register struct Lisp_Process
*p
;
2977 proc
= Fcdr (Fcar (tail
));
2978 p
= XPROCESS (proc
);
2980 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2982 XSETINT (p
->update_tick
, XINT (p
->tick
));
2984 /* If process is still active, read any output that remains. */
2985 if (XINT (p
->infd
) >= 0)
2986 while (! EQ (p
->filter
, Qt
)
2987 && read_process_output (proc
, XINT (p
->infd
)) > 0);
2991 /* Get the text to use for the message. */
2992 if (!NILP (p
->raw_status_low
))
2994 msg
= status_message (p
->status
);
2996 /* If process is terminated, deactivate it or delete it. */
2998 if (XTYPE (p
->status
) == Lisp_Cons
)
2999 symbol
= XCONS (p
->status
)->car
;
3001 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
3002 || EQ (symbol
, Qclosed
))
3004 if (delete_exited_processes
)
3005 remove_process (proc
);
3007 deactivate_process (proc
);
3010 /* Now output the message suitably. */
3011 if (!NILP (p
->sentinel
))
3012 exec_sentinel (proc
, msg
);
3013 /* Don't bother with a message in the buffer
3014 when a process becomes runnable. */
3015 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
3017 Lisp_Object ro
, tem
;
3018 struct buffer
*old
= current_buffer
;
3021 ro
= XBUFFER (buffer
)->read_only
;
3023 /* Avoid error if buffer is deleted
3024 (probably that's why the process is dead, too) */
3025 if (NILP (XBUFFER (buffer
)->name
))
3027 Fset_buffer (buffer
);
3029 /* Insert new output into buffer
3030 at the current end-of-output marker,
3031 thus preserving logical ordering of input and output. */
3032 if (XMARKER (p
->mark
)->buffer
)
3033 SET_PT (marker_position (p
->mark
));
3036 if (point
<= opoint
)
3037 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
3039 tem
= current_buffer
->read_only
;
3040 current_buffer
->read_only
= Qnil
;
3041 insert_string ("\nProcess ");
3042 Finsert (1, &p
->name
);
3043 insert_string (" ");
3045 current_buffer
->read_only
= tem
;
3046 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
3049 set_buffer_internal (old
);
3054 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
3055 redisplay_preserve_echo_area ();
3057 update_tick
= process_tick
;
3068 if (! noninteractive
|| initialized
)
3070 signal (SIGCHLD
, sigchld_handler
);
3073 FD_ZERO (&input_wait_mask
);
3075 keyboard_descriptor
= 0;
3076 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3078 Vprocess_alist
= Qnil
;
3079 for (i
= 0; i
< MAXDESC
; i
++)
3081 chan_process
[i
] = Qnil
;
3082 proc_buffered_char
[i
] = -1;
3086 /* From now on, assume keyboard input comes from descriptor DESC. */
3089 change_keyboard_wait_descriptor (desc
)
3092 FD_CLR (keyboard_descriptor
, &input_wait_mask
);
3093 keyboard_descriptor
= desc
;
3094 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3100 stream_process
= intern ("stream");
3102 Qprocessp
= intern ("processp");
3103 staticpro (&Qprocessp
);
3104 Qrun
= intern ("run");
3106 Qstop
= intern ("stop");
3108 Qsignal
= intern ("signal");
3109 staticpro (&Qsignal
);
3111 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3114 Qexit = intern ("exit");
3115 staticpro (&Qexit); */
3117 Qopen
= intern ("open");
3119 Qclosed
= intern ("closed");
3120 staticpro (&Qclosed
);
3122 staticpro (&Vprocess_alist
);
3124 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3125 "*Non-nil means delete processes immediately when they exit.\n\
3126 nil means don't delete them until `list-processes' is run.");
3128 delete_exited_processes
= 1;
3130 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3131 "Control type of device used to communicate with subprocesses.\n\
3132 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3133 pty's are not available, this variable will be ignored. The value takes\n\
3134 effect when `start-process' is called.");
3135 Vprocess_connection_type
= Qt
;
3137 defsubr (&Sprocessp
);
3138 defsubr (&Sget_process
);
3139 defsubr (&Sget_buffer_process
);
3140 defsubr (&Sdelete_process
);
3141 defsubr (&Sprocess_status
);
3142 defsubr (&Sprocess_exit_status
);
3143 defsubr (&Sprocess_id
);
3144 defsubr (&Sprocess_name
);
3145 defsubr (&Sprocess_command
);
3146 defsubr (&Sset_process_buffer
);
3147 defsubr (&Sprocess_buffer
);
3148 defsubr (&Sprocess_mark
);
3149 defsubr (&Sset_process_filter
);
3150 defsubr (&Sprocess_filter
);
3151 defsubr (&Sset_process_sentinel
);
3152 defsubr (&Sprocess_sentinel
);
3153 defsubr (&Sprocess_kill_without_query
);
3154 defsubr (&Slist_processes
);
3155 defsubr (&Sprocess_list
);
3156 defsubr (&Sstart_process
);
3158 defsubr (&Sopen_network_stream
);
3159 #endif /* HAVE_SOCKETS */
3160 defsubr (&Saccept_process_output
);
3161 defsubr (&Sprocess_send_region
);
3162 defsubr (&Sprocess_send_string
);
3163 defsubr (&Sinterrupt_process
);
3164 defsubr (&Skill_process
);
3165 defsubr (&Squit_process
);
3166 defsubr (&Sstop_process
);
3167 defsubr (&Scontinue_process
);
3168 defsubr (&Sprocess_send_eof
);
3169 defsubr (&Ssignal_process
);
3170 defsubr (&Swaiting_for_user_input_p
);
3171 /* defsubr (&Sprocess_connection); */
3175 #else /* not subprocesses */
3177 #include <sys/types.h>
3181 #include "systime.h"
3182 #include "termopts.h"
3184 extern int frame_garbaged
;
3187 /* As described above, except assuming that there are no subprocesses:
3189 Wait for timeout to elapse and/or keyboard input to be available.
3192 timeout in seconds, or
3193 zero for no limit, or
3194 -1 means gobble data immediately available but don't wait for any.
3196 read_kbd is a Lisp_Object:
3197 0 to ignore keyboard input, or
3198 1 to return when input is available, or
3199 -1 means caller will actually read the input, so don't throw to
3201 We know that read_kbd will never be a Lisp_Process, since
3202 `subprocesses' isn't defined.
3204 do_display != 0 means redisplay should be done to show subprocess
3205 output that arrives.
3207 Return true iff we received input from any process. */
3210 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3211 int time_limit
, microsecs
;
3212 Lisp_Object read_kbd
;
3215 EMACS_TIME end_time
, timeout
, *timeout_p
;
3218 /* What does time_limit really mean? */
3219 if (time_limit
|| microsecs
)
3221 /* It's not infinite. */
3222 timeout_p
= &timeout
;
3224 if (time_limit
== -1)
3225 /* In fact, it's zero. */
3226 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3228 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3230 /* How far in the future is that? */
3231 EMACS_GET_TIME (end_time
);
3232 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3235 /* It's infinite. */
3238 /* This must come before stop_polling. */
3239 prepare_menu_bars ();
3241 /* Turn off periodic alarms (in case they are in use)
3242 because the select emulator uses alarms. */
3249 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3251 /* If calling from keyboard input, do not quit
3252 since we want to return C-g as an input character.
3253 Otherwise, do pending quit if requested. */
3254 if (XINT (read_kbd
) >= 0)
3259 EMACS_GET_TIME (*timeout_p
);
3260 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3261 if (EMACS_TIME_NEG_P (*timeout_p
))
3265 /* Cause C-g and alarm signals to take immediate action,
3266 and cause input available signals to zero out timeout. */
3267 if (XINT (read_kbd
) < 0)
3268 set_waiting_for_input (&timeout
);
3270 /* If a frame has been newly mapped and needs updating,
3271 reprocess its display stuff. */
3272 if (frame_garbaged
&& do_display
)
3273 redisplay_preserve_echo_area ();
3275 if (XINT (read_kbd
) && detect_input_pending ())
3278 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3280 /* Make C-g and alarm signals set flags again */
3281 clear_waiting_for_input ();
3283 /* If we woke up due to SIGWINCH, actually change size now. */
3284 do_pending_window_change ();
3288 /* If the system call was interrupted, then go around the
3294 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3295 /* System sometimes fails to deliver SIGIO. */
3296 kill (getpid (), SIGIO
);
3299 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3303 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3315 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3316 /* Don't confuse make-docfile by having two doc strings for this function.
3317 make-docfile does not pay attention to #if, for good reason! */
3320 register Lisp_Object name
;
3325 /* Kill all processes associated with `buffer'.
3326 If `buffer' is nil, kill all processes.
3327 Since we have no subprocesses, this does nothing. */
3329 kill_buffer_processes (buffer
)
3340 defsubr (&Sget_buffer_process
);
3344 #endif /* not subprocesses */