mirror of
https://github.com/golang/go
synced 2024-11-19 17:14:44 -07:00
62 lines
2.6 KiB
Go
62 lines
2.6 KiB
Go
// Copyright 2009 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
/*
|
|
The runtime package contains operations that interact with Go's runtime system,
|
|
such as functions to control goroutines. It also includes the low-level type information
|
|
used by the reflect package; see reflect's documentation for the programmable
|
|
interface to the run-time type system.
|
|
*/
|
|
package runtime
|
|
|
|
// These functions are implemented in the base runtime library, ../../runtime/.
|
|
|
|
// Gosched yields the processor, allowing other goroutines to run. It does not
|
|
// suspend the current goroutine, so execution resumes automatically.
|
|
func Gosched()
|
|
|
|
// Goexit terminates the goroutine that calls it. No other goroutine is affected.
|
|
func Goexit()
|
|
|
|
// Breakpoint() executes a breakpoint trap.
|
|
func Breakpoint()
|
|
|
|
// Caller reports file and line number information about function invocations on
|
|
// the calling goroutine's stack. The argument is the number of stack frames to
|
|
// ascend, with 1 identifying the the caller of Caller. The return values report the
|
|
// program counter, file name, and line number within the file of the corresponding
|
|
// call. The boolean ok is false if it was not possible to recover the information.
|
|
func Caller(n int) (pc uintptr, file string, line int, ok bool)
|
|
|
|
// mid returns the current os thread (m) id.
|
|
func mid() uint32
|
|
|
|
// LockOSThread wires the calling goroutine to its current operating system thread.
|
|
// Until the calling goroutine exits or calls UnlockOSThread, it will always
|
|
// execute in that thread, and no other goroutine can.
|
|
// LockOSThread cannot be used during init functions.
|
|
func LockOSThread()
|
|
|
|
// UnlockOSThread unwires the calling goroutine from its fixed operating system thread.
|
|
// If the calling goroutine has not called LockOSThread, UnlockOSThread is a no-op.
|
|
func UnlockOSThread()
|
|
|
|
// GOMAXPROCS sets the maximum number of CPUs that can be executing
|
|
// simultaneously. This call will go away when the scheduler improves.
|
|
func GOMAXPROCS(n int)
|
|
|
|
// Cgocalls returns the number of cgo calls made by the current process.
|
|
func Cgocalls() int64
|
|
|
|
// Semacquire waits until *s > 0 and then atomically decrements it.
|
|
// It is intended as a simple sleep primitive for use by the synchronization
|
|
// library and should not be used directly.
|
|
func Semacquire(s *uint32)
|
|
|
|
// Semrelease atomically increments *s and notifies a waiting goroutine
|
|
// if one is blocked in Semacquire.
|
|
// It is intended as a simple wakeup primitive for use by the synchronization
|
|
// library and should not be used directly.
|
|
func Semrelease(s *uint32)
|