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

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

`lfs mirror read` **--mirror-id**|**-N** *MIRROR\_ID* \[**--outfile**|**-o** *OUTPUT\_FILE*] *MIRRORED\_FILE*

# [DESCRIPTION](#DESCRIPTION)

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.

# [OPTIONS](#OPTIONS)

[**-N**, **--mirror-id** *MIRROR\_ID*](#N)

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.

[**-o**, **--outfile** *output\_file*](#o)

The path name of the output file, if not specified, the standard output stream will be used.

# [EXAMPLES](#EXAMPLES)

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
```

# [AVAILABILITY](#AVAILABILITY)

The **lfs mirror read** command is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 2.12.0

# [SEE ALSO](#SEE_ALSO)

[**lfs**(1)](/man/enterprise-packages/lustre/lfs.1), [**lfs-getstripe**(1)](/man/enterprise-packages/lustre/lfs-getstripe.1), [**lfs-mirror-copy**(1)](/man/enterprise-packages/lustre/lfs-mirror-copy.1), [**lfs-mirror-create**(1)](/man/enterprise-packages/lustre/lfs-mirror-create.1), [**lfs-mirror-delete**(1)](/man/enterprise-packages/lustre/lfs-mirror-delete.1), [**lfs-mirror-extend**(1)](/man/enterprise-packages/lustre/lfs-mirror-extend.1), [**lfs-mirror-resync**(1)](/man/enterprise-packages/lustre/lfs-mirror-resync.1), [**lfs-mirror-split**(1)](/man/enterprise-packages/lustre/lfs-mirror-split.1), [**lfs-mirror-verify**(1)](/man/enterprise-packages/lustre/lfs-mirror-verify.1), [**lfs-mirror-write**(1)](/man/enterprise-packages/lustre/lfs-mirror-write.1), [**lfs-setstripe**(1)](/man/enterprise-packages/lustre/lfs-setstripe.1)

2024-08-20 Lustre

---

Document: lfs-mirror-read(1) from lustre 2.17.59-r2 (Chainguard OS)
Source: https://github.com/lustre/lustre-release
