# Directory Structure Image (DSI) File Format. # Lines starting with hash ('#') characteres are comments. # Hash characters inline are comments # Support for characters in filenames is limited to ASCII (not extended ASCII) The general format of data lines (i.e. non-commment lines) is: <DirectiveOrElement> <Data> where <DirectiveOrElement> is one of a fixed set of values, and <Data> depends on <DirectiveOrElement>. <DirectiveOrElement> can be one of i, d, D, f, s. The format of <Data> for element and directives types is: i <Tag> <ImageVersion> The 'i' Info entry contains package metadata provided by the user upon DSI creation. There can be only one 'i' entry per DSI file, and it must be the first entry. <Tag> Form: alphanumeric+dash+underbar Sample: FGS Comments: This is the index into the DSI database. <ImageVersion> Form: alphanumeric+dash+underbar Sample: 2022.1.19340 Comments: This is the user-defined version identifier for the image. d <RelPath>|<Owner>:<Group>|<Perms>|<Timestamp> The 'd' is a directory element. <RelPath> is the relative path to the directory from the package root <Owner>:<Group> are the owner/group settings as used by the `chown` command. <Perms> are the file permissions as used by the `chmod` command. <Timestamp> is the file timestamp as reported by the `ls -l` command. D <RelPath>|<Owner>:<Group>|<RecusrivePerms> The 'D' is a shorthand way to specify that all directories under the relative path have the same permissions. (NOT IMPLEMENTED, FOR FUTURE USE) f <RelPath>|<Owner>:<Group>|<Perms>|<Timestamp>|<Checksum> The 'f' is a file element. s <RelPath>|<Owner>:<Group>|<Perms>|<LinkTarget> The 's' is a symbolic link element. <ImageTag> is the tag name for a product, e.g. 'fgs' for the Friendly Greeting System product. The <Owner>:<Group> defines the Operating System owner and group. <Perms> contains permission data, of the form <OwnerPerms>:<GroupPerms>:<OtherPerms>, as reported by `ls`, e.g. rwxr-x---. LIMITATIONS: * DSI works only with regular files, directories, and symlinks. Block special devices and character special devices, sockets, pipes, and other exotic items that can appear in a directory structure are not handled. Handling of such items is undefined. * DSI descriptions only support non-extended ASCII text.
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#4 | 28669 | C. Thomas Tyler | Initial images created. | ||
#3 | 28630 | C. Thomas Tyler |
Refined and simplified image file format and related terminology. Implemented rudimentary file creation/listing logic. |
||
#2 | 27133 | C. Thomas Tyler | Doc refinements. | ||
#1 | 27130 | C. Thomas Tyler | Added AsciiDoc. | ||
//dsi/dev/src/pkg_format.txt | |||||
#1 | 26937 | C. Thomas Tyler | Added packge format file, other work in progess. |