community.general.udm_share – Manage samba shares on a univention corporate server
Note
This plugin is part of the community.general collection (version 3.8.3).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.udm_share
.
Synopsis
This module allows to manage samba shares on a univention corporate server (UCS). It uses the python API of the UCS to create a new object or edit it.
Requirements
The below requirements are needed on the host that executes this module.
Python >= 2.6
Parameters
Parameter |
Comments |
---|---|
Permissions for the share’s root directory. Default: “00755” |
|
Directory owner group of the share’s root directory. Default: “0” |
|
Host FQDN (server which provides the share), e.g. |
|
Name |
|
Only allow access for this host, IP address or network. Default: [] |
|
Option name in exports file. Default: [] |
|
Organisational unit, inside the LDAP Base DN. |
|
Directory owner of the share’s root directory. Default: “0” |
|
Directory on the providing server, e.g. |
|
Modify user ID for root user (root squashing). Choices:
|
|
Blocking locks. Choices:
|
|
Blocking size. |
|
Show in Windows network environment. Choices:
|
|
File mode. Default: “0744” |
|
Client-side caching policy. Default: “manual” |
|
Option name in smb.conf and its value. Default: [] |
|
Directory mode. Default: “0755” |
|
Directory security mode. Default: “0777” |
|
Users with write access may modify permissions. Choices:
|
|
Fake oplocks. Choices:
|
|
Force file mode. Choices:
|
|
Force directory mode. Choices:
|
|
Force directory security mode. Choices:
|
|
Force group. |
|
Force security mode. Choices:
|
|
Force user. |
|
Hide files. |
|
Hide unreadable files/directories. Choices:
|
|
Allowed host/network. Default: [] |
|
Denied host/network. Default: [] |
|
Inherit ACLs. Choices:
|
|
Create files/directories with the owner of the parent directory. Choices:
|
|
Create files/directories with permissions of the parent directory. Choices:
|
|
Invalid users or groups. |
|
Level 2 oplocks. Choices:
|
|
Locking. Choices:
|
|
MSDFS root. Choices:
|
|
Windows name. Required if |
|
NT ACL support. Choices:
|
|
Oplocks. Choices:
|
|
Postexec script. |
|
Preexec script. |
|
Allow anonymous read-only access with a guest user. Choices:
|
|
Security mode. Default: “0777” |
|
Strict locking. Default: “Auto” |
|
Valid users or groups. |
|
VFS objects. |
|
Samba write access. Choices:
|
|
Restrict write access to these users/groups. |
|
Whether the share is present or not. Choices:
|
|
Subtree checking. Choices:
|
|
NFS synchronisation. Default: “sync” |
|
NFS write access. Choices:
|