Viewing: llapi_layout_stripe_count_get.3
.TH LLAPI_LAYOUT_STRIPE_COUNT_GET 3 2024-08-27 "Lustre User API" "Lustre Library Functions"
.SH NAME
llapi_layout_stripe_count_get, llapi_layout_stripe_count_set \- get or set the stripe count of a Lustre file
.SH SYNOPSIS
.nf
.B #include <lustre/lustreapi.h>
.PP
.BI "int llapi_layout_stripe_count_get(const struct llapi_layout *" layout ",
.BI " uint64_t *" stripe_count );
.PP
.BI "int llapi_layout_stripe_count_set(struct llapi_layout *" layout ",
.BI " uint64_t " stripe_count );
.fi
.SH DESCRIPTION
The stripe count of a Lustre file defines the number of OSTs used to
store the file.
.PP
.B llapi_layout_stripe_count_get()
stores into
.I stripe_count
the stripe count of
.IR layout .
.PP
.B llapi_layout_stripe_count_set()
sets the stripe count of
.I layout
to
.IR stripe_count .
.PP
A
.I stripe_count
value of
.B LLAPI_LAYOUT_DEFAULT
means that the default stripe count will be used.
.PP
A
.I stripe_count
value of
.B LLAPI_LAYOUT_WIDE
means that the file will be striped as widely as possible.
.SH RETURN VALUES
.B llapi_layout_stripe_count_get()
and
.B llapi_layout_stripe_count_set()
return 0 on success, or -1 if an error occurred (in which case, errno is
set appropriately).
.SH ERRORS
.TP 15
.B EINVAL
An invalid argument was specified.
.SH AVAILABILITY
.B llapi_layout_stripe_count_get()
and
.B llapi_layout_stripe_count_set()
is part of the
.BR lustre (7)
user application interface library since release 2.7.0
.\" Added in commit v2_6_51_0-23-g3d3a37c9c8
.SH SEE ALSO
.BR llapi_layout_alloc (3),
.BR llapi_layout_file_open (3),
.BR llapi_layout (7),
.BR lustreapi (7)
