Class DeviceFS

A temporary file system that manages and interfaces with devices

Hierarchy (View Summary)

StoreFS<InMemoryStore>
- DeviceFS

Constructors

constructor

new DeviceFS(): DeviceFS
Returns DeviceFS
Overrides StoreFS.constructor
- Defined in src/internal/devices.ts:362

Properties

`Protected`_initialized

_initialized: boolean = false

`Protected` `Optional` `Internal`_mountPoint

_mountPoint?: string

The last place this file system was mounted

`Readonly`attributes

attributes: ConstMap<FileSystemAttributes, keyof FileSystemAttributes, void> & Map<
string,
any,
> = ...

See

FileSystemAttributes

`Protected` `Readonly`devices

devices: Map<string, Device<any>> = ...

`Readonly`id

id: number

A unique ID for this kind of file system. Currently unused internally, but could be used for partition tables or something

`Optional`label

label?: string

`Readonly`name

name: string

The name for this file system. For example, tmpfs for an in memory one

`Protected` `Readonly`store

store: InMemoryStore

Methods

_add

_add(ino: number, path: string): void
Add a inode/path pair
Parameters
- ino: number
- path: string
Returns void
Inherited from StoreFS._add
- Defined in src/backends/store/fs.ts:48

_createDevice

_createDevice<TData = any>(
driver: DeviceDriver<TData>,
options?: object,
): Device<Record<string, never> | TData>
Internal
Type Parameters
- TData = any
Parameters
- driver: DeviceDriver<TData>
- options: object = {}
Returns Device<Record<string, never> | TData>
- Defined in src/internal/devices.ts:328

_move

_move(from: string, to: string): void
Move paths in the tables
Parameters
- from: string
- to: string
Returns void
Inherited from StoreFS._move
- Defined in src/backends/store/fs.ts:67

_path

_path(id: number): undefined | string
Gets the first path associated with an inode
Parameters
- id: number
Returns undefined | string
Inherited from StoreFS._path
- Defined in src/backends/store/fs.ts:40

_remove

_remove(ino: number): void
Remove a inode/path pair
Parameters
- ino: number
Returns void
Inherited from StoreFS._remove
- Defined in src/backends/store/fs.ts:57

addDefaults

addDefaults(): void
Adds default devices

Returns void
- Defined in src/internal/devices.ts:353

`Protected`allocNew

allocNew(path: string, syscall: string): number
Allocates a new ID and adds the ID/path
Parameters
- path: string
- syscall: string
Returns number
Inherited from StoreFS.allocNew
- Defined in src/backends/store/fs.ts:696

checkRoot

checkRoot(): Promise<void>
Checks if the root directory exists. Creates it if it doesn't.

Returns Promise<void>
Inherited from StoreFS.checkRoot
- Defined in src/backends/store/fs.ts:562

checkRootSync

checkRootSync(): void
Checks if the root directory exists. Creates it if it doesn't.

Returns void
Inherited from StoreFS.checkRootSync
- Defined in src/backends/store/fs.ts:577

`Protected`commitNew

commitNew(
    path: string,
    options: PureCreationOptions,
    data: Uint8Array,
    syscall: string,
): Promise<Inode>
Commits a new file (well, a FILE or a DIRECTORY) to the file system with mode. Note: This will commit the transaction.
Parameters
- path: string
  The path to the new file.
- options: PureCreationOptions
  The options to create the new file with.
- data: Uint8Array
  The data to store at the file's data node.
- syscall: string
Returns Promise<Inode>
Inherited from StoreFS.commitNew
- Defined in src/backends/store/fs.ts:712

`Protected`commitNewSync

commitNewSync(
    path: string,
    options: PureCreationOptions,
    data: Uint8Array,
    syscall: string,
): Inode
Commits a new file (well, a FILE or a DIRECTORY) to the file system with mode. Note: This will commit the transaction.
Parameters
- path: string
  The path to the new file.
- options: PureCreationOptions
  The options to create the new file with.
- data: Uint8Array
  The data to store at the file's data node.
- syscall: string
Returns Inode
The Inode for the new file.
Inherited from StoreFS.commitNewSync
- Defined in src/backends/store/fs.ts:759

createDevice

createDevice<TData = any>(
    path: string,
    driver: DeviceDriver<TData>,
    options?: object,
): Device<TData | Record<string, never>>
Creates a new device at path relative to the DeviceFS root.
Type Parameters
- TData = any
Parameters
- path: string
- driver: DeviceDriver<TData>
- options: object = {}
Returns Device<TData | Record<string, never>>
Deprecated
- Defined in src/internal/devices.ts:287

createFile

createFile(
    path: string,
    flag: string,
    mode: number,
    options: CreationOptions,
): Promise<File<FileSystem>>
Create the file at path with the given options. Then, open it with flag.
Parameters
- path: string
- flag: string
- mode: number
- options: CreationOptions
Returns Promise<File<FileSystem>>
Overrides StoreFS.createFile
- Defined in src/internal/devices.ts:418

createFileSync

createFileSync(
    path: string,
    flag: string,
    mode: number,
    options: CreationOptions,
): File
Create the file at path with the given options. Then, open it with flag.
Parameters
- path: string
- flag: string
- mode: number
- options: CreationOptions
Returns File
Overrides StoreFS.createFileSync
- Defined in src/internal/devices.ts:425

createIndex

createIndex(): Promise<Index>
Returns Promise<Index>
Inherited from StoreFS.createIndex
- Defined in src/backends/store/fs.ts:178

createIndexSync

createIndexSync(): Index
Returns Index
Inherited from StoreFS.createIndexSync
- Defined in src/backends/store/fs.ts:206

`Protected`devicesWithDriver

devicesWithDriver(
driver: string | DeviceDriver<unknown>,
forceIdentity?: boolean,
): Device<any>[]
Parameters
- driver: string | DeviceDriver<unknown>
- OptionalforceIdentity: boolean
Returns Device<any>[]
- Defined in src/internal/devices.ts:309

empty

empty(): Promise<void>
Delete all contents stored in the file system.

Returns Promise<void>
Deprecated
Inherited from StoreFS.empty
- Defined in src/backends/store/fs.ts:125

emptySync

emptySync(): void
Delete all contents stored in the file system.

Returns void
Deprecated
Inherited from StoreFS.emptySync
- Defined in src/backends/store/fs.ts:135

exists

exists(path: string): Promise<boolean>
Test whether or not path exists.
Parameters
- path: string
Returns Promise<boolean>
Inherited from StoreFS.exists
- Defined in src/internal/filesystem.ts:302

existsSync

existsSync(path: string): boolean
Test whether or not path exists.
Parameters
- path: string
Returns boolean
Inherited from StoreFS.existsSync
- Defined in src/internal/filesystem.ts:314

`Protected`findInode

findInode(tx: WrappedTransaction, path: string, syscall: string): Promise<Inode>
Finds the Inode of path.
Parameters
- tx: WrappedTransaction
- path: string
  The path to look up.
- syscall: string
Returns Promise<Inode>
Todo
memoize/cache
Inherited from StoreFS.findInode
- Defined in src/backends/store/fs.ts:673

`Protected`findInodeSync

findInodeSync(tx: WrappedTransaction, path: string, syscall: string): Inode
Finds the Inode of path.
Parameters
- tx: WrappedTransaction
- path: string
  The path to look up.
- syscall: string
Returns Inode
The Inode of the path p.

Todo
memoize/cache
Inherited from StoreFS.findInodeSync
- Defined in src/backends/store/fs.ts:685

link

link(target: string, link: string): Promise<void>
Parameters
- target: string
- link: string
Returns Promise<void>
Overrides StoreFS.link
- Defined in src/internal/devices.ts:488

linkSync

linkSync(target: string, link: string): void
Parameters
- target: string
- link: string
Returns void
Overrides StoreFS.linkSync
- Defined in src/internal/devices.ts:498

loadIndex

loadIndex(index: Index): Promise<void>
Load an index into the StoreFS. You must manually add non-directory files
Parameters
- index: Index
Returns Promise<void>
Inherited from StoreFS.loadIndex
- Defined in src/backends/store/fs.ts:146

loadIndexSync

loadIndexSync(index: Index): void
Load an index into the StoreFS. You must manually add non-directory files
Parameters
- index: Index
Returns void
Inherited from StoreFS.loadIndexSync
- Defined in src/backends/store/fs.ts:164

metadata

metadata(): FileSystemMetadata
Get metadata about the current file system

Returns FileSystemMetadata
Deprecated
Inherited from StoreFS.metadata
- Defined in src/internal/filesystem.ts:240

mkdir

mkdir(path: string, mode: number, options: CreationOptions): Promise<void>
Parameters
- path: string
- mode: number
- options: CreationOptions
Returns Promise<void>
Overrides StoreFS.mkdir
- Defined in src/internal/devices.ts:454

mkdirSync

mkdirSync(path: string, mode: number, options: CreationOptions): void
Parameters
- path: string
- mode: number
- options: CreationOptions
Returns void
Overrides StoreFS.mkdirSync
- Defined in src/internal/devices.ts:461

openFile

openFile(path: string, flag: string): Promise<File<FileSystem>>
Opens the file at path with flag. The file must exist.
Parameters
- path: string
  The path to open.
- flag: string
  The flag to use when opening the file.
Returns Promise<File<FileSystem>>
Overrides StoreFS.openFile
- Defined in src/internal/devices.ts:404

openFileSync

openFileSync(path: string, flag: string): File
Opens the file at path with flag. The file must exist.
Parameters
- path: string
  The path to open.
- flag: string
  The flag to use when opening the file.
Returns File
Overrides StoreFS.openFileSync
- Defined in src/internal/devices.ts:411

read

read(
    path: string,
    buffer: Uint8Array,
    offset: number,
    end: number,
): Promise<void>
Reads into a buffer
Parameters
- path: string
- buffer: Uint8Array
  The buffer to read into. You must set the byteOffset and byteLength appropriately!
- offset: number
  The offset into the file to start reading from
- end: number
  The position in the file to stop reading
Returns Promise<void>
Overrides StoreFS.read
- Defined in src/internal/devices.ts:522

readdir

readdir(path: string): Promise<string[]>
Parameters
- path: string
Returns Promise<string[]>
Overrides StoreFS.readdir
- Defined in src/internal/devices.ts:468

readdirSync

readdirSync(path: string): string[]
Parameters
- path: string
Returns string[]
Overrides StoreFS.readdirSync
- Defined in src/internal/devices.ts:478

readSync

readSync(path: string, buffer: Uint8Array, offset: number, end: number): void
Reads into a buffer
Parameters
- path: string
- buffer: Uint8Array
  The buffer to read into. You must set the byteOffset and byteLength appropriately!
- offset: number
  The offset into the file to start reading from
- end: number
  The position in the file to stop reading
Returns void
Overrides StoreFS.readSync
- Defined in src/internal/devices.ts:532

ready

ready(): Promise<void>
Returns Promise<void>
Inherited from StoreFS.ready
- Defined in src/backends/store/fs.ts:92

`Protected`remove

remove(path: string, isDir: boolean): Promise<void>
Remove all traces of path from the file system.
Parameters
- path: string
  The path to remove from the file system.
- isDir: boolean
  Does the path belong to a directory, or a file?
Returns Promise<void>
Todo
Update mtime.
Inherited from StoreFS.remove
- Defined in src/backends/store/fs.ts:804

`Protected`removeSync

removeSync(path: string, isDir: boolean): void
Remove all traces of path from the file system.
Parameters
- path: string
  The path to remove from the file system.
- isDir: boolean
  Does the path belong to a directory, or a file?
Returns void
Todo
Update mtime.
Inherited from StoreFS.removeSync
- Defined in src/backends/store/fs.ts:845

rename

rename(oldPath: string, newPath: string): Promise<void>
Parameters
- oldPath: string
- newPath: string
Returns Promise<void>
Todo
Make rename compatible with the cache.
Overrides StoreFS.rename
- Defined in src/internal/devices.ts:368

renameSync

renameSync(oldPath: string, newPath: string): void
Parameters
- oldPath: string
- newPath: string
Returns void
Overrides StoreFS.renameSync
- Defined in src/internal/devices.ts:378

rmdir

rmdir(path: string): Promise<void>
Parameters
- path: string
Returns Promise<void>
Overrides StoreFS.rmdir
- Defined in src/internal/devices.ts:446

rmdirSync

rmdirSync(path: string): void
Parameters
- path: string
Returns void
Overrides StoreFS.rmdirSync
- Defined in src/internal/devices.ts:450

stat

stat(path: string): Promise<Stats>
Parameters
- path: string
Returns Promise<Stats>
Overrides StoreFS.stat
- Defined in src/internal/devices.ts:388

statSync

statSync(path: string): Stats
Parameters
- path: string
Returns Stats
Overrides StoreFS.statSync
- Defined in src/internal/devices.ts:396

streamRead

streamRead(path: string, options: StreamOptions): ReadableStream
Read a file using a stream.
Parameters
- path: string
- options: StreamOptions
Returns ReadableStream
Inherited from StoreFS.streamRead
- Defined in src/internal/filesystem.ts:362

streamWrite

streamWrite(path: string, options: StreamOptions): WritableStream
Write a file using stream.
Parameters
- path: string
- options: StreamOptions
Returns WritableStream
Inherited from StoreFS.streamWrite
- Defined in src/internal/filesystem.ts:385

sync

sync(path: string, data: Uint8Array, stats: Readonly<Stats>): Promise<void>
Updated the inode and data node at path
Parameters
- path: string
- data: Uint8Array
- stats: Readonly<Stats>
Returns Promise<void>
Todo
Ensure mtime updates properly, and use that to determine if a data update is required.
Overrides StoreFS.sync
- Defined in src/internal/devices.ts:508

syncSync

syncSync(path: string, data: Uint8Array, stats: Readonly<Stats>): void
Updated the inode and data node at path
Parameters
- path: string
- data: Uint8Array
- stats: Readonly<Stats>
Returns void
Todo
Ensure mtime updates properly, and use that to determine if a data update is required.
Overrides StoreFS.syncSync
- Defined in src/internal/devices.ts:515

toString

toString(): string
Returns string
Inherited from StoreFS.toString
- Defined in src/internal/filesystem.ts:219

unlink

unlink(path: string): Promise<void>
Parameters
- path: string
Returns Promise<void>
Overrides StoreFS.unlink
- Defined in src/internal/devices.ts:432

unlinkSync

unlinkSync(path: string): void
Parameters
- path: string
Returns void
Overrides StoreFS.unlinkSync
- Defined in src/internal/devices.ts:439

usage

usage(): UsageInfo
Experimental
Returns UsageInfo
Inherited from StoreFS.usage
- Defined in src/backends/store/fs.ts:111

write

write(path: string, data: Uint8Array, offset: number): Promise<void>
Writes a buffer to a file
Parameters
- path: string
- data: Uint8Array
- offset: number
  The offset in the file to start writing
Returns Promise<void>
Overrides StoreFS.write
- Defined in src/internal/devices.ts:542

writeSync

writeSync(path: string, data: Uint8Array, offset: number): void
Writes a buffer to a file
Parameters
- path: string
- data: Uint8Array
- offset: number
  The offset in the file to start writing
Returns void
Overrides StoreFS.writeSync
- Defined in src/internal/devices.ts:551

Class DeviceFS

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Returns DeviceFS

Properties

Protected_initialized

Protected Optional Internal_mountPoint

Readonlyattributes

See

Protected Readonlydevices

Readonlyid

Optionallabel

Readonlyname

Protected Readonlystore

Methods

_add

Parameters

Returns void

_createDevice

Type Parameters

Parameters

Returns Device<Record<string, never> | TData>

_move

Parameters

Returns void

_path

Parameters

Returns undefined | string

_remove

Parameters

Returns void

addDefaults

Returns void

ProtectedallocNew

Parameters

Returns number

checkRoot

Returns Promise<void>

checkRootSync

Returns void

ProtectedcommitNew

Parameters

Returns Promise<Inode>

ProtectedcommitNewSync

Parameters

Returns Inode

createDevice

Type Parameters

Parameters

Returns Device<TData | Record<string, never>>

Deprecated

createFile

Parameters

Returns Promise<File<FileSystem>>

createFileSync

Parameters

Returns File

createIndex

Returns Promise<Index>

createIndexSync

Returns Index

ProtecteddevicesWithDriver

Parameters

Returns Device<any>[]

empty

Returns Promise<void>

Deprecated

emptySync

Returns void

Deprecated

exists

Parameters

Returns Promise<boolean>

existsSync

Parameters

`Protected`_initialized

`Protected` `Optional` `Internal`_mountPoint

`Readonly`attributes

`Protected` `Readonly`devices

`Readonly`id

`Optional`label

`Readonly`name

`Protected` `Readonly`store

`Protected`allocNew

`Protected`commitNew

`Protected`commitNewSync

`Protected`devicesWithDriver

`Protected`findInode

`Protected`findInodeSync

`Protected`remove

`Protected`removeSync