| 1 | /* | 
| 2 |  * Copyright (c) 2010 The NetBSD Foundation, Inc. | 
| 3 |  * All rights reserved. | 
| 4 |  * | 
| 5 |  * This code is derived from software contributed to The NetBSD Foundation | 
| 6 |  * by Adam Hamsik. | 
| 7 |  * | 
| 8 |  * Redistribution and use in source and binary forms, with or without | 
| 9 |  * modification, are permitted provided that the following conditions | 
| 10 |  * are met: | 
| 11 |  * 1. Redistributions of source code must retain the above copyright | 
| 12 |  *    notice, this list of conditions and the following disclaimer. | 
| 13 |  * 2. Redistributions in binary form must reproduce the above copyright | 
| 14 |  *    notice, this list of conditions and the following disclaimer in the | 
| 15 |  *    documentation and/or other materials provided with the distribution. | 
| 16 |  * | 
| 17 |  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS | 
| 18 |  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED | 
| 19 |  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | 
| 20 |  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS | 
| 21 |  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | 
| 22 |  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | 
| 23 |  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | 
| 24 |  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | 
| 25 |  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | 
| 26 |  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | 
| 27 |  * POSSIBILITY OF SUCH DAMAGE. | 
| 28 |  */ | 
| 29 |  | 
| 30 |  | 
| 31 | #ifndef _LIB_DM_H_ | 
| 32 | #define _LIB_DM_H_ | 
| 33 |  | 
| 34 | #include <sys/cdefs.h> | 
| 35 | #include <stddef.h> | 
| 36 | #include <stdint.h> | 
| 37 |  | 
| 38 | __BEGIN_DECLS | 
| 39 |  | 
| 40 | #define DM_DEVICE_PATH "/dev/mapper/control" | 
| 41 |  | 
| 42 | #define IOCTL_TYPE_IN  0x1 | 
| 43 | #define IOCTL_TYPE_OUT 0x2 | 
| 44 |  | 
| 45 | struct libdm_task; | 
| 46 | struct libdm_cmd; | 
| 47 | struct libdm_target; | 
| 48 | struct libdm_table; | 
| 49 | struct libdm_dev; | 
| 50 | struct libdm_iter; | 
| 51 |  | 
| 52 | typedef struct libdm_task* libdm_task_t; | 
| 53 | typedef struct libdm_cmd* libdm_cmd_t; | 
| 54 | typedef struct libdm_target* libdm_target_t; | 
| 55 | typedef struct libdm_table* libdm_table_t; | 
| 56 | typedef struct libdm_dev* libdm_dev_t; | 
| 57 | typedef struct libdm_iter* libdm_iter_t; | 
| 58 |  | 
| 59 | struct cmd_version { | 
| 60 | 	const char *cmd; | 
| 61 | 	uint32_t version[3]; | 
| 62 | }; | 
| 63 |  | 
| 64 | void libdm_iter_destroy(libdm_iter_t); | 
| 65 |  | 
| 66 | libdm_task_t libdm_task_create(const char *); | 
| 67 | void libdm_task_destroy(libdm_task_t); | 
| 68 |  | 
| 69 | char *libdm_task_get_command(libdm_task_t); | 
| 70 | int32_t libdm_task_get_cmd_version(libdm_task_t, uint32_t *, size_t); | 
| 71 |  | 
| 72 | int libdm_task_set_name(const char *, libdm_task_t); | 
| 73 | char *libdm_task_get_name(libdm_task_t); | 
| 74 |  | 
| 75 | int libdm_task_set_uuid(const char *, libdm_task_t); | 
| 76 | char *libdm_task_get_uuid(libdm_task_t); | 
| 77 |  | 
| 78 | int libdm_task_set_minor(uint32_t, libdm_task_t); | 
| 79 | uint32_t libdm_task_get_minor(libdm_task_t); | 
| 80 |  | 
| 81 | uint32_t libdm_task_get_flags(libdm_task_t); | 
| 82 | void libdm_task_set_flags(libdm_task_t, uint32_t); | 
| 83 |  | 
| 84 | void libdm_task_set_suspend_flag(libdm_task_t); | 
| 85 | void libdm_task_del_suspend_flag(libdm_task_t); | 
| 86 |  | 
| 87 | void libdm_task_set_status_flag(libdm_task_t); | 
| 88 | void libdm_task_del_status_flag(libdm_task_t); | 
| 89 |  | 
| 90 | void libdm_task_set_exists_flag(libdm_task_t); | 
| 91 | void libdm_task_del_exists_flag(libdm_task_t); | 
| 92 |  | 
| 93 | void libdm_task_set_nocount_flag(libdm_task_t); | 
| 94 | void libdm_task_del_nocount_flag(libdm_task_t); | 
| 95 |  | 
| 96 | uint32_t libdm_task_get_target_num(libdm_task_t); | 
| 97 | int32_t libdm_task_get_open_num(libdm_task_t); | 
| 98 | uint32_t libdm_task_get_event_num(libdm_task_t); | 
| 99 |  | 
| 100 | int libdm_task_set_cmd(libdm_cmd_t, libdm_task_t); | 
| 101 | libdm_cmd_t libdm_task_get_cmd(libdm_task_t); | 
| 102 |  | 
| 103 | /* cmd_data dictionary entry manipulating functions */ | 
| 104 | libdm_cmd_t libdm_cmd_create(void); | 
| 105 | void libdm_cmd_destroy(libdm_cmd_t); | 
| 106 | libdm_iter_t libdm_cmd_iter_create(libdm_cmd_t); | 
| 107 |  | 
| 108 | int libdm_cmd_set_table(libdm_table_t, libdm_cmd_t); | 
| 109 |  | 
| 110 | /* cmd is array of table dictionaries */ | 
| 111 | libdm_table_t libdm_cmd_get_table(libdm_iter_t); | 
| 112 |  | 
| 113 | /* cmd is array of dev dictionaries */ | 
| 114 | libdm_dev_t libdm_cmd_get_dev(libdm_iter_t); | 
| 115 |  | 
| 116 | /* cmd is array of target dictonaries */ | 
| 117 | libdm_target_t libdm_cmd_get_target(libdm_iter_t); | 
| 118 | /* cmd is array of dev_t's */ | 
| 119 | uint64_t libdm_cmd_get_deps(libdm_iter_t); | 
| 120 |  | 
| 121 | /* Table functions. */ | 
| 122 | libdm_table_t libdm_table_create(void); | 
| 123 | void libdm_table_destroy(libdm_table_t); | 
| 124 |  | 
| 125 | int libdm_table_set_start(uint64_t, libdm_table_t); | 
| 126 | uint64_t libdm_table_get_start(libdm_table_t); | 
| 127 |  | 
| 128 | int libdm_table_set_length(uint64_t, libdm_table_t); | 
| 129 | uint64_t libdm_table_get_length(libdm_table_t); | 
| 130 |  | 
| 131 | int libdm_table_set_target(const char *, libdm_table_t); | 
| 132 | char * libdm_table_get_target(libdm_table_t); | 
| 133 |  | 
| 134 | int libdm_table_set_params(const char *, libdm_table_t); | 
| 135 | char * libdm_table_get_params(libdm_table_t); | 
| 136 |  | 
| 137 | int32_t libdm_table_get_status(libdm_table_t); | 
| 138 |  | 
| 139 | /* Target manipulating functions. */ | 
| 140 | void libdm_target_destroy(libdm_target_t); | 
| 141 |  | 
| 142 | char * libdm_target_get_name(libdm_target_t); | 
| 143 | int32_t libdm_target_get_version(libdm_target_t, uint32_t *, size_t); | 
| 144 |  | 
| 145 | /* Dev manipulating functions. */ | 
| 146 | void libdm_dev_destroy(libdm_dev_t); | 
| 147 |  | 
| 148 | char * libdm_dev_get_name(libdm_dev_t); | 
| 149 | uint32_t libdm_dev_get_minor(libdm_dev_t); | 
| 150 |  | 
| 151 | int libdm_dev_set_newname(const char *, libdm_cmd_t); | 
| 152 |  | 
| 153 | /* task run routine */ | 
| 154 | int libdm_task_run(libdm_task_t); | 
| 155 |  | 
| 156 | __END_DECLS | 
| 157 |  | 
| 158 | #endif /* _LIB_DM_H_ */ | 
| 159 |  |