1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2016 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
28 #include <sys/types.h>
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>
59 #ifdef HAVE_WINDOW_SYSTEM
61 #endif /* HAVE_WINDOW_SYSTEM */
64 #include "intervals.h"
65 #include "character.h"
70 #include "blockinput.h"
71 #include "syssignal.h"
74 #include "termhooks.h"
79 #include "composite.h"
80 #include "dispextern.h"
84 #include "sysselect.h"
90 #if (defined PROFILING \
91 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
92 # include <sys/gmon.h>
93 extern void moncontrol (int mode
);
104 #ifdef HAVE_SETRLIMIT
105 #include <sys/time.h>
106 #include <sys/resource.h>
109 #ifdef HAVE_PERSONALITY_LINUX32
110 #include <sys/personality.h>
113 static const char emacs_version
[] = PACKAGE_VERSION
;
114 static const char emacs_copyright
[] = COPYRIGHT
;
115 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
117 /* Empty lisp strings. To avoid having to build any others. */
118 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
121 /* Cache for externally loaded libraries. */
122 Lisp_Object Vlibrary_cache
;
125 /* Set after Emacs has started up the first time.
126 Prevents reinitialization of the Lisp world and keymaps
127 on subsequent starts. */
130 /* Set to true if this instance of Emacs might dump. */
131 #ifndef DOUG_LEA_MALLOC
137 extern void unexec_init_emacs_zone (void);
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 /* An address near the bottom of the stack.
154 Tells GC how to save a copy of the stack. */
158 /* The gap between BSS end and heap start as far as we can tell. */
159 static uprintmax_t heap_bss_diff
;
162 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
165 On Cocoa, CoreFoundation lib fails in forked process:
166 http://developer.apple.com/ReleaseNotes/
167 CoreFoundation/CoreFoundation.html)
169 On Windows, a Cygwin fork child cannot access the USER subsystem.
171 We mark being in the exec'd process by a daemon name argument of
172 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
173 NAME is the original daemon name, if any. */
174 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
175 # define DAEMON_MUST_EXEC
178 /* True means running Emacs without interactive terminal. */
181 /* True means remove site-lisp directories from load-path. */
184 /* True means put details like time stamps into builds. */
187 /* Name for the server started by the daemon.*/
188 static char *daemon_name
;
191 /* Pipe used to send exit notification to the daemon parent at
195 HANDLE w32_daemon_event
;
198 /* Save argv and argc. */
202 static void sort_args (int argc
, char **argv
);
203 static void syms_of_emacs (void);
205 /* C99 needs each string to be at most 4095 characters, and the usage
206 strings below are split to not overflow this limit. */
207 static char const *const usage_message
[] =
210 Run Emacs, the extensible, customizable, self-documenting real-time\n\
211 display editor. The recommended way to start Emacs for normal editing\n\
212 is with no options at all.\n\
214 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
215 read the main documentation for these command-line arguments.\n\
217 Initialization options:\n\
221 --batch do not do interactive display; implies -q\n\
222 --chdir DIR change to directory DIR\n\
223 --daemon start a server in the background\n\
224 --debug-init enable Emacs Lisp debugger for init file\n\
225 --display, -d DISPLAY use X server DISPLAY\n\
228 --no-build-details do not add build details such as time stamps\n\
229 --no-desktop do not load a saved desktop\n\
230 --no-init-file, -q load neither ~/.emacs nor default.el\n\
231 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
232 --no-site-file do not load site-start.el\n\
233 --no-x-resources do not load X resources\n\
234 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
235 --no-splash do not display a splash screen on startup\n\
236 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
239 --quick, -Q equivalent to:\n\
240 -q --no-site-file --no-site-lisp --no-splash\n\
242 --script FILE run FILE as an Emacs Lisp script\n\
243 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
244 --user, -u USER load ~USER/.emacs instead of your own\n\
250 FILE visit FILE using find-file\n\
251 +LINE go to line LINE in next FILE\n\
252 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
253 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
254 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
255 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
258 --file FILE visit FILE using find-file\n\
259 --find-file FILE visit FILE using find-file\n\
260 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
261 --insert FILE insert contents of FILE into current buffer\n\
262 --kill exit without asking for confirmation\n\
263 --load, -l FILE load Emacs Lisp FILE using the load function\n\
264 --visit FILE visit FILE using find-file\n\
270 --background-color, -bg COLOR window background color\n\
271 --basic-display, -D disable many display features;\n\
272 used for debugging Emacs\n\
273 --border-color, -bd COLOR main border color\n\
274 --border-width, -bw WIDTH width of main border\n\
277 --color, --color=MODE override color mode for character terminals;\n\
278 MODE defaults to `auto', and\n\
279 can also be `never', `always',\n\
280 or a mode name like `ansi8'\n\
281 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
282 --font, -fn FONT default font; must be fixed-width\n\
283 --foreground-color, -fg COLOR window foreground color\n\
286 --fullheight, -fh make the first frame high as the screen\n\
287 --fullscreen, -fs make the first frame fullscreen\n\
288 --fullwidth, -fw make the first frame wide as the screen\n\
289 --maximized, -mm make the first frame maximized\n\
290 --geometry, -g GEOMETRY window geometry\n\
293 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
294 --iconic start Emacs in iconified state\n\
295 --internal-border, -ib WIDTH width between text and main border\n\
296 --line-spacing, -lsp PIXELS additional space to put between lines\n\
297 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
298 --name NAME title for initial Emacs frame\n\
301 --no-blinking-cursor, -nbc disable blinking cursor\n\
302 --reverse-video, -r, -rv switch foreground and background\n\
303 --title, -T TITLE title for initial Emacs frame\n\
304 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
305 --xrm XRESOURCES set additional X resources\n\
306 --parent-id XID set parent window\n\
307 --help display this help and exit\n\
308 --version output version information and exit\n\
312 You can generally also specify long option names with a single -; for\n\
313 example, -batch as well as --batch. You can use any unambiguous\n\
314 abbreviation for a --option.\n\
316 Various environment variables and window system resources also affect\n\
317 the operation of Emacs. See the main documentation.\n\
319 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
320 section of the Emacs manual or the file BUGS.\n"
324 /* True if handling a fatal error already. */
325 bool fatal_error_in_progress
;
328 /* NS autrelease pool, for memory management. */
329 static void *ns_pool
;
334 setlocale (int cat
, char const *locale
)
340 /* True if the current system locale uses UTF-8 encoding. */
346 mbstate_t mbs
= { 0 };
347 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
354 /* Report a fatal error due to signal SIG, output a backtrace of at
355 most BACKTRACE_LIMIT lines, and exit. */
357 terminate_due_to_signal (int sig
, int backtrace_limit
)
359 signal (sig
, SIG_DFL
);
361 if (attempt_orderly_shutdown_on_fatal_signal
)
363 /* If fatal error occurs in code below, avoid infinite recursion. */
364 if (! fatal_error_in_progress
)
366 fatal_error_in_progress
= 1;
368 totally_unblock_input ();
369 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
370 Fkill_emacs (make_number (sig
));
372 shut_down_emacs (sig
, Qnil
);
373 emacs_backtrace (backtrace_limit
);
377 /* Signal the same code; this time it will really be fatal.
378 Since we're in a signal handler, the signal is blocked, so we
379 have to unblock it if we want to really receive it. */
383 sigemptyset (&unblocked
);
384 sigaddset (&unblocked
, sig
);
385 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
391 /* This shouldn't be executed, but it prevents a warning. */
395 /* Code for dealing with Lisp access to the Unix command line. */
398 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
401 Lisp_Object name
, dir
, handler
;
402 ptrdiff_t count
= SPECPDL_INDEX ();
403 Lisp_Object raw_name
;
404 AUTO_STRING (slash_colon
, "/:");
410 /* Must use argv[0] converted to UTF-8, as it begets many standard
411 file and directory names. */
413 char argv0
[MAX_UTF8_PATH
];
415 if (filename_from_ansi (argv
[0], argv0
) == 0)
416 raw_name
= build_unibyte_string (argv0
);
418 raw_name
= build_unibyte_string (argv
[0]);
421 raw_name
= build_unibyte_string (argv
[0]);
424 /* Add /: to the front of the name
425 if it would otherwise be treated as magic. */
426 handler
= Ffind_file_name_handler (raw_name
, Qt
);
427 if (! NILP (handler
))
428 raw_name
= concat2 (slash_colon
, raw_name
);
430 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
431 Vinvocation_directory
= Ffile_name_directory (raw_name
);
433 /* If we got no directory in argv[0], search PATH to find where
434 Emacs actually came from. */
435 if (NILP (Vinvocation_directory
))
438 int yes
= openp (Vexec_path
, Vinvocation_name
,
439 Vexec_suffixes
, &found
, make_number (X_OK
), false);
442 /* Add /: to the front of the name
443 if it would otherwise be treated as magic. */
444 handler
= Ffind_file_name_handler (found
, Qt
);
445 if (! NILP (handler
))
446 found
= concat2 (slash_colon
, found
);
447 Vinvocation_directory
= Ffile_name_directory (found
);
451 if (!NILP (Vinvocation_directory
)
452 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
453 /* Emacs was started with relative path, like ./emacs.
457 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
459 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
462 Vinstallation_directory
= Qnil
;
464 if (!NILP (Vinvocation_directory
))
466 dir
= Vinvocation_directory
;
468 /* If we are running from the build directory, set DIR to the
469 src subdirectory of the Emacs tree, like on Posix
471 if (SBYTES (dir
) > sizeof ("/i386/") - 1
472 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
474 dir
= Fexpand_file_name (build_string ("../.."), dir
);
475 #else /* !WINDOWSNT */
477 name
= Fexpand_file_name (Vinvocation_name
, dir
);
480 Lisp_Object tem
, lib_src_exists
;
481 Lisp_Object etc_exists
, info_exists
;
483 /* See if dir contains subdirs for use by Emacs.
484 Check for the ones that would exist in a build directory,
485 not including lisp and info. */
486 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
487 lib_src_exists
= Ffile_exists_p (tem
);
490 /* MSDOS installations frequently remove lib-src, but we still
491 must set installation-directory, or else info won't find
492 its files (it uses the value of installation-directory). */
493 tem
= Fexpand_file_name (build_string ("info"), dir
);
494 info_exists
= Ffile_exists_p (tem
);
499 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
501 tem
= Fexpand_file_name (build_string ("etc"), dir
);
502 etc_exists
= Ffile_exists_p (tem
);
503 if (!NILP (etc_exists
))
505 Vinstallation_directory
506 = Ffile_name_as_directory (dir
);
511 /* See if dir's parent contains those subdirs. */
512 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
513 lib_src_exists
= Ffile_exists_p (tem
);
517 /* See the MSDOS commentary above. */
518 tem
= Fexpand_file_name (build_string ("../info"), dir
);
519 info_exists
= Ffile_exists_p (tem
);
524 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
526 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
527 etc_exists
= Ffile_exists_p (tem
);
528 if (!NILP (etc_exists
))
530 tem
= Fexpand_file_name (build_string (".."), dir
);
531 Vinstallation_directory
532 = Ffile_name_as_directory (tem
);
537 /* If the Emacs executable is actually a link,
538 next try the dir that the link points into. */
539 tem
= Ffile_symlink_p (name
);
542 name
= Fexpand_file_name (tem
, dir
);
543 dir
= Ffile_name_directory (name
);
550 Vcommand_line_args
= Qnil
;
552 for (i
= argc
- 1; i
>= 0; i
--)
554 if (i
== 0 || i
> skip_args
)
555 /* For the moment, we keep arguments as is in unibyte strings.
556 They are decoded in the function command-line after we know
557 locale-coding-system. */
559 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
562 unbind_to (count
, Qnil
);
565 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
566 doc
: /* Return the program name that was used to run Emacs.
567 Any directory names are omitted. */)
570 return Fcopy_sequence (Vinvocation_name
);
573 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
575 doc
: /* Return the directory name in which the Emacs executable was located. */)
578 return Fcopy_sequence (Vinvocation_directory
);
582 /* Test whether the next argument in ARGV matches SSTR or a prefix of
583 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
584 (the argument is supposed to have a value) store in *VALPTR either
585 the next argument or the portion of this one after the equal sign.
586 ARGV is read starting at position *SKIPPTR; this index is advanced
587 by the number of arguments used.
589 Too bad we can't just use getopt for all of this, but we don't have
590 enough information to do it right. */
593 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
594 int minlen
, char **valptr
, int *skipptr
)
600 /* Don't access argv[argc]; give up in advance. */
601 if (argc
<= *skipptr
+ 1)
604 arg
= argv
[*skipptr
+1];
607 if (strcmp (arg
, sstr
) == 0)
611 *valptr
= argv
[*skipptr
+2];
618 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
619 ? p
- arg
: strlen (arg
));
620 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
622 else if (valptr
== NULL
)
633 else if (argv
[*skipptr
+2] != NULL
)
635 *valptr
= argv
[*skipptr
+2];
645 /* Close standard output and standard error, reporting any write
646 errors as best we can. This is intended for use with atexit. */
648 close_output_streams (void)
650 if (close_stream (stdout
) != 0)
652 emacs_perror ("Write error to standard output");
653 _exit (EXIT_FAILURE
);
656 if (close_stream (stderr
) != 0)
657 _exit (EXIT_FAILURE
);
662 main (int argc
, char **argv
)
665 char stack_bottom_variable
;
666 bool do_initial_setlocale
;
669 #ifdef HAVE_SETRLIMIT
675 #ifdef DAEMON_MUST_EXEC
680 /* If we use --chdir, this records the original directory. */
681 char *original_pwd
= 0;
686 might_dump
= !initialized
;
692 char *heap_start
= my_heap_start ();
693 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
697 #if defined WINDOWSNT || defined HAVE_NTGUI
698 /* Set global variables used to detect Windows version. Do this as
699 early as possible. (unexw32.c calls this function as well, but
700 the additional call here is harmless.) */
701 cache_system_info ();
703 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
704 to have non-stub implementations of APIs we need to convert file
705 names between UTF-8 and the system's ANSI codepage. */
706 maybe_load_unicows_dll ();
708 /* This has to be done before module_init is called below, so that
709 the latter could use the thread ID of the main thread. */
710 w32_init_main_thread ();
713 #ifdef RUN_TIME_REMAP
715 run_time_remap (argv
[0]);
718 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
721 unexec_init_emacs_zone ();
724 atexit (close_output_streams
);
730 sort_args (argc
, argv
);
732 while (argv
[argc
]) argc
++;
734 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
736 const char *version
, *copyright
;
739 Lisp_Object tem
, tem2
;
740 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
741 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
744 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
749 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
754 version
= SSDATA (tem
);
755 copyright
= SSDATA (tem2
);
760 version
= emacs_version
;
761 copyright
= emacs_copyright
;
763 printf ("%s %s\n", PACKAGE_NAME
, version
);
764 printf ("%s\n", copyright
);
765 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
766 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
767 printf ("under the terms of the GNU General Public License.\n");
768 printf ("For more information about these matters, ");
769 printf ("see the file named COPYING.\n");
773 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
776 /* argv[] array is kept in its original ANSI codepage encoding,
777 we need to convert to UTF-8, for chdir to work. */
778 char newdir
[MAX_UTF8_PATH
];
780 filename_from_ansi (ch_to_dir
, newdir
);
783 original_pwd
= emacs_get_current_dir_name ();
784 if (chdir (ch_to_dir
) != 0)
786 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
787 argv
[0], ch_to_dir
, strerror (errno
));
792 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
793 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
795 #ifdef HAVE_PERSONALITY_LINUX32
796 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
798 /* Set this so we only do this once. */
799 xputenv ("EMACS_HEAP_EXEC=true");
801 /* A flag to turn off address randomization which is introduced
802 in linux kernel shipped with fedora core 4 */
803 #define ADD_NO_RANDOMIZE 0x0040000
804 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
805 #undef ADD_NO_RANDOMIZE
807 execvp (argv
[0], argv
);
809 /* If the exec fails, try to dump anyway. */
810 emacs_perror (argv
[0]);
812 #endif /* HAVE_PERSONALITY_LINUX32 */
814 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
815 /* Extend the stack space available. Don't do that if dumping,
816 since some systems (e.g. DJGPP) might define a smaller stack
817 limit at that time. And it's not needed on Cygwin, since emacs
818 is built with an 8MB stack. Moreover, the setrlimit call can
819 cause problems on Cygwin
820 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
823 && (!noninteractive
|| initialized
)
825 && !getrlimit (RLIMIT_STACK
, &rlim
))
828 /* Approximate the amount regex.c needs per unit of re_max_failures. */
829 int ratio
= 20 * sizeof (char *);
830 /* Then add 33% to cover the size of the smaller stacks that regex.c
831 successively allocates and discards, on its way to the maximum. */
833 /* Add in some extra to cover
834 what we're likely to use for other reasons. */
835 newlim
= re_max_failures
* ratio
+ 200000;
837 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
838 stack allocation routine for new process that the allocation
839 fails if stack limit is not on page boundary. So, round up the
840 new limit to page boundary. */
841 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
843 if (newlim
> rlim
.rlim_max
)
845 newlim
= rlim
.rlim_max
;
846 /* Don't let regex.c overflow the stack we have. */
847 re_max_failures
= (newlim
- 200000) / ratio
;
849 if (rlim
.rlim_cur
< newlim
)
850 rlim
.rlim_cur
= newlim
;
852 setrlimit (RLIMIT_STACK
, &rlim
);
854 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
856 /* Record (approximately) where the stack begins. */
857 stack_bottom
= &stack_bottom_variable
;
861 emacs_backtrace (-1);
863 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
864 /* Arrange to get warning messages as memory fills up. */
865 memory_warnings (0, malloc_warning
);
867 /* Call malloc at least once, to run malloc_initialize_hook.
868 Also call realloc and free for consistency. */
869 free (realloc (malloc (4), 4));
871 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
874 SET_BINARY (fileno (stdin
));
876 SET_BINARY (fileno (stdout
));
879 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
880 The build procedure uses this while dumping, to ensure that the
881 dumped Emacs does not have its system locale tables initialized,
882 as that might cause screwups when the dumped Emacs starts up. */
884 char *lc_all
= getenv ("LC_ALL");
885 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
888 /* Set locale now, so that initial error messages are localized properly.
889 fixup_locale must wait until later, since it builds strings. */
890 if (do_initial_setlocale
)
891 setlocale (LC_ALL
, "");
892 text_quoting_flag
= using_utf8 ();
894 inhibit_window_system
= 0;
896 /* Handle the -t switch, which specifies filename to use as terminal. */
900 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
905 result
= emacs_open (term
, O_RDWR
, 0);
906 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
908 char *errstring
= strerror (errno
);
909 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
914 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
917 fprintf (stderr
, "Using %s\n", term
);
918 #ifdef HAVE_WINDOW_SYSTEM
919 inhibit_window_system
= 1; /* -t => -nw */
926 /* Command line option --no-windows is deprecated and thus not mentioned
927 in the manual and usage information. */
928 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
929 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
930 inhibit_window_system
= 1;
932 /* Handle the -batch switch, which means don't do interactive display. */
934 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
937 Vundo_outer_limit
= Qnil
;
939 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
941 noninteractive
= 1; /* Set batch mode. */
942 /* Convert --script to -scriptload, un-skip it, and sort again
943 so that it will be handled in proper sequence. */
944 /* FIXME broken for --script=FILE - is that supposed to work? */
945 argv
[skip_args
- 1] = (char *) "-scriptload";
947 sort_args (argc
, argv
);
950 /* Handle the --help option, which gives a usage message. */
951 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
954 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
955 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
956 fputs (usage_message
[i
], stdout
);
961 /* Make sure IS_DAEMON starts up as false. */
964 w32_daemon_event
= NULL
;
967 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
968 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
973 /* Start as a daemon: fork a new child process which will run the
974 rest of the initialization code, then exit.
976 Detaching a daemon requires the following steps:
980 - close the tty file-descriptors
982 We only want to do the last 2 steps once the daemon is ready to
983 serve requests, i.e. after loading .emacs (initialization).
984 OTOH initialization may start subprocesses (e.g. ispell) and these
985 should be run from the proper process (the one that will end up
986 running as daemon) and with the proper "session id" in order for
987 them to keep working after detaching, so fork and setsid need to be
988 performed before initialization.
990 We want to avoid exiting before the server socket is ready, so
991 use a pipe for synchronization. The parent waits for the child
992 to close its end of the pipe (using `daemon-initialized')
994 if (emacs_pipe (daemon_pipe
) != 0)
996 fprintf (stderr
, "Cannot pipe!\n");
1000 #ifndef DAEMON_MUST_EXEC
1002 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1003 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1004 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1005 #endif /* USE_GTK */
1007 #else /* DAEMON_MUST_EXEC */
1008 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1009 f
= fork (); /* in orig */
1011 f
= 0; /* in exec'd */
1012 #endif /* !DAEMON_MUST_EXEC */
1018 /* Close unused writing end of the pipe. */
1019 emacs_close (daemon_pipe
[1]);
1021 /* Just wait for the child to close its end of the pipe. */
1024 retval
= read (daemon_pipe
[0], &buf
, 1);
1026 while (retval
== -1 && errno
== EINTR
);
1030 fprintf (stderr
, "Error reading status from child\n");
1033 else if (retval
== 0)
1035 fprintf (stderr
, "Error: server did not start correctly\n");
1039 emacs_close (daemon_pipe
[0]);
1044 emacs_perror ("fork");
1045 exit (EXIT_CANCELED
);
1048 #ifdef DAEMON_MUST_EXEC
1050 /* In orig process, forked as child, OR in exec'd. */
1051 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1052 { /* In orig, child: now exec w/special daemon name. */
1055 snprintf (fdStr
, sizeof fdStr
,
1056 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1057 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1059 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1061 fprintf (stderr
, "daemon: child name too long\n");
1062 exit (EXIT_CANNOT_INVOKE
);
1065 argv
[skip_args
] = fdStr
;
1067 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1068 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1069 execvp (argv
[0], argv
);
1070 emacs_perror (argv
[0]);
1071 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1074 /* In exec'd: parse special dname into pipe and name info. */
1075 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1076 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1078 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1079 exit (EXIT_CANNOT_INVOKE
);
1081 dname_arg2
[0] = '\0';
1082 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1084 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1085 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1087 #endif /* DAEMON_MUST_EXEC */
1089 /* Close unused reading end of the pipe. */
1090 emacs_close (daemon_pipe
[0]);
1093 #elif defined(WINDOWSNT)
1094 /* Indicate that we want daemon mode. */
1095 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1096 if (w32_daemon_event
== NULL
)
1098 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1103 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1107 daemon_name
= xstrdup (dname_arg
);
1110 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1111 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1112 # ifndef CANNOT_DUMP
1113 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1114 that causes an infinite recursive loop with FreeBSD. See
1115 Bug#14569. The part of this bug involving Cygwin is no longer
1116 relevant, now that Cygwin defines HYBRID_MALLOC. */
1117 if (!noninteractive
|| initialized
)
1119 malloc_enable_thread ();
1122 init_signals (dumping
);
1124 noninteractive1
= noninteractive
;
1126 /* Perform basic initializations (not merely interning symbols). */
1133 init_charset_once ();
1134 init_coding_once ();
1135 init_syntax_once (); /* Create standard syntax table. */
1136 init_category_once (); /* Create standard category table. */
1137 init_casetab_once (); /* Must be done before init_buffer_once. */
1138 init_buffer_once (); /* Create buffer table and some buffers. */
1139 init_minibuf_once (); /* Create list of minibuffers. */
1140 /* Must precede init_window_once. */
1142 /* Call syms_of_xfaces before init_window_once because that
1143 function creates Vterminal_frame. Termcap frames now use
1144 faces, and the face implementation uses some symbols as
1147 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1148 be better to arrange things not to have this dependency. */
1150 /* Call syms_of_keyboard before init_window_once because
1151 keyboard sets up symbols that include some face names that
1152 the X support will want to use. This can happen when
1153 CANNOT_DUMP is defined. */
1154 syms_of_keyboard ();
1156 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1158 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1160 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1162 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1164 /* Before syms_of_coding because it initializes Qcharsetp. */
1166 /* Before init_window_once, because it sets up the
1167 Vcoding_system_hash_table. */
1168 syms_of_coding (); /* This should be after syms_of_fileio. */
1170 init_window_once (); /* Init the window system. */
1171 #ifdef HAVE_WINDOW_SYSTEM
1172 init_fringe_once (); /* Swap bitmaps if necessary. */
1173 #endif /* HAVE_WINDOW_SYSTEM */
1178 if (do_initial_setlocale
)
1181 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1182 Vsystem_time_locale
= Vprevious_system_time_locale
;
1187 running_asynch_code
= 0;
1191 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1194 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1196 build_details
= ! argmatch (argv
, argc
, "-no-build-details",
1197 "--no-build-details", 7, NULL
, &skip_args
);
1200 ns_pool
= ns_alloc_autorelease_pool ();
1201 #ifdef NS_IMPL_GNUSTEP
1202 /* GNUstep stupidly resets our locale settings after we made them. */
1206 if (!noninteractive
)
1208 #ifdef NS_IMPL_COCOA
1209 /* Started from GUI? */
1210 /* FIXME: Do the right thing if getenv returns NULL, or if
1212 if (! inhibit_window_system
&& ! isatty (0) && ! ch_to_dir
)
1213 chdir (getenv ("HOME"));
1214 if (skip_args
< argc
)
1216 if (!strncmp (argv
[skip_args
], "-psn", 4))
1219 if (! ch_to_dir
) chdir (getenv ("HOME"));
1221 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1224 if (! ch_to_dir
) chdir (getenv ("HOME"));
1229 #endif /* HAVE_NS */
1231 #ifdef HAVE_X_WINDOWS
1232 /* Stupid kludge to catch command-line display spec. We can't
1233 handle this argument entirely in window system dependent code
1234 because we don't even know which window system dependent code
1235 to run until we've recognized this argument. */
1237 char *displayname
= 0;
1238 int count_before
= skip_args
;
1240 /* Skip any number of -d options, but only use the last one. */
1243 int count_before_this
= skip_args
;
1245 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1247 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1252 count_before
= count_before_this
;
1255 /* If we have the form --display=NAME,
1256 convert it into -d name.
1257 This requires inserting a new element into argv. */
1258 if (displayname
&& count_before
< skip_args
)
1260 if (skip_args
== count_before
+ 1)
1262 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1263 (argc
- (count_before
+ 2)) * sizeof *argv
);
1264 argv
[count_before
+ 2] = displayname
;
1267 argv
[count_before
+ 1] = (char *) "-d";
1272 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1273 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1277 /* Don't actually discard this arg. */
1278 skip_args
= count_before
;
1280 #else /* !HAVE_X_WINDOWS */
1283 int count_before
= skip_args
;
1285 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1286 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1289 skip_args
= count_before
;
1293 /* argmatch must not be used after here,
1294 except when building temacs
1295 because the -d argument has not been skipped in skip_args. */
1298 /* Call early 'cause init_environment needs it. */
1300 /* Set defaults for several environment variables. */
1302 init_environment (argc
, argv
, skip_args
);
1308 globals_of_kqueue ();
1311 #ifdef HAVE_GFILENOTIFY
1312 globals_of_gfilenotify ();
1317 #ifdef HAVE_W32NOTIFY
1318 globals_of_w32notify ();
1320 /* Initialize environment from registry settings. */
1321 init_environment (argv
);
1322 init_ntproc (dumping
); /* must precede init_editfns. */
1326 /* Initialize the locale from user defaults. */
1330 /* Initialize and GC-protect Vinitial_environment and
1331 Vprocess_environment before set_initial_environment fills them
1334 syms_of_callproc ();
1335 /* egetenv is a pretty low-level facility, which may get called in
1336 many circumstances; it seems flimsy to put off initializing it
1337 until calling init_callproc. Do not do it when dumping. */
1339 set_initial_environment ();
1341 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1342 if this is not done. Do it after set_global_environment so that we
1343 don't pollute Vglobal_environment. */
1344 /* Setting LANG here will defeat the startup locale processing... */
1349 /* Init buffer storage and default directory of main buffer. */
1350 init_buffer (initialized
);
1352 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1354 /* Must precede init_lread. */
1355 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1359 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1360 Lisp_Object old_log_max
;
1361 old_log_max
= Vmessage_log_max
;
1362 XSETFASTINT (Vmessage_log_max
, 0);
1363 message_dolog ("", 0, 1, 0);
1364 Vmessage_log_max
= old_log_max
;
1367 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1371 /* Check to see if Emacs has been installed correctly. */
1372 check_windows_init_file ();
1375 /* Intern the names of all standard functions and variables;
1376 define standard keys. */
1380 /* The basic levels of Lisp must come first. Note that
1381 syms_of_data and some others have already been called. */
1386 syms_of_floatfns ();
1389 syms_of_bytecode ();
1391 syms_of_casefiddle ();
1393 syms_of_category ();
1395 syms_of_character ();
1402 syms_of_filelock ();
1405 /* syms_of_keymap (); */
1413 syms_of_terminal ();
1424 syms_of_textprop ();
1425 syms_of_composite ();
1428 #endif /* WINDOWSNT */
1435 #ifdef HAVE_WINDOW_SYSTEM
1438 #endif /* HAVE_WINDOW_SYSTEM */
1439 #ifdef HAVE_X_WINDOWS
1445 syms_of_xsettings ();
1452 #endif /* HAVE_X_WINDOWS */
1459 syms_of_decompress ();
1469 #endif /* HAVE_NTGUI */
1471 #if defined WINDOWSNT || defined HAVE_NTGUI
1472 syms_of_w32select ();
1479 syms_of_win16select ();
1486 syms_of_nsselect ();
1488 #endif /* HAVE_NS */
1494 #endif /* HAVE_INOTIFY */
1498 #endif /* HAVE_KQUEUE */
1500 #ifdef HAVE_GFILENOTIFY
1501 syms_of_gfilenotify ();
1502 #endif /* HAVE_GFILENOTIFY */
1505 syms_of_dbusbind ();
1506 #endif /* HAVE_DBUS */
1510 #ifdef HAVE_W32NOTIFY
1511 syms_of_w32notify ();
1512 #endif /* HAVE_W32NOTIFY */
1513 #endif /* WINDOWSNT */
1515 syms_of_profiler ();
1517 keys_of_casefiddle ();
1520 keys_of_keyboard ();
1526 /* Initialization that must be done even if the global variable
1527 initialized is non zero. */
1529 globals_of_w32font ();
1530 globals_of_w32fns ();
1531 globals_of_w32menu ();
1532 #endif /* HAVE_NTGUI */
1534 #if defined WINDOWSNT || defined HAVE_NTGUI
1535 globals_of_w32select ();
1541 /* This calls putenv and so must precede init_process_emacs. Also,
1542 it sets Voperating_system_release, which init_process_emacs uses. */
1543 init_editfns (dumping
);
1545 /* These two call putenv. */
1553 /* This can create a thread that may call getenv, so it must follow
1554 all calls to putenv and setenv. Also, this sets up
1555 add_keyboard_wait_descriptor, which init_display uses. */
1556 init_process_emacs ();
1558 init_keyboard (); /* This too must precede init_sys_modes. */
1559 if (!noninteractive
)
1560 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1563 init_crit (); /* w32notify.c needs this in batch mode. */
1564 #endif /* HAVE_W32NOTIFY */
1566 #ifdef HAVE_WINDOW_SYSTEM
1568 #endif /* HAVE_WINDOW_SYSTEM */
1576 /* Handle -l loadup, args passed by Makefile. */
1577 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1580 char file_utf8
[MAX_UTF8_PATH
];
1582 if (filename_from_ansi (file
, file_utf8
) == 0)
1585 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1587 /* Unless next switch is -nl, load "loadup.el" first thing. */
1589 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1592 /* Set up for profiling. This is known to work on FreeBSD,
1593 GNU/Linux and MinGW. It might work on some other systems too.
1594 Give it a try and tell us if it works on your system. To compile
1595 for profiling, use the configure option --enable-profiling. */
1596 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1601 extern unsigned char etext
asm ("etext");
1607 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1616 /* Enter editor command loop. This never returns. */
1622 /* Sort the args so we can find the most important ones
1623 at the beginning of argv. */
1625 /* First, here's a table of all the standard options. */
1627 struct standard_args
1630 const char *longname
;
1635 static const struct standard_args standard_args
[] =
1637 { "-version", "--version", 150, 0 },
1638 { "-chdir", "--chdir", 130, 1 },
1639 { "-t", "--terminal", 120, 1 },
1640 { "-nw", "--no-window-system", 110, 0 },
1641 { "-nw", "--no-windows", 110, 0 },
1642 { "-batch", "--batch", 100, 0 },
1643 { "-script", "--script", 100, 1 },
1644 { "-daemon", "--daemon", 99, 0 },
1645 { "-help", "--help", 90, 0 },
1646 { "-nl", "--no-loadup", 70, 0 },
1647 { "-nsl", "--no-site-lisp", 65, 0 },
1648 { "-no-build-details", "--no-build-details", 63, 0 },
1649 /* -d must come last before the options handled in startup.el. */
1650 { "-d", "--display", 60, 1 },
1651 { "-display", 0, 60, 1 },
1652 /* Now for the options handled in `command-line' (startup.el). */
1653 /* (Note that to imply -nsl, -Q is partially handled here.) */
1654 { "-Q", "--quick", 55, 0 },
1655 { "-quick", 0, 55, 0 },
1656 { "-q", "--no-init-file", 50, 0 },
1657 { "-no-init-file", 0, 50, 0 },
1658 { "-no-x-resources", "--no-x-resources", 40, 0 },
1659 { "-no-site-file", "--no-site-file", 40, 0 },
1660 { "-u", "--user", 30, 1 },
1661 { "-user", 0, 30, 1 },
1662 { "-debug-init", "--debug-init", 20, 0 },
1663 { "-iconic", "--iconic", 15, 0 },
1664 { "-D", "--basic-display", 12, 0},
1665 { "-basic-display", 0, 12, 0},
1666 { "-nbc", "--no-blinking-cursor", 12, 0 },
1667 /* Now for the options handled in `command-line-1' (startup.el). */
1668 { "-nbi", "--no-bitmap-icon", 10, 0 },
1669 { "-bg", "--background-color", 10, 1 },
1670 { "-background", 0, 10, 1 },
1671 { "-fg", "--foreground-color", 10, 1 },
1672 { "-foreground", 0, 10, 1 },
1673 { "-bd", "--border-color", 10, 1 },
1674 { "-bw", "--border-width", 10, 1 },
1675 { "-ib", "--internal-border", 10, 1 },
1676 { "-ms", "--mouse-color", 10, 1 },
1677 { "-cr", "--cursor-color", 10, 1 },
1678 { "-fn", "--font", 10, 1 },
1679 { "-font", 0, 10, 1 },
1680 { "-fs", "--fullscreen", 10, 0 },
1681 { "-fw", "--fullwidth", 10, 0 },
1682 { "-fh", "--fullheight", 10, 0 },
1683 { "-mm", "--maximized", 10, 0 },
1684 { "-g", "--geometry", 10, 1 },
1685 { "-geometry", 0, 10, 1 },
1686 { "-T", "--title", 10, 1 },
1687 { "-title", 0, 10, 1 },
1688 { "-name", "--name", 10, 1 },
1689 { "-xrm", "--xrm", 10, 1 },
1690 { "-parent-id", "--parent-id", 10, 1 },
1691 { "-r", "--reverse-video", 5, 0 },
1693 { "-reverse", 0, 5, 0 },
1694 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1695 { "-vb", "--vertical-scroll-bars", 5, 0 },
1696 { "-color", "--color", 5, 0},
1697 { "-no-splash", "--no-splash", 3, 0 },
1698 { "-no-desktop", "--no-desktop", 3, 0 },
1700 { "-NSAutoLaunch", 0, 5, 1 },
1701 { "-NXAutoLaunch", 0, 5, 1 },
1702 { "-_NSMachLaunch", 0, 85, 1 },
1703 { "-MachLaunch", 0, 85, 1 },
1704 { "-macosx", 0, 85, 0 },
1705 { "-NSHost", 0, 85, 1 },
1707 /* These have the same priority as ordinary file name args,
1708 so they are not reordered with respect to those. */
1709 { "-L", "--directory", 0, 1 },
1710 { "-directory", 0, 0, 1 },
1711 { "-l", "--load", 0, 1 },
1712 { "-load", 0, 0, 1 },
1713 /* This has no longname, because using --scriptload confuses sort_args,
1714 because then the --script long option seems to match twice; ie
1715 you can't have a long option which is a prefix of another long
1716 option. In any case, this is entirely an internal option. */
1717 { "-scriptload", NULL
, 0, 1 },
1718 { "-f", "--funcall", 0, 1 },
1719 { "-funcall", 0, 0, 1 },
1720 { "-eval", "--eval", 0, 1 },
1721 { "-execute", "--execute", 0, 1 },
1722 { "-find-file", "--find-file", 0, 1 },
1723 { "-visit", "--visit", 0, 1 },
1724 { "-file", "--file", 0, 1 },
1725 { "-insert", "--insert", 0, 1 },
1727 { "-NXOpen", 0, 0, 1 },
1728 { "-NXOpenTemp", 0, 0, 1 },
1729 { "-NSOpen", 0, 0, 1 },
1730 { "-NSOpenTemp", 0, 0, 1 },
1731 { "-GSFilePath", 0, 0, 1 },
1733 /* This should be processed after ordinary file name args and the like. */
1734 { "-kill", "--kill", -10, 0 },
1737 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1738 so that the highest priority ones come first.
1739 Do not change the order of elements of equal priority.
1740 If an option takes an argument, keep it and its argument together.
1742 If an option that takes no argument appears more
1743 than once, eliminate all but one copy of it. */
1746 sort_args (int argc
, char **argv
)
1748 char **new = xmalloc (argc
* sizeof *new);
1749 /* For each element of argv,
1750 the corresponding element of options is:
1751 0 for an option that takes no arguments,
1752 1 for an option that takes one argument, etc.
1753 -1 for an ordinary non-option argument. */
1754 int *options
= xnmalloc (argc
, sizeof *options
);
1755 int *priority
= xnmalloc (argc
, sizeof *priority
);
1757 int incoming_used
= 1;
1761 /* Categorize all the options,
1762 and figure out which argv elts are option arguments. */
1763 for (from
= 1; from
< argc
; from
++)
1767 if (argv
[from
][0] == '-')
1771 /* If we have found "--", don't consider
1772 any more arguments as options. */
1773 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1775 /* Leave the "--", and everything following it, at the end. */
1776 for (; from
< argc
; from
++)
1778 priority
[from
] = -100;
1784 /* Look for a match with a known old-fashioned option. */
1785 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1786 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1788 options
[from
] = standard_args
[i
].nargs
;
1789 priority
[from
] = standard_args
[i
].priority
;
1790 if (from
+ standard_args
[i
].nargs
>= argc
)
1791 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1792 from
+= standard_args
[i
].nargs
;
1796 /* Look for a match with a known long option.
1797 MATCH is -1 if no match so far, -2 if two or more matches so far,
1798 >= 0 (the table index of the match) if just one match so far. */
1799 if (argv
[from
][1] == '-')
1801 char const *equals
= strchr (argv
[from
], '=');
1803 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1807 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1808 if (standard_args
[i
].longname
1809 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1818 /* If we found exactly one match, use that. */
1821 options
[from
] = standard_args
[match
].nargs
;
1822 priority
[from
] = standard_args
[match
].priority
;
1823 /* If --OPTION=VALUE syntax is used,
1824 this option uses just one argv element. */
1827 if (from
+ options
[from
] >= argc
)
1828 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1829 from
+= options
[from
];
1831 /* FIXME When match < 0, shouldn't there be some error,
1832 or at least indication to the user that there was a
1839 /* Copy the arguments, in order of decreasing priority, to NEW. */
1841 while (incoming_used
< argc
)
1844 int best_priority
= -9999;
1846 /* Find the highest priority remaining option.
1847 If several have equal priority, take the first of them. */
1848 for (from
= 1; from
< argc
; from
++)
1850 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1852 best_priority
= priority
[from
];
1855 /* Skip option arguments--they are tied to the options. */
1856 if (options
[from
] > 0)
1857 from
+= options
[from
];
1863 /* Copy the highest priority remaining option, with its args, to NEW.
1864 Unless it is a duplicate of the previous one. */
1865 if (! (options
[best
] == 0
1866 && ! strcmp (new[to
- 1], argv
[best
])))
1868 new[to
++] = argv
[best
];
1869 for (i
= 0; i
< options
[best
]; i
++)
1870 new[to
++] = argv
[best
+ i
+ 1];
1873 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1875 /* Clear out this option in ARGV. */
1877 for (i
= 0; i
< options
[best
]; i
++)
1878 argv
[best
+ i
+ 1] = 0;
1881 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1885 memcpy (argv
, new, sizeof (char *) * argc
);
1892 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1893 doc
: /* Exit the Emacs job and kill it.
1894 If ARG is an integer, return ARG as the exit program code.
1895 If ARG is a string, stuff it as keyboard input.
1897 This function is called upon receipt of the signals SIGTERM
1898 or SIGHUP, and upon SIGINT in batch mode.
1900 The value of `kill-emacs-hook', if not void,
1901 is a list of functions (of no args),
1902 all of which are called before Emacs is actually killed. */
1903 attributes
: noreturn
)
1908 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1910 waiting_for_input
= 0;
1911 run_hook (Qkill_emacs_hook
);
1913 #ifdef HAVE_X_WINDOWS
1914 /* Transfer any clipboards we own to the clipboard manager. */
1915 x_clipboard_manager_save_all ();
1918 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
1921 ns_release_autorelease_pool (ns_pool
);
1924 /* If we have an auto-save list file,
1925 kill it because we are exiting Emacs deliberately (not crashing).
1926 Do it after shut_down_emacs, which does an auto-save. */
1927 if (STRINGP (Vauto_save_list_file_name
))
1929 Lisp_Object listfile
;
1930 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1931 unlink (SSDATA (listfile
));
1935 exit_code
= (XINT (arg
) < 0
1936 ? XINT (arg
) | INT_MIN
1937 : XINT (arg
) & INT_MAX
);
1939 exit_code
= EXIT_SUCCESS
;
1944 /* Perform an orderly shutdown of Emacs. Autosave any modified
1945 buffers, kill any child processes, clean up the terminal modes (if
1946 we're in the foreground), and other stuff like that. Don't perform
1947 any redisplay; this may be called when Emacs is shutting down in
1948 the background, or after its X connection has died.
1950 If SIG is a signal number, print a message for it.
1952 This is called by fatal signal handlers, X protocol error handlers,
1956 shut_down_emacs (int sig
, Lisp_Object stuff
)
1958 /* Prevent running of hooks from now on. */
1961 /* Don't update display from now on. */
1962 Vinhibit_redisplay
= Qt
;
1964 /* If we are controlling the terminal, reset terminal modes. */
1967 pid_t pgrp
= getpgrp ();
1968 pid_t tpgrp
= tcgetpgrp (0);
1969 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1971 reset_all_sys_modes ();
1972 if (sig
&& sig
!= SIGTERM
)
1974 static char const format
[] = "Fatal error %d: ";
1975 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1976 int buflen
= sprintf (buf
, format
, sig
);
1977 char const *sig_desc
= safe_strsignal (sig
);
1978 emacs_write (STDERR_FILENO
, buf
, buflen
);
1979 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1985 reset_all_sys_modes ();
1988 stuff_buffered_input (stuff
);
1990 inhibit_sentinels
= 1;
1991 kill_buffer_processes (Qnil
);
1992 Fdo_auto_save (Qt
, Qnil
);
1994 unlock_all_files ();
1996 /* There is a tendency for a SIGIO signal to arrive within exit,
1997 and cause a SIGHUP because the input descriptor is already closed. */
2000 /* Do this only if terminating normally, we want glyph matrices
2001 etc. in a core dump. */
2002 if (sig
== 0 || sig
== SIGTERM
)
2004 check_glyph_memory ();
2005 check_message_stack ();
2013 ns_term_shutdown (sig
);
2017 xml_cleanup_parser ();
2031 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2032 doc
: /* Dump current state of Emacs into executable file FILENAME.
2033 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2034 This is used in the file `loadup.el' when building Emacs.
2036 You must run Emacs in batch mode in order to dump it. */)
2037 (Lisp_Object filename
, Lisp_Object symfile
)
2041 ptrdiff_t count
= SPECPDL_INDEX ();
2045 if (! noninteractive
)
2046 error ("Dumping Emacs works only in batch mode");
2049 error ("Emacs can be dumped only once");
2053 /* Warn if the gap between BSS end and heap start is larger than this. */
2054 # define MAX_HEAP_BSS_DIFF (1024*1024)
2056 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2058 fprintf (stderr
, "**************************************************\n");
2059 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2060 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2062 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2063 fprintf (stderr
, "fail because of this. See the section about\n");
2064 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2065 fprintf (stderr
, "**************************************************\n");
2067 #endif /* GNU_LINUX */
2069 /* Bind `command-line-processed' to nil before dumping,
2070 so that the dumped Emacs will process its command line
2071 and set up to work with X windows if appropriate. */
2072 symbol
= intern ("command-line-processed");
2073 specbind (symbol
, Qnil
);
2075 CHECK_STRING (filename
);
2076 filename
= Fexpand_file_name (filename
, Qnil
);
2077 filename
= ENCODE_FILE (filename
);
2078 if (!NILP (symfile
))
2080 CHECK_STRING (symfile
);
2081 if (SCHARS (symfile
))
2083 symfile
= Fexpand_file_name (symfile
, Qnil
);
2084 symfile
= ENCODE_FILE (symfile
);
2089 Vpurify_flag
= Qnil
;
2091 #ifdef HYBRID_MALLOC
2093 static char const fmt
[] = "%d of %d static heap bytes used";
2094 char buf
[sizeof fmt
+ 2 * (INT_STRLEN_BOUND (int) - 2)];
2095 int max_usage
= max_bss_sbrk_ptr
- bss_sbrk_buffer
;
2096 sprintf (buf
, fmt
, max_usage
, STATIC_HEAP_SIZE
);
2097 /* Don't log messages, because at this point buffers cannot be created. */
2098 message1_nolog (buf
);
2103 /* Tell malloc where start of impure now is. */
2104 /* Also arrange for warnings when nearly out of space. */
2105 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2107 /* On Windows, this was done before dumping, and that once suffices.
2108 Meanwhile, my_edata is not valid on Windows. */
2109 memory_warnings (my_edata
, malloc_warning
);
2110 #endif /* not WINDOWSNT */
2111 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2113 alloc_unexec_pre ();
2115 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2117 alloc_unexec_post ();
2120 Vlibrary_cache
= Qnil
;
2122 #ifdef HAVE_WINDOW_SYSTEM
2123 reset_image_types ();
2128 return unbind_to (count
, Qnil
);
2131 #endif /* not CANNOT_DUMP */
2134 /* Recover from setlocale (LC_ALL, ""). */
2138 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2139 so that numbers are read and printed properly for Emacs Lisp. */
2140 setlocale (LC_NUMERIC
, "C");
2143 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2146 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2148 if (! EQ (*plocale
, desired_locale
))
2150 *plocale
= desired_locale
;
2152 /* Changing categories like LC_TIME usually requires specifying
2153 an encoding suitable for the new locale, but MS-Windows's
2154 'setlocale' will only switch the encoding when LC_ALL is
2155 specified. So we ignore CATEGORY, use LC_ALL instead, and
2156 then restore LC_NUMERIC to "C", so reading and printing
2157 numbers is unaffected. */
2158 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2159 ? SSDATA (desired_locale
)
2162 #else /* !WINDOWSNT */
2163 setlocale (category
, (STRINGP (desired_locale
)
2164 ? SSDATA (desired_locale
)
2166 #endif /* !WINDOWSNT */
2170 /* Set system time locale to match Vsystem_time_locale, if possible. */
2172 synchronize_system_time_locale (void)
2174 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2175 Vsystem_time_locale
);
2178 /* Set system messages locale to match Vsystem_messages_locale, if
2181 synchronize_system_messages_locale (void)
2184 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2185 Vsystem_messages_locale
);
2188 #endif /* HAVE_SETLOCALE */
2192 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2194 const char *path
, *p
;
2195 Lisp_Object lpath
, element
, tem
;
2196 /* Default is to use "." for empty path elements.
2197 But if argument EMPTY is true, use nil instead. */
2198 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2201 static const char *emacs_dir_env
= "%emacs_dir%/";
2202 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2203 const char *edir
= egetenv ("emacs_dir");
2204 char emacs_dir
[MAX_UTF8_PATH
];
2206 /* egetenv looks in process-environment, which holds the variables
2207 in their original system-locale encoding. We need emacs_dir to
2210 filename_from_ansi (edir
, emacs_dir
);
2213 /* It's okay to use getenv here, because this function is only used
2214 to initialize variables when Emacs starts up, and isn't called
2217 path
= getenv (evarname
);
2228 /* Ensure values from the environment use the proper directory separator. */
2234 char *path_utf8
, *q
, *d
;
2237 /* Convert each element of PATH to UTF-8. */
2238 p
= path_copy
= alloca (strlen (path
) + 1);
2239 strcpy (path_copy
, path
);
2240 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2243 q
= _mbschr (p
, SEPCHAR
);
2246 cnv_result
= filename_from_ansi (p
, d
);
2251 /* If conversion of this PATH elements fails, make sure
2252 destination pointer will stay put, thus effectively
2253 ignoring the offending element. */
2254 if (cnv_result
== 0)
2260 else if (cnv_result
!= 0 && d
> path_utf8
)
2261 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2263 path_copy
= path_utf8
;
2265 path_copy
= alloca (strlen (path
) + 1);
2266 strcpy (path_copy
, path
);
2268 dostounix_filename (path_copy
);
2275 p
= strchr (path
, SEPCHAR
);
2277 p
= path
+ strlen (path
);
2278 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2280 if (! NILP (element
))
2283 /* Relative file names in the default path are interpreted as
2284 being relative to $emacs_dir. */
2285 if (edir
&& defaulted
2286 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2287 element
= Fexpand_file_name (Fsubstring
2289 make_number (emacs_dir_len
),
2291 build_unibyte_string (emacs_dir
));
2294 /* Add /: to the front of the name
2295 if it would otherwise be treated as magic. */
2296 tem
= Ffind_file_name_handler (element
, Qt
);
2298 /* However, if the handler says "I'm safe",
2299 don't bother adding /:. */
2303 prop
= Fget (tem
, intern ("safe-magic"));
2310 AUTO_STRING (slash_colon
, "/:");
2311 element
= concat2 (slash_colon
, element
);
2313 } /* !NILP (element) */
2315 lpath
= Fcons (element
, lpath
);
2321 return Fnreverse (lpath
);
2324 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2325 doc
: /* Return non-nil if the current emacs process is a daemon.
2326 If the daemon was given a name argument, return that name. */)
2331 return build_string (daemon_name
);
2338 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2339 doc
: /* Mark the Emacs daemon as being initialized.
2340 This finishes the daemonization process by doing the other half of detaching
2341 from the parent process and its tty file descriptors. */)
2347 error ("This function can only be called if emacs is run as a daemon");
2349 if (!DAEMON_RUNNING
)
2350 error ("The daemon has already been initialized");
2352 if (NILP (Vafter_init_time
))
2353 error ("This function can only be called after loading the init files");
2357 /* Get rid of stdin, stdout and stderr. */
2358 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2360 err
|= dup2 (nfd
, 0) < 0;
2361 err
|= dup2 (nfd
, 1) < 0;
2362 err
|= dup2 (nfd
, 2) < 0;
2363 err
|= emacs_close (nfd
) != 0;
2365 /* Closing the pipe will notify the parent that it can exit.
2366 FIXME: In case some other process inherited the pipe, closing it here
2367 won't notify the parent because it's still open elsewhere, so we
2368 additionally send a byte, just to make sure the parent really exits.
2369 Instead, we should probably close the pipe in start-process and
2370 call-process to make sure the pipe is never inherited by
2372 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2373 err
|= emacs_close (daemon_pipe
[1]) != 0;
2374 /* Set it to an invalid value so we know we've already run this function. */
2375 daemon_pipe
[1] = -1;
2376 #else /* WINDOWSNT */
2377 /* Signal the waiting emacsclient process. */
2378 err
|= SetEvent (w32_daemon_event
) == 0;
2379 err
|= CloseHandle (w32_daemon_event
) == 0;
2380 /* Set it to an invalid value so we know we've already run this function. */
2381 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2385 error ("I/O error during daemon initialization");
2390 syms_of_emacs (void)
2392 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2393 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2394 DEFSYM (Qkill_emacs
, "kill-emacs");
2395 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2398 defsubr (&Sdump_emacs
);
2401 defsubr (&Skill_emacs
);
2403 defsubr (&Sinvocation_name
);
2404 defsubr (&Sinvocation_directory
);
2405 defsubr (&Sdaemonp
);
2406 defsubr (&Sdaemon_initialized
);
2408 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2409 doc
: /* Args passed by shell to Emacs, as a list of strings.
2410 Many arguments are deleted from the list as they are processed. */);
2412 DEFVAR_LISP ("system-type", Vsystem_type
,
2413 doc
: /* The value is a symbol indicating the type of operating system you are using.
2415 `gnu' compiled for a GNU Hurd system.
2416 `gnu/linux' compiled for a GNU/Linux system.
2417 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2418 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2419 `ms-dos' compiled as an MS-DOS application.
2420 `windows-nt' compiled as a native W32 application.
2421 `cygwin' compiled using the Cygwin library.
2422 Anything else (in Emacs 26, the possibilities are: aix, berkeley-unix,
2423 hpux, usg-unix-v) indicates some sort of Unix system. */);
2424 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2425 /* See configure.ac for the possible SYSTEM_TYPEs. */
2427 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2428 doc
: /* Value is string indicating configuration Emacs was built for. */);
2429 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2431 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2432 doc
: /* String containing the configuration options Emacs was built with. */);
2433 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2435 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2436 doc
: /* String listing some of the main features this Emacs was compiled with.
2437 An element of the form \"FOO\" generally means that HAVE_FOO was
2438 defined during the build.
2440 This is mainly intended for diagnostic purposes in bug reports.
2441 Don't rely on it for testing whether a feature you want to use is available. */);
2442 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2444 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2445 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2447 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2448 doc
: /* Hook run when `kill-emacs' is called.
2449 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2450 in other similar situations), functions placed on this hook should not
2451 expect to be able to interact with the user. To ask for confirmation,
2452 see `kill-emacs-query-functions' instead.
2454 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2455 `noninteractive' was non-nil. */);
2456 Vkill_emacs_hook
= Qnil
;
2458 DEFVAR_LISP ("path-separator", Vpath_separator
,
2459 doc
: /* String containing the character that separates directories in
2460 search paths, such as PATH and other similar environment variables. */);
2463 Vpath_separator
= make_string (&c
, 1);
2466 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2467 doc
: /* The program name that was used to run Emacs.
2468 Any directory names are omitted. */);
2470 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2471 doc
: /* The directory in which the Emacs executable was found, to run it.
2472 The value is nil if that directory's name is not known. */);
2474 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2475 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2476 In an installed Emacs, this is normally nil. It is non-nil if
2477 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2478 within the variable `invocation-directory' or its parent. For example,
2479 this is the case when running an uninstalled Emacs executable from its
2480 build directory. */);
2481 Vinstallation_directory
= Qnil
;
2483 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2484 doc
: /* System locale for messages. */);
2485 Vsystem_messages_locale
= Qnil
;
2487 DEFVAR_LISP ("previous-system-messages-locale",
2488 Vprevious_system_messages_locale
,
2489 doc
: /* Most recently used system locale for messages. */);
2490 Vprevious_system_messages_locale
= Qnil
;
2492 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2493 doc
: /* System locale for time. */);
2494 Vsystem_time_locale
= Qnil
;
2496 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2497 doc
: /* Most recently used system locale for time. */);
2498 Vprevious_system_time_locale
= Qnil
;
2500 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2501 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2502 Vbefore_init_time
= Qnil
;
2504 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2505 doc
: /* Value of `current-time' after loading the init files.
2506 This is nil during initialization. */);
2507 Vafter_init_time
= Qnil
;
2509 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2510 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2511 inhibit_x_resources
= 0;
2513 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2514 doc
: /* Short copyright string for this version of Emacs. */);
2515 Vemacs_copyright
= build_string (emacs_copyright
);
2517 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2518 doc
: /* Version numbers of this version of Emacs. */);
2519 Vemacs_version
= build_string (emacs_version
);
2521 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2522 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2523 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2525 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2526 doc
: /* Alist of dynamic libraries vs external files implementing them.
2527 Each element is a list (LIBRARY FILE...), where the car is a symbol
2528 representing a supported external library, and the rest are strings giving
2529 alternate filenames for that library.
2531 Emacs tries to load the library from the files in the order they appear on
2532 the list; if none is loaded, the running session of Emacs won't have access
2535 Note that image types `pbm' and `xbm' do not need entries in this variable
2536 because they do not depend on external libraries and are always available.
2538 Also note that this is not a generic facility for accessing external
2539 libraries; only those already known by Emacs will be loaded. */);
2540 Vdynamic_library_alist
= Qnil
;
2541 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2544 Vlibrary_cache
= Qnil
;
2545 staticpro (&Vlibrary_cache
);