Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
local
/
lib
/
python3.10
/
dist-packages
/
ansible
/
modules
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: group.cpython-310.pyc
o O�h�Q � @ s d dl mZ dZdZdZd dlZd dlZd dlmZ d dl m Z d dl m Z G d d � d e �ZG d d � d e�ZG d d� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�Zd d � Zed!kr�e� dS dS )"� )� annotationsa� --- 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 --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" 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 sl e Zd ZdZdZdZdZ� fdd�Zdd� Zd d � Z d d � Z d d� Z dd� Z dd� Z dd� Zdd� Z� ZS )�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 s t t�}t| |��|�S �N)r r �super�__new__)�cls�args�kwargs�new_cls�� __class__� �@/usr/local/lib/python3.10/dist-packages/ansible/modules/group.pyr � s z Group.__new__c C s^ || _ |jd | _|jd | _|jd | _|jd | _|jd | _|jd | _|jd | _d S )N�state�name�force�gid�system�local� non_unique) �module�paramsr r r r r r r )�selfr r r r �__init__� s zGroup.__init__c C s | j �|�S r )r � run_command�r �cmdr r r �execute_command� s zGroup.execute_commandc C s. | j rd}nd}| j�|d�| jg}| �|�S )N� lgroupdel�groupdelT)r r � get_bin_pathr r" �r � command_namer! r r r � group_del� s zGroup.group_delc C sN | j r#t�� D ] }| j |jkr"| j|jkr"| jjd�| j |j�d� qd S d S )Nz)GID '{0}' already exists with group '{1}'��msg) r �grp�getgrall�gr_gidr �gr_namer � fail_json�format)r �grr r r �_local_check_gid_exists� s ��z Group._local_check_gid_existsc K s� | j r d}| �� nd}| j�|d�g}|D ]2}|dkr9|| d ur9|�d� |�t|| �� | jr8|�d� q|dkrH|| du rH|�d� q|�| j� | �|�S ) N� lgroupadd�groupaddTr �-g�-or z-r) r r2 r r% �append�strr r r" )r r r' r! �keyr r r � group_add� s" � � zGroup.group_addc K s� | j r d}| �� nd}| j�|d�g}| �� }|D ],}|dkrF|| d urF|d t|| �krF|�d� |�t|| �� | jrF|�d� qt |�dkrOd S | jj rUd S |�| j � | � |�S ) N� lgroupmod�groupmodTr � r5 r6 � �N� r@ �r r@ r@ ) r r2 r r% � group_info�intr7 r8 r �len� check_moder r" )r r r' r! �infor9 r r r � group_mod� s( � zGroup.group_modc C s� | j rWtj�| j�s| jjd�| j�d� d}d�| j�}t | jd��*}|� � d d d� }|D ] }|� t |��r<d} n q/W d � |S W d � |S 1 sPw Y |S z t �| j�raW dS W d S tym Y dS w )NzI'local: true' specified but unable to find local group file {0} to parse.r) Fz{0}:�rb���T)r �os�path�exists� GROUPFILEr r/ r0 r �open� readlines� startswithr r+ �getgrnam�KeyError)r rL � name_test�f�reversed_lines�liner r r � group_exists� s6 �� �� �� � �zGroup.group_existsc C s8 | � � sdS z tt�| j��}W |S ty Y dS w )NF)rW �listr+ rQ r rR )r rF r r r rB � s ��zGroup.group_info)�__name__� __module__� __qualname__�__doc__�platform� distributionrM r r r" r( r2 r: rG rW rB � __classcell__r r r r r | s r c @ s e Zd ZdZd ZdZdd� ZdS )�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 C sF | j rd}nd}| j�|d�g}| jr|�d� |�| j� | �|�S )Nr# r$ Tz-f)r r r% r r7 r r" r& r r r r( s zLinux.group_del)rY rZ r[ r\ r] r^ r( r r r r r` � s r` c @ s$ e Zd ZdZd ZdZdZdd� ZdS )�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 K sp | j �dd�g}|D ]"}|dkr,|| d ur,|�d� |�t|| �� | jr,|�d� q |�| j� | �|�S )Nr4 Tr r5 r6 )r r% r7 r8 r r r" �r r r! r9 r r r r: s � zSunOS.group_add)rY rZ r[ r\ r] r^ rM r: r r r r ra s ra c @ s4 e Zd ZdZd ZdZdZdd� Zdd� Zdd � Z dS ) �AIXz� This is a AIX Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() Nr c C � | j �dd�| jg}| �|�S )N�rmgroupT�r r% r r" r r r r r( ; � z AIX.group_delc K sz | j �dd�g}|D ]'}|dkr"|| d ur"|�dt|| � � q |dkr1|| du r1|�d� q |�| j� | �|�S )N�mkgroupTr �id=r z-a)r r% r7 r8 r r" rb r r r r: ? s � z AIX.group_addc K s� | j �dd�g}| �� }|D ]!}|dkr/|| d ur/|d t|| �kr/|�dt|| � � qt|�dkr8dS | j jr>dS |�| j� | � |�S ) N�chgroupTr r= ri r> r? rA ) r r% rB rC r7 r8 rD rE r r" )r r r! rF r9 r r r rG I s � z AIX.group_mod� rY rZ r[ r\ r] r^ rM r( r: rG r r r r rc - � rc c @ �4 e Zd ZdZdZdZdZdd� Zdd� Zd d � Z dS ) � FreeBsdGroupz� This is a FreeBSD Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() �FreeBSDNr c C s | j �dd�d| jg}| �|�S )N�pwTr$ rf r r r r r( h s zFreeBsdGroup.group_delc K sT | j �dd�d| jg}| jd ur%|�d� |�t| j�� | jr%|�d� | �|�S )Nrp Tr4 r5 r6 )r r% r r r7 r8 r r" �r r r! r r r r: l s zFreeBsdGroup.group_addc K s� | j �dd�d| jg}| �� }t|�}| jd ur6t| j�|d kr6|�d� |�t| j�� | j r6|�d� |t|�krG| j j rBdS | � |�S dS ) Nrp Tr< r= r5 r6 rA r? ) r r% r rB rD r rC r7 r8 r rE r" )r r r! rF �cmd_lenr r r rG u s zFreeBsdGroup.group_modrk r r r r rn Z s rn c @ � e Zd ZdZdZdS )�DragonFlyBsdGroupzq This is a DragonFlyBSD Group manipulation class. It inherits all behaviors from FreeBsdGroup class. � DragonFlyN)rY rZ r[ r\ r] r r r r rt � s rt c @ s: e Zd ZdZdZdZdd� Zdd� Zd dd �Zd d � Z dS ) � 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 K s� | j �dd�g}|ddg7 }| jd ur |dt| j�g7 }n d|v r=|d du r=| �� }|dur=t|�| _|dt| j�g7 }|d| jg7 }| �|�\}}}|||fS ) N� dseditgroupTr6 �create�-ir F�-L)r r% r r8 � get_lowest_available_system_gidr r" )r r r! r �rc�out�errr r r r: � s zDarwinGroup.group_addc C sD | j �dd�g}|ddg7 }|d| jg7 }| �|�\}}}|||fS )Nrx Tr6 �deleter{ rf )r r! r} r~ r r r r r( � s zDarwinGroup.group_delc C s� | � � }| jd ur@t| j�|d kr@| j�dd�g}|ddg7 }|d ur,|dt|�g7 }|d| jg7 }| �|�\}}}|||fS dS ) Nr= rx Tr6 �editrz r{ r? )rB r rC r r% r8 r r" )r r rF r! r} r~ r r r r rG � s zDarwinGroup.group_modc C s� zL| j �dd�g}|g d�7 }| �|�\}}}|�� }d}|D ] }|�d�}t|�dkr<t|d �} | |kr<| dk r<| }q |dksE|d krHW d S |d W S tyV Y d S w ) N�dsclT)z/Local/Defaultz-listz/Groups�PrimaryGroupIDr � r> rI i� i� F)r r% r" � splitlines�splitrD rC � Exception) r r! r} r~ r �lines�highestrB �partsr r r r r| � s& � �z+DarwinGroup.get_lowest_available_system_gidr ) rY rZ r[ r\ r] r^ r: r( rG r| r r r r rv � s rv c @ rm ) � OpenBsdGroupz� This is a OpenBSD Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() �OpenBSDNr c C rd �Nr$ Trf r r r r r( � rg zOpenBsdGroup.group_delc K �Z | j �dd�g}| jd ur"|�d� |�t| j�� | jr"|�d� |�| j� | �|�S �Nr4 Tr5 r6 �r r% r r7 r8 r r r" rq r r r r: � � zOpenBsdGroup.group_addc K � | j �dd�g}| �� }| jd ur/t| j�|d kr/|�d� |�t| j�� | jr/|�d� t|�dkr7dS | j j r=dS |�| j � | � |�S � Nr< Tr= r5 r6 r> r? rA � r r% rB r rC r7 r8 r rD rE r r" �r r r! rF r r r rG � � zOpenBsdGroup.group_modrk r r r r r� � rl r� c @ rm ) � NetBsdGroupz� This is a NetBSD Group manipulation class. This overrides the following methods from the generic class:- - group_del() - group_add() - group_mod() �NetBSDNr c C rd r� rf r r r r r( rg zNetBsdGroup.group_delc K r� r� r� rq r r r r: r� zNetBsdGroup.group_addc K r� r� r� r� r r r rG r� zNetBsdGroup.group_modrk r r r r r� rl r� c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � BusyBoxGroupz� BusyBox group manipulation class for systems that have addgroup and delgroup. It overrides the following methods: - group_add() - group_del() - group_mod() c K sT | j �dd�g}| jd ur|�dt| j�g� | jr |�d� |�| j� | �|�S )N�addgroupTr5 z-S) r r% r �extendr8 r r7 r r" rq r r r r: = s zBusyBoxGroup.group_addc C rd )N�delgroupTrf r r r r r( I rg zBusyBoxGroup.group_delc K s� | � � }| jd ury| j|d krytdd�� }|�� }W d � n1 s$w Y t| j�}d||d f }d|| jf }d| j |v rP| jjdj| jd�d� | jj rVd S |� ||�}tdd ��}|� |� W d � d S 1 srw Y d S d S ) Nr= r rH s %s:x:%d:s :%d:zgid '{gid}' in use�r r) rA �wbr? ) rB r rN �readr r r r/ r0 rE �replace�write) r r rF rT �b_groups�b_name�b_current_group_string�b_new_group_string� b_new_groupsr r r rG M s( � ��zBusyBoxGroup.group_modN)rY rZ r[ r\ r: r( rG r r r r r� 3 s r� c @ rs )� AlpineGroupr` �AlpineN)rY rZ r[ r] r^ r r r r r� e s r� c C s t ttddddgd�tddd�tddd �td d �tddd �tddd �tddd �d �dd ddgggd�} | jd rC| jd rC| jdd� t| �}| �d|j � |jrZ| �d|j � d }d}d}i }|j|d< |j |d< |j dkr�|� � r�| j r~| j dd� |� � \}}}|dkr�| j|j|d� n9|j dkr�|� � s�| j r�| j dd� |j|j|jd �\}}}n |j|jd �\}}}|d ur�|dkr�| j|j|d� |d u r�d|d < nd|d < |r�||d < |r�||d < |� � r�|�� }|j|d!< |d" |d< | j d#i |�� d S )$Nr8 �present�absent)�type�default�choicesT)r� �required�boolF)r� r� rC )r� )r r r r r r r r r )� argument_spec�supports_check_mode� required_ifr r zWforce is not a valid option for local, force=True and local=True are mutually exclusiver) z Group instantiated - platform %sz$Group instantiated - distribution %sr@ r r )�changedr )r r* )r r r� r� �stdout�stderrr r= r )r �dictr r/ r �debugr] r^ r r rW rE � exit_jsonr( r: r r rG rB )r �groupr} r~ r �resultrF r r r �maink sl � �� � r� �__main__)� __future__r � DOCUMENTATION�EXAMPLES�RETURNr+ rJ �+ansible.module_utils.common.text.convertersr �ansible.module_utils.basicr �$ansible.module_utils.common.sys_infor �objectr r` ra rc rn rt rv r� r� r� r� r� rY r r r r �<module> s0 G }-, E./2G �
Save
Cancel