dpm_getreqid man page

DPM_GETREQID(3)              DPM Library Functions             DPM_GETREQID(3)

[1mNAME[0m
      dpm_getreqid - get request id for a set of requests

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

      [1mint  dpm_getreqid  (char *[4m[22mu_token[24m[1m, int *[4m[22mnbreplies[24m[1m, struct dpm_tokeninfo[0m
      [1m**[4m[22mtokeninfos[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpm_getreqid [22mgets request id for a set of requests.

      The input argument is:

      [4mu_token[0m
             specifies the user provided description associated with a previ-
             ous get/put/copy request.

      The output arguments are:

      [4mnbreplies[0m
             will  be  set  to  the  number  of replies in the array of token
             infos.

      [4mtokeninfos[0m
             will be set to the address of an array of  dpm_tokeninfo  struc-
             tures  allocated by the API. The client application is responsi-
             ble for freeing the array when not needed anymore.

      struct dpm_tokeninfo {
           char      r_token[CA_MAXDPMTOKENLEN+1];
           time_t    c_time;
      };

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

[1mERRORS[0m
      [1mEFAULT       [4m[22mnbreplies[24m or [4mtokeninfos[24m is a NULL pointer.

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

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

      [1mSENOSHOST    [22mHost unknown.

      [1mSEINTERNAL   [22mDatabase error.

      [1mSECOMERR     [22mCommunication error.

LCG                      $Date: 2006/02/17 06:47:32 $          DPM_GETREQID(3)