/docs/MyDocs

To get this branch, use:
bzr branch http://darksoft.org/webbzr/docs/MyDocs

« back to all changes in this revision

Viewing changes to Development/packaging/general/linking/ld_assume_kernel.html

  • Committer: Suren A. Chilingaryan
  • Date: 2017-04-03 02:45:17 UTC
  • Revision ID: csa@suren.me-20170403024517-dwzj0z0k1cmhxm7u
Restructuring, OpenShift, Ansible, Git

Show diffs side-by-side

added added

removed removed

Lines of Context:
Development/packaging/general/linking/ld_assume_kernel.html
1
 
<?xml version="1.0" encoding="iso-8859-1"?>
2
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-transitional.dtd">
3
 
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 
  <head>
5
 
      <title>Explaining LD_ASSUME_KERNEL</title>
6
 
  </head>
7
 
 
8
 
  <body>
9
 
    <h1>Explaining <tt>LD_ASSUME_KERNEL</tt></h1>
10
 
 
11
 
    <p>Ulrich Drepper, 2004-5-12</p>
12
 
 
13
 
    <p>It is frightening how something as simple as the mechanism
14
 
    behind <tt>LD_ASSUME_KERNEL</tt> can create that much confusion.  So
15
 
    here are a few details which should enable everybody to
16
 
    investigate the issue closer by her/himself.</p>
17
 
 
18
 
    <ol>
19
 
      <li>
20
 
        <p>First, <tt>LD_ASSUME_KERNEL</tt> is handled by the dynamic
21
 
        linker.</p>
22
 
       </li>
23
 
 
24
 
       <li>
25
 
         <p>The behavior of a specific value of <tt>LD_ASSUME_KERNEL</tt>
26
 
         is <b>not</b> hardcoded in the dynamic linker.</p>
27
 
       </li>
28
 
 
29
 
       <li>
30
 
         <p>Every DSO (Dynamic Shared Object, aka shared library) can
31
 
         tell the dynamic linker in glibc which minimum OS ABI version
32
 
         is needed.  NB: dynamic linkers other than glibc's do not
33
 
         have this feature.  The information about the minimum OS ABI
34
 
         version is encoded in a ELF note section usually named
35
 
         <tt>.note.ABI-tag</tt>.  This note section must be referenced
36
 
         by a <tt>PT_NOTE</tt> entry in the DSO's program header.</p>
37
 
 
38
 
         <p>To examine the content of a DSO's note section use the
39
 
         <tt>readelf</tt> program from <tt>elfutils</tt> (the version
40
 
         from <tt>binutils</tt> is not capable enough).  On Red Hat
41
 
         system the binary is called <tt>eu-readelf</tt>.  Using it on
42
 
         a Fedora Core 2 system shows the following:</p>
43
 
 
44
 
         <pre>$ eu-readelf -n /lib/tls/libc-2.3.3.so
45
 
 
46
 
Note segment of 32 bytes at offset 0x174:
47
 
  Owner          Data size  Type
48
 
  GNU                   16  VERSION
49
 
    OS: Linux, ABI: 2.4.20
50
 
</pre>
51
 
 
52
 
         <p>This means the <tt>/lib/tls/libc-2.3.3.so</tt> DSO
53
 
         requires at least OS ABI version 2.4.20.</p>
54
 
       </li>
55
 
 
56
 
       <li>
57
 
         <p>The specific ABI version requirements on a RHL9, and
58
 
         Fedora Core 1 and 2 system are as follows (NB: this implies
59
 
         IA-32 is the architecture):</p>
60
 
 
61
 
         <ul>
62
 
           <li><p>DSOs in <tt>/lib/tls</tt> need ABI version 2.4.20.</p></li>
63
 
           <li><p>DSOs in <tt>/lib/i686</tt> need ABI version 2.4.1.</p></li>
64
 
           <li><p>DSOs in <tt>/lib</tt> need ABI version 2.2.5.</p></li>
65
 
         </ul>
66
 
 
67
 
         <p>This means no <tt>LD_ASSUME_KERNEL</tt> setting requesting
68
 
         versions earlier than 2.2.5 will work at all.  Versions from
69
 
         2.2.5 to 2.4.0 will use the DSOs in <tt>/lib</tt>, versions
70
 
         from 2.4.1 to 2.4.19 will use the DSOs in <tt>/lib/i686</tt>,
71
 
         versions 2.4.20 and younger will use the DSOs in
72
 
         <tt>/lib/tls</tt>.</p>
73
 
 
74
 
         <p>For the Red Hat releases this layout was chosen to provide
75
 
         the maximum amount of backward compatibility for
76
 
         <b>broken</b> applications (correctly written applications
77
 
         have no problems anyway).  The code in <tt>/lib</tt> consists
78
 
         of the very early LinuxThreads code which had fixed size
79
 
         threads which could not be placed by the application.  The
80
 
         version in <tt>/lib/i686</tt> is the LinuxThreads code which
81
 
         does away with this limitation (aka floating stacks).  The
82
 
         code in <tt>/lib/tls</tt> is the new NPTL POSIX thread
83
 
         library.</p>
84
 
 
85
 
       </li>
86
 
 
87
 
       <li>
88
 
         <p>The fact that a DSO has a more stringent version
89
 
         requirement does not mean it is automatically chosen.  The
90
 
         dynamic only rejects loading DSOs based on the version
91
 
         information, it does not look for the best fit.  The above
92
 
         description is true because the dynamic linker always looks
93
 
         in the directories <tt>/lib/tls</tt>, <tt>/lib/i686</tt>, and
94
 
         <tt>/lib</tt> in this order.  Why this is the case is
95
 
         complicated and not explained here.  Read the dynamic linker
96
 
         source code.</p>
97
 
       </li>
98
 
 
99
 
       <li>
100
 
        <p>For architectures other than IA-32 the situation is
101
 
        similar, but less complicated.  In RHEL3 only two versions of
102
 
        glibc are needed, one using LinuxThreads and one using NPTL.
103
 
        The very old LinuxThreads code is not needed.</p>
104
 
       </li>
105
 
     </ol>
106
 
  </body>
107
 
</html>