compat_sunos(8)         OpenBSD System Manager's Manual        compat_sunos(8)

NAME
     compat_sunos - setup procedure for running SunOS binaries under emulation



DESCRIPTION
     OpenBSD/sparc and some of the OpenBSD/m68k architectures can run SunOS
     executables.  Most executables will work.

     The SunOS compatibility feature is active for kernels compiled with the
     COMPAT_SUNOS option enabled.

     The exceptions include programs that use the SunOS kvm library, and vari-
     ous system calls, ioctl()'s, or kernel semantics that are difficult to
     emulate.  The number of reasons why a program might fail to work is
     (thankfully) longer than the number of programs that fail to run.

     Static executables will normally run without any extra setup.  This pro-
     cedure details the directories and files that must be setup to allow dy-
     namically linked executables to work.

     The files you need are on your SunOS machine.  You need to worry about
     the legal issues of ensuring that you have a right to use the required
     files on your machine.  On your OpenBSD machine, do the following:

        1.   mkdir -p /emul/sunos/usr/lib /emul/sunos/usr/5lib

        2.   cp SunOS:/usr/lib/lib*.so.*.* OpenBSD:/emul/sunos/usr/lib

        3.   cp SunOS:/usr/5lib/lib*.so.*.* OpenBSD:/emul/sunos/usr/5lib

        4.   cp SunOS:/usr/lib/ld.so OpenBSD:/emul/sunos/usr/lib/ld.so

        5.   If you ever expect to use YP, you will want to create a link:
             ln -s /var/run/ypbind.lock /etc/ypbind.lock

     Alternatively, you can use an NFS mount to accomplish the same effect.
     On your OpenBSD machine, do the following:

        1.   mkdir -p /emul/sunos/usr

        2.   mount SunOS:/usr /emul/sunos/usr

     This will place the SunOS libraries on your OpenBSD machine in a location
     where the SunOS compatibility code will look for first, where they do not
     conflict with the standard libraries.

BUGS
     A list of things which fail to work in compatibility mode should be here.

4th Berkeley Distribution        June 15, 1994                               1