o

�N�g+;�@s�dZd
dl
Z
d
dlZd
dlZe
�e�
ZdZddi
Z	ej
jjdd��
Z
dd	�Zd
d�Zd'dd�
Zd(dd�
Zd(dd�
Zdd�Zd)dd�
Zdd�Zd*dd�
Zdd�Zdd�Zdd �Zd!d"�Zd*d#d$�
Zd+d%d&�
ZdS),a

Module for Solaris 10's zoneadm

:maintainer:    Jorge Schrauwen <sjorge@blackdot.be>
:maturity:      new
:platform:      OmniOS,OpenIndiana,SmartOS,OpenSolaris,Solaris 10

.. versionadded:: 2017.7.0

.. warning::
    Oracle Solaris 11's zoneadm is not supported by this module!
�N�zoneadm�
list_zones�listc
Cs<td
dksdSt
dd�
}|drdS|ddkrd	SdS)
z3
    Check if we are running in the globalzone
    Zkernel�SunOSF�cmd.run_all�zonename�retcode�stdout�globalT)�
__grains__�__salt__)
r�r
�H/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/zoneadm.py�_is_globalzones




rc

Cst|�
d
ko|�
d�
dkS)z*
    Check if zone is actually a UUID
    �$�
-�)�len�index�
�zoner
r
r�_is_uuid-srcCsRt�r"t
jj�d
�
r"tddvrtStddkr"ttd�
dkr"tSdt�d�fS)	z�
    We are available if we are have zoneadm and are the global zone on
    Solaris 10, OmniOS, OpenIndiana, OpenSolaris, or Smartos.
    r�os)ZOpenSolarisZSmartOSZOmniOSZOpenIndianazOracle SolarisZosmajorrelease�
Fz3 module can only be loaded in a solaris globalzone.)r�salt�utils�path�whichr�__virtualname__�intr
r
r
r�__virtual__4s



�r TFcCs�i}d
�d�
}t
dd�
}|ddkrZ|d��D]@}|�d�
}i}t|�
D]
\}	}
||	||
<q&|r:|dd	kr:q|
sC|d
dkrCq|sL|d
dkrLq|||d<||dd=q|r^|St|���
S)
ai

    List all zones

    verbose : boolean
        display additional zone information
    installed : boolean
        include installed zones in output
    configured : boolean
        include configured zones in output
    hide_global : boolean
        do not include global zone

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.list
    z1zoneid:zonename:state:zonepath:uuid:brand:ip-type�
:rzzoneadm list -p -crr
r	rr
�state�	installed�
configured)�splitr�
splitlines�	enumerate�sorted�keys)�verboser#r$Zhide_globalZzones�headerZ	zone_datarZzone_t�num�valr
r
rrGs$












cC��d
di
}d}|
r
d|��}|rd|�d|��}|r!d|�d|��}|dkr,d|����}t
d	d
jt|�
r:d|��nd|��|d
��
}|ddk|d
<|d
rS|dn|d|d<|d�dd�|d<|ddkrl|d=|S)a�
    Boot (or activate) the specified zone.

    zone : string
        name or uuid of the zone
    single : boolean
        boots only to milestone svc:/milestone/single-user:default.
    altinit : string
        valid path to an alternative executable to be the primordial process.
    smf_options : string
        include two categories of options to control booting behavior of
        the service management facility: recovery options and messages options.

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.boot clementine
        salt '*' zoneadm.boot maeve single=True
        salt '*' zoneadm.boot teddy single=True smf_options=verbose
    �statusT��-s �-i �
 �-m � -- rzzoneadm {zone} boot{boot_opts}�-u �-z �r�	boot_optsrr
r	�stderr�message�	zoneadm: ��stripr�formatr�replace�r�single�altinit�smf_options�ret�boot_options�resr
r
r�bootys,











��



rHcCr.)ap
    Restart the zone. This is equivalent to a halt boot sequence.

    zone : string
        name or uuid of the zone
    single : boolean
        boots only to milestone svc:/milestone/single-user:default.
    altinit : string
        valid path to an alternative executable to be the primordial process.
    smf_options : string
        include two categories of options to control booting behavior of
        the service management facility: recovery options and messages options.

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.reboot dolores
        salt '*' zoneadm.reboot teddy single=True
    r/Tr0r1r2r3r4r5rz zoneadm {zone} reboot{boot_opts}r6r7r8rr
r	r:r;r<r=rAr
r
r�reboot�s,











��



rIc
C�d
di
}
tddj
t|�
rd|��nd|��d�
�
}|dd	k|
d
<|
d
r*|d
n|d|
d<|
d�d
d�|
d<|
ddkrC|
d=|
S)z�
    Halt the specified zone.

    zone : string
        name or uuid of the zone

    .. note::
        To cleanly shutdown the zone use the shutdown function.

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.halt hector
    r/Trzzoneadm {zone} haltr6r7rrr
r	r:r;r<r0�rr?rr@�rrErGr
r
r�halt��

��



rMcCs�d
di
}d}|r
d|��}|rd|�d|��}|r!d|�d|��}|dkr,d|����}t
d	d
jt|�
r:d|��nd|��|
rBd
n
d|d��
}|ddk|d
<|d
rX|dn|d|d<|d�dd�|d<|ddkrq|d=|S)a�
    Gracefully shutdown the specified zone.

    zone : string
        name or uuid of the zone
    reboot : boolean
        reboot zone after shutdown (equivalent of shutdown -i6 -g0 -y)
    single : boolean
        boots only to milestone svc:/milestone/single-user:default.
    altinit : string
        valid path to an alternative executable to be the primordial process.
    smf_options : string
        include two categories of options to control booting behavior of
        the service management facility: recovery options and messages options.

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.shutdown peter
        salt '*' zoneadm.shutdown armistice reboot=True
    r/Tr0r1r2r3r4r5rz*zoneadm {zone} shutdown{reboot}{boot_opts}r6r7z -r)rrIr9rr
r	r:r;r<r=)rrIrBrCrDrErFrGr
r
r�shutdown�s.













��



rOc
CrJ)z�
    Detach the specified zone.

    zone : string
        name or uuid of the zone

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.detach kissy
    r/Trzzoneadm {zone} detachr6r7rrr
r	r:r;r<r0rKrLr
r
r�detach4
�


��



rPcC�d
di
}tddj
||
rdn
d|rd|��n
dd��
}|d	d
k|d
<|d
r+|dn|d|d
<|d
�dd�|d
<|d
dkrD|d
=|S)al

    Attach the specified zone.

    zone : string
        name of the zone
    force : boolean
        force the zone into the "installed" state with no validation
    brand_opts : string
        brand specific options to pass

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.attach lawrence
        salt '*' zoneadm.attach lawrence True
    r/Trz+zoneadm -z {zone} attach{force}{brand_opts}z -Fr0r3)r�force�
brand_optsrr
r	r:r;r<�rr?r@)rrSrTrErGr
r
r�attachR
�




��



rVc
CrJ)z�
    Prepares a zone for running applications.

    zone : string
        name or uuid of the zone

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.ready clementine
    r/Trzzoneadm {zone} readyr6r7rrr
r	r:r;r<r0rKrLr
r
r�readyw
rQrXc
Csrd
di
}
tddj
|d�
�
}|ddk|
d
<|
d
r|dn|d	|
d
<|
d
�dd�|
d
<|
d
dkr7|
d
=|
S)
z�
    Check to make sure the configuration of the specified
    zone can safely be installed on the machine.

    zone : string
        name of the zone

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.verify dolores
    r/Trzzoneadm -z {zone} verifyrrr
r	r:r;r<r0rUrLr
r
r�verify�
s

��



rYcCs�d
di
}tddj
t|�
rd|��nd|��|
d��
}|dd	k|d
<|d
r+|d
n|d|d<|d�d
d�|d<|ddkrD|d=|S)z�
    Move zone to new zonepath.

    zone : string
        name or uuid of the zone
    zonepath : string
        new zonepath

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.move meave /sweetwater/meave
    r/Trzzoneadm {zone} move {path}r6r7)rrrr
r	r:r;r<r0rK)rZzonepathrErGr
r
r�move�
s


��



rZc
CrJ)a

    Uninstall the specified zone from the system.

    zone : string
        name or uuid of the zone

    .. warning::
        The -F flag is always used to avoid the prompts when uninstalling.

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.uninstall teddy
    r/Trzzoneadm {zone} uninstall -Fr6r7rrr
r	r:r;r<r0rKrLr
r
r�	uninstall�
rNr[cCrR)ab

    Install the specified zone from the system.

    zone : string
        name of the zone
    nodataset : boolean
        do not create a ZFS file system
    brand_opts : string
        brand specific options to pass

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.install dolores
        salt '*' zoneadm.install teddy True
    r/Trz0zoneadm -z {zone} install{nodataset}{brand_opts}z
 -x nodatasetr0r3)r�	nodatasetrTrr
r	r:r;r<rU)rr\rTrErGr
r
r�install�
rWr]cCs�d
di
}tddj
||
|rd|�d�n
dd��
}|d	d
k|d
<|d
r(|dn|d|d
<|d
�dd�|d
<|d
dkrA|d
=|S)aB

    Install a zone by copying an existing installed zone.

    zone : string
        name of the zone
    source : string
        zone to clone from
    snapshot : string
        optional name of snapshot to use as source

    CLI Example:

    .. code-block:: bash

        salt '*' zoneadm.clone clementine dolores
    r/Trz*zoneadm -z {zone} clone {snapshot}{source}r1r3r0)r�source�snapshotrr
r	r:r;r<rU)rr^r_rErGr
r
r�clones



��



r`)TFFT)FNN)FFNN)FN)
N)�__doc__�loggingZsalt.utils.decoratorsrZsalt.utils.path�	getLogger�__name__�logrZ__func_alias__rZ
decoratorsZmemoizerrr rrHrIrMrOrPrVrXrYrZr[r]r`r
r
r
r�<module>
s0






2
32
!5
%!
!%