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)
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 /* For the CMU PTY driver + */
164 #define DCL_PROMPT "$ "
165 /* This is a hack. I have no idea what needs to go here, but this */
166 /* will get it to compile. We can fix it later. rbr */
176 extern char *sys_errlist
[];
180 extern char *sys_siglist
[];
182 char *sys_siglist
[] =
188 "illegal instruction",
192 "floating point exception",
195 "segmentation violation",
196 "bad argument to system call",
197 "write on a pipe with no one to read it",
199 "software termination signal from kill",
201 "sendable stop signal not from tty",
202 "stop signal from tty",
203 "continue a stopped process",
204 "child status has changed",
205 "background read attempted from control tty",
206 "background write attempted from control tty",
207 "input record available at control tty",
208 "exceeded CPU time limit",
209 "exceeded file size limit"
217 extern int comm_server
;
218 extern int net_listen_address
;
221 /* t means use pty, nil means use a pipe,
222 maybe other values to come. */
223 Lisp_Object Vprocess_connection_type
;
227 #include <sys/socket.h>
231 /* Number of events of change of status of a process. */
234 /* Number of events for which the user or sentinel has been notified. */
238 /* We could get this from param.h, but better not to depend on finding that.
239 And better not to risk that it might define other symbols used in this
242 #define SELECT_TYPE fd_set
243 #else /* no FD_SET */
245 #define SELECT_TYPE int
247 /* Define the macros to access a single-int bitmap of descriptors. */
248 #define FD_SET(n, p) (*(p) |= (1 << (n)))
249 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
250 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
251 #define FD_ZERO(p) (*(p) = 0)
252 #endif /* no FD_SET */
254 /* Mask of bits indicating the descriptors that we wait for input on */
256 SELECT_TYPE input_wait_mask
;
258 int delete_exited_processes
;
260 /* Indexed by descriptor, gives the process (if any) for that descriptor */
261 Lisp_Object chan_process
[MAXDESC
];
263 /* Alist of elements (NAME . PROCESS) */
264 Lisp_Object Vprocess_alist
;
266 Lisp_Object Qprocessp
;
268 Lisp_Object
get_process ();
270 /* Buffered-ahead input char from process, indexed by channel.
271 -1 means empty (no char is buffered).
272 Used on sys V where the only way to tell if there is any
273 output from the process is to read at least one char.
274 Always -1 on systems that support FIONREAD. */
276 int proc_buffered_char
[MAXDESC
];
278 /* Compute the Lisp form of the process status, p->status, from
279 the numeric status that was returned by `wait'. */
281 Lisp_Object
status_convert ();
284 struct Lisp_Process
*p
;
286 union { int i
; WAITTYPE wt
; } u
;
287 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
288 p
->status
= status_convert (u
.wt
);
289 p
->raw_status_low
= Qnil
;
290 p
->raw_status_high
= Qnil
;
293 /* Convert a process status work in Unix format to
294 the list that we use internally. */
301 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
302 else if (WIFEXITED (w
))
303 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
304 WCOREDUMP (w
) ? Qt
: Qnil
));
305 else if (WIFSIGNALED (w
))
306 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
307 WCOREDUMP (w
) ? Qt
: Qnil
));
312 /* Given a status-list, extract the three pieces of information
313 and store them individually through the three pointers. */
316 decode_status (l
, symbol
, code
, coredump
)
324 if (XTYPE (l
) == Lisp_Symbol
)
332 *symbol
= XCONS (l
)->car
;
333 tem
= XCONS (l
)->cdr
;
334 *code
= XFASTINT (XCONS (tem
)->car
);
335 tem
= XCONS (tem
)->cdr
;
336 *coredump
= !NILP (tem
);
340 /* Return a string describing a process status list. */
343 status_message (status
)
348 Lisp_Object string
, string2
;
350 decode_status (status
, &symbol
, &code
, &coredump
);
352 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
355 string
= build_string (code
< NSIG
? sys_siglist
[code
] : "unknown");
357 string
= build_string (code
< NSIG
? sys_errlist
[code
] : "unknown");
359 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
360 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
361 return concat2 (string
, string2
);
363 else if (EQ (symbol
, Qexit
))
366 return build_string ("finished\n");
367 string
= Fint_to_string (make_number (code
));
368 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
369 return concat2 (build_string ("exited abnormally with code "),
370 concat2 (string
, string2
));
373 return Fcopy_sequence (Fsymbol_name (symbol
));
378 /* Open an available pty, returning a file descriptor.
379 Return -1 on failure.
380 The file name of the terminal corresponding to the pty
381 is left in the variable pty_name. */
392 /* Some systems name their pseudoterminals so that there are gaps in
393 the usual sequence - for example, on HP9000/S700 systems, there
394 are no pseudoterminals with names ending in 'f'. So we wait for
395 three failures in a row before deciding that we've reached the
397 int failed_count
= 0;
402 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
403 for (i
= 0; i
< 16; i
++)
406 #ifdef PTY_NAME_SPRINTF
409 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
410 #endif /* no PTY_NAME_SPRINTF */
414 #else /* no PTY_OPEN */
416 /* Unusual IRIS code */
417 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
420 if (fstat (fd
, &stb
) < 0)
423 if (stat (pty_name
, &stb
) < 0)
426 if (failed_count
>= 3)
432 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
434 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
436 #endif /* not IRIS */
437 #endif /* no PTY_OPEN */
441 /* check to make certain that both sides are available
442 this avoids a nasty yet stupid bug in rlogins */
443 #ifdef PTY_TTY_NAME_SPRINTF
446 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
447 #endif /* no PTY_TTY_NAME_SPRINTF */
449 if (access (pty_name
, 6) != 0)
458 #endif /* not UNIPLUS */
465 #endif /* HAVE_PTYS */
471 register Lisp_Object val
, tem
, name1
;
472 register struct Lisp_Process
*p
;
476 /* size of process structure includes the vector header,
477 so deduct for that. But struct Lisp_Vector includes the first
478 element, thus deducts too much, so add it back. */
479 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
480 - sizeof (struct Lisp_Vector
)
481 + sizeof (Lisp_Object
))
482 / sizeof (Lisp_Object
)),
484 XSETTYPE (val
, Lisp_Process
);
487 XFASTINT (p
->infd
) = 0;
488 XFASTINT (p
->outfd
) = 0;
489 XFASTINT (p
->pid
) = 0;
490 XFASTINT (p
->tick
) = 0;
491 XFASTINT (p
->update_tick
) = 0;
492 p
->raw_status_low
= Qnil
;
493 p
->raw_status_high
= Qnil
;
495 p
->mark
= Fmake_marker ();
497 /* If name is already in use, modify it until it is unused. */
502 tem
= Fget_process (name1
);
503 if (NILP (tem
)) break;
504 sprintf (suffix
, "<%d>", i
);
505 name1
= concat2 (name
, build_string (suffix
));
509 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
513 remove_process (proc
)
514 register Lisp_Object proc
;
516 register Lisp_Object pair
;
518 pair
= Frassq (proc
, Vprocess_alist
);
519 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
520 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
522 deactivate_process (proc
);
525 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
526 "Return t if OBJECT is a process.")
530 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
533 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
534 "Return the process named NAME, or nil if there is none.")
536 register Lisp_Object name
;
538 if (XTYPE (name
) == Lisp_Process
)
540 CHECK_STRING (name
, 0);
541 return Fcdr (Fassoc (name
, Vprocess_alist
));
544 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
545 "Return the (or, a) process associated with BUFFER.\n\
546 BUFFER may be a buffer or the name of one.")
548 register Lisp_Object name
;
550 register Lisp_Object buf
, tail
, proc
;
552 if (NILP (name
)) return Qnil
;
553 buf
= Fget_buffer (name
);
554 if (NILP (buf
)) return Qnil
;
556 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
558 proc
= Fcdr (Fcar (tail
));
559 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
565 /* This is how commands for the user decode process arguments. It
566 accepts a process, a process name, a buffer, a buffer name, or nil.
567 Buffers denote the first process in the buffer, and nil denotes the
572 register Lisp_Object name
;
574 register Lisp_Object proc
;
576 proc
= Fget_buffer_process (Fcurrent_buffer ());
579 proc
= Fget_process (name
);
581 proc
= Fget_buffer_process (Fget_buffer (name
));
588 error ("Current buffer has no process");
590 error ("Process %s does not exist", XSTRING (name
)->data
);
594 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
595 "Delete PROCESS: kill it and forget about it immediately.\n\
596 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
597 nil, indicating the current buffer's process.")
599 register Lisp_Object proc
;
601 proc
= get_process (proc
);
602 XPROCESS (proc
)->raw_status_low
= Qnil
;
603 XPROCESS (proc
)->raw_status_high
= Qnil
;
604 if (NETCONN_P (proc
))
606 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
607 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
609 else if (XFASTINT (XPROCESS (proc
)->infd
))
611 Fkill_process (proc
, Qnil
);
612 /* Do this now, since remove_process will make sigchld_handler do nothing. */
613 XPROCESS (proc
)->status
614 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
615 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
618 remove_process (proc
);
622 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
623 "Return the status of PROCESS: a symbol, one of these:\n\
624 run -- for a process that is running.\n\
625 stop -- for a process stopped but continuable.\n\
626 exit -- for a process that has exited.\n\
627 signal -- for a process that has got a fatal signal.\n\
628 open -- for a network stream connection that is open.\n\
629 closed -- for a network stream connection that is closed.\n\
630 nil -- if arg is a process name and no such process exists.\n\
631 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
632 nil, indicating the current buffer's process.")
633 /* command -- for a command channel opened to Emacs by another process.\n\
634 external -- for an i/o channel opened to Emacs by another process.\n\ */
636 register Lisp_Object proc
;
638 register struct Lisp_Process
*p
;
639 register Lisp_Object status
;
640 proc
= get_process (proc
);
644 if (!NILP (p
->raw_status_low
))
647 if (XTYPE (status
) == Lisp_Cons
)
648 status
= XCONS (status
)->car
;
649 if (NETCONN_P (proc
))
651 if (EQ (status
, Qrun
))
653 else if (EQ (status
, Qexit
))
659 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
661 "Return the exit status of PROCESS or the signal number that killed it.\n\
662 If PROCESS has not yet exited or died, return 0.")
664 register Lisp_Object proc
;
666 CHECK_PROCESS (proc
, 0);
667 if (!NILP (XPROCESS (proc
)->raw_status_low
))
668 update_status (XPROCESS (proc
));
669 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
670 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
671 return make_number (0);
674 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
675 "Return the process id of PROCESS.\n\
676 This is the pid of the Unix process which PROCESS uses or talks to.\n\
677 For a network connection, this value is nil.")
679 register Lisp_Object proc
;
681 CHECK_PROCESS (proc
, 0);
682 return XPROCESS (proc
)->pid
;
685 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
686 "Return the name of PROCESS, as a string.\n\
687 This is the name of the program invoked in PROCESS,\n\
688 possibly modified to make it unique among process names.")
690 register Lisp_Object proc
;
692 CHECK_PROCESS (proc
, 0);
693 return XPROCESS (proc
)->name
;
696 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
697 "Return the command that was executed to start PROCESS.\n\
698 This is a list of strings, the first string being the program executed\n\
699 and the rest of the strings being the arguments given to it.\n\
700 For a non-child channel, this is nil.")
702 register Lisp_Object proc
;
704 CHECK_PROCESS (proc
, 0);
705 return XPROCESS (proc
)->command
;
708 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
710 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
712 register Lisp_Object proc
, buffer
;
714 CHECK_PROCESS (proc
, 0);
716 CHECK_BUFFER (buffer
, 1);
717 XPROCESS (proc
)->buffer
= buffer
;
721 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
723 "Return the buffer PROCESS is associated with.\n\
724 Output from PROCESS is inserted in this buffer\n\
725 unless PROCESS has a filter.")
727 register Lisp_Object proc
;
729 CHECK_PROCESS (proc
, 0);
730 return XPROCESS (proc
)->buffer
;
733 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
735 "Return the marker for the end of the last output from PROCESS.")
737 register Lisp_Object proc
;
739 CHECK_PROCESS (proc
, 0);
740 return XPROCESS (proc
)->mark
;
743 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
745 "Give PROCESS the filter function FILTER; nil means no filter.\n\
746 When a process has a filter, each time it does output\n\
747 the entire string of output is passed to the filter.\n\
748 The filter gets two arguments: the process and the string of output.\n\
749 If the process has a filter, its buffer is not used for output.")
751 register Lisp_Object proc
, filter
;
753 CHECK_PROCESS (proc
, 0);
754 XPROCESS (proc
)->filter
= filter
;
758 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
760 "Returns the filter function of PROCESS; nil if none.\n\
761 See `set-process-filter' for more info on filter functions.")
763 register Lisp_Object proc
;
765 CHECK_PROCESS (proc
, 0);
766 return XPROCESS (proc
)->filter
;
769 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
771 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
772 The sentinel is called as a function when the process changes state.\n\
773 It gets two arguments: the process, and a string describing the change.")
775 register Lisp_Object proc
, sentinel
;
777 CHECK_PROCESS (proc
, 0);
778 XPROCESS (proc
)->sentinel
= sentinel
;
782 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
784 "Return the sentinel of PROCESS; nil if none.\n\
785 See `set-process-sentinel' for more info on sentinels.")
787 register Lisp_Object proc
;
789 CHECK_PROCESS (proc
, 0);
790 return XPROCESS (proc
)->sentinel
;
793 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
794 Sprocess_kill_without_query
, 1, 2, 0,
795 "Say no query needed if PROCESS is running when Emacs is exited.\n\
796 Optional second argument if non-nill says to require a query.\n\
797 Value is t if a query was formerly required.")
799 register Lisp_Object proc
, value
;
803 CHECK_PROCESS (proc
, 0);
804 tem
= XPROCESS (proc
)->kill_without_query
;
805 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
813 register Lisp_Object tail
, tem
;
814 Lisp_Object proc
, minspace
, tem1
;
815 register struct buffer
*old
= current_buffer
;
816 register struct Lisp_Process
*p
;
820 XFASTINT (minspace
) = 1;
822 set_buffer_internal (XBUFFER (Vstandard_output
));
823 Fbuffer_disable_undo (Vstandard_output
);
825 current_buffer
->truncate_lines
= Qt
;
828 Proc Status Buffer Command\n\
829 ---- ------ ------ -------\n", -1);
831 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
835 proc
= Fcdr (Fcar (tail
));
837 if (NILP (p
->childp
))
840 Finsert (1, &p
->name
);
841 Findent_to (make_number (13), minspace
);
843 if (!NILP (p
->raw_status_low
))
846 if (XTYPE (p
->status
) == Lisp_Cons
)
847 symbol
= XCONS (p
->status
)->car
;
850 if (EQ (symbol
, Qsignal
))
853 tem
= Fcar (Fcdr (p
->status
));
855 if (XINT (tem
) < NSIG
)
856 write_string (sys_errlist
[XINT (tem
)], -1);
859 Fprinc (symbol
, Qnil
);
861 else if (NETCONN_P (proc
))
863 if (EQ (symbol
, Qrun
))
864 write_string ("open", -1);
865 else if (EQ (symbol
, Qexit
))
866 write_string ("closed", -1);
868 Fprinc (symbol
, Qnil
);
871 Fprinc (symbol
, Qnil
);
873 if (EQ (symbol
, Qexit
))
876 tem
= Fcar (Fcdr (p
->status
));
879 sprintf (tembuf
, " %d", XFASTINT (tem
));
880 write_string (tembuf
, -1);
884 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
885 remove_process (proc
);
887 Findent_to (make_number (22), minspace
);
888 if (NILP (p
->buffer
))
889 insert_string ("(none)");
890 else if (NILP (XBUFFER (p
->buffer
)->name
))
891 insert_string ("(Killed)");
893 Finsert (1, &XBUFFER (p
->buffer
)->name
);
895 Findent_to (make_number (37), minspace
);
897 if (NETCONN_P (proc
))
899 sprintf (tembuf
, "(network stream connection to %s)\n",
900 XSTRING (p
->childp
)->data
);
901 insert_string (tembuf
);
915 insert_string ("\n");
921 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
922 "Display a list of all processes.\n\
923 \(Any processes listed as Exited or Signaled are actually eliminated\n\
924 after the listing is made.)")
927 internal_with_output_to_temp_buffer ("*Process List*",
928 list_processes_1
, Qnil
);
932 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
933 "Return a list of all processes.")
936 return Fmapcar (Qcdr
, Vprocess_alist
);
939 /* Starting asynchronous inferior processes. */
941 static Lisp_Object
start_process_unwind ();
943 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
944 "Start a program in a subprocess. Return the process object for it.\n\
945 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
946 NAME is name for process. It is modified if necessary to make it unique.\n\
947 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
948 Process output goes at end of that buffer, unless you specify\n\
949 an output stream or filter function to handle the output.\n\
950 BUFFER may be also nil, meaning that this process is not associated\n\
952 Third arg is program file name. It is searched for as in the shell.\n\
953 Remaining arguments are strings to give program as arguments.")
956 register Lisp_Object
*args
;
958 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
960 register unsigned char *new_argv
;
963 register unsigned char **new_argv
;
966 int count
= specpdl_ptr
- specpdl
;
970 buffer
= Fget_buffer_create (buffer
);
972 /* Make sure that the child will be able to chdir to the current
973 buffer's current directory, or its unhandled equivalent. We
974 can't just have the child check for an error when it does the
975 chdir, since it's in a vfork.
977 We have to GCPRO around this because Fexpand_file_name and
978 Funhandled_file_name_directory might call a file name handling
979 function. The argument list is protected by the caller, so all
980 we really have to worry about is buffer. */
982 struct gcpro gcpro1
, gcpro2
;
984 current_dir
= current_buffer
->directory
;
986 GCPRO2 (buffer
, current_dir
);
989 expand_and_dir_to_file
990 (Funhandled_file_name_directory (current_dir
), Qnil
);
991 if (NILP (Ffile_accessible_directory_p (current_dir
)))
992 report_file_error ("Setting current directory",
993 Fcons (current_buffer
->directory
, Qnil
));
999 CHECK_STRING (name
, 0);
1003 CHECK_STRING (program
, 2);
1006 /* Make a one member argv with all args concatenated
1007 together separated by a blank. */
1008 len
= XSTRING (program
)->size
+ 2;
1009 for (i
= 3; i
< nargs
; i
++)
1012 CHECK_STRING (tem
, i
);
1013 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1015 new_argv
= (unsigned char *) alloca (len
);
1016 strcpy (new_argv
, XSTRING (program
)->data
);
1017 for (i
= 3; i
< nargs
; i
++)
1020 CHECK_STRING (tem
, i
);
1021 strcat (new_argv
, " ");
1022 strcat (new_argv
, XSTRING (tem
)->data
);
1024 /* Need to add code here to check for program existence on VMS */
1027 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1029 for (i
= 3; i
< nargs
; i
++)
1032 CHECK_STRING (tem
, i
);
1033 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1035 new_argv
[i
- 2] = 0;
1036 new_argv
[0] = XSTRING (program
)->data
;
1038 /* If program file name is not absolute, search our path for it */
1039 if (new_argv
[0][0] != '/')
1042 openp (Vexec_path
, program
, "", &tem
, 1);
1044 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1045 new_argv
[0] = XSTRING (tem
)->data
;
1047 #endif /* not VMS */
1049 proc
= make_process (name
);
1050 /* If an error occurs and we can't start the process, we want to
1051 remove it from the process list. This means that each error
1052 check in create_process doesn't need to call remove_process
1053 itself; it's all taken care of here. */
1054 record_unwind_protect (start_process_unwind
, proc
);
1056 XPROCESS (proc
)->childp
= Qt
;
1057 XPROCESS (proc
)->command_channel_p
= Qnil
;
1058 XPROCESS (proc
)->buffer
= buffer
;
1059 XPROCESS (proc
)->sentinel
= Qnil
;
1060 XPROCESS (proc
)->filter
= Qnil
;
1061 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1063 create_process (proc
, new_argv
, current_dir
);
1065 return unbind_to (count
, proc
);
1068 /* This function is the unwind_protect form for Fstart_process. If
1069 PROC doesn't have its pid set, then we know someone has signalled
1070 an error and the process wasn't started successfully, so we should
1071 remove it from the process list. */
1073 start_process_unwind (proc
)
1076 if (XTYPE (proc
) != Lisp_Process
)
1079 /* Was PROC started successfully? */
1080 if (XPROCESS (proc
)->pid
<= 0)
1081 remove_process (proc
);
1088 create_process_1 (signo
)
1092 /* USG systems forget handlers when they are used;
1093 must reestablish each time */
1094 signal (signo
, create_process_1
);
1098 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1101 /* Mimic blocking of signals on system V, which doesn't really have it. */
1103 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1104 int sigchld_deferred
;
1107 create_process_sigchld ()
1109 signal (SIGCHLD
, create_process_sigchld
);
1111 sigchld_deferred
= 1;
1117 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1118 create_process (process
, new_argv
, current_dir
)
1119 Lisp_Object process
;
1121 Lisp_Object current_dir
;
1123 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1126 SIGTYPE (*sigchld
)();
1129 extern char **environ
;
1131 inchannel
= outchannel
= -1;
1134 if (EQ (Vprocess_connection_type
, Qt
))
1135 outchannel
= inchannel
= allocate_pty ();
1140 /* On USG systems it does not work to open the pty's tty here
1141 and then close and reopen it in the child. */
1143 /* Don't let this terminal become our controlling terminal
1144 (in case we don't have one). */
1145 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1147 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1150 report_file_error ("Opening pty", Qnil
);
1152 forkin
= forkout
= -1;
1153 #endif /* not USG */
1157 #endif /* HAVE_PTYS */
1160 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1161 report_file_error ("Opening socketpair", Qnil
);
1162 outchannel
= inchannel
= sv
[0];
1163 forkout
= forkin
= sv
[1];
1165 #else /* not SKTPAIR */
1174 #endif /* not SKTPAIR */
1177 /* Replaced by close_process_descs */
1178 set_exclusive_use (inchannel
);
1179 set_exclusive_use (outchannel
);
1182 /* Stride people say it's a mystery why this is needed
1183 as well as the O_NDELAY, but that it fails without this. */
1184 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1187 ioctl (inchannel
, FIONBIO
, &one
);
1192 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1195 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1199 /* Record this as an active process, with its channels.
1200 As a result, child_setup will close Emacs's side of the pipes. */
1201 chan_process
[inchannel
] = process
;
1202 XFASTINT (XPROCESS (process
)->infd
) = inchannel
;
1203 XFASTINT (XPROCESS (process
)->outfd
) = outchannel
;
1204 /* Record the tty descriptor used in the subprocess. */
1206 XPROCESS (process
)->subtty
= Qnil
;
1208 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1209 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1210 XPROCESS (process
)->status
= Qrun
;
1212 /* Delay interrupts until we have a chance to store
1213 the new fork's pid in its process structure */
1217 #else /* not BSD4_1 */
1218 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1219 sigsetmask (sigmask (SIGCHLD
));
1220 #else /* ordinary USG */
1222 sigchld_deferred
= 0;
1223 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1225 #endif /* ordinary USG */
1226 #endif /* not BSD4_1 */
1227 #endif /* SIGCHLD */
1229 /* Until we store the proper pid, enable sigchld_handler
1230 to recognize an unknown pid as standing for this process.
1231 It is very important not to let this `marker' value stay
1232 in the table after this function has returned; if it does
1233 it might cause call-process to hang and subsequent asynchronous
1234 processes to get their return values scrambled. */
1235 XSETINT (XPROCESS (process
)->pid
, -1);
1238 /* child_setup must clobber environ on systems with true vfork.
1239 Protect it from permanent change. */
1240 char **save_environ
= environ
;
1245 int xforkin
= forkin
;
1246 int xforkout
= forkout
;
1248 #if 0 /* This was probably a mistake--it duplicates code later on,
1249 but fails to handle all the cases. */
1250 /* Make sure SIGCHLD is not blocked in the child. */
1251 sigsetmask (SIGEMPTYMASK
);
1254 /* Make the pty be the controlling terminal of the process. */
1256 /* First, disconnect its current controlling terminal. */
1260 /* Make the pty's terminal the controlling terminal. */
1261 if (pty_flag
&& (ioctl (xforkin
, TIOCSCTTY
, 0) < 0))
1264 #else /* not HAVE_SETSID */
1266 /* It's very important to call setpgrp() here and no time
1267 afterwards. Otherwise, we lose our controlling tty which
1268 is set when we open the pty. */
1271 #endif /* not HAVE_SETSID */
1273 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1274 can do TIOCSPGRP only to the process's controlling tty. */
1277 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1278 I can't test it since I don't have 4.3. */
1279 int j
= open ("/dev/tty", O_RDWR
, 0);
1280 ioctl (j
, TIOCNOTTY
, 0);
1283 /* In order to get a controlling terminal on some versions
1284 of BSD, it is necessary to put the process in pgrp 0
1285 before it opens the terminal. */
1289 #endif /* TIOCNOTTY */
1291 #if !defined (RTU) && !defined (UNIPLUS)
1292 /*** There is a suggestion that this ought to be a
1293 conditional on TIOCSPGRP. */
1294 /* Now close the pty (if we had it open) and reopen it.
1295 This makes the pty the controlling terminal of the subprocess. */
1298 /* I wonder if close (open (pty_name, ...)) would work? */
1301 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1306 #endif /* not UNIPLUS and not RTU */
1307 #ifdef SETUP_SLAVE_PTY
1309 #endif /* SETUP_SLAVE_PTY */
1311 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1312 Now reenable it in the child, so it will die when we want it to. */
1314 signal (SIGHUP
, SIG_DFL
);
1316 #endif /* HAVE_PTYS */
1321 #else /* not BSD4_1 */
1322 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1323 sigsetmask (SIGEMPTYMASK
);
1324 #else /* ordinary USG */
1326 signal (SIGCHLD
, sigchld
);
1328 #endif /* ordinary USG */
1329 #endif /* not BSD4_1 */
1330 #endif /* SIGCHLD */
1332 child_setup_tty (xforkout
);
1333 child_setup (xforkin
, xforkout
, xforkout
,
1334 new_argv
, 1, current_dir
);
1336 environ
= save_environ
;
1340 report_file_error ("Doing vfork", Qnil
);
1342 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1344 FD_SET (inchannel
, &input_wait_mask
);
1346 /* If the subfork execv fails, and it exits,
1347 this close hangs. I don't know why.
1348 So have an interrupt jar it loose. */
1350 signal (SIGALRM
, create_process_1
);
1353 /* OK to close only if it's not a pty. Otherwise we need to leave
1354 it open for ioctl to get pgrp when signals are sent, or to send
1355 the interrupt characters through if that's how we're signalling
1356 subprocesses. Alternately if you are concerned about running out
1357 of file descriptors, you could just save the tty name and open
1358 just to do the ioctl. */
1359 if (NILP (XFASTINT (XPROCESS (process
)->pty_flag
)))
1362 XPROCESS (process
)->subtty
= Qnil
;
1368 if (forkin
!= forkout
&& forkout
>= 0)
1374 #else /* not BSD4_1 */
1375 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1376 sigsetmask (SIGEMPTYMASK
);
1377 #else /* ordinary USG */
1379 signal (SIGCHLD
, sigchld
);
1380 /* Now really handle any of these signals
1381 that came in during this function. */
1382 if (sigchld_deferred
)
1383 kill (getpid (), SIGCHLD
);
1385 #endif /* ordinary USG */
1386 #endif /* not BSD4_1 */
1387 #endif /* SIGCHLD */
1389 #endif /* not VMS */
1393 /* open a TCP network connection to a given HOST/SERVICE. Treated
1394 exactly like a normal process when reading and writing. Only
1395 differences are in status display and process deletion. A network
1396 connection has no PID; you cannot signal it. All you can do is
1397 deactivate and close it via delete-process */
1399 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1401 "Open a TCP connection for a service to a host.\n\
1402 Returns a subprocess-object to represent the connection.\n\
1403 Input and output work as for subprocesses; `delete-process' closes it.\n\
1404 Args are NAME BUFFER HOST SERVICE.\n\
1405 NAME is name for process. It is modified if necessary to make it unique.\n\
1406 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1407 Process output goes at end of that buffer, unless you specify\n\
1408 an output stream or filter function to handle the output.\n\
1409 BUFFER may be also nil, meaning that this process is not associated\n\
1411 Third arg is name of the host to connect to, or its IP address.\n\
1412 Fourth arg SERVICE is name of the service desired, or an integer\n\
1413 specifying a port number to connect to.")
1414 (name
, buffer
, host
, service
)
1415 Lisp_Object name
, buffer
, host
, service
;
1419 struct sockaddr_in address
;
1420 struct servent
*svc_info
;
1421 struct hostent
*host_info_ptr
, host_info
;
1422 char *(addr_list
[2]);
1423 unsigned long numeric_addr
;
1427 struct hostent host_info_fixed
;
1428 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1430 GCPRO4 (name
, buffer
, host
, service
);
1431 CHECK_STRING (name
, 0);
1432 CHECK_STRING (host
, 0);
1433 if (XTYPE(service
) == Lisp_Int
)
1434 port
= htons ((unsigned short) XINT (service
));
1437 CHECK_STRING (service
, 0);
1438 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1440 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1441 port
= svc_info
->s_port
;
1444 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1445 if (host_info_ptr
== 0)
1446 /* Attempt to interpret host as numeric inet address */
1448 numeric_addr
= inet_addr (XSTRING (host
)->data
);
1449 if (numeric_addr
== -1)
1450 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1452 host_info_ptr
= &host_info
;
1453 host_info
.h_name
= 0;
1454 host_info
.h_aliases
= 0;
1455 host_info
.h_addrtype
= AF_INET
;
1456 host_info
.h_addr_list
= &(addr_list
[0]);
1457 addr_list
[0] = (char*)(&numeric_addr
);
1459 host_info
.h_length
= strlen (addr_list
[0]);
1462 bzero (&address
, sizeof address
);
1463 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1464 host_info_ptr
->h_length
);
1465 address
.sin_family
= host_info_ptr
->h_addrtype
;
1466 address
.sin_port
= port
;
1468 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1470 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1473 if (connect (s
, &address
, sizeof address
) == -1)
1480 report_file_error ("connection failed",
1481 Fcons (host
, Fcons (name
, Qnil
)));
1487 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1490 buffer
= Fget_buffer_create (buffer
);
1491 proc
= make_process (name
);
1493 chan_process
[inch
] = proc
;
1496 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1499 fcntl (inch
, F_SETFL
, O_NDELAY
);
1503 XPROCESS (proc
)->childp
= host
;
1504 XPROCESS (proc
)->command_channel_p
= Qnil
;
1505 XPROCESS (proc
)->buffer
= buffer
;
1506 XPROCESS (proc
)->sentinel
= Qnil
;
1507 XPROCESS (proc
)->filter
= Qnil
;
1508 XPROCESS (proc
)->command
= Qnil
;
1509 XPROCESS (proc
)->pid
= Qnil
;
1510 XFASTINT (XPROCESS (proc
)->infd
) = s
;
1511 XFASTINT (XPROCESS (proc
)->outfd
) = outch
;
1512 XPROCESS (proc
)->status
= Qrun
;
1513 FD_SET (inch
, &input_wait_mask
);
1518 #endif /* HAVE_SOCKETS */
1520 deactivate_process (proc
)
1523 register int inchannel
, outchannel
;
1524 register struct Lisp_Process
*p
= XPROCESS (proc
);
1526 inchannel
= XFASTINT (p
->infd
);
1527 outchannel
= XFASTINT (p
->outfd
);
1531 /* Beware SIGCHLD hereabouts. */
1532 flush_pending_output (inchannel
);
1535 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1536 sys$
dassgn (outchannel
);
1537 vs
= get_vms_process_pointer (p
->pid
)
1539 give_back_vms_process_stuff (vs
);
1543 if (outchannel
&& outchannel
!= inchannel
)
1547 XFASTINT (p
->infd
) = 0;
1548 XFASTINT (p
->outfd
) = 0;
1549 chan_process
[inchannel
] = Qnil
;
1550 FD_CLR (inchannel
, &input_wait_mask
);
1554 /* Close all descriptors currently in use for communication
1555 with subprocess. This is used in a newly-forked subprocess
1556 to get rid of irrelevant descriptors. */
1558 close_process_descs ()
1561 for (i
= 0; i
< MAXDESC
; i
++)
1563 Lisp_Object process
;
1564 process
= chan_process
[i
];
1565 if (!NILP (process
))
1567 int in
= XFASTINT (XPROCESS (process
)->infd
);
1568 int out
= XFASTINT (XPROCESS (process
)->outfd
);
1571 if (out
&& in
!= out
)
1577 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1579 "Allow any pending output from subprocesses to be read by Emacs.\n\
1580 It is read into the process' buffers or given to their filter functions.\n\
1581 Non-nil arg PROCESS means do not return until some output has been received\n\
1583 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1584 seconds and microseconds to wait; return after that much time whether\n\
1585 or not there is input.\n\
1586 Return non-nil iff we received any output before the timeout expired.")
1587 (proc
, timeout
, timeout_msecs
)
1588 register Lisp_Object proc
, timeout
, timeout_msecs
;
1593 if (! NILP (timeout_msecs
))
1595 CHECK_NUMBER (timeout_msecs
, 2);
1596 useconds
= XINT (timeout_msecs
);
1597 if (XTYPE (timeout
) != Lisp_Int
)
1598 XSET (timeout
, Lisp_Int
, 0);
1601 int carry
= useconds
/ 1000000;
1603 XSETINT (timeout
, XINT (timeout
) + carry
);
1604 useconds
-= carry
* 1000000;
1606 /* I think this clause is necessary because C doesn't
1607 guarantee a particular rounding direction for negative
1611 XSETINT (timeout
, XINT (timeout
) - 1);
1612 useconds
+= 1000000;
1619 if (! NILP (timeout
))
1621 CHECK_NUMBER (timeout
, 1);
1622 seconds
= XINT (timeout
);
1635 XFASTINT (proc
) = 0;
1638 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1642 /* This variable is different from waiting_for_input in keyboard.c.
1643 It is used to communicate to a lisp process-filter/sentinel (via the
1644 function Fwaiting_for_user_input_p below) whether emacs was waiting
1645 for user-input when that process-filter was called.
1646 waiting_for_input cannot be used as that is by definition 0 when
1647 lisp code is being evalled */
1648 static int waiting_for_user_input_p
;
1650 /* Read and dispose of subprocess output while waiting for timeout to
1651 elapse and/or keyboard input to be available.
1654 timeout in seconds, or
1655 zero for no limit, or
1656 -1 means gobble data immediately available but don't wait for any.
1658 read_kbd is a lisp value:
1659 0 to ignore keyboard input, or
1660 1 to return when input is available, or
1661 -1 means caller will actually read the input, so don't throw to
1662 the quit handler, 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;
1690 FD_ZERO (&Available
);
1692 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1694 if (XTYPE (read_kbd
) == Lisp_Process
)
1696 wait_proc
= XPROCESS (read_kbd
);
1697 wait_channel
= XFASTINT (wait_proc
->infd
);
1698 XFASTINT (read_kbd
) = 0;
1701 waiting_for_user_input_p
= XINT (read_kbd
);
1703 /* Since we may need to wait several times,
1704 compute the absolute time to return at. */
1705 if (time_limit
|| microsecs
)
1707 EMACS_GET_TIME (end_time
);
1708 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1709 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1714 /* If calling from keyboard input, do not quit
1715 since we want to return C-g as an input character.
1716 Otherwise, do pending quit if requested. */
1717 if (XINT (read_kbd
) >= 0)
1720 /* Compute time from now till when time limit is up */
1721 /* Exit if already run out */
1722 if (time_limit
== -1)
1724 /* -1 specified for timeout means
1725 gobble output available now
1726 but don't wait at all. */
1728 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1730 else if (time_limit
|| microsecs
)
1732 EMACS_GET_TIME (timeout
);
1733 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1734 if (EMACS_TIME_NEG_P (timeout
))
1739 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1742 /* Cause C-g and alarm signals to take immediate action,
1743 and cause input available signals to zero out timeout.
1745 It is important that we do this before checking for process
1746 activity. If we get a SIGCHLD after the explicit checks for
1747 process activity, timeout is the only way we will know. */
1748 if (XINT (read_kbd
) < 0)
1749 set_waiting_for_input (&timeout
);
1751 /* If status of something has changed, and no input is
1752 available, notify the user of the change right away. After
1753 this explicit check, we'll let the SIGCHLD handler zap
1754 timeout to get our attention. */
1755 if (update_tick
!= process_tick
&& do_display
)
1757 Atemp
= input_wait_mask
;
1758 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1759 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1763 /* Don't wait for output from a non-running process. */
1764 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1765 update_status (wait_proc
);
1767 && ! EQ (wait_proc
->status
, Qrun
))
1770 /* Wait till there is something to do */
1772 Available
= input_wait_mask
;
1773 if (! XINT (read_kbd
))
1774 FD_CLR (0, &Available
);
1776 /* If frame size has changed or the window is newly mapped,
1777 redisplay now, before we start to wait. There is a race
1778 condition here; if a SIGIO arrives between now and the select
1779 and indicates that a frame is trashed, the select may block
1780 displaying a trashed screen. */
1782 redisplay_preserve_echo_area ();
1784 if (XINT (read_kbd
) && detect_input_pending ())
1787 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1791 /* Make C-g and alarm signals set flags again */
1792 clear_waiting_for_input ();
1794 /* If we woke up due to SIGWINCH, actually change size now. */
1795 do_pending_window_change ();
1797 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1801 if (xerrno
== EINTR
)
1802 FD_ZERO (&Available
);
1804 /* Ultrix select seems to return ENOMEM when it is
1805 interrupted. Treat it just like EINTR. Bleah. Note
1806 that we want to test for the "ultrix" CPP symbol, not
1807 "__ultrix__"; the latter is only defined under GCC, but
1808 not by DEC's bundled CC. -JimB */
1809 else if (xerrno
== ENOMEM
)
1810 FD_ZERO (&Available
);
1813 /* This happens for no known reason on ALLIANT.
1814 I am guessing that this is the right response. -- RMS. */
1815 else if (xerrno
== EFAULT
)
1816 FD_ZERO (&Available
);
1818 else if (xerrno
== EBADF
)
1821 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1822 the child's closure of the pts gives the parent a SIGHUP, and
1823 the ptc file descriptor is automatically closed,
1824 yielding EBADF here or at select() call above.
1825 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1826 in m-ibmrt-aix.h), and here we just ignore the select error.
1827 Cleanup occurs c/o status_notify after SIGCLD. */
1828 FD_ZERO (&Available
); /* Cannot depend on values returned */
1834 error("select error: %s", sys_errlist
[xerrno
]);
1837 else if (nfds
> 0 && FD_ISSET (0, &Available
) && interrupt_input
)
1838 /* System sometimes fails to deliver SIGIO. */
1839 kill (getpid (), SIGIO
);
1842 /* Check for keyboard input */
1843 /* If there is any, return immediately
1844 to give it higher priority than subprocesses */
1846 if (XINT (read_kbd
) && detect_input_pending ())
1850 /* If we think we have keyboard input waiting, but didn't get SIGIO
1851 go read it. This can happen with X on BSD after logging out.
1852 In that case, there really is no input and no SIGIO,
1853 but select says there is input. */
1856 if (XINT (read_kbd) && interrupt_input && (Available & fileno (stdin)))
1858 if (XINT (read_kbd
) && interrupt_input
&& (FD_ISSET (fileno (stdin
), &Available
)))
1863 /* Check for connection from other process */
1865 if (Available
& ChannelMask (comm_server
))
1867 Available
&= ~(ChannelMask (comm_server
));
1873 got_some_input
|= nfds
> 0;
1875 /* If checking input just got us a size-change event from X,
1876 obey it now if we should. */
1877 if (XINT (read_kbd
))
1878 do_pending_window_change ();
1880 /* Check for data from a process or a command channel */
1881 for (channel
= FIRST_PROC_DESC
; channel
< MAXDESC
; channel
++)
1883 if (FD_ISSET (channel
, &Available
))
1887 /* If waiting for this channel, arrange to return as
1888 soon as no more input to be processed. No more
1890 if (wait_channel
== channel
)
1896 proc
= chan_process
[channel
];
1901 /* It's a command channel */
1902 if (!NILP (XPROCESS (proc
)->command_channel_p
))
1904 ProcessCommChan (channel
, proc
);
1905 if (NILP (XPROCESS (proc
)->command_channel_p
))
1907 /* It has ceased to be a command channel! */
1908 int bytes_available
;
1909 if (ioctl (channel
, FIONREAD
, &bytes_available
) < 0)
1910 bytes_available
= 0;
1911 if (bytes_available
)
1912 FD_SET (channel
, &Available
);
1918 /* Read data from the process, starting with our
1919 buffered-ahead character if we have one. */
1921 nread
= read_process_output (proc
, channel
);
1924 /* Since read_process_output can run a filter,
1925 which can call accept-process-output,
1926 don't try to read from any other processes
1927 before doing the select again. */
1928 FD_ZERO (&Available
);
1931 redisplay_preserve_echo_area ();
1934 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1938 else if (nread
== -1 && errno
== EAGAIN
)
1942 else if (nread
== -1 && errno
== EAGAIN
)
1944 /* Note that we cannot distinguish between no input
1945 available now and a closed pipe.
1946 With luck, a closed pipe will be accompanied by
1947 subprocess termination and SIGCHLD. */
1948 else if (nread
== 0 && !NETCONN_P (proc
))
1950 #endif /* O_NDELAY */
1951 #endif /* O_NONBLOCK */
1952 #endif /* EWOULDBLOCK */
1954 /* On some OSs with ptys, when the process on one end of
1955 a pty exits, the other end gets an error reading with
1956 errno = EIO instead of getting an EOF (0 bytes read).
1957 Therefore, if we get an error reading and errno =
1958 EIO, just continue, because the child process has
1959 exited and should clean itself up soon (e.g. when we
1961 else if (nread
== -1 && errno
== EIO
)
1963 #endif /* HAVE_PTYS */
1964 /* If we can detect process termination, don't consider the process
1965 gone just because its pipe is closed. */
1967 else if (nread
== 0 && !NETCONN_P (proc
))
1972 /* Preserve status of processes already terminated. */
1973 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
1974 deactivate_process (proc
);
1975 if (!NILP (XPROCESS (proc
)->raw_status_low
))
1976 update_status (XPROCESS (proc
));
1977 if (EQ (XPROCESS (proc
)->status
, Qrun
))
1978 XPROCESS (proc
)->status
1979 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
1982 } /* end for each file descriptor */
1983 } /* end while exit conditions not met */
1985 /* If calling from keyboard input, do not quit
1986 since we want to return C-g as an input character.
1987 Otherwise, do pending quit if requested. */
1988 if (XINT (read_kbd
) >= 0)
1990 /* Prevent input_pending from remaining set if we quit. */
1991 clear_input_pending ();
1995 return got_some_input
;
1998 /* Read pending output from the process channel,
1999 starting with our buffered-ahead character if we have one.
2000 Yield number of characters read.
2002 This function reads at most 1024 characters.
2003 If you want to read all available subprocess output,
2004 you must call it repeatedly until it returns zero. */
2006 read_process_output (proc
, channel
)
2008 register int channel
;
2010 register int nchars
;
2016 register Lisp_Object outstream
;
2017 register struct buffer
*old
= current_buffer
;
2018 register struct Lisp_Process
*p
= XPROCESS (proc
);
2019 register int opoint
;
2022 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2024 vs
= get_vms_process_pointer (p
->pid
);
2028 return(0); /* Really weird if it does this */
2029 if (!(vs
->iosb
[0] & 1))
2030 return -1; /* I/O error */
2033 error ("Could not get VMS process pointer");
2034 chars
= vs
->inputBuffer
;
2035 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2038 start_vms_process_read (vs
); /* Crank up the next read on the process */
2039 return 1; /* Nothing worth printing, say we got 1 */
2043 if (proc_buffered_char
[channel
] < 0)
2044 nchars
= read (channel
, chars
, sizeof chars
);
2047 chars
[0] = proc_buffered_char
[channel
];
2048 proc_buffered_char
[channel
] = -1;
2049 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2053 nchars
= nchars
+ 1;
2055 #endif /* not VMS */
2057 if (nchars
<= 0) return nchars
;
2059 outstream
= p
->filter
;
2060 if (!NILP (outstream
))
2062 /* We inhibit quit here instead of just catching it so that
2063 hitting ^G when a filter happens to be running won't screw
2065 int count
= specpdl_ptr
- specpdl
;
2066 specbind (Qinhibit_quit
, Qt
);
2067 call2 (outstream
, proc
, make_string (chars
, nchars
));
2070 start_vms_process_read (vs
);
2076 /* If no filter, write into buffer if it isn't dead. */
2077 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2079 Lisp_Object old_read_only
;
2080 Lisp_Object old_begv
, old_zv
;
2082 Fset_buffer (p
->buffer
);
2084 old_read_only
= current_buffer
->read_only
;
2085 XFASTINT (old_begv
) = BEGV
;
2086 XFASTINT (old_zv
) = ZV
;
2088 current_buffer
->read_only
= Qnil
;
2090 /* Insert new output into buffer
2091 at the current end-of-output marker,
2092 thus preserving logical ordering of input and output. */
2093 if (XMARKER (p
->mark
)->buffer
)
2094 SET_PT (marker_position (p
->mark
));
2098 /* If the output marker is outside of the visible region, save
2099 the restriction and widen. */
2100 if (! (BEGV
<= point
&& point
<= ZV
))
2103 /* Make sure opoint floats ahead of any new text, just as point
2105 if (point
<= opoint
)
2108 /* Insert after old_begv, but before old_zv. */
2109 if (point
< XFASTINT (old_begv
))
2110 XFASTINT (old_begv
) += nchars
;
2111 if (point
<= XFASTINT (old_zv
))
2112 XFASTINT (old_zv
) += nchars
;
2114 /* Insert before markers in case we are inserting where
2115 the buffer's mark is, and the user's next command is Meta-y. */
2116 insert_before_markers (chars
, nchars
);
2117 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2119 update_mode_lines
++;
2121 /* If the restriction isn't what it should be, set it. */
2122 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2123 Fnarrow_to_region (old_begv
, old_zv
);
2125 current_buffer
->read_only
= old_read_only
;
2127 set_buffer_internal (old
);
2130 start_vms_process_read (vs
);
2135 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2137 "Returns non-NIL if emacs is waiting for input from the user.\n\
2138 This is intended for use by asynchronous process output filters and sentinels.")
2141 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2144 /* Sending data to subprocess */
2146 jmp_buf send_process_frame
;
2149 send_process_trap ()
2155 longjmp (send_process_frame
, 1);
2158 send_process (proc
, buf
, len
)
2163 /* Don't use register vars; longjmp can lose them. */
2165 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2169 struct Lisp_Process
*p
= XPROCESS (proc
);
2170 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2173 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2174 update_status (XPROCESS (proc
));
2175 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2176 error ("Process %s not running", procname
);
2179 vs
= get_vms_process_pointer (p
->pid
);
2181 error ("Could not find this process: %x", p
->pid
);
2182 else if (write_to_vms_process (vs
, buf
, len
))
2185 if (!setjmp (send_process_frame
))
2189 SIGTYPE (*old_sigpipe
)();
2191 /* Don't send more than 500 bytes at a time. */
2194 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2195 rv
= write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, this);
2196 signal (SIGPIPE
, old_sigpipe
);
2201 || errno
== EWOULDBLOCK
2208 /* It would be nice to accept process output here,
2209 but that is difficult. For example, it could
2210 garbage what we are sending if that is from a buffer. */
2217 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2221 /* Allow input from processes between bursts of sending.
2222 Otherwise things may get stopped up. */
2227 XFASTINT (zero
) = 0;
2228 wait_reading_process_input (-1, 0, zero
, 0);
2234 XPROCESS (proc
)->raw_status_low
= Qnil
;
2235 XPROCESS (proc
)->raw_status_high
= Qnil
;
2236 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2237 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2238 deactivate_process (proc
);
2240 error ("Error writing to process %s; closed it", procname
);
2242 error ("SIGPIPE raised on process %s; closed it", procname
);
2247 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2249 "Send current contents of region as input to PROCESS.\n\
2250 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2251 nil, indicating the current buffer's process.\n\
2252 Called from program, takes three arguments, PROCESS, START and END.\n\
2253 If the region is more than 500 characters long,\n\
2254 it is sent in several bunches. This may happen even for shorter regions.\n\
2255 Output from processes can arrive in between bunches.")
2256 (process
, start
, end
)
2257 Lisp_Object process
, start
, end
;
2262 proc
= get_process (process
);
2263 validate_region (&start
, &end
);
2265 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2268 start1
= XINT (start
);
2269 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2274 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2276 "Send PROCESS the contents of STRING as input.\n\
2277 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2278 nil, indicating the current buffer's process.\n\
2279 If STRING is more than 500 characters long,\n\
2280 it is sent in several bunches. This may happen even for shorter strings.\n\
2281 Output from processes can arrive in between bunches.")
2283 Lisp_Object process
, string
;
2286 CHECK_STRING (string
, 1);
2287 proc
= get_process (process
);
2288 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2292 /* send a signal number SIGNO to PROCESS.
2293 CURRENT_GROUP means send to the process group that currently owns
2294 the terminal being used to communicate with PROCESS.
2295 This is used for various commands in shell mode.
2296 If NOMSG is zero, insert signal-announcements into process's buffers
2299 If we can, we try to signal PROCESS by sending control characters
2300 down the pipe. This allows us to signal inferiors who have changed
2301 their uid, for which killpg would return an EPERM error. */
2304 process_send_signal (process
, signo
, current_group
, nomsg
)
2305 Lisp_Object process
;
2307 Lisp_Object current_group
;
2311 register struct Lisp_Process
*p
;
2315 proc
= get_process (process
);
2316 p
= XPROCESS (proc
);
2318 if (!EQ (p
->childp
, Qt
))
2319 error ("Process %s is not a subprocess",
2320 XSTRING (p
->name
)->data
);
2321 if (!XFASTINT (p
->infd
))
2322 error ("Process %s is not active",
2323 XSTRING (p
->name
)->data
);
2325 if (NILP (p
->pty_flag
))
2326 current_group
= Qnil
;
2328 /* If we are using pgrps, get a pgrp number and make it negative. */
2329 if (!NILP (current_group
))
2331 #ifdef SIGNALS_VIA_CHARACTERS
2332 /* If possible, send signals to the entire pgrp
2333 by sending an input character to it. */
2335 /* TERMIOS is the latest and bestest, and seems most likely to
2336 work. If the system has it, use it. */
2343 tcgetattr (XFASTINT (p
->infd
), &t
);
2344 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2348 tcgetattr (XFASTINT (p
->infd
), &t
);
2349 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2353 tcgetattr (XFASTINT (p
->infd
), &t
);
2355 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2357 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2362 #else /* ! HAVE_TERMIOS */
2364 /* On Berkeley descendants, the following IOCTL's retrieve the
2365 current control characters. */
2366 #if defined (TIOCGLTC) && defined (TIOCGETC)
2374 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2375 send_process (proc
, &c
.t_intrc
, 1);
2378 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2379 send_process (proc
, &c
.t_quitc
, 1);
2383 ioctl (XFASTINT (p
->infd
), TIOCGLTC
, &lc
);
2384 send_process (proc
, &lc
.t_suspc
, 1);
2386 #endif /* ! defined (SIGTSTP) */
2389 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2391 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2398 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2399 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2402 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2403 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2407 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2408 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2410 #endif /* ! defined (SIGTSTP) */
2412 #else /* ! defined (TCGETA) */
2413 Your configuration files are messed up
.
2414 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2415 you'd better be using one of the alternatives above! */
2416 #endif /* ! defined (TCGETA) */
2417 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2418 #endif /* ! defined HAVE_TERMIOS */
2419 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2422 /* Get the pgrp using the tty itself, if we have that.
2423 Otherwise, use the pty to get the pgrp.
2424 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2425 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2426 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2427 His patch indicates that if TIOCGPGRP returns an error, then
2428 we should just assume that p->pid is also the process group id. */
2432 if (!NILP (p
->subtty
))
2433 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2435 err
= ioctl (XFASTINT (p
->infd
), TIOCGPGRP
, &gid
);
2439 gid
= - XFASTINT (p
->pid
);
2440 #endif /* ! defined (pfa) */
2446 #else /* ! defined (TIOCGPGRP ) */
2447 /* Can't select pgrps on this system, so we know that
2448 the child itself heads the pgrp. */
2449 gid
= - XFASTINT (p
->pid
);
2450 #endif /* ! defined (TIOCGPGRP ) */
2453 gid
= - XFASTINT (p
->pid
);
2459 p
->raw_status_low
= Qnil
;
2460 p
->raw_status_high
= Qnil
;
2462 XSETINT (p
->tick
, ++process_tick
);
2466 #endif /* ! defined (SIGCONT) */
2469 send_process (proc
, "\003", 1); /* ^C */
2474 send_process (proc
, "\031", 1); /* ^Y */
2479 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2482 flush_pending_output (XFASTINT (p
->infd
));
2486 /* If we don't have process groups, send the signal to the immediate
2487 subprocess. That isn't really right, but it's better than any
2488 obvious alternative. */
2491 kill (XFASTINT (p
->pid
), signo
);
2495 /* gid may be a pid, or minus a pgrp's number */
2497 if (!NILP (current_group
))
2498 ioctl (XFASTINT (p
->infd
), TIOCSIGSEND
, signo
);
2501 gid
= - XFASTINT (p
->pid
);
2504 #else /* ! defined (TIOCSIGSEND) */
2505 EMACS_KILLPG (-gid
, signo
);
2506 #endif /* ! defined (TIOCSIGSEND) */
2509 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2510 "Interrupt process PROCESS. May be process or name of one.\n\
2511 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2512 Nil or no arg means current buffer's process.\n\
2513 Second arg CURRENT-GROUP non-nil means send signal to\n\
2514 the current process-group of the process's controlling terminal\n\
2515 rather than to the process's own process group.\n\
2516 If the process is a shell, this means interrupt current subjob\n\
2517 rather than the shell.")
2518 (process
, current_group
)
2519 Lisp_Object process
, current_group
;
2521 process_send_signal (process
, SIGINT
, current_group
, 0);
2525 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2526 "Kill process PROCESS. May be process or name of one.\n\
2527 See function `interrupt-process' for more details on usage.")
2528 (process
, current_group
)
2529 Lisp_Object process
, current_group
;
2531 process_send_signal (process
, SIGKILL
, current_group
, 0);
2535 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2536 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2537 See function `interrupt-process' for more details on usage.")
2538 (process
, current_group
)
2539 Lisp_Object process
, current_group
;
2541 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2545 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2546 "Stop process PROCESS. May be process or name of one.\n\
2547 See function `interrupt-process' for more details on usage.")
2548 (process
, current_group
)
2549 Lisp_Object process
, current_group
;
2552 error ("no SIGTSTP support");
2554 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2559 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2560 "Continue process PROCESS. May be process or name of one.\n\
2561 See function `interrupt-process' for more details on usage.")
2562 (process
, current_group
)
2563 Lisp_Object process
, current_group
;
2566 process_send_signal (process
, SIGCONT
, current_group
, 0);
2568 error ("no SIGCONT support");
2573 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2574 2, 2, "nProcess number: \nnSignal code: ",
2575 "Send the process with number PID the signal with code CODE.\n\
2576 Both PID and CODE are integers.")
2578 Lisp_Object pid
, sig
;
2580 CHECK_NUMBER (pid
, 0);
2581 CHECK_NUMBER (sig
, 1);
2582 return make_number (kill (XINT (pid
), XINT (sig
)));
2585 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2586 "Make PROCESS see end-of-file in its input.\n\
2587 Eof comes after any text already sent to it.\n\
2588 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2589 nil, indicating the current buffer's process.")
2591 Lisp_Object process
;
2595 proc
= get_process (process
);
2596 /* Sending a zero-length record is supposed to mean eof
2597 when TIOCREMOTE is turned on. */
2601 write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, 0);
2603 #else /* did not do TOICREMOTE */
2605 send_process (proc
, "\032", 1); /* ^z */
2607 if (!NILP (XPROCESS (proc
)->pty_flag
))
2608 send_process (proc
, "\004", 1);
2611 close (XPROCESS (proc
)->outfd
);
2612 XFASTINT (XPROCESS (proc
)->outfd
) = open ("/dev/null", O_WRONLY
);
2615 #endif /* did not do TOICREMOTE */
2619 /* Kill all processes associated with `buffer'.
2620 If `buffer' is nil, kill all processes */
2622 kill_buffer_processes (buffer
)
2625 Lisp_Object tail
, proc
;
2627 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2628 tail
= XCONS (tail
)->cdr
)
2630 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2631 if (XGCTYPE (proc
) == Lisp_Process
2632 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2634 if (NETCONN_P (proc
))
2635 deactivate_process (proc
);
2636 else if (XFASTINT (XPROCESS (proc
)->infd
))
2637 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2642 /* On receipt of a signal that a child status has changed,
2643 loop asking about children with changed statuses until
2644 the system says there are no more.
2645 All we do is change the status;
2646 we do not run sentinels or print notifications.
2647 That is saved for the next time keyboard input is done,
2648 in order to avoid timing errors. */
2650 /** WARNING: this can be called during garbage collection.
2651 Therefore, it must not be fooled by the presence of mark bits in
2654 /** USG WARNING: Although it is not obvious from the documentation
2655 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2656 signal() before executing at least one wait(), otherwise the handler
2657 will be called again, resulting in an infinite loop. The relevant
2658 portion of the documentation reads "SIGCLD signals will be queued
2659 and the signal-catching function will be continually reentered until
2660 the queue is empty". Invoking signal() causes the kernel to reexamine
2661 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2664 sigchld_handler (signo
)
2667 int old_errno
= errno
;
2669 register struct Lisp_Process
*p
;
2670 extern EMACS_TIME
*input_available_clear_time
;
2674 sigheld
|= sigbit (SIGCHLD
);
2686 #endif /* no WUNTRACED */
2687 /* Keep trying to get a status until we get a definitive result. */
2691 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2693 while (pid
<= 0 && errno
== EINTR
);
2697 /* A real failure. We have done all our job, so return. */
2699 /* USG systems forget handlers when they are used;
2700 must reestablish each time */
2702 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2705 sigheld
&= ~sigbit (SIGCHLD
);
2713 #endif /* no WNOHANG */
2715 /* Find the process that signaled us, and record its status. */
2718 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2720 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2721 p
= XPROCESS (proc
);
2722 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2727 /* Look for an asynchronous process whose pid hasn't been filled
2730 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2732 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2733 p
= XPROCESS (proc
);
2734 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2739 /* Change the status of the process that was found. */
2742 union { int i
; WAITTYPE wt
; } u
;
2744 XSETINT (p
->tick
, ++process_tick
);
2746 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2747 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2749 /* If process has terminated, stop waiting for its output. */
2750 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2751 if (XFASTINT (p
->infd
))
2752 FD_CLR (XFASTINT (p
->infd
), &input_wait_mask
);
2754 /* Tell wait_reading_process_input that it needs to wake up and
2756 if (input_available_clear_time
)
2757 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2760 /* There was no asynchronous process found for that id. Check
2761 if we have a synchronous process. */
2764 synch_process_alive
= 0;
2766 /* Report the status of the synchronous process. */
2768 synch_process_retcode
= WRETCODE (w
);
2769 else if (WIFSIGNALED (w
))
2771 synch_process_death
= sys_siglist
[WTERMSIG (w
)];
2773 synch_process_death
= sys_errlist
[WTERMSIG (w
)];
2776 /* Tell wait_reading_process_input that it needs to wake up and
2778 if (input_available_clear_time
)
2779 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2782 /* On some systems, we must return right away.
2783 If any more processes want to signal us, we will
2785 Otherwise (on systems that have WNOHANG), loop around
2786 to use up all the processes that have something to tell us. */
2787 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2789 signal (signo
, sigchld_handler
);
2793 #endif /* USG, but not HPUX with WNOHANG */
2799 exec_sentinel_unwind (data
)
2802 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2807 exec_sentinel (proc
, reason
)
2808 Lisp_Object proc
, reason
;
2810 Lisp_Object sentinel
;
2811 register struct Lisp_Process
*p
= XPROCESS (proc
);
2812 int count
= specpdl_ptr
- specpdl
;
2814 sentinel
= p
->sentinel
;
2815 if (NILP (sentinel
))
2818 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2819 assure that it gets restored no matter how the sentinel exits. */
2821 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2822 /* Inhibit quit so that random quits don't screw up a running filter. */
2823 specbind (Qinhibit_quit
, Qt
);
2824 call2 (sentinel
, proc
, reason
);
2828 /* Report all recent events of a change in process status
2829 (either run the sentinel or output a message).
2830 This is done while Emacs is waiting for keyboard input. */
2834 register Lisp_Object proc
, buffer
;
2835 Lisp_Object tail
= Qnil
;
2836 Lisp_Object msg
= Qnil
;
2837 struct gcpro gcpro1
, gcpro2
;
2839 /* We need to gcpro tail; if read_process_output calls a filter
2840 which deletes a process and removes the cons to which tail points
2841 from Vprocess_alist, and then causes a GC, tail is an unprotected
2845 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2848 register struct Lisp_Process
*p
;
2850 proc
= Fcdr (Fcar (tail
));
2851 p
= XPROCESS (proc
);
2853 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2855 XSETINT (p
->update_tick
, XINT (p
->tick
));
2857 /* If process is still active, read any output that remains. */
2858 if (XFASTINT (p
->infd
))
2859 while (read_process_output (proc
, XFASTINT (p
->infd
)) > 0);
2863 /* Get the text to use for the message. */
2864 if (!NILP (p
->raw_status_low
))
2866 msg
= status_message (p
->status
);
2868 /* If process is terminated, deactivate it or delete it. */
2870 if (XTYPE (p
->status
) == Lisp_Cons
)
2871 symbol
= XCONS (p
->status
)->car
;
2873 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2874 || EQ (symbol
, Qclosed
))
2876 if (delete_exited_processes
)
2877 remove_process (proc
);
2879 deactivate_process (proc
);
2882 /* Now output the message suitably. */
2883 if (!NILP (p
->sentinel
))
2884 exec_sentinel (proc
, msg
);
2885 /* Don't bother with a message in the buffer
2886 when a process becomes runnable. */
2887 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2889 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2891 struct buffer
*old
= current_buffer
;
2894 /* Avoid error if buffer is deleted
2895 (probably that's why the process is dead, too) */
2896 if (NILP (XBUFFER (buffer
)->name
))
2898 Fset_buffer (buffer
);
2900 /* Insert new output into buffer
2901 at the current end-of-output marker,
2902 thus preserving logical ordering of input and output. */
2903 if (XMARKER (p
->mark
)->buffer
)
2904 SET_PT (marker_position (p
->mark
));
2907 if (point
<= opoint
)
2908 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2910 tem
= current_buffer
->read_only
;
2911 current_buffer
->read_only
= Qnil
;
2912 insert_string ("\nProcess ");
2913 Finsert (1, &p
->name
);
2914 insert_string (" ");
2916 current_buffer
->read_only
= tem
;
2917 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2920 set_buffer_internal (old
);
2925 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
2926 redisplay_preserve_echo_area ();
2928 update_tick
= process_tick
;
2939 if (! noninteractive
|| initialized
)
2941 signal (SIGCHLD
, sigchld_handler
);
2944 FD_ZERO (&input_wait_mask
);
2945 FD_SET (0, &input_wait_mask
);
2946 Vprocess_alist
= Qnil
;
2947 for (i
= 0; i
< MAXDESC
; i
++)
2949 chan_process
[i
] = Qnil
;
2950 proc_buffered_char
[i
] = -1;
2954 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 0, 1, 0,
2955 "Return the connection type of `PROCESS'. This can be nil (pipe),\n\
2956 t or pty (pty) or stream (socket connection).")
2958 Lisp_Object process
;
2960 return XPROCESS (process
)->type
;
2966 stream_process
= intern ("stream");
2968 Qprocessp
= intern ("processp");
2969 staticpro (&Qprocessp
);
2970 Qrun
= intern ("run");
2972 Qstop
= intern ("stop");
2974 Qsignal
= intern ("signal");
2975 staticpro (&Qsignal
);
2977 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
2980 Qexit = intern ("exit");
2981 staticpro (&Qexit); */
2983 Qopen
= intern ("open");
2985 Qclosed
= intern ("closed");
2986 staticpro (&Qclosed
);
2988 staticpro (&Vprocess_alist
);
2990 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
2991 "*Non-nil means delete processes immediately when they exit.\n\
2992 nil means don't delete them until `list-processes' is run.");
2994 delete_exited_processes
= 1;
2996 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
2997 "Control type of device used to communicate with subprocesses.\n\
2998 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
2999 pty's are not available, this variable will be ignored. The value takes\n\
3000 effect when `start-process' is called.");
3001 Vprocess_connection_type
= Qt
;
3003 defsubr (&Sprocessp
);
3004 defsubr (&Sget_process
);
3005 defsubr (&Sget_buffer_process
);
3006 defsubr (&Sdelete_process
);
3007 defsubr (&Sprocess_status
);
3008 defsubr (&Sprocess_exit_status
);
3009 defsubr (&Sprocess_id
);
3010 defsubr (&Sprocess_name
);
3011 defsubr (&Sprocess_command
);
3012 defsubr (&Sset_process_buffer
);
3013 defsubr (&Sprocess_buffer
);
3014 defsubr (&Sprocess_mark
);
3015 defsubr (&Sset_process_filter
);
3016 defsubr (&Sprocess_filter
);
3017 defsubr (&Sset_process_sentinel
);
3018 defsubr (&Sprocess_sentinel
);
3019 defsubr (&Sprocess_kill_without_query
);
3020 defsubr (&Slist_processes
);
3021 defsubr (&Sprocess_list
);
3022 defsubr (&Sstart_process
);
3024 defsubr (&Sopen_network_stream
);
3025 #endif /* HAVE_SOCKETS */
3026 defsubr (&Saccept_process_output
);
3027 defsubr (&Sprocess_send_region
);
3028 defsubr (&Sprocess_send_string
);
3029 defsubr (&Sinterrupt_process
);
3030 defsubr (&Skill_process
);
3031 defsubr (&Squit_process
);
3032 defsubr (&Sstop_process
);
3033 defsubr (&Scontinue_process
);
3034 defsubr (&Sprocess_send_eof
);
3035 defsubr (&Ssignal_process
);
3036 defsubr (&Swaiting_for_user_input_p
);
3037 /* defsubr (&Sprocess_connection); */
3041 #else /* not subprocesses */
3043 #include <sys/types.h>
3047 #include "systime.h"
3048 #include "termopts.h"
3050 extern int frame_garbaged
;
3053 /* As described above, except assuming that there are no subprocesses:
3055 Wait for timeout to elapse and/or keyboard input to be available.
3058 timeout in seconds, or
3059 zero for no limit, or
3060 -1 means gobble data immediately available but don't wait for any.
3062 read_kbd is a Lisp_Object:
3063 0 to ignore keyboard input, or
3064 1 to return when input is available, or
3065 -1 means caller will actually read the input, so don't throw to
3067 We know that read_kbd will never be a Lisp_Process, since
3068 `subprocesses' isn't defined.
3070 do_display != 0 means redisplay should be done to show subprocess
3071 output that arrives. This version of the function ignores it.
3073 Return true iff we recieved input from any process. */
3076 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3077 int time_limit
, microsecs
;
3078 Lisp_Object read_kbd
;
3081 EMACS_TIME end_time
, timeout
, *timeout_p
;
3084 /* What does time_limit really mean? */
3085 if (time_limit
|| microsecs
)
3087 /* It's not infinite. */
3088 timeout_p
= &timeout
;
3090 if (time_limit
== -1)
3091 /* In fact, it's zero. */
3092 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3094 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3096 /* How far in the future is that? */
3097 EMACS_GET_TIME (end_time
);
3098 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3101 /* It's infinite. */
3104 /* Turn off periodic alarms (in case they are in use)
3105 because the select emulator uses alarms. */
3112 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3114 /* If calling from keyboard input, do not quit
3115 since we want to return C-g as an input character.
3116 Otherwise, do pending quit if requested. */
3117 if (XINT (read_kbd
) >= 0)
3122 EMACS_GET_TIME (*timeout_p
);
3123 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3124 if (EMACS_TIME_NEG_P (*timeout_p
))
3128 /* Cause C-g and alarm signals to take immediate action,
3129 and cause input available signals to zero out timeout. */
3130 if (XINT (read_kbd
) < 0)
3131 set_waiting_for_input (&timeout
);
3133 /* If a frame has been newly mapped and needs updating,
3134 reprocess its display stuff. */
3136 redisplay_preserve_echo_area ();
3138 if (XINT (read_kbd
) && detect_input_pending ())
3141 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3143 /* Make C-g and alarm signals set flags again */
3144 clear_waiting_for_input ();
3146 /* If we woke up due to SIGWINCH, actually change size now. */
3147 do_pending_window_change ();
3151 /* If the system call was interrupted, then go around the
3157 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3158 /* System sometimes fails to deliver SIGIO. */
3159 kill (getpid (), SIGIO
);
3161 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3164 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3174 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3175 "Return the (or, a) process associated with BUFFER.\n\
3176 This copy of Emacs has not been built to support subprocesses, so this\n\
3177 function always returns nil.")
3179 register Lisp_Object name
;
3184 /* Kill all processes associated with `buffer'.
3185 If `buffer' is nil, kill all processes.
3186 Since we have no subprocesses, this does nothing. */
3188 kill_buffer_processes (buffer
)
3199 defsubr (&Sget_buffer_process
);
3203 #endif /* not subprocesses */