Ecosyste.ms: Packages
An open API service providing package, version and dependency metadata of many open source software ecosystems and registries.
Top 0.6% dependent packages on proxy.golang.org
Top 0.8% dependent repos on proxy.golang.org
Top 7.7% forks on proxy.golang.org
proxy.golang.org : github.com/CAFxX/gcnotifier
Package gcnotifier provides a way to receive notifications after every garbage collection (GC) cycle. This can be useful, in long-running programs, to instruct your code to free additional memory resources that you may be using. A common use case for this is when you have custom data structures (e.g. buffers, caches, rings, trees, pools, ...): instead of setting a maximum size to your data structure you can leave it unbounded and then drop all (or some) of the allocated-but-unused slots after every GC run (e.g. sync.Pool drops all allocated-but-unused objects in the pool during GC). To minimize the load on the GC the code that runs after receiving the notification should try to avoid allocations as much as possible, or at the very least make sure that the amount of new memory allocated is significantly smaller than the amount of memory that has been "freed" in response to the notification. GCNotifier guarantees to send a notification after every GC cycle completes. Note that the Go runtime does not guarantee that the GC will run: specifically there is no guarantee that a GC will run before the program terminates. Example implements a simple time-based buffering io.Writer: data sent over dataCh is buffered for up to 100ms, then flushed out in a single call to out.Write and the buffer is reused. If GC runs, the buffer is flushed and then discarded so that it can be collected during the next GC run. The example is necessarily simplistic, a real implementation would be more refined (e.g. on GC flush or resize the buffer based on a threshold, perform asynchronous flushes, properly signal completions and propagate errors, adaptively preallocate the buffer based on the previous capacity, etc.)
Registry
-
Source
- Documentation
- JSON
purl: pkg:golang/github.com/%21c%21a%21fx%21x/gcnotifier
Keywords: garbage-collector, gc, golang, runtime
License: MIT
Latest release: almost 2 years ago
First release: almost 2 years ago
Namespace: github.com/CAFxX
Dependent packages: 61
Dependent repositories: 47
Stars: 176 on GitHub
Forks: 6 on GitHub
See more repository details: repos.ecosyste.ms
Last synced: 7 days ago