[GHC] #9890: RTS -qa option is helpful but under-documented

#9890: RTS -qa option is helpful but under-documented -------------------------------------+------------------------------------- Reporter: adamgundry | Owner: Type: task | Status: new Priority: normal | Milestone: Component: Runtime System | Version: 7.8.3 Keywords: | Operating System: Architecture: Unknown/Multiple | Unknown/Multiple Difficulty: Unknown | Type of failure: Blocked By: | Documentation bug Related Tickets: | Test Case: | Blocking: | Differential Revisions: -------------------------------------+------------------------------------- The entire documentation for the RTS `-qa` option is Use the OS's affinity facilities to try to pin OS threads to CPU cores. This is an experimental feature, and may or may not be useful. Please let us know whether it helps for you! It does help for us: enabling it on a multithreaded, moderately GC-heavy web server led to a sizeable improvement (~20%) in throughput benchmarks. However, it would be nice if the GHC documentation was a little more descriptive about what exactly this option does and how experimental it is now considered! (Relatedly, perhaps it would be worth adding a single index of RTS options in the user's guide, much like the flag reference for GHC itself.) -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9890 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#9890: RTS -qa option is helpful but under-documented -------------------------------------+------------------------------------- Reporter: adamgundry | Owner: simonmar Type: task | Status: new Priority: normal | Milestone: 7.10.1 Component: Runtime | Version: 7.8.3 System | Keywords: Resolution: | Architecture: Unknown/Multiple Operating System: | Difficulty: Unknown Unknown/Multiple | Blocked By: Type of failure: | Related Tickets: Documentation bug | Test Case: | Blocking: | Differential Revisions: | -------------------------------------+------------------------------------- Changes (by simonmar): * owner: => simonmar * milestone: => 7.10.1 Comment: I'll improve the docs here. It's still experimental in the sense that you should experiment with it and see if it helps :) Thanks for the feedback. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9890#comment:1 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#9890: RTS -qa option is helpful but under-documented
-------------------------------------+-------------------------------------
Reporter: adamgundry | Owner: simonmar
Type: task | Status: new
Priority: normal | Milestone: 7.12.1
Component: Runtime System | Version: 7.8.3
Resolution: | Keywords:
Operating System: Unknown/Multiple | Architecture:
Type of failure: Documentation | Unknown/Multiple
bug | Test Case:
Blocked By: | Blocking:
Related Tickets: | Differential Revisions:
-------------------------------------+-------------------------------------
Comment (by Simon Marlow

#9890: RTS -qa option is helpful but under-documented -------------------------------------+------------------------------------- Reporter: adamgundry | Owner: simonmar Type: task | Status: merge Priority: normal | Milestone: 7.10.1 Component: Runtime System | Version: 7.8.3 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Revisions: -------------------------------------+------------------------------------- Changes (by hvr): * status: new => merge -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9890#comment:4 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#9890: RTS -qa option is helpful but under-documented -------------------------------------+------------------------------------- Reporter: adamgundry | Owner: simonmar Type: task | Status: closed Priority: normal | Milestone: 7.10.1 Component: Runtime System | Version: 7.8.3 Resolution: fixed | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Revisions: -------------------------------------+------------------------------------- Changes (by hvr): * status: merge => closed * resolution: => fixed Comment: merged to 7.10 with bb56695b98b20d0e28a30b360265e2b147cc2f24 -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9890#comment:5 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#9890: RTS -qa option is helpful but under-documented -------------------------------------+------------------------------------- Reporter: adamgundry | Owner: Type: task | Status: new Priority: normal | Milestone: 8.0.2 Component: Runtime System | Version: 7.8.3 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D2850 Wiki Page: | -------------------------------------+------------------------------------- Changes (by bgamari): * owner: simonmar => * status: closed => new * differential: => Phab:D2850 * resolution: fixed => * milestone: 7.10.1 => 8.0.2 Comment: It turns out that there is actually **still** no mention of this flag in the users guide. Here's a patch to fix this. -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9890#comment:6 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#9890: RTS -qa option is helpful but under-documented -------------------------------------+------------------------------------- Reporter: adamgundry | Owner: Type: task | Status: patch Priority: normal | Milestone: 8.0.2 Component: Runtime System | Version: 7.8.3 Resolution: | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D2850 Wiki Page: | -------------------------------------+------------------------------------- Changes (by bgamari): * status: new => patch -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9890#comment:7 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler

#9890: RTS -qa option is helpful but under-documented -------------------------------------+------------------------------------- Reporter: adamgundry | Owner: Type: task | Status: closed Priority: normal | Milestone: 8.0.2 Component: Runtime System | Version: 7.8.3 Resolution: fixed | Keywords: Operating System: Unknown/Multiple | Architecture: Type of failure: Documentation | Unknown/Multiple bug | Test Case: Blocked By: | Blocking: Related Tickets: | Differential Rev(s): Phab:D2850 Wiki Page: | -------------------------------------+------------------------------------- Changes (by bgamari): * status: patch => closed * resolution: => fixed Comment: It turns out that there is in fact [[https://phabricator.haskell.org/diffusion/GHC/browse/master/docs/users_guide /using- concurrent.rst;52c5e55348170f27f5ef1cb010c4c96ab4aa47cc$153-165|documentation]] for this flag -- Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/9890#comment:8 GHC http://www.haskell.org/ghc/ The Glasgow Haskell Compiler
participants (1)
-
GHC