-1. Copyright
    =========

  Copyright: (C) 2016 by Thomas Bruecker

  This program / these concepts are free software; you can redistribute it
  and/or modify it (if applicable) under the terms of the GNU   L E S S E R
  General Public License as published by the Free Software Foundation; either
  version 2 of the License, or (at your option) any later version.

  This program / these concepts are distributed in the hope that they will be
  useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  L E S S E R   General Public License for more details.

  You should have received a copy of the GNU   L E S S E R   General Public
  License along with this program; if not, write to the Free Software
  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


Brainstorming
=============

0. Introduction; 'Pseudo Raid'
   ---------------------------

* Consider a container media with one sub-media (the sub-media is the pseudo
  raid).
* Starting from "SIZE", split the container media in equally sized components;
  * size of each of these components: <ComponentSize>,
  * number of these components:       <numComponents>.
* Assemble a raid system from these components; the components will be the
  active raid disks;
  * raid level of this raid system:                 <LEVEL>,
  * raid algorithm (or layout) of this raid system: <ALGORITHM>,
  * chunk size of this raid system:                 <ChunkSize>.
    !!! important; in contradiction to the 'standard', the chunk size is
        expressed in bytes and not in 512-byte-sectors !!!
* The assembled raid system is now the realized sub-media.


1. Parameters
   ----------

* mandatory:
  <all global mandatory parameters>
  ALGORITHM
  ChunkSize:            !!! In bytes; not in 512-byte-sectors !!!
  ComponentSize
  KERNEL:               Must contain a string, that specifies the name and
                        version of an official os-kernel, that is able to
                        assemble the raid system described by the media info,
                        so that the data on it may be read and written
                        absolutely error-free and complete. It is recommended
                        to provide here an URL to the repository of the kernel.
  LEVEL:                ... -1: the array is completely specified by its UUID;
                        no other parameters are necessary ?
  numActiveComponents:
  RealizationMode:      * "dm": the raid is realized by linux 'dm-drivers',
                        * "md": the raid is realized by linux 'md-drivers'.
  START
  SIZE:                 Is not specified, it may be calculated by
                                           "<ComponentSize> * <numComponents>".

* optional:
  <all global optional parameters>
  RealizationOptions: takes also "readahead"
  RealizationPoint ev. <-- "global optional"

* optinal and ignored:
  <all global optional and ignored parameters>