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
11 (at 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"
83 #include "sysselect.h"
89 #if (defined PROFILING \
90 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
91 # include <sys/gmon.h>
92 extern void moncontrol (int mode
);
103 #ifdef HAVE_SETRLIMIT
104 #include <sys/time.h>
105 #include <sys/resource.h>
108 #ifdef HAVE_PERSONALITY_LINUX32
109 #include <sys/personality.h>
112 static const char emacs_version
[] = PACKAGE_VERSION
;
113 static const char emacs_copyright
[] = COPYRIGHT
;
114 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
116 /* Empty lisp strings. To avoid having to build any others. */
117 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
120 /* Cache for externally loaded libraries. */
121 Lisp_Object Vlibrary_cache
;
124 /* Set after Emacs has started up the first time.
125 Prevents reinitialization of the Lisp world and keymaps
126 on subsequent starts. */
129 /* Set to true if this instance of Emacs might dump. */
133 extern void unexec_init_emacs_zone (void);
136 extern void malloc_enable_thread (void);
138 /* If true, Emacs should not attempt to use a window-specific code,
139 but instead should use the virtual terminal under which it was started. */
140 bool inhibit_window_system
;
142 /* If true, a filter or a sentinel is running. Tested to save the match
143 data on the first attempt to change it inside asynchronous code. */
144 bool running_asynch_code
;
146 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
147 /* If true, -d was specified, meaning we're using some window system. */
151 /* An address near the bottom of the stack.
152 Tells GC how to save a copy of the stack. */
156 /* The gap between BSS end and heap start as far as we can tell. */
157 static uprintmax_t heap_bss_diff
;
160 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
163 On Cocoa, CoreFoundation lib fails in forked process:
164 http://developer.apple.com/ReleaseNotes/
165 CoreFoundation/CoreFoundation.html)
167 On Windows, a Cygwin fork child cannot access the USER subsystem.
169 We mark being in the exec'd process by a daemon name argument of
170 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
171 NAME is the original daemon name, if any. */
172 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
173 # define DAEMON_MUST_EXEC
176 /* True means running Emacs without interactive terminal. */
179 /* True means remove site-lisp directories from load-path. */
182 /* Name for the server started by the daemon.*/
183 static char *daemon_name
;
186 /* Pipe used to send exit notification to the daemon parent at
190 HANDLE w32_daemon_event
;
193 /* Save argv and argc. */
197 static void sort_args (int argc
, char **argv
);
198 static void syms_of_emacs (void);
200 /* C99 needs each string to be at most 4095 characters, and the usage
201 strings below are split to not overflow this limit. */
202 static char const *const usage_message
[] =
205 Run Emacs, the extensible, customizable, self-documenting real-time\n\
206 display editor. The recommended way to start Emacs for normal editing\n\
207 is with no options at all.\n\
209 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
210 read the main documentation for these command-line arguments.\n\
212 Initialization options:\n\
216 --batch do not do interactive display; implies -q\n\
217 --chdir DIR change to directory DIR\n\
218 --daemon start a server in the background\n\
219 --debug-init enable Emacs Lisp debugger for init file\n\
220 --display, -d DISPLAY use X server DISPLAY\n\
223 --no-desktop do not load a saved desktop\n\
224 --no-init-file, -q load neither ~/.emacs nor default.el\n\
225 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
226 --no-site-file do not load site-start.el\n\
227 --no-x-resources do not load X resources\n\
228 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
229 --no-splash do not display a splash screen on startup\n\
230 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
233 --quick, -Q equivalent to:\n\
234 -q --no-site-file --no-site-lisp --no-splash\n\
236 --script FILE run FILE as an Emacs Lisp script\n\
237 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
238 --user, -u USER load ~USER/.emacs instead of your own\n\
244 FILE visit FILE using find-file\n\
245 +LINE go to line LINE in next FILE\n\
246 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
247 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
248 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
249 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
252 --file FILE visit FILE using find-file\n\
253 --find-file FILE visit FILE using find-file\n\
254 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
255 --insert FILE insert contents of FILE into current buffer\n\
256 --kill exit without asking for confirmation\n\
257 --load, -l FILE load Emacs Lisp FILE using the load function\n\
258 --visit FILE visit FILE using find-file\n\
264 --background-color, -bg COLOR window background color\n\
265 --basic-display, -D disable many display features;\n\
266 used for debugging Emacs\n\
267 --border-color, -bd COLOR main border color\n\
268 --border-width, -bw WIDTH width of main border\n\
271 --color, --color=MODE override color mode for character terminals;\n\
272 MODE defaults to `auto', and\n\
273 can also be `never', `always',\n\
274 or a mode name like `ansi8'\n\
275 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
276 --font, -fn FONT default font; must be fixed-width\n\
277 --foreground-color, -fg COLOR window foreground color\n\
280 --fullheight, -fh make the first frame high as the screen\n\
281 --fullscreen, -fs make the first frame fullscreen\n\
282 --fullwidth, -fw make the first frame wide as the screen\n\
283 --maximized, -mm make the first frame maximized\n\
284 --geometry, -g GEOMETRY window geometry\n\
287 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
288 --iconic start Emacs in iconified state\n\
289 --internal-border, -ib WIDTH width between text and main border\n\
290 --line-spacing, -lsp PIXELS additional space to put between lines\n\
291 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
292 --name NAME title for initial Emacs frame\n\
295 --no-blinking-cursor, -nbc disable blinking cursor\n\
296 --reverse-video, -r, -rv switch foreground and background\n\
297 --title, -T TITLE title for initial Emacs frame\n\
298 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
299 --xrm XRESOURCES set additional X resources\n\
300 --parent-id XID set parent window\n\
301 --help display this help and exit\n\
302 --version output version information and exit\n\
306 You can generally also specify long option names with a single -; for\n\
307 example, -batch as well as --batch. You can use any unambiguous\n\
308 abbreviation for a --option.\n\
310 Various environment variables and window system resources also affect\n\
311 the operation of Emacs. See the main documentation.\n\
313 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
314 section of the Emacs manual or the file BUGS.\n"
318 /* True if handling a fatal error already. */
319 bool fatal_error_in_progress
;
322 /* NS autrelease pool, for memory management. */
323 static void *ns_pool
;
328 setlocale (int cat
, char const *locale
)
334 /* True if the current system locale uses UTF-8 encoding. */
340 mbstate_t mbs
= { 0 };
341 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
348 /* Report a fatal error due to signal SIG, output a backtrace of at
349 most BACKTRACE_LIMIT lines, and exit. */
351 terminate_due_to_signal (int sig
, int backtrace_limit
)
353 signal (sig
, SIG_DFL
);
355 if (attempt_orderly_shutdown_on_fatal_signal
)
357 /* If fatal error occurs in code below, avoid infinite recursion. */
358 if (! fatal_error_in_progress
)
360 fatal_error_in_progress
= 1;
362 totally_unblock_input ();
363 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
364 Fkill_emacs (make_number (sig
));
366 shut_down_emacs (sig
, Qnil
);
367 emacs_backtrace (backtrace_limit
);
371 /* Signal the same code; this time it will really be fatal.
372 Since we're in a signal handler, the signal is blocked, so we
373 have to unblock it if we want to really receive it. */
377 sigemptyset (&unblocked
);
378 sigaddset (&unblocked
, sig
);
379 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
385 /* This shouldn't be executed, but it prevents a warning. */
389 /* Code for dealing with Lisp access to the Unix command line. */
392 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
395 Lisp_Object name
, dir
, handler
;
396 ptrdiff_t count
= SPECPDL_INDEX ();
397 Lisp_Object raw_name
;
398 AUTO_STRING (slash_colon
, "/:");
404 /* Must use argv[0] converted to UTF-8, as it begets many standard
405 file and directory names. */
407 char argv0
[MAX_UTF8_PATH
];
409 if (filename_from_ansi (argv
[0], argv0
) == 0)
410 raw_name
= build_unibyte_string (argv0
);
412 raw_name
= build_unibyte_string (argv
[0]);
415 raw_name
= build_unibyte_string (argv
[0]);
418 /* Add /: to the front of the name
419 if it would otherwise be treated as magic. */
420 handler
= Ffind_file_name_handler (raw_name
, Qt
);
421 if (! NILP (handler
))
422 raw_name
= concat2 (slash_colon
, raw_name
);
424 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
425 Vinvocation_directory
= Ffile_name_directory (raw_name
);
427 /* If we got no directory in argv[0], search PATH to find where
428 Emacs actually came from. */
429 if (NILP (Vinvocation_directory
))
432 int yes
= openp (Vexec_path
, Vinvocation_name
,
433 Vexec_suffixes
, &found
, make_number (X_OK
), false);
436 /* Add /: to the front of the name
437 if it would otherwise be treated as magic. */
438 handler
= Ffind_file_name_handler (found
, Qt
);
439 if (! NILP (handler
))
440 found
= concat2 (slash_colon
, found
);
441 Vinvocation_directory
= Ffile_name_directory (found
);
445 if (!NILP (Vinvocation_directory
)
446 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
447 /* Emacs was started with relative path, like ./emacs.
451 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
453 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
456 Vinstallation_directory
= Qnil
;
458 if (!NILP (Vinvocation_directory
))
460 dir
= Vinvocation_directory
;
462 /* If we are running from the build directory, set DIR to the
463 src subdirectory of the Emacs tree, like on Posix
465 if (SBYTES (dir
) > sizeof ("/i386/") - 1
466 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
468 dir
= Fexpand_file_name (build_string ("../.."), dir
);
469 #else /* !WINDOWSNT */
471 name
= Fexpand_file_name (Vinvocation_name
, dir
);
474 Lisp_Object tem
, lib_src_exists
;
475 Lisp_Object etc_exists
, info_exists
;
477 /* See if dir contains subdirs for use by Emacs.
478 Check for the ones that would exist in a build directory,
479 not including lisp and info. */
480 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
481 lib_src_exists
= Ffile_exists_p (tem
);
484 /* MSDOS installations frequently remove lib-src, but we still
485 must set installation-directory, or else info won't find
486 its files (it uses the value of installation-directory). */
487 tem
= Fexpand_file_name (build_string ("info"), dir
);
488 info_exists
= Ffile_exists_p (tem
);
493 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
495 tem
= Fexpand_file_name (build_string ("etc"), dir
);
496 etc_exists
= Ffile_exists_p (tem
);
497 if (!NILP (etc_exists
))
499 Vinstallation_directory
500 = Ffile_name_as_directory (dir
);
505 /* See if dir's parent contains those subdirs. */
506 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
507 lib_src_exists
= Ffile_exists_p (tem
);
511 /* See the MSDOS commentary above. */
512 tem
= Fexpand_file_name (build_string ("../info"), dir
);
513 info_exists
= Ffile_exists_p (tem
);
518 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
520 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
521 etc_exists
= Ffile_exists_p (tem
);
522 if (!NILP (etc_exists
))
524 tem
= Fexpand_file_name (build_string (".."), dir
);
525 Vinstallation_directory
526 = Ffile_name_as_directory (tem
);
531 /* If the Emacs executable is actually a link,
532 next try the dir that the link points into. */
533 tem
= Ffile_symlink_p (name
);
536 name
= Fexpand_file_name (tem
, dir
);
537 dir
= Ffile_name_directory (name
);
544 Vcommand_line_args
= Qnil
;
546 for (i
= argc
- 1; i
>= 0; i
--)
548 if (i
== 0 || i
> skip_args
)
549 /* For the moment, we keep arguments as is in unibyte strings.
550 They are decoded in the function command-line after we know
551 locale-coding-system. */
553 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
556 unbind_to (count
, Qnil
);
559 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
560 doc
: /* Return the program name that was used to run Emacs.
561 Any directory names are omitted. */)
564 return Fcopy_sequence (Vinvocation_name
);
567 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
569 doc
: /* Return the directory name in which the Emacs executable was located. */)
572 return Fcopy_sequence (Vinvocation_directory
);
576 /* Test whether the next argument in ARGV matches SSTR or a prefix of
577 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
578 (the argument is supposed to have a value) store in *VALPTR either
579 the next argument or the portion of this one after the equal sign.
580 ARGV is read starting at position *SKIPPTR; this index is advanced
581 by the number of arguments used.
583 Too bad we can't just use getopt for all of this, but we don't have
584 enough information to do it right. */
587 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
588 int minlen
, char **valptr
, int *skipptr
)
594 /* Don't access argv[argc]; give up in advance. */
595 if (argc
<= *skipptr
+ 1)
598 arg
= argv
[*skipptr
+1];
601 if (strcmp (arg
, sstr
) == 0)
605 *valptr
= argv
[*skipptr
+2];
612 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
613 ? p
- arg
: strlen (arg
));
614 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
616 else if (valptr
== NULL
)
627 else if (argv
[*skipptr
+2] != NULL
)
629 *valptr
= argv
[*skipptr
+2];
639 /* Close standard output and standard error, reporting any write
640 errors as best we can. This is intended for use with atexit. */
642 close_output_streams (void)
644 if (close_stream (stdout
) != 0)
646 emacs_perror ("Write error to standard output");
647 _exit (EXIT_FAILURE
);
650 if (close_stream (stderr
) != 0)
651 _exit (EXIT_FAILURE
);
656 main (int argc
, char **argv
)
659 char stack_bottom_variable
;
660 bool do_initial_setlocale
;
663 #ifdef HAVE_SETRLIMIT
669 #ifdef DAEMON_MUST_EXEC
674 /* If we use --chdir, this records the original directory. */
675 char *original_pwd
= 0;
680 might_dump
= !initialized
;
686 char *heap_start
= my_heap_start ();
687 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
691 #if defined WINDOWSNT || defined HAVE_NTGUI
692 /* Set global variables used to detect Windows version. Do this as
693 early as possible. (unexw32.c calls this function as well, but
694 the additional call here is harmless.) */
695 cache_system_info ();
697 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
698 to have non-stub implementations of APIs we need to convert file
699 names between UTF-8 and the system's ANSI codepage. */
700 maybe_load_unicows_dll ();
702 /* This has to be done before module_init is called below, so that
703 the latter could use the thread ID of the main thread. */
704 w32_init_main_thread ();
707 #ifdef RUN_TIME_REMAP
709 run_time_remap (argv
[0]);
712 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
715 unexec_init_emacs_zone ();
718 atexit (close_output_streams
);
724 sort_args (argc
, argv
);
726 while (argv
[argc
]) argc
++;
728 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
730 const char *version
, *copyright
;
733 Lisp_Object tem
, tem2
;
734 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
735 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
738 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
743 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
748 version
= SSDATA (tem
);
749 copyright
= SSDATA (tem2
);
754 version
= emacs_version
;
755 copyright
= emacs_copyright
;
757 printf ("%s %s\n", PACKAGE_NAME
, version
);
758 printf ("%s\n", copyright
);
759 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
760 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
761 printf ("under the terms of the GNU General Public License.\n");
762 printf ("For more information about these matters, ");
763 printf ("see the file named COPYING.\n");
767 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
770 /* argv[] array is kept in its original ANSI codepage encoding,
771 we need to convert to UTF-8, for chdir to work. */
772 char newdir
[MAX_UTF8_PATH
];
774 filename_from_ansi (ch_to_dir
, newdir
);
777 original_pwd
= get_current_dir_name ();
778 if (chdir (ch_to_dir
) != 0)
780 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
781 argv
[0], ch_to_dir
, strerror (errno
));
786 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
787 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
789 #ifdef HAVE_PERSONALITY_LINUX32
790 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
792 /* Set this so we only do this once. */
793 xputenv ("EMACS_HEAP_EXEC=true");
795 /* A flag to turn off address randomization which is introduced
796 in linux kernel shipped with fedora core 4 */
797 #define ADD_NO_RANDOMIZE 0x0040000
798 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
799 #undef ADD_NO_RANDOMIZE
801 execvp (argv
[0], argv
);
803 /* If the exec fails, try to dump anyway. */
804 emacs_perror (argv
[0]);
806 #endif /* HAVE_PERSONALITY_LINUX32 */
808 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
809 /* Extend the stack space available. Don't do that if dumping,
810 since some systems (e.g. DJGPP) might define a smaller stack
811 limit at that time. And it's not needed on Cygwin, since emacs
812 is built with an 8MB stack. Moreover, the setrlimit call can
813 cause problems on Cygwin
814 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
817 && (!noninteractive
|| initialized
)
819 && !getrlimit (RLIMIT_STACK
, &rlim
))
822 /* Approximate the amount regex.c needs per unit of re_max_failures. */
823 int ratio
= 20 * sizeof (char *);
824 /* Then add 33% to cover the size of the smaller stacks that regex.c
825 successively allocates and discards, on its way to the maximum. */
827 /* Add in some extra to cover
828 what we're likely to use for other reasons. */
829 newlim
= re_max_failures
* ratio
+ 200000;
831 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
832 stack allocation routine for new process that the allocation
833 fails if stack limit is not on page boundary. So, round up the
834 new limit to page boundary. */
835 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
837 if (newlim
> rlim
.rlim_max
)
839 newlim
= rlim
.rlim_max
;
840 /* Don't let regex.c overflow the stack we have. */
841 re_max_failures
= (newlim
- 200000) / ratio
;
843 if (rlim
.rlim_cur
< newlim
)
844 rlim
.rlim_cur
= newlim
;
846 setrlimit (RLIMIT_STACK
, &rlim
);
848 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
850 /* Record (approximately) where the stack begins. */
851 stack_bottom
= &stack_bottom_variable
;
855 emacs_backtrace (-1);
857 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
858 /* Arrange to get warning messages as memory fills up. */
859 memory_warnings (0, malloc_warning
);
861 /* Call malloc at least once, to run malloc_initialize_hook.
862 Also call realloc and free for consistency. */
863 free (realloc (malloc (4), 4));
865 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
868 SET_BINARY (fileno (stdin
));
870 SET_BINARY (fileno (stdout
));
873 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
874 The build procedure uses this while dumping, to ensure that the
875 dumped Emacs does not have its system locale tables initialized,
876 as that might cause screwups when the dumped Emacs starts up. */
878 char *lc_all
= getenv ("LC_ALL");
879 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
882 /* Set locale now, so that initial error messages are localized properly.
883 fixup_locale must wait until later, since it builds strings. */
884 if (do_initial_setlocale
)
885 setlocale (LC_ALL
, "");
886 text_quoting_flag
= using_utf8 ();
888 inhibit_window_system
= 0;
890 /* Handle the -t switch, which specifies filename to use as terminal. */
894 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
899 result
= emacs_open (term
, O_RDWR
, 0);
900 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
902 char *errstring
= strerror (errno
);
903 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
908 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
911 fprintf (stderr
, "Using %s\n", term
);
912 #ifdef HAVE_WINDOW_SYSTEM
913 inhibit_window_system
= 1; /* -t => -nw */
920 /* Command line option --no-windows is deprecated and thus not mentioned
921 in the manual and usage information. */
922 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
923 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
924 inhibit_window_system
= 1;
926 /* Handle the -batch switch, which means don't do interactive display. */
928 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
931 Vundo_outer_limit
= Qnil
;
933 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
935 noninteractive
= 1; /* Set batch mode. */
936 /* Convert --script to -scriptload, un-skip it, and sort again
937 so that it will be handled in proper sequence. */
938 /* FIXME broken for --script=FILE - is that supposed to work? */
939 argv
[skip_args
- 1] = (char *) "-scriptload";
941 sort_args (argc
, argv
);
944 /* Handle the --help option, which gives a usage message. */
945 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
948 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
949 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
950 fputs (usage_message
[i
], stdout
);
955 /* Make sure IS_DAEMON starts up as false. */
958 w32_daemon_event
= NULL
;
961 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
962 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
967 /* Start as a daemon: fork a new child process which will run the
968 rest of the initialization code, then exit.
970 Detaching a daemon requires the following steps:
974 - close the tty file-descriptors
976 We only want to do the last 2 steps once the daemon is ready to
977 serve requests, i.e. after loading .emacs (initialization).
978 OTOH initialization may start subprocesses (e.g. ispell) and these
979 should be run from the proper process (the one that will end up
980 running as daemon) and with the proper "session id" in order for
981 them to keep working after detaching, so fork and setsid need to be
982 performed before initialization.
984 We want to avoid exiting before the server socket is ready, so
985 use a pipe for synchronization. The parent waits for the child
986 to close its end of the pipe (using `daemon-initialized')
988 if (emacs_pipe (daemon_pipe
) != 0)
990 fprintf (stderr
, "Cannot pipe!\n");
994 #ifndef DAEMON_MUST_EXEC
996 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
997 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
998 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1001 #else /* DAEMON_MUST_EXEC */
1002 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1003 f
= fork (); /* in orig */
1005 f
= 0; /* in exec'd */
1006 #endif /* !DAEMON_MUST_EXEC */
1012 /* Close unused writing end of the pipe. */
1013 emacs_close (daemon_pipe
[1]);
1015 /* Just wait for the child to close its end of the pipe. */
1018 retval
= read (daemon_pipe
[0], &buf
, 1);
1020 while (retval
== -1 && errno
== EINTR
);
1024 fprintf (stderr
, "Error reading status from child\n");
1027 else if (retval
== 0)
1029 fprintf (stderr
, "Error: server did not start correctly\n");
1033 emacs_close (daemon_pipe
[0]);
1038 emacs_perror ("fork");
1039 exit (EXIT_CANCELED
);
1042 #ifdef DAEMON_MUST_EXEC
1044 /* In orig process, forked as child, OR in exec'd. */
1045 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1046 { /* In orig, child: now exec w/special daemon name. */
1049 snprintf (fdStr
, sizeof fdStr
,
1050 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1051 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1053 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1055 fprintf (stderr
, "daemon: child name too long\n");
1056 exit (EXIT_CANNOT_INVOKE
);
1059 argv
[skip_args
] = fdStr
;
1061 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1062 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1063 execvp (argv
[0], argv
);
1064 emacs_perror (argv
[0]);
1065 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1068 /* In exec'd: parse special dname into pipe and name info. */
1069 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1070 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1072 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1073 exit (EXIT_CANNOT_INVOKE
);
1075 dname_arg2
[0] = '\0';
1076 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1078 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1079 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1081 #endif /* DAEMON_MUST_EXEC */
1083 /* Close unused reading end of the pipe. */
1084 emacs_close (daemon_pipe
[0]);
1087 #elif defined(WINDOWSNT)
1088 /* Indicate that we want daemon mode. */
1089 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1090 if (w32_daemon_event
== NULL
)
1092 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1097 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1101 daemon_name
= xstrdup (dname_arg
);
1104 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1105 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1106 # ifndef CANNOT_DUMP
1107 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1108 that causes an infinite recursive loop with FreeBSD. See
1109 Bug#14569. The part of this bug involving Cygwin is no longer
1110 relevant, now that Cygwin defines HYBRID_MALLOC. */
1111 if (!noninteractive
|| initialized
)
1113 malloc_enable_thread ();
1116 init_signals (dumping
);
1118 noninteractive1
= noninteractive
;
1120 /* Perform basic initializations (not merely interning symbols). */
1127 init_charset_once ();
1128 init_coding_once ();
1129 init_syntax_once (); /* Create standard syntax table. */
1130 init_category_once (); /* Create standard category table. */
1131 init_casetab_once (); /* Must be done before init_buffer_once. */
1132 init_buffer_once (); /* Create buffer table and some buffers. */
1133 init_minibuf_once (); /* Create list of minibuffers. */
1134 /* Must precede init_window_once. */
1136 /* Call syms_of_xfaces before init_window_once because that
1137 function creates Vterminal_frame. Termcap frames now use
1138 faces, and the face implementation uses some symbols as
1141 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1142 be better to arrange things not to have this dependency. */
1144 /* Call syms_of_keyboard before init_window_once because
1145 keyboard sets up symbols that include some face names that
1146 the X support will want to use. This can happen when
1147 CANNOT_DUMP is defined. */
1148 syms_of_keyboard ();
1150 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1152 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1154 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1156 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1158 /* Before syms_of_coding because it initializes Qcharsetp. */
1160 /* Before init_window_once, because it sets up the
1161 Vcoding_system_hash_table. */
1162 syms_of_coding (); /* This should be after syms_of_fileio. */
1164 init_window_once (); /* Init the window system. */
1165 #ifdef HAVE_WINDOW_SYSTEM
1166 init_fringe_once (); /* Swap bitmaps if necessary. */
1167 #endif /* HAVE_WINDOW_SYSTEM */
1172 if (do_initial_setlocale
)
1175 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1176 Vsystem_time_locale
= Vprevious_system_time_locale
;
1181 running_asynch_code
= 0;
1185 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1188 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1191 ns_pool
= ns_alloc_autorelease_pool ();
1192 #ifdef NS_IMPL_GNUSTEP
1193 /* GNUstep stupidly resets our locale settings after we made them. */
1197 if (!noninteractive
)
1199 #ifdef NS_IMPL_COCOA
1200 /* Started from GUI? */
1201 /* FIXME: Do the right thing if getenv returns NULL, or if
1203 if (! inhibit_window_system
&& ! isatty (0) && ! ch_to_dir
)
1204 chdir (getenv ("HOME"));
1205 if (skip_args
< argc
)
1207 if (!strncmp (argv
[skip_args
], "-psn", 4))
1210 if (! ch_to_dir
) chdir (getenv ("HOME"));
1212 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1215 if (! ch_to_dir
) chdir (getenv ("HOME"));
1220 #endif /* HAVE_NS */
1222 #ifdef HAVE_X_WINDOWS
1223 /* Stupid kludge to catch command-line display spec. We can't
1224 handle this argument entirely in window system dependent code
1225 because we don't even know which window system dependent code
1226 to run until we've recognized this argument. */
1228 char *displayname
= 0;
1229 int count_before
= skip_args
;
1231 /* Skip any number of -d options, but only use the last one. */
1234 int count_before_this
= skip_args
;
1236 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1238 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1243 count_before
= count_before_this
;
1246 /* If we have the form --display=NAME,
1247 convert it into -d name.
1248 This requires inserting a new element into argv. */
1249 if (displayname
&& count_before
< skip_args
)
1251 if (skip_args
== count_before
+ 1)
1253 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1254 (argc
- (count_before
+ 2)) * sizeof *argv
);
1255 argv
[count_before
+ 2] = displayname
;
1258 argv
[count_before
+ 1] = (char *) "-d";
1263 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1264 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1268 /* Don't actually discard this arg. */
1269 skip_args
= count_before
;
1271 #else /* !HAVE_X_WINDOWS */
1274 int count_before
= skip_args
;
1276 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1277 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1280 skip_args
= count_before
;
1284 /* argmatch must not be used after here,
1285 except when building temacs
1286 because the -d argument has not been skipped in skip_args. */
1289 /* Call early 'cause init_environment needs it. */
1291 /* Set defaults for several environment variables. */
1293 init_environment (argc
, argv
, skip_args
);
1299 globals_of_kqueue ();
1302 #ifdef HAVE_GFILENOTIFY
1303 globals_of_gfilenotify ();
1308 #ifdef HAVE_W32NOTIFY
1309 globals_of_w32notify ();
1311 /* Initialize environment from registry settings. */
1312 init_environment (argv
);
1313 init_ntproc (dumping
); /* must precede init_editfns. */
1316 /* Initialize and GC-protect Vinitial_environment and
1317 Vprocess_environment before set_initial_environment fills them
1320 syms_of_callproc ();
1321 /* egetenv is a pretty low-level facility, which may get called in
1322 many circumstances; it seems flimsy to put off initializing it
1323 until calling init_callproc. Do not do it when dumping. */
1325 set_initial_environment ();
1327 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1328 if this is not done. Do it after set_global_environment so that we
1329 don't pollute Vglobal_environment. */
1330 /* Setting LANG here will defeat the startup locale processing... */
1335 /* Init buffer storage and default directory of main buffer. */
1336 init_buffer (initialized
);
1338 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1340 /* Must precede init_lread. */
1341 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1345 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1346 Lisp_Object old_log_max
;
1347 old_log_max
= Vmessage_log_max
;
1348 XSETFASTINT (Vmessage_log_max
, 0);
1349 message_dolog ("", 0, 1, 0);
1350 Vmessage_log_max
= old_log_max
;
1353 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1357 /* Check to see if Emacs has been installed correctly. */
1358 check_windows_init_file ();
1361 /* Intern the names of all standard functions and variables;
1362 define standard keys. */
1366 /* The basic levels of Lisp must come first. Note that
1367 syms_of_data and some others have already been called. */
1372 syms_of_floatfns ();
1375 syms_of_bytecode ();
1377 syms_of_casefiddle ();
1379 syms_of_category ();
1381 syms_of_character ();
1388 syms_of_filelock ();
1391 /* syms_of_keymap (); */
1399 syms_of_terminal ();
1410 syms_of_textprop ();
1411 syms_of_composite ();
1414 #endif /* WINDOWSNT */
1421 #ifdef HAVE_WINDOW_SYSTEM
1424 #endif /* HAVE_WINDOW_SYSTEM */
1425 #ifdef HAVE_X_WINDOWS
1431 syms_of_xsettings ();
1438 #endif /* HAVE_X_WINDOWS */
1445 syms_of_decompress ();
1455 #endif /* HAVE_NTGUI */
1457 #if defined WINDOWSNT || defined HAVE_NTGUI
1458 syms_of_w32select ();
1465 syms_of_win16select ();
1472 syms_of_nsselect ();
1474 #endif /* HAVE_NS */
1480 #endif /* HAVE_INOTIFY */
1484 #endif /* HAVE_KQUEUE */
1486 #ifdef HAVE_GFILENOTIFY
1487 syms_of_gfilenotify ();
1488 #endif /* HAVE_GFILENOTIFY */
1491 syms_of_dbusbind ();
1492 #endif /* HAVE_DBUS */
1496 #ifdef HAVE_W32NOTIFY
1497 syms_of_w32notify ();
1498 #endif /* HAVE_W32NOTIFY */
1499 #endif /* WINDOWSNT */
1501 syms_of_profiler ();
1503 keys_of_casefiddle ();
1506 keys_of_keyboard ();
1512 /* Initialization that must be done even if the global variable
1513 initialized is non zero. */
1515 globals_of_w32font ();
1516 globals_of_w32fns ();
1517 globals_of_w32menu ();
1518 #endif /* HAVE_NTGUI */
1520 #if defined WINDOWSNT || defined HAVE_NTGUI
1521 globals_of_w32select ();
1527 /* This calls putenv and so must precede init_process_emacs. Also,
1528 it sets Voperating_system_release, which init_process_emacs uses. */
1529 init_editfns (dumping
);
1531 /* These two call putenv. */
1539 /* This can create a thread that may call getenv, so it must follow
1540 all calls to putenv and setenv. Also, this sets up
1541 add_keyboard_wait_descriptor, which init_display uses. */
1542 init_process_emacs ();
1544 init_keyboard (); /* This too must precede init_sys_modes. */
1545 if (!noninteractive
)
1546 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1549 init_crit (); /* w32notify.c needs this in batch mode. */
1550 #endif /* HAVE_W32NOTIFY */
1552 #ifdef HAVE_WINDOW_SYSTEM
1554 #endif /* HAVE_WINDOW_SYSTEM */
1562 /* Handle -l loadup, args passed by Makefile. */
1563 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1566 char file_utf8
[MAX_UTF8_PATH
];
1568 if (filename_from_ansi (file
, file_utf8
) == 0)
1571 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1573 /* Unless next switch is -nl, load "loadup.el" first thing. */
1575 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1578 /* Set up for profiling. This is known to work on FreeBSD,
1579 GNU/Linux and MinGW. It might work on some other systems too.
1580 Give it a try and tell us if it works on your system. To compile
1581 for profiling, use the configure option --enable-profiling. */
1582 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1587 extern unsigned char etext
asm ("etext");
1593 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1602 /* Enter editor command loop. This never returns. */
1608 /* Sort the args so we can find the most important ones
1609 at the beginning of argv. */
1611 /* First, here's a table of all the standard options. */
1613 struct standard_args
1616 const char *longname
;
1621 static const struct standard_args standard_args
[] =
1623 { "-version", "--version", 150, 0 },
1624 { "-chdir", "--chdir", 130, 1 },
1625 { "-t", "--terminal", 120, 1 },
1626 { "-nw", "--no-window-system", 110, 0 },
1627 { "-nw", "--no-windows", 110, 0 },
1628 { "-batch", "--batch", 100, 0 },
1629 { "-script", "--script", 100, 1 },
1630 { "-daemon", "--daemon", 99, 0 },
1631 { "-help", "--help", 90, 0 },
1632 { "-nl", "--no-loadup", 70, 0 },
1633 { "-nsl", "--no-site-lisp", 65, 0 },
1634 /* -d must come last before the options handled in startup.el. */
1635 { "-d", "--display", 60, 1 },
1636 { "-display", 0, 60, 1 },
1637 /* Now for the options handled in `command-line' (startup.el). */
1638 /* (Note that to imply -nsl, -Q is partially handled here.) */
1639 { "-Q", "--quick", 55, 0 },
1640 { "-quick", 0, 55, 0 },
1641 { "-q", "--no-init-file", 50, 0 },
1642 { "-no-init-file", 0, 50, 0 },
1643 { "-no-x-resources", "--no-x-resources", 40, 0 },
1644 { "-no-site-file", "--no-site-file", 40, 0 },
1645 { "-u", "--user", 30, 1 },
1646 { "-user", 0, 30, 1 },
1647 { "-debug-init", "--debug-init", 20, 0 },
1648 { "-iconic", "--iconic", 15, 0 },
1649 { "-D", "--basic-display", 12, 0},
1650 { "-basic-display", 0, 12, 0},
1651 { "-nbc", "--no-blinking-cursor", 12, 0 },
1652 /* Now for the options handled in `command-line-1' (startup.el). */
1653 { "-nbi", "--no-bitmap-icon", 10, 0 },
1654 { "-bg", "--background-color", 10, 1 },
1655 { "-background", 0, 10, 1 },
1656 { "-fg", "--foreground-color", 10, 1 },
1657 { "-foreground", 0, 10, 1 },
1658 { "-bd", "--border-color", 10, 1 },
1659 { "-bw", "--border-width", 10, 1 },
1660 { "-ib", "--internal-border", 10, 1 },
1661 { "-ms", "--mouse-color", 10, 1 },
1662 { "-cr", "--cursor-color", 10, 1 },
1663 { "-fn", "--font", 10, 1 },
1664 { "-font", 0, 10, 1 },
1665 { "-fs", "--fullscreen", 10, 0 },
1666 { "-fw", "--fullwidth", 10, 0 },
1667 { "-fh", "--fullheight", 10, 0 },
1668 { "-mm", "--maximized", 10, 0 },
1669 { "-g", "--geometry", 10, 1 },
1670 { "-geometry", 0, 10, 1 },
1671 { "-T", "--title", 10, 1 },
1672 { "-title", 0, 10, 1 },
1673 { "-name", "--name", 10, 1 },
1674 { "-xrm", "--xrm", 10, 1 },
1675 { "-parent-id", "--parent-id", 10, 1 },
1676 { "-r", "--reverse-video", 5, 0 },
1678 { "-reverse", 0, 5, 0 },
1679 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1680 { "-vb", "--vertical-scroll-bars", 5, 0 },
1681 { "-color", "--color", 5, 0},
1682 { "-no-splash", "--no-splash", 3, 0 },
1683 { "-no-desktop", "--no-desktop", 3, 0 },
1685 { "-NSAutoLaunch", 0, 5, 1 },
1686 { "-NXAutoLaunch", 0, 5, 1 },
1687 { "-_NSMachLaunch", 0, 85, 1 },
1688 { "-MachLaunch", 0, 85, 1 },
1689 { "-macosx", 0, 85, 0 },
1690 { "-NSHost", 0, 85, 1 },
1692 /* These have the same priority as ordinary file name args,
1693 so they are not reordered with respect to those. */
1694 { "-L", "--directory", 0, 1 },
1695 { "-directory", 0, 0, 1 },
1696 { "-l", "--load", 0, 1 },
1697 { "-load", 0, 0, 1 },
1698 /* This has no longname, because using --scriptload confuses sort_args,
1699 because then the --script long option seems to match twice; ie
1700 you can't have a long option which is a prefix of another long
1701 option. In any case, this is entirely an internal option. */
1702 { "-scriptload", NULL
, 0, 1 },
1703 { "-f", "--funcall", 0, 1 },
1704 { "-funcall", 0, 0, 1 },
1705 { "-eval", "--eval", 0, 1 },
1706 { "-execute", "--execute", 0, 1 },
1707 { "-find-file", "--find-file", 0, 1 },
1708 { "-visit", "--visit", 0, 1 },
1709 { "-file", "--file", 0, 1 },
1710 { "-insert", "--insert", 0, 1 },
1712 { "-NXOpen", 0, 0, 1 },
1713 { "-NXOpenTemp", 0, 0, 1 },
1714 { "-NSOpen", 0, 0, 1 },
1715 { "-NSOpenTemp", 0, 0, 1 },
1716 { "-GSFilePath", 0, 0, 1 },
1718 /* This should be processed after ordinary file name args and the like. */
1719 { "-kill", "--kill", -10, 0 },
1722 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1723 so that the highest priority ones come first.
1724 Do not change the order of elements of equal priority.
1725 If an option takes an argument, keep it and its argument together.
1727 If an option that takes no argument appears more
1728 than once, eliminate all but one copy of it. */
1731 sort_args (int argc
, char **argv
)
1733 char **new = xmalloc (argc
* sizeof *new);
1734 /* For each element of argv,
1735 the corresponding element of options is:
1736 0 for an option that takes no arguments,
1737 1 for an option that takes one argument, etc.
1738 -1 for an ordinary non-option argument. */
1739 int *options
= xnmalloc (argc
, sizeof *options
);
1740 int *priority
= xnmalloc (argc
, sizeof *priority
);
1742 int incoming_used
= 1;
1746 /* Categorize all the options,
1747 and figure out which argv elts are option arguments. */
1748 for (from
= 1; from
< argc
; from
++)
1752 if (argv
[from
][0] == '-')
1756 /* If we have found "--", don't consider
1757 any more arguments as options. */
1758 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1760 /* Leave the "--", and everything following it, at the end. */
1761 for (; from
< argc
; from
++)
1763 priority
[from
] = -100;
1769 /* Look for a match with a known old-fashioned option. */
1770 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1771 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1773 options
[from
] = standard_args
[i
].nargs
;
1774 priority
[from
] = standard_args
[i
].priority
;
1775 if (from
+ standard_args
[i
].nargs
>= argc
)
1776 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1777 from
+= standard_args
[i
].nargs
;
1781 /* Look for a match with a known long option.
1782 MATCH is -1 if no match so far, -2 if two or more matches so far,
1783 >= 0 (the table index of the match) if just one match so far. */
1784 if (argv
[from
][1] == '-')
1786 char const *equals
= strchr (argv
[from
], '=');
1788 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1792 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1793 if (standard_args
[i
].longname
1794 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1803 /* If we found exactly one match, use that. */
1806 options
[from
] = standard_args
[match
].nargs
;
1807 priority
[from
] = standard_args
[match
].priority
;
1808 /* If --OPTION=VALUE syntax is used,
1809 this option uses just one argv element. */
1812 if (from
+ options
[from
] >= argc
)
1813 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1814 from
+= options
[from
];
1816 /* FIXME When match < 0, shouldn't there be some error,
1817 or at least indication to the user that there was a
1824 /* Copy the arguments, in order of decreasing priority, to NEW. */
1826 while (incoming_used
< argc
)
1829 int best_priority
= -9999;
1831 /* Find the highest priority remaining option.
1832 If several have equal priority, take the first of them. */
1833 for (from
= 1; from
< argc
; from
++)
1835 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1837 best_priority
= priority
[from
];
1840 /* Skip option arguments--they are tied to the options. */
1841 if (options
[from
] > 0)
1842 from
+= options
[from
];
1848 /* Copy the highest priority remaining option, with its args, to NEW.
1849 Unless it is a duplicate of the previous one. */
1850 if (! (options
[best
] == 0
1851 && ! strcmp (new[to
- 1], argv
[best
])))
1853 new[to
++] = argv
[best
];
1854 for (i
= 0; i
< options
[best
]; i
++)
1855 new[to
++] = argv
[best
+ i
+ 1];
1858 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1860 /* Clear out this option in ARGV. */
1862 for (i
= 0; i
< options
[best
]; i
++)
1863 argv
[best
+ i
+ 1] = 0;
1866 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1870 memcpy (argv
, new, sizeof (char *) * argc
);
1877 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1878 doc
: /* Exit the Emacs job and kill it.
1879 If ARG is an integer, return ARG as the exit program code.
1880 If ARG is a string, stuff it as keyboard input.
1882 This function is called upon receipt of the signals SIGTERM
1883 or SIGHUP, and upon SIGINT in batch mode.
1885 The value of `kill-emacs-hook', if not void,
1886 is a list of functions (of no args),
1887 all of which are called before Emacs is actually killed. */
1888 attributes
: noreturn
)
1893 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1895 waiting_for_input
= 0;
1896 run_hook (Qkill_emacs_hook
);
1898 #ifdef HAVE_X_WINDOWS
1899 /* Transfer any clipboards we own to the clipboard manager. */
1900 x_clipboard_manager_save_all ();
1903 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
1906 ns_release_autorelease_pool (ns_pool
);
1909 /* If we have an auto-save list file,
1910 kill it because we are exiting Emacs deliberately (not crashing).
1911 Do it after shut_down_emacs, which does an auto-save. */
1912 if (STRINGP (Vauto_save_list_file_name
))
1914 Lisp_Object listfile
;
1915 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1916 unlink (SSDATA (listfile
));
1920 exit_code
= (XINT (arg
) < 0
1921 ? XINT (arg
) | INT_MIN
1922 : XINT (arg
) & INT_MAX
);
1924 exit_code
= EXIT_SUCCESS
;
1929 /* Perform an orderly shutdown of Emacs. Autosave any modified
1930 buffers, kill any child processes, clean up the terminal modes (if
1931 we're in the foreground), and other stuff like that. Don't perform
1932 any redisplay; this may be called when Emacs is shutting down in
1933 the background, or after its X connection has died.
1935 If SIG is a signal number, print a message for it.
1937 This is called by fatal signal handlers, X protocol error handlers,
1941 shut_down_emacs (int sig
, Lisp_Object stuff
)
1943 /* Prevent running of hooks from now on. */
1946 /* Don't update display from now on. */
1947 Vinhibit_redisplay
= Qt
;
1949 /* If we are controlling the terminal, reset terminal modes. */
1952 pid_t pgrp
= getpgrp ();
1953 pid_t tpgrp
= tcgetpgrp (0);
1954 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1956 reset_all_sys_modes ();
1957 if (sig
&& sig
!= SIGTERM
)
1959 static char const format
[] = "Fatal error %d: ";
1960 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1961 int buflen
= sprintf (buf
, format
, sig
);
1962 char const *sig_desc
= safe_strsignal (sig
);
1963 emacs_write (STDERR_FILENO
, buf
, buflen
);
1964 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1970 reset_all_sys_modes ();
1973 stuff_buffered_input (stuff
);
1975 inhibit_sentinels
= 1;
1976 kill_buffer_processes (Qnil
);
1977 Fdo_auto_save (Qt
, Qnil
);
1979 unlock_all_files ();
1981 /* There is a tendency for a SIGIO signal to arrive within exit,
1982 and cause a SIGHUP because the input descriptor is already closed. */
1985 /* Do this only if terminating normally, we want glyph matrices
1986 etc. in a core dump. */
1987 if (sig
== 0 || sig
== SIGTERM
)
1989 check_glyph_memory ();
1990 check_message_stack ();
1998 ns_term_shutdown (sig
);
2002 xml_cleanup_parser ();
2016 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2017 doc
: /* Dump current state of Emacs into executable file FILENAME.
2018 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2019 This is used in the file `loadup.el' when building Emacs.
2021 You must run Emacs in batch mode in order to dump it. */)
2022 (Lisp_Object filename
, Lisp_Object symfile
)
2026 ptrdiff_t count
= SPECPDL_INDEX ();
2030 if (! noninteractive
)
2031 error ("Dumping Emacs works only in batch mode");
2034 error ("Emacs can be dumped only once");
2038 /* Warn if the gap between BSS end and heap start is larger than this. */
2039 # define MAX_HEAP_BSS_DIFF (1024*1024)
2041 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2043 fprintf (stderr
, "**************************************************\n");
2044 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2045 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2047 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2048 fprintf (stderr
, "fail because of this. See the section about\n");
2049 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2050 fprintf (stderr
, "**************************************************\n");
2052 #endif /* GNU_LINUX */
2054 /* Bind `command-line-processed' to nil before dumping,
2055 so that the dumped Emacs will process its command line
2056 and set up to work with X windows if appropriate. */
2057 symbol
= intern ("command-line-processed");
2058 specbind (symbol
, Qnil
);
2060 CHECK_STRING (filename
);
2061 filename
= Fexpand_file_name (filename
, Qnil
);
2062 filename
= ENCODE_FILE (filename
);
2063 if (!NILP (symfile
))
2065 CHECK_STRING (symfile
);
2066 if (SCHARS (symfile
))
2068 symfile
= Fexpand_file_name (symfile
, Qnil
);
2069 symfile
= ENCODE_FILE (symfile
);
2074 Vpurify_flag
= Qnil
;
2077 /* Tell malloc where start of impure now is. */
2078 /* Also arrange for warnings when nearly out of space. */
2079 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2081 /* On Windows, this was done before dumping, and that once suffices.
2082 Meanwhile, my_edata is not valid on Windows. */
2083 memory_warnings (my_edata
, malloc_warning
);
2084 #endif /* not WINDOWSNT */
2085 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2087 alloc_unexec_pre ();
2089 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2091 alloc_unexec_post ();
2094 Vlibrary_cache
= Qnil
;
2096 #ifdef HAVE_WINDOW_SYSTEM
2097 reset_image_types ();
2102 return unbind_to (count
, Qnil
);
2105 #endif /* not CANNOT_DUMP */
2108 /* Recover from setlocale (LC_ALL, ""). */
2112 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2113 so that numbers are read and printed properly for Emacs Lisp. */
2114 setlocale (LC_NUMERIC
, "C");
2117 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2120 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2122 if (! EQ (*plocale
, desired_locale
))
2124 *plocale
= desired_locale
;
2126 /* Changing categories like LC_TIME usually requires specifying
2127 an encoding suitable for the new locale, but MS-Windows's
2128 'setlocale' will only switch the encoding when LC_ALL is
2129 specified. So we ignore CATEGORY, use LC_ALL instead, and
2130 then restore LC_NUMERIC to "C", so reading and printing
2131 numbers is unaffected. */
2132 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2133 ? SSDATA (desired_locale
)
2136 #else /* !WINDOWSNT */
2137 setlocale (category
, (STRINGP (desired_locale
)
2138 ? SSDATA (desired_locale
)
2140 #endif /* !WINDOWSNT */
2144 /* Set system time locale to match Vsystem_time_locale, if possible. */
2146 synchronize_system_time_locale (void)
2148 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2149 Vsystem_time_locale
);
2152 /* Set system messages locale to match Vsystem_messages_locale, if
2155 synchronize_system_messages_locale (void)
2158 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2159 Vsystem_messages_locale
);
2162 #endif /* HAVE_SETLOCALE */
2166 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2168 const char *path
, *p
;
2169 Lisp_Object lpath
, element
, tem
;
2170 /* Default is to use "." for empty path elements.
2171 But if argument EMPTY is true, use nil instead. */
2172 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2175 static const char *emacs_dir_env
= "%emacs_dir%/";
2176 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2177 const char *edir
= egetenv ("emacs_dir");
2178 char emacs_dir
[MAX_UTF8_PATH
];
2180 /* egetenv looks in process-environment, which holds the variables
2181 in their original system-locale encoding. We need emacs_dir to
2184 filename_from_ansi (edir
, emacs_dir
);
2187 /* It's okay to use getenv here, because this function is only used
2188 to initialize variables when Emacs starts up, and isn't called
2191 path
= getenv (evarname
);
2202 /* Ensure values from the environment use the proper directory separator. */
2208 char *path_utf8
, *q
, *d
;
2211 /* Convert each element of PATH to UTF-8. */
2212 p
= path_copy
= alloca (strlen (path
) + 1);
2213 strcpy (path_copy
, path
);
2214 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2217 q
= _mbschr (p
, SEPCHAR
);
2220 cnv_result
= filename_from_ansi (p
, d
);
2225 /* If conversion of this PATH elements fails, make sure
2226 destination pointer will stay put, thus effectively
2227 ignoring the offending element. */
2228 if (cnv_result
== 0)
2234 else if (cnv_result
!= 0 && d
> path_utf8
)
2235 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2237 path_copy
= path_utf8
;
2239 path_copy
= alloca (strlen (path
) + 1);
2240 strcpy (path_copy
, path
);
2242 dostounix_filename (path_copy
);
2249 p
= strchr (path
, SEPCHAR
);
2251 p
= path
+ strlen (path
);
2252 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2254 if (! NILP (element
))
2257 /* Relative file names in the default path are interpreted as
2258 being relative to $emacs_dir. */
2259 if (edir
&& defaulted
2260 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2261 element
= Fexpand_file_name (Fsubstring
2263 make_number (emacs_dir_len
),
2265 build_unibyte_string (emacs_dir
));
2268 /* Add /: to the front of the name
2269 if it would otherwise be treated as magic. */
2270 tem
= Ffind_file_name_handler (element
, Qt
);
2272 /* However, if the handler says "I'm safe",
2273 don't bother adding /:. */
2277 prop
= Fget (tem
, intern ("safe-magic"));
2284 AUTO_STRING (slash_colon
, "/:");
2285 element
= concat2 (slash_colon
, element
);
2287 } /* !NILP (element) */
2289 lpath
= Fcons (element
, lpath
);
2295 return Fnreverse (lpath
);
2298 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2299 doc
: /* Return non-nil if the current emacs process is a daemon.
2300 If the daemon was given a name argument, return that name. */)
2305 return build_string (daemon_name
);
2312 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2313 doc
: /* Mark the Emacs daemon as being initialized.
2314 This finishes the daemonization process by doing the other half of detaching
2315 from the parent process and its tty file descriptors. */)
2321 error ("This function can only be called if emacs is run as a daemon");
2323 if (!DAEMON_RUNNING
)
2324 error ("The daemon has already been initialized");
2326 if (NILP (Vafter_init_time
))
2327 error ("This function can only be called after loading the init files");
2331 /* Get rid of stdin, stdout and stderr. */
2332 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2334 err
|= dup2 (nfd
, 0) < 0;
2335 err
|= dup2 (nfd
, 1) < 0;
2336 err
|= dup2 (nfd
, 2) < 0;
2337 err
|= emacs_close (nfd
) != 0;
2339 /* Closing the pipe will notify the parent that it can exit.
2340 FIXME: In case some other process inherited the pipe, closing it here
2341 won't notify the parent because it's still open elsewhere, so we
2342 additionally send a byte, just to make sure the parent really exits.
2343 Instead, we should probably close the pipe in start-process and
2344 call-process to make sure the pipe is never inherited by
2346 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2347 err
|= emacs_close (daemon_pipe
[1]) != 0;
2348 /* Set it to an invalid value so we know we've already run this function. */
2349 daemon_pipe
[1] = -1;
2350 #else /* WINDOWSNT */
2351 /* Signal the waiting emacsclient process. */
2352 err
|= SetEvent (w32_daemon_event
) == 0;
2353 err
|= CloseHandle (w32_daemon_event
) == 0;
2354 /* Set it to an invalid value so we know we've already run this function. */
2355 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2359 error ("I/O error during daemon initialization");
2364 syms_of_emacs (void)
2366 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2367 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2368 DEFSYM (Qkill_emacs
, "kill-emacs");
2369 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2372 defsubr (&Sdump_emacs
);
2375 defsubr (&Skill_emacs
);
2377 defsubr (&Sinvocation_name
);
2378 defsubr (&Sinvocation_directory
);
2379 defsubr (&Sdaemonp
);
2380 defsubr (&Sdaemon_initialized
);
2382 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2383 doc
: /* Args passed by shell to Emacs, as a list of strings.
2384 Many arguments are deleted from the list as they are processed. */);
2386 DEFVAR_LISP ("system-type", Vsystem_type
,
2387 doc
: /* The value is a symbol indicating the type of operating system you are using.
2389 `gnu' compiled for a GNU Hurd system.
2390 `gnu/linux' compiled for a GNU/Linux system.
2391 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2392 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2393 `ms-dos' compiled as an MS-DOS application.
2394 `windows-nt' compiled as a native W32 application.
2395 `cygwin' compiled using the Cygwin library.
2396 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2397 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2398 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2399 /* See configure.ac for the possible SYSTEM_TYPEs. */
2401 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2402 doc
: /* Value is string indicating configuration Emacs was built for. */);
2403 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2405 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2406 doc
: /* String containing the configuration options Emacs was built with. */);
2407 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2409 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2410 doc
: /* String listing some of the main features this Emacs was compiled with.
2411 An element of the form \"FOO\" generally means that HAVE_FOO was
2412 defined during the build.
2414 This is mainly intended for diagnostic purposes in bug reports.
2415 Don't rely on it for testing whether a feature you want to use is available. */);
2416 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2418 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2419 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2421 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2422 doc
: /* Hook run when `kill-emacs' is called.
2423 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2424 in other similar situations), functions placed on this hook should not
2425 expect to be able to interact with the user. To ask for confirmation,
2426 see `kill-emacs-query-functions' instead.
2428 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2429 `noninteractive' was non-nil. */);
2430 Vkill_emacs_hook
= Qnil
;
2432 DEFVAR_LISP ("path-separator", Vpath_separator
,
2433 doc
: /* String containing the character that separates directories in
2434 search paths, such as PATH and other similar environment variables. */);
2437 Vpath_separator
= make_string (&c
, 1);
2440 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2441 doc
: /* The program name that was used to run Emacs.
2442 Any directory names are omitted. */);
2444 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2445 doc
: /* The directory in which the Emacs executable was found, to run it.
2446 The value is nil if that directory's name is not known. */);
2448 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2449 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2450 In an installed Emacs, this is normally nil. It is non-nil if
2451 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2452 within the variable `invocation-directory' or its parent. For example,
2453 this is the case when running an uninstalled Emacs executable from its
2454 build directory. */);
2455 Vinstallation_directory
= Qnil
;
2457 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2458 doc
: /* System locale for messages. */);
2459 Vsystem_messages_locale
= Qnil
;
2461 DEFVAR_LISP ("previous-system-messages-locale",
2462 Vprevious_system_messages_locale
,
2463 doc
: /* Most recently used system locale for messages. */);
2464 Vprevious_system_messages_locale
= Qnil
;
2466 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2467 doc
: /* System locale for time. */);
2468 Vsystem_time_locale
= Qnil
;
2470 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2471 doc
: /* Most recently used system locale for time. */);
2472 Vprevious_system_time_locale
= Qnil
;
2474 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2475 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2476 Vbefore_init_time
= Qnil
;
2478 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2479 doc
: /* Value of `current-time' after loading the init files.
2480 This is nil during initialization. */);
2481 Vafter_init_time
= Qnil
;
2483 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2484 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2485 inhibit_x_resources
= 0;
2487 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2488 doc
: /* Short copyright string for this version of Emacs. */);
2489 Vemacs_copyright
= build_string (emacs_copyright
);
2491 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2492 doc
: /* Version numbers of this version of Emacs. */);
2493 Vemacs_version
= build_string (emacs_version
);
2495 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2496 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2497 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2499 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2500 doc
: /* Alist of dynamic libraries vs external files implementing them.
2501 Each element is a list (LIBRARY FILE...), where the car is a symbol
2502 representing a supported external library, and the rest are strings giving
2503 alternate filenames for that library.
2505 Emacs tries to load the library from the files in the order they appear on
2506 the list; if none is loaded, the running session of Emacs won't have access
2509 Note that image types `pbm' and `xbm' do not need entries in this variable
2510 because they do not depend on external libraries and are always available.
2512 Also note that this is not a generic facility for accessing external
2513 libraries; only those already known by Emacs will be loaded. */);
2514 Vdynamic_library_alist
= Qnil
;
2515 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2518 Vlibrary_cache
= Qnil
;
2519 staticpro (&Vlibrary_cache
);