vault.h

/*
    This file is part of Pretty Curved Privacy (pcp1).

    Copyright (C) 2013-2015 T.v.Dein.

    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 3 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/>.

    You can contact me by mail: <tom AT vondein DOT org>.
*/


#ifndef _HAVE_PCP_VAULT
#define _HAVE_PCP_VAULT

#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <sodium.h>
#include <unistd.h>

#include "defines.h"
#include "platform.h"
#include "mem.h"
#include "key.h"
#include "uthash.h"
#include "buffer.h"
#include "keysig.h"
#include "structs.h"
#include "context.h"


vault_t *pcpvault_init(PCPCTX *ptx, char *filename);


/*  Creates a new vault file. Called internally only.
    If is_tmp If set to 1, create a temporary vault file.
 */
vault_t *pcpvault_new(PCPCTX *ptx, char *filename, int is_tmp);


/*  Writes the initial vault header to the vault.
    Called internally only. */
int pcpvault_create(PCPCTX *ptx, vault_t *vault);


int pcpvault_additem(PCPCTX *ptx, vault_t *vault, void *item, size_t itemsize, uint8_t type);


int pcpvault_addkey(PCPCTX *ptx, vault_t *vault, void *item, uint8_t type);


int pcpvault_close(PCPCTX *ptx, vault_t *vault);

void pcpvault_free(vault_t *vault);

int pcpvault_fetchall(PCPCTX *ptx, vault_t *vault);


/* Write everything back to disk. */
int pcpvault_writeall(PCPCTX *ptx, vault_t *vault);

/* copy a vault to another file */
int pcpvault_copy(PCPCTX *ptx, vault_t *tmp, vault_t *vault);

/* delete a vault file */
void pcpvault_unlink(vault_t *tmp);

/* calculate the checksum of the current vault (that is, from the
   list of keys in the current context */
byte *pcpvault_create_checksum(PCPCTX *ptx);

/* write the new checksum to the header of the current vault */
void pcpvault_update_checksum(PCPCTX *ptx, vault_t *vault);

/* bigendian converters */
vault_header_t * vh2be(vault_header_t *h);
vault_header_t * vh2native(vault_header_t *h);
vault_item_header_t * ih2be(vault_item_header_t *h);
vault_item_header_t * ih2native(vault_item_header_t *h);

#endif /*  _HAVE_PCP_VAULT */