[Bug 217291] New: librt empty, man pages should not tell users to link with -lrt

bugzilla-daemon
2023-04-03T08:23:23Z

Bug ID: 217291
Summary: librt empty, man pages should not tell users to link
with -lrt
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: low
Priority: P1
Component: man-pages
Assignee: documentation_man-pages@kernel-bugs.osdl.org
Reporter: blomqvist.janne@gmail.com
Regression: No

Nowadays librt.a is empty and librt.so is an empty placeholder, and everything
has moved to libc proper. Similar to what was done with clock_gettime() and
friends for glibc 2.17. Man pages should have similar language as for
clock_gettime that one no longer needs to link with -lrt except for old glibc
versions.

Looking at the output of git grep -F -e '-lrt' in the man-pages repo it seems
the following man pages need fixing:

man2/timer_create.2 - Moved to libc in glibc 2.34
man2/timer_delete.2 - Same
man2/timer_getoverrun.2 - Same
man2/timer_settime.2 - Same
man3/aio_cancel.3 - Same
man3/aio_error.3 - Same
man3/aio_fsync.3 - Same
man3/aio_init.3 - Same
man3/aio_read.3 - Same
man3/aio_return.3 - Same
man3/aio_suspend.3 - Same
man3/aio_write.3 - Same
man3/intro.3 - No need to mention obsolete librt?
man3/lio_listio.3 - Moved to libc in glibc 2.34
man3/mq_close.3 - Same
man3/mq_getattr.3 - Same
man3/mq_notify.3 - Same
man3/mq_open.3 - Same
man3/mq_receive.3 - Same
man3/mq_send.3 - Same
man3/mq_unlink.3 - Same
man3/pthread_getcpuclockid.3 - Remove -lrt from example comment
man3/shm_open.3 - Moved to libc in glibc 2.34
man7/mq_overview.7 - Update to reflect that -lrt needed only for
glibc < 2.34
man7/shm_overview.7 - Same