https://github.com/bodgit/puppet-rngd

Puppet Module for managing rngd
https://github.com/bodgit/puppet-rngd

puppet rngd

Last synced: 28 days ago
JSON representation

Puppet Module for managing rngd

• Host: GitHub
• URL: https://github.com/bodgit/puppet-rngd
• Owner: bodgit
• License: apache-2.0
• Created: 2014-12-05T14:06:24.000Z (about 10 years ago)
• Default Branch: main
• Last Pushed: 2021-03-06T23:17:44.000Z (almost 4 years ago)
• Last Synced: 2024-05-15T09:53:52.223Z (8 months ago)
• Topics: puppet, rngd
• Language: Ruby
• Homepage: https://forge.puppetlabs.com/bodgit/rngd
• Size: 139 KB
• Stars: 0
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# rngd

[![Build Status](https://travis-ci.org/bodgit/puppet-rngd.svg?branch=master)](https://travis-ci.org/bodgit/puppet-rngd)

[![Codecov](https://img.shields.io/codecov/c/github/bodgit/puppet-rngd)](https://codecov.io/gh/bodgit/puppet-rngd)

[![Puppet Forge version](http://img.shields.io/puppetforge/v/bodgit/rngd)](https://forge.puppetlabs.com/bodgit/rngd)

[![Puppet Forge downloads](https://img.shields.io/puppetforge/dt/bodgit/rngd)](https://forge.puppetlabs.com/bodgit/rngd)

[![Puppet Forge - PDK version](https://img.shields.io/puppetforge/pdk-version/bodgit/rngd)](https://forge.puppetlabs.com/bodgit/rngd)

#### Table of Contents

1. [Description](#description)

2. [Setup - The basics of getting started with rngd](#setup)

    * [Beginning with rngd](#beginning-with-rngd)

3. [Usage - Configuration options and additional functionality](#usage)

4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)

5. [Limitations - OS compatibility, etc.](#limitations)

6. [Development - Guide for contributing to the module](#development)

## Description

This module manages rngd.

The module basically makes sure the rngd daemon is installed and started,

that's pretty much it. The rngd daemon does a good job at working out where

the source of hardware entropy is so there's little configuration required.

## Setup

### Beginning with rngd

In the very simplest case, you can just include the following:

```puppet

include ::rngd

```

## Usage

For example to configure rngd to use `/dev/urandom` for random number input:

```puppet

class { '::rngd':

  hwrng_device => '/dev/urandom',

}

```

If you want to use something else to manage the rngd daemon, you can do:

```puppet

class { '::rngd':

  service_manage => false,

}

```

## Reference

The reference documentation is generated with

[puppet-strings](https://github.com/puppetlabs/puppet-strings) and the latest

version of the documentation is hosted at

[https://bodgit.github.io/puppet-rngd/](https://bodgit.github.io/puppet-rngd/)

and available also in the [REFERENCE.md](https://github.com/bodgit/puppet-rngd/blob/master/REFERENCE.md).

## Limitations

This module has been built on and tested against Puppet 5 and higher.

The module has been tested on:

* RedHat Enterprise Linux 6/7

* Ubuntu 14.04/16.04

* Debian 8/9

## Development

The module relies on [PDK](https://puppet.com/docs/pdk/1.x/pdk.html) and has

both [rspec-puppet](http://rspec-puppet.com) and

[beaker-rspec](https://github.com/puppetlabs/beaker-rspec) tests. Run them

with:

```

$ bundle exec rake spec

$ PUPPET_INSTALL_TYPE=agent PUPPET_INSTALL_VERSION=x.y.z bundle exec rake beaker:

```

Please log issues or pull requests at

[github](https://github.com/bodgit/puppet-rngd).