diff options
author | Miod Vallat <miod@cvs.openbsd.org> | 2002-05-07 08:20:18 +0000 |
---|---|---|
committer | Miod Vallat <miod@cvs.openbsd.org> | 2002-05-07 08:20:18 +0000 |
commit | cedfa554842cb165153bc78d859bf5ee19b55977 (patch) | |
tree | 8907897e2cefb87dd45459caa5714286559c546b /share/man/man8 | |
parent | 23b9c9663d683d8d06d4c4e0724c02173f41f915 (diff) |
The beginnings of a compat_osf1(8) manual page, borrowed from NetBSD then
adapted to our current situation.
Diffstat (limited to 'share/man/man8')
-rw-r--r-- | share/man/man8/Makefile | 12 | ||||
-rw-r--r-- | share/man/man8/compat_osf1.8 | 129 |
2 files changed, 135 insertions, 6 deletions
diff --git a/share/man/man8/Makefile b/share/man/man8/Makefile index 88eedac9758..32a4be4fb34 100644 --- a/share/man/man8/Makefile +++ b/share/man/man8/Makefile @@ -1,12 +1,12 @@ -# $OpenBSD: Makefile,v 1.37 2002/02/21 02:36:09 miod Exp $ +# $OpenBSD: Makefile,v 1.38 2002/05/07 08:20:16 miod Exp $ # $NetBSD: Makefile,v 1.13 1996/03/28 21:36:40 mark Exp $ # @(#)Makefile 8.1 (Berkeley) 6/5/93 -MAN= afterboot.8 compat_bsdos.8 compat_freebsd.8 compat_ibcs2.8 \ - compat_linux.8 compat_sunos.8 compat_svr4.8 compat_ultrix.8 crash.8 \ - dhcp.8 diskless.8 intro.8 rc.8 rc.conf.8 rc.shutdown.8 ssl.8 \ - starttls.8 sticky.8 update.8 yp.8 boot_config.8 vpn.8 release.8 \ - security.8 genassym.sh.8 netstart.8 +MAN= afterboot.8 boot_config.8 compat_bsdos.8 compat_freebsd.8 \ + compat_ibcs2.8 compat_linux.8 compat_osf1.8 compat_sunos.8 \ + compat_svr4.8 compat_ultrix.8 crash.8 dhcp.8 diskless.8 genassym.sh.8 \ + intro.8 netstart.8 rc.8 rc.conf.8 rc.shutdown.8 release.8 security.8 \ + ssl.8 starttls.8 sticky.8 update.8 vpn.8 yp.8 SUBDIR= man8.alpha man8.amiga man8.hp300 man8.i386 man8.mac68k man8.mvme68k \ man8.macppc man8.sparc man8.sparc64 man8.sun3 man8.vax diff --git a/share/man/man8/compat_osf1.8 b/share/man/man8/compat_osf1.8 new file mode 100644 index 00000000000..1a1dbdeda68 --- /dev/null +++ b/share/man/man8/compat_osf1.8 @@ -0,0 +1,129 @@ +.\" $OpenBSD: compat_osf1.8,v 1.1 2002/05/07 08:20:17 miod Exp $ +.\" $NetBSD: compat_osf1.8,v 1.8 2002/01/14 13:50:43 wiz 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 +.Ox +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 +.Dq shadow root +directory called +.Pa /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 +.Pa /etc/svc.conf , +.Nx +will first try to open +.Pa /emul/osf1/etc/svc.conf , +and if that file does not exist it will then try +.Pa /etc/svc.conf . +Shared libraries and configuration specific to OSF/1 should be installed +in the shadow tree. +.Ss Setting up /emul/osf1 +You need access to an OSF/1 machine and if the licensing details permit, +you need to copy the contents of: +.Bl -item -compact -offset indent +.It +.Pa /shlib +.It +.Pa /usr/shlib +.It +.Pa /etc/sia +.It +.Pa /usr/lib/X11/locale +.El +.Pp +(The latter is required to run Netscape Navigator or Communicator.) +.Pp +Also copy +.Bl -item -compact -offset indent +.It +.Pa /etc/svc.conf +.It +.Pa /usr/ccs/lib/cmplrs/otabase/libots.so +.It +.Pa /sbin/loader +.El +.Pp +Or, simply NFS mount the appropriate directories under +.Pa /emul/osf1 . +.Sh SEE ALSO +.Xr options 4 , +.Xr config 8 +.Sh BUGS +Your +.Xr hostname 1 +.Em must +contain a dot +.Em or +your +.Xr resolv.conf 5 +must contain a +.Li search +line. +Without one of those, the OSF/1 resolver will die and no hostname resolution +will be possible. +.Pp +Certain values in +.Pa /emul/osf1/etc/svc.conf +can cause programs to fail with +.Dq 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. +.Pp +Most Tru64 Unix (OSF/1 release 5) programs depend on an undocumented +system call which is not currently supported. |