[opensuse] mdadm man page is bad too
Like most man pages, examples that would clarify meanings are absent. What does that last parameter mean exactly in the following example I found Googling? mdadm --assemble /dev/md/alpha --name=alpha --update=name /dev/sd[fg] I want to change the name of /dev/md1 from what it is now to something else. /dev/md1 is made from /dev/sda15 and /dev/sdb15 using v1.0 metadata. This is its detail: /dev/md7: Version : 1.0 Creation Time : Sun Apr 15 16:41:25 2012 Raid Level : raid1 Array Size : 156280216 (149.04 GiB 160.03 GB) Used Dev Size : 156280216 (149.04 GiB 160.03 GB) Raid Devices : 2 Total Devices : 2 Persistence : Superblock is persistent Intent Bitmap : Internal Update Time : Sat Apr 12 00:34:16 2014 State : active Active Devices : 2 Working Devices : 2 Failed Devices : 0 Spare Devices : 0 Name : big31:7 (local to host big31) UUID : 922adc12:0bb3652b:d6259dfa:37406525 Events : 440 Number Major Minor RaidDevice State 0 8 15 0 active sync /dev/sda15 1 8 31 1 active sync /dev/sdb15 -- "The wise are known for their understanding, and pleasant words are persuasive." Proverbs 16:21 (New Living Translation) Team OS/2 ** Reg. Linux User #211409 ** a11y rocks! Felix Miata *** http://fm.no-ip.com/ -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
Felix Miata <mrmazda@earthlink.net> írta:
Like most man pages, examples that would clarify meanings are absent. What does that last parameter mean exactly in the following example I found Googling?
mdadm --assemble /dev/md/alpha --name=alpha --update=name /dev/sd[fg]
This is not an openSUSE issue I guess. Not only the manual but the mdadm/mdraid wiki site (https://raid.wiki.kernel.org/index.php/RAID_setup) is puzzling too. They say there is a raid-howto but it is obsolete and the wiki pages are cecommended. The wiki site is very badly organized, definitely hard to use for a begginer to raid configuration and setup. Istvan -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
On Sat, 12 Apr 2014 19:17:00 +0200 (CEST) Istvan Gabor <suseuser04@freemail.hu> wrote:
This is not an openSUSE issue I guess. Not only the manual but the mdadm/mdraid wiki site (https://raid.wiki.kernel.org/index.php/RAID_setup) is puzzling too. They say there is a raid-howto but it is obsolete and the wiki pages are cecommended. The wiki site is very badly organized, definitely hard to use for a begginer to raid configuration and setup.
(rant redacted) Unfortunately, this is the universal status quo and is apparently perfectly acceptable. Else people be lighting fires under code authors to get the documentation done and done right. jd -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
On Sat, 12 Apr 2014 12:21:16 jdebert wrote:
On Sat, 12 Apr 2014 19:17:00 +0200 (CEST) Istvan Gabor <suseuser04@freemail.hu> wrote:
This is not an openSUSE issue I guess. Not only the manual but the mdadm/mdraid wiki site (https://raid.wiki.kernel.org/index.php/RAID_setup) is puzzling too. They say there is a raid-howto but it is obsolete and the wiki pages are cecommended. The wiki site is very badly organized, definitely hard to use for a begginer to raid configuration and setup.
(rant redacted)
Unfortunately, this is the universal status quo and is apparently perfectly acceptable. Else people be lighting fires under code authors to get the documentation done and done right.
jd
People who write the code don't need the documentation, and some seem to expect everyone else to be able to figure it out by reading the source code... -- ============================================================== Rodney Baker VK5ZTV rodney.baker@iinet.net.au ============================================================== -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
On Tue, 15 Apr 2014 08:28:32 +0930 Rodney Baker <rodney.baker@iinet.net.au> wrote:
On Sat, 12 Apr 2014 12:21:16 jdebert wrote:
Unfortunately, this is the universal status quo and is apparently perfectly acceptable. Else people be lighting fires under code authors to get the documentation done and done right.
People who write the code don't need the documentation, and some seem to expect everyone else to be able to figure it out by reading the source code...
People who write the code also need the documentation. People tend to forget. I can't count all the times I've heard someone, including gurus, complain about neglecting to document their own code when they've forgotten what it does. The standards of documentation are well-known and have existed for well over 30 years. Unfortunately the standards are being ignored. To paraphrase one of those gurus: "Without proper docs, the code is just a hack." jd -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
В Sat, 12 Apr 2014 02:19:21 -0400 Felix Miata <mrmazda@earthlink.net> пишет:
Like most man pages, examples that would clarify meanings are absent. What does that last parameter mean exactly in the following example I found Googling?
mdadm --assemble /dev/md/alpha --name=alpha --update=name /dev/sd[fg]
If under "last parameter" you mean /dev/sd[fg], it means names of devices from which array is being assembled. It is simply shell glob syntax.
I want to change the name of /dev/md1 from what it is now to something else. /dev/md1 is made from /dev/sda15 and /dev/sdb15 using v1.0 metadata. This is its detail:
/dev/md7: Version : 1.0 Creation Time : Sun Apr 15 16:41:25 2012 Raid Level : raid1 Array Size : 156280216 (149.04 GiB 160.03 GB) Used Dev Size : 156280216 (149.04 GiB 160.03 GB) Raid Devices : 2 Total Devices : 2 Persistence : Superblock is persistent
Intent Bitmap : Internal
Update Time : Sat Apr 12 00:34:16 2014 State : active Active Devices : 2 Working Devices : 2 Failed Devices : 0 Spare Devices : 0
Name : big31:7 (local to host big31) UUID : 922adc12:0bb3652b:d6259dfa:37406525 Events : 440
Number Major Minor RaidDevice State 0 8 15 0 active sync /dev/sda15 1 8 31 1 active sync /dev/sdb15
-- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
On 2014-04-12 21:57 (GMT+0400) Andrey Borzenkov composed:
÷ Sat, 12 Apr 2014 02:19:21 -0400 Felix Miata composed:
Like most man pages, examples that would clarify meanings are absent. What does that last parameter mean exactly in the following example I found Googling?
mdadm --assemble /dev/md/alpha --name=alpha --update=name /dev/sd[fg]
If under "last parameter" you mean /dev/sd[fg], it means names of devices from which array is being assembled. It is simply shell glob syntax.
You are right. That's what I don't understand, and the precise reason why I posted. As I understand it, the example means /dev/sdf and /dev/sdg. That doesn't help me, because I need it to be /dev/sda9 and /dev/sdb9 and have found nothing that explains how that would be done. -- "The wise are known for their understanding, and pleasant words are persuasive." Proverbs 16:21 (New Living Translation) Team OS/2 ** Reg. Linux User #211409 ** a11y rocks! Felix Miata *** http://fm.no-ip.com/ -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
Hello, On Sat, 12 Apr 2014, Felix Miata wrote:
On 2014-04-12 21:57 (GMT+0400) Andrey Borzenkov composed:
÷ Sat, 12 Apr 2014 02:19:21 -0400 Felix Miata composed:
Like most man pages, examples that would clarify meanings are absent. What does that last parameter mean exactly in the following example I found Googling?
mdadm --assemble /dev/md/alpha --name=alpha --update=name /dev/sd[fg]
If under "last parameter" you mean /dev/sd[fg], it means names of devices from which array is being assembled. It is simply shell glob syntax.
You are right. That's what I don't understand, and the precise reason why I posted. As I understand it, the example means /dev/sdf and /dev/sdg. That doesn't help me, because I need it to be /dev/sda9 and /dev/sdb9 and have found nothing that explains how that would be done.
RTFM of the shell you use! man -P'less +"/^ *Pattern Matching"' bash (and search once more by pressing the / key). For your convenience: mdadm --assemble /dev/md/alpha --name=alpha --update=name /dev/sd[ab]9 HTH, -dnh -- Give a man fire, and he will be warm for a day, set a man on fire, and he will be warm for the rest of his life. -- Terry Pratchett -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org
participants (7)
-
Andrey Borzenkov -
David Haller -
Felix Miata -
Istvan Gabor -
James Knott -
jdebert -
Rodney Baker