~ubuntu-branches/ubuntu/utopic/postgresql-9.4/utopic-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/html/app-pgreceivexlog.html

  • Committer: Package Import Robot
  • Author(s): Martin Pitt, CVE-2014-8161
  • Date: 2015-02-06 12:31:46 UTC
  • mfrom: (1.1.5) (7.1.2 utopic-proposed)
  • Revision ID: package-import@ubuntu.com-20150206123146-vtmf30jbkm7w16p8
Tags: 9.4.1-0ubuntu0.14.10
* New upstream security/bug fix release (LP: #1418928)
  - Fix buffer overruns in to_char() [CVE-2015-0241]
  - Fix buffer overruns in contrib/pgcrypto [CVE-2015-0243]
  - Fix possible loss of frontend/backend protocol synchronization after an
    error [CVE-2015-0244]
  - Fix information leak via constraint-violation error messages
    [CVE-2014-8161]
  - See release notes for details about other fixes:
    http://www.postgresql.org/about/news/1569/

Show diffs side-by-side

added added

removed removed

Lines of Context:
9
9
REV="MADE"
10
10
HREF="mailto:pgsql-docs@postgresql.org"><LINK
11
11
REL="HOME"
12
 
TITLE="PostgreSQL 9.4beta3 Documentation"
 
12
TITLE="PostgreSQL 9.4.1 Documentation"
13
13
HREF="index.html"><LINK
14
14
REL="UP"
15
15
TITLE="PostgreSQL Client Applications"
26
26
HTTP-EQUIV="Content-Type"
27
27
CONTENT="text/html; charset=ISO-8859-1"><META
28
28
NAME="creation"
29
 
CONTENT="2014-10-06T18:35:22"></HEAD
 
29
CONTENT="2015-02-02T20:51:01"></HEAD
30
30
><BODY
31
31
CLASS="REFENTRY"
32
32
><DIV
44
44
VALIGN="bottom"
45
45
><A
46
46
HREF="index.html"
47
 
>PostgreSQL 9.4beta3 Documentation</A
 
47
>PostgreSQL 9.4.1 Documentation</A
48
48
></TH
49
49
></TR
50
50
><TR
95
95
><DIV
96
96
CLASS="REFNAMEDIV"
97
97
><A
98
 
NAME="AEN88961"
 
98
NAME="AEN89159"
99
99
></A
100
100
><H2
101
101
>Name</H2
102
 
>pg_receivexlog&nbsp;--&nbsp;streams transaction logs from a <SPAN
 
102
>pg_receivexlog&nbsp;--&nbsp;stream transaction logs from a <SPAN
103
103
CLASS="PRODUCTNAME"
104
104
>PostgreSQL</SPAN
105
 
> cluster</DIV
 
105
> server</DIV
106
106
><DIV
107
107
CLASS="REFSYNOPSISDIV"
108
108
><A
109
 
NAME="AEN88965"
 
109
NAME="AEN89163"
110
110
></A
111
111
><H2
112
112
>Synopsis</H2
124
124
><DIV
125
125
CLASS="REFSECT1"
126
126
><A
127
 
NAME="AEN88970"
 
127
NAME="AEN89168"
128
128
></A
129
129
><H2
130
130
>   Description
208
208
><DIV
209
209
CLASS="REFSECT1"
210
210
><A
211
 
NAME="AEN88990"
 
211
NAME="AEN89188"
212
212
></A
213
213
><H2
214
214
>Options</H2
215
215
><P
216
 
>    The following command-line options control the location and format of the
217
 
    output.
218
 
 
219
 
    <P
220
216
></P
221
 
></P><DIV
 
217
><DIV
222
218
CLASS="VARIABLELIST"
223
219
><DL
224
220
><DT
247
243
>        This parameter is required.
248
244
       </P
249
245
></DD
250
 
></DL
251
 
></DIV
252
 
><P>
253
 
   </P
254
 
><P
255
 
>    The following command-line options control the running of the program.
256
 
 
257
 
    <P
258
 
></P
259
 
></P><DIV
260
 
CLASS="VARIABLELIST"
261
 
><DL
262
246
><DT
263
247
><TT
264
248
CLASS="OPTION"
276
260
><DT
277
261
><TT
278
262
CLASS="OPTION"
 
263
>-s <TT
 
264
CLASS="REPLACEABLE"
 
265
><I
 
266
>interval</I
 
267
></TT
 
268
></TT
 
269
><BR><TT
 
270
CLASS="OPTION"
 
271
>--status-interval=<TT
 
272
CLASS="REPLACEABLE"
 
273
><I
 
274
>interval</I
 
275
></TT
 
276
></TT
 
277
></DT
 
278
><DD
 
279
><P
 
280
>        Specifies the number of seconds between status packets sent back to the
 
281
        server. This allows for easier monitoring of the progress from server.
 
282
        A value of zero disables the periodic status updates completely,
 
283
        although an update will still be sent when requested by the server, to
 
284
        avoid timeout disconnect. The default value is 10 seconds.
 
285
       </P
 
286
></DD
 
287
><DT
 
288
><TT
 
289
CLASS="OPTION"
 
290
>-S <TT
 
291
CLASS="REPLACEABLE"
 
292
><I
 
293
>slotname</I
 
294
></TT
 
295
></TT
 
296
><BR><TT
 
297
CLASS="OPTION"
 
298
>--slot=<TT
 
299
CLASS="REPLACEABLE"
 
300
><I
 
301
>slotname</I
 
302
></TT
 
303
></TT
 
304
></DT
 
305
><DD
 
306
><P
 
307
>         Require <SPAN
 
308
CLASS="APPLICATION"
 
309
>pg_receivexlog</SPAN
 
310
> to use an existing
 
311
         replication slot (see <A
 
312
HREF="warm-standby.html#STREAMING-REPLICATION-SLOTS"
 
313
>Section 25.2.6</A
 
314
>).
 
315
         When this option is used, <SPAN
 
316
CLASS="APPLICATION"
 
317
>pg_receivexlog</SPAN
 
318
> will report
 
319
         a flush position to the server, indicating when each segment has been
 
320
         synchronized to disk so that the server can remove that segment if it
 
321
         is not otherwise needed.  When using this parameter, it is important
 
322
         to make sure that <SPAN
 
323
CLASS="APPLICATION"
 
324
>pg_receivexlog</SPAN
 
325
> cannot become the
 
326
         synchronous standby through an incautious setting of
 
327
         <A
 
328
HREF="runtime-config-replication.html#GUC-SYNCHRONOUS-STANDBY-NAMES"
 
329
>synchronous_standby_names</A
 
330
>; it does not flush
 
331
         data frequently enough for this to work correctly.
 
332
        </P
 
333
></DD
 
334
><DT
 
335
><TT
 
336
CLASS="OPTION"
279
337
>-v</TT
280
338
><BR><TT
281
339
CLASS="OPTION"
288
346
></DD
289
347
></DL
290
348
></DIV
291
 
><P>
292
 
   </P
293
349
><P
294
350
>    The following command-line options control the database connection parameters.
295
351
 
399
455
><DT
400
456
><TT
401
457
CLASS="OPTION"
402
 
>-s <TT
403
 
CLASS="REPLACEABLE"
404
 
><I
405
 
>interval</I
406
 
></TT
407
 
></TT
408
 
><BR><TT
409
 
CLASS="OPTION"
410
 
>--status-interval=<TT
411
 
CLASS="REPLACEABLE"
412
 
><I
413
 
>interval</I
414
 
></TT
415
 
></TT
416
 
></DT
417
 
><DD
418
 
><P
419
 
>        Specifies the number of seconds between status packets sent back to the
420
 
        server. This allows for easier monitoring of the progress from server.
421
 
        A value of zero disables the periodic status updates completely,
422
 
        although an update will still be sent when requested by the server, to
423
 
        avoid timeout disconnect. The default value is 10 seconds.
424
 
       </P
425
 
></DD
426
 
><DT
427
 
><TT
428
 
CLASS="OPTION"
429
458
>-U <TT
430
459
CLASS="REPLACEABLE"
431
460
><I
502
531
        connection attempt.
503
532
       </P
504
533
></DD
505
 
><DT
506
 
><TT
507
 
CLASS="OPTION"
508
 
>-S <TT
509
 
CLASS="REPLACEABLE"
510
 
><I
511
 
>slotname</I
512
 
></TT
513
 
></TT
514
 
><BR><TT
515
 
CLASS="OPTION"
516
 
>--slot=<TT
517
 
CLASS="REPLACEABLE"
518
 
><I
519
 
>slotname</I
520
 
></TT
521
 
></TT
522
 
></DT
523
 
><DD
524
 
><P
525
 
>         Require <SPAN
526
 
CLASS="APPLICATION"
527
 
>pg_receivexlog</SPAN
528
 
> to use an existing
529
 
         replication slot (see <A
530
 
HREF="warm-standby.html#STREAMING-REPLICATION-SLOTS"
531
 
>Section 25.2.6</A
532
 
>).
533
 
         When this option is used, <SPAN
534
 
CLASS="APPLICATION"
535
 
>pg_receivexlog</SPAN
536
 
> will report
537
 
         a flush position to the server, indicating when each segment has been
538
 
         synchronized to disk so that the server can remove that segment if it
539
 
         is not otherwise needed.  When using this parameter, it is important
540
 
         to make sure that <SPAN
541
 
CLASS="APPLICATION"
542
 
>pg_receivexlog</SPAN
543
 
> cannot become the
544
 
         synchronous standby through an incautious setting of
545
 
         <A
546
 
HREF="runtime-config-replication.html#GUC-SYNCHRONOUS-STANDBY-NAMES"
547
 
>synchronous_standby_names</A
548
 
>; it does not flush
549
 
         data frequently enough for this to work correctly.
550
 
        </P
551
 
></DD
552
534
></DL
553
535
></DIV
554
536
><P>
602
584
><DIV
603
585
CLASS="REFSECT1"
604
586
><A
605
 
NAME="AEN89125"
 
587
NAME="AEN89320"
606
588
></A
607
589
><H2
608
590
>Environment</H2
624
606
><DIV
625
607
CLASS="REFSECT1"
626
608
><A
627
 
NAME="AEN89131"
 
609
NAME="AEN89326"
628
610
></A
629
611
><H2
630
612
>Notes</H2
636
618
   <A
637
619
HREF="runtime-config-wal.html#GUC-ARCHIVE-COMMAND"
638
620
>archive_command</A
639
 
>, the server will continue to
640
 
   recycle transaction log files even if the backups are not properly
641
 
   archived, since there is no command that fails. This can be worked
642
 
   around by having an <A
 
621
> as the main WAL backup method, it is
 
622
   strongly recommended to use replication slots.  Otherwise, the server is
 
623
   free to recycle or remove transaction log files before they are backed up,
 
624
   because it does not have any information, either
 
625
   from <A
643
626
HREF="runtime-config-wal.html#GUC-ARCHIVE-COMMAND"
644
627
>archive_command</A
645
 
> that fails
646
 
   when the file has not been properly archived yet, for example:
647
 
</P><PRE
648
 
CLASS="PROGRAMLISTING"
649
 
>archive_command = 'sleep 5 &amp;&amp; test -f /mnt/server/archivedir/%f'</PRE
650
 
><P>
651
 
   The initial timeout is necessary because
652
 
   <SPAN
653
 
CLASS="APPLICATION"
654
 
>pg_receivexlog</SPAN
655
 
> works using asynchronous
656
 
   replication and can therefore be slightly behind the master.
 
628
> or the replication slots, about
 
629
   how far the WAL stream has been archived.  Note, however, that a
 
630
   replication slot will fill up the server's disk space if the receiver does
 
631
   not keep up with fetching the WAL data.
657
632
  </P
658
633
></DIV
659
634
><DIV
660
635
CLASS="REFSECT1"
661
636
><A
662
 
NAME="AEN89139"
 
637
NAME="AEN89332"
663
638
></A
664
639
><H2
665
640
>Examples</H2
687
662
><DIV
688
663
CLASS="REFSECT1"
689
664
><A
690
 
NAME="AEN89147"
 
665
NAME="AEN89340"
691
666
></A
692
667
><H2
693
668
>See Also</H2