Current File : //lib/python2.7/site-packages/salt/modules/btrfs.pyc
�
���^c @@ sK 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
Z d d l m Z d d l
m Z d � Z d � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z e e d � Z d � Z d � Z! d � Z" d � Z# d d d � Z% d S( u)
Module for managing BTRFS file systems.
i ( t absolute_importt print_functiont unicode_literalsN( t CommandExecutionError( t sixc C@ s& t j j j � o% t j d � d k S( u)
Only work on POSIX-like systems
u kernelu Linux( t saltt utilst platformt
is_windowst
__grains__t get( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt __virtual__% s c C@ sQ t d d � } | j d � r2 t | d � � n i | d j d d � d d 6S( uk
Return BTRFS version.
CLI Example:
.. code-block:: bash
salt '*' btrfs.version
u cmd.run_allu btrfs --versionu stderru stdoutu i i����u version( t __salt__R
R t split( t out( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt version, s
c C@ s i } xg | j d � D] } | r | ^ q d D]� } | j d � r� t j d d | � } g | j d � D] } | j � ^ qm \ } } | d k r� | p� d | d <| | d <q3 n | j d
� r3 t j d | j � � } | d } i | d d
6| d d 6| d d 6| | <q3 q3 W| S( u'
Parse BTRFS device info data.
u
i����u Label:u Label:\s+u u uuid:u noneu labelu uuidu devidu \s+i u device_idi u sizei u usedN( R
t
startswitht ret subt stript None( t datat rett linet tknt labelt uuid_t dev_datat dev_id( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _parse_btrfs_info< s 3.
c C@ s: t d d j | � � } t j j j | � t | d � S( u~
Get BTRFS filesystem information.
CLI Example:
.. code-block:: bash
salt '*' btrfs.info /dev/sda1
u cmd.run_allu btrfs filesystem show {0}u stdout( R t formatR R t fsutilst _verify_runR ( t deviceR ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt infoU s
c C@ s@ t d d � } t j j j | � t j j j | d d d �S( u�
Get known BTRFS formatted devices on the system.
CLI Example:
.. code-block:: bash
salt '*' btrfs.devices
u cmd.run_allu blkid -o exportu stdoutt fs_typeu btrfs( R R R R R t
_blkid_output( R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt devicese s
c C@ sH t d d j | � � } i | d 6| d d 6| d p< t d 6t d 6S( u/
Defragment only one BTRFS mountpoint.
u cmd.run_allu" btrfs filesystem defragment -f {0}u mount_pointu stderru passedu logu range( R R t False( t
mountpointR ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _defragment_mountpointu s c C@ s_ t j j j | � } t j j j d � } | rX | j | � rX t d j | � � � n g } | r� x� | | D] } | j t | d � � qo Wn� t
} xB t j | � D]1 } x( | D] } | | d k r� t
} Pq� q� Wq� Wt | � } | r| d rd | d k rd | d <n | sNt
| d <t j j | � rA| pDt
| d <n | j | � | S( u�
Defragment mounted BTRFS filesystem.
In order to defragment a filesystem, device should be properly mounted and writable.
If passed a device name, then defragmented whole filesystem, mounted on in.
If passed a moun tpoint of the filesystem, then only this mount point is defragmented.
CLI Example:
.. code-block:: bash
salt '*' btrfs.defragment /dev/sda1
salt '*' btrfs.defragment /path/on/filesystem
u btrfsu Device "{0}" is not mountedu mount_pointu passedu range ioctl not supportedu logu< Range ioctl defragmentation is not supported in this kernel.u range( R R R t
_is_devicet _get_mountsR
R R t appendR( R& R t
itervaluest Truet ost patht exists( R/ t is_devicet mountst resultt mount_pointt
is_mountpointt mountpointst mpntt d_res( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt
defragment� s,
"
%
c C@ s� t d d � } t j j j | � i } xk g | d j d � D]' } d | k r@ t j d d | � ^ q@ D]( } | j d d � \ } } | | | <qk W| S( u�
List currently available BTRFS features.
CLI Example:
.. code-block:: bash
salt '*' btrfs.mkfs_features
u cmd.run_allu mkfs.btrfs -O list-allu stderru
u - u \s+u i ( R R R R R R
R R ( R R R t optiont description( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt features� s
Hc C@ s/ i } x"| j d � d D]
} g t j d d | � j d d � D] } | j � rB | j � ^ qB } t | � d k r t j d d | d � j d d
� j � } | d k r| d j d
� } | d j � | | <| d j d d � j d � } | d | d j | | d � <q'| d | | <q q W| S( u
Parse usage/overall.
u
i u \s+u u :i u [()]u i u _u free_estimatedu global_reserveu (u )u : u {0}_{1}( u free_estimatedu global_reserve( R
R R R t lent replacet lowerR ( t rawR R t itemt keysett keyt subk( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _usage_overall� s F+ !c C@ s� d � } | j d � } | d j d � \ } } } | j d d � j d d � j � } i } i | | <x7 | | g D]) } | | j | | j d d � � � qu Wx> | d D]2 } | | j | t j d
d | j � � � � q� W| S( u
Parse usage/specific.
c S@ s t t | j d � � g � S( Nu :( t dictt tupleR
( t val( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt <lambda>� s u
i u u ,u _u :u i u \s+( R
R> R? t updateR R R ( R@ t get_keyt sectiont sizet usedR RH R% ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _usage_specific� s $
'0c C@ ss i } xf | j d � d D]Q } t j d d | j � � j d � } t | � d k r | d | | d <q q W| S( u"
Parse usage/unallocated.
u
i u \s+u i i ( R
R R R R= ( R@ R R RB ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _usage_unallocated� s $c C@ s� t d d j | � � } t j j j | � i } xr | d j d � D]] } | j d � rn t | � | d <qF | j d � r� t | � | d <qF | j
t | � � qF W| S( u�
Show in which disk the chunks are allocated.
CLI Example:
.. code-block:: bash
salt '*' btrfs.usage /your/mountpoint
u cmd.run_allu btrfs filesystem usage {0}u stdoutu
u Overall:
u overallu
Unallocated:
u unallocated( R R R R R R R
R RE RP RJ RO ( R/ R R RL ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt usage� s
c O@ s� | s t d � � n t j j j d � } x5 | D]- } | j | � r1 t d j | � � � q1 q1 Wd g } | j d � } | j d � } t | � d k r� | r� | j d � n | r| j d � qn> | r� | j d
j | � � n | r| j d j | � � n x� d( d) d* d+ d, d- d. g D]r \ } } | d k rb| | k rbd j | d � | d <n | j | � r$| j d j | | j | � � � q$q$W| j d � r�| j d j | j d � t k r�t
j � p�| j d � � � n | j d � r | j d � n | j d � s*| j d! � n | j | � t
d" d# j | � � } t j j j | � i | d$ d% 6}
|
j t
d& | d' � � |
S(/ u2
Create a file system on the specified device. By default wipes out with force.
General options:
* **allocsize**: Specify the BTRFS offset from the start of the device.
* **bytecount**: Specify the size of the resultant filesystem.
* **nodesize**: Node size.
* **leafsize**: Specify the nodesize, the tree block size in which btrfs stores data.
* **noforce**: Prevent force overwrite when an existing filesystem is detected on the device.
* **sectorsize**: Specify the sectorsize, the minimum data block allocation unit.
* **nodiscard**: Do not perform whole device TRIM operation by default.
* **uuid**: Pass UUID or pass True to generate one.
Options:
* **dto**: (raid0|raid1|raid5|raid6|raid10|single|dup)
Specify how the data must be spanned across the devices specified.
* **mto**: (raid0|raid1|raid5|raid6|raid10|single|dup)
Specify how metadata must be spanned across the devices specified.
* **fts**: Features (call ``salt <host> btrfs.features`` for full list of available features)
See the ``mkfs.btrfs(8)`` manpage for a more complete description of corresponding options description.
CLI Example:
.. code-block:: bash
salt '*' btrfs.mkfs /dev/sda1
salt '*' btrfs.mkfs /dev/sda1 noforce=True
u No devices specifiedu btrfsu" Device "{0}" should not be mountedu
mkfs.btrfsu dtou mtoi u -d singleu -m singleu -d {0}u -m {0}u -lu leafsizeu -Lu labelu -Ou ftsu -Au allocsizeu -bu bytecountu -nu nodesizeu -su
sectorsizeu '{0}'u {0} {1}u uuidu -U {0}u nodiscardu -Ku noforceu -fu cmd.run_allu u stdoutu logu
btrfs.infoi ( u -lu leafsize( u -Lu label( u -Ou fts( u -Au allocsize( u -bu bytecount( u -nu nodesize( u -su
sectorsize( R R R R R* R
R R= R+ R- t uuidt uuid1t extendR t joinR RJ ( R% t kwargsR2 R! t cmdt dtot mtoRC R: R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt mkfs sJ !
)C
c C@ s4 | d k rr t j j j | � s9 t d j | � � � n t j j j d � j | � s� t d j | � � � q� ng t | � d k s� | d d k s� | d d k s� t j
d
d | d d � r� t d
j | � � � n t d d j | | � � } t j j j | � i | d d 6} | j
t d | � � | S( uY
Resize filesystem.
General options:
* **mountpoint**: Specify the BTRFS mountpoint to resize.
* **size**: ([+/-]<newsize>[kKmMgGtTpPeE]|max) Specify the new size of the target.
CLI Example:
.. code-block:: bash
salt '*' btrfs.resize /mountpoint size=+1g
salt '*' btrfs.resize /dev/sda1 size=max
u maxu) Mountpoint "{0}" should be a valid deviceu btrfsu Device "{0}" should be mountedi i u -+i����u kKmMgGtTpPeEu \du i u? Unknown size: "{0}". Expected: [+/-]<newsize>[kKmMgGtTpPeE]|maxu cmd.run_allu btrfs filesystem resize {0} {1}u stdoutu logu
btrfs.info( R R R R) R R R* R
R= R R R R RJ ( R' RM R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt resizee s "- c C@ se i d d 6d d 6d d 6d d 6d d
6d d 6d
d 6d d 6} | j t d d j | � � d d � S( u�
Check an ext2/ext3/ext4 file system.
This is forced check to determine a filesystem is clean or not.
NOTE: Maybe this function needs to be moved as a standard method in extfs module in a future.
u No errorsi u Filesystem errors correctedi u System should be rebootedi u" Filesystem errors left uncorrectedi u Operational errori u Usage or syntax errori u Fsck canceled by user requesti u Shared-library errori� u cmd.run_allu fsck -f -n {0}u retcodeu
Unknown error( R
R R ( R! t msgs( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _fsck_ext� s
c
C@ s� t d d � } t j j j | � t j j j | d � } | j | � sc t d j | � � � n | | d d k r� t d j | | | d � � � n t j j j | | d � j | i d! d
6g � d j d
� } | d k r� t d
� � n t j j j t d d j | � � � i i t | � d 6| d
6| | d d 6d 6} t j j j t d d j | � � � t j j j t d d j | | � � � t d d � } t j j j | � t j j j | d � } i d d 6| d
6| | d d 6| d <d j | � } | d d } t j
j | � sDt d j | � � � n | s�| | d d j | � <t j d j | � � j � j � | d d j | � <n� d | d d j | � <d | d d j | � <t j j j t d d j | � � � t d d j | � � } t j j j | � | d | d d <d j | � } t j
j | � r|| r|t j j j t d d j | � � � n | S(" u�
Convert ext2/3/4 to BTRFS. Device should be mounted.
Filesystem can be converted temporarily so the further processing and rollback is possible,
or permanently, where previous extended filesystem image gets deleted. Please note, permanent
conversion takes a while as BTRFS filesystem needs to be properly rebalanced afterwards.
General options:
* **permanent**: Specify if the migration should be permanent (false by default)
* **keeplf**: Keep ``lost+found`` of the partition (removed by default,
but still in the image, if not permanent migration)
CLI Example:
.. code-block:: bash
salt '*' btrfs.convert /dev/sda1
salt '*' btrfs.convert /dev/sda1 permanent=True
u cmd.run_allu blkid -o exportu stdoutu" The device "{0}" was is not found.u typeu ext2u ext3u ext4u( The device "{0}" is a "{1}" file system.u mount_pointi u /ub One does not simply converts a root filesystem!
Converting an extended root filesystem to BTRFS is a careful
and lengthy process, among other steps including the following
requirements:
1. Proper verified backup.
2. System outage.
3. Offline system access.
For further details, please refer to your OS vendor
documentation regarding this topic.
u
umount {0}u fsck_statusu beforeu btrfs-convert {0}u
mount {0} {1}u N/Au afteru {0}/ext2_savedu6 BTRFS migration went wrong: the image "{0}" not found!u {0}_imageu file {0}/imageu {0}_image_infou removedu btrfs subvolume delete {0}u btrfs filesystem balance {0}u balance_logu {0}/lost+foundu
rm -rf {0}( u ext2u ext3u ext4N( R R R R R R$ R
R R R* R R] R. R/ R0 t popent readR (
R! t permanentt keeplfR R% R' R t
image_patht orig_fstypet
lost_found( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt convert� s^ # &
&)2&)c O@ s� g } t j j j | � r3 t d j | � � � n t } xW t j t j j j d � � D]7 \ } } x( | D] } | d | k rk t
} Pqk qk WqX W| s� t d j | � � � n | s� t d � � n t d � } x; | D]3 } | t j | � k r� t d j | � � � q� q� Wd j | � g }
x | D] } |
j
| � q*W| d k r�| j d
� rl|
j
d � n | j d � r�|
j
d
� q�n |
j
| � t d d j |
� � } t j j j | � | d r�| j
| d � n | d k r�d } | j d � } | j d � }
| rC|
rCt d d j | |
| � � } n t d d j | � � } t j j j | � | d r�| j
| d � q�n i } | r�| j i d j | � d 6� n | j t d | � � | S( uW
Restripe BTRFS: add or remove devices from the particular mounted filesystem.
u1 Mountpount expected, while device "{0}" specifiedu btrfsu mount_pointu+ No BTRFS device mounted on "{0}" mountpointu No devices specified.u
btrfs.devicesu Device "{0}" is not recognizedu btrfs device {0}u addu nodiscardu -Ku forceu -fu cmd.run_allu u stdoutu dcu mcu3 btrfs balance start -dconvert={0} -mconvert={1} {2}u btrfs filesystem balance {0}u
u logu
btrfs.infoN( R R R R) R R R& R t iteritemsR* R- R t iterkeysR+ R
RU R R RJ ( R' t directionR% RV t fs_logt mountedR! t mntpointst mntdatat available_devicesRW R t data_conversiont meta_conversionR ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _restripe sb +
c O@ s t | d | | � S( u$
Add a devices to a BTRFS filesystem.
General options:
* **nodiscard**: Do not perform whole device TRIM
* **force**: Force overwrite existing filesystem on the disk
CLI Example:
.. code-block:: bash
salt '*' btrfs.add /mountpoint /dev/sda1 /dev/sda2
u add( Rp ( R' R% RV ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt addG s c O@ s t | d | | � S( u�
Remove devices from a BTRFS filesystem.
CLI Example:
.. code-block:: bash
salt '*' btrfs.delete /mountpoint /dev/sda1 /dev/sda2
u delete( Rp ( R' R% RV ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt deleteY s
c C@ s` i } xS | j d � D]B } t j d | d � } t | � d k r | d | | d <q q W| S( u
Parse properties list.
u
u \s+i i i ( R
R R= ( R R R ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt _parse_proplistf s c
C@ s� | r* | d k r* t d j | � � � n d
g } | j d � | j | rR d pU d
� | rx | j d j | � � n | j | � | r#ys xl g | j d � D]. } g | j d � D] } | j � ^ q� ^ q� D]& \ } } | j | � | j | � q� WWq#t k
r } t | � � q#Xn t d d j | � � } t j j
j | � | s�i }
x t j
t | d � � D]d \ } } i | d 6|
| <t d d j | | � � d } | r�| j d � d p�d |
| d <quW|
Sd S( uM
List properties for given btrfs object. The object can be path of BTRFS device,
mount point, or any directories/files inside the BTRFS filesystem.
General options:
* **type**: Possible types are s[ubvol], f[ilesystem], i[node] and d[evice].
* **force**: Force overwrite existing filesystem on the disk
* **set**: <key=value,key1=value1...> Options for a filesystem properties.
CLI Example:
.. code-block:: bash
salt '*' btrfs.properties /mountpoint
salt '*' btrfs.properties /dev/sda1 type=subvol set='ro=false,label="My Storage"'
u su subvolu fu
filesystemu iu inodeu du deviceu& Unknown property type: "{0}" specifiedu btrfsu propertyu setu listu -t{0}u ,u =u cmd.run_allu u stdoutu descriptionu btrfs property get {0} {1}i����u N/Au valueN( u su subvolu fu
filesystemu iu inodeu du device( R R R+ R
R t ExceptionR RU R R R R R Rf Rs (
t objt typet setRW RB RA RC t valuet exR R t propt descr( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt
propertiess s4
K
&+(& t __doc__t
__future__R R R R. R RR t salt.utils.fsutilsR t salt.utils.platformt salt.exceptionsR t salt.extR R R R R" R% R( R9 R< RE RO RP RQ RZ R[ R] R& Re Rp Rq Rr Rs R R| ( ( ( s6 /usr/lib/python2.7/site-packages/salt/modules/btrfs.pyt <module> s:
,
S # e E
Mini Shell