mcs(1)                              CLIX                              mcs(1)



  NAME

    mcs - Manipulates object file comment section

  SYNOPSIS

    mcs [flag ... ] object_file ...

  FLAGS

    -a string   Appends string to the comment section of the object_files.  If
                string contains embedded blanks, the entire string must be
                enclosed in quotation marks.

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

    -d          Deletes the contents of the comment section from the object
                file.  The object file comment section header is also removed.
                This flag does not remove comments beginning with the string
                SGS (see "NOTES" for more informaiton).

    -D          Deletes the contents of the comment section from the object
                file, including comments beginning with the string SGS.  The
                object file comment section header is also removed.

    -n name     Specifies the name of the section to access.  By default, mcs
                deals with the section named .comment.  This flag is used to
                specify another section.

    -p          Displays the contents of the comment section on stdout.  If
                more than one name is specified, the name of each file is
                displayed before its strings are output.

    -P          Displays the contents of the comment section, and displays the
                name of file processed before its strings are output.

  DESCRIPTION

    The mcs command manipulates the comment section (normally .comment
    section) in an object file.  It can add to, delete, display, and compress
    the contents of the comment section in a UNIX System object file.  The mcs
    command must be given one or more flags.  It takes each of the flags 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 flag is specified, the
    string is appended to the comment section of each archive element.

  EXAMPLES



  2/94 - Intergraph Corporation                                              1

  mcs(1)                              CLIX                              mcs(1)



    1.  The following displays the contents of the comment section of file.1:

        mcs -p file.1


    2.  The following appends the string hello there to the comment section of
        file.2:

        mcs -a "hello there" file.2


  FILES

    TMPDIR/mcs*
           Temporary files.

    TMPDIR/*
           Temporary files.

    The TMPDIR directory is usually /usr/tmp, but it can be redefined by
    setting the environment variable TMPDIR (see tempnam() in tmpnam).

  NOTES

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

    In order to support the IAR product, mcs was modified so that it will not
    remove comment sections which begin with the string SGS.  These strings
    are inserted by the various compilers and contain information vital to the
    operation of IAR.

  EXIT VALUES

    The mcs command returns a value of 0 if successful.  If any errors occur,
    a value of 1 is returned.

  RELATED INFORMATION

    Commands:  cpp(1), iar(1)

    Files:  a.out(4)












  2                                              Intergraph Corporation - 2/94