[src/netbsd-1-4]: src/share/man/man8 Pull up revisions 1.2-1.4 (requested by ...

[he <he%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/21c9846843df
branches:  netbsd-1-4
changeset: 470884:21c9846843df
user:      he <he%NetBSD.org@localhost>
date:      Sat Sep 09 15:12:35 2000 +0000

description:
Pull up revisions 1.2-1.4 (requested by elric):
  Update documentation of our OSF/1 compat on alpha.  Fixes PR#9060.

diffstat:

 share/man/man8/compat_osf1.8 |  96 ++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 96 insertions(+), 0 deletions(-)

diffs (100 lines):

diff -r 92a5bd6c02e5 -r 21c9846843df share/man/man8/compat_osf1.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man8/compat_osf1.8      Sat Sep 09 15:12:35 2000 +0000
@@ -0,0 +1,96 @@
+.\" $NetBSD: compat_osf1.8,v 1.1.4.2 2000/09/09 15:12:35 he Exp $
+.\"
+.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Roland C. Dowdeswell.
+.\"
+.\" 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
+.\"
+.Dd November 4, 1999
+.Dt COMPAT_OSF1 8
+.Os
+.Sh NAME
+.Nm compat_osf1
+.Nd setup procedure for running OSF/1 binaries
+.Sh DESCRIPTION
+.Nx
+supports running OSF/1 (a.k.a Digital Unix, a.k.a. Tru64) binaries on alpha
+systems.
+Most programs should work, including the ones that use the shared object
+libraries. Programs that make direct MACH system calls will not work.
+The OSF/1 compatibility feature is active for kernels compiled with the
+.Dv COMPAT_OSF1
+option enabled. (See
+.Xr options 4 .)
+.Pp
+To run dynamically linked programs, you will need the OSF/1 shared libraries,
+runtime linker, and certain configuration files found in /etc.
+These are installed in a "shadow root" directory called /emul/osf1.
+Any file operations done by OSF/1 programs run under
+.Nx
+will look in this directory first, and fall back to the file system proper.
+So, if an OSF/1 program opens /etc/svc.conf,
+.Nx
+will first try to open /emul/osf1/etc/svc.conf, and if that file does
+not exist it will then try /etc/svc.conf.
+Shared libraries and configuration specific to OSF/1 should be installed
+in the shadow tree.
+.Ss Setting up /emul/osf1
+There are many methods of populating /emul/osf1 with the appropriate
+files, but the two easiest are:
+.Pp
+If you have access to an OSF/1 machine, you can copy the contents of:
+.Bl -tag -width 123 -compact -offset indent
+.It /shlib
+.It /usr/shlib
+.It /etc/sia
+.It /usr/lib/X11/locale
+.El
+.Pp
+(The latter is required to run Netscape Navigator or Communicator.)
+.Pp
+And the files
+.Bl -tag -width 123 -compact -offset indent
+.It /etc/svc.conf
+.It /usr/ccs/lib/cmplrs/otabase/libots.so
+.It /sbin/loader
+.El
+.Pp
+Or, simply NFS mount the appropriate directories under /emul/osf1.
+.Sh BUGS
+Certain values in /emul/osf1/etc/svc.conf can cause programs to fail
+with ``Bad system call''.
+.Pp
+Pathnames pointed to by symbolic links are not looked up in the
+shadow root when running a OSF/1 executable. This is not consistent.
+.Sh SEE ALSO
+.Xr config 8 ,
+.Xr options 4 .