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