Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_NATTR_LINK (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

NAME

vxfs_nattr_link - link to a named data stream

SYNOPSIS

cc -I /opt/VRTS/include -L /opt/VRTS/lib

-l vxfsutil -ldl

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_nattr_link(int sfd, char *spath, char *tpath);

AVAILABILITY

VRTSvxfs

DESCRIPTION

The vxfs_nattr_link() function creates a new directory entry for an existing named data stream and increments its link count by one. The spath argument points to the existing named data stream in the named data stream namespace for sfd. tpath points to the new directory entry created in the named data stream name space for sfd.

Linking a named data stream with a prefix of $vxfs: fails with the EINVAL error. The $vxfs: prefix is reserved by VERITAS.

RETURN VALUES

vxfs_nattr_link() returns zero on success, -1 on failure. If unsuccessful, no link is created and errno is set to indicate the error.

ERRORS

EACCES: The specified spath does not exist. The user does not have permission to open or write to the named data stream directory.
EDQUOT: The directory for the new link cannot be created because the user quota of disk blocks on that file system was exceeded.
EEXIST: The link named by tpath already exists.
EINVAL: The file system disk layout version does not support named data streams.
ENOSPC: There is insufficient space to create a directory for the link.