1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with xserver
   • What xserver affects
   • Setup requirements
   • Beginning 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

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

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.

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

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'
    ]}
  ]
}

xserver: Initializes X Server installation and configuration.

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

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

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

This module currenly only supports Ubuntu Trusty.

Pull requests are always awesome.