1.1 --- a/docs/wiki/Components Wed Mar 02 22:27:28 2022 +0100
1.2 +++ b/docs/wiki/Components Wed Mar 02 23:23:37 2022 +0100
1.3 @@ -201,6 +201,45 @@
1.4 Alongside regular files, directories may also be opened. Reading from them
1.5 yields a listing of directory entries.
1.6
1.7 +=== Removing ===
1.8 +
1.9 +Filesystem objects are removed by invoking the `remove` operation on an opener
1.10 +context:
1.11 +
1.12 +{{{
1.13 +remove()
1.14 +}}}
1.15 +
1.16 +The path information identifying the object must first be written to the
1.17 +context's memory region.
1.18 +
1.19 +=== Renaming ===
1.20 +
1.21 +Filesystem objects are renamed by invoking the `rename` operation on an opener
1.22 +context:
1.23 +
1.24 +{{{
1.25 +rename()
1.26 +}}}
1.27 +
1.28 +The path information of the affected object and the destination of the rename
1.29 +operation must first be written to the context's memory region. The
1.30 +destination path follows immediately after the terminating byte of the
1.31 +affected path.
1.32 +
1.33 +=== Statistics/Metadata ===
1.34 +
1.35 +Statistics or metadata for a filesystem object can be obtained by invoking the
1.36 +`stat` operation on an opener context:
1.37 +
1.38 +{{{
1.39 +stat()
1.40 +}}}
1.41 +
1.42 +The path information identifying the object must first be written to the
1.43 +context's memory region. As a result of the invocation, a `stat` data
1.44 +structure will be written to the start of the memory region.
1.45 +
1.46 == Files ==
1.47
1.48 Files themselves act as dataspaces, meaning that they can be attached to a