lee/container
1
0
Fork 0
mirror of https://github.com/apple/container.git synced 2026-09-09 09:15:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

EXT4: Adjustments to file names and visibilities (#112)

Browse Source 
- FileTimestamps constructor that actually let you provide values was
not public, so it wasn't possible to pass in values other than nil. This
change makes the other constructor and the underlying fields public.
- Rename EXT4+Format to EXT4+Formatter
- Rename EXT4+Export to EXT4Reader+Export
- Make the superblock publicly accessible in the reader like the docs
for the product states.
This commit is contained in:
Danny Canter
2025-06-12 23:32:45 -07:00
committed by GitHub
parent 6d9e4b9c4d
commit 90dfc9d90e
5 changed files with 126 additions and 121 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Sources/ContainerizationEXT4/EXT4+Format.swift → Sources/ContainerizationEXT4/EXT4+Formatter.swift
View File
Sources/ContainerizationEXT4/EXT4+Reader.swift
+13 -9
View File
@@ -20,8 +20,12 @@ import SystemPackage
extension EXT4 {
/// The `EXT4Reader` opens a block device, parses the superblock, and loads group descriptors & inodes.
public class EXT4Reader {
public var superBlock: EXT4.SuperBlock {
self._superBlock
}
let handle: FileHandle
let superBlock: EXT4.SuperBlock
let _superBlock: EXT4.SuperBlock
private var groupDescriptors: [UInt32: EXT4.GroupDescriptor] = [:]
private var inodes: [InodeNumber: EXT4.Inode] = [:]
@@ -29,12 +33,12 @@ extension EXT4 {
var hardlinks: [FilePath: InodeNumber] = [:]
var tree: EXT4.FileTree = EXT4.FileTree(EXT4.RootInode, ".")
var blockSize: UInt64 {
UInt64(1024 * (1 << superBlock.logBlockSize))
UInt64(1024 * (1 << _superBlock.logBlockSize))
}
private var groupDescriptorSize: UInt16 {
if superBlock.featureIncompat & EXT4.IncompatFeature.bit64.rawValue != 0 {
return superBlock.descSize
if _superBlock.featureIncompat & EXT4.IncompatFeature.bit64.rawValue != 0 {
return _superBlock.descSize
}
return UInt16(MemoryLayout<EXT4.GroupDescriptor>.size)
}
@@ -60,7 +64,7 @@ extension EXT4 {
guard sb.magic == EXT4.SuperBlockMagic else {
throw EXT4.Error.invalidSuperBlock
}
self.superBlock = sb
self._superBlock = sb
var items: [(item: Ptr<EXT4.FileTree.FileTreeNode>, inode: InodeNumber)] = [
(self.tree.root, EXT4.RootInode)
]
@@ -116,7 +120,7 @@ extension EXT4 {
}
private func readGroupDescriptor(_ number: UInt32) throws -> GroupDescriptor {
let bs = UInt64(1024 * (1 << superBlock.logBlockSize))
let bs = UInt64(1024 * (1 << _superBlock.logBlockSize))
let offset = bs + UInt64(number) * UInt64(self.groupDescriptorSize)
try self.handle.seek(toOffset: offset)
guard let data = try? self.handle.read(upToCount: MemoryLayout<EXT4.GroupDescriptor>.size) else {
@@ -129,13 +133,13 @@ extension EXT4 {
}
private func readInode(_ number: UInt32) throws -> Inode {
let inodeGroupNumber = ((number - 1) / self.superBlock.inodesPerGroup)
let numberInGroup = UInt64((number - 1) % self.superBlock.inodesPerGroup)
let inodeGroupNumber = ((number - 1) / self._superBlock.inodesPerGroup)
let numberInGroup = UInt64((number - 1) % self._superBlock.inodesPerGroup)
let gd = try getGroupDescriptor(inodeGroupNumber)
let inodeTableStart = UInt64(gd.inodeTableLow) * self.blockSize
let inodeOffset: UInt64 = inodeTableStart + numberInGroup * UInt64(superBlock.inodeSize)
let inodeOffset: UInt64 = inodeTableStart + numberInGroup * UInt64(_superBlock.inodeSize)
try self.handle.seek(toOffset: inodeOffset)
guard let inodeData = try self.handle.read(upToCount: MemoryLayout<EXT4.Inode>.size) else {
throw EXT4.Error.couldNotReadInode(number)
Sources/ContainerizationEXT4/EXT4+Types.swift
+100 -99
View File
@@ -19,39 +19,39 @@
import Foundation
extension EXT4 {
struct SuperBlock {
var inodesCount: UInt32 = 0
var blocksCountLow: UInt32 = 0
var rootBlocksCountLow: UInt32 = 0
var freeBlocksCountLow: UInt32 = 0
var freeInodesCount: UInt32 = 0
var firstDataBlock: UInt32 = 0
var logBlockSize: UInt32 = 0
var logClusterSize: UInt32 = 0
var blocksPerGroup: UInt32 = 0
var clustersPerGroup: UInt32 = 0
var inodesPerGroup: UInt32 = 0
var mtime: UInt32 = 0
var wtime: UInt32 = 0
var mountCount: UInt16 = 0
var maxMountCount: UInt16 = 0
var magic: UInt16 = 0
var state: UInt16 = 0
var errors: UInt16 = 0
var minorRevisionLevel: UInt16 = 0
var lastCheck: UInt32 = 0
var checkInterval: UInt32 = 0
var creatorOS: UInt32 = 0
var revisionLevel: UInt32 = 0
var defaultReservedUid: UInt16 = 0
var defaultReservedGid: UInt16 = 0
var firstInode: UInt32 = 0
var inodeSize: UInt16 = 0
var blockGroupNr: UInt16 = 0
var featureCompat: UInt32 = 0
var featureIncompat: UInt32 = 0
var featureRoCompat: UInt32 = 0
var uuid:
public struct SuperBlock {
public var inodesCount: UInt32 = 0
public var blocksCountLow: UInt32 = 0
public var rootBlocksCountLow: UInt32 = 0
public var freeBlocksCountLow: UInt32 = 0
public var freeInodesCount: UInt32 = 0
public var firstDataBlock: UInt32 = 0
public var logBlockSize: UInt32 = 0
public var logClusterSize: UInt32 = 0
public var blocksPerGroup: UInt32 = 0
public var clustersPerGroup: UInt32 = 0
public var inodesPerGroup: UInt32 = 0
public var mtime: UInt32 = 0
public var wtime: UInt32 = 0
public var mountCount: UInt16 = 0
public var maxMountCount: UInt16 = 0
public var magic: UInt16 = 0
public var state: UInt16 = 0
public var errors: UInt16 = 0
public var minorRevisionLevel: UInt16 = 0
public var lastCheck: UInt32 = 0
public var checkInterval: UInt32 = 0
public var creatorOS: UInt32 = 0
public var revisionLevel: UInt32 = 0
public var defaultReservedUid: UInt16 = 0
public var defaultReservedGid: UInt16 = 0
public var firstInode: UInt32 = 0
public var inodeSize: UInt16 = 0
public var blockGroupNr: UInt16 = 0
public var featureCompat: UInt32 = 0
public var featureIncompat: UInt32 = 0
public var featureRoCompat: UInt32 = 0
public var uuid:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8
@@ -59,7 +59,7 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var volumeName:
public var volumeName:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8
@@ -67,7 +67,7 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var lastMounted:
public var lastMounted:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
@@ -87,11 +87,11 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var algorithmUsageBitmap: UInt32 = 0
var preallocBlocks: UInt8 = 0
var preallocDirBlocks: UInt8 = 0
var reservedGdtBlocks: UInt16 = 0
var journalUUID:
public var algorithmUsageBitmap: UInt32 = 0
public var preallocBlocks: UInt8 = 0
public var preallocDirBlocks: UInt8 = 0
public var reservedGdtBlocks: UInt16 = 0
public var journalUUID:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8
@@ -99,17 +99,17 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var journalInum: UInt32 = 0
var journalDev: UInt32 = 0
var lastOrphan: UInt32 = 0
var hashSeed: (UInt32, UInt32, UInt32, UInt32) = (0, 0, 0, 0)
var defHashVersion: UInt8 = 0
var journalBackupType: UInt8 = 0
var descSize: UInt16 = UInt16(MemoryLayout<GroupDescriptor>.size)
var defaultMountOpts: UInt32 = 0
var firstMetaBg: UInt32 = 0
var mkfsTime: UInt32 = 0
var journalBlocks:
public var journalInum: UInt32 = 0
public var journalDev: UInt32 = 0
public var lastOrphan: UInt32 = 0
public var hashSeed: (UInt32, UInt32, UInt32, UInt32) = (0, 0, 0, 0)
public var defHashVersion: UInt8 = 0
public var journalBackupType: UInt8 = 0
public var descSize: UInt16 = UInt16(MemoryLayout<GroupDescriptor>.size)
public var defaultMountOpts: UInt32 = 0
public var firstMetaBg: UInt32 = 0
public var mkfsTime: UInt32 = 0
public var journalBlocks:
(
UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32,
UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32,
@@ -119,29 +119,29 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0
)
var blocksCountHigh: UInt32 = 0
var rBlocksCountHigh: UInt32 = 0
var freeBlocksCountHigh: UInt32 = 0
var minExtraIsize: UInt16 = 0
var wantExtraIsize: UInt16 = 0
var flags: UInt32 = 0
var raidStride: UInt16 = 0
var mmpInterval: UInt16 = 0
var mmpBlock: UInt64 = 0
var raidStripeWidth: UInt32 = 0
var logGroupsPerFlex: UInt8 = 0
var checksumType: UInt8 = 0
var reservedPad: UInt16 = 0
var kbytesWritten: UInt64 = 0
var snapshotInum: UInt32 = 0
var snapshotID: UInt32 = 0
var snapshotRBlocksCount: UInt64 = 0
var snapshotList: UInt32 = 0
var errorCount: UInt32 = 0
var firstErrorTime: UInt32 = 0
var firstErrorInode: UInt32 = 0
var firstErrorBlock: UInt64 = 0
var firstErrorFunc:
public var blocksCountHigh: UInt32 = 0
public var rBlocksCountHigh: UInt32 = 0
public var freeBlocksCountHigh: UInt32 = 0
public var minExtraIsize: UInt16 = 0
public var wantExtraIsize: UInt16 = 0
public var flags: UInt32 = 0
public var raidStride: UInt16 = 0
public var mmpInterval: UInt16 = 0
public var mmpBlock: UInt64 = 0
public var raidStripeWidth: UInt32 = 0
public var logGroupsPerFlex: UInt8 = 0
public var checksumType: UInt8 = 0
public var reservedPad: UInt16 = 0
public var kbytesWritten: UInt64 = 0
public var snapshotInum: UInt32 = 0
public var snapshotID: UInt32 = 0
public var snapshotRBlocksCount: UInt64 = 0
public var snapshotList: UInt32 = 0
public var errorCount: UInt32 = 0
public var firstErrorTime: UInt32 = 0
public var firstErrorInode: UInt32 = 0
public var firstErrorBlock: UInt64 = 0
public var firstErrorFunc:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
@@ -153,12 +153,12 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var firstErrorLine: UInt32 = 0
var lastErrorTime: UInt32 = 0
var lastErrorInode: UInt32 = 0
var lastErrorLine: UInt32 = 0
var lastErrorBlock: UInt64 = 0
var lastErrorFunc:
public var firstErrorLine: UInt32 = 0
public var lastErrorTime: UInt32 = 0
public var lastErrorInode: UInt32 = 0
public var lastErrorLine: UInt32 = 0
public var lastErrorBlock: UInt64 = 0
public var lastErrorFunc:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
@@ -170,7 +170,7 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var mountOpts:
public var mountOpts:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
@@ -190,12 +190,12 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var userQuotaInum: UInt32 = 0
var groupQuotaInum: UInt32 = 0
var overheadBlocks: UInt32 = 0
var backupBgs: (UInt32, UInt32) = (0, 0)
var encryptAlgos: (UInt8, UInt8, UInt8, UInt8) = (0, 0, 0, 0)
var encryptPwSalt:
public var userQuotaInum: UInt32 = 0
public var groupQuotaInum: UInt32 = 0
public var overheadBlocks: UInt32 = 0
public var backupBgs: (UInt32, UInt32) = (0, 0)
public var encryptAlgos: (UInt8, UInt8, UInt8, UInt8) = (0, 0, 0, 0)
public var encryptPwSalt:
(
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8,
UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8, UInt8
@@ -203,17 +203,17 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var lpfInode: UInt32 = 0
var projectQuotaInum: UInt32 = 0
var checksumSeed: UInt32 = 0
var wtimeHigh: UInt8 = 0
var mtimeHigh: UInt8 = 0
var mkfsTimeHigh: UInt8 = 0
var lastcheckHigh: UInt8 = 0
var firstErrorTimeHigh: UInt8 = 0
var lastErrorTimeHigh: UInt8 = 0
var pad: (UInt8, UInt8) = (0, 0)
var reserved:
public var lpfInode: UInt32 = 0
public var projectQuotaInum: UInt32 = 0
public var checksumSeed: UInt32 = 0
public var wtimeHigh: UInt8 = 0
public var mtimeHigh: UInt8 = 0
public var mkfsTimeHigh: UInt8 = 0
public var lastcheckHigh: UInt8 = 0
public var firstErrorTimeHigh: UInt8 = 0
public var lastErrorTimeHigh: UInt8 = 0
public var pad: (UInt8, UInt8) = (0, 0)
public var reserved:
(
UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32,
UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32, UInt32,
@@ -241,7 +241,7 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0
)
var checksum: UInt32 = 0
public var checksum: UInt32 = 0
}
struct CompatFeature {
@@ -436,6 +436,7 @@ extension EXT4 {
0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
0, 0, 0, 0, 0, 0
)
public static func Mode(_ mode: FileModeFlag, _ perm: UInt16) -> UInt16 {
mode.rawValue | perm
}
Sources/ContainerizationEXT4/EXT4+Export.swift → Sources/ContainerizationEXT4/EXT4Reader+Export.swift
View File
Sources/ContainerizationEXT4/FileTimestamps.swift
+13 -13
View File
@@ -17,44 +17,44 @@
import Foundation
public struct FileTimestamps {
private let access: Date
private let modification: Date
private let creation: Date
private let now: Date
public var access: Date
public var modification: Date
public var creation: Date
public var now: Date
var accessLo: UInt32 {
public var accessLo: UInt32 {
access.fs().lo
}
var accessHi: UInt32 {
public var accessHi: UInt32 {
access.fs().hi
}
var modificationLo: UInt32 {
public var modificationLo: UInt32 {
modification.fs().lo
}
var modificationHi: UInt32 {
public var modificationHi: UInt32 {
modification.fs().hi
}
var creationLo: UInt32 {
public var creationLo: UInt32 {
creation.fs().lo
}
var creationHi: UInt32 {
public var creationHi: UInt32 {
creation.fs().hi
}
var nowLo: UInt32 {
public var nowLo: UInt32 {
now.fs().lo
}
var nowHi: UInt32 {
public var nowHi: UInt32 {
now.fs().hi
}
init(access: Date?, modification: Date?, creation: Date?) {
public init(access: Date?, modification: Date?, creation: Date?) {
now = Date()
self.access = access ?? now
self.modification = modification ?? now