mcs(1) manual page
Table of Contents
mcs - manipulate the comment section of an object file
mcs
{ -c | -d | -p | -V | -a string | -n name }... file...
SUNWbtool
The mcs command is used to manipulate a section, by default the .comment
section, in an ELF object file. It is used to add to, delete, print, and
compress the contents of a section in an ELF object file, and print only
the contents of a section in a COFF object file. mcs cannot add, delete
or compress the contents of a section that is contained within a segment.
If the input file is an archive (see ar(4)
), the archive is treated as
a set of individual files. For example, if the -a option is specified, the
string is appended to the comment section of each ELF object file in the
archive; if the archive member is not an ELF object file, then it is left
unchanged.
mcs must be given one or more of the options described below.
It applies, in order, each of the specified options to each file.
- -a
string
- Append string to the comment section of the ELF object files. If
string contains embedded blanks, it must be enclosed in quotation marks.
- -c
- Compress the contents of the comment section of the ELF object files.
All duplicate entries are removed. The ordering of the remaining entries
is not disturbed.
- -d
- Delete the contents of the comment section from the
ELF object files. The section header for the comment section is also removed.
- -n name
- Specify the name of the comment section to access if other than
.comment. By default, mcs deals with the section named .comment. This option
can be used to specify another section. mcs can take multiple -n options
to allow for specification of multiple section comments.
- -p
- Print the contents
of the comment section on the standard output. Each section printed is tagged
by the name of the file from which it was extracted, using the format file[member_name]:
for archive files and file: for other files.
- -V
- Print on standard error the
version number of mcs.
The following example:
example% mcs -p elf.file
prints elf.file’s comment section.
The next example:
example% mcs -a xyz elf.file
appends string xyz to elf.file’s comment section.
- /tmp/mcs*
- temporary
files
ar(1)
, as(1)
, ld(1)
, elf(3E)
, tmpnam(3S)
, a.out(4)
, ar(4)
Table of Contents