![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to ar.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / pgrm / ar|
Return to ar.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / pgrm / ar |
1.1 root 1: .\" Copyright (c) 1990 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)ar.1 6.4 (Berkeley) 7/24/90
6: .\"
7: .Dd July 24, 1990
8: .Dt AR 1
9: .Os ATT 7th
10: .Sh NAME
11: .Nm ar
12: .Nd archive and library maintainer
13: .Sh SYNOPSIS
14: .Nm ar
15: .Cm key
16: .Op Ar posname
17: .Ar afile name ...
18: .Sh DESCRIPTION
19: .Nm Ar
20: maintains groups of files
21: combined into a single archive file.
22: Its main use
23: is to create and update library files as used by the loader.
24: It can be used, though, for any similar purpose.
25: .Sy N.B.:
26: This version of
27: .Nm ar
28: uses a ASCII-format archive which is portable among the various
29: machines running UNIX.
30: Programs for dealing with older formats are available: see
31: .Xr arcv 8 .
32: .Pp
33: .Cm Key
34: is one character from the set
35: .Fl drqtpmx
36: optionally concatenated with
37: one or more of
38: .Fl vuaibclo .
39: .Ar Afile
40: is the archive file.
41: The
42: .Ar names
43: are constituent files in the archive file.
44: The meanings of the
45: .Fl key
46: characters are:
47: .Tp Fl d
48: Delete the named files from the archive file.
49: .Tp Fl r
50: Replace the named files in the archive file.
51: If the optional character
52: .Fl u
53: is used with
54: .Fl r
55: then only those files with
56: .Li last-modified
57: dates later than
58: the archive files are replaced.
59: If an optional positioning character from the set
60: .Fl abi
61: is used, then the
62: .Ar posname
63: argument must be present
64: and specifies that new files are to be placed
65: after
66: .Fl a
67: or before
68: .Fl b
69: or
70: .Fl i
71: .Ar posname .
72: Otherwise
73: new files are placed at the end.
74: .Tp Fl q
75: Quickly append the named files to the end of the archive file.
76: Optional positioning characters are invalid.
77: The command does not check whether the added members
78: are already in the archive.
79: Useful only to avoid quadratic behavior when creating a large
80: archive piece-by-piece.
81: .Tp Fl t
82: Print a table of contents of the archive file.
83: If no names are given, all files in the archive are tabled.
84: If names are given, only those files are tabled.
85: .Tp Fl p
86: Print the named files in the archive.
87: .Tp Fl m
88: Move the named files to the end of the archive.
89: If a positioning character is present,
90: then the
91: .Ar posname
92: argument must be present and,
93: as in
94: .Fl r
95: specifies where the files are to be moved.
96: .Tp Fl x
97: Extract the named files.
98: If no names are given, all files in the archive are
99: extracted.
100: In neither case does
101: .Fl x
102: alter the archive file. Normally the `last-modified' date of each
103: extracted file is the date when it is extracted. However, if
104: .Fl o
105: is used, the `last-modified' date is reset to the date recorded in the
106: archive.
107: .Tp Fl v
108: Verbose.
109: Under the verbose option,
110: .Nm ar
111: gives a file-by-file
112: description of the making of a
113: new archive file from the old archive and the constituent files.
114: When used with
115: .Fl t
116: it gives a long listing of all information about the files.
117: When used with
118: .Fl p ,
119: it precedes each file with a name.
120: .Tp Fl c
121: Create.
122: Normally
123: .Nm ar
124: will create
125: .Ar afile
126: when it needs to.
127: The create option suppresses the
128: normal message that is produced when
129: .Ar afile
130: is created.
131: .Tp Fl l
132: Local.
133: Normally
134: .Nm ar
135: places its temporary files in the directory /tmp.
136: This option causes them to be placed in the local directory.
137: .Tp
138: .Sh FILES
139: .Dw /tmp/v*
140: .Di L
141: .Dp Pa tmp/v*
142: temporaries
143: .Dp
144: .Sh SEE ALSO
145: .Xr lorder 1 ,
146: .Xr ld 1 ,
147: .Xr ranlib 1 ,
148: .Xr ar 5 ,
149: .Xr arcv 8
150: .Sh HISTORY
151: .Nm Ar
152: appeared in vanilla Version 6 AT&T UNIX. The Version 7
153: .Nm ar
154: appeared
155: in 2.0 BSD.
156: .Sh BUGS
157: If the same file is mentioned twice in an argument list,
158: it may be put in the archive twice.
159: .Pp
160: The
161: .Li last-modified
162: date of a file will not be altered by the
163: .Fl o
164: option if the user is not the owner of the extracted file, or the super-user.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.