| Dir : /proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/ |
| Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 IP: 209.182.202.254 |
| Dir : //proc/self/root/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/sysfs.py |
"""
Configuration of the kernel using sysfs
=======================================
Control the kernel object attributes exported by sysfs
.. code-block:: yaml
kernel/mm/transparent_hugepage/enabled
sysfs.present:
- value: never
.. versionadded:: 3006.0
"""
import re
def __virtual__():
"""
This state is only available on Minions which support sysctl
"""
if "sysfs.attr" in __salt__:
return True
return (False, "sysfs module could not be loaded")
def present(name, value, config=None):
"""
Ensure that the named sysfs attribute is set with the defined value
name
The name of the sysfs attribute to edit
value
The sysfs value to apply
"""
ret = {"name": name, "result": True, "changes": {}, "comment": ""}
current = __salt__["sysfs.read"](name)
if current is False:
ret["result"] = False
ret["comment"] = f"SysFS attribute {name} doesn't exist."
else:
# if the return is a dict, the "name" is an object not an attribute
if isinstance(current, dict):
ret["result"] = False
ret["comment"] = f"{name} is not a SysFS attribute."
else:
# some attribute files lists all available options and the selected one between []
if isinstance(current, str):
current = re.sub(r"(.*\[|\].*)", "", current)
if value == current:
ret["result"] = True
ret["comment"] = f"SysFS attribute {name} is already set."
else:
ret["result"] = None
if ret["result"] is None:
if __opts__["test"]:
ret["comment"] = f"SysFS attribute {name} set to be changed."
else:
update = __salt__["sysfs.write"](name, value)
if not update:
ret["result"] = False
ret["comment"] = f"Failed to set {name} to {value}"
else:
ret["result"] = True
ret["changes"] = {name: value}
ret["comment"] = f"Updated SysFS attribute {name} to {value}"
return ret