blob: 36640c03e2754648314e41d2da242c934d43f6b2 [file] [log] [blame]
// Copyright 2019 The Cobalt Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#ifndef STARBOARD_ELF_LOADER_ELF_LOADER_H_
#define STARBOARD_ELF_LOADER_ELF_LOADER_H_
#include <string>
#include "starboard/common/scoped_ptr.h"
#include "starboard/configuration.h"
namespace starboard {
namespace elf_loader {
class ElfLoaderImpl;
// A loader for ELF dynamic shared library.
class ElfLoader {
public:
ElfLoader();
~ElfLoader();
// Gets the current instance of the ELF Loader. SB_DCHECKS if called before
// the ELF Loader has been constructed.
static ElfLoader* Get();
// Loads the shared library. Returns false if |library_path| or |content_path|
// is empty, or if the library could not be loaded.
// An optional |custom_get_extension| function pointer can be passed in order
// to override the |SbSystemGetExtension| function. The flags
// |use_compression| and |use_memory_mapped_file| are not compatible so only
// one of those can be turned on.
bool Load(const std::string& library_path,
const std::string& content_path,
bool is_relative_path,
const void* (*custom_get_extension)(const char* name) = NULL,
bool use_compression = false,
bool use_memory_mapped_file = false);
// Looks up the symbol address in the
// shared library.
void* LookupSymbol(const char* symbol);
const std::string& GetLibraryPath() const { return library_path_; }
const std::string& GetContentPath() const { return content_path_; }
private:
// The paths to the loaded shared library and it's content.
std::string library_path_;
std::string content_path_;
// The ELF Loader implementation.
scoped_ptr<ElfLoaderImpl> impl_;
// The single ELF Loader instance.
static ElfLoader* g_instance;
ElfLoader(const ElfLoader&) = delete;
void operator=(const ElfLoader&) = delete;
};
} // namespace elf_loader
} // namespace starboard
#endif // STARBOARD_ELF_LOADER_ELF_LOADER_H_