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