/* SPDX-License-Identifier: (GPL-2.0+ OR MIT) */
/*
 * include/amlogic/storagekey.h
 *
 * Copyright (C) 2020 Amlogic, Inc. All rights reserved.
 *
 */

#ifndef __STORAGEKEY_H__
#define __STORAGEKEY_H__


/* storage key interface */
/**
 *1.amlkey_init: init storage key
 * return ok 0, fail not 0
 */
extern int32_t amlkey_init(uint8_t *seed, uint32_t len);

/**
 *2. amlkey_isexsit: query key, already programmed ?
 * return: exsit 1, non 0
 */
extern int32_t amlkey_isexsit(const uint8_t * name);

/**
 * 3. query if the key is secure
 * return secure 1, non 0;
 */
extern int32_t amlkey_issecure(const uint8_t * name);

/**
 * 4. amlkey_size: actual bytes of key value
 *  return actual size.
 */
extern ssize_t amlkey_size(const uint8_t *name);

/**
 *5. amlkey_read: read non-secure key in bytes.
 * return actual size read back; 0 means read failed!
 */
extern ssize_t amlkey_read(const uint8_t *name,
				uint8_t *buffer, uint32_t len);

/**
 * 6. amlkey_write: write secure/non-secure key in bytes.
 * return actual size write down. 0 means write failed!
 */
extern ssize_t amlkey_write(const uint8_t *name,
				uint8_t *buffer, uint32_t len, uint32_t secure);

/**
 * 7. get the hash value of programmed secure key | 32bytes length, sha256
 * return success 0, fail -1
 */
extern int32_t amlkey_hash_4_secure(const uint8_t * name, uint8_t * hash);

/**
 * 8. amlkey_del: del key by name
 * return success 0, fail non-0.
 */
extern int32_t amlkey_del(const uint8_t * name);


#endif /* __STORAGEKEY_H__ */