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>
32 #include <close-stream.h>
39 #include <sys/socket.h>
45 #if defined WINDOWSNT || defined HAVE_NTGUI
46 #include "w32select.h"
48 #include "w32common.h"
55 #ifdef HAVE_WINDOW_SYSTEM
57 #endif /* HAVE_WINDOW_SYSTEM */
59 #ifdef NS_IMPL_GNUSTEP
60 /* At least under Debian, GSConfig is in a subdirectory. --Stef */
61 #include <GNUstepBase/GSConfig.h>
65 #include "intervals.h"
66 #include "character.h"
72 #include "blockinput.h"
73 #include "syssignal.h"
76 #include "termhooks.h"
81 #include "composite.h"
82 #include "dispextern.h"
84 #include "sysselect.h"
91 #if (defined PROFILING \
92 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
93 # include <sys/gmon.h>
94 extern void moncontrol (int mode
);
101 #ifdef HAVE_SETRLIMIT
102 #include <sys/time.h>
103 #include <sys/resource.h>
106 #ifdef HAVE_PERSONALITY_LINUX32
107 #include <sys/personality.h>
110 static const char emacs_version
[] = PACKAGE_VERSION
;
111 static const char emacs_copyright
[] = COPYRIGHT
;
112 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
114 /* Empty lisp strings. To avoid having to build any others. */
115 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
118 /* Cache for externally loaded libraries. */
119 Lisp_Object Vlibrary_cache
;
122 /* Set after Emacs has started up the first time.
123 Prevents reinitialization of the Lisp world and keymaps
124 on subsequent starts. */
127 /* Set to true if this instance of Emacs might dump. */
131 extern void unexec_init_emacs_zone (void);
134 #ifdef DOUG_LEA_MALLOC
135 /* Preserves a pointer to the memory allocated that copies that
136 static data inside glibc's malloc. */
137 static void *malloc_state_ptr
;
138 /* From glibc, a routine that returns a copy of the malloc internal state. */
139 extern void *malloc_get_state (void);
140 /* From glibc, a routine that overwrites the malloc internal state. */
141 extern int malloc_set_state (void *);
142 /* True if the MALLOC_CHECK_ environment variable was set while
143 dumping. Used to work around a bug in glibc's malloc. */
144 static bool malloc_using_checking
;
145 #elif defined HAVE_PTHREAD && !defined SYSTEM_MALLOC
146 extern void malloc_enable_thread (void);
149 Lisp_Object Qfile_name_handler_alist
;
151 Lisp_Object Qrisky_local_variable
;
153 Lisp_Object Qkill_emacs
;
154 static Lisp_Object Qkill_emacs_hook
;
156 /* If true, Emacs should not attempt to use a window-specific code,
157 but instead should use the virtual terminal under which it was started. */
158 bool inhibit_window_system
;
160 /* If true, a filter or a sentinel is running. Tested to save the match
161 data on the first attempt to change it inside asynchronous code. */
162 bool running_asynch_code
;
164 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
165 /* If true, -d was specified, meaning we're using some window system. */
169 #if defined (DOUG_LEA_MALLOC) || defined (GNU_LINUX)
170 /* The address where the heap starts (from the first sbrk (0) call). */
171 static void *my_heap_start
;
175 /* The gap between BSS end and heap start as far as we can tell. */
176 static uprintmax_t heap_bss_diff
;
179 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
182 On Cocoa, CoreFoundation lib fails in forked process:
183 http://developer.apple.com/ReleaseNotes/
184 CoreFoundation/CoreFoundation.html)
186 On Windows, a Cygwin fork child cannot access the USER subsystem.
188 We mark being in the exec'd process by a daemon name argument of
189 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
190 NAME is the original daemon name, if any. */
191 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
192 # define DAEMON_MUST_EXEC
195 /* True means running Emacs without interactive terminal. */
198 /* True means remove site-lisp directories from load-path. */
201 /* Name for the server started by the daemon.*/
202 static char *daemon_name
;
204 /* Pipe used to send exit notification to the daemon parent at
208 /* Save argv and argc. */
212 static void sort_args (int argc
, char **argv
);
213 static void syms_of_emacs (void);
215 /* C99 needs each string to be at most 4095 characters, and the usage
216 strings below are split to not overflow this limit. */
217 static char const *const usage_message
[] =
220 Run Emacs, the extensible, customizable, self-documenting real-time\n\
221 display editor. The recommended way to start Emacs for normal editing\n\
222 is with no options at all.\n\
224 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
225 read the main documentation for these command-line arguments.\n\
227 Initialization options:\n\
231 --batch do not do interactive display; implies -q\n\
232 --chdir DIR change to directory DIR\n\
233 --daemon start a server in the background\n\
234 --debug-init enable Emacs Lisp debugger for init file\n\
235 --display, -d DISPLAY use X server DISPLAY\n\
238 --no-desktop do not load a saved desktop\n\
239 --no-init-file, -q load neither ~/.emacs nor default.el\n\
240 --no-shared-memory, -nl do not use shared memory\n\
241 --no-site-file do not load site-start.el\n\
242 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
243 --no-splash do not display a splash screen on startup\n\
244 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
247 --quick, -Q equivalent to:\n\
248 -q --no-site-file --no-site-lisp --no-splash\n\
249 --script FILE run FILE as an Emacs Lisp script\n\
250 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
251 --user, -u USER load ~USER/.emacs instead of your own\n\
257 FILE visit FILE using find-file\n\
258 +LINE go to line LINE in next FILE\n\
259 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
260 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
261 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
262 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
265 --file FILE visit FILE using find-file\n\
266 --find-file FILE visit FILE using find-file\n\
267 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
268 --insert FILE insert contents of FILE into current buffer\n\
269 --kill exit without asking for confirmation\n\
270 --load, -l FILE load Emacs Lisp FILE using the load function\n\
271 --visit FILE visit FILE using find-file\n\
277 --background-color, -bg COLOR window background color\n\
278 --basic-display, -D disable many display features;\n\
279 used for debugging Emacs\n\
280 --border-color, -bd COLOR main border color\n\
281 --border-width, -bw WIDTH width of main border\n\
284 --color, --color=MODE override color mode for character terminals;\n\
285 MODE defaults to `auto', and\n\
286 can also be `never', `always',\n\
287 or a mode name like `ansi8'\n\
288 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
289 --font, -fn FONT default font; must be fixed-width\n\
290 --foreground-color, -fg COLOR window foreground color\n\
293 --fullheight, -fh make the first frame high as the screen\n\
294 --fullscreen, -fs make the first frame fullscreen\n\
295 --fullwidth, -fw make the first frame wide as the screen\n\
296 --maximized, -mm make the first frame maximized\n\
297 --geometry, -g GEOMETRY window geometry\n\
300 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
301 --iconic start Emacs in iconified state\n\
302 --internal-border, -ib WIDTH width between text and main border\n\
303 --line-spacing, -lsp PIXELS additional space to put between lines\n\
304 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
305 --name NAME title for initial Emacs frame\n\
308 --no-blinking-cursor, -nbc disable blinking cursor\n\
309 --reverse-video, -r, -rv switch foreground and background\n\
310 --title, -T TITLE title for initial Emacs frame\n\
311 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
312 --xrm XRESOURCES set additional X resources\n\
313 --parent-id XID set parent window\n\
314 --help display this help and exit\n\
315 --version output version information and exit\n\
319 You can generally also specify long option names with a single -; for\n\
320 example, -batch as well as --batch. You can use any unambiguous\n\
321 abbreviation for a --option.\n\
323 Various environment variables and window system resources also affect\n\
324 the operation of Emacs. See the main documentation.\n\
326 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
327 section of the Emacs manual or the file BUGS.\n"
331 /* True if handling a fatal error already. */
332 bool fatal_error_in_progress
;
335 /* NS autrelease pool, for memory management. */
336 static void *ns_pool
;
341 setlocale (int cat
, char const *locale
)
348 /* Report a fatal error due to signal SIG, output a backtrace of at
349 most BACKTRACE_LIMIT lines, and exit. */
351 terminate_due_to_signal (int sig
, int backtrace_limit
)
353 signal (sig
, SIG_DFL
);
354 totally_unblock_input ();
356 /* If fatal error occurs in code below, avoid infinite recursion. */
357 if (! fatal_error_in_progress
)
359 fatal_error_in_progress
= 1;
361 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
362 Fkill_emacs (make_number (sig
));
364 shut_down_emacs (sig
, Qnil
);
365 emacs_backtrace (backtrace_limit
);
368 /* Signal the same code; this time it will really be fatal.
369 Since we're in a signal handler, the signal is blocked, so we
370 have to unblock it if we want to really receive it. */
374 sigemptyset (&unblocked
);
375 sigaddset (&unblocked
, sig
);
376 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
382 /* This shouldn't be executed, but it prevents a warning. */
386 /* Code for dealing with Lisp access to the Unix command line. */
389 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
392 Lisp_Object name
, dir
, handler
;
394 Lisp_Object raw_name
;
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 (build_string ("/:"), 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 (build_string ("/:"), 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
);
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
);
573 /* A valid but unlikely value for the TZ environment value.
574 It is OK (though a bit slower) if the user actually chooses this value. */
575 static char const dump_tz
[] = "UtC0";
578 /* Test whether the next argument in ARGV matches SSTR or a prefix of
579 LSTR (at least MINLEN characters). If so, then if VALPTR is non-null
580 (the argument is supposed to have a value) store in *VALPTR either
581 the next argument or the portion of this one after the equal sign.
582 ARGV is read starting at position *SKIPPTR; this index is advanced
583 by the number of arguments used.
585 Too bad we can't just use getopt for all of this, but we don't have
586 enough information to do it right. */
589 argmatch (char **argv
, int argc
, const char *sstr
, const char *lstr
,
590 int minlen
, char **valptr
, int *skipptr
)
596 /* Don't access argv[argc]; give up in advance. */
597 if (argc
<= *skipptr
+ 1)
600 arg
= argv
[*skipptr
+1];
603 if (strcmp (arg
, sstr
) == 0)
607 *valptr
= argv
[*skipptr
+2];
614 arglen
= (valptr
!= NULL
&& (p
= strchr (arg
, '=')) != NULL
615 ? p
- arg
: strlen (arg
));
616 if (lstr
== 0 || arglen
< minlen
|| strncmp (arg
, lstr
, arglen
) != 0)
618 else if (valptr
== NULL
)
629 else if (argv
[*skipptr
+2] != NULL
)
631 *valptr
= argv
[*skipptr
+2];
641 #ifdef DOUG_LEA_MALLOC
643 /* malloc can be invoked even before main (e.g. by the dynamic
644 linker), so the dumped malloc state must be restored as early as
645 possible using this special hook. */
648 malloc_initialize_hook (void)
652 if (!malloc_using_checking
)
653 /* Work around a bug in glibc's malloc. MALLOC_CHECK_ must be
654 ignored if the heap to be restored was constructed without
655 malloc checking. Can't use unsetenv, since that calls malloc. */
659 for (p
= environ
; p
&& *p
; p
++)
660 if (strncmp (*p
, "MALLOC_CHECK_=", 14) == 0)
669 malloc_set_state (malloc_state_ptr
);
670 free (malloc_state_ptr
);
674 if (my_heap_start
== 0)
675 my_heap_start
= sbrk (0);
676 malloc_using_checking
= getenv ("MALLOC_CHECK_") != NULL
;
680 void (*__malloc_initialize_hook
) (void) EXTERNALLY_VISIBLE
= malloc_initialize_hook
;
682 #endif /* DOUG_LEA_MALLOC */
684 /* Close standard output and standard error, reporting any write
685 errors as best we can. This is intended for use with atexit. */
687 close_output_streams (void)
689 if (close_stream (stdout
) != 0)
691 emacs_perror ("Write error to standard output");
692 _exit (EXIT_FAILURE
);
695 if (close_stream (stderr
) != 0)
696 _exit (EXIT_FAILURE
);
701 main (int argc
, char **argv
)
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;
720 #ifdef G_SLICE_ALWAYS_MALLOC
721 /* This is used by the Cygwin build. It's not needed starting with
722 cygwin-1.7.24, but it doesn't do any harm. */
723 xputenv ("G_SLICE=always-malloc");
727 might_dump
= !initialized
;
733 extern char my_endbss
[];
734 extern char *my_endbss_static
;
736 if (my_heap_start
== 0)
737 my_heap_start
= sbrk (0);
739 heap_bss_diff
= (char *)my_heap_start
- max (my_endbss
, my_endbss_static
);
743 #if defined WINDOWSNT || defined HAVE_NTGUI
744 /* Set global variables used to detect Windows version. Do this as
745 early as possible. (unexw32.c calls this function as well, but
746 the additional call here is harmless.) */
747 cache_system_info ();
749 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
750 to have non-stub implementations of APIs we need to convert file
751 names between UTF-8 and the system's ANSI codepage. */
752 maybe_load_unicows_dll ();
756 #ifdef RUN_TIME_REMAP
758 run_time_remap (argv
[0]);
761 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
764 unexec_init_emacs_zone ();
767 atexit (close_output_streams
);
769 /* Override Guile's libgc configuration. */
770 xputenv ("GC_ALL_INTERIOR_POINTERS=1");
773 sort_args (argc
, argv
);
775 while (argv
[argc
]) argc
++;
777 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
779 const char *version
, *copyright
;
782 Lisp_Object tem
, tem2
;
783 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
784 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
787 fprintf (stderr
, "Invalid value of `emacs-version'\n");
792 fprintf (stderr
, "Invalid value of `emacs-copyright'\n");
797 version
= SSDATA (tem
);
798 copyright
= SSDATA (tem2
);
803 version
= emacs_version
;
804 copyright
= emacs_copyright
;
806 printf ("GNU Emacs %s\n", version
);
807 printf ("%s\n", copyright
);
808 printf ("GNU Emacs comes with ABSOLUTELY NO WARRANTY.\n");
809 printf ("You may redistribute copies of Emacs\n");
810 printf ("under the terms of the GNU General Public License.\n");
811 printf ("For more information about these matters, ");
812 printf ("see the file named COPYING.\n");
816 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
819 /* argv[] array is kept in its original ANSI codepage encoding,
820 we need to convert to UTF-8, for chdir to work. */
821 char newdir
[MAX_UTF8_PATH
];
823 filename_from_ansi (ch_to_dir
, newdir
);
826 original_pwd
= get_current_dir_name ();
827 if (chdir (ch_to_dir
) != 0)
829 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
830 argv
[0], ch_to_dir
, strerror (errno
));
835 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
836 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
838 #ifdef HAVE_PERSONALITY_LINUX32
839 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
841 /* Set this so we only do this once. */
842 xputenv ("EMACS_HEAP_EXEC=true");
844 /* A flag to turn off address randomization which is introduced
845 in linux kernel shipped with fedora core 4 */
846 #define ADD_NO_RANDOMIZE 0x0040000
847 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
848 #undef ADD_NO_RANDOMIZE
850 execvp (argv
[0], argv
);
852 /* If the exec fails, try to dump anyway. */
853 emacs_perror (argv
[0]);
855 #endif /* HAVE_PERSONALITY_LINUX32 */
857 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK)
858 /* Extend the stack space available.
859 Don't do that if dumping, since some systems (e.g. DJGPP)
860 might define a smaller stack limit at that time. */
863 && (!noninteractive
|| initialized
)
865 && !getrlimit (RLIMIT_STACK
, &rlim
))
868 extern size_t re_max_failures
;
869 /* Approximate the amount regex.c needs per unit of re_max_failures. */
870 int ratio
= 20 * sizeof (char *);
871 /* Then add 33% to cover the size of the smaller stacks that regex.c
872 successively allocates and discards, on its way to the maximum. */
874 /* Add in some extra to cover
875 what we're likely to use for other reasons. */
876 newlim
= re_max_failures
* ratio
+ 200000;
878 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
879 stack allocation routine for new process that the allocation
880 fails if stack limit is not on page boundary. So, round up the
881 new limit to page boundary. */
882 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
884 if (newlim
> rlim
.rlim_max
)
886 newlim
= rlim
.rlim_max
;
887 /* Don't let regex.c overflow the stack we have. */
888 re_max_failures
= (newlim
- 200000) / ratio
;
890 if (rlim
.rlim_cur
< newlim
)
891 rlim
.rlim_cur
= newlim
;
893 setrlimit (RLIMIT_STACK
, &rlim
);
895 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK */
899 #ifndef SYSTEM_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 */
909 #if defined (MSDOS) || defined (WINDOWSNT)
910 /* We do all file input/output as binary files. When we need to translate
911 newlines, we do that manually. */
913 #endif /* MSDOS || WINDOWSNT */
916 if (!isatty (fileno (stdin
)))
917 setmode (fileno (stdin
), O_BINARY
);
918 if (!isatty (fileno (stdout
)))
921 setmode (fileno (stdout
), O_BINARY
);
925 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
926 The build procedure uses this while dumping, to ensure that the
927 dumped Emacs does not have its system locale tables initialized,
928 as that might cause screwups when the dumped Emacs starts up. */
930 char *lc_all
= getenv ("LC_ALL");
931 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
934 /* Set locale now, so that initial error messages are localized properly.
935 fixup_locale must wait until later, since it builds strings. */
936 if (do_initial_setlocale
)
937 setlocale (LC_ALL
, "");
939 inhibit_window_system
= 0;
941 /* Handle the -t switch, which specifies filename to use as terminal. */
945 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
950 result
= emacs_open (term
, O_RDWR
, 0);
951 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
953 char *errstring
= strerror (errno
);
954 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
959 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
962 fprintf (stderr
, "Using %s\n", term
);
963 #ifdef HAVE_WINDOW_SYSTEM
964 inhibit_window_system
= 1; /* -t => -nw */
971 /* Command line option --no-windows is deprecated and thus not mentioned
972 in the manual and usage information. */
973 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
974 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
975 inhibit_window_system
= 1;
977 /* Handle the -batch switch, which means don't do interactive display. */
979 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
982 Vundo_outer_limit
= Qnil
;
984 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
986 noninteractive
= 1; /* Set batch mode. */
987 /* Convert --script to -scriptload, un-skip it, and sort again
988 so that it will be handled in proper sequence. */
989 /* FIXME broken for --script=FILE - is that supposed to work? */
990 argv
[skip_args
- 1] = (char *) "-scriptload";
992 sort_args (argc
, argv
);
995 /* Handle the --help option, which gives a usage message. */
996 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
999 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
1000 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
1001 fputs (usage_message
[i
], stdout
);
1005 /* Make sure IS_DAEMON starts up as false. */
1008 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
1009 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
1014 /* Start as a daemon: fork a new child process which will run the
1015 rest of the initialization code, then exit.
1017 Detaching a daemon requires the following steps:
1021 - close the tty file-descriptors
1023 We only want to do the last 2 steps once the daemon is ready to
1024 serve requests, i.e. after loading .emacs (initialization).
1025 OTOH initialization may start subprocesses (e.g. ispell) and these
1026 should be run from the proper process (the one that will end up
1027 running as daemon) and with the proper "session id" in order for
1028 them to keep working after detaching, so fork and setsid need to be
1029 performed before initialization.
1031 We want to avoid exiting before the server socket is ready, so
1032 use a pipe for synchronization. The parent waits for the child
1033 to close its end of the pipe (using `daemon-initialized')
1035 if (emacs_pipe (daemon_pipe
) != 0)
1037 fprintf (stderr
, "Cannot pipe!\n");
1041 #ifndef DAEMON_MUST_EXEC
1043 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
1044 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1045 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1046 #endif /* USE_GTK */
1048 #else /* DAEMON_MUST_EXEC */
1049 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1050 f
= fork (); /* in orig */
1052 f
= 0; /* in exec'd */
1053 #endif /* !DAEMON_MUST_EXEC */
1059 /* Close unused writing end of the pipe. */
1060 emacs_close (daemon_pipe
[1]);
1062 /* Just wait for the child to close its end of the pipe. */
1065 retval
= read (daemon_pipe
[0], &buf
, 1);
1067 while (retval
== -1 && errno
== EINTR
);
1071 fprintf (stderr
, "Error reading status from child\n");
1074 else if (retval
== 0)
1076 fprintf (stderr
, "Error: server did not start correctly\n");
1080 emacs_close (daemon_pipe
[0]);
1085 emacs_perror ("fork");
1086 exit (EXIT_CANCELED
);
1089 #ifdef DAEMON_MUST_EXEC
1091 /* In orig process, forked as child, OR in exec'd. */
1092 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1093 { /* In orig, child: now exec w/special daemon name. */
1096 snprintf (fdStr
, sizeof fdStr
,
1097 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1098 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1100 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1102 fprintf (stderr
, "daemon: child name too long\n");
1103 exit (EXIT_CANNOT_INVOKE
);
1106 argv
[skip_args
] = fdStr
;
1108 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1109 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1110 execvp (argv
[0], argv
);
1111 emacs_perror (argv
[0]);
1112 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1115 /* In exec'd: parse special dname into pipe and name info. */
1116 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1117 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1119 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1120 exit (EXIT_CANNOT_INVOKE
);
1122 dname_arg2
[0] = '\0';
1123 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1125 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1126 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1128 #endif /* DAEMON_MUST_EXEC */
1131 daemon_name
= xstrdup (dname_arg
);
1132 /* Close unused reading end of the pipe. */
1133 emacs_close (daemon_pipe
[0]);
1137 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1142 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC && !defined DOUG_LEA_MALLOC
1143 # ifndef CANNOT_DUMP
1144 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1145 that causes an infinite recursive loop with FreeBSD. But do make
1146 it thread-safe when creating emacs, otherwise bootstrap-emacs
1147 fails on Cygwin. See Bug#14569. */
1148 if (!noninteractive
|| initialized
)
1150 malloc_enable_thread ();
1153 init_signals (dumping
);
1155 noninteractive1
= noninteractive
;
1157 /* Perform basic initializations (not merely interning symbols). */
1165 init_charset_once ();
1166 init_coding_once ();
1167 init_syntax_once (); /* Create standard syntax table. */
1168 init_category_once (); /* Create standard category table. */
1169 init_casetab_once (); /* Must be done before init_buffer_once. */
1170 init_buffer_once (); /* Create buffer table and some buffers. */
1171 init_minibuf_once (); /* Create list of minibuffers. */
1172 /* Must precede init_window_once. */
1174 /* Call syms_of_xfaces before init_window_once because that
1175 function creates Vterminal_frame. Termcap frames now use
1176 faces, and the face implementation uses some symbols as
1179 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1180 be better to arrange things not to have this dependency. */
1182 /* Call syms_of_keyboard before init_window_once because
1183 keyboard sets up symbols that include some face names that
1184 the X support will want to use. This can happen when
1185 CANNOT_DUMP is defined. */
1186 syms_of_keyboard ();
1188 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1190 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1192 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1194 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1196 /* Before syms_of_coding because it initializes Qcharsetp. */
1198 /* Before init_window_once, because it sets up the
1199 Vcoding_system_hash_table. */
1200 syms_of_coding (); /* This should be after syms_of_fileio. */
1202 init_window_once (); /* Init the window system. */
1203 #ifdef HAVE_WINDOW_SYSTEM
1204 init_fringe_once (); /* Swap bitmaps if necessary. */
1205 #endif /* HAVE_WINDOW_SYSTEM */
1210 if (do_initial_setlocale
)
1213 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1214 Vsystem_time_locale
= Vprevious_system_time_locale
;
1219 running_asynch_code
= 0;
1223 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1226 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1229 ns_pool
= ns_alloc_autorelease_pool ();
1230 #ifdef NS_IMPL_GNUSTEP
1231 /* GNUstep stupidly resets our locale settings after we made them. */
1235 if (!noninteractive
)
1237 #ifdef NS_IMPL_COCOA
1238 /* Started from GUI? */
1239 /* FIXME: Do the right thing if getenv returns NULL, or if
1241 if (! inhibit_window_system
&& ! isatty (0))
1242 chdir (getenv ("HOME"));
1243 if (skip_args
< argc
)
1245 if (!strncmp (argv
[skip_args
], "-psn", 4))
1248 chdir (getenv ("HOME"));
1250 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1253 chdir (getenv ("HOME"));
1258 #endif /* HAVE_NS */
1260 #ifdef HAVE_X_WINDOWS
1261 /* Stupid kludge to catch command-line display spec. We can't
1262 handle this argument entirely in window system dependent code
1263 because we don't even know which window system dependent code
1264 to run until we've recognized this argument. */
1266 char *displayname
= 0;
1267 int count_before
= skip_args
;
1269 /* Skip any number of -d options, but only use the last one. */
1272 int count_before_this
= skip_args
;
1274 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1276 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1281 count_before
= count_before_this
;
1284 /* If we have the form --display=NAME,
1285 convert it into -d name.
1286 This requires inserting a new element into argv. */
1287 if (displayname
&& count_before
< skip_args
)
1289 if (skip_args
== count_before
+ 1)
1291 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1292 (argc
- (count_before
+ 2)) * sizeof *argv
);
1293 argv
[count_before
+ 2] = displayname
;
1296 argv
[count_before
+ 1] = (char *) "-d";
1301 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1302 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1306 /* Don't actually discard this arg. */
1307 skip_args
= count_before
;
1309 #else /* !HAVE_X_WINDOWS */
1312 int count_before
= skip_args
;
1314 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1315 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1318 skip_args
= count_before
;
1322 /* argmatch must not be used after here,
1323 except when building temacs
1324 because the -d argument has not been skipped in skip_args. */
1327 /* Call early 'cause init_environment needs it. */
1329 /* Set defaults for several environment variables. */
1331 init_environment (argc
, argv
, skip_args
);
1336 #ifdef HAVE_GFILENOTIFY
1337 globals_of_gfilenotify ();
1342 #ifdef HAVE_W32NOTIFY
1343 globals_of_w32notify ();
1345 /* Initialize environment from registry settings. */
1346 init_environment (argv
);
1347 init_ntproc (dumping
); /* must precede init_editfns. */
1350 /* Initialize and GC-protect Vinitial_environment and
1351 Vprocess_environment before set_initial_environment fills them
1354 syms_of_callproc ();
1355 /* egetenv is a pretty low-level facility, which may get called in
1356 many circumstances; it seems flimsy to put off initializing it
1357 until calling init_callproc. Do not do it when dumping. */
1359 set_initial_environment ();
1361 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1362 if this is not done. Do it after set_global_environment so that we
1363 don't pollute Vglobal_environment. */
1364 /* Setting LANG here will defeat the startup locale processing... */
1369 /* Init buffer storage and default directory of main buffer. */
1370 init_buffer (initialized
);
1372 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1374 /* Must precede init_lread. */
1375 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1379 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1380 Lisp_Object old_log_max
;
1381 old_log_max
= Vmessage_log_max
;
1382 XSETFASTINT (Vmessage_log_max
, 0);
1383 message_dolog ("", 0, 1, 0);
1384 Vmessage_log_max
= old_log_max
;
1387 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1391 /* Check to see if Emacs has been installed correctly. */
1392 check_windows_init_file ();
1395 /* Intern the names of all standard functions and variables;
1396 define standard keys. */
1400 /* The basic levels of Lisp must come first. Note that
1401 syms_of_data and some others have already been called. */
1406 syms_of_floatfns ();
1409 syms_of_bytecode ();
1411 syms_of_casefiddle ();
1413 syms_of_category ();
1415 syms_of_character ();
1422 syms_of_filelock ();
1425 /* syms_of_keymap (); */
1433 syms_of_terminal ();
1439 syms_of_textprop ();
1440 syms_of_composite ();
1443 #endif /* WINDOWSNT */
1450 #ifdef HAVE_WINDOW_SYSTEM
1453 #endif /* HAVE_WINDOW_SYSTEM */
1454 #ifdef HAVE_X_WINDOWS
1459 syms_of_xsettings ();
1466 #endif /* HAVE_X_WINDOWS */
1473 syms_of_decompress ();
1483 #endif /* HAVE_NTGUI */
1485 #if defined WINDOWSNT || defined HAVE_NTGUI
1486 syms_of_w32select ();
1493 syms_of_win16select ();
1500 syms_of_nsselect ();
1502 #endif /* HAVE_NS */
1508 #ifdef HAVE_GFILENOTIFY
1509 syms_of_gfilenotify ();
1510 #endif /* HAVE_GFILENOTIFY */
1514 #endif /* HAVE_INOTIFY */
1517 syms_of_dbusbind ();
1518 #endif /* HAVE_DBUS */
1522 #ifdef HAVE_W32NOTIFY
1523 syms_of_w32notify ();
1524 #endif /* HAVE_W32NOTIFY */
1525 #endif /* WINDOWSNT */
1527 syms_of_profiler ();
1529 keys_of_casefiddle ();
1532 keys_of_keyboard ();
1538 /* Initialization that must be done even if the global variable
1539 initialized is non zero. */
1541 globals_of_w32font ();
1542 globals_of_w32fns ();
1543 globals_of_w32menu ();
1544 #endif /* HAVE_NTGUI */
1546 #if defined WINDOWSNT || defined HAVE_NTGUI
1547 globals_of_w32select ();
1553 init_editfns (); /* init_process_emacs uses Voperating_system_release. */
1554 init_process_emacs (); /* init_display uses add_keyboard_wait_descriptor. */
1555 init_keyboard (); /* This too must precede init_sys_modes. */
1556 if (!noninteractive
)
1557 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1560 init_crit (); /* w32notify.c needs this in batch mode. */
1561 #endif /* HAVE_W32NOTIFY */
1563 #ifdef HAVE_WINDOW_SYSTEM
1565 #endif /* HAVE_WINDOW_SYSTEM */
1573 /* Handle -l loadup, args passed by Makefile. */
1574 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1577 char file_utf8
[MAX_UTF8_PATH
];
1579 if (filename_from_ansi (file
, file_utf8
) == 0)
1582 Vtop_level
= list2 (intern_c_string ("load"),
1583 build_unibyte_string (file
));
1585 /* Unless next switch is -nl, load "loadup.el" first thing. */
1587 Vtop_level
= list2 (intern_c_string ("load"),
1588 build_string ("loadup.el"));
1595 /* If the execution TZ happens to be the same as the dump TZ,
1596 change it to some other value and then change it back,
1597 to force the underlying implementation to reload the TZ info.
1598 This is needed on implementations that load TZ info from files,
1599 since the TZ file contents may differ between dump and execution. */
1600 char *tz
= getenv ("TZ");
1601 if (tz
&& !strcmp (tz
, dump_tz
))
1611 /* Set up for profiling. This is known to work on FreeBSD,
1612 GNU/Linux and MinGW. It might work on some other systems too.
1613 Give it a try and tell us if it works on your system. To compile
1614 for profiling, use the configure option --enable-profiling. */
1615 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1620 extern unsigned char etext
asm ("etext");
1626 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1635 #ifdef LOCALTIME_CACHE
1636 /* Some versions of localtime have a bug. They cache the value of the time
1637 zone rather than looking it up every time. Since localtime() is
1638 called to bolt the undumping time into the undumped emacs, this
1639 results in localtime ignoring the TZ environment variable.
1640 This flushes the new TZ value into localtime. */
1642 #endif /* defined (LOCALTIME_CACHE) */
1644 /* Enter editor command loop. This never returns. */
1650 /* Sort the args so we can find the most important ones
1651 at the beginning of argv. */
1653 /* First, here's a table of all the standard options. */
1655 struct standard_args
1658 const char *longname
;
1663 static const struct standard_args standard_args
[] =
1665 { "-version", "--version", 150, 0 },
1666 { "-chdir", "--chdir", 130, 1 },
1667 { "-t", "--terminal", 120, 1 },
1668 { "-nw", "--no-window-system", 110, 0 },
1669 { "-nw", "--no-windows", 110, 0 },
1670 { "-batch", "--batch", 100, 0 },
1671 { "-script", "--script", 100, 1 },
1672 { "-daemon", "--daemon", 99, 0 },
1673 { "-help", "--help", 90, 0 },
1674 { "-nl", "--no-loadup", 70, 0 },
1675 { "-nsl", "--no-site-lisp", 65, 0 },
1676 /* -d must come last before the options handled in startup.el. */
1677 { "-d", "--display", 60, 1 },
1678 { "-display", 0, 60, 1 },
1679 /* Now for the options handled in `command-line' (startup.el). */
1680 /* (Note that to imply -nsl, -Q is partially handled here.) */
1681 { "-Q", "--quick", 55, 0 },
1682 { "-quick", 0, 55, 0 },
1683 { "-q", "--no-init-file", 50, 0 },
1684 { "-no-init-file", 0, 50, 0 },
1685 { "-no-site-file", "--no-site-file", 40, 0 },
1686 { "-u", "--user", 30, 1 },
1687 { "-user", 0, 30, 1 },
1688 { "-debug-init", "--debug-init", 20, 0 },
1689 { "-iconic", "--iconic", 15, 0 },
1690 { "-D", "--basic-display", 12, 0},
1691 { "-basic-display", 0, 12, 0},
1692 { "-nbc", "--no-blinking-cursor", 12, 0 },
1693 /* Now for the options handled in `command-line-1' (startup.el). */
1694 { "-nbi", "--no-bitmap-icon", 10, 0 },
1695 { "-bg", "--background-color", 10, 1 },
1696 { "-background", 0, 10, 1 },
1697 { "-fg", "--foreground-color", 10, 1 },
1698 { "-foreground", 0, 10, 1 },
1699 { "-bd", "--border-color", 10, 1 },
1700 { "-bw", "--border-width", 10, 1 },
1701 { "-ib", "--internal-border", 10, 1 },
1702 { "-ms", "--mouse-color", 10, 1 },
1703 { "-cr", "--cursor-color", 10, 1 },
1704 { "-fn", "--font", 10, 1 },
1705 { "-font", 0, 10, 1 },
1706 { "-fs", "--fullscreen", 10, 0 },
1707 { "-fw", "--fullwidth", 10, 0 },
1708 { "-fh", "--fullheight", 10, 0 },
1709 { "-mm", "--maximized", 10, 0 },
1710 { "-g", "--geometry", 10, 1 },
1711 { "-geometry", 0, 10, 1 },
1712 { "-T", "--title", 10, 1 },
1713 { "-title", 0, 10, 1 },
1714 { "-name", "--name", 10, 1 },
1715 { "-xrm", "--xrm", 10, 1 },
1716 { "-parent-id", "--parent-id", 10, 1 },
1717 { "-r", "--reverse-video", 5, 0 },
1719 { "-reverse", 0, 5, 0 },
1720 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1721 { "-vb", "--vertical-scroll-bars", 5, 0 },
1722 { "-color", "--color", 5, 0},
1723 { "-no-splash", "--no-splash", 3, 0 },
1724 { "-no-desktop", "--no-desktop", 3, 0 },
1726 { "-NSAutoLaunch", 0, 5, 1 },
1727 { "-NXAutoLaunch", 0, 5, 1 },
1728 { "-_NSMachLaunch", 0, 85, 1 },
1729 { "-MachLaunch", 0, 85, 1 },
1730 { "-macosx", 0, 85, 0 },
1731 { "-NSHost", 0, 85, 1 },
1733 /* These have the same priority as ordinary file name args,
1734 so they are not reordered with respect to those. */
1735 { "-L", "--directory", 0, 1 },
1736 { "-directory", 0, 0, 1 },
1737 { "-l", "--load", 0, 1 },
1738 { "-load", 0, 0, 1 },
1739 /* This has no longname, because using --scriptload confuses sort_args,
1740 because then the --script long option seems to match twice; ie
1741 you can't have a long option which is a prefix of another long
1742 option. In any case, this is entirely an internal option. */
1743 { "-scriptload", NULL
, 0, 1 },
1744 { "-f", "--funcall", 0, 1 },
1745 { "-funcall", 0, 0, 1 },
1746 { "-eval", "--eval", 0, 1 },
1747 { "-execute", "--execute", 0, 1 },
1748 { "-find-file", "--find-file", 0, 1 },
1749 { "-visit", "--visit", 0, 1 },
1750 { "-file", "--file", 0, 1 },
1751 { "-insert", "--insert", 0, 1 },
1753 { "-NXOpen", 0, 0, 1 },
1754 { "-NXOpenTemp", 0, 0, 1 },
1755 { "-NSOpen", 0, 0, 1 },
1756 { "-NSOpenTemp", 0, 0, 1 },
1757 { "-GSFilePath", 0, 0, 1 },
1759 /* This should be processed after ordinary file name args and the like. */
1760 { "-kill", "--kill", -10, 0 },
1763 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1764 so that the highest priority ones come first.
1765 Do not change the order of elements of equal priority.
1766 If an option takes an argument, keep it and its argument together.
1768 If an option that takes no argument appears more
1769 than once, eliminate all but one copy of it. */
1772 sort_args (int argc
, char **argv
)
1774 char **new = xmalloc (argc
* sizeof *new);
1775 /* For each element of argv,
1776 the corresponding element of options is:
1777 0 for an option that takes no arguments,
1778 1 for an option that takes one argument, etc.
1779 -1 for an ordinary non-option argument. */
1780 int *options
= xnmalloc_atomic (argc
, sizeof *options
);
1781 int *priority
= xnmalloc_atomic (argc
, sizeof *priority
);
1783 int incoming_used
= 1;
1787 /* Categorize all the options,
1788 and figure out which argv elts are option arguments. */
1789 for (from
= 1; from
< argc
; from
++)
1793 if (argv
[from
][0] == '-')
1797 /* If we have found "--", don't consider
1798 any more arguments as options. */
1799 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1801 /* Leave the "--", and everything following it, at the end. */
1802 for (; from
< argc
; from
++)
1804 priority
[from
] = -100;
1810 /* Look for a match with a known old-fashioned option. */
1811 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1812 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1814 options
[from
] = standard_args
[i
].nargs
;
1815 priority
[from
] = standard_args
[i
].priority
;
1816 if (from
+ standard_args
[i
].nargs
>= argc
)
1817 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1818 from
+= standard_args
[i
].nargs
;
1822 /* Look for a match with a known long option.
1823 MATCH is -1 if no match so far, -2 if two or more matches so far,
1824 >= 0 (the table index of the match) if just one match so far. */
1825 if (argv
[from
][1] == '-')
1827 char const *equals
= strchr (argv
[from
], '=');
1829 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1833 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1834 if (standard_args
[i
].longname
1835 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1844 /* If we found exactly one match, use that. */
1847 options
[from
] = standard_args
[match
].nargs
;
1848 priority
[from
] = standard_args
[match
].priority
;
1849 /* If --OPTION=VALUE syntax is used,
1850 this option uses just one argv element. */
1853 if (from
+ options
[from
] >= argc
)
1854 fatal ("Option `%s' requires an argument\n", argv
[from
]);
1855 from
+= options
[from
];
1857 /* FIXME When match < 0, shouldn't there be some error,
1858 or at least indication to the user that there was a
1865 /* Copy the arguments, in order of decreasing priority, to NEW. */
1867 while (incoming_used
< argc
)
1870 int best_priority
= -9999;
1872 /* Find the highest priority remaining option.
1873 If several have equal priority, take the first of them. */
1874 for (from
= 1; from
< argc
; from
++)
1876 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1878 best_priority
= priority
[from
];
1881 /* Skip option arguments--they are tied to the options. */
1882 if (options
[from
] > 0)
1883 from
+= options
[from
];
1889 /* Copy the highest priority remaining option, with its args, to NEW.
1890 Unless it is a duplicate of the previous one. */
1891 if (! (options
[best
] == 0
1892 && ! strcmp (new[to
- 1], argv
[best
])))
1894 new[to
++] = argv
[best
];
1895 for (i
= 0; i
< options
[best
]; i
++)
1896 new[to
++] = argv
[best
+ i
+ 1];
1899 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1901 /* Clear out this option in ARGV. */
1903 for (i
= 0; i
< options
[best
]; i
++)
1904 argv
[best
+ i
+ 1] = 0;
1907 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1911 memcpy (argv
, new, sizeof (char *) * argc
);
1918 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1919 doc
: /* Exit the Emacs job and kill it.
1920 If ARG is an integer, return ARG as the exit program code.
1921 If ARG is a string, stuff it as keyboard input.
1923 This function is called upon receipt of the signals SIGTERM
1924 or SIGHUP, and upon SIGINT in batch mode.
1926 The value of `kill-emacs-hook', if not void,
1927 is a list of functions (of no args),
1928 all of which are called before Emacs is actually killed. */)
1931 struct gcpro gcpro1
;
1939 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1941 waiting_for_input
= 0;
1942 Frun_hooks (1, &Qkill_emacs_hook
);
1945 #ifdef HAVE_X_WINDOWS
1946 /* Transfer any clipboards we own to the clipboard manager. */
1947 x_clipboard_manager_save_all ();
1950 shut_down_emacs (0, STRINGP (arg
) ? arg
: Qnil
);
1953 ns_release_autorelease_pool (ns_pool
);
1956 /* If we have an auto-save list file,
1957 kill it because we are exiting Emacs deliberately (not crashing).
1958 Do it after shut_down_emacs, which does an auto-save. */
1959 if (STRINGP (Vauto_save_list_file_name
))
1961 Lisp_Object listfile
;
1962 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1963 unlink (SSDATA (listfile
));
1967 exit_code
= (XINT (arg
) < 0
1968 ? XINT (arg
) | INT_MIN
1969 : XINT (arg
) & INT_MAX
);
1971 exit_code
= EXIT_SUCCESS
;
1976 /* Perform an orderly shutdown of Emacs. Autosave any modified
1977 buffers, kill any child processes, clean up the terminal modes (if
1978 we're in the foreground), and other stuff like that. Don't perform
1979 any redisplay; this may be called when Emacs is shutting down in
1980 the background, or after its X connection has died.
1982 If SIG is a signal number, print a message for it.
1984 This is called by fatal signal handlers, X protocol error handlers,
1988 shut_down_emacs (int sig
, Lisp_Object stuff
)
1990 /* Prevent running of hooks from now on. */
1993 /* Don't update display from now on. */
1994 Vinhibit_redisplay
= Qt
;
1996 /* If we are controlling the terminal, reset terminal modes. */
1999 pid_t pgrp
= getpgrp ();
2000 pid_t tpgrp
= tcgetpgrp (0);
2001 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
2003 reset_all_sys_modes ();
2004 if (sig
&& sig
!= SIGTERM
)
2006 static char const format
[] = "Fatal error %d: ";
2007 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
2008 int buflen
= sprintf (buf
, format
, sig
);
2009 char const *sig_desc
= safe_strsignal (sig
);
2010 emacs_write (STDERR_FILENO
, buf
, buflen
);
2011 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
2017 reset_all_sys_modes ();
2020 stuff_buffered_input (stuff
);
2022 inhibit_sentinels
= 1;
2023 kill_buffer_processes (Qnil
);
2024 Fdo_auto_save (Qt
, Qnil
);
2026 unlock_all_files ();
2028 /* There is a tendency for a SIGIO signal to arrive within exit,
2029 and cause a SIGHUP because the input descriptor is already closed. */
2033 /* Do this only if terminating normally, we want glyph matrices
2034 etc. in a core dump. */
2035 if (sig
== 0 || sig
== SIGTERM
)
2037 check_glyph_memory ();
2038 check_message_stack ();
2046 ns_term_shutdown (sig
);
2050 xml_cleanup_parser ();
2064 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2065 doc
: /* Dump current state of Emacs into executable file FILENAME.
2066 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2067 This is used in the file `loadup.el' when building Emacs.
2069 You must run Emacs in batch mode in order to dump it. */)
2070 (Lisp_Object filename
, Lisp_Object symfile
)
2078 if (! noninteractive
)
2079 error ("Dumping Emacs works only in batch mode");
2082 error ("Emacs can be dumped only once");
2086 /* Warn if the gap between BSS end and heap start is larger than this. */
2087 # define MAX_HEAP_BSS_DIFF (1024*1024)
2089 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2091 fprintf (stderr
, "**************************************************\n");
2092 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2093 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2095 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2096 fprintf (stderr
, "fail because of this. See the section about\n");
2097 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2098 fprintf (stderr
, "**************************************************\n");
2100 #endif /* GNU_LINUX */
2102 /* Bind `command-line-processed' to nil before dumping,
2103 so that the dumped Emacs will process its command line
2104 and set up to work with X windows if appropriate. */
2105 symbol
= intern ("command-line-processed");
2106 specbind (symbol
, Qnil
);
2108 CHECK_STRING (filename
);
2109 filename
= Fexpand_file_name (filename
, Qnil
);
2110 filename
= ENCODE_FILE (filename
);
2111 if (!NILP (symfile
))
2113 CHECK_STRING (symfile
);
2114 if (SCHARS (symfile
))
2116 symfile
= Fexpand_file_name (symfile
, Qnil
);
2117 symfile
= ENCODE_FILE (symfile
);
2122 Vpurify_flag
= Qnil
;
2125 set_time_zone_rule (dump_tz
);
2126 #ifndef LOCALTIME_CACHE
2127 /* Force a tz reload, since set_time_zone_rule doesn't. */
2133 /* Tell malloc where start of impure now is. */
2134 /* Also arrange for warnings when nearly out of space. */
2135 #ifndef SYSTEM_MALLOC
2137 /* On Windows, this was done before dumping, and that once suffices.
2138 Meanwhile, my_edata is not valid on Windows. */
2140 extern char my_edata
[];
2141 memory_warnings (my_edata
, malloc_warning
);
2143 #endif /* not WINDOWSNT */
2144 #endif /* not SYSTEM_MALLOC */
2145 #ifdef DOUG_LEA_MALLOC
2146 malloc_state_ptr
= malloc_get_state ();
2149 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2151 #ifdef DOUG_LEA_MALLOC
2152 free (malloc_state_ptr
);
2156 Vlibrary_cache
= Qnil
;
2158 #ifdef HAVE_WINDOW_SYSTEM
2159 reset_image_types ();
2168 #endif /* not CANNOT_DUMP */
2171 /* Recover from setlocale (LC_ALL, ""). */
2175 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2176 so that numbers are read and printed properly for Emacs Lisp. */
2177 setlocale (LC_NUMERIC
, "C");
2180 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2183 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2185 if (! EQ (*plocale
, desired_locale
))
2187 *plocale
= desired_locale
;
2188 setlocale (category
, (STRINGP (desired_locale
)
2189 ? SSDATA (desired_locale
)
2194 /* Set system time locale to match Vsystem_time_locale, if possible. */
2196 synchronize_system_time_locale (void)
2198 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2199 Vsystem_time_locale
);
2202 /* Set system messages locale to match Vsystem_messages_locale, if
2205 synchronize_system_messages_locale (void)
2208 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2209 Vsystem_messages_locale
);
2212 #endif /* HAVE_SETLOCALE */
2216 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2218 const char *path
, *p
;
2219 Lisp_Object lpath
, element
, tem
;
2220 /* Default is to use "." for empty path elements.
2221 But if argument EMPTY is true, use nil instead. */
2222 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2225 static const char *emacs_dir_env
= "%emacs_dir%/";
2226 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2227 const char *edir
= egetenv ("emacs_dir");
2228 char emacs_dir
[MAX_UTF8_PATH
];
2230 /* egetenv looks in process-environment, which holds the variables
2231 in their original system-locale encoding. We need emacs_dir to
2234 filename_from_ansi (edir
, emacs_dir
);
2237 /* It's okay to use getenv here, because this function is only used
2238 to initialize variables when Emacs starts up, and isn't called
2241 path
= getenv (evarname
);
2252 /* Ensure values from the environment use the proper directory separator. */
2258 char *path_utf8
, *q
, *d
;
2261 /* Convert each element of PATH to UTF-8. */
2262 p
= path_copy
= alloca (strlen (path
) + 1);
2263 strcpy (path_copy
, path
);
2264 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2267 q
= _mbschr (p
, SEPCHAR
);
2270 cnv_result
= filename_from_ansi (p
, d
);
2275 /* If conversion of this PATH elements fails, make sure
2276 destination pointer will stay put, thus effectively
2277 ignoring the offending element. */
2278 if (cnv_result
== 0)
2284 else if (cnv_result
!= 0 && d
> path_utf8
)
2285 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2287 path_copy
= path_utf8
;
2289 path_copy
= alloca (strlen (path
) + 1);
2290 strcpy (path_copy
, path
);
2292 dostounix_filename (path_copy
);
2299 p
= strchr (path
, SEPCHAR
);
2301 p
= path
+ strlen (path
);
2302 element
= (p
- path
? make_unibyte_string (path
, p
- path
)
2304 if (! NILP (element
))
2307 /* Relative file names in the default path are interpreted as
2308 being relative to $emacs_dir. */
2309 if (edir
&& defaulted
2310 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2311 element
= Fexpand_file_name (Fsubstring
2313 make_number (emacs_dir_len
),
2315 build_unibyte_string (emacs_dir
));
2318 /* Add /: to the front of the name
2319 if it would otherwise be treated as magic. */
2320 tem
= Ffind_file_name_handler (element
, Qt
);
2322 /* However, if the handler says "I'm safe",
2323 don't bother adding /:. */
2327 prop
= Fget (tem
, intern ("safe-magic"));
2333 element
= concat2 (build_string ("/:"), element
);
2334 } /* !NILP (element) */
2336 lpath
= Fcons (element
, lpath
);
2342 return Fnreverse (lpath
);
2345 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2346 doc
: /* Return non-nil if the current emacs process is a daemon.
2347 If the daemon was given a name argument, return that name. */)
2352 return build_string (daemon_name
);
2359 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2360 doc
: /* Mark the Emacs daemon as being initialized.
2361 This finishes the daemonization process by doing the other half of detaching
2362 from the parent process and its tty file descriptors. */)
2369 error ("This function can only be called if emacs is run as a daemon");
2371 if (daemon_pipe
[1] < 0)
2372 error ("The daemon has already been initialized");
2374 if (NILP (Vafter_init_time
))
2375 error ("This function can only be called after loading the init files");
2377 /* Get rid of stdin, stdout and stderr. */
2378 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2380 err
|= dup2 (nfd
, 0) < 0;
2381 err
|= dup2 (nfd
, 1) < 0;
2382 err
|= dup2 (nfd
, 2) < 0;
2383 err
|= emacs_close (nfd
) != 0;
2385 /* Closing the pipe will notify the parent that it can exit.
2386 FIXME: In case some other process inherited the pipe, closing it here
2387 won't notify the parent because it's still open elsewhere, so we
2388 additionally send a byte, just to make sure the parent really exits.
2389 Instead, we should probably close the pipe in start-process and
2390 call-process to make sure the pipe is never inherited by
2392 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2393 err
|= emacs_close (daemon_pipe
[1]) != 0;
2394 /* Set it to an invalid value so we know we've already run this function. */
2395 daemon_pipe
[1] = -1;
2398 error ("I/O error during daemon initialization");
2403 syms_of_emacs (void)
2407 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2408 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2409 DEFSYM (Qkill_emacs
, "kill-emacs");
2410 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2412 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2413 doc
: /* Args passed by shell to Emacs, as a list of strings.
2414 Many arguments are deleted from the list as they are processed. */);
2416 DEFVAR_LISP ("system-type", Vsystem_type
,
2417 doc
: /* The value is a symbol indicating the type of operating system you are using.
2419 `gnu' compiled for a GNU Hurd system.
2420 `gnu/linux' compiled for a GNU/Linux system.
2421 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2422 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2423 `ms-dos' compiled as an MS-DOS application.
2424 `windows-nt' compiled as a native W32 application.
2425 `cygwin' compiled using the Cygwin library.
2426 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2427 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2428 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2429 /* See configure.ac (and config.nt) for the possible SYSTEM_TYPEs. */
2431 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2432 doc
: /* Value is string indicating configuration Emacs was built for.
2433 On MS-Windows, the value reflects the OS flavor and version on which
2434 Emacs is running. */);
2435 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2437 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2438 doc
: /* String containing the configuration options Emacs was built with. */);
2439 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2441 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2442 doc
: /* String listing some of the main features this Emacs was compiled with.
2443 An element of the form \"FOO\" generally means that HAVE_FOO was
2444 defined during the build. */);
2445 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2447 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2448 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2450 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2451 doc
: /* Hook run when `kill-emacs' is called.
2452 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2453 in other similar situations), functions placed on this hook should not
2454 expect to be able to interact with the user. To ask for confirmation,
2455 see `kill-emacs-query-functions' instead.
2457 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2458 `noninteractive' was non-nil. */);
2459 Vkill_emacs_hook
= Qnil
;
2461 DEFVAR_LISP ("path-separator", Vpath_separator
,
2462 doc
: /* String containing the character that separates directories in
2463 search paths, such as PATH and other similar environment variables. */);
2466 Vpath_separator
= make_string (&c
, 1);
2469 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2470 doc
: /* The program name that was used to run Emacs.
2471 Any directory names are omitted. */);
2473 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2474 doc
: /* The directory in which the Emacs executable was found, to run it.
2475 The value is nil if that directory's name is not known. */);
2477 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2478 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2479 In an installed Emacs, this is normally nil. It is non-nil if
2480 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2481 within the variable `invocation-directory' or its parent. For example,
2482 this is the case when running an uninstalled Emacs executable from its
2483 build directory. */);
2484 Vinstallation_directory
= Qnil
;
2486 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2487 doc
: /* System locale for messages. */);
2488 Vsystem_messages_locale
= Qnil
;
2490 DEFVAR_LISP ("previous-system-messages-locale",
2491 Vprevious_system_messages_locale
,
2492 doc
: /* Most recently used system locale for messages. */);
2493 Vprevious_system_messages_locale
= Qnil
;
2495 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2496 doc
: /* System locale for time. */);
2497 Vsystem_time_locale
= Qnil
;
2499 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2500 doc
: /* Most recently used system locale for time. */);
2501 Vprevious_system_time_locale
= Qnil
;
2503 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2504 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2505 Vbefore_init_time
= Qnil
;
2507 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2508 doc
: /* Value of `current-time' after loading the init files.
2509 This is nil during initialization. */);
2510 Vafter_init_time
= Qnil
;
2512 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2513 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2514 inhibit_x_resources
= 0;
2516 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2517 doc
: /* Short copyright string for this version of Emacs. */);
2518 Vemacs_copyright
= build_string (emacs_copyright
);
2520 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2521 doc
: /* Version numbers of this version of Emacs. */);
2522 Vemacs_version
= build_string (emacs_version
);
2524 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2525 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2526 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2528 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2529 doc
: /* Alist of dynamic libraries vs external files implementing them.
2530 Each element is a list (LIBRARY FILE...), where the car is a symbol
2531 representing a supported external library, and the rest are strings giving
2532 alternate filenames for that library.
2534 Emacs tries to load the library from the files in the order they appear on
2535 the list; if none is loaded, the running session of Emacs won't have access
2538 Note that image types `pbm' and `xbm' do not need entries in this variable
2539 because they do not depend on external libraries and are always available.
2541 Also note that this is not a generic facility for accessing external
2542 libraries; only those already known by Emacs will be loaded. */);
2543 Vdynamic_library_alist
= Qnil
;
2544 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2547 Vlibrary_cache
= Qnil
;
2548 staticpro (&Vlibrary_cache
);