next up previous contents
Next: 11.8 fluke_ref_destroy: destroy a Up: 11 References Previous: 11.6 fluke_ref_copy: make a

11.7 fluke_ref_create: create a new reference object

SYNOPSIS

fluke_error_t fluke_ref_create( fluke_ref_t *new_ref);

DESCRIPTION

Creates a new reference object. The reference is initially not associated with any object; i.e. it is null.

PARAMETERS

new_ref
A pointer to the address in the current task's address space at which to create the new reference object.

ERRORS

If any of the following errors is detected, the appropriate error code is returned: All of these have an implicit FLUKE_ prefix.
NO_MEMORY
Insufficient resources were available.

If any of the following errors is detected by the Fluke implementation, it causes the current thread to take a synchronous exception with one of the following codes. All of these have an implicit FLUKE_INSANITY_ prefix.
OBJECT_EXISTS
An object already exists at the location pointed to by new_ref.
NOT_ALIGNED
new_ref is not properly aligned for a reference object.

RELATED INFORMATION

fluke_ref_destroy



Utah Flux Research Group