OpenZFS on Linux and FreeBSD
Go to file
Brian Behlendorf 8acfb2bcc1 Fix automatically generated release number
When building from the head of a branch a release number is
automatically generated with `git describe` using the last tag
on that branch as the base.  For this to work the last tag on the
branch needs to be predictable given the current META file.

This logic was accidentally broken when an -rcX tag was added to
the branch.  Update it to search for a VERSION or VERSION-RELEASE
tag.

Reviewed-by: Chris Siebenmann <cks.git01@cs.toronto.edu>
Signed-off-by: Brian Behlendorf <behlendorf1@llnl.gov>
Issue zfsonlinux/zfs#5105
Closes #572
2016-09-21 13:44:32 -07:00
cmd Add a script to display SPL slab cache statistics 2015-12-02 14:08:08 -08:00
config Fix automatically generated release number 2016-09-21 13:44:32 -07:00
include Cleanup in cred.h 2016-09-14 16:59:31 -07:00
lib Remove autotools products 2012-08-27 11:46:23 -07:00
man Allow kicking a taskq to spawn more threads 2016-02-05 14:08:31 -08:00
module Increase spl_kmem_alloc_warn limit 2016-09-16 17:10:36 -07:00
rpm Remove RPM package restriction 2016-03-10 09:19:08 -08:00
scripts Fix spl check.sh script 2016-09-14 17:17:00 -07:00
.gitignore Add gitignore entry for spl-*.o.d files 2016-08-01 12:42:55 -07:00
AUTHORS Refresh AUTHORS 2012-12-19 09:40:18 -08: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
META Tag 0.7.0-rc1 2016-09-07 10:33:21 -07:00
Makefile.am Support parallel build trees (VPATH builds) 2015-07-17 12:53:11 -07:00
README.markdown Document how to run SPLAT 2013-10-09 13:52:59 -07:00
autogen.sh build: do not call boilerplate ourself 2013-04-02 11:08:46 -07:00
configure.ac Add a script to display SPL slab cache statistics 2015-12-02 14:08:08 -08:00
copy-builtin Ensure spl/ only occurs once in core-y 2016-01-26 11:54:24 -08:00
spl.release.in Move spl.release generation to configure step 2012-07-12 12:13:47 -07:00

README.markdown

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