MCS(1)                               SysV                               MCS(1)



NAME
     mcs - manipulate the object file comment section

SYNOPSIS
     mcs [options] object-file ...

DESCRIPTION
     The mcs command manipulates the comment section, normally the ".comment"
     section, in an object file.  It is used to add to, delete, print, and
     compress the contents of the comment section in a UNIX System object
     file. The mcs command must be given one or more of the options described
     below.  It takes each of the options given and applies them in order to
     the object-files.

     If the object file is an archive, the file is treated as a set of
     individual object files.  For example, if the -a option is specified, the
     string is appended to the comment section of each archive element.

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

     -c             Compress the contents of the comment section.  All
                    duplicate entries are removed.  The ordering of the
                    remaining entries is not disturbed.

     -d             Delete the contents of the comment section from the object
                    file.  The object file comment section header is removed
                    also.

     -n name        Specify the name of the section to access.  By default,
                    mcs deals with the section named .comment.  This option
                    can be used to specify another section.

     -p             Print the contents of the comment section on the standard
                    output.  If more than one name is specified, each entry
                    printed is tagged by the name of the file from which it
                    was extracted, using the filename:string format.

EXAMPLES
             mcs -p file          # Print file's comment section.

             mcs -a string file   # Append string to file's comment section

NOTES
     The mcs command cannot add new sections or delete existing sections to
     executable objects with magic number 0413 [see a.out(4)].

FILES
     TMPDIR/mcs*           temporary files

     TMPDIR/*              temporary files

     TMPDIR is usually /usr/tmp but can be redefined by setting
                           the environment variable TMPDIR [see tempnam() in
                           tmpnam(3S)].

SEE ALSO
     cpp(1), a.out(4).