1DPM_GETSPACETOKEN(3)         DPM Library Functions        DPM_GETSPACETOKEN(3)
2
3
4

NAME

6       dpm_getspacetoken - get space token
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpm_api.h"
11
12       int  dpm_getspacetoken  (const  char  *u_token,  int  *nbreplies,  char
13       ***s_tokens)
14

DESCRIPTION

16       dpm_getspacetoken gets the list of space tokens  associated  with  this
17       user description.
18
19       The input argument is:
20
21       u_token
22              specifies the user provided description associated with a previ‐
23              ous reservespace request. If the argument is NULL, all the space
24              tokens accessible by the user will be listed.
25
26       The output arguments are:
27
28       nbreplies
29              will  be  set  to  the  number  of replies in the array of space
30              tokens.
31
32       s_tokens
33              will be set to the address of an array of space tokens allocated
34              by  the  API.  The client application is responsible for freeing
35              the array when not needed anymore.
36

RETURN VALUE

38       This routine returns 0 if the operation was successful  or  -1  if  the
39       operation failed. In the latter case, serrno is set appropriately.
40

ERRORS

42       EFAULT       nbreplies or s_tokens is a NULL pointer.
43
44       ENOMEM       Memory could not be allocated for storing the reply.
45
46       EINVAL       The  length of the user space token description is greater
47                    than 255 or the user space token description is unknown.
48
49       SENOSHOST    Host unknown.
50
51       SEINTERNAL   Database error.
52
53       SECOMERR     Communication error.
54
55
56
57LCG                      $Date: 2006/12/20 15:47:54 $     DPM_GETSPACETOKEN(3)
Impressum