Bug#396914: Please add hint about mdadm.conf overriding the default metadata version

[Goswin Brederlow]

Package: mdadm
Version: 2.5.5-1
Severity: wishlist
Tags: patch

Hi,

yesterday I created a new raid1 and after a reboot the kernel
complained about a broken superblock. I had to change the metadata
version back to 0.90 when creating the array for the kernel to accept
it. The manpage says 0.90 is the default so I first thought that was
out of date. Later I noticed that when I created the mdadm.conf a
while back a "CREATE ... metadata=1" lines got in there.

Below is a patch that adds a helpfull hint to the manpage that the
default might differ from 0.90 due to mdadm.conf.

MfG
	Goswin

----------------------------------------------------------------------
#! /bin/sh /usr/share/dpatch/dpatch-run
## 99-mdadm-manpage-e-default-note.dpatch by martin f. krafft <madduck at debian.org>
##
## All lines beginning with `## DP:' are a description of the patch.
## DP: No description.

@DPATCH@
diff -urNad trunk~/mdadm.8 trunk/mdadm.8
--- trunk~/mdadm.8	2006-10-23 07:51:57.000000000 +0200
+++ trunk/mdadm.8	2006-11-03 17:05:31.000000000 +0100
@@ -269,10 +269,16 @@
 says to get a list of array devices from
 .BR /proc/mdstat .
 
-.TP
+.tp
 .B -e ", " --metadata=
 Declare the style of superblock (raid metadata) to be used.  The
-default is 0.90 for --create, and to guess for other operations.
+default is 0.90 for --create, and to guess for other operations. The default
+can be overridden by setting the
+.B metadata
+value for the
+.B CREATE
+keyword in 
+.BR mdadm.conf .
 
 Options are:
 .RS
----------------------------------------------------------------------

-- Package-specific info:
-- System Information:
Debian Release: 4.0
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.18-xen-frosties
Locale: LANG=C, LC_CTYPE=de_DE (charmap=ISO-8859-1)

Versions of packages mdadm depends on:
ii  debconf [debconf-2.0]        1.5.8       Debian configuration management sy
ii  libc6                        2.3.6.ds1-7 GNU C Library: Shared libraries
ii  lsb-base                     3.1-19      Linux Standard Base 3.1 init scrip
ii  makedev                      2.3.1-83    creates device files in /dev

Versions of packages mdadm recommends:
ii  exim4-daemon-light [mail-tran 4.63-8     lightweight exim MTA (v4) daemon
ii  module-init-tools             3.2.2-3    tools for managing Linux kernel mo

-- debconf information excluded