qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-23 06:40:05 -07:00
Code Releases Activity

doc: rearrange the description of GOMAXPROCS

Browse Source 
The old text was written when it was only 1 by default, which
changed a long time ago.

Also add a note that GOMAXPROCS does not limit the total
number of threads.

Change-Id: I104ccd7266d11335320a4d7f5671fb09ed641f88
Reviewed-on: https://go-review.googlesource.com/123916
Reviewed-by: Ian Lance Taylor <iant@golang.org>
This commit is contained in:
Rob Pike 2018-07-13 09:08:13 +10:00
parent 2598ed0758
commit ca69a916ca
1 changed files with 44 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
doc/go_faq.html
View File

@ -1437,7 +1437,7 @@ Do not communicate by sharing memory. Instead, share memory by communicating.
<p> <p>
See the <a href="/doc/codewalk/sharemem/">Share Memory By Communicating</a> code walk See the <a href="/doc/codewalk/sharemem/">Share Memory By Communicating</a> code walk
and its <a href="//blog.golang.org/2010/07/share-memory-by-communicating.html"> and its <a href="https://blog.golang.org/2010/07/share-memory-by-communicating.html">
associated article</a> for a detailed discussion of this concept. associated article</a> for a detailed discussion of this concept.
</p> </p>
@ -1445,8 +1445,42 @@ associated article</a> for a detailed discussion of this concept.
Large concurrent programs are likely to borrow from both these toolkits. Large concurrent programs are likely to borrow from both these toolkits.
</p> </p>
<h3 id="Why_no_multi_CPU"> <h3 id="parallel_slow">
Why doesn't my multi-goroutine program use multiple CPUs?</h3> Why doesn't my program run faster with more CPUs?</h3>
<p>
Whether a program runs faster with more CPUs depends on the problem
it is solving.
The Go language provides concurrency primitives, such as goroutines
and channels, but concurrency only enables parallelism
when the underlying problem is intrinsically parallel.
Problems that are intrinsically sequential cannot be sped up by adding
more CPUs, while those that can be broken into pieces that can
execute in parallel can be sped up, sometimes dramatically.
</p>
<p>
Sometimes adding more CPUs can slow a program down.
In practical terms, programs that spend more time
synchronizing or communicating than doing useful computation
may experience performance degradation when using
multiple OS threads.
This is because passing data between threads involves switching
contexts, which has significant cost, and that cost can increase
with more CPUs.
For instance, the <a href="/ref/spec#An_example_package">prime sieve example</a>
from the Go specification has no significant parallelism although it launches many
goroutines; increasing the number of threads (CPUs) is more likely to slow it down than
to speed it up.
</p>
<p>
For more detail on this topic see the talk entitled
<a href="//blog.golang.org/2013/01/concurrency-is-not-parallelism.html">Concurrency
is not Parallelism</a>.
<h3 id="number_cpus">
How can I control the number of CPUs?</h3>
<p> <p>
The number of CPUs available simultaneously to executing goroutines is The number of CPUs available simultaneously to executing goroutines is
@ -1464,50 +1498,22 @@ forcing independent goroutines to take turns executing.
</p> </p>
<p> <p>
Programs that perform parallel computation might benefit from a further increase in The runtime can allocate more threads than the value
<code>GOMAXPROCS</code>. of <code>GOMAXPROCS</code> to service multiple outstanding
However, be aware that I/O requests.
<a href="//blog.golang.org/2013/01/concurrency-is-not-parallelism.html">concurrency <code>GOMAXPROCS</code> only affects how many goroutines
is not parallelism</a>. can actually execute at once; arbitrarily more may be blocked
</p> in system calls.
<h3 id="Why_GOMAXPROCS">
Why does using <code>GOMAXPROCS</code> &gt; 1 sometimes make my program
slower?</h3>
<p>
It depends on the nature of your program.
Problems that are intrinsically sequential cannot be sped up by adding
more goroutines.
Concurrency only becomes parallelism when the problem is
intrinsically parallel.
</p>
<p>
In practical terms, programs that spend more time
synchronizing or communicating than doing useful computation
may experience performance degradation when using
multiple OS threads.
This is because passing data between threads involves switching
contexts, which has significant cost.
For instance, the <a href="/ref/spec#An_example_package">prime sieve example</a>
from the Go specification has no significant parallelism although it launches many
goroutines; increasing <code>GOMAXPROCS</code> is more likely to slow it down than
to speed it up.
</p> </p>
<p> <p>
Go's goroutine scheduler is not as good as it needs to be, although it Go's goroutine scheduler is not as good as it needs to be, although it
has improved in recent releases. has improved over time.
In the future, it may better optimize its use of OS threads. In the future, it may better optimize its use of OS threads.
For now, if there are performance issues, For now, if there are performance issues,
setting <code>GOMAXPROCS</code> on a per-application basis may help. setting <code>GOMAXPROCS</code> on a per-application basis may help.
</p> </p>
<p>
For more detail on this topic see the talk entitled,
<a href="//blog.golang.org/2013/01/concurrency-is-not-parallelism.html">Concurrency
is not Parallelism</a>.
<h3 id="no_goroutine_id"> <h3 id="no_goroutine_id">
Why is there no goroutine ID?</h3> Why is there no goroutine ID?</h3>