diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/elfedit.1')
| -rw-r--r-- | upstream/mageia-cauldron/man1/elfedit.1 | 190 |
1 files changed, 56 insertions, 134 deletions
diff --git a/upstream/mageia-cauldron/man1/elfedit.1 b/upstream/mageia-cauldron/man1/elfedit.1 index 33e62e3e..f17b6a2b 100644 --- a/upstream/mageia-cauldron/man1/elfedit.1 +++ b/upstream/mageia-cauldron/man1/elfedit.1 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -68,79 +52,17 @@ . \} .\} .rr rF -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ELFEDIT 1" -.TH ELFEDIT 1 "2023-06-27" "binutils-2.40" "GNU Development Tools" +.TH ELFEDIT 1 2024-04-08 binutils-2.42 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh -.SH "NAME" +.SH NAME elfedit \- update ELF header and program property of ELF files -.SH "SYNOPSIS" +.SH SYNOPSIS .IX Header "SYNOPSIS" elfedit [\fB\-\-input\-mach=\fR\fImachine\fR] [\fB\-\-input\-type=\fR\fItype\fR] @@ -155,16 +77,16 @@ elfedit [\fB\-\-input\-mach=\fR\fImachine\fR] [\fB\-v\fR|\fB\-\-version\fR] [\fB\-h\fR|\fB\-\-help\fR] \fIelffile\fR... -.SH "DESCRIPTION" +.SH DESCRIPTION .IX Header "DESCRIPTION" -\&\fBelfedit\fR updates the \s-1ELF\s0 header and program property of \s-1ELF\s0 -files which have the matching \s-1ELF\s0 machine and file types. The options -control how and which fields in the \s-1ELF\s0 header and program property +\&\fBelfedit\fR updates the ELF header and program property of ELF +files which have the matching ELF machine and file types. The options +control how and which fields in the ELF header and program property should be updated. .PP -\&\fIelffile\fR... are the \s-1ELF\s0 files to be updated. 32\-bit and -64\-bit \s-1ELF\s0 files are supported, as are archives containing \s-1ELF\s0 files. -.SH "OPTIONS" +\&\fIelffile\fR... are the ELF files to be updated. 32\-bit and +64\-bit ELF files are supported, as are archives containing ELF files. +.SH OPTIONS .IX Header "OPTIONS" The long and short forms of options, shown here as alternatives, are equivalent. At least one of the \fB\-\-output\-mach\fR, @@ -172,80 +94,80 @@ equivalent. At least one of the \fB\-\-output\-mach\fR, \&\fB\-\-output\-abiversion\fR, \&\fB\-\-enable\-x86\-feature\fR and \fB\-\-disable\-x86\-feature\fR options must be given. -.IP "\fB\-\-input\-mach=\fR\fImachine\fR" 4 +.IP \fB\-\-input\-mach=\fR\fImachine\fR 4 .IX Item "--input-mach=machine" -Set the matching input \s-1ELF\s0 machine type to \fImachine\fR. If -\&\fB\-\-input\-mach\fR isn't specified, it will match any \s-1ELF\s0 +Set the matching input ELF machine type to \fImachine\fR. If +\&\fB\-\-input\-mach\fR isn't specified, it will match any ELF machine types. .Sp -The supported \s-1ELF\s0 machine types are, \fIi386\fR, \fI\s-1IAMCU\s0\fR, \fIL1OM\fR, +The supported ELF machine types are, \fIi386\fR, \fIIAMCU\fR, \fIL1OM\fR, \&\fIK1OM\fR and \fIx86\-64\fR. -.IP "\fB\-\-output\-mach=\fR\fImachine\fR" 4 +.IP \fB\-\-output\-mach=\fR\fImachine\fR 4 .IX Item "--output-mach=machine" -Change the \s-1ELF\s0 machine type in the \s-1ELF\s0 header to \fImachine\fR. The -supported \s-1ELF\s0 machine types are the same as \fB\-\-input\-mach\fR. -.IP "\fB\-\-input\-type=\fR\fItype\fR" 4 +Change the ELF machine type in the ELF header to \fImachine\fR. The +supported ELF machine types are the same as \fB\-\-input\-mach\fR. +.IP \fB\-\-input\-type=\fR\fItype\fR 4 .IX Item "--input-type=type" -Set the matching input \s-1ELF\s0 file type to \fItype\fR. If -\&\fB\-\-input\-type\fR isn't specified, it will match any \s-1ELF\s0 file types. +Set the matching input ELF file type to \fItype\fR. If +\&\fB\-\-input\-type\fR isn't specified, it will match any ELF file types. .Sp -The supported \s-1ELF\s0 file types are, \fIrel\fR, \fIexec\fR and \fIdyn\fR. -.IP "\fB\-\-output\-type=\fR\fItype\fR" 4 +The supported ELF file types are, \fIrel\fR, \fIexec\fR and \fIdyn\fR. +.IP \fB\-\-output\-type=\fR\fItype\fR 4 .IX Item "--output-type=type" -Change the \s-1ELF\s0 file type in the \s-1ELF\s0 header to \fItype\fR. The -supported \s-1ELF\s0 types are the same as \fB\-\-input\-type\fR. -.IP "\fB\-\-input\-osabi=\fR\fIosabi\fR" 4 +Change the ELF file type in the ELF header to \fItype\fR. The +supported ELF types are the same as \fB\-\-input\-type\fR. +.IP \fB\-\-input\-osabi=\fR\fIosabi\fR 4 .IX Item "--input-osabi=osabi" -Set the matching input \s-1ELF\s0 file \s-1OSABI\s0 to \fIosabi\fR. If -\&\fB\-\-input\-osabi\fR isn't specified, it will match any \s-1ELF\s0 OSABIs. +Set the matching input ELF file OSABI to \fIosabi\fR. If +\&\fB\-\-input\-osabi\fR isn't specified, it will match any ELF OSABIs. .Sp -The supported \s-1ELF\s0 OSABIs are, \fInone\fR, \fI\s-1HPUX\s0\fR, \fINetBSD\fR, -\&\fI\s-1GNU\s0\fR, \fILinux\fR (alias for \fI\s-1GNU\s0\fR), -\&\fISolaris\fR, \fI\s-1AIX\s0\fR, \fIIrix\fR, -\&\fIFreeBSD\fR, \fI\s-1TRU64\s0\fR, \fIModesto\fR, \fIOpenBSD\fR, \fIOpenVMS\fR, -\&\fI\s-1NSK\s0\fR, \fI\s-1AROS\s0\fR and \fIFenixOS\fR. -.IP "\fB\-\-output\-osabi=\fR\fIosabi\fR" 4 +The supported ELF OSABIs are, \fInone\fR, \fIHPUX\fR, \fINetBSD\fR, +\&\fIGNU\fR, \fILinux\fR (alias for \fIGNU\fR), +\&\fISolaris\fR, \fIAIX\fR, \fIIrix\fR, +\&\fIFreeBSD\fR, \fITRU64\fR, \fIModesto\fR, \fIOpenBSD\fR, \fIOpenVMS\fR, +\&\fINSK\fR, \fIAROS\fR and \fIFenixOS\fR. +.IP \fB\-\-output\-osabi=\fR\fIosabi\fR 4 .IX Item "--output-osabi=osabi" -Change the \s-1ELF OSABI\s0 in the \s-1ELF\s0 header to \fIosabi\fR. The -supported \s-1ELF OSABI\s0 are the same as \fB\-\-input\-osabi\fR. -.IP "\fB\-\-input\-abiversion=\fR\fIversion\fR" 4 +Change the ELF OSABI in the ELF header to \fIosabi\fR. The +supported ELF OSABI are the same as \fB\-\-input\-osabi\fR. +.IP \fB\-\-input\-abiversion=\fR\fIversion\fR 4 .IX Item "--input-abiversion=version" -Set the matching input \s-1ELF\s0 file \s-1ABIVERSION\s0 to \fIversion\fR. +Set the matching input ELF file ABIVERSION to \fIversion\fR. \&\fIversion\fR must be between 0 and 255. If \fB\-\-input\-abiversion\fR -isn't specified, it will match any \s-1ELF\s0 ABIVERSIONs. -.IP "\fB\-\-output\-abiversion=\fR\fIversion\fR" 4 +isn't specified, it will match any ELF ABIVERSIONs. +.IP \fB\-\-output\-abiversion=\fR\fIversion\fR 4 .IX Item "--output-abiversion=version" -Change the \s-1ELF ABIVERSION\s0 in the \s-1ELF\s0 header to \fIversion\fR. +Change the ELF ABIVERSION in the ELF header to \fIversion\fR. \&\fIversion\fR must be between 0 and 255. -.IP "\fB\-\-enable\-x86\-feature=\fR\fIfeature\fR" 4 +.IP \fB\-\-enable\-x86\-feature=\fR\fIfeature\fR 4 .IX Item "--enable-x86-feature=feature" Set the \fIfeature\fR bit in program property in \fIexec\fR or \fIdyn\fR -\&\s-1ELF\s0 files with machine types of \fIi386\fR or \fIx86\-64\fR. The +ELF files with machine types of \fIi386\fR or \fIx86\-64\fR. The supported features are, \fIibt\fR, \fIshstk\fR, \fIlam_u48\fR and \&\fIlam_u57\fR. -.IP "\fB\-\-disable\-x86\-feature=\fR\fIfeature\fR" 4 +.IP \fB\-\-disable\-x86\-feature=\fR\fIfeature\fR 4 .IX Item "--disable-x86-feature=feature" Clear the \fIfeature\fR bit in program property in \fIexec\fR or -\&\fIdyn\fR \s-1ELF\s0 files with machine types of \fIi386\fR or \fIx86\-64\fR. +\&\fIdyn\fR ELF files with machine types of \fIi386\fR or \fIx86\-64\fR. The supported features are the same as \fB\-\-enable\-x86\-feature\fR. .Sp Note: \fB\-\-enable\-x86\-feature\fR and \fB\-\-disable\-x86\-feature\fR are available only on hosts with \fBmmap\fR support. -.IP "\fB\-v\fR" 4 +.IP \fB\-v\fR 4 .IX Item "-v" .PD 0 -.IP "\fB\-\-version\fR" 4 +.IP \fB\-\-version\fR 4 .IX Item "--version" .PD Display the version number of \fBelfedit\fR. -.IP "\fB\-h\fR" 4 +.IP \fB\-h\fR 4 .IX Item "-h" .PD 0 -.IP "\fB\-\-help\fR" 4 +.IP \fB\-\-help\fR 4 .IX Item "--help" .PD Display the command-line options understood by \fBelfedit\fR. -.IP "\fB@\fR\fIfile\fR" 4 +.IP \fB@\fR\fIfile\fR 4 .IX Item "@file" Read command-line options from \fIfile\fR. The options read are inserted in place of the original @\fIfile\fR option. If \fIfile\fR @@ -261,13 +183,13 @@ with a backslash. The \fIfile\fR may itself contain additional .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR. -.SH "COPYRIGHT" +.SH COPYRIGHT .IX Header "COPYRIGHT" -Copyright (c) 1991\-2023 Free Software Foundation, Inc. +Copyright (c) 1991\-2024 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document -under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3 +under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the -section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". +section entitled "GNU Free Documentation License". |