/usr/include/libgda-5.0/libgda/gda-xa-transaction.h is in libgda-5.0-dev 5.2.4-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | /*
* Copyright (C) 2008 - 2011 Vivien Malerba <malerba@gnome-db.org>
* Copyright (C) 2011 Murray Cumming <murrayc@murrayc.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __GDA_XA_TRANSACTION_H__
#define __GDA_XA_TRANSACTION_H__
#include <glib-object.h>
#include <libgda/gda-enums.h>
#include <libgda/gda-decl.h>
G_BEGIN_DECLS
#define GDA_TYPE_XA_TRANSACTION (gda_xa_transaction_get_type())
#define GDA_XA_TRANSACTION(obj) (G_TYPE_CHECK_INSTANCE_CAST (obj, GDA_TYPE_XA_TRANSACTION, GdaXaTransaction))
#define GDA_XA_TRANSACTION_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST (klass, GDA_TYPE_XA_TRANSACTION, GdaXaTransactionClass))
#define GDA_IS_XA_TRANSACTION(obj) (G_TYPE_CHECK_INSTANCE_TYPE(obj, GDA_TYPE_XA_TRANSACTION))
#define GDA_IS_XA_TRANSACTION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GDA_TYPE_XA_TRANSACTION))
typedef struct _GdaXaTransaction GdaXaTransaction;
typedef struct _GdaXaTransactionClass GdaXaTransactionClass;
typedef struct _GdaXaTransactionPrivate GdaXaTransactionPrivate;
typedef struct _GdaXaTransactionId GdaXaTransactionId;
/* error reporting */
extern GQuark gda_xa_transaction_error_quark (void);
#define GDA_XA_TRANSACTION_ERROR gda_xa_transaction_error_quark ()
typedef enum
{
GDA_XA_TRANSACTION_ALREADY_REGISTERED_ERROR,
GDA_XA_TRANSACTION_DTP_NOT_SUPPORTED_ERROR,
GDA_XA_TRANSACTION_CONNECTION_BRANCH_LENGTH_ERROR
} GdaXaTransactionError;
struct _GdaXaTransaction {
GObject object;
GdaXaTransactionPrivate *priv;
};
struct _GdaXaTransactionClass {
GObjectClass parent_class;
/*< private >*/
/* Padding for future expansion */
void (*_gda_reserved1) (void);
void (*_gda_reserved2) (void);
void (*_gda_reserved3) (void);
void (*_gda_reserved4) (void);
};
/**
* GdaXaTransactionId:
* @format: any number
* @gtrid_length: number between 1 and 64
* @bqual_length: number between 1 and 64
* @data:
*/
struct _GdaXaTransactionId {
guint32 format;
gushort gtrid_length;
gushort bqual_length;
char data [128];
};
/**
* SECTION:gda-xa-transaction
* @short_description: Distributed transaction manager
* @title: GdaXaTransaction
* @stability: Stable
* @see_also:
*
* The #GdaXaTransaction object acts as a distributed transaction manager: to make sure local transactions on several
* connections (to possibly different databases and database types) either all succeed or all fail. For more information,
* see the X/Open CAE document Distributed Transaction Processing: The XA Specification.
* This document is published by The Open Group and available at
* <ulink url="http://www.opengroup.org/public/pubs/catalog/c193.htm">http://www.opengroup.org/public/pubs/catalog/c193.htm</ulink>.
*
* The two phases commit protocol is implemented during the execution of a distributed transaction: modifications
* made on any connection are first <emphasis>prepared</emphasis> (which means that they are store in the database), and
* if that phase succeeded for all the involved connections, then the <emphasis>commit</emphasis> phase is executed
* (where all the data previously stored during the <emphasis>prepare</emphasis> phase are actually committed).
* That second phase may actually fail, but the distributed transaction will still be considered as successfull
* as the data stored during the <emphasis>prepare</emphasis> phase can be committed afterwards.
*
* A distributed transaction involves the following steps:
* <orderedlist>
* <listitem><para>Create a #GdaXaTransaction object</para></listitem>
* <listitem><para>Register the connections which will be part of the distributed transaction with that object
* using gda_xa_transaction_register_connection()</para></listitem>
* <listitem><para>Beging the distributed transaction using gda_xa_transaction_begin()</para></listitem>
* <listitem><para>Work individually on each connection as normally (make modifications)</para></listitem>
* <listitem><para>Commit the distributed transaction using gda_xa_transaction_commit()</para></listitem>
* <listitem><para>Discard the #GdaXaTransaction object using g_object_unref()</para></listitem>
* </orderedlist>
*/
GType gda_xa_transaction_get_type (void) G_GNUC_CONST;
GdaXaTransaction *gda_xa_transaction_new (guint32 format, const gchar *global_transaction_id);
gboolean gda_xa_transaction_register_connection (GdaXaTransaction *xa_trans, GdaConnection *cnc,
const gchar *branch, GError **error);
void gda_xa_transaction_unregister_connection (GdaXaTransaction *xa_trans, GdaConnection *cnc);
gboolean gda_xa_transaction_begin (GdaXaTransaction *xa_trans, GError **error);
gboolean gda_xa_transaction_commit (GdaXaTransaction *xa_trans, GSList **cnc_to_recover, GError **error);
gboolean gda_xa_transaction_rollback (GdaXaTransaction *xa_trans, GError **error);
gboolean gda_xa_transaction_commit_recovered (GdaXaTransaction *xa_trans, GSList **cnc_to_recover,
GError **error);
/* utility functions */
gchar *gda_xa_transaction_id_to_string (const GdaXaTransactionId *xid);
GdaXaTransactionId *gda_xa_transaction_string_to_id (const gchar *str);
G_END_DECLS
#endif
|