hitls_error.h

浏览该文件的文档.

/*---------------------------------------------------------------------------------------------
 *  This file is part of the openHiTLS project.
 *  Copyright © 2023 Huawei Technologies Co.,Ltd. All rights reserved.
 *  Licensed under the openHiTLS Software license agreement 1.0. See LICENSE in the project root
 *  for license information.
 *---------------------------------------------------------------------------------------------
 */
 
#ifndef HITLS_ERROR_H
#define HITLS_ERROR_H
 
#include <stdint.h>
#include "hitls_type.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
#define HITLS_SUCCESS 0
#define HITLS_X509_V_OK 0
 
#define HITLS_WANT_CONNECT 1
 
#define HITLS_WANT_ACCEPT 2
 
#define HITLS_WANT_READ 3
 
#define HITLS_WANT_WRITE 4
 
#define HITLS_ERR_TLS 5
 
#define HITLS_ERR_SYSCALL  6
 
typedef enum {
    HITLS_NULL_INPUT = 0x02010001,                 
    HITLS_INVALID_INPUT,                           
    HITLS_INTERNAL_EXCEPTION,                      
    HITLS_MEMALLOC_FAIL,                           
    HITLS_MEMCPY_FAIL,                             
    HITLS_UNREGISTERED_CALLBACK,                   
    HITLS_CONFIG_FAIL_START = 0x02020001,          
    HITLS_CONFIG_NO_SUITABLE_CIPHER_SUITE,         
    HITLS_CONFIG_UNSUPPORT_CIPHER_SUITE,           
    HITLS_CONFIG_INVALID_SET,                      
    HITLS_CONFIG_NO_SUITABLE_SIGNATURE_ALGORITHM,  
    HITLS_CONFIG_NO_GROUPS,                        
    HITLS_CONFIG_UNSUPPORT_SIGNATURE_ALGORITHM,    
    HITLS_CONFIG_UNSUPPORT_POINT_FORMATS,          
    HITLS_CONFIG_INVALID_VERSION,                  
    HITLS_CONFIG_INVALID_LENGTH,                   
    HITLS_CONFIG_NO_CERT,                          
    HITLS_CONFIG_NO_PRIVATE_KEY,                   
    HITLS_CONFIG_DUP_DH_KEY_FAIL,                  
    HITLS_CONFIG_DUP_ECDH_KEY_FAIL,                
    HITLS_CONFIG_ERR_LOAD_CERT_FILE,               
    HITLS_CONFIG_ERR_LOAD_CERT_BUFFER,             
    HITLS_CONFIG_ERR_LOAD_KEY_FILE,                
    HITLS_CONFIG_ERR_LOAD_KEY_BUFFER,              
    HITLS_CM_FAIL_START = 0x02030001,              
    HITLS_CM_LINK_FATAL_ALERTED,                   
    HITLS_CM_LINK_CLOSED,                          
    HITLS_CM_LINK_UNESTABLISHED,                   
    HITLS_CM_LINK_UNSUPPORT_SECURE_RENEGOTIATION,  
    HITLS_MSG_HANDLE_FAIL_START = 0x02040001,      
    HITLS_MSG_HANDLE_UNEXPECTED_MESSAGE,           
    HITLS_MSG_HANDLE_RANDOM_SIZE_ERR,              
    HITLS_MSG_HANDLE_UNSUPPORT_POINT_FORMAT,       
    HITLS_MSG_HANDLE_CIPHER_SUITE_ERR,             
    HITLS_MSG_HANDLE_UNSUPPORT_VERSION,            
    HITLS_MSG_HANDLE_STATE_ILLEGAL,                
    HITLS_MSG_HANDLE_UNSUPPORT_KX_ALG,             
    HITLS_MSG_HANDLE_UNSUPPORT_CERT,               
    HITLS_MSG_HANDLE_UNKNOWN_CURVE_TYPE,           
    HITLS_MSG_HANDLE_VERIFY_FINISHED_FAIL,         
    HITLS_MSG_HANDLE_VERIFY_SIGN_FAIL,             
    HITLS_MSG_HANDLE_INCORRECT_DIGEST_LEN,         
    HITLS_MSG_HANDLE_UNSUPPORT_NAMED_CURVE,        
    HITLS_MSG_HANDLE_UNSUPPORT_EXTENSION_TYPE,     
    HITLS_MSG_HANDLE_UNSUPPORT_CIPHER_SUITE,       
    HITLS_MSG_HANDLE_ERR_ENCODE_ECDH_KEY,          
    HITLS_MSG_HANDLE_ERR_ENCODE_DH_KEY,            
    HITLS_MSG_HANDLE_ERR_GET_DH_PARAMETERS,        
    HITLS_MSG_HANDLE_ERR_GET_DH_KEY,               
    HITLS_MSG_HANDLE_NO_PEER_CERTIFIACATE,         
    HITLS_MSG_HANDLE_ERR_NO_SERVER_CERTIFICATE,    
    HITLS_MSG_HANDLE_UNMATCHED_SEQUENCE,           
    HITLS_MSG_HANDLE_ILLEGAL_VERSION,              
    HITLS_MSG_HANDLE_ILLEGAL_CIPHER_SUITE,         
    HITLS_MSG_HANDLE_ILLEGAL_SELECTED_GROUP,       
    HITLS_MSG_HANDLE_ILLEGAL_EXTRENED_MASTER_SECRET, 
    HITLS_MSG_HANDLE_MISSING_EXTENSION,             
    HITLS_MSG_HANDLE_DUPLICATE_HELLO_RETYR_REQUEST, 
    HITLS_MSG_HANDLE_ALPN_PROTOCOL_NO_MATCH,        
    HITLS_MSG_HANDLE_ILLEGAL_PSK_LEN,               
    HITLS_MSG_HANDLE_ILLEGAL_IDENTITY_LEN,          
    HITLS_MSG_HANDLE_GET_UNSIGN_DATA_FAIL,          
    HITLS_MSG_HANDLE_ILLEGAL_SESSION_ID,            
    HITLS_MSG_HANDLE_SNI_UNRECOGNIZED_NAME,         
    HITLS_MSG_HANDLE_ALPN_UNRECOGNIZED,             
    HITLS_MSG_HANDLE_ILLEGAL_KEY_UPDATE_TYPE,       
    HITLS_MSG_HANDLE_UNSECURE_VERSION,              
    HITLS_MSG_HANDLE_UNSECURE_CIPHER_SUITE,         
    HITLS_MSG_HANDLE_RENEGOTIATION_FAIL,            
    HITLS_MSG_HANDLE_SESSION_ID_CTX_ILLEGAL,        
    HITLS_MSG_HANDLE_ENCRYPT_THEN_MAC_ERR,          
    HITLS_MSG_HANDLE_ILLEGAL_PSK_IDENTITY,          
    HITLS_MSG_HANDLE_PSK_USE_SESSION_FAIL,          
    HITLS_MSG_HANDLE_PSK_FIND_SESSION_FAIL,         
    HITLS_MSG_HANDLE_PSK_SESSION_INVALID_CIPHER_SUITE, 
    HITLS_MSG_HANDLE_PSK_INVALID,                   
    HITLS_MSG_HANDLE_INVALID_CERT_REQ_CTX,          
    HITLS_MSG_HANDLE_HANDSHAKE_FAILURE,             
    HITLS_MSG_HANDLE_INVALID_COMPRESSION_METHOD,    
    HITLS_MSG_HANDLE_INVALID_EXTENDED_MASTER_SECRET, 
    HITLS_PACK_FAIL_START = 0x02050001,             
    HITLS_PACK_UNSUPPORT_VERSION,                   
    HITLS_PACK_UNSECURE_VERSION,                    
    HITLS_PACK_UNSUPPORT_HANDSHAKE_MSG,             
    HITLS_PACK_NOT_ENOUGH_BUF_LENGTH,               
    HITLS_PACK_SESSIONID_ERR,                       
    HITLS_PACK_COOKIE_ERR,                          
    HITLS_PACK_CLIENT_CIPHER_SUITE_ERR,             
    HITLS_PACK_UNSUPPORT_KX_ALG,                    
    HITLS_PACK_UNSUPPORT_KX_CURVE_TYPE,             
    HITLS_PACK_INVALID_KX_PUBKEY_LENGTH,            
    HITLS_PACK_SIGNATURE_ERR,                       
    HITLS_PACK_PRE_SHARED_KEY_ERR,                  
    HITLS_PARSE_FAIL_START = 0x02060001,            
    HITLS_PARSE_UNSUPPORT_VERSION,                  
    HITLS_PARSE_UNSUPPORT_HANDSHAKE_MSG,            
    HITLS_PARSE_INVALID_MSG_LEN,                    
    HITLS_PARSE_DUPLICATE_EXTENDED_MSG,             
    HITLS_PARSE_COMPRESSION_METHOD_ERR,             
    HITLS_PARSE_SERVER_NAME_ERR,                    
    HITLS_PARSE_CERT_ERR,                           
    HITLS_PARSE_ECDH_PUBKEY_ERR,                    
    HITLS_PARSE_ECDH_SIGN_ERR,                      
    HITLS_PARSE_UNSUPPORT_KX_ALG,                   
    HITLS_PARSE_UNSUPPORT_KX_CURVE_TYPE,            
    HITLS_PARSE_GET_SIGN_PARA_ERR,                  
    HITLS_PARSE_UNSUPPORT_SIGN_ALG,                 
    HITLS_PARSE_VERIFY_SIGN_FAIL,                   
    HITLS_PARSE_DH_P_ERR,                           
    HITLS_PARSE_DH_G_ERR,                           
    HITLS_PARSE_DH_PUBKEY_ERR,                      
    HITLS_PARSE_DH_SIGN_ERR,                        
    HITLS_PARSE_UNSUPPORTED_EXTENSION,              
    HTILS_PARSE_EXCESSIVE_MESSAGE_SIZE,             
    HTILS_PARSE_PRE_SHARED_KEY_FAILED,              
    HTILS_PARSE_DUPLICATED_KEY_SHARE,               
    HITLS_REASS_FAIL_START = 0x02070001,            
    HITLS_REASS_INVALID_FRAGMENT,                   
    HITLS_CCS_FAIL_START = 0x02080001,              
    HITLS_CCS_INVALID_CMD,                          
    HITLS_ALERT_FAIL_START = 0x02090001,            
    HITLS_ALERT_NO_WANT_SEND,                       
    HITLS_REC_FAIL_START = 0x020A0001,              
    HITLS_REC_PMTU_TOO_SMALL,                       
    HITLS_REC_ERR_BUFFER_NOT_ENOUGH,                
    HITLS_REC_ERR_TOO_BIG_LENGTH,                   
    HITLS_REC_ERR_NOT_SUPPORT_CIPHER,              
    HITLS_REC_ERR_ENCRYPT,                         
    HITLS_REC_ERR_AEAD_NONCE_PARAM,                
    HITLS_REC_ERR_SN_WRAPPING,                     
    HITLS_REC_ERR_IO_EXCEPTION,                    
    HITLS_REC_NORMAL_IO_BUSY,                      
    HITLS_REC_NORMAL_RECV_BUF_EMPTY,               
    HITLS_REC_NORMAL_RECV_UNEXPECT_MSG,            
    HITLS_REC_NORMAL_RECV_DISORDER_MSG,            
    HITLS_REC_INVLAID_RECORD,                      
    HITLS_REC_INVALID_PROTOCOL_VERSION,            
    HITLS_REC_BAD_RECORD_MAC,                      
    HITLS_REC_DECODE_ERROR,                        
    HITLS_REC_RECORD_OVERFLOW,                     
    HITLS_REC_ERR_RECV_UNEXPECTED_MSG,             
    HITLS_REC_ERR_GENERATE_MAC,                    
    HITLS_REC_NORMAL_IO_EOF,                       
    HITLS_REC_ENCRYPTED_NUMBER_OVERFLOW,           
    HITLS_REC_ERR_MSAK_APP_MSG,                    
    HITLS_UIO_FAIL_START = 0x020B0001,             
    HITLS_UIO_FAIL,                                
    HITLS_UIO_IO_EXCEPTION,                        
    HITLS_UIO_SCTP_IS_SND_BUF_EMPTY_FAIL,          
    HITLS_UIO_SCTP_ADD_AUTH_KEY_FAIL,              
    HITLS_UIO_SCTP_ACTIVE_AUTH_KEY_FAIL,           
    HITLS_UIO_SCTP_DEL_AUTH_KEY_FAIL,              
    HITLS_CERT_FAIL_START = 0x020C0001,            
    HITLS_CERT_STORE_ERR_NEW,                      
    HITLS_CERT_STORE_CTRL_ERR_SET_VERIFY_DEPTH,    
    HITLS_CERT_STORE_CTRL_ERR_ADD_CERT_LIST,       
    HITLS_CERT_ERR_X509_DUP,                       
    HITLS_CERT_ERR_KEY_DUP,                        
    HITLS_CERT_ERR_STORE_DUP,                      
    HITLS_CERT_ERR_CHAIN_DUP,                      
    HITLS_CERT_CTRL_ERR_GET_ENCODE_LEN,            
    HITLS_CERT_CTRL_ERR_GET_PUB_KEY,               
    HITLS_CERT_CTRL_ERR_GET_SIGN_ALGO,             
    HITLS_CERT_KEY_CTRL_ERR_GET_SIGN_LEN,          
    HITLS_CERT_KEY_CTRL_ERR_GET_TYPE,              
    HITLS_CERT_KEY_CTRL_ERR_GET_CURVE_NAME,        
    HITLS_CERT_KEY_CTRL_ERR_GET_POINT_FORMAT,      
    HITLS_CERT_KEY_CTRL_ERR_GET_SECBITS,           
    HITLS_CERT_KEY_CTRL_ERR_IS_ENC_USAGE,          
    HITLS_CERT_KEY_CTRL_ERR_IS_DIGITAL_SIGN_USAGE,  
    HITLS_CERT_KEY_CTRL_ERR_IS_KEY_CERT_SIGN_USAGE, 
    HITLS_CERT_KEY_CTRL_ERR_IS_KEY_AGREEMENT_USAGE, 
    HITLS_CERT_ERR_INVALID_KEY_TYPE,                
    HITLS_CERT_ERR_CHECK_CERT_AND_KEY,              
    HITLS_CERT_ERR_NO_CURVE_MATCH,                  
    HITLS_CERT_ERR_NO_POINT_FORMAT_MATCH,           
    HITLS_CERT_ERR_NO_SIGN_SCHEME_MATCH,            
    HITLS_CERT_ERR_SELECT_CERTIFICATE,              
    HITLS_CERT_ERR_BUILD_CHAIN,                     
    HITLS_CERT_ERR_ENCODE_CERT,                     
    HITLS_CERT_ERR_PARSE_MSG,                       
    HITLS_CERT_ERR_VERIFY_CERT_CHAIN,               
    HITLS_CERT_ERR_CREATE_SIGN,                     
    HITLS_CERT_ERR_VERIFY_SIGN,                     
    HITLS_CERT_ERR_ENCRYPT,                         
    HITLS_CERT_ERR_DECRYPT,                         
    HITLS_CERT_ERR_ADD_CHAIN_CERT,                  
    HITLS_CERT_ERR_MGR_DUP,                         
    HITLS_CERT_ERR_INSECURE_SIG_ALG,                
    HITLS_CERT_ERR_CA_KEY_WITH_INSECURE_SECBITS,    
    HITLS_CERT_ERR_EE_KEY_WITH_INSECURE_SECBITS,    
    HITLS_CERT_ERR_EXP_CERT,                        
    HITLS_CERT_ERR_ENCODE,                          
    HITLS_CERT_ERR_KEYUSAGE,                        
    HITLS_CERT_ERR_INVALID_STORE_TYPE,              
    HITLS_CERT_ERR_X509_REF,                        
    HITLS_CRYPT_FAIL_START = 0x020D0001,           
    HITLS_CRYPT_ERR_GENERATE_RANDOM,               
    HITLS_CRYPT_ERR_HMAC,                          
    HITLS_CRYPT_ERR_DIGEST,                        
    HITLS_CRYPT_ERR_ENCRYPT,                       
    HITLS_CRYPT_ERR_DECRYPT,                       
    HITLS_CRYPT_ERR_ENCODE_ECDH_KEY,               
    HITLS_CRYPT_ERR_CALC_SHARED_KEY,               
    HITLS_CRYPT_ERR_ENCODE_DH_KEY,                 
    HITLS_CRYPT_ERR_HKDF_EXTRACT,                  
    HITLS_CRYPT_ERR_HKDF_EXPAND,                   
    HITLS_APP_FAIL_START = 0x020E0001,             
    HITLS_APP_ERR_TOO_LONG_TO_WRITE,               
    HITLS_APP_ERR_ZERO_READ_BUF_LEN,               
    HITLS_CLIENT_HELLO_CHECK_ERROR,                
    HITLS_SESS_FAIL_START = 0x020F0001,            
    HITLS_SESS_ERR_SESSION_ID_GENRATE,             
    HITLS_SESS_ERR_DECODE_TICKET,                  
    HITLS_SESS_ERR_SESSION_TICKET_SIZE_INCORRECT,  
    HITLS_SESS_ERR_SESSION_TICKET_HMAC_FAIL,       
    HITLS_SESS_ERR_SESSION_TICKET_KEY_FAIL,        
    HITLS_SESS_ERR_ENC_VERIFY_RESULT_FAIL,         
    HITLS_SESS_ERR_ENC_MASTER_SECRET_FAIL,         
    HITLS_SESS_ERR_ENC_EXT_MASTER_SECRET_FAIL,     
    HITLS_SESS_ERR_ENC_SESSION_ID_FAIL,            
    HITLS_SESS_ERR_ENC_SESSION_ID_CTX_FAIL,        
    HITLS_SESS_ERR_ENC_HOST_NAME_FAIL,             
    HITLS_SESS_ERR_ENC_TIME_OUT_FAIL,              
    HITLS_SESS_ERR_ENC_VERSION_FAIL,               
    HITLS_SESS_ERR_ENC_CIPHER_SUITE_FAIL,          
    HITLS_SESS_ERR_ENC_START_TIME_FAIL,            
    HITLS_SESS_ERR_ENC_PSK_IDENTITY_FAIL,          
    HITLS_SESS_ERR_DEC_VERIFY_RESULT_FAIL,         
    HITLS_SESS_ERR_DEC_VERSION_FAIL,               
    HITLS_SESS_ERR_DEC_CIPHER_SUITE_FAIL,          
    HITLS_SESS_ERR_DEC_MASTER_SECRET_FAIL,         
    HITLS_SESS_ERR_DEC_PSK_IDENTITY_FAIL,          
    HITLS_SESS_ERR_DEC_START_TIME_FAIL,            
    HITLS_SESS_ERR_DEC_TIME_OUT_FAIL,              
    HITLS_SESS_ERR_DEC_HOST_NAME_FAIL,             
    HITLS_SESS_ERR_DEC_SESSION_ID_CTX_FAIL,        
    HITLS_SESS_ERR_DEC_SESSION_ID_FAIL,            
    HITLS_SESS_ERR_DEC_EXT_MASTER_SECRET_FAIL,     
    HITLS_X509_FAIL_START = 0x02100001,            
    HITLS_X509_V_ERR_UNSPECIFIED,
    HITLS_X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT,
    HITLS_X509_V_ERR_UNABLE_TO_GET_CRL,
    HITLS_X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE,
    HITLS_X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE,
    HITLS_X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY,
    HITLS_X509_V_ERR_CERT_SIGNATURE_FAILURE,
    HITLS_X509_V_ERR_CRL_SIGNATURE_FAILURE,
    HITLS_X509_V_ERR_CERT_NOT_YET_VALID,
    HITLS_X509_V_ERR_CERT_HAS_EXPIRED,
    HITLS_X509_V_ERR_CRL_NOT_YET_VALID,
    HITLS_X509_V_ERR_CRL_HAS_EXPIRED,
    HITLS_X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD,
    HITLS_X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD,
    HITLS_X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD,
    HITLS_X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD,
    HITLS_X509_V_ERR_OUT_OF_MEM,
    HITLS_X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT,
    HITLS_X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN,
    HITLS_X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY,
    HITLS_X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE,
    HITLS_X509_V_ERR_CERT_CHAIN_TOO_LONG,
    HITLS_X509_V_ERR_CERT_REVOKED,
    HITLS_X509_V_ERR_INVALID_CA,
    HITLS_X509_V_ERR_PATH_LENGTH_EXCEEDED,
    HITLS_X509_V_ERR_INVALID_PURPOSE,
    HITLS_X509_V_ERR_CERT_UNTRUSTED,
    HITLS_X509_V_ERR_CERT_REJECTED,
    HITLS_X509_V_ERR_SUBJECT_ISSUER_MISMATCH,
    HITLS_X509_V_ERR_AKID_SKID_MISMATCH,
    HITLS_X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH,
    HITLS_X509_V_ERR_KEYUSAGE_NO_CERTSIGN,
    HITLS_X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER,
    HITLS_X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION,
    HITLS_X509_V_ERR_KEYUSAGE_NO_CRL_SIGN,
    HITLS_X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION,
    HITLS_X509_V_ERR_INVALID_NON_CA,
    HITLS_X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED,
    HITLS_X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE,
    HITLS_X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED,
    HITLS_X509_V_ERR_INVALID_EXTENSION,
    HITLS_X509_V_ERR_INVALID_POLICY_EXTENSION,
    HITLS_X509_V_ERR_NO_EXPLICIT_POLICY,
    HITLS_X509_V_ERR_DIFFERENT_CRL_SCOPE,
    HITLS_X509_V_ERR_ERROR_IN_CMP_CERT_NOT_AFTER_FIELD,
    HITLS_X509_V_ERR_ERROR_IN_CMP_CRL_THIS_UPDATE_FIELD,
    HITLS_X509_V_ERR_ERROR_IN_CMP_CRL_NEXT_UPDATE_FIELD,
    HITLS_X509_V_ERR_ERROR_IN_CMP_CERT_NOT_BEFORE_FIELD,
    HITLS_X509_V_ERR_CRL_PATH_VALIDATION_ERROR,
} HITLS_ERROR;
 
int32_t HITLS_GetError(const HITLS_Ctx *ctx, int32_t ret);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* end HITLS_ERROR_H */