File: autogen.rst

package info (click to toggle)
openmpi 5.0.8-4
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 201,684 kB
  • sloc: ansic: 613,078; makefile: 42,353; sh: 11,194; javascript: 9,244; f90: 7,052; java: 6,404; perl: 5,179; python: 1,859; lex: 740; fortran: 61; cpp: 20; tcl: 12
file content (32 lines) | stat: -rw-r--r-- 1,264 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Running ``autogen.pl``
======================

You can now run OMPI's top-level ``autogen.pl`` script.  This script
will invoke the GNU Autoconf, Automake, and Libtool commands in the
proper order and do a bunch of component discovery and housekeeping to
setup to run OMPI's top-level ``configure`` script.

Running ``autogen.pl`` may take a few minutes, depending on your
system.  It's not very exciting to watch.

If you have a multi-processor system, enabling the multi-threaded
behavior in Automake 1.11 (or newer) can result in ``autogen.pl``
running faster.  Do this by setting the ``AUTOMAKE_JOBS`` environment
variable to the number of processors (threads) that you want it to use
before invoking ``autogen.pl``.  For example (you can put this in your
shell startup files)::

   # For bash/sh/zsh:
   export AUTOMAKE_JOBS=4

   # For csh/tcsh:
   setenv AUTOMAKE_JOBS 4

.. important:: You generally need to run ``autogen.pl`` whenever the
   top-level file ``configure.ac`` changes, or any files in the
   ``config/`` or ``<project>/config/`` directories change (these
   directories are where a lot of "include" files for Open MPI's
   ``configure`` script live).

.. note:: You do *NOT* need to re-run ``autogen.pl`` if you modify a
   ``Makefile.am``.