.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)