ftp://ftp.stratus.com/pub/vos/alpha/unzip-5.32/README.vos
ftp://ftp.stratus.com/pub/vos/alpha/unzip-5.32.txt

Unzip README file for the Stratus VOS operating system.
Paul Green (Paul.Green@stratus.com)
November 21, 2006


Introduction
------------
This is a port of Unzip version 5.32 to VOS.  Unzip is a
file-archiving and file-decompression command that is compatible
with the PKUNZIP command that is available on other systems.

Most of the Unzip features should work on VOS.

I have supplied binaries for all Stratus architectures (Motorola
68000, Intel 860, HP PA-RISC 7100, HP PA-RISC 8000, Intel
Pentium4).  Therefore, you do not need to build Zip first.  You
can rebuild Unzip if you prefer, or if you want to make further
changes.


Compiling Unzip on VOS
----------------------
Before you can build Unzip on VOS, you need to have or acquire the
following additional items.

1.   The VOS Standard C Compiler and Runtime, or the VOS Standard C
     Cross-Compiler.  This is a standard Stratus product.

2.   For building on the Motorola 68000 or Intel 860 machines,
     you also need the alpha version of the VOS POSIX.1
     environment.  As of this writing, this is available on the
     VOS FTP site.  Login to ftp.stratus.com anonymously and get
     the file /pub/vos/alpha/posix.save.evf.gz in binary
     file-transfer mode.  Or use the Uniform Resource Locator
     (URL) ftp://ftp.stratus.com/pub/vos/alpha/posix.save.evf.gz
     from your web browser.  This is not a standard Stratus
     product.

     For building on the other platforms, you need the
     generally-available version of VOS POSIX.1 support.  As
     long as you are running VOS Release 14.3.0 or later, and
     have purchased the VOS C runtime, you will have this
     product.

To build Unzip, change to one of the VOS object directories (e.g.,
unzip-5.32>vos>obj), and give the command "<build".  If you have
the cross-compilers and wish to build for a specific
architecture, say "<build -processor pa7100" (for example).  You
can also customize the "compile_zip.cm" command macro for your
system.


Installing Unzip on VOS
-----------------------
1.   Create the directory >system>ported>command_library.  Or
     pick another directory of your choice.

2.   Copy the appropriate version of the Unzip program modules to
     this directory.  For example, with your current directory
     set to the top-level directory of Unzip, to install the
     executable program module for the Motorola 68K
     architecture, enter:

     !copy_file vos>obj>*.pm >system>ported>command_library


Restrictions
------------
This port of Unzip prefers Unix-style, slash-separated pathnames
over VOS-style greater-than-separated pathnames.  VOS-style
pathnames should work in most contexts, but if you have trouble,
replace all greater-than signs by slash characters.  Because the
slash character is used as a pathname delimiter, Unzip cannot
process VOS pathnames containing a slash character in a
directory or file name; these must be renamed.

This port of Unzip also uses Unix-epoch date values internally.
As long as you are dealing with ASCII character string
representations of dates, this should not be an issue.  The
supported epoch is January 1, 1980 to January 17, 2038.

Don't try to place VOS fixed files, relative files, message
queues, or server queues into a zip file.  Don't place a VOS
sequential file that contains binary data into a zip file.  The
current version of Zip does not diagnose this, and it may
actually create a zip file.  But the contents of the extracted
file will not be identical to the original file after
extraction.

You can place a VOS sequential file that contains text data, and
you can place a VOS stream file that contains any data.


Support Status
--------------
I'm offering this port "as is".  You can ask me questions, but I
can't guarantee I'll be able to answer them; I don't know much
about Unzip itself; I'm still learning that.

(end)