whio  Update of "whio_epfs_tools"

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.


Artifact ID: e7ee2339288eda2a6d20c1842d003d98ba888fe5
Page Name:whio_epfs_tools
Date: 2011-05-23 18:50:56
Original User: stephan
Parent: 3a42bcc17943c5539613a7fd79dcd9d285dfb5bf

ACHTUNG: AS OF 20110523, THIS PAGE IS NOW MAINTAINED IN THE NEW WIKI: http://whiki.wanderinghorse.net/wikis/whio/?page=whio_epfs_tools

See also: whio_epfs

whio_epfs Tools

The source tree comes with several tools for working with whio_epfs container files:

These tools primarily assist in the development and testing of whio_epfs, but are useful as examples of using the library and for building/maintaining EPFS built as part of a custom project. Some of them rely on private API routines which most client code won't have access to, but over time (and with client-side experience) the public API will be fleshed out so that client-side tools will have the level of access they would need to implement features like those these tools provide. That said, most of the features these tools implement use only the public API.

Common command arguments

All (or most) of the EFS tools listed above support the following general-purpose arguments:

  • -? or --help = Show app help and quit.
  • -v or --verbose= Enable verbose mode
  • -V or --version = Show version information and quit.
  • --no-locking disables any file locking (if it was is compiled in to the library). Use with care: with this flag set, whio-epfs-mkfs can destroy an opened EFS.

and most of the tools support the following debugging-related arguments:

  • --no-mempool will disable the use of the default fs-internal memory pool (if it was enabled at compile-time).
  • --mempool-size=uint32 dynamically allocates a memory pool of the given size. If the size is smaller than some compile-time constant (probably a couple of kb) then a statically-allocated area of memory is used. If the size is 0, the effect is the same as --no-mempool.

(Exception: whio-epfs-mkfs cannot use a memory pool, for very boring reasons which i have forgotten at the moment.)

The tools also require (except in a small handful of cases) that an EFS file be given as the first non-flag argument on the command line. "Non-flag" means an argument which does not start with '-' or '--'.

Regarding the memory pool options: see whio_epfs_mempool.