jimzah/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src.git synced 2024-12-03 19:08:58 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Note that the lutimes(2) and lchflags(2) syscalls also do not follow symlinks.

Browse Source 
Remove incorrect examples.

PR:		25016
Submitted by:	Martin Kammerhofer, Joshua Goodall
This commit is contained in:
Tim J. Robbins 2002-05-26 12:51:38 +00:00
parent f59d6e4762
commit 45457c7dd2
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=97305
1 changed files with 16 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
bin/ln/symlink.7
View File

@ -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 ,