runtime

package runtime主要是与go的runtime系统进行互动操作，例如控制goroutine的函数等。它也包含reflect package所需的低等级信息。

1. Environment Variables
GOGC: 设置初始的垃圾回收百分比。默认值为GOGC=100；如果设置GOGC=off，则会完全关闭垃圾回收功能。runtime/debug package的SetGCPercent函数可以在运行时改变其值。

GOGCTRACE: 从垃圾回收处控制debug输出。

GOMAXPROCS : 控制同时运行用户态go程序的操作系统线程数。

GOTRACEBACK : 控制错误导致的输出数量。

GOARCH, GOOS, GOPATH, GOROOT: 386或amd64、linux或windows、开发目录、安装目录。

Index

• Constants
• Variables
• func BlockProfile(p []BlockProfileRecord) (n int, ok bool)
• func Breakpoint()
• func CPUProfile() []byte
• func Caller(skip int) (pc uintptr, file string, line int, ok bool)
• func Callers(skip int, pc []uintptr) int
• func GC()
• func GOMAXPROCS(n int) int
• func GOROOT() string
• func Goexit()
• func GoroutineProfile(p []StackRecord) (n int, ok bool)
• func Gosched()
• func LockOSThread()
• func MemProfile(p []MemProfileRecord, inuseZero bool) (n int, ok bool)
• func NumCPU() int
• func NumCgoCall() int64
• func NumGoroutine() int
• func ReadMemStats(m *MemStats)
• func SetBlockProfileRate(rate int)
• func SetCPUProfileRate(hz int)
• func SetFinalizer(x, f interface{})
• func Stack(buf []byte, all bool) int
• func ThreadCreateProfile(p []StackRecord) (n int, ok bool)
• func UnlockOSThread()
• func Version() string
• type BlockProfileRecord
• type Error
• type Func

   

  • func FuncForPC(pc uintptr) *Func
  • func (f *Func) Entry() uintptr
  • func (f *Func) FileLine(pc uintptr) (file string, line int)
  • func (f *Func) Name() string
• type MemProfileRecord

   

  • func (r *MemProfileRecord) InUseBytes() int64
  • func (r *MemProfileRecord) InUseObjects() int64
  • func (r *MemProfileRecord) Stack() []uintptr
• type MemStats
• type StackRecord

   

  • func (r *StackRecord) Stack() []uintptr
• type TypeAssertionError

   

  • func (e *TypeAssertionError) Error() string
  • func (*TypeAssertionError) RuntimeError()

Package Files

compiler.go debug.go error.go extern.go mem.go mgc0.go softfloat64.go type.go

2. 基本函数

func GC

func GC()

运行垃圾回收。

func NumCPU

func NumCPU() int

返回本地主机的逻辑CPU数量。

func GOMAXPROCS

func GOMAXPROCS(n int) int

设置可以同时进行运算的CPU数量；如果n<1，则不改变当前设置；可以通过上面的NumCPU函数获得参数n。

func Goexit

func Goexit()

终止调用它的goroutine；其它goroutine不受影响。

func Gosched

func Gosched()

调用此函数的goroutine会主动放弃处理器，让其它goroutine使用此处理其，最初的goroutine排队等待被执行。

func NumGoroutine

func NumGoroutine() int

返回当前存在的goroutine数量。

3. type Func

type Func

type Func struct { // contains filtered or unexported fields }

func (*Func) Entry

func (f *Func) Entry() uintptr

返回函数的入口地址。

func (*Func) FileLine

func (f *Func) FileLine(pc uintptr) (file string, line int)

根据程序的入口地址pc，返回文件名及源代码行数。

func (*Func) Name

func (f *Func) Name() string

返回函数名。

4. type MemStats

type MemStats struct {
    // General statistics.
    Alloc      uint64 // bytes allocated and still in use
    TotalAlloc uint64 // bytes allocated (even if freed) Sys uint64 // bytes obtained from system (should be sum of XxxSys below) Lookups uint64 // number of pointer lookups Mallocs uint64 // number of mallocs Frees uint64 // number of frees // Main allocation heap statistics. HeapAlloc uint64 // bytes allocated and still in use HeapSys uint64 // bytes obtained from system HeapIdle uint64 // bytes in idle spans HeapInuse uint64 // bytes in non-idle span HeapReleased uint64 // bytes released to the OS HeapObjects uint64 // total number of allocated objects // Low-level fixed-size structure allocator statistics. // Inuse is bytes used now. // Sys is bytes obtained from system. StackInuse uint64 // bootstrap stacks StackSys uint64 MSpanInuse uint64 // mspan structures MSpanSys uint64 MCacheInuse uint64 // mcache structures MCacheSys uint64 BuckHashSys uint64 // profiling bucket hash table // Garbage collector statistics. NextGC uint64 // next run in HeapAlloc time (bytes) LastGC uint64 // last run in absolute time (ns) PauseTotalNs uint64 PauseNs [256]uint64 // circular buffer of recent GC pause times, most recent at [(NumGC+255)%256] NumGC uint32 EnableGC bool DebugGC bool // Per-size allocation statistics. // 61 is NumSizeClasses in the C code. BySize [61]struct { Size uint32 Mallocs uint64 Frees uint64 } } 

记录所统计的内存分配情况。

转载于:https://www.cnblogs.com/pyrene/p/8804461.html