NPROC(1)

📦
version 0.12.0 · 7 versions
, in ubuntu stonking

✨ nproc(1) — bestie edition ✨

okay so we're in the General Commands Manual, and this is the page for nproc 💅 she's a little icon, she tells you how many cores you can actually use. no cap.

🌸 NAME 🌸

nproc — print the number of cores available to the current process. If the OMP_NUM_THREADS or OMP_THREAD_LIMIT environment variables are set, then they will determine the minimum and maximum returned value respectively. periodt 💖

🦋 SYNOPSIS 🦋

nproc [OPTIONS]...

🎀 DESCRIPTION 🎀

okay so literally what she does: she prints the number of cores available to the current process 🫶

and here's the tea — if OMP_NUM_THREADS or OMP_THREAD_LIMIT are set in your environment, those two are gonna be in charge of the answer. OMP_NUM_THREADS sets the minimum returned value, and OMP_THREAD_LIMIT sets the maximum returned value, respectively. so basically they're the ones setting the floor and the ceiling, not her. iykyk ✨

💖 OPTIONS 💖

  • --all — print the number of cores available to the system 🔥 (like, the whole system, not just what your process gets to touch)
  • --ignore <N> [default: 0] — ignore up to N cores 🙈 she just pretends they're not there
  • -h, --help — print help 🎀 (the classic)
  • -V, --version — print version ⭐

👑 VERSION 👑

v(uutils coreutils) 0.12.0

she's still growing, okay? 👑

🌈 EXAMPLES 🌈

display the number of available processing units: (the classic, the moment, the main character energy)

nproc

display the number of installed processing units, including any inactive ones:

nproc --all

if possible, subtract a given number of units from the returned value:

nproc --ignore count
tw: the examples are provided by the tldr-pages project <https://tldr.sh> under the CC BY 4.0 License. Please note that, as uutils is a work in progress, some examples might fail. 😭 don't be mean to her about it, she's doing her best 💜

and that's the whole page bestie!! 🌸 this was the NPROC(1) manual, dated 2026-09-25, filed under NPROC(1) at the bottom of the page like always 🎀 go forth and count your cores, slay 💅✨

📦 where this page comes from