![[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 [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1|
Return to ar.1 CVS log | Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1 |
1.1 root 1: .TH AR 1 "24 February 1979"
2: .SH NAME
3: ar \- archive and library maintainer
4: .SH SYNOPSIS
5: .B ar
6: key [ posname ] afile name ...
7: .SH DESCRIPTION
8: .I 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: .B N.B:
15: This version of
16: .I ar
17: uses a ASCII-format archive which is portable among the various
18: machines running \s-2UNIX\s0.
19: Programs for dealing with older formats are available: see
20: .IR arcv (8).
21: .PP
22: .I Key
23: is one character from the set
24: .B drqtpmx,
25: optionally concatenated with
26: one or more of
27: .B vuaibclo.
28: .I Afile
29: is the archive file.
30: The
31: .I names
32: are constituent files in the archive file.
33: The meanings of the
34: .I key
35: characters are:
36: .TP
37: .B d
38: Delete the named files from the archive file.
39: .TP
40: .B r
41: Replace the named files in the archive file.
42: If the optional character
43: .B u
44: is used with
45: .B r,
46: then only those files with `last-modified' dates later than
47: the archive files are replaced.
48: If an optional positioning character from the set
49: .B abi
50: is used, then the
51: .I posname
52: argument must be present
53: and specifies that new files are to be placed
54: after
55: .RB ( a )
56: or before
57: .RB ( b
58: or
59: .BR i )
60: .IR posname .
61: Otherwise
62: new files are placed at the end.
63: .TP
64: .B q
65: Quickly append the named files to the end of the archive file.
66: Optional positioning characters are invalid.
67: The command does not check whether the added members
68: are already in the archive.
69: Useful only to avoid quadratic behavior when creating a large
70: archive piece-by-piece.
71: .TP
72: .B t
73: Print a table of contents of the archive file.
74: If no names are given, all files in the archive are tabled.
75: If names are given, only those files are tabled.
76: .TP
77: .B p
78: Print the named files in the archive.
79: .TP
80: .B m
81: Move the named files to the end of the archive.
82: If a positioning character is present,
83: then the
84: .I posname
85: argument must be present and,
86: as in
87: .B r,
88: specifies where the files are to be moved.
89: .TP
90: .B x
91: Extract the named files.
92: If no names are given, all files in the archive are
93: extracted.
94: In neither case does
95: .B x
96: alter the archive file. Normally the `last-modified' date of each
97: extracted file is the date when it is extracted. However, if
98: .B o
99: is used, the `last-modified' date is reset to the date recorded in the
100: archive.
101: .TP
102: .B v
103: Verbose.
104: Under the verbose option,
105: .I ar
106: gives a file-by-file
107: description of the making of a
108: new archive file from the old archive and the constituent files.
109: When used with
110: .B t,
111: it gives a long listing of all information about the files.
112: When used with
113: .BR p ,
114: it precedes each file with a name.
115: .TP
116: .B c
117: Create.
118: Normally
119: .I ar
120: will create
121: .I afile
122: when it needs to.
123: The create option suppresses the
124: normal message that is produced when
125: .I afile
126: is created.
127: .TP
128: .B l
129: Local.
130: Normally
131: .I ar
132: places its temporary files in the directory /tmp.
133: This option causes them to be placed in the local directory.
134: .SH FILES
135: /tmp/v* temporaries
136: .SH "SEE ALSO"
137: lorder(1), ld(1), ranlib(1), ar(5), arcv(8)
138: .SH BUGS
139: If the same file is mentioned twice in an argument list,
140: it may be put in the archive twice.
141: .LP
142: The `last-modified' date of a file will not be altered by the
143: .B o
144: 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.