share/man/man8/compat_ultrix.8

   1 .\"     $NetBSD: compat_ultrix.8,v 1.18 2003/03/30 21:21:41 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1997 Jonathan Stone
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"     This product includes software developed by Jonathan Stone.
  17 .\" 4. Neither the name of the author nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .Dd January 16, 1999
  34 .Dt COMPAT_ULTRIX 8
  35 .Os
  36 .Sh NAME
  37 .Nm compat_ultrix
  38 .Nd "setup procedure for ULTRIX compatibility on MIPS and VAX architectures"
  39 .Sh DESCRIPTION
  40 .Nx Ns Tn /mips
  41 and
  42 .Nx Ns Tn /vax
  43 architectures can run Risc ULTRIX and VAX
  44 ULTRIX executables, respectively.  However, you have to worry about
  45 the legal issues of ensuring that you have a right to use any ULTRIX
  46 binaries on your machine.
  47 .Pp
  48 Most executables will work.  The exceptions include programs that use
  49 proprietary, ULTRIX-specific features (LAT, CI support, DECnet
  50 support) and various system calls,
  51 .Fn ioctl Ns 's ,
  52 or ULTRIX kernel
  53 semantics that are difficult to emulate (e.g. ULTRIX packetfilter) or
  54 buggy (e.g. ULTRIX
  55 .Tn NIS ) .
  56 .Pp
  57 All ULTRIX executables are static, so no shared libraries are required
  58 for ULTRIX compatibility. However, ULTRIX is based on a
  59 .Bx 4.3
  60 alpha release.  ULTRIX commands and libraries are often much older
  61 than their
  62 .Nx
  63 or even
  64 .Tn SunOS 4.x
  65 equivalents, and may require
  66 incompatible configuration files.
  67 .Sh SYSTEM CONFIGURATION FILES
  68 Set up
  69 .Pa resolv.conf
  70 and
  71 .Pa svc.conf
  72 as below:
  73 .Pp
  74 .Bl -tag -width 123 -compact -offset indent
  75 .It # mkdir -p /emul/ultrix/etc
  76 .br
  77 .It # cd /emul/ultrix/etc
  78 .br
  79 .It # egrep 'domain|nameserver' /etc/resolv.conf  \*[Gt] ./resolv.conf
  80 .br
  81 .It # cp -p /usr/share/examples/emul/ultrix/etc/*       ./
  82 .El
  83 .Ss /etc/resolv.conf
  84 The ULTRIX resolver library only understands
  85 .Sy domain
  86 and
  87 .Sy nameserver
  88 lines in
  89 .Xr resolv.conf 5 .
  90 You should create a copy of
  91 .Pa /etc/resolv.conf
  92 containing only those commands and put it in
  93 .Pa /emul/ultrix/etc/resolv.conf .
  94 Note that the
  95 domain search order used by ULTRIX executables may not be the same as
  96 native binaries; there is no good way around this.
  97 .Ss /etc/svc.conf
  98 ULTRIX uses
  99 .Pa /etc/svc.conf
 100 to select an ordered search of
 101 .Tn NIS ,
 102 Hesiod,
 103 or local flat-file mappings.  You should create an
 104 .Pa /emul/ultrix/etc/svc.conf
 105 specifying either local files or bind (DNS)
 106 lookups for all ULTRIX name services.
 107 .Sh SEE ALSO
 108 .Xr resolv.conf 5
 109 .Sh BUGS
 110 RISC ULTRIX
 111 .Tn NIS
 112 (YP) is known to not work.  The ULTRIX
 113 .Tn NIS
 114 libraries have a consistent endian-ness bug. ULTRIX
 115 .Tn NIS
 116 client will not inter-operate with the
 117 .Nx
 118 .Xr ypbind 8
 119 process.  The only workaround is to use
 120 .Pa /etc/svc.conf
 121 to disable
 122 .Tn NIS
 123 (YP).
 124 .Pp
 125 The ndbm hashed-password file used by ULTRIX are incompatible with the
 126 db hashed-password file used by
 127 .Nx .
 128 There is no good solution for
 129 this.
 130 .Tn NIS
 131 would be a good one, if ULTRIX
 132 .Tn NIS
 133 worked.
 134 .Pp
 135 The API used by Xservers to talk to the kernel is currently compatible
 136 with ULTRIX 4.1.  An implementation of the ULTRIX 4.2 Xws interface
 137 (used by X11R6) is in progress.
 138 .Pp
 139 A complete list of things which fail to work in ULTRIX compatibility
 140 mode should be added here.