From owner-freebsd-hackers  Wed Nov 29 03:28:20 1995
Return-Path: owner-hackers
Received: (from root@localhost)
          by freefall.freebsd.org (8.6.12/8.6.6) id DAA04324
          for hackers-outgoing; Wed, 29 Nov 1995 03:28:20 -0800
Received: from cls.net (freeside.cls.de [192.129.50.1])
          by freefall.freebsd.org (8.6.12/8.6.6) with SMTP id DAA04288
          for <hackers@freebsd.org>; Wed, 29 Nov 1995 03:28:15 -0800
Received: by mail.cls.net (Smail3.1.29.1)
	  from allegro.lemis.de (192.109.197.134) with smtp
	  id <m0tKkgB-0011jSC@cls.net>; Wed, 29 Nov 95 11:27 GMT
From: grog@lemis.de (Greg Lehey)
Organisation: LEMIS, Schellnhausen 2, 36325 Feldatal, Germany
Phone: +49-6637-919123
Fax:   +49-6637-919122
Reply-To: grog@lemis.de (Greg Lehey)
Received: (grog@localhost) by allegro.lemis.de (8.6.9/8.6.9) 
	id MAA16884; Wed, 29 Nov 1995 12:01:28 +0100
Message-Id: <199511291101.MAA16884@allegro.lemis.de>
Subject: Re: ibcs2(8)
To: lyndon@orthanc.com (Lyndon Nerenberg VE7TCP)
Date: Wed, 29 Nov 1995 12:01:28 +0100 (MET)
Cc: hackers@freebsd.org (FreeBSD Hackers)
In-Reply-To: <199511280131.RAA23749@multivac.orthanc.com> from "Lyndon Nerenberg VE7TCP" at Nov 27, 95 05:31:01 pm
X-Mailer: ELM [version 2.4 PL23]
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
Content-Length: 1514      
Sender: owner-hackers@freebsd.org
Precedence: bulk

Lyndon Nerenberg VE7TCP writes:
> 
> What's wrong with something like this? It documents the fact that
> iBCS2 support exists, and that it's not for the timid (yet).
> 
> .Dd November 27, 1995
> .Dt IBCS2 8
> .Os FreeBSD-Experimental
> .Sh NAME
> .Nm ibcs2
> .Nd load iBCS2 runtime support for SCO and ISC binaries
> .Sh SYNOPSIS
> .Nm ibcs2
> .Sh DESCRIPTION
> The
> .Nm
> utility loads kernel runtime support for iBCS2 compliant programs.
> This runtime support is limited to emulation of the iBCS2
> system call interface, and is far from complete. COFF binaries
> and shared libraries are supported, however no shared libraries
> are provided with the FreeBSD distribution.
> .Sh FILES
> .Bl -tag -width /lkm/ibcs2_coff.o -compact
> .It Pa /lkm/ibcs2_mod.o
> .It Pa /lkm/ibcs2_coff.o
> iBCS2 loadable kernel modules
> .Sh "SEE ALSO"
> .Pa /sys/i386/ibcs2/README.iBCS2 ,

AHA!  This is the documentation that I was looking for.  It's not in
-current: that's the real problem.

> .Xr modload 8 ,
> .Xr lkm 4
> .Sh BUGS
> The emulation is very incomplete.
> .Pp
> Running dynamically linked binaries requires access to an existing
> SCO system from which you can grab the shared libraries.

The term "dynamically linked binaries" suggests dynamically linked
shared libraries.  It might be better to say "shared libraries".  It's
probably also a good idea to mention that the emulator looks for them
in /compat/ibcs2 before looking in /.

> .Pp
> You can't really use this without reading the source code.

Greg