LFS-GETNAME(1)

NAME
lfs-getname - retrieve the filesystem name and instance ID

SYNOPSIS
lfs getname [--help|-h] [--instance|-i] [--fsname|-n] [--uuid|-u] [PATHNAME...]

DESCRIPTION
Print the filesystem name, instance ID, and mountpoint for all Lustre mount points on the local client. If one or more PATHNAME arguments are provided, then only print the Lustre filesystem name and instance ID for these mount points.

OPTIONS

-h, --help
    Print usage message.

-i, --instance
    Only show the mount instance ID for each filesystem. If -i is used with a single PATHNAME then the instance ID is printed without the mountpoint.

-n, --fsname
    Print only the Lustre filesystem name for each filesystem. If -n is used with a single PATHNAME then the filesystem name is printed without the mountpoint.

-u, --uuid
    Print only the UUID for this client filesystem mountpoint. Note that this is not a common UUID suitable for mounting the filesystem with, but rather a unique identifier for this specific mount instance. If -u is used with a single PATHNAME then the uuid is printed without the mountpoint.

EXAMPLES
    # lfs getname
    myth-ffff880428703400 /myth
    testfs-ffff937009271000 /mnt/testfs

# lfs getname -n /mnt/testfs
testfs

# lfs getname -i /mnt/testfs
ffff937009271000

# lfs getname -u /mnt/testfs
78adbfe8-1c12-4bd2-a485-69afa166677e

AVAILABILITY
lfs getname is part of the lustre(7) filesystem package since release 2.2.0

SEE ALSO
lfs(1), llapi_getname(3), lustre(7)