Previous: vpack Up: Application Packer
The vunpack program does precisely what its name suggests - it unpacks files from a COM file created by vpack. Its primary use is on systems other than VMS, where the COM file is not self-extracting. It may of course be used under VMS also.
The vunpack program accepts a list of parameters as follows:
vunpack <file.com> [{source|pdf|imake|build|make|
test|repack|doc|std|system|unpack|all}]
or
vunpack <file.com> -f file.1 file.2 file.3
As in the vpack program, if you call the vunpack program with no parameters, the program will tell you that you made an error and will tell you the proper syntax to use.
The first parameter tells vunpack which COM file to extract files from, and the remaining (optional) parameters tell the program which file(s) to extract. You may extract more than one type of file, if desired, by putting more than one type on the command line, separated by spaces. If no parameters other than the COM file name are provided, the program unpacks all the files in the COM file.
The vunpack program will not automatically compile and link the
program, but it can extract the imakefile so that you can create the BLD file
(VMS) or makefile (Unix) which can create the executable for you. See
Section , Vimake, for details.
The vunpack program also allows you to extract a list of specified files from the COM file. Instead of unpacking groups of files, by specifying `` -f'' and supplying a list of one or more file names, you can have vunpack unpack only the file(s) you need.
For example, if only host.c was needed from the view.com file, you would type the following:
vunpack view.com -f host.c
However, if you need all of the source files and the imakefile from VIEW.COM, you would type the following:
vunpack view.com source imake
The vunpack program will extract files from the COM file and put them in the current directory, but it will not alter the COM file in any way.