xref: /aosp_15_r20/external/sandboxed-api/sandboxed_api/sandbox2/util/minielf.h (revision ec63e07ab9515d95e79c211197c445ef84cefa6a)
1*ec63e07aSXin Li // Copyright 2019 Google LLC
2*ec63e07aSXin Li //
3*ec63e07aSXin Li // Licensed under the Apache License, Version 2.0 (the "License");
4*ec63e07aSXin Li // you may not use this file except in compliance with the License.
5*ec63e07aSXin Li // You may obtain a copy of the License at
6*ec63e07aSXin Li //
7*ec63e07aSXin Li //     https://www.apache.org/licenses/LICENSE-2.0
8*ec63e07aSXin Li //
9*ec63e07aSXin Li // Unless required by applicable law or agreed to in writing, software
10*ec63e07aSXin Li // distributed under the License is distributed on an "AS IS" BASIS,
11*ec63e07aSXin Li // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12*ec63e07aSXin Li // See the License for the specific language governing permissions and
13*ec63e07aSXin Li // limitations under the License.
14*ec63e07aSXin Li 
15*ec63e07aSXin Li #ifndef SANDBOXED_API_SANDBOX2_UTIL_MINIELF_H_
16*ec63e07aSXin Li #define SANDBOXED_API_SANDBOX2_UTIL_MINIELF_H_
17*ec63e07aSXin Li 
18*ec63e07aSXin Li #include <cstdint>
19*ec63e07aSXin Li #include <string>
20*ec63e07aSXin Li #include <vector>
21*ec63e07aSXin Li 
22*ec63e07aSXin Li #include "absl/status/statusor.h"
23*ec63e07aSXin Li 
24*ec63e07aSXin Li namespace sandbox2 {
25*ec63e07aSXin Li 
26*ec63e07aSXin Li // Minimal implementation of an ELF file parser to read the program interpreter.
27*ec63e07aSXin Li class ElfFile {
28*ec63e07aSXin Li  public:
29*ec63e07aSXin Li   struct Symbol {
30*ec63e07aSXin Li     uintptr_t address;
31*ec63e07aSXin Li     std::string name;
32*ec63e07aSXin Li   };
33*ec63e07aSXin Li 
34*ec63e07aSXin Li   static constexpr uint32_t kGetInterpreter = 1 << 0;
35*ec63e07aSXin Li   static constexpr uint32_t kLoadSymbols = 1 << 1;
36*ec63e07aSXin Li   static constexpr uint32_t kLoadImportedLibraries = 1 << 2;
37*ec63e07aSXin Li   static constexpr uint32_t kAll =
38*ec63e07aSXin Li       kGetInterpreter | kLoadSymbols | kLoadImportedLibraries;
39*ec63e07aSXin Li 
40*ec63e07aSXin Li   static absl::StatusOr<ElfFile> ParseFromFile(const std::string& filename,
41*ec63e07aSXin Li                                                uint32_t features);
42*ec63e07aSXin Li 
file_size()43*ec63e07aSXin Li   int64_t file_size() const { return file_size_; }
interpreter()44*ec63e07aSXin Li   const std::string& interpreter() const { return interpreter_; }
symbols()45*ec63e07aSXin Li   const std::vector<Symbol>& symbols() const { return symbols_; }
imported_libraries()46*ec63e07aSXin Li   const std::vector<std::string>& imported_libraries() const {
47*ec63e07aSXin Li     return imported_libraries_;
48*ec63e07aSXin Li   }
position_independent()49*ec63e07aSXin Li   bool position_independent() const { return position_independent_; }
50*ec63e07aSXin Li 
51*ec63e07aSXin Li  private:
52*ec63e07aSXin Li   friend class ElfParser;
53*ec63e07aSXin Li 
54*ec63e07aSXin Li   bool position_independent_;
55*ec63e07aSXin Li   int64_t file_size_ = 0;
56*ec63e07aSXin Li   std::string interpreter_;
57*ec63e07aSXin Li   std::vector<Symbol> symbols_;
58*ec63e07aSXin Li   std::vector<std::string> imported_libraries_;
59*ec63e07aSXin Li };
60*ec63e07aSXin Li 
61*ec63e07aSXin Li }  // namespace sandbox2
62*ec63e07aSXin Li 
63*ec63e07aSXin Li #endif  // SANDBOXED_API_SANDBOX2_UTIL_MINIELF_H_
64