libdar::archive_options_listing Class Reference

class holding optional parameters used to list the contents of an existing archive More...

#include <archive_options.hpp>

Inheritance diagram for libdar::archive_options_listing:

Collaboration diagram for libdar::archive_options_listing:

Public Member Functions
	archive_options_listing (const archive_options_listing &ref)
	archive_options_listing (archive_options_listing &&ref) noexcept
archive_options_listing &	operator= (const archive_options_listing &ref)
archive_options_listing &	operator= (archive_options_listing &&ref) noexcept
virtual void	clear ()
void	set_info_details (bool info_details)
	whether output should be verbosed --> to be moved to shell output More...
void	set_selection (const mask &selection)
	mask applied to filename, only those marching it will be listed More...
void	set_subtree (const mask &subtree)
	defines the directories and files to consider More...
void	set_filter_unsaved (bool filter_unsaved)
	whether to only show entries that have their data fully saved More...
void	set_slicing_location (bool val)
	whether to calculate the slice location of each file More...
void	set_user_slicing (const infinint &slicing_first, const infinint &slicing_others)
	when slice location is performed, user may modify the slice layout of the archive More...
void	set_display_ea (bool display_ea)
	whether to fetch EA for listing More...
bool	get_info_details () const
const mask &	get_selection () const
const mask &	get_subtree () const
bool	get_filter_unsaved () const
bool	get_user_slicing (infinint &slicing_first, infinint &slicing_others) const
bool	get_slicing_location () const
bool	get_display_ea () const

Private Member Functions
void	destroy () noexcept
void	nullifyptr () noexcept
void	copy_from (const archive_options_listing &ref)
void	move_from (archive_options_listing &&ref) noexcept

Private Attributes
bool	x_info_details
mask *	x_selection
mask *	x_subtree
bool	x_filter_unsaved
infinint *	x_slicing_first
infinint *	x_slicing_others
bool	x_slicing_location
bool	x_display_ea

Detailed Description

class holding optional parameters used to list the contents of an existing archive

Definition at line 1474 of file archive_options.hpp.

Constructor & Destructor Documentation

archive_options_listing() [1/3]

libdar::archive_options_listing::archive_options_listing ( )

inline

Definition at line 1477 of file archive_options.hpp.

archive_options_listing() [2/3]

libdar::archive_options_listing::archive_options_listing ( const archive_options_listing &  ref )

inline

Definition at line 1478 of file archive_options.hpp.

archive_options_listing() [3/3]

libdar::archive_options_listing::archive_options_listing ( archive_options_listing &&  ref )

inlinenoexcept

Definition at line 1479 of file archive_options.hpp.

~archive_options_listing()

virtual libdar::archive_options_listing::~archive_options_listing ( )

inlinevirtual

Definition at line 1482 of file archive_options.hpp.

Member Function Documentation

get_display_ea()

bool libdar::archive_options_listing::get_display_ea ( ) const

inline

Definition at line 1539 of file archive_options.hpp.

get_filter_unsaved()

bool libdar::archive_options_listing::get_filter_unsaved ( ) const

inline

Definition at line 1536 of file archive_options.hpp.

get_info_details()

bool libdar::archive_options_listing::get_info_details ( ) const

inline

Definition at line 1533 of file archive_options.hpp.

get_slicing_location()

bool libdar::archive_options_listing::get_slicing_location ( ) const

inline

Definition at line 1538 of file archive_options.hpp.

operator=() [1/2]

archive_options_listing & libdar::archive_options_listing::operator= ( archive_options_listing &&  ref )

inlinenoexcept

Definition at line 1481 of file archive_options.hpp.

operator=() [2/2]

archive_options_listing & libdar::archive_options_listing::operator= ( const archive_options_listing &  ref )

inline

Definition at line 1480 of file archive_options.hpp.

set_display_ea()

void libdar::archive_options_listing::set_display_ea ( bool  display_ea )

inline

whether to fetch EA for listing

Note

this operation implies a lot of processing

Definition at line 1527 of file archive_options.hpp.

set_filter_unsaved()

void libdar::archive_options_listing::set_filter_unsaved ( bool  filter_unsaved )

inline

whether to only show entries that have their data fully saved

Definition at line 1512 of file archive_options.hpp.

set_info_details()

void libdar::archive_options_listing::set_info_details ( bool  info_details )

inline

whether output should be verbosed --> to be moved to shell output

Definition at line 1491 of file archive_options.hpp.

set_selection()

void libdar::archive_options_listing::set_selection

(

const mask &

selection

)

mask applied to filename, only those marching it will be listed

Note

this mask does not reject directory (it does not apply to it)

set_slicing_location()

void libdar::archive_options_listing::set_slicing_location ( bool  val )

inline

whether to calculate the slice location of each file

Definition at line 1515 of file archive_options.hpp.

set_subtree()

void libdar::archive_options_listing::set_subtree

(

const mask &

subtree

)

defines the directories and files to consider

Note

WARNING: The filter mechanism used here is common to all operations and works by comparing full paths, while in the other hand, paths stored in the libdar archive are all relative to what was provided as fs_root at backup time. To have this filter mecanism working in the context of listing, where no fs_root can be provided to transform relative paths to absolute paths, libdar will emulate an fs_root with the pseudo root value of the path::FAKE_ROOT field. This is invisible form the libdar API user except when relying on mask_list objects, which cannot thus receive full path as those would not be prepended by path::FAKE_ROOT as fs_root value, because fs_root prefixing is only performed for relative paths.

set_user_slicing()

void libdar::archive_options_listing::set_user_slicing	(	const infinint &	slicing_first,
		const infinint &	slicing_others
	)

when slice location is performed, user may modify the slice layout of the archive

Note

this is needed for archive format older than 8 and when listing an isolated catalogue which original archive has been resized after the isolation operation. This option is not used if set_slicing_location is set to false

Member Data Documentation

x_display_ea

bool libdar::archive_options_listing::x_display_ea

private

Definition at line 1549 of file archive_options.hpp.

x_filter_unsaved

bool libdar::archive_options_listing::x_filter_unsaved

private

Definition at line 1545 of file archive_options.hpp.

x_info_details

bool libdar::archive_options_listing::x_info_details

private

Definition at line 1542 of file archive_options.hpp.

x_selection

mask* libdar::archive_options_listing::x_selection

private

Definition at line 1543 of file archive_options.hpp.

x_slicing_first

infinint* libdar::archive_options_listing::x_slicing_first

private

Definition at line 1546 of file archive_options.hpp.

x_slicing_location

bool libdar::archive_options_listing::x_slicing_location

private

Definition at line 1548 of file archive_options.hpp.

x_slicing_others

infinint* libdar::archive_options_listing::x_slicing_others

private

Definition at line 1547 of file archive_options.hpp.

x_subtree

mask* libdar::archive_options_listing::x_subtree

private

Definition at line 1544 of file archive_options.hpp.

---

The documentation for this class was generated from the following file:

• archive_options.hpp