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.
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| directorymode | no | 00755 | Permissions for the share's root directory. |
|
| group | no | 0 | Directory owner group of the share's root directory. |
|
| host | no | None | Host FQDN (server which provides the share), e.g. {{ ansible_fqdn }}. Required if state=present. |
|
| name | yes | Name |
||
| nfs_custom_settings | no |
Option name in exports file. aliases: nfsCustomSettings
|
||
| nfs_hosts | no | Only allow access for this host, IP address or network. |
||
| ou | yes | Organisational unit, inside the LDAP Base DN. |
||
| owner | no | Directory owner of the share's root directory. |
||
| path | no | None | Directory on the providing server, e.g. /home. Required if state=present. |
|
| root_squash | no | 1 |
| Modify user ID for root user (root squashing). |
| samba_block_size | no | None |
Blocking size. aliases: sambaBlockSize
|
|
| samba_blocking_locks | no | 1 |
|
Blocking locks. aliases: sambaBlockingLocks
|
| samba_browseable | no | 1 |
|
Show in Windows network environment. aliases: sambaBrowseable
|
| samba_create_mode | no | 0744 |
File mode. aliases: sambaCreateMode
|
|
| samba_csc_policy | no | manual |
Client-side caching policy. aliases: sambaCscPolicy
|
|
| samba_custom_settings | no |
Option name in smb.conf and its value. aliases: sambaCustomSettings
|
||
| samba_directory_mode | no | 0755 |
Directory mode. aliases: sambaDirectoryMode
|
|
| samba_directory_security_mode | no | 0777 |
Directory security mode. aliases: sambaDirectorySecurityMode
|
|
| samba_dos_filemode | no | 0 |
|
Users with write access may modify permissions. aliases: sambaDosFilemode
|
| samba_fake_oplocks | no | 0 |
|
Fake oplocks. aliases: sambaFakeOplocks
|
| samba_force_create_mode | no | 0 |
|
Force file mode. aliases: sambaForceCreateMode
|
| samba_force_directory_mode | no | 0 |
|
Force directory mode. aliases: sambaForceDirectoryMode
|
| samba_force_directory_security_mode | no | 0 |
|
Force directory security mode. aliases: sambaForceDirectorySecurityMode
|
| samba_force_group | no | None |
Force group. aliases: sambaForceGroup
|
|
| samba_force_security_mode | no | 0 |
|
Force security mode. aliases: sambaForceSecurityMode
|
| samba_force_user | no | None |
Force user. aliases: sambaForceUser
|
|
| samba_hide_files | no | None |
Hide files. aliases: sambaHideFiles
|
|
| samba_hide_unreadable | no | 0 |
|
Hide unreadable files/directories. aliases: sambaHideUnreadable
|
| samba_hosts_allow | no |
Allowed host/network. aliases: sambaHostsAllow
|
||
| samba_hosts_deny | no |
Denied host/network. aliases: sambaHostsDeny
|
||
| samba_inherit_acls | no | 1 |
|
Inherit ACLs. aliases: sambaInheritAcls
|
| samba_inherit_owner | no | 0 |
|
Create files/directories with the owner of the parent directory. aliases: sambaInheritOwner
|
| samba_inherit_permissions | no | 0 |
|
Create files/directories with permissions of the parent directory. aliases: sambaInheritPermissions
|
| samba_invalid_users | no | None |
Invalid users or groups. aliases: sambaInvalidUsers
|
|
| samba_level_2_oplocks | no | 1 |
|
Level 2 oplocks. aliases: sambaLevel2Oplocks
|
| samba_locking | no | 1 |
|
Locking. aliases: sambaLocking
|
| samba_msdfs_root | no | 0 |
|
MSDFS root. aliases: sambaMSDFSRoot
|
| samba_name | no | None |
Windows name. Required if state=present.aliases: sambaName
|
|
| samba_nt_acl_support | no | 1 |
|
NT ACL support. aliases: sambaNtAclSupport
|
| samba_oplocks | no | 1 |
|
Oplocks. aliases: sambaOplocks
|
| samba_postexec | no | None |
Postexec script. aliases: sambaPostexec
|
|
| samba_preexec | no | None |
Preexec script. aliases: sambaPreexec
|
|
| samba_public | no | 0 |
|
Allow anonymous read-only access with a guest user. aliases: sambaPublic
|
| samba_security_mode | no | 0777 |
Security mode. aliases: sambaSecurityMode
|
|
| samba_strict_locking | no | Auto |
Strict locking. aliases: sambaStrictLocking
|
|
| samba_valid_users | no | None |
Valid users or groups. aliases: sambaValidUsers
|
|
| samba_vfs_objects | no | None |
VFS objects. aliases: sambaVFSObjects
|
|
| samba_write_list | no | None |
Restrict write access to these users/groups. aliases: sambaWriteList
|
|
| samba_writeable | no | 1 |
|
Samba write access. aliases: sambaWriteable
|
| state | no | present |
| Whether the share is present or not. |
| subtree_checking | no | 1 |
| Subtree checking. |
| sync | no | sync | NFS synchronisation. |
|
| writeable | no | 1 |
| NFS write access. |
# Create a share named home on the server ucs.example.com with the path /home.
- udm_share: name=home
path=/home
host=ucs.example.com
sambaName=Home
For more information on what this means please read Extras Modules
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.
© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/udm_share_module.html