path: root/lib/libalpm/db.c

/*
 *  db.c
 *
 *  Copyright (c) 2006-2011 Pacman Development Team <pacman-dev@archlinux.org>
 *  Copyright (c) 2002-2006 by Judd Vinet <jvinet@zeroflux.org>
 *  Copyright (c) 2005 by Aurelien Foret <orelien@chez.com>
 *  Copyright (c) 2005 by Christian Hamar <krics@linuxforum.hu>
 *  Copyright (c) 2006 by David Kimpe <dnaku@frugalware.org>
 *  Copyright (c) 2005, 2006 by Miklos Vajna <vmiklos@frugalware.org>
 *
 *  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/>.
 */

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <regex.h>

/* libalpm */
#include "db.h"
#include "alpm_list.h"
#include "log.h"
#include "util.h"
#include "handle.h"
#include "alpm.h"
#include "package.h"
#include "group.h"

/** \addtogroup alpm_databases Database Functions
 * @brief Functions to query and manipulate the database of libalpm
 * @{
 */

/** Register a sync database of packages. */
alpm_db_t SYMEXPORT *alpm_db_register_sync(alpm_handle_t *handle,
    const char *treename, alpm_siglevel_t level)
{
  /* Sanity checks */
  CHECK_HANDLE(handle, return NULL);
  ASSERT(treename != NULL && strlen(treename) != 0,
      RET_ERR(handle, ALPM_ERR_WRONG_ARGS, NULL));
  /* Do not register a database if a transaction is on-going */
  ASSERT(handle->trans == NULL, RET_ERR(handle, ALPM_ERR_TRANS_NOT_NULL, NULL));

  return _alpm_db_register_sync(handle, treename, level);
}

/* Helper function for alpm_db_unregister{_all} */
void _alpm_db_unregister(alpm_db_t *db)
{
  if(db == NULL) {
    return;
  }

  _alpm_log(db->handle, ALPM_LOG_DEBUG, "unregistering database '%s'\n", db->treename);
  _alpm_db_free(db);
}

/** Unregister all package databases. */
int SYMEXPORT alpm_db_unregister_all(alpm_handle_t *handle)
{
  alpm_list_t *i;
  alpm_db_t *db;

  /* Sanity checks */
  CHECK_HANDLE(handle, return -1);
  /* Do not unregister a database if a transaction is on-going */
  ASSERT(handle->trans == NULL, RET_ERR(handle, ALPM_ERR_TRANS_NOT_NULL, -1));

  /* unregister all sync dbs */
  for(i = handle->dbs_sync; i; i = i->next) {
    db = i->data;
    db->ops->unregister(db);
    i->data = NULL;
  }
  FREELIST(handle->dbs_sync);
  return 0;
}

/** Unregister a package database. */
int SYMEXPORT alpm_db_unregister(alpm_db_t *db)
{
  int found = 0;
  alpm_handle_t *handle;

  /* Sanity checks */
  ASSERT(db != NULL, return -1);
  /* Do not unregister a database if a transaction is on-going */
  handle = db->handle;
  handle->pm_errno = 0;
  ASSERT(handle->trans == NULL, RET_ERR(handle, ALPM_ERR_TRANS_NOT_NULL, -1));

  if(db == handle->db_local) {
    handle->db_local = NULL;
    found = 1;
  } else {
    /* Warning : this function shouldn't be used to unregister all sync
     * databases by walking through the list returned by
     * alpm_option_get_syncdbs, because the db is removed from that list here.
     */
    void *data;
    handle->dbs_sync = alpm_list_remove(handle->dbs_sync,
        db, _alpm_db_cmp, &data);
    if(data) {
      found = 1;
    }
  }

  if(!found) {
    RET_ERR(handle, ALPM_ERR_DB_NOT_FOUND, -1);
  }

  db->ops->unregister(db);
  return 0;
}

/** Get the serverlist of a database. */
alpm_list_t SYMEXPORT *alpm_db_get_servers(const alpm_db_t *db)
{