dkms

Manage DKMS Kernel modules.

Table of Contents

1. Description
2. Setup - The basics of getting started with dkms
   • Setup requirements
   • Beginning with dkms
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module

Description

Install and manage DKMS, along with any kernel modules.

Setup

Setup Requirements

If you wish to use the dkms::kernel_module defined type, you must first put your source in /usr/src/<kmod-name>-<kmod-version>/.

Beginning with dkms

Modern linux distros have hooks for DKMS to automatically build a module when a new kernel is installed. Odds are for most users all you need is:

include dkms

Usage

There is a parameter provided to easily create any kmod entries you need:

class { 'dkms':
  kernel_modules => {
    'kmod_name' => {
      'kmod_version' => 'ver string',
      'ensure' => 'installed',
      'on_kernel' => 'ALL',
    }
  }
}

Review the documentation on the dkms::kernel_module defined type for more information.

Limitations

If you wish to use the dkms::kernel_module defined type, you must first put your source in /usr/src/<kmod-name>-<kmod-version>/.

The dkms::kernel_module defined type does not support tar or alternate source modes for adding modules.

Development

See the repo defined in metadata.json.