1 files changed, 76 insertions, 0 deletions
diff --git a/man/mcpu-readelf.1 b/man/mcpu-readelf.1
new file mode 100644
index 0000000..df770bd
--- /dev/null
+++ b/man/mcpu-readelf.1
@@ -0,0 +1,76 @@
+.TH MCPU-READELF 1 "October 2026" "LibMCPU" "User Commands"
+
+.SH NAME
+mcpu-readelf \- display structured information from MCPU MELF files
+.SH SYNOPSIS
+.B mcpu-readelf
+.RI "option(s) MELF-file(s)"
+.SH DESCRIPTION
+.B mcpu-readelf
+is a read-only inspector for LibMCPU MELF ABI-v1, ABI-v2 and ABI-v3 files.  It
+displays headers, sections, symbols, RELA relocations, dynamic dependency
+metadata and MCPU-specific target/lifecycle records without modifying input.
+.SH OPTIONS
+.TP
+.BR -a ", " --all
+Equivalent to -h -l -S -s -r -d -A.
+.TP
+.BR -e ", " --headers
+Equivalent to -h -l -S.
+.TP
+.BR -h ", " --file-header
+Display the MELF file header.
+.TP
+.BR -l ", " --program-headers
+Display program headers.
+.TP
+.B --segments
+Alias for --program-headers.
+.TP
+.BR -S ", " --section-headers
+Display section headers.
+.TP
+.B --sections
+Alias for --section-headers.
+.TP
+.BR -s ", " --symbols
+Display .symtab and .dynsym symbol tables when present.
+.TP
+.B --syms
+Alias for --symbols.
+.TP
+.BR -r ", " --relocs
+Display RELA relocation sections.
+.TP
+.BR -d ", " --dynamic
+Display ABI-v3 .dynamic dependency metadata including SONAME and NEEDED.
+.TP
+.BR -A ", " --arch-specific
+Display MCPU target and lifecycle metadata.
+.TP
+.BR -W ", " --wide
+Do not truncate output; accepted for GNU-readelf-style compatibility.
+.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 when all requested files are read successfully; nonzero for malformed,
+unsupported or inaccessible input.
+.SH EXAMPLES
+.nf
+mcpu-readelf -h -S file.o
+mcpu-readelf -s -r file.o
+mcpu-readelf -l -A program
+mcpu-readelf -d libfoo.so.1
+mcpu-readelf -a program
+.fi
+.SH SEE ALSO
+.BR mcpu-nm (1),
+.BR mcpu-objdump (1),
+.BR libmcpu (7)