Skip to content

Latest commit

 

History

History
 
 

ipaddr

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
CMakeLists.txt
CMakeLists.txt
 
 
README.md
README.md
 
 
ipaddr.c
ipaddr.c
 
 
ipaddr.h
ipaddr.h
 
 
test_ipaddr.h
test_ipaddr.h
 
 
testmod_ipaddr.c
testmod_ipaddr.c
 
 

README.md

  • infos = Information about the ipaddr plugin is in keys below
  • infos/author = Thomas Waser thomas.waser@libelektra.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

# 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.