*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> GetTimeValue (3)              
Title
Content
Arch
Section
 

GetTimeValue(3)

Contents


NAME    [Toc]    [Back]

       GetTimeValue,  CSSM_GetTimeValue, CSP_GetTimeValue - Get a
       CSP time value (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_GetTimeValue  (CSSM_CSP_HANDLE
  CSPHandle,  CSSM_ALGORITHMS  TimeAlgorithm, CSSM_DATA
       *TimeData)  SPI:  CSSM_RETURN  CSSMCSPI   CSP_GetTimeValue
       (CSSM_CSP_HANDLE CSPHandle, CSSM_ALGORITHMS TimeAlgorithm,
       kCSSM_DATA *TimeData)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       Handle of the cryptographic  service  provider  that  will
       perform  the  operation.  A CSSM algorithm type that indicates
 the method for  fetching  the  time.  The  following
       algorithm types are currently supported:

              CSSM_ALGID_UTC  Returns  a  time  value in the form
              YYYYMMDDhhmmss (4 characters for the year; 2  characters
  each  for the month, the day, the hour, the
              minute, and the second). The time returned is  GMT.

              CSSM_ALGID_RUNNING_COUNTER  The  current value of a
              running hardware counter that  operates  while  the
              device is in operation. This value can be read from
              a  processor  counter  provided  by  some  platform
              architectures.   The  time  value  of counter value
              returned in response to the request.

DESCRIPTION    [Toc]    [Back]

       This function returns a time value maintained  by  a  CSP.
       This  feature  will  be  supported  primarily  by hardware
       tokens with an onboard real time clock.

NOTES    [Toc]    [Back]

       The output is returned to the caller either by filling the
       caller-specified  buffer  or  by  using  the application's
       declared memory allocation functions  to  allocate  buffer
       space.  To specify a specific, preallocated output buffer,
       the caller must provide an array of one or more  CSSM_DATA
       structures,  each  containing a Length field value greater
       than zero and a non-NULL  data  pointer  field  value.  To
       specify automatic output buffer allocation by the CSP, the
       caller must provide an array  of  one  or  more  CSSM_DATA
       structures,  each containing a Length field value equal to
       zero and a NULL data pointer field value. The  application
       is  always responsible for deallocating the memory when it
       is no longer needed.

       Some tokens require authentication before returning a time
       value.





RETURN VALUE    [Toc]    [Back]

       A  CSSM_RETURN  value  indicating  success or specifying a
       particular error condition. The  value  CSSM_OK  indicates
       success. All other values represent an error condition.

ERRORS    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).

       None specific to this call.

SEE ALSO    [Toc]    [Back]

      
      
       Books

       Intel   CDSA   Application    Developer's    Guide    (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]




                                                  GetTimeValue(3)
[ Back ]
 Similar pages
Name OS Title
create_link HP-UX Creates a soft link and optionally specifies an expiration time and an extension time
vxfs_ifree_timelag HP-UX VxFS inode free time lag (specifies the minimum time to be spent on a freelist)
adjkerntz FreeBSD adjust local time CMOS clock to reflect time zone changes and keep current timezone offset for the k...
settimeofday64 Tru64 Gets and sets date and time and converts time between timeval and timeval64
settimeofday Tru64 Gets and sets date and time and converts time between timeval and timeval64
gettimeofday64 Tru64 Gets and sets date and time and converts time between timeval and timeval64
gettimeofday Tru64 Gets and sets date and time and converts time between timeval and timeval64
ftime Tru64 Gets and sets date and time and converts time between timeval and timeval64
TIMEVAL64TO32 Tru64 Gets and sets date and time and converts time between timeval and timeval64
TIMEVAL32TO64 Tru64 Gets and sets date and time and converts time between timeval and timeval64
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service