4 * Copyright (c) Intel Corporation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
17 * * Neither the name of Intel Corporation nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34 #ifndef VBDEV_OCF_UTILS_H
35 #define VBDEV_OCF_UTILS_H
38 #include "vbdev_ocf.h"
40 ocf_cache_mode_t
ocf_get_cache_mode(const char *cache_mode
);
41 const char *ocf_get_cache_modename(ocf_cache_mode_t mode
);
43 /* Initiate management operation
44 * Receives NULL terminated array of functions (path)
46 * and callback argument (cb_arg)
47 * This function may fail with ENOMEM or EBUSY */
48 int vbdev_ocf_mngt_start(struct vbdev_ocf
*vbdev
, vbdev_ocf_mngt_fn
*path
,
49 vbdev_ocf_mngt_callback cb
, void *cb_arg
);
51 /* Continue execution with polling operation (fn)
52 * fn must invoke vbdev_ocf_mngt_continue() to stop polling
53 * Poller has default timeout of 5 seconds */
54 void vbdev_ocf_mngt_poll(struct vbdev_ocf
*vbdev
, vbdev_ocf_mngt_fn fn
);
56 /* Continue execution with next function that is on path
57 * If next function is NULL, finish management operation and invoke callback */
58 void vbdev_ocf_mngt_continue(struct vbdev_ocf
*vbdev
, int status
);
60 /* Stop the execution, if status is non zero set it,
61 * if rollback function is not null invoke rollback
62 * else invoke callback with last status returned */
63 void vbdev_ocf_mngt_stop(struct vbdev_ocf
*vbdev
, vbdev_ocf_mngt_fn
*rollback_path
, int status
);
66 int vbdev_ocf_mngt_get_status(struct vbdev_ocf
*vbdev
);