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