Re: New compat_bsdos.8 Manpage

[Dan Plassche <dplassche%gmail.com@localhost>]

On 2020-08-29 16:40, Valery Ushakov wrote:
> On Sat, Aug 29, 2020 at 15:57:52 -0400, Dan Plassche wrote:
> 
>> I've updated the text to add the details of the steps involved for
>> options 1 and 3.
> 
> Could you kindly re-diff those changes against the committed version?
> 
> -uwe
> 

No problem, below is a diff:


--- compat_bsdos.8.orig	2020-08-29 16:45:00.360547482 -0400
+++ compat_bsdos.8	2020-08-29 16:55:55.171808350 -0400
@@ -37,17 +37,17 @@
 .Pp
 The
 .Cd COMPAT_NOMID
-kernel option provides compatibility with BSDi 1-3
+kernel option includes compatibility with BSDi 1-3
 .Xr a.out 5
 binaries on
 .Tn Nx Ns /i386
 and
 .Tn Nx Ns /amd64 .
-The option is included in the
+The option is enabled by default in the
 .Li GENERIC
 kernel on
 .Em i386 ,
-but needs to be enabled along with
+but needs to be set along with
 .Cd EXEC_AOUT
 on
 .Em amd64 .
@@ -61,15 +61,50 @@
 for the binaries to run successfully.
 .Pp
 .Bsx 2.0+
-binaries also require an
-.Xr ldconfig 8
-configuration or a symbolic link
-pointing to the
+binaries also require access to
+static shared libraries under
+.Pa /shlib .
+On
+.Nx
+the shared libraries are normally
+installed under
 .Pa /emul/bsdos/shlib
-directory to run outside of a chroot.
+and access can be provided by
+one of the following methods:
+.Pp
+.Bl -dash -offset -indent
+.It
+A symlink from
+.Pa /shlib
+to
+.Pa /emul/bsdos/shlib .
+.\" .It
+.\" Rebuilding the userland from source
+.\" using
+.\" .Pa /emul/bsdos/lib
+.\" and
+.\" .Pa /emul/bsdos/usr/lib .
+.\" Then adding
+.\" .Pa /emul/bsdos/lib
+.\" and
+.\" .Pa /emul/bsdos/usr/lib
+.\" to
+.\" .Pa /etc/ld.so.conf
+.\" and running
+.\" .Ic ldconfig
+.\" to regenerate
+.\" .Pa /var/run/ld.so.hints .
+.It
+Running the binaries
+under a shell in a
+.Ic chroot
+with the command
+.Ic chroot "/emul/bsdos/shlib /bin/sh" .
+.El
 .Pp
 .Bsx 4.0
-switched to ELF binaries that do not run under the
+switched to an ELF binary executable format
+that does not run under the
 compatibility layers currently available on
 .Nx .
 .Sh SEE ALSO
@@ -101,7 +136,7 @@
 library archive format.
 .Pp
 .Ox 2.2-4.7
-included a different compatibility implementation
+included a different compatability implementation
 under the
 .Li COMPAT_BSDOS
 kernel option.