Tspi_ChangeAuth - man pages section 3: Library Interfaces and Headers

Language:

Tspi_ChangeAuth (3)

Name

Tspi_ChangeAuth - change the authorization data of an entity.

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_ChangeAuth(TSS_HOBJECT hObjectToChange, TSS_HOBJECT hParentObject,
TSS_HPOLICY hNewPolicy );

Description

TCG Software Stack Developer's Reference                   Tspi_Change_Auth(3)



NAME
       Tspi_ChangeAuth - change the authorization data of an entity.

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_ChangeAuth(TSS_HOBJECT hObjectToChange, TSS_HOBJECT hParentObject,
                                  TSS_HPOLICY hNewPolicy );



DESCRIPTION
       Tspi_ChangeAuth   changes  the authorization data (secret) of an entity
       (object) and assigns the object to the policy object. All classes using
       secrets provide this method for changing their authorization data.

PARAMETERS
   hObjectToChange
       Handle of the object to change authorization for.

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

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

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

       TSS_E_INVALID_HANDLE - Either hObjectToChange, or hParentObject are not
       a valid handle.

       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.


CONFORMING TO
       Tspi_ChangeAuth conforms to the Trusted Computing Group Software Speci-
       fication 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_ChangeAuthAsym(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_Change_Auth(3)