pal_plat_drbg.h

Go to the documentation of this file.

/*******************************************************************************
 * Copyright 2016, 2017 ARM Ltd.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *******************************************************************************/


#ifndef _PAL_PLAT_DRBG_H
#define _PAL_PLAT_DRBG_H

#ifdef __cplusplus
extern "C" {
#endif

#include "pal.h"


palStatus_t pal_plat_DRBGInit(void);

palStatus_t pal_plat_DRBGDestroy(void);

// XXX: following two are really easy to mix up, a better naming needs to be done
//
// * pal_plat_osRandomBuffer_public() - The one which is called by pal_osRandomBuffer(), one which
//                                      will block until there is enough entropy harvested
//
// * pal_plat_osRandomBuffer() - The lower level part, used by pal_plat_osRandomBuffer_public(),
//                                  this is nonblocking version which will return as much as possible.
//                               Perhaps this should be pal_plat_GetosRandomBufferFromHW() to align
//                               with logic used with similar purpose function as pal_plat_osGetRoTFromHW().

palStatus_t pal_plat_osRandomBuffer(uint8_t *randomBuf, size_t bufSizeBytes, size_t* actualRandomSizeBytes);

palStatus_t pal_plat_osRandomBuffer_blocking(uint8_t *randomBuf, size_t bufSizeBytes);

#ifdef __cplusplus
}
#endif
#endif //_PAL_PLAT_RTOS_H