share/man/man8/compat_osf1.8

   1 .\" $NetBSD: compat_osf1.8,v 1.11 2005/06/20 13:25:25 peter Exp $
   2 .\"
   3 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Roland C. Dowdeswell.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  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
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  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
  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
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd November 4, 1999
  31 .Dt COMPAT_OSF1 8
  32 .Os
  33 .Sh NAME
  34 .Nm compat_osf1
  35 .Nd setup procedure for running OSF/1 binaries
  36 .Sh DESCRIPTION
  37 .Nx
  38 supports running OSF/1 (a.k.a Digital Unix, a.k.a. Tru64) binaries on
  39 .Nx Ns Tn /alpha
  40 systems.
  41 Most programs should work, including the ones that use the shared object
  42 libraries.
  43 Programs that make direct MACH system calls will not work.
  44 The OSF/1 compatibility feature is active for kernels compiled with the
  45 .Dv COMPAT_OSF1
  46 option enabled (see
  47 .Xr options 4 ) .
  48 .Pp
  49 To run dynamically linked programs, you will need the OSF/1 shared libraries,
  50 runtime linker, and certain configuration files found in /etc.
  51 These are installed in a
  52 .Dq shadow root
  53 directory called
  54 .Pa /emul/osf1 .
  55 Any file operations done by OSF/1 programs run under
  56 .Nx
  57 will look in this directory first, and fall back to the file system proper.
  58 So, if an OSF/1 program opens
  59 .Pa /etc/svc.conf ,
  60 .Nx
  61 will first try to open
  62 .Pa /emul/osf1/etc/svc.conf ,
  63 and if that file does not exist it will then try
  64 .Pa /etc/svc.conf .
  65 Shared libraries and configuration specific to OSF/1 should be installed
  66 in the shadow tree.
  67 .Ss Setting up /emul/osf1
  68 The simple technique is to install pkgsrc/emulators/osf1_lib.
  69 (You may
  70 also want to install pkgsrc/www/navigator and/or pkgsrc/www/communicator.)
  71 .Pp
  72 Alternatively, if you have access to an OSF/1 machine and if the licensing
  73 details permit, you can copy the contents of:
  74 .Bl -item -compact -offset indent
  75 .It
  76 .Pa /shlib
  77 .It
  78 .Pa /usr/shlib
  79 .It
  80 .Pa /etc/sia
  81 .It
  82 .Pa /usr/lib/X11/locale
  83 .El
  84 .Pp
  85 (The latter is required to run Netscape Navigator or Communicator.)
  86 .Pp
  87 Also copy
  88 .Bl -item -compact -offset indent
  89 .It
  90 .Pa /etc/svc.conf
  91 .It
  92 .Pa /usr/ccs/lib/cmplrs/otabase/libots.so
  93 .It
  94 .Pa /sbin/loader
  95 .El
  96 .Pp
  97 Or, simply NFS mount the appropriate directories under
  98 .Pa /emul/osf1 .
  99 .Sh SEE ALSO
 100 .Xr config 1 ,
 101 .Xr options 4
 102 .Sh BUGS
 103 Your
 104 .Xr hostname 1
 105 .Em must
 106 contain a dot
 107 .Em or
 108 your
 109 .Xr resolv.conf 5
 110 must contain a
 111 .Li search
 112 line.
 113 Without one of those, the OSF/1 resolver will die and no hostname
 114 resolution will be possible.
 115 .Pp
 116 Certain values in
 117 .Pa /emul/osf1/etc/svc.conf
 118 can cause programs to fail with
 119 .Dq Bad system call .
 120 .Pp
 121 Pathnames pointed to by symbolic links are not looked up in the
 122 shadow root when running an OSF/1 executable.
 123 This is not consistent.