summaryrefslogtreecommitdiff
path: root/static/v10/man3/galloc.3
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-26 16:38:00 -0400
commit97d5c458cfa039d857301e1ca7d5af3beb37131d (patch)
treeb460cd850d0537eb71806ba30358840377b27688 /static/v10/man3/galloc.3
parentb89dc2331a50c63f8b33272a5c4c61ab98abdaa3 (diff)
build: Better Build System
Diffstat (limited to 'static/v10/man3/galloc.3')
-rw-r--r--static/v10/man3/galloc.375
1 files changed, 0 insertions, 75 deletions
diff --git a/static/v10/man3/galloc.3 b/static/v10/man3/galloc.3
deleted file mode 100644
index 06548bf4..00000000
--- a/static/v10/man3/galloc.3
+++ /dev/null
@@ -1,75 +0,0 @@
-.TH GALLOC 3
-.CT 2 mem_man
-.SH NAME
-galloc, gfree, garbage \(mi storage allocation with garbage collection
-.SH SYNOPSIS
-.nf
-.B char *galloc(n)
-.B unsigned n;
-.PP
-.B void gfree(p)
-.B char *p;
-.PP
-.B void garbage()
-.fi
-.SH DESCRIPTION
-These functions perform heap storage allocation with
-garbage collection.
-.PP
-.I Galloc
-allocates a block of at least
-.I n
-bytes and returns a pointer to it.
-.I Gfree
-frees a block previously allocated by
-.I galloc.
-.PP
-When space gets tight, garbage blocks
-are freed automatically.
-A block allocated by
-.I galloc
-is deemed to be garbage unless it is reachable.
-A reachable block is one whose first byte is
-pointed to by a declared C variable
-or by a pointer in a reachable block.
-.PP
-The frequency of garbage collection is controlled by external
-variables declared
-.IP
-.B "long gcmax = 5000, gcmin = 50;"
-.LP
-No more than
-.I gcmax
-allocations may intervene between automatic collections; this feature
-will help contain the growth of virtual address space.
-At least
-.I gcmin
-allocations must intervene, otherwise
-garbage collection will be abandoned as fruitless.
-.I Garbage
-may be called to do garbage collection at an arbitrary time.
-.PP
-.IR Malloc (3)
-and
-.I galloc
-allocate from the same arena, but garbage collection
-affects only
-.I galloc
-blocks.
-.I Free
-(see
-.IR malloc (3))
-must not be used on blocks allocated with
-.IR galloc .
-.SH SEE ALSO
-.IR malloc (3)
-.SH DIAGNOSTICS
-.I Galloc
-returns 0
-when space cannot be found.
-.SH BUGS
-Garbage collection is conservative;
-blocks that appear to be pointed to from
-within declared storage will not be freed,
-regardless of whether the apparent `pointers'
-were declared as such.