dpm_getspacetoken man page

DPM_GETSPACETOKEN(3)         DPM Library Functions        DPM_GETSPACETOKEN(3)

      dpm_getspacetoken - get space token

      [1m#include <sys/types.h>[0m
      [1m#include "dpm_api.h"[0m

      [1mint  dpm_getspacetoken  (const  char  *[4m[22mu_token[24m[1m,  int  *[4m[22mnbreplies[24m[1m,  char[0m

      [1mdpm_getspacetoken [22mgets the list of space tokens  associated  with  this
      user description.

      The input argument is:

             specifies the user provided description associated with a previ-
             ous reservespace request. If the argument is NULL, all the space
             tokens accessible by the user will be listed.

      The output arguments are:

             will  be  set  to  the  number  of replies in the array of space

             will be set to the address of an array of space tokens allocated
             by  the  API.  The client application is responsible for freeing
             the array when not needed anymore.

      This routine returns 0 if the operation was successful  or  -1  if  the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

      [1mEFAULT       [4m[22mnbreplies[24m or [4ms_tokens[24m is a NULL pointer.

      [1mENOMEM       [22mMemory could not be allocated for storing the reply.

      [1mEINVAL       [22mThe  length of the user space token description is greater
                   than 255 or the user space token description is unknown.

      [1mSENOSHOST    [22mHost unknown.

      [1mSEINTERNAL   [22mDatabase error.

      [1mSECOMERR     [22mCommunication error.

LCG                      $Date: 2006/12/20 15:47:54 $     DPM_GETSPACETOKEN(3)