X-Git-Url: https://git.proxmox.com/?p=mirror_edk2.git;a=blobdiff_plain;f=MdePkg%2FInclude%2FProtocol%2FKms.h;h=57b006e10d4a51d79f302d762b224b75e7189e0c;hp=1d2dcc64f8ed75136c72b04ee0490b0db65288b4;hb=9095d37b8fe5bfc3d02adad6ba7fd7359ebc0107;hpb=d1102dba7210b95e41d06c2338a22ba6af248645 diff --git a/MdePkg/Include/Protocol/Kms.h b/MdePkg/Include/Protocol/Kms.h index 1d2dcc64f8..57b006e10d 100644 --- a/MdePkg/Include/Protocol/Kms.h +++ b/MdePkg/Include/Protocol/Kms.h @@ -8,7 +8,7 @@ server over the network, or to a Hardware Security Module (HSM) attached to the system it runs on, or anything else that is capable of providing the key management service. - Copyright (c) 2011 - 2017, Intel Corporation. All rights reserved.
+ Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License that accompanies this distribution. The full text of the license may be found at @@ -373,7 +373,7 @@ EFI_STATUS @param[in] This Pointer to the EFI_KMS_PROTOCOL instance. @param[in] Client Pointer to a valid EFI_KMS_CLIENT_INFO structure. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -388,11 +388,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -418,7 +418,7 @@ EFI_STATUS IN EFI_KMS_CLIENT_INFO *Client, IN OUT UINTN *ClientDataSize OPTIONAL, IN OUT VOID **ClientData OPTIONAL - ); + ); /** Request that the KMS generate one or more new keys and associate them with key identifiers. @@ -454,7 +454,7 @@ EFI_STATUS type and must be freed by the caller when it is no longer needed. Also, the KeyStatus field must reflect the result of the request relative to that key. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -469,11 +469,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -535,12 +535,12 @@ EFI_STATUS On output, the KeyIdentifierSize and KeyIdentifier fields will be unchanged, while the KeyFormat and KeyValue fields will be updated values associated with this key - identifier. Memory for the KeyValue field will be + identifier. Memory for the KeyValue field will be allocated with the BOOT_SERVICES_DATA type and must be freed by the caller when it is no longer needed. Also, the KeyStatus field will reflect the result of the request relative to the individual key descriptor. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -555,11 +555,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -626,7 +626,7 @@ EFI_STATUS consistent values to be associated with the given KeyId. On return, the KeyStatus field will reflect the result of the operation for each key request. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -641,11 +641,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -711,7 +711,7 @@ EFI_STATUS KeyValue fields are ignored, but should be 0. On return, the KeyStatus field will reflect the result of the operation for each key request. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -726,11 +726,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -789,7 +789,7 @@ EFI_STATUS On input, the fields in the structure should be NULL. On output, the attribute fields will have updated values for attributes associated with this key identifier. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -804,11 +804,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -876,7 +876,7 @@ EFI_STATUS are completely filled in. On return the KeyAttributeStatus field will reflect the result of the operation for each key attribute request. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -891,11 +891,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -967,7 +967,7 @@ EFI_STATUS are completely filled in. On return the KeyAttributeStatus field will reflect the result of the operation for each key attribute request. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -982,11 +982,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol @@ -1064,7 +1064,7 @@ EFI_STATUS caller when it is no longer needed. Also, the KeyStatus field of each descriptor will reflect the result of the request relative to that key descriptor. - @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of + @param[in, out] ClientDataSize Pointer to the size, in bytes, of an arbitrary block of data specified by the ClientData parameter. This parameter may be NULL, in which case the ClientData parameter will be ignored and no data will be @@ -1079,11 +1079,11 @@ EFI_STATUS which will be zero if no data is returned from the KMS. @param[in, out] ClientData Pointer to a pointer to an arbitrary block of data of *ClientDataSize that is to be passed directly to the - KMS if it supports the use of client data. This - parameter may be NULL if and only if the + KMS if it supports the use of client data. This + parameter may be NULL if and only if the ClientDataSize parameter is also NULL. Upon return to - the caller, *ClientData points to a block of data of - *ClientDataSize that was returned from the KMS. + the caller, *ClientData points to a block of data of + *ClientDataSize that was returned from the KMS. If the returned value for *ClientDataSize is zero, then the returned value for *ClientData must be NULL and should be ignored by the caller. The KMS protocol