mcs(CP)                        6 January 1993                        mcs(CP)


 Name

    mcs - manipulate the object file comment section

 Syntax

    mcs [options] object-file ...

 Description

    The mcs command is used to add to, delete, print, and compress the con-
    tents of the comment section (normally .comment) in an 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 each
    object-file.

    If the object file is an archive, the file is treated as a set of indi-
    vidual 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 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 format
        ``filename:string.''

 Examples


       To print file's comment section:

       mcs -p file

       To append string to file's comment section:

       mcs -a string file


 Files


    TMPDIR/mcs*    Temporary files.

    TMPDIR/*       Temporary files.

                   TMPDIR is usually /usr/tmp but can be re-defined by set-
                   ting the environment variable TMPDIR (see tempnam() in
                   tmpnam(S)).

 Notes

    This utility operates only on COFF executables.

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

 See also

    a.out(FP), cpp(CP)

 Standards conformance

    mcs is a valued-added extension of AT&T System V provided by the Santa
    Cruz Operation.