bug#80243: nproc help (--help / man page) should mention OMP_NUM_THREADS and OMP_THREAD_LIMIT
Pádraig Brady <[email protected]> Fri, 23 Jan 2026 19:00:07 +0000
| Newsgroups | gmane.comp.gnu.core-utils.bugs |
|---|---|
| Message-ID | <[email protected]> |
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.
thanks,
Padraig