PQUERY(1)

Okay bestie, welcome to the PQUERY(1) page from the OpenPMIx manual. It's giving utility energy, and we're about to deep-dive. No cap. 💅

🌸 NAME 🌸

pquery — it's literally query information from the host environment. Periodt.

🦋 SYNOPSIS 🦋

pquery [options] <KEY1>,<KEY2>,...

Like, you pass some options and a comma-separated list of keys, and pquery goes and gets the tea from the host environment. Slay.

💖 DESCRIPTION 💖

So pquery requests the host environment for values associated with the provided keys. That's the whole vibe. It's not out here doing extra; it's just asking for the values that match your keys. Respect. ✨

✨ OPTIONS ✨

pquery accepts the following options:

• -h, --help <arg0> — Shows the help message, bestie. If you don't pass that optional argument, you get a generalized help message similar to the info right here. But if you do pass an argument, you get a more detailed help message for that specific command line option. Obsessed with options within options. 🎀
• -v, --verbose — Enable debug output. Let's get nosy 👀.
• -V, --version — Print version and exit. Bye, love you, mean it. ✌️
• --pmixmca <arg0> <arg1> — Set MCA parameter value. Config queen behavior.
• --uri <arg0> — Specify the URI of the server to which we are to connect, OR the name of the file (specified as <file:filename>) that contains that info. Choose your fighter 🫶.
• --namespace <arg0> — Namespace of the daemon to which we should connect. Respect the namespace, bestie.
• --pid <arg0> — PID of the daemon to which we should connect. Pass int => PID or file:<file> for file containing the PID. It's giving process identification realness.
• --system-server-first — First look for a system server and connect to it if found. Prioritize that system server energy. 🔥
• --system-server — Connect to a system-level server. Full send.
• --tmpdir <arg0> — Set the root for the session directory tree. Plant those directory roots 🌱.
• --wait-to-connect <arg0> — Delay specified number of seconds before trying to connect. Hold up, wait a minute ⏳.
• --num-connect-retries <arg0> — Max number of times to try to connect. Keep trying, bestie, but like, only this many times. 💀

Keys passed to pquery may optionally include one or more qualifiers, with the individual qualifiers delimited by semi-colons. For example:

$ pquery "PMIX_STORAGE_XFER_SIZE[PMIX_STORAGE_ID=lustre1,lustre2;PMIX_STORAGE_PATH=foo]""

Iykyk — qualifiers go brrr with those semicolons. 💅

🚀 EXIT STATUS 🚀

Returns 0 for success, or a non-zero value otherwise. Values returned by the query are printed to stdout. So if you see the values, that's the query doing its thing. Iconic.

🌈 EXAMPLES 🌈

Examples of using this command. (Yes, that's what it says. We love a minimal example section.)

See also: openpmix(5) <#man5-openpmix>

📜 COPYRIGHT 📜

2014-2026, OpenPMIx Community 💖

---

That's a wrap, bestie! This was the PQUERY(1) page from the OpenPMIx manual, dated Aug 04, 2026. Now go query some host environments and slay. Bye! 👑✨