Hi Petr Petr Baudis wrote: > Hi! > > I'm sorry, I won't have time to review the manpage in detail in the > nearest future. :-( So three nits is all I can offer... Thanks for taking a look anyway... > On Mon, Jan 12, 2009 at 06:07:14PM +1300, Michael Kerrisk wrote: >> .TH RTLD-AUDIT 7 2009-01-12 "Linux" "Linux Programmer's Manual" >> .SH NAME >> rtld-audit \- auditing API for the dynamic linker >> .SH SYNOPSIS >> .B #define _GNU_SOURCE >> >> .B #include <link.h> >> .SH DESCRIPTION >> The GNU dynamic linker (run-time linker) > > The parentheses look awkward, is it necessary to have? Better to have, IMO. >> provides an auditing API that allows an application >> to be notified when various dynamic linking events occur. >> This API is very similar to the auditing interface provided by the >> Solaris run-time linker. > > So there _are_ differences? "compatible with", maybe? Actually, I think "very similar" is probably better. To me, "compatible" implies something even closer to "they are the same". >> The necessary constants and prototypes are defined by including >> .IR <link.h> . >> >> To use this interface, the programmer creates a shared library >> that implements a standard set of function names. >> Not all of the functions need to be implemented: in most cases, >> if the programmer is not interested in a particular class of auditing event, >> then no implementation needs to be provided for the corresponding >> auditing function. >> >> To employ the auditing interface, the environment variable >> .BR LD_AUDIT >> must be defined to contain a colon-separated list of shared libraries, >> each of which can implement (parts of) the auditing API. >> .\" FIXME Does specifying multiple audit libraries actually work >> .\" on GNU? My simple tests on Solaris work okay, but not on >> .\" Linux -- mtk, Jan 2009 >> .\" glibc bug filed: http://sourceware.org/bugzilla/show_bug.cgi?id=9733 > > Make a BUGS section for this? I'm still not 100% sure whether this is a bug in glibc, or a bug in my understanding, so, I'm reluctant at this stage to write it up in a BUGS section. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
