xref: /aosp_15_r20/system/vold/KeyBuffer.h (revision f40fafd4c6c2594924d919feffc1a1fd6e3b30f3)
1*f40fafd4SAndroid Build Coastguard Worker /*
2*f40fafd4SAndroid Build Coastguard Worker  * Copyright (C) 2017 The Android Open Source Project
3*f40fafd4SAndroid Build Coastguard Worker  *
4*f40fafd4SAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*f40fafd4SAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*f40fafd4SAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*f40fafd4SAndroid Build Coastguard Worker  *
8*f40fafd4SAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*f40fafd4SAndroid Build Coastguard Worker  *
10*f40fafd4SAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*f40fafd4SAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*f40fafd4SAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*f40fafd4SAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*f40fafd4SAndroid Build Coastguard Worker  * limitations under the License.
15*f40fafd4SAndroid Build Coastguard Worker  */
16*f40fafd4SAndroid Build Coastguard Worker 
17*f40fafd4SAndroid Build Coastguard Worker #ifndef ANDROID_VOLD_KEYBUFFER_H
18*f40fafd4SAndroid Build Coastguard Worker #define ANDROID_VOLD_KEYBUFFER_H
19*f40fafd4SAndroid Build Coastguard Worker 
20*f40fafd4SAndroid Build Coastguard Worker #include <string.h>
21*f40fafd4SAndroid Build Coastguard Worker #include <memory>
22*f40fafd4SAndroid Build Coastguard Worker #include <type_traits>
23*f40fafd4SAndroid Build Coastguard Worker #include <vector>
24*f40fafd4SAndroid Build Coastguard Worker 
25*f40fafd4SAndroid Build Coastguard Worker namespace android {
26*f40fafd4SAndroid Build Coastguard Worker namespace vold {
27*f40fafd4SAndroid Build Coastguard Worker 
28*f40fafd4SAndroid Build Coastguard Worker // Allocator that delegates useful work to standard one but zeroes data before deallocating.
29*f40fafd4SAndroid Build Coastguard Worker class ZeroingAllocator : public std::allocator<char> {
30*f40fafd4SAndroid Build Coastguard Worker   public:
deallocate(value_type * p,size_type n)31*f40fafd4SAndroid Build Coastguard Worker     void deallocate(value_type* p, size_type n) {
32*f40fafd4SAndroid Build Coastguard Worker         memset_explicit(p, 0, n);
33*f40fafd4SAndroid Build Coastguard Worker         std::allocator<char>::deallocate(p, n);
34*f40fafd4SAndroid Build Coastguard Worker     }
35*f40fafd4SAndroid Build Coastguard Worker 
36*f40fafd4SAndroid Build Coastguard Worker     template <class Other>
37*f40fafd4SAndroid Build Coastguard Worker     struct rebind {
38*f40fafd4SAndroid Build Coastguard Worker         static_assert(std::is_same_v<char, Other>, "ZeroingAllocator is only defined for char");
39*f40fafd4SAndroid Build Coastguard Worker         using other = ZeroingAllocator;
40*f40fafd4SAndroid Build Coastguard Worker     };
41*f40fafd4SAndroid Build Coastguard Worker };
42*f40fafd4SAndroid Build Coastguard Worker 
43*f40fafd4SAndroid Build Coastguard Worker // Char vector that zeroes memory when deallocating.
44*f40fafd4SAndroid Build Coastguard Worker using KeyBuffer = std::vector<char, ZeroingAllocator>;
45*f40fafd4SAndroid Build Coastguard Worker 
46*f40fafd4SAndroid Build Coastguard Worker // Convenience methods to concatenate key buffers.
47*f40fafd4SAndroid Build Coastguard Worker KeyBuffer operator+(KeyBuffer&& lhs, const KeyBuffer& rhs);
48*f40fafd4SAndroid Build Coastguard Worker KeyBuffer operator+(KeyBuffer&& lhs, const char* rhs);
49*f40fafd4SAndroid Build Coastguard Worker 
50*f40fafd4SAndroid Build Coastguard Worker }  // namespace vold
51*f40fafd4SAndroid Build Coastguard Worker }  // namespace android
52*f40fafd4SAndroid Build Coastguard Worker 
53*f40fafd4SAndroid Build Coastguard Worker #endif
54