Skip to main content

QgroupShowCommand

Struct QgroupShowCommand 

Source
pub struct QgroupShowCommand {
Show 17 fields pub path: PathBuf, pub print_parent: bool, pub print_child: bool, pub print_rfer_limit: bool, pub print_excl_limit: bool, pub filter_all: bool, pub filter_direct: bool, pub raw: bool, pub human_readable: bool, pub iec: bool, pub si: bool, pub kbytes: bool, pub mbytes: bool, pub gbytes: bool, pub tbytes: bool, pub sort: Option<SortKeys>, pub sync: bool,
}
Expand description

List subvolume quota groups

Shows all quota groups (qgroups) and their space accounting. Each subvolume automatically gets a level-0 qgroup (e.g. 0/256) that tracks its individual usage. Higher-level qgroups (1/0, 2/0, …) can be created to group subvolumes and apply shared limits across them.

Columns:

qgroupid: the quota group identifier in level/id format. Level 0 corresponds to individual subvolumes. Higher levels are user-created grouping containers.

rfer (referenced): total bytes of data referenced by this qgroup. For level-0 qgroups this is the logical size of all extents in the subvolume. Shared extents (e.g. from snapshots or reflinks) are counted in full by each qgroup that references them.

excl (exclusive): bytes used exclusively by this qgroup, not shared with any other qgroup at the same level. This is the space that would be freed if the subvolume were deleted (assuming no other references).

max_rfer: the configured limit on referenced bytes. Writes that would exceed this limit fail with EDQUOT. Shows “none” if no limit is set.

max_excl: the configured limit on exclusive bytes. Shows “none” if no limit is set.

In –format modern, the qgroup hierarchy is shown as a tree: higher- level qgroups appear as parents with their member qgroups nested below using tree connectors.

Fields§

§path: PathBuf

Path to a mounted btrfs filesystem

§print_parent: bool

Print parent qgroup id

§print_child: bool

Print child qgroup id

§print_rfer_limit: bool

Print limit of referenced size

§print_excl_limit: bool

Print limit of exclusive size

§filter_all: bool

List all qgroups impacting path, including ancestral qgroups

§filter_direct: bool

List all qgroups impacting path, excluding ancestral qgroups

§raw: bool

Show raw numbers in bytes

§human_readable: bool

Show human friendly numbers, base 1024 (default)

§iec: bool

Use 1024 as a base (IEC units)

§si: bool

Use 1000 as a base (SI units)

§kbytes: bool

Show sizes in KiB

§mbytes: bool

Show sizes in MiB

§gbytes: bool

Show sizes in GiB

§tbytes: bool

Show sizes in TiB

§sort: Option<SortKeys>

Sort by a comma-separated list of fields (qgroupid, rfer, excl, max_rfer, max_excl)

§sync: bool

Force a sync before getting quota information

Trait Implementations§

Source§

impl Args for QgroupShowCommand

Source§

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments
Source§

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut Read more
Source§

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut Read more
Source§

impl CommandFactory for QgroupShowCommand

Source§

fn command<'b>() -> Command

Build a Command that can instantiate Self. Read more
Source§

fn command_for_update<'b>() -> Command

Build a Command that can update self. Read more
Source§

impl Debug for QgroupShowCommand

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl FromArgMatches for QgroupShowCommand

Source§

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed. Read more
Source§

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.
Source§

impl Parser for QgroupShowCommand

Source§

fn parse() -> Self

Parse from std::env::args_os(), exit on error.
Source§

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.
Source§

fn parse_from<I, T>(itr: I) -> Self
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.
Source§

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.
Source§

fn update_from<I, T>(&mut self, itr: I)
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error. Read more
Source§

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>
where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.
Source§

impl Runnable for QgroupShowCommand

Source§

fn supported_formats(&self) -> &[Format]

Output formats this command supports. Read more
Source§

fn run(&self, ctx: &RunContext) -> Result<()>

Execute this command. Read more
Source§

fn supports_dry_run(&self) -> bool

Whether this command supports the global –dry-run flag. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.