[TARGET_API_MAC_CARBON] (mac_handle_window_event):
[emacs.git] / src / process.c
blob08358539a6cf909cd5a101fb1f773049c7d31e3f
1 /* Asynchronous subprocess control for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1993, 1994, 1995,
3 1996, 1998, 1999, 2001, 2002, 2003, 2004,
4 2005, 2006, 2007 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3, or (at your option)
11 any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
24 #include <config.h>
25 #include <signal.h>
27 /* This file is split into two parts by the following preprocessor
28 conditional. The 'then' clause contains all of the support for
29 asynchronous subprocesses. The 'else' clause contains stub
30 versions of some of the asynchronous subprocess routines that are
31 often called elsewhere in Emacs, so we don't have to #ifdef the
32 sections that call them. */
35 #ifdef subprocesses
37 #include <stdio.h>
38 #include <errno.h>
39 #include <setjmp.h>
40 #include <sys/types.h> /* some typedefs are used in sys/file.h */
41 #include <sys/file.h>
42 #include <sys/stat.h>
43 #ifdef HAVE_INTTYPES_H
44 #include <inttypes.h>
45 #endif
46 #ifdef HAVE_UNISTD_H
47 #include <unistd.h>
48 #endif
50 #if defined(WINDOWSNT) || defined(UNIX98_PTYS)
51 #include <stdlib.h>
52 #include <fcntl.h>
53 #endif /* not WINDOWSNT */
55 #ifdef HAVE_SOCKETS /* TCP connection support, if kernel can do it */
56 #include <sys/socket.h>
57 #include <netdb.h>
58 #include <netinet/in.h>
59 #include <arpa/inet.h>
60 #ifdef NEED_NET_ERRNO_H
61 #include <net/errno.h>
62 #endif /* NEED_NET_ERRNO_H */
64 /* Are local (unix) sockets supported? */
65 #if defined (HAVE_SYS_UN_H) && !defined (NO_SOCKETS_IN_FILE_SYSTEM)
66 #if !defined (AF_LOCAL) && defined (AF_UNIX)
67 #define AF_LOCAL AF_UNIX
68 #endif
69 #ifdef AF_LOCAL
70 #define HAVE_LOCAL_SOCKETS
71 #include <sys/un.h>
72 #endif
73 #endif
74 #endif /* HAVE_SOCKETS */
76 /* TERM is a poor-man's SLIP, used on GNU/Linux. */
77 #ifdef TERM
78 #include <client.h>
79 #endif
81 /* On some systems, e.g. DGUX, inet_addr returns a 'struct in_addr'. */
82 #ifdef HAVE_BROKEN_INET_ADDR
83 #define IN_ADDR struct in_addr
84 #define NUMERIC_ADDR_ERROR (numeric_addr.s_addr == -1)
85 #else
86 #define IN_ADDR unsigned long
87 #define NUMERIC_ADDR_ERROR (numeric_addr == -1)
88 #endif
90 #if defined(BSD_SYSTEM) || defined(STRIDE)
91 #include <sys/ioctl.h>
92 #if !defined (O_NDELAY) && defined (HAVE_PTYS) && !defined(USG5)
93 #include <fcntl.h>
94 #endif /* HAVE_PTYS and no O_NDELAY */
95 #endif /* BSD_SYSTEM || STRIDE */
97 #ifdef BROKEN_O_NONBLOCK
98 #undef O_NONBLOCK
99 #endif /* BROKEN_O_NONBLOCK */
101 #ifdef NEED_BSDTTY
102 #include <bsdtty.h>
103 #endif
105 /* Can we use SIOCGIFCONF and/or SIOCGIFADDR */
106 #ifdef HAVE_SOCKETS
107 #if defined(HAVE_SYS_IOCTL_H) && defined(HAVE_NET_IF_H)
108 /* sys/ioctl.h may have been included already */
109 #ifndef SIOCGIFADDR
110 #include <sys/ioctl.h>
111 #endif
112 #include <net/if.h>
113 #endif
114 #endif
116 #ifdef IRIS
117 #include <sys/sysmacros.h> /* for "minor" */
118 #endif /* not IRIS */
120 #ifdef HAVE_SYS_WAIT
121 #include <sys/wait.h>
122 #endif
124 #include "lisp.h"
125 #include "systime.h"
126 #include "systty.h"
128 #include "window.h"
129 #include "buffer.h"
130 #include "charset.h"
131 #include "coding.h"
132 #include "process.h"
133 #include "termhooks.h"
134 #include "termopts.h"
135 #include "commands.h"
136 #include "keyboard.h"
137 #include "frame.h"
138 #include "blockinput.h"
139 #include "dispextern.h"
140 #include "composite.h"
141 #include "atimer.h"
143 Lisp_Object Qprocessp;
144 Lisp_Object Qrun, Qstop, Qsignal;
145 Lisp_Object Qopen, Qclosed, Qconnect, Qfailed, Qlisten;
146 Lisp_Object Qlocal, Qipv4, Qdatagram;
147 #ifdef AF_INET6
148 Lisp_Object Qipv6;
149 #endif
150 Lisp_Object QCname, QCbuffer, QChost, QCservice, QCtype;
151 Lisp_Object QClocal, QCremote, QCcoding;
152 Lisp_Object QCserver, QCnowait, QCnoquery, QCstop;
153 Lisp_Object QCsentinel, QClog, QCoptions, QCplist;
154 Lisp_Object QCfilter_multibyte;
155 Lisp_Object Qlast_nonmenu_event;
156 /* QCfamily is declared and initialized in xfaces.c,
157 QCfilter in keyboard.c. */
158 extern Lisp_Object QCfamily, QCfilter;
160 /* Qexit is declared and initialized in eval.c. */
162 /* QCfamily is defined in xfaces.c. */
163 extern Lisp_Object QCfamily;
164 /* QCfilter is defined in keyboard.c. */
165 extern Lisp_Object QCfilter;
167 /* a process object is a network connection when its childp field is neither
168 Qt nor Qnil but is instead a property list (KEY VAL ...). */
170 #ifdef HAVE_SOCKETS
171 #define NETCONN_P(p) (GC_CONSP (XPROCESS (p)->childp))
172 #define NETCONN1_P(p) (GC_CONSP ((p)->childp))
173 #else
174 #define NETCONN_P(p) 0
175 #define NETCONN1_P(p) 0
176 #endif /* HAVE_SOCKETS */
178 /* Define first descriptor number available for subprocesses. */
179 #ifdef VMS
180 #define FIRST_PROC_DESC 1
181 #else /* Not VMS */
182 #define FIRST_PROC_DESC 3
183 #endif
185 /* Define SIGCHLD as an alias for SIGCLD. There are many conditionals
186 testing SIGCHLD. */
188 #if !defined (SIGCHLD) && defined (SIGCLD)
189 #define SIGCHLD SIGCLD
190 #endif /* SIGCLD */
192 #include "syssignal.h"
194 #include "syswait.h"
196 extern char *get_operating_system_release ();
198 #ifndef USE_CRT_DLL
199 extern int errno;
200 #endif
201 #ifdef VMS
202 extern char *sys_errlist[];
203 #endif
205 #ifndef HAVE_H_ERRNO
206 extern int h_errno;
207 #endif
209 /* t means use pty, nil means use a pipe,
210 maybe other values to come. */
211 static Lisp_Object Vprocess_connection_type;
213 #ifdef SKTPAIR
214 #ifndef HAVE_SOCKETS
215 #include <sys/socket.h>
216 #endif
217 #endif /* SKTPAIR */
219 /* These next two vars are non-static since sysdep.c uses them in the
220 emulation of `select'. */
221 /* Number of events of change of status of a process. */
222 int process_tick;
223 /* Number of events for which the user or sentinel has been notified. */
224 int update_tick;
226 /* Define NON_BLOCKING_CONNECT if we can support non-blocking connects. */
228 #ifdef BROKEN_NON_BLOCKING_CONNECT
229 #undef NON_BLOCKING_CONNECT
230 #else
231 #ifndef NON_BLOCKING_CONNECT
232 #ifdef HAVE_SOCKETS
233 #ifdef HAVE_SELECT
234 #if defined (HAVE_GETPEERNAME) || defined (GNU_LINUX)
235 #if defined (O_NONBLOCK) || defined (O_NDELAY)
236 #if defined (EWOULDBLOCK) || defined (EINPROGRESS)
237 #define NON_BLOCKING_CONNECT
238 #endif /* EWOULDBLOCK || EINPROGRESS */
239 #endif /* O_NONBLOCK || O_NDELAY */
240 #endif /* HAVE_GETPEERNAME || GNU_LINUX */
241 #endif /* HAVE_SELECT */
242 #endif /* HAVE_SOCKETS */
243 #endif /* NON_BLOCKING_CONNECT */
244 #endif /* BROKEN_NON_BLOCKING_CONNECT */
246 /* Define DATAGRAM_SOCKETS if datagrams can be used safely on
247 this system. We need to read full packets, so we need a
248 "non-destructive" select. So we require either native select,
249 or emulation of select using FIONREAD. */
251 #ifdef BROKEN_DATAGRAM_SOCKETS
252 #undef DATAGRAM_SOCKETS
253 #else
254 #ifndef DATAGRAM_SOCKETS
255 #ifdef HAVE_SOCKETS
256 #if defined (HAVE_SELECT) || defined (FIONREAD)
257 #if defined (HAVE_SENDTO) && defined (HAVE_RECVFROM) && defined (EMSGSIZE)
258 #define DATAGRAM_SOCKETS
259 #endif /* HAVE_SENDTO && HAVE_RECVFROM && EMSGSIZE */
260 #endif /* HAVE_SELECT || FIONREAD */
261 #endif /* HAVE_SOCKETS */
262 #endif /* DATAGRAM_SOCKETS */
263 #endif /* BROKEN_DATAGRAM_SOCKETS */
265 #ifdef TERM
266 #undef NON_BLOCKING_CONNECT
267 #undef DATAGRAM_SOCKETS
268 #endif
270 #if !defined (ADAPTIVE_READ_BUFFERING) && !defined (NO_ADAPTIVE_READ_BUFFERING)
271 #ifdef EMACS_HAS_USECS
272 #define ADAPTIVE_READ_BUFFERING
273 #endif
274 #endif
276 #ifdef ADAPTIVE_READ_BUFFERING
277 #define READ_OUTPUT_DELAY_INCREMENT 10000
278 #define READ_OUTPUT_DELAY_MAX (READ_OUTPUT_DELAY_INCREMENT * 5)
279 #define READ_OUTPUT_DELAY_MAX_MAX (READ_OUTPUT_DELAY_INCREMENT * 7)
281 /* Number of processes which have a non-zero read_output_delay,
282 and therefore might be delayed for adaptive read buffering. */
284 static int process_output_delay_count;
286 /* Non-zero if any process has non-nil read_output_skip. */
288 static int process_output_skip;
290 /* Non-nil means to delay reading process output to improve buffering.
291 A value of t means that delay is reset after each send, any other
292 non-nil value does not reset the delay. A value of nil disables
293 adaptive read buffering completely. */
294 static Lisp_Object Vprocess_adaptive_read_buffering;
295 #else
296 #define process_output_delay_count 0
297 #endif
300 #include "sysselect.h"
302 static int keyboard_bit_set P_ ((SELECT_TYPE *));
303 static void deactivate_process P_ ((Lisp_Object));
304 static void status_notify P_ ((struct Lisp_Process *));
305 static int read_process_output P_ ((Lisp_Object, int));
307 /* If we support a window system, turn on the code to poll periodically
308 to detect C-g. It isn't actually used when doing interrupt input. */
309 #ifdef HAVE_WINDOW_SYSTEM
310 #define POLL_FOR_INPUT
311 #endif
313 static Lisp_Object get_process ();
314 static void exec_sentinel ();
316 extern EMACS_TIME timer_check ();
317 extern int timers_run;
319 /* Mask of bits indicating the descriptors that we wait for input on. */
321 static SELECT_TYPE input_wait_mask;
323 /* Mask that excludes keyboard input descriptor(s). */
325 static SELECT_TYPE non_keyboard_wait_mask;
327 /* Mask that excludes process input descriptor(s). */
329 static SELECT_TYPE non_process_wait_mask;
331 /* Mask for the gpm mouse input descriptor. */
333 static SELECT_TYPE gpm_wait_mask;
335 #ifdef NON_BLOCKING_CONNECT
336 /* Mask of bits indicating the descriptors that we wait for connect to
337 complete on. Once they complete, they are removed from this mask
338 and added to the input_wait_mask and non_keyboard_wait_mask. */
340 static SELECT_TYPE connect_wait_mask;
342 /* Number of bits set in connect_wait_mask. */
343 static int num_pending_connects;
345 #define IF_NON_BLOCKING_CONNECT(s) s
346 #else
347 #define IF_NON_BLOCKING_CONNECT(s)
348 #endif
350 /* The largest descriptor currently in use for a process object. */
351 static int max_process_desc;
353 /* The largest descriptor currently in use for keyboard input. */
354 static int max_keyboard_desc;
356 /* The largest descriptor currently in use for gpm mouse input. */
357 static int max_gpm_desc;
359 /* Nonzero means delete a process right away if it exits. */
360 static int delete_exited_processes;
362 /* Indexed by descriptor, gives the process (if any) for that descriptor */
363 Lisp_Object chan_process[MAXDESC];
365 /* Alist of elements (NAME . PROCESS) */
366 Lisp_Object Vprocess_alist;
368 /* Buffered-ahead input char from process, indexed by channel.
369 -1 means empty (no char is buffered).
370 Used on sys V where the only way to tell if there is any
371 output from the process is to read at least one char.
372 Always -1 on systems that support FIONREAD. */
374 /* Don't make static; need to access externally. */
375 int proc_buffered_char[MAXDESC];
377 /* Table of `struct coding-system' for each process. */
378 static struct coding_system *proc_decode_coding_system[MAXDESC];
379 static struct coding_system *proc_encode_coding_system[MAXDESC];
381 #ifdef DATAGRAM_SOCKETS
382 /* Table of `partner address' for datagram sockets. */
383 struct sockaddr_and_len {
384 struct sockaddr *sa;
385 int len;
386 } datagram_address[MAXDESC];
387 #define DATAGRAM_CHAN_P(chan) (datagram_address[chan].sa != 0)
388 #define DATAGRAM_CONN_P(proc) (PROCESSP (proc) && datagram_address[XPROCESS (proc)->infd].sa != 0)
389 #else
390 #define DATAGRAM_CHAN_P(chan) (0)
391 #define DATAGRAM_CONN_P(proc) (0)
392 #endif
394 /* Maximum number of bytes to send to a pty without an eof. */
395 static int pty_max_bytes;
397 /* Nonzero means don't run process sentinels. This is used
398 when exiting. */
399 int inhibit_sentinels;
401 #ifdef HAVE_PTYS
402 #ifdef HAVE_PTY_H
403 #include <pty.h>
404 #endif
405 /* The file name of the pty opened by allocate_pty. */
407 static char pty_name[24];
408 #endif
410 /* Compute the Lisp form of the process status, p->status, from
411 the numeric status that was returned by `wait'. */
413 static Lisp_Object status_convert ();
415 static void
416 update_status (p)
417 struct Lisp_Process *p;
419 union { int i; WAITTYPE wt; } u;
420 eassert (p->raw_status_new);
421 u.i = p->raw_status;
422 p->status = status_convert (u.wt);
423 p->raw_status_new = 0;
426 /* Convert a process status word in Unix format to
427 the list that we use internally. */
429 static Lisp_Object
430 status_convert (w)
431 WAITTYPE w;
433 if (WIFSTOPPED (w))
434 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
435 else if (WIFEXITED (w))
436 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
437 WCOREDUMP (w) ? Qt : Qnil));
438 else if (WIFSIGNALED (w))
439 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
440 WCOREDUMP (w) ? Qt : Qnil));
441 else
442 return Qrun;
445 /* Given a status-list, extract the three pieces of information
446 and store them individually through the three pointers. */
448 static void
449 decode_status (l, symbol, code, coredump)
450 Lisp_Object l;
451 Lisp_Object *symbol;
452 int *code;
453 int *coredump;
455 Lisp_Object tem;
457 if (SYMBOLP (l))
459 *symbol = l;
460 *code = 0;
461 *coredump = 0;
463 else
465 *symbol = XCAR (l);
466 tem = XCDR (l);
467 *code = XFASTINT (XCAR (tem));
468 tem = XCDR (tem);
469 *coredump = !NILP (tem);
473 /* Return a string describing a process status list. */
475 static Lisp_Object
476 status_message (p)
477 struct Lisp_Process *p;
479 Lisp_Object status = p->status;
480 Lisp_Object symbol;
481 int code, coredump;
482 Lisp_Object string, string2;
484 decode_status (status, &symbol, &code, &coredump);
486 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
488 char *signame;
489 synchronize_system_messages_locale ();
490 signame = strsignal (code);
491 if (signame == 0)
492 signame = "unknown";
493 string = build_string (signame);
494 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
495 SSET (string, 0, DOWNCASE (SREF (string, 0)));
496 return concat2 (string, string2);
498 else if (EQ (symbol, Qexit))
500 if (NETCONN1_P (p))
501 return build_string (code == 0 ? "deleted\n" : "connection broken by remote peer\n");
502 if (code == 0)
503 return build_string ("finished\n");
504 string = Fnumber_to_string (make_number (code));
505 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
506 return concat3 (build_string ("exited abnormally with code "),
507 string, string2);
509 else if (EQ (symbol, Qfailed))
511 string = Fnumber_to_string (make_number (code));
512 string2 = build_string ("\n");
513 return concat3 (build_string ("failed with code "),
514 string, string2);
516 else
517 return Fcopy_sequence (Fsymbol_name (symbol));
520 #ifdef HAVE_PTYS
522 /* Open an available pty, returning a file descriptor.
523 Return -1 on failure.
524 The file name of the terminal corresponding to the pty
525 is left in the variable pty_name. */
527 static int
528 allocate_pty ()
530 register int c, i;
531 int fd;
533 #ifdef PTY_ITERATION
534 PTY_ITERATION
535 #else
536 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
537 for (i = 0; i < 16; i++)
538 #endif
540 struct stat stb; /* Used in some PTY_OPEN. */
541 #ifdef PTY_NAME_SPRINTF
542 PTY_NAME_SPRINTF
543 #else
544 sprintf (pty_name, "/dev/pty%c%x", c, i);
545 #endif /* no PTY_NAME_SPRINTF */
547 #ifdef PTY_OPEN
548 PTY_OPEN;
549 #else /* no PTY_OPEN */
551 # ifdef IRIS
552 /* Unusual IRIS code */
553 *ptyv = emacs_open ("/dev/ptc", O_RDWR | O_NDELAY, 0);
554 if (fd < 0)
555 return -1;
556 if (fstat (fd, &stb) < 0)
557 return -1;
558 # else /* not IRIS */
559 { /* Some systems name their pseudoterminals so that there are gaps in
560 the usual sequence - for example, on HP9000/S700 systems, there
561 are no pseudoterminals with names ending in 'f'. So we wait for
562 three failures in a row before deciding that we've reached the
563 end of the ptys. */
564 int failed_count = 0;
566 if (stat (pty_name, &stb) < 0)
568 failed_count++;
569 if (failed_count >= 3)
570 return -1;
572 else
573 failed_count = 0;
575 # ifdef O_NONBLOCK
576 fd = emacs_open (pty_name, O_RDWR | O_NONBLOCK, 0);
577 # else
578 fd = emacs_open (pty_name, O_RDWR | O_NDELAY, 0);
579 # endif
580 # endif /* not IRIS */
582 #endif /* no PTY_OPEN */
584 if (fd >= 0)
586 /* check to make certain that both sides are available
587 this avoids a nasty yet stupid bug in rlogins */
588 #ifdef PTY_TTY_NAME_SPRINTF
589 PTY_TTY_NAME_SPRINTF
590 #else
591 sprintf (pty_name, "/dev/tty%c%x", c, i);
592 #endif /* no PTY_TTY_NAME_SPRINTF */
593 #ifndef UNIPLUS
594 if (access (pty_name, 6) != 0)
596 emacs_close (fd);
597 # if !defined(IRIS) && !defined(__sgi)
598 continue;
599 # else
600 return -1;
601 # endif /* IRIS */
603 #endif /* not UNIPLUS */
604 setup_pty (fd);
605 return fd;
608 return -1;
610 #endif /* HAVE_PTYS */
612 static Lisp_Object
613 make_process (name)
614 Lisp_Object name;
616 register Lisp_Object val, tem, name1;
617 register struct Lisp_Process *p;
618 char suffix[10];
619 register int i;
621 p = allocate_process ();
623 p->infd = -1;
624 p->outfd = -1;
625 p->tick = 0;
626 p->update_tick = 0;
627 p->pid = 0;
628 p->raw_status_new = 0;
629 p->status = Qrun;
630 p->mark = Fmake_marker ();
632 #ifdef ADAPTIVE_READ_BUFFERING
633 p->adaptive_read_buffering = 0;
634 p->read_output_delay = 0;
635 p->read_output_skip = 0;
636 #endif
638 /* If name is already in use, modify it until it is unused. */
640 name1 = name;
641 for (i = 1; ; i++)
643 tem = Fget_process (name1);
644 if (NILP (tem)) break;
645 sprintf (suffix, "<%d>", i);
646 name1 = concat2 (name, build_string (suffix));
648 name = name1;
649 p->name = name;
650 XSETPROCESS (val, p);
651 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
652 return val;
655 static void
656 remove_process (proc)
657 register Lisp_Object proc;
659 register Lisp_Object pair;
661 pair = Frassq (proc, Vprocess_alist);
662 Vprocess_alist = Fdelq (pair, Vprocess_alist);
664 deactivate_process (proc);
667 /* Setup coding systems of PROCESS. */
669 void
670 setup_process_coding_systems (process)
671 Lisp_Object process;
673 struct Lisp_Process *p = XPROCESS (process);
674 int inch = p->infd;
675 int outch = p->outfd;
677 if (inch < 0 || outch < 0)
678 return;
680 if (!proc_decode_coding_system[inch])
681 proc_decode_coding_system[inch]
682 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
683 setup_coding_system (p->decode_coding_system,
684 proc_decode_coding_system[inch]);
685 if (! NILP (p->filter))
687 if (!p->filter_multibyte)
688 setup_raw_text_coding_system (proc_decode_coding_system[inch]);
690 else if (BUFFERP (p->buffer))
692 if (NILP (XBUFFER (p->buffer)->enable_multibyte_characters))
693 setup_raw_text_coding_system (proc_decode_coding_system[inch]);
696 if (!proc_encode_coding_system[outch])
697 proc_encode_coding_system[outch]
698 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
699 setup_coding_system (p->encode_coding_system,
700 proc_encode_coding_system[outch]);
701 if (proc_encode_coding_system[outch]->eol_type == CODING_EOL_UNDECIDED)
702 proc_encode_coding_system[outch]->eol_type = system_eol_type;
705 DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
706 doc: /* Return t if OBJECT is a process. */)
707 (object)
708 Lisp_Object object;
710 return PROCESSP (object) ? Qt : Qnil;
713 DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
714 doc: /* Return the process named NAME, or nil if there is none. */)
715 (name)
716 register Lisp_Object name;
718 if (PROCESSP (name))
719 return name;
720 CHECK_STRING (name);
721 return Fcdr (Fassoc (name, Vprocess_alist));
724 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
725 doc: /* Return the (or a) process associated with BUFFER.
726 BUFFER may be a buffer or the name of one. */)
727 (buffer)
728 register Lisp_Object buffer;
730 register Lisp_Object buf, tail, proc;
732 if (NILP (buffer)) return Qnil;
733 buf = Fget_buffer (buffer);
734 if (NILP (buf)) return Qnil;
736 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
738 proc = Fcdr (Fcar (tail));
739 if (PROCESSP (proc) && EQ (XPROCESS (proc)->buffer, buf))
740 return proc;
742 return Qnil;
745 /* This is how commands for the user decode process arguments. It
746 accepts a process, a process name, a buffer, a buffer name, or nil.
747 Buffers denote the first process in the buffer, and nil denotes the
748 current buffer. */
750 static Lisp_Object
751 get_process (name)
752 register Lisp_Object name;
754 register Lisp_Object proc, obj;
755 if (STRINGP (name))
757 obj = Fget_process (name);
758 if (NILP (obj))
759 obj = Fget_buffer (name);
760 if (NILP (obj))
761 error ("Process %s does not exist", SDATA (name));
763 else if (NILP (name))
764 obj = Fcurrent_buffer ();
765 else
766 obj = name;
768 /* Now obj should be either a buffer object or a process object.
770 if (BUFFERP (obj))
772 proc = Fget_buffer_process (obj);
773 if (NILP (proc))
774 error ("Buffer %s has no process", SDATA (XBUFFER (obj)->name));
776 else
778 CHECK_PROCESS (obj);
779 proc = obj;
781 return proc;
785 #ifdef SIGCHLD
786 /* Fdelete_process promises to immediately forget about the process, but in
787 reality, Emacs needs to remember those processes until they have been
788 treated by sigchld_handler; otherwise this handler would consider the
789 process as being synchronous and say that the synchronous process is
790 dead. */
791 static Lisp_Object deleted_pid_list;
792 #endif
794 DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
795 doc: /* Delete PROCESS: kill it and forget about it immediately.
796 PROCESS may be a process, a buffer, the name of a process or buffer, or
797 nil, indicating the current buffer's process. */)
798 (process)
799 register Lisp_Object process;
801 register struct Lisp_Process *p;
803 process = get_process (process);
804 p = XPROCESS (process);
806 p->raw_status_new = 0;
807 if (NETCONN1_P (p))
809 p->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
810 p->tick = ++process_tick;
811 status_notify (p);
813 else if (p->infd >= 0)
815 #ifdef SIGCHLD
816 Lisp_Object symbol;
817 /* Assignment to EMACS_INT stops GCC whining about limited range
818 of data type. */
819 EMACS_INT pid = p->pid;
821 /* No problem storing the pid here, as it is still in Vprocess_alist. */
822 deleted_pid_list = Fcons (make_fixnum_or_float (pid),
823 /* GC treated elements set to nil. */
824 Fdelq (Qnil, deleted_pid_list));
825 /* If the process has already signaled, remove it from the list. */
826 if (p->raw_status_new)
827 update_status (p);
828 symbol = p->status;
829 if (CONSP (p->status))
830 symbol = XCAR (p->status);
831 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
832 deleted_pid_list
833 = Fdelete (make_fixnum_or_float (pid), deleted_pid_list);
834 else
835 #endif
837 Fkill_process (process, Qnil);
838 /* Do this now, since remove_process will make sigchld_handler do nothing. */
839 p->status
840 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
841 p->tick = ++process_tick;
842 status_notify (p);
845 remove_process (process);
846 return Qnil;
849 DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
850 doc: /* Return the status of PROCESS.
851 The returned value is one of the following symbols:
852 run -- for a process that is running.
853 stop -- for a process stopped but continuable.
854 exit -- for a process that has exited.
855 signal -- for a process that has got a fatal signal.
856 open -- for a network stream connection that is open.
857 listen -- for a network stream server that is listening.
858 closed -- for a network stream connection that is closed.
859 connect -- when waiting for a non-blocking connection to complete.
860 failed -- when a non-blocking connection has failed.
861 nil -- if arg is a process name and no such process exists.
862 PROCESS may be a process, a buffer, the name of a process, or
863 nil, indicating the current buffer's process. */)
864 (process)
865 register Lisp_Object process;
867 register struct Lisp_Process *p;
868 register Lisp_Object status;
870 if (STRINGP (process))
871 process = Fget_process (process);
872 else
873 process = get_process (process);
875 if (NILP (process))
876 return process;
878 p = XPROCESS (process);
879 if (p->raw_status_new)
880 update_status (p);
881 status = p->status;
882 if (CONSP (status))
883 status = XCAR (status);
884 if (NETCONN1_P (p))
886 if (EQ (status, Qexit))
887 status = Qclosed;
888 else if (EQ (p->command, Qt))
889 status = Qstop;
890 else if (EQ (status, Qrun))
891 status = Qopen;
893 return status;
896 DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
897 1, 1, 0,
898 doc: /* Return the exit status of PROCESS or the signal number that killed it.
899 If PROCESS has not yet exited or died, return 0. */)
900 (process)
901 register Lisp_Object process;
903 CHECK_PROCESS (process);
904 if (XPROCESS (process)->raw_status_new)
905 update_status (XPROCESS (process));
906 if (CONSP (XPROCESS (process)->status))
907 return XCAR (XCDR (XPROCESS (process)->status));
908 return make_number (0);
911 DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
912 doc: /* Return the process id of PROCESS.
913 This is the pid of the external process which PROCESS uses or talks to.
914 For a network connection, this value is nil. */)
915 (process)
916 register Lisp_Object process;
918 /* Assignment to EMACS_INT stops GCC whining about limited range of
919 data type. */
920 EMACS_INT pid;
922 CHECK_PROCESS (process);
923 pid = XPROCESS (process)->pid;
924 return (pid ? make_fixnum_or_float (pid) : Qnil);
927 DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
928 doc: /* Return the name of PROCESS, as a string.
929 This is the name of the program invoked in PROCESS,
930 possibly modified to make it unique among process names. */)
931 (process)
932 register Lisp_Object process;
934 CHECK_PROCESS (process);
935 return XPROCESS (process)->name;
938 DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
939 doc: /* Return the command that was executed to start PROCESS.
940 This is a list of strings, the first string being the program executed
941 and the rest of the strings being the arguments given to it.
942 For a non-child channel, this is nil. */)
943 (process)
944 register Lisp_Object process;
946 CHECK_PROCESS (process);
947 return XPROCESS (process)->command;
950 DEFUN ("process-tty-name", Fprocess_tty_name, Sprocess_tty_name, 1, 1, 0,
951 doc: /* Return the name of the terminal PROCESS uses, or nil if none.
952 This is the terminal that the process itself reads and writes on,
953 not the name of the pty that Emacs uses to talk with that terminal. */)
954 (process)
955 register Lisp_Object process;
957 CHECK_PROCESS (process);
958 return XPROCESS (process)->tty_name;
961 DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
962 2, 2, 0,
963 doc: /* Set buffer associated with PROCESS to BUFFER (a buffer, or nil). */)
964 (process, buffer)
965 register Lisp_Object process, buffer;
967 struct Lisp_Process *p;
969 CHECK_PROCESS (process);
970 if (!NILP (buffer))
971 CHECK_BUFFER (buffer);
972 p = XPROCESS (process);
973 p->buffer = buffer;
974 if (NETCONN1_P (p))
975 p->childp = Fplist_put (p->childp, QCbuffer, buffer);
976 setup_process_coding_systems (process);
977 return buffer;
980 DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
981 1, 1, 0,
982 doc: /* Return the buffer PROCESS is associated with.
983 Output from PROCESS is inserted in this buffer unless PROCESS has a filter. */)
984 (process)
985 register Lisp_Object process;
987 CHECK_PROCESS (process);
988 return XPROCESS (process)->buffer;
991 DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
992 1, 1, 0,
993 doc: /* Return the marker for the end of the last output from PROCESS. */)
994 (process)
995 register Lisp_Object process;
997 CHECK_PROCESS (process);
998 return XPROCESS (process)->mark;
1001 DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
1002 2, 2, 0,
1003 doc: /* Give PROCESS the filter function FILTER; nil means no filter.
1004 t means stop accepting output from the process.
1006 When a process has a filter, its buffer is not used for output.
1007 Instead, each time it does output, the entire string of output is
1008 passed to the filter.
1010 The filter gets two arguments: the process and the string of output.
1011 The string argument is normally a multibyte string, except:
1012 - if the process' input coding system is no-conversion or raw-text,
1013 it is a unibyte string (the non-converted input), or else
1014 - if `default-enable-multibyte-characters' is nil, it is a unibyte
1015 string (the result of converting the decoded input multibyte
1016 string to unibyte with `string-make-unibyte'). */)
1017 (process, filter)
1018 register Lisp_Object process, filter;
1020 struct Lisp_Process *p;
1022 CHECK_PROCESS (process);
1023 p = XPROCESS (process);
1025 /* Don't signal an error if the process' input file descriptor
1026 is closed. This could make debugging Lisp more difficult,
1027 for example when doing something like
1029 (setq process (start-process ...))
1030 (debug)
1031 (set-process-filter process ...) */
1033 if (p->infd >= 0)
1035 if (EQ (filter, Qt) && !EQ (p->status, Qlisten))
1037 FD_CLR (p->infd, &input_wait_mask);
1038 FD_CLR (p->infd, &non_keyboard_wait_mask);
1040 else if (EQ (p->filter, Qt)
1041 && !EQ (p->command, Qt)) /* Network process not stopped. */
1043 FD_SET (p->infd, &input_wait_mask);
1044 FD_SET (p->infd, &non_keyboard_wait_mask);
1048 p->filter = filter;
1049 if (NETCONN1_P (p))
1050 p->childp = Fplist_put (p->childp, QCfilter, filter);
1051 setup_process_coding_systems (process);
1052 return filter;
1055 DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
1056 1, 1, 0,
1057 doc: /* Returns the filter function of PROCESS; nil if none.
1058 See `set-process-filter' for more info on filter functions. */)
1059 (process)
1060 register Lisp_Object process;
1062 CHECK_PROCESS (process);
1063 return XPROCESS (process)->filter;
1066 DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
1067 2, 2, 0,
1068 doc: /* Give PROCESS the sentinel SENTINEL; nil for none.
1069 The sentinel is called as a function when the process changes state.
1070 It gets two arguments: the process, and a string describing the change. */)
1071 (process, sentinel)
1072 register Lisp_Object process, sentinel;
1074 struct Lisp_Process *p;
1076 CHECK_PROCESS (process);
1077 p = XPROCESS (process);
1079 p->sentinel = sentinel;
1080 if (NETCONN1_P (p))
1081 p->childp = Fplist_put (p->childp, QCsentinel, sentinel);
1082 return sentinel;
1085 DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
1086 1, 1, 0,
1087 doc: /* Return the sentinel of PROCESS; nil if none.
1088 See `set-process-sentinel' for more info on sentinels. */)
1089 (process)
1090 register Lisp_Object process;
1092 CHECK_PROCESS (process);
1093 return XPROCESS (process)->sentinel;
1096 DEFUN ("set-process-window-size", Fset_process_window_size,
1097 Sset_process_window_size, 3, 3, 0,
1098 doc: /* Tell PROCESS that it has logical window size HEIGHT and WIDTH. */)
1099 (process, height, width)
1100 register Lisp_Object process, height, width;
1102 CHECK_PROCESS (process);
1103 CHECK_NATNUM (height);
1104 CHECK_NATNUM (width);
1106 if (XPROCESS (process)->infd < 0
1107 || set_window_size (XPROCESS (process)->infd,
1108 XINT (height), XINT (width)) <= 0)
1109 return Qnil;
1110 else
1111 return Qt;
1114 DEFUN ("set-process-inherit-coding-system-flag",
1115 Fset_process_inherit_coding_system_flag,
1116 Sset_process_inherit_coding_system_flag, 2, 2, 0,
1117 doc: /* Determine whether buffer of PROCESS will inherit coding-system.
1118 If the second argument FLAG is non-nil, then the variable
1119 `buffer-file-coding-system' of the buffer associated with PROCESS
1120 will be bound to the value of the coding system used to decode
1121 the process output.
1123 This is useful when the coding system specified for the process buffer
1124 leaves either the character code conversion or the end-of-line conversion
1125 unspecified, or if the coding system used to decode the process output
1126 is more appropriate for saving the process buffer.
1128 Binding the variable `inherit-process-coding-system' to non-nil before
1129 starting the process is an alternative way of setting the inherit flag
1130 for the process which will run. */)
1131 (process, flag)
1132 register Lisp_Object process, flag;
1134 CHECK_PROCESS (process);
1135 XPROCESS (process)->inherit_coding_system_flag = !NILP (flag);
1136 return flag;
1139 DEFUN ("process-inherit-coding-system-flag",
1140 Fprocess_inherit_coding_system_flag, Sprocess_inherit_coding_system_flag,
1141 1, 1, 0,
1142 doc: /* Return the value of inherit-coding-system flag for PROCESS.
1143 If this flag is t, `buffer-file-coding-system' of the buffer
1144 associated with PROCESS will inherit the coding system used to decode
1145 the process output. */)
1146 (process)
1147 register Lisp_Object process;
1149 CHECK_PROCESS (process);
1150 return XPROCESS (process)->inherit_coding_system_flag ? Qt : Qnil;
1153 DEFUN ("set-process-query-on-exit-flag",
1154 Fset_process_query_on_exit_flag, Sset_process_query_on_exit_flag,
1155 2, 2, 0,
1156 doc: /* Specify if query is needed for PROCESS when Emacs is exited.
1157 If the second argument FLAG is non-nil, Emacs will query the user before
1158 exiting if PROCESS is running. */)
1159 (process, flag)
1160 register Lisp_Object process, flag;
1162 CHECK_PROCESS (process);
1163 XPROCESS (process)->kill_without_query = NILP (flag);
1164 return flag;
1167 DEFUN ("process-query-on-exit-flag",
1168 Fprocess_query_on_exit_flag, Sprocess_query_on_exit_flag,
1169 1, 1, 0,
1170 doc: /* Return the current value of query-on-exit flag for PROCESS. */)
1171 (process)
1172 register Lisp_Object process;
1174 CHECK_PROCESS (process);
1175 return (XPROCESS (process)->kill_without_query ? Qnil : Qt);
1178 #ifdef DATAGRAM_SOCKETS
1179 Lisp_Object Fprocess_datagram_address ();
1180 #endif
1182 DEFUN ("process-contact", Fprocess_contact, Sprocess_contact,
1183 1, 2, 0,
1184 doc: /* Return the contact info of PROCESS; t for a real child.
1185 For a net connection, the value depends on the optional KEY arg.
1186 If KEY is nil, value is a cons cell of the form (HOST SERVICE),
1187 if KEY is t, the complete contact information for the connection is
1188 returned, else the specific value for the keyword KEY is returned.
1189 See `make-network-process' for a list of keywords. */)
1190 (process, key)
1191 register Lisp_Object process, key;
1193 Lisp_Object contact;
1195 CHECK_PROCESS (process);
1196 contact = XPROCESS (process)->childp;
1198 #ifdef DATAGRAM_SOCKETS
1199 if (DATAGRAM_CONN_P (process)
1200 && (EQ (key, Qt) || EQ (key, QCremote)))
1201 contact = Fplist_put (contact, QCremote,
1202 Fprocess_datagram_address (process));
1203 #endif
1205 if (!NETCONN_P (process) || EQ (key, Qt))
1206 return contact;
1207 if (NILP (key))
1208 return Fcons (Fplist_get (contact, QChost),
1209 Fcons (Fplist_get (contact, QCservice), Qnil));
1210 return Fplist_get (contact, key);
1213 DEFUN ("process-plist", Fprocess_plist, Sprocess_plist,
1214 1, 1, 0,
1215 doc: /* Return the plist of PROCESS. */)
1216 (process)
1217 register Lisp_Object process;
1219 CHECK_PROCESS (process);
1220 return XPROCESS (process)->plist;
1223 DEFUN ("set-process-plist", Fset_process_plist, Sset_process_plist,
1224 2, 2, 0,
1225 doc: /* Replace the plist of PROCESS with PLIST. Returns PLIST. */)
1226 (process, plist)
1227 register Lisp_Object process, plist;
1229 CHECK_PROCESS (process);
1230 CHECK_LIST (plist);
1232 XPROCESS (process)->plist = plist;
1233 return plist;
1236 #if 0 /* Turned off because we don't currently record this info
1237 in the process. Perhaps add it. */
1238 DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 1, 1, 0,
1239 doc: /* Return the connection type of PROCESS.
1240 The value is nil for a pipe, t or `pty' for a pty, or `stream' for
1241 a socket connection. */)
1242 (process)
1243 Lisp_Object process;
1245 return XPROCESS (process)->type;
1247 #endif
1249 #ifdef HAVE_SOCKETS
1250 DEFUN ("format-network-address", Fformat_network_address, Sformat_network_address,
1251 1, 2, 0,
1252 doc: /* Convert network ADDRESS from internal format to a string.
1253 A 4 or 5 element vector represents an IPv4 address (with port number).
1254 An 8 or 9 element vector represents an IPv6 address (with port number).
1255 If optional second argument OMIT-PORT is non-nil, don't include a port
1256 number in the string, even when present in ADDRESS.
1257 Returns nil if format of ADDRESS is invalid. */)
1258 (address, omit_port)
1259 Lisp_Object address, omit_port;
1261 if (NILP (address))
1262 return Qnil;
1264 if (STRINGP (address)) /* AF_LOCAL */
1265 return address;
1267 if (VECTORP (address)) /* AF_INET or AF_INET6 */
1269 register struct Lisp_Vector *p = XVECTOR (address);
1270 Lisp_Object args[10];
1271 int nargs, i;
1273 if (p->size == 4 || (p->size == 5 && !NILP (omit_port)))
1275 args[0] = build_string ("%d.%d.%d.%d");
1276 nargs = 4;
1278 else if (p->size == 5)
1280 args[0] = build_string ("%d.%d.%d.%d:%d");
1281 nargs = 5;
1283 else if (p->size == 8 || (p->size == 9 && !NILP (omit_port)))
1285 args[0] = build_string ("%x:%x:%x:%x:%x:%x:%x:%x");
1286 nargs = 8;
1288 else if (p->size == 9)
1290 args[0] = build_string ("[%x:%x:%x:%x:%x:%x:%x:%x]:%d");
1291 nargs = 9;
1293 else
1294 return Qnil;
1296 for (i = 0; i < nargs; i++)
1298 EMACS_INT element = XINT (p->contents[i]);
1300 if (element < 0 || element > 65535)
1301 return Qnil;
1303 if (nargs <= 5 /* IPv4 */
1304 && i < 4 /* host, not port */
1305 && element > 255)
1306 return Qnil;
1308 args[i+1] = p->contents[i];
1311 return Fformat (nargs+1, args);
1314 if (CONSP (address))
1316 Lisp_Object args[2];
1317 args[0] = build_string ("<Family %d>");
1318 args[1] = Fcar (address);
1319 return Fformat (2, args);
1322 return Qnil;
1324 #endif
1326 static Lisp_Object
1327 list_processes_1 (query_only)
1328 Lisp_Object query_only;
1330 register Lisp_Object tail, tem;
1331 Lisp_Object proc, minspace, tem1;
1332 register struct Lisp_Process *p;
1333 char tembuf[300];
1334 int w_proc, w_buffer, w_tty;
1335 int exited = 0;
1336 Lisp_Object i_status, i_buffer, i_tty, i_command;
1338 w_proc = 4; /* Proc */
1339 w_buffer = 6; /* Buffer */
1340 w_tty = 0; /* Omit if no ttys */
1342 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
1344 int i;
1346 proc = Fcdr (Fcar (tail));
1347 p = XPROCESS (proc);
1348 if (NILP (p->childp))
1349 continue;
1350 if (!NILP (query_only) && p->kill_without_query)
1351 continue;
1352 if (STRINGP (p->name)
1353 && ( i = SCHARS (p->name), (i > w_proc)))
1354 w_proc = i;
1355 if (!NILP (p->buffer))
1357 if (NILP (XBUFFER (p->buffer)->name) && w_buffer < 8)
1358 w_buffer = 8; /* (Killed) */
1359 else if ((i = SCHARS (XBUFFER (p->buffer)->name), (i > w_buffer)))
1360 w_buffer = i;
1362 if (STRINGP (p->tty_name)
1363 && (i = SCHARS (p->tty_name), (i > w_tty)))
1364 w_tty = i;
1367 XSETFASTINT (i_status, w_proc + 1);
1368 XSETFASTINT (i_buffer, XFASTINT (i_status) + 9);
1369 if (w_tty)
1371 XSETFASTINT (i_tty, XFASTINT (i_buffer) + w_buffer + 1);
1372 XSETFASTINT (i_command, XFASTINT (i_buffer) + w_tty + 1);
1373 } else {
1374 i_tty = Qnil;
1375 XSETFASTINT (i_command, XFASTINT (i_buffer) + w_buffer + 1);
1378 XSETFASTINT (minspace, 1);
1380 set_buffer_internal (XBUFFER (Vstandard_output));
1381 current_buffer->undo_list = Qt;
1383 current_buffer->truncate_lines = Qt;
1385 write_string ("Proc", -1);
1386 Findent_to (i_status, minspace); write_string ("Status", -1);
1387 Findent_to (i_buffer, minspace); write_string ("Buffer", -1);
1388 if (!NILP (i_tty))
1390 Findent_to (i_tty, minspace); write_string ("Tty", -1);
1392 Findent_to (i_command, minspace); write_string ("Command", -1);
1393 write_string ("\n", -1);
1395 write_string ("----", -1);
1396 Findent_to (i_status, minspace); write_string ("------", -1);
1397 Findent_to (i_buffer, minspace); write_string ("------", -1);
1398 if (!NILP (i_tty))
1400 Findent_to (i_tty, minspace); write_string ("---", -1);
1402 Findent_to (i_command, minspace); write_string ("-------", -1);
1403 write_string ("\n", -1);
1405 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
1407 Lisp_Object symbol;
1409 proc = Fcdr (Fcar (tail));
1410 p = XPROCESS (proc);
1411 if (NILP (p->childp))
1412 continue;
1413 if (!NILP (query_only) && p->kill_without_query)
1414 continue;
1416 Finsert (1, &p->name);
1417 Findent_to (i_status, minspace);
1419 if (p->raw_status_new)
1420 update_status (p);
1421 symbol = p->status;
1422 if (CONSP (p->status))
1423 symbol = XCAR (p->status);
1425 if (EQ (symbol, Qsignal))
1427 Lisp_Object tem;
1428 tem = Fcar (Fcdr (p->status));
1429 #ifdef VMS
1430 if (XINT (tem) < NSIG)
1431 write_string (sys_errlist [XINT (tem)], -1);
1432 else
1433 #endif
1434 Fprinc (symbol, Qnil);
1436 else if (NETCONN1_P (p))
1438 if (EQ (symbol, Qexit))
1439 write_string ("closed", -1);
1440 else if (EQ (p->command, Qt))
1441 write_string ("stopped", -1);
1442 else if (EQ (symbol, Qrun))
1443 write_string ("open", -1);
1444 else
1445 Fprinc (symbol, Qnil);
1447 else
1448 Fprinc (symbol, Qnil);
1450 if (EQ (symbol, Qexit))
1452 Lisp_Object tem;
1453 tem = Fcar (Fcdr (p->status));
1454 if (XFASTINT (tem))
1456 sprintf (tembuf, " %d", (int) XFASTINT (tem));
1457 write_string (tembuf, -1);
1461 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit) || EQ (symbol, Qclosed))
1462 exited++;
1464 Findent_to (i_buffer, minspace);
1465 if (NILP (p->buffer))
1466 insert_string ("(none)");
1467 else if (NILP (XBUFFER (p->buffer)->name))
1468 insert_string ("(Killed)");
1469 else
1470 Finsert (1, &XBUFFER (p->buffer)->name);
1472 if (!NILP (i_tty))
1474 Findent_to (i_tty, minspace);
1475 if (STRINGP (p->tty_name))
1476 Finsert (1, &p->tty_name);
1479 Findent_to (i_command, minspace);
1481 if (EQ (p->status, Qlisten))
1483 Lisp_Object port = Fplist_get (p->childp, QCservice);
1484 if (INTEGERP (port))
1485 port = Fnumber_to_string (port);
1486 if (NILP (port))
1487 port = Fformat_network_address (Fplist_get (p->childp, QClocal), Qnil);
1488 sprintf (tembuf, "(network %s server on %s)\n",
1489 (DATAGRAM_CHAN_P (p->infd) ? "datagram" : "stream"),
1490 (STRINGP (port) ? (char *)SDATA (port) : "?"));
1491 insert_string (tembuf);
1493 else if (NETCONN1_P (p))
1495 /* For a local socket, there is no host name,
1496 so display service instead. */
1497 Lisp_Object host = Fplist_get (p->childp, QChost);
1498 if (!STRINGP (host))
1500 host = Fplist_get (p->childp, QCservice);
1501 if (INTEGERP (host))
1502 host = Fnumber_to_string (host);
1504 if (NILP (host))
1505 host = Fformat_network_address (Fplist_get (p->childp, QCremote), Qnil);
1506 sprintf (tembuf, "(network %s connection to %s)\n",
1507 (DATAGRAM_CHAN_P (p->infd) ? "datagram" : "stream"),
1508 (STRINGP (host) ? (char *)SDATA (host) : "?"));
1509 insert_string (tembuf);
1511 else
1513 tem = p->command;
1514 while (1)
1516 tem1 = Fcar (tem);
1517 Finsert (1, &tem1);
1518 tem = Fcdr (tem);
1519 if (NILP (tem))
1520 break;
1521 insert_string (" ");
1523 insert_string ("\n");
1526 if (exited)
1527 status_notify (NULL);
1528 return Qnil;
1531 DEFUN ("list-processes", Flist_processes, Slist_processes, 0, 1, "P",
1532 doc: /* Display a list of all processes.
1533 If optional argument QUERY-ONLY is non-nil, only processes with
1534 the query-on-exit flag set will be listed.
1535 Any process listed as exited or signaled is actually eliminated
1536 after the listing is made. */)
1537 (query_only)
1538 Lisp_Object query_only;
1540 internal_with_output_to_temp_buffer ("*Process List*",
1541 list_processes_1, query_only);
1542 return Qnil;
1545 DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
1546 doc: /* Return a list of all processes. */)
1549 return Fmapcar (Qcdr, Vprocess_alist);
1552 /* Starting asynchronous inferior processes. */
1554 static Lisp_Object start_process_unwind ();
1556 DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
1557 doc: /* Start a program in a subprocess. Return the process object for it.
1558 NAME is name for process. It is modified if necessary to make it unique.
1559 BUFFER is the buffer (or buffer name) to associate with the process.
1561 Process output (both standard output and standard error streams) goes
1562 at end of BUFFER, unless you specify an output stream or filter
1563 function to handle the output. BUFFER may also be nil, meaning that
1564 this process is not associated with any buffer.
1566 PROGRAM is the program file name. It is searched for in PATH.
1567 Remaining arguments are strings to give program as arguments.
1569 If you want to separate standard output from standard error, invoke
1570 the command through a shell and redirect one of them using the shell
1571 syntax.
1573 usage: (start-process NAME BUFFER PROGRAM &rest PROGRAM-ARGS) */)
1574 (nargs, args)
1575 int nargs;
1576 register Lisp_Object *args;
1578 Lisp_Object buffer, name, program, proc, current_dir, tem;
1579 #ifdef VMS
1580 register unsigned char *new_argv;
1581 int len;
1582 #else
1583 register unsigned char **new_argv;
1584 #endif
1585 register int i;
1586 int count = SPECPDL_INDEX ();
1588 buffer = args[1];
1589 if (!NILP (buffer))
1590 buffer = Fget_buffer_create (buffer);
1592 /* Make sure that the child will be able to chdir to the current
1593 buffer's current directory, or its unhandled equivalent. We
1594 can't just have the child check for an error when it does the
1595 chdir, since it's in a vfork.
1597 We have to GCPRO around this because Fexpand_file_name and
1598 Funhandled_file_name_directory might call a file name handling
1599 function. The argument list is protected by the caller, so all
1600 we really have to worry about is buffer. */
1602 struct gcpro gcpro1, gcpro2;
1604 current_dir = current_buffer->directory;
1606 GCPRO2 (buffer, current_dir);
1608 current_dir
1609 = expand_and_dir_to_file (Funhandled_file_name_directory (current_dir),
1610 Qnil);
1611 if (NILP (Ffile_accessible_directory_p (current_dir)))
1612 report_file_error ("Setting current directory",
1613 Fcons (current_buffer->directory, Qnil));
1615 UNGCPRO;
1618 name = args[0];
1619 CHECK_STRING (name);
1621 program = args[2];
1623 CHECK_STRING (program);
1625 proc = make_process (name);
1626 /* If an error occurs and we can't start the process, we want to
1627 remove it from the process list. This means that each error
1628 check in create_process doesn't need to call remove_process
1629 itself; it's all taken care of here. */
1630 record_unwind_protect (start_process_unwind, proc);
1632 XPROCESS (proc)->childp = Qt;
1633 XPROCESS (proc)->plist = Qnil;
1634 XPROCESS (proc)->buffer = buffer;
1635 XPROCESS (proc)->sentinel = Qnil;
1636 XPROCESS (proc)->filter = Qnil;
1637 XPROCESS (proc)->filter_multibyte
1638 = !NILP (buffer_defaults.enable_multibyte_characters);
1639 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1641 #ifdef ADAPTIVE_READ_BUFFERING
1642 XPROCESS (proc)->adaptive_read_buffering
1643 = (NILP (Vprocess_adaptive_read_buffering) ? 0
1644 : EQ (Vprocess_adaptive_read_buffering, Qt) ? 1 : 2);
1645 #endif
1647 /* Make the process marker point into the process buffer (if any). */
1648 if (BUFFERP (buffer))
1649 set_marker_both (XPROCESS (proc)->mark, buffer,
1650 BUF_ZV (XBUFFER (buffer)),
1651 BUF_ZV_BYTE (XBUFFER (buffer)));
1654 /* Decide coding systems for communicating with the process. Here
1655 we don't setup the structure coding_system nor pay attention to
1656 unibyte mode. They are done in create_process. */
1658 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
1659 Lisp_Object coding_systems = Qt;
1660 Lisp_Object val, *args2;
1661 struct gcpro gcpro1, gcpro2;
1663 val = Vcoding_system_for_read;
1664 if (NILP (val))
1666 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof *args2);
1667 args2[0] = Qstart_process;
1668 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1669 GCPRO2 (proc, current_dir);
1670 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1671 UNGCPRO;
1672 if (CONSP (coding_systems))
1673 val = XCAR (coding_systems);
1674 else if (CONSP (Vdefault_process_coding_system))
1675 val = XCAR (Vdefault_process_coding_system);
1677 XPROCESS (proc)->decode_coding_system = val;
1679 val = Vcoding_system_for_write;
1680 if (NILP (val))
1682 if (EQ (coding_systems, Qt))
1684 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof args2);
1685 args2[0] = Qstart_process;
1686 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1687 GCPRO2 (proc, current_dir);
1688 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1689 UNGCPRO;
1691 if (CONSP (coding_systems))
1692 val = XCDR (coding_systems);
1693 else if (CONSP (Vdefault_process_coding_system))
1694 val = XCDR (Vdefault_process_coding_system);
1696 XPROCESS (proc)->encode_coding_system = val;
1699 #ifdef VMS
1700 /* Make a one member argv with all args concatenated
1701 together separated by a blank. */
1702 len = SBYTES (program) + 2;
1703 for (i = 3; i < nargs; i++)
1705 tem = args[i];
1706 CHECK_STRING (tem);
1707 len += SBYTES (tem) + 1; /* count the blank */
1709 new_argv = (unsigned char *) alloca (len);
1710 strcpy (new_argv, SDATA (program));
1711 for (i = 3; i < nargs; i++)
1713 tem = args[i];
1714 CHECK_STRING (tem);
1715 strcat (new_argv, " ");
1716 strcat (new_argv, SDATA (tem));
1718 /* Need to add code here to check for program existence on VMS */
1720 #else /* not VMS */
1721 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1723 /* If program file name is not absolute, search our path for it.
1724 Put the name we will really use in TEM. */
1725 if (!IS_DIRECTORY_SEP (SREF (program, 0))
1726 && !(SCHARS (program) > 1
1727 && IS_DEVICE_SEP (SREF (program, 1))))
1729 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1731 tem = Qnil;
1732 GCPRO4 (name, program, buffer, current_dir);
1733 openp (Vexec_path, program, Vexec_suffixes, &tem, make_number (X_OK));
1734 UNGCPRO;
1735 if (NILP (tem))
1736 report_file_error ("Searching for program", Fcons (program, Qnil));
1737 tem = Fexpand_file_name (tem, Qnil);
1739 else
1741 if (!NILP (Ffile_directory_p (program)))
1742 error ("Specified program for new process is a directory");
1743 tem = program;
1746 /* If program file name starts with /: for quoting a magic name,
1747 discard that. */
1748 if (SBYTES (tem) > 2 && SREF (tem, 0) == '/'
1749 && SREF (tem, 1) == ':')
1750 tem = Fsubstring (tem, make_number (2), Qnil);
1752 /* Encode the file name and put it in NEW_ARGV.
1753 That's where the child will use it to execute the program. */
1754 tem = ENCODE_FILE (tem);
1755 new_argv[0] = SDATA (tem);
1757 /* Here we encode arguments by the coding system used for sending
1758 data to the process. We don't support using different coding
1759 systems for encoding arguments and for encoding data sent to the
1760 process. */
1762 for (i = 3; i < nargs; i++)
1764 tem = args[i];
1765 CHECK_STRING (tem);
1766 if (STRING_MULTIBYTE (tem))
1767 tem = (code_convert_string_norecord
1768 (tem, XPROCESS (proc)->encode_coding_system, 1));
1769 new_argv[i - 2] = SDATA (tem);
1771 new_argv[i - 2] = 0;
1772 #endif /* not VMS */
1774 XPROCESS (proc)->decoding_buf = make_uninit_string (0);
1775 XPROCESS (proc)->decoding_carryover = 0;
1776 XPROCESS (proc)->encoding_buf = make_uninit_string (0);
1778 XPROCESS (proc)->inherit_coding_system_flag
1779 = !(NILP (buffer) || !inherit_process_coding_system);
1781 create_process (proc, (char **) new_argv, current_dir);
1783 return unbind_to (count, proc);
1786 /* This function is the unwind_protect form for Fstart_process. If
1787 PROC doesn't have its pid set, then we know someone has signaled
1788 an error and the process wasn't started successfully, so we should
1789 remove it from the process list. */
1790 static Lisp_Object
1791 start_process_unwind (proc)
1792 Lisp_Object proc;
1794 if (!PROCESSP (proc))
1795 abort ();
1797 /* Was PROC started successfully? */
1798 if (XPROCESS (proc)->pid <= 0)
1799 remove_process (proc);
1801 return Qnil;
1804 static void
1805 create_process_1 (timer)
1806 struct atimer *timer;
1808 /* Nothing to do. */
1812 #if 0 /* This doesn't work; see the note before sigchld_handler. */
1813 #ifdef USG
1814 #ifdef SIGCHLD
1815 /* Mimic blocking of signals on system V, which doesn't really have it. */
1817 /* Nonzero means we got a SIGCHLD when it was supposed to be blocked. */
1818 int sigchld_deferred;
1820 SIGTYPE
1821 create_process_sigchld ()
1823 signal (SIGCHLD, create_process_sigchld);
1825 sigchld_deferred = 1;
1827 #endif
1828 #endif
1829 #endif
1831 #ifndef VMS /* VMS version of this function is in vmsproc.c. */
1832 void
1833 create_process (process, new_argv, current_dir)
1834 Lisp_Object process;
1835 char **new_argv;
1836 Lisp_Object current_dir;
1838 int inchannel, outchannel;
1839 pid_t pid;
1840 int sv[2];
1841 #ifdef POSIX_SIGNALS
1842 sigset_t procmask;
1843 sigset_t blocked;
1844 struct sigaction sigint_action;
1845 struct sigaction sigquit_action;
1846 #ifdef AIX
1847 struct sigaction sighup_action;
1848 #endif
1849 #else /* !POSIX_SIGNALS */
1850 #if 0
1851 #ifdef SIGCHLD
1852 SIGTYPE (*sigchld)();
1853 #endif
1854 #endif /* 0 */
1855 #endif /* !POSIX_SIGNALS */
1856 /* Use volatile to protect variables from being clobbered by longjmp. */
1857 volatile int forkin, forkout;
1858 volatile int pty_flag = 0;
1859 #ifndef USE_CRT_DLL
1860 extern char **environ;
1861 #endif
1863 inchannel = outchannel = -1;
1865 #ifdef HAVE_PTYS
1866 if (!NILP (Vprocess_connection_type))
1867 outchannel = inchannel = allocate_pty ();
1869 if (inchannel >= 0)
1871 #if ! defined (USG) || defined (USG_SUBTTY_WORKS)
1872 /* On most USG systems it does not work to open the pty's tty here,
1873 then close it and reopen it in the child. */
1874 #ifdef O_NOCTTY
1875 /* Don't let this terminal become our controlling terminal
1876 (in case we don't have one). */
1877 forkout = forkin = emacs_open (pty_name, O_RDWR | O_NOCTTY, 0);
1878 #else
1879 forkout = forkin = emacs_open (pty_name, O_RDWR, 0);
1880 #endif
1881 if (forkin < 0)
1882 report_file_error ("Opening pty", Qnil);
1883 #if defined (RTU) || defined (UNIPLUS) || defined (DONT_REOPEN_PTY)
1884 /* In the case that vfork is defined as fork, the parent process
1885 (Emacs) may send some data before the child process completes
1886 tty options setup. So we setup tty before forking. */
1887 child_setup_tty (forkout);
1888 #endif /* RTU or UNIPLUS or DONT_REOPEN_PTY */
1889 #else
1890 forkin = forkout = -1;
1891 #endif /* not USG, or USG_SUBTTY_WORKS */
1892 pty_flag = 1;
1894 else
1895 #endif /* HAVE_PTYS */
1896 #ifdef SKTPAIR
1898 if (socketpair (AF_UNIX, SOCK_STREAM, 0, sv) < 0)
1899 report_file_error ("Opening socketpair", Qnil);
1900 outchannel = inchannel = sv[0];
1901 forkout = forkin = sv[1];
1903 #else /* not SKTPAIR */
1905 int tem;
1906 tem = pipe (sv);
1907 if (tem < 0)
1908 report_file_error ("Creating pipe", Qnil);
1909 inchannel = sv[0];
1910 forkout = sv[1];
1911 tem = pipe (sv);
1912 if (tem < 0)
1914 emacs_close (inchannel);
1915 emacs_close (forkout);
1916 report_file_error ("Creating pipe", Qnil);
1918 outchannel = sv[1];
1919 forkin = sv[0];
1921 #endif /* not SKTPAIR */
1923 #if 0
1924 /* Replaced by close_process_descs */
1925 set_exclusive_use (inchannel);
1926 set_exclusive_use (outchannel);
1927 #endif
1929 /* Stride people say it's a mystery why this is needed
1930 as well as the O_NDELAY, but that it fails without this. */
1931 #if defined (STRIDE) || (defined (pfa) && defined (HAVE_PTYS))
1933 int one = 1;
1934 ioctl (inchannel, FIONBIO, &one);
1936 #endif
1938 #ifdef O_NONBLOCK
1939 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1940 fcntl (outchannel, F_SETFL, O_NONBLOCK);
1941 #else
1942 #ifdef O_NDELAY
1943 fcntl (inchannel, F_SETFL, O_NDELAY);
1944 fcntl (outchannel, F_SETFL, O_NDELAY);
1945 #endif
1946 #endif
1948 /* Record this as an active process, with its channels.
1949 As a result, child_setup will close Emacs's side of the pipes. */
1950 chan_process[inchannel] = process;
1951 XPROCESS (process)->infd = inchannel;
1952 XPROCESS (process)->outfd = outchannel;
1954 /* Previously we recorded the tty descriptor used in the subprocess.
1955 It was only used for getting the foreground tty process, so now
1956 we just reopen the device (see emacs_get_tty_pgrp) as this is
1957 more portable (see USG_SUBTTY_WORKS above). */
1959 XPROCESS (process)->pty_flag = pty_flag;
1960 XPROCESS (process)->status = Qrun;
1961 setup_process_coding_systems (process);
1963 /* Delay interrupts until we have a chance to store
1964 the new fork's pid in its process structure */
1965 #ifdef POSIX_SIGNALS
1966 sigemptyset (&blocked);
1967 #ifdef SIGCHLD
1968 sigaddset (&blocked, SIGCHLD);
1969 #endif
1970 #ifdef HAVE_WORKING_VFORK
1971 /* On many hosts (e.g. Solaris 2.4), if a vforked child calls `signal',
1972 this sets the parent's signal handlers as well as the child's.
1973 So delay all interrupts whose handlers the child might munge,
1974 and record the current handlers so they can be restored later. */
1975 sigaddset (&blocked, SIGINT ); sigaction (SIGINT , 0, &sigint_action );
1976 sigaddset (&blocked, SIGQUIT); sigaction (SIGQUIT, 0, &sigquit_action);
1977 #ifdef AIX
1978 sigaddset (&blocked, SIGHUP ); sigaction (SIGHUP , 0, &sighup_action );
1979 #endif
1980 #endif /* HAVE_WORKING_VFORK */
1981 sigprocmask (SIG_BLOCK, &blocked, &procmask);
1982 #else /* !POSIX_SIGNALS */
1983 #ifdef SIGCHLD
1984 #ifdef BSD4_1
1985 sighold (SIGCHLD);
1986 #else /* not BSD4_1 */
1987 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
1988 sigsetmask (sigmask (SIGCHLD));
1989 #else /* ordinary USG */
1990 #if 0
1991 sigchld_deferred = 0;
1992 sigchld = signal (SIGCHLD, create_process_sigchld);
1993 #endif
1994 #endif /* ordinary USG */
1995 #endif /* not BSD4_1 */
1996 #endif /* SIGCHLD */
1997 #endif /* !POSIX_SIGNALS */
1999 FD_SET (inchannel, &input_wait_mask);
2000 FD_SET (inchannel, &non_keyboard_wait_mask);
2001 if (inchannel > max_process_desc)
2002 max_process_desc = inchannel;
2004 /* Until we store the proper pid, enable sigchld_handler
2005 to recognize an unknown pid as standing for this process.
2006 It is very important not to let this `marker' value stay
2007 in the table after this function has returned; if it does
2008 it might cause call-process to hang and subsequent asynchronous
2009 processes to get their return values scrambled. */
2010 XPROCESS (process)->pid = -1;
2012 BLOCK_INPUT;
2015 /* child_setup must clobber environ on systems with true vfork.
2016 Protect it from permanent change. */
2017 char **save_environ = environ;
2019 current_dir = ENCODE_FILE (current_dir);
2021 #ifndef WINDOWSNT
2022 pid = vfork ();
2023 if (pid == 0)
2024 #endif /* not WINDOWSNT */
2026 int xforkin = forkin;
2027 int xforkout = forkout;
2029 #if 0 /* This was probably a mistake--it duplicates code later on,
2030 but fails to handle all the cases. */
2031 /* Make sure SIGCHLD is not blocked in the child. */
2032 sigsetmask (SIGEMPTYMASK);
2033 #endif
2035 /* Make the pty be the controlling terminal of the process. */
2036 #ifdef HAVE_PTYS
2037 /* First, disconnect its current controlling terminal. */
2038 #ifdef HAVE_SETSID
2039 /* We tried doing setsid only if pty_flag, but it caused
2040 process_set_signal to fail on SGI when using a pipe. */
2041 setsid ();
2042 /* Make the pty's terminal the controlling terminal. */
2043 if (pty_flag)
2045 #ifdef TIOCSCTTY
2046 /* We ignore the return value
2047 because faith@cs.unc.edu says that is necessary on Linux. */
2048 ioctl (xforkin, TIOCSCTTY, 0);
2049 #endif
2051 #else /* not HAVE_SETSID */
2052 #ifdef USG
2053 /* It's very important to call setpgrp here and no time
2054 afterwards. Otherwise, we lose our controlling tty which
2055 is set when we open the pty. */
2056 setpgrp ();
2057 #endif /* USG */
2058 #endif /* not HAVE_SETSID */
2059 #if defined (HAVE_TERMIOS) && defined (LDISC1)
2060 if (pty_flag && xforkin >= 0)
2062 struct termios t;
2063 tcgetattr (xforkin, &t);
2064 t.c_lflag = LDISC1;
2065 if (tcsetattr (xforkin, TCSANOW, &t) < 0)
2066 emacs_write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
2068 #else
2069 #if defined (NTTYDISC) && defined (TIOCSETD)
2070 if (pty_flag && xforkin >= 0)
2072 /* Use new line discipline. */
2073 int ldisc = NTTYDISC;
2074 ioctl (xforkin, TIOCSETD, &ldisc);
2076 #endif
2077 #endif
2078 #ifdef TIOCNOTTY
2079 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
2080 can do TIOCSPGRP only to the process's controlling tty. */
2081 if (pty_flag)
2083 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
2084 I can't test it since I don't have 4.3. */
2085 int j = emacs_open ("/dev/tty", O_RDWR, 0);
2086 ioctl (j, TIOCNOTTY, 0);
2087 emacs_close (j);
2088 #ifndef USG
2089 /* In order to get a controlling terminal on some versions
2090 of BSD, it is necessary to put the process in pgrp 0
2091 before it opens the terminal. */
2092 #ifdef HAVE_SETPGID
2093 setpgid (0, 0);
2094 #else
2095 setpgrp (0, 0);
2096 #endif
2097 #endif
2099 #endif /* TIOCNOTTY */
2101 #if !defined (RTU) && !defined (UNIPLUS) && !defined (DONT_REOPEN_PTY)
2102 /*** There is a suggestion that this ought to be a
2103 conditional on TIOCSPGRP,
2104 or !(defined (HAVE_SETSID) && defined (TIOCSCTTY)).
2105 Trying the latter gave the wrong results on Debian GNU/Linux 1.1;
2106 that system does seem to need this code, even though
2107 both HAVE_SETSID and TIOCSCTTY are defined. */
2108 /* Now close the pty (if we had it open) and reopen it.
2109 This makes the pty the controlling terminal of the subprocess. */
2110 if (pty_flag)
2112 #ifdef SET_CHILD_PTY_PGRP
2113 int pgrp = getpid ();
2114 #endif
2116 /* I wonder if emacs_close (emacs_open (pty_name, ...))
2117 would work? */
2118 if (xforkin >= 0)
2119 emacs_close (xforkin);
2120 xforkout = xforkin = emacs_open (pty_name, O_RDWR, 0);
2122 if (xforkin < 0)
2124 emacs_write (1, "Couldn't open the pty terminal ", 31);
2125 emacs_write (1, pty_name, strlen (pty_name));
2126 emacs_write (1, "\n", 1);
2127 _exit (1);
2130 #ifdef SET_CHILD_PTY_PGRP
2131 ioctl (xforkin, TIOCSPGRP, &pgrp);
2132 ioctl (xforkout, TIOCSPGRP, &pgrp);
2133 #endif
2135 #endif /* not UNIPLUS and not RTU and not DONT_REOPEN_PTY */
2137 #ifdef SETUP_SLAVE_PTY
2138 if (pty_flag)
2140 SETUP_SLAVE_PTY;
2142 #endif /* SETUP_SLAVE_PTY */
2143 #ifdef AIX
2144 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
2145 Now reenable it in the child, so it will die when we want it to. */
2146 if (pty_flag)
2147 signal (SIGHUP, SIG_DFL);
2148 #endif
2149 #endif /* HAVE_PTYS */
2151 signal (SIGINT, SIG_DFL);
2152 signal (SIGQUIT, SIG_DFL);
2154 /* Stop blocking signals in the child. */
2155 #ifdef POSIX_SIGNALS
2156 sigprocmask (SIG_SETMASK, &procmask, 0);
2157 #else /* !POSIX_SIGNALS */
2158 #ifdef SIGCHLD
2159 #ifdef BSD4_1
2160 sigrelse (SIGCHLD);
2161 #else /* not BSD4_1 */
2162 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
2163 sigsetmask (SIGEMPTYMASK);
2164 #else /* ordinary USG */
2165 #if 0
2166 signal (SIGCHLD, sigchld);
2167 #endif
2168 #endif /* ordinary USG */
2169 #endif /* not BSD4_1 */
2170 #endif /* SIGCHLD */
2171 #endif /* !POSIX_SIGNALS */
2173 #if !defined (RTU) && !defined (UNIPLUS) && !defined (DONT_REOPEN_PTY)
2174 if (pty_flag)
2175 child_setup_tty (xforkout);
2176 #endif /* not RTU and not UNIPLUS and not DONT_REOPEN_PTY */
2177 #ifdef WINDOWSNT
2178 pid = child_setup (xforkin, xforkout, xforkout,
2179 new_argv, 1, current_dir);
2180 #else /* not WINDOWSNT */
2181 child_setup (xforkin, xforkout, xforkout,
2182 new_argv, 1, current_dir);
2183 #endif /* not WINDOWSNT */
2185 environ = save_environ;
2188 UNBLOCK_INPUT;
2190 /* This runs in the Emacs process. */
2191 if (pid < 0)
2193 if (forkin >= 0)
2194 emacs_close (forkin);
2195 if (forkin != forkout && forkout >= 0)
2196 emacs_close (forkout);
2198 else
2200 /* vfork succeeded. */
2201 XPROCESS (process)->pid = pid;
2203 #ifdef WINDOWSNT
2204 register_child (pid, inchannel);
2205 #endif /* WINDOWSNT */
2207 /* If the subfork execv fails, and it exits,
2208 this close hangs. I don't know why.
2209 So have an interrupt jar it loose. */
2211 struct atimer *timer;
2212 EMACS_TIME offset;
2214 stop_polling ();
2215 EMACS_SET_SECS_USECS (offset, 1, 0);
2216 timer = start_atimer (ATIMER_RELATIVE, offset, create_process_1, 0);
2218 if (forkin >= 0)
2219 emacs_close (forkin);
2221 cancel_atimer (timer);
2222 start_polling ();
2225 if (forkin != forkout && forkout >= 0)
2226 emacs_close (forkout);
2228 #ifdef HAVE_PTYS
2229 if (pty_flag)
2230 XPROCESS (process)->tty_name = build_string (pty_name);
2231 else
2232 #endif
2233 XPROCESS (process)->tty_name = Qnil;
2236 /* Restore the signal state whether vfork succeeded or not.
2237 (We will signal an error, below, if it failed.) */
2238 #ifdef POSIX_SIGNALS
2239 #ifdef HAVE_WORKING_VFORK
2240 /* Restore the parent's signal handlers. */
2241 sigaction (SIGINT, &sigint_action, 0);
2242 sigaction (SIGQUIT, &sigquit_action, 0);
2243 #ifdef AIX
2244 sigaction (SIGHUP, &sighup_action, 0);
2245 #endif
2246 #endif /* HAVE_WORKING_VFORK */
2247 /* Stop blocking signals in the parent. */
2248 sigprocmask (SIG_SETMASK, &procmask, 0);
2249 #else /* !POSIX_SIGNALS */
2250 #ifdef SIGCHLD
2251 #ifdef BSD4_1
2252 sigrelse (SIGCHLD);
2253 #else /* not BSD4_1 */
2254 #if defined (BSD_SYSTEM) || defined (UNIPLUS) || defined (HPUX)
2255 sigsetmask (SIGEMPTYMASK);
2256 #else /* ordinary USG */
2257 #if 0
2258 signal (SIGCHLD, sigchld);
2259 /* Now really handle any of these signals
2260 that came in during this function. */
2261 if (sigchld_deferred)
2262 kill (getpid (), SIGCHLD);
2263 #endif
2264 #endif /* ordinary USG */
2265 #endif /* not BSD4_1 */
2266 #endif /* SIGCHLD */
2267 #endif /* !POSIX_SIGNALS */
2269 /* Now generate the error if vfork failed. */
2270 if (pid < 0)
2271 report_file_error ("Doing vfork", Qnil);
2273 #endif /* not VMS */
2276 #ifdef HAVE_SOCKETS
2278 /* Convert an internal struct sockaddr to a lisp object (vector or string).
2279 The address family of sa is not included in the result. */
2281 static Lisp_Object
2282 conv_sockaddr_to_lisp (sa, len)
2283 struct sockaddr *sa;
2284 int len;
2286 Lisp_Object address;
2287 int i;
2288 unsigned char *cp;
2289 register struct Lisp_Vector *p;
2291 switch (sa->sa_family)
2293 case AF_INET:
2295 struct sockaddr_in *sin = (struct sockaddr_in *) sa;
2296 len = sizeof (sin->sin_addr) + 1;
2297 address = Fmake_vector (make_number (len), Qnil);
2298 p = XVECTOR (address);
2299 p->contents[--len] = make_number (ntohs (sin->sin_port));
2300 cp = (unsigned char *)&sin->sin_addr;
2301 break;
2303 #ifdef AF_INET6
2304 case AF_INET6:
2306 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *) sa;
2307 uint16_t *ip6 = (uint16_t *)&sin6->sin6_addr;
2308 len = sizeof (sin6->sin6_addr)/2 + 1;
2309 address = Fmake_vector (make_number (len), Qnil);
2310 p = XVECTOR (address);
2311 p->contents[--len] = make_number (ntohs (sin6->sin6_port));
2312 for (i = 0; i < len; i++)
2313 p->contents[i] = make_number (ntohs (ip6[i]));
2314 return address;
2316 #endif
2317 #ifdef HAVE_LOCAL_SOCKETS
2318 case AF_LOCAL:
2320 struct sockaddr_un *sockun = (struct sockaddr_un *) sa;
2321 for (i = 0; i < sizeof (sockun->sun_path); i++)
2322 if (sockun->sun_path[i] == 0)
2323 break;
2324 return make_unibyte_string (sockun->sun_path, i);
2326 #endif
2327 default:
2328 len -= sizeof (sa->sa_family);
2329 address = Fcons (make_number (sa->sa_family),
2330 Fmake_vector (make_number (len), Qnil));
2331 p = XVECTOR (XCDR (address));
2332 cp = (unsigned char *) sa + sizeof (sa->sa_family);
2333 break;
2336 i = 0;
2337 while (i < len)
2338 p->contents[i++] = make_number (*cp++);
2340 return address;
2344 /* Get family and required size for sockaddr structure to hold ADDRESS. */
2346 static int
2347 get_lisp_to_sockaddr_size (address, familyp)
2348 Lisp_Object address;
2349 int *familyp;
2351 register struct Lisp_Vector *p;
2353 if (VECTORP (address))
2355 p = XVECTOR (address);
2356 if (p->size == 5)
2358 *familyp = AF_INET;
2359 return sizeof (struct sockaddr_in);
2361 #ifdef AF_INET6
2362 else if (p->size == 9)
2364 *familyp = AF_INET6;
2365 return sizeof (struct sockaddr_in6);
2367 #endif
2369 #ifdef HAVE_LOCAL_SOCKETS
2370 else if (STRINGP (address))
2372 *familyp = AF_LOCAL;
2373 return sizeof (struct sockaddr_un);
2375 #endif
2376 else if (CONSP (address) && INTEGERP (XCAR (address)) && VECTORP (XCDR (address)))
2378 struct sockaddr *sa;
2379 *familyp = XINT (XCAR (address));
2380 p = XVECTOR (XCDR (address));
2381 return p->size + sizeof (sa->sa_family);
2383 return 0;
2386 /* Convert an address object (vector or string) to an internal sockaddr.
2388 The address format has been basically validated by
2389 get_lisp_to_sockaddr_size, but this does not mean FAMILY is valid;
2390 it could have come from user data. So if FAMILY is not valid,
2391 we return after zeroing *SA. */
2393 static void
2394 conv_lisp_to_sockaddr (family, address, sa, len)
2395 int family;
2396 Lisp_Object address;
2397 struct sockaddr *sa;
2398 int len;
2400 register struct Lisp_Vector *p;
2401 register unsigned char *cp = NULL;
2402 register int i;
2404 bzero (sa, len);
2406 if (VECTORP (address))
2408 p = XVECTOR (address);
2409 if (family == AF_INET)
2411 struct sockaddr_in *sin = (struct sockaddr_in *) sa;
2412 len = sizeof (sin->sin_addr) + 1;
2413 i = XINT (p->contents[--len]);
2414 sin->sin_port = htons (i);
2415 cp = (unsigned char *)&sin->sin_addr;
2416 sa->sa_family = family;
2418 #ifdef AF_INET6
2419 else if (family == AF_INET6)
2421 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *) sa;
2422 uint16_t *ip6 = (uint16_t *)&sin6->sin6_addr;
2423 len = sizeof (sin6->sin6_addr) + 1;
2424 i = XINT (p->contents[--len]);
2425 sin6->sin6_port = htons (i);
2426 for (i = 0; i < len; i++)
2427 if (INTEGERP (p->contents[i]))
2429 int j = XFASTINT (p->contents[i]) & 0xffff;
2430 ip6[i] = ntohs (j);
2432 sa->sa_family = family;
2434 #endif
2435 return;
2437 else if (STRINGP (address))
2439 #ifdef HAVE_LOCAL_SOCKETS
2440 if (family == AF_LOCAL)
2442 struct sockaddr_un *sockun = (struct sockaddr_un *) sa;
2443 cp = SDATA (address);
2444 for (i = 0; i < sizeof (sockun->sun_path) && *cp; i++)
2445 sockun->sun_path[i] = *cp++;
2446 sa->sa_family = family;
2448 #endif
2449 return;
2451 else
2453 p = XVECTOR (XCDR (address));
2454 cp = (unsigned char *)sa + sizeof (sa->sa_family);
2457 for (i = 0; i < len; i++)
2458 if (INTEGERP (p->contents[i]))
2459 *cp++ = XFASTINT (p->contents[i]) & 0xff;
2462 #ifdef DATAGRAM_SOCKETS
2463 DEFUN ("process-datagram-address", Fprocess_datagram_address, Sprocess_datagram_address,
2464 1, 1, 0,
2465 doc: /* Get the current datagram address associated with PROCESS. */)
2466 (process)
2467 Lisp_Object process;
2469 int channel;
2471 CHECK_PROCESS (process);
2473 if (!DATAGRAM_CONN_P (process))
2474 return Qnil;
2476 channel = XPROCESS (process)->infd;
2477 return conv_sockaddr_to_lisp (datagram_address[channel].sa,
2478 datagram_address[channel].len);
2481 DEFUN ("set-process-datagram-address", Fset_process_datagram_address, Sset_process_datagram_address,
2482 2, 2, 0,
2483 doc: /* Set the datagram address for PROCESS to ADDRESS.
2484 Returns nil upon error setting address, ADDRESS otherwise. */)
2485 (process, address)
2486 Lisp_Object process, address;
2488 int channel;
2489 int family, len;
2491 CHECK_PROCESS (process);
2493 if (!DATAGRAM_CONN_P (process))
2494 return Qnil;
2496 channel = XPROCESS (process)->infd;
2498 len = get_lisp_to_sockaddr_size (address, &family);
2499 if (datagram_address[channel].len != len)
2500 return Qnil;
2501 conv_lisp_to_sockaddr (family, address, datagram_address[channel].sa, len);
2502 return address;
2504 #endif
2507 static struct socket_options {
2508 /* The name of this option. Should be lowercase version of option
2509 name without SO_ prefix. */
2510 char *name;
2511 /* Option level SOL_... */
2512 int optlevel;
2513 /* Option number SO_... */
2514 int optnum;
2515 enum { SOPT_UNKNOWN, SOPT_BOOL, SOPT_INT, SOPT_IFNAME, SOPT_LINGER } opttype;
2516 enum { OPIX_NONE=0, OPIX_MISC=1, OPIX_REUSEADDR=2 } optbit;
2517 } socket_options[] =
2519 #ifdef SO_BINDTODEVICE
2520 { ":bindtodevice", SOL_SOCKET, SO_BINDTODEVICE, SOPT_IFNAME, OPIX_MISC },
2521 #endif
2522 #ifdef SO_BROADCAST
2523 { ":broadcast", SOL_SOCKET, SO_BROADCAST, SOPT_BOOL, OPIX_MISC },
2524 #endif
2525 #ifdef SO_DONTROUTE
2526 { ":dontroute", SOL_SOCKET, SO_DONTROUTE, SOPT_BOOL, OPIX_MISC },
2527 #endif
2528 #ifdef SO_KEEPALIVE
2529 { ":keepalive", SOL_SOCKET, SO_KEEPALIVE, SOPT_BOOL, OPIX_MISC },
2530 #endif
2531 #ifdef SO_LINGER
2532 { ":linger", SOL_SOCKET, SO_LINGER, SOPT_LINGER, OPIX_MISC },
2533 #endif
2534 #ifdef SO_OOBINLINE
2535 { ":oobinline", SOL_SOCKET, SO_OOBINLINE, SOPT_BOOL, OPIX_MISC },
2536 #endif
2537 #ifdef SO_PRIORITY
2538 { ":priority", SOL_SOCKET, SO_PRIORITY, SOPT_INT, OPIX_MISC },
2539 #endif
2540 #ifdef SO_REUSEADDR
2541 { ":reuseaddr", SOL_SOCKET, SO_REUSEADDR, SOPT_BOOL, OPIX_REUSEADDR },
2542 #endif
2543 { 0, 0, 0, SOPT_UNKNOWN, OPIX_NONE }
2546 /* Set option OPT to value VAL on socket S.
2548 Returns (1<<socket_options[OPT].optbit) if option is known, 0 otherwise.
2549 Signals an error if setting a known option fails.
2552 static int
2553 set_socket_option (s, opt, val)
2554 int s;
2555 Lisp_Object opt, val;
2557 char *name;
2558 struct socket_options *sopt;
2559 int ret = 0;
2561 CHECK_SYMBOL (opt);
2563 name = (char *) SDATA (SYMBOL_NAME (opt));
2564 for (sopt = socket_options; sopt->name; sopt++)
2565 if (strcmp (name, sopt->name) == 0)
2566 break;
2568 switch (sopt->opttype)
2570 case SOPT_BOOL:
2572 int optval;
2573 optval = NILP (val) ? 0 : 1;
2574 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2575 &optval, sizeof (optval));
2576 break;
2579 case SOPT_INT:
2581 int optval;
2582 if (INTEGERP (val))
2583 optval = XINT (val);
2584 else
2585 error ("Bad option value for %s", name);
2586 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2587 &optval, sizeof (optval));
2588 break;
2591 #ifdef SO_BINDTODEVICE
2592 case SOPT_IFNAME:
2594 char devname[IFNAMSIZ+1];
2596 /* This is broken, at least in the Linux 2.4 kernel.
2597 To unbind, the arg must be a zero integer, not the empty string.
2598 This should work on all systems. KFS. 2003-09-23. */
2599 bzero (devname, sizeof devname);
2600 if (STRINGP (val))
2602 char *arg = (char *) SDATA (val);
2603 int len = min (strlen (arg), IFNAMSIZ);
2604 bcopy (arg, devname, len);
2606 else if (!NILP (val))
2607 error ("Bad option value for %s", name);
2608 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2609 devname, IFNAMSIZ);
2610 break;
2612 #endif
2614 #ifdef SO_LINGER
2615 case SOPT_LINGER:
2617 struct linger linger;
2619 linger.l_onoff = 1;
2620 linger.l_linger = 0;
2621 if (INTEGERP (val))
2622 linger.l_linger = XINT (val);
2623 else
2624 linger.l_onoff = NILP (val) ? 0 : 1;
2625 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2626 &linger, sizeof (linger));
2627 break;
2629 #endif
2631 default:
2632 return 0;
2635 if (ret < 0)
2636 report_file_error ("Cannot set network option",
2637 Fcons (opt, Fcons (val, Qnil)));
2638 return (1 << sopt->optbit);
2642 DEFUN ("set-network-process-option",
2643 Fset_network_process_option, Sset_network_process_option,
2644 3, 4, 0,
2645 doc: /* For network process PROCESS set option OPTION to value VALUE.
2646 See `make-network-process' for a list of options and values.
2647 If optional fourth arg NO-ERROR is non-nil, don't signal an error if
2648 OPTION is not a supported option, return nil instead; otherwise return t. */)
2649 (process, option, value, no_error)
2650 Lisp_Object process, option, value;
2651 Lisp_Object no_error;
2653 int s;
2654 struct Lisp_Process *p;
2656 CHECK_PROCESS (process);
2657 p = XPROCESS (process);
2658 if (!NETCONN1_P (p))
2659 error ("Process is not a network process");
2661 s = p->infd;
2662 if (s < 0)
2663 error ("Process is not running");
2665 if (set_socket_option (s, option, value))
2667 p->childp = Fplist_put (p->childp, option, value);
2668 return Qt;
2671 if (NILP (no_error))
2672 error ("Unknown or unsupported option");
2674 return Qnil;
2678 /* A version of request_sigio suitable for a record_unwind_protect. */
2680 static Lisp_Object
2681 unwind_request_sigio (dummy)
2682 Lisp_Object dummy;
2684 if (interrupt_input)
2685 request_sigio ();
2686 return Qnil;
2689 /* Create a network stream/datagram client/server process. Treated
2690 exactly like a normal process when reading and writing. Primary
2691 differences are in status display and process deletion. A network
2692 connection has no PID; you cannot signal it. All you can do is
2693 stop/continue it and deactivate/close it via delete-process */
2695 DEFUN ("make-network-process", Fmake_network_process, Smake_network_process,
2696 0, MANY, 0,
2697 doc: /* Create and return a network server or client process.
2699 In Emacs, network connections are represented by process objects, so
2700 input and output work as for subprocesses and `delete-process' closes
2701 a network connection. However, a network process has no process id,
2702 it cannot be signaled, and the status codes are different from normal
2703 processes.
2705 Arguments are specified as keyword/argument pairs. The following
2706 arguments are defined:
2708 :name NAME -- NAME is name for process. It is modified if necessary
2709 to make it unique.
2711 :buffer BUFFER -- BUFFER is the buffer (or buffer-name) to associate
2712 with the process. Process output goes at end of that buffer, unless
2713 you specify an output stream or filter function to handle the output.
2714 BUFFER may be also nil, meaning that this process is not associated
2715 with any buffer.
2717 :host HOST -- HOST is name of the host to connect to, or its IP
2718 address. The symbol `local' specifies the local host. If specified
2719 for a server process, it must be a valid name or address for the local
2720 host, and only clients connecting to that address will be accepted.
2722 :service SERVICE -- SERVICE is name of the service desired, or an
2723 integer specifying a port number to connect to. If SERVICE is t,
2724 a random port number is selected for the server.
2726 :type TYPE -- TYPE is the type of connection. The default (nil) is a
2727 stream type connection, `datagram' creates a datagram type connection.
2729 :family FAMILY -- FAMILY is the address (and protocol) family for the
2730 service specified by HOST and SERVICE. The default (nil) is to use
2731 whatever address family (IPv4 or IPv6) that is defined for the host
2732 and port number specified by HOST and SERVICE. Other address families
2733 supported are:
2734 local -- for a local (i.e. UNIX) address specified by SERVICE.
2735 ipv4 -- use IPv4 address family only.
2736 ipv6 -- use IPv6 address family only.
2738 :local ADDRESS -- ADDRESS is the local address used for the connection.
2739 This parameter is ignored when opening a client process. When specified
2740 for a server process, the FAMILY, HOST and SERVICE args are ignored.
2742 :remote ADDRESS -- ADDRESS is the remote partner's address for the
2743 connection. This parameter is ignored when opening a stream server
2744 process. For a datagram server process, it specifies the initial
2745 setting of the remote datagram address. When specified for a client
2746 process, the FAMILY, HOST, and SERVICE args are ignored.
2748 The format of ADDRESS depends on the address family:
2749 - An IPv4 address is represented as an vector of integers [A B C D P]
2750 corresponding to numeric IP address A.B.C.D and port number P.
2751 - A local address is represented as a string with the address in the
2752 local address space.
2753 - An "unsupported family" address is represented by a cons (F . AV)
2754 where F is the family number and AV is a vector containing the socket
2755 address data with one element per address data byte. Do not rely on
2756 this format in portable code, as it may depend on implementation
2757 defined constants, data sizes, and data structure alignment.
2759 :coding CODING -- If CODING is a symbol, it specifies the coding
2760 system used for both reading and writing for this process. If CODING
2761 is a cons (DECODING . ENCODING), DECODING is used for reading, and
2762 ENCODING is used for writing.
2764 :nowait BOOL -- If BOOL is non-nil for a stream type client process,
2765 return without waiting for the connection to complete; instead, the
2766 sentinel function will be called with second arg matching "open" (if
2767 successful) or "failed" when the connect completes. Default is to use
2768 a blocking connect (i.e. wait) for stream type connections.
2770 :noquery BOOL -- Query the user unless BOOL is non-nil, and process is
2771 running when Emacs is exited.
2773 :stop BOOL -- Start process in the `stopped' state if BOOL non-nil.
2774 In the stopped state, a server process does not accept new
2775 connections, and a client process does not handle incoming traffic.
2776 The stopped state is cleared by `continue-process' and set by
2777 `stop-process'.
2779 :filter FILTER -- Install FILTER as the process filter.
2781 :filter-multibyte BOOL -- If BOOL is non-nil, strings given to the
2782 process filter are multibyte, otherwise they are unibyte.
2783 If this keyword is not specified, the strings are multibyte iff
2784 `default-enable-multibyte-characters' is non-nil.
2786 :sentinel SENTINEL -- Install SENTINEL as the process sentinel.
2788 :log LOG -- Install LOG as the server process log function. This
2789 function is called when the server accepts a network connection from a
2790 client. The arguments are SERVER, CLIENT, and MESSAGE, where SERVER
2791 is the server process, CLIENT is the new process for the connection,
2792 and MESSAGE is a string.
2794 :plist PLIST -- Install PLIST as the new process' initial plist.
2796 :server QLEN -- if QLEN is non-nil, create a server process for the
2797 specified FAMILY, SERVICE, and connection type (stream or datagram).
2798 If QLEN is an integer, it is used as the max. length of the server's
2799 pending connection queue (also known as the backlog); the default
2800 queue length is 5. Default is to create a client process.
2802 The following network options can be specified for this connection:
2804 :broadcast BOOL -- Allow send and receive of datagram broadcasts.
2805 :dontroute BOOL -- Only send to directly connected hosts.
2806 :keepalive BOOL -- Send keep-alive messages on network stream.
2807 :linger BOOL or TIMEOUT -- Send queued messages before closing.
2808 :oobinline BOOL -- Place out-of-band data in receive data stream.
2809 :priority INT -- Set protocol defined priority for sent packets.
2810 :reuseaddr BOOL -- Allow reusing a recently used local address
2811 (this is allowed by default for a server process).
2812 :bindtodevice NAME -- bind to interface NAME. Using this may require
2813 special privileges on some systems.
2815 Consult the relevant system programmer's manual pages for more
2816 information on using these options.
2819 A server process will listen for and accept connections from clients.
2820 When a client connection is accepted, a new network process is created
2821 for the connection with the following parameters:
2823 - The client's process name is constructed by concatenating the server
2824 process' NAME and a client identification string.
2825 - If the FILTER argument is non-nil, the client process will not get a
2826 separate process buffer; otherwise, the client's process buffer is a newly
2827 created buffer named after the server process' BUFFER name or process
2828 NAME concatenated with the client identification string.
2829 - The connection type and the process filter and sentinel parameters are
2830 inherited from the server process' TYPE, FILTER and SENTINEL.
2831 - The client process' contact info is set according to the client's
2832 addressing information (typically an IP address and a port number).
2833 - The client process' plist is initialized from the server's plist.
2835 Notice that the FILTER and SENTINEL args are never used directly by
2836 the server process. Also, the BUFFER argument is not used directly by
2837 the server process, but via the optional :log function, accepted (and
2838 failed) connections may be logged in the server process' buffer.
2840 The original argument list, modified with the actual connection
2841 information, is available via the `process-contact' function.
2843 usage: (make-network-process &rest ARGS) */)
2844 (nargs, args)
2845 int nargs;
2846 Lisp_Object *args;
2848 Lisp_Object proc;
2849 Lisp_Object contact;
2850 struct Lisp_Process *p;
2851 #ifdef HAVE_GETADDRINFO
2852 struct addrinfo ai, *res, *lres;
2853 struct addrinfo hints;
2854 char *portstring, portbuf[128];
2855 #else /* HAVE_GETADDRINFO */
2856 struct _emacs_addrinfo
2858 int ai_family;
2859 int ai_socktype;
2860 int ai_protocol;
2861 int ai_addrlen;
2862 struct sockaddr *ai_addr;
2863 struct _emacs_addrinfo *ai_next;
2864 } ai, *res, *lres;
2865 #endif /* HAVE_GETADDRINFO */
2866 struct sockaddr_in address_in;
2867 #ifdef HAVE_LOCAL_SOCKETS
2868 struct sockaddr_un address_un;
2869 #endif
2870 int port;
2871 int ret = 0;
2872 int xerrno = 0;
2873 int s = -1, outch, inch;
2874 struct gcpro gcpro1;
2875 int count = SPECPDL_INDEX ();
2876 int count1;
2877 Lisp_Object QCaddress; /* one of QClocal or QCremote */
2878 Lisp_Object tem;
2879 Lisp_Object name, buffer, host, service, address;
2880 Lisp_Object filter, sentinel;
2881 int is_non_blocking_client = 0;
2882 int is_server = 0, backlog = 5;
2883 int socktype;
2884 int family = -1;
2886 if (nargs == 0)
2887 return Qnil;
2889 /* Save arguments for process-contact and clone-process. */
2890 contact = Flist (nargs, args);
2891 GCPRO1 (contact);
2893 #ifdef WINDOWSNT
2894 /* Ensure socket support is loaded if available. */
2895 init_winsock (TRUE);
2896 #endif
2898 /* :type TYPE (nil: stream, datagram */
2899 tem = Fplist_get (contact, QCtype);
2900 if (NILP (tem))
2901 socktype = SOCK_STREAM;
2902 #ifdef DATAGRAM_SOCKETS
2903 else if (EQ (tem, Qdatagram))
2904 socktype = SOCK_DGRAM;
2905 #endif
2906 else
2907 error ("Unsupported connection type");
2909 /* :server BOOL */
2910 tem = Fplist_get (contact, QCserver);
2911 if (!NILP (tem))
2913 /* Don't support network sockets when non-blocking mode is
2914 not available, since a blocked Emacs is not useful. */
2915 #if defined(TERM) || (!defined(O_NONBLOCK) && !defined(O_NDELAY))
2916 error ("Network servers not supported");
2917 #else
2918 is_server = 1;
2919 if (INTEGERP (tem))
2920 backlog = XINT (tem);
2921 #endif
2924 /* Make QCaddress an alias for :local (server) or :remote (client). */
2925 QCaddress = is_server ? QClocal : QCremote;
2927 /* :nowait BOOL */
2928 if (!is_server && socktype == SOCK_STREAM
2929 && (tem = Fplist_get (contact, QCnowait), !NILP (tem)))
2931 #ifndef NON_BLOCKING_CONNECT
2932 error ("Non-blocking connect not supported");
2933 #else
2934 is_non_blocking_client = 1;
2935 #endif
2938 name = Fplist_get (contact, QCname);
2939 buffer = Fplist_get (contact, QCbuffer);
2940 filter = Fplist_get (contact, QCfilter);
2941 sentinel = Fplist_get (contact, QCsentinel);
2943 CHECK_STRING (name);
2945 #ifdef TERM
2946 /* Let's handle TERM before things get complicated ... */
2947 host = Fplist_get (contact, QChost);
2948 CHECK_STRING (host);
2950 service = Fplist_get (contact, QCservice);
2951 if (INTEGERP (service))
2952 port = htons ((unsigned short) XINT (service));
2953 else
2955 struct servent *svc_info;
2956 CHECK_STRING (service);
2957 svc_info = getservbyname (SDATA (service), "tcp");
2958 if (svc_info == 0)
2959 error ("Unknown service: %s", SDATA (service));
2960 port = svc_info->s_port;
2963 s = connect_server (0);
2964 if (s < 0)
2965 report_file_error ("error creating socket", Fcons (name, Qnil));
2966 send_command (s, C_PORT, 0, "%s:%d", SDATA (host), ntohs (port));
2967 send_command (s, C_DUMB, 1, 0);
2969 #else /* not TERM */
2971 /* Initialize addrinfo structure in case we don't use getaddrinfo. */
2972 ai.ai_socktype = socktype;
2973 ai.ai_protocol = 0;
2974 ai.ai_next = NULL;
2975 res = &ai;
2977 /* :local ADDRESS or :remote ADDRESS */
2978 address = Fplist_get (contact, QCaddress);
2979 if (!NILP (address))
2981 host = service = Qnil;
2983 if (!(ai.ai_addrlen = get_lisp_to_sockaddr_size (address, &family)))
2984 error ("Malformed :address");
2985 ai.ai_family = family;
2986 ai.ai_addr = alloca (ai.ai_addrlen);
2987 conv_lisp_to_sockaddr (family, address, ai.ai_addr, ai.ai_addrlen);
2988 goto open_socket;
2991 /* :family FAMILY -- nil (for Inet), local, or integer. */
2992 tem = Fplist_get (contact, QCfamily);
2993 if (NILP (tem))
2995 #if defined(HAVE_GETADDRINFO) && defined(AF_INET6)
2996 family = AF_UNSPEC;
2997 #else
2998 family = AF_INET;
2999 #endif
3001 #ifdef HAVE_LOCAL_SOCKETS
3002 else if (EQ (tem, Qlocal))
3003 family = AF_LOCAL;
3004 #endif
3005 #ifdef AF_INET6
3006 else if (EQ (tem, Qipv6))
3007 family = AF_INET6;
3008 #endif
3009 else if (EQ (tem, Qipv4))
3010 family = AF_INET;
3011 else if (INTEGERP (tem))
3012 family = XINT (tem);
3013 else
3014 error ("Unknown address family");
3016 ai.ai_family = family;
3018 /* :service SERVICE -- string, integer (port number), or t (random port). */
3019 service = Fplist_get (contact, QCservice);
3021 #ifdef HAVE_LOCAL_SOCKETS
3022 if (family == AF_LOCAL)
3024 /* Host is not used. */
3025 host = Qnil;
3026 CHECK_STRING (service);
3027 bzero (&address_un, sizeof address_un);
3028 address_un.sun_family = AF_LOCAL;
3029 strncpy (address_un.sun_path, SDATA (service), sizeof address_un.sun_path);
3030 ai.ai_addr = (struct sockaddr *) &address_un;
3031 ai.ai_addrlen = sizeof address_un;
3032 goto open_socket;
3034 #endif
3036 /* :host HOST -- hostname, ip address, or 'local for localhost. */
3037 host = Fplist_get (contact, QChost);
3038 if (!NILP (host))
3040 if (EQ (host, Qlocal))
3041 host = build_string ("localhost");
3042 CHECK_STRING (host);
3045 /* Slow down polling to every ten seconds.
3046 Some kernels have a bug which causes retrying connect to fail
3047 after a connect. Polling can interfere with gethostbyname too. */
3048 #ifdef POLL_FOR_INPUT
3049 if (socktype == SOCK_STREAM)
3051 record_unwind_protect (unwind_stop_other_atimers, Qnil);
3052 bind_polling_period (10);
3054 #endif
3056 #ifdef HAVE_GETADDRINFO
3057 /* If we have a host, use getaddrinfo to resolve both host and service.
3058 Otherwise, use getservbyname to lookup the service. */
3059 if (!NILP (host))
3062 /* SERVICE can either be a string or int.
3063 Convert to a C string for later use by getaddrinfo. */
3064 if (EQ (service, Qt))
3065 portstring = "0";
3066 else if (INTEGERP (service))
3068 sprintf (portbuf, "%ld", (long) XINT (service));
3069 portstring = portbuf;
3071 else
3073 CHECK_STRING (service);
3074 portstring = SDATA (service);
3077 immediate_quit = 1;
3078 QUIT;
3079 memset (&hints, 0, sizeof (hints));
3080 hints.ai_flags = 0;
3081 hints.ai_family = family;
3082 hints.ai_socktype = socktype;
3083 hints.ai_protocol = 0;
3084 ret = getaddrinfo (SDATA (host), portstring, &hints, &res);
3085 if (ret)
3086 #ifdef HAVE_GAI_STRERROR
3087 error ("%s/%s %s", SDATA (host), portstring, gai_strerror(ret));
3088 #else
3089 error ("%s/%s getaddrinfo error %d", SDATA (host), portstring, ret);
3090 #endif
3091 immediate_quit = 0;
3093 goto open_socket;
3095 #endif /* HAVE_GETADDRINFO */
3097 /* We end up here if getaddrinfo is not defined, or in case no hostname
3098 has been specified (e.g. for a local server process). */
3100 if (EQ (service, Qt))
3101 port = 0;
3102 else if (INTEGERP (service))
3103 port = htons ((unsigned short) XINT (service));
3104 else
3106 struct servent *svc_info;
3107 CHECK_STRING (service);
3108 svc_info = getservbyname (SDATA (service),
3109 (socktype == SOCK_DGRAM ? "udp" : "tcp"));
3110 if (svc_info == 0)
3111 error ("Unknown service: %s", SDATA (service));
3112 port = svc_info->s_port;
3115 bzero (&address_in, sizeof address_in);
3116 address_in.sin_family = family;
3117 address_in.sin_addr.s_addr = INADDR_ANY;
3118 address_in.sin_port = port;
3120 #ifndef HAVE_GETADDRINFO
3121 if (!NILP (host))
3123 struct hostent *host_info_ptr;
3125 /* gethostbyname may fail with TRY_AGAIN, but we don't honour that,
3126 as it may `hang' Emacs for a very long time. */
3127 immediate_quit = 1;
3128 QUIT;
3129 host_info_ptr = gethostbyname (SDATA (host));
3130 immediate_quit = 0;
3132 if (host_info_ptr)
3134 bcopy (host_info_ptr->h_addr, (char *) &address_in.sin_addr,
3135 host_info_ptr->h_length);
3136 family = host_info_ptr->h_addrtype;
3137 address_in.sin_family = family;
3139 else
3140 /* Attempt to interpret host as numeric inet address */
3142 IN_ADDR numeric_addr;
3143 numeric_addr = inet_addr ((char *) SDATA (host));
3144 if (NUMERIC_ADDR_ERROR)
3145 error ("Unknown host \"%s\"", SDATA (host));
3147 bcopy ((char *)&numeric_addr, (char *) &address_in.sin_addr,
3148 sizeof (address_in.sin_addr));
3152 #endif /* not HAVE_GETADDRINFO */
3154 ai.ai_family = family;
3155 ai.ai_addr = (struct sockaddr *) &address_in;
3156 ai.ai_addrlen = sizeof address_in;
3158 open_socket:
3160 /* Kernel bugs (on Ultrix at least) cause lossage (not just EINTR)
3161 when connect is interrupted. So let's not let it get interrupted.
3162 Note we do not turn off polling, because polling is only used
3163 when not interrupt_input, and thus not normally used on the systems
3164 which have this bug. On systems which use polling, there's no way
3165 to quit if polling is turned off. */
3166 if (interrupt_input
3167 && !is_server && socktype == SOCK_STREAM)
3169 /* Comment from KFS: The original open-network-stream code
3170 didn't unwind protect this, but it seems like the proper
3171 thing to do. In any case, I don't see how it could harm to
3172 do this -- and it makes cleanup (using unbind_to) easier. */
3173 record_unwind_protect (unwind_request_sigio, Qnil);
3174 unrequest_sigio ();
3177 /* Do this in case we never enter the for-loop below. */
3178 count1 = SPECPDL_INDEX ();
3179 s = -1;
3181 for (lres = res; lres; lres = lres->ai_next)
3183 int optn, optbits;
3185 retry_connect:
3187 s = socket (lres->ai_family, lres->ai_socktype, lres->ai_protocol);
3188 if (s < 0)
3190 xerrno = errno;
3191 continue;
3194 #ifdef DATAGRAM_SOCKETS
3195 if (!is_server && socktype == SOCK_DGRAM)
3196 break;
3197 #endif /* DATAGRAM_SOCKETS */
3199 #ifdef NON_BLOCKING_CONNECT
3200 if (is_non_blocking_client)
3202 #ifdef O_NONBLOCK
3203 ret = fcntl (s, F_SETFL, O_NONBLOCK);
3204 #else
3205 ret = fcntl (s, F_SETFL, O_NDELAY);
3206 #endif
3207 if (ret < 0)
3209 xerrno = errno;
3210 emacs_close (s);
3211 s = -1;
3212 continue;
3215 #endif
3217 /* Make us close S if quit. */
3218 record_unwind_protect (close_file_unwind, make_number (s));
3220 /* Parse network options in the arg list.
3221 We simply ignore anything which isn't a known option (including other keywords).
3222 An error is signalled if setting a known option fails. */
3223 for (optn = optbits = 0; optn < nargs-1; optn += 2)
3224 optbits |= set_socket_option (s, args[optn], args[optn+1]);
3226 if (is_server)
3228 /* Configure as a server socket. */
3230 /* SO_REUSEADDR = 1 is default for server sockets; must specify
3231 explicit :reuseaddr key to override this. */
3232 #ifdef HAVE_LOCAL_SOCKETS
3233 if (family != AF_LOCAL)
3234 #endif
3235 if (!(optbits & (1 << OPIX_REUSEADDR)))
3237 int optval = 1;
3238 if (setsockopt (s, SOL_SOCKET, SO_REUSEADDR, &optval, sizeof optval))
3239 report_file_error ("Cannot set reuse option on server socket", Qnil);
3242 if (bind (s, lres->ai_addr, lres->ai_addrlen))
3243 report_file_error ("Cannot bind server socket", Qnil);
3245 #ifdef HAVE_GETSOCKNAME
3246 if (EQ (service, Qt))
3248 struct sockaddr_in sa1;
3249 int len1 = sizeof (sa1);
3250 if (getsockname (s, (struct sockaddr *)&sa1, &len1) == 0)
3252 ((struct sockaddr_in *)(lres->ai_addr))->sin_port = sa1.sin_port;
3253 service = make_number (ntohs (sa1.sin_port));
3254 contact = Fplist_put (contact, QCservice, service);
3257 #endif
3259 if (socktype == SOCK_STREAM && listen (s, backlog))
3260 report_file_error ("Cannot listen on server socket", Qnil);
3262 break;
3265 immediate_quit = 1;
3266 QUIT;
3268 /* This turns off all alarm-based interrupts; the
3269 bind_polling_period call above doesn't always turn all the
3270 short-interval ones off, especially if interrupt_input is
3271 set.
3273 It'd be nice to be able to control the connect timeout
3274 though. Would non-blocking connect calls be portable?
3276 This used to be conditioned by HAVE_GETADDRINFO. Why? */
3278 turn_on_atimers (0);
3280 ret = connect (s, lres->ai_addr, lres->ai_addrlen);
3281 xerrno = errno;
3283 turn_on_atimers (1);
3285 if (ret == 0 || xerrno == EISCONN)
3287 /* The unwind-protect will be discarded afterwards.
3288 Likewise for immediate_quit. */
3289 break;
3292 #ifdef NON_BLOCKING_CONNECT
3293 #ifdef EINPROGRESS
3294 if (is_non_blocking_client && xerrno == EINPROGRESS)
3295 break;
3296 #else
3297 #ifdef EWOULDBLOCK
3298 if (is_non_blocking_client && xerrno == EWOULDBLOCK)
3299 break;
3300 #endif
3301 #endif
3302 #endif
3304 immediate_quit = 0;
3306 /* Discard the unwind protect closing S. */
3307 specpdl_ptr = specpdl + count1;
3308 emacs_close (s);
3309 s = -1;
3311 if (xerrno == EINTR)
3312 goto retry_connect;
3315 if (s >= 0)
3317 #ifdef DATAGRAM_SOCKETS
3318 if (socktype == SOCK_DGRAM)
3320 if (datagram_address[s].sa)
3321 abort ();
3322 datagram_address[s].sa = (struct sockaddr *) xmalloc (lres->ai_addrlen);
3323 datagram_address[s].len = lres->ai_addrlen;
3324 if (is_server)
3326 Lisp_Object remote;
3327 bzero (datagram_address[s].sa, lres->ai_addrlen);
3328 if (remote = Fplist_get (contact, QCremote), !NILP (remote))
3330 int rfamily, rlen;
3331 rlen = get_lisp_to_sockaddr_size (remote, &rfamily);
3332 if (rfamily == lres->ai_family && rlen == lres->ai_addrlen)
3333 conv_lisp_to_sockaddr (rfamily, remote,
3334 datagram_address[s].sa, rlen);
3337 else
3338 bcopy (lres->ai_addr, datagram_address[s].sa, lres->ai_addrlen);
3340 #endif
3341 contact = Fplist_put (contact, QCaddress,
3342 conv_sockaddr_to_lisp (lres->ai_addr, lres->ai_addrlen));
3343 #ifdef HAVE_GETSOCKNAME
3344 if (!is_server)
3346 struct sockaddr_in sa1;
3347 int len1 = sizeof (sa1);
3348 if (getsockname (s, (struct sockaddr *)&sa1, &len1) == 0)
3349 contact = Fplist_put (contact, QClocal,
3350 conv_sockaddr_to_lisp (&sa1, len1));
3352 #endif
3355 immediate_quit = 0;
3357 #ifdef HAVE_GETADDRINFO
3358 if (res != &ai)
3360 BLOCK_INPUT;
3361 freeaddrinfo (res);
3362 UNBLOCK_INPUT;
3364 #endif
3366 /* Discard the unwind protect for closing S, if any. */
3367 specpdl_ptr = specpdl + count1;
3369 /* Unwind bind_polling_period and request_sigio. */
3370 unbind_to (count, Qnil);
3372 if (s < 0)
3374 /* If non-blocking got this far - and failed - assume non-blocking is
3375 not supported after all. This is probably a wrong assumption, but
3376 the normal blocking calls to open-network-stream handles this error
3377 better. */
3378 if (is_non_blocking_client)
3379 return Qnil;
3381 errno = xerrno;
3382 if (is_server)
3383 report_file_error ("make server process failed", contact);
3384 else
3385 report_file_error ("make client process failed", contact);
3388 #endif /* not TERM */
3390 inch = s;
3391 outch = s;
3393 if (!NILP (buffer))
3394 buffer = Fget_buffer_create (buffer);
3395 proc = make_process (name);
3397 chan_process[inch] = proc;
3399 #ifdef O_NONBLOCK
3400 fcntl (inch, F_SETFL, O_NONBLOCK);
3401 #else
3402 #ifdef O_NDELAY
3403 fcntl (inch, F_SETFL, O_NDELAY);
3404 #endif
3405 #endif
3407 p = XPROCESS (proc);
3409 p->childp = contact;
3410 p->plist = Fcopy_sequence (Fplist_get (contact, QCplist));
3412 p->buffer = buffer;
3413 p->sentinel = sentinel;
3414 p->filter = filter;
3415 p->filter_multibyte = !NILP (buffer_defaults.enable_multibyte_characters);
3416 /* Override the above only if :filter-multibyte is specified. */
3417 if (! NILP (Fplist_member (contact, QCfilter_multibyte)))
3418 p->filter_multibyte = !NILP (Fplist_get (contact, QCfilter_multibyte));
3419 p->log = Fplist_get (contact, QClog);
3420 if (tem = Fplist_get (contact, QCnoquery), !NILP (tem))
3421 p->kill_without_query = 1;
3422 if ((tem = Fplist_get (contact, QCstop), !NILP (tem)))
3423 p->command = Qt;
3424 p->pid = 0;
3425 p->infd = inch;
3426 p->outfd = outch;
3427 if (is_server && socktype == SOCK_STREAM)
3428 p->status = Qlisten;
3430 /* Make the process marker point into the process buffer (if any). */
3431 if (BUFFERP (buffer))
3432 set_marker_both (p->mark, buffer,
3433 BUF_ZV (XBUFFER (buffer)),
3434 BUF_ZV_BYTE (XBUFFER (buffer)));
3436 #ifdef NON_BLOCKING_CONNECT
3437 if (is_non_blocking_client)
3439 /* We may get here if connect did succeed immediately. However,
3440 in that case, we still need to signal this like a non-blocking
3441 connection. */
3442 p->status = Qconnect;
3443 if (!FD_ISSET (inch, &connect_wait_mask))
3445 FD_SET (inch, &connect_wait_mask);
3446 num_pending_connects++;
3449 else
3450 #endif
3451 /* A server may have a client filter setting of Qt, but it must
3452 still listen for incoming connects unless it is stopped. */
3453 if ((!EQ (p->filter, Qt) && !EQ (p->command, Qt))
3454 || (EQ (p->status, Qlisten) && NILP (p->command)))
3456 FD_SET (inch, &input_wait_mask);
3457 FD_SET (inch, &non_keyboard_wait_mask);
3460 if (inch > max_process_desc)
3461 max_process_desc = inch;
3463 tem = Fplist_member (contact, QCcoding);
3464 if (!NILP (tem) && (!CONSP (tem) || !CONSP (XCDR (tem))))
3465 tem = Qnil; /* No error message (too late!). */
3468 /* Setup coding systems for communicating with the network stream. */
3469 struct gcpro gcpro1;
3470 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
3471 Lisp_Object coding_systems = Qt;
3472 Lisp_Object args[5], val;
3474 if (!NILP (tem))
3476 val = XCAR (XCDR (tem));
3477 if (CONSP (val))
3478 val = XCAR (val);
3480 else if (!NILP (Vcoding_system_for_read))
3481 val = Vcoding_system_for_read;
3482 else if ((!NILP (buffer) && NILP (XBUFFER (buffer)->enable_multibyte_characters))
3483 || (NILP (buffer) && NILP (buffer_defaults.enable_multibyte_characters)))
3484 /* We dare not decode end-of-line format by setting VAL to
3485 Qraw_text, because the existing Emacs Lisp libraries
3486 assume that they receive bare code including a sequene of
3487 CR LF. */
3488 val = Qnil;
3489 else
3491 if (NILP (host) || NILP (service))
3492 coding_systems = Qnil;
3493 else
3495 args[0] = Qopen_network_stream, args[1] = name,
3496 args[2] = buffer, args[3] = host, args[4] = service;
3497 GCPRO1 (proc);
3498 coding_systems = Ffind_operation_coding_system (5, args);
3499 UNGCPRO;
3501 if (CONSP (coding_systems))
3502 val = XCAR (coding_systems);
3503 else if (CONSP (Vdefault_process_coding_system))
3504 val = XCAR (Vdefault_process_coding_system);
3505 else
3506 val = Qnil;
3508 p->decode_coding_system = val;
3510 if (!NILP (tem))
3512 val = XCAR (XCDR (tem));
3513 if (CONSP (val))
3514 val = XCDR (val);
3516 else if (!NILP (Vcoding_system_for_write))
3517 val = Vcoding_system_for_write;
3518 else if (NILP (current_buffer->enable_multibyte_characters))
3519 val = Qnil;
3520 else
3522 if (EQ (coding_systems, Qt))
3524 if (NILP (host) || NILP (service))
3525 coding_systems = Qnil;
3526 else
3528 args[0] = Qopen_network_stream, args[1] = name,
3529 args[2] = buffer, args[3] = host, args[4] = service;
3530 GCPRO1 (proc);
3531 coding_systems = Ffind_operation_coding_system (5, args);
3532 UNGCPRO;
3535 if (CONSP (coding_systems))
3536 val = XCDR (coding_systems);
3537 else if (CONSP (Vdefault_process_coding_system))
3538 val = XCDR (Vdefault_process_coding_system);
3539 else
3540 val = Qnil;
3542 p->encode_coding_system = val;
3544 setup_process_coding_systems (proc);
3546 p->decoding_buf = make_uninit_string (0);
3547 p->decoding_carryover = 0;
3548 p->encoding_buf = make_uninit_string (0);
3550 p->inherit_coding_system_flag
3551 = !(!NILP (tem) || NILP (buffer) || !inherit_process_coding_system);
3553 UNGCPRO;
3554 return proc;
3556 #endif /* HAVE_SOCKETS */
3559 #if defined(HAVE_SOCKETS) && defined(HAVE_NET_IF_H) && defined(HAVE_SYS_IOCTL_H)
3561 #ifdef SIOCGIFCONF
3562 DEFUN ("network-interface-list", Fnetwork_interface_list, Snetwork_interface_list, 0, 0, 0,
3563 doc: /* Return an alist of all network interfaces and their network address.
3564 Each element is a cons, the car of which is a string containing the
3565 interface name, and the cdr is the network address in internal
3566 format; see the description of ADDRESS in `make-network-process'. */)
3569 struct ifconf ifconf;
3570 struct ifreq *ifreqs = NULL;
3571 int ifaces = 0;
3572 int buf_size, s;
3573 Lisp_Object res;
3575 s = socket (AF_INET, SOCK_STREAM, 0);
3576 if (s < 0)
3577 return Qnil;
3579 again:
3580 ifaces += 25;
3581 buf_size = ifaces * sizeof(ifreqs[0]);
3582 ifreqs = (struct ifreq *)xrealloc(ifreqs, buf_size);
3583 if (!ifreqs)
3585 close (s);
3586 return Qnil;
3589 ifconf.ifc_len = buf_size;
3590 ifconf.ifc_req = ifreqs;
3591 if (ioctl (s, SIOCGIFCONF, &ifconf))
3593 close (s);
3594 return Qnil;
3597 if (ifconf.ifc_len == buf_size)
3598 goto again;
3600 close (s);
3601 ifaces = ifconf.ifc_len / sizeof (ifreqs[0]);
3603 res = Qnil;
3604 while (--ifaces >= 0)
3606 struct ifreq *ifq = &ifreqs[ifaces];
3607 char namebuf[sizeof (ifq->ifr_name) + 1];
3608 if (ifq->ifr_addr.sa_family != AF_INET)
3609 continue;
3610 bcopy (ifq->ifr_name, namebuf, sizeof (ifq->ifr_name));
3611 namebuf[sizeof (ifq->ifr_name)] = 0;
3612 res = Fcons (Fcons (build_string (namebuf),
3613 conv_sockaddr_to_lisp (&ifq->ifr_addr,
3614 sizeof (struct sockaddr))),
3615 res);
3618 return res;
3620 #endif /* SIOCGIFCONF */
3622 #if defined(SIOCGIFADDR) || defined(SIOCGIFHWADDR) || defined(SIOCGIFFLAGS)
3624 struct ifflag_def {
3625 int flag_bit;
3626 char *flag_sym;
3629 static struct ifflag_def ifflag_table[] = {
3630 #ifdef IFF_UP
3631 { IFF_UP, "up" },
3632 #endif
3633 #ifdef IFF_BROADCAST
3634 { IFF_BROADCAST, "broadcast" },
3635 #endif
3636 #ifdef IFF_DEBUG
3637 { IFF_DEBUG, "debug" },
3638 #endif
3639 #ifdef IFF_LOOPBACK
3640 { IFF_LOOPBACK, "loopback" },
3641 #endif
3642 #ifdef IFF_POINTOPOINT
3643 { IFF_POINTOPOINT, "pointopoint" },
3644 #endif
3645 #ifdef IFF_RUNNING
3646 { IFF_RUNNING, "running" },
3647 #endif
3648 #ifdef IFF_NOARP
3649 { IFF_NOARP, "noarp" },
3650 #endif
3651 #ifdef IFF_PROMISC
3652 { IFF_PROMISC, "promisc" },
3653 #endif
3654 #ifdef IFF_NOTRAILERS
3655 { IFF_NOTRAILERS, "notrailers" },
3656 #endif
3657 #ifdef IFF_ALLMULTI
3658 { IFF_ALLMULTI, "allmulti" },
3659 #endif
3660 #ifdef IFF_MASTER
3661 { IFF_MASTER, "master" },
3662 #endif
3663 #ifdef IFF_SLAVE
3664 { IFF_SLAVE, "slave" },
3665 #endif
3666 #ifdef IFF_MULTICAST
3667 { IFF_MULTICAST, "multicast" },
3668 #endif
3669 #ifdef IFF_PORTSEL
3670 { IFF_PORTSEL, "portsel" },
3671 #endif
3672 #ifdef IFF_AUTOMEDIA
3673 { IFF_AUTOMEDIA, "automedia" },
3674 #endif
3675 #ifdef IFF_DYNAMIC
3676 { IFF_DYNAMIC, "dynamic" },
3677 #endif
3678 #ifdef IFF_OACTIVE
3679 { IFF_OACTIVE, "oactive" }, /* OpenBSD: transmission in progress */
3680 #endif
3681 #ifdef IFF_SIMPLEX
3682 { IFF_SIMPLEX, "simplex" }, /* OpenBSD: can't hear own transmissions */
3683 #endif
3684 #ifdef IFF_LINK0
3685 { IFF_LINK0, "link0" }, /* OpenBSD: per link layer defined bit */
3686 #endif
3687 #ifdef IFF_LINK1
3688 { IFF_LINK1, "link1" }, /* OpenBSD: per link layer defined bit */
3689 #endif
3690 #ifdef IFF_LINK2
3691 { IFF_LINK2, "link2" }, /* OpenBSD: per link layer defined bit */
3692 #endif
3693 { 0, 0 }
3696 DEFUN ("network-interface-info", Fnetwork_interface_info, Snetwork_interface_info, 1, 1, 0,
3697 doc: /* Return information about network interface named IFNAME.
3698 The return value is a list (ADDR BCAST NETMASK HWADDR FLAGS),
3699 where ADDR is the layer 3 address, BCAST is the layer 3 broadcast address,
3700 NETMASK is the layer 3 network mask, HWADDR is the layer 2 addres, and
3701 FLAGS is the current flags of the interface. */)
3702 (ifname)
3703 Lisp_Object ifname;
3705 struct ifreq rq;
3706 Lisp_Object res = Qnil;
3707 Lisp_Object elt;
3708 int s;
3709 int any = 0;
3711 CHECK_STRING (ifname);
3713 bzero (rq.ifr_name, sizeof rq.ifr_name);
3714 strncpy (rq.ifr_name, SDATA (ifname), sizeof (rq.ifr_name));
3716 s = socket (AF_INET, SOCK_STREAM, 0);
3717 if (s < 0)
3718 return Qnil;
3720 elt = Qnil;
3721 #if defined(SIOCGIFFLAGS) && defined(HAVE_STRUCT_IFREQ_IFR_FLAGS)
3722 if (ioctl (s, SIOCGIFFLAGS, &rq) == 0)
3724 int flags = rq.ifr_flags;
3725 struct ifflag_def *fp;
3726 int fnum;
3728 any++;
3729 for (fp = ifflag_table; flags != 0 && fp->flag_sym; fp++)
3731 if (flags & fp->flag_bit)
3733 elt = Fcons (intern (fp->flag_sym), elt);
3734 flags -= fp->flag_bit;
3737 for (fnum = 0; flags && fnum < 32; fnum++)
3739 if (flags & (1 << fnum))
3741 elt = Fcons (make_number (fnum), elt);
3745 #endif
3746 res = Fcons (elt, res);
3748 elt = Qnil;
3749 #if defined(SIOCGIFHWADDR) && defined(HAVE_STRUCT_IFREQ_IFR_HWADDR)
3750 if (ioctl (s, SIOCGIFHWADDR, &rq) == 0)
3752 Lisp_Object hwaddr = Fmake_vector (make_number (6), Qnil);
3753 register struct Lisp_Vector *p = XVECTOR (hwaddr);
3754 int n;
3756 any++;
3757 for (n = 0; n < 6; n++)
3758 p->contents[n] = make_number (((unsigned char *)&rq.ifr_hwaddr.sa_data[0])[n]);
3759 elt = Fcons (make_number (rq.ifr_hwaddr.sa_family), hwaddr);
3761 #endif
3762 res = Fcons (elt, res);
3764 elt = Qnil;
3765 #if defined(SIOCGIFNETMASK) && (defined(HAVE_STRUCT_IFREQ_IFR_NETMASK) || defined(HAVE_STRUCT_IFREQ_IFR_ADDR))
3766 if (ioctl (s, SIOCGIFNETMASK, &rq) == 0)
3768 any++;
3769 #ifdef HAVE_STRUCT_IFREQ_IFR_NETMASK
3770 elt = conv_sockaddr_to_lisp (&rq.ifr_netmask, sizeof (rq.ifr_netmask));
3771 #else
3772 elt = conv_sockaddr_to_lisp (&rq.ifr_addr, sizeof (rq.ifr_addr));
3773 #endif
3775 #endif
3776 res = Fcons (elt, res);
3778 elt = Qnil;
3779 #if defined(SIOCGIFBRDADDR) && defined(HAVE_STRUCT_IFREQ_IFR_BROADADDR)
3780 if (ioctl (s, SIOCGIFBRDADDR, &rq) == 0)
3782 any++;
3783 elt = conv_sockaddr_to_lisp (&rq.ifr_broadaddr, sizeof (rq.ifr_broadaddr));
3785 #endif
3786 res = Fcons (elt, res);
3788 elt = Qnil;
3789 #if defined(SIOCGIFADDR) && defined(HAVE_STRUCT_IFREQ_IFR_ADDR)
3790 if (ioctl (s, SIOCGIFADDR, &rq) == 0)
3792 any++;
3793 elt = conv_sockaddr_to_lisp (&rq.ifr_addr, sizeof (rq.ifr_addr));
3795 #endif
3796 res = Fcons (elt, res);
3798 close (s);
3800 return any ? res : Qnil;
3802 #endif
3803 #endif /* HAVE_SOCKETS */
3805 /* Turn off input and output for process PROC. */
3807 void
3808 deactivate_process (proc)
3809 Lisp_Object proc;
3811 register int inchannel, outchannel;
3812 register struct Lisp_Process *p = XPROCESS (proc);
3814 inchannel = p->infd;
3815 outchannel = p->outfd;
3817 #ifdef ADAPTIVE_READ_BUFFERING
3818 if (p->read_output_delay > 0)
3820 if (--process_output_delay_count < 0)
3821 process_output_delay_count = 0;
3822 p->read_output_delay = 0;
3823 p->read_output_skip = 0;
3825 #endif
3827 if (inchannel >= 0)
3829 /* Beware SIGCHLD hereabouts. */
3830 flush_pending_output (inchannel);
3831 #ifdef VMS
3833 VMS_PROC_STUFF *get_vms_process_pointer (), *vs;
3834 sys$dassgn (outchannel);
3835 vs = get_vms_process_pointer (p->pid);
3836 if (vs)
3837 give_back_vms_process_stuff (vs);
3839 #else
3840 emacs_close (inchannel);
3841 if (outchannel >= 0 && outchannel != inchannel)
3842 emacs_close (outchannel);
3843 #endif
3845 p->infd = -1;
3846 p->outfd = -1;
3847 #ifdef DATAGRAM_SOCKETS
3848 if (DATAGRAM_CHAN_P (inchannel))
3850 xfree (datagram_address[inchannel].sa);
3851 datagram_address[inchannel].sa = 0;
3852 datagram_address[inchannel].len = 0;
3854 #endif
3855 chan_process[inchannel] = Qnil;
3856 FD_CLR (inchannel, &input_wait_mask);
3857 FD_CLR (inchannel, &non_keyboard_wait_mask);
3858 #ifdef NON_BLOCKING_CONNECT
3859 if (FD_ISSET (inchannel, &connect_wait_mask))
3861 FD_CLR (inchannel, &connect_wait_mask);
3862 if (--num_pending_connects < 0)
3863 abort ();
3865 #endif
3866 if (inchannel == max_process_desc)
3868 int i;
3869 /* We just closed the highest-numbered process input descriptor,
3870 so recompute the highest-numbered one now. */
3871 max_process_desc = 0;
3872 for (i = 0; i < MAXDESC; i++)
3873 if (!NILP (chan_process[i]))
3874 max_process_desc = i;
3879 /* Close all descriptors currently in use for communication
3880 with subprocess. This is used in a newly-forked subprocess
3881 to get rid of irrelevant descriptors. */
3883 void
3884 close_process_descs ()
3886 #ifndef WINDOWSNT
3887 int i;
3888 for (i = 0; i < MAXDESC; i++)
3890 Lisp_Object process;
3891 process = chan_process[i];
3892 if (!NILP (process))
3894 int in = XPROCESS (process)->infd;
3895 int out = XPROCESS (process)->outfd;
3896 if (in >= 0)
3897 emacs_close (in);
3898 if (out >= 0 && in != out)
3899 emacs_close (out);
3902 #endif
3905 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
3906 0, 4, 0,
3907 doc: /* Allow any pending output from subprocesses to be read by Emacs.
3908 It is read into the process' buffers or given to their filter functions.
3909 Non-nil arg PROCESS means do not return until some output has been received
3910 from PROCESS.
3912 Non-nil second arg SECONDS and third arg MILLISEC are number of
3913 seconds and milliseconds to wait; return after that much time whether
3914 or not there is input. If SECONDS is a floating point number,
3915 it specifies a fractional number of seconds to wait.
3917 If optional fourth arg JUST-THIS-ONE is non-nil, only accept output
3918 from PROCESS, suspending reading output from other processes.
3919 If JUST-THIS-ONE is an integer, don't run any timers either.
3920 Return non-nil iff we received any output before the timeout expired. */)
3921 (process, seconds, millisec, just_this_one)
3922 register Lisp_Object process, seconds, millisec, just_this_one;
3924 int secs, usecs = 0;
3926 if (! NILP (process))
3927 CHECK_PROCESS (process);
3928 else
3929 just_this_one = Qnil;
3931 if (!NILP (seconds))
3933 if (INTEGERP (seconds))
3934 secs = XINT (seconds);
3935 else if (FLOATP (seconds))
3937 double timeout = XFLOAT_DATA (seconds);
3938 secs = (int) timeout;
3939 usecs = (int) ((timeout - (double) secs) * 1000000);
3941 else
3942 wrong_type_argument (Qnumberp, seconds);
3944 if (INTEGERP (millisec))
3946 int carry;
3947 usecs += XINT (millisec) * 1000;
3948 carry = usecs / 1000000;
3949 secs += carry;
3950 if ((usecs -= carry * 1000000) < 0)
3952 secs--;
3953 usecs += 1000000;
3957 if (secs < 0 || (secs == 0 && usecs == 0))
3958 secs = -1, usecs = 0;
3960 else
3961 secs = NILP (process) ? -1 : 0;
3963 return
3964 (wait_reading_process_output (secs, usecs, 0, 0,
3965 Qnil,
3966 !NILP (process) ? XPROCESS (process) : NULL,
3967 NILP (just_this_one) ? 0 :
3968 !INTEGERP (just_this_one) ? 1 : -1)
3969 ? Qt : Qnil);
3972 /* Accept a connection for server process SERVER on CHANNEL. */
3974 static int connect_counter = 0;
3976 static void
3977 server_accept_connection (server, channel)
3978 Lisp_Object server;
3979 int channel;
3981 Lisp_Object proc, caller, name, buffer;
3982 Lisp_Object contact, host, service;
3983 struct Lisp_Process *ps= XPROCESS (server);
3984 struct Lisp_Process *p;
3985 int s;
3986 union u_sockaddr {
3987 struct sockaddr sa;
3988 struct sockaddr_in in;
3989 #ifdef AF_INET6
3990 struct sockaddr_in6 in6;
3991 #endif
3992 #ifdef HAVE_LOCAL_SOCKETS
3993 struct sockaddr_un un;
3994 #endif
3995 } saddr;
3996 int len = sizeof saddr;
3998 s = accept (channel, &saddr.sa, &len);
4000 if (s < 0)
4002 int code = errno;
4004 if (code == EAGAIN)
4005 return;
4006 #ifdef EWOULDBLOCK
4007 if (code == EWOULDBLOCK)
4008 return;
4009 #endif
4011 if (!NILP (ps->log))
4012 call3 (ps->log, server, Qnil,
4013 concat3 (build_string ("accept failed with code"),
4014 Fnumber_to_string (make_number (code)),
4015 build_string ("\n")));
4016 return;
4019 connect_counter++;
4021 /* Setup a new process to handle the connection. */
4023 /* Generate a unique identification of the caller, and build contact
4024 information for this process. */
4025 host = Qt;
4026 service = Qnil;
4027 switch (saddr.sa.sa_family)
4029 case AF_INET:
4031 Lisp_Object args[5];
4032 unsigned char *ip = (unsigned char *)&saddr.in.sin_addr.s_addr;
4033 args[0] = build_string ("%d.%d.%d.%d");
4034 args[1] = make_number (*ip++);
4035 args[2] = make_number (*ip++);
4036 args[3] = make_number (*ip++);
4037 args[4] = make_number (*ip++);
4038 host = Fformat (5, args);
4039 service = make_number (ntohs (saddr.in.sin_port));
4041 args[0] = build_string (" <%s:%d>");
4042 args[1] = host;
4043 args[2] = service;
4044 caller = Fformat (3, args);
4046 break;
4048 #ifdef AF_INET6
4049 case AF_INET6:
4051 Lisp_Object args[9];
4052 uint16_t *ip6 = (uint16_t *)&saddr.in6.sin6_addr;
4053 int i;
4054 args[0] = build_string ("%x:%x:%x:%x:%x:%x:%x:%x");
4055 for (i = 0; i < 8; i++)
4056 args[i+1] = make_number (ntohs(ip6[i]));
4057 host = Fformat (9, args);
4058 service = make_number (ntohs (saddr.in.sin_port));
4060 args[0] = build_string (" <[%s]:%d>");
4061 args[1] = host;
4062 args[2] = service;
4063 caller = Fformat (3, args);
4065 break;
4066 #endif
4068 #ifdef HAVE_LOCAL_SOCKETS
4069 case AF_LOCAL:
4070 #endif
4071 default:
4072 caller = Fnumber_to_string (make_number (connect_counter));
4073 caller = concat3 (build_string (" <*"), caller, build_string ("*>"));
4074 break;
4077 /* Create a new buffer name for this process if it doesn't have a
4078 filter. The new buffer name is based on the buffer name or
4079 process name of the server process concatenated with the caller
4080 identification. */
4082 if (!NILP (ps->filter) && !EQ (ps->filter, Qt))
4083 buffer = Qnil;
4084 else
4086 buffer = ps->buffer;
4087 if (!NILP (buffer))
4088 buffer = Fbuffer_name (buffer);
4089 else
4090 buffer = ps->name;
4091 if (!NILP (buffer))
4093 buffer = concat2 (buffer, caller);
4094 buffer = Fget_buffer_create (buffer);
4098 /* Generate a unique name for the new server process. Combine the
4099 server process name with the caller identification. */
4101 name = concat2 (ps->name, caller);
4102 proc = make_process (name);
4104 chan_process[s] = proc;
4106 #ifdef O_NONBLOCK
4107 fcntl (s, F_SETFL, O_NONBLOCK);
4108 #else
4109 #ifdef O_NDELAY
4110 fcntl (s, F_SETFL, O_NDELAY);
4111 #endif
4112 #endif
4114 p = XPROCESS (proc);
4116 /* Build new contact information for this setup. */
4117 contact = Fcopy_sequence (ps->childp);
4118 contact = Fplist_put (contact, QCserver, Qnil);
4119 contact = Fplist_put (contact, QChost, host);
4120 if (!NILP (service))
4121 contact = Fplist_put (contact, QCservice, service);
4122 contact = Fplist_put (contact, QCremote,
4123 conv_sockaddr_to_lisp (&saddr.sa, len));
4124 #ifdef HAVE_GETSOCKNAME
4125 len = sizeof saddr;
4126 if (getsockname (s, &saddr.sa, &len) == 0)
4127 contact = Fplist_put (contact, QClocal,
4128 conv_sockaddr_to_lisp (&saddr.sa, len));
4129 #endif
4131 p->childp = contact;
4132 p->plist = Fcopy_sequence (ps->plist);
4134 p->buffer = buffer;
4135 p->sentinel = ps->sentinel;
4136 p->filter = ps->filter;
4137 p->command = Qnil;
4138 p->pid = 0;
4139 p->infd = s;
4140 p->outfd = s;
4141 p->status = Qrun;
4143 /* Client processes for accepted connections are not stopped initially. */
4144 if (!EQ (p->filter, Qt))
4146 FD_SET (s, &input_wait_mask);
4147 FD_SET (s, &non_keyboard_wait_mask);
4150 if (s > max_process_desc)
4151 max_process_desc = s;
4153 /* Setup coding system for new process based on server process.
4154 This seems to be the proper thing to do, as the coding system
4155 of the new process should reflect the settings at the time the
4156 server socket was opened; not the current settings. */
4158 p->decode_coding_system = ps->decode_coding_system;
4159 p->encode_coding_system = ps->encode_coding_system;
4160 setup_process_coding_systems (proc);
4162 p->decoding_buf = make_uninit_string (0);
4163 p->decoding_carryover = 0;
4164 p->encoding_buf = make_uninit_string (0);
4166 p->inherit_coding_system_flag
4167 = (NILP (buffer) ? 0 : ps->inherit_coding_system_flag);
4169 if (!NILP (ps->log))
4170 call3 (ps->log, server, proc,
4171 concat3 (build_string ("accept from "),
4172 (STRINGP (host) ? host : build_string ("-")),
4173 build_string ("\n")));
4175 if (!NILP (p->sentinel))
4176 exec_sentinel (proc,
4177 concat3 (build_string ("open from "),
4178 (STRINGP (host) ? host : build_string ("-")),
4179 build_string ("\n")));
4182 /* This variable is different from waiting_for_input in keyboard.c.
4183 It is used to communicate to a lisp process-filter/sentinel (via the
4184 function Fwaiting_for_user_input_p below) whether Emacs was waiting
4185 for user-input when that process-filter was called.
4186 waiting_for_input cannot be used as that is by definition 0 when
4187 lisp code is being evalled.
4188 This is also used in record_asynch_buffer_change.
4189 For that purpose, this must be 0
4190 when not inside wait_reading_process_output. */
4191 static int waiting_for_user_input_p;
4193 static Lisp_Object
4194 wait_reading_process_output_unwind (data)
4195 Lisp_Object data;
4197 waiting_for_user_input_p = XINT (data);
4198 return Qnil;
4201 /* This is here so breakpoints can be put on it. */
4202 static void
4203 wait_reading_process_output_1 ()
4207 /* Use a wrapper around select to work around a bug in gdb 5.3.
4208 Normally, the wrapper is optimzed away by inlining.
4210 If emacs is stopped inside select, the gdb backtrace doesn't
4211 show the function which called select, so it is practically
4212 impossible to step through wait_reading_process_output. */
4214 #ifndef select
4215 static INLINE int
4216 select_wrapper (n, rfd, wfd, xfd, tmo)
4217 int n;
4218 SELECT_TYPE *rfd, *wfd, *xfd;
4219 EMACS_TIME *tmo;
4221 return select (n, rfd, wfd, xfd, tmo);
4223 #define select select_wrapper
4224 #endif
4226 /* Read and dispose of subprocess output while waiting for timeout to
4227 elapse and/or keyboard input to be available.
4229 TIME_LIMIT is:
4230 timeout in seconds, or
4231 zero for no limit, or
4232 -1 means gobble data immediately available but don't wait for any.
4234 MICROSECS is:
4235 an additional duration to wait, measured in microseconds.
4236 If this is nonzero and time_limit is 0, then the timeout
4237 consists of MICROSECS only.
4239 READ_KBD is a lisp value:
4240 0 to ignore keyboard input, or
4241 1 to return when input is available, or
4242 -1 meaning caller will actually read the input, so don't throw to
4243 the quit handler, or
4245 DO_DISPLAY != 0 means redisplay should be done to show subprocess
4246 output that arrives.
4248 If WAIT_FOR_CELL is a cons cell, wait until its car is non-nil
4249 (and gobble terminal input into the buffer if any arrives).
4251 If WAIT_PROC is specified, wait until something arrives from that
4252 process. The return value is true iff we read some input from
4253 that process.
4255 If JUST_WAIT_PROC is non-nil, handle only output from WAIT_PROC
4256 (suspending output from other processes). A negative value
4257 means don't run any timers either.
4259 If WAIT_PROC is specified, then the function returns true iff we
4260 received input from that process before the timeout elapsed.
4261 Otherwise, return true iff we received input from any process. */
4264 wait_reading_process_output (time_limit, microsecs, read_kbd, do_display,
4265 wait_for_cell, wait_proc, just_wait_proc)
4266 int time_limit, microsecs, read_kbd, do_display;
4267 Lisp_Object wait_for_cell;
4268 struct Lisp_Process *wait_proc;
4269 int just_wait_proc;
4271 register int channel, nfds;
4272 SELECT_TYPE Available;
4273 #ifdef NON_BLOCKING_CONNECT
4274 SELECT_TYPE Connecting;
4275 int check_connect;
4276 #endif
4277 int check_delay, no_avail;
4278 int xerrno;
4279 Lisp_Object proc;
4280 EMACS_TIME timeout, end_time;
4281 int wait_channel = -1;
4282 int got_some_input = 0;
4283 int count = SPECPDL_INDEX ();
4285 FD_ZERO (&Available);
4286 #ifdef NON_BLOCKING_CONNECT
4287 FD_ZERO (&Connecting);
4288 #endif
4290 /* If wait_proc is a process to watch, set wait_channel accordingly. */
4291 if (wait_proc != NULL)
4292 wait_channel = wait_proc->infd;
4294 record_unwind_protect (wait_reading_process_output_unwind,
4295 make_number (waiting_for_user_input_p));
4296 waiting_for_user_input_p = read_kbd;
4298 /* Since we may need to wait several times,
4299 compute the absolute time to return at. */
4300 if (time_limit || microsecs)
4302 EMACS_GET_TIME (end_time);
4303 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
4304 EMACS_ADD_TIME (end_time, end_time, timeout);
4306 #ifdef POLL_INTERRUPTED_SYS_CALL
4307 /* AlainF 5-Jul-1996
4308 HP-UX 10.10 seem to have problems with signals coming in
4309 Causes "poll: interrupted system call" messages when Emacs is run
4310 in an X window
4311 Turn off periodic alarms (in case they are in use),
4312 and then turn off any other atimers. */
4313 stop_polling ();
4314 turn_on_atimers (0);
4315 #endif /* POLL_INTERRUPTED_SYS_CALL */
4317 while (1)
4319 int timeout_reduced_for_timers = 0;
4321 /* If calling from keyboard input, do not quit
4322 since we want to return C-g as an input character.
4323 Otherwise, do pending quit if requested. */
4324 if (read_kbd >= 0)
4325 QUIT;
4326 #ifdef SYNC_INPUT
4327 else if (interrupt_input_pending)
4328 handle_async_input ();
4329 #endif
4331 /* Exit now if the cell we're waiting for became non-nil. */
4332 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
4333 break;
4335 /* Compute time from now till when time limit is up */
4336 /* Exit if already run out */
4337 if (time_limit == -1)
4339 /* -1 specified for timeout means
4340 gobble output available now
4341 but don't wait at all. */
4343 EMACS_SET_SECS_USECS (timeout, 0, 0);
4345 else if (time_limit || microsecs)
4347 EMACS_GET_TIME (timeout);
4348 EMACS_SUB_TIME (timeout, end_time, timeout);
4349 if (EMACS_TIME_NEG_P (timeout))
4350 break;
4352 else
4354 EMACS_SET_SECS_USECS (timeout, 100000, 0);
4357 /* Normally we run timers here.
4358 But not if wait_for_cell; in those cases,
4359 the wait is supposed to be short,
4360 and those callers cannot handle running arbitrary Lisp code here. */
4361 if (NILP (wait_for_cell)
4362 && just_wait_proc >= 0)
4364 EMACS_TIME timer_delay;
4368 int old_timers_run = timers_run;
4369 struct buffer *old_buffer = current_buffer;
4371 timer_delay = timer_check (1);
4373 /* If a timer has run, this might have changed buffers
4374 an alike. Make read_key_sequence aware of that. */
4375 if (timers_run != old_timers_run
4376 && old_buffer != current_buffer
4377 && waiting_for_user_input_p == -1)
4378 record_asynch_buffer_change ();
4380 if (timers_run != old_timers_run && do_display)
4381 /* We must retry, since a timer may have requeued itself
4382 and that could alter the time_delay. */
4383 redisplay_preserve_echo_area (9);
4384 else
4385 break;
4387 while (!detect_input_pending ());
4389 /* If there is unread keyboard input, also return. */
4390 if (read_kbd != 0
4391 && requeued_events_pending_p ())
4392 break;
4394 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
4396 EMACS_TIME difference;
4397 EMACS_SUB_TIME (difference, timer_delay, timeout);
4398 if (EMACS_TIME_NEG_P (difference))
4400 timeout = timer_delay;
4401 timeout_reduced_for_timers = 1;
4404 /* If time_limit is -1, we are not going to wait at all. */
4405 else if (time_limit != -1)
4407 /* This is so a breakpoint can be put here. */
4408 wait_reading_process_output_1 ();
4412 /* Cause C-g and alarm signals to take immediate action,
4413 and cause input available signals to zero out timeout.
4415 It is important that we do this before checking for process
4416 activity. If we get a SIGCHLD after the explicit checks for
4417 process activity, timeout is the only way we will know. */
4418 if (read_kbd < 0)
4419 set_waiting_for_input (&timeout);
4421 /* If status of something has changed, and no input is
4422 available, notify the user of the change right away. After
4423 this explicit check, we'll let the SIGCHLD handler zap
4424 timeout to get our attention. */
4425 if (update_tick != process_tick && do_display)
4427 SELECT_TYPE Atemp;
4428 #ifdef NON_BLOCKING_CONNECT
4429 SELECT_TYPE Ctemp;
4430 #endif
4432 Atemp = input_wait_mask;
4433 #if 0
4434 /* On Mac OS X 10.0, the SELECT system call always says input is
4435 present (for reading) at stdin, even when none is. This
4436 causes the call to SELECT below to return 1 and
4437 status_notify not to be called. As a result output of
4438 subprocesses are incorrectly discarded.
4440 FD_CLR (0, &Atemp);
4441 #endif
4442 IF_NON_BLOCKING_CONNECT (Ctemp = connect_wait_mask);
4444 EMACS_SET_SECS_USECS (timeout, 0, 0);
4445 if ((select (max (max (max_process_desc, max_keyboard_desc),
4446 max_gpm_desc) + 1,
4447 &Atemp,
4448 #ifdef NON_BLOCKING_CONNECT
4449 (num_pending_connects > 0 ? &Ctemp : (SELECT_TYPE *)0),
4450 #else
4451 (SELECT_TYPE *)0,
4452 #endif
4453 (SELECT_TYPE *)0, &timeout)
4454 <= 0))
4456 /* It's okay for us to do this and then continue with
4457 the loop, since timeout has already been zeroed out. */
4458 clear_waiting_for_input ();
4459 status_notify (NULL);
4463 /* Don't wait for output from a non-running process. Just
4464 read whatever data has already been received. */
4465 if (wait_proc && wait_proc->raw_status_new)
4466 update_status (wait_proc);
4467 if (wait_proc
4468 && ! EQ (wait_proc->status, Qrun)
4469 && ! EQ (wait_proc->status, Qconnect))
4471 int nread, total_nread = 0;
4473 clear_waiting_for_input ();
4474 XSETPROCESS (proc, wait_proc);
4476 /* Read data from the process, until we exhaust it. */
4477 while (wait_proc->infd >= 0)
4479 nread = read_process_output (proc, wait_proc->infd);
4481 if (nread == 0)
4482 break;
4484 if (0 < nread)
4485 total_nread += nread;
4486 #ifdef EIO
4487 else if (nread == -1 && EIO == errno)
4488 break;
4489 #endif
4490 #ifdef EAGAIN
4491 else if (nread == -1 && EAGAIN == errno)
4492 break;
4493 #endif
4494 #ifdef EWOULDBLOCK
4495 else if (nread == -1 && EWOULDBLOCK == errno)
4496 break;
4497 #endif
4499 if (total_nread > 0 && do_display)
4500 redisplay_preserve_echo_area (10);
4502 break;
4505 /* Wait till there is something to do */
4507 if (wait_proc && just_wait_proc)
4509 if (wait_proc->infd < 0) /* Terminated */
4510 break;
4511 FD_SET (wait_proc->infd, &Available);
4512 check_delay = 0;
4513 IF_NON_BLOCKING_CONNECT (check_connect = 0);
4515 else if (!NILP (wait_for_cell))
4517 Available = non_process_wait_mask;
4518 check_delay = 0;
4519 IF_NON_BLOCKING_CONNECT (check_connect = 0);
4521 else
4523 if (! read_kbd)
4524 Available = non_keyboard_wait_mask;
4525 else
4526 Available = input_wait_mask;
4527 IF_NON_BLOCKING_CONNECT (check_connect = (num_pending_connects > 0));
4528 check_delay = wait_channel >= 0 ? 0 : process_output_delay_count;
4531 /* If frame size has changed or the window is newly mapped,
4532 redisplay now, before we start to wait. There is a race
4533 condition here; if a SIGIO arrives between now and the select
4534 and indicates that a frame is trashed, the select may block
4535 displaying a trashed screen. */
4536 if (frame_garbaged && do_display)
4538 clear_waiting_for_input ();
4539 redisplay_preserve_echo_area (11);
4540 if (read_kbd < 0)
4541 set_waiting_for_input (&timeout);
4544 no_avail = 0;
4545 if (read_kbd && detect_input_pending ())
4547 nfds = 0;
4548 no_avail = 1;
4550 else
4552 #ifdef NON_BLOCKING_CONNECT
4553 if (check_connect)
4554 Connecting = connect_wait_mask;
4555 #endif
4557 #ifdef ADAPTIVE_READ_BUFFERING
4558 /* Set the timeout for adaptive read buffering if any
4559 process has non-zero read_output_skip and non-zero
4560 read_output_delay, and we are not reading output for a
4561 specific wait_channel. It is not executed if
4562 Vprocess_adaptive_read_buffering is nil. */
4563 if (process_output_skip && check_delay > 0)
4565 int usecs = EMACS_USECS (timeout);
4566 if (EMACS_SECS (timeout) > 0 || usecs > READ_OUTPUT_DELAY_MAX)
4567 usecs = READ_OUTPUT_DELAY_MAX;
4568 for (channel = 0; check_delay > 0 && channel <= max_process_desc; channel++)
4570 proc = chan_process[channel];
4571 if (NILP (proc))
4572 continue;
4573 /* Find minimum non-zero read_output_delay among the
4574 processes with non-zero read_output_skip. */
4575 if (XPROCESS (proc)->read_output_delay > 0)
4577 check_delay--;
4578 if (!XPROCESS (proc)->read_output_skip)
4579 continue;
4580 FD_CLR (channel, &Available);
4581 XPROCESS (proc)->read_output_skip = 0;
4582 if (XPROCESS (proc)->read_output_delay < usecs)
4583 usecs = XPROCESS (proc)->read_output_delay;
4586 EMACS_SET_SECS_USECS (timeout, 0, usecs);
4587 process_output_skip = 0;
4589 #endif
4591 nfds = select (max (max (max_process_desc, max_keyboard_desc),
4592 max_gpm_desc) + 1,
4593 &Available,
4594 #ifdef NON_BLOCKING_CONNECT
4595 (check_connect ? &Connecting : (SELECT_TYPE *)0),
4596 #else
4597 (SELECT_TYPE *)0,
4598 #endif
4599 (SELECT_TYPE *)0, &timeout);
4602 xerrno = errno;
4604 /* Make C-g and alarm signals set flags again */
4605 clear_waiting_for_input ();
4607 /* If we woke up due to SIGWINCH, actually change size now. */
4608 do_pending_window_change (0);
4610 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
4611 /* We wanted the full specified time, so return now. */
4612 break;
4613 if (nfds < 0)
4615 if (xerrno == EINTR)
4616 no_avail = 1;
4617 #ifdef ultrix
4618 /* Ultrix select seems to return ENOMEM when it is
4619 interrupted. Treat it just like EINTR. Bleah. Note
4620 that we want to test for the "ultrix" CPP symbol, not
4621 "__ultrix__"; the latter is only defined under GCC, but
4622 not by DEC's bundled CC. -JimB */
4623 else if (xerrno == ENOMEM)
4624 no_avail = 1;
4625 #endif
4626 #ifdef ALLIANT
4627 /* This happens for no known reason on ALLIANT.
4628 I am guessing that this is the right response. -- RMS. */
4629 else if (xerrno == EFAULT)
4630 no_avail = 1;
4631 #endif
4632 else if (xerrno == EBADF)
4634 #ifdef AIX
4635 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
4636 the child's closure of the pts gives the parent a SIGHUP, and
4637 the ptc file descriptor is automatically closed,
4638 yielding EBADF here or at select() call above.
4639 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
4640 in m/ibmrt-aix.h), and here we just ignore the select error.
4641 Cleanup occurs c/o status_notify after SIGCLD. */
4642 no_avail = 1; /* Cannot depend on values returned */
4643 #else
4644 abort ();
4645 #endif
4647 else
4648 error ("select error: %s", emacs_strerror (xerrno));
4651 if (no_avail)
4653 FD_ZERO (&Available);
4654 IF_NON_BLOCKING_CONNECT (check_connect = 0);
4657 #if defined(sun) && !defined(USG5_4)
4658 if (nfds > 0 && keyboard_bit_set (&Available)
4659 && interrupt_input)
4660 /* System sometimes fails to deliver SIGIO.
4662 David J. Mackenzie says that Emacs doesn't compile under
4663 Solaris if this code is enabled, thus the USG5_4 in the CPP
4664 conditional. "I haven't noticed any ill effects so far.
4665 If you find a Solaris expert somewhere, they might know
4666 better." */
4667 kill (getpid (), SIGIO);
4668 #endif
4670 #if 0 /* When polling is used, interrupt_input is 0,
4671 so get_input_pending should read the input.
4672 So this should not be needed. */
4673 /* If we are using polling for input,
4674 and we see input available, make it get read now.
4675 Otherwise it might not actually get read for a second.
4676 And on hpux, since we turn off polling in wait_reading_process_output,
4677 it might never get read at all if we don't spend much time
4678 outside of wait_reading_process_output. */
4679 if (read_kbd && interrupt_input
4680 && keyboard_bit_set (&Available)
4681 && input_polling_used ())
4682 kill (getpid (), SIGALRM);
4683 #endif
4685 /* Check for keyboard input */
4686 /* If there is any, return immediately
4687 to give it higher priority than subprocesses */
4689 if (read_kbd != 0)
4691 int old_timers_run = timers_run;
4692 struct buffer *old_buffer = current_buffer;
4693 int leave = 0;
4695 if (detect_input_pending_run_timers (do_display))
4697 swallow_events (do_display);
4698 if (detect_input_pending_run_timers (do_display))
4699 leave = 1;
4702 /* If a timer has run, this might have changed buffers
4703 an alike. Make read_key_sequence aware of that. */
4704 if (timers_run != old_timers_run
4705 && waiting_for_user_input_p == -1
4706 && old_buffer != current_buffer)
4707 record_asynch_buffer_change ();
4709 if (leave)
4710 break;
4713 /* If there is unread keyboard input, also return. */
4714 if (read_kbd != 0
4715 && requeued_events_pending_p ())
4716 break;
4718 /* If we are not checking for keyboard input now,
4719 do process events (but don't run any timers).
4720 This is so that X events will be processed.
4721 Otherwise they may have to wait until polling takes place.
4722 That would causes delays in pasting selections, for example.
4724 (We used to do this only if wait_for_cell.) */
4725 if (read_kbd == 0 && detect_input_pending ())
4727 swallow_events (do_display);
4728 #if 0 /* Exiting when read_kbd doesn't request that seems wrong, though. */
4729 if (detect_input_pending ())
4730 break;
4731 #endif
4734 /* Exit now if the cell we're waiting for became non-nil. */
4735 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
4736 break;
4738 #ifdef SIGIO
4739 /* If we think we have keyboard input waiting, but didn't get SIGIO,
4740 go read it. This can happen with X on BSD after logging out.
4741 In that case, there really is no input and no SIGIO,
4742 but select says there is input. */
4744 if (read_kbd && interrupt_input
4745 && keyboard_bit_set (&Available) && ! noninteractive)
4746 kill (getpid (), SIGIO);
4747 #endif
4749 if (! wait_proc)
4750 got_some_input |= nfds > 0;
4752 /* If checking input just got us a size-change event from X,
4753 obey it now if we should. */
4754 if (read_kbd || ! NILP (wait_for_cell))
4755 do_pending_window_change (0);
4757 /* Check for data from a process. */
4758 if (no_avail || nfds == 0)
4759 continue;
4761 /* Really FIRST_PROC_DESC should be 0 on Unix,
4762 but this is safer in the short run. */
4763 for (channel = 0; channel <= max_process_desc; channel++)
4765 if (FD_ISSET (channel, &Available)
4766 && FD_ISSET (channel, &non_keyboard_wait_mask))
4768 int nread;
4770 /* If waiting for this channel, arrange to return as
4771 soon as no more input to be processed. No more
4772 waiting. */
4773 if (wait_channel == channel)
4775 wait_channel = -1;
4776 time_limit = -1;
4777 got_some_input = 1;
4779 proc = chan_process[channel];
4780 if (NILP (proc))
4781 continue;
4783 /* If this is a server stream socket, accept connection. */
4784 if (EQ (XPROCESS (proc)->status, Qlisten))
4786 server_accept_connection (proc, channel);
4787 continue;
4790 /* Read data from the process, starting with our
4791 buffered-ahead character if we have one. */
4793 nread = read_process_output (proc, channel);
4794 if (nread > 0)
4796 /* Since read_process_output can run a filter,
4797 which can call accept-process-output,
4798 don't try to read from any other processes
4799 before doing the select again. */
4800 FD_ZERO (&Available);
4802 if (do_display)
4803 redisplay_preserve_echo_area (12);
4805 #ifdef EWOULDBLOCK
4806 else if (nread == -1 && errno == EWOULDBLOCK)
4808 #endif
4809 /* ISC 4.1 defines both EWOULDBLOCK and O_NONBLOCK,
4810 and Emacs uses O_NONBLOCK, so what we get is EAGAIN. */
4811 #ifdef O_NONBLOCK
4812 else if (nread == -1 && errno == EAGAIN)
4814 #else
4815 #ifdef O_NDELAY
4816 else if (nread == -1 && errno == EAGAIN)
4818 /* Note that we cannot distinguish between no input
4819 available now and a closed pipe.
4820 With luck, a closed pipe will be accompanied by
4821 subprocess termination and SIGCHLD. */
4822 else if (nread == 0 && !NETCONN_P (proc))
4824 #endif /* O_NDELAY */
4825 #endif /* O_NONBLOCK */
4826 #ifdef HAVE_PTYS
4827 /* On some OSs with ptys, when the process on one end of
4828 a pty exits, the other end gets an error reading with
4829 errno = EIO instead of getting an EOF (0 bytes read).
4830 Therefore, if we get an error reading and errno =
4831 EIO, just continue, because the child process has
4832 exited and should clean itself up soon (e.g. when we
4833 get a SIGCHLD).
4835 However, it has been known to happen that the SIGCHLD
4836 got lost. So raise the signal again just in case.
4837 It can't hurt. */
4838 else if (nread == -1 && errno == EIO)
4840 /* Clear the descriptor now, so we only raise the signal once. */
4841 FD_CLR (channel, &input_wait_mask);
4842 FD_CLR (channel, &non_keyboard_wait_mask);
4844 kill (getpid (), SIGCHLD);
4846 #endif /* HAVE_PTYS */
4847 /* If we can detect process termination, don't consider the process
4848 gone just because its pipe is closed. */
4849 #ifdef SIGCHLD
4850 else if (nread == 0 && !NETCONN_P (proc))
4852 #endif
4853 else
4855 /* Preserve status of processes already terminated. */
4856 XPROCESS (proc)->tick = ++process_tick;
4857 deactivate_process (proc);
4858 if (XPROCESS (proc)->raw_status_new)
4859 update_status (XPROCESS (proc));
4860 if (EQ (XPROCESS (proc)->status, Qrun))
4861 XPROCESS (proc)->status
4862 = Fcons (Qexit, Fcons (make_number (256), Qnil));
4865 #ifdef NON_BLOCKING_CONNECT
4866 if (check_connect && FD_ISSET (channel, &Connecting)
4867 && FD_ISSET (channel, &connect_wait_mask))
4869 struct Lisp_Process *p;
4871 FD_CLR (channel, &connect_wait_mask);
4872 if (--num_pending_connects < 0)
4873 abort ();
4875 proc = chan_process[channel];
4876 if (NILP (proc))
4877 continue;
4879 p = XPROCESS (proc);
4881 #ifdef GNU_LINUX
4882 /* getsockopt(,,SO_ERROR,,) is said to hang on some systems.
4883 So only use it on systems where it is known to work. */
4885 int xlen = sizeof(xerrno);
4886 if (getsockopt(channel, SOL_SOCKET, SO_ERROR, &xerrno, &xlen))
4887 xerrno = errno;
4889 #else
4891 struct sockaddr pname;
4892 int pnamelen = sizeof(pname);
4894 /* If connection failed, getpeername will fail. */
4895 xerrno = 0;
4896 if (getpeername(channel, &pname, &pnamelen) < 0)
4898 /* Obtain connect failure code through error slippage. */
4899 char dummy;
4900 xerrno = errno;
4901 if (errno == ENOTCONN && read(channel, &dummy, 1) < 0)
4902 xerrno = errno;
4905 #endif
4906 if (xerrno)
4908 p->tick = ++process_tick;
4909 p->status = Fcons (Qfailed, Fcons (make_number (xerrno), Qnil));
4910 deactivate_process (proc);
4912 else
4914 p->status = Qrun;
4915 /* Execute the sentinel here. If we had relied on
4916 status_notify to do it later, it will read input
4917 from the process before calling the sentinel. */
4918 exec_sentinel (proc, build_string ("open\n"));
4919 if (!EQ (p->filter, Qt) && !EQ (p->command, Qt))
4921 FD_SET (p->infd, &input_wait_mask);
4922 FD_SET (p->infd, &non_keyboard_wait_mask);
4926 #endif /* NON_BLOCKING_CONNECT */
4927 } /* end for each file descriptor */
4928 } /* end while exit conditions not met */
4930 unbind_to (count, Qnil);
4932 /* If calling from keyboard input, do not quit
4933 since we want to return C-g as an input character.
4934 Otherwise, do pending quit if requested. */
4935 if (read_kbd >= 0)
4937 /* Prevent input_pending from remaining set if we quit. */
4938 clear_input_pending ();
4939 QUIT;
4941 #ifdef POLL_INTERRUPTED_SYS_CALL
4942 /* AlainF 5-Jul-1996
4943 HP-UX 10.10 seems to have problems with signals coming in
4944 Causes "poll: interrupted system call" messages when Emacs is run
4945 in an X window
4946 Turn periodic alarms back on */
4947 start_polling ();
4948 #endif /* POLL_INTERRUPTED_SYS_CALL */
4950 return got_some_input;
4953 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
4955 static Lisp_Object
4956 read_process_output_call (fun_and_args)
4957 Lisp_Object fun_and_args;
4959 return apply1 (XCAR (fun_and_args), XCDR (fun_and_args));
4962 static Lisp_Object
4963 read_process_output_error_handler (error)
4964 Lisp_Object error;
4966 cmd_error_internal (error, "error in process filter: ");
4967 Vinhibit_quit = Qt;
4968 update_echo_area ();
4969 Fsleep_for (make_number (2), Qnil);
4970 return Qt;
4973 /* Read pending output from the process channel,
4974 starting with our buffered-ahead character if we have one.
4975 Yield number of decoded characters read.
4977 This function reads at most 4096 characters.
4978 If you want to read all available subprocess output,
4979 you must call it repeatedly until it returns zero.
4981 The characters read are decoded according to PROC's coding-system
4982 for decoding. */
4984 static int
4985 read_process_output (proc, channel)
4986 Lisp_Object proc;
4987 register int channel;
4989 register int nbytes;
4990 char *chars;
4991 register Lisp_Object outstream;
4992 register struct buffer *old = current_buffer;
4993 register struct Lisp_Process *p = XPROCESS (proc);
4994 register int opoint;
4995 struct coding_system *coding = proc_decode_coding_system[channel];
4996 int carryover = p->decoding_carryover;
4997 int readmax = 4096;
4999 #ifdef VMS
5000 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
5002 vs = get_vms_process_pointer (p->pid);
5003 if (vs)
5005 if (!vs->iosb[0])
5006 return (0); /* Really weird if it does this */
5007 if (!(vs->iosb[0] & 1))
5008 return -1; /* I/O error */
5010 else
5011 error ("Could not get VMS process pointer");
5012 chars = vs->inputBuffer;
5013 nbytes = clean_vms_buffer (chars, vs->iosb[1]);
5014 if (nbytes <= 0)
5016 start_vms_process_read (vs); /* Crank up the next read on the process */
5017 return 1; /* Nothing worth printing, say we got 1 */
5019 if (carryover > 0)
5021 /* The data carried over in the previous decoding (which are at
5022 the tail of decoding buffer) should be prepended to the new
5023 data read to decode all together. */
5024 chars = (char *) alloca (nbytes + carryover);
5025 bcopy (SDATA (p->decoding_buf), buf, carryover);
5026 bcopy (vs->inputBuffer, chars + carryover, nbytes);
5028 #else /* not VMS */
5030 chars = (char *) alloca (carryover + readmax);
5031 if (carryover)
5032 /* See the comment above. */
5033 bcopy (SDATA (p->decoding_buf), chars, carryover);
5035 #ifdef DATAGRAM_SOCKETS
5036 /* We have a working select, so proc_buffered_char is always -1. */
5037 if (DATAGRAM_CHAN_P (channel))
5039 int len = datagram_address[channel].len;
5040 nbytes = recvfrom (channel, chars + carryover, readmax,
5041 0, datagram_address[channel].sa, &len);
5043 else
5044 #endif
5045 if (proc_buffered_char[channel] < 0)
5047 nbytes = emacs_read (channel, chars + carryover, readmax);
5048 #ifdef ADAPTIVE_READ_BUFFERING
5049 if (nbytes > 0 && p->adaptive_read_buffering)
5051 int delay = p->read_output_delay;
5052 if (nbytes < 256)
5054 if (delay < READ_OUTPUT_DELAY_MAX_MAX)
5056 if (delay == 0)
5057 process_output_delay_count++;
5058 delay += READ_OUTPUT_DELAY_INCREMENT * 2;
5061 else if (delay > 0 && (nbytes == readmax))
5063 delay -= READ_OUTPUT_DELAY_INCREMENT;
5064 if (delay == 0)
5065 process_output_delay_count--;
5067 p->read_output_delay = delay;
5068 if (delay)
5070 p->read_output_skip = 1;
5071 process_output_skip = 1;
5074 #endif
5076 else
5078 chars[carryover] = proc_buffered_char[channel];
5079 proc_buffered_char[channel] = -1;
5080 nbytes = emacs_read (channel, chars + carryover + 1, readmax - 1);
5081 if (nbytes < 0)
5082 nbytes = 1;
5083 else
5084 nbytes = nbytes + 1;
5086 #endif /* not VMS */
5088 p->decoding_carryover = 0;
5090 /* At this point, NBYTES holds number of bytes just received
5091 (including the one in proc_buffered_char[channel]). */
5092 if (nbytes <= 0)
5094 if (nbytes < 0 || coding->mode & CODING_MODE_LAST_BLOCK)
5095 return nbytes;
5096 coding->mode |= CODING_MODE_LAST_BLOCK;
5099 /* Now set NBYTES how many bytes we must decode. */
5100 nbytes += carryover;
5102 /* Read and dispose of the process output. */
5103 outstream = p->filter;
5104 if (!NILP (outstream))
5106 /* We inhibit quit here instead of just catching it so that
5107 hitting ^G when a filter happens to be running won't screw
5108 it up. */
5109 int count = SPECPDL_INDEX ();
5110 Lisp_Object odeactivate;
5111 Lisp_Object obuffer, okeymap;
5112 Lisp_Object text;
5113 int outer_running_asynch_code = running_asynch_code;
5114 int waiting = waiting_for_user_input_p;
5116 /* No need to gcpro these, because all we do with them later
5117 is test them for EQness, and none of them should be a string. */
5118 odeactivate = Vdeactivate_mark;
5119 XSETBUFFER (obuffer, current_buffer);
5120 okeymap = current_buffer->keymap;
5122 specbind (Qinhibit_quit, Qt);
5123 specbind (Qlast_nonmenu_event, Qt);
5125 /* In case we get recursively called,
5126 and we already saved the match data nonrecursively,
5127 save the same match data in safely recursive fashion. */
5128 if (outer_running_asynch_code)
5130 Lisp_Object tem;
5131 /* Don't clobber the CURRENT match data, either! */
5132 tem = Fmatch_data (Qnil, Qnil, Qnil);
5133 restore_search_regs ();
5134 record_unwind_save_match_data ();
5135 Fset_match_data (tem, Qt);
5138 /* For speed, if a search happens within this code,
5139 save the match data in a special nonrecursive fashion. */
5140 running_asynch_code = 1;
5142 text = decode_coding_string (make_unibyte_string (chars, nbytes),
5143 coding, 0);
5144 Vlast_coding_system_used = coding->symbol;
5145 /* A new coding system might be found. */
5146 if (!EQ (p->decode_coding_system, coding->symbol))
5148 p->decode_coding_system = coding->symbol;
5150 /* Don't call setup_coding_system for
5151 proc_decode_coding_system[channel] here. It is done in
5152 detect_coding called via decode_coding above. */
5154 /* If a coding system for encoding is not yet decided, we set
5155 it as the same as coding-system for decoding.
5157 But, before doing that we must check if
5158 proc_encode_coding_system[p->outfd] surely points to a
5159 valid memory because p->outfd will be changed once EOF is
5160 sent to the process. */
5161 if (NILP (p->encode_coding_system)
5162 && proc_encode_coding_system[p->outfd])
5164 p->encode_coding_system = coding->symbol;
5165 setup_coding_system (coding->symbol,
5166 proc_encode_coding_system[p->outfd]);
5167 if (proc_encode_coding_system[p->outfd]->eol_type
5168 == CODING_EOL_UNDECIDED)
5169 proc_encode_coding_system[p->outfd]->eol_type
5170 = system_eol_type;
5174 carryover = nbytes - coding->consumed;
5175 if (carryover < 0)
5176 abort ();
5178 if (SCHARS (p->decoding_buf) < carryover)
5179 p->decoding_buf = make_uninit_string (carryover);
5180 bcopy (chars + coding->consumed, SDATA (p->decoding_buf),
5181 carryover);
5182 p->decoding_carryover = carryover;
5183 /* Adjust the multibyteness of TEXT to that of the filter. */
5184 if (!p->filter_multibyte != !STRING_MULTIBYTE (text))
5185 text = (STRING_MULTIBYTE (text)
5186 ? Fstring_as_unibyte (text)
5187 : Fstring_to_multibyte (text));
5188 if (SBYTES (text) > 0)
5189 internal_condition_case_1 (read_process_output_call,
5190 Fcons (outstream,
5191 Fcons (proc, Fcons (text, Qnil))),
5192 !NILP (Vdebug_on_error) ? Qnil : Qerror,
5193 read_process_output_error_handler);
5195 /* If we saved the match data nonrecursively, restore it now. */
5196 restore_search_regs ();
5197 running_asynch_code = outer_running_asynch_code;
5199 /* Handling the process output should not deactivate the mark. */
5200 Vdeactivate_mark = odeactivate;
5202 /* Restore waiting_for_user_input_p as it was
5203 when we were called, in case the filter clobbered it. */
5204 waiting_for_user_input_p = waiting;
5206 #if 0 /* Call record_asynch_buffer_change unconditionally,
5207 because we might have changed minor modes or other things
5208 that affect key bindings. */
5209 if (! EQ (Fcurrent_buffer (), obuffer)
5210 || ! EQ (current_buffer->keymap, okeymap))
5211 #endif
5212 /* But do it only if the caller is actually going to read events.
5213 Otherwise there's no need to make him wake up, and it could
5214 cause trouble (for example it would make sit_for return). */
5215 if (waiting_for_user_input_p == -1)
5216 record_asynch_buffer_change ();
5218 #ifdef VMS
5219 start_vms_process_read (vs);
5220 #endif
5221 unbind_to (count, Qnil);
5222 return nbytes;
5225 /* If no filter, write into buffer if it isn't dead. */
5226 if (!NILP (p->buffer) && !NILP (XBUFFER (p->buffer)->name))
5228 Lisp_Object old_read_only;
5229 int old_begv, old_zv;
5230 int old_begv_byte, old_zv_byte;
5231 Lisp_Object odeactivate;
5232 int before, before_byte;
5233 int opoint_byte;
5234 Lisp_Object text;
5235 struct buffer *b;
5237 odeactivate = Vdeactivate_mark;
5239 Fset_buffer (p->buffer);
5240 opoint = PT;
5241 opoint_byte = PT_BYTE;
5242 old_read_only = current_buffer->read_only;
5243 old_begv = BEGV;
5244 old_zv = ZV;
5245 old_begv_byte = BEGV_BYTE;
5246 old_zv_byte = ZV_BYTE;
5248 current_buffer->read_only = Qnil;
5250 /* Insert new output into buffer
5251 at the current end-of-output marker,
5252 thus preserving logical ordering of input and output. */
5253 if (XMARKER (p->mark)->buffer)
5254 SET_PT_BOTH (clip_to_bounds (BEGV, marker_position (p->mark), ZV),
5255 clip_to_bounds (BEGV_BYTE, marker_byte_position (p->mark),
5256 ZV_BYTE));
5257 else
5258 SET_PT_BOTH (ZV, ZV_BYTE);
5259 before = PT;
5260 before_byte = PT_BYTE;
5262 /* If the output marker is outside of the visible region, save
5263 the restriction and widen. */
5264 if (! (BEGV <= PT && PT <= ZV))
5265 Fwiden ();
5267 text = decode_coding_string (make_unibyte_string (chars, nbytes),
5268 coding, 0);
5269 Vlast_coding_system_used = coding->symbol;
5270 /* A new coding system might be found. See the comment in the
5271 similar code in the previous `if' block. */
5272 if (!EQ (p->decode_coding_system, coding->symbol))
5274 p->decode_coding_system = coding->symbol;
5275 if (NILP (p->encode_coding_system)
5276 && proc_encode_coding_system[p->outfd])
5278 p->encode_coding_system = coding->symbol;
5279 setup_coding_system (coding->symbol,
5280 proc_encode_coding_system[p->outfd]);
5281 if (proc_encode_coding_system[p->outfd]->eol_type
5282 == CODING_EOL_UNDECIDED)
5283 proc_encode_coding_system[p->outfd]->eol_type
5284 = system_eol_type;
5287 carryover = nbytes - coding->consumed;
5288 if (carryover < 0)
5289 abort ();
5291 if (SCHARS (p->decoding_buf) < carryover)
5292 p->decoding_buf = make_uninit_string (carryover);
5293 bcopy (chars + coding->consumed, SDATA (p->decoding_buf),
5294 carryover);
5295 p->decoding_carryover = carryover;
5297 /* Adjust the multibyteness of TEXT to that of the buffer. */
5298 if (NILP (current_buffer->enable_multibyte_characters)
5299 != ! STRING_MULTIBYTE (text))
5300 text = (STRING_MULTIBYTE (text)
5301 ? Fstring_as_unibyte (text)
5302 : Fstring_to_multibyte (text));
5303 /* Insert before markers in case we are inserting where
5304 the buffer's mark is, and the user's next command is Meta-y. */
5305 insert_from_string_before_markers (text, 0, 0,
5306 SCHARS (text), SBYTES (text), 0);
5308 /* Make sure the process marker's position is valid when the
5309 process buffer is changed in the signal_after_change above.
5310 W3 is known to do that. */
5311 if (BUFFERP (p->buffer)
5312 && (b = XBUFFER (p->buffer), b != current_buffer))
5313 set_marker_both (p->mark, p->buffer, BUF_PT (b), BUF_PT_BYTE (b));
5314 else
5315 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
5317 update_mode_lines++;
5319 /* Make sure opoint and the old restrictions
5320 float ahead of any new text just as point would. */
5321 if (opoint >= before)
5323 opoint += PT - before;
5324 opoint_byte += PT_BYTE - before_byte;
5326 if (old_begv > before)
5328 old_begv += PT - before;
5329 old_begv_byte += PT_BYTE - before_byte;
5331 if (old_zv >= before)
5333 old_zv += PT - before;
5334 old_zv_byte += PT_BYTE - before_byte;
5337 /* If the restriction isn't what it should be, set it. */
5338 if (old_begv != BEGV || old_zv != ZV)
5339 Fnarrow_to_region (make_number (old_begv), make_number (old_zv));
5341 /* Handling the process output should not deactivate the mark. */
5342 Vdeactivate_mark = odeactivate;
5344 current_buffer->read_only = old_read_only;
5345 SET_PT_BOTH (opoint, opoint_byte);
5346 set_buffer_internal (old);
5348 #ifdef VMS
5349 start_vms_process_read (vs);
5350 #endif
5351 return nbytes;
5354 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p, Swaiting_for_user_input_p,
5355 0, 0, 0,
5356 doc: /* Returns non-nil if Emacs is waiting for input from the user.
5357 This is intended for use by asynchronous process output filters and sentinels. */)
5360 return (waiting_for_user_input_p ? Qt : Qnil);
5363 /* Sending data to subprocess */
5365 jmp_buf send_process_frame;
5366 Lisp_Object process_sent_to;
5368 SIGTYPE
5369 send_process_trap ()
5371 SIGNAL_THREAD_CHECK (SIGPIPE);
5372 #ifdef BSD4_1
5373 sigrelse (SIGPIPE);
5374 sigrelse (SIGALRM);
5375 #endif /* BSD4_1 */
5376 sigunblock (sigmask (SIGPIPE));
5377 longjmp (send_process_frame, 1);
5380 /* Send some data to process PROC.
5381 BUF is the beginning of the data; LEN is the number of characters.
5382 OBJECT is the Lisp object that the data comes from. If OBJECT is
5383 nil or t, it means that the data comes from C string.
5385 If OBJECT is not nil, the data is encoded by PROC's coding-system
5386 for encoding before it is sent.
5388 This function can evaluate Lisp code and can garbage collect. */
5390 static void
5391 send_process (proc, buf, len, object)
5392 volatile Lisp_Object proc;
5393 unsigned char *volatile buf;
5394 volatile int len;
5395 volatile Lisp_Object object;
5397 /* Use volatile to protect variables from being clobbered by longjmp. */
5398 struct Lisp_Process *p = XPROCESS (proc);
5399 int rv;
5400 struct coding_system *coding;
5401 struct gcpro gcpro1;
5402 SIGTYPE (*volatile old_sigpipe) ();
5404 GCPRO1 (object);
5406 #ifdef VMS
5407 VMS_PROC_STUFF *vs, *get_vms_process_pointer();
5408 #endif /* VMS */
5410 if (p->raw_status_new)
5411 update_status (p);
5412 if (! EQ (p->status, Qrun))
5413 error ("Process %s not running", SDATA (p->name));
5414 if (p->outfd < 0)
5415 error ("Output file descriptor of %s is closed", SDATA (p->name));
5417 coding = proc_encode_coding_system[p->outfd];
5418 Vlast_coding_system_used = coding->symbol;
5420 if ((STRINGP (object) && STRING_MULTIBYTE (object))
5421 || (BUFFERP (object)
5422 && !NILP (XBUFFER (object)->enable_multibyte_characters))
5423 || EQ (object, Qt))
5425 if (!EQ (coding->symbol, p->encode_coding_system))
5426 /* The coding system for encoding was changed to raw-text
5427 because we sent a unibyte text previously. Now we are
5428 sending a multibyte text, thus we must encode it by the
5429 original coding system specified for the current process. */
5430 setup_coding_system (p->encode_coding_system, coding);
5431 if (coding->eol_type == CODING_EOL_UNDECIDED)
5432 coding->eol_type = system_eol_type;
5433 /* src_multibyte should be set to 1 _after_ a call to
5434 setup_coding_system, since it resets src_multibyte to
5435 zero. */
5436 coding->src_multibyte = 1;
5438 else
5440 /* For sending a unibyte text, character code conversion should
5441 not take place but EOL conversion should. So, setup raw-text
5442 or one of the subsidiary if we have not yet done it. */
5443 if (coding->type != coding_type_raw_text)
5445 if (CODING_REQUIRE_FLUSHING (coding))
5447 /* But, before changing the coding, we must flush out data. */
5448 coding->mode |= CODING_MODE_LAST_BLOCK;
5449 send_process (proc, "", 0, Qt);
5451 coding->src_multibyte = 0;
5452 setup_raw_text_coding_system (coding);
5455 coding->dst_multibyte = 0;
5457 if (CODING_REQUIRE_ENCODING (coding))
5459 int require = encoding_buffer_size (coding, len);
5460 int from_byte = -1, from = -1, to = -1;
5462 if (BUFFERP (object))
5464 from_byte = BUF_PTR_BYTE_POS (XBUFFER (object), buf);
5465 from = buf_bytepos_to_charpos (XBUFFER (object), from_byte);
5466 to = buf_bytepos_to_charpos (XBUFFER (object), from_byte + len);
5468 else if (STRINGP (object))
5470 from_byte = buf - SDATA (object);
5471 from = string_byte_to_char (object, from_byte);
5472 to = string_byte_to_char (object, from_byte + len);
5475 if (coding->composing != COMPOSITION_DISABLED)
5477 if (from_byte >= 0)
5478 coding_save_composition (coding, from, to, object);
5479 else
5480 coding->composing = COMPOSITION_DISABLED;
5483 if (SBYTES (p->encoding_buf) < require)
5484 p->encoding_buf = make_uninit_string (require);
5486 if (from_byte >= 0)
5487 buf = (BUFFERP (object)
5488 ? BUF_BYTE_ADDRESS (XBUFFER (object), from_byte)
5489 : SDATA (object) + from_byte);
5491 object = p->encoding_buf;
5492 encode_coding (coding, (char *) buf, SDATA (object),
5493 len, SBYTES (object));
5494 coding_free_composition_data (coding);
5495 len = coding->produced;
5496 buf = SDATA (object);
5499 #ifdef VMS
5500 vs = get_vms_process_pointer (p->pid);
5501 if (vs == 0)
5502 error ("Could not find this process: %x", p->pid);
5503 else if (write_to_vms_process (vs, buf, len))
5505 #else /* not VMS */
5507 if (pty_max_bytes == 0)
5509 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
5510 pty_max_bytes = fpathconf (p->outfd, _PC_MAX_CANON);
5511 if (pty_max_bytes < 0)
5512 pty_max_bytes = 250;
5513 #else
5514 pty_max_bytes = 250;
5515 #endif
5516 /* Deduct one, to leave space for the eof. */
5517 pty_max_bytes--;
5520 /* 2000-09-21: Emacs 20.7, sparc-sun-solaris-2.6, GCC 2.95.2,
5521 CFLAGS="-g -O": The value of the parameter `proc' is clobbered
5522 when returning with longjmp despite being declared volatile. */
5523 if (!setjmp (send_process_frame))
5525 process_sent_to = proc;
5526 while (len > 0)
5528 int this = len;
5530 /* Decide how much data we can send in one batch.
5531 Long lines need to be split into multiple batches. */
5532 if (p->pty_flag)
5534 /* Starting this at zero is always correct when not the first
5535 iteration because the previous iteration ended by sending C-d.
5536 It may not be correct for the first iteration
5537 if a partial line was sent in a separate send_process call.
5538 If that proves worth handling, we need to save linepos
5539 in the process object. */
5540 int linepos = 0;
5541 unsigned char *ptr = (unsigned char *) buf;
5542 unsigned char *end = (unsigned char *) buf + len;
5544 /* Scan through this text for a line that is too long. */
5545 while (ptr != end && linepos < pty_max_bytes)
5547 if (*ptr == '\n')
5548 linepos = 0;
5549 else
5550 linepos++;
5551 ptr++;
5553 /* If we found one, break the line there
5554 and put in a C-d to force the buffer through. */
5555 this = ptr - buf;
5558 /* Send this batch, using one or more write calls. */
5559 while (this > 0)
5561 int outfd = p->outfd;
5562 old_sigpipe = (SIGTYPE (*) ()) signal (SIGPIPE, send_process_trap);
5563 #ifdef DATAGRAM_SOCKETS
5564 if (DATAGRAM_CHAN_P (outfd))
5566 rv = sendto (outfd, (char *) buf, this,
5567 0, datagram_address[outfd].sa,
5568 datagram_address[outfd].len);
5569 if (rv < 0 && errno == EMSGSIZE)
5571 signal (SIGPIPE, old_sigpipe);
5572 report_file_error ("sending datagram",
5573 Fcons (proc, Qnil));
5576 else
5577 #endif
5579 rv = emacs_write (outfd, (char *) buf, this);
5580 #ifdef ADAPTIVE_READ_BUFFERING
5581 if (p->read_output_delay > 0
5582 && p->adaptive_read_buffering == 1)
5584 p->read_output_delay = 0;
5585 process_output_delay_count--;
5586 p->read_output_skip = 0;
5588 #endif
5590 signal (SIGPIPE, old_sigpipe);
5592 if (rv < 0)
5594 if (0
5595 #ifdef EWOULDBLOCK
5596 || errno == EWOULDBLOCK
5597 #endif
5598 #ifdef EAGAIN
5599 || errno == EAGAIN
5600 #endif
5602 /* Buffer is full. Wait, accepting input;
5603 that may allow the program
5604 to finish doing output and read more. */
5606 int offset = 0;
5608 #ifdef BROKEN_PTY_READ_AFTER_EAGAIN
5609 /* A gross hack to work around a bug in FreeBSD.
5610 In the following sequence, read(2) returns
5611 bogus data:
5613 write(2) 1022 bytes
5614 write(2) 954 bytes, get EAGAIN
5615 read(2) 1024 bytes in process_read_output
5616 read(2) 11 bytes in process_read_output
5618 That is, read(2) returns more bytes than have
5619 ever been written successfully. The 1033 bytes
5620 read are the 1022 bytes written successfully
5621 after processing (for example with CRs added if
5622 the terminal is set up that way which it is
5623 here). The same bytes will be seen again in a
5624 later read(2), without the CRs. */
5626 if (errno == EAGAIN)
5628 int flags = FWRITE;
5629 ioctl (p->outfd, TIOCFLUSH, &flags);
5631 #endif /* BROKEN_PTY_READ_AFTER_EAGAIN */
5633 /* Running filters might relocate buffers or strings.
5634 Arrange to relocate BUF. */
5635 if (BUFFERP (object))
5636 offset = BUF_PTR_BYTE_POS (XBUFFER (object), buf);
5637 else if (STRINGP (object))
5638 offset = buf - SDATA (object);
5640 #ifdef EMACS_HAS_USECS
5641 wait_reading_process_output (0, 20000, 0, 0, Qnil, NULL, 0);
5642 #else
5643 wait_reading_process_output (1, 0, 0, 0, Qnil, NULL, 0);
5644 #endif
5646 if (BUFFERP (object))
5647 buf = BUF_BYTE_ADDRESS (XBUFFER (object), offset);
5648 else if (STRINGP (object))
5649 buf = offset + SDATA (object);
5651 rv = 0;
5653 else
5654 /* This is a real error. */
5655 report_file_error ("writing to process", Fcons (proc, Qnil));
5657 buf += rv;
5658 len -= rv;
5659 this -= rv;
5662 /* If we sent just part of the string, put in an EOF
5663 to force it through, before we send the rest. */
5664 if (len > 0)
5665 Fprocess_send_eof (proc);
5668 #endif /* not VMS */
5669 else
5671 signal (SIGPIPE, old_sigpipe);
5672 #ifndef VMS
5673 proc = process_sent_to;
5674 p = XPROCESS (proc);
5675 #endif
5676 p->raw_status_new = 0;
5677 p->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
5678 p->tick = ++process_tick;
5679 deactivate_process (proc);
5680 #ifdef VMS
5681 error ("Error writing to process %s; closed it", SDATA (p->name));
5682 #else
5683 error ("SIGPIPE raised on process %s; closed it", SDATA (p->name));
5684 #endif
5687 UNGCPRO;
5690 static Lisp_Object
5691 send_process_object_unwind (buf)
5692 Lisp_Object buf;
5694 Lisp_Object tembuf;
5696 if (XBUFFER (buf) == current_buffer)
5697 return Qnil;
5698 tembuf = Fcurrent_buffer ();
5699 Fset_buffer (buf);
5700 Fkill_buffer (tembuf);
5701 return Qnil;
5704 /* Send current contents of region between START and END to PROC.
5705 If START is a string, send it instead.
5706 This function can evaluate Lisp code and can garbage collect. */
5708 static void
5709 send_process_object (proc, start, end)
5710 Lisp_Object proc, start, end;
5712 int count = SPECPDL_INDEX ();
5713 Lisp_Object object = STRINGP (start) ? start : Fcurrent_buffer ();
5714 struct buffer *given_buffer = current_buffer;
5715 unsigned char *buf;
5716 int len;
5718 record_unwind_protect (send_process_object_unwind, Fcurrent_buffer ());
5720 if (STRINGP (object) ? STRING_MULTIBYTE (object)
5721 : ! NILP (XBUFFER (object)->enable_multibyte_characters))
5723 struct Lisp_Process *p = XPROCESS (proc);
5724 struct coding_system *coding;
5726 if (p->raw_status_new)
5727 update_status (p);
5728 if (! EQ (p->status, Qrun))
5729 error ("Process %s not running", SDATA (p->name));
5730 if (p->outfd < 0)
5731 error ("Output file descriptor of %s is closed", SDATA (p->name));
5733 coding = proc_encode_coding_system[p->outfd];
5734 if (! EQ (coding->symbol, p->encode_coding_system))
5735 /* The coding system for encoding was changed to raw-text
5736 because we sent a unibyte text previously. Now we are
5737 sending a multibyte text, thus we must encode it by the
5738 original coding system specified for the current process. */
5739 setup_coding_system (p->encode_coding_system, coding);
5740 if (! NILP (coding->pre_write_conversion))
5742 struct gcpro gcpro1, gcpro2;
5744 GCPRO2 (proc, object);
5745 call2 (coding->pre_write_conversion, start, end);
5746 UNGCPRO;
5747 if (given_buffer != current_buffer)
5749 start = make_number (BEGV), end = make_number (ZV);
5750 object = Fcurrent_buffer ();
5755 if (BUFFERP (object))
5757 EMACS_INT start_byte;
5759 if (XINT (start) < GPT && XINT (end) > GPT)
5760 move_gap (XINT (end));
5761 start_byte = CHAR_TO_BYTE (XINT (start));
5762 buf = BYTE_POS_ADDR (start_byte);
5763 len = CHAR_TO_BYTE (XINT (end)) - start_byte;
5765 else
5767 buf = SDATA (object);
5768 len = SBYTES (object);
5770 send_process (proc, buf, len, object);
5772 unbind_to (count, Qnil);
5775 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
5776 3, 3, 0,
5777 doc: /* Send current contents of region as input to PROCESS.
5778 PROCESS may be a process, a buffer, the name of a process or buffer, or
5779 nil, indicating the current buffer's process.
5780 Called from program, takes three arguments, PROCESS, START and END.
5781 If the region is more than 500 characters long,
5782 it is sent in several bunches. This may happen even for shorter regions.
5783 Output from processes can arrive in between bunches. */)
5784 (process, start, end)
5785 Lisp_Object process, start, end;
5787 Lisp_Object proc;
5789 proc = get_process (process);
5790 validate_region (&start, &end);
5791 send_process_object (proc, start, end);
5792 return Qnil;
5795 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
5796 2, 2, 0,
5797 doc: /* Send PROCESS the contents of STRING as input.
5798 PROCESS may be a process, a buffer, the name of a process or buffer, or
5799 nil, indicating the current buffer's process.
5800 If STRING is more than 500 characters long,
5801 it is sent in several bunches. This may happen even for shorter strings.
5802 Output from processes can arrive in between bunches. */)
5803 (process, string)
5804 Lisp_Object process, string;
5806 Lisp_Object proc;
5807 CHECK_STRING (string);
5808 proc = get_process (process);
5809 send_process_object (proc, string, Qnil);
5810 return Qnil;
5813 /* Return the foreground process group for the tty/pty that
5814 the process P uses. */
5815 static int
5816 emacs_get_tty_pgrp (p)
5817 struct Lisp_Process *p;
5819 int gid = -1;
5821 #ifdef TIOCGPGRP
5822 if (ioctl (p->infd, TIOCGPGRP, &gid) == -1 && ! NILP (p->tty_name))
5824 int fd;
5825 /* Some OS:es (Solaris 8/9) does not allow TIOCGPGRP from the
5826 master side. Try the slave side. */
5827 fd = emacs_open (XSTRING (p->tty_name)->data, O_RDONLY, 0);
5829 if (fd != -1)
5831 ioctl (fd, TIOCGPGRP, &gid);
5832 emacs_close (fd);
5835 #endif /* defined (TIOCGPGRP ) */
5837 return gid;
5840 DEFUN ("process-running-child-p", Fprocess_running_child_p,
5841 Sprocess_running_child_p, 0, 1, 0,
5842 doc: /* Return t if PROCESS has given the terminal to a child.
5843 If the operating system does not make it possible to find out,
5844 return t unconditionally. */)
5845 (process)
5846 Lisp_Object process;
5848 /* Initialize in case ioctl doesn't exist or gives an error,
5849 in a way that will cause returning t. */
5850 int gid;
5851 Lisp_Object proc;
5852 struct Lisp_Process *p;
5854 proc = get_process (process);
5855 p = XPROCESS (proc);
5857 if (!EQ (p->childp, Qt))
5858 error ("Process %s is not a subprocess",
5859 SDATA (p->name));
5860 if (p->infd < 0)
5861 error ("Process %s is not active",
5862 SDATA (p->name));
5864 gid = emacs_get_tty_pgrp (p);
5866 if (gid == p->pid)
5867 return Qnil;
5868 return Qt;
5871 /* send a signal number SIGNO to PROCESS.
5872 If CURRENT_GROUP is t, that means send to the process group
5873 that currently owns the terminal being used to communicate with PROCESS.
5874 This is used for various commands in shell mode.
5875 If CURRENT_GROUP is lambda, that means send to the process group
5876 that currently owns the terminal, but only if it is NOT the shell itself.
5878 If NOMSG is zero, insert signal-announcements into process's buffers
5879 right away.
5881 If we can, we try to signal PROCESS by sending control characters
5882 down the pty. This allows us to signal inferiors who have changed
5883 their uid, for which killpg would return an EPERM error. */
5885 static void
5886 process_send_signal (process, signo, current_group, nomsg)
5887 Lisp_Object process;
5888 int signo;
5889 Lisp_Object current_group;
5890 int nomsg;
5892 Lisp_Object proc;
5893 register struct Lisp_Process *p;
5894 int gid;
5895 int no_pgrp = 0;
5897 proc = get_process (process);
5898 p = XPROCESS (proc);
5900 if (!EQ (p->childp, Qt))
5901 error ("Process %s is not a subprocess",
5902 SDATA (p->name));
5903 if (p->infd < 0)
5904 error ("Process %s is not active",
5905 SDATA (p->name));
5907 if (!p->pty_flag)
5908 current_group = Qnil;
5910 /* If we are using pgrps, get a pgrp number and make it negative. */
5911 if (NILP (current_group))
5912 /* Send the signal to the shell's process group. */
5913 gid = p->pid;
5914 else
5916 #ifdef SIGNALS_VIA_CHARACTERS
5917 /* If possible, send signals to the entire pgrp
5918 by sending an input character to it. */
5920 /* TERMIOS is the latest and bestest, and seems most likely to
5921 work. If the system has it, use it. */
5922 #ifdef HAVE_TERMIOS
5923 struct termios t;
5924 cc_t *sig_char = NULL;
5926 tcgetattr (p->infd, &t);
5928 switch (signo)
5930 case SIGINT:
5931 sig_char = &t.c_cc[VINTR];
5932 break;
5934 case SIGQUIT:
5935 sig_char = &t.c_cc[VQUIT];
5936 break;
5938 case SIGTSTP:
5939 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
5940 sig_char = &t.c_cc[VSWTCH];
5941 #else
5942 sig_char = &t.c_cc[VSUSP];
5943 #endif
5944 break;
5947 if (sig_char && *sig_char != CDISABLE)
5949 send_process (proc, sig_char, 1, Qnil);
5950 return;
5952 /* If we can't send the signal with a character,
5953 fall through and send it another way. */
5954 #else /* ! HAVE_TERMIOS */
5956 /* On Berkeley descendants, the following IOCTL's retrieve the
5957 current control characters. */
5958 #if defined (TIOCGLTC) && defined (TIOCGETC)
5960 struct tchars c;
5961 struct ltchars lc;
5963 switch (signo)
5965 case SIGINT:
5966 ioctl (p->infd, TIOCGETC, &c);
5967 send_process (proc, &c.t_intrc, 1, Qnil);
5968 return;
5969 case SIGQUIT:
5970 ioctl (p->infd, TIOCGETC, &c);
5971 send_process (proc, &c.t_quitc, 1, Qnil);
5972 return;
5973 #ifdef SIGTSTP
5974 case SIGTSTP:
5975 ioctl (p->infd, TIOCGLTC, &lc);
5976 send_process (proc, &lc.t_suspc, 1, Qnil);
5977 return;
5978 #endif /* ! defined (SIGTSTP) */
5981 #else /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
5983 /* On SYSV descendants, the TCGETA ioctl retrieves the current control
5984 characters. */
5985 #ifdef TCGETA
5986 struct termio t;
5987 switch (signo)
5989 case SIGINT:
5990 ioctl (p->infd, TCGETA, &t);
5991 send_process (proc, &t.c_cc[VINTR], 1, Qnil);
5992 return;
5993 case SIGQUIT:
5994 ioctl (p->infd, TCGETA, &t);
5995 send_process (proc, &t.c_cc[VQUIT], 1, Qnil);
5996 return;
5997 #ifdef SIGTSTP
5998 case SIGTSTP:
5999 ioctl (p->infd, TCGETA, &t);
6000 send_process (proc, &t.c_cc[VSWTCH], 1, Qnil);
6001 return;
6002 #endif /* ! defined (SIGTSTP) */
6004 #else /* ! defined (TCGETA) */
6005 Your configuration files are messed up.
6006 /* If your system configuration files define SIGNALS_VIA_CHARACTERS,
6007 you'd better be using one of the alternatives above! */
6008 #endif /* ! defined (TCGETA) */
6009 #endif /* ! defined (TIOCGLTC) && defined (TIOCGETC) */
6010 /* In this case, the code above should alway returns. */
6011 abort ();
6012 #endif /* ! defined HAVE_TERMIOS */
6014 /* The code above may fall through if it can't
6015 handle the signal. */
6016 #endif /* defined (SIGNALS_VIA_CHARACTERS) */
6018 #ifdef TIOCGPGRP
6019 /* Get the current pgrp using the tty itself, if we have that.
6020 Otherwise, use the pty to get the pgrp.
6021 On pfa systems, saka@pfu.fujitsu.co.JP writes:
6022 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
6023 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
6024 His patch indicates that if TIOCGPGRP returns an error, then
6025 we should just assume that p->pid is also the process group id. */
6027 gid = emacs_get_tty_pgrp (p);
6029 if (gid == -1)
6030 /* If we can't get the information, assume
6031 the shell owns the tty. */
6032 gid = p->pid;
6034 /* It is not clear whether anything really can set GID to -1.
6035 Perhaps on some system one of those ioctls can or could do so.
6036 Or perhaps this is vestigial. */
6037 if (gid == -1)
6038 no_pgrp = 1;
6039 #else /* ! defined (TIOCGPGRP ) */
6040 /* Can't select pgrps on this system, so we know that
6041 the child itself heads the pgrp. */
6042 gid = p->pid;
6043 #endif /* ! defined (TIOCGPGRP ) */
6045 /* If current_group is lambda, and the shell owns the terminal,
6046 don't send any signal. */
6047 if (EQ (current_group, Qlambda) && gid == p->pid)
6048 return;
6051 switch (signo)
6053 #ifdef SIGCONT
6054 case SIGCONT:
6055 p->raw_status_new = 0;
6056 p->status = Qrun;
6057 p->tick = ++process_tick;
6058 if (!nomsg)
6059 status_notify (NULL);
6060 break;
6061 #endif /* ! defined (SIGCONT) */
6062 case SIGINT:
6063 #ifdef VMS
6064 send_process (proc, "\003", 1, Qnil); /* ^C */
6065 goto whoosh;
6066 #endif
6067 case SIGQUIT:
6068 #ifdef VMS
6069 send_process (proc, "\031", 1, Qnil); /* ^Y */
6070 goto whoosh;
6071 #endif
6072 case SIGKILL:
6073 #ifdef VMS
6074 sys$forcex (&(p->pid), 0, 1);
6075 whoosh:
6076 #endif
6077 flush_pending_output (p->infd);
6078 break;
6081 /* If we don't have process groups, send the signal to the immediate
6082 subprocess. That isn't really right, but it's better than any
6083 obvious alternative. */
6084 if (no_pgrp)
6086 kill (p->pid, signo);
6087 return;
6090 /* gid may be a pid, or minus a pgrp's number */
6091 #ifdef TIOCSIGSEND
6092 if (!NILP (current_group))
6094 if (ioctl (p->infd, TIOCSIGSEND, signo) == -1)
6095 EMACS_KILLPG (gid, signo);
6097 else
6099 gid = - p->pid;
6100 kill (gid, signo);
6102 #else /* ! defined (TIOCSIGSEND) */
6103 EMACS_KILLPG (gid, signo);
6104 #endif /* ! defined (TIOCSIGSEND) */
6107 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
6108 doc: /* Interrupt process PROCESS.
6109 PROCESS may be a process, a buffer, or the name of a process or buffer.
6110 No arg or nil means current buffer's process.
6111 Second arg CURRENT-GROUP non-nil means send signal to
6112 the current process-group of the process's controlling terminal
6113 rather than to the process's own process group.
6114 If the process is a shell, this means interrupt current subjob
6115 rather than the shell.
6117 If CURRENT-GROUP is `lambda', and if the shell owns the terminal,
6118 don't send the signal. */)
6119 (process, current_group)
6120 Lisp_Object process, current_group;
6122 process_send_signal (process, SIGINT, current_group, 0);
6123 return process;
6126 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
6127 doc: /* Kill process PROCESS. May be process or name of one.
6128 See function `interrupt-process' for more details on usage. */)
6129 (process, current_group)
6130 Lisp_Object process, current_group;
6132 process_send_signal (process, SIGKILL, current_group, 0);
6133 return process;
6136 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
6137 doc: /* Send QUIT signal to process PROCESS. May be process or name of one.
6138 See function `interrupt-process' for more details on usage. */)
6139 (process, current_group)
6140 Lisp_Object process, current_group;
6142 process_send_signal (process, SIGQUIT, current_group, 0);
6143 return process;
6146 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
6147 doc: /* Stop process PROCESS. May be process or name of one.
6148 See function `interrupt-process' for more details on usage.
6149 If PROCESS is a network process, inhibit handling of incoming traffic. */)
6150 (process, current_group)
6151 Lisp_Object process, current_group;
6153 #ifdef HAVE_SOCKETS
6154 if (PROCESSP (process) && NETCONN_P (process))
6156 struct Lisp_Process *p;
6158 p = XPROCESS (process);
6159 if (NILP (p->command)
6160 && p->infd >= 0)
6162 FD_CLR (p->infd, &input_wait_mask);
6163 FD_CLR (p->infd, &non_keyboard_wait_mask);
6165 p->command = Qt;
6166 return process;
6168 #endif
6169 #ifndef SIGTSTP
6170 error ("No SIGTSTP support");
6171 #else
6172 process_send_signal (process, SIGTSTP, current_group, 0);
6173 #endif
6174 return process;
6177 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
6178 doc: /* Continue process PROCESS. May be process or name of one.
6179 See function `interrupt-process' for more details on usage.
6180 If PROCESS is a network process, resume handling of incoming traffic. */)
6181 (process, current_group)
6182 Lisp_Object process, current_group;
6184 #ifdef HAVE_SOCKETS
6185 if (PROCESSP (process) && NETCONN_P (process))
6187 struct Lisp_Process *p;
6189 p = XPROCESS (process);
6190 if (EQ (p->command, Qt)
6191 && p->infd >= 0
6192 && (!EQ (p->filter, Qt) || EQ (p->status, Qlisten)))
6194 FD_SET (p->infd, &input_wait_mask);
6195 FD_SET (p->infd, &non_keyboard_wait_mask);
6197 p->command = Qnil;
6198 return process;
6200 #endif
6201 #ifdef SIGCONT
6202 process_send_signal (process, SIGCONT, current_group, 0);
6203 #else
6204 error ("No SIGCONT support");
6205 #endif
6206 return process;
6209 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
6210 2, 2, "sProcess (name or number): \nnSignal code: ",
6211 doc: /* Send PROCESS the signal with code SIGCODE.
6212 PROCESS may also be a number specifying the process id of the
6213 process to signal; in this case, the process need not be a child of
6214 this Emacs.
6215 SIGCODE may be an integer, or a symbol whose name is a signal name. */)
6216 (process, sigcode)
6217 Lisp_Object process, sigcode;
6219 pid_t pid;
6221 if (INTEGERP (process))
6223 pid = XINT (process);
6224 goto got_it;
6227 if (FLOATP (process))
6229 pid = (pid_t) XFLOAT_DATA (process);
6230 goto got_it;
6233 if (STRINGP (process))
6235 Lisp_Object tem;
6236 if (tem = Fget_process (process), NILP (tem))
6238 pid = XINT (Fstring_to_number (process, make_number (10)));
6239 if (pid > 0)
6240 goto got_it;
6242 process = tem;
6244 else
6245 process = get_process (process);
6247 if (NILP (process))
6248 return process;
6250 CHECK_PROCESS (process);
6251 pid = XPROCESS (process)->pid;
6252 if (pid <= 0)
6253 error ("Cannot signal process %s", SDATA (XPROCESS (process)->name));
6255 got_it:
6257 #define parse_signal(NAME, VALUE) \
6258 else if (!xstricmp (name, NAME)) \
6259 XSETINT (sigcode, VALUE)
6261 if (INTEGERP (sigcode))
6263 else
6265 unsigned char *name;
6267 CHECK_SYMBOL (sigcode);
6268 name = SDATA (SYMBOL_NAME (sigcode));
6270 if (!strncmp(name, "SIG", 3) || !strncmp(name, "sig", 3))
6271 name += 3;
6273 if (0)
6275 #ifdef SIGUSR1
6276 parse_signal ("usr1", SIGUSR1);
6277 #endif
6278 #ifdef SIGUSR2
6279 parse_signal ("usr2", SIGUSR2);
6280 #endif
6281 #ifdef SIGTERM
6282 parse_signal ("term", SIGTERM);
6283 #endif
6284 #ifdef SIGHUP
6285 parse_signal ("hup", SIGHUP);
6286 #endif
6287 #ifdef SIGINT
6288 parse_signal ("int", SIGINT);
6289 #endif
6290 #ifdef SIGQUIT
6291 parse_signal ("quit", SIGQUIT);
6292 #endif
6293 #ifdef SIGILL
6294 parse_signal ("ill", SIGILL);
6295 #endif
6296 #ifdef SIGABRT
6297 parse_signal ("abrt", SIGABRT);
6298 #endif
6299 #ifdef SIGEMT
6300 parse_signal ("emt", SIGEMT);
6301 #endif
6302 #ifdef SIGKILL
6303 parse_signal ("kill", SIGKILL);
6304 #endif
6305 #ifdef SIGFPE
6306 parse_signal ("fpe", SIGFPE);
6307 #endif
6308 #ifdef SIGBUS
6309 parse_signal ("bus", SIGBUS);
6310 #endif
6311 #ifdef SIGSEGV
6312 parse_signal ("segv", SIGSEGV);
6313 #endif
6314 #ifdef SIGSYS
6315 parse_signal ("sys", SIGSYS);
6316 #endif
6317 #ifdef SIGPIPE
6318 parse_signal ("pipe", SIGPIPE);
6319 #endif
6320 #ifdef SIGALRM
6321 parse_signal ("alrm", SIGALRM);
6322 #endif
6323 #ifdef SIGURG
6324 parse_signal ("urg", SIGURG);
6325 #endif
6326 #ifdef SIGSTOP
6327 parse_signal ("stop", SIGSTOP);
6328 #endif
6329 #ifdef SIGTSTP
6330 parse_signal ("tstp", SIGTSTP);
6331 #endif
6332 #ifdef SIGCONT
6333 parse_signal ("cont", SIGCONT);
6334 #endif
6335 #ifdef SIGCHLD
6336 parse_signal ("chld", SIGCHLD);
6337 #endif
6338 #ifdef SIGTTIN
6339 parse_signal ("ttin", SIGTTIN);
6340 #endif
6341 #ifdef SIGTTOU
6342 parse_signal ("ttou", SIGTTOU);
6343 #endif
6344 #ifdef SIGIO
6345 parse_signal ("io", SIGIO);
6346 #endif
6347 #ifdef SIGXCPU
6348 parse_signal ("xcpu", SIGXCPU);
6349 #endif
6350 #ifdef SIGXFSZ
6351 parse_signal ("xfsz", SIGXFSZ);
6352 #endif
6353 #ifdef SIGVTALRM
6354 parse_signal ("vtalrm", SIGVTALRM);
6355 #endif
6356 #ifdef SIGPROF
6357 parse_signal ("prof", SIGPROF);
6358 #endif
6359 #ifdef SIGWINCH
6360 parse_signal ("winch", SIGWINCH);
6361 #endif
6362 #ifdef SIGINFO
6363 parse_signal ("info", SIGINFO);
6364 #endif
6365 else
6366 error ("Undefined signal name %s", name);
6369 #undef parse_signal
6371 return make_number (kill (pid, XINT (sigcode)));
6374 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
6375 doc: /* Make PROCESS see end-of-file in its input.
6376 EOF comes after any text already sent to it.
6377 PROCESS may be a process, a buffer, the name of a process or buffer, or
6378 nil, indicating the current buffer's process.
6379 If PROCESS is a network connection, or is a process communicating
6380 through a pipe (as opposed to a pty), then you cannot send any more
6381 text to PROCESS after you call this function. */)
6382 (process)
6383 Lisp_Object process;
6385 Lisp_Object proc;
6386 struct coding_system *coding;
6388 if (DATAGRAM_CONN_P (process))
6389 return process;
6391 proc = get_process (process);
6392 coding = proc_encode_coding_system[XPROCESS (proc)->outfd];
6394 /* Make sure the process is really alive. */
6395 if (XPROCESS (proc)->raw_status_new)
6396 update_status (XPROCESS (proc));
6397 if (! EQ (XPROCESS (proc)->status, Qrun))
6398 error ("Process %s not running", SDATA (XPROCESS (proc)->name));
6400 if (CODING_REQUIRE_FLUSHING (coding))
6402 coding->mode |= CODING_MODE_LAST_BLOCK;
6403 send_process (proc, "", 0, Qnil);
6406 #ifdef VMS
6407 send_process (proc, "\032", 1, Qnil); /* ^z */
6408 #else
6409 if (XPROCESS (proc)->pty_flag)
6410 send_process (proc, "\004", 1, Qnil);
6411 else
6413 int old_outfd, new_outfd;
6415 #ifdef HAVE_SHUTDOWN
6416 /* If this is a network connection, or socketpair is used
6417 for communication with the subprocess, call shutdown to cause EOF.
6418 (In some old system, shutdown to socketpair doesn't work.
6419 Then we just can't win.) */
6420 if (XPROCESS (proc)->pid == 0
6421 || XPROCESS (proc)->outfd == XPROCESS (proc)->infd)
6422 shutdown (XPROCESS (proc)->outfd, 1);
6423 /* In case of socketpair, outfd == infd, so don't close it. */
6424 if (XPROCESS (proc)->outfd != XPROCESS (proc)->infd)
6425 emacs_close (XPROCESS (proc)->outfd);
6426 #else /* not HAVE_SHUTDOWN */
6427 emacs_close (XPROCESS (proc)->outfd);
6428 #endif /* not HAVE_SHUTDOWN */
6429 new_outfd = emacs_open (NULL_DEVICE, O_WRONLY, 0);
6430 if (new_outfd < 0)
6431 abort ();
6432 old_outfd = XPROCESS (proc)->outfd;
6434 if (!proc_encode_coding_system[new_outfd])
6435 proc_encode_coding_system[new_outfd]
6436 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
6437 bcopy (proc_encode_coding_system[old_outfd],
6438 proc_encode_coding_system[new_outfd],
6439 sizeof (struct coding_system));
6440 bzero (proc_encode_coding_system[old_outfd],
6441 sizeof (struct coding_system));
6443 XPROCESS (proc)->outfd = new_outfd;
6445 #endif /* VMS */
6446 return process;
6449 /* Kill all processes associated with `buffer'.
6450 If `buffer' is nil, kill all processes */
6452 void
6453 kill_buffer_processes (buffer)
6454 Lisp_Object buffer;
6456 Lisp_Object tail, proc;
6458 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCDR (tail))
6460 proc = XCDR (XCAR (tail));
6461 if (GC_PROCESSP (proc)
6462 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
6464 if (NETCONN_P (proc))
6465 Fdelete_process (proc);
6466 else if (XPROCESS (proc)->infd >= 0)
6467 process_send_signal (proc, SIGHUP, Qnil, 1);
6472 /* On receipt of a signal that a child status has changed, loop asking
6473 about children with changed statuses until the system says there
6474 are no more.
6476 All we do is change the status; we do not run sentinels or print
6477 notifications. That is saved for the next time keyboard input is
6478 done, in order to avoid timing errors.
6480 ** WARNING: this can be called during garbage collection.
6481 Therefore, it must not be fooled by the presence of mark bits in
6482 Lisp objects.
6484 ** USG WARNING: Although it is not obvious from the documentation
6485 in signal(2), on a USG system the SIGCLD handler MUST NOT call
6486 signal() before executing at least one wait(), otherwise the
6487 handler will be called again, resulting in an infinite loop. The
6488 relevant portion of the documentation reads "SIGCLD signals will be
6489 queued and the signal-catching function will be continually
6490 reentered until the queue is empty". Invoking signal() causes the
6491 kernel to reexamine the SIGCLD queue. Fred Fish, UniSoft Systems
6492 Inc.
6494 ** Malloc WARNING: This should never call malloc either directly or
6495 indirectly; if it does, that is a bug */
6497 #ifdef SIGCHLD
6498 SIGTYPE
6499 sigchld_handler (signo)
6500 int signo;
6502 int old_errno = errno;
6503 Lisp_Object proc;
6504 register struct Lisp_Process *p;
6505 extern EMACS_TIME *input_available_clear_time;
6507 SIGNAL_THREAD_CHECK (signo);
6509 #ifdef BSD4_1
6510 extern int sigheld;
6511 sigheld |= sigbit (SIGCHLD);
6512 #endif
6514 while (1)
6516 pid_t pid;
6517 WAITTYPE w;
6518 Lisp_Object tail;
6520 #ifdef WNOHANG
6521 #ifndef WUNTRACED
6522 #define WUNTRACED 0
6523 #endif /* no WUNTRACED */
6524 /* Keep trying to get a status until we get a definitive result. */
6527 errno = 0;
6528 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
6530 while (pid < 0 && errno == EINTR);
6532 if (pid <= 0)
6534 /* PID == 0 means no processes found, PID == -1 means a real
6535 failure. We have done all our job, so return. */
6537 /* USG systems forget handlers when they are used;
6538 must reestablish each time */
6539 #if defined (USG) && !defined (POSIX_SIGNALS)
6540 signal (signo, sigchld_handler); /* WARNING - must come after wait3() */
6541 #endif
6542 #ifdef BSD4_1
6543 sigheld &= ~sigbit (SIGCHLD);
6544 sigrelse (SIGCHLD);
6545 #endif
6546 errno = old_errno;
6547 return;
6549 #else
6550 pid = wait (&w);
6551 #endif /* no WNOHANG */
6553 /* Find the process that signaled us, and record its status. */
6555 /* The process can have been deleted by Fdelete_process. */
6556 for (tail = deleted_pid_list; GC_CONSP (tail); tail = XCDR (tail))
6558 Lisp_Object xpid = XCAR (tail);
6559 if ((GC_INTEGERP (xpid) && pid == (pid_t) XINT (xpid))
6560 || (GC_FLOATP (xpid) && pid == (pid_t) XFLOAT_DATA (xpid)))
6562 XSETCAR (tail, Qnil);
6563 goto sigchld_end_of_loop;
6567 /* Otherwise, if it is asynchronous, it is in Vprocess_alist. */
6568 p = 0;
6569 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCDR (tail))
6571 proc = XCDR (XCAR (tail));
6572 p = XPROCESS (proc);
6573 if (GC_EQ (p->childp, Qt) && p->pid == pid)
6574 break;
6575 p = 0;
6578 /* Look for an asynchronous process whose pid hasn't been filled
6579 in yet. */
6580 if (p == 0)
6581 for (tail = Vprocess_alist; GC_CONSP (tail); tail = XCDR (tail))
6583 proc = XCDR (XCAR (tail));
6584 p = XPROCESS (proc);
6585 if (p->pid == -1)
6586 break;
6587 p = 0;
6590 /* Change the status of the process that was found. */
6591 if (p != 0)
6593 union { int i; WAITTYPE wt; } u;
6594 int clear_desc_flag = 0;
6596 p->tick = ++process_tick;
6597 u.wt = w;
6598 p->raw_status = u.i;
6599 p->raw_status_new = 1;
6601 /* If process has terminated, stop waiting for its output. */
6602 if ((WIFSIGNALED (w) || WIFEXITED (w))
6603 && p->infd >= 0)
6604 clear_desc_flag = 1;
6606 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
6607 if (clear_desc_flag)
6609 FD_CLR (p->infd, &input_wait_mask);
6610 FD_CLR (p->infd, &non_keyboard_wait_mask);
6613 /* Tell wait_reading_process_output that it needs to wake up and
6614 look around. */
6615 if (input_available_clear_time)
6616 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
6619 /* There was no asynchronous process found for that pid: we have
6620 a synchronous process. */
6621 else
6623 synch_process_alive = 0;
6625 /* Report the status of the synchronous process. */
6626 if (WIFEXITED (w))
6627 synch_process_retcode = WRETCODE (w);
6628 else if (WIFSIGNALED (w))
6629 synch_process_termsig = WTERMSIG (w);
6631 /* Tell wait_reading_process_output that it needs to wake up and
6632 look around. */
6633 if (input_available_clear_time)
6634 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
6637 sigchld_end_of_loop:
6640 /* On some systems, we must return right away.
6641 If any more processes want to signal us, we will
6642 get another signal.
6643 Otherwise (on systems that have WNOHANG), loop around
6644 to use up all the processes that have something to tell us. */
6645 #if (defined WINDOWSNT \
6646 || (defined USG && !defined GNU_LINUX \
6647 && !(defined HPUX && defined WNOHANG)))
6648 #if defined (USG) && ! defined (POSIX_SIGNALS)
6649 signal (signo, sigchld_handler);
6650 #endif
6651 errno = old_errno;
6652 return;
6653 #endif /* USG, but not HPUX with WNOHANG */
6656 #endif /* SIGCHLD */
6659 static Lisp_Object
6660 exec_sentinel_unwind (data)
6661 Lisp_Object data;
6663 XPROCESS (XCAR (data))->sentinel = XCDR (data);
6664 return Qnil;
6667 static Lisp_Object
6668 exec_sentinel_error_handler (error)
6669 Lisp_Object error;
6671 cmd_error_internal (error, "error in process sentinel: ");
6672 Vinhibit_quit = Qt;
6673 update_echo_area ();
6674 Fsleep_for (make_number (2), Qnil);
6675 return Qt;
6678 static void
6679 exec_sentinel (proc, reason)
6680 Lisp_Object proc, reason;
6682 Lisp_Object sentinel, obuffer, odeactivate, okeymap;
6683 register struct Lisp_Process *p = XPROCESS (proc);
6684 int count = SPECPDL_INDEX ();
6685 int outer_running_asynch_code = running_asynch_code;
6686 int waiting = waiting_for_user_input_p;
6688 if (inhibit_sentinels)
6689 return;
6691 /* No need to gcpro these, because all we do with them later
6692 is test them for EQness, and none of them should be a string. */
6693 odeactivate = Vdeactivate_mark;
6694 XSETBUFFER (obuffer, current_buffer);
6695 okeymap = current_buffer->keymap;
6697 sentinel = p->sentinel;
6698 if (NILP (sentinel))
6699 return;
6701 /* Zilch the sentinel while it's running, to avoid recursive invocations;
6702 assure that it gets restored no matter how the sentinel exits. */
6703 p->sentinel = Qnil;
6704 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
6705 /* Inhibit quit so that random quits don't screw up a running filter. */
6706 specbind (Qinhibit_quit, Qt);
6707 specbind (Qlast_nonmenu_event, Qt);
6709 /* In case we get recursively called,
6710 and we already saved the match data nonrecursively,
6711 save the same match data in safely recursive fashion. */
6712 if (outer_running_asynch_code)
6714 Lisp_Object tem;
6715 tem = Fmatch_data (Qnil, Qnil, Qnil);
6716 restore_search_regs ();
6717 record_unwind_save_match_data ();
6718 Fset_match_data (tem, Qt);
6721 /* For speed, if a search happens within this code,
6722 save the match data in a special nonrecursive fashion. */
6723 running_asynch_code = 1;
6725 internal_condition_case_1 (read_process_output_call,
6726 Fcons (sentinel,
6727 Fcons (proc, Fcons (reason, Qnil))),
6728 !NILP (Vdebug_on_error) ? Qnil : Qerror,
6729 exec_sentinel_error_handler);
6731 /* If we saved the match data nonrecursively, restore it now. */
6732 restore_search_regs ();
6733 running_asynch_code = outer_running_asynch_code;
6735 Vdeactivate_mark = odeactivate;
6737 /* Restore waiting_for_user_input_p as it was
6738 when we were called, in case the filter clobbered it. */
6739 waiting_for_user_input_p = waiting;
6741 #if 0
6742 if (! EQ (Fcurrent_buffer (), obuffer)
6743 || ! EQ (current_buffer->keymap, okeymap))
6744 #endif
6745 /* But do it only if the caller is actually going to read events.
6746 Otherwise there's no need to make him wake up, and it could
6747 cause trouble (for example it would make sit_for return). */
6748 if (waiting_for_user_input_p == -1)
6749 record_asynch_buffer_change ();
6751 unbind_to (count, Qnil);
6754 /* Report all recent events of a change in process status
6755 (either run the sentinel or output a message).
6756 This is usually done while Emacs is waiting for keyboard input
6757 but can be done at other times. */
6759 static void
6760 status_notify (deleting_process)
6761 struct Lisp_Process *deleting_process;
6763 register Lisp_Object proc, buffer;
6764 Lisp_Object tail, msg;
6765 struct gcpro gcpro1, gcpro2;
6767 tail = Qnil;
6768 msg = Qnil;
6769 /* We need to gcpro tail; if read_process_output calls a filter
6770 which deletes a process and removes the cons to which tail points
6771 from Vprocess_alist, and then causes a GC, tail is an unprotected
6772 reference. */
6773 GCPRO2 (tail, msg);
6775 /* Set this now, so that if new processes are created by sentinels
6776 that we run, we get called again to handle their status changes. */
6777 update_tick = process_tick;
6779 for (tail = Vprocess_alist; !NILP (tail); tail = Fcdr (tail))
6781 Lisp_Object symbol;
6782 register struct Lisp_Process *p;
6784 proc = Fcdr (Fcar (tail));
6785 p = XPROCESS (proc);
6787 if (p->tick != p->update_tick)
6789 p->update_tick = p->tick;
6791 /* If process is still active, read any output that remains. */
6792 while (! EQ (p->filter, Qt)
6793 && ! EQ (p->status, Qconnect)
6794 && ! EQ (p->status, Qlisten)
6795 && ! EQ (p->command, Qt) /* Network process not stopped. */
6796 && p->infd >= 0
6797 && p != deleting_process
6798 && read_process_output (proc, p->infd) > 0);
6800 buffer = p->buffer;
6802 /* Get the text to use for the message. */
6803 if (p->raw_status_new)
6804 update_status (p);
6805 msg = status_message (p);
6807 /* If process is terminated, deactivate it or delete it. */
6808 symbol = p->status;
6809 if (CONSP (p->status))
6810 symbol = XCAR (p->status);
6812 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
6813 || EQ (symbol, Qclosed))
6815 if (delete_exited_processes)
6816 remove_process (proc);
6817 else
6818 deactivate_process (proc);
6821 /* The actions above may have further incremented p->tick.
6822 So set p->update_tick again
6823 so that an error in the sentinel will not cause
6824 this code to be run again. */
6825 p->update_tick = p->tick;
6826 /* Now output the message suitably. */
6827 if (!NILP (p->sentinel))
6828 exec_sentinel (proc, msg);
6829 /* Don't bother with a message in the buffer
6830 when a process becomes runnable. */
6831 else if (!EQ (symbol, Qrun) && !NILP (buffer))
6833 Lisp_Object ro, tem;
6834 struct buffer *old = current_buffer;
6835 int opoint, opoint_byte;
6836 int before, before_byte;
6838 ro = XBUFFER (buffer)->read_only;
6840 /* Avoid error if buffer is deleted
6841 (probably that's why the process is dead, too) */
6842 if (NILP (XBUFFER (buffer)->name))
6843 continue;
6844 Fset_buffer (buffer);
6846 opoint = PT;
6847 opoint_byte = PT_BYTE;
6848 /* Insert new output into buffer
6849 at the current end-of-output marker,
6850 thus preserving logical ordering of input and output. */
6851 if (XMARKER (p->mark)->buffer)
6852 Fgoto_char (p->mark);
6853 else
6854 SET_PT_BOTH (ZV, ZV_BYTE);
6856 before = PT;
6857 before_byte = PT_BYTE;
6859 tem = current_buffer->read_only;
6860 current_buffer->read_only = Qnil;
6861 insert_string ("\nProcess ");
6862 Finsert (1, &p->name);
6863 insert_string (" ");
6864 Finsert (1, &msg);
6865 current_buffer->read_only = tem;
6866 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
6868 if (opoint >= before)
6869 SET_PT_BOTH (opoint + (PT - before),
6870 opoint_byte + (PT_BYTE - before_byte));
6871 else
6872 SET_PT_BOTH (opoint, opoint_byte);
6874 set_buffer_internal (old);
6877 } /* end for */
6879 update_mode_lines++; /* in case buffers use %s in mode-line-format */
6880 redisplay_preserve_echo_area (13);
6882 UNGCPRO;
6886 DEFUN ("set-process-coding-system", Fset_process_coding_system,
6887 Sset_process_coding_system, 1, 3, 0,
6888 doc: /* Set coding systems of PROCESS to DECODING and ENCODING.
6889 DECODING will be used to decode subprocess output and ENCODING to
6890 encode subprocess input. */)
6891 (process, decoding, encoding)
6892 register Lisp_Object process, decoding, encoding;
6894 register struct Lisp_Process *p;
6896 CHECK_PROCESS (process);
6897 p = XPROCESS (process);
6898 if (p->infd < 0)
6899 error ("Input file descriptor of %s closed", SDATA (p->name));
6900 if (p->outfd < 0)
6901 error ("Output file descriptor of %s closed", SDATA (p->name));
6902 Fcheck_coding_system (decoding);
6903 Fcheck_coding_system (encoding);
6905 p->decode_coding_system = decoding;
6906 p->encode_coding_system = encoding;
6907 setup_process_coding_systems (process);
6909 return Qnil;
6912 DEFUN ("process-coding-system",
6913 Fprocess_coding_system, Sprocess_coding_system, 1, 1, 0,
6914 doc: /* Return a cons of coding systems for decoding and encoding of PROCESS. */)
6915 (process)
6916 register Lisp_Object process;
6918 CHECK_PROCESS (process);
6919 return Fcons (XPROCESS (process)->decode_coding_system,
6920 XPROCESS (process)->encode_coding_system);
6923 DEFUN ("set-process-filter-multibyte", Fset_process_filter_multibyte,
6924 Sset_process_filter_multibyte, 2, 2, 0,
6925 doc: /* Set multibyteness of the strings given to PROCESS's filter.
6926 If FLAG is non-nil, the filter is given multibyte strings.
6927 If FLAG is nil, the filter is given unibyte strings. In this case,
6928 all character code conversion except for end-of-line conversion is
6929 suppressed. */)
6930 (process, flag)
6931 Lisp_Object process, flag;
6933 register struct Lisp_Process *p;
6935 CHECK_PROCESS (process);
6936 p = XPROCESS (process);
6937 p->filter_multibyte = !NILP (flag);
6938 setup_process_coding_systems (process);
6940 return Qnil;
6943 DEFUN ("process-filter-multibyte-p", Fprocess_filter_multibyte_p,
6944 Sprocess_filter_multibyte_p, 1, 1, 0,
6945 doc: /* Return t if a multibyte string is given to PROCESS's filter.*/)
6946 (process)
6947 Lisp_Object process;
6949 register struct Lisp_Process *p;
6951 CHECK_PROCESS (process);
6952 p = XPROCESS (process);
6954 return (p->filter_multibyte ? Qt : Qnil);
6959 /* The first time this is called, assume keyboard input comes from DESC
6960 instead of from where we used to expect it.
6961 Subsequent calls mean assume input keyboard can come from DESC
6962 in addition to other places. */
6964 static int add_keyboard_wait_descriptor_called_flag;
6966 void
6967 add_keyboard_wait_descriptor (desc)
6968 int desc;
6970 if (! add_keyboard_wait_descriptor_called_flag)
6971 FD_CLR (0, &input_wait_mask);
6972 add_keyboard_wait_descriptor_called_flag = 1;
6973 FD_SET (desc, &input_wait_mask);
6974 FD_SET (desc, &non_process_wait_mask);
6975 if (desc > max_keyboard_desc)
6976 max_keyboard_desc = desc;
6979 static int add_gpm_wait_descriptor_called_flag;
6981 void
6982 add_gpm_wait_descriptor (desc)
6983 int desc;
6985 if (! add_gpm_wait_descriptor_called_flag)
6986 FD_CLR (0, &input_wait_mask);
6987 add_gpm_wait_descriptor_called_flag = 1;
6988 FD_SET (desc, &input_wait_mask);
6989 FD_SET (desc, &gpm_wait_mask);
6990 if (desc > max_gpm_desc)
6991 max_gpm_desc = desc;
6994 /* From now on, do not expect DESC to give keyboard input. */
6996 void
6997 delete_keyboard_wait_descriptor (desc)
6998 int desc;
7000 int fd;
7001 int lim = max_keyboard_desc;
7003 FD_CLR (desc, &input_wait_mask);
7004 FD_CLR (desc, &non_process_wait_mask);
7006 if (desc == max_keyboard_desc)
7007 for (fd = 0; fd < lim; fd++)
7008 if (FD_ISSET (fd, &input_wait_mask)
7009 && !FD_ISSET (fd, &non_keyboard_wait_mask)
7010 && !FD_ISSET (fd, &gpm_wait_mask))
7011 max_keyboard_desc = fd;
7014 void
7015 delete_gpm_wait_descriptor (desc)
7016 int desc;
7018 int fd;
7019 int lim = max_gpm_desc;
7021 FD_CLR (desc, &input_wait_mask);
7022 FD_CLR (desc, &non_process_wait_mask);
7024 if (desc == max_gpm_desc)
7025 for (fd = 0; fd < lim; fd++)
7026 if (FD_ISSET (fd, &input_wait_mask)
7027 && !FD_ISSET (fd, &non_keyboard_wait_mask)
7028 && !FD_ISSET (fd, &non_process_wait_mask))
7029 max_gpm_desc = fd;
7032 /* Return nonzero if *MASK has a bit set
7033 that corresponds to one of the keyboard input descriptors. */
7035 static int
7036 keyboard_bit_set (mask)
7037 SELECT_TYPE *mask;
7039 int fd;
7041 for (fd = 0; fd <= max_keyboard_desc; fd++)
7042 if (FD_ISSET (fd, mask) && FD_ISSET (fd, &input_wait_mask)
7043 && !FD_ISSET (fd, &non_keyboard_wait_mask))
7044 return 1;
7046 return 0;
7049 void
7050 init_process ()
7052 register int i;
7054 inhibit_sentinels = 0;
7056 #ifdef SIGCHLD
7057 #ifndef CANNOT_DUMP
7058 if (! noninteractive || initialized)
7059 #endif
7060 signal (SIGCHLD, sigchld_handler);
7061 #endif
7063 FD_ZERO (&input_wait_mask);
7064 FD_ZERO (&non_keyboard_wait_mask);
7065 FD_ZERO (&non_process_wait_mask);
7066 max_process_desc = 0;
7068 #ifdef NON_BLOCKING_CONNECT
7069 FD_ZERO (&connect_wait_mask);
7070 num_pending_connects = 0;
7071 #endif
7073 #ifdef ADAPTIVE_READ_BUFFERING
7074 process_output_delay_count = 0;
7075 process_output_skip = 0;
7076 #endif
7078 FD_SET (0, &input_wait_mask);
7080 Vprocess_alist = Qnil;
7081 #ifdef SIGCHLD
7082 deleted_pid_list = Qnil;
7083 #endif
7084 for (i = 0; i < MAXDESC; i++)
7086 chan_process[i] = Qnil;
7087 proc_buffered_char[i] = -1;
7089 bzero (proc_decode_coding_system, sizeof proc_decode_coding_system);
7090 bzero (proc_encode_coding_system, sizeof proc_encode_coding_system);
7091 #ifdef DATAGRAM_SOCKETS
7092 bzero (datagram_address, sizeof datagram_address);
7093 #endif
7095 #ifdef HAVE_SOCKETS
7097 Lisp_Object subfeatures = Qnil;
7098 struct socket_options *sopt;
7100 #define ADD_SUBFEATURE(key, val) \
7101 subfeatures = Fcons (Fcons (key, Fcons (val, Qnil)), subfeatures)
7103 #ifdef NON_BLOCKING_CONNECT
7104 ADD_SUBFEATURE (QCnowait, Qt);
7105 #endif
7106 #ifdef DATAGRAM_SOCKETS
7107 ADD_SUBFEATURE (QCtype, Qdatagram);
7108 #endif
7109 #ifdef HAVE_LOCAL_SOCKETS
7110 ADD_SUBFEATURE (QCfamily, Qlocal);
7111 #endif
7112 ADD_SUBFEATURE (QCfamily, Qipv4);
7113 #ifdef AF_INET6
7114 ADD_SUBFEATURE (QCfamily, Qipv6);
7115 #endif
7116 #ifdef HAVE_GETSOCKNAME
7117 ADD_SUBFEATURE (QCservice, Qt);
7118 #endif
7119 #if !defined(TERM) && (defined(O_NONBLOCK) || defined(O_NDELAY))
7120 ADD_SUBFEATURE (QCserver, Qt);
7121 #endif
7123 for (sopt = socket_options; sopt->name; sopt++)
7124 subfeatures = Fcons (intern (sopt->name), subfeatures);
7126 Fprovide (intern ("make-network-process"), subfeatures);
7128 #endif /* HAVE_SOCKETS */
7130 #if defined (DARWIN) || defined (MAC_OSX)
7131 /* PTYs are broken on Darwin < 6, but are sometimes useful for interactive
7132 processes. As such, we only change the default value. */
7133 if (initialized)
7135 char *release = get_operating_system_release();
7136 if (!release || !release[0] || (release[0] < MIN_PTY_KERNEL_VERSION
7137 && release[1] == '.')) {
7138 Vprocess_connection_type = Qnil;
7141 #endif
7144 void
7145 syms_of_process ()
7147 Qprocessp = intern ("processp");
7148 staticpro (&Qprocessp);
7149 Qrun = intern ("run");
7150 staticpro (&Qrun);
7151 Qstop = intern ("stop");
7152 staticpro (&Qstop);
7153 Qsignal = intern ("signal");
7154 staticpro (&Qsignal);
7156 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
7157 here again.
7159 Qexit = intern ("exit");
7160 staticpro (&Qexit); */
7162 Qopen = intern ("open");
7163 staticpro (&Qopen);
7164 Qclosed = intern ("closed");
7165 staticpro (&Qclosed);
7166 Qconnect = intern ("connect");
7167 staticpro (&Qconnect);
7168 Qfailed = intern ("failed");
7169 staticpro (&Qfailed);
7170 Qlisten = intern ("listen");
7171 staticpro (&Qlisten);
7172 Qlocal = intern ("local");
7173 staticpro (&Qlocal);
7174 Qipv4 = intern ("ipv4");
7175 staticpro (&Qipv4);
7176 #ifdef AF_INET6
7177 Qipv6 = intern ("ipv6");
7178 staticpro (&Qipv6);
7179 #endif
7180 Qdatagram = intern ("datagram");
7181 staticpro (&Qdatagram);
7183 QCname = intern (":name");
7184 staticpro (&QCname);
7185 QCbuffer = intern (":buffer");
7186 staticpro (&QCbuffer);
7187 QChost = intern (":host");
7188 staticpro (&QChost);
7189 QCservice = intern (":service");
7190 staticpro (&QCservice);
7191 QCtype = intern (":type");
7192 staticpro (&QCtype);
7193 QClocal = intern (":local");
7194 staticpro (&QClocal);
7195 QCremote = intern (":remote");
7196 staticpro (&QCremote);
7197 QCcoding = intern (":coding");
7198 staticpro (&QCcoding);
7199 QCserver = intern (":server");
7200 staticpro (&QCserver);
7201 QCnowait = intern (":nowait");
7202 staticpro (&QCnowait);
7203 QCsentinel = intern (":sentinel");
7204 staticpro (&QCsentinel);
7205 QClog = intern (":log");
7206 staticpro (&QClog);
7207 QCnoquery = intern (":noquery");
7208 staticpro (&QCnoquery);
7209 QCstop = intern (":stop");
7210 staticpro (&QCstop);
7211 QCoptions = intern (":options");
7212 staticpro (&QCoptions);
7213 QCplist = intern (":plist");
7214 staticpro (&QCplist);
7215 QCfilter_multibyte = intern (":filter-multibyte");
7216 staticpro (&QCfilter_multibyte);
7218 Qlast_nonmenu_event = intern ("last-nonmenu-event");
7219 staticpro (&Qlast_nonmenu_event);
7221 staticpro (&Vprocess_alist);
7222 #ifdef SIGCHLD
7223 staticpro (&deleted_pid_list);
7224 #endif
7226 DEFVAR_BOOL ("delete-exited-processes", &delete_exited_processes,
7227 doc: /* *Non-nil means delete processes immediately when they exit.
7228 A value of nil means don't delete them until `list-processes' is run. */);
7230 delete_exited_processes = 1;
7232 DEFVAR_LISP ("process-connection-type", &Vprocess_connection_type,
7233 doc: /* Control type of device used to communicate with subprocesses.
7234 Values are nil to use a pipe, or t or `pty' to use a pty.
7235 The value has no effect if the system has no ptys or if all ptys are busy:
7236 then a pipe is used in any case.
7237 The value takes effect when `start-process' is called. */);
7238 Vprocess_connection_type = Qt;
7240 #ifdef ADAPTIVE_READ_BUFFERING
7241 DEFVAR_LISP ("process-adaptive-read-buffering", &Vprocess_adaptive_read_buffering,
7242 doc: /* If non-nil, improve receive buffering by delaying after short reads.
7243 On some systems, when Emacs reads the output from a subprocess, the output data
7244 is read in very small blocks, potentially resulting in very poor performance.
7245 This behavior can be remedied to some extent by setting this variable to a
7246 non-nil value, as it will automatically delay reading from such processes, to
7247 allow them to produce more output before Emacs tries to read it.
7248 If the value is t, the delay is reset after each write to the process; any other
7249 non-nil value means that the delay is not reset on write.
7250 The variable takes effect when `start-process' is called. */);
7251 Vprocess_adaptive_read_buffering = Qt;
7252 #endif
7254 defsubr (&Sprocessp);
7255 defsubr (&Sget_process);
7256 defsubr (&Sget_buffer_process);
7257 defsubr (&Sdelete_process);
7258 defsubr (&Sprocess_status);
7259 defsubr (&Sprocess_exit_status);
7260 defsubr (&Sprocess_id);
7261 defsubr (&Sprocess_name);
7262 defsubr (&Sprocess_tty_name);
7263 defsubr (&Sprocess_command);
7264 defsubr (&Sset_process_buffer);
7265 defsubr (&Sprocess_buffer);
7266 defsubr (&Sprocess_mark);
7267 defsubr (&Sset_process_filter);
7268 defsubr (&Sprocess_filter);
7269 defsubr (&Sset_process_sentinel);
7270 defsubr (&Sprocess_sentinel);
7271 defsubr (&Sset_process_window_size);
7272 defsubr (&Sset_process_inherit_coding_system_flag);
7273 defsubr (&Sprocess_inherit_coding_system_flag);
7274 defsubr (&Sset_process_query_on_exit_flag);
7275 defsubr (&Sprocess_query_on_exit_flag);
7276 defsubr (&Sprocess_contact);
7277 defsubr (&Sprocess_plist);
7278 defsubr (&Sset_process_plist);
7279 defsubr (&Slist_processes);
7280 defsubr (&Sprocess_list);
7281 defsubr (&Sstart_process);
7282 #ifdef HAVE_SOCKETS
7283 defsubr (&Sset_network_process_option);
7284 defsubr (&Smake_network_process);
7285 defsubr (&Sformat_network_address);
7286 #endif /* HAVE_SOCKETS */
7287 #if defined(HAVE_SOCKETS) && defined(HAVE_NET_IF_H) && defined(HAVE_SYS_IOCTL_H)
7288 #ifdef SIOCGIFCONF
7289 defsubr (&Snetwork_interface_list);
7290 #endif
7291 #if defined(SIOCGIFADDR) || defined(SIOCGIFHWADDR) || defined(SIOCGIFFLAGS)
7292 defsubr (&Snetwork_interface_info);
7293 #endif
7294 #endif /* HAVE_SOCKETS ... */
7295 #ifdef DATAGRAM_SOCKETS
7296 defsubr (&Sprocess_datagram_address);
7297 defsubr (&Sset_process_datagram_address);
7298 #endif
7299 defsubr (&Saccept_process_output);
7300 defsubr (&Sprocess_send_region);
7301 defsubr (&Sprocess_send_string);
7302 defsubr (&Sinterrupt_process);
7303 defsubr (&Skill_process);
7304 defsubr (&Squit_process);
7305 defsubr (&Sstop_process);
7306 defsubr (&Scontinue_process);
7307 defsubr (&Sprocess_running_child_p);
7308 defsubr (&Sprocess_send_eof);
7309 defsubr (&Ssignal_process);
7310 defsubr (&Swaiting_for_user_input_p);
7311 /* defsubr (&Sprocess_connection); */
7312 defsubr (&Sset_process_coding_system);
7313 defsubr (&Sprocess_coding_system);
7314 defsubr (&Sset_process_filter_multibyte);
7315 defsubr (&Sprocess_filter_multibyte_p);
7319 #else /* not subprocesses */
7321 #include <sys/types.h>
7322 #include <errno.h>
7324 #include "lisp.h"
7325 #include "systime.h"
7326 #include "charset.h"
7327 #include "coding.h"
7328 #include "termopts.h"
7329 #include "sysselect.h"
7331 extern int frame_garbaged;
7333 extern EMACS_TIME timer_check ();
7334 extern int timers_run;
7336 Lisp_Object QCtype;
7338 /* As described above, except assuming that there are no subprocesses:
7340 Wait for timeout to elapse and/or keyboard input to be available.
7342 time_limit is:
7343 timeout in seconds, or
7344 zero for no limit, or
7345 -1 means gobble data immediately available but don't wait for any.
7347 read_kbd is a Lisp_Object:
7348 0 to ignore keyboard input, or
7349 1 to return when input is available, or
7350 -1 means caller will actually read the input, so don't throw to
7351 the quit handler.
7353 see full version for other parameters. We know that wait_proc will
7354 always be NULL, since `subprocesses' isn't defined.
7356 do_display != 0 means redisplay should be done to show subprocess
7357 output that arrives.
7359 Return true iff we received input from any process. */
7362 wait_reading_process_output (time_limit, microsecs, read_kbd, do_display,
7363 wait_for_cell, wait_proc, just_wait_proc)
7364 int time_limit, microsecs, read_kbd, do_display;
7365 Lisp_Object wait_for_cell;
7366 struct Lisp_Process *wait_proc;
7367 int just_wait_proc;
7369 register int nfds;
7370 EMACS_TIME end_time, timeout;
7371 SELECT_TYPE waitchannels;
7372 int xerrno;
7374 /* What does time_limit really mean? */
7375 if (time_limit || microsecs)
7377 EMACS_GET_TIME (end_time);
7378 EMACS_SET_SECS_USECS (timeout, time_limit, microsecs);
7379 EMACS_ADD_TIME (end_time, end_time, timeout);
7382 /* Turn off periodic alarms (in case they are in use)
7383 and then turn off any other atimers,
7384 because the select emulator uses alarms. */
7385 stop_polling ();
7386 turn_on_atimers (0);
7388 while (1)
7390 int timeout_reduced_for_timers = 0;
7392 /* If calling from keyboard input, do not quit
7393 since we want to return C-g as an input character.
7394 Otherwise, do pending quit if requested. */
7395 if (read_kbd >= 0)
7396 QUIT;
7398 /* Exit now if the cell we're waiting for became non-nil. */
7399 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
7400 break;
7402 /* Compute time from now till when time limit is up */
7403 /* Exit if already run out */
7404 if (time_limit == -1)
7406 /* -1 specified for timeout means
7407 gobble output available now
7408 but don't wait at all. */
7410 EMACS_SET_SECS_USECS (timeout, 0, 0);
7412 else if (time_limit || microsecs)
7414 EMACS_GET_TIME (timeout);
7415 EMACS_SUB_TIME (timeout, end_time, timeout);
7416 if (EMACS_TIME_NEG_P (timeout))
7417 break;
7419 else
7421 EMACS_SET_SECS_USECS (timeout, 100000, 0);
7424 /* If our caller will not immediately handle keyboard events,
7425 run timer events directly.
7426 (Callers that will immediately read keyboard events
7427 call timer_delay on their own.) */
7428 if (NILP (wait_for_cell))
7430 EMACS_TIME timer_delay;
7434 int old_timers_run = timers_run;
7435 timer_delay = timer_check (1);
7436 if (timers_run != old_timers_run && do_display)
7437 /* We must retry, since a timer may have requeued itself
7438 and that could alter the time delay. */
7439 redisplay_preserve_echo_area (14);
7440 else
7441 break;
7443 while (!detect_input_pending ());
7445 /* If there is unread keyboard input, also return. */
7446 if (read_kbd != 0
7447 && requeued_events_pending_p ())
7448 break;
7450 if (! EMACS_TIME_NEG_P (timer_delay) && time_limit != -1)
7452 EMACS_TIME difference;
7453 EMACS_SUB_TIME (difference, timer_delay, timeout);
7454 if (EMACS_TIME_NEG_P (difference))
7456 timeout = timer_delay;
7457 timeout_reduced_for_timers = 1;
7462 /* Cause C-g and alarm signals to take immediate action,
7463 and cause input available signals to zero out timeout. */
7464 if (read_kbd < 0)
7465 set_waiting_for_input (&timeout);
7467 /* Wait till there is something to do. */
7469 if (! read_kbd && NILP (wait_for_cell))
7470 FD_ZERO (&waitchannels);
7471 else
7472 FD_SET (0, &waitchannels);
7474 /* If a frame has been newly mapped and needs updating,
7475 reprocess its display stuff. */
7476 if (frame_garbaged && do_display)
7478 clear_waiting_for_input ();
7479 redisplay_preserve_echo_area (15);
7480 if (read_kbd < 0)
7481 set_waiting_for_input (&timeout);
7484 if (read_kbd && detect_input_pending ())
7486 nfds = 0;
7487 FD_ZERO (&waitchannels);
7489 else
7490 nfds = select (1, &waitchannels, (SELECT_TYPE *)0, (SELECT_TYPE *)0,
7491 &timeout);
7493 xerrno = errno;
7495 /* Make C-g and alarm signals set flags again */
7496 clear_waiting_for_input ();
7498 /* If we woke up due to SIGWINCH, actually change size now. */
7499 do_pending_window_change (0);
7501 if (time_limit && nfds == 0 && ! timeout_reduced_for_timers)
7502 /* We waited the full specified time, so return now. */
7503 break;
7505 if (nfds == -1)
7507 /* If the system call was interrupted, then go around the
7508 loop again. */
7509 if (xerrno == EINTR)
7510 FD_ZERO (&waitchannels);
7511 else
7512 error ("select error: %s", emacs_strerror (xerrno));
7514 #ifdef sun
7515 else if (nfds > 0 && (waitchannels & 1) && interrupt_input)
7516 /* System sometimes fails to deliver SIGIO. */
7517 kill (getpid (), SIGIO);
7518 #endif
7519 #ifdef SIGIO
7520 if (read_kbd && interrupt_input && (waitchannels & 1))
7521 kill (getpid (), SIGIO);
7522 #endif
7524 /* Check for keyboard input */
7526 if (read_kbd
7527 && detect_input_pending_run_timers (do_display))
7529 swallow_events (do_display);
7530 if (detect_input_pending_run_timers (do_display))
7531 break;
7534 /* If there is unread keyboard input, also return. */
7535 if (read_kbd
7536 && requeued_events_pending_p ())
7537 break;
7539 /* If wait_for_cell. check for keyboard input
7540 but don't run any timers.
7541 ??? (It seems wrong to me to check for keyboard
7542 input at all when wait_for_cell, but the code
7543 has been this way since July 1994.
7544 Try changing this after version 19.31.) */
7545 if (! NILP (wait_for_cell)
7546 && detect_input_pending ())
7548 swallow_events (do_display);
7549 if (detect_input_pending ())
7550 break;
7553 /* Exit now if the cell we're waiting for became non-nil. */
7554 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
7555 break;
7558 start_polling ();
7560 return 0;
7564 /* Don't confuse make-docfile by having two doc strings for this function.
7565 make-docfile does not pay attention to #if, for good reason! */
7566 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
7568 (name)
7569 register Lisp_Object name;
7571 return Qnil;
7574 /* Don't confuse make-docfile by having two doc strings for this function.
7575 make-docfile does not pay attention to #if, for good reason! */
7576 DEFUN ("process-inherit-coding-system-flag",
7577 Fprocess_inherit_coding_system_flag, Sprocess_inherit_coding_system_flag,
7578 1, 1, 0,
7580 (process)
7581 register Lisp_Object process;
7583 /* Ignore the argument and return the value of
7584 inherit-process-coding-system. */
7585 return inherit_process_coding_system ? Qt : Qnil;
7588 /* Kill all processes associated with `buffer'.
7589 If `buffer' is nil, kill all processes.
7590 Since we have no subprocesses, this does nothing. */
7592 void
7593 kill_buffer_processes (buffer)
7594 Lisp_Object buffer;
7598 void
7599 init_process ()
7603 void
7604 syms_of_process ()
7606 QCtype = intern (":type");
7607 staticpro (&QCtype);
7609 defsubr (&Sget_buffer_process);
7610 defsubr (&Sprocess_inherit_coding_system_flag);
7614 #endif /* not subprocesses */
7616 /* arch-tag: 3706c011-7b9a-4117-bd4f-59e7f701a4c4
7617 (do not change this comment) */