LINUX(4) BSD/i386 Kernel Interfaces Manual LINUX(4)NAMElinux — Linux ABI support
SYNOPSIS
To link Linux ABI support into the kernel:
options COMPAT_LINUX
To load the Linux ABI support kernel module:
kldload linuxDESCRIPTION
The linux module provides limited Linux ABI (Application Binary Inter‐
face) compatibility for userland applications. The module provides the
following significant facilities:
· An image activator for correctly branded elf(5) executable images
· Special signal handling for activated images
· Linux to native system call translation
It is important to note that the Linux ABI support is not provided
through an emulator, instead, a true (albeit limited) ABI implementation
is provided.
The following sysctl(8) tunable variables are available:
compat.linux.osname Linux kernel operating system name.
compat.linux.osrelease Linux kernel operating system release.
compat.linux.oss_version Linux Open Sound System version.
The linux module can be linked into the kernel statically with the
COMPAT_LINUX kernel configuration option or loaded as required. The fol‐
lowing command will load the module if it is neither linked into the ker‐
nel nor already loaded as a module:
if ! kldstat -v | grep -E 'linux(aout|elf)' > /dev/null; then
kldload linux > /dev/null 2>&1
fi
Note that dynamically linked Linux executables will require a suitable
environment in /compat/linux. Specifically, the Linux run-time linker's
hints files should be correctly initialized. For this reason, it is com‐
mon to execute the following commands to prepare the system to correctly
run Linux executables:
if [ -x /compat/linux/sbin/ldconfig ]; then
/compat/linux/sbin/ldconfig
fi
For information on loading the linux kernel loadable module automatically
on system startup, see rc.conf(5). This information applies regardless
of whether the linux module is statically linked into the kernel or
loaded as a module.
FILES
/compat/linux minimal Linux run-time environment
/compat/linux/proc limited Linux process file system
SEE ALSObrandelf(1), elf(5), linprocfs(5)HISTORY
Linux ABI support first appeared in FreeBSD 2.1.
BSD September 17, 2003 BSD
