.\" -*- nroff -*-
-.TH MDASSEMBLE 8 "" v2.5
+.TH MDASSEMBLE 8 "" v3.2
.SH NAME
mdassemble \- assemble MD devices
.I aka
-Linux Software Raid.
+Linux Software RAID
.SH SYNOPSIS
.SH DESCRIPTION
.B mdassemble
is a tiny program that can be used to assemble MD devices inside an
-initial ramdisk (initrd) or initramfs, it is meant to replace the in-kernel
+initial ramdisk (initrd) or initramfs; it is meant to replace the in-kernel
automatic raid detection and activation.
It can be built statically and linked against lightweight libc alternatives, like
.B dietlibc,
Invoking
.B mdassemble
has the same effect as invoking
-.B mdadm --assemble --scan.
+.B mdadm \-\-assemble \-\-scan.
+.PP
+Invoking
+.B mdassemble
+a second time will make all defined arrays readwrite, this is useful if
+using the
+.B start_ro
+module parameter.
.SH OPTIONS
with the exception of
.B auto=
which is supported only if mdadm was built with the
-.B -DMDASSEMBLE_AUTO
+.B \-DMDASSEMBLE_AUTO
define.
.SH SEE ALSO
.PP
.BR mdadm (8),
.BR mdadm.conf (5),
-.BR md (4).
-.PP
+.BR md (4),
.BR diet (1).