COMPAT_SUNOS(8)

NAME
compat_sunos - setup procedure for m68k and sparc architectures

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

The exceptions include programs that use the SunOS kvm library, and various 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 procedure details the directories and files that must be setup to allow dynamically 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 NetBSD machine, do the following:

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

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

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

4.  cp SunOS:/usr/lib/ld.so NetBSD:/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 NetBSD 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 NetBSD 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.

SunOS executables can not handle directory offset cookies > 32 bits. Should such an offset occur, you will see the message "sunos_getdents: dir offset too large for emulated program". Currently, this can only happen on NFS mounted filesystems, mounted from servers that return offsets with information in the upper 32 bits. These errors should rarely happen, but can be avoided by mounting this filesystem with offset translation enabled. See the -X option to mount_nfs(8). The -2 option to mount_nfs(8) will also have the desired effect, but is less preferable.