1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1992 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 1, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
25 /* This file is split into two parts by the following preprocessor
26 conditional. The 'then' clause contains all of the support for
27 asynchronous subprocesses. The 'else' clause contains stub
28 versions of some of the asynchronous subprocess routines that are
29 often called elsewhere in Emacs, so we don't have to #ifdef the
30 sections that call them. */
38 #include <sys/types.h> /* some typedefs are used in sys/file.h */
42 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
43 #include <sys/socket.h>
45 #include <netinet/in.h>
46 #include <arpa/inet.h>
47 #endif /* HAVE_SOCKETS */
49 #if defined(BSD) || defined(STRIDE)
50 #include <sys/ioctl.h>
51 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
53 #endif /* HAVE_PTYS and no O_NDELAY */
54 #endif /* BSD or STRIDE */
69 #include <sys/sysmacros.h> /* for "minor" */
79 #include "termhooks.h"
82 #include "dispextern.h"
84 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
85 /* Qexit is declared and initialized in eval.c. */
87 /* a process object is a network connection when its childp field is neither
88 Qt nor Qnil but is instead a string (name of foreign host we
89 are connected to + name of port we are connected to) */
92 static Lisp_Object stream_process
;
94 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
96 #define NETCONN_P(p) 0
97 #endif /* HAVE_SOCKETS */
99 /* Define first descriptor number available for subprocesses. */
101 #define FIRST_PROC_DESC 1
103 #define FIRST_PROC_DESC 3
106 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
109 #if !defined (SIGCHLD) && defined (SIGCLD)
110 #define SIGCHLD SIGCLD
113 #include "syssignal.h"
115 /* Define the structure that the wait system call stores.
116 On many systems, there is a structure defined for this.
117 But on vanilla-ish USG systems there is not. */
121 #if !defined (BSD) && !defined (UNIPLUS) && !defined (STRIDE) && !(defined (HPUX) && !defined (NOMULTIPLEJOBS)) && !defined (HAVE_WAIT_HEADER)
123 #define WIFSTOPPED(w) ((w&0377) == 0177)
124 #define WIFSIGNALED(w) ((w&0377) != 0177 && (w&~0377) == 0)
125 #define WIFEXITED(w) ((w&0377) == 0)
126 #define WRETCODE(w) (w >> 8)
127 #define WSTOPSIG(w) (w >> 8)
128 #define WTERMSIG(w) (w & 0377)
130 #define WCOREDUMP(w) ((w&0200) != 0)
136 #include <sys/wait.h>
137 #endif /* not BSD 4.1 */
139 #define WAITTYPE union wait
140 #define WRETCODE(w) w.w_retcode
141 #define WCOREDUMP(w) w.w_coredump
144 /* HPUX version 7 has broken definitions of these. */
153 #define WTERMSIG(w) w.w_termsig
156 #define WSTOPSIG(w) w.w_stopsig
159 #define WIFSTOPPED(w) (WTERMSIG (w) == 0177)
162 #define WIFSIGNALED(w) (WTERMSIG (w) != 0177 && (WSTOPSIG (w)) == 0)
165 #define WIFEXITED(w) (WTERMSIG (w) == 0)
167 #endif /* BSD or UNIPLUS or STRIDE */
168 #endif /* no WAITTYPE */
171 /* For the CMU PTY driver + */
172 #define DCL_PROMPT "$ "
182 extern char *sys_errlist
[];
186 extern char *sys_siglist
[];
188 char *sys_siglist
[] =
194 "illegal instruction",
198 "floating point exception",
201 "segmentation violation",
202 "bad argument to system call",
203 "write on a pipe with no one to read it",
205 "software termination signal from kill",
207 "sendable stop signal not from tty",
208 "stop signal from tty",
209 "continue a stopped process",
210 "child status has changed",
211 "background read attempted from control tty",
212 "background write attempted from control tty",
213 "input record available at control tty",
214 "exceeded CPU time limit",
215 "exceeded file size limit"
223 extern int comm_server
;
224 extern int net_listen_address
;
227 /* t means use pty, nil means use a pipe,
228 maybe other values to come. */
229 Lisp_Object Vprocess_connection_type
;
233 #include <sys/socket.h>
237 /* Number of events of change of status of a process. */
240 /* Number of events for which the user or sentinel has been notified. */
244 /* We could get this from param.h, but better not to depend on finding that.
245 And better not to risk that it might define other symbols used in this
248 #define SELECT_TYPE fd_set
249 #else /* no FD_SET */
251 #define SELECT_TYPE int
253 /* Define the macros to access a single-int bitmap of descriptors. */
254 #define FD_SET(n, p) (*(p) |= (1 << (n)))
255 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
256 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
257 #define FD_ZERO(p) (*(p) = 0)
258 #endif /* no FD_SET */
260 /* Mask of bits indicating the descriptors that we wait for input on */
262 SELECT_TYPE input_wait_mask
;
264 int delete_exited_processes
;
266 /* Indexed by descriptor, gives the process (if any) for that descriptor */
267 Lisp_Object chan_process
[MAXDESC
];
269 /* Alist of elements (NAME . PROCESS) */
270 Lisp_Object Vprocess_alist
;
272 Lisp_Object Qprocessp
;
274 Lisp_Object
get_process ();
276 /* Buffered-ahead input char from process, indexed by channel.
277 -1 means empty (no char is buffered).
278 Used on sys V where the only way to tell if there is any
279 output from the process is to read at least one char.
280 Always -1 on systems that support FIONREAD. */
282 int proc_buffered_char
[MAXDESC
];
284 /* Compute the Lisp form of the process status, p->status, from
285 the numeric status that was returned by `wait'. */
288 struct Lisp_Process
*p
;
290 union { int i
; WAITTYPE wt
; } u
;
291 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
292 p
->status
= status_convert (u
.wt
);
293 p
->raw_status_low
= Qnil
;
294 p
->raw_status_high
= Qnil
;
297 /* Convert a process status work in Unix format to
298 the list that we use internally. */
305 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
306 else if (WIFEXITED (w
))
307 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
308 WCOREDUMP (w
) ? Qt
: Qnil
));
309 else if (WIFSIGNALED (w
))
310 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
311 WCOREDUMP (w
) ? Qt
: Qnil
));
316 /* Given a status-list, extract the three pieces of information
317 and store them individually through the three pointers. */
320 decode_status (l
, symbol
, code
, coredump
)
328 if (XTYPE (l
) == Lisp_Symbol
)
336 *symbol
= XCONS (l
)->car
;
337 tem
= XCONS (l
)->cdr
;
338 *code
= XFASTINT (XCONS (tem
)->car
);
339 tem
= XFASTINT (XCONS (tem
)->cdr
);
340 *coredump
= !NILP (tem
);
344 /* Return a string describing a process status list. */
347 status_message (status
)
352 Lisp_Object string
, string2
;
354 decode_status (status
, &symbol
, &code
, &coredump
);
356 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
358 string
= build_string (code
< NSIG
? sys_siglist
[code
] : "unknown");
359 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
360 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
361 return concat2 (string
, string2
);
363 else if (EQ (symbol
, Qexit
))
366 return build_string ("finished\n");
367 string
= Fint_to_string (make_number (code
));
368 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
369 return concat2 (build_string ("exited abnormally with code "),
370 concat2 (string
, string2
));
373 return Fcopy_sequence (Fsymbol_name (symbol
));
377 static int pty_process
;
379 /* Open an available pty, returning a file descriptor.
380 Return -1 on failure.
381 The file name of the terminal corresponding to the pty
382 is left in the variable pty_name. */
393 /* Some systems name their pseudoterminals so that there are gaps in
394 the usual sequence - for example, on HP9000/S700 systems, there
395 are no pseudoterminals with names ending in 'f'. So we wait for
396 three failures in a row before deciding that we've reached the
398 int failed_count
= 0;
403 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
404 for (i
= 0; i
< 16; i
++)
407 #ifdef PTY_NAME_SPRINTF
410 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
411 #endif /* no PTY_NAME_SPRINTF */
415 #else /* no PTY_OPEN */
417 /* Unusual IRIS code */
418 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
421 if (fstat (fd
, &stb
) < 0)
424 if (stat (pty_name
, &stb
) < 0)
427 if (failed_count
>= 3)
433 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
435 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
437 #endif /* not IRIS */
438 #endif /* no PTY_OPEN */
442 /* check to make certain that both sides are available
443 this avoids a nasty yet stupid bug in rlogins */
444 #ifdef PTY_TTY_NAME_SPRINTF
447 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
448 #endif /* no PTY_TTY_NAME_SPRINTF */
450 if (access (pty_name
, 6) != 0)
459 #endif /* not UNIPLUS */
466 #endif /* HAVE_PTYS */
472 register Lisp_Object val
, tem
, name1
;
473 register struct Lisp_Process
*p
;
477 /* size of process structure includes the vector header,
478 so deduct for that. But struct Lisp_Vector includes the first
479 element, thus deducts too much, so add it back. */
480 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
481 - sizeof (struct Lisp_Vector
)
482 + sizeof (Lisp_Object
))
483 / sizeof (Lisp_Object
)),
485 XSETTYPE (val
, Lisp_Process
);
488 XFASTINT (p
->infd
) = 0;
489 XFASTINT (p
->outfd
) = 0;
490 XFASTINT (p
->pid
) = 0;
491 XFASTINT (p
->tick
) = 0;
492 XFASTINT (p
->update_tick
) = 0;
493 p
->raw_status_low
= Qnil
;
494 p
->raw_status_high
= Qnil
;
496 p
->mark
= Fmake_marker ();
498 /* If name is already in use, modify it until it is unused. */
503 tem
= Fget_process (name1
);
504 if (NILP (tem
)) break;
505 sprintf (suffix
, "<%d>", i
);
506 name1
= concat2 (name
, build_string (suffix
));
510 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
514 remove_process (proc
)
515 register Lisp_Object proc
;
517 register Lisp_Object pair
;
519 pair
= Frassq (proc
, Vprocess_alist
);
520 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
521 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
523 deactivate_process (proc
);
526 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
527 "Return t if OBJECT is a process.")
531 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
534 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
535 "Return the process named NAME, or nil if there is none.")
537 register Lisp_Object name
;
539 if (XTYPE (name
) == Lisp_Process
)
541 CHECK_STRING (name
, 0);
542 return Fcdr (Fassoc (name
, Vprocess_alist
));
545 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
546 "Return the (or, a) process associated with BUFFER.\n\
547 BUFFER may be a buffer or the name of one.")
549 register Lisp_Object name
;
551 register Lisp_Object buf
, tail
, proc
;
553 if (NILP (name
)) return Qnil
;
554 buf
= Fget_buffer (name
);
555 if (NILP (buf
)) return Qnil
;
557 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
559 proc
= Fcdr (Fcar (tail
));
560 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
566 /* This is how commands for the user decode process arguments. It
567 accepts a process, a process name, a buffer, a buffer name, or nil.
568 Buffers denote the first process in the buffer, and nil denotes the
573 register Lisp_Object name
;
575 register Lisp_Object proc
;
577 proc
= Fget_buffer_process (Fcurrent_buffer ());
580 proc
= Fget_process (name
);
582 proc
= Fget_buffer_process (Fget_buffer (name
));
589 error ("Current buffer has no process");
591 error ("Process %s does not exist", XSTRING (name
)->data
);
595 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
596 "Delete PROCESS: kill it and forget about it immediately.\n\
597 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
598 nil, indicating the current buffer's process.")
600 register Lisp_Object proc
;
602 proc
= get_process (proc
);
603 XPROCESS (proc
)->raw_status_low
= Qnil
;
604 XPROCESS (proc
)->raw_status_high
= Qnil
;
605 if (NETCONN_P (proc
))
607 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
608 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
610 else if (XFASTINT (XPROCESS (proc
)->infd
))
612 Fkill_process (proc
, Qnil
);
613 /* Do this now, since remove_process will make sigchld_handler do nothing. */
614 XPROCESS (proc
)->status
615 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
616 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
619 remove_process (proc
);
623 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
624 "Return the status of PROCESS: a symbol, one of these:\n\
625 run -- for a process that is running.\n\
626 stop -- for a process stopped but continuable.\n\
627 exit -- for a process that has exited.\n\
628 signal -- for a process that has got a fatal signal.\n\
629 open -- for a network stream connection that is open.\n\
630 closed -- for a network stream connection that is closed.\n\
631 nil -- if arg is a process name and no such process exists.\n\
632 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
633 nil, indicating the current buffer's process.")
634 /* command -- for a command channel opened to Emacs by another process.\n\
635 external -- for an i/o channel opened to Emacs by another process.\n\ */
637 register Lisp_Object proc
;
639 register struct Lisp_Process
*p
;
640 register Lisp_Object status
;
641 proc
= get_process (proc
);
645 if (!NILP (p
->raw_status_low
))
648 if (XTYPE (status
) == Lisp_Cons
)
649 status
= XCONS (status
)->car
;
650 if (NETCONN_P (proc
))
652 if (EQ (status
, Qrun
))
654 else if (EQ (status
, Qexit
))
660 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
662 "Return the exit status of PROCESS or the signal number that killed it.\n\
663 If PROCESS has not yet exited or died, return 0.")
665 register Lisp_Object proc
;
667 CHECK_PROCESS (proc
, 0);
668 if (!NILP (XPROCESS (proc
)->raw_status_low
))
669 update_status (XPROCESS (proc
));
670 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
671 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
672 return make_number (0);
675 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
676 "Return the process id of PROCESS.\n\
677 This is the pid of the Unix process which PROCESS uses or talks to.\n\
678 For a network connection, this value is nil.")
680 register Lisp_Object proc
;
682 CHECK_PROCESS (proc
, 0);
683 return XPROCESS (proc
)->pid
;
686 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
687 "Return the name of PROCESS, as a string.\n\
688 This is the name of the program invoked in PROCESS,\n\
689 possibly modified to make it unique among process names.")
691 register Lisp_Object proc
;
693 CHECK_PROCESS (proc
, 0);
694 return XPROCESS (proc
)->name
;
697 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
698 "Return the command that was executed to start PROCESS.\n\
699 This is a list of strings, the first string being the program executed\n\
700 and the rest of the strings being the arguments given to it.\n\
701 For a non-child channel, this is nil.")
703 register Lisp_Object proc
;
705 CHECK_PROCESS (proc
, 0);
706 return XPROCESS (proc
)->command
;
709 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
711 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
713 register Lisp_Object proc
, buffer
;
715 CHECK_PROCESS (proc
, 0);
717 CHECK_BUFFER (buffer
, 1);
718 XPROCESS (proc
)->buffer
= buffer
;
722 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
724 "Return the buffer PROCESS is associated with.\n\
725 Output from PROCESS is inserted in this buffer\n\
726 unless PROCESS has a filter.")
728 register Lisp_Object proc
;
730 CHECK_PROCESS (proc
, 0);
731 return XPROCESS (proc
)->buffer
;
734 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
736 "Return the marker for the end of the last output from PROCESS.")
738 register Lisp_Object proc
;
740 CHECK_PROCESS (proc
, 0);
741 return XPROCESS (proc
)->mark
;
744 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
746 "Give PROCESS the filter function FILTER; nil means no filter.\n\
747 When a process has a filter, each time it does output\n\
748 the entire string of output is passed to the filter.\n\
749 The filter gets two arguments: the process and the string of output.\n\
750 If the process has a filter, its buffer is not used for output.")
752 register Lisp_Object proc
, filter
;
754 CHECK_PROCESS (proc
, 0);
755 XPROCESS (proc
)->filter
= filter
;
759 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
761 "Returns the filter function of PROCESS; nil if none.\n\
762 See `set-process-filter' for more info on filter functions.")
764 register Lisp_Object proc
;
766 CHECK_PROCESS (proc
, 0);
767 return XPROCESS (proc
)->filter
;
770 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
772 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
773 The sentinel is called as a function when the process changes state.\n\
774 It gets two arguments: the process, and a string describing the change.")
776 register Lisp_Object proc
, sentinel
;
778 CHECK_PROCESS (proc
, 0);
779 XPROCESS (proc
)->sentinel
= sentinel
;
783 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
785 "Return the sentinel of PROCESS; nil if none.\n\
786 See `set-process-sentinel' for more info on sentinels.")
788 register Lisp_Object proc
;
790 CHECK_PROCESS (proc
, 0);
791 return XPROCESS (proc
)->sentinel
;
794 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
795 Sprocess_kill_without_query
, 1, 2, 0,
796 "Say no query needed if PROCESS is running when Emacs is exited.\n\
797 Optional second argument if non-nill says to require a query.\n\
798 Value is t if a query was formerly required.")
800 register Lisp_Object proc
, value
;
804 CHECK_PROCESS (proc
, 0);
805 tem
= XPROCESS (proc
)->kill_without_query
;
806 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
814 register Lisp_Object tail
, tem
;
815 Lisp_Object proc
, minspace
, tem1
;
816 register struct buffer
*old
= current_buffer
;
817 register struct Lisp_Process
*p
;
821 XFASTINT (minspace
) = 1;
823 set_buffer_internal (XBUFFER (Vstandard_output
));
824 Fbuffer_disable_undo (Vstandard_output
);
826 current_buffer
->truncate_lines
= Qt
;
829 Proc Status Buffer Command\n\
830 ---- ------ ------ -------\n", -1);
832 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
836 proc
= Fcdr (Fcar (tail
));
838 if (NILP (p
->childp
))
841 Finsert (1, &p
->name
);
842 Findent_to (make_number (13), minspace
);
844 if (!NILP (p
->raw_status_low
))
847 if (XTYPE (p
->status
) == Lisp_Cons
)
848 symbol
= XCONS (p
->status
)->car
;
851 if (EQ (symbol
, Qsignal
))
854 tem
= Fcar (Fcdr (p
->status
));
856 if (XINT (tem
) < NSIG
)
857 write_string (sys_siglist
[XINT (tem
)], -1);
860 Fprinc (symbol
, Qnil
);
862 else if (NETCONN_P (proc
))
864 if (EQ (symbol
, Qrun
))
865 write_string ("open", -1);
866 else if (EQ (symbol
, Qexit
))
867 write_string ("closed", -1);
869 Fprinc (symbol
, Qnil
);
872 Fprinc (symbol
, Qnil
);
874 if (EQ (symbol
, Qexit
))
877 tem
= Fcar (Fcdr (p
->status
));
880 sprintf (tembuf
, " %d", XFASTINT (tem
));
881 write_string (tembuf
, -1);
885 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
886 remove_process (proc
);
888 Findent_to (make_number (22), minspace
);
889 if (NILP (p
->buffer
))
890 insert_string ("(none)");
891 else if (NILP (XBUFFER (p
->buffer
)->name
))
892 insert_string ("(Killed)");
894 Finsert (1, &XBUFFER (p
->buffer
)->name
);
896 Findent_to (make_number (37), minspace
);
898 if (NETCONN_P (proc
))
900 sprintf (tembuf
, "(network stream connection to %s)\n",
901 XSTRING (p
->childp
)->data
);
902 insert_string (tembuf
);
916 insert_string ("\n");
922 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
923 "Display a list of all processes.\n\
924 \(Any processes listed as Exited or Signaled are actually eliminated\n\
925 after the listing is made.)")
928 internal_with_output_to_temp_buffer ("*Process List*",
929 list_processes_1
, Qnil
);
933 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
934 "Return a list of all processes.")
937 return Fmapcar (Qcdr
, Vprocess_alist
);
940 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
941 "Start a program in a subprocess. Return the process object for it.\n\
942 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
943 NAME is name for process. It is modified if necessary to make it unique.\n\
944 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
945 Process output goes at end of that buffer, unless you specify\n\
946 an output stream or filter function to handle the output.\n\
947 BUFFER may be also nil, meaning that this process is not associated\n\
949 Third arg is program file name. It is searched for as in the shell.\n\
950 Remaining arguments are strings to give program as arguments.")
953 register Lisp_Object
*args
;
955 Lisp_Object buffer
, name
, program
, proc
, tem
;
957 register unsigned char *new_argv
;
960 register unsigned char **new_argv
;
966 buffer
= Fget_buffer_create (buffer
);
969 CHECK_STRING (name
, 0);
973 CHECK_STRING (program
, 2);
976 /* Make a one member argv with all args concatenated
977 together separated by a blank. */
978 len
= XSTRING (program
)->size
+ 2;
979 for (i
= 3; i
< nargs
; i
++)
982 CHECK_STRING (tem
, i
);
983 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
985 new_argv
= (unsigned char *) alloca (len
);
986 strcpy (new_argv
, XSTRING (program
)->data
);
987 for (i
= 3; i
< nargs
; i
++)
990 CHECK_STRING (tem
, i
);
991 strcat (new_argv
, " ");
992 strcat (new_argv
, XSTRING (tem
)->data
);
995 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
997 for (i
= 3; i
< nargs
; i
++)
1000 CHECK_STRING (tem
, i
);
1001 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1003 new_argv
[i
- 2] = 0;
1004 new_argv
[0] = XSTRING (program
)->data
;
1006 /* If program file name is not absolute, search our path for it */
1007 if (new_argv
[0][0] != '/')
1010 openp (Vexec_path
, program
, "", &tem
, 1);
1012 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1013 new_argv
[0] = XSTRING (tem
)->data
;
1015 #endif /* not VMS */
1017 proc
= make_process (name
);
1019 XPROCESS (proc
)->childp
= Qt
;
1020 XPROCESS (proc
)->command_channel_p
= Qnil
;
1021 XPROCESS (proc
)->buffer
= buffer
;
1022 XPROCESS (proc
)->sentinel
= Qnil
;
1023 XPROCESS (proc
)->filter
= Qnil
;
1024 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1026 create_process (proc
, new_argv
);
1032 create_process_1 (signo
)
1036 /* USG systems forget handlers when they are used;
1037 must reestablish each time */
1038 signal (signo
, create_process_1
);
1042 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1045 /* Mimic blocking of signals on system V, which doesn't really have it. */
1047 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1048 int sigchld_deferred
;
1051 create_process_sigchld ()
1053 signal (SIGCHLD
, create_process_sigchld
);
1055 sigchld_deferred
= 1;
1061 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1062 create_process (process
, new_argv
)
1063 Lisp_Object process
;
1066 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1069 SIGTYPE (*sigchld
)();
1072 Lisp_Object current_dir
;
1073 extern char **environ
;
1075 inchannel
= outchannel
= -1;
1078 if (EQ (Vprocess_connection_type
, Qt
))
1079 outchannel
= inchannel
= allocate_pty ();
1081 /* Make sure that the child will be able to chdir to the current
1082 buffer's current directory. We can't just have the child check
1083 for an error when it does the chdir, since it's in a vfork. */
1084 current_dir
= expand_and_dir_to_file (current_buffer
->directory
, Qnil
);
1085 if (NILP (Ffile_accessible_directory_p (current_dir
)))
1086 report_file_error ("Setting current directory",
1087 Fcons (current_buffer
->directory
, Qnil
));
1092 /* On USG systems it does not work to open the pty's tty here
1093 and then close and reopen it in the child. */
1095 /* Don't let this terminal become our controlling terminal
1096 (in case we don't have one). */
1097 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1099 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1102 report_file_error ("Opening pty", Qnil
);
1104 forkin
= forkout
= -1;
1105 #endif /* not USG */
1109 #endif /* HAVE_PTYS */
1112 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1113 report_file_error ("Opening socketpair", Qnil
);
1114 outchannel
= inchannel
= sv
[0];
1115 forkout
= forkin
= sv
[1];
1117 #else /* not SKTPAIR */
1126 #endif /* not SKTPAIR */
1129 /* Replaced by close_process_descs */
1130 set_exclusive_use (inchannel
);
1131 set_exclusive_use (outchannel
);
1134 /* Stride people say it's a mystery why this is needed
1135 as well as the O_NDELAY, but that it fails without this. */
1136 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1139 ioctl (inchannel
, FIONBIO
, &one
);
1144 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1147 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1151 /* Record this as an active process, with its channels.
1152 As a result, child_setup will close Emacs's side of the pipes. */
1153 chan_process
[inchannel
] = process
;
1154 XFASTINT (XPROCESS (process
)->infd
) = inchannel
;
1155 XFASTINT (XPROCESS (process
)->outfd
) = outchannel
;
1156 /* Record the tty descriptor used in the subprocess. */
1158 XPROCESS (process
)->subtty
= Qnil
;
1160 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1161 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1162 XPROCESS (process
)->status
= Qrun
;
1164 /* Delay interrupts until we have a chance to store
1165 the new fork's pid in its process structure */
1169 #else /* not BSD4_1 */
1170 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1171 sigsetmask (sigmask (SIGCHLD
));
1172 #else /* ordinary USG */
1174 sigchld_deferred
= 0;
1175 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1177 #endif /* ordinary USG */
1178 #endif /* not BSD4_1 */
1179 #endif /* SIGCHLD */
1181 /* Until we store the proper pid, enable sigchld_handler
1182 to recognize an unknown pid as standing for this process.
1183 It is very important not to let this `marker' value stay
1184 in the table after this function has returned; if it does
1185 it might cause call-process to hang and subsequent asynchronous
1186 processes to get their return values scrambled. */
1187 XSETINT (XPROCESS (process
)->pid
, -1);
1190 /* child_setup must clobber environ on systems with true vfork.
1191 Protect it from permanent change. */
1192 char **save_environ
= environ
;
1197 int xforkin
= forkin
;
1198 int xforkout
= forkout
;
1200 #if 0 /* This was probably a mistake--it duplicates code later on,
1201 but fails to handle all the cases. */
1202 /* Make sure SIGCHLD is not blocked in the child. */
1203 sigsetmask (SIGEMPTYMASK
);
1206 /* Make the pty be the controlling terminal of the process. */
1208 /* First, disconnect its current controlling terminal. */
1212 /* Make the pty's terminal the controlling terminal. */
1213 if (pty_flag
&& (ioctl (xforkin
, TIOCSCTTY
, 0) < 0))
1216 #else /* not HAVE_SETSID */
1218 /* It's very important to call setpgrp() here and no time
1219 afterwards. Otherwise, we lose our controlling tty which
1220 is set when we open the pty. */
1223 #endif /* not HAVE_SETSID */
1225 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1226 can do TIOCSPGRP only to the process's controlling tty. */
1229 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1230 I can't test it since I don't have 4.3. */
1231 int j
= open ("/dev/tty", O_RDWR
, 0);
1232 ioctl (j
, TIOCNOTTY
, 0);
1235 /* In order to get a controlling terminal on some versions
1236 of BSD, it is necessary to put the process in pgrp 0
1237 before it opens the terminal. */
1241 #endif /* TIOCNOTTY */
1243 #if !defined (RTU) && !defined (UNIPLUS)
1244 /*** There is a suggestion that this ought to be a
1245 conditional on TIOCSPGRP. */
1246 /* Now close the pty (if we had it open) and reopen it.
1247 This makes the pty the controlling terminal of the subprocess. */
1250 /* I wonder if close (open (pty_name, ...)) would work? */
1253 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1258 #endif /* not UNIPLUS and not RTU */
1259 #ifdef SETUP_SLAVE_PTY
1261 #endif /* SETUP_SLAVE_PTY */
1263 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1264 Now reenable it in the child, so it will die when we want it to. */
1266 signal (SIGHUP
, SIG_DFL
);
1268 #endif /* HAVE_PTYS */
1273 #else /* not BSD4_1 */
1274 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1275 sigsetmask (SIGEMPTYMASK
);
1276 #else /* ordinary USG */
1278 signal (SIGCHLD
, sigchld
);
1280 #endif /* ordinary USG */
1281 #endif /* not BSD4_1 */
1282 #endif /* SIGCHLD */
1284 child_setup_tty (xforkout
);
1285 child_setup (xforkin
, xforkout
, xforkout
,
1286 new_argv
, 1, current_dir
);
1288 environ
= save_environ
;
1293 remove_process (process
);
1294 report_file_error ("Doing vfork", Qnil
);
1297 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1299 FD_SET (inchannel
, &input_wait_mask
);
1301 /* If the subfork execv fails, and it exits,
1302 this close hangs. I don't know why.
1303 So have an interrupt jar it loose. */
1305 signal (SIGALRM
, create_process_1
);
1308 /* OK to close only if it's not a pty. Otherwise we need to leave
1309 it open for ioctl to get pgrp when signals are sent, or to send
1310 the interrupt characters through if that's how we're signalling
1311 subprocesses. Alternately if you are concerned about running out
1312 of file descriptors, you could just save the tty name and open
1313 just to do the ioctl. */
1314 if (NILP (XFASTINT (XPROCESS (process
)->pty_flag
)))
1317 XPROCESS (process
)->subtty
= Qnil
;
1323 if (forkin
!= forkout
&& forkout
>= 0)
1329 #else /* not BSD4_1 */
1330 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1331 sigsetmask (SIGEMPTYMASK
);
1332 #else /* ordinary USG */
1334 signal (SIGCHLD
, sigchld
);
1335 /* Now really handle any of these signals
1336 that came in during this function. */
1337 if (sigchld_deferred
)
1338 kill (getpid (), SIGCHLD
);
1340 #endif /* ordinary USG */
1341 #endif /* not BSD4_1 */
1342 #endif /* SIGCHLD */
1344 #endif /* not VMS */
1348 /* open a TCP network connection to a given HOST/SERVICE. Treated
1349 exactly like a normal process when reading and writing. Only
1350 differences are in status display and process deletion. A network
1351 connection has no PID; you cannot signal it. All you can do is
1352 deactivate and close it via delete-process */
1354 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1356 "Open a TCP connection for a service to a host.\n\
1357 Returns a subprocess-object to represent the connection.\n\
1358 Input and output work as for subprocesses; `delete-process' closes it.\n\
1359 Args are NAME BUFFER HOST SERVICE.\n\
1360 NAME is name for process. It is modified if necessary to make it unique.\n\
1361 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1362 Process output goes at end of that buffer, unless you specify\n\
1363 an output stream or filter function to handle the output.\n\
1364 BUFFER may be also nil, meaning that this process is not associated\n\
1366 Third arg is name of the host to connect to, or its IP address.\n\
1367 Fourth arg SERVICE is name of the service desired, or an integer\n\
1368 specifying a port number to connect to.")
1369 (name
, buffer
, host
, service
)
1370 Lisp_Object name
, buffer
, host
, service
;
1374 struct sockaddr_in address
;
1375 struct servent
*svc_info
;
1376 struct hostent
*host_info_ptr
, host_info
;
1377 char *(addr_list
[2]);
1378 unsigned long numeric_addr
;
1382 struct hostent host_info_fixed
;
1383 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1385 GCPRO4 (name
, buffer
, host
, service
);
1386 CHECK_STRING (name
, 0);
1387 CHECK_STRING (host
, 0);
1388 if (XTYPE(service
) == Lisp_Int
)
1389 port
= htons ((unsigned short) XINT (service
));
1392 CHECK_STRING (service
, 0);
1393 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1395 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1396 port
= svc_info
->s_port
;
1399 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1400 if (host_info_ptr
== 0)
1401 /* Attempt to interpret host as numeric inet address */
1403 numeric_addr
= inet_addr (XSTRING (host
)->data
);
1404 if (numeric_addr
== -1)
1405 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1407 host_info_ptr
= &host_info
;
1408 host_info
.h_name
= 0;
1409 host_info
.h_aliases
= 0;
1410 host_info
.h_addrtype
= AF_INET
;
1411 host_info
.h_addr_list
= &(addr_list
[0]);
1412 addr_list
[0] = (char*)(&numeric_addr
);
1414 host_info
.h_length
= strlen (addr_list
[0]);
1417 bzero (&address
, sizeof address
);
1418 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1419 host_info_ptr
->h_length
);
1420 address
.sin_family
= host_info_ptr
->h_addrtype
;
1421 address
.sin_port
= port
;
1423 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1425 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1428 if (connect (s
, &address
, sizeof address
) == -1)
1435 report_file_error ("connection failed",
1436 Fcons (host
, Fcons (name
, Qnil
)));
1442 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1445 buffer
= Fget_buffer_create (buffer
);
1446 proc
= make_process (name
);
1448 chan_process
[inch
] = proc
;
1451 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1454 fcntl (inch
, F_SETFL
, O_NDELAY
);
1458 XPROCESS (proc
)->childp
= host
;
1459 XPROCESS (proc
)->command_channel_p
= Qnil
;
1460 XPROCESS (proc
)->buffer
= buffer
;
1461 XPROCESS (proc
)->sentinel
= Qnil
;
1462 XPROCESS (proc
)->filter
= Qnil
;
1463 XPROCESS (proc
)->command
= Qnil
;
1464 XPROCESS (proc
)->pid
= Qnil
;
1465 XFASTINT (XPROCESS (proc
)->infd
) = s
;
1466 XFASTINT (XPROCESS (proc
)->outfd
) = outch
;
1467 XPROCESS (proc
)->status
= Qrun
;
1468 FD_SET (inch
, &input_wait_mask
);
1473 #endif /* HAVE_SOCKETS */
1475 deactivate_process (proc
)
1478 register int inchannel
, outchannel
;
1479 register struct Lisp_Process
*p
= XPROCESS (proc
);
1481 inchannel
= XFASTINT (p
->infd
);
1482 outchannel
= XFASTINT (p
->outfd
);
1486 /* Beware SIGCHLD hereabouts. */
1487 flush_pending_output (inchannel
);
1490 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1491 sys$
dassgn (outchannel
);
1492 vs
= get_vms_process_pointer (p
->pid
)
1494 give_back_vms_process_stuff (vs
);
1498 if (outchannel
&& outchannel
!= inchannel
)
1502 XFASTINT (p
->infd
) = 0;
1503 XFASTINT (p
->outfd
) = 0;
1504 chan_process
[inchannel
] = Qnil
;
1505 FD_CLR (inchannel
, &input_wait_mask
);
1509 /* Close all descriptors currently in use for communication
1510 with subprocess. This is used in a newly-forked subprocess
1511 to get rid of irrelevant descriptors. */
1513 close_process_descs ()
1516 for (i
= 0; i
< MAXDESC
; i
++)
1518 Lisp_Object process
;
1519 process
= chan_process
[i
];
1520 if (!NILP (process
))
1522 int in
= XFASTINT (XPROCESS (process
)->infd
);
1523 int out
= XFASTINT (XPROCESS (process
)->outfd
);
1526 if (out
&& in
!= out
)
1532 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1534 "Allow any pending output from subprocesses to be read by Emacs.\n\
1535 It is read into the process' buffers or given to their filter functions.\n\
1536 Non-nil arg PROCESS means do not return until some output has been received\n\
1538 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1539 seconds and microseconds to wait; return after that much time whether\n\
1540 or not there is input.\n\
1541 Return non-nil iff we received any output before the timeout expired.")
1542 (proc
, timeout
, timeout_msecs
)
1543 register Lisp_Object proc
, timeout
, timeout_msecs
;
1548 if (! NILP (timeout_msecs
))
1550 CHECK_NUMBER (timeout_msecs
, 2);
1551 useconds
= XINT (timeout_msecs
);
1552 if (XTYPE (timeout
) != Lisp_Int
)
1553 XSET (timeout
, Lisp_Int
, 0);
1556 int carry
= useconds
/ 1000000;
1558 XSETINT (timeout
, XINT (timeout
) + carry
);
1559 useconds
-= carry
* 1000000;
1561 /* I think this clause is necessary because C doesn't
1562 guarantee a particular rounding direction for negative
1566 XSETINT (timeout
, XINT (timeout
) - 1);
1567 useconds
+= 1000000;
1574 if (! NILP (timeout
))
1576 CHECK_NUMBER (timeout
, 1);
1577 seconds
= XINT (timeout
);
1590 XFASTINT (proc
) = 0;
1593 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1597 /* This variable is different from waiting_for_input in keyboard.c.
1598 It is used to communicate to a lisp process-filter/sentinel (via the
1599 function Fwaiting_for_user_input_p below) whether emacs was waiting
1600 for user-input when that process-filter was called.
1601 waiting_for_input cannot be used as that is by definition 0 when
1602 lisp code is being evalled */
1603 static int waiting_for_user_input_p
;
1605 /* Read and dispose of subprocess output while waiting for timeout to
1606 elapse and/or keyboard input to be available.
1609 timeout in seconds, or
1610 zero for no limit, or
1611 -1 means gobble data immediately available but don't wait for any.
1613 read_kbd is a lisp value:
1614 0 to ignore keyboard input, or
1615 1 to return when input is available, or
1616 -1 means caller will actually read the input, so don't throw to
1617 the quit handler, or
1618 a process object, meaning wait until something arrives from that
1619 process. The return value is true iff we read some input from
1622 do_display != 0 means redisplay should be done to show subprocess
1623 output that arrives.
1625 If read_kbd is a pointer to a struct Lisp_Process, then the
1626 function returns true iff we received input from that process
1627 before the timeout elapsed.
1628 Otherwise, return true iff we recieved input from any process. */
1630 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1631 int time_limit
, microsecs
;
1632 Lisp_Object read_kbd
;
1635 register int channel
, nfds
, m
;
1636 static SELECT_TYPE Available
;
1639 EMACS_TIME timeout
, end_time
, garbage
;
1641 int wait_channel
= 0;
1642 struct Lisp_Process
*wait_proc
= 0;
1643 int got_some_input
= 0;
1645 FD_ZERO (&Available
);
1647 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1649 if (XTYPE (read_kbd
) == Lisp_Process
)
1651 wait_proc
= XPROCESS (read_kbd
);
1652 wait_channel
= XFASTINT (wait_proc
->infd
);
1653 XFASTINT (read_kbd
) = 0;
1656 waiting_for_user_input_p
= XINT (read_kbd
);
1658 /* Since we may need to wait several times,
1659 compute the absolute time to return at. */
1660 if (time_limit
|| microsecs
)
1662 EMACS_GET_TIME (end_time
);
1663 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1664 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1669 /* If calling from keyboard input, do not quit
1670 since we want to return C-g as an input character.
1671 Otherwise, do pending quit if requested. */
1672 if (XINT (read_kbd
) >= 0)
1675 /* If status of something has changed, and no input is available,
1676 notify the user of the change right away */
1677 if (update_tick
!= process_tick
&& do_display
)
1679 Atemp
= input_wait_mask
;
1680 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1681 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1685 /* Don't wait for output from a non-running process. */
1686 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1687 update_status (wait_proc
);
1689 && ! EQ (wait_proc
->status
, Qrun
))
1692 /* Compute time from now till when time limit is up */
1693 /* Exit if already run out */
1694 if (time_limit
== -1)
1696 /* -1 specified for timeout means
1697 gobble output available now
1698 but don't wait at all. */
1700 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1702 else if (time_limit
|| microsecs
)
1704 EMACS_GET_TIME (timeout
);
1705 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1706 if (EMACS_TIME_NEG_P (timeout
))
1711 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1714 /* Cause C-g and alarm signals to take immediate action,
1715 and cause input available signals to zero out timeout */
1716 if (XINT (read_kbd
) < 0)
1717 set_waiting_for_input (&timeout
);
1719 /* Wait till there is something to do */
1721 Available
= input_wait_mask
;
1722 if (! XINT (read_kbd
))
1723 FD_CLR (0, &Available
);
1725 /* If frame size has changed or the window is newly mapped,
1726 redisplay now, before we start to wait. There is a race
1727 condition here; if a SIGIO arrives between now and the select
1728 and indicates that a frame is trashed, we lose. */
1730 redisplay_preserve_echo_area ();
1732 if (XINT (read_kbd
) && detect_input_pending ())
1735 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1739 /* Make C-g and alarm signals set flags again */
1740 clear_waiting_for_input ();
1742 /* If we woke up due to SIGWINCH, actually change size now. */
1743 do_pending_window_change ();
1745 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1749 if (xerrno
== EINTR
)
1750 FD_ZERO (&Available
);
1752 /* Ultrix select seems to return ENOMEM when it is interrupted.
1753 Treat it just like EINTR. Bleah. -JimB */
1754 else if (xerrno
== ENOMEM
)
1755 FD_ZERO (&Available
);
1758 /* This happens for no known reason on ALLIANT.
1759 I am guessing that this is the right response. -- RMS. */
1760 else if (xerrno
== EFAULT
)
1761 FD_ZERO (&Available
);
1763 else if (xerrno
== EBADF
)
1766 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1767 the child's closure of the pts gives the parent a SIGHUP, and
1768 the ptc file descriptor is automatically closed,
1769 yielding EBADF here or at select() call above.
1770 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1771 in m-ibmrt-aix.h), and here we just ignore the select error.
1772 Cleanup occurs c/o status_notify after SIGCLD. */
1773 FD_ZERO (&Available
); /* Cannot depend on values returned */
1779 error("select error: %s", sys_errlist
[xerrno
]);
1782 else if (nfds
> 0 && FD_ISSET (0, &Available
) && interrupt_input
)
1783 /* System sometimes fails to deliver SIGIO. */
1784 kill (getpid (), SIGIO
);
1787 /* Check for keyboard input */
1788 /* If there is any, return immediately
1789 to give it higher priority than subprocesses */
1791 if (XINT (read_kbd
) && detect_input_pending ())
1795 /* If we think we have keyboard input waiting, but didn't get SIGIO
1796 go read it. This can happen with X on BSD after logging out.
1797 In that case, there really is no input and no SIGIO,
1798 but select says there is input. */
1801 if (XINT (read_kbd) && interrupt_input && (Available & fileno (stdin)))
1803 if (XINT (read_kbd
) && interrupt_input
&& (FD_ISSET (fileno (stdin
), &Available
)))
1808 /* Check for connection from other process */
1810 if (Available
& ChannelMask (comm_server
))
1812 Available
&= ~(ChannelMask (comm_server
));
1818 got_some_input
|= nfds
> 0;
1820 /* If checking input just got us a size-change event from X,
1821 obey it now if we should. */
1822 if (XINT (read_kbd
))
1823 do_pending_window_change ();
1825 /* Check for data from a process or a command channel */
1826 for (channel
= FIRST_PROC_DESC
; channel
< MAXDESC
; channel
++)
1828 if (FD_ISSET (channel
, &Available
))
1832 /* If waiting for this channel, arrange to return as
1833 soon as no more input to be processed. No more
1835 if (wait_channel
== channel
)
1841 proc
= chan_process
[channel
];
1846 /* It's a command channel */
1847 if (!NILP (XPROCESS (proc
)->command_channel_p
))
1849 ProcessCommChan (channel
, proc
);
1850 if (NILP (XPROCESS (proc
)->command_channel_p
))
1852 /* It has ceased to be a command channel! */
1853 int bytes_available
;
1854 if (ioctl (channel
, FIONREAD
, &bytes_available
) < 0)
1855 bytes_available
= 0;
1856 if (bytes_available
)
1857 FD_SET (channel
, &Available
);
1863 /* Read data from the process, starting with our
1864 buffered-ahead character if we have one. */
1866 nread
= read_process_output (proc
, channel
);
1869 /* Since read_process_output can run a filter,
1870 which can call accept-process-output,
1871 don't try to read from any other processes
1872 before doing the select again. */
1873 FD_ZERO (&Available
);
1876 redisplay_preserve_echo_area ();
1879 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1883 else if (nread
== -1 && errno
== EAGAIN
)
1887 else if (nread
== -1 && errno
== EAGAIN
)
1889 /* Note that we cannot distinguish between no input
1890 available now and a closed pipe.
1891 With luck, a closed pipe will be accompanied by
1892 subprocess termination and SIGCHLD. */
1893 else if (nread
== 0 && !NETCONN_P (proc
))
1895 #endif /* O_NDELAY */
1896 #endif /* O_NONBLOCK */
1897 #endif /* EWOULDBLOCK */
1899 /* On some OSs with ptys, when the process on one end of
1900 a pty exits, the other end gets an error reading with
1901 errno = EIO instead of getting an EOF (0 bytes read).
1902 Therefore, if we get an error reading and errno =
1903 EIO, just continue, because the child process has
1904 exited and should clean itself up soon (e.g. when we
1906 else if (nread
== -1 && errno
== EIO
)
1908 #endif /* HAVE_PTYS */
1909 /* If we can detect process termination, don't consider the process
1910 gone just because its pipe is closed. */
1912 else if (nread
== 0 && !NETCONN_P (proc
))
1917 /* Preserve status of processes already terminated. */
1918 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
1919 deactivate_process (proc
);
1920 if (!NILP (XPROCESS (proc
)->raw_status_low
))
1921 update_status (XPROCESS (proc
));
1922 if (EQ (XPROCESS (proc
)->status
, Qrun
))
1923 XPROCESS (proc
)->status
1924 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
1927 } /* end for each file descriptor */
1928 } /* end while exit conditions not met */
1930 /* If calling from keyboard input, do not quit
1931 since we want to return C-g as an input character.
1932 Otherwise, do pending quit if requested. */
1933 if (XINT (read_kbd
) >= 0)
1935 /* Prevent input_pending from remaining set if we quit. */
1936 clear_input_pending ();
1940 return got_some_input
;
1943 /* Read pending output from the process channel,
1944 starting with our buffered-ahead character if we have one.
1945 Yield number of characters read.
1947 This function reads at most 1024 characters.
1948 If you want to read all available subprocess output,
1949 you must call it repeatedly until it returns zero. */
1951 read_process_output (proc
, channel
)
1953 register int channel
;
1955 register int nchars
;
1961 register Lisp_Object outstream
;
1962 register struct buffer
*old
= current_buffer
;
1963 register struct Lisp_Process
*p
= XPROCESS (proc
);
1964 register int opoint
;
1967 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
1969 vs
= get_vms_process_pointer (p
->pid
);
1973 return(0); /* Really weird if it does this */
1974 if (!(vs
->iosb
[0] & 1))
1975 return -1; /* I/O error */
1978 error ("Could not get VMS process pointer");
1979 chars
= vs
->inputBuffer
;
1980 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
1983 start_vms_process_read (vs
); /* Crank up the next read on the process */
1984 return 1; /* Nothing worth printing, say we got 1 */
1988 if (proc_buffered_char
[channel
] < 0)
1989 nchars
= read (channel
, chars
, sizeof chars
);
1992 chars
[0] = proc_buffered_char
[channel
];
1993 proc_buffered_char
[channel
] = -1;
1994 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
1998 nchars
= nchars
+ 1;
2000 #endif /* not VMS */
2002 if (nchars
<= 0) return nchars
;
2004 outstream
= p
->filter
;
2005 if (!NILP (outstream
))
2007 /* We inhibit quit here instead of just catching it so that
2008 hitting ^G when a filter happens to be running won't screw
2010 int count
= specpdl_ptr
- specpdl
;
2011 specbind (Qinhibit_quit
, Qt
);
2012 call2 (outstream
, proc
, make_string (chars
, nchars
));
2015 start_vms_process_read (vs
);
2021 /* If no filter, write into buffer if it isn't dead. */
2022 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2026 Fset_buffer (p
->buffer
);
2029 /* Insert new output into buffer
2030 at the current end-of-output marker,
2031 thus preserving logical ordering of input and output. */
2032 if (XMARKER (p
->mark
)->buffer
)
2033 SET_PT (marker_position (p
->mark
));
2036 if (point
<= opoint
)
2039 tem
= current_buffer
->read_only
;
2040 current_buffer
->read_only
= Qnil
;
2041 /* Insert before markers in case we are inserting where
2042 the buffer's mark is, and the user's next command is Meta-y. */
2043 insert_before_markers (chars
, nchars
);
2044 current_buffer
->read_only
= tem
;
2045 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2046 update_mode_lines
++;
2049 set_buffer_internal (old
);
2052 start_vms_process_read (vs
);
2057 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2059 "Returns non-NIL if emacs is waiting for input from the user.\n\
2060 This is intended for use by asynchronous process output filters and sentinels.")
2063 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2066 /* Sending data to subprocess */
2068 jmp_buf send_process_frame
;
2071 send_process_trap ()
2077 longjmp (send_process_frame
, 1);
2080 send_process (proc
, buf
, len
)
2085 /* Don't use register vars; longjmp can lose them. */
2087 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2091 struct Lisp_Process
*p
= XPROCESS (proc
);
2092 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2095 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2096 update_status (XPROCESS (proc
));
2097 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2098 error ("Process %s not running", procname
);
2101 vs
= get_vms_process_pointer (p
->pid
);
2103 error ("Could not find this process: %x", p
->pid
);
2104 else if (write_to_vms_process (vs
, buf
, len
))
2107 if (!setjmp (send_process_frame
))
2111 SIGTYPE (*old_sigpipe
)();
2113 /* Don't send more than 500 bytes at a time. */
2116 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2117 rv
= write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, this);
2118 signal (SIGPIPE
, old_sigpipe
);
2123 || errno
== EWOULDBLOCK
2130 /* It would be nice to accept process output here,
2131 but that is difficult. For example, it could
2132 garbage what we are sending if that is from a buffer. */
2139 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2143 /* Allow input from processes between bursts of sending.
2144 Otherwise things may get stopped up. */
2149 XFASTINT (zero
) = 0;
2150 wait_reading_process_input (-1, 0, zero
, 0);
2156 XPROCESS (proc
)->raw_status_low
= Qnil
;
2157 XPROCESS (proc
)->raw_status_high
= Qnil
;
2158 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2159 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2160 deactivate_process (proc
);
2162 error ("Error writing to process %s; closed it", procname
);
2164 error ("SIGPIPE raised on process %s; closed it", procname
);
2169 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2171 "Send current contents of region as input to PROCESS.\n\
2172 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2173 nil, indicating the current buffer's process.\n\
2174 Called from program, takes three arguments, PROCESS, START and END.\n\
2175 If the region is more than 500 characters long,\n\
2176 it is sent in several bunches. This may happen even for shorter regions.\n\
2177 Output from processes can arrive in between bunches.")
2178 (process
, start
, end
)
2179 Lisp_Object process
, start
, end
;
2184 proc
= get_process (process
);
2185 validate_region (&start
, &end
);
2187 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2190 start1
= XINT (start
);
2191 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2196 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2198 "Send PROCESS the contents of STRING as input.\n\
2199 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2200 nil, indicating the current buffer's process.\n\
2201 If STRING is more than 500 characters long,\n\
2202 it is sent in several bunches. This may happen even for shorter strings.\n\
2203 Output from processes can arrive in between bunches.")
2205 Lisp_Object process
, string
;
2208 CHECK_STRING (string
, 1);
2209 proc
= get_process (process
);
2210 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2214 /* send a signal number SIGNO to PROCESS.
2215 CURRENT_GROUP means send to the process group that currently owns
2216 the terminal being used to communicate with PROCESS.
2217 This is used for various commands in shell mode.
2218 If NOMSG is zero, insert signal-announcements into process's buffers
2221 process_send_signal (process
, signo
, current_group
, nomsg
)
2222 Lisp_Object process
;
2224 Lisp_Object current_group
;
2228 register struct Lisp_Process
*p
;
2232 proc
= get_process (process
);
2233 p
= XPROCESS (proc
);
2235 if (!EQ (p
->childp
, Qt
))
2236 error ("Process %s is not a subprocess",
2237 XSTRING (p
->name
)->data
);
2238 if (!XFASTINT (p
->infd
))
2239 error ("Process %s is not active",
2240 XSTRING (p
->name
)->data
);
2242 if (NILP (p
->pty_flag
))
2243 current_group
= Qnil
;
2245 /* If we are using pgrps, get a pgrp number and make it negative. */
2246 if (!NILP (current_group
))
2248 /* If possible, send signals to the entire pgrp
2249 by sending an input character to it. */
2250 #if defined (TIOCGLTC) && defined (TIOCGETC)
2257 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2258 send_process (proc
, &c
.t_intrc
, 1);
2261 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2262 send_process (proc
, &c
.t_quitc
, 1);
2266 ioctl (XFASTINT (p
->infd
), TIOCGLTC
, &lc
);
2267 send_process (proc
, &lc
.t_suspc
, 1);
2269 #endif /* SIGTSTP */
2271 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2272 /* It is possible that the following code would work
2273 on other kinds of USG systems, not just on the IRIS.
2274 This should be tried in Emacs 19. */
2280 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2281 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2284 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2285 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2288 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2289 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2292 #endif /* ! defined (USG) */
2295 /* Get the pgrp using the tty itself, if we have that.
2296 Otherwise, use the pty to get the pgrp.
2297 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2298 "TICGPGRP symbol defined in sys/ioctl.h at E50.
2299 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2300 His patch indicates that if TIOCGPGRP returns an error, then
2301 we should just assume that p->pid is also the process group id. */
2305 if (!NILP (p
->subtty
))
2306 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2308 err
= ioctl (XFASTINT (p
->infd
), TIOCGPGRP
, &gid
);
2312 gid
= - XFASTINT (p
->pid
);
2313 #endif /* ! defined (pfa) */
2319 #else /* ! defined (TIOCGPGRP ) */
2320 /* Can't select pgrps on this system, so we know that
2321 the child itself heads the pgrp. */
2322 gid
= - XFASTINT (p
->pid
);
2323 #endif /* ! defined (TIOCGPGRP ) */
2326 gid
= - XFASTINT (p
->pid
);
2332 p
->raw_status_low
= Qnil
;
2333 p
->raw_status_high
= Qnil
;
2335 XSETINT (p
->tick
, ++process_tick
);
2339 #endif /* ! defined (SIGCONT) */
2342 send_process (proc
, "\003", 1); /* ^C */
2347 send_process (proc
, "\031", 1); /* ^Y */
2352 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2355 flush_pending_output (XFASTINT (p
->infd
));
2359 /* If we don't have process groups, send the signal to the immediate
2360 subprocess. That isn't really right, but it's better than any
2361 obvious alternative. */
2364 kill (XFASTINT (p
->pid
), signo
);
2368 /* gid may be a pid, or minus a pgrp's number */
2370 if (!NILP (current_group
))
2371 ioctl (XFASTINT (p
->infd
), TIOCSIGSEND
, signo
);
2374 gid
= - XFASTINT (p
->pid
);
2377 #else /* ! defined (TIOCSIGSEND) */
2378 EMACS_KILLPG (-gid
, signo
);
2379 #endif /* ! defined (TIOCSIGSEND) */
2382 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2383 "Interrupt process PROCESS. May be process or name of one.\n\
2384 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2385 Nil or no arg means current buffer's process.\n\
2386 Second arg CURRENT-GROUP non-nil means send signal to\n\
2387 the current process-group of the process's controlling terminal\n\
2388 rather than to the process's own process group.\n\
2389 If the process is a shell, this means interrupt current subjob\n\
2390 rather than the shell.")
2391 (process
, current_group
)
2392 Lisp_Object process
, current_group
;
2394 process_send_signal (process
, SIGINT
, current_group
, 0);
2398 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2399 "Kill process PROCESS. May be process or name of one.\n\
2400 See function `interrupt-process' for more details on usage.")
2401 (process
, current_group
)
2402 Lisp_Object process
, current_group
;
2404 process_send_signal (process
, SIGKILL
, current_group
, 0);
2408 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2409 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2410 See function `interrupt-process' for more details on usage.")
2411 (process
, current_group
)
2412 Lisp_Object process
, current_group
;
2414 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2418 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2419 "Stop process PROCESS. May be process or name of one.\n\
2420 See function `interrupt-process' for more details on usage.")
2421 (process
, current_group
)
2422 Lisp_Object process
, current_group
;
2425 error ("no SIGTSTP support");
2427 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2432 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2433 "Continue process PROCESS. May be process or name of one.\n\
2434 See function `interrupt-process' for more details on usage.")
2435 (process
, current_group
)
2436 Lisp_Object process
, current_group
;
2439 process_send_signal (process
, SIGCONT
, current_group
, 0);
2441 error ("no SIGCONT support");
2446 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2447 2, 2, "nProcess number: \nnSignal code: ",
2448 "Send the process with number PID the signal with code CODE.\n\
2449 Both PID and CODE are integers.")
2451 Lisp_Object pid
, sig
;
2453 CHECK_NUMBER (pid
, 0);
2454 CHECK_NUMBER (sig
, 1);
2455 return make_number (kill (XINT (pid
), XINT (sig
)));
2458 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2459 "Make PROCESS see end-of-file in its input.\n\
2460 Eof comes after any text already sent to it.\n\
2461 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2462 nil, indicating the current buffer's process.")
2464 Lisp_Object process
;
2468 proc
= get_process (process
);
2469 /* Sending a zero-length record is supposed to mean eof
2470 when TIOCREMOTE is turned on. */
2474 write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, 0);
2476 #else /* did not do TOICREMOTE */
2478 send_process (proc
, "\032", 1); /* ^z */
2480 if (!NILP (XPROCESS (proc
)->pty_flag
))
2481 send_process (proc
, "\004", 1);
2484 close (XPROCESS (proc
)->outfd
);
2485 XFASTINT (XPROCESS (proc
)->outfd
) = open ("/dev/null", O_WRONLY
);
2488 #endif /* did not do TOICREMOTE */
2492 /* Kill all processes associated with `buffer'.
2493 If `buffer' is nil, kill all processes */
2495 kill_buffer_processes (buffer
)
2498 Lisp_Object tail
, proc
;
2500 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2501 tail
= XCONS (tail
)->cdr
)
2503 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2504 if (XGCTYPE (proc
) == Lisp_Process
2505 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2507 if (NETCONN_P (proc
))
2508 deactivate_process (proc
);
2509 else if (XFASTINT (XPROCESS (proc
)->infd
))
2510 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2515 /* On receipt of a signal that a child status has changed,
2516 loop asking about children with changed statuses until
2517 the system says there are no more.
2518 All we do is change the status;
2519 we do not run sentinels or print notifications.
2520 That is saved for the next time keyboard input is done,
2521 in order to avoid timing errors. */
2523 /** WARNING: this can be called during garbage collection.
2524 Therefore, it must not be fooled by the presence of mark bits in
2527 /** USG WARNING: Although it is not obvious from the documentation
2528 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2529 signal() before executing at least one wait(), otherwise the handler
2530 will be called again, resulting in an infinite loop. The relevant
2531 portion of the documentation reads "SIGCLD signals will be queued
2532 and the signal-catching function will be continually reentered until
2533 the queue is empty". Invoking signal() causes the kernel to reexamine
2534 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2537 sigchld_handler (signo
)
2540 int old_errno
= errno
;
2542 register struct Lisp_Process
*p
;
2546 sigheld
|= sigbit (SIGCHLD
);
2558 #endif /* no WUNTRACED */
2559 /* Keep trying to get a status until we get a definitive result. */
2563 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2565 while (pid
<= 0 && errno
== EINTR
);
2569 /* A real failure. We have done all our job, so return. */
2571 /* USG systems forget handlers when they are used;
2572 must reestablish each time */
2574 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2577 sigheld
&= ~sigbit (SIGCHLD
);
2585 #endif /* no WNOHANG */
2587 /* Find the process that signaled us, and record its status. */
2590 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2592 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2593 p
= XPROCESS (proc
);
2594 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2599 /* Look for an asynchronous process whose pid hasn't been filled
2602 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2604 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2605 p
= XPROCESS (proc
);
2606 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2611 /* Change the status of the process that was found. */
2614 union { int i
; WAITTYPE wt
; } u
;
2616 XSETINT (p
->tick
, ++process_tick
);
2618 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2619 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2621 /* If process has terminated, stop waiting for its output. */
2622 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2624 FD_CLR (p
->infd
, &input_wait_mask
);
2627 /* There was no asynchronous process found for that id. Check
2628 if we have a synchronous process. */
2631 synch_process_alive
= 0;
2633 /* Report the status of the synchronous process. */
2635 synch_process_retcode
= WRETCODE (w
);
2636 else if (WIFSIGNALED (w
))
2637 synch_process_death
= sys_siglist
[WTERMSIG (w
)];
2640 /* On some systems, we must return right away.
2641 If any more processes want to signal us, we will
2643 Otherwise (on systems that have WNOHANG), loop around
2644 to use up all the processes that have something to tell us. */
2645 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2647 signal (signo
, sigchld_handler
);
2651 #endif /* USG, but not HPUX with WNOHANG */
2657 exec_sentinel_unwind (data
)
2660 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2665 exec_sentinel (proc
, reason
)
2666 Lisp_Object proc
, reason
;
2668 Lisp_Object sentinel
;
2669 register struct Lisp_Process
*p
= XPROCESS (proc
);
2670 int count
= specpdl_ptr
- specpdl
;
2672 sentinel
= p
->sentinel
;
2673 if (NILP (sentinel
))
2676 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2677 assure that it gets restored no matter how the sentinel exits. */
2679 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2680 /* Inhibit quit so that random quits don't screw up a running filter. */
2681 specbind (Qinhibit_quit
, Qt
);
2682 call2 (sentinel
, proc
, reason
);
2686 /* Report all recent events of a change in process status
2687 (either run the sentinel or output a message).
2688 This is done while Emacs is waiting for keyboard input. */
2692 register Lisp_Object proc
, buffer
;
2693 Lisp_Object tail
= Qnil
;
2694 Lisp_Object msg
= Qnil
;
2695 struct gcpro gcpro1
, gcpro2
;
2697 /* We need to gcpro tail; if read_process_output calls a filter
2698 which deletes a process and removes the cons to which tail points
2699 from Vprocess_alist, and then causes a GC, tail is an unprotected
2703 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2706 register struct Lisp_Process
*p
;
2708 proc
= Fcdr (Fcar (tail
));
2709 p
= XPROCESS (proc
);
2711 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2713 XSETINT (p
->update_tick
, XINT (p
->tick
));
2715 /* If process is still active, read any output that remains. */
2716 if (XFASTINT (p
->infd
))
2717 while (read_process_output (proc
, XFASTINT (p
->infd
)) > 0);
2721 /* Get the text to use for the message. */
2722 if (!NILP (p
->raw_status_low
))
2724 msg
= status_message (p
->status
);
2726 /* If process is terminated, deactivate it or delete it. */
2728 if (XTYPE (p
->status
) == Lisp_Cons
)
2729 symbol
= XCONS (p
->status
)->car
;
2731 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2732 || EQ (symbol
, Qclosed
))
2734 if (delete_exited_processes
)
2735 remove_process (proc
);
2737 deactivate_process (proc
);
2740 /* Now output the message suitably. */
2741 if (!NILP (p
->sentinel
))
2742 exec_sentinel (proc
, msg
);
2743 /* Don't bother with a message in the buffer
2744 when a process becomes runnable. */
2745 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2747 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2749 struct buffer
*old
= current_buffer
;
2752 /* Avoid error if buffer is deleted
2753 (probably that's why the process is dead, too) */
2754 if (NILP (XBUFFER (buffer
)->name
))
2756 Fset_buffer (buffer
);
2758 /* Insert new output into buffer
2759 at the current end-of-output marker,
2760 thus preserving logical ordering of input and output. */
2761 if (XMARKER (p
->mark
)->buffer
)
2762 SET_PT (marker_position (p
->mark
));
2765 if (point
<= opoint
)
2766 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2768 tem
= current_buffer
->read_only
;
2769 current_buffer
->read_only
= Qnil
;
2770 insert_string ("\nProcess ");
2771 Finsert (1, &p
->name
);
2772 insert_string (" ");
2774 current_buffer
->read_only
= tem
;
2775 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2778 set_buffer_internal (old
);
2783 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
2784 redisplay_preserve_echo_area ();
2786 update_tick
= process_tick
;
2797 if (! noninteractive
|| initialized
)
2799 signal (SIGCHLD
, sigchld_handler
);
2802 FD_ZERO (&input_wait_mask
);
2803 FD_SET (0, &input_wait_mask
);
2804 Vprocess_alist
= Qnil
;
2805 for (i
= 0; i
< MAXDESC
; i
++)
2807 chan_process
[i
] = Qnil
;
2808 proc_buffered_char
[i
] = -1;
2812 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 0, 1, 0,
2813 "Return the connection type of `PROCESS'. This can be nil (pipe),\n\
2814 t or pty (pty) or stream (socket connection).")
2816 Lisp_Object process
;
2818 return XPROCESS (process
)->type
;
2824 pty_process
= intern ("pty");
2827 stream_process
= intern ("stream");
2829 Qprocessp
= intern ("processp");
2830 staticpro (&Qprocessp
);
2831 Qrun
= intern ("run");
2833 Qstop
= intern ("stop");
2835 Qsignal
= intern ("signal");
2836 staticpro (&Qsignal
);
2838 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
2841 Qexit = intern ("exit");
2842 staticpro (&Qexit); */
2844 Qopen
= intern ("open");
2846 Qclosed
= intern ("closed");
2847 staticpro (&Qclosed
);
2849 staticpro (&Vprocess_alist
);
2851 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
2852 "*Non-nil means delete processes immediately when they exit.\n\
2853 nil means don't delete them until `list-processes' is run.");
2855 delete_exited_processes
= 1;
2857 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
2858 "Control type of device used to communicate with subprocesses.\n\
2859 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
2860 pty's are not available, this variable will be ignored. The value takes\n\
2861 effect when `start-process' is called.");
2862 Vprocess_connection_type
= Qt
;
2864 defsubr (&Sprocessp
);
2865 defsubr (&Sget_process
);
2866 defsubr (&Sget_buffer_process
);
2867 defsubr (&Sdelete_process
);
2868 defsubr (&Sprocess_status
);
2869 defsubr (&Sprocess_exit_status
);
2870 defsubr (&Sprocess_id
);
2871 defsubr (&Sprocess_name
);
2872 defsubr (&Sprocess_command
);
2873 defsubr (&Sset_process_buffer
);
2874 defsubr (&Sprocess_buffer
);
2875 defsubr (&Sprocess_mark
);
2876 defsubr (&Sset_process_filter
);
2877 defsubr (&Sprocess_filter
);
2878 defsubr (&Sset_process_sentinel
);
2879 defsubr (&Sprocess_sentinel
);
2880 defsubr (&Sprocess_kill_without_query
);
2881 defsubr (&Slist_processes
);
2882 defsubr (&Sprocess_list
);
2883 defsubr (&Sstart_process
);
2885 defsubr (&Sopen_network_stream
);
2886 #endif /* HAVE_SOCKETS */
2887 defsubr (&Saccept_process_output
);
2888 defsubr (&Sprocess_send_region
);
2889 defsubr (&Sprocess_send_string
);
2890 defsubr (&Sinterrupt_process
);
2891 defsubr (&Skill_process
);
2892 defsubr (&Squit_process
);
2893 defsubr (&Sstop_process
);
2894 defsubr (&Scontinue_process
);
2895 defsubr (&Sprocess_send_eof
);
2896 defsubr (&Ssignal_process
);
2897 defsubr (&Swaiting_for_user_input_p
);
2898 /* defsubr (&Sprocess_connection); */
2902 #else /* not subprocesses */
2904 #include <sys/types.h>
2908 #include "systime.h"
2909 #include "termopts.h"
2911 extern int frame_garbaged
;
2914 /* As described above, except assuming that there are no subprocesses:
2916 Wait for timeout to elapse and/or keyboard input to be available.
2919 timeout in seconds, or
2920 zero for no limit, or
2921 -1 means gobble data immediately available but don't wait for any.
2923 read_kbd is a Lisp_Object:
2924 0 to ignore keyboard input, or
2925 1 to return when input is available, or
2926 -1 means caller will actually read the input, so don't throw to
2928 We know that read_kbd will never be a Lisp_Process, since
2929 `subprocesses' isn't defined.
2931 do_display != 0 means redisplay should be done to show subprocess
2932 output that arrives. This version of the function ignores it.
2934 Return true iff we recieved input from any process. */
2937 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
2938 int time_limit
, microsecs
;
2939 Lisp_Object read_kbd
;
2942 EMACS_TIME end_time
, timeout
, *timeout_p
;
2945 /* What does time_limit really mean? */
2946 if (time_limit
|| microsecs
)
2948 /* It's not infinite. */
2949 timeout_p
= &timeout
;
2951 if (time_limit
== -1)
2952 /* In fact, it's zero. */
2953 EMACS_SET_SECS_USECS (timeout
, 0, 0);
2955 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
2957 /* How far in the future is that? */
2958 EMACS_GET_TIME (end_time
);
2959 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
2962 /* It's infinite. */
2965 /* Turn off periodic alarms (in case they are in use)
2966 because the select emulator uses alarms. */
2973 waitchannels
= XINT (read_kbd
) ? 1 : 0;
2975 /* If calling from keyboard input, do not quit
2976 since we want to return C-g as an input character.
2977 Otherwise, do pending quit if requested. */
2978 if (XINT (read_kbd
) >= 0)
2983 EMACS_GET_TIME (*timeout_p
);
2984 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
2985 if (EMACS_TIME_NEG_P (*timeout_p
))
2989 /* Cause C-g and alarm signals to take immediate action,
2990 and cause input available signals to zero out timeout. */
2991 if (XINT (read_kbd
) < 0)
2992 set_waiting_for_input (&timeout
);
2994 /* If a frame has been newly mapped and needs updating,
2995 reprocess its display stuff. */
2997 redisplay_preserve_echo_area ();
2999 if (XINT (read_kbd
) && detect_input_pending ())
3002 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3004 /* Make C-g and alarm signals set flags again */
3005 clear_waiting_for_input ();
3007 /* If we woke up due to SIGWINCH, actually change size now. */
3008 do_pending_window_change ();
3012 /* If the system call was interrupted, then go around the
3018 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3019 /* System sometimes fails to deliver SIGIO. */
3020 kill (getpid (), SIGIO
);
3022 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3025 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3035 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3036 "Return the (or, a) process associated with BUFFER.\n\
3037 This copy of Emacs has not been built to support subprocesses, so this\n\
3038 function always returns nil.")
3040 register Lisp_Object name
;
3045 /* Kill all processes associated with `buffer'.
3046 If `buffer' is nil, kill all processes.
3047 Since we have no subprocesses, this does nothing. */
3049 kill_buffer_processes (buffer
)
3060 defsubr (&Sget_buffer_process
);
3064 #endif /* not subprocesses */