Модуль community.general.kdeconfig — управление файлами конфигурации KDE

attributes

псевдонимы: attr

string

Атрибуты, которыми должен обладать результирующий объект файловой системы.

Список поддерживаемых флагов см. на странице руководства chattr целевой системы.

Эта строка должна содержать атрибуты в том же порядке, в каком они отображаются командой lsattr.

По умолчанию предполагается оператор =; в противном случае в строку необходимо включить операторы + или -.

backup

boolean

Создать файл резервной копии.

Варианты:

• false ← (по умолчанию)
• true

group

string

Имя группы, которой должен принадлежать объект файловой системы; значение передаётся команде chown.

Если параметр не указан, используется текущая группа текущего пользователя; если вы работаете от имени root, может быть сохранён прежний владелец.

kwriteconfig_path

path

Путь к исполняемому файлу kwriteconfig. Если параметр не указан, Ansible попытается найти его автоматически.

mode

any

Права доступа, которыми должен обладать результирующий объект файловой системы.

Если вы привыкли к /usr/bin/chmod, помните, что режимы доступа на самом деле являются восьмеричными числами. Ansible необходимо передать достаточно информации, чтобы он мог правильно их интерпретировать. Для единообразия заключайте восьмеричные числа в кавычки (например, '644' или '1777'), чтобы Ansible получил строку и преобразовал её в число самостоятельно. Добавление ведущего нуля (например, 0755) иногда работает, но может привести к ошибкам в циклах и некоторых других ситуациях.

Если передать Ansible число, не соблюдая ни одно из этих правил, оно будет интерпретировано как десятичное, что приведёт к неожиданным результатам.

Начиная с Ansible 1.8, режим можно задавать в символьном виде (например, u+rwx или u=rw,g=r,o=r).

Если mode не указан и целевой объект файловой системы не существует, при установке режима для нового объекта будет использоваться значение umask, заданное в системе по умолчанию.

Если mode не указан и целевой объект файловой системы существует, будет использован режим доступа существующего объекта.

Указание mode — лучший способ гарантировать, что объекты файловой системы будут созданы с правильными правами доступа. Дополнительные сведения см. в CVE-2020-1736.

owner

string

Имя пользователя, которому должен принадлежать объект файловой системы; значение передаётся команде chown.

Если параметр не указан, используется текущий пользователь; если вы работаете от имени root, может быть сохранён прежний владелец.

Числовое имя пользователя будет интерпретировано как идентификатор пользователя, а не как имя. Во избежание такой неоднозначности не используйте числовые имена пользователей.

path

path / обязательный

Путь к файлу конфигурации. Если файл не существует, он будет создан.

selevel

string

Часть уровня контекста объекта файловой системы SELinux.

Это атрибут MLS/MCS, также известный как range.

Если задано значение _default, будет использоваться часть политики level, если она доступна.

serole

string

Часть роли контекста объекта файловой системы SELinux.

Если задано значение _default, будет использоваться часть политики role, если она доступна.

setype

string

Часть типа контекста объекта файловой системы SELinux.

Если задано значение _default, будет использоваться часть политики type, если она доступна.

seuser

string

Часть пользователя контекста объекта файловой системы SELinux.

По умолчанию используется политика system, если применимо.

Если задано значение _default, будет использоваться часть политики user, если она доступна.

unsafe_writes

boolean

Определяет, когда использовать атомарную операцию для предотвращения повреждения данных или несогласованного чтения целевого объекта файловой системы.

По умолчанию этот модуль использует атомарные операции для предотвращения повреждения данных или несогласованного чтения целевых объектов файловой системы, однако иногда конфигурация систем или их неисправности не позволяют этого сделать. Например, смонтированные в Docker объекты файловой системы нельзя атомарно обновить из контейнера — их можно записывать только небезопасным способом.

Этот параметр позволяет Ansible использовать небезопасные методы обновления объектов файловой системы, если атомарные операции завершаются с ошибкой (однако он не заставляет Ansible выполнять небезопасную запись).

ВАЖНО! Небезопасная запись подвержена гонкам и может привести к повреждению данных.

Варианты:

• false ← (по умолчанию)
• true

values

list / элементы=dictionary / обязательный

Список значений для установки.

bool_value

boolean

Логическое значение.

Необходимо указать либо этот параметр, либо values[].value.

Варианты:

• false
• true

group

string

Группа параметра. Необходимо указать либо этот параметр, либо values[].groups.

groups

list / элементы=string

Список групп параметра. Необходимо указать либо этот параметр, либо values[].group.

key

string / обязательный

Имя параметра.

value

string

Значение параметра. Необходимо указать либо этот параметр, либо values[].bool_value.

check_mode

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз изменения состояния, не изменяя целевой объект.

diff_mode

Поддержка: полная

В режиме сравнения возвращает сведения об изменениях (или о том, что, возможно, необходимо изменить в check_mode).