1 //
2 // Copyright (C) 2009 The Android Open Source Project
3 //
4 // Licensed under the Apache License, Version 2.0 (the "License");
5 // you may not use this file except in compliance with the License.
6 // You may obtain a copy of the License at
7 //
8 //      http://www.apache.org/licenses/LICENSE-2.0
9 //
10 // Unless required by applicable law or agreed to in writing, software
11 // distributed under the License is distributed on an "AS IS" BASIS,
12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 // See the License for the specific language governing permissions and
14 // limitations under the License.
15 //
16 
17 #include "update_engine/payload_generator/extent_utils.h"
18 
19 #include <inttypes.h>
20 
21 #include <string>
22 #include <utility>
23 #include <vector>
24 
25 #include <base/logging.h>
26 #include <base/macros.h>
27 #include <base/strings/stringprintf.h>
28 
29 #include "update_engine/payload_consumer/payload_constants.h"
30 #include "update_engine/payload_generator/annotated_operation.h"
31 #include "update_engine/payload_generator/extent_ranges.h"
32 
33 using std::string;
34 using std::vector;
35 
36 namespace chromeos_update_engine {
37 
AppendBlockToExtents(vector<Extent> * extents,uint64_t block)38 void AppendBlockToExtents(vector<Extent>* extents, uint64_t block) {
39   // First try to extend the last extent in |extents|, if any.
40   if (!extents->empty()) {
41     Extent& extent = extents->back();
42     uint64_t next_block = extent.start_block() == kSparseHole
43                               ? kSparseHole
44                               : extent.start_block() + extent.num_blocks();
45     if (next_block == block) {
46       extent.set_num_blocks(extent.num_blocks() + 1);
47       return;
48     }
49   }
50   // If unable to extend the last extent, append a new single-block extent.
51   Extent new_extent;
52   new_extent.set_start_block(block);
53   new_extent.set_num_blocks(1);
54   extents->push_back(new_extent);
55 }
56 
ExtendExtents(google::protobuf::RepeatedPtrField<Extent> * extents,const google::protobuf::RepeatedPtrField<Extent> & extents_to_add)57 void ExtendExtents(
58     google::protobuf::RepeatedPtrField<Extent>* extents,
59     const google::protobuf::RepeatedPtrField<Extent>& extents_to_add) {
60   vector<Extent> extents_vector;
61   vector<Extent> extents_to_add_vector;
62   ExtentsToVector(*extents, &extents_vector);
63   ExtentsToVector(extents_to_add, &extents_to_add_vector);
64   extents_vector.insert(extents_vector.end(),
65                         extents_to_add_vector.begin(),
66                         extents_to_add_vector.end());
67   NormalizeExtents(&extents_vector);
68   extents->Clear();
69   StoreExtents(extents_vector, extents);
70 }
71 
72 // Stores all Extents in 'extents' into 'out'.
StoreExtents(const vector<Extent> & extents,google::protobuf::RepeatedPtrField<Extent> * out)73 void StoreExtents(const vector<Extent>& extents,
74                   google::protobuf::RepeatedPtrField<Extent>* out) {
75   for (const Extent& extent : extents) {
76     Extent* new_extent = out->Add();
77     *new_extent = extent;
78   }
79 }
80 
81 // Stores all extents in |extents| into |out_vector|.
ExtentsToVector(const google::protobuf::RepeatedPtrField<Extent> & extents,vector<Extent> * out_vector)82 void ExtentsToVector(const google::protobuf::RepeatedPtrField<Extent>& extents,
83                      vector<Extent>* out_vector) {
84   out_vector->clear();
85   for (int i = 0; i < extents.size(); i++) {
86     out_vector->push_back(extents.Get(i));
87   }
88 }
89 
ExtentsToString(const vector<Extent> & extents)90 string ExtentsToString(const vector<Extent>& extents) {
91   string ext_str;
92   for (const Extent& e : extents)
93     ext_str += base::StringPrintf("[%" PRIu64 ", %" PRIu64 "] ",
94                                   static_cast<uint64_t>(e.start_block()),
95                                   static_cast<uint64_t>(e.num_blocks()));
96   return ext_str;
97 }
98 
NormalizeExtents(vector<Extent> * extents)99 void NormalizeExtents(vector<Extent>* extents) {
100   vector<Extent> new_extents;
101   for (const Extent& curr_ext : *extents) {
102     if (new_extents.empty()) {
103       new_extents.push_back(curr_ext);
104       continue;
105     }
106     Extent& last_ext = new_extents.back();
107     if (last_ext.start_block() + last_ext.num_blocks() ==
108         curr_ext.start_block()) {
109       // If the extents are touching, we want to combine them.
110       last_ext.set_num_blocks(last_ext.num_blocks() + curr_ext.num_blocks());
111     } else {
112       // Otherwise just include the extent as is.
113       new_extents.push_back(curr_ext);
114     }
115   }
116   *extents = new_extents;
117 }
118 
ExtentsSublist(const vector<Extent> & extents,uint64_t block_offset,uint64_t block_count)119 vector<Extent> ExtentsSublist(const vector<Extent>& extents,
120                               uint64_t block_offset,
121                               uint64_t block_count) {
122   vector<Extent> result;
123   uint64_t scanned_blocks = 0;
124   if (block_count == 0)
125     return result;
126   uint64_t end_block_offset = block_offset + block_count;
127   for (const Extent& extent : extents) {
128     // The loop invariant is that if |extents| has enough blocks, there's
129     // still some extent to add to |result|. This implies that at the beginning
130     // of the loop scanned_blocks < block_offset + block_count.
131     if (scanned_blocks + extent.num_blocks() > block_offset) {
132       // This case implies that |extent| has some overlapping with the requested
133       // subsequence.
134       uint64_t new_start = extent.start_block();
135       uint64_t new_num_blocks = extent.num_blocks();
136       if (scanned_blocks + new_num_blocks > end_block_offset) {
137         // Cut the end part of the extent.
138         new_num_blocks = end_block_offset - scanned_blocks;
139       }
140       if (block_offset > scanned_blocks) {
141         // Cut the begin part of the extent.
142         new_num_blocks -= block_offset - scanned_blocks;
143         new_start += block_offset - scanned_blocks;
144       }
145       result.push_back(ExtentForRange(new_start, new_num_blocks));
146     }
147     scanned_blocks += extent.num_blocks();
148     if (scanned_blocks >= end_block_offset)
149       break;
150   }
151   return result;
152 }
153 
operator ==(const Extent & a,const Extent & b)154 bool operator==(const Extent& a, const Extent& b) {
155   return a.start_block() == b.start_block() && a.num_blocks() == b.num_blocks();
156 }
157 
158 }  // namespace chromeos_update_engine
159