// Copyright (c) 2011 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. // This file contains the code to apply a Courgette patch. #include "courgette/ensemble.h" #include "base/basictypes.h" #include "base/files/file_util.h" #include "base/files/memory_mapped_file.h" #include "base/logging.h" #include "courgette/crc.h" #include "courgette/patcher_x86_32.h" #include "courgette/region.h" #include "courgette/simple_delta.h" #include "courgette/streams.h" namespace courgette { // EnsemblePatchApplication is all the logic and data required to apply the // multi-stage patch. class EnsemblePatchApplication { public: EnsemblePatchApplication(); ~EnsemblePatchApplication(); Status ReadHeader(SourceStream* header_stream); Status InitBase(const Region& region); Status ValidateBase(); Status ReadInitialParameters(SourceStream* initial_parameters); Status PredictTransformParameters(SinkStreamSet* predicted_parameters); Status SubpatchTransformParameters(SinkStreamSet* prediction, SourceStream* correction, SourceStreamSet* corrected_parameters); Status TransformUp(SourceStreamSet* parameters, SinkStreamSet* transformed_elements); Status SubpatchTransformedElements(SinkStreamSet* elements, SourceStream* correction, SourceStreamSet* corrected_elements); Status TransformDown(SourceStreamSet* transformed_elements, SinkStream* basic_elements); Status SubpatchFinalOutput(SourceStream* original, SourceStream* correction, SinkStream* corrected_ensemble); private: Status SubpatchStreamSets(SinkStreamSet* predicted_items, SourceStream* correction, SourceStreamSet* corrected_items, SinkStream* corrected_items_storage); Region base_region_; // Location of in-memory copy of 'old' version. uint32 source_checksum_; uint32 target_checksum_; uint32 final_patch_input_size_prediction_; std::vector<TransformationPatcher*> patchers_; SinkStream corrected_parameters_storage_; SinkStream corrected_elements_storage_; DISALLOW_COPY_AND_ASSIGN(EnsemblePatchApplication); }; EnsemblePatchApplication::EnsemblePatchApplication() : source_checksum_(0), target_checksum_(0), final_patch_input_size_prediction_(0) { } EnsemblePatchApplication::~EnsemblePatchApplication() { for (size_t i = 0; i < patchers_.size(); ++i) { delete patchers_[i]; } } Status EnsemblePatchApplication::ReadHeader(SourceStream* header_stream) { uint32 magic; if (!header_stream->ReadVarint32(&magic)) return C_BAD_ENSEMBLE_MAGIC; if (magic != CourgettePatchFile::kMagic) return C_BAD_ENSEMBLE_MAGIC; uint32 version; if (!header_stream->ReadVarint32(&version)) return C_BAD_ENSEMBLE_VERSION; if (version != CourgettePatchFile::kVersion) return C_BAD_ENSEMBLE_VERSION; if (!header_stream->ReadVarint32(&source_checksum_)) return C_BAD_ENSEMBLE_HEADER; if (!header_stream->ReadVarint32(&target_checksum_)) return C_BAD_ENSEMBLE_HEADER; if (!header_stream->ReadVarint32(&final_patch_input_size_prediction_)) return C_BAD_ENSEMBLE_HEADER; return C_OK; } Status EnsemblePatchApplication::InitBase(const Region& region) { base_region_.assign(region); return C_OK; } Status EnsemblePatchApplication::ValidateBase() { uint32 checksum = CalculateCrc(base_region_.start(), base_region_.length()); if (source_checksum_ != checksum) return C_BAD_ENSEMBLE_CRC; return C_OK; } Status EnsemblePatchApplication::ReadInitialParameters( SourceStream* transformation_parameters) { uint32 number_of_transformations = 0; if (!transformation_parameters->ReadVarint32(&number_of_transformations)) return C_BAD_ENSEMBLE_HEADER; for (size_t i = 0; i < number_of_transformations; ++i) { uint32 kind; if (!transformation_parameters->ReadVarint32(&kind)) return C_BAD_ENSEMBLE_HEADER; TransformationPatcher* patcher = NULL; switch (kind) { case EXE_WIN_32_X86: patcher = new PatcherX86_32(base_region_); break; case EXE_ELF_32_X86: patcher = new PatcherX86_32(base_region_); break; case EXE_ELF_32_ARM: patcher = new PatcherX86_32(base_region_); break; case EXE_WIN_32_X64: patcher = new PatcherX86_32(base_region_); break; } if (patcher) patchers_.push_back(patcher); else return C_BAD_ENSEMBLE_HEADER; } for (size_t i = 0; i < patchers_.size(); ++i) { Status status = patchers_[i]->Init(transformation_parameters); if (status != C_OK) return status; } // All transformation_parameters should have been consumed by the above loop. if (!transformation_parameters->Empty()) return C_BAD_ENSEMBLE_HEADER; return C_OK; } Status EnsemblePatchApplication::PredictTransformParameters( SinkStreamSet* all_predicted_parameters) { for (size_t i = 0; i < patchers_.size(); ++i) { SinkStreamSet single_predicted_parameters; Status status = patchers_[i]->PredictTransformParameters(&single_predicted_parameters); if (status != C_OK) return status; if (!all_predicted_parameters->WriteSet(&single_predicted_parameters)) return C_STREAM_ERROR; } return C_OK; } Status EnsemblePatchApplication::SubpatchTransformParameters( SinkStreamSet* predicted_parameters, SourceStream* correction, SourceStreamSet* corrected_parameters) { return SubpatchStreamSets(predicted_parameters, correction, corrected_parameters, &corrected_parameters_storage_); } Status EnsemblePatchApplication::TransformUp( SourceStreamSet* parameters, SinkStreamSet* transformed_elements) { for (size_t i = 0; i < patchers_.size(); ++i) { SourceStreamSet single_parameters; if (!parameters->ReadSet(&single_parameters)) return C_STREAM_ERROR; SinkStreamSet single_transformed_element; Status status = patchers_[i]->Transform(&single_parameters, &single_transformed_element); if (status != C_OK) return status; if (!single_parameters.Empty()) return C_STREAM_NOT_CONSUMED; if (!transformed_elements->WriteSet(&single_transformed_element)) return C_STREAM_ERROR; } if (!parameters->Empty()) return C_STREAM_NOT_CONSUMED; return C_OK; } Status EnsemblePatchApplication::SubpatchTransformedElements( SinkStreamSet* predicted_elements, SourceStream* correction, SourceStreamSet* corrected_elements) { return SubpatchStreamSets(predicted_elements, correction, corrected_elements, &corrected_elements_storage_); } Status EnsemblePatchApplication::TransformDown( SourceStreamSet* transformed_elements, SinkStream* basic_elements) { // Construct blob of original input followed by reformed elements. if (!basic_elements->Reserve(final_patch_input_size_prediction_)) { return C_STREAM_ERROR; } // The original input: if (!basic_elements->Write(base_region_.start(), base_region_.length())) return C_STREAM_ERROR; for (size_t i = 0; i < patchers_.size(); ++i) { SourceStreamSet single_corrected_element; if (!transformed_elements->ReadSet(&single_corrected_element)) return C_STREAM_ERROR; Status status = patchers_[i]->Reform(&single_corrected_element, basic_elements); if (status != C_OK) return status; if (!single_corrected_element.Empty()) return C_STREAM_NOT_CONSUMED; } if (!transformed_elements->Empty()) return C_STREAM_NOT_CONSUMED; // We have totally consumed transformed_elements, so can free the // storage to which it referred. corrected_elements_storage_.Retire(); return C_OK; } Status EnsemblePatchApplication::SubpatchFinalOutput( SourceStream* original, SourceStream* correction, SinkStream* corrected_ensemble) { Status delta_status = ApplySimpleDelta(original, correction, corrected_ensemble); if (delta_status != C_OK) return delta_status; if (CalculateCrc(corrected_ensemble->Buffer(), corrected_ensemble->Length()) != target_checksum_) return C_BAD_ENSEMBLE_CRC; return C_OK; } Status EnsemblePatchApplication::SubpatchStreamSets( SinkStreamSet* predicted_items, SourceStream* correction, SourceStreamSet* corrected_items, SinkStream* corrected_items_storage) { SinkStream linearized_predicted_items; if (!predicted_items->CopyTo(&linearized_predicted_items)) return C_STREAM_ERROR; SourceStream prediction; prediction.Init(linearized_predicted_items); Status status = ApplySimpleDelta(&prediction, correction, corrected_items_storage); if (status != C_OK) return status; if (!corrected_items->Init(corrected_items_storage->Buffer(), corrected_items_storage->Length())) return C_STREAM_ERROR; return C_OK; } Status ApplyEnsemblePatch(SourceStream* base, SourceStream* patch, SinkStream* output) { Status status; EnsemblePatchApplication patch_process; status = patch_process.ReadHeader(patch); if (status != C_OK) return status; status = patch_process.InitBase(Region(base->Buffer(), base->Remaining())); if (status != C_OK) return status; status = patch_process.ValidateBase(); if (status != C_OK) return status; // The rest of the patch stream is a StreamSet. SourceStreamSet patch_streams; patch_streams.Init(patch); SourceStream* transformation_descriptions = patch_streams.stream(0); SourceStream* parameter_correction = patch_streams.stream(1); SourceStream* transformed_elements_correction = patch_streams.stream(2); SourceStream* ensemble_correction = patch_streams.stream(3); status = patch_process.ReadInitialParameters(transformation_descriptions); if (status != C_OK) return status; SinkStreamSet predicted_parameters; status = patch_process.PredictTransformParameters(&predicted_parameters); if (status != C_OK) return status; SourceStreamSet corrected_parameters; status = patch_process.SubpatchTransformParameters(&predicted_parameters, parameter_correction, &corrected_parameters); if (status != C_OK) return status; SinkStreamSet transformed_elements; status = patch_process.TransformUp(&corrected_parameters, &transformed_elements); if (status != C_OK) return status; SourceStreamSet corrected_transformed_elements; status = patch_process.SubpatchTransformedElements( &transformed_elements, transformed_elements_correction, &corrected_transformed_elements); if (status != C_OK) return status; SinkStream original_ensemble_and_corrected_base_elements; status = patch_process.TransformDown( &corrected_transformed_elements, &original_ensemble_and_corrected_base_elements); if (status != C_OK) return status; SourceStream final_patch_prediction; final_patch_prediction.Init(original_ensemble_and_corrected_base_elements); status = patch_process.SubpatchFinalOutput(&final_patch_prediction, ensemble_correction, output); if (status != C_OK) return status; return C_OK; } Status ApplyEnsemblePatch(const base::FilePath::CharType* old_file_name, const base::FilePath::CharType* patch_file_name, const base::FilePath::CharType* new_file_name) { // First read enough of the patch file to validate the header is well-formed. // A few varint32 numbers should fit in 100. base::FilePath patch_file_path(patch_file_name); base::MemoryMappedFile patch_file; if (!patch_file.Initialize(patch_file_path)) return C_READ_OPEN_ERROR; // 'Dry-run' the first step of the patch process to validate format of header. SourceStream patch_header_stream; patch_header_stream.Init(patch_file.data(), patch_file.length()); EnsemblePatchApplication patch_process; Status status = patch_process.ReadHeader(&patch_header_stream); if (status != C_OK) return status; // Read the old_file. base::FilePath old_file_path(old_file_name); base::MemoryMappedFile old_file; if (!old_file.Initialize(old_file_path)) return C_READ_ERROR; // Apply patch on streams. SourceStream old_source_stream; SourceStream patch_source_stream; old_source_stream.Init(old_file.data(), old_file.length()); patch_source_stream.Init(patch_file.data(), patch_file.length()); SinkStream new_sink_stream; status = ApplyEnsemblePatch(&old_source_stream, &patch_source_stream, &new_sink_stream); if (status != C_OK) return status; // Write the patched data to |new_file_name|. base::FilePath new_file_path(new_file_name); int written = base::WriteFile( new_file_path, reinterpret_cast<const char*>(new_sink_stream.Buffer()), static_cast<int>(new_sink_stream.Length())); if (written == -1) return C_WRITE_OPEN_ERROR; if (static_cast<size_t>(written) != new_sink_stream.Length()) return C_WRITE_ERROR; return C_OK; } } // namespace