Three documentations inaccuracies related to concurrency.
The help info below is wrong. The default is the actual number of cores, or something close.
~/waste/threadscope-sparkgraph-demo75$ ./parlist +RTS -N2 -lg -s -asdfasdf
parlist: unknown RTS option: -asdfasdf
[...]
parlist: -N<n> Use <n> processors (default: 1)
Here:
http://www.haskell.org/ghc/docs/latest/html/users_guide/using-smp.html
the first sentence of the following is wrong and could be just removed.
There is no means (currently) by which this value may vary after the program has started.
The current value of the -N option is available to the Haskell program via GHC.Conc.getNumCapabilities, and it may be changed while the program is running by calling GHC.Conc.setNumCapabilities. Note: in the current implementation, the -N value may only be increased, not decreased, by calling GHC.Conc.setNumCapabilities.
Neither here
http://www.haskell.org/ghc/docs/latest/html/users_guide/using-concurrent.html
nor on first page of the docs it refers to:
http://www.haskell.org/ghc/docs/latest/html/libraries/base-4.5.0.0/Control-Concurrent.html
is there any hint about the possibility and advantages of using "-threaded" and "+RTS -N". It may be misleading to the users that specifically seek an information about any extra flags they need to start using multiple cores or non-blocking FFI calls.
Trac metadata
Trac field | Value |
---|---|
Version | 7.4.1 |
Type | Bug |
TypeOfFailure | OtherFailure |
Priority | normal |
Resolution | Unresolved |
Component | Documentation |
Test case | |
Differential revisions | |
BlockedBy | |
Related | |
Blocking | |
CC | |
Operating system | |
Architecture |