NAME

lcfg-resolvconf - An LCFG component to manage the resolv.conf file

VERSION

This documentation refers to lcfg-resolvconf version 0.100.3

DESCRIPTION

An LCFG component to manage the resolv.conf file

RESOURCES

For a complete discussion of all the options see resolv.conf(3)

nameservers

The list of IP addresses for nameservers, you can have as many as you like in here but normally only the first 3 will be used by the resolver.

domain

Lookups for hosts within this domain can use short names. This defaults to the value of the profile.domain resource. If unset the resolver works it out from the local host name. Note that the domain and search keywords are mutually exclusive, if you define both only the search field will be added to the configuration file.

The list of domains to search for the hostname. This can be up to 6 domains with a total of 256 characters. By default it is the value of the profile.domain resource. If unset the local domain name is used. Note that the domain and search keywords are mutually exclusive, if you define both only the search field will be added to the configuration file.

sortlist

This can be used to instruct the resolver on how to sort the addresses returned. There is no default value.

randomize

Not all resolvers support the rotate option. This is a boolean value which signifies whether the component should randomize the server list before putting it into the configuration file. The default is false.

options

This is a list of options which will be put into configuration file. By default it is all the options listed below:

debug

A boolean value, default false.

ndots

An integer, default 1. This sets a threshold for the number of dots which must appear in a name given

timeout

An integer, default 5. This sets the amount of time the resolver will wait for a response from a remote name server before retrying the query via a different name server. Measured in seconds.

attempts

An integer, default 2. This sets the number of times the resolver will send a query to its name servers before giving up and returning an error to the calling application.

rotate

A boolean, default false. Setting this to true causes round robin selection of nameservers from among those listed.

no_check_names

A boolean, default false. Setting this to true disables the modern BIND checking of incoming hostnames and mail names for invalid characters such as underscore

inet6

A boolean, default false. Setting this to true has the effect of trying a AAAA query before an A query inside the gethostbyname(3) function, and of mapping IPv4 responses in IPv6 "tunneled form" if no AAAA records are found but an A record set exists.

configfile

The file to be configured, this defaults to /etc/resolv.conf. You probably do not need to change this resource.

template

This is the template file to be used, it defaults to /var/lcfg/conf/resolvconf/template. You probably do not need to change this resource.

SEE ALSO

resolv.conf(3), gethostbyname(3)

PLATFORMS

This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.

Fedora13, ScientificLinux5, ScientificLinux6

BUGS AND LIMITATIONS

Please report any problems (or praise!) to bugs@lcfg.org, feedback and patches are also always very welcome.

AUTHOR

Stephen Quinney <squinney@inf.ed.ac.uk>

LICENSE AND COPYRIGHT

Copyright (C) 2008-2010 University of Edinburgh. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.