123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135 |
- .\" $Header$
- .TH ARCH 1
- .SH NAME
- arch \- archive and library maintainer
- .SH SYNOPSIS
- .B arch
- key [ posname ] afile name ...
- .SH DESCRIPTION
- .I Arch
- maintains groups of files
- combined into a single archive file.
- Its main use
- is to create and update library files as used by a linker.
- It can be used, though, for any similar purpose.
- The Amsterdam compiler kit provides its own archiver with a
- fixed, machine-independent format, much like the UNIX-V7
- archive format.
- EM programs using libraries assume archives in EM format.
- .PP
- .I Key
- is one character from the set
- .B drqtpmx,
- optionally concatenated with
- one or more of
- .B vuaibcl.
- .I Afile
- is the archive file.
- The
- .I names
- are constituent files in the archive file.
- The meanings of the
- .I key
- characters are:
- .TP
- .B d
- Delete the named files from the archive file.
- .TP
- .B r
- Replace the named files in the archive file.
- If the optional character
- .B u
- is used with
- .B r,
- then only those files with
- modified dates later than
- the archive files are replaced.
- If an optional positioning character from the set
- .B abi
- is used, then the
- .I posname
- argument must be present
- and specifies that new files are to be placed
- after
- .RB ( a )
- or before
- .RB ( b
- or
- .BR i )
- .IR posname .
- Otherwise
- new files are placed at the end.
- .TP
- .B q
- Quickly append the named files to the end of the archive file.
- Optional positioning characters are invalid.
- The command does not check whether the added members
- are already in the archive.
- Useful only to avoid quadratic behavior when creating a large
- archive piece-by-piece.
- .TP
- .B t
- Print a table of contents of the archive file.
- If no names are given, all files in the archive are tabled.
- If names are given, only those files are tabled.
- .TP
- .B p
- Print the named files in the archive.
- .TP
- .B m
- Move the named files to the end of the archive.
- If a positioning character is present,
- then the
- .I posname
- argument must be present and,
- as in
- .B r,
- specifies where the files are to be moved.
- .TP
- .B x
- Extract the named files.
- If no names are given, all files in the archive are
- extracted.
- In neither case does
- .B x
- alter the archive file.
- .TP
- .B v
- Verbose.
- Under the verbose option,
- .I arch
- gives a file-by-file
- description of the making of a
- new archive file from the old archive and the constituent files.
- When used with
- .B t,
- it gives a long listing of all information about the files.
- When used with
- .BR p ,
- it precedes each file with a name.
- .TP
- .B c
- Create.
- Normally
- .I arch
- will create
- .I afile
- when it needs to.
- The create option suppresses the
- normal message that is produced when
- .I afile
- is created.
- .TP
- .B l
- Local.
- Normally
- .I arch
- places its temporary files in the directory /tmp.
- This option causes them to be placed in the local directory.
- .SH FILES
- /tmp/v* temporaries
- .SH "SEE ALSO"
- em_ass(I), arch(V),
- .SH BUGS
- If the same file is mentioned twice in an argument list,
- it may be put in the archive twice.
|