LFS-HSM(1)

NAME
hsm_state, hsm_action, hsm_set, hsm_clear - lfs commands used to interact with HSM features

SYNOPSIS
lfs hsm_state [FILE] ...
lfs hsm_action [FILE] ...
lfs hsm_set [--help] [--norelease] [--noarchive] [--dirty] [--exists] [--archived] [--lost] [--archive-id NUM] [FILE] ...
lfs hsm_clear [--help] [--norelease] [--noarchive] [--dirty] [--exists] [--archived] [--lost] [FILE] ...

DESCRIPTION
These are a set of lfs commands used to interact with Lustre/HSM binding feature.

lfs hsm_state [,FILE/]...
    Display the current HSM flags and archive ID for provided files.

lfs hsm_action [,FILE/]...
    Display the in-progress HSM actions for provided files.

lfs hsm_set [,OPTION/]... [,FILE/]...
    Set provided HSM flags on file list.

lfs hsm_clear [,OPTION/]... [,FILE/]...
    Clear the HSM related flags on file list.

Non-privileged user can only change the following flags: norelease, noarchive and dirty.

OPTIONS

--help
    Print usage message.

--norelease
    File should never be released. File data will stay in Lustre even if a copy exists in HSM backend.

--noarchive
    File should never be archived. Useful if this is a temporary file, for example.

--dirty
    File content is not in sync with HSM backend. File should be archived again. (root only)

--exists
    A file copy exists in HSM backend. Useful mostly for debugging. (root only)

--archived
    An up-to-date file copy exists in HSM backend. Useful mostly for debugging. (root only)

--lost
    File copy in HSM backend is not usable anymore and file could not be restored. It should be archived again. (root only)

--archive-id NUM
    Set archive number identifier to value NUM. If archive-id is 0 or option is not provided, then default identifier 0 is used and means no identifier change.

EXAMPLES
Display current HSM flag for foo:
        # lfs hsm_state /mnt/lustre/foo
        /mnt/lustre/foo: (0x0000000b) exists dirty archived, archive_id: 1

Force a file to be considered as modified in lustre (dirty):
        # lfs hsm_set --dirty /mnt/lustre/motd

AUTHORS
Written by Aurelien Degremont.

AVAILABILITY
lfs hsm_action, lfs hsm_clear, lfs hsm_set and lfs hsm_state are part of the lustre(7) filesystem package. lfs hsm_action was added in release 1.7.0. lfs hsm_clear was added in release 2.4.0. lfs hsm_set and lfs hsm_state were added in release 2.0.0.

SEE ALSO
lfs(1)