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 */
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 /* TERM is a poor-man's SLIP, used on Linux. */
54 /* DGUX inet_addr returns a 'struct in_addr'. */
56 #define IN_ADDR struct in_addr
57 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
59 #define IN_ADDR unsigned long
60 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
63 #if defined(BSD) || defined(STRIDE)
64 #include <sys/ioctl.h>
65 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
67 #endif /* HAVE_PTYS and no O_NDELAY */
68 #endif /* BSD or STRIDE */
70 #ifdef BROKEN_O_NONBLOCK
72 #endif /* BROKEN_O_NONBLOCK */
79 #include <sys/sysmacros.h> /* for "minor" */
89 #include "termhooks.h"
94 Lisp_Object Qprocessp
;
95 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
96 /* Qexit is declared and initialized in eval.c. */
98 /* a process object is a network connection when its childp field is neither
99 Qt nor Qnil but is instead a string (name of foreign host we
100 are connected to + name of port we are connected to) */
103 static Lisp_Object stream_process
;
105 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
107 #define NETCONN_P(p) 0
108 #endif /* HAVE_SOCKETS */
110 /* Define first descriptor number available for subprocesses. */
112 #define FIRST_PROC_DESC 1
114 #define FIRST_PROC_DESC 3
117 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
120 #if !defined (SIGCHLD) && defined (SIGCLD)
121 #define SIGCHLD SIGCLD
124 #include "syssignal.h"
129 extern char *strerror ();
131 extern char *sys_errlist
[];
137 extern char *sys_siglist
[];
138 #endif /* not LINUX */
140 char *sys_siglist
[] =
146 "illegal instruction",
150 "floating point exception",
153 "segmentation violation",
154 "bad argument to system call",
155 "write on a pipe with no one to read it",
157 "software termination signal from kill",
159 "sendable stop signal not from tty",
160 "stop signal from tty",
161 "continue a stopped process",
162 "child status has changed",
163 "background read attempted from control tty",
164 "background write attempted from control tty",
165 "input record available at control tty",
166 "exceeded CPU time limit",
167 "exceeded file size limit"
172 /* t means use pty, nil means use a pipe,
173 maybe other values to come. */
174 static Lisp_Object Vprocess_connection_type
;
178 #include <sys/socket.h>
182 /* Number of events of change of status of a process. */
183 static int process_tick
;
185 /* Number of events for which the user or sentinel has been notified. */
186 static int update_tick
;
189 /* We could get this from param.h, but better not to depend on finding that.
190 And better not to risk that it might define other symbols used in this
193 #define MAXDESC FD_SETSIZE
197 #define SELECT_TYPE fd_set
198 #else /* no FD_SET */
200 #define SELECT_TYPE int
202 /* Define the macros to access a single-int bitmap of descriptors. */
203 #define FD_SET(n, p) (*(p) |= (1 << (n)))
204 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
205 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
206 #define FD_ZERO(p) (*(p) = 0)
207 #endif /* no FD_SET */
209 /* Mask of bits indicating the descriptors that we wait for input on */
211 static SELECT_TYPE input_wait_mask
;
213 /* Descriptor to use for keyboard input. */
214 static int keyboard_descriptor
;
216 /* Nonzero means delete a process right away if it exits. */
217 static int delete_exited_processes
;
219 /* Indexed by descriptor, gives the process (if any) for that descriptor */
220 static Lisp_Object chan_process
[MAXDESC
];
222 /* Alist of elements (NAME . PROCESS) */
223 static Lisp_Object Vprocess_alist
;
225 /* Buffered-ahead input char from process, indexed by channel.
226 -1 means empty (no char is buffered).
227 Used on sys V where the only way to tell if there is any
228 output from the process is to read at least one char.
229 Always -1 on systems that support FIONREAD. */
231 static int proc_buffered_char
[MAXDESC
];
233 static Lisp_Object
get_process ();
235 /* Compute the Lisp form of the process status, p->status, from
236 the numeric status that was returned by `wait'. */
238 Lisp_Object
status_convert ();
241 struct Lisp_Process
*p
;
243 union { int i
; WAITTYPE wt
; } u
;
244 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
245 p
->status
= status_convert (u
.wt
);
246 p
->raw_status_low
= Qnil
;
247 p
->raw_status_high
= Qnil
;
250 /* Convert a process status word in Unix format to
251 the list that we use internally. */
258 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
259 else if (WIFEXITED (w
))
260 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
261 WCOREDUMP (w
) ? Qt
: Qnil
));
262 else if (WIFSIGNALED (w
))
263 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
264 WCOREDUMP (w
) ? Qt
: Qnil
));
269 /* Given a status-list, extract the three pieces of information
270 and store them individually through the three pointers. */
273 decode_status (l
, symbol
, code
, coredump
)
281 if (XTYPE (l
) == Lisp_Symbol
)
289 *symbol
= XCONS (l
)->car
;
290 tem
= XCONS (l
)->cdr
;
291 *code
= XFASTINT (XCONS (tem
)->car
);
292 tem
= XCONS (tem
)->cdr
;
293 *coredump
= !NILP (tem
);
297 /* Return a string describing a process status list. */
300 status_message (status
)
305 Lisp_Object string
, string2
;
307 decode_status (status
, &symbol
, &code
, &coredump
);
309 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
315 signame
= sys_siglist
[code
];
317 signame
= sys_errlist
[code
];
322 string
= build_string (signame
);
323 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
324 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
325 return concat2 (string
, string2
);
327 else if (EQ (symbol
, Qexit
))
330 return build_string ("finished\n");
331 string
= Fnumber_to_string (make_number (code
));
332 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
333 return concat2 (build_string ("exited abnormally with code "),
334 concat2 (string
, string2
));
337 return Fcopy_sequence (Fsymbol_name (symbol
));
342 /* Open an available pty, returning a file descriptor.
343 Return -1 on failure.
344 The file name of the terminal corresponding to the pty
345 is left in the variable pty_name. */
356 /* Some systems name their pseudoterminals so that there are gaps in
357 the usual sequence - for example, on HP9000/S700 systems, there
358 are no pseudoterminals with names ending in 'f'. So we wait for
359 three failures in a row before deciding that we've reached the
361 int failed_count
= 0;
366 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
367 for (i
= 0; i
< 16; i
++)
370 #ifdef PTY_NAME_SPRINTF
373 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
374 #endif /* no PTY_NAME_SPRINTF */
378 #else /* no PTY_OPEN */
380 /* Unusual IRIS code */
381 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
384 if (fstat (fd
, &stb
) < 0)
387 if (stat (pty_name
, &stb
) < 0)
390 if (failed_count
>= 3)
396 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
398 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
400 #endif /* not IRIS */
401 #endif /* no PTY_OPEN */
405 /* check to make certain that both sides are available
406 this avoids a nasty yet stupid bug in rlogins */
407 #ifdef PTY_TTY_NAME_SPRINTF
410 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
411 #endif /* no PTY_TTY_NAME_SPRINTF */
413 if (access (pty_name
, 6) != 0)
416 #if !defined(IRIS) && !defined(__sgi)
422 #endif /* not UNIPLUS */
429 #endif /* HAVE_PTYS */
435 register Lisp_Object val
, tem
, name1
;
436 register struct Lisp_Process
*p
;
440 /* size of process structure includes the vector header,
441 so deduct for that. But struct Lisp_Vector includes the first
442 element, thus deducts too much, so add it back. */
443 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
444 - sizeof (struct Lisp_Vector
)
445 + sizeof (Lisp_Object
))
446 / sizeof (Lisp_Object
)),
448 XSETTYPE (val
, Lisp_Process
);
451 XSET (p
->infd
, Lisp_Int
, -1);
452 XSET (p
->outfd
, Lisp_Int
, -1);
453 XFASTINT (p
->pid
) = 0;
454 XFASTINT (p
->tick
) = 0;
455 XFASTINT (p
->update_tick
) = 0;
456 p
->raw_status_low
= Qnil
;
457 p
->raw_status_high
= Qnil
;
459 p
->mark
= Fmake_marker ();
461 /* If name is already in use, modify it until it is unused. */
466 tem
= Fget_process (name1
);
467 if (NILP (tem
)) break;
468 sprintf (suffix
, "<%d>", i
);
469 name1
= concat2 (name
, build_string (suffix
));
473 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
477 remove_process (proc
)
478 register Lisp_Object proc
;
480 register Lisp_Object pair
;
482 pair
= Frassq (proc
, Vprocess_alist
);
483 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
484 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
486 deactivate_process (proc
);
489 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
490 "Return t if OBJECT is a process.")
494 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
497 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
498 "Return the process named NAME, or nil if there is none.")
500 register Lisp_Object name
;
502 if (XTYPE (name
) == Lisp_Process
)
504 CHECK_STRING (name
, 0);
505 return Fcdr (Fassoc (name
, Vprocess_alist
));
508 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
509 "Return the (or, a) process associated with BUFFER.\n\
510 BUFFER may be a buffer or the name of one.")
512 register Lisp_Object name
;
514 register Lisp_Object buf
, tail
, proc
;
516 if (NILP (name
)) return Qnil
;
517 buf
= Fget_buffer (name
);
518 if (NILP (buf
)) return Qnil
;
520 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
522 proc
= Fcdr (Fcar (tail
));
523 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
529 /* This is how commands for the user decode process arguments. It
530 accepts a process, a process name, a buffer, a buffer name, or nil.
531 Buffers denote the first process in the buffer, and nil denotes the
536 register Lisp_Object name
;
538 register Lisp_Object proc
;
540 proc
= Fget_buffer_process (Fcurrent_buffer ());
543 proc
= Fget_process (name
);
545 proc
= Fget_buffer_process (Fget_buffer (name
));
552 error ("Current buffer has no process");
554 error ("Process %s does not exist", XSTRING (name
)->data
);
558 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
559 "Delete PROCESS: kill it and forget about it immediately.\n\
560 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
561 nil, indicating the current buffer's process.")
563 register Lisp_Object proc
;
565 proc
= get_process (proc
);
566 XPROCESS (proc
)->raw_status_low
= Qnil
;
567 XPROCESS (proc
)->raw_status_high
= Qnil
;
568 if (NETCONN_P (proc
))
570 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
571 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
573 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
575 Fkill_process (proc
, Qnil
);
576 /* Do this now, since remove_process will make sigchld_handler do nothing. */
577 XPROCESS (proc
)->status
578 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
579 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
582 remove_process (proc
);
586 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
587 "Return the status of PROCESS: a symbol, one of these:\n\
588 run -- for a process that is running.\n\
589 stop -- for a process stopped but continuable.\n\
590 exit -- for a process that has exited.\n\
591 signal -- for a process that has got a fatal signal.\n\
592 open -- for a network stream connection that is open.\n\
593 closed -- for a network stream connection that is closed.\n\
594 nil -- if arg is a process name and no such process exists.\n\
595 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
596 nil, indicating the current buffer's process.")
598 register Lisp_Object proc
;
600 register struct Lisp_Process
*p
;
601 register Lisp_Object status
;
602 proc
= get_process (proc
);
606 if (!NILP (p
->raw_status_low
))
609 if (XTYPE (status
) == Lisp_Cons
)
610 status
= XCONS (status
)->car
;
611 if (NETCONN_P (proc
))
613 if (EQ (status
, Qrun
))
615 else if (EQ (status
, Qexit
))
621 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
623 "Return the exit status of PROCESS or the signal number that killed it.\n\
624 If PROCESS has not yet exited or died, return 0.")
626 register Lisp_Object proc
;
628 CHECK_PROCESS (proc
, 0);
629 if (!NILP (XPROCESS (proc
)->raw_status_low
))
630 update_status (XPROCESS (proc
));
631 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
632 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
633 return make_number (0);
636 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
637 "Return the process id of PROCESS.\n\
638 This is the pid of the Unix process which PROCESS uses or talks to.\n\
639 For a network connection, this value is nil.")
641 register Lisp_Object proc
;
643 CHECK_PROCESS (proc
, 0);
644 return XPROCESS (proc
)->pid
;
647 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
648 "Return the name of PROCESS, as a string.\n\
649 This is the name of the program invoked in PROCESS,\n\
650 possibly modified to make it unique among process names.")
652 register Lisp_Object proc
;
654 CHECK_PROCESS (proc
, 0);
655 return XPROCESS (proc
)->name
;
658 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
659 "Return the command that was executed to start PROCESS.\n\
660 This is a list of strings, the first string being the program executed\n\
661 and the rest of the strings being the arguments given to it.\n\
662 For a non-child channel, this is nil.")
664 register Lisp_Object proc
;
666 CHECK_PROCESS (proc
, 0);
667 return XPROCESS (proc
)->command
;
670 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
672 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
674 register Lisp_Object proc
, buffer
;
676 CHECK_PROCESS (proc
, 0);
678 CHECK_BUFFER (buffer
, 1);
679 XPROCESS (proc
)->buffer
= buffer
;
683 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
685 "Return the buffer PROCESS is associated with.\n\
686 Output from PROCESS is inserted in this buffer\n\
687 unless PROCESS has a filter.")
689 register Lisp_Object proc
;
691 CHECK_PROCESS (proc
, 0);
692 return XPROCESS (proc
)->buffer
;
695 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
697 "Return the marker for the end of the last output from PROCESS.")
699 register Lisp_Object proc
;
701 CHECK_PROCESS (proc
, 0);
702 return XPROCESS (proc
)->mark
;
705 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
707 "Give PROCESS the filter function FILTER; nil means no filter.\n\
708 t means stop accepting output from the process.\n\
709 When a process has a filter, each time it does output\n\
710 the entire string of output is passed to the filter.\n\
711 The filter gets two arguments: the process and the string of output.\n\
712 If the process has a filter, its buffer is not used for output.")
714 register Lisp_Object proc
, filter
;
716 CHECK_PROCESS (proc
, 0);
718 FD_CLR (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
719 else if (EQ (XPROCESS (proc
)->filter
, Qt
))
720 FD_SET (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
721 XPROCESS (proc
)->filter
= filter
;
725 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
727 "Returns the filter function of PROCESS; nil if none.\n\
728 See `set-process-filter' for more info on filter functions.")
730 register Lisp_Object proc
;
732 CHECK_PROCESS (proc
, 0);
733 return XPROCESS (proc
)->filter
;
736 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
738 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
739 The sentinel is called as a function when the process changes state.\n\
740 It gets two arguments: the process, and a string describing the change.")
742 register Lisp_Object proc
, sentinel
;
744 CHECK_PROCESS (proc
, 0);
745 XPROCESS (proc
)->sentinel
= sentinel
;
749 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
751 "Return the sentinel of PROCESS; nil if none.\n\
752 See `set-process-sentinel' for more info on sentinels.")
754 register Lisp_Object proc
;
756 CHECK_PROCESS (proc
, 0);
757 return XPROCESS (proc
)->sentinel
;
760 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
761 Sprocess_kill_without_query
, 1, 2, 0,
762 "Say no query needed if PROCESS is running when Emacs is exited.\n\
763 Optional second argument if non-nil says to require a query.\n\
764 Value is t if a query was formerly required.")
766 register Lisp_Object proc
, value
;
770 CHECK_PROCESS (proc
, 0);
771 tem
= XPROCESS (proc
)->kill_without_query
;
772 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
777 #if 0 /* Turned off because we don't currently record this info
778 in the process. Perhaps add it. */
779 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
780 "Return the connection type of `PROCESS'.\n\
781 The value is `nil' for a pipe,\n\
782 `t' or `pty' for a pty, or `stream' for a socket connection.")
786 return XPROCESS (process
)->type
;
793 register Lisp_Object tail
, tem
;
794 Lisp_Object proc
, minspace
, tem1
;
795 register struct buffer
*old
= current_buffer
;
796 register struct Lisp_Process
*p
;
800 XFASTINT (minspace
) = 1;
802 set_buffer_internal (XBUFFER (Vstandard_output
));
803 Fbuffer_disable_undo (Vstandard_output
);
805 current_buffer
->truncate_lines
= Qt
;
808 Proc Status Buffer Command\n\
809 ---- ------ ------ -------\n", -1);
811 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
815 proc
= Fcdr (Fcar (tail
));
817 if (NILP (p
->childp
))
820 Finsert (1, &p
->name
);
821 Findent_to (make_number (13), minspace
);
823 if (!NILP (p
->raw_status_low
))
826 if (XTYPE (p
->status
) == Lisp_Cons
)
827 symbol
= XCONS (p
->status
)->car
;
830 if (EQ (symbol
, Qsignal
))
833 tem
= Fcar (Fcdr (p
->status
));
835 if (XINT (tem
) < NSIG
)
836 write_string (sys_errlist
[XINT (tem
)], -1);
839 Fprinc (symbol
, Qnil
);
841 else if (NETCONN_P (proc
))
843 if (EQ (symbol
, Qrun
))
844 write_string ("open", -1);
845 else if (EQ (symbol
, Qexit
))
846 write_string ("closed", -1);
848 Fprinc (symbol
, Qnil
);
851 Fprinc (symbol
, Qnil
);
853 if (EQ (symbol
, Qexit
))
856 tem
= Fcar (Fcdr (p
->status
));
859 sprintf (tembuf
, " %d", XFASTINT (tem
));
860 write_string (tembuf
, -1);
864 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
865 remove_process (proc
);
867 Findent_to (make_number (22), minspace
);
868 if (NILP (p
->buffer
))
869 insert_string ("(none)");
870 else if (NILP (XBUFFER (p
->buffer
)->name
))
871 insert_string ("(Killed)");
873 Finsert (1, &XBUFFER (p
->buffer
)->name
);
875 Findent_to (make_number (37), minspace
);
877 if (NETCONN_P (proc
))
879 sprintf (tembuf
, "(network stream connection to %s)\n",
880 XSTRING (p
->childp
)->data
);
881 insert_string (tembuf
);
895 insert_string ("\n");
901 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
902 "Display a list of all processes.\n\
903 \(Any processes listed as Exited or Signaled are actually eliminated\n\
904 after the listing is made.)")
907 internal_with_output_to_temp_buffer ("*Process List*",
908 list_processes_1
, Qnil
);
912 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
913 "Return a list of all processes.")
916 return Fmapcar (Qcdr
, Vprocess_alist
);
919 /* Starting asynchronous inferior processes. */
921 static Lisp_Object
start_process_unwind ();
923 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
924 "Start a program in a subprocess. Return the process object for it.\n\
925 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
926 NAME is name for process. It is modified if necessary to make it unique.\n\
927 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
928 Process output goes at end of that buffer, unless you specify\n\
929 an output stream or filter function to handle the output.\n\
930 BUFFER may be also nil, meaning that this process is not associated\n\
932 Third arg is program file name. It is searched for as in the shell.\n\
933 Remaining arguments are strings to give program as arguments.")
936 register Lisp_Object
*args
;
938 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
940 register unsigned char *new_argv
;
943 register unsigned char **new_argv
;
946 int count
= specpdl_ptr
- specpdl
;
950 buffer
= Fget_buffer_create (buffer
);
952 /* Make sure that the child will be able to chdir to the current
953 buffer's current directory, or its unhandled equivalent. We
954 can't just have the child check for an error when it does the
955 chdir, since it's in a vfork.
957 We have to GCPRO around this because Fexpand_file_name and
958 Funhandled_file_name_directory might call a file name handling
959 function. The argument list is protected by the caller, so all
960 we really have to worry about is buffer. */
962 struct gcpro gcpro1
, gcpro2
;
964 current_dir
= current_buffer
->directory
;
966 GCPRO2 (buffer
, current_dir
);
969 expand_and_dir_to_file
970 (Funhandled_file_name_directory (current_dir
), Qnil
);
971 if (NILP (Ffile_accessible_directory_p (current_dir
)))
972 report_file_error ("Setting current directory",
973 Fcons (current_buffer
->directory
, Qnil
));
979 CHECK_STRING (name
, 0);
983 CHECK_STRING (program
, 2);
986 /* Make a one member argv with all args concatenated
987 together separated by a blank. */
988 len
= XSTRING (program
)->size
+ 2;
989 for (i
= 3; i
< nargs
; i
++)
992 CHECK_STRING (tem
, i
);
993 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
995 new_argv
= (unsigned char *) alloca (len
);
996 strcpy (new_argv
, XSTRING (program
)->data
);
997 for (i
= 3; i
< nargs
; i
++)
1000 CHECK_STRING (tem
, i
);
1001 strcat (new_argv
, " ");
1002 strcat (new_argv
, XSTRING (tem
)->data
);
1004 /* Need to add code here to check for program existence on VMS */
1007 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1009 for (i
= 3; i
< nargs
; i
++)
1012 CHECK_STRING (tem
, i
);
1013 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1015 new_argv
[i
- 2] = 0;
1016 new_argv
[0] = XSTRING (program
)->data
;
1018 /* If program file name is not absolute, search our path for it */
1019 if (new_argv
[0][0] != '/')
1022 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1024 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1025 new_argv
[0] = XSTRING (tem
)->data
;
1027 #endif /* not VMS */
1029 proc
= make_process (name
);
1030 /* If an error occurs and we can't start the process, we want to
1031 remove it from the process list. This means that each error
1032 check in create_process doesn't need to call remove_process
1033 itself; it's all taken care of here. */
1034 record_unwind_protect (start_process_unwind
, proc
);
1036 XPROCESS (proc
)->childp
= Qt
;
1037 XPROCESS (proc
)->command_channel_p
= Qnil
;
1038 XPROCESS (proc
)->buffer
= buffer
;
1039 XPROCESS (proc
)->sentinel
= Qnil
;
1040 XPROCESS (proc
)->filter
= Qnil
;
1041 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1043 create_process (proc
, new_argv
, current_dir
);
1045 return unbind_to (count
, proc
);
1048 /* This function is the unwind_protect form for Fstart_process. If
1049 PROC doesn't have its pid set, then we know someone has signalled
1050 an error and the process wasn't started successfully, so we should
1051 remove it from the process list. */
1053 start_process_unwind (proc
)
1056 if (XTYPE (proc
) != Lisp_Process
)
1059 /* Was PROC started successfully? */
1060 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1061 remove_process (proc
);
1068 create_process_1 (signo
)
1072 /* USG systems forget handlers when they are used;
1073 must reestablish each time */
1074 signal (signo
, create_process_1
);
1078 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1081 /* Mimic blocking of signals on system V, which doesn't really have it. */
1083 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1084 int sigchld_deferred
;
1087 create_process_sigchld ()
1089 signal (SIGCHLD
, create_process_sigchld
);
1091 sigchld_deferred
= 1;
1097 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1098 create_process (process
, new_argv
, current_dir
)
1099 Lisp_Object process
;
1101 Lisp_Object current_dir
;
1103 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1106 SIGTYPE (*sigchld
)();
1109 extern char **environ
;
1111 inchannel
= outchannel
= -1;
1114 if (EQ (Vprocess_connection_type
, Qt
))
1115 outchannel
= inchannel
= allocate_pty ();
1120 /* On USG systems it does not work to open the pty's tty here
1121 and then close and reopen it in the child. */
1123 /* Don't let this terminal become our controlling terminal
1124 (in case we don't have one). */
1125 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1127 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1130 report_file_error ("Opening pty", Qnil
);
1132 forkin
= forkout
= -1;
1133 #endif /* not USG */
1137 #endif /* HAVE_PTYS */
1140 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1141 report_file_error ("Opening socketpair", Qnil
);
1142 outchannel
= inchannel
= sv
[0];
1143 forkout
= forkin
= sv
[1];
1145 #else /* not SKTPAIR */
1154 #endif /* not SKTPAIR */
1157 /* Replaced by close_process_descs */
1158 set_exclusive_use (inchannel
);
1159 set_exclusive_use (outchannel
);
1162 /* Stride people say it's a mystery why this is needed
1163 as well as the O_NDELAY, but that it fails without this. */
1164 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1167 ioctl (inchannel
, FIONBIO
, &one
);
1172 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1175 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1179 /* Record this as an active process, with its channels.
1180 As a result, child_setup will close Emacs's side of the pipes. */
1181 chan_process
[inchannel
] = process
;
1182 XSET (XPROCESS (process
)->infd
, Lisp_Int
, inchannel
);
1183 XSET (XPROCESS (process
)->outfd
, Lisp_Int
, outchannel
);
1184 /* Record the tty descriptor used in the subprocess. */
1186 XPROCESS (process
)->subtty
= Qnil
;
1188 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1189 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1190 XPROCESS (process
)->status
= Qrun
;
1192 /* Delay interrupts until we have a chance to store
1193 the new fork's pid in its process structure */
1197 #else /* not BSD4_1 */
1198 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1199 sigsetmask (sigmask (SIGCHLD
));
1200 #else /* ordinary USG */
1202 sigchld_deferred
= 0;
1203 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1205 #endif /* ordinary USG */
1206 #endif /* not BSD4_1 */
1207 #endif /* SIGCHLD */
1209 /* Until we store the proper pid, enable sigchld_handler
1210 to recognize an unknown pid as standing for this process.
1211 It is very important not to let this `marker' value stay
1212 in the table after this function has returned; if it does
1213 it might cause call-process to hang and subsequent asynchronous
1214 processes to get their return values scrambled. */
1215 XSETINT (XPROCESS (process
)->pid
, -1);
1218 /* child_setup must clobber environ on systems with true vfork.
1219 Protect it from permanent change. */
1220 char **save_environ
= environ
;
1225 int xforkin
= forkin
;
1226 int xforkout
= forkout
;
1228 #if 0 /* This was probably a mistake--it duplicates code later on,
1229 but fails to handle all the cases. */
1230 /* Make sure SIGCHLD is not blocked in the child. */
1231 sigsetmask (SIGEMPTYMASK
);
1234 /* Make the pty be the controlling terminal of the process. */
1236 /* First, disconnect its current controlling terminal. */
1240 /* Make the pty's terminal the controlling terminal. */
1242 /* We ignore the return value
1243 because faith@cs.unc.edu says that is necessary on Linux. */
1244 ioctl (xforkin
, TIOCSCTTY
, 0);
1246 #else /* not HAVE_SETSID */
1248 /* It's very important to call setpgrp here and no time
1249 afterwards. Otherwise, we lose our controlling tty which
1250 is set when we open the pty. */
1253 #endif /* not HAVE_SETSID */
1257 /* Use new line discipline. */
1258 int ldisc
= NTTYDISC
;
1259 if (ioctl (xforkin
, TIOCSETD
, &ldisc
) < 0)
1260 write (1, "create_process/TIOCSETD failed\n", 31);
1264 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1265 can do TIOCSPGRP only to the process's controlling tty. */
1268 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1269 I can't test it since I don't have 4.3. */
1270 int j
= open ("/dev/tty", O_RDWR
, 0);
1271 ioctl (j
, TIOCNOTTY
, 0);
1274 /* In order to get a controlling terminal on some versions
1275 of BSD, it is necessary to put the process in pgrp 0
1276 before it opens the terminal. */
1280 #endif /* TIOCNOTTY */
1282 #if !defined (RTU) && !defined (UNIPLUS)
1283 /*** There is a suggestion that this ought to be a
1284 conditional on TIOCSPGRP. */
1285 /* Now close the pty (if we had it open) and reopen it.
1286 This makes the pty the controlling terminal of the subprocess. */
1289 #ifdef SET_CHILD_PTY_PGRP
1290 int pgrp
= getpid ();
1293 /* I wonder if close (open (pty_name, ...)) would work? */
1296 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1298 #ifdef SET_CHILD_PTY_PGRP
1299 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1300 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1306 #endif /* not UNIPLUS and not RTU */
1307 #ifdef SETUP_SLAVE_PTY
1309 #endif /* SETUP_SLAVE_PTY */
1311 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1312 Now reenable it in the child, so it will die when we want it to. */
1314 signal (SIGHUP
, SIG_DFL
);
1316 #endif /* HAVE_PTYS */
1321 #else /* not BSD4_1 */
1322 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1323 sigsetmask (SIGEMPTYMASK
);
1324 #else /* ordinary USG */
1326 signal (SIGCHLD
, sigchld
);
1328 #endif /* ordinary USG */
1329 #endif /* not BSD4_1 */
1330 #endif /* SIGCHLD */
1332 child_setup_tty (xforkout
);
1333 child_setup (xforkin
, xforkout
, xforkout
,
1334 new_argv
, 1, current_dir
);
1336 environ
= save_environ
;
1340 report_file_error ("Doing vfork", Qnil
);
1342 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1344 FD_SET (inchannel
, &input_wait_mask
);
1346 /* If the subfork execv fails, and it exits,
1347 this close hangs. I don't know why.
1348 So have an interrupt jar it loose. */
1350 signal (SIGALRM
, create_process_1
);
1352 XPROCESS (process
)->subtty
= Qnil
;
1357 if (forkin
!= forkout
&& forkout
>= 0)
1363 #else /* not BSD4_1 */
1364 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1365 sigsetmask (SIGEMPTYMASK
);
1366 #else /* ordinary USG */
1368 signal (SIGCHLD
, sigchld
);
1369 /* Now really handle any of these signals
1370 that came in during this function. */
1371 if (sigchld_deferred
)
1372 kill (getpid (), SIGCHLD
);
1374 #endif /* ordinary USG */
1375 #endif /* not BSD4_1 */
1376 #endif /* SIGCHLD */
1378 #endif /* not VMS */
1382 /* open a TCP network connection to a given HOST/SERVICE. Treated
1383 exactly like a normal process when reading and writing. Only
1384 differences are in status display and process deletion. A network
1385 connection has no PID; you cannot signal it. All you can do is
1386 deactivate and close it via delete-process */
1388 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1390 "Open a TCP connection for a service to a host.\n\
1391 Returns a subprocess-object to represent the connection.\n\
1392 Input and output work as for subprocesses; `delete-process' closes it.\n\
1393 Args are NAME BUFFER HOST SERVICE.\n\
1394 NAME is name for process. It is modified if necessary to make it unique.\n\
1395 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1396 Process output goes at end of that buffer, unless you specify\n\
1397 an output stream or filter function to handle the output.\n\
1398 BUFFER may be also nil, meaning that this process is not associated\n\
1400 Third arg is name of the host to connect to, or its IP address.\n\
1401 Fourth arg SERVICE is name of the service desired, or an integer\n\
1402 specifying a port number to connect to.")
1403 (name
, buffer
, host
, service
)
1404 Lisp_Object name
, buffer
, host
, service
;
1408 struct sockaddr_in address
;
1409 struct servent
*svc_info
;
1410 struct hostent
*host_info_ptr
, host_info
;
1411 char *(addr_list
[2]);
1412 IN_ADDR numeric_addr
;
1416 struct hostent host_info_fixed
;
1417 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1419 GCPRO4 (name
, buffer
, host
, service
);
1420 CHECK_STRING (name
, 0);
1421 CHECK_STRING (host
, 0);
1422 if (XTYPE(service
) == Lisp_Int
)
1423 port
= htons ((unsigned short) XINT (service
));
1426 CHECK_STRING (service
, 0);
1427 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1429 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1430 port
= svc_info
->s_port
;
1434 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1435 if (host_info_ptr
== 0)
1436 /* Attempt to interpret host as numeric inet address */
1438 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1439 if (NUMERIC_ADDR_ERROR
)
1440 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1442 host_info_ptr
= &host_info
;
1443 host_info
.h_name
= 0;
1444 host_info
.h_aliases
= 0;
1445 host_info
.h_addrtype
= AF_INET
;
1447 /* Older machines have only one address slot called h_addr.
1448 Newer machines have h_addr_list, but #define h_addr to
1449 be its first element. */
1450 host_info
.h_addr_list
= &(addr_list
[0]);
1452 host_info
.h_addr
= (char*)(&numeric_addr
);
1454 host_info
.h_length
= strlen (addr_list
[0]);
1457 bzero (&address
, sizeof address
);
1458 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1459 host_info_ptr
->h_length
);
1460 address
.sin_family
= host_info_ptr
->h_addrtype
;
1461 address
.sin_port
= port
;
1463 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1465 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1467 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1468 when connect is interrupted. So let's not let it get interrupted.
1469 Note we do not turn off polling, because polling is only used
1470 when not interrupt_input, and thus not normally used on the systems
1471 which have this bug. On systems which use polling, there's no way
1472 to quit if polling is turned off. */
1473 if (interrupt_input
)
1477 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1484 if (interrupt_input
)
1488 report_file_error ("connection failed",
1489 Fcons (host
, Fcons (name
, Qnil
)));
1492 if (interrupt_input
)
1496 s
= connect_server (0);
1498 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1499 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1500 send_command (s
, C_DUMB
, 1, 0);
1506 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1509 buffer
= Fget_buffer_create (buffer
);
1510 proc
= make_process (name
);
1512 chan_process
[inch
] = proc
;
1515 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1518 fcntl (inch
, F_SETFL
, O_NDELAY
);
1522 XPROCESS (proc
)->childp
= host
;
1523 XPROCESS (proc
)->command_channel_p
= Qnil
;
1524 XPROCESS (proc
)->buffer
= buffer
;
1525 XPROCESS (proc
)->sentinel
= Qnil
;
1526 XPROCESS (proc
)->filter
= Qnil
;
1527 XPROCESS (proc
)->command
= Qnil
;
1528 XPROCESS (proc
)->pid
= Qnil
;
1529 XSET (XPROCESS (proc
)->infd
, Lisp_Int
, s
);
1530 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, outch
);
1531 XPROCESS (proc
)->status
= Qrun
;
1532 FD_SET (inch
, &input_wait_mask
);
1537 #endif /* HAVE_SOCKETS */
1539 deactivate_process (proc
)
1542 register int inchannel
, outchannel
;
1543 register struct Lisp_Process
*p
= XPROCESS (proc
);
1545 inchannel
= XINT (p
->infd
);
1546 outchannel
= XINT (p
->outfd
);
1550 /* Beware SIGCHLD hereabouts. */
1551 flush_pending_output (inchannel
);
1554 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1555 sys$
dassgn (outchannel
);
1556 vs
= get_vms_process_pointer (p
->pid
);
1558 give_back_vms_process_stuff (vs
);
1562 if (outchannel
>= 0 && outchannel
!= inchannel
)
1566 XSET (p
->infd
, Lisp_Int
, -1);
1567 XSET (p
->outfd
, Lisp_Int
, -1);
1568 chan_process
[inchannel
] = Qnil
;
1569 FD_CLR (inchannel
, &input_wait_mask
);
1573 /* Close all descriptors currently in use for communication
1574 with subprocess. This is used in a newly-forked subprocess
1575 to get rid of irrelevant descriptors. */
1577 close_process_descs ()
1580 for (i
= 0; i
< MAXDESC
; i
++)
1582 Lisp_Object process
;
1583 process
= chan_process
[i
];
1584 if (!NILP (process
))
1586 int in
= XINT (XPROCESS (process
)->infd
);
1587 int out
= XINT (XPROCESS (process
)->outfd
);
1590 if (out
>= 0 && in
!= out
)
1596 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1598 "Allow any pending output from subprocesses to be read by Emacs.\n\
1599 It is read into the process' buffers or given to their filter functions.\n\
1600 Non-nil arg PROCESS means do not return until some output has been received\n\
1602 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1603 seconds and microseconds to wait; return after that much time whether\n\
1604 or not there is input.\n\
1605 Return non-nil iff we received any output before the timeout expired.")
1606 (proc
, timeout
, timeout_msecs
)
1607 register Lisp_Object proc
, timeout
, timeout_msecs
;
1612 if (! NILP (timeout_msecs
))
1614 CHECK_NUMBER (timeout_msecs
, 2);
1615 useconds
= XINT (timeout_msecs
);
1616 if (XTYPE (timeout
) != Lisp_Int
)
1617 XSET (timeout
, Lisp_Int
, 0);
1620 int carry
= useconds
/ 1000000;
1622 XSETINT (timeout
, XINT (timeout
) + carry
);
1623 useconds
-= carry
* 1000000;
1625 /* I think this clause is necessary because C doesn't
1626 guarantee a particular rounding direction for negative
1630 XSETINT (timeout
, XINT (timeout
) - 1);
1631 useconds
+= 1000000;
1638 if (! NILP (timeout
))
1640 CHECK_NUMBER (timeout
, 1);
1641 seconds
= XINT (timeout
);
1654 XFASTINT (proc
) = 0;
1657 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1661 /* This variable is different from waiting_for_input in keyboard.c.
1662 It is used to communicate to a lisp process-filter/sentinel (via the
1663 function Fwaiting_for_user_input_p below) whether emacs was waiting
1664 for user-input when that process-filter was called.
1665 waiting_for_input cannot be used as that is by definition 0 when
1666 lisp code is being evalled */
1667 static int waiting_for_user_input_p
;
1669 /* Read and dispose of subprocess output while waiting for timeout to
1670 elapse and/or keyboard input to be available.
1673 timeout in seconds, or
1674 zero for no limit, or
1675 -1 means gobble data immediately available but don't wait for any.
1678 an additional duration to wait, measured in microseconds.
1679 If this is nonzero and time_limit is 0, then the timeout
1680 consists of MICROSECS only.
1682 READ_KBD is a lisp value:
1683 0 to ignore keyboard input, or
1684 1 to return when input is available, or
1685 -1 meaning caller will actually read the input, so don't throw to
1686 the quit handler, or
1687 a cons cell, meaning wait wait until its car is non-nil
1688 (and gobble terminal input into the buffer if any arrives), or
1689 a process object, meaning wait until something arrives from that
1690 process. The return value is true iff we read some input from
1693 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1694 output that arrives.
1696 If READ_KBD is a pointer to a struct Lisp_Process, then the
1697 function returns true iff we received input from that process
1698 before the timeout elapsed.
1699 Otherwise, return true iff we received input from any process. */
1701 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1702 int time_limit
, microsecs
;
1703 Lisp_Object read_kbd
;
1706 register int channel
, nfds
, m
;
1707 static SELECT_TYPE Available
;
1710 EMACS_TIME timeout
, end_time
, garbage
;
1712 int wait_channel
= -1;
1713 struct Lisp_Process
*wait_proc
= 0;
1714 int got_some_input
= 0;
1715 Lisp_Object
*wait_for_cell
= 0;
1717 FD_ZERO (&Available
);
1719 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1721 if (XTYPE (read_kbd
) == Lisp_Process
)
1723 wait_proc
= XPROCESS (read_kbd
);
1724 wait_channel
= XINT (wait_proc
->infd
);
1725 XFASTINT (read_kbd
) = 0;
1728 /* If waiting for non-nil in a cell, record where. */
1729 if (XTYPE (read_kbd
) == Lisp_Cons
)
1731 wait_for_cell
= &XCONS (read_kbd
)->car
;
1732 XFASTINT (read_kbd
) = 0;
1735 waiting_for_user_input_p
= XINT (read_kbd
);
1737 /* Since we may need to wait several times,
1738 compute the absolute time to return at. */
1739 if (time_limit
|| microsecs
)
1741 EMACS_GET_TIME (end_time
);
1742 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1743 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1746 /* It would not be safe to call this below,
1747 where we call redisplay_preserve_echo_area. */
1748 prepare_menu_bars ();
1752 /* If calling from keyboard input, do not quit
1753 since we want to return C-g as an input character.
1754 Otherwise, do pending quit if requested. */
1755 if (XINT (read_kbd
) >= 0)
1758 /* Exit now if the cell we're waiting for became non-nil. */
1759 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1762 /* Compute time from now till when time limit is up */
1763 /* Exit if already run out */
1764 if (time_limit
== -1)
1766 /* -1 specified for timeout means
1767 gobble output available now
1768 but don't wait at all. */
1770 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1772 else if (time_limit
|| microsecs
)
1774 EMACS_GET_TIME (timeout
);
1775 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1776 if (EMACS_TIME_NEG_P (timeout
))
1781 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1784 /* Cause C-g and alarm signals to take immediate action,
1785 and cause input available signals to zero out timeout.
1787 It is important that we do this before checking for process
1788 activity. If we get a SIGCHLD after the explicit checks for
1789 process activity, timeout is the only way we will know. */
1790 if (XINT (read_kbd
) < 0)
1791 set_waiting_for_input (&timeout
);
1793 /* If status of something has changed, and no input is
1794 available, notify the user of the change right away. After
1795 this explicit check, we'll let the SIGCHLD handler zap
1796 timeout to get our attention. */
1797 if (update_tick
!= process_tick
&& do_display
)
1799 Atemp
= input_wait_mask
;
1800 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1801 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1803 /* It's okay for us to do this and then continue with
1804 the loop, since timeout has already been zeroed out. */
1805 clear_waiting_for_input ();
1810 /* Don't wait for output from a non-running process. */
1811 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1812 update_status (wait_proc
);
1814 && ! EQ (wait_proc
->status
, Qrun
))
1816 clear_waiting_for_input ();
1820 /* Wait till there is something to do */
1822 Available
= input_wait_mask
;
1823 /* We used to have && wait_for_cell == 0
1824 but that led to lossage handling selection_request events:
1825 within one, we would start to handle another. */
1826 if (! XINT (read_kbd
))
1827 FD_CLR (keyboard_descriptor
, &Available
);
1829 /* If frame size has changed or the window is newly mapped,
1830 redisplay now, before we start to wait. There is a race
1831 condition here; if a SIGIO arrives between now and the select
1832 and indicates that a frame is trashed, the select may block
1833 displaying a trashed screen. */
1835 redisplay_preserve_echo_area ();
1837 if (XINT (read_kbd
) && detect_input_pending ())
1840 FD_ZERO (&Available
);
1843 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1847 /* Make C-g and alarm signals set flags again */
1848 clear_waiting_for_input ();
1850 /* If we woke up due to SIGWINCH, actually change size now. */
1851 do_pending_window_change ();
1853 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1857 if (xerrno
== EINTR
)
1858 FD_ZERO (&Available
);
1860 /* Ultrix select seems to return ENOMEM when it is
1861 interrupted. Treat it just like EINTR. Bleah. Note
1862 that we want to test for the "ultrix" CPP symbol, not
1863 "__ultrix__"; the latter is only defined under GCC, but
1864 not by DEC's bundled CC. -JimB */
1865 else if (xerrno
== ENOMEM
)
1866 FD_ZERO (&Available
);
1869 /* This happens for no known reason on ALLIANT.
1870 I am guessing that this is the right response. -- RMS. */
1871 else if (xerrno
== EFAULT
)
1872 FD_ZERO (&Available
);
1874 else if (xerrno
== EBADF
)
1877 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1878 the child's closure of the pts gives the parent a SIGHUP, and
1879 the ptc file descriptor is automatically closed,
1880 yielding EBADF here or at select() call above.
1881 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1882 in m/ibmrt-aix.h), and here we just ignore the select error.
1883 Cleanup occurs c/o status_notify after SIGCLD. */
1884 FD_ZERO (&Available
); /* Cannot depend on values returned */
1890 error("select error: %s", strerror (xerrno
));
1892 #if defined(sun) && !defined(USG5_4)
1893 else if (nfds
> 0 && FD_ISSET (keyboard_descriptor
, &Available
)
1895 /* System sometimes fails to deliver SIGIO.
1897 David J. Mackenzie says that Emacs doesn't compile under
1898 Solaris if this code is enabled, thus the USG5_4 in the CPP
1899 conditional. "I haven't noticed any ill effects so far.
1900 If you find a Solaris expert somewhere, they might know
1902 kill (getpid (), SIGIO
);
1905 /* Check for keyboard input */
1906 /* If there is any, return immediately
1907 to give it higher priority than subprocesses */
1909 /* We used to do his if wait_for_cell,
1910 but that caused infinite recursion in selection request events. */
1911 if ((XINT (read_kbd
))
1912 && detect_input_pending ())
1915 if (detect_input_pending ())
1919 /* Exit now if the cell we're waiting for became non-nil. */
1920 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1924 /* If we think we have keyboard input waiting, but didn't get SIGIO
1925 go read it. This can happen with X on BSD after logging out.
1926 In that case, there really is no input and no SIGIO,
1927 but select says there is input. */
1929 if (XINT (read_kbd
) && interrupt_input
1930 && (FD_ISSET (keyboard_descriptor
, &Available
)))
1935 got_some_input
|= nfds
> 0;
1937 /* If checking input just got us a size-change event from X,
1938 obey it now if we should. */
1939 if (XINT (read_kbd
) || wait_for_cell
)
1940 do_pending_window_change ();
1942 /* Check for data from a process. */
1943 /* Really FIRST_PROC_DESC should be 0 on Unix,
1944 but this is safer in the short run. */
1945 for (channel
= keyboard_descriptor
== 0 ? FIRST_PROC_DESC
: 0;
1946 channel
< MAXDESC
; channel
++)
1948 if (FD_ISSET (channel
, &Available
))
1952 /* If waiting for this channel, arrange to return as
1953 soon as no more input to be processed. No more
1955 if (wait_channel
== channel
)
1961 proc
= chan_process
[channel
];
1965 /* Read data from the process, starting with our
1966 buffered-ahead character if we have one. */
1968 nread
= read_process_output (proc
, channel
);
1971 /* Since read_process_output can run a filter,
1972 which can call accept-process-output,
1973 don't try to read from any other processes
1974 before doing the select again. */
1975 FD_ZERO (&Available
);
1978 redisplay_preserve_echo_area ();
1981 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1985 else if (nread
== -1 && errno
== EAGAIN
)
1989 else if (nread
== -1 && errno
== EAGAIN
)
1991 /* Note that we cannot distinguish between no input
1992 available now and a closed pipe.
1993 With luck, a closed pipe will be accompanied by
1994 subprocess termination and SIGCHLD. */
1995 else if (nread
== 0 && !NETCONN_P (proc
))
1997 #endif /* O_NDELAY */
1998 #endif /* O_NONBLOCK */
1999 #endif /* EWOULDBLOCK */
2001 /* On some OSs with ptys, when the process on one end of
2002 a pty exits, the other end gets an error reading with
2003 errno = EIO instead of getting an EOF (0 bytes read).
2004 Therefore, if we get an error reading and errno =
2005 EIO, just continue, because the child process has
2006 exited and should clean itself up soon (e.g. when we
2008 else if (nread
== -1 && errno
== EIO
)
2010 #endif /* HAVE_PTYS */
2011 /* If we can detect process termination, don't consider the process
2012 gone just because its pipe is closed. */
2014 else if (nread
== 0 && !NETCONN_P (proc
))
2019 /* Preserve status of processes already terminated. */
2020 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2021 deactivate_process (proc
);
2022 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2023 update_status (XPROCESS (proc
));
2024 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2025 XPROCESS (proc
)->status
2026 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2029 } /* end for each file descriptor */
2030 } /* end while exit conditions not met */
2032 /* If calling from keyboard input, do not quit
2033 since we want to return C-g as an input character.
2034 Otherwise, do pending quit if requested. */
2035 if (XINT (read_kbd
) >= 0)
2037 /* Prevent input_pending from remaining set if we quit. */
2038 clear_input_pending ();
2042 return got_some_input
;
2045 /* Read pending output from the process channel,
2046 starting with our buffered-ahead character if we have one.
2047 Yield number of characters read.
2049 This function reads at most 1024 characters.
2050 If you want to read all available subprocess output,
2051 you must call it repeatedly until it returns zero. */
2053 read_process_output (proc
, channel
)
2055 register int channel
;
2057 register int nchars
;
2063 register Lisp_Object outstream
;
2064 register struct buffer
*old
= current_buffer
;
2065 register struct Lisp_Process
*p
= XPROCESS (proc
);
2066 register int opoint
;
2069 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2071 vs
= get_vms_process_pointer (p
->pid
);
2075 return(0); /* Really weird if it does this */
2076 if (!(vs
->iosb
[0] & 1))
2077 return -1; /* I/O error */
2080 error ("Could not get VMS process pointer");
2081 chars
= vs
->inputBuffer
;
2082 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2085 start_vms_process_read (vs
); /* Crank up the next read on the process */
2086 return 1; /* Nothing worth printing, say we got 1 */
2090 if (proc_buffered_char
[channel
] < 0)
2091 nchars
= read (channel
, chars
, sizeof chars
);
2094 chars
[0] = proc_buffered_char
[channel
];
2095 proc_buffered_char
[channel
] = -1;
2096 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2100 nchars
= nchars
+ 1;
2102 #endif /* not VMS */
2104 if (nchars
<= 0) return nchars
;
2106 outstream
= p
->filter
;
2107 if (!NILP (outstream
))
2109 /* We inhibit quit here instead of just catching it so that
2110 hitting ^G when a filter happens to be running won't screw
2112 int count
= specpdl_ptr
- specpdl
;
2113 Lisp_Object odeactivate
;
2115 odeactivate
= Vdeactivate_mark
;
2117 specbind (Qinhibit_quit
, Qt
);
2118 call2 (outstream
, proc
, make_string (chars
, nchars
));
2120 /* Handling the process output should not deactivate the mark. */
2121 Vdeactivate_mark
= odeactivate
;
2124 start_vms_process_read (vs
);
2126 unbind_to (count
, Qnil
);
2130 /* If no filter, write into buffer if it isn't dead. */
2131 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2133 Lisp_Object old_read_only
;
2134 Lisp_Object old_begv
, old_zv
;
2135 Lisp_Object odeactivate
;
2137 odeactivate
= Vdeactivate_mark
;
2139 Fset_buffer (p
->buffer
);
2141 old_read_only
= current_buffer
->read_only
;
2142 XFASTINT (old_begv
) = BEGV
;
2143 XFASTINT (old_zv
) = ZV
;
2145 current_buffer
->read_only
= Qnil
;
2147 /* Insert new output into buffer
2148 at the current end-of-output marker,
2149 thus preserving logical ordering of input and output. */
2150 if (XMARKER (p
->mark
)->buffer
)
2151 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2155 /* If the output marker is outside of the visible region, save
2156 the restriction and widen. */
2157 if (! (BEGV
<= point
&& point
<= ZV
))
2160 /* Make sure opoint floats ahead of any new text, just as point
2162 if (point
<= opoint
)
2165 /* Insert after old_begv, but before old_zv. */
2166 if (point
< XFASTINT (old_begv
))
2167 XFASTINT (old_begv
) += nchars
;
2168 if (point
<= XFASTINT (old_zv
))
2169 XFASTINT (old_zv
) += nchars
;
2171 /* Insert before markers in case we are inserting where
2172 the buffer's mark is, and the user's next command is Meta-y. */
2173 insert_before_markers (chars
, nchars
);
2174 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2176 update_mode_lines
++;
2178 /* If the restriction isn't what it should be, set it. */
2179 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2180 Fnarrow_to_region (old_begv
, old_zv
);
2182 /* Handling the process output should not deactivate the mark. */
2183 Vdeactivate_mark
= odeactivate
;
2185 current_buffer
->read_only
= old_read_only
;
2187 set_buffer_internal (old
);
2190 start_vms_process_read (vs
);
2195 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2197 "Returns non-NIL if emacs is waiting for input from the user.\n\
2198 This is intended for use by asynchronous process output filters and sentinels.")
2201 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2204 /* Sending data to subprocess */
2206 jmp_buf send_process_frame
;
2209 send_process_trap ()
2215 longjmp (send_process_frame
, 1);
2218 send_process (proc
, buf
, len
)
2223 /* Don't use register vars; longjmp can lose them. */
2225 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2229 struct Lisp_Process
*p
= XPROCESS (proc
);
2230 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2233 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2234 update_status (XPROCESS (proc
));
2235 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2236 error ("Process %s not running", procname
);
2239 vs
= get_vms_process_pointer (p
->pid
);
2241 error ("Could not find this process: %x", p
->pid
);
2242 else if (write_to_vms_process (vs
, buf
, len
))
2245 if (!setjmp (send_process_frame
))
2249 SIGTYPE (*old_sigpipe
)();
2251 /* Don't send more than 500 bytes at a time. */
2254 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2255 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
2256 signal (SIGPIPE
, old_sigpipe
);
2261 || errno
== EWOULDBLOCK
2268 /* It would be nice to accept process output here,
2269 but that is difficult. For example, it could
2270 garbage what we are sending if that is from a buffer. */
2277 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2281 /* Allow input from processes between bursts of sending.
2282 Otherwise things may get stopped up. */
2287 XFASTINT (zero
) = 0;
2288 wait_reading_process_input (-1, 0, zero
, 0);
2294 XPROCESS (proc
)->raw_status_low
= Qnil
;
2295 XPROCESS (proc
)->raw_status_high
= Qnil
;
2296 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2297 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2298 deactivate_process (proc
);
2300 error ("Error writing to process %s; closed it", procname
);
2302 error ("SIGPIPE raised on process %s; closed it", procname
);
2307 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2309 "Send current contents of region as input to PROCESS.\n\
2310 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2311 nil, indicating the current buffer's process.\n\
2312 Called from program, takes three arguments, PROCESS, START and END.\n\
2313 If the region is more than 500 characters long,\n\
2314 it is sent in several bunches. This may happen even for shorter regions.\n\
2315 Output from processes can arrive in between bunches.")
2316 (process
, start
, end
)
2317 Lisp_Object process
, start
, end
;
2322 proc
= get_process (process
);
2323 validate_region (&start
, &end
);
2325 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2328 start1
= XINT (start
);
2329 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2334 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2336 "Send PROCESS the contents of STRING as input.\n\
2337 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2338 nil, indicating the current buffer's process.\n\
2339 If STRING is more than 500 characters long,\n\
2340 it is sent in several bunches. This may happen even for shorter strings.\n\
2341 Output from processes can arrive in between bunches.")
2343 Lisp_Object process
, string
;
2346 CHECK_STRING (string
, 1);
2347 proc
= get_process (process
);
2348 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2352 /* send a signal number SIGNO to PROCESS.
2353 CURRENT_GROUP means send to the process group that currently owns
2354 the terminal being used to communicate with PROCESS.
2355 This is used for various commands in shell mode.
2356 If NOMSG is zero, insert signal-announcements into process's buffers
2359 If we can, we try to signal PROCESS by sending control characters
2360 down the pipe. This allows us to signal inferiors who have changed
2361 their uid, for which killpg would return an EPERM error. */
2364 process_send_signal (process
, signo
, current_group
, nomsg
)
2365 Lisp_Object process
;
2367 Lisp_Object current_group
;
2371 register struct Lisp_Process
*p
;
2375 proc
= get_process (process
);
2376 p
= XPROCESS (proc
);
2378 if (!EQ (p
->childp
, Qt
))
2379 error ("Process %s is not a subprocess",
2380 XSTRING (p
->name
)->data
);
2381 if (XINT (p
->infd
) < 0)
2382 error ("Process %s is not active",
2383 XSTRING (p
->name
)->data
);
2385 if (NILP (p
->pty_flag
))
2386 current_group
= Qnil
;
2388 /* If we are using pgrps, get a pgrp number and make it negative. */
2389 if (!NILP (current_group
))
2391 #ifdef SIGNALS_VIA_CHARACTERS
2392 /* If possible, send signals to the entire pgrp
2393 by sending an input character to it. */
2395 /* TERMIOS is the latest and bestest, and seems most likely to
2396 work. If the system has it, use it. */
2403 tcgetattr (XINT (p
->infd
), &t
);
2404 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2408 tcgetattr (XINT (p
->infd
), &t
);
2409 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2413 tcgetattr (XINT (p
->infd
), &t
);
2414 #if defined (VSWTCH) && !defined (IRIX5)
2415 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2417 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2422 #else /* ! HAVE_TERMIOS */
2424 /* On Berkeley descendants, the following IOCTL's retrieve the
2425 current control characters. */
2426 #if defined (TIOCGLTC) && defined (TIOCGETC)
2434 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2435 send_process (proc
, &c
.t_intrc
, 1);
2438 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2439 send_process (proc
, &c
.t_quitc
, 1);
2443 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
2444 send_process (proc
, &lc
.t_suspc
, 1);
2446 #endif /* ! defined (SIGTSTP) */
2449 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2451 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2458 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2459 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2462 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2463 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2467 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2468 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2470 #endif /* ! defined (SIGTSTP) */
2472 #else /* ! defined (TCGETA) */
2473 Your configuration files are messed up
.
2474 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2475 you'd better be using one of the alternatives above! */
2476 #endif /* ! defined (TCGETA) */
2477 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2478 #endif /* ! defined HAVE_TERMIOS */
2479 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2482 /* Get the pgrp using the tty itself, if we have that.
2483 Otherwise, use the pty to get the pgrp.
2484 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2485 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2486 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2487 His patch indicates that if TIOCGPGRP returns an error, then
2488 we should just assume that p->pid is also the process group id. */
2492 if (!NILP (p
->subtty
))
2493 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2495 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
2499 gid
= - XFASTINT (p
->pid
);
2500 #endif /* ! defined (pfa) */
2506 #else /* ! defined (TIOCGPGRP ) */
2507 /* Can't select pgrps on this system, so we know that
2508 the child itself heads the pgrp. */
2509 gid
= - XFASTINT (p
->pid
);
2510 #endif /* ! defined (TIOCGPGRP ) */
2513 gid
= - XFASTINT (p
->pid
);
2519 p
->raw_status_low
= Qnil
;
2520 p
->raw_status_high
= Qnil
;
2522 XSETINT (p
->tick
, ++process_tick
);
2526 #endif /* ! defined (SIGCONT) */
2529 send_process (proc
, "\003", 1); /* ^C */
2534 send_process (proc
, "\031", 1); /* ^Y */
2539 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2542 flush_pending_output (XINT (p
->infd
));
2546 /* If we don't have process groups, send the signal to the immediate
2547 subprocess. That isn't really right, but it's better than any
2548 obvious alternative. */
2551 kill (XFASTINT (p
->pid
), signo
);
2555 /* gid may be a pid, or minus a pgrp's number */
2557 if (!NILP (current_group
))
2558 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
2561 gid
= - XFASTINT (p
->pid
);
2564 #else /* ! defined (TIOCSIGSEND) */
2565 EMACS_KILLPG (-gid
, signo
);
2566 #endif /* ! defined (TIOCSIGSEND) */
2569 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2570 "Interrupt process PROCESS. May be process or name of one.\n\
2571 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2572 Nil or no arg means current buffer's process.\n\
2573 Second arg CURRENT-GROUP non-nil means send signal to\n\
2574 the current process-group of the process's controlling terminal\n\
2575 rather than to the process's own process group.\n\
2576 If the process is a shell, this means interrupt current subjob\n\
2577 rather than the shell.")
2578 (process
, current_group
)
2579 Lisp_Object process
, current_group
;
2581 process_send_signal (process
, SIGINT
, current_group
, 0);
2585 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2586 "Kill process PROCESS. May be process or name of one.\n\
2587 See function `interrupt-process' for more details on usage.")
2588 (process
, current_group
)
2589 Lisp_Object process
, current_group
;
2591 process_send_signal (process
, SIGKILL
, current_group
, 0);
2595 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2596 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2597 See function `interrupt-process' for more details on usage.")
2598 (process
, current_group
)
2599 Lisp_Object process
, current_group
;
2601 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2605 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2606 "Stop process PROCESS. May be process or name of one.\n\
2607 See function `interrupt-process' for more details on usage.")
2608 (process
, current_group
)
2609 Lisp_Object process
, current_group
;
2612 error ("no SIGTSTP support");
2614 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2619 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2620 "Continue process PROCESS. May be process or name of one.\n\
2621 See function `interrupt-process' for more details on usage.")
2622 (process
, current_group
)
2623 Lisp_Object process
, current_group
;
2626 process_send_signal (process
, SIGCONT
, current_group
, 0);
2628 error ("no SIGCONT support");
2633 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2634 2, 2, "nProcess number: \nnSignal code: ",
2635 "Send the process with number PID the signal with code CODE.\n\
2636 Both PID and CODE are integers.")
2638 Lisp_Object pid
, sig
;
2640 CHECK_NUMBER (pid
, 0);
2641 CHECK_NUMBER (sig
, 1);
2642 return make_number (kill (XINT (pid
), XINT (sig
)));
2645 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2646 "Make PROCESS see end-of-file in its input.\n\
2647 Eof comes after any text already sent to it.\n\
2648 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2649 nil, indicating the current buffer's process.")
2651 Lisp_Object process
;
2655 proc
= get_process (process
);
2657 /* Make sure the process is really alive. */
2658 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2659 update_status (XPROCESS (proc
));
2660 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2661 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2663 /* Sending a zero-length record is supposed to mean eof
2664 when TIOCREMOTE is turned on. */
2668 write (XINT (XPROCESS (proc
)->outfd
), buf
, 0);
2670 #else /* did not do TOICREMOTE */
2672 send_process (proc
, "\032", 1); /* ^z */
2674 if (!NILP (XPROCESS (proc
)->pty_flag
))
2675 send_process (proc
, "\004", 1);
2678 close (XINT (XPROCESS (proc
)->outfd
));
2679 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, open (NULL_DEVICE
, O_WRONLY
));
2682 #endif /* did not do TOICREMOTE */
2686 /* Kill all processes associated with `buffer'.
2687 If `buffer' is nil, kill all processes */
2689 kill_buffer_processes (buffer
)
2692 Lisp_Object tail
, proc
;
2694 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2695 tail
= XCONS (tail
)->cdr
)
2697 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2698 if (XGCTYPE (proc
) == Lisp_Process
2699 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2701 if (NETCONN_P (proc
))
2702 deactivate_process (proc
);
2703 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
2704 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2709 /* On receipt of a signal that a child status has changed,
2710 loop asking about children with changed statuses until
2711 the system says there are no more.
2712 All we do is change the status;
2713 we do not run sentinels or print notifications.
2714 That is saved for the next time keyboard input is done,
2715 in order to avoid timing errors. */
2717 /** WARNING: this can be called during garbage collection.
2718 Therefore, it must not be fooled by the presence of mark bits in
2721 /** USG WARNING: Although it is not obvious from the documentation
2722 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2723 signal() before executing at least one wait(), otherwise the handler
2724 will be called again, resulting in an infinite loop. The relevant
2725 portion of the documentation reads "SIGCLD signals will be queued
2726 and the signal-catching function will be continually reentered until
2727 the queue is empty". Invoking signal() causes the kernel to reexamine
2728 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2731 sigchld_handler (signo
)
2734 int old_errno
= errno
;
2736 register struct Lisp_Process
*p
;
2737 extern EMACS_TIME
*input_available_clear_time
;
2741 sigheld
|= sigbit (SIGCHLD
);
2753 #endif /* no WUNTRACED */
2754 /* Keep trying to get a status until we get a definitive result. */
2758 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2760 while (pid
<= 0 && errno
== EINTR
);
2764 /* A real failure. We have done all our job, so return. */
2766 /* USG systems forget handlers when they are used;
2767 must reestablish each time */
2769 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2772 sigheld
&= ~sigbit (SIGCHLD
);
2780 #endif /* no WNOHANG */
2782 /* Find the process that signaled us, and record its status. */
2785 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2787 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2788 p
= XPROCESS (proc
);
2789 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2794 /* Look for an asynchronous process whose pid hasn't been filled
2797 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2799 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2800 p
= XPROCESS (proc
);
2801 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2806 /* Change the status of the process that was found. */
2809 union { int i
; WAITTYPE wt
; } u
;
2811 XSETINT (p
->tick
, ++process_tick
);
2813 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2814 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2816 /* If process has terminated, stop waiting for its output. */
2817 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2818 if (XINT (p
->infd
) >= 0)
2819 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
2821 /* Tell wait_reading_process_input that it needs to wake up and
2823 if (input_available_clear_time
)
2824 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2827 /* There was no asynchronous process found for that id. Check
2828 if we have a synchronous process. */
2831 synch_process_alive
= 0;
2833 /* Report the status of the synchronous process. */
2835 synch_process_retcode
= WRETCODE (w
);
2836 else if (WIFSIGNALED (w
))
2838 int code
= WTERMSIG (w
);
2844 signame
= sys_siglist
[code
];
2846 signame
= sys_errlist
[code
];
2850 signame
= "unknown";
2852 synch_process_death
= signame
;
2855 /* Tell wait_reading_process_input that it needs to wake up and
2857 if (input_available_clear_time
)
2858 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2861 /* On some systems, we must return right away.
2862 If any more processes want to signal us, we will
2864 Otherwise (on systems that have WNOHANG), loop around
2865 to use up all the processes that have something to tell us. */
2866 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2868 signal (signo
, sigchld_handler
);
2872 #endif /* USG, but not HPUX with WNOHANG */
2878 exec_sentinel_unwind (data
)
2881 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2886 exec_sentinel (proc
, reason
)
2887 Lisp_Object proc
, reason
;
2889 Lisp_Object sentinel
;
2890 register struct Lisp_Process
*p
= XPROCESS (proc
);
2891 int count
= specpdl_ptr
- specpdl
;
2893 sentinel
= p
->sentinel
;
2894 if (NILP (sentinel
))
2897 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2898 assure that it gets restored no matter how the sentinel exits. */
2900 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2901 /* Inhibit quit so that random quits don't screw up a running filter. */
2902 specbind (Qinhibit_quit
, Qt
);
2903 call2 (sentinel
, proc
, reason
);
2904 unbind_to (count
, Qnil
);
2907 /* Report all recent events of a change in process status
2908 (either run the sentinel or output a message).
2909 This is done while Emacs is waiting for keyboard input. */
2913 register Lisp_Object proc
, buffer
;
2914 Lisp_Object tail
= Qnil
;
2915 Lisp_Object msg
= Qnil
;
2916 struct gcpro gcpro1
, gcpro2
;
2918 /* We need to gcpro tail; if read_process_output calls a filter
2919 which deletes a process and removes the cons to which tail points
2920 from Vprocess_alist, and then causes a GC, tail is an unprotected
2924 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2927 register struct Lisp_Process
*p
;
2929 proc
= Fcdr (Fcar (tail
));
2930 p
= XPROCESS (proc
);
2932 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2934 XSETINT (p
->update_tick
, XINT (p
->tick
));
2936 /* If process is still active, read any output that remains. */
2937 if (XINT (p
->infd
) >= 0)
2938 while (! EQ (p
->filter
, Qt
)
2939 && read_process_output (proc
, XINT (p
->infd
)) > 0);
2943 /* Get the text to use for the message. */
2944 if (!NILP (p
->raw_status_low
))
2946 msg
= status_message (p
->status
);
2948 /* If process is terminated, deactivate it or delete it. */
2950 if (XTYPE (p
->status
) == Lisp_Cons
)
2951 symbol
= XCONS (p
->status
)->car
;
2953 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2954 || EQ (symbol
, Qclosed
))
2956 if (delete_exited_processes
)
2957 remove_process (proc
);
2959 deactivate_process (proc
);
2962 /* Now output the message suitably. */
2963 if (!NILP (p
->sentinel
))
2964 exec_sentinel (proc
, msg
);
2965 /* Don't bother with a message in the buffer
2966 when a process becomes runnable. */
2967 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2969 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2971 struct buffer
*old
= current_buffer
;
2974 /* Avoid error if buffer is deleted
2975 (probably that's why the process is dead, too) */
2976 if (NILP (XBUFFER (buffer
)->name
))
2978 Fset_buffer (buffer
);
2980 /* Insert new output into buffer
2981 at the current end-of-output marker,
2982 thus preserving logical ordering of input and output. */
2983 if (XMARKER (p
->mark
)->buffer
)
2984 SET_PT (marker_position (p
->mark
));
2987 if (point
<= opoint
)
2988 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2990 tem
= current_buffer
->read_only
;
2991 current_buffer
->read_only
= Qnil
;
2992 insert_string ("\nProcess ");
2993 Finsert (1, &p
->name
);
2994 insert_string (" ");
2996 current_buffer
->read_only
= tem
;
2997 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
3000 set_buffer_internal (old
);
3005 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
3006 redisplay_preserve_echo_area ();
3008 update_tick
= process_tick
;
3019 if (! noninteractive
|| initialized
)
3021 signal (SIGCHLD
, sigchld_handler
);
3024 FD_ZERO (&input_wait_mask
);
3026 keyboard_descriptor
= 0;
3027 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3029 Vprocess_alist
= Qnil
;
3030 for (i
= 0; i
< MAXDESC
; i
++)
3032 chan_process
[i
] = Qnil
;
3033 proc_buffered_char
[i
] = -1;
3037 /* From now on, assume keyboard input comes from descriptor DESC. */
3040 change_keyboard_wait_descriptor (desc
)
3043 FD_CLR (keyboard_descriptor
, &input_wait_mask
);
3044 keyboard_descriptor
= desc
;
3045 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3051 stream_process
= intern ("stream");
3053 Qprocessp
= intern ("processp");
3054 staticpro (&Qprocessp
);
3055 Qrun
= intern ("run");
3057 Qstop
= intern ("stop");
3059 Qsignal
= intern ("signal");
3060 staticpro (&Qsignal
);
3062 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3065 Qexit = intern ("exit");
3066 staticpro (&Qexit); */
3068 Qopen
= intern ("open");
3070 Qclosed
= intern ("closed");
3071 staticpro (&Qclosed
);
3073 staticpro (&Vprocess_alist
);
3075 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3076 "*Non-nil means delete processes immediately when they exit.\n\
3077 nil means don't delete them until `list-processes' is run.");
3079 delete_exited_processes
= 1;
3081 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3082 "Control type of device used to communicate with subprocesses.\n\
3083 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3084 pty's are not available, this variable will be ignored. The value takes\n\
3085 effect when `start-process' is called.");
3086 Vprocess_connection_type
= Qt
;
3088 defsubr (&Sprocessp
);
3089 defsubr (&Sget_process
);
3090 defsubr (&Sget_buffer_process
);
3091 defsubr (&Sdelete_process
);
3092 defsubr (&Sprocess_status
);
3093 defsubr (&Sprocess_exit_status
);
3094 defsubr (&Sprocess_id
);
3095 defsubr (&Sprocess_name
);
3096 defsubr (&Sprocess_command
);
3097 defsubr (&Sset_process_buffer
);
3098 defsubr (&Sprocess_buffer
);
3099 defsubr (&Sprocess_mark
);
3100 defsubr (&Sset_process_filter
);
3101 defsubr (&Sprocess_filter
);
3102 defsubr (&Sset_process_sentinel
);
3103 defsubr (&Sprocess_sentinel
);
3104 defsubr (&Sprocess_kill_without_query
);
3105 defsubr (&Slist_processes
);
3106 defsubr (&Sprocess_list
);
3107 defsubr (&Sstart_process
);
3109 defsubr (&Sopen_network_stream
);
3110 #endif /* HAVE_SOCKETS */
3111 defsubr (&Saccept_process_output
);
3112 defsubr (&Sprocess_send_region
);
3113 defsubr (&Sprocess_send_string
);
3114 defsubr (&Sinterrupt_process
);
3115 defsubr (&Skill_process
);
3116 defsubr (&Squit_process
);
3117 defsubr (&Sstop_process
);
3118 defsubr (&Scontinue_process
);
3119 defsubr (&Sprocess_send_eof
);
3120 defsubr (&Ssignal_process
);
3121 defsubr (&Swaiting_for_user_input_p
);
3122 /* defsubr (&Sprocess_connection); */
3126 #else /* not subprocesses */
3128 #include <sys/types.h>
3132 #include "systime.h"
3133 #include "termopts.h"
3135 extern int frame_garbaged
;
3138 /* As described above, except assuming that there are no subprocesses:
3140 Wait for timeout to elapse and/or keyboard input to be available.
3143 timeout in seconds, or
3144 zero for no limit, or
3145 -1 means gobble data immediately available but don't wait for any.
3147 read_kbd is a Lisp_Object:
3148 0 to ignore keyboard input, or
3149 1 to return when input is available, or
3150 -1 means caller will actually read the input, so don't throw to
3152 We know that read_kbd will never be a Lisp_Process, since
3153 `subprocesses' isn't defined.
3155 do_display != 0 means redisplay should be done to show subprocess
3156 output that arrives. This version of the function ignores it.
3158 Return true iff we received input from any process. */
3161 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3162 int time_limit
, microsecs
;
3163 Lisp_Object read_kbd
;
3166 EMACS_TIME end_time
, timeout
, *timeout_p
;
3169 /* What does time_limit really mean? */
3170 if (time_limit
|| microsecs
)
3172 /* It's not infinite. */
3173 timeout_p
= &timeout
;
3175 if (time_limit
== -1)
3176 /* In fact, it's zero. */
3177 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3179 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3181 /* How far in the future is that? */
3182 EMACS_GET_TIME (end_time
);
3183 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3186 /* It's infinite. */
3189 /* This must come before stop_polling. */
3190 prepare_menu_bars ();
3192 /* Turn off periodic alarms (in case they are in use)
3193 because the select emulator uses alarms. */
3200 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3202 /* If calling from keyboard input, do not quit
3203 since we want to return C-g as an input character.
3204 Otherwise, do pending quit if requested. */
3205 if (XINT (read_kbd
) >= 0)
3210 EMACS_GET_TIME (*timeout_p
);
3211 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3212 if (EMACS_TIME_NEG_P (*timeout_p
))
3216 /* Cause C-g and alarm signals to take immediate action,
3217 and cause input available signals to zero out timeout. */
3218 if (XINT (read_kbd
) < 0)
3219 set_waiting_for_input (&timeout
);
3221 /* If a frame has been newly mapped and needs updating,
3222 reprocess its display stuff. */
3224 redisplay_preserve_echo_area ();
3226 if (XINT (read_kbd
) && detect_input_pending ())
3229 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3231 /* Make C-g and alarm signals set flags again */
3232 clear_waiting_for_input ();
3234 /* If we woke up due to SIGWINCH, actually change size now. */
3235 do_pending_window_change ();
3239 /* If the system call was interrupted, then go around the
3245 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3246 /* System sometimes fails to deliver SIGIO. */
3247 kill (getpid (), SIGIO
);
3250 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3254 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3266 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3267 /* Don't confused make-docfile by having two doc strings for this function.
3268 make-docfile does not pay attention to #if, for good reason! */
3271 register Lisp_Object name
;
3276 /* Kill all processes associated with `buffer'.
3277 If `buffer' is nil, kill all processes.
3278 Since we have no subprocesses, this does nothing. */
3280 kill_buffer_processes (buffer
)
3291 defsubr (&Sget_buffer_process
);
3295 #endif /* not subprocesses */