Print this page
12745 man page typos

*** 2,33 **** .\" Copyright (c) 2008, Sun Microsystems Inc. All .\" Rights Reserved. .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] ! .TH ELFEDIT 1 "Jan 28, 2008" .SH NAME elfedit \- examine or edit ELF files .SH SYNOPSIS - .LP .nf \fBelfedit\fR [\fB-adr\fR] [\fB-e\fR \fIcmd\fR] [\fB-L\fR \fIpath\fR] [\fB-o\fR \fBdefault\fR | \fBsimple\fR | \fBnum\fR] [\fIinfile\fR] [\fIoutfile\fR] .fi .SH DESCRIPTION - .sp - .LP \fBelfedit\fR is a tool for examining or modifying the contents of an existing ELF object. Specifically, \fBelfedit\fR is used to modify the ELF metadata contained in the object. Access is provided to most of the ELF data contained in an object, including the ELF header, section header table, program header table, dynamic section, hardware and software capabilities, string tables, and symbol tables. .SS "Syntax" - .sp - .LP \fBelfedit\fR processes commands from the command line (\fB-e\fR option) or from standard input. If standard input is a terminal, \fBelfedit\fR provides terminal editing capabilities, as well as extensive command completion. ELF uses many standard symbolic names for special integer values and bit masks. \fBelfedit\fR is aware of most possible completions for such names. You can --- 2,28 ---- .\" Copyright (c) 2008, Sun Microsystems Inc. All .\" Rights Reserved. .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] ! .TH ELFEDIT 1 "May 17, 2020" .SH NAME elfedit \- examine or edit ELF files .SH SYNOPSIS .nf \fBelfedit\fR [\fB-adr\fR] [\fB-e\fR \fIcmd\fR] [\fB-L\fR \fIpath\fR] [\fB-o\fR \fBdefault\fR | \fBsimple\fR | \fBnum\fR] [\fIinfile\fR] [\fIoutfile\fR] .fi .SH DESCRIPTION \fBelfedit\fR is a tool for examining or modifying the contents of an existing ELF object. Specifically, \fBelfedit\fR is used to modify the ELF metadata contained in the object. Access is provided to most of the ELF data contained in an object, including the ELF header, section header table, program header table, dynamic section, hardware and software capabilities, string tables, and symbol tables. .SS "Syntax" \fBelfedit\fR processes commands from the command line (\fB-e\fR option) or from standard input. If standard input is a terminal, \fBelfedit\fR provides terminal editing capabilities, as well as extensive command completion. ELF uses many standard symbolic names for special integer values and bit masks. \fBelfedit\fR is aware of most possible completions for such names. You can
*** 300,311 **** .RS 11n Core built in \fBelfedit\fR commands .RE .SS "Status And Command Documentation" - .sp - .LP Status And Command Documentation .sp .LP The status (\fBsys:status\fR) command displays information about the current \fBelfedit\fR session: --- 295,304 ----
*** 397,408 **** .fi .in -2 .sp .SS "Module Search Path" - .sp - .LP \fBelfedit\fR modules are implemented as sharable objects which are loaded on demand. When a module is required, \fBelfedit\fR searches a module path in order to locate the sharable object that implements the module. The path is a sequence of directory names delimited by colon (\fB:\fR) characters. In addition to normal characters, the path can also contain any of the following --- 390,399 ----
*** 442,452 **** .na \fB\fB%r\fR\fR .ad .RS 6n Root of file system tree holding the \fBelfedit\fR program, assuming that ! \fBelfedit\fR is installed as \fBusr/bin/elfedi\fRt within the tree. On a standard system, this is simply the standard system root directory (\fB/\fR). On a development system, where the copy of \fBelfedit\fR can be installed elsewhere, the use of \fB%r\fR can be used to ensure that the matching set of modules are used. .RE --- 433,443 ---- .na \fB\fB%r\fR\fR .ad .RS 6n Root of file system tree holding the \fBelfedit\fR program, assuming that ! \fBelfedit\fR is installed as \fBusr/bin/elfedit\fR within the tree. On a standard system, this is simply the standard system root directory (\fB/\fR). On a development system, where the copy of \fBelfedit\fR can be installed elsewhere, the use of \fB%r\fR can be used to ensure that the matching set of modules are used. .RE
*** 505,516 **** .LP The default search path can be changed by setting the \fBELFEDIT_PATH\fR environment variable, or by using the \fB-L\fR command line option. If you specify both, the \fB-L\fR option supersedes the environment variable. .SH OPTIONS - .sp - .LP The following options are supported: .sp .ne 2 .na \fB\fB-a\fR\fR --- 496,505 ----
*** 626,637 **** providing extra protection against accidental modification, it allows for the examination of files for which the user does not have write permission. .RE .SH OPERANDS - .sp - .LP The following operands are supported: .sp .ne 2 .na \fB\fIinfile\fR\fR --- 615,624 ----
*** 670,681 **** is opened for read-only access, and the modified object contents are written to \fIoutfile\fR. .RE .SH USAGE - .sp - .LP When supported by the system, \fBelfedit\fR runs as a 64-bit application, capable of processing files greater than or equal to 2 Gbytes (2^31 bytes). .sp .LP At startup, \fBelfedit\fR uses \fBlibelf\fR to open the input file and cache a --- 657,666 ----
*** 700,711 **** If no \fB-e\fR options are specified, \fBelfedit\fR reads commands from \fBstdin\fR and executes them in the order given. The caller must explicitly issue the write (\fBsys:write\fR) and quit (\fBsys:quit\fR) commands to save their work and exit when running in this mode. .SH EXIT STATUS - .sp - .LP The following exit values are returned: .sp .ne 2 .na \fB\fB0\fR\fR --- 685,694 ----
*** 731,742 **** .RS 5n Invalid command line options were specified. .RE .SH EXAMPLES - .sp - .LP In the following examples, interactive use of \fBelfedit\fR is shown with the shell prompt (\fB%\fR) and the \fBelfedit\fR prompt (\fB>\fR). Neither of these characters should be entered by the user. .LP \fBExample 1 \fRChanging the Runpath of an Executable --- 714,723 ----
*** 864,874 **** .fi .in -2 .sp .SH ENVIRONMENT VARIABLES - .sp .ne 2 .na \fB\fBELFEDIT_PATH\fR\fR .ad .RS 16n --- 845,854 ----
*** 895,905 **** Interactively delivers output from \fBelfedit\fR to the screen. If not set, \fBmore\fR is used. See \fBmore\fR(1). .RE .SH FILES - .sp .ne 2 .na \fB\fB/usr/lib/elfedit\fR\fR .ad .RS 20n --- 875,884 ----
*** 916,927 **** Personal \fBtecla\fR customization file for command line editing. See \fBtecla\fR(5). .RE .SH ATTRIBUTES - .sp - .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp .sp .TS --- 895,904 ----
*** 932,952 **** _ Interface Stability Committed .TE .SH SEE ALSO - .sp - .LP \fBdump\fR(1), \fBelfdump\fR(1), \fBld.so.1\fR(1), \fBmore\fR(1), \fBnm\fR(1), \fBpvs\fR(1), \fBelf\fR(3ELF), \fBlibelf\fR(3LIB), \fBtecla\fR(5), \fBattributes\fR(5) .sp .LP \fILinker and Libraries Guide\fR .SH WARNINGS - .sp - .LP \fBelfedit\fR is designed to be a tool for testing and development of the ELF system. It offers the ability to examine and change nearly every piece of ELF metadata in the object. It quietly allows edits that can produce an invalid or unusable ELF file. The user is expected to have knowledge of the ELF format and of the rules and conventions that govern them. The \fILinker and Libraries --- 909,925 ----
*** 963,974 **** .LP Higher level operations, such as the use of the \fBdyn:runpath\fR command to change the \fBrunpath\fR of an object, are safe, and can be carried out without the sort of risk detailed in this section. .SH NOTES - .sp - .LP Not every ELF operation supported by \fBelfedit\fR can be successfully carried out on every ELF object. \fBelfedit\fR is constrained by the existing sections found in the file. .sp .LP --- 936,945 ----