MCS(1)               INTERACTIVE UNIX System               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 com-
               ment 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.

               The following options are available.

               -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 stan-
                    dard 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 format
                    ``filename:string.''

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

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

          FILES
               TMPDIR/mcs*           temporary files


          Rev. C Software Development Set                            Page 1

          MCS(1)               INTERACTIVE UNIX System               MCS(1)



               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).

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










































          Rev. C Software Development Set                            Page 2