Current File : //usr/lib/python2.7/site-packages/salt/utils/zfs.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l m
Z
d d l m Z
d d l m Z d d l m Z d d l Z d d l m Z e j d � Z d
d d d
d d g Z e j e � Z d � Z d � Z d d � Z d � Z d � Z! d � Z" d d � Z$ d e% d � Z& e
d � � Z' e
d � � Z( d d d d d d d d � Z) d � Z* e
d � � Z+ e
d � � Z, e
d � � Z- d! � Z. d" � Z/ d# � Z0 d$ � Z1 d% � Z2 d& � Z3 d' � Z4 e% d( � Z5 d) � Z6 d* � Z7 d d+ � Z8 d e% d, � Z9 d d- � Z: d e% d. � Z; d/ � Z< d0 � Z= d1 � Z> d d d d d d d2 � Z? d d d d d d d d3 � Z@ d d4 � ZA d S(5 u7
Utility functions for zfs
These functions are for dealing with type conversion and basic execution
:maintainer: Jorge Schrauwen <sjorge@blackdot.be>
:maturity: new
:depends: salt.utils.stringutils, salt.ext, salt.module.cmdmod
:platform: illumos,freebsd,linux
.. versionadded:: 2018.3.1
i ( t absolute_importt unicode_literalst print_functionN( t Number( t memoize( t OrderedDict( t to_num( t zipu, ^(\d+|\d+(?=\d*)\.\d+)([KkMmGgTtPpEe][Bb]?)$u Ku Mu Gu Tu Pu Ec C@ s% t j j j | d d d t �d k S( u4
Simple internal wrapper for cmdmod.retcode
t output_loglevelu quiett ignore_retcodei ( t saltt modulest cmdmodt retcodet True( t cmd( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _check_retcode( s c K@ sE d | k r t | d <n d | k r2 d | d <n t j j j | � S( u0
Simple internal wrapper for cmdmod.run
u ignore_retcodeu output_loglevelu quiet( R R
R R t run_all( t kwargs( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _exec/ s
u c C@ sB t | � | k r> | d | d !| j | | d � g } n | S( u=
Merge values all values after X into the last value
i i ( t lent join( t valuest merge_aftert
merge_with( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _merge_last: s ,c C@ s* d | k r& | | j d � d } n | S( u#
Normalizes property names
u @i ( t index( t name( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _property_normalize_nameD s c C@ s� d } | j d � r d } nl | j d � r6 d } nT | d k rK d } n? | d k r` d } n* | d k ru d } n | d k r� d } n | S( u+
Detect the datatype of a property
u stru on | offu boolu yes | nou bool_altu <size>u
<size> | noneu sizeu <count>u <count> | noneu <guid>u numericu sharenfsu sharesmbu canmountu versionu copies( u <size>u
<size> | none( u <count>u <count> | noneu <guid>( u sharenfsu sharesmbu canmount( u versionu copies( t
startswith( R R t
value_type( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _property_detect_typeM s c C@ s� t t | t | t | � � � � } t | d � | d <t | d | d � | d <t | d � | d <d | k r� t | d � | d <n | d =| S( u
Create a property dict
u propertyu nameu valuesu typeu editu inherit( t dictR R R R R t from_bool( t headert datat prop( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _property_create_dicta s $ c C@ s | s i } n i } | d d k r2 | d 7} n g } x� t d | � d j d � D]� } | j � j � } | sy qU n9 | d d k r� | } qU n | sU | d d
k r� qU n t | | � } | | | d <| d | k r� | | | | d <n | d =qU W| S( u/
Parse output of zpool/zfs get command
i����u getu getR u stderru
i u propertyi u nou yesu name( u nou yes( R t splitt lowerR% ( R t aliast
propertiest prop_hdrt prop_dataR$ ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _property_parse_cmdo s*
# u autoc C@ s� | d k r | St � } | d k r1 t � } n | d k rP | j t � � n | | k rj | | d n d } | d k r� | d k r� t � d j | | � | | � St � d j | | � | � S(
u2
Internal magic for from_auto and to_auto
u tou fromu zfsu autou typeu stru sizeu {}_{}( u tou from( t property_data_zpoolt property_data_zfst updatet globalst format( t directionR t valuet sourcet convert_to_humant propsR ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _auto� s c C@ s t j j j d � S( u6
Return the path of the zfs binary if present
u zfs( R
t utilst patht which( ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _zfs_cmd� s c C@ s t j j j d � S( u8
Return the path of the zpool binary if present
u zpool( R
R8 R9 R: ( ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt
_zpool_cmd� s c
C@ s� | d k r t � n t � | g } | d k r9 g } n x | D] }
| j |
� q@ W| d k rl i } n xp t | � D]b } t | | t � s� | | g | | <n x2 | | D]& } | j | � | j t | � � q� Wqy W| d k r� i } n xk t | � D]] }
| j | d k r d n d � | j d j d |
d t |
| |
d d d t
�� � qW| d k rwi } n xY t | � D]K }
| j d � | j d j d |
d t |
| |
d d d t
�� � q�W| d k r�| d k rxt | t � s| g } n t | t � s!| g } n xa t | | � D]@ \ } } | j d j d | d t | | d | d t
�� � q1Wq�| j | � n | d k r�t | t � s�| g } n x6 | D]+ } | d k r�q�n | j t | � � q�Wn d
j | � S( u�
Build and properly escape a zfs command
.. note::
Input is not considered safe and will be passed through
to_auto(from_auto('input_here')), you do not need to do so
your self first.
u zpoolu -Ou -ou {key}={val}t keyt valR4 u zfsR5 u N(
R< R; t Nonet appendt sortedt
isinstancet listt to_strR1 t to_autot FalseR R ( R4 t commandt flagst optst
property_namet property_valuet filesystem_propertiest pool_propertiest targetR t flagt optR> t fsoptR= t tgt( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt _command� s\ $
'
' &
c C@ s t } t j j j � r! t } n� t j j j � rH t d � rH t } n� t j j j � ru t j
j d � ru t } no t j j j � r� t j j
j d � r� t } n? t j j j
� r� t j
j d � r� t j
j d � r� t } n t j j
j d � o� | t k S( u*
Check the system for ZFS support
u kldstat -q -m zfsu /sys/module/zfsu zfs-fuseu /Library/Extensions/zfs.kextu /dev/zfsu zpool( RF R
R8 t platformt is_sunosR t
is_freebsdR t is_linuxt osR9 t existsR: t is_darwin( t on_supported_platform( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt is_supported s $ ' c C@ s5 t j j j d � } | r1 t d j d | � � St S( u.
Check if zpool-features is available
u manu {man} zpool-featurest man( R
R8 R9 R: R R1 RF ( R] ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt has_feature_flags3 s c C@ s� t t � i d d 6d d 6d d 6d d 6d d
6� } d d d
d d d d d g } d d g } x- | D]% } i t d 6d d 6d d 6| | <qf Wx- | D]% } i t d 6d d 6d d 6| | <q� W| S( u"
Return a dict of zpool properties
.. note::
Each property will have an entry with the following info:
- edit : boolean - is this property editable after pool creation
- type : str - either bool, bool_alt, size, numeric, or string
- values : str - list of possible values
.. warning::
This data is probed from the output of 'zpool get' with some suplimental
data that is hardcoded. There is no better way to get this informatio aside
from reading the code.
u allocu allocatedu expandu
autoexpandu replaceu autoreplaceu listsnapsu
listsnapshotsu fragu
fragmentationu capacity-allocu
capacity-freeu operations-readu operations-writeu
bandwith-readu bandwith-writeu readu writeu cksumu capu editu sizeu typeu <size>u valuesu numericu <count>( R, R< RF ( t
property_datat zpool_size_extrat zpool_numeric_extraR$ ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyR- ? s,
c C@ sV t t � i
d d 6d d 6d d 6d d 6d d
6d d 6d
d 6d d 6d d 6d d 6� S( u]
Return a dict of zfs properties
.. note::
Each property will have an entry with the following info:
- edit : boolean - is this property editable after pool creation
- inherit : boolean - is this property inheritable
- type : str - either bool, bool_alt, size, numeric, or string
- values : str - list of possible values
.. warning::
This data is probed from the output of 'zfs get' with some suplimental
data that is hardcoded. There is no better way to get this informatio aside
from reading the code.
u availu availableu lrefer.u logicalreferencedu lused.u logicalusedu referu
referencedu volblocku volblocksizeu compressu compressionu rdonlyu readonlyu recsizeu
recordsizeu refreservu refreservationu reservu reservation( R, R; ( ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyR. w s c C@ s. | d k r d } n | r* t | � } n | S( u+
Convert zfs numeric to python int
u noneN( R? t
str_to_num( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt from_numeric� s
c C@ s% t | � } | d k r! d } n | S( u+
Convert python int to zfs numeric
u noneN( Rc R? ( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt
to_numeric� s c C@ sC | d k r t } n* | d k r* t } n | d k r? d } n | S( u)
Convert zfs bool to python bool
u onu yesu offu nou none( u onu yes( u offu noN( R RF R? ( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyR! � s c C@ s
t | � S( u-
Convert zfs bool_alt to python bool
( R! ( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt
from_bool_alt� s c C@ sI t | � } t | t � r0 | r' d n d } n | d k rE d } n | S( u0
Convert python bool to zfs on/off bool
u onu offu noneN( R! RB t boolR? ( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt to_bool� s c C@ sI t | � } t | t � r0 | r' d n d } n | d k rE d } n | S( u,
Convert python to zfs yes/no value
u yesu nou noneN( Re RB Rf R? ( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt to_bool_alt� s c C@ s� t j t | � � } | r� | j d � j � d } t | j d � � } t j d t j | � d � } | | } t
| � | k r� t
| � } q� n | d k r� t | � } n t | � S( u@
Convert zfs size (human readble) to python int (bytes)
i i i i N(
t re_zfs_sizet matcht strt groupt uppert floatt matht powt zfs_sizeR t intR? Rc ( R3 t
match_sizet v_unitt v_sizet v_multiplier( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt from_size� s
c C@ s t | � } | d k r! d } n t | t � r| d k r| rt t j t j | d � � � } t j d | � } t | � | } | t | � k r� d j
| t | d � } qxP d d d g D]< } | j
| t | d � } t | � d k r� | } Pq� q� Wn | S( u�
Convert python int (bytes) to zfs size
NOTE: http://src.illumos.org/source/xref/illumos-gate/usr/src/lib/pyzfs/common/util.py#114
u nonei u {:.0f}{}i u {:.2f}{}u {:.1f}{}i N(
Rw R? RB R Rr Ro t floort logRp Rn R1 Rq R ( R3 R5 t v_powerRv t v_size_floatt v_precisionRu ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt to_size� s& !! c C@ sn | d k r d } n | rj t | � } | j d � rU | j d � rU | d d !} n | j d d � } n | S( u;
Decode zfs safe string (used for name, path, ...)
u noneu "i i����u \"N( R? Rk R t endswitht replace( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt from_str s c C@ s] t | � } | rD | j d d � } d | k rY d | d } qY n | d k rY d } n | S( u;
Encode zfs safe string (used for name, path, ...)
u "u \"u u noneN( R� R R? ( R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyRD ! s c C@ s t d | | | � S( u+
Convert zfs value to python value
u from( R7 ( R R3 R4 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt from_auto1 s c C@ s t d | | | | � S( u+
Convert python value to zfs value
u to( R7 ( R R3 R4 R5 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyRE 8 s c C@ s7 x0 | j � D]" \ } } t | | | � | | <q
W| S( uk
Pass an entire dictionary to from_auto
.. note::
The key will be passed as the name
( t itemsR� ( R R4 R R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt from_auto_dict? s c C@ s: x3 | j � D]% \ } } t | | | | � | | <q
W| S( uh
Pass an entire dictionary to to_auto
.. note::
The key will be passed as the name
( R� RE ( R R4 R5 R R3 ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt to_auto_dictM s c C@ s t | � j d � d k S( u0
Check if name is a valid snapshot name
u @i ( R� t count( R ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt is_snapshotZ s c C@ s t | � j d � d k S( u0
Check if name is a valid bookmark name
u #i ( R� R� ( R ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt is_bookmarka s c C@ s t | � o t | � S( u<
Check if name is a valid filesystem or volume name
( R� R� ( R ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt
is_dataseth s c C@ s: t d d | d | d | d | d | d | d d
d | �S( u�
Build and properly escape a zfs command
.. note::
Input is not considered safe and will be passed through
to_auto(from_auto('input_here')), you do not need to do so
your self first.
u zfsRG RH RI RJ RK RL RM RN N( RS R? ( RG RH RI RJ RK RL RN ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt zfs_commando s c C@ s: t d d | d | d | d | d | d | d | d | �S(
u�
Build and properly escape a zpool command
.. note::
Input is not considered safe and will be passed through
to_auto(from_auto('input_here')), you do not need to do so
your self first.
u zpoolRG RH RI RJ RK RL RM RN ( RS ( RG RH RI RJ RK RL RM RN ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt
zpool_command� s c C@ s t � } | r& | d d k | | <n | d d k rg | d <x� | d j � D]� } | j � j d � rp Pn | j � j d � r� | j d d � } n | j � j d � r� | j d
d � } n | d j | � qQ W| d r� d j | d � | d <q| d =n | S(
ug
Parse the result of a zpool/zfs command
.. note::
Output on failure is rather predicatable.
- retcode > 0
- each 'error' is a line on stderr
- optional 'Usage:' block under those with hits
We simple check those and return a OrderedDict were
we set label = True|False and error = error_messages
u retcodei u erroru stderru usage:u use '-f'u -fu
force=Trueu use '-r'u -ru recursive=Trueu
( R t
splitlinesR' R R R@ R ( t rest labelt rett error( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt parse_command_result� s"
(B t __doc__t
__future__R R R RX t reRo t loggingt numbersR t salt.utils.decoratorsR t real_memoizet salt.utils.odictR t salt.utils.stringutilsR Rb t salt.modules.cmdmodR
t salt.ext.six.movesR t compileRi Rq t getLoggert __name__Ry R R R R R R% R? R, R R7 R; R< RS R\ R^ R- R. Rc Rd R! Re Rg Rh Rw R} R� RD R� RE R� R� R� R� R� R� R� R� ( ( ( s2 /usr/lib/python2.7/site-packages/salt/utils/zfs.pyt <module> sl
* S 8"
#
Mini Shell