phlegyas.vfs — phlegyas 0.1.7

->filesystem clj

(->filesystem files path-pool id root-path)

Positional factory function for class phlegyas.vfs.filesystem.

->qid clj

(->qid qid-type qid-vers qid-path)

Positional factory function for class phlegyas.vfs.qid.

->stat clj

(->stat dev
        qid-type
        qid-vers
        qid-path
        mode
        atime
        mtime
        length
        name
        size
        ssize
        uid
        gid
        muid
        children
        contents
        permissions
        parent)

Positional factory function for class phlegyas.vfs.stat.

access-time clj

(access-time fh)

Get the last access time of a file.

add-fid clj

(add-fid state fid tag)

Add a new fid to the fid map, along with the tag id of the request responsible.

add-fs clj

(add-fs state fs)

Add the given filesystem to the connection. Used during attach.

add-mapping clj

(add-mapping state fid fs path)

Add a new fid to the connection. Takes in the current state, new fid, filesystem id, and path of the fid.

add-role clj

(add-role state fsid uid gid)

Add the user/group that issued the attach to the role map.

allowed-op? clj

(allowed-op? permissions operation)

attrs clj

(attrs fh)

Get the PosixFileAttributes of a file.

create-filesystem clj

(create-filesystem)

Create a filesystem record.

current-state clj

directory-reader clj

(directory-reader fs paths max-size)

Takes a filesystem, a list of paths, and the requested byte count. Recursively fetches the stat entries for the given paths, packing them into the correct byte format. Returns when either the paths are exhausted, or we reached the byte count. Returns a vector of 2 values, the left is the data, the right is the paths that we could not walk due to size limitations. This can be then consulted on subsequent directory reads.

directory? clj

(directory? fh)

Is the file a directory?

example-filesystem! clj

(example-filesystem!)

example-function-for-files clj

(example-function-for-files & {:keys [connection frame stat]})

example-read-write clj

(example-read-write & {:keys [connection frame stat]})

fetch-data clj

(fetch-data connection frame stat)

Helper function for calling read-fn on a stat.

fid->fsname clj macro

(fid->fsname state fid)

Get the filesystem id that a fid belongs to.

fid->mapping clj

(fid->mapping conn fid)

Get the mapping corresponding to an allocated fid.

fid->role clj

(fid->role fid conn)

Given a fid and a connection, return the role associated with it.

fid->stat clj

(fid->stat state fid)

Get the stat corresponding to the fid in the current state of the connection.

file->stat clj

(file->stat file
            path
            &
            {:keys [read-fn parent length]
             :or {read-fn (var identity) parent nil length nil}})

Given a filesystem path, and a 9P path number, create a stat for it. Optional keyword arguments read-fn is a function that is called upon reads, parent is the path of the directory the file belongs to, and length can be used to manually set file size.

filename clj

(filename fh)

Get the name of the file.

frame-afid clj

frame-aname clj

frame-atime clj

frame-count clj

frame-data clj

frame-ename clj

frame-fid clj

frame-ftype clj

frame-iomode clj

frame-iounit clj

frame-length clj

frame-mode clj

frame-msize clj

frame-mtime clj

frame-muid clj

frame-name clj

frame-newfid clj

frame-nwqids clj

frame-offset clj

frame-oldtag clj

frame-qid-path clj

frame-qid-type clj

frame-qid-vers clj

frame-size clj

frame-ssize clj

frame-tag clj

frame-type clj

frame-uname clj

frame-version clj

frame-wnames clj

fs clj

fs-name clj

fsid clj

group clj

(group fh)

Get the group of a file.

insert-file clj

(insert-file fs parent stat)

Given a filesystem, and a path, inserts the stat to the filesystem and updates the provided parent path list of children to include the newly inserted stat.

map->filesystem clj

(map->filesystem m__7910__auto__)

Factory function for class phlegyas.vfs.filesystem, taking a map of keywords to field values.

map->qid clj

(map->qid m__7910__auto__)

Factory function for class phlegyas.vfs.qid, taking a map of keywords to field values.

map->stat clj

(map->stat m__7910__auto__)

Factory function for class phlegyas.vfs.stat, taking a map of keywords to field values.

mapping clj

modification-time clj

(modification-time fh)

Get the last modified time of a file.

next-available-path clj

(next-available-path fs)

Get the next value from the atomic counter.

octal-mode clj

(octal-mode fh)

Get the octal mode permissions of a file.

owner clj

(owner fh)

Get the owner of a file.

path clj

path->qid clj

(path->qid fs path)

Given a filesystem and a path, return the qid for the path.

path->stat clj

(path->stat fs path)

Given a filesystem and a path, return the stat of the file.

permission-check clj

(permission-check stat rolemap operation)

Given a stat, a role, and an operation we want to perform, see if we are allowed to perform it.

permission-set clj

(permission-set fh)

Get the set of permissions for a file.

print-current-time clj

(print-current-time & {:keys [connection frame stat]})

qid-directory? clj

(qid-directory? qid)

Is the provided qid a representation of a directory?

qid-file? clj

(qid-file? qid)

Is the provided qid a representation of a file?

read-dir clj

(read-dir fs stat)

Given a filesystem and a stat, get all children stats of provided stat.

role-resolve clj

(role-resolve stat role)

Given a stat and a role, find what role we have on the stat.

root-dir clj

(root-dir path)

/ stat on a filesystem.

sizeof clj

(sizeof fh)

Get the length of a file.

stat->qid clj

(stat->qid stat)

stat->role clj

(stat->role stat user)

Given a stat, and a user, find what role we have on it.

stat-size clj

(stat-size fname uid gid muid)

Calculate the size of a stat reply.

stat-type clj

(stat-type stat)

Get the type of a stat.

state clj

symbolic-link? clj

(symbolic-link? fh)

Is the file a symbolic link?

synthetic-file clj

(synthetic-file filename
                &
                {:keys [owner group mode read-fn write-fn metadata append]
                 :or {owner "root" group "root" mode 256 append false}})

Create a synthetic file stat.

update-children clj

(update-children fs path keyname child)

Takes a filesystem, a path, a lookup key (filename, hashed), and the child path. Updates the stat corresponding to path on fs by adding the child.

update-mapping clj

(update-mapping state fid data)

Update the mapping for fid with the provided data.

update-stat clj

(update-stat state fid data)

Update the stat associated with fid by adding data to it.

version clj

(version stat)

walk-path clj

(walk-path fs path wnames)

Given a filesystem, a path, and a vector wnames, step through the vector attempting to resolve the path of each. i.e. if we are in the root, and want to go to /a/b/c, wnames would be ["a", "b", "c"]. If we do not find a match for a wname, we return a list of all paths that we did find. In this case, a fid is not changed. Walks are only successful if the entire path can be walked.

wname->path clj

(wname->path fs path wname)

Given a filesystem, a path, and a wname (file name), look through the children of the stat for the given path and return the path associated with that name. We hash the name of the file here, and keywordize it, to prevent issues with keywordizing arbitrary strings.