llapi_layout_file_comp_del(3)

NAME

llapi_layout_file_comp_del - delete the specified layout component from an existing file.

SYNOPSIS

#include <lustre/lustreapi.h>

int llapi_layout_file_comp_del(const char *path,
                               uint32_t id, uint32_t flags);

DESCRIPTION

Deletes the layout component(s) specified by id or flags from an existing file. The id must be a real unique component ID, when flags is specified, id must be set to zero. Available flags are:

LCME_FL_INIT: Instantiated components in the layout.

LCME_FL_NEG|LCME_FL_INIT: Uninstantiated components in the layout.

RETURN VALUES

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

ERRORS

EINVAL

An invalid argument was specified.

ENOENT

path doesn't exist or the specified component isn't found in file.

AVAILABILITY

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

SEE ALSO

llapi_layout_alloc(3), llapi_layout_comp_id_get(3), llapi_layout_comp_use_id(3), llapi_layout_file_comp_add(3), llapi_layout_file_open(3), llapi_layout_get_by_path(3), llapi_layout(7), lustreapi(7)