* perfmonctl.2: Is it up to date?
@ 2021-04-23 10:31 Alejandro Colomar (man-pages)
2021-05-09 18:09 ` Michael Kerrisk (man-pages)
0 siblings, 1 reply; 2+ messages in thread
From: Alejandro Colomar (man-pages) @ 2021-04-23 10:31 UTC (permalink / raw)
To: Michael Kerrisk (man-pages); +Cc: linux-man
Hi Michael,
I haven't found any of the constants (PFM_*) used by this function in
glibc. Also not in the kernel, although in the kernel I found other
PFM_* constants different from the ones in the manual page.
I checked that this page hasn't received any patches in a very long time
(except for "Various pages" patches), so I suspect it may be out of date.
Also, does <perfmon.h> really exist? I couldn't find it either.
Cheers,
Alex
--
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: perfmonctl.2: Is it up to date?
2021-04-23 10:31 perfmonctl.2: Is it up to date? Alejandro Colomar (man-pages)
@ 2021-05-09 18:09 ` Michael Kerrisk (man-pages)
0 siblings, 0 replies; 2+ messages in thread
From: Michael Kerrisk (man-pages) @ 2021-05-09 18:09 UTC (permalink / raw)
To: Alejandro Colomar (man-pages); +Cc: mtk.manpages, linux-man
Hello Alex,
On 4/23/21 10:31 PM, Alejandro Colomar (man-pages) wrote:
> Hi Michael,
>
> I haven't found any of the constants (PFM_*) used by this function in
> glibc. Also not in the kernel, although in the kernel I found other
> PFM_* constants different from the ones in the manual page.
>
> I checked that this page hasn't received any patches in a very long time
> (except for "Various pages" patches), so I suspect it may be out of date.
>
> Also, does <perfmon.h> really exist? I couldn't find it either.
It's certainly not up to date! In fact, this system call was removed
in Linux 5.10. I have applied the patch below.
Cheers,
Michael
diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2
index b376126a1..319712e6d 100644
--- a/man2/perfmonctl.2
+++ b/man2/perfmonctl.2
@@ -196,12 +196,18 @@ On error, \-1 is returned and
is set to indicate the error.
.SH VERSIONS
.BR perfmonctl ()
-is available since Linux 2.4.
+was added in Linux 2.4;
+.\" commit ecf5b72d5f66af843f189dfe9ce31598c3e48ad7
+it was removed in Linux 5.10.
.SH CONFORMING TO
.BR perfmonctl ()
is Linux-specific and is available only on the IA-64 architecture.
.SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
+This system call was broken for many years,
+and ultimately removed in Linux 5.10.
+.PP
+Glibc does not provide a wrapper for this system call;
+on kernels where it exists, call it using
.BR syscall (2).
.SH SEE ALSO
.BR gprof (1)
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
^ permalink raw reply related [flat|nested] 2+ messages in thread
end of thread, other threads:[~2021-05-09 18:10 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-04-23 10:31 perfmonctl.2: Is it up to date? Alejandro Colomar (man-pages)
2021-05-09 18:09 ` Michael Kerrisk (man-pages)
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.