//! Feature flags for *pxar* allow to control what is stored/restored in/from the //! archive. //! Flags for known supported features for a given filesystem can be derived //! from the superblocks magic number. /// FAT-style 2s time granularity pub const WITH_2SEC_TIME: u64 = 0x40; /// Preserve read only flag of files pub const WITH_READ_ONLY: u64 = 0x80; /// Preserve unix permissions pub const WITH_PERMISSIONS: u64 = 0x100; /// Include symbolik links pub const WITH_SYMLINKS: u64 = 0x200; /// Include device nodes pub const WITH_DEVICE_NODES: u64 = 0x400; /// Include FIFOs pub const WITH_FIFOS: u64 = 0x800; /// Include Sockets pub const WITH_SOCKETS: u64 = 0x1000; /// Preserve DOS file flag `HIDDEN` pub const WITH_FLAG_HIDDEN: u64 = 0x2000; /// Preserve DOS file flag `SYSTEM` pub const WITH_FLAG_SYSTEM: u64 = 0x4000; /// Preserve DOS file flag `ARCHIVE` pub const WITH_FLAG_ARCHIVE: u64 = 0x8000; // chattr() flags /// Linux file attribute `APPEND` pub const WITH_FLAG_APPEND: u64 = 0x10000; /// Linux file attribute `NOATIME` pub const WITH_FLAG_NOATIME: u64 = 0x20000; /// Linux file attribute `COMPR` pub const WITH_FLAG_COMPR: u64 = 0x40000; /// Linux file attribute `NOCOW` pub const WITH_FLAG_NOCOW: u64 = 0x80000; /// Linux file attribute `NODUMP` pub const WITH_FLAG_NODUMP: u64 = 0x100000; /// Linux file attribute `DIRSYNC` pub const WITH_FLAG_DIRSYNC: u64 = 0x200000; /// Linux file attribute `IMMUTABLE` pub const WITH_FLAG_IMMUTABLE: u64 = 0x400000; /// Linux file attribute `SYNC` pub const WITH_FLAG_SYNC: u64 = 0x800000; /// Linux file attribute `NOCOMP` pub const WITH_FLAG_NOCOMP: u64 = 0x1000000; /// Linux file attribute `PROJINHERIT` pub const WITH_FLAG_PROJINHERIT: u64 = 0x2000000; /// Preserve BTRFS subvolume flag pub const WITH_SUBVOLUME: u64 = 0x4000000; /// Preserve BTRFS read-only subvolume flag pub const WITH_SUBVOLUME_RO: u64 = 0x8000000; /// Preserve Extended Attribute metadata pub const WITH_XATTRS: u64 = 0x10000000; /// Preserve Access Control List metadata pub const WITH_ACL: u64 = 0x20000000; /// Preserve SELinux security context pub const WITH_SELINUX: u64 = 0x40000000; /// Preserve "security.capability" xattr pub const WITH_FCAPS: u64 = 0x80000000; /// Preserve XFS/ext4/ZFS project quota ID pub const WITH_QUOTA_PROJID: u64 = 0x100000000; /// Support ".pxarexclude" files pub const EXCLUDE_FILE: u64 = 0x1000000000000000; /// Exclude submounts pub const EXCLUDE_SUBMOUNTS: u64 = 0x4000000000000000; /// Exclude entries with chattr flag NODUMP pub const EXCLUDE_NODUMP: u64 = 0x8000000000000000; /// Definitions of typical feature flags for the *pxar* encoder/decoder. /// By this expensive syscalls for unsupported features are avoided. /// All chattr file attributes pub const WITH_CHATTR: u64 = WITH_FLAG_APPEND| WITH_FLAG_NOATIME| WITH_FLAG_COMPR| WITH_FLAG_NOCOW| WITH_FLAG_NODUMP| WITH_FLAG_DIRSYNC| WITH_FLAG_IMMUTABLE| WITH_FLAG_SYNC| WITH_FLAG_NOCOMP| WITH_FLAG_PROJINHERIT; /// All FAT file attributes pub const WITH_FAT_ATTRS: u64 = WITH_FLAG_HIDDEN| WITH_FLAG_SYSTEM| WITH_FLAG_ARCHIVE; /// All bits that may also be exposed via fuse pub const WITH_FUSE: u64 = WITH_2SEC_TIME| WITH_READ_ONLY| WITH_PERMISSIONS| WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS| WITH_FAT_ATTRS| WITH_CHATTR| WITH_XATTRS; /// Default feature flags for encoder/decoder pub const DEFAULT: u64 = WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS| WITH_FLAG_HIDDEN| WITH_FLAG_SYSTEM| WITH_FLAG_ARCHIVE| WITH_FLAG_APPEND| WITH_FLAG_NOATIME| WITH_FLAG_COMPR| WITH_FLAG_NOCOW| //WITH_FLAG_NODUMP| WITH_FLAG_DIRSYNC| WITH_FLAG_IMMUTABLE| WITH_FLAG_SYNC| WITH_FLAG_NOCOMP| WITH_FLAG_PROJINHERIT| WITH_SUBVOLUME| WITH_SUBVOLUME_RO| WITH_XATTRS| WITH_ACL| WITH_SELINUX| WITH_FCAPS| WITH_QUOTA_PROJID| EXCLUDE_NODUMP| EXCLUDE_FILE; // form /usr/include/linux/fs.h const FS_APPEND_FL: u32 = 0x00000020; const FS_NOATIME_FL: u32 = 0x00000080; const FS_COMPR_FL: u32 = 0x00000004; const FS_NOCOW_FL: u32 = 0x00800000; const FS_NODUMP_FL: u32 = 0x00000040; const FS_DIRSYNC_FL: u32 = 0x00010000; const FS_IMMUTABLE_FL: u32 = 0x00000010; const FS_SYNC_FL: u32 = 0x00000008; const FS_NOCOMP_FL: u32 = 0x00000400; const FS_PROJINHERIT_FL: u32 = 0x20000000; static CHATTR_MAP: [(u64, u32); 10] = [ ( WITH_FLAG_APPEND, FS_APPEND_FL ), ( WITH_FLAG_NOATIME, FS_NOATIME_FL ), ( WITH_FLAG_COMPR, FS_COMPR_FL ), ( WITH_FLAG_NOCOW, FS_NOCOW_FL ), ( WITH_FLAG_NODUMP, FS_NODUMP_FL ), ( WITH_FLAG_DIRSYNC, FS_DIRSYNC_FL ), ( WITH_FLAG_IMMUTABLE, FS_IMMUTABLE_FL ), ( WITH_FLAG_SYNC, FS_SYNC_FL ), ( WITH_FLAG_NOCOMP, FS_NOCOMP_FL ), ( WITH_FLAG_PROJINHERIT, FS_PROJINHERIT_FL ), ]; pub fn feature_flags_from_chattr(attr: u32) -> u64 { let mut flags = 0u64; for (fe_flag, fs_flag) in &CHATTR_MAP { if (attr & fs_flag) != 0 { flags = flags | fe_flag; } } flags } // from /usr/include/linux/msdos_fs.h const ATTR_HIDDEN: u32 = 2; const ATTR_SYS: u32 = 4; const ATTR_ARCH: u32 = 32; static FAT_ATTR_MAP: [(u64, u32); 3] = [ ( WITH_FLAG_HIDDEN, ATTR_HIDDEN ), ( WITH_FLAG_SYSTEM, ATTR_SYS ), ( WITH_FLAG_ARCHIVE, ATTR_ARCH ), ]; pub fn feature_flags_from_fat_attr(attr: u32) -> u64 { let mut flags = 0u64; for (fe_flag, fs_flag) in &FAT_ATTR_MAP { if (attr & fs_flag) != 0 { flags = flags | fe_flag; } } flags } /// Return the supported *pxar* feature flags based on the magic number of the filesystem. pub fn feature_flags_from_magic(magic: i64) -> u64 { use crate::tools::fs::magic::*; match magic { MSDOS_SUPER_MAGIC => { WITH_2SEC_TIME| WITH_READ_ONLY| WITH_FAT_ATTRS }, EXT4_SUPER_MAGIC => { WITH_2SEC_TIME| WITH_READ_ONLY| WITH_PERMISSIONS| WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS| WITH_FLAG_APPEND| WITH_FLAG_NOATIME| WITH_FLAG_NODUMP| WITH_FLAG_DIRSYNC| WITH_FLAG_IMMUTABLE| WITH_FLAG_SYNC| WITH_XATTRS| WITH_ACL| WITH_SELINUX| WITH_FCAPS| WITH_QUOTA_PROJID }, XFS_SUPER_MAGIC => { WITH_2SEC_TIME| WITH_READ_ONLY| WITH_PERMISSIONS| WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS| WITH_FLAG_APPEND| WITH_FLAG_NOATIME| WITH_FLAG_NODUMP| WITH_FLAG_IMMUTABLE| WITH_FLAG_SYNC| WITH_XATTRS| WITH_ACL| WITH_SELINUX| WITH_FCAPS| WITH_QUOTA_PROJID }, ZFS_SUPER_MAGIC => { WITH_2SEC_TIME| WITH_READ_ONLY| WITH_PERMISSIONS| WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS| WITH_FLAG_APPEND| WITH_FLAG_NOATIME| WITH_FLAG_NODUMP| WITH_FLAG_DIRSYNC| WITH_FLAG_IMMUTABLE| WITH_FLAG_SYNC| WITH_XATTRS| WITH_ACL| WITH_SELINUX| WITH_FCAPS| WITH_QUOTA_PROJID }, BTRFS_SUPER_MAGIC => { WITH_2SEC_TIME| WITH_READ_ONLY| WITH_PERMISSIONS| WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS| WITH_FLAG_APPEND| WITH_FLAG_NOATIME| WITH_FLAG_COMPR| WITH_FLAG_NOCOW| WITH_FLAG_NODUMP| WITH_FLAG_DIRSYNC| WITH_FLAG_IMMUTABLE| WITH_FLAG_SYNC| WITH_FLAG_NOCOMP| WITH_XATTRS| WITH_ACL| WITH_SELINUX| WITH_SUBVOLUME| WITH_SUBVOLUME_RO| WITH_FCAPS }, TMPFS_MAGIC => { WITH_2SEC_TIME| WITH_READ_ONLY| WITH_PERMISSIONS| WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS| WITH_ACL| WITH_SELINUX }, // FUSE mounts are special as the supported feature set // is not clear a priori. FUSE_SUPER_MAGIC => { WITH_FUSE }, _ => { WITH_2SEC_TIME| WITH_READ_ONLY| WITH_PERMISSIONS| WITH_SYMLINKS| WITH_DEVICE_NODES| WITH_FIFOS| WITH_SOCKETS }, } }