find.flexfs

find.flexfs provides fast filesystem search by querying the metadata server directly, bypassing the FUSE layer. It supports filters on inode attributes, timestamps, size, cost, permissions, and file type.

Usage

find.flexfs [flags] [path...]

If no path is specified, the current directory is used. Can operate from within a flexFS mount or connect directly via --metaAddr and --volume.

Flags

Output Control

| Flag | Type | Default | Description | |---|---|---|---| | --fields | string slice | path | Output fields (comma-separated). Use all for all fields. | | --header | bool | false | Include header row in output | | --limit | uint64 | 0 | Maximum number of results (0 = unlimited) | | --noDecode | bool | false | Print base32-encoded paths | | --outputFile, -o | string | | Output file path |

Available fields: path, ino, mode, type, perm, blocks, size, size_bin, cost, nlink, uid, gid, ctime, mtime, atime, btime, xattrs.

The cost field is an estimated monthly storage cost in US dollars ($/month). See the analyze.flexfs cost field documentation for how it is calculated.

Connection

| Flag | Type | Default | Description | |---|---|---|---| | --metaAddr | string | | Metadata server address (must pair with --volume) | | --volume | string | | Volume UUID or name (must pair with --metaAddr) |

Inode Filters

| Flag | Type | Default | Description | |---|---|---|---| | --empty | bool | false | Filter for empty files or directories | | --gid | uint32 | 0 | Filter by group ID | | --ino | uint64 | 0 | Filter by inode number | | --name | string | | Filter by dentry name (supports glob patterns) | | --perm | uint32 | 0 | Required permission bits (octal with 0 prefix, e.g. 0755). Matches when (mode & permMask) == perm. | | --permMask | uint32 | 0777 | Bits of the file mode to test (octal with 0 prefix, max 07777). Default 0777 tests owner/group/other. Set to 07777 to also test setuid/setgid/sticky. | | --sparse | bool | false | Filter for sparse files | | --type | string | | Filter by inode type: b, c, d, f, l, p, s | | --uid | uint32 | 0 | Filter by user ID |

| Flag | Type | Default | Description | |---|---|---|---| | --maxBlocks | uint64 | 0 | Maximum blocks filter | | --maxCost | float64 | 0 | Maximum estimated monthly cost filter ($/month) | | --maxNlink | uint32 | 0 | Maximum hard link count filter | | --maxSize | uint64 | 0 | Maximum byte size filter | | --maxSizeBin | uint32 | 0 | Maximum size bin filter (0-74) | | --minBlocks | uint64 | 0 | Minimum blocks filter | | --minCost | float64 | 0 | Minimum estimated monthly cost filter ($/month) | | --minNlink | uint32 | 0 | Minimum hard link count filter | | --minSize | uint64 | 0 | Minimum byte size filter | | --minSizeBin | uint32 | 0 | Minimum size bin filter (0-74) |

Timestamp Filters

Timestamp values are in seconds since epoch (Unix time).

| Flag | Type | Default | Description | |---|---|---|---| | --maxAtime | uint64 | 0 | Maximum access time | | --maxBtime | uint64 | 0 | Maximum birth time | | --maxCtime | uint64 | 0 | Maximum change time | | --maxMtime | uint64 | 0 | Maximum modification time | | --minAtime | uint64 | 0 | Minimum access time | | --minBtime | uint64 | 0 | Minimum birth time | | --minCtime | uint64 | 0 | Minimum change time | | --minMtime | uint64 | 0 | Minimum modification time |

Depth Control

| Flag | Type | Default | Description | |---|---|---|---| | --maxDepth | uint32 | 0 | Maximum query depth (0 = unlimited) | | --minDepth | uint32 | 0 | Minimum query depth |

Internal Flags

| Flag | Type | Default | Description | |---|---|---|---| | --noMetaSSL | bool | false | Disable SSL for metadata server connections |

Examples

File discovery

Find all files larger than 1 GiB:

find.flexfs --minSize 1073741824 --type f /mnt/flexfs

Find files by name pattern with full metadata:

find.flexfs --name "*.bam" --fields all --header /mnt/flexfs/data

Find empty directories (candidates for cleanup):

find.flexfs --type d --empty /mnt/flexfs

Find all symlinks under a path:

find.flexfs --type l --fields path,size /mnt/flexfs/data

Cost and storage analysis

Find the most expensive files (costing more than $1/month):

find.flexfs --minCost 1 --type f --fields path,size,cost --header /mnt/flexfs

Find cold files (not accessed in over 6 months, size bin 6+) that are still large:

find.flexfs --minSizeBin 6 --minSize 1073741824 --type f \
  --fields path,size,size_bin,cost --header /mnt/flexfs

Timestamp queries

Find files not accessed since January 1 2025 (stale data candidates):

# 2025-01-01T00:00:00Z = 1735689600
find.flexfs --maxAtime 1735689600 --type f /mnt/flexfs

Find files modified in a specific window (e.g. during an incident):

# 2025-03-15 00:00:00Z = 1741996800, 2025-03-16 00:00:00Z = 1742083200
find.flexfs --minMtime 1741996800 --maxMtime 1742083200 --type f \
  --fields path,size,mtime --header /mnt/flexfs

Find files created in the last 7 days:

# Use $(date -d '7 days ago' +%s) on Linux or $(date -v-7d +%s) on macOS
find.flexfs --minBtime $(date -v-7d +%s) --type f /mnt/flexfs

Permissions audit

Find files with exact permissions rwxrwxrwx:

find.flexfs --perm 0777 --type f --fields path,perm /mnt/flexfs

Find world-writable files (other-write bit set):

find.flexfs --perm 02 --permMask 02 --type f --fields path,perm /mnt/flexfs

Find files with the setuid bit set:

find.flexfs --perm 04000 --permMask 04000 --type f --fields path,perm /mnt/flexfs

Ownership

Find all files owned by a specific user:

find.flexfs --uid 1001 --type f --fields path,size,uid /mnt/flexfs

Sparse files

Find sparse files (logical size exceeds allocated blocks):

find.flexfs --sparse --type f --fields path,size,blocks /mnt/flexfs

Exporting and direct connection

Export a full file inventory to TSV:

find.flexfs --fields all --header --type f \
  --outputFile /tmp/inventory.tsv /mnt/flexfs

Query a volume directly without a local mount:

find.flexfs --metaAddr meta.example.com:443 --volume my-vol --type d /

Output Format

Output is tab-separated. The columns correspond to the --fields list. When --header is set, the first line contains field names.