115 lines
4.6 KiB
Plaintext
115 lines
4.6 KiB
Plaintext
|
-------------------------------------------------------------------------------
|
||
|
|
GLS reference implementation (GLSREF) release notes
|
||
|
|
Craig Dunwoody
|
||
|
|
dunwoody@sgi.com
|
||
|
|
-------------------------------------------------------------------------------
|
||
|
|
|
||
|
|
GLSREF is a reference implementation of the GLS API. It is NOT a
|
||
|
|
sample implementation or a product-quality implementation, and it is
|
||
|
|
therefore NOT suitable for shipping unmodified to customers as a
|
||
|
|
product.
|
||
|
|
|
||
|
|
The full GLS API specification document is not yet available. The
|
||
|
|
primary reason for releasing GLSREF at this time is to allow vendors
|
||
|
|
to begin the development of product-quality implementations of the GLS
|
||
|
|
API.
|
||
|
|
|
||
|
|
For more details on how to use GLSREF as the starting point in the
|
||
|
|
development of a product-quality implementation of the GLS API, see
|
||
|
|
the file doc/porting.txt.
|
||
|
|
|
||
|
|
GLSREF has been built and minimally tested on the following platforms:
|
||
|
|
|
||
|
|
---------------------------------------------------------------------------
|
||
|
|
OS ISA/ABI Build environment
|
||
|
|
---------------------------------------------------------------------------
|
||
|
|
AIX 3.2.5 IBM-POWER AIX XL C Compiler/6000 3.2.5
|
||
|
|
|
||
|
|
Digital Unix 3.0 ALPHA Digital Unix C 3.0
|
||
|
|
|
||
|
|
HP-UX 9.05 PA-RISC HP-UX C 9.0.5
|
||
|
|
|
||
|
|
IRIX 5.3 MIPS-1 IDO 5.3
|
||
|
|
IRIX 5.3 MIPS-1 gcc 2.6.3, IDO 5.3
|
||
|
|
IRIX 6.2 MIPS-3/32 IDO 6.2
|
||
|
|
IRIX 6.2 MIPS-3/64 IDO 6.2
|
||
|
|
|
||
|
|
Linux 1.1.95 X86 binutils 2.5.21.17,
|
||
|
|
gcc 2.7.0,
|
||
|
|
ld.so 1.7.3,
|
||
|
|
libc 5.0.9
|
||
|
|
|
||
|
|
Solaris 2.4 SPARC SPARCompiler C 3.0.1
|
||
|
|
|
||
|
|
Windows NT 3.5 ALPHA SDK 3.5
|
||
|
|
Windows NT 3.5 MIPS-1 Visual C++ 2.0, SDK 3.5
|
||
|
|
Windows NT 3.5 X86 Visual C++ 2.0, SDK 3.5
|
||
|
|
---------------------------------------------------------------------------
|
||
|
|
|
||
|
|
If you need to bring up GLSREF on a platform that is not one of those
|
||
|
|
listed, see the file doc/porting.txt.
|
||
|
|
|
||
|
|
After building and installing the GLS library, commands, and tests,
|
||
|
|
perform a sanity check by running the following commands:
|
||
|
|
|
||
|
|
cmd/glscat data/1.gls
|
||
|
|
|
||
|
|
test/tcallarr data/1.gls
|
||
|
|
|
||
|
|
test/tcapture
|
||
|
|
|
||
|
|
test/tparser
|
||
|
|
|
||
|
|
You should put GLSREF under source code control so you can easily
|
||
|
|
track your changes and integrate them with future GLSREF releases from
|
||
|
|
SGI.
|
||
|
|
|
||
|
|
-------------------------------------------------------------------------------
|
||
|
|
File type recognition
|
||
|
|
-------------------------------------------------------------------------------
|
||
|
|
|
||
|
|
On Unix-type platforms, append one of the following two files to /etc/magic:
|
||
|
|
|
||
|
|
filetype/magic.lsb (little-endian systems)
|
||
|
|
filetype/magic.msb (big-endian systems)
|
||
|
|
|
||
|
|
-------------------------------------------------------------------------------
|
||
|
|
Known problems
|
||
|
|
-------------------------------------------------------------------------------
|
||
|
|
|
||
|
|
- The documentation of the GLS API and encodings is quite inadequate. SGI is
|
||
|
|
developing a specification document for the GLS API and encodings, and
|
||
|
|
will release this document as soon as possible.
|
||
|
|
|
||
|
|
- There is not yet any documentation on how to extend GLS to support
|
||
|
|
vendor-specific GL extensions. If you need to do this, contact SGI
|
||
|
|
to allocate a block of GLS opcodes in the GLS opcode registry that
|
||
|
|
SGI maintains.
|
||
|
|
|
||
|
|
- Mutual exclusion and thread local storage are not supported by GLSREF
|
||
|
|
on the following platforms:
|
||
|
|
|
||
|
|
AIX 3.2.5
|
||
|
|
HP-UX 9.05
|
||
|
|
IRIX 5.3, 6.2 (GLSREF only; SGI product implementation has full support)
|
||
|
|
Linux 1.1.95
|
||
|
|
|
||
|
|
This is due to a lack of adequate support for threads on these platforms.
|
||
|
|
|
||
|
|
- On the AIX 3.2.5 and HP-UX 9.05 platforms, 64-bit integers (types GLlong
|
||
|
|
and GLulong) in a GLS_TEXT stream can be parsed only if they appear in
|
||
|
|
the hexadecimal form 0xdddddddddddddddd. This is due to a lack of
|
||
|
|
adequate 64-bit integer support on these platforms, and could be
|
||
|
|
remedied by enhancing the 64-bit integer parsing code in GLSREF.
|
||
|
|
|
||
|
|
- On the AIX 3.2.5 and HP-UX 9.05 platforms, 64-bit integers (types GLlong
|
||
|
|
and GLulong) in a generated GLS_TEXT stream are always formatted in
|
||
|
|
the hexadecimal form 0xdddddddddddddddd, even in cases where the GLS
|
||
|
|
spec requires decimal formatting. This is due to a lack of adequate
|
||
|
|
64-bit integer support on these platforms, and could be remedied by
|
||
|
|
enhancing the 64-bit integer formatting code in GLSREF.
|
||
|
|
|
||
|
|
-------------------------------------------------------------------------------
|
||
|
|
End
|
||
|
|
-------------------------------------------------------------------------------
|