Tspi_ChangeAuthAsym - man pages section 3: Library Interfaces and Headers

Language:

Tspi_ChangeAuthAsym (3)

Name

Tspi_ChangeAuthAsym - change the authorization data of an entity using asymmetric change protocol.

Synopsis

#include <tss/platform.h>
#include <tss/tcpa_defines.h>
#include <tss/tcpa_typedef.h>
#include <tss/tcpa_struct.h>
#include <tss/tss_typedef.h>
#include <tss/tss_structs.h>
#include <tss/tspi.h>

TSS_RESULT Tspi_ChangeAuthAsym(TSS_HOBJECT hObjectToChange, TSS_HOBJECT hParentObject,
TSS_HKEY    hIdentKey,       TSS_HPOLICY hNewPolicy);

Description

TCG Software Stack Developer's Reference                Tspi_ChangeAuthAsym(3)



NAME
       Tspi_ChangeAuthAsym  - change the authorization data of an entity using
       asymmetric change protocol.

SYNOPSIS
       #include <tss/platform.h>
       #include <tss/tcpa_defines.h>
       #include <tss/tcpa_typedef.h>
       #include <tss/tcpa_struct.h>
       #include <tss/tss_typedef.h>
       #include <tss/tss_structs.h>
       #include <tss/tspi.h>

       TSS_RESULT Tspi_ChangeAuthAsym(TSS_HOBJECT hObjectToChange, TSS_HOBJECT hParentObject,
                                      TSS_HKEY    hIdentKey,       TSS_HPOLICY hNewPolicy);



DESCRIPTION
       Tspi_ChangeAuthAsym  changes the authorization data (secret) of an  en-
       tity  (object) utilizing the asymmetric change protocol and assigns the
       object to the policy object. All classes  using  secrets  provide  this
       method  for changing their authorization data.  This method changes the
       authorization data of an object ensuring that the parent of the  object
       does not get knowledge of the new secret.

PARAMETERS
   hObjectToChange
       Handle of the object the authorization data should be changed.

   hParentObject
       Handle  of  the parent object wrapping the object addressed by hObject-
       ToChange.

   hIdentKey
       Handle of the identity key object required to proof the internally cre-
       ated temporary key.

   hNewPolicy
       Handle of the policy object providing the new authorization data.

RETURN CODES
       Tspi_ChangeAuthAsym  returns  TSS_SUCCESS  on success, otherwise one of
       the following values are returned:

       TSS_E_INVALID_HANDLE - Either hObjectToChange, hParentObject, or hIden-
       tKey is an invalid handle.

       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.


CONFORMING TO
       Tspi_ChangeAuthAsym  conforms  to  the Trusted Computing Group Software
       Specification version 1.1 Golden


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | library/security/trousers |
       +---------------+---------------------------+
       |Stability      | Uncommitted               |
       +---------------+---------------------------+

SEE ALSO
       Tspi_ChangeAuth(3).



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at https://github.com/or-
       acle/solaris-userland.   The  original  community source was downloaded
       from                                                    https://source-
       forge.net/projects/trousers/files/trousers/0.3.15/trousers-0.3.15.tar.gz.

       Further information about this software can be found on the open source
       community website at http://trousers.sourceforge.net/.



TSS 1.1                           2004-05-26            Tspi_ChangeAuthAsym(3)