{"id":18492697,"url":"https://github.com/voxpupuli/puppet-kmod","last_synced_at":"2025-11-23T09:01:32.144Z","repository":{"id":2927411,"uuid":"3938525","full_name":"voxpupuli/puppet-kmod","owner":"voxpupuli","description":"manage kernel module with puppet","archived":false,"fork":false,"pushed_at":"2024-09-17T00:34:57.000Z","size":273,"stargazers_count":17,"open_issues_count":5,"forks_count":63,"subscribers_count":48,"default_branch":"master","last_synced_at":"2024-10-29T14:22:37.246Z","etag":null,"topics":["archlinux-puppet-module","centos-puppet-module","debian-puppet-module","hacktoberfest","linux-puppet-module","oraclelinux-puppet-module","puppet","redhat-puppet-module","sles-puppet-module","ubuntu-puppet-module"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voxpupuli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"vox-pupuli","github":"voxpupuli"}},"created_at":"2012-04-05T10:21:39.000Z","updated_at":"2024-09-17T00:35:00.000Z","dependencies_parsed_at":"2024-04-15T07:12:41.698Z","dependency_job_id":"bb23ccb2-87d8-4b03-8d08-ee967e62acc9","html_url":"https://github.com/voxpupuli/puppet-kmod","commit_stats":{"total_commits":247,"total_committers":30,"mean_commits":8.233333333333333,"dds":0.6761133603238867,"last_synced_commit":"3e741b5b826a3b9a56f81095b9f6361cfb8ff63e"},"previous_names":["camptocamp/puppet-kmod"],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-kmod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-kmod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-kmod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-kmod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voxpupuli","download_url":"https://codeload.github.com/voxpupuli/puppet-kmod/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247378134,"owners_count":20929296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archlinux-puppet-module","centos-puppet-module","debian-puppet-module","hacktoberfest","linux-puppet-module","oraclelinux-puppet-module","puppet","redhat-puppet-module","sles-puppet-module","ubuntu-puppet-module"],"created_at":"2024-11-06T13:10:23.486Z","updated_at":"2025-11-23T09:01:32.057Z","avatar_url":"https://github.com/voxpupuli.png","language":"Ruby","funding_links":["https://opencollective.com/vox-pupuli","https://github.com/sponsors/voxpupuli"],"categories":[],"sub_categories":[],"readme":"# Kmod Puppet module\n\n[![Build Status](https://github.com/voxpupuli/puppet-kmod/workflows/CI/badge.svg)](https://github.com/voxpupuli/puppet-kmod/actions?query=workflow%3ACI)\n[![Release](https://github.com/voxpupuli/puppet-kmod/actions/workflows/release.yml/badge.svg)](https://github.com/voxpupuli/puppet-kmod/actions/workflows/release.yml)\n[![Puppet Forge](https://img.shields.io/puppetforge/v/puppet/kmod.svg)](https://forge.puppetlabs.com/puppet/kmod)\n[![Puppet Forge - downloads](https://img.shields.io/puppetforge/dt/puppet/kmod.svg)](https://forge.puppetlabs.com/puppet/kmod)\n[![Puppet Forge - endorsement](https://img.shields.io/puppetforge/e/puppet/kmod.svg)](https://forge.puppetlabs.com/puppet/kmod)\n[![Puppet Forge - scores](https://img.shields.io/puppetforge/f/puppet/kmod.svg)](https://forge.puppetlabs.com/puppet/kmod)\n[![puppetmodule.info docs](http://www.puppetmodule.info/images/badge.png)](http://www.puppetmodule.info/m/puppet-kmod)\n[![Apache 2 License](https://img.shields.io/github/license/voxpupuli/puppet-kmod.svg)](LICENSE)\n[![Donated by Camptocamp](https://img.shields.io/badge/donated%20by-camptocamp-fb7047.svg)](#transfer-notice)\n\n## Description\n\nThis module provides definitions to manipulate modprobe.conf (5) stanzas:\n\n * kmod::alias\n * kmod::install\n * kmod::blacklist\n\nIt depends on Augeas with the modprobe lens.\n\n## Usage\n\nThis module has five main defined types:\n\n  * kmod::load\n  * kmod::alias\n  * kmod::option\n  * kmod::install\n  * kmod::blacklist\n\n\n### kmod::load\n\nLoads a module using modprobe and manages persistent modules in /etc/sysconfig/modules\n\n```puppet\n  kmod::load { 'mymodule': }\n```\n\n### kmod::alias\n\nAdds an alias to modprobe.conf, by default `/etc/modprobe.d/\u003cname\u003e.conf` is assumed for a filename.\n\n```puppet\n  kmod::alias { 'bond0':\n    source =\u003e 'bonding',\n  }\n```\n\nParams:\n* `source`: Name of the module to alias\n* `aliasname`: Name of the alias (defaults to the resource title)\n* `file`: File to write to (see above default)\n\n### kmod::option\n\nAdds an option to modprobe.conf\n\n```puppet\n  kmod::option { 'bond0 mode':\n    module  =\u003e 'bond0',\n    option  =\u003e 'mode',\n    value   =\u003e '1',\n  }\n\n  kmod::option { 'bond0':\n    option =\u003e 'mode',\n    value  =\u003e '1',\n  }\n```\n\nParams:\n* `option`: Name of the parameter to add\n* `value`: Value of the parameter\n* `module`: Name of the module (if ommited, the resource title is used)\n* `file`: File to write to (defaults to `/etc/modprobe.d/\u003cmodule name\u003e.conf`)\n\n### kmod::blacklist\n\nManages modprobe blacklist entries. Blacklist entries prevents module aliases from being used,\nbut would not prevent the module from being loaded.\nTo prevent a module from being loaded use `kmod::install`\n\n```puppet\n  kmod::blacklist { 'foo': }\n```\n\nParams:\n* `file`: File to write to, defaults to `/etc/modprobe.d/blacklist.conf`\n\n### kmod::install\n\nManage modprobe install entries\n\n```puppet\n   kmod::install { 'pcspkr': }\n```\n\nIf you want to ensure that module can't be loaded at all you can do the following:\n```puppet\n   kmod::install { 'dccp': command =\u003e '/bin/false' }\n```\n\nParams:\n* `file`: File to write to (defaults to `/etc/modprobe.d/\u003cmodule name\u003e.conf`)\n* `command`: (optional) command associated with the install, defaults to `/bin/true`\n\n## Using the module with hiera\nThe module makes available lists for every defined type that will create those\ndefined types if defined as class parameters. The parameters are:\n* kmod::list_of_blacklists:\n* kmod::list_of_aliases:\n* kmod::list_of_installs:\n* kmod::list_of_loads:\n* kmod::list_of_options:\n\nExample usage:\n```\n---\nkmod::list_of_blacklists:\n  'foo01': {}\n  'foo02': {}\n  'foo03': {}\nkmod::list_of_aliases:\n  'foo01':\n    source: 'squashfs'\n    aliasname: 'squash01'\n  'foo02':\n    source: 'squashfs'\n    aliasname: 'squash02'\nkmod::list_of_installs:\n  'dccp':\n    command: '/bin/false'\n  'blah':\n    command: '/bin/true'\nkmod::list_of_loads:\n  'cramfs': {}\n  'vfat': {}\nkmod::list_of_options:\n  'bond0 mode':\n    module: 'bond0'\n    option: 'mode'\n    value: '1'\n  'bond0':\n    option: 'mode'\n    value: '1'\n```\n\n## Contributing\n\nPlease report bugs and feature request using [GitHub issue\ntracker](https://github.com/camptocamp/puppet-kmod/issues).\n\nFor pull requests, it is very much appreciated to check your Puppet manifest\nwith [puppet-lint](https://github.com/camptocamp/puppet-kmod/issues) to follow the recommended Puppet style guidelines from the\n[Puppet Labs style guide](http://docs.puppetlabs.com/guides/style_guide.html).\n\n\n## Transfer Notice\n\nThis plugin was originally authored by [Camptocamp](http://www.camptocamp.com).\nThe maintainer preferred that Puppet Community take ownership of the module for future improvement and maintenance.\nExisting pull requests and issues were transferred over, please fork and continue to contribute here instead of Camptocamp.\n\nPreviously: https://github.com/camptocamp/puppet-kmod\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-kmod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxpupuli%2Fpuppet-kmod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-kmod/lists"}