chown.2: Add NOTES explaining 32-bit system calls added in Linux 2.4

This commit is contained in:
Michael Kerrisk 2010-11-22 08:49:16 +01:00
parent 489376f89c
commit 697fa2a158
1 changed files with 20 additions and 1 deletions

View File

@ -35,7 +35,7 @@
.\" (bsdgroups versus sysvgroups, and the effect of the parent
.\" directory's set-group-ID permission bit).
.\"
.TH CHOWN 2 2010-09-26 "Linux" "Linux Programmer's Manual"
.TH CHOWN 2 2010-11-22 "Linux" "Linux Programmer's Manual"
.SH NAME
chown, fchown, lchown \- change ownership of a file
.SH SYNOPSIS
@ -190,6 +190,25 @@ used by the superuser (that is, ordinary users cannot give away files).
.\" SVr4 documents additional EINVAL, EIO, EINTR, and ENOLINK
.\" error conditions.
.SH NOTES
The original Linux
.BR chown (),
.BR fchown (),
and
.BR lchown ()
system calls supported only 16-bit user and group IDs.
Subsequently, Linux 2.4 added
.BR chown32 (),
.BR fchown32 (),
and
.BR lchown32 (),
supporting 32-bit IDs.
The glibc
.BR chown (),
.BR fchown (),
and
.BR lchown ()
wrapper functions transparently deal with the variations across kernel versions.
When a new file is created (by, for example,
.BR open (2)
or