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