diff options
-rw-r--r-- | share/man/man4/man4.i386/Makefile | 3 | ||||
-rw-r--r-- | share/man/man4/man4.i386/linux.4 | 124 |
2 files changed, 126 insertions, 1 deletions
diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile index 06026b5..3ade99a 100644 --- a/share/man/man4/man4.i386/Makefile +++ b/share/man/man4/man4.i386/Makefile @@ -3,7 +3,7 @@ MAN4= aic.4 alpm.4 apm.4 ar.4 asc.4 \ cs.4 cx.4 cy.4 \ dgb.4 el.4 en.4 ep.4 ex.4 fe.4 gsc.4 \ - ie.4 io.4 labpc.4 le.4 lnc.4 matcd.4 mcd.4 \ + ie.4 io.4 labpc.4 le.4 linux.4 lnc.4 matcd.4 mcd.4 \ meteor.4 mse.4 npx.4 \ pcf.4 perfmon.4 pnp.4 \ rdp.4 sb.4 scd.4 \ @@ -30,6 +30,7 @@ MLINKS+= ie.4 ../ie.4 MLINKS+= io.4 ../io.4 MLINKS+= labpc.4 ../labpc.4 MLINKS+= le.4 ../le.4 +MLINKS+= linux.4 ../linux.4 MLINKS+= lnc.4 ../lnc.4 MLINKS+= matcd.4 ../matcd.4 MLINKS+= mcd.4 ../mcd.4 diff --git a/share/man/man4/man4.i386/linux.4 b/share/man/man4/man4.i386/linux.4 new file mode 100644 index 0000000..f37bce7 --- /dev/null +++ b/share/man/man4/man4.i386/linux.4 @@ -0,0 +1,124 @@ +.\" 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 other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.Dd August 17, 2000 +.Dt LINUX 4 i386 +.Os +.Sh NAME +.Nm linux +.Nd Linux ABI support +.Sh SYNOPSIS +To link Linux ABI support into the kernel: +.Cd options COMPAT_LINUX +.Pp +To load the Linux ABI support kernel module: +.Dl kldload linux +.Sh DESCRIPTION +The +.Nm +module provides limited +Linux ABI (application binary interface) compatibility +for userland applications. +The module provides the following significant facilities: +.Bl -bullet +.It +An image activator +for correctly branded +.Xr elf 5 +executable images +.It +Special signal handling for activated images +.It +Linux to native system call vector redirection +.El +.Pp +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. +.Pp +The following +.Xr sysctl 8 +tunable variables are available: +.Bl -tag -width compat.linux.oss_version +.It compat.linux.osname +Linux kernel operating system name. +.It compat.linux.osrelease +Linux kernel operating system release. +.It compat.linux.oss_version +Linux Open Sound System version. +.El +.Pp +The +.Nm +module can be linked into the kernel statically with the +.Dv 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: +.Bd -literal -offset indent +if ! kldstat -v | grep -E 'linux(aout|elf)' > /dev/null; then + kldload linux > /dev/null 2>&1 +fi +.Ed +.Pp +Note that dynamically linked Linux executables +will require a suitable environment in +.Pa /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: +.Bd -literal -offset indent +if [ -x /compat/linux/sbin/ldconfig ]; then + /compat/linux/sbin/ldconfig +fi +.Ed +.Pp +For information on loading the +.Nm +kernel loadable module automatically on system startup, +see +.Xr rc.conf 5 . +This information applies +regardless of whether the +.Nm +module is statically linked into the kernel +or loaded as a module. +.Sh FILES +.Bl -tag -width /compat/linux/proc -compact +.It Pa /compat/linux +minimal Linux run-time environment +.It Pa /compat/linux/proc +limited Linux process file system +.El +.Sh SEE ALSO +.Xr brandelf 1 , +.Xr elf 5 , +.Xr linprocfs +.Sh HISTORY +Linux ABI support first appeared in +.Fx 2.1 . |