lib/libalpm/alpm.c


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

/*
 *  alpm.c
 *
 *  Copyright (c) 2006-2014 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) 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/>.
 */

#ifdef HAVE_LIBCURL
#include <curl/curl.h>
#endif

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

/** \addtogroup alpm_interface Interface Functions
 * @brief Functions to initialize and release libalpm
 * @{
 */

/** Initializes the library.
 * Creates handle, connects to database and creates lockfile.
 * This must be called before any other functions are called.
 * @param root the root path for all filesystem operations
 * @param dbpath the absolute path to the libalpm database
 * @param err an optional variable to hold any error return codes
 * @return a context handle on success, NULL on error, err will be set if provided
 */
alpm_handle_t SYMEXPORT *alpm_initialize(const char *root, const char *dbpath,
    alpm_errno_t *err)
{
  alpm_errno_t myerr;
  const char *lf = "db.lck";
  size_t lockfilelen;
  alpm_handle_t *myhandle = _alpm_handle_new();

  if(myhandle == NULL) {
    myerr = ALPM_ERR_MEMORY;
    goto cleanup;
  }
  if((myerr = _alpm_set_directory_option(root, &(myhandle->root), 1))) {
    goto cleanup;
  }
  if((myerr = _alpm_set_directory_option(dbpath, &(myhandle->dbpath), 1))) {
    goto cleanup;
  }

  lockfilelen = strlen(myhandle->dbpath) + strlen(lf) + 1;
  myhandle->lockfile = calloc(lockfilelen, sizeof(char));
  snprintf(myhandle->lockfile, lockfilelen, "%s%s", myhandle->dbpath, lf);

  if(_alpm_db_register_local(myhandle) == NULL) {
    myerr = myhandle->pm_errno;
    goto cleanup;
  }

#ifdef ENABLE_NLS
  bindtextdomain("libalpm", LOCALEDIR);
#endif

  return myhandle;

cleanup:
  _alpm_handle_free(myhandle);
  if(err && myerr) {
    *err = myerr;
  }
  return NULL;
}

/** Release the library.
 * Disconnects from the database, removes handle and lockfile
 * This should be the last alpm call you make.
 * After this returns, handle should be considered invalid and cannot be reused
 * in any way.
 * @param myhandle the context handle
 * @return 0 on success, -1 on error
 */
int SYMEXPORT alpm_release(alpm_handle_t *myhandle)
{
  int ret = 0;
  alpm_db_t *db;

  CHECK_HANDLE(myhandle, return -1);

  /* close local database */
  db = myhandle->db_local;
  if(db) {
    db->ops->unregister(db);
    myhandle->db_local = NULL;
  }

  if(alpm_unregister_all_syncdbs(myhandle) == -1) {
    ret = -1;
  }

  _alpm_handle_unlock(myhandle);
  _alpm_handle_free(myhandle);

#ifdef HAVE_LIBCURL
  curl_global_cleanup();
#endif

  return ret;
}

/** @} */

/** @defgroup alpm_misc Miscellaneous Functions
 * @brief Various libalpm functions
 */

/** Get the version of library.
 * @return the library version, e.g. "6.0.4"
 * */
const char SYMEXPORT *alpm_version(void)
{
  return LIB_VERSION;
}

/** Get the capabilities of the library.
 * @return a bitmask of the capabilities
 * */
enum alpm_caps SYMEXPORT alpm_capabilities(void)
{
  return 0
#ifdef ENABLE_NLS
    | ALPM_CAPABILITY_NLS
#endif
#ifdef HAVE_LIBCURL
    | ALPM_CAPABILITY_DOWNLOADER
#endif
#ifdef HAVE_LIBGPGME
    | ALPM_CAPABILITY_SIGNATURES
#endif
    | 0;
}

/* vim: set ts=2 sw=2 noet: */