flink()

Assign a pathname to a file descriptor

Synopsis:

#include <unistd.h>

int flink( int fd,
           const char *path );

Arguments:

fd

The file descriptor.

path

The path you want to associate with the file descriptor.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The flink() function assigns the pathname, path, to the file associated with the file descriptor, fd.

Returns:

0

Success.

-1

An error occurred; errno is set.

Errors:

EACCES

A component of either path prefix denies search permission, or the link named by path is in a directory with a mode that denies write permission.

EBADF

The file descriptor fd is invalid.

EEXIST

The link named by path already exists.

ELOOP

Too many levels of symbolic links or prefixes.

EMLINK

The number of links to the file would exceed LINK_MAX.

ENAMETOOLONG

The length of the path string exceeds PATH_MAX, or a pathname component is longer than NAME_MAX.

ENOENT

This error code can mean the following:

• A component of either path prefix doesn't exist.
• The path points to an empty string.

ENOSPC

The directory that would contain the link can't be extended.

ENOSYS

The flink() function isn't implemented for the filesystem specified in path.

ENOTDIR

A component of either path prefix isn't a directory.

EROFS

The requested link requires writing in a directory on a read-only file system.

EXDEV

The link named by path is on a different logical disk.

Classification:

Unix

See also:

link()