![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to ar CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Plan 9 NeXT] / lucent / sys / man / 1|
Return to ar CVS log | Up to [Plan 9 NeXT] / lucent / sys / man / 1 |
1.1 root 1: .TH AR 1
2: .SH NAME
3: ar \- archive and library maintainer
4: .SH SYNOPSIS
5: .B ar
6: .I key
7: [
8: .I posname
9: ]
10: .I afile
11: [
12: .I file ...
13: ]
14: .SH DESCRIPTION
15: .I Ar
16: maintains groups of files
17: combined into a single archive file,
18: .IR afile .
19: The main use of
20: .I ar
21: is to create and update library files for the loaders
22: .IR 2l (1),
23: etc.
24: It can be used, though, for any similar purpose.
25: .PP
26: .I Key
27: is one character from the set
28: .BR drqtpmx ,
29: optionally concatenated with
30: one or more of
31: .BR vuaibclo .
32: The
33: .I files
34: are constituents of the archive
35: .IR afile .
36: The meanings of the
37: .I key
38: characters are:
39: .TP
40: .B d
41: Delete
42: .I files
43: from the archive file.
44: .TP
45: .B r
46: Replace
47: .I files
48: in the archive file, or add them if missing.
49: Optional modifiers are
50: .RS
51: .PD0
52: .TP
53: .B u
54: Replace only files with
55: modified dates later than that of
56: the archive.
57: .TP
58: .B a
59: Place new files after
60: .I posname
61: in the archive rather than at the end.
62: .TP
63: .BR b " or " i
64: Place new files before
65: .I posname
66: in the archive.
67: .RE
68: .PD
69: .TP
70: .B q
71: Quick. Append
72: .I files
73: to the end of the archive without checking for duplicates.
74: Avoids quadratic behavior in
75: .LR "for (i in *.o) ar r lib.a $i" .
76: .TP
77: .B t
78: List a table of contents of the archive.
79: If names are given, only those files are listed.
80: .TP
81: .B p
82: Print the named files in the archive.
83: .TP
84: .B m
85: Move the named files to the end or elsewhere,
86: specified as with
87: .LR r .
88: .TP
89: .B o
90: Preserve the access and modification times of files
91: extracted with the
92: .B x
93: command.
94: .TP
95: .B x
96: Extract the named files.
97: If no names are given, all files in the archive are
98: extracted.
99: In neither case does
100: .B x
101: alter the archive file.
102: .TP
103: .B v
104: Verbose.
105: Give a file-by-file
106: description of the making of a
107: new archive file from the old archive and the constituent files.
108: With
109: .BR p ,
110: precede each file with a name.
111: With
112: .BR t ,
113: give a long listing of all information about the files,
114: somewhat like a listing by
115: .IR ls (1),
116: showing
117: .br
118: .ns
119: .IP
120: .B
121: mode uid/gid size date name
122: .TP
123: .B c
124: Create.
125: Normally
126: .I ar
127: will create a new archive when
128: .I afile
129: does not exist, and give a warning.
130: Option
131: .B c
132: discards any old contents and suppresses the warning.
133: .TP
134: .B l
135: Local.
136: Normally
137: .I ar
138: places its temporary files in the directory
139: .BR /tmp .
140: This option causes them to be placed in the local directory.
141: .PP
142: When a
143: .BR d ,
144: .BR r ,
145: or
146: .BR m
147: .I key
148: is specified and all members of the archive are valid object files for
149: the same architecture,
150: .I ar
151: inserts a table of contents, required by the loaders, at
152: the front of the library.
153: The table of contents is
154: rebuilt whenever the archive is modified, except
155: when the
156: .B q
157: .I key
158: is specified or when the table of contents is
159: explicitly moved or deleted.
160: .SH EXAMPLE
161: .TP
162: .L
163: ar cr lib.a *.o
164: Replace the contents of library
165: .L lib.a
166: with the object files in the current directory.
167: .SH FILES
168: .TF /tmp/vxxxx
169: .TP
170: .B /tmp/v*
171: temporaries
172: .SH SOURCE
173: .B /sys/src/cmd/ar.c
174: .SH "SEE ALSO"
175: .IR 2l (1),
176: .IR ar (6)
177: .SH BUGS
178: If the same file is mentioned twice in an argument list,
179: it may be put in the archive twice.
180: .br
181: This command predates Plan 9 and makes some invalid assumptions,
182: for instance that user id's are numeric.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.