From fc22b3d6507c6745911b9dfcc68f1e665ae13dbc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:43:11 +0200 Subject: Adding upstream version 4.22.0. Signed-off-by: Daniel Baumann --- templates/man7/rtld-audit.7.pot | 1219 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 1219 insertions(+) create mode 100644 templates/man7/rtld-audit.7.pot (limited to 'templates/man7/rtld-audit.7.pot') diff --git a/templates/man7/rtld-audit.7.pot b/templates/man7/rtld-audit.7.pot new file mode 100644 index 00000000..6d1d00df --- /dev/null +++ b/templates/man7/rtld-audit.7.pot @@ -0,0 +1,1219 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-01 17:06+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "RTLD-AUDIT" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "rtld-audit - auditing API for the dynamic linker" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n" +"B<#include Elink.hE>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The GNU dynamic linker (run-time linker) 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. The necessary constants and prototypes are defined " +"by including Ilink.hE>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"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." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"To employ the auditing interface, the environment variable B must " +"be defined to contain a colon-separated list of shared libraries, each of " +"which can implement (parts of) the auditing API. When an auditable event " +"occurs, the corresponding function is invoked in each library, in the order " +"that the libraries are listed." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_version()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BIB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This is the only function that I be defined by an auditing library: it " +"performs the initial handshake between the dynamic linker and the auditing " +"library. When invoking this function, the dynamic linker passes, in " +"I, the highest version of the auditing interface that the linker " +"supports." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A typical implementation of this function simply returns the constant " +"B, which indicates the version of Ilink.hE> that was " +"used to build the audit module. If the dynamic linker does not support this " +"version of the audit interface, it will refuse to activate this audit " +"module. If the function returns zero, the dynamic linker also does not " +"activate this audit module." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In order to enable backwards compatibility with older dynamic linkers, an " +"audit module can examine the I argument and return an earlier " +"version than B, assuming the module can adjust its " +"implementation to match the requirements of the previous version of the " +"audit interface. The B function should not return the value of " +"I without further checks because it could correspond to an " +"interface that does not match the Ilink.hE> definitions used to " +"build the audit module." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_objsearch()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"BIB<, uintptr_t *>IB<,>\n" +"B< unsigned int >IB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The dynamic linker invokes this function to inform the auditing library that " +"it is about to search for a shared object. The I argument is the " +"filename or pathname that is to be searched for. I identifies the " +"shared object that initiated the search. I is set to one of the " +"following values:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This is the original name that is being searched for. Typically, this name " +"comes from an ELF B entry, or is the I argument given " +"to B(3)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I was created using a directory specified in B." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I was created using a directory specified in an ELF B or " +"B list." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I was found via the B(8) cache (I)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I was found via a search of one of the default directories." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I is specific to a secure object (unused on Linux)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"As its function result, B() returns the pathname that the " +"dynamic linker should use for further processing. If NULL is returned, then " +"this pathname is ignored for further processing. If this audit library " +"simply intends to monitor search paths, then I should be returned." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_activity()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BIB<, unsigned int >IB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The dynamic linker calls this function to inform the auditing library that " +"link-map activity is occurring. I identifies the object at the head " +"of the link map. When the dynamic linker invokes this function, I is " +"set to one of the following values:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "New objects are being added to the link map." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Objects are being removed from the link map." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Link-map activity has been completed: the map is once again consistent." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_objopen()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"BIB<, Lmid_t >IB<,>\n" +"B< uintptr_t *>IB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The dynamic linker calls this function when a new shared object is loaded. " +"The I argument is a pointer to a link-map structure that describes the " +"object. The I field has one of the following values" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Link map is part of the initial namespace." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Link map is part of a new namespace requested via B(3)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I is a pointer to an identifier for this object. The identifier is " +"provided to later calls to functions in the auditing library in order to " +"identify this object. This identifier is initialized to point to object's " +"link map, but the audit library can change the identifier to some other " +"value that it may prefer to use to identify the object." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"As its return value, B() returns a bit mask created by ORing " +"zero or more of the following constants, which allow the auditing library to " +"select the objects to be monitored by B():" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Audit symbol bindings to this object." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Audit symbol bindings from this object." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A return value of 0 from B() indicates that no symbol bindings " +"should be audited for this object." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_objclose()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BIB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The dynamic linker invokes this function after any finalization code for the " +"object has been executed, before the object is unloaded. The I " +"argument is the identifier obtained from a previous invocation of " +"B()." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In the current implementation, the value returned by B() is " +"ignored." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_preinit()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BIB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The dynamic linker invokes this function after all shared objects have been " +"loaded, before control is passed to the application (i.e., before calling " +"I
()). Note that I
() may still later dynamically load objects " +"using B(3)." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_symbind*()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"BIB<, unsigned int >IB<,>\n" +"B< uintptr_t *>IB<, uintptr_t *>IB<,>\n" +"B< unsigned int *>IB<, const char *>IB<);>\n" +"BIB<, unsigned int >IB<,>\n" +"B< uintptr_t *>IB<, uintptr_t *>IB<,>\n" +"B< unsigned int *>IB<, const char *>IB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The dynamic linker invokes one of these functions when a symbol binding " +"occurs between two shared objects that have been marked for auditing " +"notification by B(). The B() function is " +"employed on 32-bit platforms; the B() function is employed on " +"64-bit platforms." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument is a pointer to a structure that provides information " +"about the symbol being bound. The structure definition is shown in " +"Ielf.hE>. Among the fields of this structure, I " +"indicates the address to which the symbol is bound." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument gives the index of the symbol in the symbol table of the " +"bound shared object." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument identifies the shared object that is making the " +"symbol reference; this is the same identifier that is provided to the " +"B() function that returned B. The I " +"argument identifies the shared object that defines the referenced symbol; " +"this is the same identifier that is provided to the B() " +"function that returned B." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument points a string containing the name of the symbol." +msgstr "" + +#. LA_SYMB_STRUCTCALL appears to be unused +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument is a bit mask that both provides information about the " +"symbol and can be used to modify further auditing of this PLT (Procedure " +"Linkage Table) entry. The dynamic linker may supply the following bit " +"values in this argument:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The binding resulted from a call to B(3)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A previous B() call returned an alternate value for this " +"symbol." +msgstr "" + +#. pltenter/pltexit are called for non-dynamically loaded libraries, +#. but don't seem to be called for dynamically loaded libs? +#. Is this the same on Solaris? +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"By default, if the auditing library implements B() and " +"B() functions (see below), then these functions are invoked, " +"after B(), for PLT entries, each time the symbol is referenced. " +"The following flags can be ORed into I<*flags> to change this default " +"behavior:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Don't call B() for this symbol." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Don't call B() for this symbol." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The return value of B() and B() is the address " +"to which control should be passed after the function returns. If the " +"auditing library is simply monitoring symbol bindings, then it should return " +"Ist_value>. A different value may be returned if the library " +"wishes to direct control to an alternate location." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_pltenter()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The precise name and argument types for this function depend on the hardware " +"platform. (The appropriate definition is supplied by Ilink.hE>.) " +"Here is the definition for x86-32:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"BIB<, unsigned int >IB<,>\n" +"B< uintptr_t *>IB<, uintptr_t *>IB<,>\n" +"B< La_i86_regs *>IB<, unsigned int *>IB<,>\n" +"B< const char *>IB<, long *>IB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This function is invoked just before a PLT entry is called, between two " +"shared objects that have been marked for binding notification." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I, I, I, I, and I are as for " +"B()." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument points to a structure (defined in Ilink.hE>) " +"containing the values of registers to be used for the call to this PLT entry." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument points to a bit mask that conveys information about, " +"and can be used to modify subsequent auditing of, this PLT entry, as for " +"B()." +msgstr "" + +#. FIXME . Is the following correct? +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument points to a I buffer that can be used " +"to explicitly set the frame size used for the call to this PLT entry. If " +"different B() invocations for this symbol return different " +"values, then the maximum returned value is used. The B() " +"function is called only if this buffer is explicitly set to a suitable value." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The return value of B() is as for B()." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "la_pltexit()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"BIB<, unsigned int >IB<,>\n" +"B< uintptr_t *>IB<, uintptr_t *>IB<,>\n" +"B< const La_i86_regs *>IB<, La_i86_retval *>IB<,>\n" +"B< const char *>IB<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This function is called when a PLT entry, made between two shared objects " +"that have been marked for binding notification, returns. The function is " +"called just before control returns to the caller of the PLT entry." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I argument points to a structure (defined in Ilink." +"hE>) containing the values of registers used for the call to this PLT " +"entry. The I argument points to a structure (defined in " +"Ilink.hE>) containing return values for the call to this PLT " +"entry. These values can be modified by the caller, and the changes will be " +"visible to the caller of the PLT entry." +msgstr "" + +#. This differs from Solaris, where an audit library that monitors +#. symbol binding should return the value of the 'retval' argument +#. (not provided by GNU, but equivalent to returning outregs->lrv_eax +#. on (say) x86-32). +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In the current GNU implementation, the return value of B() is " +"ignored." +msgstr "" + +#. type: SH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This API is very similar to the Solaris API described in the Solaris " +"I, in the chapter I." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "STANDARDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "None." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Note the following differences from the Solaris dynamic linker auditing API:" +msgstr "" + +#. type: IP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "\\[bu]" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The Solaris B() interface is not supported by the GNU " +"implementation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The Solaris B() and B() functions do not provide " +"a I argument." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The Solaris B() function does not provide I and " +"I arguments (but does provide a I argument with the " +"function return value)." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BUGS" +msgstr "" + +#. FIXME . Specifying multiple audit libraries doesn't 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 +#. Reportedly, this is fixed on 16 Mar 2009 (i.e., for glibc 2.10) +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In glibc versions up to and include 2.9, specifying more than one audit " +"library in B results in a run-time crash. This is reportedly " +"fixed in glibc 2.10." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"#include Elink.hE\n" +"#include Estdio.hE\n" +"\\&\n" +"unsigned int\n" +"la_version(unsigned int version)\n" +"{\n" +" printf(\"la_version(): version = %u; LAV_CURRENT = %u\\en\",\n" +" version, LAV_CURRENT);\n" +"\\&\n" +" return LAV_CURRENT;\n" +"}\n" +"\\&\n" +"char *\n" +"la_objsearch(const char *name, uintptr_t *cookie, unsigned int flag)\n" +"{\n" +" printf(\"la_objsearch(): name = %s; cookie = %p\", name, cookie);\n" +" printf(\"; flag = %s\\en\",\n" +" (flag == LA_SER_ORIG) ? \"LA_SER_ORIG\" :\n" +" (flag == LA_SER_LIBPATH) ? \"LA_SER_LIBPATH\" :\n" +" (flag == LA_SER_RUNPATH) ? \"LA_SER_RUNPATH\" :\n" +" (flag == LA_SER_DEFAULT) ? \"LA_SER_DEFAULT\" :\n" +" (flag == LA_SER_CONFIG) ? \"LA_SER_CONFIG\" :\n" +" (flag == LA_SER_SECURE) ? \"LA_SER_SECURE\" :\n" +" \"???\");\n" +"\\&\n" +" return name;\n" +"}\n" +"\\&\n" +"void\n" +"la_activity (uintptr_t *cookie, unsigned int flag)\n" +"{\n" +" printf(\"la_activity(): cookie = %p; flag = %s\\en\", cookie,\n" +" (flag == LA_ACT_CONSISTENT) ? \"LA_ACT_CONSISTENT\" :\n" +" (flag == LA_ACT_ADD) ? \"LA_ACT_ADD\" :\n" +" (flag == LA_ACT_DELETE) ? \"LA_ACT_DELETE\" :\n" +" \"???\");\n" +"}\n" +"\\&\n" +"unsigned int\n" +"la_objopen(struct link_map *map, Lmid_t lmid, uintptr_t *cookie)\n" +"{\n" +" printf(\"la_objopen(): loading \\e\"%s\\e\"; lmid = %s; cookie=%p\\en\",\n" +" map-El_name,\n" +" (lmid == LM_ID_BASE) ? \"LM_ID_BASE\" :\n" +" (lmid == LM_ID_NEWLM) ? \"LM_ID_NEWLM\" :\n" +" \"???\",\n" +" cookie);\n" +"\\&\n" +" return LA_FLG_BINDTO | LA_FLG_BINDFROM;\n" +"}\n" +"\\&\n" +"unsigned int\n" +"la_objclose (uintptr_t *cookie)\n" +"{\n" +" printf(\"la_objclose(): %p\\en\", cookie);\n" +"\\&\n" +" return 0;\n" +"}\n" +"\\&\n" +"void\n" +"la_preinit(uintptr_t *cookie)\n" +"{\n" +" printf(\"la_preinit(): %p\\en\", cookie);\n" +"}\n" +"\\&\n" +"uintptr_t\n" +"la_symbind32(Elf32_Sym *sym, unsigned int ndx, uintptr_t *refcook,\n" +" uintptr_t *defcook, unsigned int *flags, const char *symname)\n" +"{\n" +" printf(\"la_symbind32(): symname = %s; sym-Est_value = %p\\en\",\n" +" symname, sym-Est_value);\n" +" printf(\" ndx = %u; flags = %#x\", ndx, *flags);\n" +" printf(\"; refcook = %p; defcook = %p\\en\", refcook, defcook);\n" +"\\&\n" +" return sym-Est_value;\n" +"}\n" +"\\&\n" +"uintptr_t\n" +"la_symbind64(Elf64_Sym *sym, unsigned int ndx, uintptr_t *refcook,\n" +" uintptr_t *defcook, unsigned int *flags, const char *symname)\n" +"{\n" +" printf(\"la_symbind64(): symname = %s; sym-Est_value = %p\\en\",\n" +" symname, sym-Est_value);\n" +" printf(\" ndx = %u; flags = %#x\", ndx, *flags);\n" +" printf(\"; refcook = %p; defcook = %p\\en\", refcook, defcook);\n" +"\\&\n" +" return sym-Est_value;\n" +"}\n" +"\\&\n" +"Elf32_Addr\n" +"la_i86_gnu_pltenter(Elf32_Sym *sym, unsigned int ndx,\n" +" uintptr_t *refcook, uintptr_t *defcook, La_i86_regs *regs,\n" +" unsigned int *flags, const char *symname, long *framesizep)\n" +"{\n" +" printf(\"la_i86_gnu_pltenter(): %s (%p)\\en\", symname, sym-Est_value);\n" +"\\&\n" +" return sym-Est_value;\n" +"}\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B(1), B(3), B(8), B(8)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2023-02-05" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"This API is nonstandard, but very similar to the Solaris API, described in " +"the Solaris I, in the chapter I." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#include Elink.hE\n" +"#include Estdio.hE\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"unsigned int\n" +"la_version(unsigned int version)\n" +"{\n" +" printf(\"la_version(): version = %u; LAV_CURRENT = %u\\en\",\n" +" version, LAV_CURRENT);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" return LAV_CURRENT;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"char *\n" +"la_objsearch(const char *name, uintptr_t *cookie, unsigned int flag)\n" +"{\n" +" printf(\"la_objsearch(): name = %s; cookie = %p\", name, cookie);\n" +" printf(\"; flag = %s\\en\",\n" +" (flag == LA_SER_ORIG) ? \"LA_SER_ORIG\" :\n" +" (flag == LA_SER_LIBPATH) ? \"LA_SER_LIBPATH\" :\n" +" (flag == LA_SER_RUNPATH) ? \"LA_SER_RUNPATH\" :\n" +" (flag == LA_SER_DEFAULT) ? \"LA_SER_DEFAULT\" :\n" +" (flag == LA_SER_CONFIG) ? \"LA_SER_CONFIG\" :\n" +" (flag == LA_SER_SECURE) ? \"LA_SER_SECURE\" :\n" +" \"???\");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" return name;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"void\n" +"la_activity (uintptr_t *cookie, unsigned int flag)\n" +"{\n" +" printf(\"la_activity(): cookie = %p; flag = %s\\en\", cookie,\n" +" (flag == LA_ACT_CONSISTENT) ? \"LA_ACT_CONSISTENT\" :\n" +" (flag == LA_ACT_ADD) ? \"LA_ACT_ADD\" :\n" +" (flag == LA_ACT_DELETE) ? \"LA_ACT_DELETE\" :\n" +" \"???\");\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"unsigned int\n" +"la_objopen(struct link_map *map, Lmid_t lmid, uintptr_t *cookie)\n" +"{\n" +" printf(\"la_objopen(): loading \\e\"%s\\e\"; lmid = %s; cookie=%p\\en\",\n" +" map-El_name,\n" +" (lmid == LM_ID_BASE) ? \"LM_ID_BASE\" :\n" +" (lmid == LM_ID_NEWLM) ? \"LM_ID_NEWLM\" :\n" +" \"???\",\n" +" cookie);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" return LA_FLG_BINDTO | LA_FLG_BINDFROM;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"unsigned int\n" +"la_objclose (uintptr_t *cookie)\n" +"{\n" +" printf(\"la_objclose(): %p\\en\", cookie);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" return 0;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"void\n" +"la_preinit(uintptr_t *cookie)\n" +"{\n" +" printf(\"la_preinit(): %p\\en\", cookie);\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"uintptr_t\n" +"la_symbind32(Elf32_Sym *sym, unsigned int ndx, uintptr_t *refcook,\n" +" uintptr_t *defcook, unsigned int *flags, const char *symname)\n" +"{\n" +" printf(\"la_symbind32(): symname = %s; sym-Est_value = %p\\en\",\n" +" symname, sym-Est_value);\n" +" printf(\" ndx = %u; flags = %#x\", ndx, *flags);\n" +" printf(\"; refcook = %p; defcook = %p\\en\", refcook, defcook);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" return sym-Est_value;\n" +"}\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"uintptr_t\n" +"la_symbind64(Elf64_Sym *sym, unsigned int ndx, uintptr_t *refcook,\n" +" uintptr_t *defcook, unsigned int *flags, const char *symname)\n" +"{\n" +" printf(\"la_symbind64(): symname = %s; sym-Est_value = %p\\en\",\n" +" symname, sym-Est_value);\n" +" printf(\" ndx = %u; flags = %#x\", ndx, *flags);\n" +" printf(\"; refcook = %p; defcook = %p\\en\", refcook, defcook);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"Elf32_Addr\n" +"la_i86_gnu_pltenter(Elf32_Sym *sym, unsigned int ndx,\n" +" uintptr_t *refcook, uintptr_t *defcook, La_i86_regs *regs,\n" +" unsigned int *flags, const char *symname, long *framesizep)\n" +"{\n" +" printf(\"la_i86_gnu_pltenter(): %s (%p)\\en\", symname, sym-Est_value);\n" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-05-03" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" -- cgit v1.2.3