Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ mcs(CP) — OpenDesktop Software Development System 1.0.0d

Media Vault

Software Library

Restoration Projects

Artifacts Sought

     Name
          mcs - manipulate the object file comment section

     Syntax
          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 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
               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
               mcs -p file       # Print file's comment section.

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

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

     See Also
          cpp(CP), a.out(F)

     Notes
          Note that 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(F)).

     Value Added
          mcs is an extension of AT&T System V provided by the Santa
          Cruz Operation.

                                                (printed 6/18/89)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026