llapi_layout_pattern_get(3)

NAME

llapi_layout_pattern_get, llapi_layout_pattern_set - get or set the RAID striping pattern of a Lustre file

SYNOPSIS

#include <lustre/lustreapi.h>

int llapi_layout_pattern_get(const struct llapi_layout *layout,
                             uint64_t *pattern);

int llapi_layout_pattern_set(struct llapi_layout *layout,
                             uint64_t pattern);

DESCRIPTION

llapi_layout_pattern_get() stores into pattern the RAID striping pattern used by layout layout.

llapi_layout_pattern_set() sets the RAID striping pattern of layout to pattern. Currently the only supported RAID pattern is RAID0. If pattern is not a supported RAID pattern the return value will be -1 and errno will be set to EOPNOTSUPP.

A pattern value of LLAPI_LAYOUT_DEFAULT means that the filesystem default RAID pattern will be used.

A pattern value of LLAPI_LAYOUT_RAID0 means that the RAID0 pattern will be used.

RETURN VALUES

llapi_layout_pattern_get() and llapi_layout_pattern_set() return 0 on success, or -1 if an error occurred (in which case, errno is set appropriately).

ERRORS

EINVAL

An invalid argument was specified.

EOPNOTSUPP

An unsupported RAID pattern was specified.

AVAILABILITY

llapi_layout_pattern_get() and llapi_layout_pattern_set() are part of the lustre(7) user application interface library since release 2.7.0

SEE ALSO

llapi_layout_alloc(3), llapi_layout_file_open(3), llapi_layout(7), lustreapi(7)