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>
60 #ifdef HAVE_WINDOW_SYSTEM
62 #endif /* HAVE_WINDOW_SYSTEM */
65 #include "intervals.h"
66 #include "character.h"
71 #include "blockinput.h"
72 #include "syssignal.h"
75 #include "termhooks.h"
80 #include "composite.h"
81 #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. */
134 extern void unexec_init_emacs_zone (void);
137 extern void malloc_enable_thread (void);
139 /* If true, Emacs should not attempt to use a window-specific code,
140 but instead should use the virtual terminal under which it was started. */
141 bool inhibit_window_system
;
143 /* If true, a filter or a sentinel is running. Tested to save the match
144 data on the first attempt to change it inside asynchronous code. */
145 bool running_asynch_code
;
147 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
148 /* If true, -d was specified, meaning we're using some window system. */
152 /* An address near the bottom of the stack.
153 Tells GC how to save a copy of the stack. */
157 /* The gap between BSS end and heap start as far as we can tell. */
158 static uprintmax_t heap_bss_diff
;
161 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
164 On Cocoa, CoreFoundation lib fails in forked process:
165 http://developer.apple.com/ReleaseNotes/
166 CoreFoundation/CoreFoundation.html)
168 On Windows, a Cygwin fork child cannot access the USER subsystem.
170 We mark being in the exec'd process by a daemon name argument of
171 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
172 NAME is the original daemon name, if any. */
173 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
174 # define DAEMON_MUST_EXEC
177 /* True means running Emacs without interactive terminal. */
180 /* True means remove site-lisp directories from load-path. */
183 /* Name for the server started by the daemon.*/
184 static char *daemon_name
;
187 /* Pipe used to send exit notification to the daemon parent at
191 HANDLE w32_daemon_event
;
194 /* Save argv and argc. */
198 static void sort_args (int argc
, char **argv
);
199 static void syms_of_emacs (void);
201 /* C99 needs each string to be at most 4095 characters, and the usage
202 strings below are split to not overflow this limit. */
203 static char const *const usage_message
[] =
206 Run Emacs, the extensible, customizable, self-documenting real-time\n\
207 display editor. The recommended way to start Emacs for normal editing\n\
208 is with no options at all.\n\
210 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
211 read the main documentation for these command-line arguments.\n\
213 Initialization options:\n\
217 --batch do not do interactive display; implies -q\n\
218 --chdir DIR change to directory DIR\n\
219 --daemon start a server in the background\n\
220 --debug-init enable Emacs Lisp debugger for init file\n\
221 --display, -d DISPLAY use X server DISPLAY\n\
224 --no-desktop do not load a saved desktop\n\
225 --no-init-file, -q load neither ~/.emacs nor default.el\n\
226 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
227 --no-site-file do not load site-start.el\n\
228 --no-x-resources do not load X resources\n\
229 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
230 --no-splash do not display a splash screen on startup\n\
231 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
234 --quick, -Q equivalent to:\n\
235 -q --no-site-file --no-site-lisp --no-splash\n\
237 --script FILE run FILE as an Emacs Lisp script\n\
238 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
239 --user, -u USER load ~USER/.emacs instead of your own\n\
245 FILE visit FILE using find-file\n\
246 +LINE go to line LINE in next FILE\n\
247 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
248 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
249 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
250 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
253 --file FILE visit FILE using find-file\n\
254 --find-file FILE visit FILE using find-file\n\
255 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
256 --insert FILE insert contents of FILE into current buffer\n\
257 --kill exit without asking for confirmation\n\
258 --load, -l FILE load Emacs Lisp FILE using the load function\n\
259 --visit FILE visit FILE using find-file\n\
265 --background-color, -bg COLOR window background color\n\
266 --basic-display, -D disable many display features;\n\
267 used for debugging Emacs\n\
268 --border-color, -bd COLOR main border color\n\
269 --border-width, -bw WIDTH width of main border\n\
272 --color, --color=MODE override color mode for character terminals;\n\
273 MODE defaults to `auto', and\n\
274 can also be `never', `always',\n\
275 or a mode name like `ansi8'\n\
276 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
277 --font, -fn FONT default font; must be fixed-width\n\
278 --foreground-color, -fg COLOR window foreground color\n\
281 --fullheight, -fh make the first frame high as the screen\n\
282 --fullscreen, -fs make the first frame fullscreen\n\
283 --fullwidth, -fw make the first frame wide as the screen\n\
284 --maximized, -mm make the first frame maximized\n\
285 --geometry, -g GEOMETRY window geometry\n\
288 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
289 --iconic start Emacs in iconified state\n\
290 --internal-border, -ib WIDTH width between text and main border\n\
291 --line-spacing, -lsp PIXELS additional space to put between lines\n\
292 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
293 --name NAME title for initial Emacs frame\n\
296 --no-blinking-cursor, -nbc disable blinking cursor\n\
297 --reverse-video, -r, -rv switch foreground and background\n\
298 --title, -T TITLE title for initial Emacs frame\n\
299 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
300 --xrm XRESOURCES set additional X resources\n\
301 --parent-id XID set parent window\n\
302 --help display this help and exit\n\
303 --version output version information and exit\n\
307 You can generally also specify long option names with a single -; for\n\
308 example, -batch as well as --batch. You can use any unambiguous\n\
309 abbreviation for a --option.\n\
311 Various environment variables and window system resources also affect\n\
312 the operation of Emacs. See the main documentation.\n\
314 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
315 section of the Emacs manual or the file BUGS.\n"
319 /* True if handling a fatal error already. */
320 bool fatal_error_in_progress
;
323 /* NS autrelease pool, for memory management. */
324 static void *ns_pool
;
329 setlocale (int cat
, char const *locale
)
335 /* True if the current system locale uses UTF-8 encoding. */
341 mbstate_t mbs
= { 0 };
342 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
349 /* Report a fatal error due to signal SIG, output a backtrace of at
350 most BACKTRACE_LIMIT lines, and exit. */
352 terminate_due_to_signal (int sig
, int backtrace_limit
)
354 signal (sig
, SIG_DFL
);
356 /* If fatal error occurs in code below, avoid infinite recursion. */
357 if (! fatal_error_in_progress
)
359 fatal_error_in_progress
= 1;
361 totally_unblock_input ();
362 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
363 Fkill_emacs (make_number (sig
));
365 shut_down_emacs (sig
, Qnil
);
366 emacs_backtrace (backtrace_limit
);
369 /* Signal the same code; this time it will really be fatal.
370 Since we're in a signal handler, the signal is blocked, so we
371 have to unblock it if we want to really receive it. */
375 sigemptyset (&unblocked
);
376 sigaddset (&unblocked
, sig
);
377 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
383 /* This shouldn't be executed, but it prevents a warning. */
387 /* Code for dealing with Lisp access to the Unix command line. */
390 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
393 Lisp_Object name
, dir
, handler
;
394 ptrdiff_t count
= SPECPDL_INDEX ();
395 Lisp_Object raw_name
;
396 AUTO_STRING (slash_colon
, "/:");
402 /* Must use argv[0] converted to UTF-8, as it begets many standard
403 file and directory names. */
405 char argv0
[MAX_UTF8_PATH
];
407 if (filename_from_ansi (argv
[0], argv0
) == 0)
408 raw_name
= build_unibyte_string (argv0
);
410 raw_name
= build_unibyte_string (argv
[0]);
413 raw_name
= build_unibyte_string (argv
[0]);
416 /* Add /: to the front of the name
417 if it would otherwise be treated as magic. */
418 handler
= Ffind_file_name_handler (raw_name
, Qt
);
419 if (! NILP (handler
))
420 raw_name
= concat2 (slash_colon
, raw_name
);
422 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
423 Vinvocation_directory
= Ffile_name_directory (raw_name
);
425 /* If we got no directory in argv[0], search PATH to find where
426 Emacs actually came from. */
427 if (NILP (Vinvocation_directory
))
430 int yes
= openp (Vexec_path
, Vinvocation_name
,
431 Vexec_suffixes
, &found
, make_number (X_OK
), false);
434 /* Add /: to the front of the name
435 if it would otherwise be treated as magic. */
436 handler
= Ffind_file_name_handler (found
, Qt
);
437 if (! NILP (handler
))
438 found
= concat2 (slash_colon
, found
);
439 Vinvocation_directory
= Ffile_name_directory (found
);
443 if (!NILP (Vinvocation_directory
)
444 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
445 /* Emacs was started with relative path, like ./emacs.
449 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
451 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
454 Vinstallation_directory
= Qnil
;
456 if (!NILP (Vinvocation_directory
))
458 dir
= Vinvocation_directory
;
460 /* If we are running from the build directory, set DIR to the
461 src subdirectory of the Emacs tree, like on Posix
463 if (SBYTES (dir
) > sizeof ("/i386/") - 1
464 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
466 dir
= Fexpand_file_name (build_string ("../.."), dir
);
467 #else /* !WINDOWSNT */
469 name
= Fexpand_file_name (Vinvocation_name
, dir
);
472 Lisp_Object tem
, lib_src_exists
;
473 Lisp_Object etc_exists
, info_exists
;
475 /* See if dir contains subdirs for use by Emacs.
476 Check for the ones that would exist in a build directory,
477 not including lisp and info. */
478 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
479 lib_src_exists
= Ffile_exists_p (tem
);
482 /* MSDOS installations frequently remove lib-src, but we still
483 must set installation-directory, or else info won't find
484 its files (it uses the value of installation-directory). */
485 tem
= Fexpand_file_name (build_string ("info"), dir
);
486 info_exists
= Ffile_exists_p (tem
);
491 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
493 tem
= Fexpand_file_name (build_string ("etc"), dir
);
494 etc_exists
= Ffile_exists_p (tem
);
495 if (!NILP (etc_exists
))
497 Vinstallation_directory
498 = Ffile_name_as_directory (dir
);
503 /* See if dir's parent contains those subdirs. */
504 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
505 lib_src_exists
= Ffile_exists_p (tem
);
509 /* See the MSDOS commentary above. */
510 tem
= Fexpand_file_name (build_string ("../info"), dir
);
511 info_exists
= Ffile_exists_p (tem
);
516 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
518 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
519 etc_exists
= Ffile_exists_p (tem
);
520 if (!NILP (etc_exists
))
522 tem
= Fexpand_file_name (build_string (".."), dir
);
523 Vinstallation_directory
524 = Ffile_name_as_directory (tem
);
529 /* If the Emacs executable is actually a link,
530 next try the dir that the link points into. */
531 tem
= Ffile_symlink_p (name
);
534 name
= Fexpand_file_name (tem
, dir
);
535 dir
= Ffile_name_directory (name
);
542 Vcommand_line_args
= Qnil
;
544 for (i
= argc
- 1; i
>= 0; i
--)
546 if (i
== 0 || i
> skip_args
)
547 /* For the moment, we keep arguments as is in unibyte strings.
548 They are decoded in the function command-line after we know
549 locale-coding-system. */
551 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
554 unbind_to (count
, Qnil
);
557 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
558 doc
: /* Return the program name that was used to run Emacs.
559 Any directory names are omitted. */)
562 return Fcopy_sequence (Vinvocation_name
);
565 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
567 doc
: /* Return the directory name in which the Emacs executable was located. */)
570 return Fcopy_sequence (Vinvocation_directory
);
574 /* Test whether the next argument in ARGV matches SSTR or a prefix of
575 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
576 (the argument is supposed to have a value) store in *VALPTR either
577 the next argument or the portion of this one after the equal sign.
578 ARGV is read starting at position *SKIPPTR; this index is advanced
579 by the number of arguments used.
581 Too bad we can't just use getopt for all of this, but we don't have
582 enough information to do it right. */
585 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
586 int minlen
, char **valptr
, int *skipptr
)
592 /* Don't access argv[argc]; give up in advance. */
593 if (argc
<= *skipptr
+ 1)
596 arg
= argv
[*skipptr
+1];
599 if (strcmp (arg
, sstr
) == 0)
603 *valptr
= argv
[*skipptr
+2];
610 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
611 ? p
- arg
: strlen (arg
));
612 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
614 else if (valptr
== NULL
)
625 else if (argv
[*skipptr
+2] != NULL
)
627 *valptr
= argv
[*skipptr
+2];
637 /* Close standard output and standard error, reporting any write
638 errors as best we can. This is intended for use with atexit. */
640 close_output_streams (void)
642 if (close_stream (stdout
) != 0)
644 emacs_perror ("Write error to standard output");
645 _exit (EXIT_FAILURE
);
648 if (close_stream (stderr
) != 0)
649 _exit (EXIT_FAILURE
);
654 main (int argc
, char **argv
)
657 char stack_bottom_variable
;
658 bool do_initial_setlocale
;
661 #ifdef HAVE_SETRLIMIT
667 #ifdef DAEMON_MUST_EXEC
672 /* If we use --chdir, this records the original directory. */
673 char *original_pwd
= 0;
678 might_dump
= !initialized
;
684 char *heap_start
= my_heap_start ();
685 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
689 #if defined WINDOWSNT || defined HAVE_NTGUI
690 /* Set global variables used to detect Windows version. Do this as
691 early as possible. (unexw32.c calls this function as well, but
692 the additional call here is harmless.) */
693 cache_system_info ();
695 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
696 to have non-stub implementations of APIs we need to convert file
697 names between UTF-8 and the system's ANSI codepage. */
698 maybe_load_unicows_dll ();
700 /* This has to be done before module_init is called below, so that
701 the latter could use the thread ID of the main thread. */
702 w32_init_main_thread ();
705 #ifdef RUN_TIME_REMAP
707 run_time_remap (argv
[0]);
710 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
713 unexec_init_emacs_zone ();
716 atexit (close_output_streams
);
722 sort_args (argc
, argv
);
724 while (argv
[argc
]) argc
++;
726 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
728 const char *version
, *copyright
;
731 Lisp_Object tem
, tem2
;
732 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
733 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
736 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
741 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
746 version
= SSDATA (tem
);
747 copyright
= SSDATA (tem2
);
752 version
= emacs_version
;
753 copyright
= emacs_copyright
;
755 printf ("%s %s\n", PACKAGE_NAME
, version
);
756 printf ("%s\n", copyright
);
757 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
758 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
759 printf ("under the terms of the GNU General Public License.\n");
760 printf ("For more information about these matters, ");
761 printf ("see the file named COPYING.\n");
765 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
768 /* argv[] array is kept in its original ANSI codepage encoding,
769 we need to convert to UTF-8, for chdir to work. */
770 char newdir
[MAX_UTF8_PATH
];
772 filename_from_ansi (ch_to_dir
, newdir
);
775 original_pwd
= get_current_dir_name ();
776 if (chdir (ch_to_dir
) != 0)
778 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
779 argv
[0], ch_to_dir
, strerror (errno
));
784 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
785 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
787 #ifdef HAVE_PERSONALITY_LINUX32
788 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
790 /* Set this so we only do this once. */
791 xputenv ("EMACS_HEAP_EXEC=true");
793 /* A flag to turn off address randomization which is introduced
794 in linux kernel shipped with fedora core 4 */
795 #define ADD_NO_RANDOMIZE 0x0040000
796 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
797 #undef ADD_NO_RANDOMIZE
799 execvp (argv
[0], argv
);
801 /* If the exec fails, try to dump anyway. */
802 emacs_perror (argv
[0]);
804 #endif /* HAVE_PERSONALITY_LINUX32 */
806 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
807 /* Extend the stack space available. Don't do that if dumping,
808 since some systems (e.g. DJGPP) might define a smaller stack
809 limit at that time. And it's not needed on Cygwin, since emacs
810 is built with an 8MB stack. Moreover, the setrlimit call can
811 cause problems on Cygwin
812 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
815 && (!noninteractive
|| initialized
)
817 && !getrlimit (RLIMIT_STACK
, &rlim
))
820 /* Approximate the amount regex.c needs per unit of re_max_failures. */
821 int ratio
= 20 * sizeof (char *);
822 /* Then add 33% to cover the size of the smaller stacks that regex.c
823 successively allocates and discards, on its way to the maximum. */
825 /* Add in some extra to cover
826 what we're likely to use for other reasons. */
827 newlim
= re_max_failures
* ratio
+ 200000;
829 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
830 stack allocation routine for new process that the allocation
831 fails if stack limit is not on page boundary. So, round up the
832 new limit to page boundary. */
833 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
835 if (newlim
> rlim
.rlim_max
)
837 newlim
= rlim
.rlim_max
;
838 /* Don't let regex.c overflow the stack we have. */
839 re_max_failures
= (newlim
- 200000) / ratio
;
841 if (rlim
.rlim_cur
< newlim
)
842 rlim
.rlim_cur
= newlim
;
844 setrlimit (RLIMIT_STACK
, &rlim
);
846 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
848 /* Record (approximately) where the stack begins. */
849 stack_bottom
= &stack_bottom_variable
;
853 emacs_backtrace (-1);
855 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
856 /* Arrange to get warning messages as memory fills up. */
857 memory_warnings (0, malloc_warning
);
859 /* Call malloc at least once, to run malloc_initialize_hook.
860 Also call realloc and free for consistency. */
861 free (realloc (malloc (4), 4));
863 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
866 SET_BINARY (fileno (stdin
));
868 SET_BINARY (fileno (stdout
));
871 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
872 The build procedure uses this while dumping, to ensure that the
873 dumped Emacs does not have its system locale tables initialized,
874 as that might cause screwups when the dumped Emacs starts up. */
876 char *lc_all
= getenv ("LC_ALL");
877 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
880 /* Set locale now, so that initial error messages are localized properly.
881 fixup_locale must wait until later, since it builds strings. */
882 if (do_initial_setlocale
)
883 setlocale (LC_ALL
, "");
884 text_quoting_flag
= using_utf8 ();
886 inhibit_window_system
= 0;
888 /* Handle the -t switch, which specifies filename to use as terminal. */
892 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
897 result
= emacs_open (term
, O_RDWR
, 0);
898 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
900 char *errstring
= strerror (errno
);
901 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
906 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
909 fprintf (stderr
, "Using %s\n", term
);
910 #ifdef HAVE_WINDOW_SYSTEM
911 inhibit_window_system
= 1; /* -t => -nw */
918 /* Command line option --no-windows is deprecated and thus not mentioned
919 in the manual and usage information. */
920 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
921 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
922 inhibit_window_system
= 1;
924 /* Handle the -batch switch, which means don't do interactive display. */
926 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
929 Vundo_outer_limit
= Qnil
;
931 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
933 noninteractive
= 1; /* Set batch mode. */
934 /* Convert --script to -scriptload, un-skip it, and sort again
935 so that it will be handled in proper sequence. */
936 /* FIXME broken for --script=FILE - is that supposed to work? */
937 argv
[skip_args
- 1] = (char *) "-scriptload";
939 sort_args (argc
, argv
);
942 /* Handle the --help option, which gives a usage message. */
943 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
946 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
947 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
948 fputs (usage_message
[i
], stdout
);
953 /* Make sure IS_DAEMON starts up as false. */
956 w32_daemon_event
= NULL
;
959 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
960 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
965 /* Start as a daemon: fork a new child process which will run the
966 rest of the initialization code, then exit.
968 Detaching a daemon requires the following steps:
972 - close the tty file-descriptors
974 We only want to do the last 2 steps once the daemon is ready to
975 serve requests, i.e. after loading .emacs (initialization).
976 OTOH initialization may start subprocesses (e.g. ispell) and these
977 should be run from the proper process (the one that will end up
978 running as daemon) and with the proper "session id" in order for
979 them to keep working after detaching, so fork and setsid need to be
980 performed before initialization.
982 We want to avoid exiting before the server socket is ready, so
983 use a pipe for synchronization. The parent waits for the child
984 to close its end of the pipe (using `daemon-initialized')
986 if (emacs_pipe (daemon_pipe
) != 0)
988 fprintf (stderr
, "Cannot pipe!\n");
992 #ifndef DAEMON_MUST_EXEC
994 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
995 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
996 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
999 #else /* DAEMON_MUST_EXEC */
1000 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1001 f
= fork (); /* in orig */
1003 f
= 0; /* in exec'd */
1004 #endif /* !DAEMON_MUST_EXEC */
1010 /* Close unused writing end of the pipe. */
1011 emacs_close (daemon_pipe
[1]);
1013 /* Just wait for the child to close its end of the pipe. */
1016 retval
= read (daemon_pipe
[0], &buf
, 1);
1018 while (retval
== -1 && errno
== EINTR
);
1022 fprintf (stderr
, "Error reading status from child\n");
1025 else if (retval
== 0)
1027 fprintf (stderr
, "Error: server did not start correctly\n");
1031 emacs_close (daemon_pipe
[0]);
1036 emacs_perror ("fork");
1037 exit (EXIT_CANCELED
);
1040 #ifdef DAEMON_MUST_EXEC
1042 /* In orig process, forked as child, OR in exec'd. */
1043 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1044 { /* In orig, child: now exec w/special daemon name. */
1047 snprintf (fdStr
, sizeof fdStr
,
1048 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1049 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1051 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1053 fprintf (stderr
, "daemon: child name too long\n");
1054 exit (EXIT_CANNOT_INVOKE
);
1057 argv
[skip_args
] = fdStr
;
1059 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1060 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1061 execvp (argv
[0], argv
);
1062 emacs_perror (argv
[0]);
1063 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1066 /* In exec'd: parse special dname into pipe and name info. */
1067 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1068 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1070 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1071 exit (EXIT_CANNOT_INVOKE
);
1073 dname_arg2
[0] = '\0';
1074 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1076 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1077 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1079 #endif /* DAEMON_MUST_EXEC */
1081 /* Close unused reading end of the pipe. */
1082 emacs_close (daemon_pipe
[0]);
1085 #elif defined(WINDOWSNT)
1086 /* Indicate that we want daemon mode. */
1087 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1088 if (w32_daemon_event
== NULL
)
1090 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1095 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1099 daemon_name
= xstrdup (dname_arg
);
1102 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1103 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1104 # ifndef CANNOT_DUMP
1105 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1106 that causes an infinite recursive loop with FreeBSD. See
1107 Bug#14569. The part of this bug involving Cygwin is no longer
1108 relevant, now that Cygwin defines HYBRID_MALLOC. */
1109 if (!noninteractive
|| initialized
)
1111 malloc_enable_thread ();
1114 init_signals (dumping
);
1116 noninteractive1
= noninteractive
;
1118 /* Perform basic initializations (not merely interning symbols). */
1125 init_charset_once ();
1126 init_coding_once ();
1127 init_syntax_once (); /* Create standard syntax table. */
1128 init_category_once (); /* Create standard category table. */
1129 init_casetab_once (); /* Must be done before init_buffer_once. */
1130 init_buffer_once (); /* Create buffer table and some buffers. */
1131 init_minibuf_once (); /* Create list of minibuffers. */
1132 /* Must precede init_window_once. */
1134 /* Call syms_of_xfaces before init_window_once because that
1135 function creates Vterminal_frame. Termcap frames now use
1136 faces, and the face implementation uses some symbols as
1139 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1140 be better to arrange things not to have this dependency. */
1142 /* Call syms_of_keyboard before init_window_once because
1143 keyboard sets up symbols that include some face names that
1144 the X support will want to use. This can happen when
1145 CANNOT_DUMP is defined. */
1146 syms_of_keyboard ();
1148 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1150 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1152 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1154 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1156 /* Before syms_of_coding because it initializes Qcharsetp. */
1158 /* Before init_window_once, because it sets up the
1159 Vcoding_system_hash_table. */
1160 syms_of_coding (); /* This should be after syms_of_fileio. */
1162 init_window_once (); /* Init the window system. */
1163 #ifdef HAVE_WINDOW_SYSTEM
1164 init_fringe_once (); /* Swap bitmaps if necessary. */
1165 #endif /* HAVE_WINDOW_SYSTEM */
1170 if (do_initial_setlocale
)
1173 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1174 Vsystem_time_locale
= Vprevious_system_time_locale
;
1179 running_asynch_code
= 0;
1183 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1186 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1189 ns_pool
= ns_alloc_autorelease_pool ();
1190 #ifdef NS_IMPL_GNUSTEP
1191 /* GNUstep stupidly resets our locale settings after we made them. */
1195 if (!noninteractive
)
1197 #ifdef NS_IMPL_COCOA
1198 /* Started from GUI? */
1199 /* FIXME: Do the right thing if getenv returns NULL, or if
1201 if (! inhibit_window_system
&& ! isatty (0) && ! ch_to_dir
)
1202 chdir (getenv ("HOME"));
1203 if (skip_args
< argc
)
1205 if (!strncmp (argv
[skip_args
], "-psn", 4))
1208 if (! ch_to_dir
) chdir (getenv ("HOME"));
1210 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1213 if (! ch_to_dir
) chdir (getenv ("HOME"));
1218 #endif /* HAVE_NS */
1220 #ifdef HAVE_X_WINDOWS
1221 /* Stupid kludge to catch command-line display spec. We can't
1222 handle this argument entirely in window system dependent code
1223 because we don't even know which window system dependent code
1224 to run until we've recognized this argument. */
1226 char *displayname
= 0;
1227 int count_before
= skip_args
;
1229 /* Skip any number of -d options, but only use the last one. */
1232 int count_before_this
= skip_args
;
1234 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1236 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1241 count_before
= count_before_this
;
1244 /* If we have the form --display=NAME,
1245 convert it into -d name.
1246 This requires inserting a new element into argv. */
1247 if (displayname
&& count_before
< skip_args
)
1249 if (skip_args
== count_before
+ 1)
1251 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1252 (argc
- (count_before
+ 2)) * sizeof *argv
);
1253 argv
[count_before
+ 2] = displayname
;
1256 argv
[count_before
+ 1] = (char *) "-d";
1261 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1262 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1266 /* Don't actually discard this arg. */
1267 skip_args
= count_before
;
1269 #else /* !HAVE_X_WINDOWS */
1272 int count_before
= skip_args
;
1274 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1275 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1278 skip_args
= count_before
;
1282 /* argmatch must not be used after here,
1283 except when building temacs
1284 because the -d argument has not been skipped in skip_args. */
1287 /* Call early 'cause init_environment needs it. */
1289 /* Set defaults for several environment variables. */
1291 init_environment (argc
, argv
, skip_args
);
1297 globals_of_kqueue ();
1300 #ifdef HAVE_GFILENOTIFY
1301 globals_of_gfilenotify ();
1306 #ifdef HAVE_W32NOTIFY
1307 globals_of_w32notify ();
1309 /* Initialize environment from registry settings. */
1310 init_environment (argv
);
1311 init_ntproc (dumping
); /* must precede init_editfns. */
1315 /* Initialize the locale from user defaults. */
1319 /* Initialize and GC-protect Vinitial_environment and
1320 Vprocess_environment before set_initial_environment fills them
1323 syms_of_callproc ();
1324 /* egetenv is a pretty low-level facility, which may get called in
1325 many circumstances; it seems flimsy to put off initializing it
1326 until calling init_callproc. Do not do it when dumping. */
1328 set_initial_environment ();
1330 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1331 if this is not done. Do it after set_global_environment so that we
1332 don't pollute Vglobal_environment. */
1333 /* Setting LANG here will defeat the startup locale processing... */
1338 /* Init buffer storage and default directory of main buffer. */
1339 init_buffer (initialized
);
1341 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1343 /* Must precede init_lread. */
1344 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1348 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1349 Lisp_Object old_log_max
;
1350 old_log_max
= Vmessage_log_max
;
1351 XSETFASTINT (Vmessage_log_max
, 0);
1352 message_dolog ("", 0, 1, 0);
1353 Vmessage_log_max
= old_log_max
;
1356 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1360 /* Check to see if Emacs has been installed correctly. */
1361 check_windows_init_file ();
1364 /* Intern the names of all standard functions and variables;
1365 define standard keys. */
1369 /* The basic levels of Lisp must come first. Note that
1370 syms_of_data and some others have already been called. */
1375 syms_of_floatfns ();
1378 syms_of_bytecode ();
1380 syms_of_casefiddle ();
1382 syms_of_category ();
1384 syms_of_character ();
1391 syms_of_filelock ();
1394 /* syms_of_keymap (); */
1402 syms_of_terminal ();
1413 syms_of_textprop ();
1414 syms_of_composite ();
1417 #endif /* WINDOWSNT */
1424 #ifdef HAVE_WINDOW_SYSTEM
1427 #endif /* HAVE_WINDOW_SYSTEM */
1428 #ifdef HAVE_X_WINDOWS
1434 syms_of_xsettings ();
1441 #endif /* HAVE_X_WINDOWS */
1448 syms_of_decompress ();
1458 #endif /* HAVE_NTGUI */
1460 #if defined WINDOWSNT || defined HAVE_NTGUI
1461 syms_of_w32select ();
1468 syms_of_win16select ();
1475 syms_of_nsselect ();
1477 #endif /* HAVE_NS */
1483 #endif /* HAVE_INOTIFY */
1487 #endif /* HAVE_KQUEUE */
1489 #ifdef HAVE_GFILENOTIFY
1490 syms_of_gfilenotify ();
1491 #endif /* HAVE_GFILENOTIFY */
1494 syms_of_dbusbind ();
1495 #endif /* HAVE_DBUS */
1499 #ifdef HAVE_W32NOTIFY
1500 syms_of_w32notify ();
1501 #endif /* HAVE_W32NOTIFY */
1502 #endif /* WINDOWSNT */
1504 syms_of_profiler ();
1506 keys_of_casefiddle ();
1509 keys_of_keyboard ();
1515 /* Initialization that must be done even if the global variable
1516 initialized is non zero. */
1518 globals_of_w32font ();
1519 globals_of_w32fns ();
1520 globals_of_w32menu ();
1521 #endif /* HAVE_NTGUI */
1523 #if defined WINDOWSNT || defined HAVE_NTGUI
1524 globals_of_w32select ();
1530 /* This calls putenv and so must precede init_process_emacs. Also,
1531 it sets Voperating_system_release, which init_process_emacs uses. */
1532 init_editfns (dumping
);
1534 /* These two call putenv. */
1542 /* This can create a thread that may call getenv, so it must follow
1543 all calls to putenv and setenv. Also, this sets up
1544 add_keyboard_wait_descriptor, which init_display uses. */
1545 init_process_emacs ();
1547 init_keyboard (); /* This too must precede init_sys_modes. */
1548 if (!noninteractive
)
1549 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1552 init_crit (); /* w32notify.c needs this in batch mode. */
1553 #endif /* HAVE_W32NOTIFY */
1555 #ifdef HAVE_WINDOW_SYSTEM
1557 #endif /* HAVE_WINDOW_SYSTEM */
1565 /* Handle -l loadup, args passed by Makefile. */
1566 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1569 char file_utf8
[MAX_UTF8_PATH
];
1571 if (filename_from_ansi (file
, file_utf8
) == 0)
1574 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1576 /* Unless next switch is -nl, load "loadup.el" first thing. */
1578 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1581 /* Set up for profiling. This is known to work on FreeBSD,
1582 GNU/Linux and MinGW. It might work on some other systems too.
1583 Give it a try and tell us if it works on your system. To compile
1584 for profiling, use the configure option --enable-profiling. */
1585 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1590 extern unsigned char etext
asm ("etext");
1596 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1605 /* Enter editor command loop. This never returns. */
1611 /* Sort the args so we can find the most important ones
1612 at the beginning of argv. */
1614 /* First, here's a table of all the standard options. */
1616 struct standard_args
1619 const char *longname
;
1624 static const struct standard_args standard_args
[] =
1626 { "-version", "--version", 150, 0 },
1627 { "-chdir", "--chdir", 130, 1 },
1628 { "-t", "--terminal", 120, 1 },
1629 { "-nw", "--no-window-system", 110, 0 },
1630 { "-nw", "--no-windows", 110, 0 },
1631 { "-batch", "--batch", 100, 0 },
1632 { "-script", "--script", 100, 1 },
1633 { "-daemon", "--daemon", 99, 0 },
1634 { "-help", "--help", 90, 0 },
1635 { "-nl", "--no-loadup", 70, 0 },
1636 { "-nsl", "--no-site-lisp", 65, 0 },
1637 /* -d must come last before the options handled in startup.el. */
1638 { "-d", "--display", 60, 1 },
1639 { "-display", 0, 60, 1 },
1640 /* Now for the options handled in `command-line' (startup.el). */
1641 /* (Note that to imply -nsl, -Q is partially handled here.) */
1642 { "-Q", "--quick", 55, 0 },
1643 { "-quick", 0, 55, 0 },
1644 { "-q", "--no-init-file", 50, 0 },
1645 { "-no-init-file", 0, 50, 0 },
1646 { "-no-x-resources", "--no-x-resources", 40, 0 },
1647 { "-no-site-file", "--no-site-file", 40, 0 },
1648 { "-u", "--user", 30, 1 },
1649 { "-user", 0, 30, 1 },
1650 { "-debug-init", "--debug-init", 20, 0 },
1651 { "-iconic", "--iconic", 15, 0 },
1652 { "-D", "--basic-display", 12, 0},
1653 { "-basic-display", 0, 12, 0},
1654 { "-nbc", "--no-blinking-cursor", 12, 0 },
1655 /* Now for the options handled in `command-line-1' (startup.el). */
1656 { "-nbi", "--no-bitmap-icon", 10, 0 },
1657 { "-bg", "--background-color", 10, 1 },
1658 { "-background", 0, 10, 1 },
1659 { "-fg", "--foreground-color", 10, 1 },
1660 { "-foreground", 0, 10, 1 },
1661 { "-bd", "--border-color", 10, 1 },
1662 { "-bw", "--border-width", 10, 1 },
1663 { "-ib", "--internal-border", 10, 1 },
1664 { "-ms", "--mouse-color", 10, 1 },
1665 { "-cr", "--cursor-color", 10, 1 },
1666 { "-fn", "--font", 10, 1 },
1667 { "-font", 0, 10, 1 },
1668 { "-fs", "--fullscreen", 10, 0 },
1669 { "-fw", "--fullwidth", 10, 0 },
1670 { "-fh", "--fullheight", 10, 0 },
1671 { "-mm", "--maximized", 10, 0 },
1672 { "-g", "--geometry", 10, 1 },
1673 { "-geometry", 0, 10, 1 },
1674 { "-T", "--title", 10, 1 },
1675 { "-title", 0, 10, 1 },
1676 { "-name", "--name", 10, 1 },
1677 { "-xrm", "--xrm", 10, 1 },
1678 { "-parent-id", "--parent-id", 10, 1 },
1679 { "-r", "--reverse-video", 5, 0 },
1681 { "-reverse", 0, 5, 0 },
1682 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1683 { "-vb", "--vertical-scroll-bars", 5, 0 },
1684 { "-color", "--color", 5, 0},
1685 { "-no-splash", "--no-splash", 3, 0 },
1686 { "-no-desktop", "--no-desktop", 3, 0 },
1688 { "-NSAutoLaunch", 0, 5, 1 },
1689 { "-NXAutoLaunch", 0, 5, 1 },
1690 { "-_NSMachLaunch", 0, 85, 1 },
1691 { "-MachLaunch", 0, 85, 1 },
1692 { "-macosx", 0, 85, 0 },
1693 { "-NSHost", 0, 85, 1 },
1695 /* These have the same priority as ordinary file name args,
1696 so they are not reordered with respect to those. */
1697 { "-L", "--directory", 0, 1 },
1698 { "-directory", 0, 0, 1 },
1699 { "-l", "--load", 0, 1 },
1700 { "-load", 0, 0, 1 },
1701 /* This has no longname, because using --scriptload confuses sort_args,
1702 because then the --script long option seems to match twice; ie
1703 you can't have a long option which is a prefix of another long
1704 option. In any case, this is entirely an internal option. */
1705 { "-scriptload", NULL
, 0, 1 },
1706 { "-f", "--funcall", 0, 1 },
1707 { "-funcall", 0, 0, 1 },
1708 { "-eval", "--eval", 0, 1 },
1709 { "-execute", "--execute", 0, 1 },
1710 { "-find-file", "--find-file", 0, 1 },
1711 { "-visit", "--visit", 0, 1 },
1712 { "-file", "--file", 0, 1 },
1713 { "-insert", "--insert", 0, 1 },
1715 { "-NXOpen", 0, 0, 1 },
1716 { "-NXOpenTemp", 0, 0, 1 },
1717 { "-NSOpen", 0, 0, 1 },
1718 { "-NSOpenTemp", 0, 0, 1 },
1719 { "-GSFilePath", 0, 0, 1 },
1721 /* This should be processed after ordinary file name args and the like. */
1722 { "-kill", "--kill", -10, 0 },
1725 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1726 so that the highest priority ones come first.
1727 Do not change the order of elements of equal priority.
1728 If an option takes an argument, keep it and its argument together.
1730 If an option that takes no argument appears more
1731 than once, eliminate all but one copy of it. */
1734 sort_args (int argc
, char **argv
)
1736 char **new = xmalloc (argc
* sizeof *new);
1737 /* For each element of argv,
1738 the corresponding element of options is:
1739 0 for an option that takes no arguments,
1740 1 for an option that takes one argument, etc.
1741 -1 for an ordinary non-option argument. */
1742 int *options
= xnmalloc (argc
, sizeof *options
);
1743 int *priority
= xnmalloc (argc
, sizeof *priority
);
1745 int incoming_used
= 1;
1749 /* Categorize all the options,
1750 and figure out which argv elts are option arguments. */
1751 for (from
= 1; from
< argc
; from
++)
1755 if (argv
[from
][0] == '-')
1759 /* If we have found "--", don't consider
1760 any more arguments as options. */
1761 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1763 /* Leave the "--", and everything following it, at the end. */
1764 for (; from
< argc
; from
++)
1766 priority
[from
] = -100;
1772 /* Look for a match with a known old-fashioned option. */
1773 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1774 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1776 options
[from
] = standard_args
[i
].nargs
;
1777 priority
[from
] = standard_args
[i
].priority
;
1778 if (from
+ standard_args
[i
].nargs
>= argc
)
1779 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1780 from
+= standard_args
[i
].nargs
;
1784 /* Look for a match with a known long option.
1785 MATCH is -1 if no match so far, -2 if two or more matches so far,
1786 >= 0 (the table index of the match) if just one match so far. */
1787 if (argv
[from
][1] == '-')
1789 char const *equals
= strchr (argv
[from
], '=');
1791 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1795 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1796 if (standard_args
[i
].longname
1797 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1806 /* If we found exactly one match, use that. */
1809 options
[from
] = standard_args
[match
].nargs
;
1810 priority
[from
] = standard_args
[match
].priority
;
1811 /* If --OPTION=VALUE syntax is used,
1812 this option uses just one argv element. */
1815 if (from
+ options
[from
] >= argc
)
1816 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1817 from
+= options
[from
];
1819 /* FIXME When match < 0, shouldn't there be some error,
1820 or at least indication to the user that there was a
1827 /* Copy the arguments, in order of decreasing priority, to NEW. */
1829 while (incoming_used
< argc
)
1832 int best_priority
= -9999;
1834 /* Find the highest priority remaining option.
1835 If several have equal priority, take the first of them. */
1836 for (from
= 1; from
< argc
; from
++)
1838 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1840 best_priority
= priority
[from
];
1843 /* Skip option arguments--they are tied to the options. */
1844 if (options
[from
] > 0)
1845 from
+= options
[from
];
1851 /* Copy the highest priority remaining option, with its args, to NEW.
1852 Unless it is a duplicate of the previous one. */
1853 if (! (options
[best
] == 0
1854 && ! strcmp (new[to
- 1], argv
[best
])))
1856 new[to
++] = argv
[best
];
1857 for (i
= 0; i
< options
[best
]; i
++)
1858 new[to
++] = argv
[best
+ i
+ 1];
1861 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1863 /* Clear out this option in ARGV. */
1865 for (i
= 0; i
< options
[best
]; i
++)
1866 argv
[best
+ i
+ 1] = 0;
1869 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1873 memcpy (argv
, new, sizeof (char *) * argc
);
1880 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1881 doc
: /* Exit the Emacs job and kill it.
1882 If ARG is an integer, return ARG as the exit program code.
1883 If ARG is a string, stuff it as keyboard input.
1885 This function is called upon receipt of the signals SIGTERM
1886 or SIGHUP, and upon SIGINT in batch mode.
1888 The value of `kill-emacs-hook', if not void,
1889 is a list of functions (of no args),
1890 all of which are called before Emacs is actually killed. */
1891 attributes
: noreturn
)
1896 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1898 waiting_for_input
= 0;
1899 run_hook (Qkill_emacs_hook
);
1901 #ifdef HAVE_X_WINDOWS
1902 /* Transfer any clipboards we own to the clipboard manager. */
1903 x_clipboard_manager_save_all ();
1906 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
1909 ns_release_autorelease_pool (ns_pool
);
1912 /* If we have an auto-save list file,
1913 kill it because we are exiting Emacs deliberately (not crashing).
1914 Do it after shut_down_emacs, which does an auto-save. */
1915 if (STRINGP (Vauto_save_list_file_name
))
1917 Lisp_Object listfile
;
1918 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1919 unlink (SSDATA (listfile
));
1923 exit_code
= (XINT (arg
) < 0
1924 ? XINT (arg
) | INT_MIN
1925 : XINT (arg
) & INT_MAX
);
1927 exit_code
= EXIT_SUCCESS
;
1932 /* Perform an orderly shutdown of Emacs. Autosave any modified
1933 buffers, kill any child processes, clean up the terminal modes (if
1934 we're in the foreground), and other stuff like that. Don't perform
1935 any redisplay; this may be called when Emacs is shutting down in
1936 the background, or after its X connection has died.
1938 If SIG is a signal number, print a message for it.
1940 This is called by fatal signal handlers, X protocol error handlers,
1944 shut_down_emacs (int sig
, Lisp_Object stuff
)
1946 /* Prevent running of hooks from now on. */
1949 /* Don't update display from now on. */
1950 Vinhibit_redisplay
= Qt
;
1952 /* If we are controlling the terminal, reset terminal modes. */
1955 pid_t pgrp
= getpgrp ();
1956 pid_t tpgrp
= tcgetpgrp (0);
1957 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1959 reset_all_sys_modes ();
1960 if (sig
&& sig
!= SIGTERM
)
1962 static char const format
[] = "Fatal error %d: ";
1963 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1964 int buflen
= sprintf (buf
, format
, sig
);
1965 char const *sig_desc
= safe_strsignal (sig
);
1966 emacs_write (STDERR_FILENO
, buf
, buflen
);
1967 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1973 reset_all_sys_modes ();
1976 stuff_buffered_input (stuff
);
1978 inhibit_sentinels
= 1;
1979 kill_buffer_processes (Qnil
);
1980 Fdo_auto_save (Qt
, Qnil
);
1982 unlock_all_files ();
1984 /* There is a tendency for a SIGIO signal to arrive within exit,
1985 and cause a SIGHUP because the input descriptor is already closed. */
1988 /* Do this only if terminating normally, we want glyph matrices
1989 etc. in a core dump. */
1990 if (sig
== 0 || sig
== SIGTERM
)
1992 check_glyph_memory ();
1993 check_message_stack ();
2001 ns_term_shutdown (sig
);
2005 xml_cleanup_parser ();
2019 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2020 doc
: /* Dump current state of Emacs into executable file FILENAME.
2021 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2022 This is used in the file `loadup.el' when building Emacs.
2024 You must run Emacs in batch mode in order to dump it. */)
2025 (Lisp_Object filename
, Lisp_Object symfile
)
2029 ptrdiff_t count
= SPECPDL_INDEX ();
2033 if (! noninteractive
)
2034 error ("Dumping Emacs works only in batch mode");
2037 error ("Emacs can be dumped only once");
2041 /* Warn if the gap between BSS end and heap start is larger than this. */
2042 # define MAX_HEAP_BSS_DIFF (1024*1024)
2044 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2046 fprintf (stderr
, "**************************************************\n");
2047 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2048 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2050 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2051 fprintf (stderr
, "fail because of this. See the section about\n");
2052 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2053 fprintf (stderr
, "**************************************************\n");
2055 #endif /* GNU_LINUX */
2057 /* Bind `command-line-processed' to nil before dumping,
2058 so that the dumped Emacs will process its command line
2059 and set up to work with X windows if appropriate. */
2060 symbol
= intern ("command-line-processed");
2061 specbind (symbol
, Qnil
);
2063 CHECK_STRING (filename
);
2064 filename
= Fexpand_file_name (filename
, Qnil
);
2065 filename
= ENCODE_FILE (filename
);
2066 if (!NILP (symfile
))
2068 CHECK_STRING (symfile
);
2069 if (SCHARS (symfile
))
2071 symfile
= Fexpand_file_name (symfile
, Qnil
);
2072 symfile
= ENCODE_FILE (symfile
);
2077 Vpurify_flag
= Qnil
;
2080 /* Tell malloc where start of impure now is. */
2081 /* Also arrange for warnings when nearly out of space. */
2082 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2084 /* On Windows, this was done before dumping, and that once suffices.
2085 Meanwhile, my_edata is not valid on Windows. */
2086 memory_warnings (my_edata
, malloc_warning
);
2087 #endif /* not WINDOWSNT */
2088 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2090 alloc_unexec_pre ();
2092 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2094 alloc_unexec_post ();
2097 Vlibrary_cache
= Qnil
;
2099 #ifdef HAVE_WINDOW_SYSTEM
2100 reset_image_types ();
2105 return unbind_to (count
, Qnil
);
2108 #endif /* not CANNOT_DUMP */
2111 /* Recover from setlocale (LC_ALL, ""). */
2115 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2116 so that numbers are read and printed properly for Emacs Lisp. */
2117 setlocale (LC_NUMERIC
, "C");
2120 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2123 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2125 if (! EQ (*plocale
, desired_locale
))
2127 *plocale
= desired_locale
;
2129 /* Changing categories like LC_TIME usually requires specifying
2130 an encoding suitable for the new locale, but MS-Windows's
2131 'setlocale' will only switch the encoding when LC_ALL is
2132 specified. So we ignore CATEGORY, use LC_ALL instead, and
2133 then restore LC_NUMERIC to "C", so reading and printing
2134 numbers is unaffected. */
2135 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2136 ? SSDATA (desired_locale
)
2139 #else /* !WINDOWSNT */
2140 setlocale (category
, (STRINGP (desired_locale
)
2141 ? SSDATA (desired_locale
)
2143 #endif /* !WINDOWSNT */
2147 /* Set system time locale to match Vsystem_time_locale, if possible. */
2149 synchronize_system_time_locale (void)
2151 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2152 Vsystem_time_locale
);
2155 /* Set system messages locale to match Vsystem_messages_locale, if
2158 synchronize_system_messages_locale (void)
2161 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2162 Vsystem_messages_locale
);
2165 #endif /* HAVE_SETLOCALE */
2169 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2171 const char *path
, *p
;
2172 Lisp_Object lpath
, element
, tem
;
2173 /* Default is to use "." for empty path elements.
2174 But if argument EMPTY is true, use nil instead. */
2175 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2178 static const char *emacs_dir_env
= "%emacs_dir%/";
2179 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2180 const char *edir
= egetenv ("emacs_dir");
2181 char emacs_dir
[MAX_UTF8_PATH
];
2183 /* egetenv looks in process-environment, which holds the variables
2184 in their original system-locale encoding. We need emacs_dir to
2187 filename_from_ansi (edir
, emacs_dir
);
2190 /* It's okay to use getenv here, because this function is only used
2191 to initialize variables when Emacs starts up, and isn't called
2194 path
= getenv (evarname
);
2205 /* Ensure values from the environment use the proper directory separator. */
2211 char *path_utf8
, *q
, *d
;
2214 /* Convert each element of PATH to UTF-8. */
2215 p
= path_copy
= alloca (strlen (path
) + 1);
2216 strcpy (path_copy
, path
);
2217 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2220 q
= _mbschr (p
, SEPCHAR
);
2223 cnv_result
= filename_from_ansi (p
, d
);
2228 /* If conversion of this PATH elements fails, make sure
2229 destination pointer will stay put, thus effectively
2230 ignoring the offending element. */
2231 if (cnv_result
== 0)
2237 else if (cnv_result
!= 0 && d
> path_utf8
)
2238 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2240 path_copy
= path_utf8
;
2242 path_copy
= alloca (strlen (path
) + 1);
2243 strcpy (path_copy
, path
);
2245 dostounix_filename (path_copy
);
2252 p
= strchr (path
, SEPCHAR
);
2254 p
= path
+ strlen (path
);
2255 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2257 if (! NILP (element
))
2260 /* Relative file names in the default path are interpreted as
2261 being relative to $emacs_dir. */
2262 if (edir
&& defaulted
2263 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2264 element
= Fexpand_file_name (Fsubstring
2266 make_number (emacs_dir_len
),
2268 build_unibyte_string (emacs_dir
));
2271 /* Add /: to the front of the name
2272 if it would otherwise be treated as magic. */
2273 tem
= Ffind_file_name_handler (element
, Qt
);
2275 /* However, if the handler says "I'm safe",
2276 don't bother adding /:. */
2280 prop
= Fget (tem
, intern ("safe-magic"));
2287 AUTO_STRING (slash_colon
, "/:");
2288 element
= concat2 (slash_colon
, element
);
2290 } /* !NILP (element) */
2292 lpath
= Fcons (element
, lpath
);
2298 return Fnreverse (lpath
);
2301 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2302 doc
: /* Return non-nil if the current emacs process is a daemon.
2303 If the daemon was given a name argument, return that name. */)
2308 return build_string (daemon_name
);
2315 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2316 doc
: /* Mark the Emacs daemon as being initialized.
2317 This finishes the daemonization process by doing the other half of detaching
2318 from the parent process and its tty file descriptors. */)
2324 error ("This function can only be called if emacs is run as a daemon");
2326 if (!DAEMON_RUNNING
)
2327 error ("The daemon has already been initialized");
2329 if (NILP (Vafter_init_time
))
2330 error ("This function can only be called after loading the init files");
2334 /* Get rid of stdin, stdout and stderr. */
2335 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2337 err
|= dup2 (nfd
, 0) < 0;
2338 err
|= dup2 (nfd
, 1) < 0;
2339 err
|= dup2 (nfd
, 2) < 0;
2340 err
|= emacs_close (nfd
) != 0;
2342 /* Closing the pipe will notify the parent that it can exit.
2343 FIXME: In case some other process inherited the pipe, closing it here
2344 won't notify the parent because it's still open elsewhere, so we
2345 additionally send a byte, just to make sure the parent really exits.
2346 Instead, we should probably close the pipe in start-process and
2347 call-process to make sure the pipe is never inherited by
2349 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2350 err
|= emacs_close (daemon_pipe
[1]) != 0;
2351 /* Set it to an invalid value so we know we've already run this function. */
2352 daemon_pipe
[1] = -1;
2353 #else /* WINDOWSNT */
2354 /* Signal the waiting emacsclient process. */
2355 err
|= SetEvent (w32_daemon_event
) == 0;
2356 err
|= CloseHandle (w32_daemon_event
) == 0;
2357 /* Set it to an invalid value so we know we've already run this function. */
2358 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2362 error ("I/O error during daemon initialization");
2367 syms_of_emacs (void)
2369 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2370 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2371 DEFSYM (Qkill_emacs
, "kill-emacs");
2372 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2375 defsubr (&Sdump_emacs
);
2378 defsubr (&Skill_emacs
);
2380 defsubr (&Sinvocation_name
);
2381 defsubr (&Sinvocation_directory
);
2382 defsubr (&Sdaemonp
);
2383 defsubr (&Sdaemon_initialized
);
2385 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2386 doc
: /* Args passed by shell to Emacs, as a list of strings.
2387 Many arguments are deleted from the list as they are processed. */);
2389 DEFVAR_LISP ("system-type", Vsystem_type
,
2390 doc
: /* The value is a symbol indicating the type of operating system you are using.
2392 `gnu' compiled for a GNU Hurd system.
2393 `gnu/linux' compiled for a GNU/Linux system.
2394 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2395 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2396 `ms-dos' compiled as an MS-DOS application.
2397 `windows-nt' compiled as a native W32 application.
2398 `cygwin' compiled using the Cygwin library.
2399 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2400 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2401 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2402 /* See configure.ac for the possible SYSTEM_TYPEs. */
2404 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2405 doc
: /* Value is string indicating configuration Emacs was built for. */);
2406 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2408 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2409 doc
: /* String containing the configuration options Emacs was built with. */);
2410 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2412 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2413 doc
: /* String listing some of the main features this Emacs was compiled with.
2414 An element of the form \"FOO\" generally means that HAVE_FOO was
2415 defined during the build.
2417 This is mainly intended for diagnostic purposes in bug reports.
2418 Don't rely on it for testing whether a feature you want to use is available. */);
2419 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2421 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2422 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2424 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2425 doc
: /* Hook run when `kill-emacs' is called.
2426 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2427 in other similar situations), functions placed on this hook should not
2428 expect to be able to interact with the user. To ask for confirmation,
2429 see `kill-emacs-query-functions' instead.
2431 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2432 `noninteractive' was non-nil. */);
2433 Vkill_emacs_hook
= Qnil
;
2435 DEFVAR_LISP ("path-separator", Vpath_separator
,
2436 doc
: /* String containing the character that separates directories in
2437 search paths, such as PATH and other similar environment variables. */);
2440 Vpath_separator
= make_string (&c
, 1);
2443 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2444 doc
: /* The program name that was used to run Emacs.
2445 Any directory names are omitted. */);
2447 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2448 doc
: /* The directory in which the Emacs executable was found, to run it.
2449 The value is nil if that directory's name is not known. */);
2451 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2452 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2453 In an installed Emacs, this is normally nil. It is non-nil if
2454 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2455 within the variable `invocation-directory' or its parent. For example,
2456 this is the case when running an uninstalled Emacs executable from its
2457 build directory. */);
2458 Vinstallation_directory
= Qnil
;
2460 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2461 doc
: /* System locale for messages. */);
2462 Vsystem_messages_locale
= Qnil
;
2464 DEFVAR_LISP ("previous-system-messages-locale",
2465 Vprevious_system_messages_locale
,
2466 doc
: /* Most recently used system locale for messages. */);
2467 Vprevious_system_messages_locale
= Qnil
;
2469 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2470 doc
: /* System locale for time. */);
2471 Vsystem_time_locale
= Qnil
;
2473 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2474 doc
: /* Most recently used system locale for time. */);
2475 Vprevious_system_time_locale
= Qnil
;
2477 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2478 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2479 Vbefore_init_time
= Qnil
;
2481 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2482 doc
: /* Value of `current-time' after loading the init files.
2483 This is nil during initialization. */);
2484 Vafter_init_time
= Qnil
;
2486 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2487 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2488 inhibit_x_resources
= 0;
2490 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2491 doc
: /* Short copyright string for this version of Emacs. */);
2492 Vemacs_copyright
= build_string (emacs_copyright
);
2494 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2495 doc
: /* Version numbers of this version of Emacs. */);
2496 Vemacs_version
= build_string (emacs_version
);
2498 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2499 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2500 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2502 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2503 doc
: /* Alist of dynamic libraries vs external files implementing them.
2504 Each element is a list (LIBRARY FILE...), where the car is a symbol
2505 representing a supported external library, and the rest are strings giving
2506 alternate filenames for that library.
2508 Emacs tries to load the library from the files in the order they appear on
2509 the list; if none is loaded, the running session of Emacs won't have access
2512 Note that image types `pbm' and `xbm' do not need entries in this variable
2513 because they do not depend on external libraries and are always available.
2515 Also note that this is not a generic facility for accessing external
2516 libraries; only those already known by Emacs will be loaded. */);
2517 Vdynamic_library_alist
= Qnil
;
2518 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2521 Vlibrary_cache
= Qnil
;
2522 staticpro (&Vlibrary_cache
);