infos = Information about HOSTS plugin is in keys below
infos/author = Markus Raab elekt.nosp@m.ra@l.nosp@m.ibele.nosp@m.ktra.nosp@m..org
infos/licence = BSD
infos/provides = storage
infos/needs =
infos/recommends = glob network
infos/placements = getstorage setstorage
infos/status = maintained unittest nodep libc
infos/description = This plugin reads and writes /etc/hosts files.

The /etc/hosts file is a simple text file that associates IP addresses with hostnames, one line per IP address. The format is described in hosts(5).

Special values

Canonical hostnames are stored as key names with the IP address as key value.

Aliases are stored as sub keys with a read only duplicate of the associated ip address as value.

Comments are stored according to the comment metadata specification (see doc/METADATA.ini for more information)

Since line breaks are preserved, you can identify multi line comments by their trailing line break.

Restrictions

The ordering of the hosts is stored in meta keys of type "order". The value is an ascending number. Ordering of aliases is NOT preserved.

Mount the plugin:

$ kdb mount --with-recommends /etc/hosts system/hosts hosts

Print out all known hosts and their aliases:

$ kdb ls system/hosts

Get IP address of ipv4 host "localhost":

$ kdb get system/hosts/ipv4/localhost

Check if a comment is belonging to host "localhost":

$ kdb lsmeta system/hosts/ipv4/localhost

Try to change the host "localhost", should fail because it is not an ipv4 adress:

$ kdb set system/hosts/ipv4/localhost ::1