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

Pádraig Brady <[email protected]> Sat, 24 Jan 2026 13:52:43 +0000
Newsgroups gmane.comp.gnu.core-utils.bugs
Message-ID <[email protected]>
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