Better global data support for tools
Tools
Copyright © 2000 Jarno van der Linden.
Fast search index
sys/gd/cleanup
sys/gd/gdconst
sys/gd/gdfree
sys/gd/gdrw
sys/gd/makename
sys/gd/cleanup (Private)
Cleanup routine run at process exit to free global data
Inputs
Outputs
- This function has no return value
Description
sys/gd/cleanup is a private function.
Example
None
See also
sys/gd/gdconst
Sets up a constant global data area
Inputs
- p0: unique name of data
- p1: pointer to data source
- i0: size of data
Outputs
- p0: pointer to created global data area
Description
sys/gd/gdconst creates a global constant data area based on
the data source. The returned global data area should NOT be written to.
Example
None
See also
sys/gd/gdrw
sys/gd/gdfree
Forces a read/write global data area to be freed here and now
Inputs
Outputs
- This function has no return value
Description
Forces the named global data area to be freed. Any attempt to access it
after this call is a Bad Thing. If you need to use the global data again,
it must be set up again using sys/gd/gdrw or
sys/gd/gdconst. Any changes made to the global data will be
lost.
The global data named must be read/write. The effect of calling this with
the name of a constant global data area is presently undefined.
Example
None
See also
sys/gd/gdrw
sys/gd/gdrw
Sets up a read/write global data area
Inputs
- p0: unique name of data
- p1: pointer to data source
- i0: size of data
Outputs
- p0: pointer to created global data area
Description
sys/gd/gdrw creates a global data area which can be read and
written to. The global data will be initialised with the given data source.
The returned global data area can be written to as much as you like.
The created global data area should only be accessed by the process that
created it. It will be automatically deleted when the process exits, unless
already deleted using sys/gd/gdfree.
p1 can be set to null, in which case the global data area is initialized
with nulls. Otherwise, the size of the data passed in i0 must be equal to
the size of the data source pointed to by p1.
Example
None
See also
sys/gd/gdconst
sys/gd/makename (Private)
Generates a system-wide unique name for a global data area
Inputs
- p0: pointer to memory area to which name will be written
- i0: atom of data name
Outputs
- This function has no return value
Description
sys/gd/makename is a private function.
Example
None
See also