1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2014
4 Free Software Foundation, Inc.
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 Lisp_Object Qfile_name_handler_alist
;
153 Lisp_Object Qrisky_local_variable
;
155 Lisp_Object Qkill_emacs
;
156 static Lisp_Object Qkill_emacs_hook
;
158 /* If true, Emacs should not attempt to use a window-specific code,
159 but instead should use the virtual terminal under which it was started. */
160 bool inhibit_window_system
;
162 /* If true, a filter or a sentinel is running. Tested to save the match
163 data on the first attempt to change it inside asynchronous code. */
164 bool running_asynch_code
;
166 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
167 /* If true, -d was specified, meaning we're using some window system. */
171 /* An address near the bottom of the stack.
172 Tells GC how to save a copy of the stack. */
175 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
176 /* The address where the heap starts (from the first sbrk (0) call). */
177 static void *my_heap_start
;
181 /* The gap between BSS end and heap start as far as we can tell. */
182 static uprintmax_t heap_bss_diff
;
185 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
188 On Cocoa, CoreFoundation lib fails in forked process:
189 http://developer.apple.com/ReleaseNotes/
190 CoreFoundation/CoreFoundation.html)
192 On Windows, a Cygwin fork child cannot access the USER subsystem.
194 We mark being in the exec'd process by a daemon name argument of
195 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
196 NAME is the original daemon name, if any. */
197 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
198 # define DAEMON_MUST_EXEC
201 /* True means running Emacs without interactive terminal. */
204 /* True means remove site-lisp directories from load-path. */
207 /* Name for the server started by the daemon.*/
208 static char *daemon_name
;
210 /* Pipe used to send exit notification to the daemon parent at
214 /* Save argv and argc. */
218 static void sort_args (int argc
, char **argv
);
219 static void syms_of_emacs (void);
221 /* C99 needs each string to be at most 4095 characters, and the usage
222 strings below are split to not overflow this limit. */
223 static char const *const usage_message
[] =
226 Run Emacs, the extensible, customizable, self-documenting real-time\n\
227 display editor. The recommended way to start Emacs for normal editing\n\
228 is with no options at all.\n\
230 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
231 read the main documentation for these command-line arguments.\n\
233 Initialization options:\n\
237 --batch do not do interactive display; implies -q\n\
238 --chdir DIR change to directory DIR\n\
239 --daemon start a server in the background\n\
240 --debug-init enable Emacs Lisp debugger for init file\n\
241 --display, -d DISPLAY use X server DISPLAY\n\
244 --no-desktop do not load a saved desktop\n\
245 --no-init-file, -q load neither ~/.emacs nor default.el\n\
246 --no-shared-memory, -nl do not use shared memory\n\
247 --no-site-file do not load site-start.el\n\
248 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
249 --no-splash do not display a splash screen on startup\n\
250 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
253 --quick, -Q equivalent to:\n\
254 -q --no-site-file --no-site-lisp --no-splash\n\
255 --script FILE run FILE as an Emacs Lisp script\n\
256 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
257 --user, -u USER load ~USER/.emacs instead of your own\n\
263 FILE visit FILE using find-file\n\
264 +LINE go to line LINE in next FILE\n\
265 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
266 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
267 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
268 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
271 --file FILE visit FILE using find-file\n\
272 --find-file FILE visit FILE using find-file\n\
273 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
274 --insert FILE insert contents of FILE into current buffer\n\
275 --kill exit without asking for confirmation\n\
276 --load, -l FILE load Emacs Lisp FILE using the load function\n\
277 --visit FILE visit FILE using find-file\n\
283 --background-color, -bg COLOR window background color\n\
284 --basic-display, -D disable many display features;\n\
285 used for debugging Emacs\n\
286 --border-color, -bd COLOR main border color\n\
287 --border-width, -bw WIDTH width of main border\n\
290 --color, --color=MODE override color mode for character terminals;\n\
291 MODE defaults to `auto', and\n\
292 can also be `never', `always',\n\
293 or a mode name like `ansi8'\n\
294 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
295 --font, -fn FONT default font; must be fixed-width\n\
296 --foreground-color, -fg COLOR window foreground color\n\
299 --fullheight, -fh make the first frame high as the screen\n\
300 --fullscreen, -fs make the first frame fullscreen\n\
301 --fullwidth, -fw make the first frame wide as the screen\n\
302 --maximized, -mm make the first frame maximized\n\
303 --geometry, -g GEOMETRY window geometry\n\
306 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
307 --iconic start Emacs in iconified state\n\
308 --internal-border, -ib WIDTH width between text and main border\n\
309 --line-spacing, -lsp PIXELS additional space to put between lines\n\
310 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
311 --name NAME title for initial Emacs frame\n\
314 --no-blinking-cursor, -nbc disable blinking cursor\n\
315 --reverse-video, -r, -rv switch foreground and background\n\
316 --title, -T TITLE title for initial Emacs frame\n\
317 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
318 --xrm XRESOURCES set additional X resources\n\
319 --parent-id XID set parent window\n\
320 --help display this help and exit\n\
321 --version output version information and exit\n\
325 You can generally also specify long option names with a single -; for\n\
326 example, -batch as well as --batch. You can use any unambiguous\n\
327 abbreviation for a --option.\n\
329 Various environment variables and window system resources also affect\n\
330 the operation of Emacs. See the main documentation.\n\
332 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
333 section of the Emacs manual or the file BUGS.\n"
337 /* True if handling a fatal error already. */
338 bool fatal_error_in_progress
;
341 /* NS autrelease pool, for memory management. */
342 static void *ns_pool
;
347 setlocale (int cat
, char const *locale
)
354 /* Report a fatal error due to signal SIG, output a backtrace of at
355 most BACKTRACE_LIMIT lines, and exit. */
357 terminate_due_to_signal (int sig
, int backtrace_limit
)
359 signal (sig
, SIG_DFL
);
360 totally_unblock_input ();
362 /* If fatal error occurs in code below, avoid infinite recursion. */
363 if (! fatal_error_in_progress
)
365 fatal_error_in_progress
= 1;
367 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
368 Fkill_emacs (make_number (sig
));
370 shut_down_emacs (sig
, Qnil
);
371 emacs_backtrace (backtrace_limit
);
374 /* Signal the same code; this time it will really be fatal.
375 Since we're in a signal handler, the signal is blocked, so we
376 have to unblock it if we want to really receive it. */
380 sigemptyset (&unblocked
);
381 sigaddset (&unblocked
, sig
);
382 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
388 /* This shouldn't be executed, but it prevents a warning. */
392 /* Code for dealing with Lisp access to the Unix command line. */
395 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
398 Lisp_Object name
, dir
, handler
;
399 ptrdiff_t count
= SPECPDL_INDEX ();
400 Lisp_Object raw_name
;
401 AUTO_STRING (slash_colon
, "/:");
407 /* Must use argv[0] converted to UTF-8, as it begets many standard
408 file and directory names. */
410 char argv0
[MAX_UTF8_PATH
];
412 if (filename_from_ansi (argv
[0], argv0
) == 0)
413 raw_name
= build_unibyte_string (argv0
);
415 raw_name
= build_unibyte_string (argv
[0]);
418 raw_name
= build_unibyte_string (argv
[0]);
421 /* Add /: to the front of the name
422 if it would otherwise be treated as magic. */
423 handler
= Ffind_file_name_handler (raw_name
, Qt
);
424 if (! NILP (handler
))
425 raw_name
= concat2 (slash_colon
, raw_name
);
427 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
428 Vinvocation_directory
= Ffile_name_directory (raw_name
);
430 /* If we got no directory in argv[0], search PATH to find where
431 Emacs actually came from. */
432 if (NILP (Vinvocation_directory
))
435 int yes
= openp (Vexec_path
, Vinvocation_name
,
436 Vexec_suffixes
, &found
, make_number (X_OK
), false);
439 /* Add /: to the front of the name
440 if it would otherwise be treated as magic. */
441 handler
= Ffind_file_name_handler (found
, Qt
);
442 if (! NILP (handler
))
443 found
= concat2 (slash_colon
, found
);
444 Vinvocation_directory
= Ffile_name_directory (found
);
448 if (!NILP (Vinvocation_directory
)
449 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
450 /* Emacs was started with relative path, like ./emacs.
454 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
456 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
459 Vinstallation_directory
= Qnil
;
461 if (!NILP (Vinvocation_directory
))
463 dir
= Vinvocation_directory
;
465 /* If we are running from the build directory, set DIR to the
466 src subdirectory of the Emacs tree, like on Posix
468 if (SBYTES (dir
) > sizeof ("/i386/") - 1
469 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
471 dir
= Fexpand_file_name (build_string ("../.."), dir
);
472 #else /* !WINDOWSNT */
474 name
= Fexpand_file_name (Vinvocation_name
, dir
);
477 Lisp_Object tem
, lib_src_exists
;
478 Lisp_Object etc_exists
, info_exists
;
480 /* See if dir contains subdirs for use by Emacs.
481 Check for the ones that would exist in a build directory,
482 not including lisp and info. */
483 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
484 lib_src_exists
= Ffile_exists_p (tem
);
487 /* MSDOS installations frequently remove lib-src, but we still
488 must set installation-directory, or else info won't find
489 its files (it uses the value of installation-directory). */
490 tem
= Fexpand_file_name (build_string ("info"), dir
);
491 info_exists
= Ffile_exists_p (tem
);
496 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
498 tem
= Fexpand_file_name (build_string ("etc"), dir
);
499 etc_exists
= Ffile_exists_p (tem
);
500 if (!NILP (etc_exists
))
502 Vinstallation_directory
503 = Ffile_name_as_directory (dir
);
508 /* See if dir's parent contains those subdirs. */
509 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
510 lib_src_exists
= Ffile_exists_p (tem
);
514 /* See the MSDOS commentary above. */
515 tem
= Fexpand_file_name (build_string ("../info"), dir
);
516 info_exists
= Ffile_exists_p (tem
);
521 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
523 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
524 etc_exists
= Ffile_exists_p (tem
);
525 if (!NILP (etc_exists
))
527 tem
= Fexpand_file_name (build_string (".."), dir
);
528 Vinstallation_directory
529 = Ffile_name_as_directory (tem
);
534 /* If the Emacs executable is actually a link,
535 next try the dir that the link points into. */
536 tem
= Ffile_symlink_p (name
);
539 name
= Fexpand_file_name (tem
, dir
);
540 dir
= Ffile_name_directory (name
);
547 Vcommand_line_args
= Qnil
;
549 for (i
= argc
- 1; i
>= 0; i
--)
551 if (i
== 0 || i
> skip_args
)
552 /* For the moment, we keep arguments as is in unibyte strings.
553 They are decoded in the function command-line after we know
554 locale-coding-system. */
556 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
559 unbind_to (count
, Qnil
);
562 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
563 doc
: /* Return the program name that was used to run Emacs.
564 Any directory names are omitted. */)
567 return Fcopy_sequence (Vinvocation_name
);
570 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
572 doc
: /* Return the directory name in which the Emacs executable was located. */)
575 return Fcopy_sequence (Vinvocation_directory
);
579 /* Test whether the next argument in ARGV matches SSTR or a prefix of
580 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
581 (the argument is supposed to have a value) store in *VALPTR either
582 the next argument or the portion of this one after the equal sign.
583 ARGV is read starting at position *SKIPPTR; this index is advanced
584 by the number of arguments used.
586 Too bad we can't just use getopt for all of this, but we don't have
587 enough information to do it right. */
590 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
591 int minlen
, char **valptr
, int *skipptr
)
597 /* Don't access argv[argc]; give up in advance. */
598 if (argc
<= *skipptr
+ 1)
601 arg
= argv
[*skipptr
+1];
604 if (strcmp (arg
, sstr
) == 0)
608 *valptr
= argv
[*skipptr
+2];
615 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
616 ? p
- arg
: strlen (arg
));
617 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
619 else if (valptr
== NULL
)
630 else if (argv
[*skipptr
+2] != NULL
)
632 *valptr
= argv
[*skipptr
+2];
642 #ifdef DOUG_LEA_MALLOC
644 /* malloc can be invoked even before main (e.g. by the dynamic
645 linker), so the dumped malloc state must be restored as early as
646 possible using this special hook. */
649 malloc_initialize_hook (void)
653 if (!malloc_using_checking
)
654 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
655 ignored if the heap to be restored was constructed without
656 malloc checking. Can't use unsetenv, since that calls malloc. */
660 for (p
= environ
; p
&& *p
; p
++)
661 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
670 malloc_set_state (malloc_state_ptr
);
671 #ifndef XMALLOC_OVERRUN_CHECK
672 free (malloc_state_ptr
);
677 if (my_heap_start
== 0)
678 my_heap_start
= sbrk (0);
679 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
683 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
685 #endif /* DOUG_LEA_MALLOC */
687 /* Close standard output and standard error, reporting any write
688 errors as best we can. This is intended for use with atexit. */
690 close_output_streams (void)
692 if (close_stream (stdout
) != 0)
694 emacs_perror ("Write error to standard output");
695 _exit (EXIT_FAILURE
);
698 if (close_stream (stderr
) != 0)
699 _exit (EXIT_FAILURE
);
704 main (int argc
, char **argv
)
709 char stack_bottom_variable
;
710 bool do_initial_setlocale
;
713 #ifdef HAVE_SETRLIMIT
719 #ifdef DAEMON_MUST_EXEC
724 /* If we use --chdir, this records the original directory. */
725 char *original_pwd
= 0;
732 might_dump
= !initialized
;
738 if (my_heap_start
== 0)
739 my_heap_start
= sbrk (0);
741 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
745 #if defined WINDOWSNT || defined HAVE_NTGUI
746 /* Set global variables used to detect Windows version. Do this as
747 early as possible. (unexw32.c calls this function as well, but
748 the additional call here is harmless.) */
749 cache_system_info ();
751 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
752 to have non-stub implementations of APIs we need to convert file
753 names between UTF-8 and the system's ANSI codepage. */
754 maybe_load_unicows_dll ();
758 #ifdef RUN_TIME_REMAP
760 run_time_remap (argv
[0]);
763 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
766 unexec_init_emacs_zone ();
769 atexit (close_output_streams
);
771 sort_args (argc
, argv
);
773 while (argv
[argc
]) argc
++;
775 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
777 const char *version
, *copyright
;
780 Lisp_Object tem
, tem2
;
781 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
782 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
785 fprintf (stderr
, "Invalid value of `emacs-version'\n");
790 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
795 version
= SSDATA (tem
);
796 copyright
= SSDATA (tem2
);
801 version
= emacs_version
;
802 copyright
= emacs_copyright
;
804 printf ("%s %s\n", PACKAGE_NAME
, version
);
805 printf ("%s\n", copyright
);
806 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
807 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
808 printf ("under the terms of the GNU General Public License.\n");
809 printf ("For more information about these matters, ");
810 printf ("see the file named COPYING.\n");
814 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
817 /* argv[] array is kept in its original ANSI codepage encoding,
818 we need to convert to UTF-8, for chdir to work. */
819 char newdir
[MAX_UTF8_PATH
];
821 filename_from_ansi (ch_to_dir
, newdir
);
824 original_pwd
= get_current_dir_name ();
825 if (chdir (ch_to_dir
) != 0)
827 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
828 argv
[0], ch_to_dir
, strerror (errno
));
833 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
834 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
836 #ifdef HAVE_PERSONALITY_LINUX32
837 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
839 /* Set this so we only do this once. */
840 xputenv ("EMACS_HEAP_EXEC=true");
842 /* A flag to turn off address randomization which is introduced
843 in linux kernel shipped with fedora core 4 */
844 #define ADD_NO_RANDOMIZE 0x0040000
845 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
846 #undef ADD_NO_RANDOMIZE
848 execvp (argv
[0], argv
);
850 /* If the exec fails, try to dump anyway. */
851 emacs_perror (argv
[0]);
853 #endif /* HAVE_PERSONALITY_LINUX32 */
855 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
856 /* Extend the stack space available.
857 Don't do that if dumping, since some systems (e.g. DJGPP)
858 might define a smaller stack limit at that time. */
861 && (!noninteractive
|| initialized
)
863 && !getrlimit (RLIMIT_STACK
, &rlim
))
866 /* Approximate the amount regex.c needs per unit of re_max_failures. */
867 int ratio
= 20 * sizeof (char *);
868 /* Then add 33% to cover the size of the smaller stacks that regex.c
869 successively allocates and discards, on its way to the maximum. */
871 /* Add in some extra to cover
872 what we're likely to use for other reasons. */
873 newlim
= re_max_failures
* ratio
+ 200000;
875 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
876 stack allocation routine for new process that the allocation
877 fails if stack limit is not on page boundary. So, round up the
878 new limit to page boundary. */
879 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
881 if (newlim
> rlim
.rlim_max
)
883 newlim
= rlim
.rlim_max
;
884 /* Don't let regex.c overflow the stack we have. */
885 re_max_failures
= (newlim
- 200000) / ratio
;
887 if (rlim
.rlim_cur
< newlim
)
888 rlim
.rlim_cur
= newlim
;
890 setrlimit (RLIMIT_STACK
, &rlim
);
892 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
894 /* Record (approximately) where the stack begins. */
895 stack_bottom
= &stack_bottom_variable
;
899 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
900 /* Arrange to get warning messages as memory fills up. */
901 memory_warnings (0, malloc_warning
);
903 /* Call malloc at least once, to run malloc_initialize_hook.
904 Also call realloc and free for consistency. */
905 free (realloc (malloc (4), 4));
907 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
910 SET_BINARY (fileno (stdin
));
912 SET_BINARY (fileno (stdout
));
915 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
916 The build procedure uses this while dumping, to ensure that the
917 dumped Emacs does not have its system locale tables initialized,
918 as that might cause screwups when the dumped Emacs starts up. */
920 char *lc_all
= getenv ("LC_ALL");
921 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
924 /* Set locale now, so that initial error messages are localized properly.
925 fixup_locale must wait until later, since it builds strings. */
926 if (do_initial_setlocale
)
927 setlocale (LC_ALL
, "");
929 inhibit_window_system
= 0;
931 /* Handle the -t switch, which specifies filename to use as terminal. */
935 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
940 result
= emacs_open (term
, O_RDWR
, 0);
941 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
943 char *errstring
= strerror (errno
);
944 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
949 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
952 fprintf (stderr
, "Using %s\n", term
);
953 #ifdef HAVE_WINDOW_SYSTEM
954 inhibit_window_system
= 1; /* -t => -nw */
961 /* Command line option --no-windows is deprecated and thus not mentioned
962 in the manual and usage information. */
963 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
964 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
965 inhibit_window_system
= 1;
967 /* Handle the -batch switch, which means don't do interactive display. */
969 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
972 Vundo_outer_limit
= Qnil
;
974 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
976 noninteractive
= 1; /* Set batch mode. */
977 /* Convert --script to -scriptload, un-skip it, and sort again
978 so that it will be handled in proper sequence. */
979 /* FIXME broken for --script=FILE - is that supposed to work? */
980 argv
[skip_args
- 1] = (char *) "-scriptload";
982 sort_args (argc
, argv
);
985 /* Handle the --help option, which gives a usage message. */
986 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
989 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
990 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
991 fputs (usage_message
[i
], stdout
);
995 /* Make sure IS_DAEMON starts up as false. */
998 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
999 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
1004 /* Start as a daemon: fork a new child process which will run the
1005 rest of the initialization code, then exit.
1007 Detaching a daemon requires the following steps:
1011 - close the tty file-descriptors
1013 We only want to do the last 2 steps once the daemon is ready to
1014 serve requests, i.e. after loading .emacs (initialization).
1015 OTOH initialization may start subprocesses (e.g. ispell) and these
1016 should be run from the proper process (the one that will end up
1017 running as daemon) and with the proper "session id" in order for
1018 them to keep working after detaching, so fork and setsid need to be
1019 performed before initialization.
1021 We want to avoid exiting before the server socket is ready, so
1022 use a pipe for synchronization. The parent waits for the child
1023 to close its end of the pipe (using `daemon-initialized')
1025 if (emacs_pipe (daemon_pipe
) != 0)
1027 fprintf (stderr
, "Cannot pipe!\n");
1031 #ifndef DAEMON_MUST_EXEC
1033 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1034 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1035 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1036 #endif /* USE_GTK */
1038 #else /* DAEMON_MUST_EXEC */
1039 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1040 f
= fork (); /* in orig */
1042 f
= 0; /* in exec'd */
1043 #endif /* !DAEMON_MUST_EXEC */
1049 /* Close unused writing end of the pipe. */
1050 emacs_close (daemon_pipe
[1]);
1052 /* Just wait for the child to close its end of the pipe. */
1055 retval
= read (daemon_pipe
[0], &buf
, 1);
1057 while (retval
== -1 && errno
== EINTR
);
1061 fprintf (stderr
, "Error reading status from child\n");
1064 else if (retval
== 0)
1066 fprintf (stderr
, "Error: server did not start correctly\n");
1070 emacs_close (daemon_pipe
[0]);
1075 emacs_perror ("fork");
1076 exit (EXIT_CANCELED
);
1079 #ifdef DAEMON_MUST_EXEC
1081 /* In orig process, forked as child, OR in exec'd. */
1082 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1083 { /* In orig, child: now exec w/special daemon name. */
1086 snprintf (fdStr
, sizeof fdStr
,
1087 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1088 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1090 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1092 fprintf (stderr
, "daemon: child name too long\n");
1093 exit (EXIT_CANNOT_INVOKE
);
1096 argv
[skip_args
] = fdStr
;
1098 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1099 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1100 execvp (argv
[0], argv
);
1101 emacs_perror (argv
[0]);
1102 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1105 /* In exec'd: parse special dname into pipe and name info. */
1106 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1107 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1109 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1110 exit (EXIT_CANNOT_INVOKE
);
1112 dname_arg2
[0] = '\0';
1113 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1115 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1116 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1118 #endif /* DAEMON_MUST_EXEC */
1121 daemon_name
= xstrdup (dname_arg
);
1122 /* Close unused reading end of the pipe. */
1123 emacs_close (daemon_pipe
[0]);
1127 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1132 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1133 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1134 # ifndef CANNOT_DUMP
1135 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1136 that causes an infinite recursive loop with FreeBSD. See
1137 Bug#14569. The part of this bug involving Cygwin is no longer
1138 relevant, now that Cygwin defines HYBRID_MALLOC. */
1139 if (!noninteractive
|| initialized
)
1141 malloc_enable_thread ();
1144 init_signals (dumping
);
1146 noninteractive1
= noninteractive
;
1148 /* Perform basic initializations (not merely interning symbols). */
1155 init_charset_once ();
1156 init_coding_once ();
1157 init_syntax_once (); /* Create standard syntax table. */
1158 init_category_once (); /* Create standard category table. */
1159 init_casetab_once (); /* Must be done before init_buffer_once. */
1160 init_buffer_once (); /* Create buffer table and some buffers. */
1161 init_minibuf_once (); /* Create list of minibuffers. */
1162 /* Must precede init_window_once. */
1164 /* Call syms_of_xfaces before init_window_once because that
1165 function creates Vterminal_frame. Termcap frames now use
1166 faces, and the face implementation uses some symbols as
1169 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1170 be better to arrange things not to have this dependency. */
1172 /* Call syms_of_keyboard before init_window_once because
1173 keyboard sets up symbols that include some face names that
1174 the X support will want to use. This can happen when
1175 CANNOT_DUMP is defined. */
1176 syms_of_keyboard ();
1178 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1180 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1182 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1184 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1186 /* Before syms_of_coding because it initializes Qcharsetp. */
1188 /* Before init_window_once, because it sets up the
1189 Vcoding_system_hash_table. */
1190 syms_of_coding (); /* This should be after syms_of_fileio. */
1192 init_window_once (); /* Init the window system. */
1193 #ifdef HAVE_WINDOW_SYSTEM
1194 init_fringe_once (); /* Swap bitmaps if necessary. */
1195 #endif /* HAVE_WINDOW_SYSTEM */
1200 if (do_initial_setlocale
)
1203 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1204 Vsystem_time_locale
= Vprevious_system_time_locale
;
1209 running_asynch_code
= 0;
1213 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1216 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1219 ns_pool
= ns_alloc_autorelease_pool ();
1220 #ifdef NS_IMPL_GNUSTEP
1221 /* GNUstep stupidly resets our locale settings after we made them. */
1225 if (!noninteractive
)
1227 #ifdef NS_IMPL_COCOA
1228 /* Started from GUI? */
1229 /* FIXME: Do the right thing if getenv returns NULL, or if
1231 if (! inhibit_window_system
&& ! isatty (0) && ! ch_to_dir
)
1232 chdir (getenv ("HOME"));
1233 if (skip_args
< argc
)
1235 if (!strncmp (argv
[skip_args
], "-psn", 4))
1238 if (! ch_to_dir
) chdir (getenv ("HOME"));
1240 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1243 if (! ch_to_dir
) chdir (getenv ("HOME"));
1248 #endif /* HAVE_NS */
1250 #ifdef HAVE_X_WINDOWS
1251 /* Stupid kludge to catch command-line display spec. We can't
1252 handle this argument entirely in window system dependent code
1253 because we don't even know which window system dependent code
1254 to run until we've recognized this argument. */
1256 char *displayname
= 0;
1257 int count_before
= skip_args
;
1259 /* Skip any number of -d options, but only use the last one. */
1262 int count_before_this
= skip_args
;
1264 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1266 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1271 count_before
= count_before_this
;
1274 /* If we have the form --display=NAME,
1275 convert it into -d name.
1276 This requires inserting a new element into argv. */
1277 if (displayname
&& count_before
< skip_args
)
1279 if (skip_args
== count_before
+ 1)
1281 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1282 (argc
- (count_before
+ 2)) * sizeof *argv
);
1283 argv
[count_before
+ 2] = displayname
;
1286 argv
[count_before
+ 1] = (char *) "-d";
1291 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1292 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1296 /* Don't actually discard this arg. */
1297 skip_args
= count_before
;
1299 #else /* !HAVE_X_WINDOWS */
1302 int count_before
= skip_args
;
1304 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1305 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1308 skip_args
= count_before
;
1312 /* argmatch must not be used after here,
1313 except when building temacs
1314 because the -d argument has not been skipped in skip_args. */
1317 /* Call early 'cause init_environment needs it. */
1319 /* Set defaults for several environment variables. */
1321 init_environment (argc
, argv
, skip_args
);
1326 #ifdef HAVE_GFILENOTIFY
1327 globals_of_gfilenotify ();
1332 #ifdef HAVE_W32NOTIFY
1333 globals_of_w32notify ();
1335 /* Initialize environment from registry settings. */
1336 init_environment (argv
);
1337 init_ntproc (dumping
); /* must precede init_editfns. */
1340 /* Initialize and GC-protect Vinitial_environment and
1341 Vprocess_environment before set_initial_environment fills them
1344 syms_of_callproc ();
1345 /* egetenv is a pretty low-level facility, which may get called in
1346 many circumstances; it seems flimsy to put off initializing it
1347 until calling init_callproc. Do not do it when dumping. */
1349 set_initial_environment ();
1351 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1352 if this is not done. Do it after set_global_environment so that we
1353 don't pollute Vglobal_environment. */
1354 /* Setting LANG here will defeat the startup locale processing... */
1359 /* Init buffer storage and default directory of main buffer. */
1360 init_buffer (initialized
);
1362 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1364 /* Must precede init_lread. */
1365 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1369 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1370 Lisp_Object old_log_max
;
1371 old_log_max
= Vmessage_log_max
;
1372 XSETFASTINT (Vmessage_log_max
, 0);
1373 message_dolog ("", 0, 1, 0);
1374 Vmessage_log_max
= old_log_max
;
1377 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1381 /* Check to see if Emacs has been installed correctly. */
1382 check_windows_init_file ();
1385 /* Intern the names of all standard functions and variables;
1386 define standard keys. */
1390 /* The basic levels of Lisp must come first. Note that
1391 syms_of_data and some others have already been called. */
1396 syms_of_floatfns ();
1399 syms_of_bytecode ();
1401 syms_of_casefiddle ();
1403 syms_of_category ();
1405 syms_of_character ();
1412 syms_of_filelock ();
1415 /* syms_of_keymap (); */
1423 syms_of_terminal ();
1429 syms_of_textprop ();
1430 syms_of_composite ();
1433 #endif /* WINDOWSNT */
1440 #ifdef HAVE_WINDOW_SYSTEM
1443 #endif /* HAVE_WINDOW_SYSTEM */
1444 #ifdef HAVE_X_WINDOWS
1449 syms_of_xsettings ();
1456 #endif /* HAVE_X_WINDOWS */
1463 syms_of_decompress ();
1473 #endif /* HAVE_NTGUI */
1475 #if defined WINDOWSNT || defined HAVE_NTGUI
1476 syms_of_w32select ();
1483 syms_of_win16select ();
1490 syms_of_nsselect ();
1492 #endif /* HAVE_NS */
1496 #ifdef HAVE_GFILENOTIFY
1497 syms_of_gfilenotify ();
1498 #endif /* HAVE_GFILENOTIFY */
1502 #endif /* HAVE_INOTIFY */
1505 syms_of_dbusbind ();
1506 #endif /* HAVE_DBUS */
1510 #ifdef HAVE_W32NOTIFY
1511 syms_of_w32notify ();
1512 #endif /* HAVE_W32NOTIFY */
1513 #endif /* WINDOWSNT */
1515 syms_of_profiler ();
1517 keys_of_casefiddle ();
1520 keys_of_keyboard ();
1526 /* Initialization that must be done even if the global variable
1527 initialized is non zero. */
1529 globals_of_w32font ();
1530 globals_of_w32fns ();
1531 globals_of_w32menu ();
1532 #endif /* HAVE_NTGUI */
1534 #if defined WINDOWSNT || defined HAVE_NTGUI
1535 globals_of_w32select ();
1541 /* This calls putenv and so must precede init_process_emacs. Also,
1542 it sets Voperating_system_release, which init_process_emacs uses. */
1545 /* These two call putenv. */
1553 /* This can create a thread that may call getenv, so it must follow
1554 all calls to putenv and setenv. Also, this sets up
1555 add_keyboard_wait_descriptor, which init_display uses. */
1556 init_process_emacs ();
1558 init_keyboard (); /* This too must precede init_sys_modes. */
1559 if (!noninteractive
)
1560 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1563 init_crit (); /* w32notify.c needs this in batch mode. */
1564 #endif /* HAVE_W32NOTIFY */
1566 #ifdef HAVE_WINDOW_SYSTEM
1568 #endif /* HAVE_WINDOW_SYSTEM */
1576 /* Handle -l loadup, args passed by Makefile. */
1577 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1580 char file_utf8
[MAX_UTF8_PATH
];
1582 if (filename_from_ansi (file
, file_utf8
) == 0)
1585 Vtop_level
= list2 (intern_c_string ("load"),
1586 build_unibyte_string (file
));
1588 /* Unless next switch is -nl, load "loadup.el" first thing. */
1590 Vtop_level
= list2 (intern_c_string ("load"),
1591 build_string ("loadup.el"));
1594 /* Set up for profiling. This is known to work on FreeBSD,
1595 GNU/Linux and MinGW. It might work on some other systems too.
1596 Give it a try and tell us if it works on your system. To compile
1597 for profiling, use the configure option --enable-profiling. */
1598 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1603 extern unsigned char etext
asm ("etext");
1609 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1618 /* Enter editor command loop. This never returns. */
1624 /* Sort the args so we can find the most important ones
1625 at the beginning of argv. */
1627 /* First, here's a table of all the standard options. */
1629 struct standard_args
1632 const char *longname
;
1637 static const struct standard_args standard_args
[] =
1639 { "-version", "--version", 150, 0 },
1640 { "-chdir", "--chdir", 130, 1 },
1641 { "-t", "--terminal", 120, 1 },
1642 { "-nw", "--no-window-system", 110, 0 },
1643 { "-nw", "--no-windows", 110, 0 },
1644 { "-batch", "--batch", 100, 0 },
1645 { "-script", "--script", 100, 1 },
1646 { "-daemon", "--daemon", 99, 0 },
1647 { "-help", "--help", 90, 0 },
1648 { "-nl", "--no-loadup", 70, 0 },
1649 { "-nsl", "--no-site-lisp", 65, 0 },
1650 /* -d must come last before the options handled in startup.el. */
1651 { "-d", "--display", 60, 1 },
1652 { "-display", 0, 60, 1 },
1653 /* Now for the options handled in `command-line' (startup.el). */
1654 /* (Note that to imply -nsl, -Q is partially handled here.) */
1655 { "-Q", "--quick", 55, 0 },
1656 { "-quick", 0, 55, 0 },
1657 { "-q", "--no-init-file", 50, 0 },
1658 { "-no-init-file", 0, 50, 0 },
1659 { "-no-site-file", "--no-site-file", 40, 0 },
1660 { "-u", "--user", 30, 1 },
1661 { "-user", 0, 30, 1 },
1662 { "-debug-init", "--debug-init", 20, 0 },
1663 { "-iconic", "--iconic", 15, 0 },
1664 { "-D", "--basic-display", 12, 0},
1665 { "-basic-display", 0, 12, 0},
1666 { "-nbc", "--no-blinking-cursor", 12, 0 },
1667 /* Now for the options handled in `command-line-1' (startup.el). */
1668 { "-nbi", "--no-bitmap-icon", 10, 0 },
1669 { "-bg", "--background-color", 10, 1 },
1670 { "-background", 0, 10, 1 },
1671 { "-fg", "--foreground-color", 10, 1 },
1672 { "-foreground", 0, 10, 1 },
1673 { "-bd", "--border-color", 10, 1 },
1674 { "-bw", "--border-width", 10, 1 },
1675 { "-ib", "--internal-border", 10, 1 },
1676 { "-ms", "--mouse-color", 10, 1 },
1677 { "-cr", "--cursor-color", 10, 1 },
1678 { "-fn", "--font", 10, 1 },
1679 { "-font", 0, 10, 1 },
1680 { "-fs", "--fullscreen", 10, 0 },
1681 { "-fw", "--fullwidth", 10, 0 },
1682 { "-fh", "--fullheight", 10, 0 },
1683 { "-mm", "--maximized", 10, 0 },
1684 { "-g", "--geometry", 10, 1 },
1685 { "-geometry", 0, 10, 1 },
1686 { "-T", "--title", 10, 1 },
1687 { "-title", 0, 10, 1 },
1688 { "-name", "--name", 10, 1 },
1689 { "-xrm", "--xrm", 10, 1 },
1690 { "-parent-id", "--parent-id", 10, 1 },
1691 { "-r", "--reverse-video", 5, 0 },
1693 { "-reverse", 0, 5, 0 },
1694 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1695 { "-vb", "--vertical-scroll-bars", 5, 0 },
1696 { "-color", "--color", 5, 0},
1697 { "-no-splash", "--no-splash", 3, 0 },
1698 { "-no-desktop", "--no-desktop", 3, 0 },
1700 { "-NSAutoLaunch", 0, 5, 1 },
1701 { "-NXAutoLaunch", 0, 5, 1 },
1702 { "-_NSMachLaunch", 0, 85, 1 },
1703 { "-MachLaunch", 0, 85, 1 },
1704 { "-macosx", 0, 85, 0 },
1705 { "-NSHost", 0, 85, 1 },
1707 /* These have the same priority as ordinary file name args,
1708 so they are not reordered with respect to those. */
1709 { "-L", "--directory", 0, 1 },
1710 { "-directory", 0, 0, 1 },
1711 { "-l", "--load", 0, 1 },
1712 { "-load", 0, 0, 1 },
1713 /* This has no longname, because using --scriptload confuses sort_args,
1714 because then the --script long option seems to match twice; ie
1715 you can't have a long option which is a prefix of another long
1716 option. In any case, this is entirely an internal option. */
1717 { "-scriptload", NULL
, 0, 1 },
1718 { "-f", "--funcall", 0, 1 },
1719 { "-funcall", 0, 0, 1 },
1720 { "-eval", "--eval", 0, 1 },
1721 { "-execute", "--execute", 0, 1 },
1722 { "-find-file", "--find-file", 0, 1 },
1723 { "-visit", "--visit", 0, 1 },
1724 { "-file", "--file", 0, 1 },
1725 { "-insert", "--insert", 0, 1 },
1727 { "-NXOpen", 0, 0, 1 },
1728 { "-NXOpenTemp", 0, 0, 1 },
1729 { "-NSOpen", 0, 0, 1 },
1730 { "-NSOpenTemp", 0, 0, 1 },
1731 { "-GSFilePath", 0, 0, 1 },
1733 /* This should be processed after ordinary file name args and the like. */
1734 { "-kill", "--kill", -10, 0 },
1737 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1738 so that the highest priority ones come first.
1739 Do not change the order of elements of equal priority.
1740 If an option takes an argument, keep it and its argument together.
1742 If an option that takes no argument appears more
1743 than once, eliminate all but one copy of it. */
1746 sort_args (int argc
, char **argv
)
1748 char **new = xmalloc (argc
* sizeof *new);
1749 /* For each element of argv,
1750 the corresponding element of options is:
1751 0 for an option that takes no arguments,
1752 1 for an option that takes one argument, etc.
1753 -1 for an ordinary non-option argument. */
1754 int *options
= xnmalloc (argc
, sizeof *options
);
1755 int *priority
= xnmalloc (argc
, sizeof *priority
);
1757 int incoming_used
= 1;
1761 /* Categorize all the options,
1762 and figure out which argv elts are option arguments. */
1763 for (from
= 1; from
< argc
; from
++)
1767 if (argv
[from
][0] == '-')
1771 /* If we have found "--", don't consider
1772 any more arguments as options. */
1773 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1775 /* Leave the "--", and everything following it, at the end. */
1776 for (; from
< argc
; from
++)
1778 priority
[from
] = -100;
1784 /* Look for a match with a known old-fashioned option. */
1785 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1786 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1788 options
[from
] = standard_args
[i
].nargs
;
1789 priority
[from
] = standard_args
[i
].priority
;
1790 if (from
+ standard_args
[i
].nargs
>= argc
)
1791 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1792 from
+= standard_args
[i
].nargs
;
1796 /* Look for a match with a known long option.
1797 MATCH is -1 if no match so far, -2 if two or more matches so far,
1798 >= 0 (the table index of the match) if just one match so far. */
1799 if (argv
[from
][1] == '-')
1801 char const *equals
= strchr (argv
[from
], '=');
1803 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1807 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1808 if (standard_args
[i
].longname
1809 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1818 /* If we found exactly one match, use that. */
1821 options
[from
] = standard_args
[match
].nargs
;
1822 priority
[from
] = standard_args
[match
].priority
;
1823 /* If --OPTION=VALUE syntax is used,
1824 this option uses just one argv element. */
1827 if (from
+ options
[from
] >= argc
)
1828 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1829 from
+= options
[from
];
1831 /* FIXME When match < 0, shouldn't there be some error,
1832 or at least indication to the user that there was a
1839 /* Copy the arguments, in order of decreasing priority, to NEW. */
1841 while (incoming_used
< argc
)
1844 int best_priority
= -9999;
1846 /* Find the highest priority remaining option.
1847 If several have equal priority, take the first of them. */
1848 for (from
= 1; from
< argc
; from
++)
1850 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1852 best_priority
= priority
[from
];
1855 /* Skip option arguments--they are tied to the options. */
1856 if (options
[from
] > 0)
1857 from
+= options
[from
];
1863 /* Copy the highest priority remaining option, with its args, to NEW.
1864 Unless it is a duplicate of the previous one. */
1865 if (! (options
[best
] == 0
1866 && ! strcmp (new[to
- 1], argv
[best
])))
1868 new[to
++] = argv
[best
];
1869 for (i
= 0; i
< options
[best
]; i
++)
1870 new[to
++] = argv
[best
+ i
+ 1];
1873 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1875 /* Clear out this option in ARGV. */
1877 for (i
= 0; i
< options
[best
]; i
++)
1878 argv
[best
+ i
+ 1] = 0;
1881 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1885 memcpy (argv
, new, sizeof (char *) * argc
);
1892 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1893 doc
: /* Exit the Emacs job and kill it.
1894 If ARG is an integer, return ARG as the exit program code.
1895 If ARG is a string, stuff it as keyboard input.
1897 This function is called upon receipt of the signals SIGTERM
1898 or SIGHUP, and upon SIGINT in batch mode.
1900 The value of `kill-emacs-hook', if not void,
1901 is a list of functions (of no args),
1902 all of which are called before Emacs is actually killed. */)
1905 struct gcpro gcpro1
;
1913 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1915 waiting_for_input
= 0;
1916 Frun_hooks (1, &Qkill_emacs_hook
);
1919 #ifdef HAVE_X_WINDOWS
1920 /* Transfer any clipboards we own to the clipboard manager. */
1921 x_clipboard_manager_save_all ();
1924 shut_down_emacs (0, STRINGP (arg
) ? arg
: Qnil
);
1927 ns_release_autorelease_pool (ns_pool
);
1930 /* If we have an auto-save list file,
1931 kill it because we are exiting Emacs deliberately (not crashing).
1932 Do it after shut_down_emacs, which does an auto-save. */
1933 if (STRINGP (Vauto_save_list_file_name
))
1935 Lisp_Object listfile
;
1936 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1937 unlink (SSDATA (listfile
));
1941 exit_code
= (XINT (arg
) < 0
1942 ? XINT (arg
) | INT_MIN
1943 : XINT (arg
) & INT_MAX
);
1945 exit_code
= EXIT_SUCCESS
;
1950 /* Perform an orderly shutdown of Emacs. Autosave any modified
1951 buffers, kill any child processes, clean up the terminal modes (if
1952 we're in the foreground), and other stuff like that. Don't perform
1953 any redisplay; this may be called when Emacs is shutting down in
1954 the background, or after its X connection has died.
1956 If SIG is a signal number, print a message for it.
1958 This is called by fatal signal handlers, X protocol error handlers,
1962 shut_down_emacs (int sig
, Lisp_Object stuff
)
1964 /* Prevent running of hooks from now on. */
1967 /* Don't update display from now on. */
1968 Vinhibit_redisplay
= Qt
;
1970 /* If we are controlling the terminal, reset terminal modes. */
1973 pid_t pgrp
= getpgrp ();
1974 pid_t tpgrp
= tcgetpgrp (0);
1975 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1977 reset_all_sys_modes ();
1978 if (sig
&& sig
!= SIGTERM
)
1980 static char const format
[] = "Fatal error %d: ";
1981 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1982 int buflen
= sprintf (buf
, format
, sig
);
1983 char const *sig_desc
= safe_strsignal (sig
);
1984 emacs_write (STDERR_FILENO
, buf
, buflen
);
1985 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1991 reset_all_sys_modes ();
1994 stuff_buffered_input (stuff
);
1996 inhibit_sentinels
= 1;
1997 kill_buffer_processes (Qnil
);
1998 Fdo_auto_save (Qt
, Qnil
);
2000 unlock_all_files ();
2002 /* There is a tendency for a SIGIO signal to arrive within exit,
2003 and cause a SIGHUP because the input descriptor is already closed. */
2007 /* Do this only if terminating normally, we want glyph matrices
2008 etc. in a core dump. */
2009 if (sig
== 0 || sig
== SIGTERM
)
2011 check_glyph_memory ();
2012 check_message_stack ();
2020 ns_term_shutdown (sig
);
2024 xml_cleanup_parser ();
2038 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2039 doc
: /* Dump current state of Emacs into executable file FILENAME.
2040 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2041 This is used in the file `loadup.el' when building Emacs.
2043 You must run Emacs in batch mode in order to dump it. */)
2044 (Lisp_Object filename
, Lisp_Object symfile
)
2048 ptrdiff_t count
= SPECPDL_INDEX ();
2052 if (! noninteractive
)
2053 error ("Dumping Emacs works only in batch mode");
2056 error ("Emacs can be dumped only once");
2060 /* Warn if the gap between BSS end and heap start is larger than this. */
2061 # define MAX_HEAP_BSS_DIFF (1024*1024)
2063 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2065 fprintf (stderr
, "**************************************************\n");
2066 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2067 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2069 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2070 fprintf (stderr
, "fail because of this. See the section about\n");
2071 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2072 fprintf (stderr
, "**************************************************\n");
2074 #endif /* GNU_LINUX */
2076 /* Bind `command-line-processed' to nil before dumping,
2077 so that the dumped Emacs will process its command line
2078 and set up to work with X windows if appropriate. */
2079 symbol
= intern ("command-line-processed");
2080 specbind (symbol
, Qnil
);
2082 CHECK_STRING (filename
);
2083 filename
= Fexpand_file_name (filename
, Qnil
);
2084 filename
= ENCODE_FILE (filename
);
2085 if (!NILP (symfile
))
2087 CHECK_STRING (symfile
);
2088 if (SCHARS (symfile
))
2090 symfile
= Fexpand_file_name (symfile
, Qnil
);
2091 symfile
= ENCODE_FILE (symfile
);
2096 Vpurify_flag
= Qnil
;
2099 /* Tell malloc where start of impure now is. */
2100 /* Also arrange for warnings when nearly out of space. */
2101 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2103 /* On Windows, this was done before dumping, and that once suffices.
2104 Meanwhile, my_edata is not valid on Windows. */
2105 memory_warnings (my_edata
, malloc_warning
);
2106 #endif /* not WINDOWSNT */
2107 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2108 #ifdef DOUG_LEA_MALLOC
2109 malloc_state_ptr
= malloc_get_state ();
2112 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2114 #ifdef DOUG_LEA_MALLOC
2115 free (malloc_state_ptr
);
2119 Vlibrary_cache
= Qnil
;
2121 #ifdef HAVE_WINDOW_SYSTEM
2122 reset_image_types ();
2127 return unbind_to (count
, Qnil
);
2130 #endif /* not CANNOT_DUMP */
2133 /* Recover from setlocale (LC_ALL, ""). */
2137 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2138 so that numbers are read and printed properly for Emacs Lisp. */
2139 setlocale (LC_NUMERIC
, "C");
2142 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2145 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2147 if (! EQ (*plocale
, desired_locale
))
2149 *plocale
= desired_locale
;
2150 setlocale (category
, (STRINGP (desired_locale
)
2151 ? SSDATA (desired_locale
)
2156 /* Set system time locale to match Vsystem_time_locale, if possible. */
2158 synchronize_system_time_locale (void)
2160 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2161 Vsystem_time_locale
);
2164 /* Set system messages locale to match Vsystem_messages_locale, if
2167 synchronize_system_messages_locale (void)
2170 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2171 Vsystem_messages_locale
);
2174 #endif /* HAVE_SETLOCALE */
2178 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2180 const char *path
, *p
;
2181 Lisp_Object lpath
, element
, tem
;
2182 /* Default is to use "." for empty path elements.
2183 But if argument EMPTY is true, use nil instead. */
2184 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2187 static const char *emacs_dir_env
= "%emacs_dir%/";
2188 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2189 const char *edir
= egetenv ("emacs_dir");
2190 char emacs_dir
[MAX_UTF8_PATH
];
2192 /* egetenv looks in process-environment, which holds the variables
2193 in their original system-locale encoding. We need emacs_dir to
2196 filename_from_ansi (edir
, emacs_dir
);
2199 /* It's okay to use getenv here, because this function is only used
2200 to initialize variables when Emacs starts up, and isn't called
2203 path
= getenv (evarname
);
2214 /* Ensure values from the environment use the proper directory separator. */
2220 char *path_utf8
, *q
, *d
;
2223 /* Convert each element of PATH to UTF-8. */
2224 p
= path_copy
= alloca (strlen (path
) + 1);
2225 strcpy (path_copy
, path
);
2226 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2229 q
= _mbschr (p
, SEPCHAR
);
2232 cnv_result
= filename_from_ansi (p
, d
);
2237 /* If conversion of this PATH elements fails, make sure
2238 destination pointer will stay put, thus effectively
2239 ignoring the offending element. */
2240 if (cnv_result
== 0)
2246 else if (cnv_result
!= 0 && d
> path_utf8
)
2247 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2249 path_copy
= path_utf8
;
2251 path_copy
= alloca (strlen (path
) + 1);
2252 strcpy (path_copy
, path
);
2254 dostounix_filename (path_copy
);
2261 p
= strchr (path
, SEPCHAR
);
2263 p
= path
+ strlen (path
);
2264 element
= (p
- path
? make_unibyte_string (path
, p
- path
)
2266 if (! NILP (element
))
2269 /* Relative file names in the default path are interpreted as
2270 being relative to $emacs_dir. */
2271 if (edir
&& defaulted
2272 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2273 element
= Fexpand_file_name (Fsubstring
2275 make_number (emacs_dir_len
),
2277 build_unibyte_string (emacs_dir
));
2280 /* Add /: to the front of the name
2281 if it would otherwise be treated as magic. */
2282 tem
= Ffind_file_name_handler (element
, Qt
);
2284 /* However, if the handler says "I'm safe",
2285 don't bother adding /:. */
2289 prop
= Fget (tem
, intern ("safe-magic"));
2296 AUTO_STRING (slash_colon
, "/:");
2297 element
= concat2 (slash_colon
, element
);
2299 } /* !NILP (element) */
2301 lpath
= Fcons (element
, lpath
);
2307 return Fnreverse (lpath
);
2310 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2311 doc
: /* Return non-nil if the current emacs process is a daemon.
2312 If the daemon was given a name argument, return that name. */)
2317 return build_string (daemon_name
);
2324 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2325 doc
: /* Mark the Emacs daemon as being initialized.
2326 This finishes the daemonization process by doing the other half of detaching
2327 from the parent process and its tty file descriptors. */)
2334 error ("This function can only be called if emacs is run as a daemon");
2336 if (daemon_pipe
[1] < 0)
2337 error ("The daemon has already been initialized");
2339 if (NILP (Vafter_init_time
))
2340 error ("This function can only be called after loading the init files");
2342 /* Get rid of stdin, stdout and stderr. */
2343 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2345 err
|= dup2 (nfd
, 0) < 0;
2346 err
|= dup2 (nfd
, 1) < 0;
2347 err
|= dup2 (nfd
, 2) < 0;
2348 err
|= emacs_close (nfd
) != 0;
2350 /* Closing the pipe will notify the parent that it can exit.
2351 FIXME: In case some other process inherited the pipe, closing it here
2352 won't notify the parent because it's still open elsewhere, so we
2353 additionally send a byte, just to make sure the parent really exits.
2354 Instead, we should probably close the pipe in start-process and
2355 call-process to make sure the pipe is never inherited by
2357 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2358 err
|= emacs_close (daemon_pipe
[1]) != 0;
2359 /* Set it to an invalid value so we know we've already run this function. */
2360 daemon_pipe
[1] = -1;
2363 error ("I/O error during daemon initialization");
2368 syms_of_emacs (void)
2370 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2371 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2372 DEFSYM (Qkill_emacs
, "kill-emacs");
2373 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2376 defsubr (&Sdump_emacs
);
2379 defsubr (&Skill_emacs
);
2381 defsubr (&Sinvocation_name
);
2382 defsubr (&Sinvocation_directory
);
2383 defsubr (&Sdaemonp
);
2384 defsubr (&Sdaemon_initialized
);
2386 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2387 doc
: /* Args passed by shell to Emacs, as a list of strings.
2388 Many arguments are deleted from the list as they are processed. */);
2390 DEFVAR_LISP ("system-type", Vsystem_type
,
2391 doc
: /* The value is a symbol indicating the type of operating system you are using.
2393 `gnu' compiled for a GNU Hurd system.
2394 `gnu/linux' compiled for a GNU/Linux system.
2395 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2396 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2397 `ms-dos' compiled as an MS-DOS application.
2398 `windows-nt' compiled as a native W32 application.
2399 `cygwin' compiled using the Cygwin library.
2400 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2401 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2402 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2403 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2405 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2406 doc
: /* Value is string indicating configuration Emacs was built for.
2407 On MS-Windows, the value reflects the OS flavor and version on which
2408 Emacs is running. */);
2409 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2411 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2412 doc
: /* String containing the configuration options Emacs was built with. */);
2413 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2415 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2416 doc
: /* String listing some of the main features this Emacs was compiled with.
2417 An element of the form \"FOO\" generally means that HAVE_FOO was
2418 defined during the build. */);
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
);