1 /* pkg.h - the itsy 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.
21 #include <sys/types.h>
29 #include "opkg_conf.h"
30 #include "conffile_list.h"
35 #define ARRAY_SIZE(array) sizeof(array) / sizeof((array)[0])
37 /* I think "Size" is currently the shortest field name */
38 #define PKG_MINIMUM_FIELD_NAME_LEN 4
48 typedef enum pkg_state_want pkg_state_want_t;
54 SF_HOLD = 2, /* do not upgrade version */
55 SF_REPLACE = 4, /* replace this package */
56 SF_NOPRUNE = 8, /* do not remove obsolete files */
57 SF_PREFER = 16, /* prefer this version */
58 SF_OBSOLETE = 32, /* old package in upgrade pair */
59 SF_MARKED = 64, /* temporary mark */
60 SF_FILELIST_CHANGED = 128, /* needs filelist written */
64 typedef enum pkg_state_flag pkg_state_flag_t;
65 #define SF_NONVOLATILE_FLAGS (SF_HOLD|SF_NOPRUNE|SF_PREFER|SF_OBSOLETE|SF_USER)
79 typedef enum pkg_state_status pkg_state_status_t;
83 int dependencies_checked;
85 pkg_state_status_t state_status;
86 pkg_state_flag_t state_flag;
87 struct abstract_pkg ** depended_upon_by; /* @@@@ this should be abstract_pkg_vec_t -Jamey */
88 abstract_pkg_vec_t * provided_by;
89 abstract_pkg_vec_t * replaced_by;
92 #include "pkg_depends.h"
94 /* XXX: CLEANUP: I'd like to clean up pkg_t in several ways:
96 The 3 version fields should go into a single version struct. (This
97 is especially important since, currently, pkg->version can easily
98 be mistaken for pkg_verson_str_alloc(pkg) although they are very
99 distinct. This has been the source of multiple bugs.
101 The 3 state fields could possibly also go into their own struct.
103 All fields which deal with lists of packages, (Depends,
104 Pre-Depends, Provides, Suggests, Recommends, Enhances), should each
105 be handled by a single struct in pkg_t
107 All string fields for which there is a small set of possible
108 values, (section, maintainer, architecture, maybe version?), that
109 are reused among different packages -- for all such packages we
110 should move from "char *"s to some atom datatype to share data
111 storage and use less memory. We might even do reference counting,
112 but probably not since most often we only create new pkg_t structs,
113 we don't often free them. */
120 char *familiar_revision;
127 pkg_state_want_t state_want;
128 pkg_state_flag_t state_flag;
129 pkg_state_status_t state_status;
132 char **pre_depends_str;
133 int pre_depends_count;
134 char **recommends_str;
135 int recommends_count;
138 compound_depend_t * depends;
140 /* Abhaya: new conflicts */
141 char **conflicts_str;
142 compound_depend_t * conflicts;
147 abstract_pkg_t ** replaces;
151 abstract_pkg_t ** provides;
153 abstract_pkg_t *parent;
155 pkg_t *old_pkg; /* during upgrade, points from installee to previously installed */
158 char *local_filename;
160 char *tmp_unpack_dir;
163 char *installed_size;
166 conffile_list_t conffiles;
167 time_t installed_time;
168 /* As pointer for lazy evaluation */
169 str_list_t *installed_files;
170 /* XXX: CLEANUP: I'd like to perhaps come up with a better
171 mechanism to avoid the problem here, (which is that the
172 installed_files list was being freed from an inner loop while
173 still being used within an outer loop. */
174 int installed_files_ref_cnt;
177 /* Adding this flag, to "force" opkg to choose a "provided_by_hand" package, if there are multiple choice */
178 int provided_by_hand;
181 pkg_t *pkg_new(void);
182 int pkg_init(pkg_t *pkg);
183 void pkg_deinit(pkg_t *pkg);
184 int pkg_init_from_file(pkg_t *pkg, const char *filename);
185 abstract_pkg_t *abstract_pkg_new(void);
186 int abstract_pkg_init(abstract_pkg_t *ab_pkg);
189 * merges fields from newpkg into oldpkg.
190 * Forcibly sets oldpkg state_status, state_want and state_flags if set_status is nonzero
192 int pkg_merge(pkg_t *oldpkg, pkg_t *newpkg, int set_status);
194 char *pkg_version_str_alloc(pkg_t *pkg);
196 int pkg_compare_versions(const pkg_t *pkg, const pkg_t *ref_pkg);
197 int pkg_name_version_and_architecture_compare(void *a, void *b);
198 int abstract_pkg_name_compare(void *a, void *b);
200 char * pkg_formatted_info(pkg_t *pkg );
201 char * pkg_formatted_field(pkg_t *pkg, const char *field );
203 void set_flags_from_control(opkg_conf_t *conf, pkg_t *pkg);
205 void pkg_print_info(pkg_t *pkg, FILE *file);
206 void pkg_print_status(pkg_t * pkg, FILE * file);
207 void pkg_print_field(pkg_t *pkg, FILE *file, const char *field);
208 str_list_t *pkg_get_installed_files(pkg_t *pkg);
209 int pkg_free_installed_files(pkg_t *pkg);
210 int pkg_remove_installed_files_list(opkg_conf_t *conf, pkg_t *pkg);
211 conffile_t *pkg_get_conffile(pkg_t *pkg, const char *file_name);
212 int pkg_run_script(struct opkg_conf *conf, pkg_t *pkg,
213 const char *script, const char *args);
216 char *pkg_state_want_to_str(pkg_state_want_t sw);
217 pkg_state_want_t pkg_state_want_from_str(char *str);
218 char *pkg_state_flag_to_str(pkg_state_flag_t sf);
219 pkg_state_flag_t pkg_state_flag_from_str(const char *str);
220 char *pkg_state_status_to_str(pkg_state_status_t ss);
221 pkg_state_status_t pkg_state_status_from_str(const char *str);
223 int pkg_version_satisfied(pkg_t *it, pkg_t *ref, const char *op);
225 int pkg_arch_supported(opkg_conf_t *conf, pkg_t *pkg);
226 int pkg_info_preinstall_check(opkg_conf_t *conf);
227 int pkg_free_installed_files(pkg_t *pkg);
229 int pkg_write_filelist(opkg_conf_t *conf, pkg_t *pkg);
230 int pkg_write_changed_filelists(opkg_conf_t *conf);