Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 821529 - sys-apps/portage manpage 5 make.conf: -jx up to date?
Summary: sys-apps/portage manpage 5 make.conf: -jx up to date?
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Documentation (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Portage team
Depends on:
Reported: 2021-11-03 21:43 UTC by korte
Modified: 2021-11-04 00:03 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Note You need to log in before you can comment on or make changes to this bug.
Description korte 2021-11-03 21:43:10 UTC
Is the following paragraph from man 5 make.conf up to date?

              Use  this  variable  if  you  want  to  use  parallel  make.  For example, if you have a dual-processor system, set this variable to "-j2" or "-j3" for  enhanced  build  performance  with  many packages. Suggested settings are between CPUs+1 and 2*CPUs+1. In order to avoid excess load, the --load-average option is recommended.  For  more  information, see  make(1). Also see emerge(1) for information about analogous --jobs and --load-average options.

It would be nice if there could be a hint about lowering the number of threads if there are out of memory problems, e.g.:

If you experience out of memory problems when running emerge, lower the number of threads in make.conf or on a per package base in package.env . Most packages will be merged without memory problems if you limit the thread count to RAM/2GB.

See also:
Comment 1 Sam James archtester Gentoo Infrastructure gentoo-dev Security 2021-11-04 00:03:37 UTC
Yeah, this is inconsistent with modern advice, which is:
jobs=min(RAM/2GB, threads)
... given modern compiler (often C++) jobs can take up to 2GB per job.