summaryrefslogtreecommitdiff
path: root/mdassemble.8
diff options
context:
space:
mode:
Diffstat (limited to 'mdassemble.8')
-rw-r--r--mdassemble.865
1 files changed, 65 insertions, 0 deletions
diff --git a/mdassemble.8 b/mdassemble.8
new file mode 100644
index 00000000..0e640023
--- /dev/null
+++ b/mdassemble.8
@@ -0,0 +1,65 @@
+.\" -*- nroff -*-
+.TH MDASSEMBLE 8 "" v3.3.2
+.SH NAME
+mdassemble \- assemble MD devices
+.I aka
+Linux Software RAID
+
+.SH SYNOPSIS
+
+.BI mdassemble
+
+.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
+automatic RAID detection and activation.
+It can be built statically and linked against lightweight libc alternatives, like
+.B dietlibc,
+.B klibc
+or
+.B uClibc.
+
+.SH USAGE
+Invoking
+.B mdassemble
+has the same effect as invoking
+.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
+
+There are no options to
+.B mdassemble.
+
+.SH FILES
+
+.SS /etc/mdadm/mdadm.conf
+
+The config file lists which devices may be scanned to see if
+they contain MD super block, and gives identifying information
+(e.g. UUID) about known MD arrays. See
+.BR mdadm.conf (5)
+for more details.
+
+.B mdassemble
+supports all configuration parameters defined in
+.B mdadm.conf
+with the exception of
+.B auto=
+which is supported only if mdadm was built with the
+.B \-DMDASSEMBLE_AUTO
+define.
+
+.SH SEE ALSO
+.PP
+.BR mdadm (8),
+.BR mdadm.conf (5),
+.BR md (4),
+.BR diet (1).