Where is the pool layer documentation?

[joachimmetz]

Where is the TSK pool layer documented?

http://wiki.sleuthkit.org/index.php?title=TSK_Tool_Overview does not mention the concept of pools

A third party paper seems to mention some details https://www.researchgate.net/publication/318925723_Extending_The_Sleuth_Kit_and_its_underlying_model_for_pooled_storage_file_system_forensic_analysis

[joachimmetz]

Questions to be answered:

• what is the role of the CompatPool versus the "regular" Pool object?
• Why is GUID a member of the base Pool object? https://github.com/sleuthkit/sleuthkit/blob/develop/tsk/pool/tsk_pool.hpp#L41. What if the identifier of a pool is not a GUID/UUID?
• what is the design decision behind having apfs_open check for the pool (https://github.com/sleuthkit/sleuthkit/blob/develop/tsk/fs/apfs_open.cpp#L26)? shouldn't this be transparent?
• tsk_pool_read appears to be only used by the Java bindings https://github.com/sleuthkit/sleuthkit/blob/develop/tsk/pool/tsk_pool.h#L93? https://github.com/sleuthkit/sleuthkit/blob/0239c5934e348699d0be38f694fb6320252a91fc/bindings/java/jni/dataModel_SleuthkitJNI.cpp#L1676
• what is the design decision about directly passing offset provided via -o OFFSET to the pool image instead of using logical/relative offset on the pool layer?
• should the image size of the compat image layer be the size of the physical volume or the logical volume?