mirror of https://github.com/mkerrisk/man-pages
elf.5: srcfix: remove commented-out mandoc markuo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
493e0eb3c2
commit
db337e545c
49
man5/elf.5
49
man5/elf.5
|
@ -161,7 +161,6 @@ typedef struct {
|
|||
.in
|
||||
.PP
|
||||
The fields have the following meanings:
|
||||
.\" .Bl -tag -width "e_phentsize"
|
||||
.\"
|
||||
.nr l1_indent 10
|
||||
.\"
|
||||
|
@ -176,7 +175,6 @@ and may contain values which start with the prefix
|
|||
.BR ELF .
|
||||
The following macros are defined:
|
||||
.RS
|
||||
.\" .Bl -tag -width "EI_VERSION" \" EI_ABIVERSION
|
||||
.TP 9
|
||||
.BR EI_MAG0
|
||||
The first byte of the magic number.
|
||||
|
@ -205,7 +203,6 @@ It must be filled with
|
|||
.BR EI_CLASS
|
||||
The fifth byte identifies the architecture for this binary:
|
||||
.RS
|
||||
.\" .Bl -tag -width "ELFCLASSNONE" -compact
|
||||
.TP 14
|
||||
.PD 0
|
||||
.BR ELFCLASSNONE
|
||||
|
@ -220,13 +217,11 @@ and virtual address spaces up to 4 Gigabytes.
|
|||
This defines the 64-bit architecture.
|
||||
.PD
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.BR EI_DATA
|
||||
The sixth byte specifies the data encoding of the processor-specific
|
||||
data in the file.
|
||||
Currently, these encodings are supported:
|
||||
.\" .Bl -tag -width "ELFDATA2LSB" -compact
|
||||
.RS 9
|
||||
.TP 14
|
||||
.PD 0
|
||||
|
@ -240,12 +235,10 @@ Two's complement, little-endian.
|
|||
Two's complement, big-endian.
|
||||
.PD
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.PD 0
|
||||
.BR EI_VERSION
|
||||
The seventh byte is the version number of the ELF specification:
|
||||
.\" .Bl -tag -width "EV_CURRENT" -compact
|
||||
|
||||
.RS
|
||||
.TP 14
|
||||
|
@ -265,7 +258,6 @@ Some fields in other ELF structures have flags
|
|||
and values that have platform-specific meanings;
|
||||
the interpretation of those fields is determined by the value of this byte.
|
||||
For example:
|
||||
.\" .Bl -tag -width "ELFOSABI_STANDALONE" -compact
|
||||
.RS
|
||||
.TP 21
|
||||
.PD 0
|
||||
|
@ -331,7 +323,6 @@ ARM architecture ABI
|
|||
.BR ELFOSABI_STANDALONE
|
||||
Stand-alone (embedded) ABI
|
||||
.\" 255
|
||||
.\" .El
|
||||
.PD
|
||||
.RE
|
||||
.TP
|
||||
|
@ -365,13 +356,11 @@ the future if currently unused bytes are given meanings.
|
|||
The size of the
|
||||
.I e_ident
|
||||
array.
|
||||
.\" .El
|
||||
.RE
|
||||
.TP
|
||||
.IR e_type
|
||||
This member of the structure identifies the object file type:
|
||||
.RS
|
||||
.\" .Bl -tag -width "ET_NONE" -compact
|
||||
.TP 16
|
||||
.PD 0
|
||||
.BR ET_NONE
|
||||
|
@ -390,13 +379,11 @@ A shared object.
|
|||
A core file.
|
||||
.PD
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.IR e_machine
|
||||
This member specifies the required architecture for an individual file.
|
||||
For example:
|
||||
.RS \n[l1_indent]
|
||||
.\" .Bl -tag -width "EM_MIPS_RS4_BE" -compact
|
||||
.TP 16
|
||||
.PD 0
|
||||
.BR EM_NONE
|
||||
|
@ -496,11 +483,9 @@ DEC Vax
|
|||
.\" Compaq [DEC] Alpha with enhanced instruction set
|
||||
.PD
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.IR e_version
|
||||
This member identifies the file version:
|
||||
.\" .Bl -tag -width "EV_CURRENT" -compact
|
||||
.RS
|
||||
.TP 16
|
||||
.PD 0
|
||||
|
@ -509,7 +494,6 @@ Invalid version
|
|||
.TP
|
||||
.BR EV_CURRENT
|
||||
Current version
|
||||
.\" .El
|
||||
.PD
|
||||
.RE
|
||||
.TP
|
||||
|
@ -566,7 +550,6 @@ member of the initial entry in section header table.
|
|||
Otherwise, the
|
||||
.IR sh_info
|
||||
member of the initial entry contains the value zero.
|
||||
.\" .Bl -tag -width "PN_XNUM"
|
||||
.RS \n[l1_indent]
|
||||
.TP 9
|
||||
.BR PN_XNUM
|
||||
|
@ -575,7 +558,6 @@ This is defined as 0xffff, the largest number
|
|||
can have, specifying where the actual number of program headers is assigned.
|
||||
.PD
|
||||
.RE
|
||||
.\" .El
|
||||
.IP
|
||||
.TP
|
||||
.IR e_shentsize
|
||||
|
@ -626,8 +608,6 @@ member of the initial entry in section header table.
|
|||
Otherwise, the
|
||||
.IR sh_link
|
||||
member of the initial entry in section header table contains the value zero.
|
||||
.\" .El
|
||||
.\" .El
|
||||
.PP
|
||||
An executable or shared object file's program header table is an array of
|
||||
structures, each describing a segment or other information the system needs
|
||||
|
@ -682,12 +662,10 @@ The main difference between the 32-bit and the 64-bit program header lies
|
|||
in the location of the
|
||||
.IR p_flags
|
||||
member in the total struct.
|
||||
.\" .Bl -tag -width "p_offset"
|
||||
.TP 10
|
||||
.IR p_type
|
||||
This member of the structure indicates what kind of segment this array
|
||||
element describes or how to interpret the array element's information.
|
||||
.\" .Bl -tag -width "PT_DYNAMIC"
|
||||
.RS 10
|
||||
.TP 12
|
||||
.BR PT_NULL
|
||||
|
@ -753,7 +731,6 @@ GNU extension which is used by the Linux kernel to control the state of the
|
|||
stack via the flags set in the
|
||||
.IR p_flags
|
||||
member.
|
||||
.\" .El
|
||||
.RE
|
||||
.TP
|
||||
.IR p_offset
|
||||
|
@ -782,7 +759,6 @@ It may be zero.
|
|||
.TP
|
||||
.IR p_flags
|
||||
This member holds a bit mask of flags relevant to the segment:
|
||||
.\" .Bl -tag -width "PF_X" -compact
|
||||
.RS \n[l1_indent]
|
||||
.TP
|
||||
.PD 0
|
||||
|
@ -796,7 +772,6 @@ A writable segment.
|
|||
A readable segment.
|
||||
.PD
|
||||
.RE
|
||||
.\" .El
|
||||
.IP
|
||||
A text segment commonly has the flags
|
||||
.BR PF_X
|
||||
|
@ -825,7 +800,6 @@ should equal
|
|||
.IR p_offset ,
|
||||
modulo
|
||||
.IR p_align .
|
||||
.\" .El
|
||||
.PP
|
||||
A file's section header table lets one locate all the file's sections.
|
||||
The
|
||||
|
@ -893,7 +867,6 @@ and
|
|||
inclusive.
|
||||
The section header table does not contain entries for the
|
||||
reserved indices.
|
||||
.\" .El
|
||||
.PP
|
||||
The section header has the following structure:
|
||||
.in +4n
|
||||
|
@ -932,7 +905,6 @@ typedef struct {
|
|||
.in
|
||||
.PP
|
||||
No real differences exist between the 32-bit and 64-bit section headers.
|
||||
.\" .Bl -tag -width "sh_addralign"
|
||||
.TP \n[l1_indent]
|
||||
.IR sh_name
|
||||
This member specifies the name of the section.
|
||||
|
@ -942,7 +914,6 @@ a null-terminated string.
|
|||
.TP
|
||||
.IR sh_type
|
||||
This member categorizes the section's contents and semantics.
|
||||
.\" .Bl -tag -width "SHT_PROGBITS"
|
||||
.RS \n[l1_indent]
|
||||
.TP 15
|
||||
.BR SHT_NULL
|
||||
|
@ -1041,7 +1012,6 @@ and
|
|||
.BR SHT_HIUSER
|
||||
may be used by the application, without conflicting with current or future
|
||||
system-defined section types.
|
||||
.\" .El
|
||||
.RE
|
||||
.TP
|
||||
.IR sh_flags
|
||||
|
@ -1055,7 +1025,6 @@ Otherwise, the attribute is
|
|||
"off"
|
||||
or does not apply.
|
||||
Undefined attributes are set to zero.
|
||||
.\" .Bl -tag -width "SHF_EXECINSTR" -compact
|
||||
.RS \n[l1_indent]
|
||||
.TP 15
|
||||
.BR SHF_WRITE
|
||||
|
@ -1076,7 +1045,6 @@ This section contains executable machine instructions.
|
|||
All bits included in this mask are reserved for processor-specific
|
||||
semantics.
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.IR sh_addr
|
||||
If this section appears in the memory image of a process, this member
|
||||
|
@ -1130,10 +1098,8 @@ Some sections hold a table of fixed-sized entries, such as a symbol table.
|
|||
For such a section, this member gives the size in bytes for each entry.
|
||||
This member contains zero if the section does not hold a table of
|
||||
fixed-size entries.
|
||||
.\" .El
|
||||
.PP
|
||||
Various sections hold program and control information:
|
||||
.\" .Bl -tag -width ".shstrtab"
|
||||
.TP \n[l1_indent]
|
||||
.IR .bss
|
||||
This section holds uninitialized data that contributes to the program's
|
||||
|
@ -1432,7 +1398,6 @@ The attributes used are
|
|||
.BR SHF_ALLOC
|
||||
and
|
||||
.BR SHF_EXECINSTR .
|
||||
.\" .El
|
||||
.PP
|
||||
String table sections hold null-terminated character sequences, commonly
|
||||
called strings.
|
||||
|
@ -1478,7 +1443,6 @@ typedef struct {
|
|||
.PP
|
||||
The 32-bit and 64-bit versions have the same members, just in a different
|
||||
order.
|
||||
.\" .Bl -tag -width "st_value"
|
||||
.TP \n[l1_indent]
|
||||
.IR st_name
|
||||
This member holds an index into the object file's symbol string table,
|
||||
|
@ -1498,7 +1462,6 @@ has no size or an unknown size.
|
|||
.TP
|
||||
.IR st_info
|
||||
This member specifies the symbol's type and binding attributes:
|
||||
.\" .Bl -tag -width "STT_SECTION"
|
||||
.RS \n[l1_indent]
|
||||
.TP 12
|
||||
.BR STT_NOTYPE
|
||||
|
@ -1532,8 +1495,6 @@ symbols of the file, if it is present.
|
|||
Values in the inclusive range
|
||||
.RB [ STT_LOPROC ", " STT_HIPROC ]
|
||||
are reserved for processor-specific semantics.
|
||||
.\" .El
|
||||
.\" .Bl -tag -width "STB_GLOBAL"
|
||||
.TP
|
||||
.BR STB_LOCAL
|
||||
Local symbols are not visible outside the object file containing their
|
||||
|
@ -1576,11 +1537,9 @@ Convert a binding and a type into an
|
|||
.I st_info
|
||||
value.
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.IR st_other
|
||||
This member defines the symbol visibility.
|
||||
.\" .Bl -tag -width "STV_PROTECTED"
|
||||
.RS \n[l1_indent]
|
||||
.TP 16
|
||||
.PD 0
|
||||
|
@ -1603,7 +1562,6 @@ There are macros for extracting the visibility type:
|
|||
or
|
||||
.BR ELF64_ST_VISIBILITY (other)
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.IR st_shndx
|
||||
Every symbol table entry is
|
||||
|
@ -1611,7 +1569,6 @@ Every symbol table entry is
|
|||
in relation to some section.
|
||||
This member holds the relevant section
|
||||
header table index.
|
||||
.\" .El
|
||||
.PP
|
||||
Relocation is the process of connecting symbolic references with
|
||||
symbolic definitions.
|
||||
|
@ -1662,7 +1619,6 @@ typedef struct {
|
|||
} Elf64_Rela;
|
||||
.fi
|
||||
.in
|
||||
.\" .Bl -tag -width "r_offset"
|
||||
.TP \n[l1_indent]
|
||||
.IR r_offset
|
||||
This member gives the location at which to apply the relocation action.
|
||||
|
@ -1690,7 +1646,6 @@ member.
|
|||
.IR r_addend
|
||||
This member specifies a constant addend used to compute the value to be
|
||||
stored into the relocatable field.
|
||||
.\" .El
|
||||
.PP
|
||||
The
|
||||
.I .dynamic
|
||||
|
@ -1727,11 +1682,9 @@ typedef struct {
|
|||
extern Elf64_Dyn _DYNAMIC[];
|
||||
.fi
|
||||
.in
|
||||
.\" .Bl -tag -width "d_tag"
|
||||
.TP \n[l1_indent]
|
||||
.IR d_tag
|
||||
This member may have any of the following values:
|
||||
.\" .Bl -tag -width "DT_SYMBOLIC"
|
||||
.RS \n[l1_indent]
|
||||
.TP 12
|
||||
.BR DT_NULL
|
||||
|
@ -1819,7 +1772,6 @@ Values in the inclusive range
|
|||
.RB [ DT_LOPROC ", " DT_HIPROC ]
|
||||
are reserved for processor-specific semantics
|
||||
.RE
|
||||
.\" .El
|
||||
.TP
|
||||
.IR d_val
|
||||
This member represents integer values with various interpretations.
|
||||
|
@ -1837,7 +1789,6 @@ Array containing all the dynamic structures in the
|
|||
.I .dynamic
|
||||
section.
|
||||
This is automatically populated by the linker.
|
||||
.\" .El
|
||||
.SH NOTES
|
||||
.\" OpenBSD
|
||||
.\" ELF support first appeared in
|
||||
|
|
Loading…
Reference in New Issue