august/LSPlt
1
0
Fork 0
mirror of https://github.com/LSPosed/LSPlt.git synced 2025-05-06 21:48:48 +08:00
Code Issues Packages Projects Releases Wiki Activity

More docs

Browse Source
This commit is contained in:
LoveSy 2022-11-28 21:01:39 +08:00
parent d6a78a935f
commit 68dca66376
No known key found for this signature in database
1 changed files with 12 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
lsplt/src/main/jni/include/lsplt.hpp
View File

@ -43,11 +43,11 @@ struct MapInfo {
/// \brief Register a hook to a function by inode. For so within an archive, you should use /// \brief Register a hook to a function by inode. For so within an archive, you should use
/// #RegisterHook(ino_t, uintptr_t, size_t, std::string_view, void *, void **) instead. /// #RegisterHook(ino_t, uintptr_t, size_t, std::string_view, void *, void **) instead.
/// \param inode The inode of the library to hook. You can obtain the inode by #stat() or by finding /// \param[in] inode The inode of the library to hook. You can obtain the inode by #stat() or by finding
/// the library in the list returned by #lsplt::v1::MapInfo::Scan(). /// the library in the list returned by #lsplt::v1::MapInfo::Scan().
/// \param symbol The function symbol to hook. /// \param[in] symbol The function symbol to hook.
/// \param callback The callback function pointer to call when the function is called. /// \param[in] callback The callback function pointer to call when the function is called.
/// \param backup The backup function pointer which can call the original function. This is /// \param[out] backup The backup function pointer which can call the original function. This is
/// optional. /// optional.
/// \return Whether the hook is successfully registered. /// \return Whether the hook is successfully registered.
/// \note This function is thread-safe. /// \note This function is thread-safe.
@ -67,13 +67,13 @@ struct MapInfo {
/// \brief Register a hook to a function by inode with offset range. This is useful when hooking /// \brief Register a hook to a function by inode with offset range. This is useful when hooking
/// a library that is directly loaded from an archive without extraction. /// a library that is directly loaded from an archive without extraction.
/// \param inode The inode of the library to hook. You can obtain the inode by #stat() or by finding /// \param[in] inode The inode of the library to hook. You can obtain the inode by #stat() or by finding
/// the library in the list returned by #lsplt::v1::MapInfo::Scan(). /// the library in the list returned by #lsplt::v1::MapInfo::Scan().
/// \param offset The to the library in the file. /// \param[in] offset The to the library in the file.
/// \param size The upper bound size to the library in the file. /// \param[in] size The upper bound size to the library in the file.
/// \param symbol The function symbol to hook. /// \param[in] symbol The function symbol to hook.
/// \param callback The callback function pointer to call when the function is called. /// \param[in] callback The callback function pointer to call when the function is called.
/// \param backup The backup function pointer which can call the original function. This is /// \param[out] backup The backup function pointer which can call the original function. This is
/// optional. /// optional.
/// \return Whether the hook is successfully registered. /// \return Whether the hook is successfully registered.
/// \note This function is thread-safe. /// \note This function is thread-safe.
@ -93,6 +93,8 @@ struct MapInfo {
/// cannot be found. /// cannot be found.
/// \note The \p size can be inaccurate but should be larger or equal to the library size, /// \note The \p size can be inaccurate but should be larger or equal to the library size,
/// otherwise the hook may fail when the hook pointer is beyond the range. /// otherwise the hook may fail when the hook pointer is beyond the range.
/// \note The behaviour of this function is undefined if \p offset + \p size is larger than the
/// the maximum value of \p size_t.
/// \see #CommitHook() /// \see #CommitHook()
/// \see #InvalidateBackup() /// \see #InvalidateBackup()
[[maybe_unused, gnu::visibility("default")]] bool RegisterHook(ino_t inode, uintptr_t offset, [[maybe_unused, gnu::visibility("default")]] bool RegisterHook(ino_t inode, uintptr_t offset,