1RGET(2) LAM REMOTE LIBRARY RGET(2)
2
6 rget, rforget - Find tagged storage on a LAM remote node.
7
9 char *rget (int node, int tag);
10 char *rforget (int node, int tag);
11
13 The flat storage service allows data to be loaded onto a remote node,
14 stored in a remote file, and assigned a reference tag by the client.
15 The client can then send the tag to any process on the remote node and
16 that process can convert the tag locally, using either rget() or rfor‐
17 get(), to the stored filename. The flat storage service has two impor‐
18 tant purposes. It allows remote servers to remain stateless vis-a-vis
19 incoming message packets when a large dataset or file need to be trans‐
20 ferred to the server (e.g. loading and running a program). There is no
21 load on the buffers and no chance of memory deadlock. Secondly, in
22 multicast operations, it gives the client the power to refer to remote
23 storage by the same tag value on several nodes. Thus, one message con‐
24 taining a tag value can be efficiently multicasted.
25 The tag is preserved by rget() but removed by rforget(). The latter
27 function should be used if the tag will not be used again, to avoid
28 overflow of the associated tables.
29
31 Upon successful completion, the actual filename of the remote storage
32 is returned. If an error occurred, -1 is returned and the global vari‐
33 able errno is set to indicate the error.
34
36 EBADTAG The tag is unknown.
37
39 rflat(2), rload(2)
40LAM 7.1.2 March, 2006 RGET(2)