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

NAME
     compat_svr4 - setup procedure for running SVR4/iBCS2 binaries under emu-
     lation



DESCRIPTION
     OpenBSD supports running SVR4/iBCS2 binaries. This code has been tested
     on i386 and sparc systems. Most programs should work, but not ones that
     use the /proc filesystem, sound, or threads (unfortunately ttsession uses
     threads).

     The SVR4 compatibility feature is active for kernels compiled with the
     COMPAT_SVR4 option enabled.

     Most SVR4 programs are dynamically linked. This means that you will also
     need the shared libraries that the program depends on and the runtime
     linker. Also, you will need to create a "shadow root" directory for SVR4
     binaries on your OpenBSD system. This directory is named /emul/svr4. Any
     file operations done by SVR4 programs run under OpenBSD will look in this
     directory first. So, if a SVR4 program opens, for example, /etc/passwd,
     OpenBSD will first try to open /emul/svr4/etc/passwd, and if that does
     not exist open the 'real' /etc/passwd file. It is recommended that you
     install SVR4 packages that include configuration files, etc under
     /emul/svr4, to avoid naming conflicts with possible OpenBSD counterparts.
     Shared libraries should also be installed in the shadow tree.

     The simplest way to setup your system for SVR4 biraries is:

     1.   Make the necessary directories:

                (me@openbsd) mkdir -p /emul/svr4/{dev,etc}
                (me@openbsd) mkdir -p /emul/svr4/usr/{bin,lib}
                (me@openbsd) mkdir -p /emul/svr4/usr/openwin/{bin,lib}

     2.   Copy files from an svr4 system:

                (me@svr4) cd /usr/lib
                (me@svr4) tar -cf - . | \
                     rsh openbsd 'cd /emul/svr4/usr/lib; tar -xpf -'

          If you are running openwindows:

                (me@svr4) cd /usr/openwin/lib
                (me@svr4) tar -cf - . | \
                     rsh openbsd 'cd /emul/svr4/usr/openwin/lib; tar -xpf -'

     3.   Setup the configuration files and devices:

                (me@openbsd) cd /usr/src/etc/etc.svr4
                (me@openbsd) cp netconfig nsswitch.conf /emul/svr4/etc
                (me@openbsd) cp SVR4_MAKEDEV /emul/svr4/dev
                (me@openbsd) cd /emul/svr4/dev; ./SVR4_MAKEDEV all

     An alternative method is to mount a whole svr4 partition in /emul/svr4
     and then override with other mounts /emul/svr4/etc and /emul/svr4/dev.

BUGS
     Many system calls are still not emulated.


4th Berkeley Distribution        July 6, 1996                                1