1 | The following changes since commit 248b23735645f7cbb503d9be6f5bf825f2a603ab: | 1 | The following changes since commit dac03af5d5482ec7ee9c23db467bb7230b33c0d9: |
---|---|---|---|
2 | 2 | ||
3 | Update version for v2.10.0-rc4 release (2017-08-24 17:34:26 +0100) | 3 | Merge remote-tracking branch 'remotes/rth/tags/pull-axp-20190825' into staging (2019-08-27 10:00:51 +0100) |
4 | 4 | ||
5 | are available in the git repository at: | 5 | are available in the Git repository at: |
6 | 6 | ||
7 | git://github.com/stefanha/qemu.git tags/block-pull-request | 7 | https://github.com/stefanha/qemu.git tags/block-pull-request |
8 | 8 | ||
9 | for you to fetch changes up to 3e4c705212abfe8c9882a00beb2d1466a8a53cec: | 9 | for you to fetch changes up to 5396234b96a2ac743f48644529771498e036e698: |
10 | 10 | ||
11 | qcow2: allocate cluster_cache/cluster_data on demand (2017-08-30 18:02:10 +0100) | 11 | block/qcow2: implement .bdrv_co_pwritev(_compressed)_part (2019-08-27 14:58:42 +0100) |
12 | |||
13 | ---------------------------------------------------------------- | ||
14 | Pull request | ||
12 | 15 | ||
13 | ---------------------------------------------------------------- | 16 | ---------------------------------------------------------------- |
14 | 17 | ||
15 | ---------------------------------------------------------------- | 18 | Vladimir Sementsov-Ogievskiy (12): |
19 | util/iov: introduce qemu_iovec_init_extended | ||
20 | util/iov: improve qemu_iovec_is_zero | ||
21 | block/io: refactor padding | ||
22 | block: define .*_part io handlers in BlockDriver | ||
23 | block/io: bdrv_co_do_copy_on_readv: use and support qiov_offset | ||
24 | block/io: bdrv_co_do_copy_on_readv: lazy allocation | ||
25 | block/io: bdrv_aligned_preadv: use and support qiov_offset | ||
26 | block/io: bdrv_aligned_pwritev: use and support qiov_offset | ||
27 | block/io: introduce bdrv_co_p{read, write}v_part | ||
28 | block/qcow2: refactor qcow2_co_preadv to use buffer-based io | ||
29 | block/qcow2: implement .bdrv_co_preadv_part | ||
30 | block/qcow2: implement .bdrv_co_pwritev(_compressed)_part | ||
16 | 31 | ||
17 | Alberto Garcia (8): | 32 | block/qcow2.h | 1 + |
18 | throttle: Fix wrong variable name in the header documentation | 33 | include/block/block_int.h | 21 ++ |
19 | throttle: Update the throttle_fix_bucket() documentation | 34 | include/qemu/iov.h | 10 +- |
20 | throttle: Make throttle_is_valid() a bit less verbose | 35 | block/backup.c | 2 +- |
21 | throttle: Remove throttle_fix_bucket() / throttle_unfix_bucket() | 36 | block/io.c | 541 +++++++++++++++++++++++--------------- |
22 | throttle: Make LeakyBucket.avg and LeakyBucket.max integer types | 37 | block/qcow2-cluster.c | 14 +- |
23 | throttle: Make burst_length 64bit and add range checks | 38 | block/qcow2.c | 131 +++++---- |
24 | throttle: Test the valid range of config values | 39 | qemu-img.c | 4 +- |
25 | misc: Remove unused Error variables | 40 | util/iov.c | 153 +++++++++-- |
26 | 41 | 9 files changed, 568 insertions(+), 309 deletions(-) | |
27 | Dan Aloni (1): | ||
28 | nvme: Fix get/set number of queues feature, again | ||
29 | |||
30 | Eduardo Habkost (1): | ||
31 | oslib-posix: Print errors before aborting on qemu_alloc_stack() | ||
32 | |||
33 | Fred Rolland (1): | ||
34 | qemu-doc: Add UUID support in initiator name | ||
35 | |||
36 | Stefan Hajnoczi (4): | ||
37 | scripts: add argparse module for Python 2.6 compatibility | ||
38 | docker.py: Python 2.6 argparse compatibility | ||
39 | tests: migration/guestperf Python 2.6 argparse compatibility | ||
40 | qcow2: allocate cluster_cache/cluster_data on demand | ||
41 | |||
42 | include/qemu/throttle.h | 8 +- | ||
43 | block/qcow.c | 12 +- | ||
44 | block/qcow2-cluster.c | 17 + | ||
45 | block/qcow2.c | 20 +- | ||
46 | dump.c | 4 +- | ||
47 | hw/block/nvme.c | 4 +- | ||
48 | tests/test-throttle.c | 80 +- | ||
49 | util/oslib-posix.c | 2 + | ||
50 | util/throttle.c | 86 +- | ||
51 | COPYING.PYTHON | 270 ++++ | ||
52 | qemu-doc.texi | 5 +- | ||
53 | scripts/argparse.py | 2406 ++++++++++++++++++++++++++++++++++++ | ||
54 | tests/docker/docker.py | 4 +- | ||
55 | tests/migration/guestperf/shell.py | 8 +- | ||
56 | 14 files changed, 2831 insertions(+), 95 deletions(-) | ||
57 | create mode 100644 COPYING.PYTHON | ||
58 | create mode 100644 scripts/argparse.py | ||
59 | 42 | ||
60 | -- | 43 | -- |
61 | 2.13.5 | 44 | 2.21.0 |
62 | 45 | ||
63 | 46 | diff view generated by jsdifflib |
Deleted patch | |||
---|---|---|---|
1 | From: Dan Aloni <dan@kernelim.com> | ||
2 | 1 | ||
3 | The number of queues that should be return by the admin command should: | ||
4 | |||
5 | 1) Only mention the number of non-admin queues. | ||
6 | 2) It is zero-based, meaning that '0 == one non-admin queue', | ||
7 | '1 == two non-admin queues', and so forth. | ||
8 | |||
9 | Because our `num_queues` means the number of queues _plus_ the admin | ||
10 | queue, then the right calculation for the number returned from the admin | ||
11 | command is `num_queues - 2`, combining the two requirements mentioned. | ||
12 | |||
13 | The issue was discovered by reducing num_queues from 64 to 8 and running | ||
14 | a Linux VM with an SMP parameter larger than that (e.g. 22). It tries to | ||
15 | utilize all queues, and therefore fails with an invalid queue number | ||
16 | when trying to queue I/Os on the last queue. | ||
17 | |||
18 | Signed-off-by: Dan Aloni <dan@kernelim.com> | ||
19 | CC: Alex Friedman <alex@e8storage.com> | ||
20 | CC: Keith Busch <keith.busch@intel.com> | ||
21 | CC: Stefan Hajnoczi <stefanha@redhat.com> | ||
22 | Reviewed-by: Keith Busch <keith.busch@intel.com> | ||
23 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
24 | --- | ||
25 | hw/block/nvme.c | 4 ++-- | ||
26 | 1 file changed, 2 insertions(+), 2 deletions(-) | ||
27 | |||
28 | diff --git a/hw/block/nvme.c b/hw/block/nvme.c | ||
29 | index XXXXXXX..XXXXXXX 100644 | ||
30 | --- a/hw/block/nvme.c | ||
31 | +++ b/hw/block/nvme.c | ||
32 | @@ -XXX,XX +XXX,XX @@ static uint16_t nvme_get_feature(NvmeCtrl *n, NvmeCmd *cmd, NvmeRequest *req) | ||
33 | result = blk_enable_write_cache(n->conf.blk); | ||
34 | break; | ||
35 | case NVME_NUMBER_OF_QUEUES: | ||
36 | - result = cpu_to_le32((n->num_queues - 1) | ((n->num_queues - 1) << 16)); | ||
37 | + result = cpu_to_le32((n->num_queues - 2) | ((n->num_queues - 2) << 16)); | ||
38 | break; | ||
39 | default: | ||
40 | return NVME_INVALID_FIELD | NVME_DNR; | ||
41 | @@ -XXX,XX +XXX,XX @@ static uint16_t nvme_set_feature(NvmeCtrl *n, NvmeCmd *cmd, NvmeRequest *req) | ||
42 | break; | ||
43 | case NVME_NUMBER_OF_QUEUES: | ||
44 | req->cqe.result = | ||
45 | - cpu_to_le32((n->num_queues - 1) | ((n->num_queues - 1) << 16)); | ||
46 | + cpu_to_le32((n->num_queues - 2) | ((n->num_queues - 2) << 16)); | ||
47 | break; | ||
48 | default: | ||
49 | return NVME_INVALID_FIELD | NVME_DNR; | ||
50 | -- | ||
51 | 2.13.5 | ||
52 | |||
53 | diff view generated by jsdifflib |
Deleted patch | |||
---|---|---|---|
1 | From: Alberto Garcia <berto@igalia.com> | ||
2 | 1 | ||
3 | The level of the burst bucket is stored in bkt.burst_level, not | ||
4 | bkt.burst_length. | ||
5 | |||
6 | Signed-off-by: Alberto Garcia <berto@igalia.com> | ||
7 | Reviewed-by: Manos Pitsidianakis <el13635@mail.ntua.gr> | ||
8 | Message-id: 49aab2711d02f285567f3b3b13a113847af33812.1503580370.git.berto@igalia.com | ||
9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
10 | --- | ||
11 | include/qemu/throttle.h | 2 +- | ||
12 | 1 file changed, 1 insertion(+), 1 deletion(-) | ||
13 | |||
14 | diff --git a/include/qemu/throttle.h b/include/qemu/throttle.h | ||
15 | index XXXXXXX..XXXXXXX 100644 | ||
16 | --- a/include/qemu/throttle.h | ||
17 | +++ b/include/qemu/throttle.h | ||
18 | @@ -XXX,XX +XXX,XX @@ typedef enum { | ||
19 | * - The bkt.avg rate does not apply until the bucket is full, | ||
20 | * allowing the user to do bursts until then. The I/O limit during | ||
21 | * bursts is bkt.max. To enforce this limit we keep an additional | ||
22 | - * bucket in bkt.burst_length that leaks at a rate of bkt.max units | ||
23 | + * bucket in bkt.burst_level that leaks at a rate of bkt.max units | ||
24 | * per second. | ||
25 | * | ||
26 | * - Because of all of the above, the user can perform I/O at a | ||
27 | -- | ||
28 | 2.13.5 | ||
29 | |||
30 | diff view generated by jsdifflib |
Deleted patch | |||
---|---|---|---|
1 | From: Alberto Garcia <berto@igalia.com> | ||
2 | 1 | ||
3 | The way the throttling algorithm works is that requests start being | ||
4 | throttled once the bucket level exceeds the burst limit. When we get | ||
5 | there the bucket leaks at the level set by the user (bkt->avg), and | ||
6 | that leak rate is what prevents guest I/O from exceeding the desired | ||
7 | limit. | ||
8 | |||
9 | If we don't allow bursts (i.e. bkt->max == 0) then we can start | ||
10 | throttling requests immediately. The problem with keeping the | ||
11 | threshold at 0 is that it only allows one request at a time, and as | ||
12 | soon as there's a bit of I/O from the guest every other request will | ||
13 | be throttled and performance will suffer considerably. That can even | ||
14 | make the guest unable to reach the throttle limit if that limit is | ||
15 | high enough, and that happens regardless of the block scheduler used | ||
16 | by the guest. | ||
17 | |||
18 | Increasing that threshold gives flexibility to the guest, allowing it | ||
19 | to perform short bursts of I/O before being throttled. Increasing the | ||
20 | threshold too much does not make a difference in the long run (because | ||
21 | it's the leak rate what defines the actual throughput) but it does | ||
22 | allow the guest to perform longer initial bursts and exceed the | ||
23 | throttle limit for a short while. | ||
24 | |||
25 | A burst value of bkt->avg / 10 allows the guest to perform 100ms' | ||
26 | worth of I/O at the target rate without being throttled. | ||
27 | |||
28 | Signed-off-by: Alberto Garcia <berto@igalia.com> | ||
29 | Message-id: 31aae6645f0d1fbf3860fb2b528b757236f0c0a7.1503580370.git.berto@igalia.com | ||
30 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
31 | --- | ||
32 | util/throttle.c | 11 +++-------- | ||
33 | 1 file changed, 3 insertions(+), 8 deletions(-) | ||
34 | |||
35 | diff --git a/util/throttle.c b/util/throttle.c | ||
36 | index XXXXXXX..XXXXXXX 100644 | ||
37 | --- a/util/throttle.c | ||
38 | +++ b/util/throttle.c | ||
39 | @@ -XXX,XX +XXX,XX @@ static void throttle_fix_bucket(LeakyBucket *bkt) | ||
40 | /* zero bucket level */ | ||
41 | bkt->level = bkt->burst_level = 0; | ||
42 | |||
43 | - /* The following is done to cope with the Linux CFQ block scheduler | ||
44 | - * which regroup reads and writes by block of 100ms in the guest. | ||
45 | - * When they are two process one making reads and one making writes cfq | ||
46 | - * make a pattern looking like the following: | ||
47 | - * WWWWWWWWWWWRRRRRRRRRRRRRRWWWWWWWWWWWWWwRRRRRRRRRRRRRRRRR | ||
48 | - * Having a max burst value of 100ms of the average will help smooth the | ||
49 | - * throttling | ||
50 | - */ | ||
51 | + /* If bkt->max is 0 we still want to allow short bursts of I/O | ||
52 | + * from the guest, otherwise every other request will be throttled | ||
53 | + * and performance will suffer considerably. */ | ||
54 | min = bkt->avg / 10; | ||
55 | if (bkt->avg && !bkt->max) { | ||
56 | bkt->max = min; | ||
57 | -- | ||
58 | 2.13.5 | ||
59 | |||
60 | diff view generated by jsdifflib |
1 | From: Alberto Garcia <berto@igalia.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | Signed-off-by: Alberto Garcia <berto@igalia.com> | 3 | Introduce new initialization API, to create requests with padding. Will |
4 | Message-id: a57dd6274e1b6dc9c28769fec4c7ea543be5c5e3.1503580370.git.berto@igalia.com | 4 | be used in the following patch. New API uses qemu_iovec_init_buf if |
5 | resulting io vector has only one element, to avoid extra allocations. | ||
6 | So, we need to update qemu_iovec_destroy to support destroying such | ||
7 | QIOVs. | ||
8 | |||
9 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> | ||
10 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
11 | Message-id: 20190604161514.262241-2-vsementsov@virtuozzo.com | ||
12 | Message-Id: <20190604161514.262241-2-vsementsov@virtuozzo.com> | ||
5 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 13 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
6 | --- | 14 | --- |
7 | tests/test-throttle.c | 77 +++++++++++++++++++++++++++++++++++++++++++++++++++ | 15 | include/qemu/iov.h | 7 +++ |
8 | 1 file changed, 77 insertions(+) | 16 | util/iov.c | 112 +++++++++++++++++++++++++++++++++++++++++++-- |
17 | 2 files changed, 114 insertions(+), 5 deletions(-) | ||
9 | 18 | ||
10 | diff --git a/tests/test-throttle.c b/tests/test-throttle.c | 19 | diff --git a/include/qemu/iov.h b/include/qemu/iov.h |
11 | index XXXXXXX..XXXXXXX 100644 | 20 | index XXXXXXX..XXXXXXX 100644 |
12 | --- a/tests/test-throttle.c | 21 | --- a/include/qemu/iov.h |
13 | +++ b/tests/test-throttle.c | 22 | +++ b/include/qemu/iov.h |
14 | @@ -XXX,XX +XXX,XX @@ static void test_is_valid(void) | 23 | @@ -XXX,XX +XXX,XX @@ static inline void *qemu_iovec_buf(QEMUIOVector *qiov) |
15 | test_is_valid_for_value(1, true); | 24 | |
25 | void qemu_iovec_init(QEMUIOVector *qiov, int alloc_hint); | ||
26 | void qemu_iovec_init_external(QEMUIOVector *qiov, struct iovec *iov, int niov); | ||
27 | +void qemu_iovec_init_extended( | ||
28 | + QEMUIOVector *qiov, | ||
29 | + void *head_buf, size_t head_len, | ||
30 | + QEMUIOVector *mid_qiov, size_t mid_offset, size_t mid_len, | ||
31 | + void *tail_buf, size_t tail_len); | ||
32 | +void qemu_iovec_init_slice(QEMUIOVector *qiov, QEMUIOVector *source, | ||
33 | + size_t offset, size_t len); | ||
34 | void qemu_iovec_add(QEMUIOVector *qiov, void *base, size_t len); | ||
35 | void qemu_iovec_concat(QEMUIOVector *dst, | ||
36 | QEMUIOVector *src, size_t soffset, size_t sbytes); | ||
37 | diff --git a/util/iov.c b/util/iov.c | ||
38 | index XXXXXXX..XXXXXXX 100644 | ||
39 | --- a/util/iov.c | ||
40 | +++ b/util/iov.c | ||
41 | @@ -XXX,XX +XXX,XX @@ void qemu_iovec_concat(QEMUIOVector *dst, | ||
42 | qemu_iovec_concat_iov(dst, src->iov, src->niov, soffset, sbytes); | ||
16 | } | 43 | } |
17 | 44 | ||
18 | +static void test_ranges(void) | 45 | +/* |
46 | + * qiov_find_iov | ||
47 | + * | ||
48 | + * Return pointer to iovec structure, where byte at @offset in original vector | ||
49 | + * @iov exactly is. | ||
50 | + * Set @remaining_offset to be offset inside that iovec to the same byte. | ||
51 | + */ | ||
52 | +static struct iovec *iov_skip_offset(struct iovec *iov, size_t offset, | ||
53 | + size_t *remaining_offset) | ||
19 | +{ | 54 | +{ |
20 | + int i; | 55 | + while (offset > 0 && offset >= iov->iov_len) { |
56 | + offset -= iov->iov_len; | ||
57 | + iov++; | ||
58 | + } | ||
59 | + *remaining_offset = offset; | ||
21 | + | 60 | + |
22 | + for (i = 0; i < BUCKETS_COUNT; i++) { | 61 | + return iov; |
23 | + LeakyBucket *b = &cfg.buckets[i]; | 62 | +} |
24 | + throttle_config_init(&cfg); | ||
25 | + | 63 | + |
26 | + /* avg = 0 means throttling is disabled, but the config is valid */ | 64 | +/* |
27 | + b->avg = 0; | 65 | + * qiov_slice |
28 | + g_assert(throttle_is_valid(&cfg, NULL)); | 66 | + * |
29 | + g_assert(!throttle_enabled(&cfg)); | 67 | + * Find subarray of iovec's, containing requested range. @head would |
68 | + * be offset in first iov (returned by the function), @tail would be | ||
69 | + * count of extra bytes in last iovec (returned iov + @niov - 1). | ||
70 | + */ | ||
71 | +static struct iovec *qiov_slice(QEMUIOVector *qiov, | ||
72 | + size_t offset, size_t len, | ||
73 | + size_t *head, size_t *tail, int *niov) | ||
74 | +{ | ||
75 | + struct iovec *iov, *end_iov; | ||
30 | + | 76 | + |
31 | + /* These are valid configurations (values <= THROTTLE_VALUE_MAX) */ | 77 | + assert(offset + len <= qiov->size); |
32 | + b->avg = 1; | ||
33 | + g_assert(throttle_is_valid(&cfg, NULL)); | ||
34 | + | 78 | + |
35 | + b->avg = THROTTLE_VALUE_MAX; | 79 | + iov = iov_skip_offset(qiov->iov, offset, head); |
36 | + g_assert(throttle_is_valid(&cfg, NULL)); | 80 | + end_iov = iov_skip_offset(iov, *head + len, tail); |
37 | + | 81 | + |
38 | + b->avg = THROTTLE_VALUE_MAX; | 82 | + if (*tail > 0) { |
39 | + b->max = THROTTLE_VALUE_MAX; | 83 | + assert(*tail < end_iov->iov_len); |
40 | + g_assert(throttle_is_valid(&cfg, NULL)); | 84 | + *tail = end_iov->iov_len - *tail; |
85 | + end_iov++; | ||
86 | + } | ||
41 | + | 87 | + |
42 | + /* Values over THROTTLE_VALUE_MAX are not allowed */ | 88 | + *niov = end_iov - iov; |
43 | + b->avg = THROTTLE_VALUE_MAX + 1; | ||
44 | + g_assert(!throttle_is_valid(&cfg, NULL)); | ||
45 | + | 89 | + |
46 | + b->avg = THROTTLE_VALUE_MAX; | 90 | + return iov; |
47 | + b->max = THROTTLE_VALUE_MAX + 1; | 91 | +} |
48 | + g_assert(!throttle_is_valid(&cfg, NULL)); | ||
49 | + | 92 | + |
50 | + /* burst_length must be between 1 and THROTTLE_VALUE_MAX */ | 93 | +/* |
51 | + b->avg = 1; | 94 | + * Compile new iovec, combining @head_buf buffer, sub-qiov of @mid_qiov, |
52 | + b->max = 1; | 95 | + * and @tail_buf buffer into new qiov. |
53 | + b->burst_length = 0; | 96 | + */ |
54 | + g_assert(!throttle_is_valid(&cfg, NULL)); | 97 | +void qemu_iovec_init_extended( |
98 | + QEMUIOVector *qiov, | ||
99 | + void *head_buf, size_t head_len, | ||
100 | + QEMUIOVector *mid_qiov, size_t mid_offset, size_t mid_len, | ||
101 | + void *tail_buf, size_t tail_len) | ||
102 | +{ | ||
103 | + size_t mid_head, mid_tail; | ||
104 | + int total_niov, mid_niov = 0; | ||
105 | + struct iovec *p, *mid_iov; | ||
55 | + | 106 | + |
56 | + b->avg = 1; | 107 | + if (mid_len) { |
57 | + b->max = 1; | 108 | + mid_iov = qiov_slice(mid_qiov, mid_offset, mid_len, |
58 | + b->burst_length = 1; | 109 | + &mid_head, &mid_tail, &mid_niov); |
59 | + g_assert(throttle_is_valid(&cfg, NULL)); | 110 | + } |
60 | + | 111 | + |
61 | + b->avg = 1; | 112 | + total_niov = !!head_len + mid_niov + !!tail_len; |
62 | + b->max = 1; | 113 | + if (total_niov == 1) { |
63 | + b->burst_length = THROTTLE_VALUE_MAX; | 114 | + qemu_iovec_init_buf(qiov, NULL, 0); |
64 | + g_assert(throttle_is_valid(&cfg, NULL)); | 115 | + p = &qiov->local_iov; |
116 | + } else { | ||
117 | + qiov->niov = qiov->nalloc = total_niov; | ||
118 | + qiov->size = head_len + mid_len + tail_len; | ||
119 | + p = qiov->iov = g_new(struct iovec, qiov->niov); | ||
120 | + } | ||
65 | + | 121 | + |
66 | + b->avg = 1; | 122 | + if (head_len) { |
67 | + b->max = 1; | 123 | + p->iov_base = head_buf; |
68 | + b->burst_length = THROTTLE_VALUE_MAX + 1; | 124 | + p->iov_len = head_len; |
69 | + g_assert(!throttle_is_valid(&cfg, NULL)); | 125 | + p++; |
126 | + } | ||
70 | + | 127 | + |
71 | + /* burst_length * max cannot exceed THROTTLE_VALUE_MAX */ | 128 | + if (mid_len) { |
72 | + b->avg = 1; | 129 | + memcpy(p, mid_iov, mid_niov * sizeof(*p)); |
73 | + b->max = 2; | 130 | + p[0].iov_base = (uint8_t *)p[0].iov_base + mid_head; |
74 | + b->burst_length = THROTTLE_VALUE_MAX / 2; | 131 | + p[0].iov_len -= mid_head; |
75 | + g_assert(throttle_is_valid(&cfg, NULL)); | 132 | + p[mid_niov - 1].iov_len -= mid_tail; |
133 | + p += mid_niov; | ||
134 | + } | ||
76 | + | 135 | + |
77 | + b->avg = 1; | 136 | + if (tail_len) { |
78 | + b->max = 3; | 137 | + p->iov_base = tail_buf; |
79 | + b->burst_length = THROTTLE_VALUE_MAX / 2; | 138 | + p->iov_len = tail_len; |
80 | + g_assert(!throttle_is_valid(&cfg, NULL)); | ||
81 | + | ||
82 | + b->avg = 1; | ||
83 | + b->max = THROTTLE_VALUE_MAX; | ||
84 | + b->burst_length = 1; | ||
85 | + g_assert(throttle_is_valid(&cfg, NULL)); | ||
86 | + | ||
87 | + b->avg = 1; | ||
88 | + b->max = THROTTLE_VALUE_MAX; | ||
89 | + b->burst_length = 2; | ||
90 | + g_assert(!throttle_is_valid(&cfg, NULL)); | ||
91 | + } | 139 | + } |
92 | +} | 140 | +} |
93 | + | 141 | + |
94 | static void test_max_is_missing_limit(void) | 142 | /* |
143 | * Check if the contents of the iovecs are all zero | ||
144 | */ | ||
145 | @@ -XXX,XX +XXX,XX @@ bool qemu_iovec_is_zero(QEMUIOVector *qiov) | ||
146 | return true; | ||
147 | } | ||
148 | |||
149 | +void qemu_iovec_init_slice(QEMUIOVector *qiov, QEMUIOVector *source, | ||
150 | + size_t offset, size_t len) | ||
151 | +{ | ||
152 | + qemu_iovec_init_extended(qiov, NULL, 0, source, offset, len, NULL, 0); | ||
153 | +} | ||
154 | + | ||
155 | void qemu_iovec_destroy(QEMUIOVector *qiov) | ||
95 | { | 156 | { |
96 | int i; | 157 | - assert(qiov->nalloc != -1); |
97 | @@ -XXX,XX +XXX,XX @@ int main(int argc, char **argv) | 158 | + if (qiov->nalloc != -1) { |
98 | g_test_add_func("/throttle/config/enabled", test_enabled); | 159 | + g_free(qiov->iov); |
99 | g_test_add_func("/throttle/config/conflicting", test_conflicting_config); | 160 | + } |
100 | g_test_add_func("/throttle/config/is_valid", test_is_valid); | 161 | |
101 | + g_test_add_func("/throttle/config/ranges", test_ranges); | 162 | - qemu_iovec_reset(qiov); |
102 | g_test_add_func("/throttle/config/max", test_max_is_missing_limit); | 163 | - g_free(qiov->iov); |
103 | g_test_add_func("/throttle/config/iops_size", | 164 | - qiov->nalloc = 0; |
104 | test_iops_size_is_missing_limit); | 165 | - qiov->iov = NULL; |
166 | + memset(qiov, 0, sizeof(*qiov)); | ||
167 | } | ||
168 | |||
169 | void qemu_iovec_reset(QEMUIOVector *qiov) | ||
105 | -- | 170 | -- |
106 | 2.13.5 | 171 | 2.21.0 |
107 | 172 | ||
108 | 173 | diff view generated by jsdifflib |
1 | From: Fred Rolland <rollandf@gmail.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | Update doc with the usage of UUID for initiator name. | 3 | We'll need to check a part of qiov soon, so implement it now. |
4 | 4 | ||
5 | Related-To: https://bugzilla.redhat.com/1006468 | 5 | Optimization with align down to 4 * sizeof(long) is dropped due to: |
6 | Signed-off-by: Fred Rolland <frolland@redhat.com> | 6 | 1. It is strange: it aligns length of the buffer, but where is a |
7 | Message-id: 20170823084830.30500-1-frolland@redhat.com | 7 | guarantee that buffer pointer is aligned itself? |
8 | 2. buffer_is_zero() is a better place for optimizations and it has | ||
9 | them. | ||
10 | |||
11 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> | ||
12 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
13 | Message-id: 20190604161514.262241-3-vsementsov@virtuozzo.com | ||
14 | Message-Id: <20190604161514.262241-3-vsementsov@virtuozzo.com> | ||
8 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 15 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
9 | --- | 16 | --- |
10 | qemu-doc.texi | 5 +++-- | 17 | include/qemu/iov.h | 2 +- |
11 | 1 file changed, 3 insertions(+), 2 deletions(-) | 18 | block/io.c | 2 +- |
19 | util/iov.c | 31 +++++++++++++++++++------------ | ||
20 | 3 files changed, 21 insertions(+), 14 deletions(-) | ||
12 | 21 | ||
13 | diff --git a/qemu-doc.texi b/qemu-doc.texi | 22 | diff --git a/include/qemu/iov.h b/include/qemu/iov.h |
14 | index XXXXXXX..XXXXXXX 100644 | 23 | index XXXXXXX..XXXXXXX 100644 |
15 | --- a/qemu-doc.texi | 24 | --- a/include/qemu/iov.h |
16 | +++ b/qemu-doc.texi | 25 | +++ b/include/qemu/iov.h |
17 | @@ -XXX,XX +XXX,XX @@ in a configuration file provided via '-readconfig' or directly on the | 26 | @@ -XXX,XX +XXX,XX @@ void qemu_iovec_concat(QEMUIOVector *dst, |
18 | command line. | 27 | size_t qemu_iovec_concat_iov(QEMUIOVector *dst, |
19 | 28 | struct iovec *src_iov, unsigned int src_cnt, | |
20 | If the initiator-name is not specified qemu will use a default name | 29 | size_t soffset, size_t sbytes); |
21 | -of 'iqn.2008-11.org.linux-kvm[:<name>'] where <name> is the name of the | 30 | -bool qemu_iovec_is_zero(QEMUIOVector *qiov); |
22 | +of 'iqn.2008-11.org.linux-kvm[:<uuid>'] where <uuid> is the UUID of the | 31 | +bool qemu_iovec_is_zero(QEMUIOVector *qiov, size_t qiov_offeset, size_t bytes); |
23 | +virtual machine. If the UUID is not specified qemu will use | 32 | void qemu_iovec_destroy(QEMUIOVector *qiov); |
24 | +'iqn.2008-11.org.linux-kvm[:<name>'] where <name> is the name of the | 33 | void qemu_iovec_reset(QEMUIOVector *qiov); |
25 | virtual machine. | 34 | size_t qemu_iovec_to_buf(QEMUIOVector *qiov, size_t offset, |
26 | 35 | diff --git a/block/io.c b/block/io.c | |
27 | - | 36 | index XXXXXXX..XXXXXXX 100644 |
28 | @example | 37 | --- a/block/io.c |
29 | Setting a specific initiator name to use when logging in to the target | 38 | +++ b/block/io.c |
30 | -iscsi initiator-name=iqn.qemu.test:my-initiator | 39 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, |
40 | |||
41 | if (!ret && bs->detect_zeroes != BLOCKDEV_DETECT_ZEROES_OPTIONS_OFF && | ||
42 | !(flags & BDRV_REQ_ZERO_WRITE) && drv->bdrv_co_pwrite_zeroes && | ||
43 | - qemu_iovec_is_zero(qiov)) { | ||
44 | + qemu_iovec_is_zero(qiov, 0, qiov->size)) { | ||
45 | flags |= BDRV_REQ_ZERO_WRITE; | ||
46 | if (bs->detect_zeroes == BLOCKDEV_DETECT_ZEROES_OPTIONS_UNMAP) { | ||
47 | flags |= BDRV_REQ_MAY_UNMAP; | ||
48 | diff --git a/util/iov.c b/util/iov.c | ||
49 | index XXXXXXX..XXXXXXX 100644 | ||
50 | --- a/util/iov.c | ||
51 | +++ b/util/iov.c | ||
52 | @@ -XXX,XX +XXX,XX @@ void qemu_iovec_init_extended( | ||
53 | } | ||
54 | |||
55 | /* | ||
56 | - * Check if the contents of the iovecs are all zero | ||
57 | + * Check if the contents of subrange of qiov data is all zeroes. | ||
58 | */ | ||
59 | -bool qemu_iovec_is_zero(QEMUIOVector *qiov) | ||
60 | +bool qemu_iovec_is_zero(QEMUIOVector *qiov, size_t offset, size_t bytes) | ||
61 | { | ||
62 | - int i; | ||
63 | - for (i = 0; i < qiov->niov; i++) { | ||
64 | - size_t offs = QEMU_ALIGN_DOWN(qiov->iov[i].iov_len, 4 * sizeof(long)); | ||
65 | - uint8_t *ptr = qiov->iov[i].iov_base; | ||
66 | - if (offs && !buffer_is_zero(qiov->iov[i].iov_base, offs)) { | ||
67 | + struct iovec *iov; | ||
68 | + size_t current_offset; | ||
69 | + | ||
70 | + assert(offset + bytes <= qiov->size); | ||
71 | + | ||
72 | + iov = iov_skip_offset(qiov->iov, offset, ¤t_offset); | ||
73 | + | ||
74 | + while (bytes) { | ||
75 | + uint8_t *base = (uint8_t *)iov->iov_base + current_offset; | ||
76 | + size_t len = MIN(iov->iov_len - current_offset, bytes); | ||
77 | + | ||
78 | + if (!buffer_is_zero(base, len)) { | ||
79 | return false; | ||
80 | } | ||
81 | - for (; offs < qiov->iov[i].iov_len; offs++) { | ||
82 | - if (ptr[offs]) { | ||
83 | - return false; | ||
84 | - } | ||
85 | - } | ||
86 | + | ||
87 | + current_offset = 0; | ||
88 | + bytes -= len; | ||
89 | + iov++; | ||
90 | } | ||
91 | + | ||
92 | return true; | ||
93 | } | ||
94 | |||
31 | -- | 95 | -- |
32 | 2.13.5 | 96 | 2.21.0 |
33 | 97 | ||
34 | 98 | diff view generated by jsdifflib |
1 | From: Alberto Garcia <berto@igalia.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | The throttling code can change internally the value of bkt->max if it | 3 | We have similar padding code in bdrv_co_pwritev, |
4 | hasn't been set by the user. The problem with this is that if we want | 4 | bdrv_co_do_pwrite_zeroes and bdrv_co_preadv. Let's combine and unify |
5 | to retrieve the original value we have to undo this change first. This | 5 | it. |
6 | is ugly and unnecessary: this patch removes the throttle_fix_bucket() | 6 | |
7 | and throttle_unfix_bucket() functions completely and moves the logic | 7 | [Squashed in Vladimir's qemu-iotests 077 fix |
8 | to throttle_compute_wait(). | 8 | --Stefan] |
9 | 9 | ||
10 | Signed-off-by: Alberto Garcia <berto@igalia.com> | 10 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
11 | Reviewed-by: Manos Pitsidianakis <el13635@mail.ntua.gr> | 11 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> |
12 | Message-id: 5b0b9e1ac6eb208d709eddc7b09e7669a523bff3.1503580370.git.berto@igalia.com | 12 | Message-id: 20190604161514.262241-4-vsementsov@virtuozzo.com |
13 | Message-Id: <20190604161514.262241-4-vsementsov@virtuozzo.com> | ||
13 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 14 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
14 | --- | 15 | --- |
15 | util/throttle.c | 62 +++++++++++++++++++++------------------------------------ | 16 | block/io.c | 365 +++++++++++++++++++++++++++++------------------------ |
16 | 1 file changed, 23 insertions(+), 39 deletions(-) | 17 | 1 file changed, 200 insertions(+), 165 deletions(-) |
17 | 18 | ||
18 | diff --git a/util/throttle.c b/util/throttle.c | 19 | diff --git a/block/io.c b/block/io.c |
19 | index XXXXXXX..XXXXXXX 100644 | 20 | index XXXXXXX..XXXXXXX 100644 |
20 | --- a/util/throttle.c | 21 | --- a/block/io.c |
21 | +++ b/util/throttle.c | 22 | +++ b/block/io.c |
22 | @@ -XXX,XX +XXX,XX @@ static int64_t throttle_do_compute_wait(double limit, double extra) | 23 | @@ -XXX,XX +XXX,XX @@ out: |
23 | int64_t throttle_compute_wait(LeakyBucket *bkt) | 24 | } |
25 | |||
26 | /* | ||
27 | - * Handle a read request in coroutine context | ||
28 | + * Request padding | ||
29 | + * | ||
30 | + * |<---- align ----->| |<----- align ---->| | ||
31 | + * |<- head ->|<------------- bytes ------------->|<-- tail -->| | ||
32 | + * | | | | | | | ||
33 | + * -*----------$-------*-------- ... --------*-----$------------*--- | ||
34 | + * | | | | | | | ||
35 | + * | offset | | end | | ||
36 | + * ALIGN_DOWN(offset) ALIGN_UP(offset) ALIGN_DOWN(end) ALIGN_UP(end) | ||
37 | + * [buf ... ) [tail_buf ) | ||
38 | + * | ||
39 | + * @buf is an aligned allocation needed to store @head and @tail paddings. @head | ||
40 | + * is placed at the beginning of @buf and @tail at the @end. | ||
41 | + * | ||
42 | + * @tail_buf is a pointer to sub-buffer, corresponding to align-sized chunk | ||
43 | + * around tail, if tail exists. | ||
44 | + * | ||
45 | + * @merge_reads is true for small requests, | ||
46 | + * if @buf_len == @head + bytes + @tail. In this case it is possible that both | ||
47 | + * head and tail exist but @buf_len == align and @tail_buf == @buf. | ||
48 | */ | ||
49 | +typedef struct BdrvRequestPadding { | ||
50 | + uint8_t *buf; | ||
51 | + size_t buf_len; | ||
52 | + uint8_t *tail_buf; | ||
53 | + size_t head; | ||
54 | + size_t tail; | ||
55 | + bool merge_reads; | ||
56 | + QEMUIOVector local_qiov; | ||
57 | +} BdrvRequestPadding; | ||
58 | + | ||
59 | +static bool bdrv_init_padding(BlockDriverState *bs, | ||
60 | + int64_t offset, int64_t bytes, | ||
61 | + BdrvRequestPadding *pad) | ||
62 | +{ | ||
63 | + uint64_t align = bs->bl.request_alignment; | ||
64 | + size_t sum; | ||
65 | + | ||
66 | + memset(pad, 0, sizeof(*pad)); | ||
67 | + | ||
68 | + pad->head = offset & (align - 1); | ||
69 | + pad->tail = ((offset + bytes) & (align - 1)); | ||
70 | + if (pad->tail) { | ||
71 | + pad->tail = align - pad->tail; | ||
72 | + } | ||
73 | + | ||
74 | + if ((!pad->head && !pad->tail) || !bytes) { | ||
75 | + return false; | ||
76 | + } | ||
77 | + | ||
78 | + sum = pad->head + bytes + pad->tail; | ||
79 | + pad->buf_len = (sum > align && pad->head && pad->tail) ? 2 * align : align; | ||
80 | + pad->buf = qemu_blockalign(bs, pad->buf_len); | ||
81 | + pad->merge_reads = sum == pad->buf_len; | ||
82 | + if (pad->tail) { | ||
83 | + pad->tail_buf = pad->buf + pad->buf_len - align; | ||
84 | + } | ||
85 | + | ||
86 | + return true; | ||
87 | +} | ||
88 | + | ||
89 | +static int bdrv_padding_rmw_read(BdrvChild *child, | ||
90 | + BdrvTrackedRequest *req, | ||
91 | + BdrvRequestPadding *pad, | ||
92 | + bool zero_middle) | ||
93 | +{ | ||
94 | + QEMUIOVector local_qiov; | ||
95 | + BlockDriverState *bs = child->bs; | ||
96 | + uint64_t align = bs->bl.request_alignment; | ||
97 | + int ret; | ||
98 | + | ||
99 | + assert(req->serialising && pad->buf); | ||
100 | + | ||
101 | + if (pad->head || pad->merge_reads) { | ||
102 | + uint64_t bytes = pad->merge_reads ? pad->buf_len : align; | ||
103 | + | ||
104 | + qemu_iovec_init_buf(&local_qiov, pad->buf, bytes); | ||
105 | + | ||
106 | + if (pad->head) { | ||
107 | + bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_HEAD); | ||
108 | + } | ||
109 | + if (pad->merge_reads && pad->tail) { | ||
110 | + bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_TAIL); | ||
111 | + } | ||
112 | + ret = bdrv_aligned_preadv(child, req, req->overlap_offset, bytes, | ||
113 | + align, &local_qiov, 0); | ||
114 | + if (ret < 0) { | ||
115 | + return ret; | ||
116 | + } | ||
117 | + if (pad->head) { | ||
118 | + bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_HEAD); | ||
119 | + } | ||
120 | + if (pad->merge_reads && pad->tail) { | ||
121 | + bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_TAIL); | ||
122 | + } | ||
123 | + | ||
124 | + if (pad->merge_reads) { | ||
125 | + goto zero_mem; | ||
126 | + } | ||
127 | + } | ||
128 | + | ||
129 | + if (pad->tail) { | ||
130 | + qemu_iovec_init_buf(&local_qiov, pad->tail_buf, align); | ||
131 | + | ||
132 | + bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_TAIL); | ||
133 | + ret = bdrv_aligned_preadv( | ||
134 | + child, req, | ||
135 | + req->overlap_offset + req->overlap_bytes - align, | ||
136 | + align, align, &local_qiov, 0); | ||
137 | + if (ret < 0) { | ||
138 | + return ret; | ||
139 | + } | ||
140 | + bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_TAIL); | ||
141 | + } | ||
142 | + | ||
143 | +zero_mem: | ||
144 | + if (zero_middle) { | ||
145 | + memset(pad->buf + pad->head, 0, pad->buf_len - pad->head - pad->tail); | ||
146 | + } | ||
147 | + | ||
148 | + return 0; | ||
149 | +} | ||
150 | + | ||
151 | +static void bdrv_padding_destroy(BdrvRequestPadding *pad) | ||
152 | +{ | ||
153 | + if (pad->buf) { | ||
154 | + qemu_vfree(pad->buf); | ||
155 | + qemu_iovec_destroy(&pad->local_qiov); | ||
156 | + } | ||
157 | +} | ||
158 | + | ||
159 | +/* | ||
160 | + * bdrv_pad_request | ||
161 | + * | ||
162 | + * Exchange request parameters with padded request if needed. Don't include RMW | ||
163 | + * read of padding, bdrv_padding_rmw_read() should be called separately if | ||
164 | + * needed. | ||
165 | + * | ||
166 | + * All parameters except @bs are in-out: they represent original request at | ||
167 | + * function call and padded (if padding needed) at function finish. | ||
168 | + * | ||
169 | + * Function always succeeds. | ||
170 | + */ | ||
171 | +static bool bdrv_pad_request(BlockDriverState *bs, QEMUIOVector **qiov, | ||
172 | + int64_t *offset, unsigned int *bytes, | ||
173 | + BdrvRequestPadding *pad) | ||
174 | +{ | ||
175 | + if (!bdrv_init_padding(bs, *offset, *bytes, pad)) { | ||
176 | + return false; | ||
177 | + } | ||
178 | + | ||
179 | + qemu_iovec_init_extended(&pad->local_qiov, pad->buf, pad->head, | ||
180 | + *qiov, 0, *bytes, | ||
181 | + pad->buf + pad->buf_len - pad->tail, pad->tail); | ||
182 | + *bytes += pad->head + pad->tail; | ||
183 | + *offset -= pad->head; | ||
184 | + *qiov = &pad->local_qiov; | ||
185 | + | ||
186 | + return true; | ||
187 | +} | ||
188 | + | ||
189 | int coroutine_fn bdrv_co_preadv(BdrvChild *child, | ||
190 | int64_t offset, unsigned int bytes, QEMUIOVector *qiov, | ||
191 | BdrvRequestFlags flags) | ||
24 | { | 192 | { |
25 | double extra; /* the number of extra units blocking the io */ | 193 | BlockDriverState *bs = child->bs; |
26 | + double bucket_size; /* I/O before throttling to bkt->avg */ | 194 | - BlockDriver *drv = bs->drv; |
27 | + double burst_bucket_size; /* Before throttling to bkt->max */ | 195 | BdrvTrackedRequest req; |
28 | 196 | - | |
29 | if (!bkt->avg) { | 197 | - uint64_t align = bs->bl.request_alignment; |
30 | return 0; | 198 | - uint8_t *head_buf = NULL; |
199 | - uint8_t *tail_buf = NULL; | ||
200 | - QEMUIOVector local_qiov; | ||
201 | - bool use_local_qiov = false; | ||
202 | + BdrvRequestPadding pad; | ||
203 | int ret; | ||
204 | |||
205 | - trace_bdrv_co_preadv(child->bs, offset, bytes, flags); | ||
206 | - | ||
207 | - if (!drv) { | ||
208 | - return -ENOMEDIUM; | ||
209 | - } | ||
210 | + trace_bdrv_co_preadv(bs, offset, bytes, flags); | ||
211 | |||
212 | ret = bdrv_check_byte_request(bs, offset, bytes); | ||
213 | if (ret < 0) { | ||
214 | @@ -XXX,XX +XXX,XX @@ int coroutine_fn bdrv_co_preadv(BdrvChild *child, | ||
215 | flags |= BDRV_REQ_COPY_ON_READ; | ||
31 | } | 216 | } |
32 | 217 | ||
33 | - /* If the bucket is full then we have to wait */ | 218 | - /* Align read if necessary by padding qiov */ |
34 | - extra = bkt->level - bkt->max * bkt->burst_length; | 219 | - if (offset & (align - 1)) { |
35 | + if (!bkt->max) { | 220 | - head_buf = qemu_blockalign(bs, align); |
36 | + /* If bkt->max is 0 we still want to allow short bursts of I/O | 221 | - qemu_iovec_init(&local_qiov, qiov->niov + 2); |
37 | + * from the guest, otherwise every other request will be throttled | 222 | - qemu_iovec_add(&local_qiov, head_buf, offset & (align - 1)); |
38 | + * and performance will suffer considerably. */ | 223 | - qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size); |
39 | + bucket_size = bkt->avg / 10; | 224 | - use_local_qiov = true; |
40 | + burst_bucket_size = 0; | 225 | - |
41 | + } else { | 226 | - bytes += offset & (align - 1); |
42 | + /* If we have a burst limit then we have to wait until all I/O | 227 | - offset = offset & ~(align - 1); |
43 | + * at burst rate has finished before throttling to bkt->avg */ | 228 | - } |
44 | + bucket_size = bkt->max * bkt->burst_length; | 229 | - |
45 | + burst_bucket_size = bkt->max / 10; | 230 | - if ((offset + bytes) & (align - 1)) { |
46 | + } | 231 | - if (!use_local_qiov) { |
47 | + | 232 | - qemu_iovec_init(&local_qiov, qiov->niov + 1); |
48 | + /* If the main bucket is full then we have to wait */ | 233 | - qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size); |
49 | + extra = bkt->level - bucket_size; | 234 | - use_local_qiov = true; |
50 | if (extra > 0) { | 235 | - } |
51 | return throttle_do_compute_wait(bkt->avg, extra); | 236 | - tail_buf = qemu_blockalign(bs, align); |
237 | - qemu_iovec_add(&local_qiov, tail_buf, | ||
238 | - align - ((offset + bytes) & (align - 1))); | ||
239 | - | ||
240 | - bytes = ROUND_UP(bytes, align); | ||
241 | - } | ||
242 | + bdrv_pad_request(bs, &qiov, &offset, &bytes, &pad); | ||
243 | |||
244 | tracked_request_begin(&req, bs, offset, bytes, BDRV_TRACKED_READ); | ||
245 | - ret = bdrv_aligned_preadv(child, &req, offset, bytes, align, | ||
246 | - use_local_qiov ? &local_qiov : qiov, | ||
247 | - flags); | ||
248 | + ret = bdrv_aligned_preadv(child, &req, offset, bytes, | ||
249 | + bs->bl.request_alignment, | ||
250 | + qiov, flags); | ||
251 | tracked_request_end(&req); | ||
252 | bdrv_dec_in_flight(bs); | ||
253 | |||
254 | - if (use_local_qiov) { | ||
255 | - qemu_iovec_destroy(&local_qiov); | ||
256 | - qemu_vfree(head_buf); | ||
257 | - qemu_vfree(tail_buf); | ||
258 | - } | ||
259 | + bdrv_padding_destroy(&pad); | ||
260 | |||
261 | return ret; | ||
262 | } | ||
263 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_zero_pwritev(BdrvChild *child, | ||
264 | BdrvTrackedRequest *req) | ||
265 | { | ||
266 | BlockDriverState *bs = child->bs; | ||
267 | - uint8_t *buf = NULL; | ||
268 | QEMUIOVector local_qiov; | ||
269 | uint64_t align = bs->bl.request_alignment; | ||
270 | - unsigned int head_padding_bytes, tail_padding_bytes; | ||
271 | int ret = 0; | ||
272 | + bool padding; | ||
273 | + BdrvRequestPadding pad; | ||
274 | |||
275 | - head_padding_bytes = offset & (align - 1); | ||
276 | - tail_padding_bytes = (align - (offset + bytes)) & (align - 1); | ||
277 | - | ||
278 | - | ||
279 | - assert(flags & BDRV_REQ_ZERO_WRITE); | ||
280 | - if (head_padding_bytes || tail_padding_bytes) { | ||
281 | - buf = qemu_blockalign(bs, align); | ||
282 | - qemu_iovec_init_buf(&local_qiov, buf, align); | ||
283 | - } | ||
284 | - if (head_padding_bytes) { | ||
285 | - uint64_t zero_bytes = MIN(bytes, align - head_padding_bytes); | ||
286 | - | ||
287 | - /* RMW the unaligned part before head. */ | ||
288 | + padding = bdrv_init_padding(bs, offset, bytes, &pad); | ||
289 | + if (padding) { | ||
290 | mark_request_serialising(req, align); | ||
291 | wait_serialising_requests(req); | ||
292 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_HEAD); | ||
293 | - ret = bdrv_aligned_preadv(child, req, offset & ~(align - 1), align, | ||
294 | - align, &local_qiov, 0); | ||
295 | - if (ret < 0) { | ||
296 | - goto fail; | ||
297 | - } | ||
298 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_HEAD); | ||
299 | |||
300 | - memset(buf + head_padding_bytes, 0, zero_bytes); | ||
301 | - ret = bdrv_aligned_pwritev(child, req, offset & ~(align - 1), align, | ||
302 | - align, &local_qiov, | ||
303 | - flags & ~BDRV_REQ_ZERO_WRITE); | ||
304 | - if (ret < 0) { | ||
305 | - goto fail; | ||
306 | + bdrv_padding_rmw_read(child, req, &pad, true); | ||
307 | + | ||
308 | + if (pad.head || pad.merge_reads) { | ||
309 | + int64_t aligned_offset = offset & ~(align - 1); | ||
310 | + int64_t write_bytes = pad.merge_reads ? pad.buf_len : align; | ||
311 | + | ||
312 | + qemu_iovec_init_buf(&local_qiov, pad.buf, write_bytes); | ||
313 | + ret = bdrv_aligned_pwritev(child, req, aligned_offset, write_bytes, | ||
314 | + align, &local_qiov, | ||
315 | + flags & ~BDRV_REQ_ZERO_WRITE); | ||
316 | + if (ret < 0 || pad.merge_reads) { | ||
317 | + /* Error or all work is done */ | ||
318 | + goto out; | ||
319 | + } | ||
320 | + offset += write_bytes - pad.head; | ||
321 | + bytes -= write_bytes - pad.head; | ||
322 | } | ||
323 | - offset += zero_bytes; | ||
324 | - bytes -= zero_bytes; | ||
52 | } | 325 | } |
53 | 326 | ||
54 | - /* If the bucket is not full yet we have to make sure that we | 327 | assert(!bytes || (offset & (align - 1)) == 0); |
55 | - * fulfill the goal of bkt->max units per second. */ | 328 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_zero_pwritev(BdrvChild *child, |
56 | + /* If the main bucket is not full yet we still have to check the | 329 | ret = bdrv_aligned_pwritev(child, req, offset, aligned_bytes, align, |
57 | + * burst bucket in order to enforce the burst limit */ | 330 | NULL, flags); |
58 | if (bkt->burst_length > 1) { | 331 | if (ret < 0) { |
59 | - /* We use 1/10 of the max value to smooth the throttling. | 332 | - goto fail; |
60 | - * See throttle_fix_bucket() for more details. */ | 333 | + goto out; |
61 | - extra = bkt->burst_level - bkt->max / 10; | ||
62 | + extra = bkt->burst_level - burst_bucket_size; | ||
63 | if (extra > 0) { | ||
64 | return throttle_do_compute_wait(bkt->max, extra); | ||
65 | } | 334 | } |
66 | @@ -XXX,XX +XXX,XX @@ bool throttle_is_valid(ThrottleConfig *cfg, Error **errp) | 335 | bytes -= aligned_bytes; |
67 | return true; | 336 | offset += aligned_bytes; |
337 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_zero_pwritev(BdrvChild *child, | ||
338 | |||
339 | assert(!bytes || (offset & (align - 1)) == 0); | ||
340 | if (bytes) { | ||
341 | - assert(align == tail_padding_bytes + bytes); | ||
342 | - /* RMW the unaligned part after tail. */ | ||
343 | - mark_request_serialising(req, align); | ||
344 | - wait_serialising_requests(req); | ||
345 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_TAIL); | ||
346 | - ret = bdrv_aligned_preadv(child, req, offset, align, | ||
347 | - align, &local_qiov, 0); | ||
348 | - if (ret < 0) { | ||
349 | - goto fail; | ||
350 | - } | ||
351 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_TAIL); | ||
352 | + assert(align == pad.tail + bytes); | ||
353 | |||
354 | - memset(buf, 0, bytes); | ||
355 | + qemu_iovec_init_buf(&local_qiov, pad.tail_buf, align); | ||
356 | ret = bdrv_aligned_pwritev(child, req, offset, align, align, | ||
357 | &local_qiov, flags & ~BDRV_REQ_ZERO_WRITE); | ||
358 | } | ||
359 | -fail: | ||
360 | - qemu_vfree(buf); | ||
361 | + | ||
362 | +out: | ||
363 | + bdrv_padding_destroy(&pad); | ||
364 | + | ||
365 | return ret; | ||
366 | - | ||
68 | } | 367 | } |
69 | 368 | ||
70 | -/* fix bucket parameters */ | 369 | /* |
71 | -static void throttle_fix_bucket(LeakyBucket *bkt) | 370 | @@ -XXX,XX +XXX,XX @@ int coroutine_fn bdrv_co_pwritev(BdrvChild *child, |
72 | -{ | 371 | BlockDriverState *bs = child->bs; |
73 | - double min; | 372 | BdrvTrackedRequest req; |
74 | - | 373 | uint64_t align = bs->bl.request_alignment; |
75 | - /* zero bucket level */ | 374 | - uint8_t *head_buf = NULL; |
76 | - bkt->level = bkt->burst_level = 0; | 375 | - uint8_t *tail_buf = NULL; |
77 | - | 376 | - QEMUIOVector local_qiov; |
78 | - /* If bkt->max is 0 we still want to allow short bursts of I/O | 377 | - bool use_local_qiov = false; |
79 | - * from the guest, otherwise every other request will be throttled | 378 | + BdrvRequestPadding pad; |
80 | - * and performance will suffer considerably. */ | 379 | int ret; |
81 | - min = bkt->avg / 10; | 380 | |
82 | - if (bkt->avg && !bkt->max) { | 381 | trace_bdrv_co_pwritev(child->bs, offset, bytes, flags); |
83 | - bkt->max = min; | 382 | @@ -XXX,XX +XXX,XX @@ int coroutine_fn bdrv_co_pwritev(BdrvChild *child, |
84 | - } | 383 | goto out; |
85 | -} | ||
86 | - | ||
87 | -/* undo internal bucket parameter changes (see throttle_fix_bucket()) */ | ||
88 | -static void throttle_unfix_bucket(LeakyBucket *bkt) | ||
89 | -{ | ||
90 | - if (bkt->max < bkt->avg) { | ||
91 | - bkt->max = 0; | ||
92 | - } | ||
93 | -} | ||
94 | - | ||
95 | /* Used to configure the throttle | ||
96 | * | ||
97 | * @ts: the throttle state we are working on | ||
98 | @@ -XXX,XX +XXX,XX @@ void throttle_config(ThrottleState *ts, | ||
99 | |||
100 | ts->cfg = *cfg; | ||
101 | |||
102 | + /* Zero bucket level */ | ||
103 | for (i = 0; i < BUCKETS_COUNT; i++) { | ||
104 | - throttle_fix_bucket(&ts->cfg.buckets[i]); | ||
105 | + ts->cfg.buckets[i].level = 0; | ||
106 | + ts->cfg.buckets[i].burst_level = 0; | ||
107 | } | 384 | } |
108 | 385 | ||
109 | ts->previous_leak = qemu_clock_get_ns(clock_type); | 386 | - if (offset & (align - 1)) { |
110 | @@ -XXX,XX +XXX,XX @@ void throttle_config(ThrottleState *ts, | 387 | - QEMUIOVector head_qiov; |
111 | */ | 388 | - |
112 | void throttle_get_config(ThrottleState *ts, ThrottleConfig *cfg) | 389 | + if (bdrv_pad_request(bs, &qiov, &offset, &bytes, &pad)) { |
113 | { | 390 | mark_request_serialising(&req, align); |
114 | - int i; | 391 | wait_serialising_requests(&req); |
115 | - | 392 | - |
116 | *cfg = ts->cfg; | 393 | - head_buf = qemu_blockalign(bs, align); |
117 | - | 394 | - qemu_iovec_init_buf(&head_qiov, head_buf, align); |
118 | - for (i = 0; i < BUCKETS_COUNT; i++) { | 395 | - |
119 | - throttle_unfix_bucket(&cfg->buckets[i]); | 396 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_HEAD); |
120 | - } | 397 | - ret = bdrv_aligned_preadv(child, &req, offset & ~(align - 1), align, |
398 | - align, &head_qiov, 0); | ||
399 | - if (ret < 0) { | ||
400 | - goto fail; | ||
401 | - } | ||
402 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_HEAD); | ||
403 | - | ||
404 | - qemu_iovec_init(&local_qiov, qiov->niov + 2); | ||
405 | - qemu_iovec_add(&local_qiov, head_buf, offset & (align - 1)); | ||
406 | - qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size); | ||
407 | - use_local_qiov = true; | ||
408 | - | ||
409 | - bytes += offset & (align - 1); | ||
410 | - offset = offset & ~(align - 1); | ||
411 | - | ||
412 | - /* We have read the tail already if the request is smaller | ||
413 | - * than one aligned block. | ||
414 | - */ | ||
415 | - if (bytes < align) { | ||
416 | - qemu_iovec_add(&local_qiov, head_buf + bytes, align - bytes); | ||
417 | - bytes = align; | ||
418 | - } | ||
419 | - } | ||
420 | - | ||
421 | - if ((offset + bytes) & (align - 1)) { | ||
422 | - QEMUIOVector tail_qiov; | ||
423 | - size_t tail_bytes; | ||
424 | - bool waited; | ||
425 | - | ||
426 | - mark_request_serialising(&req, align); | ||
427 | - waited = wait_serialising_requests(&req); | ||
428 | - assert(!waited || !use_local_qiov); | ||
429 | - | ||
430 | - tail_buf = qemu_blockalign(bs, align); | ||
431 | - qemu_iovec_init_buf(&tail_qiov, tail_buf, align); | ||
432 | - | ||
433 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_TAIL); | ||
434 | - ret = bdrv_aligned_preadv(child, &req, (offset + bytes) & ~(align - 1), | ||
435 | - align, align, &tail_qiov, 0); | ||
436 | - if (ret < 0) { | ||
437 | - goto fail; | ||
438 | - } | ||
439 | - bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_AFTER_TAIL); | ||
440 | - | ||
441 | - if (!use_local_qiov) { | ||
442 | - qemu_iovec_init(&local_qiov, qiov->niov + 1); | ||
443 | - qemu_iovec_concat(&local_qiov, qiov, 0, qiov->size); | ||
444 | - use_local_qiov = true; | ||
445 | - } | ||
446 | - | ||
447 | - tail_bytes = (offset + bytes) & (align - 1); | ||
448 | - qemu_iovec_add(&local_qiov, tail_buf + tail_bytes, align - tail_bytes); | ||
449 | - | ||
450 | - bytes = ROUND_UP(bytes, align); | ||
451 | + bdrv_padding_rmw_read(child, &req, &pad, false); | ||
452 | } | ||
453 | |||
454 | ret = bdrv_aligned_pwritev(child, &req, offset, bytes, align, | ||
455 | - use_local_qiov ? &local_qiov : qiov, | ||
456 | - flags); | ||
457 | + qiov, flags); | ||
458 | |||
459 | -fail: | ||
460 | + bdrv_padding_destroy(&pad); | ||
461 | |||
462 | - if (use_local_qiov) { | ||
463 | - qemu_iovec_destroy(&local_qiov); | ||
464 | - } | ||
465 | - qemu_vfree(head_buf); | ||
466 | - qemu_vfree(tail_buf); | ||
467 | out: | ||
468 | tracked_request_end(&req); | ||
469 | bdrv_dec_in_flight(bs); | ||
470 | + | ||
471 | return ret; | ||
121 | } | 472 | } |
122 | 473 | ||
123 | |||
124 | -- | 474 | -- |
125 | 2.13.5 | 475 | 2.21.0 |
126 | 476 | ||
127 | 477 | diff view generated by jsdifflib |
1 | Add the scripts/ directory to sys.path so Python 2.6 will be able to | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | import argparse. | 2 | |
3 | 3 | Add handlers supporting qiov_offset parameter: | |
4 | Cc: Daniel P. Berrange <berrange@redhat.com> | 4 | bdrv_co_preadv_part |
5 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 5 | bdrv_co_pwritev_part |
6 | Acked-by: John Snow <jsnow@redhat.com> | 6 | bdrv_co_pwritev_compressed_part |
7 | Acked-by: Fam Zheng <famz@redhat.com> | 7 | This is used to reduce need of defining local_qiovs and hd_qiovs in all |
8 | Message-id: 20170825155732.15665-4-stefanha@redhat.com | 8 | corners of block layer code. The following patches will increase usage |
9 | of this new API part by part. | ||
10 | |||
11 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> | ||
12 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
13 | Message-id: 20190604161514.262241-5-vsementsov@virtuozzo.com | ||
14 | Message-Id: <20190604161514.262241-5-vsementsov@virtuozzo.com> | ||
9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 15 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
10 | --- | 16 | --- |
11 | tests/migration/guestperf/shell.py | 8 +++++--- | 17 | include/block/block_int.h | 15 ++++++ |
12 | 1 file changed, 5 insertions(+), 3 deletions(-) | 18 | block/backup.c | 2 +- |
13 | 19 | block/io.c | 96 +++++++++++++++++++++++++++++++-------- | |
14 | diff --git a/tests/migration/guestperf/shell.py b/tests/migration/guestperf/shell.py | 20 | qemu-img.c | 4 +- |
21 | 4 files changed, 95 insertions(+), 22 deletions(-) | ||
22 | |||
23 | diff --git a/include/block/block_int.h b/include/block/block_int.h | ||
15 | index XXXXXXX..XXXXXXX 100644 | 24 | index XXXXXXX..XXXXXXX 100644 |
16 | --- a/tests/migration/guestperf/shell.py | 25 | --- a/include/block/block_int.h |
17 | +++ b/tests/migration/guestperf/shell.py | 26 | +++ b/include/block/block_int.h |
18 | @@ -XXX,XX +XXX,XX @@ | 27 | @@ -XXX,XX +XXX,XX @@ struct BlockDriver { |
19 | # | 28 | */ |
20 | 29 | int coroutine_fn (*bdrv_co_preadv)(BlockDriverState *bs, | |
21 | 30 | uint64_t offset, uint64_t bytes, QEMUIOVector *qiov, int flags); | |
22 | -import argparse | 31 | + int coroutine_fn (*bdrv_co_preadv_part)(BlockDriverState *bs, |
23 | -import fnmatch | 32 | + uint64_t offset, uint64_t bytes, |
24 | import os | 33 | + QEMUIOVector *qiov, size_t qiov_offset, int flags); |
25 | import os.path | 34 | int coroutine_fn (*bdrv_co_writev)(BlockDriverState *bs, |
26 | -import platform | 35 | int64_t sector_num, int nb_sectors, QEMUIOVector *qiov, int flags); |
27 | import sys | 36 | /** |
28 | +sys.path.append(os.path.join(os.path.dirname(__file__), | 37 | @@ -XXX,XX +XXX,XX @@ struct BlockDriver { |
29 | + '..', '..', '..', 'scripts')) | 38 | */ |
30 | +import argparse | 39 | int coroutine_fn (*bdrv_co_pwritev)(BlockDriverState *bs, |
31 | +import fnmatch | 40 | uint64_t offset, uint64_t bytes, QEMUIOVector *qiov, int flags); |
32 | +import platform | 41 | + int coroutine_fn (*bdrv_co_pwritev_part)(BlockDriverState *bs, |
33 | 42 | + uint64_t offset, uint64_t bytes, | |
34 | from guestperf.hardware import Hardware | 43 | + QEMUIOVector *qiov, size_t qiov_offset, int flags); |
35 | from guestperf.engine import Engine | 44 | |
45 | /* | ||
46 | * Efficiently zero a region of the disk image. Typically an image format | ||
47 | @@ -XXX,XX +XXX,XX @@ struct BlockDriver { | ||
48 | |||
49 | int coroutine_fn (*bdrv_co_pwritev_compressed)(BlockDriverState *bs, | ||
50 | uint64_t offset, uint64_t bytes, QEMUIOVector *qiov); | ||
51 | + int coroutine_fn (*bdrv_co_pwritev_compressed_part)(BlockDriverState *bs, | ||
52 | + uint64_t offset, uint64_t bytes, QEMUIOVector *qiov, | ||
53 | + size_t qiov_offset); | ||
54 | |||
55 | int (*bdrv_snapshot_create)(BlockDriverState *bs, | ||
56 | QEMUSnapshotInfo *sn_info); | ||
57 | @@ -XXX,XX +XXX,XX @@ struct BlockDriver { | ||
58 | const char *const *strong_runtime_opts; | ||
59 | }; | ||
60 | |||
61 | +static inline bool block_driver_can_compress(BlockDriver *drv) | ||
62 | +{ | ||
63 | + return drv->bdrv_co_pwritev_compressed || | ||
64 | + drv->bdrv_co_pwritev_compressed_part; | ||
65 | +} | ||
66 | + | ||
67 | typedef struct BlockLimits { | ||
68 | /* Alignment requirement, in bytes, for offset/length of I/O | ||
69 | * requests. Must be a power of 2 less than INT_MAX; defaults to | ||
70 | diff --git a/block/backup.c b/block/backup.c | ||
71 | index XXXXXXX..XXXXXXX 100644 | ||
72 | --- a/block/backup.c | ||
73 | +++ b/block/backup.c | ||
74 | @@ -XXX,XX +XXX,XX @@ BlockJob *backup_job_create(const char *job_id, BlockDriverState *bs, | ||
75 | return NULL; | ||
76 | } | ||
77 | |||
78 | - if (compress && target->drv->bdrv_co_pwritev_compressed == NULL) { | ||
79 | + if (compress && !block_driver_can_compress(target->drv)) { | ||
80 | error_setg(errp, "Compression is not supported for this drive %s", | ||
81 | bdrv_get_device_name(target)); | ||
82 | return NULL; | ||
83 | diff --git a/block/io.c b/block/io.c | ||
84 | index XXXXXXX..XXXXXXX 100644 | ||
85 | --- a/block/io.c | ||
86 | +++ b/block/io.c | ||
87 | @@ -XXX,XX +XXX,XX @@ void bdrv_refresh_limits(BlockDriverState *bs, Error **errp) | ||
88 | |||
89 | /* Default alignment based on whether driver has byte interface */ | ||
90 | bs->bl.request_alignment = (drv->bdrv_co_preadv || | ||
91 | - drv->bdrv_aio_preadv) ? 1 : 512; | ||
92 | + drv->bdrv_aio_preadv || | ||
93 | + drv->bdrv_co_preadv_part) ? 1 : 512; | ||
94 | |||
95 | /* Take some limits from the children as a default */ | ||
96 | if (bs->file) { | ||
97 | @@ -XXX,XX +XXX,XX @@ static void bdrv_co_io_em_complete(void *opaque, int ret) | ||
98 | |||
99 | static int coroutine_fn bdrv_driver_preadv(BlockDriverState *bs, | ||
100 | uint64_t offset, uint64_t bytes, | ||
101 | - QEMUIOVector *qiov, int flags) | ||
102 | + QEMUIOVector *qiov, | ||
103 | + size_t qiov_offset, int flags) | ||
104 | { | ||
105 | BlockDriver *drv = bs->drv; | ||
106 | int64_t sector_num; | ||
107 | unsigned int nb_sectors; | ||
108 | + QEMUIOVector local_qiov; | ||
109 | + int ret; | ||
110 | |||
111 | assert(!(flags & ~BDRV_REQ_MASK)); | ||
112 | assert(!(flags & BDRV_REQ_NO_FALLBACK)); | ||
113 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_driver_preadv(BlockDriverState *bs, | ||
114 | return -ENOMEDIUM; | ||
115 | } | ||
116 | |||
117 | + if (drv->bdrv_co_preadv_part) { | ||
118 | + return drv->bdrv_co_preadv_part(bs, offset, bytes, qiov, qiov_offset, | ||
119 | + flags); | ||
120 | + } | ||
121 | + | ||
122 | + if (qiov_offset > 0 || bytes != qiov->size) { | ||
123 | + qemu_iovec_init_slice(&local_qiov, qiov, qiov_offset, bytes); | ||
124 | + qiov = &local_qiov; | ||
125 | + } | ||
126 | + | ||
127 | if (drv->bdrv_co_preadv) { | ||
128 | - return drv->bdrv_co_preadv(bs, offset, bytes, qiov, flags); | ||
129 | + ret = drv->bdrv_co_preadv(bs, offset, bytes, qiov, flags); | ||
130 | + goto out; | ||
131 | } | ||
132 | |||
133 | if (drv->bdrv_aio_preadv) { | ||
134 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_driver_preadv(BlockDriverState *bs, | ||
135 | acb = drv->bdrv_aio_preadv(bs, offset, bytes, qiov, flags, | ||
136 | bdrv_co_io_em_complete, &co); | ||
137 | if (acb == NULL) { | ||
138 | - return -EIO; | ||
139 | + ret = -EIO; | ||
140 | + goto out; | ||
141 | } else { | ||
142 | qemu_coroutine_yield(); | ||
143 | - return co.ret; | ||
144 | + ret = co.ret; | ||
145 | + goto out; | ||
146 | } | ||
147 | } | ||
148 | |||
149 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_driver_preadv(BlockDriverState *bs, | ||
150 | assert(bytes <= BDRV_REQUEST_MAX_BYTES); | ||
151 | assert(drv->bdrv_co_readv); | ||
152 | |||
153 | - return drv->bdrv_co_readv(bs, sector_num, nb_sectors, qiov); | ||
154 | + ret = drv->bdrv_co_readv(bs, sector_num, nb_sectors, qiov); | ||
155 | + | ||
156 | +out: | ||
157 | + if (qiov == &local_qiov) { | ||
158 | + qemu_iovec_destroy(&local_qiov); | ||
159 | + } | ||
160 | + | ||
161 | + return ret; | ||
162 | } | ||
163 | |||
164 | static int coroutine_fn bdrv_driver_pwritev(BlockDriverState *bs, | ||
165 | uint64_t offset, uint64_t bytes, | ||
166 | - QEMUIOVector *qiov, int flags) | ||
167 | + QEMUIOVector *qiov, | ||
168 | + size_t qiov_offset, int flags) | ||
169 | { | ||
170 | BlockDriver *drv = bs->drv; | ||
171 | int64_t sector_num; | ||
172 | unsigned int nb_sectors; | ||
173 | + QEMUIOVector local_qiov; | ||
174 | int ret; | ||
175 | |||
176 | assert(!(flags & ~BDRV_REQ_MASK)); | ||
177 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_driver_pwritev(BlockDriverState *bs, | ||
178 | return -ENOMEDIUM; | ||
179 | } | ||
180 | |||
181 | + if (drv->bdrv_co_pwritev_part) { | ||
182 | + ret = drv->bdrv_co_pwritev_part(bs, offset, bytes, qiov, qiov_offset, | ||
183 | + flags & bs->supported_write_flags); | ||
184 | + flags &= ~bs->supported_write_flags; | ||
185 | + goto emulate_flags; | ||
186 | + } | ||
187 | + | ||
188 | + if (qiov_offset > 0 || bytes != qiov->size) { | ||
189 | + qemu_iovec_init_slice(&local_qiov, qiov, qiov_offset, bytes); | ||
190 | + qiov = &local_qiov; | ||
191 | + } | ||
192 | + | ||
193 | if (drv->bdrv_co_pwritev) { | ||
194 | ret = drv->bdrv_co_pwritev(bs, offset, bytes, qiov, | ||
195 | flags & bs->supported_write_flags); | ||
196 | @@ -XXX,XX +XXX,XX @@ emulate_flags: | ||
197 | ret = bdrv_co_flush(bs); | ||
198 | } | ||
199 | |||
200 | + if (qiov == &local_qiov) { | ||
201 | + qemu_iovec_destroy(&local_qiov); | ||
202 | + } | ||
203 | + | ||
204 | return ret; | ||
205 | } | ||
206 | |||
207 | static int coroutine_fn | ||
208 | bdrv_driver_pwritev_compressed(BlockDriverState *bs, uint64_t offset, | ||
209 | - uint64_t bytes, QEMUIOVector *qiov) | ||
210 | + uint64_t bytes, QEMUIOVector *qiov, | ||
211 | + size_t qiov_offset) | ||
212 | { | ||
213 | BlockDriver *drv = bs->drv; | ||
214 | + QEMUIOVector local_qiov; | ||
215 | + int ret; | ||
216 | |||
217 | if (!drv) { | ||
218 | return -ENOMEDIUM; | ||
219 | } | ||
220 | |||
221 | - if (!drv->bdrv_co_pwritev_compressed) { | ||
222 | + if (!block_driver_can_compress(drv)) { | ||
223 | return -ENOTSUP; | ||
224 | } | ||
225 | |||
226 | - return drv->bdrv_co_pwritev_compressed(bs, offset, bytes, qiov); | ||
227 | + if (drv->bdrv_co_pwritev_compressed_part) { | ||
228 | + return drv->bdrv_co_pwritev_compressed_part(bs, offset, bytes, | ||
229 | + qiov, qiov_offset); | ||
230 | + } | ||
231 | + | ||
232 | + if (qiov_offset == 0) { | ||
233 | + return drv->bdrv_co_pwritev_compressed(bs, offset, bytes, qiov); | ||
234 | + } | ||
235 | + | ||
236 | + qemu_iovec_init_slice(&local_qiov, qiov, qiov_offset, bytes); | ||
237 | + ret = drv->bdrv_co_pwritev_compressed(bs, offset, bytes, &local_qiov); | ||
238 | + qemu_iovec_destroy(&local_qiov); | ||
239 | + | ||
240 | + return ret; | ||
241 | } | ||
242 | |||
243 | static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
244 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
245 | qemu_iovec_init_buf(&local_qiov, bounce_buffer, pnum); | ||
246 | |||
247 | ret = bdrv_driver_preadv(bs, cluster_offset, pnum, | ||
248 | - &local_qiov, 0); | ||
249 | + &local_qiov, 0, 0); | ||
250 | if (ret < 0) { | ||
251 | goto err; | ||
252 | } | ||
253 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
254 | * necessary to flush even in cache=writethrough mode. | ||
255 | */ | ||
256 | ret = bdrv_driver_pwritev(bs, cluster_offset, pnum, | ||
257 | - &local_qiov, | ||
258 | + &local_qiov, 0, | ||
259 | BDRV_REQ_WRITE_UNCHANGED); | ||
260 | } | ||
261 | |||
262 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
263 | qemu_iovec_init(&local_qiov, qiov->niov); | ||
264 | qemu_iovec_concat(&local_qiov, qiov, progress, pnum - skip_bytes); | ||
265 | ret = bdrv_driver_preadv(bs, offset + progress, local_qiov.size, | ||
266 | - &local_qiov, 0); | ||
267 | + &local_qiov, 0, 0); | ||
268 | qemu_iovec_destroy(&local_qiov); | ||
269 | if (ret < 0) { | ||
270 | goto err; | ||
271 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, | ||
272 | |||
273 | max_bytes = ROUND_UP(MAX(0, total_bytes - offset), align); | ||
274 | if (bytes <= max_bytes && bytes <= max_transfer) { | ||
275 | - ret = bdrv_driver_preadv(bs, offset, bytes, qiov, 0); | ||
276 | + ret = bdrv_driver_preadv(bs, offset, bytes, qiov, 0, 0); | ||
277 | goto out; | ||
278 | } | ||
279 | |||
280 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, | ||
281 | qemu_iovec_concat(&local_qiov, qiov, bytes - bytes_remaining, num); | ||
282 | |||
283 | ret = bdrv_driver_preadv(bs, offset + bytes - bytes_remaining, | ||
284 | - num, &local_qiov, 0); | ||
285 | + num, &local_qiov, 0, 0); | ||
286 | max_bytes -= num; | ||
287 | qemu_iovec_destroy(&local_qiov); | ||
288 | } else { | ||
289 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_pwrite_zeroes(BlockDriverState *bs, | ||
290 | } | ||
291 | qemu_iovec_init_buf(&qiov, buf, num); | ||
292 | |||
293 | - ret = bdrv_driver_pwritev(bs, offset, num, &qiov, write_flags); | ||
294 | + ret = bdrv_driver_pwritev(bs, offset, num, &qiov, 0, write_flags); | ||
295 | |||
296 | /* Keep bounce buffer around if it is big enough for all | ||
297 | * all future requests. | ||
298 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, | ||
299 | bdrv_debug_event(bs, BLKDBG_PWRITEV_ZERO); | ||
300 | ret = bdrv_co_do_pwrite_zeroes(bs, offset, bytes, flags); | ||
301 | } else if (flags & BDRV_REQ_WRITE_COMPRESSED) { | ||
302 | - ret = bdrv_driver_pwritev_compressed(bs, offset, bytes, qiov); | ||
303 | + ret = bdrv_driver_pwritev_compressed(bs, offset, bytes, qiov, 0); | ||
304 | } else if (bytes <= max_transfer) { | ||
305 | bdrv_debug_event(bs, BLKDBG_PWRITEV); | ||
306 | - ret = bdrv_driver_pwritev(bs, offset, bytes, qiov, flags); | ||
307 | + ret = bdrv_driver_pwritev(bs, offset, bytes, qiov, 0, flags); | ||
308 | } else { | ||
309 | bdrv_debug_event(bs, BLKDBG_PWRITEV); | ||
310 | while (bytes_remaining) { | ||
311 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, | ||
312 | qemu_iovec_concat(&local_qiov, qiov, bytes - bytes_remaining, num); | ||
313 | |||
314 | ret = bdrv_driver_pwritev(bs, offset + bytes - bytes_remaining, | ||
315 | - num, &local_qiov, local_flags); | ||
316 | + num, &local_qiov, 0, local_flags); | ||
317 | qemu_iovec_destroy(&local_qiov); | ||
318 | if (ret < 0) { | ||
319 | break; | ||
320 | diff --git a/qemu-img.c b/qemu-img.c | ||
321 | index XXXXXXX..XXXXXXX 100644 | ||
322 | --- a/qemu-img.c | ||
323 | +++ b/qemu-img.c | ||
324 | @@ -XXX,XX +XXX,XX @@ static int img_convert(int argc, char **argv) | ||
325 | const char *preallocation = | ||
326 | qemu_opt_get(opts, BLOCK_OPT_PREALLOC); | ||
327 | |||
328 | - if (drv && !drv->bdrv_co_pwritev_compressed) { | ||
329 | + if (drv && !block_driver_can_compress(drv)) { | ||
330 | error_report("Compression not supported for this file format"); | ||
331 | ret = -1; | ||
332 | goto out; | ||
333 | @@ -XXX,XX +XXX,XX @@ static int img_convert(int argc, char **argv) | ||
334 | } | ||
335 | out_bs = blk_bs(s.target); | ||
336 | |||
337 | - if (s.compressed && !out_bs->drv->bdrv_co_pwritev_compressed) { | ||
338 | + if (s.compressed && !block_driver_can_compress(out_bs->drv)) { | ||
339 | error_report("Compression not supported for this file format"); | ||
340 | ret = -1; | ||
341 | goto out; | ||
36 | -- | 342 | -- |
37 | 2.13.5 | 343 | 2.21.0 |
38 | 344 | ||
39 | 345 | diff view generated by jsdifflib |
1 | Add the scripts/ directory to sys.path so Python 2.6 will be able to | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | import argparse. | ||
3 | 2 | ||
4 | Cc: Fam Zheng <famz@redhat.com> | 3 | Use and support new API in bdrv_co_do_copy_on_readv. Note that in case |
5 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 4 | of allocated-in-top we need to shrink read size to MIN(..) by hand, as |
6 | Acked-by: John Snow <jsnow@redhat.com> | 5 | pre-patch this was actually done implicitly by qemu_iovec_concat (and |
7 | Acked-by: Fam Zheng <famz@redhat.com> | 6 | we used local_qiov.size). |
8 | Message-id: 20170825155732.15665-3-stefanha@redhat.com | 7 | |
8 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> | ||
9 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
10 | Message-id: 20190604161514.262241-6-vsementsov@virtuozzo.com | ||
11 | Message-Id: <20190604161514.262241-6-vsementsov@virtuozzo.com> | ||
9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 12 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
10 | --- | 13 | --- |
11 | tests/docker/docker.py | 4 +++- | 14 | block/io.c | 18 +++++++++--------- |
12 | 1 file changed, 3 insertions(+), 1 deletion(-) | 15 | 1 file changed, 9 insertions(+), 9 deletions(-) |
13 | 16 | ||
14 | diff --git a/tests/docker/docker.py b/tests/docker/docker.py | 17 | diff --git a/block/io.c b/block/io.c |
15 | index XXXXXXX..XXXXXXX 100755 | 18 | index XXXXXXX..XXXXXXX 100644 |
16 | --- a/tests/docker/docker.py | 19 | --- a/block/io.c |
17 | +++ b/tests/docker/docker.py | 20 | +++ b/block/io.c |
18 | @@ -XXX,XX +XXX,XX @@ | 21 | @@ -XXX,XX +XXX,XX @@ bdrv_driver_pwritev_compressed(BlockDriverState *bs, uint64_t offset, |
19 | 22 | ||
20 | import os | 23 | static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, |
21 | import sys | 24 | int64_t offset, unsigned int bytes, QEMUIOVector *qiov, |
22 | +sys.path.append(os.path.join(os.path.dirname(__file__), | 25 | - int flags) |
23 | + '..', '..', 'scripts')) | 26 | + size_t qiov_offset, int flags) |
24 | +import argparse | 27 | { |
25 | import subprocess | 28 | BlockDriverState *bs = child->bs; |
26 | import json | 29 | |
27 | import hashlib | 30 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, |
28 | import atexit | 31 | void *bounce_buffer; |
29 | import uuid | 32 | |
30 | -import argparse | 33 | BlockDriver *drv = bs->drv; |
31 | import tempfile | 34 | - QEMUIOVector local_qiov; |
32 | import re | 35 | int64_t cluster_offset; |
33 | import signal | 36 | int64_t cluster_bytes; |
37 | size_t skip_bytes; | ||
38 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
39 | assert(skip_bytes < pnum); | ||
40 | |||
41 | if (ret <= 0) { | ||
42 | + QEMUIOVector local_qiov; | ||
43 | + | ||
44 | /* Must copy-on-read; use the bounce buffer */ | ||
45 | pnum = MIN(pnum, MAX_BOUNCE_BUFFER); | ||
46 | qemu_iovec_init_buf(&local_qiov, bounce_buffer, pnum); | ||
47 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
48 | } | ||
49 | |||
50 | if (!(flags & BDRV_REQ_PREFETCH)) { | ||
51 | - qemu_iovec_from_buf(qiov, progress, bounce_buffer + skip_bytes, | ||
52 | + qemu_iovec_from_buf(qiov, qiov_offset + progress, | ||
53 | + bounce_buffer + skip_bytes, | ||
54 | pnum - skip_bytes); | ||
55 | } | ||
56 | } else if (!(flags & BDRV_REQ_PREFETCH)) { | ||
57 | /* Read directly into the destination */ | ||
58 | - qemu_iovec_init(&local_qiov, qiov->niov); | ||
59 | - qemu_iovec_concat(&local_qiov, qiov, progress, pnum - skip_bytes); | ||
60 | - ret = bdrv_driver_preadv(bs, offset + progress, local_qiov.size, | ||
61 | - &local_qiov, 0, 0); | ||
62 | - qemu_iovec_destroy(&local_qiov); | ||
63 | + ret = bdrv_driver_preadv(bs, offset + progress, | ||
64 | + MIN(pnum - skip_bytes, bytes - progress), | ||
65 | + qiov, qiov_offset + progress, 0); | ||
66 | if (ret < 0) { | ||
67 | goto err; | ||
68 | } | ||
69 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, | ||
70 | } | ||
71 | |||
72 | if (!ret || pnum != bytes) { | ||
73 | - ret = bdrv_co_do_copy_on_readv(child, offset, bytes, qiov, flags); | ||
74 | + ret = bdrv_co_do_copy_on_readv(child, offset, bytes, qiov, 0, flags); | ||
75 | goto out; | ||
76 | } else if (flags & BDRV_REQ_PREFETCH) { | ||
77 | goto out; | ||
34 | -- | 78 | -- |
35 | 2.13.5 | 79 | 2.21.0 |
36 | 80 | ||
37 | 81 | diff view generated by jsdifflib |
1 | The minimum Python version supported by QEMU is 2.6. The argparse | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | standard library module was only added in Python 2.7. Many scripts | ||
3 | would like to use argparse because it supports command-line | ||
4 | sub-commands. | ||
5 | 2 | ||
6 | This patch adds argparse. See the top of argparse.py for details. | 3 | Allocate bounce_buffer only if it is really needed. Also, sub-optimize |
4 | allocation size (why not?). | ||
7 | 5 | ||
8 | Suggested-by: Daniel P. Berrange <berrange@redhat.com> | 6 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 7 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> |
10 | Acked-by: John Snow <jsnow@redhat.com> | 8 | Message-id: 20190604161514.262241-7-vsementsov@virtuozzo.com |
11 | Message-id: 20170825155732.15665-2-stefanha@redhat.com | 9 | Message-Id: <20190604161514.262241-7-vsementsov@virtuozzo.com> |
12 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 10 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
13 | --- | 11 | --- |
14 | COPYING.PYTHON | 270 ++++++ | 12 | block/io.c | 21 ++++++++++++--------- |
15 | scripts/argparse.py | 2406 +++++++++++++++++++++++++++++++++++++++++++++++++++ | 13 | 1 file changed, 12 insertions(+), 9 deletions(-) |
16 | 2 files changed, 2676 insertions(+) | ||
17 | create mode 100644 COPYING.PYTHON | ||
18 | create mode 100644 scripts/argparse.py | ||
19 | 14 | ||
20 | diff --git a/COPYING.PYTHON b/COPYING.PYTHON | 15 | diff --git a/block/io.c b/block/io.c |
21 | new file mode 100644 | 16 | index XXXXXXX..XXXXXXX 100644 |
22 | index XXXXXXX..XXXXXXX | 17 | --- a/block/io.c |
23 | --- /dev/null | 18 | +++ b/block/io.c |
24 | +++ b/COPYING.PYTHON | 19 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, |
25 | @@ -XXX,XX +XXX,XX @@ | 20 | * modifying the image file. This is critical for zero-copy guest I/O |
26 | +A. HISTORY OF THE SOFTWARE | 21 | * where anything might happen inside guest memory. |
27 | +========================== | 22 | */ |
23 | - void *bounce_buffer; | ||
24 | + void *bounce_buffer = NULL; | ||
25 | |||
26 | BlockDriver *drv = bs->drv; | ||
27 | int64_t cluster_offset; | ||
28 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
29 | trace_bdrv_co_do_copy_on_readv(bs, offset, bytes, | ||
30 | cluster_offset, cluster_bytes); | ||
31 | |||
32 | - bounce_buffer = qemu_try_blockalign(bs, | ||
33 | - MIN(MIN(max_transfer, cluster_bytes), | ||
34 | - MAX_BOUNCE_BUFFER)); | ||
35 | - if (bounce_buffer == NULL) { | ||
36 | - ret = -ENOMEM; | ||
37 | - goto err; | ||
38 | - } | ||
39 | - | ||
40 | while (cluster_bytes) { | ||
41 | int64_t pnum; | ||
42 | |||
43 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_copy_on_readv(BdrvChild *child, | ||
44 | |||
45 | /* Must copy-on-read; use the bounce buffer */ | ||
46 | pnum = MIN(pnum, MAX_BOUNCE_BUFFER); | ||
47 | + if (!bounce_buffer) { | ||
48 | + int64_t max_we_need = MAX(pnum, cluster_bytes - pnum); | ||
49 | + int64_t max_allowed = MIN(max_transfer, MAX_BOUNCE_BUFFER); | ||
50 | + int64_t bounce_buffer_len = MIN(max_we_need, max_allowed); | ||
28 | + | 51 | + |
29 | +Python was created in the early 1990s by Guido van Rossum at Stichting | 52 | + bounce_buffer = qemu_try_blockalign(bs, bounce_buffer_len); |
30 | +Mathematisch Centrum (CWI, see http://www.cwi.nl) in the Netherlands | 53 | + if (!bounce_buffer) { |
31 | +as a successor of a language called ABC. Guido remains Python's | 54 | + ret = -ENOMEM; |
32 | +principal author, although it includes many contributions from others. | 55 | + goto err; |
33 | + | 56 | + } |
34 | +In 1995, Guido continued his work on Python at the Corporation for | ||
35 | +National Research Initiatives (CNRI, see http://www.cnri.reston.va.us) | ||
36 | +in Reston, Virginia where he released several versions of the | ||
37 | +software. | ||
38 | + | ||
39 | +In May 2000, Guido and the Python core development team moved to | ||
40 | +BeOpen.com to form the BeOpen PythonLabs team. In October of the same | ||
41 | +year, the PythonLabs team moved to Digital Creations (now Zope | ||
42 | +Corporation, see http://www.zope.com). In 2001, the Python Software | ||
43 | +Foundation (PSF, see http://www.python.org/psf/) was formed, a | ||
44 | +non-profit organization created specifically to own Python-related | ||
45 | +Intellectual Property. Zope Corporation is a sponsoring member of | ||
46 | +the PSF. | ||
47 | + | ||
48 | +All Python releases are Open Source (see http://www.opensource.org for | ||
49 | +the Open Source Definition). Historically, most, but not all, Python | ||
50 | +releases have also been GPL-compatible; the table below summarizes | ||
51 | +the various releases. | ||
52 | + | ||
53 | + Release Derived Year Owner GPL- | ||
54 | + from compatible? (1) | ||
55 | + | ||
56 | + 0.9.0 thru 1.2 1991-1995 CWI yes | ||
57 | + 1.3 thru 1.5.2 1.2 1995-1999 CNRI yes | ||
58 | + 1.6 1.5.2 2000 CNRI no | ||
59 | + 2.0 1.6 2000 BeOpen.com no | ||
60 | + 1.6.1 1.6 2001 CNRI yes (2) | ||
61 | + 2.1 2.0+1.6.1 2001 PSF no | ||
62 | + 2.0.1 2.0+1.6.1 2001 PSF yes | ||
63 | + 2.1.1 2.1+2.0.1 2001 PSF yes | ||
64 | + 2.2 2.1.1 2001 PSF yes | ||
65 | + 2.1.2 2.1.1 2002 PSF yes | ||
66 | + 2.1.3 2.1.2 2002 PSF yes | ||
67 | + 2.2.1 2.2 2002 PSF yes | ||
68 | + 2.2.2 2.2.1 2002 PSF yes | ||
69 | + 2.2.3 2.2.2 2003 PSF yes | ||
70 | + 2.3 2.2.2 2002-2003 PSF yes | ||
71 | + 2.3.1 2.3 2002-2003 PSF yes | ||
72 | + 2.3.2 2.3.1 2002-2003 PSF yes | ||
73 | + 2.3.3 2.3.2 2002-2003 PSF yes | ||
74 | + 2.3.4 2.3.3 2004 PSF yes | ||
75 | + 2.3.5 2.3.4 2005 PSF yes | ||
76 | + 2.4 2.3 2004 PSF yes | ||
77 | + 2.4.1 2.4 2005 PSF yes | ||
78 | + 2.4.2 2.4.1 2005 PSF yes | ||
79 | + 2.4.3 2.4.2 2006 PSF yes | ||
80 | + 2.5 2.4 2006 PSF yes | ||
81 | + 2.7 2.6 2010 PSF yes | ||
82 | + | ||
83 | +Footnotes: | ||
84 | + | ||
85 | +(1) GPL-compatible doesn't mean that we're distributing Python under | ||
86 | + the GPL. All Python licenses, unlike the GPL, let you distribute | ||
87 | + a modified version without making your changes open source. The | ||
88 | + GPL-compatible licenses make it possible to combine Python with | ||
89 | + other software that is released under the GPL; the others don't. | ||
90 | + | ||
91 | +(2) According to Richard Stallman, 1.6.1 is not GPL-compatible, | ||
92 | + because its license has a choice of law clause. According to | ||
93 | + CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1 | ||
94 | + is "not incompatible" with the GPL. | ||
95 | + | ||
96 | +Thanks to the many outside volunteers who have worked under Guido's | ||
97 | +direction to make these releases possible. | ||
98 | + | ||
99 | + | ||
100 | +B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON | ||
101 | +=============================================================== | ||
102 | + | ||
103 | +PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2 | ||
104 | +-------------------------------------------- | ||
105 | + | ||
106 | +1. This LICENSE AGREEMENT is between the Python Software Foundation | ||
107 | +("PSF"), and the Individual or Organization ("Licensee") accessing and | ||
108 | +otherwise using this software ("Python") in source or binary form and | ||
109 | +its associated documentation. | ||
110 | + | ||
111 | +2. Subject to the terms and conditions of this License Agreement, PSF | ||
112 | +hereby grants Licensee a nonexclusive, royalty-free, world-wide | ||
113 | +license to reproduce, analyze, test, perform and/or display publicly, | ||
114 | +prepare derivative works, distribute, and otherwise use Python | ||
115 | +alone or in any derivative version, provided, however, that PSF's | ||
116 | +License Agreement and PSF's notice of copyright, i.e., "Copyright (c) | ||
117 | +2001, 2002, 2003, 2004, 2005, 2006 Python Software Foundation; All Rights | ||
118 | +Reserved" are retained in Python alone or in any derivative version | ||
119 | +prepared by Licensee. | ||
120 | + | ||
121 | +3. In the event Licensee prepares a derivative work that is based on | ||
122 | +or incorporates Python or any part thereof, and wants to make | ||
123 | +the derivative work available to others as provided herein, then | ||
124 | +Licensee hereby agrees to include in any such work a brief summary of | ||
125 | +the changes made to Python. | ||
126 | + | ||
127 | +4. PSF is making Python available to Licensee on an "AS IS" | ||
128 | +basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR | ||
129 | +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND | ||
130 | +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS | ||
131 | +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT | ||
132 | +INFRINGE ANY THIRD PARTY RIGHTS. | ||
133 | + | ||
134 | +5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON | ||
135 | +FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS | ||
136 | +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, | ||
137 | +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. | ||
138 | + | ||
139 | +6. This License Agreement will automatically terminate upon a material | ||
140 | +breach of its terms and conditions. | ||
141 | + | ||
142 | +7. Nothing in this License Agreement shall be deemed to create any | ||
143 | +relationship of agency, partnership, or joint venture between PSF and | ||
144 | +Licensee. This License Agreement does not grant permission to use PSF | ||
145 | +trademarks or trade name in a trademark sense to endorse or promote | ||
146 | +products or services of Licensee, or any third party. | ||
147 | + | ||
148 | +8. By copying, installing or otherwise using Python, Licensee | ||
149 | +agrees to be bound by the terms and conditions of this License | ||
150 | +Agreement. | ||
151 | + | ||
152 | + | ||
153 | +BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 | ||
154 | +------------------------------------------- | ||
155 | + | ||
156 | +BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 | ||
157 | + | ||
158 | +1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an | ||
159 | +office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the | ||
160 | +Individual or Organization ("Licensee") accessing and otherwise using | ||
161 | +this software in source or binary form and its associated | ||
162 | +documentation ("the Software"). | ||
163 | + | ||
164 | +2. Subject to the terms and conditions of this BeOpen Python License | ||
165 | +Agreement, BeOpen hereby grants Licensee a non-exclusive, | ||
166 | +royalty-free, world-wide license to reproduce, analyze, test, perform | ||
167 | +and/or display publicly, prepare derivative works, distribute, and | ||
168 | +otherwise use the Software alone or in any derivative version, | ||
169 | +provided, however, that the BeOpen Python License is retained in the | ||
170 | +Software, alone or in any derivative version prepared by Licensee. | ||
171 | + | ||
172 | +3. BeOpen is making the Software available to Licensee on an "AS IS" | ||
173 | +basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR | ||
174 | +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND | ||
175 | +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS | ||
176 | +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT | ||
177 | +INFRINGE ANY THIRD PARTY RIGHTS. | ||
178 | + | ||
179 | +4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE | ||
180 | +SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS | ||
181 | +AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY | ||
182 | +DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. | ||
183 | + | ||
184 | +5. This License Agreement will automatically terminate upon a material | ||
185 | +breach of its terms and conditions. | ||
186 | + | ||
187 | +6. This License Agreement shall be governed by and interpreted in all | ||
188 | +respects by the law of the State of California, excluding conflict of | ||
189 | +law provisions. Nothing in this License Agreement shall be deemed to | ||
190 | +create any relationship of agency, partnership, or joint venture | ||
191 | +between BeOpen and Licensee. This License Agreement does not grant | ||
192 | +permission to use BeOpen trademarks or trade names in a trademark | ||
193 | +sense to endorse or promote products or services of Licensee, or any | ||
194 | +third party. As an exception, the "BeOpen Python" logos available at | ||
195 | +http://www.pythonlabs.com/logos.html may be used according to the | ||
196 | +permissions granted on that web page. | ||
197 | + | ||
198 | +7. By copying, installing or otherwise using the software, Licensee | ||
199 | +agrees to be bound by the terms and conditions of this License | ||
200 | +Agreement. | ||
201 | + | ||
202 | + | ||
203 | +CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 | ||
204 | +--------------------------------------- | ||
205 | + | ||
206 | +1. This LICENSE AGREEMENT is between the Corporation for National | ||
207 | +Research Initiatives, having an office at 1895 Preston White Drive, | ||
208 | +Reston, VA 20191 ("CNRI"), and the Individual or Organization | ||
209 | +("Licensee") accessing and otherwise using Python 1.6.1 software in | ||
210 | +source or binary form and its associated documentation. | ||
211 | + | ||
212 | +2. Subject to the terms and conditions of this License Agreement, CNRI | ||
213 | +hereby grants Licensee a nonexclusive, royalty-free, world-wide | ||
214 | +license to reproduce, analyze, test, perform and/or display publicly, | ||
215 | +prepare derivative works, distribute, and otherwise use Python 1.6.1 | ||
216 | +alone or in any derivative version, provided, however, that CNRI's | ||
217 | +License Agreement and CNRI's notice of copyright, i.e., "Copyright (c) | ||
218 | +1995-2001 Corporation for National Research Initiatives; All Rights | ||
219 | +Reserved" are retained in Python 1.6.1 alone or in any derivative | ||
220 | +version prepared by Licensee. Alternately, in lieu of CNRI's License | ||
221 | +Agreement, Licensee may substitute the following text (omitting the | ||
222 | +quotes): "Python 1.6.1 is made available subject to the terms and | ||
223 | +conditions in CNRI's License Agreement. This Agreement together with | ||
224 | +Python 1.6.1 may be located on the Internet using the following | ||
225 | +unique, persistent identifier (known as a handle): 1895.22/1013. This | ||
226 | +Agreement may also be obtained from a proxy server on the Internet | ||
227 | +using the following URL: http://hdl.handle.net/1895.22/1013". | ||
228 | + | ||
229 | +3. In the event Licensee prepares a derivative work that is based on | ||
230 | +or incorporates Python 1.6.1 or any part thereof, and wants to make | ||
231 | +the derivative work available to others as provided herein, then | ||
232 | +Licensee hereby agrees to include in any such work a brief summary of | ||
233 | +the changes made to Python 1.6.1. | ||
234 | + | ||
235 | +4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" | ||
236 | +basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR | ||
237 | +IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND | ||
238 | +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS | ||
239 | +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT | ||
240 | +INFRINGE ANY THIRD PARTY RIGHTS. | ||
241 | + | ||
242 | +5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON | ||
243 | +1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS | ||
244 | +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, | ||
245 | +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. | ||
246 | + | ||
247 | +6. This License Agreement will automatically terminate upon a material | ||
248 | +breach of its terms and conditions. | ||
249 | + | ||
250 | +7. This License Agreement shall be governed by the federal | ||
251 | +intellectual property law of the United States, including without | ||
252 | +limitation the federal copyright law, and, to the extent such | ||
253 | +U.S. federal law does not apply, by the law of the Commonwealth of | ||
254 | +Virginia, excluding Virginia's conflict of law provisions. | ||
255 | +Notwithstanding the foregoing, with regard to derivative works based | ||
256 | +on Python 1.6.1 that incorporate non-separable material that was | ||
257 | +previously distributed under the GNU General Public License (GPL), the | ||
258 | +law of the Commonwealth of Virginia shall govern this License | ||
259 | +Agreement only as to issues arising under or with respect to | ||
260 | +Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this | ||
261 | +License Agreement shall be deemed to create any relationship of | ||
262 | +agency, partnership, or joint venture between CNRI and Licensee. This | ||
263 | +License Agreement does not grant permission to use CNRI trademarks or | ||
264 | +trade name in a trademark sense to endorse or promote products or | ||
265 | +services of Licensee, or any third party. | ||
266 | + | ||
267 | +8. By clicking on the "ACCEPT" button where indicated, or by copying, | ||
268 | +installing or otherwise using Python 1.6.1, Licensee agrees to be | ||
269 | +bound by the terms and conditions of this License Agreement. | ||
270 | + | ||
271 | + ACCEPT | ||
272 | + | ||
273 | + | ||
274 | +CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 | ||
275 | +-------------------------------------------------- | ||
276 | + | ||
277 | +Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, | ||
278 | +The Netherlands. All rights reserved. | ||
279 | + | ||
280 | +Permission to use, copy, modify, and distribute this software and its | ||
281 | +documentation for any purpose and without fee is hereby granted, | ||
282 | +provided that the above copyright notice appear in all copies and that | ||
283 | +both that copyright notice and this permission notice appear in | ||
284 | +supporting documentation, and that the name of Stichting Mathematisch | ||
285 | +Centrum or CWI not be used in advertising or publicity pertaining to | ||
286 | +distribution of the software without specific, written prior | ||
287 | +permission. | ||
288 | + | ||
289 | +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO | ||
290 | +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND | ||
291 | +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE | ||
292 | +FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | ||
293 | +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | ||
294 | +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT | ||
295 | +OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | ||
296 | diff --git a/scripts/argparse.py b/scripts/argparse.py | ||
297 | new file mode 100644 | ||
298 | index XXXXXXX..XXXXXXX | ||
299 | --- /dev/null | ||
300 | +++ b/scripts/argparse.py | ||
301 | @@ -XXX,XX +XXX,XX @@ | ||
302 | +# This is a local copy of the standard library argparse module taken from PyPI. | ||
303 | +# It is licensed under the Python Software Foundation License. This is a | ||
304 | +# fallback for Python 2.6 which does not include this module. Python 2.7+ and | ||
305 | +# 3+ will never load this module because built-in modules are loaded before | ||
306 | +# anything in sys.path. | ||
307 | +# | ||
308 | +# If your script is not located in the same directory as this file, import it | ||
309 | +# like this: | ||
310 | +# | ||
311 | +# import os | ||
312 | +# import sys | ||
313 | +# sys.path.append(os.path.join(os.path.dirname(__file__), ..., 'scripts')) | ||
314 | +# import argparse | ||
315 | + | ||
316 | +# Author: Steven J. Bethard <steven.bethard@gmail.com>. | ||
317 | +# Maintainer: Thomas Waldmann <tw@waldmann-edv.de> | ||
318 | + | ||
319 | +"""Command-line parsing library | ||
320 | + | ||
321 | +This module is an optparse-inspired command-line parsing library that: | ||
322 | + | ||
323 | + - handles both optional and positional arguments | ||
324 | + - produces highly informative usage messages | ||
325 | + - supports parsers that dispatch to sub-parsers | ||
326 | + | ||
327 | +The following is a simple usage example that sums integers from the | ||
328 | +command-line and writes the result to a file:: | ||
329 | + | ||
330 | + parser = argparse.ArgumentParser( | ||
331 | + description='sum the integers at the command line') | ||
332 | + parser.add_argument( | ||
333 | + 'integers', metavar='int', nargs='+', type=int, | ||
334 | + help='an integer to be summed') | ||
335 | + parser.add_argument( | ||
336 | + '--log', default=sys.stdout, type=argparse.FileType('w'), | ||
337 | + help='the file where the sum should be written') | ||
338 | + args = parser.parse_args() | ||
339 | + args.log.write('%s' % sum(args.integers)) | ||
340 | + args.log.close() | ||
341 | + | ||
342 | +The module contains the following public classes: | ||
343 | + | ||
344 | + - ArgumentParser -- The main entry point for command-line parsing. As the | ||
345 | + example above shows, the add_argument() method is used to populate | ||
346 | + the parser with actions for optional and positional arguments. Then | ||
347 | + the parse_args() method is invoked to convert the args at the | ||
348 | + command-line into an object with attributes. | ||
349 | + | ||
350 | + - ArgumentError -- The exception raised by ArgumentParser objects when | ||
351 | + there are errors with the parser's actions. Errors raised while | ||
352 | + parsing the command-line are caught by ArgumentParser and emitted | ||
353 | + as command-line messages. | ||
354 | + | ||
355 | + - FileType -- A factory for defining types of files to be created. As the | ||
356 | + example above shows, instances of FileType are typically passed as | ||
357 | + the type= argument of add_argument() calls. | ||
358 | + | ||
359 | + - Action -- The base class for parser actions. Typically actions are | ||
360 | + selected by passing strings like 'store_true' or 'append_const' to | ||
361 | + the action= argument of add_argument(). However, for greater | ||
362 | + customization of ArgumentParser actions, subclasses of Action may | ||
363 | + be defined and passed as the action= argument. | ||
364 | + | ||
365 | + - HelpFormatter, RawDescriptionHelpFormatter, RawTextHelpFormatter, | ||
366 | + ArgumentDefaultsHelpFormatter -- Formatter classes which | ||
367 | + may be passed as the formatter_class= argument to the | ||
368 | + ArgumentParser constructor. HelpFormatter is the default, | ||
369 | + RawDescriptionHelpFormatter and RawTextHelpFormatter tell the parser | ||
370 | + not to change the formatting for help text, and | ||
371 | + ArgumentDefaultsHelpFormatter adds information about argument defaults | ||
372 | + to the help. | ||
373 | + | ||
374 | +All other classes in this module are considered implementation details. | ||
375 | +(Also note that HelpFormatter and RawDescriptionHelpFormatter are only | ||
376 | +considered public as object names -- the API of the formatter objects is | ||
377 | +still considered an implementation detail.) | ||
378 | +""" | ||
379 | + | ||
380 | +__version__ = '1.4.0' # we use our own version number independant of the | ||
381 | + # one in stdlib and we release this on pypi. | ||
382 | + | ||
383 | +__external_lib__ = True # to make sure the tests really test THIS lib, | ||
384 | + # not the builtin one in Python stdlib | ||
385 | + | ||
386 | +__all__ = [ | ||
387 | + 'ArgumentParser', | ||
388 | + 'ArgumentError', | ||
389 | + 'ArgumentTypeError', | ||
390 | + 'FileType', | ||
391 | + 'HelpFormatter', | ||
392 | + 'ArgumentDefaultsHelpFormatter', | ||
393 | + 'RawDescriptionHelpFormatter', | ||
394 | + 'RawTextHelpFormatter', | ||
395 | + 'Namespace', | ||
396 | + 'Action', | ||
397 | + 'ONE_OR_MORE', | ||
398 | + 'OPTIONAL', | ||
399 | + 'PARSER', | ||
400 | + 'REMAINDER', | ||
401 | + 'SUPPRESS', | ||
402 | + 'ZERO_OR_MORE', | ||
403 | +] | ||
404 | + | ||
405 | + | ||
406 | +import copy as _copy | ||
407 | +import os as _os | ||
408 | +import re as _re | ||
409 | +import sys as _sys | ||
410 | +import textwrap as _textwrap | ||
411 | + | ||
412 | +from gettext import gettext as _ | ||
413 | + | ||
414 | +try: | ||
415 | + set | ||
416 | +except NameError: | ||
417 | + # for python < 2.4 compatibility (sets module is there since 2.3): | ||
418 | + from sets import Set as set | ||
419 | + | ||
420 | +try: | ||
421 | + basestring | ||
422 | +except NameError: | ||
423 | + basestring = str | ||
424 | + | ||
425 | +try: | ||
426 | + sorted | ||
427 | +except NameError: | ||
428 | + # for python < 2.4 compatibility: | ||
429 | + def sorted(iterable, reverse=False): | ||
430 | + result = list(iterable) | ||
431 | + result.sort() | ||
432 | + if reverse: | ||
433 | + result.reverse() | ||
434 | + return result | ||
435 | + | ||
436 | + | ||
437 | +def _callable(obj): | ||
438 | + return hasattr(obj, '__call__') or hasattr(obj, '__bases__') | ||
439 | + | ||
440 | + | ||
441 | +SUPPRESS = '==SUPPRESS==' | ||
442 | + | ||
443 | +OPTIONAL = '?' | ||
444 | +ZERO_OR_MORE = '*' | ||
445 | +ONE_OR_MORE = '+' | ||
446 | +PARSER = 'A...' | ||
447 | +REMAINDER = '...' | ||
448 | +_UNRECOGNIZED_ARGS_ATTR = '_unrecognized_args' | ||
449 | + | ||
450 | +# ============================= | ||
451 | +# Utility functions and classes | ||
452 | +# ============================= | ||
453 | + | ||
454 | +class _AttributeHolder(object): | ||
455 | + """Abstract base class that provides __repr__. | ||
456 | + | ||
457 | + The __repr__ method returns a string in the format:: | ||
458 | + ClassName(attr=name, attr=name, ...) | ||
459 | + The attributes are determined either by a class-level attribute, | ||
460 | + '_kwarg_names', or by inspecting the instance __dict__. | ||
461 | + """ | ||
462 | + | ||
463 | + def __repr__(self): | ||
464 | + type_name = type(self).__name__ | ||
465 | + arg_strings = [] | ||
466 | + for arg in self._get_args(): | ||
467 | + arg_strings.append(repr(arg)) | ||
468 | + for name, value in self._get_kwargs(): | ||
469 | + arg_strings.append('%s=%r' % (name, value)) | ||
470 | + return '%s(%s)' % (type_name, ', '.join(arg_strings)) | ||
471 | + | ||
472 | + def _get_kwargs(self): | ||
473 | + return sorted(self.__dict__.items()) | ||
474 | + | ||
475 | + def _get_args(self): | ||
476 | + return [] | ||
477 | + | ||
478 | + | ||
479 | +def _ensure_value(namespace, name, value): | ||
480 | + if getattr(namespace, name, None) is None: | ||
481 | + setattr(namespace, name, value) | ||
482 | + return getattr(namespace, name) | ||
483 | + | ||
484 | + | ||
485 | +# =============== | ||
486 | +# Formatting Help | ||
487 | +# =============== | ||
488 | + | ||
489 | +class HelpFormatter(object): | ||
490 | + """Formatter for generating usage messages and argument help strings. | ||
491 | + | ||
492 | + Only the name of this class is considered a public API. All the methods | ||
493 | + provided by the class are considered an implementation detail. | ||
494 | + """ | ||
495 | + | ||
496 | + def __init__(self, | ||
497 | + prog, | ||
498 | + indent_increment=2, | ||
499 | + max_help_position=24, | ||
500 | + width=None): | ||
501 | + | ||
502 | + # default setting for width | ||
503 | + if width is None: | ||
504 | + try: | ||
505 | + width = int(_os.environ['COLUMNS']) | ||
506 | + except (KeyError, ValueError): | ||
507 | + width = 80 | ||
508 | + width -= 2 | ||
509 | + | ||
510 | + self._prog = prog | ||
511 | + self._indent_increment = indent_increment | ||
512 | + self._max_help_position = max_help_position | ||
513 | + self._width = width | ||
514 | + | ||
515 | + self._current_indent = 0 | ||
516 | + self._level = 0 | ||
517 | + self._action_max_length = 0 | ||
518 | + | ||
519 | + self._root_section = self._Section(self, None) | ||
520 | + self._current_section = self._root_section | ||
521 | + | ||
522 | + self._whitespace_matcher = _re.compile(r'\s+') | ||
523 | + self._long_break_matcher = _re.compile(r'\n\n\n+') | ||
524 | + | ||
525 | + # =============================== | ||
526 | + # Section and indentation methods | ||
527 | + # =============================== | ||
528 | + def _indent(self): | ||
529 | + self._current_indent += self._indent_increment | ||
530 | + self._level += 1 | ||
531 | + | ||
532 | + def _dedent(self): | ||
533 | + self._current_indent -= self._indent_increment | ||
534 | + assert self._current_indent >= 0, 'Indent decreased below 0.' | ||
535 | + self._level -= 1 | ||
536 | + | ||
537 | + class _Section(object): | ||
538 | + | ||
539 | + def __init__(self, formatter, parent, heading=None): | ||
540 | + self.formatter = formatter | ||
541 | + self.parent = parent | ||
542 | + self.heading = heading | ||
543 | + self.items = [] | ||
544 | + | ||
545 | + def format_help(self): | ||
546 | + # format the indented section | ||
547 | + if self.parent is not None: | ||
548 | + self.formatter._indent() | ||
549 | + join = self.formatter._join_parts | ||
550 | + for func, args in self.items: | ||
551 | + func(*args) | ||
552 | + item_help = join([func(*args) for func, args in self.items]) | ||
553 | + if self.parent is not None: | ||
554 | + self.formatter._dedent() | ||
555 | + | ||
556 | + # return nothing if the section was empty | ||
557 | + if not item_help: | ||
558 | + return '' | ||
559 | + | ||
560 | + # add the heading if the section was non-empty | ||
561 | + if self.heading is not SUPPRESS and self.heading is not None: | ||
562 | + current_indent = self.formatter._current_indent | ||
563 | + heading = '%*s%s:\n' % (current_indent, '', self.heading) | ||
564 | + else: | ||
565 | + heading = '' | ||
566 | + | ||
567 | + # join the section-initial newline, the heading and the help | ||
568 | + return join(['\n', heading, item_help, '\n']) | ||
569 | + | ||
570 | + def _add_item(self, func, args): | ||
571 | + self._current_section.items.append((func, args)) | ||
572 | + | ||
573 | + # ======================== | ||
574 | + # Message building methods | ||
575 | + # ======================== | ||
576 | + def start_section(self, heading): | ||
577 | + self._indent() | ||
578 | + section = self._Section(self, self._current_section, heading) | ||
579 | + self._add_item(section.format_help, []) | ||
580 | + self._current_section = section | ||
581 | + | ||
582 | + def end_section(self): | ||
583 | + self._current_section = self._current_section.parent | ||
584 | + self._dedent() | ||
585 | + | ||
586 | + def add_text(self, text): | ||
587 | + if text is not SUPPRESS and text is not None: | ||
588 | + self._add_item(self._format_text, [text]) | ||
589 | + | ||
590 | + def add_usage(self, usage, actions, groups, prefix=None): | ||
591 | + if usage is not SUPPRESS: | ||
592 | + args = usage, actions, groups, prefix | ||
593 | + self._add_item(self._format_usage, args) | ||
594 | + | ||
595 | + def add_argument(self, action): | ||
596 | + if action.help is not SUPPRESS: | ||
597 | + | ||
598 | + # find all invocations | ||
599 | + get_invocation = self._format_action_invocation | ||
600 | + invocations = [get_invocation(action)] | ||
601 | + for subaction in self._iter_indented_subactions(action): | ||
602 | + invocations.append(get_invocation(subaction)) | ||
603 | + | ||
604 | + # update the maximum item length | ||
605 | + invocation_length = max([len(s) for s in invocations]) | ||
606 | + action_length = invocation_length + self._current_indent | ||
607 | + self._action_max_length = max(self._action_max_length, | ||
608 | + action_length) | ||
609 | + | ||
610 | + # add the item to the list | ||
611 | + self._add_item(self._format_action, [action]) | ||
612 | + | ||
613 | + def add_arguments(self, actions): | ||
614 | + for action in actions: | ||
615 | + self.add_argument(action) | ||
616 | + | ||
617 | + # ======================= | ||
618 | + # Help-formatting methods | ||
619 | + # ======================= | ||
620 | + def format_help(self): | ||
621 | + help = self._root_section.format_help() | ||
622 | + if help: | ||
623 | + help = self._long_break_matcher.sub('\n\n', help) | ||
624 | + help = help.strip('\n') + '\n' | ||
625 | + return help | ||
626 | + | ||
627 | + def _join_parts(self, part_strings): | ||
628 | + return ''.join([part | ||
629 | + for part in part_strings | ||
630 | + if part and part is not SUPPRESS]) | ||
631 | + | ||
632 | + def _format_usage(self, usage, actions, groups, prefix): | ||
633 | + if prefix is None: | ||
634 | + prefix = _('usage: ') | ||
635 | + | ||
636 | + # if usage is specified, use that | ||
637 | + if usage is not None: | ||
638 | + usage = usage % dict(prog=self._prog) | ||
639 | + | ||
640 | + # if no optionals or positionals are available, usage is just prog | ||
641 | + elif usage is None and not actions: | ||
642 | + usage = '%(prog)s' % dict(prog=self._prog) | ||
643 | + | ||
644 | + # if optionals and positionals are available, calculate usage | ||
645 | + elif usage is None: | ||
646 | + prog = '%(prog)s' % dict(prog=self._prog) | ||
647 | + | ||
648 | + # split optionals from positionals | ||
649 | + optionals = [] | ||
650 | + positionals = [] | ||
651 | + for action in actions: | ||
652 | + if action.option_strings: | ||
653 | + optionals.append(action) | ||
654 | + else: | ||
655 | + positionals.append(action) | ||
656 | + | ||
657 | + # build full usage string | ||
658 | + format = self._format_actions_usage | ||
659 | + action_usage = format(optionals + positionals, groups) | ||
660 | + usage = ' '.join([s for s in [prog, action_usage] if s]) | ||
661 | + | ||
662 | + # wrap the usage parts if it's too long | ||
663 | + text_width = self._width - self._current_indent | ||
664 | + if len(prefix) + len(usage) > text_width: | ||
665 | + | ||
666 | + # break usage into wrappable parts | ||
667 | + part_regexp = r'\(.*?\)+|\[.*?\]+|\S+' | ||
668 | + opt_usage = format(optionals, groups) | ||
669 | + pos_usage = format(positionals, groups) | ||
670 | + opt_parts = _re.findall(part_regexp, opt_usage) | ||
671 | + pos_parts = _re.findall(part_regexp, pos_usage) | ||
672 | + assert ' '.join(opt_parts) == opt_usage | ||
673 | + assert ' '.join(pos_parts) == pos_usage | ||
674 | + | ||
675 | + # helper for wrapping lines | ||
676 | + def get_lines(parts, indent, prefix=None): | ||
677 | + lines = [] | ||
678 | + line = [] | ||
679 | + if prefix is not None: | ||
680 | + line_len = len(prefix) - 1 | ||
681 | + else: | ||
682 | + line_len = len(indent) - 1 | ||
683 | + for part in parts: | ||
684 | + if line_len + 1 + len(part) > text_width: | ||
685 | + lines.append(indent + ' '.join(line)) | ||
686 | + line = [] | ||
687 | + line_len = len(indent) - 1 | ||
688 | + line.append(part) | ||
689 | + line_len += len(part) + 1 | ||
690 | + if line: | ||
691 | + lines.append(indent + ' '.join(line)) | ||
692 | + if prefix is not None: | ||
693 | + lines[0] = lines[0][len(indent):] | ||
694 | + return lines | ||
695 | + | ||
696 | + # if prog is short, follow it with optionals or positionals | ||
697 | + if len(prefix) + len(prog) <= 0.75 * text_width: | ||
698 | + indent = ' ' * (len(prefix) + len(prog) + 1) | ||
699 | + if opt_parts: | ||
700 | + lines = get_lines([prog] + opt_parts, indent, prefix) | ||
701 | + lines.extend(get_lines(pos_parts, indent)) | ||
702 | + elif pos_parts: | ||
703 | + lines = get_lines([prog] + pos_parts, indent, prefix) | ||
704 | + else: | ||
705 | + lines = [prog] | ||
706 | + | ||
707 | + # if prog is long, put it on its own line | ||
708 | + else: | ||
709 | + indent = ' ' * len(prefix) | ||
710 | + parts = opt_parts + pos_parts | ||
711 | + lines = get_lines(parts, indent) | ||
712 | + if len(lines) > 1: | ||
713 | + lines = [] | ||
714 | + lines.extend(get_lines(opt_parts, indent)) | ||
715 | + lines.extend(get_lines(pos_parts, indent)) | ||
716 | + lines = [prog] + lines | ||
717 | + | ||
718 | + # join lines into usage | ||
719 | + usage = '\n'.join(lines) | ||
720 | + | ||
721 | + # prefix with 'usage:' | ||
722 | + return '%s%s\n\n' % (prefix, usage) | ||
723 | + | ||
724 | + def _format_actions_usage(self, actions, groups): | ||
725 | + # find group indices and identify actions in groups | ||
726 | + group_actions = set() | ||
727 | + inserts = {} | ||
728 | + for group in groups: | ||
729 | + try: | ||
730 | + start = actions.index(group._group_actions[0]) | ||
731 | + except ValueError: | ||
732 | + continue | ||
733 | + else: | ||
734 | + end = start + len(group._group_actions) | ||
735 | + if actions[start:end] == group._group_actions: | ||
736 | + for action in group._group_actions: | ||
737 | + group_actions.add(action) | ||
738 | + if not group.required: | ||
739 | + if start in inserts: | ||
740 | + inserts[start] += ' [' | ||
741 | + else: | ||
742 | + inserts[start] = '[' | ||
743 | + inserts[end] = ']' | ||
744 | + else: | ||
745 | + if start in inserts: | ||
746 | + inserts[start] += ' (' | ||
747 | + else: | ||
748 | + inserts[start] = '(' | ||
749 | + inserts[end] = ')' | ||
750 | + for i in range(start + 1, end): | ||
751 | + inserts[i] = '|' | ||
752 | + | ||
753 | + # collect all actions format strings | ||
754 | + parts = [] | ||
755 | + for i, action in enumerate(actions): | ||
756 | + | ||
757 | + # suppressed arguments are marked with None | ||
758 | + # remove | separators for suppressed arguments | ||
759 | + if action.help is SUPPRESS: | ||
760 | + parts.append(None) | ||
761 | + if inserts.get(i) == '|': | ||
762 | + inserts.pop(i) | ||
763 | + elif inserts.get(i + 1) == '|': | ||
764 | + inserts.pop(i + 1) | ||
765 | + | ||
766 | + # produce all arg strings | ||
767 | + elif not action.option_strings: | ||
768 | + part = self._format_args(action, action.dest) | ||
769 | + | ||
770 | + # if it's in a group, strip the outer [] | ||
771 | + if action in group_actions: | ||
772 | + if part[0] == '[' and part[-1] == ']': | ||
773 | + part = part[1:-1] | ||
774 | + | ||
775 | + # add the action string to the list | ||
776 | + parts.append(part) | ||
777 | + | ||
778 | + # produce the first way to invoke the option in brackets | ||
779 | + else: | ||
780 | + option_string = action.option_strings[0] | ||
781 | + | ||
782 | + # if the Optional doesn't take a value, format is: | ||
783 | + # -s or --long | ||
784 | + if action.nargs == 0: | ||
785 | + part = '%s' % option_string | ||
786 | + | ||
787 | + # if the Optional takes a value, format is: | ||
788 | + # -s ARGS or --long ARGS | ||
789 | + else: | ||
790 | + default = action.dest.upper() | ||
791 | + args_string = self._format_args(action, default) | ||
792 | + part = '%s %s' % (option_string, args_string) | ||
793 | + | ||
794 | + # make it look optional if it's not required or in a group | ||
795 | + if not action.required and action not in group_actions: | ||
796 | + part = '[%s]' % part | ||
797 | + | ||
798 | + # add the action string to the list | ||
799 | + parts.append(part) | ||
800 | + | ||
801 | + # insert things at the necessary indices | ||
802 | + for i in sorted(inserts, reverse=True): | ||
803 | + parts[i:i] = [inserts[i]] | ||
804 | + | ||
805 | + # join all the action items with spaces | ||
806 | + text = ' '.join([item for item in parts if item is not None]) | ||
807 | + | ||
808 | + # clean up separators for mutually exclusive groups | ||
809 | + open = r'[\[(]' | ||
810 | + close = r'[\])]' | ||
811 | + text = _re.sub(r'(%s) ' % open, r'\1', text) | ||
812 | + text = _re.sub(r' (%s)' % close, r'\1', text) | ||
813 | + text = _re.sub(r'%s *%s' % (open, close), r'', text) | ||
814 | + text = _re.sub(r'\(([^|]*)\)', r'\1', text) | ||
815 | + text = text.strip() | ||
816 | + | ||
817 | + # return the text | ||
818 | + return text | ||
819 | + | ||
820 | + def _format_text(self, text): | ||
821 | + if '%(prog)' in text: | ||
822 | + text = text % dict(prog=self._prog) | ||
823 | + text_width = self._width - self._current_indent | ||
824 | + indent = ' ' * self._current_indent | ||
825 | + return self._fill_text(text, text_width, indent) + '\n\n' | ||
826 | + | ||
827 | + def _format_action(self, action): | ||
828 | + # determine the required width and the entry label | ||
829 | + help_position = min(self._action_max_length + 2, | ||
830 | + self._max_help_position) | ||
831 | + help_width = self._width - help_position | ||
832 | + action_width = help_position - self._current_indent - 2 | ||
833 | + action_header = self._format_action_invocation(action) | ||
834 | + | ||
835 | + # ho nelp; start on same line and add a final newline | ||
836 | + if not action.help: | ||
837 | + tup = self._current_indent, '', action_header | ||
838 | + action_header = '%*s%s\n' % tup | ||
839 | + | ||
840 | + # short action name; start on the same line and pad two spaces | ||
841 | + elif len(action_header) <= action_width: | ||
842 | + tup = self._current_indent, '', action_width, action_header | ||
843 | + action_header = '%*s%-*s ' % tup | ||
844 | + indent_first = 0 | ||
845 | + | ||
846 | + # long action name; start on the next line | ||
847 | + else: | ||
848 | + tup = self._current_indent, '', action_header | ||
849 | + action_header = '%*s%s\n' % tup | ||
850 | + indent_first = help_position | ||
851 | + | ||
852 | + # collect the pieces of the action help | ||
853 | + parts = [action_header] | ||
854 | + | ||
855 | + # if there was help for the action, add lines of help text | ||
856 | + if action.help: | ||
857 | + help_text = self._expand_help(action) | ||
858 | + help_lines = self._split_lines(help_text, help_width) | ||
859 | + parts.append('%*s%s\n' % (indent_first, '', help_lines[0])) | ||
860 | + for line in help_lines[1:]: | ||
861 | + parts.append('%*s%s\n' % (help_position, '', line)) | ||
862 | + | ||
863 | + # or add a newline if the description doesn't end with one | ||
864 | + elif not action_header.endswith('\n'): | ||
865 | + parts.append('\n') | ||
866 | + | ||
867 | + # if there are any sub-actions, add their help as well | ||
868 | + for subaction in self._iter_indented_subactions(action): | ||
869 | + parts.append(self._format_action(subaction)) | ||
870 | + | ||
871 | + # return a single string | ||
872 | + return self._join_parts(parts) | ||
873 | + | ||
874 | + def _format_action_invocation(self, action): | ||
875 | + if not action.option_strings: | ||
876 | + metavar, = self._metavar_formatter(action, action.dest)(1) | ||
877 | + return metavar | ||
878 | + | ||
879 | + else: | ||
880 | + parts = [] | ||
881 | + | ||
882 | + # if the Optional doesn't take a value, format is: | ||
883 | + # -s, --long | ||
884 | + if action.nargs == 0: | ||
885 | + parts.extend(action.option_strings) | ||
886 | + | ||
887 | + # if the Optional takes a value, format is: | ||
888 | + # -s ARGS, --long ARGS | ||
889 | + else: | ||
890 | + default = action.dest.upper() | ||
891 | + args_string = self._format_args(action, default) | ||
892 | + for option_string in action.option_strings: | ||
893 | + parts.append('%s %s' % (option_string, args_string)) | ||
894 | + | ||
895 | + return ', '.join(parts) | ||
896 | + | ||
897 | + def _metavar_formatter(self, action, default_metavar): | ||
898 | + if action.metavar is not None: | ||
899 | + result = action.metavar | ||
900 | + elif action.choices is not None: | ||
901 | + choice_strs = [str(choice) for choice in action.choices] | ||
902 | + result = '{%s}' % ','.join(choice_strs) | ||
903 | + else: | ||
904 | + result = default_metavar | ||
905 | + | ||
906 | + def format(tuple_size): | ||
907 | + if isinstance(result, tuple): | ||
908 | + return result | ||
909 | + else: | ||
910 | + return (result, ) * tuple_size | ||
911 | + return format | ||
912 | + | ||
913 | + def _format_args(self, action, default_metavar): | ||
914 | + get_metavar = self._metavar_formatter(action, default_metavar) | ||
915 | + if action.nargs is None: | ||
916 | + result = '%s' % get_metavar(1) | ||
917 | + elif action.nargs == OPTIONAL: | ||
918 | + result = '[%s]' % get_metavar(1) | ||
919 | + elif action.nargs == ZERO_OR_MORE: | ||
920 | + result = '[%s [%s ...]]' % get_metavar(2) | ||
921 | + elif action.nargs == ONE_OR_MORE: | ||
922 | + result = '%s [%s ...]' % get_metavar(2) | ||
923 | + elif action.nargs == REMAINDER: | ||
924 | + result = '...' | ||
925 | + elif action.nargs == PARSER: | ||
926 | + result = '%s ...' % get_metavar(1) | ||
927 | + else: | ||
928 | + formats = ['%s' for _ in range(action.nargs)] | ||
929 | + result = ' '.join(formats) % get_metavar(action.nargs) | ||
930 | + return result | ||
931 | + | ||
932 | + def _expand_help(self, action): | ||
933 | + params = dict(vars(action), prog=self._prog) | ||
934 | + for name in list(params): | ||
935 | + if params[name] is SUPPRESS: | ||
936 | + del params[name] | ||
937 | + for name in list(params): | ||
938 | + if hasattr(params[name], '__name__'): | ||
939 | + params[name] = params[name].__name__ | ||
940 | + if params.get('choices') is not None: | ||
941 | + choices_str = ', '.join([str(c) for c in params['choices']]) | ||
942 | + params['choices'] = choices_str | ||
943 | + return self._get_help_string(action) % params | ||
944 | + | ||
945 | + def _iter_indented_subactions(self, action): | ||
946 | + try: | ||
947 | + get_subactions = action._get_subactions | ||
948 | + except AttributeError: | ||
949 | + pass | ||
950 | + else: | ||
951 | + self._indent() | ||
952 | + for subaction in get_subactions(): | ||
953 | + yield subaction | ||
954 | + self._dedent() | ||
955 | + | ||
956 | + def _split_lines(self, text, width): | ||
957 | + text = self._whitespace_matcher.sub(' ', text).strip() | ||
958 | + return _textwrap.wrap(text, width) | ||
959 | + | ||
960 | + def _fill_text(self, text, width, indent): | ||
961 | + text = self._whitespace_matcher.sub(' ', text).strip() | ||
962 | + return _textwrap.fill(text, width, initial_indent=indent, | ||
963 | + subsequent_indent=indent) | ||
964 | + | ||
965 | + def _get_help_string(self, action): | ||
966 | + return action.help | ||
967 | + | ||
968 | + | ||
969 | +class RawDescriptionHelpFormatter(HelpFormatter): | ||
970 | + """Help message formatter which retains any formatting in descriptions. | ||
971 | + | ||
972 | + Only the name of this class is considered a public API. All the methods | ||
973 | + provided by the class are considered an implementation detail. | ||
974 | + """ | ||
975 | + | ||
976 | + def _fill_text(self, text, width, indent): | ||
977 | + return ''.join([indent + line for line in text.splitlines(True)]) | ||
978 | + | ||
979 | + | ||
980 | +class RawTextHelpFormatter(RawDescriptionHelpFormatter): | ||
981 | + """Help message formatter which retains formatting of all help text. | ||
982 | + | ||
983 | + Only the name of this class is considered a public API. All the methods | ||
984 | + provided by the class are considered an implementation detail. | ||
985 | + """ | ||
986 | + | ||
987 | + def _split_lines(self, text, width): | ||
988 | + return text.splitlines() | ||
989 | + | ||
990 | + | ||
991 | +class ArgumentDefaultsHelpFormatter(HelpFormatter): | ||
992 | + """Help message formatter which adds default values to argument help. | ||
993 | + | ||
994 | + Only the name of this class is considered a public API. All the methods | ||
995 | + provided by the class are considered an implementation detail. | ||
996 | + """ | ||
997 | + | ||
998 | + def _get_help_string(self, action): | ||
999 | + help = action.help | ||
1000 | + if '%(default)' not in action.help: | ||
1001 | + if action.default is not SUPPRESS: | ||
1002 | + defaulting_nargs = [OPTIONAL, ZERO_OR_MORE] | ||
1003 | + if action.option_strings or action.nargs in defaulting_nargs: | ||
1004 | + help += ' (default: %(default)s)' | ||
1005 | + return help | ||
1006 | + | ||
1007 | + | ||
1008 | +# ===================== | ||
1009 | +# Options and Arguments | ||
1010 | +# ===================== | ||
1011 | + | ||
1012 | +def _get_action_name(argument): | ||
1013 | + if argument is None: | ||
1014 | + return None | ||
1015 | + elif argument.option_strings: | ||
1016 | + return '/'.join(argument.option_strings) | ||
1017 | + elif argument.metavar not in (None, SUPPRESS): | ||
1018 | + return argument.metavar | ||
1019 | + elif argument.dest not in (None, SUPPRESS): | ||
1020 | + return argument.dest | ||
1021 | + else: | ||
1022 | + return None | ||
1023 | + | ||
1024 | + | ||
1025 | +class ArgumentError(Exception): | ||
1026 | + """An error from creating or using an argument (optional or positional). | ||
1027 | + | ||
1028 | + The string value of this exception is the message, augmented with | ||
1029 | + information about the argument that caused it. | ||
1030 | + """ | ||
1031 | + | ||
1032 | + def __init__(self, argument, message): | ||
1033 | + self.argument_name = _get_action_name(argument) | ||
1034 | + self.message = message | ||
1035 | + | ||
1036 | + def __str__(self): | ||
1037 | + if self.argument_name is None: | ||
1038 | + format = '%(message)s' | ||
1039 | + else: | ||
1040 | + format = 'argument %(argument_name)s: %(message)s' | ||
1041 | + return format % dict(message=self.message, | ||
1042 | + argument_name=self.argument_name) | ||
1043 | + | ||
1044 | + | ||
1045 | +class ArgumentTypeError(Exception): | ||
1046 | + """An error from trying to convert a command line string to a type.""" | ||
1047 | + pass | ||
1048 | + | ||
1049 | + | ||
1050 | +# ============== | ||
1051 | +# Action classes | ||
1052 | +# ============== | ||
1053 | + | ||
1054 | +class Action(_AttributeHolder): | ||
1055 | + """Information about how to convert command line strings to Python objects. | ||
1056 | + | ||
1057 | + Action objects are used by an ArgumentParser to represent the information | ||
1058 | + needed to parse a single argument from one or more strings from the | ||
1059 | + command line. The keyword arguments to the Action constructor are also | ||
1060 | + all attributes of Action instances. | ||
1061 | + | ||
1062 | + Keyword Arguments: | ||
1063 | + | ||
1064 | + - option_strings -- A list of command-line option strings which | ||
1065 | + should be associated with this action. | ||
1066 | + | ||
1067 | + - dest -- The name of the attribute to hold the created object(s) | ||
1068 | + | ||
1069 | + - nargs -- The number of command-line arguments that should be | ||
1070 | + consumed. By default, one argument will be consumed and a single | ||
1071 | + value will be produced. Other values include: | ||
1072 | + - N (an integer) consumes N arguments (and produces a list) | ||
1073 | + - '?' consumes zero or one arguments | ||
1074 | + - '*' consumes zero or more arguments (and produces a list) | ||
1075 | + - '+' consumes one or more arguments (and produces a list) | ||
1076 | + Note that the difference between the default and nargs=1 is that | ||
1077 | + with the default, a single value will be produced, while with | ||
1078 | + nargs=1, a list containing a single value will be produced. | ||
1079 | + | ||
1080 | + - const -- The value to be produced if the option is specified and the | ||
1081 | + option uses an action that takes no values. | ||
1082 | + | ||
1083 | + - default -- The value to be produced if the option is not specified. | ||
1084 | + | ||
1085 | + - type -- The type which the command-line arguments should be converted | ||
1086 | + to, should be one of 'string', 'int', 'float', 'complex' or a | ||
1087 | + callable object that accepts a single string argument. If None, | ||
1088 | + 'string' is assumed. | ||
1089 | + | ||
1090 | + - choices -- A container of values that should be allowed. If not None, | ||
1091 | + after a command-line argument has been converted to the appropriate | ||
1092 | + type, an exception will be raised if it is not a member of this | ||
1093 | + collection. | ||
1094 | + | ||
1095 | + - required -- True if the action must always be specified at the | ||
1096 | + command line. This is only meaningful for optional command-line | ||
1097 | + arguments. | ||
1098 | + | ||
1099 | + - help -- The help string describing the argument. | ||
1100 | + | ||
1101 | + - metavar -- The name to be used for the option's argument with the | ||
1102 | + help string. If None, the 'dest' value will be used as the name. | ||
1103 | + """ | ||
1104 | + | ||
1105 | + def __init__(self, | ||
1106 | + option_strings, | ||
1107 | + dest, | ||
1108 | + nargs=None, | ||
1109 | + const=None, | ||
1110 | + default=None, | ||
1111 | + type=None, | ||
1112 | + choices=None, | ||
1113 | + required=False, | ||
1114 | + help=None, | ||
1115 | + metavar=None): | ||
1116 | + self.option_strings = option_strings | ||
1117 | + self.dest = dest | ||
1118 | + self.nargs = nargs | ||
1119 | + self.const = const | ||
1120 | + self.default = default | ||
1121 | + self.type = type | ||
1122 | + self.choices = choices | ||
1123 | + self.required = required | ||
1124 | + self.help = help | ||
1125 | + self.metavar = metavar | ||
1126 | + | ||
1127 | + def _get_kwargs(self): | ||
1128 | + names = [ | ||
1129 | + 'option_strings', | ||
1130 | + 'dest', | ||
1131 | + 'nargs', | ||
1132 | + 'const', | ||
1133 | + 'default', | ||
1134 | + 'type', | ||
1135 | + 'choices', | ||
1136 | + 'help', | ||
1137 | + 'metavar', | ||
1138 | + ] | ||
1139 | + return [(name, getattr(self, name)) for name in names] | ||
1140 | + | ||
1141 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1142 | + raise NotImplementedError(_('.__call__() not defined')) | ||
1143 | + | ||
1144 | + | ||
1145 | +class _StoreAction(Action): | ||
1146 | + | ||
1147 | + def __init__(self, | ||
1148 | + option_strings, | ||
1149 | + dest, | ||
1150 | + nargs=None, | ||
1151 | + const=None, | ||
1152 | + default=None, | ||
1153 | + type=None, | ||
1154 | + choices=None, | ||
1155 | + required=False, | ||
1156 | + help=None, | ||
1157 | + metavar=None): | ||
1158 | + if nargs == 0: | ||
1159 | + raise ValueError('nargs for store actions must be > 0; if you ' | ||
1160 | + 'have nothing to store, actions such as store ' | ||
1161 | + 'true or store const may be more appropriate') | ||
1162 | + if const is not None and nargs != OPTIONAL: | ||
1163 | + raise ValueError('nargs must be %r to supply const' % OPTIONAL) | ||
1164 | + super(_StoreAction, self).__init__( | ||
1165 | + option_strings=option_strings, | ||
1166 | + dest=dest, | ||
1167 | + nargs=nargs, | ||
1168 | + const=const, | ||
1169 | + default=default, | ||
1170 | + type=type, | ||
1171 | + choices=choices, | ||
1172 | + required=required, | ||
1173 | + help=help, | ||
1174 | + metavar=metavar) | ||
1175 | + | ||
1176 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1177 | + setattr(namespace, self.dest, values) | ||
1178 | + | ||
1179 | + | ||
1180 | +class _StoreConstAction(Action): | ||
1181 | + | ||
1182 | + def __init__(self, | ||
1183 | + option_strings, | ||
1184 | + dest, | ||
1185 | + const, | ||
1186 | + default=None, | ||
1187 | + required=False, | ||
1188 | + help=None, | ||
1189 | + metavar=None): | ||
1190 | + super(_StoreConstAction, self).__init__( | ||
1191 | + option_strings=option_strings, | ||
1192 | + dest=dest, | ||
1193 | + nargs=0, | ||
1194 | + const=const, | ||
1195 | + default=default, | ||
1196 | + required=required, | ||
1197 | + help=help) | ||
1198 | + | ||
1199 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1200 | + setattr(namespace, self.dest, self.const) | ||
1201 | + | ||
1202 | + | ||
1203 | +class _StoreTrueAction(_StoreConstAction): | ||
1204 | + | ||
1205 | + def __init__(self, | ||
1206 | + option_strings, | ||
1207 | + dest, | ||
1208 | + default=False, | ||
1209 | + required=False, | ||
1210 | + help=None): | ||
1211 | + super(_StoreTrueAction, self).__init__( | ||
1212 | + option_strings=option_strings, | ||
1213 | + dest=dest, | ||
1214 | + const=True, | ||
1215 | + default=default, | ||
1216 | + required=required, | ||
1217 | + help=help) | ||
1218 | + | ||
1219 | + | ||
1220 | +class _StoreFalseAction(_StoreConstAction): | ||
1221 | + | ||
1222 | + def __init__(self, | ||
1223 | + option_strings, | ||
1224 | + dest, | ||
1225 | + default=True, | ||
1226 | + required=False, | ||
1227 | + help=None): | ||
1228 | + super(_StoreFalseAction, self).__init__( | ||
1229 | + option_strings=option_strings, | ||
1230 | + dest=dest, | ||
1231 | + const=False, | ||
1232 | + default=default, | ||
1233 | + required=required, | ||
1234 | + help=help) | ||
1235 | + | ||
1236 | + | ||
1237 | +class _AppendAction(Action): | ||
1238 | + | ||
1239 | + def __init__(self, | ||
1240 | + option_strings, | ||
1241 | + dest, | ||
1242 | + nargs=None, | ||
1243 | + const=None, | ||
1244 | + default=None, | ||
1245 | + type=None, | ||
1246 | + choices=None, | ||
1247 | + required=False, | ||
1248 | + help=None, | ||
1249 | + metavar=None): | ||
1250 | + if nargs == 0: | ||
1251 | + raise ValueError('nargs for append actions must be > 0; if arg ' | ||
1252 | + 'strings are not supplying the value to append, ' | ||
1253 | + 'the append const action may be more appropriate') | ||
1254 | + if const is not None and nargs != OPTIONAL: | ||
1255 | + raise ValueError('nargs must be %r to supply const' % OPTIONAL) | ||
1256 | + super(_AppendAction, self).__init__( | ||
1257 | + option_strings=option_strings, | ||
1258 | + dest=dest, | ||
1259 | + nargs=nargs, | ||
1260 | + const=const, | ||
1261 | + default=default, | ||
1262 | + type=type, | ||
1263 | + choices=choices, | ||
1264 | + required=required, | ||
1265 | + help=help, | ||
1266 | + metavar=metavar) | ||
1267 | + | ||
1268 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1269 | + items = _copy.copy(_ensure_value(namespace, self.dest, [])) | ||
1270 | + items.append(values) | ||
1271 | + setattr(namespace, self.dest, items) | ||
1272 | + | ||
1273 | + | ||
1274 | +class _AppendConstAction(Action): | ||
1275 | + | ||
1276 | + def __init__(self, | ||
1277 | + option_strings, | ||
1278 | + dest, | ||
1279 | + const, | ||
1280 | + default=None, | ||
1281 | + required=False, | ||
1282 | + help=None, | ||
1283 | + metavar=None): | ||
1284 | + super(_AppendConstAction, self).__init__( | ||
1285 | + option_strings=option_strings, | ||
1286 | + dest=dest, | ||
1287 | + nargs=0, | ||
1288 | + const=const, | ||
1289 | + default=default, | ||
1290 | + required=required, | ||
1291 | + help=help, | ||
1292 | + metavar=metavar) | ||
1293 | + | ||
1294 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1295 | + items = _copy.copy(_ensure_value(namespace, self.dest, [])) | ||
1296 | + items.append(self.const) | ||
1297 | + setattr(namespace, self.dest, items) | ||
1298 | + | ||
1299 | + | ||
1300 | +class _CountAction(Action): | ||
1301 | + | ||
1302 | + def __init__(self, | ||
1303 | + option_strings, | ||
1304 | + dest, | ||
1305 | + default=None, | ||
1306 | + required=False, | ||
1307 | + help=None): | ||
1308 | + super(_CountAction, self).__init__( | ||
1309 | + option_strings=option_strings, | ||
1310 | + dest=dest, | ||
1311 | + nargs=0, | ||
1312 | + default=default, | ||
1313 | + required=required, | ||
1314 | + help=help) | ||
1315 | + | ||
1316 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1317 | + new_count = _ensure_value(namespace, self.dest, 0) + 1 | ||
1318 | + setattr(namespace, self.dest, new_count) | ||
1319 | + | ||
1320 | + | ||
1321 | +class _HelpAction(Action): | ||
1322 | + | ||
1323 | + def __init__(self, | ||
1324 | + option_strings, | ||
1325 | + dest=SUPPRESS, | ||
1326 | + default=SUPPRESS, | ||
1327 | + help=None): | ||
1328 | + super(_HelpAction, self).__init__( | ||
1329 | + option_strings=option_strings, | ||
1330 | + dest=dest, | ||
1331 | + default=default, | ||
1332 | + nargs=0, | ||
1333 | + help=help) | ||
1334 | + | ||
1335 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1336 | + parser.print_help() | ||
1337 | + parser.exit() | ||
1338 | + | ||
1339 | + | ||
1340 | +class _VersionAction(Action): | ||
1341 | + | ||
1342 | + def __init__(self, | ||
1343 | + option_strings, | ||
1344 | + version=None, | ||
1345 | + dest=SUPPRESS, | ||
1346 | + default=SUPPRESS, | ||
1347 | + help="show program's version number and exit"): | ||
1348 | + super(_VersionAction, self).__init__( | ||
1349 | + option_strings=option_strings, | ||
1350 | + dest=dest, | ||
1351 | + default=default, | ||
1352 | + nargs=0, | ||
1353 | + help=help) | ||
1354 | + self.version = version | ||
1355 | + | ||
1356 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1357 | + version = self.version | ||
1358 | + if version is None: | ||
1359 | + version = parser.version | ||
1360 | + formatter = parser._get_formatter() | ||
1361 | + formatter.add_text(version) | ||
1362 | + parser.exit(message=formatter.format_help()) | ||
1363 | + | ||
1364 | + | ||
1365 | +class _SubParsersAction(Action): | ||
1366 | + | ||
1367 | + class _ChoicesPseudoAction(Action): | ||
1368 | + | ||
1369 | + def __init__(self, name, aliases, help): | ||
1370 | + metavar = dest = name | ||
1371 | + if aliases: | ||
1372 | + metavar += ' (%s)' % ', '.join(aliases) | ||
1373 | + sup = super(_SubParsersAction._ChoicesPseudoAction, self) | ||
1374 | + sup.__init__(option_strings=[], dest=dest, help=help, | ||
1375 | + metavar=metavar) | ||
1376 | + | ||
1377 | + def __init__(self, | ||
1378 | + option_strings, | ||
1379 | + prog, | ||
1380 | + parser_class, | ||
1381 | + dest=SUPPRESS, | ||
1382 | + help=None, | ||
1383 | + metavar=None): | ||
1384 | + | ||
1385 | + self._prog_prefix = prog | ||
1386 | + self._parser_class = parser_class | ||
1387 | + self._name_parser_map = {} | ||
1388 | + self._choices_actions = [] | ||
1389 | + | ||
1390 | + super(_SubParsersAction, self).__init__( | ||
1391 | + option_strings=option_strings, | ||
1392 | + dest=dest, | ||
1393 | + nargs=PARSER, | ||
1394 | + choices=self._name_parser_map, | ||
1395 | + help=help, | ||
1396 | + metavar=metavar) | ||
1397 | + | ||
1398 | + def add_parser(self, name, **kwargs): | ||
1399 | + # set prog from the existing prefix | ||
1400 | + if kwargs.get('prog') is None: | ||
1401 | + kwargs['prog'] = '%s %s' % (self._prog_prefix, name) | ||
1402 | + | ||
1403 | + aliases = kwargs.pop('aliases', ()) | ||
1404 | + | ||
1405 | + # create a pseudo-action to hold the choice help | ||
1406 | + if 'help' in kwargs: | ||
1407 | + help = kwargs.pop('help') | ||
1408 | + choice_action = self._ChoicesPseudoAction(name, aliases, help) | ||
1409 | + self._choices_actions.append(choice_action) | ||
1410 | + | ||
1411 | + # create the parser and add it to the map | ||
1412 | + parser = self._parser_class(**kwargs) | ||
1413 | + self._name_parser_map[name] = parser | ||
1414 | + | ||
1415 | + # make parser available under aliases also | ||
1416 | + for alias in aliases: | ||
1417 | + self._name_parser_map[alias] = parser | ||
1418 | + | ||
1419 | + return parser | ||
1420 | + | ||
1421 | + def _get_subactions(self): | ||
1422 | + return self._choices_actions | ||
1423 | + | ||
1424 | + def __call__(self, parser, namespace, values, option_string=None): | ||
1425 | + parser_name = values[0] | ||
1426 | + arg_strings = values[1:] | ||
1427 | + | ||
1428 | + # set the parser name if requested | ||
1429 | + if self.dest is not SUPPRESS: | ||
1430 | + setattr(namespace, self.dest, parser_name) | ||
1431 | + | ||
1432 | + # select the parser | ||
1433 | + try: | ||
1434 | + parser = self._name_parser_map[parser_name] | ||
1435 | + except KeyError: | ||
1436 | + tup = parser_name, ', '.join(self._name_parser_map) | ||
1437 | + msg = _('unknown parser %r (choices: %s)' % tup) | ||
1438 | + raise ArgumentError(self, msg) | ||
1439 | + | ||
1440 | + # parse all the remaining options into the namespace | ||
1441 | + # store any unrecognized options on the object, so that the top | ||
1442 | + # level parser can decide what to do with them | ||
1443 | + namespace, arg_strings = parser.parse_known_args(arg_strings, namespace) | ||
1444 | + if arg_strings: | ||
1445 | + vars(namespace).setdefault(_UNRECOGNIZED_ARGS_ATTR, []) | ||
1446 | + getattr(namespace, _UNRECOGNIZED_ARGS_ATTR).extend(arg_strings) | ||
1447 | + | ||
1448 | + | ||
1449 | +# ============== | ||
1450 | +# Type classes | ||
1451 | +# ============== | ||
1452 | + | ||
1453 | +class FileType(object): | ||
1454 | + """Factory for creating file object types | ||
1455 | + | ||
1456 | + Instances of FileType are typically passed as type= arguments to the | ||
1457 | + ArgumentParser add_argument() method. | ||
1458 | + | ||
1459 | + Keyword Arguments: | ||
1460 | + - mode -- A string indicating how the file is to be opened. Accepts the | ||
1461 | + same values as the builtin open() function. | ||
1462 | + - bufsize -- The file's desired buffer size. Accepts the same values as | ||
1463 | + the builtin open() function. | ||
1464 | + """ | ||
1465 | + | ||
1466 | + def __init__(self, mode='r', bufsize=None): | ||
1467 | + self._mode = mode | ||
1468 | + self._bufsize = bufsize | ||
1469 | + | ||
1470 | + def __call__(self, string): | ||
1471 | + # the special argument "-" means sys.std{in,out} | ||
1472 | + if string == '-': | ||
1473 | + if 'r' in self._mode: | ||
1474 | + return _sys.stdin | ||
1475 | + elif 'w' in self._mode: | ||
1476 | + return _sys.stdout | ||
1477 | + else: | ||
1478 | + msg = _('argument "-" with mode %r' % self._mode) | ||
1479 | + raise ValueError(msg) | ||
1480 | + | ||
1481 | + try: | ||
1482 | + # all other arguments are used as file names | ||
1483 | + if self._bufsize: | ||
1484 | + return open(string, self._mode, self._bufsize) | ||
1485 | + else: | ||
1486 | + return open(string, self._mode) | ||
1487 | + except IOError: | ||
1488 | + err = _sys.exc_info()[1] | ||
1489 | + message = _("can't open '%s': %s") | ||
1490 | + raise ArgumentTypeError(message % (string, err)) | ||
1491 | + | ||
1492 | + def __repr__(self): | ||
1493 | + args = [self._mode, self._bufsize] | ||
1494 | + args_str = ', '.join([repr(arg) for arg in args if arg is not None]) | ||
1495 | + return '%s(%s)' % (type(self).__name__, args_str) | ||
1496 | + | ||
1497 | +# =========================== | ||
1498 | +# Optional and Positional Parsing | ||
1499 | +# =========================== | ||
1500 | + | ||
1501 | +class Namespace(_AttributeHolder): | ||
1502 | + """Simple object for storing attributes. | ||
1503 | + | ||
1504 | + Implements equality by attribute names and values, and provides a simple | ||
1505 | + string representation. | ||
1506 | + """ | ||
1507 | + | ||
1508 | + def __init__(self, **kwargs): | ||
1509 | + for name in kwargs: | ||
1510 | + setattr(self, name, kwargs[name]) | ||
1511 | + | ||
1512 | + __hash__ = None | ||
1513 | + | ||
1514 | + def __eq__(self, other): | ||
1515 | + return vars(self) == vars(other) | ||
1516 | + | ||
1517 | + def __ne__(self, other): | ||
1518 | + return not (self == other) | ||
1519 | + | ||
1520 | + def __contains__(self, key): | ||
1521 | + return key in self.__dict__ | ||
1522 | + | ||
1523 | + | ||
1524 | +class _ActionsContainer(object): | ||
1525 | + | ||
1526 | + def __init__(self, | ||
1527 | + description, | ||
1528 | + prefix_chars, | ||
1529 | + argument_default, | ||
1530 | + conflict_handler): | ||
1531 | + super(_ActionsContainer, self).__init__() | ||
1532 | + | ||
1533 | + self.description = description | ||
1534 | + self.argument_default = argument_default | ||
1535 | + self.prefix_chars = prefix_chars | ||
1536 | + self.conflict_handler = conflict_handler | ||
1537 | + | ||
1538 | + # set up registries | ||
1539 | + self._registries = {} | ||
1540 | + | ||
1541 | + # register actions | ||
1542 | + self.register('action', None, _StoreAction) | ||
1543 | + self.register('action', 'store', _StoreAction) | ||
1544 | + self.register('action', 'store_const', _StoreConstAction) | ||
1545 | + self.register('action', 'store_true', _StoreTrueAction) | ||
1546 | + self.register('action', 'store_false', _StoreFalseAction) | ||
1547 | + self.register('action', 'append', _AppendAction) | ||
1548 | + self.register('action', 'append_const', _AppendConstAction) | ||
1549 | + self.register('action', 'count', _CountAction) | ||
1550 | + self.register('action', 'help', _HelpAction) | ||
1551 | + self.register('action', 'version', _VersionAction) | ||
1552 | + self.register('action', 'parsers', _SubParsersAction) | ||
1553 | + | ||
1554 | + # raise an exception if the conflict handler is invalid | ||
1555 | + self._get_handler() | ||
1556 | + | ||
1557 | + # action storage | ||
1558 | + self._actions = [] | ||
1559 | + self._option_string_actions = {} | ||
1560 | + | ||
1561 | + # groups | ||
1562 | + self._action_groups = [] | ||
1563 | + self._mutually_exclusive_groups = [] | ||
1564 | + | ||
1565 | + # defaults storage | ||
1566 | + self._defaults = {} | ||
1567 | + | ||
1568 | + # determines whether an "option" looks like a negative number | ||
1569 | + self._negative_number_matcher = _re.compile(r'^-\d+$|^-\d*\.\d+$') | ||
1570 | + | ||
1571 | + # whether or not there are any optionals that look like negative | ||
1572 | + # numbers -- uses a list so it can be shared and edited | ||
1573 | + self._has_negative_number_optionals = [] | ||
1574 | + | ||
1575 | + # ==================== | ||
1576 | + # Registration methods | ||
1577 | + # ==================== | ||
1578 | + def register(self, registry_name, value, object): | ||
1579 | + registry = self._registries.setdefault(registry_name, {}) | ||
1580 | + registry[value] = object | ||
1581 | + | ||
1582 | + def _registry_get(self, registry_name, value, default=None): | ||
1583 | + return self._registries[registry_name].get(value, default) | ||
1584 | + | ||
1585 | + # ================================== | ||
1586 | + # Namespace default accessor methods | ||
1587 | + # ================================== | ||
1588 | + def set_defaults(self, **kwargs): | ||
1589 | + self._defaults.update(kwargs) | ||
1590 | + | ||
1591 | + # if these defaults match any existing arguments, replace | ||
1592 | + # the previous default on the object with the new one | ||
1593 | + for action in self._actions: | ||
1594 | + if action.dest in kwargs: | ||
1595 | + action.default = kwargs[action.dest] | ||
1596 | + | ||
1597 | + def get_default(self, dest): | ||
1598 | + for action in self._actions: | ||
1599 | + if action.dest == dest and action.default is not None: | ||
1600 | + return action.default | ||
1601 | + return self._defaults.get(dest, None) | ||
1602 | + | ||
1603 | + | ||
1604 | + # ======================= | ||
1605 | + # Adding argument actions | ||
1606 | + # ======================= | ||
1607 | + def add_argument(self, *args, **kwargs): | ||
1608 | + """ | ||
1609 | + add_argument(dest, ..., name=value, ...) | ||
1610 | + add_argument(option_string, option_string, ..., name=value, ...) | ||
1611 | + """ | ||
1612 | + | ||
1613 | + # if no positional args are supplied or only one is supplied and | ||
1614 | + # it doesn't look like an option string, parse a positional | ||
1615 | + # argument | ||
1616 | + chars = self.prefix_chars | ||
1617 | + if not args or len(args) == 1 and args[0][0] not in chars: | ||
1618 | + if args and 'dest' in kwargs: | ||
1619 | + raise ValueError('dest supplied twice for positional argument') | ||
1620 | + kwargs = self._get_positional_kwargs(*args, **kwargs) | ||
1621 | + | ||
1622 | + # otherwise, we're adding an optional argument | ||
1623 | + else: | ||
1624 | + kwargs = self._get_optional_kwargs(*args, **kwargs) | ||
1625 | + | ||
1626 | + # if no default was supplied, use the parser-level default | ||
1627 | + if 'default' not in kwargs: | ||
1628 | + dest = kwargs['dest'] | ||
1629 | + if dest in self._defaults: | ||
1630 | + kwargs['default'] = self._defaults[dest] | ||
1631 | + elif self.argument_default is not None: | ||
1632 | + kwargs['default'] = self.argument_default | ||
1633 | + | ||
1634 | + # create the action object, and add it to the parser | ||
1635 | + action_class = self._pop_action_class(kwargs) | ||
1636 | + if not _callable(action_class): | ||
1637 | + raise ValueError('unknown action "%s"' % action_class) | ||
1638 | + action = action_class(**kwargs) | ||
1639 | + | ||
1640 | + # raise an error if the action type is not callable | ||
1641 | + type_func = self._registry_get('type', action.type, action.type) | ||
1642 | + if not _callable(type_func): | ||
1643 | + raise ValueError('%r is not callable' % type_func) | ||
1644 | + | ||
1645 | + return self._add_action(action) | ||
1646 | + | ||
1647 | + def add_argument_group(self, *args, **kwargs): | ||
1648 | + group = _ArgumentGroup(self, *args, **kwargs) | ||
1649 | + self._action_groups.append(group) | ||
1650 | + return group | ||
1651 | + | ||
1652 | + def add_mutually_exclusive_group(self, **kwargs): | ||
1653 | + group = _MutuallyExclusiveGroup(self, **kwargs) | ||
1654 | + self._mutually_exclusive_groups.append(group) | ||
1655 | + return group | ||
1656 | + | ||
1657 | + def _add_action(self, action): | ||
1658 | + # resolve any conflicts | ||
1659 | + self._check_conflict(action) | ||
1660 | + | ||
1661 | + # add to actions list | ||
1662 | + self._actions.append(action) | ||
1663 | + action.container = self | ||
1664 | + | ||
1665 | + # index the action by any option strings it has | ||
1666 | + for option_string in action.option_strings: | ||
1667 | + self._option_string_actions[option_string] = action | ||
1668 | + | ||
1669 | + # set the flag if any option strings look like negative numbers | ||
1670 | + for option_string in action.option_strings: | ||
1671 | + if self._negative_number_matcher.match(option_string): | ||
1672 | + if not self._has_negative_number_optionals: | ||
1673 | + self._has_negative_number_optionals.append(True) | ||
1674 | + | ||
1675 | + # return the created action | ||
1676 | + return action | ||
1677 | + | ||
1678 | + def _remove_action(self, action): | ||
1679 | + self._actions.remove(action) | ||
1680 | + | ||
1681 | + def _add_container_actions(self, container): | ||
1682 | + # collect groups by titles | ||
1683 | + title_group_map = {} | ||
1684 | + for group in self._action_groups: | ||
1685 | + if group.title in title_group_map: | ||
1686 | + msg = _('cannot merge actions - two groups are named %r') | ||
1687 | + raise ValueError(msg % (group.title)) | ||
1688 | + title_group_map[group.title] = group | ||
1689 | + | ||
1690 | + # map each action to its group | ||
1691 | + group_map = {} | ||
1692 | + for group in container._action_groups: | ||
1693 | + | ||
1694 | + # if a group with the title exists, use that, otherwise | ||
1695 | + # create a new group matching the container's group | ||
1696 | + if group.title not in title_group_map: | ||
1697 | + title_group_map[group.title] = self.add_argument_group( | ||
1698 | + title=group.title, | ||
1699 | + description=group.description, | ||
1700 | + conflict_handler=group.conflict_handler) | ||
1701 | + | ||
1702 | + # map the actions to their new group | ||
1703 | + for action in group._group_actions: | ||
1704 | + group_map[action] = title_group_map[group.title] | ||
1705 | + | ||
1706 | + # add container's mutually exclusive groups | ||
1707 | + # NOTE: if add_mutually_exclusive_group ever gains title= and | ||
1708 | + # description= then this code will need to be expanded as above | ||
1709 | + for group in container._mutually_exclusive_groups: | ||
1710 | + mutex_group = self.add_mutually_exclusive_group( | ||
1711 | + required=group.required) | ||
1712 | + | ||
1713 | + # map the actions to their new mutex group | ||
1714 | + for action in group._group_actions: | ||
1715 | + group_map[action] = mutex_group | ||
1716 | + | ||
1717 | + # add all actions to this container or their group | ||
1718 | + for action in container._actions: | ||
1719 | + group_map.get(action, self)._add_action(action) | ||
1720 | + | ||
1721 | + def _get_positional_kwargs(self, dest, **kwargs): | ||
1722 | + # make sure required is not specified | ||
1723 | + if 'required' in kwargs: | ||
1724 | + msg = _("'required' is an invalid argument for positionals") | ||
1725 | + raise TypeError(msg) | ||
1726 | + | ||
1727 | + # mark positional arguments as required if at least one is | ||
1728 | + # always required | ||
1729 | + if kwargs.get('nargs') not in [OPTIONAL, ZERO_OR_MORE]: | ||
1730 | + kwargs['required'] = True | ||
1731 | + if kwargs.get('nargs') == ZERO_OR_MORE and 'default' not in kwargs: | ||
1732 | + kwargs['required'] = True | ||
1733 | + | ||
1734 | + # return the keyword arguments with no option strings | ||
1735 | + return dict(kwargs, dest=dest, option_strings=[]) | ||
1736 | + | ||
1737 | + def _get_optional_kwargs(self, *args, **kwargs): | ||
1738 | + # determine short and long option strings | ||
1739 | + option_strings = [] | ||
1740 | + long_option_strings = [] | ||
1741 | + for option_string in args: | ||
1742 | + # error on strings that don't start with an appropriate prefix | ||
1743 | + if not option_string[0] in self.prefix_chars: | ||
1744 | + msg = _('invalid option string %r: ' | ||
1745 | + 'must start with a character %r') | ||
1746 | + tup = option_string, self.prefix_chars | ||
1747 | + raise ValueError(msg % tup) | ||
1748 | + | ||
1749 | + # strings starting with two prefix characters are long options | ||
1750 | + option_strings.append(option_string) | ||
1751 | + if option_string[0] in self.prefix_chars: | ||
1752 | + if len(option_string) > 1: | ||
1753 | + if option_string[1] in self.prefix_chars: | ||
1754 | + long_option_strings.append(option_string) | ||
1755 | + | ||
1756 | + # infer destination, '--foo-bar' -> 'foo_bar' and '-x' -> 'x' | ||
1757 | + dest = kwargs.pop('dest', None) | ||
1758 | + if dest is None: | ||
1759 | + if long_option_strings: | ||
1760 | + dest_option_string = long_option_strings[0] | ||
1761 | + else: | ||
1762 | + dest_option_string = option_strings[0] | ||
1763 | + dest = dest_option_string.lstrip(self.prefix_chars) | ||
1764 | + if not dest: | ||
1765 | + msg = _('dest= is required for options like %r') | ||
1766 | + raise ValueError(msg % option_string) | ||
1767 | + dest = dest.replace('-', '_') | ||
1768 | + | ||
1769 | + # return the updated keyword arguments | ||
1770 | + return dict(kwargs, dest=dest, option_strings=option_strings) | ||
1771 | + | ||
1772 | + def _pop_action_class(self, kwargs, default=None): | ||
1773 | + action = kwargs.pop('action', default) | ||
1774 | + return self._registry_get('action', action, action) | ||
1775 | + | ||
1776 | + def _get_handler(self): | ||
1777 | + # determine function from conflict handler string | ||
1778 | + handler_func_name = '_handle_conflict_%s' % self.conflict_handler | ||
1779 | + try: | ||
1780 | + return getattr(self, handler_func_name) | ||
1781 | + except AttributeError: | ||
1782 | + msg = _('invalid conflict_resolution value: %r') | ||
1783 | + raise ValueError(msg % self.conflict_handler) | ||
1784 | + | ||
1785 | + def _check_conflict(self, action): | ||
1786 | + | ||
1787 | + # find all options that conflict with this option | ||
1788 | + confl_optionals = [] | ||
1789 | + for option_string in action.option_strings: | ||
1790 | + if option_string in self._option_string_actions: | ||
1791 | + confl_optional = self._option_string_actions[option_string] | ||
1792 | + confl_optionals.append((option_string, confl_optional)) | ||
1793 | + | ||
1794 | + # resolve any conflicts | ||
1795 | + if confl_optionals: | ||
1796 | + conflict_handler = self._get_handler() | ||
1797 | + conflict_handler(action, confl_optionals) | ||
1798 | + | ||
1799 | + def _handle_conflict_error(self, action, conflicting_actions): | ||
1800 | + message = _('conflicting option string(s): %s') | ||
1801 | + conflict_string = ', '.join([option_string | ||
1802 | + for option_string, action | ||
1803 | + in conflicting_actions]) | ||
1804 | + raise ArgumentError(action, message % conflict_string) | ||
1805 | + | ||
1806 | + def _handle_conflict_resolve(self, action, conflicting_actions): | ||
1807 | + | ||
1808 | + # remove all conflicting options | ||
1809 | + for option_string, action in conflicting_actions: | ||
1810 | + | ||
1811 | + # remove the conflicting option | ||
1812 | + action.option_strings.remove(option_string) | ||
1813 | + self._option_string_actions.pop(option_string, None) | ||
1814 | + | ||
1815 | + # if the option now has no option string, remove it from the | ||
1816 | + # container holding it | ||
1817 | + if not action.option_strings: | ||
1818 | + action.container._remove_action(action) | ||
1819 | + | ||
1820 | + | ||
1821 | +class _ArgumentGroup(_ActionsContainer): | ||
1822 | + | ||
1823 | + def __init__(self, container, title=None, description=None, **kwargs): | ||
1824 | + # add any missing keyword arguments by checking the container | ||
1825 | + update = kwargs.setdefault | ||
1826 | + update('conflict_handler', container.conflict_handler) | ||
1827 | + update('prefix_chars', container.prefix_chars) | ||
1828 | + update('argument_default', container.argument_default) | ||
1829 | + super_init = super(_ArgumentGroup, self).__init__ | ||
1830 | + super_init(description=description, **kwargs) | ||
1831 | + | ||
1832 | + # group attributes | ||
1833 | + self.title = title | ||
1834 | + self._group_actions = [] | ||
1835 | + | ||
1836 | + # share most attributes with the container | ||
1837 | + self._registries = container._registries | ||
1838 | + self._actions = container._actions | ||
1839 | + self._option_string_actions = container._option_string_actions | ||
1840 | + self._defaults = container._defaults | ||
1841 | + self._has_negative_number_optionals = \ | ||
1842 | + container._has_negative_number_optionals | ||
1843 | + | ||
1844 | + def _add_action(self, action): | ||
1845 | + action = super(_ArgumentGroup, self)._add_action(action) | ||
1846 | + self._group_actions.append(action) | ||
1847 | + return action | ||
1848 | + | ||
1849 | + def _remove_action(self, action): | ||
1850 | + super(_ArgumentGroup, self)._remove_action(action) | ||
1851 | + self._group_actions.remove(action) | ||
1852 | + | ||
1853 | + | ||
1854 | +class _MutuallyExclusiveGroup(_ArgumentGroup): | ||
1855 | + | ||
1856 | + def __init__(self, container, required=False): | ||
1857 | + super(_MutuallyExclusiveGroup, self).__init__(container) | ||
1858 | + self.required = required | ||
1859 | + self._container = container | ||
1860 | + | ||
1861 | + def _add_action(self, action): | ||
1862 | + if action.required: | ||
1863 | + msg = _('mutually exclusive arguments must be optional') | ||
1864 | + raise ValueError(msg) | ||
1865 | + action = self._container._add_action(action) | ||
1866 | + self._group_actions.append(action) | ||
1867 | + return action | ||
1868 | + | ||
1869 | + def _remove_action(self, action): | ||
1870 | + self._container._remove_action(action) | ||
1871 | + self._group_actions.remove(action) | ||
1872 | + | ||
1873 | + | ||
1874 | +class ArgumentParser(_AttributeHolder, _ActionsContainer): | ||
1875 | + """Object for parsing command line strings into Python objects. | ||
1876 | + | ||
1877 | + Keyword Arguments: | ||
1878 | + - prog -- The name of the program (default: sys.argv[0]) | ||
1879 | + - usage -- A usage message (default: auto-generated from arguments) | ||
1880 | + - description -- A description of what the program does | ||
1881 | + - epilog -- Text following the argument descriptions | ||
1882 | + - parents -- Parsers whose arguments should be copied into this one | ||
1883 | + - formatter_class -- HelpFormatter class for printing help messages | ||
1884 | + - prefix_chars -- Characters that prefix optional arguments | ||
1885 | + - fromfile_prefix_chars -- Characters that prefix files containing | ||
1886 | + additional arguments | ||
1887 | + - argument_default -- The default value for all arguments | ||
1888 | + - conflict_handler -- String indicating how to handle conflicts | ||
1889 | + - add_help -- Add a -h/-help option | ||
1890 | + """ | ||
1891 | + | ||
1892 | + def __init__(self, | ||
1893 | + prog=None, | ||
1894 | + usage=None, | ||
1895 | + description=None, | ||
1896 | + epilog=None, | ||
1897 | + version=None, | ||
1898 | + parents=[], | ||
1899 | + formatter_class=HelpFormatter, | ||
1900 | + prefix_chars='-', | ||
1901 | + fromfile_prefix_chars=None, | ||
1902 | + argument_default=None, | ||
1903 | + conflict_handler='error', | ||
1904 | + add_help=True): | ||
1905 | + | ||
1906 | + if version is not None: | ||
1907 | + import warnings | ||
1908 | + warnings.warn( | ||
1909 | + """The "version" argument to ArgumentParser is deprecated. """ | ||
1910 | + """Please use """ | ||
1911 | + """"add_argument(..., action='version', version="N", ...)" """ | ||
1912 | + """instead""", DeprecationWarning) | ||
1913 | + | ||
1914 | + superinit = super(ArgumentParser, self).__init__ | ||
1915 | + superinit(description=description, | ||
1916 | + prefix_chars=prefix_chars, | ||
1917 | + argument_default=argument_default, | ||
1918 | + conflict_handler=conflict_handler) | ||
1919 | + | ||
1920 | + # default setting for prog | ||
1921 | + if prog is None: | ||
1922 | + prog = _os.path.basename(_sys.argv[0]) | ||
1923 | + | ||
1924 | + self.prog = prog | ||
1925 | + self.usage = usage | ||
1926 | + self.epilog = epilog | ||
1927 | + self.version = version | ||
1928 | + self.formatter_class = formatter_class | ||
1929 | + self.fromfile_prefix_chars = fromfile_prefix_chars | ||
1930 | + self.add_help = add_help | ||
1931 | + | ||
1932 | + add_group = self.add_argument_group | ||
1933 | + self._positionals = add_group(_('positional arguments')) | ||
1934 | + self._optionals = add_group(_('optional arguments')) | ||
1935 | + self._subparsers = None | ||
1936 | + | ||
1937 | + # register types | ||
1938 | + def identity(string): | ||
1939 | + return string | ||
1940 | + self.register('type', None, identity) | ||
1941 | + | ||
1942 | + # add help and version arguments if necessary | ||
1943 | + # (using explicit default to override global argument_default) | ||
1944 | + if '-' in prefix_chars: | ||
1945 | + default_prefix = '-' | ||
1946 | + else: | ||
1947 | + default_prefix = prefix_chars[0] | ||
1948 | + if self.add_help: | ||
1949 | + self.add_argument( | ||
1950 | + default_prefix+'h', default_prefix*2+'help', | ||
1951 | + action='help', default=SUPPRESS, | ||
1952 | + help=_('show this help message and exit')) | ||
1953 | + if self.version: | ||
1954 | + self.add_argument( | ||
1955 | + default_prefix+'v', default_prefix*2+'version', | ||
1956 | + action='version', default=SUPPRESS, | ||
1957 | + version=self.version, | ||
1958 | + help=_("show program's version number and exit")) | ||
1959 | + | ||
1960 | + # add parent arguments and defaults | ||
1961 | + for parent in parents: | ||
1962 | + self._add_container_actions(parent) | ||
1963 | + try: | ||
1964 | + defaults = parent._defaults | ||
1965 | + except AttributeError: | ||
1966 | + pass | ||
1967 | + else: | ||
1968 | + self._defaults.update(defaults) | ||
1969 | + | ||
1970 | + # ======================= | ||
1971 | + # Pretty __repr__ methods | ||
1972 | + # ======================= | ||
1973 | + def _get_kwargs(self): | ||
1974 | + names = [ | ||
1975 | + 'prog', | ||
1976 | + 'usage', | ||
1977 | + 'description', | ||
1978 | + 'version', | ||
1979 | + 'formatter_class', | ||
1980 | + 'conflict_handler', | ||
1981 | + 'add_help', | ||
1982 | + ] | ||
1983 | + return [(name, getattr(self, name)) for name in names] | ||
1984 | + | ||
1985 | + # ================================== | ||
1986 | + # Optional/Positional adding methods | ||
1987 | + # ================================== | ||
1988 | + def add_subparsers(self, **kwargs): | ||
1989 | + if self._subparsers is not None: | ||
1990 | + self.error(_('cannot have multiple subparser arguments')) | ||
1991 | + | ||
1992 | + # add the parser class to the arguments if it's not present | ||
1993 | + kwargs.setdefault('parser_class', type(self)) | ||
1994 | + | ||
1995 | + if 'title' in kwargs or 'description' in kwargs: | ||
1996 | + title = _(kwargs.pop('title', 'subcommands')) | ||
1997 | + description = _(kwargs.pop('description', None)) | ||
1998 | + self._subparsers = self.add_argument_group(title, description) | ||
1999 | + else: | ||
2000 | + self._subparsers = self._positionals | ||
2001 | + | ||
2002 | + # prog defaults to the usage message of this parser, skipping | ||
2003 | + # optional arguments and with no "usage:" prefix | ||
2004 | + if kwargs.get('prog') is None: | ||
2005 | + formatter = self._get_formatter() | ||
2006 | + positionals = self._get_positional_actions() | ||
2007 | + groups = self._mutually_exclusive_groups | ||
2008 | + formatter.add_usage(self.usage, positionals, groups, '') | ||
2009 | + kwargs['prog'] = formatter.format_help().strip() | ||
2010 | + | ||
2011 | + # create the parsers action and add it to the positionals list | ||
2012 | + parsers_class = self._pop_action_class(kwargs, 'parsers') | ||
2013 | + action = parsers_class(option_strings=[], **kwargs) | ||
2014 | + self._subparsers._add_action(action) | ||
2015 | + | ||
2016 | + # return the created parsers action | ||
2017 | + return action | ||
2018 | + | ||
2019 | + def _add_action(self, action): | ||
2020 | + if action.option_strings: | ||
2021 | + self._optionals._add_action(action) | ||
2022 | + else: | ||
2023 | + self._positionals._add_action(action) | ||
2024 | + return action | ||
2025 | + | ||
2026 | + def _get_optional_actions(self): | ||
2027 | + return [action | ||
2028 | + for action in self._actions | ||
2029 | + if action.option_strings] | ||
2030 | + | ||
2031 | + def _get_positional_actions(self): | ||
2032 | + return [action | ||
2033 | + for action in self._actions | ||
2034 | + if not action.option_strings] | ||
2035 | + | ||
2036 | + # ===================================== | ||
2037 | + # Command line argument parsing methods | ||
2038 | + # ===================================== | ||
2039 | + def parse_args(self, args=None, namespace=None): | ||
2040 | + args, argv = self.parse_known_args(args, namespace) | ||
2041 | + if argv: | ||
2042 | + msg = _('unrecognized arguments: %s') | ||
2043 | + self.error(msg % ' '.join(argv)) | ||
2044 | + return args | ||
2045 | + | ||
2046 | + def parse_known_args(self, args=None, namespace=None): | ||
2047 | + # args default to the system args | ||
2048 | + if args is None: | ||
2049 | + args = _sys.argv[1:] | ||
2050 | + | ||
2051 | + # default Namespace built from parser defaults | ||
2052 | + if namespace is None: | ||
2053 | + namespace = Namespace() | ||
2054 | + | ||
2055 | + # add any action defaults that aren't present | ||
2056 | + for action in self._actions: | ||
2057 | + if action.dest is not SUPPRESS: | ||
2058 | + if not hasattr(namespace, action.dest): | ||
2059 | + if action.default is not SUPPRESS: | ||
2060 | + setattr(namespace, action.dest, action.default) | ||
2061 | + | ||
2062 | + # add any parser defaults that aren't present | ||
2063 | + for dest in self._defaults: | ||
2064 | + if not hasattr(namespace, dest): | ||
2065 | + setattr(namespace, dest, self._defaults[dest]) | ||
2066 | + | ||
2067 | + # parse the arguments and exit if there are any errors | ||
2068 | + try: | ||
2069 | + namespace, args = self._parse_known_args(args, namespace) | ||
2070 | + if hasattr(namespace, _UNRECOGNIZED_ARGS_ATTR): | ||
2071 | + args.extend(getattr(namespace, _UNRECOGNIZED_ARGS_ATTR)) | ||
2072 | + delattr(namespace, _UNRECOGNIZED_ARGS_ATTR) | ||
2073 | + return namespace, args | ||
2074 | + except ArgumentError: | ||
2075 | + err = _sys.exc_info()[1] | ||
2076 | + self.error(str(err)) | ||
2077 | + | ||
2078 | + def _parse_known_args(self, arg_strings, namespace): | ||
2079 | + # replace arg strings that are file references | ||
2080 | + if self.fromfile_prefix_chars is not None: | ||
2081 | + arg_strings = self._read_args_from_files(arg_strings) | ||
2082 | + | ||
2083 | + # map all mutually exclusive arguments to the other arguments | ||
2084 | + # they can't occur with | ||
2085 | + action_conflicts = {} | ||
2086 | + for mutex_group in self._mutually_exclusive_groups: | ||
2087 | + group_actions = mutex_group._group_actions | ||
2088 | + for i, mutex_action in enumerate(mutex_group._group_actions): | ||
2089 | + conflicts = action_conflicts.setdefault(mutex_action, []) | ||
2090 | + conflicts.extend(group_actions[:i]) | ||
2091 | + conflicts.extend(group_actions[i + 1:]) | ||
2092 | + | ||
2093 | + # find all option indices, and determine the arg_string_pattern | ||
2094 | + # which has an 'O' if there is an option at an index, | ||
2095 | + # an 'A' if there is an argument, or a '-' if there is a '--' | ||
2096 | + option_string_indices = {} | ||
2097 | + arg_string_pattern_parts = [] | ||
2098 | + arg_strings_iter = iter(arg_strings) | ||
2099 | + for i, arg_string in enumerate(arg_strings_iter): | ||
2100 | + | ||
2101 | + # all args after -- are non-options | ||
2102 | + if arg_string == '--': | ||
2103 | + arg_string_pattern_parts.append('-') | ||
2104 | + for arg_string in arg_strings_iter: | ||
2105 | + arg_string_pattern_parts.append('A') | ||
2106 | + | ||
2107 | + # otherwise, add the arg to the arg strings | ||
2108 | + # and note the index if it was an option | ||
2109 | + else: | ||
2110 | + option_tuple = self._parse_optional(arg_string) | ||
2111 | + if option_tuple is None: | ||
2112 | + pattern = 'A' | ||
2113 | + else: | ||
2114 | + option_string_indices[i] = option_tuple | ||
2115 | + pattern = 'O' | ||
2116 | + arg_string_pattern_parts.append(pattern) | ||
2117 | + | ||
2118 | + # join the pieces together to form the pattern | ||
2119 | + arg_strings_pattern = ''.join(arg_string_pattern_parts) | ||
2120 | + | ||
2121 | + # converts arg strings to the appropriate and then takes the action | ||
2122 | + seen_actions = set() | ||
2123 | + seen_non_default_actions = set() | ||
2124 | + | ||
2125 | + def take_action(action, argument_strings, option_string=None): | ||
2126 | + seen_actions.add(action) | ||
2127 | + argument_values = self._get_values(action, argument_strings) | ||
2128 | + | ||
2129 | + # error if this argument is not allowed with other previously | ||
2130 | + # seen arguments, assuming that actions that use the default | ||
2131 | + # value don't really count as "present" | ||
2132 | + if argument_values is not action.default: | ||
2133 | + seen_non_default_actions.add(action) | ||
2134 | + for conflict_action in action_conflicts.get(action, []): | ||
2135 | + if conflict_action in seen_non_default_actions: | ||
2136 | + msg = _('not allowed with argument %s') | ||
2137 | + action_name = _get_action_name(conflict_action) | ||
2138 | + raise ArgumentError(action, msg % action_name) | ||
2139 | + | ||
2140 | + # take the action if we didn't receive a SUPPRESS value | ||
2141 | + # (e.g. from a default) | ||
2142 | + if argument_values is not SUPPRESS: | ||
2143 | + action(self, namespace, argument_values, option_string) | ||
2144 | + | ||
2145 | + # function to convert arg_strings into an optional action | ||
2146 | + def consume_optional(start_index): | ||
2147 | + | ||
2148 | + # get the optional identified at this index | ||
2149 | + option_tuple = option_string_indices[start_index] | ||
2150 | + action, option_string, explicit_arg = option_tuple | ||
2151 | + | ||
2152 | + # identify additional optionals in the same arg string | ||
2153 | + # (e.g. -xyz is the same as -x -y -z if no args are required) | ||
2154 | + match_argument = self._match_argument | ||
2155 | + action_tuples = [] | ||
2156 | + while True: | ||
2157 | + | ||
2158 | + # if we found no optional action, skip it | ||
2159 | + if action is None: | ||
2160 | + extras.append(arg_strings[start_index]) | ||
2161 | + return start_index + 1 | ||
2162 | + | ||
2163 | + # if there is an explicit argument, try to match the | ||
2164 | + # optional's string arguments to only this | ||
2165 | + if explicit_arg is not None: | ||
2166 | + arg_count = match_argument(action, 'A') | ||
2167 | + | ||
2168 | + # if the action is a single-dash option and takes no | ||
2169 | + # arguments, try to parse more single-dash options out | ||
2170 | + # of the tail of the option string | ||
2171 | + chars = self.prefix_chars | ||
2172 | + if arg_count == 0 and option_string[1] not in chars: | ||
2173 | + action_tuples.append((action, [], option_string)) | ||
2174 | + char = option_string[0] | ||
2175 | + option_string = char + explicit_arg[0] | ||
2176 | + new_explicit_arg = explicit_arg[1:] or None | ||
2177 | + optionals_map = self._option_string_actions | ||
2178 | + if option_string in optionals_map: | ||
2179 | + action = optionals_map[option_string] | ||
2180 | + explicit_arg = new_explicit_arg | ||
2181 | + else: | ||
2182 | + msg = _('ignored explicit argument %r') | ||
2183 | + raise ArgumentError(action, msg % explicit_arg) | ||
2184 | + | ||
2185 | + # if the action expect exactly one argument, we've | ||
2186 | + # successfully matched the option; exit the loop | ||
2187 | + elif arg_count == 1: | ||
2188 | + stop = start_index + 1 | ||
2189 | + args = [explicit_arg] | ||
2190 | + action_tuples.append((action, args, option_string)) | ||
2191 | + break | ||
2192 | + | ||
2193 | + # error if a double-dash option did not use the | ||
2194 | + # explicit argument | ||
2195 | + else: | ||
2196 | + msg = _('ignored explicit argument %r') | ||
2197 | + raise ArgumentError(action, msg % explicit_arg) | ||
2198 | + | ||
2199 | + # if there is no explicit argument, try to match the | ||
2200 | + # optional's string arguments with the following strings | ||
2201 | + # if successful, exit the loop | ||
2202 | + else: | ||
2203 | + start = start_index + 1 | ||
2204 | + selected_patterns = arg_strings_pattern[start:] | ||
2205 | + arg_count = match_argument(action, selected_patterns) | ||
2206 | + stop = start + arg_count | ||
2207 | + args = arg_strings[start:stop] | ||
2208 | + action_tuples.append((action, args, option_string)) | ||
2209 | + break | ||
2210 | + | ||
2211 | + # add the Optional to the list and return the index at which | ||
2212 | + # the Optional's string args stopped | ||
2213 | + assert action_tuples | ||
2214 | + for action, args, option_string in action_tuples: | ||
2215 | + take_action(action, args, option_string) | ||
2216 | + return stop | ||
2217 | + | ||
2218 | + # the list of Positionals left to be parsed; this is modified | ||
2219 | + # by consume_positionals() | ||
2220 | + positionals = self._get_positional_actions() | ||
2221 | + | ||
2222 | + # function to convert arg_strings into positional actions | ||
2223 | + def consume_positionals(start_index): | ||
2224 | + # match as many Positionals as possible | ||
2225 | + match_partial = self._match_arguments_partial | ||
2226 | + selected_pattern = arg_strings_pattern[start_index:] | ||
2227 | + arg_counts = match_partial(positionals, selected_pattern) | ||
2228 | + | ||
2229 | + # slice off the appropriate arg strings for each Positional | ||
2230 | + # and add the Positional and its args to the list | ||
2231 | + for action, arg_count in zip(positionals, arg_counts): | ||
2232 | + args = arg_strings[start_index: start_index + arg_count] | ||
2233 | + start_index += arg_count | ||
2234 | + take_action(action, args) | ||
2235 | + | ||
2236 | + # slice off the Positionals that we just parsed and return the | ||
2237 | + # index at which the Positionals' string args stopped | ||
2238 | + positionals[:] = positionals[len(arg_counts):] | ||
2239 | + return start_index | ||
2240 | + | ||
2241 | + # consume Positionals and Optionals alternately, until we have | ||
2242 | + # passed the last option string | ||
2243 | + extras = [] | ||
2244 | + start_index = 0 | ||
2245 | + if option_string_indices: | ||
2246 | + max_option_string_index = max(option_string_indices) | ||
2247 | + else: | ||
2248 | + max_option_string_index = -1 | ||
2249 | + while start_index <= max_option_string_index: | ||
2250 | + | ||
2251 | + # consume any Positionals preceding the next option | ||
2252 | + next_option_string_index = min([ | ||
2253 | + index | ||
2254 | + for index in option_string_indices | ||
2255 | + if index >= start_index]) | ||
2256 | + if start_index != next_option_string_index: | ||
2257 | + positionals_end_index = consume_positionals(start_index) | ||
2258 | + | ||
2259 | + # only try to parse the next optional if we didn't consume | ||
2260 | + # the option string during the positionals parsing | ||
2261 | + if positionals_end_index > start_index: | ||
2262 | + start_index = positionals_end_index | ||
2263 | + continue | ||
2264 | + else: | ||
2265 | + start_index = positionals_end_index | ||
2266 | + | ||
2267 | + # if we consumed all the positionals we could and we're not | ||
2268 | + # at the index of an option string, there were extra arguments | ||
2269 | + if start_index not in option_string_indices: | ||
2270 | + strings = arg_strings[start_index:next_option_string_index] | ||
2271 | + extras.extend(strings) | ||
2272 | + start_index = next_option_string_index | ||
2273 | + | ||
2274 | + # consume the next optional and any arguments for it | ||
2275 | + start_index = consume_optional(start_index) | ||
2276 | + | ||
2277 | + # consume any positionals following the last Optional | ||
2278 | + stop_index = consume_positionals(start_index) | ||
2279 | + | ||
2280 | + # if we didn't consume all the argument strings, there were extras | ||
2281 | + extras.extend(arg_strings[stop_index:]) | ||
2282 | + | ||
2283 | + # if we didn't use all the Positional objects, there were too few | ||
2284 | + # arg strings supplied. | ||
2285 | + if positionals: | ||
2286 | + self.error(_('too few arguments')) | ||
2287 | + | ||
2288 | + # make sure all required actions were present, and convert defaults. | ||
2289 | + for action in self._actions: | ||
2290 | + if action not in seen_actions: | ||
2291 | + if action.required: | ||
2292 | + name = _get_action_name(action) | ||
2293 | + self.error(_('argument %s is required') % name) | ||
2294 | + else: | ||
2295 | + # Convert action default now instead of doing it before | ||
2296 | + # parsing arguments to avoid calling convert functions | ||
2297 | + # twice (which may fail) if the argument was given, but | ||
2298 | + # only if it was defined already in the namespace | ||
2299 | + if (action.default is not None and | ||
2300 | + isinstance(action.default, basestring) and | ||
2301 | + hasattr(namespace, action.dest) and | ||
2302 | + action.default is getattr(namespace, action.dest)): | ||
2303 | + setattr(namespace, action.dest, | ||
2304 | + self._get_value(action, action.default)) | ||
2305 | + | ||
2306 | + # make sure all required groups had one option present | ||
2307 | + for group in self._mutually_exclusive_groups: | ||
2308 | + if group.required: | ||
2309 | + for action in group._group_actions: | ||
2310 | + if action in seen_non_default_actions: | ||
2311 | + break | ||
2312 | + | ||
2313 | + # if no actions were used, report the error | ||
2314 | + else: | ||
2315 | + names = [_get_action_name(action) | ||
2316 | + for action in group._group_actions | ||
2317 | + if action.help is not SUPPRESS] | ||
2318 | + msg = _('one of the arguments %s is required') | ||
2319 | + self.error(msg % ' '.join(names)) | ||
2320 | + | ||
2321 | + # return the updated namespace and the extra arguments | ||
2322 | + return namespace, extras | ||
2323 | + | ||
2324 | + def _read_args_from_files(self, arg_strings): | ||
2325 | + # expand arguments referencing files | ||
2326 | + new_arg_strings = [] | ||
2327 | + for arg_string in arg_strings: | ||
2328 | + | ||
2329 | + # for regular arguments, just add them back into the list | ||
2330 | + if arg_string[0] not in self.fromfile_prefix_chars: | ||
2331 | + new_arg_strings.append(arg_string) | ||
2332 | + | ||
2333 | + # replace arguments referencing files with the file content | ||
2334 | + else: | ||
2335 | + try: | ||
2336 | + args_file = open(arg_string[1:]) | ||
2337 | + try: | ||
2338 | + arg_strings = [] | ||
2339 | + for arg_line in args_file.read().splitlines(): | ||
2340 | + for arg in self.convert_arg_line_to_args(arg_line): | ||
2341 | + arg_strings.append(arg) | ||
2342 | + arg_strings = self._read_args_from_files(arg_strings) | ||
2343 | + new_arg_strings.extend(arg_strings) | ||
2344 | + finally: | ||
2345 | + args_file.close() | ||
2346 | + except IOError: | ||
2347 | + err = _sys.exc_info()[1] | ||
2348 | + self.error(str(err)) | ||
2349 | + | ||
2350 | + # return the modified argument list | ||
2351 | + return new_arg_strings | ||
2352 | + | ||
2353 | + def convert_arg_line_to_args(self, arg_line): | ||
2354 | + return [arg_line] | ||
2355 | + | ||
2356 | + def _match_argument(self, action, arg_strings_pattern): | ||
2357 | + # match the pattern for this action to the arg strings | ||
2358 | + nargs_pattern = self._get_nargs_pattern(action) | ||
2359 | + match = _re.match(nargs_pattern, arg_strings_pattern) | ||
2360 | + | ||
2361 | + # raise an exception if we weren't able to find a match | ||
2362 | + if match is None: | ||
2363 | + nargs_errors = { | ||
2364 | + None: _('expected one argument'), | ||
2365 | + OPTIONAL: _('expected at most one argument'), | ||
2366 | + ONE_OR_MORE: _('expected at least one argument'), | ||
2367 | + } | 57 | + } |
2368 | + default = _('expected %s argument(s)') % action.nargs | 58 | qemu_iovec_init_buf(&local_qiov, bounce_buffer, pnum); |
2369 | + msg = nargs_errors.get(action.nargs, default) | 59 | |
2370 | + raise ArgumentError(action, msg) | 60 | ret = bdrv_driver_preadv(bs, cluster_offset, pnum, |
2371 | + | ||
2372 | + # return the number of arguments matched | ||
2373 | + return len(match.group(1)) | ||
2374 | + | ||
2375 | + def _match_arguments_partial(self, actions, arg_strings_pattern): | ||
2376 | + # progressively shorten the actions list by slicing off the | ||
2377 | + # final actions until we find a match | ||
2378 | + result = [] | ||
2379 | + for i in range(len(actions), 0, -1): | ||
2380 | + actions_slice = actions[:i] | ||
2381 | + pattern = ''.join([self._get_nargs_pattern(action) | ||
2382 | + for action in actions_slice]) | ||
2383 | + match = _re.match(pattern, arg_strings_pattern) | ||
2384 | + if match is not None: | ||
2385 | + result.extend([len(string) for string in match.groups()]) | ||
2386 | + break | ||
2387 | + | ||
2388 | + # return the list of arg string counts | ||
2389 | + return result | ||
2390 | + | ||
2391 | + def _parse_optional(self, arg_string): | ||
2392 | + # if it's an empty string, it was meant to be a positional | ||
2393 | + if not arg_string: | ||
2394 | + return None | ||
2395 | + | ||
2396 | + # if it doesn't start with a prefix, it was meant to be positional | ||
2397 | + if not arg_string[0] in self.prefix_chars: | ||
2398 | + return None | ||
2399 | + | ||
2400 | + # if the option string is present in the parser, return the action | ||
2401 | + if arg_string in self._option_string_actions: | ||
2402 | + action = self._option_string_actions[arg_string] | ||
2403 | + return action, arg_string, None | ||
2404 | + | ||
2405 | + # if it's just a single character, it was meant to be positional | ||
2406 | + if len(arg_string) == 1: | ||
2407 | + return None | ||
2408 | + | ||
2409 | + # if the option string before the "=" is present, return the action | ||
2410 | + if '=' in arg_string: | ||
2411 | + option_string, explicit_arg = arg_string.split('=', 1) | ||
2412 | + if option_string in self._option_string_actions: | ||
2413 | + action = self._option_string_actions[option_string] | ||
2414 | + return action, option_string, explicit_arg | ||
2415 | + | ||
2416 | + # search through all possible prefixes of the option string | ||
2417 | + # and all actions in the parser for possible interpretations | ||
2418 | + option_tuples = self._get_option_tuples(arg_string) | ||
2419 | + | ||
2420 | + # if multiple actions match, the option string was ambiguous | ||
2421 | + if len(option_tuples) > 1: | ||
2422 | + options = ', '.join([option_string | ||
2423 | + for action, option_string, explicit_arg in option_tuples]) | ||
2424 | + tup = arg_string, options | ||
2425 | + self.error(_('ambiguous option: %s could match %s') % tup) | ||
2426 | + | ||
2427 | + # if exactly one action matched, this segmentation is good, | ||
2428 | + # so return the parsed action | ||
2429 | + elif len(option_tuples) == 1: | ||
2430 | + option_tuple, = option_tuples | ||
2431 | + return option_tuple | ||
2432 | + | ||
2433 | + # if it was not found as an option, but it looks like a negative | ||
2434 | + # number, it was meant to be positional | ||
2435 | + # unless there are negative-number-like options | ||
2436 | + if self._negative_number_matcher.match(arg_string): | ||
2437 | + if not self._has_negative_number_optionals: | ||
2438 | + return None | ||
2439 | + | ||
2440 | + # if it contains a space, it was meant to be a positional | ||
2441 | + if ' ' in arg_string: | ||
2442 | + return None | ||
2443 | + | ||
2444 | + # it was meant to be an optional but there is no such option | ||
2445 | + # in this parser (though it might be a valid option in a subparser) | ||
2446 | + return None, arg_string, None | ||
2447 | + | ||
2448 | + def _get_option_tuples(self, option_string): | ||
2449 | + result = [] | ||
2450 | + | ||
2451 | + # option strings starting with two prefix characters are only | ||
2452 | + # split at the '=' | ||
2453 | + chars = self.prefix_chars | ||
2454 | + if option_string[0] in chars and option_string[1] in chars: | ||
2455 | + if '=' in option_string: | ||
2456 | + option_prefix, explicit_arg = option_string.split('=', 1) | ||
2457 | + else: | ||
2458 | + option_prefix = option_string | ||
2459 | + explicit_arg = None | ||
2460 | + for option_string in self._option_string_actions: | ||
2461 | + if option_string.startswith(option_prefix): | ||
2462 | + action = self._option_string_actions[option_string] | ||
2463 | + tup = action, option_string, explicit_arg | ||
2464 | + result.append(tup) | ||
2465 | + | ||
2466 | + # single character options can be concatenated with their arguments | ||
2467 | + # but multiple character options always have to have their argument | ||
2468 | + # separate | ||
2469 | + elif option_string[0] in chars and option_string[1] not in chars: | ||
2470 | + option_prefix = option_string | ||
2471 | + explicit_arg = None | ||
2472 | + short_option_prefix = option_string[:2] | ||
2473 | + short_explicit_arg = option_string[2:] | ||
2474 | + | ||
2475 | + for option_string in self._option_string_actions: | ||
2476 | + if option_string == short_option_prefix: | ||
2477 | + action = self._option_string_actions[option_string] | ||
2478 | + tup = action, option_string, short_explicit_arg | ||
2479 | + result.append(tup) | ||
2480 | + elif option_string.startswith(option_prefix): | ||
2481 | + action = self._option_string_actions[option_string] | ||
2482 | + tup = action, option_string, explicit_arg | ||
2483 | + result.append(tup) | ||
2484 | + | ||
2485 | + # shouldn't ever get here | ||
2486 | + else: | ||
2487 | + self.error(_('unexpected option string: %s') % option_string) | ||
2488 | + | ||
2489 | + # return the collected option tuples | ||
2490 | + return result | ||
2491 | + | ||
2492 | + def _get_nargs_pattern(self, action): | ||
2493 | + # in all examples below, we have to allow for '--' args | ||
2494 | + # which are represented as '-' in the pattern | ||
2495 | + nargs = action.nargs | ||
2496 | + | ||
2497 | + # the default (None) is assumed to be a single argument | ||
2498 | + if nargs is None: | ||
2499 | + nargs_pattern = '(-*A-*)' | ||
2500 | + | ||
2501 | + # allow zero or one arguments | ||
2502 | + elif nargs == OPTIONAL: | ||
2503 | + nargs_pattern = '(-*A?-*)' | ||
2504 | + | ||
2505 | + # allow zero or more arguments | ||
2506 | + elif nargs == ZERO_OR_MORE: | ||
2507 | + nargs_pattern = '(-*[A-]*)' | ||
2508 | + | ||
2509 | + # allow one or more arguments | ||
2510 | + elif nargs == ONE_OR_MORE: | ||
2511 | + nargs_pattern = '(-*A[A-]*)' | ||
2512 | + | ||
2513 | + # allow any number of options or arguments | ||
2514 | + elif nargs == REMAINDER: | ||
2515 | + nargs_pattern = '([-AO]*)' | ||
2516 | + | ||
2517 | + # allow one argument followed by any number of options or arguments | ||
2518 | + elif nargs == PARSER: | ||
2519 | + nargs_pattern = '(-*A[-AO]*)' | ||
2520 | + | ||
2521 | + # all others should be integers | ||
2522 | + else: | ||
2523 | + nargs_pattern = '(-*%s-*)' % '-*'.join('A' * nargs) | ||
2524 | + | ||
2525 | + # if this is an optional action, -- is not allowed | ||
2526 | + if action.option_strings: | ||
2527 | + nargs_pattern = nargs_pattern.replace('-*', '') | ||
2528 | + nargs_pattern = nargs_pattern.replace('-', '') | ||
2529 | + | ||
2530 | + # return the pattern | ||
2531 | + return nargs_pattern | ||
2532 | + | ||
2533 | + # ======================== | ||
2534 | + # Value conversion methods | ||
2535 | + # ======================== | ||
2536 | + def _get_values(self, action, arg_strings): | ||
2537 | + # for everything but PARSER args, strip out '--' | ||
2538 | + if action.nargs not in [PARSER, REMAINDER]: | ||
2539 | + arg_strings = [s for s in arg_strings if s != '--'] | ||
2540 | + | ||
2541 | + # optional argument produces a default when not present | ||
2542 | + if not arg_strings and action.nargs == OPTIONAL: | ||
2543 | + if action.option_strings: | ||
2544 | + value = action.const | ||
2545 | + else: | ||
2546 | + value = action.default | ||
2547 | + if isinstance(value, basestring): | ||
2548 | + value = self._get_value(action, value) | ||
2549 | + self._check_value(action, value) | ||
2550 | + | ||
2551 | + # when nargs='*' on a positional, if there were no command-line | ||
2552 | + # args, use the default if it is anything other than None | ||
2553 | + elif (not arg_strings and action.nargs == ZERO_OR_MORE and | ||
2554 | + not action.option_strings): | ||
2555 | + if action.default is not None: | ||
2556 | + value = action.default | ||
2557 | + else: | ||
2558 | + value = arg_strings | ||
2559 | + self._check_value(action, value) | ||
2560 | + | ||
2561 | + # single argument or optional argument produces a single value | ||
2562 | + elif len(arg_strings) == 1 and action.nargs in [None, OPTIONAL]: | ||
2563 | + arg_string, = arg_strings | ||
2564 | + value = self._get_value(action, arg_string) | ||
2565 | + self._check_value(action, value) | ||
2566 | + | ||
2567 | + # REMAINDER arguments convert all values, checking none | ||
2568 | + elif action.nargs == REMAINDER: | ||
2569 | + value = [self._get_value(action, v) for v in arg_strings] | ||
2570 | + | ||
2571 | + # PARSER arguments convert all values, but check only the first | ||
2572 | + elif action.nargs == PARSER: | ||
2573 | + value = [self._get_value(action, v) for v in arg_strings] | ||
2574 | + self._check_value(action, value[0]) | ||
2575 | + | ||
2576 | + # all other types of nargs produce a list | ||
2577 | + else: | ||
2578 | + value = [self._get_value(action, v) for v in arg_strings] | ||
2579 | + for v in value: | ||
2580 | + self._check_value(action, v) | ||
2581 | + | ||
2582 | + # return the converted value | ||
2583 | + return value | ||
2584 | + | ||
2585 | + def _get_value(self, action, arg_string): | ||
2586 | + type_func = self._registry_get('type', action.type, action.type) | ||
2587 | + if not _callable(type_func): | ||
2588 | + msg = _('%r is not callable') | ||
2589 | + raise ArgumentError(action, msg % type_func) | ||
2590 | + | ||
2591 | + # convert the value to the appropriate type | ||
2592 | + try: | ||
2593 | + result = type_func(arg_string) | ||
2594 | + | ||
2595 | + # ArgumentTypeErrors indicate errors | ||
2596 | + except ArgumentTypeError: | ||
2597 | + name = getattr(action.type, '__name__', repr(action.type)) | ||
2598 | + msg = str(_sys.exc_info()[1]) | ||
2599 | + raise ArgumentError(action, msg) | ||
2600 | + | ||
2601 | + # TypeErrors or ValueErrors also indicate errors | ||
2602 | + except (TypeError, ValueError): | ||
2603 | + name = getattr(action.type, '__name__', repr(action.type)) | ||
2604 | + msg = _('invalid %s value: %r') | ||
2605 | + raise ArgumentError(action, msg % (name, arg_string)) | ||
2606 | + | ||
2607 | + # return the converted value | ||
2608 | + return result | ||
2609 | + | ||
2610 | + def _check_value(self, action, value): | ||
2611 | + # converted value must be one of the choices (if specified) | ||
2612 | + if action.choices is not None and value not in action.choices: | ||
2613 | + tup = value, ', '.join(map(repr, action.choices)) | ||
2614 | + msg = _('invalid choice: %r (choose from %s)') % tup | ||
2615 | + raise ArgumentError(action, msg) | ||
2616 | + | ||
2617 | + # ======================= | ||
2618 | + # Help-formatting methods | ||
2619 | + # ======================= | ||
2620 | + def format_usage(self): | ||
2621 | + formatter = self._get_formatter() | ||
2622 | + formatter.add_usage(self.usage, self._actions, | ||
2623 | + self._mutually_exclusive_groups) | ||
2624 | + return formatter.format_help() | ||
2625 | + | ||
2626 | + def format_help(self): | ||
2627 | + formatter = self._get_formatter() | ||
2628 | + | ||
2629 | + # usage | ||
2630 | + formatter.add_usage(self.usage, self._actions, | ||
2631 | + self._mutually_exclusive_groups) | ||
2632 | + | ||
2633 | + # description | ||
2634 | + formatter.add_text(self.description) | ||
2635 | + | ||
2636 | + # positionals, optionals and user-defined groups | ||
2637 | + for action_group in self._action_groups: | ||
2638 | + formatter.start_section(action_group.title) | ||
2639 | + formatter.add_text(action_group.description) | ||
2640 | + formatter.add_arguments(action_group._group_actions) | ||
2641 | + formatter.end_section() | ||
2642 | + | ||
2643 | + # epilog | ||
2644 | + formatter.add_text(self.epilog) | ||
2645 | + | ||
2646 | + # determine help from format above | ||
2647 | + return formatter.format_help() | ||
2648 | + | ||
2649 | + def format_version(self): | ||
2650 | + import warnings | ||
2651 | + warnings.warn( | ||
2652 | + 'The format_version method is deprecated -- the "version" ' | ||
2653 | + 'argument to ArgumentParser is no longer supported.', | ||
2654 | + DeprecationWarning) | ||
2655 | + formatter = self._get_formatter() | ||
2656 | + formatter.add_text(self.version) | ||
2657 | + return formatter.format_help() | ||
2658 | + | ||
2659 | + def _get_formatter(self): | ||
2660 | + return self.formatter_class(prog=self.prog) | ||
2661 | + | ||
2662 | + # ===================== | ||
2663 | + # Help-printing methods | ||
2664 | + # ===================== | ||
2665 | + def print_usage(self, file=None): | ||
2666 | + if file is None: | ||
2667 | + file = _sys.stdout | ||
2668 | + self._print_message(self.format_usage(), file) | ||
2669 | + | ||
2670 | + def print_help(self, file=None): | ||
2671 | + if file is None: | ||
2672 | + file = _sys.stdout | ||
2673 | + self._print_message(self.format_help(), file) | ||
2674 | + | ||
2675 | + def print_version(self, file=None): | ||
2676 | + import warnings | ||
2677 | + warnings.warn( | ||
2678 | + 'The print_version method is deprecated -- the "version" ' | ||
2679 | + 'argument to ArgumentParser is no longer supported.', | ||
2680 | + DeprecationWarning) | ||
2681 | + self._print_message(self.format_version(), file) | ||
2682 | + | ||
2683 | + def _print_message(self, message, file=None): | ||
2684 | + if message: | ||
2685 | + if file is None: | ||
2686 | + file = _sys.stderr | ||
2687 | + file.write(message) | ||
2688 | + | ||
2689 | + # =============== | ||
2690 | + # Exiting methods | ||
2691 | + # =============== | ||
2692 | + def exit(self, status=0, message=None): | ||
2693 | + if message: | ||
2694 | + self._print_message(message, _sys.stderr) | ||
2695 | + _sys.exit(status) | ||
2696 | + | ||
2697 | + def error(self, message): | ||
2698 | + """error(message: string) | ||
2699 | + | ||
2700 | + Prints a usage message incorporating the message to stderr and | ||
2701 | + exits. | ||
2702 | + | ||
2703 | + If you override this in a subclass, it should not return -- it | ||
2704 | + should either exit or raise an exception. | ||
2705 | + """ | ||
2706 | + self.print_usage(_sys.stderr) | ||
2707 | + self.exit(2, _('%s: error: %s\n') % (self.prog, message)) | ||
2708 | -- | 61 | -- |
2709 | 2.13.5 | 62 | 2.21.0 |
2710 | 63 | ||
2711 | 64 | diff view generated by jsdifflib |
1 | From: Alberto Garcia <berto@igalia.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | LeakyBucket.burst_length is defined as an unsigned integer but the | 3 | Use and support new API in bdrv_co_do_copy_on_readv. |
4 | code never checks for overflows and it only makes sure that the value | ||
5 | is not 0. | ||
6 | 4 | ||
7 | In practice this means that the user can set something like | 5 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
8 | throttling.iops-total-max-length=4294967300 despite being larger than | 6 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> |
9 | UINT_MAX and the final value after casting to unsigned int will be 4. | 7 | Message-id: 20190604161514.262241-8-vsementsov@virtuozzo.com |
10 | 8 | Message-Id: <20190604161514.262241-8-vsementsov@virtuozzo.com> | |
11 | This patch changes the data type to uint64_t. This does not increase | ||
12 | the storage size of LeakyBucket, and allows us to assign the value | ||
13 | directly from qemu_opt_get_number() or BlockIOThrottle and then do the | ||
14 | checks directly in throttle_is_valid(). | ||
15 | |||
16 | The value of burst_length does not have a specific upper limit, | ||
17 | but since the bucket size is defined by max * burst_length we have | ||
18 | to prevent overflows. Instead of going for UINT64_MAX or something | ||
19 | similar this patch reuses THROTTLE_VALUE_MAX, which allows I/O bursts | ||
20 | of 1 GiB/s for 10 days in a row. | ||
21 | |||
22 | Signed-off-by: Alberto Garcia <berto@igalia.com> | ||
23 | Message-id: 1b2e3049803f71cafb2e1fa1be4fb47147a0d398.1503580370.git.berto@igalia.com | ||
24 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
25 | --- | 10 | --- |
26 | include/qemu/throttle.h | 2 +- | 11 | block/io.c | 21 ++++++++------------- |
27 | util/throttle.c | 5 +++++ | 12 | 1 file changed, 8 insertions(+), 13 deletions(-) |
28 | 2 files changed, 6 insertions(+), 1 deletion(-) | ||
29 | 13 | ||
30 | diff --git a/include/qemu/throttle.h b/include/qemu/throttle.h | 14 | diff --git a/block/io.c b/block/io.c |
31 | index XXXXXXX..XXXXXXX 100644 | 15 | index XXXXXXX..XXXXXXX 100644 |
32 | --- a/include/qemu/throttle.h | 16 | --- a/block/io.c |
33 | +++ b/include/qemu/throttle.h | 17 | +++ b/block/io.c |
34 | @@ -XXX,XX +XXX,XX @@ typedef struct LeakyBucket { | 18 | @@ -XXX,XX +XXX,XX @@ err: |
35 | uint64_t max; /* leaky bucket max burst in units */ | 19 | */ |
36 | double level; /* bucket level in units */ | 20 | static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, |
37 | double burst_level; /* bucket level in units (for computing bursts) */ | 21 | BdrvTrackedRequest *req, int64_t offset, unsigned int bytes, |
38 | - unsigned burst_length; /* max length of the burst period, in seconds */ | 22 | - int64_t align, QEMUIOVector *qiov, int flags) |
39 | + uint64_t burst_length; /* max length of the burst period, in seconds */ | 23 | + int64_t align, QEMUIOVector *qiov, size_t qiov_offset, int flags) |
40 | } LeakyBucket; | 24 | { |
41 | 25 | BlockDriverState *bs = child->bs; | |
42 | /* The following structure is used to configure a ThrottleState | 26 | int64_t total_bytes, max_bytes; |
43 | diff --git a/util/throttle.c b/util/throttle.c | 27 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, |
44 | index XXXXXXX..XXXXXXX 100644 | 28 | assert(is_power_of_2(align)); |
45 | --- a/util/throttle.c | 29 | assert((offset & (align - 1)) == 0); |
46 | +++ b/util/throttle.c | 30 | assert((bytes & (align - 1)) == 0); |
47 | @@ -XXX,XX +XXX,XX @@ bool throttle_is_valid(ThrottleConfig *cfg, Error **errp) | 31 | - assert(!qiov || bytes == qiov->size); |
48 | return false; | 32 | assert((bs->open_flags & BDRV_O_NO_IO) == 0); |
33 | max_transfer = QEMU_ALIGN_DOWN(MIN_NON_ZERO(bs->bl.max_transfer, INT_MAX), | ||
34 | align); | ||
35 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, | ||
49 | } | 36 | } |
50 | 37 | ||
51 | + if (bkt->max && bkt->burst_length > THROTTLE_VALUE_MAX / bkt->max) { | 38 | if (!ret || pnum != bytes) { |
52 | + error_setg(errp, "burst length too high for this burst rate"); | 39 | - ret = bdrv_co_do_copy_on_readv(child, offset, bytes, qiov, 0, flags); |
53 | + return false; | 40 | + ret = bdrv_co_do_copy_on_readv(child, offset, bytes, |
54 | + } | 41 | + qiov, qiov_offset, flags); |
55 | + | 42 | goto out; |
56 | if (bkt->max && !bkt->avg) { | 43 | } else if (flags & BDRV_REQ_PREFETCH) { |
57 | error_setg(errp, "bps_max/iops_max require corresponding" | 44 | goto out; |
58 | " bps/iops values"); | 45 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, |
46 | |||
47 | max_bytes = ROUND_UP(MAX(0, total_bytes - offset), align); | ||
48 | if (bytes <= max_bytes && bytes <= max_transfer) { | ||
49 | - ret = bdrv_driver_preadv(bs, offset, bytes, qiov, 0, 0); | ||
50 | + ret = bdrv_driver_preadv(bs, offset, bytes, qiov, qiov_offset, 0); | ||
51 | goto out; | ||
52 | } | ||
53 | |||
54 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_preadv(BdrvChild *child, | ||
55 | int num; | ||
56 | |||
57 | if (max_bytes) { | ||
58 | - QEMUIOVector local_qiov; | ||
59 | - | ||
60 | num = MIN(bytes_remaining, MIN(max_bytes, max_transfer)); | ||
61 | assert(num); | ||
62 | - qemu_iovec_init(&local_qiov, qiov->niov); | ||
63 | - qemu_iovec_concat(&local_qiov, qiov, bytes - bytes_remaining, num); | ||
64 | |||
65 | ret = bdrv_driver_preadv(bs, offset + bytes - bytes_remaining, | ||
66 | - num, &local_qiov, 0, 0); | ||
67 | + num, qiov, bytes - bytes_remaining, 0); | ||
68 | max_bytes -= num; | ||
69 | - qemu_iovec_destroy(&local_qiov); | ||
70 | } else { | ||
71 | num = bytes_remaining; | ||
72 | ret = qemu_iovec_memset(qiov, bytes - bytes_remaining, 0, | ||
73 | @@ -XXX,XX +XXX,XX @@ static int bdrv_padding_rmw_read(BdrvChild *child, | ||
74 | bdrv_debug_event(bs, BLKDBG_PWRITEV_RMW_TAIL); | ||
75 | } | ||
76 | ret = bdrv_aligned_preadv(child, req, req->overlap_offset, bytes, | ||
77 | - align, &local_qiov, 0); | ||
78 | + align, &local_qiov, 0, 0); | ||
79 | if (ret < 0) { | ||
80 | return ret; | ||
81 | } | ||
82 | @@ -XXX,XX +XXX,XX @@ static int bdrv_padding_rmw_read(BdrvChild *child, | ||
83 | ret = bdrv_aligned_preadv( | ||
84 | child, req, | ||
85 | req->overlap_offset + req->overlap_bytes - align, | ||
86 | - align, align, &local_qiov, 0); | ||
87 | + align, align, &local_qiov, 0, 0); | ||
88 | if (ret < 0) { | ||
89 | return ret; | ||
90 | } | ||
91 | @@ -XXX,XX +XXX,XX @@ int coroutine_fn bdrv_co_preadv(BdrvChild *child, | ||
92 | tracked_request_begin(&req, bs, offset, bytes, BDRV_TRACKED_READ); | ||
93 | ret = bdrv_aligned_preadv(child, &req, offset, bytes, | ||
94 | bs->bl.request_alignment, | ||
95 | - qiov, flags); | ||
96 | + qiov, 0, flags); | ||
97 | tracked_request_end(&req); | ||
98 | bdrv_dec_in_flight(bs); | ||
99 | |||
59 | -- | 100 | -- |
60 | 2.13.5 | 101 | 2.21.0 |
61 | 102 | ||
62 | 103 | diff view generated by jsdifflib |
1 | From: Eduardo Habkost <ehabkost@redhat.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | If QEMU is running on a system that's out of memory and mmap() | 3 | Use and support new API in bdrv_aligned_pwritev. |
4 | fails, QEMU aborts with no error message at all, making it hard | ||
5 | to debug the reason for the failure. | ||
6 | 4 | ||
7 | Add perror() calls that will print error information before | 5 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
8 | aborting. | 6 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> |
9 | 7 | Message-id: 20190604161514.262241-9-vsementsov@virtuozzo.com | |
10 | Signed-off-by: Eduardo Habkost <ehabkost@redhat.com> | 8 | Message-Id: <20190604161514.262241-9-vsementsov@virtuozzo.com> |
11 | Reviewed-by: Philippe Mathieu-Daudé <f4bug@amsat.org> | ||
12 | Tested-by: Philippe Mathieu-Daudé <f4bug@amsat.org> | ||
13 | Message-id: 20170829212053.6003-1-ehabkost@redhat.com | ||
14 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
15 | --- | 10 | --- |
16 | util/oslib-posix.c | 2 ++ | 11 | block/io.c | 27 +++++++++++++-------------- |
17 | 1 file changed, 2 insertions(+) | 12 | 1 file changed, 13 insertions(+), 14 deletions(-) |
18 | 13 | ||
19 | diff --git a/util/oslib-posix.c b/util/oslib-posix.c | 14 | diff --git a/block/io.c b/block/io.c |
20 | index XXXXXXX..XXXXXXX 100644 | 15 | index XXXXXXX..XXXXXXX 100644 |
21 | --- a/util/oslib-posix.c | 16 | --- a/block/io.c |
22 | +++ b/util/oslib-posix.c | 17 | +++ b/block/io.c |
23 | @@ -XXX,XX +XXX,XX @@ void *qemu_alloc_stack(size_t *sz) | 18 | @@ -XXX,XX +XXX,XX @@ bdrv_co_write_req_finish(BdrvChild *child, int64_t offset, uint64_t bytes, |
24 | ptr = mmap(NULL, *sz, PROT_READ | PROT_WRITE, | 19 | */ |
25 | MAP_PRIVATE | MAP_ANONYMOUS, -1, 0); | 20 | static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, |
26 | if (ptr == MAP_FAILED) { | 21 | BdrvTrackedRequest *req, int64_t offset, unsigned int bytes, |
27 | + perror("failed to allocate memory for stack"); | 22 | - int64_t align, QEMUIOVector *qiov, int flags) |
28 | abort(); | 23 | + int64_t align, QEMUIOVector *qiov, size_t qiov_offset, int flags) |
24 | { | ||
25 | BlockDriverState *bs = child->bs; | ||
26 | BlockDriver *drv = bs->drv; | ||
27 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, | ||
28 | assert(is_power_of_2(align)); | ||
29 | assert((offset & (align - 1)) == 0); | ||
30 | assert((bytes & (align - 1)) == 0); | ||
31 | - assert(!qiov || bytes == qiov->size); | ||
32 | + assert(!qiov || qiov_offset + bytes <= qiov->size); | ||
33 | max_transfer = QEMU_ALIGN_DOWN(MIN_NON_ZERO(bs->bl.max_transfer, INT_MAX), | ||
34 | align); | ||
35 | |||
36 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, | ||
37 | |||
38 | if (!ret && bs->detect_zeroes != BLOCKDEV_DETECT_ZEROES_OPTIONS_OFF && | ||
39 | !(flags & BDRV_REQ_ZERO_WRITE) && drv->bdrv_co_pwrite_zeroes && | ||
40 | - qemu_iovec_is_zero(qiov, 0, qiov->size)) { | ||
41 | + qemu_iovec_is_zero(qiov, qiov_offset, bytes)) { | ||
42 | flags |= BDRV_REQ_ZERO_WRITE; | ||
43 | if (bs->detect_zeroes == BLOCKDEV_DETECT_ZEROES_OPTIONS_UNMAP) { | ||
44 | flags |= BDRV_REQ_MAY_UNMAP; | ||
45 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, | ||
46 | bdrv_debug_event(bs, BLKDBG_PWRITEV_ZERO); | ||
47 | ret = bdrv_co_do_pwrite_zeroes(bs, offset, bytes, flags); | ||
48 | } else if (flags & BDRV_REQ_WRITE_COMPRESSED) { | ||
49 | - ret = bdrv_driver_pwritev_compressed(bs, offset, bytes, qiov, 0); | ||
50 | + ret = bdrv_driver_pwritev_compressed(bs, offset, bytes, | ||
51 | + qiov, qiov_offset); | ||
52 | } else if (bytes <= max_transfer) { | ||
53 | bdrv_debug_event(bs, BLKDBG_PWRITEV); | ||
54 | - ret = bdrv_driver_pwritev(bs, offset, bytes, qiov, 0, flags); | ||
55 | + ret = bdrv_driver_pwritev(bs, offset, bytes, qiov, qiov_offset, flags); | ||
56 | } else { | ||
57 | bdrv_debug_event(bs, BLKDBG_PWRITEV); | ||
58 | while (bytes_remaining) { | ||
59 | int num = MIN(bytes_remaining, max_transfer); | ||
60 | - QEMUIOVector local_qiov; | ||
61 | int local_flags = flags; | ||
62 | |||
63 | assert(num); | ||
64 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_aligned_pwritev(BdrvChild *child, | ||
65 | * need to flush on the last iteration */ | ||
66 | local_flags &= ~BDRV_REQ_FUA; | ||
67 | } | ||
68 | - qemu_iovec_init(&local_qiov, qiov->niov); | ||
69 | - qemu_iovec_concat(&local_qiov, qiov, bytes - bytes_remaining, num); | ||
70 | |||
71 | ret = bdrv_driver_pwritev(bs, offset + bytes - bytes_remaining, | ||
72 | - num, &local_qiov, 0, local_flags); | ||
73 | - qemu_iovec_destroy(&local_qiov); | ||
74 | + num, qiov, bytes - bytes_remaining, | ||
75 | + local_flags); | ||
76 | if (ret < 0) { | ||
77 | break; | ||
78 | } | ||
79 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_zero_pwritev(BdrvChild *child, | ||
80 | |||
81 | qemu_iovec_init_buf(&local_qiov, pad.buf, write_bytes); | ||
82 | ret = bdrv_aligned_pwritev(child, req, aligned_offset, write_bytes, | ||
83 | - align, &local_qiov, | ||
84 | + align, &local_qiov, 0, | ||
85 | flags & ~BDRV_REQ_ZERO_WRITE); | ||
86 | if (ret < 0 || pad.merge_reads) { | ||
87 | /* Error or all work is done */ | ||
88 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_zero_pwritev(BdrvChild *child, | ||
89 | /* Write the aligned part in the middle. */ | ||
90 | uint64_t aligned_bytes = bytes & ~(align - 1); | ||
91 | ret = bdrv_aligned_pwritev(child, req, offset, aligned_bytes, align, | ||
92 | - NULL, flags); | ||
93 | + NULL, 0, flags); | ||
94 | if (ret < 0) { | ||
95 | goto out; | ||
96 | } | ||
97 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn bdrv_co_do_zero_pwritev(BdrvChild *child, | ||
98 | |||
99 | qemu_iovec_init_buf(&local_qiov, pad.tail_buf, align); | ||
100 | ret = bdrv_aligned_pwritev(child, req, offset, align, align, | ||
101 | - &local_qiov, flags & ~BDRV_REQ_ZERO_WRITE); | ||
102 | + &local_qiov, 0, | ||
103 | + flags & ~BDRV_REQ_ZERO_WRITE); | ||
29 | } | 104 | } |
30 | 105 | ||
31 | @@ -XXX,XX +XXX,XX @@ void *qemu_alloc_stack(size_t *sz) | 106 | out: |
32 | guardpage = ptr; | 107 | @@ -XXX,XX +XXX,XX @@ int coroutine_fn bdrv_co_pwritev(BdrvChild *child, |
33 | #endif | ||
34 | if (mprotect(guardpage, pagesz, PROT_NONE) != 0) { | ||
35 | + perror("failed to set up stack guard page"); | ||
36 | abort(); | ||
37 | } | 108 | } |
38 | 109 | ||
110 | ret = bdrv_aligned_pwritev(child, &req, offset, bytes, align, | ||
111 | - qiov, flags); | ||
112 | + qiov, 0, flags); | ||
113 | |||
114 | bdrv_padding_destroy(&pad); | ||
115 | |||
39 | -- | 116 | -- |
40 | 2.13.5 | 117 | 2.21.0 |
41 | 118 | ||
42 | 119 | diff view generated by jsdifflib |
1 | From: Alberto Garcia <berto@igalia.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | Use a pointer to the bucket instead of repeating cfg->buckets[i] all | 3 | Introduce extended variants of bdrv_co_preadv and bdrv_co_pwritev |
4 | the time. This makes the code more concise and will help us expand the | 4 | with qiov_offset parameter. |
5 | checks later and save a few line breaks. | ||
6 | 5 | ||
7 | Signed-off-by: Alberto Garcia <berto@igalia.com> | 6 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
8 | Message-id: 763ffc40a26b17d54cf93f5a999e4656049fcf0c.1503580370.git.berto@igalia.com | 7 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> |
8 | Message-id: 20190604161514.262241-10-vsementsov@virtuozzo.com | ||
9 | Message-Id: <20190604161514.262241-10-vsementsov@virtuozzo.com> | ||
9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 10 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
10 | --- | 11 | --- |
11 | util/throttle.c | 15 +++++++-------- | 12 | include/block/block_int.h | 6 ++++++ |
12 | 1 file changed, 7 insertions(+), 8 deletions(-) | 13 | block/io.c | 29 +++++++++++++++++++++++------ |
14 | 2 files changed, 29 insertions(+), 6 deletions(-) | ||
13 | 15 | ||
14 | diff --git a/util/throttle.c b/util/throttle.c | 16 | diff --git a/include/block/block_int.h b/include/block/block_int.h |
15 | index XXXXXXX..XXXXXXX 100644 | 17 | index XXXXXXX..XXXXXXX 100644 |
16 | --- a/util/throttle.c | 18 | --- a/include/block/block_int.h |
17 | +++ b/util/throttle.c | 19 | +++ b/include/block/block_int.h |
18 | @@ -XXX,XX +XXX,XX @@ bool throttle_is_valid(ThrottleConfig *cfg, Error **errp) | 20 | @@ -XXX,XX +XXX,XX @@ extern BlockDriver bdrv_qcow2; |
21 | int coroutine_fn bdrv_co_preadv(BdrvChild *child, | ||
22 | int64_t offset, unsigned int bytes, QEMUIOVector *qiov, | ||
23 | BdrvRequestFlags flags); | ||
24 | +int coroutine_fn bdrv_co_preadv_part(BdrvChild *child, | ||
25 | + int64_t offset, unsigned int bytes, | ||
26 | + QEMUIOVector *qiov, size_t qiov_offset, BdrvRequestFlags flags); | ||
27 | int coroutine_fn bdrv_co_pwritev(BdrvChild *child, | ||
28 | int64_t offset, unsigned int bytes, QEMUIOVector *qiov, | ||
29 | BdrvRequestFlags flags); | ||
30 | +int coroutine_fn bdrv_co_pwritev_part(BdrvChild *child, | ||
31 | + int64_t offset, unsigned int bytes, | ||
32 | + QEMUIOVector *qiov, size_t qiov_offset, BdrvRequestFlags flags); | ||
33 | |||
34 | static inline int coroutine_fn bdrv_co_pread(BdrvChild *child, | ||
35 | int64_t offset, unsigned int bytes, void *buf, BdrvRequestFlags flags) | ||
36 | diff --git a/block/io.c b/block/io.c | ||
37 | index XXXXXXX..XXXXXXX 100644 | ||
38 | --- a/block/io.c | ||
39 | +++ b/block/io.c | ||
40 | @@ -XXX,XX +XXX,XX @@ static void bdrv_padding_destroy(BdrvRequestPadding *pad) | ||
41 | * | ||
42 | * Function always succeeds. | ||
43 | */ | ||
44 | -static bool bdrv_pad_request(BlockDriverState *bs, QEMUIOVector **qiov, | ||
45 | +static bool bdrv_pad_request(BlockDriverState *bs, | ||
46 | + QEMUIOVector **qiov, size_t *qiov_offset, | ||
47 | int64_t *offset, unsigned int *bytes, | ||
48 | BdrvRequestPadding *pad) | ||
49 | { | ||
50 | @@ -XXX,XX +XXX,XX @@ static bool bdrv_pad_request(BlockDriverState *bs, QEMUIOVector **qiov, | ||
19 | } | 51 | } |
20 | 52 | ||
21 | for (i = 0; i < BUCKETS_COUNT; i++) { | 53 | qemu_iovec_init_extended(&pad->local_qiov, pad->buf, pad->head, |
22 | - if (cfg->buckets[i].avg < 0 || | 54 | - *qiov, 0, *bytes, |
23 | - cfg->buckets[i].max < 0 || | 55 | + *qiov, *qiov_offset, *bytes, |
24 | - cfg->buckets[i].avg > THROTTLE_VALUE_MAX || | 56 | pad->buf + pad->buf_len - pad->tail, pad->tail); |
25 | - cfg->buckets[i].max > THROTTLE_VALUE_MAX) { | 57 | *bytes += pad->head + pad->tail; |
26 | + LeakyBucket *bkt = &cfg->buckets[i]; | 58 | *offset -= pad->head; |
27 | + if (bkt->avg < 0 || bkt->max < 0 || | 59 | *qiov = &pad->local_qiov; |
28 | + bkt->avg > THROTTLE_VALUE_MAX || bkt->max > THROTTLE_VALUE_MAX) { | 60 | + *qiov_offset = 0; |
29 | error_setg(errp, "bps/iops/max values must be within [0, %lld]", | 61 | |
30 | THROTTLE_VALUE_MAX); | 62 | return true; |
31 | return false; | 63 | } |
32 | } | 64 | @@ -XXX,XX +XXX,XX @@ static bool bdrv_pad_request(BlockDriverState *bs, QEMUIOVector **qiov, |
33 | 65 | int coroutine_fn bdrv_co_preadv(BdrvChild *child, | |
34 | - if (!cfg->buckets[i].burst_length) { | 66 | int64_t offset, unsigned int bytes, QEMUIOVector *qiov, |
35 | + if (!bkt->burst_length) { | 67 | BdrvRequestFlags flags) |
36 | error_setg(errp, "the burst length cannot be 0"); | 68 | +{ |
37 | return false; | 69 | + return bdrv_co_preadv_part(child, offset, bytes, qiov, 0, flags); |
38 | } | 70 | +} |
39 | 71 | + | |
40 | - if (cfg->buckets[i].burst_length > 1 && !cfg->buckets[i].max) { | 72 | +int coroutine_fn bdrv_co_preadv_part(BdrvChild *child, |
41 | + if (bkt->burst_length > 1 && !bkt->max) { | 73 | + int64_t offset, unsigned int bytes, |
42 | error_setg(errp, "burst length set without burst rate"); | 74 | + QEMUIOVector *qiov, size_t qiov_offset, |
43 | return false; | 75 | + BdrvRequestFlags flags) |
44 | } | 76 | { |
45 | 77 | BlockDriverState *bs = child->bs; | |
46 | - if (cfg->buckets[i].max && !cfg->buckets[i].avg) { | 78 | BdrvTrackedRequest req; |
47 | + if (bkt->max && !bkt->avg) { | 79 | @@ -XXX,XX +XXX,XX @@ int coroutine_fn bdrv_co_preadv(BdrvChild *child, |
48 | error_setg(errp, "bps_max/iops_max require corresponding" | 80 | flags |= BDRV_REQ_COPY_ON_READ; |
49 | " bps/iops values"); | 81 | } |
50 | return false; | 82 | |
51 | } | 83 | - bdrv_pad_request(bs, &qiov, &offset, &bytes, &pad); |
52 | 84 | + bdrv_pad_request(bs, &qiov, &qiov_offset, &offset, &bytes, &pad); | |
53 | - if (cfg->buckets[i].max && cfg->buckets[i].max < cfg->buckets[i].avg) { | 85 | |
54 | + if (bkt->max && bkt->max < bkt->avg) { | 86 | tracked_request_begin(&req, bs, offset, bytes, BDRV_TRACKED_READ); |
55 | error_setg(errp, "bps_max/iops_max cannot be lower than bps/iops"); | 87 | ret = bdrv_aligned_preadv(child, &req, offset, bytes, |
56 | return false; | 88 | bs->bl.request_alignment, |
57 | } | 89 | - qiov, 0, flags); |
90 | + qiov, qiov_offset, flags); | ||
91 | tracked_request_end(&req); | ||
92 | bdrv_dec_in_flight(bs); | ||
93 | |||
94 | @@ -XXX,XX +XXX,XX @@ out: | ||
95 | int coroutine_fn bdrv_co_pwritev(BdrvChild *child, | ||
96 | int64_t offset, unsigned int bytes, QEMUIOVector *qiov, | ||
97 | BdrvRequestFlags flags) | ||
98 | +{ | ||
99 | + return bdrv_co_pwritev_part(child, offset, bytes, qiov, 0, flags); | ||
100 | +} | ||
101 | + | ||
102 | +int coroutine_fn bdrv_co_pwritev_part(BdrvChild *child, | ||
103 | + int64_t offset, unsigned int bytes, QEMUIOVector *qiov, size_t qiov_offset, | ||
104 | + BdrvRequestFlags flags) | ||
105 | { | ||
106 | BlockDriverState *bs = child->bs; | ||
107 | BdrvTrackedRequest req; | ||
108 | @@ -XXX,XX +XXX,XX @@ int coroutine_fn bdrv_co_pwritev(BdrvChild *child, | ||
109 | goto out; | ||
110 | } | ||
111 | |||
112 | - if (bdrv_pad_request(bs, &qiov, &offset, &bytes, &pad)) { | ||
113 | + if (bdrv_pad_request(bs, &qiov, &qiov_offset, &offset, &bytes, &pad)) { | ||
114 | mark_request_serialising(&req, align); | ||
115 | wait_serialising_requests(&req); | ||
116 | bdrv_padding_rmw_read(child, &req, &pad, false); | ||
117 | } | ||
118 | |||
119 | ret = bdrv_aligned_pwritev(child, &req, offset, bytes, align, | ||
120 | - qiov, 0, flags); | ||
121 | + qiov, qiov_offset, flags); | ||
122 | |||
123 | bdrv_padding_destroy(&pad); | ||
124 | |||
58 | -- | 125 | -- |
59 | 2.13.5 | 126 | 2.21.0 |
60 | 127 | ||
61 | 128 | diff view generated by jsdifflib |
1 | From: Alberto Garcia <berto@igalia.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | There's a few cases which we're passing an Error pointer to a function | 3 | Use buffer based io in encrypted case. |
4 | only to discard it immediately afterwards without checking it. In | ||
5 | these cases we can simply remove the variable and pass NULL instead. | ||
6 | 4 | ||
7 | Signed-off-by: Alberto Garcia <berto@igalia.com> | 5 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
8 | Reviewed-by: Philippe Mathieu-Daudé <f4bug@amsat.org> | 6 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> |
9 | Reviewed-by: Eric Blake <eblake@redhat.com> | 7 | Message-id: 20190604161514.262241-11-vsementsov@virtuozzo.com |
10 | Message-id: 20170829120836.16091-1-berto@igalia.com | 8 | Message-Id: <20190604161514.262241-11-vsementsov@virtuozzo.com> |
11 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
12 | --- | 10 | --- |
13 | block/qcow.c | 12 +++--------- | 11 | block/qcow2.c | 28 ++++++++++++++++------------ |
14 | block/qcow2.c | 8 ++------ | 12 | 1 file changed, 16 insertions(+), 12 deletions(-) |
15 | dump.c | 4 +--- | ||
16 | 3 files changed, 6 insertions(+), 18 deletions(-) | ||
17 | 13 | ||
18 | diff --git a/block/qcow.c b/block/qcow.c | ||
19 | index XXXXXXX..XXXXXXX 100644 | ||
20 | --- a/block/qcow.c | ||
21 | +++ b/block/qcow.c | ||
22 | @@ -XXX,XX +XXX,XX @@ static uint64_t get_cluster_offset(BlockDriverState *bs, | ||
23 | start_sect = (offset & ~(s->cluster_size - 1)) >> 9; | ||
24 | for(i = 0; i < s->cluster_sectors; i++) { | ||
25 | if (i < n_start || i >= n_end) { | ||
26 | - Error *err = NULL; | ||
27 | memset(s->cluster_data, 0x00, 512); | ||
28 | if (qcrypto_block_encrypt(s->crypto, start_sect + i, | ||
29 | s->cluster_data, | ||
30 | BDRV_SECTOR_SIZE, | ||
31 | - &err) < 0) { | ||
32 | - error_free(err); | ||
33 | + NULL) < 0) { | ||
34 | errno = EIO; | ||
35 | return -1; | ||
36 | } | ||
37 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow_co_readv(BlockDriverState *bs, int64_t sector_num, | ||
38 | QEMUIOVector hd_qiov; | ||
39 | uint8_t *buf; | ||
40 | void *orig_buf; | ||
41 | - Error *err = NULL; | ||
42 | |||
43 | if (qiov->niov > 1) { | ||
44 | buf = orig_buf = qemu_try_blockalign(bs, qiov->size); | ||
45 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow_co_readv(BlockDriverState *bs, int64_t sector_num, | ||
46 | if (bs->encrypted) { | ||
47 | assert(s->crypto); | ||
48 | if (qcrypto_block_decrypt(s->crypto, sector_num, buf, | ||
49 | - n * BDRV_SECTOR_SIZE, &err) < 0) { | ||
50 | + n * BDRV_SECTOR_SIZE, NULL) < 0) { | ||
51 | goto fail; | ||
52 | } | ||
53 | } | ||
54 | @@ -XXX,XX +XXX,XX @@ done: | ||
55 | return ret; | ||
56 | |||
57 | fail: | ||
58 | - error_free(err); | ||
59 | ret = -EIO; | ||
60 | goto done; | ||
61 | } | ||
62 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow_co_writev(BlockDriverState *bs, int64_t sector_num, | ||
63 | break; | ||
64 | } | ||
65 | if (bs->encrypted) { | ||
66 | - Error *err = NULL; | ||
67 | assert(s->crypto); | ||
68 | if (qcrypto_block_encrypt(s->crypto, sector_num, buf, | ||
69 | - n * BDRV_SECTOR_SIZE, &err) < 0) { | ||
70 | - error_free(err); | ||
71 | + n * BDRV_SECTOR_SIZE, NULL) < 0) { | ||
72 | ret = -EIO; | ||
73 | break; | ||
74 | } | ||
75 | diff --git a/block/qcow2.c b/block/qcow2.c | 14 | diff --git a/block/qcow2.c b/block/qcow2.c |
76 | index XXXXXXX..XXXXXXX 100644 | 15 | index XXXXXXX..XXXXXXX 100644 |
77 | --- a/block/qcow2.c | 16 | --- a/block/qcow2.c |
78 | +++ b/block/qcow2.c | 17 | +++ b/block/qcow2.c |
79 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_preadv(BlockDriverState *bs, uint64_t offset, | 18 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_preadv(BlockDriverState *bs, uint64_t offset, |
80 | assert(s->crypto); | 19 | } |
20 | |||
21 | assert(cur_bytes <= QCOW_MAX_CRYPT_CLUSTERS * s->cluster_size); | ||
22 | - qemu_iovec_reset(&hd_qiov); | ||
23 | - qemu_iovec_add(&hd_qiov, cluster_data, cur_bytes); | ||
24 | - } | ||
25 | |||
26 | - BLKDBG_EVENT(bs->file, BLKDBG_READ_AIO); | ||
27 | - ret = bdrv_co_preadv(s->data_file, | ||
28 | - cluster_offset + offset_in_cluster, | ||
29 | - cur_bytes, &hd_qiov, 0); | ||
30 | - if (ret < 0) { | ||
31 | - goto fail; | ||
32 | - } | ||
33 | - if (bs->encrypted) { | ||
34 | - assert(s->crypto); | ||
35 | + BLKDBG_EVENT(bs->file, BLKDBG_READ_AIO); | ||
36 | + ret = bdrv_co_pread(s->data_file, | ||
37 | + cluster_offset + offset_in_cluster, | ||
38 | + cur_bytes, cluster_data, 0); | ||
39 | + if (ret < 0) { | ||
40 | + goto fail; | ||
41 | + } | ||
42 | + | ||
81 | assert((offset & (BDRV_SECTOR_SIZE - 1)) == 0); | 43 | assert((offset & (BDRV_SECTOR_SIZE - 1)) == 0); |
82 | assert((cur_bytes & (BDRV_SECTOR_SIZE - 1)) == 0); | 44 | assert((cur_bytes & (BDRV_SECTOR_SIZE - 1)) == 0); |
83 | - Error *err = NULL; | 45 | if (qcow2_co_decrypt(bs, cluster_offset, offset, |
84 | if (qcrypto_block_decrypt(s->crypto, | 46 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_preadv(BlockDriverState *bs, uint64_t offset, |
85 | (s->crypt_physical_offset ? | ||
86 | cluster_offset + offset_in_cluster : | ||
87 | offset) >> BDRV_SECTOR_BITS, | ||
88 | cluster_data, | ||
89 | cur_bytes, | ||
90 | - &err) < 0) { | ||
91 | - error_free(err); | ||
92 | + NULL) < 0) { | ||
93 | ret = -EIO; | ||
94 | goto fail; | 47 | goto fail; |
95 | } | 48 | } |
96 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_pwritev(BlockDriverState *bs, uint64_t offset, | 49 | qemu_iovec_from_buf(qiov, bytes_done, cluster_data, cur_bytes); |
97 | qemu_iovec_concat(&hd_qiov, qiov, bytes_done, cur_bytes); | 50 | + } else { |
98 | 51 | + BLKDBG_EVENT(bs->file, BLKDBG_READ_AIO); | |
99 | if (bs->encrypted) { | 52 | + ret = bdrv_co_preadv(s->data_file, |
100 | - Error *err = NULL; | 53 | + cluster_offset + offset_in_cluster, |
101 | assert(s->crypto); | 54 | + cur_bytes, &hd_qiov, 0); |
102 | if (!cluster_data) { | 55 | + if (ret < 0) { |
103 | cluster_data = qemu_try_blockalign(bs->file->bs, | 56 | + goto fail; |
104 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_pwritev(BlockDriverState *bs, uint64_t offset, | 57 | + } |
105 | cluster_offset + offset_in_cluster : | ||
106 | offset) >> BDRV_SECTOR_BITS, | ||
107 | cluster_data, | ||
108 | - cur_bytes, &err) < 0) { | ||
109 | - error_free(err); | ||
110 | + cur_bytes, NULL) < 0) { | ||
111 | ret = -EIO; | ||
112 | goto fail; | ||
113 | } | 58 | } |
114 | diff --git a/dump.c b/dump.c | 59 | break; |
115 | index XXXXXXX..XXXXXXX 100644 | ||
116 | --- a/dump.c | ||
117 | +++ b/dump.c | ||
118 | @@ -XXX,XX +XXX,XX @@ static void dump_process(DumpState *s, Error **errp) | ||
119 | |||
120 | static void *dump_thread(void *data) | ||
121 | { | ||
122 | - Error *err = NULL; | ||
123 | DumpState *s = (DumpState *)data; | ||
124 | - dump_process(s, &err); | ||
125 | - error_free(err); | ||
126 | + dump_process(s, NULL); | ||
127 | return NULL; | ||
128 | } | ||
129 | 60 | ||
130 | -- | 61 | -- |
131 | 2.13.5 | 62 | 2.21.0 |
132 | 63 | ||
133 | 64 | diff view generated by jsdifflib |
1 | Most qcow2 files are uncompressed so it is wasteful to allocate (32 + 1) | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | * cluster_size + 512 bytes upfront. Allocate s->cluster_cache and | ||
3 | s->cluster_data when the first read operation is performance on a | ||
4 | compressed cluster. | ||
5 | 2 | ||
6 | The buffers are freed in .bdrv_close(). .bdrv_open() no longer has any | 3 | Implement and use new interface to get rid of hd_qiov. |
7 | code paths that can allocate these buffers, so remove the free functions | ||
8 | in the error code path. | ||
9 | 4 | ||
10 | This patch can result in significant memory savings when many qcow2 | 5 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
11 | disks are attached or backing file chains are long: | 6 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> |
12 | 7 | Message-id: 20190604161514.262241-12-vsementsov@virtuozzo.com | |
13 | Before 12.81% (1,023,193,088B) | 8 | Message-Id: <20190604161514.262241-12-vsementsov@virtuozzo.com> |
14 | After 5.36% (393,893,888B) | ||
15 | |||
16 | Reported-by: Alexey Kardashevskiy <aik@ozlabs.ru> | ||
17 | Tested-by: Alexey Kardashevskiy <aik@ozlabs.ru> | ||
18 | Reviewed-by: Eric Blake <eblake@redhat.com> | ||
19 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | ||
20 | Message-id: 20170821135530.32344-1-stefanha@redhat.com | ||
21 | Cc: Kevin Wolf <kwolf@redhat.com> | ||
22 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
23 | --- | 10 | --- |
24 | block/qcow2-cluster.c | 17 +++++++++++++++++ | 11 | block/qcow2-cluster.c | 5 +++-- |
25 | block/qcow2.c | 12 ------------ | 12 | block/qcow2.c | 49 +++++++++++++++++++------------------------ |
26 | 2 files changed, 17 insertions(+), 12 deletions(-) | 13 | 2 files changed, 25 insertions(+), 29 deletions(-) |
27 | 14 | ||
28 | diff --git a/block/qcow2-cluster.c b/block/qcow2-cluster.c | 15 | diff --git a/block/qcow2-cluster.c b/block/qcow2-cluster.c |
29 | index XXXXXXX..XXXXXXX 100644 | 16 | index XXXXXXX..XXXXXXX 100644 |
30 | --- a/block/qcow2-cluster.c | 17 | --- a/block/qcow2-cluster.c |
31 | +++ b/block/qcow2-cluster.c | 18 | +++ b/block/qcow2-cluster.c |
32 | @@ -XXX,XX +XXX,XX @@ int qcow2_decompress_cluster(BlockDriverState *bs, uint64_t cluster_offset) | 19 | @@ -XXX,XX +XXX,XX @@ static int coroutine_fn do_perform_cow_read(BlockDriverState *bs, |
33 | nb_csectors = ((cluster_offset >> s->csize_shift) & s->csize_mask) + 1; | 20 | * interface. This avoids double I/O throttling and request tracking, |
34 | sector_offset = coffset & 511; | 21 | * which can lead to deadlock when block layer copy-on-read is enabled. |
35 | csize = nb_csectors * 512 - sector_offset; | 22 | */ |
36 | + | 23 | - ret = bs->drv->bdrv_co_preadv(bs, src_cluster_offset + offset_in_cluster, |
37 | + /* Allocate buffers on first decompress operation, most images are | 24 | - qiov->size, qiov, 0); |
38 | + * uncompressed and the memory overhead can be avoided. The buffers | 25 | + ret = bs->drv->bdrv_co_preadv_part(bs, |
39 | + * are freed in .bdrv_close(). | 26 | + src_cluster_offset + offset_in_cluster, |
40 | + */ | 27 | + qiov->size, qiov, 0, 0); |
41 | + if (!s->cluster_data) { | 28 | if (ret < 0) { |
42 | + /* one more sector for decompressed data alignment */ | 29 | return ret; |
43 | + s->cluster_data = qemu_try_blockalign(bs->file->bs, | 30 | } |
44 | + QCOW_MAX_CRYPT_CLUSTERS * s->cluster_size + 512); | ||
45 | + if (!s->cluster_data) { | ||
46 | + return -ENOMEM; | ||
47 | + } | ||
48 | + } | ||
49 | + if (!s->cluster_cache) { | ||
50 | + s->cluster_cache = g_malloc(s->cluster_size); | ||
51 | + } | ||
52 | + | ||
53 | BLKDBG_EVENT(bs->file, BLKDBG_READ_COMPRESSED); | ||
54 | ret = bdrv_read(bs->file, coffset >> 9, s->cluster_data, | ||
55 | nb_csectors); | ||
56 | diff --git a/block/qcow2.c b/block/qcow2.c | 31 | diff --git a/block/qcow2.c b/block/qcow2.c |
57 | index XXXXXXX..XXXXXXX 100644 | 32 | index XXXXXXX..XXXXXXX 100644 |
58 | --- a/block/qcow2.c | 33 | --- a/block/qcow2.c |
59 | +++ b/block/qcow2.c | 34 | +++ b/block/qcow2.c |
60 | @@ -XXX,XX +XXX,XX @@ static int qcow2_do_open(BlockDriverState *bs, QDict *options, int flags, | 35 | @@ -XXX,XX +XXX,XX @@ qcow2_co_preadv_compressed(BlockDriverState *bs, |
36 | uint64_t file_cluster_offset, | ||
37 | uint64_t offset, | ||
38 | uint64_t bytes, | ||
39 | - QEMUIOVector *qiov); | ||
40 | + QEMUIOVector *qiov, | ||
41 | + size_t qiov_offset); | ||
42 | |||
43 | static int qcow2_probe(const uint8_t *buf, int buf_size, const char *filename) | ||
44 | { | ||
45 | @@ -XXX,XX +XXX,XX @@ out: | ||
46 | return ret; | ||
47 | } | ||
48 | |||
49 | -static coroutine_fn int qcow2_co_preadv(BlockDriverState *bs, uint64_t offset, | ||
50 | - uint64_t bytes, QEMUIOVector *qiov, | ||
51 | - int flags) | ||
52 | +static coroutine_fn int qcow2_co_preadv_part(BlockDriverState *bs, | ||
53 | + uint64_t offset, uint64_t bytes, | ||
54 | + QEMUIOVector *qiov, | ||
55 | + size_t qiov_offset, int flags) | ||
56 | { | ||
57 | BDRVQcow2State *s = bs->opaque; | ||
58 | int offset_in_cluster; | ||
59 | int ret; | ||
60 | unsigned int cur_bytes; /* number of bytes in current iteration */ | ||
61 | uint64_t cluster_offset = 0; | ||
62 | - uint64_t bytes_done = 0; | ||
63 | - QEMUIOVector hd_qiov; | ||
64 | uint8_t *cluster_data = NULL; | ||
65 | |||
66 | - qemu_iovec_init(&hd_qiov, qiov->niov); | ||
67 | - | ||
68 | while (bytes != 0) { | ||
69 | |||
70 | /* prepare next request */ | ||
71 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_preadv(BlockDriverState *bs, uint64_t offset, | ||
72 | |||
73 | offset_in_cluster = offset_into_cluster(s, offset); | ||
74 | |||
75 | - qemu_iovec_reset(&hd_qiov); | ||
76 | - qemu_iovec_concat(&hd_qiov, qiov, bytes_done, cur_bytes); | ||
77 | - | ||
78 | switch (ret) { | ||
79 | case QCOW2_CLUSTER_UNALLOCATED: | ||
80 | |||
81 | if (bs->backing) { | ||
82 | BLKDBG_EVENT(bs->file, BLKDBG_READ_BACKING_AIO); | ||
83 | - ret = bdrv_co_preadv(bs->backing, offset, cur_bytes, | ||
84 | - &hd_qiov, 0); | ||
85 | + ret = bdrv_co_preadv_part(bs->backing, offset, cur_bytes, | ||
86 | + qiov, qiov_offset, 0); | ||
87 | if (ret < 0) { | ||
88 | goto fail; | ||
89 | } | ||
90 | } else { | ||
91 | /* Note: in this case, no need to wait */ | ||
92 | - qemu_iovec_memset(&hd_qiov, 0, 0, cur_bytes); | ||
93 | + qemu_iovec_memset(qiov, qiov_offset, 0, cur_bytes); | ||
94 | } | ||
95 | break; | ||
96 | |||
97 | case QCOW2_CLUSTER_ZERO_PLAIN: | ||
98 | case QCOW2_CLUSTER_ZERO_ALLOC: | ||
99 | - qemu_iovec_memset(&hd_qiov, 0, 0, cur_bytes); | ||
100 | + qemu_iovec_memset(qiov, qiov_offset, 0, cur_bytes); | ||
101 | break; | ||
102 | |||
103 | case QCOW2_CLUSTER_COMPRESSED: | ||
104 | ret = qcow2_co_preadv_compressed(bs, cluster_offset, | ||
105 | offset, cur_bytes, | ||
106 | - &hd_qiov); | ||
107 | + qiov, qiov_offset); | ||
108 | if (ret < 0) { | ||
109 | goto fail; | ||
110 | } | ||
111 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_preadv(BlockDriverState *bs, uint64_t offset, | ||
112 | ret = -EIO; | ||
113 | goto fail; | ||
114 | } | ||
115 | - qemu_iovec_from_buf(qiov, bytes_done, cluster_data, cur_bytes); | ||
116 | + qemu_iovec_from_buf(qiov, qiov_offset, cluster_data, cur_bytes); | ||
117 | } else { | ||
118 | BLKDBG_EVENT(bs->file, BLKDBG_READ_AIO); | ||
119 | - ret = bdrv_co_preadv(s->data_file, | ||
120 | - cluster_offset + offset_in_cluster, | ||
121 | - cur_bytes, &hd_qiov, 0); | ||
122 | + ret = bdrv_co_preadv_part(s->data_file, | ||
123 | + cluster_offset + offset_in_cluster, | ||
124 | + cur_bytes, qiov, qiov_offset, 0); | ||
125 | if (ret < 0) { | ||
126 | goto fail; | ||
127 | } | ||
128 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_preadv(BlockDriverState *bs, uint64_t offset, | ||
129 | |||
130 | bytes -= cur_bytes; | ||
131 | offset += cur_bytes; | ||
132 | - bytes_done += cur_bytes; | ||
133 | + qiov_offset += cur_bytes; | ||
134 | } | ||
135 | ret = 0; | ||
136 | |||
137 | fail: | ||
138 | - qemu_iovec_destroy(&hd_qiov); | ||
139 | qemu_vfree(cluster_data); | ||
140 | |||
141 | return ret; | ||
142 | @@ -XXX,XX +XXX,XX @@ qcow2_co_preadv_compressed(BlockDriverState *bs, | ||
143 | uint64_t file_cluster_offset, | ||
144 | uint64_t offset, | ||
145 | uint64_t bytes, | ||
146 | - QEMUIOVector *qiov) | ||
147 | + QEMUIOVector *qiov, | ||
148 | + size_t qiov_offset) | ||
149 | { | ||
150 | BDRVQcow2State *s = bs->opaque; | ||
151 | int ret = 0, csize, nb_csectors; | ||
152 | @@ -XXX,XX +XXX,XX @@ qcow2_co_preadv_compressed(BlockDriverState *bs, | ||
61 | goto fail; | 153 | goto fail; |
62 | } | 154 | } |
63 | 155 | ||
64 | - s->cluster_cache = g_malloc(s->cluster_size); | 156 | - qemu_iovec_from_buf(qiov, 0, out_buf + offset_in_cluster, bytes); |
65 | - /* one more sector for decompressed data alignment */ | 157 | + qemu_iovec_from_buf(qiov, qiov_offset, out_buf + offset_in_cluster, bytes); |
66 | - s->cluster_data = qemu_try_blockalign(bs->file->bs, QCOW_MAX_CRYPT_CLUSTERS | 158 | |
67 | - * s->cluster_size + 512); | 159 | fail: |
68 | - if (s->cluster_data == NULL) { | 160 | qemu_vfree(out_buf); |
69 | - error_setg(errp, "Could not allocate temporary cluster buffer"); | 161 | @@ -XXX,XX +XXX,XX @@ static int qcow2_load_vmstate(BlockDriverState *bs, QEMUIOVector *qiov, |
70 | - ret = -ENOMEM; | 162 | BDRVQcow2State *s = bs->opaque; |
71 | - goto fail; | 163 | |
72 | - } | 164 | BLKDBG_EVENT(bs->file, BLKDBG_VMSTATE_LOAD); |
73 | - | 165 | - return bs->drv->bdrv_co_preadv(bs, qcow2_vm_state_offset(s) + pos, |
74 | s->cluster_cache_offset = -1; | 166 | - qiov->size, qiov, 0); |
75 | s->flags = flags; | 167 | + return bs->drv->bdrv_co_preadv_part(bs, qcow2_vm_state_offset(s) + pos, |
76 | 168 | + qiov->size, qiov, 0, 0); | |
77 | @@ -XXX,XX +XXX,XX @@ static int qcow2_do_open(BlockDriverState *bs, QDict *options, int flags, | 169 | } |
78 | if (s->refcount_block_cache) { | 170 | |
79 | qcow2_cache_destroy(bs, s->refcount_block_cache); | 171 | /* |
80 | } | 172 | @@ -XXX,XX +XXX,XX @@ BlockDriver bdrv_qcow2 = { |
81 | - g_free(s->cluster_cache); | 173 | .bdrv_has_zero_init_truncate = bdrv_has_zero_init_1, |
82 | - qemu_vfree(s->cluster_data); | 174 | .bdrv_co_block_status = qcow2_co_block_status, |
83 | qcrypto_block_free(s->crypto); | 175 | |
84 | qapi_free_QCryptoBlockOpenOptions(s->crypto_opts); | 176 | - .bdrv_co_preadv = qcow2_co_preadv, |
85 | return ret; | 177 | + .bdrv_co_preadv_part = qcow2_co_preadv_part, |
178 | .bdrv_co_pwritev = qcow2_co_pwritev, | ||
179 | .bdrv_co_flush_to_os = qcow2_co_flush_to_os, | ||
180 | |||
86 | -- | 181 | -- |
87 | 2.13.5 | 182 | 2.21.0 |
88 | 183 | ||
89 | 184 | diff view generated by jsdifflib |
1 | From: Alberto Garcia <berto@igalia.com> | 1 | From: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
---|---|---|---|
2 | 2 | ||
3 | Both the throttling limits set with the throttling.iops-* and | 3 | Implement and use new interface to get rid of hd_qiov. |
4 | throttling.bps-* options and their QMP equivalents defined in the | 4 | |
5 | BlockIOThrottle struct are integer values. | 5 | Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> |
6 | 6 | Acked-by: Stefan Hajnoczi <stefanha@redhat.com> | |
7 | Those limits are also reported in the BlockDeviceInfo struct and they | 7 | Message-id: 20190604161514.262241-13-vsementsov@virtuozzo.com |
8 | are integers there as well. | 8 | Message-Id: <20190604161514.262241-13-vsementsov@virtuozzo.com> |
9 | |||
10 | Therefore there's no reason to store them internally as double and do | ||
11 | the conversion everytime we're setting or querying them, so this patch | ||
12 | uses uint64_t for those types. Let's also use an unsigned type because | ||
13 | we don't allow negative values anyway. | ||
14 | |||
15 | LeakyBucket.level and LeakyBucket.burst_level do however remain double | ||
16 | because their value changes depending on the fraction of time elapsed | ||
17 | since the previous I/O operation. | ||
18 | |||
19 | Signed-off-by: Alberto Garcia <berto@igalia.com> | ||
20 | Message-id: f29b840422767b5be2c41c2dfdbbbf6c5f8fedf8.1503580370.git.berto@igalia.com | ||
21 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> | 9 | Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> |
22 | --- | 10 | --- |
23 | include/qemu/throttle.h | 4 ++-- | 11 | block/qcow2.h | 1 + |
24 | tests/test-throttle.c | 3 ++- | 12 | include/qemu/iov.h | 1 + |
25 | util/throttle.c | 7 +++---- | 13 | block/qcow2-cluster.c | 9 ++++--- |
26 | 3 files changed, 7 insertions(+), 7 deletions(-) | 14 | block/qcow2.c | 60 +++++++++++++++++++++---------------------- |
27 | 15 | util/iov.c | 10 ++++++++ | |
28 | diff --git a/include/qemu/throttle.h b/include/qemu/throttle.h | 16 | 5 files changed, 48 insertions(+), 33 deletions(-) |
29 | index XXXXXXX..XXXXXXX 100644 | 17 | |
30 | --- a/include/qemu/throttle.h | 18 | diff --git a/block/qcow2.h b/block/qcow2.h |
31 | +++ b/include/qemu/throttle.h | 19 | index XXXXXXX..XXXXXXX 100644 |
32 | @@ -XXX,XX +XXX,XX @@ typedef enum { | 20 | --- a/block/qcow2.h |
33 | */ | 21 | +++ b/block/qcow2.h |
34 | 22 | @@ -XXX,XX +XXX,XX @@ typedef struct QCowL2Meta | |
35 | typedef struct LeakyBucket { | 23 | * from @cow_start and @cow_end into one single write operation. |
36 | - double avg; /* average goal in units per second */ | 24 | */ |
37 | - double max; /* leaky bucket max burst in units */ | 25 | QEMUIOVector *data_qiov; |
38 | + uint64_t avg; /* average goal in units per second */ | 26 | + size_t data_qiov_offset; |
39 | + uint64_t max; /* leaky bucket max burst in units */ | 27 | |
40 | double level; /* bucket level in units */ | 28 | /** Pointer to next L2Meta of the same write request */ |
41 | double burst_level; /* bucket level in units (for computing bursts) */ | 29 | struct QCowL2Meta *next; |
42 | unsigned burst_length; /* max length of the burst period, in seconds */ | 30 | diff --git a/include/qemu/iov.h b/include/qemu/iov.h |
43 | diff --git a/tests/test-throttle.c b/tests/test-throttle.c | 31 | index XXXXXXX..XXXXXXX 100644 |
44 | index XXXXXXX..XXXXXXX 100644 | 32 | --- a/include/qemu/iov.h |
45 | --- a/tests/test-throttle.c | 33 | +++ b/include/qemu/iov.h |
46 | +++ b/tests/test-throttle.c | 34 | @@ -XXX,XX +XXX,XX @@ void qemu_iovec_init_extended( |
47 | @@ -XXX,XX +XXX,XX @@ static void test_enabled(void) | 35 | void *tail_buf, size_t tail_len); |
48 | for (i = 0; i < BUCKETS_COUNT; i++) { | 36 | void qemu_iovec_init_slice(QEMUIOVector *qiov, QEMUIOVector *source, |
49 | throttle_config_init(&cfg); | 37 | size_t offset, size_t len); |
50 | set_cfg_value(false, i, 150); | 38 | +int qemu_iovec_subvec_niov(QEMUIOVector *qiov, size_t offset, size_t len); |
51 | + g_assert(throttle_is_valid(&cfg, NULL)); | 39 | void qemu_iovec_add(QEMUIOVector *qiov, void *base, size_t len); |
52 | g_assert(throttle_enabled(&cfg)); | 40 | void qemu_iovec_concat(QEMUIOVector *dst, |
41 | QEMUIOVector *src, size_t soffset, size_t sbytes); | ||
42 | diff --git a/block/qcow2-cluster.c b/block/qcow2-cluster.c | ||
43 | index XXXXXXX..XXXXXXX 100644 | ||
44 | --- a/block/qcow2-cluster.c | ||
45 | +++ b/block/qcow2-cluster.c | ||
46 | @@ -XXX,XX +XXX,XX @@ static int perform_cow(BlockDriverState *bs, QCowL2Meta *m) | ||
47 | assert(start->nb_bytes <= UINT_MAX - end->nb_bytes); | ||
48 | assert(start->nb_bytes + end->nb_bytes <= UINT_MAX - data_bytes); | ||
49 | assert(start->offset + start->nb_bytes <= end->offset); | ||
50 | - assert(!m->data_qiov || m->data_qiov->size == data_bytes); | ||
51 | |||
52 | if ((start->nb_bytes == 0 && end->nb_bytes == 0) || m->skip_cow) { | ||
53 | return 0; | ||
54 | @@ -XXX,XX +XXX,XX @@ static int perform_cow(BlockDriverState *bs, QCowL2Meta *m) | ||
55 | /* The part of the buffer where the end region is located */ | ||
56 | end_buffer = start_buffer + buffer_size - end->nb_bytes; | ||
57 | |||
58 | - qemu_iovec_init(&qiov, 2 + (m->data_qiov ? m->data_qiov->niov : 0)); | ||
59 | + qemu_iovec_init(&qiov, 2 + (m->data_qiov ? | ||
60 | + qemu_iovec_subvec_niov(m->data_qiov, | ||
61 | + m->data_qiov_offset, | ||
62 | + data_bytes) | ||
63 | + : 0)); | ||
64 | |||
65 | qemu_co_mutex_unlock(&s->lock); | ||
66 | /* First we read the existing data from both COW regions. We | ||
67 | @@ -XXX,XX +XXX,XX @@ static int perform_cow(BlockDriverState *bs, QCowL2Meta *m) | ||
68 | if (start->nb_bytes) { | ||
69 | qemu_iovec_add(&qiov, start_buffer, start->nb_bytes); | ||
70 | } | ||
71 | - qemu_iovec_concat(&qiov, m->data_qiov, 0, data_bytes); | ||
72 | + qemu_iovec_concat(&qiov, m->data_qiov, m->data_qiov_offset, data_bytes); | ||
73 | if (end->nb_bytes) { | ||
74 | qemu_iovec_add(&qiov, end_buffer, end->nb_bytes); | ||
75 | } | ||
76 | diff --git a/block/qcow2.c b/block/qcow2.c | ||
77 | index XXXXXXX..XXXXXXX 100644 | ||
78 | --- a/block/qcow2.c | ||
79 | +++ b/block/qcow2.c | ||
80 | @@ -XXX,XX +XXX,XX @@ fail: | ||
81 | /* Check if it's possible to merge a write request with the writing of | ||
82 | * the data from the COW regions */ | ||
83 | static bool merge_cow(uint64_t offset, unsigned bytes, | ||
84 | - QEMUIOVector *hd_qiov, QCowL2Meta *l2meta) | ||
85 | + QEMUIOVector *qiov, size_t qiov_offset, | ||
86 | + QCowL2Meta *l2meta) | ||
87 | { | ||
88 | QCowL2Meta *m; | ||
89 | |||
90 | @@ -XXX,XX +XXX,XX @@ static bool merge_cow(uint64_t offset, unsigned bytes, | ||
91 | |||
92 | /* Make sure that adding both COW regions to the QEMUIOVector | ||
93 | * does not exceed IOV_MAX */ | ||
94 | - if (hd_qiov->niov > IOV_MAX - 2) { | ||
95 | + if (qemu_iovec_subvec_niov(qiov, qiov_offset, bytes) > IOV_MAX - 2) { | ||
96 | continue; | ||
97 | } | ||
98 | |||
99 | - m->data_qiov = hd_qiov; | ||
100 | + m->data_qiov = qiov; | ||
101 | + m->data_qiov_offset = qiov_offset; | ||
102 | return true; | ||
53 | } | 103 | } |
54 | 104 | ||
55 | for (i = 0; i < BUCKETS_COUNT; i++) { | 105 | @@ -XXX,XX +XXX,XX @@ static int handle_alloc_space(BlockDriverState *bs, QCowL2Meta *l2meta) |
56 | throttle_config_init(&cfg); | 106 | return 0; |
57 | set_cfg_value(false, i, -150); | 107 | } |
58 | - g_assert(!throttle_enabled(&cfg)); | 108 | |
59 | + g_assert(!throttle_is_valid(&cfg, NULL)); | 109 | -static coroutine_fn int qcow2_co_pwritev(BlockDriverState *bs, uint64_t offset, |
110 | - uint64_t bytes, QEMUIOVector *qiov, | ||
111 | - int flags) | ||
112 | +static coroutine_fn int qcow2_co_pwritev_part( | ||
113 | + BlockDriverState *bs, uint64_t offset, uint64_t bytes, | ||
114 | + QEMUIOVector *qiov, size_t qiov_offset, int flags) | ||
115 | { | ||
116 | BDRVQcow2State *s = bs->opaque; | ||
117 | int offset_in_cluster; | ||
118 | int ret; | ||
119 | unsigned int cur_bytes; /* number of sectors in current iteration */ | ||
120 | uint64_t cluster_offset; | ||
121 | - QEMUIOVector hd_qiov; | ||
122 | + QEMUIOVector encrypted_qiov; | ||
123 | uint64_t bytes_done = 0; | ||
124 | uint8_t *cluster_data = NULL; | ||
125 | QCowL2Meta *l2meta = NULL; | ||
126 | |||
127 | trace_qcow2_writev_start_req(qemu_coroutine_self(), offset, bytes); | ||
128 | |||
129 | - qemu_iovec_init(&hd_qiov, qiov->niov); | ||
130 | - | ||
131 | qemu_co_mutex_lock(&s->lock); | ||
132 | |||
133 | while (bytes != 0) { | ||
134 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_pwritev(BlockDriverState *bs, uint64_t offset, | ||
135 | |||
136 | qemu_co_mutex_unlock(&s->lock); | ||
137 | |||
138 | - qemu_iovec_reset(&hd_qiov); | ||
139 | - qemu_iovec_concat(&hd_qiov, qiov, bytes_done, cur_bytes); | ||
140 | - | ||
141 | if (bs->encrypted) { | ||
142 | assert(s->crypto); | ||
143 | if (!cluster_data) { | ||
144 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_pwritev(BlockDriverState *bs, uint64_t offset, | ||
145 | } | ||
146 | } | ||
147 | |||
148 | - assert(hd_qiov.size <= | ||
149 | - QCOW_MAX_CRYPT_CLUSTERS * s->cluster_size); | ||
150 | - qemu_iovec_to_buf(&hd_qiov, 0, cluster_data, hd_qiov.size); | ||
151 | + assert(cur_bytes <= QCOW_MAX_CRYPT_CLUSTERS * s->cluster_size); | ||
152 | + qemu_iovec_to_buf(qiov, qiov_offset + bytes_done, | ||
153 | + cluster_data, cur_bytes); | ||
154 | |||
155 | if (qcow2_co_encrypt(bs, cluster_offset, offset, | ||
156 | cluster_data, cur_bytes) < 0) { | ||
157 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_pwritev(BlockDriverState *bs, uint64_t offset, | ||
158 | goto out_unlocked; | ||
159 | } | ||
160 | |||
161 | - qemu_iovec_reset(&hd_qiov); | ||
162 | - qemu_iovec_add(&hd_qiov, cluster_data, cur_bytes); | ||
163 | + qemu_iovec_init_buf(&encrypted_qiov, cluster_data, cur_bytes); | ||
164 | } | ||
165 | |||
166 | /* Try to efficiently initialize the physical space with zeroes */ | ||
167 | @@ -XXX,XX +XXX,XX @@ static coroutine_fn int qcow2_co_pwritev(BlockDriverState *bs, uint64_t offset, | ||
168 | * writing of the guest data together with that of the COW regions. | ||
169 | * If it's not possible (or not necessary) then write the | ||
170 | * guest data now. */ | ||
171 | - if (!merge_cow(offset, cur_bytes, &hd_qiov, l2meta)) { | ||
172 | + if (!merge_cow(offset, cur_bytes, | ||
173 | + bs->encrypted ? &encrypted_qiov : qiov, | ||
174 | + bs->encrypted ? 0 : qiov_offset + bytes_done, l2meta)) | ||
175 | + { | ||
176 | BLKDBG_EVENT(bs->file, BLKDBG_WRITE_AIO); | ||
177 | trace_qcow2_writev_data(qemu_coroutine_self(), | ||
178 | cluster_offset + offset_in_cluster); | ||
179 | - ret = bdrv_co_pwritev(s->data_file, | ||
180 | - cluster_offset + offset_in_cluster, | ||
181 | - cur_bytes, &hd_qiov, 0); | ||
182 | + ret = bdrv_co_pwritev_part( | ||
183 | + s->data_file, cluster_offset + offset_in_cluster, cur_bytes, | ||
184 | + bs->encrypted ? &encrypted_qiov : qiov, | ||
185 | + bs->encrypted ? 0 : qiov_offset + bytes_done, 0); | ||
186 | if (ret < 0) { | ||
187 | goto out_unlocked; | ||
188 | } | ||
189 | @@ -XXX,XX +XXX,XX @@ out_locked: | ||
190 | |||
191 | qemu_co_mutex_unlock(&s->lock); | ||
192 | |||
193 | - qemu_iovec_destroy(&hd_qiov); | ||
194 | qemu_vfree(cluster_data); | ||
195 | trace_qcow2_writev_done_req(qemu_coroutine_self(), ret); | ||
196 | |||
197 | @@ -XXX,XX +XXX,XX @@ fail: | ||
198 | /* XXX: put compressed sectors first, then all the cluster aligned | ||
199 | tables to avoid losing bytes in alignment */ | ||
200 | static coroutine_fn int | ||
201 | -qcow2_co_pwritev_compressed(BlockDriverState *bs, uint64_t offset, | ||
202 | - uint64_t bytes, QEMUIOVector *qiov) | ||
203 | +qcow2_co_pwritev_compressed_part(BlockDriverState *bs, | ||
204 | + uint64_t offset, uint64_t bytes, | ||
205 | + QEMUIOVector *qiov, size_t qiov_offset) | ||
206 | { | ||
207 | BDRVQcow2State *s = bs->opaque; | ||
208 | int ret; | ||
209 | @@ -XXX,XX +XXX,XX @@ qcow2_co_pwritev_compressed(BlockDriverState *bs, uint64_t offset, | ||
210 | /* Zero-pad last write if image size is not cluster aligned */ | ||
211 | memset(buf + bytes, 0, s->cluster_size - bytes); | ||
60 | } | 212 | } |
213 | - qemu_iovec_to_buf(qiov, 0, buf, bytes); | ||
214 | + qemu_iovec_to_buf(qiov, qiov_offset, buf, bytes); | ||
215 | |||
216 | out_buf = g_malloc(s->cluster_size); | ||
217 | |||
218 | @@ -XXX,XX +XXX,XX @@ qcow2_co_pwritev_compressed(BlockDriverState *bs, uint64_t offset, | ||
219 | buf, s->cluster_size); | ||
220 | if (out_len == -ENOMEM) { | ||
221 | /* could not compress: write normal cluster */ | ||
222 | - ret = qcow2_co_pwritev(bs, offset, bytes, qiov, 0); | ||
223 | + ret = qcow2_co_pwritev_part(bs, offset, bytes, qiov, qiov_offset, 0); | ||
224 | if (ret < 0) { | ||
225 | goto fail; | ||
226 | } | ||
227 | @@ -XXX,XX +XXX,XX @@ static int qcow2_save_vmstate(BlockDriverState *bs, QEMUIOVector *qiov, | ||
228 | BDRVQcow2State *s = bs->opaque; | ||
229 | |||
230 | BLKDBG_EVENT(bs->file, BLKDBG_VMSTATE_SAVE); | ||
231 | - return bs->drv->bdrv_co_pwritev(bs, qcow2_vm_state_offset(s) + pos, | ||
232 | - qiov->size, qiov, 0); | ||
233 | + return bs->drv->bdrv_co_pwritev_part(bs, qcow2_vm_state_offset(s) + pos, | ||
234 | + qiov->size, qiov, 0, 0); | ||
61 | } | 235 | } |
62 | 236 | ||
63 | diff --git a/util/throttle.c b/util/throttle.c | 237 | static int qcow2_load_vmstate(BlockDriverState *bs, QEMUIOVector *qiov, |
64 | index XXXXXXX..XXXXXXX 100644 | 238 | @@ -XXX,XX +XXX,XX @@ BlockDriver bdrv_qcow2 = { |
65 | --- a/util/throttle.c | 239 | .bdrv_co_block_status = qcow2_co_block_status, |
66 | +++ b/util/throttle.c | 240 | |
67 | @@ -XXX,XX +XXX,XX @@ int64_t throttle_compute_wait(LeakyBucket *bkt) | 241 | .bdrv_co_preadv_part = qcow2_co_preadv_part, |
68 | /* If bkt->max is 0 we still want to allow short bursts of I/O | 242 | - .bdrv_co_pwritev = qcow2_co_pwritev, |
69 | * from the guest, otherwise every other request will be throttled | 243 | + .bdrv_co_pwritev_part = qcow2_co_pwritev_part, |
70 | * and performance will suffer considerably. */ | 244 | .bdrv_co_flush_to_os = qcow2_co_flush_to_os, |
71 | - bucket_size = bkt->avg / 10; | 245 | |
72 | + bucket_size = (double) bkt->avg / 10; | 246 | .bdrv_co_pwrite_zeroes = qcow2_co_pwrite_zeroes, |
73 | burst_bucket_size = 0; | 247 | @@ -XXX,XX +XXX,XX @@ BlockDriver bdrv_qcow2 = { |
74 | } else { | 248 | .bdrv_co_copy_range_from = qcow2_co_copy_range_from, |
75 | /* If we have a burst limit then we have to wait until all I/O | 249 | .bdrv_co_copy_range_to = qcow2_co_copy_range_to, |
76 | * at burst rate has finished before throttling to bkt->avg */ | 250 | .bdrv_co_truncate = qcow2_co_truncate, |
77 | bucket_size = bkt->max * bkt->burst_length; | 251 | - .bdrv_co_pwritev_compressed = qcow2_co_pwritev_compressed, |
78 | - burst_bucket_size = bkt->max / 10; | 252 | + .bdrv_co_pwritev_compressed_part = qcow2_co_pwritev_compressed_part, |
79 | + burst_bucket_size = (double) bkt->max / 10; | 253 | .bdrv_make_empty = qcow2_make_empty, |
80 | } | 254 | |
81 | 255 | .bdrv_snapshot_create = qcow2_snapshot_create, | |
82 | /* If the main bucket is full then we have to wait */ | 256 | diff --git a/util/iov.c b/util/iov.c |
83 | @@ -XXX,XX +XXX,XX @@ bool throttle_is_valid(ThrottleConfig *cfg, Error **errp) | 257 | index XXXXXXX..XXXXXXX 100644 |
84 | 258 | --- a/util/iov.c | |
85 | for (i = 0; i < BUCKETS_COUNT; i++) { | 259 | +++ b/util/iov.c |
86 | LeakyBucket *bkt = &cfg->buckets[i]; | 260 | @@ -XXX,XX +XXX,XX @@ static struct iovec *qiov_slice(QEMUIOVector *qiov, |
87 | - if (bkt->avg < 0 || bkt->max < 0 || | 261 | return iov; |
88 | - bkt->avg > THROTTLE_VALUE_MAX || bkt->max > THROTTLE_VALUE_MAX) { | 262 | } |
89 | + if (bkt->avg > THROTTLE_VALUE_MAX || bkt->max > THROTTLE_VALUE_MAX) { | 263 | |
90 | error_setg(errp, "bps/iops/max values must be within [0, %lld]", | 264 | +int qemu_iovec_subvec_niov(QEMUIOVector *qiov, size_t offset, size_t len) |
91 | THROTTLE_VALUE_MAX); | 265 | +{ |
92 | return false; | 266 | + size_t head, tail; |
267 | + int niov; | ||
268 | + | ||
269 | + qiov_slice(qiov, offset, len, &head, &tail, &niov); | ||
270 | + | ||
271 | + return niov; | ||
272 | +} | ||
273 | + | ||
274 | /* | ||
275 | * Compile new iovec, combining @head_buf buffer, sub-qiov of @mid_qiov, | ||
276 | * and @tail_buf buffer into new qiov. | ||
93 | -- | 277 | -- |
94 | 2.13.5 | 278 | 2.21.0 |
95 | 279 | ||
96 | 280 | diff view generated by jsdifflib |