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_UNWIND_UNWIND_H_ 16*ec63e07aSXin Li #define SANDBOXED_API_SANDBOX2_UNWIND_UNWIND_H_ 17*ec63e07aSXin Li 18*ec63e07aSXin Li #include <sys/types.h> 19*ec63e07aSXin Li 20*ec63e07aSXin Li #include <cstdint> 21*ec63e07aSXin Li #include <map> 22*ec63e07aSXin Li #include <string> 23*ec63e07aSXin Li #include <vector> 24*ec63e07aSXin Li 25*ec63e07aSXin Li #include "absl/status/statusor.h" 26*ec63e07aSXin Li #include "sandboxed_api/sandbox2/comms.h" 27*ec63e07aSXin Li 28*ec63e07aSXin Li namespace sandbox2 { 29*ec63e07aSXin Li 30*ec63e07aSXin Li // Used to map from an address to a human-readable symbol. 31*ec63e07aSXin Li using SymbolMap = std::map<uint64_t, std::string>; 32*ec63e07aSXin Li 33*ec63e07aSXin Li // Returns the symbol at `addr`, possibly with an offset into said symbol. 34*ec63e07aSXin Li std::string GetSymbolAt(const SymbolMap& addr_to_symbol, uint64_t addr); 35*ec63e07aSXin Li 36*ec63e07aSXin Li // Loads and returns a symbol map for a process with the provided `pid`. 37*ec63e07aSXin Li absl::StatusOr<SymbolMap> LoadSymbolsMap(pid_t pid); 38*ec63e07aSXin Li 39*ec63e07aSXin Li // Runs libunwind and the symbolizer and sends the results via comms. 40*ec63e07aSXin Li bool RunLibUnwindAndSymbolizer(Comms* comms); 41*ec63e07aSXin Li 42*ec63e07aSXin Li absl::StatusOr<std::vector<std::string>> RunLibUnwindAndSymbolizer( 43*ec63e07aSXin Li pid_t pid, int max_frames); 44*ec63e07aSXin Li 45*ec63e07aSXin Li } // namespace sandbox2 46*ec63e07aSXin Li 47*ec63e07aSXin Li #endif // SANDBOXED_API_SANDBOX2_UNWIND_UNWIND_H_ 48