NAME

mpicpp - Preprocess C source code, converting global to thread global variables

DESCRIPTION

This command parses pre-processed ANSI or C99 source code on stdin. It then converts any global variables in user code (not system headers) into thread global variables by prefixing __thread to their declaration. Output is directed to stdout.

The non-standard __no_thread storage class can be used to avoid the above process if a variable needs to stay global, and not thread global. This is useful if you wish to use normal locking techniques as well as MPI in your program. Note that a global variable will only be global in a single-machine scope, and not over a whole cluster.

This program should not be used by normal users. Use the mpicc shell script instead.

COMMAND LINE ARGUMENTS

There are no command line arguments. Input is stdin and output is stdout .

BUGS

Due to the proliferation of non-standard extensions, it is impossible to guarantee that C source code will always be parsed correctly. The parser works well on common code idioms, but may be tripped up by "strange" syntax. If so, manual addition of __thread keywords may be necessary.

COPYRIGHT

Copyright (C) 2011 Lockless Inc.

SEE ALSO

mpicc (1) mpiexec (1)

• Lockless
• MPI Documentation
• mpicpp