doc, update ute file header documentation

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
doc, introduce the concept of a footer in the overall file layout description

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, hygiene, get the constness straight in ute-slut's run_cmd()

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, hygiene, define const_utectx_t in utefile-private.h and constify inline funs

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, hygiene, define const_uteseek_t in utetpc.h and constify inline funs

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, introduce ute_hdrz() and ute_hdrzt() inlines for varying header sizes, express stuff in these units

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
chore, hygiene, instead of using the header type refer to the header slots in the ctx

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
fix, PEBKAC, in ute_npages() iterator over pages with the compressed mark, set the initial iterator to pgsz - otry ...

depending on res (the page we're on), if res == 0, iterate only pgsz - ute_hdrz()

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, migrate flush_tpc() to mmap_any() interface and trunc file to ute_hdrz() if not done so already

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, provide page_size() (and page_sizet()) and migrate load_last_tpc() and tpc_from_seek() to calls to those helpers

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, introduce seek_offset() and seek_set_offset() to pass on the offset of a seek (without the need for a ctx arg in flush_seek())

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
major, shrink struct utehdr2_s size to 4 ticks (64 bytes)

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
Merge branch 'core/file' into next

* core/file:
  major, shrink struct utehdr2_s size to 4 ticks (64 bytes)
  minor, introduce seek_offset() and seek_set_offset() to pass on the offset of a seek (without the need for a ctx arg in flush_seek())
  minor, provide page_size() (and page_sizet()) and migrate load_last_tpc() and tpc_from_seek() to calls to those helpers
  minor, migrate flush_tpc() to mmap_any() interface and trunc file to ute_hdrz() if not done so already
  fix, PEBKAC, in ute_npages() iterator over pages with the compressed mark, set the initial iterator to pgsz - otry ...
  chore, hygiene, instead of using the header type refer to the header slots in the ctx
  minor, introduce ute_hdrz() and ute_hdrzt() inlines for varying header sizes, express stuff in these units
  minor, hygiene, define const_uteseek_t in utetpc.h and constify inline funs
  minor, hygiene, define const_utectx_t in utefile-private.h and constify inline funs
  minor, hygiene, get the constness straight in ute-slut's run_cmd()
  doc, introduce the concept of a footer in the overall file layout description
  doc, update ute file header documentation
minor, upon ute-fsck --compress, also pick UTEHDR_MIN_SIZE as header size

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
Merge branch 'cmd/fsck' into next

* cmd/fsck:
  minor, upon ute-fsck --compress, also pick UTEHDR_MIN_SIZE as header size
chore, assign -z as a short-opt alias for --compress in ute-fsck

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, provide global ute_encode_clevel var to set the compression level

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
minor, provide --compression-level in ute-fsck to allow setting the global ute_encode() compression level

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
Merge branch 'cmd/fsck' into next

* cmd/fsck:
  minor, provide --compression-level in ute-fsck to allow setting the global ute_encode() compression level
  minor, provide global ute_encode_clevel var to set the compression level
  chore, assign -z as a short-opt alias for --compress in ute-fsck
minor, introduce struct uteftr_cell_s to keep track of pages, their size and their position within the file

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>