summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorEdward Tomasz Napierala <trasz@FreeBSD.org>2022-01-09 10:03:44 +0000
committerEdward Tomasz Napierala <trasz@FreeBSD.org>2022-02-14 19:35:10 +0000
commitf89309617e10cf9b460c76cbe724d82817573653 (patch)
tree431e7dfa69c40a9fede6798872ace108672b42d7 /share
parent5ed9dc8debc26a04ba91e8bdcc90bdf06213f938 (diff)
linux: More man page tweaks
Mention debootstrap(8) and improve the wording. Reviewed By: debdrup, emaste, Pau Amma Sponsored By: EPSRC Differential Revision: https://reviews.freebsd.org/D33772 (cherry picked from commit 595532a766b4bf62401f0567a607e85ed0f548fc)
Diffstat (limited to 'share')
-rw-r--r--share/man/man4/linux.429
1 files changed, 15 insertions, 14 deletions
diff --git a/share/man/man4/linux.4 b/share/man/man4/linux.4
index b24e3dbc9f79..6054ae1aa455 100644
--- a/share/man/man4/linux.4
+++ b/share/man/man4/linux.4
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd January 2, 2022
+.Dd January 9, 2022
.Dt LINUX 4
.Os
.Sh NAME
@@ -39,8 +39,8 @@ linux_enable="YES"
.Sh DESCRIPTION
The
.Nm
-module provides limited Linux ABI (application binary interface) compatibility,
-making it possible to run many unmodified Linux applications
+kernel module provides limited Linux ABI (application binary interface)
+compatibility, making it possible to run many unmodified Linux applications
without the need for virtualization or emulation.
Some of the facilities provided are:
.Bl -bullet
@@ -75,11 +75,13 @@ file systems.
.Pp
To install Linux shared libraries and system files into
.Pa /compat/linux ,
-use the
+either use the
.Pa emulators/linux_base-c7
-port or the
-.Dv linux_base-c7
-package.
+port or package,
+or
+.Xr debootstrap 8
+installed from
+.Pa sysutils/debootstrap .
.Pp
To avoid mounting Linux-specific filesystems at startup, add the following
line to the
@@ -132,18 +134,17 @@ From a user perspective, this makes
work for Linux executables.
Defaults to 0.
.It Va compat.linux.setid_allowed
-Disable handling of set-user-ID and set-group-ID mode bits for the new
+Enable handling of set-user-ID and set-group-ID mode bits for the new
process image file when image is to be executed under Linux ABI.
-When set, new Linux images always use credentials of the program
+When set to 0, new Linux images always use credentials of the program
that issued the
.Xr execve 2
call, regardless of the image file mode.
-Defaults to 1.
-.Pp
This might be reasonable or even required, because
.Fx
-does not emulate Linux environment completely, and missed features
-could become holes.
+does not emulate the Linux environment completely, and missed features
+may result in security vulnerabilities.
+Defaults to 1.
.El
.Sh FILES
.Bl -tag -width /compat/linux/dev/shm -compact
@@ -176,7 +177,7 @@ Linux kernel objects file system, see
.Xr linsysfs 5 ,
.Xr tmpfs 5
.Sh HISTORY
-Linux ABI support first appeared in
+Linux ABI support first appeared for i386 in
.Fx 2.1 .
Support for amd64 binaries first appeared in
.Fx 10.3 .