Fix var names in doc.
[emacs.git] / src / process.c
blobb36fbc791085c94bfab9e3c9631cee5fb8911bdd
1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 96, 98, 1999
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)
10 any later version.
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. */
23 #define _GNU_SOURCE /* to get strsignal declared with glibc 2 */
24 #include <config.h>
25 #include <signal.h>
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. */
35 #ifdef subprocesses
37 #include <stdio.h>
38 #include <errno.h>
39 #include <setjmp.h>
40 #include <sys/types.h> /* some typedefs are used in sys/file.h */
41 #include <sys/file.h>
42 #include <sys/stat.h>
43 #ifdef HAVE_UNISTD_H
44 #include <unistd.h>
45 #endif
47 #if defined(WINDOWSNT) || defined(UNIX98_PTYS)
48 #include <stdlib.h>
49 #include <fcntl.h>
50 #endif /* not WINDOWSNT */
52 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
53 #include <sys/socket.h>
54 #include <netdb.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 GNU/Linux. */
63 #ifdef TERM
64 #include <client.h>
65 #endif
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)
71 #else
72 #define IN_ADDR unsigned long
73 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
74 #endif
76 #if defined(BSD_SYSTEM) || defined(STRIDE)
77 #include <sys/ioctl.h>
78 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
79 #include <fcntl.h>
80 #endif /* HAVE_PTYS and no O_NDELAY */
81 #endif /* BSD_SYSTEM || STRIDE */
83 #ifdef BROKEN_O_NONBLOCK
84 #undef O_NONBLOCK
85 #endif /* BROKEN_O_NONBLOCK */
87 #ifdef NEED_BSDTTY
88 #include <bsdtty.h>
89 #endif
91 #ifdef IRIS
92 #include <sys/sysmacros.h> /* for "minor" */
93 #endif /* not IRIS */
95 #include "systime.h"
96 #include "systty.h"
98 #include "lisp.h"
99 #include "window.h"
100 #include "buffer.h"
101 #include "charset.h"
102 #include "coding.h"
103 #include "process.h"
104 #include "termhooks.h"
105 #include "termopts.h"
106 #include "commands.h"
107 #include "keyboard.h"
108 #include "frame.h"
109 #include "blockinput.h"
110 #include "dispextern.h"
111 #include "composite.h"
112 #include "atimer.h"
114 #define max(a, b) ((a) > (b) ? (a) : (b))
116 Lisp_Object Qprocessp;
117 Lisp_Object Qrun, Qstop, Qsignal, Qopen, Qclosed;
118 Lisp_Object Qlast_nonmenu_event;
119 /* Qexit is declared and initialized in eval.c. */
121 /* a process object is a network connection when its childp field is neither
122 Qt nor Qnil but is instead a cons cell (HOSTNAME PORTNUM). */
124 #ifdef HAVE_SOCKETS
125 #define NETCONN_P(p) (GC_CONSP (XPROCESS (p)->childp))
126 #else
127 #define NETCONN_P(p) 0
128 #endif /* HAVE_SOCKETS */
130 /* Define first descriptor number available for subprocesses. */
131 #ifdef VMS
132 #define FIRST_PROC_DESC 1
133 #else /* Not VMS */
134 #define FIRST_PROC_DESC 3
135 #endif
137 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
138 testing SIGCHLD. */
140 #if !defined (SIGCHLD) && defined (SIGCLD)
141 #define SIGCHLD SIGCLD
142 #endif /* SIGCLD */
144 #include "syssignal.h"
146 #include "syswait.h"
148 extern void set_waiting_for_input P_ ((EMACS_TIME *));
150 #ifndef USE_CRT_DLL
151 extern int errno;
152 #endif
153 #ifdef VMS
154 extern char *sys_errlist[];
155 #endif
157 #ifndef HAVE_H_ERRNO
158 extern int h_errno;
159 #endif
161 /* t means use pty, nil means use a pipe,
162 maybe other values to come. */
163 static Lisp_Object Vprocess_connection_type;
165 #ifdef SKTPAIR
166 #ifndef HAVE_SOCKETS
167 #include <sys/socket.h>
168 #endif
169 #endif /* SKTPAIR */
171 /* These next two vars are non-static since sysdep.c uses them in the
172 emulation of `select'. */
173 /* Number of events of change of status of a process. */
174 int process_tick;
175 /* Number of events for which the user or sentinel has been notified. */
176 int update_tick;
178 #include "sysselect.h"
180 extern int keyboard_bit_set P_ ((SELECT_TYPE *));
182 /* If we support a window system, turn on the code to poll periodically
183 to detect C-g. It isn't actually used when doing interrupt input. */
184 #ifdef HAVE_WINDOW_SYSTEM
185 #define POLL_FOR_INPUT
186 #endif
188 /* Mask of bits indicating the descriptors that we wait for input on. */
190 static SELECT_TYPE input_wait_mask;
192 /* Mask that excludes keyboard input descriptor (s). */
194 static SELECT_TYPE non_keyboard_wait_mask;
196 /* Mask that excludes process input descriptor (s). */
198 static SELECT_TYPE non_process_wait_mask;
200 /* The largest descriptor currently in use for a process object. */
201 static int max_process_desc;
203 /* The largest descriptor currently in use for keyboard input. */
204 static int max_keyboard_desc;
206 /* Nonzero means delete a process right away if it exits. */
207 static int delete_exited_processes;
209 /* Indexed by descriptor, gives the process (if any) for that descriptor */
210 Lisp_Object chan_process[MAXDESC];
212 /* Alist of elements (NAME . PROCESS) */
213 Lisp_Object Vprocess_alist;
215 /* Buffered-ahead input char from process, indexed by channel.
216 -1 means empty (no char is buffered).
217 Used on sys V where the only way to tell if there is any
218 output from the process is to read at least one char.
219 Always -1 on systems that support FIONREAD. */
221 /* Don't make static; need to access externally. */
222 int proc_buffered_char[MAXDESC];
224 /* Table of `struct coding-system' for each process. */
225 static struct coding_system *proc_decode_coding_system[MAXDESC];
226 static struct coding_system *proc_encode_coding_system[MAXDESC];
228 static Lisp_Object get_process ();
230 extern EMACS_TIME timer_check ();
231 extern int timers_run;
233 /* Maximum number of bytes to send to a pty without an eof. */
234 static int pty_max_bytes;
236 extern Lisp_Object Vfile_name_coding_system, Vdefault_file_name_coding_system;
238 #ifdef HAVE_PTYS
239 /* The file name of the pty opened by allocate_pty. */
241 static char pty_name[24];
242 #endif
244 /* Compute the Lisp form of the process status, p->status, from
245 the numeric status that was returned by `wait'. */
247 Lisp_Object status_convert ();
249 void
250 update_status (p)
251 struct Lisp_Process *p;
253 union { int i; WAITTYPE wt; } u;
254 u.i = XFASTINT (p->raw_status_low) + (XFASTINT (p->raw_status_high) << 16);
255 p->status = status_convert (u.wt);
256 p->raw_status_low = Qnil;
257 p->raw_status_high = Qnil;
260 /* Convert a process status word in Unix format to
261 the list that we use internally. */
263 Lisp_Object
264 status_convert (w)
265 WAITTYPE w;
267 if (WIFSTOPPED (w))
268 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
269 else if (WIFEXITED (w))
270 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
271 WCOREDUMP (w) ? Qt : Qnil));
272 else if (WIFSIGNALED (w))
273 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
274 WCOREDUMP (w) ? Qt : Qnil));
275 else
276 return Qrun;
279 /* Given a status-list, extract the three pieces of information
280 and store them individually through the three pointers. */
282 void
283 decode_status (l, symbol, code, coredump)
284 Lisp_Object l;
285 Lisp_Object *symbol;
286 int *code;
287 int *coredump;
289 Lisp_Object tem;
291 if (SYMBOLP (l))
293 *symbol = l;
294 *code = 0;
295 *coredump = 0;
297 else
299 *symbol = XCAR (l);
300 tem = XCDR (l);
301 *code = XFASTINT (XCAR (tem));
302 tem = XCDR (tem);
303 *coredump = !NILP (tem);
307 /* Return a string describing a process status list. */
309 Lisp_Object
310 status_message (status)
311 Lisp_Object status;
313 Lisp_Object symbol;
314 int code, coredump;
315 Lisp_Object string, string2;
317 decode_status (status, &symbol, &code, &coredump);
319 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
321 char *signame;
322 synchronize_system_messages_locale ();
323 signame = strsignal (code);
324 if (signame == 0)
325 signame = "unknown";
326 string = build_string (signame);
327 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
328 XSTRING (string)->data[0] = DOWNCASE (XSTRING (string)->data[0]);
329 return concat2 (string, string2);
331 else if (EQ (symbol, Qexit))
333 if (code == 0)
334 return build_string ("finished\n");
335 string = Fnumber_to_string (make_number (code));
336 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
337 return concat2 (build_string ("exited abnormally with code "),
338 concat2 (string, string2));
340 else
341 return Fcopy_sequence (Fsymbol_name (symbol));
344 #ifdef HAVE_PTYS
346 /* Open an available pty, returning a file descriptor.
347 Return -1 on failure.
348 The file name of the terminal corresponding to the pty
349 is left in the variable pty_name. */
352 allocate_pty ()
354 struct stat stb;
355 register int c, i;
356 int fd;
358 /* Some systems name their pseudoterminals so that there are gaps in
359 the usual sequence - for example, on HP9000/S700 systems, there
360 are no pseudoterminals with names ending in 'f'. So we wait for
361 three failures in a row before deciding that we've reached the
362 end of the ptys. */
363 int failed_count = 0;
365 #ifdef PTY_ITERATION
366 PTY_ITERATION
367 #else
368 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
369 for (i = 0; i < 16; i++)
370 #endif
372 #ifdef PTY_NAME_SPRINTF
373 PTY_NAME_SPRINTF
374 #else
375 sprintf (pty_name, "/dev/pty%c%x", c, i);
376 #endif /* no PTY_NAME_SPRINTF */
378 #ifdef PTY_OPEN
379 PTY_OPEN;
380 #else /* no PTY_OPEN */
381 #ifdef IRIS
382 /* Unusual IRIS code */
383 *ptyv = emacs_open ("/dev/ptc", O_RDWR | O_NDELAY, 0);
384 if (fd < 0)
385 return -1;
386 if (fstat (fd, &stb) < 0)
387 return -1;
388 #else /* not IRIS */
389 if (stat (pty_name, &stb) < 0)
391 failed_count++;
392 if (failed_count >= 3)
393 return -1;
395 else
396 failed_count = 0;
397 #ifdef O_NONBLOCK
398 fd = emacs_open (pty_name, O_RDWR | O_NONBLOCK, 0);
399 #else
400 fd = emacs_open (pty_name, O_RDWR | O_NDELAY, 0);
401 #endif
402 #endif /* not IRIS */
403 #endif /* no PTY_OPEN */
405 if (fd >= 0)
407 /* check to make certain that both sides are available
408 this avoids a nasty yet stupid bug in rlogins */
409 #ifdef PTY_TTY_NAME_SPRINTF
410 PTY_TTY_NAME_SPRINTF
411 #else
412 sprintf (pty_name, "/dev/tty%c%x", c, i);
413 #endif /* no PTY_TTY_NAME_SPRINTF */
414 #ifndef UNIPLUS
415 if (access (pty_name, 6) != 0)
417 emacs_close (fd);
418 #if !defined(IRIS) && !defined(__sgi)
419 continue;
420 #else
421 return -1;
422 #endif /* IRIS */
424 #endif /* not UNIPLUS */
425 setup_pty (fd);
426 return fd;
429 return -1;
431 #endif /* HAVE_PTYS */
433 Lisp_Object
434 make_process (name)
435 Lisp_Object name;
437 struct Lisp_Vector *vec;
438 register Lisp_Object val, tem, name1;
439 register struct Lisp_Process *p;
440 char suffix[10];
441 register int i;
443 vec = allocate_vectorlike ((EMACS_INT) VECSIZE (struct Lisp_Process));
444 for (i = 0; i < VECSIZE (struct Lisp_Process); i++)
445 vec->contents[i] = Qnil;
446 vec->size = VECSIZE (struct Lisp_Process);
447 p = (struct Lisp_Process *)vec;
449 XSETINT (p->infd, -1);
450 XSETINT (p->outfd, -1);
451 XSETFASTINT (p->pid, 0);
452 XSETFASTINT (p->tick, 0);
453 XSETFASTINT (p->update_tick, 0);
454 p->raw_status_low = Qnil;
455 p->raw_status_high = Qnil;
456 p->status = Qrun;
457 p->mark = Fmake_marker ();
459 /* If name is already in use, modify it until it is unused. */
461 name1 = name;
462 for (i = 1; ; i++)
464 tem = Fget_process (name1);
465 if (NILP (tem)) break;
466 sprintf (suffix, "<%d>", i);
467 name1 = concat2 (name, build_string (suffix));
469 name = name1;
470 p->name = name;
471 XSETPROCESS (val, p);
472 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
473 return val;
476 void
477 remove_process (proc)
478 register Lisp_Object proc;
480 register Lisp_Object pair;
482 pair = Frassq (proc, Vprocess_alist);
483 Vprocess_alist = Fdelq (pair, Vprocess_alist);
485 deactivate_process (proc);
488 DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
489 "Return t if OBJECT is a process.")
490 (object)
491 Lisp_Object object;
493 return PROCESSP (object) ? Qt : Qnil;
496 DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
497 "Return the process named NAME, or nil if there is none.")
498 (name)
499 register Lisp_Object name;
501 if (PROCESSP (name))
502 return name;
503 CHECK_STRING (name, 0);
504 return Fcdr (Fassoc (name, Vprocess_alist));
507 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
508 "Return the (or a) process associated with BUFFER.\n\
509 BUFFER may be a buffer or the name of one.")
510 (buffer)
511 register Lisp_Object buffer;
513 register Lisp_Object buf, tail, proc;
515 if (NILP (buffer)) return Qnil;
516 buf = Fget_buffer (buffer);
517 if (NILP (buf)) return Qnil;
519 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
521 proc = Fcdr (Fcar (tail));
522 if (PROCESSP (proc) && EQ (XPROCESS (proc)->buffer, buf))
523 return proc;
525 return Qnil;
528 /* This is how commands for the user decode process arguments. It
529 accepts a process, a process name, a buffer, a buffer name, or nil.
530 Buffers denote the first process in the buffer, and nil denotes the
531 current buffer. */
533 static Lisp_Object
534 get_process (name)
535 register Lisp_Object name;
537 register Lisp_Object proc, obj;
538 if (STRINGP (name))
540 obj = Fget_process (name);
541 if (NILP (obj))
542 obj = Fget_buffer (name);
543 if (NILP (obj))
544 error ("Process %s does not exist", XSTRING (name)->data);
546 else if (NILP (name))
547 obj = Fcurrent_buffer ();
548 else
549 obj = name;
551 /* Now obj should be either a buffer object or a process object.
553 if (BUFFERP (obj))
555 proc = Fget_buffer_process (obj);
556 if (NILP (proc))
557 error ("Buffer %s has no process", XSTRING (XBUFFER (obj)->name)->data);
559 else
561 CHECK_PROCESS (obj, 0);
562 proc = obj;
564 return proc;
567 DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
568 "Delete PROCESS: kill it and forget about it immediately.\n\
569 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
570 nil, indicating the current buffer's process.")
571 (process)
572 register Lisp_Object process;
574 process = get_process (process);
575 XPROCESS (process)->raw_status_low = Qnil;
576 XPROCESS (process)->raw_status_high = Qnil;
577 if (NETCONN_P (process))
579 XPROCESS (process)->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
580 XSETINT (XPROCESS (process)->tick, ++process_tick);
582 else if (XINT (XPROCESS (process)->infd) >= 0)
584 Fkill_process (process, Qnil);
585 /* Do this now, since remove_process will make sigchld_handler do nothing. */
586 XPROCESS (process)->status
587 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
588 XSETINT (XPROCESS (process)->tick, ++process_tick);
589 status_notify ();
591 remove_process (process);
592 return Qnil;
595 DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
596 "Return the status of PROCESS.\n\
597 The returned value is one of the following symbols:\n\
598 run -- for a process that is running.\n\
599 stop -- for a process stopped but continuable.\n\
600 exit -- for a process that has exited.\n\
601 signal -- for a process that has got a fatal signal.\n\
602 open -- for a network stream connection that is open.\n\
603 closed -- for a network stream connection that is closed.\n\
604 nil -- if arg is a process name and no such process exists.\n\
605 PROCESS may be a process, a buffer, the name of a process, or\n\
606 nil, indicating the current buffer's process.")
607 (process)
608 register Lisp_Object process;
610 register struct Lisp_Process *p;
611 register Lisp_Object status;
613 if (STRINGP (process))
614 process = Fget_process (process);
615 else
616 process = get_process (process);
618 if (NILP (process))
619 return process;
621 p = XPROCESS (process);
622 if (!NILP (p->raw_status_low))
623 update_status (p);
624 status = p->status;
625 if (CONSP (status))
626 status = XCAR (status);
627 if (NETCONN_P (process))
629 if (EQ (status, Qrun))
630 status = Qopen;
631 else if (EQ (status, Qexit))
632 status = Qclosed;
634 return status;
637 DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
638 1, 1, 0,
639 "Return the exit status of PROCESS or the signal number that killed it.\n\
640 If PROCESS has not yet exited or died, return 0.")
641 (process)
642 register Lisp_Object process;
644 CHECK_PROCESS (process, 0);
645 if (!NILP (XPROCESS (process)->raw_status_low))
646 update_status (XPROCESS (process));
647 if (CONSP (XPROCESS (process)->status))
648 return XCAR (XCDR (XPROCESS (process)->status));
649 return make_number (0);
652 DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
653 "Return the process id of PROCESS.\n\
654 This is the pid of the Unix process which PROCESS uses or talks to.\n\
655 For a network connection, this value is nil.")
656 (process)
657 register Lisp_Object process;
659 CHECK_PROCESS (process, 0);
660 return XPROCESS (process)->pid;
663 DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
664 "Return the name of PROCESS, as a string.\n\
665 This is the name of the program invoked in PROCESS,\n\
666 possibly modified to make it unique among process names.")
667 (process)
668 register Lisp_Object process;
670 CHECK_PROCESS (process, 0);
671 return XPROCESS (process)->name;
674 DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
675 "Return the command that was executed to start PROCESS.\n\
676 This is a list of strings, the first string being the program executed\n\
677 and the rest of the strings being the arguments given to it.\n\
678 For a non-child channel, this is nil.")
679 (process)
680 register Lisp_Object process;
682 CHECK_PROCESS (process, 0);
683 return XPROCESS (process)->command;
686 DEFUN ("process-tty-name", Fprocess_tty_name, Sprocess_tty_name, 1, 1, 0,
687 "Return the name of the terminal PROCESS uses, or nil if none.\n\
688 This is the terminal that the process itself reads and writes on,\n\
689 not the name of the pty that Emacs uses to talk with that terminal.")
690 (process)
691 register Lisp_Object process;
693 CHECK_PROCESS (process, 0);
694 return XPROCESS (process)->tty_name;
697 DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
698 2, 2, 0,
699 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
700 (process, buffer)
701 register Lisp_Object process, buffer;
703 CHECK_PROCESS (process, 0);
704 if (!NILP (buffer))
705 CHECK_BUFFER (buffer, 1);
706 XPROCESS (process)->buffer = buffer;
707 return buffer;
710 DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
711 1, 1, 0,
712 "Return the buffer PROCESS is associated with.\n\
713 Output from PROCESS is inserted in this buffer unless PROCESS has a filter.")
714 (process)
715 register Lisp_Object process;
717 CHECK_PROCESS (process, 0);
718 return XPROCESS (process)->buffer;
721 DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
722 1, 1, 0,
723 "Return the marker for the end of the last output from PROCESS.")
724 (process)
725 register Lisp_Object process;
727 CHECK_PROCESS (process, 0);
728 return XPROCESS (process)->mark;
731 DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
732 2, 2, 0,
733 "Give PROCESS the filter function FILTER; nil means no filter.\n\
734 t means stop accepting output from the process.\n\
735 When a process has a filter, each time it does output\n\
736 the entire string of output is passed to the filter.\n\
737 The filter gets two arguments: the process and the string of output.\n\
738 If the process has a filter, its buffer is not used for output.")
739 (process, filter)
740 register Lisp_Object process, filter;
742 CHECK_PROCESS (process, 0);
743 if (EQ (filter, Qt))
745 FD_CLR (XINT (XPROCESS (process)->infd), &input_wait_mask);
746 FD_CLR (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
748 else if (EQ (XPROCESS (process)->filter, Qt))
750 FD_SET (XINT (XPROCESS (process)->infd), &input_wait_mask);
751 FD_SET (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
753 XPROCESS (process)->filter = filter;
754 return filter;
757 DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
758 1, 1, 0,
759 "Returns the filter function of PROCESS; nil if none.\n\
760 See `set-process-filter' for more info on filter functions.")
761 (process)
762 register Lisp_Object process;
764 CHECK_PROCESS (process, 0);
765 return XPROCESS (process)->filter;
768 DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
769 2, 2, 0,
770 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
771 The sentinel is called as a function when the process changes state.\n\
772 It gets two arguments: the process, and a string describing the change.")
773 (process, sentinel)
774 register Lisp_Object process, sentinel;
776 CHECK_PROCESS (process, 0);
777 XPROCESS (process)->sentinel = sentinel;
778 return sentinel;
781 DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
782 1, 1, 0,
783 "Return the sentinel of PROCESS; nil if none.\n\
784 See `set-process-sentinel' for more info on sentinels.")
785 (process)
786 register Lisp_Object process;
788 CHECK_PROCESS (process, 0);
789 return XPROCESS (process)->sentinel;
792 DEFUN ("set-process-window-size", Fset_process_window_size,
793 Sset_process_window_size, 3, 3, 0,
794 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
795 (process, height, width)
796 register Lisp_Object process, height, width;
798 CHECK_PROCESS (process, 0);
799 CHECK_NATNUM (height, 0);
800 CHECK_NATNUM (width, 0);
801 if (set_window_size (XINT (XPROCESS (process)->infd),
802 XINT (height), XINT (width)) <= 0)
803 return Qnil;
804 else
805 return Qt;
808 DEFUN ("set-process-inherit-coding-system-flag",
809 Fset_process_inherit_coding_system_flag,
810 Sset_process_inherit_coding_system_flag, 2, 2, 0,
811 "Determine whether buffer of PROCESS will inherit coding-system.\n\
812 If the second argument FLAG is non-nil, then the variable\n\
813 `buffer-file-coding-system' of the buffer associated with PROCESS\n\
814 will be bound to the value of the coding system used to decode\n\
815 the process output.\n\
817 This is useful when the coding system specified for the process buffer\n\
818 leaves either the character code conversion or the end-of-line conversion\n\
819 unspecified, or if the coding system used to decode the process output\n\
820 is more appropriate for saving the process buffer.\n\
822 Binding the variable `inherit-process-coding-system' to non-nil before\n\
823 starting the process is an alternative way of setting the inherit flag\n\
824 for the process which will run.")
825 (process, flag)
826 register Lisp_Object process, flag;
828 CHECK_PROCESS (process, 0);
829 XPROCESS (process)->inherit_coding_system_flag = flag;
830 return flag;
833 DEFUN ("process-inherit-coding-system-flag",
834 Fprocess_inherit_coding_system_flag, Sprocess_inherit_coding_system_flag,
835 1, 1, 0,
836 "Return the value of inherit-coding-system flag for PROCESS.\n\
837 If this flag is t, `buffer-file-coding-system' of the buffer\n\
838 associated with PROCESS will inherit the coding system used to decode\n\
839 the process output.")
840 (process)
841 register Lisp_Object process;
843 CHECK_PROCESS (process, 0);
844 return XPROCESS (process)->inherit_coding_system_flag;
847 DEFUN ("process-kill-without-query", Fprocess_kill_without_query,
848 Sprocess_kill_without_query, 1, 2, 0,
849 "Say no query needed if PROCESS is running when Emacs is exited.\n\
850 Optional second argument if non-nil says to require a query.\n\
851 Value is t if a query was formerly required.")
852 (process, value)
853 register Lisp_Object process, value;
855 Lisp_Object tem;
857 CHECK_PROCESS (process, 0);
858 tem = XPROCESS (process)->kill_without_query;
859 XPROCESS (process)->kill_without_query = Fnull (value);
861 return Fnull (tem);
864 DEFUN ("process-contact", Fprocess_contact, Sprocess_contact,
865 1, 1, 0,
866 "Return the contact info of PROCESS; t for a real child.\n\
867 For a net connection, the value is a cons cell of the form (HOST SERVICE).")
868 (process)
869 register Lisp_Object process;
871 CHECK_PROCESS (process, 0);
872 return XPROCESS (process)->childp;
875 #if 0 /* Turned off because we don't currently record this info
876 in the process. Perhaps add it. */
877 DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 1, 1, 0,
878 "Return the connection type of PROCESS.\n\
879 The value is nil for a pipe, t or `pty' for a pty, or `stream' for\n\
880 a socket connection.")
881 (process)
882 Lisp_Object process;
884 return XPROCESS (process)->type;
886 #endif
888 Lisp_Object
889 list_processes_1 ()
891 register Lisp_Object tail, tem;
892 Lisp_Object proc, minspace, tem1;
893 register struct Lisp_Process *p;
894 char tembuf[80];
896 XSETFASTINT (minspace, 1);
898 set_buffer_internal (XBUFFER (Vstandard_output));
899 Fbuffer_disable_undo (Vstandard_output);
901 current_buffer->truncate_lines = Qt;
903 write_string ("\
904 Proc Status Buffer Tty Command\n\
905 ---- ------ ------ --- -------\n", -1);
907 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
909 Lisp_Object symbol;
911 proc = Fcdr (Fcar (tail));
912 p = XPROCESS (proc);
913 if (NILP (p->childp))
914 continue;
916 Finsert (1, &p->name);
917 Findent_to (make_number (13), minspace);
919 if (!NILP (p->raw_status_low))
920 update_status (p);
921 symbol = p->status;
922 if (CONSP (p->status))
923 symbol = XCAR (p->status);
926 if (EQ (symbol, Qsignal))
928 Lisp_Object tem;
929 tem = Fcar (Fcdr (p->status));
930 #ifdef VMS
931 if (XINT (tem) < NSIG)
932 write_string (sys_errlist [XINT (tem)], -1);
933 else
934 #endif
935 Fprinc (symbol, Qnil);
937 else if (NETCONN_P (proc))
939 if (EQ (symbol, Qrun))
940 write_string ("open", -1);
941 else if (EQ (symbol, Qexit))
942 write_string ("closed", -1);
943 else
944 Fprinc (symbol, Qnil);
946 else
947 Fprinc (symbol, Qnil);
949 if (EQ (symbol, Qexit))
951 Lisp_Object tem;
952 tem = Fcar (Fcdr (p->status));
953 if (XFASTINT (tem))
955 sprintf (tembuf, " %d", (int) XFASTINT (tem));
956 write_string (tembuf, -1);
960 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
961 remove_process (proc);
963 Findent_to (make_number (22), minspace);
964 if (NILP (p->buffer))
965 insert_string ("(none)");
966 else if (NILP (XBUFFER (p->buffer)->name))
967 insert_string ("(Killed)");
968 else
969 Finsert (1, &XBUFFER (p->buffer)->name);
971 Findent_to (make_number (37), minspace);
973 if (STRINGP (p->tty_name))
974 Finsert (1, &p->tty_name);
975 else
976 insert_string ("(none)");
978 Findent_to (make_number (49), minspace);
980 if (NETCONN_P (proc))
982 sprintf (tembuf, "(network stream connection to %s)\n",
983 XSTRING (XCAR (p->childp))->data);
984 insert_string (tembuf);
986 else
988 tem = p->command;
989 while (1)
991 tem1 = Fcar (tem);
992 Finsert (1, &tem1);
993 tem = Fcdr (tem);
994 if (NILP (tem))
995 break;
996 insert_string (" ");
998 insert_string ("\n");
1001 return Qnil;
1004 DEFUN ("list-processes", Flist_processes, Slist_processes, 0, 0, "",
1005 "Display a list of all processes.\n\
1006 Any process listed as exited or signaled is actually eliminated\n\
1007 after the listing is made.")
1010 internal_with_output_to_temp_buffer ("*Process List*",
1011 list_processes_1, Qnil);
1012 return Qnil;
1015 DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
1016 "Return a list of all processes.")
1019 return Fmapcar (Qcdr, Vprocess_alist);
1022 /* Starting asynchronous inferior processes. */
1024 static Lisp_Object start_process_unwind ();
1026 DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
1027 "Start a program in a subprocess. Return the process object for it.\n\
1028 NAME is name for process. It is modified if necessary to make it unique.\n\
1029 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
1030 Process output goes at end of that buffer, unless you specify\n\
1031 an output stream or filter function to handle the output.\n\
1032 BUFFER may be also nil, meaning that this process is not associated\n\
1033 with any buffer.\n\
1034 Third arg is program file name. It is searched for in PATH.\n\
1035 Remaining arguments are strings to give program as arguments.")
1036 (nargs, args)
1037 int nargs;
1038 register Lisp_Object *args;
1040 Lisp_Object buffer, name, program, proc, current_dir, tem;
1041 #ifdef VMS
1042 register unsigned char *new_argv;
1043 int len;
1044 #else
1045 register unsigned char **new_argv;
1046 #endif
1047 register int i;
1048 int count = specpdl_ptr - specpdl;
1050 buffer = args[1];
1051 if (!NILP (buffer))
1052 buffer = Fget_buffer_create (buffer);
1054 /* Make sure that the child will be able to chdir to the current
1055 buffer's current directory, or its unhandled equivalent. We
1056 can't just have the child check for an error when it does the
1057 chdir, since it's in a vfork.
1059 We have to GCPRO around this because Fexpand_file_name and
1060 Funhandled_file_name_directory might call a file name handling
1061 function. The argument list is protected by the caller, so all
1062 we really have to worry about is buffer. */
1064 struct gcpro gcpro1, gcpro2;
1066 current_dir = current_buffer->directory;
1068 GCPRO2 (buffer, current_dir);
1070 current_dir
1071 = expand_and_dir_to_file (Funhandled_file_name_directory (current_dir),
1072 Qnil);
1073 if (NILP (Ffile_accessible_directory_p (current_dir)))
1074 report_file_error ("Setting current directory",
1075 Fcons (current_buffer->directory, Qnil));
1077 UNGCPRO;
1080 name = args[0];
1081 CHECK_STRING (name, 0);
1083 program = args[2];
1085 CHECK_STRING (program, 2);
1087 proc = make_process (name);
1088 /* If an error occurs and we can't start the process, we want to
1089 remove it from the process list. This means that each error
1090 check in create_process doesn't need to call remove_process
1091 itself; it's all taken care of here. */
1092 record_unwind_protect (start_process_unwind, proc);
1094 XPROCESS (proc)->childp = Qt;
1095 XPROCESS (proc)->command_channel_p = Qnil;
1096 XPROCESS (proc)->buffer = buffer;
1097 XPROCESS (proc)->sentinel = Qnil;
1098 XPROCESS (proc)->filter = Qnil;
1099 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1101 /* Make the process marker point into the process buffer (if any). */
1102 if (!NILP (buffer))
1103 set_marker_both (XPROCESS (proc)->mark, buffer,
1104 BUF_ZV (XBUFFER (buffer)),
1105 BUF_ZV_BYTE (XBUFFER (buffer)));
1108 /* Decide coding systems for communicating with the process. Here
1109 we don't setup the structure coding_system nor pay attention to
1110 unibyte mode. They are done in create_process. */
1112 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
1113 Lisp_Object coding_systems = Qt;
1114 Lisp_Object val, *args2;
1115 struct gcpro gcpro1, gcpro2;
1117 val = Vcoding_system_for_read;
1118 if (NILP (val))
1120 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof *args2);
1121 args2[0] = Qstart_process;
1122 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1123 GCPRO2 (proc, current_dir);
1124 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1125 UNGCPRO;
1126 if (CONSP (coding_systems))
1127 val = XCAR (coding_systems);
1128 else if (CONSP (Vdefault_process_coding_system))
1129 val = XCAR (Vdefault_process_coding_system);
1131 XPROCESS (proc)->decode_coding_system = val;
1133 val = Vcoding_system_for_write;
1134 if (NILP (val))
1136 if (EQ (coding_systems, Qt))
1138 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof args2);
1139 args2[0] = Qstart_process;
1140 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1141 GCPRO2 (proc, current_dir);
1142 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1143 UNGCPRO;
1145 if (CONSP (coding_systems))
1146 val = XCDR (coding_systems);
1147 else if (CONSP (Vdefault_process_coding_system))
1148 val = XCDR (Vdefault_process_coding_system);
1150 XPROCESS (proc)->encode_coding_system = val;
1153 #ifdef VMS
1154 /* Make a one member argv with all args concatenated
1155 together separated by a blank. */
1156 len = STRING_BYTES (XSTRING (program)) + 2;
1157 for (i = 3; i < nargs; i++)
1159 tem = args[i];
1160 CHECK_STRING (tem, i);
1161 len += STRING_BYTES (XSTRING (tem)) + 1; /* count the blank */
1163 new_argv = (unsigned char *) alloca (len);
1164 strcpy (new_argv, XSTRING (program)->data);
1165 for (i = 3; i < nargs; i++)
1167 tem = args[i];
1168 CHECK_STRING (tem, i);
1169 strcat (new_argv, " ");
1170 strcat (new_argv, XSTRING (tem)->data);
1172 /* Need to add code here to check for program existence on VMS */
1174 #else /* not VMS */
1175 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1177 /* If program file name is not absolute, search our path for it */
1178 if (!IS_DIRECTORY_SEP (XSTRING (program)->data[0])
1179 && !(XSTRING (program)->size > 1
1180 && IS_DEVICE_SEP (XSTRING (program)->data[1])))
1182 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1184 tem = Qnil;
1185 GCPRO4 (name, program, buffer, current_dir);
1186 openp (Vexec_path, program, EXEC_SUFFIXES, &tem, 1);
1187 UNGCPRO;
1188 if (NILP (tem))
1189 report_file_error ("Searching for program", Fcons (program, Qnil));
1190 tem = Fexpand_file_name (tem, Qnil);
1191 tem = ENCODE_FILE (tem);
1192 new_argv[0] = XSTRING (tem)->data;
1194 else
1196 if (!NILP (Ffile_directory_p (program)))
1197 error ("Specified program for new process is a directory");
1199 tem = ENCODE_FILE (program);
1200 new_argv[0] = XSTRING (tem)->data;
1203 /* Here we encode arguments by the coding system used for sending
1204 data to the process. We don't support using different coding
1205 systems for encoding arguments and for encoding data sent to the
1206 process. */
1208 for (i = 3; i < nargs; i++)
1210 tem = args[i];
1211 CHECK_STRING (tem, i);
1212 if (STRING_MULTIBYTE (tem))
1213 tem = (code_convert_string_norecord
1214 (tem, XPROCESS (proc)->encode_coding_system, 1));
1215 new_argv[i - 2] = XSTRING (tem)->data;
1217 new_argv[i - 2] = 0;
1218 #endif /* not VMS */
1220 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
1221 XPROCESS (proc)->decoding_carryover = make_number (0);
1222 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
1223 XPROCESS (proc)->encoding_carryover = make_number (0);
1225 XPROCESS (proc)->inherit_coding_system_flag
1226 = (NILP (buffer) || !inherit_process_coding_system
1227 ? Qnil : Qt);
1229 create_process (proc, (char **) new_argv, current_dir);
1231 return unbind_to (count, proc);
1234 /* This function is the unwind_protect form for Fstart_process. If
1235 PROC doesn't have its pid set, then we know someone has signaled
1236 an error and the process wasn't started successfully, so we should
1237 remove it from the process list. */
1238 static Lisp_Object
1239 start_process_unwind (proc)
1240 Lisp_Object proc;
1242 if (!PROCESSP (proc))
1243 abort ();
1245 /* Was PROC started successfully? */
1246 if (XINT (XPROCESS (proc)->pid) <= 0)
1247 remove_process (proc);
1249 return Qnil;
1252 void
1253 create_process_1 (timer)
1254 struct atimer *timer;
1256 /* Nothing to do. */
1260 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1261 #ifdef USG
1262 #ifdef SIGCHLD
1263 /* Mimic blocking of signals on system V, which doesn't really have it. */
1265 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1266 int sigchld_deferred;
1268 SIGTYPE
1269 create_process_sigchld ()
1271 signal (SIGCHLD, create_process_sigchld);
1273 sigchld_deferred = 1;
1275 #endif
1276 #endif
1277 #endif
1279 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1280 void
1281 create_process (process, new_argv, current_dir)
1282 Lisp_Object process;
1283 char **new_argv;
1284 Lisp_Object current_dir;
1286 int pid, inchannel, outchannel;
1287 int sv[2];
1288 #ifdef POSIX_SIGNALS
1289 sigset_t procmask;
1290 sigset_t blocked;
1291 struct sigaction sigint_action;
1292 struct sigaction sigquit_action;
1293 #ifdef AIX
1294 struct sigaction sighup_action;
1295 #endif
1296 #else /* !POSIX_SIGNALS */
1297 #if 0
1298 #ifdef SIGCHLD
1299 SIGTYPE (*sigchld)();
1300 #endif
1301 #endif /* 0 */
1302 #endif /* !POSIX_SIGNALS */
1303 /* Use volatile to protect variables from being clobbered by longjmp. */
1304 volatile int forkin, forkout;
1305 volatile int pty_flag = 0;
1306 #ifndef USE_CRT_DLL
1307 extern char **environ;
1308 #endif
1309 Lisp_Object buffer = XPROCESS (process)->buffer;
1311 inchannel = outchannel = -1;
1313 #ifdef HAVE_PTYS
1314 if (!NILP (Vprocess_connection_type))
1315 outchannel = inchannel = allocate_pty ();
1317 if (inchannel >= 0)
1319 #ifndef USG
1320 /* On USG systems it does not work to open the pty's tty here
1321 and then close and reopen it in the child. */
1322 #ifdef O_NOCTTY
1323 /* Don't let this terminal become our controlling terminal
1324 (in case we don't have one). */
1325 forkout = forkin = emacs_open (pty_name, O_RDWR | O_NOCTTY, 0);
1326 #else
1327 forkout = forkin = emacs_open (pty_name, O_RDWR, 0);
1328 #endif
1329 if (forkin < 0)
1330 report_file_error ("Opening pty", Qnil);
1331 #else
1332 forkin = forkout = -1;
1333 #endif /* not USG */
1334 pty_flag = 1;
1336 else
1337 #endif /* HAVE_PTYS */
1338 #ifdef SKTPAIR
1340 if (socketpair (AF_UNIX, SOCK_STREAM, 0, sv) < 0)
1341 report_file_error ("Opening socketpair", Qnil);
1342 outchannel = inchannel = sv[0];
1343 forkout = forkin = sv[1];
1345 #else /* not SKTPAIR */
1347 int tem;
1348 tem = pipe (sv);
1349 if (tem < 0)
1350 report_file_error ("Creating pipe", Qnil);
1351 inchannel = sv[0];
1352 forkout = sv[1];
1353 tem = pipe (sv);
1354 if (tem < 0)
1356 emacs_close (inchannel);
1357 emacs_close (forkout);
1358 report_file_error ("Creating pipe", Qnil);
1360 outchannel = sv[1];
1361 forkin = sv[0];
1363 #endif /* not SKTPAIR */
1365 #if 0
1366 /* Replaced by close_process_descs */
1367 set_exclusive_use (inchannel);
1368 set_exclusive_use (outchannel);
1369 #endif
1371 /* Stride people say it's a mystery why this is needed
1372 as well as the O_NDELAY, but that it fails without this. */
1373 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1375 int one = 1;
1376 ioctl (inchannel, FIONBIO, &one);
1378 #endif
1380 #ifdef O_NONBLOCK
1381 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1382 fcntl (outchannel, F_SETFL, O_NONBLOCK);
1383 #else
1384 #ifdef O_NDELAY
1385 fcntl (inchannel, F_SETFL, O_NDELAY);
1386 fcntl (outchannel, F_SETFL, O_NDELAY);
1387 #endif
1388 #endif
1390 /* Record this as an active process, with its channels.
1391 As a result, child_setup will close Emacs's side of the pipes. */
1392 chan_process[inchannel] = process;
1393 XSETINT (XPROCESS (process)->infd, inchannel);
1394 XSETINT (XPROCESS (process)->outfd, outchannel);
1395 /* Record the tty descriptor used in the subprocess. */
1396 if (forkin < 0)
1397 XPROCESS (process)->subtty = Qnil;
1398 else
1399 XSETFASTINT (XPROCESS (process)->subtty, forkin);
1400 XPROCESS (process)->pty_flag = (pty_flag ? Qt : Qnil);
1401 XPROCESS (process)->status = Qrun;
1402 if (!proc_decode_coding_system[inchannel])
1403 proc_decode_coding_system[inchannel]
1404 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1405 setup_coding_system (XPROCESS (process)->decode_coding_system,
1406 proc_decode_coding_system[inchannel]);
1407 if (!proc_encode_coding_system[outchannel])
1408 proc_encode_coding_system[outchannel]
1409 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1410 setup_coding_system (XPROCESS (process)->encode_coding_system,
1411 proc_encode_coding_system[outchannel]);
1413 /* Delay interrupts until we have a chance to store
1414 the new fork's pid in its process structure */
1415 #ifdef POSIX_SIGNALS
1416 sigemptyset (&blocked);
1417 #ifdef SIGCHLD
1418 sigaddset (&blocked, SIGCHLD);
1419 #endif
1420 #ifdef HAVE_VFORK
1421 /* On many hosts (e.g. Solaris 2.4), if a vforked child calls `signal',
1422 this sets the parent's signal handlers as well as the child's.
1423 So delay all interrupts whose handlers the child might munge,
1424 and record the current handlers so they can be restored later. */
1425 sigaddset (&blocked, SIGINT ); sigaction (SIGINT , 0, &sigint_action );
1426 sigaddset (&blocked, SIGQUIT); sigaction (SIGQUIT, 0, &sigquit_action);
1427 #ifdef AIX
1428 sigaddset (&blocked, SIGHUP ); sigaction (SIGHUP , 0, &sighup_action );
1429 #endif
1430 #endif /* HAVE_VFORK */
1431 sigprocmask (SIG_BLOCK, &blocked, &procmask);
1432 #else /* !POSIX_SIGNALS */
1433 #ifdef SIGCHLD
1434 #ifdef BSD4_1
1435 sighold (SIGCHLD);
1436 #else /* not BSD4_1 */
1437 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1438 sigsetmask (sigmask (SIGCHLD));
1439 #else /* ordinary USG */
1440 #if 0
1441 sigchld_deferred = 0;
1442 sigchld = signal (SIGCHLD, create_process_sigchld);
1443 #endif
1444 #endif /* ordinary USG */
1445 #endif /* not BSD4_1 */
1446 #endif /* SIGCHLD */
1447 #endif /* !POSIX_SIGNALS */
1449 FD_SET (inchannel, &input_wait_mask);
1450 FD_SET (inchannel, &non_keyboard_wait_mask);
1451 if (inchannel > max_process_desc)
1452 max_process_desc = inchannel;
1454 /* Until we store the proper pid, enable sigchld_handler
1455 to recognize an unknown pid as standing for this process.
1456 It is very important not to let this `marker' value stay
1457 in the table after this function has returned; if it does
1458 it might cause call-process to hang and subsequent asynchronous
1459 processes to get their return values scrambled. */
1460 XSETINT (XPROCESS (process)->pid, -1);
1462 BLOCK_INPUT;
1465 /* child_setup must clobber environ on systems with true vfork.
1466 Protect it from permanent change. */
1467 char **save_environ = environ;
1469 current_dir = ENCODE_FILE (current_dir);
1471 #ifndef WINDOWSNT
1472 pid = vfork ();
1473 if (pid == 0)
1474 #endif /* not WINDOWSNT */
1476 int xforkin = forkin;
1477 int xforkout = forkout;
1479 #if 0 /* This was probably a mistake--it duplicates code later on,
1480 but fails to handle all the cases. */
1481 /* Make sure SIGCHLD is not blocked in the child. */
1482 sigsetmask (SIGEMPTYMASK);
1483 #endif
1485 /* Make the pty be the controlling terminal of the process. */
1486 #ifdef HAVE_PTYS
1487 /* First, disconnect its current controlling terminal. */
1488 #ifdef HAVE_SETSID
1489 /* We tried doing setsid only if pty_flag, but it caused
1490 process_set_signal to fail on SGI when using a pipe. */
1491 setsid ();
1492 /* Make the pty's terminal the controlling terminal. */
1493 if (pty_flag)
1495 #ifdef TIOCSCTTY
1496 /* We ignore the return value
1497 because faith@cs.unc.edu says that is necessary on Linux. */
1498 ioctl (xforkin, TIOCSCTTY, 0);
1499 #endif
1501 #else /* not HAVE_SETSID */
1502 #ifdef USG
1503 /* It's very important to call setpgrp here and no time
1504 afterwards. Otherwise, we lose our controlling tty which
1505 is set when we open the pty. */
1506 setpgrp ();
1507 #endif /* USG */
1508 #endif /* not HAVE_SETSID */
1509 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1510 if (pty_flag && xforkin >= 0)
1512 struct termios t;
1513 tcgetattr (xforkin, &t);
1514 t.c_lflag = LDISC1;
1515 if (tcsetattr (xforkin, TCSANOW, &t) < 0)
1516 emacs_write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1518 #else
1519 #if defined (NTTYDISC) && defined (TIOCSETD)
1520 if (pty_flag && xforkin >= 0)
1522 /* Use new line discipline. */
1523 int ldisc = NTTYDISC;
1524 ioctl (xforkin, TIOCSETD, &ldisc);
1526 #endif
1527 #endif
1528 #ifdef TIOCNOTTY
1529 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1530 can do TIOCSPGRP only to the process's controlling tty. */
1531 if (pty_flag)
1533 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1534 I can't test it since I don't have 4.3. */
1535 int j = emacs_open ("/dev/tty", O_RDWR, 0);
1536 ioctl (j, TIOCNOTTY, 0);
1537 emacs_close (j);
1538 #ifndef USG
1539 /* In order to get a controlling terminal on some versions
1540 of BSD, it is necessary to put the process in pgrp 0
1541 before it opens the terminal. */
1542 #ifdef HAVE_SETPGID
1543 setpgid (0, 0);
1544 #else
1545 setpgrp (0, 0);
1546 #endif
1547 #endif
1549 #endif /* TIOCNOTTY */
1551 #if !defined (RTU) && !defined (UNIPLUS) && !defined (DONT_REOPEN_PTY)
1552 /*** There is a suggestion that this ought to be a
1553 conditional on TIOCSPGRP,
1554 or !(defined (HAVE_SETSID) && defined (TIOCSCTTY)).
1555 Trying the latter gave the wrong results on Debian GNU/Linux 1.1;
1556 that system does seem to need this code, even though
1557 both HAVE_SETSID and TIOCSCTTY are defined. */
1558 /* Now close the pty (if we had it open) and reopen it.
1559 This makes the pty the controlling terminal of the subprocess. */
1560 if (pty_flag)
1562 #ifdef SET_CHILD_PTY_PGRP
1563 int pgrp = getpid ();
1564 #endif
1566 /* I wonder if emacs_close (emacs_open (pty_name, ...))
1567 would work? */
1568 if (xforkin >= 0)
1569 emacs_close (xforkin);
1570 xforkout = xforkin = emacs_open (pty_name, O_RDWR, 0);
1572 if (xforkin < 0)
1574 emacs_write (1, "Couldn't open the pty terminal ", 31);
1575 emacs_write (1, pty_name, strlen (pty_name));
1576 emacs_write (1, "\n", 1);
1577 _exit (1);
1580 #ifdef SET_CHILD_PTY_PGRP
1581 ioctl (xforkin, TIOCSPGRP, &pgrp);
1582 ioctl (xforkout, TIOCSPGRP, &pgrp);
1583 #endif
1585 #endif /* not UNIPLUS and not RTU and not DONT_REOPEN_PTY */
1587 #ifdef SETUP_SLAVE_PTY
1588 if (pty_flag)
1590 SETUP_SLAVE_PTY;
1592 #endif /* SETUP_SLAVE_PTY */
1593 #ifdef AIX
1594 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1595 Now reenable it in the child, so it will die when we want it to. */
1596 if (pty_flag)
1597 signal (SIGHUP, SIG_DFL);
1598 #endif
1599 #endif /* HAVE_PTYS */
1601 signal (SIGINT, SIG_DFL);
1602 signal (SIGQUIT, SIG_DFL);
1604 /* Stop blocking signals in the child. */
1605 #ifdef POSIX_SIGNALS
1606 sigprocmask (SIG_SETMASK, &procmask, 0);
1607 #else /* !POSIX_SIGNALS */
1608 #ifdef SIGCHLD
1609 #ifdef BSD4_1
1610 sigrelse (SIGCHLD);
1611 #else /* not BSD4_1 */
1612 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1613 sigsetmask (SIGEMPTYMASK);
1614 #else /* ordinary USG */
1615 #if 0
1616 signal (SIGCHLD, sigchld);
1617 #endif
1618 #endif /* ordinary USG */
1619 #endif /* not BSD4_1 */
1620 #endif /* SIGCHLD */
1621 #endif /* !POSIX_SIGNALS */
1623 if (pty_flag)
1624 child_setup_tty (xforkout);
1625 #ifdef WINDOWSNT
1626 pid = child_setup (xforkin, xforkout, xforkout,
1627 new_argv, 1, current_dir);
1628 #else /* not WINDOWSNT */
1629 child_setup (xforkin, xforkout, xforkout,
1630 new_argv, 1, current_dir);
1631 #endif /* not WINDOWSNT */
1633 environ = save_environ;
1636 UNBLOCK_INPUT;
1638 /* This runs in the Emacs process. */
1639 if (pid < 0)
1641 if (forkin >= 0)
1642 emacs_close (forkin);
1643 if (forkin != forkout && forkout >= 0)
1644 emacs_close (forkout);
1646 else
1648 /* vfork succeeded. */
1649 XSETFASTINT (XPROCESS (process)->pid, pid);
1651 #ifdef WINDOWSNT
1652 register_child (pid, inchannel);
1653 #endif /* WINDOWSNT */
1655 /* If the subfork execv fails, and it exits,
1656 this close hangs. I don't know why.
1657 So have an interrupt jar it loose. */
1659 struct atimer *timer;
1660 EMACS_TIME offset;
1662 stop_polling ();
1663 EMACS_SET_SECS_USECS (offset, 1, 0);
1664 timer = start_atimer (ATIMER_RELATIVE, offset, create_process_1, 0);
1666 XPROCESS (process)->subtty = Qnil;
1667 if (forkin >= 0)
1668 emacs_close (forkin);
1670 cancel_atimer (timer);
1671 start_polling ();
1674 if (forkin != forkout && forkout >= 0)
1675 emacs_close (forkout);
1677 #ifdef HAVE_PTYS
1678 if (pty_flag)
1679 XPROCESS (process)->tty_name = build_string (pty_name);
1680 else
1681 #endif
1682 XPROCESS (process)->tty_name = Qnil;
1685 /* Restore the signal state whether vfork succeeded or not.
1686 (We will signal an error, below, if it failed.) */
1687 #ifdef POSIX_SIGNALS
1688 #ifdef HAVE_VFORK
1689 /* Restore the parent's signal handlers. */
1690 sigaction (SIGINT, &sigint_action, 0);
1691 sigaction (SIGQUIT, &sigquit_action, 0);
1692 #ifdef AIX
1693 sigaction (SIGHUP, &sighup_action, 0);
1694 #endif
1695 #endif /* HAVE_VFORK */
1696 /* Stop blocking signals in the parent. */
1697 sigprocmask (SIG_SETMASK, &procmask, 0);
1698 #else /* !POSIX_SIGNALS */
1699 #ifdef SIGCHLD
1700 #ifdef BSD4_1
1701 sigrelse (SIGCHLD);
1702 #else /* not BSD4_1 */
1703 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1704 sigsetmask (SIGEMPTYMASK);
1705 #else /* ordinary USG */
1706 #if 0
1707 signal (SIGCHLD, sigchld);
1708 /* Now really handle any of these signals
1709 that came in during this function. */
1710 if (sigchld_deferred)
1711 kill (getpid (), SIGCHLD);
1712 #endif
1713 #endif /* ordinary USG */
1714 #endif /* not BSD4_1 */
1715 #endif /* SIGCHLD */
1716 #endif /* !POSIX_SIGNALS */
1718 /* Now generate the error if vfork failed. */
1719 if (pid < 0)
1720 report_file_error ("Doing vfork", Qnil);
1722 #endif /* not VMS */
1724 #ifdef HAVE_SOCKETS
1726 /* open a TCP network connection to a given HOST/SERVICE. Treated
1727 exactly like a normal process when reading and writing. Only
1728 differences are in status display and process deletion. A network
1729 connection has no PID; you cannot signal it. All you can do is
1730 deactivate and close it via delete-process */
1732 DEFUN ("open-network-stream", Fopen_network_stream, Sopen_network_stream,
1733 4, 4, 0,
1734 "Open a TCP connection for a service to a host.\n\
1735 Returns a subprocess-object to represent the connection.\n\
1736 Input and output work as for subprocesses; `delete-process' closes it.\n\
1737 Args are NAME BUFFER HOST SERVICE.\n\
1738 NAME is name for process. It is modified if necessary to make it unique.\n\
1739 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1740 Process output goes at end of that buffer, unless you specify\n\
1741 an output stream or filter function to handle the output.\n\
1742 BUFFER may be also nil, meaning that this process is not associated\n\
1743 with any buffer\n\
1744 Third arg is name of the host to connect to, or its IP address.\n\
1745 Fourth arg SERVICE is name of the service desired, or an integer\n\
1746 specifying a port number to connect to.")
1747 (name, buffer, host, service)
1748 Lisp_Object name, buffer, host, service;
1750 Lisp_Object proc;
1751 #ifdef HAVE_GETADDRINFO
1752 struct addrinfo hints, *res, *lres;
1753 int ret = 0;
1754 int xerrno = 0;
1755 char *portstring, portbuf[128];
1756 #else /* HAVE_GETADDRINFO */
1757 struct sockaddr_in address;
1758 struct servent *svc_info;
1759 struct hostent *host_info_ptr, host_info;
1760 char *(addr_list[2]);
1761 IN_ADDR numeric_addr;
1762 int port;
1763 #endif /* HAVE_GETADDRINFO */
1764 int s = -1, outch, inch;
1765 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1766 int retry = 0;
1767 int count = specpdl_ptr - specpdl;
1768 int count1;
1770 #ifdef WINDOWSNT
1771 /* Ensure socket support is loaded if available. */
1772 init_winsock (TRUE);
1773 #endif
1775 GCPRO4 (name, buffer, host, service);
1776 CHECK_STRING (name, 0);
1777 CHECK_STRING (host, 0);
1779 #ifdef HAVE_GETADDRINFO
1780 /* SERVICE can either be a string or int.
1781 Convert to a C string for later use by getaddrinfo. */
1782 if (INTEGERP (service))
1784 sprintf (portbuf, "%ld", (long) XINT (service));
1785 portstring = portbuf;
1787 else
1789 CHECK_STRING (service, 0);
1790 portstring = XSTRING (service)->data;
1792 #else /* HAVE_GETADDRINFO */
1793 if (INTEGERP (service))
1794 port = htons ((unsigned short) XINT (service));
1795 else
1797 CHECK_STRING (service, 0);
1798 svc_info = getservbyname (XSTRING (service)->data, "tcp");
1799 if (svc_info == 0)
1800 error ("Unknown service \"%s\"", XSTRING (service)->data);
1801 port = svc_info->s_port;
1803 #endif /* HAVE_GETADDRINFO */
1806 /* Slow down polling to every ten seconds.
1807 Some kernels have a bug which causes retrying connect to fail
1808 after a connect. Polling can interfere with gethostbyname too. */
1809 #ifdef POLL_FOR_INPUT
1810 record_unwind_protect (unwind_stop_other_atimers, Qnil);
1811 bind_polling_period (10);
1812 #endif
1814 #ifndef TERM
1815 #ifdef HAVE_GETADDRINFO
1816 immediate_quit = 1;
1817 QUIT;
1818 memset (&hints, 0, sizeof (hints));
1819 hints.ai_flags = 0;
1820 hints.ai_family = AF_UNSPEC;
1821 hints.ai_socktype = SOCK_STREAM;
1822 hints.ai_protocol = 0;
1823 ret = getaddrinfo (XSTRING (host)->data, portstring, &hints, &res);
1824 if (ret)
1825 #ifdef HAVE_GAI_STRERROR
1826 error ("%s/%s %s", XSTRING (host)->data, portstring, gai_strerror(ret));
1827 #else
1828 error ("%s/%s getaddrinfo error %d", XSTRING (host)->data, portstring,
1829 ret);
1830 #endif
1831 immediate_quit = 0;
1833 /* Do this in case we never enter the for-loop below. */
1834 count1 = specpdl_ptr - specpdl;
1835 s = -1;
1837 for (lres = res; lres; lres = lres->ai_next)
1839 s = socket (lres->ai_family, lres->ai_socktype, lres->ai_protocol);
1840 if (s < 0)
1842 xerrno = errno;
1843 continue;
1846 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1847 when connect is interrupted. So let's not let it get interrupted.
1848 Note we do not turn off polling, because polling is only used
1849 when not interrupt_input, and thus not normally used on the systems
1850 which have this bug. On systems which use polling, there's no way
1851 to quit if polling is turned off. */
1852 if (interrupt_input)
1853 unrequest_sigio ();
1855 /* Make us close S if quit. */
1856 count1 = specpdl_ptr - specpdl;
1857 record_unwind_protect (close_file_unwind, make_number (s));
1859 loop:
1861 immediate_quit = 1;
1862 QUIT;
1864 /* This turns off all alarm-based interrupts; the
1865 bind_polling_period call above doesn't always turn all the
1866 short-interval ones off, especially if interrupt_input is
1867 set.
1869 It'd be nice to be able to control the connect timeout
1870 though. Would non-blocking connect calls be portable? */
1871 turn_on_atimers (0);
1872 ret = connect (s, lres->ai_addr, lres->ai_addrlen);
1873 xerrno = errno;
1874 turn_on_atimers (1);
1876 if (ret == 0 || xerrno == EISCONN)
1877 /* The unwind-protect will be discarded afterwards.
1878 Likewise for immediate_quit. */
1879 break;
1881 immediate_quit = 0;
1883 if (xerrno == EINTR)
1884 goto loop;
1885 if (xerrno == EADDRINUSE && retry < 20)
1887 /* A delay here is needed on some FreeBSD systems,
1888 and it is harmless, since this retrying takes time anyway
1889 and should be infrequent. */
1890 Fsleep_for (make_number (1), Qnil);
1891 retry++;
1892 goto loop;
1895 /* Discard the unwind protect closing S. */
1896 specpdl_ptr = specpdl + count1;
1897 count1 = specpdl_ptr - specpdl;
1899 emacs_close (s);
1900 s = -1;
1903 freeaddrinfo (res);
1904 if (s < 0)
1906 if (interrupt_input)
1907 request_sigio ();
1909 errno = xerrno;
1910 report_file_error ("connection failed",
1911 Fcons (host, Fcons (name, Qnil)));
1914 #else /* not HAVE_GETADDRINFO */
1916 while (1)
1918 #if 0
1919 #ifdef TRY_AGAIN
1920 h_errno = 0;
1921 #endif
1922 #endif
1923 immediate_quit = 1;
1924 QUIT;
1925 host_info_ptr = gethostbyname (XSTRING (host)->data);
1926 immediate_quit = 0;
1927 #if 0
1928 #ifdef TRY_AGAIN
1929 if (! (host_info_ptr == 0 && h_errno == TRY_AGAIN))
1930 #endif
1931 #endif
1932 break;
1933 Fsleep_for (make_number (1), Qnil);
1936 if (host_info_ptr == 0)
1937 /* Attempt to interpret host as numeric inet address */
1939 numeric_addr = inet_addr ((char *) XSTRING (host)->data);
1940 if (NUMERIC_ADDR_ERROR)
1941 error ("Unknown host \"%s\"", XSTRING (host)->data);
1943 host_info_ptr = &host_info;
1944 host_info.h_name = 0;
1945 host_info.h_aliases = 0;
1946 host_info.h_addrtype = AF_INET;
1947 #ifdef h_addr
1948 /* Older machines have only one address slot called h_addr.
1949 Newer machines have h_addr_list, but #define h_addr to
1950 be its first element. */
1951 host_info.h_addr_list = &(addr_list[0]);
1952 #endif
1953 host_info.h_addr = (char*)(&numeric_addr);
1954 addr_list[1] = 0;
1955 /* numeric_addr isn't null-terminated; it has fixed length. */
1956 host_info.h_length = sizeof (numeric_addr);
1959 bzero (&address, sizeof address);
1960 bcopy (host_info_ptr->h_addr, (char *) &address.sin_addr,
1961 host_info_ptr->h_length);
1962 address.sin_family = host_info_ptr->h_addrtype;
1963 address.sin_port = port;
1965 s = socket (host_info_ptr->h_addrtype, SOCK_STREAM, 0);
1966 if (s < 0)
1967 report_file_error ("error creating socket", Fcons (name, Qnil));
1969 count1 = specpdl_ptr - specpdl;
1970 record_unwind_protect (close_file_unwind, make_number (s));
1972 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1973 when connect is interrupted. So let's not let it get interrupted.
1974 Note we do not turn off polling, because polling is only used
1975 when not interrupt_input, and thus not normally used on the systems
1976 which have this bug. On systems which use polling, there's no way
1977 to quit if polling is turned off. */
1978 if (interrupt_input)
1979 unrequest_sigio ();
1981 loop:
1983 immediate_quit = 1;
1984 QUIT;
1986 if (connect (s, (struct sockaddr *) &address, sizeof address) == -1
1987 && errno != EISCONN)
1989 int xerrno = errno;
1991 immediate_quit = 0;
1993 if (errno == EINTR)
1994 goto loop;
1995 if (errno == EADDRINUSE && retry < 20)
1997 /* A delay here is needed on some FreeBSD systems,
1998 and it is harmless, since this retrying takes time anyway
1999 and should be infrequent. */
2000 Fsleep_for (make_number (1), Qnil);
2001 retry++;
2002 goto loop;
2005 /* Discard the unwind protect. */
2006 specpdl_ptr = specpdl + count1;
2008 emacs_close (s);
2010 if (interrupt_input)
2011 request_sigio ();
2013 errno = xerrno;
2014 report_file_error ("connection failed",
2015 Fcons (host, Fcons (name, Qnil)));
2018 #endif /* not HAVE_GETADDRINFO */
2020 immediate_quit = 0;
2022 /* Discard the unwind protect, if any. */
2023 specpdl_ptr = specpdl + count1;
2025 #ifdef POLL_FOR_INPUT
2026 unbind_to (count, Qnil);
2027 #endif
2029 if (interrupt_input)
2030 request_sigio ();
2032 #else /* TERM */
2033 s = connect_server (0);
2034 if (s < 0)
2035 report_file_error ("error creating socket", Fcons (name, Qnil));
2036 send_command (s, C_PORT, 0, "%s:%d", XSTRING (host)->data, ntohs (port));
2037 send_command (s, C_DUMB, 1, 0);
2038 #endif /* TERM */
2040 inch = s;
2041 outch = s;
2043 if (!NILP (buffer))
2044 buffer = Fget_buffer_create (buffer);
2045 proc = make_process (name);
2047 chan_process[inch] = proc;
2049 #ifdef O_NONBLOCK
2050 fcntl (inch, F_SETFL, O_NONBLOCK);
2051 #else
2052 #ifdef O_NDELAY
2053 fcntl (inch, F_SETFL, O_NDELAY);
2054 #endif
2055 #endif
2057 XPROCESS (proc)->childp = Fcons (host, Fcons (service, Qnil));
2058 XPROCESS (proc)->command_channel_p = Qnil;
2059 XPROCESS (proc)->buffer = buffer;
2060 XPROCESS (proc)->sentinel = Qnil;
2061 XPROCESS (proc)->filter = Qnil;
2062 XPROCESS (proc)->command = Qnil;
2063 XPROCESS (proc)->pid = Qnil;
2064 XSETINT (XPROCESS (proc)->infd, inch);
2065 XSETINT (XPROCESS (proc)->outfd, outch);
2066 XPROCESS (proc)->status = Qrun;
2067 FD_SET (inch, &input_wait_mask);
2068 FD_SET (inch, &non_keyboard_wait_mask);
2069 if (inch > max_process_desc)
2070 max_process_desc = inch;
2073 /* Setup coding systems for communicating with the network stream. */
2074 struct gcpro gcpro1;
2075 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
2076 Lisp_Object coding_systems = Qt;
2077 Lisp_Object args[5], val;
2079 if (!NILP (Vcoding_system_for_read))
2080 val = Vcoding_system_for_read;
2081 else if ((!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters))
2082 || (NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters)))
2083 /* We dare not decode end-of-line format by setting VAL to
2084 Qraw_text, because the existing Emacs Lisp libraries
2085 assume that they receive bare code including a sequene of
2086 CR LF. */
2087 val = Qnil;
2088 else
2090 args[0] = Qopen_network_stream, args[1] = name,
2091 args[2] = buffer, args[3] = host, args[4] = service;
2092 GCPRO1 (proc);
2093 coding_systems = Ffind_operation_coding_system (5, args);
2094 UNGCPRO;
2095 if (CONSP (coding_systems))
2096 val = XCAR (coding_systems);
2097 else if (CONSP (Vdefault_process_coding_system))
2098 val = XCAR (Vdefault_process_coding_system);
2099 else
2100 val = Qnil;
2102 XPROCESS (proc)->decode_coding_system = val;
2104 if (!NILP (Vcoding_system_for_write))
2105 val = Vcoding_system_for_write;
2106 else if (NILP (current_buffer->enable_multibyte_characters))
2107 val = Qnil;
2108 else
2110 if (EQ (coding_systems, Qt))
2112 args[0] = Qopen_network_stream, args[1] = name,
2113 args[2] = buffer, args[3] = host, args[4] = service;
2114 GCPRO1 (proc);
2115 coding_systems = Ffind_operation_coding_system (5, args);
2116 UNGCPRO;
2118 if (CONSP (coding_systems))
2119 val = XCDR (coding_systems);
2120 else if (CONSP (Vdefault_process_coding_system))
2121 val = XCDR (Vdefault_process_coding_system);
2122 else
2123 val = Qnil;
2125 XPROCESS (proc)->encode_coding_system = val;
2128 if (!proc_decode_coding_system[inch])
2129 proc_decode_coding_system[inch]
2130 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
2131 setup_coding_system (XPROCESS (proc)->decode_coding_system,
2132 proc_decode_coding_system[inch]);
2133 if (!proc_encode_coding_system[outch])
2134 proc_encode_coding_system[outch]
2135 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
2136 setup_coding_system (XPROCESS (proc)->encode_coding_system,
2137 proc_encode_coding_system[outch]);
2139 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
2140 XPROCESS (proc)->decoding_carryover = make_number (0);
2141 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
2142 XPROCESS (proc)->encoding_carryover = make_number (0);
2144 XPROCESS (proc)->inherit_coding_system_flag
2145 = (NILP (buffer) || !inherit_process_coding_system
2146 ? Qnil : Qt);
2148 UNGCPRO;
2149 return proc;
2151 #endif /* HAVE_SOCKETS */
2153 void
2154 deactivate_process (proc)
2155 Lisp_Object proc;
2157 register int inchannel, outchannel;
2158 register struct Lisp_Process *p = XPROCESS (proc);
2160 inchannel = XINT (p->infd);
2161 outchannel = XINT (p->outfd);
2163 if (inchannel >= 0)
2165 /* Beware SIGCHLD hereabouts. */
2166 flush_pending_output (inchannel);
2167 #ifdef VMS
2169 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
2170 sys$dassgn (outchannel);
2171 vs = get_vms_process_pointer (p->pid);
2172 if (vs)
2173 give_back_vms_process_stuff (vs);
2175 #else
2176 emacs_close (inchannel);
2177 if (outchannel >= 0 && outchannel != inchannel)
2178 emacs_close (outchannel);
2179 #endif
2181 XSETINT (p->infd, -1);
2182 XSETINT (p->outfd, -1);
2183 chan_process[inchannel] = Qnil;
2184 FD_CLR (inchannel, &input_wait_mask);
2185 FD_CLR (inchannel, &non_keyboard_wait_mask);
2186 if (inchannel == max_process_desc)
2188 int i;
2189 /* We just closed the highest-numbered process input descriptor,
2190 so recompute the highest-numbered one now. */
2191 max_process_desc = 0;
2192 for (i = 0; i < MAXDESC; i++)
2193 if (!NILP (chan_process[i]))
2194 max_process_desc = i;
2199 /* Close all descriptors currently in use for communication
2200 with subprocess. This is used in a newly-forked subprocess
2201 to get rid of irrelevant descriptors. */
2203 void
2204 close_process_descs ()
2206 #ifndef WINDOWSNT
2207 int i;
2208 for (i = 0; i < MAXDESC; i++)
2210 Lisp_Object process;
2211 process = chan_process[i];
2212 if (!NILP (process))
2214 int in = XINT (XPROCESS (process)->infd);
2215 int out = XINT (XPROCESS (process)->outfd);
2216 if (in >= 0)
2217 emacs_close (in);
2218 if (out >= 0 && in != out)
2219 emacs_close (out);
2222 #endif
2225 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
2226 0, 3, 0,
2227 "Allow any pending output from subprocesses to be read by Emacs.\n\
2228 It is read into the process' buffers or given to their filter functions.\n\
2229 Non-nil arg PROCESS means do not return until some output has been received\n\
2230 from PROCESS.\n\
2231 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
2232 seconds and microseconds to wait; return after that much time whether\n\
2233 or not there is input.\n\
2234 Return non-nil iff we received any output before the timeout expired.")
2235 (process, timeout, timeout_msecs)
2236 register Lisp_Object process, timeout, timeout_msecs;
2238 int seconds;
2239 int useconds;
2241 if (! NILP (process))
2242 CHECK_PROCESS (process, 0);
2244 if (! NILP (timeout_msecs))
2246 CHECK_NUMBER (timeout_msecs, 2);
2247 useconds = XINT (timeout_msecs);
2248 if (!INTEGERP (timeout))
2249 XSETINT (timeout, 0);
2252 int carry = useconds / 1000000;
2254 XSETINT (timeout, XINT (timeout) + carry);
2255 useconds -= carry * 1000000;
2257 /* I think this clause is necessary because C doesn't
2258 guarantee a particular rounding direction for negative
2259 integers. */
2260 if (useconds < 0)
2262 XSETINT (timeout, XINT (timeout) - 1);
2263 useconds += 1000000;
2267 else
2268 useconds = 0;
2270 if (! NILP (timeout))
2272 CHECK_NUMBER (timeout, 1);
2273 seconds = XINT (timeout);
2274 if (seconds < 0 || (seconds == 0 && useconds == 0))
2275 seconds = -1;
2277 else
2279 if (NILP (process))
2280 seconds = -1;
2281 else
2282 seconds = 0;
2285 if (NILP (process))
2286 XSETFASTINT (process, 0);
2288 return
2289 (wait_reading_process_input (seconds, useconds, process, 0)
2290 ? Qt : Qnil);
2293 /* This variable is different from waiting_for_input in keyboard.c.
2294 It is used to communicate to a lisp process-filter/sentinel (via the
2295 function Fwaiting_for_user_input_p below) whether emacs was waiting
2296 for user-input when that process-filter was called.
2297 waiting_for_input cannot be used as that is by definition 0 when
2298 lisp code is being evalled.
2299 This is also used in record_asynch_buffer_change.
2300 For that purpose, this must be 0
2301 when not inside wait_reading_process_input. */
2302 static int waiting_for_user_input_p;
2304 /* This is here so breakpoints can be put on it. */
2305 static void
2306 wait_reading_process_input_1 ()
2310 /* Read and dispose of subprocess output while waiting for timeout to
2311 elapse and/or keyboard input to be available.
2313 TIME_LIMIT is:
2314 timeout in seconds, or
2315 zero for no limit, or
2316 -1 means gobble data immediately available but don't wait for any.
2318 MICROSECS is:
2319 an additional duration to wait, measured in microseconds.
2320 If this is nonzero and time_limit is 0, then the timeout
2321 consists of MICROSECS only.
2323 READ_KBD is a lisp value:
2324 0 to ignore keyboard input, or
2325 1 to return when input is available, or
2326 -1 meaning caller will actually read the input, so don't throw to
2327 the quit handler, or
2328 a cons cell, meaning wait until its car is non-nil
2329 (and gobble terminal input into the buffer if any arrives), or
2330 a process object, meaning wait until something arrives from that
2331 process. The return value is true iff we read some input from
2332 that process.
2334 DO_DISPLAY != 0 means redisplay should be done to show subprocess
2335 output that arrives.
2337 If READ_KBD is a pointer to a struct Lisp_Process, then the
2338 function returns true iff we received input from that process
2339 before the timeout elapsed.
2340 Otherwise, return true iff we received input from any process. */
2343 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
2344 int time_limit, microsecs;
2345 Lisp_Object read_kbd;
2346 int do_display;
2348 register int channel, nfds;
2349 static SELECT_TYPE Available;
2350 int xerrno;
2351 Lisp_Object proc;
2352 EMACS_TIME timeout, end_time;
2353 SELECT_TYPE Atemp;
2354 int wait_channel = -1;
2355 struct Lisp_Process *wait_proc = 0;
2356 int got_some_input = 0;
2357 Lisp_Object *wait_for_cell = 0;
2359 FD_ZERO (&Available);
2361 /* If read_kbd is a process to watch, set wait_proc and wait_channel
2362 accordingly. */
2363 if (PROCESSP (read_kbd))
2365 wait_proc = XPROCESS (read_kbd);
2366 wait_channel = XINT (wait_proc->infd);
2367 XSETFASTINT (read_kbd, 0);
2370 /* If waiting for non-nil in a cell, record where. */
2371 if (CONSP (read_kbd))
2373 wait_for_cell = &XCAR (read_kbd);
2374 XSETFASTINT (read_kbd, 0);
2377 waiting_for_user_input_p = XINT (read_kbd);
2379 /* Since we may need to wait several times,
2380 compute the absolute time to return at. */
2381 if (time_limit || microsecs)
2383 EMACS_GET_TIME (end_time);
2384 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
2385 EMACS_ADD_TIME (end_time, end_time, timeout);
2387 #ifdef hpux
2388 /* AlainF 5-Jul-1996
2389 HP-UX 10.10 seem to have problems with signals coming in
2390 Causes "poll: interrupted system call" messages when Emacs is run
2391 in an X window
2392 Turn off periodic alarms (in case they are in use) */
2393 turn_on_atimers (0);
2394 #endif
2396 while (1)
2398 int timeout_reduced_for_timers = 0;
2400 /* If calling from keyboard input, do not quit
2401 since we want to return C-g as an input character.
2402 Otherwise, do pending quit if requested. */
2403 if (XINT (read_kbd) >= 0)
2404 QUIT;
2406 /* Exit now if the cell we're waiting for became non-nil. */
2407 if (wait_for_cell && ! NILP (*wait_for_cell))
2408 break;
2410 /* Compute time from now till when time limit is up */
2411 /* Exit if already run out */
2412 if (time_limit == -1)
2414 /* -1 specified for timeout means
2415 gobble output available now
2416 but don't wait at all. */
2418 EMACS_SET_SECS_USECS (timeout, 0, 0);
2420 else if (time_limit || microsecs)
2422 EMACS_GET_TIME (timeout);
2423 EMACS_SUB_TIME (timeout, end_time, timeout);
2424 if (EMACS_TIME_NEG_P (timeout))
2425 break;
2427 else
2429 EMACS_SET_SECS_USECS (timeout, 100000, 0);
2432 /* Normally we run timers here.
2433 But not if wait_for_cell; in those cases,
2434 the wait is supposed to be short,
2435 and those callers cannot handle running arbitrary Lisp code here. */
2436 if (! wait_for_cell)
2438 EMACS_TIME timer_delay;
2439 int old_timers_run;
2441 retry:
2442 old_timers_run = timers_run;
2443 timer_delay = timer_check (1);
2444 if (timers_run != old_timers_run && do_display)
2446 redisplay_preserve_echo_area ();
2447 /* We must retry, since a timer may have requeued itself
2448 and that could alter the time_delay. */
2449 goto retry;
2452 /* If there is unread keyboard input, also return. */
2453 if (XINT (read_kbd) != 0
2454 && requeued_events_pending_p ())
2455 break;
2457 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
2459 EMACS_TIME difference;
2460 EMACS_SUB_TIME (difference, timer_delay, timeout);
2461 if (EMACS_TIME_NEG_P (difference))
2463 timeout = timer_delay;
2464 timeout_reduced_for_timers = 1;
2467 /* If time_limit is -1, we are not going to wait at all. */
2468 else if (time_limit != -1)
2470 /* This is so a breakpoint can be put here. */
2471 wait_reading_process_input_1 ();
2475 /* Cause C-g and alarm signals to take immediate action,
2476 and cause input available signals to zero out timeout.
2478 It is important that we do this before checking for process
2479 activity. If we get a SIGCHLD after the explicit checks for
2480 process activity, timeout is the only way we will know. */
2481 if (XINT (read_kbd) < 0)
2482 set_waiting_for_input (&timeout);
2484 /* If status of something has changed, and no input is
2485 available, notify the user of the change right away. After
2486 this explicit check, we'll let the SIGCHLD handler zap
2487 timeout to get our attention. */
2488 if (update_tick != process_tick && do_display)
2490 Atemp = input_wait_mask;
2491 EMACS_SET_SECS_USECS (timeout, 0, 0);
2492 if ((select (max (max_process_desc, max_keyboard_desc) + 1,
2493 &Atemp, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2494 &timeout)
2495 <= 0))
2497 /* It's okay for us to do this and then continue with
2498 the loop, since timeout has already been zeroed out. */
2499 clear_waiting_for_input ();
2500 status_notify ();
2504 /* Don't wait for output from a non-running process. */
2505 if (wait_proc != 0 && !NILP (wait_proc->raw_status_low))
2506 update_status (wait_proc);
2507 if (wait_proc != 0
2508 && ! EQ (wait_proc->status, Qrun))
2510 int nread, total_nread = 0;
2512 clear_waiting_for_input ();
2513 XSETPROCESS (proc, wait_proc);
2515 /* Read data from the process, until we exhaust it. */
2516 while (XINT (wait_proc->infd) >= 0)
2518 nread = read_process_output (proc, XINT (wait_proc->infd));
2520 if (nread == 0)
2521 break;
2523 if (0 < nread)
2524 total_nread += nread;
2525 #ifdef EIO
2526 else if (nread == -1 && EIO == errno)
2527 break;
2528 #endif
2529 #ifdef EAGAIN
2530 else if (nread == -1 && EAGAIN == errno)
2531 break;
2532 #endif
2533 #ifdef EWOULDBLOCK
2534 else if (nread == -1 && EWOULDBLOCK == errno)
2535 break;
2536 #endif
2538 if (total_nread > 0 && do_display)
2539 redisplay_preserve_echo_area ();
2541 break;
2544 /* Wait till there is something to do */
2546 if (wait_for_cell)
2547 Available = non_process_wait_mask;
2548 else if (! XINT (read_kbd))
2549 Available = non_keyboard_wait_mask;
2550 else
2551 Available = input_wait_mask;
2553 /* If frame size has changed or the window is newly mapped,
2554 redisplay now, before we start to wait. There is a race
2555 condition here; if a SIGIO arrives between now and the select
2556 and indicates that a frame is trashed, the select may block
2557 displaying a trashed screen. */
2558 if (frame_garbaged && do_display)
2560 clear_waiting_for_input ();
2561 redisplay_preserve_echo_area ();
2562 if (XINT (read_kbd) < 0)
2563 set_waiting_for_input (&timeout);
2566 if (XINT (read_kbd) && detect_input_pending ())
2568 nfds = 0;
2569 FD_ZERO (&Available);
2571 else
2572 nfds = select (max (max_process_desc, max_keyboard_desc) + 1,
2573 &Available, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2574 &timeout);
2576 xerrno = errno;
2578 /* Make C-g and alarm signals set flags again */
2579 clear_waiting_for_input ();
2581 /* If we woke up due to SIGWINCH, actually change size now. */
2582 do_pending_window_change (0);
2584 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
2585 /* We wanted the full specified time, so return now. */
2586 break;
2587 if (nfds < 0)
2589 if (xerrno == EINTR)
2590 FD_ZERO (&Available);
2591 #ifdef ultrix
2592 /* Ultrix select seems to return ENOMEM when it is
2593 interrupted. Treat it just like EINTR. Bleah. Note
2594 that we want to test for the "ultrix" CPP symbol, not
2595 "__ultrix__"; the latter is only defined under GCC, but
2596 not by DEC's bundled CC. -JimB */
2597 else if (xerrno == ENOMEM)
2598 FD_ZERO (&Available);
2599 #endif
2600 #ifdef ALLIANT
2601 /* This happens for no known reason on ALLIANT.
2602 I am guessing that this is the right response. -- RMS. */
2603 else if (xerrno == EFAULT)
2604 FD_ZERO (&Available);
2605 #endif
2606 else if (xerrno == EBADF)
2608 #ifdef AIX
2609 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
2610 the child's closure of the pts gives the parent a SIGHUP, and
2611 the ptc file descriptor is automatically closed,
2612 yielding EBADF here or at select() call above.
2613 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
2614 in m/ibmrt-aix.h), and here we just ignore the select error.
2615 Cleanup occurs c/o status_notify after SIGCLD. */
2616 FD_ZERO (&Available); /* Cannot depend on values returned */
2617 #else
2618 abort ();
2619 #endif
2621 else
2622 error ("select error: %s", emacs_strerror (xerrno));
2624 #if defined(sun) && !defined(USG5_4)
2625 else if (nfds > 0 && keyboard_bit_set (&Available)
2626 && interrupt_input)
2627 /* System sometimes fails to deliver SIGIO.
2629 David J. Mackenzie says that Emacs doesn't compile under
2630 Solaris if this code is enabled, thus the USG5_4 in the CPP
2631 conditional. "I haven't noticed any ill effects so far.
2632 If you find a Solaris expert somewhere, they might know
2633 better." */
2634 kill (getpid (), SIGIO);
2635 #endif
2637 #if 0 /* When polling is used, interrupt_input is 0,
2638 so get_input_pending should read the input.
2639 So this should not be needed. */
2640 /* If we are using polling for input,
2641 and we see input available, make it get read now.
2642 Otherwise it might not actually get read for a second.
2643 And on hpux, since we turn off polling in wait_reading_process_input,
2644 it might never get read at all if we don't spend much time
2645 outside of wait_reading_process_input. */
2646 if (XINT (read_kbd) && interrupt_input
2647 && keyboard_bit_set (&Available)
2648 && input_polling_used ())
2649 kill (getpid (), SIGALRM);
2650 #endif
2652 /* Check for keyboard input */
2653 /* If there is any, return immediately
2654 to give it higher priority than subprocesses */
2656 if (XINT (read_kbd) != 0
2657 && detect_input_pending_run_timers (do_display))
2659 swallow_events (do_display);
2660 if (detect_input_pending_run_timers (do_display))
2661 break;
2664 /* If there is unread keyboard input, also return. */
2665 if (XINT (read_kbd) != 0
2666 && requeued_events_pending_p ())
2667 break;
2669 /* If we are not checking for keyboard input now,
2670 do process events (but don't run any timers).
2671 This is so that X events will be processed.
2672 Otherwise they may have to wait until polling takes place.
2673 That would causes delays in pasting selections, for example.
2675 (We used to do this only if wait_for_cell.) */
2676 if (XINT (read_kbd) == 0 && detect_input_pending ())
2678 swallow_events (do_display);
2679 #if 0 /* Exiting when read_kbd doesn't request that seems wrong, though. */
2680 if (detect_input_pending ())
2681 break;
2682 #endif
2685 /* Exit now if the cell we're waiting for became non-nil. */
2686 if (wait_for_cell && ! NILP (*wait_for_cell))
2687 break;
2689 #ifdef SIGIO
2690 /* If we think we have keyboard input waiting, but didn't get SIGIO,
2691 go read it. This can happen with X on BSD after logging out.
2692 In that case, there really is no input and no SIGIO,
2693 but select says there is input. */
2695 if (XINT (read_kbd) && interrupt_input
2696 && keyboard_bit_set (&Available))
2697 kill (getpid (), SIGIO);
2698 #endif
2700 if (! wait_proc)
2701 got_some_input |= nfds > 0;
2703 /* If checking input just got us a size-change event from X,
2704 obey it now if we should. */
2705 if (XINT (read_kbd) || wait_for_cell)
2706 do_pending_window_change (0);
2708 /* Check for data from a process. */
2709 /* Really FIRST_PROC_DESC should be 0 on Unix,
2710 but this is safer in the short run. */
2711 for (channel = 0; channel <= max_process_desc; channel++)
2713 if (FD_ISSET (channel, &Available)
2714 && FD_ISSET (channel, &non_keyboard_wait_mask))
2716 int nread;
2718 /* If waiting for this channel, arrange to return as
2719 soon as no more input to be processed. No more
2720 waiting. */
2721 if (wait_channel == channel)
2723 wait_channel = -1;
2724 time_limit = -1;
2725 got_some_input = 1;
2727 proc = chan_process[channel];
2728 if (NILP (proc))
2729 continue;
2731 /* Read data from the process, starting with our
2732 buffered-ahead character if we have one. */
2734 nread = read_process_output (proc, channel);
2735 if (nread > 0)
2737 /* Since read_process_output can run a filter,
2738 which can call accept-process-output,
2739 don't try to read from any other processes
2740 before doing the select again. */
2741 FD_ZERO (&Available);
2743 if (do_display)
2744 redisplay_preserve_echo_area ();
2746 #ifdef EWOULDBLOCK
2747 else if (nread == -1 && errno == EWOULDBLOCK)
2749 #endif
2750 /* ISC 4.1 defines both EWOULDBLOCK and O_NONBLOCK,
2751 and Emacs uses O_NONBLOCK, so what we get is EAGAIN. */
2752 #ifdef O_NONBLOCK
2753 else if (nread == -1 && errno == EAGAIN)
2755 #else
2756 #ifdef O_NDELAY
2757 else if (nread == -1 && errno == EAGAIN)
2759 /* Note that we cannot distinguish between no input
2760 available now and a closed pipe.
2761 With luck, a closed pipe will be accompanied by
2762 subprocess termination and SIGCHLD. */
2763 else if (nread == 0 && !NETCONN_P (proc))
2765 #endif /* O_NDELAY */
2766 #endif /* O_NONBLOCK */
2767 #ifdef HAVE_PTYS
2768 /* On some OSs with ptys, when the process on one end of
2769 a pty exits, the other end gets an error reading with
2770 errno = EIO instead of getting an EOF (0 bytes read).
2771 Therefore, if we get an error reading and errno =
2772 EIO, just continue, because the child process has
2773 exited and should clean itself up soon (e.g. when we
2774 get a SIGCHLD).
2776 However, it has been known to happen that the SIGCHLD
2777 got lost. So raise the signl again just in case.
2778 It can't hurt. */
2779 else if (nread == -1 && errno == EIO)
2780 kill (getpid (), SIGCHLD);
2781 #endif /* HAVE_PTYS */
2782 /* If we can detect process termination, don't consider the process
2783 gone just because its pipe is closed. */
2784 #ifdef SIGCHLD
2785 else if (nread == 0 && !NETCONN_P (proc))
2787 #endif
2788 else
2790 /* Preserve status of processes already terminated. */
2791 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2792 deactivate_process (proc);
2793 if (!NILP (XPROCESS (proc)->raw_status_low))
2794 update_status (XPROCESS (proc));
2795 if (EQ (XPROCESS (proc)->status, Qrun))
2796 XPROCESS (proc)->status
2797 = Fcons (Qexit, Fcons (make_number (256), Qnil));
2800 } /* end for each file descriptor */
2801 } /* end while exit conditions not met */
2803 waiting_for_user_input_p = 0;
2805 /* If calling from keyboard input, do not quit
2806 since we want to return C-g as an input character.
2807 Otherwise, do pending quit if requested. */
2808 if (XINT (read_kbd) >= 0)
2810 /* Prevent input_pending from remaining set if we quit. */
2811 clear_input_pending ();
2812 QUIT;
2814 #ifdef hpux
2815 /* AlainF 5-Jul-1996
2816 HP-UX 10.10 seems to have problems with signals coming in
2817 Causes "poll: interrupted system call" messages when Emacs is run
2818 in an X window
2819 Turn periodic alarms back on */
2820 start_polling ();
2821 #endif
2823 return got_some_input;
2826 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
2828 static Lisp_Object
2829 read_process_output_call (fun_and_args)
2830 Lisp_Object fun_and_args;
2832 return apply1 (XCAR (fun_and_args), XCDR (fun_and_args));
2835 static Lisp_Object
2836 read_process_output_error_handler (error)
2837 Lisp_Object error;
2839 cmd_error_internal (error, "error in process filter: ");
2840 Vinhibit_quit = Qt;
2841 update_echo_area ();
2842 Fsleep_for (make_number (2), Qnil);
2843 return Qt;
2846 /* Read pending output from the process channel,
2847 starting with our buffered-ahead character if we have one.
2848 Yield number of decoded characters read.
2850 This function reads at most 1024 characters.
2851 If you want to read all available subprocess output,
2852 you must call it repeatedly until it returns zero.
2854 The characters read are decoded according to PROC's coding-system
2855 for decoding. */
2858 read_process_output (proc, channel)
2859 Lisp_Object proc;
2860 register int channel;
2862 register int nchars, nbytes;
2863 char *chars;
2864 register Lisp_Object outstream;
2865 register struct buffer *old = current_buffer;
2866 register struct Lisp_Process *p = XPROCESS (proc);
2867 register int opoint;
2868 struct coding_system *coding = proc_decode_coding_system[channel];
2869 int carryover = XINT (p->decoding_carryover);
2871 #ifdef VMS
2872 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2874 vs = get_vms_process_pointer (p->pid);
2875 if (vs)
2877 if (!vs->iosb[0])
2878 return (0); /* Really weird if it does this */
2879 if (!(vs->iosb[0] & 1))
2880 return -1; /* I/O error */
2882 else
2883 error ("Could not get VMS process pointer");
2884 chars = vs->inputBuffer;
2885 nbytes = clean_vms_buffer (chars, vs->iosb[1]);
2886 if (nbytes <= 0)
2888 start_vms_process_read (vs); /* Crank up the next read on the process */
2889 return 1; /* Nothing worth printing, say we got 1 */
2891 if (carryover > 0)
2893 /* The data carried over in the previous decoding (which are at
2894 the tail of decoding buffer) should be prepended to the new
2895 data read to decode all together. */
2896 chars = (char *) alloca (nbytes + carryover);
2897 bcopy (XSTRING (p->decoding_buf)->data, buf, carryover);
2898 bcopy (vs->inputBuffer, chars + carryover, nbytes);
2900 #else /* not VMS */
2901 chars = (char *) alloca (carryover + 1024);
2902 if (carryover)
2903 /* See the comment above. */
2904 bcopy (XSTRING (p->decoding_buf)->data, chars, carryover);
2906 if (proc_buffered_char[channel] < 0)
2907 nbytes = emacs_read (channel, chars + carryover, 1024 - carryover);
2908 else
2910 chars[carryover] = proc_buffered_char[channel];
2911 proc_buffered_char[channel] = -1;
2912 nbytes = emacs_read (channel, chars + carryover + 1, 1023 - carryover);
2913 if (nbytes < 0)
2914 nbytes = 1;
2915 else
2916 nbytes = nbytes + 1;
2918 #endif /* not VMS */
2920 XSETINT (p->decoding_carryover, 0);
2922 /* At this point, NBYTES holds number of bytes just received
2923 (including the one in proc_buffered_char[channel]). */
2924 if (nbytes <= 0)
2926 if (nbytes < 0 || coding->mode & CODING_MODE_LAST_BLOCK)
2927 return nbytes;
2928 coding->mode |= CODING_MODE_LAST_BLOCK;
2931 /* Now set NBYTES how many bytes we must decode. */
2932 nbytes += carryover;
2934 /* Read and dispose of the process output. */
2935 outstream = p->filter;
2936 if (!NILP (outstream))
2938 /* We inhibit quit here instead of just catching it so that
2939 hitting ^G when a filter happens to be running won't screw
2940 it up. */
2941 int count = specpdl_ptr - specpdl;
2942 Lisp_Object odeactivate;
2943 Lisp_Object obuffer, okeymap;
2944 Lisp_Object text;
2945 int outer_running_asynch_code = running_asynch_code;
2946 int waiting = waiting_for_user_input_p;
2948 /* No need to gcpro these, because all we do with them later
2949 is test them for EQness, and none of them should be a string. */
2950 odeactivate = Vdeactivate_mark;
2951 XSETBUFFER (obuffer, current_buffer);
2952 okeymap = current_buffer->keymap;
2954 specbind (Qinhibit_quit, Qt);
2955 specbind (Qlast_nonmenu_event, Qt);
2957 /* In case we get recursively called,
2958 and we already saved the match data nonrecursively,
2959 save the same match data in safely recursive fashion. */
2960 if (outer_running_asynch_code)
2962 Lisp_Object tem;
2963 /* Don't clobber the CURRENT match data, either! */
2964 tem = Fmatch_data (Qnil, Qnil);
2965 restore_match_data ();
2966 record_unwind_protect (Fset_match_data, Fmatch_data (Qnil, Qnil));
2967 Fset_match_data (tem);
2970 /* For speed, if a search happens within this code,
2971 save the match data in a special nonrecursive fashion. */
2972 running_asynch_code = 1;
2974 text = decode_coding_string (make_unibyte_string (chars, nbytes),
2975 coding, 0);
2976 if (NILP (buffer_defaults.enable_multibyte_characters))
2977 /* We had better return unibyte string. */
2978 text = string_make_unibyte (text);
2980 Vlast_coding_system_used = coding->symbol;
2981 /* A new coding system might be found. */
2982 if (!EQ (p->decode_coding_system, coding->symbol))
2984 p->decode_coding_system = coding->symbol;
2986 /* Don't call setup_coding_system for
2987 proc_decode_coding_system[channel] here. It is done in
2988 detect_coding called via decode_coding above. */
2990 /* If a coding system for encoding is not yet decided, we set
2991 it as the same as coding-system for decoding.
2993 But, before doing that we must check if
2994 proc_encode_coding_system[p->outfd] surely points to a
2995 valid memory because p->outfd will be changed once EOF is
2996 sent to the process. */
2997 if (NILP (p->encode_coding_system)
2998 && proc_encode_coding_system[XINT (p->outfd)])
3000 p->encode_coding_system = coding->symbol;
3001 setup_coding_system (coding->symbol,
3002 proc_encode_coding_system[XINT (p->outfd)]);
3006 carryover = nbytes - coding->consumed;
3007 bcopy (chars + coding->consumed, XSTRING (p->decoding_buf)->data,
3008 carryover);
3009 XSETINT (p->decoding_carryover, carryover);
3010 nbytes = STRING_BYTES (XSTRING (text));
3011 nchars = XSTRING (text)->size;
3012 internal_condition_case_1 (read_process_output_call,
3013 Fcons (outstream,
3014 Fcons (proc, Fcons (text, Qnil))),
3015 !NILP (Vdebug_on_error) ? Qnil : Qerror,
3016 read_process_output_error_handler);
3018 /* If we saved the match data nonrecursively, restore it now. */
3019 restore_match_data ();
3020 running_asynch_code = outer_running_asynch_code;
3022 /* Handling the process output should not deactivate the mark. */
3023 Vdeactivate_mark = odeactivate;
3025 /* Restore waiting_for_user_input_p as it was
3026 when we were called, in case the filter clobbered it. */
3027 waiting_for_user_input_p = waiting;
3029 #if 0 /* Call record_asynch_buffer_change unconditionally,
3030 because we might have changed minor modes or other things
3031 that affect key bindings. */
3032 if (! EQ (Fcurrent_buffer (), obuffer)
3033 || ! EQ (current_buffer->keymap, okeymap))
3034 #endif
3035 /* But do it only if the caller is actually going to read events.
3036 Otherwise there's no need to make him wake up, and it could
3037 cause trouble (for example it would make Fsit_for return). */
3038 if (waiting_for_user_input_p == -1)
3039 record_asynch_buffer_change ();
3041 #ifdef VMS
3042 start_vms_process_read (vs);
3043 #endif
3044 unbind_to (count, Qnil);
3045 return nchars;
3048 /* If no filter, write into buffer if it isn't dead. */
3049 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
3051 Lisp_Object old_read_only;
3052 int old_begv, old_zv;
3053 int old_begv_byte, old_zv_byte;
3054 Lisp_Object odeactivate;
3055 int before, before_byte;
3056 int opoint_byte;
3057 Lisp_Object text;
3059 odeactivate = Vdeactivate_mark;
3061 Fset_buffer (p->buffer);
3062 opoint = PT;
3063 opoint_byte = PT_BYTE;
3064 old_read_only = current_buffer->read_only;
3065 old_begv = BEGV;
3066 old_zv = ZV;
3067 old_begv_byte = BEGV_BYTE;
3068 old_zv_byte = ZV_BYTE;
3070 current_buffer->read_only = Qnil;
3072 /* Insert new output into buffer
3073 at the current end-of-output marker,
3074 thus preserving logical ordering of input and output. */
3075 if (XMARKER (p->mark)->buffer)
3076 SET_PT_BOTH (clip_to_bounds (BEGV, marker_position (p->mark), ZV),
3077 clip_to_bounds (BEGV_BYTE, marker_byte_position (p->mark),
3078 ZV_BYTE));
3079 else
3080 SET_PT_BOTH (ZV, ZV_BYTE);
3081 before = PT;
3082 before_byte = PT_BYTE;
3084 /* If the output marker is outside of the visible region, save
3085 the restriction and widen. */
3086 if (! (BEGV <= PT && PT <= ZV))
3087 Fwiden ();
3089 text = decode_coding_string (make_unibyte_string (chars, nbytes),
3090 coding, 0);
3091 Vlast_coding_system_used = coding->symbol;
3092 /* A new coding system might be found. See the comment in the
3093 similar code in the previous `if' block. */
3094 if (!EQ (p->decode_coding_system, coding->symbol))
3096 p->decode_coding_system = coding->symbol;
3097 if (NILP (p->encode_coding_system)
3098 && proc_encode_coding_system[XINT (p->outfd)])
3100 p->encode_coding_system = coding->symbol;
3101 setup_coding_system (coding->symbol,
3102 proc_encode_coding_system[XINT (p->outfd)]);
3105 carryover = nbytes - coding->consumed;
3106 bcopy (chars + coding->consumed, XSTRING (p->decoding_buf)->data,
3107 carryover);
3108 XSETINT (p->decoding_carryover, carryover);
3109 /* Adjust the multibyteness of TEXT to that of the buffer. */
3110 if (NILP (current_buffer->enable_multibyte_characters)
3111 != ! STRING_MULTIBYTE (text))
3112 text = (STRING_MULTIBYTE (text)
3113 ? Fstring_as_unibyte (text)
3114 : Fstring_as_multibyte (text));
3115 nbytes = STRING_BYTES (XSTRING (text));
3116 nchars = XSTRING (text)->size;
3117 /* Insert before markers in case we are inserting where
3118 the buffer's mark is, and the user's next command is Meta-y. */
3119 insert_from_string_before_markers (text, 0, 0, nchars, nbytes, 0);
3120 signal_after_change (before, 0, PT - before);
3121 update_compositions (before, PT, CHECK_BORDER);
3123 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
3125 update_mode_lines++;
3127 /* Make sure opoint and the old restrictions
3128 float ahead of any new text just as point would. */
3129 if (opoint >= before)
3131 opoint += PT - before;
3132 opoint_byte += PT_BYTE - before_byte;
3134 if (old_begv > before)
3136 old_begv += PT - before;
3137 old_begv_byte += PT_BYTE - before_byte;
3139 if (old_zv >= before)
3141 old_zv += PT - before;
3142 old_zv_byte += PT_BYTE - before_byte;
3145 /* If the restriction isn't what it should be, set it. */
3146 if (old_begv != BEGV || old_zv != ZV)
3147 Fnarrow_to_region (make_number (old_begv), make_number (old_zv));
3149 /* Handling the process output should not deactivate the mark. */
3150 Vdeactivate_mark = odeactivate;
3152 current_buffer->read_only = old_read_only;
3153 SET_PT_BOTH (opoint, opoint_byte);
3154 set_buffer_internal (old);
3156 #ifdef VMS
3157 start_vms_process_read (vs);
3158 #endif
3159 return nbytes;
3162 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
3163 0, 0, 0,
3164 "Returns non-nil if emacs is waiting for input from the user.\n\
3165 This is intended for use by asynchronous process output filters and sentinels.")
3168 return (waiting_for_user_input_p ? Qt : Qnil);
3171 /* Sending data to subprocess */
3173 jmp_buf send_process_frame;
3174 Lisp_Object process_sent_to;
3176 SIGTYPE
3177 send_process_trap ()
3179 #ifdef BSD4_1
3180 sigrelse (SIGPIPE);
3181 sigrelse (SIGALRM);
3182 #endif /* BSD4_1 */
3183 longjmp (send_process_frame, 1);
3186 /* Send some data to process PROC.
3187 BUF is the beginning of the data; LEN is the number of characters.
3188 OBJECT is the Lisp object that the data comes from.
3190 The data is encoded by PROC's coding-system for encoding before it
3191 is sent. But if the data ends at the middle of multi-byte
3192 representation, that incomplete sequence of bytes are sent without
3193 being encoded. Should we store them in a buffer to prepend them to
3194 the data send later?
3196 This function can evaluate Lisp code and can garbage collect. */
3198 void
3199 send_process (proc, buf, len, object)
3200 volatile Lisp_Object proc;
3201 unsigned char *volatile buf;
3202 volatile int len;
3203 volatile Lisp_Object object;
3205 /* Use volatile to protect variables from being clobbered by longjmp. */
3206 int rv;
3207 struct coding_system *coding;
3208 struct gcpro gcpro1;
3210 GCPRO1 (object);
3212 #ifdef VMS
3213 struct Lisp_Process *p = XPROCESS (proc);
3214 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
3215 #endif /* VMS */
3217 if (! NILP (XPROCESS (proc)->raw_status_low))
3218 update_status (XPROCESS (proc));
3219 if (! EQ (XPROCESS (proc)->status, Qrun))
3220 error ("Process %s not running",
3221 XSTRING (XPROCESS (proc)->name)->data);
3222 if (XINT (XPROCESS (proc)->outfd) < 0)
3223 error ("Output file descriptor of %s is closed",
3224 XSTRING (XPROCESS (proc)->name)->data);
3226 coding = proc_encode_coding_system[XINT (XPROCESS (proc)->outfd)];
3227 Vlast_coding_system_used = coding->symbol;
3229 if ((STRINGP (object) && STRING_MULTIBYTE (object))
3230 || (BUFFERP (object)
3231 && !NILP (XBUFFER (object)->enable_multibyte_characters)))
3233 coding->src_multibyte = 1;
3234 if (!EQ (coding->symbol, XPROCESS (proc)->encode_coding_system))
3235 /* The coding system for encoding was changed to raw-text
3236 because we sent a unibyte text previously. Now we are
3237 sending a multibyte text, thus we must encode it by the
3238 original coding system specified for the current
3239 process. */
3240 setup_coding_system (XPROCESS (proc)->encode_coding_system,
3241 coding);
3243 else
3245 coding->src_multibyte = 0;
3246 /* For sending a unibyte text, character code conversion
3247 should not take place but EOL conversion should. So, setup
3248 raw-text or one of the subsidiary. */
3249 setup_raw_text_coding_system (coding);
3251 coding->dst_multibyte = 0;
3253 if (CODING_REQUIRE_ENCODING (coding))
3255 int require = encoding_buffer_size (coding, len);
3256 int from_byte = -1, from = -1, to = -1;
3257 unsigned char *temp_buf = NULL;
3259 if (BUFFERP (object))
3261 from_byte = BUF_PTR_BYTE_POS (XBUFFER (object), buf);
3262 from = buf_bytepos_to_charpos (XBUFFER (object), from_byte);
3263 to = buf_bytepos_to_charpos (XBUFFER (object), from_byte + len);
3265 else if (STRINGP (object))
3267 from_byte = buf - XSTRING (object)->data;
3268 from = string_byte_to_char (object, from_byte);
3269 to = string_byte_to_char (object, from_byte + len);
3272 if (from_byte >= 0 && coding->composing != COMPOSITION_DISABLED)
3273 coding_save_composition (coding, from, to, object);
3275 if (STRING_BYTES (XSTRING (XPROCESS (proc)->encoding_buf)) < require)
3276 XPROCESS (proc)->encoding_buf = make_uninit_string (require);
3278 if (from_byte >= 0)
3279 buf = (BUFFERP (object)
3280 ? BUF_BYTE_ADDRESS (XBUFFER (object), from_byte)
3281 : XSTRING (object)->data + from_byte);
3283 object = XPROCESS (proc)->encoding_buf;
3284 encode_coding (coding, (char *) buf, XSTRING (object)->data,
3285 len, STRING_BYTES (XSTRING (object)));
3286 len = coding->produced;
3287 buf = XSTRING (object)->data;
3288 if (temp_buf)
3289 xfree (temp_buf);
3292 #ifdef VMS
3293 vs = get_vms_process_pointer (p->pid);
3294 if (vs == 0)
3295 error ("Could not find this process: %x", p->pid);
3296 else if (write_to_vms_process (vs, buf, len))
3298 #else /* not VMS */
3300 if (pty_max_bytes == 0)
3302 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
3303 pty_max_bytes = fpathconf (XFASTINT (XPROCESS (proc)->outfd),
3304 _PC_MAX_CANON);
3305 if (pty_max_bytes < 0)
3306 pty_max_bytes = 250;
3307 #else
3308 pty_max_bytes = 250;
3309 #endif
3310 /* Deduct one, to leave space for the eof. */
3311 pty_max_bytes--;
3314 /* 2000-09-21: Emacs 20.7, sparc-sun-solaris-2.6, GCC 2.95.2,
3315 CFLAGS="-g -O": The value of the parameter `proc' is clobbered
3316 when returning with longjmp despite being declared volatile. */
3317 if (!setjmp (send_process_frame))
3319 process_sent_to = proc;
3320 while (len > 0)
3322 int this = len;
3323 SIGTYPE (*old_sigpipe)();
3325 /* Decide how much data we can send in one batch.
3326 Long lines need to be split into multiple batches. */
3327 if (!NILP (XPROCESS (proc)->pty_flag))
3329 /* Starting this at zero is always correct when not the first iteration
3330 because the previous iteration ended by sending C-d.
3331 It may not be correct for the first iteration
3332 if a partial line was sent in a separate send_process call.
3333 If that proves worth handling, we need to save linepos
3334 in the process object. */
3335 int linepos = 0;
3336 unsigned char *ptr = (unsigned char *) buf;
3337 unsigned char *end = (unsigned char *) buf + len;
3339 /* Scan through this text for a line that is too long. */
3340 while (ptr != end && linepos < pty_max_bytes)
3342 if (*ptr == '\n')
3343 linepos = 0;
3344 else
3345 linepos++;
3346 ptr++;
3348 /* If we found one, break the line there
3349 and put in a C-d to force the buffer through. */
3350 this = ptr - buf;
3353 /* Send this batch, using one or more write calls. */
3354 while (this > 0)
3356 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
3357 rv = emacs_write (XINT (XPROCESS (proc)->outfd),
3358 (char *) buf, this);
3359 signal (SIGPIPE, old_sigpipe);
3361 if (rv < 0)
3363 if (0
3364 #ifdef EWOULDBLOCK
3365 || errno == EWOULDBLOCK
3366 #endif
3367 #ifdef EAGAIN
3368 || errno == EAGAIN
3369 #endif
3371 /* Buffer is full. Wait, accepting input;
3372 that may allow the program
3373 to finish doing output and read more. */
3375 Lisp_Object zero;
3376 int offset = 0;
3378 #ifdef BROKEN_PTY_READ_AFTER_EAGAIN
3379 /* A gross hack to work around a bug in FreeBSD.
3380 In the following sequence, read(2) returns
3381 bogus data:
3383 write(2) 1022 bytes
3384 write(2) 954 bytes, get EAGAIN
3385 read(2) 1024 bytes in process_read_output
3386 read(2) 11 bytes in process_read_output
3388 That is, read(2) returns more bytes than have
3389 ever been written successfully. The 1033 bytes
3390 read are the 1022 bytes written successfully
3391 after processing (for example with CRs added if
3392 the terminal is set up that way which it is
3393 here). The same bytes will be seen again in a
3394 later read(2), without the CRs. */
3396 if (errno == EAGAIN)
3398 int flags = FWRITE;
3399 ioctl (XINT (XPROCESS (proc)->outfd), TIOCFLUSH,
3400 &flags);
3402 #endif /* BROKEN_PTY_READ_AFTER_EAGAIN */
3404 /* Running filters might relocate buffers or strings.
3405 Arrange to relocate BUF. */
3406 if (BUFFERP (object))
3407 offset = BUF_PTR_BYTE_POS (XBUFFER (object), buf);
3408 else if (STRINGP (object))
3409 offset = buf - XSTRING (object)->data;
3411 XSETFASTINT (zero, 0);
3412 #ifdef EMACS_HAS_USECS
3413 wait_reading_process_input (0, 20000, zero, 0);
3414 #else
3415 wait_reading_process_input (1, 0, zero, 0);
3416 #endif
3418 if (BUFFERP (object))
3419 buf = BUF_BYTE_ADDRESS (XBUFFER (object), offset);
3420 else if (STRINGP (object))
3421 buf = offset + XSTRING (object)->data;
3423 rv = 0;
3425 else
3426 /* This is a real error. */
3427 report_file_error ("writing to process", Fcons (proc, Qnil));
3429 buf += rv;
3430 len -= rv;
3431 this -= rv;
3434 /* If we sent just part of the string, put in an EOF
3435 to force it through, before we send the rest. */
3436 if (len > 0)
3437 Fprocess_send_eof (proc);
3440 #endif /* not VMS */
3441 else
3443 #ifndef VMS
3444 proc = process_sent_to;
3445 #endif
3446 XPROCESS (proc)->raw_status_low = Qnil;
3447 XPROCESS (proc)->raw_status_high = Qnil;
3448 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
3449 XSETINT (XPROCESS (proc)->tick, ++process_tick);
3450 deactivate_process (proc);
3451 #ifdef VMS
3452 error ("Error writing to process %s; closed it",
3453 XSTRING (XPROCESS (proc)->name)->data);
3454 #else
3455 error ("SIGPIPE raised on process %s; closed it",
3456 XSTRING (XPROCESS (proc)->name)->data);
3457 #endif
3460 UNGCPRO;
3463 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
3464 3, 3, 0,
3465 "Send current contents of region as input to PROCESS.\n\
3466 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3467 nil, indicating the current buffer's process.\n\
3468 Called from program, takes three arguments, PROCESS, START and END.\n\
3469 If the region is more than 500 characters long,\n\
3470 it is sent in several bunches. This may happen even for shorter regions.\n\
3471 Output from processes can arrive in between bunches.")
3472 (process, start, end)
3473 Lisp_Object process, start, end;
3475 Lisp_Object proc;
3476 int start1, end1;
3478 proc = get_process (process);
3479 validate_region (&start, &end);
3481 if (XINT (start) < GPT && XINT (end) > GPT)
3482 move_gap (XINT (start));
3484 start1 = CHAR_TO_BYTE (XINT (start));
3485 end1 = CHAR_TO_BYTE (XINT (end));
3486 send_process (proc, BYTE_POS_ADDR (start1), end1 - start1,
3487 Fcurrent_buffer ());
3489 return Qnil;
3492 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
3493 2, 2, 0,
3494 "Send PROCESS the contents of STRING as input.\n\
3495 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3496 nil, indicating the current buffer's process.\n\
3497 If STRING is more than 500 characters long,\n\
3498 it is sent in several bunches. This may happen even for shorter strings.\n\
3499 Output from processes can arrive in between bunches.")
3500 (process, string)
3501 Lisp_Object process, string;
3503 Lisp_Object proc;
3504 CHECK_STRING (string, 1);
3505 proc = get_process (process);
3506 send_process (proc, XSTRING (string)->data,
3507 STRING_BYTES (XSTRING (string)), string);
3508 return Qnil;
3511 DEFUN ("process-running-child-p", Fprocess_running_child_p,
3512 Sprocess_running_child_p, 0, 1, 0,
3513 "Return t if PROCESS has given the terminal to a child.\n\
3514 If the operating system does not make it possible to find out,\n\
3515 return t unconditionally.")
3516 (process)
3517 Lisp_Object process;
3519 /* Initialize in case ioctl doesn't exist or gives an error,
3520 in a way that will cause returning t. */
3521 int gid = 0;
3522 Lisp_Object proc;
3523 struct Lisp_Process *p;
3525 proc = get_process (process);
3526 p = XPROCESS (proc);
3528 if (!EQ (p->childp, Qt))
3529 error ("Process %s is not a subprocess",
3530 XSTRING (p->name)->data);
3531 if (XINT (p->infd) < 0)
3532 error ("Process %s is not active",
3533 XSTRING (p->name)->data);
3535 #ifdef TIOCGPGRP
3536 if (!NILP (p->subtty))
3537 ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
3538 else
3539 ioctl (XINT (p->infd), TIOCGPGRP, &gid);
3540 #endif /* defined (TIOCGPGRP ) */
3542 if (gid == XFASTINT (p->pid))
3543 return Qnil;
3544 return Qt;
3547 /* send a signal number SIGNO to PROCESS.
3548 If CURRENT_GROUP is t, that means send to the process group
3549 that currently owns the terminal being used to communicate with PROCESS.
3550 This is used for various commands in shell mode.
3551 If CURRENT_GROUP is lambda, that means send to the process group
3552 that currently owns the terminal, but only if it is NOT the shell itself.
3554 If NOMSG is zero, insert signal-announcements into process's buffers
3555 right away.
3557 If we can, we try to signal PROCESS by sending control characters
3558 down the pty. This allows us to signal inferiors who have changed
3559 their uid, for which killpg would return an EPERM error. */
3561 static void
3562 process_send_signal (process, signo, current_group, nomsg)
3563 Lisp_Object process;
3564 int signo;
3565 Lisp_Object current_group;
3566 int nomsg;
3568 Lisp_Object proc;
3569 register struct Lisp_Process *p;
3570 int gid;
3571 int no_pgrp = 0;
3573 proc = get_process (process);
3574 p = XPROCESS (proc);
3576 if (!EQ (p->childp, Qt))
3577 error ("Process %s is not a subprocess",
3578 XSTRING (p->name)->data);
3579 if (XINT (p->infd) < 0)
3580 error ("Process %s is not active",
3581 XSTRING (p->name)->data);
3583 if (NILP (p->pty_flag))
3584 current_group = Qnil;
3586 /* If we are using pgrps, get a pgrp number and make it negative. */
3587 if (!NILP (current_group))
3589 #ifdef SIGNALS_VIA_CHARACTERS
3590 /* If possible, send signals to the entire pgrp
3591 by sending an input character to it. */
3593 /* TERMIOS is the latest and bestest, and seems most likely to
3594 work. If the system has it, use it. */
3595 #ifdef HAVE_TERMIOS
3596 struct termios t;
3598 switch (signo)
3600 case SIGINT:
3601 tcgetattr (XINT (p->infd), &t);
3602 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3603 return;
3605 case SIGQUIT:
3606 tcgetattr (XINT (p->infd), &t);
3607 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3608 return;
3610 case SIGTSTP:
3611 tcgetattr (XINT (p->infd), &t);
3612 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
3613 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3614 #else
3615 send_process (proc, &t.c_cc[VSUSP], 1, Qnil);
3616 #endif
3617 return;
3620 #else /* ! HAVE_TERMIOS */
3622 /* On Berkeley descendants, the following IOCTL's retrieve the
3623 current control characters. */
3624 #if defined (TIOCGLTC) && defined (TIOCGETC)
3626 struct tchars c;
3627 struct ltchars lc;
3629 switch (signo)
3631 case SIGINT:
3632 ioctl (XINT (p->infd), TIOCGETC, &c);
3633 send_process (proc, &c.t_intrc, 1, Qnil);
3634 return;
3635 case SIGQUIT:
3636 ioctl (XINT (p->infd), TIOCGETC, &c);
3637 send_process (proc, &c.t_quitc, 1, Qnil);
3638 return;
3639 #ifdef SIGTSTP
3640 case SIGTSTP:
3641 ioctl (XINT (p->infd), TIOCGLTC, &lc);
3642 send_process (proc, &lc.t_suspc, 1, Qnil);
3643 return;
3644 #endif /* ! defined (SIGTSTP) */
3647 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3649 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
3650 characters. */
3651 #ifdef TCGETA
3652 struct termio t;
3653 switch (signo)
3655 case SIGINT:
3656 ioctl (XINT (p->infd), TCGETA, &t);
3657 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3658 return;
3659 case SIGQUIT:
3660 ioctl (XINT (p->infd), TCGETA, &t);
3661 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3662 return;
3663 #ifdef SIGTSTP
3664 case SIGTSTP:
3665 ioctl (XINT (p->infd), TCGETA, &t);
3666 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3667 return;
3668 #endif /* ! defined (SIGTSTP) */
3670 #else /* ! defined (TCGETA) */
3671 Your configuration files are messed up.
3672 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
3673 you'd better be using one of the alternatives above! */
3674 #endif /* ! defined (TCGETA) */
3675 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3676 #endif /* ! defined HAVE_TERMIOS */
3677 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
3679 #ifdef TIOCGPGRP
3680 /* Get the pgrp using the tty itself, if we have that.
3681 Otherwise, use the pty to get the pgrp.
3682 On pfa systems, saka@pfu.fujitsu.co.JP writes:
3683 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
3684 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
3685 His patch indicates that if TIOCGPGRP returns an error, then
3686 we should just assume that p->pid is also the process group id. */
3688 int err;
3690 if (!NILP (p->subtty))
3691 err = ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
3692 else
3693 err = ioctl (XINT (p->infd), TIOCGPGRP, &gid);
3695 #ifdef pfa
3696 if (err == -1)
3697 gid = - XFASTINT (p->pid);
3698 #endif /* ! defined (pfa) */
3700 if (gid == -1)
3701 no_pgrp = 1;
3702 else
3703 gid = - gid;
3704 #else /* ! defined (TIOCGPGRP ) */
3705 /* Can't select pgrps on this system, so we know that
3706 the child itself heads the pgrp. */
3707 gid = - XFASTINT (p->pid);
3708 #endif /* ! defined (TIOCGPGRP ) */
3710 /* If current_group is lambda, and the shell owns the terminal,
3711 don't send any signal. */
3712 if (EQ (current_group, Qlambda) && gid == - XFASTINT (p->pid))
3713 return;
3715 else
3716 gid = - XFASTINT (p->pid);
3718 switch (signo)
3720 #ifdef SIGCONT
3721 case SIGCONT:
3722 p->raw_status_low = Qnil;
3723 p->raw_status_high = Qnil;
3724 p->status = Qrun;
3725 XSETINT (p->tick, ++process_tick);
3726 if (!nomsg)
3727 status_notify ();
3728 break;
3729 #endif /* ! defined (SIGCONT) */
3730 case SIGINT:
3731 #ifdef VMS
3732 send_process (proc, "\003", 1, Qnil); /* ^C */
3733 goto whoosh;
3734 #endif
3735 case SIGQUIT:
3736 #ifdef VMS
3737 send_process (proc, "\031", 1, Qnil); /* ^Y */
3738 goto whoosh;
3739 #endif
3740 case SIGKILL:
3741 #ifdef VMS
3742 sys$forcex (&(XFASTINT (p->pid)), 0, 1);
3743 whoosh:
3744 #endif
3745 flush_pending_output (XINT (p->infd));
3746 break;
3749 /* If we don't have process groups, send the signal to the immediate
3750 subprocess. That isn't really right, but it's better than any
3751 obvious alternative. */
3752 if (no_pgrp)
3754 kill (XFASTINT (p->pid), signo);
3755 return;
3758 /* gid may be a pid, or minus a pgrp's number */
3759 #ifdef TIOCSIGSEND
3760 if (!NILP (current_group))
3761 ioctl (XINT (p->infd), TIOCSIGSEND, signo);
3762 else
3764 gid = - XFASTINT (p->pid);
3765 kill (gid, signo);
3767 #else /* ! defined (TIOCSIGSEND) */
3768 EMACS_KILLPG (-gid, signo);
3769 #endif /* ! defined (TIOCSIGSEND) */
3772 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
3773 "Interrupt process PROCESS.\n\
3774 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
3775 nil or no arg means current buffer's process.\n\
3776 Second arg CURRENT-GROUP non-nil means send signal to\n\
3777 the current process-group of the process's controlling terminal\n\
3778 rather than to the process's own process group.\n\
3779 If the process is a shell, this means interrupt current subjob\n\
3780 rather than the shell.\n\
3782 If CURRENT-GROUP is `lambda', and if the shell owns the terminal,\n\
3783 don't send the signal.")
3784 (process, current_group)
3785 Lisp_Object process, current_group;
3787 process_send_signal (process, SIGINT, current_group, 0);
3788 return process;
3791 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
3792 "Kill process PROCESS. May be process or name of one.\n\
3793 See function `interrupt-process' for more details on usage.")
3794 (process, current_group)
3795 Lisp_Object process, current_group;
3797 process_send_signal (process, SIGKILL, current_group, 0);
3798 return process;
3801 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
3802 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
3803 See function `interrupt-process' for more details on usage.")
3804 (process, current_group)
3805 Lisp_Object process, current_group;
3807 process_send_signal (process, SIGQUIT, current_group, 0);
3808 return process;
3811 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
3812 "Stop process PROCESS. May be process or name of one.\n\
3813 See function `interrupt-process' for more details on usage.")
3814 (process, current_group)
3815 Lisp_Object process, current_group;
3817 #ifndef SIGTSTP
3818 error ("no SIGTSTP support");
3819 #else
3820 process_send_signal (process, SIGTSTP, current_group, 0);
3821 #endif
3822 return process;
3825 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
3826 "Continue process PROCESS. May be process or name of one.\n\
3827 See function `interrupt-process' for more details on usage.")
3828 (process, current_group)
3829 Lisp_Object process, current_group;
3831 #ifdef SIGCONT
3832 process_send_signal (process, SIGCONT, current_group, 0);
3833 #else
3834 error ("no SIGCONT support");
3835 #endif
3836 return process;
3839 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
3840 2, 2, "nProcess number: \nnSignal code: ",
3841 "Send the process with process id PID the signal with code SIGCODE.\n\
3842 PID must be an integer. The process need not be a child of this Emacs.\n\
3843 SIGCODE may be an integer, or a symbol whose name is a signal name.")
3844 (pid, sigcode)
3845 Lisp_Object pid, sigcode;
3847 CHECK_NUMBER (pid, 0);
3849 #define handle_signal(NAME, VALUE) \
3850 else if (!strcmp (name, NAME)) \
3851 XSETINT (sigcode, VALUE)
3853 if (INTEGERP (sigcode))
3855 else
3857 unsigned char *name;
3859 CHECK_SYMBOL (sigcode, 1);
3860 name = XSYMBOL (sigcode)->name->data;
3862 if (0)
3864 #ifdef SIGHUP
3865 handle_signal ("SIGHUP", SIGHUP);
3866 #endif
3867 #ifdef SIGINT
3868 handle_signal ("SIGINT", SIGINT);
3869 #endif
3870 #ifdef SIGQUIT
3871 handle_signal ("SIGQUIT", SIGQUIT);
3872 #endif
3873 #ifdef SIGILL
3874 handle_signal ("SIGILL", SIGILL);
3875 #endif
3876 #ifdef SIGABRT
3877 handle_signal ("SIGABRT", SIGABRT);
3878 #endif
3879 #ifdef SIGEMT
3880 handle_signal ("SIGEMT", SIGEMT);
3881 #endif
3882 #ifdef SIGKILL
3883 handle_signal ("SIGKILL", SIGKILL);
3884 #endif
3885 #ifdef SIGFPE
3886 handle_signal ("SIGFPE", SIGFPE);
3887 #endif
3888 #ifdef SIGBUS
3889 handle_signal ("SIGBUS", SIGBUS);
3890 #endif
3891 #ifdef SIGSEGV
3892 handle_signal ("SIGSEGV", SIGSEGV);
3893 #endif
3894 #ifdef SIGSYS
3895 handle_signal ("SIGSYS", SIGSYS);
3896 #endif
3897 #ifdef SIGPIPE
3898 handle_signal ("SIGPIPE", SIGPIPE);
3899 #endif
3900 #ifdef SIGALRM
3901 handle_signal ("SIGALRM", SIGALRM);
3902 #endif
3903 #ifdef SIGTERM
3904 handle_signal ("SIGTERM", SIGTERM);
3905 #endif
3906 #ifdef SIGURG
3907 handle_signal ("SIGURG", SIGURG);
3908 #endif
3909 #ifdef SIGSTOP
3910 handle_signal ("SIGSTOP", SIGSTOP);
3911 #endif
3912 #ifdef SIGTSTP
3913 handle_signal ("SIGTSTP", SIGTSTP);
3914 #endif
3915 #ifdef SIGCONT
3916 handle_signal ("SIGCONT", SIGCONT);
3917 #endif
3918 #ifdef SIGCHLD
3919 handle_signal ("SIGCHLD", SIGCHLD);
3920 #endif
3921 #ifdef SIGTTIN
3922 handle_signal ("SIGTTIN", SIGTTIN);
3923 #endif
3924 #ifdef SIGTTOU
3925 handle_signal ("SIGTTOU", SIGTTOU);
3926 #endif
3927 #ifdef SIGIO
3928 handle_signal ("SIGIO", SIGIO);
3929 #endif
3930 #ifdef SIGXCPU
3931 handle_signal ("SIGXCPU", SIGXCPU);
3932 #endif
3933 #ifdef SIGXFSZ
3934 handle_signal ("SIGXFSZ", SIGXFSZ);
3935 #endif
3936 #ifdef SIGVTALRM
3937 handle_signal ("SIGVTALRM", SIGVTALRM);
3938 #endif
3939 #ifdef SIGPROF
3940 handle_signal ("SIGPROF", SIGPROF);
3941 #endif
3942 #ifdef SIGWINCH
3943 handle_signal ("SIGWINCH", SIGWINCH);
3944 #endif
3945 #ifdef SIGINFO
3946 handle_signal ("SIGINFO", SIGINFO);
3947 #endif
3948 #ifdef SIGUSR1
3949 handle_signal ("SIGUSR1", SIGUSR1);
3950 #endif
3951 #ifdef SIGUSR2
3952 handle_signal ("SIGUSR2", SIGUSR2);
3953 #endif
3954 else
3955 error ("Undefined signal name %s", name);
3958 #undef handle_signal
3960 return make_number (kill (XINT (pid), XINT (sigcode)));
3963 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
3964 "Make PROCESS see end-of-file in its input.\n\
3965 EOF comes after any text already sent to it.\n\
3966 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3967 nil, indicating the current buffer's process.\n\
3968 If PROCESS is a network connection, or is a process communicating\n\
3969 through a pipe (as opposed to a pty), then you cannot send any more\n\
3970 text to PROCESS after you call this function.")
3971 (process)
3972 Lisp_Object process;
3974 Lisp_Object proc;
3975 struct coding_system *coding;
3977 proc = get_process (process);
3978 coding = proc_encode_coding_system[XINT (XPROCESS (proc)->outfd)];
3980 /* Make sure the process is really alive. */
3981 if (! NILP (XPROCESS (proc)->raw_status_low))
3982 update_status (XPROCESS (proc));
3983 if (! EQ (XPROCESS (proc)->status, Qrun))
3984 error ("Process %s not running", XSTRING (XPROCESS (proc)->name)->data);
3986 if (CODING_REQUIRE_FLUSHING (coding))
3988 coding->mode |= CODING_MODE_LAST_BLOCK;
3989 send_process (proc, "", 0, Qnil);
3992 #ifdef VMS
3993 send_process (proc, "\032", 1, Qnil); /* ^z */
3994 #else
3995 if (!NILP (XPROCESS (proc)->pty_flag))
3996 send_process (proc, "\004", 1, Qnil);
3997 else
3999 int old_outfd, new_outfd;
4001 #ifdef HAVE_SHUTDOWN
4002 /* If this is a network connection, or socketpair is used
4003 for communication with the subprocess, call shutdown to cause EOF.
4004 (In some old system, shutdown to socketpair doesn't work.
4005 Then we just can't win.) */
4006 if (NILP (XPROCESS (proc)->pid)
4007 || XINT (XPROCESS (proc)->outfd) == XINT (XPROCESS (proc)->infd))
4008 shutdown (XINT (XPROCESS (proc)->outfd), 1);
4009 /* In case of socketpair, outfd == infd, so don't close it. */
4010 if (XINT (XPROCESS (proc)->outfd) != XINT (XPROCESS (proc)->infd))
4011 emacs_close (XINT (XPROCESS (proc)->outfd));
4012 #else /* not HAVE_SHUTDOWN */
4013 emacs_close (XINT (XPROCESS (proc)->outfd));
4014 #endif /* not HAVE_SHUTDOWN */
4015 new_outfd = emacs_open (NULL_DEVICE, O_WRONLY, 0);
4016 old_outfd = XINT (XPROCESS (proc)->outfd);
4018 if (!proc_encode_coding_system[new_outfd])
4019 proc_encode_coding_system[new_outfd]
4020 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
4021 bcopy (proc_encode_coding_system[old_outfd],
4022 proc_encode_coding_system[new_outfd],
4023 sizeof (struct coding_system));
4024 bzero (proc_encode_coding_system[old_outfd],
4025 sizeof (struct coding_system));
4027 XSETINT (XPROCESS (proc)->outfd, new_outfd);
4029 #endif /* VMS */
4030 return process;
4033 /* Kill all processes associated with `buffer'.
4034 If `buffer' is nil, kill all processes */
4036 void
4037 kill_buffer_processes (buffer)
4038 Lisp_Object buffer;
4040 Lisp_Object tail, proc;
4042 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCDR (tail))
4044 proc = XCDR (XCAR (tail));
4045 if (GC_PROCESSP (proc)
4046 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
4048 if (NETCONN_P (proc))
4049 Fdelete_process (proc);
4050 else if (XINT (XPROCESS (proc)->infd) >= 0)
4051 process_send_signal (proc, SIGHUP, Qnil, 1);
4056 /* On receipt of a signal that a child status has changed,
4057 loop asking about children with changed statuses until
4058 the system says there are no more.
4059 All we do is change the status;
4060 we do not run sentinels or print notifications.
4061 That is saved for the next time keyboard input is done,
4062 in order to avoid timing errors. */
4064 /** WARNING: this can be called during garbage collection.
4065 Therefore, it must not be fooled by the presence of mark bits in
4066 Lisp objects. */
4068 /** USG WARNING: Although it is not obvious from the documentation
4069 in signal(2), on a USG system the SIGCLD handler MUST NOT call
4070 signal() before executing at least one wait(), otherwise the handler
4071 will be called again, resulting in an infinite loop. The relevant
4072 portion of the documentation reads "SIGCLD signals will be queued
4073 and the signal-catching function will be continually reentered until
4074 the queue is empty". Invoking signal() causes the kernel to reexamine
4075 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
4077 SIGTYPE
4078 sigchld_handler (signo)
4079 int signo;
4081 int old_errno = errno;
4082 Lisp_Object proc;
4083 register struct Lisp_Process *p;
4084 extern EMACS_TIME *input_available_clear_time;
4086 #ifdef BSD4_1
4087 extern int sigheld;
4088 sigheld |= sigbit (SIGCHLD);
4089 #endif
4091 while (1)
4093 register int pid;
4094 WAITTYPE w;
4095 Lisp_Object tail;
4097 #ifdef WNOHANG
4098 #ifndef WUNTRACED
4099 #define WUNTRACED 0
4100 #endif /* no WUNTRACED */
4101 /* Keep trying to get a status until we get a definitive result. */
4104 errno = 0;
4105 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
4107 while (pid <= 0 && errno == EINTR);
4109 if (pid <= 0)
4111 /* A real failure. We have done all our job, so return. */
4113 /* USG systems forget handlers when they are used;
4114 must reestablish each time */
4115 #if defined (USG) && !defined (POSIX_SIGNALS)
4116 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
4117 #endif
4118 #ifdef BSD4_1
4119 sigheld &= ~sigbit (SIGCHLD);
4120 sigrelse (SIGCHLD);
4121 #endif
4122 errno = old_errno;
4123 return;
4125 #else
4126 pid = wait (&w);
4127 #endif /* no WNOHANG */
4129 /* Find the process that signaled us, and record its status. */
4131 p = 0;
4132 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
4134 proc = XCDR (XCAR (tail));
4135 p = XPROCESS (proc);
4136 if (EQ (p->childp, Qt) && XFASTINT (p->pid) == pid)
4137 break;
4138 p = 0;
4141 /* Look for an asynchronous process whose pid hasn't been filled
4142 in yet. */
4143 if (p == 0)
4144 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
4146 proc = XCDR (XCAR (tail));
4147 p = XPROCESS (proc);
4148 if (INTEGERP (p->pid) && XINT (p->pid) == -1)
4149 break;
4150 p = 0;
4153 /* Change the status of the process that was found. */
4154 if (p != 0)
4156 union { int i; WAITTYPE wt; } u;
4157 int clear_desc_flag = 0;
4159 XSETINT (p->tick, ++process_tick);
4160 u.wt = w;
4161 XSETINT (p->raw_status_low, u.i & 0xffff);
4162 XSETINT (p->raw_status_high, u.i >> 16);
4164 /* If process has terminated, stop waiting for its output. */
4165 if ((WIFSIGNALED (w) || WIFEXITED (w))
4166 && XINT (p->infd) >= 0)
4167 clear_desc_flag = 1;
4169 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
4170 if (clear_desc_flag)
4172 FD_CLR (XINT (p->infd), &input_wait_mask);
4173 FD_CLR (XINT (p->infd), &non_keyboard_wait_mask);
4176 /* Tell wait_reading_process_input that it needs to wake up and
4177 look around. */
4178 if (input_available_clear_time)
4179 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
4182 /* There was no asynchronous process found for that id. Check
4183 if we have a synchronous process. */
4184 else
4186 synch_process_alive = 0;
4188 /* Report the status of the synchronous process. */
4189 if (WIFEXITED (w))
4190 synch_process_retcode = WRETCODE (w);
4191 else if (WIFSIGNALED (w))
4193 int code = WTERMSIG (w);
4194 char *signame;
4196 synchronize_system_messages_locale ();
4197 signame = strsignal (code);
4199 if (signame == 0)
4200 signame = "unknown";
4202 synch_process_death = signame;
4205 /* Tell wait_reading_process_input that it needs to wake up and
4206 look around. */
4207 if (input_available_clear_time)
4208 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
4211 /* On some systems, we must return right away.
4212 If any more processes want to signal us, we will
4213 get another signal.
4214 Otherwise (on systems that have WNOHANG), loop around
4215 to use up all the processes that have something to tell us. */
4216 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG)) || defined (WINDOWSNT)
4217 #if defined (USG) && ! defined (POSIX_SIGNALS)
4218 signal (signo, sigchld_handler);
4219 #endif
4220 errno = old_errno;
4221 return;
4222 #endif /* USG, but not HPUX with WNOHANG */
4227 static Lisp_Object
4228 exec_sentinel_unwind (data)
4229 Lisp_Object data;
4231 XPROCESS (XCAR (data))->sentinel = XCDR (data);
4232 return Qnil;
4235 static Lisp_Object
4236 exec_sentinel_error_handler (error)
4237 Lisp_Object error;
4239 cmd_error_internal (error, "error in process sentinel: ");
4240 Vinhibit_quit = Qt;
4241 update_echo_area ();
4242 Fsleep_for (make_number (2), Qnil);
4243 return Qt;
4246 static void
4247 exec_sentinel (proc, reason)
4248 Lisp_Object proc, reason;
4250 Lisp_Object sentinel, obuffer, odeactivate, okeymap;
4251 register struct Lisp_Process *p = XPROCESS (proc);
4252 int count = specpdl_ptr - specpdl;
4253 int outer_running_asynch_code = running_asynch_code;
4254 int waiting = waiting_for_user_input_p;
4256 /* No need to gcpro these, because all we do with them later
4257 is test them for EQness, and none of them should be a string. */
4258 odeactivate = Vdeactivate_mark;
4259 XSETBUFFER (obuffer, current_buffer);
4260 okeymap = current_buffer->keymap;
4262 sentinel = p->sentinel;
4263 if (NILP (sentinel))
4264 return;
4266 /* Zilch the sentinel while it's running, to avoid recursive invocations;
4267 assure that it gets restored no matter how the sentinel exits. */
4268 p->sentinel = Qnil;
4269 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
4270 /* Inhibit quit so that random quits don't screw up a running filter. */
4271 specbind (Qinhibit_quit, Qt);
4272 specbind (Qlast_nonmenu_event, Qt);
4274 /* In case we get recursively called,
4275 and we already saved the match data nonrecursively,
4276 save the same match data in safely recursive fashion. */
4277 if (outer_running_asynch_code)
4279 Lisp_Object tem;
4280 tem = Fmatch_data (Qnil, Qnil);
4281 restore_match_data ();
4282 record_unwind_protect (Fset_match_data, Fmatch_data (Qnil, Qnil));
4283 Fset_match_data (tem);
4286 /* For speed, if a search happens within this code,
4287 save the match data in a special nonrecursive fashion. */
4288 running_asynch_code = 1;
4290 internal_condition_case_1 (read_process_output_call,
4291 Fcons (sentinel,
4292 Fcons (proc, Fcons (reason, Qnil))),
4293 !NILP (Vdebug_on_error) ? Qnil : Qerror,
4294 exec_sentinel_error_handler);
4296 /* If we saved the match data nonrecursively, restore it now. */
4297 restore_match_data ();
4298 running_asynch_code = outer_running_asynch_code;
4300 Vdeactivate_mark = odeactivate;
4302 /* Restore waiting_for_user_input_p as it was
4303 when we were called, in case the filter clobbered it. */
4304 waiting_for_user_input_p = waiting;
4306 #if 0
4307 if (! EQ (Fcurrent_buffer (), obuffer)
4308 || ! EQ (current_buffer->keymap, okeymap))
4309 #endif
4310 /* But do it only if the caller is actually going to read events.
4311 Otherwise there's no need to make him wake up, and it could
4312 cause trouble (for example it would make Fsit_for return). */
4313 if (waiting_for_user_input_p == -1)
4314 record_asynch_buffer_change ();
4316 unbind_to (count, Qnil);
4319 /* Report all recent events of a change in process status
4320 (either run the sentinel or output a message).
4321 This is done while Emacs is waiting for keyboard input. */
4323 void
4324 status_notify ()
4326 register Lisp_Object proc, buffer;
4327 Lisp_Object tail, msg;
4328 struct gcpro gcpro1, gcpro2;
4330 tail = Qnil;
4331 msg = Qnil;
4332 /* We need to gcpro tail; if read_process_output calls a filter
4333 which deletes a process and removes the cons to which tail points
4334 from Vprocess_alist, and then causes a GC, tail is an unprotected
4335 reference. */
4336 GCPRO2 (tail, msg);
4338 /* Set this now, so that if new processes are created by sentinels
4339 that we run, we get called again to handle their status changes. */
4340 update_tick = process_tick;
4342 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
4344 Lisp_Object symbol;
4345 register struct Lisp_Process *p;
4347 proc = Fcdr (Fcar (tail));
4348 p = XPROCESS (proc);
4350 if (XINT (p->tick) != XINT (p->update_tick))
4352 XSETINT (p->update_tick, XINT (p->tick));
4354 /* If process is still active, read any output that remains. */
4355 while (! EQ (p->filter, Qt)
4356 && XINT (p->infd) >= 0
4357 && read_process_output (proc, XINT (p->infd)) > 0);
4359 buffer = p->buffer;
4361 /* Get the text to use for the message. */
4362 if (!NILP (p->raw_status_low))
4363 update_status (p);
4364 msg = status_message (p->status);
4366 /* If process is terminated, deactivate it or delete it. */
4367 symbol = p->status;
4368 if (CONSP (p->status))
4369 symbol = XCAR (p->status);
4371 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
4372 || EQ (symbol, Qclosed))
4374 if (delete_exited_processes)
4375 remove_process (proc);
4376 else
4377 deactivate_process (proc);
4380 /* The actions above may have further incremented p->tick.
4381 So set p->update_tick again
4382 so that an error in the sentinel will not cause
4383 this code to be run again. */
4384 XSETINT (p->update_tick, XINT (p->tick));
4385 /* Now output the message suitably. */
4386 if (!NILP (p->sentinel))
4387 exec_sentinel (proc, msg);
4388 /* Don't bother with a message in the buffer
4389 when a process becomes runnable. */
4390 else if (!EQ (symbol, Qrun) && !NILP (buffer))
4392 Lisp_Object ro, tem;
4393 struct buffer *old = current_buffer;
4394 int opoint, opoint_byte;
4395 int before, before_byte;
4397 ro = XBUFFER (buffer)->read_only;
4399 /* Avoid error if buffer is deleted
4400 (probably that's why the process is dead, too) */
4401 if (NILP (XBUFFER (buffer)->name))
4402 continue;
4403 Fset_buffer (buffer);
4405 opoint = PT;
4406 opoint_byte = PT_BYTE;
4407 /* Insert new output into buffer
4408 at the current end-of-output marker,
4409 thus preserving logical ordering of input and output. */
4410 if (XMARKER (p->mark)->buffer)
4411 Fgoto_char (p->mark);
4412 else
4413 SET_PT_BOTH (ZV, ZV_BYTE);
4415 before = PT;
4416 before_byte = PT_BYTE;
4418 tem = current_buffer->read_only;
4419 current_buffer->read_only = Qnil;
4420 insert_string ("\nProcess ");
4421 Finsert (1, &p->name);
4422 insert_string (" ");
4423 Finsert (1, &msg);
4424 current_buffer->read_only = tem;
4425 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
4427 if (opoint >= before)
4428 SET_PT_BOTH (opoint + (PT - before),
4429 opoint_byte + (PT_BYTE - before_byte));
4430 else
4431 SET_PT_BOTH (opoint, opoint_byte);
4433 set_buffer_internal (old);
4436 } /* end for */
4438 update_mode_lines++; /* in case buffers use %s in mode-line-format */
4439 redisplay_preserve_echo_area ();
4441 UNGCPRO;
4445 DEFUN ("set-process-coding-system", Fset_process_coding_system,
4446 Sset_process_coding_system, 1, 3, 0,
4447 "Set coding systems of PROCESS to DECODING and ENCODING.\n\
4448 DECODING will be used to decode subprocess output and ENCODING to\n\
4449 encode subprocess input.")
4450 (proc, decoding, encoding)
4451 register Lisp_Object proc, decoding, encoding;
4453 register struct Lisp_Process *p;
4455 CHECK_PROCESS (proc, 0);
4456 p = XPROCESS (proc);
4457 if (XINT (p->infd) < 0)
4458 error ("Input file descriptor of %s closed", XSTRING (p->name)->data);
4459 if (XINT (p->outfd) < 0)
4460 error ("Output file descriptor of %s closed", XSTRING (p->name)->data);
4462 p->decode_coding_system = Fcheck_coding_system (decoding);
4463 p->encode_coding_system = Fcheck_coding_system (encoding);
4464 setup_coding_system (decoding,
4465 proc_decode_coding_system[XINT (p->infd)]);
4466 setup_coding_system (encoding,
4467 proc_encode_coding_system[XINT (p->outfd)]);
4469 return Qnil;
4472 DEFUN ("process-coding-system",
4473 Fprocess_coding_system, Sprocess_coding_system, 1, 1, 0,
4474 "Return a cons of coding systems for decoding and encoding of PROCESS.")
4475 (proc)
4476 register Lisp_Object proc;
4478 CHECK_PROCESS (proc, 0);
4479 return Fcons (XPROCESS (proc)->decode_coding_system,
4480 XPROCESS (proc)->encode_coding_system);
4483 /* The first time this is called, assume keyboard input comes from DESC
4484 instead of from where we used to expect it.
4485 Subsequent calls mean assume input keyboard can come from DESC
4486 in addition to other places. */
4488 static int add_keyboard_wait_descriptor_called_flag;
4490 void
4491 add_keyboard_wait_descriptor (desc)
4492 int desc;
4494 if (! add_keyboard_wait_descriptor_called_flag)
4495 FD_CLR (0, &input_wait_mask);
4496 add_keyboard_wait_descriptor_called_flag = 1;
4497 FD_SET (desc, &input_wait_mask);
4498 FD_SET (desc, &non_process_wait_mask);
4499 if (desc > max_keyboard_desc)
4500 max_keyboard_desc = desc;
4503 /* From now on, do not expect DESC to give keyboard input. */
4505 void
4506 delete_keyboard_wait_descriptor (desc)
4507 int desc;
4509 int fd;
4510 int lim = max_keyboard_desc;
4512 FD_CLR (desc, &input_wait_mask);
4513 FD_CLR (desc, &non_process_wait_mask);
4515 if (desc == max_keyboard_desc)
4516 for (fd = 0; fd < lim; fd++)
4517 if (FD_ISSET (fd, &input_wait_mask)
4518 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4519 max_keyboard_desc = fd;
4522 /* Return nonzero if *MASK has a bit set
4523 that corresponds to one of the keyboard input descriptors. */
4526 keyboard_bit_set (mask)
4527 SELECT_TYPE *mask;
4529 int fd;
4531 for (fd = 0; fd <= max_keyboard_desc; fd++)
4532 if (FD_ISSET (fd, mask) && FD_ISSET (fd, &input_wait_mask)
4533 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4534 return 1;
4536 return 0;
4539 void
4540 init_process ()
4542 register int i;
4544 #ifdef SIGCHLD
4545 #ifndef CANNOT_DUMP
4546 if (! noninteractive || initialized)
4547 #endif
4548 signal (SIGCHLD, sigchld_handler);
4549 #endif
4551 FD_ZERO (&input_wait_mask);
4552 FD_ZERO (&non_keyboard_wait_mask);
4553 FD_ZERO (&non_process_wait_mask);
4554 max_process_desc = 0;
4556 FD_SET (0, &input_wait_mask);
4558 Vprocess_alist = Qnil;
4559 for (i = 0; i < MAXDESC; i++)
4561 chan_process[i] = Qnil;
4562 proc_buffered_char[i] = -1;
4564 bzero (proc_decode_coding_system, sizeof proc_decode_coding_system);
4565 bzero (proc_encode_coding_system, sizeof proc_encode_coding_system);
4568 void
4569 syms_of_process ()
4571 Qprocessp = intern ("processp");
4572 staticpro (&Qprocessp);
4573 Qrun = intern ("run");
4574 staticpro (&Qrun);
4575 Qstop = intern ("stop");
4576 staticpro (&Qstop);
4577 Qsignal = intern ("signal");
4578 staticpro (&Qsignal);
4580 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
4581 here again.
4583 Qexit = intern ("exit");
4584 staticpro (&Qexit); */
4586 Qopen = intern ("open");
4587 staticpro (&Qopen);
4588 Qclosed = intern ("closed");
4589 staticpro (&Qclosed);
4591 Qlast_nonmenu_event = intern ("last-nonmenu-event");
4592 staticpro (&Qlast_nonmenu_event);
4594 staticpro (&Vprocess_alist);
4596 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
4597 "*Non-nil means delete processes immediately when they exit.\n\
4598 nil means don't delete them until `list-processes' is run.");
4600 delete_exited_processes = 1;
4602 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
4603 "Control type of device used to communicate with subprocesses.\n\
4604 Values are nil to use a pipe, or t or `pty' to use a pty.\n\
4605 The value has no effect if the system has no ptys or if all ptys are busy:\n\
4606 then a pipe is used in any case.\n\
4607 The value takes effect when `start-process' is called.");
4608 Vprocess_connection_type = Qt;
4610 defsubr (&Sprocessp);
4611 defsubr (&Sget_process);
4612 defsubr (&Sget_buffer_process);
4613 defsubr (&Sdelete_process);
4614 defsubr (&Sprocess_status);
4615 defsubr (&Sprocess_exit_status);
4616 defsubr (&Sprocess_id);
4617 defsubr (&Sprocess_name);
4618 defsubr (&Sprocess_tty_name);
4619 defsubr (&Sprocess_command);
4620 defsubr (&Sset_process_buffer);
4621 defsubr (&Sprocess_buffer);
4622 defsubr (&Sprocess_mark);
4623 defsubr (&Sset_process_filter);
4624 defsubr (&Sprocess_filter);
4625 defsubr (&Sset_process_sentinel);
4626 defsubr (&Sprocess_sentinel);
4627 defsubr (&Sset_process_window_size);
4628 defsubr (&Sset_process_inherit_coding_system_flag);
4629 defsubr (&Sprocess_inherit_coding_system_flag);
4630 defsubr (&Sprocess_kill_without_query);
4631 defsubr (&Sprocess_contact);
4632 defsubr (&Slist_processes);
4633 defsubr (&Sprocess_list);
4634 defsubr (&Sstart_process);
4635 #ifdef HAVE_SOCKETS
4636 defsubr (&Sopen_network_stream);
4637 #endif /* HAVE_SOCKETS */
4638 defsubr (&Saccept_process_output);
4639 defsubr (&Sprocess_send_region);
4640 defsubr (&Sprocess_send_string);
4641 defsubr (&Sinterrupt_process);
4642 defsubr (&Skill_process);
4643 defsubr (&Squit_process);
4644 defsubr (&Sstop_process);
4645 defsubr (&Scontinue_process);
4646 defsubr (&Sprocess_running_child_p);
4647 defsubr (&Sprocess_send_eof);
4648 defsubr (&Ssignal_process);
4649 defsubr (&Swaiting_for_user_input_p);
4650 /* defsubr (&Sprocess_connection); */
4651 defsubr (&Sset_process_coding_system);
4652 defsubr (&Sprocess_coding_system);
4656 #else /* not subprocesses */
4658 #include <sys/types.h>
4659 #include <errno.h>
4661 #include "lisp.h"
4662 #include "systime.h"
4663 #include "charset.h"
4664 #include "coding.h"
4665 #include "termopts.h"
4666 #include "sysselect.h"
4668 extern int frame_garbaged;
4670 extern EMACS_TIME timer_check ();
4671 extern int timers_run;
4673 /* As described above, except assuming that there are no subprocesses:
4675 Wait for timeout to elapse and/or keyboard input to be available.
4677 time_limit is:
4678 timeout in seconds, or
4679 zero for no limit, or
4680 -1 means gobble data immediately available but don't wait for any.
4682 read_kbd is a Lisp_Object:
4683 0 to ignore keyboard input, or
4684 1 to return when input is available, or
4685 -1 means caller will actually read the input, so don't throw to
4686 the quit handler.
4687 a cons cell, meaning wait until its car is non-nil
4688 (and gobble terminal input into the buffer if any arrives), or
4689 We know that read_kbd will never be a Lisp_Process, since
4690 `subprocesses' isn't defined.
4692 do_display != 0 means redisplay should be done to show subprocess
4693 output that arrives.
4695 Return true iff we received input from any process. */
4698 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
4699 int time_limit, microsecs;
4700 Lisp_Object read_kbd;
4701 int do_display;
4703 register int nfds;
4704 EMACS_TIME end_time, timeout;
4705 SELECT_TYPE waitchannels;
4706 int xerrno;
4707 Lisp_Object *wait_for_cell = 0;
4709 /* If waiting for non-nil in a cell, record where. */
4710 if (CONSP (read_kbd))
4712 wait_for_cell = &XCAR (read_kbd);
4713 XSETFASTINT (read_kbd, 0);
4716 /* What does time_limit really mean? */
4717 if (time_limit || microsecs)
4719 EMACS_GET_TIME (end_time);
4720 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
4721 EMACS_ADD_TIME (end_time, end_time, timeout);
4724 /* Turn off periodic alarms (in case they are in use)
4725 because the select emulator uses alarms. */
4726 turn_on_atimers (0);
4728 while (1)
4730 int timeout_reduced_for_timers = 0;
4732 /* If calling from keyboard input, do not quit
4733 since we want to return C-g as an input character.
4734 Otherwise, do pending quit if requested. */
4735 if (XINT (read_kbd) >= 0)
4736 QUIT;
4738 /* Exit now if the cell we're waiting for became non-nil. */
4739 if (wait_for_cell && ! NILP (*wait_for_cell))
4740 break;
4742 /* Compute time from now till when time limit is up */
4743 /* Exit if already run out */
4744 if (time_limit == -1)
4746 /* -1 specified for timeout means
4747 gobble output available now
4748 but don't wait at all. */
4750 EMACS_SET_SECS_USECS (timeout, 0, 0);
4752 else if (time_limit || microsecs)
4754 EMACS_GET_TIME (timeout);
4755 EMACS_SUB_TIME (timeout, end_time, timeout);
4756 if (EMACS_TIME_NEG_P (timeout))
4757 break;
4759 else
4761 EMACS_SET_SECS_USECS (timeout, 100000, 0);
4764 /* If our caller will not immediately handle keyboard events,
4765 run timer events directly.
4766 (Callers that will immediately read keyboard events
4767 call timer_delay on their own.) */
4768 if (! wait_for_cell)
4770 EMACS_TIME timer_delay;
4771 int old_timers_run;
4773 retry:
4774 old_timers_run = timers_run;
4775 timer_delay = timer_check (1);
4776 if (timers_run != old_timers_run && do_display)
4778 redisplay_preserve_echo_area ();
4779 /* We must retry, since a timer may have requeued itself
4780 and that could alter the time delay. */
4781 goto retry;
4784 /* If there is unread keyboard input, also return. */
4785 if (XINT (read_kbd) != 0
4786 && requeued_events_pending_p ())
4787 break;
4789 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
4791 EMACS_TIME difference;
4792 EMACS_SUB_TIME (difference, timer_delay, timeout);
4793 if (EMACS_TIME_NEG_P (difference))
4795 timeout = timer_delay;
4796 timeout_reduced_for_timers = 1;
4801 /* Cause C-g and alarm signals to take immediate action,
4802 and cause input available signals to zero out timeout. */
4803 if (XINT (read_kbd) < 0)
4804 set_waiting_for_input (&timeout);
4806 /* Wait till there is something to do. */
4808 if (! XINT (read_kbd) && wait_for_cell == 0)
4809 FD_ZERO (&waitchannels);
4810 else
4811 FD_SET (0, &waitchannels);
4813 /* If a frame has been newly mapped and needs updating,
4814 reprocess its display stuff. */
4815 if (frame_garbaged && do_display)
4817 clear_waiting_for_input ();
4818 redisplay_preserve_echo_area ();
4819 if (XINT (read_kbd) < 0)
4820 set_waiting_for_input (&timeout);
4823 if (XINT (read_kbd) && detect_input_pending ())
4825 nfds = 0;
4826 FD_ZERO (&waitchannels);
4828 else
4829 nfds = select (1, &waitchannels, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
4830 &timeout);
4832 xerrno = errno;
4834 /* Make C-g and alarm signals set flags again */
4835 clear_waiting_for_input ();
4837 /* If we woke up due to SIGWINCH, actually change size now. */
4838 do_pending_window_change (0);
4840 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
4841 /* We waited the full specified time, so return now. */
4842 break;
4844 if (nfds == -1)
4846 /* If the system call was interrupted, then go around the
4847 loop again. */
4848 if (xerrno == EINTR)
4849 FD_ZERO (&waitchannels);
4850 else
4851 error ("select error: %s", emacs_strerror (xerrno));
4853 #ifdef sun
4854 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
4855 /* System sometimes fails to deliver SIGIO. */
4856 kill (getpid (), SIGIO);
4857 #endif
4858 #ifdef SIGIO
4859 if (XINT (read_kbd) && interrupt_input && (waitchannels & 1))
4860 kill (getpid (), SIGIO);
4861 #endif
4863 /* Check for keyboard input */
4865 if ((XINT (read_kbd) != 0)
4866 && detect_input_pending_run_timers (do_display))
4868 swallow_events (do_display);
4869 if (detect_input_pending_run_timers (do_display))
4870 break;
4873 /* If there is unread keyboard input, also return. */
4874 if (XINT (read_kbd) != 0
4875 && requeued_events_pending_p ())
4876 break;
4878 /* If wait_for_cell. check for keyboard input
4879 but don't run any timers.
4880 ??? (It seems wrong to me to check for keyboard
4881 input at all when wait_for_cell, but the code
4882 has been this way since July 1994.
4883 Try changing this after version 19.31.) */
4884 if (wait_for_cell
4885 && detect_input_pending ())
4887 swallow_events (do_display);
4888 if (detect_input_pending ())
4889 break;
4892 /* Exit now if the cell we're waiting for became non-nil. */
4893 if (wait_for_cell && ! NILP (*wait_for_cell))
4894 break;
4897 start_polling ();
4899 return 0;
4903 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
4904 /* Don't confuse make-docfile by having two doc strings for this function.
4905 make-docfile does not pay attention to #if, for good reason! */
4907 (name)
4908 register Lisp_Object name;
4910 return Qnil;
4913 DEFUN ("process-inherit-coding-system-flag",
4914 Fprocess_inherit_coding_system_flag, Sprocess_inherit_coding_system_flag,
4915 1, 1, 0,
4916 /* Don't confuse make-docfile by having two doc strings for this function.
4917 make-docfile does not pay attention to #if, for good reason! */
4919 (process)
4920 register Lisp_Object process;
4922 /* Ignore the argument and return the value of
4923 inherit-process-coding-system. */
4924 return inherit_process_coding_system ? Qt : Qnil;
4927 /* Kill all processes associated with `buffer'.
4928 If `buffer' is nil, kill all processes.
4929 Since we have no subprocesses, this does nothing. */
4931 void
4932 kill_buffer_processes (buffer)
4933 Lisp_Object buffer;
4937 void
4938 init_process ()
4942 void
4943 syms_of_process ()
4945 defsubr (&Sget_buffer_process);
4946 defsubr (&Sprocess_inherit_coding_system_flag);
4950 #endif /* not subprocesses */