$NetBSD: README.syscalls,v 1.3 2000/03/13 23:52:35 soren Exp $
XXX this file should be gutted. functions' comments should go with
XXX the functions. Further, this file is ... very out of date.
Once the new syscall argument-handling method was implemented, most
OSF/1 syscalls boiled down to their NetBSD equivalents. The
differences are detailed in this file.
Note that some OSF/1 syscalls, including some of those that map
directly to equivalent NetBSD syscalls, are not implemented; they
were not needed, so the effort to implement and check them was not
expended.
Finally, there are some OSF/1 syscalls which were left unimplemented,
but which seem strange enough to merit a bit more explanation.
OSF/1 compatibility is helped by the fact that the sigcontext
structure was created for NetBSD/Alpha to be the same as the OSF/1
sigcontext structure. Because of this, only one sendsig() function is
needed, and then the NetBSD sigreturn() function can be used for OSF/1
sigreturn(), as well.
The system calls are split out among the three files:
osf1_ioctl.c
osf1_misc.c
osf1_mount.c
as follows:
osf1_ioctl.c contains all osf1_ioctl() handling code.
osf1_mount.c contains all code dealing with mounting and
unmounting file systems, and with mount points in
general (e.g. osf1_getfsstat()).
osf1_misc.c contains the rest of the emulation functions.
The emulation functions as follows:
osf1_mknod()
dev_t's are different between OSF/1 and NetBSD. In OSF/1 a
dev_t has 12 bits of major number and 20 bits of minor number.
Under NetBSD, it's 24 bits of major, 8 bits of minor (but the
top 16 bits of the major number are unused, and may be
rearranged later). In any case, it was decided that the
primary use for OSF/1 binaries would be to complement native
NetBSD binaries, so file system dev_t's are assumed to be in
the NetBSD format, and osf1_mknod() translates from the OSF/1
format to the NetBSD format.
osf1_getfsstat()
The statfs structure is different between NetBSD and OSF/1,
and the way file system types are denoted is different, as
well. This routine is the same as getfsstat(), except it
converts the statfs structures before returning them to the
OSF/1 process.
osf1_lseek()
To compensate for quad alignment on 32-bit machines, the
NetBSD lseek() needs an extra argument of padding, before the
off_t 'offset' argument. This wrapper inserts the padding,
and calls the NetBSD routine.
osf1_mount()
The file system type specification and the way you specify
mount options differs substantially between NetBSD and OSF/1.
This routine (and its callees) fakes up NetBSD arguments, and
calls the NetBSD routine.
osf1_unmount()
Probably not necessary, but safe; translates flags, in case
the NetBSD unmount flags ever change.
osf1_exec_with_loader() [UNIMPLEMENTED]
From the description in the OSF/1 manual page, this executes a
file with a named loader, or "/sbin/loader" if none is named.
It appears to be used in some way, when executing dynamically
linked binaries, but is _not_ called directly from user space
in the normal case. The interface by which it passes the name
of the file to be executed, its arguments, etc., to the loader
is unspecified, and, from experimental evidence, doesn't seem
to be the normal UN*X argument-passing convention (i.e.
argc/argv). For proper dynamically linked binary support,
this function will probably have to be implemented, but it's
unclear how that can be done (short of disassembling a lot of
code).
osf1_open()
Translates OSF/1 flags to NetBSD flags.
osf1_ioctl()
Screens out ioctl requests that aren't known to work, and
translates those that differ between NetBSD and OSF/1.
osf1_reboot()
Translates OSF/1 flags to NetBSD flags.
osf1_stat()
The stat structure differs between NetBSD and OSF/1, both in
terms of field sizes, and in the dev_t representation.
This does a NetBSD stat(), translates the results, and returns
them to the OSF/1 process.
osf1_lstat()
Same as osf1_stat(), but for lstat().
osf1_mmap()
The NetBSD version needs 4 bytes of padding before the off_t
'pos' argument, and also uses different flags than the OSF/1
version. This wrapper translates the flags and deals with the
argument struct padding differences, then calls the NetBSD
routine.
osf1_fstat()
Same as osf1_stat(), but for fstat().
osf1_fcntl()
Translates OSF/1 fcntl() requests into their NetBSD
counterparts, then calls the NetBSD fcntl() to do the
operations.
osf1_socket()
Makes sure that the socket type is valid for NetBSD, and if
so, calls NetBSD's socket().
osf1_sendto()
Makes sure that the 'flags' argument doesn't use flags that
NetBSD can't handle, and calls NetBSD's sendto().
osf1_getrlimit()
Makes sure that the 'which' selector is one that NetBSD can
deal with, and calls NetBSD's getrlimit().
osf1_setrlimit()
Same as osf1_getrlimit(), but for setrlimit().
osf1_sigaction()
Deals with the differences in the NetBSD and OSF/1 sigaction
structures, and calls NetBSD's sigaction with the appropriate
arguments. If the call requests that the old sigaction be
passed back, osf1_sigaction() translates it back to the OSF/1
form, and returns it appropriately.
osf1_statfs()
Does that statfs() on the given pathname, then translates the
NetBSD statfs structure into the one that OSF/1 uses and
returns it. Makes a best effort on the mount type, because
there's not a one-to-one mapping between NetBSD and OSF/1
mount types.
osf1_fstatfs()
Same as osf1_statfs(), but for fstatfs().
osf1_usleep_thread()
This function is how sleep() and usleep() (and possibly other
functions) are implemented in OSF/1. Its usage was discovered
by disassembling the library routines that use it. It takes
two pointers to timeval structures as arguments. The first
contains the amount of time (in seconds and microseconds) to
sleep. If the second pointer is non-null, if the process
wakes up early, the amount of time "unslept" is returned. If
the process doesn't wake up early, zero is returned.
osf1_setsysinfo()
A null-op; used early on, but nothing cares that it actually
does anything.
