1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 8.2.2" />
\r
7 <style type="text/css">
\r
9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
\r
11 border: 1px solid red;
\r
16 margin: 1em 5% 1em 5%;
\r
21 text-decoration: underline;
\r
39 h1, h2, h3, h4, h5, h6 {
\r
41 font-family: sans-serif;
\r
43 margin-bottom: 0.5em;
\r
48 border-bottom: 2px solid silver;
\r
51 border-bottom: 2px solid silver;
\r
61 border: 1px solid silver;
\r
66 margin-bottom: 0.5em;
\r
76 font-family: sans-serif;
\r
83 font-family: sans-serif;
\r
87 font-family: sans-serif;
\r
89 border-top: 2px solid silver;
\r
95 padding-bottom: 0.5em;
\r
99 padding-bottom: 0.5em;
\r
103 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
104 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
105 div.admonitionblock {
\r
108 margin-bottom: 1.5em;
\r
110 div.admonitionblock {
\r
112 margin-bottom: 2.5em;
\r
115 div.content { /* Block element content. */
\r
119 /* Block element titles. */
\r
120 div.title, caption.title {
\r
121 font-family: sans-serif;
\r
125 margin-bottom: 0.5em;
\r
131 td div.title:first-child {
\r
134 div.content div.title:first-child {
\r
137 div.content + div.title {
\r
141 div.sidebarblock > div.content {
\r
142 background: #ffffee;
\r
143 border: 1px solid silver;
\r
150 div.listingblock > div.content {
\r
151 border: 1px solid silver;
\r
152 background: #f4f4f4;
\r
156 div.quoteblock > div.content {
\r
157 padding-left: 2.0em;
\r
163 div.verseblock + div.attribution {
\r
167 div.admonitionblock .icon {
\r
168 vertical-align: top;
\r
171 text-decoration: underline;
\r
173 padding-right: 0.5em;
\r
175 div.admonitionblock td.content {
\r
176 padding-left: 0.5em;
\r
177 border-left: 2px solid silver;
\r
180 div.exampleblock > div.content {
\r
181 border-left: 2px solid silver;
\r
185 div.verseblock div.content {
\r
189 div.imageblock div.content { padding-left: 0; }
\r
190 div.imageblock img { border: 1px solid silver; }
\r
191 span.image img { border-style: none; }
\r
195 margin-bottom: 0.8em;
\r
200 font-style: italic;
\r
202 dd > *:first-child {
\r
207 list-style-position: outside;
\r
210 list-style-type: lower-alpha;
\r
213 div.tableblock > table {
\r
214 border: 3px solid #527bbd;
\r
217 font-family: sans-serif;
\r
226 margin-bottom: 0.8em;
\r
229 padding-bottom: 5px;
\r
232 vertical-align: top;
\r
233 font-style: italic;
\r
234 padding-right: 0.8em;
\r
237 vertical-align: top;
\r
241 div#footer-badges { display: none; }
\r
246 font-family: sans-serif;
\r
250 margin-bottom: 0.1em;
\r
253 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
269 /* Workarounds for IE6's broken and incomplete CSS2. */
\r
271 div.sidebar-content {
\r
272 background: #ffffee;
\r
273 border: 1px solid silver;
\r
276 div.sidebar-title, div.image-title {
\r
277 font-family: sans-serif;
\r
280 margin-bottom: 0.5em;
\r
283 div.listingblock div.content {
\r
284 border: 1px solid silver;
\r
285 background: #f4f4f4;
\r
289 div.quoteblock-content {
\r
290 padding-left: 2.0em;
\r
293 div.exampleblock-content {
\r
294 border-left: 2px solid silver;
\r
295 padding-left: 0.5em;
\r
298 /* IE6 sets dynamically generated links as visited. */
\r
299 div#toc a:visited { color: blue; }
\r
301 <title>ZTEST(1)</title>
\r
306 <span id="author">Michael Gebetsroither</span><br />
\r
307 <span id="email"><tt><<a href="mailto:michael.geb@gmx.at">michael.geb@gmx.at</a>></tt></span><br />
\r
310 <div class="sectionbody">
\r
311 <p>ztest - was written by the ZFS Developers as a ZFS unit test.</p>
\r
314 <div class="sectionbody">
\r
315 <p><strong>ztest</strong> <options></p>
\r
317 <h2>DESCRIPTION</h2>
\r
318 <div class="sectionbody">
\r
319 <p>This manual page documents briefly the <strong>ztest</strong> command.</p>
\r
320 <p><strong>ztest</strong> was written by the ZFS Developers as a ZFS unit test. The tool was
\r
321 developed in tandem with the ZFS functionality and was executed nightly as one
\r
322 of the many regression test against the daily build. As features were added to
\r
323 ZFS, unit tests were also added to ztest. In addition, a separate test
\r
324 development team wrote and executed more functional and stress tests.</p>
\r
325 <p>By default <strong>ztest</strong> runs for ten minutes and uses block files (stored in /tmp)
\r
326 to create pools rather than using physical disks. Block files afford <strong>ztest</strong>
\r
327 its flexibility to play around with zpool components without requiring large
\r
328 hardware configurations. However, storing the block files in /tmp may not work
\r
329 for you if you have a small tmp directory.</p>
\r
330 <p>By default is non-verbose. This is why entering the command above will result
\r
331 in <strong>ztest</strong> quietly executing for 5 minutes. The -V option can be used to
\r
332 increase the verbosity of the tool. Adding multiple -V option is allowed and
\r
333 the more you add the more chatty <strong>ztest</strong> becomes.</p>
\r
334 <p>After the <strong>ztest</strong> run completes, you should notice many ztest.* files lying
\r
335 around. Once the run completes you can safely remove these files. Note that you
\r
336 shouldn't remove these files during a run. You can re-use these files in your
\r
337 next *ztest* run by using the -E option.</p>
\r
340 <div class="sectionbody">
\r
343 <strong>-?</strong>
\r
347 Print a help summary
\r
351 <strong>-v vdevs (default: 5)</strong>
\r
359 <strong>-s size_of_each_vdev (default: 64M)</strong>
\r
367 <strong>-a alignment_shift (default: 9) (use 0 for random)</strong>
\r
371 Used alignment in test.
\r
375 <strong>-m mirror_copies (default: 2)</strong>
\r
379 Number of mirror copies.
\r
383 <strong>-r raidz_disks (default: 4)</strong>
\r
387 Number of raidz disks.
\r
391 <strong>-R raidz_parity (default: 1)</strong>
\r
399 <strong>-d datasets (default: 7)</strong>
\r
403 Number of datasets.
\r
407 <strong>-t threads (default: 23)</strong>
\r
415 <strong>-g gang_block_threshold (default: 32K)</strong>
\r
419 Gang block threshold.
\r
423 <strong>-i initialize pool i times (default: 1)</strong>
\r
427 Number of pool initialisations.
\r
431 <strong>-k kill percentage (default: 70%)</strong>
\r
439 <strong>-p pool_name (default: ztest)</strong>
\r
447 <strong>-f file directory for vdev files (default: /tmp)</strong>
\r
451 Directory for vdev files.
\r
455 <strong>-V(erbose)</strong>
\r
459 Verbose (use multiple times for ever more blather).
\r
463 <strong>-E(xisting)</strong>
\r
467 Use existing pool (use existing pool instead of creating new one).
\r
471 <strong>-T time (default: 300 sec)</strong>
\r
475 Total test run time.
\r
479 <strong>-P passtime (default: 60 sec)</strong>
\r
487 <strong>-z zil failure rate (default: fail every 2^5 allocs)</strong>
\r
491 Injected failure rate.
\r
497 <div class="sectionbody">
\r
498 <p>To override /tmp as your location for block files, you can use the -f option:</p>
\r
499 <div class="listingblock">
\r
500 <div class="content">
\r
501 <pre><tt> ztest -f /</tt></pre>
\r
503 <p>To get an idea of what ztest is actually testing try this:</p>
\r
504 <div class="listingblock">
\r
505 <div class="content">
\r
506 <pre><tt> ztest -f / -VVV</tt></pre>
\r
508 <p>Maybe you'd like to run ztest for longer? To do so simply use the -T option and
\r
509 specify the runlength in seconds like so:</p>
\r
510 <div class="listingblock">
\r
511 <div class="content">
\r
512 <pre><tt> ztest -f / -V -T 120</tt></pre>
\r
516 <div class="sectionbody">
\r
517 <p>zpool(1), zfs(1), zdb(1), zfs-fuse(1)</p>
\r
520 <div class="sectionbody">
\r
521 <p>This manual page was transvered to asciidoc by Michael Gebetsroither
\r
522 <gebi@grml.org> from http://opensolaris.org/os/community/zfs/ztest/</p>
\r
525 <div id="footer-text">
\r
526 Last updated 01-Nov-2009 04:31:46 CEST
\r