Vh#FlddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z mZmZdZedk(rey y ) )absolute_importdivisionprint_functionu module: udm_share author: - Tobias Rüetschi (@keachi) short_description: Manage samba shares on a univention corporate server description: - 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. extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: partial options: state: default: "present" choices: [present, absent] description: - Whether the share is present or not. type: str name: required: true description: - Name. type: str host: required: false description: - Host FQDN (server which provides the share), for example V({{ ansible_fqdn }}). Required if O(state=present). type: str path: required: false description: - Directory on the providing server, for example V(/home). Required if O(state=present). type: path sambaName: required: false description: - Windows name. Required if O(state=present). type: str aliases: [samba_name] ou: required: true description: - Organisational unit, inside the LDAP Base DN. type: str owner: default: '0' description: - Directory owner of the share's root directory. type: str group: default: '0' description: - Directory owner group of the share's root directory. type: str directorymode: default: '00755' description: - Permissions for the share's root directory. type: str root_squash: default: true description: - Modify user ID for root user (root squashing). type: bool subtree_checking: default: true description: - Subtree checking. type: bool sync: default: 'sync' description: - NFS synchronisation. type: str writeable: default: true description: - NFS write access. type: bool sambaBlockSize: description: - Blocking size. type: str aliases: [samba_block_size] sambaBlockingLocks: default: true description: - Blocking locks. type: bool aliases: [samba_blocking_locks] sambaBrowseable: description: - Show in Windows network environment. type: bool default: true aliases: [samba_browsable] sambaCreateMode: default: '0744' description: - File mode. type: str aliases: [samba_create_mode] sambaCscPolicy: default: 'manual' description: - Client-side caching policy. type: str aliases: [samba_csc_policy] sambaCustomSettings: default: [] description: - Option name in C(smb.conf) and its value. type: list elements: dict aliases: [samba_custom_settings] sambaDirectoryMode: default: '0755' description: - Directory mode. type: str aliases: [samba_directory_mode] sambaDirectorySecurityMode: default: '0777' description: - Directory security mode. type: str aliases: [samba_directory_security_mode] sambaDosFilemode: default: false description: - Users with write access may modify permissions. type: bool aliases: [samba_dos_filemode] sambaFakeOplocks: default: false description: - Fake oplocks. type: bool aliases: [samba_fake_oplocks] sambaForceCreateMode: default: false description: - Force file mode. type: bool aliases: [samba_force_create_mode] sambaForceDirectoryMode: default: false description: - Force directory mode. type: bool aliases: [samba_force_directory_mode] sambaForceDirectorySecurityMode: default: false description: - Force directory security mode. type: bool aliases: [samba_force_directory_security_mode] sambaForceGroup: description: - Force group. type: str aliases: [samba_force_group] sambaForceSecurityMode: default: false description: - Force security mode. type: bool aliases: [samba_force_security_mode] sambaForceUser: description: - Force user. type: str aliases: [samba_force_user] sambaHideFiles: description: - Hide files. type: str aliases: [samba_hide_files] sambaHideUnreadable: default: false description: - Hide unreadable files/directories. type: bool aliases: [samba_hide_unreadable] sambaHostsAllow: default: [] description: - Allowed host/network. type: list elements: str aliases: [samba_hosts_allow] sambaHostsDeny: default: [] description: - Denied host/network. type: list elements: str aliases: [samba_hosts_deny] sambaInheritAcls: default: true description: - Inherit ACLs. type: bool aliases: [samba_inherit_acls] sambaInheritOwner: default: false description: - Create files/directories with the owner of the parent directory. type: bool aliases: [samba_inherit_owner] sambaInheritPermissions: default: false description: - Create files/directories with permissions of the parent directory. type: bool aliases: [samba_inherit_permissions] sambaInvalidUsers: description: - Invalid users or groups. type: str aliases: [samba_invalid_users] sambaLevel2Oplocks: default: true description: - Level 2 oplocks. type: bool aliases: [samba_level_2_oplocks] sambaLocking: default: true description: - Locking. type: bool aliases: [samba_locking] sambaMSDFSRoot: default: false description: - MSDFS root. type: bool aliases: [samba_msdfs_root] sambaNtAclSupport: default: true description: - NT ACL support. type: bool aliases: [samba_nt_acl_support] sambaOplocks: default: true description: - Oplocks. type: bool aliases: [samba_oplocks] sambaPostexec: description: - Postexec script. type: str aliases: [samba_postexec] sambaPreexec: description: - Preexec script. type: str aliases: [samba_preexec] sambaPublic: default: false description: - Allow anonymous read-only access with a guest user. type: bool aliases: [samba_public] sambaSecurityMode: default: '0777' description: - Security mode. type: str aliases: [samba_security_mode] sambaStrictLocking: default: 'Auto' description: - Strict locking. type: str aliases: [samba_strict_locking] sambaVFSObjects: description: - VFS objects. type: str aliases: [samba_vfs_objects] sambaValidUsers: description: - Valid users or groups. type: str aliases: [samba_valid_users] sambaWriteList: description: - Restrict write access to these users/groups. type: str aliases: [samba_write_list] sambaWriteable: default: true description: - Samba write access. type: bool aliases: [samba_writeable] nfs_hosts: default: [] description: - Only allow access for this host, IP address or network. type: list elements: str nfsCustomSettings: default: [] description: - Option name in exports file. type: list elements: str aliases: [nfs_custom_settings] z - name: Create a share named home on the server ucs.example.com with the path /home community.general.udm_share: name: home path: /home host: ucs.example.com sambaName: Home #) AnsibleModule)umc_module_for_addumc_module_for_edit ldap_searchbase_dnc  ttdidtdddtdddtddd tddd td d tdd dtd dtdddtdddtdddtdddtddgdtddgddtddgddtddgddtdd gd!d"td#d$d%gg&d'tdd(gd)d*tdd+gd,d-tdd.gd/d0tdd1gd/d2tdd3gd/d4tdd5gd/d6tdd7gd/d8tdd9gd:tdd;gd/dtdd?gd@tddAgd/dBtd#ddCgg&dDtd#ddEgg&dFtddGgddHtddIgd/dJtddKgd/dLtddMgdNtddOgddPtddQgddRtddSgd/dTtddUgdVtddWgddXtddYgddZtdd[gd\tdd]gd^tdd_gd/d`tddagd,dbtddcgdddetddfgdgtddhgditddjgdktddlgddmtd#dgndotd#ddpgg&dqtdrdrdsgdtddqdrgdufgv}|jd}|jdq}d/}d}tt dwj |dxgy}t t|}dzj |jdt}d{j ||}|drk(r |s td||}n td||}d}j ||jd|jd~<|jD]U} |j| durd|j| <n |j| d/urd|j| <|j| || <W|j}|r*|jD]} |j| sd}nd}|js%|s|jn|r|j!|dsk(r-|r+ td||}|js|j'd}|j)||||y#t"$r-} |j%dj ||| Yd} ~ yd} ~ wwxYw#t"$r-} |j%dj ||| Yd} ~ d} ~ wwxYw)NnameTstr)requiredtypeouowner0)rdefaultgrouppath)r directorymode00755host root_squashboolsubtree_checkingsync writeablesambaBlockSizesamba_block_size)raliasessambaBlockingLockssamba_blocking_locks)rr!rsambaBrowseablesamba_browsablesambaCreateModesamba_create_mode0744sambaCscPolicysamba_csc_policymanualsambaCustomSettingslistdictsamba_custom_settings)relementsr!rsambaDirectoryModesamba_directory_mode0755sambaDirectorySecurityModesamba_directory_security_mode0777sambaDosFilemodesamba_dos_filemodeFsambaFakeOplockssamba_fake_oplockssambaForceCreateModesamba_force_create_modesambaForceDirectoryModesamba_force_directory_modesambaForceDirectorySecurityMode#samba_force_directory_security_modesambaForceGroupsamba_force_groupsambaForceSecurityModesamba_force_security_modesambaForceUsersamba_force_usersambaHideFilessamba_hide_filessambaHideUnreadablesamba_hide_unreadablesambaHostsAllowsamba_hosts_allowsambaHostsDenysamba_hosts_denysambaInheritAclssamba_inherit_aclssambaInheritOwnersamba_inherit_ownersambaInheritPermissionssamba_inherit_permissionssambaInvalidUserssamba_invalid_userssambaLevel2Oplockssamba_level_2_oplocks sambaLocking samba_lockingsambaMSDFSRootsamba_msdfs_root sambaName samba_namesambaNtAclSupportsamba_nt_acl_support sambaOplocks samba_oplocks sambaPostexecsamba_postexec sambaPreexec samba_preexec sambaPublic samba_publicsambaSecurityModesamba_security_modesambaStrictLockingsamba_strict_lockingAutosambaVFSObjectssamba_vfs_objectssambaValidUserssamba_valid_userssambaWriteListsamba_write_listsambaWriteablesamba_writeable nfs_hosts)rr0rnfsCustomSettingsnfs_custom_settingsstatepresentabsent)rchoicesr)rrr]) argument_specsupports_check_mode required_ifz((&(objectClass=univentionShare)(cn={0}))cn)attrzcn=shares,ou={0},{1}z cn={0},{1}z shares/sharez {0} ({1}) printablename1z-Creating/editing share {0} in {1} failed: {2})msgz%Removing share {0} in {1} failed: {2})changedr diff container)rr.paramsr-r formatrlenr rr keysr hasChanged check_modecreatemodify Exception fail_jsonremove exit_json) moduler ryrrobjexistsrdnkerrs o/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/udm_share.pymainrbs! L t "L T L E"$ L E"$L 6"L E'.0L 5!L &%)+L "v*.0L "5$&#L &#')'L * U);(<>+L . $-C,D,0 2/L 4!f*;)<)-/5L :!e*=)>)/1;L @ U);(<(02AL F!%&.4.E-F-/!1GL N $-C,D,2 4OL T(,5T4U4:(-@sL x!e*=)>@yL |$(V1L0M05$7}L B U);(<>CL F U);(<>GL J!%&.E-F-2!4KL P!f*/*=)>)+-QL X V).);(<(*,YL `"v+?*@*.0aL f#,A+B+02gL l%)f2M1N16%8mL r#,A+BDsL v $-D,E,0 2wL |6'6&7&*,}L B V);(<(-/CL H$0>3IL L#,B+C+/1ML R6'6&7&*,SL XE(8'9;YL \5'6&79]L `&&4%5%*,aL f#,A+B+13gL l $-C,D,2 4mL r!e*=)>@sL v!e*=)>@wL z U);(<>{L ~ V):(;(,.L D$)#%'EL J#,1,A+B+-/KL Ry )84!#SL Z! i!> ? _RFf == D MM' "EG D {299$?V C #c(^F&--fmmD.A79MI   T9 -B ! (C)."=-8-?-?fmmTZF[-\FMM/ *XXZ *==#t+'*FMM!$]]1%.'*FMM!$q)A  *88:D'A~~a("&'$$JJLJJL V %nb9C$$ G    1    CJJ        ;BB    s7)C%U8U*V V#VV V>#V99V>__main__N) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrIansible_collections.community.general.plugins.module_utils.univention_umcrr r r r__name__rrrsRA@ } @   4Zz zFr