|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands pvs(1)
NAME
pvs - display the internal version information of dynamic
objects
SYNOPSIS
pvs [-Cdlnorsv] [-N name] file...
DESCRIPTION
The pvs utility displays any internal version information
contained within an ELF file. Commonly, these files are
dynamic executables and shared objects, and possibly relo-
catable objects. This version information can fall into one
of two categories:
o version definitions
o version dependencies
Version definitions describe the interfaces that are made
available by an ELF file. Each version definition is associ-
ated to a set of global symbols provided by the file. Ver-
sion definitions can be assigned to a file during its crea-
tion by the link-editor using the -M option and the associ-
ated mapfile directives. See the Linker and Libraries Guide
for more details.
Version dependencies describe the binding requirements of
dynamic objects on the version definitions of any shared
object dependencies. When a dynamic object is built with a
shared object, the link-editor records information within
the dynamic object indicating that the shared object is a
dependency. This dependency must be satisfied at runtime.
If the shared object also contains version definitions, then
those version definitions that satisfy the global symbol
requirements of the dynamic object are also recorded in the
dynamic object being created. At process initialization,
the runtime linker uses any version dependencies as a means
of validating the interface requirements of the dynamic
objects used to construct the process.
OPTIONS
The following options are supported. If neither the -d or -r
options are specified, both are enabled.
-C Demangles C++ symbol names.
-d Prints version definition information.
SunOS 5.10 Last change: 14 Apr 2004 1
User Commands pvs(1)
-l When used with the -s option, prints any symbols
that have been reduced from global to local binding
due to versioning. By convention, these symbol
entries are located in the .symtab section, and
fall between the FILE symbol representing the out-
put file, and the FILE symbol representing the
first input file used to generate the output file.
These reduced symbol entries are assigned the
fabricated version definition _REDUCED_. No reduced
symbols will be printed if the file has been
stripped (see strip(1)), or if the symbol entry
convention cannot be determined.
-n Normalizes version definition information. By
default, all version definitions within the object
are displayed. However, version definitions can
inherit other version definitions. Under normaliza-
tion, only the head of each inheritance list is
displayed.
-N name When used with the -d option, -N prints only the
information for the given version definition name
and any of its inherited version definitions. When
used with the -r option, -N prints only the infor-
mation for the given dependency file name.
-o Creates one-line version definition output. By
default, file, version definitions, and any symbol
output is indented to ease human inspection. This
option prefixes each output line with the file and
version definition name and can be more useful for
analysis with automated tools.
-r Prints version dependency (requirements) informa-
tion.
-s Prints the symbols associated with each version
definition. Any data symbols are accompanied with
the size, in bytes, of the data item.
SunOS 5.10 Last change: 14 Apr 2004 2
User Commands pvs(1)
-v Verbose output. Indicates any weak version defini-
tions, and any version definition inheritance. When
used with the -N and -d options, the inheritance of
the base version definition is also shown. When
used with the -s option, the version symbol defini-
tion is also shown.
OPERANDS
The following operands are supported.
file The ELF file about which internal version informa-
tion is displayed.
EXAMPLES
Example 1: Displaying version definitions
The following example displays the version definitions of
libelf.so.1:
% pvs -d /lib/libelf.so.1
libelf.so.1;
SUNW_1.1
Example 2: Creating a one-liner display
A normalized, one-liner display, suitable for creating a
mapfile version control directive, can be created using the
-n and -o options:
% pvs -don /lib/libelf.so.1
/lib/libelf.so.1 - SUNW_1.1;
Example 3: Displaying version requirements
The following example displays the version requirements of
ldd and pvs:
% pvs -r /usr/bin/ldd /usr/bin/pvs
/usr/bin/ldd:
libelf.so.1 (SUNW_1.1);
libc.so.1 (SUNW_1.1);
/usr/bin/pvs:
libelf.so.1 (SUNW_1.1);
libc.so.1 (SUNW_1.1);
EXIT STATUS
If the requested version information is not found, a non-
zero value is returned. Otherwise, a 0 value is returned.
SunOS 5.10 Last change: 14 Apr 2004 3
User Commands pvs(1)
Version information is determined not found when any of the
following is true:
o the -d option is specified and no version definitions
are found.
o the -r option is specified and no version requirements
are found.
o neither the -d nor -r option is specified and no ver-
sion definitions or version requirements are found.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWtoo |
|_____________________________|_____________________________|
SEE ALSO
ld(1), ldd(1), strip(1), elf(3ELF), attributes(5)
Linker and Libraries Guide
SunOS 5.10 Last change: 14 Apr 2004 4
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:25:18 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (4704 hits)
(openSUSE 10.2)
adv_cap_autoneg man page (4614 hits)
(Solaris 10 11_06)
CPAN man page (4352 hits)
(Suse Linux 10.1)
ssh man page (4194 hits)
(Suse Linux 10.1)
svn man page (3401 hits)
(FreeBSD 6.2)
startproc man page (1954 hits)
(Suse Linux 10.1)
pprosetup man page (1739 hits)
(Solaris 10 11_06)
netcat man page (1693 hits)
(Suse Linux 10.1)
signal man page (1670 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (1655 hits)
(Solaris 10 11_06)
|
Man Pages 
