Main Page   Modules   Data Structures   File List   Data Fields   Globals  

dar_sup_flags Struct Reference
[Archive operations]

A collection of flags toogling various types of operations. More...

#include <libdarc.h>


Data Fields

bool allow_overwrite: 1
 Allow files to be overwritten during an operation.

bool warn_overwrite: 1
 Warn before file are overwritten.

bool slice_pause: 1
 Pause between slices and prompt for continue (using answer callback).

bool create_empty_stubs: 1
 Create empty directory entries for excluded paths.

bool ea_system: 1
 Save, restore, or check system Extended Attributes.

bool ea_user: 1
 Save, restore, or check user Extended Attributes.

bool no_dump: 1
 Ignore files with the nodump flag set.

bool ignore_owner: 1
 Do not save, restore, or check ownership or permissions.

bool test_run: 1
 Perform test run; do not write any data to the filesystem.

bool alter_atime: 1
 Alter atime when reading files saved in archive.

bool same_fs: 1
 Do not wander to seperate file systems.

bool delete_marked: 1
 When a file is marked as deleted in an archive, delete it from the filesystem during a restore operation.

bool restore_flat: 1
 Perform a flat restoration (ignoring directory structure).

bool warn_remove_no_match: 1
 Warn before moving a file marked as deleted that does not match the file type stored in the archive.

bool only_more_recent: 1
 Only restore files that are more recent than those on the filesystem.

bool tar_format: 1
 Print listing data in a format similar tar, not a tree format.

bool filter_unsaved: 1
 Do not list archive entries marked as unsaved.


Detailed Description

A collection of flags toogling various types of operations.

There are optional parameters. While passing this structure is required, each field has default options that should be reasonable for typical operations.

Definition at line 951 of file libdarc.h.


Field Documentation

bool dar_sup_flags::allow_overwrite
 

Allow files to be overwritten during an operation.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             X
Diff                
Isolate             X
Get children of     

Definition at line 973 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_extract(), dar_op_archive_isolate(), and dar_sup_flags_defaults().

bool dar_sup_flags::alter_atime
 

Alter atime when reading files saved in archive.

If activated, atime will be reset to previous value. By a limitation in the POSIX API, this will change the ctime.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             
Diff                X
Isolate             
Get children of     

Definition at line 1165 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_diff(), and dar_sup_flags_defaults().

bool dar_sup_flags::create_empty_stubs
 

Create empty directory entries for excluded paths.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             
Diff                
Isolate             
Get children of     

Definition at line 1036 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_isolate(), and dar_sup_flags_defaults().

bool dar_sup_flags::delete_marked
 

When a file is marked as deleted in an archive, delete it from the filesystem during a restore operation.

This field has a default value of true.

Field usage:

Operation          Used

Create              
Open                
Close               
Test                
List                
Extract             X
Diff                
Isolate             
Get children of     

Definition at line 1208 of file libdarc.h.

Referenced by dar_op_archive_extract(), and dar_sup_flags_defaults().

bool dar_sup_flags::ea_system
 

Save, restore, or check system Extended Attributes.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             X
Diff                X
Isolate             
Get children of     

Definition at line 1057 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_diff(), dar_op_archive_extract(), and dar_sup_flags_defaults().

bool dar_sup_flags::ea_user
 

Save, restore, or check user Extended Attributes.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             X
Diff                X
Isolate             
Get children of     

Definition at line 1078 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_diff(), dar_op_archive_extract(), and dar_sup_flags_defaults().

bool dar_sup_flags::filter_unsaved
 

Do not list archive entries marked as unsaved.

This field has a default value of false.

Field usage:

Operation          Used

Create              
Open                
Close               
Test                
List                X
Extract             
Diff                
Isolate             
Get children of     

Definition at line 1322 of file libdarc.h.

Referenced by dar_op_archive_list(), and dar_sup_flags_defaults().

bool dar_sup_flags::ignore_owner
 

Do not save, restore, or check ownership or permissions.

This field has a default value of true.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             X
Diff                X
Isolate             
Get children of     

Definition at line 1120 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_diff(), dar_op_archive_extract(), and dar_sup_flags_defaults().

bool dar_sup_flags::no_dump
 

Ignore files with the nodump flag set.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             
Diff                
Isolate             
Get children of     

Definition at line 1099 of file libdarc.h.

Referenced by dar_op_archive_create(), and dar_sup_flags_defaults().

bool dar_sup_flags::only_more_recent
 

Only restore files that are more recent than those on the filesystem.

This field has a default value of false.

Field usage:

Operation          Used

Create              
Open                
Close               
Test                
List                
Extract             X
Diff                
Isolate             
Get children of     

Definition at line 1277 of file libdarc.h.

Referenced by dar_op_archive_extract(), and dar_sup_flags_defaults().

bool dar_sup_flags::restore_flat
 

Perform a flat restoration (ignoring directory structure).

This field has a default value of false.

Field usage:

Operation          Used

Create              
Open                
Close               
Test                
List                
Extract             X
Diff                
Isolate             
Get children of     

Definition at line 1233 of file libdarc.h.

Referenced by dar_op_archive_extract(), and dar_sup_flags_defaults().

bool dar_sup_flags::same_fs
 

Do not wander to seperate file systems.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             
Diff                
Isolate             
Get children of     

Definition at line 1186 of file libdarc.h.

Referenced by dar_op_archive_create(), and dar_sup_flags_defaults().

bool dar_sup_flags::slice_pause
 

Pause between slices and prompt for continue (using answer callback).

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             
Diff                
Isolate             X
Get children of     

Definition at line 1015 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_isolate(), and dar_sup_flags_defaults().

bool dar_sup_flags::tar_format
 

Print listing data in a format similar tar, not a tree format.

This field has a default value of true.

Field usage:

Operation          Used

Create              
Open                
Close               
Test                
List                X
Extract             
Diff                
Isolate             
Get children of     

Definition at line 1301 of file libdarc.h.

Referenced by dar_op_archive_list(), and dar_sup_flags_defaults().

bool dar_sup_flags::test_run
 

Perform test run; do not write any data to the filesystem.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             X
Diff                
Isolate             X
Get children of     

Definition at line 1141 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_extract(), dar_op_archive_isolate(), and dar_sup_flags_defaults().

bool dar_sup_flags::warn_overwrite
 

Warn before file are overwritten.

This field has a default value of false.

Field usage:

Operation          Used

Create              X
Open                
Close               
Test                
List                
Extract             X
Diff                
Isolate             X
Get children of     

Definition at line 994 of file libdarc.h.

Referenced by dar_op_archive_create(), dar_op_archive_extract(), and dar_sup_flags_defaults().

bool dar_sup_flags::warn_remove_no_match
 

Warn before moving a file marked as deleted that does not match the file type stored in the archive.

This field has a default value of true.

Field usage:

Operation          Used

Create              
Open                
Close               
Test                
List                
Extract             X
Diff                
Isolate             
Get children of     

Definition at line 1255 of file libdarc.h.

Referenced by dar_op_archive_extract(), and dar_sup_flags_defaults().


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