%%s 0/0/0
%%d D 1.1 25-Mar-82 12:00:38 v1.1 1 0
%%c Version 1.1 is the Spring 1982 Distribution of the LBL/Hughes release
%%c of the Software Tools Virtual Operating System software and documentation.
%%T
%%I 1
#-h- acat.r           502  asc  25-mar-82 07:13:56  v1.1 (sw-tools v1.1)
#-h- main             429  asc  25-mar-82 07:13:44  v1.1 (sw-tools v1.1)
DRIVER(acat)

character file(MAXLINE), c
integer i
filedes fd
character agetch
integer getarg
filedes aopen

string usestr "usage:  acat archive`module[`module...] ..."

call query(usestr)
for (i=1; getarg(i, file, MAXLINE) != EOF; i=i+1)
  {
  if (aopen(file, fd, size) == ERR)
    call cant(file)
  while (agetch(c, fd, size) != EOF)
    call putch(c, STDOUT)
  call close(fd)
  }
if (i == 1)
  call error(usestr)

DRETURN
end
#-h- acat.fmt         856  asc  25-mar-82 07:13:56  v1.1 (sw-tools v1.1)
.so ~bin/manhdr
.hd Acat (1) 11-Mar-82
concatenate nested archive entries on standard output
.sy
acat archive`module[`module...] ...
.ds
`acat' performs the equivalent function to `cat' on archive
files created by the `ar' utility.
The true power of `acat' lies in its ability to extract the modules from
within nested archives.  Some examples may help clarify its use.
.sp
Suppose the file arch1 consists of the modules mod1a, mod1b and mod1c.
In addition, mod1c is itself an archive, consisting of modules mod2a and
mod2b.  The command line
.sp
% acat arch1`mod1a
.sp
is equivalent to the `ar' command
.sp
% ar p arch1 mod1a
.sp
More importantly, if the user desires to see mod2a in mod1c in arch1, the
command
.sp
%acat arch1`mod1a`mod2a
.sp
will do the trick.
.fl

.sa
ar - archive file maintainer
.br
cat - concatenate files
.di

.au
Joe Sventek
.bu

%%E 1