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