Vh\bddlmZdZdZdZddlZddlZddlmZddl m Z ddl m Z Gd d e ZGd d eZGd deZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZdZed k(reyy)!) annotationsa1 --- module: group version_added: "0.0.2" short_description: Add or remove groups requirements: - groupadd - groupdel - groupmod description: - Manage presence of groups on a host. - For Windows targets, use the M(ansible.windows.win_group) module instead. options: name: description: - Name of the group to manage. type: str required: true gid: description: - Optional I(GID) to set for the group. type: int state: description: - Whether the group should be present or not on the remote host. type: str choices: [ absent, present ] default: present force: description: - Whether to delete a group even if it is the primary group of a user. - Only applicable on platforms which implement a C(--force) flag on the group deletion command. type: bool default: false version_added: "2.15" system: description: - If V(yes), indicates that the group created is a system group. type: bool default: no local: description: - Forces the use of "local" command alternatives on platforms that implement it. - This is useful in environments that use centralized authentication when you want to manipulate the local groups. (for example, it uses C(lgroupadd) instead of C(groupadd)). - This requires that these commands exist on the targeted host, otherwise it will be a fatal error. type: bool default: no version_added: "2.6" non_unique: description: - This option allows to change the group ID to a non-unique value. Requires O(gid). - Not supported on macOS or BusyBox distributions. type: bool default: no version_added: "2.8" gid_min: description: - Sets the GID_MIN value for group creation. - Overwrites /etc/login.defs default value. - Currently supported on Linux. Does nothing when used with other platforms. - Requires O(local) is omitted or V(False). type: int version_added: "2.18" gid_max: description: - Sets the GID_MAX value for group creation. - Overwrites /etc/login.defs default value. - Currently supported on Linux. Does nothing when used with other platforms. - Requires O(local) is omitted or V(False). type: int version_added: "2.18" extends_documentation_fragment: action_common_attributes attributes: check_mode: support: full diff_mode: support: none platform: platforms: posix seealso: - module: ansible.builtin.user - module: ansible.windows.win_group author: - Stephen Fromm (@sfromm) z - name: Ensure group "somegroup" exists ansible.builtin.group: name: somegroup state: present - name: Ensure group "docker" exists with correct gid ansible.builtin.group: name: docker state: present gid: 1750 a gid: description: Group ID of the group. returned: When O(state) is C(present) type: int sample: 1001 name: description: Group name. returned: always type: str sample: users state: description: Whether the group is present or not. returned: always type: str sample: 'absent' system: description: Whether the group is a system group or not. returned: When O(state) is C(present) type: bool sample: False N)to_bytes) AnsibleModule)get_platform_subclassc^eZdZdZdZdZdZfdZdZdZ dZ d Z d Z d Z d Zd ZxZS)Groupa- This is a generic Group manipulation class that is subclassed based on platform. A subclass may wish to override the following action methods:- - group_del() - group_add() - group_mod() All subclasses MUST define platform and distribution (which may be None). GenericN /etc/groupc@tt}t|||SN)rrsuper__new__)clsargskwargsnew_cls __class__s E/home/dcms/DCMS/lib/python3.12/site-packages/ansible/modules/group.pyrz Group.__new__s'.S'*733c||_|jd|_|jd|_|jd|_|jd|_|jd|_|jd|_|jd|_|jd|_ |jd |_ |jr>|j|jd |j|jd yyy) Nstatenameforcegidsystemlocal non_uniquegid_mingid_maxz&'gid_min' can not be used with 'local'msgz&'gid_max' can not be used with 'local') moduleparamsrrrrrrrrr fail_json)selfr"s r__init__zGroup.__init__s ]]7+ MM&) ]]7+ =='mmH- ]]7+  -- 5}}Y/ }}Y/ ::||'  %M N||'  %M N( rc8|jj|Sr )r" run_commandr%cmds rexecute_commandzGroup.execute_commands{{&&s++rc|jrd}nd}|jj|d|jg}|j |S)N lgroupdelgroupdelT)rr" get_bin_pathrr+r% command_namer*s r group_delzGroup.group_delsC ::&L%L{{'' d;TYYG##C((rc8|jrtjD]v}|j|jk(s|j|j k7s7|j jdj|j|j xyy)Nz)GID '{0}' already exists with group '{1}'r ) rgrpgetgrallgr_gidrgr_namer"r$format)r%grs r_local_check_gid_existszGroup._local_check_gid_existssu 88lln x88ryy(TYY"**-DKK)).Y.`.`aeaiaikmkuku.v)w x rc |jrd}|jnd}|jj|dg}|D]x}|dk(rR||M|j d|j t |||j sH|j dZ|dk(s`||dush|j dz|j8|j d |j d t |jz|j8|j d |j d t |jz|j |j|j|S) N lgroupaddgroupaddTr-g-orz-r-KGID_MIN=GID_MAX=) rr:r"r/appendstrrrrrr+)r%rr1r*keys r group_addzGroup.group_adds, ::&L  ( ( *%L{{'' d;< !Ce|s 7 4  3vc{+,??JJt$VC[D%8 4  ! << # JJt  JJzC $55 6 << # JJt  JJzC $55 6 499##C((rc *|jrd}|jnd}|jj|dg}|j }|D]o}|dk(s |||dt ||k7s$|j d|j t|||js_|j dqt|dk(ry |jjry |j |j|j|S) N lgroupmodgroupmodTrr>r?NrMrrMrM) rr:r"r/ group_infointrCrDrlen check_moderr+)r%rr1r*inforEs r group_modzGroup.group_mods ::&L  ( ( *%L{{'' d;<  )Ce|#;*tAw#fSk:J/JJJt$JJs6#;/0 4(  ) s8q=! ;; ! ! 499##C((rcD|jrtjj|js5|j j dj|jd}dj|j}t|jd5}|jddd}|D] }|jt|sd}nddd|S tj|jryy#1swY|SxYw#t$rYywxYw)NzI'local: true' specified but unable to find local group file {0} to parse.r Fz{0}:rbT)rospathexists GROUPFILEr"r$r8ropen readlines startswithrr4getgrnamKeyError)r%rZ name_testfreversed_lineslines r group_existszGroup.group_existss  ::77>>$..1 %%*u*|*|~B~L~L+M%NF dii0Idnnd+ q!"tt!4*Dx ':;!%  M << *+  M   s$6DD%DD DDc|jsy ttj|j}|S#t $rYywxYw)NF)relistr4r_rr`)r%rSs rrOzGroup.group_info sH  "  TYY/0D   s(= A A )__name__ __module__ __qualname____doc__platform distributionr[rr&r+r2r:rFrTrerO __classcell__)rs@rrrsH HLI4O$,)x )0),2rrceZdZdZdZdZdZy)Linuxz This is a Linux Group manipulation class. This is to apply the '-f' parameter to the groupdel command This overrides the following methods from the generic class:- - group_del() Nc|jrd}nd}|jj|dg}|jr|j d|j |j |j |S)Nr-r.Tz-f)rr"r/rrCrr+r0s rr2zLinux.group_del"s` ::&L%L{{'' d;< :: JJt  499##C((r)rhrirjrkrlrmr2rrrprpsHL )rrpc"eZdZdZdZdZdZdZy)SunOSz This is a SunOS Group manipulation class. Solaris doesn't have the 'system' group concept. This overrides the following methods from the generic class:- - group_add() Nr c b|jjddg}|D]Z}|dk(s |||jd|jt|||jsJ|jd\|j 8|jd|jdt|j z|j 8|jd|jdt|j z|j|j|j|S) Nr=Trr>r?r@rArB) r"r/rCrDrrrrr+r%rr*rEs rrFzSunOS.group_add=s{{'' D9: %Ce|s 7 4  3vc{+,??JJt$  % << # JJt  JJzC $55 6 << # JJt  JJzC $55 6 499##C((r)rhrirjrkrlrmr[rFrrrrrtrt0sHLI)rrtc.eZdZdZdZdZdZdZdZdZ y)AIXz This is a AIX Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() Nr ct|jjdd|jg}|j|S)NrmgroupTr"r/rr+r)s rr2z AIX.group_del_s2{{'' 48$))D##C((rc F|jjddg}|D]L}|dk(r&||!|jdt||z.|dk(s4||dus<|jdN|j8|jd|jdt|jz|j 8|jd|jd t|j z|j|j |j|S) NmkgroupTrid=rz-ar@rArB)r"r/rCrDrrrr+rvs rrFz AIX.group_addcs{{'' 489 !Ce|s 7 53vc{#334VC[D%8 4  ! << # JJt  JJzC $55 6 << # JJt  JJzC $55 6 499##C((rc |jjddg}|j}|D]C}|dk(s |||dt||k7s$|j dt ||zEt |dk(ry|jjry|j |j|j|S) NchgroupTrrJr~rKrLrN) r"r/rOrPrCrDrQrRrr+)r%rr*rSrEs rrTz AIX.group_modss{{'' 489  9Ce|#;*tAw#fSk:J/JJJus6#;'778 9 s8q=! ;; ! ! 499##C((r rhrirjrkrlrmr[r2rFrTrrrrrxrxQs'HLI)) )rrxc.eZdZdZdZdZdZdZdZdZ y) FreeBsdGroupz This is a FreeBSD Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() FreeBSDNr cv|jjddd|jg}|j|S)NpwTr.r{r)s rr2zFreeBsdGroup.group_dels4{{''d3ZK##C((rc B|jjddd|jg}|jR|j d|j t |j|j r|j d|j8|j d|j dt |jz|j8|j d|j dt |jz|j|S) NrTr=r>r?r@rArB) r"r/rrrCrDrrrr+r%rr*s rrFzFreeBsdGroup.group_adds{{''d3ZK 88  JJt  JJs488} % 4 << # JJt  JJzC $55 6 << # JJt  JJzC $55 6##C((rc |jjddd|jg}|j}t |}|j mt |j |dk7rR|jd|jt|j |jr|jd|t |k7r(|jjry|j|Sy) NrTrIrJr>r?rNrL) r"r/rrOrQrrPrCrDrrRr+)r%rr*rScmd_lens rrTzFreeBsdGroup.group_mods{{''d3ZK c( 88 CMT!W$< JJt  JJs488} % 4 c#h {{%%"'', ,rrrrrrrrs'HLI) )rrceZdZdZdZy)DragonFlyBsdGroupzq This is a DragonFlyBSD Group manipulation class. It inherits all behaviors from FreeBsdGroup class. DragonFlyN)rhrirjrkrlrrrrrrs Hrrc2eZdZdZdZdZdZdZddZdZ y) DarwinGroupz This is a Mac macOS Darwin Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() group manipulation are done using dseditgroup(1). DarwinNc |jjddg}|ddgz }|j|dt|jgz }nId|vrE|ddur>|j }|dur*t||_|dt|jgz }|d|j gz }|j |\}}}|||fS) N dseditgroupTr?create-irF-L)r"r/rrDget_lowest_available_system_gidrr+)r%rr*rrcouterrs rrFzDarwinGroup.group_adds{{'' t<= h 88  D#dhh-( (C  F8$4$<668C%s8c$((m,, dii  --c2S#C~rc|jjddg}|ddgz }|d|jgz }|j|\}}}|||fS)NrTr?deleterr{)r%r*rrrs rr2zDarwinGroup.group_dels_{{'' t<= h dii  --c2S#C~rc4|j}|j|t|j|dk7ra|jj ddg}|ddgz }||dt |gz }|d|j gz }|j|\}}}|||fSy) NrJrTr?editrrrL)rOrrPr"r/rDrr+)r%rrSr*rrrs rrTzDarwinGroup.group_mods  88 CMT!W$<;;++M4@AC D&> !Cc#h'' D$))$ $C!11#6NRcS> !rc^ |jjddg}|gdz }|j|\}}}|j}d}|D]>}|j d}t |dkDs#t |d} | |kDs7| dks=| }@|dk(s|d k(ry |dzS#t$rYy wxYw) NdsclT)z/Local/Defaultz-listz/GroupsPrimaryGroupIDr rKrWiiF)r"r/r+ splitlinessplitrQrP Exception) r%r*rrrlineshighestrOpartsrs rrz+DarwinGroup.get_lowest_available_system_gids ;;++FD9:C K KC!11#6NRcNN$EG# & "((-u:>eBi.CW}s"%  & !|w#~aK   s*A/B 2B B B B B,+B,r ) rhrirjrkrlrmrFr2rTrrrrrrrs' HL  rrc.eZdZdZdZdZdZdZdZdZ y) OpenBsdGroupz This is a OpenBSD Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() OpenBSDNr ct|jjdd|jg}|j|SNr.Tr{r)s rr2zOpenBsdGroup.group_del2{{'' D9499E##C((rc `|jjddg}|jR|jd|jt |j|j r|jd|j 8|jd|jdt |j z|j8|jd|jdt |jz|j|j|j|SNr=Tr>r?r@rArB r"r/rrCrDrrrrr+rs rrFzOpenBsdGroup.group_add{{'' D9: 88  JJt  JJs488} % 4 << # JJt  JJzC $55 6 << # JJt  JJzC $55 6 499##C((rc |jjddg}|j}|jmt |j|dk7rR|j d|j t |j|jr|j dt|dk(ry|jjry|j |j|j|S NrITrJr>r?rKrLrN r"r/rOrrPrCrDrrQrRrr+r%rr*rSs rrTzOpenBsdGroup.group_mod({{'' D9:  88 CMT!W$< JJt  JJs488} % 4 s8q=! ;; ! ! 499##C((rrrrrrrrs'HLI)) )rrc.eZdZdZdZdZdZdZdZdZ y) NetBsdGroupz This is a NetBSD Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() NetBSDNr ct|jjdd|jg}|j|Srr{r)s rr2zNetBsdGroup.group_delHrrc `|jjddg}|jR|jd|jt |j|j r|jd|j 8|jd|jdt |j z|j8|jd|jdt |jz|j|j|j|Srrrs rrFzNetBsdGroup.group_addLrrc |jjddg}|j}|jmt |j|dk7rR|j d|j t |j|jr|j dt|dk(ry|jjry|j |j|j|Srrrs rrTzNetBsdGroup.group_mod\rrrrrrrrr:s'HLI)) )rrc"eZdZdZdZdZdZy) BusyBoxGroupz BusyBox group manipulation class for systems that have addgroup and delgroup. It overrides the following methods: - group_add() - group_del() - group_mod() c B|jjddg}|j&|jdt |jg|j r|j d|j8|j d|j dt |jz|j8|j d|j dt |jz|j |j|j|S)NaddgroupTr>z-Sr@rArB) r"r/rextendrDrrCrrrr+rs rrFzBusyBoxGroup.group_addys{{'' D9: 88  JJc$((m, - ;; JJt  << # JJt  JJzC $55 6 << # JJt  JJzC $55 6 499##C((rct|jjdd|jg}|j|S)NdelgroupTr{r)s rr2zBusyBoxGroup.group_delrrc h|j}|j|j|dk7rtdd5}|j}dddt |j }d||dfz}d||jfz}d|jzvr6|j jdj|j|j jry |j||}tdd 5}|j|dddy y #1swYxYw#1swYy xYw) NrJr rVs%s:x:%d:s:%d:zgid '{gid}' in userr rNwbrL) rOrr\readrrr"r$r8rRreplacewrite) r%rrSrbb_groupsb_nameb_current_group_stringb_new_group_string b_new_groupss rrTzBusyBoxGroup.group_mods  88 DHHQ$7lD) $Q668 $dii(F%0FDG3D%D "!,/A!A !X- %%*>*E*E$((*E*S%T{{%% #++,BDVWLlD) &Q % &# $ $ &sDD(D%(D1N)rhrirjrkrFr2rTrrrrrros)()rrceZdZdZdZy) AlpineGrouprpAlpineN)rhrirjrlrmrrrrrrs HLrrcrtttddddgtddtdd td tdd tdd tdd td td  dd ddggg}|jdr!|jdr|jdt |}|j d|j z|jr|j d|jzd}d}d}i}|j|d<|j|d<|jdk(rf|jr|jr|jd|j\}}}|dk7r|j|j|n|jdk(r|jsJ|jr|jd|j|j|j \}}}n |j#|j\}}}|"|dk7r|j|j||d|d<nd|d<|r||d<|r||d <|jr'|j%}|j |d!<|d"|d<|jd#i|y)$NrDpresentabsent)typedefaultchoicesT)rrequiredboolF)rrrP)r) rrrrrrrrrrr) argument_specsupports_check_mode required_ifrrzWforce is not a valid option for local, force=True and local=True are mutually exclusiver z Group instantiated - platform %sz$Group instantiated - distribution %srMrr)changedr)rr!)rrrrstdoutstderrrrJrr)rdictr#r$rdebugrlrmrrrerR exit_jsonr2rFrrrTrO)r"grouprrrresultrSs rmainrs E9x>ST540FE2% VU3FE27e$e$  ! 4% ) F$}}W&--"8vw &ME LL3ennDE  ;e>P>PPQ B C C FZZF6NkkF7O {{h         ."__.NRcQw  ejjc :  !!!#     ."__5<<_PNRc"___;NRc >bAg   %**#  6 z!y y x x ! <<xQu Fvr__main__) __future__r DOCUMENTATIONEXAMPLESRETURNr4rX+ansible.module_utils.common.text.convertersransible.module_utils.basicr$ansible.module_utils.common.sys_inforobjectrrprtrxrrrrrrrrrhrrrrrs #U n  . @4FFFFV)E)2)E)B.)%.)f/5/d B%BJ/)5/)h/)%/)j757t, FR zFr