xfidToName() Kernel Service

Purpose

Finds the full path name of the file corresponding to an xfid_t structure.

Syntax

#include <sys/xfops.h>

int     xfidToName(struct xfid *xfp,
                            void *nrp,
                            char *pathname,
                            unsigned int pbuflen,
                            long flags);

Description

The xfidToName() kernel service finds a name for an xfid value.

Parameters

xfp

Pointer to the xfid value for which a name is needed.

nrp

Name resolution structure that is passed to the validation routine.

pathname

Pointer to buffer where the file name will be stored.

pbuflen

Size of path name buffer. A size of MAXPATHLEN is sufficient to hold any path name.

flags

Operation modifiers. This parameter must be set to zero.

Return values

0

Indicates success. The path name for the xfid value is returned.

ENOENT

Name not found.

EPERM

No permission for lookup.

EINVAL

Invalid parameter is specified.

E2BIG

Path is larger than pbuflen bytes.