Sindbad~EG File Manager
3
x?ag� � @ st d Z ddlmZ ddlmZ ddlmZ ddlZddlZddlmZ ddl m
Z
m Z ej d � G d
d � d ej �Z
dS ) z�
VDOArgumentParser - argument parser for vdo command input
$Id: //eng/vdo-releases/aluminum/src/python/vdo/vdomgmnt/VDOArgumentParser.py#19 $
� )�absolute_import)�division)�print_functionN� )� Constants)�
ArgumentError�DefaultsZvdoc s e Zd ZdZed�jdjdd� ejdd_� D ��ej ejd` d�Z
ed �jdjd
d� ej dda� D ��ej ej db d�Z
G d d � d ej�ZG d
d� dej�Zdc� fdd� Z� fdd�Zdd� Zdd� Zdddd�Zdedd�Zd d � Zd d � Zd d!� Zd"d#� Z d$d%� Z d&d'� Z d(d)� Z dfd*d+�Z d,d-� Z!d.d/� Z"d0d1� Z#dgd2d3�Z$d4d5� Z%dhd7d8�Z&d9d:� Z'd;d<� Z(did=d>�Z)djd?d@�Z*dkdAdB�Z+dldCdD�Z,dmdEdF�Z-dndGdH�Z.dodIdJ�Z/dpdKdL�Z0dMdN� Z1dqdOdP�Z2dQdR� Z3dSdT� Z4drdUdV�Z5e6dWdX� �Z7dYdZ� Z8dsd[d\�Z9d]d^� Z:� Z;S )t�VDOArgumentParserz�Argument parser for the vdo command.
Attributes:
lvmOptionalSuffix (str): describes usage of lvm suffixes
lvmOptionalSiSuffix (str): describes usage of lvm SI suffixes
z;Using a value with a {options} or {last} suffix
is optionalz, c C s g | ]}t j| �qS � )r �lvmSuffixTextMap)�.0�suffixr
r
�'/usr/lib/python3.6/VDOArgumentParser.py�
<listcomp>: s z VDOArgumentParser.<listcomp>Nr )�optionsZlastz;Using a value with a {options} or {last}
suffix is optionalc C s g | ]}t j| �qS r
)r �lvmSiSuffixTextMap)r r
r
r
r r B s c s. e Zd ZdZ� fdd�Zd� fdd� Z� ZS )z'VDOArgumentParser.CommandArgumentParserz�Argument parser type to use for commands.
Provides command-identifying "unrecognized arguments" error rather
than having the unrecognized arguments bubble up to the root parser and
result in a non-specific "unrecognized arguments" error.
c s t tj| �j||� d| _d S )NF)�superr �CommandArgumentParser�__init__� _redirected)�self�args�kwargs)� __class__r
r r R s z0VDOArgumentParser.CommandArgumentParser.__init__Nc sD d}| j s,d| _ | j||�}d| _ |g f}nttj| �j||�}|S )z�Redirects the command's argument parsing through parse_arg()
which will, if there are unknown arguments, result in a cmmand-specific
"unrecognized arguments" message.
NTF)r �
parse_argsr r r �parse_known_args)r r � namespace�result)r r
r r X s
z8VDOArgumentParser.CommandArgumentParser.parse_known_args)NN)�__name__�
__module__� __qualname__�__doc__r r �
__classcell__r
r
)r r r J s r c @ s e Zd ZdZddd�ZdS )z&VDOArgumentParser.ExclusiveStoreActionz�Action type to use for commands.
Provides a class to store a string into a namespace as specified,
returning an error if it's already set.
Nc C s> t || j| j�| jk r,|jtd�j| j�� t|| j|� d S )Nz)option '{0}' was specified more than once)�getattr�dest�default�error�_�format�setattr)r �parserr �valuesZ
option_stringr
r
r �__call__q s
z/VDOArgumentParser.ExclusiveStoreAction.__call__)N)r r r r! r, r
r
r
r �ExclusiveStoreActionj s r- c s t t| �j||�}| j|� |S )N)r r r �#_VDOArgumentParser__postParseChecks)r r r )r r
r r ~ s
z VDOArgumentParser.parse_argsc s" |j d�d krtd�|d< tt| �j||� | jddddtjd�}| j� | _| j � | _
td�}td�j |�}|j d| j
| jg||d �| _
td
�}td�j |�}|j d | j
| jd d
�| jg||d �| _td�}td�j |�}|j d| j� | jd d
�| jg||d �| _td�}td�j |tj�}|j d| j� | j� | j� | j� | j� | j� | j� | j� | j� | j � | j � | j � | j � | j � | j!� | j"� | j#� | j$� | j%� | j&� | j'� | j(� | j)� | j� | jg||d �| _*td�}td�j |�}|j d| j
| jg||d �| _+td�}td�j |�}|j d| j
| jg||d �| _,td�}td�j |�}|j d | j
| jg||d �| _-td �}td �j |�}|j d | j
| jg||d �| _.td �}td!�j |�}|j d"| j
| jg||d �| _/td#�}td�j |�}|j d$| j� | j%d d
�| jg||d �| _0td%�}td�j |�}|j d&| j� | jg||d �| _1td'�}td(�j |tj�}|j d)| j� | j� | j� | j� | j� | j� | j� | j� | j � | j � | j � | j!� | j"� | j#� | j$� | j&� | j'� | j(� | j� | jg||d �| _2td*�}td�j |�}|j d+| j3� | jg||d �| _4td,�}td�j |�}d-d.d/d0d1d2d3d4d5d6d7g | _5|j d8| j
| jd d9�| jd d9�| j d d9�| j d d9�| j d d9�| j!d d9�| j"d d9�| j#d d9�| j$d d9�| j&d d9�| j(d d9�| jg
||d �| _6td:�}td;�j |�}|j d<| jg||d �| _7td=�}td>�}td�j |�}|j d?| j
| j� | jg||d �| _8td@�}td�j |�}|j dA| j
| j9� | jg||d �| _:tdB�}td;�j |�}|j dC| j dDd
�| j;� | jg||d �| _<td=�}tdE�}td�j |�}|j dF| j
| j� | jg||d �| _=td=�}tdG�}tdH�j |�}|j dI| jg||d �| _>d S )JN� descriptiona
Manage kernel VDO devices and related configuration information. For
help on individual commands specify the command followed by --help.
Unless otherwise noted all commands must be run with root privileges.
zmanagement commands�command)�title�helpr$ �metavarZ parser_classz�
Activates one or more VDO volumes. Activated volumes can be started
using the 'start' command.
zN
{0} This command must be run with root privileges.
�activate)�parentsr2 r/ zZ
Modifies the write policy of one or all running VDO volumes.
ZchangeWritePolicyT)�requiredz�
Converts a VDO volume so it can be managed by LVM. Converted volumes
cannot be reverted back.
z�
{0} This command is intended to be used by LVM. Do not call this
directly unless you are sure what you are doing. This command must
be run with root privileges.
Zconvertzc
Creates a VDO volume and its associated index and makes it available.
a�
{0} If --activate={1} is specified the VDO volume is created but not made
available. If the specified device is already in use by a VDO volume (as
determined from the configuration file) the create will always be
rejected, even if --force is specified. If the device is not so in use
but is formatted as a VDO volume or contains an existing file system
the create will be rejected unless --force is given.
Zcreatez�
Deactivates one or more VDO volumes. Deactivated volumes cannot be
started by the 'start' command. Deactivating a currently running
volume does not stop it.
z�
{0} Once stopped a deactivated VDO volume must be activated before
it can be started again. This command must be run with root
privileges.
Z
deactivatez�
Disables compression on one or more VDO volumes. If the VDO volume is
running, takes effect immediately.
z�
{0} If the VDO volume is not running compression will be disabled the
next time the VDO volume is started. This command must be run with root
privileges.
ZdisableCompressionz�
Disables deduplication on one more VDO volumes. If the VDO volume is
running, takes effect immediately.
z�
{0} If the VDO volume is not running deduplication will be disabled the
next time the VDO volume is started. This command must be run with root
privileges.
ZdisableDeduplicationz�
Enables compression on one or more VDO volumes. If the VDO volume is
running, takes effect immediately.
z�
{0} If the VDO volume is not running compression will be enabled the
next time the VDO volume is started. This command must be run with root
privileges.
ZenableCompressionz�
Enables deduplication on one or more VDO volumes. If the VDO volume
is running, takes effect immediately.
z�
{0} If the VDO volume is not running deduplication will be enabled the
next time the VDO volume is started. This command must be run with root
privileges.
ZenableDeduplicationzv
Grows the logical size of a VDO volume. The volume must exist and
must be running.
Z growLogicalzw
Grows the physical size of a VDO volume. The volume must exist and
must be running.
Z growPhysicalz�
Creates a VDO volume from an existing VDO formatted storage device by
importing it into VDO manager for use.
a�
{0} NOTE: The following values are not stored on the device and
must be reset via command line parameters if you changed them
from the default value during create: block map cache size,
block map period, compression state, deduplication state,
512 emulation, maximum discard size, and thread configurations.
If --activate={1} is specified the VDO volume is created but not
made available. This command must be run with root privileges.
�importz�
Displays a list of started VDO volumes. If --all is specified it
displays both started and non-started volumes.
�listz�
Modifies configuration parameters of one or all VDO volumes. Changes
take effect the next time the VDO device is started; already-running
devices are not affected.
�blockMapCacheSize�blockMapPeriod�maxDiscardSizeZuuidZ
vdoAckThreadsZvdoBioRotationIntervalZ
vdoBioThreadsZ
vdoCpuThreadsZvdoHashZoneThreadsZvdoLogicalThreadsZvdoPhysicalThreads�modify)� noDefaultz{
Prints the configuration file to stdout. This command does not require
root privileges.
z
{0}
ZprintConfigFilez
z]
Removes one or more stopped VDO volumes and associated indexes.
�removezn
Starts one or more stopped, activated VDO volumes and associated
services.
�startz�
Reports VDO system and volume status in YAML format. This command does
not require root privileges though information will be incomplete if
run without.
ZstatusFz\
Stops one or more running VDO volumes and associated services.
�stopzG
Shows the current version of VDO manager.
zK
{0} This command does not need root privileges.
�version)?�getr' r r r Zadd_subparsersr �_commonOptionsParserZ!_VDOArgumentParser__commonOptions�_namingOptionsParserZ!_VDOArgumentParser__namingOptionsr( Z
add_parserZ_activateCommandParser�_writePolicyOptionParserZ _changeWritePolicyCommandParser�_nameOptionParser�_forceOptionParserZ_convertCommandParserr Zdisabled�_deviceOptionParser�_activateOptionParser� _blockMapCacheSizeOptionParser�_blockMapPeriodOptionParser�_compressionOptionParser�_deduplicationOptionParser�_emulate512OptionParser�_indexMemOptionParser�_maxDiscardSizeOptionParser�_sparseIndexOptionParser�_uuidOptionParser�_vdoAckThreadsOptionParser�#_vdoBioRotationIntervalOptionParser�_vdoBioThreadsOptionParser�_vdoCpuThreadsOptionParser� _vdoHashZoneThreadsOptionParser�_vdoLogicalSizeOptionParser� _vdoLogicalThreadsOptionParser�_vdoLogLevelOptionParser� _vdoPhysicalThreadsOptionParser�_vdoSlabSizeOptionParserZ_createCommandParserZ_deactivateCommandParserZ _disableCompressionCommandParserZ"_disableDeduplicationCommandParserZ _enableCompressionCommandParserZ!_enableDeduplicationCommandParserZ_growLogicalCommandParserZ_growPhysicalCommandParserZ_importCommandParser�_allOptionParserZ_listCommandParser�_changeableModifyOptions�_modifyCommandParserZ _printConfigFileCommandParserZ_removeCommandParser�_forceRebuildOptionParserZ_startCommandParser�_pendingOptionParserZ_statusCommandParserZ_stopCommandParserZ_versionCommandParser)r r r ZsubparserAdderZ
highLevelHelpr/ Z commandText)r r
r r � s,
zVDOArgumentParser.__init__c C s4 t jdd�}|jdtjtjtd�jt j
d�d� |S )NF)�add_helpz
--activatez�
Indicates if the VDO volume should, in addition to being created, be
activated and started. The default is {activate}.
)r4 )�action�choicesr2 ) �argparse�ArgumentParser� add_argumentr r- r �
enableChoicesr' r( r r4 )r r* r
r
r rI s z'VDOArgumentParser._activateOptionParserc C s t jdd�}| j|� |S )NF)rb )re rf �&_VDOArgumentParser__parserAddAllOption)r r* r
r
r r] - s
z"VDOArgumentParser._allOptionParserFc
C sf |rdnt d�jtj�}tjdd�}|jdtj| j tj
�dt d�jtj | j t
jtjtj|d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
� zThe default is {0}.F)rb z--blockMapCacheSizez <megabytes>a�
Specifies the amount of memory allocated for caching block map pages;
the value must be a multiple of {pageSize}. {suffixOptions}. If no
suffix is supplied, the value will be interpreted as {defaultUnits}.
The value must be at least {minCacheSize} and less than
{maxCachePlusOne}. Note that there is a memory overhead of 15%%.
{defaultHelp}
)ZpageSize�
suffixOptions� defaultUnitsZ minCacheSizeZmaxCachePlusOne� defaultHelp)rc �typer3 r2 )r' r( r r9 re rf rg r r- � _VDOArgumentParser__optionCheckZcheckPageCachesz�vdoPhysicalBlockSize�lvmOptionalSiSuffixr �lvmDefaultUnitsTextZblockMapCacheSizeMinZblockMapCacheSizeMaxPlusOne)r r= rm r* r
r
r rJ 3 s
z0VDOArgumentParser._blockMapCacheSizeOptionParserc
C sZ |rdnt d�jtj�}tjdd�}|jdtj| j tj
�dt d�jtj tj |d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default value is {0}.F)rb z--blockMapPeriodz<period>a8
Tunes the quantity of block map updates that can accumulate before
cache pages are flushed to disk. The value must at least {minPeriod}
and less than or equal to {maxPeriod}. A lower value means shorter
recovery time but lower performance. {defaultHelp}
)Z minPeriodZ maxPeriodrm )rc rn r3 r2 )
r' r( r r: re rf rg r r- ro ZcheckBlockMapPeriodZblockMapPeriodMinZblockMapPeriodMax)r r= rm r* r
r
r rK S s z-VDOArgumentParser._blockMapPeriodOptionParserc C s& t jd| j� | j� | j� | j� gd�S )NF)rb r5 )re rf �_confFileOptionParser�_debugOptionParser�_logFileOptionParser�_verboseOptionParser)r r
r
r rC o s
z&VDOArgumentParser._commonOptionsParserc C s8 t jdd�}|jdtjtjtjt d�j
tjd�d� |S )NF)rb z
--compressiona
Enables or disables compression when creating a VDO volume. The default
is {compression}. Compression may be disabled if necessary to maximize
performance or to speed processing of data that is unlikely to compress.
)� compression)rc rd r% r2 ) re rf rg r r- r rh r rw r' r( )r r* r
r
r rL w s z*VDOArgumentParser._compressionOptionParserc
C sB t jdd�}|jddtj| jtj�tjdt d�j
tjd�d� |S ) NF)rb z-fz
--confFilez<file>zj
Specifies an alternate configuration file; the default is {file}.
)�file)rc rn r% r3 r2 ) re rf rg r r- ro r Z
checkConfFileZconfFiler' r( )r r* r
r
r rs � s
z'VDOArgumentParser._confFileOptionParserc C s& t jdd�}|jddddt jd� |S )NF)rb z-dz--debug�
store_true�debug)rc r$ r2 )re rf rg ZSUPPRESS)r r* r
r
r rt � s
z$VDOArgumentParser._debugOptionParserc C s8 t jdd�}|jdtjtjtjt d�j
tjd�d� |S )NF)rb z--deduplicationa!
Enables or disables deduplication when creating a VDO volume. The
default is {deduplication}. Deduplication may be disabled in instances
where data is not expected to have good deduplication rates but
compression is still desired.
)�
deduplication)rc rd r% r2 ) re rf rg r r- r rh r r{ r' r( )r r* r
r
r rM � s z,VDOArgumentParser._deduplicationOptionParserc C s4 t jdd�}|jdtj| jtj�ddtd�d� |S )NF)rb z--devicez <devicepath>Tzj
Specifies the absolute path of the device to use for VDO storage.
)rc rn r3 r6 r2 ) re rf rg r r- ro r Z checkBlkDevr' )r r* r
r
r rH � s
z%VDOArgumentParser._deviceOptionParserc C s4 t jdd�}|jdtjtjtd�jt j
d�d� |S )NF)rb z --emulate512z�
Specifies that the VDO volume is to emulate a 512 byte block device. The
default is {emulate512}.
)�
emulate512)rc rd r2 ) re rf rg r r- r rh r' r( r r| )r r* r
r
r rN � s z)VDOArgumentParser._emulate512OptionParserc C s( t jdd�}|jddd|td�d� |S )NF)rb z--forcery �forcea[
When creating a volume, ignores any existing file system or VDO signature
already present in the storage device. When stopping or removing a VDO
volume, first unmounts the file system stored on the device if mounted.
When converting a volume to be used by LVM, this parameter is required.
)rc r$ r6 r2 )re rf rg r' )r r6 r* r
r
r rG � s
z$VDOArgumentParser._forceOptionParserc C s& t jdd�}|jdddtd�d� |S )NF)rb z--forceRebuildry Z forceRebuildz�
Forces an offline rebuild of a read-only VDO's metadata before starting
so that it may be brought back online and made available. This option
may result in data loss or corruption.
)rc r$ r2 )re rf rg r' )r r* r
r
r r` � s
z+VDOArgumentParser._forceRebuildOptionParserc C sH t jdd�}|jdtj| jtj�tjdt d�j
tjtj tj d�d� |S )NF)rb z
--indexMemz <gigabytes>az
Specifies the amount of index memory in gigabytes; the default is
currently {indexMem} GB. The special decimal values 0.25, 0.5,
0.75 can be used, as can any integer value at least {min} and less
than or equal to {max}. (The special decimal values are matched as
exact strings; "0.5" works but "0.50" is not accepted.)
Larger values will require more disk space. For a dense index,
each gigabyte of index memory will use approximately 11 GB of
storage. For a sparse index, each gigabyte of index memory will
use approximately 100 GB of storage.
)�indexMem�min�max)rc rn r% r3 r2 )
re rf rg r r- ro r Z
checkIndexmemr~ r' r( ZindexMemIntMinZindexMemIntMax)r r* r
r
r rO � s
z'VDOArgumentParser._indexMemOptionParserc C s2 t jdd�}|jdtj| jtj�dtd�d� |S )NF)rb z --logfilez
<pathname>z�
Specify the path of the file to which log messages are directed. If
unspecified, log messages will go to syslog. Warning and error messages
are always logged to syslog.
)rc rn r3 r2 ) re rf rg r r- ro r Z checkLogFiler' )r r* r
r
r ru s
z&VDOArgumentParser._logFileOptionParserc
C sf |rdnt d�jtj�}tjdd�}|jdtj| j tj
�dt d�jtj | j t
jtjtj|d�d � |S )
z�
Arguments:
noDefault (boolean) - if True, no default is provided nor mentioned in
the help text
rj zThe default is {0}.F)rb z--maxDiscardSizez <megabytes>a�
Specifies the maximum discard size VDO can receive. This is used for
performance tuning and support of devices above us. The value must be
a multiple of {blockSize}. {suffixOptions}. If no suffix is supplied,
the value will be interpreted as {defaultUnits}. The value must be at
least {minDiscard} and less than {maxDiscardPlusOne}.
{defaultHelp}
)Z blockSizerk rl Z
minDiscardZmaxDiscardPlusOnerm )rc rn r3 r2 )r' r( r r; re rf rg r r- ro ZcheckMaxDiscardSizerp rq r rr ZmaxDiscardSizeMinZmaxDiscardSizeMaxPlusOne)r r= rm r* r
r
r rP s
z-VDOArgumentParser._maxDiscardSizeOptionParserc C s t jdd�}| j|dd� |S )NF)rb T)r6 )re rf �'_VDOArgumentParser__parserAddNameOption)r r* r
r
r rF 5 s z#VDOArgumentParser._nameOptionParserTc C s, t jdd�j|d�}| j|� | j|� |S )z_
Arguments:
required (boolean) - if True, an argument is required to this parser
F)rb )r6 )re rf Z add_mutually_exclusive_groupri r� )r r6 r* r
r
r rD < s
z&VDOArgumentParser._namingOptionsParserc C s& t jdd�}|jdddtd�d� |S )NF)rb z --pendingry �pendingz�
Shows pending modifications that will take effect upon restart
in the status report of a running VDO volume. Pending modifications are
denoted with square brackets.
)rc r$ r2 )re rf rg r' )r r* r
r
r ra J s
z&VDOArgumentParser._pendingOptionParserc C s4 t jdd�}|jdtjtjtd�jt j
d�d� |S )NF)rb z
--sparseIndexz_
Enables sparse indexing. The default is {sparseIndex}.
)� sparseIndex)rc rd r2 ) re rf rg r r- r rh r' r( r r� )r r* r
r
r rQ X s z*VDOArgumentParser._sparseIndexOptionParserc C sJ |rdnt d�}tjdd�}|jdtj| jtj�dt d�j |d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj z�For newly created volumes, the default is an empty
string (generate a new uuid). For importing existing
volumes, the default is the existing VDO volume's uuid.F)rb z--uuidz<uuid>z�
Sets the UUID of the VDO volume. The value needs to be either a
valid uuid or an empty string. If an empty string is specified, a
new random uuid is generated for the VDO volume.
{defaultHelp}
)rm )rc rn r3 r2 )
r' re rf rg r r- ro r ZcheckUUIDValuer( )r r= rm r* r
r
r rR e s
z#VDOArgumentParser._uuidOptionParserc
C sV |rdn
dj tj�}tjdd�}|jdtj| jtj �dt
d�j tj tj |d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default is {0}.F)rb z--vdoAckThreadsz
<threadCount>z�
Specifies the number of threads to use for acknowledging completion of
requested VDO I/O operations. The value must be at least {min} and less
than or equal to {max}. {defaultHelp}
)r r� rm )rc rn r3 r2 )
r( r Z
ackThreadsre rf rg r r- ro �checkThreadCount0_100r' Z
ackThreadsMinZ
ackThreadsMax)r r= rm r* r
r
r rS s z,VDOArgumentParser._vdoAckThreadsOptionParserc
C sV |rdn
dj tj�}tjdd�}|jdtj| jtj �dt
d�j tj tj |d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default is {0}.F)rb z--vdoBioRotationIntervalz <ioCount>z�
Specifies the number of I/O operations to enqueue for each
bio-submission thread before directing work to the next. The value must
be at least {min} and less than or equal to {max}. {defaultHelp}
)r r� rm )rc rn r3 r2 )
r( r ZbioRotationIntervalre rf rg r r- ro ZcheckRotationIntervalr' ZbioRotationIntervalMinZbioRotationIntervalMax)r r= rm r* r
r
r rT � s z5VDOArgumentParser._vdoBioRotationIntervalOptionParserc C s^ |rdnt d�jtj�}tjdd�}|jdtj| j tj
�dt d�jtj tj tj
|d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default is {0}.F)rb z--vdoBioThreadsz
<threadCount>a?
Specifies the number of threads to use for submitting I/O operations to
the storage device. The value must be at least {min} and less than or
equal to {max}. Each additional thread after the first will use an
additional {threadOverhead} MB of RAM {defaultHelp}
)r r� ZthreadOverheadrm )rc rn r3 r2 )r' r( r Z
bioThreadsre rf rg r r- ro �checkThreadCount1_100Z
bioThreadsMinZ
bioThreadsMaxZbioThreadOverheadMB)r r= rm r* r
r
r rU � s z,VDOArgumentParser._vdoBioThreadsOptionParserc
C sZ |rdnt d�jtj�}tjdd�}|jdtj| j tj
�dt d�jtj tj |d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default is {0}.F)rb z--vdoCpuThreadsz
<threadCount>z�
Specifies the number of threads to use for CPU-intensive work such as
hashing or compression. The value must be at least {min} and less than
or equal to {max}. {defaultHelp}
)r r� rm )rc rn r3 r2 )
r' r( r Z
cpuThreadsre rf rg r r- ro r� Z
cpuThreadsMinZ
cpuThreadsMax)r r= rm r* r
r
r rV � s z,VDOArgumentParser._vdoCpuThreadsOptionParserc
C sV |rdn
dj tj�}tjdd�}|jdtj| jtj �dt
d�j tj tj |d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default is {0}.F)rb z--vdoHashZoneThreadsz
<threadCount>a�
Specifies the number of threads across which to subdivide parts of the
VDO processing based on the hash value computed from the block data.
The value must be at least {min} and less than or equal to {max}.
vdoHashZonesThreads, vdoLogicalThreads and vdoPhysicalThreads must be
either all zero or all non-zero. {defaultHelp}
)r r� rm )rc rn r3 r2 )
r( r �hashZoneThreadsre rf rg r r- ro r� r' ZhashZoneThreadsMinZhashZoneThreadsMax)r r= rm r* r
r
r rW � s z1VDOArgumentParser._vdoHashZoneThreadsOptionParserc C sZ |rdn
dj tj�}tjdd�}|jdtj| jtj �dt
d�j tj tj tj
|d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default is {0}.F)rb z--vdoLogicalThreadsz
<threadCount>a�
Specifies the number of threads across which to subdivide parts of the
VDO processing based on the logical address. The value must be at least
{min} and less than or equal to {max}. A logical thread count of
{threshold} or more will require explicitly specifying a sufficiently
large block map cache size.
vdoHashZonesThreads, vdoLogicalThreads and vdoPhysicalThreads must be
either all zero or all non-zero. {defaultHelp}
)r r� Z thresholdrm )rc rn r3 r2 )r( r r� re rf rg r r- ro ZcheckLogicalThreadCountr' ZlogicalThreadsMinZlogicalThreadsMaxZ(logicalThreadsBlockMapCacheSizeThreshold)r r= rm r* r
r
r rY s z0VDOArgumentParser._vdoLogicalThreadsOptionParserc
C sb |rdnt d�}tjdd�}|jdtj| jtj�|r8dnd|dt d �j t
j | j tj
|d
�d � |S ) z�
Arguments:
required (boolean) - if True, no default is provided nor mentioned in
the help text
rj z.The default is the size of the storage device.F)rb z--vdoLogicalSizeN�0z <megabytes>z�
Specifies the logical VDO volume size in {defaultUnits}.
{suffixOptions}. Used for over-provisioning volumes. The maximum size
supported is {max}. {defaultHelp}
)rl rk r� rm )rc rn r% r6 r3 r2 )r' re rf rg r r- ro r ZcheckLogicalSizer( r rr �lvmOptionalSuffixZlogicalSizeMax)r r6 rm r* r
r
r rX $ s
z-VDOArgumentParser._vdoLogicalSizeOptionParserc C s8 t jdd�}|jdtjtjtjtd�j tjd�d� |S )NF)rb z
--vdoLogLevelz�
Specifies the VDO driver log level. Levels are case-sensitive. The
default is {logLevel}.
)ZlogLevel)rc rd r% r2 )
re rf rg r r- r ZvdoLogLevelChoicesZ vdoLogLevelr' r( )r r* r
r
r rZ A s z*VDOArgumentParser._vdoLogLevelOptionParserc C s^ |rdnt d�jtj�}tjdd�}|jdtj| j tj
�dt d�jtj tj tj
|d�d � |S )
zb
Arguments:
noDefault (boolean) - if True, no default is mentioned in the help text
rj zThe default is {0}.F)rb z--vdoPhysicalThreadsz
<threadCount>a]
Specifies the number of threads across which to subdivide parts
of the VDO processing based on physical block addresses. The
value must be at least {min} and less than or equal to {max}.
The value must also be less than or equal to the slab count
(which can be found via the 'status' command after device
creation). Each additional thread after the first will use an
additional {overhead} MB of RAM. vdoPhysicalThreads,
vdoHashZonesThreads and vdoLogicalThreads must be either all
zero or all non-zero. {defaultHelp}
)r r� Zoverheadrm )rc rn r3 r2 )r' r( r ZphysicalThreadsre rf rg r r- ro ZcheckPhysicalThreadCountZphysicalThreadsMinZphysicalThreadsMaxZphysicalThreadOverheadMB)r r= rm r* r
r
r r[ P s
z1VDOArgumentParser._vdoPhysicalThreadsOptionParserc
C sP t jdd�}|jdtj| jtj�tjdt d�j
tj tj tj| j
tjd�d� |S )NF)rb z
--vdoSlabSizez <megabytes>a
Set the free space allocator's slab size. Must be a power of two between
{minSize} and {maxSize}; the default is {defaultSlabSize}.
{suffixOptions}. If no suffix is used, the value will be interpreted as
{defaultUnits}. This allocator manages the space VDO uses to store user
data.
The maximum number of slabs in the system is 8192, so this value
determines the maximum physical size of a VDO volume. One slab is the
minimum amount by which a VDO volume can be grown. Smaller slabs also
increase the potential for parallelism if the device has multiple
physical threads. Therefore, this value should be set as small as
possible, given the eventual maximal size of the volume.
)ZminSizeZmaxSizeZdefaultSlabSizerk rl )rc rn r% r3 r2 )re rf rg r r- ro r Z
checkSlabSizeZslabSizer' r( Z slabSizeMinZ slabSizeMaxr� r rr )r r* r
r
r r\ q s
z*VDOArgumentParser._vdoSlabSizeOptionParserc C s& t jdd�}|jdddtd�d� |S )NF)rb z --verbosery �verbosezO
Prints commands before executing them.
)rc r$ r2 )re rf rg r' )r r* r
r
r rv � s
z&VDOArgumentParser._verboseOptionParserc C sX |rdnt d�jtj�}tjdd�}|jdtjtj |r:dntj|t d�j|d�d � |S )
z�
Arguments:
required (boolean) - If True, no default is provided or mentioned
in the help text.
rj zThe default is {0}.F)rb z
--writePolicyNa�
Specifies the write policy. If 'sync', writes are acknowledged only
after the data is guaranteed to persist. If 'async', writes are
acknowledged when the data has been cached for writing to the
underlying storage. Data which has not been flushed is not guaranteed
to persist in this mode, however this mode is ACID compliant (after
recovery from a crash any unflushed write is guaranteed either to have
persisted all its data, or to have done nothing). Most databases and
filesystems should use this mode. If 'async-unsafe', writes are handled
like 'async' but there is no guarantee of the above atomicity. This
mode should only be used for better performance when atomicity is
not required. If 'auto', VDO will check the underlying storage and
determine whether it supports flushes. If it does, VDO will run in async
mode, otherwise it will run in sync mode. {defaultHelp}
)rm )rc rd r% r6 r2 )
r' r( r Z writePolicyre rf rg r r- ZwritePolicyChoices)r r6 rm r* r
r
r rE � s z*VDOArgumentParser._writePolicyOptionParserc s � fdd�}|S )a� Returns a callable for option checking which traps and translates
exceptions from the vdo management option checking to argparse's
exception in order to provide consistent behavior for option errors
including preventing stack traces.
Arguments:
checkFunc (callable) - the vdo management option check method to use
Returns:
__checker (callable) - the wrapper which translates vdo option check
exception to argparse's.
c sB y � | �} W n0 t k
r< } ztjt|���W Y d d }~X nX | S )N)r re ZArgumentTypeError�str)Z optionValueZex)� checkFuncr
r Z __checker� s
z2VDOArgumentParser.__optionCheck.<locals>.__checkerr
)�clsr� Z_VDOArgumentParser__checkerr
)r� r Z
__optionCheck� s z VDOArgumentParser.__optionCheckc C s |j ddddtd�d� d S )Nz-az--allry �allz�
Indicates that the command should be applied to all configured VDO
volumes. May not be used with --name.
)rc r$ r2 )rg r' )r r* r
r
r Z__parserAddAllOption� s
z&VDOArgumentParser.__parserAddAllOptionc C s* |j ddtj| jtj�d|td�d� d S )Nz-nz--namez<volume>zh
Operates on the specified VDO volume. May not be used with --all.
)rc rn r3 r6 r2 )rg r r- ro r Z checkVDONamer' )r r* r6 r
r
r Z__parserAddNameOption� s
z'VDOArgumentParser.__parserAddNameOptionc sR � j dkrN� fdd�| jD �}t|�dkrN| jjtd�jdjdj| j���� dS ) a5 Performs post-parsing checks between linked options.
If there is a check failure invokes the appropriate parser error()
method to display the error message and exit.
Arguments:
namespace (Namespace) - the Namespace instance populated by parsing
arguments
r< c s g | ]}t � |d �d k r|�qS )N)r# )r Zoption)r r
r r � s z7VDOArgumentParser.__postParseChecks.<locals>.<listcomp>r z#options must be specified from: {0}z--{0}z, --N)r0 r^ �lenr_ r& r' r( �join)r r r r
)r r Z__postParseChecks� s
z#VDOArgumentParser.__postParseChecks���r� r� r� )NN)F)F)F)F)T)F)F)F)F)F)F)F)F)F)F)F)<r r r r! r' r( r� r Z lvmSuffixesr r� Z
lvmSiSuffixesr rq re rf r ZActionr- r r rI r] rJ rK rC rL rs rt rM rH rN rG r` rO ru rP rF rD ra rQ rR rS rT rU rV rW rY rX rZ r[ r\ rv rE � classmethodro ri r� r. r" r
r
)r r r 1 sp
!
%
r )r! Z
__future__r r r re �gettextrj r r r Zinstallrf r r
r
r
r �<module> s
Sindbad File Manager Version 1.0, Coded By Sindbad EG ~ The Terrorists