Resolv

Parses /etc/resolv.conf

Author: Raphael Pinson rap.nosp@m.hink@gmai.nosp@m.l.com

Summary
ResolvParses /etc/resolv.conf
ReferenceThis lens tries to keep as close as possible to `man resolv.conf` where possible.
LicenceThis file is licensed under the LGPLv2+, like the rest of Augeas.
Lens Usage
Configuration filesThis lens applies to /etc/resolv.conf.
USEFUL PRIMITIVES
comment
empty
MAIN OPTIONS
netmaskA network mask for IP addresses
ipaddrAn IP address or range with an optional mask
nameserverA nameserver entry
domain
search
sortlist
SPECIAL OPTIONS
ip6_dotintip6-dotint option, which supports negation
optionsOptions values
entry
lns
filter

Reference

This lens tries to keep as close as possible to `man resolv.conf` where possible.

Licence

This file is licensed under the LGPLv2+, like the rest of Augeas.

Lens Usage

Configuration files

This lens applies to /etc/resolv.conf.  See filter.

USEFUL PRIMITIVES

comment

let comment = Util.comment_generic /[ \t]*[;#][ \t]*/ "# "

empty

let empty = Util.empty

MAIN OPTIONS

netmask

let netmask = [ label "netmask" . Util.del_str "/" . store Rx.ip ]

A network mask for IP addresses

ipaddr

let ipaddr = [label "ipaddr" . store Rx.ip . netmask?]

An IP address or range with an optional mask

nameserver

let nameserver = Build.key_value_line "nameserver" Sep.space (store Rx.ip)

A nameserver entry

domain

let domain = Build.key_value_line "domain" Sep.space (store Rx.word)

search

let search = Build.key_value_line "search" Sep.space (
   Build.opt_list [label "domain" . store Rx.word] Sep.space
)

sortlist

let sortlist = Build.key_value_line "sortlist" Sep.space (
   Build.opt_list ipaddr Sep.space
)

SPECIAL OPTIONS

ip6_dotint

let ip6_dotint = let negate = [ del "no-" "no-" . label "negate" ] in [ negate? . key "ip6-dotint" ]

ip6-dotint option, which supports negation

options

let options = let options_entry = Build.key_value (
   "ndots"|"timeout"|"attempts"
) (Util.del_str ":") (store Rx.integer) | Build.flag ("debug"|"rotate"|"no-check-names" |"inet6"|"ip6-bytestring"|"edns0") | ip6_dotint in Build.key_value_line "options" Sep.space (Build.opt_list options_entry Sep.space)

Options values

entry

let entry = nameserver | domain | search | sortlist | options

lns

let lns = (empty | comment entry)*

filter

let comment = Util.comment_generic /[ \t]*[;#][ \t]*/ "# "
let empty = Util.empty
let netmask = [ label "netmask" . Util.del_str "/" . store Rx.ip ]
A network mask for IP addresses
let ipaddr = [label "ipaddr" . store Rx.ip . netmask?]
An IP address or range with an optional mask
let nameserver = Build.key_value_line "nameserver" Sep.space (store Rx.ip)
A nameserver entry
let domain = Build.key_value_line "domain" Sep.space (store Rx.word)
let search = Build.key_value_line "search" Sep.space (
   Build.opt_list [label "domain" . store Rx.word] Sep.space
)
let sortlist = Build.key_value_line "sortlist" Sep.space (
   Build.opt_list ipaddr Sep.space
)
let ip6_dotint = let negate = [ del "no-" "no-" . label "negate" ] in [ negate? . key "ip6-dotint" ]
ip6-dotint option, which supports negation
let options = let options_entry = Build.key_value (
   "ndots"|"timeout"|"attempts"
) (Util.del_str ":") (store Rx.integer) | Build.flag ("debug"|"rotate"|"no-check-names" |"inet6"|"ip6-bytestring"|"edns0") | ip6_dotint in Build.key_value_line "options" Sep.space (Build.opt_list options_entry Sep.space)
Options values
let entry = nameserver | domain | search | sortlist | options
let lns = (empty | comment entry)*
Close