1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2017 Free Software
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or (at
11 your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #define INLINE EXTERN_INLINE
32 #include <close-stream.h>
39 #include <sys/socket.h>
45 #if defined WINDOWSNT || defined HAVE_NTGUI
46 #include "w32select.h"
48 #include "w32common.h"
56 #include <binary-io.h>
60 #ifdef HAVE_LIBSYSTEMD
61 # include <systemd/sd-daemon.h>
62 # include <sys/socket.h>
65 #ifdef HAVE_WINDOW_SYSTEM
67 #endif /* HAVE_WINDOW_SYSTEM */
69 #include "intervals.h"
70 #include "character.h"
75 #include "blockinput.h"
76 #include "syssignal.h"
79 #include "termhooks.h"
84 #include "composite.h"
85 #include "dispextern.h"
89 #include "sysselect.h"
93 #include "getpagesize.h"
96 #if (defined PROFILING \
97 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
98 # include <sys/gmon.h>
99 extern void moncontrol (int mode
);
102 #ifdef HAVE_SETLOCALE
110 #ifdef HAVE_SETRLIMIT
111 #include <sys/time.h>
112 #include <sys/resource.h>
115 static const char emacs_version
[] = PACKAGE_VERSION
;
116 static const char emacs_copyright
[] = COPYRIGHT
;
117 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
119 /* Empty lisp strings. To avoid having to build any others. */
120 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
123 /* Cache for externally loaded libraries. */
124 Lisp_Object Vlibrary_cache
;
127 /* Set after Emacs has started up the first time.
128 Prevents reinitialization of the Lisp world and keymaps
129 on subsequent starts. */
133 /* Set to true if this instance of Emacs might dump. */
134 # ifndef DOUG_LEA_MALLOC
140 /* If true, Emacs should not attempt to use a window-specific code,
141 but instead should use the virtual terminal under which it was started. */
142 bool inhibit_window_system
;
144 /* If true, a filter or a sentinel is running. Tested to save the match
145 data on the first attempt to change it inside asynchronous code. */
146 bool running_asynch_code
;
148 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
149 /* If true, -d was specified, meaning we're using some window system. */
153 #if defined GNU_LINUX && !defined CANNOT_DUMP
154 /* The gap between BSS end and heap start as far as we can tell. */
155 static uprintmax_t heap_bss_diff
;
158 /* To run as a background daemon under Cocoa or Windows,
159 we must do a fork+exec, not a simple fork.
161 On Cocoa, CoreFoundation lib fails in forked process:
162 http://developer.apple.com/ReleaseNotes/
163 CoreFoundation/CoreFoundation.html)
165 On Windows, a Cygwin fork child cannot access the USER subsystem.
167 We mark being in the exec'd process by a daemon name argument of
168 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
169 NAME is the original daemon name, if any. */
170 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
171 # define DAEMON_MUST_EXEC
174 /* True means running Emacs without interactive terminal. */
177 /* True means remove site-lisp directories from load-path. */
180 /* True means put details like time stamps into builds. */
183 /* Name for the server started by the daemon.*/
184 static char *daemon_name
;
186 /* 0 not a daemon, 1 new-style (foreground), 2 old-style (background). */
190 /* Pipe used to send exit notification to the background daemon parent at
191 startup. On Windows, we use a kernel event instead. */
192 static int daemon_pipe
[2];
194 HANDLE w32_daemon_event
;
197 /* Save argv and argc. */
201 static void sort_args (int argc
, char **argv
);
202 static void syms_of_emacs (void);
204 /* C99 needs each string to be at most 4095 characters, and the usage
205 strings below are split to not overflow this limit. */
206 static char const *const usage_message
[] =
209 Run Emacs, the extensible, customizable, self-documenting real-time\n\
210 display editor. The recommended way to start Emacs for normal editing\n\
211 is with no options at all.\n\
213 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
214 read the main documentation for these command-line arguments.\n\
216 Initialization options:\n\
220 --batch do not do interactive display; implies -q\n\
221 --chdir DIR change to directory DIR\n\
222 --daemon, --bg-daemon[=NAME] start a (named) server in the background\n\
223 --fg-daemon[=NAME] start a (named) server in the foreground\n\
224 --debug-init enable Emacs Lisp debugger for init file\n\
225 --display, -d DISPLAY use X server DISPLAY\n\
226 --module-assertions assert behavior of dynamic modules\n\
229 --no-build-details do not add build details such as time stamps\n\
230 --no-desktop do not load a saved desktop\n\
231 --no-init-file, -q load neither ~/.emacs nor default.el\n\
232 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
233 --no-site-file do not load site-start.el\n\
234 --no-x-resources do not load X resources\n\
235 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
236 --no-splash do not display a splash screen on startup\n\
237 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
240 --quick, -Q equivalent to:\n\
241 -q --no-site-file --no-site-lisp --no-splash\n\
243 --script FILE run FILE as an Emacs Lisp script\n\
244 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
245 --user, -u USER load ~USER/.emacs instead of your own\n\
251 FILE visit FILE using find-file\n\
252 +LINE go to line LINE in next FILE\n\
253 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
254 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
255 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
256 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
259 --file FILE visit FILE using find-file\n\
260 --find-file FILE visit FILE using find-file\n\
261 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
262 --insert FILE insert contents of FILE into current buffer\n\
263 --kill exit without asking for confirmation\n\
264 --load, -l FILE load Emacs Lisp FILE using the load function\n\
265 --visit FILE visit FILE using find-file\n\
271 --background-color, -bg COLOR window background color\n\
272 --basic-display, -D disable many display features;\n\
273 used for debugging Emacs\n\
274 --border-color, -bd COLOR main border color\n\
275 --border-width, -bw WIDTH width of main border\n\
278 --color, --color=MODE override color mode for character terminals;\n\
279 MODE defaults to `auto', and\n\
280 can also be `never', `always',\n\
281 or a mode name like `ansi8'\n\
282 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
283 --font, -fn FONT default font; must be fixed-width\n\
284 --foreground-color, -fg COLOR window foreground color\n\
287 --fullheight, -fh make the first frame high as the screen\n\
288 --fullscreen, -fs make the first frame fullscreen\n\
289 --fullwidth, -fw make the first frame wide as the screen\n\
290 --maximized, -mm make the first frame maximized\n\
291 --geometry, -g GEOMETRY window geometry\n\
294 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
295 --iconic start Emacs in iconified state\n\
296 --internal-border, -ib WIDTH width between text and main border\n\
297 --line-spacing, -lsp PIXELS additional space to put between lines\n\
298 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
299 --name NAME title for initial Emacs frame\n\
302 --no-blinking-cursor, -nbc disable blinking cursor\n\
303 --reverse-video, -r, -rv switch foreground and background\n\
304 --title, -T TITLE title for initial Emacs frame\n\
305 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
306 --xrm XRESOURCES set additional X resources\n\
307 --parent-id XID set parent window\n\
308 --help display this help and exit\n\
309 --version output version information and exit\n\
313 You can generally also specify long option names with a single -; for\n\
314 example, -batch as well as --batch. You can use any unambiguous\n\
315 abbreviation for a --option.\n\
317 Various environment variables and window system resources also affect\n\
318 the operation of Emacs. See the main documentation.\n\
320 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
321 section of the Emacs manual or the file BUGS.\n"
325 /* True if handling a fatal error already. */
326 bool fatal_error_in_progress
;
329 /* NS autrelease pool, for memory management. */
330 static void *ns_pool
;
335 setlocale (int cat
, char const *locale
)
341 /* True if the current system locale uses UTF-8 encoding. */
347 mbstate_t mbs
= { 0 };
348 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
355 /* Report a fatal error due to signal SIG, output a backtrace of at
356 most BACKTRACE_LIMIT lines, and exit. */
358 terminate_due_to_signal (int sig
, int backtrace_limit
)
360 signal (sig
, SIG_DFL
);
362 if (attempt_orderly_shutdown_on_fatal_signal
)
364 /* If fatal error occurs in code below, avoid infinite recursion. */
365 if (! fatal_error_in_progress
)
367 fatal_error_in_progress
= 1;
369 totally_unblock_input ();
370 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
371 Fkill_emacs (make_number (sig
));
373 shut_down_emacs (sig
, Qnil
);
374 emacs_backtrace (backtrace_limit
);
378 /* Signal the same code; this time it will really be fatal.
379 Since we're in a signal handler, the signal is blocked, so we
380 have to unblock it if we want to really receive it. */
384 sigemptyset (&unblocked
);
385 sigaddset (&unblocked
, sig
);
386 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
392 /* This shouldn't be executed, but it prevents a warning. */
396 /* Code for dealing with Lisp access to the Unix command line. */
399 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
402 Lisp_Object name
, dir
, handler
;
403 ptrdiff_t count
= SPECPDL_INDEX ();
404 Lisp_Object raw_name
;
405 AUTO_STRING (slash_colon
, "/:");
411 /* Must use argv[0] converted to UTF-8, as it begets many standard
412 file and directory names. */
414 char argv0
[MAX_UTF8_PATH
];
416 if (filename_from_ansi (argv
[0], argv0
) == 0)
417 raw_name
= build_unibyte_string (argv0
);
419 raw_name
= build_unibyte_string (argv
[0]);
422 raw_name
= build_unibyte_string (argv
[0]);
425 /* Add /: to the front of the name
426 if it would otherwise be treated as magic. */
427 handler
= Ffind_file_name_handler (raw_name
, Qt
);
428 if (! NILP (handler
))
429 raw_name
= concat2 (slash_colon
, raw_name
);
431 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
432 Vinvocation_directory
= Ffile_name_directory (raw_name
);
434 /* If we got no directory in argv[0], search PATH to find where
435 Emacs actually came from. */
436 if (NILP (Vinvocation_directory
))
439 int yes
= openp (Vexec_path
, Vinvocation_name
,
440 Vexec_suffixes
, &found
, make_number (X_OK
), false);
443 /* Add /: to the front of the name
444 if it would otherwise be treated as magic. */
445 handler
= Ffind_file_name_handler (found
, Qt
);
446 if (! NILP (handler
))
447 found
= concat2 (slash_colon
, found
);
448 Vinvocation_directory
= Ffile_name_directory (found
);
452 if (!NILP (Vinvocation_directory
)
453 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
454 /* Emacs was started with relative path, like ./emacs.
458 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
460 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
463 Vinstallation_directory
= Qnil
;
465 if (!NILP (Vinvocation_directory
))
467 if (NILP (Vpurify_flag
) && !NILP (Ffboundp (Qfile_truename
)))
468 Vinvocation_directory
= call1 (Qfile_truename
, Vinvocation_directory
);
470 dir
= Vinvocation_directory
;
472 /* If we are running from the build directory, set DIR to the
473 src subdirectory of the Emacs tree, like on Posix
475 if (SBYTES (dir
) > sizeof ("/i386/") - 1
476 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
478 dir
= Fexpand_file_name (build_string ("../.."), dir
);
479 #else /* !WINDOWSNT */
481 name
= Fexpand_file_name (Vinvocation_name
, dir
);
484 Lisp_Object tem
, lib_src_exists
;
485 Lisp_Object etc_exists
, info_exists
;
487 /* See if dir contains subdirs for use by Emacs.
488 Check for the ones that would exist in a build directory,
489 not including lisp and info. */
490 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
491 lib_src_exists
= Ffile_exists_p (tem
);
494 /* MSDOS installations frequently remove lib-src, but we still
495 must set installation-directory, or else info won't find
496 its files (it uses the value of installation-directory). */
497 tem
= Fexpand_file_name (build_string ("info"), dir
);
498 info_exists
= Ffile_exists_p (tem
);
503 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
505 tem
= Fexpand_file_name (build_string ("etc"), dir
);
506 etc_exists
= Ffile_exists_p (tem
);
507 if (!NILP (etc_exists
))
509 Vinstallation_directory
510 = Ffile_name_as_directory (dir
);
515 /* See if dir's parent contains those subdirs. */
516 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
517 lib_src_exists
= Ffile_exists_p (tem
);
521 /* See the MSDOS commentary above. */
522 tem
= Fexpand_file_name (build_string ("../info"), dir
);
523 info_exists
= Ffile_exists_p (tem
);
528 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
530 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
531 etc_exists
= Ffile_exists_p (tem
);
532 if (!NILP (etc_exists
))
534 tem
= Fexpand_file_name (build_string (".."), dir
);
535 Vinstallation_directory
536 = Ffile_name_as_directory (tem
);
541 /* If the Emacs executable is actually a link,
542 next try the dir that the link points into. */
543 tem
= Ffile_symlink_p (name
);
546 name
= Fexpand_file_name (tem
, dir
);
547 dir
= Ffile_name_directory (name
);
554 Vcommand_line_args
= Qnil
;
556 for (i
= argc
- 1; i
>= 0; i
--)
558 if (i
== 0 || i
> skip_args
)
559 /* For the moment, we keep arguments as is in unibyte strings.
560 They are decoded in the function command-line after we know
561 locale-coding-system. */
563 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
566 unbind_to (count
, Qnil
);
569 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
570 doc
: /* Return the program name that was used to run Emacs.
571 Any directory names are omitted. */)
574 return Fcopy_sequence (Vinvocation_name
);
577 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
579 doc
: /* Return the directory name in which the Emacs executable was located. */)
582 return Fcopy_sequence (Vinvocation_directory
);
586 /* Test whether the next argument in ARGV matches SSTR or a prefix of
587 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
588 (the argument is supposed to have a value) store in *VALPTR either
589 the next argument or the portion of this one after the equal sign.
590 ARGV is read starting at position *SKIPPTR; this index is advanced
591 by the number of arguments used.
593 Too bad we can't just use getopt for all of this, but we don't have
594 enough information to do it right. */
597 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
598 int minlen
, char **valptr
, int *skipptr
)
604 /* Don't access argv[argc]; give up in advance. */
605 if (argc
<= *skipptr
+ 1)
608 arg
= argv
[*skipptr
+1];
611 if (strcmp (arg
, sstr
) == 0)
615 *valptr
= argv
[*skipptr
+2];
622 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
623 ? p
- arg
: strlen (arg
));
624 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
626 else if (valptr
== NULL
)
637 else if (argv
[*skipptr
+2] != NULL
)
639 *valptr
= argv
[*skipptr
+2];
649 /* Close standard output and standard error, reporting any write
650 errors as best we can. This is intended for use with atexit. */
652 close_output_streams (void)
654 if (close_stream (stdout
) != 0)
656 emacs_perror ("Write error to standard output");
657 _exit (EXIT_FAILURE
);
660 /* Do not close stderr if addresses are being sanitized, as the
661 sanitizer might report to stderr after this function is
663 if (!ADDRESS_SANITIZER
&& close_stream (stderr
) != 0)
664 _exit (EXIT_FAILURE
);
669 main (int argc
, char **argv
)
671 char stack_bottom_variable
;
672 bool do_initial_setlocale
;
675 bool no_loadup
= false;
678 #ifdef DAEMON_MUST_EXEC
683 /* If we use --chdir, this records the original directory. */
684 char *original_pwd
= 0;
686 /* Record (approximately) where the stack begins. */
687 stack_bottom
= &stack_bottom_variable
;
690 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
691 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
696 /* True if address randomization interferes with memory allocation. */
698 bool disable_aslr
= true;
700 bool disable_aslr
= dumping
;
703 if (disable_aslr
&& disable_address_randomization ())
705 /* Set this so the personality will be reverted before execs
707 xputenv ("EMACS_HEAP_EXEC=true");
709 /* Address randomization was enabled, but is now disabled.
710 Re-execute Emacs to get a clean slate. */
711 execvp (argv
[0], argv
);
713 /* If the exec fails, warn and then try anyway. */
718 might_dump
= !initialized
;
723 char *heap_start
= my_heap_start ();
724 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
729 #if defined WINDOWSNT || defined HAVE_NTGUI
730 /* Set global variables used to detect Windows version. Do this as
731 early as possible. (unexw32.c calls this function as well, but
732 the additional call here is harmless.) */
733 cache_system_info ();
735 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
736 to have non-stub implementations of APIs we need to convert file
737 names between UTF-8 and the system's ANSI codepage. */
738 maybe_load_unicows_dll ();
739 /* Initialize the codepage for file names, needed to decode
740 non-ASCII file names during startup. */
741 w32_init_file_name_codepage ();
743 w32_init_main_thread ();
746 #ifdef RUN_TIME_REMAP
748 run_time_remap (argv
[0]);
751 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
752 #if defined DARWIN_OS && !defined CANNOT_DUMP
754 unexec_init_emacs_zone ();
757 init_standard_fds ();
758 atexit (close_output_streams
);
760 sort_args (argc
, argv
);
762 while (argv
[argc
]) argc
++;
764 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
766 const char *version
, *copyright
;
769 Lisp_Object tem
, tem2
;
770 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
771 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
774 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
779 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
784 version
= SSDATA (tem
);
785 copyright
= SSDATA (tem2
);
790 version
= emacs_version
;
791 copyright
= emacs_copyright
;
793 printf ("%s %s\n", PACKAGE_NAME
, version
);
794 printf ("%s\n", copyright
);
795 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
796 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
797 printf ("under the terms of the GNU General Public License.\n");
798 printf ("For more information about these matters, ");
799 printf ("see the file named COPYING.\n");
803 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
806 /* argv[] array is kept in its original ANSI codepage encoding,
807 we need to convert to UTF-8, for chdir to work. */
808 char newdir
[MAX_UTF8_PATH
];
810 filename_from_ansi (ch_to_dir
, newdir
);
813 original_pwd
= emacs_get_current_dir_name ();
814 if (chdir (ch_to_dir
) != 0)
816 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
817 argv
[0], ch_to_dir
, strerror (errno
));
822 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
823 /* Extend the stack space available. Don't do that if dumping,
824 since some systems (e.g. DJGPP) might define a smaller stack
825 limit at that time. And it's not needed on Cygwin, since emacs
826 is built with an 8MB stack. Moreover, the setrlimit call can
827 cause problems on Cygwin
828 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
830 if (getrlimit (RLIMIT_STACK
, &rlim
) == 0
831 && 0 <= rlim
.rlim_cur
&& rlim
.rlim_cur
<= LONG_MAX
)
833 rlim_t lim
= rlim
.rlim_cur
;
835 /* Approximate the amount regex.c needs per unit of
836 emacs_re_max_failures, then add 33% to cover the size of the
837 smaller stacks that regex.c successively allocates and
838 discards on its way to the maximum. */
839 int min_ratio
= 20 * sizeof (char *);
840 int ratio
= min_ratio
+ min_ratio
/ 3;
842 /* Extra space to cover what we're likely to use for other
843 reasons. For example, a typical GC might take 30K stack
845 int extra
= (30 * 1000) * 50;
847 bool try_to_grow_stack
= true;
849 try_to_grow_stack
= !noninteractive
|| initialized
;
852 if (try_to_grow_stack
)
854 rlim_t newlim
= emacs_re_max_failures
* ratio
+ extra
;
856 /* Round the new limit to a page boundary; this is needed
857 for Darwin kernel 15.4.0 (see Bug#23622) and perhaps
858 other systems. Do not shrink the stack and do not exceed
859 rlim_max. Don't worry about exact values of
860 RLIM_INFINITY etc. since in practice when they are
861 nonnegative they are so large that the code does the
862 right thing anyway. */
863 long pagesize
= getpagesize ();
864 newlim
+= pagesize
- 1;
865 if (0 <= rlim
.rlim_max
&& rlim
.rlim_max
< newlim
)
866 newlim
= rlim
.rlim_max
;
867 newlim
-= newlim
% pagesize
;
869 if (pagesize
<= newlim
- lim
)
871 rlim
.rlim_cur
= newlim
;
872 if (setrlimit (RLIMIT_STACK
, &rlim
) == 0)
876 /* If the stack is big enough, let regex.c more of it before
877 falling back to heap allocation. */
878 emacs_re_safe_alloca
= max
879 (min (lim
- extra
, SIZE_MAX
) * (min_ratio
/ ratio
),
882 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
886 emacs_backtrace (-1);
888 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
889 /* Arrange to get warning messages as memory fills up. */
890 memory_warnings (0, malloc_warning
);
892 /* Call malloc at least once, to run malloc_initialize_hook.
893 Also call realloc and free for consistency. */
894 free (realloc (malloc (4), 4));
896 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
899 set_binary_mode (STDIN_FILENO
, O_BINARY
);
901 set_binary_mode (STDOUT_FILENO
, O_BINARY
);
904 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
905 The build procedure uses this while dumping, to ensure that the
906 dumped Emacs does not have its system locale tables initialized,
907 as that might cause screwups when the dumped Emacs starts up. */
909 char *lc_all
= getenv ("LC_ALL");
910 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
913 /* Set locale now, so that initial error messages are localized properly.
914 fixup_locale must wait until later, since it builds strings. */
915 if (do_initial_setlocale
)
916 setlocale (LC_ALL
, "");
917 text_quoting_flag
= using_utf8 ();
919 inhibit_window_system
= 0;
921 /* Handle the -t switch, which specifies filename to use as terminal. */
925 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
927 emacs_close (STDIN_FILENO
);
928 emacs_close (STDOUT_FILENO
);
929 int result
= emacs_open (term
, O_RDWR
, 0);
930 if (result
!= STDIN_FILENO
931 || (fcntl (STDIN_FILENO
, F_DUPFD_CLOEXEC
, STDOUT_FILENO
)
934 char *errstring
= strerror (errno
);
935 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
938 if (! isatty (STDIN_FILENO
))
940 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
943 fprintf (stderr
, "Using %s\n", term
);
944 #ifdef HAVE_WINDOW_SYSTEM
945 inhibit_window_system
= true; /* -t => -nw */
952 /* Command line option --no-windows is deprecated and thus not mentioned
953 in the manual and usage information. */
954 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
955 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
956 inhibit_window_system
= 1;
958 /* Handle the -batch switch, which means don't do interactive display. */
960 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
963 Vundo_outer_limit
= Qnil
;
965 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
967 noninteractive
= 1; /* Set batch mode. */
968 /* Convert --script to -scriptload, un-skip it, and sort again
969 so that it will be handled in proper sequence. */
970 /* FIXME broken for --script=FILE - is that supposed to work? */
971 argv
[skip_args
- 1] = (char *) "-scriptload";
973 sort_args (argc
, argv
);
976 /* Handle the --help option, which gives a usage message. */
977 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
980 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
981 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
982 fputs (usage_message
[i
], stdout
);
989 /* Make sure IS_DAEMON starts up as false. */
992 w32_daemon_event
= NULL
;
998 if (argmatch (argv
, argc
, "-fg-daemon", "--fg-daemon", 10, NULL
, &skip_args
)
999 || argmatch (argv
, argc
, "-fg-daemon", "--fg-daemon", 10, &dname_arg
, &skip_args
))
1001 daemon_type
= 1; /* foreground */
1003 else if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
1004 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
)
1005 || argmatch (argv
, argc
, "-bg-daemon", "--bg-daemon", 10, NULL
, &skip_args
)
1006 || argmatch (argv
, argc
, "-bg-daemon", "--bg-daemon", 10, &dname_arg
, &skip_args
))
1008 daemon_type
= 2; /* background */
1012 if (daemon_type
> 0)
1015 if (daemon_type
== 2)
1017 /* Start as a background daemon: fork a new child process which
1018 will run the rest of the initialization code, then exit.
1020 Detaching a daemon requires the following steps:
1024 - close the tty file-descriptors
1026 We only want to do the last 2 steps once the daemon is ready to
1027 serve requests, i.e. after loading .emacs (initialization).
1028 OTOH initialization may start subprocesses (e.g. ispell) and these
1029 should be run from the proper process (the one that will end up
1030 running as daemon) and with the proper "session id" in order for
1031 them to keep working after detaching, so fork and setsid need to be
1032 performed before initialization.
1034 We want to avoid exiting before the server socket is ready, so
1035 use a pipe for synchronization. The parent waits for the child
1036 to close its end of the pipe (using `daemon-initialized')
1038 if (emacs_pipe (daemon_pipe
) != 0)
1040 fprintf (stderr
, "Cannot pipe!\n");
1043 } /* daemon_type == 2 */
1045 #ifdef HAVE_LIBSYSTEMD
1046 /* Read the number of sockets passed through by systemd. */
1047 int systemd_socket
= sd_listen_fds (1);
1049 if (systemd_socket
> 1)
1052 "Warning: systemd passed more than one socket to Emacs.\n"
1053 "Try 'Accept=false' in the Emacs socket unit file.\n"));
1054 else if (systemd_socket
== 1
1055 && (0 < sd_is_socket (SD_LISTEN_FDS_START
,
1056 AF_UNSPEC
, SOCK_STREAM
, 1)))
1057 sockfd
= SD_LISTEN_FDS_START
;
1058 #endif /* HAVE_LIBSYSTEMD */
1061 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1062 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1063 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1064 #endif /* USE_GTK */
1066 if (daemon_type
== 2)
1069 #ifndef DAEMON_MUST_EXEC
1072 #else /* DAEMON_MUST_EXEC */
1073 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1074 f
= fork (); /* in orig */
1076 f
= 0; /* in exec'd */
1077 #endif /* !DAEMON_MUST_EXEC */
1083 /* Close unused writing end of the pipe. */
1084 emacs_close (daemon_pipe
[1]);
1086 /* Just wait for the child to close its end of the pipe. */
1089 retval
= read (daemon_pipe
[0], &buf
, 1);
1091 while (retval
== -1 && errno
== EINTR
);
1095 fprintf (stderr
, "Error reading status from child\n");
1098 else if (retval
== 0)
1100 fprintf (stderr
, "Error: server did not start correctly\n");
1104 emacs_close (daemon_pipe
[0]);
1109 emacs_perror ("fork");
1110 exit (EXIT_CANCELED
);
1113 #ifdef DAEMON_MUST_EXEC
1115 /* In orig process, forked as child, OR in exec'd. */
1116 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1117 { /* In orig, child: now exec w/special daemon name. */
1120 snprintf (fdStr
, sizeof fdStr
,
1121 "--bg-daemon=\n%d,%d\n%s", daemon_pipe
[0],
1122 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1124 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1126 fprintf (stderr
, "daemon: child name too long\n");
1127 exit (EXIT_CANNOT_INVOKE
);
1130 argv
[skip_args
] = fdStr
;
1132 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1133 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1134 execvp (argv
[0], argv
);
1135 emacs_perror (argv
[0]);
1136 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1139 /* In exec'd: parse special dname into pipe and name info. */
1140 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1141 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1143 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1144 exit (EXIT_CANNOT_INVOKE
);
1146 dname_arg2
[0] = '\0';
1147 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1149 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1150 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1152 #endif /* DAEMON_MUST_EXEC */
1154 /* Close unused reading end of the pipe. */
1155 emacs_close (daemon_pipe
[0]);
1158 } /* daemon_type == 2 */
1159 #elif defined(WINDOWSNT)
1160 /* Indicate that we want daemon mode. */
1161 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1162 if (w32_daemon_event
== NULL
)
1164 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1169 fprintf (stderr
, "This platform does not support daemon mode.\n");
1173 daemon_name
= xstrdup (dname_arg
);
1176 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1177 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1178 # ifndef CANNOT_DUMP
1179 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1180 that causes an infinite recursive loop with FreeBSD. See
1181 Bug#14569. The part of this bug involving Cygwin is no longer
1182 relevant, now that Cygwin defines HYBRID_MALLOC. */
1183 if (!noninteractive
|| initialized
)
1185 malloc_enable_thread ();
1188 init_signals (dumping
);
1190 noninteractive1
= noninteractive
;
1192 /* Perform basic initializations (not merely interning symbols). */
1197 init_threads_once ();
1200 init_charset_once ();
1201 init_coding_once ();
1202 init_syntax_once (); /* Create standard syntax table. */
1203 init_category_once (); /* Create standard category table. */
1204 init_casetab_once (); /* Must be done before init_buffer_once. */
1205 init_buffer_once (); /* Create buffer table and some buffers. */
1206 init_minibuf_once (); /* Create list of minibuffers. */
1207 /* Must precede init_window_once. */
1209 /* Call syms_of_xfaces before init_window_once because that
1210 function creates Vterminal_frame. Termcap frames now use
1211 faces, and the face implementation uses some symbols as
1214 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1215 be better to arrange things not to have this dependency. */
1217 /* Call syms_of_keyboard before init_window_once because
1218 keyboard sets up symbols that include some face names that
1219 the X support will want to use. This can happen when
1220 CANNOT_DUMP is defined. */
1221 syms_of_keyboard ();
1223 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1225 syms_of_fns (); /* Before syms_of_charset which uses hash tables. */
1227 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1229 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1231 /* Before syms_of_coding because it initializes Qcharsetp. */
1233 /* Before init_window_once, because it sets up the
1234 Vcoding_system_hash_table. */
1235 syms_of_coding (); /* This should be after syms_of_fileio. */
1237 init_window_once (); /* Init the window system. */
1238 #ifdef HAVE_WINDOW_SYSTEM
1239 init_fringe_once (); /* Swap bitmaps if necessary. */
1240 #endif /* HAVE_WINDOW_SYSTEM */
1246 if (do_initial_setlocale
)
1249 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1250 Vsystem_time_locale
= Vprevious_system_time_locale
;
1255 running_asynch_code
= 0;
1259 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1262 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1264 build_details
= ! argmatch (argv
, argc
, "-no-build-details",
1265 "--no-build-details", 7, NULL
, &skip_args
);
1268 bool module_assertions
1269 = argmatch (argv
, argc
, "-module-assertions", "--module-assertions", 15,
1271 if (dumping
&& module_assertions
)
1273 fputs ("Module assertions are not supported during dumping\n", stderr
);
1276 init_module_assertions (module_assertions
);
1280 ns_pool
= ns_alloc_autorelease_pool ();
1281 #ifdef NS_IMPL_GNUSTEP
1282 /* GNUstep stupidly resets our locale settings after we made them. */
1286 if (!noninteractive
)
1288 #ifdef NS_IMPL_COCOA
1289 /* Started from GUI? */
1290 /* FIXME: Do the right thing if getenv returns NULL, or if
1292 if (! inhibit_window_system
&& ! isatty (STDIN_FILENO
) && ! ch_to_dir
)
1293 chdir (getenv ("HOME"));
1294 if (skip_args
< argc
)
1296 if (!strncmp (argv
[skip_args
], "-psn", 4))
1299 if (! ch_to_dir
) chdir (getenv ("HOME"));
1301 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1304 if (! ch_to_dir
) chdir (getenv ("HOME"));
1309 #endif /* HAVE_NS */
1311 #ifdef HAVE_X_WINDOWS
1312 /* Stupid kludge to catch command-line display spec. We can't
1313 handle this argument entirely in window system dependent code
1314 because we don't even know which window system dependent code
1315 to run until we've recognized this argument. */
1317 char *displayname
= 0;
1318 int count_before
= skip_args
;
1320 /* Skip any number of -d options, but only use the last one. */
1323 int count_before_this
= skip_args
;
1325 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1327 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1332 count_before
= count_before_this
;
1335 /* If we have the form --display=NAME,
1336 convert it into -d name.
1337 This requires inserting a new element into argv. */
1338 if (displayname
&& count_before
< skip_args
)
1340 if (skip_args
== count_before
+ 1)
1342 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1343 (argc
- (count_before
+ 2)) * sizeof *argv
);
1344 argv
[count_before
+ 2] = displayname
;
1347 argv
[count_before
+ 1] = (char *) "-d";
1352 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1353 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1357 /* Don't actually discard this arg. */
1358 skip_args
= count_before
;
1360 #else /* !HAVE_X_WINDOWS */
1363 int count_before
= skip_args
;
1365 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1366 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1369 skip_args
= count_before
;
1373 /* argmatch must not be used after here,
1374 except when building temacs
1375 because the -d argument has not been skipped in skip_args. */
1378 /* Call early 'cause init_environment needs it. */
1380 /* Set defaults for several environment variables. */
1382 init_environment (argc
, argv
, skip_args
);
1388 globals_of_kqueue ();
1391 #ifdef HAVE_GFILENOTIFY
1392 globals_of_gfilenotify ();
1396 /* Initialize the locale from user defaults. */
1400 /* Initialize and GC-protect Vinitial_environment and
1401 Vprocess_environment before set_initial_environment fills them
1404 syms_of_callproc ();
1405 /* egetenv is a pretty low-level facility, which may get called in
1406 many circumstances; it seems flimsy to put off initializing it
1407 until calling init_callproc. Do not do it when dumping. */
1409 set_initial_environment ();
1413 #ifdef HAVE_W32NOTIFY
1414 globals_of_w32notify ();
1416 /* Initialize environment from registry settings. Make sure to do
1417 this only after calling set_initial_environment so that
1418 Vinitial_environment and Vprocess_environment will contain only
1419 variables from the parent process without modifications from
1421 init_environment (argv
);
1422 init_ntproc (dumping
); /* must precede init_editfns. */
1425 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1426 if this is not done. Do it after set_global_environment so that we
1427 don't pollute Vglobal_environment. */
1428 /* Setting LANG here will defeat the startup locale processing... */
1433 /* Init buffer storage and default directory of main buffer. */
1434 init_buffer (initialized
);
1436 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1438 /* Must precede init_lread. */
1439 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1443 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1444 Lisp_Object old_log_max
;
1445 old_log_max
= Vmessage_log_max
;
1446 XSETFASTINT (Vmessage_log_max
, 0);
1447 message_dolog ("", 0, 1, 0);
1448 Vmessage_log_max
= old_log_max
;
1451 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1455 /* Check to see if Emacs has been installed correctly. */
1456 check_windows_init_file ();
1459 /* Intern the names of all standard functions and variables;
1460 define standard keys. */
1464 /* The basic levels of Lisp must come first. Note that
1465 syms_of_data and some others have already been called. */
1470 syms_of_floatfns ();
1473 syms_of_bytecode ();
1475 syms_of_casefiddle ();
1477 syms_of_category ();
1479 syms_of_character ();
1486 syms_of_filelock ();
1489 /* syms_of_keymap (); */
1497 syms_of_terminal ();
1508 syms_of_textprop ();
1509 syms_of_composite ();
1512 #endif /* WINDOWSNT */
1519 #ifdef HAVE_WINDOW_SYSTEM
1522 #endif /* HAVE_WINDOW_SYSTEM */
1523 #ifdef HAVE_X_WINDOWS
1529 syms_of_xsettings ();
1536 #endif /* HAVE_X_WINDOWS */
1543 syms_of_decompress ();
1553 #endif /* HAVE_NTGUI */
1555 #if defined WINDOWSNT || defined HAVE_NTGUI
1556 syms_of_w32select ();
1563 syms_of_win16select ();
1570 syms_of_nsselect ();
1572 #endif /* HAVE_NS */
1578 #endif /* HAVE_INOTIFY */
1582 #endif /* HAVE_KQUEUE */
1584 #ifdef HAVE_GFILENOTIFY
1585 syms_of_gfilenotify ();
1586 #endif /* HAVE_GFILENOTIFY */
1589 syms_of_dbusbind ();
1590 #endif /* HAVE_DBUS */
1594 #ifdef HAVE_W32NOTIFY
1595 syms_of_w32notify ();
1596 #endif /* HAVE_W32NOTIFY */
1597 #endif /* WINDOWSNT */
1600 syms_of_profiler ();
1602 keys_of_casefiddle ();
1605 keys_of_keyboard ();
1611 /* Initialization that must be done even if the global variable
1612 initialized is non zero. */
1614 globals_of_w32font ();
1615 globals_of_w32fns ();
1616 globals_of_w32menu ();
1617 #endif /* HAVE_NTGUI */
1619 #if defined WINDOWSNT || defined HAVE_NTGUI
1620 globals_of_w32select ();
1626 /* This calls putenv and so must precede init_process_emacs. Also,
1627 it sets Voperating_system_release, which init_process_emacs uses. */
1628 init_editfns (dumping
);
1630 /* These two call putenv. */
1638 /* This can create a thread that may call getenv, so it must follow
1639 all calls to putenv and setenv. Also, this sets up
1640 add_keyboard_wait_descriptor, which init_display uses. */
1641 init_process_emacs (sockfd
);
1643 init_keyboard (); /* This too must precede init_sys_modes. */
1644 if (!noninteractive
)
1645 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1648 init_crit (); /* w32notify.c needs this in batch mode. */
1649 #endif /* HAVE_W32NOTIFY */
1651 #ifdef HAVE_WINDOW_SYSTEM
1653 #endif /* HAVE_WINDOW_SYSTEM */
1661 /* Handle -l loadup, args passed by Makefile. */
1662 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1665 char file_utf8
[MAX_UTF8_PATH
];
1667 if (filename_from_ansi (file
, file_utf8
) == 0)
1670 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1672 /* Unless next switch is -nl, load "loadup.el" first thing. */
1674 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1677 /* Set up for profiling. This is known to work on FreeBSD,
1678 GNU/Linux and MinGW. It might work on some other systems too.
1679 Give it a try and tell us if it works on your system. To compile
1680 for profiling, use the configure option --enable-profiling. */
1681 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1686 extern unsigned char etext
asm ("etext");
1692 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1701 /* Enter editor command loop. This never returns. */
1707 /* Sort the args so we can find the most important ones
1708 at the beginning of argv. */
1710 /* First, here's a table of all the standard options. */
1712 struct standard_args
1715 const char *longname
;
1720 static const struct standard_args standard_args
[] =
1722 { "-version", "--version", 150, 0 },
1723 { "-chdir", "--chdir", 130, 1 },
1724 { "-t", "--terminal", 120, 1 },
1725 { "-nw", "--no-window-system", 110, 0 },
1726 { "-nw", "--no-windows", 110, 0 },
1727 { "-batch", "--batch", 100, 0 },
1728 { "-script", "--script", 100, 1 },
1729 { "-daemon", "--daemon", 99, 0 },
1730 { "-bg-daemon", "--bg-daemon", 99, 0 },
1731 { "-fg-daemon", "--fg-daemon", 99, 0 },
1732 { "-help", "--help", 90, 0 },
1733 { "-nl", "--no-loadup", 70, 0 },
1734 { "-nsl", "--no-site-lisp", 65, 0 },
1735 { "-no-build-details", "--no-build-details", 63, 0 },
1736 { "-module-assertions", "--module-assertions", 62, 0 },
1737 /* -d must come last before the options handled in startup.el. */
1738 { "-d", "--display", 60, 1 },
1739 { "-display", 0, 60, 1 },
1740 /* Now for the options handled in `command-line' (startup.el). */
1741 /* (Note that to imply -nsl, -Q is partially handled here.) */
1742 { "-Q", "--quick", 55, 0 },
1743 { "-quick", 0, 55, 0 },
1744 { "-q", "--no-init-file", 50, 0 },
1745 { "-no-init-file", 0, 50, 0 },
1746 { "-no-x-resources", "--no-x-resources", 40, 0 },
1747 { "-no-site-file", "--no-site-file", 40, 0 },
1748 { "-u", "--user", 30, 1 },
1749 { "-user", 0, 30, 1 },
1750 { "-debug-init", "--debug-init", 20, 0 },
1751 { "-iconic", "--iconic", 15, 0 },
1752 { "-D", "--basic-display", 12, 0},
1753 { "-basic-display", 0, 12, 0},
1754 { "-nbc", "--no-blinking-cursor", 12, 0 },
1755 /* Now for the options handled in `command-line-1' (startup.el). */
1756 { "-nbi", "--no-bitmap-icon", 10, 0 },
1757 { "-bg", "--background-color", 10, 1 },
1758 { "-background", 0, 10, 1 },
1759 { "-fg", "--foreground-color", 10, 1 },
1760 { "-foreground", 0, 10, 1 },
1761 { "-bd", "--border-color", 10, 1 },
1762 { "-bw", "--border-width", 10, 1 },
1763 { "-ib", "--internal-border", 10, 1 },
1764 { "-ms", "--mouse-color", 10, 1 },
1765 { "-cr", "--cursor-color", 10, 1 },
1766 { "-fn", "--font", 10, 1 },
1767 { "-font", 0, 10, 1 },
1768 { "-fs", "--fullscreen", 10, 0 },
1769 { "-fw", "--fullwidth", 10, 0 },
1770 { "-fh", "--fullheight", 10, 0 },
1771 { "-mm", "--maximized", 10, 0 },
1772 { "-g", "--geometry", 10, 1 },
1773 { "-geometry", 0, 10, 1 },
1774 { "-T", "--title", 10, 1 },
1775 { "-title", 0, 10, 1 },
1776 { "-name", "--name", 10, 1 },
1777 { "-xrm", "--xrm", 10, 1 },
1778 { "-parent-id", "--parent-id", 10, 1 },
1779 { "-r", "--reverse-video", 5, 0 },
1781 { "-reverse", 0, 5, 0 },
1782 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1783 { "-vb", "--vertical-scroll-bars", 5, 0 },
1784 { "-color", "--color", 5, 0},
1785 { "-no-splash", "--no-splash", 3, 0 },
1786 { "-no-desktop", "--no-desktop", 3, 0 },
1788 { "-NSAutoLaunch", 0, 5, 1 },
1789 { "-NXAutoLaunch", 0, 5, 1 },
1790 { "-_NSMachLaunch", 0, 85, 1 },
1791 { "-MachLaunch", 0, 85, 1 },
1792 { "-macosx", 0, 85, 0 },
1793 { "-NSHost", 0, 85, 1 },
1795 /* These have the same priority as ordinary file name args,
1796 so they are not reordered with respect to those. */
1797 { "-L", "--directory", 0, 1 },
1798 { "-directory", 0, 0, 1 },
1799 { "-l", "--load", 0, 1 },
1800 { "-load", 0, 0, 1 },
1801 /* This has no longname, because using --scriptload confuses sort_args,
1802 because then the --script long option seems to match twice; ie
1803 you can't have a long option which is a prefix of another long
1804 option. In any case, this is entirely an internal option. */
1805 { "-scriptload", NULL
, 0, 1 },
1806 { "-f", "--funcall", 0, 1 },
1807 { "-funcall", 0, 0, 1 },
1808 { "-eval", "--eval", 0, 1 },
1809 { "-execute", "--execute", 0, 1 },
1810 { "-find-file", "--find-file", 0, 1 },
1811 { "-visit", "--visit", 0, 1 },
1812 { "-file", "--file", 0, 1 },
1813 { "-insert", "--insert", 0, 1 },
1815 { "-NXOpen", 0, 0, 1 },
1816 { "-NXOpenTemp", 0, 0, 1 },
1817 { "-NSOpen", 0, 0, 1 },
1818 { "-NSOpenTemp", 0, 0, 1 },
1819 { "-GSFilePath", 0, 0, 1 },
1821 /* This should be processed after ordinary file name args and the like. */
1822 { "-kill", "--kill", -10, 0 },
1825 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1826 so that the highest priority ones come first.
1827 Do not change the order of elements of equal priority.
1828 If an option takes an argument, keep it and its argument together.
1830 If an option that takes no argument appears more
1831 than once, eliminate all but one copy of it. */
1834 sort_args (int argc
, char **argv
)
1836 char **new = xmalloc (argc
* sizeof *new);
1837 /* For each element of argv,
1838 the corresponding element of options is:
1839 0 for an option that takes no arguments,
1840 1 for an option that takes one argument, etc.
1841 -1 for an ordinary non-option argument. */
1842 int *options
= xnmalloc (argc
, sizeof *options
);
1843 int *priority
= xnmalloc (argc
, sizeof *priority
);
1845 int incoming_used
= 1;
1849 /* Categorize all the options,
1850 and figure out which argv elts are option arguments. */
1851 for (from
= 1; from
< argc
; from
++)
1855 if (argv
[from
][0] == '-')
1859 /* If we have found "--", don't consider
1860 any more arguments as options. */
1861 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1863 /* Leave the "--", and everything following it, at the end. */
1864 for (; from
< argc
; from
++)
1866 priority
[from
] = -100;
1872 /* Look for a match with a known old-fashioned option. */
1873 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1874 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1876 options
[from
] = standard_args
[i
].nargs
;
1877 priority
[from
] = standard_args
[i
].priority
;
1878 if (from
+ standard_args
[i
].nargs
>= argc
)
1879 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1880 from
+= standard_args
[i
].nargs
;
1884 /* Look for a match with a known long option.
1885 MATCH is -1 if no match so far, -2 if two or more matches so far,
1886 >= 0 (the table index of the match) if just one match so far. */
1887 if (argv
[from
][1] == '-')
1889 char const *equals
= strchr (argv
[from
], '=');
1891 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1895 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1896 if (standard_args
[i
].longname
1897 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1906 /* If we found exactly one match, use that. */
1909 options
[from
] = standard_args
[match
].nargs
;
1910 priority
[from
] = standard_args
[match
].priority
;
1911 /* If --OPTION=VALUE syntax is used,
1912 this option uses just one argv element. */
1915 if (from
+ options
[from
] >= argc
)
1916 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1917 from
+= options
[from
];
1919 else if (match
== -2)
1921 /* This is an internal error.
1922 Eg if one long option is a prefix of another. */
1923 fprintf (stderr
, "Option '%s' matched multiple standard arguments\n", argv
[from
]);
1925 /* Should we not also warn if there was no match? */
1931 /* Copy the arguments, in order of decreasing priority, to NEW. */
1933 while (incoming_used
< argc
)
1936 int best_priority
= -9999;
1938 /* Find the highest priority remaining option.
1939 If several have equal priority, take the first of them. */
1940 for (from
= 1; from
< argc
; from
++)
1942 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1944 best_priority
= priority
[from
];
1947 /* Skip option arguments--they are tied to the options. */
1948 if (options
[from
] > 0)
1949 from
+= options
[from
];
1955 /* Copy the highest priority remaining option, with its args, to NEW.
1956 Unless it is a duplicate of the previous one. */
1957 if (! (options
[best
] == 0
1958 && ! strcmp (new[to
- 1], argv
[best
])))
1960 new[to
++] = argv
[best
];
1961 for (i
= 0; i
< options
[best
]; i
++)
1962 new[to
++] = argv
[best
+ i
+ 1];
1965 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1967 /* Clear out this option in ARGV. */
1969 for (i
= 0; i
< options
[best
]; i
++)
1970 argv
[best
+ i
+ 1] = 0;
1973 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1977 memcpy (argv
, new, sizeof (char *) * argc
);
1984 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1985 doc
: /* Exit the Emacs job and kill it.
1986 If ARG is an integer, return ARG as the exit program code.
1987 If ARG is a string, stuff it as keyboard input.
1989 This function is called upon receipt of the signals SIGTERM
1990 or SIGHUP, and upon SIGINT in batch mode.
1992 The value of `kill-emacs-hook', if not void,
1993 is a list of functions (of no args),
1994 all of which are called before Emacs is actually killed. */
1995 attributes
: noreturn
)
2000 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
2002 waiting_for_input
= 0;
2003 run_hook (Qkill_emacs_hook
);
2005 #ifdef HAVE_X_WINDOWS
2006 /* Transfer any clipboards we own to the clipboard manager. */
2007 x_clipboard_manager_save_all ();
2010 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
2013 ns_release_autorelease_pool (ns_pool
);
2016 /* If we have an auto-save list file,
2017 kill it because we are exiting Emacs deliberately (not crashing).
2018 Do it after shut_down_emacs, which does an auto-save. */
2019 if (STRINGP (Vauto_save_list_file_name
))
2021 Lisp_Object listfile
;
2022 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
2023 unlink (SSDATA (listfile
));
2027 exit_code
= (XINT (arg
) < 0
2028 ? XINT (arg
) | INT_MIN
2029 : XINT (arg
) & INT_MAX
);
2031 exit_code
= EXIT_SUCCESS
;
2036 /* Perform an orderly shutdown of Emacs. Autosave any modified
2037 buffers, kill any child processes, clean up the terminal modes (if
2038 we're in the foreground), and other stuff like that. Don't perform
2039 any redisplay; this may be called when Emacs is shutting down in
2040 the background, or after its X connection has died.
2042 If SIG is a signal number, print a message for it.
2044 This is called by fatal signal handlers, X protocol error handlers,
2048 shut_down_emacs (int sig
, Lisp_Object stuff
)
2050 /* Prevent running of hooks from now on. */
2053 /* Don't update display from now on. */
2054 Vinhibit_redisplay
= Qt
;
2056 /* If we are controlling the terminal, reset terminal modes. */
2059 pid_t pgrp
= getpgrp ();
2060 pid_t tpgrp
= tcgetpgrp (0);
2061 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2063 reset_all_sys_modes ();
2064 if (sig
&& sig
!= SIGTERM
)
2066 static char const format
[] = "Fatal error %d: ";
2067 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
2068 int buflen
= sprintf (buf
, format
, sig
);
2069 char const *sig_desc
= safe_strsignal (sig
);
2070 emacs_write (STDERR_FILENO
, buf
, buflen
);
2071 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
2077 reset_all_sys_modes ();
2080 stuff_buffered_input (stuff
);
2082 inhibit_sentinels
= 1;
2083 kill_buffer_processes (Qnil
);
2084 Fdo_auto_save (Qt
, Qnil
);
2086 unlock_all_files ();
2088 /* There is a tendency for a SIGIO signal to arrive within exit,
2089 and cause a SIGHUP because the input descriptor is already closed. */
2092 /* Do this only if terminating normally, we want glyph matrices
2093 etc. in a core dump. */
2094 if (sig
== 0 || sig
== SIGTERM
)
2096 check_glyph_memory ();
2097 check_message_stack ();
2105 ns_term_shutdown (sig
);
2109 xml_cleanup_parser ();
2123 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2124 doc
: /* Dump current state of Emacs into executable file FILENAME.
2125 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2126 This is used in the file `loadup.el' when building Emacs.
2128 You must run Emacs in batch mode in order to dump it. */)
2129 (Lisp_Object filename
, Lisp_Object symfile
)
2133 ptrdiff_t count
= SPECPDL_INDEX ();
2137 if (! noninteractive
)
2138 error ("Dumping Emacs works only in batch mode");
2141 error ("Emacs can be dumped only once");
2143 #if defined GNU_LINUX && !defined CANNOT_DUMP
2145 /* Warn if the gap between BSS end and heap start is larger than this. */
2146 # define MAX_HEAP_BSS_DIFF (1024*1024)
2148 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2150 fprintf (stderr
, "**************************************************\n");
2151 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2152 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2154 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2155 fprintf (stderr
, "fail because of this. See the section about\n");
2156 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2157 fprintf (stderr
, "**************************************************\n");
2159 #endif /* GNU_LINUX */
2161 /* Bind `command-line-processed' to nil before dumping,
2162 so that the dumped Emacs will process its command line
2163 and set up to work with X windows if appropriate. */
2164 symbol
= intern ("command-line-processed");
2165 specbind (symbol
, Qnil
);
2167 CHECK_STRING (filename
);
2168 filename
= Fexpand_file_name (filename
, Qnil
);
2169 filename
= ENCODE_FILE (filename
);
2170 if (!NILP (symfile
))
2172 CHECK_STRING (symfile
);
2173 if (SCHARS (symfile
))
2175 symfile
= Fexpand_file_name (symfile
, Qnil
);
2176 symfile
= ENCODE_FILE (symfile
);
2181 Vpurify_flag
= Qnil
;
2183 #ifdef HYBRID_MALLOC
2185 static char const fmt
[] = "%d of %d static heap bytes used";
2186 char buf
[sizeof fmt
+ 2 * (INT_STRLEN_BOUND (int) - 2)];
2187 int max_usage
= max_bss_sbrk_ptr
- bss_sbrk_buffer
;
2188 sprintf (buf
, fmt
, max_usage
, STATIC_HEAP_SIZE
);
2189 /* Don't log messages, because at this point buffers cannot be created. */
2190 message1_nolog (buf
);
2195 /* Tell malloc where start of impure now is. */
2196 /* Also arrange for warnings when nearly out of space. */
2197 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2199 /* On Windows, this was done before dumping, and that once suffices.
2200 Meanwhile, my_edata is not valid on Windows. */
2201 memory_warnings (my_edata
, malloc_warning
);
2202 #endif /* not WINDOWSNT */
2203 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2205 alloc_unexec_pre ();
2207 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2209 alloc_unexec_post ();
2212 Vlibrary_cache
= Qnil
;
2214 #ifdef HAVE_WINDOW_SYSTEM
2215 reset_image_types ();
2220 return unbind_to (count
, Qnil
);
2223 #endif /* not CANNOT_DUMP */
2226 /* Recover from setlocale (LC_ALL, ""). */
2230 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2231 so that numbers are read and printed properly for Emacs Lisp. */
2232 setlocale (LC_NUMERIC
, "C");
2235 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2238 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2240 if (! EQ (*plocale
, desired_locale
))
2242 *plocale
= desired_locale
;
2244 /* Changing categories like LC_TIME usually requires specifying
2245 an encoding suitable for the new locale, but MS-Windows's
2246 'setlocale' will only switch the encoding when LC_ALL is
2247 specified. So we ignore CATEGORY, use LC_ALL instead, and
2248 then restore LC_NUMERIC to "C", so reading and printing
2249 numbers is unaffected. */
2250 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2251 ? SSDATA (desired_locale
)
2254 #else /* !WINDOWSNT */
2255 setlocale (category
, (STRINGP (desired_locale
)
2256 ? SSDATA (desired_locale
)
2258 #endif /* !WINDOWSNT */
2262 /* Set system time locale to match Vsystem_time_locale, if possible. */
2264 synchronize_system_time_locale (void)
2266 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2267 Vsystem_time_locale
);
2270 /* Set system messages locale to match Vsystem_messages_locale, if
2273 synchronize_system_messages_locale (void)
2276 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2277 Vsystem_messages_locale
);
2280 #endif /* HAVE_SETLOCALE */
2282 /* Return a diagnostic string for ERROR_NUMBER, in the wording
2283 and encoding appropriate for the current locale. */
2285 emacs_strerror (int error_number
)
2287 synchronize_system_messages_locale ();
2288 return strerror (error_number
);
2293 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2295 const char *path
, *p
;
2296 Lisp_Object lpath
, element
, tem
;
2297 /* Default is to use "." for empty path elements.
2298 But if argument EMPTY is true, use nil instead. */
2299 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2302 static const char *emacs_dir_env
= "%emacs_dir%/";
2303 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2304 const char *edir
= egetenv ("emacs_dir");
2305 char emacs_dir
[MAX_UTF8_PATH
];
2307 /* egetenv looks in process-environment, which holds the variables
2308 in their original system-locale encoding. We need emacs_dir to
2311 filename_from_ansi (edir
, emacs_dir
);
2314 /* It's okay to use getenv here, because this function is only used
2315 to initialize variables when Emacs starts up, and isn't called
2318 path
= getenv (evarname
);
2329 /* Ensure values from the environment use the proper directory separator. */
2335 char *path_utf8
, *q
, *d
;
2338 /* Convert each element of PATH to UTF-8. */
2339 p
= path_copy
= alloca (strlen (path
) + 1);
2340 strcpy (path_copy
, path
);
2341 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2344 q
= _mbschr (p
, SEPCHAR
);
2347 cnv_result
= filename_from_ansi (p
, d
);
2352 /* If conversion of this PATH elements fails, make sure
2353 destination pointer will stay put, thus effectively
2354 ignoring the offending element. */
2355 if (cnv_result
== 0)
2361 else if (cnv_result
!= 0 && d
> path_utf8
)
2362 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2364 path_copy
= path_utf8
;
2366 path_copy
= alloca (strlen (path
) + 1);
2367 strcpy (path_copy
, path
);
2369 dostounix_filename (path_copy
);
2376 p
= strchr (path
, SEPCHAR
);
2378 p
= path
+ strlen (path
);
2379 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2381 if (! NILP (element
))
2384 /* Relative file names in the default path are interpreted as
2385 being relative to $emacs_dir. */
2386 if (edir
&& defaulted
2387 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2388 element
= Fexpand_file_name (Fsubstring
2390 make_number (emacs_dir_len
),
2392 build_unibyte_string (emacs_dir
));
2395 /* Add /: to the front of the name
2396 if it would otherwise be treated as magic. */
2397 tem
= Ffind_file_name_handler (element
, Qt
);
2399 /* However, if the handler says "I'm safe",
2400 don't bother adding /:. */
2404 prop
= Fget (tem
, intern ("safe-magic"));
2411 AUTO_STRING (slash_colon
, "/:");
2412 element
= concat2 (slash_colon
, element
);
2414 } /* !NILP (element) */
2416 lpath
= Fcons (element
, lpath
);
2422 return Fnreverse (lpath
);
2425 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2426 doc
: /* Return non-nil if the current emacs process is a daemon.
2427 If the daemon was given a name argument, return that name. */)
2432 return build_string (daemon_name
);
2439 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2440 doc
: /* Mark the Emacs daemon as being initialized.
2441 This finishes the daemonization process by doing the other half of detaching
2442 from the parent process and its tty file descriptors. */)
2448 error ("This function can only be called if emacs is run as a daemon");
2450 if (!DAEMON_RUNNING
)
2451 error ("The daemon has already been initialized");
2453 if (NILP (Vafter_init_time
))
2454 error ("This function can only be called after loading the init files");
2457 if (daemon_type
== 2)
2461 /* Get rid of stdin, stdout and stderr. */
2462 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2464 err
|= dup2 (nfd
, STDIN_FILENO
) < 0;
2465 err
|= dup2 (nfd
, STDOUT_FILENO
) < 0;
2466 err
|= dup2 (nfd
, STDERR_FILENO
) < 0;
2467 err
|= emacs_close (nfd
) != 0;
2469 /* Closing the pipe will notify the parent that it can exit.
2470 FIXME: In case some other process inherited the pipe, closing it here
2471 won't notify the parent because it's still open elsewhere, so we
2472 additionally send a byte, just to make sure the parent really exits.
2473 Instead, we should probably close the pipe in start-process and
2474 call-process to make sure the pipe is never inherited by
2476 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2477 err
|= emacs_close (daemon_pipe
[1]) != 0;
2480 /* Set it to an invalid value so we know we've already run this function. */
2483 #else /* WINDOWSNT */
2484 /* Signal the waiting emacsclient process. */
2485 err
|= SetEvent (w32_daemon_event
) == 0;
2486 err
|= CloseHandle (w32_daemon_event
) == 0;
2487 /* Set it to an invalid value so we know we've already run this function. */
2488 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2492 error ("I/O error during daemon initialization");
2497 syms_of_emacs (void)
2499 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2500 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2501 DEFSYM (Qkill_emacs
, "kill-emacs");
2502 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2505 defsubr (&Sdump_emacs
);
2508 defsubr (&Skill_emacs
);
2510 defsubr (&Sinvocation_name
);
2511 defsubr (&Sinvocation_directory
);
2512 defsubr (&Sdaemonp
);
2513 defsubr (&Sdaemon_initialized
);
2515 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2516 doc
: /* Args passed by shell to Emacs, as a list of strings.
2517 Many arguments are deleted from the list as they are processed. */);
2519 DEFVAR_LISP ("system-type", Vsystem_type
,
2520 doc
: /* The value is a symbol indicating the type of operating system you are using.
2522 `gnu' compiled for a GNU Hurd system.
2523 `gnu/linux' compiled for a GNU/Linux system.
2524 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2525 `darwin' compiled for Darwin (GNU-Darwin, macOS, ...).
2526 `ms-dos' compiled as an MS-DOS application.
2527 `windows-nt' compiled as a native W32 application.
2528 `cygwin' compiled using the Cygwin library.
2529 Anything else (in Emacs 26, the possibilities are: aix, berkeley-unix,
2530 hpux, usg-unix-v) indicates some sort of Unix system. */);
2531 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2532 /* See configure.ac for the possible SYSTEM_TYPEs. */
2534 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2535 doc
: /* Value is string indicating configuration Emacs was built for. */);
2536 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2538 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2539 doc
: /* String containing the configuration options Emacs was built with. */);
2540 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2542 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2543 doc
: /* String listing some of the main features this Emacs was compiled with.
2544 An element of the form \"FOO\" generally means that HAVE_FOO was
2545 defined during the build.
2547 This is mainly intended for diagnostic purposes in bug reports.
2548 Don't rely on it for testing whether a feature you want to use is available. */);
2549 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2551 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2552 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2554 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2555 doc
: /* Hook run when `kill-emacs' is called.
2556 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2557 in other similar situations), functions placed on this hook should not
2558 expect to be able to interact with the user. To ask for confirmation,
2559 see `kill-emacs-query-functions' instead.
2561 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2562 `noninteractive' was non-nil. */);
2563 Vkill_emacs_hook
= Qnil
;
2565 DEFVAR_LISP ("path-separator", Vpath_separator
,
2566 doc
: /* String containing the character that separates directories in
2567 search paths, such as PATH and other similar environment variables. */);
2570 Vpath_separator
= make_string (&c
, 1);
2573 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2574 doc
: /* The program name that was used to run Emacs.
2575 Any directory names are omitted. */);
2577 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2578 doc
: /* The directory in which the Emacs executable was found, to run it.
2579 The value is nil if that directory's name is not known. */);
2581 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2582 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2583 In an installed Emacs, this is normally nil. It is non-nil if
2584 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2585 within the variable `invocation-directory' or its parent. For example,
2586 this is the case when running an uninstalled Emacs executable from its
2587 build directory. */);
2588 Vinstallation_directory
= Qnil
;
2590 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2591 doc
: /* System locale for messages. */);
2592 Vsystem_messages_locale
= Qnil
;
2594 DEFVAR_LISP ("previous-system-messages-locale",
2595 Vprevious_system_messages_locale
,
2596 doc
: /* Most recently used system locale for messages. */);
2597 Vprevious_system_messages_locale
= Qnil
;
2599 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2600 doc
: /* System locale for time. */);
2601 Vsystem_time_locale
= Qnil
;
2603 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2604 doc
: /* Most recently used system locale for time. */);
2605 Vprevious_system_time_locale
= Qnil
;
2607 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2608 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2609 Vbefore_init_time
= Qnil
;
2611 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2612 doc
: /* Value of `current-time' after loading the init files.
2613 This is nil during initialization. */);
2614 Vafter_init_time
= Qnil
;
2616 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2617 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2618 inhibit_x_resources
= 0;
2620 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2621 doc
: /* Short copyright string for this version of Emacs. */);
2622 Vemacs_copyright
= build_string (emacs_copyright
);
2624 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2625 doc
: /* Version numbers of this version of Emacs.
2626 This has the form: MAJOR.MINOR[.MICRO], where MAJOR/MINOR/MICRO are integers.
2627 MICRO is only present in unreleased development versions,
2628 and is not especially meaningful. Prior to Emacs 26.1, an extra final
2629 component .BUILD is present. This is now stored separately in
2630 `emacs-build-number'. */);
2631 Vemacs_version
= build_string (emacs_version
);
2633 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2634 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2635 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2637 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2638 doc
: /* Alist of dynamic libraries vs external files implementing them.
2639 Each element is a list (LIBRARY FILE...), where the car is a symbol
2640 representing a supported external library, and the rest are strings giving
2641 alternate filenames for that library.
2643 Emacs tries to load the library from the files in the order they appear on
2644 the list; if none is loaded, the running session of Emacs won't have access
2647 Note that image types `pbm' and `xbm' do not need entries in this variable
2648 because they do not depend on external libraries and are always available.
2650 Also note that this is not a generic facility for accessing external
2651 libraries; only those already known by Emacs will be loaded. */);
2652 Vdynamic_library_alist
= Qnil
;
2653 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2656 Vlibrary_cache
= Qnil
;
2657 staticpro (&Vlibrary_cache
);