1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1992, 1993 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 #if defined(BSD) || defined(STRIDE)
50 #include <sys/ioctl.h>
51 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
53 #endif /* HAVE_PTYS and no O_NDELAY */
54 #endif /* BSD or STRIDE */
61 #include <sys/sysmacros.h> /* for "minor" */
71 #include "termhooks.h"
76 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
77 /* Qexit is declared and initialized in eval.c. */
79 /* a process object is a network connection when its childp field is neither
80 Qt nor Qnil but is instead a string (name of foreign host we
81 are connected to + name of port we are connected to) */
84 static Lisp_Object stream_process
;
86 #define NETCONN_P(p) (XGCTYPE (XPROCESS (p)->childp) == Lisp_String)
88 #define NETCONN_P(p) 0
89 #endif /* HAVE_SOCKETS */
91 /* Define first descriptor number available for subprocesses. */
93 #define FIRST_PROC_DESC 1
95 #define FIRST_PROC_DESC 3
98 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
101 #if !defined (SIGCHLD) && defined (SIGCLD)
102 #define SIGCHLD SIGCLD
105 #include "syssignal.h"
107 /* Define the structure that the wait system call stores.
108 On many systems, there is a structure defined for this.
109 But on vanilla-ish USG systems there is not. */
113 #if !defined (BSD) && !defined (UNIPLUS) && !defined (STRIDE) && !(defined (HPUX) && !defined (NOMULTIPLEJOBS)) && !defined (HAVE_WAIT_HEADER)
115 #define WIFSTOPPED(w) ((w&0377) == 0177)
116 #define WIFSIGNALED(w) ((w&0377) != 0177 && (w&~0377) == 0)
117 #define WIFEXITED(w) ((w&0377) == 0)
118 #define WRETCODE(w) (w >> 8)
119 #define WSTOPSIG(w) (w >> 8)
120 #define WTERMSIG(w) (w & 0377)
122 #define WCOREDUMP(w) ((w&0200) != 0)
128 #include <sys/wait.h>
129 #endif /* not BSD 4.1 */
131 #define WAITTYPE union wait
132 #define WRETCODE(w) w.w_retcode
133 #define WCOREDUMP(w) w.w_coredump
136 /* HPUX version 7 has broken definitions of these. */
145 #define WTERMSIG(w) w.w_termsig
148 #define WSTOPSIG(w) w.w_stopsig
151 #define WIFSTOPPED(w) (WTERMSIG (w) == 0177)
154 #define WIFSIGNALED(w) (WTERMSIG (w) != 0177 && (WSTOPSIG (w)) == 0)
157 #define WIFEXITED(w) (WTERMSIG (w) == 0)
159 #endif /* BSD or UNIPLUS or STRIDE */
160 #endif /* no WAITTYPE */
163 /* For the CMU PTY driver + */
164 #define DCL_PROMPT "$ "
165 /* This is a hack. I have no idea what needs to go here, but this */
166 /* will get it to compile. We can fix it later. rbr */
176 extern char *sys_errlist
[];
180 extern char *sys_siglist
[];
182 char *sys_siglist
[] =
188 "illegal instruction",
192 "floating point exception",
195 "segmentation violation",
196 "bad argument to system call",
197 "write on a pipe with no one to read it",
199 "software termination signal from kill",
201 "sendable stop signal not from tty",
202 "stop signal from tty",
203 "continue a stopped process",
204 "child status has changed",
205 "background read attempted from control tty",
206 "background write attempted from control tty",
207 "input record available at control tty",
208 "exceeded CPU time limit",
209 "exceeded file size limit"
214 /* t means use pty, nil means use a pipe,
215 maybe other values to come. */
216 Lisp_Object Vprocess_connection_type
;
220 #include <sys/socket.h>
224 /* Number of events of change of status of a process. */
227 /* Number of events for which the user or sentinel has been notified. */
231 /* We could get this from param.h, but better not to depend on finding that.
232 And better not to risk that it might define other symbols used in this
235 #define SELECT_TYPE fd_set
236 #else /* no FD_SET */
238 #define SELECT_TYPE int
240 /* Define the macros to access a single-int bitmap of descriptors. */
241 #define FD_SET(n, p) (*(p) |= (1 << (n)))
242 #define FD_CLR(n, p) (*(p) &= ~(1 << (n)))
243 #define FD_ISSET(n, p) (*(p) & (1 << (n)))
244 #define FD_ZERO(p) (*(p) = 0)
245 #endif /* no FD_SET */
247 /* Mask of bits indicating the descriptors that we wait for input on */
249 SELECT_TYPE input_wait_mask
;
251 int delete_exited_processes
;
253 /* Indexed by descriptor, gives the process (if any) for that descriptor */
254 Lisp_Object chan_process
[MAXDESC
];
256 /* Alist of elements (NAME . PROCESS) */
257 Lisp_Object Vprocess_alist
;
259 Lisp_Object Qprocessp
;
261 Lisp_Object
get_process ();
263 /* Buffered-ahead input char from process, indexed by channel.
264 -1 means empty (no char is buffered).
265 Used on sys V where the only way to tell if there is any
266 output from the process is to read at least one char.
267 Always -1 on systems that support FIONREAD. */
269 int proc_buffered_char
[MAXDESC
];
271 /* Compute the Lisp form of the process status, p->status, from
272 the numeric status that was returned by `wait'. */
274 Lisp_Object
status_convert ();
277 struct Lisp_Process
*p
;
279 union { int i
; WAITTYPE wt
; } u
;
280 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
281 p
->status
= status_convert (u
.wt
);
282 p
->raw_status_low
= Qnil
;
283 p
->raw_status_high
= Qnil
;
286 /* Convert a process status work in Unix format to
287 the list that we use internally. */
294 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
295 else if (WIFEXITED (w
))
296 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
297 WCOREDUMP (w
) ? Qt
: Qnil
));
298 else if (WIFSIGNALED (w
))
299 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
300 WCOREDUMP (w
) ? Qt
: Qnil
));
305 /* Given a status-list, extract the three pieces of information
306 and store them individually through the three pointers. */
309 decode_status (l
, symbol
, code
, coredump
)
317 if (XTYPE (l
) == Lisp_Symbol
)
325 *symbol
= XCONS (l
)->car
;
326 tem
= XCONS (l
)->cdr
;
327 *code
= XFASTINT (XCONS (tem
)->car
);
328 tem
= XCONS (tem
)->cdr
;
329 *coredump
= !NILP (tem
);
333 /* Return a string describing a process status list. */
336 status_message (status
)
341 Lisp_Object string
, string2
;
343 decode_status (status
, &symbol
, &code
, &coredump
);
345 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
348 string
= build_string (code
< NSIG
? sys_siglist
[code
] : "unknown");
350 string
= build_string (code
< NSIG
? sys_errlist
[code
] : "unknown");
352 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
353 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
354 return concat2 (string
, string2
);
356 else if (EQ (symbol
, Qexit
))
359 return build_string ("finished\n");
360 string
= Fint_to_string (make_number (code
));
361 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
362 return concat2 (build_string ("exited abnormally with code "),
363 concat2 (string
, string2
));
366 return Fcopy_sequence (Fsymbol_name (symbol
));
371 /* Open an available pty, returning a file descriptor.
372 Return -1 on failure.
373 The file name of the terminal corresponding to the pty
374 is left in the variable pty_name. */
385 /* Some systems name their pseudoterminals so that there are gaps in
386 the usual sequence - for example, on HP9000/S700 systems, there
387 are no pseudoterminals with names ending in 'f'. So we wait for
388 three failures in a row before deciding that we've reached the
390 int failed_count
= 0;
395 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
396 for (i
= 0; i
< 16; i
++)
399 #ifdef PTY_NAME_SPRINTF
402 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
403 #endif /* no PTY_NAME_SPRINTF */
407 #else /* no PTY_OPEN */
409 /* Unusual IRIS code */
410 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
413 if (fstat (fd
, &stb
) < 0)
416 if (stat (pty_name
, &stb
) < 0)
419 if (failed_count
>= 3)
425 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
427 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
429 #endif /* not IRIS */
430 #endif /* no PTY_OPEN */
434 /* check to make certain that both sides are available
435 this avoids a nasty yet stupid bug in rlogins */
436 #ifdef PTY_TTY_NAME_SPRINTF
439 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
440 #endif /* no PTY_TTY_NAME_SPRINTF */
442 if (access (pty_name
, 6) != 0)
451 #endif /* not UNIPLUS */
458 #endif /* HAVE_PTYS */
464 register Lisp_Object val
, tem
, name1
;
465 register struct Lisp_Process
*p
;
469 /* size of process structure includes the vector header,
470 so deduct for that. But struct Lisp_Vector includes the first
471 element, thus deducts too much, so add it back. */
472 val
= Fmake_vector (make_number ((sizeof (struct Lisp_Process
)
473 - sizeof (struct Lisp_Vector
)
474 + sizeof (Lisp_Object
))
475 / sizeof (Lisp_Object
)),
477 XSETTYPE (val
, Lisp_Process
);
480 XFASTINT (p
->infd
) = 0;
481 XFASTINT (p
->outfd
) = 0;
482 XFASTINT (p
->pid
) = 0;
483 XFASTINT (p
->tick
) = 0;
484 XFASTINT (p
->update_tick
) = 0;
485 p
->raw_status_low
= Qnil
;
486 p
->raw_status_high
= Qnil
;
488 p
->mark
= Fmake_marker ();
490 /* If name is already in use, modify it until it is unused. */
495 tem
= Fget_process (name1
);
496 if (NILP (tem
)) break;
497 sprintf (suffix
, "<%d>", i
);
498 name1
= concat2 (name
, build_string (suffix
));
502 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
506 remove_process (proc
)
507 register Lisp_Object proc
;
509 register Lisp_Object pair
;
511 pair
= Frassq (proc
, Vprocess_alist
);
512 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
513 Fset_marker (XPROCESS (proc
)->mark
, Qnil
, Qnil
);
515 deactivate_process (proc
);
518 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
519 "Return t if OBJECT is a process.")
523 return XTYPE (obj
) == Lisp_Process
? Qt
: Qnil
;
526 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
527 "Return the process named NAME, or nil if there is none.")
529 register Lisp_Object name
;
531 if (XTYPE (name
) == Lisp_Process
)
533 CHECK_STRING (name
, 0);
534 return Fcdr (Fassoc (name
, Vprocess_alist
));
537 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
538 "Return the (or, a) process associated with BUFFER.\n\
539 BUFFER may be a buffer or the name of one.")
541 register Lisp_Object name
;
543 register Lisp_Object buf
, tail
, proc
;
545 if (NILP (name
)) return Qnil
;
546 buf
= Fget_buffer (name
);
547 if (NILP (buf
)) return Qnil
;
549 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
551 proc
= Fcdr (Fcar (tail
));
552 if (XTYPE (proc
) == Lisp_Process
&& EQ (XPROCESS (proc
)->buffer
, buf
))
558 /* This is how commands for the user decode process arguments. It
559 accepts a process, a process name, a buffer, a buffer name, or nil.
560 Buffers denote the first process in the buffer, and nil denotes the
565 register Lisp_Object name
;
567 register Lisp_Object proc
;
569 proc
= Fget_buffer_process (Fcurrent_buffer ());
572 proc
= Fget_process (name
);
574 proc
= Fget_buffer_process (Fget_buffer (name
));
581 error ("Current buffer has no process");
583 error ("Process %s does not exist", XSTRING (name
)->data
);
587 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
588 "Delete PROCESS: kill it and forget about it immediately.\n\
589 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
590 nil, indicating the current buffer's process.")
592 register Lisp_Object proc
;
594 proc
= get_process (proc
);
595 XPROCESS (proc
)->raw_status_low
= Qnil
;
596 XPROCESS (proc
)->raw_status_high
= Qnil
;
597 if (NETCONN_P (proc
))
599 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
600 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
602 else if (XFASTINT (XPROCESS (proc
)->infd
))
604 Fkill_process (proc
, Qnil
);
605 /* Do this now, since remove_process will make sigchld_handler do nothing. */
606 XPROCESS (proc
)->status
607 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
608 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
611 remove_process (proc
);
615 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
616 "Return the status of PROCESS: a symbol, one of these:\n\
617 run -- for a process that is running.\n\
618 stop -- for a process stopped but continuable.\n\
619 exit -- for a process that has exited.\n\
620 signal -- for a process that has got a fatal signal.\n\
621 open -- for a network stream connection that is open.\n\
622 closed -- for a network stream connection that is closed.\n\
623 nil -- if arg is a process name and no such process exists.\n\
624 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
625 nil, indicating the current buffer's process.")
626 /* command -- for a command channel opened to Emacs by another process.\n\
627 external -- for an i/o channel opened to Emacs by another process.\n\ */
629 register Lisp_Object proc
;
631 register struct Lisp_Process
*p
;
632 register Lisp_Object status
;
633 proc
= get_process (proc
);
637 if (!NILP (p
->raw_status_low
))
640 if (XTYPE (status
) == Lisp_Cons
)
641 status
= XCONS (status
)->car
;
642 if (NETCONN_P (proc
))
644 if (EQ (status
, Qrun
))
646 else if (EQ (status
, Qexit
))
652 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
654 "Return the exit status of PROCESS or the signal number that killed it.\n\
655 If PROCESS has not yet exited or died, return 0.")
657 register Lisp_Object proc
;
659 CHECK_PROCESS (proc
, 0);
660 if (!NILP (XPROCESS (proc
)->raw_status_low
))
661 update_status (XPROCESS (proc
));
662 if (XTYPE (XPROCESS (proc
)->status
) == Lisp_Cons
)
663 return XCONS (XCONS (XPROCESS (proc
)->status
)->cdr
)->car
;
664 return make_number (0);
667 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
668 "Return the process id of PROCESS.\n\
669 This is the pid of the Unix process which PROCESS uses or talks to.\n\
670 For a network connection, this value is nil.")
672 register Lisp_Object proc
;
674 CHECK_PROCESS (proc
, 0);
675 return XPROCESS (proc
)->pid
;
678 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
679 "Return the name of PROCESS, as a string.\n\
680 This is the name of the program invoked in PROCESS,\n\
681 possibly modified to make it unique among process names.")
683 register Lisp_Object proc
;
685 CHECK_PROCESS (proc
, 0);
686 return XPROCESS (proc
)->name
;
689 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
690 "Return the command that was executed to start PROCESS.\n\
691 This is a list of strings, the first string being the program executed\n\
692 and the rest of the strings being the arguments given to it.\n\
693 For a non-child channel, this is nil.")
695 register Lisp_Object proc
;
697 CHECK_PROCESS (proc
, 0);
698 return XPROCESS (proc
)->command
;
701 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
703 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
705 register Lisp_Object proc
, buffer
;
707 CHECK_PROCESS (proc
, 0);
709 CHECK_BUFFER (buffer
, 1);
710 XPROCESS (proc
)->buffer
= buffer
;
714 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
716 "Return the buffer PROCESS is associated with.\n\
717 Output from PROCESS is inserted in this buffer\n\
718 unless PROCESS has a filter.")
720 register Lisp_Object proc
;
722 CHECK_PROCESS (proc
, 0);
723 return XPROCESS (proc
)->buffer
;
726 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
728 "Return the marker for the end of the last output from PROCESS.")
730 register Lisp_Object proc
;
732 CHECK_PROCESS (proc
, 0);
733 return XPROCESS (proc
)->mark
;
736 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
738 "Give PROCESS the filter function FILTER; nil means no filter.\n\
739 When a process has a filter, each time it does output\n\
740 the entire string of output is passed to the filter.\n\
741 The filter gets two arguments: the process and the string of output.\n\
742 If the process has a filter, its buffer is not used for output.")
744 register Lisp_Object proc
, filter
;
746 CHECK_PROCESS (proc
, 0);
747 XPROCESS (proc
)->filter
= filter
;
751 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
753 "Returns the filter function of PROCESS; nil if none.\n\
754 See `set-process-filter' for more info on filter functions.")
756 register Lisp_Object proc
;
758 CHECK_PROCESS (proc
, 0);
759 return XPROCESS (proc
)->filter
;
762 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
764 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
765 The sentinel is called as a function when the process changes state.\n\
766 It gets two arguments: the process, and a string describing the change.")
768 register Lisp_Object proc
, sentinel
;
770 CHECK_PROCESS (proc
, 0);
771 XPROCESS (proc
)->sentinel
= sentinel
;
775 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
777 "Return the sentinel of PROCESS; nil if none.\n\
778 See `set-process-sentinel' for more info on sentinels.")
780 register Lisp_Object proc
;
782 CHECK_PROCESS (proc
, 0);
783 return XPROCESS (proc
)->sentinel
;
786 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
787 Sprocess_kill_without_query
, 1, 2, 0,
788 "Say no query needed if PROCESS is running when Emacs is exited.\n\
789 Optional second argument if non-nill says to require a query.\n\
790 Value is t if a query was formerly required.")
792 register Lisp_Object proc
, value
;
796 CHECK_PROCESS (proc
, 0);
797 tem
= XPROCESS (proc
)->kill_without_query
;
798 XPROCESS (proc
)->kill_without_query
= Fnull (value
);
806 register Lisp_Object tail
, tem
;
807 Lisp_Object proc
, minspace
, tem1
;
808 register struct buffer
*old
= current_buffer
;
809 register struct Lisp_Process
*p
;
813 XFASTINT (minspace
) = 1;
815 set_buffer_internal (XBUFFER (Vstandard_output
));
816 Fbuffer_disable_undo (Vstandard_output
);
818 current_buffer
->truncate_lines
= Qt
;
821 Proc Status Buffer Command\n\
822 ---- ------ ------ -------\n", -1);
824 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
828 proc
= Fcdr (Fcar (tail
));
830 if (NILP (p
->childp
))
833 Finsert (1, &p
->name
);
834 Findent_to (make_number (13), minspace
);
836 if (!NILP (p
->raw_status_low
))
839 if (XTYPE (p
->status
) == Lisp_Cons
)
840 symbol
= XCONS (p
->status
)->car
;
843 if (EQ (symbol
, Qsignal
))
846 tem
= Fcar (Fcdr (p
->status
));
848 if (XINT (tem
) < NSIG
)
849 write_string (sys_errlist
[XINT (tem
)], -1);
852 Fprinc (symbol
, Qnil
);
854 else if (NETCONN_P (proc
))
856 if (EQ (symbol
, Qrun
))
857 write_string ("open", -1);
858 else if (EQ (symbol
, Qexit
))
859 write_string ("closed", -1);
861 Fprinc (symbol
, Qnil
);
864 Fprinc (symbol
, Qnil
);
866 if (EQ (symbol
, Qexit
))
869 tem
= Fcar (Fcdr (p
->status
));
872 sprintf (tembuf
, " %d", XFASTINT (tem
));
873 write_string (tembuf
, -1);
877 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
878 remove_process (proc
);
880 Findent_to (make_number (22), minspace
);
881 if (NILP (p
->buffer
))
882 insert_string ("(none)");
883 else if (NILP (XBUFFER (p
->buffer
)->name
))
884 insert_string ("(Killed)");
886 Finsert (1, &XBUFFER (p
->buffer
)->name
);
888 Findent_to (make_number (37), minspace
);
890 if (NETCONN_P (proc
))
892 sprintf (tembuf
, "(network stream connection to %s)\n",
893 XSTRING (p
->childp
)->data
);
894 insert_string (tembuf
);
908 insert_string ("\n");
914 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
915 "Display a list of all processes.\n\
916 \(Any processes listed as Exited or Signaled are actually eliminated\n\
917 after the listing is made.)")
920 internal_with_output_to_temp_buffer ("*Process List*",
921 list_processes_1
, Qnil
);
925 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
926 "Return a list of all processes.")
929 return Fmapcar (Qcdr
, Vprocess_alist
);
932 /* Starting asynchronous inferior processes. */
934 static Lisp_Object
start_process_unwind ();
936 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
937 "Start a program in a subprocess. Return the process object for it.\n\
938 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
939 NAME is name for process. It is modified if necessary to make it unique.\n\
940 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
941 Process output goes at end of that buffer, unless you specify\n\
942 an output stream or filter function to handle the output.\n\
943 BUFFER may be also nil, meaning that this process is not associated\n\
945 Third arg is program file name. It is searched for as in the shell.\n\
946 Remaining arguments are strings to give program as arguments.")
949 register Lisp_Object
*args
;
951 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
953 register unsigned char *new_argv
;
956 register unsigned char **new_argv
;
959 int count
= specpdl_ptr
- specpdl
;
963 buffer
= Fget_buffer_create (buffer
);
965 /* Make sure that the child will be able to chdir to the current
966 buffer's current directory, or its unhandled equivalent. We
967 can't just have the child check for an error when it does the
968 chdir, since it's in a vfork.
970 We have to GCPRO around this because Fexpand_file_name and
971 Funhandled_file_name_directory might call a file name handling
972 function. The argument list is protected by the caller, so all
973 we really have to worry about is buffer. */
975 struct gcpro gcpro1
, gcpro2
;
977 current_dir
= current_buffer
->directory
;
979 GCPRO2 (buffer
, current_dir
);
982 expand_and_dir_to_file
983 (Funhandled_file_name_directory (current_dir
), Qnil
);
984 if (NILP (Ffile_accessible_directory_p (current_dir
)))
985 report_file_error ("Setting current directory",
986 Fcons (current_buffer
->directory
, Qnil
));
992 CHECK_STRING (name
, 0);
996 CHECK_STRING (program
, 2);
999 /* Make a one member argv with all args concatenated
1000 together separated by a blank. */
1001 len
= XSTRING (program
)->size
+ 2;
1002 for (i
= 3; i
< nargs
; i
++)
1005 CHECK_STRING (tem
, i
);
1006 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1008 new_argv
= (unsigned char *) alloca (len
);
1009 strcpy (new_argv
, XSTRING (program
)->data
);
1010 for (i
= 3; i
< nargs
; i
++)
1013 CHECK_STRING (tem
, i
);
1014 strcat (new_argv
, " ");
1015 strcat (new_argv
, XSTRING (tem
)->data
);
1017 /* Need to add code here to check for program existence on VMS */
1020 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1022 for (i
= 3; i
< nargs
; i
++)
1025 CHECK_STRING (tem
, i
);
1026 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1028 new_argv
[i
- 2] = 0;
1029 new_argv
[0] = XSTRING (program
)->data
;
1031 /* If program file name is not absolute, search our path for it */
1032 if (new_argv
[0][0] != '/')
1035 openp (Vexec_path
, program
, "", &tem
, 1);
1037 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1038 new_argv
[0] = XSTRING (tem
)->data
;
1040 #endif /* not VMS */
1042 proc
= make_process (name
);
1043 /* If an error occurs and we can't start the process, we want to
1044 remove it from the process list. This means that each error
1045 check in create_process doesn't need to call remove_process
1046 itself; it's all taken care of here. */
1047 record_unwind_protect (start_process_unwind
, proc
);
1049 XPROCESS (proc
)->childp
= Qt
;
1050 XPROCESS (proc
)->command_channel_p
= Qnil
;
1051 XPROCESS (proc
)->buffer
= buffer
;
1052 XPROCESS (proc
)->sentinel
= Qnil
;
1053 XPROCESS (proc
)->filter
= Qnil
;
1054 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1056 create_process (proc
, new_argv
, current_dir
);
1058 return unbind_to (count
, proc
);
1061 /* This function is the unwind_protect form for Fstart_process. If
1062 PROC doesn't have its pid set, then we know someone has signalled
1063 an error and the process wasn't started successfully, so we should
1064 remove it from the process list. */
1066 start_process_unwind (proc
)
1069 if (XTYPE (proc
) != Lisp_Process
)
1072 /* Was PROC started successfully? */
1073 if (XPROCESS (proc
)->pid
<= 0)
1074 remove_process (proc
);
1081 create_process_1 (signo
)
1085 /* USG systems forget handlers when they are used;
1086 must reestablish each time */
1087 signal (signo
, create_process_1
);
1091 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1094 /* Mimic blocking of signals on system V, which doesn't really have it. */
1096 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1097 int sigchld_deferred
;
1100 create_process_sigchld ()
1102 signal (SIGCHLD
, create_process_sigchld
);
1104 sigchld_deferred
= 1;
1110 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1111 create_process (process
, new_argv
, current_dir
)
1112 Lisp_Object process
;
1114 Lisp_Object current_dir
;
1116 int pid
, inchannel
, outchannel
, forkin
, forkout
;
1119 SIGTYPE (*sigchld
)();
1122 extern char **environ
;
1124 inchannel
= outchannel
= -1;
1127 if (EQ (Vprocess_connection_type
, Qt
))
1128 outchannel
= inchannel
= allocate_pty ();
1133 /* On USG systems it does not work to open the pty's tty here
1134 and then close and reopen it in the child. */
1136 /* Don't let this terminal become our controlling terminal
1137 (in case we don't have one). */
1138 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1140 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1143 report_file_error ("Opening pty", Qnil
);
1145 forkin
= forkout
= -1;
1146 #endif /* not USG */
1150 #endif /* HAVE_PTYS */
1153 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1154 report_file_error ("Opening socketpair", Qnil
);
1155 outchannel
= inchannel
= sv
[0];
1156 forkout
= forkin
= sv
[1];
1158 #else /* not SKTPAIR */
1167 #endif /* not SKTPAIR */
1170 /* Replaced by close_process_descs */
1171 set_exclusive_use (inchannel
);
1172 set_exclusive_use (outchannel
);
1175 /* Stride people say it's a mystery why this is needed
1176 as well as the O_NDELAY, but that it fails without this. */
1177 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1180 ioctl (inchannel
, FIONBIO
, &one
);
1185 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1188 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1192 /* Record this as an active process, with its channels.
1193 As a result, child_setup will close Emacs's side of the pipes. */
1194 chan_process
[inchannel
] = process
;
1195 XFASTINT (XPROCESS (process
)->infd
) = inchannel
;
1196 XFASTINT (XPROCESS (process
)->outfd
) = outchannel
;
1197 /* Record the tty descriptor used in the subprocess. */
1199 XPROCESS (process
)->subtty
= Qnil
;
1201 XFASTINT (XPROCESS (process
)->subtty
) = forkin
;
1202 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1203 XPROCESS (process
)->status
= Qrun
;
1205 /* Delay interrupts until we have a chance to store
1206 the new fork's pid in its process structure */
1210 #else /* not BSD4_1 */
1211 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1212 sigsetmask (sigmask (SIGCHLD
));
1213 #else /* ordinary USG */
1215 sigchld_deferred
= 0;
1216 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1218 #endif /* ordinary USG */
1219 #endif /* not BSD4_1 */
1220 #endif /* SIGCHLD */
1222 /* Until we store the proper pid, enable sigchld_handler
1223 to recognize an unknown pid as standing for this process.
1224 It is very important not to let this `marker' value stay
1225 in the table after this function has returned; if it does
1226 it might cause call-process to hang and subsequent asynchronous
1227 processes to get their return values scrambled. */
1228 XSETINT (XPROCESS (process
)->pid
, -1);
1231 /* child_setup must clobber environ on systems with true vfork.
1232 Protect it from permanent change. */
1233 char **save_environ
= environ
;
1238 int xforkin
= forkin
;
1239 int xforkout
= forkout
;
1241 #if 0 /* This was probably a mistake--it duplicates code later on,
1242 but fails to handle all the cases. */
1243 /* Make sure SIGCHLD is not blocked in the child. */
1244 sigsetmask (SIGEMPTYMASK
);
1247 /* Make the pty be the controlling terminal of the process. */
1249 /* First, disconnect its current controlling terminal. */
1253 /* Make the pty's terminal the controlling terminal. */
1254 if (pty_flag
&& (ioctl (xforkin
, TIOCSCTTY
, 0) < 0))
1257 #else /* not HAVE_SETSID */
1259 /* It's very important to call setpgrp() here and no time
1260 afterwards. Otherwise, we lose our controlling tty which
1261 is set when we open the pty. */
1264 #endif /* not HAVE_SETSID */
1266 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1267 can do TIOCSPGRP only to the process's controlling tty. */
1270 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1271 I can't test it since I don't have 4.3. */
1272 int j
= open ("/dev/tty", O_RDWR
, 0);
1273 ioctl (j
, TIOCNOTTY
, 0);
1276 /* In order to get a controlling terminal on some versions
1277 of BSD, it is necessary to put the process in pgrp 0
1278 before it opens the terminal. */
1282 #endif /* TIOCNOTTY */
1284 #if !defined (RTU) && !defined (UNIPLUS)
1285 /*** There is a suggestion that this ought to be a
1286 conditional on TIOCSPGRP. */
1287 /* Now close the pty (if we had it open) and reopen it.
1288 This makes the pty the controlling terminal of the subprocess. */
1291 /* I wonder if close (open (pty_name, ...)) would work? */
1294 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
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
);
1346 /* OK to close only if it's not a pty. Otherwise we need to leave
1347 it open for ioctl to get pgrp when signals are sent, or to send
1348 the interrupt characters through if that's how we're signalling
1349 subprocesses. Alternately if you are concerned about running out
1350 of file descriptors, you could just save the tty name and open
1351 just to do the ioctl. */
1352 if (NILP (XFASTINT (XPROCESS (process
)->pty_flag
)))
1355 XPROCESS (process
)->subtty
= Qnil
;
1361 if (forkin
!= forkout
&& forkout
>= 0)
1367 #else /* not BSD4_1 */
1368 #if defined (BSD) || defined (UNIPLUS) || defined (HPUX)
1369 sigsetmask (SIGEMPTYMASK
);
1370 #else /* ordinary USG */
1372 signal (SIGCHLD
, sigchld
);
1373 /* Now really handle any of these signals
1374 that came in during this function. */
1375 if (sigchld_deferred
)
1376 kill (getpid (), SIGCHLD
);
1378 #endif /* ordinary USG */
1379 #endif /* not BSD4_1 */
1380 #endif /* SIGCHLD */
1382 #endif /* not VMS */
1386 /* open a TCP network connection to a given HOST/SERVICE. Treated
1387 exactly like a normal process when reading and writing. Only
1388 differences are in status display and process deletion. A network
1389 connection has no PID; you cannot signal it. All you can do is
1390 deactivate and close it via delete-process */
1392 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1394 "Open a TCP connection for a service to a host.\n\
1395 Returns a subprocess-object to represent the connection.\n\
1396 Input and output work as for subprocesses; `delete-process' closes it.\n\
1397 Args are NAME BUFFER HOST SERVICE.\n\
1398 NAME is name for process. It is modified if necessary to make it unique.\n\
1399 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1400 Process output goes at end of that buffer, unless you specify\n\
1401 an output stream or filter function to handle the output.\n\
1402 BUFFER may be also nil, meaning that this process is not associated\n\
1404 Third arg is name of the host to connect to, or its IP address.\n\
1405 Fourth arg SERVICE is name of the service desired, or an integer\n\
1406 specifying a port number to connect to.")
1407 (name
, buffer
, host
, service
)
1408 Lisp_Object name
, buffer
, host
, service
;
1412 struct sockaddr_in address
;
1413 struct servent
*svc_info
;
1414 struct hostent
*host_info_ptr
, host_info
;
1415 char *(addr_list
[2]);
1416 unsigned long numeric_addr
;
1420 struct hostent host_info_fixed
;
1421 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1423 GCPRO4 (name
, buffer
, host
, service
);
1424 CHECK_STRING (name
, 0);
1425 CHECK_STRING (host
, 0);
1426 if (XTYPE(service
) == Lisp_Int
)
1427 port
= htons ((unsigned short) XINT (service
));
1430 CHECK_STRING (service
, 0);
1431 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1433 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1434 port
= svc_info
->s_port
;
1437 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1438 if (host_info_ptr
== 0)
1439 /* Attempt to interpret host as numeric inet address */
1441 numeric_addr
= inet_addr (XSTRING (host
)->data
);
1442 if (numeric_addr
== -1)
1443 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1445 host_info_ptr
= &host_info
;
1446 host_info
.h_name
= 0;
1447 host_info
.h_aliases
= 0;
1448 host_info
.h_addrtype
= AF_INET
;
1449 host_info
.h_addr_list
= &(addr_list
[0]);
1450 addr_list
[0] = (char*)(&numeric_addr
);
1452 host_info
.h_length
= strlen (addr_list
[0]);
1455 bzero (&address
, sizeof address
);
1456 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1457 host_info_ptr
->h_length
);
1458 address
.sin_family
= host_info_ptr
->h_addrtype
;
1459 address
.sin_port
= port
;
1461 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1463 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1466 if (connect (s
, &address
, sizeof address
) == -1)
1473 report_file_error ("connection failed",
1474 Fcons (host
, Fcons (name
, Qnil
)));
1480 report_file_error ("error duplicating socket", Fcons (name
, Qnil
));
1483 buffer
= Fget_buffer_create (buffer
);
1484 proc
= make_process (name
);
1486 chan_process
[inch
] = proc
;
1489 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1492 fcntl (inch
, F_SETFL
, O_NDELAY
);
1496 XPROCESS (proc
)->childp
= host
;
1497 XPROCESS (proc
)->command_channel_p
= Qnil
;
1498 XPROCESS (proc
)->buffer
= buffer
;
1499 XPROCESS (proc
)->sentinel
= Qnil
;
1500 XPROCESS (proc
)->filter
= Qnil
;
1501 XPROCESS (proc
)->command
= Qnil
;
1502 XPROCESS (proc
)->pid
= Qnil
;
1503 XFASTINT (XPROCESS (proc
)->infd
) = s
;
1504 XFASTINT (XPROCESS (proc
)->outfd
) = outch
;
1505 XPROCESS (proc
)->status
= Qrun
;
1506 FD_SET (inch
, &input_wait_mask
);
1511 #endif /* HAVE_SOCKETS */
1513 deactivate_process (proc
)
1516 register int inchannel
, outchannel
;
1517 register struct Lisp_Process
*p
= XPROCESS (proc
);
1519 inchannel
= XFASTINT (p
->infd
);
1520 outchannel
= XFASTINT (p
->outfd
);
1524 /* Beware SIGCHLD hereabouts. */
1525 flush_pending_output (inchannel
);
1528 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1529 sys$
dassgn (outchannel
);
1530 vs
= get_vms_process_pointer (p
->pid
)
1532 give_back_vms_process_stuff (vs
);
1536 if (outchannel
&& outchannel
!= inchannel
)
1540 XFASTINT (p
->infd
) = 0;
1541 XFASTINT (p
->outfd
) = 0;
1542 chan_process
[inchannel
] = Qnil
;
1543 FD_CLR (inchannel
, &input_wait_mask
);
1547 /* Close all descriptors currently in use for communication
1548 with subprocess. This is used in a newly-forked subprocess
1549 to get rid of irrelevant descriptors. */
1551 close_process_descs ()
1554 for (i
= 0; i
< MAXDESC
; i
++)
1556 Lisp_Object process
;
1557 process
= chan_process
[i
];
1558 if (!NILP (process
))
1560 int in
= XFASTINT (XPROCESS (process
)->infd
);
1561 int out
= XFASTINT (XPROCESS (process
)->outfd
);
1564 if (out
&& in
!= out
)
1570 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
1572 "Allow any pending output from subprocesses to be read by Emacs.\n\
1573 It is read into the process' buffers or given to their filter functions.\n\
1574 Non-nil arg PROCESS means do not return until some output has been received\n\
1576 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
1577 seconds and microseconds to wait; return after that much time whether\n\
1578 or not there is input.\n\
1579 Return non-nil iff we received any output before the timeout expired.")
1580 (proc
, timeout
, timeout_msecs
)
1581 register Lisp_Object proc
, timeout
, timeout_msecs
;
1586 if (! NILP (timeout_msecs
))
1588 CHECK_NUMBER (timeout_msecs
, 2);
1589 useconds
= XINT (timeout_msecs
);
1590 if (XTYPE (timeout
) != Lisp_Int
)
1591 XSET (timeout
, Lisp_Int
, 0);
1594 int carry
= useconds
/ 1000000;
1596 XSETINT (timeout
, XINT (timeout
) + carry
);
1597 useconds
-= carry
* 1000000;
1599 /* I think this clause is necessary because C doesn't
1600 guarantee a particular rounding direction for negative
1604 XSETINT (timeout
, XINT (timeout
) - 1);
1605 useconds
+= 1000000;
1612 if (! NILP (timeout
))
1614 CHECK_NUMBER (timeout
, 1);
1615 seconds
= XINT (timeout
);
1628 XFASTINT (proc
) = 0;
1631 (wait_reading_process_input (seconds
, useconds
, proc
, 0)
1635 /* This variable is different from waiting_for_input in keyboard.c.
1636 It is used to communicate to a lisp process-filter/sentinel (via the
1637 function Fwaiting_for_user_input_p below) whether emacs was waiting
1638 for user-input when that process-filter was called.
1639 waiting_for_input cannot be used as that is by definition 0 when
1640 lisp code is being evalled */
1641 static int waiting_for_user_input_p
;
1643 /* Read and dispose of subprocess output while waiting for timeout to
1644 elapse and/or keyboard input to be available.
1647 timeout in seconds, or
1648 zero for no limit, or
1649 -1 means gobble data immediately available but don't wait for any.
1651 read_kbd is a lisp value:
1652 0 to ignore keyboard input, or
1653 1 to return when input is available, or
1654 -1 meaning caller will actually read the input, so don't throw to
1655 the quit handler, or
1656 a cons cell, meaning wait wait until its car is non-nil, or
1657 a process object, meaning wait until something arrives from that
1658 process. The return value is true iff we read some input from
1661 do_display != 0 means redisplay should be done to show subprocess
1662 output that arrives.
1664 If read_kbd is a pointer to a struct Lisp_Process, then the
1665 function returns true iff we received input from that process
1666 before the timeout elapsed.
1667 Otherwise, return true iff we recieved input from any process. */
1669 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
1670 int time_limit
, microsecs
;
1671 Lisp_Object read_kbd
;
1674 register int channel
, nfds
, m
;
1675 static SELECT_TYPE Available
;
1678 EMACS_TIME timeout
, end_time
, garbage
;
1680 int wait_channel
= 0;
1681 struct Lisp_Process
*wait_proc
= 0;
1682 int got_some_input
= 0;
1683 Lisp_Object
*wait_for_cell
= 0;
1685 FD_ZERO (&Available
);
1687 /* If read_kbd is a process to watch, set wait_proc and wait_channel
1689 if (XTYPE (read_kbd
) == Lisp_Process
)
1691 wait_proc
= XPROCESS (read_kbd
);
1692 wait_channel
= XFASTINT (wait_proc
->infd
);
1693 XFASTINT (read_kbd
) = 0;
1696 /* If waiting for non-nil in a cell, record where. */
1697 if (XTYPE (read_kbd
) == Lisp_Cons
)
1699 wait_for_cell
= &XCONS (read_kbd
)->car
;
1700 XFASTINT (read_kbd
) = 0;
1703 waiting_for_user_input_p
= XINT (read_kbd
);
1705 /* Since we may need to wait several times,
1706 compute the absolute time to return at. */
1707 if (time_limit
|| microsecs
)
1709 EMACS_GET_TIME (end_time
);
1710 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
1711 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
1716 /* If calling from keyboard input, do not quit
1717 since we want to return C-g as an input character.
1718 Otherwise, do pending quit if requested. */
1719 if (XINT (read_kbd
) >= 0)
1722 /* Compute time from now till when time limit is up */
1723 /* Exit if already run out */
1724 if (time_limit
== -1)
1726 /* -1 specified for timeout means
1727 gobble output available now
1728 but don't wait at all. */
1730 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1732 else if (time_limit
|| microsecs
)
1734 EMACS_GET_TIME (timeout
);
1735 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
1736 if (EMACS_TIME_NEG_P (timeout
))
1741 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
1744 /* Cause C-g and alarm signals to take immediate action,
1745 and cause input available signals to zero out timeout.
1747 It is important that we do this before checking for process
1748 activity. If we get a SIGCHLD after the explicit checks for
1749 process activity, timeout is the only way we will know. */
1750 if (XINT (read_kbd
) < 0)
1751 set_waiting_for_input (&timeout
);
1753 /* If status of something has changed, and no input is
1754 available, notify the user of the change right away. After
1755 this explicit check, we'll let the SIGCHLD handler zap
1756 timeout to get our attention. */
1757 if (update_tick
!= process_tick
&& do_display
)
1759 Atemp
= input_wait_mask
;
1760 EMACS_SET_SECS_USECS (timeout
, 0, 0);
1761 if (select (MAXDESC
, &Atemp
, 0, 0, &timeout
) <= 0)
1765 /* Don't wait for output from a non-running process. */
1766 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
1767 update_status (wait_proc
);
1769 && ! EQ (wait_proc
->status
, Qrun
))
1772 /* Wait till there is something to do */
1774 Available
= input_wait_mask
;
1775 if (! XINT (read_kbd
))
1776 FD_CLR (0, &Available
);
1778 /* If frame size has changed or the window is newly mapped,
1779 redisplay now, before we start to wait. There is a race
1780 condition here; if a SIGIO arrives between now and the select
1781 and indicates that a frame is trashed, the select may block
1782 displaying a trashed screen. */
1784 redisplay_preserve_echo_area ();
1786 if (XINT (read_kbd
) && detect_input_pending ())
1789 nfds
= select (MAXDESC
, &Available
, 0, 0, &timeout
);
1793 /* Make C-g and alarm signals set flags again */
1794 clear_waiting_for_input ();
1796 /* If we woke up due to SIGWINCH, actually change size now. */
1797 do_pending_window_change ();
1799 if (time_limit
&& nfds
== 0) /* timeout elapsed */
1803 if (xerrno
== EINTR
)
1804 FD_ZERO (&Available
);
1806 /* Ultrix select seems to return ENOMEM when it is
1807 interrupted. Treat it just like EINTR. Bleah. Note
1808 that we want to test for the "ultrix" CPP symbol, not
1809 "__ultrix__"; the latter is only defined under GCC, but
1810 not by DEC's bundled CC. -JimB */
1811 else if (xerrno
== ENOMEM
)
1812 FD_ZERO (&Available
);
1815 /* This happens for no known reason on ALLIANT.
1816 I am guessing that this is the right response. -- RMS. */
1817 else if (xerrno
== EFAULT
)
1818 FD_ZERO (&Available
);
1820 else if (xerrno
== EBADF
)
1823 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
1824 the child's closure of the pts gives the parent a SIGHUP, and
1825 the ptc file descriptor is automatically closed,
1826 yielding EBADF here or at select() call above.
1827 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
1828 in m-ibmrt-aix.h), and here we just ignore the select error.
1829 Cleanup occurs c/o status_notify after SIGCLD. */
1830 FD_ZERO (&Available
); /* Cannot depend on values returned */
1836 error("select error: %s", sys_errlist
[xerrno
]);
1839 else if (nfds
> 0 && FD_ISSET (0, &Available
) && interrupt_input
)
1840 /* System sometimes fails to deliver SIGIO. */
1841 kill (getpid (), SIGIO
);
1844 /* Check for keyboard input */
1845 /* If there is any, return immediately
1846 to give it higher priority than subprocesses */
1848 if (XINT (read_kbd
) && detect_input_pending ())
1851 /* Exit now if the cell we're waiting for became non-nil. */
1852 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
1856 /* If we think we have keyboard input waiting, but didn't get SIGIO
1857 go read it. This can happen with X on BSD after logging out.
1858 In that case, there really is no input and no SIGIO,
1859 but select says there is input. */
1861 if (XINT (read_kbd
) && interrupt_input
&& (FD_ISSET (fileno (stdin
), &Available
)))
1866 got_some_input
|= nfds
> 0;
1868 /* If checking input just got us a size-change event from X,
1869 obey it now if we should. */
1870 if (XINT (read_kbd
))
1871 do_pending_window_change ();
1873 /* Check for data from a process or a command channel */
1874 for (channel
= FIRST_PROC_DESC
; channel
< MAXDESC
; channel
++)
1876 if (FD_ISSET (channel
, &Available
))
1880 /* If waiting for this channel, arrange to return as
1881 soon as no more input to be processed. No more
1883 if (wait_channel
== channel
)
1889 proc
= chan_process
[channel
];
1893 /* Read data from the process, starting with our
1894 buffered-ahead character if we have one. */
1896 nread
= read_process_output (proc
, channel
);
1899 /* Since read_process_output can run a filter,
1900 which can call accept-process-output,
1901 don't try to read from any other processes
1902 before doing the select again. */
1903 FD_ZERO (&Available
);
1906 redisplay_preserve_echo_area ();
1909 else if (nread
== -1 && errno
== EWOULDBLOCK
)
1913 else if (nread
== -1 && errno
== EAGAIN
)
1917 else if (nread
== -1 && errno
== EAGAIN
)
1919 /* Note that we cannot distinguish between no input
1920 available now and a closed pipe.
1921 With luck, a closed pipe will be accompanied by
1922 subprocess termination and SIGCHLD. */
1923 else if (nread
== 0 && !NETCONN_P (proc
))
1925 #endif /* O_NDELAY */
1926 #endif /* O_NONBLOCK */
1927 #endif /* EWOULDBLOCK */
1929 /* On some OSs with ptys, when the process on one end of
1930 a pty exits, the other end gets an error reading with
1931 errno = EIO instead of getting an EOF (0 bytes read).
1932 Therefore, if we get an error reading and errno =
1933 EIO, just continue, because the child process has
1934 exited and should clean itself up soon (e.g. when we
1936 else if (nread
== -1 && errno
== EIO
)
1938 #endif /* HAVE_PTYS */
1939 /* If we can detect process termination, don't consider the process
1940 gone just because its pipe is closed. */
1942 else if (nread
== 0 && !NETCONN_P (proc
))
1947 /* Preserve status of processes already terminated. */
1948 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
1949 deactivate_process (proc
);
1950 if (!NILP (XPROCESS (proc
)->raw_status_low
))
1951 update_status (XPROCESS (proc
));
1952 if (EQ (XPROCESS (proc
)->status
, Qrun
))
1953 XPROCESS (proc
)->status
1954 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
1957 } /* end for each file descriptor */
1958 } /* end while exit conditions not met */
1960 /* If calling from keyboard input, do not quit
1961 since we want to return C-g as an input character.
1962 Otherwise, do pending quit if requested. */
1963 if (XINT (read_kbd
) >= 0)
1965 /* Prevent input_pending from remaining set if we quit. */
1966 clear_input_pending ();
1970 return got_some_input
;
1973 /* Read pending output from the process channel,
1974 starting with our buffered-ahead character if we have one.
1975 Yield number of characters read.
1977 This function reads at most 1024 characters.
1978 If you want to read all available subprocess output,
1979 you must call it repeatedly until it returns zero. */
1981 read_process_output (proc
, channel
)
1983 register int channel
;
1985 register int nchars
;
1991 register Lisp_Object outstream
;
1992 register struct buffer
*old
= current_buffer
;
1993 register struct Lisp_Process
*p
= XPROCESS (proc
);
1994 register int opoint
;
1997 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
1999 vs
= get_vms_process_pointer (p
->pid
);
2003 return(0); /* Really weird if it does this */
2004 if (!(vs
->iosb
[0] & 1))
2005 return -1; /* I/O error */
2008 error ("Could not get VMS process pointer");
2009 chars
= vs
->inputBuffer
;
2010 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2013 start_vms_process_read (vs
); /* Crank up the next read on the process */
2014 return 1; /* Nothing worth printing, say we got 1 */
2018 if (proc_buffered_char
[channel
] < 0)
2019 nchars
= read (channel
, chars
, sizeof chars
);
2022 chars
[0] = proc_buffered_char
[channel
];
2023 proc_buffered_char
[channel
] = -1;
2024 nchars
= read (channel
, chars
+ 1, sizeof chars
- 1);
2028 nchars
= nchars
+ 1;
2030 #endif /* not VMS */
2032 if (nchars
<= 0) return nchars
;
2034 outstream
= p
->filter
;
2035 if (!NILP (outstream
))
2037 /* We inhibit quit here instead of just catching it so that
2038 hitting ^G when a filter happens to be running won't screw
2040 int count
= specpdl_ptr
- specpdl
;
2041 specbind (Qinhibit_quit
, Qt
);
2042 call2 (outstream
, proc
, make_string (chars
, nchars
));
2045 start_vms_process_read (vs
);
2051 /* If no filter, write into buffer if it isn't dead. */
2052 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2054 Lisp_Object old_read_only
;
2055 Lisp_Object old_begv
, old_zv
;
2057 Fset_buffer (p
->buffer
);
2059 old_read_only
= current_buffer
->read_only
;
2060 XFASTINT (old_begv
) = BEGV
;
2061 XFASTINT (old_zv
) = ZV
;
2063 current_buffer
->read_only
= Qnil
;
2065 /* Insert new output into buffer
2066 at the current end-of-output marker,
2067 thus preserving logical ordering of input and output. */
2068 if (XMARKER (p
->mark
)->buffer
)
2069 SET_PT (marker_position (p
->mark
));
2073 /* If the output marker is outside of the visible region, save
2074 the restriction and widen. */
2075 if (! (BEGV
<= point
&& point
<= ZV
))
2078 /* Make sure opoint floats ahead of any new text, just as point
2080 if (point
<= opoint
)
2083 /* Insert after old_begv, but before old_zv. */
2084 if (point
< XFASTINT (old_begv
))
2085 XFASTINT (old_begv
) += nchars
;
2086 if (point
<= XFASTINT (old_zv
))
2087 XFASTINT (old_zv
) += nchars
;
2089 /* Insert before markers in case we are inserting where
2090 the buffer's mark is, and the user's next command is Meta-y. */
2091 insert_before_markers (chars
, nchars
);
2092 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2094 update_mode_lines
++;
2096 /* If the restriction isn't what it should be, set it. */
2097 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2098 Fnarrow_to_region (old_begv
, old_zv
);
2100 current_buffer
->read_only
= old_read_only
;
2102 set_buffer_internal (old
);
2105 start_vms_process_read (vs
);
2110 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2112 "Returns non-NIL if emacs is waiting for input from the user.\n\
2113 This is intended for use by asynchronous process output filters and sentinels.")
2116 return ((waiting_for_user_input_p
) ? Qt
: Qnil
);
2119 /* Sending data to subprocess */
2121 jmp_buf send_process_frame
;
2124 send_process_trap ()
2130 longjmp (send_process_frame
, 1);
2133 send_process (proc
, buf
, len
)
2138 /* Don't use register vars; longjmp can lose them. */
2140 unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2144 struct Lisp_Process
*p
= XPROCESS (proc
);
2145 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2148 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2149 update_status (XPROCESS (proc
));
2150 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2151 error ("Process %s not running", procname
);
2154 vs
= get_vms_process_pointer (p
->pid
);
2156 error ("Could not find this process: %x", p
->pid
);
2157 else if (write_to_vms_process (vs
, buf
, len
))
2160 if (!setjmp (send_process_frame
))
2164 SIGTYPE (*old_sigpipe
)();
2166 /* Don't send more than 500 bytes at a time. */
2169 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
2170 rv
= write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, this);
2171 signal (SIGPIPE
, old_sigpipe
);
2176 || errno
== EWOULDBLOCK
2183 /* It would be nice to accept process output here,
2184 but that is difficult. For example, it could
2185 garbage what we are sending if that is from a buffer. */
2192 report_file_error ("writing to process", Fcons (proc
, Qnil
));
2196 /* Allow input from processes between bursts of sending.
2197 Otherwise things may get stopped up. */
2202 XFASTINT (zero
) = 0;
2203 wait_reading_process_input (-1, 0, zero
, 0);
2209 XPROCESS (proc
)->raw_status_low
= Qnil
;
2210 XPROCESS (proc
)->raw_status_high
= Qnil
;
2211 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2212 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2213 deactivate_process (proc
);
2215 error ("Error writing to process %s; closed it", procname
);
2217 error ("SIGPIPE raised on process %s; closed it", procname
);
2222 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
2224 "Send current contents of region as input to PROCESS.\n\
2225 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2226 nil, indicating the current buffer's process.\n\
2227 Called from program, takes three arguments, PROCESS, START and END.\n\
2228 If the region is more than 500 characters long,\n\
2229 it is sent in several bunches. This may happen even for shorter regions.\n\
2230 Output from processes can arrive in between bunches.")
2231 (process
, start
, end
)
2232 Lisp_Object process
, start
, end
;
2237 proc
= get_process (process
);
2238 validate_region (&start
, &end
);
2240 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
2243 start1
= XINT (start
);
2244 send_process (proc
, &FETCH_CHAR (start1
), XINT (end
) - XINT (start
));
2249 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
2251 "Send PROCESS the contents of STRING as input.\n\
2252 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2253 nil, indicating the current buffer's process.\n\
2254 If STRING is more than 500 characters long,\n\
2255 it is sent in several bunches. This may happen even for shorter strings.\n\
2256 Output from processes can arrive in between bunches.")
2258 Lisp_Object process
, string
;
2261 CHECK_STRING (string
, 1);
2262 proc
= get_process (process
);
2263 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
);
2267 /* send a signal number SIGNO to PROCESS.
2268 CURRENT_GROUP means send to the process group that currently owns
2269 the terminal being used to communicate with PROCESS.
2270 This is used for various commands in shell mode.
2271 If NOMSG is zero, insert signal-announcements into process's buffers
2274 If we can, we try to signal PROCESS by sending control characters
2275 down the pipe. This allows us to signal inferiors who have changed
2276 their uid, for which killpg would return an EPERM error. */
2279 process_send_signal (process
, signo
, current_group
, nomsg
)
2280 Lisp_Object process
;
2282 Lisp_Object current_group
;
2286 register struct Lisp_Process
*p
;
2290 proc
= get_process (process
);
2291 p
= XPROCESS (proc
);
2293 if (!EQ (p
->childp
, Qt
))
2294 error ("Process %s is not a subprocess",
2295 XSTRING (p
->name
)->data
);
2296 if (!XFASTINT (p
->infd
))
2297 error ("Process %s is not active",
2298 XSTRING (p
->name
)->data
);
2300 if (NILP (p
->pty_flag
))
2301 current_group
= Qnil
;
2303 /* If we are using pgrps, get a pgrp number and make it negative. */
2304 if (!NILP (current_group
))
2306 #ifdef SIGNALS_VIA_CHARACTERS
2307 /* If possible, send signals to the entire pgrp
2308 by sending an input character to it. */
2310 /* TERMIOS is the latest and bestest, and seems most likely to
2311 work. If the system has it, use it. */
2318 tcgetattr (XFASTINT (p
->infd
), &t
);
2319 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2323 tcgetattr (XFASTINT (p
->infd
), &t
);
2324 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2328 tcgetattr (XFASTINT (p
->infd
), &t
);
2330 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2332 send_process (proc
, &t
.c_cc
[VSUSP
], 1);
2337 #else /* ! HAVE_TERMIOS */
2339 /* On Berkeley descendants, the following IOCTL's retrieve the
2340 current control characters. */
2341 #if defined (TIOCGLTC) && defined (TIOCGETC)
2349 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2350 send_process (proc
, &c
.t_intrc
, 1);
2353 ioctl (XFASTINT (p
->infd
), TIOCGETC
, &c
);
2354 send_process (proc
, &c
.t_quitc
, 1);
2358 ioctl (XFASTINT (p
->infd
), TIOCGLTC
, &lc
);
2359 send_process (proc
, &lc
.t_suspc
, 1);
2361 #endif /* ! defined (SIGTSTP) */
2364 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2366 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
2373 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2374 send_process (proc
, &t
.c_cc
[VINTR
], 1);
2377 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2378 send_process (proc
, &t
.c_cc
[VQUIT
], 1);
2382 ioctl (XFASTINT (p
->infd
), TCGETA
, &t
);
2383 send_process (proc
, &t
.c_cc
[VSWTCH
], 1);
2385 #endif /* ! defined (SIGTSTP) */
2387 #else /* ! defined (TCGETA) */
2388 Your configuration files are messed up
.
2389 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
2390 you'd better be using one of the alternatives above! */
2391 #endif /* ! defined (TCGETA) */
2392 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
2393 #endif /* ! defined HAVE_TERMIOS */
2394 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
2397 /* Get the pgrp using the tty itself, if we have that.
2398 Otherwise, use the pty to get the pgrp.
2399 On pfa systems, saka@pfu.fujitsu.co.JP writes:
2400 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
2401 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
2402 His patch indicates that if TIOCGPGRP returns an error, then
2403 we should just assume that p->pid is also the process group id. */
2407 if (!NILP (p
->subtty
))
2408 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
2410 err
= ioctl (XFASTINT (p
->infd
), TIOCGPGRP
, &gid
);
2414 gid
= - XFASTINT (p
->pid
);
2415 #endif /* ! defined (pfa) */
2421 #else /* ! defined (TIOCGPGRP ) */
2422 /* Can't select pgrps on this system, so we know that
2423 the child itself heads the pgrp. */
2424 gid
= - XFASTINT (p
->pid
);
2425 #endif /* ! defined (TIOCGPGRP ) */
2428 gid
= - XFASTINT (p
->pid
);
2434 p
->raw_status_low
= Qnil
;
2435 p
->raw_status_high
= Qnil
;
2437 XSETINT (p
->tick
, ++process_tick
);
2441 #endif /* ! defined (SIGCONT) */
2444 send_process (proc
, "\003", 1); /* ^C */
2449 send_process (proc
, "\031", 1); /* ^Y */
2454 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
2457 flush_pending_output (XFASTINT (p
->infd
));
2461 /* If we don't have process groups, send the signal to the immediate
2462 subprocess. That isn't really right, but it's better than any
2463 obvious alternative. */
2466 kill (XFASTINT (p
->pid
), signo
);
2470 /* gid may be a pid, or minus a pgrp's number */
2472 if (!NILP (current_group
))
2473 ioctl (XFASTINT (p
->infd
), TIOCSIGSEND
, signo
);
2476 gid
= - XFASTINT (p
->pid
);
2479 #else /* ! defined (TIOCSIGSEND) */
2480 EMACS_KILLPG (-gid
, signo
);
2481 #endif /* ! defined (TIOCSIGSEND) */
2484 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
2485 "Interrupt process PROCESS. May be process or name of one.\n\
2486 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
2487 Nil or no arg means current buffer's process.\n\
2488 Second arg CURRENT-GROUP non-nil means send signal to\n\
2489 the current process-group of the process's controlling terminal\n\
2490 rather than to the process's own process group.\n\
2491 If the process is a shell, this means interrupt current subjob\n\
2492 rather than the shell.")
2493 (process
, current_group
)
2494 Lisp_Object process
, current_group
;
2496 process_send_signal (process
, SIGINT
, current_group
, 0);
2500 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
2501 "Kill process PROCESS. May be process or name of one.\n\
2502 See function `interrupt-process' for more details on usage.")
2503 (process
, current_group
)
2504 Lisp_Object process
, current_group
;
2506 process_send_signal (process
, SIGKILL
, current_group
, 0);
2510 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
2511 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
2512 See function `interrupt-process' for more details on usage.")
2513 (process
, current_group
)
2514 Lisp_Object process
, current_group
;
2516 process_send_signal (process
, SIGQUIT
, current_group
, 0);
2520 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
2521 "Stop process PROCESS. May be process or name of one.\n\
2522 See function `interrupt-process' for more details on usage.")
2523 (process
, current_group
)
2524 Lisp_Object process
, current_group
;
2527 error ("no SIGTSTP support");
2529 process_send_signal (process
, SIGTSTP
, current_group
, 0);
2534 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
2535 "Continue process PROCESS. May be process or name of one.\n\
2536 See function `interrupt-process' for more details on usage.")
2537 (process
, current_group
)
2538 Lisp_Object process
, current_group
;
2541 process_send_signal (process
, SIGCONT
, current_group
, 0);
2543 error ("no SIGCONT support");
2548 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
2549 2, 2, "nProcess number: \nnSignal code: ",
2550 "Send the process with number PID the signal with code CODE.\n\
2551 Both PID and CODE are integers.")
2553 Lisp_Object pid
, sig
;
2555 CHECK_NUMBER (pid
, 0);
2556 CHECK_NUMBER (sig
, 1);
2557 return make_number (kill (XINT (pid
), XINT (sig
)));
2560 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
2561 "Make PROCESS see end-of-file in its input.\n\
2562 Eof comes after any text already sent to it.\n\
2563 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
2564 nil, indicating the current buffer's process.")
2566 Lisp_Object process
;
2570 proc
= get_process (process
);
2571 /* Sending a zero-length record is supposed to mean eof
2572 when TIOCREMOTE is turned on. */
2576 write (XFASTINT (XPROCESS (proc
)->outfd
), buf
, 0);
2578 #else /* did not do TOICREMOTE */
2580 send_process (proc
, "\032", 1); /* ^z */
2582 if (!NILP (XPROCESS (proc
)->pty_flag
))
2583 send_process (proc
, "\004", 1);
2586 close (XPROCESS (proc
)->outfd
);
2587 XFASTINT (XPROCESS (proc
)->outfd
) = open ("/dev/null", O_WRONLY
);
2590 #endif /* did not do TOICREMOTE */
2594 /* Kill all processes associated with `buffer'.
2595 If `buffer' is nil, kill all processes */
2597 kill_buffer_processes (buffer
)
2600 Lisp_Object tail
, proc
;
2602 for (tail
= Vprocess_alist
; XGCTYPE (tail
) == Lisp_Cons
;
2603 tail
= XCONS (tail
)->cdr
)
2605 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2606 if (XGCTYPE (proc
) == Lisp_Process
2607 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
2609 if (NETCONN_P (proc
))
2610 deactivate_process (proc
);
2611 else if (XFASTINT (XPROCESS (proc
)->infd
))
2612 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
2617 /* On receipt of a signal that a child status has changed,
2618 loop asking about children with changed statuses until
2619 the system says there are no more.
2620 All we do is change the status;
2621 we do not run sentinels or print notifications.
2622 That is saved for the next time keyboard input is done,
2623 in order to avoid timing errors. */
2625 /** WARNING: this can be called during garbage collection.
2626 Therefore, it must not be fooled by the presence of mark bits in
2629 /** USG WARNING: Although it is not obvious from the documentation
2630 in signal(2), on a USG system the SIGCLD handler MUST NOT call
2631 signal() before executing at least one wait(), otherwise the handler
2632 will be called again, resulting in an infinite loop. The relevant
2633 portion of the documentation reads "SIGCLD signals will be queued
2634 and the signal-catching function will be continually reentered until
2635 the queue is empty". Invoking signal() causes the kernel to reexamine
2636 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
2639 sigchld_handler (signo
)
2642 int old_errno
= errno
;
2644 register struct Lisp_Process
*p
;
2645 extern EMACS_TIME
*input_available_clear_time
;
2649 sigheld
|= sigbit (SIGCHLD
);
2661 #endif /* no WUNTRACED */
2662 /* Keep trying to get a status until we get a definitive result. */
2666 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
2668 while (pid
<= 0 && errno
== EINTR
);
2672 /* A real failure. We have done all our job, so return. */
2674 /* USG systems forget handlers when they are used;
2675 must reestablish each time */
2677 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
2680 sigheld
&= ~sigbit (SIGCHLD
);
2688 #endif /* no WNOHANG */
2690 /* Find the process that signaled us, and record its status. */
2693 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2695 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2696 p
= XPROCESS (proc
);
2697 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
2702 /* Look for an asynchronous process whose pid hasn't been filled
2705 for (tail
= Vprocess_alist
; XSYMBOL (tail
) != XSYMBOL (Qnil
); tail
= XCONS (tail
)->cdr
)
2707 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
2708 p
= XPROCESS (proc
);
2709 if (XTYPE (p
->pid
) == Lisp_Int
&& XINT (p
->pid
) == -1)
2714 /* Change the status of the process that was found. */
2717 union { int i
; WAITTYPE wt
; } u
;
2719 XSETINT (p
->tick
, ++process_tick
);
2721 XFASTINT (p
->raw_status_low
) = u
.i
& 0xffff;
2722 XFASTINT (p
->raw_status_high
) = u
.i
>> 16;
2724 /* If process has terminated, stop waiting for its output. */
2725 if (WIFSIGNALED (w
) || WIFEXITED (w
))
2726 if (XFASTINT (p
->infd
))
2727 FD_CLR (XFASTINT (p
->infd
), &input_wait_mask
);
2729 /* Tell wait_reading_process_input that it needs to wake up and
2731 if (input_available_clear_time
)
2732 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2735 /* There was no asynchronous process found for that id. Check
2736 if we have a synchronous process. */
2739 synch_process_alive
= 0;
2741 /* Report the status of the synchronous process. */
2743 synch_process_retcode
= WRETCODE (w
);
2744 else if (WIFSIGNALED (w
))
2746 synch_process_death
= sys_siglist
[WTERMSIG (w
)];
2748 synch_process_death
= sys_errlist
[WTERMSIG (w
)];
2751 /* Tell wait_reading_process_input that it needs to wake up and
2753 if (input_available_clear_time
)
2754 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
2757 /* On some systems, we must return right away.
2758 If any more processes want to signal us, we will
2760 Otherwise (on systems that have WNOHANG), loop around
2761 to use up all the processes that have something to tell us. */
2762 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG))
2764 signal (signo
, sigchld_handler
);
2768 #endif /* USG, but not HPUX with WNOHANG */
2774 exec_sentinel_unwind (data
)
2777 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
2782 exec_sentinel (proc
, reason
)
2783 Lisp_Object proc
, reason
;
2785 Lisp_Object sentinel
;
2786 register struct Lisp_Process
*p
= XPROCESS (proc
);
2787 int count
= specpdl_ptr
- specpdl
;
2789 sentinel
= p
->sentinel
;
2790 if (NILP (sentinel
))
2793 /* Zilch the sentinel while it's running, to avoid recursive invocations;
2794 assure that it gets restored no matter how the sentinel exits. */
2796 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
2797 /* Inhibit quit so that random quits don't screw up a running filter. */
2798 specbind (Qinhibit_quit
, Qt
);
2799 call2 (sentinel
, proc
, reason
);
2803 /* Report all recent events of a change in process status
2804 (either run the sentinel or output a message).
2805 This is done while Emacs is waiting for keyboard input. */
2809 register Lisp_Object proc
, buffer
;
2810 Lisp_Object tail
= Qnil
;
2811 Lisp_Object msg
= Qnil
;
2812 struct gcpro gcpro1
, gcpro2
;
2814 /* We need to gcpro tail; if read_process_output calls a filter
2815 which deletes a process and removes the cons to which tail points
2816 from Vprocess_alist, and then causes a GC, tail is an unprotected
2820 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
2823 register struct Lisp_Process
*p
;
2825 proc
= Fcdr (Fcar (tail
));
2826 p
= XPROCESS (proc
);
2828 if (XINT (p
->tick
) != XINT (p
->update_tick
))
2830 XSETINT (p
->update_tick
, XINT (p
->tick
));
2832 /* If process is still active, read any output that remains. */
2833 if (XFASTINT (p
->infd
))
2834 while (read_process_output (proc
, XFASTINT (p
->infd
)) > 0);
2838 /* Get the text to use for the message. */
2839 if (!NILP (p
->raw_status_low
))
2841 msg
= status_message (p
->status
);
2843 /* If process is terminated, deactivate it or delete it. */
2845 if (XTYPE (p
->status
) == Lisp_Cons
)
2846 symbol
= XCONS (p
->status
)->car
;
2848 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
2849 || EQ (symbol
, Qclosed
))
2851 if (delete_exited_processes
)
2852 remove_process (proc
);
2854 deactivate_process (proc
);
2857 /* Now output the message suitably. */
2858 if (!NILP (p
->sentinel
))
2859 exec_sentinel (proc
, msg
);
2860 /* Don't bother with a message in the buffer
2861 when a process becomes runnable. */
2862 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
2864 Lisp_Object ro
= XBUFFER (buffer
)->read_only
;
2866 struct buffer
*old
= current_buffer
;
2869 /* Avoid error if buffer is deleted
2870 (probably that's why the process is dead, too) */
2871 if (NILP (XBUFFER (buffer
)->name
))
2873 Fset_buffer (buffer
);
2875 /* Insert new output into buffer
2876 at the current end-of-output marker,
2877 thus preserving logical ordering of input and output. */
2878 if (XMARKER (p
->mark
)->buffer
)
2879 SET_PT (marker_position (p
->mark
));
2882 if (point
<= opoint
)
2883 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
2885 tem
= current_buffer
->read_only
;
2886 current_buffer
->read_only
= Qnil
;
2887 insert_string ("\nProcess ");
2888 Finsert (1, &p
->name
);
2889 insert_string (" ");
2891 current_buffer
->read_only
= tem
;
2892 Fset_marker (p
->mark
, make_number (point
), p
->buffer
);
2895 set_buffer_internal (old
);
2900 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
2901 redisplay_preserve_echo_area ();
2903 update_tick
= process_tick
;
2914 if (! noninteractive
|| initialized
)
2916 signal (SIGCHLD
, sigchld_handler
);
2919 FD_ZERO (&input_wait_mask
);
2920 FD_SET (0, &input_wait_mask
);
2921 Vprocess_alist
= Qnil
;
2922 for (i
= 0; i
< MAXDESC
; i
++)
2924 chan_process
[i
] = Qnil
;
2925 proc_buffered_char
[i
] = -1;
2929 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 0, 1, 0,
2930 "Return the connection type of `PROCESS'. This can be nil (pipe),\n\
2931 t or pty (pty) or stream (socket connection).")
2933 Lisp_Object process
;
2935 return XPROCESS (process
)->type
;
2941 stream_process
= intern ("stream");
2943 Qprocessp
= intern ("processp");
2944 staticpro (&Qprocessp
);
2945 Qrun
= intern ("run");
2947 Qstop
= intern ("stop");
2949 Qsignal
= intern ("signal");
2950 staticpro (&Qsignal
);
2952 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
2955 Qexit = intern ("exit");
2956 staticpro (&Qexit); */
2958 Qopen
= intern ("open");
2960 Qclosed
= intern ("closed");
2961 staticpro (&Qclosed
);
2963 staticpro (&Vprocess_alist
);
2965 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
2966 "*Non-nil means delete processes immediately when they exit.\n\
2967 nil means don't delete them until `list-processes' is run.");
2969 delete_exited_processes
= 1;
2971 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
2972 "Control type of device used to communicate with subprocesses.\n\
2973 Values are nil to use a pipe, and t or 'pty for a pty. Note that if\n\
2974 pty's are not available, this variable will be ignored. The value takes\n\
2975 effect when `start-process' is called.");
2976 Vprocess_connection_type
= Qt
;
2978 defsubr (&Sprocessp
);
2979 defsubr (&Sget_process
);
2980 defsubr (&Sget_buffer_process
);
2981 defsubr (&Sdelete_process
);
2982 defsubr (&Sprocess_status
);
2983 defsubr (&Sprocess_exit_status
);
2984 defsubr (&Sprocess_id
);
2985 defsubr (&Sprocess_name
);
2986 defsubr (&Sprocess_command
);
2987 defsubr (&Sset_process_buffer
);
2988 defsubr (&Sprocess_buffer
);
2989 defsubr (&Sprocess_mark
);
2990 defsubr (&Sset_process_filter
);
2991 defsubr (&Sprocess_filter
);
2992 defsubr (&Sset_process_sentinel
);
2993 defsubr (&Sprocess_sentinel
);
2994 defsubr (&Sprocess_kill_without_query
);
2995 defsubr (&Slist_processes
);
2996 defsubr (&Sprocess_list
);
2997 defsubr (&Sstart_process
);
2999 defsubr (&Sopen_network_stream
);
3000 #endif /* HAVE_SOCKETS */
3001 defsubr (&Saccept_process_output
);
3002 defsubr (&Sprocess_send_region
);
3003 defsubr (&Sprocess_send_string
);
3004 defsubr (&Sinterrupt_process
);
3005 defsubr (&Skill_process
);
3006 defsubr (&Squit_process
);
3007 defsubr (&Sstop_process
);
3008 defsubr (&Scontinue_process
);
3009 defsubr (&Sprocess_send_eof
);
3010 defsubr (&Ssignal_process
);
3011 defsubr (&Swaiting_for_user_input_p
);
3012 /* defsubr (&Sprocess_connection); */
3016 #else /* not subprocesses */
3018 #include <sys/types.h>
3022 #include "systime.h"
3023 #include "termopts.h"
3025 extern int frame_garbaged
;
3028 /* As described above, except assuming that there are no subprocesses:
3030 Wait for timeout to elapse and/or keyboard input to be available.
3033 timeout in seconds, or
3034 zero for no limit, or
3035 -1 means gobble data immediately available but don't wait for any.
3037 read_kbd is a Lisp_Object:
3038 0 to ignore keyboard input, or
3039 1 to return when input is available, or
3040 -1 means caller will actually read the input, so don't throw to
3042 We know that read_kbd will never be a Lisp_Process, since
3043 `subprocesses' isn't defined.
3045 do_display != 0 means redisplay should be done to show subprocess
3046 output that arrives. This version of the function ignores it.
3048 Return true iff we recieved input from any process. */
3051 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
3052 int time_limit
, microsecs
;
3053 Lisp_Object read_kbd
;
3056 EMACS_TIME end_time
, timeout
, *timeout_p
;
3059 /* What does time_limit really mean? */
3060 if (time_limit
|| microsecs
)
3062 /* It's not infinite. */
3063 timeout_p
= &timeout
;
3065 if (time_limit
== -1)
3066 /* In fact, it's zero. */
3067 EMACS_SET_SECS_USECS (timeout
, 0, 0);
3069 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
3071 /* How far in the future is that? */
3072 EMACS_GET_TIME (end_time
);
3073 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
3076 /* It's infinite. */
3079 /* Turn off periodic alarms (in case they are in use)
3080 because the select emulator uses alarms. */
3087 waitchannels
= XINT (read_kbd
) ? 1 : 0;
3089 /* If calling from keyboard input, do not quit
3090 since we want to return C-g as an input character.
3091 Otherwise, do pending quit if requested. */
3092 if (XINT (read_kbd
) >= 0)
3097 EMACS_GET_TIME (*timeout_p
);
3098 EMACS_SUB_TIME (*timeout_p
, end_time
, *timeout_p
);
3099 if (EMACS_TIME_NEG_P (*timeout_p
))
3103 /* Cause C-g and alarm signals to take immediate action,
3104 and cause input available signals to zero out timeout. */
3105 if (XINT (read_kbd
) < 0)
3106 set_waiting_for_input (&timeout
);
3108 /* If a frame has been newly mapped and needs updating,
3109 reprocess its display stuff. */
3111 redisplay_preserve_echo_area ();
3113 if (XINT (read_kbd
) && detect_input_pending ())
3116 nfds
= select (1, &waitchannels
, 0, 0, timeout_p
);
3118 /* Make C-g and alarm signals set flags again */
3119 clear_waiting_for_input ();
3121 /* If we woke up due to SIGWINCH, actually change size now. */
3122 do_pending_window_change ();
3126 /* If the system call was interrupted, then go around the
3132 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
3133 /* System sometimes fails to deliver SIGIO. */
3134 kill (getpid (), SIGIO
);
3136 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
3139 /* If we have timed out (nfds == 0) or found some input (nfds > 0),
3151 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
3152 "Return the (or, a) process associated with BUFFER.\n\
3153 This copy of Emacs has not been built to support subprocesses, so this\n\
3154 function always returns nil.")
3156 register Lisp_Object name
;
3161 /* Kill all processes associated with `buffer'.
3162 If `buffer' is nil, kill all processes.
3163 Since we have no subprocesses, this does nothing. */
3165 kill_buffer_processes (buffer
)
3176 defsubr (&Sget_buffer_process
);
3180 #endif /* not subprocesses */