Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/./man/man1/elfcompress.1
Real path: /usr/share/man/man1/elfcompress.1
Zurück

'\" te .\" Copyright (c) 2014, 2021, Oracle and/or its affiliates. .TH elfcompress 1 "2 December 2021" "Oracle Solaris 11.4" "User Commands" .SH NAME elfcompress \- compress/decompress debug sections of an object file .SH SYNOPSIS .LP .nf \fBelfcompress\fR [\fB-fV\fR] [\fB-c\fR [\fB!\fR]\fIclass1\fR,[\fB!\fR]\fIclass2\fR,... | \fB-n\fR \fIname\fR] [\fB-t\fR \fIcmp-type\fR[,cmp-opt...]] \fIfile\fR... .fi .SH DESCRIPTION .sp .LP The \fBelfcompress\fR command is used to compress or decompress sections in \fBELF\fR object files. Unless otherwise specified, all debug and annotate sections are manipulated. .sp .LP If the input file is an archive (see \fBar.h\fR(3HEAD)), the archive is treated as a set of individual files. If the archive member is not an object file, then it is left unchanged. .sp .LP \fBelfcompress\fR cannot modify a section that is contained within a segment. Such allocable sections have their \fBSHF_ALLOC\fR section flag set. \fBelfcompress\fR cannot modify sections of type \fBSHT_NOBITS\fR. The compression operation specified with the\fB-t\fR option may place additional limits on candidate sections. See the \fB-t\fR option, and NOTES. .sp .LP When the \fB-n\fR option is used to specify one or more sections to process, only the specified sections are processed, and all other sections are left unmodified. .sp .LP When the \fB-n\fR option is not used, \fBelfcompress\fR processes sections selected by the \fB-c\fR option that are compatible with the compression format specified with the \fB-t\fR option. By default, debug and annotate sections are compressed using the \fBzlib\fR format. .SH OPTIONS .sp .LP The following options are supported: .sp .ne 2 .mk .na \fB\fB-c\fR\fB [!]\fIclass1\fR,[!]\fIclass2\fR,...\fR\fR .ad .br .sp .6 .RS 4n Specify candidate sections. This option provides fine grained control over the selection of candidate sections to be manipulated. \fB-c\fR is used in conjunction with the \fB-t\fR option. If the \fB-c\fR option is not specified, \fBelfcompress\fR will default to the \fBannotate\fR and \fBdebug\fR classes. .sp Some classes cause other classes to be implicitly included, or \fBencapsulated\fR. Such cases are noted in the class descriptions below. Each class token can be prepended with a '\fB!\fR' to indicate that the class should not be included. This definition can be useful to prevent a class from including another normally encapsulated class. For example, while the \fBsymbol\fR class encapsulates non-allocable sort sections, \fBsymbol,!sort\fR targets the non-allocable symbol table, but excludes any associated ELF sort sections. .sp The following classes of section can be defined. .sp .ne 2 .mk .na \fB\fBnonalloc\fR\fR .ad .br .sp .6 .RS 4n Process any non-allocatable section. These sections are identified as not including the \fBSHF_ALLOC\fR section flag. This class encapsulates all of the other classes, except for the \fBshstrtab\fR class. .RE .sp .ne 2 .mk .na \fB\fBannotate\fR\fR .ad .br .sp .6 .RS 4n Process any annotation section. These sections provide information that is used by memory access tools, and coverage related tools. These sections are identified by having a \fBSHT_SUNW_ANNOTATE\fR section type. .RE .sp .ne 2 .mk .na \fB\fBcomment\fR\fR .ad .br .sp .6 .RS 4n Process any comment section. These sections are identified by having a \fB.comment\fR section name. .RE .sp .ne 2 .mk .na \fB\fBcompcom\fR\fR .ad .br .sp .6 .RS 4n Compress any compiler commentary section. These sections are identified by having a \fB.compcom\fR section name. .RE .sp .ne 2 .mk .na \fB\fBdebug\fR\fR .ad .br .sp .6 .RS 4n Process sections commonly used to contain debugging data. Debug sections are identified by having a \fB.debug*\fR, \fB.line\fR, \fB.stab*\fR, \fB.SUNW_ctf\fR, or \fB.zdebug*\fR section name. These sections are also identified by having an \fBSHT_PROGBITS\fR, \fBSHT_SUNW_DEBUG\fR, or \fBSHT_SUNW_DEBUGSTR\fR section type. This class also encapsulates the \fBcompcom\fR class. .RE .sp .ne 2 .mk .na \fB\fBshstrtab\fR\fR .ad .br .sp .6 .RS 4n Process the \fB.shstrtab\fR section used to hold \fBELF\fR section names. This option is intended for specialized dynamic objects, and is not recommended for general use. .RE .sp .ne 2 .mk .na \fB\fBsort_sym_addr\fR, \fBsort_sym_name\fR, \fBsort\fR, \fBsort_sym\fR\fR .ad .br .sp .6 .RS 4n Process the symbol sort sections associated to \fBSHT_SYMTAB\fR symbol tables. Each of these symbol tables typically have associated symbol sort sections, sorted by address, and by name. .sp .ne 2 .mk .na \fB\fBsort_sym_addr\fR\fR .ad .RS 18n .rt By-address \fB.symtab\fR symbol sort sections (\fBSHT_SUNW_symsort\fR, \fBSHT_SUNW_tlssort\fR). .RE .sp .ne 2 .mk .na \fB\fBsort_sym_name\fR\fR .ad .RS 18n .rt By-name \fB.symtab\fR symbol sort sections (\fBSHT_SUNW_symnsort\fR). .RE .sp .ne 2 .mk .na \fB\fBsort\fR, \fBsort_sym\fR\fR .ad .RS 18n .rt All \fB.symtab\fR symbol sort sections. Equivalent to specifying both \fBsort_sym_addr\fR and \fBsort_sym_name\fR. .RE .RE .sp .ne 2 .mk .na \fB\fBsymbol\fR\fR .ad .br .sp .6 .RS 4n Process any non-allocatable symbol table. These sections are identified by having a \fBSHT_SYMTAB\fR section type. This class also encapsulates the \fBsort\fR classes. Any associated string table or symbol sort sections are also processed. .RE .RE .sp .ne 2 .mk .na \fB\fB-f\fR\fR .ad .br .sp .6 .RS 4n By default, \fBelfcompress\fR will only compress sections if their resulting size is equal to or smaller than the original data. Specify \fB-f\fR to force compression even when the resulting size is larger than the original. The \fB-f\fR option is equivalent to specifying the \fB-t\fR \fBforce\fR option. .RE .sp .ne 2 .mk .na \fB\fB-n\fR \fIname\fR\fR .ad .br .sp .6 .RS 4n Specifies the name of the section to process. \fBelfcompress\fR can take multiple \fB-n\fR options to allow for specification of multiple sections. If \fB-n\fR is not used, \fBelfcompress\fR selects all debug sections that are compatible with the specified compression operation. See the \fB-t\fR option, and NOTES. .RE .sp .ne 2 .mk .na \fB\fB-t\fR \fIcmp-type\fR[,\fIcmp-opt\fR...]\fR .ad .br .sp .6 .RS 4n Specifies the compression operation to be performed. If the \fB-t\fR option is not specified, \fBelfcompress\fR will default to \fBzlib\fR. The following compression types are recognized. .sp .sp .ne 2 .mk .na \fB\fBnone\fR\fR .ad .br .sp .6 .RS 4n Compressed sections are decompressed. .RE .sp .ne 2 .mk .na \fB\fBzlib\fR\fR .ad .br .sp .6 .RS 4n Compress debug sections with \fBZLIB\fR compression. The candidate sections for compression can be specified using the \fB-c\fR option. If \fB-c\fR is not present, \fBelfcompress\fR defaults to compressing annotate and debug sections, as if the \fB-c\fR \fBannotate,debug\fR option had been set. The resulting sections will have the \fBSHF_COMPRESSED\fR section flag set to identify the use of compression. .RE .sp .ne 2 .mk .na \fB\fBzlib-gnu\fR\fR .ad .br .sp .6 .RS 4n Compress debug sections with \fBZLIB\fR compression, using the \fBGNU\fR section compression format. Candidate sections must be non-allocable (\fBSHF_ALLOC\fR flag not set), cannot have type \fBSHT_NOBITS\fR, and must have a name that begins with \fB.debug\fR. The resulting section will be renamed to start with \fB.zdebug\fR, to identify the use of compression. .RE The following \fIcmp-opt\fR option can be specified. .sp .ne 2 .mk .na \fB\fBforce\fR\fR .ad .br .sp .6 .RS 4n By default, \fBelfcompress\fR will only compress sections if their resulting size is equal to or smaller than the original data. Specify \fBforce\fR to force compression even when the resulting size is larger than the original. .RE .RE .sp .ne 2 .mk .na \fB\fB-V\fR\fR .ad .br .na \fB\fB--version\fR\fR .ad .br .sp .6 .RS 4n Print version information. .RE .sp .ne 2 .mk .na \fB\fB-?\fR\fR .ad .br .na \fB\fB--help\fR\fR .ad .br .sp .6 .RS 4n Print usage message and immediately exit. .RE .SH NOTES .sp .LP The \fBzlib-gnu\fR compression format is limited to sections with names that start with \fB.debug\fR, while the default \fBzlib\fR compression format can be applied to sections with arbitrary names. When \fB-t\fR \fBzlib-gnu\fR is specified, and the \fB-n\fR option is not, any previously compressed sections with names that are incompatible with the \fBzlib-gnu\fR format are decompressed. .sp .LP The \fBelfcompress\fR command is unable to modify core files. .sp .LP The \fBelfcompress\fR \fB-c\fR and \fB-t\fR options correspond to the \fBld\fR \fB-z\ compress-class\fR and \fB-z\ compress-sections\fR options, respectively. Performing these operations at link-edit time, rather than using \fBelfcompress\fR to post process objects is more efficient, but otherwise equivalent. See \fBld\fR(1). .SH EXAMPLES .LP \fBExample 1\fR Apply \fBzlib\fR compression to all debug sections .sp .in +2 .nf % \fBelfcompress file\fR .fi .in -2 .sp .LP \fBExample 2\fR Decompress all debug sections .sp .in +2 .nf % \fBelfcompress -t none file\fR .fi .in -2 .sp .LP \fBExample 3\fR Compress the \fB.debug_info\fR section, using the \fBGNU\fR-style format .sp .in +2 .nf % \fBelfcompress -t zlib-gnu -n .debug_info file\fR .fi .in -2 .sp .LP \fBExample 4\fR Compress the \fB.symtab\fR symbol table and all related sections .sp .in +2 .nf % \fBelfcompress -c symbol file\fR .fi .in -2 .sp .LP \fBExample 5\fR Compress \fB.symtab\fR symbol table and all related sections, excluding symbol sort sections .sp .in +2 .nf % \fBelfcompress -c 'symbol,!sort' file\fR .fi .in -2 .sp .SH FILES .sp .ne 2 .mk .na \fB\fB/tmp/elfcompress_*\fR\fR .ad .RS 22n .rt temporary files .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Availability developer/base-developer-utilities _ Interface Stability Committed .TE .sp .SH SEE ALSO .sp .LP \fBar\fR(1), \fBas\fR(1), \fBld\fR(1), \fBmcs\fR(1), \fBstrip\fR(1), \fBelf\fR(3ELF), \fBar.h\fR(3HEAD), \fBzlib\fR(3), \fBa.out\fR(5), \fBattributes\fR(7) .sp .LP \fIOracle Solaris 11.4 Linkers and Libraries Guide\fR