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 /* On some systems, e.g. DGUX, inet_addr returns a 'struct in_addr'. */
58 #ifdef HAVE_BROKEN_INET_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 Lisp_Object Qlast_nonmenu_event
;
100 /* Qexit is declared and initialized in eval.c. */
102 /* a process object is a network connection when its childp field is neither
103 Qt nor Qnil but is instead a string (name of foreign host we
104 are connected to + name of port we are connected to) */
107 static Lisp_Object stream_process
;
109 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
111 #define NETCONN_P(p) 0
112 #endif /* HAVE_SOCKETS */
114 /* Define first descriptor number available for subprocesses. */
116 #define FIRST_PROC_DESC 1
118 #define FIRST_PROC_DESC 3
121 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
124 #if !defined (SIGCHLD) && defined (SIGCLD)
125 #define SIGCHLD SIGCLD
128 #include "syssignal.h"
133 extern char *strerror ();
135 extern char *sys_errlist
[];
142 #ifndef SYS_SIGLIST_DECLARED
146 extern char *sys_siglist
[];
147 #endif /* not LINUX */
149 char *sys_siglist
[] =
155 "illegal instruction",
159 "floating point exception",
162 "segmentation violation",
163 "bad argument to system call",
164 "write on a pipe with no one to read it",
166 "software termination signal from kill",
168 "sendable stop signal not from tty",
169 "stop signal from tty",
170 "continue a stopped process",
171 "child status has changed",
172 "background read attempted from control tty",
173 "background write attempted from control tty",
174 "input record available at control tty",
175 "exceeded CPU time limit",
176 "exceeded file size limit"
180 #endif /* ! SYS_SIGLIST_DECLARED */
182 /* t means use pty, nil means use a pipe,
183 maybe other values to come. */
184 static Lisp_Object Vprocess_connection_type
;
188 #include <sys/socket.h>
192 /* Number of events of change of status of a process. */
193 static int process_tick
;
195 /* Number of events for which the user or sentinel has been notified. */
196 static int update_tick
;
199 /* We could get this from param.h, but better not to depend on finding that.
200 And better not to risk that it might define other symbols used in this
203 #define MAXDESC FD_SETSIZE
207 #define SELECT_TYPE fd_set
208 #else /* no FD_SET */
210 #define SELECT_TYPE int
212 /* Define the macros to access a single-int bitmap of descriptors. */
213 #define FD_SET(n, p) (*(p) |= (1 << (n)))
214 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
215 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
216 #define FD_ZERO(p) (*(p) = 0)
217 #endif /* no FD_SET */
219 /* If we support X Windows, turn on the code to poll periodically
220 to detect C-g. It isn't actually used when doing interrupt input. */
221 #ifdef HAVE_X_WINDOWS
222 #define POLL_FOR_INPUT
225 /* Mask of bits indicating the descriptors that we wait for input on */
227 static SELECT_TYPE input_wait_mask
;
229 /* The largest descriptor currently in use for a process object. */
230 static int max_process_desc
;
232 /* Descriptor to use for keyboard input. */
233 static int keyboard_descriptor
;
235 /* Nonzero means delete a process right away if it exits. */
236 static int delete_exited_processes
;
238 /* Indexed by descriptor, gives the process (if any) for that descriptor */
239 Lisp_Object chan_process
[MAXDESC
];
241 /* Alist of elements (NAME . PROCESS) */
242 Lisp_Object Vprocess_alist
;
244 /* Buffered-ahead input char from process, indexed by channel.
245 -1 means empty (no char is buffered).
246 Used on sys V where the only way to tell if there is any
247 output from the process is to read at least one char.
248 Always -1 on systems that support FIONREAD. */
250 static int proc_buffered_char
[MAXDESC
];
252 static Lisp_Object
get_process ();
254 /* Maximum number of bytes to send to a pty without an eof. */
255 static int pty_max_bytes
;
257 /* Compute the Lisp form of the process status, p->status, from
258 the numeric status that was returned by `wait'. */
260 Lisp_Object
status_convert ();
263 struct Lisp_Process
*p
;
265 union { int i
; WAITTYPE wt
; } u
;
266 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
267 p
->status
= status_convert (u
.wt
);
268 p
->raw_status_low
= Qnil
;
269 p
->raw_status_high
= Qnil
;
272 /* Convert a process status word in Unix format to
273 the list that we use internally. */
280 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
281 else if (WIFEXITED (w
))
282 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
283 WCOREDUMP (w
) ? Qt
: Qnil
));
284 else if (WIFSIGNALED (w
))
285 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
286 WCOREDUMP (w
) ? Qt
: Qnil
));
291 /* Given a status-list, extract the three pieces of information
292 and store them individually through the three pointers. */
295 decode_status (l
, symbol
, code
, coredump
)
303 if (XTYPE (l
) == Lisp_Symbol
)
311 *symbol
= XCONS (l
)->car
;
312 tem
= XCONS (l
)->cdr
;
313 *code
= XFASTINT (XCONS (tem
)->car
);
314 tem
= XCONS (tem
)->cdr
;
315 *coredump
= !NILP (tem
);
319 /* Return a string describing a process status list. */
322 status_message (status
)
327 Lisp_Object string
, string2
;
329 decode_status (status
, &symbol
, &code
, &coredump
);
331 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
337 signame
= sys_siglist
[code
];
339 signame
= sys_errlist
[code
];
344 string
= build_string (signame
);
345 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
346 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
347 return concat2 (string
, string2
);
349 else if (EQ (symbol
, Qexit
))
352 return build_string ("finished\n");
353 string
= Fnumber_to_string (make_number (code
));
354 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
355 return concat2 (build_string ("exited abnormally with code "),
356 concat2 (string
, string2
));
359 return Fcopy_sequence (Fsymbol_name (symbol
));
364 /* Open an available pty, returning a file descriptor.
365 Return -1 on failure.
366 The file name of the terminal corresponding to the pty
367 is left in the variable pty_name. */
378 /* Some systems name their pseudoterminals so that there are gaps in
379 the usual sequence - for example, on HP9000/S700 systems, there
380 are no pseudoterminals with names ending in 'f'. So we wait for
381 three failures in a row before deciding that we've reached the
383 int failed_count
= 0;
388 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
389 for (i
= 0; i
< 16; i
++)
392 #ifdef PTY_NAME_SPRINTF
395 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
396 #endif /* no PTY_NAME_SPRINTF */
400 #else /* no PTY_OPEN */
402 /* Unusual IRIS code */
403 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
406 if (fstat (fd
, &stb
) < 0)
409 if (stat (pty_name
, &stb
) < 0)
412 if (failed_count
>= 3)
418 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
420 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
422 #endif /* not IRIS */
423 #endif /* no PTY_OPEN */
427 /* check to make certain that both sides are available
428 this avoids a nasty yet stupid bug in rlogins */
429 #ifdef PTY_TTY_NAME_SPRINTF
432 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
433 #endif /* no PTY_TTY_NAME_SPRINTF */
435 if (access (pty_name
, 6) != 0)
438 #if !defined(IRIS) && !defined(__sgi)
444 #endif /* not UNIPLUS */
451 #endif /* HAVE_PTYS */
457 register Lisp_Object val
, tem
, name1
;
458 register struct Lisp_Process
*p
;
462 /* size of process structure includes the vector header,
463 so deduct for that. But struct Lisp_Vector includes the first
464 element, thus deducts too much, so add it back. */
465 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
466 - sizeof (struct Lisp_Vector
)
467 + sizeof (Lisp_Object
))
468 / sizeof (Lisp_Object
)),
470 XSETTYPE (val
, Lisp_Process
);
473 XSET (p
->infd
, Lisp_Int
, -1);
474 XSET (p
->outfd
, Lisp_Int
, -1);
475 XFASTINT (p
->pid
) = 0;
476 XFASTINT (p
->tick
) = 0;
477 XFASTINT (p
->update_tick
) = 0;
478 p
->raw_status_low
= Qnil
;
479 p
->raw_status_high
= Qnil
;
481 p
->mark
= Fmake_marker ();
483 /* If name is already in use, modify it until it is unused. */
488 tem
= Fget_process (name1
);
489 if (NILP (tem
)) break;
490 sprintf (suffix
, "<%d>", i
);
491 name1
= concat2 (name
, build_string (suffix
));
495 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
499 remove_process (proc
)
500 register Lisp_Object proc
;
502 register Lisp_Object pair
;
504 pair
= Frassq (proc
, Vprocess_alist
);
505 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
506 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
508 deactivate_process (proc
);
511 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
512 "Return t if OBJECT is a process.")
516 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
519 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
520 "Return the process named NAME, or nil if there is none.")
522 register Lisp_Object name
;
524 if (XTYPE (name
) == Lisp_Process
)
526 CHECK_STRING (name
, 0);
527 return Fcdr (Fassoc (name
, Vprocess_alist
));
530 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
531 "Return the (or, a) process associated with BUFFER.\n\
532 BUFFER may be a buffer or the name of one.")
534 register Lisp_Object name
;
536 register Lisp_Object buf
, tail
, proc
;
538 if (NILP (name
)) return Qnil
;
539 buf
= Fget_buffer (name
);
540 if (NILP (buf
)) return Qnil
;
542 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
544 proc
= Fcdr (Fcar (tail
));
545 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
551 /* This is how commands for the user decode process arguments. It
552 accepts a process, a process name, a buffer, a buffer name, or nil.
553 Buffers denote the first process in the buffer, and nil denotes the
558 register Lisp_Object name
;
560 register Lisp_Object proc
, obj
;
563 obj
= Fget_process (name
);
565 obj
= Fget_buffer (name
);
567 error ("Process %s does not exist", XSTRING (name
)->data
);
569 else if (NILP (name
))
570 obj
= Fcurrent_buffer ();
574 /* Now obj should be either a buffer object or a process object.
578 proc
= Fget_buffer_process (obj
);
580 error ("Buffer %s has no process", XSTRING (XBUFFER (obj
)->name
)->data
);
584 CHECK_PROCESS (obj
, 0);
590 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
591 "Delete PROCESS: kill it and forget about it immediately.\n\
592 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
593 nil, indicating the current buffer's process.")
595 register Lisp_Object proc
;
597 proc
= get_process (proc
);
598 XPROCESS (proc
)->raw_status_low
= Qnil
;
599 XPROCESS (proc
)->raw_status_high
= Qnil
;
600 if (NETCONN_P (proc
))
602 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
603 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
605 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
607 Fkill_process (proc
, Qnil
);
608 /* Do this now, since remove_process will make sigchld_handler do nothing. */
609 XPROCESS (proc
)->status
610 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
611 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
614 remove_process (proc
);
618 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
619 "Return the status of PROCESS: a symbol, one of these:\n\
620 run -- for a process that is running.\n\
621 stop -- for a process stopped but continuable.\n\
622 exit -- for a process that has exited.\n\
623 signal -- for a process that has got a fatal signal.\n\
624 open -- for a network stream connection that is open.\n\
625 closed -- for a network stream connection that is closed.\n\
626 nil -- if arg is a process name and no such process exists.\n\
627 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
628 nil, indicating the current buffer's process.")
630 register Lisp_Object proc
;
632 register struct Lisp_Process
*p
;
633 register Lisp_Object status
;
636 proc
= Fget_process (proc
);
638 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 t means stop accepting output from the process.\n\
747 When a process has a filter, each time it does output\n\
748 the entire string of output is passed to the filter.\n\
749 The filter gets two arguments: the process and the string of output.\n\
750 If the process has a filter, its buffer is not used for output.")
752 register Lisp_Object proc
, filter
;
754 CHECK_PROCESS (proc
, 0);
756 FD_CLR (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
757 else if (EQ (XPROCESS (proc
)->filter
, Qt
))
758 FD_SET (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
759 XPROCESS (proc
)->filter
= filter
;
763 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
765 "Returns the filter function of PROCESS; nil if none.\n\
766 See `set-process-filter' for more info on filter functions.")
768 register Lisp_Object proc
;
770 CHECK_PROCESS (proc
, 0);
771 return XPROCESS (proc
)->filter
;
774 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
776 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
777 The sentinel is called as a function when the process changes state.\n\
778 It gets two arguments: the process, and a string describing the change.")
780 register Lisp_Object proc
, sentinel
;
782 CHECK_PROCESS (proc
, 0);
783 XPROCESS (proc
)->sentinel
= sentinel
;
787 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
789 "Return the sentinel of PROCESS; nil if none.\n\
790 See `set-process-sentinel' for more info on sentinels.")
792 register Lisp_Object proc
;
794 CHECK_PROCESS (proc
, 0);
795 return XPROCESS (proc
)->sentinel
;
798 DEFUN ("set-process-window-size", Fset_process_window_size
,
799 Sset_process_window_size
, 3, 3, 0,
800 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
801 (proc
, height
, width
)
802 register Lisp_Object proc
, height
, width
;
804 CHECK_PROCESS (proc
, 0);
805 CHECK_NATNUM (height
, 0);
806 CHECK_NATNUM (width
, 0);
807 if (set_window_size (XINT (XPROCESS (proc
)->infd
),
808 XINT (height
), XINT(width
)) <= 0)
814 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
815 Sprocess_kill_without_query
, 1, 2, 0,
816 "Say no query needed if PROCESS is running when Emacs is exited.\n\
817 Optional second argument if non-nil says to require a query.\n\
818 Value is t if a query was formerly required.")
820 register Lisp_Object proc
, value
;
824 CHECK_PROCESS (proc
, 0);
825 tem
= XPROCESS (proc
)->kill_without_query
;
826 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
831 #if 0 /* Turned off because we don't currently record this info
832 in the process. Perhaps add it. */
833 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
834 "Return the connection type of `PROCESS'.\n\
835 The value is `nil' for a pipe,\n\
836 `t' or `pty' for a pty, or `stream' for a socket connection.")
840 return XPROCESS (process
)->type
;
847 register Lisp_Object tail
, tem
;
848 Lisp_Object proc
, minspace
, tem1
;
849 register struct buffer
*old
= current_buffer
;
850 register struct Lisp_Process
*p
;
854 XFASTINT (minspace
) = 1;
856 set_buffer_internal (XBUFFER (Vstandard_output
));
857 Fbuffer_disable_undo (Vstandard_output
);
859 current_buffer
->truncate_lines
= Qt
;
862 Proc Status Buffer Command\n\
863 ---- ------ ------ -------\n", -1);
865 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
869 proc
= Fcdr (Fcar (tail
));
871 if (NILP (p
->childp
))
874 Finsert (1, &p
->name
);
875 Findent_to (make_number (13), minspace
);
877 if (!NILP (p
->raw_status_low
))
880 if (XTYPE (p
->status
) == Lisp_Cons
)
881 symbol
= XCONS (p
->status
)->car
;
884 if (EQ (symbol
, Qsignal
))
887 tem
= Fcar (Fcdr (p
->status
));
889 if (XINT (tem
) < NSIG
)
890 write_string (sys_errlist
[XINT (tem
)], -1);
893 Fprinc (symbol
, Qnil
);
895 else if (NETCONN_P (proc
))
897 if (EQ (symbol
, Qrun
))
898 write_string ("open", -1);
899 else if (EQ (symbol
, Qexit
))
900 write_string ("closed", -1);
902 Fprinc (symbol
, Qnil
);
905 Fprinc (symbol
, Qnil
);
907 if (EQ (symbol
, Qexit
))
910 tem
= Fcar (Fcdr (p
->status
));
913 sprintf (tembuf
, " %d", XFASTINT (tem
));
914 write_string (tembuf
, -1);
918 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
919 remove_process (proc
);
921 Findent_to (make_number (22), minspace
);
922 if (NILP (p
->buffer
))
923 insert_string ("(none)");
924 else if (NILP (XBUFFER (p
->buffer
)->name
))
925 insert_string ("(Killed)");
927 Finsert (1, &XBUFFER (p
->buffer
)->name
);
929 Findent_to (make_number (37), minspace
);
931 if (NETCONN_P (proc
))
933 sprintf (tembuf
, "(network stream connection to %s)\n",
934 XSTRING (p
->childp
)->data
);
935 insert_string (tembuf
);
949 insert_string ("\n");
955 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
956 "Display a list of all processes.\n\
957 \(Any processes listed as Exited or Signaled are actually eliminated\n\
958 after the listing is made.)")
961 internal_with_output_to_temp_buffer ("*Process List*",
962 list_processes_1
, Qnil
);
966 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
967 "Return a list of all processes.")
970 return Fmapcar (Qcdr
, Vprocess_alist
);
973 /* Starting asynchronous inferior processes. */
975 static Lisp_Object
start_process_unwind ();
977 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
978 "Start a program in a subprocess. Return the process object for it.\n\
979 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
980 NAME is name for process. It is modified if necessary to make it unique.\n\
981 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
982 Process output goes at end of that buffer, unless you specify\n\
983 an output stream or filter function to handle the output.\n\
984 BUFFER may be also nil, meaning that this process is not associated\n\
986 Third arg is program file name. It is searched for as in the shell.\n\
987 Remaining arguments are strings to give program as arguments.")
990 register Lisp_Object
*args
;
992 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
994 register unsigned char *new_argv
;
997 register unsigned char **new_argv
;
1000 int count
= specpdl_ptr
- specpdl
;
1004 buffer
= Fget_buffer_create (buffer
);
1006 /* Make sure that the child will be able to chdir to the current
1007 buffer's current directory, or its unhandled equivalent. We
1008 can't just have the child check for an error when it does the
1009 chdir, since it's in a vfork.
1011 We have to GCPRO around this because Fexpand_file_name and
1012 Funhandled_file_name_directory might call a file name handling
1013 function. The argument list is protected by the caller, so all
1014 we really have to worry about is buffer. */
1016 struct gcpro gcpro1
, gcpro2
;
1018 current_dir
= current_buffer
->directory
;
1020 GCPRO2 (buffer
, current_dir
);
1023 expand_and_dir_to_file
1024 (Funhandled_file_name_directory (current_dir
), Qnil
);
1025 if (NILP (Ffile_accessible_directory_p (current_dir
)))
1026 report_file_error ("Setting current directory",
1027 Fcons (current_buffer
->directory
, Qnil
));
1033 CHECK_STRING (name
, 0);
1037 CHECK_STRING (program
, 2);
1040 /* Make a one member argv with all args concatenated
1041 together separated by a blank. */
1042 len
= XSTRING (program
)->size
+ 2;
1043 for (i
= 3; i
< nargs
; i
++)
1046 CHECK_STRING (tem
, i
);
1047 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1049 new_argv
= (unsigned char *) alloca (len
);
1050 strcpy (new_argv
, XSTRING (program
)->data
);
1051 for (i
= 3; i
< nargs
; i
++)
1054 CHECK_STRING (tem
, i
);
1055 strcat (new_argv
, " ");
1056 strcat (new_argv
, XSTRING (tem
)->data
);
1058 /* Need to add code here to check for program existence on VMS */
1061 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1063 /* If program file name is not absolute, search our path for it */
1064 if (XSTRING (program
)->data
[0] != '/')
1066 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1069 GCPRO4 (name
, program
, buffer
, current_dir
);
1070 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1073 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1074 new_argv
[0] = XSTRING (tem
)->data
;
1077 new_argv
[0] = XSTRING (program
)->data
;
1079 for (i
= 3; i
< nargs
; i
++)
1082 CHECK_STRING (tem
, i
);
1083 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1085 new_argv
[i
- 2] = 0;
1086 #endif /* not VMS */
1088 proc
= make_process (name
);
1089 /* If an error occurs and we can't start the process, we want to
1090 remove it from the process list. This means that each error
1091 check in create_process doesn't need to call remove_process
1092 itself; it's all taken care of here. */
1093 record_unwind_protect (start_process_unwind
, proc
);
1095 XPROCESS (proc
)->childp
= Qt
;
1096 XPROCESS (proc
)->command_channel_p
= Qnil
;
1097 XPROCESS (proc
)->buffer
= buffer
;
1098 XPROCESS (proc
)->sentinel
= Qnil
;
1099 XPROCESS (proc
)->filter
= Qnil
;
1100 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1102 create_process (proc
, new_argv
, current_dir
);
1104 return unbind_to (count
, proc
);
1107 /* This function is the unwind_protect form for Fstart_process. If
1108 PROC doesn't have its pid set, then we know someone has signalled
1109 an error and the process wasn't started successfully, so we should
1110 remove it from the process list. */
1112 start_process_unwind (proc
)
1115 if (XTYPE (proc
) != Lisp_Process
)
1118 /* Was PROC started successfully? */
1119 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1120 remove_process (proc
);
1127 create_process_1 (signo
)
1131 /* USG systems forget handlers when they are used;
1132 must reestablish each time */
1133 signal (signo
, create_process_1
);
1137 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1140 /* Mimic blocking of signals on system V, which doesn't really have it. */
1142 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1143 int sigchld_deferred
;
1146 create_process_sigchld ()
1148 signal (SIGCHLD
, create_process_sigchld
);
1150 sigchld_deferred
= 1;
1156 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1157 create_process (process
, new_argv
, current_dir
)
1158 Lisp_Object process
;
1160 Lisp_Object current_dir
;
1162 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1165 SIGTYPE (*sigchld
)();
1168 extern char **environ
;
1170 inchannel
= outchannel
= -1;
1173 if (!NILP (Vprocess_connection_type
))
1174 outchannel
= inchannel
= allocate_pty ();
1179 /* On USG systems it does not work to open the pty's tty here
1180 and then close and reopen it in the child. */
1182 /* Don't let this terminal become our controlling terminal
1183 (in case we don't have one). */
1184 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1186 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1189 report_file_error ("Opening pty", Qnil
);
1191 forkin
= forkout
= -1;
1192 #endif /* not USG */
1196 #endif /* HAVE_PTYS */
1199 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1200 report_file_error ("Opening socketpair", Qnil
);
1201 outchannel
= inchannel
= sv
[0];
1202 forkout
= forkin
= sv
[1];
1204 #else /* not SKTPAIR */
1213 #endif /* not SKTPAIR */
1216 /* Replaced by close_process_descs */
1217 set_exclusive_use (inchannel
);
1218 set_exclusive_use (outchannel
);
1221 /* Stride people say it's a mystery why this is needed
1222 as well as the O_NDELAY, but that it fails without this. */
1223 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1226 ioctl (inchannel
, FIONBIO
, &one
);
1231 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1234 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1238 /* Record this as an active process, with its channels.
1239 As a result, child_setup will close Emacs's side of the pipes. */
1240 chan_process
[inchannel
] = process
;
1241 XSET (XPROCESS (process
)->infd
, Lisp_Int
, inchannel
);
1242 XSET (XPROCESS (process
)->outfd
, Lisp_Int
, outchannel
);
1243 /* Record the tty descriptor used in the subprocess. */
1245 XPROCESS (process
)->subtty
= Qnil
;
1247 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1248 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1249 XPROCESS (process
)->status
= Qrun
;
1251 /* Delay interrupts until we have a chance to store
1252 the new fork's pid in its process structure */
1256 #else /* not BSD4_1 */
1257 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1258 sigsetmask (sigmask (SIGCHLD
));
1259 #else /* ordinary USG */
1261 sigchld_deferred
= 0;
1262 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1264 #endif /* ordinary USG */
1265 #endif /* not BSD4_1 */
1266 #endif /* SIGCHLD */
1268 FD_SET (inchannel
, &input_wait_mask
);
1269 if (inchannel
> max_process_desc
)
1270 max_process_desc
= inchannel
;
1272 /* Until we store the proper pid, enable sigchld_handler
1273 to recognize an unknown pid as standing for this process.
1274 It is very important not to let this `marker' value stay
1275 in the table after this function has returned; if it does
1276 it might cause call-process to hang and subsequent asynchronous
1277 processes to get their return values scrambled. */
1278 XSETINT (XPROCESS (process
)->pid
, -1);
1281 /* child_setup must clobber environ on systems with true vfork.
1282 Protect it from permanent change. */
1283 char **save_environ
= environ
;
1288 int xforkin
= forkin
;
1289 int xforkout
= forkout
;
1291 #if 0 /* This was probably a mistake--it duplicates code later on,
1292 but fails to handle all the cases. */
1293 /* Make sure SIGCHLD is not blocked in the child. */
1294 sigsetmask (SIGEMPTYMASK
);
1297 /* Make the pty be the controlling terminal of the process. */
1299 /* First, disconnect its current controlling terminal. */
1301 /* We tried doing setsid only if pty_flag, but it caused
1302 process_set_signal to fail on SGI when using a pipe. */
1304 /* Make the pty's terminal the controlling terminal. */
1308 /* We ignore the return value
1309 because faith@cs.unc.edu says that is necessary on Linux. */
1310 ioctl (xforkin
, TIOCSCTTY
, 0);
1313 #else /* not HAVE_SETSID */
1315 /* It's very important to call setpgrp here and no time
1316 afterwards. Otherwise, we lose our controlling tty which
1317 is set when we open the pty. */
1320 #endif /* not HAVE_SETSID */
1321 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1322 if (pty_flag
&& xforkin
>= 0)
1325 tcgetattr (xforkin
, &t
);
1327 if (tcsetattr (xforkin
, TCSANOW
, &t
) < 0)
1328 write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1331 #if defined (NTTYDISC) && defined (TIOCSETD)
1332 if (pty_flag
&& xforkin
>= 0)
1334 /* Use new line discipline. */
1335 int ldisc
= NTTYDISC
;
1336 ioctl (xforkin
, TIOCSETD
, &ldisc
);
1341 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1342 can do TIOCSPGRP only to the process's controlling tty. */
1345 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1346 I can't test it since I don't have 4.3. */
1347 int j
= open ("/dev/tty", O_RDWR
, 0);
1348 ioctl (j
, TIOCNOTTY
, 0);
1351 /* In order to get a controlling terminal on some versions
1352 of BSD, it is necessary to put the process in pgrp 0
1353 before it opens the terminal. */
1357 #endif /* TIOCNOTTY */
1359 #if !defined (RTU) && !defined (UNIPLUS)
1360 /*** There is a suggestion that this ought to be a
1361 conditional on TIOCSPGRP. */
1362 /* Now close the pty (if we had it open) and reopen it.
1363 This makes the pty the controlling terminal of the subprocess. */
1366 #ifdef SET_CHILD_PTY_PGRP
1367 int pgrp
= getpid ();
1370 /* I wonder if close (open (pty_name, ...)) would work? */
1373 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1375 #ifdef SET_CHILD_PTY_PGRP
1376 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1377 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1383 #endif /* not UNIPLUS and not RTU */
1384 #ifdef SETUP_SLAVE_PTY
1389 #endif /* SETUP_SLAVE_PTY */
1391 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1392 Now reenable it in the child, so it will die when we want it to. */
1394 signal (SIGHUP
, SIG_DFL
);
1396 #endif /* HAVE_PTYS */
1401 #else /* not BSD4_1 */
1402 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1403 sigsetmask (SIGEMPTYMASK
);
1404 #else /* ordinary USG */
1406 signal (SIGCHLD
, sigchld
);
1408 #endif /* ordinary USG */
1409 #endif /* not BSD4_1 */
1410 #endif /* SIGCHLD */
1412 signal (SIGINT
, SIG_DFL
);
1413 signal (SIGQUIT
, SIG_DFL
);
1416 child_setup_tty (xforkout
);
1417 child_setup (xforkin
, xforkout
, xforkout
,
1418 new_argv
, 1, current_dir
);
1420 environ
= save_environ
;
1427 if (forkin
!= forkout
&& forkout
>= 0)
1429 report_file_error ("Doing vfork", Qnil
);
1432 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1434 /* If the subfork execv fails, and it exits,
1435 this close hangs. I don't know why.
1436 So have an interrupt jar it loose. */
1438 signal (SIGALRM
, create_process_1
);
1440 XPROCESS (process
)->subtty
= Qnil
;
1445 if (forkin
!= forkout
&& forkout
>= 0)
1451 #else /* not BSD4_1 */
1452 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1453 sigsetmask (SIGEMPTYMASK
);
1454 #else /* ordinary USG */
1456 signal (SIGCHLD
, sigchld
);
1457 /* Now really handle any of these signals
1458 that came in during this function. */
1459 if (sigchld_deferred
)
1460 kill (getpid (), SIGCHLD
);
1462 #endif /* ordinary USG */
1463 #endif /* not BSD4_1 */
1464 #endif /* SIGCHLD */
1466 #endif /* not VMS */
1470 /* open a TCP network connection to a given HOST/SERVICE. Treated
1471 exactly like a normal process when reading and writing. Only
1472 differences are in status display and process deletion. A network
1473 connection has no PID; you cannot signal it. All you can do is
1474 deactivate and close it via delete-process */
1476 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1478 "Open a TCP connection for a service to a host.\n\
1479 Returns a subprocess-object to represent the connection.\n\
1480 Input and output work as for subprocesses; `delete-process' closes it.\n\
1481 Args are NAME BUFFER HOST SERVICE.\n\
1482 NAME is name for process. It is modified if necessary to make it unique.\n\
1483 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1484 Process output goes at end of that buffer, unless you specify\n\
1485 an output stream or filter function to handle the output.\n\
1486 BUFFER may be also nil, meaning that this process is not associated\n\
1488 Third arg is name of the host to connect to, or its IP address.\n\
1489 Fourth arg SERVICE is name of the service desired, or an integer\n\
1490 specifying a port number to connect to.")
1491 (name
, buffer
, host
, service
)
1492 Lisp_Object name
, buffer
, host
, service
;
1496 struct sockaddr_in address
;
1497 struct servent
*svc_info
;
1498 struct hostent
*host_info_ptr
, host_info
;
1499 char *(addr_list
[2]);
1500 IN_ADDR numeric_addr
;
1504 struct hostent host_info_fixed
;
1505 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1507 int count
= specpdl_ptr
- specpdl
;
1509 GCPRO4 (name
, buffer
, host
, service
);
1510 CHECK_STRING (name
, 0);
1511 CHECK_STRING (host
, 0);
1512 if (XTYPE (service
) == Lisp_Int
)
1513 port
= htons ((unsigned short) XINT (service
));
1516 CHECK_STRING (service
, 0);
1517 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1519 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1520 port
= svc_info
->s_port
;
1529 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1531 if (! (host_info_ptr
== 0 && h_errno
== TRY_AGAIN
))
1534 Fsleep_for (make_number (1), Qnil
);
1536 if (host_info_ptr
== 0)
1537 /* Attempt to interpret host as numeric inet address */
1539 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1540 if (NUMERIC_ADDR_ERROR
)
1541 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1543 host_info_ptr
= &host_info
;
1544 host_info
.h_name
= 0;
1545 host_info
.h_aliases
= 0;
1546 host_info
.h_addrtype
= AF_INET
;
1548 /* Older machines have only one address slot called h_addr.
1549 Newer machines have h_addr_list, but #define h_addr to
1550 be its first element. */
1551 host_info
.h_addr_list
= &(addr_list
[0]);
1553 host_info
.h_addr
= (char*)(&numeric_addr
);
1555 host_info
.h_length
= strlen (addr_list
[0]);
1558 bzero (&address
, sizeof address
);
1559 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1560 host_info_ptr
->h_length
);
1561 address
.sin_family
= host_info_ptr
->h_addrtype
;
1562 address
.sin_port
= port
;
1564 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1566 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1568 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1569 when connect is interrupted. So let's not let it get interrupted.
1570 Note we do not turn off polling, because polling is only used
1571 when not interrupt_input, and thus not normally used on the systems
1572 which have this bug. On systems which use polling, there's no way
1573 to quit if polling is turned off. */
1574 if (interrupt_input
)
1577 /* Slow down polling to every ten seconds.
1578 Some kernels have a bug which causes retrying connect to fail
1580 #ifdef POLL_FOR_INPUT
1581 bind_polling_period (10);
1585 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1
1586 && errno
!= EISCONN
)
1592 if (errno
== EADDRINUSE
&& retry
< 20)
1600 if (interrupt_input
)
1604 report_file_error ("connection failed",
1605 Fcons (host
, Fcons (name
, Qnil
)));
1608 #ifdef POLL_FOR_INPUT
1609 unbind_to (count
, Qnil
);
1612 if (interrupt_input
)
1616 s
= connect_server (0);
1618 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1619 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1620 send_command (s
, C_DUMB
, 1, 0);
1626 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1629 buffer
= Fget_buffer_create (buffer
);
1630 proc
= make_process (name
);
1632 chan_process
[inch
] = proc
;
1635 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1638 fcntl (inch
, F_SETFL
, O_NDELAY
);
1642 XPROCESS (proc
)->childp
= host
;
1643 XPROCESS (proc
)->command_channel_p
= Qnil
;
1644 XPROCESS (proc
)->buffer
= buffer
;
1645 XPROCESS (proc
)->sentinel
= Qnil
;
1646 XPROCESS (proc
)->filter
= Qnil
;
1647 XPROCESS (proc
)->command
= Qnil
;
1648 XPROCESS (proc
)->pid
= Qnil
;
1649 XSET (XPROCESS (proc
)->infd
, Lisp_Int
, s
);
1650 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, outch
);
1651 XPROCESS (proc
)->status
= Qrun
;
1652 FD_SET (inch
, &input_wait_mask
);
1653 if (inch
> max_process_desc
)
1654 max_process_desc
= inch
;
1659 #endif /* HAVE_SOCKETS */
1661 deactivate_process (proc
)
1664 register int inchannel
, outchannel
;
1665 register struct Lisp_Process
*p
= XPROCESS (proc
);
1667 inchannel
= XINT (p
->infd
);
1668 outchannel
= XINT (p
->outfd
);
1672 /* Beware SIGCHLD hereabouts. */
1673 flush_pending_output (inchannel
);
1676 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1677 sys$
dassgn (outchannel
);
1678 vs
= get_vms_process_pointer (p
->pid
);
1680 give_back_vms_process_stuff (vs
);
1684 if (outchannel
>= 0 && outchannel
!= inchannel
)
1688 XSET (p
->infd
, Lisp_Int
, -1);
1689 XSET (p
->outfd
, Lisp_Int
, -1);
1690 chan_process
[inchannel
] = Qnil
;
1691 FD_CLR (inchannel
, &input_wait_mask
);
1692 if (inchannel
== max_process_desc
)
1695 /* We just closed the highest-numbered process input descriptor,
1696 so recompute the highest-numbered one now. */
1697 max_process_desc
= 0;
1698 for (i
= 0; i
< MAXDESC
; i
++)
1699 if (!NILP (chan_process
[i
]))
1700 max_process_desc
= i
;
1705 /* Close all descriptors currently in use for communication
1706 with subprocess. This is used in a newly-forked subprocess
1707 to get rid of irrelevant descriptors. */
1709 close_process_descs ()
1712 for (i
= 0; i
< MAXDESC
; i
++)
1714 Lisp_Object process
;
1715 process
= chan_process
[i
];
1716 if (!NILP (process
))
1718 int in
= XINT (XPROCESS (process
)->infd
);
1719 int out
= XINT (XPROCESS (process
)->outfd
);
1722 if (out
>= 0 && in
!= out
)
1728 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1730 "Allow any pending output from subprocesses to be read by Emacs.\n\
1731 It is read into the process' buffers or given to their filter functions.\n\
1732 Non-nil arg PROCESS means do not return until some output has been received\n\
1734 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1735 seconds and microseconds to wait; return after that much time whether\n\
1736 or not there is input.\n\
1737 Return non-nil iff we received any output before the timeout expired.")
1738 (proc
, timeout
, timeout_msecs
)
1739 register Lisp_Object proc
, timeout
, timeout_msecs
;
1744 if (! NILP (timeout_msecs
))
1746 CHECK_NUMBER (timeout_msecs
, 2);
1747 useconds
= XINT (timeout_msecs
);
1748 if (XTYPE (timeout
) != Lisp_Int
)
1749 XSET (timeout
, Lisp_Int
, 0);
1752 int carry
= useconds
/ 1000000;
1754 XSETINT (timeout
, XINT (timeout
) + carry
);
1755 useconds
-= carry
* 1000000;
1757 /* I think this clause is necessary because C doesn't
1758 guarantee a particular rounding direction for negative
1762 XSETINT (timeout
, XINT (timeout
) - 1);
1763 useconds
+= 1000000;
1770 if (! NILP (timeout
))
1772 CHECK_NUMBER (timeout
, 1);
1773 seconds
= XINT (timeout
);
1786 XFASTINT (proc
) = 0;
1789 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1793 /* This variable is different from waiting_for_input in keyboard.c.
1794 It is used to communicate to a lisp process-filter/sentinel (via the
1795 function Fwaiting_for_user_input_p below) whether emacs was waiting
1796 for user-input when that process-filter was called.
1797 waiting_for_input cannot be used as that is by definition 0 when
1798 lisp code is being evalled.
1799 This is also used in record_asynch_buffer_change.
1800 For that purpose, this must be 0
1801 when not inside wait_reading_process_input. */
1802 static int waiting_for_user_input_p
;
1804 /* Read and dispose of subprocess output while waiting for timeout to
1805 elapse and/or keyboard input to be available.
1808 timeout in seconds, or
1809 zero for no limit, or
1810 -1 means gobble data immediately available but don't wait for any.
1813 an additional duration to wait, measured in microseconds.
1814 If this is nonzero and time_limit is 0, then the timeout
1815 consists of MICROSECS only.
1817 READ_KBD is a lisp value:
1818 0 to ignore keyboard input, or
1819 1 to return when input is available, or
1820 -1 meaning caller will actually read the input, so don't throw to
1821 the quit handler, or
1822 a cons cell, meaning wait until its car is non-nil
1823 (and gobble terminal input into the buffer if any arrives), or
1824 a process object, meaning wait until something arrives from that
1825 process. The return value is true iff we read some input from
1828 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1829 output that arrives.
1831 If READ_KBD is a pointer to a struct Lisp_Process, then the
1832 function returns true iff we received input from that process
1833 before the timeout elapsed.
1834 Otherwise, return true iff we received input from any process. */
1836 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1837 int time_limit
, microsecs
;
1838 Lisp_Object read_kbd
;
1841 register int channel
, nfds
, m
;
1842 static SELECT_TYPE Available
;
1845 EMACS_TIME timeout
, end_time
, garbage
;
1847 int wait_channel
= -1;
1848 struct Lisp_Process
*wait_proc
= 0;
1849 int got_some_input
= 0;
1850 Lisp_Object
*wait_for_cell
= 0;
1852 FD_ZERO (&Available
);
1854 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1856 if (XTYPE (read_kbd
) == Lisp_Process
)
1858 wait_proc
= XPROCESS (read_kbd
);
1859 wait_channel
= XINT (wait_proc
->infd
);
1860 XFASTINT (read_kbd
) = 0;
1863 /* If waiting for non-nil in a cell, record where. */
1864 if (XTYPE (read_kbd
) == Lisp_Cons
)
1866 wait_for_cell
= &XCONS (read_kbd
)->car
;
1867 XFASTINT (read_kbd
) = 0;
1870 waiting_for_user_input_p
= XINT (read_kbd
);
1872 /* Since we may need to wait several times,
1873 compute the absolute time to return at. */
1874 if (time_limit
|| microsecs
)
1876 EMACS_GET_TIME (end_time
);
1877 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1878 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1881 /* It would not be safe to call this below,
1882 where we call redisplay_preserve_echo_area. */
1883 if (do_display
&& frame_garbaged
)
1884 prepare_menu_bars ();
1888 /* If calling from keyboard input, do not quit
1889 since we want to return C-g as an input character.
1890 Otherwise, do pending quit if requested. */
1891 if (XINT (read_kbd
) >= 0)
1894 /* Exit now if the cell we're waiting for became non-nil. */
1895 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1898 /* Compute time from now till when time limit is up */
1899 /* Exit if already run out */
1900 if (time_limit
== -1)
1902 /* -1 specified for timeout means
1903 gobble output available now
1904 but don't wait at all. */
1906 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1908 else if (time_limit
|| microsecs
)
1910 EMACS_GET_TIME (timeout
);
1911 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1912 if (EMACS_TIME_NEG_P (timeout
))
1917 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1920 /* Cause C-g and alarm signals to take immediate action,
1921 and cause input available signals to zero out timeout.
1923 It is important that we do this before checking for process
1924 activity. If we get a SIGCHLD after the explicit checks for
1925 process activity, timeout is the only way we will know. */
1926 if (XINT (read_kbd
) < 0)
1927 set_waiting_for_input (&timeout
);
1929 /* If status of something has changed, and no input is
1930 available, notify the user of the change right away. After
1931 this explicit check, we'll let the SIGCHLD handler zap
1932 timeout to get our attention. */
1933 if (update_tick
!= process_tick
&& do_display
)
1935 Atemp
= input_wait_mask
;
1936 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1937 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1939 /* It's okay for us to do this and then continue with
1940 the loop, since timeout has already been zeroed out. */
1941 clear_waiting_for_input ();
1946 /* Don't wait for output from a non-running process. */
1947 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1948 update_status (wait_proc
);
1950 && ! EQ (wait_proc
->status
, Qrun
))
1952 clear_waiting_for_input ();
1956 /* Wait till there is something to do */
1958 Available
= input_wait_mask
;
1959 if (! XINT (read_kbd
) && wait_for_cell
== 0)
1960 FD_CLR (keyboard_descriptor
, &Available
);
1962 /* If frame size has changed or the window is newly mapped,
1963 redisplay now, before we start to wait. There is a race
1964 condition here; if a SIGIO arrives between now and the select
1965 and indicates that a frame is trashed, the select may block
1966 displaying a trashed screen. */
1967 if (frame_garbaged
&& do_display
)
1968 redisplay_preserve_echo_area ();
1970 if (XINT (read_kbd
) && detect_input_pending ())
1973 FD_ZERO (&Available
);
1976 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1980 /* Make C-g and alarm signals set flags again */
1981 clear_waiting_for_input ();
1983 /* If we woke up due to SIGWINCH, actually change size now. */
1984 do_pending_window_change ();
1986 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1990 if (xerrno
== EINTR
)
1991 FD_ZERO (&Available
);
1993 /* Ultrix select seems to return ENOMEM when it is
1994 interrupted. Treat it just like EINTR. Bleah. Note
1995 that we want to test for the "ultrix" CPP symbol, not
1996 "__ultrix__"; the latter is only defined under GCC, but
1997 not by DEC's bundled CC. -JimB */
1998 else if (xerrno
== ENOMEM
)
1999 FD_ZERO (&Available
);
2002 /* This happens for no known reason on ALLIANT.
2003 I am guessing that this is the right response. -- RMS. */
2004 else if (xerrno
== EFAULT
)
2005 FD_ZERO (&Available
);
2007 else if (xerrno
== EBADF
)
2010 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
2011 the child's closure of the pts gives the parent a SIGHUP, and
2012 the ptc file descriptor is automatically closed,
2013 yielding EBADF here or at select() call above.
2014 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
2015 in m/ibmrt-aix.h), and here we just ignore the select error.
2016 Cleanup occurs c/o status_notify after SIGCLD. */
2017 FD_ZERO (&Available
); /* Cannot depend on values returned */
2023 error("select error: %s", strerror (xerrno
));
2025 #if defined(sun) && !defined(USG5_4)
2026 else if (nfds
> 0 && FD_ISSET (keyboard_descriptor
, &Available
)
2028 /* System sometimes fails to deliver SIGIO.
2030 David J. Mackenzie says that Emacs doesn't compile under
2031 Solaris if this code is enabled, thus the USG5_4 in the CPP
2032 conditional. "I haven't noticed any ill effects so far.
2033 If you find a Solaris expert somewhere, they might know
2035 kill (getpid (), SIGIO
);
2038 /* Check for keyboard input */
2039 /* If there is any, return immediately
2040 to give it higher priority than subprocesses */
2042 /* We used to do this if wait_for_cell,
2043 but that caused infinite recursion in selection request events. */
2044 if ((XINT (read_kbd
) || wait_for_cell
)
2045 && detect_input_pending ())
2048 if (detect_input_pending ())
2052 /* Exit now if the cell we're waiting for became non-nil. */
2053 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
2057 /* If we think we have keyboard input waiting, but didn't get SIGIO
2058 go read it. This can happen with X on BSD after logging out.
2059 In that case, there really is no input and no SIGIO,
2060 but select says there is input. */
2062 if (XINT (read_kbd
) && interrupt_input
2063 && (FD_ISSET (keyboard_descriptor
, &Available
)))
2068 got_some_input
|= nfds
> 0;
2070 /* If checking input just got us a size-change event from X,
2071 obey it now if we should. */
2072 if (XINT (read_kbd
) || wait_for_cell
)
2073 do_pending_window_change ();
2075 /* Check for data from a process. */
2076 /* Really FIRST_PROC_DESC should be 0 on Unix,
2077 but this is safer in the short run. */
2078 for (channel
= keyboard_descriptor
== 0 ? FIRST_PROC_DESC
: 0;
2079 channel
<= max_process_desc
; channel
++)
2081 if (FD_ISSET (channel
, &Available
))
2085 /* If waiting for this channel, arrange to return as
2086 soon as no more input to be processed. No more
2088 if (wait_channel
== channel
)
2094 proc
= chan_process
[channel
];
2098 /* Read data from the process, starting with our
2099 buffered-ahead character if we have one. */
2101 nread
= read_process_output (proc
, channel
);
2104 /* Since read_process_output can run a filter,
2105 which can call accept-process-output,
2106 don't try to read from any other processes
2107 before doing the select again. */
2108 FD_ZERO (&Available
);
2111 redisplay_preserve_echo_area ();
2114 else if (nread
== -1 && errno
== EWOULDBLOCK
)
2118 else if (nread
== -1 && errno
== EAGAIN
)
2122 else if (nread
== -1 && errno
== EAGAIN
)
2124 /* Note that we cannot distinguish between no input
2125 available now and a closed pipe.
2126 With luck, a closed pipe will be accompanied by
2127 subprocess termination and SIGCHLD. */
2128 else if (nread
== 0 && !NETCONN_P (proc
))
2130 #endif /* O_NDELAY */
2131 #endif /* O_NONBLOCK */
2132 #endif /* EWOULDBLOCK */
2134 /* On some OSs with ptys, when the process on one end of
2135 a pty exits, the other end gets an error reading with
2136 errno = EIO instead of getting an EOF (0 bytes read).
2137 Therefore, if we get an error reading and errno =
2138 EIO, just continue, because the child process has
2139 exited and should clean itself up soon (e.g. when we
2141 else if (nread
== -1 && errno
== EIO
)
2143 #endif /* HAVE_PTYS */
2144 /* If we can detect process termination, don't consider the process
2145 gone just because its pipe is closed. */
2147 else if (nread
== 0 && !NETCONN_P (proc
))
2152 /* Preserve status of processes already terminated. */
2153 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2154 deactivate_process (proc
);
2155 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2156 update_status (XPROCESS (proc
));
2157 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2158 XPROCESS (proc
)->status
2159 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2162 } /* end for each file descriptor */
2163 } /* end while exit conditions not met */
2165 waiting_for_user_input_p
= 0;
2167 /* If calling from keyboard input, do not quit
2168 since we want to return C-g as an input character.
2169 Otherwise, do pending quit if requested. */
2170 if (XINT (read_kbd
) >= 0)
2172 /* Prevent input_pending from remaining set if we quit. */
2173 clear_input_pending ();
2177 return got_some_input
;
2180 /* Read pending output from the process channel,
2181 starting with our buffered-ahead character if we have one.
2182 Yield number of characters read.
2184 This function reads at most 1024 characters.
2185 If you want to read all available subprocess output,
2186 you must call it repeatedly until it returns zero. */
2188 read_process_output (proc
, channel
)
2190 register int channel
;
2192 register int nchars
;
2198 register Lisp_Object outstream
;
2199 register struct buffer
*old
= current_buffer
;
2200 register struct Lisp_Process
*p
= XPROCESS (proc
);
2201 register int opoint
;
2204 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2206 vs
= get_vms_process_pointer (p
->pid
);
2210 return(0); /* Really weird if it does this */
2211 if (!(vs
->iosb
[0] & 1))
2212 return -1; /* I/O error */
2215 error ("Could not get VMS process pointer");
2216 chars
= vs
->inputBuffer
;
2217 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2220 start_vms_process_read (vs
); /* Crank up the next read on the process */
2221 return 1; /* Nothing worth printing, say we got 1 */
2225 if (proc_buffered_char
[channel
] < 0)
2226 nchars
= read (channel
, chars
, sizeof chars
);
2229 chars
[0] = proc_buffered_char
[channel
];
2230 proc_buffered_char
[channel
] = -1;
2231 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2235 nchars
= nchars
+ 1;
2237 #endif /* not VMS */
2239 if (nchars
<= 0) return nchars
;
2241 outstream
= p
->filter
;
2242 if (!NILP (outstream
))
2244 /* We inhibit quit here instead of just catching it so that
2245 hitting ^G when a filter happens to be running won't screw
2247 int count
= specpdl_ptr
- specpdl
;
2248 Lisp_Object odeactivate
;
2249 Lisp_Object obuffer
;
2251 odeactivate
= Vdeactivate_mark
;
2252 obuffer
= Fcurrent_buffer ();
2254 specbind (Qinhibit_quit
, Qt
);
2255 specbind (Qlast_nonmenu_event
, Qt
);
2256 call2 (outstream
, proc
, make_string (chars
, nchars
));
2258 /* Handling the process output should not deactivate the mark. */
2259 Vdeactivate_mark
= odeactivate
;
2261 if (! EQ (Fcurrent_buffer (), obuffer
))
2262 record_asynch_buffer_change ();
2264 if (waiting_for_user_input_p
)
2265 prepare_menu_bars ();
2268 start_vms_process_read (vs
);
2270 unbind_to (count
, Qnil
);
2274 /* If no filter, write into buffer if it isn't dead. */
2275 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2277 Lisp_Object old_read_only
;
2278 Lisp_Object old_begv
, old_zv
;
2279 Lisp_Object odeactivate
;
2281 odeactivate
= Vdeactivate_mark
;
2283 Fset_buffer (p
->buffer
);
2285 old_read_only
= current_buffer
->read_only
;
2286 XFASTINT (old_begv
) = BEGV
;
2287 XFASTINT (old_zv
) = ZV
;
2289 current_buffer
->read_only
= Qnil
;
2291 /* Insert new output into buffer
2292 at the current end-of-output marker,
2293 thus preserving logical ordering of input and output. */
2294 if (XMARKER (p
->mark
)->buffer
)
2295 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2299 /* If the output marker is outside of the visible region, save
2300 the restriction and widen. */
2301 if (! (BEGV
<= point
&& point
<= ZV
))
2304 /* Make sure opoint floats ahead of any new text, just as point
2306 if (point
<= opoint
)
2309 /* Insert after old_begv, but before old_zv. */
2310 if (point
< XFASTINT (old_begv
))
2311 XFASTINT (old_begv
) += nchars
;
2312 if (point
<= XFASTINT (old_zv
))
2313 XFASTINT (old_zv
) += nchars
;
2315 /* Insert before markers in case we are inserting where
2316 the buffer's mark is, and the user's next command is Meta-y. */
2317 insert_before_markers (chars
, nchars
);
2318 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2320 update_mode_lines
++;
2322 /* If the restriction isn't what it should be, set it. */
2323 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2324 Fnarrow_to_region (old_begv
, old_zv
);
2326 /* Handling the process output should not deactivate the mark. */
2327 Vdeactivate_mark
= odeactivate
;
2329 current_buffer
->read_only
= old_read_only
;
2331 set_buffer_internal (old
);
2334 start_vms_process_read (vs
);
2339 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2341 "Returns non-nil if emacs is waiting for input from the user.\n\
2342 This is intended for use by asynchronous process output filters and sentinels.")
2345 return (waiting_for_user_input_p
? Qt
: Qnil
);
2348 /* Sending data to subprocess */
2350 jmp_buf send_process_frame
;
2353 send_process_trap ()
2359 longjmp (send_process_frame
, 1);
2362 /* Send some data to process PROC.
2363 BUF is the beginning of the data; LEN is the number of characters.
2364 OBJECT is the Lisp object that the data comes from. */
2366 send_process (proc
, buf
, len
, object
)
2372 /* Don't use register vars; longjmp can lose them. */
2374 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2377 struct Lisp_Process
*p
= XPROCESS (proc
);
2378 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2381 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2382 update_status (XPROCESS (proc
));
2383 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2384 error ("Process %s not running", procname
);
2387 vs
= get_vms_process_pointer (p
->pid
);
2389 error ("Could not find this process: %x", p
->pid
);
2390 else if (write_to_vms_process (vs
, buf
, len
))
2394 if (pty_max_bytes
== 0)
2396 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2397 pty_max_bytes
= fpathconf (XFASTINT (XPROCESS (proc
)->outfd
),
2399 if (pty_max_bytes
< 0)
2400 pty_max_bytes
= 250;
2402 pty_max_bytes
= 250;
2404 /* Deduct one, to leave space for the eof. */
2408 if (!setjmp (send_process_frame
))
2412 SIGTYPE (*old_sigpipe
)();
2415 /* Decide how much data we can send in one batch.
2416 Long lines need to be split into multiple batches. */
2417 if (!NILP (XPROCESS (proc
)->pty_flag
))
2419 /* Starting this at zero is always correct when not the first iteration
2420 because the previous iteration ended by sending C-d.
2421 It may not be correct for the first iteration
2422 if a partial line was sent in a separate send_process call.
2423 If that proves worth handling, we need to save linepos
2424 in the process object. */
2427 char *end
= buf
+ len
;
2429 /* Scan through this text for a line that is too long. */
2430 while (ptr
!= end
&& linepos
< pty_max_bytes
)
2438 /* If we found one, break the line there
2439 and put in a C-d to force the buffer through. */
2443 /* Send this batch, using one or more write calls. */
2446 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2447 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
2448 signal (SIGPIPE
, old_sigpipe
);
2454 || errno
== EWOULDBLOCK
2460 /* Buffer is full. Wait, accepting input;
2461 that may allow the program
2462 to finish doing output and read more. */
2467 /* Running filters might relocate buffers or strings.
2468 Arrange to relocate BUF. */
2469 if (BUFFERP (object
))
2470 offset
= BUF_PTR_CHAR_POS (XBUFFER (object
),
2471 (unsigned char *) buf
);
2472 else if (STRINGP (object
))
2473 offset
= buf
- (char *) XSTRING (object
)->data
;
2475 XFASTINT (zero
) = 0;
2476 wait_reading_process_input (1, 0, zero
, 0);
2478 if (BUFFERP (object
))
2479 buf
= (char *) BUF_CHAR_ADDRESS (XBUFFER (object
), offset
);
2480 else if (STRINGP (object
))
2481 buf
= offset
+ (char *) XSTRING (object
)->data
;
2486 /* This is a real error. */
2487 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2494 /* If we sent just part of the string, put in an EOF
2495 to force it through, before we send the rest. */
2497 Fprocess_send_eof (proc
);
2502 XPROCESS (proc
)->raw_status_low
= Qnil
;
2503 XPROCESS (proc
)->raw_status_high
= Qnil
;
2504 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2505 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2506 deactivate_process (proc
);
2508 error ("Error writing to process %s; closed it", procname
);
2510 error ("SIGPIPE raised on process %s; closed it", procname
);
2515 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2517 "Send current contents of region as input to PROCESS.\n\
2518 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2519 nil, indicating the current buffer's process.\n\
2520 Called from program, takes three arguments, PROCESS, START and END.\n\
2521 If the region is more than 500 characters long,\n\
2522 it is sent in several bunches. This may happen even for shorter regions.\n\
2523 Output from processes can arrive in between bunches.")
2524 (process
, start
, end
)
2525 Lisp_Object process
, start
, end
;
2530 proc
= get_process (process
);
2531 validate_region (&start
, &end
);
2533 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2536 start1
= XINT (start
);
2537 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
),
2538 Fcurrent_buffer ());
2543 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2545 "Send PROCESS the contents of STRING as input.\n\
2546 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2547 nil, indicating the current buffer's process.\n\
2548 If STRING is more than 500 characters long,\n\
2549 it is sent in several bunches. This may happen even for shorter strings.\n\
2550 Output from processes can arrive in between bunches.")
2552 Lisp_Object process
, string
;
2555 CHECK_STRING (string
, 1);
2556 proc
= get_process (process
);
2557 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
, string
);
2561 /* send a signal number SIGNO to PROCESS.
2562 CURRENT_GROUP means send to the process group that currently owns
2563 the terminal being used to communicate with PROCESS.
2564 This is used for various commands in shell mode.
2565 If NOMSG is zero, insert signal-announcements into process's buffers
2568 If we can, we try to signal PROCESS by sending control characters
2569 down the pty. This allows us to signal inferiors who have changed
2570 their uid, for which killpg would return an EPERM error. */
2573 process_send_signal (process
, signo
, current_group
, nomsg
)
2574 Lisp_Object process
;
2576 Lisp_Object current_group
;
2580 register struct Lisp_Process
*p
;
2584 proc
= get_process (process
);
2585 p
= XPROCESS (proc
);
2587 if (!EQ (p
->childp
, Qt
))
2588 error ("Process %s is not a subprocess",
2589 XSTRING (p
->name
)->data
);
2590 if (XINT (p
->infd
) < 0)
2591 error ("Process %s is not active",
2592 XSTRING (p
->name
)->data
);
2594 if (NILP (p
->pty_flag
))
2595 current_group
= Qnil
;
2597 /* If we are using pgrps, get a pgrp number and make it negative. */
2598 if (!NILP (current_group
))
2600 #ifdef SIGNALS_VIA_CHARACTERS
2601 /* If possible, send signals to the entire pgrp
2602 by sending an input character to it. */
2604 /* TERMIOS is the latest and bestest, and seems most likely to
2605 work. If the system has it, use it. */
2612 tcgetattr (XINT (p
->infd
), &t
);
2613 send_process (proc
, &t
.c_cc
[VINTR
], 1, Qnil
);
2617 tcgetattr (XINT (p
->infd
), &t
);
2618 send_process (proc
, &t
.c_cc
[VQUIT
], 1, Qnil
);
2622 tcgetattr (XINT (p
->infd
), &t
);
2623 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
2624 send_process (proc
, &t
.c_cc
[VSWTCH
], 1, Qnil
);
2626 send_process (proc
, &t
.c_cc
[VSUSP
], 1, Qnil
);
2631 #else /* ! HAVE_TERMIOS */
2633 /* On Berkeley descendants, the following IOCTL's retrieve the
2634 current control characters. */
2635 #if defined (TIOCGLTC) && defined (TIOCGETC)
2643 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2644 send_process (proc
, &c
.t_intrc
, 1, Qnil
);
2647 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2648 send_process (proc
, &c
.t_quitc
, 1, Qnil
);
2652 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
2653 send_process (proc
, &lc
.t_suspc
, 1, Qnil
);
2655 #endif /* ! defined (SIGTSTP) */
2658 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2660 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2667 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2668 send_process (proc
, &t
.c_cc
[VINTR
], 1, Qnil
);
2671 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2672 send_process (proc
, &t
.c_cc
[VQUIT
], 1, Qnil
);
2676 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2677 send_process (proc
, &t
.c_cc
[VSWTCH
], 1, Qnil
);
2679 #endif /* ! defined (SIGTSTP) */
2681 #else /* ! defined (TCGETA) */
2682 Your configuration files are messed up
.
2683 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2684 you'd better be using one of the alternatives above! */
2685 #endif /* ! defined (TCGETA) */
2686 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2687 #endif /* ! defined HAVE_TERMIOS */
2688 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2691 /* Get the pgrp using the tty itself, if we have that.
2692 Otherwise, use the pty to get the pgrp.
2693 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2694 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2695 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2696 His patch indicates that if TIOCGPGRP returns an error, then
2697 we should just assume that p->pid is also the process group id. */
2701 if (!NILP (p
->subtty
))
2702 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2704 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
2708 gid
= - XFASTINT (p
->pid
);
2709 #endif /* ! defined (pfa) */
2715 #else /* ! defined (TIOCGPGRP ) */
2716 /* Can't select pgrps on this system, so we know that
2717 the child itself heads the pgrp. */
2718 gid
= - XFASTINT (p
->pid
);
2719 #endif /* ! defined (TIOCGPGRP ) */
2722 gid
= - XFASTINT (p
->pid
);
2728 p
->raw_status_low
= Qnil
;
2729 p
->raw_status_high
= Qnil
;
2731 XSETINT (p
->tick
, ++process_tick
);
2735 #endif /* ! defined (SIGCONT) */
2738 send_process (proc
, "\003", 1, Qnil
); /* ^C */
2743 send_process (proc
, "\031", 1, Qnil
); /* ^Y */
2748 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2751 flush_pending_output (XINT (p
->infd
));
2755 /* If we don't have process groups, send the signal to the immediate
2756 subprocess. That isn't really right, but it's better than any
2757 obvious alternative. */
2760 kill (XFASTINT (p
->pid
), signo
);
2764 /* gid may be a pid, or minus a pgrp's number */
2766 if (!NILP (current_group
))
2767 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
2770 gid
= - XFASTINT (p
->pid
);
2773 #else /* ! defined (TIOCSIGSEND) */
2774 EMACS_KILLPG (-gid
, signo
);
2775 #endif /* ! defined (TIOCSIGSEND) */
2778 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2779 "Interrupt process PROCESS. May be process or name of one.\n\
2780 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2781 nil or no arg means current buffer's process.\n\
2782 Second arg CURRENT-GROUP non-nil means send signal to\n\
2783 the current process-group of the process's controlling terminal\n\
2784 rather than to the process's own process group.\n\
2785 If the process is a shell, this means interrupt current subjob\n\
2786 rather than the shell.")
2787 (process
, current_group
)
2788 Lisp_Object process
, current_group
;
2790 process_send_signal (process
, SIGINT
, current_group
, 0);
2794 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2795 "Kill process PROCESS. May be process or name of one.\n\
2796 See function `interrupt-process' for more details on usage.")
2797 (process
, current_group
)
2798 Lisp_Object process
, current_group
;
2800 process_send_signal (process
, SIGKILL
, current_group
, 0);
2804 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2805 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2806 See function `interrupt-process' for more details on usage.")
2807 (process
, current_group
)
2808 Lisp_Object process
, current_group
;
2810 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2814 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2815 "Stop process PROCESS. May be process or name of one.\n\
2816 See function `interrupt-process' for more details on usage.")
2817 (process
, current_group
)
2818 Lisp_Object process
, current_group
;
2821 error ("no SIGTSTP support");
2823 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2828 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2829 "Continue process PROCESS. May be process or name of one.\n\
2830 See function `interrupt-process' for more details on usage.")
2831 (process
, current_group
)
2832 Lisp_Object process
, current_group
;
2835 process_send_signal (process
, SIGCONT
, current_group
, 0);
2837 error ("no SIGCONT support");
2842 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2843 2, 2, "nProcess number: \nnSignal code: ",
2844 "Send the process with number PID the signal with code CODE.\n\
2845 Both PID and CODE are integers.")
2847 Lisp_Object pid
, sig
;
2849 CHECK_NUMBER (pid
, 0);
2850 CHECK_NUMBER (sig
, 1);
2851 return make_number (kill (XINT (pid
), XINT (sig
)));
2854 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2855 "Make PROCESS see end-of-file in its input.\n\
2856 Eof comes after any text already sent to it.\n\
2857 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2858 nil, indicating the current buffer's process.\n\
2859 If PROCESS is a network connection, or is a process communicating\n\
2860 through a pipe (as opposed to a pty), then you cannot send any more\n\
2861 text to PROCESS after you call this function.")
2863 Lisp_Object process
;
2867 proc
= get_process (process
);
2869 /* Make sure the process is really alive. */
2870 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2871 update_status (XPROCESS (proc
));
2872 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2873 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2875 /* Sending a zero-length record is supposed to mean eof
2876 when TIOCREMOTE is turned on. */
2880 write (XINT (XPROCESS (proc
)->outfd
), buf
, 0);
2882 #else /* did not do TOICREMOTE */
2884 send_process (proc
, "\032", 1, Qnil
); /* ^z */
2886 if (!NILP (XPROCESS (proc
)->pty_flag
))
2887 send_process (proc
, "\004", 1, Qnil
);
2890 close (XINT (XPROCESS (proc
)->outfd
));
2891 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, open (NULL_DEVICE
, O_WRONLY
));
2894 #endif /* did not do TOICREMOTE */
2898 /* Kill all processes associated with `buffer'.
2899 If `buffer' is nil, kill all processes */
2901 kill_buffer_processes (buffer
)
2904 Lisp_Object tail
, proc
;
2906 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2907 tail
= XCONS (tail
)->cdr
)
2909 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2910 if (XGCTYPE (proc
) == Lisp_Process
2911 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2913 if (NETCONN_P (proc
))
2914 Fdelete_process (proc
);
2915 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
2916 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2921 /* On receipt of a signal that a child status has changed,
2922 loop asking about children with changed statuses until
2923 the system says there are no more.
2924 All we do is change the status;
2925 we do not run sentinels or print notifications.
2926 That is saved for the next time keyboard input is done,
2927 in order to avoid timing errors. */
2929 /** WARNING: this can be called during garbage collection.
2930 Therefore, it must not be fooled by the presence of mark bits in
2933 /** USG WARNING: Although it is not obvious from the documentation
2934 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2935 signal() before executing at least one wait(), otherwise the handler
2936 will be called again, resulting in an infinite loop. The relevant
2937 portion of the documentation reads "SIGCLD signals will be queued
2938 and the signal-catching function will be continually reentered until
2939 the queue is empty". Invoking signal() causes the kernel to reexamine
2940 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2943 sigchld_handler (signo
)
2946 int old_errno
= errno
;
2948 register struct Lisp_Process
*p
;
2949 extern EMACS_TIME
*input_available_clear_time
;
2953 sigheld
|= sigbit (SIGCHLD
);
2965 #endif /* no WUNTRACED */
2966 /* Keep trying to get a status until we get a definitive result. */
2970 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2972 while (pid
<= 0 && errno
== EINTR
);
2976 /* A real failure. We have done all our job, so return. */
2978 /* USG systems forget handlers when they are used;
2979 must reestablish each time */
2981 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2984 sigheld
&= ~sigbit (SIGCHLD
);
2992 #endif /* no WNOHANG */
2994 /* Find the process that signaled us, and record its status. */
2997 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2999 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
3000 p
= XPROCESS (proc
);
3001 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
3006 /* Look for an asynchronous process whose pid hasn't been filled
3009 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
3011 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
3012 p
= XPROCESS (proc
);
3013 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
3018 /* Change the status of the process that was found. */
3021 union { int i
; WAITTYPE wt
; } u
;
3023 XSETINT (p
->tick
, ++process_tick
);
3025 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
3026 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
3028 /* If process has terminated, stop waiting for its output. */
3029 if (WIFSIGNALED (w
) || WIFEXITED (w
))
3030 if (XINT (p
->infd
) >= 0)
3031 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
3033 /* Tell wait_reading_process_input that it needs to wake up and
3035 if (input_available_clear_time
)
3036 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
3039 /* There was no asynchronous process found for that id. Check
3040 if we have a synchronous process. */
3043 synch_process_alive
= 0;
3045 /* Report the status of the synchronous process. */
3047 synch_process_retcode
= WRETCODE (w
);
3048 else if (WIFSIGNALED (w
))
3050 int code
= WTERMSIG (w
);
3056 signame
= sys_siglist
[code
];
3058 signame
= sys_errlist
[code
];
3062 signame
= "unknown";
3064 synch_process_death
= signame
;
3067 /* Tell wait_reading_process_input that it needs to wake up and
3069 if (input_available_clear_time
)
3070 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
3073 /* On some systems, we must return right away.
3074 If any more processes want to signal us, we will
3076 Otherwise (on systems that have WNOHANG), loop around
3077 to use up all the processes that have something to tell us. */
3078 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
3080 signal (signo
, sigchld_handler
);
3084 #endif /* USG, but not HPUX with WNOHANG */
3090 exec_sentinel_unwind (data
)
3093 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
3098 exec_sentinel (proc
, reason
)
3099 Lisp_Object proc
, reason
;
3101 Lisp_Object sentinel
, obuffer
, odeactivate
;
3102 register struct Lisp_Process
*p
= XPROCESS (proc
);
3103 int count
= specpdl_ptr
- specpdl
;
3105 odeactivate
= Vdeactivate_mark
;
3106 obuffer
= Fcurrent_buffer ();
3107 sentinel
= p
->sentinel
;
3108 if (NILP (sentinel
))
3111 /* Zilch the sentinel while it's running, to avoid recursive invocations;
3112 assure that it gets restored no matter how the sentinel exits. */
3114 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
3115 /* Inhibit quit so that random quits don't screw up a running filter. */
3116 specbind (Qinhibit_quit
, Qt
);
3117 specbind (Qlast_nonmenu_event
, Qt
);
3118 call2 (sentinel
, proc
, reason
);
3120 Vdeactivate_mark
= odeactivate
;
3121 if (! EQ (Fcurrent_buffer (), obuffer
))
3122 record_asynch_buffer_change ();
3124 if (waiting_for_user_input_p
)
3125 prepare_menu_bars ();
3126 unbind_to (count
, Qnil
);
3129 /* Report all recent events of a change in process status
3130 (either run the sentinel or output a message).
3131 This is done while Emacs is waiting for keyboard input. */
3135 register Lisp_Object proc
, buffer
;
3136 Lisp_Object tail
, msg
;
3137 struct gcpro gcpro1
, gcpro2
;
3141 /* We need to gcpro tail; if read_process_output calls a filter
3142 which deletes a process and removes the cons to which tail points
3143 from Vprocess_alist, and then causes a GC, tail is an unprotected
3147 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
3150 register struct Lisp_Process
*p
;
3152 proc
= Fcdr (Fcar (tail
));
3153 p
= XPROCESS (proc
);
3155 if (XINT (p
->tick
) != XINT (p
->update_tick
))
3157 XSETINT (p
->update_tick
, XINT (p
->tick
));
3159 /* If process is still active, read any output that remains. */
3160 if (XINT (p
->infd
) >= 0)
3161 while (! EQ (p
->filter
, Qt
)
3162 && read_process_output (proc
, XINT (p
->infd
)) > 0);
3166 /* Get the text to use for the message. */
3167 if (!NILP (p
->raw_status_low
))
3169 msg
= status_message (p
->status
);
3171 /* If process is terminated, deactivate it or delete it. */
3173 if (XTYPE (p
->status
) == Lisp_Cons
)
3174 symbol
= XCONS (p
->status
)->car
;
3176 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
3177 || EQ (symbol
, Qclosed
))
3179 if (delete_exited_processes
)
3180 remove_process (proc
);
3182 deactivate_process (proc
);
3185 /* Now output the message suitably. */
3186 if (!NILP (p
->sentinel
))
3187 exec_sentinel (proc
, msg
);
3188 /* Don't bother with a message in the buffer
3189 when a process becomes runnable. */
3190 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
3192 Lisp_Object ro
, tem
;
3193 struct buffer
*old
= current_buffer
;
3196 ro
= XBUFFER (buffer
)->read_only
;
3198 /* Avoid error if buffer is deleted
3199 (probably that's why the process is dead, too) */
3200 if (NILP (XBUFFER (buffer
)->name
))
3202 Fset_buffer (buffer
);
3204 /* Insert new output into buffer
3205 at the current end-of-output marker,
3206 thus preserving logical ordering of input and output. */
3207 if (XMARKER (p
->mark
)->buffer
)
3208 SET_PT (marker_position (p
->mark
));
3211 if (point
<= opoint
)
3212 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
3214 tem
= current_buffer
->read_only
;
3215 current_buffer
->read_only
= Qnil
;
3216 insert_string ("\nProcess ");
3217 Finsert (1, &p
->name
);
3218 insert_string (" ");
3220 current_buffer
->read_only
= tem
;
3221 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
3224 set_buffer_internal (old
);
3229 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
3230 redisplay_preserve_echo_area ();
3232 update_tick
= process_tick
;
3243 if (! noninteractive
|| initialized
)
3245 signal (SIGCHLD
, sigchld_handler
);
3248 FD_ZERO (&input_wait_mask
);
3249 max_process_desc
= 0;
3251 keyboard_descriptor
= 0;
3252 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3254 Vprocess_alist
= Qnil
;
3255 for (i
= 0; i
< MAXDESC
; i
++)
3257 chan_process
[i
] = Qnil
;
3258 proc_buffered_char
[i
] = -1;
3262 /* From now on, assume keyboard input comes from descriptor DESC. */
3265 change_keyboard_wait_descriptor (desc
)
3268 FD_CLR (keyboard_descriptor
, &input_wait_mask
);
3269 keyboard_descriptor
= desc
;
3270 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3276 stream_process
= intern ("stream");
3278 Qprocessp
= intern ("processp");
3279 staticpro (&Qprocessp
);
3280 Qrun
= intern ("run");
3282 Qstop
= intern ("stop");
3284 Qsignal
= intern ("signal");
3285 staticpro (&Qsignal
);
3287 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3290 Qexit = intern ("exit");
3291 staticpro (&Qexit); */
3293 Qopen
= intern ("open");
3295 Qclosed
= intern ("closed");
3296 staticpro (&Qclosed
);
3298 Qlast_nonmenu_event
= intern ("last-nonmenu-event");
3299 staticpro (&Qlast_nonmenu_event
);
3301 staticpro (&Vprocess_alist
);
3303 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3304 "*Non-nil means delete processes immediately when they exit.\n\
3305 nil means don't delete them until `list-processes' is run.");
3307 delete_exited_processes
= 1;
3309 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3310 "Control type of device used to communicate with subprocesses.\n\
3311 Values are nil to use a pipe, or t or `pty' to use a pty.\n\
3312 The value has no effect if the system has no ptys or if all ptys are busy:\n\
3313 then a pipe is used in any case.\n\
3314 The value takes effect when `start-process' is called.");
3315 Vprocess_connection_type
= Qt
;
3317 defsubr (&Sprocessp
);
3318 defsubr (&Sget_process
);
3319 defsubr (&Sget_buffer_process
);
3320 defsubr (&Sdelete_process
);
3321 defsubr (&Sprocess_status
);
3322 defsubr (&Sprocess_exit_status
);
3323 defsubr (&Sprocess_id
);
3324 defsubr (&Sprocess_name
);
3325 defsubr (&Sprocess_command
);
3326 defsubr (&Sset_process_buffer
);
3327 defsubr (&Sprocess_buffer
);
3328 defsubr (&Sprocess_mark
);
3329 defsubr (&Sset_process_filter
);
3330 defsubr (&Sprocess_filter
);
3331 defsubr (&Sset_process_sentinel
);
3332 defsubr (&Sset_process_window_size
);
3333 defsubr (&Sprocess_sentinel
);
3334 defsubr (&Sprocess_kill_without_query
);
3335 defsubr (&Slist_processes
);
3336 defsubr (&Sprocess_list
);
3337 defsubr (&Sstart_process
);
3339 defsubr (&Sopen_network_stream
);
3340 #endif /* HAVE_SOCKETS */
3341 defsubr (&Saccept_process_output
);
3342 defsubr (&Sprocess_send_region
);
3343 defsubr (&Sprocess_send_string
);
3344 defsubr (&Sinterrupt_process
);
3345 defsubr (&Skill_process
);
3346 defsubr (&Squit_process
);
3347 defsubr (&Sstop_process
);
3348 defsubr (&Scontinue_process
);
3349 defsubr (&Sprocess_send_eof
);
3350 defsubr (&Ssignal_process
);
3351 defsubr (&Swaiting_for_user_input_p
);
3352 /* defsubr (&Sprocess_connection); */
3356 #else /* not subprocesses */
3358 #include <sys/types.h>
3362 #include "systime.h"
3363 #include "termopts.h"
3365 extern int frame_garbaged
;
3368 /* As described above, except assuming that there are no subprocesses:
3370 Wait for timeout to elapse and/or keyboard input to be available.
3373 timeout in seconds, or
3374 zero for no limit, or
3375 -1 means gobble data immediately available but don't wait for any.
3377 read_kbd is a Lisp_Object:
3378 0 to ignore keyboard input, or
3379 1 to return when input is available, or
3380 -1 means caller will actually read the input, so don't throw to
3382 We know that read_kbd will never be a Lisp_Process, since
3383 `subprocesses' isn't defined.
3385 do_display != 0 means redisplay should be done to show subprocess
3386 output that arrives.
3388 Return true iff we received input from any process. */
3391 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3392 int time_limit
, microsecs
;
3393 Lisp_Object read_kbd
;
3396 EMACS_TIME end_time
, timeout
, *timeout_p
;
3399 /* What does time_limit really mean? */
3400 if (time_limit
|| microsecs
)
3402 /* It's not infinite. */
3403 timeout_p
= &timeout
;
3405 if (time_limit
== -1)
3406 /* In fact, it's zero. */
3407 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3409 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3411 /* How far in the future is that? */
3412 EMACS_GET_TIME (end_time
);
3413 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3416 /* It's infinite. */
3419 /* This must come before stop_polling. */
3420 prepare_menu_bars ();
3422 /* Turn off periodic alarms (in case they are in use)
3423 because the select emulator uses alarms. */
3430 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3432 /* If calling from keyboard input, do not quit
3433 since we want to return C-g as an input character.
3434 Otherwise, do pending quit if requested. */
3435 if (XINT (read_kbd
) >= 0)
3440 EMACS_GET_TIME (*timeout_p
);
3441 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3442 if (EMACS_TIME_NEG_P (*timeout_p
))
3446 /* Cause C-g and alarm signals to take immediate action,
3447 and cause input available signals to zero out timeout. */
3448 if (XINT (read_kbd
) < 0)
3449 set_waiting_for_input (&timeout
);
3451 /* If a frame has been newly mapped and needs updating,
3452 reprocess its display stuff. */
3453 if (frame_garbaged
&& do_display
)
3454 redisplay_preserve_echo_area ();
3456 if (XINT (read_kbd
) && detect_input_pending ())
3459 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3461 /* Make C-g and alarm signals set flags again */
3462 clear_waiting_for_input ();
3464 /* If we woke up due to SIGWINCH, actually change size now. */
3465 do_pending_window_change ();
3469 /* If the system call was interrupted, then go around the
3475 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3476 /* System sometimes fails to deliver SIGIO. */
3477 kill (getpid (), SIGIO
);
3480 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3484 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3496 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3497 /* Don't confuse make-docfile by having two doc strings for this function.
3498 make-docfile does not pay attention to #if, for good reason! */
3501 register Lisp_Object name
;
3506 /* Kill all processes associated with `buffer'.
3507 If `buffer' is nil, kill all processes.
3508 Since we have no subprocesses, this does nothing. */
3510 kill_buffer_processes (buffer
)
3521 defsubr (&Sget_buffer_process
);
3525 #endif /* not subprocesses */