usr/src/cmd/sgs/link_audit/man/symbindrep.man

   1 .\" Copyright (c) 1996, 2010, Oracle and/or its affiliates. All rights reserved.
   2 .\"
   3 .\" CDDL HEADER START
   4 .\"
   5 .\" The contents of this file are subject to the terms of the
   6 .\" Common Development and Distribution License (the "License").
   7 .\" You may not use this file except in compliance with the License.
   8 .\"
   9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10 .\" or http://www.opensolaris.org/os/licensing.
  11 .\" See the License for the specific language governing permissions
  12 .\" and limitations under the License.
  13 .\"
  14 .\" When distributing Covered Code, include this CDDL HEADER in each
  15 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16 .\" If applicable, add the following below this CDDL HEADER, with the
  17 .\" fields enclosed by brackets "[]" replaced with your own identifying
  18 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  19 .\"
  20 .\" CDDL HEADER END
  21 .\"
  22 .if n .tr \--
  23 .TH symbindrep 1 "18 Nov 1996"
  24 .SH NAME
  25 symbindrep \- report on all symbol bindings required to load this object
  26 .SH SYNOPSIS
  27 .B symbindrep
  28 [
  29 .B -f
  30 .I bindfromlist
  31 ] [
  32 .B -t
  33 .I bindtolist
  34 ] [
  35 .B -l
  36 .I symbindreplib
  37 ]
  38 .I funcname
  39 executable
  40 .SH AVAILABILITY
  41 .LP
  42 SUNWosdem
  43 .SH DESCRIPTION
  44 .B symbindrep
  45 is a simple example of a
  46 .I Link-Auditing
  47 library which reports on the symbol bindings performed by
  48 the run-time linker (ld.so.1) when loading an object.
  49 .B symbindrep
  50 will display all of the symbol bindings that occur
  51 between the executable and all of it's dependencies.  After all symbol
  52 bindings have been performed
  53 .B symbindrep
  54 will terminate.  No code from the executable is ever executed.
  55 .SH OPTIONS
  56 .TP 10
  57 .BI \-f " bindfromlist"
  58 A colon separated list of libraries that are to be traced.  Only symbol
  59 bindings from these libraries will be traced.  The default is
  60 to report on all symbol bindings.
  61 .BI \-t " bindtolib"
  62 A colon separated list of libraries that are to be traced.  Only symbol
  63 bindings to these libraries will be reported.  The default is to trace
  64 all libraries.
  65 .BI \-l " symbindrep"
  66 specify an alternate symbindrep.so
  67 .I Link-Auditing
  68 library to use.
  69 .SH EXAMPLES
  70 This example reports on only the symbol bindings between nm and
  71 libelf.so.1.
  72 .LP
  73 .nf
  74 .ft 3
  75 % symbindrep -t /usr/lib/libelf.so.1 -f nm nm
  76                     Symbol Bindings
  77
  78 Referencing          Defining
  79 Object               Object               Symbol
  80 ------------------------------------------------------------------
  81 nm                   /usr/lib/libelf.so.1 elf_version
  82 nm                   /usr/lib/libelf.so.1 elf_begin
  83 nm                   /usr/lib/libelf.so.1 elf_errmsg
  84 nm                   /usr/lib/libelf.so.1 elf_kind
  85 nm                   /usr/lib/libelf.so.1 elf_end
  86 nm                   /usr/lib/libelf.so.1 elf32_getehdr
  87 nm                   /usr/lib/libelf.so.1 elf_getscn
  88 nm                   /usr/lib/libelf.so.1 elf32_getshdr
  89 nm                   /usr/lib/libelf.so.1 elf_getdata
  90 nm                   /usr/lib/libelf.so.1 elf_nextscn
  91 nm                   /usr/lib/libelf.so.1 elf_getarhdr
  92 nm                   /usr/lib/libelf.so.1 elf_next
  93 nm                   /usr/lib/libelf.so.1 elf_strptr
  94 .ft
  95 .fi
  96 .SH SEE ALSO
  97 .BR ld.so.1 (1)
  98 .br
  99 .TZ LLM