{"id":972,"date":"2022-11-13T22:59:58","date_gmt":"2022-11-13T20:59:58","guid":{"rendered":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/?page_id=972"},"modified":"2025-12-15T17:13:48","modified_gmt":"2025-12-15T15:13:48","slug":"ompi-ppg-basic-installation-usage","status":"publish","type":"page","link":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/software\/ompi\/documentation\/ompi-ppg-basic-installation-usage\/","title":{"rendered":"OMPi @ ppg — basic installation & usage"},"content":{"rendered":"

Here you can find short installation and usage guides, as well as some documents about OMPi internals. More documentation is provided within the source distribution, found in our download page<\/a>.<\/p>\n

<\/a>Prerequisites<\/h3>\n

The basic requirements for building and installing OMPi on your system are:<\/p>\n

    \n
  1. The meson<\/b> build system (version 0.58.0<\/b> or later required)<\/li>\n
  2. A C compiler (e.g. gcc<\/code>)<\/li>\n<\/ol>\n

    <\/a>Quick Installation Guide<\/h3>\n
      \n
    1. Extract the package\n
        tar xvf ompi-X.Y.Z.tar.xz\r\n<\/pre>\n<\/li>\n
    2. Prepare for building and installing (see below for advanced configuration options<\/a>)\n
        meson setup build --prefix=\u2039install-dir\u203a\r\n<\/pre>\n
      This will create a directory named build<\/code> where OMPi will be built; install-dir<\/code> is the directory OMPi will be installed at. If omitted, \/usr\/local\/<\/code> will be used by default.<\/p>\n
      <\/span>More configuration options<\/div>
      \n
      If you want to enable debugging, give the -Denable-debug=true<\/code> option to meson setup<\/code> (turned off by default).<\/p>\n
      The compiler flags used to build the compiler & the libraries are just -O2<\/code>. In case you want to use different\/additional ones, edit the top-level meson.build<\/code> file and put your flags in the standard_cflags<\/code> array.<\/p>\n
      The default compiler is determined by meson<\/code> itself. If you want to use a different compiler you need to set the CC<\/code> environment variable before executing the meson setup<\/code> command<\/p>\n<\/div><\/div>\n 
      <\/span>Advanced configuration: portable OMPi<\/div>
      \n
      You can have a portable build of OMPi in linux as follows:<\/p>\n
        meson setup build -Dportable=true --prefix=\u2039install-dir\u203a ...<\/pre>\n
      You can then build and install OMPi as normal, but now you can move the install_dir<\/code> contents anywhere you like; you can execute ompicc<\/code> within the new directory, or by giving the full path as in:<\/p>\n
        \/new\/path\/bin\/ompicc myfile.c\r\n<\/pre>\n
      Everything will work as normal, even if it has been moved away from the initial install-dir<\/code>.<\/p>\n<\/div><\/div>\n 
      <\/span>Advanced configuration: thread libraries<\/div>
      \n
      OMPi comes with multiple thread libraries, and can support even more (see the bundled doc\/runtime.txt<\/code>); “pthreads”, based on POSIX threads, is the default one. You can choose which one OMPi will be built with as follows:<\/p>\n
        meson setup build -Dortlib=\u2039name\u203a ...\r\n<\/pre>\n
      where \u2039name\u203a is any of the included libraries, or any other library you have developed.<\/p>\n<\/div><\/div>\n 
      <\/span>Advanced configuration: devices\/modules<\/div>
      \n
      OMPi can support multiple OpenMP devices through device modules<\/em>; by default, at configuration time it checks and builds all device modules that may be supported. You can choose which ones OMPi should be built with as follows:<\/p>\n
        meson setup build -Dmodules=\"\u2039name\u203a \u2039name\u203a ...\" ...\r\n<\/pre>\n
      i.e. space-seperated module names, where each \u2039name\u203a is any of the modules OMPi ships with, or any other module you may have developed.<\/p>\n<\/div><\/div>\n 
      <\/span>Advanced configuration: kernel bundling<\/div>
      \n
      OMPi generates kernel binaries from\u00a0#pragma omp target<\/code> constructs, and can either (a) bundle them\u00a0into<\/em> the main\u00a0executable (a.out<\/code>), or (b) output them as separate files in the working directory, alongside<\/em> the main executable. By default, OMPi goes with option (a). To\u00a0change the default behavior, you can set up the compiler with the -Dkernel-bundling=<opt><\/code>\u00a0option:<\/p>\n
        meson setup build -Dkernel-bundling=<opt> ...<\/pre>\n
      where <opt><\/code> can be true<\/code> (enable kernel bundling), false<\/code> (disable kernel bundling) and\u00a0auto<\/code> (current default behavior; equal to\u00a0true<\/code>).<\/p>\n<\/div><\/div>\n<\/li>\n
    3. Compile and install the package\n
        cd build\/\r\n  meson compile\r\n  meson install\r\n<\/pre>\n<\/li>\n
    4. Make sure \u2039install-dir\u203a\/bin<\/code> is in your PATH<\/li>\n<\/ol>\n
      <\/a>Quick Usage Guide<\/h3>\n
      Usage: ompicc [options] files.c<\/code><\/p>\n
      Example:<\/p>\n
        ompicc -o executable file1.c file2.c\r\n<\/pre>\n
      Basic options:<\/p>\n
        \n
      • all (g)cc flags<\/li>\n
      • -k <\/code>: the generated (transformed) file is kept after compilation<\/em><\/li>\n
      • -K <\/code>: all intermediate generated files are kept after compilation<\/em><\/li>\n
      • -v <\/code>: be verbose (shows all steps of the translation process)<\/em><\/li>\n
      • --options <\/code>: show all available options (see below for some of them)<\/em><\/li>\n<\/ul>\n
        <\/span>Some handy options<\/div>
        \n
          \n
        • --info envs\u00a0<\/code>\n
            \n
          • show all OpenMP and extra OMPi environmental variables names
            \n <\/em><\/li>\n<\/ul>\n<\/li>\n
          • --info clause <name> 
            \n <\/code><\/p>\n
              \n
            • show all OpenMP directives that accept <name> as a clause<\/em><\/li>\n<\/ul>\n<\/li>\n
            • --taskopt=<type> 
              \n <\/code><\/p>\n
                \n
              • select tasking optimization type among size<\/code>, speed<\/code>, speed+<\/code> (speed is the default)<\/em><\/li>\n<\/ul>\n<\/li>\n
              • --nolineno\u00a0<\/code>\n
                  \n
                • useful when debugging compiler errors; as a source-to-source compiler,\u00a0OMPi may not always produce very accurate position information for problematic transformed code. This option makes OMPi produce exact source line information but requires all the intermediate files to be kept (with the -K<\/code> option).<\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/div><\/div>\n
                  <\/span>Device options<\/div>
                  \n
                  Following OpenMP 4.0, OMPi supports attached devices that can execute offloaded code. Automatically configured devices are shown with the ompiconf<\/code> utility, as follows:<\/p>\n
                    \n
                  • ompiconf --devinfo[=devs]\u00a0<\/code>: show short information about configured devices.<\/em><\/li>\n
                  • ompiconf --devvinfo[=devs]\u00a0<\/code>: show longer information about configured devices.<\/em><\/li>\n<\/ul>\n
                    To target specific devices when compiling an application, pass the --devs<\/code> option to ompicc<\/code>, as shown below.<\/p>\n
                      \n
                    • --devs=\"\u2039name\u203a \u2039name\u203a ...\" <\/code>: target the given devices<\/em><\/li>\n
                    • --devopt [options] <\/code>: options for particular devices.<\/em><\/li>\n<\/ul>\n<\/div><\/div>\n
                      <\/span>More usage details<\/div>
                      \n
                      OMPi is a source-to-source compiler, so after generating the multithreaded C program, it runs the system compiler — which by default is the one used during OMPi’s installation.<\/p>\n
                      If you want to play with different system compilers, and different compilation flags, you can set three environmental variables to whatever you like: OMPI_CPP<\/code>, OMPI_CC<\/code>, OMPI_CPPFLAGS<\/code>, OMPI_CFLAGS<\/code> and OMPI_LDFLAGS<\/code>. The first two specify the system preprocessor and compiler you like to use and the last three ones the particular flags you want. Make sure you set their values before<\/em> running ompicc<\/code>.<\/p>\n
                      The\u00a0--ort=\u2039libname\u203a<\/code> option lets you select any runtime library you might have built. For more information on this topic, please refer to the bundled doc\/runtime.txt<\/code> file.<\/p>\n
                      The --bundle-kernels<\/code> and\u00a0--no-bundle-kernels<\/code> options let you override the default kernel bundling behavior, enabling\/disabling it only for a specific compilation.<\/p>\n<\/div><\/div>\n
                      Don’t forget to consult the implementation-specific OpenMP behaviors which are bundled with the OMPi source code package.<\/p>\n","protected":false},"excerpt":{"rendered":"
                      Here you can find short installation and usage guides, as well as some documents about OMPi internals. More documentation is provided within the source distribution, found in our download page. Prerequisites The basic requirements for building and installing OMPi on your system are: The meson build system (version 0.58.0 or later required) A C compiler […]<\/p>\n","protected":false},"author":3,"featured_media":0,"parent":120,"menu_order":0,"comment_status":"closed","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-972","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/pages\/972","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/comments?post=972"}],"version-history":[{"count":33,"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/pages\/972\/revisions"}],"predecessor-version":[{"id":1453,"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/pages\/972\/revisions\/1453"}],"up":[{"embeddable":true,"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/pages\/120"}],"wp:attachment":[{"href":"https:\/\/paragroup.cse.uoi.gr\/wpsite\/wp-json\/wp\/v2\/media?parent=972"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}