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