X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=doc%2Fsbcl.1;h=c088876f12a80a712c8d6975a7e6a76cb6daebc9;hb=f961fda4e87e79aacc6c61172303106d3e9522de;hp=2f86938e8c0cd5d6584d01776634862dcbca6257;hpb=2f4ae65a93c2ef74c58dc62abb2ab42e4e472a30;p=sbcl.git diff --git a/doc/sbcl.1 b/doc/sbcl.1 index 2f86938..c088876 100644 --- a/doc/sbcl.1 +++ b/doc/sbcl.1 @@ -41,7 +41,7 @@ To run SBCL, type "sbcl". After startup messages a prompt execute it, print any values returned, give you another prompt, and wait for your next input. -\f(C +\f(CR $ sbcl ...[startup messages elided]... * (+ 1 2 3) @@ -105,10 +105,38 @@ startup. (This makes it easier to write Lisp programs which work cleanly in Unix pipelines. See also the "\-\-noprint" and "\-\-disable\-debugger" options.) .TP 3 +.B \-\-disable\-ldb +Disable the low-level debugger. Only effective if SBCL is compiled with LDB. +.TP 3 +.B \-\-lose\-on\-corruption +There are some dangerous low level errors (for instance, control stack +exhausted, memory fault) that (or whose handlers) can corrupt the +image. By default SBCL prints a warning, then tries to continue and +handle the error in Lisp, but this will not always work and SBCL may +malfunction or even hang. With this option, upon encountering such an +error SBCL will invoke ldb (if present and enabled) or else exit. +.TP 3 .B \-\-script -As a runtime option equivalent to \-\-noinform -\-\-end\-toplevel\-options \-\-script . See the description -of \-\-script as a toplevel option below. +As a runtime option equivalent to \-\-noinform \-\-disable\-ldb +\-\-lose\-on\-corruption \-\-end\-runtime\-options \-\-script +. See the description of \-\-script as a toplevel option +below. +.TP 3 +.B \-\-merge\-core\-pages +When platform support is present, provide hints to the operating +system that identical pages may be shared between processes until they +are written to. This can be useful to reduce the memory usage on +systems with multiple SBCL processes started from similar but +differently\-named core files, or from compressed cores. Without +platform support, do nothing. +.TP 3 +.B \-\-no-merge\-core\-pages +Ensures that no sharing hint is provided to the operating system. +.TP 3 +.B \-\-default\-merge\-core\-pages +Reverts the sharing hint policy to the default: only compressed cores +trigger hinting. Uncompressed cores are mapped directly from the core +file, which is usually enough to ensure sharing. .TP 3 .B \-\-help Print some basic information about SBCL, then exit. @@ -166,6 +194,18 @@ debugger, allowing interactive diagnosis and possible intercession. This option disables the debugger, causing errors to print a backtrace and exit with status 1 instead -- which is a mode of operation better suited for batch processing. See the User Manual on \f(CRSB\-EXT:DISABLE\-DEBUGGER\fR for details. +.TP 3 +.B \-\-quit +At the end of toplevel option processing, exit SBCL with a successful +code of zero. Note that the effect of this option is delayed until after +toplevel options following this one. +.TP 3 +.B \-\-non-interactive +This option disables the read-eval-print loop for both exceptional and +non-exceptional reasons. It is short for --disable-debugger and --quit in +combination and is useful for batch uses where the special option processing +implied by --script is not desired. +.TP 3 .B \-\-script Implies \-\-no-sysinit \-\-no-userinit \-\-disable-debugger \-\-end\-toplevel\-options.