Unpack a ShrinkIt archive from the wild
Watch / unshrink
Filmed on the Apple IIe 80-column display. The same session on the Videx UltraTerm: same keys, same text.
The Videx UltraTerm was an 80-column video card for the Apple IIe, with its own video memory and character generator, real hardware scrolling and more screen modes than the IIe's own 80 columns. This demo runs on either display; the UltraTerm film shows the original Videx UltraTerm, emulated.
Thirty years of Apple II software lives in ShrinkIt archives. This one is real, a 1990 freeware utility fetched from the asimov.net mirror. The demo lists it with nulib2 -v, unpacks it with nulib2 -x, lists the files, and reads the documentation with more.
What it types
Everything it types, in order. A line starting with $ is a command at the shell, RET included; keys lines are single keystrokes to a program (RET, ESC and the control keys are named).
$ cd /mnt/MAUX/OUT $ nulib2 -v /mnt/MAUX/ARC/VBLSET.SHK $ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK $ ls $ cksum SET.TIME SET.TIME.DOC $ more SET.TIME.DOC
Between steps it presses ^L to clear the screen.
What the captions say
- Thirty years of Apple II software lives in ShrinkIt archives.
- This one is real: Doug Reeder's VBL clock utilities, 1990.
- Fetched from the wild in 2026.
- nulib2 -x unpacks it. LZW decompression on a 6502.
- ProDOS names run to 15 characters, and not one more.
- Two files that came out of the compressor: checksums first.
- And the documentation, straight from the archive.
The gate that proves it
This film is made by site/demos/unshrink.py. Run as assertions, the
same file is make check-demo-unshrink, and it runs with the rest of the tests. It requires that the machine’s listing agrees with an independent reader of the archive on every name, type, size and auxiliary type; that the directory after unpacking holds exactly the archive’s files; that cksum of an unpacked program and an unpacked text file, both stored compressed (LZW) in the archive, equals the host’s checksum of the archive’s own bytes; and that the documentation text comes out row for row. The checks themselves were tested: with nulib2 replaced by a copy of true the listing is empty; with one byte flipped inside the compressed stream nulib2 reports a damaged stream and the demo fails at "nulib2 -x says nothing"; with cksum or more replaced by true the checksum and the text rows fail.
Transcript
The screen at every checkpoint the test checks, as the recorder saved it:
== host: the two files the demo checks are LZW-compressed in the archive, so only a working decompressor gets them right (t=0.0 s) $ == list (t=22.6 s) $ cd /mnt/MAUX/OUT $ nulib2 -v /mnt/MAUX/ARC/VBLSET.SHK BIN 119 $0359 VBL.CLOCK.INT BIN 64 $6000 VBL.CLOCK.SETUP BIN 7438 $6000 SET.TIME TXT 433 $0000 VBL.CLOCK.DOC TXT 615 $0000 SET.TIME.DOC $ == the machine lists the same records, types and sizes as an independent reader of the archive (t=22.6 s) $ cd /mnt/MAUX/OUT $ nulib2 -v /mnt/MAUX/ARC/VBLSET.SHK BIN 119 $0359 VBL.CLOCK.INT BIN 64 $6000 VBL.CLOCK.SETUP BIN 7438 $6000 SET.TIME TXT 433 $0000 VBL.CLOCK.DOC TXT 615 $0000 SET.TIME.DOC $ == nulib2 -x says nothing and the prompt is back (t=36.3 s) $ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK $ == ls (t=42.3 s) $ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK $ ls SET.TIME VBL.CLOCK.DOC VBL.CLOCK.SETUP SET.TIME.DOC VBL.CLOCK.INT $ == ls shows exactly the archive's files (t=42.3 s) $ nulib2 -x /mnt/MAUX/ARC/VBLSET.SHK $ ls SET.TIME VBL.CLOCK.DOC VBL.CLOCK.SETUP SET.TIME.DOC VBL.CLOCK.INT $ == cksum (t=59.9 s) $ cksum SET.TIME SET.TIME.DOC 1778855797 7438 SET.TIME 1371311518 615 SET.TIME.DOC $ == cksum of the two unpacked files equals the host's checksum of the archive's own bytes (t=59.9 s) $ cksum SET.TIME SET.TIME.DOC 1778855797 7438 SET.TIME 1371311518 615 SET.TIME.DOC $ == the documentation record comes out row for row (t=72.1 s) $ more SET.TIME.DOC Set.Time by Doug Reeder Use the arrow keys to set the time and date to the present and then hit return. Set.Time remembers the last time you set, provided you keep the program named SE T.TIME and set the prefix to the directory it's in before you run it. A very useful thing to do if you have SETUP.SYSTEM is to put Set.Time in your SE TUPS directory. Set.Time was written in Aardvaark Pascal. Copyright 1990 by Doug Reeder Free for non-commercial purposes. Corporate Licence: $5 Doug Reeder BITNET: reeder@reed.BITNET 1718 Birch USENET: ...!tektronix!reed!reeder Richland,WA 99352 $