1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
25 /* This file is split into two parts by the following preprocessor
26 conditional. The 'then' clause contains all of the support for
27 asynchronous subprocesses. The 'else' clause contains stub
28 versions of some of the asynchronous subprocess routines that are
29 often called elsewhere in Emacs, so we don't have to #ifdef the
30 sections that call them. */
38 #include <sys/types.h> /* some typedefs are used in sys/file.h */
45 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
46 #include <sys/socket.h>
48 #include <netinet/in.h>
49 #include <arpa/inet.h>
50 #endif /* HAVE_SOCKETS */
52 /* TERM is a poor-man's SLIP, used on Linux. */
57 /* DGUX inet_addr returns a 'struct in_addr'. */
59 #define IN_ADDR struct in_addr
60 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
62 #define IN_ADDR unsigned long
63 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
66 #if defined(BSD) || defined(STRIDE)
67 #include <sys/ioctl.h>
68 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
70 #endif /* HAVE_PTYS and no O_NDELAY */
71 #endif /* BSD or STRIDE */
73 #ifdef BROKEN_O_NONBLOCK
75 #endif /* BROKEN_O_NONBLOCK */
82 #include <sys/sysmacros.h> /* for "minor" */
92 #include "termhooks.h"
97 Lisp_Object Qprocessp
;
98 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
99 /* Qexit is declared and initialized in eval.c. */
101 /* a process object is a network connection when its childp field is neither
102 Qt nor Qnil but is instead a string (name of foreign host we
103 are connected to + name of port we are connected to) */
106 static Lisp_Object stream_process
;
108 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
110 #define NETCONN_P(p) 0
111 #endif /* HAVE_SOCKETS */
113 /* Define first descriptor number available for subprocesses. */
115 #define FIRST_PROC_DESC 1
117 #define FIRST_PROC_DESC 3
120 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
123 #if !defined (SIGCHLD) && defined (SIGCLD)
124 #define SIGCHLD SIGCLD
127 #include "syssignal.h"
132 extern char *strerror ();
134 extern char *sys_errlist
[];
137 #ifndef SYS_SIGLIST_DECLARED
141 extern char *sys_siglist
[];
142 #endif /* not LINUX */
144 char *sys_siglist
[] =
150 "illegal instruction",
154 "floating point exception",
157 "segmentation violation",
158 "bad argument to system call",
159 "write on a pipe with no one to read it",
161 "software termination signal from kill",
163 "sendable stop signal not from tty",
164 "stop signal from tty",
165 "continue a stopped process",
166 "child status has changed",
167 "background read attempted from control tty",
168 "background write attempted from control tty",
169 "input record available at control tty",
170 "exceeded CPU time limit",
171 "exceeded file size limit"
175 #endif /* ! SYS_SIGLIST_DECLARED */
177 /* t means use pty, nil means use a pipe,
178 maybe other values to come. */
179 static Lisp_Object Vprocess_connection_type
;
183 #include <sys/socket.h>
187 /* Number of events of change of status of a process. */
188 static int process_tick
;
190 /* Number of events for which the user or sentinel has been notified. */
191 static int update_tick
;
194 /* We could get this from param.h, but better not to depend on finding that.
195 And better not to risk that it might define other symbols used in this
198 #define MAXDESC FD_SETSIZE
202 #define SELECT_TYPE fd_set
203 #else /* no FD_SET */
205 #define SELECT_TYPE int
207 /* Define the macros to access a single-int bitmap of descriptors. */
208 #define FD_SET(n, p) (*(p) |= (1 << (n)))
209 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
210 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
211 #define FD_ZERO(p) (*(p) = 0)
212 #endif /* no FD_SET */
214 /* Mask of bits indicating the descriptors that we wait for input on */
216 static SELECT_TYPE input_wait_mask
;
218 /* The largest descriptor currently in use for a process object. */
219 static int max_process_desc
;
221 /* Descriptor to use for keyboard input. */
222 static int keyboard_descriptor
;
224 /* Nonzero means delete a process right away if it exits. */
225 static int delete_exited_processes
;
227 /* Indexed by descriptor, gives the process (if any) for that descriptor */
228 Lisp_Object chan_process
[MAXDESC
];
230 /* Alist of elements (NAME . PROCESS) */
231 Lisp_Object Vprocess_alist
;
233 /* Buffered-ahead input char from process, indexed by channel.
234 -1 means empty (no char is buffered).
235 Used on sys V where the only way to tell if there is any
236 output from the process is to read at least one char.
237 Always -1 on systems that support FIONREAD. */
239 static int proc_buffered_char
[MAXDESC
];
241 static Lisp_Object
get_process ();
243 /* Maximum number of bytes to send to a pty without an eof. */
244 static int pty_max_bytes
;
246 /* Compute the Lisp form of the process status, p->status, from
247 the numeric status that was returned by `wait'. */
249 Lisp_Object
status_convert ();
252 struct Lisp_Process
*p
;
254 union { int i
; WAITTYPE wt
; } u
;
255 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
256 p
->status
= status_convert (u
.wt
);
257 p
->raw_status_low
= Qnil
;
258 p
->raw_status_high
= Qnil
;
261 /* Convert a process status word in Unix format to
262 the list that we use internally. */
269 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
270 else if (WIFEXITED (w
))
271 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
272 WCOREDUMP (w
) ? Qt
: Qnil
));
273 else if (WIFSIGNALED (w
))
274 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
275 WCOREDUMP (w
) ? Qt
: Qnil
));
280 /* Given a status-list, extract the three pieces of information
281 and store them individually through the three pointers. */
284 decode_status (l
, symbol
, code
, coredump
)
292 if (XTYPE (l
) == Lisp_Symbol
)
300 *symbol
= XCONS (l
)->car
;
301 tem
= XCONS (l
)->cdr
;
302 *code
= XFASTINT (XCONS (tem
)->car
);
303 tem
= XCONS (tem
)->cdr
;
304 *coredump
= !NILP (tem
);
308 /* Return a string describing a process status list. */
311 status_message (status
)
316 Lisp_Object string
, string2
;
318 decode_status (status
, &symbol
, &code
, &coredump
);
320 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
326 signame
= sys_siglist
[code
];
328 signame
= sys_errlist
[code
];
333 string
= build_string (signame
);
334 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
335 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
336 return concat2 (string
, string2
);
338 else if (EQ (symbol
, Qexit
))
341 return build_string ("finished\n");
342 string
= Fnumber_to_string (make_number (code
));
343 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
344 return concat2 (build_string ("exited abnormally with code "),
345 concat2 (string
, string2
));
348 return Fcopy_sequence (Fsymbol_name (symbol
));
353 /* Open an available pty, returning a file descriptor.
354 Return -1 on failure.
355 The file name of the terminal corresponding to the pty
356 is left in the variable pty_name. */
367 /* Some systems name their pseudoterminals so that there are gaps in
368 the usual sequence - for example, on HP9000/S700 systems, there
369 are no pseudoterminals with names ending in 'f'. So we wait for
370 three failures in a row before deciding that we've reached the
372 int failed_count
= 0;
377 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
378 for (i
= 0; i
< 16; i
++)
381 #ifdef PTY_NAME_SPRINTF
384 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
385 #endif /* no PTY_NAME_SPRINTF */
389 #else /* no PTY_OPEN */
391 /* Unusual IRIS code */
392 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
395 if (fstat (fd
, &stb
) < 0)
398 if (stat (pty_name
, &stb
) < 0)
401 if (failed_count
>= 3)
407 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
409 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
411 #endif /* not IRIS */
412 #endif /* no PTY_OPEN */
416 /* check to make certain that both sides are available
417 this avoids a nasty yet stupid bug in rlogins */
418 #ifdef PTY_TTY_NAME_SPRINTF
421 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
422 #endif /* no PTY_TTY_NAME_SPRINTF */
424 if (access (pty_name
, 6) != 0)
427 #if !defined(IRIS) && !defined(__sgi)
433 #endif /* not UNIPLUS */
440 #endif /* HAVE_PTYS */
446 register Lisp_Object val
, tem
, name1
;
447 register struct Lisp_Process
*p
;
451 /* size of process structure includes the vector header,
452 so deduct for that. But struct Lisp_Vector includes the first
453 element, thus deducts too much, so add it back. */
454 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
455 - sizeof (struct Lisp_Vector
)
456 + sizeof (Lisp_Object
))
457 / sizeof (Lisp_Object
)),
459 XSETTYPE (val
, Lisp_Process
);
462 XSET (p
->infd
, Lisp_Int
, -1);
463 XSET (p
->outfd
, Lisp_Int
, -1);
464 XFASTINT (p
->pid
) = 0;
465 XFASTINT (p
->tick
) = 0;
466 XFASTINT (p
->update_tick
) = 0;
467 p
->raw_status_low
= Qnil
;
468 p
->raw_status_high
= Qnil
;
470 p
->mark
= Fmake_marker ();
472 /* If name is already in use, modify it until it is unused. */
477 tem
= Fget_process (name1
);
478 if (NILP (tem
)) break;
479 sprintf (suffix
, "<%d>", i
);
480 name1
= concat2 (name
, build_string (suffix
));
484 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
488 remove_process (proc
)
489 register Lisp_Object proc
;
491 register Lisp_Object pair
;
493 pair
= Frassq (proc
, Vprocess_alist
);
494 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
495 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
497 deactivate_process (proc
);
500 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
501 "Return t if OBJECT is a process.")
505 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
508 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
509 "Return the process named NAME, or nil if there is none.")
511 register Lisp_Object name
;
513 if (XTYPE (name
) == Lisp_Process
)
515 CHECK_STRING (name
, 0);
516 return Fcdr (Fassoc (name
, Vprocess_alist
));
519 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
520 "Return the (or, a) process associated with BUFFER.\n\
521 BUFFER may be a buffer or the name of one.")
523 register Lisp_Object name
;
525 register Lisp_Object buf
, tail
, proc
;
527 if (NILP (name
)) return Qnil
;
528 buf
= Fget_buffer (name
);
529 if (NILP (buf
)) return Qnil
;
531 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
533 proc
= Fcdr (Fcar (tail
));
534 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
540 /* This is how commands for the user decode process arguments. It
541 accepts a process, a process name, a buffer, a buffer name, or nil.
542 Buffers denote the first process in the buffer, and nil denotes the
547 register Lisp_Object name
;
549 register Lisp_Object proc
, obj
;
552 obj
= Fget_process (name
);
554 obj
= Fget_buffer (name
);
556 error ("Process %s does not exist", XSTRING (name
)->data
);
558 else if (NILP (name
))
559 obj
= Fcurrent_buffer ();
563 /* Now obj should be either a buffer object or a process object.
567 proc
= Fget_buffer_process (obj
);
569 error ("Buffer %s has no process", XSTRING (XBUFFER (obj
)->name
)->data
);
573 CHECK_PROCESS (obj
, 0);
579 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
580 "Delete PROCESS: kill it and forget about it immediately.\n\
581 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
582 nil, indicating the current buffer's process.")
584 register Lisp_Object proc
;
586 proc
= get_process (proc
);
587 XPROCESS (proc
)->raw_status_low
= Qnil
;
588 XPROCESS (proc
)->raw_status_high
= Qnil
;
589 if (NETCONN_P (proc
))
591 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
592 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
594 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
596 Fkill_process (proc
, Qnil
);
597 /* Do this now, since remove_process will make sigchld_handler do nothing. */
598 XPROCESS (proc
)->status
599 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
600 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
603 remove_process (proc
);
607 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
608 "Return the status of PROCESS: a symbol, one of these:\n\
609 run -- for a process that is running.\n\
610 stop -- for a process stopped but continuable.\n\
611 exit -- for a process that has exited.\n\
612 signal -- for a process that has got a fatal signal.\n\
613 open -- for a network stream connection that is open.\n\
614 closed -- for a network stream connection that is closed.\n\
615 nil -- if arg is a process name and no such process exists.\n\
616 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
617 nil, indicating the current buffer's process.")
619 register Lisp_Object proc
;
621 register struct Lisp_Process
*p
;
622 register Lisp_Object status
;
623 proc
= get_process (proc
);
627 if (!NILP (p
->raw_status_low
))
630 if (XTYPE (status
) == Lisp_Cons
)
631 status
= XCONS (status
)->car
;
632 if (NETCONN_P (proc
))
634 if (EQ (status
, Qrun
))
636 else if (EQ (status
, Qexit
))
642 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
644 "Return the exit status of PROCESS or the signal number that killed it.\n\
645 If PROCESS has not yet exited or died, return 0.")
647 register Lisp_Object proc
;
649 CHECK_PROCESS (proc
, 0);
650 if (!NILP (XPROCESS (proc
)->raw_status_low
))
651 update_status (XPROCESS (proc
));
652 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
653 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
654 return make_number (0);
657 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
658 "Return the process id of PROCESS.\n\
659 This is the pid of the Unix process which PROCESS uses or talks to.\n\
660 For a network connection, this value is nil.")
662 register Lisp_Object proc
;
664 CHECK_PROCESS (proc
, 0);
665 return XPROCESS (proc
)->pid
;
668 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
669 "Return the name of PROCESS, as a string.\n\
670 This is the name of the program invoked in PROCESS,\n\
671 possibly modified to make it unique among process names.")
673 register Lisp_Object proc
;
675 CHECK_PROCESS (proc
, 0);
676 return XPROCESS (proc
)->name
;
679 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
680 "Return the command that was executed to start PROCESS.\n\
681 This is a list of strings, the first string being the program executed\n\
682 and the rest of the strings being the arguments given to it.\n\
683 For a non-child channel, this is nil.")
685 register Lisp_Object proc
;
687 CHECK_PROCESS (proc
, 0);
688 return XPROCESS (proc
)->command
;
691 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
693 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
695 register Lisp_Object proc
, buffer
;
697 CHECK_PROCESS (proc
, 0);
699 CHECK_BUFFER (buffer
, 1);
700 XPROCESS (proc
)->buffer
= buffer
;
704 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
706 "Return the buffer PROCESS is associated with.\n\
707 Output from PROCESS is inserted in this buffer\n\
708 unless PROCESS has a filter.")
710 register Lisp_Object proc
;
712 CHECK_PROCESS (proc
, 0);
713 return XPROCESS (proc
)->buffer
;
716 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
718 "Return the marker for the end of the last output from PROCESS.")
720 register Lisp_Object proc
;
722 CHECK_PROCESS (proc
, 0);
723 return XPROCESS (proc
)->mark
;
726 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
728 "Give PROCESS the filter function FILTER; nil means no filter.\n\
729 t means stop accepting output from the process.\n\
730 When a process has a filter, each time it does output\n\
731 the entire string of output is passed to the filter.\n\
732 The filter gets two arguments: the process and the string of output.\n\
733 If the process has a filter, its buffer is not used for output.")
735 register Lisp_Object proc
, filter
;
737 CHECK_PROCESS (proc
, 0);
739 FD_CLR (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
740 else if (EQ (XPROCESS (proc
)->filter
, Qt
))
741 FD_SET (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
742 XPROCESS (proc
)->filter
= filter
;
746 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
748 "Returns the filter function of PROCESS; nil if none.\n\
749 See `set-process-filter' for more info on filter functions.")
751 register Lisp_Object proc
;
753 CHECK_PROCESS (proc
, 0);
754 return XPROCESS (proc
)->filter
;
757 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
759 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
760 The sentinel is called as a function when the process changes state.\n\
761 It gets two arguments: the process, and a string describing the change.")
763 register Lisp_Object proc
, sentinel
;
765 CHECK_PROCESS (proc
, 0);
766 XPROCESS (proc
)->sentinel
= sentinel
;
770 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
772 "Return the sentinel of PROCESS; nil if none.\n\
773 See `set-process-sentinel' for more info on sentinels.")
775 register Lisp_Object proc
;
777 CHECK_PROCESS (proc
, 0);
778 return XPROCESS (proc
)->sentinel
;
781 DEFUN ("set-process-window-size", Fset_process_window_size
,
782 Sset_process_window_size
, 3, 3, 0,
783 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
784 (proc
, height
, width
)
785 register Lisp_Object proc
, height
, width
;
787 CHECK_PROCESS (proc
, 0);
788 CHECK_NATNUM (height
, 0);
789 CHECK_NATNUM (width
, 0);
790 if (set_window_size (XINT (XPROCESS (proc
)->infd
),
791 XINT (height
), XINT(width
)) <= 0)
797 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
798 Sprocess_kill_without_query
, 1, 2, 0,
799 "Say no query needed if PROCESS is running when Emacs is exited.\n\
800 Optional second argument if non-nil says to require a query.\n\
801 Value is t if a query was formerly required.")
803 register Lisp_Object proc
, value
;
807 CHECK_PROCESS (proc
, 0);
808 tem
= XPROCESS (proc
)->kill_without_query
;
809 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
814 #if 0 /* Turned off because we don't currently record this info
815 in the process. Perhaps add it. */
816 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
817 "Return the connection type of `PROCESS'.\n\
818 The value is `nil' for a pipe,\n\
819 `t' or `pty' for a pty, or `stream' for a socket connection.")
823 return XPROCESS (process
)->type
;
830 register Lisp_Object tail
, tem
;
831 Lisp_Object proc
, minspace
, tem1
;
832 register struct buffer
*old
= current_buffer
;
833 register struct Lisp_Process
*p
;
837 XFASTINT (minspace
) = 1;
839 set_buffer_internal (XBUFFER (Vstandard_output
));
840 Fbuffer_disable_undo (Vstandard_output
);
842 current_buffer
->truncate_lines
= Qt
;
845 Proc Status Buffer Command\n\
846 ---- ------ ------ -------\n", -1);
848 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
852 proc
= Fcdr (Fcar (tail
));
854 if (NILP (p
->childp
))
857 Finsert (1, &p
->name
);
858 Findent_to (make_number (13), minspace
);
860 if (!NILP (p
->raw_status_low
))
863 if (XTYPE (p
->status
) == Lisp_Cons
)
864 symbol
= XCONS (p
->status
)->car
;
867 if (EQ (symbol
, Qsignal
))
870 tem
= Fcar (Fcdr (p
->status
));
872 if (XINT (tem
) < NSIG
)
873 write_string (sys_errlist
[XINT (tem
)], -1);
876 Fprinc (symbol
, Qnil
);
878 else if (NETCONN_P (proc
))
880 if (EQ (symbol
, Qrun
))
881 write_string ("open", -1);
882 else if (EQ (symbol
, Qexit
))
883 write_string ("closed", -1);
885 Fprinc (symbol
, Qnil
);
888 Fprinc (symbol
, Qnil
);
890 if (EQ (symbol
, Qexit
))
893 tem
= Fcar (Fcdr (p
->status
));
896 sprintf (tembuf
, " %d", XFASTINT (tem
));
897 write_string (tembuf
, -1);
901 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
902 remove_process (proc
);
904 Findent_to (make_number (22), minspace
);
905 if (NILP (p
->buffer
))
906 insert_string ("(none)");
907 else if (NILP (XBUFFER (p
->buffer
)->name
))
908 insert_string ("(Killed)");
910 Finsert (1, &XBUFFER (p
->buffer
)->name
);
912 Findent_to (make_number (37), minspace
);
914 if (NETCONN_P (proc
))
916 sprintf (tembuf
, "(network stream connection to %s)\n",
917 XSTRING (p
->childp
)->data
);
918 insert_string (tembuf
);
932 insert_string ("\n");
938 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
939 "Display a list of all processes.\n\
940 \(Any processes listed as Exited or Signaled are actually eliminated\n\
941 after the listing is made.)")
944 internal_with_output_to_temp_buffer ("*Process List*",
945 list_processes_1
, Qnil
);
949 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
950 "Return a list of all processes.")
953 return Fmapcar (Qcdr
, Vprocess_alist
);
956 /* Starting asynchronous inferior processes. */
958 static Lisp_Object
start_process_unwind ();
960 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
961 "Start a program in a subprocess. Return the process object for it.\n\
962 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
963 NAME is name for process. It is modified if necessary to make it unique.\n\
964 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
965 Process output goes at end of that buffer, unless you specify\n\
966 an output stream or filter function to handle the output.\n\
967 BUFFER may be also nil, meaning that this process is not associated\n\
969 Third arg is program file name. It is searched for as in the shell.\n\
970 Remaining arguments are strings to give program as arguments.")
973 register Lisp_Object
*args
;
975 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
977 register unsigned char *new_argv
;
980 register unsigned char **new_argv
;
983 int count
= specpdl_ptr
- specpdl
;
987 buffer
= Fget_buffer_create (buffer
);
989 /* Make sure that the child will be able to chdir to the current
990 buffer's current directory, or its unhandled equivalent. We
991 can't just have the child check for an error when it does the
992 chdir, since it's in a vfork.
994 We have to GCPRO around this because Fexpand_file_name and
995 Funhandled_file_name_directory might call a file name handling
996 function. The argument list is protected by the caller, so all
997 we really have to worry about is buffer. */
999 struct gcpro gcpro1
, gcpro2
;
1001 current_dir
= current_buffer
->directory
;
1003 GCPRO2 (buffer
, current_dir
);
1006 expand_and_dir_to_file
1007 (Funhandled_file_name_directory (current_dir
), Qnil
);
1008 if (NILP (Ffile_accessible_directory_p (current_dir
)))
1009 report_file_error ("Setting current directory",
1010 Fcons (current_buffer
->directory
, Qnil
));
1016 CHECK_STRING (name
, 0);
1020 CHECK_STRING (program
, 2);
1023 /* Make a one member argv with all args concatenated
1024 together separated by a blank. */
1025 len
= XSTRING (program
)->size
+ 2;
1026 for (i
= 3; i
< nargs
; i
++)
1029 CHECK_STRING (tem
, i
);
1030 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1032 new_argv
= (unsigned char *) alloca (len
);
1033 strcpy (new_argv
, XSTRING (program
)->data
);
1034 for (i
= 3; i
< nargs
; i
++)
1037 CHECK_STRING (tem
, i
);
1038 strcat (new_argv
, " ");
1039 strcat (new_argv
, XSTRING (tem
)->data
);
1041 /* Need to add code here to check for program existence on VMS */
1044 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1046 /* If program file name is not absolute, search our path for it */
1047 if (XSTRING (program
)->data
[0] != '/')
1049 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1052 GCPRO4 (name
, program
, buffer
, current_dir
);
1053 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1056 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1057 new_argv
[0] = XSTRING (tem
)->data
;
1060 new_argv
[0] = XSTRING (program
)->data
;
1062 for (i
= 3; i
< nargs
; i
++)
1065 CHECK_STRING (tem
, i
);
1066 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1068 new_argv
[i
- 2] = 0;
1069 #endif /* not VMS */
1071 proc
= make_process (name
);
1072 /* If an error occurs and we can't start the process, we want to
1073 remove it from the process list. This means that each error
1074 check in create_process doesn't need to call remove_process
1075 itself; it's all taken care of here. */
1076 record_unwind_protect (start_process_unwind
, proc
);
1078 XPROCESS (proc
)->childp
= Qt
;
1079 XPROCESS (proc
)->command_channel_p
= Qnil
;
1080 XPROCESS (proc
)->buffer
= buffer
;
1081 XPROCESS (proc
)->sentinel
= Qnil
;
1082 XPROCESS (proc
)->filter
= Qnil
;
1083 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1085 create_process (proc
, new_argv
, current_dir
);
1087 return unbind_to (count
, proc
);
1090 /* This function is the unwind_protect form for Fstart_process. If
1091 PROC doesn't have its pid set, then we know someone has signalled
1092 an error and the process wasn't started successfully, so we should
1093 remove it from the process list. */
1095 start_process_unwind (proc
)
1098 if (XTYPE (proc
) != Lisp_Process
)
1101 /* Was PROC started successfully? */
1102 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1103 remove_process (proc
);
1110 create_process_1 (signo
)
1114 /* USG systems forget handlers when they are used;
1115 must reestablish each time */
1116 signal (signo
, create_process_1
);
1120 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1123 /* Mimic blocking of signals on system V, which doesn't really have it. */
1125 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1126 int sigchld_deferred
;
1129 create_process_sigchld ()
1131 signal (SIGCHLD
, create_process_sigchld
);
1133 sigchld_deferred
= 1;
1139 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1140 create_process (process
, new_argv
, current_dir
)
1141 Lisp_Object process
;
1143 Lisp_Object current_dir
;
1145 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1148 SIGTYPE (*sigchld
)();
1151 extern char **environ
;
1153 inchannel
= outchannel
= -1;
1156 if (EQ (Vprocess_connection_type
, Qt
))
1157 outchannel
= inchannel
= allocate_pty ();
1162 /* On USG systems it does not work to open the pty's tty here
1163 and then close and reopen it in the child. */
1165 /* Don't let this terminal become our controlling terminal
1166 (in case we don't have one). */
1167 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1169 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1172 report_file_error ("Opening pty", Qnil
);
1174 forkin
= forkout
= -1;
1175 #endif /* not USG */
1179 #endif /* HAVE_PTYS */
1182 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1183 report_file_error ("Opening socketpair", Qnil
);
1184 outchannel
= inchannel
= sv
[0];
1185 forkout
= forkin
= sv
[1];
1187 #else /* not SKTPAIR */
1196 #endif /* not SKTPAIR */
1199 /* Replaced by close_process_descs */
1200 set_exclusive_use (inchannel
);
1201 set_exclusive_use (outchannel
);
1204 /* Stride people say it's a mystery why this is needed
1205 as well as the O_NDELAY, but that it fails without this. */
1206 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1209 ioctl (inchannel
, FIONBIO
, &one
);
1214 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1217 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1221 /* Record this as an active process, with its channels.
1222 As a result, child_setup will close Emacs's side of the pipes. */
1223 chan_process
[inchannel
] = process
;
1224 XSET (XPROCESS (process
)->infd
, Lisp_Int
, inchannel
);
1225 XSET (XPROCESS (process
)->outfd
, Lisp_Int
, outchannel
);
1226 /* Record the tty descriptor used in the subprocess. */
1228 XPROCESS (process
)->subtty
= Qnil
;
1230 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1231 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1232 XPROCESS (process
)->status
= Qrun
;
1234 /* Delay interrupts until we have a chance to store
1235 the new fork's pid in its process structure */
1239 #else /* not BSD4_1 */
1240 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1241 sigsetmask (sigmask (SIGCHLD
));
1242 #else /* ordinary USG */
1244 sigchld_deferred
= 0;
1245 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1247 #endif /* ordinary USG */
1248 #endif /* not BSD4_1 */
1249 #endif /* SIGCHLD */
1251 /* Until we store the proper pid, enable sigchld_handler
1252 to recognize an unknown pid as standing for this process.
1253 It is very important not to let this `marker' value stay
1254 in the table after this function has returned; if it does
1255 it might cause call-process to hang and subsequent asynchronous
1256 processes to get their return values scrambled. */
1257 XSETINT (XPROCESS (process
)->pid
, -1);
1260 /* child_setup must clobber environ on systems with true vfork.
1261 Protect it from permanent change. */
1262 char **save_environ
= environ
;
1267 int xforkin
= forkin
;
1268 int xforkout
= forkout
;
1270 #if 0 /* This was probably a mistake--it duplicates code later on,
1271 but fails to handle all the cases. */
1272 /* Make sure SIGCHLD is not blocked in the child. */
1273 sigsetmask (SIGEMPTYMASK
);
1276 /* Make the pty be the controlling terminal of the process. */
1278 /* First, disconnect its current controlling terminal. */
1280 /* Make the pty's terminal the controlling terminal. */
1285 /* We ignore the return value
1286 because faith@cs.unc.edu says that is necessary on Linux. */
1287 ioctl (xforkin
, TIOCSCTTY
, 0);
1290 #else /* not HAVE_SETSID */
1292 /* It's very important to call setpgrp here and no time
1293 afterwards. Otherwise, we lose our controlling tty which
1294 is set when we open the pty. */
1297 #endif /* not HAVE_SETSID */
1298 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1299 if (pty_flag
&& xforkin
>= 0)
1302 tcgetattr (xforkin
, &t
);
1304 if (tcsetattr (xforkin
, TCSANOW
, &t
) < 0)
1305 write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1308 #if defined (NTTYDISC) && defined (TIOCSETD)
1309 if (pty_flag
&& xforkin
>= 0)
1311 /* Use new line discipline. */
1312 int ldisc
= NTTYDISC
;
1313 if (ioctl (xforkin
, TIOCSETD
, &ldisc
) < 0)
1314 write (1, "create_process/TIOCSETD failed\n", 31);
1319 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1320 can do TIOCSPGRP only to the process's controlling tty. */
1323 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1324 I can't test it since I don't have 4.3. */
1325 int j
= open ("/dev/tty", O_RDWR
, 0);
1326 ioctl (j
, TIOCNOTTY
, 0);
1329 /* In order to get a controlling terminal on some versions
1330 of BSD, it is necessary to put the process in pgrp 0
1331 before it opens the terminal. */
1335 #endif /* TIOCNOTTY */
1337 #if !defined (RTU) && !defined (UNIPLUS)
1338 /*** There is a suggestion that this ought to be a
1339 conditional on TIOCSPGRP. */
1340 /* Now close the pty (if we had it open) and reopen it.
1341 This makes the pty the controlling terminal of the subprocess. */
1344 #ifdef SET_CHILD_PTY_PGRP
1345 int pgrp
= getpid ();
1348 /* I wonder if close (open (pty_name, ...)) would work? */
1351 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1353 #ifdef SET_CHILD_PTY_PGRP
1354 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1355 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1361 #endif /* not UNIPLUS and not RTU */
1362 #ifdef SETUP_SLAVE_PTY
1367 #endif /* SETUP_SLAVE_PTY */
1369 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1370 Now reenable it in the child, so it will die when we want it to. */
1372 signal (SIGHUP
, SIG_DFL
);
1374 #endif /* HAVE_PTYS */
1379 #else /* not BSD4_1 */
1380 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1381 sigsetmask (SIGEMPTYMASK
);
1382 #else /* ordinary USG */
1384 signal (SIGCHLD
, sigchld
);
1386 #endif /* ordinary USG */
1387 #endif /* not BSD4_1 */
1388 #endif /* SIGCHLD */
1391 child_setup_tty (xforkout
);
1392 child_setup (xforkin
, xforkout
, xforkout
,
1393 new_argv
, 1, current_dir
);
1395 environ
= save_environ
;
1402 if (forkin
!= forkout
&& forkout
>= 0)
1404 report_file_error ("Doing vfork", Qnil
);
1407 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1409 FD_SET (inchannel
, &input_wait_mask
);
1410 if (inchannel
> max_process_desc
)
1411 max_process_desc
= inchannel
;
1413 /* If the subfork execv fails, and it exits,
1414 this close hangs. I don't know why.
1415 So have an interrupt jar it loose. */
1417 signal (SIGALRM
, create_process_1
);
1419 XPROCESS (process
)->subtty
= Qnil
;
1424 if (forkin
!= forkout
&& forkout
>= 0)
1430 #else /* not BSD4_1 */
1431 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1432 sigsetmask (SIGEMPTYMASK
);
1433 #else /* ordinary USG */
1435 signal (SIGCHLD
, sigchld
);
1436 /* Now really handle any of these signals
1437 that came in during this function. */
1438 if (sigchld_deferred
)
1439 kill (getpid (), SIGCHLD
);
1441 #endif /* ordinary USG */
1442 #endif /* not BSD4_1 */
1443 #endif /* SIGCHLD */
1445 #endif /* not VMS */
1449 /* open a TCP network connection to a given HOST/SERVICE. Treated
1450 exactly like a normal process when reading and writing. Only
1451 differences are in status display and process deletion. A network
1452 connection has no PID; you cannot signal it. All you can do is
1453 deactivate and close it via delete-process */
1455 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1457 "Open a TCP connection for a service to a host.\n\
1458 Returns a subprocess-object to represent the connection.\n\
1459 Input and output work as for subprocesses; `delete-process' closes it.\n\
1460 Args are NAME BUFFER HOST SERVICE.\n\
1461 NAME is name for process. It is modified if necessary to make it unique.\n\
1462 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1463 Process output goes at end of that buffer, unless you specify\n\
1464 an output stream or filter function to handle the output.\n\
1465 BUFFER may be also nil, meaning that this process is not associated\n\
1467 Third arg is name of the host to connect to, or its IP address.\n\
1468 Fourth arg SERVICE is name of the service desired, or an integer\n\
1469 specifying a port number to connect to.")
1470 (name
, buffer
, host
, service
)
1471 Lisp_Object name
, buffer
, host
, service
;
1475 struct sockaddr_in address
;
1476 struct servent
*svc_info
;
1477 struct hostent
*host_info_ptr
, host_info
;
1478 char *(addr_list
[2]);
1479 IN_ADDR numeric_addr
;
1483 struct hostent host_info_fixed
;
1484 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1486 GCPRO4 (name
, buffer
, host
, service
);
1487 CHECK_STRING (name
, 0);
1488 CHECK_STRING (host
, 0);
1489 if (XTYPE(service
) == Lisp_Int
)
1490 port
= htons ((unsigned short) XINT (service
));
1493 CHECK_STRING (service
, 0);
1494 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1496 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1497 port
= svc_info
->s_port
;
1501 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1502 if (host_info_ptr
== 0)
1503 /* Attempt to interpret host as numeric inet address */
1505 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1506 if (NUMERIC_ADDR_ERROR
)
1507 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1509 host_info_ptr
= &host_info
;
1510 host_info
.h_name
= 0;
1511 host_info
.h_aliases
= 0;
1512 host_info
.h_addrtype
= AF_INET
;
1514 /* Older machines have only one address slot called h_addr.
1515 Newer machines have h_addr_list, but #define h_addr to
1516 be its first element. */
1517 host_info
.h_addr_list
= &(addr_list
[0]);
1519 host_info
.h_addr
= (char*)(&numeric_addr
);
1521 host_info
.h_length
= strlen (addr_list
[0]);
1524 bzero (&address
, sizeof address
);
1525 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1526 host_info_ptr
->h_length
);
1527 address
.sin_family
= host_info_ptr
->h_addrtype
;
1528 address
.sin_port
= port
;
1530 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1532 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1534 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1535 when connect is interrupted. So let's not let it get interrupted.
1536 Note we do not turn off polling, because polling is only used
1537 when not interrupt_input, and thus not normally used on the systems
1538 which have this bug. On systems which use polling, there's no way
1539 to quit if polling is turned off. */
1540 if (interrupt_input
)
1544 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1551 if (interrupt_input
)
1555 report_file_error ("connection failed",
1556 Fcons (host
, Fcons (name
, Qnil
)));
1559 if (interrupt_input
)
1563 s
= connect_server (0);
1565 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1566 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1567 send_command (s
, C_DUMB
, 1, 0);
1573 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1576 buffer
= Fget_buffer_create (buffer
);
1577 proc
= make_process (name
);
1579 chan_process
[inch
] = proc
;
1582 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1585 fcntl (inch
, F_SETFL
, O_NDELAY
);
1589 XPROCESS (proc
)->childp
= host
;
1590 XPROCESS (proc
)->command_channel_p
= Qnil
;
1591 XPROCESS (proc
)->buffer
= buffer
;
1592 XPROCESS (proc
)->sentinel
= Qnil
;
1593 XPROCESS (proc
)->filter
= Qnil
;
1594 XPROCESS (proc
)->command
= Qnil
;
1595 XPROCESS (proc
)->pid
= Qnil
;
1596 XSET (XPROCESS (proc
)->infd
, Lisp_Int
, s
);
1597 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, outch
);
1598 XPROCESS (proc
)->status
= Qrun
;
1599 FD_SET (inch
, &input_wait_mask
);
1600 if (inch
> max_process_desc
)
1601 max_process_desc
= inch
;
1606 #endif /* HAVE_SOCKETS */
1608 deactivate_process (proc
)
1611 register int inchannel
, outchannel
;
1612 register struct Lisp_Process
*p
= XPROCESS (proc
);
1614 inchannel
= XINT (p
->infd
);
1615 outchannel
= XINT (p
->outfd
);
1619 /* Beware SIGCHLD hereabouts. */
1620 flush_pending_output (inchannel
);
1623 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1624 sys$
dassgn (outchannel
);
1625 vs
= get_vms_process_pointer (p
->pid
);
1627 give_back_vms_process_stuff (vs
);
1631 if (outchannel
>= 0 && outchannel
!= inchannel
)
1635 XSET (p
->infd
, Lisp_Int
, -1);
1636 XSET (p
->outfd
, Lisp_Int
, -1);
1637 chan_process
[inchannel
] = Qnil
;
1638 FD_CLR (inchannel
, &input_wait_mask
);
1639 if (inchannel
== max_process_desc
)
1642 /* We just closed the highest-numbered process input descriptor,
1643 so recompute the highest-numbered one now. */
1644 max_process_desc
= 0;
1645 for (i
= 0; i
< MAXDESC
; i
++)
1646 if (!NILP (chan_process
[i
]))
1647 max_process_desc
= i
;
1652 /* Close all descriptors currently in use for communication
1653 with subprocess. This is used in a newly-forked subprocess
1654 to get rid of irrelevant descriptors. */
1656 close_process_descs ()
1659 for (i
= 0; i
< MAXDESC
; i
++)
1661 Lisp_Object process
;
1662 process
= chan_process
[i
];
1663 if (!NILP (process
))
1665 int in
= XINT (XPROCESS (process
)->infd
);
1666 int out
= XINT (XPROCESS (process
)->outfd
);
1669 if (out
>= 0 && in
!= out
)
1675 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1677 "Allow any pending output from subprocesses to be read by Emacs.\n\
1678 It is read into the process' buffers or given to their filter functions.\n\
1679 Non-nil arg PROCESS means do not return until some output has been received\n\
1681 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1682 seconds and microseconds to wait; return after that much time whether\n\
1683 or not there is input.\n\
1684 Return non-nil iff we received any output before the timeout expired.")
1685 (proc
, timeout
, timeout_msecs
)
1686 register Lisp_Object proc
, timeout
, timeout_msecs
;
1691 if (! NILP (timeout_msecs
))
1693 CHECK_NUMBER (timeout_msecs
, 2);
1694 useconds
= XINT (timeout_msecs
);
1695 if (XTYPE (timeout
) != Lisp_Int
)
1696 XSET (timeout
, Lisp_Int
, 0);
1699 int carry
= useconds
/ 1000000;
1701 XSETINT (timeout
, XINT (timeout
) + carry
);
1702 useconds
-= carry
* 1000000;
1704 /* I think this clause is necessary because C doesn't
1705 guarantee a particular rounding direction for negative
1709 XSETINT (timeout
, XINT (timeout
) - 1);
1710 useconds
+= 1000000;
1717 if (! NILP (timeout
))
1719 CHECK_NUMBER (timeout
, 1);
1720 seconds
= XINT (timeout
);
1733 XFASTINT (proc
) = 0;
1736 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1740 /* This variable is different from waiting_for_input in keyboard.c.
1741 It is used to communicate to a lisp process-filter/sentinel (via the
1742 function Fwaiting_for_user_input_p below) whether emacs was waiting
1743 for user-input when that process-filter was called.
1744 waiting_for_input cannot be used as that is by definition 0 when
1745 lisp code is being evalled */
1746 static int waiting_for_user_input_p
;
1748 /* Read and dispose of subprocess output while waiting for timeout to
1749 elapse and/or keyboard input to be available.
1752 timeout in seconds, or
1753 zero for no limit, or
1754 -1 means gobble data immediately available but don't wait for any.
1757 an additional duration to wait, measured in microseconds.
1758 If this is nonzero and time_limit is 0, then the timeout
1759 consists of MICROSECS only.
1761 READ_KBD is a lisp value:
1762 0 to ignore keyboard input, or
1763 1 to return when input is available, or
1764 -1 meaning caller will actually read the input, so don't throw to
1765 the quit handler, or
1766 a cons cell, meaning wait until its car is non-nil
1767 (and gobble terminal input into the buffer if any arrives), or
1768 a process object, meaning wait until something arrives from that
1769 process. The return value is true iff we read some input from
1772 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1773 output that arrives.
1775 If READ_KBD is a pointer to a struct Lisp_Process, then the
1776 function returns true iff we received input from that process
1777 before the timeout elapsed.
1778 Otherwise, return true iff we received input from any process. */
1780 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1781 int time_limit
, microsecs
;
1782 Lisp_Object read_kbd
;
1785 register int channel
, nfds
, m
;
1786 static SELECT_TYPE Available
;
1789 EMACS_TIME timeout
, end_time
, garbage
;
1791 int wait_channel
= -1;
1792 struct Lisp_Process
*wait_proc
= 0;
1793 int got_some_input
= 0;
1794 Lisp_Object
*wait_for_cell
= 0;
1796 FD_ZERO (&Available
);
1798 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1800 if (XTYPE (read_kbd
) == Lisp_Process
)
1802 wait_proc
= XPROCESS (read_kbd
);
1803 wait_channel
= XINT (wait_proc
->infd
);
1804 XFASTINT (read_kbd
) = 0;
1807 /* If waiting for non-nil in a cell, record where. */
1808 if (XTYPE (read_kbd
) == Lisp_Cons
)
1810 wait_for_cell
= &XCONS (read_kbd
)->car
;
1811 XFASTINT (read_kbd
) = 0;
1814 waiting_for_user_input_p
= XINT (read_kbd
);
1816 /* Since we may need to wait several times,
1817 compute the absolute time to return at. */
1818 if (time_limit
|| microsecs
)
1820 EMACS_GET_TIME (end_time
);
1821 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1822 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1825 /* It would not be safe to call this below,
1826 where we call redisplay_preserve_echo_area. */
1827 prepare_menu_bars ();
1831 /* If calling from keyboard input, do not quit
1832 since we want to return C-g as an input character.
1833 Otherwise, do pending quit if requested. */
1834 if (XINT (read_kbd
) >= 0)
1837 /* Exit now if the cell we're waiting for became non-nil. */
1838 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1841 /* Compute time from now till when time limit is up */
1842 /* Exit if already run out */
1843 if (time_limit
== -1)
1845 /* -1 specified for timeout means
1846 gobble output available now
1847 but don't wait at all. */
1849 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1851 else if (time_limit
|| microsecs
)
1853 EMACS_GET_TIME (timeout
);
1854 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1855 if (EMACS_TIME_NEG_P (timeout
))
1860 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1863 /* Cause C-g and alarm signals to take immediate action,
1864 and cause input available signals to zero out timeout.
1866 It is important that we do this before checking for process
1867 activity. If we get a SIGCHLD after the explicit checks for
1868 process activity, timeout is the only way we will know. */
1869 if (XINT (read_kbd
) < 0)
1870 set_waiting_for_input (&timeout
);
1872 /* If status of something has changed, and no input is
1873 available, notify the user of the change right away. After
1874 this explicit check, we'll let the SIGCHLD handler zap
1875 timeout to get our attention. */
1876 if (update_tick
!= process_tick
&& do_display
)
1878 Atemp
= input_wait_mask
;
1879 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1880 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1882 /* It's okay for us to do this and then continue with
1883 the loop, since timeout has already been zeroed out. */
1884 clear_waiting_for_input ();
1889 /* Don't wait for output from a non-running process. */
1890 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1891 update_status (wait_proc
);
1893 && ! EQ (wait_proc
->status
, Qrun
))
1895 clear_waiting_for_input ();
1899 /* Wait till there is something to do */
1901 Available
= input_wait_mask
;
1902 /* We used to have && wait_for_cell == 0
1903 but that led to lossage handling selection_request events:
1904 within one, we would start to handle another. */
1905 if (! XINT (read_kbd
))
1906 FD_CLR (keyboard_descriptor
, &Available
);
1908 /* If frame size has changed or the window is newly mapped,
1909 redisplay now, before we start to wait. There is a race
1910 condition here; if a SIGIO arrives between now and the select
1911 and indicates that a frame is trashed, the select may block
1912 displaying a trashed screen. */
1913 if (frame_garbaged
&& do_display
)
1914 redisplay_preserve_echo_area ();
1916 if (XINT (read_kbd
) && detect_input_pending ())
1919 FD_ZERO (&Available
);
1922 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1926 /* Make C-g and alarm signals set flags again */
1927 clear_waiting_for_input ();
1929 /* If we woke up due to SIGWINCH, actually change size now. */
1930 do_pending_window_change ();
1932 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1936 if (xerrno
== EINTR
)
1937 FD_ZERO (&Available
);
1939 /* Ultrix select seems to return ENOMEM when it is
1940 interrupted. Treat it just like EINTR. Bleah. Note
1941 that we want to test for the "ultrix" CPP symbol, not
1942 "__ultrix__"; the latter is only defined under GCC, but
1943 not by DEC's bundled CC. -JimB */
1944 else if (xerrno
== ENOMEM
)
1945 FD_ZERO (&Available
);
1948 /* This happens for no known reason on ALLIANT.
1949 I am guessing that this is the right response. -- RMS. */
1950 else if (xerrno
== EFAULT
)
1951 FD_ZERO (&Available
);
1953 else if (xerrno
== EBADF
)
1956 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1957 the child's closure of the pts gives the parent a SIGHUP, and
1958 the ptc file descriptor is automatically closed,
1959 yielding EBADF here or at select() call above.
1960 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1961 in m/ibmrt-aix.h), and here we just ignore the select error.
1962 Cleanup occurs c/o status_notify after SIGCLD. */
1963 FD_ZERO (&Available
); /* Cannot depend on values returned */
1969 error("select error: %s", strerror (xerrno
));
1971 #if defined(sun) && !defined(USG5_4)
1972 else if (nfds
> 0 && FD_ISSET (keyboard_descriptor
, &Available
)
1974 /* System sometimes fails to deliver SIGIO.
1976 David J. Mackenzie says that Emacs doesn't compile under
1977 Solaris if this code is enabled, thus the USG5_4 in the CPP
1978 conditional. "I haven't noticed any ill effects so far.
1979 If you find a Solaris expert somewhere, they might know
1981 kill (getpid (), SIGIO
);
1984 /* Check for keyboard input */
1985 /* If there is any, return immediately
1986 to give it higher priority than subprocesses */
1988 /* We used to do this if wait_for_cell,
1989 but that caused infinite recursion in selection request events. */
1990 if ((XINT (read_kbd
))
1991 && detect_input_pending ())
1994 if (detect_input_pending ())
1998 /* Exit now if the cell we're waiting for became non-nil. */
1999 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
2003 /* If we think we have keyboard input waiting, but didn't get SIGIO
2004 go read it. This can happen with X on BSD after logging out.
2005 In that case, there really is no input and no SIGIO,
2006 but select says there is input. */
2008 if (XINT (read_kbd
) && interrupt_input
2009 && (FD_ISSET (keyboard_descriptor
, &Available
)))
2014 got_some_input
|= nfds
> 0;
2016 /* If checking input just got us a size-change event from X,
2017 obey it now if we should. */
2018 if (XINT (read_kbd
) || wait_for_cell
)
2019 do_pending_window_change ();
2021 /* Check for data from a process. */
2022 /* Really FIRST_PROC_DESC should be 0 on Unix,
2023 but this is safer in the short run. */
2024 for (channel
= keyboard_descriptor
== 0 ? FIRST_PROC_DESC
: 0;
2025 channel
<= max_process_desc
; channel
++)
2027 if (FD_ISSET (channel
, &Available
))
2031 /* If waiting for this channel, arrange to return as
2032 soon as no more input to be processed. No more
2034 if (wait_channel
== channel
)
2040 proc
= chan_process
[channel
];
2044 /* Read data from the process, starting with our
2045 buffered-ahead character if we have one. */
2047 nread
= read_process_output (proc
, channel
);
2050 /* Since read_process_output can run a filter,
2051 which can call accept-process-output,
2052 don't try to read from any other processes
2053 before doing the select again. */
2054 FD_ZERO (&Available
);
2057 redisplay_preserve_echo_area ();
2060 else if (nread
== -1 && errno
== EWOULDBLOCK
)
2064 else if (nread
== -1 && errno
== EAGAIN
)
2068 else if (nread
== -1 && errno
== EAGAIN
)
2070 /* Note that we cannot distinguish between no input
2071 available now and a closed pipe.
2072 With luck, a closed pipe will be accompanied by
2073 subprocess termination and SIGCHLD. */
2074 else if (nread
== 0 && !NETCONN_P (proc
))
2076 #endif /* O_NDELAY */
2077 #endif /* O_NONBLOCK */
2078 #endif /* EWOULDBLOCK */
2080 /* On some OSs with ptys, when the process on one end of
2081 a pty exits, the other end gets an error reading with
2082 errno = EIO instead of getting an EOF (0 bytes read).
2083 Therefore, if we get an error reading and errno =
2084 EIO, just continue, because the child process has
2085 exited and should clean itself up soon (e.g. when we
2087 else if (nread
== -1 && errno
== EIO
)
2089 #endif /* HAVE_PTYS */
2090 /* If we can detect process termination, don't consider the process
2091 gone just because its pipe is closed. */
2093 else if (nread
== 0 && !NETCONN_P (proc
))
2098 /* Preserve status of processes already terminated. */
2099 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2100 deactivate_process (proc
);
2101 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2102 update_status (XPROCESS (proc
));
2103 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2104 XPROCESS (proc
)->status
2105 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2108 } /* end for each file descriptor */
2109 } /* end while exit conditions not met */
2111 /* If calling from keyboard input, do not quit
2112 since we want to return C-g as an input character.
2113 Otherwise, do pending quit if requested. */
2114 if (XINT (read_kbd
) >= 0)
2116 /* Prevent input_pending from remaining set if we quit. */
2117 clear_input_pending ();
2121 return got_some_input
;
2124 /* Read pending output from the process channel,
2125 starting with our buffered-ahead character if we have one.
2126 Yield number of characters read.
2128 This function reads at most 1024 characters.
2129 If you want to read all available subprocess output,
2130 you must call it repeatedly until it returns zero. */
2132 read_process_output (proc
, channel
)
2134 register int channel
;
2136 register int nchars
;
2142 register Lisp_Object outstream
;
2143 register struct buffer
*old
= current_buffer
;
2144 register struct Lisp_Process
*p
= XPROCESS (proc
);
2145 register int opoint
;
2148 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2150 vs
= get_vms_process_pointer (p
->pid
);
2154 return(0); /* Really weird if it does this */
2155 if (!(vs
->iosb
[0] & 1))
2156 return -1; /* I/O error */
2159 error ("Could not get VMS process pointer");
2160 chars
= vs
->inputBuffer
;
2161 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2164 start_vms_process_read (vs
); /* Crank up the next read on the process */
2165 return 1; /* Nothing worth printing, say we got 1 */
2169 if (proc_buffered_char
[channel
] < 0)
2170 nchars
= read (channel
, chars
, sizeof chars
);
2173 chars
[0] = proc_buffered_char
[channel
];
2174 proc_buffered_char
[channel
] = -1;
2175 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2179 nchars
= nchars
+ 1;
2181 #endif /* not VMS */
2183 if (nchars
<= 0) return nchars
;
2185 outstream
= p
->filter
;
2186 if (!NILP (outstream
))
2188 /* We inhibit quit here instead of just catching it so that
2189 hitting ^G when a filter happens to be running won't screw
2191 int count
= specpdl_ptr
- specpdl
;
2192 Lisp_Object odeactivate
;
2193 Lisp_Object obuffer
;
2195 odeactivate
= Vdeactivate_mark
;
2196 obuffer
= Fcurrent_buffer ();
2198 specbind (Qinhibit_quit
, Qt
);
2199 call2 (outstream
, proc
, make_string (chars
, nchars
));
2201 /* Handling the process output should not deactivate the mark. */
2202 Vdeactivate_mark
= odeactivate
;
2204 if (! EQ (Fcurrent_buffer (), obuffer
))
2205 record_asynch_buffer_change ();
2208 start_vms_process_read (vs
);
2210 unbind_to (count
, Qnil
);
2214 /* If no filter, write into buffer if it isn't dead. */
2215 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2217 Lisp_Object old_read_only
;
2218 Lisp_Object old_begv
, old_zv
;
2219 Lisp_Object odeactivate
;
2221 odeactivate
= Vdeactivate_mark
;
2223 Fset_buffer (p
->buffer
);
2225 old_read_only
= current_buffer
->read_only
;
2226 XFASTINT (old_begv
) = BEGV
;
2227 XFASTINT (old_zv
) = ZV
;
2229 current_buffer
->read_only
= Qnil
;
2231 /* Insert new output into buffer
2232 at the current end-of-output marker,
2233 thus preserving logical ordering of input and output. */
2234 if (XMARKER (p
->mark
)->buffer
)
2235 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2239 /* If the output marker is outside of the visible region, save
2240 the restriction and widen. */
2241 if (! (BEGV
<= point
&& point
<= ZV
))
2244 /* Make sure opoint floats ahead of any new text, just as point
2246 if (point
<= opoint
)
2249 /* Insert after old_begv, but before old_zv. */
2250 if (point
< XFASTINT (old_begv
))
2251 XFASTINT (old_begv
) += nchars
;
2252 if (point
<= XFASTINT (old_zv
))
2253 XFASTINT (old_zv
) += nchars
;
2255 /* Insert before markers in case we are inserting where
2256 the buffer's mark is, and the user's next command is Meta-y. */
2257 insert_before_markers (chars
, nchars
);
2258 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2260 update_mode_lines
++;
2262 /* If the restriction isn't what it should be, set it. */
2263 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2264 Fnarrow_to_region (old_begv
, old_zv
);
2266 /* Handling the process output should not deactivate the mark. */
2267 Vdeactivate_mark
= odeactivate
;
2269 current_buffer
->read_only
= old_read_only
;
2271 set_buffer_internal (old
);
2274 start_vms_process_read (vs
);
2279 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2281 "Returns non-NIL if emacs is waiting for input from the user.\n\
2282 This is intended for use by asynchronous process output filters and sentinels.")
2285 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2288 /* Sending data to subprocess */
2290 jmp_buf send_process_frame
;
2293 send_process_trap ()
2299 longjmp (send_process_frame
, 1);
2302 send_process (proc
, buf
, len
)
2307 /* Don't use register vars; longjmp can lose them. */
2309 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2313 struct Lisp_Process
*p
= XPROCESS (proc
);
2314 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2317 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2318 update_status (XPROCESS (proc
));
2319 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2320 error ("Process %s not running", procname
);
2323 vs
= get_vms_process_pointer (p
->pid
);
2325 error ("Could not find this process: %x", p
->pid
);
2326 else if (write_to_vms_process (vs
, buf
, len
))
2329 if (!setjmp (send_process_frame
))
2333 SIGTYPE (*old_sigpipe
)();
2336 if (pty_max_bytes
== 0)
2338 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2339 pty_max_bytes
= fpathconf (XFASTINT (XPROCESS (proc
)->outfd
),
2341 if (pty_max_bytes
< 0)
2342 pty_max_bytes
= 250;
2344 pty_max_bytes
= 250;
2348 /* Don't send more than pty_max_bytes bytes at a time. */
2349 /* Subtract 1 to leave room for the EOF. */
2350 if (this >= pty_max_bytes
&& !NILP (XPROCESS (proc
)->pty_flag
))
2351 this = pty_max_bytes
- 1;
2353 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2354 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
2356 /* If we sent just part of the string, put in an EOF
2357 to force it through, before we send the rest. */
2359 Fprocess_send_eof (proc
);
2361 signal (SIGPIPE
, old_sigpipe
);
2366 || errno
== EWOULDBLOCK
2373 /* It would be nice to accept process output here,
2374 but that is difficult. For example, it could
2375 garbage what we are sending if that is from a buffer. */
2382 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2386 /* Allow input from processes between bursts of sending.
2387 Otherwise things may get stopped up. */
2392 XFASTINT (zero
) = 0;
2393 wait_reading_process_input (-1, 0, zero
, 0);
2399 XPROCESS (proc
)->raw_status_low
= Qnil
;
2400 XPROCESS (proc
)->raw_status_high
= Qnil
;
2401 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2402 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2403 deactivate_process (proc
);
2405 error ("Error writing to process %s; closed it", procname
);
2407 error ("SIGPIPE raised on process %s; closed it", procname
);
2412 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2414 "Send current contents of region as input to PROCESS.\n\
2415 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2416 nil, indicating the current buffer's process.\n\
2417 Called from program, takes three arguments, PROCESS, START and END.\n\
2418 If the region is more than 500 characters long,\n\
2419 it is sent in several bunches. This may happen even for shorter regions.\n\
2420 Output from processes can arrive in between bunches.")
2421 (process
, start
, end
)
2422 Lisp_Object process
, start
, end
;
2427 proc
= get_process (process
);
2428 validate_region (&start
, &end
);
2430 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2433 start1
= XINT (start
);
2434 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2439 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2441 "Send PROCESS the contents of STRING as input.\n\
2442 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2443 nil, indicating the current buffer's process.\n\
2444 If STRING is more than 500 characters long,\n\
2445 it is sent in several bunches. This may happen even for shorter strings.\n\
2446 Output from processes can arrive in between bunches.")
2448 Lisp_Object process
, string
;
2451 CHECK_STRING (string
, 1);
2452 proc
= get_process (process
);
2453 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2457 /* send a signal number SIGNO to PROCESS.
2458 CURRENT_GROUP means send to the process group that currently owns
2459 the terminal being used to communicate with PROCESS.
2460 This is used for various commands in shell mode.
2461 If NOMSG is zero, insert signal-announcements into process's buffers
2464 If we can, we try to signal PROCESS by sending control characters
2465 down the pipe. This allows us to signal inferiors who have changed
2466 their uid, for which killpg would return an EPERM error. */
2469 process_send_signal (process
, signo
, current_group
, nomsg
)
2470 Lisp_Object process
;
2472 Lisp_Object current_group
;
2476 register struct Lisp_Process
*p
;
2480 proc
= get_process (process
);
2481 p
= XPROCESS (proc
);
2483 if (!EQ (p
->childp
, Qt
))
2484 error ("Process %s is not a subprocess",
2485 XSTRING (p
->name
)->data
);
2486 if (XINT (p
->infd
) < 0)
2487 error ("Process %s is not active",
2488 XSTRING (p
->name
)->data
);
2490 if (NILP (p
->pty_flag
))
2491 current_group
= Qnil
;
2493 /* If we are using pgrps, get a pgrp number and make it negative. */
2494 if (!NILP (current_group
))
2496 #ifdef SIGNALS_VIA_CHARACTERS
2497 /* If possible, send signals to the entire pgrp
2498 by sending an input character to it. */
2500 /* TERMIOS is the latest and bestest, and seems most likely to
2501 work. If the system has it, use it. */
2508 tcgetattr (XINT (p
->infd
), &t
);
2509 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2513 tcgetattr (XINT (p
->infd
), &t
);
2514 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2518 tcgetattr (XINT (p
->infd
), &t
);
2519 #if defined (VSWTCH) && !defined (IRIX5)
2520 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2522 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2527 #else /* ! HAVE_TERMIOS */
2529 /* On Berkeley descendants, the following IOCTL's retrieve the
2530 current control characters. */
2531 #if defined (TIOCGLTC) && defined (TIOCGETC)
2539 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2540 send_process (proc
, &c
.t_intrc
, 1);
2543 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2544 send_process (proc
, &c
.t_quitc
, 1);
2548 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
2549 send_process (proc
, &lc
.t_suspc
, 1);
2551 #endif /* ! defined (SIGTSTP) */
2554 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2556 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2563 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2564 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2567 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2568 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2572 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2573 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2575 #endif /* ! defined (SIGTSTP) */
2577 #else /* ! defined (TCGETA) */
2578 Your configuration files are messed up
.
2579 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2580 you'd better be using one of the alternatives above! */
2581 #endif /* ! defined (TCGETA) */
2582 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2583 #endif /* ! defined HAVE_TERMIOS */
2584 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2587 /* Get the pgrp using the tty itself, if we have that.
2588 Otherwise, use the pty to get the pgrp.
2589 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2590 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2591 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2592 His patch indicates that if TIOCGPGRP returns an error, then
2593 we should just assume that p->pid is also the process group id. */
2597 if (!NILP (p
->subtty
))
2598 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2600 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
2604 gid
= - XFASTINT (p
->pid
);
2605 #endif /* ! defined (pfa) */
2611 #else /* ! defined (TIOCGPGRP ) */
2612 /* Can't select pgrps on this system, so we know that
2613 the child itself heads the pgrp. */
2614 gid
= - XFASTINT (p
->pid
);
2615 #endif /* ! defined (TIOCGPGRP ) */
2618 gid
= - XFASTINT (p
->pid
);
2624 p
->raw_status_low
= Qnil
;
2625 p
->raw_status_high
= Qnil
;
2627 XSETINT (p
->tick
, ++process_tick
);
2631 #endif /* ! defined (SIGCONT) */
2634 send_process (proc
, "\003", 1); /* ^C */
2639 send_process (proc
, "\031", 1); /* ^Y */
2644 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2647 flush_pending_output (XINT (p
->infd
));
2651 /* If we don't have process groups, send the signal to the immediate
2652 subprocess. That isn't really right, but it's better than any
2653 obvious alternative. */
2656 kill (XFASTINT (p
->pid
), signo
);
2660 /* gid may be a pid, or minus a pgrp's number */
2662 if (!NILP (current_group
))
2663 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
2666 gid
= - XFASTINT (p
->pid
);
2669 #else /* ! defined (TIOCSIGSEND) */
2670 EMACS_KILLPG (-gid
, signo
);
2671 #endif /* ! defined (TIOCSIGSEND) */
2674 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2675 "Interrupt process PROCESS. May be process or name of one.\n\
2676 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2677 Nil or no arg means current buffer's process.\n\
2678 Second arg CURRENT-GROUP non-nil means send signal to\n\
2679 the current process-group of the process's controlling terminal\n\
2680 rather than to the process's own process group.\n\
2681 If the process is a shell, this means interrupt current subjob\n\
2682 rather than the shell.")
2683 (process
, current_group
)
2684 Lisp_Object process
, current_group
;
2686 process_send_signal (process
, SIGINT
, current_group
, 0);
2690 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2691 "Kill process PROCESS. May be process or name of one.\n\
2692 See function `interrupt-process' for more details on usage.")
2693 (process
, current_group
)
2694 Lisp_Object process
, current_group
;
2696 process_send_signal (process
, SIGKILL
, current_group
, 0);
2700 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2701 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2702 See function `interrupt-process' for more details on usage.")
2703 (process
, current_group
)
2704 Lisp_Object process
, current_group
;
2706 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2710 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2711 "Stop process PROCESS. May be process or name of one.\n\
2712 See function `interrupt-process' for more details on usage.")
2713 (process
, current_group
)
2714 Lisp_Object process
, current_group
;
2717 error ("no SIGTSTP support");
2719 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2724 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2725 "Continue process PROCESS. May be process or name of one.\n\
2726 See function `interrupt-process' for more details on usage.")
2727 (process
, current_group
)
2728 Lisp_Object process
, current_group
;
2731 process_send_signal (process
, SIGCONT
, current_group
, 0);
2733 error ("no SIGCONT support");
2738 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2739 2, 2, "nProcess number: \nnSignal code: ",
2740 "Send the process with number PID the signal with code CODE.\n\
2741 Both PID and CODE are integers.")
2743 Lisp_Object pid
, sig
;
2745 CHECK_NUMBER (pid
, 0);
2746 CHECK_NUMBER (sig
, 1);
2747 return make_number (kill (XINT (pid
), XINT (sig
)));
2750 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2751 "Make PROCESS see end-of-file in its input.\n\
2752 Eof comes after any text already sent to it.\n\
2753 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2754 nil, indicating the current buffer's process.")
2756 Lisp_Object process
;
2760 proc
= get_process (process
);
2762 /* Make sure the process is really alive. */
2763 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2764 update_status (XPROCESS (proc
));
2765 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2766 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2768 /* Sending a zero-length record is supposed to mean eof
2769 when TIOCREMOTE is turned on. */
2773 write (XINT (XPROCESS (proc
)->outfd
), buf
, 0);
2775 #else /* did not do TOICREMOTE */
2777 send_process (proc
, "\032", 1); /* ^z */
2779 if (!NILP (XPROCESS (proc
)->pty_flag
))
2780 send_process (proc
, "\004", 1);
2783 close (XINT (XPROCESS (proc
)->outfd
));
2784 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, open (NULL_DEVICE
, O_WRONLY
));
2787 #endif /* did not do TOICREMOTE */
2791 /* Kill all processes associated with `buffer'.
2792 If `buffer' is nil, kill all processes */
2794 kill_buffer_processes (buffer
)
2797 Lisp_Object tail
, proc
;
2799 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2800 tail
= XCONS (tail
)->cdr
)
2802 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2803 if (XGCTYPE (proc
) == Lisp_Process
2804 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2806 if (NETCONN_P (proc
))
2807 deactivate_process (proc
);
2808 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
2809 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2814 /* On receipt of a signal that a child status has changed,
2815 loop asking about children with changed statuses until
2816 the system says there are no more.
2817 All we do is change the status;
2818 we do not run sentinels or print notifications.
2819 That is saved for the next time keyboard input is done,
2820 in order to avoid timing errors. */
2822 /** WARNING: this can be called during garbage collection.
2823 Therefore, it must not be fooled by the presence of mark bits in
2826 /** USG WARNING: Although it is not obvious from the documentation
2827 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2828 signal() before executing at least one wait(), otherwise the handler
2829 will be called again, resulting in an infinite loop. The relevant
2830 portion of the documentation reads "SIGCLD signals will be queued
2831 and the signal-catching function will be continually reentered until
2832 the queue is empty". Invoking signal() causes the kernel to reexamine
2833 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2836 sigchld_handler (signo
)
2839 int old_errno
= errno
;
2841 register struct Lisp_Process
*p
;
2842 extern EMACS_TIME
*input_available_clear_time
;
2846 sigheld
|= sigbit (SIGCHLD
);
2858 #endif /* no WUNTRACED */
2859 /* Keep trying to get a status until we get a definitive result. */
2863 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2865 while (pid
<= 0 && errno
== EINTR
);
2869 /* A real failure. We have done all our job, so return. */
2871 /* USG systems forget handlers when they are used;
2872 must reestablish each time */
2874 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2877 sigheld
&= ~sigbit (SIGCHLD
);
2885 #endif /* no WNOHANG */
2887 /* Find the process that signaled us, and record its status. */
2890 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2892 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2893 p
= XPROCESS (proc
);
2894 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2899 /* Look for an asynchronous process whose pid hasn't been filled
2902 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2904 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2905 p
= XPROCESS (proc
);
2906 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2911 /* Change the status of the process that was found. */
2914 union { int i
; WAITTYPE wt
; } u
;
2916 XSETINT (p
->tick
, ++process_tick
);
2918 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2919 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2921 /* If process has terminated, stop waiting for its output. */
2922 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2923 if (XINT (p
->infd
) >= 0)
2924 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
2926 /* Tell wait_reading_process_input that it needs to wake up and
2928 if (input_available_clear_time
)
2929 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2932 /* There was no asynchronous process found for that id. Check
2933 if we have a synchronous process. */
2936 synch_process_alive
= 0;
2938 /* Report the status of the synchronous process. */
2940 synch_process_retcode
= WRETCODE (w
);
2941 else if (WIFSIGNALED (w
))
2943 int code
= WTERMSIG (w
);
2949 signame
= sys_siglist
[code
];
2951 signame
= sys_errlist
[code
];
2955 signame
= "unknown";
2957 synch_process_death
= signame
;
2960 /* Tell wait_reading_process_input that it needs to wake up and
2962 if (input_available_clear_time
)
2963 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2966 /* On some systems, we must return right away.
2967 If any more processes want to signal us, we will
2969 Otherwise (on systems that have WNOHANG), loop around
2970 to use up all the processes that have something to tell us. */
2971 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2973 signal (signo
, sigchld_handler
);
2977 #endif /* USG, but not HPUX with WNOHANG */
2983 exec_sentinel_unwind (data
)
2986 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2991 exec_sentinel (proc
, reason
)
2992 Lisp_Object proc
, reason
;
2994 Lisp_Object sentinel
;
2995 register struct Lisp_Process
*p
= XPROCESS (proc
);
2996 int count
= specpdl_ptr
- specpdl
;
2998 sentinel
= p
->sentinel
;
2999 if (NILP (sentinel
))
3002 /* Zilch the sentinel while it's running, to avoid recursive invocations;
3003 assure that it gets restored no matter how the sentinel exits. */
3005 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
3006 /* Inhibit quit so that random quits don't screw up a running filter. */
3007 specbind (Qinhibit_quit
, Qt
);
3008 call2 (sentinel
, proc
, reason
);
3009 unbind_to (count
, Qnil
);
3012 /* Report all recent events of a change in process status
3013 (either run the sentinel or output a message).
3014 This is done while Emacs is waiting for keyboard input. */
3018 register Lisp_Object proc
, buffer
;
3019 Lisp_Object tail
, msg
;
3020 struct gcpro gcpro1
, gcpro2
;
3024 /* We need to gcpro tail; if read_process_output calls a filter
3025 which deletes a process and removes the cons to which tail points
3026 from Vprocess_alist, and then causes a GC, tail is an unprotected
3030 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
3033 register struct Lisp_Process
*p
;
3035 proc
= Fcdr (Fcar (tail
));
3036 p
= XPROCESS (proc
);
3038 if (XINT (p
->tick
) != XINT (p
->update_tick
))
3040 XSETINT (p
->update_tick
, XINT (p
->tick
));
3042 /* If process is still active, read any output that remains. */
3043 if (XINT (p
->infd
) >= 0)
3044 while (! EQ (p
->filter
, Qt
)
3045 && read_process_output (proc
, XINT (p
->infd
)) > 0);
3049 /* Get the text to use for the message. */
3050 if (!NILP (p
->raw_status_low
))
3052 msg
= status_message (p
->status
);
3054 /* If process is terminated, deactivate it or delete it. */
3056 if (XTYPE (p
->status
) == Lisp_Cons
)
3057 symbol
= XCONS (p
->status
)->car
;
3059 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
3060 || EQ (symbol
, Qclosed
))
3062 if (delete_exited_processes
)
3063 remove_process (proc
);
3065 deactivate_process (proc
);
3068 /* Now output the message suitably. */
3069 if (!NILP (p
->sentinel
))
3070 exec_sentinel (proc
, msg
);
3071 /* Don't bother with a message in the buffer
3072 when a process becomes runnable. */
3073 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
3075 Lisp_Object ro
, tem
;
3076 struct buffer
*old
= current_buffer
;
3079 ro
= XBUFFER (buffer
)->read_only
;
3081 /* Avoid error if buffer is deleted
3082 (probably that's why the process is dead, too) */
3083 if (NILP (XBUFFER (buffer
)->name
))
3085 Fset_buffer (buffer
);
3087 /* Insert new output into buffer
3088 at the current end-of-output marker,
3089 thus preserving logical ordering of input and output. */
3090 if (XMARKER (p
->mark
)->buffer
)
3091 SET_PT (marker_position (p
->mark
));
3094 if (point
<= opoint
)
3095 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
3097 tem
= current_buffer
->read_only
;
3098 current_buffer
->read_only
= Qnil
;
3099 insert_string ("\nProcess ");
3100 Finsert (1, &p
->name
);
3101 insert_string (" ");
3103 current_buffer
->read_only
= tem
;
3104 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
3107 set_buffer_internal (old
);
3112 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
3113 redisplay_preserve_echo_area ();
3115 update_tick
= process_tick
;
3126 if (! noninteractive
|| initialized
)
3128 signal (SIGCHLD
, sigchld_handler
);
3131 FD_ZERO (&input_wait_mask
);
3132 max_process_desc
= 0;
3134 keyboard_descriptor
= 0;
3135 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3137 Vprocess_alist
= Qnil
;
3138 for (i
= 0; i
< MAXDESC
; i
++)
3140 chan_process
[i
] = Qnil
;
3141 proc_buffered_char
[i
] = -1;
3145 /* From now on, assume keyboard input comes from descriptor DESC. */
3148 change_keyboard_wait_descriptor (desc
)
3151 FD_CLR (keyboard_descriptor
, &input_wait_mask
);
3152 keyboard_descriptor
= desc
;
3153 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3159 stream_process
= intern ("stream");
3161 Qprocessp
= intern ("processp");
3162 staticpro (&Qprocessp
);
3163 Qrun
= intern ("run");
3165 Qstop
= intern ("stop");
3167 Qsignal
= intern ("signal");
3168 staticpro (&Qsignal
);
3170 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3173 Qexit = intern ("exit");
3174 staticpro (&Qexit); */
3176 Qopen
= intern ("open");
3178 Qclosed
= intern ("closed");
3179 staticpro (&Qclosed
);
3181 staticpro (&Vprocess_alist
);
3183 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3184 "*Non-nil means delete processes immediately when they exit.\n\
3185 nil means don't delete them until `list-processes' is run.");
3187 delete_exited_processes
= 1;
3189 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3190 "Control type of device used to communicate with subprocesses.\n\
3191 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3192 pty's are not available, this variable will be ignored. The value takes\n\
3193 effect when `start-process' is called.");
3194 Vprocess_connection_type
= Qt
;
3196 defsubr (&Sprocessp
);
3197 defsubr (&Sget_process
);
3198 defsubr (&Sget_buffer_process
);
3199 defsubr (&Sdelete_process
);
3200 defsubr (&Sprocess_status
);
3201 defsubr (&Sprocess_exit_status
);
3202 defsubr (&Sprocess_id
);
3203 defsubr (&Sprocess_name
);
3204 defsubr (&Sprocess_command
);
3205 defsubr (&Sset_process_buffer
);
3206 defsubr (&Sprocess_buffer
);
3207 defsubr (&Sprocess_mark
);
3208 defsubr (&Sset_process_filter
);
3209 defsubr (&Sprocess_filter
);
3210 defsubr (&Sset_process_sentinel
);
3211 defsubr (&Sset_process_window_size
);
3212 defsubr (&Sprocess_sentinel
);
3213 defsubr (&Sprocess_kill_without_query
);
3214 defsubr (&Slist_processes
);
3215 defsubr (&Sprocess_list
);
3216 defsubr (&Sstart_process
);
3218 defsubr (&Sopen_network_stream
);
3219 #endif /* HAVE_SOCKETS */
3220 defsubr (&Saccept_process_output
);
3221 defsubr (&Sprocess_send_region
);
3222 defsubr (&Sprocess_send_string
);
3223 defsubr (&Sinterrupt_process
);
3224 defsubr (&Skill_process
);
3225 defsubr (&Squit_process
);
3226 defsubr (&Sstop_process
);
3227 defsubr (&Scontinue_process
);
3228 defsubr (&Sprocess_send_eof
);
3229 defsubr (&Ssignal_process
);
3230 defsubr (&Swaiting_for_user_input_p
);
3231 /* defsubr (&Sprocess_connection); */
3235 #else /* not subprocesses */
3237 #include <sys/types.h>
3241 #include "systime.h"
3242 #include "termopts.h"
3244 extern int frame_garbaged
;
3247 /* As described above, except assuming that there are no subprocesses:
3249 Wait for timeout to elapse and/or keyboard input to be available.
3252 timeout in seconds, or
3253 zero for no limit, or
3254 -1 means gobble data immediately available but don't wait for any.
3256 read_kbd is a Lisp_Object:
3257 0 to ignore keyboard input, or
3258 1 to return when input is available, or
3259 -1 means caller will actually read the input, so don't throw to
3261 We know that read_kbd will never be a Lisp_Process, since
3262 `subprocesses' isn't defined.
3264 do_display != 0 means redisplay should be done to show subprocess
3265 output that arrives.
3267 Return true iff we received input from any process. */
3270 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3271 int time_limit
, microsecs
;
3272 Lisp_Object read_kbd
;
3275 EMACS_TIME end_time
, timeout
, *timeout_p
;
3278 /* What does time_limit really mean? */
3279 if (time_limit
|| microsecs
)
3281 /* It's not infinite. */
3282 timeout_p
= &timeout
;
3284 if (time_limit
== -1)
3285 /* In fact, it's zero. */
3286 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3288 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3290 /* How far in the future is that? */
3291 EMACS_GET_TIME (end_time
);
3292 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3295 /* It's infinite. */
3298 /* This must come before stop_polling. */
3299 prepare_menu_bars ();
3301 /* Turn off periodic alarms (in case they are in use)
3302 because the select emulator uses alarms. */
3309 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3311 /* If calling from keyboard input, do not quit
3312 since we want to return C-g as an input character.
3313 Otherwise, do pending quit if requested. */
3314 if (XINT (read_kbd
) >= 0)
3319 EMACS_GET_TIME (*timeout_p
);
3320 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3321 if (EMACS_TIME_NEG_P (*timeout_p
))
3325 /* Cause C-g and alarm signals to take immediate action,
3326 and cause input available signals to zero out timeout. */
3327 if (XINT (read_kbd
) < 0)
3328 set_waiting_for_input (&timeout
);
3330 /* If a frame has been newly mapped and needs updating,
3331 reprocess its display stuff. */
3332 if (frame_garbaged
&& do_display
)
3333 redisplay_preserve_echo_area ();
3335 if (XINT (read_kbd
) && detect_input_pending ())
3338 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3340 /* Make C-g and alarm signals set flags again */
3341 clear_waiting_for_input ();
3343 /* If we woke up due to SIGWINCH, actually change size now. */
3344 do_pending_window_change ();
3348 /* If the system call was interrupted, then go around the
3354 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3355 /* System sometimes fails to deliver SIGIO. */
3356 kill (getpid (), SIGIO
);
3359 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3363 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3375 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3376 /* Don't confuse make-docfile by having two doc strings for this function.
3377 make-docfile does not pay attention to #if, for good reason! */
3380 register Lisp_Object name
;
3385 /* Kill all processes associated with `buffer'.
3386 If `buffer' is nil, kill all processes.
3387 Since we have no subprocesses, this does nothing. */
3389 kill_buffer_processes (buffer
)
3400 defsubr (&Sget_buffer_process
);
3404 #endif /* not subprocesses */