# pypanda-plugins

**Repository Path**: lzz_gitee/pypanda-plugins

## Basic Information

- **Project Name**: pypanda-plugins
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-13
- **Last Updated**: 2025-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

PyPANDA Plugins
====

Standalone Python plugins for [PANDA](https://github.com/panda-re/panda)'s Python Interface.

They are separated into two directories:

* src/pyplugins - PyPlugins
* scripts - libraries and scripts designed for use with standalone pypanda scripts

## Install
Optional Virtualenv Setup
```sh
python3 -m venv venv
. venv/bin/activate
```

Install PANDA from source and build (not shown), then install PyPanda (with `develop` or `install`)
```ssh
cd panda/panda/python/core/pandare
python setup.py develop
```

Install this PyPlugins package (with `develop` or `install`)
```py
cd panda-pyplugins/
python setup.py develop
```

## Plugins

### Basic Block Count (bb_count.py)

A plugin that provides a live-updating basic block count.

Webpage url: https://localhost:8080/BasicBlockCount

### Live Process Graph (proc_graph.py)

A plugin that provides a live-updating process graph.

Webpage url: https://localhost:8080/LiveProcGraph

![Process Graph](https://raw.githubusercontent.com/lacraig2/panda_webserver_process_graph/master/images/example.png)

## Scripts

### FileHook
When the guest attempts to access a file, silently redirect the access to another file.

```py
hook = FileHook(panda)
hook.rename_file("/does_not_exist", "/etc/issue")
```

### FileFaker
** Currently broken **
When the guest attempts to read from a file which may or may not exist, provide fake contents.
```py
fake = FileFaker(panda)
faker.replace_file("/does_not_exist", FakeFile("Hello World")
```

### IoctlFaker
When the guest issues an IOCTL that returns `-ENOTTY` (i.e., no driver has registered this IOCTL), silence the error.

```py
iofaker = IoctlFaker(panda)
panda.run()

print(iofaker.get_forced_returns())
```

### ModeFilter
Class of decorators to simplify state machines in PyPANDA scripts.

### ProcWriteCapture
Whenever a guest process writes data, record it to the host disk.

```py
ProcWriteCapture(panda)
panda.run()
# Local files will be created when guest programs write output
```

Status
====
These plugins are unversioned.