← Back to branch summary

~ubuntu-branches/debian/sid/postgresql-9.3/sid

« back to all changes in this revision

Viewing changes to doc/src/sgml/pgtestfsync.sgml

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2013-05-08 05:39:52 UTC
  • Revision ID: package-import@ubuntu.com-20130508053952-1j7uilp7mjtrvq8q
Tags: upstream-9.3~beta1
Import upstream version 9.3~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/pgtestfsync.sgml
 
1
<!-- doc/src/sgml/pgtestfsync.sgml -->
 
2
 
 
3
<refentry id="pgtestfsync">
 
4
 <refmeta>
 
5
  <refentrytitle><application>pg_test_fsync</application></refentrytitle>
 
6
  <manvolnum>1</manvolnum>
 
7
  <refmiscinfo>Application</refmiscinfo>
 
8
 </refmeta>
 
9
 
 
10
 <refnamediv>
 
11
  <refname>pg_test_fsync</refname>
 
12
  <refpurpose>determine fastest wal_sync_method for <productname>PostgreSQL</productname></refpurpose>
 
13
 </refnamediv>
 
14
 
 
15
 <indexterm zone="pgtestfsync">
 
16
  <primary>pg_test_fsync</primary>
 
17
 </indexterm>
 
18
 
 
19
 <refsynopsisdiv>
 
20
  <cmdsynopsis>
 
21
   <command>pg_test_fsync</command>
 
22
   <arg rep="repeat"><replaceable>option</replaceable></arg>
 
23
  </cmdsynopsis>
 
24
 </refsynopsisdiv>
 
25
 
 
26
 <refsect1>
 
27
  <title>Description</title>
 
28
 
 
29
 <para>
 
30
  <application>pg_test_fsync</> is intended to give you a reasonable
 
31
  idea of what the fastest <xref linkend="guc-wal-sync-method"> is on your
 
32
  specific system,
 
33
  as well as supplying diagnostic information in the event of an identified I/O
 
34
  problem.  However, differences shown by
 
35
  <application>pg_test_fsync</application> might not make any significant
 
36
  difference in real database throughput, especially since many database servers
 
37
  are not speed-limited by their transaction logs.
 
38
  <application>pg_test_fsync</application> reports average file sync operation
 
39
  time in microseconds for each wal_sync_method, which can also be used to
 
40
  inform efforts to optimize the value of <xref linkend="guc-commit-delay">.
 
41
 </para>
 
42
 </refsect1>
 
43
 
 
44
 <refsect1>
 
45
  <title>Options</title>
 
46
 
 
47
   <para>
 
48
    <application>pg_test_fsync</application> accepts the following
 
49
    command-line options:
 
50
 
 
51
    <variablelist>
 
52
 
 
53
     <varlistentry>
 
54
      <term><option>-f</option></term>
 
55
      <term><option>--filename</option></term>
 
56
      <listitem>
 
57
       <para>
 
58
        Specifies the file name to write test data in.
 
59
        This file should be in the same file system that the
 
60
        <filename>pg_xlog</> directory is or will be placed in.
 
61
        (<filename>pg_xlog</> contains the <acronym>WAL</> files.)
 
62
        The default is <filename>pg_test_fsync.out</> in the current
 
63
        directory.
 
64
       </para>
 
65
      </listitem>
 
66
     </varlistentry>
 
67
 
 
68
     <varlistentry>
 
69
      <term><option>-s</option></term>
 
70
      <term><option>--secs-per-test</option></term>
 
71
      <listitem>
 
72
       <para>
 
73
        Specifies the number of seconds for each test.  The more time
 
74
        per test, the greater the test's accuracy, but the longer it takes
 
75
        to run.  The default is 5 seconds, which allows the program to
 
76
        complete in under 2 minutes.
 
77
       </para>
 
78
      </listitem>
 
79
     </varlistentry>
 
80
 
 
81
     <varlistentry>
 
82
      <term><option>-V</></term>
 
83
      <term><option>--version</></term>
 
84
      <listitem>
 
85
       <para>
 
86
        Print the <application>pg_test_fsync</application> version and exit.
 
87
       </para>
 
88
      </listitem>
 
89
     </varlistentry>
 
90
 
 
91
     <varlistentry>
 
92
      <term><option>-?</></term>
 
93
      <term><option>--help</></term>
 
94
      <listitem>
 
95
       <para>
 
96
        Show help about <application>pg_test_fsync</application> command line
 
97
        arguments, and exit.
 
98
       </para>
 
99
      </listitem>
 
100
     </varlistentry>
 
101
    </variablelist>
 
102
   </para>
 
103
 
 
104
 </refsect1>
 
105
 
 
106
 <refsect1>
 
107
  <title>Author</title>
 
108
 
 
109
  <para>
 
110
   Bruce Momjian <email>bruce@momjian.us</email>
 
111
  </para>
 
112
 </refsect1>
 
113
 
 
114
 <refsect1>
 
115
  <title>See Also</title>
 
116
 
 
117
  <simplelist type="inline">
 
118
   <member><xref linkend="app-postgres"></member>
 
119
  </simplelist>
 
120
 </refsect1>
 
121
</refentry>