diff --git a/assets/xsd/tree.xsd b/assets/xsd/tree.xsd new file mode 100644 index 0000000..d23c2f0 --- /dev/null +++ b/assets/xsd/tree.xsd @@ -0,0 +1,299 @@ + + + + + + XML Schema Definition file for the XML output of the tree command. + + + + + + + A binary value represented in octal. + + + + + + + + + + + Permissions serialized as an octal number. + + + + + + + + + + + Item type and permissions described as a readable string. + The first character determines the item type, and the 9 other characters describe the read, write, execute permissions for the user, group and others, respectively. + The execute permission might be shown as various other characters to denote the set-user-ID, set-group-ID or sticky bits being used. + + + + + + + + + + + + + Name of the item. + + + + + + + Read, write and execute permissions for the item. + + + + + + + Item type and permissions described as a readable string. + + + + + + + Size of the item. + For directories, this can also be the total size of the directory and its items if the --du option was used. + + + + + + + Name of the user that owns this item. + + + + + + + Name of the group that owns this item. + + + + + + + Last modification time or last status change time for the item. + Can be formatted arbitrarily using the --timefmt argument. + + + + + + + Inode number of the item. + + + + + + + Device number to which the item belongs. + + + + + + + A comment added from a .info file. Since version 2.0.0. + + + + + + + + + An error message. + + + + + + + + + + + + + + + + + A directory. + If the directory contents have been listed, this may contain other items. + + + + + + + + + + + + + + + A symbolic link. + If the link has been followed, this may contain other items. + + + + + + + + Path to the target of the symbolic link. + + + + + + + + + + + + + A regular file. + + + + + + + + + A character device. + + + + + + + A block device. + + + + + + + A named first-in first-out (FIFO) pipe. + + + + + + + A socket. + + + + + + + A Solaris door. + + + + + + + A Solaris port. + + + + + + + An unknown item. + + + + + + + + + + Statistics over the whole tree. + + + + + + + Total size of the tree, in bytes. Only included if the --du flag is set. + + + + + + + Total number of directories. + + + + + + + Total number of files. Not included if tree was set to only include directories. + + + + + + + + + + XML output of the tree command, from the -X argument. + + + + + + + + + + diff --git a/content/meta.md b/content/meta.md index db18109..48ecb9d 100644 --- a/content/meta.md +++ b/content/meta.md @@ -125,3 +125,9 @@ wiki for various blog articles, books, etc. that I might stumble upon and find interesting thoughts on, to reproduce the reference system mentioned in that book. One blog post, for which I had written an incomplete two thousand word draft, then gave up on it, could benefit from that. + +## Implementation notes + +This wiki has an [everything](./everything.html) page that gets generated from +the XML output mode of the `tree` command. I wrote an XSD for it to better +document the format: [tree XSD](./xsd/tree.xsd)