github/ocf
4
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #614 from robertbaldyga/redesign-standby

Browse Source 
Redesign failover standby API
This commit is contained in:
Robert Baldyga
2022-01-04 14:07:05 +01:00
committed by GitHub
parent 4d4cdece0d 4aa3d8f9df
commit c6644116ae
14 changed files with 396 additions and 303 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
inc/ocf_cache.h
View File

@@ -93,8 +93,8 @@ struct ocf_cache_info {
uint32_t metadata_end_offset;
/*!< LBA offset where metadata ends (in 4KiB blocks) */
bool failover_detached;
/*!< true if cache drive detached for failover */
bool standby_detached;
/*!< true if cache volume detached in standby mode */
};
/**

4
inc/ocf_err.h
View File

@@ -141,9 +141,9 @@ typedef enum {
OCF_ERR_CACHE_STANDBY,
/** Operation invalid with cache drive atatched in failover standby */
OCF_ERR_FAILOVER_ATTACHED,
OCF_ERR_STANDBY_ATTACHED,
OCF_ERR_MAX = OCF_ERR_FAILOVER_ATTACHED,
OCF_ERR_MAX = OCF_ERR_STANDBY_ATTACHED,
} ocf_error_t;
#endif /* __OCF_ERR_H__ */

88
inc/ocf_mngt.h
View File

@@ -529,52 +529,108 @@ void ocf_mngt_cache_load(ocf_cache_t cache,
ocf_mngt_cache_load_end_t cmpl, void *priv);
/**
* @brief Completion callback of cache bind operation
* @brief Completion callback of cache standby attach operation
*
* @param[in] cache Cache handle
* @param[in] priv Callback context
* @param[in] error Error code (zero on success)
*/
typedef void (*ocf_mngt_cache_bind_end_t)(ocf_cache_t cache,
typedef void (*ocf_mngt_cache_standby_attach_end_t)(ocf_cache_t cache,
void *priv, int error);
/**
* @brief Initiate failover standby
* @brief Attach caching device to cache instance in failover standby mode
*
* @param[in] cache Cache handle
* @param[in] cfg Caching device configuration
* @param[in] cmpl Completion callback
* @param[in] priv Completion callback context
*/
void ocf_mngt_cache_standby(ocf_cache_t cache,
void ocf_mngt_cache_standby_attach(ocf_cache_t cache,
struct ocf_mngt_cache_attach_config *cfg,
ocf_mngt_cache_bind_end_t cmpl, void *priv);
ocf_mngt_cache_standby_attach_end_t cmpl, void *priv);
typedef void (*ocf_mngt_cache_failover_detach_end_t)(void *priv, int error);
void ocf_mngt_cache_failover_detach(ocf_cache_t cache,
ocf_mngt_cache_failover_detach_end_t cmpl, void *priv);
/**
* @brief Completion callback of cache activate operation
* @brief Completion callback of cache standby load operation
*
* @param[in] cache Cache handle
* @param[in] priv Callback context
* @param[in] error Error code (zero on success)
*/
typedef void (*ocf_mngt_cache_activate_end_t)(ocf_cache_t cache,
typedef void (*ocf_mngt_cache_standby_load_end_t)(ocf_cache_t cache,
void *priv, int error);
/**
* @brief Activate cache instance
* @brief Load cache instance in failover standby mode
*
* @param[in] cache Cache handle
* @param[in] cfg Caching device configuration
* @param[in] cmpl Completion callback
* @param[in] priv Completion callback context
*/
void ocf_mngt_cache_activate(ocf_cache_t cache,
struct ocf_mngt_cache_device_config *cfg,
ocf_mngt_cache_activate_end_t cmpl, void *priv);
void ocf_mngt_cache_standby_load(ocf_cache_t cache,
struct ocf_mngt_cache_attach_config *cfg,
ocf_mngt_cache_standby_load_end_t cmpl, void *priv);
/**
* @brief Completion callback of cache standby detach operation
*
* @param[in] cache Cache handle
* @param[in] priv Callback context
* @param[in] error Error code (zero on success)
*/
typedef void (*ocf_mngt_cache_standby_detach_end_t)(void *priv, int error);
/**
* @brief Detach cache volume from cache in standby mode
*
* @param[in] cache Cache handle
* @param[in] cmpl Completion callback
* @param[in] priv Completion callback context
*/
void ocf_mngt_cache_standby_detach(ocf_cache_t cache,
ocf_mngt_cache_standby_detach_end_t cmpl, void *priv);
/**
* @brief Cache standby activate configuration
*/
struct ocf_mngt_cache_standby_activate_config {
/**
* @brief Cache device configuration - must be the first field
*/
struct ocf_mngt_cache_device_config device;
/**
* @brief Automatically open core volumes when activating cache
*
* If set to false, cache load will not attempt to open core volumes,
* and so cores will be marked "inactive" unless their volumes were
* earlier added to the core pool. In such case user will be expected
* to add cores later using function ocf_mngt_cache_add_core().
*/
bool open_cores;
};
/**
* @brief Completion callback of standby cache activate operation
*
* @param[in] cache Cache handle
* @param[in] priv Callback context
* @param[in] error Error code (zero on success)
*/
typedef void (*ocf_mngt_cache_standby_activate_end_t)(ocf_cache_t cache,
void *priv, int error);
/**
* @brief Activate standby cache instance
*
* @param[in] cache Cache handle
* @param[in] cfg Caching device configuration
* @param[in] cmpl Completion callback
* @param[in] priv Completion callback context
*/
void ocf_mngt_cache_standby_activate(ocf_cache_t cache,
struct ocf_mngt_cache_standby_activate_config *cfg,
ocf_mngt_cache_standby_activate_end_t cmpl, void *priv);
/* Adding and removing cores */