xref: /kvmtool/include/kvm/disk-image.h (revision 5c5cae758a726ac073b68c8b0072c877d901589f)
1 #ifndef KVM__DISK_IMAGE_H
2 #define KVM__DISK_IMAGE_H
3 
4 #include "kvm/read-write.h"
5 #include "kvm/util.h"
6 #include "kvm/parse-options.h"
7 
8 #include <linux/types.h>
9 #include <linux/fs.h>	/* for BLKGETSIZE64 */
10 #include <sys/ioctl.h>
11 #include <sys/types.h>
12 #include <sys/mman.h>
13 #include <sys/stat.h>
14 #include <stdbool.h>
15 #include <sys/uio.h>
16 #include <stdbool.h>
17 #include <stddef.h>
18 #include <stdlib.h>
19 #include <unistd.h>
20 #include <fcntl.h>
21 
22 #define SECTOR_SHIFT		9
23 #define SECTOR_SIZE		(1UL << SECTOR_SHIFT)
24 
25 enum {
26 	DISK_IMAGE_REGULAR,
27 	DISK_IMAGE_MMAP,
28 };
29 
30 #define MAX_DISK_IMAGES         4
31 
32 struct disk_image;
33 
34 struct disk_image_operations {
35 	ssize_t (*read)(struct disk_image *disk, u64 sector, const struct iovec *iov,
36 			int iovcount, void *param);
37 	ssize_t (*write)(struct disk_image *disk, u64 sector, const struct iovec *iov,
38 			int iovcount, void *param);
39 	int (*flush)(struct disk_image *disk);
40 	int (*close)(struct disk_image *disk);
41 };
42 
43 struct disk_image_params {
44 	const char *filename;
45 	/*
46 	 * wwpn == World Wide Port Number
47 	 * tpgt == Target Portal Group Tag
48 	 */
49 	const char *wwpn;
50 	const char *tpgt;
51 	bool readonly;
52 	bool direct;
53 };
54 
55 struct disk_image {
56 	int				fd;
57 	u64				size;
58 	struct disk_image_operations	*ops;
59 	void				*priv;
60 	void				*disk_req_cb_param;
61 	void				(*disk_req_cb)(void *param, long len);
62 	bool				readonly;
63 	bool				async;
64 	int				evt;
65 #ifdef CONFIG_HAS_AIO
66 	io_context_t			ctx;
67 #endif
68 	const char			*wwpn;
69 	const char			*tpgt;
70 	int				debug_iodelay;
71 };
72 
73 int disk_img_name_parser(const struct option *opt, const char *arg, int unset);
74 int disk_image__init(struct kvm *kvm);
75 int disk_image__exit(struct kvm *kvm);
76 struct disk_image *disk_image__new(int fd, u64 size, struct disk_image_operations *ops, int mmap);
77 int disk_image__flush(struct disk_image *disk);
78 ssize_t disk_image__read(struct disk_image *disk, u64 sector, const struct iovec *iov,
79 				int iovcount, void *param);
80 ssize_t disk_image__write(struct disk_image *disk, u64 sector, const struct iovec *iov,
81 				int iovcount, void *param);
82 ssize_t disk_image__get_serial(struct disk_image *disk, void *buffer, ssize_t *len);
83 
84 struct disk_image *raw_image__probe(int fd, struct stat *st, bool readonly);
85 struct disk_image *blkdev__probe(const char *filename, int flags, struct stat *st);
86 
87 ssize_t raw_image__read(struct disk_image *disk, u64 sector,
88 				const struct iovec *iov, int iovcount, void *param);
89 ssize_t raw_image__write(struct disk_image *disk, u64 sector,
90 				const struct iovec *iov, int iovcount, void *param);
91 ssize_t raw_image__read_mmap(struct disk_image *disk, u64 sector,
92 				const struct iovec *iov, int iovcount, void *param);
93 ssize_t raw_image__write_mmap(struct disk_image *disk, u64 sector,
94 				const struct iovec *iov, int iovcount, void *param);
95 int raw_image__close(struct disk_image *disk);
96 void disk_image__set_callback(struct disk_image *disk, void (*disk_req_cb)(void *param, long len));
97 #endif /* KVM__DISK_IMAGE_H */
98