llapi_layout_comp_id_get(3)

NAME

llapi_layout_comp_id_get - get the ID of a layout component.

SYNOPSIS

#include <lustre/lustreapi.h>

int llapi_layout_comp_id_get(const struct llapi_layout *layout,
                             uint32_t *comp_id);

DESCRIPTION

Return the unique numeric ID comp_id of the currently active component of layout. The ID of a component is a unique numeric identifier for the component within the layout of each file, and no age, ordering, relative position, or other semantics are implied by the component ID. If a file's layout is modified a large number of times, the component ID may be re-used but will always be unique within a single file's layout.

RETURN VALUES

Return 0 on success. Return -1 if an error occurred and set errno appropriately.

ERRORS

EINVAL

An invalid argument was specified.

AVAILABILITY

llapi_layout_comp_id_get() is part of the lustre(7) user application interface library since release 2.10.0

SEE ALSO

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