diff --git a/man2/chown.2 b/man2/chown.2 index bf7818b39..585fe3720 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -41,25 +41,23 @@ chown, fchown, lchown, fchownat \- change ownership of a file .SH SYNOPSIS .nf .B #include -.sp +.PP .BI "int chown(const char *" pathname ", uid_t " owner ", gid_t " group ); -.br .BI "int fchown(int " fd ", uid_t " owner ", gid_t " group ); -.br .BI "int lchown(const char *" pathname ", uid_t " owner ", gid_t " group ); -.sp + .BR "#include " "/* Definition of AT_* constants */" .B #include -.sp +.PP .BI "int fchownat(int " dirfd ", const char *" pathname , .BI " uid_t " owner ", gid_t " group ", int " flags ); .fi -.sp +.PP .in -4n Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .in -.sp +.PP .BR fchown (), .BR lchown (): .PD 0 @@ -70,7 +68,7 @@ Feature Test Macro Requirements for glibc (see .\" || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || /* Glibc versions <= 2.19: */ _BSD_SOURCE .RE -.sp +.PP .BR fchownat (): .PD 0 .ad l @@ -115,13 +113,13 @@ to any group of which that owner is a member. A privileged process (Linux: with .BR CAP_CHOWN ) may change the group arbitrarily. - +.PP If the .I owner or .I group is specified as \-1, then that ID is not changed. - +.PP When the owner or group of an executable file is changed by an unprivileged user, the .B S_ISUID @@ -142,7 +140,7 @@ bit is not set) the .B S_ISGID bit indicates mandatory locking, and is not cleared by a .BR chown (). - +.PP When the owner or group of an executable file is changed (by any user), all capability sets for the file are cleared. .\" @@ -152,7 +150,7 @@ The system call operates in exactly the same way as .BR chown (), except for the differences described here. - +.PP If the pathname given in .I pathname is relative, then it is interpreted relative to the directory @@ -162,7 +160,7 @@ referred to by the file descriptor the calling process, as is done by .BR chown () for a relative pathname). - +.PP If .I pathname is relative and @@ -174,13 +172,13 @@ then is interpreted relative to the current working directory of the calling process (like .BR chown ()). - +.PP If .I pathname is absolute, then .I dirfd is ignored. - +.PP The .I flags argument is a bit mask created by ORing together @@ -232,7 +230,7 @@ is set appropriately. .SH ERRORS Depending on the filesystem, errors other than those listed below can be returned. - +.PP The more general errors for .BR chown () are listed below. @@ -324,7 +322,7 @@ library support was added to glibc in version 2.4. .BR fchown (), .BR lchown (): 4.4BSD, SVr4, POSIX.1-2001, POSIX.1-2008. - +.PP The 4.4BSD version can be used only by the superuser (that is, ordinary users cannot give away files). .\" chown(): @@ -333,7 +331,7 @@ used only by the superuser (that is, ordinary users cannot give away files). .\" fchown(): .\" SVr4 documents additional EINVAL, EIO, EINTR, and ENOLINK .\" error conditions. - +.PP .BR fchownat (): POSIX.1-2008. .SH NOTES @@ -433,7 +431,7 @@ The glibc and .BR lchown () wrapper functions transparently deal with the variations across kernel versions. - +.PP In versions of Linux prior to 2.1.81 (and distinct from 2.1.46), .BR chown () did not follow symbolic links. @@ -458,7 +456,7 @@ or as a username (which is converted to a user ID by using .BR getpwnam (3) to perform a lookup in the system password file). .SS Program source -.nf +.EX #include #include #include @@ -495,7 +493,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } -.fi +.EE .SH SEE ALSO .BR chgrp (1), .BR chown (1),