1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1992, 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
[];
182 extern char *sys_siglist
[];
184 char *sys_siglist
[] =
190 "illegal instruction",
194 "floating point exception",
197 "segmentation violation",
198 "bad argument to system call",
199 "write on a pipe with no one to read it",
201 "software termination signal from kill",
203 "sendable stop signal not from tty",
204 "stop signal from tty",
205 "continue a stopped process",
206 "child status has changed",
207 "background read attempted from control tty",
208 "background write attempted from control tty",
209 "input record available at control tty",
210 "exceeded CPU time limit",
211 "exceeded file size limit"
216 /* t means use pty, nil means use a pipe,
217 maybe other values to come. */
218 Lisp_Object Vprocess_connection_type
;
222 #include <sys/socket.h>
226 /* Number of events of change of status of a process. */
229 /* Number of events for which the user or sentinel has been notified. */
233 /* We could get this from param.h, but better not to depend on finding that.
234 And better not to risk that it might define other symbols used in this
237 #define SELECT_TYPE fd_set
238 #else /* no FD_SET */
240 #define SELECT_TYPE int
242 /* Define the macros to access a single-int bitmap of descriptors. */
243 #define FD_SET(n, p) (*(p) |= (1 << (n)))
244 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
245 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
246 #define FD_ZERO(p) (*(p) = 0)
247 #endif /* no FD_SET */
249 /* Mask of bits indicating the descriptors that we wait for input on */
251 SELECT_TYPE input_wait_mask
;
253 int delete_exited_processes
;
255 /* Indexed by descriptor, gives the process (if any) for that descriptor */
256 Lisp_Object chan_process
[MAXDESC
];
258 /* Alist of elements (NAME . PROCESS) */
259 Lisp_Object Vprocess_alist
;
261 Lisp_Object Qprocessp
;
263 Lisp_Object
get_process ();
265 /* Buffered-ahead input char from process, indexed by channel.
266 -1 means empty (no char is buffered).
267 Used on sys V where the only way to tell if there is any
268 output from the process is to read at least one char.
269 Always -1 on systems that support FIONREAD. */
271 int proc_buffered_char
[MAXDESC
];
273 /* Compute the Lisp form of the process status, p->status, from
274 the numeric status that was returned by `wait'. */
276 Lisp_Object
status_convert ();
279 struct Lisp_Process
*p
;
281 union { int i
; WAITTYPE wt
; } u
;
282 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
283 p
->status
= status_convert (u
.wt
);
284 p
->raw_status_low
= Qnil
;
285 p
->raw_status_high
= Qnil
;
288 /* Convert a process status work in Unix format to
289 the list that we use internally. */
296 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
297 else if (WIFEXITED (w
))
298 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
299 WCOREDUMP (w
) ? Qt
: Qnil
));
300 else if (WIFSIGNALED (w
))
301 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
302 WCOREDUMP (w
) ? Qt
: Qnil
));
307 /* Given a status-list, extract the three pieces of information
308 and store them individually through the three pointers. */
311 decode_status (l
, symbol
, code
, coredump
)
319 if (XTYPE (l
) == Lisp_Symbol
)
327 *symbol
= XCONS (l
)->car
;
328 tem
= XCONS (l
)->cdr
;
329 *code
= XFASTINT (XCONS (tem
)->car
);
330 tem
= XCONS (tem
)->cdr
;
331 *coredump
= !NILP (tem
);
335 /* Return a string describing a process status list. */
338 status_message (status
)
343 Lisp_Object string
, string2
;
345 decode_status (status
, &symbol
, &code
, &coredump
);
347 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
350 string
= build_string (code
< NSIG
? sys_siglist
[code
] : "unknown");
352 string
= build_string (code
< NSIG
? sys_errlist
[code
] : "unknown");
354 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
355 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
356 return concat2 (string
, string2
);
358 else if (EQ (symbol
, Qexit
))
361 return build_string ("finished\n");
362 string
= Fnumber_to_string (make_number (code
));
363 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
364 return concat2 (build_string ("exited abnormally with code "),
365 concat2 (string
, string2
));
368 return Fcopy_sequence (Fsymbol_name (symbol
));
373 /* Open an available pty, returning a file descriptor.
374 Return -1 on failure.
375 The file name of the terminal corresponding to the pty
376 is left in the variable pty_name. */
387 /* Some systems name their pseudoterminals so that there are gaps in
388 the usual sequence - for example, on HP9000/S700 systems, there
389 are no pseudoterminals with names ending in 'f'. So we wait for
390 three failures in a row before deciding that we've reached the
392 int failed_count
= 0;
397 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
398 for (i
= 0; i
< 16; i
++)
401 #ifdef PTY_NAME_SPRINTF
404 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
405 #endif /* no PTY_NAME_SPRINTF */
409 #else /* no PTY_OPEN */
411 /* Unusual IRIS code */
412 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
415 if (fstat (fd
, &stb
) < 0)
418 if (stat (pty_name
, &stb
) < 0)
421 if (failed_count
>= 3)
427 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
429 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
431 #endif /* not IRIS */
432 #endif /* no PTY_OPEN */
436 /* check to make certain that both sides are available
437 this avoids a nasty yet stupid bug in rlogins */
438 #ifdef PTY_TTY_NAME_SPRINTF
441 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
442 #endif /* no PTY_TTY_NAME_SPRINTF */
444 if (access (pty_name
, 6) != 0)
447 #if !defined(IRIS) && !defined(__sgi)
453 #endif /* not UNIPLUS */
460 #endif /* HAVE_PTYS */
466 register Lisp_Object val
, tem
, name1
;
467 register struct Lisp_Process
*p
;
471 /* size of process structure includes the vector header,
472 so deduct for that. But struct Lisp_Vector includes the first
473 element, thus deducts too much, so add it back. */
474 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
475 - sizeof (struct Lisp_Vector
)
476 + sizeof (Lisp_Object
))
477 / sizeof (Lisp_Object
)),
479 XSETTYPE (val
, Lisp_Process
);
482 XFASTINT (p
->infd
) = 0;
483 XFASTINT (p
->outfd
) = 0;
484 XFASTINT (p
->pid
) = 0;
485 XFASTINT (p
->tick
) = 0;
486 XFASTINT (p
->update_tick
) = 0;
487 p
->raw_status_low
= Qnil
;
488 p
->raw_status_high
= Qnil
;
490 p
->mark
= Fmake_marker ();
492 /* If name is already in use, modify it until it is unused. */
497 tem
= Fget_process (name1
);
498 if (NILP (tem
)) break;
499 sprintf (suffix
, "<%d>", i
);
500 name1
= concat2 (name
, build_string (suffix
));
504 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
508 remove_process (proc
)
509 register Lisp_Object proc
;
511 register Lisp_Object pair
;
513 pair
= Frassq (proc
, Vprocess_alist
);
514 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
515 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
517 deactivate_process (proc
);
520 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
521 "Return t if OBJECT is a process.")
525 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
528 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
529 "Return the process named NAME, or nil if there is none.")
531 register Lisp_Object name
;
533 if (XTYPE (name
) == Lisp_Process
)
535 CHECK_STRING (name
, 0);
536 return Fcdr (Fassoc (name
, Vprocess_alist
));
539 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
540 "Return the (or, a) process associated with BUFFER.\n\
541 BUFFER may be a buffer or the name of one.")
543 register Lisp_Object name
;
545 register Lisp_Object buf
, tail
, proc
;
547 if (NILP (name
)) return Qnil
;
548 buf
= Fget_buffer (name
);
549 if (NILP (buf
)) return Qnil
;
551 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
553 proc
= Fcdr (Fcar (tail
));
554 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
560 /* This is how commands for the user decode process arguments. It
561 accepts a process, a process name, a buffer, a buffer name, or nil.
562 Buffers denote the first process in the buffer, and nil denotes the
567 register Lisp_Object name
;
569 register Lisp_Object proc
;
571 proc
= Fget_buffer_process (Fcurrent_buffer ());
574 proc
= Fget_process (name
);
576 proc
= Fget_buffer_process (Fget_buffer (name
));
583 error ("Current buffer has no process");
585 error ("Process %s does not exist", XSTRING (name
)->data
);
589 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
590 "Delete PROCESS: kill it and forget about it immediately.\n\
591 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
592 nil, indicating the current buffer's process.")
594 register Lisp_Object proc
;
596 proc
= get_process (proc
);
597 XPROCESS (proc
)->raw_status_low
= Qnil
;
598 XPROCESS (proc
)->raw_status_high
= Qnil
;
599 if (NETCONN_P (proc
))
601 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
602 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
604 else if (XFASTINT (XPROCESS (proc
)->infd
))
606 Fkill_process (proc
, Qnil
);
607 /* Do this now, since remove_process will make sigchld_handler do nothing. */
608 XPROCESS (proc
)->status
609 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
610 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
613 remove_process (proc
);
617 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
618 "Return the status of PROCESS: a symbol, one of these:\n\
619 run -- for a process that is running.\n\
620 stop -- for a process stopped but continuable.\n\
621 exit -- for a process that has exited.\n\
622 signal -- for a process that has got a fatal signal.\n\
623 open -- for a network stream connection that is open.\n\
624 closed -- for a network stream connection that is closed.\n\
625 nil -- if arg is a process name and no such process exists.\n\
626 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
627 nil, indicating the current buffer's process.")
628 /* command -- for a command channel opened to Emacs by another process.\n\
629 external -- for an i/o channel opened to Emacs by another process.\n\ */
631 register Lisp_Object proc
;
633 register struct Lisp_Process
*p
;
634 register Lisp_Object status
;
635 proc
= get_process (proc
);
639 if (!NILP (p
->raw_status_low
))
642 if (XTYPE (status
) == Lisp_Cons
)
643 status
= XCONS (status
)->car
;
644 if (NETCONN_P (proc
))
646 if (EQ (status
, Qrun
))
648 else if (EQ (status
, Qexit
))
654 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
656 "Return the exit status of PROCESS or the signal number that killed it.\n\
657 If PROCESS has not yet exited or died, return 0.")
659 register Lisp_Object proc
;
661 CHECK_PROCESS (proc
, 0);
662 if (!NILP (XPROCESS (proc
)->raw_status_low
))
663 update_status (XPROCESS (proc
));
664 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
665 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
666 return make_number (0);
669 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
670 "Return the process id of PROCESS.\n\
671 This is the pid of the Unix process which PROCESS uses or talks to.\n\
672 For a network connection, this value is nil.")
674 register Lisp_Object proc
;
676 CHECK_PROCESS (proc
, 0);
677 return XPROCESS (proc
)->pid
;
680 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
681 "Return the name of PROCESS, as a string.\n\
682 This is the name of the program invoked in PROCESS,\n\
683 possibly modified to make it unique among process names.")
685 register Lisp_Object proc
;
687 CHECK_PROCESS (proc
, 0);
688 return XPROCESS (proc
)->name
;
691 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
692 "Return the command that was executed to start PROCESS.\n\
693 This is a list of strings, the first string being the program executed\n\
694 and the rest of the strings being the arguments given to it.\n\
695 For a non-child channel, this is nil.")
697 register Lisp_Object proc
;
699 CHECK_PROCESS (proc
, 0);
700 return XPROCESS (proc
)->command
;
703 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
705 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
707 register Lisp_Object proc
, buffer
;
709 CHECK_PROCESS (proc
, 0);
711 CHECK_BUFFER (buffer
, 1);
712 XPROCESS (proc
)->buffer
= buffer
;
716 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
718 "Return the buffer PROCESS is associated with.\n\
719 Output from PROCESS is inserted in this buffer\n\
720 unless PROCESS has a filter.")
722 register Lisp_Object proc
;
724 CHECK_PROCESS (proc
, 0);
725 return XPROCESS (proc
)->buffer
;
728 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
730 "Return the marker for the end of the last output from PROCESS.")
732 register Lisp_Object proc
;
734 CHECK_PROCESS (proc
, 0);
735 return XPROCESS (proc
)->mark
;
738 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
740 "Give PROCESS the filter function FILTER; nil means no filter.\n\
741 When a process has a filter, each time it does output\n\
742 the entire string of output is passed to the filter.\n\
743 The filter gets two arguments: the process and the string of output.\n\
744 If the process has a filter, its buffer is not used for output.")
746 register Lisp_Object proc
, filter
;
748 CHECK_PROCESS (proc
, 0);
749 XPROCESS (proc
)->filter
= filter
;
753 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
755 "Returns the filter function of PROCESS; nil if none.\n\
756 See `set-process-filter' for more info on filter functions.")
758 register Lisp_Object proc
;
760 CHECK_PROCESS (proc
, 0);
761 return XPROCESS (proc
)->filter
;
764 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
766 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
767 The sentinel is called as a function when the process changes state.\n\
768 It gets two arguments: the process, and a string describing the change.")
770 register Lisp_Object proc
, sentinel
;
772 CHECK_PROCESS (proc
, 0);
773 XPROCESS (proc
)->sentinel
= sentinel
;
777 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
779 "Return the sentinel of PROCESS; nil if none.\n\
780 See `set-process-sentinel' for more info on sentinels.")
782 register Lisp_Object proc
;
784 CHECK_PROCESS (proc
, 0);
785 return XPROCESS (proc
)->sentinel
;
788 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
789 Sprocess_kill_without_query
, 1, 2, 0,
790 "Say no query needed if PROCESS is running when Emacs is exited.\n\
791 Optional second argument if non-nill says to require a query.\n\
792 Value is t if a query was formerly required.")
794 register Lisp_Object proc
, value
;
798 CHECK_PROCESS (proc
, 0);
799 tem
= XPROCESS (proc
)->kill_without_query
;
800 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
808 register Lisp_Object tail
, tem
;
809 Lisp_Object proc
, minspace
, tem1
;
810 register struct buffer
*old
= current_buffer
;
811 register struct Lisp_Process
*p
;
815 XFASTINT (minspace
) = 1;
817 set_buffer_internal (XBUFFER (Vstandard_output
));
818 Fbuffer_disable_undo (Vstandard_output
);
820 current_buffer
->truncate_lines
= Qt
;
823 Proc Status Buffer Command\n\
824 ---- ------ ------ -------\n", -1);
826 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
830 proc
= Fcdr (Fcar (tail
));
832 if (NILP (p
->childp
))
835 Finsert (1, &p
->name
);
836 Findent_to (make_number (13), minspace
);
838 if (!NILP (p
->raw_status_low
))
841 if (XTYPE (p
->status
) == Lisp_Cons
)
842 symbol
= XCONS (p
->status
)->car
;
845 if (EQ (symbol
, Qsignal
))
848 tem
= Fcar (Fcdr (p
->status
));
850 if (XINT (tem
) < NSIG
)
851 write_string (sys_errlist
[XINT (tem
)], -1);
854 Fprinc (symbol
, Qnil
);
856 else if (NETCONN_P (proc
))
858 if (EQ (symbol
, Qrun
))
859 write_string ("open", -1);
860 else if (EQ (symbol
, Qexit
))
861 write_string ("closed", -1);
863 Fprinc (symbol
, Qnil
);
866 Fprinc (symbol
, Qnil
);
868 if (EQ (symbol
, Qexit
))
871 tem
= Fcar (Fcdr (p
->status
));
874 sprintf (tembuf
, " %d", XFASTINT (tem
));
875 write_string (tembuf
, -1);
879 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
880 remove_process (proc
);
882 Findent_to (make_number (22), minspace
);
883 if (NILP (p
->buffer
))
884 insert_string ("(none)");
885 else if (NILP (XBUFFER (p
->buffer
)->name
))
886 insert_string ("(Killed)");
888 Finsert (1, &XBUFFER (p
->buffer
)->name
);
890 Findent_to (make_number (37), minspace
);
892 if (NETCONN_P (proc
))
894 sprintf (tembuf
, "(network stream connection to %s)\n",
895 XSTRING (p
->childp
)->data
);
896 insert_string (tembuf
);
910 insert_string ("\n");
916 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
917 "Display a list of all processes.\n\
918 \(Any processes listed as Exited or Signaled are actually eliminated\n\
919 after the listing is made.)")
922 internal_with_output_to_temp_buffer ("*Process List*",
923 list_processes_1
, Qnil
);
927 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
928 "Return a list of all processes.")
931 return Fmapcar (Qcdr
, Vprocess_alist
);
934 /* Starting asynchronous inferior processes. */
936 static Lisp_Object
start_process_unwind ();
938 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
939 "Start a program in a subprocess. Return the process object for it.\n\
940 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
941 NAME is name for process. It is modified if necessary to make it unique.\n\
942 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
943 Process output goes at end of that buffer, unless you specify\n\
944 an output stream or filter function to handle the output.\n\
945 BUFFER may be also nil, meaning that this process is not associated\n\
947 Third arg is program file name. It is searched for as in the shell.\n\
948 Remaining arguments are strings to give program as arguments.")
951 register Lisp_Object
*args
;
953 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
955 register unsigned char *new_argv
;
958 register unsigned char **new_argv
;
961 int count
= specpdl_ptr
- specpdl
;
965 buffer
= Fget_buffer_create (buffer
);
967 /* Make sure that the child will be able to chdir to the current
968 buffer's current directory, or its unhandled equivalent. We
969 can't just have the child check for an error when it does the
970 chdir, since it's in a vfork.
972 We have to GCPRO around this because Fexpand_file_name and
973 Funhandled_file_name_directory might call a file name handling
974 function. The argument list is protected by the caller, so all
975 we really have to worry about is buffer. */
977 struct gcpro gcpro1
, gcpro2
;
979 current_dir
= current_buffer
->directory
;
981 GCPRO2 (buffer
, current_dir
);
984 expand_and_dir_to_file
985 (Funhandled_file_name_directory (current_dir
), Qnil
);
986 if (NILP (Ffile_accessible_directory_p (current_dir
)))
987 report_file_error ("Setting current directory",
988 Fcons (current_buffer
->directory
, Qnil
));
994 CHECK_STRING (name
, 0);
998 CHECK_STRING (program
, 2);
1001 /* Make a one member argv with all args concatenated
1002 together separated by a blank. */
1003 len
= XSTRING (program
)->size
+ 2;
1004 for (i
= 3; i
< nargs
; i
++)
1007 CHECK_STRING (tem
, i
);
1008 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1010 new_argv
= (unsigned char *) alloca (len
);
1011 strcpy (new_argv
, XSTRING (program
)->data
);
1012 for (i
= 3; i
< nargs
; i
++)
1015 CHECK_STRING (tem
, i
);
1016 strcat (new_argv
, " ");
1017 strcat (new_argv
, XSTRING (tem
)->data
);
1019 /* Need to add code here to check for program existence on VMS */
1022 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1024 for (i
= 3; i
< nargs
; i
++)
1027 CHECK_STRING (tem
, i
);
1028 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1030 new_argv
[i
- 2] = 0;
1031 new_argv
[0] = XSTRING (program
)->data
;
1033 /* If program file name is not absolute, search our path for it */
1034 if (new_argv
[0][0] != '/')
1037 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1039 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1040 new_argv
[0] = XSTRING (tem
)->data
;
1042 #endif /* not VMS */
1044 proc
= make_process (name
);
1045 /* If an error occurs and we can't start the process, we want to
1046 remove it from the process list. This means that each error
1047 check in create_process doesn't need to call remove_process
1048 itself; it's all taken care of here. */
1049 record_unwind_protect (start_process_unwind
, proc
);
1051 XPROCESS (proc
)->childp
= Qt
;
1052 XPROCESS (proc
)->command_channel_p
= Qnil
;
1053 XPROCESS (proc
)->buffer
= buffer
;
1054 XPROCESS (proc
)->sentinel
= Qnil
;
1055 XPROCESS (proc
)->filter
= Qnil
;
1056 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1058 create_process (proc
, new_argv
, current_dir
);
1060 return unbind_to (count
, proc
);
1063 /* This function is the unwind_protect form for Fstart_process. If
1064 PROC doesn't have its pid set, then we know someone has signalled
1065 an error and the process wasn't started successfully, so we should
1066 remove it from the process list. */
1068 start_process_unwind (proc
)
1071 if (XTYPE (proc
) != Lisp_Process
)
1074 /* Was PROC started successfully? */
1075 if (XPROCESS (proc
)->pid
<= 0)
1076 remove_process (proc
);
1083 create_process_1 (signo
)
1087 /* USG systems forget handlers when they are used;
1088 must reestablish each time */
1089 signal (signo
, create_process_1
);
1093 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1096 /* Mimic blocking of signals on system V, which doesn't really have it. */
1098 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1099 int sigchld_deferred
;
1102 create_process_sigchld ()
1104 signal (SIGCHLD
, create_process_sigchld
);
1106 sigchld_deferred
= 1;
1112 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1113 create_process (process
, new_argv
, current_dir
)
1114 Lisp_Object process
;
1116 Lisp_Object current_dir
;
1118 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1121 SIGTYPE (*sigchld
)();
1124 extern char **environ
;
1126 inchannel
= outchannel
= -1;
1129 if (EQ (Vprocess_connection_type
, Qt
))
1130 outchannel
= inchannel
= allocate_pty ();
1135 /* On USG systems it does not work to open the pty's tty here
1136 and then close and reopen it in the child. */
1138 /* Don't let this terminal become our controlling terminal
1139 (in case we don't have one). */
1140 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1142 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1145 report_file_error ("Opening pty", Qnil
);
1147 forkin
= forkout
= -1;
1148 #endif /* not USG */
1152 #endif /* HAVE_PTYS */
1155 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1156 report_file_error ("Opening socketpair", Qnil
);
1157 outchannel
= inchannel
= sv
[0];
1158 forkout
= forkin
= sv
[1];
1160 #else /* not SKTPAIR */
1169 #endif /* not SKTPAIR */
1172 /* Replaced by close_process_descs */
1173 set_exclusive_use (inchannel
);
1174 set_exclusive_use (outchannel
);
1177 /* Stride people say it's a mystery why this is needed
1178 as well as the O_NDELAY, but that it fails without this. */
1179 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1182 ioctl (inchannel
, FIONBIO
, &one
);
1187 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1190 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1194 /* Record this as an active process, with its channels.
1195 As a result, child_setup will close Emacs's side of the pipes. */
1196 chan_process
[inchannel
] = process
;
1197 XFASTINT (XPROCESS (process
)->infd
) = inchannel
;
1198 XFASTINT (XPROCESS (process
)->outfd
) = outchannel
;
1199 /* Record the tty descriptor used in the subprocess. */
1201 XPROCESS (process
)->subtty
= Qnil
;
1203 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1204 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1205 XPROCESS (process
)->status
= Qrun
;
1207 /* Delay interrupts until we have a chance to store
1208 the new fork's pid in its process structure */
1212 #else /* not BSD4_1 */
1213 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1214 sigsetmask (sigmask (SIGCHLD
));
1215 #else /* ordinary USG */
1217 sigchld_deferred
= 0;
1218 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1220 #endif /* ordinary USG */
1221 #endif /* not BSD4_1 */
1222 #endif /* SIGCHLD */
1224 /* Until we store the proper pid, enable sigchld_handler
1225 to recognize an unknown pid as standing for this process.
1226 It is very important not to let this `marker' value stay
1227 in the table after this function has returned; if it does
1228 it might cause call-process to hang and subsequent asynchronous
1229 processes to get their return values scrambled. */
1230 XSETINT (XPROCESS (process
)->pid
, -1);
1233 /* child_setup must clobber environ on systems with true vfork.
1234 Protect it from permanent change. */
1235 char **save_environ
= environ
;
1240 int xforkin
= forkin
;
1241 int xforkout
= forkout
;
1243 #if 0 /* This was probably a mistake--it duplicates code later on,
1244 but fails to handle all the cases. */
1245 /* Make sure SIGCHLD is not blocked in the child. */
1246 sigsetmask (SIGEMPTYMASK
);
1249 /* Make the pty be the controlling terminal of the process. */
1251 /* First, disconnect its current controlling terminal. */
1255 /* Make the pty's terminal the controlling terminal. */
1256 if (pty_flag
&& (ioctl (xforkin
, TIOCSCTTY
, 0) < 0))
1259 #else /* not HAVE_SETSID */
1261 /* It's very important to call setpgrp() here and no time
1262 afterwards. Otherwise, we lose our controlling tty which
1263 is set when we open the pty. */
1266 #endif /* not HAVE_SETSID */
1268 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1269 can do TIOCSPGRP only to the process's controlling tty. */
1272 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1273 I can't test it since I don't have 4.3. */
1274 int j
= open ("/dev/tty", O_RDWR
, 0);
1275 ioctl (j
, TIOCNOTTY
, 0);
1278 /* In order to get a controlling terminal on some versions
1279 of BSD, it is necessary to put the process in pgrp 0
1280 before it opens the terminal. */
1284 #endif /* TIOCNOTTY */
1286 #if !defined (RTU) && !defined (UNIPLUS)
1287 /*** There is a suggestion that this ought to be a
1288 conditional on TIOCSPGRP. */
1289 /* Now close the pty (if we had it open) and reopen it.
1290 This makes the pty the controlling terminal of the subprocess. */
1293 /* I wonder if close (open (pty_name, ...)) would work? */
1296 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1301 #endif /* not UNIPLUS and not RTU */
1302 #ifdef SETUP_SLAVE_PTY
1304 #endif /* SETUP_SLAVE_PTY */
1306 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1307 Now reenable it in the child, so it will die when we want it to. */
1309 signal (SIGHUP
, SIG_DFL
);
1311 #endif /* HAVE_PTYS */
1316 #else /* not BSD4_1 */
1317 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1318 sigsetmask (SIGEMPTYMASK
);
1319 #else /* ordinary USG */
1321 signal (SIGCHLD
, sigchld
);
1323 #endif /* ordinary USG */
1324 #endif /* not BSD4_1 */
1325 #endif /* SIGCHLD */
1327 child_setup_tty (xforkout
);
1328 child_setup (xforkin
, xforkout
, xforkout
,
1329 new_argv
, 1, current_dir
);
1331 environ
= save_environ
;
1335 report_file_error ("Doing vfork", Qnil
);
1337 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1339 FD_SET (inchannel
, &input_wait_mask
);
1341 /* If the subfork execv fails, and it exits,
1342 this close hangs. I don't know why.
1343 So have an interrupt jar it loose. */
1345 signal (SIGALRM
, create_process_1
);
1348 /* OK to close only if it's not a pty. Otherwise we need to leave
1349 it open for ioctl to get pgrp when signals are sent, or to send
1350 the interrupt characters through if that's how we're signalling
1351 subprocesses. Alternately if you are concerned about running out
1352 of file descriptors, you could just save the tty name and open
1353 just to do the ioctl. */
1354 if (NILP (XFASTINT (XPROCESS (process
)->pty_flag
)))
1357 XPROCESS (process
)->subtty
= Qnil
;
1363 if (forkin
!= forkout
&& forkout
>= 0)
1369 #else /* not BSD4_1 */
1370 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1371 sigsetmask (SIGEMPTYMASK
);
1372 #else /* ordinary USG */
1374 signal (SIGCHLD
, sigchld
);
1375 /* Now really handle any of these signals
1376 that came in during this function. */
1377 if (sigchld_deferred
)
1378 kill (getpid (), SIGCHLD
);
1380 #endif /* ordinary USG */
1381 #endif /* not BSD4_1 */
1382 #endif /* SIGCHLD */
1384 #endif /* not VMS */
1388 /* open a TCP network connection to a given HOST/SERVICE. Treated
1389 exactly like a normal process when reading and writing. Only
1390 differences are in status display and process deletion. A network
1391 connection has no PID; you cannot signal it. All you can do is
1392 deactivate and close it via delete-process */
1394 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1396 "Open a TCP connection for a service to a host.\n\
1397 Returns a subprocess-object to represent the connection.\n\
1398 Input and output work as for subprocesses; `delete-process' closes it.\n\
1399 Args are NAME BUFFER HOST SERVICE.\n\
1400 NAME is name for process. It is modified if necessary to make it unique.\n\
1401 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1402 Process output goes at end of that buffer, unless you specify\n\
1403 an output stream or filter function to handle the output.\n\
1404 BUFFER may be also nil, meaning that this process is not associated\n\
1406 Third arg is name of the host to connect to, or its IP address.\n\
1407 Fourth arg SERVICE is name of the service desired, or an integer\n\
1408 specifying a port number to connect to.")
1409 (name
, buffer
, host
, service
)
1410 Lisp_Object name
, buffer
, host
, service
;
1414 struct sockaddr_in address
;
1415 struct servent
*svc_info
;
1416 struct hostent
*host_info_ptr
, host_info
;
1417 char *(addr_list
[2]);
1418 unsigned long numeric_addr
;
1422 struct hostent host_info_fixed
;
1423 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1425 GCPRO4 (name
, buffer
, host
, service
);
1426 CHECK_STRING (name
, 0);
1427 CHECK_STRING (host
, 0);
1428 if (XTYPE(service
) == Lisp_Int
)
1429 port
= htons ((unsigned short) XINT (service
));
1432 CHECK_STRING (service
, 0);
1433 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1435 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1436 port
= svc_info
->s_port
;
1439 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1440 if (host_info_ptr
== 0)
1441 /* Attempt to interpret host as numeric inet address */
1443 numeric_addr
= inet_addr (XSTRING (host
)->data
);
1444 if (numeric_addr
== -1)
1445 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1447 host_info_ptr
= &host_info
;
1448 host_info
.h_name
= 0;
1449 host_info
.h_aliases
= 0;
1450 host_info
.h_addrtype
= AF_INET
;
1451 host_info
.h_addr_list
= &(addr_list
[0]);
1452 addr_list
[0] = (char*)(&numeric_addr
);
1454 host_info
.h_length
= strlen (addr_list
[0]);
1457 bzero (&address
, sizeof address
);
1458 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1459 host_info_ptr
->h_length
);
1460 address
.sin_family
= host_info_ptr
->h_addrtype
;
1461 address
.sin_port
= port
;
1463 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1465 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1468 if (connect (s
, &address
, sizeof address
) == -1)
1475 report_file_error ("connection failed",
1476 Fcons (host
, Fcons (name
, Qnil
)));
1482 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1485 buffer
= Fget_buffer_create (buffer
);
1486 proc
= make_process (name
);
1488 chan_process
[inch
] = proc
;
1491 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1494 fcntl (inch
, F_SETFL
, O_NDELAY
);
1498 XPROCESS (proc
)->childp
= host
;
1499 XPROCESS (proc
)->command_channel_p
= Qnil
;
1500 XPROCESS (proc
)->buffer
= buffer
;
1501 XPROCESS (proc
)->sentinel
= Qnil
;
1502 XPROCESS (proc
)->filter
= Qnil
;
1503 XPROCESS (proc
)->command
= Qnil
;
1504 XPROCESS (proc
)->pid
= Qnil
;
1505 XFASTINT (XPROCESS (proc
)->infd
) = s
;
1506 XFASTINT (XPROCESS (proc
)->outfd
) = outch
;
1507 XPROCESS (proc
)->status
= Qrun
;
1508 FD_SET (inch
, &input_wait_mask
);
1513 #endif /* HAVE_SOCKETS */
1515 deactivate_process (proc
)
1518 register int inchannel
, outchannel
;
1519 register struct Lisp_Process
*p
= XPROCESS (proc
);
1521 inchannel
= XFASTINT (p
->infd
);
1522 outchannel
= XFASTINT (p
->outfd
);
1526 /* Beware SIGCHLD hereabouts. */
1527 flush_pending_output (inchannel
);
1530 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1531 sys$
dassgn (outchannel
);
1532 vs
= get_vms_process_pointer (p
->pid
);
1534 give_back_vms_process_stuff (vs
);
1538 if (outchannel
&& outchannel
!= inchannel
)
1542 XFASTINT (p
->infd
) = 0;
1543 XFASTINT (p
->outfd
) = 0;
1544 chan_process
[inchannel
] = Qnil
;
1545 FD_CLR (inchannel
, &input_wait_mask
);
1549 /* Close all descriptors currently in use for communication
1550 with subprocess. This is used in a newly-forked subprocess
1551 to get rid of irrelevant descriptors. */
1553 close_process_descs ()
1556 for (i
= 0; i
< MAXDESC
; i
++)
1558 Lisp_Object process
;
1559 process
= chan_process
[i
];
1560 if (!NILP (process
))
1562 int in
= XFASTINT (XPROCESS (process
)->infd
);
1563 int out
= XFASTINT (XPROCESS (process
)->outfd
);
1566 if (out
&& in
!= out
)
1572 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1574 "Allow any pending output from subprocesses to be read by Emacs.\n\
1575 It is read into the process' buffers or given to their filter functions.\n\
1576 Non-nil arg PROCESS means do not return until some output has been received\n\
1578 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1579 seconds and microseconds to wait; return after that much time whether\n\
1580 or not there is input.\n\
1581 Return non-nil iff we received any output before the timeout expired.")
1582 (proc
, timeout
, timeout_msecs
)
1583 register Lisp_Object proc
, timeout
, timeout_msecs
;
1588 if (! NILP (timeout_msecs
))
1590 CHECK_NUMBER (timeout_msecs
, 2);
1591 useconds
= XINT (timeout_msecs
);
1592 if (XTYPE (timeout
) != Lisp_Int
)
1593 XSET (timeout
, Lisp_Int
, 0);
1596 int carry
= useconds
/ 1000000;
1598 XSETINT (timeout
, XINT (timeout
) + carry
);
1599 useconds
-= carry
* 1000000;
1601 /* I think this clause is necessary because C doesn't
1602 guarantee a particular rounding direction for negative
1606 XSETINT (timeout
, XINT (timeout
) - 1);
1607 useconds
+= 1000000;
1614 if (! NILP (timeout
))
1616 CHECK_NUMBER (timeout
, 1);
1617 seconds
= XINT (timeout
);
1630 XFASTINT (proc
) = 0;
1633 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1637 /* This variable is different from waiting_for_input in keyboard.c.
1638 It is used to communicate to a lisp process-filter/sentinel (via the
1639 function Fwaiting_for_user_input_p below) whether emacs was waiting
1640 for user-input when that process-filter was called.
1641 waiting_for_input cannot be used as that is by definition 0 when
1642 lisp code is being evalled */
1643 static int waiting_for_user_input_p
;
1645 /* Read and dispose of subprocess output while waiting for timeout to
1646 elapse and/or keyboard input to be available.
1649 timeout in seconds, or
1650 zero for no limit, or
1651 -1 means gobble data immediately available but don't wait for any.
1654 an additional duration to wait (if time_limit is greater than
1655 zero), specified in millisec.
1657 read_kbd is a lisp value:
1658 0 to ignore keyboard input, or
1659 1 to return when input is available, or
1660 -1 meaning caller will actually read the input, so don't throw to
1661 the quit handler, or
1662 a cons cell, meaning wait wait until its car is non-nil, or
1663 a process object, meaning wait until something arrives from that
1664 process. The return value is true iff we read some input from
1667 do_display != 0 means redisplay should be done to show subprocess
1668 output that arrives.
1670 If read_kbd is a pointer to a struct Lisp_Process, then the
1671 function returns true iff we received input from that process
1672 before the timeout elapsed.
1673 Otherwise, return true iff we recieved input from any process. */
1675 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1676 int time_limit
, microsecs
;
1677 Lisp_Object read_kbd
;
1680 register int channel
, nfds
, m
;
1681 static SELECT_TYPE Available
;
1684 EMACS_TIME timeout
, end_time
, garbage
;
1686 int wait_channel
= 0;
1687 struct Lisp_Process
*wait_proc
= 0;
1688 int got_some_input
= 0;
1689 Lisp_Object
*wait_for_cell
= 0;
1691 FD_ZERO (&Available
);
1693 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1695 if (XTYPE (read_kbd
) == Lisp_Process
)
1697 wait_proc
= XPROCESS (read_kbd
);
1698 wait_channel
= XFASTINT (wait_proc
->infd
);
1699 XFASTINT (read_kbd
) = 0;
1702 /* If waiting for non-nil in a cell, record where. */
1703 if (XTYPE (read_kbd
) == Lisp_Cons
)
1705 wait_for_cell
= &XCONS (read_kbd
)->car
;
1706 XFASTINT (read_kbd
) = 0;
1709 waiting_for_user_input_p
= XINT (read_kbd
);
1711 /* Since we may need to wait several times,
1712 compute the absolute time to return at. */
1713 if (time_limit
|| microsecs
)
1715 EMACS_GET_TIME (end_time
);
1716 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1717 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1722 /* If calling from keyboard input, do not quit
1723 since we want to return C-g as an input character.
1724 Otherwise, do pending quit if requested. */
1725 if (XINT (read_kbd
) >= 0)
1728 /* Compute time from now till when time limit is up */
1729 /* Exit if already run out */
1730 if (time_limit
== -1)
1732 /* -1 specified for timeout means
1733 gobble output available now
1734 but don't wait at all. */
1736 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1738 else if (time_limit
|| microsecs
)
1740 EMACS_GET_TIME (timeout
);
1741 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1742 if (EMACS_TIME_NEG_P (timeout
))
1747 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1750 /* Cause C-g and alarm signals to take immediate action,
1751 and cause input available signals to zero out timeout.
1753 It is important that we do this before checking for process
1754 activity. If we get a SIGCHLD after the explicit checks for
1755 process activity, timeout is the only way we will know. */
1756 if (XINT (read_kbd
) < 0)
1757 set_waiting_for_input (&timeout
);
1759 /* If status of something has changed, and no input is
1760 available, notify the user of the change right away. After
1761 this explicit check, we'll let the SIGCHLD handler zap
1762 timeout to get our attention. */
1763 if (update_tick
!= process_tick
&& do_display
)
1765 Atemp
= input_wait_mask
;
1766 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1767 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1769 /* It's okay for us to do this and then continue with
1770 the loop, since timeout has already been zeroed out. */
1771 clear_waiting_for_input ();
1776 /* Don't wait for output from a non-running process. */
1777 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1778 update_status (wait_proc
);
1780 && ! EQ (wait_proc
->status
, Qrun
))
1782 clear_waiting_for_input ();
1786 /* Wait till there is something to do */
1788 Available
= input_wait_mask
;
1789 if (! XINT (read_kbd
))
1790 FD_CLR (0, &Available
);
1792 /* If frame size has changed or the window is newly mapped,
1793 redisplay now, before we start to wait. There is a race
1794 condition here; if a SIGIO arrives between now and the select
1795 and indicates that a frame is trashed, the select may block
1796 displaying a trashed screen. */
1798 redisplay_preserve_echo_area ();
1800 if (XINT (read_kbd
) && detect_input_pending ())
1803 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1807 /* Make C-g and alarm signals set flags again */
1808 clear_waiting_for_input ();
1810 /* If we woke up due to SIGWINCH, actually change size now. */
1811 do_pending_window_change ();
1813 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1817 if (xerrno
== EINTR
)
1818 FD_ZERO (&Available
);
1820 /* Ultrix select seems to return ENOMEM when it is
1821 interrupted. Treat it just like EINTR. Bleah. Note
1822 that we want to test for the "ultrix" CPP symbol, not
1823 "__ultrix__"; the latter is only defined under GCC, but
1824 not by DEC's bundled CC. -JimB */
1825 else if (xerrno
== ENOMEM
)
1826 FD_ZERO (&Available
);
1829 /* This happens for no known reason on ALLIANT.
1830 I am guessing that this is the right response. -- RMS. */
1831 else if (xerrno
== EFAULT
)
1832 FD_ZERO (&Available
);
1834 else if (xerrno
== EBADF
)
1837 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1838 the child's closure of the pts gives the parent a SIGHUP, and
1839 the ptc file descriptor is automatically closed,
1840 yielding EBADF here or at select() call above.
1841 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1842 in m-ibmrt-aix.h), and here we just ignore the select error.
1843 Cleanup occurs c/o status_notify after SIGCLD. */
1844 FD_ZERO (&Available
); /* Cannot depend on values returned */
1850 error("select error: %s", sys_errlist
[xerrno
]);
1852 #if defined(sun) && !defined(USG5_4)
1853 else if (nfds
> 0 && FD_ISSET (0, &Available
) && interrupt_input
)
1854 /* System sometimes fails to deliver SIGIO.
1856 David J. Mackenzie says that Emacs doesn't compile under
1857 Solaris if this code is enabled, thus the USG5_4 in the CPP
1858 conditional. "I haven't noticed any ill effects so far.
1859 If you find a Solaris expert somewhere, they might know
1861 kill (getpid (), SIGIO
);
1864 /* Check for keyboard input */
1865 /* If there is any, return immediately
1866 to give it higher priority than subprocesses */
1868 if (XINT (read_kbd
) && detect_input_pending ())
1871 /* Exit now if the cell we're waiting for became non-nil. */
1872 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1876 /* If we think we have keyboard input waiting, but didn't get SIGIO
1877 go read it. This can happen with X on BSD after logging out.
1878 In that case, there really is no input and no SIGIO,
1879 but select says there is input. */
1881 if (XINT (read_kbd
) && interrupt_input
&& (FD_ISSET (fileno (stdin
), &Available
)))
1886 got_some_input
|= nfds
> 0;
1888 /* If checking input just got us a size-change event from X,
1889 obey it now if we should. */
1890 if (XINT (read_kbd
))
1891 do_pending_window_change ();
1893 /* Check for data from a process or a command channel */
1894 for (channel
= FIRST_PROC_DESC
; channel
< MAXDESC
; channel
++)
1896 if (FD_ISSET (channel
, &Available
))
1900 /* If waiting for this channel, arrange to return as
1901 soon as no more input to be processed. No more
1903 if (wait_channel
== channel
)
1909 proc
= chan_process
[channel
];
1913 /* Read data from the process, starting with our
1914 buffered-ahead character if we have one. */
1916 nread
= read_process_output (proc
, channel
);
1919 /* Since read_process_output can run a filter,
1920 which can call accept-process-output,
1921 don't try to read from any other processes
1922 before doing the select again. */
1923 FD_ZERO (&Available
);
1926 redisplay_preserve_echo_area ();
1929 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1933 else if (nread
== -1 && errno
== EAGAIN
)
1937 else if (nread
== -1 && errno
== EAGAIN
)
1939 /* Note that we cannot distinguish between no input
1940 available now and a closed pipe.
1941 With luck, a closed pipe will be accompanied by
1942 subprocess termination and SIGCHLD. */
1943 else if (nread
== 0 && !NETCONN_P (proc
))
1945 #endif /* O_NDELAY */
1946 #endif /* O_NONBLOCK */
1947 #endif /* EWOULDBLOCK */
1949 /* On some OSs with ptys, when the process on one end of
1950 a pty exits, the other end gets an error reading with
1951 errno = EIO instead of getting an EOF (0 bytes read).
1952 Therefore, if we get an error reading and errno =
1953 EIO, just continue, because the child process has
1954 exited and should clean itself up soon (e.g. when we
1956 else if (nread
== -1 && errno
== EIO
)
1958 #endif /* HAVE_PTYS */
1959 /* If we can detect process termination, don't consider the process
1960 gone just because its pipe is closed. */
1962 else if (nread
== 0 && !NETCONN_P (proc
))
1967 /* Preserve status of processes already terminated. */
1968 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
1969 deactivate_process (proc
);
1970 if (!NILP (XPROCESS (proc
)->raw_status_low
))
1971 update_status (XPROCESS (proc
));
1972 if (EQ (XPROCESS (proc
)->status
, Qrun
))
1973 XPROCESS (proc
)->status
1974 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
1977 } /* end for each file descriptor */
1978 } /* end while exit conditions not met */
1980 /* If calling from keyboard input, do not quit
1981 since we want to return C-g as an input character.
1982 Otherwise, do pending quit if requested. */
1983 if (XINT (read_kbd
) >= 0)
1985 /* Prevent input_pending from remaining set if we quit. */
1986 clear_input_pending ();
1990 return got_some_input
;
1993 /* Read pending output from the process channel,
1994 starting with our buffered-ahead character if we have one.
1995 Yield number of characters read.
1997 This function reads at most 1024 characters.
1998 If you want to read all available subprocess output,
1999 you must call it repeatedly until it returns zero. */
2001 read_process_output (proc
, channel
)
2003 register int channel
;
2005 register int nchars
;
2011 register Lisp_Object outstream
;
2012 register struct buffer
*old
= current_buffer
;
2013 register struct Lisp_Process
*p
= XPROCESS (proc
);
2014 register int opoint
;
2017 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2019 vs
= get_vms_process_pointer (p
->pid
);
2023 return(0); /* Really weird if it does this */
2024 if (!(vs
->iosb
[0] & 1))
2025 return -1; /* I/O error */
2028 error ("Could not get VMS process pointer");
2029 chars
= vs
->inputBuffer
;
2030 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2033 start_vms_process_read (vs
); /* Crank up the next read on the process */
2034 return 1; /* Nothing worth printing, say we got 1 */
2038 if (proc_buffered_char
[channel
] < 0)
2039 nchars
= read (channel
, chars
, sizeof chars
);
2042 chars
[0] = proc_buffered_char
[channel
];
2043 proc_buffered_char
[channel
] = -1;
2044 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2048 nchars
= nchars
+ 1;
2050 #endif /* not VMS */
2052 if (nchars
<= 0) return nchars
;
2054 outstream
= p
->filter
;
2055 if (!NILP (outstream
))
2057 /* We inhibit quit here instead of just catching it so that
2058 hitting ^G when a filter happens to be running won't screw
2060 int count
= specpdl_ptr
- specpdl
;
2061 specbind (Qinhibit_quit
, Qt
);
2062 call2 (outstream
, proc
, make_string (chars
, nchars
));
2065 start_vms_process_read (vs
);
2071 /* If no filter, write into buffer if it isn't dead. */
2072 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2074 Lisp_Object old_read_only
;
2075 Lisp_Object old_begv
, old_zv
;
2077 Fset_buffer (p
->buffer
);
2079 old_read_only
= current_buffer
->read_only
;
2080 XFASTINT (old_begv
) = BEGV
;
2081 XFASTINT (old_zv
) = ZV
;
2083 current_buffer
->read_only
= Qnil
;
2085 /* Insert new output into buffer
2086 at the current end-of-output marker,
2087 thus preserving logical ordering of input and output. */
2088 if (XMARKER (p
->mark
)->buffer
)
2089 SET_PT (marker_position (p
->mark
));
2093 /* If the output marker is outside of the visible region, save
2094 the restriction and widen. */
2095 if (! (BEGV
<= point
&& point
<= ZV
))
2098 /* Make sure opoint floats ahead of any new text, just as point
2100 if (point
<= opoint
)
2103 /* Insert after old_begv, but before old_zv. */
2104 if (point
< XFASTINT (old_begv
))
2105 XFASTINT (old_begv
) += nchars
;
2106 if (point
<= XFASTINT (old_zv
))
2107 XFASTINT (old_zv
) += nchars
;
2109 /* Insert before markers in case we are inserting where
2110 the buffer's mark is, and the user's next command is Meta-y. */
2111 insert_before_markers (chars
, nchars
);
2112 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2114 update_mode_lines
++;
2116 /* If the restriction isn't what it should be, set it. */
2117 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2118 Fnarrow_to_region (old_begv
, old_zv
);
2120 current_buffer
->read_only
= old_read_only
;
2122 set_buffer_internal (old
);
2125 start_vms_process_read (vs
);
2130 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2132 "Returns non-NIL if emacs is waiting for input from the user.\n\
2133 This is intended for use by asynchronous process output filters and sentinels.")
2136 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2139 /* Sending data to subprocess */
2141 jmp_buf send_process_frame
;
2144 send_process_trap ()
2150 longjmp (send_process_frame
, 1);
2153 send_process (proc
, buf
, len
)
2158 /* Don't use register vars; longjmp can lose them. */
2160 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2164 struct Lisp_Process
*p
= XPROCESS (proc
);
2165 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2168 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2169 update_status (XPROCESS (proc
));
2170 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2171 error ("Process %s not running", procname
);
2174 vs
= get_vms_process_pointer (p
->pid
);
2176 error ("Could not find this process: %x", p
->pid
);
2177 else if (write_to_vms_process (vs
, buf
, len
))
2180 if (!setjmp (send_process_frame
))
2184 SIGTYPE (*old_sigpipe
)();
2186 /* Don't send more than 500 bytes at a time. */
2189 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2190 rv
= write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, this);
2191 signal (SIGPIPE
, old_sigpipe
);
2196 || errno
== EWOULDBLOCK
2203 /* It would be nice to accept process output here,
2204 but that is difficult. For example, it could
2205 garbage what we are sending if that is from a buffer. */
2212 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2216 /* Allow input from processes between bursts of sending.
2217 Otherwise things may get stopped up. */
2222 XFASTINT (zero
) = 0;
2223 wait_reading_process_input (-1, 0, zero
, 0);
2229 XPROCESS (proc
)->raw_status_low
= Qnil
;
2230 XPROCESS (proc
)->raw_status_high
= Qnil
;
2231 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2232 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2233 deactivate_process (proc
);
2235 error ("Error writing to process %s; closed it", procname
);
2237 error ("SIGPIPE raised on process %s; closed it", procname
);
2242 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2244 "Send current contents of region as input to PROCESS.\n\
2245 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2246 nil, indicating the current buffer's process.\n\
2247 Called from program, takes three arguments, PROCESS, START and END.\n\
2248 If the region is more than 500 characters long,\n\
2249 it is sent in several bunches. This may happen even for shorter regions.\n\
2250 Output from processes can arrive in between bunches.")
2251 (process
, start
, end
)
2252 Lisp_Object process
, start
, end
;
2257 proc
= get_process (process
);
2258 validate_region (&start
, &end
);
2260 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2263 start1
= XINT (start
);
2264 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2269 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2271 "Send PROCESS the contents of STRING as input.\n\
2272 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2273 nil, indicating the current buffer's process.\n\
2274 If STRING is more than 500 characters long,\n\
2275 it is sent in several bunches. This may happen even for shorter strings.\n\
2276 Output from processes can arrive in between bunches.")
2278 Lisp_Object process
, string
;
2281 CHECK_STRING (string
, 1);
2282 proc
= get_process (process
);
2283 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2287 /* send a signal number SIGNO to PROCESS.
2288 CURRENT_GROUP means send to the process group that currently owns
2289 the terminal being used to communicate with PROCESS.
2290 This is used for various commands in shell mode.
2291 If NOMSG is zero, insert signal-announcements into process's buffers
2294 If we can, we try to signal PROCESS by sending control characters
2295 down the pipe. This allows us to signal inferiors who have changed
2296 their uid, for which killpg would return an EPERM error. */
2299 process_send_signal (process
, signo
, current_group
, nomsg
)
2300 Lisp_Object process
;
2302 Lisp_Object current_group
;
2306 register struct Lisp_Process
*p
;
2310 proc
= get_process (process
);
2311 p
= XPROCESS (proc
);
2313 if (!EQ (p
->childp
, Qt
))
2314 error ("Process %s is not a subprocess",
2315 XSTRING (p
->name
)->data
);
2316 if (!XFASTINT (p
->infd
))
2317 error ("Process %s is not active",
2318 XSTRING (p
->name
)->data
);
2320 if (NILP (p
->pty_flag
))
2321 current_group
= Qnil
;
2323 /* If we are using pgrps, get a pgrp number and make it negative. */
2324 if (!NILP (current_group
))
2326 #ifdef SIGNALS_VIA_CHARACTERS
2327 /* If possible, send signals to the entire pgrp
2328 by sending an input character to it. */
2330 /* TERMIOS is the latest and bestest, and seems most likely to
2331 work. If the system has it, use it. */
2338 tcgetattr (XFASTINT (p
->infd
), &t
);
2339 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2343 tcgetattr (XFASTINT (p
->infd
), &t
);
2344 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2348 tcgetattr (XFASTINT (p
->infd
), &t
);
2350 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2352 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2357 #else /* ! HAVE_TERMIOS */
2359 /* On Berkeley descendants, the following IOCTL's retrieve the
2360 current control characters. */
2361 #if defined (TIOCGLTC) && defined (TIOCGETC)
2369 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2370 send_process (proc
, &c
.t_intrc
, 1);
2373 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2374 send_process (proc
, &c
.t_quitc
, 1);
2378 ioctl (XFASTINT (p
->infd
), TIOCGLTC
, &lc
);
2379 send_process (proc
, &lc
.t_suspc
, 1);
2381 #endif /* ! defined (SIGTSTP) */
2384 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2386 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2393 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2394 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2397 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2398 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2402 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2403 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2405 #endif /* ! defined (SIGTSTP) */
2407 #else /* ! defined (TCGETA) */
2408 Your configuration files are messed up
.
2409 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2410 you'd better be using one of the alternatives above! */
2411 #endif /* ! defined (TCGETA) */
2412 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2413 #endif /* ! defined HAVE_TERMIOS */
2414 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2417 /* Get the pgrp using the tty itself, if we have that.
2418 Otherwise, use the pty to get the pgrp.
2419 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2420 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2421 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2422 His patch indicates that if TIOCGPGRP returns an error, then
2423 we should just assume that p->pid is also the process group id. */
2427 if (!NILP (p
->subtty
))
2428 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2430 err
= ioctl (XFASTINT (p
->infd
), TIOCGPGRP
, &gid
);
2434 gid
= - XFASTINT (p
->pid
);
2435 #endif /* ! defined (pfa) */
2441 #else /* ! defined (TIOCGPGRP ) */
2442 /* Can't select pgrps on this system, so we know that
2443 the child itself heads the pgrp. */
2444 gid
= - XFASTINT (p
->pid
);
2445 #endif /* ! defined (TIOCGPGRP ) */
2448 gid
= - XFASTINT (p
->pid
);
2454 p
->raw_status_low
= Qnil
;
2455 p
->raw_status_high
= Qnil
;
2457 XSETINT (p
->tick
, ++process_tick
);
2461 #endif /* ! defined (SIGCONT) */
2464 send_process (proc
, "\003", 1); /* ^C */
2469 send_process (proc
, "\031", 1); /* ^Y */
2474 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2477 flush_pending_output (XFASTINT (p
->infd
));
2481 /* If we don't have process groups, send the signal to the immediate
2482 subprocess. That isn't really right, but it's better than any
2483 obvious alternative. */
2486 kill (XFASTINT (p
->pid
), signo
);
2490 /* gid may be a pid, or minus a pgrp's number */
2492 if (!NILP (current_group
))
2493 ioctl (XFASTINT (p
->infd
), TIOCSIGSEND
, signo
);
2496 gid
= - XFASTINT (p
->pid
);
2499 #else /* ! defined (TIOCSIGSEND) */
2500 EMACS_KILLPG (-gid
, signo
);
2501 #endif /* ! defined (TIOCSIGSEND) */
2504 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2505 "Interrupt process PROCESS. May be process or name of one.\n\
2506 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2507 Nil or no arg means current buffer's process.\n\
2508 Second arg CURRENT-GROUP non-nil means send signal to\n\
2509 the current process-group of the process's controlling terminal\n\
2510 rather than to the process's own process group.\n\
2511 If the process is a shell, this means interrupt current subjob\n\
2512 rather than the shell.")
2513 (process
, current_group
)
2514 Lisp_Object process
, current_group
;
2516 process_send_signal (process
, SIGINT
, current_group
, 0);
2520 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2521 "Kill process PROCESS. May be process or name of one.\n\
2522 See function `interrupt-process' for more details on usage.")
2523 (process
, current_group
)
2524 Lisp_Object process
, current_group
;
2526 process_send_signal (process
, SIGKILL
, current_group
, 0);
2530 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2531 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2532 See function `interrupt-process' for more details on usage.")
2533 (process
, current_group
)
2534 Lisp_Object process
, current_group
;
2536 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2540 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2541 "Stop process PROCESS. May be process or name of one.\n\
2542 See function `interrupt-process' for more details on usage.")
2543 (process
, current_group
)
2544 Lisp_Object process
, current_group
;
2547 error ("no SIGTSTP support");
2549 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2554 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2555 "Continue process PROCESS. May be process or name of one.\n\
2556 See function `interrupt-process' for more details on usage.")
2557 (process
, current_group
)
2558 Lisp_Object process
, current_group
;
2561 process_send_signal (process
, SIGCONT
, current_group
, 0);
2563 error ("no SIGCONT support");
2568 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2569 2, 2, "nProcess number: \nnSignal code: ",
2570 "Send the process with number PID the signal with code CODE.\n\
2571 Both PID and CODE are integers.")
2573 Lisp_Object pid
, sig
;
2575 CHECK_NUMBER (pid
, 0);
2576 CHECK_NUMBER (sig
, 1);
2577 return make_number (kill (XINT (pid
), XINT (sig
)));
2580 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2581 "Make PROCESS see end-of-file in its input.\n\
2582 Eof comes after any text already sent to it.\n\
2583 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2584 nil, indicating the current buffer's process.")
2586 Lisp_Object process
;
2590 proc
= get_process (process
);
2592 /* Make sure the process is really alive. */
2593 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2594 update_status (XPROCESS (proc
));
2595 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2596 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2598 /* Sending a zero-length record is supposed to mean eof
2599 when TIOCREMOTE is turned on. */
2603 write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, 0);
2605 #else /* did not do TOICREMOTE */
2607 send_process (proc
, "\032", 1); /* ^z */
2609 if (!NILP (XPROCESS (proc
)->pty_flag
))
2610 send_process (proc
, "\004", 1);
2613 close (XPROCESS (proc
)->outfd
);
2614 XFASTINT (XPROCESS (proc
)->outfd
) = open (NULL_DEVICE
, O_WRONLY
);
2617 #endif /* did not do TOICREMOTE */
2621 /* Kill all processes associated with `buffer'.
2622 If `buffer' is nil, kill all processes */
2624 kill_buffer_processes (buffer
)
2627 Lisp_Object tail
, proc
;
2629 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2630 tail
= XCONS (tail
)->cdr
)
2632 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2633 if (XGCTYPE (proc
) == Lisp_Process
2634 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2636 if (NETCONN_P (proc
))
2637 deactivate_process (proc
);
2638 else if (XFASTINT (XPROCESS (proc
)->infd
))
2639 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2644 /* On receipt of a signal that a child status has changed,
2645 loop asking about children with changed statuses until
2646 the system says there are no more.
2647 All we do is change the status;
2648 we do not run sentinels or print notifications.
2649 That is saved for the next time keyboard input is done,
2650 in order to avoid timing errors. */
2652 /** WARNING: this can be called during garbage collection.
2653 Therefore, it must not be fooled by the presence of mark bits in
2656 /** USG WARNING: Although it is not obvious from the documentation
2657 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2658 signal() before executing at least one wait(), otherwise the handler
2659 will be called again, resulting in an infinite loop. The relevant
2660 portion of the documentation reads "SIGCLD signals will be queued
2661 and the signal-catching function will be continually reentered until
2662 the queue is empty". Invoking signal() causes the kernel to reexamine
2663 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2666 sigchld_handler (signo
)
2669 int old_errno
= errno
;
2671 register struct Lisp_Process
*p
;
2672 extern EMACS_TIME
*input_available_clear_time
;
2676 sigheld
|= sigbit (SIGCHLD
);
2688 #endif /* no WUNTRACED */
2689 /* Keep trying to get a status until we get a definitive result. */
2693 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2695 while (pid
<= 0 && errno
== EINTR
);
2699 /* A real failure. We have done all our job, so return. */
2701 /* USG systems forget handlers when they are used;
2702 must reestablish each time */
2704 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2707 sigheld
&= ~sigbit (SIGCHLD
);
2715 #endif /* no WNOHANG */
2717 /* Find the process that signaled us, and record its status. */
2720 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2722 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2723 p
= XPROCESS (proc
);
2724 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2729 /* Look for an asynchronous process whose pid hasn't been filled
2732 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2734 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2735 p
= XPROCESS (proc
);
2736 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2741 /* Change the status of the process that was found. */
2744 union { int i
; WAITTYPE wt
; } u
;
2746 XSETINT (p
->tick
, ++process_tick
);
2748 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2749 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2751 /* If process has terminated, stop waiting for its output. */
2752 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2753 if (XFASTINT (p
->infd
))
2754 FD_CLR (XFASTINT (p
->infd
), &input_wait_mask
);
2756 /* Tell wait_reading_process_input that it needs to wake up and
2758 if (input_available_clear_time
)
2759 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2762 /* There was no asynchronous process found for that id. Check
2763 if we have a synchronous process. */
2766 synch_process_alive
= 0;
2768 /* Report the status of the synchronous process. */
2770 synch_process_retcode
= WRETCODE (w
);
2771 else if (WIFSIGNALED (w
))
2773 synch_process_death
= sys_siglist
[WTERMSIG (w
)];
2775 synch_process_death
= sys_errlist
[WTERMSIG (w
)];
2778 /* Tell wait_reading_process_input that it needs to wake up and
2780 if (input_available_clear_time
)
2781 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2784 /* On some systems, we must return right away.
2785 If any more processes want to signal us, we will
2787 Otherwise (on systems that have WNOHANG), loop around
2788 to use up all the processes that have something to tell us. */
2789 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2791 signal (signo
, sigchld_handler
);
2795 #endif /* USG, but not HPUX with WNOHANG */
2801 exec_sentinel_unwind (data
)
2804 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2809 exec_sentinel (proc
, reason
)
2810 Lisp_Object proc
, reason
;
2812 Lisp_Object sentinel
;
2813 register struct Lisp_Process
*p
= XPROCESS (proc
);
2814 int count
= specpdl_ptr
- specpdl
;
2816 sentinel
= p
->sentinel
;
2817 if (NILP (sentinel
))
2820 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2821 assure that it gets restored no matter how the sentinel exits. */
2823 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2824 /* Inhibit quit so that random quits don't screw up a running filter. */
2825 specbind (Qinhibit_quit
, Qt
);
2826 call2 (sentinel
, proc
, reason
);
2830 /* Report all recent events of a change in process status
2831 (either run the sentinel or output a message).
2832 This is done while Emacs is waiting for keyboard input. */
2836 register Lisp_Object proc
, buffer
;
2837 Lisp_Object tail
= Qnil
;
2838 Lisp_Object msg
= Qnil
;
2839 struct gcpro gcpro1
, gcpro2
;
2841 /* We need to gcpro tail; if read_process_output calls a filter
2842 which deletes a process and removes the cons to which tail points
2843 from Vprocess_alist, and then causes a GC, tail is an unprotected
2847 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2850 register struct Lisp_Process
*p
;
2852 proc
= Fcdr (Fcar (tail
));
2853 p
= XPROCESS (proc
);
2855 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2857 XSETINT (p
->update_tick
, XINT (p
->tick
));
2859 /* If process is still active, read any output that remains. */
2860 if (XFASTINT (p
->infd
))
2861 while (read_process_output (proc
, XFASTINT (p
->infd
)) > 0);
2865 /* Get the text to use for the message. */
2866 if (!NILP (p
->raw_status_low
))
2868 msg
= status_message (p
->status
);
2870 /* If process is terminated, deactivate it or delete it. */
2872 if (XTYPE (p
->status
) == Lisp_Cons
)
2873 symbol
= XCONS (p
->status
)->car
;
2875 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2876 || EQ (symbol
, Qclosed
))
2878 if (delete_exited_processes
)
2879 remove_process (proc
);
2881 deactivate_process (proc
);
2884 /* Now output the message suitably. */
2885 if (!NILP (p
->sentinel
))
2886 exec_sentinel (proc
, msg
);
2887 /* Don't bother with a message in the buffer
2888 when a process becomes runnable. */
2889 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2891 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2893 struct buffer
*old
= current_buffer
;
2896 /* Avoid error if buffer is deleted
2897 (probably that's why the process is dead, too) */
2898 if (NILP (XBUFFER (buffer
)->name
))
2900 Fset_buffer (buffer
);
2902 /* Insert new output into buffer
2903 at the current end-of-output marker,
2904 thus preserving logical ordering of input and output. */
2905 if (XMARKER (p
->mark
)->buffer
)
2906 SET_PT (marker_position (p
->mark
));
2909 if (point
<= opoint
)
2910 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2912 tem
= current_buffer
->read_only
;
2913 current_buffer
->read_only
= Qnil
;
2914 insert_string ("\nProcess ");
2915 Finsert (1, &p
->name
);
2916 insert_string (" ");
2918 current_buffer
->read_only
= tem
;
2919 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2922 set_buffer_internal (old
);
2927 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
2928 redisplay_preserve_echo_area ();
2930 update_tick
= process_tick
;
2941 if (! noninteractive
|| initialized
)
2943 signal (SIGCHLD
, sigchld_handler
);
2946 FD_ZERO (&input_wait_mask
);
2947 FD_SET (0, &input_wait_mask
);
2948 Vprocess_alist
= Qnil
;
2949 for (i
= 0; i
< MAXDESC
; i
++)
2951 chan_process
[i
] = Qnil
;
2952 proc_buffered_char
[i
] = -1;
2956 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 0, 1, 0,
2957 "Return the connection type of `PROCESS'. This can be nil (pipe),\n\
2958 t or pty (pty) or stream (socket connection).")
2960 Lisp_Object process
;
2962 return XPROCESS (process
)->type
;
2968 stream_process
= intern ("stream");
2970 Qprocessp
= intern ("processp");
2971 staticpro (&Qprocessp
);
2972 Qrun
= intern ("run");
2974 Qstop
= intern ("stop");
2976 Qsignal
= intern ("signal");
2977 staticpro (&Qsignal
);
2979 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
2982 Qexit = intern ("exit");
2983 staticpro (&Qexit); */
2985 Qopen
= intern ("open");
2987 Qclosed
= intern ("closed");
2988 staticpro (&Qclosed
);
2990 staticpro (&Vprocess_alist
);
2992 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
2993 "*Non-nil means delete processes immediately when they exit.\n\
2994 nil means don't delete them until `list-processes' is run.");
2996 delete_exited_processes
= 1;
2998 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
2999 "Control type of device used to communicate with subprocesses.\n\
3000 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3001 pty's are not available, this variable will be ignored. The value takes\n\
3002 effect when `start-process' is called.");
3003 Vprocess_connection_type
= Qt
;
3005 defsubr (&Sprocessp
);
3006 defsubr (&Sget_process
);
3007 defsubr (&Sget_buffer_process
);
3008 defsubr (&Sdelete_process
);
3009 defsubr (&Sprocess_status
);
3010 defsubr (&Sprocess_exit_status
);
3011 defsubr (&Sprocess_id
);
3012 defsubr (&Sprocess_name
);
3013 defsubr (&Sprocess_command
);
3014 defsubr (&Sset_process_buffer
);
3015 defsubr (&Sprocess_buffer
);
3016 defsubr (&Sprocess_mark
);
3017 defsubr (&Sset_process_filter
);
3018 defsubr (&Sprocess_filter
);
3019 defsubr (&Sset_process_sentinel
);
3020 defsubr (&Sprocess_sentinel
);
3021 defsubr (&Sprocess_kill_without_query
);
3022 defsubr (&Slist_processes
);
3023 defsubr (&Sprocess_list
);
3024 defsubr (&Sstart_process
);
3026 defsubr (&Sopen_network_stream
);
3027 #endif /* HAVE_SOCKETS */
3028 defsubr (&Saccept_process_output
);
3029 defsubr (&Sprocess_send_region
);
3030 defsubr (&Sprocess_send_string
);
3031 defsubr (&Sinterrupt_process
);
3032 defsubr (&Skill_process
);
3033 defsubr (&Squit_process
);
3034 defsubr (&Sstop_process
);
3035 defsubr (&Scontinue_process
);
3036 defsubr (&Sprocess_send_eof
);
3037 defsubr (&Ssignal_process
);
3038 defsubr (&Swaiting_for_user_input_p
);
3039 /* defsubr (&Sprocess_connection); */
3043 #else /* not subprocesses */
3045 #include <sys/types.h>
3049 #include "systime.h"
3050 #include "termopts.h"
3052 extern int frame_garbaged
;
3055 /* As described above, except assuming that there are no subprocesses:
3057 Wait for timeout to elapse and/or keyboard input to be available.
3060 timeout in seconds, or
3061 zero for no limit, or
3062 -1 means gobble data immediately available but don't wait for any.
3064 read_kbd is a Lisp_Object:
3065 0 to ignore keyboard input, or
3066 1 to return when input is available, or
3067 -1 means caller will actually read the input, so don't throw to
3069 We know that read_kbd will never be a Lisp_Process, since
3070 `subprocesses' isn't defined.
3072 do_display != 0 means redisplay should be done to show subprocess
3073 output that arrives. This version of the function ignores it.
3075 Return true iff we recieved input from any process. */
3078 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3079 int time_limit
, microsecs
;
3080 Lisp_Object read_kbd
;
3083 EMACS_TIME end_time
, timeout
, *timeout_p
;
3086 /* What does time_limit really mean? */
3087 if (time_limit
|| microsecs
)
3089 /* It's not infinite. */
3090 timeout_p
= &timeout
;
3092 if (time_limit
== -1)
3093 /* In fact, it's zero. */
3094 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3096 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3098 /* How far in the future is that? */
3099 EMACS_GET_TIME (end_time
);
3100 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3103 /* It's infinite. */
3106 /* Turn off periodic alarms (in case they are in use)
3107 because the select emulator uses alarms. */
3114 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3116 /* If calling from keyboard input, do not quit
3117 since we want to return C-g as an input character.
3118 Otherwise, do pending quit if requested. */
3119 if (XINT (read_kbd
) >= 0)
3124 EMACS_GET_TIME (*timeout_p
);
3125 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3126 if (EMACS_TIME_NEG_P (*timeout_p
))
3130 /* Cause C-g and alarm signals to take immediate action,
3131 and cause input available signals to zero out timeout. */
3132 if (XINT (read_kbd
) < 0)
3133 set_waiting_for_input (&timeout
);
3135 /* If a frame has been newly mapped and needs updating,
3136 reprocess its display stuff. */
3138 redisplay_preserve_echo_area ();
3140 if (XINT (read_kbd
) && detect_input_pending ())
3143 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3145 /* Make C-g and alarm signals set flags again */
3146 clear_waiting_for_input ();
3148 /* If we woke up due to SIGWINCH, actually change size now. */
3149 do_pending_window_change ();
3153 /* If the system call was interrupted, then go around the
3159 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3160 /* System sometimes fails to deliver SIGIO. */
3161 kill (getpid (), SIGIO
);
3163 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3166 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3178 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3179 "Return the (or, a) process associated with BUFFER.\n\
3180 This copy of Emacs has not been built to support subprocesses, so this\n\
3181 function always returns nil.")
3183 register Lisp_Object name
;
3188 /* Kill all processes associated with `buffer'.
3189 If `buffer' is nil, kill all processes.
3190 Since we have no subprocesses, this does nothing. */
3192 kill_buffer_processes (buffer
)
3203 defsubr (&Sget_buffer_process
);
3207 #endif /* not subprocesses */