// reference

Named sessions

Session can now be named and have short description, set during first mount. PrismaFS writes small manifest file next to session directory (not inside it, because it should never be located in mounted filesystem view). Contains name, creation time, description, and BASE layer paths.

mkdir -p ~/pfs-base ~/pfs-session ~/pfs-mnt
echo hello > ~/pfs-base/hello.txt

export SESSION_LAYER_DIR=~/pfs-session
export BASE_LAYER_DIRS=~/pfs-base
prismafs -n myproject --desc "testing named sessions" ~/pfs-mnt

cat ~/pfs-session.prismafs-session

Manifest is text format with one field per line:

name myproject
created 2026-10-05T12:00:00Z
description testing named sessions
base /home/you/pfs-base

Unmount, then mount same session again without -n / --desc:

On macOS:

umount ~/pfs-mnt
prismafs ~/pfs-mnt
cat ~/pfs-session.prismafs-session

On Linux:

fusermount3 -u ~/pfs-mnt
prismafs ~/pfs-mnt
cat ~/pfs-session.prismafs-session

Name, creation time and description stay same as on first mount. Manifest is only written one time for session, later mounts do not modify it.