Add gnulib support for pthread_sigmask.
[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 {
3c59b4c9 255 SAFE_ALLOCA (args2, Lisp_Object *, (nargs + 1) * sizeof *args2);
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);
599 sigprocmask (SIG_BLOCK, &blocked, &procmask);
600#endif
601
aba637ec
KS
602 BLOCK_INPUT;
603
db6c0e74 604 /* vfork, and prevent local vars from being clobbered by the vfork. */
b08a63cc 605 {
db6c0e74
PE
606 int volatile fd_error_volatile = fd_error;
607 int volatile fd_output_volatile = fd_output;
608 int volatile output_to_buffer_volatile = output_to_buffer;
609 unsigned char const **volatile new_argv_volatile = new_argv;
80856e74 610
db6c0e74 611 pid = vfork ();
80856e74 612
db6c0e74
PE
613 fd_error = fd_error_volatile;
614 fd_output = fd_output_volatile;
615 output_to_buffer = output_to_buffer_volatile;
616 new_argv = new_argv_volatile;
617 }
b9c7f648 618
80856e74
JB
619 if (pid == 0)
620 {
621 if (fd[0] >= 0)
68c45bf0 622 emacs_close (fd[0]);
1e7963c7 623#ifdef HAVE_SETSID
19ed11ba 624 setsid ();
1e7963c7 625#endif
58eb6cf0 626#if defined (USG)
19ed11ba 627 setpgrp ();
80856e74 628#else
19ed11ba 629 setpgrp (pid, pid);
80856e74 630#endif /* USG */
c0ad4ea5 631
2f9a22e2 632 /* GConf causes us to ignore SIGPIPE, make sure it is restored
c0ad4ea5 633 in the child. */
2f9a22e2 634 //signal (SIGPIPE, SIG_DFL);
c0ad4ea5
AS
635#ifdef HAVE_WORKING_VFORK
636 sigprocmask (SIG_SETMASK, &procmask, 0);
637#endif
638
2d607244
RS
639 child_setup (filefd, fd1, fd_error, (char **) new_argv,
640 0, current_dir);
80856e74 641 }
aba637ec
KS
642
643 UNBLOCK_INPUT;
c0ad4ea5
AS
644
645#ifdef HAVE_WORKING_VFORK
646 /* Restore the signal state. */
647 sigaction (SIGPIPE, &sigpipe_action, 0);
648 sigprocmask (SIG_SETMASK, &procmask, 0);
649#endif
650
bad95d8f 651#endif /* not WINDOWSNT */
cd5f8f60
RS
652
653 /* The MSDOS case did this already. */
654 if (fd_error >= 0)
68c45bf0 655 emacs_close (fd_error);
2610078a 656#endif /* not MSDOS */
80856e74 657
80856e74
JB
658 environ = save_environ;
659
6b6e798b
RS
660 /* Close most of our fd's, but not fd[0]
661 since we will use that to read input from. */
68c45bf0 662 emacs_close (filefd);
1ef14cb4
LMI
663 if (fd_output >= 0)
664 emacs_close (fd_output);
799abb26 665 if (fd1 >= 0 && fd1 != fd_error)
68c45bf0 666 emacs_close (fd1);
80856e74
JB
667 }
668
669 if (pid < 0)
670 {
6b6e798b 671 if (fd[0] >= 0)
68c45bf0 672 emacs_close (fd[0]);
80856e74
JB
673 report_file_error ("Doing vfork", Qnil);
674 }
675
d50d3dc8 676 if (INTEGERP (buffer))
80856e74 677 {
6b6e798b 678 if (fd[0] >= 0)
68c45bf0 679 emacs_close (fd[0]);
80856e74
JB
680 return Qnil;
681 }
682
6b6e798b 683 /* Enable sending signal if user quits below. */
37d54121
RS
684 call_process_exited = 0;
685
e39a993c 686#if defined(MSDOS)
7e6c2178
RS
687 /* MSDOS needs different cleanup information. */
688 record_unwind_protect (call_process_cleanup,
ad3aaf33
AS
689 Fcons (Fcurrent_buffer (),
690 Fcons (make_number (fd[0]),
888c9e86 691 build_string (tempfile ? tempfile : ""))));
7e6c2178 692#else
80856e74 693 record_unwind_protect (call_process_cleanup,
ad3aaf33
AS
694 Fcons (Fcurrent_buffer (),
695 Fcons (make_number (fd[0]), make_number (pid))));
e39a993c 696#endif /* not MSDOS */
80856e74
JB
697
698
d50d3dc8 699 if (BUFFERP (buffer))
80856e74
JB
700 Fset_buffer (buffer);
701
09494912
RS
702 if (NILP (buffer))
703 {
704 /* If BUFFER is nil, we must read process output once and then
705 discard it, so setup coding system but with nil. */
706 setup_coding_system (Qnil, &process_coding);
707 }
708 else
709 {
710 Lisp_Object val, *args2;
711
712 val = Qnil;
713 if (!NILP (Vcoding_system_for_read))
714 val = Vcoding_system_for_read;
715 else
716 {
717 if (EQ (coding_systems, Qt))
718 {
f66c7cf8 719 ptrdiff_t i;
09494912 720
3c59b4c9 721 SAFE_ALLOCA (args2, Lisp_Object *, (nargs + 1) * sizeof *args2);
09494912
RS
722 args2[0] = Qcall_process;
723 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
724 coding_systems
725 = Ffind_operation_coding_system (nargs + 1, args2);
726 }
727 if (CONSP (coding_systems))
70949dac 728 val = XCAR (coding_systems);
09494912 729 else if (CONSP (Vdefault_process_coding_system))
70949dac 730 val = XCAR (Vdefault_process_coding_system);
09494912
RS
731 else
732 val = Qnil;
733 }
91183bfd 734 Fcheck_coding_system (val);
09494912
RS
735 /* In unibyte mode, character code conversion should not take
736 place but EOL conversion should. So, setup raw-text or one
737 of the subsidiary according to the information just setup. */
4b4deea2 738 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
09494912 739 && !NILP (val))
91183bfd
KH
740 val = raw_text_coding_system (val);
741 setup_coding_system (val, &process_coding);
09494912
RS
742 }
743
80856e74
JB
744 immediate_quit = 1;
745 QUIT;
746
1ef14cb4 747 if (output_to_buffer)
19ed11ba
AS
748 {
749 register EMACS_INT nread;
750 int first = 1;
751 EMACS_INT total_read = 0;
752 int carryover = 0;
753 int display_p = display_p_volatile;
754 int display_on_the_fly = display_p;
755 struct coding_system saved_coding;
756
757 saved_coding = process_coding;
758 while (1)
759 {
760 /* Repeatedly read until we've filled as much as possible
761 of the buffer size we have. But don't read
762 less than 1024--save that for the next bufferful. */
763 nread = carryover;
764 while (nread < bufsize - 1024)
765 {
766 int this_read = emacs_read (fd[0], buf + nread,
767 bufsize - nread);
60558b19 768
19ed11ba
AS
769 if (this_read < 0)
770 goto give_up;
60558b19 771
19ed11ba
AS
772 if (this_read == 0)
773 {
774 process_coding.mode |= CODING_MODE_LAST_BLOCK;
775 break;
776 }
60558b19 777
19ed11ba
AS
778 nread += this_read;
779 total_read += this_read;
60558b19 780
19ed11ba
AS
781 if (display_on_the_fly)
782 break;
783 }
60558b19 784
19ed11ba
AS
785 /* Now NREAD is the total amount of data in the buffer. */
786 immediate_quit = 0;
177c0ea7 787
19ed11ba
AS
788 if (!NILP (buffer))
789 {
790 if (NILP (BVAR (current_buffer, enable_multibyte_characters))
791 && ! CODING_MAY_REQUIRE_DECODING (&process_coding))
792 insert_1_both (buf, nread, nread, 0, 1, 0);
793 else
794 { /* We have to decode the input. */
795 Lisp_Object curbuf;
796 int count1 = SPECPDL_INDEX ();
797
798 XSETBUFFER (curbuf, current_buffer);
799 /* We cannot allow after-change-functions be run
800 during decoding, because that might modify the
801 buffer, while we rely on process_coding.produced to
802 faithfully reflect inserted text until we
803 TEMP_SET_PT_BOTH below. */
804 specbind (Qinhibit_modification_hooks, Qt);
805 decode_coding_c_string (&process_coding,
806 (unsigned char *) buf, nread, curbuf);
807 unbind_to (count1, Qnil);
808 if (display_on_the_fly
809 && CODING_REQUIRE_DETECTION (&saved_coding)
810 && ! CODING_REQUIRE_DETECTION (&process_coding))
811 {
812 /* We have detected some coding system. But,
813 there's a possibility that the detection was
814 done by insufficient data. So, we give up
815 displaying on the fly. */
816 if (process_coding.produced > 0)
817 del_range_2 (process_coding.dst_pos,
818 process_coding.dst_pos_byte,
819 process_coding.dst_pos
820 + process_coding.produced_char,
821 process_coding.dst_pos_byte
822 + process_coding.produced, 0);
823 display_on_the_fly = 0;
824 process_coding = saved_coding;
825 carryover = nread;
826 /* This is to make the above condition always
827 fails in the future. */
828 saved_coding.common_flags
829 &= ~CODING_REQUIRE_DETECTION_MASK;
830 continue;
831 }
832
833 TEMP_SET_PT_BOTH (PT + process_coding.produced_char,
834 PT_BYTE + process_coding.produced);
835 carryover = process_coding.carryover_bytes;
836 if (carryover > 0)
837 memcpy (buf, process_coding.carryover,
838 process_coding.carryover_bytes);
839 }
840 }
c5bfa12b 841
19ed11ba
AS
842 if (process_coding.mode & CODING_MODE_LAST_BLOCK)
843 break;
6e3bfbb2 844
19ed11ba
AS
845 /* Make the buffer bigger as we continue to read more data,
846 but not past CALLPROC_BUFFER_SIZE_MAX. */
847 if (bufsize < CALLPROC_BUFFER_SIZE_MAX && total_read > 32 * bufsize)
848 if ((bufsize *= 2) > CALLPROC_BUFFER_SIZE_MAX)
849 bufsize = CALLPROC_BUFFER_SIZE_MAX;
6e3bfbb2 850
19ed11ba
AS
851 if (display_p)
852 {
853 if (first)
854 prepare_menu_bars ();
855 first = 0;
856 redisplay_preserve_echo_area (1);
857 /* This variable might have been set to 0 for code
858 detection. In that case, we set it back to 1 because
859 we should have already detected a coding system. */
860 display_on_the_fly = 1;
861 }
862 immediate_quit = 1;
863 QUIT;
864 }
865 give_up: ;
866
867 Vlast_coding_system_used = CODING_ID_NAME (process_coding.id);
868 /* If the caller required, let the buffer inherit the
869 coding-system used to decode the process output. */
870 if (inherit_process_coding_system)
871 call1 (intern ("after-insert-file-set-buffer-file-coding-system"),
872 make_number (total_read));
873 }
3b440bb5 874
77defa9a 875#ifndef MSDOS
80856e74 876 /* Wait for it to terminate, unless it already has. */
1ef14cb4
LMI
877 if (output_to_buffer)
878 wait_for_termination (pid);
879 else
880 interruptible_wait_for_termination (pid);
77defa9a 881#endif
80856e74
JB
882
883 immediate_quit = 0;
884
37d54121
RS
885 /* Don't kill any children that the subprocess may have left behind
886 when exiting. */
887 call_process_exited = 1;
888
3c59b4c9 889 SAFE_FREE ();
80856e74
JB
890 unbind_to (count, Qnil);
891
6b61353c
KH
892 if (synch_process_termsig)
893 {
42ca4633 894 const char *signame;
6b61353c
KH
895
896 synchronize_system_messages_locale ();
897 signame = strsignal (synch_process_termsig);
898
899 if (signame == 0)
19ed11ba 900 signame = "unknown";
6b61353c
KH
901
902 synch_process_death = signame;
903 }
904
80856e74 905 if (synch_process_death)
68c45bf0
PE
906 return code_convert_string_norecord (build_string (synch_process_death),
907 Vlocale_coding_system, 0);
80856e74
JB
908 return make_number (synch_process_retcode);
909}
80856e74 910\f
9fefd2ba 911static Lisp_Object
971de7fb 912delete_temp_file (Lisp_Object name)
80856e74 913{
1a271e14
KR
914 /* Suppress jka-compr handling, etc. */
915 int count = SPECPDL_INDEX ();
916 specbind (intern ("file-name-handler-alist"), Qnil);
f1a5d776 917 internal_delete_file (name);
1a271e14 918 unbind_to (count, Qnil);
320695d8 919 return Qnil;
80856e74
JB
920}
921
922DEFUN ("call-process-region", Fcall_process_region, Scall_process_region,
fdb82f93
PJ
923 3, MANY, 0,
924 doc: /* Send text from START to END to a synchronous process running PROGRAM.
925The remaining arguments are optional.
926Delete the text if fourth arg DELETE is non-nil.
927
1ef14cb4
LMI
928Insert output in BUFFER before point; t means current buffer; nil for
929 BUFFER means discard it; 0 means discard and don't wait; and `(:file
930 FILE)', where FILE is a file name string, means that it should be
931 written to that file.
fdb82f93
PJ
932BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
933REAL-BUFFER says what to do with standard output, as above,
934while STDERR-FILE says what to do with standard error in the child.
935STDERR-FILE may be nil (discard standard error output),
936t (mix it with ordinary output), or a file name string.
937
938Sixth arg DISPLAY non-nil means redisplay buffer as output is inserted.
939Remaining args are passed to PROGRAM at startup as command args.
940
ba9a5174 941If BUFFER is 0, `call-process-region' returns immediately with value nil.
fdb82f93
PJ
942Otherwise it waits for PROGRAM to terminate
943and returns a numeric exit status or a signal description string.
d98b59b5
MB
944If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.
945
946usage: (call-process-region START END PROGRAM &optional DELETE BUFFER DISPLAY &rest ARGS) */)
f66c7cf8 947 (ptrdiff_t nargs, Lisp_Object *args)
80856e74 948{
39323a7e
KH
949 struct gcpro gcpro1;
950 Lisp_Object filename_string;
951 register Lisp_Object start, end;
aed13378 952 int count = SPECPDL_INDEX ();
08ee4e87 953 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
09494912 954 Lisp_Object coding_systems;
32d08644 955 Lisp_Object val, *args2;
f66c7cf8 956 ptrdiff_t i;
7e6c2178 957 char *tempfile;
f92d51d8 958 Lisp_Object tmpdir, pattern;
7e6c2178 959
f92d51d8
CY
960 if (STRINGP (Vtemporary_file_directory))
961 tmpdir = Vtemporary_file_directory;
7e6c2178
RS
962 else
963 {
f92d51d8
CY
964#ifndef DOS_NT
965 if (getenv ("TMPDIR"))
966 tmpdir = build_string (getenv ("TMPDIR"));
967 else
968 tmpdir = build_string ("/tmp/");
969#else /* DOS_NT */
970 char *outf;
971 if ((outf = egetenv ("TMPDIR"))
972 || (outf = egetenv ("TMP"))
973 || (outf = egetenv ("TEMP")))
974 tmpdir = build_string (outf);
975 else
976 tmpdir = Ffile_name_as_directory (build_string ("c:/temp"));
0774fcf8 977#endif
f92d51d8 978 }
7e6c2178 979
3c59b4c9
PE
980 {
981 USE_SAFE_ALLOCA;
982 pattern = Fexpand_file_name (Vtemp_file_name_pattern, tmpdir);
983 SAFE_ALLOCA (tempfile, char *, SBYTES (pattern) + 1);
984 memcpy (tempfile, SDATA (pattern), SBYTES (pattern) + 1);
985 coding_systems = Qt;
09494912 986
1ddc85a4 987#ifdef HAVE_MKSTEMP
3c59b4c9
PE
988 {
989 int fd;
990
991 BLOCK_INPUT;
992 fd = mkstemp (tempfile);
993 UNBLOCK_INPUT;
994 if (fd == -1)
995 report_file_error ("Failed to open temporary file",
996 Fcons (Vtemp_file_name_pattern, Qnil));
997 else
998 close (fd);
999 }
1ddc85a4 1000#else
3c59b4c9 1001 mktemp (tempfile);
1ddc85a4 1002#endif
80856e74 1003
3c59b4c9
PE
1004 filename_string = build_string (tempfile);
1005 GCPRO1 (filename_string);
1006 SAFE_FREE ();
1007 }
1008
80856e74
JB
1009 start = args[0];
1010 end = args[1];
32d08644 1011 /* Decide coding-system of the contents of the temporary file. */
91489411
RS
1012 if (!NILP (Vcoding_system_for_write))
1013 val = Vcoding_system_for_write;
4b4deea2 1014 else if (NILP (BVAR (current_buffer, enable_multibyte_characters)))
fcaf8878 1015 val = Qraw_text;
32d08644 1016 else
beacaab3 1017 {
3c59b4c9
PE
1018 USE_SAFE_ALLOCA;
1019 SAFE_ALLOCA (args2, Lisp_Object *, (nargs + 1) * sizeof *args2);
91489411
RS
1020 args2[0] = Qcall_process_region;
1021 for (i = 0; i < nargs; i++) args2[i + 1] = args[i];
1022 coding_systems = Ffind_operation_coding_system (nargs + 1, args2);
fcaf8878 1023 val = CONSP (coding_systems) ? XCDR (coding_systems) : Qnil;
3c59b4c9 1024 SAFE_FREE ();
beacaab3 1025 }
fcaf8878 1026 val = complement_process_encoding_system (val);
32d08644 1027
168afdaa 1028 {
aed13378 1029 int count1 = SPECPDL_INDEX ();
168afdaa
RS
1030
1031 specbind (intern ("coding-system-for-write"), val);
bb951f0e
KR
1032 /* POSIX lets mk[s]temp use "."; don't invoke jka-compr if we
1033 happen to get a ".Z" suffix. */
1034 specbind (intern ("file-name-handler-alist"), Qnil);
168afdaa
RS
1035 Fwrite_region (start, end, filename_string, Qnil, Qlambda, Qnil, Qnil);
1036
1037 unbind_to (count1, Qnil);
1038 }
91489411 1039
177c0ea7 1040 /* Note that Fcall_process takes care of binding
91489411 1041 coding-system-for-read. */
093650fe 1042
80856e74
JB
1043 record_unwind_protect (delete_temp_file, filename_string);
1044
edf496dd 1045 if (nargs > 3 && !NILP (args[3]))
80856e74
JB
1046 Fdelete_region (start, end);
1047
edf496dd
KH
1048 if (nargs > 3)
1049 {
1050 args += 2;
1051 nargs -= 2;
1052 }
1053 else
1054 {
1055 args[0] = args[2];
1056 nargs = 2;
1057 }
1058 args[1] = filename_string;
80856e74 1059
edf496dd 1060 RETURN_UNGCPRO (unbind_to (count, Fcall_process (nargs, args)));
80856e74
JB
1061}
1062\f
361358ea 1063#ifndef WINDOWSNT
971de7fb 1064static int relocate_fd (int fd, int minfd);
361358ea 1065#endif
dfcf069d 1066
5990851d
KL
1067static char **
1068add_env (char **env, char **new_env, char *string)
1069{
1070 char **ep;
1071 int ok = 1;
1072 if (string == NULL)
1073 return new_env;
1074
1075 /* See if this string duplicates any string already in the env.
1076 If so, don't put it in.
1077 When an env var has multiple definitions,
1078 we keep the definition that comes first in process-environment. */
1079 for (ep = env; ok && ep != new_env; ep++)
1080 {
1081 char *p = *ep, *q = string;
1082 while (ok)
19ed11ba
AS
1083 {
1084 if (*q != *p)
1085 break;
1086 if (*q == 0)
1087 /* The string is a lone variable name; keep it for now, we
1088 will remove it later. It is a placeholder for a
1089 variable that is not to be included in the environment. */
1090 break;
1091 if (*q == '=')
1092 ok = 0;
1093 p++, q++;
1094 }
5990851d
KL
1095 }
1096 if (ok)
1097 *new_env++ = string;
1098 return new_env;
1099}
1100
80856e74
JB
1101/* This is the last thing run in a newly forked inferior
1102 either synchronous or asynchronous.
1103 Copy descriptors IN, OUT and ERR as descriptors 0, 1 and 2.
1104 Initialize inferior's priority, pgrp, connected dir and environment.
1105 then exec another program based on new_argv.
1106
1107 This function may change environ for the superior process.
1108 Therefore, the superior process must save and restore the value
1109 of environ around the vfork and the call to this function.
1110
80856e74 1111 SET_PGRP is nonzero if we should put the subprocess into a separate
177c0ea7 1112 process group.
e576cab4
JB
1113
1114 CURRENT_DIR is an elisp string giving the path of the current
1115 directory the subprocess should have. Since we can't really signal
1116 a decent error from within the child, this should be verified as an
1117 executable directory by the parent. */
80856e74 1118
dfcf069d 1119int
971de7fb 1120child_setup (int in, int out, int err, register char **new_argv, int set_pgrp, Lisp_Object current_dir)
80856e74 1121{
e576cab4 1122 char **env;
7fcf7f05 1123 char *pwd_var;
bad95d8f
RS
1124#ifdef WINDOWSNT
1125 int cpid;
4252a4bd 1126 HANDLE handles[3];
bad95d8f 1127#endif /* WINDOWSNT */
e576cab4 1128
33abe2d9 1129 int pid = getpid ();
80856e74 1130
80856e74
JB
1131 /* Close Emacs's descriptors that this process should not have. */
1132 close_process_descs ();
ded80a25 1133
c17c4250
EZ
1134 /* DOS_NT isn't in a vfork, so if we are in the middle of load-file,
1135 we will lose if we call close_load_descs here. */
1136#ifndef DOS_NT
4458cebe 1137 close_load_descs ();
c17c4250 1138#endif
80856e74
JB
1139
1140 /* Note that use of alloca is always safe here. It's obvious for systems
1141 that do not have true vfork or that have true (stack) alloca.
caa01fe0
GM
1142 If using vfork and C_ALLOCA (when Emacs used to include
1143 src/alloca.c) it is safe because that changes the superior's
1144 static variables as if the superior had done alloca and will be
1145 cleaned up in the usual way. */
e576cab4 1146 {
7fcf7f05 1147 register char *temp;
e576cab4 1148 register int i;
77d78be1 1149
d5db4077 1150 i = SBYTES (current_dir);
16425c4a
EZ
1151#ifdef MSDOS
1152 /* MSDOS must have all environment variables malloc'ed, because
1153 low-level libc functions that launch subsidiary processes rely
1154 on that. */
1155 pwd_var = (char *) xmalloc (i + 6);
1156#else
7fcf7f05 1157 pwd_var = (char *) alloca (i + 6);
16425c4a 1158#endif
7fcf7f05 1159 temp = pwd_var + 4;
72af86bd
AS
1160 memcpy (pwd_var, "PWD=", 4);
1161 memcpy (temp, SDATA (current_dir), i);
bad95d8f 1162 if (!IS_DIRECTORY_SEP (temp[i - 1])) temp[i++] = DIRECTORY_SEP;
e576cab4
JB
1163 temp[i] = 0;
1164
c17c4250 1165#ifndef DOS_NT
e576cab4
JB
1166 /* We can't signal an Elisp error here; we're in a vfork. Since
1167 the callers check the current directory before forking, this
1168 should only return an error if the directory's permissions
1169 are changed between the check and this chdir, but we should
1170 at least check. */
1171 if (chdir (temp) < 0)
20b25e46 1172 _exit (errno);
f8d23104 1173#else /* DOS_NT */
c17c4250
EZ
1174 /* Get past the drive letter, so that d:/ is left alone. */
1175 if (i > 2 && IS_DEVICE_SEP (temp[1]) && IS_DIRECTORY_SEP (temp[2]))
1176 {
1177 temp += 2;
1178 i -= 2;
1179 }
f8d23104 1180#endif /* DOS_NT */
c17c4250 1181
7fcf7f05 1182 /* Strip trailing slashes for PWD, but leave "/" and "//" alone. */
bad95d8f 1183 while (i > 2 && IS_DIRECTORY_SEP (temp[i - 1]))
7fcf7f05 1184 temp[--i] = 0;
e576cab4 1185 }
80856e74 1186
5990851d 1187 /* Set `env' to a vector of the strings in the environment. */
80856e74
JB
1188 {
1189 register Lisp_Object tem;
1190 register char **new_env;
5990851d 1191 char **p, **q;
80856e74 1192 register int new_length;
d2bb6598 1193 Lisp_Object display = Qnil;
361358ea 1194
80856e74 1195 new_length = 0;
f105f403 1196
80856e74 1197 for (tem = Vprocess_environment;
19ed11ba
AS
1198 CONSP (tem) && STRINGP (XCAR (tem));
1199 tem = XCDR (tem))
d2bb6598 1200 {
42a5b22f 1201 if (strncmp (SSDATA (XCAR (tem)), "DISPLAY", 7) == 0
d2bb6598
SM
1202 && (SDATA (XCAR (tem)) [7] == '\0'
1203 || SDATA (XCAR (tem)) [7] == '='))
1204 /* DISPLAY is specified in process-environment. */
1205 display = Qt;
1206 new_length++;
1207 }
de87fb59 1208
d2bb6598
SM
1209 /* If not provided yet, use the frame's DISPLAY. */
1210 if (NILP (display))
1211 {
1212 Lisp_Object tmp = Fframe_parameter (selected_frame, Qdisplay);
1213 if (!STRINGP (tmp) && CONSP (Vinitial_environment))
1214 /* If still not found, Look for DISPLAY in Vinitial_environment. */
1215 tmp = Fgetenv_internal (build_string ("DISPLAY"),
1216 Vinitial_environment);
1217 if (STRINGP (tmp))
1218 {
1219 display = tmp;
1220 new_length++;
1221 }
1222 }
80856e74 1223
7fcf7f05
RS
1224 /* new_length + 2 to include PWD and terminating 0. */
1225 env = new_env = (char **) alloca ((new_length + 2) * sizeof (char *));
7fcf7f05
RS
1226 /* If we have a PWD envvar, pass one down,
1227 but with corrected value. */
a13f8f50 1228 if (egetenv ("PWD"))
7fcf7f05 1229 *new_env++ = pwd_var;
361358ea 1230
6b8e474c 1231 if (STRINGP (display))
de87fb59 1232 {
35016e9a 1233 char *vdata = (char *) alloca (sizeof "DISPLAY=" + SBYTES (display));
de87fb59 1234 strcpy (vdata, "DISPLAY=");
42a5b22f 1235 strcat (vdata, SSDATA (display));
de87fb59
DN
1236 new_env = add_env (env, new_env, vdata);
1237 }
80856e74 1238
5990851d 1239 /* Overrides. */
80856e74 1240 for (tem = Vprocess_environment;
70949dac
KR
1241 CONSP (tem) && STRINGP (XCAR (tem));
1242 tem = XCDR (tem))
42a5b22f 1243 new_env = add_env (env, new_env, SSDATA (XCAR (tem)));
d2bb6598 1244
5990851d
KL
1245 *new_env = 0;
1246
1247 /* Remove variable names without values. */
1248 p = q = env;
1249 while (*p != 0)
cd9565ba 1250 {
19ed11ba
AS
1251 while (*q != 0 && strchr (*q, '=') == NULL)
1252 q++;
1253 *p = *q++;
1254 if (*p != 0)
1255 p++;
cd9565ba 1256 }
80856e74 1257 }
de87fb59 1258
361358ea 1259
bad95d8f
RS
1260#ifdef WINDOWSNT
1261 prepare_standard_handles (in, out, err, handles);
d5db4077 1262 set_process_dir (SDATA (current_dir));
67802943
DN
1263 /* Spawn the child. (See ntproc.c:Spawnve). */
1264 cpid = spawnve (_P_NOWAIT, new_argv[0], new_argv, env);
1265 reset_standard_handles (in, out, err, handles);
1266 if (cpid == -1)
1267 /* An error occurred while trying to spawn the process. */
1268 report_file_error ("Spawning child process", Qnil);
1269 return cpid;
1270
bad95d8f 1271#else /* not WINDOWSNT */
426b37ae
JB
1272 /* Make sure that in, out, and err are not actually already in
1273 descriptors zero, one, or two; this could happen if Emacs is
7e6c2178 1274 started with its standard in, out, or error closed, as might
426b37ae 1275 happen under X. */
f29f9e4a
RS
1276 {
1277 int oin = in, oout = out;
1278
1279 /* We have to avoid relocating the same descriptor twice! */
1280
1281 in = relocate_fd (in, 3);
1282
1283 if (out == oin)
1284 out = in;
1285 else
3e9367e7 1286 out = relocate_fd (out, 3);
f29f9e4a
RS
1287
1288 if (err == oin)
1289 err = in;
1290 else if (err == oout)
1291 err = out;
1292 else
3e9367e7 1293 err = relocate_fd (err, 3);
f29f9e4a 1294 }
426b37ae 1295
c17c4250 1296#ifndef MSDOS
68c45bf0
PE
1297 emacs_close (0);
1298 emacs_close (1);
1299 emacs_close (2);
80856e74
JB
1300
1301 dup2 (in, 0);
1302 dup2 (out, 1);
1303 dup2 (err, 2);
68c45bf0 1304 emacs_close (in);
ce8f5a9a
AS
1305 if (out != in)
1306 emacs_close (out);
1307 if (err != in && err != out)
1308 emacs_close (err);
80856e74 1309
58eb6cf0 1310#if defined(USG)
fdba8590 1311#ifndef SETPGRP_RELEASES_CTTY
e576cab4 1312 setpgrp (); /* No arguments but equivalent in this case */
fdba8590 1313#endif
67802943 1314#else /* not USG */
e576cab4 1315 setpgrp (pid, pid);
67802943 1316#endif /* not USG */
80856e74 1317
a7ebc409 1318 /* setpgrp_of_tty is incorrect here; it uses input_fd. */
12e610e8 1319 tcsetpgrp (0, pid);
a7ebc409 1320
80856e74
JB
1321 /* execvp does not accept an environment arg so the only way
1322 to pass this environment is to set environ. Our caller
1323 is responsible for restoring the ambient value of environ. */
1324 environ = env;
1325 execvp (new_argv[0], new_argv);
1326
68c45bf0
PE
1327 emacs_write (1, "Can't exec program: ", 20);
1328 emacs_write (1, new_argv[0], strlen (new_argv[0]));
1329 emacs_write (1, "\n", 1);
80856e74 1330 _exit (1);
67802943
DN
1331
1332#else /* MSDOS */
1333 pid = run_msdos_command (new_argv, pwd_var + 4, in, out, err, env);
1334 xfree (pwd_var);
1335 if (pid == -1)
1336 /* An error occurred while trying to run the subprocess. */
1337 report_file_error ("Spawning child process", Qnil);
1338 return pid;
1339#endif /* MSDOS */
ae76d9e1 1340#endif /* not WINDOWSNT */
80856e74
JB
1341}
1342
361358ea 1343#ifndef WINDOWSNT
a3833dfe 1344/* Move the file descriptor FD so that its number is not less than MINFD.
426b37ae 1345 If the file descriptor is moved at all, the original is freed. */
dfcf069d 1346static int
971de7fb 1347relocate_fd (int fd, int minfd)
426b37ae 1348{
a3833dfe 1349 if (fd >= minfd)
426b37ae
JB
1350 return fd;
1351 else
1352 {
cf237e27
AS
1353 int new;
1354#ifdef F_DUPFD
1355 new = fcntl (fd, F_DUPFD, minfd);
1356#else
1357 new = dup (fd);
1358 if (new != -1)
1359 /* Note that we hold the original FD open while we recurse,
1360 to guarantee we'll get a new FD if we need it. */
1361 new = relocate_fd (new, minfd);
1362#endif
426b37ae
JB
1363 if (new == -1)
1364 {
cb1d0ef7 1365 const char *message_1 = "Error while setting up child: ";
a8fe7202 1366 const char *errmessage = strerror (errno);
cb1d0ef7
PE
1367 const char *message_2 = "\n";
1368 emacs_write (2, message_1, strlen (message_1));
68c45bf0 1369 emacs_write (2, errmessage, strlen (errmessage));
cb1d0ef7 1370 emacs_write (2, message_2, strlen (message_2));
426b37ae
JB
1371 _exit (1);
1372 }
68c45bf0 1373 emacs_close (fd);
426b37ae
JB
1374 return new;
1375 }
1376}
361358ea 1377#endif /* not WINDOWSNT */
426b37ae 1378
012c6fcb 1379static int
989f33ba
PE
1380getenv_internal_1 (const char *var, ptrdiff_t varlen, char **value,
1381 ptrdiff_t *valuelen, Lisp_Object env)
012c6fcb 1382{
db699fc6 1383 for (; CONSP (env); env = XCDR (env))
012c6fcb 1384 {
db699fc6 1385 Lisp_Object entry = XCAR (env);
d50d3dc8 1386 if (STRINGP (entry)
db699fc6 1387 && SBYTES (entry) >= varlen
bad95d8f
RS
1388#ifdef WINDOWSNT
1389 /* NT environment variables are case insensitive. */
d5db4077 1390 && ! strnicmp (SDATA (entry), var, varlen)
bad95d8f 1391#else /* not WINDOWSNT */
72af86bd 1392 && ! memcmp (SDATA (entry), var, varlen)
bad95d8f 1393#endif /* not WINDOWSNT */
a9971c6d 1394 )
012c6fcb 1395 {
db699fc6
SM
1396 if (SBYTES (entry) > varlen && SREF (entry, varlen) == '=')
1397 {
51b59d79 1398 *value = SSDATA (entry) + (varlen + 1);
db699fc6
SM
1399 *valuelen = SBYTES (entry) - (varlen + 1);
1400 return 1;
1401 }
1402 else if (SBYTES (entry) == varlen)
1403 {
1404 /* Lone variable names in Vprocess_environment mean that
1405 variable should be removed from the environment. */
1406 *value = NULL;
1407 return 1;
1408 }
1409 }
1410 }
1411 return 0;
1412}
1413
012c6fcb 1414static int
989f33ba
PE
1415getenv_internal (const char *var, ptrdiff_t varlen, char **value,
1416 ptrdiff_t *valuelen, Lisp_Object frame)
012c6fcb 1417{
d2bb6598
SM
1418 /* Try to find VAR in Vprocess_environment first. */
1419 if (getenv_internal_1 (var, varlen, value, valuelen,
1420 Vprocess_environment))
1421 return *value ? 1 : 0;
f105f403 1422
d2bb6598 1423 /* For DISPLAY try to get the values from the frame or the initial env. */
de87fb59 1424 if (strcmp (var, "DISPLAY") == 0)
d2bb6598
SM
1425 {
1426 Lisp_Object display
1427 = Fframe_parameter (NILP (frame) ? selected_frame : frame, Qdisplay);
1428 if (STRINGP (display))
1429 {
51b59d79 1430 *value = SSDATA (display);
de87fb59 1431 *valuelen = SBYTES (display);
012c6fcb
JA
1432 return 1;
1433 }
d2bb6598
SM
1434 /* If still not found, Look for DISPLAY in Vinitial_environment. */
1435 if (getenv_internal_1 (var, varlen, value, valuelen,
1436 Vinitial_environment))
1437 return *value ? 1 : 0;
012c6fcb
JA
1438 }
1439
1440 return 0;
1441}
1442
f105f403 1443DEFUN ("getenv-internal", Fgetenv_internal, Sgetenv_internal, 1, 2, 0,
5990851d
KL
1444 doc: /* Get the value of environment variable VARIABLE.
1445VARIABLE should be a string. Value is nil if VARIABLE is undefined in
1446the environment. Otherwise, value is a string.
f105f403 1447
acf20901 1448This function searches `process-environment' for VARIABLE.
5990851d 1449
db699fc6 1450If optional parameter ENV is a list, then search this list instead of
acf20901
JB
1451`process-environment', and return t when encountering a negative entry
1452\(an entry for a variable with no value). */)
5842a27b 1453 (Lisp_Object variable, Lisp_Object env)
012c6fcb
JA
1454{
1455 char *value;
989f33ba 1456 ptrdiff_t valuelen;
012c6fcb 1457
5990851d 1458 CHECK_STRING (variable);
db699fc6
SM
1459 if (CONSP (env))
1460 {
42a5b22f 1461 if (getenv_internal_1 (SSDATA (variable), SBYTES (variable),
db699fc6
SM
1462 &value, &valuelen, env))
1463 return value ? make_string (value, valuelen) : Qt;
1464 else
1465 return Qnil;
1466 }
42a5b22f 1467 else if (getenv_internal (SSDATA (variable), SBYTES (variable),
d2bb6598 1468 &value, &valuelen, env))
012c6fcb
JA
1469 return make_string (value, valuelen);
1470 else
1471 return Qnil;
1472}
1473
5990851d
KL
1474/* A version of getenv that consults the Lisp environment lists,
1475 easily callable from C. */
012c6fcb 1476char *
a8fe7202 1477egetenv (const char *var)
012c6fcb
JA
1478{
1479 char *value;
25c7e41f 1480 ptrdiff_t valuelen;
012c6fcb 1481
f105f403 1482 if (getenv_internal (var, strlen (var), &value, &valuelen, Qnil))
012c6fcb
JA
1483 return value;
1484 else
1485 return 0;
1486}
1487
80856e74 1488\f
8de15d69 1489/* This is run before init_cmdargs. */
177c0ea7 1490
dfcf069d 1491void
971de7fb 1492init_callproc_1 (void)
8de15d69
RS
1493{
1494 char *data_dir = egetenv ("EMACSDATA");
35a2f4b8
KH
1495 char *doc_dir = egetenv ("EMACSDOC");
1496
8de15d69 1497 Vdata_directory
177c0ea7 1498 = Ffile_name_as_directory (build_string (data_dir ? data_dir
8de15d69 1499 : PATH_DATA));
35a2f4b8
KH
1500 Vdoc_directory
1501 = Ffile_name_as_directory (build_string (doc_dir ? doc_dir
1502 : PATH_DOC));
9453ea7b 1503
e576cab4 1504 /* Check the EMACSPATH environment variable, defaulting to the
57bda87a 1505 PATH_EXEC path from epaths.h. */
e576cab4 1506 Vexec_path = decode_env_path ("EMACSPATH", PATH_EXEC);
80856e74
JB
1507 Vexec_directory = Ffile_name_as_directory (Fcar (Vexec_path));
1508 Vexec_path = nconc2 (decode_env_path ("PATH", ""), Vexec_path);
8de15d69
RS
1509}
1510
e17f7533 1511/* This is run after init_cmdargs, when Vinstallation_directory is valid. */
8de15d69 1512
dfcf069d 1513void
971de7fb 1514init_callproc (void)
8de15d69
RS
1515{
1516 char *data_dir = egetenv ("EMACSDATA");
177c0ea7 1517
8de15d69
RS
1518 register char * sh;
1519 Lisp_Object tempdir;
1520
9cc4fad5 1521 if (!NILP (Vinstallation_directory))
8de15d69 1522 {
05630743
RS
1523 /* Add to the path the lib-src subdir of the installation dir. */
1524 Lisp_Object tem;
1525 tem = Fexpand_file_name (build_string ("lib-src"),
1526 Vinstallation_directory);
bad95d8f 1527#ifndef DOS_NT
1a6640ec 1528 /* MSDOS uses wrapped binaries, so don't do this. */
0fa248bc 1529 if (NILP (Fmember (tem, Vexec_path)))
70ec1377
RS
1530 {
1531 Vexec_path = decode_env_path ("EMACSPATH", PATH_EXEC);
1532 Vexec_path = Fcons (tem, Vexec_path);
1533 Vexec_path = nconc2 (decode_env_path ("PATH", ""), Vexec_path);
1534 }
177c0ea7 1535
0fa248bc 1536 Vexec_directory = Ffile_name_as_directory (tem);
bad95d8f 1537#endif /* not DOS_NT */
8de15d69 1538
e17f7533
RS
1539 /* Maybe use ../etc as well as ../lib-src. */
1540 if (data_dir == 0)
1541 {
1542 tem = Fexpand_file_name (build_string ("etc"),
1543 Vinstallation_directory);
1544 Vdoc_directory = Ffile_name_as_directory (tem);
8de15d69
RS
1545 }
1546 }
7e933683
RS
1547
1548 /* Look for the files that should be in etc. We don't use
1549 Vinstallation_directory, because these files are never installed
e17f7533 1550 near the executable, and they are never in the build
7e933683
RS
1551 directory when that's different from the source directory.
1552
1553 Instead, if these files are not in the nominal place, we try the
1554 source directory. */
1555 if (data_dir == 0)
1556 {
70ec1377 1557 Lisp_Object tem, tem1, srcdir;
7e933683 1558
70ec1377
RS
1559 srcdir = Fexpand_file_name (build_string ("../src/"),
1560 build_string (PATH_DUMPLOADSEARCH));
7e933683
RS
1561 tem = Fexpand_file_name (build_string ("GNU"), Vdata_directory);
1562 tem1 = Ffile_exists_p (tem);
70ec1377 1563 if (!NILP (Fequal (srcdir, Vinvocation_directory)) || NILP (tem1))
7e933683 1564 {
70ec1377 1565 Lisp_Object newdir;
7e933683
RS
1566 newdir = Fexpand_file_name (build_string ("../etc/"),
1567 build_string (PATH_DUMPLOADSEARCH));
1568 tem = Fexpand_file_name (build_string ("GNU"), newdir);
1569 tem1 = Ffile_exists_p (tem);
1570 if (!NILP (tem1))
1571 Vdata_directory = newdir;
1572 }
1573 }
80856e74 1574
d883eb62
RS
1575#ifndef CANNOT_DUMP
1576 if (initialized)
1577#endif
1578 {
1579 tempdir = Fdirectory_file_name (Vexec_directory);
42a5b22f 1580 if (access (SSDATA (tempdir), 0) < 0)
d883eb62
RS
1581 dir_warning ("Warning: arch-dependent data dir (%s) does not exist.\n",
1582 Vexec_directory);
1583 }
80856e74 1584
e576cab4 1585 tempdir = Fdirectory_file_name (Vdata_directory);
42a5b22f 1586 if (access (SSDATA (tempdir), 0) < 0)
76d5c6cf
RS
1587 dir_warning ("Warning: arch-independent data dir (%s) does not exist.\n",
1588 Vdata_directory);
e576cab4 1589
e576cab4 1590 sh = (char *) getenv ("SHELL");
80856e74 1591 Vshell_file_name = build_string (sh ? sh : "/bin/sh");
8abd035b 1592
40b49d4b
JB
1593#ifdef DOS_NT
1594 Vshared_game_score_directory = Qnil;
1595#else
63789758
RS
1596 Vshared_game_score_directory = build_string (PATH_GAME);
1597 if (NILP (Ffile_directory_p (Vshared_game_score_directory)))
1598 Vshared_game_score_directory = Qnil;
40b49d4b 1599#endif
9fefd2ba
JB
1600}
1601
dfcf069d 1602void
971de7fb 1603set_initial_environment (void)
9fefd2ba 1604{
738db178
DN
1605 char **envp;
1606 for (envp = environ; *envp; envp++)
1607 Vprocess_environment = Fcons (build_string (*envp),
1608 Vprocess_environment);
1609 /* Ideally, the `copy' shouldn't be necessary, but it seems it's frequent
1610 to use `delete' and friends on process-environment. */
1611 Vinitial_environment = Fcopy_sequence (Vprocess_environment);
80856e74
JB
1612}
1613
dfcf069d 1614void
971de7fb 1615syms_of_callproc (void)
80856e74 1616{
f92d51d8
CY
1617#ifndef DOS_NT
1618 Vtemp_file_name_pattern = build_string ("emacsXXXXXX");
1619#elif defined (WINDOWSNT)
1620 Vtemp_file_name_pattern = build_string ("emXXXXXX");
1621#else
1622 Vtemp_file_name_pattern = build_string ("detmp.XXX");
1623#endif
1624 staticpro (&Vtemp_file_name_pattern);
1625
29208e82 1626 DEFVAR_LISP ("shell-file-name", Vshell_file_name,
fdb82f93 1627 doc: /* *File name to load inferior shells from.
b20b29be
EZ
1628Initialized from the SHELL environment variable, or to a system-dependent
1629default if SHELL is not set. */);
80856e74 1630
29208e82 1631 DEFVAR_LISP ("exec-path", Vexec_path,
fdb82f93
PJ
1632 doc: /* *List of directories to search programs to run in subprocesses.
1633Each element is a string (directory name) or nil (try default directory). */);
80856e74 1634
29208e82 1635 DEFVAR_LISP ("exec-suffixes", Vexec_suffixes,
fdb82f93
PJ
1636 doc: /* *List of suffixes to try to find executable file names.
1637Each element is a string. */);
33d5af99 1638 Vexec_suffixes = Qnil;
b81a1b72 1639
29208e82 1640 DEFVAR_LISP ("exec-directory", Vexec_directory,
fdb82f93
PJ
1641 doc: /* Directory for executables for Emacs to invoke.
1642More generally, this includes any architecture-dependent files
1643that are built and installed from the Emacs distribution. */);
e576cab4 1644
29208e82 1645 DEFVAR_LISP ("data-directory", Vdata_directory,
fdb82f93
PJ
1646 doc: /* Directory of machine-independent files that come with GNU Emacs.
1647These are files intended for Emacs to use while it runs. */);
80856e74 1648
29208e82 1649 DEFVAR_LISP ("doc-directory", Vdoc_directory,
fdb82f93 1650 doc: /* Directory containing the DOC file that comes with GNU Emacs.
ebf24b59 1651This is usually the same as `data-directory'. */);
35a2f4b8 1652
29208e82 1653 DEFVAR_LISP ("configure-info-directory", Vconfigure_info_directory,
fdb82f93
PJ
1654 doc: /* For internal use by the build procedure only.
1655This is the name of the directory in which the build procedure installed
ebf24b59 1656Emacs's info files; the default value for `Info-default-directory-list'
fdb82f93 1657includes this. */);
ed61592a
JB
1658 Vconfigure_info_directory = build_string (PATH_INFO);
1659
29208e82 1660 DEFVAR_LISP ("shared-game-score-directory", Vshared_game_score_directory,
b065672a
CW
1661 doc: /* Directory of score files for games which come with GNU Emacs.
1662If this variable is nil, then Emacs is unable to use a shared directory. */);
40b49d4b
JB
1663#ifdef DOS_NT
1664 Vshared_game_score_directory = Qnil;
1665#else
63789758 1666 Vshared_game_score_directory = build_string (PATH_GAME);
40b49d4b 1667#endif
b065672a 1668
29208e82 1669 DEFVAR_LISP ("initial-environment", Vinitial_environment,
6b8e474c
SM
1670 doc: /* List of environment variables inherited from the parent process.
1671Each element should be a string of the form ENVVARNAME=VALUE.
1672The elements must normally be decoded (using `locale-coding-system') for use. */);
1673 Vinitial_environment = Qnil;
1674
29208e82 1675 DEFVAR_LISP ("process-environment", Vprocess_environment,
5990851d 1676 doc: /* List of overridden environment variables for subprocesses to inherit.
fdb82f93 1677Each element should be a string of the form ENVVARNAME=VALUE.
5990851d 1678
a13f8f50
KL
1679Entries in this list take precedence to those in the frame-local
1680environments. Therefore, let-binding `process-environment' is an easy
1681way to temporarily change the value of an environment variable,
1682irrespective of where it comes from. To use `process-environment' to
1683remove an environment variable, include only its name in the list,
1684without "=VALUE".
5990851d
KL
1685
1686This variable is set to nil when Emacs starts.
1687
fdb82f93
PJ
1688If multiple entries define the same variable, the first one always
1689takes precedence.
5990851d 1690
776a24a1 1691Non-ASCII characters are encoded according to the initial value of
5990851d
KL
1692`locale-coding-system', i.e. the elements must normally be decoded for
1693use.
1694
776a24a1 1695See `setenv' and `getenv'. */);
86f5ca04 1696 Vprocess_environment = Qnil;
80856e74 1697
80856e74 1698 defsubr (&Scall_process);
83fa009c 1699 defsubr (&Sgetenv_internal);
e576cab4 1700 defsubr (&Scall_process_region);
80856e74 1701}