1 /* pkg.h - the opkg package management system
5 Copyright (C) 2001 University of Southern California
7 This program is free software; you can redistribute it and/or
8 modify it under the terms of the GNU General Public License as
9 published by the Free Software Foundation; either version 2, or (at
10 your option) any later version.
12 This program is distributed in the hope that it will be useful, but
13 WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 General Public License for more details.
23 #include <sys/types.h>
24 #include <libubox/blob.h>
28 #include "active_list.h"
31 #include "opkg_conf.h"
32 #include "conffile_list.h"
37 #define ARRAY_SIZE(array) sizeof(array) / sizeof((array)[0])
40 /* I think "Size" is currently the shortest field name */
41 #define PKG_MINIMUM_FIELD_NAME_LEN 4
50 typedef enum pkg_state_want pkg_state_want_t;
55 SF_HOLD = 2, /* do not upgrade version */
56 SF_REPLACE = 4, /* replace this package */
57 SF_NOPRUNE = 8, /* do not remove obsolete files */
58 SF_PREFER = 16, /* prefer this version */
59 SF_OBSOLETE = 32, /* old package in upgrade pair */
60 SF_MARKED = 64, /* temporary mark */
61 SF_FILELIST_CHANGED = 128, /* needs filelist written */
65 typedef enum pkg_state_flag pkg_state_flag_t;
66 #define SF_NONVOLATILE_FLAGS (SF_HOLD|SF_NOPRUNE|SF_PREFER|SF_OBSOLETE|SF_USER)
68 enum pkg_state_status {
79 typedef enum pkg_state_status pkg_state_status_t;
100 int dependencies_checked;
102 pkg_state_status_t state_status;
103 pkg_state_flag_t state_flag;
105 /* XXX: This should be abstract_pkg_vec_t for consistency. */
106 struct abstract_pkg **depended_upon_by;
108 abstract_pkg_vec_t *provided_by;
109 abstract_pkg_vec_t *replaced_by;
112 #include "pkg_depends.h"
114 /* XXX: CLEANUP: I'd like to clean up pkg_t in several ways:
116 The 3 version fields should go into a single version struct. (This
117 is especially important since, currently, pkg->version can easily
118 be mistaken for pkg_verson_str_alloc(pkg) although they are very
119 distinct. This has been the source of multiple bugs.
121 The 3 state fields could possibly also go into their own struct.
123 All fields which deal with lists of packages, (Depends,
124 Pre-Depends, Provides, Suggests, Recommends, Enhances), should each
125 be handled by a single struct in pkg_t
127 All string fields for which there is a small set of possible
128 values, (section, maintainer, architecture, maybe version?), that
129 are reused among different packages -- for all such packages we
130 should move from "char *"s to some atom datatype to share data
131 storage and use less memory. We might even do reference counting,
132 but probably not since most often we only create new pkg_t structs,
133 we don't often free them. */
138 pkg_state_want_t state_want;
139 pkg_state_flag_t state_flag;
140 pkg_state_status_t state_status;
142 unsigned int depends_count;
143 char **pre_depends_str;
144 unsigned int pre_depends_count;
145 char **recommends_str;
146 unsigned int recommends_count;
148 unsigned int suggests_count;
149 struct active_list list; /* Used for installing|upgrading */
150 compound_depend_t *depends;
152 char **conflicts_str;
153 compound_depend_t *conflicts;
154 unsigned int conflicts_count;
157 unsigned int replaces_count;
158 abstract_pkg_t **replaces;
161 unsigned int provides_count;
162 abstract_pkg_t **provides;
164 abstract_pkg_t *parent;
166 char *tmp_unpack_dir;
167 unsigned long size; /* in bytes */
168 unsigned long installed_size; /* in bytes */
169 conffile_list_t conffiles;
170 time_t installed_time;
171 /* As pointer for lazy evaluation */
172 str_list_t *installed_files;
173 /* XXX: CLEANUP: I'd like to perhaps come up with a better
174 mechanism to avoid the problem here, (which is that the
175 installed_files list was being freed from an inner loop while
176 still being used within an outer loop. */
177 int installed_files_ref_cnt;
181 /* Adding this flag, to "force" opkg to choose a "provided_by_hand" package, if there are multiple choice */
182 int provided_by_hand:1;
184 /* this flag specifies whether the package was installed to satisfy another
185 * package's dependancies */
186 int auto_installed:1;
189 struct blob_buf blob;
192 pkg_t *pkg_new(void);
193 void pkg_deinit(pkg_t * pkg);
194 int pkg_init_from_file(pkg_t * pkg, const char *filename);
196 void *pkg_set_raw(pkg_t *pkg, int id, const void *val, size_t len);
197 void *pkg_get_raw(const pkg_t *pkg, int id);
199 static inline int pkg_set_int(pkg_t *pkg, int id, int val)
201 return (intptr_t) pkg_set_raw(pkg, id, &val, sizeof(val));
204 static inline int pkg_get_int(const pkg_t *pkg, int id)
206 return (intptr_t) pkg_get_raw(pkg, id);
209 char *pkg_set_string(pkg_t *pkg, int id, const char *s);
211 static inline char *pkg_get_string(const pkg_t *pkg, int id)
213 return (char *) pkg_get_raw(pkg, id);
216 static inline void * pkg_set_ptr(pkg_t *pkg, int id, void *ptr)
218 return pkg_set_raw(pkg, id, ptr, sizeof(ptr));
221 static inline void * pkg_get_ptr(const pkg_t *pkg, int id)
223 return pkg_get_raw(pkg, id);
226 abstract_pkg_t *abstract_pkg_new(void);
229 * merges fields from newpkg into oldpkg.
230 * Forcibly sets oldpkg state_status, state_want and state_flags
232 int pkg_merge(pkg_t * oldpkg, pkg_t * newpkg);
234 char *pkg_version_str_alloc(pkg_t * pkg);
236 int pkg_compare_versions(const pkg_t *pkg, const pkg_t *ref_pkg);
237 int pkg_name_version_and_architecture_compare(const void *a, const void *b);
238 int abstract_pkg_name_compare(const void *a, const void *b);
240 void pkg_formatted_info(FILE * fp, pkg_t * pkg);
241 void pkg_formatted_field(FILE * fp, pkg_t * pkg, const char *field);
243 void set_flags_from_control(pkg_t * pkg);
245 void pkg_print_status(pkg_t * pkg, FILE * file);
246 str_list_t *pkg_get_installed_files(pkg_t * pkg);
247 void pkg_free_installed_files(pkg_t * pkg);
248 void pkg_remove_installed_files_list(pkg_t * pkg);
249 conffile_t *pkg_get_conffile(pkg_t * pkg, const char *file_name);
250 int pkg_run_script(pkg_t * pkg, const char *script, const char *args);
253 pkg_state_want_t pkg_state_want_from_str(char *str);
254 pkg_state_flag_t pkg_state_flag_from_str(const char *str);
255 pkg_state_status_t pkg_state_status_from_str(const char *str);
257 int pkg_version_satisfied(pkg_t * it, pkg_t * ref, const char *op);
259 int pkg_arch_supported(pkg_t * pkg);
260 void pkg_info_preinstall_check(void);
262 int pkg_write_filelist(pkg_t * pkg);
263 int pkg_write_changed_filelists(void);