1fc01f7e7Sbellard /* 2fc01f7e7Sbellard * QEMU System Emulator block driver 3fc01f7e7Sbellard * 4fc01f7e7Sbellard * Copyright (c) 2003 Fabrice Bellard 5fc01f7e7Sbellard * 6fc01f7e7Sbellard * Permission is hereby granted, free of charge, to any person obtaining a copy 7fc01f7e7Sbellard * of this software and associated documentation files (the "Software"), to deal 8fc01f7e7Sbellard * in the Software without restriction, including without limitation the rights 9fc01f7e7Sbellard * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 10fc01f7e7Sbellard * copies of the Software, and to permit persons to whom the Software is 11fc01f7e7Sbellard * furnished to do so, subject to the following conditions: 12fc01f7e7Sbellard * 13fc01f7e7Sbellard * The above copyright notice and this permission notice shall be included in 14fc01f7e7Sbellard * all copies or substantial portions of the Software. 15fc01f7e7Sbellard * 16fc01f7e7Sbellard * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17fc01f7e7Sbellard * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18fc01f7e7Sbellard * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 19fc01f7e7Sbellard * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20fc01f7e7Sbellard * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 21fc01f7e7Sbellard * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 22fc01f7e7Sbellard * THE SOFTWARE. 23fc01f7e7Sbellard */ 24*faf07963Spbrook #ifdef QEMU_IMG 25*faf07963Spbrook #include "qemu-common.h" 26*faf07963Spbrook #else 27fc01f7e7Sbellard #include "vl.h" 28*faf07963Spbrook #endif 29ea2384d3Sbellard #include "block_int.h" 30fc01f7e7Sbellard 317674e7bfSbellard #ifdef _BSD 327674e7bfSbellard #include <sys/types.h> 337674e7bfSbellard #include <sys/stat.h> 347674e7bfSbellard #include <sys/ioctl.h> 357674e7bfSbellard #include <sys/queue.h> 367674e7bfSbellard #include <sys/disk.h> 377674e7bfSbellard #endif 387674e7bfSbellard 3983f64091Sbellard #define SECTOR_BITS 9 4083f64091Sbellard #define SECTOR_SIZE (1 << SECTOR_BITS) 413b0d4f61Sbellard 4290765429Sbellard typedef struct BlockDriverAIOCBSync { 4390765429Sbellard BlockDriverAIOCB common; 4490765429Sbellard QEMUBH *bh; 4590765429Sbellard int ret; 4690765429Sbellard } BlockDriverAIOCBSync; 4790765429Sbellard 48ce1a14dcSpbrook static BlockDriverAIOCB *bdrv_aio_read_em(BlockDriverState *bs, 49ce1a14dcSpbrook int64_t sector_num, uint8_t *buf, int nb_sectors, 50ce1a14dcSpbrook BlockDriverCompletionFunc *cb, void *opaque); 51ce1a14dcSpbrook static BlockDriverAIOCB *bdrv_aio_write_em(BlockDriverState *bs, 52ce1a14dcSpbrook int64_t sector_num, const uint8_t *buf, int nb_sectors, 53ce1a14dcSpbrook BlockDriverCompletionFunc *cb, void *opaque); 5483f64091Sbellard static void bdrv_aio_cancel_em(BlockDriverAIOCB *acb); 5583f64091Sbellard static int bdrv_read_em(BlockDriverState *bs, int64_t sector_num, 5683f64091Sbellard uint8_t *buf, int nb_sectors); 5783f64091Sbellard static int bdrv_write_em(BlockDriverState *bs, int64_t sector_num, 5883f64091Sbellard const uint8_t *buf, int nb_sectors); 59ec530c81Sbellard 60*faf07963Spbrook BlockDriverState *bdrv_first; 61ea2384d3Sbellard static BlockDriver *first_drv; 62ea2384d3Sbellard 6383f64091Sbellard int path_is_absolute(const char *path) 6483f64091Sbellard { 6583f64091Sbellard const char *p; 6621664424Sbellard #ifdef _WIN32 6721664424Sbellard /* specific case for names like: "\\.\d:" */ 6821664424Sbellard if (*path == '/' || *path == '\\') 6921664424Sbellard return 1; 7021664424Sbellard #endif 7183f64091Sbellard p = strchr(path, ':'); 7283f64091Sbellard if (p) 7383f64091Sbellard p++; 7483f64091Sbellard else 7583f64091Sbellard p = path; 763b9f94e1Sbellard #ifdef _WIN32 773b9f94e1Sbellard return (*p == '/' || *p == '\\'); 783b9f94e1Sbellard #else 793b9f94e1Sbellard return (*p == '/'); 803b9f94e1Sbellard #endif 8183f64091Sbellard } 8283f64091Sbellard 8383f64091Sbellard /* if filename is absolute, just copy it to dest. Otherwise, build a 8483f64091Sbellard path to it by considering it is relative to base_path. URL are 8583f64091Sbellard supported. */ 8683f64091Sbellard void path_combine(char *dest, int dest_size, 8783f64091Sbellard const char *base_path, 8883f64091Sbellard const char *filename) 8983f64091Sbellard { 9083f64091Sbellard const char *p, *p1; 9183f64091Sbellard int len; 9283f64091Sbellard 9383f64091Sbellard if (dest_size <= 0) 9483f64091Sbellard return; 9583f64091Sbellard if (path_is_absolute(filename)) { 9683f64091Sbellard pstrcpy(dest, dest_size, filename); 9783f64091Sbellard } else { 9883f64091Sbellard p = strchr(base_path, ':'); 9983f64091Sbellard if (p) 10083f64091Sbellard p++; 10183f64091Sbellard else 10283f64091Sbellard p = base_path; 1033b9f94e1Sbellard p1 = strrchr(base_path, '/'); 1043b9f94e1Sbellard #ifdef _WIN32 1053b9f94e1Sbellard { 1063b9f94e1Sbellard const char *p2; 1073b9f94e1Sbellard p2 = strrchr(base_path, '\\'); 1083b9f94e1Sbellard if (!p1 || p2 > p1) 1093b9f94e1Sbellard p1 = p2; 1103b9f94e1Sbellard } 1113b9f94e1Sbellard #endif 11283f64091Sbellard if (p1) 11383f64091Sbellard p1++; 11483f64091Sbellard else 11583f64091Sbellard p1 = base_path; 11683f64091Sbellard if (p1 > p) 11783f64091Sbellard p = p1; 11883f64091Sbellard len = p - base_path; 11983f64091Sbellard if (len > dest_size - 1) 12083f64091Sbellard len = dest_size - 1; 12183f64091Sbellard memcpy(dest, base_path, len); 12283f64091Sbellard dest[len] = '\0'; 12383f64091Sbellard pstrcat(dest, dest_size, filename); 12483f64091Sbellard } 12583f64091Sbellard } 12683f64091Sbellard 12783f64091Sbellard 128ea2384d3Sbellard void bdrv_register(BlockDriver *bdrv) 129ea2384d3Sbellard { 130ce1a14dcSpbrook if (!bdrv->bdrv_aio_read) { 13183f64091Sbellard /* add AIO emulation layer */ 13283f64091Sbellard bdrv->bdrv_aio_read = bdrv_aio_read_em; 13383f64091Sbellard bdrv->bdrv_aio_write = bdrv_aio_write_em; 13483f64091Sbellard bdrv->bdrv_aio_cancel = bdrv_aio_cancel_em; 13590765429Sbellard bdrv->aiocb_size = sizeof(BlockDriverAIOCBSync); 13683f64091Sbellard } else if (!bdrv->bdrv_read && !bdrv->bdrv_pread) { 13783f64091Sbellard /* add synchronous IO emulation layer */ 13883f64091Sbellard bdrv->bdrv_read = bdrv_read_em; 13983f64091Sbellard bdrv->bdrv_write = bdrv_write_em; 14083f64091Sbellard } 141ea2384d3Sbellard bdrv->next = first_drv; 142ea2384d3Sbellard first_drv = bdrv; 143ea2384d3Sbellard } 144b338082bSbellard 145b338082bSbellard /* create a new block device (by default it is empty) */ 146b338082bSbellard BlockDriverState *bdrv_new(const char *device_name) 147fc01f7e7Sbellard { 148b338082bSbellard BlockDriverState **pbs, *bs; 149b338082bSbellard 150b338082bSbellard bs = qemu_mallocz(sizeof(BlockDriverState)); 151b338082bSbellard if(!bs) 152b338082bSbellard return NULL; 153b338082bSbellard pstrcpy(bs->device_name, sizeof(bs->device_name), device_name); 154ea2384d3Sbellard if (device_name[0] != '\0') { 155b338082bSbellard /* insert at the end */ 156b338082bSbellard pbs = &bdrv_first; 157b338082bSbellard while (*pbs != NULL) 158b338082bSbellard pbs = &(*pbs)->next; 159b338082bSbellard *pbs = bs; 160ea2384d3Sbellard } 161b338082bSbellard return bs; 162b338082bSbellard } 163b338082bSbellard 164ea2384d3Sbellard BlockDriver *bdrv_find_format(const char *format_name) 165ea2384d3Sbellard { 166ea2384d3Sbellard BlockDriver *drv1; 167ea2384d3Sbellard for(drv1 = first_drv; drv1 != NULL; drv1 = drv1->next) { 168ea2384d3Sbellard if (!strcmp(drv1->format_name, format_name)) 169ea2384d3Sbellard return drv1; 170ea2384d3Sbellard } 171ea2384d3Sbellard return NULL; 172ea2384d3Sbellard } 173ea2384d3Sbellard 174ea2384d3Sbellard int bdrv_create(BlockDriver *drv, 175ea2384d3Sbellard const char *filename, int64_t size_in_sectors, 176ea2384d3Sbellard const char *backing_file, int flags) 177ea2384d3Sbellard { 178ea2384d3Sbellard if (!drv->bdrv_create) 179ea2384d3Sbellard return -ENOTSUP; 180ea2384d3Sbellard return drv->bdrv_create(filename, size_in_sectors, backing_file, flags); 181ea2384d3Sbellard } 182ea2384d3Sbellard 183d5249393Sbellard #ifdef _WIN32 18495389c86Sbellard void get_tmp_filename(char *filename, int size) 185d5249393Sbellard { 1863b9f94e1Sbellard char temp_dir[MAX_PATH]; 1873b9f94e1Sbellard 1883b9f94e1Sbellard GetTempPath(MAX_PATH, temp_dir); 1893b9f94e1Sbellard GetTempFileName(temp_dir, "qem", 0, filename); 190d5249393Sbellard } 191d5249393Sbellard #else 19295389c86Sbellard void get_tmp_filename(char *filename, int size) 193ea2384d3Sbellard { 194ea2384d3Sbellard int fd; 195d5249393Sbellard /* XXX: race condition possible */ 196ea2384d3Sbellard pstrcpy(filename, size, "/tmp/vl.XXXXXX"); 197ea2384d3Sbellard fd = mkstemp(filename); 198ea2384d3Sbellard close(fd); 199ea2384d3Sbellard } 200d5249393Sbellard #endif 201ea2384d3Sbellard 20219cb3738Sbellard #ifdef _WIN32 203f45512feSbellard static int is_windows_drive_prefix(const char *filename) 204f45512feSbellard { 205f45512feSbellard return (((filename[0] >= 'a' && filename[0] <= 'z') || 206f45512feSbellard (filename[0] >= 'A' && filename[0] <= 'Z')) && 207f45512feSbellard filename[1] == ':'); 208f45512feSbellard } 209f45512feSbellard 21019cb3738Sbellard static int is_windows_drive(const char *filename) 21119cb3738Sbellard { 212f45512feSbellard if (is_windows_drive_prefix(filename) && 213f45512feSbellard filename[2] == '\0') 21419cb3738Sbellard return 1; 21519cb3738Sbellard if (strstart(filename, "\\\\.\\", NULL) || 21619cb3738Sbellard strstart(filename, "//./", NULL)) 21719cb3738Sbellard return 1; 21819cb3738Sbellard return 0; 21919cb3738Sbellard } 22019cb3738Sbellard #endif 22119cb3738Sbellard 22283f64091Sbellard static BlockDriver *find_protocol(const char *filename) 22383f64091Sbellard { 22483f64091Sbellard BlockDriver *drv1; 22583f64091Sbellard char protocol[128]; 22683f64091Sbellard int len; 22783f64091Sbellard const char *p; 22819cb3738Sbellard 22919cb3738Sbellard #ifdef _WIN32 230f45512feSbellard if (is_windows_drive(filename) || 231f45512feSbellard is_windows_drive_prefix(filename)) 23219cb3738Sbellard return &bdrv_raw; 23319cb3738Sbellard #endif 23483f64091Sbellard p = strchr(filename, ':'); 23583f64091Sbellard if (!p) 23683f64091Sbellard return &bdrv_raw; 23783f64091Sbellard len = p - filename; 23883f64091Sbellard if (len > sizeof(protocol) - 1) 23983f64091Sbellard len = sizeof(protocol) - 1; 24083f64091Sbellard memcpy(protocol, filename, len); 24183f64091Sbellard protocol[len] = '\0'; 24283f64091Sbellard for(drv1 = first_drv; drv1 != NULL; drv1 = drv1->next) { 24383f64091Sbellard if (drv1->protocol_name && 24483f64091Sbellard !strcmp(drv1->protocol_name, protocol)) 24583f64091Sbellard return drv1; 24683f64091Sbellard } 24783f64091Sbellard return NULL; 24883f64091Sbellard } 24983f64091Sbellard 2507674e7bfSbellard /* XXX: force raw format if block or character device ? It would 2517674e7bfSbellard simplify the BSD case */ 252ea2384d3Sbellard static BlockDriver *find_image_format(const char *filename) 253ea2384d3Sbellard { 25483f64091Sbellard int ret, score, score_max; 255ea2384d3Sbellard BlockDriver *drv1, *drv; 25683f64091Sbellard uint8_t buf[2048]; 25783f64091Sbellard BlockDriverState *bs; 258ea2384d3Sbellard 25919cb3738Sbellard /* detect host devices. By convention, /dev/cdrom[N] is always 26019cb3738Sbellard recognized as a host CDROM */ 26119cb3738Sbellard if (strstart(filename, "/dev/cdrom", NULL)) 26219cb3738Sbellard return &bdrv_host_device; 26319cb3738Sbellard #ifdef _WIN32 26419cb3738Sbellard if (is_windows_drive(filename)) 26519cb3738Sbellard return &bdrv_host_device; 26619cb3738Sbellard #else 26719cb3738Sbellard { 26819cb3738Sbellard struct stat st; 26919cb3738Sbellard if (stat(filename, &st) >= 0 && 27019cb3738Sbellard (S_ISCHR(st.st_mode) || S_ISBLK(st.st_mode))) { 27119cb3738Sbellard return &bdrv_host_device; 27219cb3738Sbellard } 27319cb3738Sbellard } 27419cb3738Sbellard #endif 27519cb3738Sbellard 27683f64091Sbellard drv = find_protocol(filename); 27719cb3738Sbellard /* no need to test disk image formats for vvfat */ 27883f64091Sbellard if (drv == &bdrv_vvfat) 27983f64091Sbellard return drv; 28083f64091Sbellard 28183f64091Sbellard ret = bdrv_file_open(&bs, filename, BDRV_O_RDONLY); 28283f64091Sbellard if (ret < 0) 2837674e7bfSbellard return NULL; 28483f64091Sbellard ret = bdrv_pread(bs, 0, buf, sizeof(buf)); 28583f64091Sbellard bdrv_delete(bs); 286ea2384d3Sbellard if (ret < 0) { 287ea2384d3Sbellard return NULL; 288ea2384d3Sbellard } 289ea2384d3Sbellard 290ea2384d3Sbellard score_max = 0; 291ea2384d3Sbellard for(drv1 = first_drv; drv1 != NULL; drv1 = drv1->next) { 29283f64091Sbellard if (drv1->bdrv_probe) { 293ea2384d3Sbellard score = drv1->bdrv_probe(buf, ret, filename); 294ea2384d3Sbellard if (score > score_max) { 295ea2384d3Sbellard score_max = score; 296ea2384d3Sbellard drv = drv1; 297ea2384d3Sbellard } 298ea2384d3Sbellard } 29983f64091Sbellard } 300ea2384d3Sbellard return drv; 301ea2384d3Sbellard } 302ea2384d3Sbellard 30383f64091Sbellard int bdrv_file_open(BlockDriverState **pbs, const char *filename, int flags) 304b338082bSbellard { 30583f64091Sbellard BlockDriverState *bs; 30683f64091Sbellard int ret; 3073b0d4f61Sbellard 30883f64091Sbellard bs = bdrv_new(""); 30983f64091Sbellard if (!bs) 31083f64091Sbellard return -ENOMEM; 31183f64091Sbellard ret = bdrv_open2(bs, filename, flags | BDRV_O_FILE, NULL); 31283f64091Sbellard if (ret < 0) { 31383f64091Sbellard bdrv_delete(bs); 31483f64091Sbellard return ret; 3153b0d4f61Sbellard } 31683f64091Sbellard *pbs = bs; 31783f64091Sbellard return 0; 3183b0d4f61Sbellard } 3193b0d4f61Sbellard 32083f64091Sbellard int bdrv_open(BlockDriverState *bs, const char *filename, int flags) 32183f64091Sbellard { 32283f64091Sbellard return bdrv_open2(bs, filename, flags, NULL); 323ea2384d3Sbellard } 324ea2384d3Sbellard 32583f64091Sbellard int bdrv_open2(BlockDriverState *bs, const char *filename, int flags, 326ea2384d3Sbellard BlockDriver *drv) 327ea2384d3Sbellard { 32883f64091Sbellard int ret, open_flags; 329eb5c851fSths char tmp_filename[PATH_MAX]; 330eb5c851fSths char backing_filename[PATH_MAX]; 331fc01f7e7Sbellard 3320849bf08Sbellard bs->read_only = 0; 333ea2384d3Sbellard bs->is_temporary = 0; 334ea2384d3Sbellard bs->encrypted = 0; 33533e3963eSbellard 33683f64091Sbellard if (flags & BDRV_O_SNAPSHOT) { 337ea2384d3Sbellard BlockDriverState *bs1; 338ea2384d3Sbellard int64_t total_size; 33933e3963eSbellard 340ea2384d3Sbellard /* if snapshot, we create a temporary backing file and open it 341ea2384d3Sbellard instead of opening 'filename' directly */ 342ea2384d3Sbellard 343ea2384d3Sbellard /* if there is a backing file, use it */ 344ea2384d3Sbellard bs1 = bdrv_new(""); 345ea2384d3Sbellard if (!bs1) { 34683f64091Sbellard return -ENOMEM; 347ea2384d3Sbellard } 348ea2384d3Sbellard if (bdrv_open(bs1, filename, 0) < 0) { 349ea2384d3Sbellard bdrv_delete(bs1); 350ea2384d3Sbellard return -1; 351ea2384d3Sbellard } 35283f64091Sbellard total_size = bdrv_getlength(bs1) >> SECTOR_BITS; 353ea2384d3Sbellard bdrv_delete(bs1); 354ea2384d3Sbellard 355ea2384d3Sbellard get_tmp_filename(tmp_filename, sizeof(tmp_filename)); 356a817d936Sbellard realpath(filename, backing_filename); 357d15a771dSbellard if (bdrv_create(&bdrv_qcow2, tmp_filename, 358a817d936Sbellard total_size, backing_filename, 0) < 0) { 359ea2384d3Sbellard return -1; 360ea2384d3Sbellard } 361ea2384d3Sbellard filename = tmp_filename; 362ea2384d3Sbellard bs->is_temporary = 1; 363ea2384d3Sbellard } 364ea2384d3Sbellard 365ea2384d3Sbellard pstrcpy(bs->filename, sizeof(bs->filename), filename); 36683f64091Sbellard if (flags & BDRV_O_FILE) { 36783f64091Sbellard drv = find_protocol(filename); 36883f64091Sbellard if (!drv) 36983f64091Sbellard return -ENOENT; 37083f64091Sbellard } else { 371ea2384d3Sbellard if (!drv) { 372ea2384d3Sbellard drv = find_image_format(filename); 373ea2384d3Sbellard if (!drv) 374ea2384d3Sbellard return -1; 375ea2384d3Sbellard } 37683f64091Sbellard } 377ea2384d3Sbellard bs->drv = drv; 378ea2384d3Sbellard bs->opaque = qemu_mallocz(drv->instance_size); 379ea2384d3Sbellard if (bs->opaque == NULL && drv->instance_size > 0) 380ea2384d3Sbellard return -1; 38183f64091Sbellard /* Note: for compatibility, we open disk image files as RDWR, and 38283f64091Sbellard RDONLY as fallback */ 38383f64091Sbellard if (!(flags & BDRV_O_FILE)) 38483f64091Sbellard open_flags = BDRV_O_RDWR; 38583f64091Sbellard else 38683f64091Sbellard open_flags = flags & ~(BDRV_O_FILE | BDRV_O_SNAPSHOT); 38783f64091Sbellard ret = drv->bdrv_open(bs, filename, open_flags); 38883f64091Sbellard if (ret == -EACCES && !(flags & BDRV_O_FILE)) { 38983f64091Sbellard ret = drv->bdrv_open(bs, filename, BDRV_O_RDONLY); 39083f64091Sbellard bs->read_only = 1; 39183f64091Sbellard } 392ea2384d3Sbellard if (ret < 0) { 393ea2384d3Sbellard qemu_free(bs->opaque); 3946b21b973Sbellard bs->opaque = NULL; 3956b21b973Sbellard bs->drv = NULL; 39683f64091Sbellard return ret; 397ea2384d3Sbellard } 398d15a771dSbellard if (drv->bdrv_getlength) { 399d15a771dSbellard bs->total_sectors = bdrv_getlength(bs) >> SECTOR_BITS; 400d15a771dSbellard } 401ea2384d3Sbellard #ifndef _WIN32 402ea2384d3Sbellard if (bs->is_temporary) { 403ea2384d3Sbellard unlink(filename); 40433e3963eSbellard } 40567b915a5Sbellard #endif 40683f64091Sbellard if (bs->backing_file[0] != '\0') { 407ea2384d3Sbellard /* if there is a backing file, use it */ 408ea2384d3Sbellard bs->backing_hd = bdrv_new(""); 409ea2384d3Sbellard if (!bs->backing_hd) { 410ea2384d3Sbellard fail: 411ea2384d3Sbellard bdrv_close(bs); 4126b21b973Sbellard return -ENOMEM; 413ea2384d3Sbellard } 41483f64091Sbellard path_combine(backing_filename, sizeof(backing_filename), 41583f64091Sbellard filename, bs->backing_file); 41683f64091Sbellard if (bdrv_open(bs->backing_hd, backing_filename, 0) < 0) 417ea2384d3Sbellard goto fail; 418ea2384d3Sbellard } 41933e3963eSbellard 420b338082bSbellard /* call the change callback */ 42119cb3738Sbellard bs->media_changed = 1; 422b338082bSbellard if (bs->change_cb) 423b338082bSbellard bs->change_cb(bs->change_opaque); 424b338082bSbellard 425b338082bSbellard return 0; 426fc01f7e7Sbellard } 427fc01f7e7Sbellard 428fc01f7e7Sbellard void bdrv_close(BlockDriverState *bs) 429fc01f7e7Sbellard { 43019cb3738Sbellard if (bs->drv) { 431ea2384d3Sbellard if (bs->backing_hd) 432ea2384d3Sbellard bdrv_delete(bs->backing_hd); 433ea2384d3Sbellard bs->drv->bdrv_close(bs); 434ea2384d3Sbellard qemu_free(bs->opaque); 435ea2384d3Sbellard #ifdef _WIN32 436ea2384d3Sbellard if (bs->is_temporary) { 437ea2384d3Sbellard unlink(bs->filename); 438ea2384d3Sbellard } 43967b915a5Sbellard #endif 440ea2384d3Sbellard bs->opaque = NULL; 441ea2384d3Sbellard bs->drv = NULL; 442b338082bSbellard 443b338082bSbellard /* call the change callback */ 44419cb3738Sbellard bs->media_changed = 1; 445b338082bSbellard if (bs->change_cb) 446b338082bSbellard bs->change_cb(bs->change_opaque); 447b338082bSbellard } 448b338082bSbellard } 449b338082bSbellard 450b338082bSbellard void bdrv_delete(BlockDriverState *bs) 451b338082bSbellard { 452ea2384d3Sbellard /* XXX: remove the driver list */ 453b338082bSbellard bdrv_close(bs); 454b338082bSbellard qemu_free(bs); 455fc01f7e7Sbellard } 456fc01f7e7Sbellard 45733e3963eSbellard /* commit COW file into the raw image */ 45833e3963eSbellard int bdrv_commit(BlockDriverState *bs) 45933e3963eSbellard { 46019cb3738Sbellard BlockDriver *drv = bs->drv; 46183f64091Sbellard int64_t i, total_sectors; 462ea2384d3Sbellard int n, j; 463ea2384d3Sbellard unsigned char sector[512]; 46433e3963eSbellard 46519cb3738Sbellard if (!drv) 46619cb3738Sbellard return -ENOMEDIUM; 46733e3963eSbellard 46833e3963eSbellard if (bs->read_only) { 469ea2384d3Sbellard return -EACCES; 47033e3963eSbellard } 47133e3963eSbellard 472ea2384d3Sbellard if (!bs->backing_hd) { 473ea2384d3Sbellard return -ENOTSUP; 474ea2384d3Sbellard } 475ea2384d3Sbellard 47683f64091Sbellard total_sectors = bdrv_getlength(bs) >> SECTOR_BITS; 47783f64091Sbellard for (i = 0; i < total_sectors;) { 47819cb3738Sbellard if (drv->bdrv_is_allocated(bs, i, 65536, &n)) { 479ea2384d3Sbellard for(j = 0; j < n; j++) { 48033e3963eSbellard if (bdrv_read(bs, i, sector, 1) != 0) { 481ea2384d3Sbellard return -EIO; 48233e3963eSbellard } 48333e3963eSbellard 484ea2384d3Sbellard if (bdrv_write(bs->backing_hd, i, sector, 1) != 0) { 485ea2384d3Sbellard return -EIO; 48633e3963eSbellard } 487ea2384d3Sbellard i++; 488ea2384d3Sbellard } 489ea2384d3Sbellard } else { 490ea2384d3Sbellard i += n; 49133e3963eSbellard } 49233e3963eSbellard } 49395389c86Sbellard 49419cb3738Sbellard if (drv->bdrv_make_empty) 49519cb3738Sbellard return drv->bdrv_make_empty(bs); 49695389c86Sbellard 49733e3963eSbellard return 0; 49833e3963eSbellard } 49933e3963eSbellard 50019cb3738Sbellard /* return < 0 if error. See bdrv_write() for the return codes */ 501fc01f7e7Sbellard int bdrv_read(BlockDriverState *bs, int64_t sector_num, 502fc01f7e7Sbellard uint8_t *buf, int nb_sectors) 503fc01f7e7Sbellard { 504ea2384d3Sbellard BlockDriver *drv = bs->drv; 505fc01f7e7Sbellard 50619cb3738Sbellard if (!drv) 50719cb3738Sbellard return -ENOMEDIUM; 508b338082bSbellard 50983f64091Sbellard if (sector_num == 0 && bs->boot_sector_enabled && nb_sectors > 0) { 510cf98951bSbellard memcpy(buf, bs->boot_sector_data, 512); 51183f64091Sbellard sector_num++; 51283f64091Sbellard nb_sectors--; 51383f64091Sbellard buf += 512; 51483f64091Sbellard if (nb_sectors == 0) 515fc01f7e7Sbellard return 0; 516fc01f7e7Sbellard } 51783f64091Sbellard if (drv->bdrv_pread) { 51883f64091Sbellard int ret, len; 51983f64091Sbellard len = nb_sectors * 512; 52083f64091Sbellard ret = drv->bdrv_pread(bs, sector_num * 512, buf, len); 52183f64091Sbellard if (ret < 0) 52283f64091Sbellard return ret; 52383f64091Sbellard else if (ret != len) 52419cb3738Sbellard return -EINVAL; 52583f64091Sbellard else 52683f64091Sbellard return 0; 52783f64091Sbellard } else { 52883f64091Sbellard return drv->bdrv_read(bs, sector_num, buf, nb_sectors); 52983f64091Sbellard } 53083f64091Sbellard } 531fc01f7e7Sbellard 53219cb3738Sbellard /* Return < 0 if error. Important errors are: 53319cb3738Sbellard -EIO generic I/O error (may happen for all errors) 53419cb3738Sbellard -ENOMEDIUM No media inserted. 53519cb3738Sbellard -EINVAL Invalid sector number or nb_sectors 53619cb3738Sbellard -EACCES Trying to write a read-only device 53719cb3738Sbellard */ 538fc01f7e7Sbellard int bdrv_write(BlockDriverState *bs, int64_t sector_num, 539fc01f7e7Sbellard const uint8_t *buf, int nb_sectors) 540fc01f7e7Sbellard { 54183f64091Sbellard BlockDriver *drv = bs->drv; 54219cb3738Sbellard if (!bs->drv) 54319cb3738Sbellard return -ENOMEDIUM; 5440849bf08Sbellard if (bs->read_only) 54519cb3738Sbellard return -EACCES; 54679639d42Sbellard if (sector_num == 0 && bs->boot_sector_enabled && nb_sectors > 0) { 54779639d42Sbellard memcpy(bs->boot_sector_data, buf, 512); 54879639d42Sbellard } 54983f64091Sbellard if (drv->bdrv_pwrite) { 55083f64091Sbellard int ret, len; 55183f64091Sbellard len = nb_sectors * 512; 55283f64091Sbellard ret = drv->bdrv_pwrite(bs, sector_num * 512, buf, len); 55383f64091Sbellard if (ret < 0) 55483f64091Sbellard return ret; 55583f64091Sbellard else if (ret != len) 55683f64091Sbellard return -EIO; 55783f64091Sbellard else 55883f64091Sbellard return 0; 55983f64091Sbellard } else { 56083f64091Sbellard return drv->bdrv_write(bs, sector_num, buf, nb_sectors); 56183f64091Sbellard } 56283f64091Sbellard } 56383f64091Sbellard 56483f64091Sbellard static int bdrv_pread_em(BlockDriverState *bs, int64_t offset, 565faea38e7Sbellard uint8_t *buf, int count1) 56683f64091Sbellard { 56783f64091Sbellard uint8_t tmp_buf[SECTOR_SIZE]; 56883f64091Sbellard int len, nb_sectors, count; 56983f64091Sbellard int64_t sector_num; 57083f64091Sbellard 57183f64091Sbellard count = count1; 57283f64091Sbellard /* first read to align to sector start */ 57383f64091Sbellard len = (SECTOR_SIZE - offset) & (SECTOR_SIZE - 1); 57483f64091Sbellard if (len > count) 57583f64091Sbellard len = count; 57683f64091Sbellard sector_num = offset >> SECTOR_BITS; 57783f64091Sbellard if (len > 0) { 57883f64091Sbellard if (bdrv_read(bs, sector_num, tmp_buf, 1) < 0) 57983f64091Sbellard return -EIO; 58083f64091Sbellard memcpy(buf, tmp_buf + (offset & (SECTOR_SIZE - 1)), len); 58183f64091Sbellard count -= len; 58283f64091Sbellard if (count == 0) 58383f64091Sbellard return count1; 58483f64091Sbellard sector_num++; 58583f64091Sbellard buf += len; 58683f64091Sbellard } 58783f64091Sbellard 58883f64091Sbellard /* read the sectors "in place" */ 58983f64091Sbellard nb_sectors = count >> SECTOR_BITS; 59083f64091Sbellard if (nb_sectors > 0) { 59183f64091Sbellard if (bdrv_read(bs, sector_num, buf, nb_sectors) < 0) 59283f64091Sbellard return -EIO; 59383f64091Sbellard sector_num += nb_sectors; 59483f64091Sbellard len = nb_sectors << SECTOR_BITS; 59583f64091Sbellard buf += len; 59683f64091Sbellard count -= len; 59783f64091Sbellard } 59883f64091Sbellard 59983f64091Sbellard /* add data from the last sector */ 60083f64091Sbellard if (count > 0) { 60183f64091Sbellard if (bdrv_read(bs, sector_num, tmp_buf, 1) < 0) 60283f64091Sbellard return -EIO; 60383f64091Sbellard memcpy(buf, tmp_buf, count); 60483f64091Sbellard } 60583f64091Sbellard return count1; 60683f64091Sbellard } 60783f64091Sbellard 60883f64091Sbellard static int bdrv_pwrite_em(BlockDriverState *bs, int64_t offset, 609faea38e7Sbellard const uint8_t *buf, int count1) 61083f64091Sbellard { 61183f64091Sbellard uint8_t tmp_buf[SECTOR_SIZE]; 61283f64091Sbellard int len, nb_sectors, count; 61383f64091Sbellard int64_t sector_num; 61483f64091Sbellard 61583f64091Sbellard count = count1; 61683f64091Sbellard /* first write to align to sector start */ 61783f64091Sbellard len = (SECTOR_SIZE - offset) & (SECTOR_SIZE - 1); 61883f64091Sbellard if (len > count) 61983f64091Sbellard len = count; 62083f64091Sbellard sector_num = offset >> SECTOR_BITS; 62183f64091Sbellard if (len > 0) { 62283f64091Sbellard if (bdrv_read(bs, sector_num, tmp_buf, 1) < 0) 62383f64091Sbellard return -EIO; 62483f64091Sbellard memcpy(tmp_buf + (offset & (SECTOR_SIZE - 1)), buf, len); 62583f64091Sbellard if (bdrv_write(bs, sector_num, tmp_buf, 1) < 0) 62683f64091Sbellard return -EIO; 62783f64091Sbellard count -= len; 62883f64091Sbellard if (count == 0) 62983f64091Sbellard return count1; 63083f64091Sbellard sector_num++; 63183f64091Sbellard buf += len; 63283f64091Sbellard } 63383f64091Sbellard 63483f64091Sbellard /* write the sectors "in place" */ 63583f64091Sbellard nb_sectors = count >> SECTOR_BITS; 63683f64091Sbellard if (nb_sectors > 0) { 63783f64091Sbellard if (bdrv_write(bs, sector_num, buf, nb_sectors) < 0) 63883f64091Sbellard return -EIO; 63983f64091Sbellard sector_num += nb_sectors; 64083f64091Sbellard len = nb_sectors << SECTOR_BITS; 64183f64091Sbellard buf += len; 64283f64091Sbellard count -= len; 64383f64091Sbellard } 64483f64091Sbellard 64583f64091Sbellard /* add data from the last sector */ 64683f64091Sbellard if (count > 0) { 64783f64091Sbellard if (bdrv_read(bs, sector_num, tmp_buf, 1) < 0) 64883f64091Sbellard return -EIO; 64983f64091Sbellard memcpy(tmp_buf, buf, count); 65083f64091Sbellard if (bdrv_write(bs, sector_num, tmp_buf, 1) < 0) 65183f64091Sbellard return -EIO; 65283f64091Sbellard } 65383f64091Sbellard return count1; 65483f64091Sbellard } 65583f64091Sbellard 65683f64091Sbellard /** 65783f64091Sbellard * Read with byte offsets (needed only for file protocols) 65883f64091Sbellard */ 65983f64091Sbellard int bdrv_pread(BlockDriverState *bs, int64_t offset, 66083f64091Sbellard void *buf1, int count1) 66183f64091Sbellard { 66283f64091Sbellard BlockDriver *drv = bs->drv; 66383f64091Sbellard 66483f64091Sbellard if (!drv) 66519cb3738Sbellard return -ENOMEDIUM; 66683f64091Sbellard if (!drv->bdrv_pread) 667faea38e7Sbellard return bdrv_pread_em(bs, offset, buf1, count1); 66883f64091Sbellard return drv->bdrv_pread(bs, offset, buf1, count1); 66983f64091Sbellard } 67083f64091Sbellard 67183f64091Sbellard /** 67283f64091Sbellard * Write with byte offsets (needed only for file protocols) 67383f64091Sbellard */ 67483f64091Sbellard int bdrv_pwrite(BlockDriverState *bs, int64_t offset, 67583f64091Sbellard const void *buf1, int count1) 67683f64091Sbellard { 67783f64091Sbellard BlockDriver *drv = bs->drv; 67883f64091Sbellard 67983f64091Sbellard if (!drv) 68019cb3738Sbellard return -ENOMEDIUM; 68183f64091Sbellard if (!drv->bdrv_pwrite) 682faea38e7Sbellard return bdrv_pwrite_em(bs, offset, buf1, count1); 68383f64091Sbellard return drv->bdrv_pwrite(bs, offset, buf1, count1); 68483f64091Sbellard } 68583f64091Sbellard 68683f64091Sbellard /** 68783f64091Sbellard * Truncate file to 'offset' bytes (needed only for file protocols) 68883f64091Sbellard */ 68983f64091Sbellard int bdrv_truncate(BlockDriverState *bs, int64_t offset) 69083f64091Sbellard { 69183f64091Sbellard BlockDriver *drv = bs->drv; 69283f64091Sbellard if (!drv) 69319cb3738Sbellard return -ENOMEDIUM; 69483f64091Sbellard if (!drv->bdrv_truncate) 69583f64091Sbellard return -ENOTSUP; 69683f64091Sbellard return drv->bdrv_truncate(bs, offset); 69783f64091Sbellard } 69883f64091Sbellard 69983f64091Sbellard /** 70083f64091Sbellard * Length of a file in bytes. Return < 0 if error or unknown. 70183f64091Sbellard */ 70283f64091Sbellard int64_t bdrv_getlength(BlockDriverState *bs) 70383f64091Sbellard { 70483f64091Sbellard BlockDriver *drv = bs->drv; 70583f64091Sbellard if (!drv) 70619cb3738Sbellard return -ENOMEDIUM; 70783f64091Sbellard if (!drv->bdrv_getlength) { 70883f64091Sbellard /* legacy mode */ 70983f64091Sbellard return bs->total_sectors * SECTOR_SIZE; 71083f64091Sbellard } 71183f64091Sbellard return drv->bdrv_getlength(bs); 712fc01f7e7Sbellard } 713fc01f7e7Sbellard 71419cb3738Sbellard /* return 0 as number of sectors if no device present or error */ 715fc01f7e7Sbellard void bdrv_get_geometry(BlockDriverState *bs, int64_t *nb_sectors_ptr) 716fc01f7e7Sbellard { 71719cb3738Sbellard int64_t length; 71819cb3738Sbellard length = bdrv_getlength(bs); 71919cb3738Sbellard if (length < 0) 72019cb3738Sbellard length = 0; 72119cb3738Sbellard else 72219cb3738Sbellard length = length >> SECTOR_BITS; 72319cb3738Sbellard *nb_sectors_ptr = length; 724fc01f7e7Sbellard } 725cf98951bSbellard 726cf98951bSbellard /* force a given boot sector. */ 727cf98951bSbellard void bdrv_set_boot_sector(BlockDriverState *bs, const uint8_t *data, int size) 728cf98951bSbellard { 729cf98951bSbellard bs->boot_sector_enabled = 1; 730cf98951bSbellard if (size > 512) 731cf98951bSbellard size = 512; 732cf98951bSbellard memcpy(bs->boot_sector_data, data, size); 733cf98951bSbellard memset(bs->boot_sector_data + size, 0, 512 - size); 734cf98951bSbellard } 735b338082bSbellard 736b338082bSbellard void bdrv_set_geometry_hint(BlockDriverState *bs, 737b338082bSbellard int cyls, int heads, int secs) 738b338082bSbellard { 739b338082bSbellard bs->cyls = cyls; 740b338082bSbellard bs->heads = heads; 741b338082bSbellard bs->secs = secs; 742b338082bSbellard } 743b338082bSbellard 744b338082bSbellard void bdrv_set_type_hint(BlockDriverState *bs, int type) 745b338082bSbellard { 746b338082bSbellard bs->type = type; 747b338082bSbellard bs->removable = ((type == BDRV_TYPE_CDROM || 748b338082bSbellard type == BDRV_TYPE_FLOPPY)); 749b338082bSbellard } 750b338082bSbellard 75146d4767dSbellard void bdrv_set_translation_hint(BlockDriverState *bs, int translation) 75246d4767dSbellard { 75346d4767dSbellard bs->translation = translation; 75446d4767dSbellard } 75546d4767dSbellard 756b338082bSbellard void bdrv_get_geometry_hint(BlockDriverState *bs, 757b338082bSbellard int *pcyls, int *pheads, int *psecs) 758b338082bSbellard { 759b338082bSbellard *pcyls = bs->cyls; 760b338082bSbellard *pheads = bs->heads; 761b338082bSbellard *psecs = bs->secs; 762b338082bSbellard } 763b338082bSbellard 764b338082bSbellard int bdrv_get_type_hint(BlockDriverState *bs) 765b338082bSbellard { 766b338082bSbellard return bs->type; 767b338082bSbellard } 768b338082bSbellard 76946d4767dSbellard int bdrv_get_translation_hint(BlockDriverState *bs) 77046d4767dSbellard { 77146d4767dSbellard return bs->translation; 77246d4767dSbellard } 77346d4767dSbellard 774b338082bSbellard int bdrv_is_removable(BlockDriverState *bs) 775b338082bSbellard { 776b338082bSbellard return bs->removable; 777b338082bSbellard } 778b338082bSbellard 779b338082bSbellard int bdrv_is_read_only(BlockDriverState *bs) 780b338082bSbellard { 781b338082bSbellard return bs->read_only; 782b338082bSbellard } 783b338082bSbellard 78419cb3738Sbellard /* XXX: no longer used */ 785b338082bSbellard void bdrv_set_change_cb(BlockDriverState *bs, 786b338082bSbellard void (*change_cb)(void *opaque), void *opaque) 787b338082bSbellard { 788b338082bSbellard bs->change_cb = change_cb; 789b338082bSbellard bs->change_opaque = opaque; 790b338082bSbellard } 791b338082bSbellard 792ea2384d3Sbellard int bdrv_is_encrypted(BlockDriverState *bs) 793ea2384d3Sbellard { 794ea2384d3Sbellard if (bs->backing_hd && bs->backing_hd->encrypted) 795ea2384d3Sbellard return 1; 796ea2384d3Sbellard return bs->encrypted; 797ea2384d3Sbellard } 798ea2384d3Sbellard 799ea2384d3Sbellard int bdrv_set_key(BlockDriverState *bs, const char *key) 800ea2384d3Sbellard { 801ea2384d3Sbellard int ret; 802ea2384d3Sbellard if (bs->backing_hd && bs->backing_hd->encrypted) { 803ea2384d3Sbellard ret = bdrv_set_key(bs->backing_hd, key); 804ea2384d3Sbellard if (ret < 0) 805ea2384d3Sbellard return ret; 806ea2384d3Sbellard if (!bs->encrypted) 807ea2384d3Sbellard return 0; 808ea2384d3Sbellard } 809ea2384d3Sbellard if (!bs->encrypted || !bs->drv || !bs->drv->bdrv_set_key) 810ea2384d3Sbellard return -1; 811ea2384d3Sbellard return bs->drv->bdrv_set_key(bs, key); 812ea2384d3Sbellard } 813ea2384d3Sbellard 814ea2384d3Sbellard void bdrv_get_format(BlockDriverState *bs, char *buf, int buf_size) 815ea2384d3Sbellard { 81619cb3738Sbellard if (!bs->drv) { 817ea2384d3Sbellard buf[0] = '\0'; 818ea2384d3Sbellard } else { 819ea2384d3Sbellard pstrcpy(buf, buf_size, bs->drv->format_name); 820ea2384d3Sbellard } 821ea2384d3Sbellard } 822ea2384d3Sbellard 823ea2384d3Sbellard void bdrv_iterate_format(void (*it)(void *opaque, const char *name), 824ea2384d3Sbellard void *opaque) 825ea2384d3Sbellard { 826ea2384d3Sbellard BlockDriver *drv; 827ea2384d3Sbellard 828ea2384d3Sbellard for (drv = first_drv; drv != NULL; drv = drv->next) { 829ea2384d3Sbellard it(opaque, drv->format_name); 830ea2384d3Sbellard } 831ea2384d3Sbellard } 832ea2384d3Sbellard 833b338082bSbellard BlockDriverState *bdrv_find(const char *name) 834b338082bSbellard { 835b338082bSbellard BlockDriverState *bs; 836b338082bSbellard 837b338082bSbellard for (bs = bdrv_first; bs != NULL; bs = bs->next) { 838b338082bSbellard if (!strcmp(name, bs->device_name)) 839b338082bSbellard return bs; 840b338082bSbellard } 841b338082bSbellard return NULL; 842b338082bSbellard } 843b338082bSbellard 84481d0912dSbellard void bdrv_iterate(void (*it)(void *opaque, const char *name), void *opaque) 84581d0912dSbellard { 84681d0912dSbellard BlockDriverState *bs; 84781d0912dSbellard 84881d0912dSbellard for (bs = bdrv_first; bs != NULL; bs = bs->next) { 84981d0912dSbellard it(opaque, bs->device_name); 85081d0912dSbellard } 85181d0912dSbellard } 85281d0912dSbellard 853ea2384d3Sbellard const char *bdrv_get_device_name(BlockDriverState *bs) 854ea2384d3Sbellard { 855ea2384d3Sbellard return bs->device_name; 856ea2384d3Sbellard } 857ea2384d3Sbellard 8587a6cba61Spbrook void bdrv_flush(BlockDriverState *bs) 8597a6cba61Spbrook { 8607a6cba61Spbrook if (bs->drv->bdrv_flush) 8617a6cba61Spbrook bs->drv->bdrv_flush(bs); 8627a6cba61Spbrook if (bs->backing_hd) 8637a6cba61Spbrook bdrv_flush(bs->backing_hd); 8647a6cba61Spbrook } 8657a6cba61Spbrook 866*faf07963Spbrook #ifndef QEMU_IMG 867b338082bSbellard void bdrv_info(void) 868b338082bSbellard { 869b338082bSbellard BlockDriverState *bs; 870b338082bSbellard 871b338082bSbellard for (bs = bdrv_first; bs != NULL; bs = bs->next) { 872b338082bSbellard term_printf("%s:", bs->device_name); 873b338082bSbellard term_printf(" type="); 874b338082bSbellard switch(bs->type) { 875b338082bSbellard case BDRV_TYPE_HD: 876b338082bSbellard term_printf("hd"); 877b338082bSbellard break; 878b338082bSbellard case BDRV_TYPE_CDROM: 879b338082bSbellard term_printf("cdrom"); 880b338082bSbellard break; 881b338082bSbellard case BDRV_TYPE_FLOPPY: 882b338082bSbellard term_printf("floppy"); 883b338082bSbellard break; 884b338082bSbellard } 885b338082bSbellard term_printf(" removable=%d", bs->removable); 886b338082bSbellard if (bs->removable) { 887b338082bSbellard term_printf(" locked=%d", bs->locked); 888b338082bSbellard } 88919cb3738Sbellard if (bs->drv) { 890fef30743Sths term_printf(" file="); 891fef30743Sths term_print_filename(bs->filename); 892fef30743Sths if (bs->backing_file[0] != '\0') { 893fef30743Sths term_printf(" backing_file="); 894fef30743Sths term_print_filename(bs->backing_file); 895fef30743Sths } 896b338082bSbellard term_printf(" ro=%d", bs->read_only); 897ea2384d3Sbellard term_printf(" drv=%s", bs->drv->format_name); 898ea2384d3Sbellard if (bs->encrypted) 899ea2384d3Sbellard term_printf(" encrypted"); 900b338082bSbellard } else { 901b338082bSbellard term_printf(" [not inserted]"); 902b338082bSbellard } 903b338082bSbellard term_printf("\n"); 904b338082bSbellard } 905b338082bSbellard } 906*faf07963Spbrook #endif 907ea2384d3Sbellard 90883f64091Sbellard void bdrv_get_backing_filename(BlockDriverState *bs, 90983f64091Sbellard char *filename, int filename_size) 91083f64091Sbellard { 91183f64091Sbellard if (!bs->backing_hd) { 91283f64091Sbellard pstrcpy(filename, filename_size, ""); 91383f64091Sbellard } else { 91483f64091Sbellard pstrcpy(filename, filename_size, bs->backing_file); 91583f64091Sbellard } 91683f64091Sbellard } 91783f64091Sbellard 918faea38e7Sbellard int bdrv_write_compressed(BlockDriverState *bs, int64_t sector_num, 919faea38e7Sbellard const uint8_t *buf, int nb_sectors) 920faea38e7Sbellard { 921faea38e7Sbellard BlockDriver *drv = bs->drv; 922faea38e7Sbellard if (!drv) 92319cb3738Sbellard return -ENOMEDIUM; 924faea38e7Sbellard if (!drv->bdrv_write_compressed) 925faea38e7Sbellard return -ENOTSUP; 926faea38e7Sbellard return drv->bdrv_write_compressed(bs, sector_num, buf, nb_sectors); 927faea38e7Sbellard } 928faea38e7Sbellard 929faea38e7Sbellard int bdrv_get_info(BlockDriverState *bs, BlockDriverInfo *bdi) 930faea38e7Sbellard { 931faea38e7Sbellard BlockDriver *drv = bs->drv; 932faea38e7Sbellard if (!drv) 93319cb3738Sbellard return -ENOMEDIUM; 934faea38e7Sbellard if (!drv->bdrv_get_info) 935faea38e7Sbellard return -ENOTSUP; 936faea38e7Sbellard memset(bdi, 0, sizeof(*bdi)); 937faea38e7Sbellard return drv->bdrv_get_info(bs, bdi); 938faea38e7Sbellard } 939faea38e7Sbellard 940faea38e7Sbellard /**************************************************************/ 941faea38e7Sbellard /* handling of snapshots */ 942faea38e7Sbellard 943faea38e7Sbellard int bdrv_snapshot_create(BlockDriverState *bs, 944faea38e7Sbellard QEMUSnapshotInfo *sn_info) 945faea38e7Sbellard { 946faea38e7Sbellard BlockDriver *drv = bs->drv; 947faea38e7Sbellard if (!drv) 94819cb3738Sbellard return -ENOMEDIUM; 949faea38e7Sbellard if (!drv->bdrv_snapshot_create) 950faea38e7Sbellard return -ENOTSUP; 951faea38e7Sbellard return drv->bdrv_snapshot_create(bs, sn_info); 952faea38e7Sbellard } 953faea38e7Sbellard 954faea38e7Sbellard int bdrv_snapshot_goto(BlockDriverState *bs, 955faea38e7Sbellard const char *snapshot_id) 956faea38e7Sbellard { 957faea38e7Sbellard BlockDriver *drv = bs->drv; 958faea38e7Sbellard if (!drv) 95919cb3738Sbellard return -ENOMEDIUM; 960faea38e7Sbellard if (!drv->bdrv_snapshot_goto) 961faea38e7Sbellard return -ENOTSUP; 962faea38e7Sbellard return drv->bdrv_snapshot_goto(bs, snapshot_id); 963faea38e7Sbellard } 964faea38e7Sbellard 965faea38e7Sbellard int bdrv_snapshot_delete(BlockDriverState *bs, const char *snapshot_id) 966faea38e7Sbellard { 967faea38e7Sbellard BlockDriver *drv = bs->drv; 968faea38e7Sbellard if (!drv) 96919cb3738Sbellard return -ENOMEDIUM; 970faea38e7Sbellard if (!drv->bdrv_snapshot_delete) 971faea38e7Sbellard return -ENOTSUP; 972faea38e7Sbellard return drv->bdrv_snapshot_delete(bs, snapshot_id); 973faea38e7Sbellard } 974faea38e7Sbellard 975faea38e7Sbellard int bdrv_snapshot_list(BlockDriverState *bs, 976faea38e7Sbellard QEMUSnapshotInfo **psn_info) 977faea38e7Sbellard { 978faea38e7Sbellard BlockDriver *drv = bs->drv; 979faea38e7Sbellard if (!drv) 98019cb3738Sbellard return -ENOMEDIUM; 981faea38e7Sbellard if (!drv->bdrv_snapshot_list) 982faea38e7Sbellard return -ENOTSUP; 983faea38e7Sbellard return drv->bdrv_snapshot_list(bs, psn_info); 984faea38e7Sbellard } 985faea38e7Sbellard 986faea38e7Sbellard #define NB_SUFFIXES 4 987faea38e7Sbellard 988faea38e7Sbellard char *get_human_readable_size(char *buf, int buf_size, int64_t size) 989faea38e7Sbellard { 990faea38e7Sbellard static const char suffixes[NB_SUFFIXES] = "KMGT"; 991faea38e7Sbellard int64_t base; 992faea38e7Sbellard int i; 993faea38e7Sbellard 994faea38e7Sbellard if (size <= 999) { 995faea38e7Sbellard snprintf(buf, buf_size, "%" PRId64, size); 996faea38e7Sbellard } else { 997faea38e7Sbellard base = 1024; 998faea38e7Sbellard for(i = 0; i < NB_SUFFIXES; i++) { 999faea38e7Sbellard if (size < (10 * base)) { 1000faea38e7Sbellard snprintf(buf, buf_size, "%0.1f%c", 1001faea38e7Sbellard (double)size / base, 1002faea38e7Sbellard suffixes[i]); 1003faea38e7Sbellard break; 1004faea38e7Sbellard } else if (size < (1000 * base) || i == (NB_SUFFIXES - 1)) { 1005faea38e7Sbellard snprintf(buf, buf_size, "%" PRId64 "%c", 1006faea38e7Sbellard ((size + (base >> 1)) / base), 1007faea38e7Sbellard suffixes[i]); 1008faea38e7Sbellard break; 1009faea38e7Sbellard } 1010faea38e7Sbellard base = base * 1024; 1011faea38e7Sbellard } 1012faea38e7Sbellard } 1013faea38e7Sbellard return buf; 1014faea38e7Sbellard } 1015faea38e7Sbellard 1016faea38e7Sbellard char *bdrv_snapshot_dump(char *buf, int buf_size, QEMUSnapshotInfo *sn) 1017faea38e7Sbellard { 1018faea38e7Sbellard char buf1[128], date_buf[128], clock_buf[128]; 10193b9f94e1Sbellard #ifdef _WIN32 10203b9f94e1Sbellard struct tm *ptm; 10213b9f94e1Sbellard #else 1022faea38e7Sbellard struct tm tm; 10233b9f94e1Sbellard #endif 1024faea38e7Sbellard time_t ti; 1025faea38e7Sbellard int64_t secs; 1026faea38e7Sbellard 1027faea38e7Sbellard if (!sn) { 1028faea38e7Sbellard snprintf(buf, buf_size, 1029faea38e7Sbellard "%-10s%-20s%7s%20s%15s", 1030faea38e7Sbellard "ID", "TAG", "VM SIZE", "DATE", "VM CLOCK"); 1031faea38e7Sbellard } else { 1032faea38e7Sbellard ti = sn->date_sec; 10333b9f94e1Sbellard #ifdef _WIN32 10343b9f94e1Sbellard ptm = localtime(&ti); 10353b9f94e1Sbellard strftime(date_buf, sizeof(date_buf), 10363b9f94e1Sbellard "%Y-%m-%d %H:%M:%S", ptm); 10373b9f94e1Sbellard #else 1038faea38e7Sbellard localtime_r(&ti, &tm); 1039faea38e7Sbellard strftime(date_buf, sizeof(date_buf), 1040faea38e7Sbellard "%Y-%m-%d %H:%M:%S", &tm); 10413b9f94e1Sbellard #endif 1042faea38e7Sbellard secs = sn->vm_clock_nsec / 1000000000; 1043faea38e7Sbellard snprintf(clock_buf, sizeof(clock_buf), 1044faea38e7Sbellard "%02d:%02d:%02d.%03d", 1045faea38e7Sbellard (int)(secs / 3600), 1046faea38e7Sbellard (int)((secs / 60) % 60), 1047faea38e7Sbellard (int)(secs % 60), 1048faea38e7Sbellard (int)((sn->vm_clock_nsec / 1000000) % 1000)); 1049faea38e7Sbellard snprintf(buf, buf_size, 1050faea38e7Sbellard "%-10s%-20s%7s%20s%15s", 1051faea38e7Sbellard sn->id_str, sn->name, 1052faea38e7Sbellard get_human_readable_size(buf1, sizeof(buf1), sn->vm_state_size), 1053faea38e7Sbellard date_buf, 1054faea38e7Sbellard clock_buf); 1055faea38e7Sbellard } 1056faea38e7Sbellard return buf; 1057faea38e7Sbellard } 1058faea38e7Sbellard 105983f64091Sbellard 1060ea2384d3Sbellard /**************************************************************/ 106183f64091Sbellard /* async I/Os */ 1062ea2384d3Sbellard 1063ce1a14dcSpbrook BlockDriverAIOCB *bdrv_aio_read(BlockDriverState *bs, int64_t sector_num, 106483f64091Sbellard uint8_t *buf, int nb_sectors, 106583f64091Sbellard BlockDriverCompletionFunc *cb, void *opaque) 1066ea2384d3Sbellard { 106783f64091Sbellard BlockDriver *drv = bs->drv; 1068ea2384d3Sbellard 106919cb3738Sbellard if (!drv) 1070ce1a14dcSpbrook return NULL; 107183f64091Sbellard 107283f64091Sbellard /* XXX: we assume that nb_sectors == 0 is suppored by the async read */ 107383f64091Sbellard if (sector_num == 0 && bs->boot_sector_enabled && nb_sectors > 0) { 107483f64091Sbellard memcpy(buf, bs->boot_sector_data, 512); 107583f64091Sbellard sector_num++; 107683f64091Sbellard nb_sectors--; 107783f64091Sbellard buf += 512; 1078ea2384d3Sbellard } 107983f64091Sbellard 1080ce1a14dcSpbrook return drv->bdrv_aio_read(bs, sector_num, buf, nb_sectors, cb, opaque); 108183f64091Sbellard } 108283f64091Sbellard 1083ce1a14dcSpbrook BlockDriverAIOCB *bdrv_aio_write(BlockDriverState *bs, int64_t sector_num, 108483f64091Sbellard const uint8_t *buf, int nb_sectors, 108583f64091Sbellard BlockDriverCompletionFunc *cb, void *opaque) 10867674e7bfSbellard { 108783f64091Sbellard BlockDriver *drv = bs->drv; 108883f64091Sbellard 108919cb3738Sbellard if (!drv) 1090ce1a14dcSpbrook return NULL; 109183f64091Sbellard if (bs->read_only) 1092ce1a14dcSpbrook return NULL; 109383f64091Sbellard if (sector_num == 0 && bs->boot_sector_enabled && nb_sectors > 0) { 109483f64091Sbellard memcpy(bs->boot_sector_data, buf, 512); 10957674e7bfSbellard } 109683f64091Sbellard 1097ce1a14dcSpbrook return drv->bdrv_aio_write(bs, sector_num, buf, nb_sectors, cb, opaque); 109883f64091Sbellard } 109983f64091Sbellard 110083f64091Sbellard void bdrv_aio_cancel(BlockDriverAIOCB *acb) 110183f64091Sbellard { 1102ce1a14dcSpbrook BlockDriver *drv = acb->bs->drv; 110383f64091Sbellard 110483f64091Sbellard drv->bdrv_aio_cancel(acb); 110583f64091Sbellard } 110683f64091Sbellard 110783f64091Sbellard 110883f64091Sbellard /**************************************************************/ 110983f64091Sbellard /* async block device emulation */ 111083f64091Sbellard 1111*faf07963Spbrook #ifdef QEMU_IMG 1112ce1a14dcSpbrook static BlockDriverAIOCB *bdrv_aio_read_em(BlockDriverState *bs, 1113ce1a14dcSpbrook int64_t sector_num, uint8_t *buf, int nb_sectors, 1114ce1a14dcSpbrook BlockDriverCompletionFunc *cb, void *opaque) 1115ea2384d3Sbellard { 1116ea2384d3Sbellard int ret; 1117ce1a14dcSpbrook ret = bdrv_read(bs, sector_num, buf, nb_sectors); 1118ce1a14dcSpbrook cb(opaque, ret); 1119ce1a14dcSpbrook return NULL; 1120ea2384d3Sbellard } 1121ea2384d3Sbellard 1122ce1a14dcSpbrook static BlockDriverAIOCB *bdrv_aio_write_em(BlockDriverState *bs, 1123ce1a14dcSpbrook int64_t sector_num, const uint8_t *buf, int nb_sectors, 1124ce1a14dcSpbrook BlockDriverCompletionFunc *cb, void *opaque) 1125ea2384d3Sbellard { 1126ea2384d3Sbellard int ret; 1127ce1a14dcSpbrook ret = bdrv_write(bs, sector_num, buf, nb_sectors); 1128ce1a14dcSpbrook cb(opaque, ret); 1129ce1a14dcSpbrook return NULL; 1130ea2384d3Sbellard } 1131ea2384d3Sbellard 113283f64091Sbellard static void bdrv_aio_cancel_em(BlockDriverAIOCB *acb) 1133ea2384d3Sbellard { 1134ea2384d3Sbellard } 1135beac80cdSbellard #else 113683f64091Sbellard static void bdrv_aio_bh_cb(void *opaque) 1137beac80cdSbellard { 1138ce1a14dcSpbrook BlockDriverAIOCBSync *acb = opaque; 1139ce1a14dcSpbrook acb->common.cb(acb->common.opaque, acb->ret); 1140ce1a14dcSpbrook qemu_aio_release(acb); 1141beac80cdSbellard } 1142beac80cdSbellard 1143ce1a14dcSpbrook static BlockDriverAIOCB *bdrv_aio_read_em(BlockDriverState *bs, 1144ce1a14dcSpbrook int64_t sector_num, uint8_t *buf, int nb_sectors, 1145ce1a14dcSpbrook BlockDriverCompletionFunc *cb, void *opaque) 1146ea2384d3Sbellard { 1147ce1a14dcSpbrook BlockDriverAIOCBSync *acb; 114883f64091Sbellard int ret; 114983f64091Sbellard 1150ce1a14dcSpbrook acb = qemu_aio_get(bs, cb, opaque); 1151ce1a14dcSpbrook if (!acb->bh) 1152ce1a14dcSpbrook acb->bh = qemu_bh_new(bdrv_aio_bh_cb, acb); 1153ce1a14dcSpbrook ret = bdrv_read(bs, sector_num, buf, nb_sectors); 1154ce1a14dcSpbrook acb->ret = ret; 1155ce1a14dcSpbrook qemu_bh_schedule(acb->bh); 1156ce1a14dcSpbrook return &acb->common; 11577a6cba61Spbrook } 11587a6cba61Spbrook 1159ce1a14dcSpbrook static BlockDriverAIOCB *bdrv_aio_write_em(BlockDriverState *bs, 1160ce1a14dcSpbrook int64_t sector_num, const uint8_t *buf, int nb_sectors, 1161ce1a14dcSpbrook BlockDriverCompletionFunc *cb, void *opaque) 116283f64091Sbellard { 1163ce1a14dcSpbrook BlockDriverAIOCBSync *acb; 116483f64091Sbellard int ret; 116583f64091Sbellard 1166ce1a14dcSpbrook acb = qemu_aio_get(bs, cb, opaque); 1167ce1a14dcSpbrook if (!acb->bh) 1168ce1a14dcSpbrook acb->bh = qemu_bh_new(bdrv_aio_bh_cb, acb); 1169ce1a14dcSpbrook ret = bdrv_write(bs, sector_num, buf, nb_sectors); 1170ce1a14dcSpbrook acb->ret = ret; 1171ce1a14dcSpbrook qemu_bh_schedule(acb->bh); 1172ce1a14dcSpbrook return &acb->common; 117383f64091Sbellard } 117483f64091Sbellard 1175ce1a14dcSpbrook static void bdrv_aio_cancel_em(BlockDriverAIOCB *blockacb) 117683f64091Sbellard { 1177ce1a14dcSpbrook BlockDriverAIOCBSync *acb = (BlockDriverAIOCBSync *)blockacb; 1178ce1a14dcSpbrook qemu_bh_cancel(acb->bh); 1179ce1a14dcSpbrook qemu_aio_release(acb); 118083f64091Sbellard } 1181*faf07963Spbrook #endif /* !QEMU_IMG */ 118283f64091Sbellard 118383f64091Sbellard /**************************************************************/ 118483f64091Sbellard /* sync block device emulation */ 118583f64091Sbellard 118683f64091Sbellard static void bdrv_rw_em_cb(void *opaque, int ret) 118783f64091Sbellard { 118883f64091Sbellard *(int *)opaque = ret; 118983f64091Sbellard } 119083f64091Sbellard 119183f64091Sbellard #define NOT_DONE 0x7fffffff 119283f64091Sbellard 119383f64091Sbellard static int bdrv_read_em(BlockDriverState *bs, int64_t sector_num, 119483f64091Sbellard uint8_t *buf, int nb_sectors) 119583f64091Sbellard { 1196ce1a14dcSpbrook int async_ret; 1197ce1a14dcSpbrook BlockDriverAIOCB *acb; 119883f64091Sbellard 119983f64091Sbellard async_ret = NOT_DONE; 120083f64091Sbellard qemu_aio_wait_start(); 1201ce1a14dcSpbrook acb = bdrv_aio_read(bs, sector_num, buf, nb_sectors, 120283f64091Sbellard bdrv_rw_em_cb, &async_ret); 1203ce1a14dcSpbrook if (acb == NULL) { 120483f64091Sbellard qemu_aio_wait_end(); 1205ce1a14dcSpbrook return -1; 120683f64091Sbellard } 120783f64091Sbellard while (async_ret == NOT_DONE) { 120883f64091Sbellard qemu_aio_wait(); 120983f64091Sbellard } 121083f64091Sbellard qemu_aio_wait_end(); 121183f64091Sbellard return async_ret; 121283f64091Sbellard } 121383f64091Sbellard 121483f64091Sbellard static int bdrv_write_em(BlockDriverState *bs, int64_t sector_num, 121583f64091Sbellard const uint8_t *buf, int nb_sectors) 121683f64091Sbellard { 1217ce1a14dcSpbrook int async_ret; 1218ce1a14dcSpbrook BlockDriverAIOCB *acb; 121983f64091Sbellard 122083f64091Sbellard async_ret = NOT_DONE; 122183f64091Sbellard qemu_aio_wait_start(); 1222ce1a14dcSpbrook acb = bdrv_aio_write(bs, sector_num, buf, nb_sectors, 122383f64091Sbellard bdrv_rw_em_cb, &async_ret); 1224ce1a14dcSpbrook if (acb == NULL) { 122583f64091Sbellard qemu_aio_wait_end(); 1226ce1a14dcSpbrook return -1; 122783f64091Sbellard } 122883f64091Sbellard while (async_ret == NOT_DONE) { 122983f64091Sbellard qemu_aio_wait(); 123083f64091Sbellard } 123183f64091Sbellard qemu_aio_wait_end(); 123283f64091Sbellard return async_ret; 123383f64091Sbellard } 1234ea2384d3Sbellard 1235ea2384d3Sbellard void bdrv_init(void) 1236ea2384d3Sbellard { 1237ea2384d3Sbellard bdrv_register(&bdrv_raw); 123819cb3738Sbellard bdrv_register(&bdrv_host_device); 1239ea2384d3Sbellard #ifndef _WIN32 1240ea2384d3Sbellard bdrv_register(&bdrv_cow); 1241ea2384d3Sbellard #endif 1242ea2384d3Sbellard bdrv_register(&bdrv_qcow); 1243ea2384d3Sbellard bdrv_register(&bdrv_vmdk); 12443c56521bSbellard bdrv_register(&bdrv_cloop); 1245585d0ed9Sbellard bdrv_register(&bdrv_dmg); 1246a8753c34Sbellard bdrv_register(&bdrv_bochs); 12476a0f9e82Sbellard bdrv_register(&bdrv_vpc); 1248712e7874Sbellard bdrv_register(&bdrv_vvfat); 1249faea38e7Sbellard bdrv_register(&bdrv_qcow2); 12506ada7453Sths bdrv_register(&bdrv_parallels); 1251ea2384d3Sbellard } 1252ce1a14dcSpbrook 1253ce1a14dcSpbrook void *qemu_aio_get(BlockDriverState *bs, BlockDriverCompletionFunc *cb, 1254ce1a14dcSpbrook void *opaque) 1255ce1a14dcSpbrook { 1256ce1a14dcSpbrook BlockDriver *drv; 1257ce1a14dcSpbrook BlockDriverAIOCB *acb; 1258ce1a14dcSpbrook 1259ce1a14dcSpbrook drv = bs->drv; 1260ce1a14dcSpbrook if (drv->free_aiocb) { 1261ce1a14dcSpbrook acb = drv->free_aiocb; 1262ce1a14dcSpbrook drv->free_aiocb = acb->next; 1263ce1a14dcSpbrook } else { 1264ce1a14dcSpbrook acb = qemu_mallocz(drv->aiocb_size); 1265ce1a14dcSpbrook if (!acb) 1266ce1a14dcSpbrook return NULL; 1267ce1a14dcSpbrook } 1268ce1a14dcSpbrook acb->bs = bs; 1269ce1a14dcSpbrook acb->cb = cb; 1270ce1a14dcSpbrook acb->opaque = opaque; 1271ce1a14dcSpbrook return acb; 1272ce1a14dcSpbrook } 1273ce1a14dcSpbrook 1274ce1a14dcSpbrook void qemu_aio_release(void *p) 1275ce1a14dcSpbrook { 1276ce1a14dcSpbrook BlockDriverAIOCB *acb = p; 1277ce1a14dcSpbrook BlockDriver *drv = acb->bs->drv; 1278ce1a14dcSpbrook acb->next = drv->free_aiocb; 1279ce1a14dcSpbrook drv->free_aiocb = acb; 1280ce1a14dcSpbrook } 128119cb3738Sbellard 128219cb3738Sbellard /**************************************************************/ 128319cb3738Sbellard /* removable device support */ 128419cb3738Sbellard 128519cb3738Sbellard /** 128619cb3738Sbellard * Return TRUE if the media is present 128719cb3738Sbellard */ 128819cb3738Sbellard int bdrv_is_inserted(BlockDriverState *bs) 128919cb3738Sbellard { 129019cb3738Sbellard BlockDriver *drv = bs->drv; 129119cb3738Sbellard int ret; 129219cb3738Sbellard if (!drv) 129319cb3738Sbellard return 0; 129419cb3738Sbellard if (!drv->bdrv_is_inserted) 129519cb3738Sbellard return 1; 129619cb3738Sbellard ret = drv->bdrv_is_inserted(bs); 129719cb3738Sbellard return ret; 129819cb3738Sbellard } 129919cb3738Sbellard 130019cb3738Sbellard /** 130119cb3738Sbellard * Return TRUE if the media changed since the last call to this 130219cb3738Sbellard * function. It is currently only used for floppy disks 130319cb3738Sbellard */ 130419cb3738Sbellard int bdrv_media_changed(BlockDriverState *bs) 130519cb3738Sbellard { 130619cb3738Sbellard BlockDriver *drv = bs->drv; 130719cb3738Sbellard int ret; 130819cb3738Sbellard 130919cb3738Sbellard if (!drv || !drv->bdrv_media_changed) 131019cb3738Sbellard ret = -ENOTSUP; 131119cb3738Sbellard else 131219cb3738Sbellard ret = drv->bdrv_media_changed(bs); 131319cb3738Sbellard if (ret == -ENOTSUP) 131419cb3738Sbellard ret = bs->media_changed; 131519cb3738Sbellard bs->media_changed = 0; 131619cb3738Sbellard return ret; 131719cb3738Sbellard } 131819cb3738Sbellard 131919cb3738Sbellard /** 132019cb3738Sbellard * If eject_flag is TRUE, eject the media. Otherwise, close the tray 132119cb3738Sbellard */ 132219cb3738Sbellard void bdrv_eject(BlockDriverState *bs, int eject_flag) 132319cb3738Sbellard { 132419cb3738Sbellard BlockDriver *drv = bs->drv; 132519cb3738Sbellard int ret; 132619cb3738Sbellard 132719cb3738Sbellard if (!drv || !drv->bdrv_eject) { 132819cb3738Sbellard ret = -ENOTSUP; 132919cb3738Sbellard } else { 133019cb3738Sbellard ret = drv->bdrv_eject(bs, eject_flag); 133119cb3738Sbellard } 133219cb3738Sbellard if (ret == -ENOTSUP) { 133319cb3738Sbellard if (eject_flag) 133419cb3738Sbellard bdrv_close(bs); 133519cb3738Sbellard } 133619cb3738Sbellard } 133719cb3738Sbellard 133819cb3738Sbellard int bdrv_is_locked(BlockDriverState *bs) 133919cb3738Sbellard { 134019cb3738Sbellard return bs->locked; 134119cb3738Sbellard } 134219cb3738Sbellard 134319cb3738Sbellard /** 134419cb3738Sbellard * Lock or unlock the media (if it is locked, the user won't be able 134519cb3738Sbellard * to eject it manually). 134619cb3738Sbellard */ 134719cb3738Sbellard void bdrv_set_locked(BlockDriverState *bs, int locked) 134819cb3738Sbellard { 134919cb3738Sbellard BlockDriver *drv = bs->drv; 135019cb3738Sbellard 135119cb3738Sbellard bs->locked = locked; 135219cb3738Sbellard if (drv && drv->bdrv_set_locked) { 135319cb3738Sbellard drv->bdrv_set_locked(bs, locked); 135419cb3738Sbellard } 135519cb3738Sbellard } 1356