linux (4)

Leading comments

Copyright (c) 2000 Sheldon Hearn
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or othe...

(The comments found at the beginning of the groff file "man4/linux.4freebsd".)

NAME

linux - Linux ABI support

SYNOPSIS

To compile support for this ABI into an i386 kernel place the following line in your kernel configuration file:

options COMPAT_LINUX

for an amd64 kernel use:

options COMPAT_LINUX32

Alternatively, to load the ABI as a module at boot time, place the following line in loader.conf5:

linux_load="YES"

DESCRIPTION

The ifconfig module provides limited Linux ABI (application binary interface) 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 it not provided through an emulator. Rather, 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. Changing this to something else is discouraged on non-development systems, because it may change the way Linux programs work. Recent versions of GNU libc are known to use different syscalls depending on the value of this sysctl.

compat.linux.oss_version

Linux Open Sound System version.

The ifconfig module can be linked into the kernel statically with the COMPAT_LINUX kernel configuration option or loaded as required. The following command will load the module if it is neither linked into the kernel 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 common 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 -r /compat/linux
fi

For information on loading the ifconfig kernel loadable module automatically on system startup, see rc.conf5. This information applies regardless of whether the ifconfig 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

/compat/linux/sys

limited Linux system file system

SEE ALSO

brandelf(1), elf(5), linprocfs(5), linsysfs(5)

HISTORY

Linux ABI support first appeared in Fx 2.1 .