diff options
author | Stonewall Jackson <stonewall@sacredheartsc.com> | 2023-02-20 21:55:13 -0500 |
---|---|---|
committer | Stonewall Jackson <stonewall@sacredheartsc.com> | 2023-02-20 21:55:13 -0500 |
commit | 90e5c57d654924dcf64b106e68145e2995cc9914 (patch) | |
tree | 2c4315f9d07957fe024415e3680cd216fbc6308e /roles/udev | |
parent | 02379f37151ff9a86bbe6e781c6854d2c8b02f35 (diff) | |
download | selfhosted-90e5c57d654924dcf64b106e68145e2995cc9914.tar.gz selfhosted-90e5c57d654924dcf64b106e68145e2995cc9914.zip |
udev: add docs
Diffstat (limited to 'roles/udev')
-rw-r--r-- | roles/udev/README.md | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/roles/udev/README.md b/roles/udev/README.md new file mode 100644 index 0000000..854f147 --- /dev/null +++ b/roles/udev/README.md @@ -0,0 +1,44 @@ +udev +===== + +Description +----------- + +The `udev` role configures specified udev rules and generates a powersave +blacklist based on vendor and device IDs. + + +Variables +--------- + +This role **accepts** the following variables: + +Variable | Default | Description +-------------------------------|---------|------------ +`udev_rules` | `[]` | List of udev rules (see [format](#udev_rules) below) +`udev_pci_powersave_blacklist` | `[]` | List of PCI devices with powersaving disabled (`vendorid:productid`) + +### udev\_rules + +The `udev_rules` variable is used to add udev rulesets. It should contain a +list of dictionaries of the following format: + +Key | Default | Description +-------|-----------|------------ +`name` | | Name of rule under `/etc/udev/rules.d` +`rule` | | Rule content + +Usage +----- + +Example playbook: + +````yaml +- name: disable powersaving for NIC + hosts: linux_desktops + roles: + - role: udev + vars: + udev_pci_powersave_blacklist: + - 8086:43e0 +```` |