RFLAT(2)

NAME
rflat - Tag and load storage on LAM remote nodes.

SYNOPSIS

int rflat (int node, char *buffer, int ld_length, int ma_length, int tag);

int rflclean (int node, int tag);

ARGUMENTS

node
    where data will be stored

buffer
    data to be stored

ld_length
    length of data to be stored

ma_length
    length of storage to allocate

tag label to assign to remote storage for future reference

DESCRIPTION
The tag serves as a symbolic name, and is not related to the actual address of the allocated remote storage. The flat daemon remembers the tag. A later call to rget(2) can retrieve the actual address of the storage.

The ld_length and ma_length arguments are almost always set to the same value. A larger value for ma_length (the only other possibility) allows extra contiguous storage to be allocated but not loaded.

The rflclean() function frees any storage associated with the flat tag. It also deletes the flat tag.

ERRORS

ENOFLDESCRIPTORS
    The table of storage addresses (kept by the flat server) is full.

SEE ALSO
rget(2), rload(2)