libopkg/pkg.h

   1 /* pkg.h - the opkg package management system
   2
   3    Carl D. Worth
   4
   5    Copyright (C) 2001 University of Southern California
   6
   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.
  11
  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.
  16 */
  17
  18 #ifndef PKG_H
  19 #define PKG_H
  20
  21 #include <sys/types.h>
  22 #include <sys/stat.h>
  23 #include <unistd.h>
  24
  25 #include "pkg_vec.h"
  26 #include "str_list.h"
  27 #include "active_list.h"
  28 #include "pkg_src.h"
  29 #include "pkg_dest.h"
  30 #include "opkg_conf.h"
  31 #include "conffile_list.h"
  32
  33 struct opkg_conf;
  34
  35
  36 #define ARRAY_SIZE(array) sizeof(array) / sizeof((array)[0])
  37
  38 /* I think "Size" is currently the shortest field name */
  39 #define PKG_MINIMUM_FIELD_NAME_LEN 4
  40
  41 enum pkg_state_want
  42 {
  43     SW_UNKNOWN = 1,
  44     SW_INSTALL,
  45     SW_DEINSTALL,
  46     SW_PURGE,
  47     SW_LAST_STATE_WANT
  48 };
  49 typedef enum pkg_state_want pkg_state_want_t;
  50
  51 enum pkg_state_flag
  52 {
  53     SF_OK        = 0,
  54     SF_REINSTREQ = 1,
  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 */
  62     SF_USER      = 256,
  63     SF_LAST_STATE_FLAG
  64 };
  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)
  67
  68 enum pkg_state_status
  69 {
  70     SS_NOT_INSTALLED = 1,
  71     SS_UNPACKED,
  72     SS_HALF_CONFIGURED,
  73     SS_INSTALLED,
  74     SS_HALF_INSTALLED,
  75     SS_CONFIG_FILES,
  76     SS_POST_INST_FAILED,
  77     SS_REMOVAL_FAILED,
  78     SS_LAST_STATE_STATUS
  79 };
  80 typedef enum pkg_state_status pkg_state_status_t;
  81
  82 struct abstract_pkg{
  83     char * name;
  84     int dependencies_checked;
  85     pkg_vec_t * pkgs;
  86     pkg_state_status_t state_status;
  87     pkg_state_flag_t state_flag;
  88     struct abstract_pkg ** depended_upon_by; /* @@@@ this should be abstract_pkg_vec_t -Jamey */
  89     abstract_pkg_vec_t * provided_by;
  90     abstract_pkg_vec_t * replaced_by;
  91 };
  92
  93 #include "pkg_depends.h"
  94
  95 /* XXX: CLEANUP: I'd like to clean up pkg_t in several ways:
  96
  97    The 3 version fields should go into a single version struct. (This
  98    is especially important since, currently, pkg->version can easily
  99    be mistaken for pkg_verson_str_alloc(pkg) although they are very
 100    distinct. This has been the source of multiple bugs.
 101
 102    The 3 state fields could possibly also go into their own struct.
 103
 104    All fields which deal with lists of packages, (Depends,
 105    Pre-Depends, Provides, Suggests, Recommends, Enhances), should each
 106    be handled by a single struct in pkg_t
 107
 108    All string fields for which there is a small set of possible
 109    values, (section, maintainer, architecture, maybe version?), that
 110    are reused among different packages -- for all such packages we
 111    should move from "char *"s to some atom datatype to share data
 112    storage and use less memory. We might even do reference counting,
 113    but probably not since most often we only create new pkg_t structs,
 114    we don't often free them.  */
 115 struct pkg
 116 {
 117      char *name;
 118      unsigned long epoch;
 119      char *version;
 120      char *revision;
 121      pkg_src_t *src;
 122      pkg_dest_t *dest;
 123      char *architecture;
 124      char *section;
 125      char *maintainer;
 126      char *description;
 127      char *tags;
 128      pkg_state_want_t state_want;
 129      pkg_state_flag_t state_flag;
 130      pkg_state_status_t state_status;
 131      char **depends_str;
 132      int depends_count;
 133      char **pre_depends_str;
 134      int pre_depends_count;
 135      char **recommends_str;
 136      int recommends_count;
 137      char **suggests_str;
 138      int suggests_count;
 139      struct active_list list; /* Used for installing|upgrading */
 140      compound_depend_t * depends;
 141
 142      /* Abhaya: new conflicts */
 143      char **conflicts_str;
 144      compound_depend_t * conflicts;
 145      int conflicts_count;
 146
 147      char **replaces_str;
 148      int replaces_count;
 149      abstract_pkg_t ** replaces;
 150
 151      char **provides_str;
 152      int provides_count;
 153      abstract_pkg_t ** provides;
 154
 155      abstract_pkg_t *parent;
 156
 157      pkg_t *old_pkg; /* during upgrade, points from installee to previously installed */
 158
 159      char *filename;
 160      char *local_filename;
 161      char *url;
 162      char *tmp_unpack_dir;
 163      char *md5sum;
 164 #if defined HAVE_SHA256
 165      char *sha256sum;
 166 #endif
 167      char *size;
 168      char *installed_size;
 169      char *priority;
 170      char *source;
 171      conffile_list_t conffiles;
 172      time_t installed_time;
 173      /* As pointer for lazy evaluation */
 174      str_list_t *installed_files;
 175      /* XXX: CLEANUP: I'd like to perhaps come up with a better
 176         mechanism to avoid the problem here, (which is that the
 177         installed_files list was being freed from an inner loop while
 178         still being used within an outer loop. */
 179      int installed_files_ref_cnt;
 180      int essential;
 181      int arch_priority;
 182 /* Adding this flag, to "force" opkg to choose a "provided_by_hand" package, if there are multiple choice */
 183      int provided_by_hand;
 184
 185      /* this flag specifies whether the package was installed to satisfy another
 186       * package's dependancies */
 187      int auto_installed;
 188 };
 189
 190 pkg_t *pkg_new(void);
 191 int pkg_init(pkg_t *pkg);
 192 void pkg_deinit(pkg_t *pkg);
 193 int pkg_init_from_file(pkg_t *pkg, const char *filename);
 194 abstract_pkg_t *abstract_pkg_new(void);
 195 int abstract_pkg_init(abstract_pkg_t *ab_pkg);
 196
 197 /*
 198  * merges fields from newpkg into oldpkg.
 199  * Forcibly sets oldpkg state_status, state_want and state_flags if set_status is nonzero
 200  */
 201 int pkg_merge(pkg_t *oldpkg, pkg_t *newpkg, int set_status);
 202
 203 char *pkg_version_str_alloc(pkg_t *pkg);
 204
 205 int pkg_compare_versions(const pkg_t *pkg, const pkg_t *ref_pkg);
 206 int pkg_name_version_and_architecture_compare(const void *a, const void *b);
 207 int abstract_pkg_name_compare(const void *a, const void *b);
 208
 209 void pkg_formatted_info(FILE *fp, pkg_t *pkg);
 210 void pkg_formatted_field(FILE *fp, pkg_t *pkg, const char *field);
 211
 212 void set_flags_from_control(opkg_conf_t *conf, pkg_t *pkg);
 213
 214 void pkg_print_status(pkg_t * pkg, FILE * file);
 215 str_list_t *pkg_get_installed_files(pkg_t *pkg);
 216 int pkg_free_installed_files(pkg_t *pkg);
 217 int pkg_remove_installed_files_list(opkg_conf_t *conf, pkg_t *pkg);
 218 conffile_t *pkg_get_conffile(pkg_t *pkg, const char *file_name);
 219 int pkg_run_script(struct opkg_conf *conf, pkg_t *pkg,
 220                    const char *script, const char *args);
 221
 222 /* enum mappings */
 223 char *pkg_state_want_to_str(pkg_state_want_t sw);
 224 pkg_state_want_t pkg_state_want_from_str(char *str);
 225 char *pkg_state_flag_to_str(pkg_state_flag_t sf);
 226 pkg_state_flag_t pkg_state_flag_from_str(const char *str);
 227 char *pkg_state_status_to_str(pkg_state_status_t ss);
 228 pkg_state_status_t pkg_state_status_from_str(const char *str);
 229
 230 int pkg_version_satisfied(pkg_t *it, pkg_t *ref, const char *op);
 231
 232 int pkg_arch_supported(opkg_conf_t *conf, pkg_t *pkg);
 233 int pkg_info_preinstall_check(opkg_conf_t *conf);
 234 int pkg_free_installed_files(pkg_t *pkg);
 235
 236 int pkg_write_filelist(opkg_conf_t *conf, pkg_t *pkg);
 237 int pkg_write_changed_filelists(opkg_conf_t *conf);
 238
 239 #endif