Elektra: Plugin: ipaddr

Elektra 0.8.24

Plugin: ipaddr

- infos = Information about the ipaddr plugin is in keys below
- infos/author = Thomas Waser thoma.nosp@m.s.wa.nosp@m.ser@l.nosp@m.ibel.nosp@m.ektra.nosp@m..org
- infos/licence = BSD
- infos/needs =
- infos/provides = check
- infos/recommends =
- infos/placements = presetstorage
- infos/status = maintained unittest nodep
- infos/metadata = check/ipaddr
- infos/description = Validation for IP addresses

# IP Address Validation

## Introduction

This plugin validates IP addresses using regular expressions.

## Usage

```<h1>Mount`ipaddr`plugin to cascading namespace`/tests/ipaddr` kdb mount config.dump /tests/ipaddr dump ipaddr

# Check the validity of the IP stored in `/tests/ipaddr/ipv4`

kdb setmeta /tests/ipaddr/ipv4 check/ipaddr ipv4

# Try to set an incorrect IP address

kdb set /tests/ipaddr/ipv4 127.0.0.1337

# STDERR: .*value of key is not a valid IP Address.*

# ERROR: 51

# RET: 5

# Set a correct IPv4 address

kdb set /tests/ipaddr/ipv4 127.0.0.1 kdb get /tests/ipaddr/ipv4 #> 127.0.0.1

# By default the plugin allows both IPv4 and IPv6 addresses

kdb setmeta /tests/ipaddr/address check/ipaddr ""

# Set correct IP addresses

kdb set /tests/ipaddr/address 1.2.3.4 kdb set /tests/ipaddr/address ::1

# Try to set incorrect addresses

kdb set /tests/ipaddr/address bad::ip

# RET: 5

kdb set /tests/ipaddr/address 1.2.-3.4

# RET: 5

# Undo modifications to the database

kdb rm -r /tests/ipaddr kdb umount /tests/ipaddr ```

## Limitations

The plugin only checks IP addresses for validity. It is not able to resolve hostnames. If you are looking for a plugin that supports hostnames, check out the network plugin.