From 31ea6b8427fff307f9d7a1078854d33caa73dd6f Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 27 Nov 2016 12:05:32 +0100 Subject: [PATCH] elf.5: srcfix: rewrap some long source lines Signed-off-by: Michael Kerrisk --- man5/elf.5 | 48 +++++++++++++++++++++++++++--------------------- 1 file changed, 27 insertions(+), 21 deletions(-) diff --git a/man5/elf.5 b/man5/elf.5 index 3d253b78e..2381e29b8 100644 --- a/man5/elf.5 +++ b/man5/elf.5 @@ -524,8 +524,8 @@ Currently, no flags have been defined. This member holds the ELF header's size in bytes. .TP .IR e_phentsize -This member holds the size in bytes of one entry in the file's program header -table; all entries are the same size. +This member holds the size in bytes of one entry in the file's +program header table; all entries are the same size. .TP .IR e_phnum This member holds the number of entries in the program header @@ -540,7 +540,8 @@ If a file has no program header, .IR e_phnum holds the value zero. .IP -If the number of entries in the program header table is larger than or equal to +If the number of entries in the program header table is +larger than or equal to .\" This is a Linux extension, added in Linux 2.6.34. .BR PN_XNUM (0xffff), this member holds @@ -580,7 +581,8 @@ header table, .IR e_shnum holds the value of zero. .IP -If the number of entries in the section header table is larger than or equal to +If the number of entries in the section header table is +larger than or equal to .BR SHN_LORESERVE (0xff00), .IR e_shnum @@ -590,7 +592,8 @@ table is held in the member of the initial entry in section header table. Otherwise, the .IR sh_size -member of the initial entry in the section header table holds the value zero. +member of the initial entry in the section header table holds +the value zero. .TP .IR e_shstrndx This member holds the section header table index of the entry associated @@ -599,7 +602,8 @@ If the file has no section name string table, this member holds the value .BR SHN_UNDEF . .IP -If the index of section name string table section is larger than or equal to +If the index of section name string table section is +larger than or equal to .BR SHN_LORESERVE (0xff00), this member holds .BR SHN_XINDEX @@ -716,8 +720,9 @@ Programs that contain an array element of this type do not conform to the ABI. .TP .BR PT_PHDR -The array element, if present, specifies the location and size of the program -header table itself, both in the file and in the memory image of the program. +The array element, if present, +specifies the location and size of the program header table itself, +both in the file and in the memory image of the program. This segment type may not occur more than once in a file. Moreover, it may occur only if the program header table is part of the memory image of the @@ -839,8 +844,8 @@ An object file does not have sections for these special indices: .TP .BR SHN_UNDEF -This value marks an undefined, missing, irrelevant, or otherwise meaningless -section reference. +This value marks an undefined, missing, irrelevant, +or otherwise meaningless section reference. .TP .BR SHN_LORESERVE This value specifies the lower bound of the range of reserved indices. @@ -858,8 +863,8 @@ example, a symbol defined relative to section number has an absolute value and is not affected by relocation. .TP .BR SHN_COMMON -Symbols defined relative to this section are common symbols, such as FORTRAN -COMMON or unallocated C external variables. +Symbols defined relative to this section are common symbols, +such as FORTRAN COMMON or unallocated C external variables. .TP .BR SHN_HIRESERVE This value specifies the upper bound of the range of reserved indices. @@ -1252,8 +1257,8 @@ The attribute used is .IR .init This section holds executable instructions that contribute to the process initialization code. -When a program starts to run the system arranges to -execute the code in this section before calling the main program entry point. +When a program starts to run the system arranges to execute +the code in this section before calling the main program entry point. This section is of type .BR SHT_PROGBITS . The attributes used are @@ -1273,8 +1278,9 @@ This section is of type .BR SHT_PROGBITS . .TP .IR .line -This section holds line number information for symbolic debugging, which -describes the correspondence between the program source and the machine code. +This section holds line number information for symbolic debugging, +which describes the correspondence between the program source and +the machine code. The contents are unspecified. This section is of type .BR SHT_PROGBITS . @@ -1295,8 +1301,8 @@ The only attribute used is .BR SHF_ALLOC . .TP .IR .note.gnu.build-id -This section is used to hold an ID that uniquely identifies the contents of the -ELF. +This section is used to hold an ID that uniquely identifies +the contents of the ELF. Different files with the same build ID should contain the same executable content. See the @@ -1317,9 +1323,9 @@ This indicates to the GNU linker that the object file requires an executable stack. .TP .IR .note.openbsd.ident -OpenBSD native executables usually contain this section to identify themselves -so the kernel can bypass any compatibility ELF binary emulation tests when -loading the file. +OpenBSD native executables usually contain this section +to identify themselves so the kernel can bypass any compatibility +ELF binary emulation tests when loading the file. .TP .IR .plt This section holds the procedure linkage table.