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
| Safety: |
|
| Cancellation point |
No |
| Interrupt handler |
No |
| Signal handler |
Yes |
| Thread |
Yes |