An open API service indexing awesome lists of open source software.

https://github.com/frida/frida-core

Frida core library intended for static linking into bindings
https://github.com/frida/frida-core

frida instrumentation vala

Last synced: 19 days ago
JSON representation

Frida core library intended for static linking into bindings

Awesome Lists containing this project

README

          

# frida-core

Frida core library.

- Lets you inject your own JavaScript instrumentation code
into other processes, optionally with your own [C code][]
for performance-sensitive bits.
- Acts as a logistics layer that packages up [GumJS][] into
a shared library.
- Provides a two-way communication channel for talking to
your scripts, if needed, and later unload them.
- Also lets you enumerate installed apps, running processes,
and connected devices.
- Written in [Vala][], with OS-specific glue code in
C/Objective-C/asm.

## Binaries

Typically used through one of the available language bindings:

- [Python][]
- [Node.js][]
- [.NET][]
- [Swift][]
- [Qml][]

E.g.:

```console
$ pip install frida-tools # CLI tools
$ pip install frida # Python bindings
$ npm install frida # Node.js bindings
```

Or, for static linking into your own project written in a
C-compatible language, download a devkit from the Frida
[releases][] page.

## Distro Packaging

For building a shared library suitable for distro packaging:

```console
$ ./configure --enable-shared --without-prebuilds=sdk && make
```

This builds `libfrida-core-1.0.so` against system dependencies,
while `frida-agent.so` is built using Frida's SDK (with its GLib
fork, needed for the agent's inject/unload lifecycle).

Prerequisites on Fedora:

```console
$ sudo dnf install libgee-devel json-glib-devel \
libsoup3-devel libunwind-devel libdwarf-devel \
libnice-devel ngtcp2-crypto-ossl-devel
```

Prerequisites on Ubuntu:

```console
$ sudo apt install libgee-0.8-dev libjson-glib-dev \
libsoup-3.0-dev libunwind-dev libdwarf-dev \
libnice-dev libngtcp2-crypto-ossl-dev
```

Prerequisites on macOS:

```console
$ brew install libgee json-glib libsoup libnice capstone
```

## Internals

For a higher level view of the internals, check out the [architecture diagram][]
and its links to the different parts of the codebase.

[C code]: https://frida.re/docs/javascript-api/#cmodule
[Vala]: https://wiki.gnome.org/Projects/Vala
[GumJS]: https://github.com/frida/frida-gum
[Python]: https://github.com/frida/frida-python
[Node.js]: https://github.com/frida/frida-node
[.NET]: https://github.com/frida/frida-clr
[Swift]: https://github.com/frida/frida-swift
[Qml]: https://github.com/frida/frida-qml
[releases]: https://github.com/frida/frida/releases
[architecture diagram]: https://frida.re/docs/hacking/