analyze.flexfs

analyze.flexfs reports storage usage by file, folder, or user. It queries the metadata server’s REST API and can operate either from within a mounted flexFS directory or by connecting directly via --metaAddr and --volume.

Subcommands

Subcommand	Description
files	Report top files by size, size_bin, or cost
folders	Report per-directory recursive size and cost
users	Report per-user size and cost
version	Print the build version

Usage

# From within a flexFS mount
cd /mnt/flexfs && analyze.flexfs files

# Or connect directly to a metadata server
analyze.flexfs files --metaAddr meta.example.com:443 --volume my-vol /data

Global Flags

Flag	Type	Default	Description	Visibility
--header	bool	false	Include header row in output	Public
--metaAddr	string		Metadata server address (must pair with --volume)	Public
--noDecode	bool	false	Print base32-encoded paths	Public
--outputFile, -o	string		Output file path	Public
--volume	string		Volume UUID or name (must pair with --metaAddr)	Public
--noMetaSSL	bool	false	Disable SSL for metadata server connections	Internal

files

analyze.flexfs files [--limit N] [--orderBy field] [path...]

Reports the top files by size, size_bin, or cost.

Flag	Type	Default	Description
--limit	uint32	100	Maximum number of results (1-1000)
--orderBy	string	cost	Sort field: size, size_bin, or cost

folders

analyze.flexfs folders [--maxDepth N] [path...]

Reports per-directory recursive size and cost.

Flag	Type	Default	Description
--maxDepth	uint32	0	Maximum output depth (0 = unlimited)

users

analyze.flexfs users [--limit N] [--orderBy field] [path...]

Reports per-user size and cost. Resolves UIDs to usernames when possible.

Flag	Type	Default	Description
--limit	uint32	100	Maximum number of results (1-1000)
--orderBy	string	cost	Sort field: size or cost

Output Format

Output is tab-separated. When --header is set, the first line contains column names. The files subcommand outputs path followed by size/cost fields. The folders subcommand outputs path followed by aggregate stats. The users subcommand outputs UID, username, and cost fields.