Go to file
Turbo Fredriksson 37d7cd94f3 Support parallel build trees (VPATH builds)
Build products from an out of tree build should be written
relative to the build directory.  Sources should be referred
to by their locations in the source directory.

This is accomplished by adding the 'src' and 'obj' variables
for the module Makefile.am, using relative paths to reference
source files, and by setting VPATH when source files are not
co-located with the Makefile.  This enables the following:

  $ mkdir build
  $ cd build
  $ ../configure
  $ make -s

This change also has the advantage of resolving the following
warning which is generated by modern versions of automake.

  Makefile.am:00: warning: source file 'xxx' is in a subdirectory,
  Makefile.am:00: but option 'subdir-objects' is disabled

Signed-off-by: Turbo Fredriksson <turbo@bayour.com>
Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
Issue zfsonlinux/zfs#1082
2015-07-17 12:53:11 -07:00
cmd Retire legacy debugging infrastructure 2014-11-19 10:35:07 -08:00
config Support parallel build trees (VPATH builds) 2015-07-17 12:53:11 -07:00
include Support parallel build trees (VPATH builds) 2015-07-17 12:53:11 -07:00
lib Remove autotools products 2012-08-27 11:46:23 -07:00
man Add TASKQ_DYNAMIC feature 2015-06-24 15:14:18 -07:00
module Support parallel build trees (VPATH builds) 2015-07-17 12:53:11 -07:00
rpm Tag spl-0.6.4 2015-04-08 14:03:42 -07:00
scripts Support parallel build trees (VPATH builds) 2015-07-17 12:53:11 -07:00
.gitignore Ignore *.{deb,rpm,tar.gz} files in the top directory. 2013-04-24 16:18:14 -07:00
AUTHORS Refresh AUTHORS 2012-12-19 09:40:18 -08:00
autogen.sh build: do not call boilerplate ourself 2013-04-02 11:08:46 -07:00
configure.ac Add RHEL style kmod packages 2015-03-27 14:42:04 -07:00
copy-builtin Copy spl.release.in to kernel dir 2013-06-21 15:40:04 -07:00
COPYING Public Release Prep 2010-05-17 15:18:00 -07:00
DISCLAIMER Public Release Prep 2010-05-17 15:18:00 -07:00
Makefile.am Support parallel build trees (VPATH builds) 2015-07-17 12:53:11 -07:00
META Tag spl-0.6.4 2015-04-08 14:03:42 -07:00
README.markdown Document how to run SPLAT 2013-10-09 13:52:59 -07:00
spl.release.in Move spl.release generation to configure step 2012-07-12 12:13:47 -07:00

The Solaris Porting Layer (SPL) is a Linux kernel module which provides many of the Solaris kernel APIs. This shim layer makes it possible to run Solaris kernel code in the Linux kernel with relatively minimal modification. This can be particularly useful when you want to track upstream Solaris development closely and do not want the overhead of maintaining a large patch which converts Solaris primitives to Linux primitives.

To build packages for your distribution:

$ ./configure
$ make pkg

If you are building directly from the git tree and not an officially released tarball you will need to generate the configure script. This can be done by executing the autogen.sh script after installing the GNU autotools for your distribution.

To copy the kernel code inside your kernel source tree for builtin compilation:

$ ./configure --enable-linux-builtin --with-linux=/usr/src/linux-...
$ ./copy-builtin /usr/src/linux-...

The SPL comes with an automated test suite called SPLAT. The test suite is implemented in two parts. There is a kernel module which contains the tests and a user space utility which controls which tests are run. To run the full test suite:

$ sudo insmod ./module/splat/splat.ko
$ sudo ./cmd/splat --all

Full documentation for building, configuring, testing, and using the SPL can be found at: http://zfsonlinux.org