[LU-16344] Misleading --ost|-O explaination in manual of lfs-getstripe

Tue, 6 Dec 2022 13:18:21 +0000

In "lustre/doc/lfs-getstripe.1":

.BR --ost | -O
Print the starting OST index for the file layout.

It is the same with -i option:

.BR --stripe-index | -i
Print the starting OST index for the file layout.

"Print the starting OST index for the file layout." is not "-O" would do. Actually, "lfs getstrip O lustre0-OST0000" would print the information of the stripes located only on OST0000, and ignore the other stripes:

# lfs getstripe file
file
  lcm_layout_gen:    3
  lcm_mirror_count:  1
  lcm_entry_count:   2
    lcme_id:             1
    lcme_mirror_id:      0
    lcme_flags:          init
    lcme_extent.e_start: 0
    lcme_extent.e_end:   33554432
      lmm_stripe_count:  1
      lmm_stripe_size:   1048576
      lmm_pattern:       raid0
      lmm_layout_gen:    0
      lmm_stripe_offset: 0
      lmm_objects:
      - 0: \{ l_ost_idx: 0, l_fid: [0x100000000:0x35fe:0x0] }

    lcme_id:             2
    lcme_mirror_id:      0
    lcme_flags:          init
    lcme_extent.e_start: 33554432
    lcme_extent.e_end:   EOF
      lmm_stripe_count:  4
      lmm_stripe_size:   1048576
      lmm_pattern:       raid0
      lmm_layout_gen:    0
      lmm_stripe_offset: 2
      lmm_objects:
      - 0: \{ l_ost_idx: 2, l_fid: [0x100020000:0x1f28:0x0] }
      - 1: \{ l_ost_idx: 1, l_fid: [0x100010000:0xefc:0x0] }
      - 2: \{ l_ost_idx: 3, l_fid: [0x100030000:0x1b0f:0x0] }
      - 3: \{ l_ost_idx: 0, l_fid: [0x100000000:0x35ff:0x0] }

# lfs getstripe file -O lustre0-OST0000
file
  lcm_layout_gen:    3
  lcm_mirror_count:  1
  lcm_entry_count:   2
    lcme_id:             1
    lcme_mirror_id:      0
    lcme_flags:          init
    lcme_extent.e_start: 0
    lcme_extent.e_end:   33554432
      lmm_stripe_count:  1
      lmm_stripe_size:   1048576
      lmm_pattern:       raid0
      lmm_layout_gen:    0
      lmm_stripe_offset: 0
      lmm_objects:
      - 0: \{ l_ost_idx: 0, l_fid: [0x100000000:0x35fe:0x0] }

    lcme_id:             2
    lcme_mirror_id:      0
    lcme_flags:          init
    lcme_extent.e_start: 33554432
    lcme_extent.e_end:   EOF
      lmm_stripe_count:  4
      lmm_stripe_size:   1048576
      lmm_pattern:       raid0
      lmm_layout_gen:    0
      lmm_stripe_offset: 2
      lmm_objects:
      - 3: \{ l_ost_idx: 0, l_fid: [0x100000000:0x35ff:0x0] }

Whamcloud Community JIRA

[LU-16344] Misleading --ost|-O explaination in manual of lfs-getstripe