xserver

Puppet module to manage the installation and configuration of the X.Org X Server

wilrnh

wilrnh

7,806 downloads

7,806 latest version

3.6 quality score

Version information

  • 0.1.0 (latest)
released May 16th 2015
This version is compatible with:
  • Ubuntu

Start using this module

Documentation

wilrnh/xserver — version 0.1.0 May 16th 2015

xserver

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 xserver
  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

Puppet module to manage the installation and configuration of Xorg's X Server.

Module Description

The X.Org project provides an open source implementation of the X Window System.

This module manages the installation and configuration of the Xorg X Window Server. This module does not manage the X Server service. See the wilrnh-xdm module for that.

Setup

What xserver affects

  • X Server package
  • X server configuration - xorg.conf

Beginning with xserver

To get started with the X server with default configurations, simply include the module in your manifest:

include ::xserver

This will install the Xorg X Server, and install an empty xorg.conf, which should make X use its defaults. To o setup a working xorg.conf, a a bunch of sections, eg.,:

xserver::section{'Layout0':
  section_name => 'ServerLayout'
  section_entries => [
    'Identifier "Layout0"', # section entry
    'Screen 0  "Screen0"',
    'InputDevice "Keyboard0" "CoreKeyboard"',
    'InputDevice "Keyboard0" "CoreKeyboard"',
    {'Display' => [ # subsection
      'Virtual 1280 1024',
      'Depth 24'
    ]}
  ]
}

Usage

Reference

Public Classes

xserver: Initializes X Server installation and configuration.

Defined types

xserver::section: Manages a single section in xorg.conf

Parameters

::xserver

package_ensure: Passed directly to the ensure attribute of the package type. Defaults to 'present'.

::xserver::section

section_name: The name of the xorg.conf section. See man xorg.conf(5) for valid values.

section_entries: Array of Section Entries to place within the section. 'Strings' are entered verbatim, and hash structures denote a subsection (see example above.)

Limitations

This module currenly only supports Ubuntu Trusty.

Development

Pull requests are always awesome.