# PMIx Reference Runtime Environment (PRRTE) v3.0.6rc1

The project is formally referred to in documentation by “PRRTE”, and the GitHub repository is `prrte`.

Note

We have found that most users do not like typing the two consecutive `r` letters in the name. Hence, all of the internal API symbols, environment variables, MCA frameworks, and CLI executables all use the abbreviated `prte` (one `r`, not two) for convenience.

# Documentation locations

This documentation can be found in the following locations:

- On the web: https://docs.prrte.org/

- In the tarball: `docs/_build/html/index.html`

- Installed: `$prefix/share/doc/prrte/html/index.html`

# Table of contents

- 1. Quick start
- 2. Release Notes
- 3. Getting help
- 4. Installing PRRTE
  - 4.1. For More Information
  - 4.2. Minimum PMIx version
  - 4.3. Developer Builds
  - 4.4. User Builds
- 5. PRRTE DVM Configuration
  - 5.1. Configuration Options
  - 5.2. Configurator Tool
- 6. How Things Work
  - 6.1. Session Directories
- 7. Host specification
  - 7.1. Resource Manager-Provided Hosts
  - 7.2. Hostfiles
  - 7.3. Listing Hosts on the Command Line
  - 7.4. Relative host indexing
- 8. Process placement
  - 8.1. Overview
  - 8.2. Definition of ‘slot’
  - 8.3. Definition of “processor element”
  - 8.4. Examples
  - 8.5. Fundamentals
  - 8.6. Overloading and Oversubscribing
  - 8.7. Diagnostics
  - 8.8. Rankfiles
  - 8.9. Deprecated options
- 9. Notifications
- 10. Session directory
  - 10.1. Directory location
  - 10.2. Directory name
  - 10.3. Tools
- 11. Developer’s guide
  - 11.1. Prerequisites
  - 11.2. GitHub, Git, and related topics
  - 11.3. Manually installing the GNU Autootools
  - 11.4. Installing and running Sphinx (building the PRRTE docs)
  - 11.5. ReStructured Text for those who know Markdown
- 12. Contributing to PRRTE
  - 12.1. Open source contributions
- 13. License
- 14. PRRTE manual pages
  - 14.1. Commands (section 1)
  - 14.2. Config file manual pages (section 5)
- 15. Software Version Numbers
- 16. News
  - 16.1. PRRTE v3.x series
  - 16.2. PRRTE v2.x series
  - 16.3. PRRTE v1.x series