2671 lines
87 KiB
Python
2671 lines
87 KiB
Python
from . import _frida
|
|
import dataclasses
|
|
import fnmatch
|
|
import functools
|
|
import inspect
|
|
import time
|
|
import json
|
|
import sys
|
|
import threading
|
|
import traceback
|
|
from typing import (Any, Callable, Dict, List, Literal, Mapping, Optional, Tuple, Sequence, Union, TypeVar, cast,
|
|
overload)
|
|
|
|
if sys.version_info >= (3, 11):
|
|
from typing import NotRequired, ParamSpec, TypedDict
|
|
else:
|
|
from typing_extensions import NotRequired, ParamSpec, TypedDict
|
|
|
|
|
|
ServerNotRunningError = _frida.ServerNotRunningError
|
|
ExecutableNotFoundError = _frida.ExecutableNotFoundError
|
|
ExecutableNotSupportedError = _frida.ExecutableNotSupportedError
|
|
ProcessNotFoundError = _frida.ProcessNotFoundError
|
|
ProcessNotRespondingError = _frida.ProcessNotRespondingError
|
|
InvalidArgumentError = _frida.InvalidArgumentError
|
|
InvalidOperationError = _frida.InvalidOperationError
|
|
PermissionDeniedError = _frida.PermissionDeniedError
|
|
AddressInUseError = _frida.AddressInUseError
|
|
TimedOutError = _frida.TimedOutError
|
|
NotSupportedError = _frida.NotSupportedError
|
|
ProtocolError = _frida.ProtocolError
|
|
TransportError = _frida.TransportError
|
|
OperationCancelledError = _frida.OperationCancelledError
|
|
|
|
ProcessTarget = Union[int, str]
|
|
|
|
|
|
class ScriptErrorMessage(TypedDict):
|
|
type: Literal["error"]
|
|
description: str
|
|
stack: NotRequired[str]
|
|
fileName: NotRequired[str]
|
|
lineNumber: NotRequired[int]
|
|
columnNumber: NotRequired[int]
|
|
|
|
|
|
class ScriptPayloadMessage(TypedDict):
|
|
type: Literal["send"]
|
|
payload: NotRequired[Any]
|
|
|
|
|
|
ScriptMessage = Union[ScriptPayloadMessage, ScriptErrorMessage]
|
|
ScriptMessageCallback = Callable[[ScriptMessage, Optional[bytes]], None]
|
|
ScriptDestroyedCallback = Callable[[], None]
|
|
|
|
SessionDetachedCallback = Callable[
|
|
[
|
|
Literal[
|
|
"application-requested", "process-replaced", "process-terminated", "connection-terminated", "device-lost"
|
|
],
|
|
Optional[_frida.Crash],
|
|
],
|
|
None,
|
|
]
|
|
|
|
BusDetachedCallback = Callable[[], None]
|
|
BusMessageCallback = Callable[[Mapping[Any, Any], Optional[bytes]], None]
|
|
|
|
ServiceCloseCallback = Callable[[], None]
|
|
ServiceMessageCallback = Callable[[Any], None]
|
|
|
|
DeviceSpawnAddedCallback = Callable[[_frida.Spawn], None]
|
|
DeviceSpawnRemovedCallback = Callable[[_frida.Spawn], None]
|
|
DeviceChildAddedCallback = Callable[[_frida.Child], None]
|
|
DeviceChildRemovedCallback = Callable[[_frida.Child], None]
|
|
DeviceProcessCrashedCallback = Callable[[_frida.Crash], None]
|
|
DeviceOutputCallback = Callable[[int, int, bytes], None]
|
|
DeviceUninjectedCallback = Callable[[int], None]
|
|
DeviceLostCallback = Callable[[], None]
|
|
|
|
DeviceManagerAddedCallback = Callable[[_frida.Device], None]
|
|
DeviceManagerRemovedCallback = Callable[[_frida.Device], None]
|
|
DeviceManagerChangedCallback = Callable[[], None]
|
|
|
|
PortalServiceNodeJoinedCallback = Callable[[int, _frida.Application], None]
|
|
PortalServiceNodeLeftCallback = Callable[[int, _frida.Application], None]
|
|
PortalServiceNodeConnectedCallback = Callable[[int, Tuple[str, int]], None]
|
|
PortalServiceNodeDisconnectedCallback = Callable[[int, Tuple[str, int]], None]
|
|
PortalServiceControllerConnectedCallback = Callable[[int, Tuple[str, int]], None]
|
|
PortalServiceControllerDisconnectedCallback = Callable[[int, Tuple[str, int]], None]
|
|
PortalServiceAuthenticatedCallback = Callable[[int, Mapping[Any, Any]], None]
|
|
PortalServiceSubscribeCallback = Callable[[int], None]
|
|
PortalServiceMessageCallback = Callable[[int, Mapping[Any, Any], Optional[bytes]], None]
|
|
|
|
|
|
class CompilerDiagnosticFile(TypedDict):
|
|
path: str
|
|
line: int
|
|
character: int
|
|
|
|
|
|
class CompilerDiagnostic(TypedDict):
|
|
category: str
|
|
code: int
|
|
file: NotRequired[CompilerDiagnosticFile]
|
|
text: str
|
|
|
|
|
|
CompilerStartingCallback = Callable[[], None]
|
|
CompilerFinishedCallback = Callable[[], None]
|
|
CompilerOutputCallback = Callable[[str], None]
|
|
CompilerDiagnosticsCallback = Callable[[List[CompilerDiagnostic]], None]
|
|
|
|
CompilerOutputFormat = Literal["unescaped", "hex-bytes", "c-string"]
|
|
CompilerBundleFormat = Literal["esm", "iife"]
|
|
CompilerTypeCheck = Literal["full", "none"]
|
|
CompilerSourceMaps = Literal["included", "omitted"]
|
|
CompilerCompression = Literal["none", "terser"]
|
|
CompilerPlatform = Literal["neutral", "gum", "browser"]
|
|
|
|
PackageManagerInstallProgressCallback = Callable[
|
|
[
|
|
Literal[
|
|
"initializing",
|
|
"preparing-dependencies",
|
|
"resolving-package",
|
|
"fetching-resource",
|
|
"package-already-installed",
|
|
"downloading-package",
|
|
"package-installed",
|
|
"resolving-and-installing-all",
|
|
"complete",
|
|
],
|
|
float,
|
|
Optional[str],
|
|
],
|
|
None,
|
|
]
|
|
|
|
PackageRole = Literal["runtime", "development", "optional", "peer"]
|
|
|
|
|
|
_to_json = json.dumps
|
|
|
|
|
|
def _wrap(impl):
|
|
if impl is None:
|
|
return None
|
|
cls = _WRAPPERS.get(type(impl).__name__)
|
|
if cls is None:
|
|
return impl
|
|
wrapper = cls.__new__(cls)
|
|
wrapper._impl = impl
|
|
setup = getattr(wrapper, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
return wrapper
|
|
|
|
|
|
def _unwrap(obj):
|
|
if obj is None:
|
|
return None
|
|
return getattr(obj, "_impl", obj)
|
|
|
|
|
|
def _make_signal_handler(callback):
|
|
def handler(*args):
|
|
return callback(*[_wrap(arg) for arg in args])
|
|
|
|
handler._frida_original = callback
|
|
handler.__signature__ = inspect.signature(callback)
|
|
return handler
|
|
|
|
|
|
def _to_envp(value):
|
|
if isinstance(value, dict):
|
|
return [f"{key}={val}" for key, val in value.items()]
|
|
return value
|
|
|
|
|
|
def _make_options(cls, values, selectors):
|
|
options = cls()
|
|
_apply_settings(options, values, selectors)
|
|
return options
|
|
|
|
|
|
def _apply_settings(impl, values, selectors):
|
|
for name, value in values.items():
|
|
if value is None:
|
|
continue
|
|
select = selectors.get(name)
|
|
if select is None:
|
|
setattr(impl, name, _unwrap(value))
|
|
elif isinstance(value, dict):
|
|
add = getattr(impl, select)
|
|
for key, element in value.items():
|
|
add(key, _unwrap(element))
|
|
else:
|
|
add = getattr(impl, select)
|
|
for element in value:
|
|
add(_unwrap(element))
|
|
|
|
|
|
_current_cancellable = threading.local()
|
|
|
|
|
|
def _current_cancellable_get():
|
|
stack = getattr(_current_cancellable, "stack", None)
|
|
return stack[-1] if stack else None
|
|
|
|
|
|
def _invoke(method, args):
|
|
completed = threading.Event()
|
|
outcome = {}
|
|
|
|
def on_complete(result, error):
|
|
outcome["result"] = result
|
|
outcome["error"] = error
|
|
completed.set()
|
|
|
|
cancellable = _current_cancellable_get()
|
|
if cancellable is None:
|
|
method(*args, on_complete)
|
|
completed.wait()
|
|
else:
|
|
def on_cancelled():
|
|
completed.set()
|
|
|
|
method(*args, on_complete, cancellable._impl)
|
|
cancellable._impl.on("cancelled", on_cancelled)
|
|
try:
|
|
completed.wait()
|
|
finally:
|
|
cancellable._impl.off("cancelled", on_cancelled)
|
|
|
|
if "error" not in outcome:
|
|
raise _frida.OperationCancelledError("operation was cancelled")
|
|
error = outcome["error"]
|
|
if error is not None:
|
|
raise error
|
|
return outcome["result"]
|
|
|
|
|
|
class _Implementation:
|
|
def _frida_dispatch(self, name: str, args: List[Any], completion: Any) -> None:
|
|
def run() -> None:
|
|
try:
|
|
result = _unwrap(getattr(self, name)(*[_wrap(a) for a in args]))
|
|
error = None
|
|
except Exception as e:
|
|
result = None
|
|
error = e
|
|
_frida._complete_request(completion, result, error)
|
|
|
|
threading.Thread(target=run, daemon=True).start()
|
|
|
|
|
|
__version__ = _frida.__version__
|
|
|
|
|
|
def get_device_manager() -> "DeviceManager":
|
|
return _wrap(_frida.get_device_manager())
|
|
|
|
|
|
def get_device(id: str, timeout: Union[int, float] = 0) -> "Device":
|
|
return get_device_manager().get_device_by_id(id, int(timeout * 1000))
|
|
|
|
|
|
def get_device_matching(predicate: Callable[["Device"], bool], timeout: Union[int, float] = 0) -> "Device":
|
|
return get_device_manager().get_device_matching(predicate, timeout)
|
|
|
|
|
|
def get_local_device() -> "Device":
|
|
return get_device_manager().get_device_by_type("local", 0)
|
|
|
|
|
|
def get_remote_device() -> "Device":
|
|
return get_device_manager().get_device_by_type("remote", 0)
|
|
|
|
|
|
def get_usb_device(timeout: Union[int, float] = 0) -> "Device":
|
|
return get_device_manager().get_device_by_type("usb", int(timeout * 1000))
|
|
|
|
|
|
def enumerate_devices() -> List["Device"]:
|
|
return get_device_manager().enumerate_devices()
|
|
|
|
|
|
def query_system_parameters() -> Dict[str, Any]:
|
|
return get_local_device().query_system_parameters()
|
|
|
|
|
|
def spawn(
|
|
program: Union[str, List[Union[str, bytes]]],
|
|
argv: Optional[List[Union[str, bytes]]] = None,
|
|
envp: Optional[Dict[str, str]] = None,
|
|
env: Optional[Dict[str, str]] = None,
|
|
cwd: Optional[str] = None,
|
|
stdio: Optional[str] = None,
|
|
**aux: Any,
|
|
) -> int:
|
|
return get_local_device().spawn(
|
|
program, argv=argv, envp=envp, env=env, cwd=cwd, stdio=stdio, **aux
|
|
)
|
|
|
|
|
|
def resume(target: ProcessTarget) -> None:
|
|
return get_local_device().resume(target)
|
|
|
|
|
|
def kill(target: ProcessTarget) -> None:
|
|
return get_local_device().kill(target)
|
|
|
|
|
|
def attach(target: ProcessTarget, **kwargs: Any) -> "Session":
|
|
return get_local_device().attach(target, **kwargs)
|
|
|
|
|
|
def inject_library_file(target: ProcessTarget, path: str, entrypoint: str, data: str) -> int:
|
|
return get_local_device().inject_library_file(target, path, entrypoint, data)
|
|
|
|
|
|
def inject_library_blob(target: ProcessTarget, blob: bytes, entrypoint: str, data: str) -> int:
|
|
return get_local_device().inject_library_blob(target, blob, entrypoint, data)
|
|
|
|
|
|
def shutdown() -> None:
|
|
get_device_manager().close()
|
|
|
|
|
|
def make_auth_callback(callback: Callable[[str], Any]) -> Callable[[Any], str]:
|
|
def authenticate(token: str) -> str:
|
|
session_info = callback(token)
|
|
return json.dumps(session_info)
|
|
|
|
return authenticate
|
|
|
|
|
|
def _to_camel_case(name: str) -> str:
|
|
result = ""
|
|
capitalize = False
|
|
for ch in name:
|
|
if ch == "_":
|
|
capitalize = True
|
|
elif capitalize:
|
|
result += ch.upper()
|
|
capitalize = False
|
|
else:
|
|
result += ch
|
|
return result
|
|
|
|
|
|
class RPCException(Exception):
|
|
def __str__(self) -> str:
|
|
return str(self.args[2]) if len(self.args) >= 3 else str(self.args[0])
|
|
|
|
|
|
class _ScriptExports:
|
|
def __init__(self, script: "Script") -> None:
|
|
self._script = script
|
|
|
|
def __getattr__(self, name: str) -> Callable[..., Any]:
|
|
script = self._script
|
|
js_name = _to_camel_case(name)
|
|
|
|
def method(*args: Any) -> Any:
|
|
if args and isinstance(args[-1], bytes):
|
|
params, data = list(args[:-1]), args[-1]
|
|
else:
|
|
params, data = list(args), None
|
|
return script._rpc_request(["call", js_name, params], data)
|
|
|
|
return method
|
|
|
|
def __dir__(self) -> List[str]:
|
|
return self._script._list_exports()
|
|
|
|
|
|
ScriptExportsSync = _ScriptExports
|
|
ScriptExports = ScriptExportsSync
|
|
|
|
|
|
@dataclasses.dataclass
|
|
class RPCResult:
|
|
finished: bool = False
|
|
value: Any = None
|
|
error: Optional[Exception] = None
|
|
|
|
|
|
def make_rpc_call_request(js_name: str, args: Sequence[Any]) -> Tuple[List[Any], Optional[bytes]]:
|
|
if args and isinstance(args[-1], bytes):
|
|
raw_args = args[:-1]
|
|
data = args[-1]
|
|
else:
|
|
raw_args = args
|
|
data = None
|
|
return (["call", js_name, raw_args], data)
|
|
|
|
|
|
class CancellablePollFD:
|
|
def __init__(self, cancellable: _frida.Cancellable) -> None:
|
|
self.handle = cancellable.get_fd()
|
|
self._cancellable: Optional[_frida.Cancellable] = cancellable
|
|
|
|
def __del__(self) -> None:
|
|
self.release()
|
|
|
|
def release(self) -> None:
|
|
if self._cancellable is not None:
|
|
if self.handle != -1:
|
|
self._cancellable.release_fd()
|
|
self.handle = -1
|
|
self._cancellable = None
|
|
|
|
def __repr__(self) -> str:
|
|
return repr(self.handle)
|
|
|
|
def __enter__(self) -> int:
|
|
return self.handle
|
|
|
|
def __exit__(self, *exc: Any) -> None:
|
|
self.release()
|
|
|
|
|
|
P = ParamSpec("P")
|
|
R = TypeVar("R", covariant=True)
|
|
|
|
|
|
def cancellable(f: Callable[P, R]) -> Callable[P, R]:
|
|
@functools.wraps(f)
|
|
def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
|
|
cancellable = kwargs.pop("cancellable", None)
|
|
if cancellable is not None:
|
|
with cast(Cancellable, cancellable):
|
|
return f(*args, **kwargs)
|
|
|
|
return f(*args, **kwargs)
|
|
|
|
return wrapper
|
|
|
|
|
|
class GObject:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.GObject(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def notify(self, property_name: str) -> None:
|
|
return self._impl.notify(property_name)
|
|
|
|
|
|
class DeviceManager:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.DeviceManager(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {'remote_devices': 'add_remote_device', 'barebone_devices': 'add_barebone_device'})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@overload
|
|
def on(self, signal: Literal["added"], callback: DeviceManagerAddedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["removed"], callback: DeviceManagerRemovedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["changed"], callback: DeviceManagerChangedCallback) -> None: ...
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
@overload
|
|
def off(self, signal: Literal["added"], callback: DeviceManagerAddedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["removed"], callback: DeviceManagerRemovedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["changed"], callback: DeviceManagerChangedCallback) -> None: ...
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
def close(self) -> None:
|
|
return _invoke(self._impl.close, ())
|
|
|
|
def get_device_by_id(self, id: str, timeout: int) -> "Device":
|
|
return _wrap(_invoke(self._impl.get_device_by_id, (id, timeout, )))
|
|
|
|
def get_device_by_type(self, type: str, timeout: int) -> "Device":
|
|
return _wrap(_invoke(self._impl.get_device_by_type, (type, timeout, )))
|
|
|
|
def find_device_by_id(self, id: str, timeout: int) -> "Device":
|
|
return _wrap(_invoke(self._impl.find_device_by_id, (id, timeout, )))
|
|
|
|
def find_device_by_type(self, type: str, timeout: int) -> "Device":
|
|
return _wrap(_invoke(self._impl.find_device_by_type, (type, timeout, )))
|
|
|
|
def enumerate_devices(self) -> list["Device"]:
|
|
return [_wrap(element) for element in _invoke(self._impl.enumerate_devices, ())]
|
|
|
|
def add_remote_device(self, address: str, **kwargs) -> "Device":
|
|
return _wrap(_invoke(self._impl.add_remote_device, (address, _make_options(_frida.RemoteDeviceOptions, kwargs, {}), )))
|
|
|
|
def remove_remote_device(self, address: str) -> None:
|
|
return _invoke(self._impl.remove_remote_device, (address, ))
|
|
|
|
def add_barebone_device(self, config: Optional["BareboneConfig"] = None, **kwargs) -> "Device":
|
|
return _wrap(_invoke(self._impl.add_barebone_device, (_unwrap(config), _make_options(_frida.BareboneDeviceOptions, kwargs, {}), )))
|
|
|
|
def remove_barebone_device(self, device: Optional["Device"] = None) -> None:
|
|
return _invoke(self._impl.remove_barebone_device, (_unwrap(device), ))
|
|
|
|
def get_device_matching(self, predicate: Callable[["Device"], bool], timeout: Union[int, float] = 0) -> "Device":
|
|
deadline = time.monotonic() + timeout
|
|
while True:
|
|
for device in self.enumerate_devices():
|
|
if predicate(device):
|
|
return device
|
|
if time.monotonic() >= deadline:
|
|
raise _frida.InvalidArgumentError("no matching device found")
|
|
time.sleep(0.05)
|
|
|
|
|
|
def get_device(self, id: Optional[str], timeout: Union[int, float] = 0) -> "Device":
|
|
return self.get_device_matching(lambda d: d.id == id, timeout)
|
|
|
|
|
|
def get_local_device(self) -> "Device":
|
|
return self.get_device_matching(lambda d: d.type == "local", 0)
|
|
|
|
|
|
def get_remote_device(self) -> "Device":
|
|
return self.get_device_matching(lambda d: d.type == "remote", 0)
|
|
|
|
|
|
def get_usb_device(self, timeout: Union[int, float] = 0) -> "Device":
|
|
return self.get_device_matching(lambda d: d.type == "usb", timeout)
|
|
|
|
|
|
class Device:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Device(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@overload
|
|
def on(self, signal: Literal["spawn-added"], callback: DeviceSpawnAddedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["spawn-removed"], callback: DeviceSpawnRemovedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["child-added"], callback: DeviceChildAddedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["child-removed"], callback: DeviceChildRemovedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["process-crashed"], callback: DeviceProcessCrashedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["output"], callback: DeviceOutputCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["uninjected"], callback: DeviceUninjectedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["lost"], callback: DeviceLostCallback) -> None: ...
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
@overload
|
|
def off(self, signal: Literal["spawn-added"], callback: DeviceSpawnAddedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["spawn-removed"], callback: DeviceSpawnRemovedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["child-added"], callback: DeviceChildAddedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["child-removed"], callback: DeviceChildRemovedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["process-crashed"], callback: DeviceProcessCrashedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["output"], callback: DeviceOutputCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["uninjected"], callback: DeviceUninjectedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["lost"], callback: DeviceLostCallback) -> None: ...
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
@property
|
|
def is_lost(self) -> bool:
|
|
return self._impl.is_lost()
|
|
|
|
def override_option(self, name: str, val: Any) -> None:
|
|
return self._impl.override_option(name, val)
|
|
|
|
def query_system_parameters(self) -> dict:
|
|
return _invoke(self._impl.query_system_parameters, ())
|
|
|
|
def get_frontmost_application(self, **kwargs) -> "Application":
|
|
return _wrap(_invoke(self._impl.get_frontmost_application, (_make_options(_frida.FrontmostQueryOptions, kwargs, {}), )))
|
|
|
|
def enumerate_applications(self, **kwargs) -> list["Application"]:
|
|
return [_wrap(element) for element in _invoke(self._impl.enumerate_applications, (_make_options(_frida.ApplicationQueryOptions, kwargs, {'identifiers': 'select_identifier'}), ))]
|
|
|
|
def get_process_by_pid(self, pid: int, **kwargs) -> "Process":
|
|
return _wrap(_invoke(self._impl.get_process_by_pid, (pid, _make_options(_frida.ProcessMatchOptions, kwargs, {}), )))
|
|
|
|
def get_process_by_name(self, name: str, **kwargs) -> "Process":
|
|
return _wrap(_invoke(self._impl.get_process_by_name, (name, _make_options(_frida.ProcessMatchOptions, kwargs, {}), )))
|
|
|
|
def find_process_by_pid(self, pid: int, **kwargs) -> "Process":
|
|
return _wrap(_invoke(self._impl.find_process_by_pid, (pid, _make_options(_frida.ProcessMatchOptions, kwargs, {}), )))
|
|
|
|
def find_process_by_name(self, name: str, **kwargs) -> "Process":
|
|
return _wrap(_invoke(self._impl.find_process_by_name, (name, _make_options(_frida.ProcessMatchOptions, kwargs, {}), )))
|
|
|
|
def enumerate_processes(self, **kwargs) -> list["Process"]:
|
|
return [_wrap(element) for element in _invoke(self._impl.enumerate_processes, (_make_options(_frida.ProcessQueryOptions, kwargs, {'pids': 'select_pid'}), ))]
|
|
|
|
def enable_spawn_gating(self, **kwargs) -> None:
|
|
return _invoke(self._impl.enable_spawn_gating, (_make_options(_frida.SpawnGatingOptions, kwargs, {}), ))
|
|
|
|
def disable_spawn_gating(self) -> None:
|
|
return _invoke(self._impl.disable_spawn_gating, ())
|
|
|
|
def enumerate_pending_spawn(self) -> list["Spawn"]:
|
|
return [_wrap(element) for element in _invoke(self._impl.enumerate_pending_spawn, ())]
|
|
|
|
def enumerate_pending_children(self) -> list["Child"]:
|
|
return [_wrap(element) for element in _invoke(self._impl.enumerate_pending_children, ())]
|
|
|
|
def spawn(self, program: Union[str, List[Union[str, bytes]]], argv: Optional[List[Union[str, bytes]]] = None, envp: Optional[Mapping[str, str]] = None, env: Optional[Mapping[str, str]] = None, cwd: Optional[str] = None, stdio: Optional[str] = None, **aux: Any) -> int:
|
|
if not isinstance(program, str):
|
|
args = list(program)
|
|
argv = args if len(args) > 1 else None
|
|
first = args[0]
|
|
program = first.decode() if isinstance(first, bytes) else first
|
|
|
|
options = _frida.SpawnOptions()
|
|
if argv is not None:
|
|
options.argv = [arg.decode() if isinstance(arg, bytes) else arg for arg in argv]
|
|
if envp is not None:
|
|
options.envp = _to_envp(envp)
|
|
if env is not None:
|
|
options.env = _to_envp(env)
|
|
if cwd is not None:
|
|
options.cwd = cwd
|
|
if stdio is not None:
|
|
options.stdio = stdio
|
|
if aux:
|
|
options.aux = aux
|
|
return _invoke(self._impl.spawn, (program, options, ))
|
|
|
|
def input(self, target: ProcessTarget, data: bytes) -> None:
|
|
pid = self._pid_of(target)
|
|
return _invoke(self._impl.input, (pid, data, ))
|
|
|
|
def resume(self, target: ProcessTarget) -> None:
|
|
pid = self._pid_of(target)
|
|
return _invoke(self._impl.resume, (pid, ))
|
|
|
|
def kill(self, target: ProcessTarget) -> None:
|
|
pid = self._pid_of(target)
|
|
return _invoke(self._impl.kill, (pid, ))
|
|
|
|
def attach(self, target: ProcessTarget, **kwargs: Any) -> "Session":
|
|
pid = self._pid_of(target)
|
|
return _wrap(_invoke(self._impl.attach, (pid, _make_options(_frida.SessionOptions, kwargs, {'linker_notifier_offsets': 'add_linker_notifier_offset'}), )))
|
|
|
|
def inject_library_file(self, target: ProcessTarget, path: str, entrypoint: str, data: str) -> int:
|
|
pid = self._pid_of(target)
|
|
return _invoke(self._impl.inject_library_file, (pid, path, entrypoint, data, ))
|
|
|
|
def inject_library_blob(self, target: ProcessTarget, blob: bytes, entrypoint: str, data: str) -> int:
|
|
pid = self._pid_of(target)
|
|
return _invoke(self._impl.inject_library_blob, (pid, blob, entrypoint, data, ))
|
|
|
|
def open_channel(self, address: str) -> "IOStream":
|
|
return _wrap(_invoke(self._impl.open_channel, (address, )))
|
|
|
|
def open_service(self, address: str) -> "Service":
|
|
return _wrap(_invoke(self._impl.open_service, (address, )))
|
|
|
|
def unpair(self) -> None:
|
|
return _invoke(self._impl.unpair, ())
|
|
|
|
@property
|
|
def id(self) -> str:
|
|
return self._impl.id
|
|
|
|
@property
|
|
def name(self) -> str:
|
|
return self._impl.name
|
|
|
|
@property
|
|
def icon(self) -> Any:
|
|
return self._impl.icon
|
|
|
|
@property
|
|
def dtype(self) -> str:
|
|
return self._impl.dtype
|
|
|
|
@property
|
|
def bus(self) -> "Bus":
|
|
return _wrap(self._impl.bus)
|
|
|
|
@property
|
|
def type(self) -> str:
|
|
return self.dtype
|
|
|
|
def get_bus(self) -> "Bus":
|
|
return self.bus
|
|
|
|
def get_process(self, process_name: str) -> "Process":
|
|
process_name_lc = process_name.lower()
|
|
matching = [
|
|
process
|
|
for process in self.enumerate_processes()
|
|
if fnmatch.fnmatchcase(process.name.lower(), process_name_lc)
|
|
]
|
|
if len(matching) == 1:
|
|
return matching[0]
|
|
if len(matching) > 1:
|
|
matches = ", ".join(f"{p.name} (pid: {p.pid})" for p in matching)
|
|
raise _frida.ProcessNotFoundError(f"ambiguous name; it matches: {matches}")
|
|
raise _frida.ProcessNotFoundError(f"unable to find process with name '{process_name}'")
|
|
|
|
def _pid_of(self, target: ProcessTarget) -> int:
|
|
if isinstance(target, str):
|
|
return self.get_process(target).pid
|
|
return target
|
|
|
|
def __repr__(self):
|
|
return f"Device(id={self.id!r}, name={self.name!r}, dtype={self.dtype!r})"
|
|
|
|
|
|
class BareboneConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def check(self) -> None:
|
|
return self._impl.check()
|
|
|
|
@property
|
|
def connection(self) -> "BareboneConnectionConfig":
|
|
return _wrap(self._impl.connection)
|
|
|
|
@connection.setter
|
|
def connection(self, value: "BareboneConnectionConfig") -> None:
|
|
self._impl.connection = _unwrap(value)
|
|
|
|
@property
|
|
def allocator(self) -> "BareboneAllocatorConfig":
|
|
return _wrap(self._impl.allocator)
|
|
|
|
@allocator.setter
|
|
def allocator(self, value: "BareboneAllocatorConfig") -> None:
|
|
self._impl.allocator = _unwrap(value)
|
|
|
|
@property
|
|
def agent(self) -> "BareboneAgentConfig":
|
|
return _wrap(self._impl.agent)
|
|
|
|
@agent.setter
|
|
def agent(self, value: "BareboneAgentConfig") -> None:
|
|
self._impl.agent = _unwrap(value)
|
|
|
|
@property
|
|
def image(self) -> "BareboneImageConfig":
|
|
return _wrap(self._impl.image)
|
|
|
|
@image.setter
|
|
def image(self, value: "BareboneImageConfig") -> None:
|
|
self._impl.image = _unwrap(value)
|
|
|
|
@property
|
|
def kernel(self) -> str:
|
|
return self._impl.kernel
|
|
|
|
@kernel.setter
|
|
def kernel(self, value: str) -> None:
|
|
self._impl.kernel = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneConfig(kernel={self.kernel!r})"
|
|
|
|
|
|
class BareboneConnectionConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneConnectionConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def host(self) -> str:
|
|
return self._impl.host
|
|
|
|
@host.setter
|
|
def host(self, value: str) -> None:
|
|
self._impl.host = _unwrap(value)
|
|
|
|
@property
|
|
def port(self) -> int:
|
|
return self._impl.port
|
|
|
|
@port.setter
|
|
def port(self, value: int) -> None:
|
|
self._impl.port = _unwrap(value)
|
|
|
|
@property
|
|
def pid(self) -> int:
|
|
return self._impl.pid
|
|
|
|
@pid.setter
|
|
def pid(self, value: int) -> None:
|
|
self._impl.pid = _unwrap(value)
|
|
|
|
@property
|
|
def flavor(self) -> str:
|
|
return self._impl.flavor
|
|
|
|
@flavor.setter
|
|
def flavor(self, value: str) -> None:
|
|
self._impl.flavor = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneConnectionConfig(host={self.host!r}, port={self.port!r}, pid={self.pid!r}, flavor={self.flavor!r})"
|
|
|
|
|
|
class BareboneAllocatorConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneAllocatorConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def check(self) -> None:
|
|
return self._impl.check()
|
|
|
|
|
|
class BareboneInvalidAllocatorConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneInvalidAllocatorConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BarebonePhysicalAllocatorConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BarebonePhysicalAllocatorConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def physical_base(self) -> "BareboneMemoryAddress":
|
|
return _wrap(self._impl.physical_base)
|
|
|
|
@physical_base.setter
|
|
def physical_base(self, value: "BareboneMemoryAddress") -> None:
|
|
self._impl.physical_base = _unwrap(value)
|
|
|
|
|
|
class BareboneTargetFunctionsAllocatorConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneTargetFunctionsAllocatorConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {'alloc_arguments': 'add_alloc_argument', 'free_arguments': 'add_free_argument'})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def clear_alloc_arguments(self) -> None:
|
|
return self._impl.clear_alloc_arguments()
|
|
|
|
def add_alloc_argument(self, argument: "BareboneCallArgument") -> None:
|
|
return self._impl.add_alloc_argument(_unwrap(argument))
|
|
|
|
def clear_free_arguments(self) -> None:
|
|
return self._impl.clear_free_arguments()
|
|
|
|
def add_free_argument(self, argument: "BareboneCallArgument") -> None:
|
|
return self._impl.add_free_argument(_unwrap(argument))
|
|
|
|
@property
|
|
def alloc_function(self) -> "BareboneMemoryAddress":
|
|
return _wrap(self._impl.alloc_function)
|
|
|
|
@alloc_function.setter
|
|
def alloc_function(self, value: "BareboneMemoryAddress") -> None:
|
|
self._impl.alloc_function = _unwrap(value)
|
|
|
|
@property
|
|
def free_function(self) -> "BareboneMemoryAddress":
|
|
return _wrap(self._impl.free_function)
|
|
|
|
@free_function.setter
|
|
def free_function(self, value: "BareboneMemoryAddress") -> None:
|
|
self._impl.free_function = _unwrap(value)
|
|
|
|
@property
|
|
def alloc_flags(self) -> int:
|
|
return self._impl.alloc_flags
|
|
|
|
@alloc_flags.setter
|
|
def alloc_flags(self, value: int) -> None:
|
|
self._impl.alloc_flags = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneTargetFunctionsAllocatorConfig(alloc_flags={self.alloc_flags!r})"
|
|
|
|
|
|
class BareboneCallArgument:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneCallArgument(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def role(self) -> str:
|
|
return self._impl.role
|
|
|
|
@property
|
|
def value(self) -> int:
|
|
return self._impl.value
|
|
|
|
def __repr__(self):
|
|
return f"BareboneCallArgument(role={self.role!r}, value={self.value!r})"
|
|
|
|
|
|
class BareboneAgentConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneAgentConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def check(self) -> None:
|
|
return self._impl.check()
|
|
|
|
|
|
class BareboneInvalidAgentConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneInvalidAgentConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BareboneInjectedAgentConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneInjectedAgentConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def image(self) -> bytes:
|
|
return self._impl.image
|
|
|
|
@image.setter
|
|
def image(self, value: bytes) -> None:
|
|
self._impl.image = _unwrap(value)
|
|
|
|
@property
|
|
def transport(self) -> "BareboneInjectingTransportConfig":
|
|
return _wrap(self._impl.transport)
|
|
|
|
@transport.setter
|
|
def transport(self, value: "BareboneInjectingTransportConfig") -> None:
|
|
self._impl.transport = _unwrap(value)
|
|
|
|
|
|
class BareboneResidentAgentConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneResidentAgentConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def transport(self) -> "BareboneResidentTransportConfig":
|
|
return _wrap(self._impl.transport)
|
|
|
|
@transport.setter
|
|
def transport(self, value: "BareboneResidentTransportConfig") -> None:
|
|
self._impl.transport = _unwrap(value)
|
|
|
|
|
|
class BareboneTransportConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneTransportConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def check(self) -> None:
|
|
return self._impl.check()
|
|
|
|
|
|
class BareboneInjectingTransportConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneInjectingTransportConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BareboneResidentTransportConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneResidentTransportConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BareboneHostlinkTransportConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneHostlinkTransportConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def qmp(self) -> str:
|
|
return self._impl.qmp
|
|
|
|
@qmp.setter
|
|
def qmp(self, value: str) -> None:
|
|
self._impl.qmp = _unwrap(value)
|
|
|
|
@property
|
|
def bus(self) -> str:
|
|
return self._impl.bus
|
|
|
|
@bus.setter
|
|
def bus(self, value: str) -> None:
|
|
self._impl.bus = _unwrap(value)
|
|
|
|
@property
|
|
def fabric(self) -> "BareboneHostlinkFabric":
|
|
return _wrap(self._impl.fabric)
|
|
|
|
@fabric.setter
|
|
def fabric(self, value: "BareboneHostlinkFabric") -> None:
|
|
self._impl.fabric = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneHostlinkTransportConfig(qmp={self.qmp!r}, bus={self.bus!r})"
|
|
|
|
|
|
class BareboneHostlinkFabric:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneHostlinkFabric(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BareboneHostlinkEcamFabric:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneHostlinkEcamFabric(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def ecam(self) -> int:
|
|
return self._impl.ecam
|
|
|
|
@ecam.setter
|
|
def ecam(self, value: int) -> None:
|
|
self._impl.ecam = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneHostlinkEcamFabric(ecam={self.ecam!r})"
|
|
|
|
|
|
class BareboneHostlinkPortsFabric:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneHostlinkPortsFabric(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BareboneHostlinkMmioFabric:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneHostlinkMmioFabric(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BareboneVsockTransportConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneVsockTransportConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def socket_path(self) -> str:
|
|
return self._impl.socket_path
|
|
|
|
@socket_path.setter
|
|
def socket_path(self, value: str) -> None:
|
|
self._impl.socket_path = _unwrap(value)
|
|
|
|
@property
|
|
def port(self) -> int:
|
|
return self._impl.port
|
|
|
|
@port.setter
|
|
def port(self, value: int) -> None:
|
|
self._impl.port = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneVsockTransportConfig(socket_path={self.socket_path!r}, port={self.port!r})"
|
|
|
|
|
|
class BareboneDeviceTransportConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneDeviceTransportConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def path(self) -> str:
|
|
return self._impl.path
|
|
|
|
@path.setter
|
|
def path(self, value: str) -> None:
|
|
self._impl.path = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneDeviceTransportConfig(path={self.path!r})"
|
|
|
|
|
|
class BareboneSocketTransportConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneSocketTransportConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def path(self) -> str:
|
|
return self._impl.path
|
|
|
|
@path.setter
|
|
def path(self, value: str) -> None:
|
|
self._impl.path = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneSocketTransportConfig(path={self.path!r})"
|
|
|
|
|
|
class BareboneImageConfig:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneImageConfig(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {'symbols': 'add_symbol'})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def clear_symbols(self) -> None:
|
|
return self._impl.clear_symbols()
|
|
|
|
def add_symbol(self, name: str, address: int) -> None:
|
|
return self._impl.add_symbol(name, address)
|
|
|
|
def check(self) -> None:
|
|
return self._impl.check()
|
|
|
|
@property
|
|
def file(self) -> str:
|
|
return self._impl.file
|
|
|
|
@file.setter
|
|
def file(self, value: str) -> None:
|
|
self._impl.file = _unwrap(value)
|
|
|
|
@property
|
|
def base(self) -> "BareboneMemoryAddress":
|
|
return _wrap(self._impl.base)
|
|
|
|
@base.setter
|
|
def base(self, value: "BareboneMemoryAddress") -> None:
|
|
self._impl.base = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"BareboneImageConfig(file={self.file!r})"
|
|
|
|
|
|
class BareboneMemoryAddress:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneMemoryAddress(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def check(self) -> None:
|
|
return self._impl.check()
|
|
|
|
@property
|
|
def label(self) -> str:
|
|
return self._impl.label
|
|
|
|
@property
|
|
def address(self) -> int:
|
|
return self._impl.address
|
|
|
|
def __repr__(self):
|
|
return f"BareboneMemoryAddress(label={self.label!r}, address={self.address!r})"
|
|
|
|
|
|
class BareboneInvalidMemoryAddress:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneInvalidMemoryAddress(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class BareboneNonNullMemoryAddress:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.BareboneNonNullMemoryAddress(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
|
|
class Application:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Application(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def identifier(self) -> str:
|
|
return self._impl.identifier
|
|
|
|
@property
|
|
def name(self) -> str:
|
|
return self._impl.name
|
|
|
|
@property
|
|
def pid(self) -> int:
|
|
return self._impl.pid
|
|
|
|
@property
|
|
def parameters(self) -> dict:
|
|
return self._impl.parameters
|
|
|
|
def __repr__(self):
|
|
return f"Application(identifier={self.identifier!r}, name={self.name!r}, pid={self.pid!r})"
|
|
|
|
|
|
class Process:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Process(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def pid(self) -> int:
|
|
return self._impl.pid
|
|
|
|
@property
|
|
def name(self) -> str:
|
|
return self._impl.name
|
|
|
|
@property
|
|
def parameters(self) -> dict:
|
|
return self._impl.parameters
|
|
|
|
def __repr__(self):
|
|
return f"Process(pid={self.pid!r}, name={self.name!r})"
|
|
|
|
|
|
class Spawn:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Spawn(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def pid(self) -> int:
|
|
return self._impl.pid
|
|
|
|
@property
|
|
def identifier(self) -> str:
|
|
return self._impl.identifier
|
|
|
|
def __repr__(self):
|
|
return f"Spawn(pid={self.pid!r}, identifier={self.identifier!r})"
|
|
|
|
|
|
class Child:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Child(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def pid(self) -> int:
|
|
return self._impl.pid
|
|
|
|
@property
|
|
def parent_pid(self) -> int:
|
|
return self._impl.parent_pid
|
|
|
|
@property
|
|
def origin(self) -> str:
|
|
return self._impl.origin
|
|
|
|
@property
|
|
def identifier(self) -> str:
|
|
return self._impl.identifier
|
|
|
|
@property
|
|
def path(self) -> str:
|
|
return self._impl.path
|
|
|
|
@property
|
|
def argv(self) -> list[str]:
|
|
return self._impl.argv
|
|
|
|
@property
|
|
def envp(self) -> list[str]:
|
|
return self._impl.envp
|
|
|
|
def __repr__(self):
|
|
return f"Child(pid={self.pid!r}, parent_pid={self.parent_pid!r}, origin={self.origin!r}, identifier={self.identifier!r}, path={self.path!r})"
|
|
|
|
|
|
class Crash:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Crash(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def pid(self) -> int:
|
|
return self._impl.pid
|
|
|
|
@property
|
|
def process_name(self) -> str:
|
|
return self._impl.process_name
|
|
|
|
@property
|
|
def summary(self) -> str:
|
|
return self._impl.summary
|
|
|
|
@property
|
|
def report(self) -> str:
|
|
return self._impl.report
|
|
|
|
@property
|
|
def parameters(self) -> dict:
|
|
return self._impl.parameters
|
|
|
|
def __repr__(self):
|
|
return f"Crash(pid={self.pid!r}, process_name={self.process_name!r}, summary={self.summary!r}, report={self.report!r})"
|
|
|
|
|
|
class Bus:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Bus(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def is_detached(self) -> bool:
|
|
return self._impl.is_detached()
|
|
|
|
def attach(self) -> None:
|
|
return _invoke(self._impl.attach, ())
|
|
|
|
def post(self, message: Any, data: Optional[bytes] = None) -> None:
|
|
json = _to_json(message)
|
|
return self._impl.post(json, data, )
|
|
|
|
def _setup(self) -> None:
|
|
self._message_handlers: List[BusMessageCallback] = []
|
|
self._impl.on("message", self._on_message)
|
|
|
|
@overload
|
|
def on(self, signal: Literal["detached"], callback: BusDetachedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["message"], callback: BusMessageCallback) -> None: ...
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
if signal == "message":
|
|
self._message_handlers.append(callback)
|
|
else:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
@overload
|
|
def off(self, signal: Literal["detached"], callback: BusDetachedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["message"], callback: BusMessageCallback) -> None: ...
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
if signal == "message":
|
|
self._message_handlers.remove(callback)
|
|
else:
|
|
self._impl.off(signal, callback)
|
|
|
|
def _on_message(self, raw_message: str, data: Optional[bytes]) -> None:
|
|
message = json.loads(raw_message)
|
|
for handler in list(self._message_handlers):
|
|
try:
|
|
handler(message, data)
|
|
except Exception:
|
|
traceback.print_exc()
|
|
|
|
|
|
class Service:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Service(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@overload
|
|
def on(self, signal: Literal["close"], callback: ServiceCloseCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["message"], callback: ServiceMessageCallback) -> None: ...
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
@overload
|
|
def off(self, signal: Literal["close"], callback: ServiceCloseCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["message"], callback: ServiceMessageCallback) -> None: ...
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
@property
|
|
def is_closed(self) -> bool:
|
|
return self._impl.is_closed()
|
|
|
|
def activate(self) -> None:
|
|
return _invoke(self._impl.activate, ())
|
|
|
|
def cancel(self) -> None:
|
|
return _invoke(self._impl.cancel, ())
|
|
|
|
def request(self, parameters: Any) -> Any:
|
|
return _invoke(self._impl.request, (parameters, ))
|
|
|
|
|
|
class Session:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Session(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
@property
|
|
def is_detached(self) -> bool:
|
|
return self._impl.is_detached()
|
|
|
|
def detach(self) -> None:
|
|
return _invoke(self._impl.detach, ())
|
|
|
|
def resume(self) -> None:
|
|
return _invoke(self._impl.resume, ())
|
|
|
|
def enable_child_gating(self) -> None:
|
|
return _invoke(self._impl.enable_child_gating, ())
|
|
|
|
def disable_child_gating(self) -> None:
|
|
return _invoke(self._impl.disable_child_gating, ())
|
|
|
|
def create_script(self, source: str, name: Optional[str] = None, snapshot: Optional[bytes] = None, runtime: Optional[str] = None) -> "Script":
|
|
options = _frida.ScriptOptions()
|
|
if name is not None:
|
|
options.name = name
|
|
if snapshot is not None:
|
|
options.snapshot = snapshot
|
|
if runtime is not None:
|
|
options.runtime = runtime
|
|
return _wrap(_invoke(self._impl.create_script, (source, options, )))
|
|
|
|
def create_script_from_bytes(self, data: bytes, name: Optional[str] = None, snapshot: Optional[bytes] = None, runtime: Optional[str] = None) -> "Script":
|
|
bytes = data
|
|
options = _frida.ScriptOptions()
|
|
if name is not None:
|
|
options.name = name
|
|
if snapshot is not None:
|
|
options.snapshot = snapshot
|
|
if runtime is not None:
|
|
options.runtime = runtime
|
|
return _wrap(_invoke(self._impl.create_script_from_bytes, (bytes, options, )))
|
|
|
|
def compile_script(self, source: str, name: Optional[str] = None, runtime: Optional[str] = None) -> bytes:
|
|
options = _frida.ScriptOptions()
|
|
if name is not None:
|
|
options.name = name
|
|
if runtime is not None:
|
|
options.runtime = runtime
|
|
return _invoke(self._impl.compile_script, (source, options, ))
|
|
|
|
def snapshot_script(self, embed_script: str, warmup_script: Optional[str] = None, runtime: Optional[str] = None) -> bytes:
|
|
options = _frida.SnapshotOptions()
|
|
if warmup_script is not None:
|
|
options.warmup_script = warmup_script
|
|
if runtime is not None:
|
|
options.runtime = runtime
|
|
return _invoke(self._impl.snapshot_script, (embed_script, options, ))
|
|
|
|
def setup_peer_connection(self, **kwargs) -> None:
|
|
return _invoke(self._impl.setup_peer_connection, (_make_options(_frida.PeerOptions, kwargs, {'relays': 'add_relay'}), ))
|
|
|
|
def join_portal(self, address: str, **kwargs) -> "PortalMembership":
|
|
return _wrap(_invoke(self._impl.join_portal, (address, _make_options(_frida.PortalOptions, kwargs, {}), )))
|
|
|
|
@property
|
|
def pid(self) -> int:
|
|
return self._impl.pid
|
|
|
|
@property
|
|
def persist_timeout(self) -> int:
|
|
return self._impl.persist_timeout
|
|
|
|
def __repr__(self):
|
|
return f"Session(pid={self.pid!r}, persist_timeout={self.persist_timeout!r})"
|
|
|
|
|
|
class Script:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Script(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def is_destroyed(self) -> bool:
|
|
return self._impl.is_destroyed()
|
|
|
|
def load(self) -> None:
|
|
return _invoke(self._impl.load, ())
|
|
|
|
def interrupt(self) -> None:
|
|
return _invoke(self._impl.interrupt, ())
|
|
|
|
def unload(self) -> None:
|
|
return _invoke(self._impl.unload, ())
|
|
|
|
def terminate(self) -> None:
|
|
return _invoke(self._impl.terminate, ())
|
|
|
|
def eternalize(self) -> None:
|
|
return _invoke(self._impl.eternalize, ())
|
|
|
|
def post(self, message: Any, data: Optional[bytes] = None) -> None:
|
|
json = _to_json(message)
|
|
return self._impl.post(json, data, )
|
|
|
|
def enable_debugger(self, port: int = 0) -> None:
|
|
return _invoke(self._impl.enable_debugger, (port, ))
|
|
|
|
def disable_debugger(self) -> None:
|
|
return _invoke(self._impl.disable_debugger, ())
|
|
|
|
def _setup(self) -> None:
|
|
self.exports_sync = _ScriptExports(self)
|
|
self._message_handlers: List[ScriptMessageCallback] = []
|
|
self._log_handler: Callable[[str, str], None] = self.default_log_handler
|
|
self._pending: Dict[int, Callable[[Any, Optional[Exception]], None]] = {}
|
|
self._next_request_id = 1
|
|
self._cond = threading.Condition()
|
|
self._impl.on("message", self._on_message)
|
|
self._impl.on("destroyed", self._on_destroyed)
|
|
|
|
@property
|
|
def exports(self) -> "_ScriptExports":
|
|
return self.exports_sync
|
|
|
|
@overload
|
|
def on(self, signal: Literal["destroyed"], callback: ScriptDestroyedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["message"], callback: ScriptMessageCallback) -> None: ...
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
if signal == "message":
|
|
self._message_handlers.append(callback)
|
|
else:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
@overload
|
|
def off(self, signal: Literal["destroyed"], callback: ScriptDestroyedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["message"], callback: ScriptMessageCallback) -> None: ...
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
if signal == "message":
|
|
self._message_handlers.remove(callback)
|
|
else:
|
|
self._impl.off(signal, callback)
|
|
|
|
def get_log_handler(self) -> Callable[[str, str], None]:
|
|
return self._log_handler
|
|
|
|
def set_log_handler(self, handler: Callable[[str, str], None]) -> None:
|
|
self._log_handler = handler
|
|
|
|
def default_log_handler(self, level: str, text: str) -> None:
|
|
if level == "info":
|
|
print(text, file=sys.stdout)
|
|
else:
|
|
print(text, file=sys.stderr)
|
|
|
|
def list_exports_sync(self) -> List[str]:
|
|
return self._rpc_request(["list"])
|
|
|
|
def list_exports(self) -> List[str]:
|
|
return self.list_exports_sync()
|
|
|
|
def _list_exports(self) -> List[str]:
|
|
return self.list_exports_sync()
|
|
|
|
def _rpc_request(self, args: Any, data: Optional[bytes] = None) -> Any:
|
|
outcome: Dict[str, Any] = {}
|
|
cond = self._cond
|
|
|
|
def complete(value: Any, error: Optional[Exception]) -> None:
|
|
with cond:
|
|
outcome["value"] = value
|
|
outcome["error"] = error
|
|
cond.notify_all()
|
|
|
|
with cond:
|
|
request_id = self._next_request_id
|
|
self._next_request_id += 1
|
|
self._pending[request_id] = complete
|
|
|
|
if self._impl.is_destroyed():
|
|
self._on_destroyed()
|
|
else:
|
|
self.post(["frida:rpc", request_id] + list(args), data)
|
|
|
|
with cond:
|
|
while not outcome:
|
|
cond.wait()
|
|
|
|
if outcome["error"] is not None:
|
|
raise outcome["error"]
|
|
return outcome["value"]
|
|
|
|
def _on_message(self, raw_message: str, data: Optional[bytes]) -> None:
|
|
message = json.loads(raw_message)
|
|
mtype = message["type"]
|
|
payload = message.get("payload")
|
|
if mtype == "log":
|
|
self._log_handler(message["level"], payload)
|
|
elif mtype == "send" and isinstance(payload, list) and payload[:1] == ["frida:rpc"]:
|
|
self._on_rpc_message(payload[1], payload[2], payload[3:], data)
|
|
else:
|
|
for handler in list(self._message_handlers):
|
|
try:
|
|
handler(message, data)
|
|
except Exception:
|
|
traceback.print_exc()
|
|
|
|
def _on_destroyed(self) -> None:
|
|
while True:
|
|
with self._cond:
|
|
pending_ids = list(self._pending.keys())
|
|
complete = self._pending.pop(pending_ids[0]) if pending_ids else None
|
|
if complete is None:
|
|
break
|
|
complete(None, _frida.InvalidOperationError("script has been destroyed"))
|
|
|
|
def _on_rpc_message(self, request_id: int, operation: str, params: List[Any], data: Optional[Any]) -> None:
|
|
if operation not in ("ok", "error"):
|
|
return
|
|
complete = self._pending.pop(request_id, None)
|
|
if complete is None:
|
|
return
|
|
if operation == "error":
|
|
complete(None, RPCException(*params[0:3]))
|
|
elif data is not None:
|
|
complete((params[1], data) if len(params) > 1 else data, None)
|
|
else:
|
|
complete(params[0], None)
|
|
|
|
|
|
class PortalMembership:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.PortalMembership(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def terminate(self) -> None:
|
|
return _invoke(self._impl.terminate, ())
|
|
|
|
|
|
class PackageManager:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.PackageManager(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
def search(self, query: str, **kwargs) -> "PackageSearchResult":
|
|
return _wrap(_invoke(self._impl.search, (query, _make_options(_frida.PackageSearchOptions, kwargs, {}), )))
|
|
|
|
def install(self, **kwargs) -> "PackageInstallResult":
|
|
return _wrap(_invoke(self._impl.install, (_make_options(_frida.PackageInstallOptions, kwargs, {'specs': 'add_spec', 'omits': 'add_omit'}), )))
|
|
|
|
@property
|
|
def registry(self) -> str:
|
|
return self._impl.registry
|
|
|
|
@registry.setter
|
|
def registry(self, value: str) -> None:
|
|
self._impl.registry = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"PackageManager(registry={self.registry!r})"
|
|
|
|
|
|
class Package:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Package(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def name(self) -> str:
|
|
return self._impl.name
|
|
|
|
@property
|
|
def version(self) -> str:
|
|
return self._impl.version
|
|
|
|
@property
|
|
def description(self) -> str:
|
|
return self._impl.description
|
|
|
|
@property
|
|
def url(self) -> str:
|
|
return self._impl.url
|
|
|
|
def __repr__(self):
|
|
return f"Package(name={self.name!r}, version={self.version!r}, description={self.description!r}, url={self.url!r})"
|
|
|
|
|
|
class PackageSearchResult:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.PackageSearchResult(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def packages(self) -> list["Package"]:
|
|
return [_wrap(element) for element in self._impl.packages]
|
|
|
|
@property
|
|
def total(self) -> int:
|
|
return self._impl.total
|
|
|
|
def __repr__(self):
|
|
return f"PackageSearchResult(total={self.total!r})"
|
|
|
|
|
|
class PackageInstallResult:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.PackageInstallResult(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def packages(self) -> list["Package"]:
|
|
return [_wrap(element) for element in self._impl.packages]
|
|
|
|
|
|
class ControlService:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.ControlService(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def start(self) -> None:
|
|
return _invoke(self._impl.start, ())
|
|
|
|
def stop(self) -> None:
|
|
return _invoke(self._impl.stop, ())
|
|
|
|
|
|
class PortalService:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.PortalService(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {'cluster_endpoints': 'add_cluster_endpoint', 'control_endpoints': 'add_control_endpoint'})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def add_cluster_endpoint(self, endpoint_params: "EndpointParameters") -> None:
|
|
return self._impl.add_cluster_endpoint(_unwrap(endpoint_params))
|
|
|
|
def add_control_endpoint(self, endpoint_params: "EndpointParameters") -> None:
|
|
return self._impl.add_control_endpoint(_unwrap(endpoint_params))
|
|
|
|
def start(self) -> None:
|
|
return _invoke(self._impl.start, ())
|
|
|
|
def stop(self) -> None:
|
|
return _invoke(self._impl.stop, ())
|
|
|
|
def kick(self, connection_id: int) -> None:
|
|
return self._impl.kick(connection_id)
|
|
|
|
def post(self, connection_id: int, message: Any, data: Optional[bytes] = None) -> None:
|
|
json = _to_json(message)
|
|
return self._impl.post(connection_id, json, data, )
|
|
|
|
def narrowcast(self, tag: str, message: Any, data: Optional[bytes] = None) -> None:
|
|
json = _to_json(message)
|
|
return self._impl.narrowcast(tag, json, data, )
|
|
|
|
def broadcast(self, message: Any, data: Optional[bytes] = None) -> None:
|
|
json = _to_json(message)
|
|
return self._impl.broadcast(json, data, )
|
|
|
|
def enumerate_tags(self, connection_id: int) -> list[str]:
|
|
return self._impl.enumerate_tags(connection_id)
|
|
|
|
def tag(self, connection_id: int, tag: str) -> None:
|
|
return self._impl.tag(connection_id, tag)
|
|
|
|
def untag(self, connection_id: int, tag: str) -> None:
|
|
return self._impl.untag(connection_id, tag)
|
|
|
|
@property
|
|
def device(self) -> "Device":
|
|
return _wrap(self._impl.device)
|
|
|
|
@property
|
|
def cluster_params(self) -> "EndpointParameters":
|
|
return _wrap(self._impl.cluster_params)
|
|
|
|
@property
|
|
def control_params(self) -> "EndpointParameters":
|
|
return _wrap(self._impl.control_params)
|
|
|
|
def _setup(self) -> None:
|
|
self._authenticated_handlers: List[PortalServiceAuthenticatedCallback] = []
|
|
self._message_handlers: List[PortalServiceMessageCallback] = []
|
|
self._impl.on("authenticated", self._on_authenticated)
|
|
self._impl.on("message", self._on_message)
|
|
|
|
@overload
|
|
def on(self, signal: Literal["node-connected"], callback: PortalServiceNodeConnectedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["node-joined"], callback: PortalServiceNodeJoinedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["node-left"], callback: PortalServiceNodeLeftCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["node-disconnected"], callback: PortalServiceNodeDisconnectedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["controller-connected"], callback: PortalServiceControllerConnectedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["controller-disconnected"], callback: PortalServiceControllerDisconnectedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["authenticated"], callback: PortalServiceAuthenticatedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["subscribe"], callback: PortalServiceSubscribeCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["message"], callback: PortalServiceMessageCallback) -> None: ...
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
if signal == "authenticated":
|
|
self._authenticated_handlers.append(callback)
|
|
elif signal == "message":
|
|
self._message_handlers.append(callback)
|
|
else:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
@overload
|
|
def off(self, signal: Literal["node-connected"], callback: PortalServiceNodeConnectedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["node-joined"], callback: PortalServiceNodeJoinedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["node-left"], callback: PortalServiceNodeLeftCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["node-disconnected"], callback: PortalServiceNodeDisconnectedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["controller-connected"], callback: PortalServiceControllerConnectedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["controller-disconnected"], callback: PortalServiceControllerDisconnectedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["authenticated"], callback: PortalServiceAuthenticatedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["subscribe"], callback: PortalServiceSubscribeCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["message"], callback: PortalServiceMessageCallback) -> None: ...
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
if signal == "authenticated":
|
|
self._authenticated_handlers.remove(callback)
|
|
elif signal == "message":
|
|
self._message_handlers.remove(callback)
|
|
else:
|
|
self._impl.off(signal, callback)
|
|
|
|
def _on_authenticated(self, connection_id: int, raw_session_info: str) -> None:
|
|
session_info = json.loads(raw_session_info)
|
|
for handler in list(self._authenticated_handlers):
|
|
try:
|
|
handler(connection_id, session_info)
|
|
except Exception:
|
|
traceback.print_exc()
|
|
|
|
def _on_message(self, connection_id: int, raw_message: str, data: Optional[bytes]) -> None:
|
|
message = json.loads(raw_message)
|
|
for handler in list(self._message_handlers):
|
|
try:
|
|
handler(connection_id, message, data)
|
|
except Exception:
|
|
traceback.print_exc()
|
|
|
|
|
|
class FileMonitor:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.FileMonitor(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
def enable(self) -> None:
|
|
return _invoke(self._impl.enable, ())
|
|
|
|
def disable(self) -> None:
|
|
return _invoke(self._impl.disable, ())
|
|
|
|
@property
|
|
def path(self) -> str:
|
|
return self._impl.path
|
|
|
|
def __repr__(self):
|
|
return f"FileMonitor(path={self.path!r})"
|
|
|
|
|
|
class Compiler:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Compiler(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@overload
|
|
def on(self, signal: Literal["starting"], callback: CompilerStartingCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["finished"], callback: CompilerFinishedCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["output"], callback: CompilerOutputCallback) -> None: ...
|
|
@overload
|
|
def on(self, signal: Literal["diagnostics"], callback: CompilerDiagnosticsCallback) -> None: ...
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
@overload
|
|
def off(self, signal: Literal["starting"], callback: CompilerStartingCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["finished"], callback: CompilerFinishedCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["output"], callback: CompilerOutputCallback) -> None: ...
|
|
@overload
|
|
def off(self, signal: Literal["diagnostics"], callback: CompilerDiagnosticsCallback) -> None: ...
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
def build(self, entrypoint: str, **kwargs) -> str:
|
|
return _invoke(self._impl.build, (entrypoint, _make_options(_frida.BuildOptions, kwargs, {'externals': 'add_external'}), ))
|
|
|
|
def watch(self, entrypoint: str, **kwargs) -> None:
|
|
return _invoke(self._impl.watch, (entrypoint, _make_options(_frida.WatchOptions, kwargs, {'externals': 'add_external'}), ))
|
|
|
|
|
|
class LanguageServer:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.LanguageServer(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
def start(self) -> None:
|
|
return _invoke(self._impl.start, ())
|
|
|
|
def stop(self) -> None:
|
|
return self._impl.stop()
|
|
|
|
def post(self, json: str) -> None:
|
|
return self._impl.post(json)
|
|
|
|
@property
|
|
def project_root(self) -> str:
|
|
return self._impl.project_root
|
|
|
|
def __repr__(self):
|
|
return f"LanguageServer(project_root={self.project_root!r})"
|
|
|
|
|
|
class StaticAuthenticationService:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.StaticAuthenticationService(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def token_hash(self) -> str:
|
|
return self._impl.token_hash
|
|
|
|
def __repr__(self):
|
|
return f"StaticAuthenticationService(token_hash={self.token_hash!r})"
|
|
|
|
|
|
class Relay:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Relay(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def address(self) -> str:
|
|
return self._impl.address
|
|
|
|
@property
|
|
def username(self) -> str:
|
|
return self._impl.username
|
|
|
|
@property
|
|
def password(self) -> str:
|
|
return self._impl.password
|
|
|
|
@property
|
|
def kind(self) -> str:
|
|
return self._impl.kind
|
|
|
|
def __repr__(self):
|
|
return f"Relay(address={self.address!r}, username={self.username!r}, password={self.password!r}, kind={self.kind!r})"
|
|
|
|
|
|
class EndpointParameters:
|
|
def __init__(self, address: Optional[str] = None, port: Optional[int] = None, certificate: Optional[str] = None, origin: Optional[str] = None, authentication: Optional[Tuple[str, Any]] = None, asset_root: Optional[str] = None, request_handler: Optional[Callable[..., Any]] = None):
|
|
auth_service = None
|
|
if authentication is not None:
|
|
if isinstance(authentication, tuple):
|
|
scheme, data = authentication
|
|
if scheme == "token":
|
|
auth_service = _frida.StaticAuthenticationService(data)
|
|
elif scheme == "callback":
|
|
if not callable(data):
|
|
raise ValueError("authentication data must be callable for the callback scheme")
|
|
service = AuthenticationService.__new__(AuthenticationService)
|
|
service.authenticate = lambda token: json.dumps(data(token)) # type: ignore[attr-defined]
|
|
AuthenticationService.__init__(service)
|
|
auth_service = service._impl
|
|
else:
|
|
raise ValueError("invalid authentication scheme")
|
|
else:
|
|
auth_service = _unwrap(authentication)
|
|
|
|
kwargs: Dict[str, Any] = {}
|
|
if address is not None:
|
|
kwargs["address"] = address
|
|
if port is not None:
|
|
kwargs["port"] = port
|
|
if certificate is not None:
|
|
kwargs["certificate"] = certificate
|
|
if origin is not None:
|
|
kwargs["origin"] = origin
|
|
if auth_service is not None:
|
|
kwargs["auth_service"] = auth_service
|
|
if asset_root is not None:
|
|
kwargs["asset_root"] = str(asset_root)
|
|
|
|
self._impl = _frida.EndpointParameters(**kwargs)
|
|
|
|
if request_handler is not None:
|
|
self._impl.request_handler = _unwrap(request_handler)
|
|
|
|
@property
|
|
def address(self) -> str:
|
|
return self._impl.address
|
|
|
|
@property
|
|
def port(self) -> int:
|
|
return self._impl.port
|
|
|
|
@property
|
|
def certificate(self) -> str:
|
|
return self._impl.certificate
|
|
|
|
@property
|
|
def origin(self) -> str:
|
|
return self._impl.origin
|
|
|
|
@property
|
|
def auth_service(self) -> "AuthenticationService":
|
|
return _wrap(self._impl.auth_service)
|
|
|
|
@property
|
|
def request_handler(self) -> "WebRequestHandler":
|
|
return _wrap(self._impl.request_handler)
|
|
|
|
@request_handler.setter
|
|
def request_handler(self, value: "WebRequestHandler") -> None:
|
|
self._impl.request_handler = _unwrap(value)
|
|
|
|
def __repr__(self):
|
|
return f"EndpointParameters(address={self.address!r}, port={self.port!r}, origin={self.origin!r})"
|
|
|
|
|
|
class WebRequest:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.WebRequest(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def method(self) -> str:
|
|
return self._impl.method
|
|
|
|
@property
|
|
def path(self) -> str:
|
|
return self._impl.path
|
|
|
|
@property
|
|
def query_string(self) -> str:
|
|
return self._impl.query_string
|
|
|
|
@property
|
|
def body(self) -> bytes:
|
|
return self._impl.body
|
|
|
|
def __repr__(self):
|
|
return f"WebRequest(method={self.method!r}, path={self.path!r}, query_string={self.query_string!r})"
|
|
|
|
|
|
class WebResponse:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.WebResponse(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {'headers': 'add_header'})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def add_header(self, name: str, val: str) -> None:
|
|
return self._impl.add_header(name, val)
|
|
|
|
@property
|
|
def status(self) -> int:
|
|
return self._impl.status
|
|
|
|
@property
|
|
def body(self) -> bytes:
|
|
return self._impl.body
|
|
|
|
def __repr__(self):
|
|
return f"WebResponse(status={self.status!r})"
|
|
|
|
|
|
class AuthenticationService(_Implementation):
|
|
def __init__(self):
|
|
self._impl = _frida.AuthenticationService(self)
|
|
|
|
|
|
class WebRequestHandler(_Implementation):
|
|
def __init__(self):
|
|
self._impl = _frida.WebRequestHandler(self)
|
|
|
|
|
|
class Cancellable:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.Cancellable(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def on(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.on(signal, _make_signal_handler(callback))
|
|
|
|
def off(self, signal: str, callback: Callable[..., Any]) -> None:
|
|
self._impl.off(signal, callback)
|
|
|
|
def cancel(self) -> None:
|
|
return self._impl.cancel()
|
|
|
|
def get_fd(self) -> int:
|
|
return self._impl.get_fd()
|
|
|
|
@property
|
|
def is_cancelled(self) -> bool:
|
|
return self._impl.is_cancelled()
|
|
|
|
def pop_current(self) -> None:
|
|
return self._impl.pop_current()
|
|
|
|
def push_current(self) -> None:
|
|
return self._impl.push_current()
|
|
|
|
def release_fd(self) -> None:
|
|
return self._impl.release_fd()
|
|
|
|
def reset(self) -> None:
|
|
return self._impl.reset()
|
|
|
|
def set_error_if_cancelled(self) -> bool:
|
|
return self._impl.set_error_if_cancelled()
|
|
|
|
def __enter__(self) -> "Cancellable":
|
|
stack = getattr(_current_cancellable, "stack", None)
|
|
if stack is None:
|
|
stack = []
|
|
_current_cancellable.stack = stack
|
|
stack.append(self)
|
|
return self
|
|
|
|
def __exit__(self, *exc: Any) -> Literal[False]:
|
|
_current_cancellable.stack.pop()
|
|
return False
|
|
|
|
@classmethod
|
|
def get_current(cls) -> "Cancellable":
|
|
return _current_cancellable_get()
|
|
|
|
def raise_if_cancelled(self) -> None:
|
|
if self._impl.is_cancelled():
|
|
raise _frida.OperationCancelledError("operation was cancelled")
|
|
|
|
def get_pollfd(self) -> "CancellablePollFD":
|
|
return CancellablePollFD(self._impl)
|
|
|
|
|
|
def _setup(self) -> None:
|
|
self._cancel_handlers: Dict[int, Callable[..., Any]] = {}
|
|
self._next_cancel_handler_id = 1
|
|
|
|
|
|
def connect(self, callback: Callable[..., Any]) -> int:
|
|
if self._impl.is_cancelled():
|
|
callback()
|
|
return 0
|
|
|
|
handler_id = self._next_cancel_handler_id
|
|
self._next_cancel_handler_id = handler_id + 1
|
|
|
|
def handler(*args: Any) -> None:
|
|
callback()
|
|
|
|
self._cancel_handlers[handler_id] = handler
|
|
self._impl.on("cancelled", handler)
|
|
return handler_id
|
|
|
|
|
|
def disconnect(self, handler_id: int) -> None:
|
|
handler = self._cancel_handlers.pop(handler_id, None)
|
|
if handler is not None:
|
|
self._impl.off("cancelled", handler)
|
|
|
|
|
|
class IOStream:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.IOStream(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def input_stream(self) -> "InputStream":
|
|
return _wrap(self._impl.input_stream)
|
|
|
|
@property
|
|
def output_stream(self) -> "OutputStream":
|
|
return _wrap(self._impl.output_stream)
|
|
|
|
@property
|
|
def is_closed(self) -> bool:
|
|
return self._impl.is_closed
|
|
|
|
def close(self) -> None:
|
|
_invoke(self._impl.close_async, (0,))
|
|
|
|
def read(self, count: int) -> bytes:
|
|
return _invoke(self._impl.input_stream.read_bytes_async, (count, 0))
|
|
|
|
def read_all(self, count: int) -> bytes:
|
|
chunks = []
|
|
remaining = count
|
|
while remaining > 0:
|
|
chunk = _invoke(self._impl.input_stream.read_bytes_async, (remaining, 0))
|
|
if not chunk:
|
|
break
|
|
chunks.append(chunk)
|
|
remaining -= len(chunk)
|
|
return b"".join(chunks)
|
|
|
|
def write(self, data: bytes) -> int:
|
|
return _invoke(self._impl.output_stream.write_bytes_async, (data, 0))
|
|
|
|
def write_all(self, data: bytes) -> None:
|
|
view = memoryview(data)
|
|
while len(view) != 0:
|
|
written = _invoke(self._impl.output_stream.write_bytes_async, (bytes(view), 0))
|
|
view = view[written:]
|
|
|
|
def __repr__(self):
|
|
return f"IOStream(is_closed={self.is_closed!r})"
|
|
|
|
|
|
class InputStream:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.InputStream(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def close_async(self, io_priority: int) -> bool:
|
|
return _invoke(self._impl.close_async, (io_priority, ))
|
|
|
|
def read_bytes_async(self, count: int, io_priority: int) -> bytes:
|
|
return _invoke(self._impl.read_bytes_async, (count, io_priority, ))
|
|
|
|
def skip_async(self, count: int, io_priority: int) -> int:
|
|
return _invoke(self._impl.skip_async, (count, io_priority, ))
|
|
|
|
|
|
class OutputStream:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.OutputStream(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def close_async(self, io_priority: int) -> bool:
|
|
return _invoke(self._impl.close_async, (io_priority, ))
|
|
|
|
def flush_async(self, io_priority: int) -> bool:
|
|
return _invoke(self._impl.flush_async, (io_priority, ))
|
|
|
|
def write_bytes_async(self, bytes: bytes, io_priority: int) -> int:
|
|
return _invoke(self._impl.write_bytes_async, (bytes, io_priority, ))
|
|
|
|
|
|
class SocketAddress:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.SocketAddress(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def family(self) -> str:
|
|
return self._impl.family
|
|
|
|
def get_native_size(self) -> int:
|
|
return self._impl.get_native_size()
|
|
|
|
def __repr__(self):
|
|
return f"SocketAddress(family={self.family!r})"
|
|
|
|
|
|
class SocketAddressEnumerator:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.SocketAddressEnumerator(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def next(self, cancellable: Optional["Cancellable"] = None) -> "SocketAddress":
|
|
return _wrap(self._impl.next(_unwrap(cancellable)))
|
|
|
|
def next_async(self) -> "SocketAddress":
|
|
return _wrap(_invoke(self._impl.next_async, ()))
|
|
|
|
|
|
class SocketConnectable:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.SocketConnectable(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def enumerate(self) -> "SocketAddressEnumerator":
|
|
return _wrap(self._impl.enumerate())
|
|
|
|
def proxy_enumerate(self) -> "SocketAddressEnumerator":
|
|
return _wrap(self._impl.proxy_enumerate())
|
|
|
|
def to_string(self) -> str:
|
|
return self._impl.to_string()
|
|
|
|
|
|
class InetSocketAddress:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.InetSocketAddress(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def address(self) -> "InetAddress":
|
|
return _wrap(self._impl.address)
|
|
|
|
@property
|
|
def flowinfo(self) -> int:
|
|
return self._impl.flowinfo
|
|
|
|
@property
|
|
def port(self) -> int:
|
|
return self._impl.port
|
|
|
|
@property
|
|
def scope_id(self) -> int:
|
|
return self._impl.scope_id
|
|
|
|
def __repr__(self):
|
|
return f"InetSocketAddress(flowinfo={self.flowinfo!r}, port={self.port!r}, scope_id={self.scope_id!r})"
|
|
|
|
|
|
class InetAddress:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.InetAddress(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
def equal(self, other_address: "InetAddress") -> bool:
|
|
return self._impl.equal(_unwrap(other_address))
|
|
|
|
@property
|
|
def family(self) -> str:
|
|
return self._impl.family
|
|
|
|
@property
|
|
def is_any(self) -> bool:
|
|
return self._impl.is_any
|
|
|
|
@property
|
|
def is_link_local(self) -> bool:
|
|
return self._impl.is_link_local
|
|
|
|
@property
|
|
def is_loopback(self) -> bool:
|
|
return self._impl.is_loopback
|
|
|
|
@property
|
|
def is_mc_global(self) -> bool:
|
|
return self._impl.is_mc_global
|
|
|
|
@property
|
|
def is_mc_link_local(self) -> bool:
|
|
return self._impl.is_mc_link_local
|
|
|
|
@property
|
|
def is_mc_node_local(self) -> bool:
|
|
return self._impl.is_mc_node_local
|
|
|
|
@property
|
|
def is_mc_org_local(self) -> bool:
|
|
return self._impl.is_mc_org_local
|
|
|
|
@property
|
|
def is_mc_site_local(self) -> bool:
|
|
return self._impl.is_mc_site_local
|
|
|
|
@property
|
|
def is_multicast(self) -> bool:
|
|
return self._impl.is_multicast
|
|
|
|
@property
|
|
def is_site_local(self) -> bool:
|
|
return self._impl.is_site_local
|
|
|
|
def get_native_size(self) -> int:
|
|
return self._impl.get_native_size()
|
|
|
|
def to_string(self) -> str:
|
|
return self._impl.to_string()
|
|
|
|
def __repr__(self):
|
|
return f"InetAddress(family={self.family!r}, is_any={self.is_any!r}, is_link_local={self.is_link_local!r}, is_loopback={self.is_loopback!r}, is_mc_global={self.is_mc_global!r}, is_mc_link_local={self.is_mc_link_local!r}, is_mc_node_local={self.is_mc_node_local!r}, is_mc_org_local={self.is_mc_org_local!r}, is_mc_site_local={self.is_mc_site_local!r}, is_multicast={self.is_multicast!r}, is_site_local={self.is_site_local!r})"
|
|
|
|
|
|
class UnixSocketAddress:
|
|
def __init__(self, *args, **kwargs):
|
|
self._impl = _frida.UnixSocketAddress(*[_unwrap(a) for a in args])
|
|
_apply_settings(self._impl, kwargs, {})
|
|
setup = getattr(self, "_setup", None)
|
|
if setup is not None:
|
|
setup()
|
|
|
|
@property
|
|
def address_type(self) -> str:
|
|
return self._impl.address_type
|
|
|
|
@property
|
|
def path(self) -> str:
|
|
return self._impl.path
|
|
|
|
def __repr__(self):
|
|
return f"UnixSocketAddress(address_type={self.address_type!r}, path={self.path!r})"
|
|
|
|
|
|
_WRAPPERS = {
|
|
"GObject": GObject,
|
|
"DeviceManager": DeviceManager,
|
|
"Device": Device,
|
|
"BareboneConfig": BareboneConfig,
|
|
"BareboneConnectionConfig": BareboneConnectionConfig,
|
|
"BareboneAllocatorConfig": BareboneAllocatorConfig,
|
|
"BareboneInvalidAllocatorConfig": BareboneInvalidAllocatorConfig,
|
|
"BarebonePhysicalAllocatorConfig": BarebonePhysicalAllocatorConfig,
|
|
"BareboneTargetFunctionsAllocatorConfig": BareboneTargetFunctionsAllocatorConfig,
|
|
"BareboneCallArgument": BareboneCallArgument,
|
|
"BareboneAgentConfig": BareboneAgentConfig,
|
|
"BareboneInvalidAgentConfig": BareboneInvalidAgentConfig,
|
|
"BareboneInjectedAgentConfig": BareboneInjectedAgentConfig,
|
|
"BareboneResidentAgentConfig": BareboneResidentAgentConfig,
|
|
"BareboneTransportConfig": BareboneTransportConfig,
|
|
"BareboneInjectingTransportConfig": BareboneInjectingTransportConfig,
|
|
"BareboneResidentTransportConfig": BareboneResidentTransportConfig,
|
|
"BareboneHostlinkTransportConfig": BareboneHostlinkTransportConfig,
|
|
"BareboneHostlinkFabric": BareboneHostlinkFabric,
|
|
"BareboneHostlinkEcamFabric": BareboneHostlinkEcamFabric,
|
|
"BareboneHostlinkPortsFabric": BareboneHostlinkPortsFabric,
|
|
"BareboneHostlinkMmioFabric": BareboneHostlinkMmioFabric,
|
|
"BareboneVsockTransportConfig": BareboneVsockTransportConfig,
|
|
"BareboneDeviceTransportConfig": BareboneDeviceTransportConfig,
|
|
"BareboneSocketTransportConfig": BareboneSocketTransportConfig,
|
|
"BareboneImageConfig": BareboneImageConfig,
|
|
"BareboneMemoryAddress": BareboneMemoryAddress,
|
|
"BareboneInvalidMemoryAddress": BareboneInvalidMemoryAddress,
|
|
"BareboneNonNullMemoryAddress": BareboneNonNullMemoryAddress,
|
|
"Application": Application,
|
|
"Process": Process,
|
|
"Spawn": Spawn,
|
|
"Child": Child,
|
|
"Crash": Crash,
|
|
"Bus": Bus,
|
|
"Service": Service,
|
|
"Session": Session,
|
|
"Script": Script,
|
|
"PortalMembership": PortalMembership,
|
|
"PackageManager": PackageManager,
|
|
"Package": Package,
|
|
"PackageSearchResult": PackageSearchResult,
|
|
"PackageInstallResult": PackageInstallResult,
|
|
"ControlService": ControlService,
|
|
"PortalService": PortalService,
|
|
"FileMonitor": FileMonitor,
|
|
"Compiler": Compiler,
|
|
"LanguageServer": LanguageServer,
|
|
"StaticAuthenticationService": StaticAuthenticationService,
|
|
"Relay": Relay,
|
|
"EndpointParameters": EndpointParameters,
|
|
"WebRequest": WebRequest,
|
|
"WebResponse": WebResponse,
|
|
"AuthenticationService": AuthenticationService,
|
|
"WebRequestHandler": WebRequestHandler,
|
|
"Cancellable": Cancellable,
|
|
"IOStream": IOStream,
|
|
"InputStream": InputStream,
|
|
"OutputStream": OutputStream,
|
|
"SocketAddress": SocketAddress,
|
|
"SocketAddressEnumerator": SocketAddressEnumerator,
|
|
"SocketConnectable": SocketConnectable,
|
|
"InetSocketAddress": InetSocketAddress,
|
|
"InetAddress": InetAddress,
|
|
"UnixSocketAddress": UnixSocketAddress,
|
|
}
|
|
|
|
|
|
from . import aio
|
|
|
|
ScriptExportsAsync = aio._ScriptExports
|
|
|
|
core = sys.modules[__name__]
|
|
sys.modules[__name__ + ".core"] = core
|