registry: add comment explaining workflow to make store_keys safe w/o transactions
authorMichael Adam <obnox@samba.org>
Tue, 6 May 2008 08:06:34 +0000 (10:06 +0200)
committerMichael Adam <obnox@samba.org>
Thu, 8 May 2008 16:29:10 +0000 (18:29 +0200)
commit01e640f6ea609ec2235543d69b1715a1be7d09b3
tree79c7dea2a701c610f560dafc0efc5b866040cdd3
parent7fa4cd242163cf048785585b7a1f392aeefeb20f
registry: add comment explaining workflow to make store_keys safe w/o transactions

/*
 * Make the store operation as safe as possible without transactions:
 *
 * (1) For each subkey removed from ctr compared with old_subkeys:
 *
 *     (a) First delete the value db entry.
 *
 *     (b) Next delete the secdesc db record.
 *
 *     (c) Then delete the subkey list entry.
 *
 * (2) Now write the list of subkeys of the parent key,
 *     deleting removed entries and adding new ones.
 *
 * (3) Finally create the subkey list entries for the added keys.
 *
 * This way if we crash half-way in between deleting the subkeys
 * and storing the parent's list of subkeys, no old data can pop up
 * out of the blue when re-adding keys later on.
 */

The workflow is going to be modified to meet this agendain the next commits.

Michael
(This used to be commit 55dd9bdd148fc942e15aacfe9f6b38b1a5c53158)
source3/registry/reg_backend_db.c