OS Manuals

lfs-mirror-read(1)

lfs-mirror-read - read a mirror's content of a mirrored file

LFS-MIRROR-READ(1) Lustre User Utilities LFS-MIRROR-READ(1)

lfs-mirror-read - read a mirror's content of a mirrored file

lfs mirror read --mirror-id|-N MIRROR_ID [--outfile|-o OUTPUT_FILE] MIRRORED_FILE

This command reads the content of a file's mirror, the file is specified by the path name MIRRORED_FILE, the mirror is specified by its mirror ID MIRROR_ID.

If an OUTPUT_FILE is specified, the content will be written to the file, otherwise the standard output stream will be used.

This option indicates the content of which mirror specified by MIRROR_ID needs to be read. The MIRROR_ID is the numerical unique identifier for a mirror.
The path name of the output file, if not specified, the standard output stream will be used.

Dump the content of mirror with mirror ID 3 for /mnt/lustre/file1 to STDOUT:

# lfs mirror read --mirror-id 3 /mnt/lustre/file1

Dump the content of mirror with mirror ID 2 for /mnt/lustre/file1 to file /tmp/m2:

# lfs mirror read -N 2 -o /tmp/m2 /mnt/lustre/file1

The lfs mirror read command is part of the lustre(7) filesystem package since release 2.12.0

lfs(1), lfs-getstripe(1), lfs-mirror-copy(1), lfs-mirror-create(1), lfs-mirror-delete(1), lfs-mirror-extend(1), lfs-mirror-resync(1), lfs-mirror-split(1), lfs-mirror-verify(1), lfs-mirror-write(1), lfs-setstripe(1)

2024-08-20 Lustre

lustre 2.17.59-r1 · enterprise-packages · ingested 2026-10-02