[unix-history] / misc / ar.1

.th AR I 7/14/75
.sh NAME
ar \*- archive and library maintainer
.sh SYNOPSIS
.bd ar
key [ posname ] afile name ...
.sh DESCRIPTION
.it Ar
maintains groups of files
combined into a single archive file.
Its main use
is to create and update library files as used by the loader.
It can be used, though, for any similar purpose.
.s3
.it Key
is one character from the set
.bd drtpmx,
optionally concatenated with
.bd vuai.
.it Afile
is the archive file.
The
.it names
are constituent files in the archive file.
The meanings of the
.it key
characters are:
.s3
.bd d
means delete the named files from the archive file.
.s3
.bd r
means replace the named files in the archive file.
If the optional character
.bd u
is used with
.bd r,
then only those files with
modified dates later than
the archive files are replaced.
If the optional positioning character
.bd a
(also
.bd i
)
is used, then the
.it posname
argument must be present
and specifies a file in the archive
after (before for
.bd i
)
which new files are placed.
Without
.bd a
or
.bd i,
new files are placed at the end.
.s3
.bd t
prints 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.
.s3
.bd p
prints the named files in the archive.
.s3
.bd m
moves the named files to the end of the archive.
If the options
.bd i
or
.bd b
are used, then the
.it posname
argument must be present and,
as in
.bd r,
specifies where the files are to be moved
.s3
.bd x
extracts the named files.
If no names are given, all files in the archive are
extracted.
In neither case does
.bd x
alter the archive file.
.s3
.bd v
means verbose.
Under the verbose option,
.it ar
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
.bd t,
it gives a long listing of all information about the files.
.sh FILES
/tmp/vtm?	temporary
.sh "SEE ALSO"
ld (I), archive (V)
.sh BUGS
If the same file is mentioned twice in an argument list,
it may be put in the archive twice.
Commit	Line	Data
93fd070f BJ	1	.th AR I 7/14/75
	2	.sh NAME
	3	ar \*- archive and library maintainer
	4	.sh SYNOPSIS
	5	.bd ar
	6	key [ posname ] afile name ...
	7	.sh DESCRIPTION
	8	.it Ar
	9	maintains groups of files
	10	combined into a single archive file.
	11	Its main use
	12	is to create and update library files as used by the loader.
	13	It can be used, though, for any similar purpose.
	14	.s3
	15	.it Key
	16	is one character from the set
	17	.bd drtpmx,
	18	optionally concatenated with
	19	.bd vuai.
	20	.it Afile
	21	is the archive file.
	22	The
	23	.it names
	24	are constituent files in the archive file.
	25	The meanings of the
	26	.it key
	27	characters are:
	28	.s3
	29	.bd d
	30	means delete the named files from the archive file.
	31	.s3
	32	.bd r
	33	means replace the named files in the archive file.
	34	If the optional character
	35	.bd u
	36	is used with
	37	.bd r,
	38	then only those files with
	39	modified dates later than
	40	the archive files are replaced.
	41	If the optional positioning character
	42	.bd a
	43	(also
	44	.bd i
	45	)
	46	is used, then the
	47	.it posname
	48	argument must be present
	49	and specifies a file in the archive
	50	after (before for
	51	.bd i
	52	)
	53	which new files are placed.
	54	Without
	55	.bd a
	56	or
	57	.bd i,
	58	new files are placed at the end.
	59	.s3
	60	.bd t
	61	prints a table of contents of the archive file.
	62	If no names are given, all files in the archive are tabled.
	63	If names are given, only those files are tabled.
	64	.s3
65	.bd p
66	prints the named files in the archive.
67	.s3
68	.bd m
69	moves the named files to the end of the archive.
70	If the options
71	.bd i
72	or
73	.bd b
74	are used, then the
75	.it posname
76	argument must be present and,
77	as in
78	.bd r,
79	specifies where the files are to be moved
80	.s3
81	.bd x
82	extracts the named files.
83	If no names are given, all files in the archive are
84	extracted.
85	In neither case does
86	.bd x
87	alter the archive file.
88	.s3
89	.bd v
90	means verbose.
91	Under the verbose option,
92	.it ar
93	gives a file-by-file
94	description of the making of a
95	new archive file from the old archive and the constituent files.
96	When used with
97	.bd t,
98	it gives a long listing of all information about the files.
99	.sh FILES
100	/tmp/vtm? temporary
101	.sh "SEE ALSO"
102	ld (I), archive (V)
103	.sh BUGS
104	If the same file is mentioned twice in an argument list,
105	it may be put in the archive twice.