[LUDOC-2] Update documentation for new lfs getstripe option Created: 19/May/11  Updated: 27/Nov/12  Resolved: 30/Mar/12

Status: Closed
Project: Lustre Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Task Priority: Blocker
Reporter: Jessica A. Popp (Inactive) Assignee: Jian Yu
Resolution: Fixed Votes: 0
Labels: releases

Rank (Obsolete): 7208

 Description   

LU-64 patches added new lfs getstripe option. The manpage is updated, need to see if any other documentation needs to be updated too.

 Comments   
Comment by Peter Jones [ 23/Jan/12 ]

Lai

Could you please add the information that needs to be added to the manual for your LU-64 changes to this ticket. Don't worry about formatting, grammar etc - the doc writer will take care of that

Thanks

Peter

Comment by Lai Siyao [ 06/Feb/12 ]

"lfs getstripe" should report the global default for any fields with
a value that means "use the default". This patch introduces the
following functionality:

1. If "lfs getstripe" is called on a directory and finds that striping
EA is not set, the filesystem's defaults are looked up and printed.
2. If the striping EA is set, but the striping count and/or striping
size has a value that means "use the default" (count = 0 and/or
size = 0), the filesystem's default for that specific striping
attribute is looked up and printed.
3. A new option to "lfs getstripe" is introduced; the "--raw" or
"-R" option. If this option is specified, the previous two checks
are skipped. In other words, if the striping EA is not set, 0, 0,
-1, will be printed for the striping count, size, and offset
respectively. Also, if the striping EA is set, the values will be
printed without first converting them into their respective
defaults.

Comment by Lai Siyao [ 06/Feb/12 ]

Hi Peter, I found the commit log is quite clear, do you think it's enough?

Comment by Peter Jones [ 09/Feb/12 ]

Yes. Thanks Lai!

Comment by Andreas Dilger [ 09/Feb/12 ]

Lai, the lustre/doc/lfs.1 man page already documents the --raw option, so I think this part is OK. What still needs to be done is checkout lustre-manual and see where "lfs getstripe" is described, to see if it needs to be updated there also.

Comment by Peter Jones [ 13/Feb/12 ]

Lai may have missed the guidance from Andreas due to reassignment

Comment by Peter Jones [ 26/Mar/12 ]

Yujian will help complete this work

Comment by Jian Yu [ 28/Mar/12 ]

What still needs to be done is checkout lustre-manual and see where "lfs getstripe" is described, to see if it needs to be updated there also.

Patch is in http://review.whamcloud.com/2414.

Comment by Jian Yu [ 30/Mar/12 ]

The manual update has been merged.

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