summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarcel Telka <marcel@telka.sk>2021-03-02 11:11:41 +0100
committerRobert Mustacchi <rm@fingolfin.org>2021-03-03 11:33:49 -0800
commitf2db47a16aa8decb07a3891af701f32bba6990cd (patch)
treebc95968f0101bea63734778328e64d8e7c8a0905
parentc764c31dc69b9f3126169050c6e4b771cea45370 (diff)
downloadillumos-joyent-f2db47a16aa8decb07a3891af701f32bba6990cd.tar.gz
13594 Valid flag for fchownat(2) is AT_SYMLINK_NOFOLLOW, not SYMLNK
Reviewed by: Andy Fiddaman <omnios@citrus-it.co.uk> Reviewed by: Toomas Soome <tsoome@me.com> Approved by: Robert Mustacchi <rm@fingolfin.org>
-rw-r--r--usr/src/man/man2/chown.215
1 files changed, 2 insertions, 13 deletions
diff --git a/usr/src/man/man2/chown.2 b/usr/src/man/man2/chown.2
index b3270cafc6..72c42a6a5f 100644
--- a/usr/src/man/man2/chown.2
+++ b/usr/src/man/man2/chown.2
@@ -4,11 +4,10 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH CHOWN 2 "Oct 9, 2008"
+.TH CHOWN 2 "Mar 2, 2021"
.SH NAME
chown, lchown, fchown, fchownat \- change owner and group of a file
.SH SYNOPSIS
-.LP
.nf
#include <unistd.h>
#include <sys/types.h>
@@ -33,8 +32,6 @@ chown, lchown, fchown, fchownat \- change owner and group of a file
.fi
.SH DESCRIPTION
-.sp
-.LP
The \fBchown()\fR function sets the owner \fBID\fR and group \fBID\fR of the
file specified by \fIpath\fR or referenced by the open file descriptor
\fIfildes\fR to \fIowner\fR and \fIgroup\fR respectively. If \fIowner\fR or
@@ -54,7 +51,7 @@ in the same manner as \fBchown()\fR. If, however, the \fIpath\fR argument is
relative, the path is resolved relative to the \fIfildes\fR argument rather
than the current working directory. If the \fIfildes\fR argument has the
special value \fBAT_FDCWD\fR, the path resolution reverts back to current
-working directory relative. If the \fIflag\fR argument is set to \fBSYMLNK\fR,
+working directory relative. If the \fIflag\fR argument is set to \fBAT_SYMLINK_NOFOLLOW\fR,
the function behaves like \fBlchown()\fR with respect to symbolic links. If the
\fIpath\fR argument is absolute, the \fIfildes\fR argument is ignored. If the
\fIpath\fR argument is a null pointer, the function behaves like
@@ -105,14 +102,10 @@ See \fBsystem\fR(4) and \fBfpathconf\fR(2).
Upon successful completion, \fBchown()\fR, \fBfchown()\fR and \fBlchown()\fR
mark for update the \fBst_ctime\fR field of the file.
.SH RETURN VALUES
-.sp
-.LP
Upon successful completion, \fB0\fR is returned. Otherwise, \fB\(mi1\fR is
returned, the owner and group of the named file remain unchanged, and
\fBerrno\fR is set to indicate the error.
.SH ERRORS
-.sp
-.LP
All of these functions will fail if:
.sp
.ne 2
@@ -299,8 +292,6 @@ The named file referred to by \fIfildes\fR resides on a read-only file system.
.RE
.SH ATTRIBUTES
-.sp
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
@@ -324,7 +315,5 @@ The \fBfchownat()\fR function is Evolving.
.LP
The \fBchown()\fR and \fBfchownat()\fR functions are Async-Signal-Safe.
.SH SEE ALSO
-.sp
-.LP
\fBchgrp\fR(1), \fBchown\fR(1), \fBchmod\fR(2), \fBfpathconf\fR(2),
\fBsystem\fR(4), \fBattributes\fR(5), \fBstandards\fR(5)