X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flfs-hsm.1;h=b5261fd8c588e4d25ac5bd1dbe4bff24401c4be2;hb=5787efc44c8e6501c8d7b0bb4e1c0aa1ec2248fb;hp=72e2d766054ad96442619f0cd79468b820a58f21;hpb=c42b426c87c3d3b1dc9eda612cc831293dc80d68;p=fs%2Flustre-release.git

diff --git a/lustre/doc/lfs-hsm.1 b/lustre/doc/lfs-hsm.1
index 72e2d76..b5261fd 100644
--- a/lustre/doc/lfs-hsm.1
+++ b/lustre/doc/lfs-hsm.1
@@ -1,30 +1,43 @@
-.TH lfs-hsm 1 "November 9, 2012" Lustre "Lustre/HSM binding utility"
+.TH LFS-HSM 1 "April 20, 2022" Lustre "Lustre/HSM binding utility"
 .SH NAME
-.Blfs hsm_command
-lfs commands used to interact with HSM features
+hsm_state, hsm_action, hsm_set, hsm_clear \- lfs commands used to interact with HSM features
 .SH SYNOPSIS
 .B lfs hsm_state
-.RB <FILE> ...
-.br
-.B  lfs hsm_set|hsm_clear
-.RB [ --norelease ]
-.RB [ --noarchive ]
-.RB [ --dirty ]
-.RB [ --exists ]
-.RB [ --archived ]
-.RB [ --lost ]
-.RB <FILE> ...
-.br
+[\fI\,FILE\/\fR]...
+.PP
+.B lfs hsm_action
+[\fI\,FILE\/\fR]...
+.PP
+.B lfs hsm_set
+[\fB\-\-norelease\fR]
+[\fB\-\-noarchive\fR]
+[\fB\-\-exists\fR]
+[\fB\-\-archived\fR]
+[\fB\-\-lost\fR]
+[\fB\-\-archive-id\fR \fINUM\fR]
+[\fI\,FILE\/\fR]...
+.PP
+.B lfs hsm_clear
+[\fB\-\-norelease\fR]
+[\fB\-\-noarchive\fR]
+[\fB\-\-exists\fR]
+[\fB\-\-archived\fR]
+[\fB\-\-lost\fR]
+[\fI\,FILE\/\fR]...
+.PP
 .SH DESCRIPTION
 These are a set of lfs commands used to interact with Lustre/HSM binding feature.
 .TP
-.B lfs hsm_state <FILE> ...
+.B lfs hsm_state \fR[\fI\,FILE\/\fR]...
 Display the current HSM flags and archive ID for provided files.
 .TP
-.B lfs hsm_set <FILE>...
+.B lfs hsm_action \fR[\fI\,FILE\/\fR]...
+Display the in-progress HSM actions for provided files.
+.TP
+.B lfs hsm_set \fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
 Set provided HSM flags on file list.
 .TP
-.B lfs hsm_clear <FILE>...
+.B lfs hsm_clear \fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
 Clear the HSM related flags on file list.
 .PP
 Non-privileged user can only change the following flags:
@@ -53,6 +66,9 @@ An up-to-date file copy exists in HSM backend. Useful mostly for debugging. (roo
 .TP
 .B \\--lost
 File copy in HSM backend is not usable anymore and file could not be restored. It should be archived again. (root only)
+.TP
+.B \\--archive-id \fINUM\fR
+Set archive number identifier to value \fINUM\fR. If archive-id is 0 or option is not provided, then default identifier 0 is used and means no identifier change.
 .SH EXAMPLES
 .TP
 .B Display current HSM flag for foo:
@@ -69,6 +85,6 @@ Written by Aurelien Degremont.
 
 .SH KNOWN BUGS
 .PP
-Please report all bugs to http://jira.whamcloud.com/
+Please report all bugs to https://jira.whamcloud.com/
 .SH SEE ALSO
 .BR lfs (1)