github.com/cockroachdb/cockroach@v20.2.0-alpha.1+incompatible/pkg/util/growstack/growstack.go (about)

     1  // Copyright 2019 The Cockroach Authors.
     2  //
     3  // Use of this software is governed by the Business Source License
     4  // included in the file licenses/BSL.txt.
     5  //
     6  // As of the Change Date specified in that file, in accordance with
     7  // the Business Source License, use of this software will be governed
     8  // by the Apache License, Version 2.0, included in the file
     9  // licenses/APL.txt.
    10  
    11  package growstack
    12  
    13  // Grow grows the goroutine stack by 16 KB. Goroutine stacks currently start
    14  // at 2 KB in size. The code paths through the storage package often need a
    15  // stack that is 32 KB in size. The stack growth is mildly expensive making it
    16  // useful to trick the runtime into growing the stack early. Since goroutine
    17  // stacks grow in multiples of 2 and start at 2 KB in size, by placing a 16 KB
    18  // object on the stack early in the lifetime of a goroutine we force the
    19  // runtime to use a 32 KB stack for the goroutine.
    20  func Grow()