lib/libalpm/alpm.c

   1 /*
   2  *  alpm.c
   3  *
   4  *  Copyright (c) 2006-2011 Pacman Development Team <pacman-dev@archlinux.org>
   5  *  Copyright (c) 2002-2006 by Judd Vinet <jvinet@zeroflux.org>
   6  *  Copyright (c) 2005 by Aurelien Foret <orelien@chez.com>
   7  *  Copyright (c) 2005 by Christian Hamar <krics@linuxforum.hu>
   8  *  Copyright (c) 2005, 2006 by Miklos Vajna <vmiklos@frugalware.org>
   9  *
  10  *  This program is free software; you can redistribute it and/or modify
  11  *  it under the terms of the GNU General Public License as published by
  12  *  the Free Software Foundation; either version 2 of the License, or
  13  *  (at your option) any later version.
  14  *
  15  *  This program is distributed in the hope that it will be useful,
  16  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  *  GNU General Public License for more details.
  19  *
  20  *  You should have received a copy of the GNU General Public License
  21  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
  22  */
  23
  24 #include "config.h"
  25
  26 #ifdef HAVE_LIBCURL
  27 #include <curl/curl.h>
  28 #endif
  29
  30 /* libalpm */
  31 #include "alpm.h"
  32 #include "alpm_list.h"
  33 #include "handle.h"
  34 #include "log.h"
  35 #include "util.h"
  36
  37 /** \addtogroup alpm_interface Interface Functions
  38  * @brief Functions to initialize and release libalpm
  39  * @{
  40  */
  41
  42 /** Initializes the library.  This must be called before any other
  43  * functions are called.
  44  * @param root the root path for all filesystem operations
  45  * @param dbpath the absolute path to the libalpm database
  46  * @param err an optional variable to hold any error return codes
  47  * @return a context handle on success, NULL on error, err will be set if provided
  48  */
  49 alpm_handle_t SYMEXPORT *alpm_initialize(const char *root, const char *dbpath,
  50                 enum _alpm_errno_t *err)
  51 {
  52         enum _alpm_errno_t myerr;
  53         const char *lf = "db.lck";
  54         size_t lockfilelen;
  55         alpm_handle_t *myhandle = _alpm_handle_new();
  56
  57         if(myhandle == NULL) {
  58                 myerr = PM_ERR_MEMORY;
  59                 goto cleanup;
  60         }
  61         if((myerr = _alpm_set_directory_option(root, &(myhandle->root), 1))) {
  62                 goto cleanup;
  63         }
  64         if((myerr = _alpm_set_directory_option(dbpath, &(myhandle->dbpath), 1))) {
  65                 goto cleanup;
  66         }
  67
  68         lockfilelen = strlen(myhandle->dbpath) + strlen(lf) + 1;
  69         myhandle->lockfile = calloc(lockfilelen, sizeof(char));
  70         snprintf(myhandle->lockfile, lockfilelen, "%s%s", myhandle->dbpath, lf);
  71
  72         if(_alpm_db_register_local(myhandle) == NULL) {
  73                 myerr = myhandle->pm_errno;
  74                 goto cleanup;
  75         }
  76
  77 #ifdef ENABLE_NLS
  78         bindtextdomain("libalpm", LOCALEDIR);
  79 #endif
  80
  81 #ifdef HAVE_LIBCURL
  82         curl_global_init(CURL_GLOBAL_SSL);
  83         myhandle->curl = curl_easy_init();
  84 #endif
  85
  86         return myhandle;
  87
  88 cleanup:
  89         _alpm_handle_free(myhandle);
  90         if(err && myerr) {
  91                 *err = myerr;
  92         }
  93         return NULL;
  94 }
  95
  96 /** Release the library.  This should be the last alpm call you make.
  97  * After this returns, handle should be considered invalid and cannot be reused
  98  * in any way.
  99  * @param handle the context handle
 100  * @return 0 on success, -1 on error
 101  */
 102 int SYMEXPORT alpm_release(alpm_handle_t *myhandle)
 103 {
 104         int ret = 0;
 105         alpm_db_t *db;
 106
 107         CHECK_HANDLE(myhandle, return -1);
 108
 109         /* close local database */
 110         db = myhandle->db_local;
 111         if(db) {
 112                 db->ops->unregister(db);
 113                 myhandle->db_local = NULL;
 114         }
 115
 116         if(alpm_db_unregister_all(myhandle) == -1) {
 117                 ret = -1;
 118         }
 119
 120         _alpm_handle_unlock(myhandle);
 121         _alpm_handle_free(myhandle);
 122
 123 #ifdef HAVE_LIBCURL
 124         curl_global_cleanup();
 125 #endif
 126
 127         return ret;
 128 }
 129
 130 /** @} */
 131
 132 /** @defgroup alpm_misc Miscellaneous Functions
 133  * @brief Various libalpm functions
 134  */
 135
 136 /* Get the version of library */
 137 const char SYMEXPORT *alpm_version(void) {
 138         return LIB_VERSION;
 139 }
 140
 141 /* vim: set ts=2 sw=2 noet: */