export_test.go

     1  // Copyright 2010 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // Export guts for testing.
     6  
     7  package runtime
     8  
     9  import (
    10  	"internal/abi"
    11  	"internal/goarch"
    12  	"internal/goos"
    13  	"internal/runtime/atomic"
    14  	"internal/runtime/gc"
    15  	"internal/runtime/maps"
    16  	"internal/runtime/sys"
    17  	"unsafe"
    18  )
    19  
    20  var Fadd64 = fadd64
    21  var Fsub64 = fsub64
    22  var Fmul64 = fmul64
    23  var Fdiv64 = fdiv64
    24  var F64to32 = f64to32
    25  var F32to64 = f32to64
    26  var Fcmp64 = fcmp64
    27  var Fintto64 = fintto64
    28  var F64toint = f64toint
    29  
    30  var Entersyscall = entersyscall
    31  var Exitsyscall = exitsyscall
    32  var LockedOSThread = lockedOSThread
    33  var Xadduintptr = atomic.Xadduintptr
    34  
    35  var ReadRandomFailed = &readRandomFailed
    36  
    37  var Fastlog2 = fastlog2
    38  
    39  var ParseByteCount = parseByteCount
    40  
    41  var Nanotime = nanotime
    42  var Cputicks = cputicks
    43  var CyclesPerSecond = pprof_cyclesPerSecond
    44  var NetpollBreak = netpollBreak
    45  var Usleep = usleep
    46  
    47  var PhysPageSize = physPageSize
    48  var PhysHugePageSize = physHugePageSize
    49  
    50  var NetpollGenericInit = netpollGenericInit
    51  
    52  var Memmove = memmove
    53  var MemclrNoHeapPointers = memclrNoHeapPointers
    54  
    55  var CgoCheckPointer = cgoCheckPointer
    56  
    57  const CrashStackImplemented = crashStackImplemented
    58  
    59  const TracebackInnerFrames = tracebackInnerFrames
    60  const TracebackOuterFrames = tracebackOuterFrames
    61  
    62  var LockPartialOrder = lockPartialOrder
    63  
    64  type TimeTimer = timeTimer
    65  
    66  type LockRank lockRank
    67  
    68  func (l LockRank) String() string {
    69  	return lockRank(l).String()
    70  }
    71  
    72  const PreemptMSupported = preemptMSupported
    73  
    74  type LFNode struct {
    75  	Next    uint64
    76  	Pushcnt uintptr
    77  }
    78  
    79  func LFStackPush(head *uint64, node *LFNode) {
    80  	(*lfstack)(head).push((*lfnode)(unsafe.Pointer(node)))
    81  }
    82  
    83  func LFStackPop(head *uint64) *LFNode {
    84  	return (*LFNode)((*lfstack)(head).pop())
    85  }
    86  func LFNodeValidate(node *LFNode) {
    87  	lfnodeValidate((*lfnode)(unsafe.Pointer(node)))
    88  }
    89  
    90  func Netpoll(delta int64) {
    91  	systemstack(func() {
    92  		netpoll(delta)
    93  	})
    94  }
    95  
    96  func PointerMask(x any) (ret []byte) {
    97  	systemstack(func() {
    98  		ret = pointerMask(x)
    99  	})
   100  	return
   101  }
   102  
   103  func RunSchedLocalQueueTest() {
   104  	pp := new(p)
   105  	gs := make([]g, len(pp.runq))
   106  	Escape(gs) // Ensure gs doesn't move, since we use guintptrs
   107  	for i := 0; i < len(pp.runq); i++ {
   108  		if g, _ := runqget(pp); g != nil {
   109  			throw("runq is not empty initially")
   110  		}
   111  		for j := 0; j < i; j++ {
   112  			runqput(pp, &gs[i], false)
   113  		}
   114  		for j := 0; j < i; j++ {
   115  			if g, _ := runqget(pp); g != &gs[i] {
   116  				print("bad element at iter ", i, "/", j, "\n")
   117  				throw("bad element")
   118  			}
   119  		}
   120  		if g, _ := runqget(pp); g != nil {
   121  			throw("runq is not empty afterwards")
   122  		}
   123  	}
   124  }
   125  
   126  func RunSchedLocalQueueStealTest() {
   127  	p1 := new(p)
   128  	p2 := new(p)
   129  	gs := make([]g, len(p1.runq))
   130  	Escape(gs) // Ensure gs doesn't move, since we use guintptrs
   131  	for i := 0; i < len(p1.runq); i++ {
   132  		for j := 0; j < i; j++ {
   133  			gs[j].sig = 0
   134  			runqput(p1, &gs[j], false)
   135  		}
   136  		gp := runqsteal(p2, p1, true)
   137  		s := 0
   138  		if gp != nil {
   139  			s++
   140  			gp.sig++
   141  		}
   142  		for {
   143  			gp, _ = runqget(p2)
   144  			if gp == nil {
   145  				break
   146  			}
   147  			s++
   148  			gp.sig++
   149  		}
   150  		for {
   151  			gp, _ = runqget(p1)
   152  			if gp == nil {
   153  				break
   154  			}
   155  			gp.sig++
   156  		}
   157  		for j := 0; j < i; j++ {
   158  			if gs[j].sig != 1 {
   159  				print("bad element ", j, "(", gs[j].sig, ") at iter ", i, "\n")
   160  				throw("bad element")
   161  			}
   162  		}
   163  		if s != i/2 && s != i/2+1 {
   164  			print("bad steal ", s, ", want ", i/2, " or ", i/2+1, ", iter ", i, "\n")
   165  			throw("bad steal")
   166  		}
   167  	}
   168  }
   169  
   170  func RunSchedLocalQueueEmptyTest(iters int) {
   171  	// Test that runq is not spuriously reported as empty.
   172  	// Runq emptiness affects scheduling decisions and spurious emptiness
   173  	// can lead to underutilization (both runnable Gs and idle Ps coexist
   174  	// for arbitrary long time).
   175  	done := make(chan bool, 1)
   176  	p := new(p)
   177  	gs := make([]g, 2)
   178  	Escape(gs) // Ensure gs doesn't move, since we use guintptrs
   179  	ready := new(uint32)
   180  	for i := 0; i < iters; i++ {
   181  		*ready = 0
   182  		next0 := (i & 1) == 0
   183  		next1 := (i & 2) == 0
   184  		runqput(p, &gs[0], next0)
   185  		go func() {
   186  			for atomic.Xadd(ready, 1); atomic.Load(ready) != 2; {
   187  			}
   188  			if runqempty(p) {
   189  				println("next:", next0, next1)
   190  				throw("queue is empty")
   191  			}
   192  			done <- true
   193  		}()
   194  		for atomic.Xadd(ready, 1); atomic.Load(ready) != 2; {
   195  		}
   196  		runqput(p, &gs[1], next1)
   197  		runqget(p)
   198  		<-done
   199  		runqget(p)
   200  	}
   201  }
   202  
   203  var (
   204  	StringHash = stringHash
   205  	BytesHash  = bytesHash
   206  	Int32Hash  = int32Hash
   207  	Int64Hash  = int64Hash
   208  	MemHash    = memhash
   209  	MemHash32  = memhash32
   210  	MemHash64  = memhash64
   211  	EfaceHash  = efaceHash
   212  	IfaceHash  = ifaceHash
   213  )
   214  
   215  var MinAeshashSize = &maps.MinAeshashSize
   216  
   217  var AeshashEnabled = maps.AeshashEnabled
   218  
   219  func MemclrBytes(b []byte) {
   220  	s := (*slice)(unsafe.Pointer(&b))
   221  	memclrNoHeapPointers(s.array, uintptr(s.len))
   222  }
   223  
   224  const HashLoad = hashLoad
   225  
   226  // entry point for testing
   227  func GostringW(w []uint16) (s string) {
   228  	systemstack(func() {
   229  		s = gostringw(&w[0])
   230  	})
   231  	return
   232  }
   233  
   234  var Open = open
   235  var Close = closefd
   236  var Read = read
   237  var Write = write
   238  
   239  func Envs() []string     { return envs }
   240  func SetEnvs(e []string) { envs = e }
   241  
   242  const PtrSize = goarch.PtrSize
   243  
   244  const ClobberdeadPtr = clobberdeadPtr
   245  
   246  func Clobberfree() bool {
   247  	return debug.clobberfree != 0
   248  }
   249  
   250  var ForceGCPeriod = &forcegcperiod
   251  
   252  // SetTracebackEnv is like runtime/debug.SetTraceback, but it raises
   253  // the "environment" traceback level, so later calls to
   254  // debug.SetTraceback (e.g., from testing timeouts) can't lower it.
   255  func SetTracebackEnv(level string) {
   256  	setTraceback(level)
   257  	traceback_env = traceback_cache
   258  }
   259  
   260  var ReadUnaligned64 = readUnaligned64
   261  
   262  func CountPagesInUse() (pagesInUse, counted uintptr) {
   263  	stw := stopTheWorld(stwForTestCountPagesInUse)
   264  
   265  	pagesInUse = mheap_.pagesInUse.Load()
   266  
   267  	for _, s := range mheap_.allspans {
   268  		if s.state.get() == mSpanInUse {
   269  			counted += s.npages
   270  		}
   271  	}
   272  
   273  	startTheWorld(stw)
   274  
   275  	return
   276  }
   277  
   278  func Blocksampled(cycles, rate int64) bool { return blocksampled(cycles, rate) }
   279  
   280  func Cheaprand() uint32         { return cheaprand() }
   281  func Cheaprand64() int64        { return cheaprand64() }
   282  func Fastrand() uint32          { return uint32(rand()) }
   283  func Fastrand64() uint64        { return rand() }
   284  func Fastrandn(n uint32) uint32 { return randn(n) }
   285  
   286  type ProfBuf profBuf
   287  
   288  func NewProfBuf(hdrsize, bufwords, tags int) *ProfBuf {
   289  	return (*ProfBuf)(newProfBuf(hdrsize, bufwords, tags))
   290  }
   291  
   292  func (p *ProfBuf) Write(tag *unsafe.Pointer, now int64, hdr []uint64, stk []uintptr) {
   293  	(*profBuf)(p).write(tag, now, hdr, stk)
   294  }
   295  
   296  const (
   297  	ProfBufBlocking    = profBufBlocking
   298  	ProfBufNonBlocking = profBufNonBlocking
   299  )
   300  
   301  func (p *ProfBuf) Read(mode profBufReadMode) ([]uint64, []unsafe.Pointer, bool) {
   302  	return (*profBuf)(p).read(mode)
   303  }
   304  
   305  func (p *ProfBuf) Close() {
   306  	(*profBuf)(p).close()
   307  }
   308  
   309  type CPUStats = cpuStats
   310  
   311  func ReadCPUStats() CPUStats {
   312  	return work.cpuStats
   313  }
   314  
   315  func ReadMetricsSlow(memStats *MemStats, samplesp unsafe.Pointer, len, cap int) {
   316  	stw := stopTheWorld(stwForTestReadMetricsSlow)
   317  
   318  	// Initialize the metrics beforehand because this could
   319  	// allocate and skew the stats.
   320  	metricsLock()
   321  	initMetrics()
   322  
   323  	systemstack(func() {
   324  		// Donate the racectx to g0. readMetricsLocked calls into the race detector
   325  		// via map access.
   326  		getg().racectx = getg().m.curg.racectx
   327  
   328  		// Read the metrics once before in case it allocates and skews the metrics.
   329  		// readMetricsLocked is designed to only allocate the first time it is called
   330  		// with a given slice of samples. In effect, this extra read tests that this
   331  		// remains true, since otherwise the second readMetricsLocked below could
   332  		// allocate before it returns.
   333  		readMetricsLocked(samplesp, len, cap)
   334  
   335  		// Read memstats first. It's going to flush
   336  		// the mcaches which readMetrics does not do, so
   337  		// going the other way around may result in
   338  		// inconsistent statistics.
   339  		readmemstats_m(memStats)
   340  
   341  		// Read metrics again. We need to be sure we're on the
   342  		// system stack with readmemstats_m so that we don't call into
   343  		// the stack allocator and adjust metrics between there and here.
   344  		readMetricsLocked(samplesp, len, cap)
   345  
   346  		// Undo the donation.
   347  		getg().racectx = 0
   348  	})
   349  	metricsUnlock()
   350  
   351  	startTheWorld(stw)
   352  }
   353  
   354  var DoubleCheckReadMemStats = &doubleCheckReadMemStats
   355  
   356  // ReadMemStatsSlow returns both the runtime-computed MemStats and
   357  // MemStats accumulated by scanning the heap.
   358  func ReadMemStatsSlow() (base, slow MemStats) {
   359  	stw := stopTheWorld(stwForTestReadMemStatsSlow)
   360  
   361  	// Run on the system stack to avoid stack growth allocation.
   362  	systemstack(func() {
   363  		// Make sure stats don't change.
   364  		getg().m.mallocing++
   365  
   366  		readmemstats_m(&base)
   367  
   368  		// Initialize slow from base and zero the fields we're
   369  		// recomputing.
   370  		slow = base
   371  		slow.Alloc = 0
   372  		slow.TotalAlloc = 0
   373  		slow.Mallocs = 0
   374  		slow.Frees = 0
   375  		slow.HeapReleased = 0
   376  		var bySize [gc.NumSizeClasses]struct {
   377  			Mallocs, Frees uint64
   378  		}
   379  
   380  		// Add up current allocations in spans.
   381  		for _, s := range mheap_.allspans {
   382  			if s.state.get() != mSpanInUse {
   383  				continue
   384  			}
   385  			if s.isUnusedUserArenaChunk() {
   386  				continue
   387  			}
   388  			if sizeclass := s.spanclass.sizeclass(); sizeclass == 0 {
   389  				slow.Mallocs++
   390  				slow.Alloc += uint64(s.elemsize)
   391  			} else {
   392  				slow.Mallocs += uint64(s.allocCount)
   393  				slow.Alloc += uint64(s.allocCount) * uint64(s.elemsize)
   394  				bySize[sizeclass].Mallocs += uint64(s.allocCount)
   395  			}
   396  		}
   397  
   398  		// Add in frees by just reading the stats for those directly.
   399  		var m heapStatsDelta
   400  		memstats.heapStats.unsafeRead(&m)
   401  
   402  		// Collect per-sizeclass free stats.
   403  		var smallFree uint64
   404  		for i := 0; i < gc.NumSizeClasses; i++ {
   405  			slow.Frees += m.smallFreeCount[i]
   406  			bySize[i].Frees += m.smallFreeCount[i]
   407  			bySize[i].Mallocs += m.smallFreeCount[i]
   408  			smallFree += m.smallFreeCount[i] * uint64(gc.SizeClassToSize[i])
   409  		}
   410  		slow.Frees += m.tinyAllocCount + m.largeFreeCount
   411  		slow.Mallocs += slow.Frees
   412  
   413  		slow.TotalAlloc = slow.Alloc + m.largeFree + smallFree
   414  
   415  		for i := range slow.BySize {
   416  			slow.BySize[i].Mallocs = bySize[i].Mallocs
   417  			slow.BySize[i].Frees = bySize[i].Frees
   418  		}
   419  
   420  		for i := mheap_.pages.start; i < mheap_.pages.end; i++ {
   421  			chunk := mheap_.pages.tryChunkOf(i)
   422  			if chunk == nil {
   423  				continue
   424  			}
   425  			pg := chunk.scavenged.popcntRange(0, pallocChunkPages)
   426  			slow.HeapReleased += uint64(pg) * pageSize
   427  		}
   428  		for _, p := range allp {
   429  			// Only count scav bits for pages in the cache
   430  			pg := sys.OnesCount64(p.pcache.cache & p.pcache.scav)
   431  			slow.HeapReleased += uint64(pg) * pageSize
   432  		}
   433  
   434  		getg().m.mallocing--
   435  	})
   436  
   437  	startTheWorld(stw)
   438  	return
   439  }
   440  
   441  // ShrinkStackAndVerifyFramePointers attempts to shrink the stack of the current goroutine
   442  // and verifies that unwinding the new stack doesn't crash, even if the old
   443  // stack has been freed or reused (simulated via poisoning).
   444  func ShrinkStackAndVerifyFramePointers() {
   445  	before := stackPoisonCopy
   446  	defer func() { stackPoisonCopy = before }()
   447  	stackPoisonCopy = 1
   448  
   449  	gp := getg()
   450  	systemstack(func() {
   451  		shrinkstack(gp)
   452  	})
   453  	// If our new stack contains frame pointers into the old stack, this will
   454  	// crash because the old stack has been poisoned.
   455  	FPCallers(make([]uintptr, 1024))
   456  }
   457  
   458  type StackPoisonCopyRestore int
   459  
   460  func (s StackPoisonCopyRestore) Restore() { stackPoisonCopy = int(s) }
   461  
   462  func StackPoisonCopy() StackPoisonCopyRestore {
   463  	before := stackPoisonCopy
   464  	stackPoisonCopy = 1
   465  	return StackPoisonCopyRestore(before)
   466  }
   467  
   468  // BlockOnSystemStack switches to the system stack, prints "x\n" to
   469  // stderr, and blocks in a stack containing
   470  // "runtime.blockOnSystemStackInternal".
   471  func BlockOnSystemStack() {
   472  	systemstack(blockOnSystemStackInternal)
   473  }
   474  
   475  func blockOnSystemStackInternal() {
   476  	print("x\n")
   477  	lock(&deadlock)
   478  	lock(&deadlock)
   479  }
   480  
   481  type RWMutex struct {
   482  	rw rwmutex
   483  }
   484  
   485  func (rw *RWMutex) Init() {
   486  	rw.rw.init(lockRankTestR, lockRankTestRInternal, lockRankTestW)
   487  }
   488  
   489  func (rw *RWMutex) RLock() {
   490  	rw.rw.rlock()
   491  }
   492  
   493  func (rw *RWMutex) RUnlock() {
   494  	rw.rw.runlock()
   495  }
   496  
   497  func (rw *RWMutex) Lock() {
   498  	rw.rw.lock()
   499  }
   500  
   501  func (rw *RWMutex) Unlock() {
   502  	rw.rw.unlock()
   503  }
   504  
   505  func LockOSCounts() (external, internal uint32) {
   506  	gp := getg()
   507  	if gp.m.lockedExt+gp.m.lockedInt == 0 {
   508  		if gp.lockedm != 0 {
   509  			panic("lockedm on non-locked goroutine")
   510  		}
   511  	} else {
   512  		if gp.lockedm == 0 {
   513  			panic("nil lockedm on locked goroutine")
   514  		}
   515  	}
   516  	return gp.m.lockedExt, gp.m.lockedInt
   517  }
   518  
   519  //go:noinline
   520  func TracebackSystemstack(stk []uintptr, i int) int {
   521  	if i == 0 {
   522  		pc, sp := sys.GetCallerPC(), sys.GetCallerSP()
   523  		var u unwinder
   524  		u.initAt(pc, sp, 0, getg(), unwindJumpStack) // Don't ignore errors, for testing
   525  		return tracebackPCs(&u, 0, stk)
   526  	}
   527  	n := 0
   528  	systemstack(func() {
   529  		n = TracebackSystemstack(stk, i-1)
   530  	})
   531  	return n
   532  }
   533  
   534  func KeepNArenaHints(n int) {
   535  	hint := mheap_.arenaHints
   536  	for i := 1; i < n; i++ {
   537  		hint = hint.next
   538  		if hint == nil {
   539  			return
   540  		}
   541  	}
   542  	hint.next = nil
   543  }
   544  
   545  // MapNextArenaHint reserves a page at the next arena growth hint,
   546  // preventing the arena from growing there, and returns the range of
   547  // addresses that are no longer viable.
   548  //
   549  // This may fail to reserve memory. If it fails, it still returns the
   550  // address range it attempted to reserve.
   551  func MapNextArenaHint() (start, end uintptr, ok bool) {
   552  	hint := mheap_.arenaHints
   553  	addr := hint.addr
   554  	if hint.down {
   555  		start, end = addr-heapArenaBytes, addr
   556  		addr -= physPageSize
   557  	} else {
   558  		start, end = addr, addr+heapArenaBytes
   559  	}
   560  	got := sysReserve(unsafe.Pointer(addr), physPageSize, "")
   561  	ok = (addr == uintptr(got))
   562  	if !ok {
   563  		// We were unable to get the requested reservation.
   564  		// Release what we did get and fail.
   565  		sysUnreserve(got, physPageSize)
   566  	}
   567  	return
   568  }
   569  
   570  func NextArenaHint() (uintptr, bool) {
   571  	if mheap_.arenaHints == nil {
   572  		return 0, false
   573  	}
   574  	return mheap_.arenaHints.addr, true
   575  }
   576  
   577  const RandomizeHeapBase = randomizeHeapBase
   578  
   579  // ArenaHintAddrs returns the heap's remaining arena hint addresses, in
   580  // chain order.
   581  func ArenaHintAddrs() []uintptr {
   582  	// Preallocate: appending while holding the heap lock would allocate
   583  	// under mheap_.lock. mallocinit generates at most 64 heap hints.
   584  	out := make([]uintptr, 0, 128)
   585  	lock(&mheap_.lock)
   586  	for h := mheap_.arenaHints; h != nil; h = h.next {
   587  		out = append(out, h.addr)
   588  	}
   589  	unlock(&mheap_.lock)
   590  	return out
   591  }
   592  
   593  type G = g
   594  
   595  type Sudog = sudog
   596  
   597  type XRegPerG = xRegPerG
   598  
   599  func Getg() *G {
   600  	return getg()
   601  }
   602  
   603  func Goid() uint64 {
   604  	return getg().goid
   605  }
   606  
   607  func GIsWaitingOnMutex(gp *G) bool {
   608  	return readgstatus(gp) == _Gwaiting && gp.waitreason.isMutexWait()
   609  }
   610  
   611  var CasGStatusAlwaysTrack = &casgstatusAlwaysTrack
   612  
   613  //go:noinline
   614  func PanicForTesting(b []byte, i int) byte {
   615  	return unexportedPanicForTesting(b, i)
   616  }
   617  
   618  //go:noinline
   619  func unexportedPanicForTesting(b []byte, i int) byte {
   620  	return b[i]
   621  }
   622  
   623  func G0StackOverflow() {
   624  	systemstack(func() {
   625  		g0 := getg()
   626  		sp := sys.GetCallerSP()
   627  		// The stack bounds for g0 stack is not always precise.
   628  		// Use an artificially small stack, to trigger a stack overflow
   629  		// without actually run out of the system stack (which may seg fault).
   630  		g0.stack.lo = sp - 4096 - stackSystem
   631  		g0.stackguard0 = g0.stack.lo + stackGuard
   632  		g0.stackguard1 = g0.stackguard0
   633  
   634  		stackOverflow(nil)
   635  	})
   636  }
   637  
   638  func stackOverflow(x *byte) {
   639  	var buf [256]byte
   640  	stackOverflow(&buf[0])
   641  }
   642  
   643  func RunGetgThreadSwitchTest() {
   644  	// Test that getg works correctly with thread switch.
   645  	// With gccgo, if we generate getg inlined, the backend
   646  	// may cache the address of the TLS variable, which
   647  	// will become invalid after a thread switch. This test
   648  	// checks that the bad caching doesn't happen.
   649  
   650  	ch := make(chan int)
   651  	go func(ch chan int) {
   652  		ch <- 5
   653  		LockOSThread()
   654  	}(ch)
   655  
   656  	g1 := getg()
   657  
   658  	// Block on a receive. This is likely to get us a thread
   659  	// switch. If we yield to the sender goroutine, it will
   660  	// lock the thread, forcing us to resume on a different
   661  	// thread.
   662  	<-ch
   663  
   664  	g2 := getg()
   665  	if g1 != g2 {
   666  		panic("g1 != g2")
   667  	}
   668  
   669  	// Also test getg after some control flow, as the
   670  	// backend is sensitive to control flow.
   671  	g3 := getg()
   672  	if g1 != g3 {
   673  		panic("g1 != g3")
   674  	}
   675  }
   676  
   677  // Expose freegc for testing.
   678  func Freegc(p unsafe.Pointer, size uintptr, noscan bool) {
   679  	freegc(p, size, noscan)
   680  }
   681  
   682  // Expose gcAssistBytes for the current g for testing.
   683  func AssistCredit() int64 {
   684  	assistG := getg()
   685  	if assistG.m.curg != nil {
   686  		assistG = assistG.m.curg
   687  	}
   688  	return assistG.gcAssistBytes
   689  }
   690  
   691  // Expose gcBlackenEnabled for testing.
   692  func GcBlackenEnable() bool {
   693  	// Note we do a non-atomic load here.
   694  	// Some checks against gcBlackenEnabled (e.g., in mallocgc)
   695  	// are currently done via non-atomic load for performance reasons,
   696  	// but other checks are done via atomic load (e.g., in mgcmark.go),
   697  	// so interpreting this value in a test may be subtle.
   698  	return gcBlackenEnabled != 0
   699  }
   700  
   701  const SizeSpecializedMallocEnabled = sizeSpecializedMallocEnabled
   702  
   703  const RuntimeFreegcEnabled = runtimeFreegcEnabled
   704  
   705  const (
   706  	PageSize         = pageSize
   707  	PallocChunkPages = pallocChunkPages
   708  	PageAlloc64Bit   = pageAlloc64Bit
   709  	PallocSumBytes   = pallocSumBytes
   710  )
   711  
   712  // Expose pallocSum for testing.
   713  type PallocSum pallocSum
   714  
   715  func PackPallocSum(start, max, end uint) PallocSum { return PallocSum(packPallocSum(start, max, end)) }
   716  func (m PallocSum) Start() uint                    { return pallocSum(m).start() }
   717  func (m PallocSum) Max() uint                      { return pallocSum(m).max() }
   718  func (m PallocSum) End() uint                      { return pallocSum(m).end() }
   719  
   720  // Expose pallocBits for testing.
   721  type PallocBits pallocBits
   722  
   723  func (b *PallocBits) Find(npages uintptr, searchIdx uint) (uint, uint) {
   724  	return (*pallocBits)(b).find(npages, searchIdx)
   725  }
   726  func (b *PallocBits) AllocRange(i, n uint)       { (*pallocBits)(b).allocRange(i, n) }
   727  func (b *PallocBits) Free(i, n uint)             { (*pallocBits)(b).free(i, n) }
   728  func (b *PallocBits) Summarize() PallocSum       { return PallocSum((*pallocBits)(b).summarize()) }
   729  func (b *PallocBits) PopcntRange(i, n uint) uint { return (*pageBits)(b).popcntRange(i, n) }
   730  
   731  // SummarizeSlow is a slow but more obviously correct implementation
   732  // of (*pallocBits).summarize. Used for testing.
   733  func SummarizeSlow(b *PallocBits) PallocSum {
   734  	var start, most, end uint
   735  
   736  	const N = uint(len(b)) * 64
   737  	for start < N && (*pageBits)(b).get(start) == 0 {
   738  		start++
   739  	}
   740  	for end < N && (*pageBits)(b).get(N-end-1) == 0 {
   741  		end++
   742  	}
   743  	run := uint(0)
   744  	for i := uint(0); i < N; i++ {
   745  		if (*pageBits)(b).get(i) == 0 {
   746  			run++
   747  		} else {
   748  			run = 0
   749  		}
   750  		most = max(most, run)
   751  	}
   752  	return PackPallocSum(start, most, end)
   753  }
   754  
   755  // Expose non-trivial helpers for testing.
   756  func FindBitRange64(c uint64, n uint) uint { return findBitRange64(c, n) }
   757  
   758  // Given two PallocBits, returns a set of bit ranges where
   759  // they differ.
   760  func DiffPallocBits(a, b *PallocBits) []BitRange {
   761  	ba := (*pageBits)(a)
   762  	bb := (*pageBits)(b)
   763  
   764  	var d []BitRange
   765  	base, size := uint(0), uint(0)
   766  	for i := uint(0); i < uint(len(ba))*64; i++ {
   767  		if ba.get(i) != bb.get(i) {
   768  			if size == 0 {
   769  				base = i
   770  			}
   771  			size++
   772  		} else {
   773  			if size != 0 {
   774  				d = append(d, BitRange{base, size})
   775  			}
   776  			size = 0
   777  		}
   778  	}
   779  	if size != 0 {
   780  		d = append(d, BitRange{base, size})
   781  	}
   782  	return d
   783  }
   784  
   785  // StringifyPallocBits gets the bits in the bit range r from b,
   786  // and returns a string containing the bits as ASCII 0 and 1
   787  // characters.
   788  func StringifyPallocBits(b *PallocBits, r BitRange) string {
   789  	str := ""
   790  	for j := r.I; j < r.I+r.N; j++ {
   791  		if (*pageBits)(b).get(j) != 0 {
   792  			str += "1"
   793  		} else {
   794  			str += "0"
   795  		}
   796  	}
   797  	return str
   798  }
   799  
   800  // Expose pallocData for testing.
   801  type PallocData pallocData
   802  
   803  func (d *PallocData) FindScavengeCandidate(searchIdx uint, min, max uintptr) (uint, uint) {
   804  	return (*pallocData)(d).findScavengeCandidate(searchIdx, min, max)
   805  }
   806  func (d *PallocData) AllocRange(i, n uint) { (*pallocData)(d).allocRange(i, n) }
   807  func (d *PallocData) ScavengedSetRange(i, n uint) {
   808  	(*pallocData)(d).scavenged.setRange(i, n)
   809  }
   810  func (d *PallocData) PallocBits() *PallocBits {
   811  	return (*PallocBits)(&(*pallocData)(d).pallocBits)
   812  }
   813  func (d *PallocData) Scavenged() *PallocBits {
   814  	return (*PallocBits)(&(*pallocData)(d).scavenged)
   815  }
   816  
   817  // Expose fillAligned for testing.
   818  func FillAligned(x uint64, m uint) uint64 { return fillAligned(x, m) }
   819  
   820  // Expose pageCache for testing.
   821  type PageCache pageCache
   822  
   823  const PageCachePages = pageCachePages
   824  
   825  func NewPageCache(base uintptr, cache, scav uint64) PageCache {
   826  	return PageCache(pageCache{base: base, cache: cache, scav: scav})
   827  }
   828  func (c *PageCache) Empty() bool   { return (*pageCache)(c).empty() }
   829  func (c *PageCache) Base() uintptr { return (*pageCache)(c).base }
   830  func (c *PageCache) Cache() uint64 { return (*pageCache)(c).cache }
   831  func (c *PageCache) Scav() uint64  { return (*pageCache)(c).scav }
   832  func (c *PageCache) Alloc(npages uintptr) (uintptr, uintptr) {
   833  	return (*pageCache)(c).alloc(npages)
   834  }
   835  func (c *PageCache) Flush(s *PageAlloc) {
   836  	cp := (*pageCache)(c)
   837  	sp := (*pageAlloc)(s)
   838  
   839  	systemstack(func() {
   840  		// None of the tests need any higher-level locking, so we just
   841  		// take the lock internally.
   842  		lock(sp.mheapLock)
   843  		cp.flush(sp)
   844  		unlock(sp.mheapLock)
   845  	})
   846  }
   847  
   848  // Expose chunk index type.
   849  type ChunkIdx chunkIdx
   850  
   851  // Expose pageAlloc for testing. Note that because pageAlloc is
   852  // not in the heap, so is PageAlloc.
   853  type PageAlloc pageAlloc
   854  
   855  func (p *PageAlloc) Alloc(npages uintptr) (uintptr, uintptr) {
   856  	pp := (*pageAlloc)(p)
   857  
   858  	var addr, scav uintptr
   859  	systemstack(func() {
   860  		// None of the tests need any higher-level locking, so we just
   861  		// take the lock internally.
   862  		lock(pp.mheapLock)
   863  		addr, scav = pp.alloc(npages)
   864  		unlock(pp.mheapLock)
   865  	})
   866  	return addr, scav
   867  }
   868  func (p *PageAlloc) AllocToCache() PageCache {
   869  	pp := (*pageAlloc)(p)
   870  
   871  	var c PageCache
   872  	systemstack(func() {
   873  		// None of the tests need any higher-level locking, so we just
   874  		// take the lock internally.
   875  		lock(pp.mheapLock)
   876  		c = PageCache(pp.allocToCache())
   877  		unlock(pp.mheapLock)
   878  	})
   879  	return c
   880  }
   881  func (p *PageAlloc) Free(base, npages uintptr) {
   882  	pp := (*pageAlloc)(p)
   883  
   884  	systemstack(func() {
   885  		// None of the tests need any higher-level locking, so we just
   886  		// take the lock internally.
   887  		lock(pp.mheapLock)
   888  		pp.free(base, npages)
   889  		unlock(pp.mheapLock)
   890  	})
   891  }
   892  func (p *PageAlloc) Bounds() (ChunkIdx, ChunkIdx) {
   893  	return ChunkIdx((*pageAlloc)(p).start), ChunkIdx((*pageAlloc)(p).end)
   894  }
   895  func (p *PageAlloc) Scavenge(nbytes uintptr) (r uintptr) {
   896  	pp := (*pageAlloc)(p)
   897  	systemstack(func() {
   898  		r = pp.scavenge(nbytes, nil, true)
   899  	})
   900  	return
   901  }
   902  func (p *PageAlloc) InUse() []AddrRange {
   903  	ranges := make([]AddrRange, 0, len(p.inUse.ranges))
   904  	for _, r := range p.inUse.ranges {
   905  		ranges = append(ranges, AddrRange{r})
   906  	}
   907  	return ranges
   908  }
   909  
   910  // Returns nil if the PallocData's L2 is missing.
   911  func (p *PageAlloc) PallocData(i ChunkIdx) *PallocData {
   912  	ci := chunkIdx(i)
   913  	return (*PallocData)((*pageAlloc)(p).tryChunkOf(ci))
   914  }
   915  
   916  // AddrRange is a wrapper around addrRange for testing.
   917  type AddrRange struct {
   918  	addrRange
   919  }
   920  
   921  // MakeAddrRange creates a new address range.
   922  func MakeAddrRange(base, limit uintptr) AddrRange {
   923  	return AddrRange{makeAddrRange(base, limit)}
   924  }
   925  
   926  // Base returns the virtual base address of the address range.
   927  func (a AddrRange) Base() uintptr {
   928  	return a.addrRange.base.addr()
   929  }
   930  
   931  // Base returns the virtual address of the limit of the address range.
   932  func (a AddrRange) Limit() uintptr {
   933  	return a.addrRange.limit.addr()
   934  }
   935  
   936  // Equals returns true if the two address ranges are exactly equal.
   937  func (a AddrRange) Equals(b AddrRange) bool {
   938  	return a == b
   939  }
   940  
   941  // Size returns the size in bytes of the address range.
   942  func (a AddrRange) Size() uintptr {
   943  	return a.addrRange.size()
   944  }
   945  
   946  // testSysStat is the sysStat passed to test versions of various
   947  // runtime structures. We do actually have to keep track of this
   948  // because otherwise memstats.mappedReady won't actually line up
   949  // with other stats in the runtime during tests.
   950  var testSysStat = &memstats.other_sys
   951  
   952  // AddrRanges is a wrapper around addrRanges for testing.
   953  type AddrRanges struct {
   954  	addrRanges
   955  	mutable bool
   956  }
   957  
   958  // NewAddrRanges creates a new empty addrRanges.
   959  //
   960  // Note that this initializes addrRanges just like in the
   961  // runtime, so its memory is persistentalloc'd. Call this
   962  // function sparingly since the memory it allocates is
   963  // leaked.
   964  //
   965  // This AddrRanges is mutable, so we can test methods like
   966  // Add.
   967  func NewAddrRanges() AddrRanges {
   968  	r := addrRanges{}
   969  	r.init(testSysStat)
   970  	return AddrRanges{r, true}
   971  }
   972  
   973  // MakeAddrRanges creates a new addrRanges populated with
   974  // the ranges in a.
   975  //
   976  // The returned AddrRanges is immutable, so methods like
   977  // Add will fail.
   978  func MakeAddrRanges(a ...AddrRange) AddrRanges {
   979  	// Methods that manipulate the backing store of addrRanges.ranges should
   980  	// not be used on the result from this function (e.g. add) since they may
   981  	// trigger reallocation. That would normally be fine, except the new
   982  	// backing store won't come from the heap, but from persistentalloc, so
   983  	// we'll leak some memory implicitly.
   984  	ranges := make([]addrRange, 0, len(a))
   985  	total := uintptr(0)
   986  	for _, r := range a {
   987  		ranges = append(ranges, r.addrRange)
   988  		total += r.Size()
   989  	}
   990  	return AddrRanges{addrRanges{
   991  		ranges:     ranges,
   992  		totalBytes: total,
   993  		sysStat:    testSysStat,
   994  	}, false}
   995  }
   996  
   997  // Ranges returns a copy of the ranges described by the
   998  // addrRanges.
   999  func (a *AddrRanges) Ranges() []AddrRange {
  1000  	result := make([]AddrRange, 0, len(a.addrRanges.ranges))
  1001  	for _, r := range a.addrRanges.ranges {
  1002  		result = append(result, AddrRange{r})
  1003  	}
  1004  	return result
  1005  }
  1006  
  1007  // FindSucc returns the successor to base. See addrRanges.findSucc
  1008  // for more details.
  1009  func (a *AddrRanges) FindSucc(base uintptr) int {
  1010  	return a.findSucc(base)
  1011  }
  1012  
  1013  // Add adds a new AddrRange to the AddrRanges.
  1014  //
  1015  // The AddrRange must be mutable (i.e. created by NewAddrRanges),
  1016  // otherwise this method will throw.
  1017  func (a *AddrRanges) Add(r AddrRange) {
  1018  	if !a.mutable {
  1019  		throw("attempt to mutate immutable AddrRanges")
  1020  	}
  1021  	a.add(r.addrRange)
  1022  }
  1023  
  1024  // TotalBytes returns the totalBytes field of the addrRanges.
  1025  func (a *AddrRanges) TotalBytes() uintptr {
  1026  	return a.addrRanges.totalBytes
  1027  }
  1028  
  1029  // BitRange represents a range over a bitmap.
  1030  type BitRange struct {
  1031  	I, N uint // bit index and length in bits
  1032  }
  1033  
  1034  // NewPageAlloc creates a new page allocator for testing and
  1035  // initializes it with the scav and chunks maps. Each key in these maps
  1036  // represents a chunk index and each value is a series of bit ranges to
  1037  // set within each bitmap's chunk.
  1038  //
  1039  // The initialization of the pageAlloc preserves the invariant that if a
  1040  // scavenged bit is set the alloc bit is necessarily unset, so some
  1041  // of the bits described by scav may be cleared in the final bitmap if
  1042  // ranges in chunks overlap with them.
  1043  //
  1044  // scav is optional, and if nil, the scavenged bitmap will be cleared
  1045  // (as opposed to all 1s, which it usually is). Furthermore, every
  1046  // chunk index in scav must appear in chunks; ones that do not are
  1047  // ignored.
  1048  func NewPageAlloc(chunks, scav map[ChunkIdx][]BitRange) *PageAlloc {
  1049  	p := new(pageAlloc)
  1050  
  1051  	// We've got an entry, so initialize the pageAlloc.
  1052  	p.init(new(mutex), testSysStat, true)
  1053  	lockInit(p.mheapLock, lockRankMheap)
  1054  	for i, init := range chunks {
  1055  		addr := chunkBase(chunkIdx(i))
  1056  
  1057  		// Mark the chunk's existence in the pageAlloc.
  1058  		systemstack(func() {
  1059  			lock(p.mheapLock)
  1060  			p.grow(addr, pallocChunkBytes)
  1061  			unlock(p.mheapLock)
  1062  		})
  1063  
  1064  		// Initialize the bitmap and update pageAlloc metadata.
  1065  		ci := chunkIndex(addr)
  1066  		chunk := p.chunkOf(ci)
  1067  
  1068  		// Clear all the scavenged bits which grow set.
  1069  		chunk.scavenged.clearRange(0, pallocChunkPages)
  1070  
  1071  		// Simulate the allocation and subsequent free of all pages in
  1072  		// the chunk for the scavenge index. This sets the state equivalent
  1073  		// with all pages within the index being free.
  1074  		p.scav.index.alloc(ci, pallocChunkPages)
  1075  		p.scav.index.free(ci, 0, pallocChunkPages)
  1076  
  1077  		// Apply scavenge state if applicable.
  1078  		if scav != nil {
  1079  			if scvg, ok := scav[i]; ok {
  1080  				for _, s := range scvg {
  1081  					// Ignore the case of s.N == 0. setRange doesn't handle
  1082  					// it and it's a no-op anyway.
  1083  					if s.N != 0 {
  1084  						chunk.scavenged.setRange(s.I, s.N)
  1085  					}
  1086  				}
  1087  			}
  1088  		}
  1089  
  1090  		// Apply alloc state.
  1091  		for _, s := range init {
  1092  			// Ignore the case of s.N == 0. allocRange doesn't handle
  1093  			// it and it's a no-op anyway.
  1094  			if s.N != 0 {
  1095  				chunk.allocRange(s.I, s.N)
  1096  
  1097  				// Make sure the scavenge index is updated.
  1098  				p.scav.index.alloc(ci, s.N)
  1099  			}
  1100  		}
  1101  
  1102  		// Update heap metadata for the allocRange calls above.
  1103  		systemstack(func() {
  1104  			lock(p.mheapLock)
  1105  			p.update(addr, pallocChunkPages, false, false)
  1106  			unlock(p.mheapLock)
  1107  		})
  1108  	}
  1109  
  1110  	return (*PageAlloc)(p)
  1111  }
  1112  
  1113  // FreePageAlloc releases hard OS resources owned by the pageAlloc. Once this
  1114  // is called the pageAlloc may no longer be used. The object itself will be
  1115  // collected by the garbage collector once it is no longer live.
  1116  func FreePageAlloc(pp *PageAlloc) {
  1117  	p := (*pageAlloc)(pp)
  1118  
  1119  	// Free all the mapped space for the summary levels.
  1120  	if pageAlloc64Bit != 0 {
  1121  		for l := 0; l < summaryLevels; l++ {
  1122  			// This isn't quite right, as some of this memory may
  1123  			// be Ready instead of Reserved. The mappedReady and
  1124  			// testSysStat adjustments below correct for the
  1125  			// difference.
  1126  			sysUnreserve(unsafe.Pointer(&p.summary[l][0]), uintptr(cap(p.summary[l]))*pallocSumBytes)
  1127  		}
  1128  	} else {
  1129  		resSize := uintptr(0)
  1130  		for _, s := range p.summary {
  1131  			resSize += uintptr(cap(s)) * pallocSumBytes
  1132  		}
  1133  		// See sysUnreserve comment above.
  1134  		sysUnreserve(unsafe.Pointer(&p.summary[0][0]), alignUp(resSize, physPageSize))
  1135  	}
  1136  
  1137  	// Subtract back out whatever we mapped for the summaries.
  1138  	// sysUsed adds to p.sysStat and memstats.mappedReady no matter what
  1139  	// (and in anger should actually be accounted for), and there's no other
  1140  	// way to figure out how much we actually mapped.
  1141  	gcController.mappedReady.Add(-int64(p.summaryMappedReady))
  1142  	testSysStat.add(-int64(p.summaryMappedReady))
  1143  
  1144  	// Free extra data structures.
  1145  	//
  1146  	// TODO(prattmic): As above, some of this may be Ready, so we should
  1147  	// manually adjust mappedReady and testSysStat?
  1148  	sysUnreserve(unsafe.Pointer(&p.scav.index.chunks[0]), uintptr(cap(p.scav.index.chunks))*unsafe.Sizeof(atomicScavChunkData{}))
  1149  
  1150  	// Free the mapped space for chunks.
  1151  	for i := range p.chunks {
  1152  		if x := p.chunks[i]; x != nil {
  1153  			p.chunks[i] = nil
  1154  			// This memory comes from sysAlloc and will always be page-aligned.
  1155  			sysFree(unsafe.Pointer(x), unsafe.Sizeof(*p.chunks[0]), testSysStat)
  1156  		}
  1157  	}
  1158  }
  1159  
  1160  // BaseChunkIdx is a convenient chunkIdx value which works on both
  1161  // 64 bit and 32 bit platforms, allowing the tests to share code
  1162  // between the two.
  1163  //
  1164  // This should not be higher than 0x100*pallocChunkBytes to support
  1165  // mips and mipsle, which only have 31-bit address spaces.
  1166  var BaseChunkIdx = func() ChunkIdx {
  1167  	var prefix uintptr
  1168  	if pageAlloc64Bit != 0 {
  1169  		prefix = 0xc000
  1170  	} else {
  1171  		prefix = 0x100
  1172  	}
  1173  	baseAddr := prefix * pallocChunkBytes
  1174  	if goos.IsAix != 0 {
  1175  		baseAddr += arenaBaseOffset
  1176  	}
  1177  	return ChunkIdx(chunkIndex(baseAddr))
  1178  }()
  1179  
  1180  // PageBase returns an address given a chunk index and a page index
  1181  // relative to that chunk.
  1182  func PageBase(c ChunkIdx, pageIdx uint) uintptr {
  1183  	return chunkBase(chunkIdx(c)) + uintptr(pageIdx)*pageSize
  1184  }
  1185  
  1186  type BitsMismatch struct {
  1187  	Base      uintptr
  1188  	Got, Want uint64
  1189  }
  1190  
  1191  func CheckScavengedBitsCleared(mismatches []BitsMismatch) (n int, ok bool) {
  1192  	ok = true
  1193  
  1194  	// Run on the system stack to avoid stack growth allocation.
  1195  	systemstack(func() {
  1196  		getg().m.mallocing++
  1197  
  1198  		// Lock so that we can safely access the bitmap.
  1199  		lock(&mheap_.lock)
  1200  
  1201  	chunkLoop:
  1202  		for i := mheap_.pages.start; i < mheap_.pages.end; i++ {
  1203  			chunk := mheap_.pages.tryChunkOf(i)
  1204  			if chunk == nil {
  1205  				continue
  1206  			}
  1207  			cb := chunkBase(i)
  1208  			for j := 0; j < pallocChunkPages/64; j++ {
  1209  				// Run over each 64-bit bitmap section and ensure
  1210  				// scavenged is being cleared properly on allocation.
  1211  				// If a used bit and scavenged bit are both set, that's
  1212  				// an error, and could indicate a larger problem, or
  1213  				// an accounting problem.
  1214  				want := chunk.scavenged[j] &^ chunk.pallocBits[j]
  1215  				got := chunk.scavenged[j]
  1216  				if want != got {
  1217  					ok = false
  1218  					if n >= len(mismatches) {
  1219  						break chunkLoop
  1220  					}
  1221  					mismatches[n] = BitsMismatch{
  1222  						Base: cb + uintptr(j)*64*pageSize,
  1223  						Got:  got,
  1224  						Want: want,
  1225  					}
  1226  					n++
  1227  				}
  1228  			}
  1229  		}
  1230  		unlock(&mheap_.lock)
  1231  
  1232  		getg().m.mallocing--
  1233  	})
  1234  
  1235  	if randomizeHeapBase && len(mismatches) > 0 {
  1236  		// When goexperiment.RandomizedHeapBase64 is set we use a series of
  1237  		// padding pages to generate randomized heap base address which have
  1238  		// both the alloc and scav bits set. Because of this we expect exactly
  1239  		// one arena will have mismatches, so check for that explicitly and
  1240  		// remove the mismatches if that property holds. If we see more than one
  1241  		// arena with this property, that is an indication something has
  1242  		// actually gone wrong, so return the mismatches.
  1243  		//
  1244  		// We do this, instead of ignoring the mismatches in the chunkLoop, because
  1245  		// it's not easy to determine which arena we added the padding pages to
  1246  		// programmatically, without explicitly recording the base address somewhere
  1247  		// in a global variable (which we'd rather not do as the address of that variable
  1248  		// is likely to be somewhat predictable, potentially defeating the purpose
  1249  		// of our randomization).
  1250  		affectedArenas := map[arenaIdx]bool{}
  1251  		for _, mismatch := range mismatches {
  1252  			if mismatch.Base > 0 {
  1253  				affectedArenas[arenaIndex(mismatch.Base)] = true
  1254  			}
  1255  		}
  1256  		if len(affectedArenas) == 1 {
  1257  			ok = true
  1258  			// zero the mismatches
  1259  			for i := range n {
  1260  				mismatches[i] = BitsMismatch{}
  1261  			}
  1262  		}
  1263  	}
  1264  
  1265  	return
  1266  }
  1267  
  1268  func PageCachePagesLeaked() (leaked uintptr) {
  1269  	stw := stopTheWorld(stwForTestPageCachePagesLeaked)
  1270  
  1271  	// Walk over destroyed Ps and look for unflushed caches.
  1272  	deadp := allp[len(allp):cap(allp)]
  1273  	for _, p := range deadp {
  1274  		// Since we're going past len(allp) we may see nil Ps.
  1275  		// Just ignore them.
  1276  		if p != nil {
  1277  			leaked += uintptr(sys.OnesCount64(p.pcache.cache))
  1278  		}
  1279  	}
  1280  
  1281  	startTheWorld(stw)
  1282  	return
  1283  }
  1284  
  1285  var ProcYield = procyield
  1286  var OSYield = osyield
  1287  
  1288  type Note = note
  1289  
  1290  var NoteClear = noteclear
  1291  var NoteTSleepG = notetsleepg
  1292  
  1293  // NoteTSleepG0 calls notetsleep on the system stack
  1294  func NoteTSleepG0(n *Note, ns int64) bool {
  1295  	var ok bool
  1296  	systemstack(func() {
  1297  		ok = notetsleep(n, ns)
  1298  	})
  1299  	return ok
  1300  }
  1301  
  1302  type Mutex = mutex
  1303  
  1304  var Lock = lock
  1305  var Unlock = unlock
  1306  
  1307  var MutexContended = mutexContended
  1308  
  1309  func SemRootLock(addr *uint32) *mutex {
  1310  	root := semtable.rootFor(addr)
  1311  	return &root.lock
  1312  }
  1313  
  1314  var Semacquire = semacquire
  1315  var Semrelease1 = semrelease1
  1316  
  1317  func SemNwait(addr *uint32) uint32 {
  1318  	root := semtable.rootFor(addr)
  1319  	return root.nwait.Load()
  1320  }
  1321  
  1322  const SemTableSize = semTabSize
  1323  
  1324  // SemTable is a wrapper around semTable exported for testing.
  1325  type SemTable struct {
  1326  	semTable
  1327  }
  1328  
  1329  // Enqueue simulates enqueuing a waiter for a semaphore (or lock) at addr.
  1330  func (t *SemTable) Enqueue(addr *uint32) {
  1331  	s := acquireSudog()
  1332  	s.releasetime = 0
  1333  	s.acquiretime = 0
  1334  	s.ticket = 0
  1335  	t.semTable.rootFor(addr).queue(addr, s, false)
  1336  }
  1337  
  1338  // Dequeue simulates dequeuing a waiter for a semaphore (or lock) at addr.
  1339  //
  1340  // Returns true if there actually was a waiter to be dequeued.
  1341  func (t *SemTable) Dequeue(addr *uint32) bool {
  1342  	s, _, _ := t.semTable.rootFor(addr).dequeue(addr)
  1343  	if s != nil {
  1344  		releaseSudog(s)
  1345  		return true
  1346  	}
  1347  	return false
  1348  }
  1349  
  1350  // mspan wrapper for testing.
  1351  type MSpan mspan
  1352  
  1353  // Allocate an mspan for testing.
  1354  func AllocMSpan() *MSpan {
  1355  	var s *mspan
  1356  	systemstack(func() {
  1357  		lock(&mheap_.lock)
  1358  		s = (*mspan)(mheap_.spanalloc.alloc())
  1359  		s.init(0, 0)
  1360  		unlock(&mheap_.lock)
  1361  	})
  1362  	return (*MSpan)(s)
  1363  }
  1364  
  1365  // Free an allocated mspan.
  1366  func FreeMSpan(s *MSpan) {
  1367  	systemstack(func() {
  1368  		lock(&mheap_.lock)
  1369  		mheap_.spanalloc.free(unsafe.Pointer(s))
  1370  		unlock(&mheap_.lock)
  1371  	})
  1372  }
  1373  
  1374  func MSpanCountAlloc(ms *MSpan, bits []byte) int {
  1375  	s := (*mspan)(ms)
  1376  	s.nelems = uint16(len(bits) * 8)
  1377  	s.gcmarkBits = (*gcBits)(unsafe.Pointer(&bits[0]))
  1378  	result := s.countAlloc()
  1379  	s.gcmarkBits = nil
  1380  	return result
  1381  }
  1382  
  1383  const (
  1384  	TimeHistSubBucketBits = timeHistSubBucketBits
  1385  	TimeHistNumSubBuckets = timeHistNumSubBuckets
  1386  	TimeHistNumBuckets    = timeHistNumBuckets
  1387  	TimeHistMinBucketBits = timeHistMinBucketBits
  1388  	TimeHistMaxBucketBits = timeHistMaxBucketBits
  1389  )
  1390  
  1391  type TimeHistogram timeHistogram
  1392  
  1393  // Count returns the counts for the given bucket, subBucket indices.
  1394  // Returns true if the bucket was valid, otherwise returns the counts
  1395  // for the overflow bucket if bucket > 0 or the underflow bucket if
  1396  // bucket < 0, and false.
  1397  func (th *TimeHistogram) Count(bucket, subBucket int) (uint64, bool) {
  1398  	t := (*timeHistogram)(th)
  1399  	if bucket < 0 {
  1400  		return t.underflow.Load(), false
  1401  	}
  1402  	i := bucket*TimeHistNumSubBuckets + subBucket
  1403  	if i >= len(t.counts) {
  1404  		return t.overflow.Load(), false
  1405  	}
  1406  	return t.counts[i].Load(), true
  1407  }
  1408  
  1409  func (th *TimeHistogram) Record(duration int64) {
  1410  	(*timeHistogram)(th).record(duration)
  1411  }
  1412  
  1413  var TimeHistogramMetricsBuckets = timeHistogramMetricsBuckets
  1414  
  1415  func SetIntArgRegs(a int) int {
  1416  	lock(&finlock)
  1417  	old := intArgRegs
  1418  	if a >= 0 {
  1419  		intArgRegs = a
  1420  	}
  1421  	unlock(&finlock)
  1422  	return old
  1423  }
  1424  
  1425  func FinalizerGAsleep() bool {
  1426  	return fingStatus.Load()&fingWait != 0
  1427  }
  1428  
  1429  // For GCTestMoveStackOnNextCall, it's important not to introduce an
  1430  // extra layer of call, since then there's a return before the "real"
  1431  // next call.
  1432  var GCTestMoveStackOnNextCall = gcTestMoveStackOnNextCall
  1433  
  1434  // For GCTestIsReachable, it's important that we do this as a call so
  1435  // escape analysis can see through it.
  1436  func GCTestIsReachable(ptrs ...unsafe.Pointer) (mask uint64) {
  1437  	return gcTestIsReachable(ptrs...)
  1438  }
  1439  
  1440  // For GCTestPointerClass, it's important that we do this as a call so
  1441  // escape analysis can see through it.
  1442  //
  1443  // This is nosplit because gcTestPointerClass is.
  1444  //
  1445  //go:nosplit
  1446  func GCTestPointerClass(p unsafe.Pointer) string {
  1447  	return gcTestPointerClass(p)
  1448  }
  1449  
  1450  const Raceenabled = raceenabled
  1451  
  1452  const (
  1453  	GCBackgroundUtilization            = gcBackgroundUtilization
  1454  	GCGoalUtilization                  = gcGoalUtilization
  1455  	DefaultHeapMinimum                 = defaultHeapMinimum
  1456  	MemoryLimitHeapGoalHeadroomPercent = memoryLimitHeapGoalHeadroomPercent
  1457  	MemoryLimitMinHeapGoalHeadroom     = memoryLimitMinHeapGoalHeadroom
  1458  )
  1459  
  1460  type GCController struct {
  1461  	gcControllerState
  1462  }
  1463  
  1464  func NewGCController(gcPercent int, memoryLimit int64) *GCController {
  1465  	// Force the controller to escape. We're going to
  1466  	// do 64-bit atomics on it, and if it gets stack-allocated
  1467  	// on a 32-bit architecture, it may get allocated unaligned
  1468  	// space.
  1469  	g := Escape(new(GCController))
  1470  	g.gcControllerState.test = true // Mark it as a test copy.
  1471  	g.init(int32(gcPercent), memoryLimit)
  1472  	return g
  1473  }
  1474  
  1475  func (c *GCController) StartCycle(stackSize, globalsSize uint64, scannableFrac float64, gomaxprocs int) {
  1476  	trigger, _ := c.trigger()
  1477  	if c.heapMarked > trigger {
  1478  		trigger = c.heapMarked
  1479  	}
  1480  	c.maxStackScan.Store(stackSize)
  1481  	c.globalsScan.Store(globalsSize)
  1482  	c.heapLive.Store(trigger)
  1483  	c.heapScan.Add(int64(float64(trigger-c.heapMarked) * scannableFrac))
  1484  	c.startCycle(0, gomaxprocs, gcTrigger{kind: gcTriggerHeap})
  1485  }
  1486  
  1487  func (c *GCController) AssistWorkPerByte() float64 {
  1488  	return c.assistWorkPerByte.Load()
  1489  }
  1490  
  1491  func (c *GCController) HeapGoal() uint64 {
  1492  	return c.heapGoal()
  1493  }
  1494  
  1495  func (c *GCController) HeapLive() uint64 {
  1496  	return c.heapLive.Load()
  1497  }
  1498  
  1499  func (c *GCController) HeapMarked() uint64 {
  1500  	return c.heapMarked
  1501  }
  1502  
  1503  func (c *GCController) Triggered() uint64 {
  1504  	return c.triggered
  1505  }
  1506  
  1507  type GCControllerReviseDelta struct {
  1508  	HeapLive        int64
  1509  	HeapScan        int64
  1510  	HeapScanWork    int64
  1511  	StackScanWork   int64
  1512  	GlobalsScanWork int64
  1513  }
  1514  
  1515  func (c *GCController) Revise(d GCControllerReviseDelta) {
  1516  	c.heapLive.Add(d.HeapLive)
  1517  	c.heapScan.Add(d.HeapScan)
  1518  	c.heapScanWork.Add(d.HeapScanWork)
  1519  	c.stackScanWork.Add(d.StackScanWork)
  1520  	c.globalsScanWork.Add(d.GlobalsScanWork)
  1521  	c.revise()
  1522  }
  1523  
  1524  func (c *GCController) EndCycle(bytesMarked uint64, assistTime, elapsed int64, gomaxprocs int) {
  1525  	c.assistTime.Store(assistTime)
  1526  	c.endCycle(elapsed, gomaxprocs)
  1527  	c.resetLive(bytesMarked)
  1528  	c.commit(false)
  1529  }
  1530  
  1531  func (c *GCController) AddIdleMarkWorker() bool {
  1532  	return c.addIdleMarkWorker()
  1533  }
  1534  
  1535  func (c *GCController) NeedIdleMarkWorker() bool {
  1536  	return c.needIdleMarkWorker()
  1537  }
  1538  
  1539  func (c *GCController) RemoveIdleMarkWorker() {
  1540  	c.removeIdleMarkWorker()
  1541  }
  1542  
  1543  func (c *GCController) SetMaxIdleMarkWorkers(max int32) {
  1544  	c.setMaxIdleMarkWorkers(max)
  1545  }
  1546  
  1547  var alwaysFalse bool
  1548  var escapeSink any
  1549  
  1550  func Escape[T any](x T) T {
  1551  	if alwaysFalse {
  1552  		escapeSink = x
  1553  	}
  1554  	return x
  1555  }
  1556  
  1557  // Acquirem blocks preemption.
  1558  func Acquirem() {
  1559  	acquirem()
  1560  }
  1561  
  1562  func Releasem() {
  1563  	releasem(getg().m)
  1564  }
  1565  
  1566  // GoschedIfBusy is an explicit preemption check to call back
  1567  // into the scheduler. This is useful for tests that run code
  1568  // which spend most of their time as non-preemptible, as it
  1569  // can be placed right after becoming preemptible again to ensure
  1570  // that the scheduler gets a chance to preempt the goroutine.
  1571  func GoschedIfBusy() {
  1572  	goschedIfBusy()
  1573  }
  1574  
  1575  type PIController struct {
  1576  	piController
  1577  }
  1578  
  1579  func NewPIController(kp, ti, tt, min, max float64) *PIController {
  1580  	return &PIController{piController{
  1581  		kp:  kp,
  1582  		ti:  ti,
  1583  		tt:  tt,
  1584  		min: min,
  1585  		max: max,
  1586  	}}
  1587  }
  1588  
  1589  func (c *PIController) Next(input, setpoint, period float64) (float64, bool) {
  1590  	return c.piController.next(input, setpoint, period)
  1591  }
  1592  
  1593  const (
  1594  	CapacityPerProc          = capacityPerProc
  1595  	GCCPULimiterUpdatePeriod = gcCPULimiterUpdatePeriod
  1596  )
  1597  
  1598  type GCCPULimiter struct {
  1599  	limiter gcCPULimiterState
  1600  }
  1601  
  1602  func NewGCCPULimiter(now int64, gomaxprocs int32) *GCCPULimiter {
  1603  	// Force the controller to escape. We're going to
  1604  	// do 64-bit atomics on it, and if it gets stack-allocated
  1605  	// on a 32-bit architecture, it may get allocated unaligned
  1606  	// space.
  1607  	l := Escape(new(GCCPULimiter))
  1608  	l.limiter.test = true
  1609  	l.limiter.resetCapacity(now, gomaxprocs)
  1610  	return l
  1611  }
  1612  
  1613  func (l *GCCPULimiter) Fill() uint64 {
  1614  	return l.limiter.bucket.fill
  1615  }
  1616  
  1617  func (l *GCCPULimiter) Capacity() uint64 {
  1618  	return l.limiter.bucket.capacity
  1619  }
  1620  
  1621  func (l *GCCPULimiter) Overflow() uint64 {
  1622  	return l.limiter.overflow
  1623  }
  1624  
  1625  func (l *GCCPULimiter) Limiting() bool {
  1626  	return l.limiter.limiting()
  1627  }
  1628  
  1629  func (l *GCCPULimiter) NeedUpdate(now int64) bool {
  1630  	return l.limiter.needUpdate(now)
  1631  }
  1632  
  1633  func (l *GCCPULimiter) StartGCTransition(enableGC bool, now int64) {
  1634  	l.limiter.startGCTransition(enableGC, now)
  1635  }
  1636  
  1637  func (l *GCCPULimiter) FinishGCTransition(now int64) {
  1638  	l.limiter.finishGCTransition(now)
  1639  }
  1640  
  1641  func (l *GCCPULimiter) Update(now int64) {
  1642  	l.limiter.update(now)
  1643  }
  1644  
  1645  func (l *GCCPULimiter) AddAssistTime(t int64) {
  1646  	l.limiter.addAssistTime(t)
  1647  }
  1648  
  1649  func (l *GCCPULimiter) ResetCapacity(now int64, nprocs int32) {
  1650  	l.limiter.resetCapacity(now, nprocs)
  1651  }
  1652  
  1653  const ScavengePercent = scavengePercent
  1654  
  1655  type Scavenger struct {
  1656  	Sleep      func(int64) int64
  1657  	Scavenge   func(uintptr) (uintptr, int64)
  1658  	ShouldStop func() bool
  1659  	GoMaxProcs func() int32
  1660  
  1661  	released  atomic.Uintptr
  1662  	scavenger scavengerState
  1663  	stop      chan<- struct{}
  1664  	done      <-chan struct{}
  1665  }
  1666  
  1667  func (s *Scavenger) Start() {
  1668  	if s.Sleep == nil || s.Scavenge == nil || s.ShouldStop == nil || s.GoMaxProcs == nil {
  1669  		panic("must populate all stubs")
  1670  	}
  1671  
  1672  	// Install hooks.
  1673  	s.scavenger.sleepStub = s.Sleep
  1674  	s.scavenger.scavenge = s.Scavenge
  1675  	s.scavenger.shouldStop = s.ShouldStop
  1676  	s.scavenger.gomaxprocs = s.GoMaxProcs
  1677  
  1678  	// Start up scavenger goroutine, and wait for it to be ready.
  1679  	stop := make(chan struct{})
  1680  	s.stop = stop
  1681  	done := make(chan struct{})
  1682  	s.done = done
  1683  	go func() {
  1684  		// This should match bgscavenge, loosely.
  1685  		s.scavenger.init()
  1686  		s.scavenger.park()
  1687  		for {
  1688  			select {
  1689  			case <-stop:
  1690  				close(done)
  1691  				return
  1692  			default:
  1693  			}
  1694  			released, workTime := s.scavenger.run()
  1695  			if released == 0 {
  1696  				s.scavenger.park()
  1697  				continue
  1698  			}
  1699  			s.released.Add(released)
  1700  			s.scavenger.sleep(workTime)
  1701  		}
  1702  	}()
  1703  	if !s.BlockUntilParked(1e9 /* 1 second */) {
  1704  		panic("timed out waiting for scavenger to get ready")
  1705  	}
  1706  }
  1707  
  1708  // BlockUntilParked blocks until the scavenger parks, or until
  1709  // timeout is exceeded. Returns true if the scavenger parked.
  1710  //
  1711  // Note that in testing, parked means something slightly different.
  1712  // In anger, the scavenger parks to sleep, too, but in testing,
  1713  // it only parks when it actually has no work to do.
  1714  func (s *Scavenger) BlockUntilParked(timeout int64) bool {
  1715  	// Just spin, waiting for it to park.
  1716  	//
  1717  	// The actual parking process is racy with respect to
  1718  	// wakeups, which is fine, but for testing we need something
  1719  	// a bit more robust.
  1720  	start := nanotime()
  1721  	for nanotime()-start < timeout {
  1722  		lock(&s.scavenger.lock)
  1723  		parked := s.scavenger.parked
  1724  		unlock(&s.scavenger.lock)
  1725  		if parked {
  1726  			return true
  1727  		}
  1728  		Gosched()
  1729  	}
  1730  	return false
  1731  }
  1732  
  1733  // Released returns how many bytes the scavenger released.
  1734  func (s *Scavenger) Released() uintptr {
  1735  	return s.released.Load()
  1736  }
  1737  
  1738  // Wake wakes up a parked scavenger to keep running.
  1739  func (s *Scavenger) Wake() {
  1740  	s.scavenger.wake()
  1741  }
  1742  
  1743  // Stop cleans up the scavenger's resources. The scavenger
  1744  // must be parked for this to work.
  1745  func (s *Scavenger) Stop() {
  1746  	lock(&s.scavenger.lock)
  1747  	parked := s.scavenger.parked
  1748  	unlock(&s.scavenger.lock)
  1749  	if !parked {
  1750  		panic("tried to clean up scavenger that is not parked")
  1751  	}
  1752  	close(s.stop)
  1753  	s.Wake()
  1754  	<-s.done
  1755  }
  1756  
  1757  type ScavengeIndex struct {
  1758  	i scavengeIndex
  1759  }
  1760  
  1761  func NewScavengeIndex(min, max ChunkIdx) *ScavengeIndex {
  1762  	s := new(ScavengeIndex)
  1763  	// This is a bit lazy but we easily guarantee we'll be able
  1764  	// to reference all the relevant chunks. The worst-case
  1765  	// memory usage here is 512 MiB, but tests generally use
  1766  	// small offsets from BaseChunkIdx, which results in ~100s
  1767  	// of KiB in memory use.
  1768  	//
  1769  	// This may still be worth making better, at least by sharing
  1770  	// this fairly large array across calls with a sync.Pool or
  1771  	// something. Currently, when the tests are run serially,
  1772  	// it takes around 0.5s. Not all that much, but if we have
  1773  	// a lot of tests like this it could add up.
  1774  	s.i.chunks = make([]atomicScavChunkData, max)
  1775  	s.i.min.Store(uintptr(min))
  1776  	s.i.max.Store(uintptr(max))
  1777  	s.i.minHeapIdx.Store(uintptr(min))
  1778  	s.i.test = true
  1779  	return s
  1780  }
  1781  
  1782  func (s *ScavengeIndex) Find(force bool) (ChunkIdx, uint) {
  1783  	ci, off := s.i.find(force)
  1784  	return ChunkIdx(ci), off
  1785  }
  1786  
  1787  func (s *ScavengeIndex) AllocRange(base, limit uintptr) {
  1788  	sc, ec := chunkIndex(base), chunkIndex(limit-1)
  1789  	si, ei := chunkPageIndex(base), chunkPageIndex(limit-1)
  1790  
  1791  	if sc == ec {
  1792  		// The range doesn't cross any chunk boundaries.
  1793  		s.i.alloc(sc, ei+1-si)
  1794  	} else {
  1795  		// The range crosses at least one chunk boundary.
  1796  		s.i.alloc(sc, pallocChunkPages-si)
  1797  		for c := sc + 1; c < ec; c++ {
  1798  			s.i.alloc(c, pallocChunkPages)
  1799  		}
  1800  		s.i.alloc(ec, ei+1)
  1801  	}
  1802  }
  1803  
  1804  func (s *ScavengeIndex) FreeRange(base, limit uintptr) {
  1805  	sc, ec := chunkIndex(base), chunkIndex(limit-1)
  1806  	si, ei := chunkPageIndex(base), chunkPageIndex(limit-1)
  1807  
  1808  	if sc == ec {
  1809  		// The range doesn't cross any chunk boundaries.
  1810  		s.i.free(sc, si, ei+1-si)
  1811  	} else {
  1812  		// The range crosses at least one chunk boundary.
  1813  		s.i.free(sc, si, pallocChunkPages-si)
  1814  		for c := sc + 1; c < ec; c++ {
  1815  			s.i.free(c, 0, pallocChunkPages)
  1816  		}
  1817  		s.i.free(ec, 0, ei+1)
  1818  	}
  1819  }
  1820  
  1821  func (s *ScavengeIndex) ResetSearchAddrs() {
  1822  	for _, a := range []*atomicOffAddr{&s.i.searchAddrBg, &s.i.searchAddrForce} {
  1823  		addr, marked := a.Load()
  1824  		if marked {
  1825  			a.StoreUnmark(addr, addr)
  1826  		}
  1827  		a.Clear()
  1828  	}
  1829  	s.i.freeHWM = minOffAddr
  1830  }
  1831  
  1832  func (s *ScavengeIndex) NextGen() {
  1833  	s.i.nextGen()
  1834  }
  1835  
  1836  func (s *ScavengeIndex) SetEmpty(ci ChunkIdx) {
  1837  	s.i.setEmpty(chunkIdx(ci))
  1838  }
  1839  
  1840  func CheckPackScavChunkData(gen uint32, inUse, lastInUse uint16, flags uint8) bool {
  1841  	sc0 := scavChunkData{
  1842  		gen:            gen,
  1843  		inUse:          inUse,
  1844  		lastInUse:      lastInUse,
  1845  		scavChunkFlags: scavChunkFlags(flags),
  1846  	}
  1847  	scp := sc0.pack()
  1848  	sc1 := unpackScavChunkData(scp)
  1849  	return sc0 == sc1
  1850  }
  1851  
  1852  const GTrackingPeriod = gTrackingPeriod
  1853  
  1854  var ZeroBase = unsafe.Pointer(&zerobase)
  1855  
  1856  const UserArenaChunkBytes = userArenaChunkBytes
  1857  
  1858  type UserArena struct {
  1859  	arena *userArena
  1860  }
  1861  
  1862  func NewUserArena() *UserArena {
  1863  	return &UserArena{newUserArena()}
  1864  }
  1865  
  1866  func (a *UserArena) New(out *any) {
  1867  	i := efaceOf(out)
  1868  	typ := i._type
  1869  	if typ.Kind() != abi.Pointer {
  1870  		panic("new result of non-ptr type")
  1871  	}
  1872  	typ = (*ptrtype)(unsafe.Pointer(typ)).Elem
  1873  	i.data = a.arena.new(typ)
  1874  }
  1875  
  1876  func (a *UserArena) Slice(sl any, cap int) {
  1877  	a.arena.slice(sl, cap)
  1878  }
  1879  
  1880  func (a *UserArena) Free() {
  1881  	a.arena.free()
  1882  }
  1883  
  1884  func GlobalWaitingArenaChunks() int {
  1885  	n := 0
  1886  	systemstack(func() {
  1887  		lock(&mheap_.lock)
  1888  		for s := mheap_.userArena.quarantineList.first; s != nil; s = s.next {
  1889  			n++
  1890  		}
  1891  		unlock(&mheap_.lock)
  1892  	})
  1893  	return n
  1894  }
  1895  
  1896  func UserArenaClone[T any](s T) T {
  1897  	return arena_heapify(s).(T)
  1898  }
  1899  
  1900  var AlignUp = alignUp
  1901  
  1902  func BlockUntilEmptyFinalizerQueue(timeout int64) bool {
  1903  	return blockUntilEmptyFinalizerQueue(timeout)
  1904  }
  1905  
  1906  func BlockUntilEmptyCleanupQueue(timeout int64) bool {
  1907  	return gcCleanups.blockUntilEmpty(timeout)
  1908  }
  1909  
  1910  func FrameStartLine(f *Frame) int {
  1911  	return f.startLine
  1912  }
  1913  
  1914  // PersistentAlloc allocates some memory that lives outside the Go heap.
  1915  // This memory will never be freed; use sparingly.
  1916  func PersistentAlloc(n, align uintptr) unsafe.Pointer {
  1917  	return persistentalloc(n, align, &memstats.other_sys)
  1918  }
  1919  
  1920  const TagAlign = tagAlign
  1921  
  1922  // FPCallers works like Callers and uses frame pointer unwinding to populate
  1923  // pcBuf with the return addresses of the physical frames on the stack.
  1924  func FPCallers(pcBuf []uintptr) int {
  1925  	return fpTracebackPCs(unsafe.Pointer(getfp()), pcBuf)
  1926  }
  1927  
  1928  const FramePointerEnabled = framepointer_enabled
  1929  
  1930  var (
  1931  	IsPinned      = isPinned
  1932  	GetPinCounter = pinnerGetPinCounter
  1933  )
  1934  
  1935  func SetPinnerLeakPanic(f func()) {
  1936  	pinnerLeakPanic = f
  1937  }
  1938  func GetPinnerLeakPanic() func() {
  1939  	return pinnerLeakPanic
  1940  }
  1941  
  1942  var testUintptr uintptr
  1943  
  1944  func MyGenericFunc[T any]() {
  1945  	systemstack(func() {
  1946  		testUintptr = 4
  1947  	})
  1948  }
  1949  
  1950  func UnsafePoint(pc uintptr) bool {
  1951  	fi := findfunc(pc)
  1952  	v := pcdatavalue(fi, abi.PCDATA_UnsafePoint, pc)
  1953  	switch v {
  1954  	case abi.UnsafePointUnsafe:
  1955  		return true
  1956  	case abi.UnsafePointSafe:
  1957  		return false
  1958  	case abi.UnsafePointRestart1, abi.UnsafePointRestart2, abi.UnsafePointRestartAtEntry:
  1959  		// These are all interruptible, they just encode a nonstandard
  1960  		// way of recovering when interrupted.
  1961  		return false
  1962  	default:
  1963  		var buf [20]byte
  1964  		panic("invalid unsafe point code " + string(itoa(buf[:], uint64(v))))
  1965  	}
  1966  }
  1967  
  1968  type TraceMap struct {
  1969  	traceMap
  1970  }
  1971  
  1972  func (m *TraceMap) PutString(s string) (uint64, bool) {
  1973  	return m.traceMap.put(unsafe.Pointer(unsafe.StringData(s)), uintptr(len(s)))
  1974  }
  1975  
  1976  func (m *TraceMap) Reset() {
  1977  	m.traceMap.reset()
  1978  }
  1979  
  1980  func SetSpinInGCMarkDone(spin bool) {
  1981  	gcDebugMarkDone.spinAfterRaggedBarrier.Store(spin)
  1982  }
  1983  
  1984  func GCMarkDoneRestarted() bool {
  1985  	// Only read this outside of the GC. If we're running during a GC, just report false.
  1986  	mp := acquirem()
  1987  	if gcphase != _GCoff {
  1988  		releasem(mp)
  1989  		return false
  1990  	}
  1991  	restarted := gcDebugMarkDone.restartedDueTo27993
  1992  	releasem(mp)
  1993  	return restarted
  1994  }
  1995  
  1996  func GCMarkDoneResetRestartFlag() {
  1997  	mp := acquirem()
  1998  	for gcphase != _GCoff {
  1999  		releasem(mp)
  2000  		Gosched()
  2001  		mp = acquirem()
  2002  	}
  2003  	gcDebugMarkDone.restartedDueTo27993 = false
  2004  	releasem(mp)
  2005  }
  2006  
  2007  type BitCursor struct {
  2008  	b bitCursor
  2009  }
  2010  
  2011  func NewBitCursor(buf *byte) BitCursor {
  2012  	return BitCursor{b: bitCursor{ptr: buf, n: 0}}
  2013  }
  2014  
  2015  func (b BitCursor) Write(data *byte, cnt uintptr) {
  2016  	b.b.write(data, cnt)
  2017  }
  2018  func (b BitCursor) Offset(cnt uintptr) BitCursor {
  2019  	return BitCursor{b: b.b.offset(cnt)}
  2020  }
  2021  
  2022  const (
  2023  	BubbleAssocUnbubbled     = bubbleAssocUnbubbled
  2024  	BubbleAssocCurrentBubble = bubbleAssocCurrentBubble
  2025  	BubbleAssocOtherBubble   = bubbleAssocOtherBubble
  2026  )
  2027  
  2028  type TraceStackTable traceStackTable
  2029  
  2030  func (t *TraceStackTable) Reset() {
  2031  	t.tab.reset()
  2032  }
  2033  
  2034  func TraceStack(gp *G, tab *TraceStackTable) {
  2035  	traceStack(0, gp, (*traceStackTable)(tab))
  2036  }
  2037  
  2038  var X86HasAVX = &x86HasAVX
  2039  
  2040  var DebugDecorateMappings = &debug.decoratemappings
  2041  
  2042  func SetVMANameSupported() bool { return setVMANameSupported() }
  2043  
  2044  type ListHead struct {
  2045  	l listHead
  2046  }
  2047  
  2048  func (head *ListHead) Init(off uintptr) {
  2049  	head.l.init(off)
  2050  }
  2051  
  2052  type ListNode struct {
  2053  	l listNode
  2054  }
  2055  
  2056  func (head *ListHead) Push(p unsafe.Pointer) {
  2057  	head.l.push(p)
  2058  }
  2059  
  2060  func (head *ListHead) Pop() unsafe.Pointer {
  2061  	return head.l.pop()
  2062  }
  2063  
  2064  func (head *ListHead) Remove(p unsafe.Pointer) {
  2065  	head.l.remove(p)
  2066  }
  2067  
  2068  type ListHeadManual struct {
  2069  	l listHeadManual
  2070  }
  2071  
  2072  func (head *ListHeadManual) Init(off uintptr) {
  2073  	head.l.init(off)
  2074  }
  2075  
  2076  type ListNodeManual struct {
  2077  	l listNodeManual
  2078  }
  2079  
  2080  func (head *ListHeadManual) Push(p unsafe.Pointer) {
  2081  	head.l.push(p)
  2082  }
  2083  
  2084  func (head *ListHeadManual) Pop() unsafe.Pointer {
  2085  	return head.l.pop()
  2086  }
  2087  
  2088  func (head *ListHeadManual) Remove(p unsafe.Pointer) {
  2089  	head.l.remove(p)
  2090  }
  2091  
  2092  func Hexdumper(base uintptr, wordBytes int, mark func(addr uintptr, start func()), data ...[]byte) string {
  2093  	buf := make([]byte, 0, 2048)
  2094  	getg().writebuf = buf
  2095  	h := hexdumper{addr: base, addrBytes: 4, wordBytes: uint8(wordBytes)}
  2096  	if mark != nil {
  2097  		h.mark = func(addr uintptr, m hexdumpMarker) {
  2098  			mark(addr, m.start)
  2099  		}
  2100  	}
  2101  	for _, d := range data {
  2102  		h.write(d)
  2103  	}
  2104  	h.close()
  2105  	n := len(getg().writebuf)
  2106  	getg().writebuf = nil
  2107  	if n == cap(buf) {
  2108  		panic("Hexdumper buf too small")
  2109  	}
  2110  	return string(buf[:n])
  2111  }
  2112  
  2113  func HexdumpWords(p, bytes uintptr) string {
  2114  	buf := make([]byte, 0, 2048)
  2115  	getg().writebuf = buf
  2116  	hexdumpWords(p, bytes, nil)
  2117  	n := len(getg().writebuf)
  2118  	getg().writebuf = nil
  2119  	if n == cap(buf) {
  2120  		panic("HexdumpWords buf too small")
  2121  	}
  2122  	return string(buf[:n])
  2123  }
  2124  
  2125  // DumpPrintQuoted provides access to print(quoted()) for the tests in
  2126  // runtime/print_quoted_test.go, allowing us to test that implementation.
  2127  func DumpPrintQuoted(s string) string {
  2128  	gp := getg()
  2129  	gp.writebuf = make([]byte, 0, 1<<20)
  2130  	print(quoted(s))
  2131  	buf := gp.writebuf
  2132  	gp.writebuf = nil
  2133  
  2134  	return string(buf)
  2135  }
  2136  
  2137  // PrintBacklog returns a copy of the runtime's print backlog.
  2138  func PrintBacklog() []byte {
  2139  	b := make([]byte, len(printBacklog))
  2140  	printlock()
  2141  	copy(b, printBacklog[:])
  2142  	printunlock()
  2143  	return b
  2144  }
  2145  
  2146  // DumpPrint returns the output of print(v).
  2147  func DumpPrint[T any](v T) string {
  2148  	gp := getg()
  2149  	gp.writebuf = make([]byte, 0, 2048)
  2150  	print(v)
  2151  	buf := gp.writebuf
  2152  	gp.writebuf = nil
  2153  
  2154  	return string(buf)
  2155  }
  2156  
  2157  var (
  2158  	Float64Bytes    = float64Bytes
  2159  	Float32Bytes    = float32Bytes
  2160  	Complex128Bytes = complex128Bytes
  2161  	Complex64Bytes  = complex64Bytes
  2162  )
  2163  
  2164  func GetScanAlloc() uintptr {
  2165  	c := getMCache(getg().m)
  2166  	return c.scanAlloc
  2167  }
  2168  
  2169  func MallocGC(size uintptr, typ *abi.Type, needzero bool) unsafe.Pointer {
  2170  	return mallocgc(size, typ, needzero)
  2171  }
  2172  
  2173  func FuncNamePiecesForPrint(name string) (string, string, string, string, string) {
  2174  	return funcNamePiecesForPrint(name)
  2175  }
  2176  
  2177  var InHeapOrStack = inHeapOrStack
  2178
View as plain text