1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>xNBD Change Log</title><link rel="stylesheet" type="text/css" href="docbook-xsl.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /></head><body><div xml:lang="en" class="article" title="xNBD Change Log" lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="idp152640"></a>xNBD Change Log</h2></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="section"><a href="#_0_3_0">0.3.0</a></span></dt><dd><dl><dt><span class="section"><a href="#_bugfixes">Bugfixes</a></span></dt><dt><span class="section"><a href="#_improvements">Improvements</a></span></dt></dl></dd><dt><span class="section"><a href="#_0_2_0_rc2">0.2.0-rc2</a></span></dt><dd><dl><dt><span class="section"><a href="#_bugfixes_2">Bugfixes</a></span></dt></dl></dd><dt><span class="section"><a href="#_0_2_0_rc1">0.2.0-rc1</a></span></dt><dd><dl><dt><span class="section"><a href="#_bugfixes_3">Bugfixes</a></span></dt><dt><span class="section"><a href="#_improvements_2">Improvements</a></span></dt><dt><span class="section"><a href="#_deprecations">Deprecations</a></span></dt><dt><span class="section"><a href="#_changes_relevant_to_packaging">Changes relevant to packaging</a></span></dt></dl></dd><dt><span class="section"><a href="#_0_1_0_pre_hg20_e75b93a47722">0.1.0-pre-hg20-e75b93a47722</a></span></dt><dd><dl><dt><span class="section"><a href="#_bugfixes_4">Bugfixes</a></span></dt><dt><span class="section"><a href="#_improvements_3">Improvements</a></span></dt></dl></dd><dt><span class="section"><a href="#_0_1_0_pre">0.1.0-pre</a></span></dt></dl></div><div class="section" title="0.3.0"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_0_3_0"></a>0.3.0</h2></div></div></div><div class="section" title="Bugfixes"><div class="titlepage"><div><div><h3 class="title"><a id="_bugfixes"></a>Bugfixes</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
xnbd-server: Fix --readonly option for the proxy server. Reject write
requests from clients, but may update the cache image file.
</li><li class="listitem">
xnbd-server: Fix erroneous assertions caused by xnbd-bgctl (issues #6 and #8).
</li></ul></div></div><div class="section" title="Improvements"><div class="titlepage"><div><div><h3 class="title"><a id="_improvements"></a>Improvements</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
xnbd-server: Add --max-queue-size and --max-buf-size parameters that limit
memory usage of xnbd-server so that a slow disk and fast network no longer may
force the host into swapping
</li><li class="listitem">
xnbd-server: Fix version output by --version
</li><li class="listitem">
xnbd-bgctl: Limit the number of asynchronous requests to avoid huge memory
consumption of xnbd-server.
</li><li class="listitem">
xnbd-bgctl: Improve the progress bar to be more accurate. Go forward
according to the percentage of actually cached blocks.
</li><li class="listitem">
xnbd-wrapper: Support passing custom --max-(buf|queue)-size to xnbd-server
</li><li class="listitem">
xnbd-register: Add support for wrapper options max_buf_size and max_queue_size
</li><li class="listitem">
xnbd-register: Fix warning on unknown wrapper option keys
</li></ul></div></div></div><div class="section" title="0.2.0-rc2"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_0_2_0_rc2"></a>0.2.0-rc2</h2></div></div></div><div class="section" title="Bugfixes"><div class="titlepage"><div><div><h3 class="title"><a id="_bugfixes_2"></a>Bugfixes</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
xnbd-register: Fix and improve --help usage output
</li><li class="listitem">
xnbd-wrapper: Fix reporting of disk size 0 for non-empty, non-regular files
in target mode (issue #7)
</li></ul></div></div></div><div class="section" title="0.2.0-rc1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_0_2_0_rc1"></a>0.2.0-rc1</h2></div></div></div><div class="section" title="Bugfixes"><div class="titlepage"><div><div><h3 class="title"><a id="_bugfixes_3"></a>Bugfixes</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
Fix false positives in network error detection
</li><li class="listitem">
xnbd-server: By default, use syslog in daemon mode for logging, not /tmp/xnbd.log.
This fixes the vulnerability to symlink attacks on /tmp/xnbd.log (CVE-2013-0265).
</li><li class="listitem">
xnbd-server: No longer let network errors stop entire proxy server (issue #3)
</li><li class="listitem">
xnbd-server: Make --shutdown work for wrapped servers (issue #5)
</li><li class="listitem">
xnbd-(bgctl|server): Use SIGUSR2 (rather than SIGHUP) for internal (issue #2)
</li><li class="listitem">
xnbd-bgctl: Detect wrapped servers for --cache-all2 (related to issue #4)
</li><li class="listitem">
xnbd-wrapper: Make sure no zombie servers are left behind
</li><li class="listitem">
xnbd-wrapper: Fix race conditions in disk registration
</li><li class="listitem">
xnbd-wrapper: Fix unspecified behavior from calling pthread_detach() twice
</li><li class="listitem">
xnbd-wrapper(-ctl): Add support for filenames containing spaces or newlines
</li><li class="listitem">
xnbd-client: Actually apply retry count from --retry|-r COUNT
</li><li class="listitem">
xnbd-wrapper-ctl: Fix leading whitespace in echoed server output
</li><li class="listitem">
xnbd-wrapper: On missing disk file, error out rather than sending bogus disk size
</li><li class="listitem">
xnbd-wrapper: Fix locating xnbd-server binary
</li><li class="listitem">
xnbd-wrapper: Fix unintended termination when the process is stopped and continued
</li><li class="listitem">
Fix typos in program output and man pages
</li></ul></div></div><div class="section" title="Improvements"><div class="titlepage"><div><div><h3 class="title"><a id="_improvements_2"></a>Improvements</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
xnbd-bgctl: Improve the speed of --cache-all
</li><li class="listitem">
xnbd-bgctl: Add optional progress bar to --cache-all operation
</li><li class="listitem">
xnbd-bgctl: Guard --shutdown/--switch by --force, i.e. prevent premature switching
</li><li class="listitem">
xnbd-bgctl: Make --shutdown/--switch wait for the server to finish
</li><li class="listitem">
xnbd-bgctl: Show caching percentage in --query output communication
</li><li class="listitem">
xnbd-bgctl: Allow reconnecting a proxy to wrapped servers
</li><li class="listitem">
xnbd-client: Add support for symlinks to NBD devices
</li><li class="listitem">
xnbd-client: Mode --check now returns code 2 for a valid, unused NBD device
</li><li class="listitem">
xnbd-register: New tool, integrated from Debian
</li><li class="listitem">
xnbd-register: Exit gracefully if config file missing
</li><li class="listitem">
xnbd-register: Add --config option
</li><li class="listitem">
xnbd-register: Add support for export names
</li><li class="listitem">
xnbd-register: Stop clients before wrapper (since they might be using the wrapper)
</li><li class="listitem">
xnbd-server: Fix broken startup with GLib 2.32 or later
</li><li class="listitem">
xnbd-server: Keep existing bitmap state by default, add option --clear-bitmap
</li><li class="listitem">
xnbd-server: Prevent re-use of bitmap with different disk size
</li><li class="listitem">
xnbd-server: Add support for wrapped remote servers to proxy mode (through option
--target-exportname)
</li><li class="listitem">
xnbd-server: Stop writing to failed client connections
</li><li class="listitem">
xnbd-server: Document --connected-fd in man page
</li><li class="listitem">
xnbd-(server|wrapper): Add --syslog parameter
</li><li class="listitem">
xnbd-wrapper: Resolve hard limit to 32 registered disks
</li><li class="listitem">
xnbd-wrapper: Keep disk indices constant during runtime
</li><li class="listitem">
xnbd-wrapper: Document --cow and --readonly in man page
</li><li class="listitem">
xnbd-wrapper: Add --xnbd-bgctl parameter
</li><li class="listitem">
xnbd-wrapper(-ctl): Change default control socket path from /tmp/xnbd_wrapper.ctl
to /var/run/xnbd-wrapper.ctl as a measure of precaution
</li><li class="listitem">
xnbd-wrapper(-ctl): Distinct export and file name, support removal by export name
or file name, too
</li><li class="listitem">
xnbd-wrapper(-ctl): Add support for proxy mode images through commands --add-proxy,
--bgctl-query, --bgctl-cache-all, --bgctl-switch, and --bgctl-reconnect
</li><li class="listitem">
xnbd-wrapper-ctl: Forward error return code from xnbd-wrapper
</li><li class="listitem">
xnbd-wrapper-ctl: Improve reporting on socket opening errors
</li><li class="listitem">
Improve man pages, help output, error reporting
</li></ul></div></div><div class="section" title="Deprecations"><div class="titlepage"><div><div><h3 class="title"><a id="_deprecations"></a>Deprecations</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
xnbd-wrapper: Deprecate --port in favor of --lport
</li><li class="listitem">
xnbd-wrapper: Deprecate --xnbd-binary in favor of --xnbd-server
</li><li class="listitem">
xnbd-wrapper(-ctl): Deprecate --add in favor of --add-target
</li><li class="listitem">
xnbd-wrapper(-ctl): Deprecate --remove in favor of --remove-by-file
and --remove-by-exportname
</li><li class="listitem">
xnbd-server: Deprecate --shutdown in favor of --switch
</li><li class="listitem">
xnbd-register: Deprecate config key "server" in favor of "wrapper"
</li></ul></div></div><div class="section" title="Changes relevant to packaging"><div class="titlepage"><div><div><h3 class="title"><a id="_changes_relevant_to_packaging"></a>Changes relevant to packaging</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
Build system migrated to GNU autotools (autoconf, automake, libtool)
</li><li class="listitem">
Man pages now shipped pre-built as Troff and HTML, too; no more docbook-to-man
</li><li class="listitem">
Man page compression now left to downstream
</li><li class="listitem">
xnbd-wrapper-ctl now depends on Python 2.6 and argparse
</li></ul></div></div></div><div class="section" title="0.1.0-pre-hg20-e75b93a47722"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_0_1_0_pre_hg20_e75b93a47722"></a>0.1.0-pre-hg20-e75b93a47722</h2></div></div></div><p>While technically this never was an upstream release, it is the state that people
running xNBD on Debian GNU/Linux are familiar with. So we decided to make an
artificial cut.</p><div class="section" title="Bugfixes"><div class="titlepage"><div><div><h3 class="title"><a id="_bugfixes_4"></a>Bugfixes</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
xnbd-server: Fix migration of disks larger than 4GB on a 32bit operating system
</li><li class="listitem">
xnbd-(bgctl|server): Handle memory mapping failure properly
</li><li class="listitem">
Various build system fixes
</li></ul></div></div><div class="section" title="Improvements"><div class="titlepage"><div><div><h3 class="title"><a id="_improvements_3"></a>Improvements</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
xnbd-server: Add --inetd option
</li><li class="listitem">
xnbd-server: Increase proxy read queue size from 10 requests to 32 requests
</li><li class="listitem">
xnbd-wrapper: Add --daemonize, --logpath, --cow, and --readonly
</li><li class="listitem">
xnbd-wrapper: Improve --help output
</li><li class="listitem">
xnbd-wrapper(-ctl): Add --shutdown option
</li><li class="listitem">
xnbd-wrapper-ctl: Rename -d (for delete) to -r (for remove)
</li><li class="listitem">
xnbd-wrapper-ctl: Add long option versions: --list, --add, --remove, --socket
</li><li class="listitem">
Add man pages xnbd-wrapper, xnbd-wrapper-ctl
</li><li class="listitem">
Improve and extend existing man pages
</li></ul></div></div></div><div class="section" title="0.1.0-pre"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_0_1_0_pre"></a>0.1.0-pre</h2></div></div></div><p>Starting point of the change log.</p></div></div></body></html>
|
