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
;
548 proc
= Fget_buffer_process (Fcurrent_buffer ());
551 proc
= Fget_process (name
);
553 proc
= Fget_buffer_process (Fget_buffer (name
));
560 error ("Current buffer has no process");
562 error ("Process %s does not exist", XSTRING (name
)->data
);
566 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
567 "Delete PROCESS: kill it and forget about it immediately.\n\
568 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
569 nil, indicating the current buffer's process.")
571 register Lisp_Object proc
;
573 proc
= get_process (proc
);
574 XPROCESS (proc
)->raw_status_low
= Qnil
;
575 XPROCESS (proc
)->raw_status_high
= Qnil
;
576 if (NETCONN_P (proc
))
578 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
579 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
581 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
583 Fkill_process (proc
, Qnil
);
584 /* Do this now, since remove_process will make sigchld_handler do nothing. */
585 XPROCESS (proc
)->status
586 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
587 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
590 remove_process (proc
);
594 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
595 "Return the status of PROCESS: a symbol, one of these:\n\
596 run -- for a process that is running.\n\
597 stop -- for a process stopped but continuable.\n\
598 exit -- for a process that has exited.\n\
599 signal -- for a process that has got a fatal signal.\n\
600 open -- for a network stream connection that is open.\n\
601 closed -- for a network stream connection that is closed.\n\
602 nil -- if arg is a process name and no such process exists.\n\
603 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
604 nil, indicating the current buffer's process.")
606 register Lisp_Object proc
;
608 register struct Lisp_Process
*p
;
609 register Lisp_Object status
;
610 proc
= get_process (proc
);
614 if (!NILP (p
->raw_status_low
))
617 if (XTYPE (status
) == Lisp_Cons
)
618 status
= XCONS (status
)->car
;
619 if (NETCONN_P (proc
))
621 if (EQ (status
, Qrun
))
623 else if (EQ (status
, Qexit
))
629 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
631 "Return the exit status of PROCESS or the signal number that killed it.\n\
632 If PROCESS has not yet exited or died, return 0.")
634 register Lisp_Object proc
;
636 CHECK_PROCESS (proc
, 0);
637 if (!NILP (XPROCESS (proc
)->raw_status_low
))
638 update_status (XPROCESS (proc
));
639 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
640 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
641 return make_number (0);
644 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
645 "Return the process id of PROCESS.\n\
646 This is the pid of the Unix process which PROCESS uses or talks to.\n\
647 For a network connection, this value is nil.")
649 register Lisp_Object proc
;
651 CHECK_PROCESS (proc
, 0);
652 return XPROCESS (proc
)->pid
;
655 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
656 "Return the name of PROCESS, as a string.\n\
657 This is the name of the program invoked in PROCESS,\n\
658 possibly modified to make it unique among process names.")
660 register Lisp_Object proc
;
662 CHECK_PROCESS (proc
, 0);
663 return XPROCESS (proc
)->name
;
666 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
667 "Return the command that was executed to start PROCESS.\n\
668 This is a list of strings, the first string being the program executed\n\
669 and the rest of the strings being the arguments given to it.\n\
670 For a non-child channel, this is nil.")
672 register Lisp_Object proc
;
674 CHECK_PROCESS (proc
, 0);
675 return XPROCESS (proc
)->command
;
678 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
680 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
682 register Lisp_Object proc
, buffer
;
684 CHECK_PROCESS (proc
, 0);
686 CHECK_BUFFER (buffer
, 1);
687 XPROCESS (proc
)->buffer
= buffer
;
691 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
693 "Return the buffer PROCESS is associated with.\n\
694 Output from PROCESS is inserted in this buffer\n\
695 unless PROCESS has a filter.")
697 register Lisp_Object proc
;
699 CHECK_PROCESS (proc
, 0);
700 return XPROCESS (proc
)->buffer
;
703 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
705 "Return the marker for the end of the last output from PROCESS.")
707 register Lisp_Object proc
;
709 CHECK_PROCESS (proc
, 0);
710 return XPROCESS (proc
)->mark
;
713 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
715 "Give PROCESS the filter function FILTER; nil means no filter.\n\
716 t means stop accepting output from the process.\n\
717 When a process has a filter, each time it does output\n\
718 the entire string of output is passed to the filter.\n\
719 The filter gets two arguments: the process and the string of output.\n\
720 If the process has a filter, its buffer is not used for output.")
722 register Lisp_Object proc
, filter
;
724 CHECK_PROCESS (proc
, 0);
726 FD_CLR (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
727 else if (EQ (XPROCESS (proc
)->filter
, Qt
))
728 FD_SET (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
729 XPROCESS (proc
)->filter
= filter
;
733 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
735 "Returns the filter function of PROCESS; nil if none.\n\
736 See `set-process-filter' for more info on filter functions.")
738 register Lisp_Object proc
;
740 CHECK_PROCESS (proc
, 0);
741 return XPROCESS (proc
)->filter
;
744 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
746 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
747 The sentinel is called as a function when the process changes state.\n\
748 It gets two arguments: the process, and a string describing the change.")
750 register Lisp_Object proc
, sentinel
;
752 CHECK_PROCESS (proc
, 0);
753 XPROCESS (proc
)->sentinel
= sentinel
;
757 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
759 "Return the sentinel of PROCESS; nil if none.\n\
760 See `set-process-sentinel' for more info on sentinels.")
762 register Lisp_Object proc
;
764 CHECK_PROCESS (proc
, 0);
765 return XPROCESS (proc
)->sentinel
;
768 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
769 Sprocess_kill_without_query
, 1, 2, 0,
770 "Say no query needed if PROCESS is running when Emacs is exited.\n\
771 Optional second argument if non-nil says to require a query.\n\
772 Value is t if a query was formerly required.")
774 register Lisp_Object proc
, value
;
778 CHECK_PROCESS (proc
, 0);
779 tem
= XPROCESS (proc
)->kill_without_query
;
780 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
785 #if 0 /* Turned off because we don't currently record this info
786 in the process. Perhaps add it. */
787 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
788 "Return the connection type of `PROCESS'.\n\
789 The value is `nil' for a pipe,\n\
790 `t' or `pty' for a pty, or `stream' for a socket connection.")
794 return XPROCESS (process
)->type
;
801 register Lisp_Object tail
, tem
;
802 Lisp_Object proc
, minspace
, tem1
;
803 register struct buffer
*old
= current_buffer
;
804 register struct Lisp_Process
*p
;
808 XFASTINT (minspace
) = 1;
810 set_buffer_internal (XBUFFER (Vstandard_output
));
811 Fbuffer_disable_undo (Vstandard_output
);
813 current_buffer
->truncate_lines
= Qt
;
816 Proc Status Buffer Command\n\
817 ---- ------ ------ -------\n", -1);
819 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
823 proc
= Fcdr (Fcar (tail
));
825 if (NILP (p
->childp
))
828 Finsert (1, &p
->name
);
829 Findent_to (make_number (13), minspace
);
831 if (!NILP (p
->raw_status_low
))
834 if (XTYPE (p
->status
) == Lisp_Cons
)
835 symbol
= XCONS (p
->status
)->car
;
838 if (EQ (symbol
, Qsignal
))
841 tem
= Fcar (Fcdr (p
->status
));
843 if (XINT (tem
) < NSIG
)
844 write_string (sys_errlist
[XINT (tem
)], -1);
847 Fprinc (symbol
, Qnil
);
849 else if (NETCONN_P (proc
))
851 if (EQ (symbol
, Qrun
))
852 write_string ("open", -1);
853 else if (EQ (symbol
, Qexit
))
854 write_string ("closed", -1);
856 Fprinc (symbol
, Qnil
);
859 Fprinc (symbol
, Qnil
);
861 if (EQ (symbol
, Qexit
))
864 tem
= Fcar (Fcdr (p
->status
));
867 sprintf (tembuf
, " %d", XFASTINT (tem
));
868 write_string (tembuf
, -1);
872 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
873 remove_process (proc
);
875 Findent_to (make_number (22), minspace
);
876 if (NILP (p
->buffer
))
877 insert_string ("(none)");
878 else if (NILP (XBUFFER (p
->buffer
)->name
))
879 insert_string ("(Killed)");
881 Finsert (1, &XBUFFER (p
->buffer
)->name
);
883 Findent_to (make_number (37), minspace
);
885 if (NETCONN_P (proc
))
887 sprintf (tembuf
, "(network stream connection to %s)\n",
888 XSTRING (p
->childp
)->data
);
889 insert_string (tembuf
);
903 insert_string ("\n");
909 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
910 "Display a list of all processes.\n\
911 \(Any processes listed as Exited or Signaled are actually eliminated\n\
912 after the listing is made.)")
915 internal_with_output_to_temp_buffer ("*Process List*",
916 list_processes_1
, Qnil
);
920 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
921 "Return a list of all processes.")
924 return Fmapcar (Qcdr
, Vprocess_alist
);
927 /* Starting asynchronous inferior processes. */
929 static Lisp_Object
start_process_unwind ();
931 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
932 "Start a program in a subprocess. Return the process object for it.\n\
933 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
934 NAME is name for process. It is modified if necessary to make it unique.\n\
935 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
936 Process output goes at end of that buffer, unless you specify\n\
937 an output stream or filter function to handle the output.\n\
938 BUFFER may be also nil, meaning that this process is not associated\n\
940 Third arg is program file name. It is searched for as in the shell.\n\
941 Remaining arguments are strings to give program as arguments.")
944 register Lisp_Object
*args
;
946 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
948 register unsigned char *new_argv
;
951 register unsigned char **new_argv
;
954 int count
= specpdl_ptr
- specpdl
;
958 buffer
= Fget_buffer_create (buffer
);
960 /* Make sure that the child will be able to chdir to the current
961 buffer's current directory, or its unhandled equivalent. We
962 can't just have the child check for an error when it does the
963 chdir, since it's in a vfork.
965 We have to GCPRO around this because Fexpand_file_name and
966 Funhandled_file_name_directory might call a file name handling
967 function. The argument list is protected by the caller, so all
968 we really have to worry about is buffer. */
970 struct gcpro gcpro1
, gcpro2
;
972 current_dir
= current_buffer
->directory
;
974 GCPRO2 (buffer
, current_dir
);
977 expand_and_dir_to_file
978 (Funhandled_file_name_directory (current_dir
), Qnil
);
979 if (NILP (Ffile_accessible_directory_p (current_dir
)))
980 report_file_error ("Setting current directory",
981 Fcons (current_buffer
->directory
, Qnil
));
987 CHECK_STRING (name
, 0);
991 CHECK_STRING (program
, 2);
994 /* Make a one member argv with all args concatenated
995 together separated by a blank. */
996 len
= XSTRING (program
)->size
+ 2;
997 for (i
= 3; i
< nargs
; i
++)
1000 CHECK_STRING (tem
, i
);
1001 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1003 new_argv
= (unsigned char *) alloca (len
);
1004 strcpy (new_argv
, XSTRING (program
)->data
);
1005 for (i
= 3; i
< nargs
; i
++)
1008 CHECK_STRING (tem
, i
);
1009 strcat (new_argv
, " ");
1010 strcat (new_argv
, XSTRING (tem
)->data
);
1012 /* Need to add code here to check for program existence on VMS */
1015 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1017 for (i
= 3; i
< nargs
; i
++)
1020 CHECK_STRING (tem
, i
);
1021 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1023 new_argv
[i
- 2] = 0;
1024 new_argv
[0] = XSTRING (program
)->data
;
1026 /* If program file name is not absolute, search our path for it */
1027 if (new_argv
[0][0] != '/')
1030 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1032 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1033 new_argv
[0] = XSTRING (tem
)->data
;
1035 #endif /* not VMS */
1037 proc
= make_process (name
);
1038 /* If an error occurs and we can't start the process, we want to
1039 remove it from the process list. This means that each error
1040 check in create_process doesn't need to call remove_process
1041 itself; it's all taken care of here. */
1042 record_unwind_protect (start_process_unwind
, proc
);
1044 XPROCESS (proc
)->childp
= Qt
;
1045 XPROCESS (proc
)->command_channel_p
= Qnil
;
1046 XPROCESS (proc
)->buffer
= buffer
;
1047 XPROCESS (proc
)->sentinel
= Qnil
;
1048 XPROCESS (proc
)->filter
= Qnil
;
1049 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1051 create_process (proc
, new_argv
, current_dir
);
1053 return unbind_to (count
, proc
);
1056 /* This function is the unwind_protect form for Fstart_process. If
1057 PROC doesn't have its pid set, then we know someone has signalled
1058 an error and the process wasn't started successfully, so we should
1059 remove it from the process list. */
1061 start_process_unwind (proc
)
1064 if (XTYPE (proc
) != Lisp_Process
)
1067 /* Was PROC started successfully? */
1068 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1069 remove_process (proc
);
1076 create_process_1 (signo
)
1080 /* USG systems forget handlers when they are used;
1081 must reestablish each time */
1082 signal (signo
, create_process_1
);
1086 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1089 /* Mimic blocking of signals on system V, which doesn't really have it. */
1091 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1092 int sigchld_deferred
;
1095 create_process_sigchld ()
1097 signal (SIGCHLD
, create_process_sigchld
);
1099 sigchld_deferred
= 1;
1105 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1106 create_process (process
, new_argv
, current_dir
)
1107 Lisp_Object process
;
1109 Lisp_Object current_dir
;
1111 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1114 SIGTYPE (*sigchld
)();
1117 extern char **environ
;
1119 inchannel
= outchannel
= -1;
1122 if (EQ (Vprocess_connection_type
, Qt
))
1123 outchannel
= inchannel
= allocate_pty ();
1128 /* On USG systems it does not work to open the pty's tty here
1129 and then close and reopen it in the child. */
1131 /* Don't let this terminal become our controlling terminal
1132 (in case we don't have one). */
1133 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1135 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1138 report_file_error ("Opening pty", Qnil
);
1140 forkin
= forkout
= -1;
1141 #endif /* not USG */
1145 #endif /* HAVE_PTYS */
1148 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1149 report_file_error ("Opening socketpair", Qnil
);
1150 outchannel
= inchannel
= sv
[0];
1151 forkout
= forkin
= sv
[1];
1153 #else /* not SKTPAIR */
1162 #endif /* not SKTPAIR */
1165 /* Replaced by close_process_descs */
1166 set_exclusive_use (inchannel
);
1167 set_exclusive_use (outchannel
);
1170 /* Stride people say it's a mystery why this is needed
1171 as well as the O_NDELAY, but that it fails without this. */
1172 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1175 ioctl (inchannel
, FIONBIO
, &one
);
1180 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1183 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1187 /* Record this as an active process, with its channels.
1188 As a result, child_setup will close Emacs's side of the pipes. */
1189 chan_process
[inchannel
] = process
;
1190 XSET (XPROCESS (process
)->infd
, Lisp_Int
, inchannel
);
1191 XSET (XPROCESS (process
)->outfd
, Lisp_Int
, outchannel
);
1192 /* Record the tty descriptor used in the subprocess. */
1194 XPROCESS (process
)->subtty
= Qnil
;
1196 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1197 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1198 XPROCESS (process
)->status
= Qrun
;
1200 /* Delay interrupts until we have a chance to store
1201 the new fork's pid in its process structure */
1205 #else /* not BSD4_1 */
1206 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1207 sigsetmask (sigmask (SIGCHLD
));
1208 #else /* ordinary USG */
1210 sigchld_deferred
= 0;
1211 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1213 #endif /* ordinary USG */
1214 #endif /* not BSD4_1 */
1215 #endif /* SIGCHLD */
1217 /* Until we store the proper pid, enable sigchld_handler
1218 to recognize an unknown pid as standing for this process.
1219 It is very important not to let this `marker' value stay
1220 in the table after this function has returned; if it does
1221 it might cause call-process to hang and subsequent asynchronous
1222 processes to get their return values scrambled. */
1223 XSETINT (XPROCESS (process
)->pid
, -1);
1226 /* child_setup must clobber environ on systems with true vfork.
1227 Protect it from permanent change. */
1228 char **save_environ
= environ
;
1233 int xforkin
= forkin
;
1234 int xforkout
= forkout
;
1236 #if 0 /* This was probably a mistake--it duplicates code later on,
1237 but fails to handle all the cases. */
1238 /* Make sure SIGCHLD is not blocked in the child. */
1239 sigsetmask (SIGEMPTYMASK
);
1242 /* Make the pty be the controlling terminal of the process. */
1244 /* First, disconnect its current controlling terminal. */
1248 /* Make the pty's terminal the controlling terminal. */
1250 /* We ignore the return value
1251 because faith@cs.unc.edu says that is necessary on Linux. */
1252 ioctl (xforkin
, TIOCSCTTY
, 0);
1254 #else /* not HAVE_SETSID */
1256 /* It's very important to call setpgrp here and no time
1257 afterwards. Otherwise, we lose our controlling tty which
1258 is set when we open the pty. */
1261 #endif /* not HAVE_SETSID */
1265 /* Use new line discipline. */
1266 int ldisc
= NTTYDISC
;
1267 if (ioctl (xforkin
, TIOCSETD
, &ldisc
) < 0)
1268 write (1, "create_process/TIOCSETD failed\n", 31);
1272 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1273 can do TIOCSPGRP only to the process's controlling tty. */
1276 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1277 I can't test it since I don't have 4.3. */
1278 int j
= open ("/dev/tty", O_RDWR
, 0);
1279 ioctl (j
, TIOCNOTTY
, 0);
1282 /* In order to get a controlling terminal on some versions
1283 of BSD, it is necessary to put the process in pgrp 0
1284 before it opens the terminal. */
1288 #endif /* TIOCNOTTY */
1290 #if !defined (RTU) && !defined (UNIPLUS)
1291 /*** There is a suggestion that this ought to be a
1292 conditional on TIOCSPGRP. */
1293 /* Now close the pty (if we had it open) and reopen it.
1294 This makes the pty the controlling terminal of the subprocess. */
1297 #ifdef SET_CHILD_PTY_PGRP
1298 int pgrp
= getpid ();
1301 /* I wonder if close (open (pty_name, ...)) would work? */
1304 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1306 #ifdef SET_CHILD_PTY_PGRP
1307 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1308 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1314 #endif /* not UNIPLUS and not RTU */
1315 #ifdef SETUP_SLAVE_PTY
1317 #endif /* SETUP_SLAVE_PTY */
1319 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1320 Now reenable it in the child, so it will die when we want it to. */
1322 signal (SIGHUP
, SIG_DFL
);
1324 #endif /* HAVE_PTYS */
1329 #else /* not BSD4_1 */
1330 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1331 sigsetmask (SIGEMPTYMASK
);
1332 #else /* ordinary USG */
1334 signal (SIGCHLD
, sigchld
);
1336 #endif /* ordinary USG */
1337 #endif /* not BSD4_1 */
1338 #endif /* SIGCHLD */
1340 child_setup_tty (xforkout
);
1341 child_setup (xforkin
, xforkout
, xforkout
,
1342 new_argv
, 1, current_dir
);
1344 environ
= save_environ
;
1348 report_file_error ("Doing vfork", Qnil
);
1350 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1352 FD_SET (inchannel
, &input_wait_mask
);
1354 /* If the subfork execv fails, and it exits,
1355 this close hangs. I don't know why.
1356 So have an interrupt jar it loose. */
1358 signal (SIGALRM
, create_process_1
);
1360 XPROCESS (process
)->subtty
= Qnil
;
1365 if (forkin
!= forkout
&& forkout
>= 0)
1371 #else /* not BSD4_1 */
1372 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1373 sigsetmask (SIGEMPTYMASK
);
1374 #else /* ordinary USG */
1376 signal (SIGCHLD
, sigchld
);
1377 /* Now really handle any of these signals
1378 that came in during this function. */
1379 if (sigchld_deferred
)
1380 kill (getpid (), SIGCHLD
);
1382 #endif /* ordinary USG */
1383 #endif /* not BSD4_1 */
1384 #endif /* SIGCHLD */
1386 #endif /* not VMS */
1390 /* open a TCP network connection to a given HOST/SERVICE. Treated
1391 exactly like a normal process when reading and writing. Only
1392 differences are in status display and process deletion. A network
1393 connection has no PID; you cannot signal it. All you can do is
1394 deactivate and close it via delete-process */
1396 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1398 "Open a TCP connection for a service to a host.\n\
1399 Returns a subprocess-object to represent the connection.\n\
1400 Input and output work as for subprocesses; `delete-process' closes it.\n\
1401 Args are NAME BUFFER HOST SERVICE.\n\
1402 NAME is name for process. It is modified if necessary to make it unique.\n\
1403 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1404 Process output goes at end of that buffer, unless you specify\n\
1405 an output stream or filter function to handle the output.\n\
1406 BUFFER may be also nil, meaning that this process is not associated\n\
1408 Third arg is name of the host to connect to, or its IP address.\n\
1409 Fourth arg SERVICE is name of the service desired, or an integer\n\
1410 specifying a port number to connect to.")
1411 (name
, buffer
, host
, service
)
1412 Lisp_Object name
, buffer
, host
, service
;
1416 struct sockaddr_in address
;
1417 struct servent
*svc_info
;
1418 struct hostent
*host_info_ptr
, host_info
;
1419 char *(addr_list
[2]);
1420 IN_ADDR numeric_addr
;
1424 struct hostent host_info_fixed
;
1425 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1427 GCPRO4 (name
, buffer
, host
, service
);
1428 CHECK_STRING (name
, 0);
1429 CHECK_STRING (host
, 0);
1430 if (XTYPE(service
) == Lisp_Int
)
1431 port
= htons ((unsigned short) XINT (service
));
1434 CHECK_STRING (service
, 0);
1435 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1437 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1438 port
= svc_info
->s_port
;
1442 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1443 if (host_info_ptr
== 0)
1444 /* Attempt to interpret host as numeric inet address */
1446 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1447 if (NUMERIC_ADDR_ERROR
)
1448 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1450 host_info_ptr
= &host_info
;
1451 host_info
.h_name
= 0;
1452 host_info
.h_aliases
= 0;
1453 host_info
.h_addrtype
= AF_INET
;
1455 /* Older machines have only one address slot called h_addr.
1456 Newer machines have h_addr_list, but #define h_addr to
1457 be its first element. */
1458 host_info
.h_addr_list
= &(addr_list
[0]);
1460 host_info
.h_addr
= (char*)(&numeric_addr
);
1462 host_info
.h_length
= strlen (addr_list
[0]);
1465 bzero (&address
, sizeof address
);
1466 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1467 host_info_ptr
->h_length
);
1468 address
.sin_family
= host_info_ptr
->h_addrtype
;
1469 address
.sin_port
= port
;
1471 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1473 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1475 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1476 when connect is interrupted. So let's not let it get interrupted.
1477 Note we do not turn off polling, because polling is only used
1478 when not interrupt_input, and thus not normally used on the systems
1479 which have this bug. On systems which use polling, there's no way
1480 to quit if polling is turned off. */
1481 if (interrupt_input
)
1485 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1492 if (interrupt_input
)
1496 report_file_error ("connection failed",
1497 Fcons (host
, Fcons (name
, Qnil
)));
1500 if (interrupt_input
)
1504 s
= connect_server (0);
1506 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1507 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1508 send_command (s
, C_DUMB
, 1, 0);
1514 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1517 buffer
= Fget_buffer_create (buffer
);
1518 proc
= make_process (name
);
1520 chan_process
[inch
] = proc
;
1523 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1526 fcntl (inch
, F_SETFL
, O_NDELAY
);
1530 XPROCESS (proc
)->childp
= host
;
1531 XPROCESS (proc
)->command_channel_p
= Qnil
;
1532 XPROCESS (proc
)->buffer
= buffer
;
1533 XPROCESS (proc
)->sentinel
= Qnil
;
1534 XPROCESS (proc
)->filter
= Qnil
;
1535 XPROCESS (proc
)->command
= Qnil
;
1536 XPROCESS (proc
)->pid
= Qnil
;
1537 XSET (XPROCESS (proc
)->infd
, Lisp_Int
, s
);
1538 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, outch
);
1539 XPROCESS (proc
)->status
= Qrun
;
1540 FD_SET (inch
, &input_wait_mask
);
1545 #endif /* HAVE_SOCKETS */
1547 deactivate_process (proc
)
1550 register int inchannel
, outchannel
;
1551 register struct Lisp_Process
*p
= XPROCESS (proc
);
1553 inchannel
= XINT (p
->infd
);
1554 outchannel
= XINT (p
->outfd
);
1558 /* Beware SIGCHLD hereabouts. */
1559 flush_pending_output (inchannel
);
1562 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1563 sys$
dassgn (outchannel
);
1564 vs
= get_vms_process_pointer (p
->pid
);
1566 give_back_vms_process_stuff (vs
);
1570 if (outchannel
>= 0 && outchannel
!= inchannel
)
1574 XSET (p
->infd
, Lisp_Int
, -1);
1575 XSET (p
->outfd
, Lisp_Int
, -1);
1576 chan_process
[inchannel
] = Qnil
;
1577 FD_CLR (inchannel
, &input_wait_mask
);
1581 /* Close all descriptors currently in use for communication
1582 with subprocess. This is used in a newly-forked subprocess
1583 to get rid of irrelevant descriptors. */
1585 close_process_descs ()
1588 for (i
= 0; i
< MAXDESC
; i
++)
1590 Lisp_Object process
;
1591 process
= chan_process
[i
];
1592 if (!NILP (process
))
1594 int in
= XINT (XPROCESS (process
)->infd
);
1595 int out
= XINT (XPROCESS (process
)->outfd
);
1598 if (out
>= 0 && in
!= out
)
1604 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1606 "Allow any pending output from subprocesses to be read by Emacs.\n\
1607 It is read into the process' buffers or given to their filter functions.\n\
1608 Non-nil arg PROCESS means do not return until some output has been received\n\
1610 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1611 seconds and microseconds to wait; return after that much time whether\n\
1612 or not there is input.\n\
1613 Return non-nil iff we received any output before the timeout expired.")
1614 (proc
, timeout
, timeout_msecs
)
1615 register Lisp_Object proc
, timeout
, timeout_msecs
;
1620 if (! NILP (timeout_msecs
))
1622 CHECK_NUMBER (timeout_msecs
, 2);
1623 useconds
= XINT (timeout_msecs
);
1624 if (XTYPE (timeout
) != Lisp_Int
)
1625 XSET (timeout
, Lisp_Int
, 0);
1628 int carry
= useconds
/ 1000000;
1630 XSETINT (timeout
, XINT (timeout
) + carry
);
1631 useconds
-= carry
* 1000000;
1633 /* I think this clause is necessary because C doesn't
1634 guarantee a particular rounding direction for negative
1638 XSETINT (timeout
, XINT (timeout
) - 1);
1639 useconds
+= 1000000;
1646 if (! NILP (timeout
))
1648 CHECK_NUMBER (timeout
, 1);
1649 seconds
= XINT (timeout
);
1662 XFASTINT (proc
) = 0;
1665 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1669 /* This variable is different from waiting_for_input in keyboard.c.
1670 It is used to communicate to a lisp process-filter/sentinel (via the
1671 function Fwaiting_for_user_input_p below) whether emacs was waiting
1672 for user-input when that process-filter was called.
1673 waiting_for_input cannot be used as that is by definition 0 when
1674 lisp code is being evalled */
1675 static int waiting_for_user_input_p
;
1677 /* Read and dispose of subprocess output while waiting for timeout to
1678 elapse and/or keyboard input to be available.
1681 timeout in seconds, or
1682 zero for no limit, or
1683 -1 means gobble data immediately available but don't wait for any.
1686 an additional duration to wait, measured in microseconds.
1687 If this is nonzero and time_limit is 0, then the timeout
1688 consists of MICROSECS only.
1690 READ_KBD is a lisp value:
1691 0 to ignore keyboard input, or
1692 1 to return when input is available, or
1693 -1 meaning caller will actually read the input, so don't throw to
1694 the quit handler, or
1695 a cons cell, meaning wait wait until its car is non-nil
1696 (and gobble terminal input into the buffer if any arrives), or
1697 a process object, meaning wait until something arrives from that
1698 process. The return value is true iff we read some input from
1701 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1702 output that arrives.
1704 If READ_KBD is a pointer to a struct Lisp_Process, then the
1705 function returns true iff we received input from that process
1706 before the timeout elapsed.
1707 Otherwise, return true iff we received input from any process. */
1709 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1710 int time_limit
, microsecs
;
1711 Lisp_Object read_kbd
;
1714 register int channel
, nfds
, m
;
1715 static SELECT_TYPE Available
;
1718 EMACS_TIME timeout
, end_time
, garbage
;
1720 int wait_channel
= -1;
1721 struct Lisp_Process
*wait_proc
= 0;
1722 int got_some_input
= 0;
1723 Lisp_Object
*wait_for_cell
= 0;
1725 FD_ZERO (&Available
);
1727 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1729 if (XTYPE (read_kbd
) == Lisp_Process
)
1731 wait_proc
= XPROCESS (read_kbd
);
1732 wait_channel
= XINT (wait_proc
->infd
);
1733 XFASTINT (read_kbd
) = 0;
1736 /* If waiting for non-nil in a cell, record where. */
1737 if (XTYPE (read_kbd
) == Lisp_Cons
)
1739 wait_for_cell
= &XCONS (read_kbd
)->car
;
1740 XFASTINT (read_kbd
) = 0;
1743 waiting_for_user_input_p
= XINT (read_kbd
);
1745 /* Since we may need to wait several times,
1746 compute the absolute time to return at. */
1747 if (time_limit
|| microsecs
)
1749 EMACS_GET_TIME (end_time
);
1750 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1751 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1754 /* It would not be safe to call this below,
1755 where we call redisplay_preserve_echo_area. */
1756 prepare_menu_bars ();
1760 /* If calling from keyboard input, do not quit
1761 since we want to return C-g as an input character.
1762 Otherwise, do pending quit if requested. */
1763 if (XINT (read_kbd
) >= 0)
1766 /* Exit now if the cell we're waiting for became non-nil. */
1767 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1770 /* Compute time from now till when time limit is up */
1771 /* Exit if already run out */
1772 if (time_limit
== -1)
1774 /* -1 specified for timeout means
1775 gobble output available now
1776 but don't wait at all. */
1778 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1780 else if (time_limit
|| microsecs
)
1782 EMACS_GET_TIME (timeout
);
1783 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1784 if (EMACS_TIME_NEG_P (timeout
))
1789 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1792 /* Cause C-g and alarm signals to take immediate action,
1793 and cause input available signals to zero out timeout.
1795 It is important that we do this before checking for process
1796 activity. If we get a SIGCHLD after the explicit checks for
1797 process activity, timeout is the only way we will know. */
1798 if (XINT (read_kbd
) < 0)
1799 set_waiting_for_input (&timeout
);
1801 /* If status of something has changed, and no input is
1802 available, notify the user of the change right away. After
1803 this explicit check, we'll let the SIGCHLD handler zap
1804 timeout to get our attention. */
1805 if (update_tick
!= process_tick
&& do_display
)
1807 Atemp
= input_wait_mask
;
1808 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1809 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1811 /* It's okay for us to do this and then continue with
1812 the loop, since timeout has already been zeroed out. */
1813 clear_waiting_for_input ();
1818 /* Don't wait for output from a non-running process. */
1819 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1820 update_status (wait_proc
);
1822 && ! EQ (wait_proc
->status
, Qrun
))
1824 clear_waiting_for_input ();
1828 /* Wait till there is something to do */
1830 Available
= input_wait_mask
;
1831 /* We used to have && wait_for_cell == 0
1832 but that led to lossage handling selection_request events:
1833 within one, we would start to handle another. */
1834 if (! XINT (read_kbd
))
1835 FD_CLR (keyboard_descriptor
, &Available
);
1837 /* If frame size has changed or the window is newly mapped,
1838 redisplay now, before we start to wait. There is a race
1839 condition here; if a SIGIO arrives between now and the select
1840 and indicates that a frame is trashed, the select may block
1841 displaying a trashed screen. */
1843 redisplay_preserve_echo_area ();
1845 if (XINT (read_kbd
) && detect_input_pending ())
1848 FD_ZERO (&Available
);
1851 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1855 /* Make C-g and alarm signals set flags again */
1856 clear_waiting_for_input ();
1858 /* If we woke up due to SIGWINCH, actually change size now. */
1859 do_pending_window_change ();
1861 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1865 if (xerrno
== EINTR
)
1866 FD_ZERO (&Available
);
1868 /* Ultrix select seems to return ENOMEM when it is
1869 interrupted. Treat it just like EINTR. Bleah. Note
1870 that we want to test for the "ultrix" CPP symbol, not
1871 "__ultrix__"; the latter is only defined under GCC, but
1872 not by DEC's bundled CC. -JimB */
1873 else if (xerrno
== ENOMEM
)
1874 FD_ZERO (&Available
);
1877 /* This happens for no known reason on ALLIANT.
1878 I am guessing that this is the right response. -- RMS. */
1879 else if (xerrno
== EFAULT
)
1880 FD_ZERO (&Available
);
1882 else if (xerrno
== EBADF
)
1885 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1886 the child's closure of the pts gives the parent a SIGHUP, and
1887 the ptc file descriptor is automatically closed,
1888 yielding EBADF here or at select() call above.
1889 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1890 in m/ibmrt-aix.h), and here we just ignore the select error.
1891 Cleanup occurs c/o status_notify after SIGCLD. */
1892 FD_ZERO (&Available
); /* Cannot depend on values returned */
1898 error("select error: %s", strerror (xerrno
));
1900 #if defined(sun) && !defined(USG5_4)
1901 else if (nfds
> 0 && FD_ISSET (keyboard_descriptor
, &Available
)
1903 /* System sometimes fails to deliver SIGIO.
1905 David J. Mackenzie says that Emacs doesn't compile under
1906 Solaris if this code is enabled, thus the USG5_4 in the CPP
1907 conditional. "I haven't noticed any ill effects so far.
1908 If you find a Solaris expert somewhere, they might know
1910 kill (getpid (), SIGIO
);
1913 /* Check for keyboard input */
1914 /* If there is any, return immediately
1915 to give it higher priority than subprocesses */
1917 /* We used to do his if wait_for_cell,
1918 but that caused infinite recursion in selection request events. */
1919 if ((XINT (read_kbd
))
1920 && detect_input_pending ())
1923 if (detect_input_pending ())
1927 /* Exit now if the cell we're waiting for became non-nil. */
1928 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1932 /* If we think we have keyboard input waiting, but didn't get SIGIO
1933 go read it. This can happen with X on BSD after logging out.
1934 In that case, there really is no input and no SIGIO,
1935 but select says there is input. */
1937 if (XINT (read_kbd
) && interrupt_input
1938 && (FD_ISSET (keyboard_descriptor
, &Available
)))
1943 got_some_input
|= nfds
> 0;
1945 /* If checking input just got us a size-change event from X,
1946 obey it now if we should. */
1947 if (XINT (read_kbd
) || wait_for_cell
)
1948 do_pending_window_change ();
1950 /* Check for data from a process. */
1951 /* Really FIRST_PROC_DESC should be 0 on Unix,
1952 but this is safer in the short run. */
1953 for (channel
= keyboard_descriptor
== 0 ? FIRST_PROC_DESC
: 0;
1954 channel
< MAXDESC
; channel
++)
1956 if (FD_ISSET (channel
, &Available
))
1960 /* If waiting for this channel, arrange to return as
1961 soon as no more input to be processed. No more
1963 if (wait_channel
== channel
)
1969 proc
= chan_process
[channel
];
1973 /* Read data from the process, starting with our
1974 buffered-ahead character if we have one. */
1976 nread
= read_process_output (proc
, channel
);
1979 /* Since read_process_output can run a filter,
1980 which can call accept-process-output,
1981 don't try to read from any other processes
1982 before doing the select again. */
1983 FD_ZERO (&Available
);
1986 redisplay_preserve_echo_area ();
1989 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1993 else if (nread
== -1 && errno
== EAGAIN
)
1997 else if (nread
== -1 && errno
== EAGAIN
)
1999 /* Note that we cannot distinguish between no input
2000 available now and a closed pipe.
2001 With luck, a closed pipe will be accompanied by
2002 subprocess termination and SIGCHLD. */
2003 else if (nread
== 0 && !NETCONN_P (proc
))
2005 #endif /* O_NDELAY */
2006 #endif /* O_NONBLOCK */
2007 #endif /* EWOULDBLOCK */
2009 /* On some OSs with ptys, when the process on one end of
2010 a pty exits, the other end gets an error reading with
2011 errno = EIO instead of getting an EOF (0 bytes read).
2012 Therefore, if we get an error reading and errno =
2013 EIO, just continue, because the child process has
2014 exited and should clean itself up soon (e.g. when we
2016 else if (nread
== -1 && errno
== EIO
)
2018 #endif /* HAVE_PTYS */
2019 /* If we can detect process termination, don't consider the process
2020 gone just because its pipe is closed. */
2022 else if (nread
== 0 && !NETCONN_P (proc
))
2027 /* Preserve status of processes already terminated. */
2028 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2029 deactivate_process (proc
);
2030 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2031 update_status (XPROCESS (proc
));
2032 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2033 XPROCESS (proc
)->status
2034 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2037 } /* end for each file descriptor */
2038 } /* end while exit conditions not met */
2040 /* If calling from keyboard input, do not quit
2041 since we want to return C-g as an input character.
2042 Otherwise, do pending quit if requested. */
2043 if (XINT (read_kbd
) >= 0)
2045 /* Prevent input_pending from remaining set if we quit. */
2046 clear_input_pending ();
2050 return got_some_input
;
2053 /* Read pending output from the process channel,
2054 starting with our buffered-ahead character if we have one.
2055 Yield number of characters read.
2057 This function reads at most 1024 characters.
2058 If you want to read all available subprocess output,
2059 you must call it repeatedly until it returns zero. */
2061 read_process_output (proc
, channel
)
2063 register int channel
;
2065 register int nchars
;
2071 register Lisp_Object outstream
;
2072 register struct buffer
*old
= current_buffer
;
2073 register struct Lisp_Process
*p
= XPROCESS (proc
);
2074 register int opoint
;
2077 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2079 vs
= get_vms_process_pointer (p
->pid
);
2083 return(0); /* Really weird if it does this */
2084 if (!(vs
->iosb
[0] & 1))
2085 return -1; /* I/O error */
2088 error ("Could not get VMS process pointer");
2089 chars
= vs
->inputBuffer
;
2090 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2093 start_vms_process_read (vs
); /* Crank up the next read on the process */
2094 return 1; /* Nothing worth printing, say we got 1 */
2098 if (proc_buffered_char
[channel
] < 0)
2099 nchars
= read (channel
, chars
, sizeof chars
);
2102 chars
[0] = proc_buffered_char
[channel
];
2103 proc_buffered_char
[channel
] = -1;
2104 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2108 nchars
= nchars
+ 1;
2110 #endif /* not VMS */
2112 if (nchars
<= 0) return nchars
;
2114 outstream
= p
->filter
;
2115 if (!NILP (outstream
))
2117 /* We inhibit quit here instead of just catching it so that
2118 hitting ^G when a filter happens to be running won't screw
2120 int count
= specpdl_ptr
- specpdl
;
2121 Lisp_Object odeactivate
;
2123 odeactivate
= Vdeactivate_mark
;
2125 specbind (Qinhibit_quit
, Qt
);
2126 call2 (outstream
, proc
, make_string (chars
, nchars
));
2128 /* Handling the process output should not deactivate the mark. */
2129 Vdeactivate_mark
= odeactivate
;
2132 start_vms_process_read (vs
);
2134 unbind_to (count
, Qnil
);
2138 /* If no filter, write into buffer if it isn't dead. */
2139 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2141 Lisp_Object old_read_only
;
2142 Lisp_Object old_begv
, old_zv
;
2143 Lisp_Object odeactivate
;
2145 odeactivate
= Vdeactivate_mark
;
2147 Fset_buffer (p
->buffer
);
2149 old_read_only
= current_buffer
->read_only
;
2150 XFASTINT (old_begv
) = BEGV
;
2151 XFASTINT (old_zv
) = ZV
;
2153 current_buffer
->read_only
= Qnil
;
2155 /* Insert new output into buffer
2156 at the current end-of-output marker,
2157 thus preserving logical ordering of input and output. */
2158 if (XMARKER (p
->mark
)->buffer
)
2159 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2163 /* If the output marker is outside of the visible region, save
2164 the restriction and widen. */
2165 if (! (BEGV
<= point
&& point
<= ZV
))
2168 /* Make sure opoint floats ahead of any new text, just as point
2170 if (point
<= opoint
)
2173 /* Insert after old_begv, but before old_zv. */
2174 if (point
< XFASTINT (old_begv
))
2175 XFASTINT (old_begv
) += nchars
;
2176 if (point
<= XFASTINT (old_zv
))
2177 XFASTINT (old_zv
) += nchars
;
2179 /* Insert before markers in case we are inserting where
2180 the buffer's mark is, and the user's next command is Meta-y. */
2181 insert_before_markers (chars
, nchars
);
2182 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2184 update_mode_lines
++;
2186 /* If the restriction isn't what it should be, set it. */
2187 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2188 Fnarrow_to_region (old_begv
, old_zv
);
2190 /* Handling the process output should not deactivate the mark. */
2191 Vdeactivate_mark
= odeactivate
;
2193 current_buffer
->read_only
= old_read_only
;
2195 set_buffer_internal (old
);
2198 start_vms_process_read (vs
);
2203 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2205 "Returns non-NIL if emacs is waiting for input from the user.\n\
2206 This is intended for use by asynchronous process output filters and sentinels.")
2209 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2212 /* Sending data to subprocess */
2214 jmp_buf send_process_frame
;
2217 send_process_trap ()
2223 longjmp (send_process_frame
, 1);
2226 send_process (proc
, buf
, len
)
2231 /* Don't use register vars; longjmp can lose them. */
2233 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2237 struct Lisp_Process
*p
= XPROCESS (proc
);
2238 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2241 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2242 update_status (XPROCESS (proc
));
2243 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2244 error ("Process %s not running", procname
);
2247 vs
= get_vms_process_pointer (p
->pid
);
2249 error ("Could not find this process: %x", p
->pid
);
2250 else if (write_to_vms_process (vs
, buf
, len
))
2253 if (!setjmp (send_process_frame
))
2257 SIGTYPE (*old_sigpipe
)();
2260 if (pty_max_bytes
== 0)
2262 #ifdef _PC_MAX_CANON
2263 pty_max_bytes
= fpathconf (XFASTINT (XPROCESS (proc
)->outfd
),
2266 pty_max_bytes
= 250;
2270 /* Don't send more than pty_max_bytes bytes at a time. */
2271 /* Subtract 1 to leave room for the EOF. */
2272 if (this >= pty_max_bytes
&& XPROCESS (proc
)->pty_flag
!= 0)
2273 this = pty_max_bytes
- 1;
2275 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2276 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
2278 /* If we sent just part of the string, put in an EOF
2279 to force it through, before we send the rest. */
2281 Fprocess_send_eof (proc
);
2283 signal (SIGPIPE
, old_sigpipe
);
2288 || errno
== EWOULDBLOCK
2295 /* It would be nice to accept process output here,
2296 but that is difficult. For example, it could
2297 garbage what we are sending if that is from a buffer. */
2304 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2308 /* Allow input from processes between bursts of sending.
2309 Otherwise things may get stopped up. */
2314 XFASTINT (zero
) = 0;
2315 wait_reading_process_input (-1, 0, zero
, 0);
2321 XPROCESS (proc
)->raw_status_low
= Qnil
;
2322 XPROCESS (proc
)->raw_status_high
= Qnil
;
2323 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2324 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2325 deactivate_process (proc
);
2327 error ("Error writing to process %s; closed it", procname
);
2329 error ("SIGPIPE raised on process %s; closed it", procname
);
2334 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2336 "Send current contents of region as input to PROCESS.\n\
2337 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2338 nil, indicating the current buffer's process.\n\
2339 Called from program, takes three arguments, PROCESS, START and END.\n\
2340 If the region is more than 500 characters long,\n\
2341 it is sent in several bunches. This may happen even for shorter regions.\n\
2342 Output from processes can arrive in between bunches.")
2343 (process
, start
, end
)
2344 Lisp_Object process
, start
, end
;
2349 proc
= get_process (process
);
2350 validate_region (&start
, &end
);
2352 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2355 start1
= XINT (start
);
2356 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2361 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2363 "Send PROCESS the contents of STRING as input.\n\
2364 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2365 nil, indicating the current buffer's process.\n\
2366 If STRING is more than 500 characters long,\n\
2367 it is sent in several bunches. This may happen even for shorter strings.\n\
2368 Output from processes can arrive in between bunches.")
2370 Lisp_Object process
, string
;
2373 CHECK_STRING (string
, 1);
2374 proc
= get_process (process
);
2375 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2379 /* send a signal number SIGNO to PROCESS.
2380 CURRENT_GROUP means send to the process group that currently owns
2381 the terminal being used to communicate with PROCESS.
2382 This is used for various commands in shell mode.
2383 If NOMSG is zero, insert signal-announcements into process's buffers
2386 If we can, we try to signal PROCESS by sending control characters
2387 down the pipe. This allows us to signal inferiors who have changed
2388 their uid, for which killpg would return an EPERM error. */
2391 process_send_signal (process
, signo
, current_group
, nomsg
)
2392 Lisp_Object process
;
2394 Lisp_Object current_group
;
2398 register struct Lisp_Process
*p
;
2402 proc
= get_process (process
);
2403 p
= XPROCESS (proc
);
2405 if (!EQ (p
->childp
, Qt
))
2406 error ("Process %s is not a subprocess",
2407 XSTRING (p
->name
)->data
);
2408 if (XINT (p
->infd
) < 0)
2409 error ("Process %s is not active",
2410 XSTRING (p
->name
)->data
);
2412 if (NILP (p
->pty_flag
))
2413 current_group
= Qnil
;
2415 /* If we are using pgrps, get a pgrp number and make it negative. */
2416 if (!NILP (current_group
))
2418 #ifdef SIGNALS_VIA_CHARACTERS
2419 /* If possible, send signals to the entire pgrp
2420 by sending an input character to it. */
2422 /* TERMIOS is the latest and bestest, and seems most likely to
2423 work. If the system has it, use it. */
2430 tcgetattr (XINT (p
->infd
), &t
);
2431 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2435 tcgetattr (XINT (p
->infd
), &t
);
2436 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2440 tcgetattr (XINT (p
->infd
), &t
);
2441 #if defined (VSWTCH) && !defined (IRIX5)
2442 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2444 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2449 #else /* ! HAVE_TERMIOS */
2451 /* On Berkeley descendants, the following IOCTL's retrieve the
2452 current control characters. */
2453 #if defined (TIOCGLTC) && defined (TIOCGETC)
2461 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2462 send_process (proc
, &c
.t_intrc
, 1);
2465 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2466 send_process (proc
, &c
.t_quitc
, 1);
2470 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
2471 send_process (proc
, &lc
.t_suspc
, 1);
2473 #endif /* ! defined (SIGTSTP) */
2476 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2478 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2485 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2486 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2489 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2490 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2494 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2495 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2497 #endif /* ! defined (SIGTSTP) */
2499 #else /* ! defined (TCGETA) */
2500 Your configuration files are messed up
.
2501 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2502 you'd better be using one of the alternatives above! */
2503 #endif /* ! defined (TCGETA) */
2504 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2505 #endif /* ! defined HAVE_TERMIOS */
2506 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2509 /* Get the pgrp using the tty itself, if we have that.
2510 Otherwise, use the pty to get the pgrp.
2511 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2512 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2513 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2514 His patch indicates that if TIOCGPGRP returns an error, then
2515 we should just assume that p->pid is also the process group id. */
2519 if (!NILP (p
->subtty
))
2520 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2522 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
2526 gid
= - XFASTINT (p
->pid
);
2527 #endif /* ! defined (pfa) */
2533 #else /* ! defined (TIOCGPGRP ) */
2534 /* Can't select pgrps on this system, so we know that
2535 the child itself heads the pgrp. */
2536 gid
= - XFASTINT (p
->pid
);
2537 #endif /* ! defined (TIOCGPGRP ) */
2540 gid
= - XFASTINT (p
->pid
);
2546 p
->raw_status_low
= Qnil
;
2547 p
->raw_status_high
= Qnil
;
2549 XSETINT (p
->tick
, ++process_tick
);
2553 #endif /* ! defined (SIGCONT) */
2556 send_process (proc
, "\003", 1); /* ^C */
2561 send_process (proc
, "\031", 1); /* ^Y */
2566 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2569 flush_pending_output (XINT (p
->infd
));
2573 /* If we don't have process groups, send the signal to the immediate
2574 subprocess. That isn't really right, but it's better than any
2575 obvious alternative. */
2578 kill (XFASTINT (p
->pid
), signo
);
2582 /* gid may be a pid, or minus a pgrp's number */
2584 if (!NILP (current_group
))
2585 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
2588 gid
= - XFASTINT (p
->pid
);
2591 #else /* ! defined (TIOCSIGSEND) */
2592 EMACS_KILLPG (-gid
, signo
);
2593 #endif /* ! defined (TIOCSIGSEND) */
2596 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2597 "Interrupt process PROCESS. May be process or name of one.\n\
2598 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2599 Nil or no arg means current buffer's process.\n\
2600 Second arg CURRENT-GROUP non-nil means send signal to\n\
2601 the current process-group of the process's controlling terminal\n\
2602 rather than to the process's own process group.\n\
2603 If the process is a shell, this means interrupt current subjob\n\
2604 rather than the shell.")
2605 (process
, current_group
)
2606 Lisp_Object process
, current_group
;
2608 process_send_signal (process
, SIGINT
, current_group
, 0);
2612 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2613 "Kill process PROCESS. May be process or name of one.\n\
2614 See function `interrupt-process' for more details on usage.")
2615 (process
, current_group
)
2616 Lisp_Object process
, current_group
;
2618 process_send_signal (process
, SIGKILL
, current_group
, 0);
2622 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2623 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2624 See function `interrupt-process' for more details on usage.")
2625 (process
, current_group
)
2626 Lisp_Object process
, current_group
;
2628 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2632 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2633 "Stop process PROCESS. May be process or name of one.\n\
2634 See function `interrupt-process' for more details on usage.")
2635 (process
, current_group
)
2636 Lisp_Object process
, current_group
;
2639 error ("no SIGTSTP support");
2641 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2646 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2647 "Continue process PROCESS. May be process or name of one.\n\
2648 See function `interrupt-process' for more details on usage.")
2649 (process
, current_group
)
2650 Lisp_Object process
, current_group
;
2653 process_send_signal (process
, SIGCONT
, current_group
, 0);
2655 error ("no SIGCONT support");
2660 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2661 2, 2, "nProcess number: \nnSignal code: ",
2662 "Send the process with number PID the signal with code CODE.\n\
2663 Both PID and CODE are integers.")
2665 Lisp_Object pid
, sig
;
2667 CHECK_NUMBER (pid
, 0);
2668 CHECK_NUMBER (sig
, 1);
2669 return make_number (kill (XINT (pid
), XINT (sig
)));
2672 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2673 "Make PROCESS see end-of-file in its input.\n\
2674 Eof comes after any text already sent to it.\n\
2675 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2676 nil, indicating the current buffer's process.")
2678 Lisp_Object process
;
2682 proc
= get_process (process
);
2684 /* Make sure the process is really alive. */
2685 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2686 update_status (XPROCESS (proc
));
2687 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2688 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2690 /* Sending a zero-length record is supposed to mean eof
2691 when TIOCREMOTE is turned on. */
2695 write (XINT (XPROCESS (proc
)->outfd
), buf
, 0);
2697 #else /* did not do TOICREMOTE */
2699 send_process (proc
, "\032", 1); /* ^z */
2701 if (!NILP (XPROCESS (proc
)->pty_flag
))
2702 send_process (proc
, "\004", 1);
2705 close (XINT (XPROCESS (proc
)->outfd
));
2706 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, open (NULL_DEVICE
, O_WRONLY
));
2709 #endif /* did not do TOICREMOTE */
2713 /* Kill all processes associated with `buffer'.
2714 If `buffer' is nil, kill all processes */
2716 kill_buffer_processes (buffer
)
2719 Lisp_Object tail
, proc
;
2721 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2722 tail
= XCONS (tail
)->cdr
)
2724 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2725 if (XGCTYPE (proc
) == Lisp_Process
2726 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2728 if (NETCONN_P (proc
))
2729 deactivate_process (proc
);
2730 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
2731 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2736 /* On receipt of a signal that a child status has changed,
2737 loop asking about children with changed statuses until
2738 the system says there are no more.
2739 All we do is change the status;
2740 we do not run sentinels or print notifications.
2741 That is saved for the next time keyboard input is done,
2742 in order to avoid timing errors. */
2744 /** WARNING: this can be called during garbage collection.
2745 Therefore, it must not be fooled by the presence of mark bits in
2748 /** USG WARNING: Although it is not obvious from the documentation
2749 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2750 signal() before executing at least one wait(), otherwise the handler
2751 will be called again, resulting in an infinite loop. The relevant
2752 portion of the documentation reads "SIGCLD signals will be queued
2753 and the signal-catching function will be continually reentered until
2754 the queue is empty". Invoking signal() causes the kernel to reexamine
2755 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2758 sigchld_handler (signo
)
2761 int old_errno
= errno
;
2763 register struct Lisp_Process
*p
;
2764 extern EMACS_TIME
*input_available_clear_time
;
2768 sigheld
|= sigbit (SIGCHLD
);
2780 #endif /* no WUNTRACED */
2781 /* Keep trying to get a status until we get a definitive result. */
2785 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2787 while (pid
<= 0 && errno
== EINTR
);
2791 /* A real failure. We have done all our job, so return. */
2793 /* USG systems forget handlers when they are used;
2794 must reestablish each time */
2796 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2799 sigheld
&= ~sigbit (SIGCHLD
);
2807 #endif /* no WNOHANG */
2809 /* Find the process that signaled us, and record its status. */
2812 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2814 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2815 p
= XPROCESS (proc
);
2816 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2821 /* Look for an asynchronous process whose pid hasn't been filled
2824 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2826 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2827 p
= XPROCESS (proc
);
2828 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2833 /* Change the status of the process that was found. */
2836 union { int i
; WAITTYPE wt
; } u
;
2838 XSETINT (p
->tick
, ++process_tick
);
2840 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2841 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2843 /* If process has terminated, stop waiting for its output. */
2844 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2845 if (XINT (p
->infd
) >= 0)
2846 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
2848 /* Tell wait_reading_process_input that it needs to wake up and
2850 if (input_available_clear_time
)
2851 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2854 /* There was no asynchronous process found for that id. Check
2855 if we have a synchronous process. */
2858 synch_process_alive
= 0;
2860 /* Report the status of the synchronous process. */
2862 synch_process_retcode
= WRETCODE (w
);
2863 else if (WIFSIGNALED (w
))
2865 int code
= WTERMSIG (w
);
2871 signame
= sys_siglist
[code
];
2873 signame
= sys_errlist
[code
];
2877 signame
= "unknown";
2879 synch_process_death
= signame
;
2882 /* Tell wait_reading_process_input that it needs to wake up and
2884 if (input_available_clear_time
)
2885 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2888 /* On some systems, we must return right away.
2889 If any more processes want to signal us, we will
2891 Otherwise (on systems that have WNOHANG), loop around
2892 to use up all the processes that have something to tell us. */
2893 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2895 signal (signo
, sigchld_handler
);
2899 #endif /* USG, but not HPUX with WNOHANG */
2905 exec_sentinel_unwind (data
)
2908 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2913 exec_sentinel (proc
, reason
)
2914 Lisp_Object proc
, reason
;
2916 Lisp_Object sentinel
;
2917 register struct Lisp_Process
*p
= XPROCESS (proc
);
2918 int count
= specpdl_ptr
- specpdl
;
2920 sentinel
= p
->sentinel
;
2921 if (NILP (sentinel
))
2924 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2925 assure that it gets restored no matter how the sentinel exits. */
2927 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2928 /* Inhibit quit so that random quits don't screw up a running filter. */
2929 specbind (Qinhibit_quit
, Qt
);
2930 call2 (sentinel
, proc
, reason
);
2931 unbind_to (count
, Qnil
);
2934 /* Report all recent events of a change in process status
2935 (either run the sentinel or output a message).
2936 This is done while Emacs is waiting for keyboard input. */
2940 register Lisp_Object proc
, buffer
;
2941 Lisp_Object tail
= Qnil
;
2942 Lisp_Object msg
= Qnil
;
2943 struct gcpro gcpro1
, gcpro2
;
2945 /* We need to gcpro tail; if read_process_output calls a filter
2946 which deletes a process and removes the cons to which tail points
2947 from Vprocess_alist, and then causes a GC, tail is an unprotected
2951 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2954 register struct Lisp_Process
*p
;
2956 proc
= Fcdr (Fcar (tail
));
2957 p
= XPROCESS (proc
);
2959 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2961 XSETINT (p
->update_tick
, XINT (p
->tick
));
2963 /* If process is still active, read any output that remains. */
2964 if (XINT (p
->infd
) >= 0)
2965 while (! EQ (p
->filter
, Qt
)
2966 && read_process_output (proc
, XINT (p
->infd
)) > 0);
2970 /* Get the text to use for the message. */
2971 if (!NILP (p
->raw_status_low
))
2973 msg
= status_message (p
->status
);
2975 /* If process is terminated, deactivate it or delete it. */
2977 if (XTYPE (p
->status
) == Lisp_Cons
)
2978 symbol
= XCONS (p
->status
)->car
;
2980 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2981 || EQ (symbol
, Qclosed
))
2983 if (delete_exited_processes
)
2984 remove_process (proc
);
2986 deactivate_process (proc
);
2989 /* Now output the message suitably. */
2990 if (!NILP (p
->sentinel
))
2991 exec_sentinel (proc
, msg
);
2992 /* Don't bother with a message in the buffer
2993 when a process becomes runnable. */
2994 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2996 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2998 struct buffer
*old
= current_buffer
;
3001 /* Avoid error if buffer is deleted
3002 (probably that's why the process is dead, too) */
3003 if (NILP (XBUFFER (buffer
)->name
))
3005 Fset_buffer (buffer
);
3007 /* Insert new output into buffer
3008 at the current end-of-output marker,
3009 thus preserving logical ordering of input and output. */
3010 if (XMARKER (p
->mark
)->buffer
)
3011 SET_PT (marker_position (p
->mark
));
3014 if (point
<= opoint
)
3015 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
3017 tem
= current_buffer
->read_only
;
3018 current_buffer
->read_only
= Qnil
;
3019 insert_string ("\nProcess ");
3020 Finsert (1, &p
->name
);
3021 insert_string (" ");
3023 current_buffer
->read_only
= tem
;
3024 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
3027 set_buffer_internal (old
);
3032 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
3033 redisplay_preserve_echo_area ();
3035 update_tick
= process_tick
;
3046 if (! noninteractive
|| initialized
)
3048 signal (SIGCHLD
, sigchld_handler
);
3051 FD_ZERO (&input_wait_mask
);
3053 keyboard_descriptor
= 0;
3054 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3056 Vprocess_alist
= Qnil
;
3057 for (i
= 0; i
< MAXDESC
; i
++)
3059 chan_process
[i
] = Qnil
;
3060 proc_buffered_char
[i
] = -1;
3064 /* From now on, assume keyboard input comes from descriptor DESC. */
3067 change_keyboard_wait_descriptor (desc
)
3070 FD_CLR (keyboard_descriptor
, &input_wait_mask
);
3071 keyboard_descriptor
= desc
;
3072 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3078 stream_process
= intern ("stream");
3080 Qprocessp
= intern ("processp");
3081 staticpro (&Qprocessp
);
3082 Qrun
= intern ("run");
3084 Qstop
= intern ("stop");
3086 Qsignal
= intern ("signal");
3087 staticpro (&Qsignal
);
3089 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3092 Qexit = intern ("exit");
3093 staticpro (&Qexit); */
3095 Qopen
= intern ("open");
3097 Qclosed
= intern ("closed");
3098 staticpro (&Qclosed
);
3100 staticpro (&Vprocess_alist
);
3102 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3103 "*Non-nil means delete processes immediately when they exit.\n\
3104 nil means don't delete them until `list-processes' is run.");
3106 delete_exited_processes
= 1;
3108 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3109 "Control type of device used to communicate with subprocesses.\n\
3110 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3111 pty's are not available, this variable will be ignored. The value takes\n\
3112 effect when `start-process' is called.");
3113 Vprocess_connection_type
= Qt
;
3115 defsubr (&Sprocessp
);
3116 defsubr (&Sget_process
);
3117 defsubr (&Sget_buffer_process
);
3118 defsubr (&Sdelete_process
);
3119 defsubr (&Sprocess_status
);
3120 defsubr (&Sprocess_exit_status
);
3121 defsubr (&Sprocess_id
);
3122 defsubr (&Sprocess_name
);
3123 defsubr (&Sprocess_command
);
3124 defsubr (&Sset_process_buffer
);
3125 defsubr (&Sprocess_buffer
);
3126 defsubr (&Sprocess_mark
);
3127 defsubr (&Sset_process_filter
);
3128 defsubr (&Sprocess_filter
);
3129 defsubr (&Sset_process_sentinel
);
3130 defsubr (&Sprocess_sentinel
);
3131 defsubr (&Sprocess_kill_without_query
);
3132 defsubr (&Slist_processes
);
3133 defsubr (&Sprocess_list
);
3134 defsubr (&Sstart_process
);
3136 defsubr (&Sopen_network_stream
);
3137 #endif /* HAVE_SOCKETS */
3138 defsubr (&Saccept_process_output
);
3139 defsubr (&Sprocess_send_region
);
3140 defsubr (&Sprocess_send_string
);
3141 defsubr (&Sinterrupt_process
);
3142 defsubr (&Skill_process
);
3143 defsubr (&Squit_process
);
3144 defsubr (&Sstop_process
);
3145 defsubr (&Scontinue_process
);
3146 defsubr (&Sprocess_send_eof
);
3147 defsubr (&Ssignal_process
);
3148 defsubr (&Swaiting_for_user_input_p
);
3149 /* defsubr (&Sprocess_connection); */
3153 #else /* not subprocesses */
3155 #include <sys/types.h>
3159 #include "systime.h"
3160 #include "termopts.h"
3162 extern int frame_garbaged
;
3165 /* As described above, except assuming that there are no subprocesses:
3167 Wait for timeout to elapse and/or keyboard input to be available.
3170 timeout in seconds, or
3171 zero for no limit, or
3172 -1 means gobble data immediately available but don't wait for any.
3174 read_kbd is a Lisp_Object:
3175 0 to ignore keyboard input, or
3176 1 to return when input is available, or
3177 -1 means caller will actually read the input, so don't throw to
3179 We know that read_kbd will never be a Lisp_Process, since
3180 `subprocesses' isn't defined.
3182 do_display != 0 means redisplay should be done to show subprocess
3183 output that arrives. This version of the function ignores it.
3185 Return true iff we received input from any process. */
3188 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3189 int time_limit
, microsecs
;
3190 Lisp_Object read_kbd
;
3193 EMACS_TIME end_time
, timeout
, *timeout_p
;
3196 /* What does time_limit really mean? */
3197 if (time_limit
|| microsecs
)
3199 /* It's not infinite. */
3200 timeout_p
= &timeout
;
3202 if (time_limit
== -1)
3203 /* In fact, it's zero. */
3204 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3206 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3208 /* How far in the future is that? */
3209 EMACS_GET_TIME (end_time
);
3210 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3213 /* It's infinite. */
3216 /* This must come before stop_polling. */
3217 prepare_menu_bars ();
3219 /* Turn off periodic alarms (in case they are in use)
3220 because the select emulator uses alarms. */
3227 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3229 /* If calling from keyboard input, do not quit
3230 since we want to return C-g as an input character.
3231 Otherwise, do pending quit if requested. */
3232 if (XINT (read_kbd
) >= 0)
3237 EMACS_GET_TIME (*timeout_p
);
3238 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3239 if (EMACS_TIME_NEG_P (*timeout_p
))
3243 /* Cause C-g and alarm signals to take immediate action,
3244 and cause input available signals to zero out timeout. */
3245 if (XINT (read_kbd
) < 0)
3246 set_waiting_for_input (&timeout
);
3248 /* If a frame has been newly mapped and needs updating,
3249 reprocess its display stuff. */
3251 redisplay_preserve_echo_area ();
3253 if (XINT (read_kbd
) && detect_input_pending ())
3256 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3258 /* Make C-g and alarm signals set flags again */
3259 clear_waiting_for_input ();
3261 /* If we woke up due to SIGWINCH, actually change size now. */
3262 do_pending_window_change ();
3266 /* If the system call was interrupted, then go around the
3272 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3273 /* System sometimes fails to deliver SIGIO. */
3274 kill (getpid (), SIGIO
);
3277 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3281 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3293 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3294 /* Don't confused make-docfile by having two doc strings for this function.
3295 make-docfile does not pay attention to #if, for good reason! */
3298 register Lisp_Object name
;
3303 /* Kill all processes associated with `buffer'.
3304 If `buffer' is nil, kill all processes.
3305 Since we have no subprocesses, this does nothing. */
3307 kill_buffer_processes (buffer
)
3318 defsubr (&Sget_buffer_process
);
3322 #endif /* not subprocesses */