#resolv_conf

####Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with resolv_conf
   • What resolv_conf affects
   • Setup requirements
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

##Overview

The resolv_conf module configures /etc/resolv.conf on Linux based systems.

##Module Description

resolv_conf module will manage the configuration of the /etc/resolv.conf on Linux based systems

##Setup

###What resolv_conf affects

• If the contents of /etc/resolv.conf are being managed by Network Manager, it will get overwritten

###Setup Requirements

This module assumes that the network configuration is not being managed by Network Manager.

Requires Puppetlabs stdlib module

##Usage

Class: resolv_conf

class { 'resolv_conf':
  nameserver => '192.168.1.20',
  domain     => 'example.com',
}

Hiera

resolv_conf::nameserver: 192.168.1.20

##Reference

###Classes

####Public Classes

• resolv_conf: Main class

##Parameters:

    $nameserver
    IP address in dot notation of your name servers

    $domain
    Local domain

    $search
    Please refer to the resolv.conf(5) manual page

    $sortlist (optional)
    Optional parameter that defaults to your netmask

    $options (optional)
    Please refer to the resolv.conf(5) manual page

##Limitations

Tested on Debian and RedHat based Linux distributions.

##Development

This module follows the manual page provided on Linux systems. If adding any options, please consult the man page first.

##Release Notes/Contributors/Etc

Contributions from:

Thomas Linkin tom@puppetlabs.com