This directory contains sources to build executable copies of
pgextract, pgzip, and pgunzip.  These can be used to access the
CCFF information that the PGI compilers append to the object files,
for instance.

These utilities use the zlib general purpose compression library
written by Jean-loup Gailly and Mark Adler.  pgzip and pgunzip,
in particular, are based on the excellent and well-documented
zpipe.c example Version 1.2 (November 2004) written by Mark Adler.
See www.zlib.net for more information on zlib.

The makefile is set up to build with pgcc, and uses the system
libz.  You can modify the makefiles to use another compiler or another
version of libz.  pgextract can be built without libz, but obviously
pgzip and pgunzip cannot.

The command line for pgzip is:
	pgzip [-[0-9]] [infile [outfile]]
If the infile or outfile names are missing, stdin and stdout are used.
The integer flag is the zlib compression level to use; the default is to
use level 9, maximum compression.

The command line for pgunzip is:
	pgunzip [infile [outfile]]
If the infile or outfile names are missing, stdin and stdout are used.

The command line for pgextract is:
	pgextract [flags] objectfile [-name] sectionname outputfile
The flags are:
	--	treat any subsequent arguments as nonswitches.
	-help	command line help
	-name	following argument is the section name
	-q	be quiet
	-cz	decompress using zlib
	-mscoff	treat object file as an MS-COFF object
	-coff	same as -mscoff
	-elf	treat object file as an ELF object
	-osx	treat object file as an OSX MACH-O object
	-xmltag	The following argument will be surrounded by XML
		brackets (<>), and the XML tag will be prepended and
		appended to the output file.
