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 /* Descriptor to use for keyboard input. */
219 static int keyboard_descriptor
;
221 /* Nonzero means delete a process right away if it exits. */
222 static int delete_exited_processes
;
224 /* Indexed by descriptor, gives the process (if any) for that descriptor */
225 Lisp_Object chan_process
[MAXDESC
];
227 /* Alist of elements (NAME . PROCESS) */
228 Lisp_Object Vprocess_alist
;
230 /* Buffered-ahead input char from process, indexed by channel.
231 -1 means empty (no char is buffered).
232 Used on sys V where the only way to tell if there is any
233 output from the process is to read at least one char.
234 Always -1 on systems that support FIONREAD. */
236 static int proc_buffered_char
[MAXDESC
];
238 static Lisp_Object
get_process ();
240 /* Maximum number of bytes to send to a pty without an eof. */
241 static int pty_max_bytes
;
243 /* Compute the Lisp form of the process status, p->status, from
244 the numeric status that was returned by `wait'. */
246 Lisp_Object
status_convert ();
249 struct Lisp_Process
*p
;
251 union { int i
; WAITTYPE wt
; } u
;
252 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
253 p
->status
= status_convert (u
.wt
);
254 p
->raw_status_low
= Qnil
;
255 p
->raw_status_high
= Qnil
;
258 /* Convert a process status word in Unix format to
259 the list that we use internally. */
266 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
267 else if (WIFEXITED (w
))
268 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
269 WCOREDUMP (w
) ? Qt
: Qnil
));
270 else if (WIFSIGNALED (w
))
271 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
272 WCOREDUMP (w
) ? Qt
: Qnil
));
277 /* Given a status-list, extract the three pieces of information
278 and store them individually through the three pointers. */
281 decode_status (l
, symbol
, code
, coredump
)
289 if (XTYPE (l
) == Lisp_Symbol
)
297 *symbol
= XCONS (l
)->car
;
298 tem
= XCONS (l
)->cdr
;
299 *code
= XFASTINT (XCONS (tem
)->car
);
300 tem
= XCONS (tem
)->cdr
;
301 *coredump
= !NILP (tem
);
305 /* Return a string describing a process status list. */
308 status_message (status
)
313 Lisp_Object string
, string2
;
315 decode_status (status
, &symbol
, &code
, &coredump
);
317 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
323 signame
= sys_siglist
[code
];
325 signame
= sys_errlist
[code
];
330 string
= build_string (signame
);
331 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
332 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
333 return concat2 (string
, string2
);
335 else if (EQ (symbol
, Qexit
))
338 return build_string ("finished\n");
339 string
= Fnumber_to_string (make_number (code
));
340 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
341 return concat2 (build_string ("exited abnormally with code "),
342 concat2 (string
, string2
));
345 return Fcopy_sequence (Fsymbol_name (symbol
));
350 /* Open an available pty, returning a file descriptor.
351 Return -1 on failure.
352 The file name of the terminal corresponding to the pty
353 is left in the variable pty_name. */
364 /* Some systems name their pseudoterminals so that there are gaps in
365 the usual sequence - for example, on HP9000/S700 systems, there
366 are no pseudoterminals with names ending in 'f'. So we wait for
367 three failures in a row before deciding that we've reached the
369 int failed_count
= 0;
374 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
375 for (i
= 0; i
< 16; i
++)
378 #ifdef PTY_NAME_SPRINTF
381 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
382 #endif /* no PTY_NAME_SPRINTF */
386 #else /* no PTY_OPEN */
388 /* Unusual IRIS code */
389 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
392 if (fstat (fd
, &stb
) < 0)
395 if (stat (pty_name
, &stb
) < 0)
398 if (failed_count
>= 3)
404 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
406 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
408 #endif /* not IRIS */
409 #endif /* no PTY_OPEN */
413 /* check to make certain that both sides are available
414 this avoids a nasty yet stupid bug in rlogins */
415 #ifdef PTY_TTY_NAME_SPRINTF
418 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
419 #endif /* no PTY_TTY_NAME_SPRINTF */
421 if (access (pty_name
, 6) != 0)
424 #if !defined(IRIS) && !defined(__sgi)
430 #endif /* not UNIPLUS */
437 #endif /* HAVE_PTYS */
443 register Lisp_Object val
, tem
, name1
;
444 register struct Lisp_Process
*p
;
448 /* size of process structure includes the vector header,
449 so deduct for that. But struct Lisp_Vector includes the first
450 element, thus deducts too much, so add it back. */
451 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
452 - sizeof (struct Lisp_Vector
)
453 + sizeof (Lisp_Object
))
454 / sizeof (Lisp_Object
)),
456 XSETTYPE (val
, Lisp_Process
);
459 XSET (p
->infd
, Lisp_Int
, -1);
460 XSET (p
->outfd
, Lisp_Int
, -1);
461 XFASTINT (p
->pid
) = 0;
462 XFASTINT (p
->tick
) = 0;
463 XFASTINT (p
->update_tick
) = 0;
464 p
->raw_status_low
= Qnil
;
465 p
->raw_status_high
= Qnil
;
467 p
->mark
= Fmake_marker ();
469 /* If name is already in use, modify it until it is unused. */
474 tem
= Fget_process (name1
);
475 if (NILP (tem
)) break;
476 sprintf (suffix
, "<%d>", i
);
477 name1
= concat2 (name
, build_string (suffix
));
481 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
485 remove_process (proc
)
486 register Lisp_Object proc
;
488 register Lisp_Object pair
;
490 pair
= Frassq (proc
, Vprocess_alist
);
491 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
492 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
494 deactivate_process (proc
);
497 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
498 "Return t if OBJECT is a process.")
502 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
505 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
506 "Return the process named NAME, or nil if there is none.")
508 register Lisp_Object name
;
510 if (XTYPE (name
) == Lisp_Process
)
512 CHECK_STRING (name
, 0);
513 return Fcdr (Fassoc (name
, Vprocess_alist
));
516 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
517 "Return the (or, a) process associated with BUFFER.\n\
518 BUFFER may be a buffer or the name of one.")
520 register Lisp_Object name
;
522 register Lisp_Object buf
, tail
, proc
;
524 if (NILP (name
)) return Qnil
;
525 buf
= Fget_buffer (name
);
526 if (NILP (buf
)) return Qnil
;
528 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
530 proc
= Fcdr (Fcar (tail
));
531 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
537 /* This is how commands for the user decode process arguments. It
538 accepts a process, a process name, a buffer, a buffer name, or nil.
539 Buffers denote the first process in the buffer, and nil denotes the
544 register Lisp_Object name
;
546 register Lisp_Object proc
, obj
;
549 obj
= Fget_process (name
);
551 obj
= Fget_buffer (name
);
553 error ("Process %s does not exist", XSTRING (name
)->data
);
555 else if (NILP (name
))
556 obj
= Fcurrent_buffer ();
560 /* Now obj should be either a buffer object or a process object.
564 proc
= Fget_buffer_process (obj
);
566 error ("Buffer %s has no process", XSTRING (XBUFFER (obj
)->name
)->data
);
570 CHECK_PROCESS (obj
, 0);
576 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
577 "Delete PROCESS: kill it and forget about it immediately.\n\
578 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
579 nil, indicating the current buffer's process.")
581 register Lisp_Object proc
;
583 proc
= get_process (proc
);
584 XPROCESS (proc
)->raw_status_low
= Qnil
;
585 XPROCESS (proc
)->raw_status_high
= Qnil
;
586 if (NETCONN_P (proc
))
588 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
589 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
591 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
593 Fkill_process (proc
, Qnil
);
594 /* Do this now, since remove_process will make sigchld_handler do nothing. */
595 XPROCESS (proc
)->status
596 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
597 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
600 remove_process (proc
);
604 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
605 "Return the status of PROCESS: a symbol, one of these:\n\
606 run -- for a process that is running.\n\
607 stop -- for a process stopped but continuable.\n\
608 exit -- for a process that has exited.\n\
609 signal -- for a process that has got a fatal signal.\n\
610 open -- for a network stream connection that is open.\n\
611 closed -- for a network stream connection that is closed.\n\
612 nil -- if arg is a process name and no such process exists.\n\
613 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
614 nil, indicating the current buffer's process.")
616 register Lisp_Object proc
;
618 register struct Lisp_Process
*p
;
619 register Lisp_Object status
;
620 proc
= get_process (proc
);
624 if (!NILP (p
->raw_status_low
))
627 if (XTYPE (status
) == Lisp_Cons
)
628 status
= XCONS (status
)->car
;
629 if (NETCONN_P (proc
))
631 if (EQ (status
, Qrun
))
633 else if (EQ (status
, Qexit
))
639 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
641 "Return the exit status of PROCESS or the signal number that killed it.\n\
642 If PROCESS has not yet exited or died, return 0.")
644 register Lisp_Object proc
;
646 CHECK_PROCESS (proc
, 0);
647 if (!NILP (XPROCESS (proc
)->raw_status_low
))
648 update_status (XPROCESS (proc
));
649 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
650 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
651 return make_number (0);
654 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
655 "Return the process id of PROCESS.\n\
656 This is the pid of the Unix process which PROCESS uses or talks to.\n\
657 For a network connection, this value is nil.")
659 register Lisp_Object proc
;
661 CHECK_PROCESS (proc
, 0);
662 return XPROCESS (proc
)->pid
;
665 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
666 "Return the name of PROCESS, as a string.\n\
667 This is the name of the program invoked in PROCESS,\n\
668 possibly modified to make it unique among process names.")
670 register Lisp_Object proc
;
672 CHECK_PROCESS (proc
, 0);
673 return XPROCESS (proc
)->name
;
676 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
677 "Return the command that was executed to start PROCESS.\n\
678 This is a list of strings, the first string being the program executed\n\
679 and the rest of the strings being the arguments given to it.\n\
680 For a non-child channel, this is nil.")
682 register Lisp_Object proc
;
684 CHECK_PROCESS (proc
, 0);
685 return XPROCESS (proc
)->command
;
688 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
690 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
692 register Lisp_Object proc
, buffer
;
694 CHECK_PROCESS (proc
, 0);
696 CHECK_BUFFER (buffer
, 1);
697 XPROCESS (proc
)->buffer
= buffer
;
701 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
703 "Return the buffer PROCESS is associated with.\n\
704 Output from PROCESS is inserted in this buffer\n\
705 unless PROCESS has a filter.")
707 register Lisp_Object proc
;
709 CHECK_PROCESS (proc
, 0);
710 return XPROCESS (proc
)->buffer
;
713 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
715 "Return the marker for the end of the last output from PROCESS.")
717 register Lisp_Object proc
;
719 CHECK_PROCESS (proc
, 0);
720 return XPROCESS (proc
)->mark
;
723 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
725 "Give PROCESS the filter function FILTER; nil means no filter.\n\
726 t means stop accepting output from the process.\n\
727 When a process has a filter, each time it does output\n\
728 the entire string of output is passed to the filter.\n\
729 The filter gets two arguments: the process and the string of output.\n\
730 If the process has a filter, its buffer is not used for output.")
732 register Lisp_Object proc
, filter
;
734 CHECK_PROCESS (proc
, 0);
736 FD_CLR (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
737 else if (EQ (XPROCESS (proc
)->filter
, Qt
))
738 FD_SET (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
739 XPROCESS (proc
)->filter
= filter
;
743 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
745 "Returns the filter function of PROCESS; nil if none.\n\
746 See `set-process-filter' for more info on filter functions.")
748 register Lisp_Object proc
;
750 CHECK_PROCESS (proc
, 0);
751 return XPROCESS (proc
)->filter
;
754 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
756 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
757 The sentinel is called as a function when the process changes state.\n\
758 It gets two arguments: the process, and a string describing the change.")
760 register Lisp_Object proc
, sentinel
;
762 CHECK_PROCESS (proc
, 0);
763 XPROCESS (proc
)->sentinel
= sentinel
;
767 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
769 "Return the sentinel of PROCESS; nil if none.\n\
770 See `set-process-sentinel' for more info on sentinels.")
772 register Lisp_Object proc
;
774 CHECK_PROCESS (proc
, 0);
775 return XPROCESS (proc
)->sentinel
;
778 DEFUN ("set-process-window-size", Fset_process_window_size
,
779 Sset_process_window_size
, 3, 3, 0,
780 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
781 (proc
, height
, width
)
782 register Lisp_Object proc
, height
, width
;
784 CHECK_PROCESS (proc
, 0);
785 CHECK_NATNUM (height
, 0);
786 CHECK_NATNUM (width
, 0);
787 if (set_window_size (XINT (XPROCESS (proc
)->infd
),
788 XINT (height
), XINT(width
)) <= 0)
794 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
795 Sprocess_kill_without_query
, 1, 2, 0,
796 "Say no query needed if PROCESS is running when Emacs is exited.\n\
797 Optional second argument if non-nil says to require a query.\n\
798 Value is t if a query was formerly required.")
800 register Lisp_Object proc
, value
;
804 CHECK_PROCESS (proc
, 0);
805 tem
= XPROCESS (proc
)->kill_without_query
;
806 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
811 #if 0 /* Turned off because we don't currently record this info
812 in the process. Perhaps add it. */
813 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
814 "Return the connection type of `PROCESS'.\n\
815 The value is `nil' for a pipe,\n\
816 `t' or `pty' for a pty, or `stream' for a socket connection.")
820 return XPROCESS (process
)->type
;
827 register Lisp_Object tail
, tem
;
828 Lisp_Object proc
, minspace
, tem1
;
829 register struct buffer
*old
= current_buffer
;
830 register struct Lisp_Process
*p
;
834 XFASTINT (minspace
) = 1;
836 set_buffer_internal (XBUFFER (Vstandard_output
));
837 Fbuffer_disable_undo (Vstandard_output
);
839 current_buffer
->truncate_lines
= Qt
;
842 Proc Status Buffer Command\n\
843 ---- ------ ------ -------\n", -1);
845 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
849 proc
= Fcdr (Fcar (tail
));
851 if (NILP (p
->childp
))
854 Finsert (1, &p
->name
);
855 Findent_to (make_number (13), minspace
);
857 if (!NILP (p
->raw_status_low
))
860 if (XTYPE (p
->status
) == Lisp_Cons
)
861 symbol
= XCONS (p
->status
)->car
;
864 if (EQ (symbol
, Qsignal
))
867 tem
= Fcar (Fcdr (p
->status
));
869 if (XINT (tem
) < NSIG
)
870 write_string (sys_errlist
[XINT (tem
)], -1);
873 Fprinc (symbol
, Qnil
);
875 else if (NETCONN_P (proc
))
877 if (EQ (symbol
, Qrun
))
878 write_string ("open", -1);
879 else if (EQ (symbol
, Qexit
))
880 write_string ("closed", -1);
882 Fprinc (symbol
, Qnil
);
885 Fprinc (symbol
, Qnil
);
887 if (EQ (symbol
, Qexit
))
890 tem
= Fcar (Fcdr (p
->status
));
893 sprintf (tembuf
, " %d", XFASTINT (tem
));
894 write_string (tembuf
, -1);
898 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
899 remove_process (proc
);
901 Findent_to (make_number (22), minspace
);
902 if (NILP (p
->buffer
))
903 insert_string ("(none)");
904 else if (NILP (XBUFFER (p
->buffer
)->name
))
905 insert_string ("(Killed)");
907 Finsert (1, &XBUFFER (p
->buffer
)->name
);
909 Findent_to (make_number (37), minspace
);
911 if (NETCONN_P (proc
))
913 sprintf (tembuf
, "(network stream connection to %s)\n",
914 XSTRING (p
->childp
)->data
);
915 insert_string (tembuf
);
929 insert_string ("\n");
935 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
936 "Display a list of all processes.\n\
937 \(Any processes listed as Exited or Signaled are actually eliminated\n\
938 after the listing is made.)")
941 internal_with_output_to_temp_buffer ("*Process List*",
942 list_processes_1
, Qnil
);
946 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
947 "Return a list of all processes.")
950 return Fmapcar (Qcdr
, Vprocess_alist
);
953 /* Starting asynchronous inferior processes. */
955 static Lisp_Object
start_process_unwind ();
957 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
958 "Start a program in a subprocess. Return the process object for it.\n\
959 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
960 NAME is name for process. It is modified if necessary to make it unique.\n\
961 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
962 Process output goes at end of that buffer, unless you specify\n\
963 an output stream or filter function to handle the output.\n\
964 BUFFER may be also nil, meaning that this process is not associated\n\
966 Third arg is program file name. It is searched for as in the shell.\n\
967 Remaining arguments are strings to give program as arguments.")
970 register Lisp_Object
*args
;
972 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
974 register unsigned char *new_argv
;
977 register unsigned char **new_argv
;
980 int count
= specpdl_ptr
- specpdl
;
984 buffer
= Fget_buffer_create (buffer
);
986 /* Make sure that the child will be able to chdir to the current
987 buffer's current directory, or its unhandled equivalent. We
988 can't just have the child check for an error when it does the
989 chdir, since it's in a vfork.
991 We have to GCPRO around this because Fexpand_file_name and
992 Funhandled_file_name_directory might call a file name handling
993 function. The argument list is protected by the caller, so all
994 we really have to worry about is buffer. */
996 struct gcpro gcpro1
, gcpro2
;
998 current_dir
= current_buffer
->directory
;
1000 GCPRO2 (buffer
, current_dir
);
1003 expand_and_dir_to_file
1004 (Funhandled_file_name_directory (current_dir
), Qnil
);
1005 if (NILP (Ffile_accessible_directory_p (current_dir
)))
1006 report_file_error ("Setting current directory",
1007 Fcons (current_buffer
->directory
, Qnil
));
1013 CHECK_STRING (name
, 0);
1017 CHECK_STRING (program
, 2);
1020 /* Make a one member argv with all args concatenated
1021 together separated by a blank. */
1022 len
= XSTRING (program
)->size
+ 2;
1023 for (i
= 3; i
< nargs
; i
++)
1026 CHECK_STRING (tem
, i
);
1027 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1029 new_argv
= (unsigned char *) alloca (len
);
1030 strcpy (new_argv
, XSTRING (program
)->data
);
1031 for (i
= 3; i
< nargs
; i
++)
1034 CHECK_STRING (tem
, i
);
1035 strcat (new_argv
, " ");
1036 strcat (new_argv
, XSTRING (tem
)->data
);
1038 /* Need to add code here to check for program existence on VMS */
1041 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1043 /* If program file name is not absolute, search our path for it */
1044 if (XSTRING (program
)->data
[0] != '/')
1046 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1049 GCPRO4 (name
, program
, buffer
, current_dir
);
1050 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1053 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1054 new_argv
[0] = XSTRING (tem
)->data
;
1057 new_argv
[0] = XSTRING (program
)->data
;
1059 for (i
= 3; i
< nargs
; i
++)
1062 CHECK_STRING (tem
, i
);
1063 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1065 new_argv
[i
- 2] = 0;
1066 #endif /* not VMS */
1068 proc
= make_process (name
);
1069 /* If an error occurs and we can't start the process, we want to
1070 remove it from the process list. This means that each error
1071 check in create_process doesn't need to call remove_process
1072 itself; it's all taken care of here. */
1073 record_unwind_protect (start_process_unwind
, proc
);
1075 XPROCESS (proc
)->childp
= Qt
;
1076 XPROCESS (proc
)->command_channel_p
= Qnil
;
1077 XPROCESS (proc
)->buffer
= buffer
;
1078 XPROCESS (proc
)->sentinel
= Qnil
;
1079 XPROCESS (proc
)->filter
= Qnil
;
1080 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1082 create_process (proc
, new_argv
, current_dir
);
1084 return unbind_to (count
, proc
);
1087 /* This function is the unwind_protect form for Fstart_process. If
1088 PROC doesn't have its pid set, then we know someone has signalled
1089 an error and the process wasn't started successfully, so we should
1090 remove it from the process list. */
1092 start_process_unwind (proc
)
1095 if (XTYPE (proc
) != Lisp_Process
)
1098 /* Was PROC started successfully? */
1099 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1100 remove_process (proc
);
1107 create_process_1 (signo
)
1111 /* USG systems forget handlers when they are used;
1112 must reestablish each time */
1113 signal (signo
, create_process_1
);
1117 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1120 /* Mimic blocking of signals on system V, which doesn't really have it. */
1122 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1123 int sigchld_deferred
;
1126 create_process_sigchld ()
1128 signal (SIGCHLD
, create_process_sigchld
);
1130 sigchld_deferred
= 1;
1136 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1137 create_process (process
, new_argv
, current_dir
)
1138 Lisp_Object process
;
1140 Lisp_Object current_dir
;
1142 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1145 SIGTYPE (*sigchld
)();
1148 extern char **environ
;
1150 inchannel
= outchannel
= -1;
1153 if (EQ (Vprocess_connection_type
, Qt
))
1154 outchannel
= inchannel
= allocate_pty ();
1159 /* On USG systems it does not work to open the pty's tty here
1160 and then close and reopen it in the child. */
1162 /* Don't let this terminal become our controlling terminal
1163 (in case we don't have one). */
1164 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1166 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1169 report_file_error ("Opening pty", Qnil
);
1171 forkin
= forkout
= -1;
1172 #endif /* not USG */
1176 #endif /* HAVE_PTYS */
1179 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1180 report_file_error ("Opening socketpair", Qnil
);
1181 outchannel
= inchannel
= sv
[0];
1182 forkout
= forkin
= sv
[1];
1184 #else /* not SKTPAIR */
1193 #endif /* not SKTPAIR */
1196 /* Replaced by close_process_descs */
1197 set_exclusive_use (inchannel
);
1198 set_exclusive_use (outchannel
);
1201 /* Stride people say it's a mystery why this is needed
1202 as well as the O_NDELAY, but that it fails without this. */
1203 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1206 ioctl (inchannel
, FIONBIO
, &one
);
1211 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1214 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1218 /* Record this as an active process, with its channels.
1219 As a result, child_setup will close Emacs's side of the pipes. */
1220 chan_process
[inchannel
] = process
;
1221 XSET (XPROCESS (process
)->infd
, Lisp_Int
, inchannel
);
1222 XSET (XPROCESS (process
)->outfd
, Lisp_Int
, outchannel
);
1223 /* Record the tty descriptor used in the subprocess. */
1225 XPROCESS (process
)->subtty
= Qnil
;
1227 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1228 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1229 XPROCESS (process
)->status
= Qrun
;
1231 /* Delay interrupts until we have a chance to store
1232 the new fork's pid in its process structure */
1236 #else /* not BSD4_1 */
1237 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1238 sigsetmask (sigmask (SIGCHLD
));
1239 #else /* ordinary USG */
1241 sigchld_deferred
= 0;
1242 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1244 #endif /* ordinary USG */
1245 #endif /* not BSD4_1 */
1246 #endif /* SIGCHLD */
1248 /* Until we store the proper pid, enable sigchld_handler
1249 to recognize an unknown pid as standing for this process.
1250 It is very important not to let this `marker' value stay
1251 in the table after this function has returned; if it does
1252 it might cause call-process to hang and subsequent asynchronous
1253 processes to get their return values scrambled. */
1254 XSETINT (XPROCESS (process
)->pid
, -1);
1257 /* child_setup must clobber environ on systems with true vfork.
1258 Protect it from permanent change. */
1259 char **save_environ
= environ
;
1264 int xforkin
= forkin
;
1265 int xforkout
= forkout
;
1267 #if 0 /* This was probably a mistake--it duplicates code later on,
1268 but fails to handle all the cases. */
1269 /* Make sure SIGCHLD is not blocked in the child. */
1270 sigsetmask (SIGEMPTYMASK
);
1273 /* Make the pty be the controlling terminal of the process. */
1275 /* First, disconnect its current controlling terminal. */
1279 /* Make the pty's terminal the controlling terminal. */
1281 /* We ignore the return value
1282 because faith@cs.unc.edu says that is necessary on Linux. */
1283 ioctl (xforkin
, TIOCSCTTY
, 0);
1285 #else /* not HAVE_SETSID */
1287 /* It's very important to call setpgrp here and no time
1288 afterwards. Otherwise, we lose our controlling tty which
1289 is set when we open the pty. */
1292 #endif /* not HAVE_SETSID */
1293 #if defined (NTTYDISC) || defined (TIOCSETD)
1294 if (pty_flag
&& xforkin
>= 0)
1296 /* Use new line discipline. */
1297 int ldisc
= NTTYDISC
;
1298 if (ioctl (xforkin
, TIOCSETD
, &ldisc
) < 0)
1299 write (1, "create_process/TIOCSETD failed\n", 31);
1303 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1304 can do TIOCSPGRP only to the process's controlling tty. */
1307 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1308 I can't test it since I don't have 4.3. */
1309 int j
= open ("/dev/tty", O_RDWR
, 0);
1310 ioctl (j
, TIOCNOTTY
, 0);
1313 /* In order to get a controlling terminal on some versions
1314 of BSD, it is necessary to put the process in pgrp 0
1315 before it opens the terminal. */
1319 #endif /* TIOCNOTTY */
1321 #if !defined (RTU) && !defined (UNIPLUS)
1322 /*** There is a suggestion that this ought to be a
1323 conditional on TIOCSPGRP. */
1324 /* Now close the pty (if we had it open) and reopen it.
1325 This makes the pty the controlling terminal of the subprocess. */
1328 #ifdef SET_CHILD_PTY_PGRP
1329 int pgrp
= getpid ();
1332 /* I wonder if close (open (pty_name, ...)) would work? */
1335 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1337 #ifdef SET_CHILD_PTY_PGRP
1338 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1339 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1345 #endif /* not UNIPLUS and not RTU */
1346 #ifdef SETUP_SLAVE_PTY
1348 #endif /* SETUP_SLAVE_PTY */
1350 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1351 Now reenable it in the child, so it will die when we want it to. */
1353 signal (SIGHUP
, SIG_DFL
);
1355 #endif /* HAVE_PTYS */
1360 #else /* not BSD4_1 */
1361 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1362 sigsetmask (SIGEMPTYMASK
);
1363 #else /* ordinary USG */
1365 signal (SIGCHLD
, sigchld
);
1367 #endif /* ordinary USG */
1368 #endif /* not BSD4_1 */
1369 #endif /* SIGCHLD */
1371 child_setup_tty (xforkout
);
1372 child_setup (xforkin
, xforkout
, xforkout
,
1373 new_argv
, 1, current_dir
);
1375 environ
= save_environ
;
1379 report_file_error ("Doing vfork", Qnil
);
1381 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1383 FD_SET (inchannel
, &input_wait_mask
);
1385 /* If the subfork execv fails, and it exits,
1386 this close hangs. I don't know why.
1387 So have an interrupt jar it loose. */
1389 signal (SIGALRM
, create_process_1
);
1391 XPROCESS (process
)->subtty
= Qnil
;
1396 if (forkin
!= forkout
&& forkout
>= 0)
1402 #else /* not BSD4_1 */
1403 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1404 sigsetmask (SIGEMPTYMASK
);
1405 #else /* ordinary USG */
1407 signal (SIGCHLD
, sigchld
);
1408 /* Now really handle any of these signals
1409 that came in during this function. */
1410 if (sigchld_deferred
)
1411 kill (getpid (), SIGCHLD
);
1413 #endif /* ordinary USG */
1414 #endif /* not BSD4_1 */
1415 #endif /* SIGCHLD */
1417 #endif /* not VMS */
1421 /* open a TCP network connection to a given HOST/SERVICE. Treated
1422 exactly like a normal process when reading and writing. Only
1423 differences are in status display and process deletion. A network
1424 connection has no PID; you cannot signal it. All you can do is
1425 deactivate and close it via delete-process */
1427 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1429 "Open a TCP connection for a service to a host.\n\
1430 Returns a subprocess-object to represent the connection.\n\
1431 Input and output work as for subprocesses; `delete-process' closes it.\n\
1432 Args are NAME BUFFER HOST SERVICE.\n\
1433 NAME is name for process. It is modified if necessary to make it unique.\n\
1434 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1435 Process output goes at end of that buffer, unless you specify\n\
1436 an output stream or filter function to handle the output.\n\
1437 BUFFER may be also nil, meaning that this process is not associated\n\
1439 Third arg is name of the host to connect to, or its IP address.\n\
1440 Fourth arg SERVICE is name of the service desired, or an integer\n\
1441 specifying a port number to connect to.")
1442 (name
, buffer
, host
, service
)
1443 Lisp_Object name
, buffer
, host
, service
;
1447 struct sockaddr_in address
;
1448 struct servent
*svc_info
;
1449 struct hostent
*host_info_ptr
, host_info
;
1450 char *(addr_list
[2]);
1451 IN_ADDR numeric_addr
;
1455 struct hostent host_info_fixed
;
1456 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1458 GCPRO4 (name
, buffer
, host
, service
);
1459 CHECK_STRING (name
, 0);
1460 CHECK_STRING (host
, 0);
1461 if (XTYPE(service
) == Lisp_Int
)
1462 port
= htons ((unsigned short) XINT (service
));
1465 CHECK_STRING (service
, 0);
1466 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1468 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1469 port
= svc_info
->s_port
;
1473 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1474 if (host_info_ptr
== 0)
1475 /* Attempt to interpret host as numeric inet address */
1477 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1478 if (NUMERIC_ADDR_ERROR
)
1479 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1481 host_info_ptr
= &host_info
;
1482 host_info
.h_name
= 0;
1483 host_info
.h_aliases
= 0;
1484 host_info
.h_addrtype
= AF_INET
;
1486 /* Older machines have only one address slot called h_addr.
1487 Newer machines have h_addr_list, but #define h_addr to
1488 be its first element. */
1489 host_info
.h_addr_list
= &(addr_list
[0]);
1491 host_info
.h_addr
= (char*)(&numeric_addr
);
1493 host_info
.h_length
= strlen (addr_list
[0]);
1496 bzero (&address
, sizeof address
);
1497 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1498 host_info_ptr
->h_length
);
1499 address
.sin_family
= host_info_ptr
->h_addrtype
;
1500 address
.sin_port
= port
;
1502 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1504 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1506 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1507 when connect is interrupted. So let's not let it get interrupted.
1508 Note we do not turn off polling, because polling is only used
1509 when not interrupt_input, and thus not normally used on the systems
1510 which have this bug. On systems which use polling, there's no way
1511 to quit if polling is turned off. */
1512 if (interrupt_input
)
1516 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1523 if (interrupt_input
)
1527 report_file_error ("connection failed",
1528 Fcons (host
, Fcons (name
, Qnil
)));
1531 if (interrupt_input
)
1535 s
= connect_server (0);
1537 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1538 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1539 send_command (s
, C_DUMB
, 1, 0);
1545 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1548 buffer
= Fget_buffer_create (buffer
);
1549 proc
= make_process (name
);
1551 chan_process
[inch
] = proc
;
1554 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1557 fcntl (inch
, F_SETFL
, O_NDELAY
);
1561 XPROCESS (proc
)->childp
= host
;
1562 XPROCESS (proc
)->command_channel_p
= Qnil
;
1563 XPROCESS (proc
)->buffer
= buffer
;
1564 XPROCESS (proc
)->sentinel
= Qnil
;
1565 XPROCESS (proc
)->filter
= Qnil
;
1566 XPROCESS (proc
)->command
= Qnil
;
1567 XPROCESS (proc
)->pid
= Qnil
;
1568 XSET (XPROCESS (proc
)->infd
, Lisp_Int
, s
);
1569 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, outch
);
1570 XPROCESS (proc
)->status
= Qrun
;
1571 FD_SET (inch
, &input_wait_mask
);
1576 #endif /* HAVE_SOCKETS */
1578 deactivate_process (proc
)
1581 register int inchannel
, outchannel
;
1582 register struct Lisp_Process
*p
= XPROCESS (proc
);
1584 inchannel
= XINT (p
->infd
);
1585 outchannel
= XINT (p
->outfd
);
1589 /* Beware SIGCHLD hereabouts. */
1590 flush_pending_output (inchannel
);
1593 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1594 sys$
dassgn (outchannel
);
1595 vs
= get_vms_process_pointer (p
->pid
);
1597 give_back_vms_process_stuff (vs
);
1601 if (outchannel
>= 0 && outchannel
!= inchannel
)
1605 XSET (p
->infd
, Lisp_Int
, -1);
1606 XSET (p
->outfd
, Lisp_Int
, -1);
1607 chan_process
[inchannel
] = Qnil
;
1608 FD_CLR (inchannel
, &input_wait_mask
);
1612 /* Close all descriptors currently in use for communication
1613 with subprocess. This is used in a newly-forked subprocess
1614 to get rid of irrelevant descriptors. */
1616 close_process_descs ()
1619 for (i
= 0; i
< MAXDESC
; i
++)
1621 Lisp_Object process
;
1622 process
= chan_process
[i
];
1623 if (!NILP (process
))
1625 int in
= XINT (XPROCESS (process
)->infd
);
1626 int out
= XINT (XPROCESS (process
)->outfd
);
1629 if (out
>= 0 && in
!= out
)
1635 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1637 "Allow any pending output from subprocesses to be read by Emacs.\n\
1638 It is read into the process' buffers or given to their filter functions.\n\
1639 Non-nil arg PROCESS means do not return until some output has been received\n\
1641 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1642 seconds and microseconds to wait; return after that much time whether\n\
1643 or not there is input.\n\
1644 Return non-nil iff we received any output before the timeout expired.")
1645 (proc
, timeout
, timeout_msecs
)
1646 register Lisp_Object proc
, timeout
, timeout_msecs
;
1651 if (! NILP (timeout_msecs
))
1653 CHECK_NUMBER (timeout_msecs
, 2);
1654 useconds
= XINT (timeout_msecs
);
1655 if (XTYPE (timeout
) != Lisp_Int
)
1656 XSET (timeout
, Lisp_Int
, 0);
1659 int carry
= useconds
/ 1000000;
1661 XSETINT (timeout
, XINT (timeout
) + carry
);
1662 useconds
-= carry
* 1000000;
1664 /* I think this clause is necessary because C doesn't
1665 guarantee a particular rounding direction for negative
1669 XSETINT (timeout
, XINT (timeout
) - 1);
1670 useconds
+= 1000000;
1677 if (! NILP (timeout
))
1679 CHECK_NUMBER (timeout
, 1);
1680 seconds
= XINT (timeout
);
1693 XFASTINT (proc
) = 0;
1696 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1700 /* This variable is different from waiting_for_input in keyboard.c.
1701 It is used to communicate to a lisp process-filter/sentinel (via the
1702 function Fwaiting_for_user_input_p below) whether emacs was waiting
1703 for user-input when that process-filter was called.
1704 waiting_for_input cannot be used as that is by definition 0 when
1705 lisp code is being evalled */
1706 static int waiting_for_user_input_p
;
1708 /* Read and dispose of subprocess output while waiting for timeout to
1709 elapse and/or keyboard input to be available.
1712 timeout in seconds, or
1713 zero for no limit, or
1714 -1 means gobble data immediately available but don't wait for any.
1717 an additional duration to wait, measured in microseconds.
1718 If this is nonzero and time_limit is 0, then the timeout
1719 consists of MICROSECS only.
1721 READ_KBD is a lisp value:
1722 0 to ignore keyboard input, or
1723 1 to return when input is available, or
1724 -1 meaning caller will actually read the input, so don't throw to
1725 the quit handler, or
1726 a cons cell, meaning wait until its car is non-nil
1727 (and gobble terminal input into the buffer if any arrives), or
1728 a process object, meaning wait until something arrives from that
1729 process. The return value is true iff we read some input from
1732 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1733 output that arrives.
1735 If READ_KBD is a pointer to a struct Lisp_Process, then the
1736 function returns true iff we received input from that process
1737 before the timeout elapsed.
1738 Otherwise, return true iff we received input from any process. */
1740 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1741 int time_limit
, microsecs
;
1742 Lisp_Object read_kbd
;
1745 register int channel
, nfds
, m
;
1746 static SELECT_TYPE Available
;
1749 EMACS_TIME timeout
, end_time
, garbage
;
1751 int wait_channel
= -1;
1752 struct Lisp_Process
*wait_proc
= 0;
1753 int got_some_input
= 0;
1754 Lisp_Object
*wait_for_cell
= 0;
1756 FD_ZERO (&Available
);
1758 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1760 if (XTYPE (read_kbd
) == Lisp_Process
)
1762 wait_proc
= XPROCESS (read_kbd
);
1763 wait_channel
= XINT (wait_proc
->infd
);
1764 XFASTINT (read_kbd
) = 0;
1767 /* If waiting for non-nil in a cell, record where. */
1768 if (XTYPE (read_kbd
) == Lisp_Cons
)
1770 wait_for_cell
= &XCONS (read_kbd
)->car
;
1771 XFASTINT (read_kbd
) = 0;
1774 waiting_for_user_input_p
= XINT (read_kbd
);
1776 /* Since we may need to wait several times,
1777 compute the absolute time to return at. */
1778 if (time_limit
|| microsecs
)
1780 EMACS_GET_TIME (end_time
);
1781 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1782 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1785 /* It would not be safe to call this below,
1786 where we call redisplay_preserve_echo_area. */
1787 prepare_menu_bars ();
1791 /* If calling from keyboard input, do not quit
1792 since we want to return C-g as an input character.
1793 Otherwise, do pending quit if requested. */
1794 if (XINT (read_kbd
) >= 0)
1797 /* Exit now if the cell we're waiting for became non-nil. */
1798 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1801 /* Compute time from now till when time limit is up */
1802 /* Exit if already run out */
1803 if (time_limit
== -1)
1805 /* -1 specified for timeout means
1806 gobble output available now
1807 but don't wait at all. */
1809 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1811 else if (time_limit
|| microsecs
)
1813 EMACS_GET_TIME (timeout
);
1814 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1815 if (EMACS_TIME_NEG_P (timeout
))
1820 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1823 /* Cause C-g and alarm signals to take immediate action,
1824 and cause input available signals to zero out timeout.
1826 It is important that we do this before checking for process
1827 activity. If we get a SIGCHLD after the explicit checks for
1828 process activity, timeout is the only way we will know. */
1829 if (XINT (read_kbd
) < 0)
1830 set_waiting_for_input (&timeout
);
1832 /* If status of something has changed, and no input is
1833 available, notify the user of the change right away. After
1834 this explicit check, we'll let the SIGCHLD handler zap
1835 timeout to get our attention. */
1836 if (update_tick
!= process_tick
&& do_display
)
1838 Atemp
= input_wait_mask
;
1839 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1840 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1842 /* It's okay for us to do this and then continue with
1843 the loop, since timeout has already been zeroed out. */
1844 clear_waiting_for_input ();
1849 /* Don't wait for output from a non-running process. */
1850 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1851 update_status (wait_proc
);
1853 && ! EQ (wait_proc
->status
, Qrun
))
1855 clear_waiting_for_input ();
1859 /* Wait till there is something to do */
1861 Available
= input_wait_mask
;
1862 /* We used to have && wait_for_cell == 0
1863 but that led to lossage handling selection_request events:
1864 within one, we would start to handle another. */
1865 if (! XINT (read_kbd
))
1866 FD_CLR (keyboard_descriptor
, &Available
);
1868 /* If frame size has changed or the window is newly mapped,
1869 redisplay now, before we start to wait. There is a race
1870 condition here; if a SIGIO arrives between now and the select
1871 and indicates that a frame is trashed, the select may block
1872 displaying a trashed screen. */
1873 if (frame_garbaged
&& do_display
)
1874 redisplay_preserve_echo_area ();
1876 if (XINT (read_kbd
) && detect_input_pending ())
1879 FD_ZERO (&Available
);
1882 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1886 /* Make C-g and alarm signals set flags again */
1887 clear_waiting_for_input ();
1889 /* If we woke up due to SIGWINCH, actually change size now. */
1890 do_pending_window_change ();
1892 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1896 if (xerrno
== EINTR
)
1897 FD_ZERO (&Available
);
1899 /* Ultrix select seems to return ENOMEM when it is
1900 interrupted. Treat it just like EINTR. Bleah. Note
1901 that we want to test for the "ultrix" CPP symbol, not
1902 "__ultrix__"; the latter is only defined under GCC, but
1903 not by DEC's bundled CC. -JimB */
1904 else if (xerrno
== ENOMEM
)
1905 FD_ZERO (&Available
);
1908 /* This happens for no known reason on ALLIANT.
1909 I am guessing that this is the right response. -- RMS. */
1910 else if (xerrno
== EFAULT
)
1911 FD_ZERO (&Available
);
1913 else if (xerrno
== EBADF
)
1916 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1917 the child's closure of the pts gives the parent a SIGHUP, and
1918 the ptc file descriptor is automatically closed,
1919 yielding EBADF here or at select() call above.
1920 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1921 in m/ibmrt-aix.h), and here we just ignore the select error.
1922 Cleanup occurs c/o status_notify after SIGCLD. */
1923 FD_ZERO (&Available
); /* Cannot depend on values returned */
1929 error("select error: %s", strerror (xerrno
));
1931 #if defined(sun) && !defined(USG5_4)
1932 else if (nfds
> 0 && FD_ISSET (keyboard_descriptor
, &Available
)
1934 /* System sometimes fails to deliver SIGIO.
1936 David J. Mackenzie says that Emacs doesn't compile under
1937 Solaris if this code is enabled, thus the USG5_4 in the CPP
1938 conditional. "I haven't noticed any ill effects so far.
1939 If you find a Solaris expert somewhere, they might know
1941 kill (getpid (), SIGIO
);
1944 /* Check for keyboard input */
1945 /* If there is any, return immediately
1946 to give it higher priority than subprocesses */
1948 /* We used to do this if wait_for_cell,
1949 but that caused infinite recursion in selection request events. */
1950 if ((XINT (read_kbd
))
1951 && detect_input_pending ())
1954 if (detect_input_pending ())
1958 /* Exit now if the cell we're waiting for became non-nil. */
1959 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1963 /* If we think we have keyboard input waiting, but didn't get SIGIO
1964 go read it. This can happen with X on BSD after logging out.
1965 In that case, there really is no input and no SIGIO,
1966 but select says there is input. */
1968 if (XINT (read_kbd
) && interrupt_input
1969 && (FD_ISSET (keyboard_descriptor
, &Available
)))
1974 got_some_input
|= nfds
> 0;
1976 /* If checking input just got us a size-change event from X,
1977 obey it now if we should. */
1978 if (XINT (read_kbd
) || wait_for_cell
)
1979 do_pending_window_change ();
1981 /* Check for data from a process. */
1982 /* Really FIRST_PROC_DESC should be 0 on Unix,
1983 but this is safer in the short run. */
1984 for (channel
= keyboard_descriptor
== 0 ? FIRST_PROC_DESC
: 0;
1985 channel
< MAXDESC
; channel
++)
1987 if (FD_ISSET (channel
, &Available
))
1991 /* If waiting for this channel, arrange to return as
1992 soon as no more input to be processed. No more
1994 if (wait_channel
== channel
)
2000 proc
= chan_process
[channel
];
2004 /* Read data from the process, starting with our
2005 buffered-ahead character if we have one. */
2007 nread
= read_process_output (proc
, channel
);
2010 /* Since read_process_output can run a filter,
2011 which can call accept-process-output,
2012 don't try to read from any other processes
2013 before doing the select again. */
2014 FD_ZERO (&Available
);
2017 redisplay_preserve_echo_area ();
2020 else if (nread
== -1 && errno
== EWOULDBLOCK
)
2024 else if (nread
== -1 && errno
== EAGAIN
)
2028 else if (nread
== -1 && errno
== EAGAIN
)
2030 /* Note that we cannot distinguish between no input
2031 available now and a closed pipe.
2032 With luck, a closed pipe will be accompanied by
2033 subprocess termination and SIGCHLD. */
2034 else if (nread
== 0 && !NETCONN_P (proc
))
2036 #endif /* O_NDELAY */
2037 #endif /* O_NONBLOCK */
2038 #endif /* EWOULDBLOCK */
2040 /* On some OSs with ptys, when the process on one end of
2041 a pty exits, the other end gets an error reading with
2042 errno = EIO instead of getting an EOF (0 bytes read).
2043 Therefore, if we get an error reading and errno =
2044 EIO, just continue, because the child process has
2045 exited and should clean itself up soon (e.g. when we
2047 else if (nread
== -1 && errno
== EIO
)
2049 #endif /* HAVE_PTYS */
2050 /* If we can detect process termination, don't consider the process
2051 gone just because its pipe is closed. */
2053 else if (nread
== 0 && !NETCONN_P (proc
))
2058 /* Preserve status of processes already terminated. */
2059 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2060 deactivate_process (proc
);
2061 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2062 update_status (XPROCESS (proc
));
2063 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2064 XPROCESS (proc
)->status
2065 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2068 } /* end for each file descriptor */
2069 } /* end while exit conditions not met */
2071 /* If calling from keyboard input, do not quit
2072 since we want to return C-g as an input character.
2073 Otherwise, do pending quit if requested. */
2074 if (XINT (read_kbd
) >= 0)
2076 /* Prevent input_pending from remaining set if we quit. */
2077 clear_input_pending ();
2081 return got_some_input
;
2084 /* Read pending output from the process channel,
2085 starting with our buffered-ahead character if we have one.
2086 Yield number of characters read.
2088 This function reads at most 1024 characters.
2089 If you want to read all available subprocess output,
2090 you must call it repeatedly until it returns zero. */
2092 read_process_output (proc
, channel
)
2094 register int channel
;
2096 register int nchars
;
2102 register Lisp_Object outstream
;
2103 register struct buffer
*old
= current_buffer
;
2104 register struct Lisp_Process
*p
= XPROCESS (proc
);
2105 register int opoint
;
2108 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2110 vs
= get_vms_process_pointer (p
->pid
);
2114 return(0); /* Really weird if it does this */
2115 if (!(vs
->iosb
[0] & 1))
2116 return -1; /* I/O error */
2119 error ("Could not get VMS process pointer");
2120 chars
= vs
->inputBuffer
;
2121 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2124 start_vms_process_read (vs
); /* Crank up the next read on the process */
2125 return 1; /* Nothing worth printing, say we got 1 */
2129 if (proc_buffered_char
[channel
] < 0)
2130 nchars
= read (channel
, chars
, sizeof chars
);
2133 chars
[0] = proc_buffered_char
[channel
];
2134 proc_buffered_char
[channel
] = -1;
2135 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2139 nchars
= nchars
+ 1;
2141 #endif /* not VMS */
2143 if (nchars
<= 0) return nchars
;
2145 outstream
= p
->filter
;
2146 if (!NILP (outstream
))
2148 /* We inhibit quit here instead of just catching it so that
2149 hitting ^G when a filter happens to be running won't screw
2151 int count
= specpdl_ptr
- specpdl
;
2152 Lisp_Object odeactivate
;
2153 Lisp_Object obuffer
;
2155 odeactivate
= Vdeactivate_mark
;
2156 obuffer
= Fcurrent_buffer ();
2158 specbind (Qinhibit_quit
, Qt
);
2159 call2 (outstream
, proc
, make_string (chars
, nchars
));
2161 /* Handling the process output should not deactivate the mark. */
2162 Vdeactivate_mark
= odeactivate
;
2164 if (! EQ (Fcurrent_buffer (), obuffer
))
2165 record_asynch_buffer_change ();
2168 start_vms_process_read (vs
);
2170 unbind_to (count
, Qnil
);
2174 /* If no filter, write into buffer if it isn't dead. */
2175 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2177 Lisp_Object old_read_only
;
2178 Lisp_Object old_begv
, old_zv
;
2179 Lisp_Object odeactivate
;
2181 odeactivate
= Vdeactivate_mark
;
2183 Fset_buffer (p
->buffer
);
2185 old_read_only
= current_buffer
->read_only
;
2186 XFASTINT (old_begv
) = BEGV
;
2187 XFASTINT (old_zv
) = ZV
;
2189 current_buffer
->read_only
= Qnil
;
2191 /* Insert new output into buffer
2192 at the current end-of-output marker,
2193 thus preserving logical ordering of input and output. */
2194 if (XMARKER (p
->mark
)->buffer
)
2195 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2199 /* If the output marker is outside of the visible region, save
2200 the restriction and widen. */
2201 if (! (BEGV
<= point
&& point
<= ZV
))
2204 /* Make sure opoint floats ahead of any new text, just as point
2206 if (point
<= opoint
)
2209 /* Insert after old_begv, but before old_zv. */
2210 if (point
< XFASTINT (old_begv
))
2211 XFASTINT (old_begv
) += nchars
;
2212 if (point
<= XFASTINT (old_zv
))
2213 XFASTINT (old_zv
) += nchars
;
2215 /* Insert before markers in case we are inserting where
2216 the buffer's mark is, and the user's next command is Meta-y. */
2217 insert_before_markers (chars
, nchars
);
2218 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2220 update_mode_lines
++;
2222 /* If the restriction isn't what it should be, set it. */
2223 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2224 Fnarrow_to_region (old_begv
, old_zv
);
2226 /* Handling the process output should not deactivate the mark. */
2227 Vdeactivate_mark
= odeactivate
;
2229 current_buffer
->read_only
= old_read_only
;
2231 set_buffer_internal (old
);
2234 start_vms_process_read (vs
);
2239 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2241 "Returns non-NIL if emacs is waiting for input from the user.\n\
2242 This is intended for use by asynchronous process output filters and sentinels.")
2245 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2248 /* Sending data to subprocess */
2250 jmp_buf send_process_frame
;
2253 send_process_trap ()
2259 longjmp (send_process_frame
, 1);
2262 send_process (proc
, buf
, len
)
2267 /* Don't use register vars; longjmp can lose them. */
2269 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2273 struct Lisp_Process
*p
= XPROCESS (proc
);
2274 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2277 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2278 update_status (XPROCESS (proc
));
2279 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2280 error ("Process %s not running", procname
);
2283 vs
= get_vms_process_pointer (p
->pid
);
2285 error ("Could not find this process: %x", p
->pid
);
2286 else if (write_to_vms_process (vs
, buf
, len
))
2289 if (!setjmp (send_process_frame
))
2293 SIGTYPE (*old_sigpipe
)();
2296 if (pty_max_bytes
== 0)
2298 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2299 pty_max_bytes
= fpathconf (XFASTINT (XPROCESS (proc
)->outfd
),
2302 pty_max_bytes
= 250;
2306 /* Don't send more than pty_max_bytes bytes at a time. */
2307 /* Subtract 1 to leave room for the EOF. */
2308 if (this >= pty_max_bytes
&& !NILP (XPROCESS (proc
)->pty_flag
))
2309 this = pty_max_bytes
- 1;
2311 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2312 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
2314 /* If we sent just part of the string, put in an EOF
2315 to force it through, before we send the rest. */
2317 Fprocess_send_eof (proc
);
2319 signal (SIGPIPE
, old_sigpipe
);
2324 || errno
== EWOULDBLOCK
2331 /* It would be nice to accept process output here,
2332 but that is difficult. For example, it could
2333 garbage what we are sending if that is from a buffer. */
2340 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2344 /* Allow input from processes between bursts of sending.
2345 Otherwise things may get stopped up. */
2350 XFASTINT (zero
) = 0;
2351 wait_reading_process_input (-1, 0, zero
, 0);
2357 XPROCESS (proc
)->raw_status_low
= Qnil
;
2358 XPROCESS (proc
)->raw_status_high
= Qnil
;
2359 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2360 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2361 deactivate_process (proc
);
2363 error ("Error writing to process %s; closed it", procname
);
2365 error ("SIGPIPE raised on process %s; closed it", procname
);
2370 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2372 "Send current contents of region as input to PROCESS.\n\
2373 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2374 nil, indicating the current buffer's process.\n\
2375 Called from program, takes three arguments, PROCESS, START and END.\n\
2376 If the region is more than 500 characters long,\n\
2377 it is sent in several bunches. This may happen even for shorter regions.\n\
2378 Output from processes can arrive in between bunches.")
2379 (process
, start
, end
)
2380 Lisp_Object process
, start
, end
;
2385 proc
= get_process (process
);
2386 validate_region (&start
, &end
);
2388 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2391 start1
= XINT (start
);
2392 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2397 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2399 "Send PROCESS the contents of STRING as input.\n\
2400 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2401 nil, indicating the current buffer's process.\n\
2402 If STRING is more than 500 characters long,\n\
2403 it is sent in several bunches. This may happen even for shorter strings.\n\
2404 Output from processes can arrive in between bunches.")
2406 Lisp_Object process
, string
;
2409 CHECK_STRING (string
, 1);
2410 proc
= get_process (process
);
2411 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2415 /* send a signal number SIGNO to PROCESS.
2416 CURRENT_GROUP means send to the process group that currently owns
2417 the terminal being used to communicate with PROCESS.
2418 This is used for various commands in shell mode.
2419 If NOMSG is zero, insert signal-announcements into process's buffers
2422 If we can, we try to signal PROCESS by sending control characters
2423 down the pipe. This allows us to signal inferiors who have changed
2424 their uid, for which killpg would return an EPERM error. */
2427 process_send_signal (process
, signo
, current_group
, nomsg
)
2428 Lisp_Object process
;
2430 Lisp_Object current_group
;
2434 register struct Lisp_Process
*p
;
2438 proc
= get_process (process
);
2439 p
= XPROCESS (proc
);
2441 if (!EQ (p
->childp
, Qt
))
2442 error ("Process %s is not a subprocess",
2443 XSTRING (p
->name
)->data
);
2444 if (XINT (p
->infd
) < 0)
2445 error ("Process %s is not active",
2446 XSTRING (p
->name
)->data
);
2448 if (NILP (p
->pty_flag
))
2449 current_group
= Qnil
;
2451 /* If we are using pgrps, get a pgrp number and make it negative. */
2452 if (!NILP (current_group
))
2454 #ifdef SIGNALS_VIA_CHARACTERS
2455 /* If possible, send signals to the entire pgrp
2456 by sending an input character to it. */
2458 /* TERMIOS is the latest and bestest, and seems most likely to
2459 work. If the system has it, use it. */
2466 tcgetattr (XINT (p
->infd
), &t
);
2467 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2471 tcgetattr (XINT (p
->infd
), &t
);
2472 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2476 tcgetattr (XINT (p
->infd
), &t
);
2477 #if defined (VSWTCH) && !defined (IRIX5)
2478 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2480 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2485 #else /* ! HAVE_TERMIOS */
2487 /* On Berkeley descendants, the following IOCTL's retrieve the
2488 current control characters. */
2489 #if defined (TIOCGLTC) && defined (TIOCGETC)
2497 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2498 send_process (proc
, &c
.t_intrc
, 1);
2501 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2502 send_process (proc
, &c
.t_quitc
, 1);
2506 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
2507 send_process (proc
, &lc
.t_suspc
, 1);
2509 #endif /* ! defined (SIGTSTP) */
2512 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2514 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2521 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2522 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2525 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2526 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2530 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2531 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2533 #endif /* ! defined (SIGTSTP) */
2535 #else /* ! defined (TCGETA) */
2536 Your configuration files are messed up
.
2537 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2538 you'd better be using one of the alternatives above! */
2539 #endif /* ! defined (TCGETA) */
2540 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2541 #endif /* ! defined HAVE_TERMIOS */
2542 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2545 /* Get the pgrp using the tty itself, if we have that.
2546 Otherwise, use the pty to get the pgrp.
2547 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2548 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2549 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2550 His patch indicates that if TIOCGPGRP returns an error, then
2551 we should just assume that p->pid is also the process group id. */
2555 if (!NILP (p
->subtty
))
2556 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2558 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
2562 gid
= - XFASTINT (p
->pid
);
2563 #endif /* ! defined (pfa) */
2569 #else /* ! defined (TIOCGPGRP ) */
2570 /* Can't select pgrps on this system, so we know that
2571 the child itself heads the pgrp. */
2572 gid
= - XFASTINT (p
->pid
);
2573 #endif /* ! defined (TIOCGPGRP ) */
2576 gid
= - XFASTINT (p
->pid
);
2582 p
->raw_status_low
= Qnil
;
2583 p
->raw_status_high
= Qnil
;
2585 XSETINT (p
->tick
, ++process_tick
);
2589 #endif /* ! defined (SIGCONT) */
2592 send_process (proc
, "\003", 1); /* ^C */
2597 send_process (proc
, "\031", 1); /* ^Y */
2602 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2605 flush_pending_output (XINT (p
->infd
));
2609 /* If we don't have process groups, send the signal to the immediate
2610 subprocess. That isn't really right, but it's better than any
2611 obvious alternative. */
2614 kill (XFASTINT (p
->pid
), signo
);
2618 /* gid may be a pid, or minus a pgrp's number */
2620 if (!NILP (current_group
))
2621 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
2624 gid
= - XFASTINT (p
->pid
);
2627 #else /* ! defined (TIOCSIGSEND) */
2628 EMACS_KILLPG (-gid
, signo
);
2629 #endif /* ! defined (TIOCSIGSEND) */
2632 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2633 "Interrupt process PROCESS. May be process or name of one.\n\
2634 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2635 Nil or no arg means current buffer's process.\n\
2636 Second arg CURRENT-GROUP non-nil means send signal to\n\
2637 the current process-group of the process's controlling terminal\n\
2638 rather than to the process's own process group.\n\
2639 If the process is a shell, this means interrupt current subjob\n\
2640 rather than the shell.")
2641 (process
, current_group
)
2642 Lisp_Object process
, current_group
;
2644 process_send_signal (process
, SIGINT
, current_group
, 0);
2648 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2649 "Kill process PROCESS. May be process or name of one.\n\
2650 See function `interrupt-process' for more details on usage.")
2651 (process
, current_group
)
2652 Lisp_Object process
, current_group
;
2654 process_send_signal (process
, SIGKILL
, current_group
, 0);
2658 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2659 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2660 See function `interrupt-process' for more details on usage.")
2661 (process
, current_group
)
2662 Lisp_Object process
, current_group
;
2664 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2668 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2669 "Stop process PROCESS. May be process or name of one.\n\
2670 See function `interrupt-process' for more details on usage.")
2671 (process
, current_group
)
2672 Lisp_Object process
, current_group
;
2675 error ("no SIGTSTP support");
2677 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2682 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2683 "Continue process PROCESS. May be process or name of one.\n\
2684 See function `interrupt-process' for more details on usage.")
2685 (process
, current_group
)
2686 Lisp_Object process
, current_group
;
2689 process_send_signal (process
, SIGCONT
, current_group
, 0);
2691 error ("no SIGCONT support");
2696 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2697 2, 2, "nProcess number: \nnSignal code: ",
2698 "Send the process with number PID the signal with code CODE.\n\
2699 Both PID and CODE are integers.")
2701 Lisp_Object pid
, sig
;
2703 CHECK_NUMBER (pid
, 0);
2704 CHECK_NUMBER (sig
, 1);
2705 return make_number (kill (XINT (pid
), XINT (sig
)));
2708 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2709 "Make PROCESS see end-of-file in its input.\n\
2710 Eof comes after any text already sent to it.\n\
2711 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2712 nil, indicating the current buffer's process.")
2714 Lisp_Object process
;
2718 proc
= get_process (process
);
2720 /* Make sure the process is really alive. */
2721 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2722 update_status (XPROCESS (proc
));
2723 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2724 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2726 /* Sending a zero-length record is supposed to mean eof
2727 when TIOCREMOTE is turned on. */
2731 write (XINT (XPROCESS (proc
)->outfd
), buf
, 0);
2733 #else /* did not do TOICREMOTE */
2735 send_process (proc
, "\032", 1); /* ^z */
2737 if (!NILP (XPROCESS (proc
)->pty_flag
))
2738 send_process (proc
, "\004", 1);
2741 close (XINT (XPROCESS (proc
)->outfd
));
2742 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, open (NULL_DEVICE
, O_WRONLY
));
2745 #endif /* did not do TOICREMOTE */
2749 /* Kill all processes associated with `buffer'.
2750 If `buffer' is nil, kill all processes */
2752 kill_buffer_processes (buffer
)
2755 Lisp_Object tail
, proc
;
2757 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2758 tail
= XCONS (tail
)->cdr
)
2760 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2761 if (XGCTYPE (proc
) == Lisp_Process
2762 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2764 if (NETCONN_P (proc
))
2765 deactivate_process (proc
);
2766 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
2767 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2772 /* On receipt of a signal that a child status has changed,
2773 loop asking about children with changed statuses until
2774 the system says there are no more.
2775 All we do is change the status;
2776 we do not run sentinels or print notifications.
2777 That is saved for the next time keyboard input is done,
2778 in order to avoid timing errors. */
2780 /** WARNING: this can be called during garbage collection.
2781 Therefore, it must not be fooled by the presence of mark bits in
2784 /** USG WARNING: Although it is not obvious from the documentation
2785 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2786 signal() before executing at least one wait(), otherwise the handler
2787 will be called again, resulting in an infinite loop. The relevant
2788 portion of the documentation reads "SIGCLD signals will be queued
2789 and the signal-catching function will be continually reentered until
2790 the queue is empty". Invoking signal() causes the kernel to reexamine
2791 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2794 sigchld_handler (signo
)
2797 int old_errno
= errno
;
2799 register struct Lisp_Process
*p
;
2800 extern EMACS_TIME
*input_available_clear_time
;
2804 sigheld
|= sigbit (SIGCHLD
);
2816 #endif /* no WUNTRACED */
2817 /* Keep trying to get a status until we get a definitive result. */
2821 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2823 while (pid
<= 0 && errno
== EINTR
);
2827 /* A real failure. We have done all our job, so return. */
2829 /* USG systems forget handlers when they are used;
2830 must reestablish each time */
2832 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2835 sigheld
&= ~sigbit (SIGCHLD
);
2843 #endif /* no WNOHANG */
2845 /* Find the process that signaled us, and record its status. */
2848 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2850 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2851 p
= XPROCESS (proc
);
2852 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2857 /* Look for an asynchronous process whose pid hasn't been filled
2860 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2862 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2863 p
= XPROCESS (proc
);
2864 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2869 /* Change the status of the process that was found. */
2872 union { int i
; WAITTYPE wt
; } u
;
2874 XSETINT (p
->tick
, ++process_tick
);
2876 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2877 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2879 /* If process has terminated, stop waiting for its output. */
2880 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2881 if (XINT (p
->infd
) >= 0)
2882 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
2884 /* Tell wait_reading_process_input that it needs to wake up and
2886 if (input_available_clear_time
)
2887 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2890 /* There was no asynchronous process found for that id. Check
2891 if we have a synchronous process. */
2894 synch_process_alive
= 0;
2896 /* Report the status of the synchronous process. */
2898 synch_process_retcode
= WRETCODE (w
);
2899 else if (WIFSIGNALED (w
))
2901 int code
= WTERMSIG (w
);
2907 signame
= sys_siglist
[code
];
2909 signame
= sys_errlist
[code
];
2913 signame
= "unknown";
2915 synch_process_death
= signame
;
2918 /* Tell wait_reading_process_input that it needs to wake up and
2920 if (input_available_clear_time
)
2921 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2924 /* On some systems, we must return right away.
2925 If any more processes want to signal us, we will
2927 Otherwise (on systems that have WNOHANG), loop around
2928 to use up all the processes that have something to tell us. */
2929 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2931 signal (signo
, sigchld_handler
);
2935 #endif /* USG, but not HPUX with WNOHANG */
2941 exec_sentinel_unwind (data
)
2944 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2949 exec_sentinel (proc
, reason
)
2950 Lisp_Object proc
, reason
;
2952 Lisp_Object sentinel
;
2953 register struct Lisp_Process
*p
= XPROCESS (proc
);
2954 int count
= specpdl_ptr
- specpdl
;
2956 sentinel
= p
->sentinel
;
2957 if (NILP (sentinel
))
2960 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2961 assure that it gets restored no matter how the sentinel exits. */
2963 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2964 /* Inhibit quit so that random quits don't screw up a running filter. */
2965 specbind (Qinhibit_quit
, Qt
);
2966 call2 (sentinel
, proc
, reason
);
2967 unbind_to (count
, Qnil
);
2970 /* Report all recent events of a change in process status
2971 (either run the sentinel or output a message).
2972 This is done while Emacs is waiting for keyboard input. */
2976 register Lisp_Object proc
, buffer
;
2977 Lisp_Object tail
, msg
;
2978 struct gcpro gcpro1
, gcpro2
;
2982 /* We need to gcpro tail; if read_process_output calls a filter
2983 which deletes a process and removes the cons to which tail points
2984 from Vprocess_alist, and then causes a GC, tail is an unprotected
2988 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2991 register struct Lisp_Process
*p
;
2993 proc
= Fcdr (Fcar (tail
));
2994 p
= XPROCESS (proc
);
2996 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2998 XSETINT (p
->update_tick
, XINT (p
->tick
));
3000 /* If process is still active, read any output that remains. */
3001 if (XINT (p
->infd
) >= 0)
3002 while (! EQ (p
->filter
, Qt
)
3003 && read_process_output (proc
, XINT (p
->infd
)) > 0);
3007 /* Get the text to use for the message. */
3008 if (!NILP (p
->raw_status_low
))
3010 msg
= status_message (p
->status
);
3012 /* If process is terminated, deactivate it or delete it. */
3014 if (XTYPE (p
->status
) == Lisp_Cons
)
3015 symbol
= XCONS (p
->status
)->car
;
3017 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
3018 || EQ (symbol
, Qclosed
))
3020 if (delete_exited_processes
)
3021 remove_process (proc
);
3023 deactivate_process (proc
);
3026 /* Now output the message suitably. */
3027 if (!NILP (p
->sentinel
))
3028 exec_sentinel (proc
, msg
);
3029 /* Don't bother with a message in the buffer
3030 when a process becomes runnable. */
3031 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
3033 Lisp_Object ro
, tem
;
3034 struct buffer
*old
= current_buffer
;
3037 ro
= XBUFFER (buffer
)->read_only
;
3039 /* Avoid error if buffer is deleted
3040 (probably that's why the process is dead, too) */
3041 if (NILP (XBUFFER (buffer
)->name
))
3043 Fset_buffer (buffer
);
3045 /* Insert new output into buffer
3046 at the current end-of-output marker,
3047 thus preserving logical ordering of input and output. */
3048 if (XMARKER (p
->mark
)->buffer
)
3049 SET_PT (marker_position (p
->mark
));
3052 if (point
<= opoint
)
3053 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
3055 tem
= current_buffer
->read_only
;
3056 current_buffer
->read_only
= Qnil
;
3057 insert_string ("\nProcess ");
3058 Finsert (1, &p
->name
);
3059 insert_string (" ");
3061 current_buffer
->read_only
= tem
;
3062 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
3065 set_buffer_internal (old
);
3070 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
3071 redisplay_preserve_echo_area ();
3073 update_tick
= process_tick
;
3084 if (! noninteractive
|| initialized
)
3086 signal (SIGCHLD
, sigchld_handler
);
3089 FD_ZERO (&input_wait_mask
);
3091 keyboard_descriptor
= 0;
3092 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3094 Vprocess_alist
= Qnil
;
3095 for (i
= 0; i
< MAXDESC
; i
++)
3097 chan_process
[i
] = Qnil
;
3098 proc_buffered_char
[i
] = -1;
3102 /* From now on, assume keyboard input comes from descriptor DESC. */
3105 change_keyboard_wait_descriptor (desc
)
3108 FD_CLR (keyboard_descriptor
, &input_wait_mask
);
3109 keyboard_descriptor
= desc
;
3110 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3116 stream_process
= intern ("stream");
3118 Qprocessp
= intern ("processp");
3119 staticpro (&Qprocessp
);
3120 Qrun
= intern ("run");
3122 Qstop
= intern ("stop");
3124 Qsignal
= intern ("signal");
3125 staticpro (&Qsignal
);
3127 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3130 Qexit = intern ("exit");
3131 staticpro (&Qexit); */
3133 Qopen
= intern ("open");
3135 Qclosed
= intern ("closed");
3136 staticpro (&Qclosed
);
3138 staticpro (&Vprocess_alist
);
3140 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3141 "*Non-nil means delete processes immediately when they exit.\n\
3142 nil means don't delete them until `list-processes' is run.");
3144 delete_exited_processes
= 1;
3146 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3147 "Control type of device used to communicate with subprocesses.\n\
3148 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3149 pty's are not available, this variable will be ignored. The value takes\n\
3150 effect when `start-process' is called.");
3151 Vprocess_connection_type
= Qt
;
3153 defsubr (&Sprocessp
);
3154 defsubr (&Sget_process
);
3155 defsubr (&Sget_buffer_process
);
3156 defsubr (&Sdelete_process
);
3157 defsubr (&Sprocess_status
);
3158 defsubr (&Sprocess_exit_status
);
3159 defsubr (&Sprocess_id
);
3160 defsubr (&Sprocess_name
);
3161 defsubr (&Sprocess_command
);
3162 defsubr (&Sset_process_buffer
);
3163 defsubr (&Sprocess_buffer
);
3164 defsubr (&Sprocess_mark
);
3165 defsubr (&Sset_process_filter
);
3166 defsubr (&Sprocess_filter
);
3167 defsubr (&Sset_process_sentinel
);
3168 defsubr (&Sset_process_window_size
);
3169 defsubr (&Sprocess_sentinel
);
3170 defsubr (&Sprocess_kill_without_query
);
3171 defsubr (&Slist_processes
);
3172 defsubr (&Sprocess_list
);
3173 defsubr (&Sstart_process
);
3175 defsubr (&Sopen_network_stream
);
3176 #endif /* HAVE_SOCKETS */
3177 defsubr (&Saccept_process_output
);
3178 defsubr (&Sprocess_send_region
);
3179 defsubr (&Sprocess_send_string
);
3180 defsubr (&Sinterrupt_process
);
3181 defsubr (&Skill_process
);
3182 defsubr (&Squit_process
);
3183 defsubr (&Sstop_process
);
3184 defsubr (&Scontinue_process
);
3185 defsubr (&Sprocess_send_eof
);
3186 defsubr (&Ssignal_process
);
3187 defsubr (&Swaiting_for_user_input_p
);
3188 /* defsubr (&Sprocess_connection); */
3192 #else /* not subprocesses */
3194 #include <sys/types.h>
3198 #include "systime.h"
3199 #include "termopts.h"
3201 extern int frame_garbaged
;
3204 /* As described above, except assuming that there are no subprocesses:
3206 Wait for timeout to elapse and/or keyboard input to be available.
3209 timeout in seconds, or
3210 zero for no limit, or
3211 -1 means gobble data immediately available but don't wait for any.
3213 read_kbd is a Lisp_Object:
3214 0 to ignore keyboard input, or
3215 1 to return when input is available, or
3216 -1 means caller will actually read the input, so don't throw to
3218 We know that read_kbd will never be a Lisp_Process, since
3219 `subprocesses' isn't defined.
3221 do_display != 0 means redisplay should be done to show subprocess
3222 output that arrives.
3224 Return true iff we received input from any process. */
3227 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3228 int time_limit
, microsecs
;
3229 Lisp_Object read_kbd
;
3232 EMACS_TIME end_time
, timeout
, *timeout_p
;
3235 /* What does time_limit really mean? */
3236 if (time_limit
|| microsecs
)
3238 /* It's not infinite. */
3239 timeout_p
= &timeout
;
3241 if (time_limit
== -1)
3242 /* In fact, it's zero. */
3243 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3245 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3247 /* How far in the future is that? */
3248 EMACS_GET_TIME (end_time
);
3249 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3252 /* It's infinite. */
3255 /* This must come before stop_polling. */
3256 prepare_menu_bars ();
3258 /* Turn off periodic alarms (in case they are in use)
3259 because the select emulator uses alarms. */
3266 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3268 /* If calling from keyboard input, do not quit
3269 since we want to return C-g as an input character.
3270 Otherwise, do pending quit if requested. */
3271 if (XINT (read_kbd
) >= 0)
3276 EMACS_GET_TIME (*timeout_p
);
3277 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3278 if (EMACS_TIME_NEG_P (*timeout_p
))
3282 /* Cause C-g and alarm signals to take immediate action,
3283 and cause input available signals to zero out timeout. */
3284 if (XINT (read_kbd
) < 0)
3285 set_waiting_for_input (&timeout
);
3287 /* If a frame has been newly mapped and needs updating,
3288 reprocess its display stuff. */
3289 if (frame_garbaged
&& do_display
)
3290 redisplay_preserve_echo_area ();
3292 if (XINT (read_kbd
) && detect_input_pending ())
3295 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3297 /* Make C-g and alarm signals set flags again */
3298 clear_waiting_for_input ();
3300 /* If we woke up due to SIGWINCH, actually change size now. */
3301 do_pending_window_change ();
3305 /* If the system call was interrupted, then go around the
3311 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3312 /* System sometimes fails to deliver SIGIO. */
3313 kill (getpid (), SIGIO
);
3316 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3320 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3332 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3333 /* Don't confuse make-docfile by having two doc strings for this function.
3334 make-docfile does not pay attention to #if, for good reason! */
3337 register Lisp_Object name
;
3342 /* Kill all processes associated with `buffer'.
3343 If `buffer' is nil, kill all processes.
3344 Since we have no subprocesses, this does nothing. */
3346 kill_buffer_processes (buffer
)
3357 defsubr (&Sget_buffer_process
);
3361 #endif /* not subprocesses */