blob: 3de29f8349e8bc899b2716f1a07f453744922f01 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
.TH MCPU-AR 1 "October 2026" "LibMCPU" "User Commands"
.SH NAME
mcpu-ar \- create and maintain deterministic MCPU static archives
.SH SYNOPSIS
.B mcpu-ar
.RI [ options ] " operation archive " [ member ...]
.SH DESCRIPTION
.B mcpu-ar
creates and maintains deterministic UNIX ar archives whose ordinary members
are MCPU MELF ET_REL objects. Member order is preserved. A standard
System-V/GNU-style archive symbol index can be built with the s operation or
modifier and is used by
.BR mcpu-ld (1)
for selective extraction.
.SH OPERATIONS
.TP
.B r
Replace matching members in place or append members not already present.
.TP
.B q
Append members without replacement.
.TP
.B d
Delete named members.
.TP
.B t
List members.
.TP
.B p
Write selected member contents to standard output.
.TP
.B x
Extract selected members into the current directory.
.TP
.B s
Rebuild the archive symbol index.
.SH MODIFIERS
.TP
.B c
Accepted for ar compatibility; archive creation is quiet.
.TP
.B s
Write or rebuild the standard archive symbol index.
.TP
.B v
Verbose operation.
.PP
Operation and modifiers may be combined, for example rcs, tv or xv.
.SH OPTIONS
.TP
.B --help
Display help and exit.
.TP
.B --version
Display the program name, MCPU toolchain identity and version, then exit.
.TP
.B --dump-version
Display only the MCPU package version number and exit.
.SH EXIT STATUS
Zero on success; nonzero on malformed archives, invalid members, I/O or command
errors.
.SH EXAMPLES
.nf
mcpu-ar rcs libsimple.a add-one.o add-two.o value.o
mcpu-ar t libsimple.a
mcpu-ar tv libsimple.a
mcpu-ar x libsimple.a add-one.o
mcpu-ar s libsimple.a
.fi
.SH SEE ALSO
.BR mcpu-ld (1),
.BR mcpu-nm (1),
.BR mcpu-objdump (1),
.BR libmcpu (7)
|
