Module Name: src Committed By: uwe Date: Mon Jan 13 15:54:48 UTC 2020
Modified Files: src/share/man/man3: dlfcn.3 Log Message: Minor tweaks. Use same -indent for lists of values that are OR'ed as one argument. Use consistent markup for dli_* member names. Untabify Dl_info definition so that it lines up in PS output. To generate a diff of this commit: cvs rdiff -u -r1.36 -r1.37 src/share/man/man3/dlfcn.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/share/man/man3/dlfcn.3 diff -u src/share/man/man3/dlfcn.3:1.36 src/share/man/man3/dlfcn.3:1.37 --- src/share/man/man3/dlfcn.3:1.36 Mon Jan 13 11:44:02 2020 +++ src/share/man/man3/dlfcn.3 Mon Jan 13 15:54:48 2020 @@ -1,4 +1,4 @@ -.\" $NetBSD: dlfcn.3,v 1.36 2020/01/13 11:44:02 wiz Exp $ +.\" $NetBSD: dlfcn.3,v 1.37 2020/01/13 15:54:48 uwe Exp $ .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -104,7 +104,7 @@ The .Fa mode parameter specifies symbol resolution time and symbol visibility. One of the following values may be used to specify symbol resolution time: -.Bl -tag -width "RTLD_GLOBALXX" -offset indent +.Bl -tag -width "Dv RTLD_NODELETE" -offset indent .It Dv RTLD_NOW Symbols are resolved immediately. .It Dv RTLD_LAZY @@ -113,7 +113,7 @@ This is the default value if resolution .El .Pp One of the following values may be used to specify symbol visibility: -.Bl -tag -width "RTLD_GLOBALXX" -offset indent +.Bl -tag -width "Dv RTLD_NODELETE" -offset indent .It Dv RTLD_GLOBAL The object's symbols and the symbols of its dependencies will be visible to other objects. @@ -135,12 +135,12 @@ then it is promoted to Additionally, one of the following flags may be ORed into the .Fa mode argument: -.Bl -tag -width "RTLD_NODELETEXX" -offset indent +.Bl -tag -width "Dv RTLD_NODELETE" -offset indent .It Dv RTLD_NODELETE Prevents unload of the loaded object on .Fn dlclose . The same behaviour may be requested by -.Fl "z nodelete" +.Fl z Cm nodelete option of the static linker .Xr ld 1 . .It Dv RTLD_NOLOAD @@ -256,10 +256,10 @@ as mapped in the process address space \ the value passed in the first argument .Fa addr . The symbols of a shared object are only eligible if -.Va addr +.Fa addr is between the base address of the shared object and the value of the symbol -.Dq _end +.Va _end in the same shared object. If no object for which this condition holds true can be found, @@ -272,23 +272,23 @@ and the shared object it is contained in The .Fa dli argument points at a caller-provided -.Va Dl_info +.Vt Dl_info structure defined as follows: .Bd -literal -offset indent typedef struct { - const char *dli_fname; /* File defining the symbol */ - void *dli_fbase; /* Base address */ - const char *dli_sname; /* Symbol name */ - const void *dli_saddr; /* Symbol address */ + const char *dli_fname; /* File defining the symbol */ + void *dli_fbase; /* Base address */ + const char *dli_sname; /* Symbol name */ + const void *dli_saddr; /* Symbol address */ } Dl_info; .Ed .Pp The structure members are further described as follows: -.Bl -tag -width "dli_fnameXX" -.It Li "dli_fname" +.Bl -tag -width "Va" +.It Va dli_fname The pathname of the shared object containing the address .Fa addr . -.It Li "dli_fbase" +.It Va dli_fbase The base address at which this shared object is loaded in the process address space. This may be zero if the symbol was found in the internally generated @@ -299,9 +299,9 @@ see .Xr link 5 .Pc which is not associated with a file. -.It Li "dli_sname" +.It Va dli_sname points at the nul-terminated name of the selected symbol -.It Li "dli_saddr" +.It Va dli_saddr is the actual address .Pq as it appears in the process address space of the symbol.