Support higher-resolution time stamps.
[emacs.git] / src / process.c
blob0ee0e499d6e8e4a48a1aaf28ed808655808fc5a9
1 /* Asynchronous subprocess control for GNU Emacs.
3 Copyright (C) 1985-1988, 1993-1996, 1998-1999, 2001-2012
4 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 of the License, or
11 (at your option) 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. If not, see <http://www.gnu.org/licenses/>. */
22 #include <config.h>
23 #include <signal.h>
24 #include <stdio.h>
25 #include <errno.h>
26 #include <setjmp.h>
27 #include <sys/types.h> /* Some typedefs are used in sys/file.h. */
28 #include <sys/file.h>
29 #include <sys/stat.h>
30 #include <setjmp.h>
32 #include <unistd.h>
33 #include <fcntl.h>
35 #include "lisp.h"
37 /* Only MS-DOS does not define `subprocesses'. */
38 #ifdef subprocesses
40 #include <sys/socket.h>
41 #include <netdb.h>
42 #include <netinet/in.h>
43 #include <arpa/inet.h>
45 /* Are local (unix) sockets supported? */
46 #if defined (HAVE_SYS_UN_H)
47 #if !defined (AF_LOCAL) && defined (AF_UNIX)
48 #define AF_LOCAL AF_UNIX
49 #endif
50 #ifdef AF_LOCAL
51 #define HAVE_LOCAL_SOCKETS
52 #include <sys/un.h>
53 #endif
54 #endif
56 #include <sys/ioctl.h>
57 #if defined (HAVE_NET_IF_H)
58 #include <net/if.h>
59 #endif /* HAVE_NET_IF_H */
61 #if defined (HAVE_IFADDRS_H)
62 /* Must be after net/if.h */
63 #include <ifaddrs.h>
65 /* We only use structs from this header when we use getifaddrs. */
66 #if defined (HAVE_NET_IF_DL_H)
67 #include <net/if_dl.h>
68 #endif
70 #endif
72 #ifdef NEED_BSDTTY
73 #include <bsdtty.h>
74 #endif
76 #ifdef HAVE_RES_INIT
77 #include <netinet/in.h>
78 #include <arpa/nameser.h>
79 #include <resolv.h>
80 #endif
82 #ifdef HAVE_UTIL_H
83 #include <util.h>
84 #endif
86 #ifdef HAVE_PTY_H
87 #include <pty.h>
88 #endif
90 #endif /* subprocesses */
92 #include "systime.h"
93 #include "systty.h"
95 #include "window.h"
96 #include "character.h"
97 #include "buffer.h"
98 #include "coding.h"
99 #include "process.h"
100 #include "frame.h"
101 #include "termhooks.h"
102 #include "termopts.h"
103 #include "commands.h"
104 #include "keyboard.h"
105 #include "blockinput.h"
106 #include "dispextern.h"
107 #include "composite.h"
108 #include "atimer.h"
109 #include "sysselect.h"
110 #include "syssignal.h"
111 #include "syswait.h"
112 #ifdef HAVE_GNUTLS
113 #include "gnutls.h"
114 #endif
116 #if defined (USE_GTK) || defined (HAVE_GCONF) || defined (HAVE_GSETTINGS)
117 #include "xgselect.h"
118 #endif
119 #ifdef HAVE_NS
120 #include "nsterm.h"
121 #endif
123 /* Work around GCC 4.7.0 bug with strict overflow checking; see
124 <http://gcc.gnu.org/bugzilla/show_bug.cgi?id=52904>.
125 These lines can be removed once the GCC bug is fixed. */
126 #if (__GNUC__ == 4 && 3 <= __GNUC_MINOR__) || 4 < __GNUC__
127 # pragma GCC diagnostic ignored "-Wstrict-overflow"
128 #endif
130 Lisp_Object Qeuid, Qegid, Qcomm, Qstate, Qppid, Qpgrp, Qsess, Qttname, Qtpgid;
131 Lisp_Object Qminflt, Qmajflt, Qcminflt, Qcmajflt, Qutime, Qstime, Qcstime;
132 Lisp_Object Qcutime, Qpri, Qnice, Qthcount, Qstart, Qvsize, Qrss, Qargs;
133 Lisp_Object Quser, Qgroup, Qetime, Qpcpu, Qpmem, Qtime, Qctime;
134 Lisp_Object QCname, QCtype;
136 /* Non-zero if keyboard input is on hold, zero otherwise. */
138 static int kbd_is_on_hold;
140 /* Nonzero means don't run process sentinels. This is used
141 when exiting. */
142 int inhibit_sentinels;
144 #ifdef subprocesses
146 Lisp_Object Qprocessp;
147 static Lisp_Object Qrun, Qstop, Qsignal;
148 static Lisp_Object Qopen, Qclosed, Qconnect, Qfailed, Qlisten;
149 Lisp_Object Qlocal;
150 static Lisp_Object Qipv4, Qdatagram, Qseqpacket;
151 static Lisp_Object Qreal, Qnetwork, Qserial;
152 #ifdef AF_INET6
153 static Lisp_Object Qipv6;
154 #endif
155 static Lisp_Object QCport, QCprocess;
156 Lisp_Object QCspeed;
157 Lisp_Object QCbytesize, QCstopbits, QCparity, Qodd, Qeven;
158 Lisp_Object QCflowcontrol, Qhw, Qsw, QCsummary;
159 static Lisp_Object QCbuffer, QChost, QCservice;
160 static Lisp_Object QClocal, QCremote, QCcoding;
161 static Lisp_Object QCserver, QCnowait, QCnoquery, QCstop;
162 static Lisp_Object QCsentinel, QClog, QCoptions, QCplist;
163 static Lisp_Object Qlast_nonmenu_event;
164 /* QCfamily is declared and initialized in xfaces.c,
165 QCfilter in keyboard.c. */
166 extern Lisp_Object QCfamily, QCfilter;
168 /* Qexit is declared and initialized in eval.c. */
170 /* QCfamily is defined in xfaces.c. */
171 extern Lisp_Object QCfamily;
172 /* QCfilter is defined in keyboard.c. */
173 extern Lisp_Object QCfilter;
175 #define NETCONN_P(p) (EQ (XPROCESS (p)->type, Qnetwork))
176 #define NETCONN1_P(p) (EQ ((p)->type, Qnetwork))
177 #define SERIALCONN_P(p) (EQ (XPROCESS (p)->type, Qserial))
178 #define SERIALCONN1_P(p) (EQ ((p)->type, Qserial))
180 #ifndef HAVE_H_ERRNO
181 extern int h_errno;
182 #endif
184 /* Number of events of change of status of a process. */
185 static EMACS_INT process_tick;
186 /* Number of events for which the user or sentinel has been notified. */
187 static EMACS_INT update_tick;
189 /* Define NON_BLOCKING_CONNECT if we can support non-blocking connects. */
191 /* Only W32 has this, it really means that select can't take write mask. */
192 #ifdef BROKEN_NON_BLOCKING_CONNECT
193 #undef NON_BLOCKING_CONNECT
194 #define SELECT_CANT_DO_WRITE_MASK
195 #else
196 #ifndef NON_BLOCKING_CONNECT
197 #ifdef HAVE_SELECT
198 #if defined (HAVE_GETPEERNAME) || defined (GNU_LINUX)
199 #if defined (O_NONBLOCK) || defined (O_NDELAY)
200 #if defined (EWOULDBLOCK) || defined (EINPROGRESS)
201 #define NON_BLOCKING_CONNECT
202 #endif /* EWOULDBLOCK || EINPROGRESS */
203 #endif /* O_NONBLOCK || O_NDELAY */
204 #endif /* HAVE_GETPEERNAME || GNU_LINUX */
205 #endif /* HAVE_SELECT */
206 #endif /* NON_BLOCKING_CONNECT */
207 #endif /* BROKEN_NON_BLOCKING_CONNECT */
209 /* Define DATAGRAM_SOCKETS if datagrams can be used safely on
210 this system. We need to read full packets, so we need a
211 "non-destructive" select. So we require either native select,
212 or emulation of select using FIONREAD. */
214 #ifdef BROKEN_DATAGRAM_SOCKETS
215 #undef DATAGRAM_SOCKETS
216 #else
217 #ifndef DATAGRAM_SOCKETS
218 #if defined (HAVE_SELECT) || defined (FIONREAD)
219 #if defined (HAVE_SENDTO) && defined (HAVE_RECVFROM) && defined (EMSGSIZE)
220 #define DATAGRAM_SOCKETS
221 #endif /* HAVE_SENDTO && HAVE_RECVFROM && EMSGSIZE */
222 #endif /* HAVE_SELECT || FIONREAD */
223 #endif /* DATAGRAM_SOCKETS */
224 #endif /* BROKEN_DATAGRAM_SOCKETS */
226 #if defined HAVE_LOCAL_SOCKETS && defined DATAGRAM_SOCKETS
227 # define HAVE_SEQPACKET
228 #endif
230 #if !defined (ADAPTIVE_READ_BUFFERING) && !defined (NO_ADAPTIVE_READ_BUFFERING)
231 #define ADAPTIVE_READ_BUFFERING
232 #endif
234 #ifdef ADAPTIVE_READ_BUFFERING
235 #define READ_OUTPUT_DELAY_INCREMENT (EMACS_TIME_RESOLUTION / 100)
236 #define READ_OUTPUT_DELAY_MAX (READ_OUTPUT_DELAY_INCREMENT * 5)
237 #define READ_OUTPUT_DELAY_MAX_MAX (READ_OUTPUT_DELAY_INCREMENT * 7)
239 /* Number of processes which have a non-zero read_output_delay,
240 and therefore might be delayed for adaptive read buffering. */
242 static int process_output_delay_count;
244 /* Non-zero if any process has non-nil read_output_skip. */
246 static int process_output_skip;
248 #else
249 #define process_output_delay_count 0
250 #endif
252 static Lisp_Object Fget_process (Lisp_Object);
253 static void create_process (Lisp_Object, char **, Lisp_Object);
254 #ifdef SIGIO
255 static int keyboard_bit_set (SELECT_TYPE *);
256 #endif
257 static void deactivate_process (Lisp_Object);
258 static void status_notify (struct Lisp_Process *);
259 static int read_process_output (Lisp_Object, int);
260 static void create_pty (Lisp_Object);
262 /* If we support a window system, turn on the code to poll periodically
263 to detect C-g. It isn't actually used when doing interrupt input. */
264 #if defined (HAVE_WINDOW_SYSTEM) && !defined (USE_ASYNC_EVENTS)
265 #define POLL_FOR_INPUT
266 #endif
268 static Lisp_Object get_process (register Lisp_Object name);
269 static void exec_sentinel (Lisp_Object proc, Lisp_Object reason);
271 /* Mask of bits indicating the descriptors that we wait for input on. */
273 static SELECT_TYPE input_wait_mask;
275 /* Mask that excludes keyboard input descriptor(s). */
277 static SELECT_TYPE non_keyboard_wait_mask;
279 /* Mask that excludes process input descriptor(s). */
281 static SELECT_TYPE non_process_wait_mask;
283 /* Mask for selecting for write. */
285 static SELECT_TYPE write_mask;
287 #ifdef NON_BLOCKING_CONNECT
288 /* Mask of bits indicating the descriptors that we wait for connect to
289 complete on. Once they complete, they are removed from this mask
290 and added to the input_wait_mask and non_keyboard_wait_mask. */
292 static SELECT_TYPE connect_wait_mask;
294 /* Number of bits set in connect_wait_mask. */
295 static int num_pending_connects;
296 #endif /* NON_BLOCKING_CONNECT */
298 /* The largest descriptor currently in use for a process object. */
299 static int max_process_desc;
301 /* The largest descriptor currently in use for input. */
302 static int max_input_desc;
304 /* Indexed by descriptor, gives the process (if any) for that descriptor */
305 static Lisp_Object chan_process[MAXDESC];
307 /* Alist of elements (NAME . PROCESS) */
308 static Lisp_Object Vprocess_alist;
310 /* Buffered-ahead input char from process, indexed by channel.
311 -1 means empty (no char is buffered).
312 Used on sys V where the only way to tell if there is any
313 output from the process is to read at least one char.
314 Always -1 on systems that support FIONREAD. */
316 static int proc_buffered_char[MAXDESC];
318 /* Table of `struct coding-system' for each process. */
319 static struct coding_system *proc_decode_coding_system[MAXDESC];
320 static struct coding_system *proc_encode_coding_system[MAXDESC];
322 #ifdef DATAGRAM_SOCKETS
323 /* Table of `partner address' for datagram sockets. */
324 static struct sockaddr_and_len {
325 struct sockaddr *sa;
326 int len;
327 } datagram_address[MAXDESC];
328 #define DATAGRAM_CHAN_P(chan) (datagram_address[chan].sa != 0)
329 #define DATAGRAM_CONN_P(proc) (PROCESSP (proc) && datagram_address[XPROCESS (proc)->infd].sa != 0)
330 #else
331 #define DATAGRAM_CHAN_P(chan) (0)
332 #define DATAGRAM_CONN_P(proc) (0)
333 #endif
335 /* Maximum number of bytes to send to a pty without an eof. */
336 static int pty_max_bytes;
340 static struct fd_callback_data
342 fd_callback func;
343 void *data;
344 #define FOR_READ 1
345 #define FOR_WRITE 2
346 int condition; /* mask of the defines above. */
347 } fd_callback_info[MAXDESC];
350 /* Add a file descriptor FD to be monitored for when read is possible.
351 When read is possible, call FUNC with argument DATA. */
353 void
354 add_read_fd (int fd, fd_callback func, void *data)
356 xassert (fd < MAXDESC);
357 add_keyboard_wait_descriptor (fd);
359 fd_callback_info[fd].func = func;
360 fd_callback_info[fd].data = data;
361 fd_callback_info[fd].condition |= FOR_READ;
364 /* Stop monitoring file descriptor FD for when read is possible. */
366 void
367 delete_read_fd (int fd)
369 xassert (fd < MAXDESC);
370 delete_keyboard_wait_descriptor (fd);
372 fd_callback_info[fd].condition &= ~FOR_READ;
373 if (fd_callback_info[fd].condition == 0)
375 fd_callback_info[fd].func = 0;
376 fd_callback_info[fd].data = 0;
380 /* Add a file descriptor FD to be monitored for when write is possible.
381 When write is possible, call FUNC with argument DATA. */
383 void
384 add_write_fd (int fd, fd_callback func, void *data)
386 xassert (fd < MAXDESC);
387 FD_SET (fd, &write_mask);
388 if (fd > max_input_desc)
389 max_input_desc = fd;
391 fd_callback_info[fd].func = func;
392 fd_callback_info[fd].data = data;
393 fd_callback_info[fd].condition |= FOR_WRITE;
396 /* Stop monitoring file descriptor FD for when write is possible. */
398 void
399 delete_write_fd (int fd)
401 int lim = max_input_desc;
403 xassert (fd < MAXDESC);
404 FD_CLR (fd, &write_mask);
405 fd_callback_info[fd].condition &= ~FOR_WRITE;
406 if (fd_callback_info[fd].condition == 0)
408 fd_callback_info[fd].func = 0;
409 fd_callback_info[fd].data = 0;
411 if (fd == max_input_desc)
412 for (fd = lim; fd >= 0; fd--)
413 if (FD_ISSET (fd, &input_wait_mask) || FD_ISSET (fd, &write_mask))
415 max_input_desc = fd;
416 break;
423 /* Compute the Lisp form of the process status, p->status, from
424 the numeric status that was returned by `wait'. */
426 static Lisp_Object status_convert (int);
428 static void
429 update_status (struct Lisp_Process *p)
431 eassert (p->raw_status_new);
432 p->status = status_convert (p->raw_status);
433 p->raw_status_new = 0;
436 /* Convert a process status word in Unix format to
437 the list that we use internally. */
439 static Lisp_Object
440 status_convert (int w)
442 if (WIFSTOPPED (w))
443 return Fcons (Qstop, Fcons (make_number (WSTOPSIG (w)), Qnil));
444 else if (WIFEXITED (w))
445 return Fcons (Qexit, Fcons (make_number (WRETCODE (w)),
446 WCOREDUMP (w) ? Qt : Qnil));
447 else if (WIFSIGNALED (w))
448 return Fcons (Qsignal, Fcons (make_number (WTERMSIG (w)),
449 WCOREDUMP (w) ? Qt : Qnil));
450 else
451 return Qrun;
454 /* Given a status-list, extract the three pieces of information
455 and store them individually through the three pointers. */
457 static void
458 decode_status (Lisp_Object l, Lisp_Object *symbol, int *code, int *coredump)
460 Lisp_Object tem;
462 if (SYMBOLP (l))
464 *symbol = l;
465 *code = 0;
466 *coredump = 0;
468 else
470 *symbol = XCAR (l);
471 tem = XCDR (l);
472 *code = XFASTINT (XCAR (tem));
473 tem = XCDR (tem);
474 *coredump = !NILP (tem);
478 /* Return a string describing a process status list. */
480 static Lisp_Object
481 status_message (struct Lisp_Process *p)
483 Lisp_Object status = p->status;
484 Lisp_Object symbol;
485 int code, coredump;
486 Lisp_Object string, string2;
488 decode_status (status, &symbol, &code, &coredump);
490 if (EQ (symbol, Qsignal) || EQ (symbol, Qstop))
492 char *signame;
493 synchronize_system_messages_locale ();
494 signame = strsignal (code);
495 if (signame == 0)
496 string = build_string ("unknown");
497 else
499 int c1, c2;
501 string = make_unibyte_string (signame, strlen (signame));
502 if (! NILP (Vlocale_coding_system))
503 string = (code_convert_string_norecord
504 (string, Vlocale_coding_system, 0));
505 c1 = STRING_CHAR (SDATA (string));
506 c2 = downcase (c1);
507 if (c1 != c2)
508 Faset (string, make_number (0), make_number (c2));
510 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
511 return concat2 (string, string2);
513 else if (EQ (symbol, Qexit))
515 if (NETCONN1_P (p))
516 return build_string (code == 0 ? "deleted\n" : "connection broken by remote peer\n");
517 if (code == 0)
518 return build_string ("finished\n");
519 string = Fnumber_to_string (make_number (code));
520 string2 = build_string (coredump ? " (core dumped)\n" : "\n");
521 return concat3 (build_string ("exited abnormally with code "),
522 string, string2);
524 else if (EQ (symbol, Qfailed))
526 string = Fnumber_to_string (make_number (code));
527 string2 = build_string ("\n");
528 return concat3 (build_string ("failed with code "),
529 string, string2);
531 else
532 return Fcopy_sequence (Fsymbol_name (symbol));
535 #ifdef HAVE_PTYS
537 /* The file name of the pty opened by allocate_pty. */
538 static char pty_name[24];
540 /* Open an available pty, returning a file descriptor.
541 Return -1 on failure.
542 The file name of the terminal corresponding to the pty
543 is left in the variable pty_name. */
545 static int
546 allocate_pty (void)
548 int fd;
550 #ifdef PTY_ITERATION
551 PTY_ITERATION
552 #else
553 register int c, i;
554 for (c = FIRST_PTY_LETTER; c <= 'z'; c++)
555 for (i = 0; i < 16; i++)
556 #endif
558 #ifdef PTY_NAME_SPRINTF
559 PTY_NAME_SPRINTF
560 #else
561 sprintf (pty_name, "/dev/pty%c%x", c, i);
562 #endif /* no PTY_NAME_SPRINTF */
564 #ifdef PTY_OPEN
565 PTY_OPEN;
566 #else /* no PTY_OPEN */
568 { /* Some systems name their pseudoterminals so that there are gaps in
569 the usual sequence - for example, on HP9000/S700 systems, there
570 are no pseudoterminals with names ending in 'f'. So we wait for
571 three failures in a row before deciding that we've reached the
572 end of the ptys. */
573 int failed_count = 0;
574 struct stat stb;
576 if (stat (pty_name, &stb) < 0)
578 failed_count++;
579 if (failed_count >= 3)
580 return -1;
582 else
583 failed_count = 0;
585 # ifdef O_NONBLOCK
586 fd = emacs_open (pty_name, O_RDWR | O_NONBLOCK, 0);
587 # else
588 fd = emacs_open (pty_name, O_RDWR | O_NDELAY, 0);
589 # endif
591 #endif /* no PTY_OPEN */
593 if (fd >= 0)
595 /* check to make certain that both sides are available
596 this avoids a nasty yet stupid bug in rlogins */
597 #ifdef PTY_TTY_NAME_SPRINTF
598 PTY_TTY_NAME_SPRINTF
599 #else
600 sprintf (pty_name, "/dev/tty%c%x", c, i);
601 #endif /* no PTY_TTY_NAME_SPRINTF */
602 if (access (pty_name, 6) != 0)
604 emacs_close (fd);
605 # ifndef __sgi
606 continue;
607 # else
608 return -1;
609 # endif /* __sgi */
611 setup_pty (fd);
612 return fd;
615 return -1;
617 #endif /* HAVE_PTYS */
619 static Lisp_Object
620 make_process (Lisp_Object name)
622 register Lisp_Object val, tem, name1;
623 register struct Lisp_Process *p;
624 char suffix[sizeof "<>" + INT_STRLEN_BOUND (printmax_t)];
625 printmax_t i;
627 p = allocate_process ();
629 p->infd = -1;
630 p->outfd = -1;
631 p->tick = 0;
632 p->update_tick = 0;
633 p->pid = 0;
634 p->pty_flag = 0;
635 p->raw_status_new = 0;
636 p->status = Qrun;
637 p->mark = Fmake_marker ();
638 p->kill_without_query = 0;
639 p->write_queue = Qnil;
641 #ifdef ADAPTIVE_READ_BUFFERING
642 p->adaptive_read_buffering = 0;
643 p->read_output_delay = 0;
644 p->read_output_skip = 0;
645 #endif
647 #ifdef HAVE_GNUTLS
648 p->gnutls_initstage = GNUTLS_STAGE_EMPTY;
649 /* Default log level. */
650 p->gnutls_log_level = 0;
651 /* GnuTLS handshakes attempted for this connection. */
652 p->gnutls_handshakes_tried = 0;
653 p->gnutls_p = 0;
654 p->gnutls_state = NULL;
655 p->gnutls_x509_cred = NULL;
656 p->gnutls_anon_cred = NULL;
657 #endif
659 /* If name is already in use, modify it until it is unused. */
661 name1 = name;
662 for (i = 1; ; i++)
664 tem = Fget_process (name1);
665 if (NILP (tem)) break;
666 sprintf (suffix, "<%"pMd">", i);
667 name1 = concat2 (name, build_string (suffix));
669 name = name1;
670 p->name = name;
671 XSETPROCESS (val, p);
672 Vprocess_alist = Fcons (Fcons (name, val), Vprocess_alist);
673 return val;
676 static void
677 remove_process (register Lisp_Object proc)
679 register Lisp_Object pair;
681 pair = Frassq (proc, Vprocess_alist);
682 Vprocess_alist = Fdelq (pair, Vprocess_alist);
684 deactivate_process (proc);
688 DEFUN ("processp", Fprocessp, Sprocessp, 1, 1, 0,
689 doc: /* Return t if OBJECT is a process. */)
690 (Lisp_Object object)
692 return PROCESSP (object) ? Qt : Qnil;
695 DEFUN ("get-process", Fget_process, Sget_process, 1, 1, 0,
696 doc: /* Return the process named NAME, or nil if there is none. */)
697 (register Lisp_Object name)
699 if (PROCESSP (name))
700 return name;
701 CHECK_STRING (name);
702 return Fcdr (Fassoc (name, Vprocess_alist));
705 /* This is how commands for the user decode process arguments. It
706 accepts a process, a process name, a buffer, a buffer name, or nil.
707 Buffers denote the first process in the buffer, and nil denotes the
708 current buffer. */
710 static Lisp_Object
711 get_process (register Lisp_Object name)
713 register Lisp_Object proc, obj;
714 if (STRINGP (name))
716 obj = Fget_process (name);
717 if (NILP (obj))
718 obj = Fget_buffer (name);
719 if (NILP (obj))
720 error ("Process %s does not exist", SDATA (name));
722 else if (NILP (name))
723 obj = Fcurrent_buffer ();
724 else
725 obj = name;
727 /* Now obj should be either a buffer object or a process object.
729 if (BUFFERP (obj))
731 proc = Fget_buffer_process (obj);
732 if (NILP (proc))
733 error ("Buffer %s has no process", SDATA (BVAR (XBUFFER (obj), name)));
735 else
737 CHECK_PROCESS (obj);
738 proc = obj;
740 return proc;
744 #ifdef SIGCHLD
745 /* Fdelete_process promises to immediately forget about the process, but in
746 reality, Emacs needs to remember those processes until they have been
747 treated by sigchld_handler; otherwise this handler would consider the
748 process as being synchronous and say that the synchronous process is
749 dead. */
750 static Lisp_Object deleted_pid_list;
751 #endif
753 DEFUN ("delete-process", Fdelete_process, Sdelete_process, 1, 1, 0,
754 doc: /* Delete PROCESS: kill it and forget about it immediately.
755 PROCESS may be a process, a buffer, the name of a process or buffer, or
756 nil, indicating the current buffer's process. */)
757 (register Lisp_Object process)
759 register struct Lisp_Process *p;
761 process = get_process (process);
762 p = XPROCESS (process);
764 p->raw_status_new = 0;
765 if (NETCONN1_P (p) || SERIALCONN1_P (p))
767 p->status = Fcons (Qexit, Fcons (make_number (0), Qnil));
768 p->tick = ++process_tick;
769 status_notify (p);
770 redisplay_preserve_echo_area (13);
772 else if (p->infd >= 0)
774 #ifdef SIGCHLD
775 Lisp_Object symbol;
776 pid_t pid = p->pid;
778 /* No problem storing the pid here, as it is still in Vprocess_alist. */
779 deleted_pid_list = Fcons (make_fixnum_or_float (pid),
780 /* GC treated elements set to nil. */
781 Fdelq (Qnil, deleted_pid_list));
782 /* If the process has already signaled, remove it from the list. */
783 if (p->raw_status_new)
784 update_status (p);
785 symbol = p->status;
786 if (CONSP (p->status))
787 symbol = XCAR (p->status);
788 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit))
789 deleted_pid_list
790 = Fdelete (make_fixnum_or_float (pid), deleted_pid_list);
791 else
792 #endif
794 Fkill_process (process, Qnil);
795 /* Do this now, since remove_process will make sigchld_handler do nothing. */
796 p->status
797 = Fcons (Qsignal, Fcons (make_number (SIGKILL), Qnil));
798 p->tick = ++process_tick;
799 status_notify (p);
800 redisplay_preserve_echo_area (13);
803 remove_process (process);
804 return Qnil;
807 DEFUN ("process-status", Fprocess_status, Sprocess_status, 1, 1, 0,
808 doc: /* Return the status of PROCESS.
809 The returned value is one of the following symbols:
810 run -- for a process that is running.
811 stop -- for a process stopped but continuable.
812 exit -- for a process that has exited.
813 signal -- for a process that has got a fatal signal.
814 open -- for a network stream connection that is open.
815 listen -- for a network stream server that is listening.
816 closed -- for a network stream connection that is closed.
817 connect -- when waiting for a non-blocking connection to complete.
818 failed -- when a non-blocking connection has failed.
819 nil -- if arg is a process name and no such process exists.
820 PROCESS may be a process, a buffer, the name of a process, or
821 nil, indicating the current buffer's process. */)
822 (register Lisp_Object process)
824 register struct Lisp_Process *p;
825 register Lisp_Object status;
827 if (STRINGP (process))
828 process = Fget_process (process);
829 else
830 process = get_process (process);
832 if (NILP (process))
833 return process;
835 p = XPROCESS (process);
836 if (p->raw_status_new)
837 update_status (p);
838 status = p->status;
839 if (CONSP (status))
840 status = XCAR (status);
841 if (NETCONN1_P (p) || SERIALCONN1_P (p))
843 if (EQ (status, Qexit))
844 status = Qclosed;
845 else if (EQ (p->command, Qt))
846 status = Qstop;
847 else if (EQ (status, Qrun))
848 status = Qopen;
850 return status;
853 DEFUN ("process-exit-status", Fprocess_exit_status, Sprocess_exit_status,
854 1, 1, 0,
855 doc: /* Return the exit status of PROCESS or the signal number that killed it.
856 If PROCESS has not yet exited or died, return 0. */)
857 (register Lisp_Object process)
859 CHECK_PROCESS (process);
860 if (XPROCESS (process)->raw_status_new)
861 update_status (XPROCESS (process));
862 if (CONSP (XPROCESS (process)->status))
863 return XCAR (XCDR (XPROCESS (process)->status));
864 return make_number (0);
867 DEFUN ("process-id", Fprocess_id, Sprocess_id, 1, 1, 0,
868 doc: /* Return the process id of PROCESS.
869 This is the pid of the external process which PROCESS uses or talks to.
870 For a network connection, this value is nil. */)
871 (register Lisp_Object process)
873 pid_t pid;
875 CHECK_PROCESS (process);
876 pid = XPROCESS (process)->pid;
877 return (pid ? make_fixnum_or_float (pid) : Qnil);
880 DEFUN ("process-name", Fprocess_name, Sprocess_name, 1, 1, 0,
881 doc: /* Return the name of PROCESS, as a string.
882 This is the name of the program invoked in PROCESS,
883 possibly modified to make it unique among process names. */)
884 (register Lisp_Object process)
886 CHECK_PROCESS (process);
887 return XPROCESS (process)->name;
890 DEFUN ("process-command", Fprocess_command, Sprocess_command, 1, 1, 0,
891 doc: /* Return the command that was executed to start PROCESS.
892 This is a list of strings, the first string being the program executed
893 and the rest of the strings being the arguments given to it.
894 For a network or serial process, this is nil (process is running) or t
895 \(process is stopped). */)
896 (register Lisp_Object process)
898 CHECK_PROCESS (process);
899 return XPROCESS (process)->command;
902 DEFUN ("process-tty-name", Fprocess_tty_name, Sprocess_tty_name, 1, 1, 0,
903 doc: /* Return the name of the terminal PROCESS uses, or nil if none.
904 This is the terminal that the process itself reads and writes on,
905 not the name of the pty that Emacs uses to talk with that terminal. */)
906 (register Lisp_Object process)
908 CHECK_PROCESS (process);
909 return XPROCESS (process)->tty_name;
912 DEFUN ("set-process-buffer", Fset_process_buffer, Sset_process_buffer,
913 2, 2, 0,
914 doc: /* Set buffer associated with PROCESS to BUFFER (a buffer, or nil).
915 Return BUFFER. */)
916 (register Lisp_Object process, Lisp_Object buffer)
918 struct Lisp_Process *p;
920 CHECK_PROCESS (process);
921 if (!NILP (buffer))
922 CHECK_BUFFER (buffer);
923 p = XPROCESS (process);
924 p->buffer = buffer;
925 if (NETCONN1_P (p) || SERIALCONN1_P (p))
926 p->childp = Fplist_put (p->childp, QCbuffer, buffer);
927 setup_process_coding_systems (process);
928 return buffer;
931 DEFUN ("process-buffer", Fprocess_buffer, Sprocess_buffer,
932 1, 1, 0,
933 doc: /* Return the buffer PROCESS is associated with.
934 Output from PROCESS is inserted in this buffer unless PROCESS has a filter. */)
935 (register Lisp_Object process)
937 CHECK_PROCESS (process);
938 return XPROCESS (process)->buffer;
941 DEFUN ("process-mark", Fprocess_mark, Sprocess_mark,
942 1, 1, 0,
943 doc: /* Return the marker for the end of the last output from PROCESS. */)
944 (register Lisp_Object process)
946 CHECK_PROCESS (process);
947 return XPROCESS (process)->mark;
950 DEFUN ("set-process-filter", Fset_process_filter, Sset_process_filter,
951 2, 2, 0,
952 doc: /* Give PROCESS the filter function FILTER; nil means no filter.
953 A value of t means stop accepting output from the process.
955 When a process has a filter, its buffer is not used for output.
956 Instead, each time it does output, the entire string of output is
957 passed to the filter.
959 The filter gets two arguments: the process and the string of output.
960 The string argument is normally a multibyte string, except:
961 - if the process' input coding system is no-conversion or raw-text,
962 it is a unibyte string (the non-converted input), or else
963 - if `default-enable-multibyte-characters' is nil, it is a unibyte
964 string (the result of converting the decoded input multibyte
965 string to unibyte with `string-make-unibyte'). */)
966 (register Lisp_Object process, Lisp_Object filter)
968 struct Lisp_Process *p;
970 CHECK_PROCESS (process);
971 p = XPROCESS (process);
973 /* Don't signal an error if the process' input file descriptor
974 is closed. This could make debugging Lisp more difficult,
975 for example when doing something like
977 (setq process (start-process ...))
978 (debug)
979 (set-process-filter process ...) */
981 if (p->infd >= 0)
983 if (EQ (filter, Qt) && !EQ (p->status, Qlisten))
985 FD_CLR (p->infd, &input_wait_mask);
986 FD_CLR (p->infd, &non_keyboard_wait_mask);
988 else if (EQ (p->filter, Qt)
989 /* Network or serial process not stopped: */
990 && !EQ (p->command, Qt))
992 FD_SET (p->infd, &input_wait_mask);
993 FD_SET (p->infd, &non_keyboard_wait_mask);
997 p->filter = filter;
998 if (NETCONN1_P (p) || SERIALCONN1_P (p))
999 p->childp = Fplist_put (p->childp, QCfilter, filter);
1000 setup_process_coding_systems (process);
1001 return filter;
1004 DEFUN ("process-filter", Fprocess_filter, Sprocess_filter,
1005 1, 1, 0,
1006 doc: /* Returns the filter function of PROCESS; nil if none.
1007 See `set-process-filter' for more info on filter functions. */)
1008 (register Lisp_Object process)
1010 CHECK_PROCESS (process);
1011 return XPROCESS (process)->filter;
1014 DEFUN ("set-process-sentinel", Fset_process_sentinel, Sset_process_sentinel,
1015 2, 2, 0,
1016 doc: /* Give PROCESS the sentinel SENTINEL; nil for none.
1017 The sentinel is called as a function when the process changes state.
1018 It gets two arguments: the process, and a string describing the change. */)
1019 (register Lisp_Object process, Lisp_Object sentinel)
1021 struct Lisp_Process *p;
1023 CHECK_PROCESS (process);
1024 p = XPROCESS (process);
1026 p->sentinel = sentinel;
1027 if (NETCONN1_P (p) || SERIALCONN1_P (p))
1028 p->childp = Fplist_put (p->childp, QCsentinel, sentinel);
1029 return sentinel;
1032 DEFUN ("process-sentinel", Fprocess_sentinel, Sprocess_sentinel,
1033 1, 1, 0,
1034 doc: /* Return the sentinel of PROCESS; nil if none.
1035 See `set-process-sentinel' for more info on sentinels. */)
1036 (register Lisp_Object process)
1038 CHECK_PROCESS (process);
1039 return XPROCESS (process)->sentinel;
1042 DEFUN ("set-process-window-size", Fset_process_window_size,
1043 Sset_process_window_size, 3, 3, 0,
1044 doc: /* Tell PROCESS that it has logical window size HEIGHT and WIDTH. */)
1045 (register Lisp_Object process, Lisp_Object height, Lisp_Object width)
1047 CHECK_PROCESS (process);
1048 CHECK_RANGED_INTEGER (0, height, INT_MAX);
1049 CHECK_RANGED_INTEGER (0, width, INT_MAX);
1051 if (XPROCESS (process)->infd < 0
1052 || set_window_size (XPROCESS (process)->infd,
1053 XINT (height), XINT (width)) <= 0)
1054 return Qnil;
1055 else
1056 return Qt;
1059 DEFUN ("set-process-inherit-coding-system-flag",
1060 Fset_process_inherit_coding_system_flag,
1061 Sset_process_inherit_coding_system_flag, 2, 2, 0,
1062 doc: /* Determine whether buffer of PROCESS will inherit coding-system.
1063 If the second argument FLAG is non-nil, then the variable
1064 `buffer-file-coding-system' of the buffer associated with PROCESS
1065 will be bound to the value of the coding system used to decode
1066 the process output.
1068 This is useful when the coding system specified for the process buffer
1069 leaves either the character code conversion or the end-of-line conversion
1070 unspecified, or if the coding system used to decode the process output
1071 is more appropriate for saving the process buffer.
1073 Binding the variable `inherit-process-coding-system' to non-nil before
1074 starting the process is an alternative way of setting the inherit flag
1075 for the process which will run.
1077 This function returns FLAG. */)
1078 (register Lisp_Object process, Lisp_Object flag)
1080 CHECK_PROCESS (process);
1081 XPROCESS (process)->inherit_coding_system_flag = !NILP (flag);
1082 return flag;
1085 DEFUN ("set-process-query-on-exit-flag",
1086 Fset_process_query_on_exit_flag, Sset_process_query_on_exit_flag,
1087 2, 2, 0,
1088 doc: /* Specify if query is needed for PROCESS when Emacs is exited.
1089 If the second argument FLAG is non-nil, Emacs will query the user before
1090 exiting or killing a buffer if PROCESS is running. This function
1091 returns FLAG. */)
1092 (register Lisp_Object process, Lisp_Object flag)
1094 CHECK_PROCESS (process);
1095 XPROCESS (process)->kill_without_query = NILP (flag);
1096 return flag;
1099 DEFUN ("process-query-on-exit-flag",
1100 Fprocess_query_on_exit_flag, Sprocess_query_on_exit_flag,
1101 1, 1, 0,
1102 doc: /* Return the current value of query-on-exit flag for PROCESS. */)
1103 (register Lisp_Object process)
1105 CHECK_PROCESS (process);
1106 return (XPROCESS (process)->kill_without_query ? Qnil : Qt);
1109 #ifdef DATAGRAM_SOCKETS
1110 static Lisp_Object Fprocess_datagram_address (Lisp_Object);
1111 #endif
1113 DEFUN ("process-contact", Fprocess_contact, Sprocess_contact,
1114 1, 2, 0,
1115 doc: /* Return the contact info of PROCESS; t for a real child.
1116 For a network or serial connection, the value depends on the optional
1117 KEY arg. If KEY is nil, value is a cons cell of the form (HOST
1118 SERVICE) for a network connection or (PORT SPEED) for a serial
1119 connection. If KEY is t, the complete contact information for the
1120 connection is returned, else the specific value for the keyword KEY is
1121 returned. See `make-network-process' or `make-serial-process' for a
1122 list of keywords. */)
1123 (register Lisp_Object process, Lisp_Object key)
1125 Lisp_Object contact;
1127 CHECK_PROCESS (process);
1128 contact = XPROCESS (process)->childp;
1130 #ifdef DATAGRAM_SOCKETS
1131 if (DATAGRAM_CONN_P (process)
1132 && (EQ (key, Qt) || EQ (key, QCremote)))
1133 contact = Fplist_put (contact, QCremote,
1134 Fprocess_datagram_address (process));
1135 #endif
1137 if ((!NETCONN_P (process) && !SERIALCONN_P (process)) || EQ (key, Qt))
1138 return contact;
1139 if (NILP (key) && NETCONN_P (process))
1140 return Fcons (Fplist_get (contact, QChost),
1141 Fcons (Fplist_get (contact, QCservice), Qnil));
1142 if (NILP (key) && SERIALCONN_P (process))
1143 return Fcons (Fplist_get (contact, QCport),
1144 Fcons (Fplist_get (contact, QCspeed), Qnil));
1145 return Fplist_get (contact, key);
1148 DEFUN ("process-plist", Fprocess_plist, Sprocess_plist,
1149 1, 1, 0,
1150 doc: /* Return the plist of PROCESS. */)
1151 (register Lisp_Object process)
1153 CHECK_PROCESS (process);
1154 return XPROCESS (process)->plist;
1157 DEFUN ("set-process-plist", Fset_process_plist, Sset_process_plist,
1158 2, 2, 0,
1159 doc: /* Replace the plist of PROCESS with PLIST. Returns PLIST. */)
1160 (register Lisp_Object process, Lisp_Object plist)
1162 CHECK_PROCESS (process);
1163 CHECK_LIST (plist);
1165 XPROCESS (process)->plist = plist;
1166 return plist;
1169 #if 0 /* Turned off because we don't currently record this info
1170 in the process. Perhaps add it. */
1171 DEFUN ("process-connection", Fprocess_connection, Sprocess_connection, 1, 1, 0,
1172 doc: /* Return the connection type of PROCESS.
1173 The value is nil for a pipe, t or `pty' for a pty, or `stream' for
1174 a socket connection. */)
1175 (Lisp_Object process)
1177 return XPROCESS (process)->type;
1179 #endif
1181 DEFUN ("process-type", Fprocess_type, Sprocess_type, 1, 1, 0,
1182 doc: /* Return the connection type of PROCESS.
1183 The value is either the symbol `real', `network', or `serial'.
1184 PROCESS may be a process, a buffer, the name of a process or buffer, or
1185 nil, indicating the current buffer's process. */)
1186 (Lisp_Object process)
1188 Lisp_Object proc;
1189 proc = get_process (process);
1190 return XPROCESS (proc)->type;
1193 DEFUN ("format-network-address", Fformat_network_address, Sformat_network_address,
1194 1, 2, 0,
1195 doc: /* Convert network ADDRESS from internal format to a string.
1196 A 4 or 5 element vector represents an IPv4 address (with port number).
1197 An 8 or 9 element vector represents an IPv6 address (with port number).
1198 If optional second argument OMIT-PORT is non-nil, don't include a port
1199 number in the string, even when present in ADDRESS.
1200 Returns nil if format of ADDRESS is invalid. */)
1201 (Lisp_Object address, Lisp_Object omit_port)
1203 if (NILP (address))
1204 return Qnil;
1206 if (STRINGP (address)) /* AF_LOCAL */
1207 return address;
1209 if (VECTORP (address)) /* AF_INET or AF_INET6 */
1211 register struct Lisp_Vector *p = XVECTOR (address);
1212 ptrdiff_t size = p->header.size;
1213 Lisp_Object args[10];
1214 int nargs, i;
1216 if (size == 4 || (size == 5 && !NILP (omit_port)))
1218 args[0] = build_string ("%d.%d.%d.%d");
1219 nargs = 4;
1221 else if (size == 5)
1223 args[0] = build_string ("%d.%d.%d.%d:%d");
1224 nargs = 5;
1226 else if (size == 8 || (size == 9 && !NILP (omit_port)))
1228 args[0] = build_string ("%x:%x:%x:%x:%x:%x:%x:%x");
1229 nargs = 8;
1231 else if (size == 9)
1233 args[0] = build_string ("[%x:%x:%x:%x:%x:%x:%x:%x]:%d");
1234 nargs = 9;
1236 else
1237 return Qnil;
1239 for (i = 0; i < nargs; i++)
1241 if (! RANGED_INTEGERP (0, p->contents[i], 65535))
1242 return Qnil;
1244 if (nargs <= 5 /* IPv4 */
1245 && i < 4 /* host, not port */
1246 && XINT (p->contents[i]) > 255)
1247 return Qnil;
1249 args[i+1] = p->contents[i];
1252 return Fformat (nargs+1, args);
1255 if (CONSP (address))
1257 Lisp_Object args[2];
1258 args[0] = build_string ("<Family %d>");
1259 args[1] = Fcar (address);
1260 return Fformat (2, args);
1263 return Qnil;
1266 DEFUN ("process-list", Fprocess_list, Sprocess_list, 0, 0, 0,
1267 doc: /* Return a list of all processes. */)
1268 (void)
1270 return Fmapcar (Qcdr, Vprocess_alist);
1273 /* Starting asynchronous inferior processes. */
1275 static Lisp_Object start_process_unwind (Lisp_Object proc);
1277 DEFUN ("start-process", Fstart_process, Sstart_process, 3, MANY, 0,
1278 doc: /* Start a program in a subprocess. Return the process object for it.
1279 NAME is name for process. It is modified if necessary to make it unique.
1280 BUFFER is the buffer (or buffer name) to associate with the process.
1282 Process output (both standard output and standard error streams) goes
1283 at end of BUFFER, unless you specify an output stream or filter
1284 function to handle the output. BUFFER may also be nil, meaning that
1285 this process is not associated with any buffer.
1287 PROGRAM is the program file name. It is searched for in `exec-path'
1288 (which see). If nil, just associate a pty with the buffer. Remaining
1289 arguments are strings to give program as arguments.
1291 If you want to separate standard output from standard error, invoke
1292 the command through a shell and redirect one of them using the shell
1293 syntax.
1295 usage: (start-process NAME BUFFER PROGRAM &rest PROGRAM-ARGS) */)
1296 (ptrdiff_t nargs, Lisp_Object *args)
1298 Lisp_Object buffer, name, program, proc, current_dir, tem;
1299 register unsigned char **new_argv;
1300 ptrdiff_t i;
1301 ptrdiff_t count = SPECPDL_INDEX ();
1303 buffer = args[1];
1304 if (!NILP (buffer))
1305 buffer = Fget_buffer_create (buffer);
1307 /* Make sure that the child will be able to chdir to the current
1308 buffer's current directory, or its unhandled equivalent. We
1309 can't just have the child check for an error when it does the
1310 chdir, since it's in a vfork.
1312 We have to GCPRO around this because Fexpand_file_name and
1313 Funhandled_file_name_directory might call a file name handling
1314 function. The argument list is protected by the caller, so all
1315 we really have to worry about is buffer. */
1317 struct gcpro gcpro1, gcpro2;
1319 current_dir = BVAR (current_buffer, directory);
1321 GCPRO2 (buffer, current_dir);
1323 current_dir = Funhandled_file_name_directory (current_dir);
1324 if (NILP (current_dir))
1325 /* If the file name handler says that current_dir is unreachable, use
1326 a sensible default. */
1327 current_dir = build_string ("~/");
1328 current_dir = expand_and_dir_to_file (current_dir, Qnil);
1329 if (NILP (Ffile_accessible_directory_p (current_dir)))
1330 report_file_error ("Setting current directory",
1331 Fcons (BVAR (current_buffer, directory), Qnil));
1333 UNGCPRO;
1336 name = args[0];
1337 CHECK_STRING (name);
1339 program = args[2];
1341 if (!NILP (program))
1342 CHECK_STRING (program);
1344 proc = make_process (name);
1345 /* If an error occurs and we can't start the process, we want to
1346 remove it from the process list. This means that each error
1347 check in create_process doesn't need to call remove_process
1348 itself; it's all taken care of here. */
1349 record_unwind_protect (start_process_unwind, proc);
1351 XPROCESS (proc)->childp = Qt;
1352 XPROCESS (proc)->plist = Qnil;
1353 XPROCESS (proc)->type = Qreal;
1354 XPROCESS (proc)->buffer = buffer;
1355 XPROCESS (proc)->sentinel = Qnil;
1356 XPROCESS (proc)->filter = Qnil;
1357 XPROCESS (proc)->command = Flist (nargs - 2, args + 2);
1359 #ifdef HAVE_GNUTLS
1360 /* AKA GNUTLS_INITSTAGE(proc). */
1361 XPROCESS (proc)->gnutls_initstage = GNUTLS_STAGE_EMPTY;
1362 XPROCESS (proc)->gnutls_cred_type = Qnil;
1363 #endif
1365 #ifdef ADAPTIVE_READ_BUFFERING
1366 XPROCESS (proc)->adaptive_read_buffering
1367 = (NILP (Vprocess_adaptive_read_buffering) ? 0
1368 : EQ (Vprocess_adaptive_read_buffering, Qt) ? 1 : 2);
1369 #endif
1371 /* Make the process marker point into the process buffer (if any). */
1372 if (BUFFERP (buffer))
1373 set_marker_both (XPROCESS (proc)->mark, buffer,
1374 BUF_ZV (XBUFFER (buffer)),
1375 BUF_ZV_BYTE (XBUFFER (buffer)));
1378 /* Decide coding systems for communicating with the process. Here
1379 we don't setup the structure coding_system nor pay attention to
1380 unibyte mode. They are done in create_process. */
1382 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
1383 Lisp_Object coding_systems = Qt;
1384 Lisp_Object val, *args2;
1385 struct gcpro gcpro1, gcpro2;
1387 val = Vcoding_system_for_read;
1388 if (NILP (val))
1390 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof *args2);
1391 args2[0] = Qstart_process;
1392 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1393 GCPRO2 (proc, current_dir);
1394 if (!NILP (program))
1395 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1396 UNGCPRO;
1397 if (CONSP (coding_systems))
1398 val = XCAR (coding_systems);
1399 else if (CONSP (Vdefault_process_coding_system))
1400 val = XCAR (Vdefault_process_coding_system);
1402 XPROCESS (proc)->decode_coding_system = val;
1404 val = Vcoding_system_for_write;
1405 if (NILP (val))
1407 if (EQ (coding_systems, Qt))
1409 args2 = (Lisp_Object *) alloca ((nargs + 1) * sizeof *args2);
1410 args2[0] = Qstart_process;
1411 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1412 GCPRO2 (proc, current_dir);
1413 if (!NILP (program))
1414 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
1415 UNGCPRO;
1417 if (CONSP (coding_systems))
1418 val = XCDR (coding_systems);
1419 else if (CONSP (Vdefault_process_coding_system))
1420 val = XCDR (Vdefault_process_coding_system);
1422 XPROCESS (proc)->encode_coding_system = val;
1423 /* Note: At this moment, the above coding system may leave
1424 text-conversion or eol-conversion unspecified. They will be
1425 decided after we read output from the process and decode it by
1426 some coding system, or just before we actually send a text to
1427 the process. */
1431 XPROCESS (proc)->decoding_buf = empty_unibyte_string;
1432 XPROCESS (proc)->decoding_carryover = 0;
1433 XPROCESS (proc)->encoding_buf = empty_unibyte_string;
1435 XPROCESS (proc)->inherit_coding_system_flag
1436 = !(NILP (buffer) || !inherit_process_coding_system);
1438 if (!NILP (program))
1440 /* If program file name is not absolute, search our path for it.
1441 Put the name we will really use in TEM. */
1442 if (!IS_DIRECTORY_SEP (SREF (program, 0))
1443 && !(SCHARS (program) > 1
1444 && IS_DEVICE_SEP (SREF (program, 1))))
1446 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1448 tem = Qnil;
1449 GCPRO4 (name, program, buffer, current_dir);
1450 openp (Vexec_path, program, Vexec_suffixes, &tem, make_number (X_OK));
1451 UNGCPRO;
1452 if (NILP (tem))
1453 report_file_error ("Searching for program", Fcons (program, Qnil));
1454 tem = Fexpand_file_name (tem, Qnil);
1456 else
1458 if (!NILP (Ffile_directory_p (program)))
1459 error ("Specified program for new process is a directory");
1460 tem = program;
1463 /* If program file name starts with /: for quoting a magic name,
1464 discard that. */
1465 if (SBYTES (tem) > 2 && SREF (tem, 0) == '/'
1466 && SREF (tem, 1) == ':')
1467 tem = Fsubstring (tem, make_number (2), Qnil);
1470 Lisp_Object arg_encoding = Qnil;
1471 struct gcpro gcpro1;
1472 GCPRO1 (tem);
1474 /* Encode the file name and put it in NEW_ARGV.
1475 That's where the child will use it to execute the program. */
1476 tem = Fcons (ENCODE_FILE (tem), Qnil);
1478 /* Here we encode arguments by the coding system used for sending
1479 data to the process. We don't support using different coding
1480 systems for encoding arguments and for encoding data sent to the
1481 process. */
1483 for (i = 3; i < nargs; i++)
1485 tem = Fcons (args[i], tem);
1486 CHECK_STRING (XCAR (tem));
1487 if (STRING_MULTIBYTE (XCAR (tem)))
1489 if (NILP (arg_encoding))
1490 arg_encoding = (complement_process_encoding_system
1491 (XPROCESS (proc)->encode_coding_system));
1492 XSETCAR (tem,
1493 code_convert_string_norecord
1494 (XCAR (tem), arg_encoding, 1));
1498 UNGCPRO;
1501 /* Now that everything is encoded we can collect the strings into
1502 NEW_ARGV. */
1503 new_argv = (unsigned char **) alloca ((nargs - 1) * sizeof (char *));
1504 new_argv[nargs - 2] = 0;
1506 for (i = nargs - 2; i-- != 0; )
1508 new_argv[i] = SDATA (XCAR (tem));
1509 tem = XCDR (tem);
1512 create_process (proc, (char **) new_argv, current_dir);
1514 else
1515 create_pty (proc);
1517 return unbind_to (count, proc);
1520 /* This function is the unwind_protect form for Fstart_process. If
1521 PROC doesn't have its pid set, then we know someone has signaled
1522 an error and the process wasn't started successfully, so we should
1523 remove it from the process list. */
1524 static Lisp_Object
1525 start_process_unwind (Lisp_Object proc)
1527 if (!PROCESSP (proc))
1528 abort ();
1530 /* Was PROC started successfully?
1531 -2 is used for a pty with no process, eg for gdb. */
1532 if (XPROCESS (proc)->pid <= 0 && XPROCESS (proc)->pid != -2)
1533 remove_process (proc);
1535 return Qnil;
1538 static void
1539 create_process_1 (struct atimer *timer)
1541 /* Nothing to do. */
1545 static void
1546 create_process (Lisp_Object process, char **new_argv, Lisp_Object current_dir)
1548 int inchannel, outchannel;
1549 pid_t pid;
1550 int sv[2];
1551 #if !defined (WINDOWSNT) && defined (FD_CLOEXEC)
1552 int wait_child_setup[2];
1553 #endif
1554 sigset_t procmask;
1555 sigset_t blocked;
1556 struct sigaction sigint_action;
1557 struct sigaction sigquit_action;
1558 struct sigaction sigpipe_action;
1559 #ifdef AIX
1560 struct sigaction sighup_action;
1561 #endif
1562 /* Use volatile to protect variables from being clobbered by longjmp. */
1563 volatile int forkin, forkout;
1564 volatile int pty_flag = 0;
1565 #ifndef USE_CRT_DLL
1566 extern char **environ;
1567 #endif
1569 inchannel = outchannel = -1;
1571 #ifdef HAVE_PTYS
1572 if (!NILP (Vprocess_connection_type))
1573 outchannel = inchannel = allocate_pty ();
1575 if (inchannel >= 0)
1577 #if ! defined (USG) || defined (USG_SUBTTY_WORKS)
1578 /* On most USG systems it does not work to open the pty's tty here,
1579 then close it and reopen it in the child. */
1580 #ifdef O_NOCTTY
1581 /* Don't let this terminal become our controlling terminal
1582 (in case we don't have one). */
1583 forkout = forkin = emacs_open (pty_name, O_RDWR | O_NOCTTY, 0);
1584 #else
1585 forkout = forkin = emacs_open (pty_name, O_RDWR, 0);
1586 #endif
1587 if (forkin < 0)
1588 report_file_error ("Opening pty", Qnil);
1589 #else
1590 forkin = forkout = -1;
1591 #endif /* not USG, or USG_SUBTTY_WORKS */
1592 pty_flag = 1;
1594 else
1595 #endif /* HAVE_PTYS */
1597 int tem;
1598 tem = pipe (sv);
1599 if (tem < 0)
1600 report_file_error ("Creating pipe", Qnil);
1601 inchannel = sv[0];
1602 forkout = sv[1];
1603 tem = pipe (sv);
1604 if (tem < 0)
1606 emacs_close (inchannel);
1607 emacs_close (forkout);
1608 report_file_error ("Creating pipe", Qnil);
1610 outchannel = sv[1];
1611 forkin = sv[0];
1614 #if !defined (WINDOWSNT) && defined (FD_CLOEXEC)
1616 int tem;
1618 tem = pipe (wait_child_setup);
1619 if (tem < 0)
1620 report_file_error ("Creating pipe", Qnil);
1621 tem = fcntl (wait_child_setup[1], F_GETFD, 0);
1622 if (tem >= 0)
1623 tem = fcntl (wait_child_setup[1], F_SETFD, tem | FD_CLOEXEC);
1624 if (tem < 0)
1626 emacs_close (wait_child_setup[0]);
1627 emacs_close (wait_child_setup[1]);
1628 report_file_error ("Setting file descriptor flags", Qnil);
1631 #endif
1633 #ifdef O_NONBLOCK
1634 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1635 fcntl (outchannel, F_SETFL, O_NONBLOCK);
1636 #else
1637 #ifdef O_NDELAY
1638 fcntl (inchannel, F_SETFL, O_NDELAY);
1639 fcntl (outchannel, F_SETFL, O_NDELAY);
1640 #endif
1641 #endif
1643 /* Record this as an active process, with its channels.
1644 As a result, child_setup will close Emacs's side of the pipes. */
1645 chan_process[inchannel] = process;
1646 XPROCESS (process)->infd = inchannel;
1647 XPROCESS (process)->outfd = outchannel;
1649 /* Previously we recorded the tty descriptor used in the subprocess.
1650 It was only used for getting the foreground tty process, so now
1651 we just reopen the device (see emacs_get_tty_pgrp) as this is
1652 more portable (see USG_SUBTTY_WORKS above). */
1654 XPROCESS (process)->pty_flag = pty_flag;
1655 XPROCESS (process)->status = Qrun;
1657 /* Delay interrupts until we have a chance to store
1658 the new fork's pid in its process structure */
1659 sigemptyset (&blocked);
1660 #ifdef SIGCHLD
1661 sigaddset (&blocked, SIGCHLD);
1662 #endif
1663 #ifdef HAVE_WORKING_VFORK
1664 /* On many hosts (e.g. Solaris 2.4), if a vforked child calls `signal',
1665 this sets the parent's signal handlers as well as the child's.
1666 So delay all interrupts whose handlers the child might munge,
1667 and record the current handlers so they can be restored later. */
1668 sigaddset (&blocked, SIGINT ); sigaction (SIGINT , 0, &sigint_action );
1669 sigaddset (&blocked, SIGQUIT); sigaction (SIGQUIT, 0, &sigquit_action);
1670 sigaddset (&blocked, SIGPIPE); sigaction (SIGPIPE, 0, &sigpipe_action);
1671 #ifdef AIX
1672 sigaddset (&blocked, SIGHUP ); sigaction (SIGHUP , 0, &sighup_action );
1673 #endif
1674 #endif /* HAVE_WORKING_VFORK */
1675 pthread_sigmask (SIG_BLOCK, &blocked, &procmask);
1677 FD_SET (inchannel, &input_wait_mask);
1678 FD_SET (inchannel, &non_keyboard_wait_mask);
1679 if (inchannel > max_process_desc)
1680 max_process_desc = inchannel;
1682 /* Until we store the proper pid, enable sigchld_handler
1683 to recognize an unknown pid as standing for this process.
1684 It is very important not to let this `marker' value stay
1685 in the table after this function has returned; if it does
1686 it might cause call-process to hang and subsequent asynchronous
1687 processes to get their return values scrambled. */
1688 XPROCESS (process)->pid = -1;
1690 /* This must be called after the above line because it may signal an
1691 error. */
1692 setup_process_coding_systems (process);
1694 BLOCK_INPUT;
1697 /* child_setup must clobber environ on systems with true vfork.
1698 Protect it from permanent change. */
1699 char **save_environ = environ;
1700 volatile Lisp_Object encoded_current_dir = ENCODE_FILE (current_dir);
1702 #ifndef WINDOWSNT
1703 pid = vfork ();
1704 if (pid == 0)
1705 #endif /* not WINDOWSNT */
1707 int xforkin = forkin;
1708 int xforkout = forkout;
1710 #if 0 /* This was probably a mistake--it duplicates code later on,
1711 but fails to handle all the cases. */
1712 /* Make sure SIGCHLD is not blocked in the child. */
1713 sigsetmask (SIGEMPTYMASK);
1714 #endif
1716 /* Make the pty be the controlling terminal of the process. */
1717 #ifdef HAVE_PTYS
1718 /* First, disconnect its current controlling terminal. */
1719 #ifdef HAVE_SETSID
1720 /* We tried doing setsid only if pty_flag, but it caused
1721 process_set_signal to fail on SGI when using a pipe. */
1722 setsid ();
1723 /* Make the pty's terminal the controlling terminal. */
1724 if (pty_flag && xforkin >= 0)
1726 #ifdef TIOCSCTTY
1727 /* We ignore the return value
1728 because faith@cs.unc.edu says that is necessary on Linux. */
1729 ioctl (xforkin, TIOCSCTTY, 0);
1730 #endif
1732 #else /* not HAVE_SETSID */
1733 #ifdef USG
1734 /* It's very important to call setpgrp here and no time
1735 afterwards. Otherwise, we lose our controlling tty which
1736 is set when we open the pty. */
1737 setpgrp ();
1738 #endif /* USG */
1739 #endif /* not HAVE_SETSID */
1740 #if defined (LDISC1)
1741 if (pty_flag && xforkin >= 0)
1743 struct termios t;
1744 tcgetattr (xforkin, &t);
1745 t.c_lflag = LDISC1;
1746 if (tcsetattr (xforkin, TCSANOW, &t) < 0)
1747 emacs_write (1, "create_process/tcsetattr LDISC1 failed\n", 39);
1749 #else
1750 #if defined (NTTYDISC) && defined (TIOCSETD)
1751 if (pty_flag && xforkin >= 0)
1753 /* Use new line discipline. */
1754 int ldisc = NTTYDISC;
1755 ioctl (xforkin, TIOCSETD, &ldisc);
1757 #endif
1758 #endif
1759 #ifdef TIOCNOTTY
1760 /* In 4.3BSD, the TIOCSPGRP bug has been fixed, and now you
1761 can do TIOCSPGRP only to the process's controlling tty. */
1762 if (pty_flag)
1764 /* I wonder: would just ioctl (0, TIOCNOTTY, 0) work here?
1765 I can't test it since I don't have 4.3. */
1766 int j = emacs_open ("/dev/tty", O_RDWR, 0);
1767 if (j >= 0)
1769 ioctl (j, TIOCNOTTY, 0);
1770 emacs_close (j);
1772 #ifndef USG
1773 /* In order to get a controlling terminal on some versions
1774 of BSD, it is necessary to put the process in pgrp 0
1775 before it opens the terminal. */
1776 #ifdef HAVE_SETPGID
1777 setpgid (0, 0);
1778 #else
1779 setpgrp (0, 0);
1780 #endif
1781 #endif
1783 #endif /* TIOCNOTTY */
1785 #if !defined (DONT_REOPEN_PTY)
1786 /*** There is a suggestion that this ought to be a
1787 conditional on TIOCSPGRP,
1788 or !(defined (HAVE_SETSID) && defined (TIOCSCTTY)).
1789 Trying the latter gave the wrong results on Debian GNU/Linux 1.1;
1790 that system does seem to need this code, even though
1791 both HAVE_SETSID and TIOCSCTTY are defined. */
1792 /* Now close the pty (if we had it open) and reopen it.
1793 This makes the pty the controlling terminal of the subprocess. */
1794 if (pty_flag)
1797 /* I wonder if emacs_close (emacs_open (pty_name, ...))
1798 would work? */
1799 if (xforkin >= 0)
1800 emacs_close (xforkin);
1801 xforkout = xforkin = emacs_open (pty_name, O_RDWR, 0);
1803 if (xforkin < 0)
1805 emacs_write (1, "Couldn't open the pty terminal ", 31);
1806 emacs_write (1, pty_name, strlen (pty_name));
1807 emacs_write (1, "\n", 1);
1808 _exit (1);
1812 #endif /* not DONT_REOPEN_PTY */
1814 #ifdef SETUP_SLAVE_PTY
1815 if (pty_flag)
1817 SETUP_SLAVE_PTY;
1819 #endif /* SETUP_SLAVE_PTY */
1820 #ifdef AIX
1821 /* On AIX, we've disabled SIGHUP above once we start a child on a pty.
1822 Now reenable it in the child, so it will die when we want it to. */
1823 if (pty_flag)
1824 signal (SIGHUP, SIG_DFL);
1825 #endif
1826 #endif /* HAVE_PTYS */
1828 signal (SIGINT, SIG_DFL);
1829 signal (SIGQUIT, SIG_DFL);
1830 /* GConf causes us to ignore SIGPIPE, make sure it is restored
1831 in the child. */
1832 signal (SIGPIPE, SIG_DFL);
1834 /* Stop blocking signals in the child. */
1835 pthread_sigmask (SIG_SETMASK, &procmask, 0);
1837 if (pty_flag)
1838 child_setup_tty (xforkout);
1839 #ifdef WINDOWSNT
1840 pid = child_setup (xforkin, xforkout, xforkout,
1841 new_argv, 1, encoded_current_dir);
1842 #else /* not WINDOWSNT */
1843 #ifdef FD_CLOEXEC
1844 emacs_close (wait_child_setup[0]);
1845 #endif
1846 child_setup (xforkin, xforkout, xforkout,
1847 new_argv, 1, encoded_current_dir);
1848 #endif /* not WINDOWSNT */
1850 environ = save_environ;
1853 UNBLOCK_INPUT;
1855 /* This runs in the Emacs process. */
1856 if (pid < 0)
1858 if (forkin >= 0)
1859 emacs_close (forkin);
1860 if (forkin != forkout && forkout >= 0)
1861 emacs_close (forkout);
1863 else
1865 /* vfork succeeded. */
1866 XPROCESS (process)->pid = pid;
1868 #ifdef WINDOWSNT
1869 register_child (pid, inchannel);
1870 #endif /* WINDOWSNT */
1872 /* If the subfork execv fails, and it exits,
1873 this close hangs. I don't know why.
1874 So have an interrupt jar it loose. */
1876 struct atimer *timer;
1877 EMACS_TIME offset;
1879 stop_polling ();
1880 EMACS_SET_SECS_USECS (offset, 1, 0);
1881 timer = start_atimer (ATIMER_RELATIVE, offset, create_process_1, 0);
1883 if (forkin >= 0)
1884 emacs_close (forkin);
1886 cancel_atimer (timer);
1887 start_polling ();
1890 if (forkin != forkout && forkout >= 0)
1891 emacs_close (forkout);
1893 #ifdef HAVE_PTYS
1894 if (pty_flag)
1895 XPROCESS (process)->tty_name = build_string (pty_name);
1896 else
1897 #endif
1898 XPROCESS (process)->tty_name = Qnil;
1900 #if !defined (WINDOWSNT) && defined (FD_CLOEXEC)
1901 /* Wait for child_setup to complete in case that vfork is
1902 actually defined as fork. The descriptor wait_child_setup[1]
1903 of a pipe is closed at the child side either by close-on-exec
1904 on successful execvp or the _exit call in child_setup. */
1906 char dummy;
1908 emacs_close (wait_child_setup[1]);
1909 emacs_read (wait_child_setup[0], &dummy, 1);
1910 emacs_close (wait_child_setup[0]);
1912 #endif
1915 /* Restore the signal state whether vfork succeeded or not.
1916 (We will signal an error, below, if it failed.) */
1917 #ifdef HAVE_WORKING_VFORK
1918 /* Restore the parent's signal handlers. */
1919 sigaction (SIGINT, &sigint_action, 0);
1920 sigaction (SIGQUIT, &sigquit_action, 0);
1921 sigaction (SIGPIPE, &sigpipe_action, 0);
1922 #ifdef AIX
1923 sigaction (SIGHUP, &sighup_action, 0);
1924 #endif
1925 #endif /* HAVE_WORKING_VFORK */
1926 /* Stop blocking signals in the parent. */
1927 pthread_sigmask (SIG_SETMASK, &procmask, 0);
1929 /* Now generate the error if vfork failed. */
1930 if (pid < 0)
1931 report_file_error ("Doing vfork", Qnil);
1934 void
1935 create_pty (Lisp_Object process)
1937 int inchannel, outchannel;
1938 int pty_flag = 0;
1940 inchannel = outchannel = -1;
1942 #ifdef HAVE_PTYS
1943 if (!NILP (Vprocess_connection_type))
1944 outchannel = inchannel = allocate_pty ();
1946 if (inchannel >= 0)
1948 #if ! defined (USG) || defined (USG_SUBTTY_WORKS)
1949 /* On most USG systems it does not work to open the pty's tty here,
1950 then close it and reopen it in the child. */
1951 #ifdef O_NOCTTY
1952 /* Don't let this terminal become our controlling terminal
1953 (in case we don't have one). */
1954 int forkout = emacs_open (pty_name, O_RDWR | O_NOCTTY, 0);
1955 #else
1956 int forkout = emacs_open (pty_name, O_RDWR, 0);
1957 #endif
1958 if (forkout < 0)
1959 report_file_error ("Opening pty", Qnil);
1960 #if defined (DONT_REOPEN_PTY)
1961 /* In the case that vfork is defined as fork, the parent process
1962 (Emacs) may send some data before the child process completes
1963 tty options setup. So we setup tty before forking. */
1964 child_setup_tty (forkout);
1965 #endif /* DONT_REOPEN_PTY */
1966 #endif /* not USG, or USG_SUBTTY_WORKS */
1967 pty_flag = 1;
1969 #endif /* HAVE_PTYS */
1971 #ifdef O_NONBLOCK
1972 fcntl (inchannel, F_SETFL, O_NONBLOCK);
1973 fcntl (outchannel, F_SETFL, O_NONBLOCK);
1974 #else
1975 #ifdef O_NDELAY
1976 fcntl (inchannel, F_SETFL, O_NDELAY);
1977 fcntl (outchannel, F_SETFL, O_NDELAY);
1978 #endif
1979 #endif
1981 /* Record this as an active process, with its channels.
1982 As a result, child_setup will close Emacs's side of the pipes. */
1983 chan_process[inchannel] = process;
1984 XPROCESS (process)->infd = inchannel;
1985 XPROCESS (process)->outfd = outchannel;
1987 /* Previously we recorded the tty descriptor used in the subprocess.
1988 It was only used for getting the foreground tty process, so now
1989 we just reopen the device (see emacs_get_tty_pgrp) as this is
1990 more portable (see USG_SUBTTY_WORKS above). */
1992 XPROCESS (process)->pty_flag = pty_flag;
1993 XPROCESS (process)->status = Qrun;
1994 setup_process_coding_systems (process);
1996 FD_SET (inchannel, &input_wait_mask);
1997 FD_SET (inchannel, &non_keyboard_wait_mask);
1998 if (inchannel > max_process_desc)
1999 max_process_desc = inchannel;
2001 XPROCESS (process)->pid = -2;
2002 #ifdef HAVE_PTYS
2003 if (pty_flag)
2004 XPROCESS (process)->tty_name = build_string (pty_name);
2005 else
2006 #endif
2007 XPROCESS (process)->tty_name = Qnil;
2011 /* Convert an internal struct sockaddr to a lisp object (vector or string).
2012 The address family of sa is not included in the result. */
2014 static Lisp_Object
2015 conv_sockaddr_to_lisp (struct sockaddr *sa, int len)
2017 Lisp_Object address;
2018 int i;
2019 unsigned char *cp;
2020 register struct Lisp_Vector *p;
2022 /* Workaround for a bug in getsockname on BSD: Names bound to
2023 sockets in the UNIX domain are inaccessible; getsockname returns
2024 a zero length name. */
2025 if (len < offsetof (struct sockaddr, sa_family) + sizeof (sa->sa_family))
2026 return empty_unibyte_string;
2028 switch (sa->sa_family)
2030 case AF_INET:
2032 struct sockaddr_in *sin = (struct sockaddr_in *) sa;
2033 len = sizeof (sin->sin_addr) + 1;
2034 address = Fmake_vector (make_number (len), Qnil);
2035 p = XVECTOR (address);
2036 p->contents[--len] = make_number (ntohs (sin->sin_port));
2037 cp = (unsigned char *) &sin->sin_addr;
2038 break;
2040 #ifdef AF_INET6
2041 case AF_INET6:
2043 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *) sa;
2044 uint16_t *ip6 = (uint16_t *) &sin6->sin6_addr;
2045 len = sizeof (sin6->sin6_addr)/2 + 1;
2046 address = Fmake_vector (make_number (len), Qnil);
2047 p = XVECTOR (address);
2048 p->contents[--len] = make_number (ntohs (sin6->sin6_port));
2049 for (i = 0; i < len; i++)
2050 p->contents[i] = make_number (ntohs (ip6[i]));
2051 return address;
2053 #endif
2054 #ifdef HAVE_LOCAL_SOCKETS
2055 case AF_LOCAL:
2057 struct sockaddr_un *sockun = (struct sockaddr_un *) sa;
2058 for (i = 0; i < sizeof (sockun->sun_path); i++)
2059 if (sockun->sun_path[i] == 0)
2060 break;
2061 return make_unibyte_string (sockun->sun_path, i);
2063 #endif
2064 default:
2065 len -= offsetof (struct sockaddr, sa_family) + sizeof (sa->sa_family);
2066 address = Fcons (make_number (sa->sa_family),
2067 Fmake_vector (make_number (len), Qnil));
2068 p = XVECTOR (XCDR (address));
2069 cp = (unsigned char *) &sa->sa_family + sizeof (sa->sa_family);
2070 break;
2073 i = 0;
2074 while (i < len)
2075 p->contents[i++] = make_number (*cp++);
2077 return address;
2081 /* Get family and required size for sockaddr structure to hold ADDRESS. */
2083 static int
2084 get_lisp_to_sockaddr_size (Lisp_Object address, int *familyp)
2086 register struct Lisp_Vector *p;
2088 if (VECTORP (address))
2090 p = XVECTOR (address);
2091 if (p->header.size == 5)
2093 *familyp = AF_INET;
2094 return sizeof (struct sockaddr_in);
2096 #ifdef AF_INET6
2097 else if (p->header.size == 9)
2099 *familyp = AF_INET6;
2100 return sizeof (struct sockaddr_in6);
2102 #endif
2104 #ifdef HAVE_LOCAL_SOCKETS
2105 else if (STRINGP (address))
2107 *familyp = AF_LOCAL;
2108 return sizeof (struct sockaddr_un);
2110 #endif
2111 else if (CONSP (address) && TYPE_RANGED_INTEGERP (int, XCAR (address))
2112 && VECTORP (XCDR (address)))
2114 struct sockaddr *sa;
2115 *familyp = XINT (XCAR (address));
2116 p = XVECTOR (XCDR (address));
2117 return p->header.size + sizeof (sa->sa_family);
2119 return 0;
2122 /* Convert an address object (vector or string) to an internal sockaddr.
2124 The address format has been basically validated by
2125 get_lisp_to_sockaddr_size, but this does not mean FAMILY is valid;
2126 it could have come from user data. So if FAMILY is not valid,
2127 we return after zeroing *SA. */
2129 static void
2130 conv_lisp_to_sockaddr (int family, Lisp_Object address, struct sockaddr *sa, int len)
2132 register struct Lisp_Vector *p;
2133 register unsigned char *cp = NULL;
2134 register int i;
2135 EMACS_INT hostport;
2137 memset (sa, 0, len);
2139 if (VECTORP (address))
2141 p = XVECTOR (address);
2142 if (family == AF_INET)
2144 struct sockaddr_in *sin = (struct sockaddr_in *) sa;
2145 len = sizeof (sin->sin_addr) + 1;
2146 hostport = XINT (p->contents[--len]);
2147 sin->sin_port = htons (hostport);
2148 cp = (unsigned char *)&sin->sin_addr;
2149 sa->sa_family = family;
2151 #ifdef AF_INET6
2152 else if (family == AF_INET6)
2154 struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *) sa;
2155 uint16_t *ip6 = (uint16_t *)&sin6->sin6_addr;
2156 len = sizeof (sin6->sin6_addr) + 1;
2157 hostport = XINT (p->contents[--len]);
2158 sin6->sin6_port = htons (hostport);
2159 for (i = 0; i < len; i++)
2160 if (INTEGERP (p->contents[i]))
2162 int j = XFASTINT (p->contents[i]) & 0xffff;
2163 ip6[i] = ntohs (j);
2165 sa->sa_family = family;
2166 return;
2168 #endif
2169 else
2170 return;
2172 else if (STRINGP (address))
2174 #ifdef HAVE_LOCAL_SOCKETS
2175 if (family == AF_LOCAL)
2177 struct sockaddr_un *sockun = (struct sockaddr_un *) sa;
2178 cp = SDATA (address);
2179 for (i = 0; i < sizeof (sockun->sun_path) && *cp; i++)
2180 sockun->sun_path[i] = *cp++;
2181 sa->sa_family = family;
2183 #endif
2184 return;
2186 else
2188 p = XVECTOR (XCDR (address));
2189 cp = (unsigned char *)sa + sizeof (sa->sa_family);
2192 for (i = 0; i < len; i++)
2193 if (INTEGERP (p->contents[i]))
2194 *cp++ = XFASTINT (p->contents[i]) & 0xff;
2197 #ifdef DATAGRAM_SOCKETS
2198 DEFUN ("process-datagram-address", Fprocess_datagram_address, Sprocess_datagram_address,
2199 1, 1, 0,
2200 doc: /* Get the current datagram address associated with PROCESS. */)
2201 (Lisp_Object process)
2203 int channel;
2205 CHECK_PROCESS (process);
2207 if (!DATAGRAM_CONN_P (process))
2208 return Qnil;
2210 channel = XPROCESS (process)->infd;
2211 return conv_sockaddr_to_lisp (datagram_address[channel].sa,
2212 datagram_address[channel].len);
2215 DEFUN ("set-process-datagram-address", Fset_process_datagram_address, Sset_process_datagram_address,
2216 2, 2, 0,
2217 doc: /* Set the datagram address for PROCESS to ADDRESS.
2218 Returns nil upon error setting address, ADDRESS otherwise. */)
2219 (Lisp_Object process, Lisp_Object address)
2221 int channel;
2222 int family, len;
2224 CHECK_PROCESS (process);
2226 if (!DATAGRAM_CONN_P (process))
2227 return Qnil;
2229 channel = XPROCESS (process)->infd;
2231 len = get_lisp_to_sockaddr_size (address, &family);
2232 if (datagram_address[channel].len != len)
2233 return Qnil;
2234 conv_lisp_to_sockaddr (family, address, datagram_address[channel].sa, len);
2235 return address;
2237 #endif
2240 static const struct socket_options {
2241 /* The name of this option. Should be lowercase version of option
2242 name without SO_ prefix. */
2243 const char *name;
2244 /* Option level SOL_... */
2245 int optlevel;
2246 /* Option number SO_... */
2247 int optnum;
2248 enum { SOPT_UNKNOWN, SOPT_BOOL, SOPT_INT, SOPT_IFNAME, SOPT_LINGER } opttype;
2249 enum { OPIX_NONE=0, OPIX_MISC=1, OPIX_REUSEADDR=2 } optbit;
2250 } socket_options[] =
2252 #ifdef SO_BINDTODEVICE
2253 { ":bindtodevice", SOL_SOCKET, SO_BINDTODEVICE, SOPT_IFNAME, OPIX_MISC },
2254 #endif
2255 #ifdef SO_BROADCAST
2256 { ":broadcast", SOL_SOCKET, SO_BROADCAST, SOPT_BOOL, OPIX_MISC },
2257 #endif
2258 #ifdef SO_DONTROUTE
2259 { ":dontroute", SOL_SOCKET, SO_DONTROUTE, SOPT_BOOL, OPIX_MISC },
2260 #endif
2261 #ifdef SO_KEEPALIVE
2262 { ":keepalive", SOL_SOCKET, SO_KEEPALIVE, SOPT_BOOL, OPIX_MISC },
2263 #endif
2264 #ifdef SO_LINGER
2265 { ":linger", SOL_SOCKET, SO_LINGER, SOPT_LINGER, OPIX_MISC },
2266 #endif
2267 #ifdef SO_OOBINLINE
2268 { ":oobinline", SOL_SOCKET, SO_OOBINLINE, SOPT_BOOL, OPIX_MISC },
2269 #endif
2270 #ifdef SO_PRIORITY
2271 { ":priority", SOL_SOCKET, SO_PRIORITY, SOPT_INT, OPIX_MISC },
2272 #endif
2273 #ifdef SO_REUSEADDR
2274 { ":reuseaddr", SOL_SOCKET, SO_REUSEADDR, SOPT_BOOL, OPIX_REUSEADDR },
2275 #endif
2276 { 0, 0, 0, SOPT_UNKNOWN, OPIX_NONE }
2279 /* Set option OPT to value VAL on socket S.
2281 Returns (1<<socket_options[OPT].optbit) if option is known, 0 otherwise.
2282 Signals an error if setting a known option fails.
2285 static int
2286 set_socket_option (int s, Lisp_Object opt, Lisp_Object val)
2288 char *name;
2289 const struct socket_options *sopt;
2290 int ret = 0;
2292 CHECK_SYMBOL (opt);
2294 name = SSDATA (SYMBOL_NAME (opt));
2295 for (sopt = socket_options; sopt->name; sopt++)
2296 if (strcmp (name, sopt->name) == 0)
2297 break;
2299 switch (sopt->opttype)
2301 case SOPT_BOOL:
2303 int optval;
2304 optval = NILP (val) ? 0 : 1;
2305 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2306 &optval, sizeof (optval));
2307 break;
2310 case SOPT_INT:
2312 int optval;
2313 if (TYPE_RANGED_INTEGERP (int, val))
2314 optval = XINT (val);
2315 else
2316 error ("Bad option value for %s", name);
2317 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2318 &optval, sizeof (optval));
2319 break;
2322 #ifdef SO_BINDTODEVICE
2323 case SOPT_IFNAME:
2325 char devname[IFNAMSIZ+1];
2327 /* This is broken, at least in the Linux 2.4 kernel.
2328 To unbind, the arg must be a zero integer, not the empty string.
2329 This should work on all systems. KFS. 2003-09-23. */
2330 memset (devname, 0, sizeof devname);
2331 if (STRINGP (val))
2333 char *arg = SSDATA (val);
2334 int len = min (strlen (arg), IFNAMSIZ);
2335 memcpy (devname, arg, len);
2337 else if (!NILP (val))
2338 error ("Bad option value for %s", name);
2339 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2340 devname, IFNAMSIZ);
2341 break;
2343 #endif
2345 #ifdef SO_LINGER
2346 case SOPT_LINGER:
2348 struct linger linger;
2350 linger.l_onoff = 1;
2351 linger.l_linger = 0;
2352 if (TYPE_RANGED_INTEGERP (int, val))
2353 linger.l_linger = XINT (val);
2354 else
2355 linger.l_onoff = NILP (val) ? 0 : 1;
2356 ret = setsockopt (s, sopt->optlevel, sopt->optnum,
2357 &linger, sizeof (linger));
2358 break;
2360 #endif
2362 default:
2363 return 0;
2366 if (ret < 0)
2367 report_file_error ("Cannot set network option",
2368 Fcons (opt, Fcons (val, Qnil)));
2369 return (1 << sopt->optbit);
2373 DEFUN ("set-network-process-option",
2374 Fset_network_process_option, Sset_network_process_option,
2375 3, 4, 0,
2376 doc: /* For network process PROCESS set option OPTION to value VALUE.
2377 See `make-network-process' for a list of options and values.
2378 If optional fourth arg NO-ERROR is non-nil, don't signal an error if
2379 OPTION is not a supported option, return nil instead; otherwise return t. */)
2380 (Lisp_Object process, Lisp_Object option, Lisp_Object value, Lisp_Object no_error)
2382 int s;
2383 struct Lisp_Process *p;
2385 CHECK_PROCESS (process);
2386 p = XPROCESS (process);
2387 if (!NETCONN1_P (p))
2388 error ("Process is not a network process");
2390 s = p->infd;
2391 if (s < 0)
2392 error ("Process is not running");
2394 if (set_socket_option (s, option, value))
2396 p->childp = Fplist_put (p->childp, option, value);
2397 return Qt;
2400 if (NILP (no_error))
2401 error ("Unknown or unsupported option");
2403 return Qnil;
2407 DEFUN ("serial-process-configure",
2408 Fserial_process_configure,
2409 Sserial_process_configure,
2410 0, MANY, 0,
2411 doc: /* Configure speed, bytesize, etc. of a serial process.
2413 Arguments are specified as keyword/argument pairs. Attributes that
2414 are not given are re-initialized from the process's current
2415 configuration (available via the function `process-contact') or set to
2416 reasonable default values. The following arguments are defined:
2418 :process PROCESS
2419 :name NAME
2420 :buffer BUFFER
2421 :port PORT
2422 -- Any of these arguments can be given to identify the process that is
2423 to be configured. If none of these arguments is given, the current
2424 buffer's process is used.
2426 :speed SPEED -- SPEED is the speed of the serial port in bits per
2427 second, also called baud rate. Any value can be given for SPEED, but
2428 most serial ports work only at a few defined values between 1200 and
2429 115200, with 9600 being the most common value. If SPEED is nil, the
2430 serial port is not configured any further, i.e., all other arguments
2431 are ignored. This may be useful for special serial ports such as
2432 Bluetooth-to-serial converters which can only be configured through AT
2433 commands. A value of nil for SPEED can be used only when passed
2434 through `make-serial-process' or `serial-term'.
2436 :bytesize BYTESIZE -- BYTESIZE is the number of bits per byte, which
2437 can be 7 or 8. If BYTESIZE is not given or nil, a value of 8 is used.
2439 :parity PARITY -- PARITY can be nil (don't use parity), the symbol
2440 `odd' (use odd parity), or the symbol `even' (use even parity). If
2441 PARITY is not given, no parity is used.
2443 :stopbits STOPBITS -- STOPBITS is the number of stopbits used to
2444 terminate a byte transmission. STOPBITS can be 1 or 2. If STOPBITS
2445 is not given or nil, 1 stopbit is used.
2447 :flowcontrol FLOWCONTROL -- FLOWCONTROL determines the type of
2448 flowcontrol to be used, which is either nil (don't use flowcontrol),
2449 the symbol `hw' (use RTS/CTS hardware flowcontrol), or the symbol `sw'
2450 \(use XON/XOFF software flowcontrol). If FLOWCONTROL is not given, no
2451 flowcontrol is used.
2453 `serial-process-configure' is called by `make-serial-process' for the
2454 initial configuration of the serial port.
2456 Examples:
2458 \(serial-process-configure :process "/dev/ttyS0" :speed 1200)
2460 \(serial-process-configure
2461 :buffer "COM1" :stopbits 1 :parity 'odd :flowcontrol 'hw)
2463 \(serial-process-configure :port "\\\\.\\COM13" :bytesize 7)
2465 usage: (serial-process-configure &rest ARGS) */)
2466 (ptrdiff_t nargs, Lisp_Object *args)
2468 struct Lisp_Process *p;
2469 Lisp_Object contact = Qnil;
2470 Lisp_Object proc = Qnil;
2471 struct gcpro gcpro1;
2473 contact = Flist (nargs, args);
2474 GCPRO1 (contact);
2476 proc = Fplist_get (contact, QCprocess);
2477 if (NILP (proc))
2478 proc = Fplist_get (contact, QCname);
2479 if (NILP (proc))
2480 proc = Fplist_get (contact, QCbuffer);
2481 if (NILP (proc))
2482 proc = Fplist_get (contact, QCport);
2483 proc = get_process (proc);
2484 p = XPROCESS (proc);
2485 if (!EQ (p->type, Qserial))
2486 error ("Not a serial process");
2488 if (NILP (Fplist_get (p->childp, QCspeed)))
2490 UNGCPRO;
2491 return Qnil;
2494 serial_configure (p, contact);
2496 UNGCPRO;
2497 return Qnil;
2500 /* Used by make-serial-process to recover from errors. */
2501 static Lisp_Object
2502 make_serial_process_unwind (Lisp_Object proc)
2504 if (!PROCESSP (proc))
2505 abort ();
2506 remove_process (proc);
2507 return Qnil;
2510 DEFUN ("make-serial-process", Fmake_serial_process, Smake_serial_process,
2511 0, MANY, 0,
2512 doc: /* Create and return a serial port process.
2514 In Emacs, serial port connections are represented by process objects,
2515 so input and output work as for subprocesses, and `delete-process'
2516 closes a serial port connection. However, a serial process has no
2517 process id, it cannot be signaled, and the status codes are different
2518 from normal processes.
2520 `make-serial-process' creates a process and a buffer, on which you
2521 probably want to use `process-send-string'. Try \\[serial-term] for
2522 an interactive terminal. See below for examples.
2524 Arguments are specified as keyword/argument pairs. The following
2525 arguments are defined:
2527 :port PORT -- (mandatory) PORT is the path or name of the serial port.
2528 For example, this could be "/dev/ttyS0" on Unix. On Windows, this
2529 could be "COM1", or "\\\\.\\COM10" for ports higher than COM9 (double
2530 the backslashes in strings).
2532 :speed SPEED -- (mandatory) is handled by `serial-process-configure',
2533 which this function calls.
2535 :name NAME -- NAME is the name of the process. If NAME is not given,
2536 the value of PORT is used.
2538 :buffer BUFFER -- BUFFER is the buffer (or buffer-name) to associate
2539 with the process. Process output goes at the end of that buffer,
2540 unless you specify an output stream or filter function to handle the
2541 output. If BUFFER is not given, the value of NAME is used.
2543 :coding CODING -- If CODING is a symbol, it specifies the coding
2544 system used for both reading and writing for this process. If CODING
2545 is a cons (DECODING . ENCODING), DECODING is used for reading, and
2546 ENCODING is used for writing.
2548 :noquery BOOL -- When exiting Emacs, query the user if BOOL is nil and
2549 the process is running. If BOOL is not given, query before exiting.
2551 :stop BOOL -- Start process in the `stopped' state if BOOL is non-nil.
2552 In the stopped state, a serial process does not accept incoming data,
2553 but you can send outgoing data. The stopped state is cleared by
2554 `continue-process' and set by `stop-process'.
2556 :filter FILTER -- Install FILTER as the process filter.
2558 :sentinel SENTINEL -- Install SENTINEL as the process sentinel.
2560 :plist PLIST -- Install PLIST as the initial plist of the process.
2562 :bytesize
2563 :parity
2564 :stopbits
2565 :flowcontrol
2566 -- This function calls `serial-process-configure' to handle these
2567 arguments.
2569 The original argument list, possibly modified by later configuration,
2570 is available via the function `process-contact'.
2572 Examples:
2574 \(make-serial-process :port "/dev/ttyS0" :speed 9600)
2576 \(make-serial-process :port "COM1" :speed 115200 :stopbits 2)
2578 \(make-serial-process :port "\\\\.\\COM13" :speed 1200 :bytesize 7 :parity 'odd)
2580 \(make-serial-process :port "/dev/tty.BlueConsole-SPP-1" :speed nil)
2582 usage: (make-serial-process &rest ARGS) */)
2583 (ptrdiff_t nargs, Lisp_Object *args)
2585 int fd = -1;
2586 Lisp_Object proc, contact, port;
2587 struct Lisp_Process *p;
2588 struct gcpro gcpro1;
2589 Lisp_Object name, buffer;
2590 Lisp_Object tem, val;
2591 ptrdiff_t specpdl_count = -1;
2593 if (nargs == 0)
2594 return Qnil;
2596 contact = Flist (nargs, args);
2597 GCPRO1 (contact);
2599 port = Fplist_get (contact, QCport);
2600 if (NILP (port))
2601 error ("No port specified");
2602 CHECK_STRING (port);
2604 if (NILP (Fplist_member (contact, QCspeed)))
2605 error (":speed not specified");
2606 if (!NILP (Fplist_get (contact, QCspeed)))
2607 CHECK_NUMBER (Fplist_get (contact, QCspeed));
2609 name = Fplist_get (contact, QCname);
2610 if (NILP (name))
2611 name = port;
2612 CHECK_STRING (name);
2613 proc = make_process (name);
2614 specpdl_count = SPECPDL_INDEX ();
2615 record_unwind_protect (make_serial_process_unwind, proc);
2616 p = XPROCESS (proc);
2618 fd = serial_open (SSDATA (port));
2619 p->infd = fd;
2620 p->outfd = fd;
2621 if (fd > max_process_desc)
2622 max_process_desc = fd;
2623 chan_process[fd] = proc;
2625 buffer = Fplist_get (contact, QCbuffer);
2626 if (NILP (buffer))
2627 buffer = name;
2628 buffer = Fget_buffer_create (buffer);
2629 p->buffer = buffer;
2631 p->childp = contact;
2632 p->plist = Fcopy_sequence (Fplist_get (contact, QCplist));
2633 p->type = Qserial;
2634 p->sentinel = Fplist_get (contact, QCsentinel);
2635 p->filter = Fplist_get (contact, QCfilter);
2636 p->log = Qnil;
2637 if (tem = Fplist_get (contact, QCnoquery), !NILP (tem))
2638 p->kill_without_query = 1;
2639 if (tem = Fplist_get (contact, QCstop), !NILP (tem))
2640 p->command = Qt;
2641 p->pty_flag = 0;
2643 if (!EQ (p->command, Qt))
2645 FD_SET (fd, &input_wait_mask);
2646 FD_SET (fd, &non_keyboard_wait_mask);
2649 if (BUFFERP (buffer))
2651 set_marker_both (p->mark, buffer,
2652 BUF_ZV (XBUFFER (buffer)),
2653 BUF_ZV_BYTE (XBUFFER (buffer)));
2656 tem = Fplist_member (contact, QCcoding);
2657 if (!NILP (tem) && (!CONSP (tem) || !CONSP (XCDR (tem))))
2658 tem = Qnil;
2660 val = Qnil;
2661 if (!NILP (tem))
2663 val = XCAR (XCDR (tem));
2664 if (CONSP (val))
2665 val = XCAR (val);
2667 else if (!NILP (Vcoding_system_for_read))
2668 val = Vcoding_system_for_read;
2669 else if ((!NILP (buffer) && NILP (BVAR (XBUFFER (buffer), enable_multibyte_characters)))
2670 || (NILP (buffer) && NILP (BVAR (&buffer_defaults, enable_multibyte_characters))))
2671 val = Qnil;
2672 p->decode_coding_system = val;
2674 val = Qnil;
2675 if (!NILP (tem))
2677 val = XCAR (XCDR (tem));
2678 if (CONSP (val))
2679 val = XCDR (val);
2681 else if (!NILP (Vcoding_system_for_write))
2682 val = Vcoding_system_for_write;
2683 else if ((!NILP (buffer) && NILP (BVAR (XBUFFER (buffer), enable_multibyte_characters)))
2684 || (NILP (buffer) && NILP (BVAR (&buffer_defaults, enable_multibyte_characters))))
2685 val = Qnil;
2686 p->encode_coding_system = val;
2688 setup_process_coding_systems (proc);
2689 p->decoding_buf = empty_unibyte_string;
2690 p->decoding_carryover = 0;
2691 p->encoding_buf = empty_unibyte_string;
2692 p->inherit_coding_system_flag
2693 = !(!NILP (tem) || NILP (buffer) || !inherit_process_coding_system);
2695 Fserial_process_configure (nargs, args);
2697 specpdl_ptr = specpdl + specpdl_count;
2699 UNGCPRO;
2700 return proc;
2703 /* Create a network stream/datagram client/server process. Treated
2704 exactly like a normal process when reading and writing. Primary
2705 differences are in status display and process deletion. A network
2706 connection has no PID; you cannot signal it. All you can do is
2707 stop/continue it and deactivate/close it via delete-process */
2709 DEFUN ("make-network-process", Fmake_network_process, Smake_network_process,
2710 0, MANY, 0,
2711 doc: /* Create and return a network server or client process.
2713 In Emacs, network connections are represented by process objects, so
2714 input and output work as for subprocesses and `delete-process' closes
2715 a network connection. However, a network process has no process id,
2716 it cannot be signaled, and the status codes are different from normal
2717 processes.
2719 Arguments are specified as keyword/argument pairs. The following
2720 arguments are defined:
2722 :name NAME -- NAME is name for process. It is modified if necessary
2723 to make it unique.
2725 :buffer BUFFER -- BUFFER is the buffer (or buffer-name) to associate
2726 with the process. Process output goes at end of that buffer, unless
2727 you specify an output stream or filter function to handle the output.
2728 BUFFER may be also nil, meaning that this process is not associated
2729 with any buffer.
2731 :host HOST -- HOST is name of the host to connect to, or its IP
2732 address. The symbol `local' specifies the local host. If specified
2733 for a server process, it must be a valid name or address for the local
2734 host, and only clients connecting to that address will be accepted.
2736 :service SERVICE -- SERVICE is name of the service desired, or an
2737 integer specifying a port number to connect to. If SERVICE is t,
2738 a random port number is selected for the server. (If Emacs was
2739 compiled with getaddrinfo, a port number can also be specified as a
2740 string, e.g. "80", as well as an integer. This is not portable.)
2742 :type TYPE -- TYPE is the type of connection. The default (nil) is a
2743 stream type connection, `datagram' creates a datagram type connection,
2744 `seqpacket' creates a reliable datagram connection.
2746 :family FAMILY -- FAMILY is the address (and protocol) family for the
2747 service specified by HOST and SERVICE. The default (nil) is to use
2748 whatever address family (IPv4 or IPv6) that is defined for the host
2749 and port number specified by HOST and SERVICE. Other address families
2750 supported are:
2751 local -- for a local (i.e. UNIX) address specified by SERVICE.
2752 ipv4 -- use IPv4 address family only.
2753 ipv6 -- use IPv6 address family only.
2755 :local ADDRESS -- ADDRESS is the local address used for the connection.
2756 This parameter is ignored when opening a client process. When specified
2757 for a server process, the FAMILY, HOST and SERVICE args are ignored.
2759 :remote ADDRESS -- ADDRESS is the remote partner's address for the
2760 connection. This parameter is ignored when opening a stream server
2761 process. For a datagram server process, it specifies the initial
2762 setting of the remote datagram address. When specified for a client
2763 process, the FAMILY, HOST, and SERVICE args are ignored.
2765 The format of ADDRESS depends on the address family:
2766 - An IPv4 address is represented as an vector of integers [A B C D P]
2767 corresponding to numeric IP address A.B.C.D and port number P.
2768 - A local address is represented as a string with the address in the
2769 local address space.
2770 - An "unsupported family" address is represented by a cons (F . AV)
2771 where F is the family number and AV is a vector containing the socket
2772 address data with one element per address data byte. Do not rely on
2773 this format in portable code, as it may depend on implementation
2774 defined constants, data sizes, and data structure alignment.
2776 :coding CODING -- If CODING is a symbol, it specifies the coding
2777 system used for both reading and writing for this process. If CODING
2778 is a cons (DECODING . ENCODING), DECODING is used for reading, and
2779 ENCODING is used for writing.
2781 :nowait BOOL -- If BOOL is non-nil for a stream type client process,
2782 return without waiting for the connection to complete; instead, the
2783 sentinel function will be called with second arg matching "open" (if
2784 successful) or "failed" when the connect completes. Default is to use
2785 a blocking connect (i.e. wait) for stream type connections.
2787 :noquery BOOL -- Query the user unless BOOL is non-nil, and process is
2788 running when Emacs is exited.
2790 :stop BOOL -- Start process in the `stopped' state if BOOL non-nil.
2791 In the stopped state, a server process does not accept new
2792 connections, and a client process does not handle incoming traffic.
2793 The stopped state is cleared by `continue-process' and set by
2794 `stop-process'.
2796 :filter FILTER -- Install FILTER as the process filter.
2798 :filter-multibyte BOOL -- If BOOL is non-nil, strings given to the
2799 process filter are multibyte, otherwise they are unibyte.
2800 If this keyword is not specified, the strings are multibyte if
2801 the default value of `enable-multibyte-characters' is non-nil.
2803 :sentinel SENTINEL -- Install SENTINEL as the process sentinel.
2805 :log LOG -- Install LOG as the server process log function. This
2806 function is called when the server accepts a network connection from a
2807 client. The arguments are SERVER, CLIENT, and MESSAGE, where SERVER
2808 is the server process, CLIENT is the new process for the connection,
2809 and MESSAGE is a string.
2811 :plist PLIST -- Install PLIST as the new process' initial plist.
2813 :server QLEN -- if QLEN is non-nil, create a server process for the
2814 specified FAMILY, SERVICE, and connection type (stream or datagram).
2815 If QLEN is an integer, it is used as the max. length of the server's
2816 pending connection queue (also known as the backlog); the default
2817 queue length is 5. Default is to create a client process.
2819 The following network options can be specified for this connection:
2821 :broadcast BOOL -- Allow send and receive of datagram broadcasts.
2822 :dontroute BOOL -- Only send to directly connected hosts.
2823 :keepalive BOOL -- Send keep-alive messages on network stream.
2824 :linger BOOL or TIMEOUT -- Send queued messages before closing.
2825 :oobinline BOOL -- Place out-of-band data in receive data stream.
2826 :priority INT -- Set protocol defined priority for sent packets.
2827 :reuseaddr BOOL -- Allow reusing a recently used local address
2828 (this is allowed by default for a server process).
2829 :bindtodevice NAME -- bind to interface NAME. Using this may require
2830 special privileges on some systems.
2832 Consult the relevant system programmer's manual pages for more
2833 information on using these options.
2836 A server process will listen for and accept connections from clients.
2837 When a client connection is accepted, a new network process is created
2838 for the connection with the following parameters:
2840 - The client's process name is constructed by concatenating the server
2841 process' NAME and a client identification string.
2842 - If the FILTER argument is non-nil, the client process will not get a
2843 separate process buffer; otherwise, the client's process buffer is a newly
2844 created buffer named after the server process' BUFFER name or process
2845 NAME concatenated with the client identification string.
2846 - The connection type and the process filter and sentinel parameters are
2847 inherited from the server process' TYPE, FILTER and SENTINEL.
2848 - The client process' contact info is set according to the client's
2849 addressing information (typically an IP address and a port number).
2850 - The client process' plist is initialized from the server's plist.
2852 Notice that the FILTER and SENTINEL args are never used directly by
2853 the server process. Also, the BUFFER argument is not used directly by
2854 the server process, but via the optional :log function, accepted (and
2855 failed) connections may be logged in the server process' buffer.
2857 The original argument list, modified with the actual connection
2858 information, is available via the `process-contact' function.
2860 usage: (make-network-process &rest ARGS) */)
2861 (ptrdiff_t nargs, Lisp_Object *args)
2863 Lisp_Object proc;
2864 Lisp_Object contact;
2865 struct Lisp_Process *p;
2866 #ifdef HAVE_GETADDRINFO
2867 struct addrinfo ai, *res, *lres;
2868 struct addrinfo hints;
2869 const char *portstring;
2870 char portbuf[128];
2871 #else /* HAVE_GETADDRINFO */
2872 struct _emacs_addrinfo
2874 int ai_family;
2875 int ai_socktype;
2876 int ai_protocol;
2877 int ai_addrlen;
2878 struct sockaddr *ai_addr;
2879 struct _emacs_addrinfo *ai_next;
2880 } ai, *res, *lres;
2881 #endif /* HAVE_GETADDRINFO */
2882 struct sockaddr_in address_in;
2883 #ifdef HAVE_LOCAL_SOCKETS
2884 struct sockaddr_un address_un;
2885 #endif
2886 int port;
2887 int ret = 0;
2888 int xerrno = 0;
2889 int s = -1, outch, inch;
2890 struct gcpro gcpro1;
2891 ptrdiff_t count = SPECPDL_INDEX ();
2892 ptrdiff_t count1;
2893 Lisp_Object QCaddress; /* one of QClocal or QCremote */
2894 Lisp_Object tem;
2895 Lisp_Object name, buffer, host, service, address;
2896 Lisp_Object filter, sentinel;
2897 int is_non_blocking_client = 0;
2898 int is_server = 0, backlog = 5;
2899 int socktype;
2900 int family = -1;
2902 if (nargs == 0)
2903 return Qnil;
2905 /* Save arguments for process-contact and clone-process. */
2906 contact = Flist (nargs, args);
2907 GCPRO1 (contact);
2909 #ifdef WINDOWSNT
2910 /* Ensure socket support is loaded if available. */
2911 init_winsock (TRUE);
2912 #endif
2914 /* :type TYPE (nil: stream, datagram */
2915 tem = Fplist_get (contact, QCtype);
2916 if (NILP (tem))
2917 socktype = SOCK_STREAM;
2918 #ifdef DATAGRAM_SOCKETS
2919 else if (EQ (tem, Qdatagram))
2920 socktype = SOCK_DGRAM;
2921 #endif
2922 #ifdef HAVE_SEQPACKET
2923 else if (EQ (tem, Qseqpacket))
2924 socktype = SOCK_SEQPACKET;
2925 #endif
2926 else
2927 error ("Unsupported connection type");
2929 /* :server BOOL */
2930 tem = Fplist_get (contact, QCserver);
2931 if (!NILP (tem))
2933 /* Don't support network sockets when non-blocking mode is
2934 not available, since a blocked Emacs is not useful. */
2935 #if !defined (O_NONBLOCK) && !defined (O_NDELAY)
2936 error ("Network servers not supported");
2937 #else
2938 is_server = 1;
2939 if (TYPE_RANGED_INTEGERP (int, tem))
2940 backlog = XINT (tem);
2941 #endif
2944 /* Make QCaddress an alias for :local (server) or :remote (client). */
2945 QCaddress = is_server ? QClocal : QCremote;
2947 /* :nowait BOOL */
2948 if (!is_server && socktype != SOCK_DGRAM
2949 && (tem = Fplist_get (contact, QCnowait), !NILP (tem)))
2951 #ifndef NON_BLOCKING_CONNECT
2952 error ("Non-blocking connect not supported");
2953 #else
2954 is_non_blocking_client = 1;
2955 #endif
2958 name = Fplist_get (contact, QCname);
2959 buffer = Fplist_get (contact, QCbuffer);
2960 filter = Fplist_get (contact, QCfilter);
2961 sentinel = Fplist_get (contact, QCsentinel);
2963 CHECK_STRING (name);
2965 /* Initialize addrinfo structure in case we don't use getaddrinfo. */
2966 ai.ai_socktype = socktype;
2967 ai.ai_protocol = 0;
2968 ai.ai_next = NULL;
2969 res = &ai;
2971 /* :local ADDRESS or :remote ADDRESS */
2972 address = Fplist_get (contact, QCaddress);
2973 if (!NILP (address))
2975 host = service = Qnil;
2977 if (!(ai.ai_addrlen = get_lisp_to_sockaddr_size (address, &family)))
2978 error ("Malformed :address");
2979 ai.ai_family = family;
2980 ai.ai_addr = alloca (ai.ai_addrlen);
2981 conv_lisp_to_sockaddr (family, address, ai.ai_addr, ai.ai_addrlen);
2982 goto open_socket;
2985 /* :family FAMILY -- nil (for Inet), local, or integer. */
2986 tem = Fplist_get (contact, QCfamily);
2987 if (NILP (tem))
2989 #if defined (HAVE_GETADDRINFO) && defined (AF_INET6)
2990 family = AF_UNSPEC;
2991 #else
2992 family = AF_INET;
2993 #endif
2995 #ifdef HAVE_LOCAL_SOCKETS
2996 else if (EQ (tem, Qlocal))
2997 family = AF_LOCAL;
2998 #endif
2999 #ifdef AF_INET6
3000 else if (EQ (tem, Qipv6))
3001 family = AF_INET6;
3002 #endif
3003 else if (EQ (tem, Qipv4))
3004 family = AF_INET;
3005 else if (TYPE_RANGED_INTEGERP (int, tem))
3006 family = XINT (tem);
3007 else
3008 error ("Unknown address family");
3010 ai.ai_family = family;
3012 /* :service SERVICE -- string, integer (port number), or t (random port). */
3013 service = Fplist_get (contact, QCservice);
3015 /* :host HOST -- hostname, ip address, or 'local for localhost. */
3016 host = Fplist_get (contact, QChost);
3017 if (!NILP (host))
3019 if (EQ (host, Qlocal))
3020 /* Depending on setup, "localhost" may map to different IPv4 and/or
3021 IPv6 addresses, so it's better to be explicit. (Bug#6781) */
3022 host = build_string ("127.0.0.1");
3023 CHECK_STRING (host);
3026 #ifdef HAVE_LOCAL_SOCKETS
3027 if (family == AF_LOCAL)
3029 if (!NILP (host))
3031 message (":family local ignores the :host \"%s\" property",
3032 SDATA (host));
3033 contact = Fplist_put (contact, QChost, Qnil);
3034 host = Qnil;
3036 CHECK_STRING (service);
3037 memset (&address_un, 0, sizeof address_un);
3038 address_un.sun_family = AF_LOCAL;
3039 strncpy (address_un.sun_path, SSDATA (service), sizeof address_un.sun_path);
3040 ai.ai_addr = (struct sockaddr *) &address_un;
3041 ai.ai_addrlen = sizeof address_un;
3042 goto open_socket;
3044 #endif
3046 /* Slow down polling to every ten seconds.
3047 Some kernels have a bug which causes retrying connect to fail
3048 after a connect. Polling can interfere with gethostbyname too. */
3049 #ifdef POLL_FOR_INPUT
3050 if (socktype != SOCK_DGRAM)
3052 record_unwind_protect (unwind_stop_other_atimers, Qnil);
3053 bind_polling_period (10);
3055 #endif
3057 #ifdef HAVE_GETADDRINFO
3058 /* If we have a host, use getaddrinfo to resolve both host and service.
3059 Otherwise, use getservbyname to lookup the service. */
3060 if (!NILP (host))
3063 /* SERVICE can either be a string or int.
3064 Convert to a C string for later use by getaddrinfo. */
3065 if (EQ (service, Qt))
3066 portstring = "0";
3067 else if (INTEGERP (service))
3069 sprintf (portbuf, "%"pI"d", XINT (service));
3070 portstring = portbuf;
3072 else
3074 CHECK_STRING (service);
3075 portstring = SSDATA (service);
3078 immediate_quit = 1;
3079 QUIT;
3080 memset (&hints, 0, sizeof (hints));
3081 hints.ai_flags = 0;
3082 hints.ai_family = family;
3083 hints.ai_socktype = socktype;
3084 hints.ai_protocol = 0;
3086 #ifdef HAVE_RES_INIT
3087 res_init ();
3088 #endif
3090 ret = getaddrinfo (SSDATA (host), portstring, &hints, &res);
3091 if (ret)
3092 #ifdef HAVE_GAI_STRERROR
3093 error ("%s/%s %s", SSDATA (host), portstring, gai_strerror (ret));
3094 #else
3095 error ("%s/%s getaddrinfo error %d", SSDATA (host), portstring, ret);
3096 #endif
3097 immediate_quit = 0;
3099 goto open_socket;
3101 #endif /* HAVE_GETADDRINFO */
3103 /* We end up here if getaddrinfo is not defined, or in case no hostname
3104 has been specified (e.g. for a local server process). */
3106 if (EQ (service, Qt))
3107 port = 0;
3108 else if (INTEGERP (service))
3109 port = htons ((unsigned short) XINT (service));
3110 else
3112 struct servent *svc_info;
3113 CHECK_STRING (service);
3114 svc_info = getservbyname (SSDATA (service),
3115 (socktype == SOCK_DGRAM ? "udp" : "tcp"));
3116 if (svc_info == 0)
3117 error ("Unknown service: %s", SDATA (service));
3118 port = svc_info->s_port;
3121 memset (&address_in, 0, sizeof address_in);
3122 address_in.sin_family = family;
3123 address_in.sin_addr.s_addr = INADDR_ANY;
3124 address_in.sin_port = port;
3126 #ifndef HAVE_GETADDRINFO
3127 if (!NILP (host))
3129 struct hostent *host_info_ptr;
3131 /* gethostbyname may fail with TRY_AGAIN, but we don't honor that,
3132 as it may `hang' Emacs for a very long time. */
3133 immediate_quit = 1;
3134 QUIT;
3136 #ifdef HAVE_RES_INIT
3137 res_init ();
3138 #endif
3140 host_info_ptr = gethostbyname (SDATA (host));
3141 immediate_quit = 0;
3143 if (host_info_ptr)
3145 memcpy (&address_in.sin_addr, host_info_ptr->h_addr,
3146 host_info_ptr->h_length);
3147 family = host_info_ptr->h_addrtype;
3148 address_in.sin_family = family;
3150 else
3151 /* Attempt to interpret host as numeric inet address */
3153 unsigned long numeric_addr;
3154 numeric_addr = inet_addr (SSDATA (host));
3155 if (numeric_addr == -1)
3156 error ("Unknown host \"%s\"", SDATA (host));
3158 memcpy (&address_in.sin_addr, &numeric_addr,
3159 sizeof (address_in.sin_addr));
3163 #endif /* not HAVE_GETADDRINFO */
3165 ai.ai_family = family;
3166 ai.ai_addr = (struct sockaddr *) &address_in;
3167 ai.ai_addrlen = sizeof address_in;
3169 open_socket:
3171 /* Do this in case we never enter the for-loop below. */
3172 count1 = SPECPDL_INDEX ();
3173 s = -1;
3175 for (lres = res; lres; lres = lres->ai_next)
3177 ptrdiff_t optn;
3178 int optbits;
3180 #ifdef WINDOWSNT
3181 retry_connect:
3182 #endif
3184 s = socket (lres->ai_family, lres->ai_socktype, lres->ai_protocol);
3185 if (s < 0)
3187 xerrno = errno;
3188 continue;
3191 #ifdef DATAGRAM_SOCKETS
3192 if (!is_server && socktype == SOCK_DGRAM)
3193 break;
3194 #endif /* DATAGRAM_SOCKETS */
3196 #ifdef NON_BLOCKING_CONNECT
3197 if (is_non_blocking_client)
3199 #ifdef O_NONBLOCK
3200 ret = fcntl (s, F_SETFL, O_NONBLOCK);
3201 #else
3202 ret = fcntl (s, F_SETFL, O_NDELAY);
3203 #endif
3204 if (ret < 0)
3206 xerrno = errno;
3207 emacs_close (s);
3208 s = -1;
3209 continue;
3212 #endif
3214 /* Make us close S if quit. */
3215 record_unwind_protect (close_file_unwind, make_number (s));
3217 /* Parse network options in the arg list.
3218 We simply ignore anything which isn't a known option (including other keywords).
3219 An error is signaled if setting a known option fails. */
3220 for (optn = optbits = 0; optn < nargs-1; optn += 2)
3221 optbits |= set_socket_option (s, args[optn], args[optn+1]);
3223 if (is_server)
3225 /* Configure as a server socket. */
3227 /* SO_REUSEADDR = 1 is default for server sockets; must specify
3228 explicit :reuseaddr key to override this. */
3229 #ifdef HAVE_LOCAL_SOCKETS
3230 if (family != AF_LOCAL)
3231 #endif
3232 if (!(optbits & (1 << OPIX_REUSEADDR)))
3234 int optval = 1;
3235 if (setsockopt (s, SOL_SOCKET, SO_REUSEADDR, &optval, sizeof optval))
3236 report_file_error ("Cannot set reuse option on server socket", Qnil);
3239 if (bind (s, lres->ai_addr, lres->ai_addrlen))
3240 report_file_error ("Cannot bind server socket", Qnil);
3242 #ifdef HAVE_GETSOCKNAME
3243 if (EQ (service, Qt))
3245 struct sockaddr_in sa1;
3246 socklen_t len1 = sizeof (sa1);
3247 if (getsockname (s, (struct sockaddr *)&sa1, &len1) == 0)
3249 ((struct sockaddr_in *)(lres->ai_addr))->sin_port = sa1.sin_port;
3250 service = make_number (ntohs (sa1.sin_port));
3251 contact = Fplist_put (contact, QCservice, service);
3254 #endif
3256 if (socktype != SOCK_DGRAM && listen (s, backlog))
3257 report_file_error ("Cannot listen on server socket", Qnil);
3259 break;
3262 immediate_quit = 1;
3263 QUIT;
3265 ret = connect (s, lres->ai_addr, lres->ai_addrlen);
3266 xerrno = errno;
3268 if (ret == 0 || xerrno == EISCONN)
3270 /* The unwind-protect will be discarded afterwards.
3271 Likewise for immediate_quit. */
3272 break;
3275 #ifdef NON_BLOCKING_CONNECT
3276 #ifdef EINPROGRESS
3277 if (is_non_blocking_client && xerrno == EINPROGRESS)
3278 break;
3279 #else
3280 #ifdef EWOULDBLOCK
3281 if (is_non_blocking_client && xerrno == EWOULDBLOCK)
3282 break;
3283 #endif
3284 #endif
3285 #endif
3287 #ifndef WINDOWSNT
3288 if (xerrno == EINTR)
3290 /* Unlike most other syscalls connect() cannot be called
3291 again. (That would return EALREADY.) The proper way to
3292 wait for completion is pselect(). */
3293 int sc;
3294 socklen_t len;
3295 SELECT_TYPE fdset;
3296 retry_select:
3297 FD_ZERO (&fdset);
3298 FD_SET (s, &fdset);
3299 QUIT;
3300 sc = pselect (s + 1, NULL, &fdset, NULL, NULL, NULL);
3301 if (sc == -1)
3303 if (errno == EINTR)
3304 goto retry_select;
3305 else
3306 report_file_error ("select failed", Qnil);
3308 eassert (sc > 0);
3310 len = sizeof xerrno;
3311 eassert (FD_ISSET (s, &fdset));
3312 if (getsockopt (s, SOL_SOCKET, SO_ERROR, &xerrno, &len) == -1)
3313 report_file_error ("getsockopt failed", Qnil);
3314 if (xerrno)
3315 errno = xerrno, report_file_error ("error during connect", Qnil);
3316 else
3317 break;
3319 #endif /* !WINDOWSNT */
3321 immediate_quit = 0;
3323 /* Discard the unwind protect closing S. */
3324 specpdl_ptr = specpdl + count1;
3325 emacs_close (s);
3326 s = -1;
3328 #ifdef WINDOWSNT
3329 if (xerrno == EINTR)
3330 goto retry_connect;
3331 #endif
3334 if (s >= 0)
3336 #ifdef DATAGRAM_SOCKETS
3337 if (socktype == SOCK_DGRAM)
3339 if (datagram_address[s].sa)
3340 abort ();
3341 datagram_address[s].sa = (struct sockaddr *) xmalloc (lres->ai_addrlen);
3342 datagram_address[s].len = lres->ai_addrlen;
3343 if (is_server)
3345 Lisp_Object remote;
3346 memset (datagram_address[s].sa, 0, lres->ai_addrlen);
3347 if (remote = Fplist_get (contact, QCremote), !NILP (remote))
3349 int rfamily, rlen;
3350 rlen = get_lisp_to_sockaddr_size (remote, &rfamily);
3351 if (rfamily == lres->ai_family && rlen == lres->ai_addrlen)
3352 conv_lisp_to_sockaddr (rfamily, remote,
3353 datagram_address[s].sa, rlen);
3356 else
3357 memcpy (datagram_address[s].sa, lres->ai_addr, lres->ai_addrlen);
3359 #endif
3360 contact = Fplist_put (contact, QCaddress,
3361 conv_sockaddr_to_lisp (lres->ai_addr, lres->ai_addrlen));
3362 #ifdef HAVE_GETSOCKNAME
3363 if (!is_server)
3365 struct sockaddr_in sa1;
3366 socklen_t len1 = sizeof (sa1);
3367 if (getsockname (s, (struct sockaddr *)&sa1, &len1) == 0)
3368 contact = Fplist_put (contact, QClocal,
3369 conv_sockaddr_to_lisp ((struct sockaddr *)&sa1, len1));
3371 #endif
3374 immediate_quit = 0;
3376 #ifdef HAVE_GETADDRINFO
3377 if (res != &ai)
3379 BLOCK_INPUT;
3380 freeaddrinfo (res);
3381 UNBLOCK_INPUT;
3383 #endif
3385 /* Discard the unwind protect for closing S, if any. */
3386 specpdl_ptr = specpdl + count1;
3388 /* Unwind bind_polling_period and request_sigio. */
3389 unbind_to (count, Qnil);
3391 if (s < 0)
3393 /* If non-blocking got this far - and failed - assume non-blocking is
3394 not supported after all. This is probably a wrong assumption, but
3395 the normal blocking calls to open-network-stream handles this error
3396 better. */
3397 if (is_non_blocking_client)
3398 return Qnil;
3400 errno = xerrno;
3401 if (is_server)
3402 report_file_error ("make server process failed", contact);
3403 else
3404 report_file_error ("make client process failed", contact);
3407 inch = s;
3408 outch = s;
3410 if (!NILP (buffer))
3411 buffer = Fget_buffer_create (buffer);
3412 proc = make_process (name);
3414 chan_process[inch] = proc;
3416 #ifdef O_NONBLOCK
3417 fcntl (inch, F_SETFL, O_NONBLOCK);
3418 #else
3419 #ifdef O_NDELAY
3420 fcntl (inch, F_SETFL, O_NDELAY);
3421 #endif
3422 #endif
3424 p = XPROCESS (proc);
3426 p->childp = contact;
3427 p->plist = Fcopy_sequence (Fplist_get (contact, QCplist));
3428 p->type = Qnetwork;
3430 p->buffer = buffer;
3431 p->sentinel = sentinel;
3432 p->filter = filter;
3433 p->log = Fplist_get (contact, QClog);
3434 if (tem = Fplist_get (contact, QCnoquery), !NILP (tem))
3435 p->kill_without_query = 1;
3436 if ((tem = Fplist_get (contact, QCstop), !NILP (tem)))
3437 p->command = Qt;
3438 p->pid = 0;
3439 p->infd = inch;
3440 p->outfd = outch;
3441 if (is_server && socktype != SOCK_DGRAM)
3442 p->status = Qlisten;
3444 /* Make the process marker point into the process buffer (if any). */
3445 if (BUFFERP (buffer))
3446 set_marker_both (p->mark, buffer,
3447 BUF_ZV (XBUFFER (buffer)),
3448 BUF_ZV_BYTE (XBUFFER (buffer)));
3450 #ifdef NON_BLOCKING_CONNECT
3451 if (is_non_blocking_client)
3453 /* We may get here if connect did succeed immediately. However,
3454 in that case, we still need to signal this like a non-blocking
3455 connection. */
3456 p->status = Qconnect;
3457 if (!FD_ISSET (inch, &connect_wait_mask))
3459 FD_SET (inch, &connect_wait_mask);
3460 FD_SET (inch, &write_mask);
3461 num_pending_connects++;
3464 else
3465 #endif
3466 /* A server may have a client filter setting of Qt, but it must
3467 still listen for incoming connects unless it is stopped. */
3468 if ((!EQ (p->filter, Qt) && !EQ (p->command, Qt))
3469 || (EQ (p->status, Qlisten) && NILP (p->command)))
3471 FD_SET (inch, &input_wait_mask);
3472 FD_SET (inch, &non_keyboard_wait_mask);
3475 if (inch > max_process_desc)
3476 max_process_desc = inch;
3478 tem = Fplist_member (contact, QCcoding);
3479 if (!NILP (tem) && (!CONSP (tem) || !CONSP (XCDR (tem))))
3480 tem = Qnil; /* No error message (too late!). */
3483 /* Setup coding systems for communicating with the network stream. */
3484 struct gcpro gcpro1;
3485 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
3486 Lisp_Object coding_systems = Qt;
3487 Lisp_Object fargs[5], val;
3489 if (!NILP (tem))
3491 val = XCAR (XCDR (tem));
3492 if (CONSP (val))
3493 val = XCAR (val);
3495 else if (!NILP (Vcoding_system_for_read))
3496 val = Vcoding_system_for_read;
3497 else if ((!NILP (buffer) && NILP (BVAR (XBUFFER (buffer), enable_multibyte_characters)))
3498 || (NILP (buffer) && NILP (BVAR (&buffer_defaults, enable_multibyte_characters))))
3499 /* We dare not decode end-of-line format by setting VAL to
3500 Qraw_text, because the existing Emacs Lisp libraries
3501 assume that they receive bare code including a sequence of
3502 CR LF. */
3503 val = Qnil;
3504 else
3506 if (NILP (host) || NILP (service))
3507 coding_systems = Qnil;
3508 else
3510 fargs[0] = Qopen_network_stream, fargs[1] = name,
3511 fargs[2] = buffer, fargs[3] = host, fargs[4] = service;
3512 GCPRO1 (proc);
3513 coding_systems = Ffind_operation_coding_system (5, fargs);
3514 UNGCPRO;
3516 if (CONSP (coding_systems))
3517 val = XCAR (coding_systems);
3518 else if (CONSP (Vdefault_process_coding_system))
3519 val = XCAR (Vdefault_process_coding_system);
3520 else
3521 val = Qnil;
3523 p->decode_coding_system = val;
3525 if (!NILP (tem))
3527 val = XCAR (XCDR (tem));
3528 if (CONSP (val))
3529 val = XCDR (val);
3531 else if (!NILP (Vcoding_system_for_write))
3532 val = Vcoding_system_for_write;
3533 else if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
3534 val = Qnil;
3535 else
3537 if (EQ (coding_systems, Qt))
3539 if (NILP (host) || NILP (service))
3540 coding_systems = Qnil;
3541 else
3543 fargs[0] = Qopen_network_stream, fargs[1] = name,
3544 fargs[2] = buffer, fargs[3] = host, fargs[4] = service;
3545 GCPRO1 (proc);
3546 coding_systems = Ffind_operation_coding_system (5, fargs);
3547 UNGCPRO;
3550 if (CONSP (coding_systems))
3551 val = XCDR (coding_systems);
3552 else if (CONSP (Vdefault_process_coding_system))
3553 val = XCDR (Vdefault_process_coding_system);
3554 else
3555 val = Qnil;
3557 p->encode_coding_system = val;
3559 setup_process_coding_systems (proc);
3561 p->decoding_buf = empty_unibyte_string;
3562 p->decoding_carryover = 0;
3563 p->encoding_buf = empty_unibyte_string;
3565 p->inherit_coding_system_flag
3566 = !(!NILP (tem) || NILP (buffer) || !inherit_process_coding_system);
3568 UNGCPRO;
3569 return proc;
3573 #if defined (HAVE_NET_IF_H)
3575 #ifdef SIOCGIFCONF
3576 DEFUN ("network-interface-list", Fnetwork_interface_list, Snetwork_interface_list, 0, 0, 0,
3577 doc: /* Return an alist of all network interfaces and their network address.
3578 Each element is a cons, the car of which is a string containing the
3579 interface name, and the cdr is the network address in internal
3580 format; see the description of ADDRESS in `make-network-process'. */)
3581 (void)
3583 struct ifconf ifconf;
3584 struct ifreq *ifreq;
3585 void *buf = NULL;
3586 ptrdiff_t buf_size = 512;
3587 int s, i;
3588 Lisp_Object res;
3590 s = socket (AF_INET, SOCK_STREAM, 0);
3591 if (s < 0)
3592 return Qnil;
3596 buf = xpalloc (buf, &buf_size, 1, INT_MAX, 1);
3597 ifconf.ifc_buf = buf;
3598 ifconf.ifc_len = buf_size;
3599 if (ioctl (s, SIOCGIFCONF, &ifconf))
3601 close (s);
3602 xfree (buf);
3603 return Qnil;
3606 while (ifconf.ifc_len == buf_size);
3608 close (s);
3610 res = Qnil;
3611 ifreq = ifconf.ifc_req;
3612 while ((char *) ifreq < (char *) ifconf.ifc_req + ifconf.ifc_len)
3614 struct ifreq *ifq = ifreq;
3615 #ifdef HAVE_STRUCT_IFREQ_IFR_ADDR_SA_LEN
3616 #define SIZEOF_IFREQ(sif) \
3617 ((sif)->ifr_addr.sa_len < sizeof (struct sockaddr) \
3618 ? sizeof (*(sif)) : sizeof ((sif)->ifr_name) + (sif)->ifr_addr.sa_len)
3620 int len = SIZEOF_IFREQ (ifq);
3621 #else
3622 int len = sizeof (*ifreq);
3623 #endif
3624 char namebuf[sizeof (ifq->ifr_name) + 1];
3625 i += len;
3626 ifreq = (struct ifreq *) ((char *) ifreq + len);
3628 if (ifq->ifr_addr.sa_family != AF_INET)
3629 continue;
3631 memcpy (namebuf, ifq->ifr_name, sizeof (ifq->ifr_name));
3632 namebuf[sizeof (ifq->ifr_name)] = 0;
3633 res = Fcons (Fcons (build_string (namebuf),
3634 conv_sockaddr_to_lisp (&ifq->ifr_addr,
3635 sizeof (struct sockaddr))),
3636 res);
3639 xfree (buf);
3640 return res;
3642 #endif /* SIOCGIFCONF */
3644 #if defined (SIOCGIFADDR) || defined (SIOCGIFHWADDR) || defined (SIOCGIFFLAGS)
3646 struct ifflag_def {
3647 int flag_bit;
3648 const char *flag_sym;
3651 static const struct ifflag_def ifflag_table[] = {
3652 #ifdef IFF_UP
3653 { IFF_UP, "up" },
3654 #endif
3655 #ifdef IFF_BROADCAST
3656 { IFF_BROADCAST, "broadcast" },
3657 #endif
3658 #ifdef IFF_DEBUG
3659 { IFF_DEBUG, "debug" },
3660 #endif
3661 #ifdef IFF_LOOPBACK
3662 { IFF_LOOPBACK, "loopback" },
3663 #endif
3664 #ifdef IFF_POINTOPOINT
3665 { IFF_POINTOPOINT, "pointopoint" },
3666 #endif
3667 #ifdef IFF_RUNNING
3668 { IFF_RUNNING, "running" },
3669 #endif
3670 #ifdef IFF_NOARP
3671 { IFF_NOARP, "noarp" },
3672 #endif
3673 #ifdef IFF_PROMISC
3674 { IFF_PROMISC, "promisc" },
3675 #endif
3676 #ifdef IFF_NOTRAILERS
3677 #ifdef NS_IMPL_COCOA
3678 /* Really means smart, notrailers is obsolete */
3679 { IFF_NOTRAILERS, "smart" },
3680 #else
3681 { IFF_NOTRAILERS, "notrailers" },
3682 #endif
3683 #endif
3684 #ifdef IFF_ALLMULTI
3685 { IFF_ALLMULTI, "allmulti" },
3686 #endif
3687 #ifdef IFF_MASTER
3688 { IFF_MASTER, "master" },
3689 #endif
3690 #ifdef IFF_SLAVE
3691 { IFF_SLAVE, "slave" },
3692 #endif
3693 #ifdef IFF_MULTICAST
3694 { IFF_MULTICAST, "multicast" },
3695 #endif
3696 #ifdef IFF_PORTSEL
3697 { IFF_PORTSEL, "portsel" },
3698 #endif
3699 #ifdef IFF_AUTOMEDIA
3700 { IFF_AUTOMEDIA, "automedia" },
3701 #endif
3702 #ifdef IFF_DYNAMIC
3703 { IFF_DYNAMIC, "dynamic" },
3704 #endif
3705 #ifdef IFF_OACTIVE
3706 { IFF_OACTIVE, "oactive" }, /* OpenBSD: transmission in progress */
3707 #endif
3708 #ifdef IFF_SIMPLEX
3709 { IFF_SIMPLEX, "simplex" }, /* OpenBSD: can't hear own transmissions */
3710 #endif
3711 #ifdef IFF_LINK0
3712 { IFF_LINK0, "link0" }, /* OpenBSD: per link layer defined bit */
3713 #endif
3714 #ifdef IFF_LINK1
3715 { IFF_LINK1, "link1" }, /* OpenBSD: per link layer defined bit */
3716 #endif
3717 #ifdef IFF_LINK2
3718 { IFF_LINK2, "link2" }, /* OpenBSD: per link layer defined bit */
3719 #endif
3720 { 0, 0 }
3723 DEFUN ("network-interface-info", Fnetwork_interface_info, Snetwork_interface_info, 1, 1, 0,
3724 doc: /* Return information about network interface named IFNAME.
3725 The return value is a list (ADDR BCAST NETMASK HWADDR FLAGS),
3726 where ADDR is the layer 3 address, BCAST is the layer 3 broadcast address,
3727 NETMASK is the layer 3 network mask, HWADDR is the layer 2 address, and
3728 FLAGS is the current flags of the interface. */)
3729 (Lisp_Object ifname)
3731 struct ifreq rq;
3732 Lisp_Object res = Qnil;
3733 Lisp_Object elt;
3734 int s;
3735 int any = 0;
3736 #if (! (defined SIOCGIFHWADDR && defined HAVE_STRUCT_IFREQ_IFR_HWADDR) \
3737 && defined HAVE_GETIFADDRS && defined LLADDR)
3738 struct ifaddrs *ifap;
3739 #endif
3741 CHECK_STRING (ifname);
3743 memset (rq.ifr_name, 0, sizeof rq.ifr_name);
3744 strncpy (rq.ifr_name, SSDATA (ifname), sizeof (rq.ifr_name));
3746 s = socket (AF_INET, SOCK_STREAM, 0);
3747 if (s < 0)
3748 return Qnil;
3750 elt = Qnil;
3751 #if defined (SIOCGIFFLAGS) && defined (HAVE_STRUCT_IFREQ_IFR_FLAGS)
3752 if (ioctl (s, SIOCGIFFLAGS, &rq) == 0)
3754 int flags = rq.ifr_flags;
3755 const struct ifflag_def *fp;
3756 int fnum;
3758 /* If flags is smaller than int (i.e. short) it may have the high bit set
3759 due to IFF_MULTICAST. In that case, sign extending it into
3760 an int is wrong. */
3761 if (flags < 0 && sizeof (rq.ifr_flags) < sizeof (flags))
3762 flags = (unsigned short) rq.ifr_flags;
3764 any = 1;
3765 for (fp = ifflag_table; flags != 0 && fp->flag_sym; fp++)
3767 if (flags & fp->flag_bit)
3769 elt = Fcons (intern (fp->flag_sym), elt);
3770 flags -= fp->flag_bit;
3773 for (fnum = 0; flags && fnum < 32; flags >>= 1, fnum++)
3775 if (flags & 1)
3777 elt = Fcons (make_number (fnum), elt);
3781 #endif
3782 res = Fcons (elt, res);
3784 elt = Qnil;
3785 #if defined (SIOCGIFHWADDR) && defined (HAVE_STRUCT_IFREQ_IFR_HWADDR)
3786 if (ioctl (s, SIOCGIFHWADDR, &rq) == 0)
3788 Lisp_Object hwaddr = Fmake_vector (make_number (6), Qnil);
3789 register struct Lisp_Vector *p = XVECTOR (hwaddr);
3790 int n;
3792 any = 1;
3793 for (n = 0; n < 6; n++)
3794 p->contents[n] = make_number (((unsigned char *)&rq.ifr_hwaddr.sa_data[0])[n]);
3795 elt = Fcons (make_number (rq.ifr_hwaddr.sa_family), hwaddr);
3797 #elif defined (HAVE_GETIFADDRS) && defined (LLADDR)
3798 if (getifaddrs (&ifap) != -1)
3800 Lisp_Object hwaddr = Fmake_vector (make_number (6), Qnil);
3801 register struct Lisp_Vector *p = XVECTOR (hwaddr);
3802 struct ifaddrs *it;
3804 for (it = ifap; it != NULL; it = it->ifa_next)
3806 struct sockaddr_dl *sdl = (struct sockaddr_dl*) it->ifa_addr;
3807 unsigned char linkaddr[6];
3808 int n;
3810 if (it->ifa_addr->sa_family != AF_LINK
3811 || strcmp (it->ifa_name, SSDATA (ifname)) != 0
3812 || sdl->sdl_alen != 6)
3813 continue;
3815 memcpy (linkaddr, LLADDR (sdl), sdl->sdl_alen);
3816 for (n = 0; n < 6; n++)
3817 p->contents[n] = make_number (linkaddr[n]);
3819 elt = Fcons (make_number (it->ifa_addr->sa_family), hwaddr);
3820 break;
3823 #ifdef HAVE_FREEIFADDRS
3824 freeifaddrs (ifap);
3825 #endif
3827 #endif /* HAVE_GETIFADDRS && LLADDR */
3829 res = Fcons (elt, res);
3831 elt = Qnil;
3832 #if defined (SIOCGIFNETMASK) && (defined (HAVE_STRUCT_IFREQ_IFR_NETMASK) || defined (HAVE_STRUCT_IFREQ_IFR_ADDR))
3833 if (ioctl (s, SIOCGIFNETMASK, &rq) == 0)
3835 any = 1;
3836 #ifdef HAVE_STRUCT_IFREQ_IFR_NETMASK
3837 elt = conv_sockaddr_to_lisp (&rq.ifr_netmask, sizeof (rq.ifr_netmask));
3838 #else
3839 elt = conv_sockaddr_to_lisp (&rq.ifr_addr, sizeof (rq.ifr_addr));
3840 #endif
3842 #endif
3843 res = Fcons (elt, res);
3845 elt = Qnil;
3846 #if defined (SIOCGIFBRDADDR) && defined (HAVE_STRUCT_IFREQ_IFR_BROADADDR)
3847 if (ioctl (s, SIOCGIFBRDADDR, &rq) == 0)
3849 any = 1;
3850 elt = conv_sockaddr_to_lisp (&rq.ifr_broadaddr, sizeof (rq.ifr_broadaddr));
3852 #endif
3853 res = Fcons (elt, res);
3855 elt = Qnil;
3856 #if defined (SIOCGIFADDR) && defined (HAVE_STRUCT_IFREQ_IFR_ADDR)
3857 if (ioctl (s, SIOCGIFADDR, &rq) == 0)
3859 any = 1;
3860 elt = conv_sockaddr_to_lisp (&rq.ifr_addr, sizeof (rq.ifr_addr));
3862 #endif
3863 res = Fcons (elt, res);
3865 close (s);
3867 return any ? res : Qnil;
3869 #endif
3870 #endif /* defined (HAVE_NET_IF_H) */
3872 /* Turn off input and output for process PROC. */
3874 static void
3875 deactivate_process (Lisp_Object proc)
3877 register int inchannel, outchannel;
3878 register struct Lisp_Process *p = XPROCESS (proc);
3880 #ifdef HAVE_GNUTLS
3881 /* Delete GnuTLS structures in PROC, if any. */
3882 emacs_gnutls_deinit (proc);
3883 #endif /* HAVE_GNUTLS */
3885 inchannel = p->infd;
3886 outchannel = p->outfd;
3888 #ifdef ADAPTIVE_READ_BUFFERING
3889 if (p->read_output_delay > 0)
3891 if (--process_output_delay_count < 0)
3892 process_output_delay_count = 0;
3893 p->read_output_delay = 0;
3894 p->read_output_skip = 0;
3896 #endif
3898 if (inchannel >= 0)
3900 /* Beware SIGCHLD hereabouts. */
3901 flush_pending_output (inchannel);
3902 emacs_close (inchannel);
3903 if (outchannel >= 0 && outchannel != inchannel)
3904 emacs_close (outchannel);
3906 p->infd = -1;
3907 p->outfd = -1;
3908 #ifdef DATAGRAM_SOCKETS
3909 if (DATAGRAM_CHAN_P (inchannel))
3911 xfree (datagram_address[inchannel].sa);
3912 datagram_address[inchannel].sa = 0;
3913 datagram_address[inchannel].len = 0;
3915 #endif
3916 chan_process[inchannel] = Qnil;
3917 FD_CLR (inchannel, &input_wait_mask);
3918 FD_CLR (inchannel, &non_keyboard_wait_mask);
3919 #ifdef NON_BLOCKING_CONNECT
3920 if (FD_ISSET (inchannel, &connect_wait_mask))
3922 FD_CLR (inchannel, &connect_wait_mask);
3923 FD_CLR (inchannel, &write_mask);
3924 if (--num_pending_connects < 0)
3925 abort ();
3927 #endif
3928 if (inchannel == max_process_desc)
3930 int i;
3931 /* We just closed the highest-numbered process input descriptor,
3932 so recompute the highest-numbered one now. */
3933 max_process_desc = 0;
3934 for (i = 0; i < MAXDESC; i++)
3935 if (!NILP (chan_process[i]))
3936 max_process_desc = i;
3942 DEFUN ("accept-process-output", Faccept_process_output, Saccept_process_output,
3943 0, 4, 0,
3944 doc: /* Allow any pending output from subprocesses to be read by Emacs.
3945 It is read into the process' buffers or given to their filter functions.
3946 Non-nil arg PROCESS means do not return until some output has been received
3947 from PROCESS.
3949 Non-nil second arg SECONDS and third arg MILLISEC are number of seconds
3950 and milliseconds to wait; return after that much time whether or not
3951 there is any subprocess output. If SECONDS is a floating point number,
3952 it specifies a fractional number of seconds to wait.
3953 The MILLISEC argument is obsolete and should be avoided.
3955 If optional fourth arg JUST-THIS-ONE is non-nil, only accept output
3956 from PROCESS, suspending reading output from other processes.
3957 If JUST-THIS-ONE is an integer, don't run any timers either.
3958 Return non-nil if we received any output before the timeout expired. */)
3959 (register Lisp_Object process, Lisp_Object seconds, Lisp_Object millisec, Lisp_Object just_this_one)
3961 intmax_t secs;
3962 int nsecs;
3964 if (! NILP (process))
3965 CHECK_PROCESS (process);
3966 else
3967 just_this_one = Qnil;
3969 if (!NILP (millisec))
3970 { /* Obsolete calling convention using integers rather than floats. */
3971 CHECK_NUMBER (millisec);
3972 if (NILP (seconds))
3973 seconds = make_float (XINT (millisec) / 1000.0);
3974 else
3976 CHECK_NUMBER (seconds);
3977 seconds = make_float (XINT (millisec) / 1000.0 + XINT (seconds));
3981 secs = 0;
3982 nsecs = -1;
3984 if (!NILP (seconds))
3986 if (INTEGERP (seconds))
3988 if (0 < XINT (seconds))
3990 secs = XINT (seconds);
3991 nsecs = 0;
3994 else if (FLOATP (seconds))
3996 if (0 < XFLOAT_DATA (seconds))
3998 EMACS_TIME t = EMACS_TIME_FROM_DOUBLE (XFLOAT_DATA (seconds));
3999 secs = min (EMACS_SECS (t), INTMAX_MAX);
4000 nsecs = EMACS_NSECS (t);
4003 else
4004 wrong_type_argument (Qnumberp, seconds);
4006 else if (! NILP (process))
4007 nsecs = 0;
4009 return
4010 (wait_reading_process_output (secs, nsecs, 0, 0,
4011 Qnil,
4012 !NILP (process) ? XPROCESS (process) : NULL,
4013 NILP (just_this_one) ? 0 :
4014 !INTEGERP (just_this_one) ? 1 : -1)
4015 ? Qt : Qnil);
4018 /* Accept a connection for server process SERVER on CHANNEL. */
4020 static int connect_counter = 0;
4022 static void
4023 server_accept_connection (Lisp_Object server, int channel)
4025 Lisp_Object proc, caller, name, buffer;
4026 Lisp_Object contact, host, service;
4027 struct Lisp_Process *ps= XPROCESS (server);
4028 struct Lisp_Process *p;
4029 int s;
4030 union u_sockaddr {
4031 struct sockaddr sa;
4032 struct sockaddr_in in;
4033 #ifdef AF_INET6
4034 struct sockaddr_in6 in6;
4035 #endif
4036 #ifdef HAVE_LOCAL_SOCKETS
4037 struct sockaddr_un un;
4038 #endif
4039 } saddr;
4040 socklen_t len = sizeof saddr;
4042 s = accept (channel, &saddr.sa, &len);
4044 if (s < 0)
4046 int code = errno;
4048 if (code == EAGAIN)
4049 return;
4050 #ifdef EWOULDBLOCK
4051 if (code == EWOULDBLOCK)
4052 return;
4053 #endif
4055 if (!NILP (ps->log))
4056 call3 (ps->log, server, Qnil,
4057 concat3 (build_string ("accept failed with code"),
4058 Fnumber_to_string (make_number (code)),
4059 build_string ("\n")));
4060 return;
4063 connect_counter++;
4065 /* Setup a new process to handle the connection. */
4067 /* Generate a unique identification of the caller, and build contact
4068 information for this process. */
4069 host = Qt;
4070 service = Qnil;
4071 switch (saddr.sa.sa_family)
4073 case AF_INET:
4075 Lisp_Object args[5];
4076 unsigned char *ip = (unsigned char *)&saddr.in.sin_addr.s_addr;
4077 args[0] = build_string ("%d.%d.%d.%d");
4078 args[1] = make_number (*ip++);
4079 args[2] = make_number (*ip++);
4080 args[3] = make_number (*ip++);
4081 args[4] = make_number (*ip++);
4082 host = Fformat (5, args);
4083 service = make_number (ntohs (saddr.in.sin_port));
4085 args[0] = build_string (" <%s:%d>");
4086 args[1] = host;
4087 args[2] = service;
4088 caller = Fformat (3, args);
4090 break;
4092 #ifdef AF_INET6
4093 case AF_INET6:
4095 Lisp_Object args[9];
4096 uint16_t *ip6 = (uint16_t *)&saddr.in6.sin6_addr;
4097 int i;
4098 args[0] = build_string ("%x:%x:%x:%x:%x:%x:%x:%x");
4099 for (i = 0; i < 8; i++)
4100 args[i+1] = make_number (ntohs (ip6[i]));
4101 host = Fformat (9, args);
4102 service = make_number (ntohs (saddr.in.sin_port));
4104 args[0] = build_string (" <[%s]:%d>");
4105 args[1] = host;
4106 args[2] = service;
4107 caller = Fformat (3, args);
4109 break;
4110 #endif
4112 #ifdef HAVE_LOCAL_SOCKETS
4113 case AF_LOCAL:
4114 #endif
4115 default:
4116 caller = Fnumber_to_string (make_number (connect_counter));
4117 caller = concat3 (build_string (" <"), caller, build_string (">"));
4118 break;
4121 /* Create a new buffer name for this process if it doesn't have a
4122 filter. The new buffer name is based on the buffer name or
4123 process name of the server process concatenated with the caller
4124 identification. */
4126 if (!NILP (ps->filter) && !EQ (ps->filter, Qt))
4127 buffer = Qnil;
4128 else
4130 buffer = ps->buffer;
4131 if (!NILP (buffer))
4132 buffer = Fbuffer_name (buffer);
4133 else
4134 buffer = ps->name;
4135 if (!NILP (buffer))
4137 buffer = concat2 (buffer, caller);
4138 buffer = Fget_buffer_create (buffer);
4142 /* Generate a unique name for the new server process. Combine the
4143 server process name with the caller identification. */
4145 name = concat2 (ps->name, caller);
4146 proc = make_process (name);
4148 chan_process[s] = proc;
4150 #ifdef O_NONBLOCK
4151 fcntl (s, F_SETFL, O_NONBLOCK);
4152 #else
4153 #ifdef O_NDELAY
4154 fcntl (s, F_SETFL, O_NDELAY);
4155 #endif
4156 #endif
4158 p = XPROCESS (proc);
4160 /* Build new contact information for this setup. */
4161 contact = Fcopy_sequence (ps->childp);
4162 contact = Fplist_put (contact, QCserver, Qnil);
4163 contact = Fplist_put (contact, QChost, host);
4164 if (!NILP (service))
4165 contact = Fplist_put (contact, QCservice, service);
4166 contact = Fplist_put (contact, QCremote,
4167 conv_sockaddr_to_lisp (&saddr.sa, len));
4168 #ifdef HAVE_GETSOCKNAME
4169 len = sizeof saddr;
4170 if (getsockname (s, &saddr.sa, &len) == 0)
4171 contact = Fplist_put (contact, QClocal,
4172 conv_sockaddr_to_lisp (&saddr.sa, len));
4173 #endif
4175 p->childp = contact;
4176 p->plist = Fcopy_sequence (ps->plist);
4177 p->type = Qnetwork;
4179 p->buffer = buffer;
4180 p->sentinel = ps->sentinel;
4181 p->filter = ps->filter;
4182 p->command = Qnil;
4183 p->pid = 0;
4184 p->infd = s;
4185 p->outfd = s;
4186 p->status = Qrun;
4188 /* Client processes for accepted connections are not stopped initially. */
4189 if (!EQ (p->filter, Qt))
4191 FD_SET (s, &input_wait_mask);
4192 FD_SET (s, &non_keyboard_wait_mask);
4195 if (s > max_process_desc)
4196 max_process_desc = s;
4198 /* Setup coding system for new process based on server process.
4199 This seems to be the proper thing to do, as the coding system
4200 of the new process should reflect the settings at the time the
4201 server socket was opened; not the current settings. */
4203 p->decode_coding_system = ps->decode_coding_system;
4204 p->encode_coding_system = ps->encode_coding_system;
4205 setup_process_coding_systems (proc);
4207 p->decoding_buf = empty_unibyte_string;
4208 p->decoding_carryover = 0;
4209 p->encoding_buf = empty_unibyte_string;
4211 p->inherit_coding_system_flag
4212 = (NILP (buffer) ? 0 : ps->inherit_coding_system_flag);
4214 if (!NILP (ps->log))
4215 call3 (ps->log, server, proc,
4216 concat3 (build_string ("accept from "),
4217 (STRINGP (host) ? host : build_string ("-")),
4218 build_string ("\n")));
4220 if (!NILP (p->sentinel))
4221 exec_sentinel (proc,
4222 concat3 (build_string ("open from "),
4223 (STRINGP (host) ? host : build_string ("-")),
4224 build_string ("\n")));
4227 /* This variable is different from waiting_for_input in keyboard.c.
4228 It is used to communicate to a lisp process-filter/sentinel (via the
4229 function Fwaiting_for_user_input_p below) whether Emacs was waiting
4230 for user-input when that process-filter was called.
4231 waiting_for_input cannot be used as that is by definition 0 when
4232 lisp code is being evalled.
4233 This is also used in record_asynch_buffer_change.
4234 For that purpose, this must be 0
4235 when not inside wait_reading_process_output. */
4236 static int waiting_for_user_input_p;
4238 static Lisp_Object
4239 wait_reading_process_output_unwind (Lisp_Object data)
4241 waiting_for_user_input_p = XINT (data);
4242 return Qnil;
4245 /* This is here so breakpoints can be put on it. */
4246 static void
4247 wait_reading_process_output_1 (void)
4251 /* Read and dispose of subprocess output while waiting for timeout to
4252 elapse and/or keyboard input to be available.
4254 TIME_LIMIT is:
4255 timeout in seconds
4256 If negative, gobble data immediately available but don't wait for any.
4258 NSECS is:
4259 an additional duration to wait, measured in nanoseconds
4260 If TIME_LIMIT is zero, then:
4261 If NSECS == 0, there is no limit.
4262 If NSECS > 0, the timeout consists of NSEC only.
4263 If NSECS < 0, gobble data immediately, as if TIME_LIMIT were negative.
4265 READ_KBD is a lisp value:
4266 0 to ignore keyboard input, or
4267 1 to return when input is available, or
4268 -1 meaning caller will actually read the input, so don't throw to
4269 the quit handler, or
4271 DO_DISPLAY != 0 means redisplay should be done to show subprocess
4272 output that arrives.
4274 If WAIT_FOR_CELL is a cons cell, wait until its car is non-nil
4275 (and gobble terminal input into the buffer if any arrives).
4277 If WAIT_PROC is specified, wait until something arrives from that
4278 process. The return value is true if we read some input from
4279 that process.
4281 If JUST_WAIT_PROC is non-nil, handle only output from WAIT_PROC
4282 (suspending output from other processes). A negative value
4283 means don't run any timers either.
4285 If WAIT_PROC is specified, then the function returns true if we
4286 received input from that process before the timeout elapsed.
4287 Otherwise, return true if we received input from any process. */
4290 wait_reading_process_output (intmax_t time_limit, int nsecs, int read_kbd,
4291 int do_display,
4292 Lisp_Object wait_for_cell,
4293 struct Lisp_Process *wait_proc, int just_wait_proc)
4295 register int channel, nfds;
4296 SELECT_TYPE Available;
4297 SELECT_TYPE Writeok;
4298 int check_write;
4299 int check_delay, no_avail;
4300 int xerrno;
4301 Lisp_Object proc;
4302 EMACS_TIME timeout, end_time;
4303 int wait_channel = -1;
4304 int got_some_input = 0;
4305 ptrdiff_t count = SPECPDL_INDEX ();
4307 FD_ZERO (&Available);
4308 FD_ZERO (&Writeok);
4310 if (time_limit == 0 && nsecs == 0 && wait_proc && !NILP (Vinhibit_quit)
4311 && !(CONSP (wait_proc->status) && EQ (XCAR (wait_proc->status), Qexit)))
4312 message ("Blocking call to accept-process-output with quit inhibited!!");
4314 /* If wait_proc is a process to watch, set wait_channel accordingly. */
4315 if (wait_proc != NULL)
4316 wait_channel = wait_proc->infd;
4318 record_unwind_protect (wait_reading_process_output_unwind,
4319 make_number (waiting_for_user_input_p));
4320 waiting_for_user_input_p = read_kbd;
4322 if (time_limit < 0)
4324 time_limit = 0;
4325 nsecs = -1;
4327 else if (TYPE_MAXIMUM (time_t) < time_limit)
4328 time_limit = TYPE_MAXIMUM (time_t);
4330 /* Since we may need to wait several times,
4331 compute the absolute time to return at. */
4332 if (time_limit || nsecs) /* FIXME neither should be negative, no? */
4334 EMACS_GET_TIME (end_time);
4335 EMACS_SET_SECS_NSECS (timeout, time_limit, nsecs);
4336 EMACS_ADD_TIME (end_time, end_time, timeout);
4339 while (1)
4341 int timeout_reduced_for_timers = 0;
4343 /* If calling from keyboard input, do not quit
4344 since we want to return C-g as an input character.
4345 Otherwise, do pending quit if requested. */
4346 if (read_kbd >= 0)
4347 QUIT;
4348 #ifdef SYNC_INPUT
4349 else
4350 process_pending_signals ();
4351 #endif
4353 /* Exit now if the cell we're waiting for became non-nil. */
4354 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
4355 break;
4357 /* Compute time from now till when time limit is up */
4358 /* Exit if already run out */
4359 if (nsecs < 0)
4361 /* -1 specified for timeout means
4362 gobble output available now
4363 but don't wait at all. */
4365 EMACS_SET_SECS_USECS (timeout, 0, 0);
4367 else if (time_limit || nsecs)
4369 EMACS_GET_TIME (timeout);
4370 if (EMACS_TIME_LE (end_time, timeout))
4371 break;
4372 EMACS_SUB_TIME (timeout, end_time, timeout);
4374 else
4376 EMACS_SET_SECS_USECS (timeout, 100000, 0);
4379 /* Normally we run timers here.
4380 But not if wait_for_cell; in those cases,
4381 the wait is supposed to be short,
4382 and those callers cannot handle running arbitrary Lisp code here. */
4383 if (NILP (wait_for_cell)
4384 && just_wait_proc >= 0)
4386 EMACS_TIME timer_delay;
4390 int old_timers_run = timers_run;
4391 struct buffer *old_buffer = current_buffer;
4392 Lisp_Object old_window = selected_window;
4394 timer_delay = timer_check ();
4396 /* If a timer has run, this might have changed buffers
4397 an alike. Make read_key_sequence aware of that. */
4398 if (timers_run != old_timers_run
4399 && (old_buffer != current_buffer
4400 || !EQ (old_window, selected_window))
4401 && waiting_for_user_input_p == -1)
4402 record_asynch_buffer_change ();
4404 if (timers_run != old_timers_run && do_display)
4405 /* We must retry, since a timer may have requeued itself
4406 and that could alter the time_delay. */
4407 redisplay_preserve_echo_area (9);
4408 else
4409 break;
4411 while (!detect_input_pending ());
4413 /* If there is unread keyboard input, also return. */
4414 if (read_kbd != 0
4415 && requeued_events_pending_p ())
4416 break;
4418 /* If time_limit is negative, we are not going to wait at all. */
4419 if (0 <= nsecs)
4421 if (EMACS_TIME_VALID_P (timer_delay))
4423 if (EMACS_TIME_LT (timer_delay, timeout))
4425 timeout = timer_delay;
4426 timeout_reduced_for_timers = 1;
4429 else
4431 /* This is so a breakpoint can be put here. */
4432 wait_reading_process_output_1 ();
4437 /* Cause C-g and alarm signals to take immediate action,
4438 and cause input available signals to zero out timeout.
4440 It is important that we do this before checking for process
4441 activity. If we get a SIGCHLD after the explicit checks for
4442 process activity, timeout is the only way we will know. */
4443 if (read_kbd < 0)
4444 set_waiting_for_input (&timeout);
4446 /* If status of something has changed, and no input is
4447 available, notify the user of the change right away. After
4448 this explicit check, we'll let the SIGCHLD handler zap
4449 timeout to get our attention. */
4450 if (update_tick != process_tick)
4452 SELECT_TYPE Atemp;
4453 SELECT_TYPE Ctemp;
4455 if (kbd_on_hold_p ())
4456 FD_ZERO (&Atemp);
4457 else
4458 Atemp = input_wait_mask;
4459 Ctemp = write_mask;
4461 EMACS_SET_SECS_USECS (timeout, 0, 0);
4462 if ((pselect (max (max_process_desc, max_input_desc) + 1,
4463 &Atemp,
4464 #ifdef NON_BLOCKING_CONNECT
4465 (num_pending_connects > 0 ? &Ctemp : NULL),
4466 #else
4467 NULL,
4468 #endif
4469 NULL, &timeout, NULL)
4470 <= 0))
4472 /* It's okay for us to do this and then continue with
4473 the loop, since timeout has already been zeroed out. */
4474 clear_waiting_for_input ();
4475 status_notify (NULL);
4476 if (do_display) redisplay_preserve_echo_area (13);
4480 /* Don't wait for output from a non-running process. Just
4481 read whatever data has already been received. */
4482 if (wait_proc && wait_proc->raw_status_new)
4483 update_status (wait_proc);
4484 if (wait_proc
4485 && ! EQ (wait_proc->status, Qrun)
4486 && ! EQ (wait_proc->status, Qconnect))
4488 int nread, total_nread = 0;
4490 clear_waiting_for_input ();
4491 XSETPROCESS (proc, wait_proc);
4493 /* Read data from the process, until we exhaust it. */
4494 while (wait_proc->infd >= 0)
4496 nread = read_process_output (proc, wait_proc->infd);
4498 if (nread == 0)
4499 break;
4501 if (0 < nread)
4503 total_nread += nread;
4504 got_some_input = 1;
4506 #ifdef EIO
4507 else if (nread == -1 && EIO == errno)
4508 break;
4509 #endif
4510 #ifdef EAGAIN
4511 else if (nread == -1 && EAGAIN == errno)
4512 break;
4513 #endif
4514 #ifdef EWOULDBLOCK
4515 else if (nread == -1 && EWOULDBLOCK == errno)
4516 break;
4517 #endif
4519 if (total_nread > 0 && do_display)
4520 redisplay_preserve_echo_area (10);
4522 break;
4525 /* Wait till there is something to do */
4527 if (wait_proc && just_wait_proc)
4529 if (wait_proc->infd < 0) /* Terminated */
4530 break;
4531 FD_SET (wait_proc->infd, &Available);
4532 check_delay = 0;
4533 check_write = 0;
4535 else if (!NILP (wait_for_cell))
4537 Available = non_process_wait_mask;
4538 check_delay = 0;
4539 check_write = 0;
4541 else
4543 if (! read_kbd)
4544 Available = non_keyboard_wait_mask;
4545 else
4546 Available = input_wait_mask;
4547 Writeok = write_mask;
4548 #ifdef SELECT_CANT_DO_WRITE_MASK
4549 check_write = 0;
4550 #else
4551 check_write = 1;
4552 #endif
4553 check_delay = wait_channel >= 0 ? 0 : process_output_delay_count;
4556 /* If frame size has changed or the window is newly mapped,
4557 redisplay now, before we start to wait. There is a race
4558 condition here; if a SIGIO arrives between now and the select
4559 and indicates that a frame is trashed, the select may block
4560 displaying a trashed screen. */
4561 if (frame_garbaged && do_display)
4563 clear_waiting_for_input ();
4564 redisplay_preserve_echo_area (11);
4565 if (read_kbd < 0)
4566 set_waiting_for_input (&timeout);
4569 /* Skip the `select' call if input is available and we're
4570 waiting for keyboard input or a cell change (which can be
4571 triggered by processing X events). In the latter case, set
4572 nfds to 1 to avoid breaking the loop. */
4573 no_avail = 0;
4574 if ((read_kbd || !NILP (wait_for_cell))
4575 && detect_input_pending ())
4577 nfds = read_kbd ? 0 : 1;
4578 no_avail = 1;
4581 if (!no_avail)
4584 #ifdef ADAPTIVE_READ_BUFFERING
4585 /* Set the timeout for adaptive read buffering if any
4586 process has non-zero read_output_skip and non-zero
4587 read_output_delay, and we are not reading output for a
4588 specific wait_channel. It is not executed if
4589 Vprocess_adaptive_read_buffering is nil. */
4590 if (process_output_skip && check_delay > 0)
4592 int nsecs = EMACS_NSECS (timeout);
4593 if (EMACS_SECS (timeout) > 0 || nsecs > READ_OUTPUT_DELAY_MAX)
4594 nsecs = READ_OUTPUT_DELAY_MAX;
4595 for (channel = 0; check_delay > 0 && channel <= max_process_desc; channel++)
4597 proc = chan_process[channel];
4598 if (NILP (proc))
4599 continue;
4600 /* Find minimum non-zero read_output_delay among the
4601 processes with non-zero read_output_skip. */
4602 if (XPROCESS (proc)->read_output_delay > 0)
4604 check_delay--;
4605 if (!XPROCESS (proc)->read_output_skip)
4606 continue;
4607 FD_CLR (channel, &Available);
4608 XPROCESS (proc)->read_output_skip = 0;
4609 if (XPROCESS (proc)->read_output_delay < nsecs)
4610 nsecs = XPROCESS (proc)->read_output_delay;
4613 EMACS_SET_SECS_NSECS (timeout, 0, nsecs);
4614 process_output_skip = 0;
4616 #endif
4617 #if defined (USE_GTK) || defined (HAVE_GCONF) || defined (HAVE_GSETTINGS)
4618 nfds = xg_select
4619 #elif defined (HAVE_NS)
4620 nfds = ns_select
4621 #else
4622 nfds = pselect
4623 #endif
4624 (max (max_process_desc, max_input_desc) + 1,
4625 &Available,
4626 (check_write ? &Writeok : (SELECT_TYPE *)0),
4627 NULL, &timeout, NULL);
4629 #ifdef HAVE_GNUTLS
4630 /* GnuTLS buffers data internally. In lowat mode it leaves
4631 some data in the TCP buffers so that select works, but
4632 with custom pull/push functions we need to check if some
4633 data is available in the buffers manually. */
4634 if (nfds == 0)
4636 if (! wait_proc)
4638 /* We're not waiting on a specific process, so loop
4639 through all the channels and check for data.
4640 This is a workaround needed for some versions of
4641 the gnutls library -- 2.12.14 has been confirmed
4642 to need it. See
4643 http://comments.gmane.org/gmane.emacs.devel/145074 */
4644 for (channel = 0; channel < MAXDESC; ++channel)
4645 if (! NILP (chan_process[channel]))
4647 struct Lisp_Process *p =
4648 XPROCESS (chan_process[channel]);
4649 if (p && p->gnutls_p && p->infd
4650 && ((emacs_gnutls_record_check_pending
4651 (p->gnutls_state))
4652 > 0))
4654 nfds++;
4655 FD_SET (p->infd, &Available);
4659 else
4661 /* Check this specific channel. */
4662 if (wait_proc->gnutls_p /* Check for valid process. */
4663 /* Do we have pending data? */
4664 && ((emacs_gnutls_record_check_pending
4665 (wait_proc->gnutls_state))
4666 > 0))
4668 nfds = 1;
4669 /* Set to Available. */
4670 FD_SET (wait_proc->infd, &Available);
4674 #endif
4677 xerrno = errno;
4679 /* Make C-g and alarm signals set flags again */
4680 clear_waiting_for_input ();
4682 /* If we woke up due to SIGWINCH, actually change size now. */
4683 do_pending_window_change (0);
4685 if ((time_limit || nsecs) && nfds == 0 && ! timeout_reduced_for_timers)
4686 /* We wanted the full specified time, so return now. */
4687 break;
4688 if (nfds < 0)
4690 if (xerrno == EINTR)
4691 no_avail = 1;
4692 else if (xerrno == EBADF)
4694 #ifdef AIX
4695 /* AIX doesn't handle PTY closure the same way BSD does. On AIX,
4696 the child's closure of the pts gives the parent a SIGHUP, and
4697 the ptc file descriptor is automatically closed,
4698 yielding EBADF here or at select() call above.
4699 So, SIGHUP is ignored (see def of PTY_TTY_NAME_SPRINTF
4700 in m/ibmrt-aix.h), and here we just ignore the select error.
4701 Cleanup occurs c/o status_notify after SIGCLD. */
4702 no_avail = 1; /* Cannot depend on values returned */
4703 #else
4704 abort ();
4705 #endif
4707 else
4708 error ("select error: %s", emacs_strerror (xerrno));
4711 if (no_avail)
4713 FD_ZERO (&Available);
4714 check_write = 0;
4717 #if 0 /* When polling is used, interrupt_input is 0,
4718 so get_input_pending should read the input.
4719 So this should not be needed. */
4720 /* If we are using polling for input,
4721 and we see input available, make it get read now.
4722 Otherwise it might not actually get read for a second.
4723 And on hpux, since we turn off polling in wait_reading_process_output,
4724 it might never get read at all if we don't spend much time
4725 outside of wait_reading_process_output. */
4726 if (read_kbd && interrupt_input
4727 && keyboard_bit_set (&Available)
4728 && input_polling_used ())
4729 kill (getpid (), SIGALRM);
4730 #endif
4732 /* Check for keyboard input */
4733 /* If there is any, return immediately
4734 to give it higher priority than subprocesses */
4736 if (read_kbd != 0)
4738 int old_timers_run = timers_run;
4739 struct buffer *old_buffer = current_buffer;
4740 Lisp_Object old_window = selected_window;
4741 int leave = 0;
4743 if (detect_input_pending_run_timers (do_display))
4745 swallow_events (do_display);
4746 if (detect_input_pending_run_timers (do_display))
4747 leave = 1;
4750 /* If a timer has run, this might have changed buffers
4751 an alike. Make read_key_sequence aware of that. */
4752 if (timers_run != old_timers_run
4753 && waiting_for_user_input_p == -1
4754 && (old_buffer != current_buffer
4755 || !EQ (old_window, selected_window)))
4756 record_asynch_buffer_change ();
4758 if (leave)
4759 break;
4762 /* If there is unread keyboard input, also return. */
4763 if (read_kbd != 0
4764 && requeued_events_pending_p ())
4765 break;
4767 /* If we are not checking for keyboard input now,
4768 do process events (but don't run any timers).
4769 This is so that X events will be processed.
4770 Otherwise they may have to wait until polling takes place.
4771 That would causes delays in pasting selections, for example.
4773 (We used to do this only if wait_for_cell.) */
4774 if (read_kbd == 0 && detect_input_pending ())
4776 swallow_events (do_display);
4777 #if 0 /* Exiting when read_kbd doesn't request that seems wrong, though. */
4778 if (detect_input_pending ())
4779 break;
4780 #endif
4783 /* Exit now if the cell we're waiting for became non-nil. */
4784 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
4785 break;
4787 #ifdef SIGIO
4788 /* If we think we have keyboard input waiting, but didn't get SIGIO,
4789 go read it. This can happen with X on BSD after logging out.
4790 In that case, there really is no input and no SIGIO,
4791 but select says there is input. */
4793 if (read_kbd && interrupt_input
4794 && keyboard_bit_set (&Available) && ! noninteractive)
4795 kill (getpid (), SIGIO);
4796 #endif
4798 if (! wait_proc)
4799 got_some_input |= nfds > 0;
4801 /* If checking input just got us a size-change event from X,
4802 obey it now if we should. */
4803 if (read_kbd || ! NILP (wait_for_cell))
4804 do_pending_window_change (0);
4806 /* Check for data from a process. */
4807 if (no_avail || nfds == 0)
4808 continue;
4810 for (channel = 0; channel <= max_input_desc; ++channel)
4812 struct fd_callback_data *d = &fd_callback_info[channel];
4813 if (FD_ISSET (channel, &Available)
4814 && d->func != 0
4815 && (d->condition & FOR_READ) != 0)
4816 d->func (channel, d->data, 1);
4817 if (FD_ISSET (channel, &write_mask)
4818 && d->func != 0
4819 && (d->condition & FOR_WRITE) != 0)
4820 d->func (channel, d->data, 0);
4823 for (channel = 0; channel <= max_process_desc; channel++)
4825 if (FD_ISSET (channel, &Available)
4826 && FD_ISSET (channel, &non_keyboard_wait_mask)
4827 && !FD_ISSET (channel, &non_process_wait_mask))
4829 int nread;
4831 /* If waiting for this channel, arrange to return as
4832 soon as no more input to be processed. No more
4833 waiting. */
4834 if (wait_channel == channel)
4836 wait_channel = -1;
4837 nsecs = -1;
4838 got_some_input = 1;
4840 proc = chan_process[channel];
4841 if (NILP (proc))
4842 continue;
4844 /* If this is a server stream socket, accept connection. */
4845 if (EQ (XPROCESS (proc)->status, Qlisten))
4847 server_accept_connection (proc, channel);
4848 continue;
4851 /* Read data from the process, starting with our
4852 buffered-ahead character if we have one. */
4854 nread = read_process_output (proc, channel);
4855 if (nread > 0)
4857 /* Since read_process_output can run a filter,
4858 which can call accept-process-output,
4859 don't try to read from any other processes
4860 before doing the select again. */
4861 FD_ZERO (&Available);
4863 if (do_display)
4864 redisplay_preserve_echo_area (12);
4866 #ifdef EWOULDBLOCK
4867 else if (nread == -1 && errno == EWOULDBLOCK)
4869 #endif
4870 /* ISC 4.1 defines both EWOULDBLOCK and O_NONBLOCK,
4871 and Emacs uses O_NONBLOCK, so what we get is EAGAIN. */
4872 #ifdef O_NONBLOCK
4873 else if (nread == -1 && errno == EAGAIN)
4875 #else
4876 #ifdef O_NDELAY
4877 else if (nread == -1 && errno == EAGAIN)
4879 /* Note that we cannot distinguish between no input
4880 available now and a closed pipe.
4881 With luck, a closed pipe will be accompanied by
4882 subprocess termination and SIGCHLD. */
4883 else if (nread == 0 && !NETCONN_P (proc) && !SERIALCONN_P (proc))
4885 #endif /* O_NDELAY */
4886 #endif /* O_NONBLOCK */
4887 #ifdef HAVE_PTYS
4888 /* On some OSs with ptys, when the process on one end of
4889 a pty exits, the other end gets an error reading with
4890 errno = EIO instead of getting an EOF (0 bytes read).
4891 Therefore, if we get an error reading and errno =
4892 EIO, just continue, because the child process has
4893 exited and should clean itself up soon (e.g. when we
4894 get a SIGCHLD).
4896 However, it has been known to happen that the SIGCHLD
4897 got lost. So raise the signal again just in case.
4898 It can't hurt. */
4899 else if (nread == -1 && errno == EIO)
4901 struct Lisp_Process *p = XPROCESS (proc);
4903 /* Clear the descriptor now, so we only raise the
4904 signal once. */
4905 FD_CLR (channel, &input_wait_mask);
4906 FD_CLR (channel, &non_keyboard_wait_mask);
4908 if (p->pid == -2)
4910 /* If the EIO occurs on a pty, sigchld_handler's
4911 wait3() will not find the process object to
4912 delete. Do it here. */
4913 p->tick = ++process_tick;
4914 p->status = Qfailed;
4916 else
4917 kill (getpid (), SIGCHLD);
4919 #endif /* HAVE_PTYS */
4920 /* If we can detect process termination, don't consider the
4921 process gone just because its pipe is closed. */
4922 #ifdef SIGCHLD
4923 else if (nread == 0 && !NETCONN_P (proc) && !SERIALCONN_P (proc))
4925 #endif
4926 else
4928 /* Preserve status of processes already terminated. */
4929 XPROCESS (proc)->tick = ++process_tick;
4930 deactivate_process (proc);
4931 if (XPROCESS (proc)->raw_status_new)
4932 update_status (XPROCESS (proc));
4933 if (EQ (XPROCESS (proc)->status, Qrun))
4934 XPROCESS (proc)->status
4935 = Fcons (Qexit, Fcons (make_number (256), Qnil));
4938 #ifdef NON_BLOCKING_CONNECT
4939 if (FD_ISSET (channel, &Writeok)
4940 && FD_ISSET (channel, &connect_wait_mask))
4942 struct Lisp_Process *p;
4944 FD_CLR (channel, &connect_wait_mask);
4945 FD_CLR (channel, &write_mask);
4946 if (--num_pending_connects < 0)
4947 abort ();
4949 proc = chan_process[channel];
4950 if (NILP (proc))
4951 continue;
4953 p = XPROCESS (proc);
4955 #ifdef GNU_LINUX
4956 /* getsockopt(,,SO_ERROR,,) is said to hang on some systems.
4957 So only use it on systems where it is known to work. */
4959 socklen_t xlen = sizeof (xerrno);
4960 if (getsockopt (channel, SOL_SOCKET, SO_ERROR, &xerrno, &xlen))
4961 xerrno = errno;
4963 #else
4965 struct sockaddr pname;
4966 int pnamelen = sizeof (pname);
4968 /* If connection failed, getpeername will fail. */
4969 xerrno = 0;
4970 if (getpeername (channel, &pname, &pnamelen) < 0)
4972 /* Obtain connect failure code through error slippage. */
4973 char dummy;
4974 xerrno = errno;
4975 if (errno == ENOTCONN && read (channel, &dummy, 1) < 0)
4976 xerrno = errno;
4979 #endif
4980 if (xerrno)
4982 p->tick = ++process_tick;
4983 p->status = Fcons (Qfailed, Fcons (make_number (xerrno), Qnil));
4984 deactivate_process (proc);
4986 else
4988 p->status = Qrun;
4989 /* Execute the sentinel here. If we had relied on
4990 status_notify to do it later, it will read input
4991 from the process before calling the sentinel. */
4992 exec_sentinel (proc, build_string ("open\n"));
4993 if (!EQ (p->filter, Qt) && !EQ (p->command, Qt))
4995 FD_SET (p->infd, &input_wait_mask);
4996 FD_SET (p->infd, &non_keyboard_wait_mask);
5000 #endif /* NON_BLOCKING_CONNECT */
5001 } /* end for each file descriptor */
5002 } /* end while exit conditions not met */
5004 unbind_to (count, Qnil);
5006 /* If calling from keyboard input, do not quit
5007 since we want to return C-g as an input character.
5008 Otherwise, do pending quit if requested. */
5009 if (read_kbd >= 0)
5011 /* Prevent input_pending from remaining set if we quit. */
5012 clear_input_pending ();
5013 QUIT;
5016 return got_some_input;
5019 /* Given a list (FUNCTION ARGS...), apply FUNCTION to the ARGS. */
5021 static Lisp_Object
5022 read_process_output_call (Lisp_Object fun_and_args)
5024 return apply1 (XCAR (fun_and_args), XCDR (fun_and_args));
5027 static Lisp_Object
5028 read_process_output_error_handler (Lisp_Object error_val)
5030 cmd_error_internal (error_val, "error in process filter: ");
5031 Vinhibit_quit = Qt;
5032 update_echo_area ();
5033 Fsleep_for (make_number (2), Qnil);
5034 return Qt;
5037 /* Read pending output from the process channel,
5038 starting with our buffered-ahead character if we have one.
5039 Yield number of decoded characters read.
5041 This function reads at most 4096 characters.
5042 If you want to read all available subprocess output,
5043 you must call it repeatedly until it returns zero.
5045 The characters read are decoded according to PROC's coding-system
5046 for decoding. */
5048 static int
5049 read_process_output (Lisp_Object proc, register int channel)
5051 register ssize_t nbytes;
5052 char *chars;
5053 register Lisp_Object outstream;
5054 register struct Lisp_Process *p = XPROCESS (proc);
5055 register ptrdiff_t opoint;
5056 struct coding_system *coding = proc_decode_coding_system[channel];
5057 int carryover = p->decoding_carryover;
5058 int readmax = 4096;
5059 ptrdiff_t count = SPECPDL_INDEX ();
5060 Lisp_Object odeactivate;
5062 chars = (char *) alloca (carryover + readmax);
5063 if (carryover)
5064 /* See the comment above. */
5065 memcpy (chars, SDATA (p->decoding_buf), carryover);
5067 #ifdef DATAGRAM_SOCKETS
5068 /* We have a working select, so proc_buffered_char is always -1. */
5069 if (DATAGRAM_CHAN_P (channel))
5071 socklen_t len = datagram_address[channel].len;
5072 nbytes = recvfrom (channel, chars + carryover, readmax,
5073 0, datagram_address[channel].sa, &len);
5075 else
5076 #endif
5078 int buffered = 0 <= proc_buffered_char[channel];
5079 if (buffered)
5081 chars[carryover] = proc_buffered_char[channel];
5082 proc_buffered_char[channel] = -1;
5084 #ifdef HAVE_GNUTLS
5085 if (p->gnutls_p)
5086 nbytes = emacs_gnutls_read (p, chars + carryover + buffered,
5087 readmax - buffered);
5088 else
5089 #endif
5090 nbytes = emacs_read (channel, chars + carryover + buffered,
5091 readmax - buffered);
5092 #ifdef ADAPTIVE_READ_BUFFERING
5093 if (nbytes > 0 && p->adaptive_read_buffering)
5095 int delay = p->read_output_delay;
5096 if (nbytes < 256)
5098 if (delay < READ_OUTPUT_DELAY_MAX_MAX)
5100 if (delay == 0)
5101 process_output_delay_count++;
5102 delay += READ_OUTPUT_DELAY_INCREMENT * 2;
5105 else if (delay > 0 && nbytes == readmax - buffered)
5107 delay -= READ_OUTPUT_DELAY_INCREMENT;
5108 if (delay == 0)
5109 process_output_delay_count--;
5111 p->read_output_delay = delay;
5112 if (delay)
5114 p->read_output_skip = 1;
5115 process_output_skip = 1;
5118 #endif
5119 nbytes += buffered;
5120 nbytes += buffered && nbytes <= 0;
5123 p->decoding_carryover = 0;
5125 /* At this point, NBYTES holds number of bytes just received
5126 (including the one in proc_buffered_char[channel]). */
5127 if (nbytes <= 0)
5129 if (nbytes < 0 || coding->mode & CODING_MODE_LAST_BLOCK)
5130 return nbytes;
5131 coding->mode |= CODING_MODE_LAST_BLOCK;
5134 /* Now set NBYTES how many bytes we must decode. */
5135 nbytes += carryover;
5137 odeactivate = Vdeactivate_mark;
5138 /* There's no good reason to let process filters change the current
5139 buffer, and many callers of accept-process-output, sit-for, and
5140 friends don't expect current-buffer to be changed from under them. */
5141 record_unwind_protect (set_buffer_if_live, Fcurrent_buffer ());
5143 /* Read and dispose of the process output. */
5144 outstream = p->filter;
5145 if (!NILP (outstream))
5147 Lisp_Object text;
5148 int outer_running_asynch_code = running_asynch_code;
5149 int waiting = waiting_for_user_input_p;
5151 /* No need to gcpro these, because all we do with them later
5152 is test them for EQness, and none of them should be a string. */
5153 #if 0
5154 Lisp_Object obuffer, okeymap;
5155 XSETBUFFER (obuffer, current_buffer);
5156 okeymap = BVAR (current_buffer, keymap);
5157 #endif
5159 /* We inhibit quit here instead of just catching it so that
5160 hitting ^G when a filter happens to be running won't screw
5161 it up. */
5162 specbind (Qinhibit_quit, Qt);
5163 specbind (Qlast_nonmenu_event, Qt);
5165 /* In case we get recursively called,
5166 and we already saved the match data nonrecursively,
5167 save the same match data in safely recursive fashion. */
5168 if (outer_running_asynch_code)
5170 Lisp_Object tem;
5171 /* Don't clobber the CURRENT match data, either! */
5172 tem = Fmatch_data (Qnil, Qnil, Qnil);
5173 restore_search_regs ();
5174 record_unwind_save_match_data ();
5175 Fset_match_data (tem, Qt);
5178 /* For speed, if a search happens within this code,
5179 save the match data in a special nonrecursive fashion. */
5180 running_asynch_code = 1;
5182 decode_coding_c_string (coding, (unsigned char *) chars, nbytes, Qt);
5183 text = coding->dst_object;
5184 Vlast_coding_system_used = CODING_ID_NAME (coding->id);
5185 /* A new coding system might be found. */
5186 if (!EQ (p->decode_coding_system, Vlast_coding_system_used))
5188 p->decode_coding_system = Vlast_coding_system_used;
5190 /* Don't call setup_coding_system for
5191 proc_decode_coding_system[channel] here. It is done in
5192 detect_coding called via decode_coding above. */
5194 /* If a coding system for encoding is not yet decided, we set
5195 it as the same as coding-system for decoding.
5197 But, before doing that we must check if
5198 proc_encode_coding_system[p->outfd] surely points to a
5199 valid memory because p->outfd will be changed once EOF is
5200 sent to the process. */
5201 if (NILP (p->encode_coding_system)
5202 && proc_encode_coding_system[p->outfd])
5204 p->encode_coding_system
5205 = coding_inherit_eol_type (Vlast_coding_system_used, Qnil);
5206 setup_coding_system (p->encode_coding_system,
5207 proc_encode_coding_system[p->outfd]);
5211 if (coding->carryover_bytes > 0)
5213 if (SCHARS (p->decoding_buf) < coding->carryover_bytes)
5214 p->decoding_buf = make_uninit_string (coding->carryover_bytes);
5215 memcpy (SDATA (p->decoding_buf), coding->carryover,
5216 coding->carryover_bytes);
5217 p->decoding_carryover = coding->carryover_bytes;
5219 if (SBYTES (text) > 0)
5220 /* FIXME: It's wrong to wrap or not based on debug-on-error, and
5221 sometimes it's simply wrong to wrap (e.g. when called from
5222 accept-process-output). */
5223 internal_condition_case_1 (read_process_output_call,
5224 Fcons (outstream,
5225 Fcons (proc, Fcons (text, Qnil))),
5226 !NILP (Vdebug_on_error) ? Qnil : Qerror,
5227 read_process_output_error_handler);
5229 /* If we saved the match data nonrecursively, restore it now. */
5230 restore_search_regs ();
5231 running_asynch_code = outer_running_asynch_code;
5233 /* Restore waiting_for_user_input_p as it was
5234 when we were called, in case the filter clobbered it. */
5235 waiting_for_user_input_p = waiting;
5237 #if 0 /* Call record_asynch_buffer_change unconditionally,
5238 because we might have changed minor modes or other things
5239 that affect key bindings. */
5240 if (! EQ (Fcurrent_buffer (), obuffer)
5241 || ! EQ (current_buffer->keymap, okeymap))
5242 #endif
5243 /* But do it only if the caller is actually going to read events.
5244 Otherwise there's no need to make him wake up, and it could
5245 cause trouble (for example it would make sit_for return). */
5246 if (waiting_for_user_input_p == -1)
5247 record_asynch_buffer_change ();
5250 /* If no filter, write into buffer if it isn't dead. */
5251 else if (!NILP (p->buffer) && !NILP (BVAR (XBUFFER (p->buffer), name)))
5253 Lisp_Object old_read_only;
5254 ptrdiff_t old_begv, old_zv;
5255 ptrdiff_t old_begv_byte, old_zv_byte;
5256 ptrdiff_t before, before_byte;
5257 ptrdiff_t opoint_byte;
5258 Lisp_Object text;
5259 struct buffer *b;
5261 Fset_buffer (p->buffer);
5262 opoint = PT;
5263 opoint_byte = PT_BYTE;
5264 old_read_only = BVAR (current_buffer, read_only);
5265 old_begv = BEGV;
5266 old_zv = ZV;
5267 old_begv_byte = BEGV_BYTE;
5268 old_zv_byte = ZV_BYTE;
5270 BVAR (current_buffer, read_only) = Qnil;
5272 /* Insert new output into buffer
5273 at the current end-of-output marker,
5274 thus preserving logical ordering of input and output. */
5275 if (XMARKER (p->mark)->buffer)
5276 SET_PT_BOTH (clip_to_bounds (BEGV, marker_position (p->mark), ZV),
5277 clip_to_bounds (BEGV_BYTE, marker_byte_position (p->mark),
5278 ZV_BYTE));
5279 else
5280 SET_PT_BOTH (ZV, ZV_BYTE);
5281 before = PT;
5282 before_byte = PT_BYTE;
5284 /* If the output marker is outside of the visible region, save
5285 the restriction and widen. */
5286 if (! (BEGV <= PT && PT <= ZV))
5287 Fwiden ();
5289 decode_coding_c_string (coding, (unsigned char *) chars, nbytes, Qt);
5290 text = coding->dst_object;
5291 Vlast_coding_system_used = CODING_ID_NAME (coding->id);
5292 /* A new coding system might be found. See the comment in the
5293 similar code in the previous `if' block. */
5294 if (!EQ (p->decode_coding_system, Vlast_coding_system_used))
5296 p->decode_coding_system = Vlast_coding_system_used;
5297 if (NILP (p->encode_coding_system)
5298 && proc_encode_coding_system[p->outfd])
5300 p->encode_coding_system
5301 = coding_inherit_eol_type (Vlast_coding_system_used, Qnil);
5302 setup_coding_system (p->encode_coding_system,
5303 proc_encode_coding_system[p->outfd]);
5306 if (coding->carryover_bytes > 0)
5308 if (SCHARS (p->decoding_buf) < coding->carryover_bytes)
5309 p->decoding_buf = make_uninit_string (coding->carryover_bytes);
5310 memcpy (SDATA (p->decoding_buf), coding->carryover,
5311 coding->carryover_bytes);
5312 p->decoding_carryover = coding->carryover_bytes;
5314 /* Adjust the multibyteness of TEXT to that of the buffer. */
5315 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
5316 != ! STRING_MULTIBYTE (text))
5317 text = (STRING_MULTIBYTE (text)
5318 ? Fstring_as_unibyte (text)
5319 : Fstring_to_multibyte (text));
5320 /* Insert before markers in case we are inserting where
5321 the buffer's mark is, and the user's next command is Meta-y. */
5322 insert_from_string_before_markers (text, 0, 0,
5323 SCHARS (text), SBYTES (text), 0);
5325 /* Make sure the process marker's position is valid when the
5326 process buffer is changed in the signal_after_change above.
5327 W3 is known to do that. */
5328 if (BUFFERP (p->buffer)
5329 && (b = XBUFFER (p->buffer), b != current_buffer))
5330 set_marker_both (p->mark, p->buffer, BUF_PT (b), BUF_PT_BYTE (b));
5331 else
5332 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
5334 update_mode_lines++;
5336 /* Make sure opoint and the old restrictions
5337 float ahead of any new text just as point would. */
5338 if (opoint >= before)
5340 opoint += PT - before;
5341 opoint_byte += PT_BYTE - before_byte;
5343 if (old_begv > before)
5345 old_begv += PT - before;
5346 old_begv_byte += PT_BYTE - before_byte;
5348 if (old_zv >= before)
5350 old_zv += PT - before;
5351 old_zv_byte += PT_BYTE - before_byte;
5354 /* If the restriction isn't what it should be, set it. */
5355 if (old_begv != BEGV || old_zv != ZV)
5356 Fnarrow_to_region (make_number (old_begv), make_number (old_zv));
5359 BVAR (current_buffer, read_only) = old_read_only;
5360 SET_PT_BOTH (opoint, opoint_byte);
5362 /* Handling the process output should not deactivate the mark. */
5363 Vdeactivate_mark = odeactivate;
5365 unbind_to (count, Qnil);
5366 return nbytes;
5369 /* Sending data to subprocess */
5371 static jmp_buf send_process_frame;
5372 static Lisp_Object process_sent_to;
5374 #ifndef FORWARD_SIGNAL_TO_MAIN_THREAD
5375 static void send_process_trap (int) NO_RETURN;
5376 #endif
5378 static void
5379 send_process_trap (int ignore)
5381 SIGNAL_THREAD_CHECK (SIGPIPE);
5382 sigunblock (sigmask (SIGPIPE));
5383 longjmp (send_process_frame, 1);
5386 /* In send_process, when a write fails temporarily,
5387 wait_reading_process_output is called. It may execute user code,
5388 e.g. timers, that attempts to write new data to the same process.
5389 We must ensure that data is sent in the right order, and not
5390 interspersed half-completed with other writes (Bug#10815). This is
5391 handled by the write_queue element of struct process. It is a list
5392 with each entry having the form
5394 (string . (offset . length))
5396 where STRING is a lisp string, OFFSET is the offset into the
5397 string's byte sequence from which we should begin to send, and
5398 LENGTH is the number of bytes left to send. */
5400 /* Create a new entry in write_queue.
5401 INPUT_OBJ should be a buffer, string Qt, or Qnil.
5402 BUF is a pointer to the string sequence of the input_obj or a C
5403 string in case of Qt or Qnil. */
5405 static void
5406 write_queue_push (struct Lisp_Process *p, Lisp_Object input_obj,
5407 const char *buf, ptrdiff_t len, int front)
5409 ptrdiff_t offset;
5410 Lisp_Object entry, obj;
5412 if (STRINGP (input_obj))
5414 offset = buf - SSDATA (input_obj);
5415 obj = input_obj;
5417 else
5419 offset = 0;
5420 obj = make_unibyte_string (buf, len);
5423 entry = Fcons (obj, Fcons (make_number (offset), make_number (len)));
5425 if (front)
5426 p->write_queue = Fcons (entry, p->write_queue);
5427 else
5428 p->write_queue = nconc2 (p->write_queue, Fcons (entry, Qnil));
5431 /* Remove the first element in the write_queue of process P, put its
5432 contents in OBJ, BUF and LEN, and return non-zero. If the
5433 write_queue is empty, return zero. */
5435 static int
5436 write_queue_pop (struct Lisp_Process *p, Lisp_Object *obj,
5437 const char **buf, ptrdiff_t *len)
5439 Lisp_Object entry, offset_length;
5440 ptrdiff_t offset;
5442 if (NILP (p->write_queue))
5443 return 0;
5445 entry = XCAR (p->write_queue);
5446 p->write_queue = XCDR (p->write_queue);
5448 *obj = XCAR (entry);
5449 offset_length = XCDR (entry);
5451 *len = XINT (XCDR (offset_length));
5452 offset = XINT (XCAR (offset_length));
5453 *buf = SSDATA (*obj) + offset;
5455 return 1;
5458 /* Send some data to process PROC.
5459 BUF is the beginning of the data; LEN is the number of characters.
5460 OBJECT is the Lisp object that the data comes from. If OBJECT is
5461 nil or t, it means that the data comes from C string.
5463 If OBJECT is not nil, the data is encoded by PROC's coding-system
5464 for encoding before it is sent.
5466 This function can evaluate Lisp code and can garbage collect. */
5468 static void
5469 send_process (volatile Lisp_Object proc, const char *volatile buf,
5470 volatile ptrdiff_t len, volatile Lisp_Object object)
5472 /* Use volatile to protect variables from being clobbered by longjmp. */
5473 struct Lisp_Process *p = XPROCESS (proc);
5474 ssize_t rv;
5475 struct coding_system *coding;
5476 void (*volatile old_sigpipe) (int);
5478 if (p->raw_status_new)
5479 update_status (p);
5480 if (! EQ (p->status, Qrun))
5481 error ("Process %s not running", SDATA (p->name));
5482 if (p->outfd < 0)
5483 error ("Output file descriptor of %s is closed", SDATA (p->name));
5485 coding = proc_encode_coding_system[p->outfd];
5486 Vlast_coding_system_used = CODING_ID_NAME (coding->id);
5488 if ((STRINGP (object) && STRING_MULTIBYTE (object))
5489 || (BUFFERP (object)
5490 && !NILP (BVAR (XBUFFER (object), enable_multibyte_characters)))
5491 || EQ (object, Qt))
5493 p->encode_coding_system
5494 = complement_process_encoding_system (p->encode_coding_system);
5495 if (!EQ (Vlast_coding_system_used, p->encode_coding_system))
5497 /* The coding system for encoding was changed to raw-text
5498 because we sent a unibyte text previously. Now we are
5499 sending a multibyte text, thus we must encode it by the
5500 original coding system specified for the current process.
5502 Another reason we come here is that the coding system
5503 was just complemented and a new one was returned by
5504 complement_process_encoding_system. */
5505 setup_coding_system (p->encode_coding_system, coding);
5506 Vlast_coding_system_used = p->encode_coding_system;
5508 coding->src_multibyte = 1;
5510 else
5512 coding->src_multibyte = 0;
5513 /* For sending a unibyte text, character code conversion should
5514 not take place but EOL conversion should. So, setup raw-text
5515 or one of the subsidiary if we have not yet done it. */
5516 if (CODING_REQUIRE_ENCODING (coding))
5518 if (CODING_REQUIRE_FLUSHING (coding))
5520 /* But, before changing the coding, we must flush out data. */
5521 coding->mode |= CODING_MODE_LAST_BLOCK;
5522 send_process (proc, "", 0, Qt);
5523 coding->mode &= CODING_MODE_LAST_BLOCK;
5525 setup_coding_system (raw_text_coding_system
5526 (Vlast_coding_system_used),
5527 coding);
5528 coding->src_multibyte = 0;
5531 coding->dst_multibyte = 0;
5533 if (CODING_REQUIRE_ENCODING (coding))
5535 coding->dst_object = Qt;
5536 if (BUFFERP (object))
5538 ptrdiff_t from_byte, from, to;
5539 ptrdiff_t save_pt, save_pt_byte;
5540 struct buffer *cur = current_buffer;
5542 set_buffer_internal (XBUFFER (object));
5543 save_pt = PT, save_pt_byte = PT_BYTE;
5545 from_byte = PTR_BYTE_POS ((unsigned char *) buf);
5546 from = BYTE_TO_CHAR (from_byte);
5547 to = BYTE_TO_CHAR (from_byte + len);
5548 TEMP_SET_PT_BOTH (from, from_byte);
5549 encode_coding_object (coding, object, from, from_byte,
5550 to, from_byte + len, Qt);
5551 TEMP_SET_PT_BOTH (save_pt, save_pt_byte);
5552 set_buffer_internal (cur);
5554 else if (STRINGP (object))
5556 encode_coding_object (coding, object, 0, 0, SCHARS (object),
5557 SBYTES (object), Qt);
5559 else
5561 coding->dst_object = make_unibyte_string (buf, len);
5562 coding->produced = len;
5565 len = coding->produced;
5566 object = coding->dst_object;
5567 buf = SSDATA (object);
5570 if (pty_max_bytes == 0)
5572 #if defined (HAVE_FPATHCONF) && defined (_PC_MAX_CANON)
5573 pty_max_bytes = fpathconf (p->outfd, _PC_MAX_CANON);
5574 if (pty_max_bytes < 0)
5575 pty_max_bytes = 250;
5576 #else
5577 pty_max_bytes = 250;
5578 #endif
5579 /* Deduct one, to leave space for the eof. */
5580 pty_max_bytes--;
5583 /* 2000-09-21: Emacs 20.7, sparc-sun-solaris-2.6, GCC 2.95.2,
5584 CFLAGS="-g -O": The value of the parameter `proc' is clobbered
5585 when returning with longjmp despite being declared volatile. */
5586 if (!setjmp (send_process_frame))
5588 p = XPROCESS (proc); /* Repair any setjmp clobbering. */
5589 process_sent_to = proc;
5591 /* If there is already data in the write_queue, put the new data
5592 in the back of queue. Otherwise, ignore it. */
5593 if (!NILP (p->write_queue))
5594 write_queue_push (p, object, buf, len, 0);
5596 do /* while !NILP (p->write_queue) */
5598 ptrdiff_t cur_len = -1;
5599 const char *cur_buf;
5600 Lisp_Object cur_object;
5602 /* If write_queue is empty, ignore it. */
5603 if (!write_queue_pop (p, &cur_object, &cur_buf, &cur_len))
5605 cur_len = len;
5606 cur_buf = buf;
5607 cur_object = object;
5610 while (cur_len > 0)
5612 /* Send this batch, using one or more write calls. */
5613 ptrdiff_t written = 0;
5614 int outfd = p->outfd;
5615 old_sigpipe = (void (*) (int)) signal (SIGPIPE, send_process_trap);
5616 #ifdef DATAGRAM_SOCKETS
5617 if (DATAGRAM_CHAN_P (outfd))
5619 rv = sendto (outfd, cur_buf, cur_len,
5620 0, datagram_address[outfd].sa,
5621 datagram_address[outfd].len);
5622 if (0 <= rv)
5623 written = rv;
5624 else if (errno == EMSGSIZE)
5626 signal (SIGPIPE, old_sigpipe);
5627 report_file_error ("sending datagram",
5628 Fcons (proc, Qnil));
5631 else
5632 #endif
5634 #ifdef HAVE_GNUTLS
5635 if (p->gnutls_p)
5636 written = emacs_gnutls_write (p, cur_buf, cur_len);
5637 else
5638 #endif
5639 written = emacs_write (outfd, cur_buf, cur_len);
5640 rv = (written ? 0 : -1);
5641 #ifdef ADAPTIVE_READ_BUFFERING
5642 if (p->read_output_delay > 0
5643 && p->adaptive_read_buffering == 1)
5645 p->read_output_delay = 0;
5646 process_output_delay_count--;
5647 p->read_output_skip = 0;
5649 #endif
5651 signal (SIGPIPE, old_sigpipe);
5653 if (rv < 0)
5655 if (0
5656 #ifdef EWOULDBLOCK
5657 || errno == EWOULDBLOCK
5658 #endif
5659 #ifdef EAGAIN
5660 || errno == EAGAIN
5661 #endif
5663 /* Buffer is full. Wait, accepting input;
5664 that may allow the program
5665 to finish doing output and read more. */
5667 #ifdef BROKEN_PTY_READ_AFTER_EAGAIN
5668 /* A gross hack to work around a bug in FreeBSD.
5669 In the following sequence, read(2) returns
5670 bogus data:
5672 write(2) 1022 bytes
5673 write(2) 954 bytes, get EAGAIN
5674 read(2) 1024 bytes in process_read_output
5675 read(2) 11 bytes in process_read_output
5677 That is, read(2) returns more bytes than have
5678 ever been written successfully. The 1033 bytes
5679 read are the 1022 bytes written successfully
5680 after processing (for example with CRs added if
5681 the terminal is set up that way which it is
5682 here). The same bytes will be seen again in a
5683 later read(2), without the CRs. */
5685 if (errno == EAGAIN)
5687 int flags = FWRITE;
5688 ioctl (p->outfd, TIOCFLUSH, &flags);
5690 #endif /* BROKEN_PTY_READ_AFTER_EAGAIN */
5692 /* Put what we should have written in wait_queue. */
5693 write_queue_push (p, cur_object, cur_buf, cur_len, 1);
5694 wait_reading_process_output (0, 20 * 1000 * 1000,
5695 0, 0, Qnil, NULL, 0);
5696 /* Reread queue, to see what is left. */
5697 break;
5699 else
5700 /* This is a real error. */
5701 report_file_error ("writing to process", Fcons (proc, Qnil));
5703 cur_buf += written;
5704 cur_len -= written;
5707 while (!NILP (p->write_queue));
5709 else
5711 signal (SIGPIPE, old_sigpipe);
5712 proc = process_sent_to;
5713 p = XPROCESS (proc);
5714 p->raw_status_new = 0;
5715 p->status = Fcons (Qexit, Fcons (make_number (256), Qnil));
5716 p->tick = ++process_tick;
5717 deactivate_process (proc);
5718 error ("SIGPIPE raised on process %s; closed it", SDATA (p->name));
5722 DEFUN ("process-send-region", Fprocess_send_region, Sprocess_send_region,
5723 3, 3, 0,
5724 doc: /* Send current contents of region as input to PROCESS.
5725 PROCESS may be a process, a buffer, the name of a process or buffer, or
5726 nil, indicating the current buffer's process.
5727 Called from program, takes three arguments, PROCESS, START and END.
5728 If the region is more than 500 characters long,
5729 it is sent in several bunches. This may happen even for shorter regions.
5730 Output from processes can arrive in between bunches. */)
5731 (Lisp_Object process, Lisp_Object start, Lisp_Object end)
5733 Lisp_Object proc;
5734 ptrdiff_t start1, end1;
5736 proc = get_process (process);
5737 validate_region (&start, &end);
5739 if (XINT (start) < GPT && XINT (end) > GPT)
5740 move_gap (XINT (start));
5742 start1 = CHAR_TO_BYTE (XINT (start));
5743 end1 = CHAR_TO_BYTE (XINT (end));
5744 send_process (proc, (char *) BYTE_POS_ADDR (start1), end1 - start1,
5745 Fcurrent_buffer ());
5747 return Qnil;
5750 DEFUN ("process-send-string", Fprocess_send_string, Sprocess_send_string,
5751 2, 2, 0,
5752 doc: /* Send PROCESS the contents of STRING as input.
5753 PROCESS may be a process, a buffer, the name of a process or buffer, or
5754 nil, indicating the current buffer's process.
5755 If STRING is more than 500 characters long,
5756 it is sent in several bunches. This may happen even for shorter strings.
5757 Output from processes can arrive in between bunches. */)
5758 (Lisp_Object process, Lisp_Object string)
5760 Lisp_Object proc;
5761 CHECK_STRING (string);
5762 proc = get_process (process);
5763 send_process (proc, SSDATA (string),
5764 SBYTES (string), string);
5765 return Qnil;
5768 /* Return the foreground process group for the tty/pty that
5769 the process P uses. */
5770 static pid_t
5771 emacs_get_tty_pgrp (struct Lisp_Process *p)
5773 pid_t gid = -1;
5775 #ifdef TIOCGPGRP
5776 if (ioctl (p->infd, TIOCGPGRP, &gid) == -1 && ! NILP (p->tty_name))
5778 int fd;
5779 /* Some OS:es (Solaris 8/9) does not allow TIOCGPGRP from the
5780 master side. Try the slave side. */
5781 fd = emacs_open (SSDATA (p->tty_name), O_RDONLY, 0);
5783 if (fd != -1)
5785 ioctl (fd, TIOCGPGRP, &gid);
5786 emacs_close (fd);
5789 #endif /* defined (TIOCGPGRP ) */
5791 return gid;
5794 DEFUN ("process-running-child-p", Fprocess_running_child_p,
5795 Sprocess_running_child_p, 0, 1, 0,
5796 doc: /* Return t if PROCESS has given the terminal to a child.
5797 If the operating system does not make it possible to find out,
5798 return t unconditionally. */)
5799 (Lisp_Object process)
5801 /* Initialize in case ioctl doesn't exist or gives an error,
5802 in a way that will cause returning t. */
5803 pid_t gid;
5804 Lisp_Object proc;
5805 struct Lisp_Process *p;
5807 proc = get_process (process);
5808 p = XPROCESS (proc);
5810 if (!EQ (p->type, Qreal))
5811 error ("Process %s is not a subprocess",
5812 SDATA (p->name));
5813 if (p->infd < 0)
5814 error ("Process %s is not active",
5815 SDATA (p->name));
5817 gid = emacs_get_tty_pgrp (p);
5819 if (gid == p->pid)
5820 return Qnil;
5821 return Qt;
5824 /* send a signal number SIGNO to PROCESS.
5825 If CURRENT_GROUP is t, that means send to the process group
5826 that currently owns the terminal being used to communicate with PROCESS.
5827 This is used for various commands in shell mode.
5828 If CURRENT_GROUP is lambda, that means send to the process group
5829 that currently owns the terminal, but only if it is NOT the shell itself.
5831 If NOMSG is zero, insert signal-announcements into process's buffers
5832 right away.
5834 If we can, we try to signal PROCESS by sending control characters
5835 down the pty. This allows us to signal inferiors who have changed
5836 their uid, for which killpg would return an EPERM error. */
5838 static void
5839 process_send_signal (Lisp_Object process, int signo, Lisp_Object current_group,
5840 int nomsg)
5842 Lisp_Object proc;
5843 register struct Lisp_Process *p;
5844 pid_t gid;
5845 int no_pgrp = 0;
5847 proc = get_process (process);
5848 p = XPROCESS (proc);
5850 if (!EQ (p->type, Qreal))
5851 error ("Process %s is not a subprocess",
5852 SDATA (p->name));
5853 if (p->infd < 0)
5854 error ("Process %s is not active",
5855 SDATA (p->name));
5857 if (!p->pty_flag)
5858 current_group = Qnil;
5860 /* If we are using pgrps, get a pgrp number and make it negative. */
5861 if (NILP (current_group))
5862 /* Send the signal to the shell's process group. */
5863 gid = p->pid;
5864 else
5866 #ifdef SIGNALS_VIA_CHARACTERS
5867 /* If possible, send signals to the entire pgrp
5868 by sending an input character to it. */
5870 struct termios t;
5871 cc_t *sig_char = NULL;
5873 tcgetattr (p->infd, &t);
5875 switch (signo)
5877 case SIGINT:
5878 sig_char = &t.c_cc[VINTR];
5879 break;
5881 case SIGQUIT:
5882 sig_char = &t.c_cc[VQUIT];
5883 break;
5885 case SIGTSTP:
5886 #if defined (VSWTCH) && !defined (PREFER_VSUSP)
5887 sig_char = &t.c_cc[VSWTCH];
5888 #else
5889 sig_char = &t.c_cc[VSUSP];
5890 #endif
5891 break;
5894 if (sig_char && *sig_char != CDISABLE)
5896 send_process (proc, (char *) sig_char, 1, Qnil);
5897 return;
5899 /* If we can't send the signal with a character,
5900 fall through and send it another way. */
5902 /* The code above may fall through if it can't
5903 handle the signal. */
5904 #endif /* defined (SIGNALS_VIA_CHARACTERS) */
5906 #ifdef TIOCGPGRP
5907 /* Get the current pgrp using the tty itself, if we have that.
5908 Otherwise, use the pty to get the pgrp.
5909 On pfa systems, saka@pfu.fujitsu.co.JP writes:
5910 "TIOCGPGRP symbol defined in sys/ioctl.h at E50.
5911 But, TIOCGPGRP does not work on E50 ;-P works fine on E60"
5912 His patch indicates that if TIOCGPGRP returns an error, then
5913 we should just assume that p->pid is also the process group id. */
5915 gid = emacs_get_tty_pgrp (p);
5917 if (gid == -1)
5918 /* If we can't get the information, assume
5919 the shell owns the tty. */
5920 gid = p->pid;
5922 /* It is not clear whether anything really can set GID to -1.
5923 Perhaps on some system one of those ioctls can or could do so.
5924 Or perhaps this is vestigial. */
5925 if (gid == -1)
5926 no_pgrp = 1;
5927 #else /* ! defined (TIOCGPGRP ) */
5928 /* Can't select pgrps on this system, so we know that
5929 the child itself heads the pgrp. */
5930 gid = p->pid;
5931 #endif /* ! defined (TIOCGPGRP ) */
5933 /* If current_group is lambda, and the shell owns the terminal,
5934 don't send any signal. */
5935 if (EQ (current_group, Qlambda) && gid == p->pid)
5936 return;
5939 switch (signo)
5941 #ifdef SIGCONT
5942 case SIGCONT:
5943 p->raw_status_new = 0;
5944 p->status = Qrun;
5945 p->tick = ++process_tick;
5946 if (!nomsg)
5948 status_notify (NULL);
5949 redisplay_preserve_echo_area (13);
5951 break;
5952 #endif /* ! defined (SIGCONT) */
5953 case SIGINT:
5954 case SIGQUIT:
5955 case SIGKILL:
5956 flush_pending_output (p->infd);
5957 break;
5960 /* If we don't have process groups, send the signal to the immediate
5961 subprocess. That isn't really right, but it's better than any
5962 obvious alternative. */
5963 if (no_pgrp)
5965 kill (p->pid, signo);
5966 return;
5969 /* gid may be a pid, or minus a pgrp's number */
5970 #ifdef TIOCSIGSEND
5971 if (!NILP (current_group))
5973 if (ioctl (p->infd, TIOCSIGSEND, signo) == -1)
5974 EMACS_KILLPG (gid, signo);
5976 else
5978 gid = - p->pid;
5979 kill (gid, signo);
5981 #else /* ! defined (TIOCSIGSEND) */
5982 EMACS_KILLPG (gid, signo);
5983 #endif /* ! defined (TIOCSIGSEND) */
5986 DEFUN ("interrupt-process", Finterrupt_process, Sinterrupt_process, 0, 2, 0,
5987 doc: /* Interrupt process PROCESS.
5988 PROCESS may be a process, a buffer, or the name of a process or buffer.
5989 No arg or nil means current buffer's process.
5990 Second arg CURRENT-GROUP non-nil means send signal to
5991 the current process-group of the process's controlling terminal
5992 rather than to the process's own process group.
5993 If the process is a shell, this means interrupt current subjob
5994 rather than the shell.
5996 If CURRENT-GROUP is `lambda', and if the shell owns the terminal,
5997 don't send the signal. */)
5998 (Lisp_Object process, Lisp_Object current_group)
6000 process_send_signal (process, SIGINT, current_group, 0);
6001 return process;
6004 DEFUN ("kill-process", Fkill_process, Skill_process, 0, 2, 0,
6005 doc: /* Kill process PROCESS. May be process or name of one.
6006 See function `interrupt-process' for more details on usage. */)
6007 (Lisp_Object process, Lisp_Object current_group)
6009 process_send_signal (process, SIGKILL, current_group, 0);
6010 return process;
6013 DEFUN ("quit-process", Fquit_process, Squit_process, 0, 2, 0,
6014 doc: /* Send QUIT signal to process PROCESS. May be process or name of one.
6015 See function `interrupt-process' for more details on usage. */)
6016 (Lisp_Object process, Lisp_Object current_group)
6018 process_send_signal (process, SIGQUIT, current_group, 0);
6019 return process;
6022 DEFUN ("stop-process", Fstop_process, Sstop_process, 0, 2, 0,
6023 doc: /* Stop process PROCESS. May be process or name of one.
6024 See function `interrupt-process' for more details on usage.
6025 If PROCESS is a network or serial process, inhibit handling of incoming
6026 traffic. */)
6027 (Lisp_Object process, Lisp_Object current_group)
6029 if (PROCESSP (process) && (NETCONN_P (process) || SERIALCONN_P (process)))
6031 struct Lisp_Process *p;
6033 p = XPROCESS (process);
6034 if (NILP (p->command)
6035 && p->infd >= 0)
6037 FD_CLR (p->infd, &input_wait_mask);
6038 FD_CLR (p->infd, &non_keyboard_wait_mask);
6040 p->command = Qt;
6041 return process;
6043 #ifndef SIGTSTP
6044 error ("No SIGTSTP support");
6045 #else
6046 process_send_signal (process, SIGTSTP, current_group, 0);
6047 #endif
6048 return process;
6051 DEFUN ("continue-process", Fcontinue_process, Scontinue_process, 0, 2, 0,
6052 doc: /* Continue process PROCESS. May be process or name of one.
6053 See function `interrupt-process' for more details on usage.
6054 If PROCESS is a network or serial process, resume handling of incoming
6055 traffic. */)
6056 (Lisp_Object process, Lisp_Object current_group)
6058 if (PROCESSP (process) && (NETCONN_P (process) || SERIALCONN_P (process)))
6060 struct Lisp_Process *p;
6062 p = XPROCESS (process);
6063 if (EQ (p->command, Qt)
6064 && p->infd >= 0
6065 && (!EQ (p->filter, Qt) || EQ (p->status, Qlisten)))
6067 FD_SET (p->infd, &input_wait_mask);
6068 FD_SET (p->infd, &non_keyboard_wait_mask);
6069 #ifdef WINDOWSNT
6070 if (fd_info[ p->infd ].flags & FILE_SERIAL)
6071 PurgeComm (fd_info[ p->infd ].hnd, PURGE_RXABORT | PURGE_RXCLEAR);
6072 #else /* not WINDOWSNT */
6073 tcflush (p->infd, TCIFLUSH);
6074 #endif /* not WINDOWSNT */
6076 p->command = Qnil;
6077 return process;
6079 #ifdef SIGCONT
6080 process_send_signal (process, SIGCONT, current_group, 0);
6081 #else
6082 error ("No SIGCONT support");
6083 #endif
6084 return process;
6087 DEFUN ("signal-process", Fsignal_process, Ssignal_process,
6088 2, 2, "sProcess (name or number): \nnSignal code: ",
6089 doc: /* Send PROCESS the signal with code SIGCODE.
6090 PROCESS may also be a number specifying the process id of the
6091 process to signal; in this case, the process need not be a child of
6092 this Emacs.
6093 SIGCODE may be an integer, or a symbol whose name is a signal name. */)
6094 (Lisp_Object process, Lisp_Object sigcode)
6096 pid_t pid;
6098 if (STRINGP (process))
6100 Lisp_Object tem = Fget_process (process);
6101 if (NILP (tem))
6103 Lisp_Object process_number =
6104 string_to_number (SSDATA (process), 10, 1);
6105 if (INTEGERP (process_number) || FLOATP (process_number))
6106 tem = process_number;
6108 process = tem;
6110 else if (!NUMBERP (process))
6111 process = get_process (process);
6113 if (NILP (process))
6114 return process;
6116 if (NUMBERP (process))
6117 CONS_TO_INTEGER (process, pid_t, pid);
6118 else
6120 CHECK_PROCESS (process);
6121 pid = XPROCESS (process)->pid;
6122 if (pid <= 0)
6123 error ("Cannot signal process %s", SDATA (XPROCESS (process)->name));
6126 #define parse_signal(NAME, VALUE) \
6127 else if (!xstrcasecmp (name, NAME)) \
6128 XSETINT (sigcode, VALUE)
6130 if (INTEGERP (sigcode))
6131 CHECK_TYPE_RANGED_INTEGER (int, sigcode);
6132 else
6134 char *name;
6136 CHECK_SYMBOL (sigcode);
6137 name = SSDATA (SYMBOL_NAME (sigcode));
6139 if (!strncmp (name, "SIG", 3) || !strncmp (name, "sig", 3))
6140 name += 3;
6142 if (0)
6144 #ifdef SIGUSR1
6145 parse_signal ("usr1", SIGUSR1);
6146 #endif
6147 #ifdef SIGUSR2
6148 parse_signal ("usr2", SIGUSR2);
6149 #endif
6150 #ifdef SIGTERM
6151 parse_signal ("term", SIGTERM);
6152 #endif
6153 #ifdef SIGHUP
6154 parse_signal ("hup", SIGHUP);
6155 #endif
6156 #ifdef SIGINT
6157 parse_signal ("int", SIGINT);
6158 #endif
6159 #ifdef SIGQUIT
6160 parse_signal ("quit", SIGQUIT);
6161 #endif
6162 #ifdef SIGILL
6163 parse_signal ("ill", SIGILL);
6164 #endif
6165 #ifdef SIGABRT
6166 parse_signal ("abrt", SIGABRT);
6167 #endif
6168 #ifdef SIGEMT
6169 parse_signal ("emt", SIGEMT);
6170 #endif
6171 #ifdef SIGKILL
6172 parse_signal ("kill", SIGKILL);
6173 #endif
6174 #ifdef SIGFPE
6175 parse_signal ("fpe", SIGFPE);
6176 #endif
6177 #ifdef SIGBUS
6178 parse_signal ("bus", SIGBUS);
6179 #endif
6180 #ifdef SIGSEGV
6181 parse_signal ("segv", SIGSEGV);
6182 #endif
6183 #ifdef SIGSYS
6184 parse_signal ("sys", SIGSYS);
6185 #endif
6186 #ifdef SIGPIPE
6187 parse_signal ("pipe", SIGPIPE);
6188 #endif
6189 #ifdef SIGALRM
6190 parse_signal ("alrm", SIGALRM);
6191 #endif
6192 #ifdef SIGURG
6193 parse_signal ("urg", SIGURG);
6194 #endif
6195 #ifdef SIGSTOP
6196 parse_signal ("stop", SIGSTOP);
6197 #endif
6198 #ifdef SIGTSTP
6199 parse_signal ("tstp", SIGTSTP);
6200 #endif
6201 #ifdef SIGCONT
6202 parse_signal ("cont", SIGCONT);
6203 #endif
6204 #ifdef SIGCHLD
6205 parse_signal ("chld", SIGCHLD);
6206 #endif
6207 #ifdef SIGTTIN
6208 parse_signal ("ttin", SIGTTIN);
6209 #endif
6210 #ifdef SIGTTOU
6211 parse_signal ("ttou", SIGTTOU);
6212 #endif
6213 #ifdef SIGIO
6214 parse_signal ("io", SIGIO);
6215 #endif
6216 #ifdef SIGXCPU
6217 parse_signal ("xcpu", SIGXCPU);
6218 #endif
6219 #ifdef SIGXFSZ
6220 parse_signal ("xfsz", SIGXFSZ);
6221 #endif
6222 #ifdef SIGVTALRM
6223 parse_signal ("vtalrm", SIGVTALRM);
6224 #endif
6225 #ifdef SIGPROF
6226 parse_signal ("prof", SIGPROF);
6227 #endif
6228 #ifdef SIGWINCH
6229 parse_signal ("winch", SIGWINCH);
6230 #endif
6231 #ifdef SIGINFO
6232 parse_signal ("info", SIGINFO);
6233 #endif
6234 else
6235 error ("Undefined signal name %s", name);
6238 #undef parse_signal
6240 return make_number (kill (pid, XINT (sigcode)));
6243 DEFUN ("process-send-eof", Fprocess_send_eof, Sprocess_send_eof, 0, 1, 0,
6244 doc: /* Make PROCESS see end-of-file in its input.
6245 EOF comes after any text already sent to it.
6246 PROCESS may be a process, a buffer, the name of a process or buffer, or
6247 nil, indicating the current buffer's process.
6248 If PROCESS is a network connection, or is a process communicating
6249 through a pipe (as opposed to a pty), then you cannot send any more
6250 text to PROCESS after you call this function.
6251 If PROCESS is a serial process, wait until all output written to the
6252 process has been transmitted to the serial port. */)
6253 (Lisp_Object process)
6255 Lisp_Object proc;
6256 struct coding_system *coding;
6258 if (DATAGRAM_CONN_P (process))
6259 return process;
6261 proc = get_process (process);
6262 coding = proc_encode_coding_system[XPROCESS (proc)->outfd];
6264 /* Make sure the process is really alive. */
6265 if (XPROCESS (proc)->raw_status_new)
6266 update_status (XPROCESS (proc));
6267 if (! EQ (XPROCESS (proc)->status, Qrun))
6268 error ("Process %s not running", SDATA (XPROCESS (proc)->name));
6270 if (CODING_REQUIRE_FLUSHING (coding))
6272 coding->mode |= CODING_MODE_LAST_BLOCK;
6273 send_process (proc, "", 0, Qnil);
6276 if (XPROCESS (proc)->pty_flag)
6277 send_process (proc, "\004", 1, Qnil);
6278 else if (EQ (XPROCESS (proc)->type, Qserial))
6280 #ifndef WINDOWSNT
6281 if (tcdrain (XPROCESS (proc)->outfd) != 0)
6282 error ("tcdrain() failed: %s", emacs_strerror (errno));
6283 #endif /* not WINDOWSNT */
6284 /* Do nothing on Windows because writes are blocking. */
6286 else
6288 int old_outfd, new_outfd;
6290 #ifdef HAVE_SHUTDOWN
6291 /* If this is a network connection, or socketpair is used
6292 for communication with the subprocess, call shutdown to cause EOF.
6293 (In some old system, shutdown to socketpair doesn't work.
6294 Then we just can't win.) */
6295 if (EQ (XPROCESS (proc)->type, Qnetwork)
6296 || XPROCESS (proc)->outfd == XPROCESS (proc)->infd)
6297 shutdown (XPROCESS (proc)->outfd, 1);
6298 /* In case of socketpair, outfd == infd, so don't close it. */
6299 if (XPROCESS (proc)->outfd != XPROCESS (proc)->infd)
6300 emacs_close (XPROCESS (proc)->outfd);
6301 #else /* not HAVE_SHUTDOWN */
6302 emacs_close (XPROCESS (proc)->outfd);
6303 #endif /* not HAVE_SHUTDOWN */
6304 new_outfd = emacs_open (NULL_DEVICE, O_WRONLY, 0);
6305 if (new_outfd < 0)
6306 abort ();
6307 old_outfd = XPROCESS (proc)->outfd;
6309 if (!proc_encode_coding_system[new_outfd])
6310 proc_encode_coding_system[new_outfd]
6311 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
6312 memcpy (proc_encode_coding_system[new_outfd],
6313 proc_encode_coding_system[old_outfd],
6314 sizeof (struct coding_system));
6315 memset (proc_encode_coding_system[old_outfd], 0,
6316 sizeof (struct coding_system));
6318 XPROCESS (proc)->outfd = new_outfd;
6320 return process;
6323 /* On receipt of a signal that a child status has changed, loop asking
6324 about children with changed statuses until the system says there
6325 are no more.
6327 All we do is change the status; we do not run sentinels or print
6328 notifications. That is saved for the next time keyboard input is
6329 done, in order to avoid timing errors.
6331 ** WARNING: this can be called during garbage collection.
6332 Therefore, it must not be fooled by the presence of mark bits in
6333 Lisp objects.
6335 ** USG WARNING: Although it is not obvious from the documentation
6336 in signal(2), on a USG system the SIGCLD handler MUST NOT call
6337 signal() before executing at least one wait(), otherwise the
6338 handler will be called again, resulting in an infinite loop. The
6339 relevant portion of the documentation reads "SIGCLD signals will be
6340 queued and the signal-catching function will be continually
6341 reentered until the queue is empty". Invoking signal() causes the
6342 kernel to reexamine the SIGCLD queue. Fred Fish, UniSoft Systems
6343 Inc.
6345 ** Malloc WARNING: This should never call malloc either directly or
6346 indirectly; if it does, that is a bug */
6348 #ifdef SIGCHLD
6349 static void
6350 sigchld_handler (int signo)
6352 int old_errno = errno;
6353 Lisp_Object proc;
6354 struct Lisp_Process *p;
6356 SIGNAL_THREAD_CHECK (signo);
6358 while (1)
6360 pid_t pid;
6361 int w;
6362 Lisp_Object tail;
6364 #ifdef WNOHANG
6365 #ifndef WUNTRACED
6366 #define WUNTRACED 0
6367 #endif /* no WUNTRACED */
6368 /* Keep trying to get a status until we get a definitive result. */
6371 errno = 0;
6372 pid = wait3 (&w, WNOHANG | WUNTRACED, 0);
6374 while (pid < 0 && errno == EINTR);
6376 if (pid <= 0)
6378 /* PID == 0 means no processes found, PID == -1 means a real
6379 failure. We have done all our job, so return. */
6381 errno = old_errno;
6382 return;
6384 #else
6385 pid = wait (&w);
6386 #endif /* no WNOHANG */
6388 /* Find the process that signaled us, and record its status. */
6390 /* The process can have been deleted by Fdelete_process. */
6391 for (tail = deleted_pid_list; CONSP (tail); tail = XCDR (tail))
6393 Lisp_Object xpid = XCAR (tail);
6394 if ((INTEGERP (xpid) && pid == XINT (xpid))
6395 || (FLOATP (xpid) && pid == XFLOAT_DATA (xpid)))
6397 XSETCAR (tail, Qnil);
6398 goto sigchld_end_of_loop;
6402 /* Otherwise, if it is asynchronous, it is in Vprocess_alist. */
6403 p = 0;
6404 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
6406 proc = XCDR (XCAR (tail));
6407 p = XPROCESS (proc);
6408 if (EQ (p->type, Qreal) && p->pid == pid)
6409 break;
6410 p = 0;
6413 /* Look for an asynchronous process whose pid hasn't been filled
6414 in yet. */
6415 if (p == 0)
6416 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
6418 proc = XCDR (XCAR (tail));
6419 p = XPROCESS (proc);
6420 if (p->pid == -1)
6421 break;
6422 p = 0;
6425 /* Change the status of the process that was found. */
6426 if (p != 0)
6428 int clear_desc_flag = 0;
6430 p->tick = ++process_tick;
6431 p->raw_status = w;
6432 p->raw_status_new = 1;
6434 /* If process has terminated, stop waiting for its output. */
6435 if ((WIFSIGNALED (w) || WIFEXITED (w))
6436 && p->infd >= 0)
6437 clear_desc_flag = 1;
6439 /* We use clear_desc_flag to avoid a compiler bug in Microsoft C. */
6440 if (clear_desc_flag)
6442 FD_CLR (p->infd, &input_wait_mask);
6443 FD_CLR (p->infd, &non_keyboard_wait_mask);
6446 /* Tell wait_reading_process_output that it needs to wake up and
6447 look around. */
6448 if (input_available_clear_time)
6449 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
6452 /* There was no asynchronous process found for that pid: we have
6453 a synchronous process. */
6454 else
6456 synch_process_alive = 0;
6458 /* Report the status of the synchronous process. */
6459 if (WIFEXITED (w))
6460 synch_process_retcode = WRETCODE (w);
6461 else if (WIFSIGNALED (w))
6462 synch_process_termsig = WTERMSIG (w);
6464 /* Tell wait_reading_process_output that it needs to wake up and
6465 look around. */
6466 if (input_available_clear_time)
6467 EMACS_SET_SECS_USECS (*input_available_clear_time, 0, 0);
6470 sigchld_end_of_loop:
6473 /* On some systems, we must return right away.
6474 If any more processes want to signal us, we will
6475 get another signal.
6476 Otherwise (on systems that have WNOHANG), loop around
6477 to use up all the processes that have something to tell us. */
6478 #if (defined WINDOWSNT \
6479 || (defined USG && !defined GNU_LINUX \
6480 && !(defined HPUX && defined WNOHANG)))
6481 errno = old_errno;
6482 return;
6483 #endif /* USG, but not HPUX with WNOHANG */
6486 #endif /* SIGCHLD */
6489 static Lisp_Object
6490 exec_sentinel_unwind (Lisp_Object data)
6492 XPROCESS (XCAR (data))->sentinel = XCDR (data);
6493 return Qnil;
6496 static Lisp_Object
6497 exec_sentinel_error_handler (Lisp_Object error_val)
6499 cmd_error_internal (error_val, "error in process sentinel: ");
6500 Vinhibit_quit = Qt;
6501 update_echo_area ();
6502 Fsleep_for (make_number (2), Qnil);
6503 return Qt;
6506 static void
6507 exec_sentinel (Lisp_Object proc, Lisp_Object reason)
6509 Lisp_Object sentinel, odeactivate;
6510 register struct Lisp_Process *p = XPROCESS (proc);
6511 ptrdiff_t count = SPECPDL_INDEX ();
6512 int outer_running_asynch_code = running_asynch_code;
6513 int waiting = waiting_for_user_input_p;
6515 if (inhibit_sentinels)
6516 return;
6518 /* No need to gcpro these, because all we do with them later
6519 is test them for EQness, and none of them should be a string. */
6520 odeactivate = Vdeactivate_mark;
6521 #if 0
6522 Lisp_Object obuffer, okeymap;
6523 XSETBUFFER (obuffer, current_buffer);
6524 okeymap = BVAR (current_buffer, keymap);
6525 #endif
6527 /* There's no good reason to let sentinels change the current
6528 buffer, and many callers of accept-process-output, sit-for, and
6529 friends don't expect current-buffer to be changed from under them. */
6530 record_unwind_protect (set_buffer_if_live, Fcurrent_buffer ());
6532 sentinel = p->sentinel;
6533 if (NILP (sentinel))
6534 return;
6536 /* Zilch the sentinel while it's running, to avoid recursive invocations;
6537 assure that it gets restored no matter how the sentinel exits. */
6538 p->sentinel = Qnil;
6539 record_unwind_protect (exec_sentinel_unwind, Fcons (proc, sentinel));
6540 /* Inhibit quit so that random quits don't screw up a running filter. */
6541 specbind (Qinhibit_quit, Qt);
6542 specbind (Qlast_nonmenu_event, Qt); /* Why? --Stef */
6544 /* In case we get recursively called,
6545 and we already saved the match data nonrecursively,
6546 save the same match data in safely recursive fashion. */
6547 if (outer_running_asynch_code)
6549 Lisp_Object tem;
6550 tem = Fmatch_data (Qnil, Qnil, Qnil);
6551 restore_search_regs ();
6552 record_unwind_save_match_data ();
6553 Fset_match_data (tem, Qt);
6556 /* For speed, if a search happens within this code,
6557 save the match data in a special nonrecursive fashion. */
6558 running_asynch_code = 1;
6560 internal_condition_case_1 (read_process_output_call,
6561 Fcons (sentinel,
6562 Fcons (proc, Fcons (reason, Qnil))),
6563 !NILP (Vdebug_on_error) ? Qnil : Qerror,
6564 exec_sentinel_error_handler);
6566 /* If we saved the match data nonrecursively, restore it now. */
6567 restore_search_regs ();
6568 running_asynch_code = outer_running_asynch_code;
6570 Vdeactivate_mark = odeactivate;
6572 /* Restore waiting_for_user_input_p as it was
6573 when we were called, in case the filter clobbered it. */
6574 waiting_for_user_input_p = waiting;
6576 #if 0
6577 if (! EQ (Fcurrent_buffer (), obuffer)
6578 || ! EQ (current_buffer->keymap, okeymap))
6579 #endif
6580 /* But do it only if the caller is actually going to read events.
6581 Otherwise there's no need to make him wake up, and it could
6582 cause trouble (for example it would make sit_for return). */
6583 if (waiting_for_user_input_p == -1)
6584 record_asynch_buffer_change ();
6586 unbind_to (count, Qnil);
6589 /* Report all recent events of a change in process status
6590 (either run the sentinel or output a message).
6591 This is usually done while Emacs is waiting for keyboard input
6592 but can be done at other times. */
6594 static void
6595 status_notify (struct Lisp_Process *deleting_process)
6597 register Lisp_Object proc, buffer;
6598 Lisp_Object tail, msg;
6599 struct gcpro gcpro1, gcpro2;
6601 tail = Qnil;
6602 msg = Qnil;
6603 /* We need to gcpro tail; if read_process_output calls a filter
6604 which deletes a process and removes the cons to which tail points
6605 from Vprocess_alist, and then causes a GC, tail is an unprotected
6606 reference. */
6607 GCPRO2 (tail, msg);
6609 /* Set this now, so that if new processes are created by sentinels
6610 that we run, we get called again to handle their status changes. */
6611 update_tick = process_tick;
6613 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
6615 Lisp_Object symbol;
6616 register struct Lisp_Process *p;
6618 proc = Fcdr (XCAR (tail));
6619 p = XPROCESS (proc);
6621 if (p->tick != p->update_tick)
6623 p->update_tick = p->tick;
6625 /* If process is still active, read any output that remains. */
6626 while (! EQ (p->filter, Qt)
6627 && ! EQ (p->status, Qconnect)
6628 && ! EQ (p->status, Qlisten)
6629 /* Network or serial process not stopped: */
6630 && ! EQ (p->command, Qt)
6631 && p->infd >= 0
6632 && p != deleting_process
6633 && read_process_output (proc, p->infd) > 0);
6635 buffer = p->buffer;
6637 /* Get the text to use for the message. */
6638 if (p->raw_status_new)
6639 update_status (p);
6640 msg = status_message (p);
6642 /* If process is terminated, deactivate it or delete it. */
6643 symbol = p->status;
6644 if (CONSP (p->status))
6645 symbol = XCAR (p->status);
6647 if (EQ (symbol, Qsignal) || EQ (symbol, Qexit)
6648 || EQ (symbol, Qclosed))
6650 if (delete_exited_processes)
6651 remove_process (proc);
6652 else
6653 deactivate_process (proc);
6656 /* The actions above may have further incremented p->tick.
6657 So set p->update_tick again
6658 so that an error in the sentinel will not cause
6659 this code to be run again. */
6660 p->update_tick = p->tick;
6661 /* Now output the message suitably. */
6662 if (!NILP (p->sentinel))
6663 exec_sentinel (proc, msg);
6664 /* Don't bother with a message in the buffer
6665 when a process becomes runnable. */
6666 else if (!EQ (symbol, Qrun) && !NILP (buffer))
6668 Lisp_Object tem;
6669 struct buffer *old = current_buffer;
6670 ptrdiff_t opoint, opoint_byte;
6671 ptrdiff_t before, before_byte;
6673 /* Avoid error if buffer is deleted
6674 (probably that's why the process is dead, too) */
6675 if (NILP (BVAR (XBUFFER (buffer), name)))
6676 continue;
6677 Fset_buffer (buffer);
6679 opoint = PT;
6680 opoint_byte = PT_BYTE;
6681 /* Insert new output into buffer
6682 at the current end-of-output marker,
6683 thus preserving logical ordering of input and output. */
6684 if (XMARKER (p->mark)->buffer)
6685 Fgoto_char (p->mark);
6686 else
6687 SET_PT_BOTH (ZV, ZV_BYTE);
6689 before = PT;
6690 before_byte = PT_BYTE;
6692 tem = BVAR (current_buffer, read_only);
6693 BVAR (current_buffer, read_only) = Qnil;
6694 insert_string ("\nProcess ");
6695 Finsert (1, &p->name);
6696 insert_string (" ");
6697 Finsert (1, &msg);
6698 BVAR (current_buffer, read_only) = tem;
6699 set_marker_both (p->mark, p->buffer, PT, PT_BYTE);
6701 if (opoint >= before)
6702 SET_PT_BOTH (opoint + (PT - before),
6703 opoint_byte + (PT_BYTE - before_byte));
6704 else
6705 SET_PT_BOTH (opoint, opoint_byte);
6707 set_buffer_internal (old);
6710 } /* end for */
6712 update_mode_lines++; /* in case buffers use %s in mode-line-format */
6713 UNGCPRO;
6717 DEFUN ("set-process-coding-system", Fset_process_coding_system,
6718 Sset_process_coding_system, 1, 3, 0,
6719 doc: /* Set coding systems of PROCESS to DECODING and ENCODING.
6720 DECODING will be used to decode subprocess output and ENCODING to
6721 encode subprocess input. */)
6722 (register Lisp_Object process, Lisp_Object decoding, Lisp_Object encoding)
6724 register struct Lisp_Process *p;
6726 CHECK_PROCESS (process);
6727 p = XPROCESS (process);
6728 if (p->infd < 0)
6729 error ("Input file descriptor of %s closed", SDATA (p->name));
6730 if (p->outfd < 0)
6731 error ("Output file descriptor of %s closed", SDATA (p->name));
6732 Fcheck_coding_system (decoding);
6733 Fcheck_coding_system (encoding);
6734 encoding = coding_inherit_eol_type (encoding, Qnil);
6735 p->decode_coding_system = decoding;
6736 p->encode_coding_system = encoding;
6737 setup_process_coding_systems (process);
6739 return Qnil;
6742 DEFUN ("process-coding-system",
6743 Fprocess_coding_system, Sprocess_coding_system, 1, 1, 0,
6744 doc: /* Return a cons of coding systems for decoding and encoding of PROCESS. */)
6745 (register Lisp_Object process)
6747 CHECK_PROCESS (process);
6748 return Fcons (XPROCESS (process)->decode_coding_system,
6749 XPROCESS (process)->encode_coding_system);
6752 DEFUN ("set-process-filter-multibyte", Fset_process_filter_multibyte,
6753 Sset_process_filter_multibyte, 2, 2, 0,
6754 doc: /* Set multibyteness of the strings given to PROCESS's filter.
6755 If FLAG is non-nil, the filter is given multibyte strings.
6756 If FLAG is nil, the filter is given unibyte strings. In this case,
6757 all character code conversion except for end-of-line conversion is
6758 suppressed. */)
6759 (Lisp_Object process, Lisp_Object flag)
6761 register struct Lisp_Process *p;
6763 CHECK_PROCESS (process);
6764 p = XPROCESS (process);
6765 if (NILP (flag))
6766 p->decode_coding_system = raw_text_coding_system (p->decode_coding_system);
6767 setup_process_coding_systems (process);
6769 return Qnil;
6772 DEFUN ("process-filter-multibyte-p", Fprocess_filter_multibyte_p,
6773 Sprocess_filter_multibyte_p, 1, 1, 0,
6774 doc: /* Return t if a multibyte string is given to PROCESS's filter.*/)
6775 (Lisp_Object process)
6777 register struct Lisp_Process *p;
6778 struct coding_system *coding;
6780 CHECK_PROCESS (process);
6781 p = XPROCESS (process);
6782 coding = proc_decode_coding_system[p->infd];
6783 return (CODING_FOR_UNIBYTE (coding) ? Qnil : Qt);
6789 # ifdef HAVE_GPM
6791 void
6792 add_gpm_wait_descriptor (int desc)
6794 add_keyboard_wait_descriptor (desc);
6797 void
6798 delete_gpm_wait_descriptor (int desc)
6800 delete_keyboard_wait_descriptor (desc);
6803 # endif
6805 # ifdef SIGIO
6807 /* Return nonzero if *MASK has a bit set
6808 that corresponds to one of the keyboard input descriptors. */
6810 static int
6811 keyboard_bit_set (fd_set *mask)
6813 int fd;
6815 for (fd = 0; fd <= max_input_desc; fd++)
6816 if (FD_ISSET (fd, mask) && FD_ISSET (fd, &input_wait_mask)
6817 && !FD_ISSET (fd, &non_keyboard_wait_mask))
6818 return 1;
6820 return 0;
6822 # endif
6824 #else /* not subprocesses */
6826 /* Defined on msdos.c. */
6827 extern int sys_select (int, SELECT_TYPE *, SELECT_TYPE *, SELECT_TYPE *,
6828 EMACS_TIME *);
6830 /* Implementation of wait_reading_process_output, assuming that there
6831 are no subprocesses. Used only by the MS-DOS build.
6833 Wait for timeout to elapse and/or keyboard input to be available.
6835 time_limit is:
6836 timeout in seconds
6837 If negative, gobble data immediately available but don't wait for any.
6839 nsec is:
6840 an additional duration to wait, measured in nanoseconds
6841 If TIME_LIMIT is zero, then:
6842 If NSEC == 0, there is no limit.
6843 If NSEC > 0, the timeout consists of NSEC only.
6844 If NSECS < 0, gobble data immediately, as if TIME_LIMIT were negative.
6846 read_kbd is a Lisp_Object:
6847 0 to ignore keyboard input, or
6848 1 to return when input is available, or
6849 -1 means caller will actually read the input, so don't throw to
6850 the quit handler.
6852 see full version for other parameters. We know that wait_proc will
6853 always be NULL, since `subprocesses' isn't defined.
6855 do_display != 0 means redisplay should be done to show subprocess
6856 output that arrives.
6858 Return true if we received input from any process. */
6861 wait_reading_process_output (intmax_t time_limit, int nsecs, int read_kbd,
6862 int do_display,
6863 Lisp_Object wait_for_cell,
6864 struct Lisp_Process *wait_proc, int just_wait_proc)
6866 register int nfds;
6867 EMACS_TIME end_time, timeout;
6868 SELECT_TYPE waitchannels;
6869 int xerrno;
6871 if (time_limit < 0)
6873 time_limit = 0;
6874 nsecs = -1;
6876 else if (TYPE_MAXIMUM (time_t) < time_limit)
6877 time_limit = TYPE_MAXIMUM (time_t);
6879 /* What does time_limit really mean? */
6880 if (time_limit || nsecs) /* FIXME: what if negative? */
6882 EMACS_GET_TIME (end_time);
6883 EMACS_SET_SECS_NSECS (timeout, time_limit, nsecs);
6884 EMACS_ADD_TIME (end_time, end_time, timeout);
6887 /* Turn off periodic alarms (in case they are in use)
6888 and then turn off any other atimers,
6889 because the select emulator uses alarms. */
6890 stop_polling ();
6891 turn_on_atimers (0);
6893 while (1)
6895 int timeout_reduced_for_timers = 0;
6897 /* If calling from keyboard input, do not quit
6898 since we want to return C-g as an input character.
6899 Otherwise, do pending quit if requested. */
6900 if (read_kbd >= 0)
6901 QUIT;
6903 /* Exit now if the cell we're waiting for became non-nil. */
6904 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
6905 break;
6907 /* Compute time from now till when time limit is up */
6908 /* Exit if already run out */
6909 if (nsecs < 0)
6911 /* -1 specified for timeout means
6912 gobble output available now
6913 but don't wait at all. */
6915 EMACS_SET_SECS_USECS (timeout, 0, 0);
6917 else if (time_limit || nsecs)
6919 EMACS_GET_TIME (timeout);
6920 if (EMACS_TIME_LE (end_time, timeout))
6921 break;
6922 EMACS_SUB_TIME (timeout, end_time, timeout);
6924 else
6926 EMACS_SET_SECS_USECS (timeout, 100000, 0);
6929 /* If our caller will not immediately handle keyboard events,
6930 run timer events directly.
6931 (Callers that will immediately read keyboard events
6932 call timer_delay on their own.) */
6933 if (NILP (wait_for_cell))
6935 EMACS_TIME timer_delay;
6939 int old_timers_run = timers_run;
6940 timer_delay = timer_check ();
6941 if (timers_run != old_timers_run && do_display)
6942 /* We must retry, since a timer may have requeued itself
6943 and that could alter the time delay. */
6944 redisplay_preserve_echo_area (14);
6945 else
6946 break;
6948 while (!detect_input_pending ());
6950 /* If there is unread keyboard input, also return. */
6951 if (read_kbd != 0
6952 && requeued_events_pending_p ())
6953 break;
6955 if (EMACS_TIME_VALID_P (timer_delay) && 0 <= nsecs)
6957 if (EMACS_TIME_LT (timer_delay, timeout))
6959 timeout = timer_delay;
6960 timeout_reduced_for_timers = 1;
6965 /* Cause C-g and alarm signals to take immediate action,
6966 and cause input available signals to zero out timeout. */
6967 if (read_kbd < 0)
6968 set_waiting_for_input (&timeout);
6970 /* Wait till there is something to do. */
6972 if (! read_kbd && NILP (wait_for_cell))
6973 FD_ZERO (&waitchannels);
6974 else
6975 FD_SET (0, &waitchannels);
6977 /* If a frame has been newly mapped and needs updating,
6978 reprocess its display stuff. */
6979 if (frame_garbaged && do_display)
6981 clear_waiting_for_input ();
6982 redisplay_preserve_echo_area (15);
6983 if (read_kbd < 0)
6984 set_waiting_for_input (&timeout);
6987 if (read_kbd && detect_input_pending ())
6989 nfds = 0;
6990 FD_ZERO (&waitchannels);
6992 else
6993 nfds = pselect (1, &waitchannels, NULL, NULL, &timeout, NULL);
6995 xerrno = errno;
6997 /* Make C-g and alarm signals set flags again */
6998 clear_waiting_for_input ();
7000 /* If we woke up due to SIGWINCH, actually change size now. */
7001 do_pending_window_change (0);
7003 if ((time_limit || nsecs) && nfds == 0 && ! timeout_reduced_for_timers)
7004 /* We waited the full specified time, so return now. */
7005 break;
7007 if (nfds == -1)
7009 /* If the system call was interrupted, then go around the
7010 loop again. */
7011 if (xerrno == EINTR)
7012 FD_ZERO (&waitchannels);
7013 else
7014 error ("select error: %s", emacs_strerror (xerrno));
7017 /* Check for keyboard input */
7019 if (read_kbd
7020 && detect_input_pending_run_timers (do_display))
7022 swallow_events (do_display);
7023 if (detect_input_pending_run_timers (do_display))
7024 break;
7027 /* If there is unread keyboard input, also return. */
7028 if (read_kbd
7029 && requeued_events_pending_p ())
7030 break;
7032 /* If wait_for_cell. check for keyboard input
7033 but don't run any timers.
7034 ??? (It seems wrong to me to check for keyboard
7035 input at all when wait_for_cell, but the code
7036 has been this way since July 1994.
7037 Try changing this after version 19.31.) */
7038 if (! NILP (wait_for_cell)
7039 && detect_input_pending ())
7041 swallow_events (do_display);
7042 if (detect_input_pending ())
7043 break;
7046 /* Exit now if the cell we're waiting for became non-nil. */
7047 if (! NILP (wait_for_cell) && ! NILP (XCAR (wait_for_cell)))
7048 break;
7051 start_polling ();
7053 return 0;
7056 #endif /* not subprocesses */
7058 /* The following functions are needed even if async subprocesses are
7059 not supported. Some of them are no-op stubs in that case. */
7061 /* Add DESC to the set of keyboard input descriptors. */
7063 void
7064 add_keyboard_wait_descriptor (int desc)
7066 #ifdef subprocesses /* actually means "not MSDOS" */
7067 FD_SET (desc, &input_wait_mask);
7068 FD_SET (desc, &non_process_wait_mask);
7069 if (desc > max_input_desc)
7070 max_input_desc = desc;
7071 #endif
7074 /* From now on, do not expect DESC to give keyboard input. */
7076 void
7077 delete_keyboard_wait_descriptor (int desc)
7079 #ifdef subprocesses
7080 int fd;
7081 int lim = max_input_desc;
7083 FD_CLR (desc, &input_wait_mask);
7084 FD_CLR (desc, &non_process_wait_mask);
7086 if (desc == max_input_desc)
7087 for (fd = 0; fd < lim; fd++)
7088 if (FD_ISSET (fd, &input_wait_mask) || FD_ISSET (fd, &write_mask))
7089 max_input_desc = fd;
7090 #endif
7093 /* Setup coding systems of PROCESS. */
7095 void
7096 setup_process_coding_systems (Lisp_Object process)
7098 #ifdef subprocesses
7099 struct Lisp_Process *p = XPROCESS (process);
7100 int inch = p->infd;
7101 int outch = p->outfd;
7102 Lisp_Object coding_system;
7104 if (inch < 0 || outch < 0)
7105 return;
7107 if (!proc_decode_coding_system[inch])
7108 proc_decode_coding_system[inch]
7109 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
7110 coding_system = p->decode_coding_system;
7111 if (! NILP (p->filter))
7113 else if (BUFFERP (p->buffer))
7115 if (NILP (BVAR (XBUFFER (p->buffer), enable_multibyte_characters)))
7116 coding_system = raw_text_coding_system (coding_system);
7118 setup_coding_system (coding_system, proc_decode_coding_system[inch]);
7120 if (!proc_encode_coding_system[outch])
7121 proc_encode_coding_system[outch]
7122 = (struct coding_system *) xmalloc (sizeof (struct coding_system));
7123 setup_coding_system (p->encode_coding_system,
7124 proc_encode_coding_system[outch]);
7125 #endif
7128 /* Close all descriptors currently in use for communication
7129 with subprocess. This is used in a newly-forked subprocess
7130 to get rid of irrelevant descriptors. */
7132 void
7133 close_process_descs (void)
7135 #ifndef DOS_NT
7136 int i;
7137 for (i = 0; i < MAXDESC; i++)
7139 Lisp_Object process;
7140 process = chan_process[i];
7141 if (!NILP (process))
7143 int in = XPROCESS (process)->infd;
7144 int out = XPROCESS (process)->outfd;
7145 if (in >= 0)
7146 emacs_close (in);
7147 if (out >= 0 && in != out)
7148 emacs_close (out);
7151 #endif
7154 DEFUN ("get-buffer-process", Fget_buffer_process, Sget_buffer_process, 1, 1, 0,
7155 doc: /* Return the (or a) process associated with BUFFER.
7156 BUFFER may be a buffer or the name of one. */)
7157 (register Lisp_Object buffer)
7159 #ifdef subprocesses
7160 register Lisp_Object buf, tail, proc;
7162 if (NILP (buffer)) return Qnil;
7163 buf = Fget_buffer (buffer);
7164 if (NILP (buf)) return Qnil;
7166 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
7168 proc = Fcdr (XCAR (tail));
7169 if (PROCESSP (proc) && EQ (XPROCESS (proc)->buffer, buf))
7170 return proc;
7172 #endif /* subprocesses */
7173 return Qnil;
7176 DEFUN ("process-inherit-coding-system-flag",
7177 Fprocess_inherit_coding_system_flag, Sprocess_inherit_coding_system_flag,
7178 1, 1, 0,
7179 doc: /* Return the value of inherit-coding-system flag for PROCESS.
7180 If this flag is t, `buffer-file-coding-system' of the buffer
7181 associated with PROCESS will inherit the coding system used to decode
7182 the process output. */)
7183 (register Lisp_Object process)
7185 #ifdef subprocesses
7186 CHECK_PROCESS (process);
7187 return XPROCESS (process)->inherit_coding_system_flag ? Qt : Qnil;
7188 #else
7189 /* Ignore the argument and return the value of
7190 inherit-process-coding-system. */
7191 return inherit_process_coding_system ? Qt : Qnil;
7192 #endif
7195 /* Kill all processes associated with `buffer'.
7196 If `buffer' is nil, kill all processes */
7198 void
7199 kill_buffer_processes (Lisp_Object buffer)
7201 #ifdef subprocesses
7202 Lisp_Object tail, proc;
7204 for (tail = Vprocess_alist; CONSP (tail); tail = XCDR (tail))
7206 proc = XCDR (XCAR (tail));
7207 if (PROCESSP (proc)
7208 && (NILP (buffer) || EQ (XPROCESS (proc)->buffer, buffer)))
7210 if (NETCONN_P (proc) || SERIALCONN_P (proc))
7211 Fdelete_process (proc);
7212 else if (XPROCESS (proc)->infd >= 0)
7213 process_send_signal (proc, SIGHUP, Qnil, 1);
7216 #else /* subprocesses */
7217 /* Since we have no subprocesses, this does nothing. */
7218 #endif /* subprocesses */
7221 DEFUN ("waiting-for-user-input-p", Fwaiting_for_user_input_p,
7222 Swaiting_for_user_input_p, 0, 0, 0,
7223 doc: /* Returns non-nil if Emacs is waiting for input from the user.
7224 This is intended for use by asynchronous process output filters and sentinels. */)
7225 (void)
7227 #ifdef subprocesses
7228 return (waiting_for_user_input_p ? Qt : Qnil);
7229 #else
7230 return Qnil;
7231 #endif
7234 /* Stop reading input from keyboard sources. */
7236 void
7237 hold_keyboard_input (void)
7239 kbd_is_on_hold = 1;
7242 /* Resume reading input from keyboard sources. */
7244 void
7245 unhold_keyboard_input (void)
7247 kbd_is_on_hold = 0;
7250 /* Return non-zero if keyboard input is on hold, zero otherwise. */
7253 kbd_on_hold_p (void)
7255 return kbd_is_on_hold;
7259 /* Enumeration of and access to system processes a-la ps(1). */
7261 DEFUN ("list-system-processes", Flist_system_processes, Slist_system_processes,
7262 0, 0, 0,
7263 doc: /* Return a list of numerical process IDs of all running processes.
7264 If this functionality is unsupported, return nil.
7266 See `process-attributes' for getting attributes of a process given its ID. */)
7267 (void)
7269 return list_system_processes ();
7272 DEFUN ("process-attributes", Fprocess_attributes,
7273 Sprocess_attributes, 1, 1, 0,
7274 doc: /* Return attributes of the process given by its PID, a number.
7276 Value is an alist where each element is a cons cell of the form
7278 \(KEY . VALUE)
7280 If this functionality is unsupported, the value is nil.
7282 See `list-system-processes' for getting a list of all process IDs.
7284 The KEYs of the attributes that this function may return are listed
7285 below, together with the type of the associated VALUE (in parentheses).
7286 Not all platforms support all of these attributes; unsupported
7287 attributes will not appear in the returned alist.
7288 Unless explicitly indicated otherwise, numbers can have either
7289 integer or floating point values.
7291 euid -- Effective user User ID of the process (number)
7292 user -- User name corresponding to euid (string)
7293 egid -- Effective user Group ID of the process (number)
7294 group -- Group name corresponding to egid (string)
7295 comm -- Command name (executable name only) (string)
7296 state -- Process state code, such as "S", "R", or "T" (string)
7297 ppid -- Parent process ID (number)
7298 pgrp -- Process group ID (number)
7299 sess -- Session ID, i.e. process ID of session leader (number)
7300 ttname -- Controlling tty name (string)
7301 tpgid -- ID of foreground process group on the process's tty (number)
7302 minflt -- number of minor page faults (number)
7303 majflt -- number of major page faults (number)
7304 cminflt -- cumulative number of minor page faults (number)
7305 cmajflt -- cumulative number of major page faults (number)
7306 utime -- user time used by the process, in (current-time) format,
7307 which is a list of integers (HIGH LOW USEC PSEC)
7308 stime -- system time used by the process (current-time)
7309 time -- sum of utime and stime (current-time)
7310 cutime -- user time used by the process and its children (current-time)
7311 cstime -- system time used by the process and its children (current-time)
7312 ctime -- sum of cutime and cstime (current-time)
7313 pri -- priority of the process (number)
7314 nice -- nice value of the process (number)
7315 thcount -- process thread count (number)
7316 start -- time the process started (current-time)
7317 vsize -- virtual memory size of the process in KB's (number)
7318 rss -- resident set size of the process in KB's (number)
7319 etime -- elapsed time the process is running, in (HIGH LOW USEC PSEC) format
7320 pcpu -- percents of CPU time used by the process (floating-point number)
7321 pmem -- percents of total physical memory used by process's resident set
7322 (floating-point number)
7323 args -- command line which invoked the process (string). */)
7324 ( Lisp_Object pid)
7326 return system_process_attributes (pid);
7330 void
7331 init_process (void)
7333 #ifdef subprocesses
7334 register int i;
7336 inhibit_sentinels = 0;
7338 #ifdef SIGCHLD
7339 #ifndef CANNOT_DUMP
7340 if (! noninteractive || initialized)
7341 #endif
7342 signal (SIGCHLD, sigchld_handler);
7343 #endif
7345 FD_ZERO (&input_wait_mask);
7346 FD_ZERO (&non_keyboard_wait_mask);
7347 FD_ZERO (&non_process_wait_mask);
7348 FD_ZERO (&write_mask);
7349 max_process_desc = 0;
7350 memset (fd_callback_info, 0, sizeof (fd_callback_info));
7352 #ifdef NON_BLOCKING_CONNECT
7353 FD_ZERO (&connect_wait_mask);
7354 num_pending_connects = 0;
7355 #endif
7357 #ifdef ADAPTIVE_READ_BUFFERING
7358 process_output_delay_count = 0;
7359 process_output_skip = 0;
7360 #endif
7362 /* Don't do this, it caused infinite select loops. The display
7363 method should call add_keyboard_wait_descriptor on stdin if it
7364 needs that. */
7365 #if 0
7366 FD_SET (0, &input_wait_mask);
7367 #endif
7369 Vprocess_alist = Qnil;
7370 #ifdef SIGCHLD
7371 deleted_pid_list = Qnil;
7372 #endif
7373 for (i = 0; i < MAXDESC; i++)
7375 chan_process[i] = Qnil;
7376 proc_buffered_char[i] = -1;
7378 memset (proc_decode_coding_system, 0, sizeof proc_decode_coding_system);
7379 memset (proc_encode_coding_system, 0, sizeof proc_encode_coding_system);
7380 #ifdef DATAGRAM_SOCKETS
7381 memset (datagram_address, 0, sizeof datagram_address);
7382 #endif
7385 Lisp_Object subfeatures = Qnil;
7386 const struct socket_options *sopt;
7388 #define ADD_SUBFEATURE(key, val) \
7389 subfeatures = pure_cons (pure_cons (key, pure_cons (val, Qnil)), subfeatures)
7391 #ifdef NON_BLOCKING_CONNECT
7392 ADD_SUBFEATURE (QCnowait, Qt);
7393 #endif
7394 #ifdef DATAGRAM_SOCKETS
7395 ADD_SUBFEATURE (QCtype, Qdatagram);
7396 #endif
7397 #ifdef HAVE_SEQPACKET
7398 ADD_SUBFEATURE (QCtype, Qseqpacket);
7399 #endif
7400 #ifdef HAVE_LOCAL_SOCKETS
7401 ADD_SUBFEATURE (QCfamily, Qlocal);
7402 #endif
7403 ADD_SUBFEATURE (QCfamily, Qipv4);
7404 #ifdef AF_INET6
7405 ADD_SUBFEATURE (QCfamily, Qipv6);
7406 #endif
7407 #ifdef HAVE_GETSOCKNAME
7408 ADD_SUBFEATURE (QCservice, Qt);
7409 #endif
7410 #if defined (O_NONBLOCK) || defined (O_NDELAY)
7411 ADD_SUBFEATURE (QCserver, Qt);
7412 #endif
7414 for (sopt = socket_options; sopt->name; sopt++)
7415 subfeatures = pure_cons (intern_c_string (sopt->name), subfeatures);
7417 Fprovide (intern_c_string ("make-network-process"), subfeatures);
7420 #if defined (DARWIN_OS)
7421 /* PTYs are broken on Darwin < 6, but are sometimes useful for interactive
7422 processes. As such, we only change the default value. */
7423 if (initialized)
7425 char const *release = (STRINGP (Voperating_system_release)
7426 ? SSDATA (Voperating_system_release)
7427 : 0);
7428 if (!release || !release[0] || (release[0] < MIN_PTY_KERNEL_VERSION
7429 && release[1] == '.')) {
7430 Vprocess_connection_type = Qnil;
7433 #endif
7434 #endif /* subprocesses */
7435 kbd_is_on_hold = 0;
7438 void
7439 syms_of_process (void)
7441 #ifdef subprocesses
7443 DEFSYM (Qprocessp, "processp");
7444 DEFSYM (Qrun, "run");
7445 DEFSYM (Qstop, "stop");
7446 DEFSYM (Qsignal, "signal");
7448 /* Qexit is already staticpro'd by syms_of_eval; don't staticpro it
7449 here again.
7451 Qexit = intern_c_string ("exit");
7452 staticpro (&Qexit); */
7454 DEFSYM (Qopen, "open");
7455 DEFSYM (Qclosed, "closed");
7456 DEFSYM (Qconnect, "connect");
7457 DEFSYM (Qfailed, "failed");
7458 DEFSYM (Qlisten, "listen");
7459 DEFSYM (Qlocal, "local");
7460 DEFSYM (Qipv4, "ipv4");
7461 #ifdef AF_INET6
7462 DEFSYM (Qipv6, "ipv6");
7463 #endif
7464 DEFSYM (Qdatagram, "datagram");
7465 DEFSYM (Qseqpacket, "seqpacket");
7467 DEFSYM (QCport, ":port");
7468 DEFSYM (QCspeed, ":speed");
7469 DEFSYM (QCprocess, ":process");
7471 DEFSYM (QCbytesize, ":bytesize");
7472 DEFSYM (QCstopbits, ":stopbits");
7473 DEFSYM (QCparity, ":parity");
7474 DEFSYM (Qodd, "odd");
7475 DEFSYM (Qeven, "even");
7476 DEFSYM (QCflowcontrol, ":flowcontrol");
7477 DEFSYM (Qhw, "hw");
7478 DEFSYM (Qsw, "sw");
7479 DEFSYM (QCsummary, ":summary");
7481 DEFSYM (Qreal, "real");
7482 DEFSYM (Qnetwork, "network");
7483 DEFSYM (Qserial, "serial");
7484 DEFSYM (QCbuffer, ":buffer");
7485 DEFSYM (QChost, ":host");
7486 DEFSYM (QCservice, ":service");
7487 DEFSYM (QClocal, ":local");
7488 DEFSYM (QCremote, ":remote");
7489 DEFSYM (QCcoding, ":coding");
7490 DEFSYM (QCserver, ":server");
7491 DEFSYM (QCnowait, ":nowait");
7492 DEFSYM (QCsentinel, ":sentinel");
7493 DEFSYM (QClog, ":log");
7494 DEFSYM (QCnoquery, ":noquery");
7495 DEFSYM (QCstop, ":stop");
7496 DEFSYM (QCoptions, ":options");
7497 DEFSYM (QCplist, ":plist");
7499 DEFSYM (Qlast_nonmenu_event, "last-nonmenu-event");
7501 staticpro (&Vprocess_alist);
7502 #ifdef SIGCHLD
7503 staticpro (&deleted_pid_list);
7504 #endif
7506 #endif /* subprocesses */
7508 DEFSYM (QCname, ":name");
7509 DEFSYM (QCtype, ":type");
7511 DEFSYM (Qeuid, "euid");
7512 DEFSYM (Qegid, "egid");
7513 DEFSYM (Quser, "user");
7514 DEFSYM (Qgroup, "group");
7515 DEFSYM (Qcomm, "comm");
7516 DEFSYM (Qstate, "state");
7517 DEFSYM (Qppid, "ppid");
7518 DEFSYM (Qpgrp, "pgrp");
7519 DEFSYM (Qsess, "sess");
7520 DEFSYM (Qttname, "ttname");
7521 DEFSYM (Qtpgid, "tpgid");
7522 DEFSYM (Qminflt, "minflt");
7523 DEFSYM (Qmajflt, "majflt");
7524 DEFSYM (Qcminflt, "cminflt");
7525 DEFSYM (Qcmajflt, "cmajflt");
7526 DEFSYM (Qutime, "utime");
7527 DEFSYM (Qstime, "stime");
7528 DEFSYM (Qtime, "time");
7529 DEFSYM (Qcutime, "cutime");
7530 DEFSYM (Qcstime, "cstime");
7531 DEFSYM (Qctime, "ctime");
7532 DEFSYM (Qpri, "pri");
7533 DEFSYM (Qnice, "nice");
7534 DEFSYM (Qthcount, "thcount");
7535 DEFSYM (Qstart, "start");
7536 DEFSYM (Qvsize, "vsize");
7537 DEFSYM (Qrss, "rss");
7538 DEFSYM (Qetime, "etime");
7539 DEFSYM (Qpcpu, "pcpu");
7540 DEFSYM (Qpmem, "pmem");
7541 DEFSYM (Qargs, "args");
7543 DEFVAR_BOOL ("delete-exited-processes", delete_exited_processes,
7544 doc: /* Non-nil means delete processes immediately when they exit.
7545 A value of nil means don't delete them until `list-processes' is run. */);
7547 delete_exited_processes = 1;
7549 #ifdef subprocesses
7550 DEFVAR_LISP ("process-connection-type", Vprocess_connection_type,
7551 doc: /* Control type of device used to communicate with subprocesses.
7552 Values are nil to use a pipe, or t or `pty' to use a pty.
7553 The value has no effect if the system has no ptys or if all ptys are busy:
7554 then a pipe is used in any case.
7555 The value takes effect when `start-process' is called. */);
7556 Vprocess_connection_type = Qt;
7558 #ifdef ADAPTIVE_READ_BUFFERING
7559 DEFVAR_LISP ("process-adaptive-read-buffering", Vprocess_adaptive_read_buffering,
7560 doc: /* If non-nil, improve receive buffering by delaying after short reads.
7561 On some systems, when Emacs reads the output from a subprocess, the output data
7562 is read in very small blocks, potentially resulting in very poor performance.
7563 This behavior can be remedied to some extent by setting this variable to a
7564 non-nil value, as it will automatically delay reading from such processes, to
7565 allow them to produce more output before Emacs tries to read it.
7566 If the value is t, the delay is reset after each write to the process; any other
7567 non-nil value means that the delay is not reset on write.
7568 The variable takes effect when `start-process' is called. */);
7569 Vprocess_adaptive_read_buffering = Qt;
7570 #endif
7572 defsubr (&Sprocessp);
7573 defsubr (&Sget_process);
7574 defsubr (&Sdelete_process);
7575 defsubr (&Sprocess_status);
7576 defsubr (&Sprocess_exit_status);
7577 defsubr (&Sprocess_id);
7578 defsubr (&Sprocess_name);
7579 defsubr (&Sprocess_tty_name);
7580 defsubr (&Sprocess_command);
7581 defsubr (&Sset_process_buffer);
7582 defsubr (&Sprocess_buffer);
7583 defsubr (&Sprocess_mark);
7584 defsubr (&Sset_process_filter);
7585 defsubr (&Sprocess_filter);
7586 defsubr (&Sset_process_sentinel);
7587 defsubr (&Sprocess_sentinel);
7588 defsubr (&Sset_process_window_size);
7589 defsubr (&Sset_process_inherit_coding_system_flag);
7590 defsubr (&Sset_process_query_on_exit_flag);
7591 defsubr (&Sprocess_query_on_exit_flag);
7592 defsubr (&Sprocess_contact);
7593 defsubr (&Sprocess_plist);
7594 defsubr (&Sset_process_plist);
7595 defsubr (&Sprocess_list);
7596 defsubr (&Sstart_process);
7597 defsubr (&Sserial_process_configure);
7598 defsubr (&Smake_serial_process);
7599 defsubr (&Sset_network_process_option);
7600 defsubr (&Smake_network_process);
7601 defsubr (&Sformat_network_address);
7602 #if defined (HAVE_NET_IF_H)
7603 #ifdef SIOCGIFCONF
7604 defsubr (&Snetwork_interface_list);
7605 #endif
7606 #if defined (SIOCGIFADDR) || defined (SIOCGIFHWADDR) || defined (SIOCGIFFLAGS)
7607 defsubr (&Snetwork_interface_info);
7608 #endif
7609 #endif /* defined (HAVE_NET_IF_H) */
7610 #ifdef DATAGRAM_SOCKETS
7611 defsubr (&Sprocess_datagram_address);
7612 defsubr (&Sset_process_datagram_address);
7613 #endif
7614 defsubr (&Saccept_process_output);
7615 defsubr (&Sprocess_send_region);
7616 defsubr (&Sprocess_send_string);
7617 defsubr (&Sinterrupt_process);
7618 defsubr (&Skill_process);
7619 defsubr (&Squit_process);
7620 defsubr (&Sstop_process);
7621 defsubr (&Scontinue_process);
7622 defsubr (&Sprocess_running_child_p);
7623 defsubr (&Sprocess_send_eof);
7624 defsubr (&Ssignal_process);
7625 defsubr (&Swaiting_for_user_input_p);
7626 defsubr (&Sprocess_type);
7627 defsubr (&Sset_process_coding_system);
7628 defsubr (&Sprocess_coding_system);
7629 defsubr (&Sset_process_filter_multibyte);
7630 defsubr (&Sprocess_filter_multibyte_p);
7632 #endif /* subprocesses */
7634 defsubr (&Sget_buffer_process);
7635 defsubr (&Sprocess_inherit_coding_system_flag);
7636 defsubr (&Slist_system_processes);
7637 defsubr (&Sprocess_attributes);