Assume POSIX 1003.1-1988 or later for signal.h.
[bpt/emacs.git] / src / callproc.c
CommitLineData
80856e74 1/* Synchronous subprocess invocation for GNU Emacs.
acaf905b 2 Copyright (C) 1985-1988, 1993-1995, 1999-2012
19ed11ba 3 Free Software Foundation, Inc.
80856e74
JB
4
5This file is part of GNU Emacs.
6
9ec0b715 7GNU Emacs is free software: you can redistribute it and/or modify
80856e74 8it under the terms of the GNU General Public License as published by
9ec0b715
GM
9the Free Software Foundation, either version 3 of the License, or
10(at your option) any later version.
80856e74
JB
11
12GNU Emacs is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
9ec0b715 18along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
80856e74
JB
19
20
68c45bf0 21#include <config.h>
e576cab4 22#include <errno.h>
565620a5 23#include <stdio.h>
80856e74 24#include <sys/types.h>
3cbd6585 25#include <unistd.h>
3cbd6585 26
80856e74 27#include <sys/file.h>
80856e74 28#include <fcntl.h>
80856e74 29
0898ca10
JB
30#include "lisp.h"
31
bad95d8f
RS
32#ifdef WINDOWSNT
33#define NOMINMAX
34#include <windows.h>
489f9371 35#include "w32.h"
bad95d8f
RS
36#define _P_NOWAIT 1 /* from process.h */
37#endif
38
7e6c2178 39#ifdef MSDOS /* Demacs 1.1.1 91/10/16 HIRANO Satoshi */
7e6c2178
RS
40#include <sys/stat.h>
41#include <sys/param.h>
7e6c2178
RS
42#endif /* MSDOS */
43
80856e74 44#include "commands.h"
91183bfd 45#include "character.h"
e5560ff7 46#include "buffer.h"
edf496dd 47#include "ccl.h"
32d08644 48#include "coding.h"
f0b950cf 49#include "composite.h"
57bda87a 50#include <epaths.h>
80856e74 51#include "process.h"
d177f194 52#include "syssignal.h"
a129418f 53#include "systty.h"
afea8a8a 54#include "syswait.h"
aba637ec 55#include "blockinput.h"
f105f403
KL
56#include "frame.h"
57#include "termhooks.h"
80856e74 58
5f027cea
EZ
59#ifdef MSDOS
60#include "msdos.h"
61#endif
62
d01ba2f1
GM
63#ifdef HAVE_NS
64#include "nsterm.h"
65#endif
66
f92d51d8
CY
67/* Pattern used by call-process-region to make temp files. */
68static Lisp_Object Vtemp_file_name_pattern;
69
bb5f74ee
PE
70/* The next two variables are valid only while record-unwind-protect
71 is in place during call-process for a synchronous subprocess. At
72 other times, their contents are irrelevant. Doing this via static
73 C variables is more convenient than putting them into the arguments
74 of record-unwind-protect, as they need to be updated at randomish
75 times in the code, and Lisp cannot always store these values as
76 Emacs integers. It's safe to use static variables here, as the
77 code is never invoked reentrantly. */
78
79/* If nonzero, a process-ID that has not been reaped. */
80static pid_t synch_process_pid;
81
82/* If nonnegative, a file descriptor that has not been closed. */
83static int synch_process_fd;
84\f
85/* Block SIGCHLD. */
80856e74 86
bb5f74ee
PE
87static void
88block_child_signal (void)
89{
bb5f74ee
PE
90 sigset_t blocked;
91 sigemptyset (&blocked);
92 sigaddset (&blocked, SIGCHLD);
93 pthread_sigmask (SIG_BLOCK, &blocked, 0);
bb5f74ee 94}
6b61353c 95
bb5f74ee 96/* Unblock SIGCHLD. */
f105f403 97
bb5f74ee
PE
98static void
99unblock_child_signal (void)
100{
bb5f74ee 101 pthread_sigmask (SIG_SETMASK, &empty_mask, 0);
bb5f74ee 102}
37d54121 103
35fb8050
PE
104/* If P is reapable, record it as a deleted process and kill it.
105 Do this in a critical section. Unless PID is wedged it will be
106 reaped on receipt of the first SIGCHLD after the critical section. */
107
108void
109record_kill_process (struct Lisp_Process *p)
110{
111 block_child_signal ();
112
113 if (p->alive)
114 {
115 p->alive = 0;
116 record_deleted_pid (p->pid);
d983a10b 117 kill (- p->pid, SIGKILL);
35fb8050
PE
118 }
119
120 unblock_child_signal ();
121}
122
bb5f74ee 123/* Clean up when exiting call_process_cleanup. */
37d54121 124
d177f194 125static Lisp_Object
bb5f74ee 126call_process_kill (Lisp_Object ignored)
d177f194 127{
bb5f74ee
PE
128 if (0 <= synch_process_fd)
129 emacs_close (synch_process_fd);
130
bb5f74ee
PE
131 if (synch_process_pid)
132 {
35fb8050
PE
133 struct Lisp_Process proc;
134 proc.alive = 1;
135 proc.pid = synch_process_pid;
136 record_kill_process (&proc);
bb5f74ee
PE
137 }
138
d177f194
JB
139 return Qnil;
140}
141
bb5f74ee
PE
142/* Clean up when exiting Fcall_process.
143 On MSDOS, delete the temporary file on any kind of termination.
144 On Unix, kill the process and any children on termination by signal. */
145
7710357c 146static Lisp_Object
971de7fb 147call_process_cleanup (Lisp_Object arg)
80856e74 148{
bb5f74ee
PE
149#ifdef MSDOS
150 Lisp_Object buffer = Fcar (arg);
151 Lisp_Object file = Fcdr (arg);
ad3aaf33 152#else
bb5f74ee 153 Lisp_Object buffer = arg;
ad3aaf33
AS
154#endif
155
bb5f74ee 156 Fset_buffer (buffer);
d177f194 157
bb5f74ee
PE
158#ifndef MSDOS
159 /* If the process still exists, kill its process group. */
160 if (synch_process_pid)
d177f194 161 {
d311d28c 162 ptrdiff_t count = SPECPDL_INDEX ();
d983a10b 163 kill (-synch_process_pid, SIGINT);
bb5f74ee 164 record_unwind_protect (call_process_kill, make_number (0));
d177f194
JB
165 message1 ("Waiting for process to die...(type C-g again to kill it instantly)");
166 immediate_quit = 1;
167 QUIT;
bb5f74ee
PE
168 wait_for_termination (synch_process_pid, 0, 1);
169 synch_process_pid = 0;
d177f194
JB
170 immediate_quit = 0;
171 specpdl_ptr = specpdl + count; /* Discard the unwind protect. */
172 message1 ("Waiting for process to die...done");
173 }
bb5f74ee
PE
174#endif
175
176 if (0 <= synch_process_fd)
177 emacs_close (synch_process_fd);
178
179#ifdef MSDOS
180 /* FILE is "" when we didn't actually create a temporary file in
181 call-process. */
182 if (!(strcmp (SDATA (file), NULL_DEVICE) == 0 || SREF (file, 0) == '\0'))
183 unlink (SDATA (file));
184#endif
185
80856e74
JB
186 return Qnil;
187}
188
a7ca3326 189DEFUN ("call-process", Fcall_process, Scall_process, 1, MANY, 0,
fdb82f93
PJ
190 doc: /* Call PROGRAM synchronously in separate process.
191The remaining arguments are optional.
192The program's input comes from file INFILE (nil means `/dev/null').
1ef14cb4
LMI
193Insert output in BUFFER before point; t means current buffer; nil for BUFFER
194 means discard it; 0 means discard and don't wait; and `(:file FILE)', where
1b9f60cc
GM
195 FILE is a file name string, means that it should be written to that file
196 \(if the file already exists it is overwritten).
fdb82f93
PJ
197BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
198REAL-BUFFER says what to do with standard output, as above,
199while STDERR-FILE says what to do with standard error in the child.
200STDERR-FILE may be nil (discard standard error output),
201t (mix it with ordinary output), or a file name string.
202
203Fourth arg DISPLAY non-nil means redisplay buffer as output is inserted.
204Remaining arguments are strings passed as command arguments to PROGRAM.
205
a4feb144
RS
206If executable PROGRAM can't be found as an executable, `call-process'
207signals a Lisp error. `call-process' reports errors in execution of
208the program only through its return and output.
209
fdb82f93
PJ
210If BUFFER is 0, `call-process' returns immediately with value nil.
211Otherwise it waits for PROGRAM to terminate
212and returns a numeric exit status or a signal description string.
d98b59b5
MB
213If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.
214
215usage: (call-process PROGRAM &optional INFILE BUFFER DISPLAY &rest ARGS) */)
f66c7cf8 216 (ptrdiff_t nargs, Lisp_Object *args)
80856e74 217{
bb5f74ee 218 Lisp_Object infile, buffer, current_dir, path;
2f221583 219 bool display_p;
60aeceb8 220 int fd0, fd1, filefd;
bb5f74ee 221 int status;
d311d28c
PE
222 ptrdiff_t count = SPECPDL_INDEX ();
223 USE_SAFE_ALLOCA;
2d607244 224
60aeceb8 225 char **new_argv;
39eaa782
RS
226 /* File to use for stderr in the child.
227 t means use same as standard output. */
228 Lisp_Object error_file;
1ef14cb4 229 Lisp_Object output_file = Qnil;
7e6c2178 230#ifdef MSDOS /* Demacs 1.1.1 91/10/16 HIRANO Satoshi */
888c9e86 231 char *outf, *tempfile = NULL;
7e6c2178 232 int outfilefd;
d311d28c
PE
233 int pid;
234#else
235 pid_t pid;
80856e74 236#endif
bb5f74ee 237 int child_errno;
1ef14cb4 238 int fd_output = -1;
32d08644
KH
239 struct coding_system process_coding; /* coding-system of process output */
240 struct coding_system argument_coding; /* coding-system of arguments */
09494912
RS
241 /* Set to the return value of Ffind_operation_coding_system. */
242 Lisp_Object coding_systems;
2f221583 243 bool output_to_buffer = 1;
09494912
RS
244
245 /* Qt denotes that Ffind_operation_coding_system is not yet called. */
246 coding_systems = Qt;
32d08644 247
b7826503 248 CHECK_STRING (args[0]);
80856e74 249
39eaa782
RS
250 error_file = Qt;
251
7e6c2178
RS
252#ifndef subprocesses
253 /* Without asynchronous processes we cannot have BUFFER == 0. */
177c0ea7 254 if (nargs >= 3
09ffb8b5 255 && (INTEGERP (CONSP (args[2]) ? XCAR (args[2]) : args[2])))
7e6c2178
RS
256 error ("Operating system cannot handle asynchronous subprocesses");
257#endif /* subprocesses */
258
09494912 259 /* Decide the coding-system for giving arguments. */
32d08644
KH
260 {
261 Lisp_Object val, *args2;
f66c7cf8 262 ptrdiff_t i;
32d08644
KH
263
264 /* If arguments are supplied, we may have to encode them. */
265 if (nargs >= 5)
266 {
2f221583 267 bool must_encode = 0;
6e50da0a 268 Lisp_Object coding_attrs;
30d57b8e 269
e7c1c20e 270 for (i = 4; i < nargs; i++)
b7826503 271 CHECK_STRING (args[i]);
e7c1c20e 272
a2286b5c 273 for (i = 4; i < nargs; i++)
30d57b8e
RS
274 if (STRING_MULTIBYTE (args[i]))
275 must_encode = 1;
276
beacaab3
KH
277 if (!NILP (Vcoding_system_for_write))
278 val = Vcoding_system_for_write;
30d57b8e 279 else if (! must_encode)
fcaf8878 280 val = Qraw_text;
beacaab3 281 else
32d08644 282 {
0065d054 283 SAFE_NALLOCA (args2, 1, nargs + 1);
32d08644
KH
284 args2[0] = Qcall_process;
285 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
08ee4e87 286 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
fcaf8878 287 val = CONSP (coding_systems) ? XCDR (coding_systems) : Qnil;
32d08644 288 }
fcaf8878 289 val = complement_process_encoding_system (val);
32d08644 290 setup_coding_system (Fcheck_coding_system (val), &argument_coding);
6e50da0a
KH
291 coding_attrs = CODING_ID_ATTRS (argument_coding.id);
292 if (NILP (CODING_ATTR_ASCII_COMPAT (coding_attrs)))
293 {
294 /* We should not use an ASCII incompatible coding system. */
295 val = raw_text_coding_system (val);
296 setup_coding_system (val, &argument_coding);
297 }
32d08644 298 }
32d08644
KH
299 }
300
e576cab4
JB
301 if (nargs >= 2 && ! NILP (args[1]))
302 {
4b4deea2 303 infile = Fexpand_file_name (args[1], BVAR (current_buffer, directory));
b7826503 304 CHECK_STRING (infile);
e576cab4 305 }
80856e74 306 else
5437e9f9 307 infile = build_string (NULL_DEVICE);
80856e74 308
e576cab4
JB
309 if (nargs >= 3)
310 {
39eaa782
RS
311 buffer = args[2];
312
1ef14cb4
LMI
313 /* If BUFFER is a list, its meaning is (BUFFER-FOR-STDOUT
314 FILE-FOR-STDERR), unless the first element is :file, in which case see
315 the next paragraph. */
19ed11ba
AS
316 if (CONSP (buffer)
317 && (! SYMBOLP (XCAR (buffer))
318 || strcmp (SSDATA (SYMBOL_NAME (XCAR (buffer))), ":file")))
39eaa782 319 {
70949dac 320 if (CONSP (XCDR (buffer)))
45be8a1e 321 {
a9d4f28a 322 Lisp_Object stderr_file;
70949dac 323 stderr_file = XCAR (XCDR (buffer));
45be8a1e
RS
324
325 if (NILP (stderr_file) || EQ (Qt, stderr_file))
326 error_file = stderr_file;
327 else
328 error_file = Fexpand_file_name (stderr_file, Qnil);
329 }
330
70949dac 331 buffer = XCAR (buffer);
39eaa782 332 }
044512ed 333
1ef14cb4 334 /* If the buffer is (still) a list, it might be a (:file "file") spec. */
19ed11ba
AS
335 if (CONSP (buffer)
336 && SYMBOLP (XCAR (buffer))
337 && ! strcmp (SSDATA (SYMBOL_NAME (XCAR (buffer))), ":file"))
1ef14cb4
LMI
338 {
339 output_file = Fexpand_file_name (XCAR (XCDR (buffer)),
340 BVAR (current_buffer, directory));
341 CHECK_STRING (output_file);
342 buffer = Qnil;
343 }
344
39eaa782
RS
345 if (!(EQ (buffer, Qnil)
346 || EQ (buffer, Qt)
3ffde7d6 347 || INTEGERP (buffer)))
e576cab4 348 {
39eaa782
RS
349 Lisp_Object spec_buffer;
350 spec_buffer = buffer;
50fe359b 351 buffer = Fget_buffer_create (buffer);
39eaa782
RS
352 /* Mention the buffer name for a better error message. */
353 if (NILP (buffer))
b7826503
PJ
354 CHECK_BUFFER (spec_buffer);
355 CHECK_BUFFER (buffer);
e576cab4
JB
356 }
357 }
177c0ea7 358 else
e576cab4 359 buffer = Qnil;
80856e74 360
58616e67
JB
361 /* Make sure that the child will be able to chdir to the current
362 buffer's current directory, or its unhandled equivalent. We
363 can't just have the child check for an error when it does the
364 chdir, since it's in a vfork.
365
366 We have to GCPRO around this because Fexpand_file_name,
367 Funhandled_file_name_directory, and Ffile_accessible_directory_p
368 might call a file name handling function. The argument list is
369 protected by the caller, so all we really have to worry about is
370 buffer. */
371 {
1ef14cb4 372 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
58616e67 373
4b4deea2 374 current_dir = BVAR (current_buffer, directory);
58616e67 375
1ef14cb4 376 GCPRO5 (infile, buffer, current_dir, error_file, output_file);
58616e67 377
ca319910
SM
378 current_dir = Funhandled_file_name_directory (current_dir);
379 if (NILP (current_dir))
380 /* If the file name handler says that current_dir is unreachable, use
381 a sensible default. */
382 current_dir = build_string ("~/");
383 current_dir = expand_and_dir_to_file (current_dir, Qnil);
db8454b0
CY
384 current_dir = Ffile_name_as_directory (current_dir);
385
58616e67
JB
386 if (NILP (Ffile_accessible_directory_p (current_dir)))
387 report_file_error ("Setting current directory",
4b4deea2 388 Fcons (BVAR (current_buffer, directory), Qnil));
58616e67 389
34b87689
KH
390 if (STRING_MULTIBYTE (infile))
391 infile = ENCODE_FILE (infile);
392 if (STRING_MULTIBYTE (current_dir))
393 current_dir = ENCODE_FILE (current_dir);
394 if (STRINGP (error_file) && STRING_MULTIBYTE (error_file))
395 error_file = ENCODE_FILE (error_file);
1ef14cb4
LMI
396 if (STRINGP (output_file) && STRING_MULTIBYTE (output_file))
397 output_file = ENCODE_FILE (output_file);
58616e67
JB
398 UNGCPRO;
399 }
400
d311d28c 401 display_p = INTERACTIVE && nargs >= 4 && !NILP (args[3]);
80856e74 402
42a5b22f 403 filefd = emacs_open (SSDATA (infile), O_RDONLY, 0);
80856e74
JB
404 if (filefd < 0)
405 {
34b87689 406 infile = DECODE_FILE (infile);
e576cab4 407 report_file_error ("Opening process input file", Fcons (infile, Qnil));
80856e74 408 }
1ef14cb4
LMI
409
410 if (STRINGP (output_file))
411 {
412#ifdef DOS_NT
413 fd_output = emacs_open (SSDATA (output_file),
414 O_WRONLY | O_TRUNC | O_CREAT | O_TEXT,
415 S_IREAD | S_IWRITE);
416#else /* not DOS_NT */
417 fd_output = creat (SSDATA (output_file), 0666);
418#endif /* not DOS_NT */
419 if (fd_output < 0)
420 {
421 output_file = DECODE_FILE (output_file);
422 report_file_error ("Opening process output file",
423 Fcons (output_file, Qnil));
19ed11ba 424 }
1ef14cb4 425 if (STRINGP (error_file) || NILP (error_file))
19ed11ba 426 output_to_buffer = 0;
1ef14cb4
LMI
427 }
428
80856e74 429 /* Search for program; barf if not found. */
c52b0b34 430 {
ad3aaf33 431 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
c52b0b34 432
ad3aaf33 433 GCPRO4 (infile, buffer, current_dir, error_file);
5c150961 434 openp (Vexec_path, args[0], Vexec_suffixes, &path, make_number (X_OK));
c52b0b34
KH
435 UNGCPRO;
436 }
012c6fcb 437 if (NILP (path))
80856e74 438 {
68c45bf0 439 emacs_close (filefd);
80856e74
JB
440 report_file_error ("Searching for program", Fcons (args[0], Qnil));
441 }
8ee8f447
RS
442
443 /* If program file name starts with /: for quoting a magic name,
444 discard that. */
445 if (SBYTES (path) > 2 && SREF (path, 0) == '/'
446 && SREF (path, 1) == ':')
447 path = Fsubstring (path, make_number (2), Qnil);
448
98c6f1e3 449 new_argv = SAFE_ALLOCA ((nargs > 4 ? nargs - 2 : 2) * sizeof *new_argv);
c364e618
KH
450 if (nargs > 4)
451 {
f66c7cf8 452 ptrdiff_t i;
ad3aaf33 453 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
c364e618 454
ad3aaf33 455 GCPRO5 (infile, buffer, current_dir, path, error_file);
c5bfa12b
KH
456 argument_coding.dst_multibyte = 0;
457 for (i = 4; i < nargs; i++)
c364e618 458 {
c5bfa12b
KH
459 argument_coding.src_multibyte = STRING_MULTIBYTE (args[i]);
460 if (CODING_REQUIRE_ENCODING (&argument_coding))
91183bfd
KH
461 /* We must encode this argument. */
462 args[i] = encode_coding_string (&argument_coding, args[i], 1);
c364e618 463 }
c5bfa12b 464 UNGCPRO;
1aa83b22 465 for (i = 4; i < nargs; i++)
60aeceb8 466 new_argv[i - 3] = SSDATA (args[i]);
1aa83b22 467 new_argv[i - 3] = 0;
c364e618 468 }
db54baaa
KH
469 else
470 new_argv[1] = 0;
60aeceb8 471 new_argv[0] = SSDATA (path);
80856e74 472
7e6c2178 473#ifdef MSDOS /* MW, July 1993 */
7e6c2178 474
888c9e86
EZ
475 /* If we're redirecting STDOUT to a file, that file is already open
476 on fd_output. */
1ef14cb4 477 if (fd_output < 0)
7e6c2178 478 {
888c9e86
EZ
479 if ((outf = egetenv ("TMPDIR")))
480 strcpy (tempfile = alloca (strlen (outf) + 20), outf);
481 else
482 {
483 tempfile = alloca (20);
484 *tempfile = '\0';
485 }
486 dostounix_filename (tempfile);
487 if (*tempfile == '\0' || tempfile[strlen (tempfile) - 1] != '/')
488 strcat (tempfile, "/");
489 strcat (tempfile, "detmp.XXX");
490 mktemp (tempfile);
1ef14cb4
LMI
491 outfilefd = creat (tempfile, S_IREAD | S_IWRITE);
492 if (outfilefd < 0) {
493 emacs_close (filefd);
494 report_file_error ("Opening process output file",
495 Fcons (build_string (tempfile), Qnil));
496 }
7e6c2178 497 }
1ef14cb4
LMI
498 else
499 outfilefd = fd_output;
60aeceb8
PE
500 fd0 = filefd;
501 fd1 = outfilefd;
6f89d28a 502#endif /* MSDOS */
7e6c2178 503
d50d3dc8 504 if (INTEGERP (buffer))
60aeceb8
PE
505 {
506 fd0 = -1;
507 fd1 = emacs_open (NULL_DEVICE, O_WRONLY, 0);
508 }
80856e74
JB
509 else
510 {
7e6c2178 511#ifndef MSDOS
60aeceb8 512 int fd[2];
db92b288
GM
513 if (pipe (fd) == -1)
514 {
60aeceb8 515 int pipe_errno = errno;
db92b288 516 emacs_close (filefd);
60aeceb8 517 errno = pipe_errno;
db92b288
GM
518 report_file_error ("Creating process pipe", Qnil);
519 }
60aeceb8
PE
520 fd0 = fd[0];
521 fd1 = fd[1];
80856e74
JB
522#endif
523 }
524
525 {
39eaa782 526 int fd_error = fd1;
80856e74 527
1ef14cb4
LMI
528 if (fd_output >= 0)
529 fd1 = fd_output;
80856e74 530
39eaa782 531 if (NILP (error_file))
68c45bf0 532 fd_error = emacs_open (NULL_DEVICE, O_WRONLY, 0);
39eaa782
RS
533 else if (STRINGP (error_file))
534 {
535#ifdef DOS_NT
42a5b22f 536 fd_error = emacs_open (SSDATA (error_file),
68c45bf0
PE
537 O_WRONLY | O_TRUNC | O_CREAT | O_TEXT,
538 S_IREAD | S_IWRITE);
39eaa782 539#else /* not DOS_NT */
42a5b22f 540 fd_error = creat (SSDATA (error_file), 0666);
39eaa782
RS
541#endif /* not DOS_NT */
542 }
543
544 if (fd_error < 0)
545 {
68c45bf0 546 emacs_close (filefd);
60aeceb8
PE
547 if (fd0 != filefd)
548 emacs_close (fd0);
39eaa782 549 if (fd1 >= 0)
68c45bf0 550 emacs_close (fd1);
6f89d28a
MB
551#ifdef MSDOS
552 unlink (tempfile);
553#endif
34b87689
KH
554 if (NILP (error_file))
555 error_file = build_string (NULL_DEVICE);
556 else if (STRINGP (error_file))
557 error_file = DECODE_FILE (error_file);
558 report_file_error ("Cannot redirect stderr", Fcons (error_file, Qnil));
39eaa782 559 }
89e1ec1d 560
2610078a 561#ifdef MSDOS /* MW, July 1993 */
c17c4250 562 /* Note that on MSDOS `child_setup' actually returns the child process
bb5f74ee 563 exit status, not its PID, so assign it to status below. */
60aeceb8 564 pid = child_setup (filefd, outfilefd, fd_error, new_argv, 0, current_dir);
bb5f74ee 565 child_errno = errno;
2610078a 566
68c45bf0 567 emacs_close (outfilefd);
2610078a 568 if (fd_error != outfilefd)
68c45bf0 569 emacs_close (fd_error);
bb5f74ee
PE
570 if (pid < 0)
571 {
572 synchronize_system_messages_locale ();
573 return
574 code_convert_string_norecord (build_string (strerror (child_errno)),
575 Vlocale_coding_system, 0);
576 }
577 status = pid;
2610078a 578 fd1 = -1; /* No harm in closing that one! */
888c9e86 579 if (tempfile)
2610078a 580 {
888c9e86
EZ
581 /* Since CRLF is converted to LF within `decode_coding', we
582 can always open a file with binary mode. */
60aeceb8
PE
583 fd0 = emacs_open (tempfile, O_RDONLY | O_BINARY, 0);
584 if (fd0 < 0)
888c9e86
EZ
585 {
586 unlink (tempfile);
587 emacs_close (filefd);
588 report_file_error ("Cannot re-open temporary file",
7285dc67 589 Fcons (build_string (tempfile), Qnil));
888c9e86 590 }
2610078a 591 }
888c9e86 592 else
60aeceb8 593 fd0 = -1; /* We are not going to read from tempfile. */
644d3f0d 594#endif /* MSDOS */
bb5f74ee
PE
595
596 /* Do the unwind-protect now, even though the pid is not known, so
597 that no storage allocation is done in the critical section.
598 The actual PID will be filled in during the critical section. */
599 synch_process_pid = 0;
600 synch_process_fd = fd0;
644d3f0d
PE
601
602#ifdef MSDOS
603 /* MSDOS needs different cleanup information. */
604 record_unwind_protect (call_process_cleanup,
605 Fcons (Fcurrent_buffer (),
606 build_string (tempfile ? tempfile : "")));
607#else
bb5f74ee
PE
608 record_unwind_protect (call_process_cleanup, Fcurrent_buffer ());
609
610 block_input ();
611 block_child_signal ();
612
bad95d8f 613#ifdef WINDOWSNT
60aeceb8 614 pid = child_setup (filefd, fd1, fd_error, new_argv, 0, current_dir);
bad95d8f 615#else /* not WINDOWSNT */
c0ad4ea5 616
db6c0e74 617 /* vfork, and prevent local vars from being clobbered by the vfork. */
b08a63cc 618 {
c74e9d86
PE
619 Lisp_Object volatile buffer_volatile = buffer;
620 Lisp_Object volatile coding_systems_volatile = coding_systems;
621 Lisp_Object volatile current_dir_volatile = current_dir;
2f221583
PE
622 bool volatile display_p_volatile = display_p;
623 bool volatile output_to_buffer_volatile = output_to_buffer;
624 bool volatile sa_must_free_volatile = sa_must_free;
5266b4bb 625 int volatile fd1_volatile = fd1;
db6c0e74
PE
626 int volatile fd_error_volatile = fd_error;
627 int volatile fd_output_volatile = fd_output;
60aeceb8
PE
628 int volatile filefd_volatile = filefd;
629 ptrdiff_t volatile count_volatile = count;
d311d28c 630 ptrdiff_t volatile sa_count_volatile = sa_count;
60aeceb8 631 char **volatile new_argv_volatile = new_argv;
80856e74 632
db6c0e74 633 pid = vfork ();
bb5f74ee 634 child_errno = errno;
80856e74 635
c74e9d86
PE
636 buffer = buffer_volatile;
637 coding_systems = coding_systems_volatile;
638 current_dir = current_dir_volatile;
d311d28c 639 display_p = display_p_volatile;
60aeceb8
PE
640 output_to_buffer = output_to_buffer_volatile;
641 sa_must_free = sa_must_free_volatile;
5266b4bb 642 fd1 = fd1_volatile;
db6c0e74
PE
643 fd_error = fd_error_volatile;
644 fd_output = fd_output_volatile;
60aeceb8
PE
645 filefd = filefd_volatile;
646 count = count_volatile;
d311d28c 647 sa_count = sa_count_volatile;
db6c0e74 648 new_argv = new_argv_volatile;
644d3f0d
PE
649
650 fd0 = synch_process_fd;
db6c0e74 651 }
b9c7f648 652
80856e74
JB
653 if (pid == 0)
654 {
bb5f74ee
PE
655 unblock_child_signal ();
656
60aeceb8
PE
657 if (fd0 >= 0)
658 emacs_close (fd0);
322aea6d 659
19ed11ba 660 setsid ();
c0ad4ea5 661
4d7e6e51 662 /* Emacs ignores SIGPIPE, but the child should not. */
2f9b9adb 663 signal (SIGPIPE, SIG_DFL);
c0ad4ea5 664
60aeceb8 665 child_setup (filefd, fd1, fd_error, new_argv, 0, current_dir);
80856e74 666 }
aba637ec 667
bad95d8f 668#endif /* not WINDOWSNT */
cd5f8f60 669
bb5f74ee
PE
670 child_errno = errno;
671
672 if (0 < pid)
673 {
674 if (INTEGERP (buffer))
675 record_deleted_pid (pid);
676 else
677 synch_process_pid = pid;
678 }
679
680 unblock_child_signal ();
681 unblock_input ();
682
cd5f8f60
RS
683 /* The MSDOS case did this already. */
684 if (fd_error >= 0)
68c45bf0 685 emacs_close (fd_error);
2610078a 686#endif /* not MSDOS */
80856e74 687
60aeceb8 688 /* Close most of our file descriptors, but not fd0
6b6e798b 689 since we will use that to read input from. */
68c45bf0 690 emacs_close (filefd);
1ef14cb4
LMI
691 if (fd_output >= 0)
692 emacs_close (fd_output);
799abb26 693 if (fd1 >= 0 && fd1 != fd_error)
68c45bf0 694 emacs_close (fd1);
80856e74
JB
695 }
696
697 if (pid < 0)
698 {
bb5f74ee 699 errno = child_errno;
80856e74
JB
700 report_file_error ("Doing vfork", Qnil);
701 }
702
d50d3dc8 703 if (INTEGERP (buffer))
644d3f0d 704 return unbind_to (count, Qnil);
80856e74 705
d50d3dc8 706 if (BUFFERP (buffer))
80856e74
JB
707 Fset_buffer (buffer);
708
09494912
RS
709 if (NILP (buffer))
710 {
711 /* If BUFFER is nil, we must read process output once and then
712 discard it, so setup coding system but with nil. */
713 setup_coding_system (Qnil, &process_coding);
659afede 714 process_coding.dst_multibyte = 0;
09494912
RS
715 }
716 else
717 {
718 Lisp_Object val, *args2;
719
720 val = Qnil;
721 if (!NILP (Vcoding_system_for_read))
722 val = Vcoding_system_for_read;
723 else
724 {
725 if (EQ (coding_systems, Qt))
726 {
f66c7cf8 727 ptrdiff_t i;
09494912 728
0065d054 729 SAFE_NALLOCA (args2, 1, nargs + 1);
09494912
RS
730 args2[0] = Qcall_process;
731 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
732 coding_systems
733 = Ffind_operation_coding_system (nargs + 1, args2);
734 }
735 if (CONSP (coding_systems))
70949dac 736 val = XCAR (coding_systems);
09494912 737 else if (CONSP (Vdefault_process_coding_system))
70949dac 738 val = XCAR (Vdefault_process_coding_system);
09494912
RS
739 else
740 val = Qnil;
741 }
91183bfd 742 Fcheck_coding_system (val);
09494912
RS
743 /* In unibyte mode, character code conversion should not take
744 place but EOL conversion should. So, setup raw-text or one
745 of the subsidiary according to the information just setup. */
4b4deea2 746 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
09494912 747 && !NILP (val))
91183bfd
KH
748 val = raw_text_coding_system (val);
749 setup_coding_system (val, &process_coding);
659afede
KH
750 process_coding.dst_multibyte
751 = ! NILP (BVAR (current_buffer, enable_multibyte_characters));
09494912 752 }
a0241d01 753 process_coding.src_multibyte = 0;
09494912 754
80856e74
JB
755 immediate_quit = 1;
756 QUIT;
757
1ef14cb4 758 if (output_to_buffer)
19ed11ba 759 {
60aeceb8
PE
760 enum { CALLPROC_BUFFER_SIZE_MIN = 16 * 1024 };
761 enum { CALLPROC_BUFFER_SIZE_MAX = 4 * CALLPROC_BUFFER_SIZE_MIN };
762 char buf[CALLPROC_BUFFER_SIZE_MAX];
763 int bufsize = CALLPROC_BUFFER_SIZE_MIN;
2f221583
PE
764 int nread;
765 bool first = 1;
19ed11ba
AS
766 EMACS_INT total_read = 0;
767 int carryover = 0;
2f221583 768 bool display_on_the_fly = display_p;
19ed11ba
AS
769 struct coding_system saved_coding;
770
771 saved_coding = process_coding;
772 while (1)
773 {
774 /* Repeatedly read until we've filled as much as possible
775 of the buffer size we have. But don't read
776 less than 1024--save that for the next bufferful. */
777 nread = carryover;
778 while (nread < bufsize - 1024)
779 {
60aeceb8 780 int this_read = emacs_read (fd0, buf + nread,
19ed11ba 781 bufsize - nread);
60558b19 782
19ed11ba
AS
783 if (this_read < 0)
784 goto give_up;
60558b19 785
19ed11ba
AS
786 if (this_read == 0)
787 {
788 process_coding.mode |= CODING_MODE_LAST_BLOCK;
789 break;
790 }
60558b19 791
19ed11ba
AS
792 nread += this_read;
793 total_read += this_read;
60558b19 794
19ed11ba
AS
795 if (display_on_the_fly)
796 break;
797 }
60558b19 798
19ed11ba
AS
799 /* Now NREAD is the total amount of data in the buffer. */
800 immediate_quit = 0;
177c0ea7 801
19ed11ba
AS
802 if (!NILP (buffer))
803 {
804 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
805 && ! CODING_MAY_REQUIRE_DECODING (&process_coding))
806 insert_1_both (buf, nread, nread, 0, 1, 0);
807 else
808 { /* We have to decode the input. */
809 Lisp_Object curbuf;
d311d28c 810 ptrdiff_t count1 = SPECPDL_INDEX ();
19ed11ba
AS
811
812 XSETBUFFER (curbuf, current_buffer);
813 /* We cannot allow after-change-functions be run
814 during decoding, because that might modify the
815 buffer, while we rely on process_coding.produced to
816 faithfully reflect inserted text until we
817 TEMP_SET_PT_BOTH below. */
818 specbind (Qinhibit_modification_hooks, Qt);
819 decode_coding_c_string (&process_coding,
820 (unsigned char *) buf, nread, curbuf);
821 unbind_to (count1, Qnil);
822 if (display_on_the_fly
823 && CODING_REQUIRE_DETECTION (&saved_coding)
824 && ! CODING_REQUIRE_DETECTION (&process_coding))
825 {
826 /* We have detected some coding system. But,
827 there's a possibility that the detection was
828 done by insufficient data. So, we give up
829 displaying on the fly. */
830 if (process_coding.produced > 0)
831 del_range_2 (process_coding.dst_pos,
832 process_coding.dst_pos_byte,
833 process_coding.dst_pos
834 + process_coding.produced_char,
835 process_coding.dst_pos_byte
836 + process_coding.produced, 0);
837 display_on_the_fly = 0;
838 process_coding = saved_coding;
839 carryover = nread;
840 /* This is to make the above condition always
841 fails in the future. */
842 saved_coding.common_flags
843 &= ~CODING_REQUIRE_DETECTION_MASK;
844 continue;
845 }
846
847 TEMP_SET_PT_BOTH (PT + process_coding.produced_char,
848 PT_BYTE + process_coding.produced);
849 carryover = process_coding.carryover_bytes;
850 if (carryover > 0)
851 memcpy (buf, process_coding.carryover,
852 process_coding.carryover_bytes);
853 }
854 }
c5bfa12b 855
19ed11ba
AS
856 if (process_coding.mode & CODING_MODE_LAST_BLOCK)
857 break;
6e3bfbb2 858
19ed11ba
AS
859 /* Make the buffer bigger as we continue to read more data,
860 but not past CALLPROC_BUFFER_SIZE_MAX. */
861 if (bufsize < CALLPROC_BUFFER_SIZE_MAX && total_read > 32 * bufsize)
862 if ((bufsize *= 2) > CALLPROC_BUFFER_SIZE_MAX)
863 bufsize = CALLPROC_BUFFER_SIZE_MAX;
6e3bfbb2 864
19ed11ba
AS
865 if (display_p)
866 {
867 if (first)
868 prepare_menu_bars ();
869 first = 0;
870 redisplay_preserve_echo_area (1);
871 /* This variable might have been set to 0 for code
872 detection. In that case, we set it back to 1 because
873 we should have already detected a coding system. */
874 display_on_the_fly = 1;
875 }
876 immediate_quit = 1;
877 QUIT;
878 }
879 give_up: ;
880
881 Vlast_coding_system_used = CODING_ID_NAME (process_coding.id);
882 /* If the caller required, let the buffer inherit the
883 coding-system used to decode the process output. */
884 if (inherit_process_coding_system)
885 call1 (intern ("after-insert-file-set-buffer-file-coding-system"),
886 make_number (total_read));
887 }
3b440bb5 888
77defa9a 889#ifndef MSDOS
80856e74 890 /* Wait for it to terminate, unless it already has. */
bb5f74ee 891 wait_for_termination (pid, &status, !output_to_buffer);
77defa9a 892#endif
80856e74
JB
893
894 immediate_quit = 0;
895
37d54121
RS
896 /* Don't kill any children that the subprocess may have left behind
897 when exiting. */
bb5f74ee 898 synch_process_pid = 0;
37d54121 899
3c59b4c9 900 SAFE_FREE ();
80856e74
JB
901 unbind_to (count, Qnil);
902
bb5f74ee 903 if (WIFSIGNALED (status))
6b61353c 904 {
42ca4633 905 const char *signame;
6b61353c
KH
906
907 synchronize_system_messages_locale ();
bb5f74ee 908 signame = strsignal (WTERMSIG (status));
6b61353c
KH
909
910 if (signame == 0)
19ed11ba 911 signame = "unknown";
6b61353c 912
bb5f74ee
PE
913 return code_convert_string_norecord (build_string (signame),
914 Vlocale_coding_system, 0);
6b61353c
KH
915 }
916
bb5f74ee
PE
917 eassert (WIFEXITED (status));
918 return make_number (WEXITSTATUS (status));
80856e74 919}
80856e74 920\f
9fefd2ba 921static Lisp_Object
971de7fb 922delete_temp_file (Lisp_Object name)
80856e74 923{
1a271e14 924 /* Suppress jka-compr handling, etc. */
d311d28c 925 ptrdiff_t count = SPECPDL_INDEX ();
1a271e14 926 specbind (intern ("file-name-handler-alist"), Qnil);
f1a5d776 927 internal_delete_file (name);
1a271e14 928 unbind_to (count, Qnil);
320695d8 929 return Qnil;
80856e74
JB
930}
931
932DEFUN ("call-process-region", Fcall_process_region, Scall_process_region,
fdb82f93
PJ
933 3, MANY, 0,
934 doc: /* Send text from START to END to a synchronous process running PROGRAM.
935The remaining arguments are optional.
936Delete the text if fourth arg DELETE is non-nil.
937
1ef14cb4
LMI
938Insert output in BUFFER before point; t means current buffer; nil for
939 BUFFER means discard it; 0 means discard and don't wait; and `(:file
940 FILE)', where FILE is a file name string, means that it should be
1b9f60cc 941 written to that file (if the file already exists it is overwritten).
fdb82f93
PJ
942BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
943REAL-BUFFER says what to do with standard output, as above,
944while STDERR-FILE says what to do with standard error in the child.
945STDERR-FILE may be nil (discard standard error output),
946t (mix it with ordinary output), or a file name string.
947
948Sixth arg DISPLAY non-nil means redisplay buffer as output is inserted.
949Remaining args are passed to PROGRAM at startup as command args.
950
ba9a5174 951If BUFFER is 0, `call-process-region' returns immediately with value nil.
fdb82f93
PJ
952Otherwise it waits for PROGRAM to terminate
953and returns a numeric exit status or a signal description string.
d98b59b5
MB
954If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.
955
956usage: (call-process-region START END PROGRAM &optional DELETE BUFFER DISPLAY &rest ARGS) */)
f66c7cf8 957 (ptrdiff_t nargs, Lisp_Object *args)
80856e74 958{
39323a7e
KH
959 struct gcpro gcpro1;
960 Lisp_Object filename_string;
961 register Lisp_Object start, end;
d311d28c 962 ptrdiff_t count = SPECPDL_INDEX ();
08ee4e87 963 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
09494912 964 Lisp_Object coding_systems;
32d08644 965 Lisp_Object val, *args2;
f66c7cf8 966 ptrdiff_t i;
98c6f1e3 967 Lisp_Object tmpdir;
7e6c2178 968
f92d51d8
CY
969 if (STRINGP (Vtemporary_file_directory))
970 tmpdir = Vtemporary_file_directory;
7e6c2178
RS
971 else
972 {
f92d51d8
CY
973#ifndef DOS_NT
974 if (getenv ("TMPDIR"))
975 tmpdir = build_string (getenv ("TMPDIR"));
976 else
977 tmpdir = build_string ("/tmp/");
978#else /* DOS_NT */
979 char *outf;
980 if ((outf = egetenv ("TMPDIR"))
981 || (outf = egetenv ("TMP"))
982 || (outf = egetenv ("TEMP")))
983 tmpdir = build_string (outf);
984 else
985 tmpdir = Ffile_name_as_directory (build_string ("c:/temp"));
0774fcf8 986#endif
f92d51d8 987 }
7e6c2178 988
3c59b4c9
PE
989 {
990 USE_SAFE_ALLOCA;
98c6f1e3 991 Lisp_Object pattern = Fexpand_file_name (Vtemp_file_name_pattern, tmpdir);
7c2fcf9b
EZ
992 Lisp_Object encoded_tem = ENCODE_FILE (pattern);
993 char *tempfile = SAFE_ALLOCA (SBYTES (encoded_tem) + 1);
994 memcpy (tempfile, SDATA (encoded_tem), SBYTES (encoded_tem) + 1);
3c59b4c9 995 coding_systems = Qt;
09494912 996
1ddc85a4 997#ifdef HAVE_MKSTEMP
3c59b4c9
PE
998 {
999 int fd;
1000
4d7e6e51 1001 block_input ();
3c59b4c9 1002 fd = mkstemp (tempfile);
4d7e6e51 1003 unblock_input ();
3c59b4c9
PE
1004 if (fd == -1)
1005 report_file_error ("Failed to open temporary file",
baac5bc7 1006 Fcons (build_string (tempfile), Qnil));
3c59b4c9
PE
1007 else
1008 close (fd);
1009 }
1ddc85a4 1010#else
d3cefd13 1011 errno = 0;
3c59b4c9 1012 mktemp (tempfile);
d3cefd13
EZ
1013 if (!*tempfile)
1014 {
1015 if (!errno)
1016 errno = EEXIST;
1017 report_file_error ("Failed to open temporary file using pattern",
1018 Fcons (pattern, Qnil));
1019 }
1ddc85a4 1020#endif
80856e74 1021
3c59b4c9
PE
1022 filename_string = build_string (tempfile);
1023 GCPRO1 (filename_string);
1024 SAFE_FREE ();
1025 }
1026
80856e74
JB
1027 start = args[0];
1028 end = args[1];
32d08644 1029 /* Decide coding-system of the contents of the temporary file. */
91489411
RS
1030 if (!NILP (Vcoding_system_for_write))
1031 val = Vcoding_system_for_write;
4b4deea2 1032 else if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
fcaf8878 1033 val = Qraw_text;
32d08644 1034 else
beacaab3 1035 {
3c59b4c9 1036 USE_SAFE_ALLOCA;
0065d054 1037 SAFE_NALLOCA (args2, 1, nargs + 1);
91489411
RS
1038 args2[0] = Qcall_process_region;
1039 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1040 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
fcaf8878 1041 val = CONSP (coding_systems) ? XCDR (coding_systems) : Qnil;
3c59b4c9 1042 SAFE_FREE ();
beacaab3 1043 }
fcaf8878 1044 val = complement_process_encoding_system (val);
32d08644 1045
168afdaa 1046 {
d311d28c 1047 ptrdiff_t count1 = SPECPDL_INDEX ();
168afdaa
RS
1048
1049 specbind (intern ("coding-system-for-write"), val);
bb951f0e
KR
1050 /* POSIX lets mk[s]temp use "."; don't invoke jka-compr if we
1051 happen to get a ".Z" suffix. */
1052 specbind (intern ("file-name-handler-alist"), Qnil);
168afdaa
RS
1053 Fwrite_region (start, end, filename_string, Qnil, Qlambda, Qnil, Qnil);
1054
1055 unbind_to (count1, Qnil);
1056 }
91489411 1057
177c0ea7 1058 /* Note that Fcall_process takes care of binding
91489411 1059 coding-system-for-read. */
093650fe 1060
80856e74
JB
1061 record_unwind_protect (delete_temp_file, filename_string);
1062
edf496dd 1063 if (nargs > 3 && !NILP (args[3]))
80856e74
JB
1064 Fdelete_region (start, end);
1065
edf496dd
KH
1066 if (nargs > 3)
1067 {
1068 args += 2;
1069 nargs -= 2;
1070 }
1071 else
1072 {
1073 args[0] = args[2];
1074 nargs = 2;
1075 }
1076 args[1] = filename_string;
80856e74 1077
edf496dd 1078 RETURN_UNGCPRO (unbind_to (count, Fcall_process (nargs, args)));
80856e74
JB
1079}
1080\f
361358ea 1081#ifndef WINDOWSNT
971de7fb 1082static int relocate_fd (int fd, int minfd);
361358ea 1083#endif
dfcf069d 1084
5990851d
KL
1085static char **
1086add_env (char **env, char **new_env, char *string)
1087{
1088 char **ep;
2f221583 1089 bool ok = 1;
5990851d
KL
1090 if (string == NULL)
1091 return new_env;
1092
1093 /* See if this string duplicates any string already in the env.
1094 If so, don't put it in.
1095 When an env var has multiple definitions,
1096 we keep the definition that comes first in process-environment. */
1097 for (ep = env; ok && ep != new_env; ep++)
1098 {
1099 char *p = *ep, *q = string;
1100 while (ok)
19ed11ba
AS
1101 {
1102 if (*q != *p)
1103 break;
1104 if (*q == 0)
1105 /* The string is a lone variable name; keep it for now, we
1106 will remove it later. It is a placeholder for a
1107 variable that is not to be included in the environment. */
1108 break;
1109 if (*q == '=')
1110 ok = 0;
1111 p++, q++;
1112 }
5990851d
KL
1113 }
1114 if (ok)
1115 *new_env++ = string;
1116 return new_env;
1117}
1118
80856e74
JB
1119/* This is the last thing run in a newly forked inferior
1120 either synchronous or asynchronous.
1121 Copy descriptors IN, OUT and ERR as descriptors 0, 1 and 2.
1122 Initialize inferior's priority, pgrp, connected dir and environment.
1123 then exec another program based on new_argv.
1124
2f221583 1125 If SET_PGRP, put the subprocess into a separate process group.
e576cab4
JB
1126
1127 CURRENT_DIR is an elisp string giving the path of the current
1128 directory the subprocess should have. Since we can't really signal
1129 a decent error from within the child, this should be verified as an
1130 executable directory by the parent. */
80856e74 1131
dfcf069d 1132int
2f221583
PE
1133child_setup (int in, int out, int err, char **new_argv, bool set_pgrp,
1134 Lisp_Object current_dir)
80856e74 1135{
e576cab4 1136 char **env;
7fcf7f05 1137 char *pwd_var;
bad95d8f
RS
1138#ifdef WINDOWSNT
1139 int cpid;
4252a4bd 1140 HANDLE handles[3];
bad95d8f 1141#endif /* WINDOWSNT */
e576cab4 1142
d311d28c 1143 pid_t pid = getpid ();
80856e74 1144
80856e74
JB
1145 /* Close Emacs's descriptors that this process should not have. */
1146 close_process_descs ();
ded80a25 1147
c17c4250
EZ
1148 /* DOS_NT isn't in a vfork, so if we are in the middle of load-file,
1149 we will lose if we call close_load_descs here. */
1150#ifndef DOS_NT
4458cebe 1151 close_load_descs ();
c17c4250 1152#endif
80856e74
JB
1153
1154 /* Note that use of alloca is always safe here. It's obvious for systems
1155 that do not have true vfork or that have true (stack) alloca.
caa01fe0
GM
1156 If using vfork and C_ALLOCA (when Emacs used to include
1157 src/alloca.c) it is safe because that changes the superior's
1158 static variables as if the superior had done alloca and will be
1159 cleaned up in the usual way. */
e576cab4 1160 {
7fcf7f05 1161 register char *temp;
0065d054 1162 size_t i; /* size_t, because ptrdiff_t might overflow here! */
77d78be1 1163
d5db4077 1164 i = SBYTES (current_dir);
16425c4a
EZ
1165#ifdef MSDOS
1166 /* MSDOS must have all environment variables malloc'ed, because
1167 low-level libc functions that launch subsidiary processes rely
1168 on that. */
23f86fce 1169 pwd_var = xmalloc (i + 6);
16425c4a 1170#else
38182d90 1171 pwd_var = alloca (i + 6);
16425c4a 1172#endif
7fcf7f05 1173 temp = pwd_var + 4;
72af86bd
AS
1174 memcpy (pwd_var, "PWD=", 4);
1175 memcpy (temp, SDATA (current_dir), i);
bad95d8f 1176 if (!IS_DIRECTORY_SEP (temp[i - 1])) temp[i++] = DIRECTORY_SEP;
e576cab4
JB
1177 temp[i] = 0;
1178
c17c4250 1179#ifndef DOS_NT
e576cab4
JB
1180 /* We can't signal an Elisp error here; we're in a vfork. Since
1181 the callers check the current directory before forking, this
1182 should only return an error if the directory's permissions
1183 are changed between the check and this chdir, but we should
1184 at least check. */
1185 if (chdir (temp) < 0)
20b25e46 1186 _exit (errno);
f8d23104 1187#else /* DOS_NT */
c17c4250
EZ
1188 /* Get past the drive letter, so that d:/ is left alone. */
1189 if (i > 2 && IS_DEVICE_SEP (temp[1]) && IS_DIRECTORY_SEP (temp[2]))
1190 {
1191 temp += 2;
1192 i -= 2;
1193 }
f8d23104 1194#endif /* DOS_NT */
c17c4250 1195
7fcf7f05 1196 /* Strip trailing slashes for PWD, but leave "/" and "//" alone. */
bad95d8f 1197 while (i > 2 && IS_DIRECTORY_SEP (temp[i - 1]))
7fcf7f05 1198 temp[--i] = 0;
e576cab4 1199 }
80856e74 1200
5990851d 1201 /* Set `env' to a vector of the strings in the environment. */
80856e74
JB
1202 {
1203 register Lisp_Object tem;
1204 register char **new_env;
5990851d 1205 char **p, **q;
80856e74 1206 register int new_length;
d2bb6598 1207 Lisp_Object display = Qnil;
361358ea 1208
80856e74 1209 new_length = 0;
f105f403 1210
80856e74 1211 for (tem = Vprocess_environment;
19ed11ba
AS
1212 CONSP (tem) && STRINGP (XCAR (tem));
1213 tem = XCDR (tem))
d2bb6598 1214 {
42a5b22f 1215 if (strncmp (SSDATA (XCAR (tem)), "DISPLAY", 7) == 0
d2bb6598
SM
1216 && (SDATA (XCAR (tem)) [7] == '\0'
1217 || SDATA (XCAR (tem)) [7] == '='))
1218 /* DISPLAY is specified in process-environment. */
1219 display = Qt;
1220 new_length++;
1221 }
de87fb59 1222
d2bb6598
SM
1223 /* If not provided yet, use the frame's DISPLAY. */
1224 if (NILP (display))
1225 {
1226 Lisp_Object tmp = Fframe_parameter (selected_frame, Qdisplay);
1227 if (!STRINGP (tmp) && CONSP (Vinitial_environment))
1228 /* If still not found, Look for DISPLAY in Vinitial_environment. */
1229 tmp = Fgetenv_internal (build_string ("DISPLAY"),
1230 Vinitial_environment);
1231 if (STRINGP (tmp))
1232 {
1233 display = tmp;
1234 new_length++;
1235 }
1236 }
80856e74 1237
7fcf7f05 1238 /* new_length + 2 to include PWD and terminating 0. */
38182d90 1239 env = new_env = alloca ((new_length + 2) * sizeof *env);
7fcf7f05
RS
1240 /* If we have a PWD envvar, pass one down,
1241 but with corrected value. */
a13f8f50 1242 if (egetenv ("PWD"))
7fcf7f05 1243 *new_env++ = pwd_var;
361358ea 1244
6b8e474c 1245 if (STRINGP (display))
de87fb59 1246 {
38182d90 1247 char *vdata = alloca (sizeof "DISPLAY=" + SBYTES (display));
de87fb59 1248 strcpy (vdata, "DISPLAY=");
42a5b22f 1249 strcat (vdata, SSDATA (display));
de87fb59
DN
1250 new_env = add_env (env, new_env, vdata);
1251 }
80856e74 1252
5990851d 1253 /* Overrides. */
80856e74 1254 for (tem = Vprocess_environment;
70949dac
KR
1255 CONSP (tem) && STRINGP (XCAR (tem));
1256 tem = XCDR (tem))
42a5b22f 1257 new_env = add_env (env, new_env, SSDATA (XCAR (tem)));
d2bb6598 1258
5990851d
KL
1259 *new_env = 0;
1260
1261 /* Remove variable names without values. */
1262 p = q = env;
1263 while (*p != 0)
cd9565ba 1264 {
19ed11ba
AS
1265 while (*q != 0 && strchr (*q, '=') == NULL)
1266 q++;
1267 *p = *q++;
1268 if (*p != 0)
1269 p++;
cd9565ba 1270 }
80856e74 1271 }
de87fb59 1272
361358ea 1273
bad95d8f
RS
1274#ifdef WINDOWSNT
1275 prepare_standard_handles (in, out, err, handles);
d5db4077 1276 set_process_dir (SDATA (current_dir));
67802943
DN
1277 /* Spawn the child. (See ntproc.c:Spawnve). */
1278 cpid = spawnve (_P_NOWAIT, new_argv[0], new_argv, env);
1279 reset_standard_handles (in, out, err, handles);
1280 if (cpid == -1)
1281 /* An error occurred while trying to spawn the process. */
1282 report_file_error ("Spawning child process", Qnil);
1283 return cpid;
1284
bad95d8f 1285#else /* not WINDOWSNT */
426b37ae
JB
1286 /* Make sure that in, out, and err are not actually already in
1287 descriptors zero, one, or two; this could happen if Emacs is
7e6c2178 1288 started with its standard in, out, or error closed, as might
426b37ae 1289 happen under X. */
f29f9e4a
RS
1290 {
1291 int oin = in, oout = out;
1292
1293 /* We have to avoid relocating the same descriptor twice! */
1294
1295 in = relocate_fd (in, 3);
1296
1297 if (out == oin)
1298 out = in;
1299 else
3e9367e7 1300 out = relocate_fd (out, 3);
f29f9e4a
RS
1301
1302 if (err == oin)
1303 err = in;
1304 else if (err == oout)
1305 err = out;
1306 else
3e9367e7 1307 err = relocate_fd (err, 3);
f29f9e4a 1308 }
426b37ae 1309
c17c4250 1310#ifndef MSDOS
68c45bf0
PE
1311 emacs_close (0);
1312 emacs_close (1);
1313 emacs_close (2);
80856e74
JB
1314
1315 dup2 (in, 0);
1316 dup2 (out, 1);
1317 dup2 (err, 2);
68c45bf0 1318 emacs_close (in);
ce8f5a9a
AS
1319 if (out != in)
1320 emacs_close (out);
1321 if (err != in && err != out)
1322 emacs_close (err);
80856e74 1323
dd0333b6 1324 setpgid (0, 0);
12e610e8 1325 tcsetpgrp (0, pid);
a7ebc409 1326
21e54a94 1327 execve (new_argv[0], new_argv, env);
80856e74 1328
68c45bf0
PE
1329 emacs_write (1, "Can't exec program: ", 20);
1330 emacs_write (1, new_argv[0], strlen (new_argv[0]));
1331 emacs_write (1, "\n", 1);
80856e74 1332 _exit (1);
67802943
DN
1333
1334#else /* MSDOS */
1335 pid = run_msdos_command (new_argv, pwd_var + 4, in, out, err, env);
1336 xfree (pwd_var);
1337 if (pid == -1)
1338 /* An error occurred while trying to run the subprocess. */
1339 report_file_error ("Spawning child process", Qnil);
1340 return pid;
1341#endif /* MSDOS */
ae76d9e1 1342#endif /* not WINDOWSNT */
80856e74
JB
1343}
1344
361358ea 1345#ifndef WINDOWSNT
a3833dfe 1346/* Move the file descriptor FD so that its number is not less than MINFD.
426b37ae 1347 If the file descriptor is moved at all, the original is freed. */
dfcf069d 1348static int
971de7fb 1349relocate_fd (int fd, int minfd)
426b37ae 1350{
a3833dfe 1351 if (fd >= minfd)
426b37ae
JB
1352 return fd;
1353 else
1354 {
49cdacda 1355 int new = fcntl (fd, F_DUPFD, minfd);
426b37ae
JB
1356 if (new == -1)
1357 {
cb1d0ef7 1358 const char *message_1 = "Error while setting up child: ";
a8fe7202 1359 const char *errmessage = strerror (errno);
cb1d0ef7
PE
1360 const char *message_2 = "\n";
1361 emacs_write (2, message_1, strlen (message_1));
68c45bf0 1362 emacs_write (2, errmessage, strlen (errmessage));
cb1d0ef7 1363 emacs_write (2, message_2, strlen (message_2));
426b37ae
JB
1364 _exit (1);
1365 }
68c45bf0 1366 emacs_close (fd);
426b37ae
JB
1367 return new;
1368 }
1369}
361358ea 1370#endif /* not WINDOWSNT */
426b37ae 1371
2f221583 1372static bool
989f33ba
PE
1373getenv_internal_1 (const char *var, ptrdiff_t varlen, char **value,
1374 ptrdiff_t *valuelen, Lisp_Object env)
012c6fcb 1375{
db699fc6 1376 for (; CONSP (env); env = XCDR (env))
012c6fcb 1377 {
db699fc6 1378 Lisp_Object entry = XCAR (env);
d50d3dc8 1379 if (STRINGP (entry)
db699fc6 1380 && SBYTES (entry) >= varlen
bad95d8f
RS
1381#ifdef WINDOWSNT
1382 /* NT environment variables are case insensitive. */
d5db4077 1383 && ! strnicmp (SDATA (entry), var, varlen)
bad95d8f 1384#else /* not WINDOWSNT */
72af86bd 1385 && ! memcmp (SDATA (entry), var, varlen)
bad95d8f 1386#endif /* not WINDOWSNT */
a9971c6d 1387 )
012c6fcb 1388 {
db699fc6
SM
1389 if (SBYTES (entry) > varlen && SREF (entry, varlen) == '=')
1390 {
51b59d79 1391 *value = SSDATA (entry) + (varlen + 1);
db699fc6
SM
1392 *valuelen = SBYTES (entry) - (varlen + 1);
1393 return 1;
1394 }
1395 else if (SBYTES (entry) == varlen)
1396 {
1397 /* Lone variable names in Vprocess_environment mean that
1398 variable should be removed from the environment. */
1399 *value = NULL;
1400 return 1;
1401 }
1402 }
1403 }
1404 return 0;
1405}
1406
2f221583 1407static bool
989f33ba
PE
1408getenv_internal (const char *var, ptrdiff_t varlen, char **value,
1409 ptrdiff_t *valuelen, Lisp_Object frame)
012c6fcb 1410{
d2bb6598
SM
1411 /* Try to find VAR in Vprocess_environment first. */
1412 if (getenv_internal_1 (var, varlen, value, valuelen,
1413 Vprocess_environment))
1414 return *value ? 1 : 0;
f105f403 1415
d2bb6598 1416 /* For DISPLAY try to get the values from the frame or the initial env. */
de87fb59 1417 if (strcmp (var, "DISPLAY") == 0)
d2bb6598
SM
1418 {
1419 Lisp_Object display
1420 = Fframe_parameter (NILP (frame) ? selected_frame : frame, Qdisplay);
1421 if (STRINGP (display))
1422 {
51b59d79 1423 *value = SSDATA (display);
de87fb59 1424 *valuelen = SBYTES (display);
012c6fcb
JA
1425 return 1;
1426 }
d2bb6598
SM
1427 /* If still not found, Look for DISPLAY in Vinitial_environment. */
1428 if (getenv_internal_1 (var, varlen, value, valuelen,
1429 Vinitial_environment))
1430 return *value ? 1 : 0;
012c6fcb
JA
1431 }
1432
1433 return 0;
1434}
1435
f105f403 1436DEFUN ("getenv-internal", Fgetenv_internal, Sgetenv_internal, 1, 2, 0,
5990851d
KL
1437 doc: /* Get the value of environment variable VARIABLE.
1438VARIABLE should be a string. Value is nil if VARIABLE is undefined in
1439the environment. Otherwise, value is a string.
f105f403 1440
acf20901 1441This function searches `process-environment' for VARIABLE.
5990851d 1442
db699fc6 1443If optional parameter ENV is a list, then search this list instead of
acf20901
JB
1444`process-environment', and return t when encountering a negative entry
1445\(an entry for a variable with no value). */)
5842a27b 1446 (Lisp_Object variable, Lisp_Object env)
012c6fcb
JA
1447{
1448 char *value;
989f33ba 1449 ptrdiff_t valuelen;
012c6fcb 1450
5990851d 1451 CHECK_STRING (variable);
db699fc6
SM
1452 if (CONSP (env))
1453 {
42a5b22f 1454 if (getenv_internal_1 (SSDATA (variable), SBYTES (variable),
db699fc6
SM
1455 &value, &valuelen, env))
1456 return value ? make_string (value, valuelen) : Qt;
1457 else
1458 return Qnil;
1459 }
42a5b22f 1460 else if (getenv_internal (SSDATA (variable), SBYTES (variable),
d2bb6598 1461 &value, &valuelen, env))
012c6fcb
JA
1462 return make_string (value, valuelen);
1463 else
1464 return Qnil;
1465}
1466
5990851d
KL
1467/* A version of getenv that consults the Lisp environment lists,
1468 easily callable from C. */
012c6fcb 1469char *
a8fe7202 1470egetenv (const char *var)
012c6fcb
JA
1471{
1472 char *value;
25c7e41f 1473 ptrdiff_t valuelen;
012c6fcb 1474
f105f403 1475 if (getenv_internal (var, strlen (var), &value, &valuelen, Qnil))
012c6fcb
JA
1476 return value;
1477 else
1478 return 0;
1479}
1480
80856e74 1481\f
8de15d69 1482/* This is run before init_cmdargs. */
177c0ea7 1483
dfcf069d 1484void
971de7fb 1485init_callproc_1 (void)
8de15d69 1486{
d01ba2f1
GM
1487#ifdef HAVE_NS
1488 const char *etc_dir = ns_etc_directory ();
cbb31951 1489 const char *path_exec = ns_exec_path ();
d01ba2f1 1490#endif
35a2f4b8 1491
76151e2c 1492 Vdata_directory = decode_env_path ("EMACSDATA",
d01ba2f1 1493#ifdef HAVE_NS
76151e2c 1494 etc_dir ? etc_dir :
d01ba2f1 1495#endif
76151e2c
EZ
1496 PATH_DATA);
1497 Vdata_directory = Ffile_name_as_directory (Fcar (Vdata_directory));
1498
1499 Vdoc_directory = decode_env_path ("EMACSDOC",
d01ba2f1 1500#ifdef HAVE_NS
76151e2c 1501 etc_dir ? etc_dir :
d01ba2f1 1502#endif
76151e2c
EZ
1503 PATH_DOC);
1504 Vdoc_directory = Ffile_name_as_directory (Fcar (Vdoc_directory));
9453ea7b 1505
e576cab4 1506 /* Check the EMACSPATH environment variable, defaulting to the
57bda87a 1507 PATH_EXEC path from epaths.h. */
cbb31951
GM
1508 Vexec_path = decode_env_path ("EMACSPATH",
1509#ifdef HAVE_NS
1510 path_exec ? path_exec :
1511#endif
1512 PATH_EXEC);
80856e74 1513 Vexec_directory = Ffile_name_as_directory (Fcar (Vexec_path));
cbb31951 1514 /* FIXME? For ns, path_exec should go at the front? */
80856e74 1515 Vexec_path = nconc2 (decode_env_path ("PATH", ""), Vexec_path);
8de15d69
RS
1516}
1517
e17f7533 1518/* This is run after init_cmdargs, when Vinstallation_directory is valid. */
8de15d69 1519
dfcf069d 1520void
971de7fb 1521init_callproc (void)
8de15d69
RS
1522{
1523 char *data_dir = egetenv ("EMACSDATA");
177c0ea7 1524
8de15d69
RS
1525 register char * sh;
1526 Lisp_Object tempdir;
d01ba2f1
GM
1527#ifdef HAVE_NS
1528 if (data_dir == 0)
1529 {
1530 const char *etc_dir = ns_etc_directory ();
1531 if (etc_dir)
1532 {
1533 data_dir = alloca (strlen (etc_dir) + 1);
1534 strcpy (data_dir, etc_dir);
1535 }
1536 }
1537#endif
8de15d69 1538
9cc4fad5 1539 if (!NILP (Vinstallation_directory))
8de15d69 1540 {
05630743
RS
1541 /* Add to the path the lib-src subdir of the installation dir. */
1542 Lisp_Object tem;
1543 tem = Fexpand_file_name (build_string ("lib-src"),
1544 Vinstallation_directory);
76151e2c 1545#ifndef MSDOS
1a6640ec 1546 /* MSDOS uses wrapped binaries, so don't do this. */
0fa248bc 1547 if (NILP (Fmember (tem, Vexec_path)))
70ec1377 1548 {
cbb31951
GM
1549#ifdef HAVE_NS
1550 const char *path_exec = ns_exec_path ();
1551#endif
1552 Vexec_path = decode_env_path ("EMACSPATH",
1553#ifdef HAVE_NS
1554 path_exec ? path_exec :
1555#endif
1556 PATH_EXEC);
70ec1377
RS
1557 Vexec_path = Fcons (tem, Vexec_path);
1558 Vexec_path = nconc2 (decode_env_path ("PATH", ""), Vexec_path);
1559 }
177c0ea7 1560
0fa248bc 1561 Vexec_directory = Ffile_name_as_directory (tem);
76151e2c 1562#endif /* not MSDOS */
8de15d69 1563
e17f7533
RS
1564 /* Maybe use ../etc as well as ../lib-src. */
1565 if (data_dir == 0)
1566 {
1567 tem = Fexpand_file_name (build_string ("etc"),
1568 Vinstallation_directory);
1569 Vdoc_directory = Ffile_name_as_directory (tem);
8de15d69
RS
1570 }
1571 }
7e933683
RS
1572
1573 /* Look for the files that should be in etc. We don't use
1574 Vinstallation_directory, because these files are never installed
e17f7533 1575 near the executable, and they are never in the build
7e933683
RS
1576 directory when that's different from the source directory.
1577
1578 Instead, if these files are not in the nominal place, we try the
1579 source directory. */
1580 if (data_dir == 0)
1581 {
70ec1377 1582 Lisp_Object tem, tem1, srcdir;
7e933683 1583
70ec1377
RS
1584 srcdir = Fexpand_file_name (build_string ("../src/"),
1585 build_string (PATH_DUMPLOADSEARCH));
7e933683
RS
1586 tem = Fexpand_file_name (build_string ("GNU"), Vdata_directory);
1587 tem1 = Ffile_exists_p (tem);
70ec1377 1588 if (!NILP (Fequal (srcdir, Vinvocation_directory)) || NILP (tem1))
7e933683 1589 {
70ec1377 1590 Lisp_Object newdir;
7e933683
RS
1591 newdir = Fexpand_file_name (build_string ("../etc/"),
1592 build_string (PATH_DUMPLOADSEARCH));
1593 tem = Fexpand_file_name (build_string ("GNU"), newdir);
1594 tem1 = Ffile_exists_p (tem);
1595 if (!NILP (tem1))
1596 Vdata_directory = newdir;
1597 }
1598 }
80856e74 1599
d883eb62
RS
1600#ifndef CANNOT_DUMP
1601 if (initialized)
1602#endif
1603 {
1604 tempdir = Fdirectory_file_name (Vexec_directory);
73dcdb9f
PE
1605 if (! file_accessible_directory_p (SSDATA (tempdir)))
1606 dir_warning ("arch-dependent data dir", Vexec_directory);
d883eb62 1607 }
80856e74 1608
e576cab4 1609 tempdir = Fdirectory_file_name (Vdata_directory);
73dcdb9f
PE
1610 if (! file_accessible_directory_p (SSDATA (tempdir)))
1611 dir_warning ("arch-independent data dir", Vdata_directory);
e576cab4 1612
e576cab4 1613 sh = (char *) getenv ("SHELL");
80856e74 1614 Vshell_file_name = build_string (sh ? sh : "/bin/sh");
8abd035b 1615
40b49d4b
JB
1616#ifdef DOS_NT
1617 Vshared_game_score_directory = Qnil;
1618#else
63789758 1619 Vshared_game_score_directory = build_string (PATH_GAME);
73dcdb9f 1620 if (NILP (Ffile_accessible_directory_p (Vshared_game_score_directory)))
63789758 1621 Vshared_game_score_directory = Qnil;
40b49d4b 1622#endif
9fefd2ba
JB
1623}
1624
dfcf069d 1625void
971de7fb 1626set_initial_environment (void)
9fefd2ba 1627{
738db178
DN
1628 char **envp;
1629 for (envp = environ; *envp; envp++)
1630 Vprocess_environment = Fcons (build_string (*envp),
1631 Vprocess_environment);
1632 /* Ideally, the `copy' shouldn't be necessary, but it seems it's frequent
1633 to use `delete' and friends on process-environment. */
1634 Vinitial_environment = Fcopy_sequence (Vprocess_environment);
80856e74
JB
1635}
1636
dfcf069d 1637void
971de7fb 1638syms_of_callproc (void)
80856e74 1639{
f92d51d8
CY
1640#ifndef DOS_NT
1641 Vtemp_file_name_pattern = build_string ("emacsXXXXXX");
1642#elif defined (WINDOWSNT)
1643 Vtemp_file_name_pattern = build_string ("emXXXXXX");
1644#else
1645 Vtemp_file_name_pattern = build_string ("detmp.XXX");
1646#endif
1647 staticpro (&Vtemp_file_name_pattern);
1648
29208e82 1649 DEFVAR_LISP ("shell-file-name", Vshell_file_name,
fb7ada5f 1650 doc: /* File name to load inferior shells from.
b20b29be
EZ
1651Initialized from the SHELL environment variable, or to a system-dependent
1652default if SHELL is not set. */);
80856e74 1653
29208e82 1654 DEFVAR_LISP ("exec-path", Vexec_path,
fb7ada5f 1655 doc: /* List of directories to search programs to run in subprocesses.
fdb82f93 1656Each element is a string (directory name) or nil (try default directory). */);
80856e74 1657
29208e82 1658 DEFVAR_LISP ("exec-suffixes", Vexec_suffixes,
fb7ada5f 1659 doc: /* List of suffixes to try to find executable file names.
fdb82f93 1660Each element is a string. */);
33d5af99 1661 Vexec_suffixes = Qnil;
b81a1b72 1662
29208e82 1663 DEFVAR_LISP ("exec-directory", Vexec_directory,
fdb82f93
PJ
1664 doc: /* Directory for executables for Emacs to invoke.
1665More generally, this includes any architecture-dependent files
1666that are built and installed from the Emacs distribution. */);
e576cab4 1667
29208e82 1668 DEFVAR_LISP ("data-directory", Vdata_directory,
fdb82f93
PJ
1669 doc: /* Directory of machine-independent files that come with GNU Emacs.
1670These are files intended for Emacs to use while it runs. */);
80856e74 1671
29208e82 1672 DEFVAR_LISP ("doc-directory", Vdoc_directory,
fdb82f93 1673 doc: /* Directory containing the DOC file that comes with GNU Emacs.
ebf24b59 1674This is usually the same as `data-directory'. */);
35a2f4b8 1675
29208e82 1676 DEFVAR_LISP ("configure-info-directory", Vconfigure_info_directory,
fdb82f93
PJ
1677 doc: /* For internal use by the build procedure only.
1678This is the name of the directory in which the build procedure installed
ebf24b59 1679Emacs's info files; the default value for `Info-default-directory-list'
fdb82f93 1680includes this. */);
ed61592a
JB
1681 Vconfigure_info_directory = build_string (PATH_INFO);
1682
29208e82 1683 DEFVAR_LISP ("shared-game-score-directory", Vshared_game_score_directory,
b065672a
CW
1684 doc: /* Directory of score files for games which come with GNU Emacs.
1685If this variable is nil, then Emacs is unable to use a shared directory. */);
40b49d4b
JB
1686#ifdef DOS_NT
1687 Vshared_game_score_directory = Qnil;
1688#else
63789758 1689 Vshared_game_score_directory = build_string (PATH_GAME);
40b49d4b 1690#endif
b065672a 1691
29208e82 1692 DEFVAR_LISP ("initial-environment", Vinitial_environment,
6b8e474c
SM
1693 doc: /* List of environment variables inherited from the parent process.
1694Each element should be a string of the form ENVVARNAME=VALUE.
1695The elements must normally be decoded (using `locale-coding-system') for use. */);
1696 Vinitial_environment = Qnil;
1697
29208e82 1698 DEFVAR_LISP ("process-environment", Vprocess_environment,
5990851d 1699 doc: /* List of overridden environment variables for subprocesses to inherit.
fdb82f93 1700Each element should be a string of the form ENVVARNAME=VALUE.
5990851d 1701
a13f8f50
KL
1702Entries in this list take precedence to those in the frame-local
1703environments. Therefore, let-binding `process-environment' is an easy
1704way to temporarily change the value of an environment variable,
1705irrespective of where it comes from. To use `process-environment' to
1706remove an environment variable, include only its name in the list,
1707without "=VALUE".
5990851d
KL
1708
1709This variable is set to nil when Emacs starts.
1710
fdb82f93
PJ
1711If multiple entries define the same variable, the first one always
1712takes precedence.
5990851d 1713
776a24a1 1714Non-ASCII characters are encoded according to the initial value of
5990851d
KL
1715`locale-coding-system', i.e. the elements must normally be decoded for
1716use.
1717
776a24a1 1718See `setenv' and `getenv'. */);
86f5ca04 1719 Vprocess_environment = Qnil;
80856e74 1720
80856e74 1721 defsubr (&Scall_process);
83fa009c 1722 defsubr (&Sgetenv_internal);
e576cab4 1723 defsubr (&Scall_process_region);
80856e74 1724}