1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1993 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
25 /* This file is split into two parts by the following preprocessor
26 conditional. The 'then' clause contains all of the support for
27 asynchronous subprocesses. The 'else' clause contains stub
28 versions of some of the asynchronous subprocess routines that are
29 often called elsewhere in Emacs, so we don't have to #ifdef the
30 sections that call them. */
38 #include <sys/types.h> /* some typedefs are used in sys/file.h */
42 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
43 #include <sys/socket.h>
45 #include <netinet/in.h>
46 #include <arpa/inet.h>
47 #endif /* HAVE_SOCKETS */
49 #if defined(BSD) || defined(STRIDE)
50 #include <sys/ioctl.h>
51 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
53 #endif /* HAVE_PTYS and no O_NDELAY */
54 #endif /* BSD or STRIDE */
61 #include <sys/sysmacros.h> /* for "minor" */
71 #include "termhooks.h"
76 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
77 /* Qexit is declared and initialized in eval.c. */
79 /* a process object is a network connection when its childp field is neither
80 Qt nor Qnil but is instead a string (name of foreign host we
81 are connected to + name of port we are connected to) */
84 static Lisp_Object stream_process
;
86 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
88 #define NETCONN_P(p) 0
89 #endif /* HAVE_SOCKETS */
91 /* Define first descriptor number available for subprocesses. */
93 #define FIRST_PROC_DESC 1
95 #define FIRST_PROC_DESC 3
98 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
101 #if !defined (SIGCHLD) && defined (SIGCLD)
102 #define SIGCHLD SIGCLD
105 #include "syssignal.h"
107 /* Define the structure that the wait system call stores.
108 On many systems, there is a structure defined for this.
109 But on vanilla-ish USG systems there is not. */
113 #if (!defined (BSD) && !defined (UNIPLUS) && !defined (STRIDE) && !(defined (HPUX) && !defined (NOMULTIPLEJOBS)) && !defined (HAVE_WAIT_HEADER)) || defined (LINUX)
115 #define WIFSTOPPED(w) ((w&0377) == 0177)
116 #define WIFSIGNALED(w) ((w&0377) != 0177 && (w&~0377) == 0)
117 #define WIFEXITED(w) ((w&0377) == 0)
118 #define WRETCODE(w) (w >> 8)
119 #define WSTOPSIG(w) (w >> 8)
120 #define WTERMSIG(w) (w & 0377)
122 #define WCOREDUMP(w) ((w&0200) != 0)
128 #include <sys/wait.h>
129 #endif /* not BSD 4.1 */
131 #define WAITTYPE union wait
132 #define WRETCODE(w) w.w_retcode
133 #define WCOREDUMP(w) w.w_coredump
136 /* HPUX version 7 has broken definitions of these. */
145 #define WTERMSIG(w) w.w_termsig
148 #define WSTOPSIG(w) w.w_stopsig
151 #define WIFSTOPPED(w) (WTERMSIG (w) == 0177)
154 #define WIFSIGNALED(w) (WTERMSIG (w) != 0177 && (WSTOPSIG (w)) == 0)
157 #define WIFEXITED(w) (WTERMSIG (w) == 0)
159 #endif /* BSD or UNIPLUS or STRIDE */
160 #endif /* no WAITTYPE */
163 #define WIFSTOPPED(w) 0
164 #define WIFSIGNALED(w) 0
165 #define WIFEXITED(w) ((w) != -1)
166 #define WRETCODE(w) (w)
167 #define WSTOPSIG(w) (w)
168 #define WCOREDUMP(w) 0
169 #define WTERMSIG(w) (w)
178 extern char *sys_errlist
[];
183 extern char *sys_siglist
[];
186 char *sys_siglist
[] =
192 "illegal instruction",
196 "floating point exception",
199 "segmentation violation",
200 "bad argument to system call",
201 "write on a pipe with no one to read it",
203 "software termination signal from kill",
205 "sendable stop signal not from tty",
206 "stop signal from tty",
207 "continue a stopped process",
208 "child status has changed",
209 "background read attempted from control tty",
210 "background write attempted from control tty",
211 "input record available at control tty",
212 "exceeded CPU time limit",
213 "exceeded file size limit"
218 /* t means use pty, nil means use a pipe,
219 maybe other values to come. */
220 Lisp_Object Vprocess_connection_type
;
224 #include <sys/socket.h>
228 /* Number of events of change of status of a process. */
231 /* Number of events for which the user or sentinel has been notified. */
235 /* We could get this from param.h, but better not to depend on finding that.
236 And better not to risk that it might define other symbols used in this
239 #define MAXDESC FD_SETSIZE
243 #define SELECT_TYPE fd_set
244 #else /* no FD_SET */
246 #define SELECT_TYPE int
248 /* Define the macros to access a single-int bitmap of descriptors. */
249 #define FD_SET(n, p) (*(p) |= (1 << (n)))
250 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
251 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
252 #define FD_ZERO(p) (*(p) = 0)
253 #endif /* no FD_SET */
255 /* Mask of bits indicating the descriptors that we wait for input on */
257 SELECT_TYPE input_wait_mask
;
259 int delete_exited_processes
;
261 /* Indexed by descriptor, gives the process (if any) for that descriptor */
262 Lisp_Object chan_process
[MAXDESC
];
264 /* Alist of elements (NAME . PROCESS) */
265 Lisp_Object Vprocess_alist
;
267 Lisp_Object Qprocessp
;
269 Lisp_Object
get_process ();
271 /* Buffered-ahead input char from process, indexed by channel.
272 -1 means empty (no char is buffered).
273 Used on sys V where the only way to tell if there is any
274 output from the process is to read at least one char.
275 Always -1 on systems that support FIONREAD. */
277 int proc_buffered_char
[MAXDESC
];
279 /* Compute the Lisp form of the process status, p->status, from
280 the numeric status that was returned by `wait'. */
282 Lisp_Object
status_convert ();
285 struct Lisp_Process
*p
;
287 union { int i
; WAITTYPE wt
; } u
;
288 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
289 p
->status
= status_convert (u
.wt
);
290 p
->raw_status_low
= Qnil
;
291 p
->raw_status_high
= Qnil
;
294 /* Convert a process status word in Unix format to
295 the list that we use internally. */
302 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
303 else if (WIFEXITED (w
))
304 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
305 WCOREDUMP (w
) ? Qt
: Qnil
));
306 else if (WIFSIGNALED (w
))
307 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
308 WCOREDUMP (w
) ? Qt
: Qnil
));
313 /* Given a status-list, extract the three pieces of information
314 and store them individually through the three pointers. */
317 decode_status (l
, symbol
, code
, coredump
)
325 if (XTYPE (l
) == Lisp_Symbol
)
333 *symbol
= XCONS (l
)->car
;
334 tem
= XCONS (l
)->cdr
;
335 *code
= XFASTINT (XCONS (tem
)->car
);
336 tem
= XCONS (tem
)->cdr
;
337 *coredump
= !NILP (tem
);
341 /* Return a string describing a process status list. */
344 status_message (status
)
349 Lisp_Object string
, string2
;
351 decode_status (status
, &symbol
, &code
, &coredump
);
353 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
356 string
= build_string (code
< NSIG
? sys_siglist
[code
] : "unknown");
358 string
= build_string (code
< NSIG
? sys_errlist
[code
] : "unknown");
360 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
361 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
362 return concat2 (string
, string2
);
364 else if (EQ (symbol
, Qexit
))
367 return build_string ("finished\n");
368 string
= Fnumber_to_string (make_number (code
));
369 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
370 return concat2 (build_string ("exited abnormally with code "),
371 concat2 (string
, string2
));
374 return Fcopy_sequence (Fsymbol_name (symbol
));
379 /* Open an available pty, returning a file descriptor.
380 Return -1 on failure.
381 The file name of the terminal corresponding to the pty
382 is left in the variable pty_name. */
393 /* Some systems name their pseudoterminals so that there are gaps in
394 the usual sequence - for example, on HP9000/S700 systems, there
395 are no pseudoterminals with names ending in 'f'. So we wait for
396 three failures in a row before deciding that we've reached the
398 int failed_count
= 0;
403 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
404 for (i
= 0; i
< 16; i
++)
407 #ifdef PTY_NAME_SPRINTF
410 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
411 #endif /* no PTY_NAME_SPRINTF */
415 #else /* no PTY_OPEN */
417 /* Unusual IRIS code */
418 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
421 if (fstat (fd
, &stb
) < 0)
424 if (stat (pty_name
, &stb
) < 0)
427 if (failed_count
>= 3)
433 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
435 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
437 #endif /* not IRIS */
438 #endif /* no PTY_OPEN */
442 /* check to make certain that both sides are available
443 this avoids a nasty yet stupid bug in rlogins */
444 #ifdef PTY_TTY_NAME_SPRINTF
447 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
448 #endif /* no PTY_TTY_NAME_SPRINTF */
450 if (access (pty_name
, 6) != 0)
453 #if !defined(IRIS) && !defined(__sgi)
459 #endif /* not UNIPLUS */
466 #endif /* HAVE_PTYS */
472 register Lisp_Object val
, tem
, name1
;
473 register struct Lisp_Process
*p
;
477 /* size of process structure includes the vector header,
478 so deduct for that. But struct Lisp_Vector includes the first
479 element, thus deducts too much, so add it back. */
480 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
481 - sizeof (struct Lisp_Vector
)
482 + sizeof (Lisp_Object
))
483 / sizeof (Lisp_Object
)),
485 XSETTYPE (val
, Lisp_Process
);
488 XFASTINT (p
->infd
) = 0;
489 XFASTINT (p
->outfd
) = 0;
490 XFASTINT (p
->pid
) = 0;
491 XFASTINT (p
->tick
) = 0;
492 XFASTINT (p
->update_tick
) = 0;
493 p
->raw_status_low
= Qnil
;
494 p
->raw_status_high
= Qnil
;
496 p
->mark
= Fmake_marker ();
498 /* If name is already in use, modify it until it is unused. */
503 tem
= Fget_process (name1
);
504 if (NILP (tem
)) break;
505 sprintf (suffix
, "<%d>", i
);
506 name1
= concat2 (name
, build_string (suffix
));
510 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
514 remove_process (proc
)
515 register Lisp_Object proc
;
517 register Lisp_Object pair
;
519 pair
= Frassq (proc
, Vprocess_alist
);
520 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
521 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
523 deactivate_process (proc
);
526 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
527 "Return t if OBJECT is a process.")
531 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
534 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
535 "Return the process named NAME, or nil if there is none.")
537 register Lisp_Object name
;
539 if (XTYPE (name
) == Lisp_Process
)
541 CHECK_STRING (name
, 0);
542 return Fcdr (Fassoc (name
, Vprocess_alist
));
545 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
546 "Return the (or, a) process associated with BUFFER.\n\
547 BUFFER may be a buffer or the name of one.")
549 register Lisp_Object name
;
551 register Lisp_Object buf
, tail
, proc
;
553 if (NILP (name
)) return Qnil
;
554 buf
= Fget_buffer (name
);
555 if (NILP (buf
)) return Qnil
;
557 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
559 proc
= Fcdr (Fcar (tail
));
560 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
566 /* This is how commands for the user decode process arguments. It
567 accepts a process, a process name, a buffer, a buffer name, or nil.
568 Buffers denote the first process in the buffer, and nil denotes the
573 register Lisp_Object name
;
575 register Lisp_Object proc
;
577 proc
= Fget_buffer_process (Fcurrent_buffer ());
580 proc
= Fget_process (name
);
582 proc
= Fget_buffer_process (Fget_buffer (name
));
589 error ("Current buffer has no process");
591 error ("Process %s does not exist", XSTRING (name
)->data
);
595 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
596 "Delete PROCESS: kill it and forget about it immediately.\n\
597 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
598 nil, indicating the current buffer's process.")
600 register Lisp_Object proc
;
602 proc
= get_process (proc
);
603 XPROCESS (proc
)->raw_status_low
= Qnil
;
604 XPROCESS (proc
)->raw_status_high
= Qnil
;
605 if (NETCONN_P (proc
))
607 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
608 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
610 else if (XFASTINT (XPROCESS (proc
)->infd
))
612 Fkill_process (proc
, Qnil
);
613 /* Do this now, since remove_process will make sigchld_handler do nothing. */
614 XPROCESS (proc
)->status
615 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
616 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
619 remove_process (proc
);
623 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
624 "Return the status of PROCESS: a symbol, one of these:\n\
625 run -- for a process that is running.\n\
626 stop -- for a process stopped but continuable.\n\
627 exit -- for a process that has exited.\n\
628 signal -- for a process that has got a fatal signal.\n\
629 open -- for a network stream connection that is open.\n\
630 closed -- for a network stream connection that is closed.\n\
631 nil -- if arg is a process name and no such process exists.\n\
632 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
633 nil, indicating the current buffer's process.")
634 /* command -- for a command channel opened to Emacs by another process.\n\
635 external -- for an i/o channel opened to Emacs by another process.\n\ */
637 register Lisp_Object proc
;
639 register struct Lisp_Process
*p
;
640 register Lisp_Object status
;
641 proc
= get_process (proc
);
645 if (!NILP (p
->raw_status_low
))
648 if (XTYPE (status
) == Lisp_Cons
)
649 status
= XCONS (status
)->car
;
650 if (NETCONN_P (proc
))
652 if (EQ (status
, Qrun
))
654 else if (EQ (status
, Qexit
))
660 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
662 "Return the exit status of PROCESS or the signal number that killed it.\n\
663 If PROCESS has not yet exited or died, return 0.")
665 register Lisp_Object proc
;
667 CHECK_PROCESS (proc
, 0);
668 if (!NILP (XPROCESS (proc
)->raw_status_low
))
669 update_status (XPROCESS (proc
));
670 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
671 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
672 return make_number (0);
675 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
676 "Return the process id of PROCESS.\n\
677 This is the pid of the Unix process which PROCESS uses or talks to.\n\
678 For a network connection, this value is nil.")
680 register Lisp_Object proc
;
682 CHECK_PROCESS (proc
, 0);
683 return XPROCESS (proc
)->pid
;
686 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
687 "Return the name of PROCESS, as a string.\n\
688 This is the name of the program invoked in PROCESS,\n\
689 possibly modified to make it unique among process names.")
691 register Lisp_Object proc
;
693 CHECK_PROCESS (proc
, 0);
694 return XPROCESS (proc
)->name
;
697 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
698 "Return the command that was executed to start PROCESS.\n\
699 This is a list of strings, the first string being the program executed\n\
700 and the rest of the strings being the arguments given to it.\n\
701 For a non-child channel, this is nil.")
703 register Lisp_Object proc
;
705 CHECK_PROCESS (proc
, 0);
706 return XPROCESS (proc
)->command
;
709 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
711 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
713 register Lisp_Object proc
, buffer
;
715 CHECK_PROCESS (proc
, 0);
717 CHECK_BUFFER (buffer
, 1);
718 XPROCESS (proc
)->buffer
= buffer
;
722 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
724 "Return the buffer PROCESS is associated with.\n\
725 Output from PROCESS is inserted in this buffer\n\
726 unless PROCESS has a filter.")
728 register Lisp_Object proc
;
730 CHECK_PROCESS (proc
, 0);
731 return XPROCESS (proc
)->buffer
;
734 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
736 "Return the marker for the end of the last output from PROCESS.")
738 register Lisp_Object proc
;
740 CHECK_PROCESS (proc
, 0);
741 return XPROCESS (proc
)->mark
;
744 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
746 "Give PROCESS the filter function FILTER; nil means no filter.\n\
747 When a process has a filter, each time it does output\n\
748 the entire string of output is passed to the filter.\n\
749 The filter gets two arguments: the process and the string of output.\n\
750 If the process has a filter, its buffer is not used for output.")
752 register Lisp_Object proc
, filter
;
754 CHECK_PROCESS (proc
, 0);
755 XPROCESS (proc
)->filter
= filter
;
759 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
761 "Returns the filter function of PROCESS; nil if none.\n\
762 See `set-process-filter' for more info on filter functions.")
764 register Lisp_Object proc
;
766 CHECK_PROCESS (proc
, 0);
767 return XPROCESS (proc
)->filter
;
770 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
772 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
773 The sentinel is called as a function when the process changes state.\n\
774 It gets two arguments: the process, and a string describing the change.")
776 register Lisp_Object proc
, sentinel
;
778 CHECK_PROCESS (proc
, 0);
779 XPROCESS (proc
)->sentinel
= sentinel
;
783 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
785 "Return the sentinel of PROCESS; nil if none.\n\
786 See `set-process-sentinel' for more info on sentinels.")
788 register Lisp_Object proc
;
790 CHECK_PROCESS (proc
, 0);
791 return XPROCESS (proc
)->sentinel
;
794 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
795 Sprocess_kill_without_query
, 1, 2, 0,
796 "Say no query needed if PROCESS is running when Emacs is exited.\n\
797 Optional second argument if non-nill says to require a query.\n\
798 Value is t if a query was formerly required.")
800 register Lisp_Object proc
, value
;
804 CHECK_PROCESS (proc
, 0);
805 tem
= XPROCESS (proc
)->kill_without_query
;
806 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
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_errlist
[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 /* Starting asynchronous inferior processes. */
942 static Lisp_Object
start_process_unwind ();
944 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
945 "Start a program in a subprocess. Return the process object for it.\n\
946 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
947 NAME is name for process. It is modified if necessary to make it unique.\n\
948 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
949 Process output goes at end of that buffer, unless you specify\n\
950 an output stream or filter function to handle the output.\n\
951 BUFFER may be also nil, meaning that this process is not associated\n\
953 Third arg is program file name. It is searched for as in the shell.\n\
954 Remaining arguments are strings to give program as arguments.")
957 register Lisp_Object
*args
;
959 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
961 register unsigned char *new_argv
;
964 register unsigned char **new_argv
;
967 int count
= specpdl_ptr
- specpdl
;
971 buffer
= Fget_buffer_create (buffer
);
973 /* Make sure that the child will be able to chdir to the current
974 buffer's current directory, or its unhandled equivalent. We
975 can't just have the child check for an error when it does the
976 chdir, since it's in a vfork.
978 We have to GCPRO around this because Fexpand_file_name and
979 Funhandled_file_name_directory might call a file name handling
980 function. The argument list is protected by the caller, so all
981 we really have to worry about is buffer. */
983 struct gcpro gcpro1
, gcpro2
;
985 current_dir
= current_buffer
->directory
;
987 GCPRO2 (buffer
, current_dir
);
990 expand_and_dir_to_file
991 (Funhandled_file_name_directory (current_dir
), Qnil
);
992 if (NILP (Ffile_accessible_directory_p (current_dir
)))
993 report_file_error ("Setting current directory",
994 Fcons (current_buffer
->directory
, Qnil
));
1000 CHECK_STRING (name
, 0);
1004 CHECK_STRING (program
, 2);
1007 /* Make a one member argv with all args concatenated
1008 together separated by a blank. */
1009 len
= XSTRING (program
)->size
+ 2;
1010 for (i
= 3; i
< nargs
; i
++)
1013 CHECK_STRING (tem
, i
);
1014 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1016 new_argv
= (unsigned char *) alloca (len
);
1017 strcpy (new_argv
, XSTRING (program
)->data
);
1018 for (i
= 3; i
< nargs
; i
++)
1021 CHECK_STRING (tem
, i
);
1022 strcat (new_argv
, " ");
1023 strcat (new_argv
, XSTRING (tem
)->data
);
1025 /* Need to add code here to check for program existence on VMS */
1028 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1030 for (i
= 3; i
< nargs
; i
++)
1033 CHECK_STRING (tem
, i
);
1034 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1036 new_argv
[i
- 2] = 0;
1037 new_argv
[0] = XSTRING (program
)->data
;
1039 /* If program file name is not absolute, search our path for it */
1040 if (new_argv
[0][0] != '/')
1043 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1045 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1046 new_argv
[0] = XSTRING (tem
)->data
;
1048 #endif /* not VMS */
1050 proc
= make_process (name
);
1051 /* If an error occurs and we can't start the process, we want to
1052 remove it from the process list. This means that each error
1053 check in create_process doesn't need to call remove_process
1054 itself; it's all taken care of here. */
1055 record_unwind_protect (start_process_unwind
, proc
);
1057 XPROCESS (proc
)->childp
= Qt
;
1058 XPROCESS (proc
)->command_channel_p
= Qnil
;
1059 XPROCESS (proc
)->buffer
= buffer
;
1060 XPROCESS (proc
)->sentinel
= Qnil
;
1061 XPROCESS (proc
)->filter
= Qnil
;
1062 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1064 create_process (proc
, new_argv
, current_dir
);
1066 return unbind_to (count
, proc
);
1069 /* This function is the unwind_protect form for Fstart_process. If
1070 PROC doesn't have its pid set, then we know someone has signalled
1071 an error and the process wasn't started successfully, so we should
1072 remove it from the process list. */
1074 start_process_unwind (proc
)
1077 if (XTYPE (proc
) != Lisp_Process
)
1080 /* Was PROC started successfully? */
1081 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1082 remove_process (proc
);
1089 create_process_1 (signo
)
1093 /* USG systems forget handlers when they are used;
1094 must reestablish each time */
1095 signal (signo
, create_process_1
);
1099 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1102 /* Mimic blocking of signals on system V, which doesn't really have it. */
1104 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1105 int sigchld_deferred
;
1108 create_process_sigchld ()
1110 signal (SIGCHLD
, create_process_sigchld
);
1112 sigchld_deferred
= 1;
1118 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1119 create_process (process
, new_argv
, current_dir
)
1120 Lisp_Object process
;
1122 Lisp_Object current_dir
;
1124 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1127 SIGTYPE (*sigchld
)();
1130 extern char **environ
;
1132 inchannel
= outchannel
= -1;
1135 if (EQ (Vprocess_connection_type
, Qt
))
1136 outchannel
= inchannel
= allocate_pty ();
1141 /* On USG systems it does not work to open the pty's tty here
1142 and then close and reopen it in the child. */
1144 /* Don't let this terminal become our controlling terminal
1145 (in case we don't have one). */
1146 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1148 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1151 report_file_error ("Opening pty", Qnil
);
1153 forkin
= forkout
= -1;
1154 #endif /* not USG */
1158 #endif /* HAVE_PTYS */
1161 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1162 report_file_error ("Opening socketpair", Qnil
);
1163 outchannel
= inchannel
= sv
[0];
1164 forkout
= forkin
= sv
[1];
1166 #else /* not SKTPAIR */
1175 #endif /* not SKTPAIR */
1178 /* Replaced by close_process_descs */
1179 set_exclusive_use (inchannel
);
1180 set_exclusive_use (outchannel
);
1183 /* Stride people say it's a mystery why this is needed
1184 as well as the O_NDELAY, but that it fails without this. */
1185 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1188 ioctl (inchannel
, FIONBIO
, &one
);
1193 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1196 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1200 /* Record this as an active process, with its channels.
1201 As a result, child_setup will close Emacs's side of the pipes. */
1202 chan_process
[inchannel
] = process
;
1203 XFASTINT (XPROCESS (process
)->infd
) = inchannel
;
1204 XFASTINT (XPROCESS (process
)->outfd
) = outchannel
;
1205 /* Record the tty descriptor used in the subprocess. */
1207 XPROCESS (process
)->subtty
= Qnil
;
1209 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1210 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1211 XPROCESS (process
)->status
= Qrun
;
1213 /* Delay interrupts until we have a chance to store
1214 the new fork's pid in its process structure */
1218 #else /* not BSD4_1 */
1219 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1220 sigsetmask (sigmask (SIGCHLD
));
1221 #else /* ordinary USG */
1223 sigchld_deferred
= 0;
1224 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1226 #endif /* ordinary USG */
1227 #endif /* not BSD4_1 */
1228 #endif /* SIGCHLD */
1230 /* Until we store the proper pid, enable sigchld_handler
1231 to recognize an unknown pid as standing for this process.
1232 It is very important not to let this `marker' value stay
1233 in the table after this function has returned; if it does
1234 it might cause call-process to hang and subsequent asynchronous
1235 processes to get their return values scrambled. */
1236 XSETINT (XPROCESS (process
)->pid
, -1);
1239 /* child_setup must clobber environ on systems with true vfork.
1240 Protect it from permanent change. */
1241 char **save_environ
= environ
;
1246 int xforkin
= forkin
;
1247 int xforkout
= forkout
;
1249 #if 0 /* This was probably a mistake--it duplicates code later on,
1250 but fails to handle all the cases. */
1251 /* Make sure SIGCHLD is not blocked in the child. */
1252 sigsetmask (SIGEMPTYMASK
);
1255 /* Make the pty be the controlling terminal of the process. */
1257 /* First, disconnect its current controlling terminal. */
1261 /* Make the pty's terminal the controlling terminal. */
1263 /* We ignore the return value
1264 because faith@cs.unc.edu says that is necessary on Linux. */
1265 ioctl (xforkin
, TIOCSCTTY
, 0);
1267 #else /* not HAVE_SETSID */
1268 #if defined (USG) && !defined (IRIX)
1269 /* It's very important to call setpgrp() here and no time
1270 afterwards. Otherwise, we lose our controlling tty which
1271 is set when we open the pty. */
1274 #endif /* not HAVE_SETSID */
1276 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1277 can do TIOCSPGRP only to the process's controlling tty. */
1280 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1281 I can't test it since I don't have 4.3. */
1282 int j
= open ("/dev/tty", O_RDWR
, 0);
1283 ioctl (j
, TIOCNOTTY
, 0);
1286 /* In order to get a controlling terminal on some versions
1287 of BSD, it is necessary to put the process in pgrp 0
1288 before it opens the terminal. */
1292 #endif /* TIOCNOTTY */
1294 #if !defined (RTU) && !defined (UNIPLUS)
1295 /*** There is a suggestion that this ought to be a
1296 conditional on TIOCSPGRP. */
1297 /* Now close the pty (if we had it open) and reopen it.
1298 This makes the pty the controlling terminal of the subprocess. */
1301 /* I wonder if close (open (pty_name, ...)) would work? */
1304 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1309 #endif /* not UNIPLUS and not RTU */
1310 #ifdef SETUP_SLAVE_PTY
1312 #endif /* SETUP_SLAVE_PTY */
1314 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1315 Now reenable it in the child, so it will die when we want it to. */
1317 signal (SIGHUP
, SIG_DFL
);
1319 #endif /* HAVE_PTYS */
1324 #else /* not BSD4_1 */
1325 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1326 sigsetmask (SIGEMPTYMASK
);
1327 #else /* ordinary USG */
1329 signal (SIGCHLD
, sigchld
);
1331 #endif /* ordinary USG */
1332 #endif /* not BSD4_1 */
1333 #endif /* SIGCHLD */
1335 child_setup_tty (xforkout
);
1336 child_setup (xforkin
, xforkout
, xforkout
,
1337 new_argv
, 1, current_dir
);
1339 environ
= save_environ
;
1343 report_file_error ("Doing vfork", Qnil
);
1345 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1347 FD_SET (inchannel
, &input_wait_mask
);
1349 /* If the subfork execv fails, and it exits,
1350 this close hangs. I don't know why.
1351 So have an interrupt jar it loose. */
1353 signal (SIGALRM
, create_process_1
);
1356 /* OK to close only if it's not a pty. Otherwise we need to leave
1357 it open for ioctl to get pgrp when signals are sent, or to send
1358 the interrupt characters through if that's how we're signalling
1359 subprocesses. Alternately if you are concerned about running out
1360 of file descriptors, you could just save the tty name and open
1361 just to do the ioctl. */
1362 if (NILP (XFASTINT (XPROCESS (process
)->pty_flag
)))
1365 XPROCESS (process
)->subtty
= Qnil
;
1371 if (forkin
!= forkout
&& forkout
>= 0)
1377 #else /* not BSD4_1 */
1378 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1379 sigsetmask (SIGEMPTYMASK
);
1380 #else /* ordinary USG */
1382 signal (SIGCHLD
, sigchld
);
1383 /* Now really handle any of these signals
1384 that came in during this function. */
1385 if (sigchld_deferred
)
1386 kill (getpid (), SIGCHLD
);
1388 #endif /* ordinary USG */
1389 #endif /* not BSD4_1 */
1390 #endif /* SIGCHLD */
1392 #endif /* not VMS */
1396 /* open a TCP network connection to a given HOST/SERVICE. Treated
1397 exactly like a normal process when reading and writing. Only
1398 differences are in status display and process deletion. A network
1399 connection has no PID; you cannot signal it. All you can do is
1400 deactivate and close it via delete-process */
1402 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1404 "Open a TCP connection for a service to a host.\n\
1405 Returns a subprocess-object to represent the connection.\n\
1406 Input and output work as for subprocesses; `delete-process' closes it.\n\
1407 Args are NAME BUFFER HOST SERVICE.\n\
1408 NAME is name for process. It is modified if necessary to make it unique.\n\
1409 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1410 Process output goes at end of that buffer, unless you specify\n\
1411 an output stream or filter function to handle the output.\n\
1412 BUFFER may be also nil, meaning that this process is not associated\n\
1414 Third arg is name of the host to connect to, or its IP address.\n\
1415 Fourth arg SERVICE is name of the service desired, or an integer\n\
1416 specifying a port number to connect to.")
1417 (name
, buffer
, host
, service
)
1418 Lisp_Object name
, buffer
, host
, service
;
1422 struct sockaddr_in address
;
1423 struct servent
*svc_info
;
1424 struct hostent
*host_info_ptr
, host_info
;
1425 char *(addr_list
[2]);
1426 unsigned long numeric_addr
;
1430 struct hostent host_info_fixed
;
1431 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1433 GCPRO4 (name
, buffer
, host
, service
);
1434 CHECK_STRING (name
, 0);
1435 CHECK_STRING (host
, 0);
1436 if (XTYPE(service
) == Lisp_Int
)
1437 port
= htons ((unsigned short) XINT (service
));
1440 CHECK_STRING (service
, 0);
1441 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1443 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1444 port
= svc_info
->s_port
;
1447 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1448 if (host_info_ptr
== 0)
1449 /* Attempt to interpret host as numeric inet address */
1451 numeric_addr
= inet_addr (XSTRING (host
)->data
);
1452 if (numeric_addr
== -1)
1453 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1455 host_info_ptr
= &host_info
;
1456 host_info
.h_name
= 0;
1457 host_info
.h_aliases
= 0;
1458 host_info
.h_addrtype
= AF_INET
;
1460 /* Older machines have only one address slot called h_addr.
1461 Newer machines have h_addr_list, but #define h_addr to
1462 be its first element. */
1463 host_info
.h_addr_list
= &(addr_list
[0]);
1465 host_info
.h_addr
= (char*)(&numeric_addr
);
1467 host_info
.h_length
= strlen (addr_list
[0]);
1470 bzero (&address
, sizeof address
);
1471 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1472 host_info_ptr
->h_length
);
1473 address
.sin_family
= host_info_ptr
->h_addrtype
;
1474 address
.sin_port
= port
;
1476 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1478 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1481 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1488 report_file_error ("connection failed",
1489 Fcons (host
, Fcons (name
, Qnil
)));
1495 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1498 buffer
= Fget_buffer_create (buffer
);
1499 proc
= make_process (name
);
1501 chan_process
[inch
] = proc
;
1504 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1507 fcntl (inch
, F_SETFL
, O_NDELAY
);
1511 XPROCESS (proc
)->childp
= host
;
1512 XPROCESS (proc
)->command_channel_p
= Qnil
;
1513 XPROCESS (proc
)->buffer
= buffer
;
1514 XPROCESS (proc
)->sentinel
= Qnil
;
1515 XPROCESS (proc
)->filter
= Qnil
;
1516 XPROCESS (proc
)->command
= Qnil
;
1517 XPROCESS (proc
)->pid
= Qnil
;
1518 XFASTINT (XPROCESS (proc
)->infd
) = s
;
1519 XFASTINT (XPROCESS (proc
)->outfd
) = outch
;
1520 XPROCESS (proc
)->status
= Qrun
;
1521 FD_SET (inch
, &input_wait_mask
);
1526 #endif /* HAVE_SOCKETS */
1528 deactivate_process (proc
)
1531 register int inchannel
, outchannel
;
1532 register struct Lisp_Process
*p
= XPROCESS (proc
);
1534 inchannel
= XFASTINT (p
->infd
);
1535 outchannel
= XFASTINT (p
->outfd
);
1539 /* Beware SIGCHLD hereabouts. */
1540 flush_pending_output (inchannel
);
1543 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1544 sys$
dassgn (outchannel
);
1545 vs
= get_vms_process_pointer (p
->pid
);
1547 give_back_vms_process_stuff (vs
);
1551 if (outchannel
&& outchannel
!= inchannel
)
1555 XFASTINT (p
->infd
) = 0;
1556 XFASTINT (p
->outfd
) = 0;
1557 chan_process
[inchannel
] = Qnil
;
1558 FD_CLR (inchannel
, &input_wait_mask
);
1562 /* Close all descriptors currently in use for communication
1563 with subprocess. This is used in a newly-forked subprocess
1564 to get rid of irrelevant descriptors. */
1566 close_process_descs ()
1569 for (i
= 0; i
< MAXDESC
; i
++)
1571 Lisp_Object process
;
1572 process
= chan_process
[i
];
1573 if (!NILP (process
))
1575 int in
= XFASTINT (XPROCESS (process
)->infd
);
1576 int out
= XFASTINT (XPROCESS (process
)->outfd
);
1579 if (out
&& in
!= out
)
1585 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1587 "Allow any pending output from subprocesses to be read by Emacs.\n\
1588 It is read into the process' buffers or given to their filter functions.\n\
1589 Non-nil arg PROCESS means do not return until some output has been received\n\
1591 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1592 seconds and microseconds to wait; return after that much time whether\n\
1593 or not there is input.\n\
1594 Return non-nil iff we received any output before the timeout expired.")
1595 (proc
, timeout
, timeout_msecs
)
1596 register Lisp_Object proc
, timeout
, timeout_msecs
;
1601 if (! NILP (timeout_msecs
))
1603 CHECK_NUMBER (timeout_msecs
, 2);
1604 useconds
= XINT (timeout_msecs
);
1605 if (XTYPE (timeout
) != Lisp_Int
)
1606 XSET (timeout
, Lisp_Int
, 0);
1609 int carry
= useconds
/ 1000000;
1611 XSETINT (timeout
, XINT (timeout
) + carry
);
1612 useconds
-= carry
* 1000000;
1614 /* I think this clause is necessary because C doesn't
1615 guarantee a particular rounding direction for negative
1619 XSETINT (timeout
, XINT (timeout
) - 1);
1620 useconds
+= 1000000;
1627 if (! NILP (timeout
))
1629 CHECK_NUMBER (timeout
, 1);
1630 seconds
= XINT (timeout
);
1643 XFASTINT (proc
) = 0;
1646 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1650 /* This variable is different from waiting_for_input in keyboard.c.
1651 It is used to communicate to a lisp process-filter/sentinel (via the
1652 function Fwaiting_for_user_input_p below) whether emacs was waiting
1653 for user-input when that process-filter was called.
1654 waiting_for_input cannot be used as that is by definition 0 when
1655 lisp code is being evalled */
1656 static int waiting_for_user_input_p
;
1658 /* Read and dispose of subprocess output while waiting for timeout to
1659 elapse and/or keyboard input to be available.
1662 timeout in seconds, or
1663 zero for no limit, or
1664 -1 means gobble data immediately available but don't wait for any.
1667 an additional duration to wait, measured in microseconds.
1668 If this is nonzero and time_limit is 0, then the timeout
1669 consists of MICROSECS only.
1671 READ_KBD is a lisp value:
1672 0 to ignore keyboard input, or
1673 1 to return when input is available, or
1674 -1 meaning caller will actually read the input, so don't throw to
1675 the quit handler, or
1676 a cons cell, meaning wait wait until its car is non-nil
1677 (and gobble terminal input into the buffer if any arrives), or
1678 a process object, meaning wait until something arrives from that
1679 process. The return value is true iff we read some input from
1682 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1683 output that arrives.
1685 If READ_KBD is a pointer to a struct Lisp_Process, then the
1686 function returns true iff we received input from that process
1687 before the timeout elapsed.
1688 Otherwise, return true iff we received input from any process. */
1690 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1691 int time_limit
, microsecs
;
1692 Lisp_Object read_kbd
;
1695 register int channel
, nfds
, m
;
1696 static SELECT_TYPE Available
;
1699 EMACS_TIME timeout
, end_time
, garbage
;
1701 int wait_channel
= 0;
1702 struct Lisp_Process
*wait_proc
= 0;
1703 int got_some_input
= 0;
1704 Lisp_Object
*wait_for_cell
= 0;
1706 FD_ZERO (&Available
);
1708 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1710 if (XTYPE (read_kbd
) == Lisp_Process
)
1712 wait_proc
= XPROCESS (read_kbd
);
1713 wait_channel
= XFASTINT (wait_proc
->infd
);
1714 XFASTINT (read_kbd
) = 0;
1717 /* If waiting for non-nil in a cell, record where. */
1718 if (XTYPE (read_kbd
) == Lisp_Cons
)
1720 wait_for_cell
= &XCONS (read_kbd
)->car
;
1721 XFASTINT (read_kbd
) = 0;
1724 waiting_for_user_input_p
= XINT (read_kbd
);
1726 /* Since we may need to wait several times,
1727 compute the absolute time to return at. */
1728 if (time_limit
|| microsecs
)
1730 EMACS_GET_TIME (end_time
);
1731 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1732 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1737 /* If calling from keyboard input, do not quit
1738 since we want to return C-g as an input character.
1739 Otherwise, do pending quit if requested. */
1740 if (XINT (read_kbd
) >= 0)
1743 /* Compute time from now till when time limit is up */
1744 /* Exit if already run out */
1745 if (time_limit
== -1)
1747 /* -1 specified for timeout means
1748 gobble output available now
1749 but don't wait at all. */
1751 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1753 else if (time_limit
|| microsecs
)
1755 EMACS_GET_TIME (timeout
);
1756 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1757 if (EMACS_TIME_NEG_P (timeout
))
1762 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1765 /* Cause C-g and alarm signals to take immediate action,
1766 and cause input available signals to zero out timeout.
1768 It is important that we do this before checking for process
1769 activity. If we get a SIGCHLD after the explicit checks for
1770 process activity, timeout is the only way we will know. */
1771 if (XINT (read_kbd
) < 0)
1772 set_waiting_for_input (&timeout
);
1774 /* If status of something has changed, and no input is
1775 available, notify the user of the change right away. After
1776 this explicit check, we'll let the SIGCHLD handler zap
1777 timeout to get our attention. */
1778 if (update_tick
!= process_tick
&& do_display
)
1780 Atemp
= input_wait_mask
;
1781 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1782 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1784 /* It's okay for us to do this and then continue with
1785 the loop, since timeout has already been zeroed out. */
1786 clear_waiting_for_input ();
1791 /* Don't wait for output from a non-running process. */
1792 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1793 update_status (wait_proc
);
1795 && ! EQ (wait_proc
->status
, Qrun
))
1797 clear_waiting_for_input ();
1801 /* Wait till there is something to do */
1803 Available
= input_wait_mask
;
1804 if (! XINT (read_kbd
) && wait_for_cell
== 0)
1805 FD_CLR (0, &Available
);
1807 /* If frame size has changed or the window is newly mapped,
1808 redisplay now, before we start to wait. There is a race
1809 condition here; if a SIGIO arrives between now and the select
1810 and indicates that a frame is trashed, the select may block
1811 displaying a trashed screen. */
1813 redisplay_preserve_echo_area ();
1815 if (XINT (read_kbd
) && detect_input_pending ())
1818 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1822 /* Make C-g and alarm signals set flags again */
1823 clear_waiting_for_input ();
1825 /* If we woke up due to SIGWINCH, actually change size now. */
1826 do_pending_window_change ();
1828 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1832 if (xerrno
== EINTR
)
1833 FD_ZERO (&Available
);
1835 /* Ultrix select seems to return ENOMEM when it is
1836 interrupted. Treat it just like EINTR. Bleah. Note
1837 that we want to test for the "ultrix" CPP symbol, not
1838 "__ultrix__"; the latter is only defined under GCC, but
1839 not by DEC's bundled CC. -JimB */
1840 else if (xerrno
== ENOMEM
)
1841 FD_ZERO (&Available
);
1844 /* This happens for no known reason on ALLIANT.
1845 I am guessing that this is the right response. -- RMS. */
1846 else if (xerrno
== EFAULT
)
1847 FD_ZERO (&Available
);
1849 else if (xerrno
== EBADF
)
1852 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1853 the child's closure of the pts gives the parent a SIGHUP, and
1854 the ptc file descriptor is automatically closed,
1855 yielding EBADF here or at select() call above.
1856 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1857 in m-ibmrt-aix.h), and here we just ignore the select error.
1858 Cleanup occurs c/o status_notify after SIGCLD. */
1859 FD_ZERO (&Available
); /* Cannot depend on values returned */
1865 error("select error: %s", sys_errlist
[xerrno
]);
1867 #if defined(sun) && !defined(USG5_4)
1868 else if (nfds
> 0 && FD_ISSET (0, &Available
) && interrupt_input
)
1869 /* System sometimes fails to deliver SIGIO.
1871 David J. Mackenzie says that Emacs doesn't compile under
1872 Solaris if this code is enabled, thus the USG5_4 in the CPP
1873 conditional. "I haven't noticed any ill effects so far.
1874 If you find a Solaris expert somewhere, they might know
1876 kill (getpid (), SIGIO
);
1879 /* Check for keyboard input */
1880 /* If there is any, return immediately
1881 to give it higher priority than subprocesses */
1883 if ((XINT (read_kbd
) || wait_for_cell
)
1884 && detect_input_pending ())
1887 if (detect_input_pending ())
1891 /* Exit now if the cell we're waiting for became non-nil. */
1892 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1896 /* If we think we have keyboard input waiting, but didn't get SIGIO
1897 go read it. This can happen with X on BSD after logging out.
1898 In that case, there really is no input and no SIGIO,
1899 but select says there is input. */
1901 if (XINT (read_kbd
) && interrupt_input
&& (FD_ISSET (fileno (stdin
), &Available
)))
1906 got_some_input
|= nfds
> 0;
1908 /* If checking input just got us a size-change event from X,
1909 obey it now if we should. */
1910 if (XINT (read_kbd
) || wait_for_cell
)
1911 do_pending_window_change ();
1913 /* Check for data from a process or a command channel */
1914 for (channel
= FIRST_PROC_DESC
; channel
< MAXDESC
; channel
++)
1916 if (FD_ISSET (channel
, &Available
))
1920 /* If waiting for this channel, arrange to return as
1921 soon as no more input to be processed. No more
1923 if (wait_channel
== channel
)
1929 proc
= chan_process
[channel
];
1933 /* Read data from the process, starting with our
1934 buffered-ahead character if we have one. */
1936 nread
= read_process_output (proc
, channel
);
1939 /* Since read_process_output can run a filter,
1940 which can call accept-process-output,
1941 don't try to read from any other processes
1942 before doing the select again. */
1943 FD_ZERO (&Available
);
1946 redisplay_preserve_echo_area ();
1949 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1953 else if (nread
== -1 && errno
== EAGAIN
)
1957 else if (nread
== -1 && errno
== EAGAIN
)
1959 /* Note that we cannot distinguish between no input
1960 available now and a closed pipe.
1961 With luck, a closed pipe will be accompanied by
1962 subprocess termination and SIGCHLD. */
1963 else if (nread
== 0 && !NETCONN_P (proc
))
1965 #endif /* O_NDELAY */
1966 #endif /* O_NONBLOCK */
1967 #endif /* EWOULDBLOCK */
1969 /* On some OSs with ptys, when the process on one end of
1970 a pty exits, the other end gets an error reading with
1971 errno = EIO instead of getting an EOF (0 bytes read).
1972 Therefore, if we get an error reading and errno =
1973 EIO, just continue, because the child process has
1974 exited and should clean itself up soon (e.g. when we
1976 else if (nread
== -1 && errno
== EIO
)
1978 #endif /* HAVE_PTYS */
1979 /* If we can detect process termination, don't consider the process
1980 gone just because its pipe is closed. */
1982 else if (nread
== 0 && !NETCONN_P (proc
))
1987 /* Preserve status of processes already terminated. */
1988 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
1989 deactivate_process (proc
);
1990 if (!NILP (XPROCESS (proc
)->raw_status_low
))
1991 update_status (XPROCESS (proc
));
1992 if (EQ (XPROCESS (proc
)->status
, Qrun
))
1993 XPROCESS (proc
)->status
1994 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
1997 } /* end for each file descriptor */
1998 } /* end while exit conditions not met */
2000 /* If calling from keyboard input, do not quit
2001 since we want to return C-g as an input character.
2002 Otherwise, do pending quit if requested. */
2003 if (XINT (read_kbd
) >= 0)
2005 /* Prevent input_pending from remaining set if we quit. */
2006 clear_input_pending ();
2010 return got_some_input
;
2013 /* Read pending output from the process channel,
2014 starting with our buffered-ahead character if we have one.
2015 Yield number of characters read.
2017 This function reads at most 1024 characters.
2018 If you want to read all available subprocess output,
2019 you must call it repeatedly until it returns zero. */
2021 read_process_output (proc
, channel
)
2023 register int channel
;
2025 register int nchars
;
2031 register Lisp_Object outstream
;
2032 register struct buffer
*old
= current_buffer
;
2033 register struct Lisp_Process
*p
= XPROCESS (proc
);
2034 register int opoint
;
2037 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2039 vs
= get_vms_process_pointer (p
->pid
);
2043 return(0); /* Really weird if it does this */
2044 if (!(vs
->iosb
[0] & 1))
2045 return -1; /* I/O error */
2048 error ("Could not get VMS process pointer");
2049 chars
= vs
->inputBuffer
;
2050 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2053 start_vms_process_read (vs
); /* Crank up the next read on the process */
2054 return 1; /* Nothing worth printing, say we got 1 */
2058 if (proc_buffered_char
[channel
] < 0)
2059 nchars
= read (channel
, chars
, sizeof chars
);
2062 chars
[0] = proc_buffered_char
[channel
];
2063 proc_buffered_char
[channel
] = -1;
2064 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2068 nchars
= nchars
+ 1;
2070 #endif /* not VMS */
2072 if (nchars
<= 0) return nchars
;
2074 outstream
= p
->filter
;
2075 if (!NILP (outstream
))
2077 /* We inhibit quit here instead of just catching it so that
2078 hitting ^G when a filter happens to be running won't screw
2080 int count
= specpdl_ptr
- specpdl
;
2081 Lisp_Object odeactivate
;
2083 odeactivate
= Vdeactivate_mark
;
2085 specbind (Qinhibit_quit
, Qt
);
2086 call2 (outstream
, proc
, make_string (chars
, nchars
));
2088 /* Handling the process output should not deactivate the mark. */
2089 Vdeactivate_mark
= odeactivate
;
2092 start_vms_process_read (vs
);
2098 /* If no filter, write into buffer if it isn't dead. */
2099 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2101 Lisp_Object old_read_only
;
2102 Lisp_Object old_begv
, old_zv
;
2103 Lisp_Object odeactivate
;
2105 odeactivate
= Vdeactivate_mark
;
2107 Fset_buffer (p
->buffer
);
2109 old_read_only
= current_buffer
->read_only
;
2110 XFASTINT (old_begv
) = BEGV
;
2111 XFASTINT (old_zv
) = ZV
;
2113 current_buffer
->read_only
= Qnil
;
2115 /* Insert new output into buffer
2116 at the current end-of-output marker,
2117 thus preserving logical ordering of input and output. */
2118 if (XMARKER (p
->mark
)->buffer
)
2119 SET_PT (marker_position (p
->mark
));
2123 /* If the output marker is outside of the visible region, save
2124 the restriction and widen. */
2125 if (! (BEGV
<= point
&& point
<= ZV
))
2128 /* Make sure opoint floats ahead of any new text, just as point
2130 if (point
<= opoint
)
2133 /* Insert after old_begv, but before old_zv. */
2134 if (point
< XFASTINT (old_begv
))
2135 XFASTINT (old_begv
) += nchars
;
2136 if (point
<= XFASTINT (old_zv
))
2137 XFASTINT (old_zv
) += nchars
;
2139 /* Insert before markers in case we are inserting where
2140 the buffer's mark is, and the user's next command is Meta-y. */
2141 insert_before_markers (chars
, nchars
);
2142 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2144 update_mode_lines
++;
2146 /* If the restriction isn't what it should be, set it. */
2147 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2148 Fnarrow_to_region (old_begv
, old_zv
);
2150 /* Handling the process output should not deactivate the mark. */
2151 Vdeactivate_mark
= odeactivate
;
2153 current_buffer
->read_only
= old_read_only
;
2155 set_buffer_internal (old
);
2158 start_vms_process_read (vs
);
2163 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2165 "Returns non-NIL if emacs is waiting for input from the user.\n\
2166 This is intended for use by asynchronous process output filters and sentinels.")
2169 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2172 /* Sending data to subprocess */
2174 jmp_buf send_process_frame
;
2177 send_process_trap ()
2183 longjmp (send_process_frame
, 1);
2186 send_process (proc
, buf
, len
)
2191 /* Don't use register vars; longjmp can lose them. */
2193 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2197 struct Lisp_Process
*p
= XPROCESS (proc
);
2198 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2201 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2202 update_status (XPROCESS (proc
));
2203 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2204 error ("Process %s not running", procname
);
2207 vs
= get_vms_process_pointer (p
->pid
);
2209 error ("Could not find this process: %x", p
->pid
);
2210 else if (write_to_vms_process (vs
, buf
, len
))
2213 if (!setjmp (send_process_frame
))
2217 SIGTYPE (*old_sigpipe
)();
2219 /* Don't send more than 500 bytes at a time. */
2222 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2223 rv
= write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, this);
2224 signal (SIGPIPE
, old_sigpipe
);
2229 || errno
== EWOULDBLOCK
2236 /* It would be nice to accept process output here,
2237 but that is difficult. For example, it could
2238 garbage what we are sending if that is from a buffer. */
2245 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2249 /* Allow input from processes between bursts of sending.
2250 Otherwise things may get stopped up. */
2255 XFASTINT (zero
) = 0;
2256 wait_reading_process_input (-1, 0, zero
, 0);
2262 XPROCESS (proc
)->raw_status_low
= Qnil
;
2263 XPROCESS (proc
)->raw_status_high
= Qnil
;
2264 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2265 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2266 deactivate_process (proc
);
2268 error ("Error writing to process %s; closed it", procname
);
2270 error ("SIGPIPE raised on process %s; closed it", procname
);
2275 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2277 "Send current contents of region as input to PROCESS.\n\
2278 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2279 nil, indicating the current buffer's process.\n\
2280 Called from program, takes three arguments, PROCESS, START and END.\n\
2281 If the region is more than 500 characters long,\n\
2282 it is sent in several bunches. This may happen even for shorter regions.\n\
2283 Output from processes can arrive in between bunches.")
2284 (process
, start
, end
)
2285 Lisp_Object process
, start
, end
;
2290 proc
= get_process (process
);
2291 validate_region (&start
, &end
);
2293 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2296 start1
= XINT (start
);
2297 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2302 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2304 "Send PROCESS the contents of STRING as input.\n\
2305 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2306 nil, indicating the current buffer's process.\n\
2307 If STRING is more than 500 characters long,\n\
2308 it is sent in several bunches. This may happen even for shorter strings.\n\
2309 Output from processes can arrive in between bunches.")
2311 Lisp_Object process
, string
;
2314 CHECK_STRING (string
, 1);
2315 proc
= get_process (process
);
2316 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2320 /* send a signal number SIGNO to PROCESS.
2321 CURRENT_GROUP means send to the process group that currently owns
2322 the terminal being used to communicate with PROCESS.
2323 This is used for various commands in shell mode.
2324 If NOMSG is zero, insert signal-announcements into process's buffers
2327 If we can, we try to signal PROCESS by sending control characters
2328 down the pipe. This allows us to signal inferiors who have changed
2329 their uid, for which killpg would return an EPERM error. */
2332 process_send_signal (process
, signo
, current_group
, nomsg
)
2333 Lisp_Object process
;
2335 Lisp_Object current_group
;
2339 register struct Lisp_Process
*p
;
2343 proc
= get_process (process
);
2344 p
= XPROCESS (proc
);
2346 if (!EQ (p
->childp
, Qt
))
2347 error ("Process %s is not a subprocess",
2348 XSTRING (p
->name
)->data
);
2349 if (!XFASTINT (p
->infd
))
2350 error ("Process %s is not active",
2351 XSTRING (p
->name
)->data
);
2353 if (NILP (p
->pty_flag
))
2354 current_group
= Qnil
;
2356 /* If we are using pgrps, get a pgrp number and make it negative. */
2357 if (!NILP (current_group
))
2359 #ifdef SIGNALS_VIA_CHARACTERS
2360 /* If possible, send signals to the entire pgrp
2361 by sending an input character to it. */
2363 /* TERMIOS is the latest and bestest, and seems most likely to
2364 work. If the system has it, use it. */
2371 tcgetattr (XFASTINT (p
->infd
), &t
);
2372 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2376 tcgetattr (XFASTINT (p
->infd
), &t
);
2377 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2381 tcgetattr (XFASTINT (p
->infd
), &t
);
2383 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2385 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2390 #else /* ! HAVE_TERMIOS */
2392 /* On Berkeley descendants, the following IOCTL's retrieve the
2393 current control characters. */
2394 #if defined (TIOCGLTC) && defined (TIOCGETC)
2402 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2403 send_process (proc
, &c
.t_intrc
, 1);
2406 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2407 send_process (proc
, &c
.t_quitc
, 1);
2411 ioctl (XFASTINT (p
->infd
), TIOCGLTC
, &lc
);
2412 send_process (proc
, &lc
.t_suspc
, 1);
2414 #endif /* ! defined (SIGTSTP) */
2417 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2419 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2426 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2427 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2430 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2431 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2435 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2436 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2438 #endif /* ! defined (SIGTSTP) */
2440 #else /* ! defined (TCGETA) */
2441 Your configuration files are messed up
.
2442 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2443 you'd better be using one of the alternatives above! */
2444 #endif /* ! defined (TCGETA) */
2445 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2446 #endif /* ! defined HAVE_TERMIOS */
2447 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2450 /* Get the pgrp using the tty itself, if we have that.
2451 Otherwise, use the pty to get the pgrp.
2452 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2453 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2454 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2455 His patch indicates that if TIOCGPGRP returns an error, then
2456 we should just assume that p->pid is also the process group id. */
2460 if (!NILP (p
->subtty
))
2461 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2463 err
= ioctl (XFASTINT (p
->infd
), TIOCGPGRP
, &gid
);
2467 gid
= - XFASTINT (p
->pid
);
2468 #endif /* ! defined (pfa) */
2474 #else /* ! defined (TIOCGPGRP ) */
2475 /* Can't select pgrps on this system, so we know that
2476 the child itself heads the pgrp. */
2477 gid
= - XFASTINT (p
->pid
);
2478 #endif /* ! defined (TIOCGPGRP ) */
2481 gid
= - XFASTINT (p
->pid
);
2487 p
->raw_status_low
= Qnil
;
2488 p
->raw_status_high
= Qnil
;
2490 XSETINT (p
->tick
, ++process_tick
);
2494 #endif /* ! defined (SIGCONT) */
2497 send_process (proc
, "\003", 1); /* ^C */
2502 send_process (proc
, "\031", 1); /* ^Y */
2507 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2510 flush_pending_output (XFASTINT (p
->infd
));
2514 /* If we don't have process groups, send the signal to the immediate
2515 subprocess. That isn't really right, but it's better than any
2516 obvious alternative. */
2519 kill (XFASTINT (p
->pid
), signo
);
2523 /* gid may be a pid, or minus a pgrp's number */
2525 if (!NILP (current_group
))
2526 ioctl (XFASTINT (p
->infd
), TIOCSIGSEND
, signo
);
2529 gid
= - XFASTINT (p
->pid
);
2532 #else /* ! defined (TIOCSIGSEND) */
2533 EMACS_KILLPG (-gid
, signo
);
2534 #endif /* ! defined (TIOCSIGSEND) */
2537 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2538 "Interrupt process PROCESS. May be process or name of one.\n\
2539 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2540 Nil or no arg means current buffer's process.\n\
2541 Second arg CURRENT-GROUP non-nil means send signal to\n\
2542 the current process-group of the process's controlling terminal\n\
2543 rather than to the process's own process group.\n\
2544 If the process is a shell, this means interrupt current subjob\n\
2545 rather than the shell.")
2546 (process
, current_group
)
2547 Lisp_Object process
, current_group
;
2549 process_send_signal (process
, SIGINT
, current_group
, 0);
2553 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2554 "Kill process PROCESS. May be process or name of one.\n\
2555 See function `interrupt-process' for more details on usage.")
2556 (process
, current_group
)
2557 Lisp_Object process
, current_group
;
2559 process_send_signal (process
, SIGKILL
, current_group
, 0);
2563 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2564 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2565 See function `interrupt-process' for more details on usage.")
2566 (process
, current_group
)
2567 Lisp_Object process
, current_group
;
2569 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2573 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2574 "Stop process PROCESS. May be process or name of one.\n\
2575 See function `interrupt-process' for more details on usage.")
2576 (process
, current_group
)
2577 Lisp_Object process
, current_group
;
2580 error ("no SIGTSTP support");
2582 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2587 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2588 "Continue process PROCESS. May be process or name of one.\n\
2589 See function `interrupt-process' for more details on usage.")
2590 (process
, current_group
)
2591 Lisp_Object process
, current_group
;
2594 process_send_signal (process
, SIGCONT
, current_group
, 0);
2596 error ("no SIGCONT support");
2601 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2602 2, 2, "nProcess number: \nnSignal code: ",
2603 "Send the process with number PID the signal with code CODE.\n\
2604 Both PID and CODE are integers.")
2606 Lisp_Object pid
, sig
;
2608 CHECK_NUMBER (pid
, 0);
2609 CHECK_NUMBER (sig
, 1);
2610 return make_number (kill (XINT (pid
), XINT (sig
)));
2613 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2614 "Make PROCESS see end-of-file in its input.\n\
2615 Eof comes after any text already sent to it.\n\
2616 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2617 nil, indicating the current buffer's process.")
2619 Lisp_Object process
;
2623 proc
= get_process (process
);
2625 /* Make sure the process is really alive. */
2626 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2627 update_status (XPROCESS (proc
));
2628 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2629 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2631 /* Sending a zero-length record is supposed to mean eof
2632 when TIOCREMOTE is turned on. */
2636 write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, 0);
2638 #else /* did not do TOICREMOTE */
2640 send_process (proc
, "\032", 1); /* ^z */
2642 if (!NILP (XPROCESS (proc
)->pty_flag
))
2643 send_process (proc
, "\004", 1);
2646 close (XPROCESS (proc
)->outfd
);
2647 XFASTINT (XPROCESS (proc
)->outfd
) = open (NULL_DEVICE
, O_WRONLY
);
2650 #endif /* did not do TOICREMOTE */
2654 /* Kill all processes associated with `buffer'.
2655 If `buffer' is nil, kill all processes */
2657 kill_buffer_processes (buffer
)
2660 Lisp_Object tail
, proc
;
2662 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2663 tail
= XCONS (tail
)->cdr
)
2665 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2666 if (XGCTYPE (proc
) == Lisp_Process
2667 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2669 if (NETCONN_P (proc
))
2670 deactivate_process (proc
);
2671 else if (XFASTINT (XPROCESS (proc
)->infd
))
2672 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2677 /* On receipt of a signal that a child status has changed,
2678 loop asking about children with changed statuses until
2679 the system says there are no more.
2680 All we do is change the status;
2681 we do not run sentinels or print notifications.
2682 That is saved for the next time keyboard input is done,
2683 in order to avoid timing errors. */
2685 /** WARNING: this can be called during garbage collection.
2686 Therefore, it must not be fooled by the presence of mark bits in
2689 /** USG WARNING: Although it is not obvious from the documentation
2690 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2691 signal() before executing at least one wait(), otherwise the handler
2692 will be called again, resulting in an infinite loop. The relevant
2693 portion of the documentation reads "SIGCLD signals will be queued
2694 and the signal-catching function will be continually reentered until
2695 the queue is empty". Invoking signal() causes the kernel to reexamine
2696 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2699 sigchld_handler (signo
)
2702 int old_errno
= errno
;
2704 register struct Lisp_Process
*p
;
2705 extern EMACS_TIME
*input_available_clear_time
;
2709 sigheld
|= sigbit (SIGCHLD
);
2721 #endif /* no WUNTRACED */
2722 /* Keep trying to get a status until we get a definitive result. */
2726 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2728 while (pid
<= 0 && errno
== EINTR
);
2732 /* A real failure. We have done all our job, so return. */
2734 /* USG systems forget handlers when they are used;
2735 must reestablish each time */
2737 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2740 sigheld
&= ~sigbit (SIGCHLD
);
2748 #endif /* no WNOHANG */
2750 /* Find the process that signaled us, and record its status. */
2753 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2755 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2756 p
= XPROCESS (proc
);
2757 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2762 /* Look for an asynchronous process whose pid hasn't been filled
2765 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2767 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2768 p
= XPROCESS (proc
);
2769 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2774 /* Change the status of the process that was found. */
2777 union { int i
; WAITTYPE wt
; } u
;
2779 XSETINT (p
->tick
, ++process_tick
);
2781 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2782 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2784 /* If process has terminated, stop waiting for its output. */
2785 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2786 if (XFASTINT (p
->infd
))
2787 FD_CLR (XFASTINT (p
->infd
), &input_wait_mask
);
2789 /* Tell wait_reading_process_input that it needs to wake up and
2791 if (input_available_clear_time
)
2792 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2795 /* There was no asynchronous process found for that id. Check
2796 if we have a synchronous process. */
2799 synch_process_alive
= 0;
2801 /* Report the status of the synchronous process. */
2803 synch_process_retcode
= WRETCODE (w
);
2804 else if (WIFSIGNALED (w
))
2806 synch_process_death
= (char *) sys_siglist
[WTERMSIG (w
)];
2808 synch_process_death
= sys_errlist
[WTERMSIG (w
)];
2811 /* Tell wait_reading_process_input that it needs to wake up and
2813 if (input_available_clear_time
)
2814 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2817 /* On some systems, we must return right away.
2818 If any more processes want to signal us, we will
2820 Otherwise (on systems that have WNOHANG), loop around
2821 to use up all the processes that have something to tell us. */
2822 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2824 signal (signo
, sigchld_handler
);
2828 #endif /* USG, but not HPUX with WNOHANG */
2834 exec_sentinel_unwind (data
)
2837 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2842 exec_sentinel (proc
, reason
)
2843 Lisp_Object proc
, reason
;
2845 Lisp_Object sentinel
;
2846 register struct Lisp_Process
*p
= XPROCESS (proc
);
2847 int count
= specpdl_ptr
- specpdl
;
2849 sentinel
= p
->sentinel
;
2850 if (NILP (sentinel
))
2853 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2854 assure that it gets restored no matter how the sentinel exits. */
2856 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2857 /* Inhibit quit so that random quits don't screw up a running filter. */
2858 specbind (Qinhibit_quit
, Qt
);
2859 call2 (sentinel
, proc
, reason
);
2863 /* Report all recent events of a change in process status
2864 (either run the sentinel or output a message).
2865 This is done while Emacs is waiting for keyboard input. */
2869 register Lisp_Object proc
, buffer
;
2870 Lisp_Object tail
= Qnil
;
2871 Lisp_Object msg
= Qnil
;
2872 struct gcpro gcpro1
, gcpro2
;
2874 /* We need to gcpro tail; if read_process_output calls a filter
2875 which deletes a process and removes the cons to which tail points
2876 from Vprocess_alist, and then causes a GC, tail is an unprotected
2880 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2883 register struct Lisp_Process
*p
;
2885 proc
= Fcdr (Fcar (tail
));
2886 p
= XPROCESS (proc
);
2888 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2890 XSETINT (p
->update_tick
, XINT (p
->tick
));
2892 /* If process is still active, read any output that remains. */
2893 if (XFASTINT (p
->infd
))
2894 while (read_process_output (proc
, XFASTINT (p
->infd
)) > 0);
2898 /* Get the text to use for the message. */
2899 if (!NILP (p
->raw_status_low
))
2901 msg
= status_message (p
->status
);
2903 /* If process is terminated, deactivate it or delete it. */
2905 if (XTYPE (p
->status
) == Lisp_Cons
)
2906 symbol
= XCONS (p
->status
)->car
;
2908 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2909 || EQ (symbol
, Qclosed
))
2911 if (delete_exited_processes
)
2912 remove_process (proc
);
2914 deactivate_process (proc
);
2917 /* Now output the message suitably. */
2918 if (!NILP (p
->sentinel
))
2919 exec_sentinel (proc
, msg
);
2920 /* Don't bother with a message in the buffer
2921 when a process becomes runnable. */
2922 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2924 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2926 struct buffer
*old
= current_buffer
;
2929 /* Avoid error if buffer is deleted
2930 (probably that's why the process is dead, too) */
2931 if (NILP (XBUFFER (buffer
)->name
))
2933 Fset_buffer (buffer
);
2935 /* Insert new output into buffer
2936 at the current end-of-output marker,
2937 thus preserving logical ordering of input and output. */
2938 if (XMARKER (p
->mark
)->buffer
)
2939 SET_PT (marker_position (p
->mark
));
2942 if (point
<= opoint
)
2943 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2945 tem
= current_buffer
->read_only
;
2946 current_buffer
->read_only
= Qnil
;
2947 insert_string ("\nProcess ");
2948 Finsert (1, &p
->name
);
2949 insert_string (" ");
2951 current_buffer
->read_only
= tem
;
2952 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2955 set_buffer_internal (old
);
2960 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
2961 redisplay_preserve_echo_area ();
2963 update_tick
= process_tick
;
2974 if (! noninteractive
|| initialized
)
2976 signal (SIGCHLD
, sigchld_handler
);
2979 FD_ZERO (&input_wait_mask
);
2980 FD_SET (0, &input_wait_mask
);
2981 Vprocess_alist
= Qnil
;
2982 for (i
= 0; i
< MAXDESC
; i
++)
2984 chan_process
[i
] = Qnil
;
2985 proc_buffered_char
[i
] = -1;
2989 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 0, 1, 0,
2990 "Return the connection type of `PROCESS'. This can be nil (pipe),\n\
2991 t or pty (pty) or stream (socket connection).")
2993 Lisp_Object process
;
2995 return XPROCESS (process
)->type
;
3001 stream_process
= intern ("stream");
3003 Qprocessp
= intern ("processp");
3004 staticpro (&Qprocessp
);
3005 Qrun
= intern ("run");
3007 Qstop
= intern ("stop");
3009 Qsignal
= intern ("signal");
3010 staticpro (&Qsignal
);
3012 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3015 Qexit = intern ("exit");
3016 staticpro (&Qexit); */
3018 Qopen
= intern ("open");
3020 Qclosed
= intern ("closed");
3021 staticpro (&Qclosed
);
3023 staticpro (&Vprocess_alist
);
3025 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3026 "*Non-nil means delete processes immediately when they exit.\n\
3027 nil means don't delete them until `list-processes' is run.");
3029 delete_exited_processes
= 1;
3031 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3032 "Control type of device used to communicate with subprocesses.\n\
3033 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3034 pty's are not available, this variable will be ignored. The value takes\n\
3035 effect when `start-process' is called.");
3036 Vprocess_connection_type
= Qt
;
3038 defsubr (&Sprocessp
);
3039 defsubr (&Sget_process
);
3040 defsubr (&Sget_buffer_process
);
3041 defsubr (&Sdelete_process
);
3042 defsubr (&Sprocess_status
);
3043 defsubr (&Sprocess_exit_status
);
3044 defsubr (&Sprocess_id
);
3045 defsubr (&Sprocess_name
);
3046 defsubr (&Sprocess_command
);
3047 defsubr (&Sset_process_buffer
);
3048 defsubr (&Sprocess_buffer
);
3049 defsubr (&Sprocess_mark
);
3050 defsubr (&Sset_process_filter
);
3051 defsubr (&Sprocess_filter
);
3052 defsubr (&Sset_process_sentinel
);
3053 defsubr (&Sprocess_sentinel
);
3054 defsubr (&Sprocess_kill_without_query
);
3055 defsubr (&Slist_processes
);
3056 defsubr (&Sprocess_list
);
3057 defsubr (&Sstart_process
);
3059 defsubr (&Sopen_network_stream
);
3060 #endif /* HAVE_SOCKETS */
3061 defsubr (&Saccept_process_output
);
3062 defsubr (&Sprocess_send_region
);
3063 defsubr (&Sprocess_send_string
);
3064 defsubr (&Sinterrupt_process
);
3065 defsubr (&Skill_process
);
3066 defsubr (&Squit_process
);
3067 defsubr (&Sstop_process
);
3068 defsubr (&Scontinue_process
);
3069 defsubr (&Sprocess_send_eof
);
3070 defsubr (&Ssignal_process
);
3071 defsubr (&Swaiting_for_user_input_p
);
3072 /* defsubr (&Sprocess_connection); */
3076 #else /* not subprocesses */
3078 #include <sys/types.h>
3082 #include "systime.h"
3083 #include "termopts.h"
3085 extern int frame_garbaged
;
3088 /* As described above, except assuming that there are no subprocesses:
3090 Wait for timeout to elapse and/or keyboard input to be available.
3093 timeout in seconds, or
3094 zero for no limit, or
3095 -1 means gobble data immediately available but don't wait for any.
3097 read_kbd is a Lisp_Object:
3098 0 to ignore keyboard input, or
3099 1 to return when input is available, or
3100 -1 means caller will actually read the input, so don't throw to
3102 We know that read_kbd will never be a Lisp_Process, since
3103 `subprocesses' isn't defined.
3105 do_display != 0 means redisplay should be done to show subprocess
3106 output that arrives. This version of the function ignores it.
3108 Return true iff we received input from any process. */
3111 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3112 int time_limit
, microsecs
;
3113 Lisp_Object read_kbd
;
3116 EMACS_TIME end_time
, timeout
, *timeout_p
;
3119 /* What does time_limit really mean? */
3120 if (time_limit
|| microsecs
)
3122 /* It's not infinite. */
3123 timeout_p
= &timeout
;
3125 if (time_limit
== -1)
3126 /* In fact, it's zero. */
3127 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3129 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3131 /* How far in the future is that? */
3132 EMACS_GET_TIME (end_time
);
3133 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3136 /* It's infinite. */
3139 /* Turn off periodic alarms (in case they are in use)
3140 because the select emulator uses alarms. */
3147 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3149 /* If calling from keyboard input, do not quit
3150 since we want to return C-g as an input character.
3151 Otherwise, do pending quit if requested. */
3152 if (XINT (read_kbd
) >= 0)
3157 EMACS_GET_TIME (*timeout_p
);
3158 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3159 if (EMACS_TIME_NEG_P (*timeout_p
))
3163 /* Cause C-g and alarm signals to take immediate action,
3164 and cause input available signals to zero out timeout. */
3165 if (XINT (read_kbd
) < 0)
3166 set_waiting_for_input (&timeout
);
3168 /* If a frame has been newly mapped and needs updating,
3169 reprocess its display stuff. */
3171 redisplay_preserve_echo_area ();
3173 if (XINT (read_kbd
) && detect_input_pending ())
3176 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3178 /* Make C-g and alarm signals set flags again */
3179 clear_waiting_for_input ();
3181 /* If we woke up due to SIGWINCH, actually change size now. */
3182 do_pending_window_change ();
3186 /* If the system call was interrupted, then go around the
3192 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3193 /* System sometimes fails to deliver SIGIO. */
3194 kill (getpid (), SIGIO
);
3197 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3201 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3213 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3214 "Return the (or, a) process associated with BUFFER.\n\
3215 This copy of Emacs has not been built to support subprocesses, so this\n\
3216 function always returns nil.")
3218 register Lisp_Object name
;
3223 /* Kill all processes associated with `buffer'.
3224 If `buffer' is nil, kill all processes.
3225 Since we have no subprocesses, this does nothing. */
3227 kill_buffer_processes (buffer
)
3238 defsubr (&Sget_buffer_process
);
3242 #endif /* not subprocesses */