NAME
compat_30
—
setup procedure for backward
compatibility on post-3.0 releases
SYNOPSIS
options COMPAT_30
DESCRIPTION
Thecompat_30
module allows
NetBSD to run NetBSD 3.0
executables.
The support is present if the kernel was built with option
COMPAT_30
. It is not available as a loadable
module.
Static executables typically need no additional setup. Dynamic binaries may require shared libraries whose major version number changed since NetBSD 3.0, which are listed below. A shadow directory under /emul is not used; the libraries can be obtained from a NetBSD 3.0 distribution and installed in the original directories shown, as the major version number in the file name will prevent conflicts. If an upgrade installation from NetBSD 3.0 has been done and these libraries are still present, nothing more need be done.
Libraries needed from 3.0
- /lib/libcrypto.so.2.1 /lib/libcrypto.so.2
- /usr/lib/libcrypto.so.2.1 /usr/lib/libcrypto.so.2
- /lib/libevent.so.0.2 /lib/libevent.so.0
- /usr/lib/libevent.so.0.2 /usr/lib/libevent.so.0
- /usr/lib/libg2c.so.2.0 /usr/lib/libg2c.so.2
- /usr/lib/libkadm.so.5.0 /usr/lib/libkadm.so.5
- /usr/lib/libkafs.so.6.0 /usr/lib/libkafs.so.6
- /usr/lib/libkdb.so.5.0 /usr/lib/libkdb.so.5
- /usr/lib/libkrb5.so.19.1 /usr/lib/libkrb5.so.19
- /usr/lib/libkrb.so.6.0 /usr/lib/libkrb.so.6
- /usr/lib/libkstream.so.2.0 /usr/lib/libkstream.so.2
- /usr/lib/libmagic.so.0.1 /usr/lib/libmagic.so.0
- /usr/lib/libpcap.so.1.4 /usr/lib/libpcap.so.1
- /lib/libradius.so.0.0 /lib/libradius.so.0
- /usr/lib/libradius.so.0.0 /usr/lib/libradius.so.0
- /usr/lib/libssh.so.1.0 /usr/lib/libssh.so.1
- /usr/lib/libssl.so.3.0 /usr/lib/libssl.so.3
- /usr/lib/libstdc++.so.5.0 /usr/lib/libstdc++.so.5
- /lib/libz.so.0.4 /lib/libz.so.0
- /usr/lib/libz.so.0.4 /usr/lib/libz.so.0
- /usr/lib/libamu.so.2.1 /usr/lib/libamu.so.2
IMPLEMENTATION NOTES
COMPAT_30
enables the
NetBSD 3.0 versions of the following system calls,
whose syscall numbers and argument structures were changed after the 3.0
release to accommodate 64-bit filesystems:
fhstat(2),
fstat(2),
getdents(2),
lstat(2), stat(2).
The filehandle structure (formerly
fhandle_t) was made opaque to userland and
variable-sized. A fh_size argument was added to
related syscalls:
fhstat(2),
fhstatvfs(2),
fhstatvfs1(2),
fhopen(2),
getfh(2). This changes the API and ABI of those syscalls,
COMPAT_30
enables binary compatibility with the old
ABI. Source compatibility is not provided, as use of those syscalls is
supposed to be rare.
The error code from the
socket(2) syscall changed from
EPROTONOSUPPORT
to
EAFNOSUPPORT
in the case of an unsupported address
family. COMPAT_30
enables binary compatibility with
the old ABI. Source compatiblility is not provided.
The struct ntptimeval used by ntp_gettime(2) changed with the implementation of timecounters.
SEE ALSO
config(1), fhstat(2), fstat(2), getdents(2), lstat(2), stat(2), options(4)
HISTORY
NetBSD offers back-compatibility options
back to NetBSD 0.9, but the first to be documented
with a manual page is compat_30
.
BUGS
The compatible
getdents(2) is unable to see directory entries beneath the top layer
of a union, even though the real 3.0 getdents
() did
not have that problem.
SECURITY CONSIDERATIONS
Programs with security impact that receive incorrect directory
contents from getdents
() may behave improperly, as
when they are unable to find, or find the wrong versions of, important
files.