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