Function tune

salt/modules/disk.py:324–390

Set attributes for the specified device CLI Example: .. code-block:: bash salt '*' disk.tune /dev/sda1 read-ahead=1024 read-write=True Valid options are: ``read-ahead``, ``filesystem-read-ahead``, ``read-only``, ``read-write``. For ``read-only`` and ``read-write

(device, **kwargs)

def tune(device, **kwargs):
    """
    Set attributes for the specified device

    CLI Example:

    .. code-block:: bash

        salt '*' disk.tune /dev/sda1 read-ahead=1024 read-write=True

    Valid options are: ``read-ahead``, ``filesystem-read-ahead``,
    ``read-only``, ``read-write``.

    For ``read-only`` and ``read-write``, the value must be set to ``True``.

    See the ``blockdev(8)`` manpage for a more complete description of these
    options.
    """

    kwarg_map = {
        "read-ahead": "setra",
        "filesystem-read-ahead": "setfra",
        "read-only": "setro",
        "read-write": "setrw",
    }
    opts = ""
    args = []
    invalid_kwargs = {}

    for key, value in kwargs.items():
        # Check for invalid kwargs but ignore dunder args
        if key not in kwarg_map and not key.startswith("__"):
            invalid_kwargs[key] = value
            continue

        # Check that read-only and read-write have a value of True
        # they do not accept other values
        if key in ("read-only", "read-write") and not (
            value == "True" or value is True
        ):
            invalid_kwargs[key] = value
            continue

        if key in kwarg_map:
            switch = kwarg_map[key]
            if key != "read-write":
                args.append(switch.replace("set", "get"))
            else:
                args.append("getro")
            if key in ("read-only", "read-write"):
                opts += f"--{switch} "
            else:
                opts += f"--{switch} {value} "

    # Raise error if any invalid kwargs were found
    if invalid_kwargs:
        invalid_kwargs_str = ", ".join(f"{k}={v}" for k, v in invalid_kwargs.items())
        raise SaltInvocationError(f"Invalid keyword arguments: {invalid_kwargs_str}")