#ifndef IFSFILE_H
#define IFSFILE_H
#ifdef __cplusplus
extern "C" {
#endif
// standard C includes
#include <stdint.h>
#include <stdlib.h>
// compiler-specific glue
#ifdef _WIN32
#ifndef __BYTE_ORDER__
#define __ORDER_BIG_ENDIAN__ 4321
#define __ORDER_LITTLE_ENDIAN__ 1234
#define __BYTE_ORDER__ __ORDER_LITTLE_ENDIAN__ // all Windows machines are little endian
#endif // !__BYTE_ORDER__
#ifndef __builtin_bswap64
#ifdef _MSC_VER
#define __builtin_bswap64(x) _byteswap_uint64 ((unsigned long long) (x))
#endif // _MSC_VER
#endif // !__builtin_bswap64
#ifndef __builtin_bswap32
#ifdef _MSC_VER
#define __builtin_bswap32(x) _byteswap_ulong ((unsigned long) (x))
#endif // _MSC_VER
#endif // !__builtin_bswap32
#ifndef __builtin_bswap16
#ifdef _MSC_VER
#define __builtin_bswap16(x) _byteswap_ushort ((unsigned short) (x))
#endif // _MSC_VER
#endif // !__builtin_bswap32
#endif // _WIN32
#ifdef _MSC_VER
#define START_OF_PACKED_STRUCT() __pragma(pack(push)) __pragma(pack(1))
#define END_OF_PACKED_STRUCT() __pragma(pack(pop))
#define PACKED(thing) thing
#else // !_MSC_VER
#define START_OF_PACKED_STRUCT()
#define END_OF_PACKED_STRUCT()
#define PACKED(thing) thing __attribute__((packed))
#endif // _MSC_VER
// bitmapped flags used in the flags1 member of the startup header
#define STARTUP_HDR_FLAGS1_VIRTUAL (1 << 0)
#define STARTUP_HDR_FLAGS1_BIGENDIAN (1 << 1)
#define STARTUP_HDR_FLAGS1_COMPRESS_NONE ((0 << 4) | (0 << 3) | (0 << 2))
#define STARTUP_HDR_FLAGS1_COMPRESS_ZLIB ((0 << 4) | (0 << 3) | (1 << 2)) // deprecated in mkifs
#define STARTUP_HDR_FLAGS1_COMPRESS_LZO ((0 << 4) | (1 << 3) | (0 << 2)) // TODO: add this compression scheme with liblzo
#define STARTUP_HDR_FLAGS1_COMPRESS_UCL ((0 << 4) | (1 << 3) | (1 << 2))
#define STARTUP_HDR_FLAGS1_COMPRESS_MASK ((1 << 4) | (1 << 3) | (1 << 2))
#define STARTUP_HDR_FLAGS1_TRAILER_V2 (1 << 5) // if set, then a struct startup_trailer_v2 follows the startup. If the image is compressed, then the compressed imagefs is followed by a struct image_trailer_v2
// bitmapped flags used in the flags member of the image header
#define IMAGE_FLAGS_BIGENDIAN (1 << 0) // header, trailer, dirents in big-endian format
#define IMAGE_FLAGS_READONLY (1 << 1) // do not try to write to image (rom/flash)
#define IMAGE_FLAGS_INO_BITS (1 << 2) // inode bits valid
#define IMAGE_FLAGS_SORTED (1 << 3) // dirent section is sorted (by pathname)
#define IMAGE_FLAGS_TRAILER_V2 (1 << 4) // image uses struct image_trailer_v2
// bitmapped flags superposed to a filesystem entry's inode number
#define IFS_INO_PROCESSED_ELF (1 << 31)
#define IFS_INO_RUNONCE_ELF (1 << 30)
#define IFS_INO_BOOTSTRAP_EXE (1 << 29)
// compiled boot script command types
#define SCRIPTCMD_TYPE_EXTERNAL "\x00"
#define SCRIPTCMD_TYPE_WAITFOR "\x01"
#define SCRIPTCMD_TYPE_REOPEN "\x02"
#define SCRIPTCMD_TYPE_DISPLAY_MSG "\x03"
#define SCRIPTCMD_TYPE_PROCMGR_SYMLINK "\x04"
#define SCRIPTCMD_TYPE_EXTSCHED_APS "\x05"
// compiled boot script external command flags
#define SCRIPTCMD_FLAG_EXTSCHED (1 << 0)
#define SCRIPTCMD_FLAG_SESSION (1 << 1)
#define SCRIPTCMD_FLAG_SCHED_SET (1 << 2)
#define SCRIPTCMD_FLAG_CPU_SET (1 << 3)
#define SCRIPTCMD_FLAG_UNKNOWN1 (1 << 4) // ???
#define SCRIPTCMD_FLAG_BACKGROUND (1 << 5)
#define SCRIPTCMD_FLAG_KDEBUG (1 << 6)
#define SCRIPTCMD_FLAG_UNKNOWN2 (1 << 7) // ???
// compiled boot script external command scheduling policies
#define SCRIPTCMD_SCHEDULERPOLICY_FIFO 1
#define SCRIPTCMD_SCHEDULERPOLICY_RR 2
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) fsentry_s
{
PACKED (struct) fsentry_header_s
{
uint16_t size; // size of dirent
uint16_t extattr_offset; // if zero, no extattr data
uint32_t ino; // if zero, skip entry
uint32_t mode; // mode and perms of entry
uint32_t gid;
uint32_t uid;
uint32_t mtime;
} header;
PACKED (union) fsentry_specific_u
{
PACKED (struct) fsentry_file_s // when (mode & S_IFMT) == S_IFREG
{
uint32_t offset; // offset from header
uint32_t size;
char *path; // null terminated path (no leading slash)
uint8_t *UNSAVED_databuf; // file data blob buffer (convenience pointer, NOT SAVED IN THE IFS)
} file;
PACKED (struct) fsentry_dir_s // when (mode & S_IFMT) == S_IFDIR
{
char *path; // null terminated path (no leading slash)
} dir;
PACKED (struct) fsentry_symlink_s // when (mode & S_IFMT) == S_IFLNK
{
uint16_t sym_offset; // offset to 'contents' from 'path'
uint16_t sym_size; // strlen (contents)
char *path; // null terminated path (no leading slash)
char *contents; // null terminated symlink contents
} symlink;
PACKED (struct) fsentry_device_s // when (mode & S_IFMT) == S_IF<CHR|BLK|FIFO|NAM|SOCK>
{
uint32_t dev;
uint32_t rdev;
char *path; // null terminated path (no leading slash)
} device;
} u;
bool UNSAVED_was_data_written; // whether this entry's data was written to the image (convenience member, NOT SAVED IN THE IFS)
} fsentry_t;
END_OF_PACKED_STRUCT () // restore default alignment
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) startup_header_s // size 256 bytes
{
// I - used by the QNX IPL
// S - used by the startup program
uint8_t signature[4]; // [I ] Header signature, "\xeb\x7e\xff\x00"
uint16_t version; // [I ] Header version, i.e. 1
uint8_t flags1; // [IS] Misc flags, 0x21 (= 0x20 | STARTUP_HDR_FLAGS1_VIRTUAL)
uint8_t flags2; // [ ] No flags defined yet (0)
uint16_t header_size; // [ S] sizeof(struct startup_header), i.e. 256
uint16_t machine; // [IS] Machine type from elfdefinitions.h, i.e. 0x003E --> _ELF_DEFINE_EM(EM_X86_64, 62, "AMD x86-64 architecture")
uint32_t startup_vaddr; // [I ] Virtual Address to transfer to after IPL is done, here 0x01403008 (appears in "Entry" column for "startup.*")
uint32_t paddr_bias; // [ S] Value to add to physical address to get a value to put into a pointer and indirected through, here 0 (no indirections)
uint32_t image_paddr; // [IS] Physical address of image, here 0x01400f30 (appears in "Offset" column for "startup-header" which is the first entry/start of file)
uint32_t ram_paddr; // [IS] Physical address of RAM to copy image to (startup_size bytes copied), here 0x01400f30 (same as above)
uint32_t ram_size; // [ S] Amount of RAM used by the startup program and executables contained in the file system, here 0x00cd6128 i.e. 13 459 752 dec. which is 13 Mb. i.e. IFS file size minus 0x9eee
uint32_t startup_size; // [I ] Size of startup (never compressed), here 0x02f148 or 192 840 bytes
uint32_t stored_size; // [I ] Size of entire image, here 0x00cd6128 (same as ram_size)
uint32_t imagefs_paddr; // [IS] Set by IPL to where the imagefs is when startup runs (0)
uint32_t imagefs_size; // [ S] Size of uncompressed imagefs, here 0x00ca6fe0 or 13 266 912 bytes
uint16_t preboot_size; // [I ] Size of loaded before header, here 0xf30 or 3888 bytes (size of "bios.boot" file))
uint16_t zero0; // [ ] Zeros
uint32_t zero[1]; // [ ] Zeros
uint64_t addr_off; // [ S] Offset to add to startup_vaddr, image_paddr, ram_paddr, and imagefs_paddr members, here zero (0)
uint32_t info[48]; // [IS] Array of startup_info* structures (zero filled)
} startup_header_t;
END_OF_PACKED_STRUCT () // restore default alignment
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) startup_trailer_s
{
uint32_t cksum; // checksum from start of header to start of trailer
} startup_trailer_v1_t;
END_OF_PACKED_STRUCT () // restore default alignment
// NOTE: The checksums in this trailer will only be valid prior to entering startup.
// Because the startup binary is executed in-place, its data segment will change once the program is running.
// Hence, any checksum validation would need to be done by the boot loader / IFS.
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) startup_trailer_v2_s
{
uint8_t sha512[64]; // SHA512 from start of header to start of trailer
uint32_t cksum; // checksum from start of header to start of this member
} startup_trailer_v2_t;
END_OF_PACKED_STRUCT () // restore default alignment
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) image_header_s
{
uint8_t signature[7]; // image filesystem signature, i.e. "imagefs"
uint8_t flags; // endian neutral flags, 0x1c
uint32_t image_size; // size from start of header to end of trailer (here 0xca6fe0 or 13 266 912)
uint32_t hdr_dir_size; // size from start of header to last dirent (here 0x12b8 or 4792)
uint32_t dir_offset; // offset from start of header to start of first dirent (here 0x5c or 92)
uint32_t boot_ino[4]; // inode of files for bootstrap pgms (here 0xa0000002, 0, 0, 0)
uint32_t script_ino; // inode of file for script (here 3)
uint32_t chain_paddr; // offset to next filesystem signature (0)
uint32_t spare[10]; // zerofill
uint32_t mountflags; // default _MOUNT_* from sys/iomsg.h (0)
char mountpoint[4]; // default mountpoint for image ("/" + "\0\0\0")
} image_header_t;
END_OF_PACKED_STRUCT () // restore default alignment
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) image_trailer_v1_s
{
uint32_t cksum; // checksum from start of header to start of trailer
} image_trailer_v1_t; // NOTE: this is the same structure as startup_trailer_v1_t
END_OF_PACKED_STRUCT () // restore default alignment
// NOTE: the checksums in this trailer will only be valid until the first non-startup bootstrap binary (e.g., startup-verifier, procnto, ...) is invoked.
// Because bootstrap binaries execute in-place, their data segments will change once the programs are running.
// Hence, any checksum validation would need to be done either by the boot loader / IFS or by the startup.
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) image_trailer_v2_s
{
uint8_t sha512[64]; // SHA512 from start of image header to start of trailer
uint32_t cksum; // checksum from start of header to start of this member
} image_trailer_v2_t; // NOTE: this is the same structure as startup_trailer_v2_t
END_OF_PACKED_STRUCT () // restore default alignment
START_OF_PACKED_STRUCT () // we need byte-alignment for this struct
typedef PACKED (struct) bootargs_entry_s
{
uint8_t size_lo; // includes entire structure
uint8_t size_hi;
uint8_t argc; // number of C-style strings that make up argv[] in args
uint8_t envc; // number of C-style strings that make up envp[] in args after argv[]
// if the actual startup header address cannot be represented in 32 bits, then shdr_addr is set to 0xFFFFFFFF and a uint64_t with the REAL shdr_address
// immediately follows the last byte of the variable-length <args>. It will be included in the advertised <size_*> and is located at <bootargs_addr>+<size>-8
uint32_t shdr_addr;
//char *args; // variable length
} bootargs_entry_t;
END_OF_PACKED_STRUCT () // restore default alignment
// undefine the helpers we no longer need
#undef START_OF_PACKED_STRUCT
#undef END_OF_PACKED_STRUCT
#undef PACKED
#ifdef __cplusplus
}
#endif
#endif // IFSFILE_H