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 */
42 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
43 #include <sys/socket.h>
45 #include <netinet/in.h>
46 #include <arpa/inet.h>
47 #endif /* HAVE_SOCKETS */
49 /* TERM is a poor-man's SLIP, used on Linux. */
54 /* DGUX inet_addr returns a 'struct in_addr'. */
56 #define IN_ADDR struct in_addr
57 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
59 #define IN_ADDR unsigned long
60 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
63 #if defined(BSD) || defined(STRIDE)
64 #include <sys/ioctl.h>
65 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
67 #endif /* HAVE_PTYS and no O_NDELAY */
68 #endif /* BSD or STRIDE */
70 #ifdef BROKEN_O_NONBLOCK
72 #endif /* BROKEN_O_NONBLOCK */
79 #include <sys/sysmacros.h> /* for "minor" */
89 #include "termhooks.h"
94 Lisp_Object Qprocessp
;
95 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
96 /* Qexit is declared and initialized in eval.c. */
98 /* a process object is a network connection when its childp field is neither
99 Qt nor Qnil but is instead a string (name of foreign host we
100 are connected to + name of port we are connected to) */
103 static Lisp_Object stream_process
;
105 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
107 #define NETCONN_P(p) 0
108 #endif /* HAVE_SOCKETS */
110 /* Define first descriptor number available for subprocesses. */
112 #define FIRST_PROC_DESC 1
114 #define FIRST_PROC_DESC 3
117 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
120 #if !defined (SIGCHLD) && defined (SIGCLD)
121 #define SIGCHLD SIGCLD
124 #include "syssignal.h"
129 extern char *strerror ();
131 extern char *sys_errlist
[];
137 extern char *sys_siglist
[];
138 #endif /* not LINUX */
140 char *sys_siglist
[] =
146 "illegal instruction",
150 "floating point exception",
153 "segmentation violation",
154 "bad argument to system call",
155 "write on a pipe with no one to read it",
157 "software termination signal from kill",
159 "sendable stop signal not from tty",
160 "stop signal from tty",
161 "continue a stopped process",
162 "child status has changed",
163 "background read attempted from control tty",
164 "background write attempted from control tty",
165 "input record available at control tty",
166 "exceeded CPU time limit",
167 "exceeded file size limit"
172 /* t means use pty, nil means use a pipe,
173 maybe other values to come. */
174 static Lisp_Object Vprocess_connection_type
;
178 #include <sys/socket.h>
182 /* Number of events of change of status of a process. */
183 static int process_tick
;
185 /* Number of events for which the user or sentinel has been notified. */
186 static int update_tick
;
189 /* We could get this from param.h, but better not to depend on finding that.
190 And better not to risk that it might define other symbols used in this
193 #define MAXDESC FD_SETSIZE
197 #define SELECT_TYPE fd_set
198 #else /* no FD_SET */
200 #define SELECT_TYPE int
202 /* Define the macros to access a single-int bitmap of descriptors. */
203 #define FD_SET(n, p) (*(p) |= (1 << (n)))
204 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
205 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
206 #define FD_ZERO(p) (*(p) = 0)
207 #endif /* no FD_SET */
209 /* Mask of bits indicating the descriptors that we wait for input on */
211 static SELECT_TYPE input_wait_mask
;
213 /* Descriptor to use for keyboard input. */
214 static int keyboard_descriptor
;
216 /* Nonzero means delete a process right away if it exits. */
217 static int delete_exited_processes
;
219 /* Indexed by descriptor, gives the process (if any) for that descriptor */
220 static Lisp_Object chan_process
[MAXDESC
];
222 /* Alist of elements (NAME . PROCESS) */
223 static Lisp_Object Vprocess_alist
;
225 /* Buffered-ahead input char from process, indexed by channel.
226 -1 means empty (no char is buffered).
227 Used on sys V where the only way to tell if there is any
228 output from the process is to read at least one char.
229 Always -1 on systems that support FIONREAD. */
231 static int proc_buffered_char
[MAXDESC
];
233 static Lisp_Object
get_process ();
235 /* Compute the Lisp form of the process status, p->status, from
236 the numeric status that was returned by `wait'. */
238 Lisp_Object
status_convert ();
241 struct Lisp_Process
*p
;
243 union { int i
; WAITTYPE wt
; } u
;
244 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
245 p
->status
= status_convert (u
.wt
);
246 p
->raw_status_low
= Qnil
;
247 p
->raw_status_high
= Qnil
;
250 /* Convert a process status word in Unix format to
251 the list that we use internally. */
258 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
259 else if (WIFEXITED (w
))
260 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
261 WCOREDUMP (w
) ? Qt
: Qnil
));
262 else if (WIFSIGNALED (w
))
263 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
264 WCOREDUMP (w
) ? Qt
: Qnil
));
269 /* Given a status-list, extract the three pieces of information
270 and store them individually through the three pointers. */
273 decode_status (l
, symbol
, code
, coredump
)
281 if (XTYPE (l
) == Lisp_Symbol
)
289 *symbol
= XCONS (l
)->car
;
290 tem
= XCONS (l
)->cdr
;
291 *code
= XFASTINT (XCONS (tem
)->car
);
292 tem
= XCONS (tem
)->cdr
;
293 *coredump
= !NILP (tem
);
297 /* Return a string describing a process status list. */
300 status_message (status
)
305 Lisp_Object string
, string2
;
307 decode_status (status
, &symbol
, &code
, &coredump
);
309 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
312 string
= build_string (code
< NSIG
? sys_siglist
[code
] : "unknown");
314 string
= build_string (code
< NSIG
? sys_errlist
[code
] : "unknown");
316 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
317 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
318 return concat2 (string
, string2
);
320 else if (EQ (symbol
, Qexit
))
323 return build_string ("finished\n");
324 string
= Fnumber_to_string (make_number (code
));
325 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
326 return concat2 (build_string ("exited abnormally with code "),
327 concat2 (string
, string2
));
330 return Fcopy_sequence (Fsymbol_name (symbol
));
335 /* Open an available pty, returning a file descriptor.
336 Return -1 on failure.
337 The file name of the terminal corresponding to the pty
338 is left in the variable pty_name. */
349 /* Some systems name their pseudoterminals so that there are gaps in
350 the usual sequence - for example, on HP9000/S700 systems, there
351 are no pseudoterminals with names ending in 'f'. So we wait for
352 three failures in a row before deciding that we've reached the
354 int failed_count
= 0;
359 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
360 for (i
= 0; i
< 16; i
++)
363 #ifdef PTY_NAME_SPRINTF
366 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
367 #endif /* no PTY_NAME_SPRINTF */
371 #else /* no PTY_OPEN */
373 /* Unusual IRIS code */
374 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
377 if (fstat (fd
, &stb
) < 0)
380 if (stat (pty_name
, &stb
) < 0)
383 if (failed_count
>= 3)
389 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
391 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
393 #endif /* not IRIS */
394 #endif /* no PTY_OPEN */
398 /* check to make certain that both sides are available
399 this avoids a nasty yet stupid bug in rlogins */
400 #ifdef PTY_TTY_NAME_SPRINTF
403 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
404 #endif /* no PTY_TTY_NAME_SPRINTF */
406 if (access (pty_name
, 6) != 0)
409 #if !defined(IRIS) && !defined(__sgi)
415 #endif /* not UNIPLUS */
422 #endif /* HAVE_PTYS */
428 register Lisp_Object val
, tem
, name1
;
429 register struct Lisp_Process
*p
;
433 /* size of process structure includes the vector header,
434 so deduct for that. But struct Lisp_Vector includes the first
435 element, thus deducts too much, so add it back. */
436 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
437 - sizeof (struct Lisp_Vector
)
438 + sizeof (Lisp_Object
))
439 / sizeof (Lisp_Object
)),
441 XSETTYPE (val
, Lisp_Process
);
444 XSET (p
->infd
, Lisp_Int
, -1);
445 XSET (p
->outfd
, Lisp_Int
, -1);
446 XFASTINT (p
->pid
) = 0;
447 XFASTINT (p
->tick
) = 0;
448 XFASTINT (p
->update_tick
) = 0;
449 p
->raw_status_low
= Qnil
;
450 p
->raw_status_high
= Qnil
;
452 p
->mark
= Fmake_marker ();
454 /* If name is already in use, modify it until it is unused. */
459 tem
= Fget_process (name1
);
460 if (NILP (tem
)) break;
461 sprintf (suffix
, "<%d>", i
);
462 name1
= concat2 (name
, build_string (suffix
));
466 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
470 remove_process (proc
)
471 register Lisp_Object proc
;
473 register Lisp_Object pair
;
475 pair
= Frassq (proc
, Vprocess_alist
);
476 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
477 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
479 deactivate_process (proc
);
482 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
483 "Return t if OBJECT is a process.")
487 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
490 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
491 "Return the process named NAME, or nil if there is none.")
493 register Lisp_Object name
;
495 if (XTYPE (name
) == Lisp_Process
)
497 CHECK_STRING (name
, 0);
498 return Fcdr (Fassoc (name
, Vprocess_alist
));
501 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
502 "Return the (or, a) process associated with BUFFER.\n\
503 BUFFER may be a buffer or the name of one.")
505 register Lisp_Object name
;
507 register Lisp_Object buf
, tail
, proc
;
509 if (NILP (name
)) return Qnil
;
510 buf
= Fget_buffer (name
);
511 if (NILP (buf
)) return Qnil
;
513 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
515 proc
= Fcdr (Fcar (tail
));
516 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
522 /* This is how commands for the user decode process arguments. It
523 accepts a process, a process name, a buffer, a buffer name, or nil.
524 Buffers denote the first process in the buffer, and nil denotes the
529 register Lisp_Object name
;
531 register Lisp_Object proc
;
533 proc
= Fget_buffer_process (Fcurrent_buffer ());
536 proc
= Fget_process (name
);
538 proc
= Fget_buffer_process (Fget_buffer (name
));
545 error ("Current buffer has no process");
547 error ("Process %s does not exist", XSTRING (name
)->data
);
551 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
552 "Delete PROCESS: kill it and forget about it immediately.\n\
553 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
554 nil, indicating the current buffer's process.")
556 register Lisp_Object proc
;
558 proc
= get_process (proc
);
559 XPROCESS (proc
)->raw_status_low
= Qnil
;
560 XPROCESS (proc
)->raw_status_high
= Qnil
;
561 if (NETCONN_P (proc
))
563 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
564 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
566 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
568 Fkill_process (proc
, Qnil
);
569 /* Do this now, since remove_process will make sigchld_handler do nothing. */
570 XPROCESS (proc
)->status
571 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
572 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
575 remove_process (proc
);
579 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
580 "Return the status of PROCESS: a symbol, one of these:\n\
581 run -- for a process that is running.\n\
582 stop -- for a process stopped but continuable.\n\
583 exit -- for a process that has exited.\n\
584 signal -- for a process that has got a fatal signal.\n\
585 open -- for a network stream connection that is open.\n\
586 closed -- for a network stream connection that is closed.\n\
587 nil -- if arg is a process name and no such process exists.\n\
588 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
589 nil, indicating the current buffer's process.")
591 register Lisp_Object proc
;
593 register struct Lisp_Process
*p
;
594 register Lisp_Object status
;
595 proc
= get_process (proc
);
599 if (!NILP (p
->raw_status_low
))
602 if (XTYPE (status
) == Lisp_Cons
)
603 status
= XCONS (status
)->car
;
604 if (NETCONN_P (proc
))
606 if (EQ (status
, Qrun
))
608 else if (EQ (status
, Qexit
))
614 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
616 "Return the exit status of PROCESS or the signal number that killed it.\n\
617 If PROCESS has not yet exited or died, return 0.")
619 register Lisp_Object proc
;
621 CHECK_PROCESS (proc
, 0);
622 if (!NILP (XPROCESS (proc
)->raw_status_low
))
623 update_status (XPROCESS (proc
));
624 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
625 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
626 return make_number (0);
629 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
630 "Return the process id of PROCESS.\n\
631 This is the pid of the Unix process which PROCESS uses or talks to.\n\
632 For a network connection, this value is nil.")
634 register Lisp_Object proc
;
636 CHECK_PROCESS (proc
, 0);
637 return XPROCESS (proc
)->pid
;
640 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
641 "Return the name of PROCESS, as a string.\n\
642 This is the name of the program invoked in PROCESS,\n\
643 possibly modified to make it unique among process names.")
645 register Lisp_Object proc
;
647 CHECK_PROCESS (proc
, 0);
648 return XPROCESS (proc
)->name
;
651 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
652 "Return the command that was executed to start PROCESS.\n\
653 This is a list of strings, the first string being the program executed\n\
654 and the rest of the strings being the arguments given to it.\n\
655 For a non-child channel, this is nil.")
657 register Lisp_Object proc
;
659 CHECK_PROCESS (proc
, 0);
660 return XPROCESS (proc
)->command
;
663 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
665 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
667 register Lisp_Object proc
, buffer
;
669 CHECK_PROCESS (proc
, 0);
671 CHECK_BUFFER (buffer
, 1);
672 XPROCESS (proc
)->buffer
= buffer
;
676 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
678 "Return the buffer PROCESS is associated with.\n\
679 Output from PROCESS is inserted in this buffer\n\
680 unless PROCESS has a filter.")
682 register Lisp_Object proc
;
684 CHECK_PROCESS (proc
, 0);
685 return XPROCESS (proc
)->buffer
;
688 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
690 "Return the marker for the end of the last output from PROCESS.")
692 register Lisp_Object proc
;
694 CHECK_PROCESS (proc
, 0);
695 return XPROCESS (proc
)->mark
;
698 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
700 "Give PROCESS the filter function FILTER; nil means no filter.\n\
701 t means stop accepting output from the process.\n\
702 When a process has a filter, each time it does output\n\
703 the entire string of output is passed to the filter.\n\
704 The filter gets two arguments: the process and the string of output.\n\
705 If the process has a filter, its buffer is not used for output.")
707 register Lisp_Object proc
, filter
;
709 CHECK_PROCESS (proc
, 0);
711 FD_CLR (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
712 else if (EQ (XPROCESS (proc
)->filter
, Qt
))
713 FD_SET (XINT (XPROCESS (proc
)->infd
), &input_wait_mask
);
714 XPROCESS (proc
)->filter
= filter
;
718 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
720 "Returns the filter function of PROCESS; nil if none.\n\
721 See `set-process-filter' for more info on filter functions.")
723 register Lisp_Object proc
;
725 CHECK_PROCESS (proc
, 0);
726 return XPROCESS (proc
)->filter
;
729 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
731 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
732 The sentinel is called as a function when the process changes state.\n\
733 It gets two arguments: the process, and a string describing the change.")
735 register Lisp_Object proc
, sentinel
;
737 CHECK_PROCESS (proc
, 0);
738 XPROCESS (proc
)->sentinel
= sentinel
;
742 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
744 "Return the sentinel of PROCESS; nil if none.\n\
745 See `set-process-sentinel' for more info on sentinels.")
747 register Lisp_Object proc
;
749 CHECK_PROCESS (proc
, 0);
750 return XPROCESS (proc
)->sentinel
;
753 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
754 Sprocess_kill_without_query
, 1, 2, 0,
755 "Say no query needed if PROCESS is running when Emacs is exited.\n\
756 Optional second argument if non-nill says to require a query.\n\
757 Value is t if a query was formerly required.")
759 register Lisp_Object proc
, value
;
763 CHECK_PROCESS (proc
, 0);
764 tem
= XPROCESS (proc
)->kill_without_query
;
765 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
770 #if 0 /* Turned off because we don't currently record this info
771 in the process. Perhaps add it. */
772 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
773 "Return the connection type of `PROCESS'.\n\
774 The value is `nil' for a pipe,\n\
775 `t' or `pty' for a pty, or `stream' for a socket connection.")
779 return XPROCESS (process
)->type
;
786 register Lisp_Object tail
, tem
;
787 Lisp_Object proc
, minspace
, tem1
;
788 register struct buffer
*old
= current_buffer
;
789 register struct Lisp_Process
*p
;
793 XFASTINT (minspace
) = 1;
795 set_buffer_internal (XBUFFER (Vstandard_output
));
796 Fbuffer_disable_undo (Vstandard_output
);
798 current_buffer
->truncate_lines
= Qt
;
801 Proc Status Buffer Command\n\
802 ---- ------ ------ -------\n", -1);
804 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
808 proc
= Fcdr (Fcar (tail
));
810 if (NILP (p
->childp
))
813 Finsert (1, &p
->name
);
814 Findent_to (make_number (13), minspace
);
816 if (!NILP (p
->raw_status_low
))
819 if (XTYPE (p
->status
) == Lisp_Cons
)
820 symbol
= XCONS (p
->status
)->car
;
823 if (EQ (symbol
, Qsignal
))
826 tem
= Fcar (Fcdr (p
->status
));
828 if (XINT (tem
) < NSIG
)
829 write_string (sys_errlist
[XINT (tem
)], -1);
832 Fprinc (symbol
, Qnil
);
834 else if (NETCONN_P (proc
))
836 if (EQ (symbol
, Qrun
))
837 write_string ("open", -1);
838 else if (EQ (symbol
, Qexit
))
839 write_string ("closed", -1);
841 Fprinc (symbol
, Qnil
);
844 Fprinc (symbol
, Qnil
);
846 if (EQ (symbol
, Qexit
))
849 tem
= Fcar (Fcdr (p
->status
));
852 sprintf (tembuf
, " %d", XFASTINT (tem
));
853 write_string (tembuf
, -1);
857 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
858 remove_process (proc
);
860 Findent_to (make_number (22), minspace
);
861 if (NILP (p
->buffer
))
862 insert_string ("(none)");
863 else if (NILP (XBUFFER (p
->buffer
)->name
))
864 insert_string ("(Killed)");
866 Finsert (1, &XBUFFER (p
->buffer
)->name
);
868 Findent_to (make_number (37), minspace
);
870 if (NETCONN_P (proc
))
872 sprintf (tembuf
, "(network stream connection to %s)\n",
873 XSTRING (p
->childp
)->data
);
874 insert_string (tembuf
);
888 insert_string ("\n");
894 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
895 "Display a list of all processes.\n\
896 \(Any processes listed as Exited or Signaled are actually eliminated\n\
897 after the listing is made.)")
900 internal_with_output_to_temp_buffer ("*Process List*",
901 list_processes_1
, Qnil
);
905 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
906 "Return a list of all processes.")
909 return Fmapcar (Qcdr
, Vprocess_alist
);
912 /* Starting asynchronous inferior processes. */
914 static Lisp_Object
start_process_unwind ();
916 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
917 "Start a program in a subprocess. Return the process object for it.\n\
918 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
919 NAME is name for process. It is modified if necessary to make it unique.\n\
920 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
921 Process output goes at end of that buffer, unless you specify\n\
922 an output stream or filter function to handle the output.\n\
923 BUFFER may be also nil, meaning that this process is not associated\n\
925 Third arg is program file name. It is searched for as in the shell.\n\
926 Remaining arguments are strings to give program as arguments.")
929 register Lisp_Object
*args
;
931 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
933 register unsigned char *new_argv
;
936 register unsigned char **new_argv
;
939 int count
= specpdl_ptr
- specpdl
;
943 buffer
= Fget_buffer_create (buffer
);
945 /* Make sure that the child will be able to chdir to the current
946 buffer's current directory, or its unhandled equivalent. We
947 can't just have the child check for an error when it does the
948 chdir, since it's in a vfork.
950 We have to GCPRO around this because Fexpand_file_name and
951 Funhandled_file_name_directory might call a file name handling
952 function. The argument list is protected by the caller, so all
953 we really have to worry about is buffer. */
955 struct gcpro gcpro1
, gcpro2
;
957 current_dir
= current_buffer
->directory
;
959 GCPRO2 (buffer
, current_dir
);
962 expand_and_dir_to_file
963 (Funhandled_file_name_directory (current_dir
), Qnil
);
964 if (NILP (Ffile_accessible_directory_p (current_dir
)))
965 report_file_error ("Setting current directory",
966 Fcons (current_buffer
->directory
, Qnil
));
972 CHECK_STRING (name
, 0);
976 CHECK_STRING (program
, 2);
979 /* Make a one member argv with all args concatenated
980 together separated by a blank. */
981 len
= XSTRING (program
)->size
+ 2;
982 for (i
= 3; i
< nargs
; i
++)
985 CHECK_STRING (tem
, i
);
986 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
988 new_argv
= (unsigned char *) alloca (len
);
989 strcpy (new_argv
, XSTRING (program
)->data
);
990 for (i
= 3; i
< nargs
; i
++)
993 CHECK_STRING (tem
, i
);
994 strcat (new_argv
, " ");
995 strcat (new_argv
, XSTRING (tem
)->data
);
997 /* Need to add code here to check for program existence on VMS */
1000 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1002 for (i
= 3; i
< nargs
; i
++)
1005 CHECK_STRING (tem
, i
);
1006 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1008 new_argv
[i
- 2] = 0;
1009 new_argv
[0] = XSTRING (program
)->data
;
1011 /* If program file name is not absolute, search our path for it */
1012 if (new_argv
[0][0] != '/')
1015 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1017 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1018 new_argv
[0] = XSTRING (tem
)->data
;
1020 #endif /* not VMS */
1022 proc
= make_process (name
);
1023 /* If an error occurs and we can't start the process, we want to
1024 remove it from the process list. This means that each error
1025 check in create_process doesn't need to call remove_process
1026 itself; it's all taken care of here. */
1027 record_unwind_protect (start_process_unwind
, proc
);
1029 XPROCESS (proc
)->childp
= Qt
;
1030 XPROCESS (proc
)->command_channel_p
= Qnil
;
1031 XPROCESS (proc
)->buffer
= buffer
;
1032 XPROCESS (proc
)->sentinel
= Qnil
;
1033 XPROCESS (proc
)->filter
= Qnil
;
1034 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1036 create_process (proc
, new_argv
, current_dir
);
1038 return unbind_to (count
, proc
);
1041 /* This function is the unwind_protect form for Fstart_process. If
1042 PROC doesn't have its pid set, then we know someone has signalled
1043 an error and the process wasn't started successfully, so we should
1044 remove it from the process list. */
1046 start_process_unwind (proc
)
1049 if (XTYPE (proc
) != Lisp_Process
)
1052 /* Was PROC started successfully? */
1053 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1054 remove_process (proc
);
1061 create_process_1 (signo
)
1065 /* USG systems forget handlers when they are used;
1066 must reestablish each time */
1067 signal (signo
, create_process_1
);
1071 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1074 /* Mimic blocking of signals on system V, which doesn't really have it. */
1076 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1077 int sigchld_deferred
;
1080 create_process_sigchld ()
1082 signal (SIGCHLD
, create_process_sigchld
);
1084 sigchld_deferred
= 1;
1090 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1091 create_process (process
, new_argv
, current_dir
)
1092 Lisp_Object process
;
1094 Lisp_Object current_dir
;
1096 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1099 SIGTYPE (*sigchld
)();
1102 extern char **environ
;
1104 inchannel
= outchannel
= -1;
1107 if (EQ (Vprocess_connection_type
, Qt
))
1108 outchannel
= inchannel
= allocate_pty ();
1113 /* On USG systems it does not work to open the pty's tty here
1114 and then close and reopen it in the child. */
1116 /* Don't let this terminal become our controlling terminal
1117 (in case we don't have one). */
1118 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1120 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1123 report_file_error ("Opening pty", Qnil
);
1125 forkin
= forkout
= -1;
1126 #endif /* not USG */
1130 #endif /* HAVE_PTYS */
1133 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1134 report_file_error ("Opening socketpair", Qnil
);
1135 outchannel
= inchannel
= sv
[0];
1136 forkout
= forkin
= sv
[1];
1138 #else /* not SKTPAIR */
1147 #endif /* not SKTPAIR */
1150 /* Replaced by close_process_descs */
1151 set_exclusive_use (inchannel
);
1152 set_exclusive_use (outchannel
);
1155 /* Stride people say it's a mystery why this is needed
1156 as well as the O_NDELAY, but that it fails without this. */
1157 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1160 ioctl (inchannel
, FIONBIO
, &one
);
1165 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1168 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1172 /* Record this as an active process, with its channels.
1173 As a result, child_setup will close Emacs's side of the pipes. */
1174 chan_process
[inchannel
] = process
;
1175 XSET (XPROCESS (process
)->infd
, Lisp_Int
, inchannel
);
1176 XSET (XPROCESS (process
)->outfd
, Lisp_Int
, outchannel
);
1177 /* Record the tty descriptor used in the subprocess. */
1179 XPROCESS (process
)->subtty
= Qnil
;
1181 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1182 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1183 XPROCESS (process
)->status
= Qrun
;
1185 /* Delay interrupts until we have a chance to store
1186 the new fork's pid in its process structure */
1190 #else /* not BSD4_1 */
1191 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1192 sigsetmask (sigmask (SIGCHLD
));
1193 #else /* ordinary USG */
1195 sigchld_deferred
= 0;
1196 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1198 #endif /* ordinary USG */
1199 #endif /* not BSD4_1 */
1200 #endif /* SIGCHLD */
1202 /* Until we store the proper pid, enable sigchld_handler
1203 to recognize an unknown pid as standing for this process.
1204 It is very important not to let this `marker' value stay
1205 in the table after this function has returned; if it does
1206 it might cause call-process to hang and subsequent asynchronous
1207 processes to get their return values scrambled. */
1208 XSETINT (XPROCESS (process
)->pid
, -1);
1211 /* child_setup must clobber environ on systems with true vfork.
1212 Protect it from permanent change. */
1213 char **save_environ
= environ
;
1218 int xforkin
= forkin
;
1219 int xforkout
= forkout
;
1221 #if 0 /* This was probably a mistake--it duplicates code later on,
1222 but fails to handle all the cases. */
1223 /* Make sure SIGCHLD is not blocked in the child. */
1224 sigsetmask (SIGEMPTYMASK
);
1227 /* Make the pty be the controlling terminal of the process. */
1229 /* First, disconnect its current controlling terminal. */
1233 /* Make the pty's terminal the controlling terminal. */
1235 /* We ignore the return value
1236 because faith@cs.unc.edu says that is necessary on Linux. */
1237 ioctl (xforkin
, TIOCSCTTY
, 0);
1239 #else /* not HAVE_SETSID */
1241 /* It's very important to call setpgrp here and no time
1242 afterwards. Otherwise, we lose our controlling tty which
1243 is set when we open the pty. */
1246 #endif /* not HAVE_SETSID */
1250 /* Use new line discipline. */
1251 int ldisc
= NTTYDISC
;
1252 if (ioctl (xforkin
, TIOCSETD
, &ldisc
) < 0)
1253 write (1, "create_process/TIOCSETD failed\n", 31);
1257 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1258 can do TIOCSPGRP only to the process's controlling tty. */
1261 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1262 I can't test it since I don't have 4.3. */
1263 int j
= open ("/dev/tty", O_RDWR
, 0);
1264 ioctl (j
, TIOCNOTTY
, 0);
1267 /* In order to get a controlling terminal on some versions
1268 of BSD, it is necessary to put the process in pgrp 0
1269 before it opens the terminal. */
1273 #endif /* TIOCNOTTY */
1275 #if !defined (RTU) && !defined (UNIPLUS)
1276 /*** There is a suggestion that this ought to be a
1277 conditional on TIOCSPGRP. */
1278 /* Now close the pty (if we had it open) and reopen it.
1279 This makes the pty the controlling terminal of the subprocess. */
1282 #ifdef SET_CHILD_PTY_PGRP
1283 int pgrp
= getpid ();
1286 /* I wonder if close (open (pty_name, ...)) would work? */
1289 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1291 #ifdef SET_CHILD_PTY_PGRP
1292 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1293 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1299 #endif /* not UNIPLUS and not RTU */
1300 #ifdef SETUP_SLAVE_PTY
1302 #endif /* SETUP_SLAVE_PTY */
1304 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1305 Now reenable it in the child, so it will die when we want it to. */
1307 signal (SIGHUP
, SIG_DFL
);
1309 #endif /* HAVE_PTYS */
1314 #else /* not BSD4_1 */
1315 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1316 sigsetmask (SIGEMPTYMASK
);
1317 #else /* ordinary USG */
1319 signal (SIGCHLD
, sigchld
);
1321 #endif /* ordinary USG */
1322 #endif /* not BSD4_1 */
1323 #endif /* SIGCHLD */
1325 child_setup_tty (xforkout
);
1326 child_setup (xforkin
, xforkout
, xforkout
,
1327 new_argv
, 1, current_dir
);
1329 environ
= save_environ
;
1333 report_file_error ("Doing vfork", Qnil
);
1335 XFASTINT (XPROCESS (process
)->pid
) = pid
;
1337 FD_SET (inchannel
, &input_wait_mask
);
1339 /* If the subfork execv fails, and it exits,
1340 this close hangs. I don't know why.
1341 So have an interrupt jar it loose. */
1343 signal (SIGALRM
, create_process_1
);
1345 XPROCESS (process
)->subtty
= Qnil
;
1350 if (forkin
!= forkout
&& forkout
>= 0)
1356 #else /* not BSD4_1 */
1357 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1358 sigsetmask (SIGEMPTYMASK
);
1359 #else /* ordinary USG */
1361 signal (SIGCHLD
, sigchld
);
1362 /* Now really handle any of these signals
1363 that came in during this function. */
1364 if (sigchld_deferred
)
1365 kill (getpid (), SIGCHLD
);
1367 #endif /* ordinary USG */
1368 #endif /* not BSD4_1 */
1369 #endif /* SIGCHLD */
1371 #endif /* not VMS */
1375 /* open a TCP network connection to a given HOST/SERVICE. Treated
1376 exactly like a normal process when reading and writing. Only
1377 differences are in status display and process deletion. A network
1378 connection has no PID; you cannot signal it. All you can do is
1379 deactivate and close it via delete-process */
1381 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1383 "Open a TCP connection for a service to a host.\n\
1384 Returns a subprocess-object to represent the connection.\n\
1385 Input and output work as for subprocesses; `delete-process' closes it.\n\
1386 Args are NAME BUFFER HOST SERVICE.\n\
1387 NAME is name for process. It is modified if necessary to make it unique.\n\
1388 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1389 Process output goes at end of that buffer, unless you specify\n\
1390 an output stream or filter function to handle the output.\n\
1391 BUFFER may be also nil, meaning that this process is not associated\n\
1393 Third arg is name of the host to connect to, or its IP address.\n\
1394 Fourth arg SERVICE is name of the service desired, or an integer\n\
1395 specifying a port number to connect to.")
1396 (name
, buffer
, host
, service
)
1397 Lisp_Object name
, buffer
, host
, service
;
1401 struct sockaddr_in address
;
1402 struct servent
*svc_info
;
1403 struct hostent
*host_info_ptr
, host_info
;
1404 char *(addr_list
[2]);
1405 IN_ADDR numeric_addr
;
1409 struct hostent host_info_fixed
;
1410 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1412 GCPRO4 (name
, buffer
, host
, service
);
1413 CHECK_STRING (name
, 0);
1414 CHECK_STRING (host
, 0);
1415 if (XTYPE(service
) == Lisp_Int
)
1416 port
= htons ((unsigned short) XINT (service
));
1419 CHECK_STRING (service
, 0);
1420 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1422 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1423 port
= svc_info
->s_port
;
1427 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1428 if (host_info_ptr
== 0)
1429 /* Attempt to interpret host as numeric inet address */
1431 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1432 if (NUMERIC_ADDR_ERROR
)
1433 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1435 host_info_ptr
= &host_info
;
1436 host_info
.h_name
= 0;
1437 host_info
.h_aliases
= 0;
1438 host_info
.h_addrtype
= AF_INET
;
1440 /* Older machines have only one address slot called h_addr.
1441 Newer machines have h_addr_list, but #define h_addr to
1442 be its first element. */
1443 host_info
.h_addr_list
= &(addr_list
[0]);
1445 host_info
.h_addr
= (char*)(&numeric_addr
);
1447 host_info
.h_length
= strlen (addr_list
[0]);
1450 bzero (&address
, sizeof address
);
1451 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1452 host_info_ptr
->h_length
);
1453 address
.sin_family
= host_info_ptr
->h_addrtype
;
1454 address
.sin_port
= port
;
1456 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1458 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1460 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1461 when connect is interrupted. So let's not let it get interrupted.
1462 Note we do not turn off polling, because polling is only used
1463 when not interrupt_input, and thus not normally used on the systems
1464 which have this bug. On systems which use polling, there's no way
1465 to quit if polling is turned off. */
1466 if (interrupt_input
)
1470 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1)
1477 if (interrupt_input
)
1481 report_file_error ("connection failed",
1482 Fcons (host
, Fcons (name
, Qnil
)));
1485 if (interrupt_input
)
1489 s
= connect_server (0);
1491 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1492 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1493 send_command (s
, C_DUMB
, 1, 0);
1499 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1502 buffer
= Fget_buffer_create (buffer
);
1503 proc
= make_process (name
);
1505 chan_process
[inch
] = proc
;
1508 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1511 fcntl (inch
, F_SETFL
, O_NDELAY
);
1515 XPROCESS (proc
)->childp
= host
;
1516 XPROCESS (proc
)->command_channel_p
= Qnil
;
1517 XPROCESS (proc
)->buffer
= buffer
;
1518 XPROCESS (proc
)->sentinel
= Qnil
;
1519 XPROCESS (proc
)->filter
= Qnil
;
1520 XPROCESS (proc
)->command
= Qnil
;
1521 XPROCESS (proc
)->pid
= Qnil
;
1522 XSET (XPROCESS (proc
)->infd
, Lisp_Int
, s
);
1523 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, outch
);
1524 XPROCESS (proc
)->status
= Qrun
;
1525 FD_SET (inch
, &input_wait_mask
);
1530 #endif /* HAVE_SOCKETS */
1532 deactivate_process (proc
)
1535 register int inchannel
, outchannel
;
1536 register struct Lisp_Process
*p
= XPROCESS (proc
);
1538 inchannel
= XINT (p
->infd
);
1539 outchannel
= XINT (p
->outfd
);
1543 /* Beware SIGCHLD hereabouts. */
1544 flush_pending_output (inchannel
);
1547 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1548 sys$
dassgn (outchannel
);
1549 vs
= get_vms_process_pointer (p
->pid
);
1551 give_back_vms_process_stuff (vs
);
1555 if (outchannel
>= 0 && outchannel
!= inchannel
)
1559 XSET (p
->infd
, Lisp_Int
, -1);
1560 XSET (p
->outfd
, Lisp_Int
, -1);
1561 chan_process
[inchannel
] = Qnil
;
1562 FD_CLR (inchannel
, &input_wait_mask
);
1566 /* Close all descriptors currently in use for communication
1567 with subprocess. This is used in a newly-forked subprocess
1568 to get rid of irrelevant descriptors. */
1570 close_process_descs ()
1573 for (i
= 0; i
< MAXDESC
; i
++)
1575 Lisp_Object process
;
1576 process
= chan_process
[i
];
1577 if (!NILP (process
))
1579 int in
= XINT (XPROCESS (process
)->infd
);
1580 int out
= XINT (XPROCESS (process
)->outfd
);
1583 if (out
>= 0 && in
!= out
)
1589 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1591 "Allow any pending output from subprocesses to be read by Emacs.\n\
1592 It is read into the process' buffers or given to their filter functions.\n\
1593 Non-nil arg PROCESS means do not return until some output has been received\n\
1595 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1596 seconds and microseconds to wait; return after that much time whether\n\
1597 or not there is input.\n\
1598 Return non-nil iff we received any output before the timeout expired.")
1599 (proc
, timeout
, timeout_msecs
)
1600 register Lisp_Object proc
, timeout
, timeout_msecs
;
1605 if (! NILP (timeout_msecs
))
1607 CHECK_NUMBER (timeout_msecs
, 2);
1608 useconds
= XINT (timeout_msecs
);
1609 if (XTYPE (timeout
) != Lisp_Int
)
1610 XSET (timeout
, Lisp_Int
, 0);
1613 int carry
= useconds
/ 1000000;
1615 XSETINT (timeout
, XINT (timeout
) + carry
);
1616 useconds
-= carry
* 1000000;
1618 /* I think this clause is necessary because C doesn't
1619 guarantee a particular rounding direction for negative
1623 XSETINT (timeout
, XINT (timeout
) - 1);
1624 useconds
+= 1000000;
1631 if (! NILP (timeout
))
1633 CHECK_NUMBER (timeout
, 1);
1634 seconds
= XINT (timeout
);
1647 XFASTINT (proc
) = 0;
1650 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1654 /* This variable is different from waiting_for_input in keyboard.c.
1655 It is used to communicate to a lisp process-filter/sentinel (via the
1656 function Fwaiting_for_user_input_p below) whether emacs was waiting
1657 for user-input when that process-filter was called.
1658 waiting_for_input cannot be used as that is by definition 0 when
1659 lisp code is being evalled */
1660 static int waiting_for_user_input_p
;
1662 /* Read and dispose of subprocess output while waiting for timeout to
1663 elapse and/or keyboard input to be available.
1666 timeout in seconds, or
1667 zero for no limit, or
1668 -1 means gobble data immediately available but don't wait for any.
1671 an additional duration to wait, measured in microseconds.
1672 If this is nonzero and time_limit is 0, then the timeout
1673 consists of MICROSECS only.
1675 READ_KBD is a lisp value:
1676 0 to ignore keyboard input, or
1677 1 to return when input is available, or
1678 -1 meaning caller will actually read the input, so don't throw to
1679 the quit handler, or
1680 a cons cell, meaning wait wait until its car is non-nil
1681 (and gobble terminal input into the buffer if any arrives), or
1682 a process object, meaning wait until something arrives from that
1683 process. The return value is true iff we read some input from
1686 DO_DISPLAY != 0 means redisplay should be done to show subprocess
1687 output that arrives.
1689 If READ_KBD is a pointer to a struct Lisp_Process, then the
1690 function returns true iff we received input from that process
1691 before the timeout elapsed.
1692 Otherwise, return true iff we received input from any process. */
1694 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1695 int time_limit
, microsecs
;
1696 Lisp_Object read_kbd
;
1699 register int channel
, nfds
, m
;
1700 static SELECT_TYPE Available
;
1703 EMACS_TIME timeout
, end_time
, garbage
;
1705 int wait_channel
= -1;
1706 struct Lisp_Process
*wait_proc
= 0;
1707 int got_some_input
= 0;
1708 Lisp_Object
*wait_for_cell
= 0;
1710 FD_ZERO (&Available
);
1712 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1714 if (XTYPE (read_kbd
) == Lisp_Process
)
1716 wait_proc
= XPROCESS (read_kbd
);
1717 wait_channel
= XINT (wait_proc
->infd
);
1718 XFASTINT (read_kbd
) = 0;
1721 /* If waiting for non-nil in a cell, record where. */
1722 if (XTYPE (read_kbd
) == Lisp_Cons
)
1724 wait_for_cell
= &XCONS (read_kbd
)->car
;
1725 XFASTINT (read_kbd
) = 0;
1728 waiting_for_user_input_p
= XINT (read_kbd
);
1730 /* Since we may need to wait several times,
1731 compute the absolute time to return at. */
1732 if (time_limit
|| microsecs
)
1734 EMACS_GET_TIME (end_time
);
1735 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1736 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1739 /* It would not be safe to call this below,
1740 where we call redisplay_preserve_echo_area. */
1741 prepare_menu_bars ();
1745 /* If calling from keyboard input, do not quit
1746 since we want to return C-g as an input character.
1747 Otherwise, do pending quit if requested. */
1748 if (XINT (read_kbd
) >= 0)
1751 /* Exit now if the cell we're waiting for became non-nil. */
1752 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1755 /* Compute time from now till when time limit is up */
1756 /* Exit if already run out */
1757 if (time_limit
== -1)
1759 /* -1 specified for timeout means
1760 gobble output available now
1761 but don't wait at all. */
1763 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1765 else if (time_limit
|| microsecs
)
1767 EMACS_GET_TIME (timeout
);
1768 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1769 if (EMACS_TIME_NEG_P (timeout
))
1774 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1777 /* Cause C-g and alarm signals to take immediate action,
1778 and cause input available signals to zero out timeout.
1780 It is important that we do this before checking for process
1781 activity. If we get a SIGCHLD after the explicit checks for
1782 process activity, timeout is the only way we will know. */
1783 if (XINT (read_kbd
) < 0)
1784 set_waiting_for_input (&timeout
);
1786 /* If status of something has changed, and no input is
1787 available, notify the user of the change right away. After
1788 this explicit check, we'll let the SIGCHLD handler zap
1789 timeout to get our attention. */
1790 if (update_tick
!= process_tick
&& do_display
)
1792 Atemp
= input_wait_mask
;
1793 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1794 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1796 /* It's okay for us to do this and then continue with
1797 the loop, since timeout has already been zeroed out. */
1798 clear_waiting_for_input ();
1803 /* Don't wait for output from a non-running process. */
1804 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1805 update_status (wait_proc
);
1807 && ! EQ (wait_proc
->status
, Qrun
))
1809 clear_waiting_for_input ();
1813 /* Wait till there is something to do */
1815 Available
= input_wait_mask
;
1816 /* We used to have && wait_for_cell == 0
1817 but that led to lossage handling selection_request events:
1818 within one, we would start to handle another. */
1819 if (! XINT (read_kbd
))
1820 FD_CLR (keyboard_descriptor
, &Available
);
1822 /* If frame size has changed or the window is newly mapped,
1823 redisplay now, before we start to wait. There is a race
1824 condition here; if a SIGIO arrives between now and the select
1825 and indicates that a frame is trashed, the select may block
1826 displaying a trashed screen. */
1828 redisplay_preserve_echo_area ();
1830 if (XINT (read_kbd
) && detect_input_pending ())
1833 FD_ZERO (&Available
);
1836 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1840 /* Make C-g and alarm signals set flags again */
1841 clear_waiting_for_input ();
1843 /* If we woke up due to SIGWINCH, actually change size now. */
1844 do_pending_window_change ();
1846 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1850 if (xerrno
== EINTR
)
1851 FD_ZERO (&Available
);
1853 /* Ultrix select seems to return ENOMEM when it is
1854 interrupted. Treat it just like EINTR. Bleah. Note
1855 that we want to test for the "ultrix" CPP symbol, not
1856 "__ultrix__"; the latter is only defined under GCC, but
1857 not by DEC's bundled CC. -JimB */
1858 else if (xerrno
== ENOMEM
)
1859 FD_ZERO (&Available
);
1862 /* This happens for no known reason on ALLIANT.
1863 I am guessing that this is the right response. -- RMS. */
1864 else if (xerrno
== EFAULT
)
1865 FD_ZERO (&Available
);
1867 else if (xerrno
== EBADF
)
1870 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1871 the child's closure of the pts gives the parent a SIGHUP, and
1872 the ptc file descriptor is automatically closed,
1873 yielding EBADF here or at select() call above.
1874 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1875 in m/ibmrt-aix.h), and here we just ignore the select error.
1876 Cleanup occurs c/o status_notify after SIGCLD. */
1877 FD_ZERO (&Available
); /* Cannot depend on values returned */
1883 error("select error: %s", strerror (xerrno
));
1885 #if defined(sun) && !defined(USG5_4)
1886 else if (nfds
> 0 && FD_ISSET (keyboard_descriptor
, &Available
)
1888 /* System sometimes fails to deliver SIGIO.
1890 David J. Mackenzie says that Emacs doesn't compile under
1891 Solaris if this code is enabled, thus the USG5_4 in the CPP
1892 conditional. "I haven't noticed any ill effects so far.
1893 If you find a Solaris expert somewhere, they might know
1895 kill (getpid (), SIGIO
);
1898 /* Check for keyboard input */
1899 /* If there is any, return immediately
1900 to give it higher priority than subprocesses */
1902 /* We used to do his if wait_for_cell,
1903 but that caused infinite recursion in selection request events. */
1904 if ((XINT (read_kbd
))
1905 && detect_input_pending ())
1908 if (detect_input_pending ())
1912 /* Exit now if the cell we're waiting for became non-nil. */
1913 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1917 /* If we think we have keyboard input waiting, but didn't get SIGIO
1918 go read it. This can happen with X on BSD after logging out.
1919 In that case, there really is no input and no SIGIO,
1920 but select says there is input. */
1922 if (XINT (read_kbd
) && interrupt_input
1923 && (FD_ISSET (keyboard_descriptor
, &Available
)))
1928 got_some_input
|= nfds
> 0;
1930 /* If checking input just got us a size-change event from X,
1931 obey it now if we should. */
1932 if (XINT (read_kbd
) || wait_for_cell
)
1933 do_pending_window_change ();
1935 /* Check for data from a process. */
1936 /* Really FIRST_PROC_DESC should be 0 on Unix,
1937 but this is safer in the short run. */
1938 for (channel
= keyboard_descriptor
== 0 ? FIRST_PROC_DESC
: 0;
1939 channel
< MAXDESC
; channel
++)
1941 if (FD_ISSET (channel
, &Available
))
1945 /* If waiting for this channel, arrange to return as
1946 soon as no more input to be processed. No more
1948 if (wait_channel
== channel
)
1954 proc
= chan_process
[channel
];
1958 /* Read data from the process, starting with our
1959 buffered-ahead character if we have one. */
1961 nread
= read_process_output (proc
, channel
);
1964 /* Since read_process_output can run a filter,
1965 which can call accept-process-output,
1966 don't try to read from any other processes
1967 before doing the select again. */
1968 FD_ZERO (&Available
);
1971 redisplay_preserve_echo_area ();
1974 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1978 else if (nread
== -1 && errno
== EAGAIN
)
1982 else if (nread
== -1 && errno
== EAGAIN
)
1984 /* Note that we cannot distinguish between no input
1985 available now and a closed pipe.
1986 With luck, a closed pipe will be accompanied by
1987 subprocess termination and SIGCHLD. */
1988 else if (nread
== 0 && !NETCONN_P (proc
))
1990 #endif /* O_NDELAY */
1991 #endif /* O_NONBLOCK */
1992 #endif /* EWOULDBLOCK */
1994 /* On some OSs with ptys, when the process on one end of
1995 a pty exits, the other end gets an error reading with
1996 errno = EIO instead of getting an EOF (0 bytes read).
1997 Therefore, if we get an error reading and errno =
1998 EIO, just continue, because the child process has
1999 exited and should clean itself up soon (e.g. when we
2001 else if (nread
== -1 && errno
== EIO
)
2003 #endif /* HAVE_PTYS */
2004 /* If we can detect process termination, don't consider the process
2005 gone just because its pipe is closed. */
2007 else if (nread
== 0 && !NETCONN_P (proc
))
2012 /* Preserve status of processes already terminated. */
2013 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2014 deactivate_process (proc
);
2015 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2016 update_status (XPROCESS (proc
));
2017 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2018 XPROCESS (proc
)->status
2019 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2022 } /* end for each file descriptor */
2023 } /* end while exit conditions not met */
2025 /* If calling from keyboard input, do not quit
2026 since we want to return C-g as an input character.
2027 Otherwise, do pending quit if requested. */
2028 if (XINT (read_kbd
) >= 0)
2030 /* Prevent input_pending from remaining set if we quit. */
2031 clear_input_pending ();
2035 return got_some_input
;
2038 /* Read pending output from the process channel,
2039 starting with our buffered-ahead character if we have one.
2040 Yield number of characters read.
2042 This function reads at most 1024 characters.
2043 If you want to read all available subprocess output,
2044 you must call it repeatedly until it returns zero. */
2046 read_process_output (proc
, channel
)
2048 register int channel
;
2050 register int nchars
;
2056 register Lisp_Object outstream
;
2057 register struct buffer
*old
= current_buffer
;
2058 register struct Lisp_Process
*p
= XPROCESS (proc
);
2059 register int opoint
;
2062 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2064 vs
= get_vms_process_pointer (p
->pid
);
2068 return(0); /* Really weird if it does this */
2069 if (!(vs
->iosb
[0] & 1))
2070 return -1; /* I/O error */
2073 error ("Could not get VMS process pointer");
2074 chars
= vs
->inputBuffer
;
2075 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2078 start_vms_process_read (vs
); /* Crank up the next read on the process */
2079 return 1; /* Nothing worth printing, say we got 1 */
2083 if (proc_buffered_char
[channel
] < 0)
2084 nchars
= read (channel
, chars
, sizeof chars
);
2087 chars
[0] = proc_buffered_char
[channel
];
2088 proc_buffered_char
[channel
] = -1;
2089 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2093 nchars
= nchars
+ 1;
2095 #endif /* not VMS */
2097 if (nchars
<= 0) return nchars
;
2099 outstream
= p
->filter
;
2100 if (!NILP (outstream
))
2102 /* We inhibit quit here instead of just catching it so that
2103 hitting ^G when a filter happens to be running won't screw
2105 int count
= specpdl_ptr
- specpdl
;
2106 Lisp_Object odeactivate
;
2108 odeactivate
= Vdeactivate_mark
;
2110 specbind (Qinhibit_quit
, Qt
);
2111 call2 (outstream
, proc
, make_string (chars
, nchars
));
2113 /* Handling the process output should not deactivate the mark. */
2114 Vdeactivate_mark
= odeactivate
;
2117 start_vms_process_read (vs
);
2123 /* If no filter, write into buffer if it isn't dead. */
2124 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2126 Lisp_Object old_read_only
;
2127 Lisp_Object old_begv
, old_zv
;
2128 Lisp_Object odeactivate
;
2130 odeactivate
= Vdeactivate_mark
;
2132 Fset_buffer (p
->buffer
);
2134 old_read_only
= current_buffer
->read_only
;
2135 XFASTINT (old_begv
) = BEGV
;
2136 XFASTINT (old_zv
) = ZV
;
2138 current_buffer
->read_only
= Qnil
;
2140 /* Insert new output into buffer
2141 at the current end-of-output marker,
2142 thus preserving logical ordering of input and output. */
2143 if (XMARKER (p
->mark
)->buffer
)
2144 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2148 /* If the output marker is outside of the visible region, save
2149 the restriction and widen. */
2150 if (! (BEGV
<= point
&& point
<= ZV
))
2153 /* Make sure opoint floats ahead of any new text, just as point
2155 if (point
<= opoint
)
2158 /* Insert after old_begv, but before old_zv. */
2159 if (point
< XFASTINT (old_begv
))
2160 XFASTINT (old_begv
) += nchars
;
2161 if (point
<= XFASTINT (old_zv
))
2162 XFASTINT (old_zv
) += nchars
;
2164 /* Insert before markers in case we are inserting where
2165 the buffer's mark is, and the user's next command is Meta-y. */
2166 insert_before_markers (chars
, nchars
);
2167 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2169 update_mode_lines
++;
2171 /* If the restriction isn't what it should be, set it. */
2172 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2173 Fnarrow_to_region (old_begv
, old_zv
);
2175 /* Handling the process output should not deactivate the mark. */
2176 Vdeactivate_mark
= odeactivate
;
2178 current_buffer
->read_only
= old_read_only
;
2180 set_buffer_internal (old
);
2183 start_vms_process_read (vs
);
2188 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2190 "Returns non-NIL if emacs is waiting for input from the user.\n\
2191 This is intended for use by asynchronous process output filters and sentinels.")
2194 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2197 /* Sending data to subprocess */
2199 jmp_buf send_process_frame
;
2202 send_process_trap ()
2208 longjmp (send_process_frame
, 1);
2211 send_process (proc
, buf
, len
)
2216 /* Don't use register vars; longjmp can lose them. */
2218 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2222 struct Lisp_Process
*p
= XPROCESS (proc
);
2223 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2226 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2227 update_status (XPROCESS (proc
));
2228 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2229 error ("Process %s not running", procname
);
2232 vs
= get_vms_process_pointer (p
->pid
);
2234 error ("Could not find this process: %x", p
->pid
);
2235 else if (write_to_vms_process (vs
, buf
, len
))
2238 if (!setjmp (send_process_frame
))
2242 SIGTYPE (*old_sigpipe
)();
2244 /* Don't send more than 500 bytes at a time. */
2247 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2248 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
2249 signal (SIGPIPE
, old_sigpipe
);
2254 || errno
== EWOULDBLOCK
2261 /* It would be nice to accept process output here,
2262 but that is difficult. For example, it could
2263 garbage what we are sending if that is from a buffer. */
2270 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2274 /* Allow input from processes between bursts of sending.
2275 Otherwise things may get stopped up. */
2280 XFASTINT (zero
) = 0;
2281 wait_reading_process_input (-1, 0, zero
, 0);
2287 XPROCESS (proc
)->raw_status_low
= Qnil
;
2288 XPROCESS (proc
)->raw_status_high
= Qnil
;
2289 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2290 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2291 deactivate_process (proc
);
2293 error ("Error writing to process %s; closed it", procname
);
2295 error ("SIGPIPE raised on process %s; closed it", procname
);
2300 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2302 "Send current contents of region as input to PROCESS.\n\
2303 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2304 nil, indicating the current buffer's process.\n\
2305 Called from program, takes three arguments, PROCESS, START and END.\n\
2306 If the region is more than 500 characters long,\n\
2307 it is sent in several bunches. This may happen even for shorter regions.\n\
2308 Output from processes can arrive in between bunches.")
2309 (process
, start
, end
)
2310 Lisp_Object process
, start
, end
;
2315 proc
= get_process (process
);
2316 validate_region (&start
, &end
);
2318 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2321 start1
= XINT (start
);
2322 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2327 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2329 "Send PROCESS the contents of STRING as input.\n\
2330 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2331 nil, indicating the current buffer's process.\n\
2332 If STRING is more than 500 characters long,\n\
2333 it is sent in several bunches. This may happen even for shorter strings.\n\
2334 Output from processes can arrive in between bunches.")
2336 Lisp_Object process
, string
;
2339 CHECK_STRING (string
, 1);
2340 proc
= get_process (process
);
2341 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2345 /* send a signal number SIGNO to PROCESS.
2346 CURRENT_GROUP means send to the process group that currently owns
2347 the terminal being used to communicate with PROCESS.
2348 This is used for various commands in shell mode.
2349 If NOMSG is zero, insert signal-announcements into process's buffers
2352 If we can, we try to signal PROCESS by sending control characters
2353 down the pipe. This allows us to signal inferiors who have changed
2354 their uid, for which killpg would return an EPERM error. */
2357 process_send_signal (process
, signo
, current_group
, nomsg
)
2358 Lisp_Object process
;
2360 Lisp_Object current_group
;
2364 register struct Lisp_Process
*p
;
2368 proc
= get_process (process
);
2369 p
= XPROCESS (proc
);
2371 if (!EQ (p
->childp
, Qt
))
2372 error ("Process %s is not a subprocess",
2373 XSTRING (p
->name
)->data
);
2374 if (XINT (p
->infd
) < 0)
2375 error ("Process %s is not active",
2376 XSTRING (p
->name
)->data
);
2378 if (NILP (p
->pty_flag
))
2379 current_group
= Qnil
;
2381 /* If we are using pgrps, get a pgrp number and make it negative. */
2382 if (!NILP (current_group
))
2384 #ifdef SIGNALS_VIA_CHARACTERS
2385 /* If possible, send signals to the entire pgrp
2386 by sending an input character to it. */
2388 /* TERMIOS is the latest and bestest, and seems most likely to
2389 work. If the system has it, use it. */
2396 tcgetattr (XINT (p
->infd
), &t
);
2397 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2401 tcgetattr (XINT (p
->infd
), &t
);
2402 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2406 tcgetattr (XINT (p
->infd
), &t
);
2407 #if defined (VSWTCH) && !defined (IRIX5)
2408 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2410 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2415 #else /* ! HAVE_TERMIOS */
2417 /* On Berkeley descendants, the following IOCTL's retrieve the
2418 current control characters. */
2419 #if defined (TIOCGLTC) && defined (TIOCGETC)
2427 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2428 send_process (proc
, &c
.t_intrc
, 1);
2431 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
2432 send_process (proc
, &c
.t_quitc
, 1);
2436 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
2437 send_process (proc
, &lc
.t_suspc
, 1);
2439 #endif /* ! defined (SIGTSTP) */
2442 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2444 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2451 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2452 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2455 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2456 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2460 ioctl (XINT (p
->infd
), TCGETA
, &t
);
2461 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2463 #endif /* ! defined (SIGTSTP) */
2465 #else /* ! defined (TCGETA) */
2466 Your configuration files are messed up
.
2467 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2468 you'd better be using one of the alternatives above! */
2469 #endif /* ! defined (TCGETA) */
2470 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2471 #endif /* ! defined HAVE_TERMIOS */
2472 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2475 /* Get the pgrp using the tty itself, if we have that.
2476 Otherwise, use the pty to get the pgrp.
2477 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2478 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2479 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2480 His patch indicates that if TIOCGPGRP returns an error, then
2481 we should just assume that p->pid is also the process group id. */
2485 if (!NILP (p
->subtty
))
2486 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2488 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
2492 gid
= - XFASTINT (p
->pid
);
2493 #endif /* ! defined (pfa) */
2499 #else /* ! defined (TIOCGPGRP ) */
2500 /* Can't select pgrps on this system, so we know that
2501 the child itself heads the pgrp. */
2502 gid
= - XFASTINT (p
->pid
);
2503 #endif /* ! defined (TIOCGPGRP ) */
2506 gid
= - XFASTINT (p
->pid
);
2512 p
->raw_status_low
= Qnil
;
2513 p
->raw_status_high
= Qnil
;
2515 XSETINT (p
->tick
, ++process_tick
);
2519 #endif /* ! defined (SIGCONT) */
2522 send_process (proc
, "\003", 1); /* ^C */
2527 send_process (proc
, "\031", 1); /* ^Y */
2532 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2535 flush_pending_output (XINT (p
->infd
));
2539 /* If we don't have process groups, send the signal to the immediate
2540 subprocess. That isn't really right, but it's better than any
2541 obvious alternative. */
2544 kill (XFASTINT (p
->pid
), signo
);
2548 /* gid may be a pid, or minus a pgrp's number */
2550 if (!NILP (current_group
))
2551 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
2554 gid
= - XFASTINT (p
->pid
);
2557 #else /* ! defined (TIOCSIGSEND) */
2558 EMACS_KILLPG (-gid
, signo
);
2559 #endif /* ! defined (TIOCSIGSEND) */
2562 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2563 "Interrupt process PROCESS. May be process or name of one.\n\
2564 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2565 Nil or no arg means current buffer's process.\n\
2566 Second arg CURRENT-GROUP non-nil means send signal to\n\
2567 the current process-group of the process's controlling terminal\n\
2568 rather than to the process's own process group.\n\
2569 If the process is a shell, this means interrupt current subjob\n\
2570 rather than the shell.")
2571 (process
, current_group
)
2572 Lisp_Object process
, current_group
;
2574 process_send_signal (process
, SIGINT
, current_group
, 0);
2578 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2579 "Kill process PROCESS. May be process or name of one.\n\
2580 See function `interrupt-process' for more details on usage.")
2581 (process
, current_group
)
2582 Lisp_Object process
, current_group
;
2584 process_send_signal (process
, SIGKILL
, current_group
, 0);
2588 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2589 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2590 See function `interrupt-process' for more details on usage.")
2591 (process
, current_group
)
2592 Lisp_Object process
, current_group
;
2594 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2598 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2599 "Stop process PROCESS. May be process or name of one.\n\
2600 See function `interrupt-process' for more details on usage.")
2601 (process
, current_group
)
2602 Lisp_Object process
, current_group
;
2605 error ("no SIGTSTP support");
2607 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2612 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2613 "Continue 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
;
2619 process_send_signal (process
, SIGCONT
, current_group
, 0);
2621 error ("no SIGCONT support");
2626 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2627 2, 2, "nProcess number: \nnSignal code: ",
2628 "Send the process with number PID the signal with code CODE.\n\
2629 Both PID and CODE are integers.")
2631 Lisp_Object pid
, sig
;
2633 CHECK_NUMBER (pid
, 0);
2634 CHECK_NUMBER (sig
, 1);
2635 return make_number (kill (XINT (pid
), XINT (sig
)));
2638 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2639 "Make PROCESS see end-of-file in its input.\n\
2640 Eof comes after any text already sent to it.\n\
2641 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2642 nil, indicating the current buffer's process.")
2644 Lisp_Object process
;
2648 proc
= get_process (process
);
2650 /* Make sure the process is really alive. */
2651 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2652 update_status (XPROCESS (proc
));
2653 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2654 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
2656 /* Sending a zero-length record is supposed to mean eof
2657 when TIOCREMOTE is turned on. */
2661 write (XINT (XPROCESS (proc
)->outfd
), buf
, 0);
2663 #else /* did not do TOICREMOTE */
2665 send_process (proc
, "\032", 1); /* ^z */
2667 if (!NILP (XPROCESS (proc
)->pty_flag
))
2668 send_process (proc
, "\004", 1);
2671 close (XINT (XPROCESS (proc
)->outfd
));
2672 XSET (XPROCESS (proc
)->outfd
, Lisp_Int
, open (NULL_DEVICE
, O_WRONLY
));
2675 #endif /* did not do TOICREMOTE */
2679 /* Kill all processes associated with `buffer'.
2680 If `buffer' is nil, kill all processes */
2682 kill_buffer_processes (buffer
)
2685 Lisp_Object tail
, proc
;
2687 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2688 tail
= XCONS (tail
)->cdr
)
2690 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2691 if (XGCTYPE (proc
) == Lisp_Process
2692 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2694 if (NETCONN_P (proc
))
2695 deactivate_process (proc
);
2696 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
2697 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2702 /* On receipt of a signal that a child status has changed,
2703 loop asking about children with changed statuses until
2704 the system says there are no more.
2705 All we do is change the status;
2706 we do not run sentinels or print notifications.
2707 That is saved for the next time keyboard input is done,
2708 in order to avoid timing errors. */
2710 /** WARNING: this can be called during garbage collection.
2711 Therefore, it must not be fooled by the presence of mark bits in
2714 /** USG WARNING: Although it is not obvious from the documentation
2715 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2716 signal() before executing at least one wait(), otherwise the handler
2717 will be called again, resulting in an infinite loop. The relevant
2718 portion of the documentation reads "SIGCLD signals will be queued
2719 and the signal-catching function will be continually reentered until
2720 the queue is empty". Invoking signal() causes the kernel to reexamine
2721 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2724 sigchld_handler (signo
)
2727 int old_errno
= errno
;
2729 register struct Lisp_Process
*p
;
2730 extern EMACS_TIME
*input_available_clear_time
;
2734 sigheld
|= sigbit (SIGCHLD
);
2746 #endif /* no WUNTRACED */
2747 /* Keep trying to get a status until we get a definitive result. */
2751 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2753 while (pid
<= 0 && errno
== EINTR
);
2757 /* A real failure. We have done all our job, so return. */
2759 /* USG systems forget handlers when they are used;
2760 must reestablish each time */
2762 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2765 sigheld
&= ~sigbit (SIGCHLD
);
2773 #endif /* no WNOHANG */
2775 /* Find the process that signaled us, and record its status. */
2778 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2780 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2781 p
= XPROCESS (proc
);
2782 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2787 /* Look for an asynchronous process whose pid hasn't been filled
2790 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2792 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2793 p
= XPROCESS (proc
);
2794 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2799 /* Change the status of the process that was found. */
2802 union { int i
; WAITTYPE wt
; } u
;
2804 XSETINT (p
->tick
, ++process_tick
);
2806 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2807 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2809 /* If process has terminated, stop waiting for its output. */
2810 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2811 if (XINT (p
->infd
) >= 0)
2812 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
2814 /* Tell wait_reading_process_input that it needs to wake up and
2816 if (input_available_clear_time
)
2817 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2820 /* There was no asynchronous process found for that id. Check
2821 if we have a synchronous process. */
2824 synch_process_alive
= 0;
2826 /* Report the status of the synchronous process. */
2828 synch_process_retcode
= WRETCODE (w
);
2829 else if (WIFSIGNALED (w
))
2831 synch_process_death
= (char *) sys_siglist
[WTERMSIG (w
)];
2833 synch_process_death
= sys_errlist
[WTERMSIG (w
)];
2836 /* Tell wait_reading_process_input that it needs to wake up and
2838 if (input_available_clear_time
)
2839 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2842 /* On some systems, we must return right away.
2843 If any more processes want to signal us, we will
2845 Otherwise (on systems that have WNOHANG), loop around
2846 to use up all the processes that have something to tell us. */
2847 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2849 signal (signo
, sigchld_handler
);
2853 #endif /* USG, but not HPUX with WNOHANG */
2859 exec_sentinel_unwind (data
)
2862 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2867 exec_sentinel (proc
, reason
)
2868 Lisp_Object proc
, reason
;
2870 Lisp_Object sentinel
;
2871 register struct Lisp_Process
*p
= XPROCESS (proc
);
2872 int count
= specpdl_ptr
- specpdl
;
2874 sentinel
= p
->sentinel
;
2875 if (NILP (sentinel
))
2878 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2879 assure that it gets restored no matter how the sentinel exits. */
2881 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2882 /* Inhibit quit so that random quits don't screw up a running filter. */
2883 specbind (Qinhibit_quit
, Qt
);
2884 call2 (sentinel
, proc
, reason
);
2888 /* Report all recent events of a change in process status
2889 (either run the sentinel or output a message).
2890 This is done while Emacs is waiting for keyboard input. */
2894 register Lisp_Object proc
, buffer
;
2895 Lisp_Object tail
= Qnil
;
2896 Lisp_Object msg
= Qnil
;
2897 struct gcpro gcpro1
, gcpro2
;
2899 /* We need to gcpro tail; if read_process_output calls a filter
2900 which deletes a process and removes the cons to which tail points
2901 from Vprocess_alist, and then causes a GC, tail is an unprotected
2905 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2908 register struct Lisp_Process
*p
;
2910 proc
= Fcdr (Fcar (tail
));
2911 p
= XPROCESS (proc
);
2913 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2915 XSETINT (p
->update_tick
, XINT (p
->tick
));
2917 /* If process is still active, read any output that remains. */
2918 if (XINT (p
->infd
) >= 0)
2919 while (! EQ (p
->filter
, Qt
)
2920 && read_process_output (proc
, XINT (p
->infd
)) > 0);
2924 /* Get the text to use for the message. */
2925 if (!NILP (p
->raw_status_low
))
2927 msg
= status_message (p
->status
);
2929 /* If process is terminated, deactivate it or delete it. */
2931 if (XTYPE (p
->status
) == Lisp_Cons
)
2932 symbol
= XCONS (p
->status
)->car
;
2934 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2935 || EQ (symbol
, Qclosed
))
2937 if (delete_exited_processes
)
2938 remove_process (proc
);
2940 deactivate_process (proc
);
2943 /* Now output the message suitably. */
2944 if (!NILP (p
->sentinel
))
2945 exec_sentinel (proc
, msg
);
2946 /* Don't bother with a message in the buffer
2947 when a process becomes runnable. */
2948 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2950 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2952 struct buffer
*old
= current_buffer
;
2955 /* Avoid error if buffer is deleted
2956 (probably that's why the process is dead, too) */
2957 if (NILP (XBUFFER (buffer
)->name
))
2959 Fset_buffer (buffer
);
2961 /* Insert new output into buffer
2962 at the current end-of-output marker,
2963 thus preserving logical ordering of input and output. */
2964 if (XMARKER (p
->mark
)->buffer
)
2965 SET_PT (marker_position (p
->mark
));
2968 if (point
<= opoint
)
2969 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2971 tem
= current_buffer
->read_only
;
2972 current_buffer
->read_only
= Qnil
;
2973 insert_string ("\nProcess ");
2974 Finsert (1, &p
->name
);
2975 insert_string (" ");
2977 current_buffer
->read_only
= tem
;
2978 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2981 set_buffer_internal (old
);
2986 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
2987 redisplay_preserve_echo_area ();
2989 update_tick
= process_tick
;
3000 if (! noninteractive
|| initialized
)
3002 signal (SIGCHLD
, sigchld_handler
);
3005 FD_ZERO (&input_wait_mask
);
3007 keyboard_descriptor
= 0;
3008 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3010 Vprocess_alist
= Qnil
;
3011 for (i
= 0; i
< MAXDESC
; i
++)
3013 chan_process
[i
] = Qnil
;
3014 proc_buffered_char
[i
] = -1;
3018 /* From now on, assume keyboard input comes from descriptor DESC. */
3021 change_keyboard_wait_descriptor (desc
)
3024 FD_CLR (keyboard_descriptor
, &input_wait_mask
);
3025 keyboard_descriptor
= desc
;
3026 FD_SET (keyboard_descriptor
, &input_wait_mask
);
3032 stream_process
= intern ("stream");
3034 Qprocessp
= intern ("processp");
3035 staticpro (&Qprocessp
);
3036 Qrun
= intern ("run");
3038 Qstop
= intern ("stop");
3040 Qsignal
= intern ("signal");
3041 staticpro (&Qsignal
);
3043 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
3046 Qexit = intern ("exit");
3047 staticpro (&Qexit); */
3049 Qopen
= intern ("open");
3051 Qclosed
= intern ("closed");
3052 staticpro (&Qclosed
);
3054 staticpro (&Vprocess_alist
);
3056 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
3057 "*Non-nil means delete processes immediately when they exit.\n\
3058 nil means don't delete them until `list-processes' is run.");
3060 delete_exited_processes
= 1;
3062 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
3063 "Control type of device used to communicate with subprocesses.\n\
3064 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
3065 pty's are not available, this variable will be ignored. The value takes\n\
3066 effect when `start-process' is called.");
3067 Vprocess_connection_type
= Qt
;
3069 defsubr (&Sprocessp
);
3070 defsubr (&Sget_process
);
3071 defsubr (&Sget_buffer_process
);
3072 defsubr (&Sdelete_process
);
3073 defsubr (&Sprocess_status
);
3074 defsubr (&Sprocess_exit_status
);
3075 defsubr (&Sprocess_id
);
3076 defsubr (&Sprocess_name
);
3077 defsubr (&Sprocess_command
);
3078 defsubr (&Sset_process_buffer
);
3079 defsubr (&Sprocess_buffer
);
3080 defsubr (&Sprocess_mark
);
3081 defsubr (&Sset_process_filter
);
3082 defsubr (&Sprocess_filter
);
3083 defsubr (&Sset_process_sentinel
);
3084 defsubr (&Sprocess_sentinel
);
3085 defsubr (&Sprocess_kill_without_query
);
3086 defsubr (&Slist_processes
);
3087 defsubr (&Sprocess_list
);
3088 defsubr (&Sstart_process
);
3090 defsubr (&Sopen_network_stream
);
3091 #endif /* HAVE_SOCKETS */
3092 defsubr (&Saccept_process_output
);
3093 defsubr (&Sprocess_send_region
);
3094 defsubr (&Sprocess_send_string
);
3095 defsubr (&Sinterrupt_process
);
3096 defsubr (&Skill_process
);
3097 defsubr (&Squit_process
);
3098 defsubr (&Sstop_process
);
3099 defsubr (&Scontinue_process
);
3100 defsubr (&Sprocess_send_eof
);
3101 defsubr (&Ssignal_process
);
3102 defsubr (&Swaiting_for_user_input_p
);
3103 /* defsubr (&Sprocess_connection); */
3107 #else /* not subprocesses */
3109 #include <sys/types.h>
3113 #include "systime.h"
3114 #include "termopts.h"
3116 extern int frame_garbaged
;
3119 /* As described above, except assuming that there are no subprocesses:
3121 Wait for timeout to elapse and/or keyboard input to be available.
3124 timeout in seconds, or
3125 zero for no limit, or
3126 -1 means gobble data immediately available but don't wait for any.
3128 read_kbd is a Lisp_Object:
3129 0 to ignore keyboard input, or
3130 1 to return when input is available, or
3131 -1 means caller will actually read the input, so don't throw to
3133 We know that read_kbd will never be a Lisp_Process, since
3134 `subprocesses' isn't defined.
3136 do_display != 0 means redisplay should be done to show subprocess
3137 output that arrives. This version of the function ignores it.
3139 Return true iff we received input from any process. */
3142 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3143 int time_limit
, microsecs
;
3144 Lisp_Object read_kbd
;
3147 EMACS_TIME end_time
, timeout
, *timeout_p
;
3150 /* What does time_limit really mean? */
3151 if (time_limit
|| microsecs
)
3153 /* It's not infinite. */
3154 timeout_p
= &timeout
;
3156 if (time_limit
== -1)
3157 /* In fact, it's zero. */
3158 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3160 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3162 /* How far in the future is that? */
3163 EMACS_GET_TIME (end_time
);
3164 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3167 /* It's infinite. */
3170 /* This must come before stop_polling. */
3171 prepare_menu_bars ();
3173 /* Turn off periodic alarms (in case they are in use)
3174 because the select emulator uses alarms. */
3181 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3183 /* If calling from keyboard input, do not quit
3184 since we want to return C-g as an input character.
3185 Otherwise, do pending quit if requested. */
3186 if (XINT (read_kbd
) >= 0)
3191 EMACS_GET_TIME (*timeout_p
);
3192 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3193 if (EMACS_TIME_NEG_P (*timeout_p
))
3197 /* Cause C-g and alarm signals to take immediate action,
3198 and cause input available signals to zero out timeout. */
3199 if (XINT (read_kbd
) < 0)
3200 set_waiting_for_input (&timeout
);
3202 /* If a frame has been newly mapped and needs updating,
3203 reprocess its display stuff. */
3205 redisplay_preserve_echo_area ();
3207 if (XINT (read_kbd
) && detect_input_pending ())
3210 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3212 /* Make C-g and alarm signals set flags again */
3213 clear_waiting_for_input ();
3215 /* If we woke up due to SIGWINCH, actually change size now. */
3216 do_pending_window_change ();
3220 /* If the system call was interrupted, then go around the
3226 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3227 /* System sometimes fails to deliver SIGIO. */
3228 kill (getpid (), SIGIO
);
3231 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3235 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3247 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3248 /* Don't confused make-docfile by having two doc strings for this function.
3249 make-docfile does not pay attention to #if, for good reason! */
3252 register Lisp_Object name
;
3257 /* Kill all processes associated with `buffer'.
3258 If `buffer' is nil, kill all processes.
3259 Since we have no subprocesses, this does nothing. */
3261 kill_buffer_processes (buffer
)
3272 defsubr (&Sget_buffer_process
);
3276 #endif /* not subprocesses */