leo hendrickson / Mbed OS example-Ethernet-mbed-Cloud-connect

simple-mbed-cloud-client/mbed-cloud-client/certificate-enrollment-client/certificate-enrollment-client/ce_status.h

Committer:
leothedragon
Date:
2021-05-04
Revision:
0:8f0bb79ddd48

File content as of revision 0:8f0bb79ddd48:

// ----------------------------------------------------------------------------
// Copyright 2018 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 __CE_STATUS_H__
#define __CE_STATUS_H__

#ifdef __cplusplus
extern "C" {
#endif

    /**
    * @file ce_status.h
    *  \brief Certificate Enrollment (CE) status and error codes.
    * This list may grow as needed.
    */

#define CE_STATUS_RANGE_BASE 0x0500
#define CE_STATUS_RANGE_END 0x05ff

typedef enum {
    CE_STATUS_SUCCESS = 0,                    //!< Operation completed successfully.
    CE_STATUS_ERROR = CE_STATUS_RANGE_BASE,   //!< Operation ended with an unspecified error.
    CE_STATUS_INVALID_PARAMETER,              //!< A parameter provided to the function was invalid.
    CE_STATUS_INSUFFICIENT_BUFFER,            //!< The provided buffer size was insufficient for the required output.
    CE_STATUS_OUT_OF_MEMORY,                  //!< An out-of-memory condition occurred.
    CE_STATUS_ITEM_NOT_FOUND,                 //!< The item was not found in the storage.
    CE_STATUS_DEVICE_BUSY,                    //!< The device is processing too many certificate renewals.
    CE_STATUS_BAD_INPUT_FROM_SERVER,          //!< The server sent a TLV that is either unsupported or malformed
    CE_STATUS_EST_ERROR,                      //!< An error during enrollment over secure transport (EST) occurred.
    CE_STATUS_STORAGE_ERROR,                  //!< The storage operation ended with an error.
    CE_STATUS_RENEWAL_ITEM_VALIDATION_ERROR,  //!< Operation failed to validate renewal items.
    CE_STATUS_BACKUP_ITEM_ERROR,              //!< Operation failed to create/read/validate backup items.
    CE_STATUS_ORIGINAL_ITEM_ERROR,            //!< Operation failed to create/read/validate original items.
    CE_STATUS_RESTORE_BACKUP_ERROR,           //!< Operation failed to restore backup items.
    CE_STATUS_RENEWAL_STATUS_ERROR,           //!< Operation failed to create/validate/delete the renewal status file.
    CE_STATUS_FORBIDDEN_REQUEST,              //!< The server asked for a forbidden operation (for example: the server is not allowed to renew the device's bootstrap certificate).
    CE_STATUS_ITEM_IS_EMPTY,                  //!< The item was found in the storage but its length is zero.
    CE_STATUS_NOT_INITIALIZED,                //!< Called CertificateEnrollmentClient API before the initialization of the module.
    CE_STATUS_INIT_FAILED,                    //!< Initialization of the Certificate Enrollment module has failed. This error may be passed into MbedCloudClient::error callback.
    CE_MAX_STATUS = CE_STATUS_RANGE_END
} ce_status_e;

#ifdef __cplusplus
}
#endif

#endif  //__CE_STATUS_H__