1 |
vapier 11/12/21 22:21:51 |
2 |
|
3 |
Modified: scanelf.docbook |
4 |
Log: |
5 |
document extended -k/-N/-s syntax |
6 |
|
7 |
Revision Changes Path |
8 |
1.13 pax-utils/man/scanelf.docbook |
9 |
|
10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo-projects/pax-utils/man/scanelf.docbook?rev=1.13&view=markup |
11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo-projects/pax-utils/man/scanelf.docbook?rev=1.13&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo-projects/pax-utils/man/scanelf.docbook?r1=1.12&r2=1.13 |
13 |
|
14 |
Index: scanelf.docbook |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo-projects/pax-utils/man/scanelf.docbook,v |
17 |
retrieving revision 1.12 |
18 |
retrieving revision 1.13 |
19 |
diff -u -r1.12 -r1.13 |
20 |
--- scanelf.docbook 14 Feb 2010 18:14:07 -0000 1.12 |
21 |
+++ scanelf.docbook 21 Dec 2011 22:21:51 -0000 1.13 |
22 |
@@ -92,7 +92,11 @@ |
23 |
</varlistentry> |
24 |
<varlistentry> |
25 |
<term><option>-k</option>, <option>--section</option> <replaceable>SECTION</replaceable></term> |
26 |
- <listitem><para>Find ELFs with the specified section</para></listitem> |
27 |
+ <listitem><para> |
28 |
+ Find ELFs with the specified section. May be specified multiple times to |
29 |
+ match multiple sections simultaneously. See |
30 |
+ <link><emphasis remap='B'>SECTION MATCHING</emphasis></link> for more info. |
31 |
+ </para></listitem> |
32 |
</varlistentry> |
33 |
<varlistentry> |
34 |
<term><option>-L</option>, <option>--ldcache</option></term> |
35 |
@@ -112,7 +116,11 @@ |
36 |
</varlistentry> |
37 |
<varlistentry> |
38 |
<term><option>-N</option>, <option>--lib</option> <replaceable>SONAME</replaceable></term> |
39 |
- <listitem><para>Find ELFs that need the specified SONAME</para></listitem> |
40 |
+ <listitem><para> |
41 |
+ Find ELFs that need the specified SONAME. May be specified multiple times |
42 |
+ to match multiple SONAMEs simultaneously. See |
43 |
+ <link><emphasis remap='B'>SONAME MATCHING</emphasis></link> for more info. |
44 |
+ </para></listitem> |
45 |
</varlistentry> |
46 |
<varlistentry> |
47 |
<term><option>-n</option>, <option>--needed</option></term> |
48 |
@@ -254,12 +262,51 @@ |
49 |
</para> |
50 |
</refsect1> |
51 |
|
52 |
-<refsect1 id='elf-etypes'> |
53 |
+<refsect1 id='symbol-matching'> |
54 |
<title>Symbol Matching</title> |
55 |
<para> |
56 |
- A <emphasis remap='B'>-</emphasis> prefix will only show undefined references |
57 |
- while a <emphasis remap='B'>+</emphasis> prefix will only show defined |
58 |
- references while no prefix will show both. |
59 |
+ The string specified takes the form <emphasis remap='B'>[%[modifiers]%][[+-]<symbol name>][,[.....]]</emphasis>. |
60 |
+ </para> |
61 |
+ <para> |
62 |
+ If the <option>symbol name</option> is empty, then all symbols are matched. |
63 |
+ </para> |
64 |
+ <para> |
65 |
+ If the <option>symbol name</option> is a glob ("<emphasis remap='B'>*</emphasis>"), |
66 |
+ then all symbols are dumped in a debug format. Do not rely on the structure |
67 |
+ of this output as it changes whenever we feel like it. |
68 |
+ </para> |
69 |
+ <para> |
70 |
+ If the first char of the symbol name is a plus ("<emphasis remap='B'>+</emphasis>"), |
71 |
+ then only match defined symbols. If it's a minus ("<emphasis remap='B'>-</emphasis>"), |
72 |
+ only match undefined symbols. When we say "defined", we mean the symbol is |
73 |
+ defined in the ELF vs having an external reference. |
74 |
+ </para> |
75 |
+ <para> |
76 |
+ Putting modifiers in between the percent signs ("<emphasis remap='B'>%</emphasis>") |
77 |
+ allows for more in depth filters. There are groups of modifiers. If you |
78 |
+ don't specify a member of a group, then all types in that group are matched. |
79 |
+ </para> |
80 |
+ <para> |
81 |
+ <itemizedlist> |
82 |
+ <listitem><para><emphasis remap='B'>STT group</emphasis> (symbol type)</para></listitem> |
83 |
+ <listitem><para><emphasis remap='B'>n</emphasis> - STT_NOTYPE</para></listitem> |
84 |
+ <listitem><para><emphasis remap='B'>o</emphasis> - STT_OBJECT</para></listitem> |
85 |
+ <listitem><para><emphasis remap='B'>f</emphasis> - STT_FUNC</para></listitem> |
86 |
+ <listitem><para><emphasis remap='B'>F</emphasis> - STT_FILE</para></listitem> |
87 |
+ <listitem><para><emphasis remap='B'>STB group</emphasis> (symbol binding/visibility)</para></listitem> |
88 |
+ <listitem><para><emphasis remap='B'>l</emphasis> - STB_LOCAL</para></listitem> |
89 |
+ <listitem><para><emphasis remap='B'>g</emphasis> - STB_GLOBAL</para></listitem> |
90 |
+ <listitem><para><emphasis remap='B'>w</emphasis> - STB_WEAK</para></listitem> |
91 |
+ <listitem><para><emphasis remap='B'>SHN group</emphasis> (section header)</para></listitem> |
92 |
+ <listitem><para><emphasis remap='B'>u</emphasis> - SHN_UNDEF</para></listitem> |
93 |
+ <listitem><para><emphasis remap='B'>a</emphasis> - SHN_ABS</para></listitem> |
94 |
+ <listitem><para><emphasis remap='B'>c</emphasis> - SHN_COMMON</para></listitem> |
95 |
+ </itemizedlist> |
96 |
+ </para> |
97 |
+ <para> |
98 |
+ You can search for multiple symbols simultaneously by using a comma ("<emphasis remap='B'>,</emphasis>") |
99 |
+ to separate different searches. Every symbol that matches will be displayed |
100 |
+ while unmatched symbols will not. |
101 |
</para> |
102 |
</refsect1> |
103 |
|
104 |
@@ -299,6 +346,22 @@ |
105 |
</para> |
106 |
</refsect1> |
107 |
|
108 |
+<refsect1 id='section-matching'> |
109 |
+ <title>Section Matching</title> |
110 |
+ <para> |
111 |
+ A <emphasis remap='B'>!</emphasis> prefix will only show ELF's that do not |
112 |
+ have the specified section. |
113 |
+ </para> |
114 |
+</refsect1> |
115 |
+ |
116 |
+<refsect1 id='needed-matching'> |
117 |
+ <title>Needed SONAME Matching</title> |
118 |
+ <para> |
119 |
+ A <emphasis remap='B'>!</emphasis> prefix will only show ELF's that do not |
120 |
+ depend on the specified library. |
121 |
+ </para> |
122 |
+</refsect1> |
123 |
+ |
124 |
&reftail; |
125 |
|
126 |
</refentry> |