xref: /illumos-gate/usr/src/cmd/sgs/link_audit/man/symbindrep.man (revision d2a70789f056fc6c9ce3ab047b52126d80b0e3da)
Copyright (c) 1996, 2010, Oracle and/or its affiliates. All rights reserved.

CDDL HEADER START

The contents of this file are subject to the terms of the
Common Development and Distribution License (the "License").
You may not use this file except in compliance with the License.

You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.

When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at usr/src/OPENSOLARIS.LICENSE.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]

CDDL HEADER END

symbindrep 1 "18 Nov 1996"
NAME
symbindrep - report on all symbol bindings required to load this object
SYNOPSIS
symbindrep [ -f bindfromlist ] [ -t bindtolist ] [ -l symbindreplib ] funcname executable
AVAILABILITY

SUNWosdem

DESCRIPTION
symbindrep is a simple example of a Link-Auditing library which reports on the symbol bindings performed by the run-time linker (ld.so.1) when loading an object. symbindrep will display all of the symbol bindings that occur between the executable and all of it's dependencies. After all symbol bindings have been performed symbindrep will terminate. No code from the executable is ever executed.
OPTIONS

10 -f " bindfromlist" A colon separated list of libraries that are to be traced. Only symbol bindings from these libraries will be traced. The default is to report on all symbol bindings. -t " bindtolib" A colon separated list of libraries that are to be traced. Only symbol bindings to these libraries will be reported. The default is to trace all libraries. -l " symbindrep" specify an alternate symbindrep.so Link-Auditing library to use.

EXAMPLES
This example reports on only the symbol bindings between nm and libelf.so.1.

% symbindrep -t /usr/lib/libelf.so.1 -f nm nm
 Symbol Bindings

Referencing Defining
Object Object Symbol
------------------------------------------------------------------
nm /usr/lib/libelf.so.1 elf_version
nm /usr/lib/libelf.so.1 elf_begin
nm /usr/lib/libelf.so.1 elf_errmsg
nm /usr/lib/libelf.so.1 elf_kind
nm /usr/lib/libelf.so.1 elf_end
nm /usr/lib/libelf.so.1 elf32_getehdr
nm /usr/lib/libelf.so.1 elf_getscn
nm /usr/lib/libelf.so.1 elf32_getshdr
nm /usr/lib/libelf.so.1 elf_getdata
nm /usr/lib/libelf.so.1 elf_nextscn
nm /usr/lib/libelf.so.1 elf_getarhdr
nm /usr/lib/libelf.so.1 elf_next
nm /usr/lib/libelf.so.1 elf_strptr
SEE ALSO
ld.so.1 (1)

.TZ LLM