symlinkat — create a symbolic link relative to a directory file descriptor
#define _ATFILE_SOURCE #include <fcntl.h> /* Definition of AT_* constants */ #include <stdio.h>
int
symlinkat( |
const char * | oldpath, |
int | newdirfd, | |
const char * | newpath) ; |
The symlinkat
() system call
operates in exactly the same way as symlink(2), except for the
differences described in this manual page.
If the pathname given in newpath
is relative, then it is
interpreted relative to the directory referred to by the file
descriptor newdirfd
(rather than relative to the current working directory of the
calling process, as is done by symlink(2) for a relative
pathname).
If newpath
is
relative and newdirfd
is the special value AT_FDCWD
,
then newpath
is
interpreted relative to the current working directory of the
calling process (like symlink(2)).
If newpath
is
absolute, then newdirfd
is ignored.
On success, symlinkat
()
returns 0. On error, −1 is returned and errno
is set to indicate the error.
The same errors that occur for symlink(2) can also occur
for symlinkat
(). The following
additional errors can occur for symlinkat
():
newdirfd
is
not a valid file descriptor.
newpath
is
relative and newdirfd
is a file
descriptor referring to a file other than a
directory.
This system call is non-standard but is proposed for inclusion in a future revision of POSIX.1.