MPC(1)MPC(1)


NAME
     mpc - Multiprocessing C source transformer

SYNOPSIS
     /usr/lib/mpc [-ansi] [-cckr] [-dollar] [-Kfile] [-xansi] [-64] ...
     file [options] ...

     /usr/lib64/cmplrs/mpc [-ansi] [-cckr] [-dollar] [-Kfile] [-xansi]
     [-64] ... file [options] ...

DESCRIPTION
     NOTE: This command is available only for o32 ABI.

     mpc is a source-to-source C translator that transforms code that
     contains parallel directives, inserted by pca(1) or by hand, into
     parallel C code containing calls to the C multiprocessing library.
     For more information on the types of directives that mpc implements,
     see the IRIS Power C User's Guide.

     mpc is usually invoked as an option to the cc(1) command, although it
     can be run separately.  When mpc is used as part of a cc compilation,
     the mpc options must be passed via the -W (specifically, -WM)
     mechanism.  See the cc(1) man page for details about -W.

     mpc will accept the name of a single input source file, specified
     anywhere on its command line.  If none is specified, standard input is
     used.  The input should be C code that has already been preprocessed.

     An output filename can be specified by using the -K option, see the
     option description that follows.  If no such option is given, no
     output code will be produced.

     The following options are available:

     -ansi       Pure ANSI/ISO C.

     -cckr       Uses the traditional K&R/Version7 C with SGI (and some
                 ANSI/ISO-C-like) extensions, including function
                 prototypes, void, and void*.

     -dollar     Allows the dollar sign ($) as a character in C
                 identifiers, including allowing it as the leading
                 character of an identifier.  The option is provided solely
                 for compatibility purposes.  The dollar sign is not a
                 standard C identifier character and its use is not
                 recommended.

     -Kfile      Instructs mpc to place the transformed C code into the
                 specified file.

     -xansi      Specifies ANSI/ISO C with SGI extensions and relaxed
                 enforcement of certain ANSI guidelines.

     -64         This option informs mpc that the code is being compiled
                 for a 64-bit machine.  This affects the size of certain C
                 data types.

FILES
     /usr/lib/mpc
          The mpc program

     /usr/lib64/cmplrs/mpc
          The mpc program for 32-bit and 64-bit versions

     file.i
          C preprocessed source file with directives

     file.P
          C transformed file with parallel code

     /usr/lib/libc_mp.a
          Multiprocessing C runtime library (mips1 version)

     /usr/lib64/mips3/libmp.a
          Multiprocessing C runtime library (mips3 version)

     /usr/lib64/mips4/libmp.a
          Multiprocessing C runtime library (mips4 version)

SEE ALSO
     cc(1), cpp(1), pca(1)

     IRIS Power C User's Guide

     IRIS Power C Quick Reference

     Parallel Programming on Silicon Graphics Computer Systems

     Practical Parallel Programming, by Dr. Barr Bauer, Academic Press,
     1991.

     Introduction to Parallel Programming, by Steven Brawer, Academic
     Press, 1989.