lfs-getname(1)

NAME

lfs-getname - retrieve the filesystem name and instance ID

SYNOPSIS

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)