]> code.delx.au - gnu-emacs/blob - src/process.c
frame-override-unsplittable/inhibit-frame-unsplittable name change.
[gnu-emacs] / src / process.c
1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 1996
3 Free Software Foundation, Inc.
4
5 This file is part of GNU Emacs.
6
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.
11
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.
16
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. */
21
22
23 #include <signal.h>
24
25 #include <config.h>
26
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. */
33
34 \f
35 #ifdef subprocesses
36
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
46
47 #ifdef WINDOWSNT
48 #include <stdlib.h>
49 #include <fcntl.h>
50 #endif /* not WINDOWSNT */
51
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 */
61
62 /* TERM is a poor-man's SLIP, used on Linux. */
63 #ifdef TERM
64 #include <client.h>
65 #endif
66
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
75
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 */
82
83 #ifdef BROKEN_O_NONBLOCK
84 #undef O_NONBLOCK
85 #endif /* BROKEN_O_NONBLOCK */
86
87 #ifdef NEED_BSDTTY
88 #include <bsdtty.h>
89 #endif
90
91 #ifdef IRIS
92 #include <sys/sysmacros.h> /* for "minor" */
93 #endif /* not IRIS */
94
95 #include "systime.h"
96 #include "systty.h"
97
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 "frame.h"
108 #include "blockinput.h"
109
110 Lisp_Object Qprocessp;
111 Lisp_Object Qrun, Qstop, Qsignal, Qopen, Qclosed;
112 Lisp_Object Qlast_nonmenu_event;
113 /* Qexit is declared and initialized in eval.c. */
114
115 /* a process object is a network connection when its childp field is neither
116 Qt nor Qnil but is instead a cons cell (HOSTNAME PORTNUM). */
117
118 #ifdef HAVE_SOCKETS
119 #define NETCONN_P(p) (GC_CONSP (XPROCESS (p)->childp))
120 #else
121 #define NETCONN_P(p) 0
122 #endif /* HAVE_SOCKETS */
123
124 /* Define first descriptor number available for subprocesses. */
125 #ifdef VMS
126 #define FIRST_PROC_DESC 1
127 #else /* Not VMS */
128 #define FIRST_PROC_DESC 3
129 #endif
130
131 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
132 testing SIGCHLD. */
133
134 #if !defined (SIGCHLD) && defined (SIGCLD)
135 #define SIGCHLD SIGCLD
136 #endif /* SIGCLD */
137
138 #include "syssignal.h"
139
140 #include "syswait.h"
141
142 extern int errno;
143 extern char *strerror ();
144 #ifdef VMS
145 extern char *sys_errlist[];
146 #endif
147
148 #ifndef HAVE_H_ERRNO
149 extern int h_errno;
150 #endif
151
152 #ifndef SYS_SIGLIST_DECLARED
153 #ifndef VMS
154 #ifndef BSD4_1
155 #ifndef WINDOWSNT
156 #ifndef LINUX
157 extern char *sys_siglist[];
158 #endif /* not LINUX */
159 #else /* BSD4_1 */
160 char *sys_siglist[] =
161 {
162 "bum signal!!",
163 "hangup",
164 "interrupt",
165 "quit",
166 "illegal instruction",
167 "trace trap",
168 "iot instruction",
169 "emt instruction",
170 "floating point exception",
171 "kill",
172 "bus error",
173 "segmentation violation",
174 "bad argument to system call",
175 "write on a pipe with no one to read it",
176 "alarm clock",
177 "software termination signal from kill",
178 "status signal",
179 "sendable stop signal not from tty",
180 "stop signal from tty",
181 "continue a stopped process",
182 "child status has changed",
183 "background read attempted from control tty",
184 "background write attempted from control tty",
185 "input record available at control tty",
186 "exceeded CPU time limit",
187 "exceeded file size limit"
188 };
189 #endif /* not WINDOWSNT */
190 #endif
191 #endif /* VMS */
192 #endif /* ! SYS_SIGLIST_DECLARED */
193
194 /* t means use pty, nil means use a pipe,
195 maybe other values to come. */
196 static Lisp_Object Vprocess_connection_type;
197
198 #ifdef SKTPAIR
199 #ifndef HAVE_SOCKETS
200 #include <sys/socket.h>
201 #endif
202 #endif /* SKTPAIR */
203
204 /* These next two vars are non-static since sysdep.c uses them in the
205 emulation of `select'. */
206 /* Number of events of change of status of a process. */
207 int process_tick;
208 /* Number of events for which the user or sentinel has been notified. */
209 int update_tick;
210
211 #include "sysselect.h"
212
213 /* If we support a window system, turn on the code to poll periodically
214 to detect C-g. It isn't actually used when doing interrupt input. */
215 #ifdef HAVE_WINDOW_SYSTEM
216 #define POLL_FOR_INPUT
217 #endif
218
219 /* Mask of bits indicating the descriptors that we wait for input on. */
220
221 static SELECT_TYPE input_wait_mask;
222
223 /* Mask that excludes keyboard input descriptor (s). */
224
225 static SELECT_TYPE non_keyboard_wait_mask;
226
227 /* Mask that excludes process input descriptor (s). */
228
229 static SELECT_TYPE non_process_wait_mask;
230
231 /* The largest descriptor currently in use for a process object. */
232 static int max_process_desc;
233
234 /* The largest descriptor currently in use for keyboard input. */
235 static int max_keyboard_desc;
236
237 /* Nonzero means delete a process right away if it exits. */
238 static int delete_exited_processes;
239
240 /* Indexed by descriptor, gives the process (if any) for that descriptor */
241 Lisp_Object chan_process[MAXDESC];
242
243 /* Alist of elements (NAME . PROCESS) */
244 Lisp_Object Vprocess_alist;
245
246 /* Buffered-ahead input char from process, indexed by channel.
247 -1 means empty (no char is buffered).
248 Used on sys V where the only way to tell if there is any
249 output from the process is to read at least one char.
250 Always -1 on systems that support FIONREAD. */
251
252 /* Don't make static; need to access externally. */
253 int proc_buffered_char[MAXDESC];
254
255 /* Table of `struct coding-system' for each process. */
256 static struct coding_system *proc_decode_coding_system[MAXDESC];
257 static struct coding_system *proc_encode_coding_system[MAXDESC];
258
259 static Lisp_Object get_process ();
260
261 extern EMACS_TIME timer_check ();
262 extern int timers_run;
263
264 /* Maximum number of bytes to send to a pty without an eof. */
265 static int pty_max_bytes;
266
267 #ifdef HAVE_PTYS
268 /* The file name of the pty opened by allocate_pty. */
269
270 static char pty_name[24];
271 #endif
272 \f
273 /* Compute the Lisp form of the process status, p->status, from
274 the numeric status that was returned by `wait'. */
275
276 Lisp_Object status_convert ();
277
278 update_status (p)
279 struct Lisp_Process *p;
280 {
281 union { int i; WAITTYPE wt; } u;
282 u.i = XFASTINT (p->raw_status_low) + (XFASTINT (p->raw_status_high) << 16);
283 p->status = status_convert (u.wt);
284 p->raw_status_low = Qnil;
285 p->raw_status_high = Qnil;
286 }
287
288 /* Convert a process status word in Unix format to
289 the list that we use internally. */
290
291 Lisp_Object
292 status_convert (w)
293 WAITTYPE w;
294 {
295 if (WIFSTOPPED (w))
296 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
297 else if (WIFEXITED (w))
298 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
299 WCOREDUMP (w) ? Qt : Qnil));
300 else if (WIFSIGNALED (w))
301 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
302 WCOREDUMP (w) ? Qt : Qnil));
303 else
304 return Qrun;
305 }
306
307 /* Given a status-list, extract the three pieces of information
308 and store them individually through the three pointers. */
309
310 void
311 decode_status (l, symbol, code, coredump)
312 Lisp_Object l;
313 Lisp_Object *symbol;
314 int *code;
315 int *coredump;
316 {
317 Lisp_Object tem;
318
319 if (SYMBOLP (l))
320 {
321 *symbol = l;
322 *code = 0;
323 *coredump = 0;
324 }
325 else
326 {
327 *symbol = XCONS (l)->car;
328 tem = XCONS (l)->cdr;
329 *code = XFASTINT (XCONS (tem)->car);
330 tem = XCONS (tem)->cdr;
331 *coredump = !NILP (tem);
332 }
333 }
334
335 /* Return a string describing a process status list. */
336
337 Lisp_Object
338 status_message (status)
339 Lisp_Object status;
340 {
341 Lisp_Object symbol;
342 int code, coredump;
343 Lisp_Object string, string2;
344
345 decode_status (status, &symbol, &code, &coredump);
346
347 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
348 {
349 char *signame = 0;
350 if (code < NSIG)
351 {
352 #ifndef VMS
353 /* Cast to suppress warning if the table has const char *. */
354 signame = (char *) sys_siglist[code];
355 #else
356 signame = sys_errlist[code];
357 #endif
358 }
359 if (signame == 0)
360 signame = "unknown";
361 string = build_string (signame);
362 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
363 XSTRING (string)->data[0] = DOWNCASE (XSTRING (string)->data[0]);
364 return concat2 (string, string2);
365 }
366 else if (EQ (symbol, Qexit))
367 {
368 if (code == 0)
369 return build_string ("finished\n");
370 string = Fnumber_to_string (make_number (code));
371 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
372 return concat2 (build_string ("exited abnormally with code "),
373 concat2 (string, string2));
374 }
375 else
376 return Fcopy_sequence (Fsymbol_name (symbol));
377 }
378 \f
379 #ifdef HAVE_PTYS
380
381 /* Open an available pty, returning a file descriptor.
382 Return -1 on failure.
383 The file name of the terminal corresponding to the pty
384 is left in the variable pty_name. */
385
386 int
387 allocate_pty ()
388 {
389 struct stat stb;
390 register c, i;
391 int fd;
392
393 /* Some systems name their pseudoterminals so that there are gaps in
394 the usual sequence - for example, on HP9000/S700 systems, there
395 are no pseudoterminals with names ending in 'f'. So we wait for
396 three failures in a row before deciding that we've reached the
397 end of the ptys. */
398 int failed_count = 0;
399
400 #ifdef PTY_ITERATION
401 PTY_ITERATION
402 #else
403 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
404 for (i = 0; i < 16; i++)
405 #endif
406 {
407 #ifdef PTY_NAME_SPRINTF
408 PTY_NAME_SPRINTF
409 #else
410 sprintf (pty_name, "/dev/pty%c%x", c, i);
411 #endif /* no PTY_NAME_SPRINTF */
412
413 #ifdef PTY_OPEN
414 PTY_OPEN;
415 #else /* no PTY_OPEN */
416 #ifdef IRIS
417 /* Unusual IRIS code */
418 *ptyv = open ("/dev/ptc", O_RDWR | O_NDELAY, 0);
419 if (fd < 0)
420 return -1;
421 if (fstat (fd, &stb) < 0)
422 return -1;
423 #else /* not IRIS */
424 if (stat (pty_name, &stb) < 0)
425 {
426 failed_count++;
427 if (failed_count >= 3)
428 return -1;
429 }
430 else
431 failed_count = 0;
432 #ifdef O_NONBLOCK
433 fd = open (pty_name, O_RDWR | O_NONBLOCK, 0);
434 #else
435 fd = open (pty_name, O_RDWR | O_NDELAY, 0);
436 #endif
437 #endif /* not IRIS */
438 #endif /* no PTY_OPEN */
439
440 if (fd >= 0)
441 {
442 /* check to make certain that both sides are available
443 this avoids a nasty yet stupid bug in rlogins */
444 #ifdef PTY_TTY_NAME_SPRINTF
445 PTY_TTY_NAME_SPRINTF
446 #else
447 sprintf (pty_name, "/dev/tty%c%x", c, i);
448 #endif /* no PTY_TTY_NAME_SPRINTF */
449 #ifndef UNIPLUS
450 if (access (pty_name, 6) != 0)
451 {
452 close (fd);
453 #if !defined(IRIS) && !defined(__sgi)
454 continue;
455 #else
456 return -1;
457 #endif /* IRIS */
458 }
459 #endif /* not UNIPLUS */
460 setup_pty (fd);
461 return fd;
462 }
463 }
464 return -1;
465 }
466 #endif /* HAVE_PTYS */
467 \f
468 Lisp_Object
469 make_process (name)
470 Lisp_Object name;
471 {
472 struct Lisp_Vector *vec;
473 register Lisp_Object val, tem, name1;
474 register struct Lisp_Process *p;
475 char suffix[10];
476 register int i;
477
478 vec = allocate_vectorlike ((EMACS_INT) VECSIZE (struct Lisp_Process));
479 for (i = 0; i < VECSIZE (struct Lisp_Process); i++)
480 vec->contents[i] = Qnil;
481 vec->size = VECSIZE (struct Lisp_Process);
482 p = (struct Lisp_Process *)vec;
483
484 XSETINT (p->infd, -1);
485 XSETINT (p->outfd, -1);
486 XSETFASTINT (p->pid, 0);
487 XSETFASTINT (p->tick, 0);
488 XSETFASTINT (p->update_tick, 0);
489 p->raw_status_low = Qnil;
490 p->raw_status_high = Qnil;
491 p->status = Qrun;
492 p->mark = Fmake_marker ();
493
494 /* If name is already in use, modify it until it is unused. */
495
496 name1 = name;
497 for (i = 1; ; i++)
498 {
499 tem = Fget_process (name1);
500 if (NILP (tem)) break;
501 sprintf (suffix, "<%d>", i);
502 name1 = concat2 (name, build_string (suffix));
503 }
504 name = name1;
505 p->name = name;
506 XSETPROCESS (val, p);
507 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
508 return val;
509 }
510
511 remove_process (proc)
512 register Lisp_Object proc;
513 {
514 register Lisp_Object pair;
515
516 pair = Frassq (proc, Vprocess_alist);
517 Vprocess_alist = Fdelq (pair, Vprocess_alist);
518
519 deactivate_process (proc);
520 }
521 \f
522 DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
523 "Return t if OBJECT is a process.")
524 (object)
525 Lisp_Object object;
526 {
527 return PROCESSP (object) ? Qt : Qnil;
528 }
529
530 DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
531 "Return the process named NAME, or nil if there is none.")
532 (name)
533 register Lisp_Object name;
534 {
535 if (PROCESSP (name))
536 return name;
537 CHECK_STRING (name, 0);
538 return Fcdr (Fassoc (name, Vprocess_alist));
539 }
540
541 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
542 "Return the (or, a) process associated with BUFFER.\n\
543 BUFFER may be a buffer or the name of one.")
544 (buffer)
545 register Lisp_Object buffer;
546 {
547 register Lisp_Object buf, tail, proc;
548
549 if (NILP (buffer)) return Qnil;
550 buf = Fget_buffer (buffer);
551 if (NILP (buf)) return Qnil;
552
553 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
554 {
555 proc = Fcdr (Fcar (tail));
556 if (PROCESSP (proc) && EQ (XPROCESS (proc)->buffer, buf))
557 return proc;
558 }
559 return Qnil;
560 }
561
562 /* This is how commands for the user decode process arguments. It
563 accepts a process, a process name, a buffer, a buffer name, or nil.
564 Buffers denote the first process in the buffer, and nil denotes the
565 current buffer. */
566
567 static Lisp_Object
568 get_process (name)
569 register Lisp_Object name;
570 {
571 register Lisp_Object proc, obj;
572 if (STRINGP (name))
573 {
574 obj = Fget_process (name);
575 if (NILP (obj))
576 obj = Fget_buffer (name);
577 if (NILP (obj))
578 error ("Process %s does not exist", XSTRING (name)->data);
579 }
580 else if (NILP (name))
581 obj = Fcurrent_buffer ();
582 else
583 obj = name;
584
585 /* Now obj should be either a buffer object or a process object.
586 */
587 if (BUFFERP (obj))
588 {
589 proc = Fget_buffer_process (obj);
590 if (NILP (proc))
591 error ("Buffer %s has no process", XSTRING (XBUFFER (obj)->name)->data);
592 }
593 else
594 {
595 CHECK_PROCESS (obj, 0);
596 proc = obj;
597 }
598 return proc;
599 }
600
601 DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
602 "Delete PROCESS: kill it and forget about it immediately.\n\
603 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
604 nil, indicating the current buffer's process.")
605 (process)
606 register Lisp_Object process;
607 {
608 process = get_process (process);
609 XPROCESS (process)->raw_status_low = Qnil;
610 XPROCESS (process)->raw_status_high = Qnil;
611 if (NETCONN_P (process))
612 {
613 XPROCESS (process)->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
614 XSETINT (XPROCESS (process)->tick, ++process_tick);
615 }
616 else if (XINT (XPROCESS (process)->infd) >= 0)
617 {
618 Fkill_process (process, Qnil);
619 /* Do this now, since remove_process will make sigchld_handler do nothing. */
620 XPROCESS (process)->status
621 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
622 XSETINT (XPROCESS (process)->tick, ++process_tick);
623 status_notify ();
624 }
625 remove_process (process);
626 return Qnil;
627 }
628 \f
629 DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
630 "Return the status of PROCESS: a symbol, one of these:\n\
631 run -- for a process that is running.\n\
632 stop -- for a process stopped but continuable.\n\
633 exit -- for a process that has exited.\n\
634 signal -- for a process that has got a fatal signal.\n\
635 open -- for a network stream connection that is open.\n\
636 closed -- for a network stream connection that is closed.\n\
637 nil -- if arg is a process name and no such process exists.\n\
638 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
639 nil, indicating the current buffer's process.")
640 (process)
641 register Lisp_Object process;
642 {
643 register struct Lisp_Process *p;
644 register Lisp_Object status;
645
646 if (STRINGP (process))
647 process = Fget_process (process);
648 else
649 process = get_process (process);
650
651 if (NILP (process))
652 return process;
653
654 p = XPROCESS (process);
655 if (!NILP (p->raw_status_low))
656 update_status (p);
657 status = p->status;
658 if (CONSP (status))
659 status = XCONS (status)->car;
660 if (NETCONN_P (process))
661 {
662 if (EQ (status, Qrun))
663 status = Qopen;
664 else if (EQ (status, Qexit))
665 status = Qclosed;
666 }
667 return status;
668 }
669
670 DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
671 1, 1, 0,
672 "Return the exit status of PROCESS or the signal number that killed it.\n\
673 If PROCESS has not yet exited or died, return 0.")
674 (process)
675 register Lisp_Object process;
676 {
677 CHECK_PROCESS (process, 0);
678 if (!NILP (XPROCESS (process)->raw_status_low))
679 update_status (XPROCESS (process));
680 if (CONSP (XPROCESS (process)->status))
681 return XCONS (XCONS (XPROCESS (process)->status)->cdr)->car;
682 return make_number (0);
683 }
684
685 DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
686 "Return the process id of PROCESS.\n\
687 This is the pid of the Unix process which PROCESS uses or talks to.\n\
688 For a network connection, this value is nil.")
689 (process)
690 register Lisp_Object process;
691 {
692 CHECK_PROCESS (process, 0);
693 return XPROCESS (process)->pid;
694 }
695
696 DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
697 "Return the name of PROCESS, as a string.\n\
698 This is the name of the program invoked in PROCESS,\n\
699 possibly modified to make it unique among process names.")
700 (process)
701 register Lisp_Object process;
702 {
703 CHECK_PROCESS (process, 0);
704 return XPROCESS (process)->name;
705 }
706
707 DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
708 "Return the command that was executed to start PROCESS.\n\
709 This is a list of strings, the first string being the program executed\n\
710 and the rest of the strings being the arguments given to it.\n\
711 For a non-child channel, this is nil.")
712 (process)
713 register Lisp_Object process;
714 {
715 CHECK_PROCESS (process, 0);
716 return XPROCESS (process)->command;
717 }
718
719 DEFUN ("process-tty-name", Fprocess_tty_name, Sprocess_tty_name, 1, 1, 0,
720 "Return the name of the terminal PROCESS uses, or nil if none.\n\
721 This is the terminal that the process itself reads and writes on,\n\
722 not the name of the pty that Emacs uses to talk with that terminal.")
723 (process)
724 register Lisp_Object process;
725 {
726 CHECK_PROCESS (process, 0);
727 return XPROCESS (process)->tty_name;
728 }
729
730 DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
731 2, 2, 0,
732 "Set buffer associated with PROCESS to BUFFER (a buffer, or nil).")
733 (process, buffer)
734 register Lisp_Object process, buffer;
735 {
736 CHECK_PROCESS (process, 0);
737 if (!NILP (buffer))
738 CHECK_BUFFER (buffer, 1);
739 XPROCESS (process)->buffer = buffer;
740 return buffer;
741 }
742
743 DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
744 1, 1, 0,
745 "Return the buffer PROCESS is associated with.\n\
746 Output from PROCESS is inserted in this buffer\n\
747 unless PROCESS has a filter.")
748 (process)
749 register Lisp_Object process;
750 {
751 CHECK_PROCESS (process, 0);
752 return XPROCESS (process)->buffer;
753 }
754
755 DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
756 1, 1, 0,
757 "Return the marker for the end of the last output from PROCESS.")
758 (process)
759 register Lisp_Object process;
760 {
761 CHECK_PROCESS (process, 0);
762 return XPROCESS (process)->mark;
763 }
764
765 DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
766 2, 2, 0,
767 "Give PROCESS the filter function FILTER; nil means no filter.\n\
768 t means stop accepting output from the process.\n\
769 When a process has a filter, each time it does output\n\
770 the entire string of output is passed to the filter.\n\
771 The filter gets two arguments: the process and the string of output.\n\
772 If the process has a filter, its buffer is not used for output.")
773 (process, filter)
774 register Lisp_Object process, filter;
775 {
776 CHECK_PROCESS (process, 0);
777 if (EQ (filter, Qt))
778 {
779 FD_CLR (XINT (XPROCESS (process)->infd), &input_wait_mask);
780 FD_CLR (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
781 }
782 else if (EQ (XPROCESS (process)->filter, Qt))
783 {
784 FD_SET (XINT (XPROCESS (process)->infd), &input_wait_mask);
785 FD_SET (XINT (XPROCESS (process)->infd), &non_keyboard_wait_mask);
786 }
787 XPROCESS (process)->filter = filter;
788 return filter;
789 }
790
791 DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
792 1, 1, 0,
793 "Returns the filter function of PROCESS; nil if none.\n\
794 See `set-process-filter' for more info on filter functions.")
795 (process)
796 register Lisp_Object process;
797 {
798 CHECK_PROCESS (process, 0);
799 return XPROCESS (process)->filter;
800 }
801
802 DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
803 2, 2, 0,
804 "Give PROCESS the sentinel SENTINEL; nil for none.\n\
805 The sentinel is called as a function when the process changes state.\n\
806 It gets two arguments: the process, and a string describing the change.")
807 (process, sentinel)
808 register Lisp_Object process, sentinel;
809 {
810 CHECK_PROCESS (process, 0);
811 XPROCESS (process)->sentinel = sentinel;
812 return sentinel;
813 }
814
815 DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
816 1, 1, 0,
817 "Return the sentinel of PROCESS; nil if none.\n\
818 See `set-process-sentinel' for more info on sentinels.")
819 (process)
820 register Lisp_Object process;
821 {
822 CHECK_PROCESS (process, 0);
823 return XPROCESS (process)->sentinel;
824 }
825
826 DEFUN ("set-process-window-size", Fset_process_window_size,
827 Sset_process_window_size, 3, 3, 0,
828 "Tell PROCESS that it has logical window size HEIGHT and WIDTH.")
829 (process, height, width)
830 register Lisp_Object process, height, width;
831 {
832 CHECK_PROCESS (process, 0);
833 CHECK_NATNUM (height, 0);
834 CHECK_NATNUM (width, 0);
835 if (set_window_size (XINT (XPROCESS (process)->infd),
836 XINT (height), XINT(width)) <= 0)
837 return Qnil;
838 else
839 return Qt;
840 }
841
842 DEFUN ("process-kill-without-query", Fprocess_kill_without_query,
843 Sprocess_kill_without_query, 1, 2, 0,
844 "Say no query needed if PROCESS is running when Emacs is exited.\n\
845 Optional second argument if non-nil says to require a query.\n\
846 Value is t if a query was formerly required.")
847 (process, value)
848 register Lisp_Object process, value;
849 {
850 Lisp_Object tem;
851
852 CHECK_PROCESS (process, 0);
853 tem = XPROCESS (process)->kill_without_query;
854 XPROCESS (process)->kill_without_query = Fnull (value);
855
856 return Fnull (tem);
857 }
858
859 DEFUN ("process-contact", Fprocess_contact, Sprocess_contact,
860 1, 1, 0,
861 "Return the contact info of PROCESS; t for a real child.\n\
862 For a net connection, the value is a cons cell of the form (HOST SERVICE).")
863 (process)
864 register Lisp_Object process;
865 {
866 CHECK_PROCESS (process, 0);
867 return XPROCESS (process)->childp;
868 }
869
870 #if 0 /* Turned off because we don't currently record this info
871 in the process. Perhaps add it. */
872 DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 1, 1, 0,
873 "Return the connection type of `PROCESS'.\n\
874 The value is `nil' for a pipe,\n\
875 `t' or `pty' for a pty, or `stream' for a socket connection.")
876 (process)
877 Lisp_Object process;
878 {
879 return XPROCESS (process)->type;
880 }
881 #endif
882 \f
883 Lisp_Object
884 list_processes_1 ()
885 {
886 register Lisp_Object tail, tem;
887 Lisp_Object proc, minspace, tem1;
888 register struct buffer *old = current_buffer;
889 register struct Lisp_Process *p;
890 register int state;
891 char tembuf[80];
892
893 XSETFASTINT (minspace, 1);
894
895 set_buffer_internal (XBUFFER (Vstandard_output));
896 Fbuffer_disable_undo (Vstandard_output);
897
898 current_buffer->truncate_lines = Qt;
899
900 write_string ("\
901 Proc Status Buffer Tty Command\n\
902 ---- ------ ------ --- -------\n", -1);
903
904 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
905 {
906 Lisp_Object symbol;
907
908 proc = Fcdr (Fcar (tail));
909 p = XPROCESS (proc);
910 if (NILP (p->childp))
911 continue;
912
913 Finsert (1, &p->name);
914 Findent_to (make_number (13), minspace);
915
916 if (!NILP (p->raw_status_low))
917 update_status (p);
918 symbol = p->status;
919 if (CONSP (p->status))
920 symbol = XCONS (p->status)->car;
921
922
923 if (EQ (symbol, Qsignal))
924 {
925 Lisp_Object tem;
926 tem = Fcar (Fcdr (p->status));
927 #ifdef VMS
928 if (XINT (tem) < NSIG)
929 write_string (sys_errlist [XINT (tem)], -1);
930 else
931 #endif
932 Fprinc (symbol, Qnil);
933 }
934 else if (NETCONN_P (proc))
935 {
936 if (EQ (symbol, Qrun))
937 write_string ("open", -1);
938 else if (EQ (symbol, Qexit))
939 write_string ("closed", -1);
940 else
941 Fprinc (symbol, Qnil);
942 }
943 else
944 Fprinc (symbol, Qnil);
945
946 if (EQ (symbol, Qexit))
947 {
948 Lisp_Object tem;
949 tem = Fcar (Fcdr (p->status));
950 if (XFASTINT (tem))
951 {
952 sprintf (tembuf, " %d", (int) XFASTINT (tem));
953 write_string (tembuf, -1);
954 }
955 }
956
957 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
958 remove_process (proc);
959
960 Findent_to (make_number (22), minspace);
961 if (NILP (p->buffer))
962 insert_string ("(none)");
963 else if (NILP (XBUFFER (p->buffer)->name))
964 insert_string ("(Killed)");
965 else
966 Finsert (1, &XBUFFER (p->buffer)->name);
967
968 Findent_to (make_number (37), minspace);
969
970 if (STRINGP (p->tty_name))
971 Finsert (1, &p->tty_name);
972 else
973 insert_string ("(none)");
974
975 Findent_to (make_number (49), minspace);
976
977 if (NETCONN_P (proc))
978 {
979 sprintf (tembuf, "(network stream connection to %s)\n",
980 XSTRING (XCONS (p->childp)->car)->data);
981 insert_string (tembuf);
982 }
983 else
984 {
985 tem = p->command;
986 while (1)
987 {
988 tem1 = Fcar (tem);
989 Finsert (1, &tem1);
990 tem = Fcdr (tem);
991 if (NILP (tem))
992 break;
993 insert_string (" ");
994 }
995 insert_string ("\n");
996 }
997 }
998 return Qnil;
999 }
1000
1001 DEFUN ("list-processes", Flist_processes, Slist_processes, 0, 0, "",
1002 "Display a list of all processes.\n\
1003 \(Any processes listed as Exited or Signaled are actually eliminated\n\
1004 after the listing is made.)")
1005 ()
1006 {
1007 internal_with_output_to_temp_buffer ("*Process List*",
1008 list_processes_1, Qnil);
1009 return Qnil;
1010 }
1011
1012 DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
1013 "Return a list of all processes.")
1014 ()
1015 {
1016 return Fmapcar (Qcdr, Vprocess_alist);
1017 }
1018 \f
1019 /* Starting asynchronous inferior processes. */
1020
1021 static Lisp_Object start_process_unwind ();
1022
1023 DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
1024 "Start a program in a subprocess. Return the process object for it.\n\
1025 Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS\n\
1026 NAME is name for process. It is modified if necessary to make it unique.\n\
1027 BUFFER is the buffer or (buffer-name) to associate with the process.\n\
1028 Process output goes at end of that buffer, unless you specify\n\
1029 an output stream or filter function to handle the output.\n\
1030 BUFFER may be also nil, meaning that this process is not associated\n\
1031 with any buffer.\n\
1032 Third arg is program file name. It is searched for as in the shell.\n\
1033 Remaining arguments are strings to give program as arguments.")
1034 (nargs, args)
1035 int nargs;
1036 register Lisp_Object *args;
1037 {
1038 Lisp_Object buffer, name, program, proc, current_dir, tem;
1039 #ifdef VMS
1040 register unsigned char *new_argv;
1041 int len;
1042 #else
1043 register unsigned char **new_argv;
1044 #endif
1045 register int i;
1046 int count = specpdl_ptr - specpdl;
1047
1048 buffer = args[1];
1049 if (!NILP (buffer))
1050 buffer = Fget_buffer_create (buffer);
1051
1052 /* Make sure that the child will be able to chdir to the current
1053 buffer's current directory, or its unhandled equivalent. We
1054 can't just have the child check for an error when it does the
1055 chdir, since it's in a vfork.
1056
1057 We have to GCPRO around this because Fexpand_file_name and
1058 Funhandled_file_name_directory might call a file name handling
1059 function. The argument list is protected by the caller, so all
1060 we really have to worry about is buffer. */
1061 {
1062 struct gcpro gcpro1, gcpro2;
1063
1064 current_dir = current_buffer->directory;
1065
1066 GCPRO2 (buffer, current_dir);
1067
1068 current_dir
1069 = expand_and_dir_to_file (Funhandled_file_name_directory (current_dir),
1070 Qnil);
1071 if (NILP (Ffile_accessible_directory_p (current_dir)))
1072 report_file_error ("Setting current directory",
1073 Fcons (current_buffer->directory, Qnil));
1074
1075 UNGCPRO;
1076 }
1077
1078 name = args[0];
1079 CHECK_STRING (name, 0);
1080
1081 program = args[2];
1082
1083 CHECK_STRING (program, 2);
1084
1085 #ifdef VMS
1086 /* Make a one member argv with all args concatenated
1087 together separated by a blank. */
1088 len = XSTRING (program)->size + 2;
1089 for (i = 3; i < nargs; i++)
1090 {
1091 tem = args[i];
1092 CHECK_STRING (tem, i);
1093 len += XSTRING (tem)->size + 1; /* count the blank */
1094 }
1095 new_argv = (unsigned char *) alloca (len);
1096 strcpy (new_argv, XSTRING (program)->data);
1097 for (i = 3; i < nargs; i++)
1098 {
1099 tem = args[i];
1100 CHECK_STRING (tem, i);
1101 strcat (new_argv, " ");
1102 strcat (new_argv, XSTRING (tem)->data);
1103 }
1104 /* Need to add code here to check for program existence on VMS */
1105
1106 #else /* not VMS */
1107 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1108
1109 /* If program file name is not absolute, search our path for it */
1110 if (!IS_DIRECTORY_SEP (XSTRING (program)->data[0])
1111 && !(XSTRING (program)->size > 1
1112 && IS_DEVICE_SEP (XSTRING (program)->data[1])))
1113 {
1114 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1115
1116 tem = Qnil;
1117 GCPRO4 (name, program, buffer, current_dir);
1118 openp (Vexec_path, program, EXEC_SUFFIXES, &tem, 1);
1119 UNGCPRO;
1120 if (NILP (tem))
1121 report_file_error ("Searching for program", Fcons (program, Qnil));
1122 tem = Fexpand_file_name (tem, Qnil);
1123 new_argv[0] = XSTRING (tem)->data;
1124 }
1125 else
1126 {
1127 if (!NILP (Ffile_directory_p (program)))
1128 error ("Specified program for new process is a directory");
1129
1130 new_argv[0] = XSTRING (program)->data;
1131 }
1132
1133 for (i = 3; i < nargs; i++)
1134 {
1135 tem = args[i];
1136 CHECK_STRING (tem, i);
1137 new_argv[i - 2] = XSTRING (tem)->data;
1138 }
1139 new_argv[i - 2] = 0;
1140 #endif /* not VMS */
1141
1142 proc = make_process (name);
1143 /* If an error occurs and we can't start the process, we want to
1144 remove it from the process list. This means that each error
1145 check in create_process doesn't need to call remove_process
1146 itself; it's all taken care of here. */
1147 record_unwind_protect (start_process_unwind, proc);
1148
1149 XPROCESS (proc)->childp = Qt;
1150 XPROCESS (proc)->command_channel_p = Qnil;
1151 XPROCESS (proc)->buffer = buffer;
1152 XPROCESS (proc)->sentinel = Qnil;
1153 XPROCESS (proc)->filter = Qnil;
1154 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1155
1156 /* Make the process marker point into the process buffer (if any). */
1157 if (!NILP (buffer))
1158 Fset_marker (XPROCESS (proc)->mark,
1159 make_number (BUF_ZV (XBUFFER (buffer))), buffer);
1160
1161 if (!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters)
1162 || NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters))
1163 {
1164 XPROCESS (proc)->decode_coding_system = Qnil;
1165 XPROCESS (proc)->encode_coding_system = Qnil;
1166 }
1167 else
1168 {
1169 /* Setup coding systems for communicating with the process. */
1170 /* Qt denotes that we have not yet called Ffind_coding_system. */
1171 Lisp_Object coding_systems = Qt;
1172 Lisp_Object val, *args2;
1173 struct gcpro gcpro1;
1174
1175 if (NILP (val = Vcoding_system_for_read))
1176 {
1177 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof *args2);
1178 args2[0] = Qstart_process;
1179 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1180 GCPRO1 (proc);
1181 coding_systems = Ffind_coding_system (nargs + 1, args2);
1182 UNGCPRO;
1183 if (CONSP (coding_systems))
1184 val = XCONS (coding_systems)->car;
1185 }
1186 XPROCESS (proc)->decode_coding_system = val;
1187
1188 if (NILP (val = Vcoding_system_for_write))
1189 {
1190 if (EQ (coding_systems, Qt))
1191 {
1192 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof args2);
1193 args2[0] = Qstart_process;
1194 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1195 GCPRO1 (proc);
1196 coding_systems = Ffind_coding_system (nargs + 1, args2);
1197 UNGCPRO;
1198 }
1199 if (CONSP (coding_systems))
1200 val = XCONS (coding_systems)->cdr;
1201 }
1202 XPROCESS (proc)->encode_coding_system = val;
1203 }
1204
1205 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
1206 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
1207
1208 create_process (proc, new_argv, current_dir);
1209
1210 return unbind_to (count, proc);
1211 }
1212
1213 /* This function is the unwind_protect form for Fstart_process. If
1214 PROC doesn't have its pid set, then we know someone has signaled
1215 an error and the process wasn't started successfully, so we should
1216 remove it from the process list. */
1217 static Lisp_Object
1218 start_process_unwind (proc)
1219 Lisp_Object proc;
1220 {
1221 if (!PROCESSP (proc))
1222 abort ();
1223
1224 /* Was PROC started successfully? */
1225 if (XINT (XPROCESS (proc)->pid) <= 0)
1226 remove_process (proc);
1227
1228 return Qnil;
1229 }
1230
1231
1232 SIGTYPE
1233 create_process_1 (signo)
1234 int signo;
1235 {
1236 #if defined (USG) && !defined (POSIX_SIGNALS)
1237 /* USG systems forget handlers when they are used;
1238 must reestablish each time */
1239 signal (signo, create_process_1);
1240 #endif /* USG */
1241 }
1242
1243 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1244 #ifdef USG
1245 #ifdef SIGCHLD
1246 /* Mimic blocking of signals on system V, which doesn't really have it. */
1247
1248 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1249 int sigchld_deferred;
1250
1251 SIGTYPE
1252 create_process_sigchld ()
1253 {
1254 signal (SIGCHLD, create_process_sigchld);
1255
1256 sigchld_deferred = 1;
1257 }
1258 #endif
1259 #endif
1260 #endif
1261
1262 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1263 create_process (process, new_argv, current_dir)
1264 Lisp_Object process;
1265 char **new_argv;
1266 Lisp_Object current_dir;
1267 {
1268 int pid, inchannel, outchannel;
1269 int sv[2];
1270 #ifdef POSIX_SIGNALS
1271 sigset_t procmask;
1272 sigset_t blocked;
1273 struct sigaction sigint_action;
1274 struct sigaction sigquit_action;
1275 #ifdef AIX
1276 struct sigaction sighup_action;
1277 #endif
1278 #else /* !POSIX_SIGNALS */
1279 #ifdef SIGCHLD
1280 SIGTYPE (*sigchld)();
1281 #endif
1282 #endif /* !POSIX_SIGNALS */
1283 /* Use volatile to protect variables from being clobbered by longjmp. */
1284 volatile int forkin, forkout;
1285 volatile int pty_flag = 0;
1286 extern char **environ;
1287
1288 inchannel = outchannel = -1;
1289
1290 #ifdef HAVE_PTYS
1291 if (!NILP (Vprocess_connection_type))
1292 outchannel = inchannel = allocate_pty ();
1293
1294 if (inchannel >= 0)
1295 {
1296 #ifndef USG
1297 /* On USG systems it does not work to open the pty's tty here
1298 and then close and reopen it in the child. */
1299 #ifdef O_NOCTTY
1300 /* Don't let this terminal become our controlling terminal
1301 (in case we don't have one). */
1302 forkout = forkin = open (pty_name, O_RDWR | O_NOCTTY, 0);
1303 #else
1304 forkout = forkin = open (pty_name, O_RDWR, 0);
1305 #endif
1306 if (forkin < 0)
1307 report_file_error ("Opening pty", Qnil);
1308 #else
1309 forkin = forkout = -1;
1310 #endif /* not USG */
1311 pty_flag = 1;
1312 }
1313 else
1314 #endif /* HAVE_PTYS */
1315 #ifdef SKTPAIR
1316 {
1317 if (socketpair (AF_UNIX, SOCK_STREAM, 0, sv) < 0)
1318 report_file_error ("Opening socketpair", Qnil);
1319 outchannel = inchannel = sv[0];
1320 forkout = forkin = sv[1];
1321 }
1322 #else /* not SKTPAIR */
1323 {
1324 pipe (sv);
1325 inchannel = sv[0];
1326 forkout = sv[1];
1327 pipe (sv);
1328 outchannel = sv[1];
1329 forkin = sv[0];
1330 }
1331 #endif /* not SKTPAIR */
1332
1333 #if 0
1334 /* Replaced by close_process_descs */
1335 set_exclusive_use (inchannel);
1336 set_exclusive_use (outchannel);
1337 #endif
1338
1339 /* Stride people say it's a mystery why this is needed
1340 as well as the O_NDELAY, but that it fails without this. */
1341 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1342 {
1343 int one = 1;
1344 ioctl (inchannel, FIONBIO, &one);
1345 }
1346 #endif
1347
1348 #ifdef O_NONBLOCK
1349 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1350 fcntl (outchannel, F_SETFL, O_NONBLOCK);
1351 #else
1352 #ifdef O_NDELAY
1353 fcntl (inchannel, F_SETFL, O_NDELAY);
1354 fcntl (outchannel, F_SETFL, O_NDELAY);
1355 #endif
1356 #endif
1357
1358 /* Record this as an active process, with its channels.
1359 As a result, child_setup will close Emacs's side of the pipes. */
1360 chan_process[inchannel] = process;
1361 XSETINT (XPROCESS (process)->infd, inchannel);
1362 XSETINT (XPROCESS (process)->outfd, outchannel);
1363 /* Record the tty descriptor used in the subprocess. */
1364 if (forkin < 0)
1365 XPROCESS (process)->subtty = Qnil;
1366 else
1367 XSETFASTINT (XPROCESS (process)->subtty, forkin);
1368 XPROCESS (process)->pty_flag = (pty_flag ? Qt : Qnil);
1369 XPROCESS (process)->status = Qrun;
1370 if (!proc_decode_coding_system[inchannel])
1371 proc_decode_coding_system[inchannel]
1372 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1373 setup_coding_system (XPROCESS (process)->decode_coding_system,
1374 proc_decode_coding_system[inchannel]);
1375 if (!proc_encode_coding_system[outchannel])
1376 proc_encode_coding_system[outchannel]
1377 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1378 setup_coding_system (XPROCESS (process)->encode_coding_system,
1379 proc_encode_coding_system[outchannel]);
1380
1381 /* Delay interrupts until we have a chance to store
1382 the new fork's pid in its process structure */
1383 #ifdef POSIX_SIGNALS
1384 sigemptyset (&blocked);
1385 #ifdef SIGCHLD
1386 sigaddset (&blocked, SIGCHLD);
1387 #endif
1388 #ifdef HAVE_VFORK
1389 /* On many hosts (e.g. Solaris 2.4), if a vforked child calls `signal',
1390 this sets the parent's signal handlers as well as the child's.
1391 So delay all interrupts whose handlers the child might munge,
1392 and record the current handlers so they can be restored later. */
1393 sigaddset (&blocked, SIGINT ); sigaction (SIGINT , 0, &sigint_action );
1394 sigaddset (&blocked, SIGQUIT); sigaction (SIGQUIT, 0, &sigquit_action);
1395 #ifdef AIX
1396 sigaddset (&blocked, SIGHUP ); sigaction (SIGHUP , 0, &sighup_action );
1397 #endif
1398 #endif /* HAVE_VFORK */
1399 sigprocmask (SIG_BLOCK, &blocked, &procmask);
1400 #else /* !POSIX_SIGNALS */
1401 #ifdef SIGCHLD
1402 #ifdef BSD4_1
1403 sighold (SIGCHLD);
1404 #else /* not BSD4_1 */
1405 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1406 sigsetmask (sigmask (SIGCHLD));
1407 #else /* ordinary USG */
1408 #if 0
1409 sigchld_deferred = 0;
1410 sigchld = signal (SIGCHLD, create_process_sigchld);
1411 #endif
1412 #endif /* ordinary USG */
1413 #endif /* not BSD4_1 */
1414 #endif /* SIGCHLD */
1415 #endif /* !POSIX_SIGNALS */
1416
1417 FD_SET (inchannel, &input_wait_mask);
1418 FD_SET (inchannel, &non_keyboard_wait_mask);
1419 if (inchannel > max_process_desc)
1420 max_process_desc = inchannel;
1421
1422 /* Until we store the proper pid, enable sigchld_handler
1423 to recognize an unknown pid as standing for this process.
1424 It is very important not to let this `marker' value stay
1425 in the table after this function has returned; if it does
1426 it might cause call-process to hang and subsequent asynchronous
1427 processes to get their return values scrambled. */
1428 XSETINT (XPROCESS (process)->pid, -1);
1429
1430 BLOCK_INPUT;
1431
1432 {
1433 /* child_setup must clobber environ on systems with true vfork.
1434 Protect it from permanent change. */
1435 char **save_environ = environ;
1436
1437 #ifndef WINDOWSNT
1438 pid = vfork ();
1439 if (pid == 0)
1440 #endif /* not WINDOWSNT */
1441 {
1442 int xforkin = forkin;
1443 int xforkout = forkout;
1444
1445 #if 0 /* This was probably a mistake--it duplicates code later on,
1446 but fails to handle all the cases. */
1447 /* Make sure SIGCHLD is not blocked in the child. */
1448 sigsetmask (SIGEMPTYMASK);
1449 #endif
1450
1451 /* Make the pty be the controlling terminal of the process. */
1452 #ifdef HAVE_PTYS
1453 /* First, disconnect its current controlling terminal. */
1454 #ifdef HAVE_SETSID
1455 /* We tried doing setsid only if pty_flag, but it caused
1456 process_set_signal to fail on SGI when using a pipe. */
1457 setsid ();
1458 /* Make the pty's terminal the controlling terminal. */
1459 if (pty_flag)
1460 {
1461 #ifdef TIOCSCTTY
1462 /* We ignore the return value
1463 because faith@cs.unc.edu says that is necessary on Linux. */
1464 ioctl (xforkin, TIOCSCTTY, 0);
1465 #endif
1466 }
1467 #else /* not HAVE_SETSID */
1468 #ifdef USG
1469 /* It's very important to call setpgrp here and no time
1470 afterwards. Otherwise, we lose our controlling tty which
1471 is set when we open the pty. */
1472 setpgrp ();
1473 #endif /* USG */
1474 #endif /* not HAVE_SETSID */
1475 #if defined (HAVE_TERMIOS) && defined (LDISC1)
1476 if (pty_flag && xforkin >= 0)
1477 {
1478 struct termios t;
1479 tcgetattr (xforkin, &t);
1480 t.c_lflag = LDISC1;
1481 if (tcsetattr (xforkin, TCSANOW, &t) < 0)
1482 write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1483 }
1484 #else
1485 #if defined (NTTYDISC) && defined (TIOCSETD)
1486 if (pty_flag && xforkin >= 0)
1487 {
1488 /* Use new line discipline. */
1489 int ldisc = NTTYDISC;
1490 ioctl (xforkin, TIOCSETD, &ldisc);
1491 }
1492 #endif
1493 #endif
1494 #ifdef TIOCNOTTY
1495 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1496 can do TIOCSPGRP only to the process's controlling tty. */
1497 if (pty_flag)
1498 {
1499 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1500 I can't test it since I don't have 4.3. */
1501 int j = open ("/dev/tty", O_RDWR, 0);
1502 ioctl (j, TIOCNOTTY, 0);
1503 close (j);
1504 #ifndef USG
1505 /* In order to get a controlling terminal on some versions
1506 of BSD, it is necessary to put the process in pgrp 0
1507 before it opens the terminal. */
1508 #ifdef HAVE_SETPGID
1509 setpgid (0, 0);
1510 #else
1511 setpgrp (0, 0);
1512 #endif
1513 #endif
1514 }
1515 #endif /* TIOCNOTTY */
1516
1517 #if !defined (RTU) && !defined (UNIPLUS) && !defined (DONT_REOPEN_PTY)
1518 /*** There is a suggestion that this ought to be a
1519 conditional on TIOCSPGRP,
1520 or !(defined (HAVE_SETSID) && defined (TIOCSCTTY)).
1521 Trying the latter gave the wrong results on Debian GNU/Linux 1.1;
1522 that system does seem to need this code, even though
1523 both HAVE_SETSID and TIOCSCTTY are defined. */
1524 /* Now close the pty (if we had it open) and reopen it.
1525 This makes the pty the controlling terminal of the subprocess. */
1526 if (pty_flag)
1527 {
1528 #ifdef SET_CHILD_PTY_PGRP
1529 int pgrp = getpid ();
1530 #endif
1531
1532 /* I wonder if close (open (pty_name, ...)) would work? */
1533 if (xforkin >= 0)
1534 close (xforkin);
1535 xforkout = xforkin = open (pty_name, O_RDWR, 0);
1536
1537 if (xforkin < 0)
1538 {
1539 write (1, "Couldn't open the pty terminal ", 31);
1540 write (1, pty_name, strlen (pty_name));
1541 write (1, "\n", 1);
1542 _exit (1);
1543 }
1544
1545 #ifdef SET_CHILD_PTY_PGRP
1546 ioctl (xforkin, TIOCSPGRP, &pgrp);
1547 ioctl (xforkout, TIOCSPGRP, &pgrp);
1548 #endif
1549 }
1550 #endif /* not UNIPLUS and not RTU and not DONT_REOPEN_PTY */
1551
1552 #ifdef SETUP_SLAVE_PTY
1553 if (pty_flag)
1554 {
1555 SETUP_SLAVE_PTY;
1556 }
1557 #endif /* SETUP_SLAVE_PTY */
1558 #ifdef AIX
1559 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1560 Now reenable it in the child, so it will die when we want it to. */
1561 if (pty_flag)
1562 signal (SIGHUP, SIG_DFL);
1563 #endif
1564 #endif /* HAVE_PTYS */
1565
1566 signal (SIGINT, SIG_DFL);
1567 signal (SIGQUIT, SIG_DFL);
1568
1569 /* Stop blocking signals in the child. */
1570 #ifdef POSIX_SIGNALS
1571 sigprocmask (SIG_SETMASK, &procmask, 0);
1572 #else /* !POSIX_SIGNALS */
1573 #ifdef SIGCHLD
1574 #ifdef BSD4_1
1575 sigrelse (SIGCHLD);
1576 #else /* not BSD4_1 */
1577 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1578 sigsetmask (SIGEMPTYMASK);
1579 #else /* ordinary USG */
1580 #if 0
1581 signal (SIGCHLD, sigchld);
1582 #endif
1583 #endif /* ordinary USG */
1584 #endif /* not BSD4_1 */
1585 #endif /* SIGCHLD */
1586 #endif /* !POSIX_SIGNALS */
1587
1588 if (pty_flag)
1589 child_setup_tty (xforkout);
1590 #ifdef WINDOWSNT
1591 pid = child_setup (xforkin, xforkout, xforkout,
1592 new_argv, 1, current_dir);
1593 #else /* not WINDOWSNT */
1594 child_setup (xforkin, xforkout, xforkout,
1595 new_argv, 1, current_dir);
1596 #endif /* not WINDOWSNT */
1597 }
1598 environ = save_environ;
1599 }
1600
1601 UNBLOCK_INPUT;
1602
1603 /* This runs in the Emacs process. */
1604 if (pid < 0)
1605 {
1606 if (forkin >= 0)
1607 close (forkin);
1608 if (forkin != forkout && forkout >= 0)
1609 close (forkout);
1610 }
1611 else
1612 {
1613 /* vfork succeeded. */
1614 XSETFASTINT (XPROCESS (process)->pid, pid);
1615
1616 #ifdef WINDOWSNT
1617 register_child (pid, inchannel);
1618 #endif /* WINDOWSNT */
1619
1620 /* If the subfork execv fails, and it exits,
1621 this close hangs. I don't know why.
1622 So have an interrupt jar it loose. */
1623 stop_polling ();
1624 signal (SIGALRM, create_process_1);
1625 alarm (1);
1626 XPROCESS (process)->subtty = Qnil;
1627 if (forkin >= 0)
1628 close (forkin);
1629 alarm (0);
1630 start_polling ();
1631 if (forkin != forkout && forkout >= 0)
1632 close (forkout);
1633
1634 #ifdef HAVE_PTYS
1635 if (pty_flag)
1636 XPROCESS (process)->tty_name = build_string (pty_name);
1637 else
1638 #endif
1639 XPROCESS (process)->tty_name = Qnil;
1640 }
1641
1642 /* Restore the signal state whether vfork succeeded or not.
1643 (We will signal an error, below, if it failed.) */
1644 #ifdef POSIX_SIGNALS
1645 #ifdef HAVE_VFORK
1646 /* Restore the parent's signal handlers. */
1647 sigaction (SIGINT, &sigint_action, 0);
1648 sigaction (SIGQUIT, &sigquit_action, 0);
1649 #ifdef AIX
1650 sigaction (SIGHUP, &sighup_action, 0);
1651 #endif
1652 #endif /* HAVE_VFORK */
1653 /* Stop blocking signals in the parent. */
1654 sigprocmask (SIG_SETMASK, &procmask, 0);
1655 #else /* !POSIX_SIGNALS */
1656 #ifdef SIGCHLD
1657 #ifdef BSD4_1
1658 sigrelse (SIGCHLD);
1659 #else /* not BSD4_1 */
1660 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1661 sigsetmask (SIGEMPTYMASK);
1662 #else /* ordinary USG */
1663 #if 0
1664 signal (SIGCHLD, sigchld);
1665 /* Now really handle any of these signals
1666 that came in during this function. */
1667 if (sigchld_deferred)
1668 kill (getpid (), SIGCHLD);
1669 #endif
1670 #endif /* ordinary USG */
1671 #endif /* not BSD4_1 */
1672 #endif /* SIGCHLD */
1673 #endif /* !POSIX_SIGNALS */
1674
1675 /* Now generate the error if vfork failed. */
1676 if (pid < 0)
1677 report_file_error ("Doing vfork", Qnil);
1678 }
1679 #endif /* not VMS */
1680
1681 #ifdef HAVE_SOCKETS
1682
1683 /* open a TCP network connection to a given HOST/SERVICE. Treated
1684 exactly like a normal process when reading and writing. Only
1685 differences are in status display and process deletion. A network
1686 connection has no PID; you cannot signal it. All you can do is
1687 deactivate and close it via delete-process */
1688
1689 DEFUN ("open-network-stream", Fopen_network_stream, Sopen_network_stream,
1690 4, 4, 0,
1691 "Open a TCP connection for a service to a host.\n\
1692 Returns a subprocess-object to represent the connection.\n\
1693 Input and output work as for subprocesses; `delete-process' closes it.\n\
1694 Args are NAME BUFFER HOST SERVICE.\n\
1695 NAME is name for process. It is modified if necessary to make it unique.\n\
1696 BUFFER is the buffer (or buffer-name) to associate with the process.\n\
1697 Process output goes at end of that buffer, unless you specify\n\
1698 an output stream or filter function to handle the output.\n\
1699 BUFFER may be also nil, meaning that this process is not associated\n\
1700 with any buffer\n\
1701 Third arg is name of the host to connect to, or its IP address.\n\
1702 Fourth arg SERVICE is name of the service desired, or an integer\n\
1703 specifying a port number to connect to.")
1704 (name, buffer, host, service)
1705 Lisp_Object name, buffer, host, service;
1706 {
1707 Lisp_Object proc;
1708 register int i;
1709 struct sockaddr_in address;
1710 struct servent *svc_info;
1711 struct hostent *host_info_ptr, host_info;
1712 char *(addr_list[2]);
1713 IN_ADDR numeric_addr;
1714 int s, outch, inch;
1715 char errstring[80];
1716 int port;
1717 struct hostent host_info_fixed;
1718 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1719 int retry = 0;
1720 int count = specpdl_ptr - specpdl;
1721
1722 #ifdef WINDOWSNT
1723 /* Ensure socket support is loaded if available. */
1724 init_winsock (TRUE);
1725 #endif
1726
1727 GCPRO4 (name, buffer, host, service);
1728 CHECK_STRING (name, 0);
1729 CHECK_STRING (host, 0);
1730 if (INTEGERP (service))
1731 port = htons ((unsigned short) XINT (service));
1732 else
1733 {
1734 CHECK_STRING (service, 0);
1735 svc_info = getservbyname (XSTRING (service)->data, "tcp");
1736 if (svc_info == 0)
1737 error ("Unknown service \"%s\"", XSTRING (service)->data);
1738 port = svc_info->s_port;
1739 }
1740
1741 /* Slow down polling to every ten seconds.
1742 Some kernels have a bug which causes retrying connect to fail
1743 after a connect. Polling can interfere with gethostbyname too. */
1744 #ifdef POLL_FOR_INPUT
1745 bind_polling_period (10);
1746 #endif
1747
1748 #ifndef TERM
1749 while (1)
1750 {
1751 #ifdef TRY_AGAIN
1752 h_errno = 0;
1753 #endif
1754 immediate_quit = 1;
1755 QUIT;
1756 host_info_ptr = gethostbyname (XSTRING (host)->data);
1757 immediate_quit = 0;
1758 #ifdef TRY_AGAIN
1759 if (! (host_info_ptr == 0 && h_errno == TRY_AGAIN))
1760 #endif
1761 break;
1762 Fsleep_for (make_number (1), Qnil);
1763 }
1764 if (host_info_ptr == 0)
1765 /* Attempt to interpret host as numeric inet address */
1766 {
1767 numeric_addr = inet_addr ((char *) XSTRING (host)->data);
1768 if (NUMERIC_ADDR_ERROR)
1769 error ("Unknown host \"%s\"", XSTRING (host)->data);
1770
1771 host_info_ptr = &host_info;
1772 host_info.h_name = 0;
1773 host_info.h_aliases = 0;
1774 host_info.h_addrtype = AF_INET;
1775 #ifdef h_addr
1776 /* Older machines have only one address slot called h_addr.
1777 Newer machines have h_addr_list, but #define h_addr to
1778 be its first element. */
1779 host_info.h_addr_list = &(addr_list[0]);
1780 #endif
1781 host_info.h_addr = (char*)(&numeric_addr);
1782 addr_list[1] = 0;
1783 /* numeric_addr isn't null-terminated; it has fixed length. */
1784 host_info.h_length = sizeof (numeric_addr);
1785 }
1786
1787 bzero (&address, sizeof address);
1788 bcopy (host_info_ptr->h_addr, (char *) &address.sin_addr,
1789 host_info_ptr->h_length);
1790 address.sin_family = host_info_ptr->h_addrtype;
1791 address.sin_port = port;
1792
1793 s = socket (host_info_ptr->h_addrtype, SOCK_STREAM, 0);
1794 if (s < 0)
1795 report_file_error ("error creating socket", Fcons (name, Qnil));
1796
1797 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
1798 when connect is interrupted. So let's not let it get interrupted.
1799 Note we do not turn off polling, because polling is only used
1800 when not interrupt_input, and thus not normally used on the systems
1801 which have this bug. On systems which use polling, there's no way
1802 to quit if polling is turned off. */
1803 if (interrupt_input)
1804 unrequest_sigio ();
1805
1806 loop:
1807
1808 immediate_quit = 1;
1809 QUIT;
1810
1811 if (connect (s, (struct sockaddr *) &address, sizeof address) == -1
1812 && errno != EISCONN)
1813 {
1814 int xerrno = errno;
1815
1816 immediate_quit = 0;
1817
1818 if (errno == EINTR)
1819 goto loop;
1820 if (errno == EADDRINUSE && retry < 20)
1821 {
1822 /* A delay here is needed on some FreeBSD systems,
1823 and it is harmless, since this retrying takes time anyway
1824 and should be infrequent. */
1825 Fsleep_for (make_number (1), Qnil);
1826 retry++;
1827 goto loop;
1828 }
1829
1830 close (s);
1831
1832 if (interrupt_input)
1833 request_sigio ();
1834
1835 errno = xerrno;
1836 report_file_error ("connection failed",
1837 Fcons (host, Fcons (name, Qnil)));
1838 }
1839
1840 immediate_quit = 0;
1841
1842 #ifdef POLL_FOR_INPUT
1843 unbind_to (count, Qnil);
1844 #endif
1845
1846 if (interrupt_input)
1847 request_sigio ();
1848
1849 #else /* TERM */
1850 s = connect_server (0);
1851 if (s < 0)
1852 report_file_error ("error creating socket", Fcons (name, Qnil));
1853 send_command (s, C_PORT, 0, "%s:%d", XSTRING (host)->data, ntohs (port));
1854 send_command (s, C_DUMB, 1, 0);
1855 #endif /* TERM */
1856
1857 inch = s;
1858 outch = s;
1859
1860 if (!NILP (buffer))
1861 buffer = Fget_buffer_create (buffer);
1862 proc = make_process (name);
1863
1864 chan_process[inch] = proc;
1865
1866 #ifdef O_NONBLOCK
1867 fcntl (inch, F_SETFL, O_NONBLOCK);
1868 #else
1869 #ifdef O_NDELAY
1870 fcntl (inch, F_SETFL, O_NDELAY);
1871 #endif
1872 #endif
1873
1874 XPROCESS (proc)->childp = Fcons (host, Fcons (service, Qnil));
1875 XPROCESS (proc)->command_channel_p = Qnil;
1876 XPROCESS (proc)->buffer = buffer;
1877 XPROCESS (proc)->sentinel = Qnil;
1878 XPROCESS (proc)->filter = Qnil;
1879 XPROCESS (proc)->command = Qnil;
1880 XPROCESS (proc)->pid = Qnil;
1881 XSETINT (XPROCESS (proc)->infd, inch);
1882 XSETINT (XPROCESS (proc)->outfd, outch);
1883 XPROCESS (proc)->status = Qrun;
1884 FD_SET (inch, &input_wait_mask);
1885 FD_SET (inch, &non_keyboard_wait_mask);
1886 if (inch > max_process_desc)
1887 max_process_desc = inch;
1888
1889 if (!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters)
1890 || NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters))
1891 {
1892 XPROCESS (proc)->decode_coding_system = Qnil;
1893 XPROCESS (proc)->encode_coding_system = Qnil;
1894 }
1895 else
1896 {
1897 /* Setup coding systems for communicating with the network stream. */
1898 struct gcpro gcpro1;
1899 /* Qt denotes that we have not yet called Ffind_coding_system. */
1900 Lisp_Object coding_systems = Qt;
1901 Lisp_Object args[5], val;
1902
1903 if (NILP (val = Vcoding_system_for_read))
1904 {
1905 args[0] = Qopen_network_stream, args[1] = name,
1906 args[2] = buffer, args[3] = host, args[4] = service;
1907 GCPRO1 (proc);
1908 coding_systems = Ffind_coding_system (5, args);
1909 UNGCPRO;
1910 val = (CONSP (coding_systems) ? XCONS (coding_systems)->car : Qnil);
1911 }
1912 XPROCESS (proc)->decode_coding_system = val;
1913
1914 if (NILP (val = Vcoding_system_for_write))
1915 {
1916 if (EQ (coding_systems, Qt))
1917 {
1918 args[0] = Qopen_network_stream, args[1] = name,
1919 args[2] = buffer, args[3] = host, args[4] = service;
1920 GCPRO1 (proc);
1921 coding_systems = Ffind_coding_system (5, args);
1922 UNGCPRO;
1923 }
1924 val = (CONSP (coding_systems) ? XCONS (coding_systems)->cdr : Qnil);
1925 }
1926 XPROCESS (proc)->encode_coding_system = val;
1927 }
1928
1929 if (!proc_decode_coding_system[inch])
1930 proc_decode_coding_system[inch]
1931 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1932 setup_coding_system (XPROCESS (proc)->decode_coding_system,
1933 proc_decode_coding_system[inch]);
1934 if (!proc_encode_coding_system[outch])
1935 proc_encode_coding_system[outch]
1936 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
1937 setup_coding_system (XPROCESS (proc)->encode_coding_system,
1938 proc_encode_coding_system[outch]);
1939
1940 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
1941 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
1942
1943 UNGCPRO;
1944 return proc;
1945 }
1946 #endif /* HAVE_SOCKETS */
1947
1948 deactivate_process (proc)
1949 Lisp_Object proc;
1950 {
1951 register int inchannel, outchannel;
1952 register struct Lisp_Process *p = XPROCESS (proc);
1953
1954 inchannel = XINT (p->infd);
1955 outchannel = XINT (p->outfd);
1956
1957 if (inchannel >= 0)
1958 {
1959 /* Beware SIGCHLD hereabouts. */
1960 flush_pending_output (inchannel);
1961 #ifdef VMS
1962 {
1963 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
1964 sys$dassgn (outchannel);
1965 vs = get_vms_process_pointer (p->pid);
1966 if (vs)
1967 give_back_vms_process_stuff (vs);
1968 }
1969 #else
1970 close (inchannel);
1971 if (outchannel >= 0 && outchannel != inchannel)
1972 close (outchannel);
1973 #endif
1974
1975 XSETINT (p->infd, -1);
1976 XSETINT (p->outfd, -1);
1977 chan_process[inchannel] = Qnil;
1978 FD_CLR (inchannel, &input_wait_mask);
1979 FD_CLR (inchannel, &non_keyboard_wait_mask);
1980 if (inchannel == max_process_desc)
1981 {
1982 int i;
1983 /* We just closed the highest-numbered process input descriptor,
1984 so recompute the highest-numbered one now. */
1985 max_process_desc = 0;
1986 for (i = 0; i < MAXDESC; i++)
1987 if (!NILP (chan_process[i]))
1988 max_process_desc = i;
1989 }
1990 }
1991 }
1992
1993 /* Close all descriptors currently in use for communication
1994 with subprocess. This is used in a newly-forked subprocess
1995 to get rid of irrelevant descriptors. */
1996
1997 close_process_descs ()
1998 {
1999 #ifndef WINDOWSNT
2000 int i;
2001 for (i = 0; i < MAXDESC; i++)
2002 {
2003 Lisp_Object process;
2004 process = chan_process[i];
2005 if (!NILP (process))
2006 {
2007 int in = XINT (XPROCESS (process)->infd);
2008 int out = XINT (XPROCESS (process)->outfd);
2009 if (in >= 0)
2010 close (in);
2011 if (out >= 0 && in != out)
2012 close (out);
2013 }
2014 }
2015 #endif
2016 }
2017 \f
2018 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
2019 0, 3, 0,
2020 "Allow any pending output from subprocesses to be read by Emacs.\n\
2021 It is read into the process' buffers or given to their filter functions.\n\
2022 Non-nil arg PROCESS means do not return until some output has been received\n\
2023 from PROCESS.\n\
2024 Non-nil second arg TIMEOUT and third arg TIMEOUT-MSECS are number of\n\
2025 seconds and microseconds to wait; return after that much time whether\n\
2026 or not there is input.\n\
2027 Return non-nil iff we received any output before the timeout expired.")
2028 (process, timeout, timeout_msecs)
2029 register Lisp_Object process, timeout, timeout_msecs;
2030 {
2031 int seconds;
2032 int useconds;
2033
2034 if (! NILP (timeout_msecs))
2035 {
2036 CHECK_NUMBER (timeout_msecs, 2);
2037 useconds = XINT (timeout_msecs);
2038 if (!INTEGERP (timeout))
2039 XSETINT (timeout, 0);
2040
2041 {
2042 int carry = useconds / 1000000;
2043
2044 XSETINT (timeout, XINT (timeout) + carry);
2045 useconds -= carry * 1000000;
2046
2047 /* I think this clause is necessary because C doesn't
2048 guarantee a particular rounding direction for negative
2049 integers. */
2050 if (useconds < 0)
2051 {
2052 XSETINT (timeout, XINT (timeout) - 1);
2053 useconds += 1000000;
2054 }
2055 }
2056 }
2057 else
2058 useconds = 0;
2059
2060 if (! NILP (timeout))
2061 {
2062 CHECK_NUMBER (timeout, 1);
2063 seconds = XINT (timeout);
2064 if (seconds < 0 || (seconds == 0 && useconds == 0))
2065 seconds = -1;
2066 }
2067 else
2068 {
2069 if (NILP (process))
2070 seconds = -1;
2071 else
2072 seconds = 0;
2073 }
2074
2075 if (NILP (process))
2076 XSETFASTINT (process, 0);
2077
2078 return
2079 (wait_reading_process_input (seconds, useconds, process, 0)
2080 ? Qt : Qnil);
2081 }
2082
2083 /* This variable is different from waiting_for_input in keyboard.c.
2084 It is used to communicate to a lisp process-filter/sentinel (via the
2085 function Fwaiting_for_user_input_p below) whether emacs was waiting
2086 for user-input when that process-filter was called.
2087 waiting_for_input cannot be used as that is by definition 0 when
2088 lisp code is being evalled.
2089 This is also used in record_asynch_buffer_change.
2090 For that purpose, this must be 0
2091 when not inside wait_reading_process_input. */
2092 static int waiting_for_user_input_p;
2093
2094 /* This is here so breakpoints can be put on it. */
2095 static
2096 wait_reading_process_input_1 ()
2097 {
2098 }
2099
2100 /* Read and dispose of subprocess output while waiting for timeout to
2101 elapse and/or keyboard input to be available.
2102
2103 TIME_LIMIT is:
2104 timeout in seconds, or
2105 zero for no limit, or
2106 -1 means gobble data immediately available but don't wait for any.
2107
2108 MICROSECS is:
2109 an additional duration to wait, measured in microseconds.
2110 If this is nonzero and time_limit is 0, then the timeout
2111 consists of MICROSECS only.
2112
2113 READ_KBD is a lisp value:
2114 0 to ignore keyboard input, or
2115 1 to return when input is available, or
2116 -1 meaning caller will actually read the input, so don't throw to
2117 the quit handler, or
2118 a cons cell, meaning wait until its car is non-nil
2119 (and gobble terminal input into the buffer if any arrives), or
2120 a process object, meaning wait until something arrives from that
2121 process. The return value is true iff we read some input from
2122 that process.
2123
2124 DO_DISPLAY != 0 means redisplay should be done to show subprocess
2125 output that arrives.
2126
2127 If READ_KBD is a pointer to a struct Lisp_Process, then the
2128 function returns true iff we received input from that process
2129 before the timeout elapsed.
2130 Otherwise, return true iff we received input from any process. */
2131
2132 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
2133 int time_limit, microsecs;
2134 Lisp_Object read_kbd;
2135 int do_display;
2136 {
2137 register int channel, nfds, m;
2138 static SELECT_TYPE Available;
2139 int xerrno;
2140 Lisp_Object proc;
2141 EMACS_TIME timeout, end_time, garbage;
2142 SELECT_TYPE Atemp;
2143 int wait_channel = -1;
2144 struct Lisp_Process *wait_proc = 0;
2145 int got_some_input = 0;
2146 Lisp_Object *wait_for_cell = 0;
2147
2148 FD_ZERO (&Available);
2149
2150 /* If read_kbd is a process to watch, set wait_proc and wait_channel
2151 accordingly. */
2152 if (PROCESSP (read_kbd))
2153 {
2154 wait_proc = XPROCESS (read_kbd);
2155 wait_channel = XINT (wait_proc->infd);
2156 XSETFASTINT (read_kbd, 0);
2157 }
2158
2159 /* If waiting for non-nil in a cell, record where. */
2160 if (CONSP (read_kbd))
2161 {
2162 wait_for_cell = &XCONS (read_kbd)->car;
2163 XSETFASTINT (read_kbd, 0);
2164 }
2165
2166 waiting_for_user_input_p = XINT (read_kbd);
2167
2168 /* Since we may need to wait several times,
2169 compute the absolute time to return at. */
2170 if (time_limit || microsecs)
2171 {
2172 EMACS_GET_TIME (end_time);
2173 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
2174 EMACS_ADD_TIME (end_time, end_time, timeout);
2175 }
2176 #ifdef hpux
2177 /* AlainF 5-Jul-1996
2178 HP-UX 10.10 seem to have problems with signals coming in
2179 Causes "poll: interrupted system call" messages when Emacs is run
2180 in an X window
2181 Turn off periodic alarms (in case they are in use) */
2182 stop_polling ();
2183 #endif
2184
2185 while (1)
2186 {
2187 int timeout_reduced_for_timers = 0;
2188
2189 /* If calling from keyboard input, do not quit
2190 since we want to return C-g as an input character.
2191 Otherwise, do pending quit if requested. */
2192 if (XINT (read_kbd) >= 0)
2193 QUIT;
2194
2195 /* Exit now if the cell we're waiting for became non-nil. */
2196 if (wait_for_cell && ! NILP (*wait_for_cell))
2197 break;
2198
2199 /* Compute time from now till when time limit is up */
2200 /* Exit if already run out */
2201 if (time_limit == -1)
2202 {
2203 /* -1 specified for timeout means
2204 gobble output available now
2205 but don't wait at all. */
2206
2207 EMACS_SET_SECS_USECS (timeout, 0, 0);
2208 }
2209 else if (time_limit || microsecs)
2210 {
2211 EMACS_GET_TIME (timeout);
2212 EMACS_SUB_TIME (timeout, end_time, timeout);
2213 if (EMACS_TIME_NEG_P (timeout))
2214 break;
2215 }
2216 else
2217 {
2218 EMACS_SET_SECS_USECS (timeout, 100000, 0);
2219 }
2220
2221 /* Normally we run timers here.
2222 But not if wait_for_cell; in those cases,
2223 the wait is supposed to be short,
2224 and those callers cannot handle running arbitrary Lisp code here. */
2225 if (! wait_for_cell)
2226 {
2227 EMACS_TIME timer_delay;
2228 int old_timers_run;
2229
2230 retry:
2231 old_timers_run = timers_run;
2232 timer_delay = timer_check (1);
2233 if (timers_run != old_timers_run && do_display)
2234 {
2235 redisplay_preserve_echo_area ();
2236 /* We must retry, since a timer may have requeued itself
2237 and that could alter the time_delay. */
2238 goto retry;
2239 }
2240
2241 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
2242 {
2243 EMACS_TIME difference;
2244 EMACS_SUB_TIME (difference, timer_delay, timeout);
2245 if (EMACS_TIME_NEG_P (difference))
2246 {
2247 timeout = timer_delay;
2248 timeout_reduced_for_timers = 1;
2249 }
2250 }
2251 /* If time_limit is -1, we are not going to wait at all. */
2252 else if (time_limit != -1)
2253 {
2254 /* This is so a breakpoint can be put here. */
2255 wait_reading_process_input_1 ();
2256 }
2257 }
2258
2259 /* Cause C-g and alarm signals to take immediate action,
2260 and cause input available signals to zero out timeout.
2261
2262 It is important that we do this before checking for process
2263 activity. If we get a SIGCHLD after the explicit checks for
2264 process activity, timeout is the only way we will know. */
2265 if (XINT (read_kbd) < 0)
2266 set_waiting_for_input (&timeout);
2267
2268 /* If status of something has changed, and no input is
2269 available, notify the user of the change right away. After
2270 this explicit check, we'll let the SIGCHLD handler zap
2271 timeout to get our attention. */
2272 if (update_tick != process_tick && do_display)
2273 {
2274 Atemp = input_wait_mask;
2275 EMACS_SET_SECS_USECS (timeout, 0, 0);
2276 if ((select (MAXDESC, &Atemp, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2277 &timeout)
2278 <= 0))
2279 {
2280 /* It's okay for us to do this and then continue with
2281 the loop, since timeout has already been zeroed out. */
2282 clear_waiting_for_input ();
2283 status_notify ();
2284 }
2285 }
2286
2287 /* Don't wait for output from a non-running process. */
2288 if (wait_proc != 0 && !NILP (wait_proc->raw_status_low))
2289 update_status (wait_proc);
2290 if (wait_proc != 0
2291 && ! EQ (wait_proc->status, Qrun))
2292 {
2293 clear_waiting_for_input ();
2294 break;
2295 }
2296
2297 /* Wait till there is something to do */
2298
2299 if (wait_for_cell)
2300 Available = non_process_wait_mask;
2301 else if (! XINT (read_kbd))
2302 Available = non_keyboard_wait_mask;
2303 else
2304 Available = input_wait_mask;
2305
2306 /* If frame size has changed or the window is newly mapped,
2307 redisplay now, before we start to wait. There is a race
2308 condition here; if a SIGIO arrives between now and the select
2309 and indicates that a frame is trashed, the select may block
2310 displaying a trashed screen. */
2311 if (frame_garbaged && do_display)
2312 {
2313 clear_waiting_for_input ();
2314 redisplay_preserve_echo_area ();
2315 if (XINT (read_kbd) < 0)
2316 set_waiting_for_input (&timeout);
2317 }
2318
2319 if (XINT (read_kbd) && detect_input_pending ())
2320 {
2321 nfds = 0;
2322 FD_ZERO (&Available);
2323 }
2324 else
2325 nfds = select (MAXDESC, &Available, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
2326 &timeout);
2327
2328 xerrno = errno;
2329
2330 /* Make C-g and alarm signals set flags again */
2331 clear_waiting_for_input ();
2332
2333 /* If we woke up due to SIGWINCH, actually change size now. */
2334 do_pending_window_change ();
2335
2336 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
2337 /* We wanted the full specified time, so return now. */
2338 break;
2339 if (nfds < 0)
2340 {
2341 if (xerrno == EINTR)
2342 FD_ZERO (&Available);
2343 #ifdef ultrix
2344 /* Ultrix select seems to return ENOMEM when it is
2345 interrupted. Treat it just like EINTR. Bleah. Note
2346 that we want to test for the "ultrix" CPP symbol, not
2347 "__ultrix__"; the latter is only defined under GCC, but
2348 not by DEC's bundled CC. -JimB */
2349 else if (xerrno == ENOMEM)
2350 FD_ZERO (&Available);
2351 #endif
2352 #ifdef ALLIANT
2353 /* This happens for no known reason on ALLIANT.
2354 I am guessing that this is the right response. -- RMS. */
2355 else if (xerrno == EFAULT)
2356 FD_ZERO (&Available);
2357 #endif
2358 else if (xerrno == EBADF)
2359 {
2360 #ifdef AIX
2361 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
2362 the child's closure of the pts gives the parent a SIGHUP, and
2363 the ptc file descriptor is automatically closed,
2364 yielding EBADF here or at select() call above.
2365 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
2366 in m/ibmrt-aix.h), and here we just ignore the select error.
2367 Cleanup occurs c/o status_notify after SIGCLD. */
2368 FD_ZERO (&Available); /* Cannot depend on values returned */
2369 #else
2370 abort ();
2371 #endif
2372 }
2373 else
2374 error ("select error: %s", strerror (xerrno));
2375 }
2376 #if defined(sun) && !defined(USG5_4)
2377 else if (nfds > 0 && keyboard_bit_set (&Available)
2378 && interrupt_input)
2379 /* System sometimes fails to deliver SIGIO.
2380
2381 David J. Mackenzie says that Emacs doesn't compile under
2382 Solaris if this code is enabled, thus the USG5_4 in the CPP
2383 conditional. "I haven't noticed any ill effects so far.
2384 If you find a Solaris expert somewhere, they might know
2385 better." */
2386 kill (getpid (), SIGIO);
2387 #endif
2388
2389 /* Check for keyboard input */
2390 /* If there is any, return immediately
2391 to give it higher priority than subprocesses */
2392
2393 if ((XINT (read_kbd) != 0)
2394 && detect_input_pending_run_timers (do_display))
2395 {
2396 swallow_events (do_display);
2397 if (detect_input_pending_run_timers (do_display))
2398 break;
2399 }
2400
2401 /* If wait_for_cell. check for keyboard input
2402 but don't run any timers.
2403 ??? (It seems wrong to me to check for keyboard
2404 input at all when wait_for_cell, but the code
2405 has been this way since July 1994.
2406 Try changing this after version 19.31.) */
2407 if (wait_for_cell
2408 && detect_input_pending ())
2409 {
2410 swallow_events (do_display);
2411 if (detect_input_pending ())
2412 break;
2413 }
2414
2415 /* Exit now if the cell we're waiting for became non-nil. */
2416 if (wait_for_cell && ! NILP (*wait_for_cell))
2417 break;
2418
2419 #ifdef SIGIO
2420 /* If we think we have keyboard input waiting, but didn't get SIGIO
2421 go read it. This can happen with X on BSD after logging out.
2422 In that case, there really is no input and no SIGIO,
2423 but select says there is input. */
2424
2425 if (XINT (read_kbd) && interrupt_input
2426 && (keyboard_bit_set (&Available)))
2427 kill (getpid (), SIGIO);
2428 #endif
2429
2430 if (! wait_proc)
2431 got_some_input |= nfds > 0;
2432
2433 /* If checking input just got us a size-change event from X,
2434 obey it now if we should. */
2435 if (XINT (read_kbd) || wait_for_cell)
2436 do_pending_window_change ();
2437
2438 /* Check for data from a process. */
2439 /* Really FIRST_PROC_DESC should be 0 on Unix,
2440 but this is safer in the short run. */
2441 for (channel = 0; channel <= max_process_desc; channel++)
2442 {
2443 if (FD_ISSET (channel, &Available)
2444 && FD_ISSET (channel, &non_keyboard_wait_mask))
2445 {
2446 int nread;
2447
2448 /* If waiting for this channel, arrange to return as
2449 soon as no more input to be processed. No more
2450 waiting. */
2451 if (wait_channel == channel)
2452 {
2453 wait_channel = -1;
2454 time_limit = -1;
2455 got_some_input = 1;
2456 }
2457 proc = chan_process[channel];
2458 if (NILP (proc))
2459 continue;
2460
2461 /* Read data from the process, starting with our
2462 buffered-ahead character if we have one. */
2463
2464 nread = read_process_output (proc, channel);
2465 if (nread > 0)
2466 {
2467 /* Since read_process_output can run a filter,
2468 which can call accept-process-output,
2469 don't try to read from any other processes
2470 before doing the select again. */
2471 FD_ZERO (&Available);
2472
2473 if (do_display)
2474 redisplay_preserve_echo_area ();
2475 }
2476 #ifdef EWOULDBLOCK
2477 else if (nread == -1 && errno == EWOULDBLOCK)
2478 ;
2479 #endif
2480 /* ISC 4.1 defines both EWOULDBLOCK and O_NONBLOCK,
2481 and Emacs uses O_NONBLOCK, so what we get is EAGAIN. */
2482 #ifdef O_NONBLOCK
2483 else if (nread == -1 && errno == EAGAIN)
2484 ;
2485 #else
2486 #ifdef O_NDELAY
2487 else if (nread == -1 && errno == EAGAIN)
2488 ;
2489 /* Note that we cannot distinguish between no input
2490 available now and a closed pipe.
2491 With luck, a closed pipe will be accompanied by
2492 subprocess termination and SIGCHLD. */
2493 else if (nread == 0 && !NETCONN_P (proc))
2494 ;
2495 #endif /* O_NDELAY */
2496 #endif /* O_NONBLOCK */
2497 #ifdef HAVE_PTYS
2498 /* On some OSs with ptys, when the process on one end of
2499 a pty exits, the other end gets an error reading with
2500 errno = EIO instead of getting an EOF (0 bytes read).
2501 Therefore, if we get an error reading and errno =
2502 EIO, just continue, because the child process has
2503 exited and should clean itself up soon (e.g. when we
2504 get a SIGCHLD). */
2505 else if (nread == -1 && errno == EIO)
2506 ;
2507 #endif /* HAVE_PTYS */
2508 /* If we can detect process termination, don't consider the process
2509 gone just because its pipe is closed. */
2510 #ifdef SIGCHLD
2511 else if (nread == 0 && !NETCONN_P (proc))
2512 ;
2513 #endif
2514 else
2515 {
2516 /* Preserve status of processes already terminated. */
2517 XSETINT (XPROCESS (proc)->tick, ++process_tick);
2518 deactivate_process (proc);
2519 if (!NILP (XPROCESS (proc)->raw_status_low))
2520 update_status (XPROCESS (proc));
2521 if (EQ (XPROCESS (proc)->status, Qrun))
2522 XPROCESS (proc)->status
2523 = Fcons (Qexit, Fcons (make_number (256), Qnil));
2524 }
2525 }
2526 } /* end for each file descriptor */
2527 } /* end while exit conditions not met */
2528
2529 waiting_for_user_input_p = 0;
2530
2531 /* If calling from keyboard input, do not quit
2532 since we want to return C-g as an input character.
2533 Otherwise, do pending quit if requested. */
2534 if (XINT (read_kbd) >= 0)
2535 {
2536 /* Prevent input_pending from remaining set if we quit. */
2537 clear_input_pending ();
2538 QUIT;
2539 }
2540 #ifdef hpux
2541 /* AlainF 5-Jul-1996
2542 HP-UX 10.10 seems to have problems with signals coming in
2543 Causes "poll: interrupted system call" messages when Emacs is run
2544 in an X window
2545 Turn periodic alarms back on */
2546 start_polling();
2547 #endif
2548
2549 return got_some_input;
2550 }
2551 \f
2552 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
2553
2554 static Lisp_Object
2555 read_process_output_call (fun_and_args)
2556 Lisp_Object fun_and_args;
2557 {
2558 return apply1 (XCONS (fun_and_args)->car, XCONS (fun_and_args)->cdr);
2559 }
2560
2561 static Lisp_Object
2562 read_process_output_error_handler (error)
2563 Lisp_Object error;
2564 {
2565 cmd_error_internal (error, "error in process filter: ");
2566 Vinhibit_quit = Qt;
2567 update_echo_area ();
2568 Fsleep_for (make_number (2), Qnil);
2569 }
2570
2571 #ifdef WINDOWSNT
2572 #define READ_CHILD_OUTPUT read_child_output
2573 #else
2574 #define READ_CHILD_OUTPUT read
2575 #endif
2576
2577 /* Read pending output from the process channel,
2578 starting with our buffered-ahead character if we have one.
2579 Yield number of decoded characters read.
2580
2581 This function reads at most 1024 characters.
2582 If you want to read all available subprocess output,
2583 you must call it repeatedly until it returns zero.
2584
2585 The characters read are decoded according to PROC's coding-system
2586 for decoding. */
2587
2588 read_process_output (proc, channel)
2589 Lisp_Object proc;
2590 register int channel;
2591 {
2592 register int nchars;
2593 char *chars;
2594 #ifdef VMS
2595 int chars_allocated = 0; /* If 1, `chars' should be freed later. */
2596 #else
2597 char buf[1024];
2598 #endif
2599 register Lisp_Object outstream;
2600 register struct buffer *old = current_buffer;
2601 register struct Lisp_Process *p = XPROCESS (proc);
2602 register int opoint;
2603 struct coding_system *coding = proc_decode_coding_system[channel];
2604 int chars_in_decoding_buf = 0; /* If 1, `chars' points
2605 XSTRING (p->decoding_buf)->data. */
2606
2607 #ifdef VMS
2608 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2609
2610 vs = get_vms_process_pointer (p->pid);
2611 if (vs)
2612 {
2613 if (!vs->iosb[0])
2614 return(0); /* Really weird if it does this */
2615 if (!(vs->iosb[0] & 1))
2616 return -1; /* I/O error */
2617 }
2618 else
2619 error ("Could not get VMS process pointer");
2620 chars = vs->inputBuffer;
2621 nchars = clean_vms_buffer (chars, vs->iosb[1]);
2622 if (nchars <= 0)
2623 {
2624 start_vms_process_read (vs); /* Crank up the next read on the process */
2625 return 1; /* Nothing worth printing, say we got 1 */
2626 }
2627 if (coding->carryover_size)
2628 {
2629 /* The data carried over in the previous decoding should be
2630 prepended to the new data read to decode all together. */
2631 char *buf = (char *) xmalloc (nchars + coding->carryover_size);
2632
2633 bcopy (coding->carryover, buf, coding->carryover_size);
2634 bcopy (chars, buf + coding->carryover_size, nchars);
2635 chars = buf;
2636 chars_allocated = 1;
2637 }
2638 #else /* not VMS */
2639
2640 if (coding->carryover_size)
2641 /* The data carried over in the previous decoding should be
2642 prepended to the new data read to decode all together. */
2643 bcopy (coding->carryover, buf, coding->carryover_size);
2644
2645 if (proc_buffered_char[channel] < 0)
2646 nchars = READ_CHILD_OUTPUT (channel, buf + coding->carryover_size,
2647 (sizeof buf) - coding->carryover_size);
2648 else
2649 {
2650 buf[coding->carryover_size] = proc_buffered_char[channel];
2651 proc_buffered_char[channel] = -1;
2652 nchars = READ_CHILD_OUTPUT (channel, buf + coding->carryover_size + 1,
2653 (sizeof buf) - coding->carryover_size - 1);
2654 if (nchars < 0)
2655 nchars = 1;
2656 else
2657 nchars = nchars + 1;
2658 }
2659 chars = buf;
2660 #endif /* not VMS */
2661
2662 /* At this point, NCHARS holds number of characters just received
2663 (including the one in proc_buffered_char[channel]). */
2664 if (nchars <= 0) return nchars;
2665
2666 /* Now set NCHARS how many bytes we must decode. */
2667 nchars += coding->carryover_size;
2668
2669 if (CODING_REQUIRE_CONVERSION (coding))
2670 {
2671 int require = decoding_buffer_size (coding, nchars);
2672 int consumed, produced;
2673
2674 if (XSTRING (p->decoding_buf)->size < require)
2675 p->decoding_buf = make_uninit_string (require);
2676 produced = decode_coding (coding, chars, XSTRING (p->decoding_buf)->data,
2677 nchars, XSTRING (p->decoding_buf)->size,
2678 &consumed);
2679
2680 /* New coding-system might be found by `decode_coding'. */
2681 if (!EQ (p->decode_coding_system, coding->symbol))
2682 {
2683 p->decode_coding_system = coding->symbol;
2684 setup_coding_system (coding->symbol,
2685 proc_decode_coding_system[channel]);
2686 /* If coding-system for encoding is not yet decided, we set it
2687 as the same as coding-system for decoding. */
2688 if (NILP (p->encode_coding_system))
2689 {
2690 p->encode_coding_system = coding->symbol;
2691 setup_coding_system (coding->symbol,
2692 proc_encode_coding_system[channel]);
2693 }
2694 }
2695 #ifdef VMS
2696 /* Now we don't need the contents of `chars'. */
2697 if (chars_allocated)
2698 free (chars);
2699 #endif
2700 if (produced == 0)
2701 return 0;
2702 chars = XSTRING (p->decoding_buf)->data;
2703 nchars = produced;
2704 chars_in_decoding_buf = 1;
2705 }
2706 #ifdef VMS
2707 else if (chars_allocated)
2708 {
2709 /* Although we don't have to decode the received data, we must
2710 move it to an area which we don't have to free. */
2711 if (! STRINGP (p->decoding_buf)
2712 || XSTRING (p->decoding_buf)->size < nchars)
2713 p->decoding_buf = make_uninit_string (nchars);
2714 bcopy (chars, XSTRING (p->decoding_buf)->data, nchars);
2715 free (chars);
2716 chars = XSTRING (p->decoding_buf)->data;
2717 chars_in_decoding_buf = 1;
2718 }
2719 #endif
2720
2721 outstream = p->filter;
2722 if (!NILP (outstream))
2723 {
2724 /* We inhibit quit here instead of just catching it so that
2725 hitting ^G when a filter happens to be running won't screw
2726 it up. */
2727 int count = specpdl_ptr - specpdl;
2728 Lisp_Object odeactivate;
2729 Lisp_Object obuffer, okeymap;
2730 int outer_running_asynch_code = running_asynch_code;
2731
2732 /* No need to gcpro these, because all we do with them later
2733 is test them for EQness, and none of them should be a string. */
2734 odeactivate = Vdeactivate_mark;
2735 XSETBUFFER (obuffer, current_buffer);
2736 okeymap = current_buffer->keymap;
2737
2738 specbind (Qinhibit_quit, Qt);
2739 specbind (Qlast_nonmenu_event, Qt);
2740
2741 /* In case we get recursively called,
2742 and we already saved the match data nonrecursively,
2743 save the same match data in safely recursive fashion. */
2744 if (outer_running_asynch_code)
2745 {
2746 Lisp_Object tem;
2747 /* Don't clobber the CURRENT match data, either! */
2748 tem = Fmatch_data (Qnil, Qnil);
2749 restore_match_data ();
2750 record_unwind_protect (Fstore_match_data, Fmatch_data (Qnil, Qnil));
2751 Fstore_match_data (tem);
2752 }
2753
2754 /* For speed, if a search happens within this code,
2755 save the match data in a special nonrecursive fashion. */
2756 running_asynch_code = 1;
2757
2758 /* Read and dispose of the process output. */
2759 internal_condition_case_1 (read_process_output_call,
2760 Fcons (outstream,
2761 Fcons (proc,
2762 Fcons (make_string (chars,
2763 nchars),
2764 Qnil))),
2765 !NILP (Vdebug_on_error) ? Qnil : Qerror,
2766 read_process_output_error_handler);
2767
2768 /* If we saved the match data nonrecursively, restore it now. */
2769 restore_match_data ();
2770 running_asynch_code = outer_running_asynch_code;
2771
2772 /* Handling the process output should not deactivate the mark. */
2773 Vdeactivate_mark = odeactivate;
2774
2775 #if 0 /* Call record_asynch_buffer_change unconditionally,
2776 because we might have changed minor modes or other things
2777 that affect key bindings. */
2778 if (! EQ (Fcurrent_buffer (), obuffer)
2779 || ! EQ (current_buffer->keymap, okeymap))
2780 #endif
2781 /* But do it only if the caller is actually going to read events.
2782 Otherwise there's no need to make him wake up, and it could
2783 cause trouble (for example it would make Fsit_for return). */
2784 if (waiting_for_user_input_p == -1)
2785 record_asynch_buffer_change ();
2786
2787 #ifdef VMS
2788 start_vms_process_read (vs);
2789 #endif
2790 unbind_to (count, Qnil);
2791 return nchars;
2792 }
2793
2794 /* If no filter, write into buffer if it isn't dead. */
2795 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
2796 {
2797 Lisp_Object old_read_only;
2798 int old_begv, old_zv;
2799 Lisp_Object odeactivate;
2800 int before;
2801
2802 odeactivate = Vdeactivate_mark;
2803
2804 Fset_buffer (p->buffer);
2805 opoint = PT;
2806 old_read_only = current_buffer->read_only;
2807 old_begv = BEGV;
2808 old_zv = ZV;
2809
2810 current_buffer->read_only = Qnil;
2811
2812 /* Insert new output into buffer
2813 at the current end-of-output marker,
2814 thus preserving logical ordering of input and output. */
2815 if (XMARKER (p->mark)->buffer)
2816 SET_PT (clip_to_bounds (BEGV, marker_position (p->mark), ZV));
2817 else
2818 SET_PT (ZV);
2819 before = PT;
2820
2821 /* If the output marker is outside of the visible region, save
2822 the restriction and widen. */
2823 if (! (BEGV <= PT && PT <= ZV))
2824 Fwiden ();
2825
2826 /* Insert before markers in case we are inserting where
2827 the buffer's mark is, and the user's next command is Meta-y. */
2828 if (chars_in_decoding_buf)
2829 insert_from_string_before_markers (p->decoding_buf, 0, nchars, 0);
2830 else
2831 insert_before_markers (chars, nchars);
2832 Fset_marker (p->mark, make_number (PT), p->buffer);
2833
2834 update_mode_lines++;
2835
2836 /* Make sure opoint and the old restrictions
2837 float ahead of any new text just as point would. */
2838 if (opoint >= before)
2839 opoint += PT - before;
2840 if (old_begv > before)
2841 old_begv += PT - before;
2842 if (old_zv >= before)
2843 old_zv += PT - before;
2844
2845 /* If the restriction isn't what it should be, set it. */
2846 if (old_begv != BEGV || old_zv != ZV)
2847 Fnarrow_to_region (make_number (old_begv), make_number (old_zv));
2848
2849 /* Handling the process output should not deactivate the mark. */
2850 Vdeactivate_mark = odeactivate;
2851
2852 current_buffer->read_only = old_read_only;
2853 SET_PT (opoint);
2854 set_buffer_internal (old);
2855 }
2856 #ifdef VMS
2857 start_vms_process_read (vs);
2858 #endif
2859 return nchars;
2860 }
2861
2862 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
2863 0, 0, 0,
2864 "Returns non-nil if emacs is waiting for input from the user.\n\
2865 This is intended for use by asynchronous process output filters and sentinels.")
2866 ()
2867 {
2868 return (waiting_for_user_input_p ? Qt : Qnil);
2869 }
2870 \f
2871 /* Sending data to subprocess */
2872
2873 jmp_buf send_process_frame;
2874
2875 SIGTYPE
2876 send_process_trap ()
2877 {
2878 #ifdef BSD4_1
2879 sigrelse (SIGPIPE);
2880 sigrelse (SIGALRM);
2881 #endif /* BSD4_1 */
2882 longjmp (send_process_frame, 1);
2883 }
2884
2885 /* Send some data to process PROC.
2886 BUF is the beginning of the data; LEN is the number of characters.
2887 OBJECT is the Lisp object that the data comes from.
2888
2889 The data is encoded by PROC's coding-system for encoding before it
2890 is sent. But if the data ends at the middle of multi-byte
2891 representation, that incomplete sequence of bytes are sent without
2892 being encoded. Should we store them in a buffer to prepend them to
2893 the data send later? */
2894
2895 send_process (proc, buf, len, object)
2896 volatile Lisp_Object proc;
2897 char *buf;
2898 int len;
2899 Lisp_Object object;
2900 {
2901 /* Use volatile to protect variables from being clobbered by longjmp. */
2902 int rv;
2903 volatile unsigned char *procname = XSTRING (XPROCESS (proc)->name)->data;
2904 struct coding_system *coding;
2905 struct gcpro gcpro1;
2906
2907 GCPRO1 (object);
2908
2909 #ifdef VMS
2910 struct Lisp_Process *p = XPROCESS (proc);
2911 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
2912 #endif /* VMS */
2913
2914 if (! NILP (XPROCESS (proc)->raw_status_low))
2915 update_status (XPROCESS (proc));
2916 if (! EQ (XPROCESS (proc)->status, Qrun))
2917 error ("Process %s not running", procname);
2918 if (XINT (XPROCESS (proc)->outfd) < 0)
2919 error ("Output file descriptor of %s is closed", procname);
2920
2921 coding = proc_encode_coding_system[XINT (XPROCESS (proc)->outfd)];
2922 if (CODING_REQUIRE_CONVERSION (coding))
2923 {
2924 int require = encoding_buffer_size (coding, len);
2925 int offset, dummy;
2926 char *temp_buf = NULL;
2927
2928 /* Remember the offset of data because a string or a buffer may
2929 be relocated. Setting OFFSET to -1 means we don't have to
2930 care relocation. */
2931 offset = (BUFFERP (object)
2932 ? BUF_PTR_CHAR_POS (XBUFFER (object), (unsigned char *) buf)
2933 : (STRINGP (object)
2934 ? offset = buf - (char *) XSTRING (object)->data
2935 : -1));
2936
2937 if (coding->carryover_size > 0)
2938 {
2939 temp_buf = (char *) xmalloc (len + coding->carryover_size);
2940
2941 if (offset >= 0)
2942 {
2943 if (BUFFERP (object))
2944 buf = (char *) BUF_CHAR_ADDRESS (XBUFFER (object), offset);
2945 else if (STRINGP (object))
2946 buf = offset + (char *) XSTRING (object)->data;
2947 /* Now we don't have to care relocation. */
2948 offset = -1;
2949 }
2950 bcopy (coding->carryover, temp_buf, coding->carryover_size);
2951 bcopy (buf, temp_buf + coding->carryover_size, len);
2952 buf = temp_buf;
2953 }
2954
2955 if (XSTRING (XPROCESS (proc)->encoding_buf)->size < require)
2956 {
2957 XPROCESS (proc)->encoding_buf = make_uninit_string (require);
2958
2959 if (offset >= 0)
2960 {
2961 if (BUFFERP (object))
2962 buf = (char *) BUF_CHAR_ADDRESS (XBUFFER (object), offset);
2963 else if (STRINGP (object))
2964 buf = offset + (char *) XSTRING (object)->data;
2965 }
2966 }
2967 object = XPROCESS (proc)->encoding_buf;
2968 len = encode_coding (coding, buf, XSTRING (object)->data,
2969 len, XSTRING (object)->size, &dummy);
2970 buf = XSTRING (object)->data;
2971 if (temp_buf)
2972 xfree (temp_buf);
2973 }
2974
2975 #ifdef VMS
2976 vs = get_vms_process_pointer (p->pid);
2977 if (vs == 0)
2978 error ("Could not find this process: %x", p->pid);
2979 else if (write_to_vms_process (vs, buf, len))
2980 ;
2981 #else
2982
2983 if (pty_max_bytes == 0)
2984 {
2985 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
2986 pty_max_bytes = fpathconf (XFASTINT (XPROCESS (proc)->outfd),
2987 _PC_MAX_CANON);
2988 if (pty_max_bytes < 0)
2989 pty_max_bytes = 250;
2990 #else
2991 pty_max_bytes = 250;
2992 #endif
2993 /* Deduct one, to leave space for the eof. */
2994 pty_max_bytes--;
2995 }
2996
2997 if (!setjmp (send_process_frame))
2998 while (len > 0)
2999 {
3000 int this = len;
3001 SIGTYPE (*old_sigpipe)();
3002 int flush_pty = 0;
3003
3004 /* Decide how much data we can send in one batch.
3005 Long lines need to be split into multiple batches. */
3006 if (!NILP (XPROCESS (proc)->pty_flag))
3007 {
3008 /* Starting this at zero is always correct when not the first iteration
3009 because the previous iteration ended by sending C-d.
3010 It may not be correct for the first iteration
3011 if a partial line was sent in a separate send_process call.
3012 If that proves worth handling, we need to save linepos
3013 in the process object. */
3014 int linepos = 0;
3015 char *ptr = buf;
3016 char *end = buf + len;
3017
3018 /* Scan through this text for a line that is too long. */
3019 while (ptr != end && linepos < pty_max_bytes)
3020 {
3021 if (*ptr == '\n')
3022 linepos = 0;
3023 else
3024 linepos++;
3025 ptr++;
3026 }
3027 /* If we found one, break the line there
3028 and put in a C-d to force the buffer through. */
3029 this = ptr - buf;
3030 }
3031
3032 /* Send this batch, using one or more write calls. */
3033 while (this > 0)
3034 {
3035 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
3036 rv = write (XINT (XPROCESS (proc)->outfd), buf, this);
3037 signal (SIGPIPE, old_sigpipe);
3038
3039 if (rv < 0)
3040 {
3041 if (0
3042 #ifdef EWOULDBLOCK
3043 || errno == EWOULDBLOCK
3044 #endif
3045 #ifdef EAGAIN
3046 || errno == EAGAIN
3047 #endif
3048 )
3049 /* Buffer is full. Wait, accepting input;
3050 that may allow the program
3051 to finish doing output and read more. */
3052 {
3053 Lisp_Object zero;
3054 int offset;
3055
3056 /* Running filters might relocate buffers or strings.
3057 Arrange to relocate BUF. */
3058 if (BUFFERP (object))
3059 offset = BUF_PTR_CHAR_POS (XBUFFER (object),
3060 (unsigned char *) buf);
3061 else if (STRINGP (object))
3062 offset = buf - (char *) XSTRING (object)->data;
3063
3064 XSETFASTINT (zero, 0);
3065 #ifdef EMACS_HAS_USECS
3066 wait_reading_process_input (0, 20000, zero, 0);
3067 #else
3068 wait_reading_process_input (1, 0, zero, 0);
3069 #endif
3070
3071 if (BUFFERP (object))
3072 buf = (char *) BUF_CHAR_ADDRESS (XBUFFER (object), offset);
3073 else if (STRINGP (object))
3074 buf = offset + (char *) XSTRING (object)->data;
3075
3076 rv = 0;
3077 }
3078 else
3079 /* This is a real error. */
3080 report_file_error ("writing to process", Fcons (proc, Qnil));
3081 }
3082 buf += rv;
3083 len -= rv;
3084 this -= rv;
3085 }
3086
3087 /* If we sent just part of the string, put in an EOF
3088 to force it through, before we send the rest. */
3089 if (len > 0)
3090 Fprocess_send_eof (proc);
3091 }
3092 #endif
3093 else
3094 {
3095 XPROCESS (proc)->raw_status_low = Qnil;
3096 XPROCESS (proc)->raw_status_high = Qnil;
3097 XPROCESS (proc)->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
3098 XSETINT (XPROCESS (proc)->tick, ++process_tick);
3099 deactivate_process (proc);
3100 #ifdef VMS
3101 error ("Error writing to process %s; closed it", procname);
3102 #else
3103 error ("SIGPIPE raised on process %s; closed it", procname);
3104 #endif
3105 }
3106
3107 UNGCPRO;
3108 }
3109
3110 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
3111 3, 3, 0,
3112 "Send current contents of region as input to PROCESS.\n\
3113 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3114 nil, indicating the current buffer's process.\n\
3115 Called from program, takes three arguments, PROCESS, START and END.\n\
3116 If the region is more than 500 characters long,\n\
3117 it is sent in several bunches. This may happen even for shorter regions.\n\
3118 Output from processes can arrive in between bunches.")
3119 (process, start, end)
3120 Lisp_Object process, start, end;
3121 {
3122 Lisp_Object proc;
3123 int start1;
3124
3125 proc = get_process (process);
3126 validate_region (&start, &end);
3127
3128 if (XINT (start) < GPT && XINT (end) > GPT)
3129 move_gap (start);
3130
3131 start1 = XINT (start);
3132 send_process (proc, POS_ADDR (start1), XINT (end) - XINT (start),
3133 Fcurrent_buffer ());
3134
3135 return Qnil;
3136 }
3137
3138 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
3139 2, 2, 0,
3140 "Send PROCESS the contents of STRING as input.\n\
3141 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3142 nil, indicating the current buffer's process.\n\
3143 If STRING is more than 500 characters long,\n\
3144 it is sent in several bunches. This may happen even for shorter strings.\n\
3145 Output from processes can arrive in between bunches.")
3146 (process, string)
3147 Lisp_Object process, string;
3148 {
3149 Lisp_Object proc;
3150 CHECK_STRING (string, 1);
3151 proc = get_process (process);
3152 send_process (proc, XSTRING (string)->data, XSTRING (string)->size, string);
3153 return Qnil;
3154 }
3155 \f
3156 /* send a signal number SIGNO to PROCESS.
3157 CURRENT_GROUP means send to the process group that currently owns
3158 the terminal being used to communicate with PROCESS.
3159 This is used for various commands in shell mode.
3160 If NOMSG is zero, insert signal-announcements into process's buffers
3161 right away.
3162
3163 If we can, we try to signal PROCESS by sending control characters
3164 down the pty. This allows us to signal inferiors who have changed
3165 their uid, for which killpg would return an EPERM error. */
3166
3167 static void
3168 process_send_signal (process, signo, current_group, nomsg)
3169 Lisp_Object process;
3170 int signo;
3171 Lisp_Object current_group;
3172 int nomsg;
3173 {
3174 Lisp_Object proc;
3175 register struct Lisp_Process *p;
3176 int gid;
3177 int no_pgrp = 0;
3178
3179 proc = get_process (process);
3180 p = XPROCESS (proc);
3181
3182 if (!EQ (p->childp, Qt))
3183 error ("Process %s is not a subprocess",
3184 XSTRING (p->name)->data);
3185 if (XINT (p->infd) < 0)
3186 error ("Process %s is not active",
3187 XSTRING (p->name)->data);
3188
3189 if (NILP (p->pty_flag))
3190 current_group = Qnil;
3191
3192 /* If we are using pgrps, get a pgrp number and make it negative. */
3193 if (!NILP (current_group))
3194 {
3195 #ifdef SIGNALS_VIA_CHARACTERS
3196 /* If possible, send signals to the entire pgrp
3197 by sending an input character to it. */
3198
3199 /* TERMIOS is the latest and bestest, and seems most likely to
3200 work. If the system has it, use it. */
3201 #ifdef HAVE_TERMIOS
3202 struct termios t;
3203
3204 switch (signo)
3205 {
3206 case SIGINT:
3207 tcgetattr (XINT (p->infd), &t);
3208 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3209 return;
3210
3211 case SIGQUIT:
3212 tcgetattr (XINT (p->infd), &t);
3213 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3214 return;
3215
3216 case SIGTSTP:
3217 tcgetattr (XINT (p->infd), &t);
3218 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
3219 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3220 #else
3221 send_process (proc, &t.c_cc[VSUSP], 1, Qnil);
3222 #endif
3223 return;
3224 }
3225
3226 #else /* ! HAVE_TERMIOS */
3227
3228 /* On Berkeley descendants, the following IOCTL's retrieve the
3229 current control characters. */
3230 #if defined (TIOCGLTC) && defined (TIOCGETC)
3231
3232 struct tchars c;
3233 struct ltchars lc;
3234
3235 switch (signo)
3236 {
3237 case SIGINT:
3238 ioctl (XINT (p->infd), TIOCGETC, &c);
3239 send_process (proc, &c.t_intrc, 1, Qnil);
3240 return;
3241 case SIGQUIT:
3242 ioctl (XINT (p->infd), TIOCGETC, &c);
3243 send_process (proc, &c.t_quitc, 1, Qnil);
3244 return;
3245 #ifdef SIGTSTP
3246 case SIGTSTP:
3247 ioctl (XINT (p->infd), TIOCGLTC, &lc);
3248 send_process (proc, &lc.t_suspc, 1, Qnil);
3249 return;
3250 #endif /* ! defined (SIGTSTP) */
3251 }
3252
3253 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3254
3255 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
3256 characters. */
3257 #ifdef TCGETA
3258 struct termio t;
3259 switch (signo)
3260 {
3261 case SIGINT:
3262 ioctl (XINT (p->infd), TCGETA, &t);
3263 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
3264 return;
3265 case SIGQUIT:
3266 ioctl (XINT (p->infd), TCGETA, &t);
3267 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
3268 return;
3269 #ifdef SIGTSTP
3270 case SIGTSTP:
3271 ioctl (XINT (p->infd), TCGETA, &t);
3272 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
3273 return;
3274 #endif /* ! defined (SIGTSTP) */
3275 }
3276 #else /* ! defined (TCGETA) */
3277 Your configuration files are messed up.
3278 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
3279 you'd better be using one of the alternatives above! */
3280 #endif /* ! defined (TCGETA) */
3281 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
3282 #endif /* ! defined HAVE_TERMIOS */
3283 #endif /* ! defined (SIGNALS_VIA_CHARACTERS) */
3284
3285 #ifdef TIOCGPGRP
3286 /* Get the pgrp using the tty itself, if we have that.
3287 Otherwise, use the pty to get the pgrp.
3288 On pfa systems, saka@pfu.fujitsu.co.JP writes:
3289 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
3290 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
3291 His patch indicates that if TIOCGPGRP returns an error, then
3292 we should just assume that p->pid is also the process group id. */
3293 {
3294 int err;
3295
3296 if (!NILP (p->subtty))
3297 err = ioctl (XFASTINT (p->subtty), TIOCGPGRP, &gid);
3298 else
3299 err = ioctl (XINT (p->infd), TIOCGPGRP, &gid);
3300
3301 #ifdef pfa
3302 if (err == -1)
3303 gid = - XFASTINT (p->pid);
3304 #endif /* ! defined (pfa) */
3305 }
3306 if (gid == -1)
3307 no_pgrp = 1;
3308 else
3309 gid = - gid;
3310 #else /* ! defined (TIOCGPGRP ) */
3311 /* Can't select pgrps on this system, so we know that
3312 the child itself heads the pgrp. */
3313 gid = - XFASTINT (p->pid);
3314 #endif /* ! defined (TIOCGPGRP ) */
3315 }
3316 else
3317 gid = - XFASTINT (p->pid);
3318
3319 switch (signo)
3320 {
3321 #ifdef SIGCONT
3322 case SIGCONT:
3323 p->raw_status_low = Qnil;
3324 p->raw_status_high = Qnil;
3325 p->status = Qrun;
3326 XSETINT (p->tick, ++process_tick);
3327 if (!nomsg)
3328 status_notify ();
3329 break;
3330 #endif /* ! defined (SIGCONT) */
3331 case SIGINT:
3332 #ifdef VMS
3333 send_process (proc, "\003", 1, Qnil); /* ^C */
3334 goto whoosh;
3335 #endif
3336 case SIGQUIT:
3337 #ifdef VMS
3338 send_process (proc, "\031", 1, Qnil); /* ^Y */
3339 goto whoosh;
3340 #endif
3341 case SIGKILL:
3342 #ifdef VMS
3343 sys$forcex (&(XFASTINT (p->pid)), 0, 1);
3344 whoosh:
3345 #endif
3346 flush_pending_output (XINT (p->infd));
3347 break;
3348 }
3349
3350 /* If we don't have process groups, send the signal to the immediate
3351 subprocess. That isn't really right, but it's better than any
3352 obvious alternative. */
3353 if (no_pgrp)
3354 {
3355 kill (XFASTINT (p->pid), signo);
3356 return;
3357 }
3358
3359 /* gid may be a pid, or minus a pgrp's number */
3360 #ifdef TIOCSIGSEND
3361 if (!NILP (current_group))
3362 ioctl (XINT (p->infd), TIOCSIGSEND, signo);
3363 else
3364 {
3365 gid = - XFASTINT (p->pid);
3366 kill (gid, signo);
3367 }
3368 #else /* ! defined (TIOCSIGSEND) */
3369 EMACS_KILLPG (-gid, signo);
3370 #endif /* ! defined (TIOCSIGSEND) */
3371 }
3372
3373 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
3374 "Interrupt process PROCESS. May be process or name of one.\n\
3375 PROCESS may be a process, a buffer, or the name of a process or buffer.\n\
3376 nil or no arg means current buffer's process.\n\
3377 Second arg CURRENT-GROUP non-nil means send signal to\n\
3378 the current process-group of the process's controlling terminal\n\
3379 rather than to the process's own process group.\n\
3380 If the process is a shell, this means interrupt current subjob\n\
3381 rather than the shell.")
3382 (process, current_group)
3383 Lisp_Object process, current_group;
3384 {
3385 process_send_signal (process, SIGINT, current_group, 0);
3386 return process;
3387 }
3388
3389 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
3390 "Kill process PROCESS. May be process or name of one.\n\
3391 See function `interrupt-process' for more details on usage.")
3392 (process, current_group)
3393 Lisp_Object process, current_group;
3394 {
3395 process_send_signal (process, SIGKILL, current_group, 0);
3396 return process;
3397 }
3398
3399 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
3400 "Send QUIT signal to process PROCESS. May be process or name of one.\n\
3401 See function `interrupt-process' for more details on usage.")
3402 (process, current_group)
3403 Lisp_Object process, current_group;
3404 {
3405 process_send_signal (process, SIGQUIT, current_group, 0);
3406 return process;
3407 }
3408
3409 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
3410 "Stop process PROCESS. May be process or name of one.\n\
3411 See function `interrupt-process' for more details on usage.")
3412 (process, current_group)
3413 Lisp_Object process, current_group;
3414 {
3415 #ifndef SIGTSTP
3416 error ("no SIGTSTP support");
3417 #else
3418 process_send_signal (process, SIGTSTP, current_group, 0);
3419 #endif
3420 return process;
3421 }
3422
3423 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
3424 "Continue process PROCESS. May be process or name of one.\n\
3425 See function `interrupt-process' for more details on usage.")
3426 (process, current_group)
3427 Lisp_Object process, current_group;
3428 {
3429 #ifdef SIGCONT
3430 process_send_signal (process, SIGCONT, current_group, 0);
3431 #else
3432 error ("no SIGCONT support");
3433 #endif
3434 return process;
3435 }
3436
3437 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
3438 2, 2, "nProcess number: \nnSignal code: ",
3439 "Send the process with process id PID the signal with code SIGCODE.\n\
3440 PID must be an integer. The process need not be a child of this Emacs.\n\
3441 SIGCODE may be an integer, or a symbol whose name is a signal name.")
3442 (pid, sigcode)
3443 Lisp_Object pid, sigcode;
3444 {
3445 CHECK_NUMBER (pid, 0);
3446
3447 #define handle_signal(NAME, VALUE) \
3448 else if (!strcmp (name, NAME)) \
3449 XSETINT (sigcode, VALUE)
3450
3451 if (INTEGERP (sigcode))
3452 ;
3453 else
3454 {
3455 unsigned char *name;
3456
3457 CHECK_SYMBOL (sigcode, 1);
3458 name = XSYMBOL (sigcode)->name->data;
3459
3460 if (0)
3461 ;
3462 #ifdef SIGHUP
3463 handle_signal ("SIGHUP", SIGHUP);
3464 #endif
3465 #ifdef SIGINT
3466 handle_signal ("SIGINT", SIGINT);
3467 #endif
3468 #ifdef SIGQUIT
3469 handle_signal ("SIGQUIT", SIGQUIT);
3470 #endif
3471 #ifdef SIGILL
3472 handle_signal ("SIGILL", SIGILL);
3473 #endif
3474 #ifdef SIGABRT
3475 handle_signal ("SIGABRT", SIGABRT);
3476 #endif
3477 #ifdef SIGEMT
3478 handle_signal ("SIGEMT", SIGEMT);
3479 #endif
3480 #ifdef SIGKILL
3481 handle_signal ("SIGKILL", SIGKILL);
3482 #endif
3483 #ifdef SIGFPE
3484 handle_signal ("SIGFPE", SIGFPE);
3485 #endif
3486 #ifdef SIGBUS
3487 handle_signal ("SIGBUS", SIGBUS);
3488 #endif
3489 #ifdef SIGSEGV
3490 handle_signal ("SIGSEGV", SIGSEGV);
3491 #endif
3492 #ifdef SIGSYS
3493 handle_signal ("SIGSYS", SIGSYS);
3494 #endif
3495 #ifdef SIGPIPE
3496 handle_signal ("SIGPIPE", SIGPIPE);
3497 #endif
3498 #ifdef SIGALRM
3499 handle_signal ("SIGALRM", SIGALRM);
3500 #endif
3501 #ifdef SIGTERM
3502 handle_signal ("SIGTERM", SIGTERM);
3503 #endif
3504 #ifdef SIGURG
3505 handle_signal ("SIGURG", SIGURG);
3506 #endif
3507 #ifdef SIGSTOP
3508 handle_signal ("SIGSTOP", SIGSTOP);
3509 #endif
3510 #ifdef SIGTSTP
3511 handle_signal ("SIGTSTP", SIGTSTP);
3512 #endif
3513 #ifdef SIGCONT
3514 handle_signal ("SIGCONT", SIGCONT);
3515 #endif
3516 #ifdef SIGCHLD
3517 handle_signal ("SIGCHLD", SIGCHLD);
3518 #endif
3519 #ifdef SIGTTIN
3520 handle_signal ("SIGTTIN", SIGTTIN);
3521 #endif
3522 #ifdef SIGTTOU
3523 handle_signal ("SIGTTOU", SIGTTOU);
3524 #endif
3525 #ifdef SIGIO
3526 handle_signal ("SIGIO", SIGIO);
3527 #endif
3528 #ifdef SIGXCPU
3529 handle_signal ("SIGXCPU", SIGXCPU);
3530 #endif
3531 #ifdef SIGXFSZ
3532 handle_signal ("SIGXFSZ", SIGXFSZ);
3533 #endif
3534 #ifdef SIGVTALRM
3535 handle_signal ("SIGVTALRM", SIGVTALRM);
3536 #endif
3537 #ifdef SIGPROF
3538 handle_signal ("SIGPROF", SIGPROF);
3539 #endif
3540 #ifdef SIGWINCH
3541 handle_signal ("SIGWINCH", SIGWINCH);
3542 #endif
3543 #ifdef SIGINFO
3544 handle_signal ("SIGINFO", SIGINFO);
3545 #endif
3546 #ifdef SIGUSR1
3547 handle_signal ("SIGUSR1", SIGUSR1);
3548 #endif
3549 #ifdef SIGUSR2
3550 handle_signal ("SIGUSR2", SIGUSR2);
3551 #endif
3552 else
3553 error ("Undefined signal name %s", name);
3554 }
3555
3556 #undef handle_signal
3557
3558 return make_number (kill (XINT (pid), XINT (sigcode)));
3559 }
3560
3561 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
3562 "Make PROCESS see end-of-file in its input.\n\
3563 Eof comes after any text already sent to it.\n\
3564 PROCESS may be a process, a buffer, the name of a process or buffer, or\n\
3565 nil, indicating the current buffer's process.\n\
3566 If PROCESS is a network connection, or is a process communicating\n\
3567 through a pipe (as opposed to a pty), then you cannot send any more\n\
3568 text to PROCESS after you call this function.")
3569 (process)
3570 Lisp_Object process;
3571 {
3572 Lisp_Object proc;
3573
3574 proc = get_process (process);
3575
3576 /* Make sure the process is really alive. */
3577 if (! NILP (XPROCESS (proc)->raw_status_low))
3578 update_status (XPROCESS (proc));
3579 if (! EQ (XPROCESS (proc)->status, Qrun))
3580 error ("Process %s not running", XSTRING (XPROCESS (proc)->name)->data);
3581
3582 #ifdef VMS
3583 send_process (proc, "\032", 1, Qnil); /* ^z */
3584 #else
3585 if (!NILP (XPROCESS (proc)->pty_flag))
3586 send_process (proc, "\004", 1, Qnil);
3587 else
3588 {
3589 close (XINT (XPROCESS (proc)->outfd));
3590 XSETINT (XPROCESS (proc)->outfd, open (NULL_DEVICE, O_WRONLY));
3591 }
3592 #endif /* VMS */
3593 return process;
3594 }
3595
3596 /* Kill all processes associated with `buffer'.
3597 If `buffer' is nil, kill all processes */
3598
3599 kill_buffer_processes (buffer)
3600 Lisp_Object buffer;
3601 {
3602 Lisp_Object tail, proc;
3603
3604 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCONS (tail)->cdr)
3605 {
3606 proc = XCONS (XCONS (tail)->car)->cdr;
3607 if (GC_PROCESSP (proc)
3608 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
3609 {
3610 if (NETCONN_P (proc))
3611 Fdelete_process (proc);
3612 else if (XINT (XPROCESS (proc)->infd) >= 0)
3613 process_send_signal (proc, SIGHUP, Qnil, 1);
3614 }
3615 }
3616 }
3617 \f
3618 /* On receipt of a signal that a child status has changed,
3619 loop asking about children with changed statuses until
3620 the system says there are no more.
3621 All we do is change the status;
3622 we do not run sentinels or print notifications.
3623 That is saved for the next time keyboard input is done,
3624 in order to avoid timing errors. */
3625
3626 /** WARNING: this can be called during garbage collection.
3627 Therefore, it must not be fooled by the presence of mark bits in
3628 Lisp objects. */
3629
3630 /** USG WARNING: Although it is not obvious from the documentation
3631 in signal(2), on a USG system the SIGCLD handler MUST NOT call
3632 signal() before executing at least one wait(), otherwise the handler
3633 will be called again, resulting in an infinite loop. The relevant
3634 portion of the documentation reads "SIGCLD signals will be queued
3635 and the signal-catching function will be continually reentered until
3636 the queue is empty". Invoking signal() causes the kernel to reexamine
3637 the SIGCLD queue. Fred Fish, UniSoft Systems Inc. */
3638
3639 SIGTYPE
3640 sigchld_handler (signo)
3641 int signo;
3642 {
3643 int old_errno = errno;
3644 Lisp_Object proc;
3645 register struct Lisp_Process *p;
3646 extern EMACS_TIME *input_available_clear_time;
3647
3648 #ifdef BSD4_1
3649 extern int sigheld;
3650 sigheld |= sigbit (SIGCHLD);
3651 #endif
3652
3653 while (1)
3654 {
3655 register int pid;
3656 WAITTYPE w;
3657 Lisp_Object tail;
3658
3659 #ifdef WNOHANG
3660 #ifndef WUNTRACED
3661 #define WUNTRACED 0
3662 #endif /* no WUNTRACED */
3663 /* Keep trying to get a status until we get a definitive result. */
3664 do
3665 {
3666 errno = 0;
3667 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
3668 }
3669 while (pid <= 0 && errno == EINTR);
3670
3671 if (pid <= 0)
3672 {
3673 /* A real failure. We have done all our job, so return. */
3674
3675 /* USG systems forget handlers when they are used;
3676 must reestablish each time */
3677 #if defined (USG) && !defined (POSIX_SIGNALS)
3678 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
3679 #endif
3680 #ifdef BSD4_1
3681 sigheld &= ~sigbit (SIGCHLD);
3682 sigrelse (SIGCHLD);
3683 #endif
3684 errno = old_errno;
3685 return;
3686 }
3687 #else
3688 pid = wait (&w);
3689 #endif /* no WNOHANG */
3690
3691 /* Find the process that signaled us, and record its status. */
3692
3693 p = 0;
3694 for (tail = Vprocess_alist; CONSP (tail); tail = XCONS (tail)->cdr)
3695 {
3696 proc = XCONS (XCONS (tail)->car)->cdr;
3697 p = XPROCESS (proc);
3698 if (EQ (p->childp, Qt) && XFASTINT (p->pid) == pid)
3699 break;
3700 p = 0;
3701 }
3702
3703 /* Look for an asynchronous process whose pid hasn't been filled
3704 in yet. */
3705 if (p == 0)
3706 for (tail = Vprocess_alist; CONSP (tail); tail = XCONS (tail)->cdr)
3707 {
3708 proc = XCONS (XCONS (tail)->car)->cdr;
3709 p = XPROCESS (proc);
3710 if (INTEGERP (p->pid) && XINT (p->pid) == -1)
3711 break;
3712 p = 0;
3713 }
3714
3715 /* Change the status of the process that was found. */
3716 if (p != 0)
3717 {
3718 union { int i; WAITTYPE wt; } u;
3719 int clear_desc_flag = 0;
3720
3721 XSETINT (p->tick, ++process_tick);
3722 u.wt = w;
3723 XSETINT (p->raw_status_low, u.i & 0xffff);
3724 XSETINT (p->raw_status_high, u.i >> 16);
3725
3726 /* If process has terminated, stop waiting for its output. */
3727 if ((WIFSIGNALED (w) || WIFEXITED (w))
3728 && XINT (p->infd) >= 0)
3729 clear_desc_flag = 1;
3730
3731 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
3732 if (clear_desc_flag)
3733 {
3734 FD_CLR (XINT (p->infd), &input_wait_mask);
3735 FD_CLR (XINT (p->infd), &non_keyboard_wait_mask);
3736 }
3737
3738 /* Tell wait_reading_process_input that it needs to wake up and
3739 look around. */
3740 if (input_available_clear_time)
3741 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
3742 }
3743
3744 /* There was no asynchronous process found for that id. Check
3745 if we have a synchronous process. */
3746 else
3747 {
3748 synch_process_alive = 0;
3749
3750 /* Report the status of the synchronous process. */
3751 if (WIFEXITED (w))
3752 synch_process_retcode = WRETCODE (w);
3753 else if (WIFSIGNALED (w))
3754 {
3755 int code = WTERMSIG (w);
3756 char *signame = 0;
3757
3758 if (code < NSIG)
3759 {
3760 #ifndef VMS
3761 /* Suppress warning if the table has const char *. */
3762 signame = (char *) sys_siglist[code];
3763 #else
3764 signame = sys_errlist[code];
3765 #endif
3766 }
3767 if (signame == 0)
3768 signame = "unknown";
3769
3770 synch_process_death = signame;
3771 }
3772
3773 /* Tell wait_reading_process_input that it needs to wake up and
3774 look around. */
3775 if (input_available_clear_time)
3776 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
3777 }
3778
3779 /* On some systems, we must return right away.
3780 If any more processes want to signal us, we will
3781 get another signal.
3782 Otherwise (on systems that have WNOHANG), loop around
3783 to use up all the processes that have something to tell us. */
3784 #if defined (USG) && ! (defined (HPUX) && defined (WNOHANG)) || defined (WINDOWSNT)
3785 #if defined (USG) && ! defined (POSIX_SIGNALS)
3786 signal (signo, sigchld_handler);
3787 #endif
3788 errno = old_errno;
3789 return;
3790 #endif /* USG, but not HPUX with WNOHANG */
3791 }
3792 }
3793 \f
3794
3795 static Lisp_Object
3796 exec_sentinel_unwind (data)
3797 Lisp_Object data;
3798 {
3799 XPROCESS (XCONS (data)->car)->sentinel = XCONS (data)->cdr;
3800 return Qnil;
3801 }
3802
3803 static Lisp_Object
3804 exec_sentinel_error_handler (error)
3805 Lisp_Object error;
3806 {
3807 cmd_error_internal (error, "error in process sentinel: ");
3808 Vinhibit_quit = Qt;
3809 update_echo_area ();
3810 Fsleep_for (make_number (2), Qnil);
3811 }
3812
3813 static void
3814 exec_sentinel (proc, reason)
3815 Lisp_Object proc, reason;
3816 {
3817 Lisp_Object sentinel, obuffer, odeactivate, okeymap;
3818 register struct Lisp_Process *p = XPROCESS (proc);
3819 int count = specpdl_ptr - specpdl;
3820 int outer_running_asynch_code = running_asynch_code;
3821
3822 /* No need to gcpro these, because all we do with them later
3823 is test them for EQness, and none of them should be a string. */
3824 odeactivate = Vdeactivate_mark;
3825 XSETBUFFER (obuffer, current_buffer);
3826 okeymap = current_buffer->keymap;
3827
3828 sentinel = p->sentinel;
3829 if (NILP (sentinel))
3830 return;
3831
3832 /* Zilch the sentinel while it's running, to avoid recursive invocations;
3833 assure that it gets restored no matter how the sentinel exits. */
3834 p->sentinel = Qnil;
3835 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
3836 /* Inhibit quit so that random quits don't screw up a running filter. */
3837 specbind (Qinhibit_quit, Qt);
3838 specbind (Qlast_nonmenu_event, Qt);
3839
3840 /* In case we get recursively called,
3841 and we already saved the match data nonrecursively,
3842 save the same match data in safely recursive fashion. */
3843 if (outer_running_asynch_code)
3844 {
3845 Lisp_Object tem;
3846 tem = Fmatch_data (Qnil, Qnil);
3847 restore_match_data ();
3848 record_unwind_protect (Fstore_match_data, Fmatch_data (Qnil, Qnil));
3849 Fstore_match_data (tem);
3850 }
3851
3852 /* For speed, if a search happens within this code,
3853 save the match data in a special nonrecursive fashion. */
3854 running_asynch_code = 1;
3855
3856 internal_condition_case_1 (read_process_output_call,
3857 Fcons (sentinel,
3858 Fcons (proc, Fcons (reason, Qnil))),
3859 !NILP (Vdebug_on_error) ? Qnil : Qerror,
3860 exec_sentinel_error_handler);
3861
3862 /* If we saved the match data nonrecursively, restore it now. */
3863 restore_match_data ();
3864 running_asynch_code = outer_running_asynch_code;
3865
3866 Vdeactivate_mark = odeactivate;
3867 #if 0
3868 if (! EQ (Fcurrent_buffer (), obuffer)
3869 || ! EQ (current_buffer->keymap, okeymap))
3870 #endif
3871 /* But do it only if the caller is actually going to read events.
3872 Otherwise there's no need to make him wake up, and it could
3873 cause trouble (for example it would make Fsit_for return). */
3874 if (waiting_for_user_input_p == -1)
3875 record_asynch_buffer_change ();
3876
3877 unbind_to (count, Qnil);
3878 }
3879
3880 /* Report all recent events of a change in process status
3881 (either run the sentinel or output a message).
3882 This is done while Emacs is waiting for keyboard input. */
3883
3884 status_notify ()
3885 {
3886 register Lisp_Object proc, buffer;
3887 Lisp_Object tail, msg;
3888 struct gcpro gcpro1, gcpro2;
3889
3890 tail = Qnil;
3891 msg = Qnil;
3892 /* We need to gcpro tail; if read_process_output calls a filter
3893 which deletes a process and removes the cons to which tail points
3894 from Vprocess_alist, and then causes a GC, tail is an unprotected
3895 reference. */
3896 GCPRO2 (tail, msg);
3897
3898 /* Set this now, so that if new processes are created by sentinels
3899 that we run, we get called again to handle their status changes. */
3900 update_tick = process_tick;
3901
3902 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
3903 {
3904 Lisp_Object symbol;
3905 register struct Lisp_Process *p;
3906
3907 proc = Fcdr (Fcar (tail));
3908 p = XPROCESS (proc);
3909
3910 if (XINT (p->tick) != XINT (p->update_tick))
3911 {
3912 XSETINT (p->update_tick, XINT (p->tick));
3913
3914 /* If process is still active, read any output that remains. */
3915 while (! EQ (p->filter, Qt)
3916 && XINT (p->infd) >= 0
3917 && read_process_output (proc, XINT (p->infd)) > 0);
3918
3919 buffer = p->buffer;
3920
3921 /* Get the text to use for the message. */
3922 if (!NILP (p->raw_status_low))
3923 update_status (p);
3924 msg = status_message (p->status);
3925
3926 /* If process is terminated, deactivate it or delete it. */
3927 symbol = p->status;
3928 if (CONSP (p->status))
3929 symbol = XCONS (p->status)->car;
3930
3931 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
3932 || EQ (symbol, Qclosed))
3933 {
3934 if (delete_exited_processes)
3935 remove_process (proc);
3936 else
3937 deactivate_process (proc);
3938 }
3939
3940 /* The actions above may have further incremented p->tick.
3941 So set p->update_tick again
3942 so that an error in the sentinel will not cause
3943 this code to be run again. */
3944 XSETINT (p->update_tick, XINT (p->tick));
3945 /* Now output the message suitably. */
3946 if (!NILP (p->sentinel))
3947 exec_sentinel (proc, msg);
3948 /* Don't bother with a message in the buffer
3949 when a process becomes runnable. */
3950 else if (!EQ (symbol, Qrun) && !NILP (buffer))
3951 {
3952 Lisp_Object ro, tem;
3953 struct buffer *old = current_buffer;
3954 int opoint;
3955 int before;
3956
3957 ro = XBUFFER (buffer)->read_only;
3958
3959 /* Avoid error if buffer is deleted
3960 (probably that's why the process is dead, too) */
3961 if (NILP (XBUFFER (buffer)->name))
3962 continue;
3963 Fset_buffer (buffer);
3964
3965 opoint = PT;
3966 /* Insert new output into buffer
3967 at the current end-of-output marker,
3968 thus preserving logical ordering of input and output. */
3969 if (XMARKER (p->mark)->buffer)
3970 SET_PT (marker_position (p->mark));
3971 else
3972 SET_PT (ZV);
3973
3974 before = PT;
3975
3976 tem = current_buffer->read_only;
3977 current_buffer->read_only = Qnil;
3978 insert_string ("\nProcess ");
3979 Finsert (1, &p->name);
3980 insert_string (" ");
3981 Finsert (1, &msg);
3982 current_buffer->read_only = tem;
3983 Fset_marker (p->mark, make_number (PT), p->buffer);
3984
3985 if (opoint >= before)
3986 SET_PT (opoint + (PT - before));
3987 else
3988 SET_PT (opoint);
3989
3990 set_buffer_internal (old);
3991 }
3992 }
3993 } /* end for */
3994
3995 update_mode_lines++; /* in case buffers use %s in mode-line-format */
3996 redisplay_preserve_echo_area ();
3997
3998 UNGCPRO;
3999 }
4000
4001 \f
4002 DEFUN ("set-process-coding-system", Fset_process_coding_system,
4003 Sset_process_coding_system, 1, 3, 0,
4004 "Set coding-systems of PROCESS to DECODING (input from the process) and\n\
4005 ENCODING (output to the process).")
4006 (proc, decoding, encoding)
4007 register Lisp_Object proc, decoding, encoding;
4008 {
4009 register struct Lisp_Process *p;
4010
4011 CHECK_PROCESS (proc, 0);
4012 p = XPROCESS (proc);
4013 if (XINT (p->infd) < 0)
4014 error ("Input file descriptor of %s closed", XSTRING (p->name)->data);
4015 if (XINT (p->outfd) < 0)
4016 error ("Output file descriptor of %s closed", XSTRING (p->name)->data);
4017
4018 p->decode_coding_system = Fcheck_coding_system (decoding);
4019 p->encode_coding_system = Fcheck_coding_system (encoding);
4020 setup_coding_system (decoding,
4021 proc_decode_coding_system[XINT (p->infd)]);
4022 setup_coding_system (encoding,
4023 proc_encode_coding_system[XINT (p->outfd)]);
4024
4025 return Qnil;
4026 }
4027
4028 DEFUN ("process-coding-system",
4029 Fprocess_coding_system, Sprocess_coding_system, 1, 1, 0,
4030 "Return a cons of coding-system for decoding and encoding of PROCESS.")
4031 (proc)
4032 register Lisp_Object proc;
4033 {
4034 CHECK_PROCESS (proc, 0);
4035 return Fcons (XPROCESS (proc)->decode_coding_system,
4036 XPROCESS (proc)->encode_coding_system);
4037 }
4038 \f
4039 /* The first time this is called, assume keyboard input comes from DESC
4040 instead of from where we used to expect it.
4041 Subsequent calls mean assume input keyboard can come from DESC
4042 in addition to other places. */
4043
4044 static int add_keyboard_wait_descriptor_called_flag;
4045
4046 void
4047 add_keyboard_wait_descriptor (desc)
4048 int desc;
4049 {
4050 if (! add_keyboard_wait_descriptor_called_flag)
4051 FD_CLR (0, &input_wait_mask);
4052 add_keyboard_wait_descriptor_called_flag = 1;
4053 FD_SET (desc, &input_wait_mask);
4054 FD_SET (desc, &non_process_wait_mask);
4055 if (desc > max_keyboard_desc)
4056 max_keyboard_desc = desc;
4057 }
4058
4059 /* From now on, do not expect DESC to give keyboard input. */
4060
4061 void
4062 delete_keyboard_wait_descriptor (desc)
4063 int desc;
4064 {
4065 int fd;
4066 int lim = max_keyboard_desc;
4067
4068 FD_CLR (desc, &input_wait_mask);
4069 FD_CLR (desc, &non_process_wait_mask);
4070
4071 if (desc == max_keyboard_desc)
4072 for (fd = 0; fd < lim; fd++)
4073 if (FD_ISSET (fd, &input_wait_mask)
4074 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4075 max_keyboard_desc = fd;
4076 }
4077
4078 /* Return nonzero if *MASK has a bit set
4079 that corresponds to one of the keyboard input descriptors. */
4080
4081 int
4082 keyboard_bit_set (mask)
4083 SELECT_TYPE *mask;
4084 {
4085 int fd;
4086
4087 for (fd = 0; fd <= max_keyboard_desc; fd++)
4088 if (FD_ISSET (fd, mask) && FD_ISSET (fd, &input_wait_mask)
4089 && !FD_ISSET (fd, &non_keyboard_wait_mask))
4090 return 1;
4091
4092 return 0;
4093 }
4094 \f
4095 init_process ()
4096 {
4097 register int i;
4098
4099 #ifdef SIGCHLD
4100 #ifndef CANNOT_DUMP
4101 if (! noninteractive || initialized)
4102 #endif
4103 signal (SIGCHLD, sigchld_handler);
4104 #endif
4105
4106 FD_ZERO (&input_wait_mask);
4107 FD_ZERO (&non_keyboard_wait_mask);
4108 FD_ZERO (&non_process_wait_mask);
4109 max_process_desc = 0;
4110
4111 FD_SET (0, &input_wait_mask);
4112
4113 Vprocess_alist = Qnil;
4114 for (i = 0; i < MAXDESC; i++)
4115 {
4116 chan_process[i] = Qnil;
4117 proc_buffered_char[i] = -1;
4118 }
4119 bzero (proc_decode_coding_system, sizeof proc_decode_coding_system);
4120 bzero (proc_encode_coding_system, sizeof proc_encode_coding_system);
4121 }
4122
4123 syms_of_process ()
4124 {
4125 Qprocessp = intern ("processp");
4126 staticpro (&Qprocessp);
4127 Qrun = intern ("run");
4128 staticpro (&Qrun);
4129 Qstop = intern ("stop");
4130 staticpro (&Qstop);
4131 Qsignal = intern ("signal");
4132 staticpro (&Qsignal);
4133
4134 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
4135 here again.
4136
4137 Qexit = intern ("exit");
4138 staticpro (&Qexit); */
4139
4140 Qopen = intern ("open");
4141 staticpro (&Qopen);
4142 Qclosed = intern ("closed");
4143 staticpro (&Qclosed);
4144
4145 Qlast_nonmenu_event = intern ("last-nonmenu-event");
4146 staticpro (&Qlast_nonmenu_event);
4147
4148 staticpro (&Vprocess_alist);
4149
4150 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
4151 "*Non-nil means delete processes immediately when they exit.\n\
4152 nil means don't delete them until `list-processes' is run.");
4153
4154 delete_exited_processes = 1;
4155
4156 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
4157 "Control type of device used to communicate with subprocesses.\n\
4158 Values are nil to use a pipe, or t or `pty' to use a pty.\n\
4159 The value has no effect if the system has no ptys or if all ptys are busy:\n\
4160 then a pipe is used in any case.\n\
4161 The value takes effect when `start-process' is called.");
4162 Vprocess_connection_type = Qt;
4163
4164 defsubr (&Sprocessp);
4165 defsubr (&Sget_process);
4166 defsubr (&Sget_buffer_process);
4167 defsubr (&Sdelete_process);
4168 defsubr (&Sprocess_status);
4169 defsubr (&Sprocess_exit_status);
4170 defsubr (&Sprocess_id);
4171 defsubr (&Sprocess_name);
4172 defsubr (&Sprocess_tty_name);
4173 defsubr (&Sprocess_command);
4174 defsubr (&Sset_process_buffer);
4175 defsubr (&Sprocess_buffer);
4176 defsubr (&Sprocess_mark);
4177 defsubr (&Sset_process_filter);
4178 defsubr (&Sprocess_filter);
4179 defsubr (&Sset_process_sentinel);
4180 defsubr (&Sprocess_sentinel);
4181 defsubr (&Sset_process_window_size);
4182 defsubr (&Sprocess_kill_without_query);
4183 defsubr (&Sprocess_contact);
4184 defsubr (&Slist_processes);
4185 defsubr (&Sprocess_list);
4186 defsubr (&Sstart_process);
4187 #ifdef HAVE_SOCKETS
4188 defsubr (&Sopen_network_stream);
4189 #endif /* HAVE_SOCKETS */
4190 defsubr (&Saccept_process_output);
4191 defsubr (&Sprocess_send_region);
4192 defsubr (&Sprocess_send_string);
4193 defsubr (&Sinterrupt_process);
4194 defsubr (&Skill_process);
4195 defsubr (&Squit_process);
4196 defsubr (&Sstop_process);
4197 defsubr (&Scontinue_process);
4198 defsubr (&Sprocess_send_eof);
4199 defsubr (&Ssignal_process);
4200 defsubr (&Swaiting_for_user_input_p);
4201 /* defsubr (&Sprocess_connection); */
4202 defsubr (&Sset_process_coding_system);
4203 defsubr (&Sprocess_coding_system);
4204 }
4205
4206 \f
4207 #else /* not subprocesses */
4208
4209 #include <sys/types.h>
4210 #include <errno.h>
4211
4212 #include "lisp.h"
4213 #include "systime.h"
4214 #include "termopts.h"
4215 #include "sysselect.h"
4216
4217 extern int frame_garbaged;
4218
4219 extern EMACS_TIME timer_check ();
4220 extern int timers_run;
4221
4222 /* As described above, except assuming that there are no subprocesses:
4223
4224 Wait for timeout to elapse and/or keyboard input to be available.
4225
4226 time_limit is:
4227 timeout in seconds, or
4228 zero for no limit, or
4229 -1 means gobble data immediately available but don't wait for any.
4230
4231 read_kbd is a Lisp_Object:
4232 0 to ignore keyboard input, or
4233 1 to return when input is available, or
4234 -1 means caller will actually read the input, so don't throw to
4235 the quit handler.
4236 a cons cell, meaning wait until its car is non-nil
4237 (and gobble terminal input into the buffer if any arrives), or
4238 We know that read_kbd will never be a Lisp_Process, since
4239 `subprocesses' isn't defined.
4240
4241 do_display != 0 means redisplay should be done to show subprocess
4242 output that arrives.
4243
4244 Return true iff we received input from any process. */
4245
4246 int
4247 wait_reading_process_input (time_limit, microsecs, read_kbd, do_display)
4248 int time_limit, microsecs;
4249 Lisp_Object read_kbd;
4250 int do_display;
4251 {
4252 EMACS_TIME end_time, timeout;
4253 SELECT_TYPE waitchannels;
4254 int xerrno;
4255 Lisp_Object *wait_for_cell = 0;
4256
4257 /* If waiting for non-nil in a cell, record where. */
4258 if (CONSP (read_kbd))
4259 {
4260 wait_for_cell = &XCONS (read_kbd)->car;
4261 XSETFASTINT (read_kbd, 0);
4262 }
4263
4264 /* What does time_limit really mean? */
4265 if (time_limit || microsecs)
4266 {
4267 if (time_limit == -1)
4268 /* In fact, it's zero. */
4269 EMACS_SET_SECS_USECS (timeout, 0, 0);
4270 else
4271 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
4272
4273 /* How far in the future is that? */
4274 EMACS_GET_TIME (end_time);
4275 EMACS_ADD_TIME (end_time, end_time, timeout);
4276 }
4277 else
4278 /* It's infinite. */
4279 EMACS_SET_SECS_USECS (timeout, 100000, 0);
4280
4281 /* Turn off periodic alarms (in case they are in use)
4282 because the select emulator uses alarms. */
4283 stop_polling ();
4284
4285 for (;;)
4286 {
4287 int nfds;
4288 int timeout_reduced_for_timers = 0;
4289
4290 /* If calling from keyboard input, do not quit
4291 since we want to return C-g as an input character.
4292 Otherwise, do pending quit if requested. */
4293 if (XINT (read_kbd) >= 0)
4294 QUIT;
4295
4296 /* Exit now if the cell we're waiting for became non-nil. */
4297 if (wait_for_cell && ! NILP (*wait_for_cell))
4298 break;
4299
4300 /* Compute time from now till when time limit is up */
4301 /* Exit if already run out */
4302 if (time_limit > 0 || microsecs)
4303 {
4304 EMACS_GET_TIME (timeout);
4305 EMACS_SUB_TIME (timeout, end_time, timeout);
4306 if (EMACS_TIME_NEG_P (timeout))
4307 break;
4308 }
4309
4310 /* If our caller will not immediately handle keyboard events,
4311 run timer events directly.
4312 (Callers that will immediately read keyboard events
4313 call timer_delay on their own.) */
4314 if (! wait_for_cell)
4315 {
4316 EMACS_TIME timer_delay;
4317 int old_timers_run;
4318
4319 retry:
4320 old_timers_run = timers_run;
4321 timer_delay = timer_check (1);
4322 if (timers_run != old_timers_run && do_display)
4323 {
4324 redisplay_preserve_echo_area ();
4325 /* We must retry, since a timer may have requeued itself
4326 and that could alter the time delay. */
4327 goto retry;
4328 }
4329
4330 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
4331 {
4332 EMACS_TIME difference;
4333 EMACS_SUB_TIME (difference, timer_delay, timeout);
4334 if (EMACS_TIME_NEG_P (difference))
4335 {
4336 timeout = timer_delay;
4337 timeout_reduced_for_timers = 1;
4338 }
4339 }
4340 }
4341
4342 /* Cause C-g and alarm signals to take immediate action,
4343 and cause input available signals to zero out timeout. */
4344 if (XINT (read_kbd) < 0)
4345 set_waiting_for_input (&timeout);
4346
4347 /* Wait till there is something to do. */
4348
4349 if (! XINT (read_kbd) && wait_for_cell == 0)
4350 FD_ZERO (&waitchannels);
4351 else
4352 FD_SET (0, &waitchannels);
4353
4354 /* If a frame has been newly mapped and needs updating,
4355 reprocess its display stuff. */
4356 if (frame_garbaged && do_display)
4357 {
4358 clear_waiting_for_input ();
4359 redisplay_preserve_echo_area ();
4360 if (XINT (read_kbd) < 0)
4361 set_waiting_for_input (&timeout);
4362 }
4363
4364 if (XINT (read_kbd) && detect_input_pending ())
4365 {
4366 nfds = 0;
4367 FD_ZERO (&waitchannels);
4368 }
4369 else
4370 nfds = select (1, &waitchannels, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
4371 &timeout);
4372
4373 xerrno = errno;
4374
4375 /* Make C-g and alarm signals set flags again */
4376 clear_waiting_for_input ();
4377
4378 /* If we woke up due to SIGWINCH, actually change size now. */
4379 do_pending_window_change ();
4380
4381 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
4382 /* We waited the full specified time, so return now. */
4383 break;
4384
4385 if (nfds == -1)
4386 {
4387 /* If the system call was interrupted, then go around the
4388 loop again. */
4389 if (xerrno == EINTR)
4390 FD_ZERO (&waitchannels);
4391 else
4392 error ("select error: %s", strerror (xerrno));
4393 }
4394 #ifdef sun
4395 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
4396 /* System sometimes fails to deliver SIGIO. */
4397 kill (getpid (), SIGIO);
4398 #endif
4399 #ifdef SIGIO
4400 if (XINT (read_kbd) && interrupt_input && (waitchannels & 1))
4401 kill (getpid (), SIGIO);
4402 #endif
4403
4404 /* Check for keyboard input */
4405
4406 if ((XINT (read_kbd) != 0)
4407 && detect_input_pending_run_timers (do_display))
4408 {
4409 swallow_events (do_display);
4410 if (detect_input_pending_run_timers (do_display))
4411 break;
4412 }
4413
4414 /* If wait_for_cell. check for keyboard input
4415 but don't run any timers.
4416 ??? (It seems wrong to me to check for keyboard
4417 input at all when wait_for_cell, but the code
4418 has been this way since July 1994.
4419 Try changing this after version 19.31.) */
4420 if (wait_for_cell
4421 && detect_input_pending ())
4422 {
4423 swallow_events (do_display);
4424 if (detect_input_pending ())
4425 break;
4426 }
4427
4428 /* Exit now if the cell we're waiting for became non-nil. */
4429 if (wait_for_cell && ! NILP (*wait_for_cell))
4430 break;
4431 }
4432
4433 start_polling ();
4434
4435 return 0;
4436 }
4437
4438
4439 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
4440 /* Don't confuse make-docfile by having two doc strings for this function.
4441 make-docfile does not pay attention to #if, for good reason! */
4442 0)
4443 (name)
4444 register Lisp_Object name;
4445 {
4446 return Qnil;
4447 }
4448
4449 /* Kill all processes associated with `buffer'.
4450 If `buffer' is nil, kill all processes.
4451 Since we have no subprocesses, this does nothing. */
4452
4453 kill_buffer_processes (buffer)
4454 Lisp_Object buffer;
4455 {
4456 }
4457
4458 init_process ()
4459 {
4460 }
4461
4462 syms_of_process ()
4463 {
4464 defsubr (&Sget_buffer_process);
4465 }
4466
4467 \f
4468 #endif /* not subprocesses */