index.subr revision 273068
1if [ ! "$_PACKAGES_INDEX_SUBR" ]; then _PACKAGES_INDEX_SUBR=1 2# 3# Copyright (c) 2013 Devin Teske 4# All rights reserved. 5# 6# Redistribution and use in source and binary forms, with or without 7# modification, are permitted provided that the following conditions 8# are met: 9# 1. Redistributions of source code must retain the above copyright 10# notice, this list of conditions and the following disclaimer. 11# 2. Redistributions in binary form must reproduce the above copyright 12# notice, this list of conditions and the following disclaimer in the 13# documentation and/or other materials provided with the distribution. 14# 15# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25# SUCH DAMAGE. 26# 27# $FreeBSD: head/usr.sbin/bsdconfig/share/packages/index.subr 273068 2014-10-14 03:22:37Z dteske $ 28# 29############################################################ INCLUDES 30 31BSDCFG_SHARE="/usr/share/bsdconfig" 32. $BSDCFG_SHARE/common.subr || exit 1 33f_dprintf "%s: loading includes..." packages/index.subr 34f_include $BSDCFG_SHARE/device.subr 35f_include $BSDCFG_SHARE/media/common.subr 36f_include $BSDCFG_SHARE/packages/musthavepkg.subr 37f_include $BSDCFG_SHARE/strings.subr 38 39BSDCFG_LIBE="/usr/libexec/bsdconfig" 40f_include_lang $BSDCFG_LIBE/include/messages.subr 41 42############################################################ GLOBALS 43 44PACKAGE_INDEX= 45_INDEX_INITTED= 46 47# 48# Default path to pkg(8) repo-packagesite.sqlite database 49# 50SQLITE_REPO="/var/db/pkg/repo-packagesite.sqlite" 51 52# 53# Default path to on-disk cache INDEX file 54# 55PACKAGES_INDEX_CACHEFILE="/var/run/bsdconfig/packages_INDEX.cache" 56 57############################################################ FUNCTIONS 58 59# f_index_initialize [$var_to_set] 60# 61# Read and initialize the global index. Returns success unless media cannot be 62# initialized for any reason (e.g. user cancels media selection dialog or an 63# error occurs). The index is sorted before being loaded into $var_to_set. 64# 65# NOTE: The index is processed with f_index_read() [below] after being loaded. 66# 67f_index_initialize() 68{ 69 local __funcname=f_index_initialize 70 local __var_to_set="${1:-PACKAGE_INDEX}" 71 72 [ "$_INDEX_INITTED" ] && return $SUCCESS 73 74 # Got any media? 75 f_media_verify || return $FAILURE 76 77 # Make sure we have a usable pkg(8) with $PKG_ABI 78 f_musthavepkg_init 79 80 # Does it move when you kick it? 81 f_device_init device_media || return $FAILURE 82 83 f_show_info "$msg_attempting_to_update_repository_catalogue" 84 85 # 86 # Generate $PACKAGESITE variable for pkg(8) based on media type 87 # 88 local __type __data __site 89 device_media get type __type 90 device_media get private __data 91 case "$__type" in 92 $DEVICE_TYPE_DIRECTORY) 93 __site="file://$__data/packages/$PKG_ABI" ;; 94 $DEVICE_TYPE_FLOPPY) 95 __site="file://${__data:-$MOUNTPOINT}/packages/$PKG_ABI" ;; 96 $DEVICE_TYPE_FTP) 97 f_getvar $VAR_FTP_PATH __site 98 __site="$__site/packages/$PKG_ABI" ;; 99 $DEVICE_TYPE_HTTP) 100 f_getvar $VAR_HTTP_PATH __site 101 __site="$__site/$PKG_ABI/latest" ;; 102 $DEVICE_TYPE_HTTP_PROXY) 103 f_getvar $VAR_HTTP_PROXY_PATH __site 104 __site="$__site/packages/$PKG_ABI" ;; 105 $DEVICE_TYPE_CDROM) 106 __site="file://$MOUNTPOINT/packages/$PKG_ABI" 107 export REPOS_DIR="$MOUNTPOINT/packages/repos" ;; 108 *) # UFS, DISK, CDROM, USB, DOS, NFS, etc. 109 __site="file://$MOUNTPOINT/packages/$PKG_ABI" 110 esac 111 112 f_dprintf "PACKAGESITE=[%s]" "$__site" 113 if ! f_eval_catch $__funcname pkg \ 114 'PACKAGESITE="%s" pkg update' "$__site" 115 then 116 f_show_err "$msg_unable_to_update_pkg_from_selected_media" 117 f_device_shutdown device_media 118 return $FAILURE 119 fi 120 121 # 122 # Try to get contents from validated on-disk cache 123 # 124 125 # 126 # Calculate digest used to determine if the on-disk persistant cache 127 # INDEX (containing this digest on the first line) is valid and can be 128 # used to quickly populate the environment. 129 # 130 local __sqlite_digest 131 if ! __sqlite_digest=$( md5 < "$SQLITE_REPO" 2> /dev/null ); then 132 f_show_err "$msg_no_pkg_database_found" 133 f_device_shutdown device_media 134 return $FAILURE 135 fi 136 137 # 138 # Check to see if the persistant cache INDEX file exists 139 # 140 if [ -f "$PACKAGES_INDEX_CACHEFILE" ]; then 141 # 142 # Attempt to populate the environment with the (soon to be) 143 # validated on-disk cache. If validation fails, fall-back to 144 # generating a fresh cache. 145 # 146 if eval $__var_to_set='$( 147 ( # Get digest as the first word on first line 148 read digest rest_ignored 149 150 # 151 # If the stored digest matches the calculated- 152 # one populate the environment from the on-disk 153 # cache and provide success exit status. 154 # 155 if [ "$digest" = "$__sqlite_digest" ]; then 156 cat 157 exit $SUCCESS 158 else 159 # Otherwise, return the current value 160 eval echo \"\$__var_to_set\" 161 exit $FAILURE 162 fi 163 ) < "$PACKAGES_INDEX_CACHEFILE" 2> /dev/null 164 )'; then 165 f_show_info \ 166 "$msg_located_index_now_reading_package_data_from_it" 167 if ! f_index_read "$__var_to_set"; then 168 f_show_err \ 169 "$msg_io_or_format_error_on_index_file" 170 return $FAILURE 171 fi 172 _INDEX_INITTED=1 173 return $SUCCESS 174 fi 175 # Otherwise, fall-thru to create a fresh cache from scratch 176 fi 177 178 # 179 # If we reach this point, we need to generate the data from scratch 180 # 181 182 f_show_info "$msg_generating_index_from_pkg_database" 183 eval "$__var_to_set"='$( pkg rquery -I | sort )' 184 185 # 186 # Attempt to create the persistant on-disk cache 187 # 188 189 # Create a new temporary file to write to 190 local __tmpfile 191 if f_eval_catch -dk __tmpfile $__funcname mktemp \ 192 'mktemp -t "%s"' "$pgm" 193 then 194 # Write the temporary file contents 195 echo "$__sqlite_digest" > "$__tmpfile" 196 debug= f_getvar "$__var_to_set" >> "$__tmpfile" 197 198 # Finally, move the temporary file into place 199 case "$PACKAGES_INDEX_CACHEFILE" in 200 */*) f_eval_catch -d $__funcname mkdir \ 201 'mkdir -p "%s"' "${PACKAGES_INDEX_CACHEFILE%/*}" 202 esac 203 f_eval_catch -d $__funcname mv 'mv -f "%s" "%s"' \ 204 "$__tmpfile" "$PACKAGES_INDEX_CACHEFILE" 205 fi 206 207 f_show_info "$msg_located_index_now_reading_package_data_from_it" 208 if ! f_index_read "$__var_to_set"; then 209 f_show_err "$msg_io_or_format_error_on_index_file" 210 return $FAILURE 211 fi 212 213 _INDEX_INITTED=1 214 return $SUCCESS 215} 216 217# f_index_read [$var_to_get] 218# 219# Process the INDEX file (contents contained in $var_to_get) and... 220# 221# 1. create a list ($CATEGORY_MENU_LIST) of categories with package counts 222# 2. For convenience, create $_npkgs holding the total number of all packages 223# 3. extract associative categories for each package into $_categories_$varpkg 224# 4. extract runtime dependencies for each package into $_rundeps_$varpkg 225# 5. extract a [sorted] list of categories into $PACKAGE_CATEGORIES 226# 6. create $_npkgs_$varcat holding the total number of packages in category 227# 228# NOTE: $varpkg is the product of f_str2varname $package varpkg 229# NOTE: $package is the name as it appears in the INDEX (no archive suffix) 230# NOTE: We only show categories for which there are at least one package. 231# NOTE: $varcat is the product of f_str2varname $category varcat 232# 233f_index_read() 234{ 235 local var_to_get="${1:-PACKAGE_INDEX}" 236 237 # Export variables required by awk(1) below 238 export msg_no_description_provided 239 export msg_all msg_all_desc 240 export VALID_VARNAME_CHARS 241 export msg_packages 242 243 eval "$( debug= f_getvar "$var_to_get" | awk -F'|' ' 244 function _asorti(src, dest) 245 { 246 k = nitems = 0 247 248 # Copy src indices to dest and calculate array length 249 for (i in src) dest[++nitems] = i 250 251 # Sort the array of indices (dest) using insertion sort method 252 for (i = 1; i <= nitems; k = i++) 253 { 254 idx = dest[i] 255 while ((k > 0) && (dest[k] > idx)) 256 { 257 dest[k+1] = dest[k] 258 k-- 259 } 260 dest[k+1] = idx 261 } 262 263 return nitems 264 } 265 function print_category(category, npkgs, desc) 266 { 267 cat = category 268 # Accent the category if the first page has been 269 # cached (also acting as a visitation indicator) 270 if ( ENVIRON["_index_page_" varcat "_1"] ) 271 cat = cat "*" 272 printf "'\''%s'\'' '\''%s " packages "'\'' '\''%s'\''\n", 273 cat, npkgs, desc 274 } 275 BEGIN { 276 valid_chars = ENVIRON["VALID_VARNAME_CHARS"] 277 default_desc = ENVIRON["msg_no_description_provided"] 278 packages = ENVIRON["msg_packages"] 279 tpkgs = 0 280 prefix = "" 281 } 282 { 283 tpkgs++ 284 varpkg = $1 285 gsub("[^" valid_chars "]", "_", varpkg) 286 print "_categories_" varpkg "=\"" $7 "\"" 287 split($7, pkg_categories, /[[:space:]]+/) 288 for (pkg_category in pkg_categories) 289 categories[pkg_categories[pkg_category]]++ 290 print "_rundeps_" varpkg "=\"" $9 "\"" 291 } 292 END { 293 print "_npkgs=" tpkgs # For convenience, total package count 294 295 n = _asorti(categories, categories_sorted) 296 297 # Produce package counts for each category 298 for (i = 1; i <= n; i++) 299 { 300 cat = varcat = categories_sorted[i] 301 npkgs = categories[cat] 302 gsub("[^" valid_chars "]", "_", varcat) 303 print "_npkgs_" varcat "=\"" npkgs "\"" 304 } 305 306 # Create menu list and generate list of categories at same time 307 print "CATEGORY_MENU_LIST=\"" 308 print_category(ENVIRON["msg_all"], tpkgs, 309 ENVIRON["msg_all_desc"]) 310 category_list = "" 311 for (i = 1; i <= n; i++) 312 { 313 cat = varcat = categories_sorted[i] 314 npkgs = categories[cat] 315 cur_prefix = tolower(substr(cat, 1, 1)) 316 if ( prefix != cur_prefix ) 317 prefix = cur_prefix 318 else 319 cat = " " cat 320 gsub("[^" valid_chars "]", "_", varcat) 321 desc = ENVIRON["_category_" varcat] 322 if ( ! desc ) desc = default_desc 323 print_category(cat, npkgs, desc) 324 category_list = category_list " " cat 325 } 326 print "\"" 327 328 # Produce the list of categories (calculated in above block) 329 sub(/^ /, "", category_list) 330 print "PACKAGE_CATEGORIES=\"" category_list "\"" 331 332 }' )" # End-Quote 333} 334 335# f_index_extract_pages $var_to_get $var_basename $pagesize [$category] 336# 337# Extracts the package INDEX ($PACKAGE_INDEX by default if/when $var_to_get is 338# NULL; but should not be missing) into a series of sequential variables 339# corresponding to "pages" containing up to $pagesize packages. The package 340# INDEX data must be contained in the variable $var_to_get. The extracted pages 341# are stored in variables ${var_basename}_# -- where "#" is a the page number. 342# If $category is set, only packages for that category are extracted. 343# Otherwise, if $category is "All", missing, or NULL, all packages are 344# extracted and no filtering is done. 345# 346f_index_extract_pages() 347{ 348 local var_to_get="${1:-PACKAGE_INDEX}" var_basename="$2" pagesize="$3" 349 local category="$4" # Optional 350 351 eval "$( 352 debug= f_getvar "$var_to_get" | awk -F'|' \ 353 -v cat="$category" \ 354 -v pagesize="$pagesize" \ 355 -v var_basename="$var_basename" \ 356 -v i18n_all="$msg_all" ' 357 BEGIN { n = page = 0 } 358 /'\''/{ gsub(/'\''/, "'\''\\'\'\''") } 359 { 360 if ( cat !~ "(^$|^" i18n_all "$)" && $7 !~ \ 361 "(^|[[:space:]])" cat "([[:space:]]|$)" ) next 362 starting_new_page = (n++ == (pagesize * page)) 363 if ( starting_new_page ) 364 printf "%s%s", ( n > 1 ? "'\''\n" : "" ), 365 var_basename "_" ++page "='\''" 366 printf "%s%s", ( starting_new_page ? "" : "\n" ), $0 367 } 368 END { if ( n > 0 ) print "'\''" }' 369 )" 370} 371 372# f_index_search $var_to_get $name [$var_to_set] 373# 374# Search the package INDEX ($PACKAGE_INDEX by default if/when $var_to_get is 375# NULL; but should not be missing) for $name, returning the first match. 376# Matches are strict (not regular expressions) and must match the beginning 377# portion of the package name to be considered a match. If $var_to_set is 378# missing or NULL, output is sent to standard output. If a match is found, 379# returns success; otherwise failure. 380# 381f_index_search() 382{ 383 local __var_to_get="${1:-PACKAGE_INDEX}" __pkg_basename="$2" 384 local __var_to_set="$3" 385 386 f_dprintf "f_index_search: Searching package data (in %s) for %s" \ 387 "$__var_to_get" "$__pkg_basename" 388 389 local __pkg= 390 __pkg=$( debug= f_getvar "$__var_to_get" | 391 awk -F'|' -v basename="$__pkg_basename" ' 392 BEGIN { n = length(basename) } 393 substr($1, 0, n) == basename { print $1; exit } 394 ' ) 395 if [ ! "$__pkg" ]; then 396 f_dprintf "f_index_search: No packages matching %s found" \ 397 "$__pkg_basename" 398 return $FAILURE 399 fi 400 401 f_dprintf "f_index_search: Found package %s" "$__pkg" 402 if [ "$__var_to_set" ]; then 403 setvar "$__var_to_set" "$__pkg" 404 else 405 echo "$__pkg" 406 fi 407 return $SUCCESS 408} 409 410############################################################ MAIN 411 412f_dprintf "%s: Successfully loaded." packages/index.subr 413 414fi # ! $_PACKAGES_INDEX_SUBR 415