]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man2/linkat.2
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
[thirdparty/man-pages.git] / man2 / linkat.2
index ce3db2f9836fc3367ae5dfe08b1dbc35d459abb8..b48ca39502f8ff39d6892fb9dda130911e1c10b0 100644 (file)
@@ -10,7 +10,7 @@
 .\" manual under the conditions for verbatim copying, provided that the
 .\" entire resulting derived work is distributed under the terms of a
 .\" permission notice identical to this one.
-.\" 
+.\"
 .\" Since the Linux kernel and libraries are constantly changing, this
 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
 .\" responsibility for errors or omissions, or for damages resulting from
@@ -18,7 +18,7 @@
 .\" have taken the same level of care in the production of this manual,
 .\" which is licensed free of charge, as they might when working
 .\" professionally.
-.\" 
+.\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
@@ -31,7 +31,7 @@ linkat \- create a file link relative to directory file descriptors
 .B #define _ATFILE_SOURCE
 .B #include <unistd.h>
 .sp
-.BI "int linkat(int " olddirfd ", const char *" oldpath , 
+.BI "int linkat(int " olddirfd ", const char *" oldpath ,
 .BI "           int " newdirfd ", const char *" newpath ", int " flags );
 .fi
 .SH DESCRIPTION
@@ -41,51 +41,51 @@ system call operates in exactly the same way as
 .BR link (2),
 except for the differences described in this manual page.
 
-If the pathname given in 
+If the pathname given in
 .I oldpath
 is relative, then it is interpreted relative to the directory
 referred to by the file descriptor
-.IR olddirfd 
-(rather than relative to the current working directory of 
+.IR olddirfd
+(rather than relative to the current working directory of
 the calling process, as is done by
 .BR link (2)
 for a relative pathname).
 
 If
 .I oldpath
-is relative and 
+is relative and
 .I olddirfd
 is the special value
 .BR AT_FDCWD ,
 then
 .I oldpath
-is interpreted relative to the current working 
+is interpreted relative to the current working
 directory of the calling process (like
 .BR link (2)).
 
 If
 .IR oldpath
-is absolute, then 
-.I olddirfd 
+is absolute, then
+.I olddirfd
 is ignored.
 
 The interpretation of
 .I newpath
-is as for 
-.IR oldpath , 
+is as for
+.IR oldpath ,
 except that a relative pathname is interpreted relative
 to the directory referred to by the file descriptor
 .IR newdirfd .
 
 By default,
 .BR linkat (2),
-does not dereference 
+does not dereference
 .I oldpath
-if it is a symbolic link (like 
+if it is a symbolic link (like
 .BR link (2)).
 Since Linux 2.6.18, the flag
 .B AT_SYMLINK_FOLLOW
-can be specified 
+can be specified
 .I flags
 to cause
 .I oldpath
@@ -95,8 +95,8 @@ Before kernel 2.6.18, the
 argument was unused, and had to be specified as 0.
 .SH "RETURN VALUE"
 On success,
-.BR linkat () 
-returns 0.  
+.BR linkat ()
+returns 0.
 On error, \-1 is returned and
 .I errno
 is set to indicate the error.
@@ -105,7 +105,7 @@ The same errors that occur for
 .BR link (2)
 can also occur for
 .BR linkat ().
-The following additional errors can occur for 
+The following additional errors can occur for
 .BR linkat ():
 .TP
 .B EBADF