Sat Aug 29 21:42:25 2020 UTC ()
Minor wording tweaks from Dan Plassche.


(uwe)
diff -r1.3 -r1.4 src/share/man/man8/compat_bsdos.8
cvs diff -r1.3 -r1.4 src/share/man/man8/compat_bsdos.8 (switch to unified diff)

--- src/share/man/man8/compat_bsdos.8 2020/08/28 17:13:13 1.3
+++ src/share/man/man8/compat_bsdos.8 2020/08/29 21:42:25 1.4
@@ -1,119 +1,120 @@ @@ -1,119 +1,120 @@
1.\" $NetBSD: compat_bsdos.8,v 1.3 2020/08/28 17:13:13 wiz Exp $ 1.\" $NetBSD: compat_bsdos.8,v 1.4 2020/08/29 21:42:25 uwe Exp $
2.\" 2.\"
3.\" Copyright (c) 2020 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2020 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Dan Plassche. 7.\" by Dan Plassche.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\" notice, this list of conditions and the following disclaimer in the 15.\" notice, this list of conditions and the following disclaimer in the
16.\" documentation and/or other materials provided with the distribution. 16.\" documentation and/or other materials provided with the distribution.
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd August 27, 2020 30.Dd August 27, 2020
31.Dt COMPAT_BSDOS 8 31.Dt COMPAT_BSDOS 8
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm compat_bsdos 34.Nm compat_bsdos
35.Nd binary compatibility for BSDi releases 35.Nd binary compatibility for BSDi releases
36.Sh DESCRIPTION 36.Sh DESCRIPTION
37The 37The
38.Dv COMPAT_NOMID 38.Dv COMPAT_NOMID
39kernel option provides compatibility with 39kernel option includes compatibility with
40.Tn BSDi Ns No \ 1. Ns Em \^x Ns \|\(en\|3. Ns Em \^x 40.Tn BSDi Ns No \ 1. Ns Em \^x Ns \|\(en\|3. Ns Em \^x
41.Xr a.out 5 41.Xr a.out 5
42binaries on 42binaries on
43.Nx Ns Tn /i386 43.Nx Ns Tn /i386
44and 44and
45.Nx Ns Tn /amd64 . 45.Nx Ns Tn /amd64 .
46The option is included in the 46The option is enabled by default in the
47.Li GENERIC 47.Li GENERIC
48kernel on i386, 48kernel on i386,
49but needs to be enabled along with 49but needs to be set along with
50.Dv EXEC_AOUT 50.Dv EXEC_AOUT
51on amd64. 51on amd64.
52.Pp 52.Pp
53Null memory protection must be disabled with the 53Null memory protection must be disabled with the
54.Xr sysctl 7 54.Xr sysctl 7
55option 55option
56.Va vm.user_va0_disable 56.Va vm.user_va0_disable
57set to 57set to
58.Li 0 58.Li 0
59for the binaries to run successfully. 59for the binaries to run successfully.
60.Pp 60.Pp
61.Bsx 2.0+ 61.Bsx 2.0+
62binaries also require an 62binaries also require an
63.Xr ldconfig 8 63.Xr ldconfig 8
64configuration or a symbolic link 64configuration or a symbolic link
65pointing to the 65pointing to the
66.Pa /emul/bsdos/shlib 66.Pa /emul/bsdos/shlib
67directory to run outside of a chroot. 67directory to run outside of a chroot.
68.Pp 68.Pp
69.Bsx 4.0 69.Bsx 4.0
70switched to ELF binaries that do not run under the 70switched to an ELF binary executable format
 71that does not run under the
71compatibility layers currently available on 72compatibility layers currently available on
72.Nx . 73.Nx .
73.Sh SEE ALSO 74.Sh SEE ALSO
74.Xr options 4 , 75.Xr options 4 ,
75.Xr a.out 5 , 76.Xr a.out 5 ,
76.Xr elf 5 , 77.Xr elf 5 ,
77.Xr sysctl 7 , 78.Xr sysctl 7 ,
78.Xr compat_netbsd32 8 , 79.Xr compat_netbsd32 8 ,
79.Xr ldconfig 8 80.Xr ldconfig 8
80.Sh HISTORY 81.Sh HISTORY
81.Tn BSD/386 Ns No \ 1.0\|\(en\|1.1 82.Tn BSD/386 Ns No \ 1.0\|\(en\|1.1
82was derived from 83was derived from
83.Bx 4.3 Tn Reno 84.Bx 4.3 Tn Reno
84code in the 85code in the
85.Tn Net/2 86.Tn Net/2
86release. 87release.
87.Pp 88.Pp
88.Bsx 2.0 89.Bsx 2.0
89was based on 90was based on
90.Bx 4.4 Tn Lite , 91.Bx 4.4 Tn Lite ,
91but introduced new static shared libraries 92but introduced new static shared libraries
92compiled into binary objects under 93compiled into binary objects under
93.Pa /shlib . 94.Pa /shlib .
94The build system included the 95The build system included the
95.Li shlicc 96.Li shlicc
96command with the 97command with the
97.Fl Bstatic 98.Fl Bstatic
98flag that allowed reverting to the standard 99flag that allowed reverting to the standard
99library archive format. 100library archive format.
100.Pp 101.Pp
101.Ox 2.2\|\(en\|4.7 102.Ox 2.2\|\(en\|4.7
102included a different compatibility implementation 103included a different compatibility implementation
103under the 104under the
104.Dv COMPAT_BSDOS 105.Dv COMPAT_BSDOS
105kernel option. 106kernel option.
106.Sh BUGS 107.Sh BUGS
107.Bsx 108.Bsx
108compatibility was broken on 109compatibility was broken on
109.Nx 5\|\(en\|6 110.Nx 5\|\(en\|6
110.Pp 111.Pp
111.Bsx 3.0 112.Bsx 3.0
112added 113added
113.Tn SPARC 114.Tn SPARC
114support, but the binaries are incorrectly recognized as 115support, but the binaries are incorrectly recognized as
115.Tn SunOS 116.Tn SunOS
116executables and fail on 117executables and fail on
117.Nx Ns Tn /sparc 118.Nx Ns Tn /sparc
118and 119and
119.Nx Ns Tn /sparc64 . 120.Nx Ns Tn /sparc64 .