Module: Ext3

Included in:: FileObject

Defined in:: lib/fs/MiqFS/modules/Ext3.rb,
lib/fs/ext3/inode.rb,
lib/fs/ext3/directory.rb,
lib/fs/ext3/file_data.rb,
lib/fs/ext3/superblock.rb,
lib/fs/ext3/alloc_bitmap.rb,
lib/fs/ext3/ex_attrib_name.rb,
lib/fs/ext3/directory_entry.rb,
lib/fs/ext3/hash_tree_entry.rb,
lib/fs/ext3/posix_acl_entry.rb,
lib/fs/ext3/ex_attrib_header.rb,
lib/fs/ext3/hash_tree_header.rb,
lib/fs/ext3/posix_acl_header.rb,
lib/fs/ext3/block_pointers_path.rb,
lib/fs/ext3/group_descriptor_entry.rb,
lib/fs/ext3/group_descriptor_table.rb

Overview

Ext3 file system interface to MiqFS.

Defined Under Namespace

Classes: AllocBitmap, BlockPointersPath, Directory, DirectoryEntry, ExAttribHeader, ExAttribName, FileData, FileObject, GroupDescriptorEntry, GroupDescriptorTable, HashTreeEntry, HashTreeHeader, Inode, PosixAclEntry, PosixAclHeader, Superblock

Constant Summary collapse

INODE = //////////////////////////////////////////////////////////////////////////// // Data definitions.

BinaryStruct.new([
  'S',  'file_mode',    # File mode (type and permission), see PF_ DF_ & FM_ below.
  'S',  'uid_lo',       # Lower 16-bits of user id.
  'L',  'size_lo',      # Lower 32-bits of size in bytes.
  'L',  'atime',        # Last access time.
  'L',  'ctime',        # Last change time.
  'L',  'mtime',        # Last modification time.
  'L',  'dtime',        # Time deleted.
  'S',  'gid_lo',       # Lower 16-bits of group id.
  'S',  'link_count',   # Link count.
  'L',  'sector_count', # Sector count.
  'L',  'flags',        # Inode flags, see IF_ below.
  'L',  'unused1',      # Unused.
  'a48',  'blk_ptrs',   # 12 direct block pointers.
  'L',  'ind_ptr',      # 1 single indirect block pointer.
  'L',  'dbl_ind_ptr',  # 1 double indirect block pointer.
  'L',  'tpl_ind_ptr',  # 1 triple indirect block pointer.
  'L',  'gen_num',      # Generation number (NFS).
  'L',  'ext_attrib',   # Extended attribute block (ACL).
  'L',  'size_hi',      # Upper 32-bits of size in bytes or directory ACL.
  'L',  'frag_blk',     # Block address of fragment.
  'C',  'frag_idx',     # Fragment index in block.
  'C',  'frag_siz',     # Fragment size.
  'S',  'unused2',      # Unused.
  'S',  'uid_hi',       # Upper 16-bits of user id.
  'S',  'gid_hi',       # Upper 16-bits of group id.
  'L',  'unused3',      # Unused.
])

SYM_LNK_OFFSET = Offset of block pointers for those files whose content is a symbolic link of less than 60 chars.

SYM_LNK_SIZE =

SUPERBLOCK = //////////////////////////////////////////////////////////////////////////// // Data definitions. Linux 2.6.2 from Fedora Core 6.

BinaryStruct.new([
  'L',  'num_inodes',         # Number of inodes in file system.
  'L',  'num_blocks',         # Number of blocks in file system.
  'L',  'reserved_blocks',    # Number of reserved blocks to prevent file system from filling up.
  'L',  'unallocated_blocks', # Number of unallocated blocks.
  'L',  'unallocated_inodes', # Number of unallocated inodes.
  'L',  'block_group_zero',   # Block where block group 0 starts.
  'L',  'block_size',         # Block size (saved as num bits to shift 1024 left).
  'L',  'fragment_size',      # Fragment size (saved as num bits to shift 1024 left).
  'L',  'blocks_in_group',    # Number of blocks in each block group.
  'L',  'fragments_in_group', # Number of fragments in each block group.
  'L',  'inodes_in_group',    # Number of inodes in each block group.
  'L',  'last_mount_time',    # Time FS was last mounted.
  'L',  'last_write_time',    # Time FS was last written to.
  'S',  'mount_count',        # Current mount count.
  'S',  'max_mount_count',    # Maximum mount count.
  'S',  'signature',          # Always 0xef53
  'S',  'fs_state',           # File System State: see FSS_ below.
  'S',  'err_method',         # Error Handling Method: see EHM_ below.
  'S',  'ver_minor',          # Minor version number.
  'L',  'last_check_time',    # Last consistency check time.
  'L',  'forced_check_int',   # Forced check interval.
  'L',  'creator_os',         # Creator OS: see CO_ below.
  'L',  'ver_major',          # Major version: see MV_ below.
  'S',  'uid_res_blocks',     # UID that can use reserved blocks.
  'S',  'gid_res_blocks',     # GID that can uss reserved blocks.
  # Begin dynamic version fields
  'L',  'first_inode',        # First non-reserved inode in file system.
  'S',  'inode_size',         # Size of each inode.
  'S',  'block_group',        # Block group that this superblock is part of (if backup copy).
  'L',  'compat_flags',       # Compatible feature flags (see CFF_ below).
  'L',  'incompat_flags',     # Incompatible feature flags (see ICF_ below).
  'L',  'ro_flags',           # Read Only feature flags (see ROF_ below).
  'a16',  'fs_id',            # File system ID (UUID or GUID).
  'a16',  'vol_name',         # Volume name.
  'a64',  'last_mnt_path',    # Path where last mounted.
  'L',  'algo_use_bmp',       # Algorithm usage bitmap.
  # Performance hints
  'C',  'file_prealloc_blks', # Blocks to preallocate for files.
  'C',  'dir_prealloc_blks',  # Blocks to preallocate for directories.
  'S',  'unused1',            # Unused.
  # Journal support
  'a16',  'jrnl_id',          # Joural ID (UUID or GUID).
  'L',  'jrnl_inode',         # Journal inode.
  'L',  'jrnl_device',        # Journal device.
  'L',  'orphan_head',        # Head of orphan inode list.
  'a16',  'hash_seed',        # HTREE hash seed. This is actually L4 (__u32 s_hash_seed[4])
  'C',  'hash_ver',           # Default hash version.
  'C',  'unused2',
  'S',  'unused3',
  'L',  'mount_opts',         # Default mount options.
  'L',  'first_meta_blk_grp', # First metablock block group.
  'a360', 'reserved'          # Unused.
])

SUPERBLOCK_SIG =

0xef53

SUPERBLOCK_OFFSET =

SUPERBLOCK_SIZE =

GDE_SIZE =

INODE_SIZE = Default inode size.

SUPERBLOCK_VALIDATE = Simpler structure for just validating the presence of a superblock

BinaryStruct.new([
  'x56', nil,
  'S',  'signature',          # Always 0xef53
  'S',  'fs_state',           # File System State: see FSS_ below.
  'S',  'err_method',         # Error Handling Method: see EHM_ below.
])

SUPERBLOCK_VALIDATE_SIZE =

SUPERBLOCK_VALIDATE.size

DEF_CACHE_SIZE = Default directory cache size.

EX_ATTRIB_NAME = //////////////////////////////////////////////////////////////////////////// // Data definitions.

[
  'C',  'name_len',       # Length of name
  'C',  'type',           # Type of attribute, see AT_ below.
  'S',  'offset_to_val',  # Offset to value.
  'L',  'blk_loc',        # Block location of value (not used).
  'L',  'size_of_val',    # Size in bytes of value.
  'L',  'hash_of_val',    # Hash of value.
]

DIR_ENTRY_ORIGINAL = //////////////////////////////////////////////////////////////////////////// // Data definitions.

BinaryStruct.new([
  'L',  'inode_val',  # Inode address of metadata.
  'S',  'entry_len',  # Length of entry.
  'S',  'name_len',   # Length of name.
])

SIZEOF_DIR_ENTRY_ORIGINAL = Here follows the name in ASCII.

DIR_ENTRY_ORIGINAL.size

DIR_ENTRY_NEW =

BinaryStruct.new([
  'L',  'inode_val',  # Inode address of metadata.
  'S',  'entry_len',  # Length of entry.
  'C',  'name_len',   # Length of name.
  'C',  'file_type',  # Type of file (see FT_ below).
])

SIZEOF_DIR_ENTRY_NEW = Here follows the name in ASCII.

DIR_ENTRY_NEW.size

HASH_TREE_ENTRY_FIRST = //////////////////////////////////////////////////////////////////////////// // Data definitions.

[
  'S',  'max_descriptors',  # Maximum number of node descriptors.
  'S',  'cur_descriptors',  # Current number of node descriptors.
  'L',  'first_node',       # Block address of first node.
]

HASH_TREE_ENTRY_NEXT =

[
  'L',  'min_hash',   # Minimum hash value in node.
  'L',  'next_node',  # Block address of next node.
]

POSIX_ACL_ENTRY = //////////////////////////////////////////////////////////////////////////// // Data definitions.

[
  'S',  'type',         # Entry type, see ET_ below.
  'S',  'permissions',  # Permissions, see EP_ below.
  'L',  'u_g_id',       # User / Group id (not defined for some types).
]

EX_ATTRIB_HEADER = //////////////////////////////////////////////////////////////////////////// // Data definitions.

[
  'L',  'signature',  # Always 0xea020000
  'L',  'ref_count',
  'L',  'num_blks',
  'L',  'hash',
]

HASH_TREE_HEADER = //////////////////////////////////////////////////////////////////////////// // Data definitions.

[
  'L',  'unused1',    # Unused.
  'C',  'hash_ver',   # Hash version.
  'C',  'length',     # Length of this structure.
  'C',  'leaf_level', # Levels of leaves.
  'C',  'unused2',    # Unused.
]

POSIX_ACL_HEADER = //////////////////////////////////////////////////////////////////////////// // Data definitions.

[
  'L',  'version',  # Always 1, or 1 is all that's supported.
]

GDE = //////////////////////////////////////////////////////////////////////////// // Data definitions.

BinaryStruct.new([
  'L',  'blk_bmp',        # Starting block address of block bitmap.
  'L',  'inode_bmp',      # Starting block address of inode bitmap.
  'L',  'inode_table',    # Starting block address of inode table.
  'S',  'unalloc_blks',   # Number of unallocated blocks in group.
  'S',  'unalloc_inodes', # Number of unallocated inodes in group.
  'S',  'num_dirs',       # Number of directories in group.
  'a14',  'unused1',      # Unused.
])

SIZEOF_GDE =

GDE.size

Instance Attribute Summary collapse

#cache_hits ⇒ Object

Members (these become members of an MiqFS instance).
#dir_cache ⇒ Object

Members (these become members of an MiqFS instance).
#entry_cache ⇒ Object

Members (these become members of an MiqFS instance).
#rootDir ⇒ Object

Members (these become members of an MiqFS instance).
#superblock ⇒ Object

Members (these become members of an MiqFS instance).