💾 Archived View for goodclover.xyz › texts › WIP › olive-file-access-protocol.gmi captured on 2022-01-08 at 13:46:00. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2021-12-03)
-=-=-=-=-=-=-
=!= This file was given up on halfway between a change in ideas, it has large issues. =!=
As always, I wrote this for fun and is just a concept.
This would probabbly be really stupid in practice.
A byte is an octet, 8 bits.
Whitespace used in request/resonse headers must be a singular space.
Pretty much your standard URI domain+path.
The trailing slash must only be used for directories.
Servers should be strict about this, returning client errors.
path = [domain-path] (file-path / dir-path) domain-path = "//" name file-path = 1*("/" name dir-path = "/" / file-path "/" ; <name> is a non-zero sequence of printing UTF-8 characters
The client will initiate the transaction, and send a <client-message>.
The server will then respond, either with a <server-resp>.
((TODO: Client item-meta requests))
There are two kinds of client message:
Request codes:
L is identical to repeating I on every file in the folder.
The list may be in any order.
Upload codes:
client-message = request / upload request = "r" ("R" / "L" / "I") SP path CRLF upload = "u" ("W" / "P") SP path SP length CRLF body length = 1*DIGIT ; Decimal digits body = *(%x01-FF) ; Non-null bytes
<length> is the length of the body in bytes.
Errors:
client/request error (fix & retry)
file/permisson error (don't retry)
server error
; WIP TODO server-response =
If the requested path doesn't exist, an error should be returned.
((TODO: Should files and dirs get a different symbol or should the trailing slash be relied on??))
item-list = *(item CRLF) item = file / dir file = " " perms SP length SP file-path dir = "d" perms SP length SP dir-path length = 1*DIGIT ; Decimal digits perms = ("r"/"-")("w"/"-")("m"/"-")
<length> is the length of the file in bytes.
<perms> is the permissions that the client has on that item.
There are three permissons:
((TODO: Better name for "modify meta"))
The read permisson tells the client it can read (R).
The write permisson tells the client it can write (W,P).
The meta permisson tells the client it can modify perms, delete & move.
For directories:
Reading is listing a directories's contents.
Writing is creating new items/moving items to this directory.
((TODO: deleting/moving from??))
Permissons may be different on sub-directories.
e.g. a client may no perms on "/foo/", but may have full perms on "/foo/bar/".
((TODO: Having modify perms on an item inside a dir with no write perms??))
If an upload was succesful, the server should repond with an OK and then info for the file (as if the client had I requested).