summaryrefslogtreecommitdiffstats
path: root/bin/ln
diff options
context:
space:
mode:
authortjr <tjr@FreeBSD.org>2002-05-26 12:51:38 +0000
committertjr <tjr@FreeBSD.org>2002-05-26 12:51:38 +0000
commit77288420b0b89bfd29008398f3db0e7996e65068 (patch)
tree354c4c97748b3a19e6468bf03754764903b000b1 /bin/ln
parent4cc401e5efcd857c8303b9fe5c51dc23c6c831e7 (diff)
downloadFreeBSD-src-77288420b0b89bfd29008398f3db0e7996e65068.zip
FreeBSD-src-77288420b0b89bfd29008398f3db0e7996e65068.tar.gz
Note that the lutimes(2) and lchflags(2) syscalls also do not follow symlinks.
Remove incorrect examples. PR: 25016 Submitted by: Martin Kammerhofer, Joshua Goodall
Diffstat (limited to 'bin/ln')
-rw-r--r--bin/ln/symlink.729
1 files changed, 16 insertions, 13 deletions
diff --git a/bin/ln/symlink.7 b/bin/ln/symlink.7
index 490720a..691f643 100644
--- a/bin/ln/symlink.7
+++ b/bin/ln/symlink.7
@@ -106,12 +106,14 @@ the system call
would return a file descriptor to the file
.Dq afile .
.Pp
-There are seven system calls that do not follow links, and which operate
+There are nine system calls that do not follow links, and which operate
on the symbolic link itself.
They are:
+.Xr lchflags 2 ,
.Xr lchmod 2 ,
.Xr lchown 2 ,
.Xr lstat 2 ,
+.Xr lutimes 2 ,
.Xr readlink 2 ,
.Xr rename 2 ,
.Xr rmdir 2 ,
@@ -131,8 +133,16 @@ The owner and group of an existing symbolic link can be changed by
means of the
.Xr lchown 2
system call.
-The other file attributes, such as the modification time and access
-permissions, are not used by the system and cannot be changed.
+The flags, access permissions, owner/group and modification time of
+an existing symbolic link can be changed by means of the
+.Xr lchflags 2
+.Xr lchmod 2 ,
+.Xr lchown 2 ,
+and
+.Xr lutimes 2 ,
+system calls, respectively.
+Of these only the flags are used by the system;
+the access permissions and ownership are ignored.
.Pp
The
.Bx 4.4
@@ -272,13 +282,6 @@ not of type directory.
Operations that apply to symbolic links are performed on the links
themselves, but otherwise the links are ignored.
.Pp
-For example, the command
-.Dq Li "chown -R user slink directory"
-will ignore
-.Dq Li slink ,
-because symbolic links in this system do not have owners.
-Any symbolic links encountered during the tree traversal will also be
-ignored.
The command
.Dq Li "rm -r slink directory"
will remove
@@ -286,9 +289,7 @@ will remove
as well as any symbolic links encountered in the tree traversal of
.Dq Li directory ,
because symbolic links may be removed.
-In no case will either
-.Nm chown
-or
+In no case will
.Nm rm
affect the file which
.Dq Li slink
@@ -442,9 +443,11 @@ whether specified on the command line or encountered in the tree walk.
.Xr pax 1 ,
.Xr rm 1 ,
.Xr tar 1 ,
+.Xr lchflags 2 ,
.Xr lchmod 2 ,
.Xr lchown 2 ,
.Xr lstat 2 ,
+.Xr lutimes 2 ,
.Xr readlink 2 ,
.Xr rename 2 ,
.Xr symlink 2 ,
OpenPOWER on IntegriCloud