1. BINARY DISTRIBUTION
1.1. Quick start
- 1.2. Finding ancilliary files
+ 1.2. Finding ancillary files
1.3. Anatomy of SBCL
2. SOURCE DISTRIBUTION
by the environment variable "INSTALL_ROOT".
If you install SBCL from binary distribution in other location then
- "/usr/local", see section 1.2, "Finding ancilliary files".
+ "/usr/local", see section 1.2, "Finding ancillary files".
-1.2. Finding ancilliary files
+1.2. Finding ancillary files
The SBCL runtime needs to be able to find the ancillary files
associated with it: the "sbcl.core" file, and the contrib modules.
- This can happen in three ways:
+ Finding core can happen in three ways:
1. By default, in a location configured when the system was built.
For binary distributions this is in "/usr/local/lib/sbcl".
$ sbcl --core /foo/bar/sbcl.core
- When using this option contrib modules are looked for in the
- directory where the designated core resides, and in "SBCL_HOME".
-
The usual, recommended approach is method #1. Method #2 is useful if
you're installing SBCL on a system in a non-standard location
(e.g. in your user account), instead of installing SBCL on an entire
system. Method #3 is mostly useful for testing or other special
cases.
+ Contributed modules are primarily looked for in "SBCL_HOME", or the
+ directory the core resides in if "SBCL_HOME" is not set.
+ ASDF:*CENTRAL-REGISTRY* serves as an additional fallback for
+ ASDF-based modules.
+
1.3. Anatomy of SBCL
The two files that SBCL needs to run, at minimum, are:
passed their tests. If you need to install by hand, see "install.sh"
for details.
- Documentation concists of a man-page, the SBCL Manual (in info, pdf
+ Documentation consists of a man-page, the SBCL Manual (in info, pdf
and html formats), and a few additional text files.
2. SOURCE DISTRIBUTION
If you don't already have an SBCL binary installed as "sbcl" on your
system, you'll need to tell make.sh what Lisp to use as the
- cross-compilation host. For example, to use CMU CL (assuming has
+ cross-compilation host. For example, to use CMUCL (assuming has
been installed under its default name "lisp") as the
cross-compilation host:
Other
- * Check that the host lisp you're building with is known to work
- as an SBCL build host, and the your OS is supported.
+ * Check that the host lisp you're building with is known to work as
+ an SBCL build host, and that your operating system is supported.
+
+ * Try to do a build without loading any initialization files
+ for the cross-compilation host (for example
+ "sh make.sh 'sbcl --userinit /dev/null --sysinit /dev/null'").
* Some GCC versions are known to have bugs that affect SBCL
compilation: if the error you're encountering seems related to
All of the following platforms are supported in the sense of "should
work", but some things like loading foreign object files may lag
- behind on less-used OS's.
+ behind on less-used operating systems.
Supported toolchains:
CMUCL
OpenMCL
CLISP (recent versions only)
+ ABCL (recent versions only)
Note that every release isn't tested with every possible host
compiler. You're most likely to get a clean build with SBCL itself
Tru64 X
Darwin (Mac OS X) X
- Some OS's are more equal then others: most of the development and
- testing is done on x86 Linux and *BSD, PPC Linux and Mac OS X.
+ Some operating systems are more equal then others: most of the
+ development and testing is done on x86 Linux and *BSD, PPC Linux
+ and Mac OS X.
If an underprivileged platform is important to you, you can help
by eg. testing during the monthly freeze periods, and most