#!/bin/bash # # Copyright (C) 2013 The Android Open Source Project # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # A test script for paycheck.py and the update_payload.py library. # # This script requires three payload files, along with a metadata signature for # each, and a public key for verifying signatures. Payload include: # # - A full payload for release X (old_full_payload) # # - A full payload for release Y (new_full_payload), where Y > X # # - A delta payload from X to Y (delta_payload) # # The test performs the following: # # - It verifies each payload against its metadata signature, also asserting the # payload type. Another artifact is a human-readable payload report, which # is output to stdout to be inspected by the user. # # - It applies old_full_payload to yield old kernel (old_kern.part) and rootfs # (old_root.part) partitions. # # - It applies delta_payload to old_{kern,root}.part to yield new kernel # (new_delta_kern.part) and rootfs (new_delta_root.part) partitions. # # - It applies new_full_payload to yield reference new kernel # (new_full_kern.part) and rootfs (new_full_root.part) partitions. # # - It compares new_{delta,full}_kern.part and new_{delta,full}_root.part to # ensure that they are binary identical. # # If all steps have completed successfully we know with high certainty that # paycheck.py (and hence update_payload.py) correctly parses both full and delta # payloads, and applies them to yield the expected result. Finally, each # paycheck.py execution is timed. # Stop on errors, unset variables. set -e set -u # Temporary image files. OLD_KERN_PART=old_kern.part OLD_ROOT_PART=old_root.part NEW_DELTA_KERN_PART=new_delta_kern.part NEW_DELTA_ROOT_PART=new_delta_root.part NEW_FULL_KERN_PART=new_full_kern.part NEW_FULL_ROOT_PART=new_full_root.part CROS_PARTS="kernel root" log() { echo "$@" >&2 } die() { log "$@" exit 1 } usage_and_exit() { cat >&2 <<EOF Usage: ${0##*/} old_full_payload delta_payload new_full_payload EOF exit } check_payload() { payload_file=$1 payload_type=$2 time ${paycheck} -t ${payload_type} ${payload_file} } apply_full_payload() { payload_file=$1 out_dst_kern_part="$2/$3" out_dst_root_part="$2/$4" time ${paycheck} ${payload_file} \ --part_names ${CROS_PARTS} \ --out_dst_part_paths ${out_dst_kern_part} ${out_dst_root_part} } apply_delta_payload() { payload_file=$1 out_dst_kern_part="$2/$3" out_dst_root_part="$2/$4" dst_kern_part="$2/$5" dst_root_part="$2/$6" src_kern_part="$2/$7" src_root_part="$2/$8" time ${paycheck} ${payload_file} \ --part_names ${CROS_PARTS} \ --out_dst_part_paths ${out_dst_kern_part} ${out_dst_root_part} \ --dst_part_paths ${dst_kern_part} ${dst_root_part} \ --src_part_paths ${src_kern_part} ${src_root_part} } main() { # Read command-line arguments. if [ $# == 1 ] && [ "$1" == "-h" ]; then usage_and_exit elif [ $# != 3 ]; then die "Error: unexpected number of arguments" fi old_full_payload="$1" delta_payload="$2" new_full_payload="$3" # Find paycheck.py paycheck=${0%/*}/paycheck.py if [ -z "${paycheck}" ] || [ ! -x ${paycheck} ]; then die "cannot find ${paycheck} or file is not executable" fi # Check the payloads statically. log "Checking payloads..." check_payload "${old_full_payload}" full check_payload "${new_full_payload}" full check_payload "${delta_payload}" delta log "Done" # Apply full/delta payloads and verify results are identical. tmpdir="$(mktemp -d --tmpdir test_paycheck.XXXXXXXX)" log "Initiating application of payloads at $tmpdir" log "Applying old full payload..." apply_full_payload "${old_full_payload}" "${tmpdir}" "${OLD_KERN_PART}" \ "${OLD_ROOT_PART}" log "Done" log "Applying new full payload..." apply_full_payload "${new_full_payload}" "${tmpdir}" "${NEW_FULL_KERN_PART}" \ "${NEW_FULL_ROOT_PART}" log "Done" log "Applying delta payload to old partitions..." apply_delta_payload "${delta_payload}" "${tmpdir}" "${NEW_DELTA_KERN_PART}" \ "${NEW_DELTA_ROOT_PART}" "${NEW_FULL_KERN_PART}" \ "${NEW_FULL_ROOT_PART}" "${OLD_KERN_PART}" "${OLD_ROOT_PART}" log "Done" log "Comparing results of delta and new full updates..." diff "${tmpdir}/${NEW_FULL_KERN_PART}" "${tmpdir}/${NEW_DELTA_KERN_PART}" diff "${tmpdir}/${NEW_FULL_ROOT_PART}" "${tmpdir}/${NEW_DELTA_ROOT_PART}" log "Done" log "Cleaning up" rm -fr "${tmpdir}" } main "$@"