1 /* Fully extensible Emacs, running on Unix, intended for GNU.
3 Copyright (C) 1985-1987, 1993-1995, 1997-1999, 2001-2016 Free Software
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 #define INLINE EXTERN_INLINE
28 #include <sys/types.h>
32 #include <close-stream.h>
39 #include <sys/socket.h>
45 #if defined WINDOWSNT || defined HAVE_NTGUI
46 #include "w32select.h"
48 #include "w32common.h"
56 #include <binary-io.h>
59 #ifdef HAVE_WINDOW_SYSTEM
61 #endif /* HAVE_WINDOW_SYSTEM */
64 #include "intervals.h"
65 #include "character.h"
70 #include "blockinput.h"
71 #include "syssignal.h"
74 #include "termhooks.h"
79 #include "composite.h"
80 #include "dispextern.h"
84 #include "sysselect.h"
90 #if (defined PROFILING \
91 && (defined __FreeBSD__ || defined GNU_LINUX || defined __MINGW32__))
92 # include <sys/gmon.h>
93 extern void moncontrol (int mode
);
104 #ifdef HAVE_SETRLIMIT
105 #include <sys/time.h>
106 #include <sys/resource.h>
109 #ifdef HAVE_PERSONALITY_LINUX32
110 #include <sys/personality.h>
113 static const char emacs_version
[] = PACKAGE_VERSION
;
114 static const char emacs_copyright
[] = COPYRIGHT
;
115 static const char emacs_bugreport
[] = PACKAGE_BUGREPORT
;
117 /* Empty lisp strings. To avoid having to build any others. */
118 Lisp_Object empty_unibyte_string
, empty_multibyte_string
;
121 /* Cache for externally loaded libraries. */
122 Lisp_Object Vlibrary_cache
;
125 /* Set after Emacs has started up the first time.
126 Prevents reinitialization of the Lisp world and keymaps
127 on subsequent starts. */
130 /* Set to true if this instance of Emacs might dump. */
131 #ifndef DOUG_LEA_MALLOC
137 extern void unexec_init_emacs_zone (void);
140 /* If true, Emacs should not attempt to use a window-specific code,
141 but instead should use the virtual terminal under which it was started. */
142 bool inhibit_window_system
;
144 /* If true, a filter or a sentinel is running. Tested to save the match
145 data on the first attempt to change it inside asynchronous code. */
146 bool running_asynch_code
;
148 #if defined (HAVE_X_WINDOWS) || defined (HAVE_NS)
149 /* If true, -d was specified, meaning we're using some window system. */
153 /* An address near the bottom of the stack.
154 Tells GC how to save a copy of the stack. */
158 /* The gap between BSS end and heap start as far as we can tell. */
159 static uprintmax_t heap_bss_diff
;
162 /* To run as a daemon under Cocoa or Windows, we must do a fork+exec,
165 On Cocoa, CoreFoundation lib fails in forked process:
166 http://developer.apple.com/ReleaseNotes/
167 CoreFoundation/CoreFoundation.html)
169 On Windows, a Cygwin fork child cannot access the USER subsystem.
171 We mark being in the exec'd process by a daemon name argument of
172 form "--daemon=\nFD0,FD1\nNAME" where FD are the pipe file descriptors,
173 NAME is the original daemon name, if any. */
174 #if defined NS_IMPL_COCOA || (defined HAVE_NTGUI && defined CYGWIN)
175 # define DAEMON_MUST_EXEC
178 /* True means running Emacs without interactive terminal. */
181 /* True means remove site-lisp directories from load-path. */
184 /* Name for the server started by the daemon.*/
185 static char *daemon_name
;
188 /* Pipe used to send exit notification to the daemon parent at
192 HANDLE w32_daemon_event
;
195 /* Save argv and argc. */
199 static void sort_args (int argc
, char **argv
);
200 static void syms_of_emacs (void);
202 /* C99 needs each string to be at most 4095 characters, and the usage
203 strings below are split to not overflow this limit. */
204 static char const *const usage_message
[] =
207 Run Emacs, the extensible, customizable, self-documenting real-time\n\
208 display editor. The recommended way to start Emacs for normal editing\n\
209 is with no options at all.\n\
211 Run M-x info RET m emacs RET m emacs invocation RET inside Emacs to\n\
212 read the main documentation for these command-line arguments.\n\
214 Initialization options:\n\
218 --batch do not do interactive display; implies -q\n\
219 --chdir DIR change to directory DIR\n\
220 --daemon start a server in the background\n\
221 --debug-init enable Emacs Lisp debugger for init file\n\
222 --display, -d DISPLAY use X server DISPLAY\n\
225 --no-desktop do not load a saved desktop\n\
226 --no-init-file, -q load neither ~/.emacs nor default.el\n\
227 --no-loadup, -nl do not load loadup.el into bare Emacs\n\
228 --no-site-file do not load site-start.el\n\
229 --no-x-resources do not load X resources\n\
230 --no-site-lisp, -nsl do not add site-lisp directories to load-path\n\
231 --no-splash do not display a splash screen on startup\n\
232 --no-window-system, -nw do not communicate with X, ignoring $DISPLAY\n\
235 --quick, -Q equivalent to:\n\
236 -q --no-site-file --no-site-lisp --no-splash\n\
238 --script FILE run FILE as an Emacs Lisp script\n\
239 --terminal, -t DEVICE use DEVICE for terminal I/O\n\
240 --user, -u USER load ~USER/.emacs instead of your own\n\
246 FILE visit FILE using find-file\n\
247 +LINE go to line LINE in next FILE\n\
248 +LINE:COLUMN go to line LINE, column COLUMN, in next FILE\n\
249 --directory, -L DIR prepend DIR to load-path (with :DIR, append DIR)\n\
250 --eval EXPR evaluate Emacs Lisp expression EXPR\n\
251 --execute EXPR evaluate Emacs Lisp expression EXPR\n\
254 --file FILE visit FILE using find-file\n\
255 --find-file FILE visit FILE using find-file\n\
256 --funcall, -f FUNC call Emacs Lisp function FUNC with no arguments\n\
257 --insert FILE insert contents of FILE into current buffer\n\
258 --kill exit without asking for confirmation\n\
259 --load, -l FILE load Emacs Lisp FILE using the load function\n\
260 --visit FILE visit FILE using find-file\n\
266 --background-color, -bg COLOR window background color\n\
267 --basic-display, -D disable many display features;\n\
268 used for debugging Emacs\n\
269 --border-color, -bd COLOR main border color\n\
270 --border-width, -bw WIDTH width of main border\n\
273 --color, --color=MODE override color mode for character terminals;\n\
274 MODE defaults to `auto', and\n\
275 can also be `never', `always',\n\
276 or a mode name like `ansi8'\n\
277 --cursor-color, -cr COLOR color of the Emacs cursor indicating point\n\
278 --font, -fn FONT default font; must be fixed-width\n\
279 --foreground-color, -fg COLOR window foreground color\n\
282 --fullheight, -fh make the first frame high as the screen\n\
283 --fullscreen, -fs make the first frame fullscreen\n\
284 --fullwidth, -fw make the first frame wide as the screen\n\
285 --maximized, -mm make the first frame maximized\n\
286 --geometry, -g GEOMETRY window geometry\n\
289 --no-bitmap-icon, -nbi do not use picture of gnu for Emacs icon\n\
290 --iconic start Emacs in iconified state\n\
291 --internal-border, -ib WIDTH width between text and main border\n\
292 --line-spacing, -lsp PIXELS additional space to put between lines\n\
293 --mouse-color, -ms COLOR mouse cursor color in Emacs window\n\
294 --name NAME title for initial Emacs frame\n\
297 --no-blinking-cursor, -nbc disable blinking cursor\n\
298 --reverse-video, -r, -rv switch foreground and background\n\
299 --title, -T TITLE title for initial Emacs frame\n\
300 --vertical-scroll-bars, -vb enable vertical scroll bars\n\
301 --xrm XRESOURCES set additional X resources\n\
302 --parent-id XID set parent window\n\
303 --help display this help and exit\n\
304 --version output version information and exit\n\
308 You can generally also specify long option names with a single -; for\n\
309 example, -batch as well as --batch. You can use any unambiguous\n\
310 abbreviation for a --option.\n\
312 Various environment variables and window system resources also affect\n\
313 the operation of Emacs. See the main documentation.\n\
315 Report bugs to " PACKAGE_BUGREPORT
". First, please see the Bugs\n\
316 section of the Emacs manual or the file BUGS.\n"
320 /* True if handling a fatal error already. */
321 bool fatal_error_in_progress
;
324 /* NS autrelease pool, for memory management. */
325 static void *ns_pool
;
330 setlocale (int cat
, char const *locale
)
336 /* True if the current system locale uses UTF-8 encoding. */
342 mbstate_t mbs
= { 0 };
343 return mbrtowc (&wc
, "\xc4\x80", 2, &mbs
) == 2 && wc
== 0x100;
350 /* Report a fatal error due to signal SIG, output a backtrace of at
351 most BACKTRACE_LIMIT lines, and exit. */
353 terminate_due_to_signal (int sig
, int backtrace_limit
)
355 signal (sig
, SIG_DFL
);
357 if (attempt_orderly_shutdown_on_fatal_signal
)
359 /* If fatal error occurs in code below, avoid infinite recursion. */
360 if (! fatal_error_in_progress
)
362 fatal_error_in_progress
= 1;
364 totally_unblock_input ();
365 if (sig
== SIGTERM
|| sig
== SIGHUP
|| sig
== SIGINT
)
366 Fkill_emacs (make_number (sig
));
368 shut_down_emacs (sig
, Qnil
);
369 emacs_backtrace (backtrace_limit
);
373 /* Signal the same code; this time it will really be fatal.
374 Since we're in a signal handler, the signal is blocked, so we
375 have to unblock it if we want to really receive it. */
379 sigemptyset (&unblocked
);
380 sigaddset (&unblocked
, sig
);
381 pthread_sigmask (SIG_UNBLOCK
, &unblocked
, 0);
387 /* This shouldn't be executed, but it prevents a warning. */
391 /* Code for dealing with Lisp access to the Unix command line. */
394 init_cmdargs (int argc
, char **argv
, int skip_args
, char *original_pwd
)
397 Lisp_Object name
, dir
, handler
;
398 ptrdiff_t count
= SPECPDL_INDEX ();
399 Lisp_Object raw_name
;
400 AUTO_STRING (slash_colon
, "/:");
406 /* Must use argv[0] converted to UTF-8, as it begets many standard
407 file and directory names. */
409 char argv0
[MAX_UTF8_PATH
];
411 if (filename_from_ansi (argv
[0], argv0
) == 0)
412 raw_name
= build_unibyte_string (argv0
);
414 raw_name
= build_unibyte_string (argv
[0]);
417 raw_name
= build_unibyte_string (argv
[0]);
420 /* Add /: to the front of the name
421 if it would otherwise be treated as magic. */
422 handler
= Ffind_file_name_handler (raw_name
, Qt
);
423 if (! NILP (handler
))
424 raw_name
= concat2 (slash_colon
, raw_name
);
426 Vinvocation_name
= Ffile_name_nondirectory (raw_name
);
427 Vinvocation_directory
= Ffile_name_directory (raw_name
);
429 /* If we got no directory in argv[0], search PATH to find where
430 Emacs actually came from. */
431 if (NILP (Vinvocation_directory
))
434 int yes
= openp (Vexec_path
, Vinvocation_name
,
435 Vexec_suffixes
, &found
, make_number (X_OK
), false);
438 /* Add /: to the front of the name
439 if it would otherwise be treated as magic. */
440 handler
= Ffind_file_name_handler (found
, Qt
);
441 if (! NILP (handler
))
442 found
= concat2 (slash_colon
, found
);
443 Vinvocation_directory
= Ffile_name_directory (found
);
447 if (!NILP (Vinvocation_directory
)
448 && NILP (Ffile_name_absolute_p (Vinvocation_directory
)))
449 /* Emacs was started with relative path, like ./emacs.
453 original_pwd
? build_unibyte_string (original_pwd
) : Qnil
;
455 Vinvocation_directory
= Fexpand_file_name (Vinvocation_directory
, odir
);
458 Vinstallation_directory
= Qnil
;
460 if (!NILP (Vinvocation_directory
))
462 dir
= Vinvocation_directory
;
464 /* If we are running from the build directory, set DIR to the
465 src subdirectory of the Emacs tree, like on Posix
467 if (SBYTES (dir
) > sizeof ("/i386/") - 1
468 && 0 == strcmp (SSDATA (dir
) + SBYTES (dir
) - sizeof ("/i386/") + 1,
470 dir
= Fexpand_file_name (build_string ("../.."), dir
);
471 #else /* !WINDOWSNT */
473 name
= Fexpand_file_name (Vinvocation_name
, dir
);
476 Lisp_Object tem
, lib_src_exists
;
477 Lisp_Object etc_exists
, info_exists
;
479 /* See if dir contains subdirs for use by Emacs.
480 Check for the ones that would exist in a build directory,
481 not including lisp and info. */
482 tem
= Fexpand_file_name (build_string ("lib-src"), dir
);
483 lib_src_exists
= Ffile_exists_p (tem
);
486 /* MSDOS installations frequently remove lib-src, but we still
487 must set installation-directory, or else info won't find
488 its files (it uses the value of installation-directory). */
489 tem
= Fexpand_file_name (build_string ("info"), dir
);
490 info_exists
= Ffile_exists_p (tem
);
495 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
497 tem
= Fexpand_file_name (build_string ("etc"), dir
);
498 etc_exists
= Ffile_exists_p (tem
);
499 if (!NILP (etc_exists
))
501 Vinstallation_directory
502 = Ffile_name_as_directory (dir
);
507 /* See if dir's parent contains those subdirs. */
508 tem
= Fexpand_file_name (build_string ("../lib-src"), dir
);
509 lib_src_exists
= Ffile_exists_p (tem
);
513 /* See the MSDOS commentary above. */
514 tem
= Fexpand_file_name (build_string ("../info"), dir
);
515 info_exists
= Ffile_exists_p (tem
);
520 if (!NILP (lib_src_exists
) || !NILP (info_exists
))
522 tem
= Fexpand_file_name (build_string ("../etc"), dir
);
523 etc_exists
= Ffile_exists_p (tem
);
524 if (!NILP (etc_exists
))
526 tem
= Fexpand_file_name (build_string (".."), dir
);
527 Vinstallation_directory
528 = Ffile_name_as_directory (tem
);
533 /* If the Emacs executable is actually a link,
534 next try the dir that the link points into. */
535 tem
= Ffile_symlink_p (name
);
538 name
= Fexpand_file_name (tem
, dir
);
539 dir
= Ffile_name_directory (name
);
546 Vcommand_line_args
= Qnil
;
548 for (i
= argc
- 1; i
>= 0; i
--)
550 if (i
== 0 || i
> skip_args
)
551 /* For the moment, we keep arguments as is in unibyte strings.
552 They are decoded in the function command-line after we know
553 locale-coding-system. */
555 = Fcons (build_unibyte_string (argv
[i
]), Vcommand_line_args
);
558 unbind_to (count
, Qnil
);
561 DEFUN ("invocation-name", Finvocation_name
, Sinvocation_name
, 0, 0, 0,
562 doc
: /* Return the program name that was used to run Emacs.
563 Any directory names are omitted. */)
566 return Fcopy_sequence (Vinvocation_name
);
569 DEFUN ("invocation-directory", Finvocation_directory
, Sinvocation_directory
,
571 doc
: /* Return the directory name in which the Emacs executable was located. */)
574 return Fcopy_sequence (Vinvocation_directory
);
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 /* Close standard output and standard error, reporting any write
642 errors as best we can. This is intended for use with atexit. */
644 close_output_streams (void)
646 if (close_stream (stdout
) != 0)
648 emacs_perror ("Write error to standard output");
649 _exit (EXIT_FAILURE
);
652 if (close_stream (stderr
) != 0)
653 _exit (EXIT_FAILURE
);
658 main (int argc
, char **argv
)
661 char stack_bottom_variable
;
662 bool do_initial_setlocale
;
665 #ifdef HAVE_SETRLIMIT
671 #ifdef DAEMON_MUST_EXEC
676 /* If we use --chdir, this records the original directory. */
677 char *original_pwd
= 0;
682 might_dump
= !initialized
;
688 char *heap_start
= my_heap_start ();
689 heap_bss_diff
= heap_start
- max (my_endbss
, my_endbss_static
);
693 #if defined WINDOWSNT || defined HAVE_NTGUI
694 /* Set global variables used to detect Windows version. Do this as
695 early as possible. (unexw32.c calls this function as well, but
696 the additional call here is harmless.) */
697 cache_system_info ();
699 /* On Windows 9X, we have to load UNICOWS.DLL as early as possible,
700 to have non-stub implementations of APIs we need to convert file
701 names between UTF-8 and the system's ANSI codepage. */
702 maybe_load_unicows_dll ();
704 /* This has to be done before module_init is called below, so that
705 the latter could use the thread ID of the main thread. */
706 w32_init_main_thread ();
709 #ifdef RUN_TIME_REMAP
711 run_time_remap (argv
[0]);
714 /* If using unexmacosx.c (set by s/darwin.h), we must do this. */
717 unexec_init_emacs_zone ();
720 atexit (close_output_streams
);
726 sort_args (argc
, argv
);
728 while (argv
[argc
]) argc
++;
730 if (argmatch (argv
, argc
, "-version", "--version", 3, NULL
, &skip_args
))
732 const char *version
, *copyright
;
735 Lisp_Object tem
, tem2
;
736 tem
= Fsymbol_value (intern_c_string ("emacs-version"));
737 tem2
= Fsymbol_value (intern_c_string ("emacs-copyright"));
740 fprintf (stderr
, "Invalid value of 'emacs-version'\n");
745 fprintf (stderr
, "Invalid value of 'emacs-copyright'\n");
750 version
= SSDATA (tem
);
751 copyright
= SSDATA (tem2
);
756 version
= emacs_version
;
757 copyright
= emacs_copyright
;
759 printf ("%s %s\n", PACKAGE_NAME
, version
);
760 printf ("%s\n", copyright
);
761 printf ("%s comes with ABSOLUTELY NO WARRANTY.\n", PACKAGE_NAME
);
762 printf ("You may redistribute copies of %s\n", PACKAGE_NAME
);
763 printf ("under the terms of the GNU General Public License.\n");
764 printf ("For more information about these matters, ");
765 printf ("see the file named COPYING.\n");
769 if (argmatch (argv
, argc
, "-chdir", "--chdir", 4, &ch_to_dir
, &skip_args
))
772 /* argv[] array is kept in its original ANSI codepage encoding,
773 we need to convert to UTF-8, for chdir to work. */
774 char newdir
[MAX_UTF8_PATH
];
776 filename_from_ansi (ch_to_dir
, newdir
);
779 original_pwd
= emacs_get_current_dir_name ();
780 if (chdir (ch_to_dir
) != 0)
782 fprintf (stderr
, "%s: Can't chdir to %s: %s\n",
783 argv
[0], ch_to_dir
, strerror (errno
));
788 dumping
= !initialized
&& (strcmp (argv
[argc
- 1], "dump") == 0
789 || strcmp (argv
[argc
- 1], "bootstrap") == 0);
791 #ifdef HAVE_PERSONALITY_LINUX32
792 if (dumping
&& ! getenv ("EMACS_HEAP_EXEC"))
794 /* Set this so we only do this once. */
795 xputenv ("EMACS_HEAP_EXEC=true");
797 /* A flag to turn off address randomization which is introduced
798 in linux kernel shipped with fedora core 4 */
799 #define ADD_NO_RANDOMIZE 0x0040000
800 personality (PER_LINUX32
| ADD_NO_RANDOMIZE
);
801 #undef ADD_NO_RANDOMIZE
803 execvp (argv
[0], argv
);
805 /* If the exec fails, try to dump anyway. */
806 emacs_perror (argv
[0]);
808 #endif /* HAVE_PERSONALITY_LINUX32 */
810 #if defined (HAVE_SETRLIMIT) && defined (RLIMIT_STACK) && !defined (CYGWIN)
811 /* Extend the stack space available. Don't do that if dumping,
812 since some systems (e.g. DJGPP) might define a smaller stack
813 limit at that time. And it's not needed on Cygwin, since emacs
814 is built with an 8MB stack. Moreover, the setrlimit call can
815 cause problems on Cygwin
816 (https://www.cygwin.com/ml/cygwin/2015-07/msg00096.html). */
819 && (!noninteractive
|| initialized
)
821 && !getrlimit (RLIMIT_STACK
, &rlim
))
824 /* Approximate the amount regex.c needs per unit of re_max_failures. */
825 int ratio
= 20 * sizeof (char *);
826 /* Then add 33% to cover the size of the smaller stacks that regex.c
827 successively allocates and discards, on its way to the maximum. */
829 /* Add in some extra to cover
830 what we're likely to use for other reasons. */
831 newlim
= re_max_failures
* ratio
+ 200000;
833 /* NetBSD (at least NetBSD 1.2G and former) has a bug in its
834 stack allocation routine for new process that the allocation
835 fails if stack limit is not on page boundary. So, round up the
836 new limit to page boundary. */
837 newlim
= (newlim
+ getpagesize () - 1) / getpagesize () * getpagesize ();
839 if (newlim
> rlim
.rlim_max
)
841 newlim
= rlim
.rlim_max
;
842 /* Don't let regex.c overflow the stack we have. */
843 re_max_failures
= (newlim
- 200000) / ratio
;
845 if (rlim
.rlim_cur
< newlim
)
846 rlim
.rlim_cur
= newlim
;
848 setrlimit (RLIMIT_STACK
, &rlim
);
850 #endif /* HAVE_SETRLIMIT and RLIMIT_STACK and not CYGWIN */
852 /* Record (approximately) where the stack begins. */
853 stack_bottom
= &stack_bottom_variable
;
857 emacs_backtrace (-1);
859 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
860 /* Arrange to get warning messages as memory fills up. */
861 memory_warnings (0, malloc_warning
);
863 /* Call malloc at least once, to run malloc_initialize_hook.
864 Also call realloc and free for consistency. */
865 free (realloc (malloc (4), 4));
867 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
870 SET_BINARY (fileno (stdin
));
872 SET_BINARY (fileno (stdout
));
875 /* Skip initial setlocale if LC_ALL is "C", as it's not needed in that case.
876 The build procedure uses this while dumping, to ensure that the
877 dumped Emacs does not have its system locale tables initialized,
878 as that might cause screwups when the dumped Emacs starts up. */
880 char *lc_all
= getenv ("LC_ALL");
881 do_initial_setlocale
= ! lc_all
|| strcmp (lc_all
, "C");
884 /* Set locale now, so that initial error messages are localized properly.
885 fixup_locale must wait until later, since it builds strings. */
886 if (do_initial_setlocale
)
887 setlocale (LC_ALL
, "");
888 text_quoting_flag
= using_utf8 ();
890 inhibit_window_system
= 0;
892 /* Handle the -t switch, which specifies filename to use as terminal. */
896 if (argmatch (argv
, argc
, "-t", "--terminal", 4, &term
, &skip_args
))
901 result
= emacs_open (term
, O_RDWR
, 0);
902 if (result
< 0 || fcntl (0, F_DUPFD_CLOEXEC
, 1) < 0)
904 char *errstring
= strerror (errno
);
905 fprintf (stderr
, "%s: %s: %s\n", argv
[0], term
, errstring
);
910 fprintf (stderr
, "%s: %s: not a tty\n", argv
[0], term
);
913 fprintf (stderr
, "Using %s\n", term
);
914 #ifdef HAVE_WINDOW_SYSTEM
915 inhibit_window_system
= 1; /* -t => -nw */
922 /* Command line option --no-windows is deprecated and thus not mentioned
923 in the manual and usage information. */
924 if (argmatch (argv
, argc
, "-nw", "--no-window-system", 6, NULL
, &skip_args
)
925 || argmatch (argv
, argc
, "-nw", "--no-windows", 6, NULL
, &skip_args
))
926 inhibit_window_system
= 1;
928 /* Handle the -batch switch, which means don't do interactive display. */
930 if (argmatch (argv
, argc
, "-batch", "--batch", 5, NULL
, &skip_args
))
933 Vundo_outer_limit
= Qnil
;
935 if (argmatch (argv
, argc
, "-script", "--script", 3, &junk
, &skip_args
))
937 noninteractive
= 1; /* Set batch mode. */
938 /* Convert --script to -scriptload, un-skip it, and sort again
939 so that it will be handled in proper sequence. */
940 /* FIXME broken for --script=FILE - is that supposed to work? */
941 argv
[skip_args
- 1] = (char *) "-scriptload";
943 sort_args (argc
, argv
);
946 /* Handle the --help option, which gives a usage message. */
947 if (argmatch (argv
, argc
, "-help", "--help", 3, NULL
, &skip_args
))
950 printf ("Usage: %s [OPTION-OR-FILENAME]...\n", argv
[0]);
951 for (i
= 0; i
< ARRAYELTS (usage_message
); i
++)
952 fputs (usage_message
[i
], stdout
);
957 /* Make sure IS_DAEMON starts up as false. */
960 w32_daemon_event
= NULL
;
963 if (argmatch (argv
, argc
, "-daemon", "--daemon", 5, NULL
, &skip_args
)
964 || argmatch (argv
, argc
, "-daemon", "--daemon", 5, &dname_arg
, &skip_args
))
969 /* Start as a daemon: fork a new child process which will run the
970 rest of the initialization code, then exit.
972 Detaching a daemon requires the following steps:
976 - close the tty file-descriptors
978 We only want to do the last 2 steps once the daemon is ready to
979 serve requests, i.e. after loading .emacs (initialization).
980 OTOH initialization may start subprocesses (e.g. ispell) and these
981 should be run from the proper process (the one that will end up
982 running as daemon) and with the proper "session id" in order for
983 them to keep working after detaching, so fork and setsid need to be
984 performed before initialization.
986 We want to avoid exiting before the server socket is ready, so
987 use a pipe for synchronization. The parent waits for the child
988 to close its end of the pipe (using `daemon-initialized')
990 if (emacs_pipe (daemon_pipe
) != 0)
992 fprintf (stderr
, "Cannot pipe!\n");
996 #ifndef DAEMON_MUST_EXEC
998 fprintf (stderr
, "\nWarning: due to a long standing Gtk+ bug\nhttp://bugzilla.gnome.org/show_bug.cgi?id=85715\n\
999 Emacs might crash when run in daemon mode and the X11 connection is unexpectedly lost.\n\
1000 Using an Emacs configured with --with-x-toolkit=lucid does not have this problem.\n");
1001 #endif /* USE_GTK */
1003 #else /* DAEMON_MUST_EXEC */
1004 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1005 f
= fork (); /* in orig */
1007 f
= 0; /* in exec'd */
1008 #endif /* !DAEMON_MUST_EXEC */
1014 /* Close unused writing end of the pipe. */
1015 emacs_close (daemon_pipe
[1]);
1017 /* Just wait for the child to close its end of the pipe. */
1020 retval
= read (daemon_pipe
[0], &buf
, 1);
1022 while (retval
== -1 && errno
== EINTR
);
1026 fprintf (stderr
, "Error reading status from child\n");
1029 else if (retval
== 0)
1031 fprintf (stderr
, "Error: server did not start correctly\n");
1035 emacs_close (daemon_pipe
[0]);
1040 emacs_perror ("fork");
1041 exit (EXIT_CANCELED
);
1044 #ifdef DAEMON_MUST_EXEC
1046 /* In orig process, forked as child, OR in exec'd. */
1047 if (!dname_arg
|| !strchr (dname_arg
, '\n'))
1048 { /* In orig, child: now exec w/special daemon name. */
1051 snprintf (fdStr
, sizeof fdStr
,
1052 "--daemon=\n%d,%d\n%s", daemon_pipe
[0],
1053 daemon_pipe
[1], dname_arg
? dname_arg
: "");
1055 if (! (0 <= fdStrlen
&& fdStrlen
< sizeof fdStr
))
1057 fprintf (stderr
, "daemon: child name too long\n");
1058 exit (EXIT_CANNOT_INVOKE
);
1061 argv
[skip_args
] = fdStr
;
1063 fcntl (daemon_pipe
[0], F_SETFD
, 0);
1064 fcntl (daemon_pipe
[1], F_SETFD
, 0);
1065 execvp (argv
[0], argv
);
1066 emacs_perror (argv
[0]);
1067 exit (errno
== ENOENT
? EXIT_ENOENT
: EXIT_CANNOT_INVOKE
);
1070 /* In exec'd: parse special dname into pipe and name info. */
1071 if (!dname_arg
|| !strchr (dname_arg
, '\n')
1072 || strlen (dname_arg
) < 1 || strlen (dname_arg
) > 70)
1074 fprintf (stderr
, "emacs daemon: daemon name absent or too long\n");
1075 exit (EXIT_CANNOT_INVOKE
);
1077 dname_arg2
[0] = '\0';
1078 sscanf (dname_arg
, "\n%d,%d\n%s", &(daemon_pipe
[0]), &(daemon_pipe
[1]),
1080 dname_arg
= *dname_arg2
? dname_arg2
: NULL
;
1081 fcntl (daemon_pipe
[1], F_SETFD
, FD_CLOEXEC
);
1083 #endif /* DAEMON_MUST_EXEC */
1085 /* Close unused reading end of the pipe. */
1086 emacs_close (daemon_pipe
[0]);
1089 #elif defined(WINDOWSNT)
1090 /* Indicate that we want daemon mode. */
1091 w32_daemon_event
= CreateEvent (NULL
, TRUE
, FALSE
, W32_DAEMON_EVENT
);
1092 if (w32_daemon_event
== NULL
)
1094 fprintf (stderr
, "Couldn't create MS-Windows event for daemon: %s\n",
1099 fprintf (stderr
, "This platform does not support the -daemon flag.\n");
1103 daemon_name
= xstrdup (dname_arg
);
1106 #if defined HAVE_PTHREAD && !defined SYSTEM_MALLOC \
1107 && !defined DOUG_LEA_MALLOC && !defined HYBRID_MALLOC
1108 # ifndef CANNOT_DUMP
1109 /* Do not make gmalloc thread-safe when creating bootstrap-emacs, as
1110 that causes an infinite recursive loop with FreeBSD. See
1111 Bug#14569. The part of this bug involving Cygwin is no longer
1112 relevant, now that Cygwin defines HYBRID_MALLOC. */
1113 if (!noninteractive
|| initialized
)
1115 malloc_enable_thread ();
1118 init_signals (dumping
);
1120 noninteractive1
= noninteractive
;
1122 /* Perform basic initializations (not merely interning symbols). */
1129 init_charset_once ();
1130 init_coding_once ();
1131 init_syntax_once (); /* Create standard syntax table. */
1132 init_category_once (); /* Create standard category table. */
1133 init_casetab_once (); /* Must be done before init_buffer_once. */
1134 init_buffer_once (); /* Create buffer table and some buffers. */
1135 init_minibuf_once (); /* Create list of minibuffers. */
1136 /* Must precede init_window_once. */
1138 /* Call syms_of_xfaces before init_window_once because that
1139 function creates Vterminal_frame. Termcap frames now use
1140 faces, and the face implementation uses some symbols as
1143 /* XXX syms_of_keyboard uses some symbols in keymap.c. It would
1144 be better to arrange things not to have this dependency. */
1146 /* Call syms_of_keyboard before init_window_once because
1147 keyboard sets up symbols that include some face names that
1148 the X support will want to use. This can happen when
1149 CANNOT_DUMP is defined. */
1150 syms_of_keyboard ();
1152 /* Called before syms_of_fileio, because it sets up Qerror_condition. */
1154 syms_of_fns (); /* Before syms_of_charset which uses hashtables. */
1156 /* Before syms_of_coding to initialize Vgc_cons_threshold. */
1158 /* May call Ffuncall and so GC, thus the latter should be initialized. */
1160 /* Before syms_of_coding because it initializes Qcharsetp. */
1162 /* Before init_window_once, because it sets up the
1163 Vcoding_system_hash_table. */
1164 syms_of_coding (); /* This should be after syms_of_fileio. */
1166 init_window_once (); /* Init the window system. */
1167 #ifdef HAVE_WINDOW_SYSTEM
1168 init_fringe_once (); /* Swap bitmaps if necessary. */
1169 #endif /* HAVE_WINDOW_SYSTEM */
1174 if (do_initial_setlocale
)
1177 Vsystem_messages_locale
= Vprevious_system_messages_locale
;
1178 Vsystem_time_locale
= Vprevious_system_time_locale
;
1183 running_asynch_code
= 0;
1187 = argmatch (argv
, argc
, "-nl", "--no-loadup", 6, NULL
, &skip_args
);
1190 = argmatch (argv
, argc
, "-nsl", "--no-site-lisp", 11, NULL
, &skip_args
);
1193 ns_pool
= ns_alloc_autorelease_pool ();
1194 #ifdef NS_IMPL_GNUSTEP
1195 /* GNUstep stupidly resets our locale settings after we made them. */
1199 if (!noninteractive
)
1201 #ifdef NS_IMPL_COCOA
1202 /* Started from GUI? */
1203 /* FIXME: Do the right thing if getenv returns NULL, or if
1205 if (! inhibit_window_system
&& ! isatty (0) && ! ch_to_dir
)
1206 chdir (getenv ("HOME"));
1207 if (skip_args
< argc
)
1209 if (!strncmp (argv
[skip_args
], "-psn", 4))
1212 if (! ch_to_dir
) chdir (getenv ("HOME"));
1214 else if (skip_args
+1 < argc
&& !strncmp (argv
[skip_args
+1], "-psn", 4))
1217 if (! ch_to_dir
) chdir (getenv ("HOME"));
1222 #endif /* HAVE_NS */
1224 #ifdef HAVE_X_WINDOWS
1225 /* Stupid kludge to catch command-line display spec. We can't
1226 handle this argument entirely in window system dependent code
1227 because we don't even know which window system dependent code
1228 to run until we've recognized this argument. */
1230 char *displayname
= 0;
1231 int count_before
= skip_args
;
1233 /* Skip any number of -d options, but only use the last one. */
1236 int count_before_this
= skip_args
;
1238 if (argmatch (argv
, argc
, "-d", "--display", 3, &displayname
, &skip_args
))
1240 else if (argmatch (argv
, argc
, "-display", 0, 3, &displayname
, &skip_args
))
1245 count_before
= count_before_this
;
1248 /* If we have the form --display=NAME,
1249 convert it into -d name.
1250 This requires inserting a new element into argv. */
1251 if (displayname
&& count_before
< skip_args
)
1253 if (skip_args
== count_before
+ 1)
1255 memmove (argv
+ count_before
+ 3, argv
+ count_before
+ 2,
1256 (argc
- (count_before
+ 2)) * sizeof *argv
);
1257 argv
[count_before
+ 2] = displayname
;
1260 argv
[count_before
+ 1] = (char *) "-d";
1265 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1266 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1270 /* Don't actually discard this arg. */
1271 skip_args
= count_before
;
1273 #else /* !HAVE_X_WINDOWS */
1276 int count_before
= skip_args
;
1278 if (argmatch (argv
, argc
, "-Q", "--quick", 3, NULL
, &skip_args
)
1279 || argmatch (argv
, argc
, "-quick", 0, 2, NULL
, &skip_args
))
1282 skip_args
= count_before
;
1286 /* argmatch must not be used after here,
1287 except when building temacs
1288 because the -d argument has not been skipped in skip_args. */
1291 /* Call early 'cause init_environment needs it. */
1293 /* Set defaults for several environment variables. */
1295 init_environment (argc
, argv
, skip_args
);
1301 globals_of_kqueue ();
1304 #ifdef HAVE_GFILENOTIFY
1305 globals_of_gfilenotify ();
1310 #ifdef HAVE_W32NOTIFY
1311 globals_of_w32notify ();
1313 /* Initialize environment from registry settings. */
1314 init_environment (argv
);
1315 init_ntproc (dumping
); /* must precede init_editfns. */
1319 /* Initialize the locale from user defaults. */
1323 /* Initialize and GC-protect Vinitial_environment and
1324 Vprocess_environment before set_initial_environment fills them
1327 syms_of_callproc ();
1328 /* egetenv is a pretty low-level facility, which may get called in
1329 many circumstances; it seems flimsy to put off initializing it
1330 until calling init_callproc. Do not do it when dumping. */
1332 set_initial_environment ();
1334 /* AIX crashes are reported in system versions 3.2.3 and 3.2.4
1335 if this is not done. Do it after set_global_environment so that we
1336 don't pollute Vglobal_environment. */
1337 /* Setting LANG here will defeat the startup locale processing... */
1342 /* Init buffer storage and default directory of main buffer. */
1343 init_buffer (initialized
);
1345 init_callproc_1 (); /* Must precede init_cmdargs and init_sys_modes. */
1347 /* Must precede init_lread. */
1348 init_cmdargs (argc
, argv
, skip_args
, original_pwd
);
1352 /* Erase any pre-dump messages in the message log, to avoid confusion. */
1353 Lisp_Object old_log_max
;
1354 old_log_max
= Vmessage_log_max
;
1355 XSETFASTINT (Vmessage_log_max
, 0);
1356 message_dolog ("", 0, 1, 0);
1357 Vmessage_log_max
= old_log_max
;
1360 init_callproc (); /* Must follow init_cmdargs but not init_sys_modes. */
1364 /* Check to see if Emacs has been installed correctly. */
1365 check_windows_init_file ();
1368 /* Intern the names of all standard functions and variables;
1369 define standard keys. */
1373 /* The basic levels of Lisp must come first. Note that
1374 syms_of_data and some others have already been called. */
1379 syms_of_floatfns ();
1382 syms_of_bytecode ();
1384 syms_of_casefiddle ();
1386 syms_of_category ();
1388 syms_of_character ();
1395 syms_of_filelock ();
1398 /* syms_of_keymap (); */
1406 syms_of_terminal ();
1417 syms_of_textprop ();
1418 syms_of_composite ();
1421 #endif /* WINDOWSNT */
1428 #ifdef HAVE_WINDOW_SYSTEM
1431 #endif /* HAVE_WINDOW_SYSTEM */
1432 #ifdef HAVE_X_WINDOWS
1438 syms_of_xsettings ();
1445 #endif /* HAVE_X_WINDOWS */
1452 syms_of_decompress ();
1462 #endif /* HAVE_NTGUI */
1464 #if defined WINDOWSNT || defined HAVE_NTGUI
1465 syms_of_w32select ();
1472 syms_of_win16select ();
1479 syms_of_nsselect ();
1481 #endif /* HAVE_NS */
1487 #endif /* HAVE_INOTIFY */
1491 #endif /* HAVE_KQUEUE */
1493 #ifdef HAVE_GFILENOTIFY
1494 syms_of_gfilenotify ();
1495 #endif /* HAVE_GFILENOTIFY */
1498 syms_of_dbusbind ();
1499 #endif /* HAVE_DBUS */
1503 #ifdef HAVE_W32NOTIFY
1504 syms_of_w32notify ();
1505 #endif /* HAVE_W32NOTIFY */
1506 #endif /* WINDOWSNT */
1508 syms_of_profiler ();
1510 keys_of_casefiddle ();
1513 keys_of_keyboard ();
1519 /* Initialization that must be done even if the global variable
1520 initialized is non zero. */
1522 globals_of_w32font ();
1523 globals_of_w32fns ();
1524 globals_of_w32menu ();
1525 #endif /* HAVE_NTGUI */
1527 #if defined WINDOWSNT || defined HAVE_NTGUI
1528 globals_of_w32select ();
1534 /* This calls putenv and so must precede init_process_emacs. Also,
1535 it sets Voperating_system_release, which init_process_emacs uses. */
1536 init_editfns (dumping
);
1538 /* These two call putenv. */
1546 /* This can create a thread that may call getenv, so it must follow
1547 all calls to putenv and setenv. Also, this sets up
1548 add_keyboard_wait_descriptor, which init_display uses. */
1549 init_process_emacs ();
1551 init_keyboard (); /* This too must precede init_sys_modes. */
1552 if (!noninteractive
)
1553 init_display (); /* Determine terminal type. Calls init_sys_modes. */
1556 init_crit (); /* w32notify.c needs this in batch mode. */
1557 #endif /* HAVE_W32NOTIFY */
1559 #ifdef HAVE_WINDOW_SYSTEM
1561 #endif /* HAVE_WINDOW_SYSTEM */
1569 /* Handle -l loadup, args passed by Makefile. */
1570 if (argmatch (argv
, argc
, "-l", "--load", 3, &file
, &skip_args
))
1573 char file_utf8
[MAX_UTF8_PATH
];
1575 if (filename_from_ansi (file
, file_utf8
) == 0)
1578 Vtop_level
= list2 (Qload
, build_unibyte_string (file
));
1580 /* Unless next switch is -nl, load "loadup.el" first thing. */
1582 Vtop_level
= list2 (Qload
, build_string ("loadup.el"));
1585 /* Set up for profiling. This is known to work on FreeBSD,
1586 GNU/Linux and MinGW. It might work on some other systems too.
1587 Give it a try and tell us if it works on your system. To compile
1588 for profiling, use the configure option --enable-profiling. */
1589 #if defined (__FreeBSD__) || defined (GNU_LINUX) || defined (__MINGW32__)
1594 extern unsigned char etext
asm ("etext");
1600 monstartup ((uintptr_t) __executable_start
, (uintptr_t) &etext
);
1609 /* Enter editor command loop. This never returns. */
1615 /* Sort the args so we can find the most important ones
1616 at the beginning of argv. */
1618 /* First, here's a table of all the standard options. */
1620 struct standard_args
1623 const char *longname
;
1628 static const struct standard_args standard_args
[] =
1630 { "-version", "--version", 150, 0 },
1631 { "-chdir", "--chdir", 130, 1 },
1632 { "-t", "--terminal", 120, 1 },
1633 { "-nw", "--no-window-system", 110, 0 },
1634 { "-nw", "--no-windows", 110, 0 },
1635 { "-batch", "--batch", 100, 0 },
1636 { "-script", "--script", 100, 1 },
1637 { "-daemon", "--daemon", 99, 0 },
1638 { "-help", "--help", 90, 0 },
1639 { "-nl", "--no-loadup", 70, 0 },
1640 { "-nsl", "--no-site-lisp", 65, 0 },
1641 /* -d must come last before the options handled in startup.el. */
1642 { "-d", "--display", 60, 1 },
1643 { "-display", 0, 60, 1 },
1644 /* Now for the options handled in `command-line' (startup.el). */
1645 /* (Note that to imply -nsl, -Q is partially handled here.) */
1646 { "-Q", "--quick", 55, 0 },
1647 { "-quick", 0, 55, 0 },
1648 { "-q", "--no-init-file", 50, 0 },
1649 { "-no-init-file", 0, 50, 0 },
1650 { "-no-x-resources", "--no-x-resources", 40, 0 },
1651 { "-no-site-file", "--no-site-file", 40, 0 },
1652 { "-u", "--user", 30, 1 },
1653 { "-user", 0, 30, 1 },
1654 { "-debug-init", "--debug-init", 20, 0 },
1655 { "-iconic", "--iconic", 15, 0 },
1656 { "-D", "--basic-display", 12, 0},
1657 { "-basic-display", 0, 12, 0},
1658 { "-nbc", "--no-blinking-cursor", 12, 0 },
1659 /* Now for the options handled in `command-line-1' (startup.el). */
1660 { "-nbi", "--no-bitmap-icon", 10, 0 },
1661 { "-bg", "--background-color", 10, 1 },
1662 { "-background", 0, 10, 1 },
1663 { "-fg", "--foreground-color", 10, 1 },
1664 { "-foreground", 0, 10, 1 },
1665 { "-bd", "--border-color", 10, 1 },
1666 { "-bw", "--border-width", 10, 1 },
1667 { "-ib", "--internal-border", 10, 1 },
1668 { "-ms", "--mouse-color", 10, 1 },
1669 { "-cr", "--cursor-color", 10, 1 },
1670 { "-fn", "--font", 10, 1 },
1671 { "-font", 0, 10, 1 },
1672 { "-fs", "--fullscreen", 10, 0 },
1673 { "-fw", "--fullwidth", 10, 0 },
1674 { "-fh", "--fullheight", 10, 0 },
1675 { "-mm", "--maximized", 10, 0 },
1676 { "-g", "--geometry", 10, 1 },
1677 { "-geometry", 0, 10, 1 },
1678 { "-T", "--title", 10, 1 },
1679 { "-title", 0, 10, 1 },
1680 { "-name", "--name", 10, 1 },
1681 { "-xrm", "--xrm", 10, 1 },
1682 { "-parent-id", "--parent-id", 10, 1 },
1683 { "-r", "--reverse-video", 5, 0 },
1685 { "-reverse", 0, 5, 0 },
1686 { "-hb", "--horizontal-scroll-bars", 5, 0 },
1687 { "-vb", "--vertical-scroll-bars", 5, 0 },
1688 { "-color", "--color", 5, 0},
1689 { "-no-splash", "--no-splash", 3, 0 },
1690 { "-no-desktop", "--no-desktop", 3, 0 },
1692 { "-NSAutoLaunch", 0, 5, 1 },
1693 { "-NXAutoLaunch", 0, 5, 1 },
1694 { "-_NSMachLaunch", 0, 85, 1 },
1695 { "-MachLaunch", 0, 85, 1 },
1696 { "-macosx", 0, 85, 0 },
1697 { "-NSHost", 0, 85, 1 },
1699 /* These have the same priority as ordinary file name args,
1700 so they are not reordered with respect to those. */
1701 { "-L", "--directory", 0, 1 },
1702 { "-directory", 0, 0, 1 },
1703 { "-l", "--load", 0, 1 },
1704 { "-load", 0, 0, 1 },
1705 /* This has no longname, because using --scriptload confuses sort_args,
1706 because then the --script long option seems to match twice; ie
1707 you can't have a long option which is a prefix of another long
1708 option. In any case, this is entirely an internal option. */
1709 { "-scriptload", NULL
, 0, 1 },
1710 { "-f", "--funcall", 0, 1 },
1711 { "-funcall", 0, 0, 1 },
1712 { "-eval", "--eval", 0, 1 },
1713 { "-execute", "--execute", 0, 1 },
1714 { "-find-file", "--find-file", 0, 1 },
1715 { "-visit", "--visit", 0, 1 },
1716 { "-file", "--file", 0, 1 },
1717 { "-insert", "--insert", 0, 1 },
1719 { "-NXOpen", 0, 0, 1 },
1720 { "-NXOpenTemp", 0, 0, 1 },
1721 { "-NSOpen", 0, 0, 1 },
1722 { "-NSOpenTemp", 0, 0, 1 },
1723 { "-GSFilePath", 0, 0, 1 },
1725 /* This should be processed after ordinary file name args and the like. */
1726 { "-kill", "--kill", -10, 0 },
1729 /* Reorder the elements of ARGV (assumed to have ARGC elements)
1730 so that the highest priority ones come first.
1731 Do not change the order of elements of equal priority.
1732 If an option takes an argument, keep it and its argument together.
1734 If an option that takes no argument appears more
1735 than once, eliminate all but one copy of it. */
1738 sort_args (int argc
, char **argv
)
1740 char **new = xmalloc (argc
* sizeof *new);
1741 /* For each element of argv,
1742 the corresponding element of options is:
1743 0 for an option that takes no arguments,
1744 1 for an option that takes one argument, etc.
1745 -1 for an ordinary non-option argument. */
1746 int *options
= xnmalloc (argc
, sizeof *options
);
1747 int *priority
= xnmalloc (argc
, sizeof *priority
);
1749 int incoming_used
= 1;
1753 /* Categorize all the options,
1754 and figure out which argv elts are option arguments. */
1755 for (from
= 1; from
< argc
; from
++)
1759 if (argv
[from
][0] == '-')
1763 /* If we have found "--", don't consider
1764 any more arguments as options. */
1765 if (argv
[from
][1] == '-' && argv
[from
][2] == 0)
1767 /* Leave the "--", and everything following it, at the end. */
1768 for (; from
< argc
; from
++)
1770 priority
[from
] = -100;
1776 /* Look for a match with a known old-fashioned option. */
1777 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1778 if (!strcmp (argv
[from
], standard_args
[i
].name
))
1780 options
[from
] = standard_args
[i
].nargs
;
1781 priority
[from
] = standard_args
[i
].priority
;
1782 if (from
+ standard_args
[i
].nargs
>= argc
)
1783 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1784 from
+= standard_args
[i
].nargs
;
1788 /* Look for a match with a known long option.
1789 MATCH is -1 if no match so far, -2 if two or more matches so far,
1790 >= 0 (the table index of the match) if just one match so far. */
1791 if (argv
[from
][1] == '-')
1793 char const *equals
= strchr (argv
[from
], '=');
1795 equals
? equals
- argv
[from
] : strlen (argv
[from
]);
1799 for (i
= 0; i
< ARRAYELTS (standard_args
); i
++)
1800 if (standard_args
[i
].longname
1801 && !strncmp (argv
[from
], standard_args
[i
].longname
,
1810 /* If we found exactly one match, use that. */
1813 options
[from
] = standard_args
[match
].nargs
;
1814 priority
[from
] = standard_args
[match
].priority
;
1815 /* If --OPTION=VALUE syntax is used,
1816 this option uses just one argv element. */
1819 if (from
+ options
[from
] >= argc
)
1820 fatal ("Option '%s' requires an argument\n", argv
[from
]);
1821 from
+= options
[from
];
1823 /* FIXME When match < 0, shouldn't there be some error,
1824 or at least indication to the user that there was a
1831 /* Copy the arguments, in order of decreasing priority, to NEW. */
1833 while (incoming_used
< argc
)
1836 int best_priority
= -9999;
1838 /* Find the highest priority remaining option.
1839 If several have equal priority, take the first of them. */
1840 for (from
= 1; from
< argc
; from
++)
1842 if (argv
[from
] != 0 && priority
[from
] > best_priority
)
1844 best_priority
= priority
[from
];
1847 /* Skip option arguments--they are tied to the options. */
1848 if (options
[from
] > 0)
1849 from
+= options
[from
];
1855 /* Copy the highest priority remaining option, with its args, to NEW.
1856 Unless it is a duplicate of the previous one. */
1857 if (! (options
[best
] == 0
1858 && ! strcmp (new[to
- 1], argv
[best
])))
1860 new[to
++] = argv
[best
];
1861 for (i
= 0; i
< options
[best
]; i
++)
1862 new[to
++] = argv
[best
+ i
+ 1];
1865 incoming_used
+= 1 + (options
[best
] > 0 ? options
[best
] : 0);
1867 /* Clear out this option in ARGV. */
1869 for (i
= 0; i
< options
[best
]; i
++)
1870 argv
[best
+ i
+ 1] = 0;
1873 /* If duplicate options were deleted, fill up extra space with null ptrs. */
1877 memcpy (argv
, new, sizeof (char *) * argc
);
1884 DEFUN ("kill-emacs", Fkill_emacs
, Skill_emacs
, 0, 1, "P",
1885 doc
: /* Exit the Emacs job and kill it.
1886 If ARG is an integer, return ARG as the exit program code.
1887 If ARG is a string, stuff it as keyboard input.
1889 This function is called upon receipt of the signals SIGTERM
1890 or SIGHUP, and upon SIGINT in batch mode.
1892 The value of `kill-emacs-hook', if not void,
1893 is a list of functions (of no args),
1894 all of which are called before Emacs is actually killed. */
1895 attributes
: noreturn
)
1900 /* Fsignal calls emacs_abort () if it sees that waiting_for_input is
1902 waiting_for_input
= 0;
1903 run_hook (Qkill_emacs_hook
);
1905 #ifdef HAVE_X_WINDOWS
1906 /* Transfer any clipboards we own to the clipboard manager. */
1907 x_clipboard_manager_save_all ();
1910 shut_down_emacs (0, (STRINGP (arg
) && !feof (stdin
)) ? arg
: Qnil
);
1913 ns_release_autorelease_pool (ns_pool
);
1916 /* If we have an auto-save list file,
1917 kill it because we are exiting Emacs deliberately (not crashing).
1918 Do it after shut_down_emacs, which does an auto-save. */
1919 if (STRINGP (Vauto_save_list_file_name
))
1921 Lisp_Object listfile
;
1922 listfile
= Fexpand_file_name (Vauto_save_list_file_name
, Qnil
);
1923 unlink (SSDATA (listfile
));
1927 exit_code
= (XINT (arg
) < 0
1928 ? XINT (arg
) | INT_MIN
1929 : XINT (arg
) & INT_MAX
);
1931 exit_code
= EXIT_SUCCESS
;
1936 /* Perform an orderly shutdown of Emacs. Autosave any modified
1937 buffers, kill any child processes, clean up the terminal modes (if
1938 we're in the foreground), and other stuff like that. Don't perform
1939 any redisplay; this may be called when Emacs is shutting down in
1940 the background, or after its X connection has died.
1942 If SIG is a signal number, print a message for it.
1944 This is called by fatal signal handlers, X protocol error handlers,
1948 shut_down_emacs (int sig
, Lisp_Object stuff
)
1950 /* Prevent running of hooks from now on. */
1953 /* Don't update display from now on. */
1954 Vinhibit_redisplay
= Qt
;
1956 /* If we are controlling the terminal, reset terminal modes. */
1959 pid_t pgrp
= getpgrp ();
1960 pid_t tpgrp
= tcgetpgrp (0);
1961 if ((tpgrp
!= -1) && tpgrp
== pgrp
)
1963 reset_all_sys_modes ();
1964 if (sig
&& sig
!= SIGTERM
)
1966 static char const format
[] = "Fatal error %d: ";
1967 char buf
[sizeof format
- 2 + INT_STRLEN_BOUND (int)];
1968 int buflen
= sprintf (buf
, format
, sig
);
1969 char const *sig_desc
= safe_strsignal (sig
);
1970 emacs_write (STDERR_FILENO
, buf
, buflen
);
1971 emacs_write (STDERR_FILENO
, sig_desc
, strlen (sig_desc
));
1977 reset_all_sys_modes ();
1980 stuff_buffered_input (stuff
);
1982 inhibit_sentinels
= 1;
1983 kill_buffer_processes (Qnil
);
1984 Fdo_auto_save (Qt
, Qnil
);
1986 unlock_all_files ();
1988 /* There is a tendency for a SIGIO signal to arrive within exit,
1989 and cause a SIGHUP because the input descriptor is already closed. */
1992 /* Do this only if terminating normally, we want glyph matrices
1993 etc. in a core dump. */
1994 if (sig
== 0 || sig
== SIGTERM
)
1996 check_glyph_memory ();
1997 check_message_stack ();
2005 ns_term_shutdown (sig
);
2009 xml_cleanup_parser ();
2023 DEFUN ("dump-emacs", Fdump_emacs
, Sdump_emacs
, 2, 2, 0,
2024 doc
: /* Dump current state of Emacs into executable file FILENAME.
2025 Take symbols from SYMFILE (presumably the file you executed to run Emacs).
2026 This is used in the file `loadup.el' when building Emacs.
2028 You must run Emacs in batch mode in order to dump it. */)
2029 (Lisp_Object filename
, Lisp_Object symfile
)
2033 ptrdiff_t count
= SPECPDL_INDEX ();
2037 if (! noninteractive
)
2038 error ("Dumping Emacs works only in batch mode");
2041 error ("Emacs can be dumped only once");
2045 /* Warn if the gap between BSS end and heap start is larger than this. */
2046 # define MAX_HEAP_BSS_DIFF (1024*1024)
2048 if (heap_bss_diff
> MAX_HEAP_BSS_DIFF
)
2050 fprintf (stderr
, "**************************************************\n");
2051 fprintf (stderr
, "Warning: Your system has a gap between BSS and the\n");
2052 fprintf (stderr
, "heap (%"pMu
" bytes). This usually means that exec-shield\n",
2054 fprintf (stderr
, "or something similar is in effect. The dump may\n");
2055 fprintf (stderr
, "fail because of this. See the section about\n");
2056 fprintf (stderr
, "exec-shield in etc/PROBLEMS for more information.\n");
2057 fprintf (stderr
, "**************************************************\n");
2059 #endif /* GNU_LINUX */
2061 /* Bind `command-line-processed' to nil before dumping,
2062 so that the dumped Emacs will process its command line
2063 and set up to work with X windows if appropriate. */
2064 symbol
= intern ("command-line-processed");
2065 specbind (symbol
, Qnil
);
2067 CHECK_STRING (filename
);
2068 filename
= Fexpand_file_name (filename
, Qnil
);
2069 filename
= ENCODE_FILE (filename
);
2070 if (!NILP (symfile
))
2072 CHECK_STRING (symfile
);
2073 if (SCHARS (symfile
))
2075 symfile
= Fexpand_file_name (symfile
, Qnil
);
2076 symfile
= ENCODE_FILE (symfile
);
2081 Vpurify_flag
= Qnil
;
2083 #ifdef HYBRID_MALLOC
2085 static char const fmt
[] = "%d of %d static heap bytes used";
2086 char buf
[sizeof fmt
+ 2 * (INT_STRLEN_BOUND (int) - 2)];
2087 int max_usage
= max_bss_sbrk_ptr
- bss_sbrk_buffer
;
2088 sprintf (buf
, fmt
, max_usage
, STATIC_HEAP_SIZE
);
2089 /* Don't log messages, because at this point buffers cannot be created. */
2090 message1_nolog (buf
);
2095 /* Tell malloc where start of impure now is. */
2096 /* Also arrange for warnings when nearly out of space. */
2097 #if !defined SYSTEM_MALLOC && !defined HYBRID_MALLOC
2099 /* On Windows, this was done before dumping, and that once suffices.
2100 Meanwhile, my_edata is not valid on Windows. */
2101 memory_warnings (my_edata
, malloc_warning
);
2102 #endif /* not WINDOWSNT */
2103 #endif /* not SYSTEM_MALLOC and not HYBRID_MALLOC */
2105 alloc_unexec_pre ();
2107 unexec (SSDATA (filename
), !NILP (symfile
) ? SSDATA (symfile
) : 0);
2109 alloc_unexec_post ();
2112 Vlibrary_cache
= Qnil
;
2114 #ifdef HAVE_WINDOW_SYSTEM
2115 reset_image_types ();
2120 return unbind_to (count
, Qnil
);
2123 #endif /* not CANNOT_DUMP */
2126 /* Recover from setlocale (LC_ALL, ""). */
2130 /* The Emacs Lisp reader needs LC_NUMERIC to be "C",
2131 so that numbers are read and printed properly for Emacs Lisp. */
2132 setlocale (LC_NUMERIC
, "C");
2135 /* Set system locale CATEGORY, with previous locale *PLOCALE, to
2138 synchronize_locale (int category
, Lisp_Object
*plocale
, Lisp_Object desired_locale
)
2140 if (! EQ (*plocale
, desired_locale
))
2142 *plocale
= desired_locale
;
2144 /* Changing categories like LC_TIME usually requires specifying
2145 an encoding suitable for the new locale, but MS-Windows's
2146 'setlocale' will only switch the encoding when LC_ALL is
2147 specified. So we ignore CATEGORY, use LC_ALL instead, and
2148 then restore LC_NUMERIC to "C", so reading and printing
2149 numbers is unaffected. */
2150 setlocale (LC_ALL
, (STRINGP (desired_locale
)
2151 ? SSDATA (desired_locale
)
2154 #else /* !WINDOWSNT */
2155 setlocale (category
, (STRINGP (desired_locale
)
2156 ? SSDATA (desired_locale
)
2158 #endif /* !WINDOWSNT */
2162 /* Set system time locale to match Vsystem_time_locale, if possible. */
2164 synchronize_system_time_locale (void)
2166 synchronize_locale (LC_TIME
, &Vprevious_system_time_locale
,
2167 Vsystem_time_locale
);
2170 /* Set system messages locale to match Vsystem_messages_locale, if
2173 synchronize_system_messages_locale (void)
2176 synchronize_locale (LC_MESSAGES
, &Vprevious_system_messages_locale
,
2177 Vsystem_messages_locale
);
2180 #endif /* HAVE_SETLOCALE */
2184 decode_env_path (const char *evarname
, const char *defalt
, bool empty
)
2186 const char *path
, *p
;
2187 Lisp_Object lpath
, element
, tem
;
2188 /* Default is to use "." for empty path elements.
2189 But if argument EMPTY is true, use nil instead. */
2190 Lisp_Object empty_element
= empty
? Qnil
: build_string (".");
2193 static const char *emacs_dir_env
= "%emacs_dir%/";
2194 const size_t emacs_dir_len
= strlen (emacs_dir_env
);
2195 const char *edir
= egetenv ("emacs_dir");
2196 char emacs_dir
[MAX_UTF8_PATH
];
2198 /* egetenv looks in process-environment, which holds the variables
2199 in their original system-locale encoding. We need emacs_dir to
2202 filename_from_ansi (edir
, emacs_dir
);
2205 /* It's okay to use getenv here, because this function is only used
2206 to initialize variables when Emacs starts up, and isn't called
2209 path
= getenv (evarname
);
2220 /* Ensure values from the environment use the proper directory separator. */
2226 char *path_utf8
, *q
, *d
;
2229 /* Convert each element of PATH to UTF-8. */
2230 p
= path_copy
= alloca (strlen (path
) + 1);
2231 strcpy (path_copy
, path
);
2232 d
= path_utf8
= alloca (4 * strlen (path
) + 1);
2235 q
= _mbschr (p
, SEPCHAR
);
2238 cnv_result
= filename_from_ansi (p
, d
);
2243 /* If conversion of this PATH elements fails, make sure
2244 destination pointer will stay put, thus effectively
2245 ignoring the offending element. */
2246 if (cnv_result
== 0)
2252 else if (cnv_result
!= 0 && d
> path_utf8
)
2253 d
[-1] = '\0'; /* remove last semi-colon and null-terminate PATH */
2255 path_copy
= path_utf8
;
2257 path_copy
= alloca (strlen (path
) + 1);
2258 strcpy (path_copy
, path
);
2260 dostounix_filename (path_copy
);
2267 p
= strchr (path
, SEPCHAR
);
2269 p
= path
+ strlen (path
);
2270 element
= ((p
- path
) ? make_unibyte_string (path
, p
- path
)
2272 if (! NILP (element
))
2275 /* Relative file names in the default path are interpreted as
2276 being relative to $emacs_dir. */
2277 if (edir
&& defaulted
2278 && strncmp (path
, emacs_dir_env
, emacs_dir_len
) == 0)
2279 element
= Fexpand_file_name (Fsubstring
2281 make_number (emacs_dir_len
),
2283 build_unibyte_string (emacs_dir
));
2286 /* Add /: to the front of the name
2287 if it would otherwise be treated as magic. */
2288 tem
= Ffind_file_name_handler (element
, Qt
);
2290 /* However, if the handler says "I'm safe",
2291 don't bother adding /:. */
2295 prop
= Fget (tem
, intern ("safe-magic"));
2302 AUTO_STRING (slash_colon
, "/:");
2303 element
= concat2 (slash_colon
, element
);
2305 } /* !NILP (element) */
2307 lpath
= Fcons (element
, lpath
);
2313 return Fnreverse (lpath
);
2316 DEFUN ("daemonp", Fdaemonp
, Sdaemonp
, 0, 0, 0,
2317 doc
: /* Return non-nil if the current emacs process is a daemon.
2318 If the daemon was given a name argument, return that name. */)
2323 return build_string (daemon_name
);
2330 DEFUN ("daemon-initialized", Fdaemon_initialized
, Sdaemon_initialized
, 0, 0, 0,
2331 doc
: /* Mark the Emacs daemon as being initialized.
2332 This finishes the daemonization process by doing the other half of detaching
2333 from the parent process and its tty file descriptors. */)
2339 error ("This function can only be called if emacs is run as a daemon");
2341 if (!DAEMON_RUNNING
)
2342 error ("The daemon has already been initialized");
2344 if (NILP (Vafter_init_time
))
2345 error ("This function can only be called after loading the init files");
2349 /* Get rid of stdin, stdout and stderr. */
2350 nfd
= emacs_open ("/dev/null", O_RDWR
, 0);
2352 err
|= dup2 (nfd
, 0) < 0;
2353 err
|= dup2 (nfd
, 1) < 0;
2354 err
|= dup2 (nfd
, 2) < 0;
2355 err
|= emacs_close (nfd
) != 0;
2357 /* Closing the pipe will notify the parent that it can exit.
2358 FIXME: In case some other process inherited the pipe, closing it here
2359 won't notify the parent because it's still open elsewhere, so we
2360 additionally send a byte, just to make sure the parent really exits.
2361 Instead, we should probably close the pipe in start-process and
2362 call-process to make sure the pipe is never inherited by
2364 err
|= write (daemon_pipe
[1], "\n", 1) < 0;
2365 err
|= emacs_close (daemon_pipe
[1]) != 0;
2366 /* Set it to an invalid value so we know we've already run this function. */
2367 daemon_pipe
[1] = -1;
2368 #else /* WINDOWSNT */
2369 /* Signal the waiting emacsclient process. */
2370 err
|= SetEvent (w32_daemon_event
) == 0;
2371 err
|= CloseHandle (w32_daemon_event
) == 0;
2372 /* Set it to an invalid value so we know we've already run this function. */
2373 w32_daemon_event
= INVALID_HANDLE_VALUE
;
2377 error ("I/O error during daemon initialization");
2382 syms_of_emacs (void)
2384 DEFSYM (Qfile_name_handler_alist
, "file-name-handler-alist");
2385 DEFSYM (Qrisky_local_variable
, "risky-local-variable");
2386 DEFSYM (Qkill_emacs
, "kill-emacs");
2387 DEFSYM (Qkill_emacs_hook
, "kill-emacs-hook");
2390 defsubr (&Sdump_emacs
);
2393 defsubr (&Skill_emacs
);
2395 defsubr (&Sinvocation_name
);
2396 defsubr (&Sinvocation_directory
);
2397 defsubr (&Sdaemonp
);
2398 defsubr (&Sdaemon_initialized
);
2400 DEFVAR_LISP ("command-line-args", Vcommand_line_args
,
2401 doc
: /* Args passed by shell to Emacs, as a list of strings.
2402 Many arguments are deleted from the list as they are processed. */);
2404 DEFVAR_LISP ("system-type", Vsystem_type
,
2405 doc
: /* The value is a symbol indicating the type of operating system you are using.
2407 `gnu' compiled for a GNU Hurd system.
2408 `gnu/linux' compiled for a GNU/Linux system.
2409 `gnu/kfreebsd' compiled for a GNU system with a FreeBSD kernel.
2410 `darwin' compiled for Darwin (GNU-Darwin, Mac OS X, ...).
2411 `ms-dos' compiled as an MS-DOS application.
2412 `windows-nt' compiled as a native W32 application.
2413 `cygwin' compiled using the Cygwin library.
2414 Anything else (in Emacs 24.1, the possibilities are: aix, berkeley-unix,
2415 hpux, irix, usg-unix-v) indicates some sort of Unix system. */);
2416 Vsystem_type
= intern_c_string (SYSTEM_TYPE
);
2417 /* See configure.ac for the possible SYSTEM_TYPEs. */
2419 DEFVAR_LISP ("system-configuration", Vsystem_configuration
,
2420 doc
: /* Value is string indicating configuration Emacs was built for. */);
2421 Vsystem_configuration
= build_string (EMACS_CONFIGURATION
);
2423 DEFVAR_LISP ("system-configuration-options", Vsystem_configuration_options
,
2424 doc
: /* String containing the configuration options Emacs was built with. */);
2425 Vsystem_configuration_options
= build_string (EMACS_CONFIG_OPTIONS
);
2427 DEFVAR_LISP ("system-configuration-features", Vsystem_configuration_features
,
2428 doc
: /* String listing some of the main features this Emacs was compiled with.
2429 An element of the form \"FOO\" generally means that HAVE_FOO was
2430 defined during the build.
2432 This is mainly intended for diagnostic purposes in bug reports.
2433 Don't rely on it for testing whether a feature you want to use is available. */);
2434 Vsystem_configuration_features
= build_string (EMACS_CONFIG_FEATURES
);
2436 DEFVAR_BOOL ("noninteractive", noninteractive1
,
2437 doc
: /* Non-nil means Emacs is running without interactive terminal. */);
2439 DEFVAR_LISP ("kill-emacs-hook", Vkill_emacs_hook
,
2440 doc
: /* Hook run when `kill-emacs' is called.
2441 Since `kill-emacs' may be invoked when the terminal is disconnected (or
2442 in other similar situations), functions placed on this hook should not
2443 expect to be able to interact with the user. To ask for confirmation,
2444 see `kill-emacs-query-functions' instead.
2446 Before Emacs 24.1, the hook was not run in batch mode, i.e., if
2447 `noninteractive' was non-nil. */);
2448 Vkill_emacs_hook
= Qnil
;
2450 DEFVAR_LISP ("path-separator", Vpath_separator
,
2451 doc
: /* String containing the character that separates directories in
2452 search paths, such as PATH and other similar environment variables. */);
2455 Vpath_separator
= make_string (&c
, 1);
2458 DEFVAR_LISP ("invocation-name", Vinvocation_name
,
2459 doc
: /* The program name that was used to run Emacs.
2460 Any directory names are omitted. */);
2462 DEFVAR_LISP ("invocation-directory", Vinvocation_directory
,
2463 doc
: /* The directory in which the Emacs executable was found, to run it.
2464 The value is nil if that directory's name is not known. */);
2466 DEFVAR_LISP ("installation-directory", Vinstallation_directory
,
2467 doc
: /* A directory within which to look for the `lib-src' and `etc' directories.
2468 In an installed Emacs, this is normally nil. It is non-nil if
2469 both `lib-src' (on MS-DOS, `info') and `etc' directories are found
2470 within the variable `invocation-directory' or its parent. For example,
2471 this is the case when running an uninstalled Emacs executable from its
2472 build directory. */);
2473 Vinstallation_directory
= Qnil
;
2475 DEFVAR_LISP ("system-messages-locale", Vsystem_messages_locale
,
2476 doc
: /* System locale for messages. */);
2477 Vsystem_messages_locale
= Qnil
;
2479 DEFVAR_LISP ("previous-system-messages-locale",
2480 Vprevious_system_messages_locale
,
2481 doc
: /* Most recently used system locale for messages. */);
2482 Vprevious_system_messages_locale
= Qnil
;
2484 DEFVAR_LISP ("system-time-locale", Vsystem_time_locale
,
2485 doc
: /* System locale for time. */);
2486 Vsystem_time_locale
= Qnil
;
2488 DEFVAR_LISP ("previous-system-time-locale", Vprevious_system_time_locale
,
2489 doc
: /* Most recently used system locale for time. */);
2490 Vprevious_system_time_locale
= Qnil
;
2492 DEFVAR_LISP ("before-init-time", Vbefore_init_time
,
2493 doc
: /* Value of `current-time' before Emacs begins initialization. */);
2494 Vbefore_init_time
= Qnil
;
2496 DEFVAR_LISP ("after-init-time", Vafter_init_time
,
2497 doc
: /* Value of `current-time' after loading the init files.
2498 This is nil during initialization. */);
2499 Vafter_init_time
= Qnil
;
2501 DEFVAR_BOOL ("inhibit-x-resources", inhibit_x_resources
,
2502 doc
: /* If non-nil, X resources, Windows Registry settings, and NS defaults are not used. */);
2503 inhibit_x_resources
= 0;
2505 DEFVAR_LISP ("emacs-copyright", Vemacs_copyright
,
2506 doc
: /* Short copyright string for this version of Emacs. */);
2507 Vemacs_copyright
= build_string (emacs_copyright
);
2509 DEFVAR_LISP ("emacs-version", Vemacs_version
,
2510 doc
: /* Version numbers of this version of Emacs. */);
2511 Vemacs_version
= build_string (emacs_version
);
2513 DEFVAR_LISP ("report-emacs-bug-address", Vreport_emacs_bug_address
,
2514 doc
: /* Address of mailing list for GNU Emacs bugs. */);
2515 Vreport_emacs_bug_address
= build_string (emacs_bugreport
);
2517 DEFVAR_LISP ("dynamic-library-alist", Vdynamic_library_alist
,
2518 doc
: /* Alist of dynamic libraries vs external files implementing them.
2519 Each element is a list (LIBRARY FILE...), where the car is a symbol
2520 representing a supported external library, and the rest are strings giving
2521 alternate filenames for that library.
2523 Emacs tries to load the library from the files in the order they appear on
2524 the list; if none is loaded, the running session of Emacs won't have access
2527 Note that image types `pbm' and `xbm' do not need entries in this variable
2528 because they do not depend on external libraries and are always available.
2530 Also note that this is not a generic facility for accessing external
2531 libraries; only those already known by Emacs will be loaded. */);
2532 Vdynamic_library_alist
= Qnil
;
2533 Fput (intern_c_string ("dynamic-library-alist"), Qrisky_local_variable
, Qt
);
2536 Vlibrary_cache
= Qnil
;
2537 staticpro (&Vlibrary_cache
);