079bff693b
Invoke the transaction drivers' .clean() methods only after all .commit() or .abort() handlers are done. This makes it easier to have nested transactions where the top-level transactions pass objects to lower transactions that the latter can still use throughout their commit/abort phases, while the top-level transaction keeps a reference that is released in its .clean() method. (Before this commit, that is also possible, but the top-level transaction would need to take care to invoke tran_add() before the lower-level transaction does. This commit makes the ordering irrelevant, which is just a bit nicer.) Signed-off-by: Hanna Reitz <hreitz@redhat.com> Message-Id: <20211111120829.81329-8-hreitz@redhat.com> Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> Signed-off-by: Kevin Wolf <kwolf@redhat.com> Message-Id: <20211115145409.176785-8-kwolf@redhat.com> Signed-off-by: Hanna Reitz <hreitz@redhat.com>
67 lines
2.2 KiB
C
67 lines
2.2 KiB
C
/*
|
|
* Simple transactions API
|
|
*
|
|
* Copyright (c) 2021 Virtuozzo International GmbH.
|
|
*
|
|
* Author:
|
|
* Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*
|
|
* = Generic transaction API =
|
|
*
|
|
* The intended usage is the following: you create "prepare" functions, which
|
|
* represents the actions. They will usually have Transaction* argument, and
|
|
* call tran_add() to register finalization callbacks. For finalization
|
|
* callbacks, prepare corresponding TransactionActionDrv structures.
|
|
*
|
|
* Then, when you need to make a transaction, create an empty Transaction by
|
|
* tran_create(), call your "prepare" functions on it, and finally call
|
|
* tran_abort() or tran_commit() to finalize the transaction by corresponding
|
|
* finalization actions in reverse order.
|
|
*
|
|
* The clean() functions registered by the drivers in a transaction are called
|
|
* last, after all abort() or commit() functions have been called.
|
|
*/
|
|
|
|
#ifndef QEMU_TRANSACTIONS_H
|
|
#define QEMU_TRANSACTIONS_H
|
|
|
|
#include <gmodule.h>
|
|
|
|
typedef struct TransactionActionDrv {
|
|
void (*abort)(void *opaque);
|
|
void (*commit)(void *opaque);
|
|
void (*clean)(void *opaque);
|
|
} TransactionActionDrv;
|
|
|
|
typedef struct Transaction Transaction;
|
|
|
|
Transaction *tran_new(void);
|
|
void tran_add(Transaction *tran, TransactionActionDrv *drv, void *opaque);
|
|
void tran_abort(Transaction *tran);
|
|
void tran_commit(Transaction *tran);
|
|
|
|
static inline void tran_finalize(Transaction *tran, int ret)
|
|
{
|
|
if (ret < 0) {
|
|
tran_abort(tran);
|
|
} else {
|
|
tran_commit(tran);
|
|
}
|
|
}
|
|
|
|
#endif /* QEMU_TRANSACTIONS_H */
|