2023-11-23 08:08:28 +00:00
# PTR Stream
2024-12-06 22:41:03 +00:00
PTR Stream is a high-performance reverse DNS *(PTR record)* lookup tool written in Go. It efficiently processes the entire IPv4 address space, performing concurrent DNS lookups with support for custom DNS servers, output logging, and real-time progress visualization.
2023-11-23 09:09:36 +00:00
2024-12-06 22:41:03 +00:00
## Installation
2023-11-23 09:09:36 +00:00
```bash
2024-12-06 22:41:03 +00:00
go install github.com/acidvegas/ptrstream@latest
2023-11-23 09:09:36 +00:00
```
2024-12-06 22:41:03 +00:00
Or, build from source:
```bash
git clone https://github.com/acidvegas/ptrstream
cd ptrstream
go build
```
2023-11-23 10:09:11 +00:00
2024-12-06 22:41:03 +00:00
## Usage
2023-12-02 00:41:51 +00:00
2024-12-06 22:41:03 +00:00
```bash
ptrstream [options]
```
2023-12-02 00:41:51 +00:00
2024-12-06 22:41:03 +00:00
###### Command Line Arguments
| Flag | Description | Default | Example |
|---------|--------------------------------------|---------|------------------------|
| `-c` | Concurrency level | `100` | `-c 200` |
| `-t` | Timeout for DNS queries | `2s` | `-t 5s` |
| `-r` | Number of retries for failed lookups | `2` | `-r 3` |
| `-dns` | File containing DNS servers | | `-dns nameservers.txt` |
| `-debug` | Show unsuccessful lookups | `False` | `-debug` |
| `-o` | Path to NDJSON output file | | `-o results.json` |
| `-s` | Seed for IP generation | Random | `-s 12345` |
| `-shard` | Shard specification | | `-shard 1/4` |
---
###### Mirrors: [acid.vegas](https://git.acid.vegas/ptrstream) • [SuperNETs](https://git.supernets.org/acidvegas/ptrstream) • [GitHub](https://github.com/acidvegas/ptrstream) • [GitLab](https://gitlab.com/acidvegas/ptrstream) • [Codeberg](https://codeberg.org/acidvegas/ptrstream)
