[LU-16344] Misleading --ost|-O explaination in manual of lfs-getstripe Created: 28/Nov/22  Updated: 06/Dec/22  Resolved: 06/Dec/22

Status: Resolved
Project: Lustre
Component/s: None
Affects Version/s: None
Fix Version/s: Lustre 2.16.0

Type: Bug Priority: Minor
Reporter: Li Xi Assignee: Xing Huang
Resolution: Fixed Votes: 0
Labels: None

Severity: 3
Rank (Obsolete): 9223372036854775807

 Description   

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] }

 

 

 



 Comments   
Comment by Gerrit Updater [ 28/Nov/22 ]

"Xing Huang <hxing@ddn.com>" uploaded a new patch: https://review.whamcloud.com/c/fs/lustre-release/+/49256
Subject: LU-16344 docs: Improve explaination in manual of lfs-getstripe
Project: fs/lustre-release
Branch: master
Current Patch Set: 1
Commit: dfdc1b803397bac27e6394b86407351355ee84b4

Comment by Gerrit Updater [ 06/Dec/22 ]

"Oleg Drokin <green@whamcloud.com>" merged in patch https://review.whamcloud.com/c/fs/lustre-release/+/49256/
Subject: LU-16344 docs: Improve explaination in manual of lfs-getstripe
Project: fs/lustre-release
Branch: master
Current Patch Set:
Commit: e7aa83d105547608130c53c5abc0bb370a1dc1bc

Comment by Peter Jones [ 06/Dec/22 ]

Landed for 2.16

Generated at Sat Feb 10 03:26:12 UTC 2024 using Jira 9.4.14#940014-sha1:734e6822bbf0d45eff9af51f82432957f73aa32c.