@zenfs/core 2.6.5 → 2.7.0

package/dist/vfs/ioctl.d.ts

@@ -1,90 +1,13 @@
-import { BufferView } from 'utilium/buffer';
+import type { PathOrFileDescriptor } from 'node:fs';
 import type { V_Context } from '../context.js';
-import { Inode } from '../internal/inode.js';
-declare const fsxattr_base: import("memium").StructConstructor<BufferView<any>>;
-declare class fsxattr extends fsxattr_base {
-    static name: string;
-    /** xflags field value */
-    accessor xflags: number;
-    /** extsize field value */
-    accessor extsize: number;
-    /** nextents field value */
-    accessor nextents: number;
-    /** project identifier */
-    accessor projid: number;
-    /** CoW extsize field value */
-    accessor cowextsize: number;
-    protected accessor pad: number[];
-    constructor(inode?: Inode);
-}
+import type { IoctlArgs, IoctlDefaultAsyncOps, IoctlDefaultSyncOps, IoctlOps } from '../internal/ioctl.js';
 /**
- * `FS_IOC_*` commands for {@link ioctl | `ioctl`}
- * @remarks
- * These are computed from a script since constant values are needed for enum member types
+ * Perform an `ioctl` on a file or file system.
+ * @category ioctl
  */
-export declare enum IOC {
-    GetFlags = 2148034049,
-    SetFlags = 1074292226,
-    GetVersion = 2148038145,
-    SetVersion = 1074296322,
-    Fiemap = 3223348747,
-    GetXattr = 2149341215,
-    SetXattr = 1075599392,
-    GetLabel = 2164298801,
-    SetLabel = 1090556978,
-    GetUUID = 2148603136,
-    GetSysfsPath = 2155943169
-}
+export declare function ioctl<const Command extends number, const Ops extends IoctlOps = IoctlDefaultAsyncOps>(this: V_Context, path: PathOrFileDescriptor, command: Command, ...args: IoctlArgs<Ops[Command]>): Promise<ReturnType<Ops[Command]>>;
 /**
- * `FS_IOC32_*` commands for {@link ioctl | `ioctl`}
- * @remarks
- * These are computed from a script since constant values are needed for enum member types
+ * Perform an `ioctl` on a file or file system
+ * @category ioctl
  */
-export declare enum IOC32 {
-    GetFlags = 2147771905,
-    SetFlags = 1074030082,
-    GetVersion = 2147776001,
-    SetVersion = 1074034178
-}
-/** Used by `ioctl` for type inference */
-interface _ioc_ops {
-    [IOC.GetFlags](): number;
-    [IOC.SetFlags](flags: number): void;
-    [IOC.GetVersion](): number;
-    [IOC.SetVersion](version: number): void;
-    [IOC.Fiemap](): never;
-    [IOC.GetXattr](name: string): fsxattr;
-    [IOC.SetXattr](name: string, value: fsxattr): never;
-    [IOC.GetLabel](): string;
-    [IOC.SetLabel](label: string): void;
-    [IOC.GetUUID](): string;
-    [IOC.GetSysfsPath](): string;
-}
-/** Used by `ioctl` for type inference */
-interface _ioc32_ops extends Record<keyof IOC32, (...args: any[]) => any> {
-    [IOC32.GetFlags](): number;
-    [IOC32.SetFlags](flags: number): void;
-    [IOC32.GetVersion](): number;
-    [IOC32.SetVersion](version: number): void;
-}
-/** Used by `ioctl` for type inference */
-type __ioctl_args__<T extends number> = T extends IOC ? Parameters<_ioc_ops[T]> : T extends IOC32 ? Parameters<_ioc32_ops[T]> : any[];
-/** Used by `ioctl` for type inference */
-type __ioctl_return__<T extends number> = T extends IOC ? ReturnType<_ioc_ops[T]> : T extends IOC32 ? ReturnType<_ioc32_ops[T]> : any;
-/** Perform an `ioctl` on a file or file system. */
-export declare function ioctl<const Command extends number, const Args extends __ioctl_args__<Command>, const Return extends __ioctl_return__<Command>>(this: V_Context, 
-/** The path to the file or file system to perform the `ioctl` on */
-path: string, 
-/** The command to perform (uint32) */
-command: Command, 
-/** The arguments to pass to the command */
-...args: Args): Promise<Return>;
-/** Perform an `ioctl` on a file or file system */
-export declare function ioctlSync<const Command extends number, const Args extends __ioctl_args__<Command>, const Return extends __ioctl_return__<Command>>(this: V_Context, 
-/** The path to the file or file system to perform the `ioctl` on */
-path: string, 
-/** The command to perform (uint32) */
-command: Command, 
-/** The arguments to pass to the command */
-...args: Args): Return;
-export {};
+export declare function ioctlSync<const Command extends number, const Ops extends IoctlOps = IoctlDefaultSyncOps>(this: V_Context, path: PathOrFileDescriptor, command: Command, ...args: IoctlArgs<Ops[Command]>): ReturnType<Ops[Command]>;

package/dist/vfs/ioctl.js

@@ -5,387 +5,85 @@
     - include/uapi/asm-generic/ioctl.h
     - include/uapi/linux/fs.h (`FS_IOC_*`)
 */
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-import { Errno, Exception, setUVMessage, UV } from 'kerium';
-import { sizeof } from 'memium';
-import { $from, struct, types as t } from 'memium/decorators';
-import { _throw } from 'utilium';
-import { BufferView } from 'utilium/buffer';
-import { Inode, InodeFlags } from '../internal/inode.js';
+import { setUVMessage, UV } from 'kerium';
 import { normalizePath } from '../utils.js';
-import { resolveMount } from './shared.js';
-/*
- * Flags for the fsxattr.xflags field
- */
-var XFlag;
-(function (XFlag) {
-    /** data in realtime volume */
-    XFlag[XFlag["RealTime"] = 1] = "RealTime";
-    /** preallocated file extents */
-    XFlag[XFlag["PreAlloc"] = 2] = "PreAlloc";
-    /** file cannot be modified */
-    XFlag[XFlag["Immutable"] = 8] = "Immutable";
-    /** all writes append */
-    XFlag[XFlag["Append"] = 16] = "Append";
-    /** all writes synchronous */
-    XFlag[XFlag["Sync"] = 32] = "Sync";
-    /** do not update access time */
-    XFlag[XFlag["NoAtime"] = 64] = "NoAtime";
-    /** do not include in backups */
-    XFlag[XFlag["NoDump"] = 128] = "NoDump";
-    /** create with rt bit set */
-    XFlag[XFlag["RtInherit"] = 256] = "RtInherit";
-    /** create with parents projid */
-    XFlag[XFlag["ProjInherit"] = 512] = "ProjInherit";
-    /** disallow symlink creation */
-    XFlag[XFlag["NoSymlinks"] = 1024] = "NoSymlinks";
-    /** extent size allocator hint */
-    XFlag[XFlag["ExtSize"] = 2048] = "ExtSize";
-    /** inherit inode extent size */
-    XFlag[XFlag["ExtSzInherit"] = 4096] = "ExtSzInherit";
-    /** do not defragment */
-    XFlag[XFlag["NoDefrag"] = 8192] = "NoDefrag";
-    /** use filestream allocator */
-    XFlag[XFlag["FileStream"] = 16384] = "FileStream";
-    /** use DAX for IO */
-    XFlag[XFlag["Dax"] = 32768] = "Dax";
-    /** CoW extent size allocator hint */
-    XFlag[XFlag["CowExtSize"] = 65536] = "CowExtSize";
-    /** no DIFLAG for this */
-    XFlag[XFlag["HasAttr"] = 2147483648] = "HasAttr";
-})(XFlag || (XFlag = {}));
-let fsxattr = (() => {
-    var _a, _b, _c, _d, _e;
-    let _classDecorators = [struct()];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _classSuper = $from(BufferView);
-    let _xflags_decorators;
-    let _xflags_initializers = [];
-    let _xflags_extraInitializers = [];
-    let _extsize_decorators;
-    let _extsize_initializers = [];
-    let _extsize_extraInitializers = [];
-    let _nextents_decorators;
-    let _nextents_initializers = [];
-    let _nextents_extraInitializers = [];
-    let _projid_decorators;
-    let _projid_initializers = [];
-    let _projid_extraInitializers = [];
-    let _cowextsize_decorators;
-    let _cowextsize_initializers = [];
-    let _cowextsize_extraInitializers = [];
-    let _pad_decorators;
-    let _pad_initializers = [];
-    let _pad_extraInitializers = [];
-    var fsxattr = class extends _classSuper {
-        static { _classThis = this; }
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-            _xflags_decorators = [(_a = t).uint32.bind(_a)];
-            _extsize_decorators = [(_b = t).uint32.bind(_b)];
-            _nextents_decorators = [(_c = t).uint32.bind(_c)];
-            _projid_decorators = [(_d = t).uint32.bind(_d)];
-            _cowextsize_decorators = [(_e = t).uint32.bind(_e)];
-            _pad_decorators = [t.char(8)];
-            __esDecorate(this, null, _xflags_decorators, { kind: "accessor", name: "xflags", static: false, private: false, access: { has: obj => "xflags" in obj, get: obj => obj.xflags, set: (obj, value) => { obj.xflags = value; } }, metadata: _metadata }, _xflags_initializers, _xflags_extraInitializers);
-            __esDecorate(this, null, _extsize_decorators, { kind: "accessor", name: "extsize", static: false, private: false, access: { has: obj => "extsize" in obj, get: obj => obj.extsize, set: (obj, value) => { obj.extsize = value; } }, metadata: _metadata }, _extsize_initializers, _extsize_extraInitializers);
-            __esDecorate(this, null, _nextents_decorators, { kind: "accessor", name: "nextents", static: false, private: false, access: { has: obj => "nextents" in obj, get: obj => obj.nextents, set: (obj, value) => { obj.nextents = value; } }, metadata: _metadata }, _nextents_initializers, _nextents_extraInitializers);
-            __esDecorate(this, null, _projid_decorators, { kind: "accessor", name: "projid", static: false, private: false, access: { has: obj => "projid" in obj, get: obj => obj.projid, set: (obj, value) => { obj.projid = value; } }, metadata: _metadata }, _projid_initializers, _projid_extraInitializers);
-            __esDecorate(this, null, _cowextsize_decorators, { kind: "accessor", name: "cowextsize", static: false, private: false, access: { has: obj => "cowextsize" in obj, get: obj => obj.cowextsize, set: (obj, value) => { obj.cowextsize = value; } }, metadata: _metadata }, _cowextsize_initializers, _cowextsize_extraInitializers);
-            __esDecorate(this, null, _pad_decorators, { kind: "accessor", name: "pad", static: false, private: false, access: { has: obj => "pad" in obj, get: obj => obj.pad, set: (obj, value) => { obj.pad = value; } }, metadata: _metadata }, _pad_initializers, _pad_extraInitializers);
-            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
-            fsxattr = _classThis = _classDescriptor.value;
-            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-        }
-        static name = 'fsxattr';
-        #xflags_accessor_storage = __runInitializers(this, _xflags_initializers, void 0);
-        /** xflags field value */
-        get xflags() { return this.#xflags_accessor_storage; }
-        set xflags(value) { this.#xflags_accessor_storage = value; }
-        #extsize_accessor_storage = (__runInitializers(this, _xflags_extraInitializers), __runInitializers(this, _extsize_initializers, void 0));
-        /** extsize field value */
-        get extsize() { return this.#extsize_accessor_storage; }
-        set extsize(value) { this.#extsize_accessor_storage = value; }
-        #nextents_accessor_storage = (__runInitializers(this, _extsize_extraInitializers), __runInitializers(this, _nextents_initializers, void 0));
-        /** nextents field value */
-        get nextents() { return this.#nextents_accessor_storage; }
-        set nextents(value) { this.#nextents_accessor_storage = value; }
-        #projid_accessor_storage = (__runInitializers(this, _nextents_extraInitializers), __runInitializers(this, _projid_initializers, void 0));
-        /** project identifier */
-        get projid() { return this.#projid_accessor_storage; }
-        set projid(value) { this.#projid_accessor_storage = value; }
-        #cowextsize_accessor_storage = (__runInitializers(this, _projid_extraInitializers), __runInitializers(this, _cowextsize_initializers, void 0));
-        /** CoW extsize field value */
-        get cowextsize() { return this.#cowextsize_accessor_storage; }
-        set cowextsize(value) { this.#cowextsize_accessor_storage = value; }
-        #pad_accessor_storage = (__runInitializers(this, _cowextsize_extraInitializers), __runInitializers(this, _pad_initializers, []));
-        get pad() { return this.#pad_accessor_storage; }
-        set pad(value) { this.#pad_accessor_storage = value; }
-        constructor(inode = _throw(new Exception(Errno.EINVAL, 'fsxattr must be initialized with an inode'))) {
-            super(new ArrayBuffer(sizeof(fsxattr)));
-            __runInitializers(this, _pad_extraInitializers);
-            this.extsize = inode.size;
-            this.nextents = 1;
-            this.projid = inode.uid;
-            this.cowextsize = inode.size;
-            for (const name of Object.keys(InodeFlags)) {
-                if (!(inode.flags & InodeFlags[name]))
-                    continue;
-                if (name in XFlag)
-                    this.xflags |= XFlag[name];
-            }
-        }
-        static {
-            __runInitializers(_classThis, _classExtraInitializers);
-        }
-    };
-    return fsxattr = _classThis;
-})();
+import { resolve as resolveAsync } from './async.js';
+import { fromFD } from './file.js';
+import { resolve as resolveSync } from './sync.js';
+import { cacheOf } from './vcache.js';
 /**
- * Inode flags (FS_IOC_GETFLAGS / FS_IOC_SETFLAGS)
- * @see `FS_*_FL` in `include/uapi/linux/fs.h` (around L250)
- * @experimental
+ * Perform an `ioctl` on a file or file system.
+ * @category ioctl
  */
-var FileFlag;
-(function (FileFlag) {
-    /** Secure deletion */
-    FileFlag[FileFlag["SecureRm"] = 1] = "SecureRm";
-    /** Undelete */
-    FileFlag[FileFlag["Undelete"] = 2] = "Undelete";
-    /** Compress file */
-    FileFlag[FileFlag["Compress"] = 4] = "Compress";
-    /** Synchronous updates */
-    FileFlag[FileFlag["Sync"] = 8] = "Sync";
-    /** Immutable file */
-    FileFlag[FileFlag["Immutable"] = 16] = "Immutable";
-    /** Writes to file may only append */
-    FileFlag[FileFlag["Append"] = 32] = "Append";
-    /** do not dump file */
-    FileFlag[FileFlag["NoDump"] = 64] = "NoDump";
-    /** do not update atime */
-    FileFlag[FileFlag["NoAtime"] = 128] = "NoAtime";
-    // Reserved for compression usage...
-    FileFlag[FileFlag["Dirty"] = 256] = "Dirty";
-    /** One or more compressed clusters */
-    FileFlag[FileFlag["CompressBlk"] = 512] = "CompressBlk";
-    /** Don't compress */
-    FileFlag[FileFlag["NoCompress"] = 1024] = "NoCompress";
-    // End compression flags --- maybe not all used
-    /** Encrypted file */
-    FileFlag[FileFlag["Encrypt"] = 2048] = "Encrypt";
-    /** btree format dir */
-    FileFlag[FileFlag["Btree"] = 4096] = "Btree";
-    /** hash-indexed directory */
-    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
-    FileFlag[FileFlag["Index"] = 4096] = "Index";
-    /** AFS directory */
-    FileFlag[FileFlag["IMagic"] = 8192] = "IMagic";
-    /** Reserved for ext3 */
-    FileFlag[FileFlag["JournalData"] = 16384] = "JournalData";
-    /** file tail should not be merged */
-    FileFlag[FileFlag["NoTail"] = 32768] = "NoTail";
-    /** dirsync behaviour (directories only) */
-    FileFlag[FileFlag["DirSync"] = 65536] = "DirSync";
-    /** Top of directory hierarchies*/
-    FileFlag[FileFlag["TopDir"] = 131072] = "TopDir";
-    /** Reserved for ext4 */
-    FileFlag[FileFlag["HugeFile"] = 262144] = "HugeFile";
-    /** Extents */
-    FileFlag[FileFlag["Extent"] = 524288] = "Extent";
-    /** Verity protected inode */
-    FileFlag[FileFlag["Verity"] = 1048576] = "Verity";
-    /** Inode used for large EA */
-    FileFlag[FileFlag["EaInode"] = 2097152] = "EaInode";
-    /** Reserved for ext4 */
-    FileFlag[FileFlag["EofBlocks"] = 4194304] = "EofBlocks";
-    /** Do not cow file */
-    FileFlag[FileFlag["NoCow"] = 8388608] = "NoCow";
-    /** Inode is DAX */
-    FileFlag[FileFlag["Dax"] = 33554432] = "Dax";
-    /** Reserved for ext4 */
-    FileFlag[FileFlag["InlineData"] = 268435456] = "InlineData";
-    /** Create with parents projid */
-    FileFlag[FileFlag["ProjInherit"] = 536870912] = "ProjInherit";
-    /** Folder is case insensitive */
-    FileFlag[FileFlag["CaseFold"] = 1073741824] = "CaseFold";
-    /** reserved for ext2 lib */
-    FileFlag[FileFlag["Reserved"] = 2147483648] = "Reserved";
-})(FileFlag || (FileFlag = {}));
-/**
- * `FS_IOC_*` commands for {@link ioctl | `ioctl`}
- * @remarks
- * These are computed from a script since constant values are needed for enum member types
- */
-export var IOC;
-(function (IOC) {
-    IOC[IOC["GetFlags"] = 2148034049] = "GetFlags";
-    IOC[IOC["SetFlags"] = 1074292226] = "SetFlags";
-    IOC[IOC["GetVersion"] = 2148038145] = "GetVersion";
-    IOC[IOC["SetVersion"] = 1074296322] = "SetVersion";
-    IOC[IOC["Fiemap"] = 3223348747] = "Fiemap";
-    IOC[IOC["GetXattr"] = 2149341215] = "GetXattr";
-    IOC[IOC["SetXattr"] = 1075599392] = "SetXattr";
-    IOC[IOC["GetLabel"] = 2164298801] = "GetLabel";
-    IOC[IOC["SetLabel"] = 1090556978] = "SetLabel";
-    IOC[IOC["GetUUID"] = 2148603136] = "GetUUID";
-    IOC[IOC["GetSysfsPath"] = 2155943169] = "GetSysfsPath";
-})(IOC || (IOC = {}));
-/**
- * `FS_IOC32_*` commands for {@link ioctl | `ioctl`}
- * @remarks
- * These are computed from a script since constant values are needed for enum member types
- */
-export var IOC32;
-(function (IOC32) {
-    IOC32[IOC32["GetFlags"] = 2147771905] = "GetFlags";
-    IOC32[IOC32["SetFlags"] = 1074030082] = "SetFlags";
-    IOC32[IOC32["GetVersion"] = 2147776001] = "GetVersion";
-    IOC32[IOC32["SetVersion"] = 1074034178] = "SetVersion";
-})(IOC32 || (IOC32 = {}));
-/** Perform an `ioctl` on a file or file system. */
-export async function ioctl(
-/** The path to the file or file system to perform the `ioctl` on */
-path, 
-/** The command to perform (uint32) */
-command, 
-/** The arguments to pass to the command */
-...args) {
-    path = normalizePath(path);
-    const { fs, path: resolved } = resolveMount(path, this);
+export async function ioctl(path, command, ...args) {
+    let vcache, vnode, file;
+    if (typeof path == 'number') {
+        file = fromFD(this, path);
+        vcache = cacheOf(file.fs);
+        vnode = file.vnode;
+        // In the future we may need to use `vcache.ref(...)`
+        // For now this avoids some issues: touching vnode.paths, triggering the "referenced by more paths" error, and inode assignment
+        vnode.refs++;
+    }
+    else {
+        path = normalizePath(path);
+        const mnt = await resolveAsync(this, path, false, { syscall: 'ioctl', path });
+        if (!mnt.stats)
+            throw UV('ENOENT', { syscall: 'ioctl', path });
+        vcache = cacheOf(mnt.fs);
+        vnode = vcache.ref(mnt.path, vcache.get(mnt.path)?.inode ?? mnt.stats);
+    }
+    const context = {
+        fs: vnode.fs,
+        inode: vnode.inode,
+        path: vnode.path,
+        file,
+    };
     try {
-        const inode = new Inode(await fs.stat(resolved));
-        switch (command) {
-            case IOC.GetFlags:
-            case IOC32.GetFlags:
-                return inode.flags;
-            case IOC.SetFlags:
-            case IOC32.SetFlags:
-                inode.flags = args[0];
-                await fs.touch(resolved, inode);
-                return undefined;
-            case IOC.GetVersion:
-            case IOC32.GetVersion:
-                return inode.version;
-            case IOC.SetVersion:
-            case IOC32.SetVersion:
-                inode.version = args[0];
-                await fs.touch(resolved, inode);
-                return undefined;
-            case IOC.Fiemap:
-                break;
-            case IOC.GetXattr:
-                return new fsxattr(inode);
-            case IOC.SetXattr:
-                break;
-            case IOC.GetLabel:
-                return fs.label;
-            case IOC.SetLabel:
-                fs.label = args[0];
-                return undefined;
-            case IOC.GetUUID:
-                return fs.uuid;
-            case IOC.GetSysfsPath:
-                /**
-                 * Returns the path component under /sys/fs/ that refers to this filesystem;
-                 * also /sys/kernel/debug/ for filesystems with debugfs exports
-                 * @todo Implement sysfs and have each FS implement the /sys/fs/<name> tree
-                 */
-                return `/sys/fs/${fs.name}/${fs.uuid}`;
-        }
+        return await vnode.fs.ioctl(context, command, ...args);
     }
     catch (e) {
         throw setUVMessage(Object.assign(e, { syscall: 'ioctl', path }));
     }
-    throw UV('ENOTSUP', 'ioctl', path);
+    finally {
+        vcache.unref(vnode);
+    }
 }
-/** Perform an `ioctl` on a file or file system */
-export function ioctlSync(
-/** The path to the file or file system to perform the `ioctl` on */
-path, 
-/** The command to perform (uint32) */
-command, 
-/** The arguments to pass to the command */
-...args) {
-    path = normalizePath(path);
-    const { fs, path: resolved } = resolveMount(path, this);
+/**
+ * Perform an `ioctl` on a file or file system
+ * @category ioctl
+ */
+export function ioctlSync(path, command, ...args) {
+    let vcache, vnode, file;
+    if (typeof path == 'number') {
+        file = fromFD(this, path);
+        vcache = cacheOf(file.fs);
+        vnode = file.vnode;
+        // In the future we may need to use `vcache.ref(...)`
+        // For now this avoids some issues: touching vnode.paths, triggering the "referenced by more paths" error, and inode assignment
+        vnode.refs++;
+    }
+    else {
+        path = normalizePath(path);
+        const mnt = resolveSync(this, path, false, { syscall: 'ioctl', path });
+        if (!mnt.stats)
+            throw UV('ENOENT', { syscall: 'ioctl', path });
+        vcache = cacheOf(mnt.fs);
+        vnode = vcache.ref(mnt.path, vcache.get(mnt.path)?.inode ?? mnt.stats);
+    }
+    const context = {
+        fs: vnode.fs,
+        inode: vnode.inode,
+        path: vnode.path,
+        file,
+    };
     try {
-        const inode = new Inode(fs.statSync(resolved));
-        switch (command) {
-            case IOC.GetFlags:
-            case IOC32.GetFlags:
-                return inode.flags;
-            case IOC.SetFlags:
-            case IOC32.SetFlags:
-                inode.flags = args[0];
-                fs.touchSync(resolved, inode);
-                return undefined;
-            case IOC.GetVersion:
-            case IOC32.GetVersion:
-                return inode.version;
-            case IOC.SetVersion:
-            case IOC32.SetVersion:
-                inode.version = args[0];
-                fs.touchSync(resolved, inode);
-                return undefined;
-            case IOC.Fiemap:
-                break;
-            case IOC.GetXattr:
-                return new fsxattr(inode);
-            case IOC.SetXattr:
-                break;
-            case IOC.GetLabel:
-                return fs.label;
-            case IOC.SetLabel:
-                fs.label = args[0];
-                return undefined;
-            case IOC.GetUUID:
-                return fs.uuid;
-            case IOC.GetSysfsPath:
-                /**
-                 * Returns the path component under /sys/fs/ that refers to this filesystem;
-                 * also /sys/kernel/debug/ for filesystems with debugfs exports
-                 * @todo Implement sysfs and have each FS implement the /sys/fs/<name> tree
-                 */
-                return `/sys/fs/${fs.name}/${fs.uuid}`;
-        }
+        return vnode.fs.ioctlSync(context, command, ...args);
     }
     catch (e) {
         throw setUVMessage(Object.assign(e, { syscall: 'ioctl', path }));
     }
-    throw UV('ENOTSUP', 'ioctl', path);
+    finally {
+        vcache.unref(vnode);
+    }
 }

package/dist/vfs/shared.d.ts

@@ -12,6 +12,8 @@ export type MountObject = Record<AbsolutePath, FileSystem>;
  * The map of mount points
  * @category Backends and Configuration
  * @internal
+ * @deprecated Use `defaultContext.mounts`.
+ * @todo [breaking] remove this
  */
 export declare const mounts: Map<string, FileSystem>;
 /**

package/dist/vfs/shared.js

@@ -4,7 +4,7 @@ import { Errno, Exception, UV, withErrno } from 'kerium';
 import { alert, debug, err, info, notice, warn } from 'kerium/log';
 import { InMemory } from '../backends/memory.js';
 import { size_max } from '../constants.js';
-import { contextOf } from '../internal/contexts.js';
+import { contextOf, defaultContext } from '../internal/contexts.js';
 import { credentialsAllowRoot } from '../internal/credentials.js';
 import { withExceptionContext } from '../internal/error.js';
 import { join, resolve } from '../path.js';
@@ -14,8 +14,10 @@ import { caches, VCache } from './vcache.js';
  * The map of mount points
  * @category Backends and Configuration
  * @internal
+ * @deprecated Use `defaultContext.mounts`.
+ * @todo [breaking] remove this
  */
-export const mounts = new Map();
+export const mounts = defaultContext.mounts;
 // Set a default root.
 mount('/', InMemory.create({ label: 'root' }));
 /**
@@ -24,13 +26,14 @@ mount('/', InMemory.create({ label: 'root' }));
  * @internal
  */
 export function mount(mountPoint, fs) {
+    const $ = contextOf(this);
     if (mountPoint[0] != '/')
         mountPoint = '/' + mountPoint;
-    mountPoint = resolve.call(this, mountPoint);
-    if (mounts.has(mountPoint))
+    mountPoint = resolve.call($, mountPoint);
+    if ($.mounts.has(mountPoint))
         throw err(withErrno('EINVAL', 'Mount point is already in use: ' + mountPoint));
     fs._mountPoint = mountPoint;
-    mounts.set(mountPoint, fs);
+    $.mounts.set(mountPoint, fs);
     if (!caches.has(fs.uuid))
         caches.set(fs.uuid, new VCache(fs));
     info(`Mounted ${fs.name} on ${mountPoint}`);
@@ -42,10 +45,11 @@ export function mount(mountPoint, fs) {
  * @todo [BREAKING] make this `async` and `await` vcache sync
  */
 export function umount(mountPoint) {
+    const $ = contextOf(this);
     if (mountPoint[0] != '/')
         mountPoint = '/' + mountPoint;
     mountPoint = resolve.call(this, mountPoint);
-    const fs = mounts.get(mountPoint);
+    const fs = $.mounts.get(mountPoint);
     if (!fs) {
         warn(mountPoint + ' is already unmounted');
         return;
@@ -62,7 +66,7 @@ export function umount(mountPoint) {
         warn(`Could not flush to ${mountPoint} synchronously.`);
         void caches.get(fs.uuid)?.sync().then(_done);
     }
-    mounts.delete(mountPoint);
+    $.mounts.delete(mountPoint);
     notice('Unmounted ' + mountPoint);
 }
 /**
@@ -70,7 +74,7 @@ export function umount(mountPoint) {
  * @internal @hidden
  */
 export function resolveMount(path, ctx, extra) {
-    const { root } = contextOf(ctx);
+    const { root, mounts } = contextOf(ctx);
     const _exceptionContext = { path, ...extra };
     path = normalizePath(join(root, path), true);
     path = resolve.call(ctx, path);

package/dist/vfs/sync.d.ts

@@ -16,7 +16,7 @@ export declare function resolve($: V_Context, path: string, preserveSymlinks?: b
  * @category VFS
  * @internal
  */
-export declare function open(this: V_Context, path: PathLike, opt: OpenOptions): Handle;
+export declare function open($: V_Context, path: PathLike, opt: OpenOptions): Handle;
 export declare function readlink(this: V_Context, path: PathLike): string;
 export declare function mkdir(this: V_Context, path: PathLike, options?: MkdirOptions): string | void;
 export declare function readdir(this: V_Context, path: PathLike, options?: ReaddirOptions): Dirent[];