1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 1996
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
27 /* This file is split into two parts by the following preprocessor
28 conditional. The 'then' clause contains all of the support for
29 asynchronous subprocesses. The 'else' clause contains stub
30 versions of some of the asynchronous subprocess routines that are
31 often called elsewhere in Emacs, so we don't have to #ifdef the
32 sections that call them. */
40 #include <sys/types.h> /* some typedefs are used in sys/file.h */
50 #endif /* not WINDOWSNT */
52 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
53 #include <sys/socket.h>
55 #include <netinet/in.h>
56 #include <arpa/inet.h>
57 #ifdef NEED_NET_ERRNO_H
58 #include <net/errno.h>
59 #endif /* NEED_NET_ERRNO_H */
60 #endif /* HAVE_SOCKETS */
62 /* TERM is a poor-man's SLIP, used on Linux. */
67 /* On some systems, e.g. DGUX, inet_addr returns a 'struct in_addr'. */
68 #ifdef HAVE_BROKEN_INET_ADDR
69 #define IN_ADDR struct in_addr
70 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
72 #define IN_ADDR unsigned long
73 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
76 #if defined(BSD_SYSTEM) || defined(STRIDE)
77 #include <sys/ioctl.h>
78 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
80 #endif /* HAVE_PTYS and no O_NDELAY */
81 #endif /* BSD_SYSTEM || STRIDE */
83 #ifdef BROKEN_O_NONBLOCK
85 #endif /* BROKEN_O_NONBLOCK */
92 #include <sys/sysmacros.h> /* for "minor" */
104 #include "termhooks.h"
105 #include "termopts.h"
106 #include "commands.h"
108 #include "blockinput.h"
110 Lisp_Object Qprocessp
;
111 Lisp_Object Qrun
, Qstop
, Qsignal
, Qopen
, Qclosed
;
112 Lisp_Object Qlast_nonmenu_event
;
113 /* Qexit is declared and initialized in eval.c. */
115 /* a process object is a network connection when its childp field is neither
116 Qt nor Qnil but is instead a cons cell (HOSTNAME PORTNUM). */
119 #define NETCONN_P(p) (GC_CONSP (XPROCESS (p)->childp))
121 #define NETCONN_P(p) 0
122 #endif /* HAVE_SOCKETS */
124 /* Define first descriptor number available for subprocesses. */
126 #define FIRST_PROC_DESC 1
128 #define FIRST_PROC_DESC 3
131 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
134 #if !defined (SIGCHLD) && defined (SIGCLD)
135 #define SIGCHLD SIGCLD
138 #include "syssignal.h"
143 extern char *strerror ();
145 extern char *sys_errlist
[];
152 #ifndef SYS_SIGLIST_DECLARED
157 extern char *sys_siglist
[];
158 #endif /* not LINUX */
160 char *sys_siglist
[] =
166 "illegal instruction",
170 "floating point exception",
173 "segmentation violation",
174 "bad argument to system call",
175 "write on a pipe with no one to read it",
177 "software termination signal from kill",
179 "sendable stop signal not from tty",
180 "stop signal from tty",
181 "continue a stopped process",
182 "child status has changed",
183 "background read attempted from control tty",
184 "background write attempted from control tty",
185 "input record available at control tty",
186 "exceeded CPU time limit",
187 "exceeded file size limit"
189 #endif /* not WINDOWSNT */
192 #endif /* ! SYS_SIGLIST_DECLARED */
194 /* t means use pty, nil means use a pipe,
195 maybe other values to come. */
196 static Lisp_Object Vprocess_connection_type
;
200 #include <sys/socket.h>
204 /* These next two vars are non-static since sysdep.c uses them in the
205 emulation of `select'. */
206 /* Number of events of change of status of a process. */
208 /* Number of events for which the user or sentinel has been notified. */
211 #include "sysselect.h"
213 /* If we support a window system, turn on the code to poll periodically
214 to detect C-g. It isn't actually used when doing interrupt input. */
215 #ifdef HAVE_WINDOW_SYSTEM
216 #define POLL_FOR_INPUT
219 /* Mask of bits indicating the descriptors that we wait for input on. */
221 static SELECT_TYPE input_wait_mask
;
223 /* Mask that excludes keyboard input descriptor (s). */
225 static SELECT_TYPE non_keyboard_wait_mask
;
227 /* Mask that excludes process input descriptor (s). */
229 static SELECT_TYPE non_process_wait_mask
;
231 /* The largest descriptor currently in use for a process object. */
232 static int max_process_desc
;
234 /* The largest descriptor currently in use for keyboard input. */
235 static int max_keyboard_desc
;
237 /* Nonzero means delete a process right away if it exits. */
238 static int delete_exited_processes
;
240 /* Indexed by descriptor, gives the process (if any) for that descriptor */
241 Lisp_Object chan_process
[MAXDESC
];
243 /* Alist of elements (NAME . PROCESS) */
244 Lisp_Object Vprocess_alist
;
246 /* Buffered-ahead input char from process, indexed by channel.
247 -1 means empty (no char is buffered).
248 Used on sys V where the only way to tell if there is any
249 output from the process is to read at least one char.
250 Always -1 on systems that support FIONREAD. */
252 /* Don't make static; need to access externally. */
253 int proc_buffered_char
[MAXDESC
];
255 /* Table of `struct coding-system' for each process. */
256 static struct coding_system
*proc_decode_coding_system
[MAXDESC
];
257 static struct coding_system
*proc_encode_coding_system
[MAXDESC
];
259 static Lisp_Object
get_process ();
261 extern EMACS_TIME
timer_check ();
262 extern int timers_run
;
264 /* Maximum number of bytes to send to a pty without an eof. */
265 static int pty_max_bytes
;
268 /* The file name of the pty opened by allocate_pty. */
270 static char pty_name
[24];
273 /* Compute the Lisp form of the process status, p->status, from
274 the numeric status that was returned by `wait'. */
276 Lisp_Object
status_convert ();
279 struct Lisp_Process
*p
;
281 union { int i
; WAITTYPE wt
; } u
;
282 u
.i
= XFASTINT (p
->raw_status_low
) + (XFASTINT (p
->raw_status_high
) << 16);
283 p
->status
= status_convert (u
.wt
);
284 p
->raw_status_low
= Qnil
;
285 p
->raw_status_high
= Qnil
;
288 /* Convert a process status word in Unix format to
289 the list that we use internally. */
296 return Fcons (Qstop
, Fcons (make_number (WSTOPSIG (w
)), Qnil
));
297 else if (WIFEXITED (w
))
298 return Fcons (Qexit
, Fcons (make_number (WRETCODE (w
)),
299 WCOREDUMP (w
) ? Qt
: Qnil
));
300 else if (WIFSIGNALED (w
))
301 return Fcons (Qsignal
, Fcons (make_number (WTERMSIG (w
)),
302 WCOREDUMP (w
) ? Qt
: Qnil
));
307 /* Given a status-list, extract the three pieces of information
308 and store them individually through the three pointers. */
311 decode_status (l
, symbol
, code
, coredump
)
327 *symbol
= XCONS (l
)->car
;
328 tem
= XCONS (l
)->cdr
;
329 *code
= XFASTINT (XCONS (tem
)->car
);
330 tem
= XCONS (tem
)->cdr
;
331 *coredump
= !NILP (tem
);
335 /* Return a string describing a process status list. */
338 status_message (status
)
343 Lisp_Object string
, string2
;
345 decode_status (status
, &symbol
, &code
, &coredump
);
347 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qstop
))
353 /* Cast to suppress warning if the table has const char *. */
354 signame
= (char *) sys_siglist
[code
];
356 signame
= sys_errlist
[code
];
361 string
= build_string (signame
);
362 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
363 XSTRING (string
)->data
[0] = DOWNCASE (XSTRING (string
)->data
[0]);
364 return concat2 (string
, string2
);
366 else if (EQ (symbol
, Qexit
))
369 return build_string ("finished\n");
370 string
= Fnumber_to_string (make_number (code
));
371 string2
= build_string (coredump
? " (core dumped)\n" : "\n");
372 return concat2 (build_string ("exited abnormally with code "),
373 concat2 (string
, string2
));
376 return Fcopy_sequence (Fsymbol_name (symbol
));
381 /* Open an available pty, returning a file descriptor.
382 Return -1 on failure.
383 The file name of the terminal corresponding to the pty
384 is left in the variable pty_name. */
393 /* Some systems name their pseudoterminals so that there are gaps in
394 the usual sequence - for example, on HP9000/S700 systems, there
395 are no pseudoterminals with names ending in 'f'. So we wait for
396 three failures in a row before deciding that we've reached the
398 int failed_count
= 0;
403 for (c
= FIRST_PTY_LETTER
; c
<= 'z'; c
++)
404 for (i
= 0; i
< 16; i
++)
407 #ifdef PTY_NAME_SPRINTF
410 sprintf (pty_name
, "/dev/pty%c%x", c
, i
);
411 #endif /* no PTY_NAME_SPRINTF */
415 #else /* no PTY_OPEN */
417 /* Unusual IRIS code */
418 *ptyv
= open ("/dev/ptc", O_RDWR
| O_NDELAY
, 0);
421 if (fstat (fd
, &stb
) < 0)
424 if (stat (pty_name
, &stb
) < 0)
427 if (failed_count
>= 3)
433 fd
= open (pty_name
, O_RDWR
| O_NONBLOCK
, 0);
435 fd
= open (pty_name
, O_RDWR
| O_NDELAY
, 0);
437 #endif /* not IRIS */
438 #endif /* no PTY_OPEN */
442 /* check to make certain that both sides are available
443 this avoids a nasty yet stupid bug in rlogins */
444 #ifdef PTY_TTY_NAME_SPRINTF
447 sprintf (pty_name
, "/dev/tty%c%x", c
, i
);
448 #endif /* no PTY_TTY_NAME_SPRINTF */
450 if (access (pty_name
, 6) != 0)
453 #if !defined(IRIS) && !defined(__sgi)
459 #endif /* not UNIPLUS */
466 #endif /* HAVE_PTYS */
472 struct Lisp_Vector
*vec
;
473 register Lisp_Object val
, tem
, name1
;
474 register struct Lisp_Process
*p
;
478 vec
= allocate_vectorlike ((EMACS_INT
) VECSIZE (struct Lisp_Process
));
479 for (i
= 0; i
< VECSIZE (struct Lisp_Process
); i
++)
480 vec
->contents
[i
] = Qnil
;
481 vec
->size
= VECSIZE (struct Lisp_Process
);
482 p
= (struct Lisp_Process
*)vec
;
484 XSETINT (p
->infd
, -1);
485 XSETINT (p
->outfd
, -1);
486 XSETFASTINT (p
->pid
, 0);
487 XSETFASTINT (p
->tick
, 0);
488 XSETFASTINT (p
->update_tick
, 0);
489 p
->raw_status_low
= Qnil
;
490 p
->raw_status_high
= Qnil
;
492 p
->mark
= Fmake_marker ();
494 /* If name is already in use, modify it until it is unused. */
499 tem
= Fget_process (name1
);
500 if (NILP (tem
)) break;
501 sprintf (suffix
, "<%d>", i
);
502 name1
= concat2 (name
, build_string (suffix
));
506 XSETPROCESS (val
, p
);
507 Vprocess_alist
= Fcons (Fcons (name
, val
), Vprocess_alist
);
511 remove_process (proc
)
512 register Lisp_Object proc
;
514 register Lisp_Object pair
;
516 pair
= Frassq (proc
, Vprocess_alist
);
517 Vprocess_alist
= Fdelq (pair
, Vprocess_alist
);
519 deactivate_process (proc
);
522 DEFUN ("processp", Fprocessp
, Sprocessp
, 1, 1, 0,
523 "Return t if OBJECT is a process.")
527 return PROCESSP (object
) ? Qt
: Qnil
;
530 DEFUN ("get-process", Fget_process
, Sget_process
, 1, 1, 0,
531 "Return the process named NAME, or nil if there is none.")
533 register Lisp_Object name
;
537 CHECK_STRING (name
, 0);
538 return Fcdr (Fassoc (name
, Vprocess_alist
));
541 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
542 "Return the (or, a) process associated with BUFFER.\n\
543 BUFFER may be a buffer or the name of one.")
545 register Lisp_Object buffer
;
547 register Lisp_Object buf
, tail
, proc
;
549 if (NILP (buffer
)) return Qnil
;
550 buf
= Fget_buffer (buffer
);
551 if (NILP (buf
)) return Qnil
;
553 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
555 proc
= Fcdr (Fcar (tail
));
556 if (PROCESSP (proc
) && EQ (XPROCESS (proc
)->buffer
, buf
))
562 /* This is how commands for the user decode process arguments. It
563 accepts a process, a process name, a buffer, a buffer name, or nil.
564 Buffers denote the first process in the buffer, and nil denotes the
569 register Lisp_Object name
;
571 register Lisp_Object proc
, obj
;
574 obj
= Fget_process (name
);
576 obj
= Fget_buffer (name
);
578 error ("Process %s does not exist", XSTRING (name
)->data
);
580 else if (NILP (name
))
581 obj
= Fcurrent_buffer ();
585 /* Now obj should be either a buffer object or a process object.
589 proc
= Fget_buffer_process (obj
);
591 error ("Buffer %s has no process", XSTRING (XBUFFER (obj
)->name
)->data
);
595 CHECK_PROCESS (obj
, 0);
601 DEFUN ("delete-process", Fdelete_process
, Sdelete_process
, 1, 1, 0,
602 "Delete PROCESS: kill it and forget about it immediately.\n\
603 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
604 nil, indicating the current buffer's process.")
606 register Lisp_Object process
;
608 process
= get_process (process
);
609 XPROCESS (process
)->raw_status_low
= Qnil
;
610 XPROCESS (process
)->raw_status_high
= Qnil
;
611 if (NETCONN_P (process
))
613 XPROCESS (process
)->status
= Fcons (Qexit
, Fcons (make_number (0), Qnil
));
614 XSETINT (XPROCESS (process
)->tick
, ++process_tick
);
616 else if (XINT (XPROCESS (process
)->infd
) >= 0)
618 Fkill_process (process
, Qnil
);
619 /* Do this now, since remove_process will make sigchld_handler do nothing. */
620 XPROCESS (process
)->status
621 = Fcons (Qsignal
, Fcons (make_number (SIGKILL
), Qnil
));
622 XSETINT (XPROCESS (process
)->tick
, ++process_tick
);
625 remove_process (process
);
629 DEFUN ("process-status", Fprocess_status
, Sprocess_status
, 1, 1, 0,
630 "Return the status of PROCESS: a symbol, one of these:\n\
631 run -- for a process that is running.\n\
632 stop -- for a process stopped but continuable.\n\
633 exit -- for a process that has exited.\n\
634 signal -- for a process that has got a fatal signal.\n\
635 open -- for a network stream connection that is open.\n\
636 closed -- for a network stream connection that is closed.\n\
637 nil -- if arg is a process name and no such process exists.\n\
638 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
639 nil, indicating the current buffer's process.")
641 register Lisp_Object process
;
643 register struct Lisp_Process
*p
;
644 register Lisp_Object status
;
646 if (STRINGP (process
))
647 process
= Fget_process (process
);
649 process
= get_process (process
);
654 p
= XPROCESS (process
);
655 if (!NILP (p
->raw_status_low
))
659 status
= XCONS (status
)->car
;
660 if (NETCONN_P (process
))
662 if (EQ (status
, Qrun
))
664 else if (EQ (status
, Qexit
))
670 DEFUN ("process-exit-status", Fprocess_exit_status
, Sprocess_exit_status
,
672 "Return the exit status of PROCESS or the signal number that killed it.\n\
673 If PROCESS has not yet exited or died, return 0.")
675 register Lisp_Object process
;
677 CHECK_PROCESS (process
, 0);
678 if (!NILP (XPROCESS (process
)->raw_status_low
))
679 update_status (XPROCESS (process
));
680 if (CONSP (XPROCESS (process
)->status
))
681 return XCONS (XCONS (XPROCESS (process
)->status
)->cdr
)->car
;
682 return make_number (0);
685 DEFUN ("process-id", Fprocess_id
, Sprocess_id
, 1, 1, 0,
686 "Return the process id of PROCESS.\n\
687 This is the pid of the Unix process which PROCESS uses or talks to.\n\
688 For a network connection, this value is nil.")
690 register Lisp_Object process
;
692 CHECK_PROCESS (process
, 0);
693 return XPROCESS (process
)->pid
;
696 DEFUN ("process-name", Fprocess_name
, Sprocess_name
, 1, 1, 0,
697 "Return the name of PROCESS, as a string.\n\
698 This is the name of the program invoked in PROCESS,\n\
699 possibly modified to make it unique among process names.")
701 register Lisp_Object process
;
703 CHECK_PROCESS (process
, 0);
704 return XPROCESS (process
)->name
;
707 DEFUN ("process-command", Fprocess_command
, Sprocess_command
, 1, 1, 0,
708 "Return the command that was executed to start PROCESS.\n\
709 This is a list of strings, the first string being the program executed\n\
710 and the rest of the strings being the arguments given to it.\n\
711 For a non-child channel, this is nil.")
713 register Lisp_Object process
;
715 CHECK_PROCESS (process
, 0);
716 return XPROCESS (process
)->command
;
719 DEFUN ("process-tty-name", Fprocess_tty_name
, Sprocess_tty_name
, 1, 1, 0,
720 "Return the name of the terminal PROCESS uses, or nil if none.\n\
721 This is the terminal that the process itself reads and writes on,\n\
722 not the name of the pty that Emacs uses to talk with that terminal.")
724 register Lisp_Object process
;
726 CHECK_PROCESS (process
, 0);
727 return XPROCESS (process
)->tty_name
;
730 DEFUN ("set-process-buffer", Fset_process_buffer
, Sset_process_buffer
,
732 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
734 register Lisp_Object process
, buffer
;
736 CHECK_PROCESS (process
, 0);
738 CHECK_BUFFER (buffer
, 1);
739 XPROCESS (process
)->buffer
= buffer
;
743 DEFUN ("process-buffer", Fprocess_buffer
, Sprocess_buffer
,
745 "Return the buffer PROCESS is associated with.\n\
746 Output from PROCESS is inserted in this buffer\n\
747 unless PROCESS has a filter.")
749 register Lisp_Object process
;
751 CHECK_PROCESS (process
, 0);
752 return XPROCESS (process
)->buffer
;
755 DEFUN ("process-mark", Fprocess_mark
, Sprocess_mark
,
757 "Return the marker for the end of the last output from PROCESS.")
759 register Lisp_Object process
;
761 CHECK_PROCESS (process
, 0);
762 return XPROCESS (process
)->mark
;
765 DEFUN ("set-process-filter", Fset_process_filter
, Sset_process_filter
,
767 "Give PROCESS the filter function FILTER; nil means no filter.\n\
768 t means stop accepting output from the process.\n\
769 When a process has a filter, each time it does output\n\
770 the entire string of output is passed to the filter.\n\
771 The filter gets two arguments: the process and the string of output.\n\
772 If the process has a filter, its buffer is not used for output.")
774 register Lisp_Object process
, filter
;
776 CHECK_PROCESS (process
, 0);
779 FD_CLR (XINT (XPROCESS (process
)->infd
), &input_wait_mask
);
780 FD_CLR (XINT (XPROCESS (process
)->infd
), &non_keyboard_wait_mask
);
782 else if (EQ (XPROCESS (process
)->filter
, Qt
))
784 FD_SET (XINT (XPROCESS (process
)->infd
), &input_wait_mask
);
785 FD_SET (XINT (XPROCESS (process
)->infd
), &non_keyboard_wait_mask
);
787 XPROCESS (process
)->filter
= filter
;
791 DEFUN ("process-filter", Fprocess_filter
, Sprocess_filter
,
793 "Returns the filter function of PROCESS; nil if none.\n\
794 See `set-process-filter' for more info on filter functions.")
796 register Lisp_Object process
;
798 CHECK_PROCESS (process
, 0);
799 return XPROCESS (process
)->filter
;
802 DEFUN ("set-process-sentinel", Fset_process_sentinel
, Sset_process_sentinel
,
804 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
805 The sentinel is called as a function when the process changes state.\n\
806 It gets two arguments: the process, and a string describing the change.")
808 register Lisp_Object process
, sentinel
;
810 CHECK_PROCESS (process
, 0);
811 XPROCESS (process
)->sentinel
= sentinel
;
815 DEFUN ("process-sentinel", Fprocess_sentinel
, Sprocess_sentinel
,
817 "Return the sentinel of PROCESS; nil if none.\n\
818 See `set-process-sentinel' for more info on sentinels.")
820 register Lisp_Object process
;
822 CHECK_PROCESS (process
, 0);
823 return XPROCESS (process
)->sentinel
;
826 DEFUN ("set-process-window-size", Fset_process_window_size
,
827 Sset_process_window_size
, 3, 3, 0,
828 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
829 (process
, height
, width
)
830 register Lisp_Object process
, height
, width
;
832 CHECK_PROCESS (process
, 0);
833 CHECK_NATNUM (height
, 0);
834 CHECK_NATNUM (width
, 0);
835 if (set_window_size (XINT (XPROCESS (process
)->infd
),
836 XINT (height
), XINT(width
)) <= 0)
842 DEFUN ("process-kill-without-query", Fprocess_kill_without_query
,
843 Sprocess_kill_without_query
, 1, 2, 0,
844 "Say no query needed if PROCESS is running when Emacs is exited.\n\
845 Optional second argument if non-nil says to require a query.\n\
846 Value is t if a query was formerly required.")
848 register Lisp_Object process
, value
;
852 CHECK_PROCESS (process
, 0);
853 tem
= XPROCESS (process
)->kill_without_query
;
854 XPROCESS (process
)->kill_without_query
= Fnull (value
);
859 DEFUN ("process-contact", Fprocess_contact
, Sprocess_contact
,
861 "Return the contact info of PROCESS; t for a real child.\n\
862 For a net connection, the value is a cons cell of the form (HOST SERVICE).")
864 register Lisp_Object process
;
866 CHECK_PROCESS (process
, 0);
867 return XPROCESS (process
)->childp
;
870 #if 0 /* Turned off because we don't currently record this info
871 in the process. Perhaps add it. */
872 DEFUN ("process-connection", Fprocess_connection
, Sprocess_connection
, 1, 1, 0,
873 "Return the connection type of `PROCESS'.\n\
874 The value is `nil' for a pipe,\n\
875 `t' or `pty' for a pty, or `stream' for a socket connection.")
879 return XPROCESS (process
)->type
;
886 register Lisp_Object tail
, tem
;
887 Lisp_Object proc
, minspace
, tem1
;
888 register struct buffer
*old
= current_buffer
;
889 register struct Lisp_Process
*p
;
893 XSETFASTINT (minspace
, 1);
895 set_buffer_internal (XBUFFER (Vstandard_output
));
896 Fbuffer_disable_undo (Vstandard_output
);
898 current_buffer
->truncate_lines
= Qt
;
901 Proc Status Buffer Tty Command\n\
902 ---- ------ ------ --- -------\n", -1);
904 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
908 proc
= Fcdr (Fcar (tail
));
910 if (NILP (p
->childp
))
913 Finsert (1, &p
->name
);
914 Findent_to (make_number (13), minspace
);
916 if (!NILP (p
->raw_status_low
))
919 if (CONSP (p
->status
))
920 symbol
= XCONS (p
->status
)->car
;
923 if (EQ (symbol
, Qsignal
))
926 tem
= Fcar (Fcdr (p
->status
));
928 if (XINT (tem
) < NSIG
)
929 write_string (sys_errlist
[XINT (tem
)], -1);
932 Fprinc (symbol
, Qnil
);
934 else if (NETCONN_P (proc
))
936 if (EQ (symbol
, Qrun
))
937 write_string ("open", -1);
938 else if (EQ (symbol
, Qexit
))
939 write_string ("closed", -1);
941 Fprinc (symbol
, Qnil
);
944 Fprinc (symbol
, Qnil
);
946 if (EQ (symbol
, Qexit
))
949 tem
= Fcar (Fcdr (p
->status
));
952 sprintf (tembuf
, " %d", (int) XFASTINT (tem
));
953 write_string (tembuf
, -1);
957 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
))
958 remove_process (proc
);
960 Findent_to (make_number (22), minspace
);
961 if (NILP (p
->buffer
))
962 insert_string ("(none)");
963 else if (NILP (XBUFFER (p
->buffer
)->name
))
964 insert_string ("(Killed)");
966 Finsert (1, &XBUFFER (p
->buffer
)->name
);
968 Findent_to (make_number (37), minspace
);
970 if (STRINGP (p
->tty_name
))
971 Finsert (1, &p
->tty_name
);
973 insert_string ("(none)");
975 Findent_to (make_number (49), minspace
);
977 if (NETCONN_P (proc
))
979 sprintf (tembuf
, "(network stream connection to %s)\n",
980 XSTRING (XCONS (p
->childp
)->car
)->data
);
981 insert_string (tembuf
);
995 insert_string ("\n");
1001 DEFUN ("list-processes", Flist_processes
, Slist_processes
, 0, 0, "",
1002 "Display a list of all processes.\n\
1003 \(Any processes listed as Exited or Signaled are actually eliminated\n\
1004 after the listing is made.)")
1007 internal_with_output_to_temp_buffer ("*Process List*",
1008 list_processes_1
, Qnil
);
1012 DEFUN ("process-list", Fprocess_list
, Sprocess_list
, 0, 0, 0,
1013 "Return a list of all processes.")
1016 return Fmapcar (Qcdr
, Vprocess_alist
);
1019 /* Starting asynchronous inferior processes. */
1021 static Lisp_Object
start_process_unwind ();
1023 DEFUN ("start-process", Fstart_process
, Sstart_process
, 3, MANY
, 0,
1024 "Start a program in a subprocess. Return the process object for it.\n\
1025 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
1026 NAME is name for process. It is modified if necessary to make it unique.\n\
1027 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
1028 Process output goes at end of that buffer, unless you specify\n\
1029 an output stream or filter function to handle the output.\n\
1030 BUFFER may be also nil, meaning that this process is not associated\n\
1032 Third arg is program file name. It is searched for as in the shell.\n\
1033 Remaining arguments are strings to give program as arguments.")
1036 register Lisp_Object
*args
;
1038 Lisp_Object buffer
, name
, program
, proc
, current_dir
, tem
;
1040 register unsigned char *new_argv
;
1043 register unsigned char **new_argv
;
1046 int count
= specpdl_ptr
- specpdl
;
1050 buffer
= Fget_buffer_create (buffer
);
1052 /* Make sure that the child will be able to chdir to the current
1053 buffer's current directory, or its unhandled equivalent. We
1054 can't just have the child check for an error when it does the
1055 chdir, since it's in a vfork.
1057 We have to GCPRO around this because Fexpand_file_name and
1058 Funhandled_file_name_directory might call a file name handling
1059 function. The argument list is protected by the caller, so all
1060 we really have to worry about is buffer. */
1062 struct gcpro gcpro1
, gcpro2
;
1064 current_dir
= current_buffer
->directory
;
1066 GCPRO2 (buffer
, current_dir
);
1069 = expand_and_dir_to_file (Funhandled_file_name_directory (current_dir
),
1071 if (NILP (Ffile_accessible_directory_p (current_dir
)))
1072 report_file_error ("Setting current directory",
1073 Fcons (current_buffer
->directory
, Qnil
));
1079 CHECK_STRING (name
, 0);
1083 CHECK_STRING (program
, 2);
1086 /* Make a one member argv with all args concatenated
1087 together separated by a blank. */
1088 len
= XSTRING (program
)->size
+ 2;
1089 for (i
= 3; i
< nargs
; i
++)
1092 CHECK_STRING (tem
, i
);
1093 len
+= XSTRING (tem
)->size
+ 1; /* count the blank */
1095 new_argv
= (unsigned char *) alloca (len
);
1096 strcpy (new_argv
, XSTRING (program
)->data
);
1097 for (i
= 3; i
< nargs
; i
++)
1100 CHECK_STRING (tem
, i
);
1101 strcat (new_argv
, " ");
1102 strcat (new_argv
, XSTRING (tem
)->data
);
1104 /* Need to add code here to check for program existence on VMS */
1107 new_argv
= (unsigned char **) alloca ((nargs
- 1) * sizeof (char *));
1109 /* If program file name is not absolute, search our path for it */
1110 if (!IS_DIRECTORY_SEP (XSTRING (program
)->data
[0])
1111 && !(XSTRING (program
)->size
> 1
1112 && IS_DEVICE_SEP (XSTRING (program
)->data
[1])))
1114 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1117 GCPRO4 (name
, program
, buffer
, current_dir
);
1118 openp (Vexec_path
, program
, EXEC_SUFFIXES
, &tem
, 1);
1121 report_file_error ("Searching for program", Fcons (program
, Qnil
));
1122 tem
= Fexpand_file_name (tem
, Qnil
);
1123 new_argv
[0] = XSTRING (tem
)->data
;
1127 if (!NILP (Ffile_directory_p (program
)))
1128 error ("Specified program for new process is a directory");
1130 new_argv
[0] = XSTRING (program
)->data
;
1133 for (i
= 3; i
< nargs
; i
++)
1136 CHECK_STRING (tem
, i
);
1137 new_argv
[i
- 2] = XSTRING (tem
)->data
;
1139 new_argv
[i
- 2] = 0;
1140 #endif /* not VMS */
1142 proc
= make_process (name
);
1143 /* If an error occurs and we can't start the process, we want to
1144 remove it from the process list. This means that each error
1145 check in create_process doesn't need to call remove_process
1146 itself; it's all taken care of here. */
1147 record_unwind_protect (start_process_unwind
, proc
);
1149 XPROCESS (proc
)->childp
= Qt
;
1150 XPROCESS (proc
)->command_channel_p
= Qnil
;
1151 XPROCESS (proc
)->buffer
= buffer
;
1152 XPROCESS (proc
)->sentinel
= Qnil
;
1153 XPROCESS (proc
)->filter
= Qnil
;
1154 XPROCESS (proc
)->command
= Flist (nargs
- 2, args
+ 2);
1156 /* Make the process marker point into the process buffer (if any). */
1158 Fset_marker (XPROCESS (proc
)->mark
,
1159 make_number (BUF_ZV (XBUFFER (buffer
))), buffer
);
1161 if (!NILP (buffer
) && NILP (XBUFFER (buffer
)->enable_multibyte_characters
)
1162 || NILP (buffer
) && NILP (buffer_defaults
.enable_multibyte_characters
))
1164 XPROCESS (proc
)->decode_coding_system
= Qnil
;
1165 XPROCESS (proc
)->encode_coding_system
= Qnil
;
1169 /* Setup coding systems for communicating with the process. */
1170 /* Qt denotes that we have not yet called Ffind_coding_system. */
1171 Lisp_Object coding_systems
= Qt
;
1172 Lisp_Object val
, *args2
;
1173 struct gcpro gcpro1
;
1175 if (NILP (val
= Vcoding_system_for_read
))
1177 args2
= (Lisp_Object
*) alloca ((nargs
+ 1) * sizeof *args2
);
1178 args2
[0] = Qstart_process
;
1179 for (i
= 0; i
< nargs
; i
++) args2
[i
+ 1] = args
[i
];
1181 coding_systems
= Ffind_coding_system (nargs
+ 1, args2
);
1183 if (CONSP (coding_systems
))
1184 val
= XCONS (coding_systems
)->car
;
1186 XPROCESS (proc
)->decode_coding_system
= val
;
1188 if (NILP (val
= Vcoding_system_for_write
))
1190 if (EQ (coding_systems
, Qt
))
1192 args2
= (Lisp_Object
*) alloca ((nargs
+ 1) * sizeof args2
);
1193 args2
[0] = Qstart_process
;
1194 for (i
= 0; i
< nargs
; i
++) args2
[i
+ 1] = args
[i
];
1196 coding_systems
= Ffind_coding_system (nargs
+ 1, args2
);
1199 if (CONSP (coding_systems
))
1200 val
= XCONS (coding_systems
)->cdr
;
1202 XPROCESS (proc
)->encode_coding_system
= val
;
1205 XPROCESS (proc
)->decoding_buf
= make_uninit_string (0);
1206 XPROCESS (proc
)->encoding_buf
= make_uninit_string (0);
1208 create_process (proc
, new_argv
, current_dir
);
1210 return unbind_to (count
, proc
);
1213 /* This function is the unwind_protect form for Fstart_process. If
1214 PROC doesn't have its pid set, then we know someone has signaled
1215 an error and the process wasn't started successfully, so we should
1216 remove it from the process list. */
1218 start_process_unwind (proc
)
1221 if (!PROCESSP (proc
))
1224 /* Was PROC started successfully? */
1225 if (XINT (XPROCESS (proc
)->pid
) <= 0)
1226 remove_process (proc
);
1233 create_process_1 (signo
)
1236 #if defined (USG) && !defined (POSIX_SIGNALS)
1237 /* USG systems forget handlers when they are used;
1238 must reestablish each time */
1239 signal (signo
, create_process_1
);
1243 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1246 /* Mimic blocking of signals on system V, which doesn't really have it. */
1248 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1249 int sigchld_deferred
;
1252 create_process_sigchld ()
1254 signal (SIGCHLD
, create_process_sigchld
);
1256 sigchld_deferred
= 1;
1262 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1263 create_process (process
, new_argv
, current_dir
)
1264 Lisp_Object process
;
1266 Lisp_Object current_dir
;
1268 int pid
, inchannel
, outchannel
;
1270 #ifdef POSIX_SIGNALS
1273 struct sigaction sigint_action
;
1274 struct sigaction sigquit_action
;
1276 struct sigaction sighup_action
;
1278 #else /* !POSIX_SIGNALS */
1280 SIGTYPE (*sigchld
)();
1282 #endif /* !POSIX_SIGNALS */
1283 /* Use volatile to protect variables from being clobbered by longjmp. */
1284 volatile int forkin
, forkout
;
1285 volatile int pty_flag
= 0;
1286 extern char **environ
;
1288 inchannel
= outchannel
= -1;
1291 if (!NILP (Vprocess_connection_type
))
1292 outchannel
= inchannel
= allocate_pty ();
1297 /* On USG systems it does not work to open the pty's tty here
1298 and then close and reopen it in the child. */
1300 /* Don't let this terminal become our controlling terminal
1301 (in case we don't have one). */
1302 forkout
= forkin
= open (pty_name
, O_RDWR
| O_NOCTTY
, 0);
1304 forkout
= forkin
= open (pty_name
, O_RDWR
, 0);
1307 report_file_error ("Opening pty", Qnil
);
1309 forkin
= forkout
= -1;
1310 #endif /* not USG */
1314 #endif /* HAVE_PTYS */
1317 if (socketpair (AF_UNIX
, SOCK_STREAM
, 0, sv
) < 0)
1318 report_file_error ("Opening socketpair", Qnil
);
1319 outchannel
= inchannel
= sv
[0];
1320 forkout
= forkin
= sv
[1];
1322 #else /* not SKTPAIR */
1331 #endif /* not SKTPAIR */
1334 /* Replaced by close_process_descs */
1335 set_exclusive_use (inchannel
);
1336 set_exclusive_use (outchannel
);
1339 /* Stride people say it's a mystery why this is needed
1340 as well as the O_NDELAY, but that it fails without this. */
1341 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1344 ioctl (inchannel
, FIONBIO
, &one
);
1349 fcntl (inchannel
, F_SETFL
, O_NONBLOCK
);
1350 fcntl (outchannel
, F_SETFL
, O_NONBLOCK
);
1353 fcntl (inchannel
, F_SETFL
, O_NDELAY
);
1354 fcntl (outchannel
, F_SETFL
, O_NDELAY
);
1358 /* Record this as an active process, with its channels.
1359 As a result, child_setup will close Emacs's side of the pipes. */
1360 chan_process
[inchannel
] = process
;
1361 XSETINT (XPROCESS (process
)->infd
, inchannel
);
1362 XSETINT (XPROCESS (process
)->outfd
, outchannel
);
1363 /* Record the tty descriptor used in the subprocess. */
1365 XPROCESS (process
)->subtty
= Qnil
;
1367 XSETFASTINT (XPROCESS (process
)->subtty
, forkin
);
1368 XPROCESS (process
)->pty_flag
= (pty_flag
? Qt
: Qnil
);
1369 XPROCESS (process
)->status
= Qrun
;
1370 if (!proc_decode_coding_system
[inchannel
])
1371 proc_decode_coding_system
[inchannel
]
1372 = (struct coding_system
*) xmalloc (sizeof (struct coding_system
));
1373 setup_coding_system (XPROCESS (process
)->decode_coding_system
,
1374 proc_decode_coding_system
[inchannel
]);
1375 if (!proc_encode_coding_system
[outchannel
])
1376 proc_encode_coding_system
[outchannel
]
1377 = (struct coding_system
*) xmalloc (sizeof (struct coding_system
));
1378 setup_coding_system (XPROCESS (process
)->encode_coding_system
,
1379 proc_encode_coding_system
[outchannel
]);
1381 /* Delay interrupts until we have a chance to store
1382 the new fork's pid in its process structure */
1383 #ifdef POSIX_SIGNALS
1384 sigemptyset (&blocked
);
1386 sigaddset (&blocked
, SIGCHLD
);
1389 /* On many hosts (e.g. Solaris 2.4), if a vforked child calls `signal',
1390 this sets the parent's signal handlers as well as the child's.
1391 So delay all interrupts whose handlers the child might munge,
1392 and record the current handlers so they can be restored later. */
1393 sigaddset (&blocked
, SIGINT
); sigaction (SIGINT
, 0, &sigint_action
);
1394 sigaddset (&blocked
, SIGQUIT
); sigaction (SIGQUIT
, 0, &sigquit_action
);
1396 sigaddset (&blocked
, SIGHUP
); sigaction (SIGHUP
, 0, &sighup_action
);
1398 #endif /* HAVE_VFORK */
1399 sigprocmask (SIG_BLOCK
, &blocked
, &procmask
);
1400 #else /* !POSIX_SIGNALS */
1404 #else /* not BSD4_1 */
1405 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1406 sigsetmask (sigmask (SIGCHLD
));
1407 #else /* ordinary USG */
1409 sigchld_deferred
= 0;
1410 sigchld
= signal (SIGCHLD
, create_process_sigchld
);
1412 #endif /* ordinary USG */
1413 #endif /* not BSD4_1 */
1414 #endif /* SIGCHLD */
1415 #endif /* !POSIX_SIGNALS */
1417 FD_SET (inchannel
, &input_wait_mask
);
1418 FD_SET (inchannel
, &non_keyboard_wait_mask
);
1419 if (inchannel
> max_process_desc
)
1420 max_process_desc
= inchannel
;
1422 /* Until we store the proper pid, enable sigchld_handler
1423 to recognize an unknown pid as standing for this process.
1424 It is very important not to let this `marker' value stay
1425 in the table after this function has returned; if it does
1426 it might cause call-process to hang and subsequent asynchronous
1427 processes to get their return values scrambled. */
1428 XSETINT (XPROCESS (process
)->pid
, -1);
1433 /* child_setup must clobber environ on systems with true vfork.
1434 Protect it from permanent change. */
1435 char **save_environ
= environ
;
1440 #endif /* not WINDOWSNT */
1442 int xforkin
= forkin
;
1443 int xforkout
= forkout
;
1445 #if 0 /* This was probably a mistake--it duplicates code later on,
1446 but fails to handle all the cases. */
1447 /* Make sure SIGCHLD is not blocked in the child. */
1448 sigsetmask (SIGEMPTYMASK
);
1451 /* Make the pty be the controlling terminal of the process. */
1453 /* First, disconnect its current controlling terminal. */
1455 /* We tried doing setsid only if pty_flag, but it caused
1456 process_set_signal to fail on SGI when using a pipe. */
1458 /* Make the pty's terminal the controlling terminal. */
1462 /* We ignore the return value
1463 because faith@cs.unc.edu says that is necessary on Linux. */
1464 ioctl (xforkin
, TIOCSCTTY
, 0);
1467 #else /* not HAVE_SETSID */
1469 /* It's very important to call setpgrp here and no time
1470 afterwards. Otherwise, we lose our controlling tty which
1471 is set when we open the pty. */
1474 #endif /* not HAVE_SETSID */
1475 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1476 if (pty_flag
&& xforkin
>= 0)
1479 tcgetattr (xforkin
, &t
);
1481 if (tcsetattr (xforkin
, TCSANOW
, &t
) < 0)
1482 write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1485 #if defined (NTTYDISC) && defined (TIOCSETD)
1486 if (pty_flag
&& xforkin
>= 0)
1488 /* Use new line discipline. */
1489 int ldisc
= NTTYDISC
;
1490 ioctl (xforkin
, TIOCSETD
, &ldisc
);
1495 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1496 can do TIOCSPGRP only to the process's controlling tty. */
1499 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1500 I can't test it since I don't have 4.3. */
1501 int j
= open ("/dev/tty", O_RDWR
, 0);
1502 ioctl (j
, TIOCNOTTY
, 0);
1505 /* In order to get a controlling terminal on some versions
1506 of BSD, it is necessary to put the process in pgrp 0
1507 before it opens the terminal. */
1515 #endif /* TIOCNOTTY */
1517 #if !defined (RTU) && !defined (UNIPLUS) && !defined (DONT_REOPEN_PTY)
1518 /*** There is a suggestion that this ought to be a
1519 conditional on TIOCSPGRP,
1520 or !(defined (HAVE_SETSID) && defined (TIOCSCTTY)).
1521 Trying the latter gave the wrong results on Debian GNU/Linux 1.1;
1522 that system does seem to need this code, even though
1523 both HAVE_SETSID and TIOCSCTTY are defined. */
1524 /* Now close the pty (if we had it open) and reopen it.
1525 This makes the pty the controlling terminal of the subprocess. */
1528 #ifdef SET_CHILD_PTY_PGRP
1529 int pgrp
= getpid ();
1532 /* I wonder if close (open (pty_name, ...)) would work? */
1535 xforkout
= xforkin
= open (pty_name
, O_RDWR
, 0);
1539 write (1, "Couldn't open the pty terminal ", 31);
1540 write (1, pty_name
, strlen (pty_name
));
1545 #ifdef SET_CHILD_PTY_PGRP
1546 ioctl (xforkin
, TIOCSPGRP
, &pgrp
);
1547 ioctl (xforkout
, TIOCSPGRP
, &pgrp
);
1550 #endif /* not UNIPLUS and not RTU and not DONT_REOPEN_PTY */
1552 #ifdef SETUP_SLAVE_PTY
1557 #endif /* SETUP_SLAVE_PTY */
1559 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1560 Now reenable it in the child, so it will die when we want it to. */
1562 signal (SIGHUP
, SIG_DFL
);
1564 #endif /* HAVE_PTYS */
1566 signal (SIGINT
, SIG_DFL
);
1567 signal (SIGQUIT
, SIG_DFL
);
1569 /* Stop blocking signals in the child. */
1570 #ifdef POSIX_SIGNALS
1571 sigprocmask (SIG_SETMASK
, &procmask
, 0);
1572 #else /* !POSIX_SIGNALS */
1576 #else /* not BSD4_1 */
1577 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1578 sigsetmask (SIGEMPTYMASK
);
1579 #else /* ordinary USG */
1581 signal (SIGCHLD
, sigchld
);
1583 #endif /* ordinary USG */
1584 #endif /* not BSD4_1 */
1585 #endif /* SIGCHLD */
1586 #endif /* !POSIX_SIGNALS */
1589 child_setup_tty (xforkout
);
1591 pid
= child_setup (xforkin
, xforkout
, xforkout
,
1592 new_argv
, 1, current_dir
);
1593 #else /* not WINDOWSNT */
1594 child_setup (xforkin
, xforkout
, xforkout
,
1595 new_argv
, 1, current_dir
);
1596 #endif /* not WINDOWSNT */
1598 environ
= save_environ
;
1603 /* This runs in the Emacs process. */
1608 if (forkin
!= forkout
&& forkout
>= 0)
1613 /* vfork succeeded. */
1614 XSETFASTINT (XPROCESS (process
)->pid
, pid
);
1617 register_child (pid
, inchannel
);
1618 #endif /* WINDOWSNT */
1620 /* If the subfork execv fails, and it exits,
1621 this close hangs. I don't know why.
1622 So have an interrupt jar it loose. */
1624 signal (SIGALRM
, create_process_1
);
1626 XPROCESS (process
)->subtty
= Qnil
;
1631 if (forkin
!= forkout
&& forkout
>= 0)
1636 XPROCESS (process
)->tty_name
= build_string (pty_name
);
1639 XPROCESS (process
)->tty_name
= Qnil
;
1642 /* Restore the signal state whether vfork succeeded or not.
1643 (We will signal an error, below, if it failed.) */
1644 #ifdef POSIX_SIGNALS
1646 /* Restore the parent's signal handlers. */
1647 sigaction (SIGINT
, &sigint_action
, 0);
1648 sigaction (SIGQUIT
, &sigquit_action
, 0);
1650 sigaction (SIGHUP
, &sighup_action
, 0);
1652 #endif /* HAVE_VFORK */
1653 /* Stop blocking signals in the parent. */
1654 sigprocmask (SIG_SETMASK
, &procmask
, 0);
1655 #else /* !POSIX_SIGNALS */
1659 #else /* not BSD4_1 */
1660 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1661 sigsetmask (SIGEMPTYMASK
);
1662 #else /* ordinary USG */
1664 signal (SIGCHLD
, sigchld
);
1665 /* Now really handle any of these signals
1666 that came in during this function. */
1667 if (sigchld_deferred
)
1668 kill (getpid (), SIGCHLD
);
1670 #endif /* ordinary USG */
1671 #endif /* not BSD4_1 */
1672 #endif /* SIGCHLD */
1673 #endif /* !POSIX_SIGNALS */
1675 /* Now generate the error if vfork failed. */
1677 report_file_error ("Doing vfork", Qnil
);
1679 #endif /* not VMS */
1683 /* open a TCP network connection to a given HOST/SERVICE. Treated
1684 exactly like a normal process when reading and writing. Only
1685 differences are in status display and process deletion. A network
1686 connection has no PID; you cannot signal it. All you can do is
1687 deactivate and close it via delete-process */
1689 DEFUN ("open-network-stream", Fopen_network_stream
, Sopen_network_stream
,
1691 "Open a TCP connection for a service to a host.\n\
1692 Returns a subprocess-object to represent the connection.\n\
1693 Input and output work as for subprocesses; `delete-process' closes it.\n\
1694 Args are NAME BUFFER HOST SERVICE.\n\
1695 NAME is name for process. It is modified if necessary to make it unique.\n\
1696 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1697 Process output goes at end of that buffer, unless you specify\n\
1698 an output stream or filter function to handle the output.\n\
1699 BUFFER may be also nil, meaning that this process is not associated\n\
1701 Third arg is name of the host to connect to, or its IP address.\n\
1702 Fourth arg SERVICE is name of the service desired, or an integer\n\
1703 specifying a port number to connect to.")
1704 (name
, buffer
, host
, service
)
1705 Lisp_Object name
, buffer
, host
, service
;
1709 struct sockaddr_in address
;
1710 struct servent
*svc_info
;
1711 struct hostent
*host_info_ptr
, host_info
;
1712 char *(addr_list
[2]);
1713 IN_ADDR numeric_addr
;
1717 struct hostent host_info_fixed
;
1718 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1720 int count
= specpdl_ptr
- specpdl
;
1723 /* Ensure socket support is loaded if available. */
1724 init_winsock (TRUE
);
1727 GCPRO4 (name
, buffer
, host
, service
);
1728 CHECK_STRING (name
, 0);
1729 CHECK_STRING (host
, 0);
1730 if (INTEGERP (service
))
1731 port
= htons ((unsigned short) XINT (service
));
1734 CHECK_STRING (service
, 0);
1735 svc_info
= getservbyname (XSTRING (service
)->data
, "tcp");
1737 error ("Unknown service \"%s\"", XSTRING (service
)->data
);
1738 port
= svc_info
->s_port
;
1741 /* Slow down polling to every ten seconds.
1742 Some kernels have a bug which causes retrying connect to fail
1743 after a connect. Polling can interfere with gethostbyname too. */
1744 #ifdef POLL_FOR_INPUT
1745 bind_polling_period (10);
1756 host_info_ptr
= gethostbyname (XSTRING (host
)->data
);
1759 if (! (host_info_ptr
== 0 && h_errno
== TRY_AGAIN
))
1762 Fsleep_for (make_number (1), Qnil
);
1764 if (host_info_ptr
== 0)
1765 /* Attempt to interpret host as numeric inet address */
1767 numeric_addr
= inet_addr ((char *) XSTRING (host
)->data
);
1768 if (NUMERIC_ADDR_ERROR
)
1769 error ("Unknown host \"%s\"", XSTRING (host
)->data
);
1771 host_info_ptr
= &host_info
;
1772 host_info
.h_name
= 0;
1773 host_info
.h_aliases
= 0;
1774 host_info
.h_addrtype
= AF_INET
;
1776 /* Older machines have only one address slot called h_addr.
1777 Newer machines have h_addr_list, but #define h_addr to
1778 be its first element. */
1779 host_info
.h_addr_list
= &(addr_list
[0]);
1781 host_info
.h_addr
= (char*)(&numeric_addr
);
1783 /* numeric_addr isn't null-terminated; it has fixed length. */
1784 host_info
.h_length
= sizeof (numeric_addr
);
1787 bzero (&address
, sizeof address
);
1788 bcopy (host_info_ptr
->h_addr
, (char *) &address
.sin_addr
,
1789 host_info_ptr
->h_length
);
1790 address
.sin_family
= host_info_ptr
->h_addrtype
;
1791 address
.sin_port
= port
;
1793 s
= socket (host_info_ptr
->h_addrtype
, SOCK_STREAM
, 0);
1795 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1797 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1798 when connect is interrupted. So let's not let it get interrupted.
1799 Note we do not turn off polling, because polling is only used
1800 when not interrupt_input, and thus not normally used on the systems
1801 which have this bug. On systems which use polling, there's no way
1802 to quit if polling is turned off. */
1803 if (interrupt_input
)
1811 if (connect (s
, (struct sockaddr
*) &address
, sizeof address
) == -1
1812 && errno
!= EISCONN
)
1820 if (errno
== EADDRINUSE
&& retry
< 20)
1822 /* A delay here is needed on some FreeBSD systems,
1823 and it is harmless, since this retrying takes time anyway
1824 and should be infrequent. */
1825 Fsleep_for (make_number (1), Qnil
);
1832 if (interrupt_input
)
1836 report_file_error ("connection failed",
1837 Fcons (host
, Fcons (name
, Qnil
)));
1842 #ifdef POLL_FOR_INPUT
1843 unbind_to (count
, Qnil
);
1846 if (interrupt_input
)
1850 s
= connect_server (0);
1852 report_file_error ("error creating socket", Fcons (name
, Qnil
));
1853 send_command (s
, C_PORT
, 0, "%s:%d", XSTRING (host
)->data
, ntohs (port
));
1854 send_command (s
, C_DUMB
, 1, 0);
1861 buffer
= Fget_buffer_create (buffer
);
1862 proc
= make_process (name
);
1864 chan_process
[inch
] = proc
;
1867 fcntl (inch
, F_SETFL
, O_NONBLOCK
);
1870 fcntl (inch
, F_SETFL
, O_NDELAY
);
1874 XPROCESS (proc
)->childp
= Fcons (host
, Fcons (service
, Qnil
));
1875 XPROCESS (proc
)->command_channel_p
= Qnil
;
1876 XPROCESS (proc
)->buffer
= buffer
;
1877 XPROCESS (proc
)->sentinel
= Qnil
;
1878 XPROCESS (proc
)->filter
= Qnil
;
1879 XPROCESS (proc
)->command
= Qnil
;
1880 XPROCESS (proc
)->pid
= Qnil
;
1881 XSETINT (XPROCESS (proc
)->infd
, inch
);
1882 XSETINT (XPROCESS (proc
)->outfd
, outch
);
1883 XPROCESS (proc
)->status
= Qrun
;
1884 FD_SET (inch
, &input_wait_mask
);
1885 FD_SET (inch
, &non_keyboard_wait_mask
);
1886 if (inch
> max_process_desc
)
1887 max_process_desc
= inch
;
1889 if (!NILP (buffer
) && NILP (XBUFFER (buffer
)->enable_multibyte_characters
)
1890 || NILP (buffer
) && NILP (buffer_defaults
.enable_multibyte_characters
))
1892 XPROCESS (proc
)->decode_coding_system
= Qnil
;
1893 XPROCESS (proc
)->encode_coding_system
= Qnil
;
1897 /* Setup coding systems for communicating with the network stream. */
1898 struct gcpro gcpro1
;
1899 /* Qt denotes that we have not yet called Ffind_coding_system. */
1900 Lisp_Object coding_systems
= Qt
;
1901 Lisp_Object args
[5], val
;
1903 if (NILP (val
= Vcoding_system_for_read
))
1905 args
[0] = Qopen_network_stream
, args
[1] = name
,
1906 args
[2] = buffer
, args
[3] = host
, args
[4] = service
;
1908 coding_systems
= Ffind_coding_system (5, args
);
1910 val
= (CONSP (coding_systems
) ? XCONS (coding_systems
)->car
: Qnil
);
1912 XPROCESS (proc
)->decode_coding_system
= val
;
1914 if (NILP (val
= Vcoding_system_for_write
))
1916 if (EQ (coding_systems
, Qt
))
1918 args
[0] = Qopen_network_stream
, args
[1] = name
,
1919 args
[2] = buffer
, args
[3] = host
, args
[4] = service
;
1921 coding_systems
= Ffind_coding_system (5, args
);
1924 val
= (CONSP (coding_systems
) ? XCONS (coding_systems
)->cdr
: Qnil
);
1926 XPROCESS (proc
)->encode_coding_system
= val
;
1929 if (!proc_decode_coding_system
[inch
])
1930 proc_decode_coding_system
[inch
]
1931 = (struct coding_system
*) xmalloc (sizeof (struct coding_system
));
1932 setup_coding_system (XPROCESS (proc
)->decode_coding_system
,
1933 proc_decode_coding_system
[inch
]);
1934 if (!proc_encode_coding_system
[outch
])
1935 proc_encode_coding_system
[outch
]
1936 = (struct coding_system
*) xmalloc (sizeof (struct coding_system
));
1937 setup_coding_system (XPROCESS (proc
)->encode_coding_system
,
1938 proc_encode_coding_system
[outch
]);
1940 XPROCESS (proc
)->decoding_buf
= make_uninit_string (0);
1941 XPROCESS (proc
)->encoding_buf
= make_uninit_string (0);
1946 #endif /* HAVE_SOCKETS */
1948 deactivate_process (proc
)
1951 register int inchannel
, outchannel
;
1952 register struct Lisp_Process
*p
= XPROCESS (proc
);
1954 inchannel
= XINT (p
->infd
);
1955 outchannel
= XINT (p
->outfd
);
1959 /* Beware SIGCHLD hereabouts. */
1960 flush_pending_output (inchannel
);
1963 VMS_PROC_STUFF
*get_vms_process_pointer (), *vs
;
1964 sys$
dassgn (outchannel
);
1965 vs
= get_vms_process_pointer (p
->pid
);
1967 give_back_vms_process_stuff (vs
);
1971 if (outchannel
>= 0 && outchannel
!= inchannel
)
1975 XSETINT (p
->infd
, -1);
1976 XSETINT (p
->outfd
, -1);
1977 chan_process
[inchannel
] = Qnil
;
1978 FD_CLR (inchannel
, &input_wait_mask
);
1979 FD_CLR (inchannel
, &non_keyboard_wait_mask
);
1980 if (inchannel
== max_process_desc
)
1983 /* We just closed the highest-numbered process input descriptor,
1984 so recompute the highest-numbered one now. */
1985 max_process_desc
= 0;
1986 for (i
= 0; i
< MAXDESC
; i
++)
1987 if (!NILP (chan_process
[i
]))
1988 max_process_desc
= i
;
1993 /* Close all descriptors currently in use for communication
1994 with subprocess. This is used in a newly-forked subprocess
1995 to get rid of irrelevant descriptors. */
1997 close_process_descs ()
2001 for (i
= 0; i
< MAXDESC
; i
++)
2003 Lisp_Object process
;
2004 process
= chan_process
[i
];
2005 if (!NILP (process
))
2007 int in
= XINT (XPROCESS (process
)->infd
);
2008 int out
= XINT (XPROCESS (process
)->outfd
);
2011 if (out
>= 0 && in
!= out
)
2018 DEFUN ("accept-process-output", Faccept_process_output
, Saccept_process_output
,
2020 "Allow any pending output from subprocesses to be read by Emacs.\n\
2021 It is read into the process' buffers or given to their filter functions.\n\
2022 Non-nil arg PROCESS means do not return until some output has been received\n\
2024 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
2025 seconds and microseconds to wait; return after that much time whether\n\
2026 or not there is input.\n\
2027 Return non-nil iff we received any output before the timeout expired.")
2028 (process
, timeout
, timeout_msecs
)
2029 register Lisp_Object process
, timeout
, timeout_msecs
;
2034 if (! NILP (timeout_msecs
))
2036 CHECK_NUMBER (timeout_msecs
, 2);
2037 useconds
= XINT (timeout_msecs
);
2038 if (!INTEGERP (timeout
))
2039 XSETINT (timeout
, 0);
2042 int carry
= useconds
/ 1000000;
2044 XSETINT (timeout
, XINT (timeout
) + carry
);
2045 useconds
-= carry
* 1000000;
2047 /* I think this clause is necessary because C doesn't
2048 guarantee a particular rounding direction for negative
2052 XSETINT (timeout
, XINT (timeout
) - 1);
2053 useconds
+= 1000000;
2060 if (! NILP (timeout
))
2062 CHECK_NUMBER (timeout
, 1);
2063 seconds
= XINT (timeout
);
2064 if (seconds
< 0 || (seconds
== 0 && useconds
== 0))
2076 XSETFASTINT (process
, 0);
2079 (wait_reading_process_input (seconds
, useconds
, process
, 0)
2083 /* This variable is different from waiting_for_input in keyboard.c.
2084 It is used to communicate to a lisp process-filter/sentinel (via the
2085 function Fwaiting_for_user_input_p below) whether emacs was waiting
2086 for user-input when that process-filter was called.
2087 waiting_for_input cannot be used as that is by definition 0 when
2088 lisp code is being evalled.
2089 This is also used in record_asynch_buffer_change.
2090 For that purpose, this must be 0
2091 when not inside wait_reading_process_input. */
2092 static int waiting_for_user_input_p
;
2094 /* This is here so breakpoints can be put on it. */
2096 wait_reading_process_input_1 ()
2100 /* Read and dispose of subprocess output while waiting for timeout to
2101 elapse and/or keyboard input to be available.
2104 timeout in seconds, or
2105 zero for no limit, or
2106 -1 means gobble data immediately available but don't wait for any.
2109 an additional duration to wait, measured in microseconds.
2110 If this is nonzero and time_limit is 0, then the timeout
2111 consists of MICROSECS only.
2113 READ_KBD is a lisp value:
2114 0 to ignore keyboard input, or
2115 1 to return when input is available, or
2116 -1 meaning caller will actually read the input, so don't throw to
2117 the quit handler, or
2118 a cons cell, meaning wait until its car is non-nil
2119 (and gobble terminal input into the buffer if any arrives), or
2120 a process object, meaning wait until something arrives from that
2121 process. The return value is true iff we read some input from
2124 DO_DISPLAY != 0 means redisplay should be done to show subprocess
2125 output that arrives.
2127 If READ_KBD is a pointer to a struct Lisp_Process, then the
2128 function returns true iff we received input from that process
2129 before the timeout elapsed.
2130 Otherwise, return true iff we received input from any process. */
2132 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
2133 int time_limit
, microsecs
;
2134 Lisp_Object read_kbd
;
2137 register int channel
, nfds
, m
;
2138 static SELECT_TYPE Available
;
2141 EMACS_TIME timeout
, end_time
, garbage
;
2143 int wait_channel
= -1;
2144 struct Lisp_Process
*wait_proc
= 0;
2145 int got_some_input
= 0;
2146 Lisp_Object
*wait_for_cell
= 0;
2148 FD_ZERO (&Available
);
2150 /* If read_kbd is a process to watch, set wait_proc and wait_channel
2152 if (PROCESSP (read_kbd
))
2154 wait_proc
= XPROCESS (read_kbd
);
2155 wait_channel
= XINT (wait_proc
->infd
);
2156 XSETFASTINT (read_kbd
, 0);
2159 /* If waiting for non-nil in a cell, record where. */
2160 if (CONSP (read_kbd
))
2162 wait_for_cell
= &XCONS (read_kbd
)->car
;
2163 XSETFASTINT (read_kbd
, 0);
2166 waiting_for_user_input_p
= XINT (read_kbd
);
2168 /* Since we may need to wait several times,
2169 compute the absolute time to return at. */
2170 if (time_limit
|| microsecs
)
2172 EMACS_GET_TIME (end_time
);
2173 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
2174 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
2177 /* AlainF 5-Jul-1996
2178 HP-UX 10.10 seem to have problems with signals coming in
2179 Causes "poll: interrupted system call" messages when Emacs is run
2181 Turn off periodic alarms (in case they are in use) */
2187 int timeout_reduced_for_timers
= 0;
2189 /* If calling from keyboard input, do not quit
2190 since we want to return C-g as an input character.
2191 Otherwise, do pending quit if requested. */
2192 if (XINT (read_kbd
) >= 0)
2195 /* Exit now if the cell we're waiting for became non-nil. */
2196 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
2199 /* Compute time from now till when time limit is up */
2200 /* Exit if already run out */
2201 if (time_limit
== -1)
2203 /* -1 specified for timeout means
2204 gobble output available now
2205 but don't wait at all. */
2207 EMACS_SET_SECS_USECS (timeout
, 0, 0);
2209 else if (time_limit
|| microsecs
)
2211 EMACS_GET_TIME (timeout
);
2212 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
2213 if (EMACS_TIME_NEG_P (timeout
))
2218 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
2221 /* Normally we run timers here.
2222 But not if wait_for_cell; in those cases,
2223 the wait is supposed to be short,
2224 and those callers cannot handle running arbitrary Lisp code here. */
2225 if (! wait_for_cell
)
2227 EMACS_TIME timer_delay
;
2231 old_timers_run
= timers_run
;
2232 timer_delay
= timer_check (1);
2233 if (timers_run
!= old_timers_run
&& do_display
)
2235 redisplay_preserve_echo_area ();
2236 /* We must retry, since a timer may have requeued itself
2237 and that could alter the time_delay. */
2241 if (! EMACS_TIME_NEG_P (timer_delay
) && time_limit
!= -1)
2243 EMACS_TIME difference
;
2244 EMACS_SUB_TIME (difference
, timer_delay
, timeout
);
2245 if (EMACS_TIME_NEG_P (difference
))
2247 timeout
= timer_delay
;
2248 timeout_reduced_for_timers
= 1;
2251 /* If time_limit is -1, we are not going to wait at all. */
2252 else if (time_limit
!= -1)
2254 /* This is so a breakpoint can be put here. */
2255 wait_reading_process_input_1 ();
2259 /* Cause C-g and alarm signals to take immediate action,
2260 and cause input available signals to zero out timeout.
2262 It is important that we do this before checking for process
2263 activity. If we get a SIGCHLD after the explicit checks for
2264 process activity, timeout is the only way we will know. */
2265 if (XINT (read_kbd
) < 0)
2266 set_waiting_for_input (&timeout
);
2268 /* If status of something has changed, and no input is
2269 available, notify the user of the change right away. After
2270 this explicit check, we'll let the SIGCHLD handler zap
2271 timeout to get our attention. */
2272 if (update_tick
!= process_tick
&& do_display
)
2274 Atemp
= input_wait_mask
;
2275 EMACS_SET_SECS_USECS (timeout
, 0, 0);
2276 if ((select (MAXDESC
, &Atemp
, (SELECT_TYPE
*)0, (SELECT_TYPE
*)0,
2280 /* It's okay for us to do this and then continue with
2281 the loop, since timeout has already been zeroed out. */
2282 clear_waiting_for_input ();
2287 /* Don't wait for output from a non-running process. */
2288 if (wait_proc
!= 0 && !NILP (wait_proc
->raw_status_low
))
2289 update_status (wait_proc
);
2291 && ! EQ (wait_proc
->status
, Qrun
))
2293 clear_waiting_for_input ();
2297 /* Wait till there is something to do */
2300 Available
= non_process_wait_mask
;
2301 else if (! XINT (read_kbd
))
2302 Available
= non_keyboard_wait_mask
;
2304 Available
= input_wait_mask
;
2306 /* If frame size has changed or the window is newly mapped,
2307 redisplay now, before we start to wait. There is a race
2308 condition here; if a SIGIO arrives between now and the select
2309 and indicates that a frame is trashed, the select may block
2310 displaying a trashed screen. */
2311 if (frame_garbaged
&& do_display
)
2313 clear_waiting_for_input ();
2314 redisplay_preserve_echo_area ();
2315 if (XINT (read_kbd
) < 0)
2316 set_waiting_for_input (&timeout
);
2319 if (XINT (read_kbd
) && detect_input_pending ())
2322 FD_ZERO (&Available
);
2325 nfds
= select (MAXDESC
, &Available
, (SELECT_TYPE
*)0, (SELECT_TYPE
*)0,
2330 /* Make C-g and alarm signals set flags again */
2331 clear_waiting_for_input ();
2333 /* If we woke up due to SIGWINCH, actually change size now. */
2334 do_pending_window_change ();
2336 if (time_limit
&& nfds
== 0 && ! timeout_reduced_for_timers
)
2337 /* We wanted the full specified time, so return now. */
2341 if (xerrno
== EINTR
)
2342 FD_ZERO (&Available
);
2344 /* Ultrix select seems to return ENOMEM when it is
2345 interrupted. Treat it just like EINTR. Bleah. Note
2346 that we want to test for the "ultrix" CPP symbol, not
2347 "__ultrix__"; the latter is only defined under GCC, but
2348 not by DEC's bundled CC. -JimB */
2349 else if (xerrno
== ENOMEM
)
2350 FD_ZERO (&Available
);
2353 /* This happens for no known reason on ALLIANT.
2354 I am guessing that this is the right response. -- RMS. */
2355 else if (xerrno
== EFAULT
)
2356 FD_ZERO (&Available
);
2358 else if (xerrno
== EBADF
)
2361 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
2362 the child's closure of the pts gives the parent a SIGHUP, and
2363 the ptc file descriptor is automatically closed,
2364 yielding EBADF here or at select() call above.
2365 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
2366 in m/ibmrt-aix.h), and here we just ignore the select error.
2367 Cleanup occurs c/o status_notify after SIGCLD. */
2368 FD_ZERO (&Available
); /* Cannot depend on values returned */
2374 error ("select error: %s", strerror (xerrno
));
2376 #if defined(sun) && !defined(USG5_4)
2377 else if (nfds
> 0 && keyboard_bit_set (&Available
)
2379 /* System sometimes fails to deliver SIGIO.
2381 David J. Mackenzie says that Emacs doesn't compile under
2382 Solaris if this code is enabled, thus the USG5_4 in the CPP
2383 conditional. "I haven't noticed any ill effects so far.
2384 If you find a Solaris expert somewhere, they might know
2386 kill (getpid (), SIGIO
);
2389 /* Check for keyboard input */
2390 /* If there is any, return immediately
2391 to give it higher priority than subprocesses */
2393 if ((XINT (read_kbd
) != 0)
2394 && detect_input_pending_run_timers (do_display
))
2396 swallow_events (do_display
);
2397 if (detect_input_pending_run_timers (do_display
))
2401 /* If wait_for_cell. check for keyboard input
2402 but don't run any timers.
2403 ??? (It seems wrong to me to check for keyboard
2404 input at all when wait_for_cell, but the code
2405 has been this way since July 1994.
2406 Try changing this after version 19.31.) */
2408 && detect_input_pending ())
2410 swallow_events (do_display
);
2411 if (detect_input_pending ())
2415 /* Exit now if the cell we're waiting for became non-nil. */
2416 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
2420 /* If we think we have keyboard input waiting, but didn't get SIGIO
2421 go read it. This can happen with X on BSD after logging out.
2422 In that case, there really is no input and no SIGIO,
2423 but select says there is input. */
2425 if (XINT (read_kbd
) && interrupt_input
2426 && (keyboard_bit_set (&Available
)))
2427 kill (getpid (), SIGIO
);
2431 got_some_input
|= nfds
> 0;
2433 /* If checking input just got us a size-change event from X,
2434 obey it now if we should. */
2435 if (XINT (read_kbd
) || wait_for_cell
)
2436 do_pending_window_change ();
2438 /* Check for data from a process. */
2439 /* Really FIRST_PROC_DESC should be 0 on Unix,
2440 but this is safer in the short run. */
2441 for (channel
= 0; channel
<= max_process_desc
; channel
++)
2443 if (FD_ISSET (channel
, &Available
)
2444 && FD_ISSET (channel
, &non_keyboard_wait_mask
))
2448 /* If waiting for this channel, arrange to return as
2449 soon as no more input to be processed. No more
2451 if (wait_channel
== channel
)
2457 proc
= chan_process
[channel
];
2461 /* Read data from the process, starting with our
2462 buffered-ahead character if we have one. */
2464 nread
= read_process_output (proc
, channel
);
2467 /* Since read_process_output can run a filter,
2468 which can call accept-process-output,
2469 don't try to read from any other processes
2470 before doing the select again. */
2471 FD_ZERO (&Available
);
2474 redisplay_preserve_echo_area ();
2477 else if (nread
== -1 && errno
== EWOULDBLOCK
)
2480 /* ISC 4.1 defines both EWOULDBLOCK and O_NONBLOCK,
2481 and Emacs uses O_NONBLOCK, so what we get is EAGAIN. */
2483 else if (nread
== -1 && errno
== EAGAIN
)
2487 else if (nread
== -1 && errno
== EAGAIN
)
2489 /* Note that we cannot distinguish between no input
2490 available now and a closed pipe.
2491 With luck, a closed pipe will be accompanied by
2492 subprocess termination and SIGCHLD. */
2493 else if (nread
== 0 && !NETCONN_P (proc
))
2495 #endif /* O_NDELAY */
2496 #endif /* O_NONBLOCK */
2498 /* On some OSs with ptys, when the process on one end of
2499 a pty exits, the other end gets an error reading with
2500 errno = EIO instead of getting an EOF (0 bytes read).
2501 Therefore, if we get an error reading and errno =
2502 EIO, just continue, because the child process has
2503 exited and should clean itself up soon (e.g. when we
2505 else if (nread
== -1 && errno
== EIO
)
2507 #endif /* HAVE_PTYS */
2508 /* If we can detect process termination, don't consider the process
2509 gone just because its pipe is closed. */
2511 else if (nread
== 0 && !NETCONN_P (proc
))
2516 /* Preserve status of processes already terminated. */
2517 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
2518 deactivate_process (proc
);
2519 if (!NILP (XPROCESS (proc
)->raw_status_low
))
2520 update_status (XPROCESS (proc
));
2521 if (EQ (XPROCESS (proc
)->status
, Qrun
))
2522 XPROCESS (proc
)->status
2523 = Fcons (Qexit
, Fcons (make_number (256), Qnil
));
2526 } /* end for each file descriptor */
2527 } /* end while exit conditions not met */
2529 waiting_for_user_input_p
= 0;
2531 /* If calling from keyboard input, do not quit
2532 since we want to return C-g as an input character.
2533 Otherwise, do pending quit if requested. */
2534 if (XINT (read_kbd
) >= 0)
2536 /* Prevent input_pending from remaining set if we quit. */
2537 clear_input_pending ();
2541 /* AlainF 5-Jul-1996
2542 HP-UX 10.10 seems to have problems with signals coming in
2543 Causes "poll: interrupted system call" messages when Emacs is run
2545 Turn periodic alarms back on */
2549 return got_some_input
;
2552 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
2555 read_process_output_call (fun_and_args
)
2556 Lisp_Object fun_and_args
;
2558 return apply1 (XCONS (fun_and_args
)->car
, XCONS (fun_and_args
)->cdr
);
2562 read_process_output_error_handler (error
)
2565 cmd_error_internal (error
, "error in process filter: ");
2567 update_echo_area ();
2568 Fsleep_for (make_number (2), Qnil
);
2572 #define READ_CHILD_OUTPUT read_child_output
2574 #define READ_CHILD_OUTPUT read
2577 /* Read pending output from the process channel,
2578 starting with our buffered-ahead character if we have one.
2579 Yield number of decoded characters read.
2581 This function reads at most 1024 characters.
2582 If you want to read all available subprocess output,
2583 you must call it repeatedly until it returns zero.
2585 The characters read are decoded according to PROC's coding-system
2588 read_process_output (proc
, channel
)
2590 register int channel
;
2592 register int nchars
;
2595 int chars_allocated
= 0; /* If 1, `chars' should be freed later. */
2599 register Lisp_Object outstream
;
2600 register struct buffer
*old
= current_buffer
;
2601 register struct Lisp_Process
*p
= XPROCESS (proc
);
2602 register int opoint
;
2603 struct coding_system
*coding
= proc_decode_coding_system
[channel
];
2604 int chars_in_decoding_buf
= 0; /* If 1, `chars' points
2605 XSTRING (p->decoding_buf)->data. */
2608 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2610 vs
= get_vms_process_pointer (p
->pid
);
2614 return(0); /* Really weird if it does this */
2615 if (!(vs
->iosb
[0] & 1))
2616 return -1; /* I/O error */
2619 error ("Could not get VMS process pointer");
2620 chars
= vs
->inputBuffer
;
2621 nchars
= clean_vms_buffer (chars
, vs
->iosb
[1]);
2624 start_vms_process_read (vs
); /* Crank up the next read on the process */
2625 return 1; /* Nothing worth printing, say we got 1 */
2627 if (coding
->carryover_size
)
2629 /* The data carried over in the previous decoding should be
2630 prepended to the new data read to decode all together. */
2631 char *buf
= (char *) xmalloc (nchars
+ coding
->carryover_size
);
2633 bcopy (coding
->carryover
, buf
, coding
->carryover_size
);
2634 bcopy (chars
, buf
+ coding
->carryover_size
, nchars
);
2636 chars_allocated
= 1;
2640 if (coding
->carryover_size
)
2641 /* The data carried over in the previous decoding should be
2642 prepended to the new data read to decode all together. */
2643 bcopy (coding
->carryover
, buf
, coding
->carryover_size
);
2645 if (proc_buffered_char
[channel
] < 0)
2646 nchars
= READ_CHILD_OUTPUT (channel
, buf
+ coding
->carryover_size
,
2647 (sizeof buf
) - coding
->carryover_size
);
2650 buf
[coding
->carryover_size
] = proc_buffered_char
[channel
];
2651 proc_buffered_char
[channel
] = -1;
2652 nchars
= READ_CHILD_OUTPUT (channel
, buf
+ coding
->carryover_size
+ 1,
2653 (sizeof buf
) - coding
->carryover_size
- 1);
2657 nchars
= nchars
+ 1;
2660 #endif /* not VMS */
2662 /* At this point, NCHARS holds number of characters just received
2663 (including the one in proc_buffered_char[channel]). */
2664 if (nchars
<= 0) return nchars
;
2666 /* Now set NCHARS how many bytes we must decode. */
2667 nchars
+= coding
->carryover_size
;
2669 if (CODING_REQUIRE_CONVERSION (coding
))
2671 int require
= decoding_buffer_size (coding
, nchars
);
2672 int consumed
, produced
;
2674 if (XSTRING (p
->decoding_buf
)->size
< require
)
2675 p
->decoding_buf
= make_uninit_string (require
);
2676 produced
= decode_coding (coding
, chars
, XSTRING (p
->decoding_buf
)->data
,
2677 nchars
, XSTRING (p
->decoding_buf
)->size
,
2680 /* New coding-system might be found by `decode_coding'. */
2681 if (!EQ (p
->decode_coding_system
, coding
->symbol
))
2683 p
->decode_coding_system
= coding
->symbol
;
2684 setup_coding_system (coding
->symbol
,
2685 proc_decode_coding_system
[channel
]);
2686 /* If coding-system for encoding is not yet decided, we set it
2687 as the same as coding-system for decoding. */
2688 if (NILP (p
->encode_coding_system
))
2690 p
->encode_coding_system
= coding
->symbol
;
2691 setup_coding_system (coding
->symbol
,
2692 proc_encode_coding_system
[channel
]);
2696 /* Now we don't need the contents of `chars'. */
2697 if (chars_allocated
)
2702 chars
= XSTRING (p
->decoding_buf
)->data
;
2704 chars_in_decoding_buf
= 1;
2707 else if (chars_allocated
)
2709 /* Although we don't have to decode the received data, we must
2710 move it to an area which we don't have to free. */
2711 if (! STRINGP (p
->decoding_buf
)
2712 || XSTRING (p
->decoding_buf
)->size
< nchars
)
2713 p
->decoding_buf
= make_uninit_string (nchars
);
2714 bcopy (chars
, XSTRING (p
->decoding_buf
)->data
, nchars
);
2716 chars
= XSTRING (p
->decoding_buf
)->data
;
2717 chars_in_decoding_buf
= 1;
2721 outstream
= p
->filter
;
2722 if (!NILP (outstream
))
2724 /* We inhibit quit here instead of just catching it so that
2725 hitting ^G when a filter happens to be running won't screw
2727 int count
= specpdl_ptr
- specpdl
;
2728 Lisp_Object odeactivate
;
2729 Lisp_Object obuffer
, okeymap
;
2730 int outer_running_asynch_code
= running_asynch_code
;
2732 /* No need to gcpro these, because all we do with them later
2733 is test them for EQness, and none of them should be a string. */
2734 odeactivate
= Vdeactivate_mark
;
2735 XSETBUFFER (obuffer
, current_buffer
);
2736 okeymap
= current_buffer
->keymap
;
2738 specbind (Qinhibit_quit
, Qt
);
2739 specbind (Qlast_nonmenu_event
, Qt
);
2741 /* In case we get recursively called,
2742 and we already saved the match data nonrecursively,
2743 save the same match data in safely recursive fashion. */
2744 if (outer_running_asynch_code
)
2747 /* Don't clobber the CURRENT match data, either! */
2748 tem
= Fmatch_data (Qnil
, Qnil
);
2749 restore_match_data ();
2750 record_unwind_protect (Fstore_match_data
, Fmatch_data (Qnil
, Qnil
));
2751 Fstore_match_data (tem
);
2754 /* For speed, if a search happens within this code,
2755 save the match data in a special nonrecursive fashion. */
2756 running_asynch_code
= 1;
2758 /* Read and dispose of the process output. */
2759 internal_condition_case_1 (read_process_output_call
,
2762 Fcons (make_string (chars
,
2765 !NILP (Vdebug_on_error
) ? Qnil
: Qerror
,
2766 read_process_output_error_handler
);
2768 /* If we saved the match data nonrecursively, restore it now. */
2769 restore_match_data ();
2770 running_asynch_code
= outer_running_asynch_code
;
2772 /* Handling the process output should not deactivate the mark. */
2773 Vdeactivate_mark
= odeactivate
;
2775 #if 0 /* Call record_asynch_buffer_change unconditionally,
2776 because we might have changed minor modes or other things
2777 that affect key bindings. */
2778 if (! EQ (Fcurrent_buffer (), obuffer
)
2779 || ! EQ (current_buffer
->keymap
, okeymap
))
2781 /* But do it only if the caller is actually going to read events.
2782 Otherwise there's no need to make him wake up, and it could
2783 cause trouble (for example it would make Fsit_for return). */
2784 if (waiting_for_user_input_p
== -1)
2785 record_asynch_buffer_change ();
2788 start_vms_process_read (vs
);
2790 unbind_to (count
, Qnil
);
2794 /* If no filter, write into buffer if it isn't dead. */
2795 if (!NILP (p
->buffer
) && !NILP (XBUFFER (p
->buffer
)->name
))
2797 Lisp_Object old_read_only
;
2798 Lisp_Object old_begv
, old_zv
;
2799 Lisp_Object odeactivate
;
2801 odeactivate
= Vdeactivate_mark
;
2803 Fset_buffer (p
->buffer
);
2805 old_read_only
= current_buffer
->read_only
;
2806 XSETFASTINT (old_begv
, BEGV
);
2807 XSETFASTINT (old_zv
, ZV
);
2809 current_buffer
->read_only
= Qnil
;
2811 /* Insert new output into buffer
2812 at the current end-of-output marker,
2813 thus preserving logical ordering of input and output. */
2814 if (XMARKER (p
->mark
)->buffer
)
2815 SET_PT (clip_to_bounds (BEGV
, marker_position (p
->mark
), ZV
));
2819 /* If the output marker is outside of the visible region, save
2820 the restriction and widen. */
2821 if (! (BEGV
<= PT
&& PT
<= ZV
))
2824 /* Make sure opoint floats ahead of any new text, just as point
2829 /* Insert after old_begv, but before old_zv. */
2830 if (PT
< XFASTINT (old_begv
))
2831 XSETFASTINT (old_begv
, XFASTINT (old_begv
) + nchars
);
2832 if (PT
<= XFASTINT (old_zv
))
2833 XSETFASTINT (old_zv
, XFASTINT (old_zv
) + nchars
);
2835 /* Insert before markers in case we are inserting where
2836 the buffer's mark is, and the user's next command is Meta-y. */
2837 if (chars_in_decoding_buf
)
2838 insert_from_string_before_markers (p
->decoding_buf
, 0, nchars
, 0);
2840 insert_before_markers (chars
, nchars
);
2841 Fset_marker (p
->mark
, make_number (PT
), p
->buffer
);
2843 update_mode_lines
++;
2845 /* If the restriction isn't what it should be, set it. */
2846 if (XFASTINT (old_begv
) != BEGV
|| XFASTINT (old_zv
) != ZV
)
2847 Fnarrow_to_region (old_begv
, old_zv
);
2849 /* Handling the process output should not deactivate the mark. */
2850 Vdeactivate_mark
= odeactivate
;
2852 current_buffer
->read_only
= old_read_only
;
2854 set_buffer_internal (old
);
2857 start_vms_process_read (vs
);
2862 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p
, Swaiting_for_user_input_p
,
2864 "Returns non-nil if emacs is waiting for input from the user.\n\
2865 This is intended for use by asynchronous process output filters and sentinels.")
2868 return (waiting_for_user_input_p
? Qt
: Qnil
);
2871 /* Sending data to subprocess */
2873 jmp_buf send_process_frame
;
2876 send_process_trap ()
2882 longjmp (send_process_frame
, 1);
2885 /* Send some data to process PROC.
2886 BUF is the beginning of the data; LEN is the number of characters.
2887 OBJECT is the Lisp object that the data comes from.
2889 The data is encoded by PROC's coding-system for encoding before it
2890 is sent. But if the data ends at the middle of multi-byte
2891 representation, that incomplete sequence of bytes are sent without
2892 being encoded. Should we store them in a buffer to prepend them to
2893 the data send later? */
2895 send_process (proc
, buf
, len
, object
)
2896 volatile Lisp_Object proc
;
2901 /* Use volatile to protect variables from being clobbered by longjmp. */
2903 volatile unsigned char *procname
= XSTRING (XPROCESS (proc
)->name
)->data
;
2904 struct coding_system
*coding
;
2905 struct gcpro gcpro1
;
2910 struct Lisp_Process
*p
= XPROCESS (proc
);
2911 VMS_PROC_STUFF
*vs
, *get_vms_process_pointer();
2914 if (! NILP (XPROCESS (proc
)->raw_status_low
))
2915 update_status (XPROCESS (proc
));
2916 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
2917 error ("Process %s not running", procname
);
2918 if (XINT (XPROCESS (proc
)->outfd
) < 0)
2919 error ("Output file descriptor of %s is closed", procname
);
2921 coding
= proc_encode_coding_system
[XINT (XPROCESS (proc
)->outfd
)];
2922 if (CODING_REQUIRE_CONVERSION (coding
))
2924 int require
= encoding_buffer_size (coding
, len
);
2926 char *temp_buf
= NULL
;
2928 /* Remember the offset of data because a string or a buffer may
2929 be relocated. Setting OFFSET to -1 means we don't have to
2931 offset
= (BUFFERP (object
)
2932 ? BUF_PTR_CHAR_POS (XBUFFER (object
), (unsigned char *) buf
)
2934 ? offset
= buf
- (char *) XSTRING (object
)->data
2937 if (coding
->carryover_size
> 0)
2939 temp_buf
= (char *) xmalloc (len
+ coding
->carryover_size
);
2943 if (BUFFERP (object
))
2944 buf
= (char *) BUF_CHAR_ADDRESS (XBUFFER (object
), offset
);
2945 else if (STRINGP (object
))
2946 buf
= offset
+ (char *) XSTRING (object
)->data
;
2947 /* Now we don't have to care relocation. */
2950 bcopy (coding
->carryover
, temp_buf
, coding
->carryover_size
);
2951 bcopy (buf
, temp_buf
+ coding
->carryover_size
, len
);
2955 if (XSTRING (XPROCESS (proc
)->encoding_buf
)->size
< require
)
2957 XPROCESS (proc
)->encoding_buf
= make_uninit_string (require
);
2961 if (BUFFERP (object
))
2962 buf
= (char *) BUF_CHAR_ADDRESS (XBUFFER (object
), offset
);
2963 else if (STRINGP (object
))
2964 buf
= offset
+ (char *) XSTRING (object
)->data
;
2967 object
= XPROCESS (proc
)->encoding_buf
;
2968 len
= encode_coding (coding
, buf
, XSTRING (object
)->data
,
2969 len
, XSTRING (object
)->size
, &dummy
);
2970 buf
= XSTRING (object
)->data
;
2976 vs
= get_vms_process_pointer (p
->pid
);
2978 error ("Could not find this process: %x", p
->pid
);
2979 else if (write_to_vms_process (vs
, buf
, len
))
2983 if (pty_max_bytes
== 0)
2985 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2986 pty_max_bytes
= fpathconf (XFASTINT (XPROCESS (proc
)->outfd
),
2988 if (pty_max_bytes
< 0)
2989 pty_max_bytes
= 250;
2991 pty_max_bytes
= 250;
2993 /* Deduct one, to leave space for the eof. */
2997 if (!setjmp (send_process_frame
))
3001 SIGTYPE (*old_sigpipe
)();
3004 /* Decide how much data we can send in one batch.
3005 Long lines need to be split into multiple batches. */
3006 if (!NILP (XPROCESS (proc
)->pty_flag
))
3008 /* Starting this at zero is always correct when not the first iteration
3009 because the previous iteration ended by sending C-d.
3010 It may not be correct for the first iteration
3011 if a partial line was sent in a separate send_process call.
3012 If that proves worth handling, we need to save linepos
3013 in the process object. */
3016 char *end
= buf
+ len
;
3018 /* Scan through this text for a line that is too long. */
3019 while (ptr
!= end
&& linepos
< pty_max_bytes
)
3027 /* If we found one, break the line there
3028 and put in a C-d to force the buffer through. */
3032 /* Send this batch, using one or more write calls. */
3035 old_sigpipe
= (SIGTYPE (*) ()) signal (SIGPIPE
, send_process_trap
);
3036 rv
= write (XINT (XPROCESS (proc
)->outfd
), buf
, this);
3037 signal (SIGPIPE
, old_sigpipe
);
3043 || errno
== EWOULDBLOCK
3049 /* Buffer is full. Wait, accepting input;
3050 that may allow the program
3051 to finish doing output and read more. */
3056 /* Running filters might relocate buffers or strings.
3057 Arrange to relocate BUF. */
3058 if (BUFFERP (object
))
3059 offset
= BUF_PTR_CHAR_POS (XBUFFER (object
),
3060 (unsigned char *) buf
);
3061 else if (STRINGP (object
))
3062 offset
= buf
- (char *) XSTRING (object
)->data
;
3064 XSETFASTINT (zero
, 0);
3065 #ifdef EMACS_HAS_USECS
3066 wait_reading_process_input (0, 20000, zero
, 0);
3068 wait_reading_process_input (1, 0, zero
, 0);
3071 if (BUFFERP (object
))
3072 buf
= (char *) BUF_CHAR_ADDRESS (XBUFFER (object
), offset
);
3073 else if (STRINGP (object
))
3074 buf
= offset
+ (char *) XSTRING (object
)->data
;
3079 /* This is a real error. */
3080 report_file_error ("writing to process", Fcons (proc
, Qnil
));
3087 /* If we sent just part of the string, put in an EOF
3088 to force it through, before we send the rest. */
3090 Fprocess_send_eof (proc
);
3095 XPROCESS (proc
)->raw_status_low
= Qnil
;
3096 XPROCESS (proc
)->raw_status_high
= Qnil
;
3097 XPROCESS (proc
)->status
= Fcons (Qexit
, Fcons (make_number (256), Qnil
));
3098 XSETINT (XPROCESS (proc
)->tick
, ++process_tick
);
3099 deactivate_process (proc
);
3101 error ("Error writing to process %s; closed it", procname
);
3103 error ("SIGPIPE raised on process %s; closed it", procname
);
3110 DEFUN ("process-send-region", Fprocess_send_region
, Sprocess_send_region
,
3112 "Send current contents of region as input to PROCESS.\n\
3113 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3114 nil, indicating the current buffer's process.\n\
3115 Called from program, takes three arguments, PROCESS, START and END.\n\
3116 If the region is more than 500 characters long,\n\
3117 it is sent in several bunches. This may happen even for shorter regions.\n\
3118 Output from processes can arrive in between bunches.")
3119 (process
, start
, end
)
3120 Lisp_Object process
, start
, end
;
3125 proc
= get_process (process
);
3126 validate_region (&start
, &end
);
3128 if (XINT (start
) < GPT
&& XINT (end
) > GPT
)
3131 start1
= XINT (start
);
3132 send_process (proc
, POS_ADDR (start1
), XINT (end
) - XINT (start
),
3133 Fcurrent_buffer ());
3138 DEFUN ("process-send-string", Fprocess_send_string
, Sprocess_send_string
,
3140 "Send PROCESS the contents of STRING as input.\n\
3141 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3142 nil, indicating the current buffer's process.\n\
3143 If STRING is more than 500 characters long,\n\
3144 it is sent in several bunches. This may happen even for shorter strings.\n\
3145 Output from processes can arrive in between bunches.")
3147 Lisp_Object process
, string
;
3150 CHECK_STRING (string
, 1);
3151 proc
= get_process (process
);
3152 send_process (proc
, XSTRING (string
)->data
, XSTRING (string
)->size
, string
);
3156 /* send a signal number SIGNO to PROCESS.
3157 CURRENT_GROUP means send to the process group that currently owns
3158 the terminal being used to communicate with PROCESS.
3159 This is used for various commands in shell mode.
3160 If NOMSG is zero, insert signal-announcements into process's buffers
3163 If we can, we try to signal PROCESS by sending control characters
3164 down the pty. This allows us to signal inferiors who have changed
3165 their uid, for which killpg would return an EPERM error. */
3168 process_send_signal (process
, signo
, current_group
, nomsg
)
3169 Lisp_Object process
;
3171 Lisp_Object current_group
;
3175 register struct Lisp_Process
*p
;
3179 proc
= get_process (process
);
3180 p
= XPROCESS (proc
);
3182 if (!EQ (p
->childp
, Qt
))
3183 error ("Process %s is not a subprocess",
3184 XSTRING (p
->name
)->data
);
3185 if (XINT (p
->infd
) < 0)
3186 error ("Process %s is not active",
3187 XSTRING (p
->name
)->data
);
3189 if (NILP (p
->pty_flag
))
3190 current_group
= Qnil
;
3192 /* If we are using pgrps, get a pgrp number and make it negative. */
3193 if (!NILP (current_group
))
3195 #ifdef SIGNALS_VIA_CHARACTERS
3196 /* If possible, send signals to the entire pgrp
3197 by sending an input character to it. */
3199 /* TERMIOS is the latest and bestest, and seems most likely to
3200 work. If the system has it, use it. */
3207 tcgetattr (XINT (p
->infd
), &t
);
3208 send_process (proc
, &t
.c_cc
[VINTR
], 1, Qnil
);
3212 tcgetattr (XINT (p
->infd
), &t
);
3213 send_process (proc
, &t
.c_cc
[VQUIT
], 1, Qnil
);
3217 tcgetattr (XINT (p
->infd
), &t
);
3218 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
3219 send_process (proc
, &t
.c_cc
[VSWTCH
], 1, Qnil
);
3221 send_process (proc
, &t
.c_cc
[VSUSP
], 1, Qnil
);
3226 #else /* ! HAVE_TERMIOS */
3228 /* On Berkeley descendants, the following IOCTL's retrieve the
3229 current control characters. */
3230 #if defined (TIOCGLTC) && defined (TIOCGETC)
3238 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
3239 send_process (proc
, &c
.t_intrc
, 1, Qnil
);
3242 ioctl (XINT (p
->infd
), TIOCGETC
, &c
);
3243 send_process (proc
, &c
.t_quitc
, 1, Qnil
);
3247 ioctl (XINT (p
->infd
), TIOCGLTC
, &lc
);
3248 send_process (proc
, &lc
.t_suspc
, 1, Qnil
);
3250 #endif /* ! defined (SIGTSTP) */
3253 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3255 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
3262 ioctl (XINT (p
->infd
), TCGETA
, &t
);
3263 send_process (proc
, &t
.c_cc
[VINTR
], 1, Qnil
);
3266 ioctl (XINT (p
->infd
), TCGETA
, &t
);
3267 send_process (proc
, &t
.c_cc
[VQUIT
], 1, Qnil
);
3271 ioctl (XINT (p
->infd
), TCGETA
, &t
);
3272 send_process (proc
, &t
.c_cc
[VSWTCH
], 1, Qnil
);
3274 #endif /* ! defined (SIGTSTP) */
3276 #else /* ! defined (TCGETA) */
3277 Your configuration files are messed up
.
3278 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
3279 you'd better be using one of the alternatives above! */
3280 #endif /* ! defined (TCGETA) */
3281 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3282 #endif /* ! defined HAVE_TERMIOS */
3283 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
3286 /* Get the pgrp using the tty itself, if we have that.
3287 Otherwise, use the pty to get the pgrp.
3288 On pfa systems, saka@pfu.fujitsu.co.JP writes:
3289 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
3290 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
3291 His patch indicates that if TIOCGPGRP returns an error, then
3292 we should just assume that p->pid is also the process group id. */
3296 if (!NILP (p
->subtty
))
3297 err
= ioctl (XFASTINT (p
->subtty
), TIOCGPGRP
, &gid
);
3299 err
= ioctl (XINT (p
->infd
), TIOCGPGRP
, &gid
);
3303 gid
= - XFASTINT (p
->pid
);
3304 #endif /* ! defined (pfa) */
3310 #else /* ! defined (TIOCGPGRP ) */
3311 /* Can't select pgrps on this system, so we know that
3312 the child itself heads the pgrp. */
3313 gid
= - XFASTINT (p
->pid
);
3314 #endif /* ! defined (TIOCGPGRP ) */
3317 gid
= - XFASTINT (p
->pid
);
3323 p
->raw_status_low
= Qnil
;
3324 p
->raw_status_high
= Qnil
;
3326 XSETINT (p
->tick
, ++process_tick
);
3330 #endif /* ! defined (SIGCONT) */
3333 send_process (proc
, "\003", 1, Qnil
); /* ^C */
3338 send_process (proc
, "\031", 1, Qnil
); /* ^Y */
3343 sys$
forcex (&(XFASTINT (p
->pid
)), 0, 1);
3346 flush_pending_output (XINT (p
->infd
));
3350 /* If we don't have process groups, send the signal to the immediate
3351 subprocess. That isn't really right, but it's better than any
3352 obvious alternative. */
3355 kill (XFASTINT (p
->pid
), signo
);
3359 /* gid may be a pid, or minus a pgrp's number */
3361 if (!NILP (current_group
))
3362 ioctl (XINT (p
->infd
), TIOCSIGSEND
, signo
);
3365 gid
= - XFASTINT (p
->pid
);
3368 #else /* ! defined (TIOCSIGSEND) */
3369 EMACS_KILLPG (-gid
, signo
);
3370 #endif /* ! defined (TIOCSIGSEND) */
3373 DEFUN ("interrupt-process", Finterrupt_process
, Sinterrupt_process
, 0, 2, 0,
3374 "Interrupt process PROCESS. May be process or name of one.\n\
3375 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
3376 nil or no arg means current buffer's process.\n\
3377 Second arg CURRENT-GROUP non-nil means send signal to\n\
3378 the current process-group of the process's controlling terminal\n\
3379 rather than to the process's own process group.\n\
3380 If the process is a shell, this means interrupt current subjob\n\
3381 rather than the shell.")
3382 (process
, current_group
)
3383 Lisp_Object process
, current_group
;
3385 process_send_signal (process
, SIGINT
, current_group
, 0);
3389 DEFUN ("kill-process", Fkill_process
, Skill_process
, 0, 2, 0,
3390 "Kill process PROCESS. May be process or name of one.\n\
3391 See function `interrupt-process' for more details on usage.")
3392 (process
, current_group
)
3393 Lisp_Object process
, current_group
;
3395 process_send_signal (process
, SIGKILL
, current_group
, 0);
3399 DEFUN ("quit-process", Fquit_process
, Squit_process
, 0, 2, 0,
3400 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
3401 See function `interrupt-process' for more details on usage.")
3402 (process
, current_group
)
3403 Lisp_Object process
, current_group
;
3405 process_send_signal (process
, SIGQUIT
, current_group
, 0);
3409 DEFUN ("stop-process", Fstop_process
, Sstop_process
, 0, 2, 0,
3410 "Stop process PROCESS. May be process or name of one.\n\
3411 See function `interrupt-process' for more details on usage.")
3412 (process
, current_group
)
3413 Lisp_Object process
, current_group
;
3416 error ("no SIGTSTP support");
3418 process_send_signal (process
, SIGTSTP
, current_group
, 0);
3423 DEFUN ("continue-process", Fcontinue_process
, Scontinue_process
, 0, 2, 0,
3424 "Continue process PROCESS. May be process or name of one.\n\
3425 See function `interrupt-process' for more details on usage.")
3426 (process
, current_group
)
3427 Lisp_Object process
, current_group
;
3430 process_send_signal (process
, SIGCONT
, current_group
, 0);
3432 error ("no SIGCONT support");
3437 DEFUN ("signal-process", Fsignal_process
, Ssignal_process
,
3438 2, 2, "nProcess number: \nnSignal code: ",
3439 "Send the process with process id PID the signal with code SIGCODE.\n\
3440 PID must be an integer. The process need not be a child of this Emacs.\n\
3441 SIGCODE may be an integer, or a symbol whose name is a signal name.")
3443 Lisp_Object pid
, sigcode
;
3445 CHECK_NUMBER (pid
, 0);
3447 #define handle_signal(NAME, VALUE) \
3448 else if (!strcmp (name, NAME)) \
3449 XSETINT (sigcode, VALUE)
3451 if (INTEGERP (sigcode
))
3455 unsigned char *name
;
3457 CHECK_SYMBOL (sigcode
, 1);
3458 name
= XSYMBOL (sigcode
)->name
->data
;
3463 handle_signal ("SIGHUP", SIGHUP
);
3466 handle_signal ("SIGINT", SIGINT
);
3469 handle_signal ("SIGQUIT", SIGQUIT
);
3472 handle_signal ("SIGILL", SIGILL
);
3475 handle_signal ("SIGABRT", SIGABRT
);
3478 handle_signal ("SIGEMT", SIGEMT
);
3481 handle_signal ("SIGKILL", SIGKILL
);
3484 handle_signal ("SIGFPE", SIGFPE
);
3487 handle_signal ("SIGBUS", SIGBUS
);
3490 handle_signal ("SIGSEGV", SIGSEGV
);
3493 handle_signal ("SIGSYS", SIGSYS
);
3496 handle_signal ("SIGPIPE", SIGPIPE
);
3499 handle_signal ("SIGALRM", SIGALRM
);
3502 handle_signal ("SIGTERM", SIGTERM
);
3505 handle_signal ("SIGURG", SIGURG
);
3508 handle_signal ("SIGSTOP", SIGSTOP
);
3511 handle_signal ("SIGTSTP", SIGTSTP
);
3514 handle_signal ("SIGCONT", SIGCONT
);
3517 handle_signal ("SIGCHLD", SIGCHLD
);
3520 handle_signal ("SIGTTIN", SIGTTIN
);
3523 handle_signal ("SIGTTOU", SIGTTOU
);
3526 handle_signal ("SIGIO", SIGIO
);
3529 handle_signal ("SIGXCPU", SIGXCPU
);
3532 handle_signal ("SIGXFSZ", SIGXFSZ
);
3535 handle_signal ("SIGVTALRM", SIGVTALRM
);
3538 handle_signal ("SIGPROF", SIGPROF
);
3541 handle_signal ("SIGWINCH", SIGWINCH
);
3544 handle_signal ("SIGINFO", SIGINFO
);
3547 handle_signal ("SIGUSR1", SIGUSR1
);
3550 handle_signal ("SIGUSR2", SIGUSR2
);
3553 error ("Undefined signal name %s", name
);
3556 #undef handle_signal
3558 return make_number (kill (XINT (pid
), XINT (sigcode
)));
3561 DEFUN ("process-send-eof", Fprocess_send_eof
, Sprocess_send_eof
, 0, 1, 0,
3562 "Make PROCESS see end-of-file in its input.\n\
3563 Eof comes after any text already sent to it.\n\
3564 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3565 nil, indicating the current buffer's process.\n\
3566 If PROCESS is a network connection, or is a process communicating\n\
3567 through a pipe (as opposed to a pty), then you cannot send any more\n\
3568 text to PROCESS after you call this function.")
3570 Lisp_Object process
;
3574 proc
= get_process (process
);
3576 /* Make sure the process is really alive. */
3577 if (! NILP (XPROCESS (proc
)->raw_status_low
))
3578 update_status (XPROCESS (proc
));
3579 if (! EQ (XPROCESS (proc
)->status
, Qrun
))
3580 error ("Process %s not running", XSTRING (XPROCESS (proc
)->name
)->data
);
3583 send_process (proc
, "\032", 1, Qnil
); /* ^z */
3585 if (!NILP (XPROCESS (proc
)->pty_flag
))
3586 send_process (proc
, "\004", 1, Qnil
);
3589 close (XINT (XPROCESS (proc
)->outfd
));
3590 XSETINT (XPROCESS (proc
)->outfd
, open (NULL_DEVICE
, O_WRONLY
));
3596 /* Kill all processes associated with `buffer'.
3597 If `buffer' is nil, kill all processes */
3599 kill_buffer_processes (buffer
)
3602 Lisp_Object tail
, proc
;
3604 for (tail
= Vprocess_alist
; GC_CONSP (tail
); tail
= XCONS (tail
)->cdr
)
3606 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
3607 if (GC_PROCESSP (proc
)
3608 && (NILP (buffer
) || EQ (XPROCESS (proc
)->buffer
, buffer
)))
3610 if (NETCONN_P (proc
))
3611 Fdelete_process (proc
);
3612 else if (XINT (XPROCESS (proc
)->infd
) >= 0)
3613 process_send_signal (proc
, SIGHUP
, Qnil
, 1);
3618 /* On receipt of a signal that a child status has changed,
3619 loop asking about children with changed statuses until
3620 the system says there are no more.
3621 All we do is change the status;
3622 we do not run sentinels or print notifications.
3623 That is saved for the next time keyboard input is done,
3624 in order to avoid timing errors. */
3626 /** WARNING: this can be called during garbage collection.
3627 Therefore, it must not be fooled by the presence of mark bits in
3630 /** USG WARNING: Although it is not obvious from the documentation
3631 in signal(2), on a USG system the SIGCLD handler MUST NOT call
3632 signal() before executing at least one wait(), otherwise the handler
3633 will be called again, resulting in an infinite loop. The relevant
3634 portion of the documentation reads "SIGCLD signals will be queued
3635 and the signal-catching function will be continually reentered until
3636 the queue is empty". Invoking signal() causes the kernel to reexamine
3637 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
3640 sigchld_handler (signo
)
3643 int old_errno
= errno
;
3645 register struct Lisp_Process
*p
;
3646 extern EMACS_TIME
*input_available_clear_time
;
3650 sigheld
|= sigbit (SIGCHLD
);
3662 #endif /* no WUNTRACED */
3663 /* Keep trying to get a status until we get a definitive result. */
3667 pid
= wait3 (&w
, WNOHANG
| WUNTRACED
, 0);
3669 while (pid
<= 0 && errno
== EINTR
);
3673 /* A real failure. We have done all our job, so return. */
3675 /* USG systems forget handlers when they are used;
3676 must reestablish each time */
3677 #if defined (USG) && !defined (POSIX_SIGNALS)
3678 signal (signo
, sigchld_handler
); /* WARNING - must come after wait3() */
3681 sigheld
&= ~sigbit (SIGCHLD
);
3689 #endif /* no WNOHANG */
3691 /* Find the process that signaled us, and record its status. */
3694 for (tail
= Vprocess_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
3696 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
3697 p
= XPROCESS (proc
);
3698 if (EQ (p
->childp
, Qt
) && XFASTINT (p
->pid
) == pid
)
3703 /* Look for an asynchronous process whose pid hasn't been filled
3706 for (tail
= Vprocess_alist
; CONSP (tail
); tail
= XCONS (tail
)->cdr
)
3708 proc
= XCONS (XCONS (tail
)->car
)->cdr
;
3709 p
= XPROCESS (proc
);
3710 if (INTEGERP (p
->pid
) && XINT (p
->pid
) == -1)
3715 /* Change the status of the process that was found. */
3718 union { int i
; WAITTYPE wt
; } u
;
3719 int clear_desc_flag
= 0;
3721 XSETINT (p
->tick
, ++process_tick
);
3723 XSETINT (p
->raw_status_low
, u
.i
& 0xffff);
3724 XSETINT (p
->raw_status_high
, u
.i
>> 16);
3726 /* If process has terminated, stop waiting for its output. */
3727 if ((WIFSIGNALED (w
) || WIFEXITED (w
))
3728 && XINT (p
->infd
) >= 0)
3729 clear_desc_flag
= 1;
3731 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
3732 if (clear_desc_flag
)
3734 FD_CLR (XINT (p
->infd
), &input_wait_mask
);
3735 FD_CLR (XINT (p
->infd
), &non_keyboard_wait_mask
);
3738 /* Tell wait_reading_process_input that it needs to wake up and
3740 if (input_available_clear_time
)
3741 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
3744 /* There was no asynchronous process found for that id. Check
3745 if we have a synchronous process. */
3748 synch_process_alive
= 0;
3750 /* Report the status of the synchronous process. */
3752 synch_process_retcode
= WRETCODE (w
);
3753 else if (WIFSIGNALED (w
))
3755 int code
= WTERMSIG (w
);
3761 /* Suppress warning if the table has const char *. */
3762 signame
= (char *) sys_siglist
[code
];
3764 signame
= sys_errlist
[code
];
3768 signame
= "unknown";
3770 synch_process_death
= signame
;
3773 /* Tell wait_reading_process_input that it needs to wake up and
3775 if (input_available_clear_time
)
3776 EMACS_SET_SECS_USECS (*input_available_clear_time
, 0, 0);
3779 /* On some systems, we must return right away.
3780 If any more processes want to signal us, we will
3782 Otherwise (on systems that have WNOHANG), loop around
3783 to use up all the processes that have something to tell us. */
3784 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG)) || defined (WINDOWSNT)
3785 #if defined (USG) && ! defined (POSIX_SIGNALS)
3786 signal (signo
, sigchld_handler
);
3790 #endif /* USG, but not HPUX with WNOHANG */
3796 exec_sentinel_unwind (data
)
3799 XPROCESS (XCONS (data
)->car
)->sentinel
= XCONS (data
)->cdr
;
3804 exec_sentinel_error_handler (error
)
3807 cmd_error_internal (error
, "error in process sentinel: ");
3809 update_echo_area ();
3810 Fsleep_for (make_number (2), Qnil
);
3814 exec_sentinel (proc
, reason
)
3815 Lisp_Object proc
, reason
;
3817 Lisp_Object sentinel
, obuffer
, odeactivate
, okeymap
;
3818 register struct Lisp_Process
*p
= XPROCESS (proc
);
3819 int count
= specpdl_ptr
- specpdl
;
3820 int outer_running_asynch_code
= running_asynch_code
;
3822 /* No need to gcpro these, because all we do with them later
3823 is test them for EQness, and none of them should be a string. */
3824 odeactivate
= Vdeactivate_mark
;
3825 XSETBUFFER (obuffer
, current_buffer
);
3826 okeymap
= current_buffer
->keymap
;
3828 sentinel
= p
->sentinel
;
3829 if (NILP (sentinel
))
3832 /* Zilch the sentinel while it's running, to avoid recursive invocations;
3833 assure that it gets restored no matter how the sentinel exits. */
3835 record_unwind_protect (exec_sentinel_unwind
, Fcons (proc
, sentinel
));
3836 /* Inhibit quit so that random quits don't screw up a running filter. */
3837 specbind (Qinhibit_quit
, Qt
);
3838 specbind (Qlast_nonmenu_event
, Qt
);
3840 /* In case we get recursively called,
3841 and we already saved the match data nonrecursively,
3842 save the same match data in safely recursive fashion. */
3843 if (outer_running_asynch_code
)
3846 tem
= Fmatch_data (Qnil
, Qnil
);
3847 restore_match_data ();
3848 record_unwind_protect (Fstore_match_data
, Fmatch_data (Qnil
, Qnil
));
3849 Fstore_match_data (tem
);
3852 /* For speed, if a search happens within this code,
3853 save the match data in a special nonrecursive fashion. */
3854 running_asynch_code
= 1;
3856 internal_condition_case_1 (read_process_output_call
,
3858 Fcons (proc
, Fcons (reason
, Qnil
))),
3859 !NILP (Vdebug_on_error
) ? Qnil
: Qerror
,
3860 exec_sentinel_error_handler
);
3862 /* If we saved the match data nonrecursively, restore it now. */
3863 restore_match_data ();
3864 running_asynch_code
= outer_running_asynch_code
;
3866 Vdeactivate_mark
= odeactivate
;
3868 if (! EQ (Fcurrent_buffer (), obuffer
)
3869 || ! EQ (current_buffer
->keymap
, okeymap
))
3871 /* But do it only if the caller is actually going to read events.
3872 Otherwise there's no need to make him wake up, and it could
3873 cause trouble (for example it would make Fsit_for return). */
3874 if (waiting_for_user_input_p
== -1)
3875 record_asynch_buffer_change ();
3877 unbind_to (count
, Qnil
);
3880 /* Report all recent events of a change in process status
3881 (either run the sentinel or output a message).
3882 This is done while Emacs is waiting for keyboard input. */
3886 register Lisp_Object proc
, buffer
;
3887 Lisp_Object tail
, msg
;
3888 struct gcpro gcpro1
, gcpro2
;
3892 /* We need to gcpro tail; if read_process_output calls a filter
3893 which deletes a process and removes the cons to which tail points
3894 from Vprocess_alist, and then causes a GC, tail is an unprotected
3898 /* Set this now, so that if new processes are created by sentinels
3899 that we run, we get called again to handle their status changes. */
3900 update_tick
= process_tick
;
3902 for (tail
= Vprocess_alist
; !NILP (tail
); tail
= Fcdr (tail
))
3905 register struct Lisp_Process
*p
;
3907 proc
= Fcdr (Fcar (tail
));
3908 p
= XPROCESS (proc
);
3910 if (XINT (p
->tick
) != XINT (p
->update_tick
))
3912 XSETINT (p
->update_tick
, XINT (p
->tick
));
3914 /* If process is still active, read any output that remains. */
3915 while (! EQ (p
->filter
, Qt
)
3916 && XINT (p
->infd
) >= 0
3917 && read_process_output (proc
, XINT (p
->infd
)) > 0);
3921 /* Get the text to use for the message. */
3922 if (!NILP (p
->raw_status_low
))
3924 msg
= status_message (p
->status
);
3926 /* If process is terminated, deactivate it or delete it. */
3928 if (CONSP (p
->status
))
3929 symbol
= XCONS (p
->status
)->car
;
3931 if (EQ (symbol
, Qsignal
) || EQ (symbol
, Qexit
)
3932 || EQ (symbol
, Qclosed
))
3934 if (delete_exited_processes
)
3935 remove_process (proc
);
3937 deactivate_process (proc
);
3940 /* The actions above may have further incremented p->tick.
3941 So set p->update_tick again
3942 so that an error in the sentinel will not cause
3943 this code to be run again. */
3944 XSETINT (p
->update_tick
, XINT (p
->tick
));
3945 /* Now output the message suitably. */
3946 if (!NILP (p
->sentinel
))
3947 exec_sentinel (proc
, msg
);
3948 /* Don't bother with a message in the buffer
3949 when a process becomes runnable. */
3950 else if (!EQ (symbol
, Qrun
) && !NILP (buffer
))
3952 Lisp_Object ro
, tem
;
3953 struct buffer
*old
= current_buffer
;
3956 ro
= XBUFFER (buffer
)->read_only
;
3958 /* Avoid error if buffer is deleted
3959 (probably that's why the process is dead, too) */
3960 if (NILP (XBUFFER (buffer
)->name
))
3962 Fset_buffer (buffer
);
3964 /* Insert new output into buffer
3965 at the current end-of-output marker,
3966 thus preserving logical ordering of input and output. */
3967 if (XMARKER (p
->mark
)->buffer
)
3968 SET_PT (marker_position (p
->mark
));
3972 opoint
+= XSTRING (msg
)->size
+ XSTRING (p
->name
)->size
+ 10;
3974 tem
= current_buffer
->read_only
;
3975 current_buffer
->read_only
= Qnil
;
3976 insert_string ("\nProcess ");
3977 Finsert (1, &p
->name
);
3978 insert_string (" ");
3980 current_buffer
->read_only
= tem
;
3981 Fset_marker (p
->mark
, make_number (PT
), p
->buffer
);
3984 set_buffer_internal (old
);
3989 update_mode_lines
++; /* in case buffers use %s in mode-line-format */
3990 redisplay_preserve_echo_area ();
3996 DEFUN ("set-process-coding-system", Fset_process_coding_system
,
3997 Sset_process_coding_system
, 1, 3, 0,
3998 "Set coding-systems of PROCESS to DECODING (input from the process) and\n\
3999 ENCODING (output to the process).")
4000 (proc
, decoding
, encoding
)
4001 register Lisp_Object proc
, decoding
, encoding
;
4003 register struct Lisp_Process
*p
;
4005 CHECK_PROCESS (proc
, 0);
4006 p
= XPROCESS (proc
);
4007 if (XINT (p
->infd
) < 0)
4008 error ("Input file descriptor of %s closed", XSTRING (p
->name
)->data
);
4009 if (XINT (p
->outfd
) < 0)
4010 error ("Output file descriptor of %s closed", XSTRING (p
->name
)->data
);
4012 p
->decode_coding_system
= Fcheck_coding_system (decoding
);
4013 p
->encode_coding_system
= Fcheck_coding_system (encoding
);
4014 setup_coding_system (decoding
,
4015 proc_decode_coding_system
[XINT (p
->infd
)]);
4016 setup_coding_system (encoding
,
4017 proc_encode_coding_system
[XINT (p
->outfd
)]);
4022 DEFUN ("process-coding-system",
4023 Fprocess_coding_system
, Sprocess_coding_system
, 1, 1, 0,
4024 "Return a cons of coding-system for decoding and encoding of PROCESS.")
4026 register Lisp_Object proc
;
4028 CHECK_PROCESS (proc
, 0);
4029 return Fcons (XPROCESS (proc
)->decode_coding_system
,
4030 XPROCESS (proc
)->encode_coding_system
);
4033 /* The first time this is called, assume keyboard input comes from DESC
4034 instead of from where we used to expect it.
4035 Subsequent calls mean assume input keyboard can come from DESC
4036 in addition to other places. */
4038 static int add_keyboard_wait_descriptor_called_flag
;
4041 add_keyboard_wait_descriptor (desc
)
4044 if (! add_keyboard_wait_descriptor_called_flag
)
4045 FD_CLR (0, &input_wait_mask
);
4046 add_keyboard_wait_descriptor_called_flag
= 1;
4047 FD_SET (desc
, &input_wait_mask
);
4048 FD_SET (desc
, &non_process_wait_mask
);
4049 if (desc
> max_keyboard_desc
)
4050 max_keyboard_desc
= desc
;
4053 /* From now on, do not expect DESC to give keyboard input. */
4056 delete_keyboard_wait_descriptor (desc
)
4060 int lim
= max_keyboard_desc
;
4062 FD_CLR (desc
, &input_wait_mask
);
4063 FD_CLR (desc
, &non_process_wait_mask
);
4065 if (desc
== max_keyboard_desc
)
4066 for (fd
= 0; fd
< lim
; fd
++)
4067 if (FD_ISSET (fd
, &input_wait_mask
)
4068 && !FD_ISSET (fd
, &non_keyboard_wait_mask
))
4069 max_keyboard_desc
= fd
;
4072 /* Return nonzero if *MASK has a bit set
4073 that corresponds to one of the keyboard input descriptors. */
4076 keyboard_bit_set (mask
)
4081 for (fd
= 0; fd
<= max_keyboard_desc
; fd
++)
4082 if (FD_ISSET (fd
, mask
) && FD_ISSET (fd
, &input_wait_mask
)
4083 && !FD_ISSET (fd
, &non_keyboard_wait_mask
))
4095 if (! noninteractive
|| initialized
)
4097 signal (SIGCHLD
, sigchld_handler
);
4100 FD_ZERO (&input_wait_mask
);
4101 FD_ZERO (&non_keyboard_wait_mask
);
4102 FD_ZERO (&non_process_wait_mask
);
4103 max_process_desc
= 0;
4105 FD_SET (0, &input_wait_mask
);
4107 Vprocess_alist
= Qnil
;
4108 for (i
= 0; i
< MAXDESC
; i
++)
4110 chan_process
[i
] = Qnil
;
4111 proc_buffered_char
[i
] = -1;
4113 bzero (proc_decode_coding_system
, sizeof proc_decode_coding_system
);
4114 bzero (proc_encode_coding_system
, sizeof proc_encode_coding_system
);
4119 Qprocessp
= intern ("processp");
4120 staticpro (&Qprocessp
);
4121 Qrun
= intern ("run");
4123 Qstop
= intern ("stop");
4125 Qsignal
= intern ("signal");
4126 staticpro (&Qsignal
);
4128 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
4131 Qexit = intern ("exit");
4132 staticpro (&Qexit); */
4134 Qopen
= intern ("open");
4136 Qclosed
= intern ("closed");
4137 staticpro (&Qclosed
);
4139 Qlast_nonmenu_event
= intern ("last-nonmenu-event");
4140 staticpro (&Qlast_nonmenu_event
);
4142 staticpro (&Vprocess_alist
);
4144 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes
,
4145 "*Non-nil means delete processes immediately when they exit.\n\
4146 nil means don't delete them until `list-processes' is run.");
4148 delete_exited_processes
= 1;
4150 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type
,
4151 "Control type of device used to communicate with subprocesses.\n\
4152 Values are nil to use a pipe, or t or `pty' to use a pty.\n\
4153 The value has no effect if the system has no ptys or if all ptys are busy:\n\
4154 then a pipe is used in any case.\n\
4155 The value takes effect when `start-process' is called.");
4156 Vprocess_connection_type
= Qt
;
4158 defsubr (&Sprocessp
);
4159 defsubr (&Sget_process
);
4160 defsubr (&Sget_buffer_process
);
4161 defsubr (&Sdelete_process
);
4162 defsubr (&Sprocess_status
);
4163 defsubr (&Sprocess_exit_status
);
4164 defsubr (&Sprocess_id
);
4165 defsubr (&Sprocess_name
);
4166 defsubr (&Sprocess_tty_name
);
4167 defsubr (&Sprocess_command
);
4168 defsubr (&Sset_process_buffer
);
4169 defsubr (&Sprocess_buffer
);
4170 defsubr (&Sprocess_mark
);
4171 defsubr (&Sset_process_filter
);
4172 defsubr (&Sprocess_filter
);
4173 defsubr (&Sset_process_sentinel
);
4174 defsubr (&Sprocess_sentinel
);
4175 defsubr (&Sset_process_window_size
);
4176 defsubr (&Sprocess_kill_without_query
);
4177 defsubr (&Sprocess_contact
);
4178 defsubr (&Slist_processes
);
4179 defsubr (&Sprocess_list
);
4180 defsubr (&Sstart_process
);
4182 defsubr (&Sopen_network_stream
);
4183 #endif /* HAVE_SOCKETS */
4184 defsubr (&Saccept_process_output
);
4185 defsubr (&Sprocess_send_region
);
4186 defsubr (&Sprocess_send_string
);
4187 defsubr (&Sinterrupt_process
);
4188 defsubr (&Skill_process
);
4189 defsubr (&Squit_process
);
4190 defsubr (&Sstop_process
);
4191 defsubr (&Scontinue_process
);
4192 defsubr (&Sprocess_send_eof
);
4193 defsubr (&Ssignal_process
);
4194 defsubr (&Swaiting_for_user_input_p
);
4195 /* defsubr (&Sprocess_connection); */
4196 defsubr (&Sset_process_coding_system
);
4197 defsubr (&Sprocess_coding_system
);
4201 #else /* not subprocesses */
4203 #include <sys/types.h>
4207 #include "systime.h"
4208 #include "termopts.h"
4209 #include "sysselect.h"
4211 extern int frame_garbaged
;
4213 extern EMACS_TIME
timer_check ();
4214 extern int timers_run
;
4216 /* As described above, except assuming that there are no subprocesses:
4218 Wait for timeout to elapse and/or keyboard input to be available.
4221 timeout in seconds, or
4222 zero for no limit, or
4223 -1 means gobble data immediately available but don't wait for any.
4225 read_kbd is a Lisp_Object:
4226 0 to ignore keyboard input, or
4227 1 to return when input is available, or
4228 -1 means caller will actually read the input, so don't throw to
4230 a cons cell, meaning wait until its car is non-nil
4231 (and gobble terminal input into the buffer if any arrives), or
4232 We know that read_kbd will never be a Lisp_Process, since
4233 `subprocesses' isn't defined.
4235 do_display != 0 means redisplay should be done to show subprocess
4236 output that arrives.
4238 Return true iff we received input from any process. */
4241 wait_reading_process_input (time_limit
, microsecs
, read_kbd
, do_display
)
4242 int time_limit
, microsecs
;
4243 Lisp_Object read_kbd
;
4246 EMACS_TIME end_time
, timeout
;
4247 SELECT_TYPE waitchannels
;
4249 Lisp_Object
*wait_for_cell
= 0;
4251 /* If waiting for non-nil in a cell, record where. */
4252 if (CONSP (read_kbd
))
4254 wait_for_cell
= &XCONS (read_kbd
)->car
;
4255 XSETFASTINT (read_kbd
, 0);
4258 /* What does time_limit really mean? */
4259 if (time_limit
|| microsecs
)
4261 if (time_limit
== -1)
4262 /* In fact, it's zero. */
4263 EMACS_SET_SECS_USECS (timeout
, 0, 0);
4265 EMACS_SET_SECS_USECS (timeout
, time_limit
, microsecs
);
4267 /* How far in the future is that? */
4268 EMACS_GET_TIME (end_time
);
4269 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
4272 /* It's infinite. */
4273 EMACS_SET_SECS_USECS (timeout
, 100000, 0);
4275 /* Turn off periodic alarms (in case they are in use)
4276 because the select emulator uses alarms. */
4282 int timeout_reduced_for_timers
= 0;
4284 /* If calling from keyboard input, do not quit
4285 since we want to return C-g as an input character.
4286 Otherwise, do pending quit if requested. */
4287 if (XINT (read_kbd
) >= 0)
4290 /* Exit now if the cell we're waiting for became non-nil. */
4291 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
4294 /* Compute time from now till when time limit is up */
4295 /* Exit if already run out */
4296 if (time_limit
> 0 || microsecs
)
4298 EMACS_GET_TIME (timeout
);
4299 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
4300 if (EMACS_TIME_NEG_P (timeout
))
4304 /* If our caller will not immediately handle keyboard events,
4305 run timer events directly.
4306 (Callers that will immediately read keyboard events
4307 call timer_delay on their own.) */
4308 if (! wait_for_cell
)
4310 EMACS_TIME timer_delay
;
4314 old_timers_run
= timers_run
;
4315 timer_delay
= timer_check (1);
4316 if (timers_run
!= old_timers_run
&& do_display
)
4318 redisplay_preserve_echo_area ();
4319 /* We must retry, since a timer may have requeued itself
4320 and that could alter the time delay. */
4324 if (! EMACS_TIME_NEG_P (timer_delay
) && time_limit
!= -1)
4326 EMACS_TIME difference
;
4327 EMACS_SUB_TIME (difference
, timer_delay
, timeout
);
4328 if (EMACS_TIME_NEG_P (difference
))
4330 timeout
= timer_delay
;
4331 timeout_reduced_for_timers
= 1;
4336 /* Cause C-g and alarm signals to take immediate action,
4337 and cause input available signals to zero out timeout. */
4338 if (XINT (read_kbd
) < 0)
4339 set_waiting_for_input (&timeout
);
4341 /* Wait till there is something to do. */
4343 if (! XINT (read_kbd
) && wait_for_cell
== 0)
4344 FD_ZERO (&waitchannels
);
4346 FD_SET (0, &waitchannels
);
4348 /* If a frame has been newly mapped and needs updating,
4349 reprocess its display stuff. */
4350 if (frame_garbaged
&& do_display
)
4352 clear_waiting_for_input ();
4353 redisplay_preserve_echo_area ();
4354 if (XINT (read_kbd
) < 0)
4355 set_waiting_for_input (&timeout
);
4358 if (XINT (read_kbd
) && detect_input_pending ())
4361 FD_ZERO (&waitchannels
);
4364 nfds
= select (1, &waitchannels
, (SELECT_TYPE
*)0, (SELECT_TYPE
*)0,
4369 /* Make C-g and alarm signals set flags again */
4370 clear_waiting_for_input ();
4372 /* If we woke up due to SIGWINCH, actually change size now. */
4373 do_pending_window_change ();
4375 if (time_limit
&& nfds
== 0 && ! timeout_reduced_for_timers
)
4376 /* We waited the full specified time, so return now. */
4381 /* If the system call was interrupted, then go around the
4383 if (xerrno
== EINTR
)
4384 FD_ZERO (&waitchannels
);
4386 error ("select error: %s", strerror (xerrno
));
4389 else if (nfds
> 0 && (waitchannels
& 1) && interrupt_input
)
4390 /* System sometimes fails to deliver SIGIO. */
4391 kill (getpid (), SIGIO
);
4394 if (XINT (read_kbd
) && interrupt_input
&& (waitchannels
& 1))
4395 kill (getpid (), SIGIO
);
4398 /* Check for keyboard input */
4400 if ((XINT (read_kbd
) != 0)
4401 && detect_input_pending_run_timers (do_display
))
4403 swallow_events (do_display
);
4404 if (detect_input_pending_run_timers (do_display
))
4408 /* If wait_for_cell. check for keyboard input
4409 but don't run any timers.
4410 ??? (It seems wrong to me to check for keyboard
4411 input at all when wait_for_cell, but the code
4412 has been this way since July 1994.
4413 Try changing this after version 19.31.) */
4415 && detect_input_pending ())
4417 swallow_events (do_display
);
4418 if (detect_input_pending ())
4422 /* Exit now if the cell we're waiting for became non-nil. */
4423 if (wait_for_cell
&& ! NILP (*wait_for_cell
))
4433 DEFUN ("get-buffer-process", Fget_buffer_process
, Sget_buffer_process
, 1, 1, 0,
4434 /* Don't confuse make-docfile by having two doc strings for this function.
4435 make-docfile does not pay attention to #if, for good reason! */
4438 register Lisp_Object name
;
4443 /* Kill all processes associated with `buffer'.
4444 If `buffer' is nil, kill all processes.
4445 Since we have no subprocesses, this does nothing. */
4447 kill_buffer_processes (buffer
)
4458 defsubr (&Sget_buffer_process
);
4462 #endif /* not subprocesses */