elf.5: srcfix: remove commented-out mandoc markuo

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-03-09 19:17:49 +01:00
parent 493e0eb3c2
commit db337e545c
1 changed files with 0 additions and 49 deletions

View File

@ -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