man/man2/*: Update history of syscalls CI-G
cover man/man2/*: Update history of syscalls CI-G
Hello,
This patch set updates the POSIX/SUS history of system calls with identifiers starting with CI through G. It also attempts to provide chronological order where possible, similar to the last patch set.
Although this set does begin to touch on man pages with a peculiar listing in their HISTORY sections. Namely, "4.4BSD (first appeared in 4.2BSD)". I ordered these as if they were just "4.4BSD", since that's not inside the brackets and so should be more important (otherwise I'd assume it'd just say "4.2BSD" instead). Although I'm not confident in this choice, so any thoughts regarding this would be appreciated.
Seth McDonald (23):
man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of
clock_* syscalls
man/man2/close.2: HISTORY: Update first POSIX appearance of close(2) man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2) man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2) man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2) man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2) man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of
locking constants
man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2) man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of
fdatasync(2)
man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of
get[e][gu]id(2)
man/man2/getgroups.2: HISTORY: Update first POSIX appearance of
getgroups(2)
man/man2/gethostname.2: HISTORY: Split gethostname(2) and
sethostname(2)
man/man2/getitimer.2: HISTORY: Update first SUS appearance of
[gs]etitimer(2)
man/man2/getpagesize.2: HISTORY: Update first SUS appearance of
getpagesize(2)
man/man2/getpid.2: HISTORY: Update first POSIX appearance of
get[p]pid(2)
man/man2/getpriority.2: HISTORY: Update first POSIX appearance of
[gs]etpriority(2)
man/man2/getresuid.2: HISTORY: Update first POSIX appearance of
getres[gu]id(2)
man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of
[gs]etrlimit(2) man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2) man/man2/getrusage.2: HISTORY: Update first POSIX appearance of
getrusage(2)
man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of
gettimeofday(2)
man/man2/_exit.2 | 4 +++- man/man2/clock_getres.2 | 2 +- man/man2/close.2 | 4 +++- man/man2/dup.2 | 4 +++- man/man2/execve.2 | 4 +++- man/man2/fcntl.2 | 4 +++- man/man2/fcntl_locking.2 | 4 +++- man/man2/fork.2 | 4 +++- man/man2/fsync.2 | 10 +++++++++- man/man2/getgid.2 | 3 ++- man/man2/getgroups.2 | 4 +++- man/man2/gethostname.2 | 12 ++++++++---- man/man2/getitimer.2 | 5 ++++- man/man2/getpagesize.2 | 5 +++-- man/man2/getpid.2 | 4 +++- man/man2/getpriority.2 | 6 ++++-- man/man2/getresuid.2 | 3 ++- man/man2/getrlimit.2 | 6 +++++- man/man2/getrusage.2 | 5 ++++- man/man2/getsid.2 | 7 +++++-- man/man2/gettimeofday.2 | 7 ++++--- man/man2/getuid.2 | 3 ++- 22 files changed, 80 insertions(+), 30 deletions(-)
Range-diff against v0:
-: ------------ > 1: 1a421b5ee130 man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls -: ------------ > 2: 5327747ac3c3 man/man2/close.2: HISTORY: Update first POSIX appearance of close(2) -: ------------ > 3: 11e4b9d2ac05 man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2) -: ------------ > 4: 5d691ee5e6a3 man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2) -: ------------ > 5: eb5b310ab4dd man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2) -: ------------ > 6: 1f924f4f5c3c man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2) -: ------------ > 7: a44c49650063 man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants -: ------------ > 8: 7404e99ec690 man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2) -: ------------ > 9: 163be42a70ea man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2) -: ------------ > 10: 0dfa064b051b man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2) -: ------------ > 11: a968c006c218 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2) -: ------------ > 12: 566fd21d97b0 man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2) -: ------------ > 13: a54a94c8b118 man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2) -: ------------ > 14: 0097b249c950 man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2) -: ------------ > 15: 824605c82a14 man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2) -: ------------ > 16: f776e452e427 man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2) -: ------------ > 17: c2b9d37b6208 man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2) -: ------------ > 18: d5e7adf0a804 man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2) -: ------------ > 19: b5a7de01af52 man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2) -: ------------ > 20: 5e54217b8cec man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2) -: ------------ > 21: 1bc25963021c man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2) -: ------------ > 22: b93c17918b36 man/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2) -: ------------ > 23: 00b72e770428 man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)
base-commit: 760458adc15668e910cefbbc4f9e11ccfd454411
Signature · 1 line
2.47.3
PATCH 1/23 man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
clock_getres(2), clock_gettime(2), and clock_settime(2) first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.
[1] ISO/IEC 9945-1:1996, Section 14.2.1 "Clocks".
--- man/man2/clock_getres.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
man/man2/clock_getres.2 +1 -1
@@ -369,7 +369,7 @@ .SS C library/kernel differences .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SUSv2. +POSIX.1-1996, Linux 2.6. .P On POSIX systems on which these functions are available, the symbol
Signature · 1 line
2.47.3
Alejandro Colomar
maintainerRe: [PATCH v1 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
Hi Seth,
Quoted 3 lines · Seth McDonald
clock_getres(2),clock_gettime(2), andclock_settime(2)first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.
Are you sure SUSv2 incorporates POSIX.1-1996? Could you please show sources for that?
Cheers,
Alex
Quoted 24 lines
[1] ISO/IEC 9945-1:1996, Section 14.2.1 "Clocks".
Signed-off-by Seth McDonald <[email protected]>--- man/man2/clock_getres.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)man/man2/clock_getres.2 +1
-1@@ -369,7 +369,7 @@ .SS C library/kernel differences .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SUSv2. +POSIX.1-1996, Linux 2.6. .P On POSIX systems on which these functions are available, the symbolSignature · 1 line
2.47.3
Signature · 1 line
<https://www.alejandro-colomar.es>
Re: [PATCH v1 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
Hi Alex,
Quoted 9 lines · Alejandro Colomar
Hi Seth,
Quoted 3 lines · Seth McDonald
clock_getres(2),clock_gettime(2), andclock_settime(2)first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.Are you sure SUSv2 incorporates POSIX.1-1996? Could you please show sources for that?
We can reference the following SUSv2 PDF:
CAE Specification, System Interfaces and Headers, Issue 5.
<https://pubs.opengroup.org/onlinepubs/009639399/toc.pdf>
Section 1.6 "Relationship to Formal Standards", page 11 states:
Great care has been taken to ensure that this specification is fully aligned with the following formal standards:
- ISO/IEC 9945-1:1996
- ISO/IEC 9945-2:1993
- ISO/IEC 9899:1990
- ISO/IEC 9899:1990/Amendment 1:1994 (E) (MSE)
- Federal Information Procurement Standards (FIPS) 151-2.
Any conflict between this specification and any of these standards is unintentional.
Additionally, section 1.7 "Portability", page 12 states:
This document describes a superset of the requirements of the ISO POSIX-1 standard and the ISO C standard. [...] (The ISO POSIX-1 standard is identical to IEEE Std 1003.1-1996, which is often referred to as the POSIX.1 standard. [...])
For context, page xiii defines "ISO C" as ISO/IEC 9899:1990 including Technical Corrigendum 1:1994 and Amendment 1:1994. And "ISO POSIX-1" as ISO/IEC 9945-1:1996.
So SUSv2 XSH is a superset of POSIX.1-1996 and C95.
Signature · 5 lines
Take care, Seth McDonald. On-list: 2336 E8D2 FEB1 5300 692C 62A9 5839 6AD8 9243 D369 Off-list: 82B9 620E 53D0 A1AE 2D69 6111 C267 B002 0A90 0289
Alejandro Colomar
maintainerRe: [PATCH v1 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
Hi Seth,
Quoted 37 lines · Seth McDonald
Hi Alex,
Quoted 9 lines · Alejandro Colomar
Hi Seth,
Quoted 3 lines · Seth McDonald
clock_getres(2),clock_gettime(2), andclock_settime(2)first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.Are you sure SUSv2 incorporates POSIX.1-1996? Could you please show sources for that?
We can reference the following SUSv2 PDF:
CAE Specification, System Interfaces and Headers, Issue 5.
<https://pubs.opengroup.org/onlinepubs/009639399/toc.pdf>Section 1.6 "Relationship to Formal Standards", page 11 states:
Great care has been taken to ensure that this specification is fully aligned with the following formal standards:
- ISO/IEC 9945-1:1996
- ISO/IEC 9945-2:1993
- ISO/IEC 9899:1990
- ISO/IEC 9899:1990/Amendment 1:1994 (E) (MSE)
- Federal Information Procurement Standards (FIPS) 151-2.Any conflict between this specification and any of these standards is unintentional.
Additionally, section 1.7 "Portability", page 12 states:
This document describes a superset of the requirements of the ISO POSIX-1 standard and the ISO C standard. [...] (The ISO POSIX-1 standard is identical to IEEE Std 1003.1-1996, which is often referred to as the POSIX.1 standard. [...])
Quoted 5 lines
For context, page xiii defines "ISO C" as ISO/IEC 9899:1990 including Technical Corrigendum 1:1994 and Amendment 1:1994. And "ISO POSIX-1" as ISO/IEC 9945-1:1996.
So SUSv2 XSH is a superset of POSIX.1-1996 and C95.
Thanks! And then I guess POSIX.1-1996 would also be based on C95. This is quite interesting!
Have a lovely night!
Alex
Quoted 7 lines
Signature · 6 lines
-- Take care, Seth McDonald. On-list: 2336 E8D2 FEB1 5300 692C 62A9 5839 6AD8 9243 D369 Off-list: 82B9 620E 53D0 A1AE 2D69 6111 C267 B002 0A90 0289
Signature · 1 line
<https://www.alejandro-colomar.es>
PATCH 2/23 man/man2/close.2: HISTORY: Update first POSIX appearance of close(2)
In reply to Seth McDonaldclose(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 6.3.1 "Close a File".
--- man/man2/close.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/close.2 +3 -1
@@ -81,7 +81,9 @@ .SH ERRORS .SH STANDARDS POSIX.1-2008. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .\" SVr4 documents an additional ENOLINK error condition. .SH NOTES The close-on-exec file descriptor flag can be used to ensure
Signature · 1 line
2.47.3
PATCH 3/23 man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2)
In reply to Seth McDonalddup(2) and dup2(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 6.2.1 "Duplicate an Open File Descriptor".
--- man/man2/dup.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/dup.2 +3 -1
@@ -196,7 +196,9 @@ .SH HISTORY .BR dup () .TQ .BR dup2 () -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .\" SVr4 documents additional .\" EINTR and ENOLINK error conditions. POSIX.1 adds EINTR. .\" The EBUSY return is Linux-specific.
Signature · 1 line
2.47.3
PATCH 4/23 man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2)
In reply to Seth McDonaldexecve(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 3.1.2 "Execute a File".
--- man/man2/execve.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/execve.2 +3 -1
@@ -616,7 +616,9 @@ .SS Interpreter scripts .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .\" SVr4 documents additional error .\" conditions EAGAIN, EINTR, ELIBACC, ENOLINK, EMULTIHOP; POSIX does not .\" document ETXTBSY, EPERM, EFAULT, ELOOP, EIO, ENFILE, EMFILE, EINVAL,
Signature · 1 line
2.47.3
PATCH 5/23 man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2)
In reply to Seth McDonald_exit(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 3.2.2 "Terminate a Process".
--- man/man2/_exit.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/_exit.2 +3 -1
@@ -65,7 +65,9 @@ .SH STANDARDS .SH HISTORY .TP .BR _exit () -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .TP .BR _Exit () C99, POSIX.1-2001.
Signature · 1 line
2.47.3
PATCH 6/23 man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2)
In reply to Seth McDonaldfcntl(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 6.5.2 "File Control".
--- man/man2/fcntl.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/fcntl.2 +3 -1
@@ -134,7 +134,9 @@ .SH STANDARDS .\" .P .\" SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. .SH HISTORY -SVr4, 4.3BSD, POSIX.1-2001. +4.3BSD, +SVr4, +POSIX.1-1988. .SH SEE ALSO .BR dup2 (2), .BR flock (2),
Signature · 1 line
2.47.3
PATCH 7/23 man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants
In reply to Seth McDonaldThe F_GETLK, F_SETLK, and F_SETLKW symbolic constants first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Table 6-1 "cmd Values for fcntl()".
--- man/man2/fcntl_locking.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/fcntl_locking.2 +3 -1
@@ -571,7 +571,9 @@ .SH HISTORY .B F_SETLK .TQ .B F_SETLKW -SVr4, 4.3BSD, POSIX.1-2001. +4.3BSD, +SVr4, +POSIX.1-1988. .TP .B F_OFD_SETLK .TQ
Signature · 1 line
2.47.3
PATCH 8/23 man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2)
In reply to Seth McDonaldfork(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 3.1.1 "Process Creation".
--- man/man2/fork.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/fork.2 +3 -1
@@ -278,7 +278,9 @@ .SS Async-signal safety .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .SH NOTES Under Linux, .BR fork ()
Signature · 1 line
2.47.3
PATCH 9/23 man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2)
In reply to Seth McDonald--- man/man2/fsync.2 | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-)
man/man2/fsync.2 +8 -1
@@ -151,7 +151,14 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.2BSD. +.TP +.BR fsync () +4.2BSD, +POSIX.1-2001. +.TP +.BR fdatasync () +4.2BSD, +POSIX.1-2001. .P In Linux 2.2 and earlier, .BR fdatasync ()
Signature · 1 line
2.47.3
PATCH 10/23 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2)
In reply to Seth McDonaldfsync(2) first appeared in SUSv1.[1] The function was then added to POSIX.1-1996.[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 214.
[2] ISO/IEC 9945-1:1996, Section 6.6.1 "Synchronize the State of a File".
--- man/man2/fsync.2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
man/man2/fsync.2 +2 -1
@@ -154,7 +154,8 @@ .SH HISTORY .TP .BR fsync () 4.2BSD, -POSIX.1-2001. +SUSv1, +POSIX.1-1996. .TP .BR fdatasync () 4.2BSD,
Signature · 1 line
2.47.3
PATCH 11/23 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2)
In reply to Seth McDonaldfdatasync(2) first appeared in POSIX.1-1996.[1]
[1] ISO/IEC 9945-1:1996, Section 6.6.2 "Synchronize the Data of a File".
--- man/man2/fsync.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
man/man2/fsync.2 +1 -1
@@ -159,7 +159,7 @@ .SH HISTORY .TP .BR fdatasync () 4.2BSD, -POSIX.1-2001. +POSIX.1-1996. .P In Linux 2.2 and earlier, .BR fdatasync ()
Signature · 1 line
2.47.3
PATCH 12/23 man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2)
In reply to Seth McDonaldgetgid(2), getegid(2), getuid(2), and geteuid(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 4.2.1 "Get Real User, Effective User, Real Group, and Effective Group IDs".
--- man/man2/getgid.2 | 3 ++- man/man2/getuid.2 | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-)
man/man2/getgid.2 +2 -1
@@ -46,7 +46,8 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.3BSD. +4.3BSD, +POSIX.1-1988. .P The original Linux .BR getgid ()
man/man2/getuid.2 +2 -1
@@ -30,7 +30,8 @@ .SH ERRORS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.3BSD. +4.3BSD, +POSIX.1-1988. .P In UNIX\ V6 the .BR getuid ()
Signature · 1 line
2.47.3
PATCH 13/23 man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2)
In reply to Seth McDonaldgetgroups(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 4.2.3 "Get Supplementary Group IDs".
--- man/man2/getgroups.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/getgroups.2 +3 -1
@@ -157,7 +157,9 @@ .SH STANDARDS .SH HISTORY .TP .BR getgroups () -SVr4, 4.3BSD, POSIX.1-2001. +4.3BSD, +SVr4, +POSIX.1-1988. .TP .BR setgroups () SVr4, 4.3BSD.
Signature · 1 line
2.47.3
PATCH 14/23 man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2)
In reply to Seth McDonaldgethostname(2) first appeared in POSIX.1-2001.[1]
[1] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p. 516.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/gethostname.html>
--- man/man2/gethostname.2 | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-)
man/man2/gethostname.2 +8 -4
@@ -145,11 +145,15 @@ .SH STANDARDS .BR sethostname () None. .SH HISTORY -SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). -POSIX.1 specifies +.TP .BR gethostname () -but not -.BR sethostname (). +SVr4, +4.4BSD (first appeared in 4.2BSD), +POSIX.1-2001. +.TP +.BR sethostname () +SVr4, +4.4BSD (first appeared in 4.2BSD). .P Versions of glibc before glibc 2.2 .\" At least glibc 2.0 and glibc 2.1, older versions not checked
Signature · 1 line
2.47.3
PATCH 15/23 man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2)
In reply to Seth McDonaldgetitimer(2) and setitimer(2) first appeared in SUSv1.[1]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", pp. 244-245.
--- man/man2/getitimer.2 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
man/man2/getitimer.2 +4 -1
@@ -181,7 +181,10 @@ .SH VERSIONS .SH STANDARDS None. .SH HISTORY -POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD). +SVr4, +4.4BSD (first appeared in 4.2BSD), +SUSv1, +POSIX.1-2001. POSIX.1-2008 marked .BR getitimer () and
Signature · 1 line
2.47.3
PATCH 16/23 man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2)
In reply to Seth McDonaldgetpagesize(2) first appeared in SUSv1.[1]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 254.
--- man/man2/getpagesize.2 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
man/man2/getpagesize.2 +3 -2
@@ -53,8 +53,9 @@ .SH VERSIONS .SH STANDARDS None. .SH HISTORY -This call first appeared in 4.2BSD. -SVr4, 4.4BSD, SUSv2. +SVr4, +4.4BSD (first appeared in 4.2BSD), +SUSv1. In SUSv2 the .BR getpagesize () call was labeled LEGACY,
Signature · 1 line
2.47.3
PATCH 17/23 man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2)
In reply to Seth McDonaldgetpid(2) and getppid(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 4.1.1 "Get Process and Parent Process IDs".
--- man/man2/getpid.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/getpid.2 +3 -1
@@ -53,7 +53,9 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.3BSD, SVr4. +4.3BSD, +SVr4, +POSIX.1-1988. .SS C library/kernel differences From glibc 2.3.4 up to and including glibc 2.24, the glibc wrapper function for
Signature · 1 line
2.47.3
PATCH 18/23 man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2)
In reply to Seth McDonaldgetpriority(2) and setpriority(2) first appeared in SUSv1.[1] The functions were added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", pp. 262-263.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp. 540-542.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getpriority.html>
--- man/man2/getpriority.2 | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-)
man/man2/getpriority.2 +4 -2
@@ -139,8 +139,10 @@ .SH ERRORS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, -SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). +SVr4, +4.4BSD (first appeared in 4.2BSD), +SUSv1, +POSIX.1-2001 XSI. .P The details on the condition for .B EPERM
Signature · 1 line
2.47.3
PATCH 19/23 man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2)
In reply to Seth McDonaldgetresgid(2) and getresuid(2) first appeared in POSIX.1-2024 as an XSI extension.[1][2]
[1] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p. 1174.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresgid.html>
[2] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p. 1175.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresuid.html>
--- man/man2/getresuid.2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
man/man2/getresuid.2 +2 -1
@@ -42,7 +42,8 @@ .SH STANDARDS These calls also appear on HP-UX and some of the BSDs. .SH HISTORY Linux 2.1.44, -glibc 2.3.2. +glibc 2.3.2, +POSIX.1-2024 XSI. .P The original Linux .BR getresuid ()
Signature · 1 line
2.47.3
PATCH 20/23 man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2)
In reply to Seth McDonaldgetrlimit(2) and setrlimit(2) first appeared in SUSv1.[1] The functions were added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2] Then POSIX.1-2024 added them to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", pp. 269-270.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp. 551-553.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getrlimit.html>
[3] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp. 1176-1179.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getrlimit.html>
--- man/man2/getrlimit.2 | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-)
man/man2/getrlimit.2 +5 -1
@@ -554,7 +554,11 @@ .SH HISTORY .BR getrlimit () .TQ .BR setrlimit () -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +SUSv1, +POSIX.1-2001 XSI, +POSIX.1-2024. .TP .BR prlimit () Linux 2.6.36,
Signature · 1 line
2.47.3
PATCH 21/23 man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2)
In reply to Seth McDonaldgetsid(2) first appeared in SUSv1.[1] The function was added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2] Then POSIX.1-2008 added it to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 273.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p. 558.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getsid.html>
[3] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", p. 1073.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/getsid.html>
--- man/man2/getsid.2 | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-)
man/man2/getsid.2 +5 -2
@@ -60,8 +60,11 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4. -Linux 2.0. +SVr4, +SUSv1, +Linux 2.0, +POSIX.1-2001 XSI, +POSIX.1-2008. .\" Linux has this system call since Linux 1.3.44. .\" There is libc support since libc 5.2.19. .SH NOTES
Signature · 1 line
2.47.3
PATCH 22/23 man/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2)
In reply to Seth McDonaldgetrusage(2) first appeared in SUSv1.[1] The function was added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 271.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp. 554-555.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getrusage.html>
--- man/man2/getrusage.2 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
man/man2/getrusage.2 +4 -1
@@ -195,7 +195,10 @@ .SH STANDARDS .B RUSAGE_THREAD is Linux-specific. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +SUSv1, +POSIX.1-2001 XSI. .P Before Linux 2.6.9, if the disposition of .B SIGCHLD
Signature · 1 line
2.47.3
PATCH 23/23 man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)
In reply to Seth McDonaldgettimeofday(2) first appeared in SUSv1.[1] The function was added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 275.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p. 567.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/gettimeofday.html>
--- man/man2/gettimeofday.2 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-)
man/man2/gettimeofday.2 +4 -3
@@ -177,12 +177,13 @@ .SS C library/kernel differences .SH STANDARDS None. .SH HISTORY -SVr4, 4.3BSD. -POSIX.1-2001 described +4.3BSD, +SVr4. +SUSv1 and POSIX.1-2001 XSI described .BR gettimeofday () but not .BR settimeofday (). -POSIX.1-2008 marked +POSIX.1-2008 XSI marked .BR gettimeofday () as obsolete, recommending the use of .BR clock_gettime (2)
Signature · 1 line
2.47.3
Alejandro Colomar
maintainerHi Seth,
Quoted 6 lines · Seth McDonald
Hello,
This patch set updates the POSIX/SUS history of system calls with identifiers starting with CI through G. It also attempts to provide chronological order where possible, similar to the last patch set.
Quoted 6 lines
Although this set does begin to touch on man pages with a peculiar listing in their HISTORY sections. Namely, "4.4BSD (first appeared in 4.2BSD)". I ordered these as if they were just "4.4BSD", since that's not inside the brackets and so should be more important (otherwise I'd assume it'd just say "4.2BSD" instead). Although I'm not confident in this choice, so any thoughts regarding this would be appreciated.
I'd replace such a thing by 4.2BSD, as you suggest.
Cheers,
Alex
Quoted 93 lines
Seth McDonald (23):
man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of
clock_* syscalls
man/man2/close.2: HISTORY: Update first POSIX appearance of close(2) man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2) man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2) man/man2/_exit.2: HISTORY: Update first POSIX appearance of_exit(2)man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2) man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of
locking constants
man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2) man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of
fdatasync(2)
man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance ofget[e][gu]id(2) man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2) man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2) man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2) man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2) man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2) man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2) man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2) man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2)man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2) man/man2/getrusage.2: HISTORY: Update first POSIX appearance of
getrusage(2)
man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of
gettimeofday(2)man/man2/_exit.2 | 4 +++- man/man2/clock_getres.2 | 2 +- man/man2/close.2 | 4 +++- man/man2/dup.2 | 4 +++- man/man2/execve.2 | 4 +++- man/man2/fcntl.2 | 4 +++- man/man2/fcntl_locking.2 | 4 +++- man/man2/fork.2 | 4 +++- man/man2/fsync.2 | 10 +++++++++- man/man2/getgid.2 | 3 ++- man/man2/getgroups.2 | 4 +++- man/man2/gethostname.2 | 12 ++++++++---- man/man2/getitimer.2 | 5 ++++- man/man2/getpagesize.2 | 5 +++-- man/man2/getpid.2 | 4 +++- man/man2/getpriority.2 | 6 ++++-- man/man2/getresuid.2 | 3 ++- man/man2/getrlimit.2 | 6 +++++- man/man2/getrusage.2 | 5 ++++- man/man2/getsid.2 | 7 +++++-- man/man2/gettimeofday.2 | 7 ++++--- man/man2/getuid.2 | 3 ++- 22 files changed, 80 insertions(+), 30 deletions(-)Range-diff against v0:
-: ------------ > 1: 1a421b5ee130 man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls -: ------------ > 2: 5327747ac3c3 man/man2/close.2: HISTORY: Update first POSIX appearance of close(2) -: ------------ > 3: 11e4b9d2ac05 man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2) -: ------------ > 4: 5d691ee5e6a3 man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2) -: ------------ > 5: eb5b310ab4dd man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2) -: ------------ > 6: 1f924f4f5c3c man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2) -: ------------ > 7: a44c49650063 man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants -: ------------ > 8: 7404e99ec690 man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2) -: ------------ > 9: 163be42a70ea man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2) -: ------------ > 10: 0dfa064b051b man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2) -: ------------ > 11: a968c006c218 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2) -: ------------ > 12: 566fd21d97b0 man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2) -: ------------ > 13: a54a94c8b118 man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2) -: ------------ > 14: 0097b249c950 man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2) -: ------------ > 15: 824605c82a14 man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2) -: ------------ > 16: f776e452e427 man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2) -: ------------ > 17: c2b9d37b6208 man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2) -: ------------ > 18: d5e7adf0a804 man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2) -: ------------ > 19: b5a7de01af52 man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2) -: ------------ > 20: 5e54217b8cec man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2) -: ------------ > 21: 1bc25963021c man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2) -: ------------ > 22: b93c17918b36 man/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2) -: ------------ > 23: 00b72e770428 man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)base-commit:
760458adc15668e910cefbbc4f9e11ccfd454411Signature · 1 line
2.47.3
Signature · 1 line
<https://www.alejandro-colomar.es>
v2 cover man/man2/*: Update history of syscalls CI-G
In reply to Seth McDonaldHi again,
v2 now treats listings of both 4.2BSD and 4.4BSD as equivalent to just 4.2BSD, and thus removes the redundant mention of 4.4BSD in such cases.
Seth McDonald (23):
man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of
clock_* syscalls
man/man2/close.2: HISTORY: Update first POSIX appearance of close(2) man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2) man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2) man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2) man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2) man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of
locking constants
man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2) man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of
fdatasync(2)
man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of
get[e][gu]id(2)
man/man2/getgroups.2: HISTORY: Update first POSIX appearance of
getgroups(2)
man/man2/gethostname.2: HISTORY: Split gethostname(2) and
sethostname(2)
man/man2/getitimer.2: HISTORY: Update first SUS appearance of
[gs]etitimer(2)
man/man2/getpagesize.2: HISTORY: Update first SUS appearance of
getpagesize(2)
man/man2/getpid.2: HISTORY: Update first POSIX appearance of
get[p]pid(2)
man/man2/getpriority.2: HISTORY: Update first POSIX appearance of
[gs]etpriority(2)
man/man2/getresuid.2: HISTORY: Update first POSIX appearance of
getres[gu]id(2)
man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of
[gs]etrlimit(2) man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2) man/man2/getrusage.2: HISTORY: Update first POSIX appearance of
getrusage(2)
man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of
gettimeofday(2)
man/man2/_exit.2 | 4 +++- man/man2/clock_getres.2 | 2 +- man/man2/close.2 | 4 +++- man/man2/dup.2 | 4 +++- man/man2/execve.2 | 4 +++- man/man2/fcntl.2 | 4 +++- man/man2/fcntl_locking.2 | 4 +++- man/man2/fork.2 | 4 +++- man/man2/fsync.2 | 9 ++++++++- man/man2/getgid.2 | 3 ++- man/man2/getgroups.2 | 4 +++- man/man2/gethostname.2 | 12 ++++++++---- man/man2/getitimer.2 | 5 ++++- man/man2/getpagesize.2 | 5 +++-- man/man2/getpid.2 | 4 +++- man/man2/getpriority.2 | 6 ++++-- man/man2/getresuid.2 | 3 ++- man/man2/getrlimit.2 | 6 +++++- man/man2/getrusage.2 | 5 ++++- man/man2/getsid.2 | 7 +++++-- man/man2/gettimeofday.2 | 7 ++++--- man/man2/getuid.2 | 3 ++- 22 files changed, 79 insertions(+), 30 deletions(-)
Range-diff against v1:
1: 1a421b5ee130 = 1: 1a421b5ee130 man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
2: 5327747ac3c3 = 2: 5327747ac3c3 man/man2/close.2: HISTORY: Update first POSIX appearance of close(2)
3: 11e4b9d2ac05 = 3: 11e4b9d2ac05 man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2)
4: 5d691ee5e6a3 = 4: 5d691ee5e6a3 man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2)
5: eb5b310ab4dd = 5: eb5b310ab4dd man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2)
6: 1f924f4f5c3c = 6: 1f924f4f5c3c man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2)
7: a44c49650063 = 7: a44c49650063 man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants
8: 7404e99ec690 = 8: 7404e99ec690 man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2)
9: 163be42a70ea ! 9: 7b237415d7b9 man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2)
@@ man/man2/fsync.2: .SH VERSIONS
+POSIX.1-2001.
+.TP
+.BR fdatasync ()
-+4.2BSD,
+POSIX.1-2001.
.P
In Linux 2.2 and earlier,10: 0dfa064b051b ! 10: ab31e843c470 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2)
@@ man/man2/fsync.2: .SH HISTORY
+POSIX.1-1996.
.TP
.BR fdatasync ()
- 4.2BSD,
+ POSIX.1-2001.
11: a968c006c218 ! 11: 0d67e7c63fd3 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2)
@@ Commit message
## man/man2/fsync.2 ##
@@ man/man2/fsync.2: .SH HISTORY
+ POSIX.1-1996.
.TP
.BR fdatasync ()
- 4.2BSD,
-POSIX.1-2001.
+POSIX.1-1996.
.P
12: 566fd21d97b0 = 12: 6b987649c5cc man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2)
13: a54a94c8b118 = 13: 4ad7acf2ef8c man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2)
14: 0097b249c950 ! 14: 94b81d0f1c2b man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2)
@@ man/man2/gethostname.2: .SH STANDARDS
.BR gethostname ()
-but not
-.BR sethostname ().
++4.2BSD,
+SVr4,
-+4.4BSD (first appeared in 4.2BSD),
+POSIX.1-2001.
+.TP
+.BR sethostname ()
-+SVr4,
-+4.4BSD (first appeared in 4.2BSD).
++4.2BSD,
++SVr4.
.P
Versions of glibc before glibc 2.2
.\" At least glibc 2.0 and glibc 2.1, older versions not checked
15: 824605c82a14 ! 15: 9c780e0e0176 man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2)
@@ man/man2/getitimer.2: .SH VERSIONS
None.
.SH HISTORY
-POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD).
++4.2BSD,
+SVr4,
-+4.4BSD (first appeared in 4.2BSD),
+SUSv1,
+POSIX.1-2001.
POSIX.1-2008 marked
16: f776e452e427 ! 16: 825144f95298 man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2)
@@ man/man2/getpagesize.2: .SH VERSIONS
.SH HISTORY
-This call first appeared in 4.2BSD.
-SVr4, 4.4BSD, SUSv2.
++4.2BSD,
+SVr4,
-+4.4BSD (first appeared in 4.2BSD),
+SUSv1.
In SUSv2 the
.BR getpagesize ()
17: c2b9d37b6208 = 17: db0485168785 man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2)
18: d5e7adf0a804 ! 18: 6bcf34a705e3 man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2)
@@ man/man2/getpriority.2: .SH ERRORS
.SH HISTORY
-POSIX.1-2001,
-SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD).
++4.2BSD,
+SVr4,
-+4.4BSD (first appeared in 4.2BSD),
+SUSv1,
+POSIX.1-2001 XSI.
.P
19: b5a7de01af52 = 19: 0afcc4b4083b man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2)
20: 5e54217b8cec = 20: ffb23d585617 man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2)
21: 1bc25963021c = 21: 8ec811d4690a man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2)
22: b93c17918b36 = 22: 3efc2800fc16 man/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2)
23: 00b72e770428 = 23: 37278a0497bd man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)base-commit: 760458adc15668e910cefbbc4f9e11ccfd454411
Signature · 1 line
2.47.3
PATCH v2 1/23 man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
clock_getres(2), clock_gettime(2), and clock_settime(2) first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.
[1] ISO/IEC 9945-1:1996, Section 14.2.1 "Clocks".
--- man/man2/clock_getres.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
man/man2/clock_getres.2 +1 -1
@@ -369,7 +369,7 @@ .SS C library/kernel differences .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SUSv2. +POSIX.1-1996, Linux 2.6. .P On POSIX systems on which these functions are available, the symbol
Signature · 1 line
2.47.3
Re: [PATCH v2 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
Quoted 4 lines · Seth McDonald
clock_getres(2),clock_gettime(2), andclock_settime(2)first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.
Technically these functions came from POSIX.1b (1003.1b-1993), which was a set of optional realtime extensions to POSIX, published as a separate document. POSIX.1-1996 integrated them into the main standard (1003.1-1996) as part of a Timers extension. In 1997 X/Open adopted them to SUSv2 as part of their own X/Open Realtime extension, which includes the POSIX Timers extension and other extensions that had been added to POSIX from POSIX.1b.
- Mark
Quoted 24 lines
[1] ISO/IEC 9945-1:1996, Section 14.2.1 "Clocks".
Signed-off-by Seth McDonald <[email protected]>--- man/man2/clock_getres.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)man/man2/clock_getres.2 +1
-2@@ -369,7 +369,7 @@ .SS C library/kernel differences .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SUSv2. +POSIX.1-1996, Linux 2.6. .P On POSIX systems on which these functions are available, the symbol --2.47.3
Alejandro Colomar
maintainerRe: [PATCH v2 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
Hi Mark, Seth,
Quoted 6 lines · Mark Harris
Quoted 4 lines · Seth McDonald
clock_getres(2),clock_gettime(2), andclock_settime(2)first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.
Quoted 7 lines
Technically these functions came from POSIX.1b (1003.1b-1993), which was a set of optional realtime extensions to POSIX, published as a separate document. POSIX.1-1996 integrated them into the main standard (1003.1-1996) as part of a Timers extension. In 1997 X/Open adopted them to SUSv2 as part of their own X/Open Realtime extension, which includes the POSIX Timers extension and other extensions that had been added to POSIX from POSIX.1b.
Thanks! For now, I think I'll take the patch, even if the commit message is factually incorrect. We can then do a future round of patches researching those less common POSIX extension standard.
Does this sound good?
Have a lovely day!
Alex
Quoted 27 lines
- Mark
Quoted 24 lines
[1] ISO/IEC 9945-1:1996, Section 14.2.1 "Clocks".
Signed-off-by Seth McDonald <[email protected]>--- man/man2/clock_getres.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)man/man2/clock_getres.2 +1
-2@@ -369,7 +369,7 @@ .SS C library/kernel differences .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SUSv2. +POSIX.1-1996, Linux 2.6. .P On POSIX systems on which these functions are available, the symbol --2.47.3
Signature · 1 line
<https://www.alejandro-colomar.es>
Re: [PATCH v2 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
Quoted 18 lines · Alejandro Colomar
Hi Mark, Seth,
Quoted 6 lines · Mark Harris
Quoted 4 lines · Seth McDonald
clock_getres(2),clock_gettime(2), andclock_settime(2)first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.Quoted 7 lines
Technically these functions came from POSIX.1b (1003.1b-1993), which was a set of optional realtime extensions to POSIX, published as a separate document. POSIX.1-1996 integrated them into the main standard (1003.1-1996) as part of a Timers extension. In 1997 X/Open adopted them to SUSv2 as part of their own X/Open Realtime extension, which includes the POSIX Timers extension and other extensions that had been added to POSIX from POSIX.1b.
Quoted 6 lines
Thanks! For now, I think I'll take the patch, even if the commit message is factually incorrect. We can then do a future round of patches researching those less common POSIX extension standard.
Does this sound good?
Sounds great!
- Mark
Quoted 34 lines
Have a lovely day!
AlexQuoted 11 lines
- Mark
Quoted 8 lines
[1] ISO/IEC 9945-1:1996, Section 14.2.1 "Clocks".
Signed-off-by Seth McDonald <[email protected]>--- man/man2/clock_getres.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)Quoted 16 lines
Quoted 14 lines
man/man2/clock_getres.2 +1
-2@@ -369,7 +369,7 @@ .SS C library/kernel differences .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SUSv2. +POSIX.1-1996, Linux 2.6. .P On POSIX systems on which these functions are available, the symbol --Quoted 2 lines
2.47.3
Re: [PATCH v2 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls
In reply to Alejandro ColomarHi Alex and Mark,
Quoted 17 lines · Alejandro Colomar
Hi Mark, Seth,
Quoted 6 lines · Mark Harris
Quoted 4 lines · Seth McDonald
clock_getres(2),clock_gettime(2), andclock_settime(2)first appeared in POSIX.1-1996.[1] SUSv2 incorporates POSIX.1-1996, so listing both is redundant.Quoted 7 lines
Technically these functions came from POSIX.1b (1003.1b-1993), which was a set of optional realtime extensions to POSIX, published as a separate document. POSIX.1-1996 integrated them into the main standard (1003.1-1996) as part of a Timers extension. In 1997 X/Open adopted them to SUSv2 as part of their own X/Open Realtime extension, which includes the POSIX Timers extension and other extensions that had been added to POSIX from POSIX.1b.
Quoted 3 lines
Thanks! For now, I think I'll take the patch, even if the commit message is factually incorrect. We can then do a future round of patches researching those less common POSIX extension standard.
Good to know. I'll be sure to phrase my patch descriptions more carefully from now on to prevent such inaccuracies.
Signature · 5 lines
Take care, Seth McDonald. On-list: 2336 E8D2 FEB1 5300 692C 62A9 5839 6AD8 9243 D369 Off-list: 82B9 620E 53D0 A1AE 2D69 6111 C267 B002 0A90 0289
PATCH v2 2/23 man/man2/close.2: HISTORY: Update first POSIX appearance of close(2)
In reply to Seth McDonaldclose(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 6.3.1 "Close a File".
--- man/man2/close.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/close.2 +3 -1
@@ -81,7 +81,9 @@ .SH ERRORS .SH STANDARDS POSIX.1-2008. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .\" SVr4 documents an additional ENOLINK error condition. .SH NOTES The close-on-exec file descriptor flag can be used to ensure
Signature · 1 line
2.47.3
PATCH v2 3/23 man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2)
In reply to Seth McDonalddup(2) and dup2(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 6.2.1 "Duplicate an Open File Descriptor".
--- man/man2/dup.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/dup.2 +3 -1
@@ -196,7 +196,9 @@ .SH HISTORY .BR dup () .TQ .BR dup2 () -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .\" SVr4 documents additional .\" EINTR and ENOLINK error conditions. POSIX.1 adds EINTR. .\" The EBUSY return is Linux-specific.
Signature · 1 line
2.47.3
PATCH v2 4/23 man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2)
In reply to Seth McDonaldexecve(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 3.1.2 "Execute a File".
--- man/man2/execve.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/execve.2 +3 -1
@@ -616,7 +616,9 @@ .SS Interpreter scripts .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .\" SVr4 documents additional error .\" conditions EAGAIN, EINTR, ELIBACC, ENOLINK, EMULTIHOP; POSIX does not .\" document ETXTBSY, EPERM, EFAULT, ELOOP, EIO, ENFILE, EMFILE, EINVAL,
Signature · 1 line
2.47.3
PATCH v2 5/23 man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2)
In reply to Seth McDonald_exit(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 3.2.2 "Terminate a Process".
--- man/man2/_exit.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/_exit.2 +3 -1
@@ -65,7 +65,9 @@ .SH STANDARDS .SH HISTORY .TP .BR _exit () -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .TP .BR _Exit () C99, POSIX.1-2001.
Signature · 1 line
2.47.3
PATCH v2 6/23 man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2)
In reply to Seth McDonaldfcntl(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 6.5.2 "File Control".
--- man/man2/fcntl.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/fcntl.2 +3 -1
@@ -134,7 +134,9 @@ .SH STANDARDS .\" .P .\" SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions. .SH HISTORY -SVr4, 4.3BSD, POSIX.1-2001. +4.3BSD, +SVr4, +POSIX.1-1988. .SH SEE ALSO .BR dup2 (2), .BR flock (2),
Signature · 1 line
2.47.3
PATCH v2 7/23 man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants
In reply to Seth McDonaldThe F_GETLK, F_SETLK, and F_SETLKW symbolic constants first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Table 6-1 "cmd Values for fcntl()".
--- man/man2/fcntl_locking.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/fcntl_locking.2 +3 -1
@@ -571,7 +571,9 @@ .SH HISTORY .B F_SETLK .TQ .B F_SETLKW -SVr4, 4.3BSD, POSIX.1-2001. +4.3BSD, +SVr4, +POSIX.1-1988. .TP .B F_OFD_SETLK .TQ
Signature · 1 line
2.47.3
PATCH v2 8/23 man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2)
In reply to Seth McDonaldfork(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 3.1.1 "Process Creation".
--- man/man2/fork.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/fork.2 +3 -1
@@ -278,7 +278,9 @@ .SS Async-signal safety .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +POSIX.1-1988. .SH NOTES Under Linux, .BR fork ()
Signature · 1 line
2.47.3
PATCH v2 9/23 man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2)
In reply to Seth McDonald--- man/man2/fsync.2 | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-)
man/man2/fsync.2 +7 -1
@@ -151,7 +151,13 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.2BSD. +.TP +.BR fsync () +4.2BSD, +POSIX.1-2001. +.TP +.BR fdatasync () +POSIX.1-2001. .P In Linux 2.2 and earlier, .BR fdatasync ()
Signature · 1 line
2.47.3
PATCH v2 10/23 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2)
In reply to Seth McDonaldfsync(2) first appeared in SUSv1.[1] The function was then added to POSIX.1-1996.[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 214.
[2] ISO/IEC 9945-1:1996, Section 6.6.1 "Synchronize the State of a File".
--- man/man2/fsync.2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
man/man2/fsync.2 +2 -1
@@ -154,7 +154,8 @@ .SH HISTORY .TP .BR fsync () 4.2BSD, -POSIX.1-2001. +SUSv1, +POSIX.1-1996. .TP .BR fdatasync () POSIX.1-2001.
Signature · 1 line
2.47.3
PATCH v2 11/23 man/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2)
In reply to Seth McDonaldfdatasync(2) first appeared in POSIX.1-1996.[1]
[1] ISO/IEC 9945-1:1996, Section 6.6.2 "Synchronize the Data of a File".
--- man/man2/fsync.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
man/man2/fsync.2 +1 -1
@@ -158,7 +158,7 @@ .SH HISTORY POSIX.1-1996. .TP .BR fdatasync () -POSIX.1-2001. +POSIX.1-1996. .P In Linux 2.2 and earlier, .BR fdatasync ()
Signature · 1 line
2.47.3
PATCH v2 12/23 man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2)
In reply to Seth McDonaldgetgid(2), getegid(2), getuid(2), and geteuid(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 4.2.1 "Get Real User, Effective User, Real Group, and Effective Group IDs".
--- man/man2/getgid.2 | 3 ++- man/man2/getuid.2 | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-)
man/man2/getgid.2 +2 -1
@@ -46,7 +46,8 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.3BSD. +4.3BSD, +POSIX.1-1988. .P The original Linux .BR getgid ()
man/man2/getuid.2 +2 -1
@@ -30,7 +30,8 @@ .SH ERRORS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.3BSD. +4.3BSD, +POSIX.1-1988. .P In UNIX\ V6 the .BR getuid ()
Signature · 1 line
2.47.3
PATCH v2 13/23 man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2)
In reply to Seth McDonaldgetgroups(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 4.2.3 "Get Supplementary Group IDs".
--- man/man2/getgroups.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/getgroups.2 +3 -1
@@ -157,7 +157,9 @@ .SH STANDARDS .SH HISTORY .TP .BR getgroups () -SVr4, 4.3BSD, POSIX.1-2001. +4.3BSD, +SVr4, +POSIX.1-1988. .TP .BR setgroups () SVr4, 4.3BSD.
Signature · 1 line
2.47.3
PATCH v2 14/23 man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2)
In reply to Seth McDonaldgethostname(2) first appeared in POSIX.1-2001.[1]
[1] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p. 516.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/gethostname.html>
--- man/man2/gethostname.2 | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-)
man/man2/gethostname.2 +8 -4
@@ -145,11 +145,15 @@ .SH STANDARDS .BR sethostname () None. .SH HISTORY -SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). -POSIX.1 specifies +.TP .BR gethostname () -but not -.BR sethostname (). +4.2BSD, +SVr4, +POSIX.1-2001. +.TP +.BR sethostname () +4.2BSD, +SVr4. .P Versions of glibc before glibc 2.2 .\" At least glibc 2.0 and glibc 2.1, older versions not checked
Signature · 1 line
2.47.3
PATCH v2 15/23 man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2)
In reply to Seth McDonaldgetitimer(2) and setitimer(2) first appeared in SUSv1.[1]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", pp. 244-245.
--- man/man2/getitimer.2 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
man/man2/getitimer.2 +4 -1
@@ -181,7 +181,10 @@ .SH VERSIONS .SH STANDARDS None. .SH HISTORY -POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD). +4.2BSD, +SVr4, +SUSv1, +POSIX.1-2001. POSIX.1-2008 marked .BR getitimer () and
Signature · 1 line
2.47.3
PATCH v2 16/23 man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2)
In reply to Seth McDonaldgetpagesize(2) first appeared in SUSv1.[1]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 254.
--- man/man2/getpagesize.2 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
man/man2/getpagesize.2 +3 -2
@@ -53,8 +53,9 @@ .SH VERSIONS .SH STANDARDS None. .SH HISTORY -This call first appeared in 4.2BSD. -SVr4, 4.4BSD, SUSv2. +4.2BSD, +SVr4, +SUSv1. In SUSv2 the .BR getpagesize () call was labeled LEGACY,
Signature · 1 line
2.47.3
PATCH v2 17/23 man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2)
In reply to Seth McDonaldgetpid(2) and getppid(2) first appeared in POSIX.1-1988.[1]
[1] IEEE Std 1003.1-1988, Section 4.1.1 "Get Process and Parent Process IDs".
--- man/man2/getpid.2 | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
man/man2/getpid.2 +3 -1
@@ -53,7 +53,9 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, 4.3BSD, SVr4. +4.3BSD, +SVr4, +POSIX.1-1988. .SS C library/kernel differences From glibc 2.3.4 up to and including glibc 2.24, the glibc wrapper function for
Signature · 1 line
2.47.3
PATCH v2 18/23 man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2)
In reply to Seth McDonaldgetpriority(2) and setpriority(2) first appeared in SUSv1.[1] The functions were added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", pp. 262-263.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp. 540-542.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getpriority.html>
--- man/man2/getpriority.2 | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-)
man/man2/getpriority.2 +4 -2
@@ -139,8 +139,10 @@ .SH ERRORS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, -SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). +4.2BSD, +SVr4, +SUSv1, +POSIX.1-2001 XSI. .P The details on the condition for .B EPERM
Signature · 1 line
2.47.3
PATCH v2 19/23 man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2)
In reply to Seth McDonaldgetresgid(2) and getresuid(2) first appeared in POSIX.1-2024 as an XSI extension.[1][2]
[1] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p. 1174.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresgid.html>
[2] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p. 1175.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresuid.html>
--- man/man2/getresuid.2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
man/man2/getresuid.2 +2 -1
@@ -42,7 +42,8 @@ .SH STANDARDS These calls also appear on HP-UX and some of the BSDs. .SH HISTORY Linux 2.1.44, -glibc 2.3.2. +glibc 2.3.2, +POSIX.1-2024 XSI. .P The original Linux .BR getresuid ()
Signature · 1 line
2.47.3
Alejandro Colomar
maintainerRe: [PATCH v2 19/23] man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2)
Hi Seth,
Quoted 20 lines · Seth McDonald
getresgid(2) and getresuid(2) first appeared in POSIX.1-2024 as an XSI extension.[1][2]
[1] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p. 1174.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresgid.html>
[2] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", p. 1175.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getresuid.html>Signed-off-by Seth McDonald <[email protected]>--- man/man2/getresuid.2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)man/man2/getresuid.2 +0
-0
man/man2/getresuid.2 .SH STANDARDS · line 46
Quoted 6 lines
man/man2/getresuid.2 +2
-1@@ -42,7 +42,8 @@ .SH STANDARDS These calls also appear on HP-UX and some of the BSDs. .SH HISTORY Linux 2.1.44, -glibc 2.3.2. +glibc 2.3.2, +POSIX.1-2024 XSI.
I've applied the patch, and amended to also document POSIX.1-2024 XSI in the STANDARDS section.
Have a lovely day!
Alex
Quoted 6 lines
man/man2/getresuid.2 +0
-0.P The original Linux .BR getresuid ()Signature · 1 line
2.47.3
Signature · 1 line
<https://www.alejandro-colomar.es>
PATCH v2 20/23 man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2)
In reply to Seth McDonaldgetrlimit(2) and setrlimit(2) first appeared in SUSv1.[1] The functions were added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2] Then POSIX.1-2024 added them to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", pp. 269-270.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp. 551-553.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getrlimit.html>
[3] IEEE Std 1003.1-2024, Volume 2, Chapter 3 "System Interfaces", pp. 1176-1179.
<https://pubs.opengroup.org/onlinepubs/9799919799/functions/getrlimit.html>
--- man/man2/getrlimit.2 | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-)
man/man2/getrlimit.2 +5 -1
@@ -554,7 +554,11 @@ .SH HISTORY .BR getrlimit () .TQ .BR setrlimit () -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +SUSv1, +POSIX.1-2001 XSI, +POSIX.1-2024. .TP .BR prlimit () Linux 2.6.36,
Signature · 1 line
2.47.3
PATCH v2 21/23 man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2)
In reply to Seth McDonaldgetsid(2) first appeared in SUSv1.[1] The function was added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2] Then POSIX.1-2008 added it to the base specification.[3]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 273.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p. 558.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getsid.html>
[3] IEEE Std 1003.1-2008, Volume 2, Chapter 3 "System Interfaces", p. 1073.
<https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/functions/getsid.html>
--- man/man2/getsid.2 | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-)
man/man2/getsid.2 +5 -2
@@ -60,8 +60,11 @@ .SH VERSIONS .SH STANDARDS POSIX.1-2024. .SH HISTORY -POSIX.1-2001, SVr4. -Linux 2.0. +SVr4, +SUSv1, +Linux 2.0, +POSIX.1-2001 XSI, +POSIX.1-2008. .\" Linux has this system call since Linux 1.3.44. .\" There is libc support since libc 5.2.19. .SH NOTES
Signature · 1 line
2.47.3
PATCH v2 22/23 man/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2)
In reply to Seth McDonaldgetrusage(2) first appeared in SUSv1.[1] The function was added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 271.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", pp. 554-555.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/getrusage.html>
--- man/man2/getrusage.2 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
man/man2/getrusage.2 +4 -1
@@ -195,7 +195,10 @@ .SH STANDARDS .B RUSAGE_THREAD is Linux-specific. .SH HISTORY -POSIX.1-2001, SVr4, 4.3BSD. +4.3BSD, +SVr4, +SUSv1, +POSIX.1-2001 XSI. .P Before Linux 2.6.9, if the disposition of .B SIGCHLD
Signature · 1 line
2.47.3
PATCH v2 23/23 man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)
In reply to Seth McDonaldgettimeofday(2) first appeared in SUSv1.[1] The function was added to POSIX.1-2001 when POSIX and SUS merged, but as an XSI extension (still SUS-only).[2]
[1] X/Open CAE Specification, System Interfaces and Headers Issue 4, Version 2, Chapter 3 "System Interfaces", p. 275.
[2] IEEE Std 1003.1-2001, Volume 2, Chapter 3 "System Interfaces", p. 567.
<https://pubs.opengroup.org/onlinepubs/009604499/functions/gettimeofday.html>
--- man/man2/gettimeofday.2 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-)
man/man2/gettimeofday.2 +4 -3
@@ -177,12 +177,13 @@ .SS C library/kernel differences .SH STANDARDS None. .SH HISTORY -SVr4, 4.3BSD. -POSIX.1-2001 described +4.3BSD, +SVr4. +SUSv1 and POSIX.1-2001 XSI described .BR gettimeofday () but not .BR settimeofday (). -POSIX.1-2008 marked +POSIX.1-2008 XSI marked .BR gettimeofday () as obsolete, recommending the use of .BR clock_gettime (2)
Signature · 1 line
2.47.3
Hi Seth,
Quoted 6 lines · Seth McDonald
Hi again,
v2 now treats listings of both 4.2BSD and 4.4BSD as equivalent to just 4.2BSD, and thus removes the redundant mention of 4.4BSD in such cases.
Seth McDonald (23):
I've applied all 23 patches. Thanks!
Cheers,
Alex
Quoted 163 lines
man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of
clock_* syscalls
man/man2/close.2: HISTORY: Update first POSIX appearance of close(2) man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2) man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2) man/man2/_exit.2: HISTORY: Update first POSIX appearance of_exit(2)man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2) man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of
locking constants
man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2) man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2) man/man2/fsync.2: HISTORY: Update first POSIX appearance of
fdatasync(2)
man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance ofget[e][gu]id(2) man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2) man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2) man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2) man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2) man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2) man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2) man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2) man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2)man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2) man/man2/getrusage.2: HISTORY: Update first POSIX appearance of
getrusage(2)
man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of
gettimeofday(2)man/man2/_exit.2 | 4 +++- man/man2/clock_getres.2 | 2 +- man/man2/close.2 | 4 +++- man/man2/dup.2 | 4 +++- man/man2/execve.2 | 4 +++- man/man2/fcntl.2 | 4 +++- man/man2/fcntl_locking.2 | 4 +++- man/man2/fork.2 | 4 +++- man/man2/fsync.2 | 9 ++++++++- man/man2/getgid.2 | 3 ++- man/man2/getgroups.2 | 4 +++- man/man2/gethostname.2 | 12 ++++++++---- man/man2/getitimer.2 | 5 ++++- man/man2/getpagesize.2 | 5 +++-- man/man2/getpid.2 | 4 +++- man/man2/getpriority.2 | 6 ++++-- man/man2/getresuid.2 | 3 ++- man/man2/getrlimit.2 | 6 +++++- man/man2/getrusage.2 | 5 ++++- man/man2/getsid.2 | 7 +++++-- man/man2/gettimeofday.2 | 7 ++++--- man/man2/getuid.2 | 3 ++- 22 files changed, 79 insertions(+), 30 deletions(-)Range-diff against v1:
1: 1a421b5ee130 = 1: 1a421b5ee130 man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls 2: 5327747ac3c3 = 2: 5327747ac3c3 man/man2/close.2: HISTORY: Update first POSIX appearance of close(2) 3: 11e4b9d2ac05 = 3: 11e4b9d2ac05 man/man2/dup.2: HISTORY: Update first POSIX appearance of dup[2](2) 4: 5d691ee5e6a3 = 4: 5d691ee5e6a3 man/man2/execve.2: HISTORY: Update first POSIX appearance of execve(2) 5: eb5b310ab4dd = 5: eb5b310ab4dd man/man2/_exit.2: HISTORY: Update first POSIX appearance of _exit(2) 6: 1f924f4f5c3c = 6: 1f924f4f5c3c man/man2/fcntl.2: HISTORY: Update first POSIX appearance of fcntl(2) 7: a44c49650063 = 7: a44c49650063 man/man2/fcntl_locking.2: HISTORY: Update first POSIX appearance of locking constants 8: 7404e99ec690 = 8: 7404e99ec690 man/man2/fork.2: HISTORY: Update first POSIX appearance of fork(2) 9: 163be42a70ea ! 9: 7b237415d7b9 man/man2/fsync.2: HISTORY: Split fsync(2) and fdatasync(2) @@ man/man2/fsync.2: .SH VERSIONS +POSIX.1-2001. +.TP +.BR fdatasync () -+4.2BSD, +POSIX.1-2001. .P In Linux 2.2 and earlier,10:
0dfa064b051b! 10:ab31e843c470man/man2/fsync.2: HISTORY: Update first POSIX appearance of fsync(2)
@@ man/man2/fsync.2: .SH HISTORY
+POSIX.1-1996.
.TP
.BR fdatasync ()
- 4.2BSD,
+ POSIX.1-2001.
11:a968c006c218! 11:0d67e7c63fd3man/man2/fsync.2: HISTORY: Update first POSIX appearance of fdatasync(2)@@ Commit message ## man/man2/fsync.2 ## @@ man/man2/fsync.2: .SH HISTORY + POSIX.1-1996. .TP .BR fdatasync () - 4.2BSD, -POSIX.1-2001. +POSIX.1-1996. .P 12: 566fd21d97b0 = 12: 6b987649c5cc man/man2/get[gu]id.2: HISTORY: Update first POSIX appearance of get[e][gu]id(2) 13: a54a94c8b118 = 13: 4ad7acf2ef8c man/man2/getgroups.2: HISTORY: Update first POSIX appearance of getgroups(2) 14: 0097b249c950 ! 14: 94b81d0f1c2b man/man2/gethostname.2: HISTORY: Split gethostname(2) and sethostname(2) @@ man/man2/gethostname.2: .SH STANDARDS .BR gethostname () -but not -.BR sethostname (). ++4.2BSD, +SVr4, -+4.4BSD (first appeared in 4.2BSD), +POSIX.1-2001. +.TP +.BR sethostname () -+SVr4, -+4.4BSD (first appeared in 4.2BSD). ++4.2BSD, ++SVr4. .P Versions of glibc before glibc 2.2 .\" At least glibc 2.0 and glibc 2.1, older versions not checked 15: 824605c82a14 ! 15: 9c780e0e0176 man/man2/getitimer.2: HISTORY: Update first SUS appearance of [gs]etitimer(2) @@ man/man2/getitimer.2: .SH VERSIONS None. .SH HISTORY -POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD). ++4.2BSD, +SVr4, -+4.4BSD (first appeared in 4.2BSD), +SUSv1, +POSIX.1-2001. POSIX.1-2008 marked 16: f776e452e427 ! 16: 825144f95298 man/man2/getpagesize.2: HISTORY: Update first SUS appearance of getpagesize(2) @@ man/man2/getpagesize.2: .SH VERSIONS .SH HISTORY -This call first appeared in 4.2BSD. -SVr4, 4.4BSD, SUSv2. ++4.2BSD, +SVr4, -+4.4BSD (first appeared in 4.2BSD), +SUSv1. In SUSv2 the .BR getpagesize () 17: c2b9d37b6208 = 17: db0485168785 man/man2/getpid.2: HISTORY: Update first POSIX appearance of get[p]pid(2) 18: d5e7adf0a804 ! 18: 6bcf34a705e3 man/man2/getpriority.2: HISTORY: Update first POSIX appearance of [gs]etpriority(2) @@ man/man2/getpriority.2: .SH ERRORS .SH HISTORY -POSIX.1-2001, -SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). ++4.2BSD, +SVr4, -+4.4BSD (first appeared in 4.2BSD), +SUSv1, +POSIX.1-2001 XSI. .P 19: b5a7de01af52 = 19: 0afcc4b4083b man/man2/getresuid.2: HISTORY: Update first POSIX appearance of getres[gu]id(2) 20: 5e54217b8cec = 20: ffb23d585617 man/man2/getrlimit.2: HISTORY: Update first POSIX appearance of [gs]etrlimit(2) 21: 1bc25963021c = 21: 8ec811d4690a man/man2/getsid.2: HISTORY: Update first POSIX appearance of getsid(2) 22: b93c17918b36 = 22: 3efc2800fc16 man/man2/getrusage.2: HISTORY: Update first POSIX appearance of getrusage(2) 23: 00b72e770428 = 23: 37278a0497bd man/man2/gettimeofday.2: HISTORY: Update first POSIX appearance of gettimeofday(2)base-commit:
760458adc15668e910cefbbc4f9e11ccfd454411Signature · 1 line
2.47.3
Signature · 1 line
<https://www.alejandro-colomar.es>