Provided by: elektra-doc_0.8.14-5_all bug

NAME

       md_src_plugins_fstab_README - README

       • infos = Information about FSTAB plugin is in keys below

       • infos/author = Markus Raab elektra@libelektra.org

       • infos/licence = BSD

       • infos/needs =

       • infos/provides = storage

       • infos/placements = getstorage setstorage

       • infos/recommends = struct type path

       • infos/description = Parses files in a syntax like /etc/fstab file

       This plugin is an implementation of a parser and generator of the /etc/fstab file.

   old fstab Entries
       (Deprecated, remove this section after it is reimplemented in the new way)

       For each device in fstab elektra will store the following keys: pseudoname/device pseudoname/mpoint
       pseudoname/type pseudoname/options pseudoname/dumpfreq pseudoname/passno

       Each represents a column in fstab.

       The pseudoname can be any name for setting keys, the will be generated when getting keys, so don't expect
       the same name.

       the directory / will be called rootfs

       all swap devices will be called swapXX with a number from 00 on for XX

       otherwise the mountpoint without the '/' character will be used.

       At the other point there is the issue with the pseudonames, you can't rely on the pseudoname you have
       set.

       The biggest issue is that you can't change or delete existing entries. All entries you set will be
       appended to the other filesystems.

       So if you get the filesystems and change the type of the filesystem of the rootfs and set it again the
       resulting fstab will be like: /dev/sda6 / ext3>---- >----defaults,errors=remount-ro 0 1 /dev/sda6 /
       jfs>---- >----defaults,errors=remount-ro 0 1

       which will be not like you desired!

       setmntent is used, so it is only conforming to BSD 4.3 and linux and you can't use any comments.

   new fstab Entries
       Specification:

       [/_]
       type = array
       explanation = the name of the key is the mountpoint (so the former
         mpoint is not needed); the value is the number of entries in the
         array
       [/_/#]
       explanation = an entry in the array
       [/_/#/device]
       [/_/#/type]
       [/_/#/options]
       [/_/#/dumpfreq]
       [/_/#/passno]

       Example: A fstab that looks like:

       /dev/sr0        /media/cdrom   udf,iso9660 user,noauto     0       0

       would have a key name that is an array (so the value is the number of children, in this case 1):

       system/filesystems/mediacdrom

       with the array entry:

       system/filesystems/mediacdrom0/#0/

       So when following line is added

       /dev/sr0        /media/cdrom   ramfs user,noauto     0       0

       Implementation hint: use keyAddBaseName() to get escaping of /, then add array items below it

       If a mount point exists more than once (that could be proc, swap or overlay mountpoints) the array below
       gets incremented (otherwise #0 is used for every unique entry).

       The order of the array must, of course, be preserved. Other lines may be reordered for now, a proper
       'order' could be done later.

       Spaces in the names are replaced by \040 in the fstab.

   Example
       Mount the plugin:

           kdb mount /etc/fstab system/filesystems fstab struct type path

   Note
       The status of this plugin is experimental.