.\"	$NetBSD: compat_netbsd32.8,v 1.2 2001/09/09 22:18:14 wiz Exp $
.\"
.\" Copyright (c) 2001 Matthew R. Green
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd February 3, 2001
.Dt COMPAT_NETBSD32 8
.Os
.Sh NAME
.Nm compat_netbsd32
.Nd setup procedure for 32-bit compatibility on 64-bit platform
.Sh DESCRIPTION
The
.Nm
module allows
.Nx Ns Tn /sparc64
to run
.Nx Ns Tn /sparc
executables.
.Pp
To use
.Nm "" ,
one must either have
.Dv COMPAT_NETBSD32
in the kernel, or load the compat_netbsd32 and exec_netbsd32 kernel
modules.
.Pp
Static executables typically need no additional setup.
Dynamic binaries require the dynamic linker, plus shared libaries.  Most of
these files will need to be placed under
.Pa /emul/netbsd32 .
.Pp
The easiest method of installing support for these is via the
.Pa emulators/netbsd32_compat14
and
.Pa emulators/netbsd32_compat15
packages, provided in the
.Nx
packages collection.  These install 32-bit a.out and ELF compatibility
libraries, respectively.  The details of what is actually necessary for
correct operation are given below.  This obviously is handled by the
emulator packages.
.Pp
For a.out compatibility,
.Pa /usr/libexec/ld.so
from a 32-bit distribution is required to exist as
.Pa /emul/netbsd32/usr/libexec/ld.so .
For 32-bit ELF compatibility,
.Pa /usr/libexec/ld.elf_so
needs to be in
.Pa /emul/netbsd32/usr/libexec/ld.elf_so .
.Pp
The shared libaries for a.out binaries do not live under the
.Pa /emul/netbsd32
directory, but under the
.Pa /emul/aout
directory, where the a.out dyanmic linker will find them.
.Sh BUGS
A list of things which fail to work in compatibility mode should
be here.
.Pp
IPC is not well supported.
.Pp
.Xr sysctl 3
is not well supported.