bug-coreutils
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#80243: nproc help (--help / man page) should mention OMP_NUM_THREADS


From: Pádraig Brady
Subject: bug#80243: nproc help (--help / man page) should mention OMP_NUM_THREADS and OMP_THREAD_LIMIT
Date: Sat, 24 Jan 2026 13:52:43 +0000
User-agent: Mozilla Thunderbird Beta

On 23/01/2026 19:00, Pádraig Brady wrote:
On 23/01/2026 18:40, Vincent Lefevre wrote:
The nproc output is affected by the OMP_NUM_THREADS and OMP_THREAD_LIMIT
environment variables (except with the --all option). This is completely
unintuitive:
    * The short description of nproc ("print the number of processing
      units available" / "Print the number of available processors")
      does not even mention threading, for a good reason as it is not
      necessarily related to multithreading:
    * For instance, one may want to run several processes in parallel,
      each being set to single-threaded by using OMP_NUM_THREADS=1.

So the --help text (which also corresponds to the nproc(1) man page)
should mention the the effect of these environment variables.


We do mention this in the full manual,
but yes I agree we should add it to the summary --help and man page.
The existing text in the info manual is succinct enough,
so I'll use that.

Pushed this change at:
https://github.com/coreutils/coreutils/commit/1361ade5c

Marking this as done.

cheers,
Padraig





reply via email to

[Prev in Thread] Current Thread [Next in Thread]