# PMIx Reference Runtime Environment (PRRTE) v4.0.0

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. Terminology
- 7. How Things Work
  - 7.1. Session Directories
  - 7.2. Scheduler Integration
- 8. Host specification
  - 8.1. Resource Manager-Provided Hosts
  - 8.2. Hostfiles
  - 8.3. Listing Hosts on the Command Line
  - 8.4. Relative host indexing
- 9. Process placement
  - 9.1. Overview
  - 9.2. Definition of ‘slot’
  - 9.3. Definition of “processor element”
  - 9.4. Examples
  - 9.5. Fundamentals
  - 9.6. Overloading and Oversubscribing
  - 9.7. Diagnostics
  - 9.8. Rankfiles
  - 9.9. Deprecated options
- 10. Notifications
- 11. Session directory
  - 11.1. Directory location
  - 11.2. Directory name
  - 11.3. Tools
- 12. Developer’s guide
  - 12.1. Prerequisites
  - 12.2. GitHub, Git, and related topics
  - 12.3. Manually installing the GNU Autootools
  - 12.4. Installing and running Sphinx (building the PRRTE docs)
  - 12.5. ReStructured Text for those who know Markdown
- 13. Contributing to PRRTE
  - 13.1. Open source contributions
- 14. License
- 15. PRRTE manual pages
  - 15.1. Commands (section 1)
  - 15.2. Config file manual pages (section 5)
- 16. Software Version Numbers
- 17. News
  - 17.1. PRRTE v4.x series
  - 17.2. PRRTE v3.x series
  - 17.3. PRRTE v2.x series
  - 17.4. PRRTE v1.x series