mcs(1)

NAME

     mcs - manipulate the comment section of an object file

SYNOPSIS

     /usr/ccs/bin/mcs {-c | -d | -p | -V | -a string  |  -n name}
     ... file...

DESCRIPTION

     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  sec-
     tion 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(3HEAD)), 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.

OPTIONS

     The following options are supported:

     -a string
           Appends string to  the  comment  section  of  the  ELF
           object  files.  If string contains embedded blanks, it
           must be enclosed in quotation marks.

     -c    Compresses the contents of the comment section of  the
           ELF  object  files. All duplicate entries are removed.
           The ordering of the  remaining  entries  is  not  dis-
           turbed.

     -d    Deletes the contents of the comment section  from  the
           ELF  object  files. The section header for the comment
           section is also removed.

     -n name
           Specifies 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  sec-
           tion comments.

     -p    Prints 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    Prints on standard error the version number of mcs.

EXAMPLES

     Example 1: Printing a file's comment section

     The following entry

     example% /usr/ccs/bin/mcs -p elf.file

     prints the comment section of the file elf.file.

     Example 2: Appending a string to a comment section

     The following entry

     example% /usr/ccs/bin/mcs -a  xyz elf.file

     appends string xyz to elf.file's comment section.

FILES

     /tmp/mcs*
           temporary files

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWbtool                   |
    |_____________________________|_____________________________|

SEE ALSO

     ar(1),  as(1),  ld(1),  elf(3ELF),   tmpnam(3C),   a.out(4),
     ar(3HEAD), attributes(5)

NOTES

     When mcs deletes a section using the -d option, it tries  to
     bind together sections of type  SHT_REL and  target sections
     pointed to by the  sh_info section header field. If  one  is
     to  be  deleted,   mcs  attempts  to delete the other of the
     pair.