llapi_dir_create_foreign(3)

NAME

llapi_dir_create_foreign - create a foreign directory entry

SYNOPSIS

#include <lustre/lustreapi.h>

int llapi_dir_create_foreign(const char *name, mode_t mode,
                             __u32 type, __u32 flags,
                             const char *value)

DESCRIPTION

llapi_dir_create_foreign() creates a foreign directory entry that stores a reference to external storage or metadata. This allows Lustre to track and manage directories that reside outside the Lustre filesystem.

The arguments are as follows:

name

The pathname of the directory entry to create. The parent directory must already exist and be on a Lustre filesystem.

mode

The permission bits for the new directory, as described in open(2).

type

The type of foreign directory. This identifies what kind of external storage or system the foreign reference points to.

flags

Flags controlling the behavior of the foreign directory entry.

value

A string value containing the foreign reference information, such as a path or identifier in the external system.

RETURN VALUE

llapi_dir_create_foreign() returns 0 on success, or a negative errno value on failure.

ERRORS

-EACCES

Permission denied on parent directory.

-EALREADY

Stripe already set on existing directory.

-EEXIST

Directory already exists.

-EINVAL

An invalid argument was specified.

-ENOENT

Parent directory does not exist.

-ENOMEM

Not enough memory to allocate a resource.

AVAILABILITY

llapi_dir_create_foreign () is part of the lustre(7) user application interface library since release 2.13.0.

SEE ALSO

llapi_dir_create(3), llapi_dir_create_pool(3), lustreapi(7)