# -*- text -*-
#
# Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana
#                         University Research and Technology
#                         Corporation.  All rights reserved.
# Copyright (c) 2004-2005 The University of Tennessee and The University
#                         of Tennessee Research Foundation.  All rights
#                         reserved.
# Copyright (c) 2004-2005 High Performance Computing Center Stuttgart,
#                         University of Stuttgart.  All rights reserved.
# Copyright (c) 2004-2005 The Regents of the University of California.
#                         All rights reserved.
# Copyright (c) 2010-2012 Cisco Systems, Inc.  All rights reserved.
# Copyright (c) 2017-2018 Intel, Inc. All rights reserved.
# Copyright (c) 2022-2026 Nanook Consulting  All rights reserved.
# $COPYRIGHT$
#
# Additional copyrights may follow
#
# $HEADER$
#
# This is the US/English help file for PMIx pmix-info help
# messages.
#
#
[version]

%s (%s) %s

%s
#
[usage]
%s (%s) %s

Usage: %s [OPTION]...
PMIx Library Information


/*****      General Options      *****/

-h|--help                            This help message
-h|--help <arg0>                     Help for the specified option
-v|--verbose                         Enable typical debug options
-V|--version                         Print version and exit
   --pmixmca <key> <value>           Pass context-specific PMIx MCA parameters ("key" is the parameter
                                     name; "value" is the parameter value)

-a|--all                             Show all configuration options and MCA parameters
   --arch                            Show architecture PMIx was compiled on
-c|--config                          Show configuration options
   --hostname                        Show the hostname that PMIx was configured and built on
   --internal                        Show internal MCA parameters (not meant to be modified by users)
   --param <fw>[:<comp>[,<comp>...]] Show MCA parameters of the named framework, optionally limited to
                                     a comma-delimited list of its components (all of its components
                                     if none are given). The keyword "all" shows every parameter. May
                                     be repeated.
   --params <fw>[:<comp>[,<comp>...]]
                                     Synonym for "--param"
   --path <type>                     Show paths with which PMIx was configured. Accepts "all" or one of:
                                     "prefix", "exec_prefix", "bindir", "sbindir", "libdir", "incdir",
                                     "mandir", "pkglibdir", "libexecdir", "datarootdir", "datadir",
                                     "sysconfdir", "sharedstatedir", "localstatedir", "infodir",
                                     "pkgdatadir", "pkgincludedir". May be repeated.
   --show-version [<what> [<part>]]  Show version of PMIx or a component.  <what> can be the keywords
                                     "pmix" or "all", a framework name (indicating all components in a
                                     framework), or a framework:component string (indicating a specific
                                     component).  <part> can be one of: full (default), major, minor,
                                     release, greek, repo.
   --pretty-print                    When used in conjunction with other parameters, the output is
                                     displayed in 'pretty-print' format (default)
   --parsable                        When used in conjunction with other parameters, the output is
                                     displayed in a machine-parsable format
   --parseable                       Synonym for --parsable
   --color <hue>                     Control color coding: auto (default), never, always

   --show-failed                     Show the components that failed to load along with the reason why they failed
   --selected-only                   Show only variables from selected components
-t| --type                           Show MCA parameters of the type specified in parameter. Accepts the following
                                     parameters: "unsigned_int", "unsigned_long", "unsigned_long_long", "size_t",
                                     "string", "version_string", "bool", and "double"

Report bugs to %s
#
[pmixmca]

Pass a PMIx MCA parameter

Syntax: "--pmixmca <key> <value>", where "key" is the parameter name
and "value" is the parameter value.
#
[param]
Syntax: --param <framework>[:<component>[,<component>...]]
        --param all

Show MCA parameters.  The value names a framework, optionally followed
by a colon and a comma-delimited list of that framework's components;
if no components are listed (or the list is "all"), the parameters of
every component of the framework are shown.  The keyword "all" shows
every parameter.  The option may be repeated.  For example:

   --param pif
   --param pif:linux,bsdx_ipv6
#
[params]
Synonym for "--param"
#
[internal]
Syntax: internal
Show internal MCA parameters (i.e., parameters not meant to be modified by users)
#
[path]
Syntax: --path <type>
Show the paths with which PMIx was configured.  Accepts "all" or one
of: prefix, exec_prefix, bindir, sbindir, libdir, incdir, mandir,
pkglibdir, libexecdir, datarootdir, datadir, sysconfdir,
sharedstatedir, localstatedir, infodir, pkgdatadir, pkgincludedir.
The option may be repeated.
#
[arch]
Syntax: arch
Show architecture PMIx was compiled on
#
[config]
Syntax: c or config
Show configuration options used to configure PMIx
#
[hostname]
Syntax: hostname
Show the hostname upon which PMIx was configured and built
#
[all]
Syntax: a or all
Show all configuration options and MCA parameters
#
[show-version]
Syntax: --show-version [<what> [<part>]]
Show version of PMIx or a component.  <what> can be the keywords "pmix"
or "all", a framework name (indicating all components in a framework),
or a framework:component string (indicating a specific component).
<part> can be one of: full (the default), major, minor, release,
greek, repo.  Given no argument, the version of PMIx and of every
component is shown.  This is distinct from "-V|--version", which
prints only the tool's own version.
#
[pretty-print]
When used in conjunction with other parameters, the output is
displayed in 'pretty-print' format (default)
#
[parsable]
When used in conjunction with other parameters, the output is
displayed in a machine-parsable format
#
[parseable]
When used in conjunction with other parameters, the output is
displayed in a machine-parsable format
#
[color]
Control color coding: auto (default), never, always
#
[show-failed]
Show the components that failed to load along with the reason why they failed
#
[selected-only]
Show only variables from selected (active) components
#
[type]
Show MCA parameters of the type specified in parameter. Accepts the following
parameters: "unsigned_int", "unsigned_long", "unsigned_long_long", "size_t",
"string", "version_string", "bool", and "double"
#
[lib-call-fail]
A library call unexpectedly failed.  This is a terminal error; please
show this message to a PMIx wizard:

        Library call: %s
         Source file: %s
  Source line number: %d

Aborting...
#
[developer warning: field too long]
**************************************************************************
*** DEVELOPER WARNING: A field in pmix_info output is too long and
*** will appear poorly in the prettyprint output.
***
***   Value:      "%s"
***   Max length: %d
**************************************************************************
#
[not-found]
The specified framework could not be found:

  Framework: %s

This could be due to a misspelling of the framework name, or because support
for that framework was not configured into this version of orte. Please see
the "config" option for a full report of how PMIx was configured.
#
[bad-param-value]
The %s option was given a value it cannot interpret:

  Value: "%s"

The value must name a framework, optionally followed by a colon and a
comma-delimited list of that framework's components - for example,
"pif" or "pif:linux,bsdx_ipv6" - or be the keyword "all".
#
[missing-values]
The %s option requires %d values, but fewer were provided:

  Option:  %s
  Value:   %s

Please correct this and try again.
#
[no-args]

The %s command does not accept arguments other than those specifically
defined by the command. The following were not recognized:

   Args: %s

Please see "%s --help" for a description of all accepted command
options.
