summaryrefslogtreecommitdiffstats
path: root/man/de/deb-symbols.pod
blob: 2242ddb206c18219dfd5ec9255f3da2b6b2f5f60 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 BEZEICHNUNG

deb-symbols - Debians erweiterte Informationsdatei von Laufzeitbibliotheken

=head1 ÜBERSICHT

B<DEBIAN/symbols>

=head1 BESCHREIBUNG

Die Symboldateien werden in Debian-Binärpaketen ausgeliefert. Deren Format
ist eine Teilmenge der Vorlagensymboldateien, die von B<dpkg-gensymbols>(1)
in Debian-Quellpaketen verwandt wird.

Das Format eines Eintrags für eine erweiterte Abhängigkeitsinformation einer
Laufzeitbibliothek („shared library“) lautet:

Z<>
 I<Bibliothek-Soname Hauptabhängigkeitsvorlage>
 [| I<alternative-Abhängigkeitsvorlage>]
 [...]
 [* I<Feldname>: I<Feldwert>]
 [...]
  I<Symbol> I<minimale_Version> [I<Kennung_der_Abhängigkeitsvorlage>]

Der I<Bibliotheks-Soname> ist genau der Wert des SONAME-Feldes, wie er von
B<objdump>(1) exportiert wird. Eine I<Abhängigkeitsvorlage> ist eine
Abhängigkeit, in der I<#MINVER#> dynamisch entweder von einer
Versionsprüfung der Art „(E<gt>= I<Minimalversion>)“ oder durch nichts
ersetzt wird, falls eine nicht-versionierte Abhängigkeit als ausreichend
erachtet wird.

Jedem exportierten I<Symbol> (aufgeführt als I<Name>@I<Version>, mit
I<Version> als „Base“, falls die Bibliothek nicht versioniert ist) wird eine
I<Minimalversion> seiner Abhängigkeitsvorlage zugeordnet (die
Hauptabhängigkeitsvorlage wird immer verwandt und wird am Ende mit der
abhängigen, in I<Kennung_der_Abhängigkeitsvorlage> referenzierten Vorlage
(falls vorhanden) kombiniert). Die erste alternative Abhängigkeitsvorlage
wird mit 1 nummeriert, die zweite mit 2 usw. Jede Spalte ist genau durch ein
Leerraum abgetrennt.

Jeder Eintrag für eine Bibliothek kann auch einige Felder mit
Metainformationen enthalten. Diese Felder werden in Zeilen gespeichert, die
mit einem Stern beginnen. Derzeit sind die einzig gültigen Felder:

=over 

=item B<Build-Depends-Package>

Es gibt den Namen des „-dev“-Pakets an, das der Bibliothek zugeordnet ist,
und wird von B<dpkg-shlibdeps> verwandt, um sicherzustellen, dass die
erstellte Abhängigkeit mindestens genauso strikt ist wie die zugehörige
Bau-Abhängigkeit (seit Dpkg 1.14.13).

=item B<Build-Depends-Packages>

Identisch zu B<Build-Depends-Package>, akzeptiert aber eine
Kommata-getrennte Liste an Paketnamen (seit Dpkg 1.20.0). Dieses Feld setzt
jedes vorhandende Feld B<Build-Depends-Package> außer Kraft und ist mit
„-dev“-Paketen und davon abhängigen Metapaketen, beispielsweise für eine
Übergangsperiode, am nützlichsten.

=item B<Allow-Internal-Symbol-Groups>

Es gibt in einer durch Leerraumzeichen getrennten Liste an, welche internen
Gruppen ignoriert werden sollten, so dass Symbole, die in diesen Gruppen
enthalten sind, in die Ausgabedatei aufgenommen werden (seit Dpkg
1.20.1). Dies sollte nur für Toolchain-Pakete notwendig sein, die solche
internen Symbole bereitstellen. Die verfügbaren Gruppen sind systemabhängig,
für ELF- und GNU-basierte Systeme sind dies B<aeabi> und B<gomp>.

=item B<Ignore-Blacklist-Groups>

Ein veralteter Alias für B<Allow-Internal-Symbol-Groups> (seit Dpkg 1.20.1,
unterstützt seit Dpkg 1.17.6).

=back

=head1 BEISPIELE

=head2 Einfache Symboldatei

 libftp.so.3 libftp3 #MINVER#
  DefaultNetbuf@Base 3.1-1-6
  FtpAccess@Base 3.1-1-6
  […]

=head2 Fortgeschrittene Symboldatei

 libGL.so.1 libgl1
 | libgl1-mesa-glx #MINVER#
 * Build-Depends-Package: libgl1-mesa-dev
  publicGlSymbol@Base 6.3-1
  […]
  implementationSpecificSymbol@Base 6.5.2-7 1
  […]

=head1 SIEHE AUCH

L<https://wiki.debian.org/Projects/ImprovedDpkgShlibdeps>,
B<dpkg-shlibdeps>(1), B<dpkg-gensymbols>(1).


=head1 ÜBERSETZUNG

Die deutsche Übersetzung wurde 2004, 2006-2020 von Helge Kreutzmann
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2008 von Sven Joachim <svenjoac@gmx.de>
angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
Es gibt KEINE HAFTUNG.