1 /* Synchronous subprocess invocation for GNU Emacs.
2 Copyright (C) 1985, 1986, 1987, 1988, 1993, 1994, 1995, 1999, 2000, 2001,
3 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
32 /* Define SIGCHLD as an alias for SIGCLD. */
34 #if !defined (SIGCHLD) && defined (SIGCLD)
35 #define SIGCHLD SIGCLD
38 #include <sys/types.h>
46 #define INCLUDED_FCNTL
53 #include <stdlib.h> /* for proper declaration of environ */
56 #define _P_NOWAIT 1 /* from process.h */
59 #ifdef MSDOS /* Demacs 1.1.1 91/10/16 HIRANO Satoshi */
60 #define INCLUDED_FCNTL
63 #include <sys/param.h>
81 #include "composite.h"
84 #include "syssignal.h"
86 #include "blockinput.h"
88 #include "termhooks.h"
95 extern noshare
char **environ
;
98 extern char **environ
;
103 #if !defined (USG) || defined (BSD_PGRPS)
105 #define setpgrp setpgid
109 Lisp_Object Vexec_path
, Vexec_directory
, Vexec_suffixes
;
110 Lisp_Object Vdata_directory
, Vdoc_directory
;
111 Lisp_Object Vconfigure_info_directory
, Vshared_game_score_directory
;
112 Lisp_Object Vtemp_file_name_pattern
;
114 Lisp_Object Vshell_file_name
;
116 Lisp_Object Vglobal_environment
;
117 Lisp_Object Vprocess_environment
;
120 Lisp_Object Qbuffer_file_type
;
123 /* True iff we are about to fork off a synchronous process or if we
124 are waiting for it. */
125 int synch_process_alive
;
127 /* Nonzero => this is a string explaining death of synchronous subprocess. */
128 char *synch_process_death
;
130 /* Nonzero => this is the signal number that terminated the subprocess. */
131 int synch_process_termsig
;
133 /* If synch_process_death is zero,
134 this is exit code of synchronous subprocess. */
135 int synch_process_retcode
;
137 /* List of environment variables to look up in emacsclient. */
138 Lisp_Object Vlocal_environment_variables
;
141 /* Clean up when exiting Fcall_process.
142 On MSDOS, delete the temporary file on any kind of termination.
143 On Unix, kill the process and any children on termination by signal. */
145 /* Nonzero if this is termination due to exit. */
146 static int call_process_exited
;
148 #ifndef VMS /* VMS version is in vmsproc.c. */
151 call_process_kill (fdpid
)
154 emacs_close (XFASTINT (Fcar (fdpid
)));
155 EMACS_KILLPG (XFASTINT (Fcdr (fdpid
)), SIGKILL
);
156 synch_process_alive
= 0;
161 call_process_cleanup (fdpid
)
164 #if defined (MSDOS) || defined (MAC_OS8)
165 /* for MSDOS fdpid is really (fd . tempfile) */
166 register Lisp_Object file
;
168 emacs_close (XFASTINT (Fcar (fdpid
)));
169 if (strcmp (SDATA (file
), NULL_DEVICE
) != 0)
170 unlink (SDATA (file
));
171 #else /* not MSDOS and not MAC_OS8 */
172 register int pid
= XFASTINT (Fcdr (fdpid
));
174 if (call_process_exited
)
176 emacs_close (XFASTINT (Fcar (fdpid
)));
180 if (EMACS_KILLPG (pid
, SIGINT
) == 0)
182 int count
= SPECPDL_INDEX ();
183 record_unwind_protect (call_process_kill
, fdpid
);
184 message1 ("Waiting for process to die...(type C-g again to kill it instantly)");
187 wait_for_termination (pid
);
189 specpdl_ptr
= specpdl
+ count
; /* Discard the unwind protect. */
190 message1 ("Waiting for process to die...done");
192 synch_process_alive
= 0;
193 emacs_close (XFASTINT (Fcar (fdpid
)));
194 #endif /* not MSDOS */
198 DEFUN ("call-process", Fcall_process
, Scall_process
, 1, MANY
, 0,
199 doc
: /* Call PROGRAM synchronously in separate process.
200 The remaining arguments are optional.
201 The program's input comes from file INFILE (nil means `/dev/null').
202 Insert output in BUFFER before point; t means current buffer;
203 nil for BUFFER means discard it; 0 means discard and don't wait.
204 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
205 REAL-BUFFER says what to do with standard output, as above,
206 while STDERR-FILE says what to do with standard error in the child.
207 STDERR-FILE may be nil (discard standard error output),
208 t (mix it with ordinary output), or a file name string.
210 Fourth arg DISPLAY non-nil means redisplay buffer as output is inserted.
211 Remaining arguments are strings passed as command arguments to PROGRAM.
213 If BUFFER is 0, `call-process' returns immediately with value nil.
214 Otherwise it waits for PROGRAM to terminate
215 and returns a numeric exit status or a signal description string.
216 If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.
218 usage: (call-process PROGRAM &optional INFILE BUFFER DISPLAY &rest ARGS) */)
221 register Lisp_Object
*args
;
223 Lisp_Object infile
, buffer
, current_dir
, path
;
228 #define CALLPROC_BUFFER_SIZE_MIN (16 * 1024)
229 #define CALLPROC_BUFFER_SIZE_MAX (4 * CALLPROC_BUFFER_SIZE_MIN)
230 char buf
[CALLPROC_BUFFER_SIZE_MAX
];
231 int bufsize
= CALLPROC_BUFFER_SIZE_MIN
;
232 int count
= SPECPDL_INDEX ();
234 register const unsigned char **new_argv
235 = (const unsigned char **) alloca ((max (2, nargs
- 2)) * sizeof (char *));
236 struct buffer
*old
= current_buffer
;
237 /* File to use for stderr in the child.
238 t means use same as standard output. */
239 Lisp_Object error_file
;
240 #ifdef MSDOS /* Demacs 1.1.1 91/10/16 HIRANO Satoshi */
241 char *outf
, *tempfile
;
251 struct coding_system process_coding
; /* coding-system of process output */
252 struct coding_system argument_coding
; /* coding-system of arguments */
253 /* Set to the return value of Ffind_operation_coding_system. */
254 Lisp_Object coding_systems
;
256 /* Qt denotes that Ffind_operation_coding_system is not yet called. */
259 CHECK_STRING (args
[0]);
264 /* Without asynchronous processes we cannot have BUFFER == 0. */
266 && (INTEGERP (CONSP (args
[2]) ? XCAR (args
[2]) : args
[2])))
267 error ("Operating system cannot handle asynchronous subprocesses");
268 #endif /* subprocesses */
270 /* Decide the coding-system for giving arguments. */
272 Lisp_Object val
, *args2
;
275 /* If arguments are supplied, we may have to encode them. */
280 for (i
= 4; i
< nargs
; i
++)
281 CHECK_STRING (args
[i
]);
283 for (i
= 4; i
< nargs
; i
++)
284 if (STRING_MULTIBYTE (args
[i
]))
287 if (!NILP (Vcoding_system_for_write
))
288 val
= Vcoding_system_for_write
;
289 else if (! must_encode
)
293 args2
= (Lisp_Object
*) alloca ((nargs
+ 1) * sizeof *args2
);
294 args2
[0] = Qcall_process
;
295 for (i
= 0; i
< nargs
; i
++) args2
[i
+ 1] = args
[i
];
296 coding_systems
= Ffind_operation_coding_system (nargs
+ 1, args2
);
297 if (CONSP (coding_systems
))
298 val
= XCDR (coding_systems
);
299 else if (CONSP (Vdefault_process_coding_system
))
300 val
= XCDR (Vdefault_process_coding_system
);
304 setup_coding_system (Fcheck_coding_system (val
), &argument_coding
);
308 if (nargs
>= 2 && ! NILP (args
[1]))
310 infile
= Fexpand_file_name (args
[1], current_buffer
->directory
);
311 CHECK_STRING (infile
);
314 infile
= build_string (NULL_DEVICE
);
320 /* If BUFFER is a list, its meaning is
321 (BUFFER-FOR-STDOUT FILE-FOR-STDERR). */
324 if (CONSP (XCDR (buffer
)))
326 Lisp_Object stderr_file
;
327 stderr_file
= XCAR (XCDR (buffer
));
329 if (NILP (stderr_file
) || EQ (Qt
, stderr_file
))
330 error_file
= stderr_file
;
332 error_file
= Fexpand_file_name (stderr_file
, Qnil
);
335 buffer
= XCAR (buffer
);
338 if (!(EQ (buffer
, Qnil
)
340 || INTEGERP (buffer
)))
342 Lisp_Object spec_buffer
;
343 spec_buffer
= buffer
;
344 buffer
= Fget_buffer_create (buffer
);
345 /* Mention the buffer name for a better error message. */
347 CHECK_BUFFER (spec_buffer
);
348 CHECK_BUFFER (buffer
);
354 /* Make sure that the child will be able to chdir to the current
355 buffer's current directory, or its unhandled equivalent. We
356 can't just have the child check for an error when it does the
357 chdir, since it's in a vfork.
359 We have to GCPRO around this because Fexpand_file_name,
360 Funhandled_file_name_directory, and Ffile_accessible_directory_p
361 might call a file name handling function. The argument list is
362 protected by the caller, so all we really have to worry about is
365 struct gcpro gcpro1
, gcpro2
, gcpro3
;
367 current_dir
= current_buffer
->directory
;
369 GCPRO3 (infile
, buffer
, current_dir
);
372 = expand_and_dir_to_file (Funhandled_file_name_directory (current_dir
),
374 if (NILP (Ffile_accessible_directory_p (current_dir
)))
375 report_file_error ("Setting current directory",
376 Fcons (current_buffer
->directory
, Qnil
));
381 display_p
= INTERACTIVE
&& nargs
>= 4 && !NILP (args
[3]);
383 filefd
= emacs_open (SDATA (infile
), O_RDONLY
, 0);
386 report_file_error ("Opening process input file", Fcons (infile
, Qnil
));
388 /* Search for program; barf if not found. */
392 GCPRO1 (current_dir
);
393 openp (Vexec_path
, args
[0], Vexec_suffixes
, &path
, make_number (X_OK
));
398 emacs_close (filefd
);
399 report_file_error ("Searching for program", Fcons (args
[0], Qnil
));
402 /* If program file name starts with /: for quoting a magic name,
404 if (SBYTES (path
) > 2 && SREF (path
, 0) == '/'
405 && SREF (path
, 1) == ':')
406 path
= Fsubstring (path
, make_number (2), Qnil
);
408 new_argv
[0] = SDATA (path
);
412 struct gcpro gcpro1
, gcpro2
, gcpro3
;
414 GCPRO3 (infile
, buffer
, current_dir
);
415 argument_coding
.dst_multibyte
= 0;
416 for (i
= 4; i
< nargs
; i
++)
418 argument_coding
.src_multibyte
= STRING_MULTIBYTE (args
[i
]);
419 if (CODING_REQUIRE_ENCODING (&argument_coding
))
421 /* We must encode this argument. */
422 args
[i
] = encode_coding_string (args
[i
], &argument_coding
, 1);
423 if (argument_coding
.type
== coding_type_ccl
)
424 setup_ccl_program (&(argument_coding
.spec
.ccl
.encoder
), Qnil
);
426 new_argv
[i
- 3] = SDATA (args
[i
]);
429 new_argv
[nargs
- 3] = 0;
434 #ifdef MSDOS /* MW, July 1993 */
435 if ((outf
= egetenv ("TMPDIR")))
436 strcpy (tempfile
= alloca (strlen (outf
) + 20), outf
);
439 tempfile
= alloca (20);
442 dostounix_filename (tempfile
);
443 if (*tempfile
== '\0' || tempfile
[strlen (tempfile
) - 1] != '/')
444 strcat (tempfile
, "/");
445 strcat (tempfile
, "detmp.XXX");
448 outfilefd
= creat (tempfile
, S_IREAD
| S_IWRITE
);
451 emacs_close (filefd
);
452 report_file_error ("Opening process output file",
453 Fcons (build_string (tempfile
), Qnil
));
460 /* Since we don't have pipes on the Mac, create a temporary file to
461 hold the output of the subprocess. */
462 tempfile
= (char *) alloca (SBYTES (Vtemp_file_name_pattern
) + 1);
463 bcopy (SDATA (Vtemp_file_name_pattern
), tempfile
,
464 SBYTES (Vtemp_file_name_pattern
) + 1);
468 outfilefd
= creat (tempfile
, S_IREAD
| S_IWRITE
);
472 report_file_error ("Opening process output file",
473 Fcons (build_string (tempfile
), Qnil
));
479 if (INTEGERP (buffer
))
480 fd
[1] = emacs_open (NULL_DEVICE
, O_WRONLY
, 0), fd
[0] = -1;
488 emacs_close (filefd
);
489 report_file_error ("Creating process pipe", Qnil
);
494 /* Replaced by close_process_descs */
495 set_exclusive_use (fd
[0]);
500 /* child_setup must clobber environ in systems with true vfork.
501 Protect it from permanent change. */
502 register char **save_environ
= environ
;
503 register int fd1
= fd
[1];
506 #if 0 /* Some systems don't have sigblock. */
507 mask
= sigblock (sigmask (SIGCHLD
));
510 /* Record that we're about to create a synchronous process. */
511 synch_process_alive
= 1;
513 /* These vars record information from process termination.
514 Clear them now before process can possibly terminate,
515 to avoid timing error if process terminates soon. */
516 synch_process_death
= 0;
517 synch_process_retcode
= 0;
518 synch_process_termsig
= 0;
520 if (NILP (error_file
))
521 fd_error
= emacs_open (NULL_DEVICE
, O_WRONLY
, 0);
522 else if (STRINGP (error_file
))
525 fd_error
= emacs_open (SDATA (error_file
),
526 O_WRONLY
| O_TRUNC
| O_CREAT
| O_TEXT
,
528 #else /* not DOS_NT */
529 fd_error
= creat (SDATA (error_file
), 0666);
530 #endif /* not DOS_NT */
535 emacs_close (filefd
);
543 report_file_error ("Cannot redirect stderr",
544 Fcons ((NILP (error_file
)
545 ? build_string (NULL_DEVICE
) : error_file
),
549 current_dir
= ENCODE_FILE (current_dir
);
553 /* Call run_mac_command in sysdep.c here directly instead of doing
554 a child_setup as for MSDOS and other platforms. Note that this
555 code does not handle passing the environment to the synchronous
557 char *infn
, *outfn
, *errfn
, *currdn
;
559 /* close these files so subprocess can write to them */
561 if (fd_error
!= outfilefd
)
563 fd1
= -1; /* No harm in closing that one! */
565 infn
= SDATA (infile
);
567 if (NILP (error_file
))
569 else if (EQ (Qt
, error_file
))
572 errfn
= SDATA (error_file
);
573 currdn
= SDATA (current_dir
);
574 pid
= run_mac_command (new_argv
, currdn
, infn
, outfn
, errfn
);
576 /* Record that the synchronous process exited and note its
577 termination status. */
578 synch_process_alive
= 0;
579 synch_process_retcode
= pid
;
580 if (synch_process_retcode
< 0) /* means it couldn't be exec'ed */
582 synchronize_system_messages_locale ();
583 synch_process_death
= strerror (errno
);
586 /* Since CRLF is converted to LF within `decode_coding', we can
587 always open a file with binary mode. */
588 fd
[0] = open (tempfile
, O_BINARY
);
593 report_file_error ("Cannot re-open temporary file", Qnil
);
596 #else /* not MAC_OS8 */
597 #ifdef MSDOS /* MW, July 1993 */
598 /* Note that on MSDOS `child_setup' actually returns the child process
599 exit status, not its PID, so we assign it to `synch_process_retcode'
601 pid
= child_setup (filefd
, outfilefd
, fd_error
, (char **) new_argv
,
604 /* Record that the synchronous process exited and note its
605 termination status. */
606 synch_process_alive
= 0;
607 synch_process_retcode
= pid
;
608 if (synch_process_retcode
< 0) /* means it couldn't be exec'ed */
610 synchronize_system_messages_locale ();
611 synch_process_death
= strerror (errno
);
614 emacs_close (outfilefd
);
615 if (fd_error
!= outfilefd
)
616 emacs_close (fd_error
);
617 fd1
= -1; /* No harm in closing that one! */
618 /* Since CRLF is converted to LF within `decode_coding', we can
619 always open a file with binary mode. */
620 fd
[0] = emacs_open (tempfile
, O_RDONLY
| O_BINARY
, 0);
624 emacs_close (filefd
);
625 report_file_error ("Cannot re-open temporary file", Qnil
);
627 #else /* not MSDOS */
629 pid
= child_setup (filefd
, fd1
, fd_error
, (char **) new_argv
,
631 #else /* not WINDOWSNT */
643 #if defined (USG) && !defined (BSD_PGRPS)
648 child_setup (filefd
, fd1
, fd_error
, (char **) new_argv
,
653 #endif /* not WINDOWSNT */
655 /* The MSDOS case did this already. */
657 emacs_close (fd_error
);
658 #endif /* not MSDOS */
659 #endif /* not MAC_OS8 */
661 environ
= save_environ
;
663 /* Close most of our fd's, but not fd[0]
664 since we will use that to read input from. */
665 emacs_close (filefd
);
666 if (fd1
>= 0 && fd1
!= fd_error
)
674 report_file_error ("Doing vfork", Qnil
);
677 if (INTEGERP (buffer
))
682 /* If Emacs has been built with asynchronous subprocess support,
683 we don't need to do this, I think because it will then have
684 the facilities for handling SIGCHLD. */
685 wait_without_blocking ();
686 #endif /* subprocesses */
690 /* Enable sending signal if user quits below. */
691 call_process_exited
= 0;
693 #if defined(MSDOS) || defined(MAC_OS8)
694 /* MSDOS needs different cleanup information. */
695 record_unwind_protect (call_process_cleanup
,
696 Fcons (make_number (fd
[0]), build_string (tempfile
)));
698 record_unwind_protect (call_process_cleanup
,
699 Fcons (make_number (fd
[0]), make_number (pid
)));
700 #endif /* not MSDOS and not MAC_OS8 */
703 if (BUFFERP (buffer
))
704 Fset_buffer (buffer
);
708 /* If BUFFER is nil, we must read process output once and then
709 discard it, so setup coding system but with nil. */
710 setup_coding_system (Qnil
, &process_coding
);
714 Lisp_Object val
, *args2
;
717 if (!NILP (Vcoding_system_for_read
))
718 val
= Vcoding_system_for_read
;
721 if (EQ (coding_systems
, Qt
))
725 args2
= (Lisp_Object
*) alloca ((nargs
+ 1) * sizeof *args2
);
726 args2
[0] = Qcall_process
;
727 for (i
= 0; i
< nargs
; i
++) args2
[i
+ 1] = args
[i
];
729 = Ffind_operation_coding_system (nargs
+ 1, args2
);
731 if (CONSP (coding_systems
))
732 val
= XCAR (coding_systems
);
733 else if (CONSP (Vdefault_process_coding_system
))
734 val
= XCAR (Vdefault_process_coding_system
);
738 setup_coding_system (Fcheck_coding_system (val
), &process_coding
);
739 /* In unibyte mode, character code conversion should not take
740 place but EOL conversion should. So, setup raw-text or one
741 of the subsidiary according to the information just setup. */
742 if (NILP (current_buffer
->enable_multibyte_characters
)
744 setup_raw_text_coding_system (&process_coding
);
746 process_coding
.src_multibyte
= 0;
747 process_coding
.dst_multibyte
749 ? ! NILP (XBUFFER (buffer
)->enable_multibyte_characters
)
750 : ! NILP (current_buffer
->enable_multibyte_characters
));
760 int display_on_the_fly
= display_p
;
761 struct coding_system saved_coding
;
762 int pt_orig
= PT
, pt_byte_orig
= PT_BYTE
;
765 saved_coding
= process_coding
;
766 if (process_coding
.composing
!= COMPOSITION_DISABLED
)
767 coding_allocate_composition_data (&process_coding
, PT
);
770 /* Repeatedly read until we've filled as much as possible
771 of the buffer size we have. But don't read
772 less than 1024--save that for the next bufferful. */
774 while (nread
< bufsize
- 1024)
776 int this_read
= emacs_read (fd
[0], buf
+ nread
,
784 process_coding
.mode
|= CODING_MODE_LAST_BLOCK
;
789 total_read
+= this_read
;
791 if (display_on_the_fly
)
795 /* Now NREAD is the total amount of data in the buffer. */
800 if (! CODING_MAY_REQUIRE_DECODING (&process_coding
))
801 insert_1_both (buf
, nread
, nread
, 0, 1, 0);
803 { /* We have to decode the input. */
808 size
= decoding_buffer_size (&process_coding
, nread
);
809 decoding_buf
= (char *) xmalloc (size
);
811 /* We can't use the macro CODING_REQUIRE_DETECTION
812 because it always returns nonzero if the coding
813 system requires EOL detection. Here, we have to
814 check only whether or not the coding system
815 requires text-encoding detection. */
816 if (process_coding
.type
== coding_type_undecided
)
818 detect_coding (&process_coding
, buf
, nread
);
819 if (process_coding
.composing
!= COMPOSITION_DISABLED
)
820 /* We have not yet allocated the composition
821 data because the coding type was undecided. */
822 coding_allocate_composition_data (&process_coding
, PT
);
824 if (process_coding
.cmp_data
)
825 process_coding
.cmp_data
->char_offset
= PT
;
827 decode_coding (&process_coding
, buf
, decoding_buf
,
830 if (display_on_the_fly
831 && saved_coding
.type
== coding_type_undecided
832 && process_coding
.type
!= coding_type_undecided
)
834 /* We have detected some coding system. But,
835 there's a possibility that the detection was
836 done by insufficient data. So, we try the code
837 detection again with more data. */
838 xfree (decoding_buf
);
839 display_on_the_fly
= 0;
840 process_coding
= saved_coding
;
842 /* This is to make the above condition always
843 fails in the future. */
844 saved_coding
.type
= coding_type_no_conversion
;
848 if (process_coding
.produced
> 0)
849 insert_1_both (decoding_buf
, process_coding
.produced_char
,
850 process_coding
.produced
, 0, 1, 0);
851 xfree (decoding_buf
);
853 if (process_coding
.result
== CODING_FINISH_INCONSISTENT_EOL
)
855 Lisp_Object eol_type
, coding
;
857 if (process_coding
.eol_type
== CODING_EOL_CR
)
859 /* CRs have been replaced with LFs. Undo
860 that in the text inserted above. */
863 move_gap_both (PT
, PT_BYTE
);
865 p
= BYTE_POS_ADDR (pt_byte_orig
);
866 for (; p
< GPT_ADDR
; ++p
)
870 else if (process_coding
.eol_type
== CODING_EOL_CRLF
)
872 /* CR LFs have been replaced with LFs. Undo
873 that by inserting CRs in front of LFs in
874 the text inserted above. */
875 EMACS_INT bytepos
, old_pt
, old_pt_byte
, nCR
;
878 old_pt_byte
= PT_BYTE
;
881 for (bytepos
= PT_BYTE
- 1;
882 bytepos
>= pt_byte_orig
;
884 if (FETCH_BYTE (bytepos
) == '\n')
886 EMACS_INT charpos
= BYTE_TO_CHAR (bytepos
);
887 TEMP_SET_PT_BOTH (charpos
, bytepos
);
888 insert_1_both ("\r", 1, 1, 0, 1, 0);
892 TEMP_SET_PT_BOTH (old_pt
+ nCR
, old_pt_byte
+ nCR
);
895 /* Set the coding system symbol to that for
897 eol_type
= Fget (saved_coding
.symbol
, Qeol_type
);
898 if (VECTORP (eol_type
)
899 && ASIZE (eol_type
) == 3
900 && SYMBOLP (AREF (eol_type
, CODING_EOL_LF
)))
901 coding
= AREF (eol_type
, CODING_EOL_LF
);
903 coding
= saved_coding
.symbol
;
905 process_coding
.symbol
= coding
;
906 process_coding
.eol_type
= CODING_EOL_LF
;
908 &= ~CODING_MODE_INHIBIT_INCONSISTENT_EOL
;
911 nread
-= process_coding
.consumed
;
914 /* As CARRYOVER should not be that large, we had
915 better avoid overhead of bcopy. */
916 BCOPY_SHORT (buf
+ process_coding
.consumed
, buf
,
918 if (process_coding
.result
== CODING_FINISH_INSUFFICIENT_CMP
)
920 /* The decoding ended because of insufficient data
921 area to record information about composition.
922 We must try decoding with additional data area
923 before reading more output for the process. */
924 coding_allocate_composition_data (&process_coding
, PT
);
925 goto repeat_decoding
;
930 if (process_coding
.mode
& CODING_MODE_LAST_BLOCK
)
933 #if (CALLPROC_BUFFER_SIZE_MIN != CALLPROC_BUFFER_SIZE_MAX)
934 /* Make the buffer bigger as we continue to read more data,
935 but not past CALLPROC_BUFFER_SIZE_MAX. */
936 if (bufsize
< CALLPROC_BUFFER_SIZE_MAX
&& total_read
> 32 * bufsize
)
937 if ((bufsize
*= 2) > CALLPROC_BUFFER_SIZE_MAX
)
938 bufsize
= CALLPROC_BUFFER_SIZE_MAX
;
944 prepare_menu_bars ();
946 redisplay_preserve_echo_area (1);
947 /* This variable might have been set to 0 for code
948 detection. In that case, we set it back to 1 because
949 we should have already detected a coding system. */
950 display_on_the_fly
= 1;
958 && process_coding
.cmp_data
)
960 coding_restore_composition (&process_coding
, Fcurrent_buffer ());
961 coding_free_composition_data (&process_coding
);
965 int post_read_count
= SPECPDL_INDEX ();
967 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
968 inserted
= PT
- pt_orig
;
969 TEMP_SET_PT_BOTH (pt_orig
, pt_byte_orig
);
970 if (SYMBOLP (process_coding
.post_read_conversion
)
971 && !NILP (Ffboundp (process_coding
.post_read_conversion
)))
972 call1 (process_coding
.post_read_conversion
, make_number (inserted
));
974 Vlast_coding_system_used
= process_coding
.symbol
;
976 /* If the caller required, let the buffer inherit the
977 coding-system used to decode the process output. */
978 if (inherit_process_coding_system
)
979 call1 (intern ("after-insert-file-set-buffer-file-coding-system"),
980 make_number (total_read
));
982 unbind_to (post_read_count
, Qnil
);
986 /* Wait for it to terminate, unless it already has. */
987 wait_for_termination (pid
);
991 set_buffer_internal (old
);
993 /* Don't kill any children that the subprocess may have left behind
995 call_process_exited
= 1;
997 unbind_to (count
, Qnil
);
999 if (synch_process_termsig
)
1003 synchronize_system_messages_locale ();
1004 signame
= strsignal (synch_process_termsig
);
1007 signame
= "unknown";
1009 synch_process_death
= signame
;
1012 if (synch_process_death
)
1013 return code_convert_string_norecord (build_string (synch_process_death
),
1014 Vlocale_coding_system
, 0);
1015 return make_number (synch_process_retcode
);
1020 delete_temp_file (name
)
1023 /* Use Fdelete_file (indirectly) because that runs a file name handler.
1024 We did that when writing the file, so we should do so when deleting. */
1025 internal_delete_file (name
);
1029 DEFUN ("call-process-region", Fcall_process_region
, Scall_process_region
,
1031 doc
: /* Send text from START to END to a synchronous process running PROGRAM.
1032 The remaining arguments are optional.
1033 Delete the text if fourth arg DELETE is non-nil.
1035 Insert output in BUFFER before point; t means current buffer;
1036 nil for BUFFER means discard it; 0 means discard and don't wait.
1037 BUFFER can also have the form (REAL-BUFFER STDERR-FILE); in that case,
1038 REAL-BUFFER says what to do with standard output, as above,
1039 while STDERR-FILE says what to do with standard error in the child.
1040 STDERR-FILE may be nil (discard standard error output),
1041 t (mix it with ordinary output), or a file name string.
1043 Sixth arg DISPLAY non-nil means redisplay buffer as output is inserted.
1044 Remaining args are passed to PROGRAM at startup as command args.
1046 If BUFFER is 0, `call-process-region' returns immediately with value nil.
1047 Otherwise it waits for PROGRAM to terminate
1048 and returns a numeric exit status or a signal description string.
1049 If you quit, the process is killed with SIGINT, or SIGKILL if you quit again.
1051 usage: (call-process-region START END PROGRAM &optional DELETE BUFFER DISPLAY &rest ARGS) */)
1054 register Lisp_Object
*args
;
1056 struct gcpro gcpro1
;
1057 Lisp_Object filename_string
;
1058 register Lisp_Object start
, end
;
1059 int count
= SPECPDL_INDEX ();
1060 /* Qt denotes we have not yet called Ffind_operation_coding_system. */
1061 Lisp_Object coding_systems
;
1062 Lisp_Object val
, *args2
;
1068 if ((outf
= egetenv ("TMPDIR"))
1069 || (outf
= egetenv ("TMP"))
1070 || (outf
= egetenv ("TEMP")))
1071 strcpy (tempfile
= alloca (strlen (outf
) + 20), outf
);
1074 tempfile
= alloca (20);
1077 if (!IS_DIRECTORY_SEP (tempfile
[strlen (tempfile
) - 1]))
1078 strcat (tempfile
, "/");
1079 if ('/' == DIRECTORY_SEP
)
1080 dostounix_filename (tempfile
);
1082 unixtodos_filename (tempfile
);
1084 strcat (tempfile
, "emXXXXXX");
1086 strcat (tempfile
, "detmp.XXX");
1088 #else /* not DOS_NT */
1089 char *tempfile
= (char *) alloca (SBYTES (Vtemp_file_name_pattern
) + 1);
1090 bcopy (SDATA (Vtemp_file_name_pattern
), tempfile
,
1091 SBYTES (Vtemp_file_name_pattern
) + 1);
1092 #endif /* not DOS_NT */
1094 coding_systems
= Qt
;
1098 int fd
= mkstemp (tempfile
);
1100 report_file_error ("Failed to open temporary file",
1101 Fcons (Vtemp_file_name_pattern
, Qnil
));
1109 filename_string
= build_string (tempfile
);
1110 GCPRO1 (filename_string
);
1113 /* Decide coding-system of the contents of the temporary file. */
1114 if (!NILP (Vcoding_system_for_write
))
1115 val
= Vcoding_system_for_write
;
1116 else if (NILP (current_buffer
->enable_multibyte_characters
))
1120 args2
= (Lisp_Object
*) alloca ((nargs
+ 1) * sizeof *args2
);
1121 args2
[0] = Qcall_process_region
;
1122 for (i
= 0; i
< nargs
; i
++) args2
[i
+ 1] = args
[i
];
1123 coding_systems
= Ffind_operation_coding_system (nargs
+ 1, args2
);
1124 if (CONSP (coding_systems
))
1125 val
= XCDR (coding_systems
);
1126 else if (CONSP (Vdefault_process_coding_system
))
1127 val
= XCDR (Vdefault_process_coding_system
);
1133 int count1
= SPECPDL_INDEX ();
1135 specbind (intern ("coding-system-for-write"), val
);
1136 Fwrite_region (start
, end
, filename_string
, Qnil
, Qlambda
, Qnil
, Qnil
);
1138 unbind_to (count1
, Qnil
);
1141 /* Note that Fcall_process takes care of binding
1142 coding-system-for-read. */
1144 record_unwind_protect (delete_temp_file
, filename_string
);
1146 if (nargs
> 3 && !NILP (args
[3]))
1147 Fdelete_region (start
, end
);
1159 args
[1] = filename_string
;
1161 RETURN_UNGCPRO (unbind_to (count
, Fcall_process (nargs
, args
)));
1164 #ifndef VMS /* VMS version is in vmsproc.c. */
1166 static int relocate_fd ();
1169 add_env (char **env
, char **new_env
, char *string
)
1176 /* See if this string duplicates any string already in the env.
1177 If so, don't put it in.
1178 When an env var has multiple definitions,
1179 we keep the definition that comes first in process-environment. */
1180 for (ep
= env
; ok
&& ep
!= new_env
; ep
++)
1182 char *p
= *ep
, *q
= string
;
1188 /* The string is a lone variable name; keep it for now, we
1189 will remove it later. It is a placeholder for a
1190 variable that is not to be included in the environment. */
1198 *new_env
++ = string
;
1202 /* This is the last thing run in a newly forked inferior
1203 either synchronous or asynchronous.
1204 Copy descriptors IN, OUT and ERR as descriptors 0, 1 and 2.
1205 Initialize inferior's priority, pgrp, connected dir and environment.
1206 then exec another program based on new_argv.
1208 This function may change environ for the superior process.
1209 Therefore, the superior process must save and restore the value
1210 of environ around the vfork and the call to this function.
1212 SET_PGRP is nonzero if we should put the subprocess into a separate
1215 CURRENT_DIR is an elisp string giving the path of the current
1216 directory the subprocess should have. Since we can't really signal
1217 a decent error from within the child, this should be verified as an
1218 executable directory by the parent. */
1221 child_setup (in
, out
, err
, new_argv
, set_pgrp
, current_dir
)
1223 register char **new_argv
;
1225 Lisp_Object current_dir
;
1232 #endif /* WINDOWSNT */
1234 int pid
= getpid ();
1236 #ifdef SET_EMACS_PRIORITY
1238 extern EMACS_INT emacs_priority
;
1240 if (emacs_priority
< 0)
1241 nice (- emacs_priority
);
1246 /* Close Emacs's descriptors that this process should not have. */
1247 close_process_descs ();
1249 /* DOS_NT isn't in a vfork, so if we are in the middle of load-file,
1250 we will lose if we call close_load_descs here. */
1252 close_load_descs ();
1255 /* Note that use of alloca is always safe here. It's obvious for systems
1256 that do not have true vfork or that have true (stack) alloca.
1257 If using vfork and C_ALLOCA it is safe because that changes
1258 the superior's static variables as if the superior had done alloca
1259 and will be cleaned up in the usual way. */
1261 register char *temp
;
1264 i
= SBYTES (current_dir
);
1266 /* MSDOS must have all environment variables malloc'ed, because
1267 low-level libc functions that launch subsidiary processes rely
1269 pwd_var
= (char *) xmalloc (i
+ 6);
1271 pwd_var
= (char *) alloca (i
+ 6);
1274 bcopy ("PWD=", pwd_var
, 4);
1275 bcopy (SDATA (current_dir
), temp
, i
);
1276 if (!IS_DIRECTORY_SEP (temp
[i
- 1])) temp
[i
++] = DIRECTORY_SEP
;
1280 /* We can't signal an Elisp error here; we're in a vfork. Since
1281 the callers check the current directory before forking, this
1282 should only return an error if the directory's permissions
1283 are changed between the check and this chdir, but we should
1285 if (chdir (temp
) < 0)
1290 /* Get past the drive letter, so that d:/ is left alone. */
1291 if (i
> 2 && IS_DEVICE_SEP (temp
[1]) && IS_DIRECTORY_SEP (temp
[2]))
1298 /* Strip trailing slashes for PWD, but leave "/" and "//" alone. */
1299 while (i
> 2 && IS_DIRECTORY_SEP (temp
[i
- 1]))
1303 /* Set `env' to a vector of the strings in the environment. */
1305 register Lisp_Object tem
;
1306 register char **new_env
;
1308 register int new_length
;
1309 Lisp_Object environment
= Vglobal_environment
;
1314 for (tem
= Vprocess_environment
;
1315 CONSP (tem
) && STRINGP (XCAR (tem
));
1319 if (!NILP (Vlocal_environment_variables
))
1321 local
= get_frame_param (XFRAME (Fframe_with_environment (selected_frame
)),
1323 if (EQ (Vlocal_environment_variables
, Qt
)
1325 environment
= local
;
1326 else if (CONSP (local
))
1328 new_length
+= Fsafe_length (Vlocal_environment_variables
);
1332 for (tem
= environment
;
1333 CONSP (tem
) && STRINGP (XCAR (tem
));
1337 /* new_length + 2 to include PWD and terminating 0. */
1338 env
= new_env
= (char **) alloca ((new_length
+ 2) * sizeof (char *));
1340 /* If we have a PWD envvar, pass one down,
1341 but with corrected value. */
1343 *new_env
++ = pwd_var
;
1346 for (tem
= Vprocess_environment
;
1347 CONSP (tem
) && STRINGP (XCAR (tem
));
1349 new_env
= add_env (env
, new_env
, SDATA (XCAR (tem
)));
1351 /* Local part of environment, if Vlocal_environment_variables is a list. */
1352 for (tem
= Vlocal_environment_variables
;
1353 CONSP (tem
) && STRINGP (XCAR (tem
));
1355 new_env
= add_env (env
, new_env
, egetenv (SDATA (XCAR (tem
))));
1357 /* The rest of the environment (either Vglobal_environment or the
1358 'environment frame parameter). */
1359 for (tem
= environment
;
1360 CONSP (tem
) && STRINGP (XCAR (tem
));
1362 new_env
= add_env (env
, new_env
, SDATA (XCAR (tem
)));
1366 /* Remove variable names without values. */
1370 while (*q
!= 0 && strchr (*q
, '=') == NULL
)
1378 prepare_standard_handles (in
, out
, err
, handles
);
1379 set_process_dir (SDATA (current_dir
));
1380 #else /* not WINDOWSNT */
1381 /* Make sure that in, out, and err are not actually already in
1382 descriptors zero, one, or two; this could happen if Emacs is
1383 started with its standard in, out, or error closed, as might
1386 int oin
= in
, oout
= out
;
1388 /* We have to avoid relocating the same descriptor twice! */
1390 in
= relocate_fd (in
, 3);
1395 out
= relocate_fd (out
, 3);
1399 else if (err
== oout
)
1402 err
= relocate_fd (err
, 3);
1416 #endif /* not MSDOS */
1417 #endif /* not WINDOWSNT */
1419 #if defined(USG) && !defined(BSD_PGRPS)
1420 #ifndef SETPGRP_RELEASES_CTTY
1421 setpgrp (); /* No arguments but equivalent in this case */
1426 /* setpgrp_of_tty is incorrect here; it uses input_fd. */
1427 EMACS_SET_TTY_PGRP (0, &pid
);
1430 pid
= run_msdos_command (new_argv
, pwd_var
+ 4, in
, out
, err
, env
);
1433 /* An error occurred while trying to run the subprocess. */
1434 report_file_error ("Spawning child process", Qnil
);
1436 #else /* not MSDOS */
1438 /* Spawn the child. (See ntproc.c:Spawnve). */
1439 cpid
= spawnve (_P_NOWAIT
, new_argv
[0], new_argv
, env
);
1440 reset_standard_handles (in
, out
, err
, handles
);
1442 /* An error occurred while trying to spawn the process. */
1443 report_file_error ("Spawning child process", Qnil
);
1445 #else /* not WINDOWSNT */
1446 /* execvp does not accept an environment arg so the only way
1447 to pass this environment is to set environ. Our caller
1448 is responsible for restoring the ambient value of environ. */
1450 execvp (new_argv
[0], new_argv
);
1452 emacs_write (1, "Can't exec program: ", 20);
1453 emacs_write (1, new_argv
[0], strlen (new_argv
[0]));
1454 emacs_write (1, "\n", 1);
1456 #endif /* not WINDOWSNT */
1457 #endif /* not MSDOS */
1460 /* Move the file descriptor FD so that its number is not less than MINFD.
1461 If the file descriptor is moved at all, the original is freed. */
1463 relocate_fd (fd
, minfd
)
1473 char *message1
= "Error while setting up child: ";
1474 char *errmessage
= strerror (errno
);
1475 char *message2
= "\n";
1476 emacs_write (2, message1
, strlen (message1
));
1477 emacs_write (2, errmessage
, strlen (errmessage
));
1478 emacs_write (2, message2
, strlen (message2
));
1481 /* Note that we hold the original FD open while we recurse,
1482 to guarantee we'll get a new FD if we need it. */
1483 new = relocate_fd (new, minfd
);
1490 getenv_internal (var
, varlen
, value
, valuelen
, frame
)
1498 Lisp_Object environment
= Vglobal_environment
;
1500 /* Try to find VAR in Vprocess_environment first. */
1501 for (scan
= Vprocess_environment
; CONSP (scan
); scan
= XCDR (scan
))
1503 Lisp_Object entry
= XCAR (scan
);
1505 && SBYTES (entry
) >= varlen
1507 /* NT environment variables are case insensitive. */
1508 && ! strnicmp (SDATA (entry
), var
, varlen
)
1509 #else /* not WINDOWSNT */
1510 && ! bcmp (SDATA (entry
), var
, varlen
)
1511 #endif /* not WINDOWSNT */
1514 if (SBYTES (entry
) > varlen
&& SREF (entry
, varlen
) == '=')
1516 *value
= (char *) SDATA (entry
) + (varlen
+ 1);
1517 *valuelen
= SBYTES (entry
) - (varlen
+ 1);
1520 else if (SBYTES (entry
) == varlen
)
1522 /* Lone variable names in Vprocess_environment mean that
1523 variable should be removed from the environment. */
1529 /* Find the environment in which to search the variable. */
1532 CHECK_FRAME (frame
);
1533 frame
= Fframe_with_environment (frame
);
1534 Lisp_Object local
= get_frame_param (XFRAME (frame
), Qenvironment
);
1535 /* Use Vglobal_environment if there is no local environment. */
1537 environment
= local
;
1539 else if (!NILP (Vlocal_environment_variables
))
1541 Lisp_Object local
= get_frame_param (XFRAME (Fframe_with_environment (selected_frame
)),
1543 if (EQ (Vlocal_environment_variables
, Qt
)
1545 environment
= local
;
1546 else if (CONSP (local
))
1548 for (scan
= Vlocal_environment_variables
; CONSP (scan
); scan
= XCDR (scan
))
1550 Lisp_Object entry
= XCAR (scan
);
1552 && SBYTES (entry
) == varlen
1554 /* NT environment variables are case insensitive. */
1555 && ! strnicmp (SDATA (entry
), var
, varlen
)
1556 #else /* not WINDOWSNT */
1557 && ! bcmp (SDATA (entry
), var
, varlen
)
1558 #endif /* not WINDOWSNT */
1561 environment
= local
;
1568 for (scan
= environment
; CONSP (scan
); scan
= XCDR (scan
))
1572 entry
= XCAR (scan
);
1574 && SBYTES (entry
) > varlen
1575 && SREF (entry
, varlen
) == '='
1577 /* NT environment variables are case insensitive. */
1578 && ! strnicmp (SDATA (entry
), var
, varlen
)
1579 #else /* not WINDOWSNT */
1580 && ! bcmp (SDATA (entry
), var
, varlen
)
1581 #endif /* not WINDOWSNT */
1584 *value
= (char *) SDATA (entry
) + (varlen
+ 1);
1585 *valuelen
= SBYTES (entry
) - (varlen
+ 1);
1593 DEFUN ("getenv-internal", Fgetenv_internal
, Sgetenv_internal
, 1, 2, 0,
1594 doc
: /* Get the value of environment variable VARIABLE.
1595 VARIABLE should be a string. Value is nil if VARIABLE is undefined in
1596 the environment. Otherwise, value is a string.
1598 If optional parameter FRAME is non-nil, then it should be a frame. If
1599 that frame has its own set of environment variables, this function
1600 will look up VARIABLE in there.
1602 Otherwise, this function searches `process-environment' for VARIABLE.
1603 If it was not found there, then it continues the search in either
1604 `global-environment' or the local environment list of the current
1605 frame, depending on the value of `local-environment-variables'. */)
1607 Lisp_Object variable
, frame
;
1612 CHECK_STRING (variable
);
1613 if (getenv_internal (SDATA (variable
), SBYTES (variable
),
1614 &value
, &valuelen
, frame
))
1615 return make_string (value
, valuelen
);
1620 /* A version of getenv that consults the Lisp environment lists,
1621 easily callable from C. */
1629 if (getenv_internal (var
, strlen (var
), &value
, &valuelen
, Qnil
))
1635 #endif /* not VMS */
1637 /* This is run before init_cmdargs. */
1642 char *data_dir
= egetenv ("EMACSDATA");
1643 char *doc_dir
= egetenv ("EMACSDOC");
1646 = Ffile_name_as_directory (build_string (data_dir
? data_dir
1649 = Ffile_name_as_directory (build_string (doc_dir
? doc_dir
1652 /* Check the EMACSPATH environment variable, defaulting to the
1653 PATH_EXEC path from epaths.h. */
1654 Vexec_path
= decode_env_path ("EMACSPATH", PATH_EXEC
);
1655 Vexec_directory
= Ffile_name_as_directory (Fcar (Vexec_path
));
1656 Vexec_path
= nconc2 (decode_env_path ("PATH", ""), Vexec_path
);
1659 /* This is run after init_cmdargs, when Vinstallation_directory is valid. */
1664 char *data_dir
= egetenv ("EMACSDATA");
1667 Lisp_Object tempdir
;
1669 if (!NILP (Vinstallation_directory
))
1671 /* Add to the path the lib-src subdir of the installation dir. */
1673 tem
= Fexpand_file_name (build_string ("lib-src"),
1674 Vinstallation_directory
);
1676 /* MSDOS uses wrapped binaries, so don't do this. */
1677 if (NILP (Fmember (tem
, Vexec_path
)))
1679 Vexec_path
= decode_env_path ("EMACSPATH", PATH_EXEC
);
1680 Vexec_path
= Fcons (tem
, Vexec_path
);
1681 Vexec_path
= nconc2 (decode_env_path ("PATH", ""), Vexec_path
);
1684 Vexec_directory
= Ffile_name_as_directory (tem
);
1685 #endif /* not DOS_NT */
1687 /* Maybe use ../etc as well as ../lib-src. */
1690 tem
= Fexpand_file_name (build_string ("etc"),
1691 Vinstallation_directory
);
1692 Vdoc_directory
= Ffile_name_as_directory (tem
);
1696 /* Look for the files that should be in etc. We don't use
1697 Vinstallation_directory, because these files are never installed
1698 near the executable, and they are never in the build
1699 directory when that's different from the source directory.
1701 Instead, if these files are not in the nominal place, we try the
1702 source directory. */
1705 Lisp_Object tem
, tem1
, srcdir
;
1707 srcdir
= Fexpand_file_name (build_string ("../src/"),
1708 build_string (PATH_DUMPLOADSEARCH
));
1709 tem
= Fexpand_file_name (build_string ("GNU"), Vdata_directory
);
1710 tem1
= Ffile_exists_p (tem
);
1711 if (!NILP (Fequal (srcdir
, Vinvocation_directory
)) || NILP (tem1
))
1714 newdir
= Fexpand_file_name (build_string ("../etc/"),
1715 build_string (PATH_DUMPLOADSEARCH
));
1716 tem
= Fexpand_file_name (build_string ("GNU"), newdir
);
1717 tem1
= Ffile_exists_p (tem
);
1719 Vdata_directory
= newdir
;
1727 tempdir
= Fdirectory_file_name (Vexec_directory
);
1728 if (access (SDATA (tempdir
), 0) < 0)
1729 dir_warning ("Warning: arch-dependent data dir (%s) does not exist.\n",
1733 tempdir
= Fdirectory_file_name (Vdata_directory
);
1734 if (access (SDATA (tempdir
), 0) < 0)
1735 dir_warning ("Warning: arch-independent data dir (%s) does not exist.\n",
1739 Vshell_file_name
= build_string ("*dcl*");
1741 sh
= (char *) getenv ("SHELL");
1742 Vshell_file_name
= build_string (sh
? sh
: "/bin/sh");
1746 Vtemp_file_name_pattern
= build_string ("tmp:emacsXXXXXX.");
1748 if (getenv ("TMPDIR"))
1750 char *dir
= getenv ("TMPDIR");
1751 Vtemp_file_name_pattern
1752 = Fexpand_file_name (build_string ("emacsXXXXXX"),
1753 build_string (dir
));
1756 Vtemp_file_name_pattern
= build_string ("/tmp/emacsXXXXXX");
1760 Vshared_game_score_directory
= Qnil
;
1762 Vshared_game_score_directory
= build_string (PATH_GAME
);
1763 if (NILP (Ffile_directory_p (Vshared_game_score_directory
)))
1764 Vshared_game_score_directory
= Qnil
;
1769 set_global_environment ()
1771 register char **envp
;
1773 Vglobal_environment
= Qnil
;
1777 for (envp
= environ
; *envp
; envp
++)
1778 Vglobal_environment
= Fcons (build_string (*envp
),
1779 Vglobal_environment
);
1786 Qbuffer_file_type
= intern ("buffer-file-type");
1787 staticpro (&Qbuffer_file_type
);
1790 DEFVAR_LISP ("shell-file-name", &Vshell_file_name
,
1791 doc
: /* *File name to load inferior shells from.
1792 Initialized from the SHELL environment variable. */);
1794 DEFVAR_LISP ("exec-path", &Vexec_path
,
1795 doc
: /* *List of directories to search programs to run in subprocesses.
1796 Each element is a string (directory name) or nil (try default directory). */);
1798 DEFVAR_LISP ("exec-suffixes", &Vexec_suffixes
,
1799 doc
: /* *List of suffixes to try to find executable file names.
1800 Each element is a string. */);
1801 Vexec_suffixes
= Qnil
;
1803 DEFVAR_LISP ("exec-directory", &Vexec_directory
,
1804 doc
: /* Directory for executables for Emacs to invoke.
1805 More generally, this includes any architecture-dependent files
1806 that are built and installed from the Emacs distribution. */);
1808 DEFVAR_LISP ("data-directory", &Vdata_directory
,
1809 doc
: /* Directory of machine-independent files that come with GNU Emacs.
1810 These are files intended for Emacs to use while it runs. */);
1812 DEFVAR_LISP ("doc-directory", &Vdoc_directory
,
1813 doc
: /* Directory containing the DOC file that comes with GNU Emacs.
1814 This is usually the same as data-directory. */);
1816 DEFVAR_LISP ("configure-info-directory", &Vconfigure_info_directory
,
1817 doc
: /* For internal use by the build procedure only.
1818 This is the name of the directory in which the build procedure installed
1819 Emacs's info files; the default value for Info-default-directory-list
1821 Vconfigure_info_directory
= build_string (PATH_INFO
);
1823 DEFVAR_LISP ("shared-game-score-directory", &Vshared_game_score_directory
,
1824 doc
: /* Directory of score files for games which come with GNU Emacs.
1825 If this variable is nil, then Emacs is unable to use a shared directory. */);
1827 Vshared_game_score_directory
= Qnil
;
1829 Vshared_game_score_directory
= build_string (PATH_GAME
);
1832 DEFVAR_LISP ("temp-file-name-pattern", &Vtemp_file_name_pattern
,
1833 doc
: /* Pattern for making names for temporary files.
1834 This is used by `call-process-region'. */);
1835 /* This variable is initialized in init_callproc. */
1837 DEFVAR_LISP ("global-environment", &Vglobal_environment
,
1838 doc
: /* Global list of environment variables for subprocesses to inherit.
1839 Each element should be a string of the form ENVVARNAME=VALUE.
1841 The environment which Emacs inherits is placed in this variable when
1844 Some frames may have their own local list of environment variables in
1845 their 'environment parameter, which may override this global list; see
1846 `local-environment-variables'. See `process-environment' for a way to
1847 modify an environment variable on all frames.
1849 If multiple entries define the same variable, the first one always
1852 Non-ASCII characters are encoded according to the initial value of
1853 `locale-coding-system', i.e. the elements must normally be decoded for use.
1854 See `setenv' and `getenv'. */);
1856 DEFVAR_LISP ("process-environment", &Vprocess_environment
,
1857 doc
: /* List of overridden environment variables for subprocesses to inherit.
1858 Each element should be a string of the form ENVVARNAME=VALUE.
1860 Entries in this list take precedence to those in `global-environment'
1861 or the frame-local environment. (See `local-environment-variables'.)
1862 Therefore, let-binding `process-environment' is an easy way to
1863 temporarily change the value of an environment variable, irrespective
1864 of where it comes from. To use `process-environment' to remove an
1865 environment variable, include only its name in the list, without
1868 This variable is set to nil when Emacs starts.
1870 If multiple entries define the same variable, the first one always
1873 Non-ASCII characters are encoded according to the initial value of
1874 `locale-coding-system', i.e. the elements must normally be decoded for
1877 See `setenv' and `getenv'. */);
1878 Vprocess_environment
= Qnil
;
1881 defsubr (&Scall_process
);
1882 defsubr (&Sgetenv_internal
);
1884 defsubr (&Scall_process_region
);
1886 DEFVAR_LISP ("local-environment-variables", &Vlocal_environment_variables
,
1887 doc
: /* Enable or disable frame-local environment variables.
1888 If set to t, `getenv', `setenv' and subprocess creation functions use
1889 the local environment of the selected frame, ignoring
1890 `global-environment'.
1892 If set to nil, Emacs uses `global-environment' and ignores the
1893 frame-local environment.
1895 Otherwise, `local-environment-variables' should be a list of variable
1896 names (represented by Lisp strings) to look up in the frame's
1897 environment. The rest will come from `global-environment'. */);
1898 Vlocal_environment_variables
= Qnil
;
1901 /* arch-tag: 769b8045-1df7-4d2b-8968-e3fb49017f95
1902 (do not change this comment) */