4 * FreeBSD install - a package for the installation and maintainance
5 * of non-core utilities.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
19 * Include and define various things wanted by the library routines.
23 #ifndef _INST_LIB_LIB_H_
24 #define _INST_LIB_LIB_H_
27 #include <sys/param.h>
30 #include <sys/queue.h>
54 /* Usually "rm", but often "echo" during debugging! */
55 #define REMOVE_CMD "rm"
57 /* Usually "rm", but often "echo" during debugging! */
58 #define RMDIR_CMD "rmdir"
60 /* Where we put logging information by default, else ${PKG_DBDIR} if set */
61 #define DEF_LOG_DIR "/var/db/pkg"
62 /* just in case we change the environment variable name */
63 #define PKG_DBDIR "PKG_DBDIR"
64 /* macro to get name of directory where we put logging information */
65 #define LOG_DIR (getenv(PKG_DBDIR) ? getenv(PKG_DBDIR) : DEF_LOG_DIR)
67 /* The names of our "special" files */
68 #define CONTENTS_FNAME "+CONTENTS"
69 #define COMMENT_FNAME "+COMMENT"
70 #define DESC_FNAME "+DESC"
71 #define INSTALL_FNAME "+INSTALL"
72 #define POST_INSTALL_FNAME "+POST-INSTALL"
73 #define DEINSTALL_FNAME "+DEINSTALL"
74 #define POST_DEINSTALL_FNAME "+POST-DEINSTALL"
75 #define REQUIRE_FNAME "+REQUIRE"
76 #define REQUIRED_BY_FNAME "+REQUIRED_BY"
77 #define DISPLAY_FNAME "+DISPLAY"
78 #define MTREE_FNAME "+MTREE_DIRS"
80 #define CMD_CHAR '@' /* prefix for extended PLIST cmd */
82 /* The name of the "prefix" environment variable given to scripts */
83 #define PKG_PREFIX_VNAME "PKG_PREFIX"
85 /* Version numbers to assist with changes in package file format */
86 #define PLIST_FMT_VER_MAJOR 1
87 #define PLIST_FMT_VER_MINOR 1
90 PLIST_FILE, PLIST_CWD, PLIST_CMD, PLIST_CHMOD,
91 PLIST_CHOWN, PLIST_CHGRP, PLIST_COMMENT, PLIST_IGNORE,
92 PLIST_NAME, PLIST_UNEXEC, PLIST_SRC, PLIST_DISPLAY,
93 PLIST_PKGDEP, PLIST_MTREE, PLIST_DIR_RM, PLIST_IGNORE_INST,
94 PLIST_OPTION, PLIST_ORIGIN, PLIST_DEPORIGIN
96 typedef enum _plist_t plist_t;
99 MATCH_ALL, MATCH_EXACT, MATCH_GLOB, MATCH_REGEX
101 typedef enum _match_t match_t;
104 typedef unsigned int Boolean;
107 struct _plist *prev, *next;
112 typedef struct _plist *PackingList;
115 struct _plist *head, *tail;
118 int fmtver_maj, fmtver_mnr;
120 typedef struct _pack Package;
122 struct reqr_by_entry {
123 STAILQ_ENTRY(reqr_by_entry) link;
124 char pkgname[PATH_MAX];
126 STAILQ_HEAD(reqr_by_head, reqr_by_entry);
130 int vsystem(const char *, ...);
131 char *vpipe(const char *, ...);
133 char *make_playpen(char *, off_t);
134 char *where_playpen(void);
135 void leave_playpen(void);
136 off_t min_free(const char *);
139 char *get_dash_string(char **);
140 char *copy_string(const char *);
141 Boolean suffix(const char *, const char *);
142 void nuke_suffix(char *);
143 void str_lowercase(char *);
144 char *strconcat(const char *, const char *);
145 char *get_string(char *, int, FILE *);
148 Boolean fexists(const char *);
149 Boolean isdir(const char *);
150 Boolean isemptydir(const char *fname);
151 Boolean isemptyfile(const char *fname);
152 Boolean isfile(const char *);
153 Boolean isempty(const char *);
154 Boolean issymlink(const char *);
155 Boolean isURL(const char *);
156 char *fileGetURL(const char *, const char *);
157 char *fileFindByPath(const char *, const char *);
158 char *fileGetContents(const char *);
159 void write_file(const char *, const char *);
160 void copy_file(const char *, const char *, const char *);
161 void move_file(const char *, const char *, const char *);
162 void copy_hierarchy(const char *, const char *, Boolean);
163 int delete_hierarchy(const char *, Boolean, Boolean);
164 int unpack(const char *, const char *);
165 void format_cmd(char *, const char *, const char *, const char *);
168 void upchuck(const char *);
169 void barf(const char *, ...);
170 void whinge(const char *, ...);
171 Boolean y_or_n(Boolean, const char *, ...);
174 PackingList new_plist_entry(void);
175 PackingList last_plist(Package *);
176 PackingList find_plist(Package *, plist_t);
177 char *find_plist_option(Package *, const char *name);
178 void plist_delete(Package *, Boolean, plist_t, const char *);
179 void free_plist(Package *);
180 void mark_plist(Package *);
181 void csum_plist_entry(char *, PackingList);
182 void add_plist(Package *, plist_t, const char *);
183 void add_plist_top(Package *, plist_t, const char *);
184 void delete_plist(Package *pkg, Boolean all, plist_t type, const char *name);
185 void write_plist(Package *, FILE *);
186 void read_plist(Package *, FILE *);
187 int plist_cmd(const char *, char **);
188 int delete_package(Boolean, Boolean, Package *);
189 Boolean make_preserve_name(char *, int, const char *, const char *);
192 int pkg_perform(char **);
194 /* Query installed packages */
195 char **matchinstalled(match_t, char **, int *);
196 char **matchbyorigin(const char *, int *);
197 int isinstalledpkg(const char *name);
200 int sortdeps(char **);
201 int chkifdepends(const char *, const char *);
202 int requiredby(const char *, struct reqr_by_head **, Boolean, Boolean);
205 int verscmp(Package *, int, int);
206 const char *version_of(const char *, int *, int *);
207 int version_cmp(const char *, const char *);
210 extern Boolean Verbose;
212 extern Boolean Force;
213 extern int AutoAnswer;
215 #endif /* _INST_LIB_LIB_H_ */