1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2018 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 <https://www.gnu.org/licenses/>. */
21 #define INLINE EXTERN_INLINE
31 #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"
86 #include "ptr-bounds.h"
90 #include "sysselect.h"
94 #include "getpagesize.h"
98 # include <sys/gmon.h>
99 extern void moncontrol (int mode
);
101 extern unsigned char etext
asm ("etext");
107 #ifdef HAVE_SETLOCALE
115 #ifdef HAVE_SETRLIMIT
116 #include <sys/time.h>
117 #include <sys/resource.h>
120 static const char emacs_version
[] = PACKAGE_VERSION
;
121 static const char emacs_copyright
[] = COPYRIGHT
;
122 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
124 /* Empty lisp strings. To avoid having to build any others. */
125 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
128 /* Cache for externally loaded libraries. */
129 Lisp_Object Vlibrary_cache
;
132 /* Set after Emacs has started up the first time.
133 Prevents reinitialization of the Lisp world and keymaps
134 on subsequent starts. */
138 /* Set to true if this instance of Emacs might dump. */
139 # ifndef DOUG_LEA_MALLOC
145 /* If true, Emacs should not attempt to use a window-specific code,
146 but instead should use the virtual terminal under which it was started. */
147 bool inhibit_window_system
;
149 /* If true, a filter or a sentinel is running. Tested to save the match
150 data on the first attempt to change it inside asynchronous code. */
151 bool running_asynch_code
;
153 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
154 /* If true, -d was specified, meaning we're using some window system. */
158 #if defined GNU_LINUX && !defined CANNOT_DUMP
159 /* The gap between BSS end and heap start as far as we can tell. */
160 static uprintmax_t heap_bss_diff
;
163 /* To run as a background daemon under Cocoa or Windows,
164 we must do a fork+exec, not a simple fork.
166 On Cocoa, CoreFoundation lib fails in forked process:
167 http://developer.apple.com/ReleaseNotes/
168 CoreFoundation/CoreFoundation.html)
170 On Windows, a Cygwin fork child cannot access the USER subsystem.
172 We mark being in the exec'd process by a daemon name argument of
173 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
174 NAME is the original daemon name, if any. */
175 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
176 # define DAEMON_MUST_EXEC
179 /* True means running Emacs without interactive terminal. */
182 /* True means remove site-lisp directories from load-path. */
185 /* True means put details like time stamps into builds. */
188 /* Name for the server started by the daemon.*/
189 static char *daemon_name
;
191 /* 0 not a daemon, 1 new-style (foreground), 2 old-style (background). */
195 /* Pipe used to send exit notification to the background daemon parent at
196 startup. On Windows, we use a kernel event instead. */
197 static int daemon_pipe
[2];
199 HANDLE w32_daemon_event
;
202 /* Save argv and argc. */
206 static void sort_args (int argc
, char **argv
);
207 static void syms_of_emacs (void);
209 /* C99 needs each string to be at most 4095 characters, and the usage
210 strings below are split to not overflow this limit. */
211 static char const *const usage_message
[] =
214 Run Emacs, the extensible, customizable, self-documenting real-time\n\
215 display editor. The recommended way to start Emacs for normal editing\n\
216 is with no options at all.\n\
218 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
219 read the main documentation for these command-line arguments.\n\
221 Initialization options:\n\
225 --batch do not do interactive display; implies -q\n\
226 --chdir DIR change to directory DIR\n\
227 --daemon, --bg-daemon[=NAME] start a (named) server in the background\n\
228 --fg-daemon[=NAME] start a (named) server in the foreground\n\
229 --debug-init enable Emacs Lisp debugger for init file\n\
230 --display, -d DISPLAY use X server DISPLAY\n\
234 --module-assertions assert behavior of dynamic modules\n\
238 --no-build-details do not add build details such as time stamps\n\
239 --no-desktop do not load a saved desktop\n\
240 --no-init-file, -q load neither ~/.emacs nor default.el\n\
241 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
242 --no-site-file do not load site-start.el\n\
243 --no-x-resources do not load X resources\n\
244 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
245 --no-splash do not display a splash screen on startup\n\
246 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
249 --quick, -Q equivalent to:\n\
250 -q --no-site-file --no-site-lisp --no-splash\n\
252 --script FILE run FILE as an Emacs Lisp script\n\
253 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
254 --user, -u USER load ~USER/.emacs instead of your own\n\
261 +LINE go to line LINE in next FILE\n\
262 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
263 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
264 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
265 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
268 --file FILE visit FILE\n\
269 --find-file FILE visit FILE\n\
270 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
271 --insert FILE insert contents of FILE into current buffer\n\
272 --kill exit without asking for confirmation\n\
273 --load, -l FILE load Emacs Lisp FILE using the load function\n\
274 --visit FILE visit FILE\n\
280 --background-color, -bg COLOR window background color\n\
281 --basic-display, -D disable many display features;\n\
282 used for debugging Emacs\n\
283 --border-color, -bd COLOR main border color\n\
284 --border-width, -bw WIDTH width of main border\n\
287 --color, --color=MODE override color mode for character terminals;\n\
288 MODE defaults to `auto', and\n\
289 can also be `never', `always',\n\
290 or a mode name like `ansi8'\n\
291 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
292 --font, -fn FONT default font; must be fixed-width\n\
293 --foreground-color, -fg COLOR window foreground color\n\
296 --fullheight, -fh make the first frame high as the screen\n\
297 --fullscreen, -fs make the first frame fullscreen\n\
298 --fullwidth, -fw make the first frame wide as the screen\n\
299 --maximized, -mm make the first frame maximized\n\
300 --geometry, -g GEOMETRY window geometry\n\
303 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
304 --iconic start Emacs in iconified state\n\
305 --internal-border, -ib WIDTH width between text and main border\n\
306 --line-spacing, -lsp PIXELS additional space to put between lines\n\
307 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
308 --name NAME title for initial Emacs frame\n\
311 --no-blinking-cursor, -nbc disable blinking cursor\n\
312 --reverse-video, -r, -rv switch foreground and background\n\
313 --title, -T TITLE title for initial Emacs frame\n\
314 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
315 --xrm XRESOURCES set additional X resources\n\
316 --parent-id XID set parent window\n\
317 --help display this help and exit\n\
318 --version output version information and exit\n\
322 You can generally also specify long option names with a single -; for\n\
323 example, -batch as well as --batch. You can use any unambiguous\n\
324 abbreviation for a --option.\n\
326 Various environment variables and window system resources also affect\n\
327 the operation of Emacs. See the main documentation.\n\
329 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
330 section of the Emacs manual or the file BUGS.\n"
334 /* True if handling a fatal error already. */
335 bool fatal_error_in_progress
;
338 /* NS autrelease pool, for memory management. */
339 static void *ns_pool
;
344 setlocale (int cat
, char const *locale
)
350 /* True if the current system locale uses UTF-8 encoding. */
356 mbstate_t mbs
= { 0 };
357 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
364 /* Report a fatal error due to signal SIG, output a backtrace of at
365 most BACKTRACE_LIMIT lines, and exit. */
367 terminate_due_to_signal (int sig
, int backtrace_limit
)
369 signal (sig
, SIG_DFL
);
371 if (attempt_orderly_shutdown_on_fatal_signal
)
373 /* If fatal error occurs in code below, avoid infinite recursion. */
374 if (! fatal_error_in_progress
)
376 fatal_error_in_progress
= 1;
378 totally_unblock_input ();
379 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
380 Fkill_emacs (make_number (sig
));
382 shut_down_emacs (sig
, Qnil
);
383 emacs_backtrace (backtrace_limit
);
387 /* Signal the same code; this time it will really be fatal.
388 Since we're in a signal handler, the signal is blocked, so we
389 have to unblock it if we want to really receive it. */
393 sigemptyset (&unblocked
);
394 sigaddset (&unblocked
, sig
);
395 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
401 /* This shouldn't be executed, but it prevents a warning. */
405 /* Code for dealing with Lisp access to the Unix command line. */
408 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
411 Lisp_Object name
, dir
, handler
;
412 ptrdiff_t count
= SPECPDL_INDEX ();
413 Lisp_Object raw_name
;
414 AUTO_STRING (slash_colon
, "/:");
420 /* Must use argv[0] converted to UTF-8, as it begets many standard
421 file and directory names. */
423 char argv0
[MAX_UTF8_PATH
];
425 if (filename_from_ansi (argv
[0], argv0
) == 0)
426 raw_name
= build_unibyte_string (argv0
);
428 raw_name
= build_unibyte_string (argv
[0]);
431 raw_name
= build_unibyte_string (argv
[0]);
434 /* Add /: to the front of the name
435 if it would otherwise be treated as magic. */
436 handler
= Ffind_file_name_handler (raw_name
, Qt
);
437 if (! NILP (handler
))
438 raw_name
= concat2 (slash_colon
, raw_name
);
440 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
441 Vinvocation_directory
= Ffile_name_directory (raw_name
);
443 /* If we got no directory in argv[0], search PATH to find where
444 Emacs actually came from. */
445 if (NILP (Vinvocation_directory
))
448 int yes
= openp (Vexec_path
, Vinvocation_name
,
449 Vexec_suffixes
, &found
, make_number (X_OK
), false);
452 /* Add /: to the front of the name
453 if it would otherwise be treated as magic. */
454 handler
= Ffind_file_name_handler (found
, Qt
);
455 if (! NILP (handler
))
456 found
= concat2 (slash_colon
, found
);
457 Vinvocation_directory
= Ffile_name_directory (found
);
461 if (!NILP (Vinvocation_directory
)
462 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
463 /* Emacs was started with relative path, like ./emacs.
467 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
469 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
472 Vinstallation_directory
= Qnil
;
474 if (!NILP (Vinvocation_directory
))
476 if (NILP (Vpurify_flag
) && !NILP (Ffboundp (Qfile_truename
)))
477 Vinvocation_directory
= call1 (Qfile_truename
, Vinvocation_directory
);
479 dir
= Vinvocation_directory
;
481 /* If we are running from the build directory, set DIR to the
482 src subdirectory of the Emacs tree, like on Posix
484 if (SBYTES (dir
) > sizeof ("/i386/") - 1
485 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
487 dir
= Fexpand_file_name (build_string ("../.."), dir
);
488 #else /* !WINDOWSNT */
490 name
= Fexpand_file_name (Vinvocation_name
, dir
);
493 Lisp_Object tem
, lib_src_exists
;
494 Lisp_Object etc_exists
, info_exists
;
496 /* See if dir contains subdirs for use by Emacs.
497 Check for the ones that would exist in a build directory,
498 not including lisp and info. */
499 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
500 lib_src_exists
= Ffile_exists_p (tem
);
503 /* MSDOS installations frequently remove lib-src, but we still
504 must set installation-directory, or else info won't find
505 its files (it uses the value of installation-directory). */
506 tem
= Fexpand_file_name (build_string ("info"), dir
);
507 info_exists
= Ffile_exists_p (tem
);
512 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
514 tem
= Fexpand_file_name (build_string ("etc"), dir
);
515 etc_exists
= Ffile_exists_p (tem
);
516 if (!NILP (etc_exists
))
518 Vinstallation_directory
519 = Ffile_name_as_directory (dir
);
524 /* See if dir's parent contains those subdirs. */
525 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
526 lib_src_exists
= Ffile_exists_p (tem
);
530 /* See the MSDOS commentary above. */
531 tem
= Fexpand_file_name (build_string ("../info"), dir
);
532 info_exists
= Ffile_exists_p (tem
);
537 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
539 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
540 etc_exists
= Ffile_exists_p (tem
);
541 if (!NILP (etc_exists
))
543 tem
= Fexpand_file_name (build_string (".."), dir
);
544 Vinstallation_directory
545 = Ffile_name_as_directory (tem
);
550 /* If the Emacs executable is actually a link,
551 next try the dir that the link points into. */
552 tem
= Ffile_symlink_p (name
);
555 name
= Fexpand_file_name (tem
, dir
);
556 dir
= Ffile_name_directory (name
);
563 Vcommand_line_args
= Qnil
;
565 for (i
= argc
- 1; i
>= 0; i
--)
567 if (i
== 0 || i
> skip_args
)
568 /* For the moment, we keep arguments as is in unibyte strings.
569 They are decoded in the function command-line after we know
570 locale-coding-system. */
572 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
575 unbind_to (count
, Qnil
);
578 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
579 doc
: /* Return the program name that was used to run Emacs.
580 Any directory names are omitted. */)
583 return Fcopy_sequence (Vinvocation_name
);
586 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
588 doc
: /* Return the directory name in which the Emacs executable was located. */)
591 return Fcopy_sequence (Vinvocation_directory
);
595 /* Test whether the next argument in ARGV matches SSTR or a prefix of
596 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
597 (the argument is supposed to have a value) store in *VALPTR either
598 the next argument or the portion of this one after the equal sign.
599 ARGV is read starting at position *SKIPPTR; this index is advanced
600 by the number of arguments used.
602 Too bad we can't just use getopt for all of this, but we don't have
603 enough information to do it right. */
606 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
607 int minlen
, char **valptr
, int *skipptr
)
613 /* Don't access argv[argc]; give up in advance. */
614 if (argc
<= *skipptr
+ 1)
617 arg
= argv
[*skipptr
+1];
620 if (strcmp (arg
, sstr
) == 0)
624 *valptr
= argv
[*skipptr
+2];
631 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
632 ? p
- arg
: strlen (arg
));
633 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
635 else if (valptr
== NULL
)
646 else if (argv
[*skipptr
+2] != NULL
)
648 *valptr
= argv
[*skipptr
+2];
658 /* Close standard output and standard error, reporting any write
659 errors as best we can. This is intended for use with atexit. */
661 close_output_streams (void)
663 if (close_stream (stdout
) != 0)
665 emacs_perror ("Write error to standard output");
666 _exit (EXIT_FAILURE
);
669 /* Do not close stderr if addresses are being sanitized, as the
670 sanitizer might report to stderr after this function is
672 if (!ADDRESS_SANITIZER
&& close_stream (stderr
) != 0)
673 _exit (EXIT_FAILURE
);
678 main (int argc
, char **argv
)
680 /* Variable near the bottom of the stack, and aligned appropriately
682 void *stack_bottom_variable
;
684 bool do_initial_setlocale
;
687 bool no_loadup
= false;
690 #ifdef DAEMON_MUST_EXEC
695 /* If we use --chdir, this records the original directory. */
696 char *original_pwd
= 0;
698 /* Record (approximately) where the stack begins. */
699 stack_bottom
= (char *) &stack_bottom_variable
;
702 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
703 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
708 /* True if address randomization interferes with memory allocation. */
710 bool disable_aslr
= true;
712 bool disable_aslr
= dumping
;
715 if (disable_aslr
&& disable_address_randomization ())
717 /* Set this so the personality will be reverted before execs
719 xputenv ("EMACS_HEAP_EXEC=true");
721 /* Address randomization was enabled, but is now disabled.
722 Re-execute Emacs to get a clean slate. */
723 execvp (argv
[0], argv
);
725 /* If the exec fails, warn and then try anyway. */
730 might_dump
= !initialized
;
735 char *heap_start
= my_heap_start ();
736 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
741 #if defined WINDOWSNT || defined HAVE_NTGUI
742 /* Set global variables used to detect Windows version. Do this as
743 early as possible. (unexw32.c calls this function as well, but
744 the additional call here is harmless.) */
745 cache_system_info ();
747 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
748 to have non-stub implementations of APIs we need to convert file
749 names between UTF-8 and the system's ANSI codepage. */
750 maybe_load_unicows_dll ();
751 /* Initialize the codepage for file names, needed to decode
752 non-ASCII file names during startup. */
753 w32_init_file_name_codepage ();
755 w32_init_main_thread ();
758 #ifdef RUN_TIME_REMAP
760 run_time_remap (argv
[0]);
763 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
764 #if defined DARWIN_OS && !defined CANNOT_DUMP
766 unexec_init_emacs_zone ();
769 init_standard_fds ();
770 atexit (close_output_streams
);
772 sort_args (argc
, argv
);
774 while (argv
[argc
]) argc
++;
776 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
778 const char *version
, *copyright
;
781 Lisp_Object tem
, tem2
;
782 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
783 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
786 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
791 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
796 version
= SSDATA (tem
);
797 copyright
= SSDATA (tem2
);
802 version
= emacs_version
;
803 copyright
= emacs_copyright
;
805 printf ("%s %s\n", PACKAGE_NAME
, version
);
806 printf ("%s\n", copyright
);
807 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
808 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
809 printf ("under the terms of the GNU General Public License.\n");
810 printf ("For more information about these matters, ");
811 printf ("see the file named COPYING.\n");
815 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
818 /* argv[] array is kept in its original ANSI codepage encoding,
819 we need to convert to UTF-8, for chdir to work. */
820 char newdir
[MAX_UTF8_PATH
];
822 filename_from_ansi (ch_to_dir
, newdir
);
825 original_pwd
= emacs_get_current_dir_name ();
826 if (chdir (ch_to_dir
) != 0)
828 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
829 argv
[0], ch_to_dir
, strerror (errno
));
834 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
835 /* Extend the stack space available. Don't do that if dumping,
836 since some systems (e.g. DJGPP) might define a smaller stack
837 limit at that time. And it's not needed on Cygwin, since emacs
838 is built with an 8MB stack. Moreover, the setrlimit call can
839 cause problems on Cygwin
840 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
842 if (getrlimit (RLIMIT_STACK
, &rlim
) == 0
843 && 0 <= rlim
.rlim_cur
&& rlim
.rlim_cur
<= LONG_MAX
)
845 rlim_t lim
= rlim
.rlim_cur
;
847 /* Approximate the amount regex.c needs per unit of
848 emacs_re_max_failures, then add 33% to cover the size of the
849 smaller stacks that regex.c successively allocates and
850 discards on its way to the maximum. */
851 int min_ratio
= 20 * sizeof (char *);
852 int ratio
= min_ratio
+ min_ratio
/ 3;
854 /* Extra space to cover what we're likely to use for other
855 reasons. For example, a typical GC might take 30K stack
857 int extra
= (30 * 1000) * 50;
859 bool try_to_grow_stack
= true;
861 try_to_grow_stack
= !noninteractive
|| initialized
;
864 if (try_to_grow_stack
)
866 rlim_t newlim
= emacs_re_max_failures
* ratio
+ extra
;
868 /* Round the new limit to a page boundary; this is needed
869 for Darwin kernel 15.4.0 (see Bug#23622) and perhaps
870 other systems. Do not shrink the stack and do not exceed
871 rlim_max. Don't worry about exact values of
872 RLIM_INFINITY etc. since in practice when they are
873 nonnegative they are so large that the code does the
874 right thing anyway. */
875 long pagesize
= getpagesize ();
876 newlim
+= pagesize
- 1;
877 if (0 <= rlim
.rlim_max
&& rlim
.rlim_max
< newlim
)
878 newlim
= rlim
.rlim_max
;
879 newlim
-= newlim
% pagesize
;
881 if (pagesize
<= newlim
- lim
)
883 rlim
.rlim_cur
= newlim
;
884 if (setrlimit (RLIMIT_STACK
, &rlim
) == 0)
888 /* If the stack is big enough, let regex.c more of it before
889 falling back to heap allocation. */
890 emacs_re_safe_alloca
= max
891 (min (lim
- extra
, SIZE_MAX
) * (min_ratio
/ ratio
),
894 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
896 clearerr_unlocked (stdin
);
898 emacs_backtrace (-1);
900 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
901 /* Arrange to get warning messages as memory fills up. */
902 memory_warnings (0, malloc_warning
);
904 /* Call malloc at least once, to run malloc_initialize_hook.
905 Also call realloc and free for consistency. */
906 free (realloc (malloc (4), 4));
908 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
911 set_binary_mode (STDIN_FILENO
, O_BINARY
);
913 set_binary_mode (STDOUT_FILENO
, O_BINARY
);
916 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
917 The build procedure uses this while dumping, to ensure that the
918 dumped Emacs does not have its system locale tables initialized,
919 as that might cause screwups when the dumped Emacs starts up. */
921 char *lc_all
= getenv ("LC_ALL");
922 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
925 /* Set locale now, so that initial error messages are localized properly.
926 fixup_locale must wait until later, since it builds strings. */
927 if (do_initial_setlocale
)
928 setlocale (LC_ALL
, "");
929 text_quoting_flag
= using_utf8 ();
931 inhibit_window_system
= 0;
933 /* Handle the -t switch, which specifies filename to use as terminal. */
937 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
939 emacs_close (STDIN_FILENO
);
940 emacs_close (STDOUT_FILENO
);
941 int result
= emacs_open (term
, O_RDWR
, 0);
942 if (result
!= STDIN_FILENO
943 || (fcntl (STDIN_FILENO
, F_DUPFD_CLOEXEC
, STDOUT_FILENO
)
946 char *errstring
= strerror (errno
);
947 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
950 if (! isatty (STDIN_FILENO
))
952 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
955 fprintf (stderr
, "Using %s\n", term
);
956 #ifdef HAVE_WINDOW_SYSTEM
957 inhibit_window_system
= true; /* -t => -nw */
964 /* Command line option --no-windows is deprecated and thus not mentioned
965 in the manual and usage information. */
966 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
967 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
968 inhibit_window_system
= 1;
970 /* Handle the -batch switch, which means don't do interactive display. */
972 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
975 Vundo_outer_limit
= Qnil
;
977 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
979 noninteractive
= 1; /* Set batch mode. */
980 /* Convert --script to -scriptload, un-skip it, and sort again
981 so that it will be handled in proper sequence. */
982 /* FIXME broken for --script=FILE - is that supposed to work? */
983 argv
[skip_args
- 1] = (char *) "-scriptload";
985 sort_args (argc
, argv
);
988 /* Handle the --help option, which gives a usage message. */
989 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
992 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
993 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
994 fputs_unlocked (usage_message
[i
], stdout
);
1001 /* Make sure IS_DAEMON starts up as false. */
1004 w32_daemon_event
= NULL
;
1010 if (argmatch (argv
, argc
, "-fg-daemon", "--fg-daemon", 10, NULL
, &skip_args
)
1011 || argmatch (argv
, argc
, "-fg-daemon", "--fg-daemon", 10, &dname_arg
, &skip_args
))
1013 daemon_type
= 1; /* foreground */
1015 else if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
1016 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
)
1017 || argmatch (argv
, argc
, "-bg-daemon", "--bg-daemon", 10, NULL
, &skip_args
)
1018 || argmatch (argv
, argc
, "-bg-daemon", "--bg-daemon", 10, &dname_arg
, &skip_args
))
1020 daemon_type
= 2; /* background */
1024 if (daemon_type
> 0)
1027 if (daemon_type
== 2)
1029 /* Start as a background daemon: fork a new child process which
1030 will run the rest of the initialization code, then exit.
1032 Detaching a daemon requires the following steps:
1036 - close the tty file-descriptors
1038 We only want to do the last 2 steps once the daemon is ready to
1039 serve requests, i.e. after loading .emacs (initialization).
1040 OTOH initialization may start subprocesses (e.g. ispell) and these
1041 should be run from the proper process (the one that will end up
1042 running as daemon) and with the proper "session id" in order for
1043 them to keep working after detaching, so fork and setsid need to be
1044 performed before initialization.
1046 We want to avoid exiting before the server socket is ready, so
1047 use a pipe for synchronization. The parent waits for the child
1048 to close its end of the pipe (using `daemon-initialized')
1050 if (emacs_pipe (daemon_pipe
) != 0)
1052 fprintf (stderr
, "Cannot pipe!\n");
1055 } /* daemon_type == 2 */
1057 #ifdef HAVE_LIBSYSTEMD
1058 /* Read the number of sockets passed through by systemd. */
1059 int systemd_socket
= sd_listen_fds (1);
1061 if (systemd_socket
> 1)
1064 "Warning: systemd passed more than one socket to Emacs.\n"
1065 "Try 'Accept=false' in the Emacs socket unit file.\n"));
1066 else if (systemd_socket
== 1
1067 && (0 < sd_is_socket (SD_LISTEN_FDS_START
,
1068 AF_UNSPEC
, SOCK_STREAM
, 1)))
1069 sockfd
= SD_LISTEN_FDS_START
;
1070 #endif /* HAVE_LIBSYSTEMD */
1073 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttps://gitlab.gnome.org/GNOME/gtk/issues/221\n\
1074 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1075 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1076 #endif /* USE_GTK */
1078 if (daemon_type
== 2)
1081 #ifndef DAEMON_MUST_EXEC
1084 #else /* DAEMON_MUST_EXEC */
1085 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1086 f
= fork (); /* in orig */
1088 f
= 0; /* in exec'd */
1089 #endif /* !DAEMON_MUST_EXEC */
1095 /* Close unused writing end of the pipe. */
1096 emacs_close (daemon_pipe
[1]);
1098 /* Just wait for the child to close its end of the pipe. */
1101 retval
= read (daemon_pipe
[0], &buf
, 1);
1103 while (retval
== -1 && errno
== EINTR
);
1107 fprintf (stderr
, "Error reading status from child\n");
1110 else if (retval
== 0)
1112 fprintf (stderr
, "Error: server did not start correctly\n");
1116 emacs_close (daemon_pipe
[0]);
1121 emacs_perror ("fork");
1122 exit (EXIT_CANCELED
);
1125 #ifdef DAEMON_MUST_EXEC
1127 /* In orig process, forked as child, OR in exec'd. */
1128 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1129 { /* In orig, child: now exec w/special daemon name. */
1132 snprintf (fdStr
, sizeof fdStr
,
1133 "--bg-daemon=\n%d,%d\n%s", daemon_pipe
[0],
1134 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1136 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1138 fprintf (stderr
, "daemon: child name too long\n");
1139 exit (EXIT_CANNOT_INVOKE
);
1142 argv
[skip_args
] = fdStr
;
1144 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1145 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1146 execvp (argv
[0], argv
);
1147 emacs_perror (argv
[0]);
1148 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1151 /* In exec'd: parse special dname into pipe and name info. */
1152 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1153 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1155 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1156 exit (EXIT_CANNOT_INVOKE
);
1158 dname_arg2
[0] = '\0';
1159 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1161 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1162 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1164 #endif /* DAEMON_MUST_EXEC */
1166 /* Close unused reading end of the pipe. */
1167 emacs_close (daemon_pipe
[0]);
1170 } /* daemon_type == 2 */
1171 #elif defined(WINDOWSNT)
1172 /* Indicate that we want daemon mode. */
1173 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1174 if (w32_daemon_event
== NULL
)
1176 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1181 fprintf (stderr
, "This platform does not support daemon mode.\n");
1185 daemon_name
= xstrdup (dname_arg
);
1188 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1189 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1190 # ifndef CANNOT_DUMP
1191 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1192 that causes an infinite recursive loop with FreeBSD. See
1193 Bug#14569. The part of this bug involving Cygwin is no longer
1194 relevant, now that Cygwin defines HYBRID_MALLOC. */
1195 if (!noninteractive
|| initialized
)
1197 malloc_enable_thread ();
1200 init_signals (dumping
);
1202 noninteractive1
= noninteractive
;
1204 /* Perform basic initializations (not merely interning symbols). */
1209 init_threads_once ();
1212 init_charset_once ();
1213 init_coding_once ();
1214 init_syntax_once (); /* Create standard syntax table. */
1215 init_category_once (); /* Create standard category table. */
1216 init_casetab_once (); /* Must be done before init_buffer_once. */
1217 init_buffer_once (); /* Create buffer table and some buffers. */
1218 init_minibuf_once (); /* Create list of minibuffers. */
1219 /* Must precede init_window_once. */
1221 /* Call syms_of_xfaces before init_window_once because that
1222 function creates Vterminal_frame. Termcap frames now use
1223 faces, and the face implementation uses some symbols as
1226 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1227 be better to arrange things not to have this dependency. */
1229 /* Call syms_of_keyboard before init_window_once because
1230 keyboard sets up symbols that include some face names that
1231 the X support will want to use. This can happen when
1232 CANNOT_DUMP is defined. */
1233 syms_of_keyboard ();
1235 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1237 syms_of_fns (); /* Before syms_of_charset which uses hash tables. */
1239 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1241 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1243 /* Before syms_of_coding because it initializes Qcharsetp. */
1245 /* Before init_window_once, because it sets up the
1246 Vcoding_system_hash_table. */
1247 syms_of_coding (); /* This should be after syms_of_fileio. */
1249 init_window_once (); /* Init the window system. */
1250 #ifdef HAVE_WINDOW_SYSTEM
1251 init_fringe_once (); /* Swap bitmaps if necessary. */
1252 #endif /* HAVE_WINDOW_SYSTEM */
1258 if (do_initial_setlocale
)
1261 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1262 Vsystem_time_locale
= Vprevious_system_time_locale
;
1267 running_asynch_code
= 0;
1270 #if defined HAVE_JSON && !defined WINDOWSNT
1275 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1278 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1280 build_details
= ! argmatch (argv
, argc
, "-no-build-details",
1281 "--no-build-details", 7, NULL
, &skip_args
);
1284 bool module_assertions
1285 = argmatch (argv
, argc
, "-module-assertions", "--module-assertions", 15,
1287 if (dumping
&& module_assertions
)
1289 fputs ("Module assertions are not supported during dumping\n", stderr
);
1292 init_module_assertions (module_assertions
);
1296 ns_pool
= ns_alloc_autorelease_pool ();
1297 #ifdef NS_IMPL_GNUSTEP
1298 /* GNUstep stupidly resets our locale settings after we made them. */
1302 if (!noninteractive
)
1304 #ifdef NS_IMPL_COCOA
1305 /* Started from GUI? */
1306 /* FIXME: Do the right thing if getenv returns NULL, or if
1308 if (! inhibit_window_system
&& ! isatty (STDIN_FILENO
) && ! ch_to_dir
)
1309 chdir (getenv ("HOME"));
1310 if (skip_args
< argc
)
1312 if (!strncmp (argv
[skip_args
], "-psn", 4))
1315 if (! ch_to_dir
) chdir (getenv ("HOME"));
1317 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1320 if (! ch_to_dir
) chdir (getenv ("HOME"));
1325 #endif /* HAVE_NS */
1327 #ifdef HAVE_X_WINDOWS
1328 /* Stupid kludge to catch command-line display spec. We can't
1329 handle this argument entirely in window system dependent code
1330 because we don't even know which window system dependent code
1331 to run until we've recognized this argument. */
1333 char *displayname
= 0;
1334 int count_before
= skip_args
;
1336 /* Skip any number of -d options, but only use the last one. */
1339 int count_before_this
= skip_args
;
1341 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1343 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1348 count_before
= count_before_this
;
1351 /* If we have the form --display=NAME,
1352 convert it into -d name.
1353 This requires inserting a new element into argv. */
1354 if (displayname
&& count_before
< skip_args
)
1356 if (skip_args
== count_before
+ 1)
1358 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1359 (argc
- (count_before
+ 2)) * sizeof *argv
);
1360 argv
[count_before
+ 2] = displayname
;
1363 argv
[count_before
+ 1] = (char *) "-d";
1368 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1369 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1373 /* Don't actually discard this arg. */
1374 skip_args
= count_before
;
1376 #else /* !HAVE_X_WINDOWS */
1379 int count_before
= skip_args
;
1381 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1382 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1385 skip_args
= count_before
;
1389 /* argmatch must not be used after here,
1390 except when building temacs
1391 because the -d argument has not been skipped in skip_args. */
1394 /* Call early 'cause init_environment needs it. */
1396 /* Set defaults for several environment variables. */
1398 init_environment (argc
, argv
, skip_args
);
1404 globals_of_kqueue ();
1407 #ifdef HAVE_GFILENOTIFY
1408 globals_of_gfilenotify ();
1412 /* Initialize the locale from user defaults. */
1416 /* Initialize and GC-protect Vinitial_environment and
1417 Vprocess_environment before set_initial_environment fills them
1420 syms_of_callproc ();
1421 /* egetenv is a pretty low-level facility, which may get called in
1422 many circumstances; it seems flimsy to put off initializing it
1423 until calling init_callproc. Do not do it when dumping. */
1425 set_initial_environment ();
1429 #ifdef HAVE_W32NOTIFY
1430 globals_of_w32notify ();
1432 /* Initialize environment from registry settings. Make sure to do
1433 this only after calling set_initial_environment so that
1434 Vinitial_environment and Vprocess_environment will contain only
1435 variables from the parent process without modifications from
1437 init_environment (argv
);
1438 init_ntproc (dumping
); /* must precede init_editfns. */
1441 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1442 if this is not done. Do it after set_global_environment so that we
1443 don't pollute Vglobal_environment. */
1444 /* Setting LANG here will defeat the startup locale processing... */
1449 /* Init buffer storage and default directory of main buffer. */
1450 init_buffer (initialized
);
1452 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1454 /* Must precede init_lread. */
1455 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1459 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1460 Lisp_Object old_log_max
;
1461 old_log_max
= Vmessage_log_max
;
1462 XSETFASTINT (Vmessage_log_max
, 0);
1463 message_dolog ("", 0, 1, 0);
1464 Vmessage_log_max
= old_log_max
;
1467 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1471 /* Check to see if Emacs has been installed correctly. */
1472 check_windows_init_file ();
1475 /* Intern the names of all standard functions and variables;
1476 define standard keys. */
1480 /* The basic levels of Lisp must come first. Note that
1481 syms_of_data and some others have already been called. */
1486 syms_of_floatfns ();
1489 syms_of_bytecode ();
1491 syms_of_casefiddle ();
1493 syms_of_category ();
1495 syms_of_character ();
1502 syms_of_filelock ();
1505 /* syms_of_keymap (); */
1513 syms_of_terminal ();
1524 syms_of_textprop ();
1525 syms_of_composite ();
1528 #endif /* WINDOWSNT */
1535 #ifdef HAVE_WINDOW_SYSTEM
1538 #endif /* HAVE_WINDOW_SYSTEM */
1539 #ifdef HAVE_X_WINDOWS
1545 syms_of_xsettings ();
1552 #endif /* HAVE_X_WINDOWS */
1561 syms_of_decompress ();
1571 #endif /* HAVE_NTGUI */
1573 #if defined HAVE_NTGUI || defined CYGWIN
1574 syms_of_w32cygwinx ();
1577 #if defined WINDOWSNT || defined HAVE_NTGUI
1578 syms_of_w32select ();
1585 syms_of_win16select ();
1592 syms_of_nsselect ();
1594 #endif /* HAVE_NS */
1600 #endif /* HAVE_INOTIFY */
1604 #endif /* HAVE_KQUEUE */
1606 #ifdef HAVE_GFILENOTIFY
1607 syms_of_gfilenotify ();
1608 #endif /* HAVE_GFILENOTIFY */
1611 syms_of_dbusbind ();
1612 #endif /* HAVE_DBUS */
1616 #ifdef HAVE_W32NOTIFY
1617 syms_of_w32notify ();
1618 #endif /* HAVE_W32NOTIFY */
1619 #endif /* WINDOWSNT */
1622 syms_of_profiler ();
1628 keys_of_casefiddle ();
1631 keys_of_keyboard ();
1637 /* Initialization that must be done even if the global variable
1638 initialized is non zero. */
1640 globals_of_w32font ();
1641 globals_of_w32fns ();
1642 globals_of_w32menu ();
1643 #endif /* HAVE_NTGUI */
1645 #if defined WINDOWSNT || defined HAVE_NTGUI
1646 globals_of_w32select ();
1652 /* This calls putenv and so must precede init_process_emacs. Also,
1653 it sets Voperating_system_release, which init_process_emacs uses. */
1654 init_editfns (dumping
);
1656 /* These two call putenv. */
1664 /* This can create a thread that may call getenv, so it must follow
1665 all calls to putenv and setenv. Also, this sets up
1666 add_keyboard_wait_descriptor, which init_display uses. */
1667 init_process_emacs (sockfd
);
1669 init_keyboard (); /* This too must precede init_sys_modes. */
1670 if (!noninteractive
)
1671 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1674 init_crit (); /* w32notify.c needs this in batch mode. */
1675 #endif /* HAVE_W32NOTIFY */
1677 #ifdef HAVE_WINDOW_SYSTEM
1679 #endif /* HAVE_WINDOW_SYSTEM */
1687 /* Handle -l loadup, args passed by Makefile. */
1688 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1691 char file_utf8
[MAX_UTF8_PATH
];
1693 if (filename_from_ansi (file
, file_utf8
) == 0)
1696 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1698 /* Unless next switch is -nl, load "loadup.el" first thing. */
1700 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1703 /* Set up for profiling. This is known to work on FreeBSD,
1704 GNU/Linux and MinGW. It might work on some other systems too.
1705 Give it a try and tell us if it works on your system. To compile
1706 for profiling, use the configure option --enable-profiling. */
1711 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1719 /* Enter editor command loop. This never returns. */
1725 /* Sort the args so we can find the most important ones
1726 at the beginning of argv. */
1728 /* First, here's a table of all the standard options. */
1730 struct standard_args
1733 const char *longname
;
1738 static const struct standard_args standard_args
[] =
1740 { "-version", "--version", 150, 0 },
1741 { "-chdir", "--chdir", 130, 1 },
1742 { "-t", "--terminal", 120, 1 },
1743 { "-nw", "--no-window-system", 110, 0 },
1744 { "-nw", "--no-windows", 110, 0 },
1745 { "-batch", "--batch", 100, 0 },
1746 { "-script", "--script", 100, 1 },
1747 { "-daemon", "--daemon", 99, 0 },
1748 { "-bg-daemon", "--bg-daemon", 99, 0 },
1749 { "-fg-daemon", "--fg-daemon", 99, 0 },
1750 { "-help", "--help", 90, 0 },
1751 { "-nl", "--no-loadup", 70, 0 },
1752 { "-nsl", "--no-site-lisp", 65, 0 },
1753 { "-no-build-details", "--no-build-details", 63, 0 },
1755 { "-module-assertions", "--module-assertions", 62, 0 },
1757 /* -d must come last before the options handled in startup.el. */
1758 { "-d", "--display", 60, 1 },
1759 { "-display", 0, 60, 1 },
1760 /* Now for the options handled in `command-line' (startup.el). */
1761 /* (Note that to imply -nsl, -Q is partially handled here.) */
1762 { "-Q", "--quick", 55, 0 },
1763 { "-quick", 0, 55, 0 },
1764 { "-q", "--no-init-file", 50, 0 },
1765 { "-no-init-file", 0, 50, 0 },
1766 { "-no-x-resources", "--no-x-resources", 40, 0 },
1767 { "-no-site-file", "--no-site-file", 40, 0 },
1768 { "-u", "--user", 30, 1 },
1769 { "-user", 0, 30, 1 },
1770 { "-debug-init", "--debug-init", 20, 0 },
1771 { "-iconic", "--iconic", 15, 0 },
1772 { "-D", "--basic-display", 12, 0},
1773 { "-basic-display", 0, 12, 0},
1774 { "-nbc", "--no-blinking-cursor", 12, 0 },
1775 /* Now for the options handled in `command-line-1' (startup.el). */
1776 { "-nbi", "--no-bitmap-icon", 10, 0 },
1777 { "-bg", "--background-color", 10, 1 },
1778 { "-background", 0, 10, 1 },
1779 { "-fg", "--foreground-color", 10, 1 },
1780 { "-foreground", 0, 10, 1 },
1781 { "-bd", "--border-color", 10, 1 },
1782 { "-bw", "--border-width", 10, 1 },
1783 { "-ib", "--internal-border", 10, 1 },
1784 { "-ms", "--mouse-color", 10, 1 },
1785 { "-cr", "--cursor-color", 10, 1 },
1786 { "-fn", "--font", 10, 1 },
1787 { "-font", 0, 10, 1 },
1788 { "-fs", "--fullscreen", 10, 0 },
1789 { "-fw", "--fullwidth", 10, 0 },
1790 { "-fh", "--fullheight", 10, 0 },
1791 { "-mm", "--maximized", 10, 0 },
1792 { "-g", "--geometry", 10, 1 },
1793 { "-geometry", 0, 10, 1 },
1794 { "-T", "--title", 10, 1 },
1795 { "-title", 0, 10, 1 },
1796 { "-name", "--name", 10, 1 },
1797 { "-xrm", "--xrm", 10, 1 },
1798 { "-parent-id", "--parent-id", 10, 1 },
1799 { "-r", "--reverse-video", 5, 0 },
1801 { "-reverse", 0, 5, 0 },
1802 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1803 { "-vb", "--vertical-scroll-bars", 5, 0 },
1804 { "-color", "--color", 5, 0},
1805 { "-no-splash", "--no-splash", 3, 0 },
1806 { "-no-desktop", "--no-desktop", 3, 0 },
1808 { "-NSAutoLaunch", 0, 5, 1 },
1809 { "-NXAutoLaunch", 0, 5, 1 },
1810 { "-_NSMachLaunch", 0, 85, 1 },
1811 { "-MachLaunch", 0, 85, 1 },
1812 { "-macosx", 0, 85, 0 },
1813 { "-NSHost", 0, 85, 1 },
1815 /* These have the same priority as ordinary file name args,
1816 so they are not reordered with respect to those. */
1817 { "-L", "--directory", 0, 1 },
1818 { "-directory", 0, 0, 1 },
1819 { "-l", "--load", 0, 1 },
1820 { "-load", 0, 0, 1 },
1821 /* This has no longname, because using --scriptload confuses sort_args,
1822 because then the --script long option seems to match twice; ie
1823 you can't have a long option which is a prefix of another long
1824 option. In any case, this is entirely an internal option. */
1825 { "-scriptload", NULL
, 0, 1 },
1826 { "-f", "--funcall", 0, 1 },
1827 { "-funcall", 0, 0, 1 },
1828 { "-eval", "--eval", 0, 1 },
1829 { "-execute", "--execute", 0, 1 },
1830 { "-find-file", "--find-file", 0, 1 },
1831 { "-visit", "--visit", 0, 1 },
1832 { "-file", "--file", 0, 1 },
1833 { "-insert", "--insert", 0, 1 },
1835 { "-NXOpen", 0, 0, 1 },
1836 { "-NXOpenTemp", 0, 0, 1 },
1837 { "-NSOpen", 0, 0, 1 },
1838 { "-NSOpenTemp", 0, 0, 1 },
1839 { "-GSFilePath", 0, 0, 1 },
1841 /* This should be processed after ordinary file name args and the like. */
1842 { "-kill", "--kill", -10, 0 },
1845 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1846 so that the highest priority ones come first.
1847 Do not change the order of elements of equal priority.
1848 If an option takes an argument, keep it and its argument together.
1850 If an option that takes no argument appears more
1851 than once, eliminate all but one copy of it. */
1854 sort_args (int argc
, char **argv
)
1856 char **new = xmalloc (argc
* sizeof *new);
1857 /* For each element of argv,
1858 the corresponding element of options is:
1859 0 for an option that takes no arguments,
1860 1 for an option that takes one argument, etc.
1861 -1 for an ordinary non-option argument. */
1862 int *options
= xnmalloc (argc
, sizeof *options
);
1863 int *priority
= xnmalloc (argc
, sizeof *priority
);
1865 int incoming_used
= 1;
1869 /* Categorize all the options,
1870 and figure out which argv elts are option arguments. */
1871 for (from
= 1; from
< argc
; from
++)
1875 if (argv
[from
][0] == '-')
1879 /* If we have found "--", don't consider
1880 any more arguments as options. */
1881 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1883 /* Leave the "--", and everything following it, at the end. */
1884 for (; from
< argc
; from
++)
1886 priority
[from
] = -100;
1892 /* Look for a match with a known old-fashioned option. */
1893 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1894 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1896 options
[from
] = standard_args
[i
].nargs
;
1897 priority
[from
] = standard_args
[i
].priority
;
1898 if (from
+ standard_args
[i
].nargs
>= argc
)
1899 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1900 from
+= standard_args
[i
].nargs
;
1904 /* Look for a match with a known long option.
1905 MATCH is -1 if no match so far, -2 if two or more matches so far,
1906 >= 0 (the table index of the match) if just one match so far. */
1907 if (argv
[from
][1] == '-')
1909 char const *equals
= strchr (argv
[from
], '=');
1911 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1915 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1916 if (standard_args
[i
].longname
1917 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1926 /* If we found exactly one match, use that. */
1929 options
[from
] = standard_args
[match
].nargs
;
1930 priority
[from
] = standard_args
[match
].priority
;
1931 /* If --OPTION=VALUE syntax is used,
1932 this option uses just one argv element. */
1935 if (from
+ options
[from
] >= argc
)
1936 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1937 from
+= options
[from
];
1939 else if (match
== -2)
1941 /* This is an internal error.
1942 Eg if one long option is a prefix of another. */
1943 fprintf (stderr
, "Option '%s' matched multiple standard arguments\n", argv
[from
]);
1945 /* Should we not also warn if there was no match? */
1951 /* Copy the arguments, in order of decreasing priority, to NEW. */
1953 while (incoming_used
< argc
)
1956 int best_priority
= -9999;
1958 /* Find the highest priority remaining option.
1959 If several have equal priority, take the first of them. */
1960 for (from
= 1; from
< argc
; from
++)
1962 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1964 best_priority
= priority
[from
];
1967 /* Skip option arguments--they are tied to the options. */
1968 if (options
[from
] > 0)
1969 from
+= options
[from
];
1975 /* Copy the highest priority remaining option, with its args, to NEW.
1976 Unless it is a duplicate of the previous one. */
1977 if (! (options
[best
] == 0
1978 && ! strcmp (new[to
- 1], argv
[best
])))
1980 new[to
++] = argv
[best
];
1981 for (i
= 0; i
< options
[best
]; i
++)
1982 new[to
++] = argv
[best
+ i
+ 1];
1985 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1987 /* Clear out this option in ARGV. */
1989 for (i
= 0; i
< options
[best
]; i
++)
1990 argv
[best
+ i
+ 1] = 0;
1993 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1997 memcpy (argv
, new, sizeof (char *) * argc
);
2004 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
2005 doc
: /* Exit the Emacs job and kill it.
2006 If ARG is an integer, return ARG as the exit program code.
2007 If ARG is a string, stuff it as keyboard input.
2009 This function is called upon receipt of the signals SIGTERM
2010 or SIGHUP, and upon SIGINT in batch mode.
2012 The value of `kill-emacs-hook', if not void,
2013 is a list of functions (of no args),
2014 all of which are called before Emacs is actually killed. */
2015 attributes
: noreturn
)
2020 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
2022 waiting_for_input
= 0;
2024 safe_run_hooks (Qkill_emacs_hook
);
2026 run_hook (Qkill_emacs_hook
);
2028 #ifdef HAVE_X_WINDOWS
2029 /* Transfer any clipboards we own to the clipboard manager. */
2030 x_clipboard_manager_save_all ();
2033 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
2036 ns_release_autorelease_pool (ns_pool
);
2039 /* If we have an auto-save list file,
2040 kill it because we are exiting Emacs deliberately (not crashing).
2041 Do it after shut_down_emacs, which does an auto-save. */
2042 if (STRINGP (Vauto_save_list_file_name
))
2044 Lisp_Object listfile
;
2045 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
2046 unlink (SSDATA (listfile
));
2050 exit_code
= (XINT (arg
) < 0
2051 ? XINT (arg
) | INT_MIN
2052 : XINT (arg
) & INT_MAX
);
2054 exit_code
= EXIT_SUCCESS
;
2059 /* Perform an orderly shutdown of Emacs. Autosave any modified
2060 buffers, kill any child processes, clean up the terminal modes (if
2061 we're in the foreground), and other stuff like that. Don't perform
2062 any redisplay; this may be called when Emacs is shutting down in
2063 the background, or after its X connection has died.
2065 If SIG is a signal number, print a message for it.
2067 This is called by fatal signal handlers, X protocol error handlers,
2071 shut_down_emacs (int sig
, Lisp_Object stuff
)
2073 /* Prevent running of hooks from now on. */
2076 /* Don't update display from now on. */
2077 Vinhibit_redisplay
= Qt
;
2079 /* If we are controlling the terminal, reset terminal modes. */
2082 pid_t pgrp
= getpgrp ();
2083 pid_t tpgrp
= tcgetpgrp (0);
2084 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2086 reset_all_sys_modes ();
2087 if (sig
&& sig
!= SIGTERM
)
2089 static char const format
[] = "Fatal error %d: ";
2090 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
2091 int buflen
= sprintf (buf
, format
, sig
);
2092 char const *sig_desc
= safe_strsignal (sig
);
2093 emacs_write (STDERR_FILENO
, buf
, buflen
);
2094 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
2100 reset_all_sys_modes ();
2103 stuff_buffered_input (stuff
);
2105 inhibit_sentinels
= 1;
2106 kill_buffer_processes (Qnil
);
2107 Fdo_auto_save (Qt
, Qnil
);
2109 unlock_all_files ();
2111 /* There is a tendency for a SIGIO signal to arrive within exit,
2112 and cause a SIGHUP because the input descriptor is already closed. */
2115 /* Do this only if terminating normally, we want glyph matrices
2116 etc. in a core dump. */
2117 if (sig
== 0 || sig
== SIGTERM
)
2119 check_glyph_memory ();
2120 check_message_stack ();
2128 ns_term_shutdown (sig
);
2132 xml_cleanup_parser ();
2146 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2147 doc
: /* Dump current state of Emacs into executable file FILENAME.
2148 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2149 This is used in the file `loadup.el' when building Emacs.
2151 You must run Emacs in batch mode in order to dump it. */)
2152 (Lisp_Object filename
, Lisp_Object symfile
)
2156 ptrdiff_t count
= SPECPDL_INDEX ();
2160 if (! noninteractive
)
2161 error ("Dumping Emacs works only in batch mode");
2164 error ("Emacs can be dumped only once");
2166 #if defined GNU_LINUX && !defined CANNOT_DUMP
2168 /* Warn if the gap between BSS end and heap start is larger than this. */
2169 # define MAX_HEAP_BSS_DIFF (1024*1024)
2171 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2173 fprintf (stderr
, "**************************************************\n");
2174 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2175 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2177 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2178 fprintf (stderr
, "fail because of this. See the section about\n");
2179 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2180 fprintf (stderr
, "**************************************************\n");
2182 #endif /* GNU_LINUX */
2184 /* Bind `command-line-processed' to nil before dumping,
2185 so that the dumped Emacs will process its command line
2186 and set up to work with X windows if appropriate. */
2187 symbol
= intern ("command-line-processed");
2188 specbind (symbol
, Qnil
);
2190 CHECK_STRING (filename
);
2191 filename
= Fexpand_file_name (filename
, Qnil
);
2192 filename
= ENCODE_FILE (filename
);
2193 if (!NILP (symfile
))
2195 CHECK_STRING (symfile
);
2196 if (SCHARS (symfile
))
2198 symfile
= Fexpand_file_name (symfile
, Qnil
);
2199 symfile
= ENCODE_FILE (symfile
);
2204 Vpurify_flag
= Qnil
;
2206 #ifdef HYBRID_MALLOC
2208 static char const fmt
[] = "%d of %d static heap bytes used";
2209 char buf
[sizeof fmt
+ 2 * (INT_STRLEN_BOUND (int) - 2)];
2210 int max_usage
= max_bss_sbrk_ptr
- bss_sbrk_buffer
;
2211 sprintf (buf
, fmt
, max_usage
, STATIC_HEAP_SIZE
);
2212 /* Don't log messages, because at this point buffers cannot be created. */
2213 message1_nolog (buf
);
2217 fflush_unlocked (stdout
);
2218 /* Tell malloc where start of impure now is. */
2219 /* Also arrange for warnings when nearly out of space. */
2220 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2222 /* On Windows, this was done before dumping, and that once suffices.
2223 Meanwhile, my_edata is not valid on Windows. */
2224 memory_warnings (my_edata
, malloc_warning
);
2225 #endif /* not WINDOWSNT */
2226 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2228 alloc_unexec_pre ();
2230 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2232 alloc_unexec_post ();
2235 Vlibrary_cache
= Qnil
;
2237 #ifdef HAVE_WINDOW_SYSTEM
2238 reset_image_types ();
2243 return unbind_to (count
, Qnil
);
2246 #endif /* not CANNOT_DUMP */
2249 /* Recover from setlocale (LC_ALL, ""). */
2253 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2254 so that numbers are read and printed properly for Emacs Lisp. */
2255 setlocale (LC_NUMERIC
, "C");
2258 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2261 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2263 if (! EQ (*plocale
, desired_locale
))
2265 *plocale
= desired_locale
;
2267 /* Changing categories like LC_TIME usually requires specifying
2268 an encoding suitable for the new locale, but MS-Windows's
2269 'setlocale' will only switch the encoding when LC_ALL is
2270 specified. So we ignore CATEGORY, use LC_ALL instead, and
2271 then restore LC_NUMERIC to "C", so reading and printing
2272 numbers is unaffected. */
2273 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2274 ? SSDATA (desired_locale
)
2277 #else /* !WINDOWSNT */
2278 setlocale (category
, (STRINGP (desired_locale
)
2279 ? SSDATA (desired_locale
)
2281 #endif /* !WINDOWSNT */
2285 /* Set system time locale to match Vsystem_time_locale, if possible. */
2287 synchronize_system_time_locale (void)
2289 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2290 Vsystem_time_locale
);
2293 /* Set system messages locale to match Vsystem_messages_locale, if
2296 synchronize_system_messages_locale (void)
2299 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2300 Vsystem_messages_locale
);
2303 #endif /* HAVE_SETLOCALE */
2305 /* Return a diagnostic string for ERROR_NUMBER, in the wording
2306 and encoding appropriate for the current locale. */
2308 emacs_strerror (int error_number
)
2310 synchronize_system_messages_locale ();
2311 return strerror (error_number
);
2316 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2318 const char *path
, *p
;
2319 Lisp_Object lpath
, element
, tem
;
2320 /* Default is to use "." for empty path elements.
2321 But if argument EMPTY is true, use nil instead. */
2322 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2325 static const char *emacs_dir_env
= "%emacs_dir%/";
2326 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2327 const char *edir
= egetenv ("emacs_dir");
2328 char emacs_dir
[MAX_UTF8_PATH
];
2330 /* egetenv looks in process-environment, which holds the variables
2331 in their original system-locale encoding. We need emacs_dir to
2334 filename_from_ansi (edir
, emacs_dir
);
2337 /* It's okay to use getenv here, because this function is only used
2338 to initialize variables when Emacs starts up, and isn't called
2341 path
= getenv (evarname
);
2352 /* Ensure values from the environment use the proper directory separator. */
2358 char *path_utf8
, *q
, *d
;
2361 /* Convert each element of PATH to UTF-8. */
2362 p
= path_copy
= alloca (strlen (path
) + 1);
2363 strcpy (path_copy
, path
);
2364 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2367 q
= _mbschr (p
, SEPCHAR
);
2370 cnv_result
= filename_from_ansi (p
, d
);
2375 /* If conversion of this PATH elements fails, make sure
2376 destination pointer will stay put, thus effectively
2377 ignoring the offending element. */
2378 if (cnv_result
== 0)
2384 else if (cnv_result
!= 0 && d
> path_utf8
)
2385 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2387 path_copy
= path_utf8
;
2389 path_copy
= alloca (strlen (path
) + 1);
2390 strcpy (path_copy
, path
);
2392 dostounix_filename (path_copy
);
2399 p
= strchr (path
, SEPCHAR
);
2401 p
= path
+ strlen (path
);
2402 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2404 if (! NILP (element
))
2407 /* Relative file names in the default path are interpreted as
2408 being relative to $emacs_dir. */
2409 if (edir
&& defaulted
2410 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2411 element
= Fexpand_file_name (Fsubstring
2413 make_number (emacs_dir_len
),
2415 build_unibyte_string (emacs_dir
));
2418 /* Add /: to the front of the name
2419 if it would otherwise be treated as magic. */
2420 tem
= Ffind_file_name_handler (element
, Qt
);
2422 /* However, if the handler says "I'm safe",
2423 don't bother adding /:. */
2427 prop
= Fget (tem
, intern ("safe-magic"));
2434 AUTO_STRING (slash_colon
, "/:");
2435 element
= concat2 (slash_colon
, element
);
2437 } /* !NILP (element) */
2439 lpath
= Fcons (element
, lpath
);
2445 return Fnreverse (lpath
);
2448 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2449 doc
: /* Return non-nil if the current emacs process is a daemon.
2450 If the daemon was given a name argument, return that name. */)
2455 return build_string (daemon_name
);
2462 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2463 doc
: /* Mark the Emacs daemon as being initialized.
2464 This finishes the daemonization process by doing the other half of detaching
2465 from the parent process and its tty file descriptors. */)
2471 error ("This function can only be called if emacs is run as a daemon");
2473 if (!DAEMON_RUNNING
)
2474 error ("The daemon has already been initialized");
2476 if (NILP (Vafter_init_time
))
2477 error ("This function can only be called after loading the init files");
2480 if (daemon_type
== 2)
2484 /* Get rid of stdin, stdout and stderr. */
2485 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2487 err
|= dup2 (nfd
, STDIN_FILENO
) < 0;
2488 err
|= dup2 (nfd
, STDOUT_FILENO
) < 0;
2489 err
|= dup2 (nfd
, STDERR_FILENO
) < 0;
2490 err
|= emacs_close (nfd
) != 0;
2492 /* Closing the pipe will notify the parent that it can exit.
2493 FIXME: In case some other process inherited the pipe, closing it here
2494 won't notify the parent because it's still open elsewhere, so we
2495 additionally send a byte, just to make sure the parent really exits.
2496 Instead, we should probably close the pipe in start-process and
2497 call-process to make sure the pipe is never inherited by
2499 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2500 err
|= emacs_close (daemon_pipe
[1]) != 0;
2503 /* Set it to an invalid value so we know we've already run this function. */
2506 #else /* WINDOWSNT */
2507 /* Signal the waiting emacsclient process. */
2508 err
|= SetEvent (w32_daemon_event
) == 0;
2509 err
|= CloseHandle (w32_daemon_event
) == 0;
2510 /* Set it to an invalid value so we know we've already run this function. */
2511 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2515 error ("I/O error during daemon initialization");
2520 syms_of_emacs (void)
2522 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2523 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2524 DEFSYM (Qkill_emacs
, "kill-emacs");
2525 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2528 defsubr (&Sdump_emacs
);
2531 defsubr (&Skill_emacs
);
2533 defsubr (&Sinvocation_name
);
2534 defsubr (&Sinvocation_directory
);
2535 defsubr (&Sdaemonp
);
2536 defsubr (&Sdaemon_initialized
);
2538 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2539 doc
: /* Args passed by shell to Emacs, as a list of strings.
2540 Many arguments are deleted from the list as they are processed. */);
2542 DEFVAR_LISP ("system-type", Vsystem_type
,
2543 doc
: /* The value is a symbol indicating the type of operating system you are using.
2545 `gnu' compiled for a GNU Hurd system.
2546 `gnu/linux' compiled for a GNU/Linux system.
2547 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2548 `darwin' compiled for Darwin (GNU-Darwin, macOS, ...).
2549 `ms-dos' compiled as an MS-DOS application.
2550 `windows-nt' compiled as a native W32 application.
2551 `cygwin' compiled using the Cygwin library.
2552 Anything else (in Emacs 26, the possibilities are: aix, berkeley-unix,
2553 hpux, usg-unix-v) indicates some sort of Unix system. */);
2554 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2555 /* See configure.ac for the possible SYSTEM_TYPEs. */
2557 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2558 doc
: /* Value is string indicating configuration Emacs was built for. */);
2559 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2561 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2562 doc
: /* String containing the configuration options Emacs was built with. */);
2563 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2565 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2566 doc
: /* String listing some of the main features this Emacs was compiled with.
2567 An element of the form \"FOO\" generally means that HAVE_FOO was
2568 defined during the build.
2570 This is mainly intended for diagnostic purposes in bug reports.
2571 Don't rely on it for testing whether a feature you want to use is available. */);
2572 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2574 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2575 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2577 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2578 doc
: /* Hook run when `kill-emacs' is called.
2579 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2580 in other similar situations), functions placed on this hook should not
2581 expect to be able to interact with the user. To ask for confirmation,
2582 see `kill-emacs-query-functions' instead.
2584 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2585 `noninteractive' was non-nil. */);
2586 Vkill_emacs_hook
= Qnil
;
2588 DEFVAR_LISP ("path-separator", Vpath_separator
,
2589 doc
: /* String containing the character that separates directories in
2590 search paths, such as PATH and other similar environment variables. */);
2593 Vpath_separator
= make_string (&c
, 1);
2596 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2597 doc
: /* The program name that was used to run Emacs.
2598 Any directory names are omitted. */);
2600 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2601 doc
: /* The directory in which the Emacs executable was found, to run it.
2602 The value is nil if that directory's name is not known. */);
2604 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2605 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2606 In an installed Emacs, this is normally nil. It is non-nil if
2607 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2608 within the variable `invocation-directory' or its parent. For example,
2609 this is the case when running an uninstalled Emacs executable from its
2610 build directory. */);
2611 Vinstallation_directory
= Qnil
;
2613 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2614 doc
: /* System locale for messages. */);
2615 Vsystem_messages_locale
= Qnil
;
2617 DEFVAR_LISP ("previous-system-messages-locale",
2618 Vprevious_system_messages_locale
,
2619 doc
: /* Most recently used system locale for messages. */);
2620 Vprevious_system_messages_locale
= Qnil
;
2622 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2623 doc
: /* System locale for time. */);
2624 Vsystem_time_locale
= Qnil
;
2626 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2627 doc
: /* Most recently used system locale for time. */);
2628 Vprevious_system_time_locale
= Qnil
;
2630 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2631 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2632 Vbefore_init_time
= Qnil
;
2634 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2635 doc
: /* Value of `current-time' after loading the init files.
2636 This is nil during initialization. */);
2637 Vafter_init_time
= Qnil
;
2639 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2640 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2641 inhibit_x_resources
= 0;
2643 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2644 doc
: /* Short copyright string for this version of Emacs. */);
2645 Vemacs_copyright
= build_string (emacs_copyright
);
2647 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2648 doc
: /* Version numbers of this version of Emacs.
2649 This has the form: MAJOR.MINOR[.MICRO], where MAJOR/MINOR/MICRO are integers.
2650 MICRO is only present in unreleased development versions,
2651 and is not especially meaningful. Prior to Emacs 26.1, an extra final
2652 component .BUILD is present. This is now stored separately in
2653 `emacs-build-number'. */);
2654 Vemacs_version
= build_string (emacs_version
);
2656 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2657 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2658 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2660 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2661 doc
: /* Alist of dynamic libraries vs external files implementing them.
2662 Each element is a list (LIBRARY FILE...), where the car is a symbol
2663 representing a supported external library, and the rest are strings giving
2664 alternate filenames for that library.
2666 Emacs tries to load the library from the files in the order they appear on
2667 the list; if none is loaded, the running session of Emacs won't have access
2670 Note that image types `pbm' and `xbm' do not need entries in this variable
2671 because they do not depend on external libraries and are always available.
2673 Also note that this is not a generic facility for accessing external
2674 libraries; only those already known by Emacs will be loaded. */);
2675 Vdynamic_library_alist
= Qnil
;
2676 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2679 Vlibrary_cache
= Qnil
;
2680 staticpro (&Vlibrary_cache
);