1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2015 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
27 #include <sys/types.h>
31 #include <close-stream.h>
38 #include <sys/socket.h>
44 #if defined WINDOWSNT || defined HAVE_NTGUI
45 #include "w32select.h"
47 #include "w32common.h"
55 #include <binary-io.h>
58 #ifdef HAVE_WINDOW_SYSTEM
60 #endif /* HAVE_WINDOW_SYSTEM */
62 #ifdef NS_IMPL_GNUSTEP
63 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
64 #include <GNUstepBase/GSConfig.h>
68 #include "intervals.h"
69 #include "character.h"
75 #include "blockinput.h"
76 #include "syssignal.h"
79 #include "termhooks.h"
84 #include "composite.h"
85 #include "dispextern.h"
88 #include "sysselect.h"
93 #if (defined PROFILING \
94 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
95 # include <sys/gmon.h>
96 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 #ifdef DOUG_LEA_MALLOC
137 /* Preserves a pointer to the memory allocated that copies that
138 static data inside glibc's malloc. */
139 static void *malloc_state_ptr
;
140 /* From glibc, a routine that returns a copy of the malloc internal state. */
141 extern void *malloc_get_state (void);
142 /* From glibc, a routine that overwrites the malloc internal state. */
143 extern int malloc_set_state (void *);
144 /* True if the MALLOC_CHECK_ environment variable was set while
145 dumping. Used to work around a bug in glibc's malloc. */
146 static bool malloc_using_checking
;
147 #elif defined HAVE_PTHREAD && !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
148 extern void malloc_enable_thread (void);
151 /* If true, Emacs should not attempt to use a window-specific code,
152 but instead should use the virtual terminal under which it was started. */
153 bool inhibit_window_system
;
155 /* If true, a filter or a sentinel is running. Tested to save the match
156 data on the first attempt to change it inside asynchronous code. */
157 bool running_asynch_code
;
159 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
160 /* If true, -d was specified, meaning we're using some window system. */
164 /* An address near the bottom of the stack.
165 Tells GC how to save a copy of the stack. */
168 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
169 /* The address where the heap starts (from the first sbrk (0) call). */
170 static void *my_heap_start
;
174 /* The gap between BSS end and heap start as far as we can tell. */
175 static uprintmax_t heap_bss_diff
;
178 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
181 On Cocoa, CoreFoundation lib fails in forked process:
182 http://developer.apple.com/ReleaseNotes/
183 CoreFoundation/CoreFoundation.html)
185 On Windows, a Cygwin fork child cannot access the USER subsystem.
187 We mark being in the exec'd process by a daemon name argument of
188 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
189 NAME is the original daemon name, if any. */
190 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
191 # define DAEMON_MUST_EXEC
194 /* True means running Emacs without interactive terminal. */
197 /* True means remove site-lisp directories from load-path. */
200 /* Name for the server started by the daemon.*/
201 static char *daemon_name
;
203 /* Pipe used to send exit notification to the daemon parent at
207 /* Save argv and argc. */
211 static void sort_args (int argc
, char **argv
);
212 static void syms_of_emacs (void);
214 /* C99 needs each string to be at most 4095 characters, and the usage
215 strings below are split to not overflow this limit. */
216 static char const *const usage_message
[] =
219 Run Emacs, the extensible, customizable, self-documenting real-time\n\
220 display editor. The recommended way to start Emacs for normal editing\n\
221 is with no options at all.\n\
223 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
224 read the main documentation for these command-line arguments.\n\
226 Initialization options:\n\
230 --batch do not do interactive display; implies -q\n\
231 --chdir DIR change to directory DIR\n\
232 --daemon start a server in the background\n\
233 --debug-init enable Emacs Lisp debugger for init file\n\
234 --display, -d DISPLAY use X server DISPLAY\n\
237 --no-desktop do not load a saved desktop\n\
238 --no-init-file, -q load neither ~/.emacs nor default.el\n\
239 --no-shared-memory, -nl do not use shared memory\n\
240 --no-site-file do not load site-start.el\n\
241 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
242 --no-splash do not display a splash screen on startup\n\
243 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
246 --quick, -Q equivalent to:\n\
247 -q --no-site-file --no-site-lisp --no-splash\n\
248 --script FILE run FILE as an Emacs Lisp script\n\
249 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
250 --user, -u USER load ~USER/.emacs instead of your own\n\
256 FILE visit FILE using find-file\n\
257 +LINE go to line LINE in next FILE\n\
258 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
259 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
260 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
261 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
264 --file FILE visit FILE using find-file\n\
265 --find-file FILE visit FILE using find-file\n\
266 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
267 --insert FILE insert contents of FILE into current buffer\n\
268 --kill exit without asking for confirmation\n\
269 --load, -l FILE load Emacs Lisp FILE using the load function\n\
270 --visit FILE visit FILE using find-file\n\
276 --background-color, -bg COLOR window background color\n\
277 --basic-display, -D disable many display features;\n\
278 used for debugging Emacs\n\
279 --border-color, -bd COLOR main border color\n\
280 --border-width, -bw WIDTH width of main border\n\
283 --color, --color=MODE override color mode for character terminals;\n\
284 MODE defaults to `auto', and\n\
285 can also be `never', `always',\n\
286 or a mode name like `ansi8'\n\
287 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
288 --font, -fn FONT default font; must be fixed-width\n\
289 --foreground-color, -fg COLOR window foreground color\n\
292 --fullheight, -fh make the first frame high as the screen\n\
293 --fullscreen, -fs make the first frame fullscreen\n\
294 --fullwidth, -fw make the first frame wide as the screen\n\
295 --maximized, -mm make the first frame maximized\n\
296 --geometry, -g GEOMETRY window geometry\n\
299 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
300 --iconic start Emacs in iconified state\n\
301 --internal-border, -ib WIDTH width between text and main border\n\
302 --line-spacing, -lsp PIXELS additional space to put between lines\n\
303 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
304 --name NAME title for initial Emacs frame\n\
307 --no-blinking-cursor, -nbc disable blinking cursor\n\
308 --reverse-video, -r, -rv switch foreground and background\n\
309 --title, -T TITLE title for initial Emacs frame\n\
310 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
311 --xrm XRESOURCES set additional X resources\n\
312 --parent-id XID set parent window\n\
313 --help display this help and exit\n\
314 --version output version information and exit\n\
318 You can generally also specify long option names with a single -; for\n\
319 example, -batch as well as --batch. You can use any unambiguous\n\
320 abbreviation for a --option.\n\
322 Various environment variables and window system resources also affect\n\
323 the operation of Emacs. See the main documentation.\n\
325 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
326 section of the Emacs manual or the file BUGS.\n"
330 /* True if handling a fatal error already. */
331 bool fatal_error_in_progress
;
334 /* NS autrelease pool, for memory management. */
335 static void *ns_pool
;
340 setlocale (int cat
, char const *locale
)
347 /* Report a fatal error due to signal SIG, output a backtrace of at
348 most BACKTRACE_LIMIT lines, and exit. */
350 terminate_due_to_signal (int sig
, int backtrace_limit
)
352 signal (sig
, SIG_DFL
);
353 totally_unblock_input ();
355 /* If fatal error occurs in code below, avoid infinite recursion. */
356 if (! fatal_error_in_progress
)
358 fatal_error_in_progress
= 1;
360 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
361 Fkill_emacs (make_number (sig
));
363 shut_down_emacs (sig
, Qnil
);
364 emacs_backtrace (backtrace_limit
);
367 /* Signal the same code; this time it will really be fatal.
368 Since we're in a signal handler, the signal is blocked, so we
369 have to unblock it if we want to really receive it. */
373 sigemptyset (&unblocked
);
374 sigaddset (&unblocked
, sig
);
375 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
381 /* This shouldn't be executed, but it prevents a warning. */
385 /* Code for dealing with Lisp access to the Unix command line. */
388 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
391 Lisp_Object name
, dir
, handler
;
392 ptrdiff_t count
= SPECPDL_INDEX ();
393 Lisp_Object raw_name
;
394 AUTO_STRING (slash_colon
, "/:");
400 /* Must use argv[0] converted to UTF-8, as it begets many standard
401 file and directory names. */
403 char argv0
[MAX_UTF8_PATH
];
405 if (filename_from_ansi (argv
[0], argv0
) == 0)
406 raw_name
= build_unibyte_string (argv0
);
408 raw_name
= build_unibyte_string (argv
[0]);
411 raw_name
= build_unibyte_string (argv
[0]);
414 /* Add /: to the front of the name
415 if it would otherwise be treated as magic. */
416 handler
= Ffind_file_name_handler (raw_name
, Qt
);
417 if (! NILP (handler
))
418 raw_name
= concat2 (slash_colon
, raw_name
);
420 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
421 Vinvocation_directory
= Ffile_name_directory (raw_name
);
423 /* If we got no directory in argv[0], search PATH to find where
424 Emacs actually came from. */
425 if (NILP (Vinvocation_directory
))
428 int yes
= openp (Vexec_path
, Vinvocation_name
,
429 Vexec_suffixes
, &found
, make_number (X_OK
), false);
432 /* Add /: to the front of the name
433 if it would otherwise be treated as magic. */
434 handler
= Ffind_file_name_handler (found
, Qt
);
435 if (! NILP (handler
))
436 found
= concat2 (slash_colon
, found
);
437 Vinvocation_directory
= Ffile_name_directory (found
);
441 if (!NILP (Vinvocation_directory
)
442 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
443 /* Emacs was started with relative path, like ./emacs.
447 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
449 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
452 Vinstallation_directory
= Qnil
;
454 if (!NILP (Vinvocation_directory
))
456 dir
= Vinvocation_directory
;
458 /* If we are running from the build directory, set DIR to the
459 src subdirectory of the Emacs tree, like on Posix
461 if (SBYTES (dir
) > sizeof ("/i386/") - 1
462 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
464 dir
= Fexpand_file_name (build_string ("../.."), dir
);
465 #else /* !WINDOWSNT */
467 name
= Fexpand_file_name (Vinvocation_name
, dir
);
470 Lisp_Object tem
, lib_src_exists
;
471 Lisp_Object etc_exists
, info_exists
;
473 /* See if dir contains subdirs for use by Emacs.
474 Check for the ones that would exist in a build directory,
475 not including lisp and info. */
476 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
477 lib_src_exists
= Ffile_exists_p (tem
);
480 /* MSDOS installations frequently remove lib-src, but we still
481 must set installation-directory, or else info won't find
482 its files (it uses the value of installation-directory). */
483 tem
= Fexpand_file_name (build_string ("info"), dir
);
484 info_exists
= Ffile_exists_p (tem
);
489 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
491 tem
= Fexpand_file_name (build_string ("etc"), dir
);
492 etc_exists
= Ffile_exists_p (tem
);
493 if (!NILP (etc_exists
))
495 Vinstallation_directory
496 = Ffile_name_as_directory (dir
);
501 /* See if dir's parent contains those subdirs. */
502 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
503 lib_src_exists
= Ffile_exists_p (tem
);
507 /* See the MSDOS commentary above. */
508 tem
= Fexpand_file_name (build_string ("../info"), dir
);
509 info_exists
= Ffile_exists_p (tem
);
514 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
516 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
517 etc_exists
= Ffile_exists_p (tem
);
518 if (!NILP (etc_exists
))
520 tem
= Fexpand_file_name (build_string (".."), dir
);
521 Vinstallation_directory
522 = Ffile_name_as_directory (tem
);
527 /* If the Emacs executable is actually a link,
528 next try the dir that the link points into. */
529 tem
= Ffile_symlink_p (name
);
532 name
= Fexpand_file_name (tem
, dir
);
533 dir
= Ffile_name_directory (name
);
540 Vcommand_line_args
= Qnil
;
542 for (i
= argc
- 1; i
>= 0; i
--)
544 if (i
== 0 || i
> skip_args
)
545 /* For the moment, we keep arguments as is in unibyte strings.
546 They are decoded in the function command-line after we know
547 locale-coding-system. */
549 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
552 unbind_to (count
, Qnil
);
555 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
556 doc
: /* Return the program name that was used to run Emacs.
557 Any directory names are omitted. */)
560 return Fcopy_sequence (Vinvocation_name
);
563 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
565 doc
: /* Return the directory name in which the Emacs executable was located. */)
568 return Fcopy_sequence (Vinvocation_directory
);
572 /* Test whether the next argument in ARGV matches SSTR or a prefix of
573 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
574 (the argument is supposed to have a value) store in *VALPTR either
575 the next argument or the portion of this one after the equal sign.
576 ARGV is read starting at position *SKIPPTR; this index is advanced
577 by the number of arguments used.
579 Too bad we can't just use getopt for all of this, but we don't have
580 enough information to do it right. */
583 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
584 int minlen
, char **valptr
, int *skipptr
)
590 /* Don't access argv[argc]; give up in advance. */
591 if (argc
<= *skipptr
+ 1)
594 arg
= argv
[*skipptr
+1];
597 if (strcmp (arg
, sstr
) == 0)
601 *valptr
= argv
[*skipptr
+2];
608 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
609 ? p
- arg
: strlen (arg
));
610 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
612 else if (valptr
== NULL
)
623 else if (argv
[*skipptr
+2] != NULL
)
625 *valptr
= argv
[*skipptr
+2];
635 #ifdef DOUG_LEA_MALLOC
637 /* malloc can be invoked even before main (e.g. by the dynamic
638 linker), so the dumped malloc state must be restored as early as
639 possible using this special hook. */
642 malloc_initialize_hook (void)
646 if (!malloc_using_checking
)
647 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
648 ignored if the heap to be restored was constructed without
649 malloc checking. Can't use unsetenv, since that calls malloc. */
653 for (p
= environ
; p
&& *p
; p
++)
654 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
663 malloc_set_state (malloc_state_ptr
);
664 #ifndef XMALLOC_OVERRUN_CHECK
665 free (malloc_state_ptr
);
670 if (my_heap_start
== 0)
671 my_heap_start
= sbrk (0);
672 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
676 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
678 #endif /* DOUG_LEA_MALLOC */
680 /* Close standard output and standard error, reporting any write
681 errors as best we can. This is intended for use with atexit. */
683 close_output_streams (void)
685 if (close_stream (stdout
) != 0)
687 emacs_perror ("Write error to standard output");
688 _exit (EXIT_FAILURE
);
691 if (close_stream (stderr
) != 0)
692 _exit (EXIT_FAILURE
);
697 main (int argc
, char **argv
)
702 char stack_bottom_variable
;
703 bool do_initial_setlocale
;
706 #ifdef HAVE_SETRLIMIT
712 #ifdef DAEMON_MUST_EXEC
717 /* If we use --chdir, this records the original directory. */
718 char *original_pwd
= 0;
725 might_dump
= !initialized
;
731 if (my_heap_start
== 0)
732 my_heap_start
= sbrk (0);
734 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
738 #if defined WINDOWSNT || defined HAVE_NTGUI
739 /* Set global variables used to detect Windows version. Do this as
740 early as possible. (unexw32.c calls this function as well, but
741 the additional call here is harmless.) */
742 cache_system_info ();
744 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
745 to have non-stub implementations of APIs we need to convert file
746 names between UTF-8 and the system's ANSI codepage. */
747 maybe_load_unicows_dll ();
751 #ifdef RUN_TIME_REMAP
753 run_time_remap (argv
[0]);
756 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
759 unexec_init_emacs_zone ();
762 atexit (close_output_streams
);
764 sort_args (argc
, argv
);
766 while (argv
[argc
]) argc
++;
768 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
770 const char *version
, *copyright
;
773 Lisp_Object tem
, tem2
;
774 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
775 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
778 fprintf (stderr
, "Invalid value of `emacs-version'\n");
783 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
788 version
= SSDATA (tem
);
789 copyright
= SSDATA (tem2
);
794 version
= emacs_version
;
795 copyright
= emacs_copyright
;
797 printf ("%s %s\n", PACKAGE_NAME
, version
);
798 printf ("%s\n", copyright
);
799 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
800 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
801 printf ("under the terms of the GNU General Public License.\n");
802 printf ("For more information about these matters, ");
803 printf ("see the file named COPYING.\n");
807 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
810 /* argv[] array is kept in its original ANSI codepage encoding,
811 we need to convert to UTF-8, for chdir to work. */
812 char newdir
[MAX_UTF8_PATH
];
814 filename_from_ansi (ch_to_dir
, newdir
);
817 original_pwd
= get_current_dir_name ();
818 if (chdir (ch_to_dir
) != 0)
820 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
821 argv
[0], ch_to_dir
, strerror (errno
));
826 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
827 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
829 #ifdef HAVE_PERSONALITY_LINUX32
830 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
832 /* Set this so we only do this once. */
833 xputenv ("EMACS_HEAP_EXEC=true");
835 /* A flag to turn off address randomization which is introduced
836 in linux kernel shipped with fedora core 4 */
837 #define ADD_NO_RANDOMIZE 0x0040000
838 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
839 #undef ADD_NO_RANDOMIZE
841 execvp (argv
[0], argv
);
843 /* If the exec fails, try to dump anyway. */
844 emacs_perror (argv
[0]);
846 #endif /* HAVE_PERSONALITY_LINUX32 */
848 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
849 /* Extend the stack space available.
850 Don't do that if dumping, since some systems (e.g. DJGPP)
851 might define a smaller stack limit at that time. */
854 && (!noninteractive
|| initialized
)
856 && !getrlimit (RLIMIT_STACK
, &rlim
))
859 /* Approximate the amount regex.c needs per unit of re_max_failures. */
860 int ratio
= 20 * sizeof (char *);
861 /* Then add 33% to cover the size of the smaller stacks that regex.c
862 successively allocates and discards, on its way to the maximum. */
864 /* Add in some extra to cover
865 what we're likely to use for other reasons. */
866 newlim
= re_max_failures
* ratio
+ 200000;
868 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
869 stack allocation routine for new process that the allocation
870 fails if stack limit is not on page boundary. So, round up the
871 new limit to page boundary. */
872 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
874 if (newlim
> rlim
.rlim_max
)
876 newlim
= rlim
.rlim_max
;
877 /* Don't let regex.c overflow the stack we have. */
878 re_max_failures
= (newlim
- 200000) / ratio
;
880 if (rlim
.rlim_cur
< newlim
)
881 rlim
.rlim_cur
= newlim
;
883 setrlimit (RLIMIT_STACK
, &rlim
);
885 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
887 /* Record (approximately) where the stack begins. */
888 stack_bottom
= &stack_bottom_variable
;
892 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
893 /* Arrange to get warning messages as memory fills up. */
894 memory_warnings (0, malloc_warning
);
896 /* Call malloc at least once, to run malloc_initialize_hook.
897 Also call realloc and free for consistency. */
898 free (realloc (malloc (4), 4));
900 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
903 SET_BINARY (fileno (stdin
));
905 SET_BINARY (fileno (stdout
));
908 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
909 The build procedure uses this while dumping, to ensure that the
910 dumped Emacs does not have its system locale tables initialized,
911 as that might cause screwups when the dumped Emacs starts up. */
913 char *lc_all
= getenv ("LC_ALL");
914 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
917 /* Set locale now, so that initial error messages are localized properly.
918 fixup_locale must wait until later, since it builds strings. */
919 if (do_initial_setlocale
)
920 setlocale (LC_ALL
, "");
922 inhibit_window_system
= 0;
924 /* Handle the -t switch, which specifies filename to use as terminal. */
928 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
933 result
= emacs_open (term
, O_RDWR
, 0);
934 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
936 char *errstring
= strerror (errno
);
937 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
942 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
945 fprintf (stderr
, "Using %s\n", term
);
946 #ifdef HAVE_WINDOW_SYSTEM
947 inhibit_window_system
= 1; /* -t => -nw */
954 /* Command line option --no-windows is deprecated and thus not mentioned
955 in the manual and usage information. */
956 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
957 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
958 inhibit_window_system
= 1;
960 /* Handle the -batch switch, which means don't do interactive display. */
962 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
965 Vundo_outer_limit
= Qnil
;
967 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
969 noninteractive
= 1; /* Set batch mode. */
970 /* Convert --script to -scriptload, un-skip it, and sort again
971 so that it will be handled in proper sequence. */
972 /* FIXME broken for --script=FILE - is that supposed to work? */
973 argv
[skip_args
- 1] = (char *) "-scriptload";
975 sort_args (argc
, argv
);
978 /* Handle the --help option, which gives a usage message. */
979 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
982 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
983 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
984 fputs (usage_message
[i
], stdout
);
988 /* Make sure IS_DAEMON starts up as false. */
991 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
992 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
997 /* Start as a daemon: fork a new child process which will run the
998 rest of the initialization code, then exit.
1000 Detaching a daemon requires the following steps:
1004 - close the tty file-descriptors
1006 We only want to do the last 2 steps once the daemon is ready to
1007 serve requests, i.e. after loading .emacs (initialization).
1008 OTOH initialization may start subprocesses (e.g. ispell) and these
1009 should be run from the proper process (the one that will end up
1010 running as daemon) and with the proper "session id" in order for
1011 them to keep working after detaching, so fork and setsid need to be
1012 performed before initialization.
1014 We want to avoid exiting before the server socket is ready, so
1015 use a pipe for synchronization. The parent waits for the child
1016 to close its end of the pipe (using `daemon-initialized')
1018 if (emacs_pipe (daemon_pipe
) != 0)
1020 fprintf (stderr
, "Cannot pipe!\n");
1024 #ifndef DAEMON_MUST_EXEC
1026 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1027 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1028 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1029 #endif /* USE_GTK */
1031 #else /* DAEMON_MUST_EXEC */
1032 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1033 f
= fork (); /* in orig */
1035 f
= 0; /* in exec'd */
1036 #endif /* !DAEMON_MUST_EXEC */
1042 /* Close unused writing end of the pipe. */
1043 emacs_close (daemon_pipe
[1]);
1045 /* Just wait for the child to close its end of the pipe. */
1048 retval
= read (daemon_pipe
[0], &buf
, 1);
1050 while (retval
== -1 && errno
== EINTR
);
1054 fprintf (stderr
, "Error reading status from child\n");
1057 else if (retval
== 0)
1059 fprintf (stderr
, "Error: server did not start correctly\n");
1063 emacs_close (daemon_pipe
[0]);
1068 emacs_perror ("fork");
1069 exit (EXIT_CANCELED
);
1072 #ifdef DAEMON_MUST_EXEC
1074 /* In orig process, forked as child, OR in exec'd. */
1075 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1076 { /* In orig, child: now exec w/special daemon name. */
1079 snprintf (fdStr
, sizeof fdStr
,
1080 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1081 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1083 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1085 fprintf (stderr
, "daemon: child name too long\n");
1086 exit (EXIT_CANNOT_INVOKE
);
1089 argv
[skip_args
] = fdStr
;
1091 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1092 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1093 execvp (argv
[0], argv
);
1094 emacs_perror (argv
[0]);
1095 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1098 /* In exec'd: parse special dname into pipe and name info. */
1099 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1100 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1102 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1103 exit (EXIT_CANNOT_INVOKE
);
1105 dname_arg2
[0] = '\0';
1106 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1108 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1109 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1111 #endif /* DAEMON_MUST_EXEC */
1114 daemon_name
= xstrdup (dname_arg
);
1115 /* Close unused reading end of the pipe. */
1116 emacs_close (daemon_pipe
[0]);
1120 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1125 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1126 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1127 # ifndef CANNOT_DUMP
1128 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1129 that causes an infinite recursive loop with FreeBSD. See
1130 Bug#14569. The part of this bug involving Cygwin is no longer
1131 relevant, now that Cygwin defines HYBRID_MALLOC. */
1132 if (!noninteractive
|| initialized
)
1134 malloc_enable_thread ();
1137 init_signals (dumping
);
1139 noninteractive1
= noninteractive
;
1141 /* Perform basic initializations (not merely interning symbols). */
1148 init_charset_once ();
1149 init_coding_once ();
1150 init_syntax_once (); /* Create standard syntax table. */
1151 init_category_once (); /* Create standard category table. */
1152 init_casetab_once (); /* Must be done before init_buffer_once. */
1153 init_buffer_once (); /* Create buffer table and some buffers. */
1154 init_minibuf_once (); /* Create list of minibuffers. */
1155 /* Must precede init_window_once. */
1157 /* Call syms_of_xfaces before init_window_once because that
1158 function creates Vterminal_frame. Termcap frames now use
1159 faces, and the face implementation uses some symbols as
1162 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1163 be better to arrange things not to have this dependency. */
1165 /* Call syms_of_keyboard before init_window_once because
1166 keyboard sets up symbols that include some face names that
1167 the X support will want to use. This can happen when
1168 CANNOT_DUMP is defined. */
1169 syms_of_keyboard ();
1171 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1173 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1175 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1177 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1179 /* Before syms_of_coding because it initializes Qcharsetp. */
1181 /* Before init_window_once, because it sets up the
1182 Vcoding_system_hash_table. */
1183 syms_of_coding (); /* This should be after syms_of_fileio. */
1185 init_window_once (); /* Init the window system. */
1186 #ifdef HAVE_WINDOW_SYSTEM
1187 init_fringe_once (); /* Swap bitmaps if necessary. */
1188 #endif /* HAVE_WINDOW_SYSTEM */
1193 if (do_initial_setlocale
)
1196 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1197 Vsystem_time_locale
= Vprevious_system_time_locale
;
1202 running_asynch_code
= 0;
1206 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1209 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1212 ns_pool
= ns_alloc_autorelease_pool ();
1213 #ifdef NS_IMPL_GNUSTEP
1214 /* GNUstep stupidly resets our locale settings after we made them. */
1218 if (!noninteractive
)
1220 #ifdef NS_IMPL_COCOA
1221 /* Started from GUI? */
1222 /* FIXME: Do the right thing if getenv returns NULL, or if
1224 if (! inhibit_window_system
&& ! isatty (0) && ! ch_to_dir
)
1225 chdir (getenv ("HOME"));
1226 if (skip_args
< argc
)
1228 if (!strncmp (argv
[skip_args
], "-psn", 4))
1231 if (! ch_to_dir
) chdir (getenv ("HOME"));
1233 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1236 if (! ch_to_dir
) chdir (getenv ("HOME"));
1241 #endif /* HAVE_NS */
1243 #ifdef HAVE_X_WINDOWS
1244 /* Stupid kludge to catch command-line display spec. We can't
1245 handle this argument entirely in window system dependent code
1246 because we don't even know which window system dependent code
1247 to run until we've recognized this argument. */
1249 char *displayname
= 0;
1250 int count_before
= skip_args
;
1252 /* Skip any number of -d options, but only use the last one. */
1255 int count_before_this
= skip_args
;
1257 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1259 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1264 count_before
= count_before_this
;
1267 /* If we have the form --display=NAME,
1268 convert it into -d name.
1269 This requires inserting a new element into argv. */
1270 if (displayname
&& count_before
< skip_args
)
1272 if (skip_args
== count_before
+ 1)
1274 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1275 (argc
- (count_before
+ 2)) * sizeof *argv
);
1276 argv
[count_before
+ 2] = displayname
;
1279 argv
[count_before
+ 1] = (char *) "-d";
1284 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1285 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1289 /* Don't actually discard this arg. */
1290 skip_args
= count_before
;
1292 #else /* !HAVE_X_WINDOWS */
1295 int count_before
= skip_args
;
1297 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1298 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1301 skip_args
= count_before
;
1305 /* argmatch must not be used after here,
1306 except when building temacs
1307 because the -d argument has not been skipped in skip_args. */
1310 /* Call early 'cause init_environment needs it. */
1312 /* Set defaults for several environment variables. */
1314 init_environment (argc
, argv
, skip_args
);
1319 #ifdef HAVE_GFILENOTIFY
1320 globals_of_gfilenotify ();
1325 #ifdef HAVE_W32NOTIFY
1326 globals_of_w32notify ();
1328 /* Initialize environment from registry settings. */
1329 init_environment (argv
);
1330 init_ntproc (dumping
); /* must precede init_editfns. */
1333 /* Initialize and GC-protect Vinitial_environment and
1334 Vprocess_environment before set_initial_environment fills them
1337 syms_of_callproc ();
1338 /* egetenv is a pretty low-level facility, which may get called in
1339 many circumstances; it seems flimsy to put off initializing it
1340 until calling init_callproc. Do not do it when dumping. */
1342 set_initial_environment ();
1344 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1345 if this is not done. Do it after set_global_environment so that we
1346 don't pollute Vglobal_environment. */
1347 /* Setting LANG here will defeat the startup locale processing... */
1352 /* Init buffer storage and default directory of main buffer. */
1353 init_buffer (initialized
);
1355 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1357 /* Must precede init_lread. */
1358 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1362 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1363 Lisp_Object old_log_max
;
1364 old_log_max
= Vmessage_log_max
;
1365 XSETFASTINT (Vmessage_log_max
, 0);
1366 message_dolog ("", 0, 1, 0);
1367 Vmessage_log_max
= old_log_max
;
1370 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1374 /* Check to see if Emacs has been installed correctly. */
1375 check_windows_init_file ();
1378 /* Intern the names of all standard functions and variables;
1379 define standard keys. */
1383 /* The basic levels of Lisp must come first. Note that
1384 syms_of_data and some others have already been called. */
1389 syms_of_floatfns ();
1392 syms_of_bytecode ();
1394 syms_of_casefiddle ();
1396 syms_of_category ();
1398 syms_of_character ();
1405 syms_of_filelock ();
1408 /* syms_of_keymap (); */
1416 syms_of_terminal ();
1422 syms_of_textprop ();
1423 syms_of_composite ();
1426 #endif /* WINDOWSNT */
1433 #ifdef HAVE_WINDOW_SYSTEM
1436 #endif /* HAVE_WINDOW_SYSTEM */
1437 #ifdef HAVE_X_WINDOWS
1442 syms_of_xsettings ();
1449 #endif /* HAVE_X_WINDOWS */
1456 syms_of_decompress ();
1466 #endif /* HAVE_NTGUI */
1468 #if defined WINDOWSNT || defined HAVE_NTGUI
1469 syms_of_w32select ();
1476 syms_of_win16select ();
1483 syms_of_nsselect ();
1485 #endif /* HAVE_NS */
1489 #ifdef HAVE_GFILENOTIFY
1490 syms_of_gfilenotify ();
1491 #endif /* HAVE_GFILENOTIFY */
1495 #endif /* HAVE_INOTIFY */
1498 syms_of_dbusbind ();
1499 #endif /* HAVE_DBUS */
1503 #ifdef HAVE_W32NOTIFY
1504 syms_of_w32notify ();
1505 #endif /* HAVE_W32NOTIFY */
1506 #endif /* WINDOWSNT */
1508 syms_of_profiler ();
1510 keys_of_casefiddle ();
1513 keys_of_keyboard ();
1519 /* Initialization that must be done even if the global variable
1520 initialized is non zero. */
1522 globals_of_w32font ();
1523 globals_of_w32fns ();
1524 globals_of_w32menu ();
1525 #endif /* HAVE_NTGUI */
1527 #if defined WINDOWSNT || defined HAVE_NTGUI
1528 globals_of_w32select ();
1534 /* This calls putenv and so must precede init_process_emacs. Also,
1535 it sets Voperating_system_release, which init_process_emacs uses. */
1538 /* These two call putenv. */
1546 /* This can create a thread that may call getenv, so it must follow
1547 all calls to putenv and setenv. Also, this sets up
1548 add_keyboard_wait_descriptor, which init_display uses. */
1549 init_process_emacs ();
1551 init_keyboard (); /* This too must precede init_sys_modes. */
1552 if (!noninteractive
)
1553 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1556 init_crit (); /* w32notify.c needs this in batch mode. */
1557 #endif /* HAVE_W32NOTIFY */
1559 #ifdef HAVE_WINDOW_SYSTEM
1561 #endif /* HAVE_WINDOW_SYSTEM */
1569 /* Handle -l loadup, args passed by Makefile. */
1570 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1573 char file_utf8
[MAX_UTF8_PATH
];
1575 if (filename_from_ansi (file
, file_utf8
) == 0)
1578 Vtop_level
= list2 (intern_c_string ("load"),
1579 build_unibyte_string (file
));
1581 /* Unless next switch is -nl, load "loadup.el" first thing. */
1583 Vtop_level
= list2 (intern_c_string ("load"),
1584 build_string ("loadup.el"));
1587 /* Set up for profiling. This is known to work on FreeBSD,
1588 GNU/Linux and MinGW. It might work on some other systems too.
1589 Give it a try and tell us if it works on your system. To compile
1590 for profiling, use the configure option --enable-profiling. */
1591 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1596 extern unsigned char etext
asm ("etext");
1602 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1611 /* Enter editor command loop. This never returns. */
1617 /* Sort the args so we can find the most important ones
1618 at the beginning of argv. */
1620 /* First, here's a table of all the standard options. */
1622 struct standard_args
1625 const char *longname
;
1630 static const struct standard_args standard_args
[] =
1632 { "-version", "--version", 150, 0 },
1633 { "-chdir", "--chdir", 130, 1 },
1634 { "-t", "--terminal", 120, 1 },
1635 { "-nw", "--no-window-system", 110, 0 },
1636 { "-nw", "--no-windows", 110, 0 },
1637 { "-batch", "--batch", 100, 0 },
1638 { "-script", "--script", 100, 1 },
1639 { "-daemon", "--daemon", 99, 0 },
1640 { "-help", "--help", 90, 0 },
1641 { "-nl", "--no-loadup", 70, 0 },
1642 { "-nsl", "--no-site-lisp", 65, 0 },
1643 /* -d must come last before the options handled in startup.el. */
1644 { "-d", "--display", 60, 1 },
1645 { "-display", 0, 60, 1 },
1646 /* Now for the options handled in `command-line' (startup.el). */
1647 /* (Note that to imply -nsl, -Q is partially handled here.) */
1648 { "-Q", "--quick", 55, 0 },
1649 { "-quick", 0, 55, 0 },
1650 { "-q", "--no-init-file", 50, 0 },
1651 { "-no-init-file", 0, 50, 0 },
1652 { "-no-site-file", "--no-site-file", 40, 0 },
1653 { "-u", "--user", 30, 1 },
1654 { "-user", 0, 30, 1 },
1655 { "-debug-init", "--debug-init", 20, 0 },
1656 { "-iconic", "--iconic", 15, 0 },
1657 { "-D", "--basic-display", 12, 0},
1658 { "-basic-display", 0, 12, 0},
1659 { "-nbc", "--no-blinking-cursor", 12, 0 },
1660 /* Now for the options handled in `command-line-1' (startup.el). */
1661 { "-nbi", "--no-bitmap-icon", 10, 0 },
1662 { "-bg", "--background-color", 10, 1 },
1663 { "-background", 0, 10, 1 },
1664 { "-fg", "--foreground-color", 10, 1 },
1665 { "-foreground", 0, 10, 1 },
1666 { "-bd", "--border-color", 10, 1 },
1667 { "-bw", "--border-width", 10, 1 },
1668 { "-ib", "--internal-border", 10, 1 },
1669 { "-ms", "--mouse-color", 10, 1 },
1670 { "-cr", "--cursor-color", 10, 1 },
1671 { "-fn", "--font", 10, 1 },
1672 { "-font", 0, 10, 1 },
1673 { "-fs", "--fullscreen", 10, 0 },
1674 { "-fw", "--fullwidth", 10, 0 },
1675 { "-fh", "--fullheight", 10, 0 },
1676 { "-mm", "--maximized", 10, 0 },
1677 { "-g", "--geometry", 10, 1 },
1678 { "-geometry", 0, 10, 1 },
1679 { "-T", "--title", 10, 1 },
1680 { "-title", 0, 10, 1 },
1681 { "-name", "--name", 10, 1 },
1682 { "-xrm", "--xrm", 10, 1 },
1683 { "-parent-id", "--parent-id", 10, 1 },
1684 { "-r", "--reverse-video", 5, 0 },
1686 { "-reverse", 0, 5, 0 },
1687 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1688 { "-vb", "--vertical-scroll-bars", 5, 0 },
1689 { "-color", "--color", 5, 0},
1690 { "-no-splash", "--no-splash", 3, 0 },
1691 { "-no-desktop", "--no-desktop", 3, 0 },
1693 { "-NSAutoLaunch", 0, 5, 1 },
1694 { "-NXAutoLaunch", 0, 5, 1 },
1695 { "-_NSMachLaunch", 0, 85, 1 },
1696 { "-MachLaunch", 0, 85, 1 },
1697 { "-macosx", 0, 85, 0 },
1698 { "-NSHost", 0, 85, 1 },
1700 /* These have the same priority as ordinary file name args,
1701 so they are not reordered with respect to those. */
1702 { "-L", "--directory", 0, 1 },
1703 { "-directory", 0, 0, 1 },
1704 { "-l", "--load", 0, 1 },
1705 { "-load", 0, 0, 1 },
1706 /* This has no longname, because using --scriptload confuses sort_args,
1707 because then the --script long option seems to match twice; ie
1708 you can't have a long option which is a prefix of another long
1709 option. In any case, this is entirely an internal option. */
1710 { "-scriptload", NULL
, 0, 1 },
1711 { "-f", "--funcall", 0, 1 },
1712 { "-funcall", 0, 0, 1 },
1713 { "-eval", "--eval", 0, 1 },
1714 { "-execute", "--execute", 0, 1 },
1715 { "-find-file", "--find-file", 0, 1 },
1716 { "-visit", "--visit", 0, 1 },
1717 { "-file", "--file", 0, 1 },
1718 { "-insert", "--insert", 0, 1 },
1720 { "-NXOpen", 0, 0, 1 },
1721 { "-NXOpenTemp", 0, 0, 1 },
1722 { "-NSOpen", 0, 0, 1 },
1723 { "-NSOpenTemp", 0, 0, 1 },
1724 { "-GSFilePath", 0, 0, 1 },
1726 /* This should be processed after ordinary file name args and the like. */
1727 { "-kill", "--kill", -10, 0 },
1730 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1731 so that the highest priority ones come first.
1732 Do not change the order of elements of equal priority.
1733 If an option takes an argument, keep it and its argument together.
1735 If an option that takes no argument appears more
1736 than once, eliminate all but one copy of it. */
1739 sort_args (int argc
, char **argv
)
1741 char **new = xmalloc (argc
* sizeof *new);
1742 /* For each element of argv,
1743 the corresponding element of options is:
1744 0 for an option that takes no arguments,
1745 1 for an option that takes one argument, etc.
1746 -1 for an ordinary non-option argument. */
1747 int *options
= xnmalloc (argc
, sizeof *options
);
1748 int *priority
= xnmalloc (argc
, sizeof *priority
);
1750 int incoming_used
= 1;
1754 /* Categorize all the options,
1755 and figure out which argv elts are option arguments. */
1756 for (from
= 1; from
< argc
; from
++)
1760 if (argv
[from
][0] == '-')
1764 /* If we have found "--", don't consider
1765 any more arguments as options. */
1766 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1768 /* Leave the "--", and everything following it, at the end. */
1769 for (; from
< argc
; from
++)
1771 priority
[from
] = -100;
1777 /* Look for a match with a known old-fashioned option. */
1778 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1779 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1781 options
[from
] = standard_args
[i
].nargs
;
1782 priority
[from
] = standard_args
[i
].priority
;
1783 if (from
+ standard_args
[i
].nargs
>= argc
)
1784 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1785 from
+= standard_args
[i
].nargs
;
1789 /* Look for a match with a known long option.
1790 MATCH is -1 if no match so far, -2 if two or more matches so far,
1791 >= 0 (the table index of the match) if just one match so far. */
1792 if (argv
[from
][1] == '-')
1794 char const *equals
= strchr (argv
[from
], '=');
1796 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1800 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1801 if (standard_args
[i
].longname
1802 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1811 /* If we found exactly one match, use that. */
1814 options
[from
] = standard_args
[match
].nargs
;
1815 priority
[from
] = standard_args
[match
].priority
;
1816 /* If --OPTION=VALUE syntax is used,
1817 this option uses just one argv element. */
1820 if (from
+ options
[from
] >= argc
)
1821 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1822 from
+= options
[from
];
1824 /* FIXME When match < 0, shouldn't there be some error,
1825 or at least indication to the user that there was a
1832 /* Copy the arguments, in order of decreasing priority, to NEW. */
1834 while (incoming_used
< argc
)
1837 int best_priority
= -9999;
1839 /* Find the highest priority remaining option.
1840 If several have equal priority, take the first of them. */
1841 for (from
= 1; from
< argc
; from
++)
1843 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1845 best_priority
= priority
[from
];
1848 /* Skip option arguments--they are tied to the options. */
1849 if (options
[from
] > 0)
1850 from
+= options
[from
];
1856 /* Copy the highest priority remaining option, with its args, to NEW.
1857 Unless it is a duplicate of the previous one. */
1858 if (! (options
[best
] == 0
1859 && ! strcmp (new[to
- 1], argv
[best
])))
1861 new[to
++] = argv
[best
];
1862 for (i
= 0; i
< options
[best
]; i
++)
1863 new[to
++] = argv
[best
+ i
+ 1];
1866 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1868 /* Clear out this option in ARGV. */
1870 for (i
= 0; i
< options
[best
]; i
++)
1871 argv
[best
+ i
+ 1] = 0;
1874 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1878 memcpy (argv
, new, sizeof (char *) * argc
);
1885 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1886 doc
: /* Exit the Emacs job and kill it.
1887 If ARG is an integer, return ARG as the exit program code.
1888 If ARG is a string, stuff it as keyboard input.
1890 This function is called upon receipt of the signals SIGTERM
1891 or SIGHUP, and upon SIGINT in batch mode.
1893 The value of `kill-emacs-hook', if not void,
1894 is a list of functions (of no args),
1895 all of which are called before Emacs is actually killed. */
1896 attributes
: noreturn
)
1899 struct gcpro gcpro1
;
1907 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1909 waiting_for_input
= 0;
1910 run_hook (Qkill_emacs_hook
);
1913 #ifdef HAVE_X_WINDOWS
1914 /* Transfer any clipboards we own to the clipboard manager. */
1915 x_clipboard_manager_save_all ();
1918 shut_down_emacs (0, STRINGP (arg
) ? arg
: Qnil
);
1921 ns_release_autorelease_pool (ns_pool
);
1924 /* If we have an auto-save list file,
1925 kill it because we are exiting Emacs deliberately (not crashing).
1926 Do it after shut_down_emacs, which does an auto-save. */
1927 if (STRINGP (Vauto_save_list_file_name
))
1929 Lisp_Object listfile
;
1930 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1931 unlink (SSDATA (listfile
));
1935 exit_code
= (XINT (arg
) < 0
1936 ? XINT (arg
) | INT_MIN
1937 : XINT (arg
) & INT_MAX
);
1939 exit_code
= EXIT_SUCCESS
;
1944 /* Perform an orderly shutdown of Emacs. Autosave any modified
1945 buffers, kill any child processes, clean up the terminal modes (if
1946 we're in the foreground), and other stuff like that. Don't perform
1947 any redisplay; this may be called when Emacs is shutting down in
1948 the background, or after its X connection has died.
1950 If SIG is a signal number, print a message for it.
1952 This is called by fatal signal handlers, X protocol error handlers,
1956 shut_down_emacs (int sig
, Lisp_Object stuff
)
1958 /* Prevent running of hooks from now on. */
1961 /* Don't update display from now on. */
1962 Vinhibit_redisplay
= Qt
;
1964 /* If we are controlling the terminal, reset terminal modes. */
1967 pid_t pgrp
= getpgrp ();
1968 pid_t tpgrp
= tcgetpgrp (0);
1969 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1971 reset_all_sys_modes ();
1972 if (sig
&& sig
!= SIGTERM
)
1974 static char const format
[] = "Fatal error %d: ";
1975 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1976 int buflen
= sprintf (buf
, format
, sig
);
1977 char const *sig_desc
= safe_strsignal (sig
);
1978 emacs_write (STDERR_FILENO
, buf
, buflen
);
1979 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1985 reset_all_sys_modes ();
1988 stuff_buffered_input (stuff
);
1990 inhibit_sentinels
= 1;
1991 kill_buffer_processes (Qnil
);
1992 Fdo_auto_save (Qt
, Qnil
);
1994 unlock_all_files ();
1996 /* There is a tendency for a SIGIO signal to arrive within exit,
1997 and cause a SIGHUP because the input descriptor is already closed. */
2001 /* Do this only if terminating normally, we want glyph matrices
2002 etc. in a core dump. */
2003 if (sig
== 0 || sig
== SIGTERM
)
2005 check_glyph_memory ();
2006 check_message_stack ();
2014 ns_term_shutdown (sig
);
2018 xml_cleanup_parser ();
2032 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2033 doc
: /* Dump current state of Emacs into executable file FILENAME.
2034 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2035 This is used in the file `loadup.el' when building Emacs.
2037 You must run Emacs in batch mode in order to dump it. */)
2038 (Lisp_Object filename
, Lisp_Object symfile
)
2042 ptrdiff_t count
= SPECPDL_INDEX ();
2046 if (! noninteractive
)
2047 error ("Dumping Emacs works only in batch mode");
2050 error ("Emacs can be dumped only once");
2054 /* Warn if the gap between BSS end and heap start is larger than this. */
2055 # define MAX_HEAP_BSS_DIFF (1024*1024)
2057 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2059 fprintf (stderr
, "**************************************************\n");
2060 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2061 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2063 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2064 fprintf (stderr
, "fail because of this. See the section about\n");
2065 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2066 fprintf (stderr
, "**************************************************\n");
2068 #endif /* GNU_LINUX */
2070 /* Bind `command-line-processed' to nil before dumping,
2071 so that the dumped Emacs will process its command line
2072 and set up to work with X windows if appropriate. */
2073 symbol
= intern ("command-line-processed");
2074 specbind (symbol
, Qnil
);
2076 CHECK_STRING (filename
);
2077 filename
= Fexpand_file_name (filename
, Qnil
);
2078 filename
= ENCODE_FILE (filename
);
2079 if (!NILP (symfile
))
2081 CHECK_STRING (symfile
);
2082 if (SCHARS (symfile
))
2084 symfile
= Fexpand_file_name (symfile
, Qnil
);
2085 symfile
= ENCODE_FILE (symfile
);
2090 Vpurify_flag
= Qnil
;
2093 /* Tell malloc where start of impure now is. */
2094 /* Also arrange for warnings when nearly out of space. */
2095 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2097 /* On Windows, this was done before dumping, and that once suffices.
2098 Meanwhile, my_edata is not valid on Windows. */
2099 memory_warnings (my_edata
, malloc_warning
);
2100 #endif /* not WINDOWSNT */
2101 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2102 #ifdef DOUG_LEA_MALLOC
2103 malloc_state_ptr
= malloc_get_state ();
2106 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2108 #ifdef DOUG_LEA_MALLOC
2109 free (malloc_state_ptr
);
2113 Vlibrary_cache
= Qnil
;
2115 #ifdef HAVE_WINDOW_SYSTEM
2116 reset_image_types ();
2121 return unbind_to (count
, Qnil
);
2124 #endif /* not CANNOT_DUMP */
2127 /* Recover from setlocale (LC_ALL, ""). */
2131 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2132 so that numbers are read and printed properly for Emacs Lisp. */
2133 setlocale (LC_NUMERIC
, "C");
2136 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2139 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2141 if (! EQ (*plocale
, desired_locale
))
2143 *plocale
= desired_locale
;
2144 setlocale (category
, (STRINGP (desired_locale
)
2145 ? SSDATA (desired_locale
)
2150 /* Set system time locale to match Vsystem_time_locale, if possible. */
2152 synchronize_system_time_locale (void)
2154 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2155 Vsystem_time_locale
);
2158 /* Set system messages locale to match Vsystem_messages_locale, if
2161 synchronize_system_messages_locale (void)
2164 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2165 Vsystem_messages_locale
);
2168 #endif /* HAVE_SETLOCALE */
2172 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2174 const char *path
, *p
;
2175 Lisp_Object lpath
, element
, tem
;
2176 /* Default is to use "." for empty path elements.
2177 But if argument EMPTY is true, use nil instead. */
2178 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2181 static const char *emacs_dir_env
= "%emacs_dir%/";
2182 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2183 const char *edir
= egetenv ("emacs_dir");
2184 char emacs_dir
[MAX_UTF8_PATH
];
2186 /* egetenv looks in process-environment, which holds the variables
2187 in their original system-locale encoding. We need emacs_dir to
2190 filename_from_ansi (edir
, emacs_dir
);
2193 /* It's okay to use getenv here, because this function is only used
2194 to initialize variables when Emacs starts up, and isn't called
2197 path
= getenv (evarname
);
2208 /* Ensure values from the environment use the proper directory separator. */
2214 char *path_utf8
, *q
, *d
;
2217 /* Convert each element of PATH to UTF-8. */
2218 p
= path_copy
= alloca (strlen (path
) + 1);
2219 strcpy (path_copy
, path
);
2220 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2223 q
= _mbschr (p
, SEPCHAR
);
2226 cnv_result
= filename_from_ansi (p
, d
);
2231 /* If conversion of this PATH elements fails, make sure
2232 destination pointer will stay put, thus effectively
2233 ignoring the offending element. */
2234 if (cnv_result
== 0)
2240 else if (cnv_result
!= 0 && d
> path_utf8
)
2241 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2243 path_copy
= path_utf8
;
2245 path_copy
= alloca (strlen (path
) + 1);
2246 strcpy (path_copy
, path
);
2248 dostounix_filename (path_copy
);
2255 p
= strchr (path
, SEPCHAR
);
2257 p
= path
+ strlen (path
);
2258 element
= (p
- path
? make_unibyte_string (path
, p
- path
)
2260 if (! NILP (element
))
2263 /* Relative file names in the default path are interpreted as
2264 being relative to $emacs_dir. */
2265 if (edir
&& defaulted
2266 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2267 element
= Fexpand_file_name (Fsubstring
2269 make_number (emacs_dir_len
),
2271 build_unibyte_string (emacs_dir
));
2274 /* Add /: to the front of the name
2275 if it would otherwise be treated as magic. */
2276 tem
= Ffind_file_name_handler (element
, Qt
);
2278 /* However, if the handler says "I'm safe",
2279 don't bother adding /:. */
2283 prop
= Fget (tem
, intern ("safe-magic"));
2290 AUTO_STRING (slash_colon
, "/:");
2291 element
= concat2 (slash_colon
, element
);
2293 } /* !NILP (element) */
2295 lpath
= Fcons (element
, lpath
);
2301 return Fnreverse (lpath
);
2304 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2305 doc
: /* Return non-nil if the current emacs process is a daemon.
2306 If the daemon was given a name argument, return that name. */)
2311 return build_string (daemon_name
);
2318 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2319 doc
: /* Mark the Emacs daemon as being initialized.
2320 This finishes the daemonization process by doing the other half of detaching
2321 from the parent process and its tty file descriptors. */)
2328 error ("This function can only be called if emacs is run as a daemon");
2330 if (daemon_pipe
[1] < 0)
2331 error ("The daemon has already been initialized");
2333 if (NILP (Vafter_init_time
))
2334 error ("This function can only be called after loading the init files");
2336 /* Get rid of stdin, stdout and stderr. */
2337 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2339 err
|= dup2 (nfd
, 0) < 0;
2340 err
|= dup2 (nfd
, 1) < 0;
2341 err
|= dup2 (nfd
, 2) < 0;
2342 err
|= emacs_close (nfd
) != 0;
2344 /* Closing the pipe will notify the parent that it can exit.
2345 FIXME: In case some other process inherited the pipe, closing it here
2346 won't notify the parent because it's still open elsewhere, so we
2347 additionally send a byte, just to make sure the parent really exits.
2348 Instead, we should probably close the pipe in start-process and
2349 call-process to make sure the pipe is never inherited by
2351 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2352 err
|= emacs_close (daemon_pipe
[1]) != 0;
2353 /* Set it to an invalid value so we know we've already run this function. */
2354 daemon_pipe
[1] = -1;
2357 error ("I/O error during daemon initialization");
2362 syms_of_emacs (void)
2364 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2365 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2366 DEFSYM (Qkill_emacs
, "kill-emacs");
2367 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2370 defsubr (&Sdump_emacs
);
2373 defsubr (&Skill_emacs
);
2375 defsubr (&Sinvocation_name
);
2376 defsubr (&Sinvocation_directory
);
2377 defsubr (&Sdaemonp
);
2378 defsubr (&Sdaemon_initialized
);
2380 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2381 doc
: /* Args passed by shell to Emacs, as a list of strings.
2382 Many arguments are deleted from the list as they are processed. */);
2384 DEFVAR_LISP ("system-type", Vsystem_type
,
2385 doc
: /* The value is a symbol indicating the type of operating system you are using.
2387 `gnu' compiled for a GNU Hurd system.
2388 `gnu/linux' compiled for a GNU/Linux system.
2389 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2390 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2391 `ms-dos' compiled as an MS-DOS application.
2392 `windows-nt' compiled as a native W32 application.
2393 `cygwin' compiled using the Cygwin library.
2394 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2395 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2396 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2397 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2399 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2400 doc
: /* Value is string indicating configuration Emacs was built for.
2401 On MS-Windows, the value reflects the OS flavor and version on which
2402 Emacs is running. */);
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. */);
2413 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2415 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2416 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2418 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2419 doc
: /* Hook run when `kill-emacs' is called.
2420 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2421 in other similar situations), functions placed on this hook should not
2422 expect to be able to interact with the user. To ask for confirmation,
2423 see `kill-emacs-query-functions' instead.
2425 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2426 `noninteractive' was non-nil. */);
2427 Vkill_emacs_hook
= Qnil
;
2429 DEFVAR_LISP ("path-separator", Vpath_separator
,
2430 doc
: /* String containing the character that separates directories in
2431 search paths, such as PATH and other similar environment variables. */);
2434 Vpath_separator
= make_string (&c
, 1);
2437 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2438 doc
: /* The program name that was used to run Emacs.
2439 Any directory names are omitted. */);
2441 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2442 doc
: /* The directory in which the Emacs executable was found, to run it.
2443 The value is nil if that directory's name is not known. */);
2445 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2446 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2447 In an installed Emacs, this is normally nil. It is non-nil if
2448 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2449 within the variable `invocation-directory' or its parent. For example,
2450 this is the case when running an uninstalled Emacs executable from its
2451 build directory. */);
2452 Vinstallation_directory
= Qnil
;
2454 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2455 doc
: /* System locale for messages. */);
2456 Vsystem_messages_locale
= Qnil
;
2458 DEFVAR_LISP ("previous-system-messages-locale",
2459 Vprevious_system_messages_locale
,
2460 doc
: /* Most recently used system locale for messages. */);
2461 Vprevious_system_messages_locale
= Qnil
;
2463 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2464 doc
: /* System locale for time. */);
2465 Vsystem_time_locale
= Qnil
;
2467 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2468 doc
: /* Most recently used system locale for time. */);
2469 Vprevious_system_time_locale
= Qnil
;
2471 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2472 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2473 Vbefore_init_time
= Qnil
;
2475 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2476 doc
: /* Value of `current-time' after loading the init files.
2477 This is nil during initialization. */);
2478 Vafter_init_time
= Qnil
;
2480 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2481 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2482 inhibit_x_resources
= 0;
2484 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2485 doc
: /* Short copyright string for this version of Emacs. */);
2486 Vemacs_copyright
= build_string (emacs_copyright
);
2488 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2489 doc
: /* Version numbers of this version of Emacs. */);
2490 Vemacs_version
= build_string (emacs_version
);
2492 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2493 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2494 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2496 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2497 doc
: /* Alist of dynamic libraries vs external files implementing them.
2498 Each element is a list (LIBRARY FILE...), where the car is a symbol
2499 representing a supported external library, and the rest are strings giving
2500 alternate filenames for that library.
2502 Emacs tries to load the library from the files in the order they appear on
2503 the list; if none is loaded, the running session of Emacs won't have access
2506 Note that image types `pbm' and `xbm' do not need entries in this variable
2507 because they do not depend on external libraries and are always available.
2509 Also note that this is not a generic facility for accessing external
2510 libraries; only those already known by Emacs will be loaded. */);
2511 Vdynamic_library_alist
= Qnil
;
2512 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2515 Vlibrary_cache
= Qnil
;
2516 staticpro (&Vlibrary_cache
);