RELEASE-v0.9: add pddb libstd notes

Signed-off-by: Sean Cross <sean@xobs.io>
This commit is contained in:
Sean Cross 2022-07-05 23:57:01 +08:00
parent 086c014de2
commit fe4211bb15

View file

@ -182,6 +182,18 @@ perform the Xous firmware upgrade. This requires running manual update commands,
- context switches that revert to a prior app screen are restored from a stashed bitmap instead of a full redraw. This - context switches that revert to a prior app screen are restored from a stashed bitmap instead of a full redraw. This
prevents old menus, contexts, and defacements from "piling up" when an app is blocked due to an exceptional condition prevents old menus, contexts, and defacements from "piling up" when an app is blocked due to an exceptional condition
being raised (such as the PDDB requesting a full basis unlock to generate the FSCB) being raised (such as the PDDB requesting a full basis unlock to generate the FSCB)
- PDDB support in libstd
- Directories are implemented as dicts in the flat namespace
- The `:` separator is used between path components
- A path that begins with a `:` specifies a basis. That is, the path `example` specifies a dict in the Union basis, while the path `:.System:example` specifies a dict `example` in the basis `.System`.
- A path that is only `:` specifies `all bases`, and is used to list the open bases
- The path `::` specifies the "default basis", which is the most recently-opened one
- Because the path delimiter is `:`, this cannot be used as a string in filenames
- Note, however, that the underlying API allows for `:` in filenames, which will confuse the libstd API
- It is possible for a "file" and a "directory" with the same name to exist in the same "directory". In this case, the entity will return `true` for both `.is_file()` and `.is_directory()`. In practice this doesn't matter, since there are different calls for working with files and directories.
- When deleting a file, it is immediately deleted and all open file handles on the system are now invalid. This is in contrast to other platforms where open file handles still work, or where a file that is open cannot be deleted.
- It is not yet possible to create or delete bases using this API.
- Libstd support for PDDB is not possible with hosted mode. File operations will write to your local filesystem.
## Roadmap to 1.0 ## Roadmap to 1.0