aboutsummaryrefslogtreecommitdiff
path: root/doc/src/sgml/pgtestfsync.sgml
blob: 2889059c82cdf438e3f61c4eb866ea55ca11b0c2 (plain)
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
<!-- doc/src/sgml/pgtestfsync.sgml -->

<sect1 id="pgtestfsync" xreflabel="pg_test_fsync">
 <title>pg_test_fsync</title>

 <indexterm zone="pgtestfsync">
  <primary>pg_test_fsync</primary>
 </indexterm>

 <para>
  <application>pg_test_fsync</> is intended to give you a reasonable
  idea of what the fastest <xref linkend="guc-wal-sync-method"> is on your
  specific system,
  as well as supplying diagnostic information in the event of an
  identified I/O problem.  However, differences shown by pg_test_fsync
  might not make any difference in real database throughput, especially
  since many database servers are not speed-limited by their transaction
  logs.
 </para>

 <sect2>
  <title>Usage</title>

<synopsis>
pg_test_fsync [options]
</synopsis>

   <para>
    <application>pg_test_fsync</application> accepts the following
    command-line options:

    <variablelist>

     <varlistentry>
      <term><option>-f</option></term>
      <term><option>--filename</option></term>
      <listitem>
       <para>
        Specifies the file name to write test data in.
        This file should be in the same file system that the
        <filename>pg_xlog</> directory is or will be placed in.
        (<filename>pg_xlog</> contains the <acronym>WAL</> files.)
        The default is <filename>pg_test_fsync.out</> in the current
        directory.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><option>-o</option></term>
      <term><option>--ops-per-test</option></term>
      <listitem>
       <para>
        Specifies the number of operations per test.  The more operations
        per test, the greater the test's accuracy, but the longer it takes
        to run.  The default is 2000.
       </para>
      </listitem>
     </varlistentry>

    </variablelist>
   </para>

 </sect2>

 <sect2>
  <title>Author</title>

  <para>
   Bruce Momjian <email>bruce@momjian.us</email>
  </para>
 </sect2>

</sect1>