2011-03-07 00:39:14 +01:00
|
|
|
/*-------------------------------------------------------------------------
|
|
|
|
|
*
|
|
|
|
|
* syncrep.h
|
|
|
|
|
* Exports from replication/syncrep.c.
|
|
|
|
|
*
|
2014-01-07 22:05:30 +01:00
|
|
|
* Portions Copyright (c) 2010-2014, PostgreSQL Global Development Group
|
2011-03-07 00:39:14 +01:00
|
|
|
*
|
2011-03-10 07:05:33 +01:00
|
|
|
* IDENTIFICATION
|
|
|
|
|
* src/include/replication/syncrep.h
|
2011-03-07 00:39:14 +01:00
|
|
|
*
|
|
|
|
|
*-------------------------------------------------------------------------
|
|
|
|
|
*/
|
|
|
|
|
#ifndef _SYNCREP_H
|
|
|
|
|
#define _SYNCREP_H
|
|
|
|
|
|
2012-08-28 15:46:08 +02:00
|
|
|
#include "access/xlogdefs.h"
|
2011-03-07 00:39:14 +01:00
|
|
|
#include "utils/guc.h"
|
|
|
|
|
|
2012-01-24 21:22:37 +01:00
|
|
|
#define SyncRepRequested() \
|
|
|
|
|
(max_wal_senders > 0 && synchronous_commit > SYNCHRONOUS_COMMIT_LOCAL_FLUSH)
|
|
|
|
|
|
|
|
|
|
/* SyncRepWaitMode */
|
|
|
|
|
#define SYNC_REP_NO_WAIT -1
|
|
|
|
|
#define SYNC_REP_WAIT_WRITE 0
|
|
|
|
|
#define SYNC_REP_WAIT_FLUSH 1
|
|
|
|
|
|
|
|
|
|
#define NUM_SYNC_REP_WAIT_MODE 2
|
|
|
|
|
|
2011-03-07 00:39:14 +01:00
|
|
|
/* syncRepState */
|
|
|
|
|
#define SYNC_REP_NOT_WAITING 0
|
|
|
|
|
#define SYNC_REP_WAITING 1
|
|
|
|
|
#define SYNC_REP_WAIT_COMPLETE 2
|
|
|
|
|
|
|
|
|
|
/* user-settable parameters for synchronous replication */
|
|
|
|
|
extern char *SyncRepStandbyNames;
|
|
|
|
|
|
|
|
|
|
/* called by user backend */
|
|
|
|
|
extern void SyncRepWaitForLSN(XLogRecPtr XactCommitLSN);
|
|
|
|
|
|
2011-08-10 18:20:30 +02:00
|
|
|
/* called at backend exit */
|
|
|
|
|
extern void SyncRepCleanupAtProcExit(void);
|
2011-03-07 00:39:14 +01:00
|
|
|
|
|
|
|
|
/* called by wal sender */
|
|
|
|
|
extern void SyncRepInitConfig(void);
|
|
|
|
|
extern void SyncRepReleaseWaiters(void);
|
|
|
|
|
|
2013-05-23 17:34:30 +02:00
|
|
|
/* called by checkpointer */
|
Fix various possible problems with synchronous replication.
1. Don't ignore query cancel interrupts. Instead, if the user asks to
cancel the query after we've already committed it, but before it's on
the standby, just emit a warning and let the COMMIT finish.
2. Don't ignore die interrupts (pg_terminate_backend or fast shutdown).
Instead, emit a warning message and close the connection without
acknowledging the commit. Other backends will still see the effect of
the commit, but there's no getting around that; it's too late to abort
at this point, and ignoring die interrupts altogether doesn't seem like
a good idea.
3. If synchronous_standby_names becomes empty, wake up all backends
waiting for synchronous replication to complete. Without this, someone
attempting to shut synchronous replication off could easily wedge the
entire system instead.
4. Avoid depending on the assumption that if a walsender updates
MyProc->syncRepState, we'll see the change even if we read it without
holding the lock. The window for this appears to be quite narrow (and
probably doesn't exist at all on machines with strong memory ordering)
but protecting against it is practically free, so do that.
5. Remove useless state SYNC_REP_MUST_DISCONNECT, which isn't needed and
doesn't actually do anything.
There's still some further work needed here to make the behavior of fast
shutdown plausible, but that looks complex, so I'm leaving it for a
separate commit. Review by Fujii Masao.
2011-03-17 18:10:42 +01:00
|
|
|
extern void SyncRepUpdateSyncStandbysDefined(void);
|
|
|
|
|
|
2011-03-07 00:39:14 +01:00
|
|
|
/* called by various procs */
|
2012-01-24 21:22:37 +01:00
|
|
|
extern int SyncRepWakeQueue(bool all, int mode);
|
2011-09-04 07:13:16 +02:00
|
|
|
|
2011-04-07 06:11:01 +02:00
|
|
|
extern bool check_synchronous_standby_names(char **newval, void **extra, GucSource source);
|
2012-01-24 21:22:37 +01:00
|
|
|
extern void assign_synchronous_commit(int newval, void *extra);
|
2011-03-07 00:39:14 +01:00
|
|
|
|
|
|
|
|
#endif /* _SYNCREP_H */
|
