>DDFFT GUSI 2 -- A multithreaded POSIX library
INTRODUCTION
GUSI is an extension and partial replacement of the standard C runtime library
supplied with your compiler. The main objective of GUSI is to faciliate the
porting of software written for UNIX systems by implementing a substantial subset
of the Single Unix Specification library routines:
- BSD style sockets.
- Pthreads.
- Many other POSIX facilities such as diropen().
REQUIREMENTS
To use GUSI, you need one of the following compilers:
- Metrowerks CodeWarrior Pro 5 or later.
- SC/SCpp 8.8.4d1c1 or later.
- MrC/MrCpp 4.1.0a6c1 or later.
GETTING STARTED
If you're new to GUSI, start by reading the manual in :doc:GUSI.pdf.
If you're using GUSI with the Metrowerks CodeWarrior IDE, also read
:doc:GUSI_CW_Guide.pdf if you haver any difficulties getting your first GUSI
project to compile/link.
If you're using GUSI in combination with the MPW shell and/or the MPW compilers,
please run GUSI_Install.MPW. For more details, please consider reading the
documentation in the doc folder.
To recompile GUSI with the MPW compilers, you need an STL library. I've found
STLport, available at http://www.stlport.org/download.shtml, to work perfectly
for my purposes. To install it, put it anywhere on your disk and run
STLport_Install.MPW. Current versions of GUSI have been compiled with STLport 3.1.2.
GUSI USER LICENSE
My primary objective in distributing GUSI is to have it used as widely as
possible, while protecting my moral rights of authorship and limiting my
exposure to liability.
Copyright (C) 1992-2001 Matthias Neeracher
Permission is granted to anyone to use this software for any purpose on any
computer system, and to redistribute it freely, subject to the following
restrictions:
- The author is not responsible for the consequences of use of this software,
no matter how awful, even if they arise from defects in it.
- The origin of this software must not be misrepresented, either by explicit
claim or by omission.
- You are allowed to distributed modified copies of the software, in source
and binary form, provided they are marked plainly as altered versions, and
are not misrepresented as being the original software.
While I am giving GUSI away for free, that does not mean that I don't like
getting appreciation for it. If you want to do something for me beyond your
obligations outlined above, you can
- Acknowledge the use of GUSI in the about box of your application and/or
your documentation.
- Send me a CD as described in
http://www.iis.ee.ethz.ch/~neeri/macintosh/donations.html
BUGS, QUESTIONS, SUGGESTIONS
Please report any problems you experience with the code or the documentation to
me. I'd also be interested in hearing about your success stories, if you have
any.
GUSI ON WWW
An online version of the GUSI manual and a GUSI FAQ are available at
http://www.iis.ee.ethz.ch/~neeri/macintosh.html
MAILING LIST
There is a mailing list for announcing new releases and discussions about
how to make GUSI change your life. To subscribe, send a mail:
----------------------------------
To: gusi-request@iis.ee.ethz.ch
Subject: (is ignored)
subscribe
----------------------------------
Mail is now processed by a daemon, so please follow the above format.
Matthias Neeracher
20875 Valley Green Dr. #50
Cupertino, CA 95014
e-Mail: <neeracher@mac.com>
Fax: +1 (408) 514-2605 ext. 0023
KNOWN BUGS
- MSG_PEEK does not yet work for for native OpenTransport sockets, only for MacTCP
sockets [John Cargill-Ek].
- hstrerror() is not yet implemented [Darrell Walisser].
RELEASE NOTES
Version 2.1.6 08Apr01
- Fix handling of error codes in select() [Jean-Pierre Stierlin].
- Paths starting with ::: were mishandled [Chris Nandor, MacPerl Bug #409940].
- Made minor tweaks to make GUSI work better with Natty (Don't ask yet).
- Fixed major bugs in relative path generation.
- MPW tools were unable to open files which were open as windows
[Thomas Wegner, MacP
