Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
rafael-santiago committed Aug 21, 2023
1 parent ea8c2dd commit 444eb2b
Show file tree
Hide file tree
Showing 5 changed files with 53 additions and 7 deletions.
60 changes: 53 additions & 7 deletions doc/MANUAL.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
- [The dnsspoof command](#the-dnsspoof-command)
- [The xablau command](#the-xablau-command)
- [The caleaboqui command](#the-caleaboqui-command)
- [Catsparrow's ``macgonuts`` commands cheat sheet](#catsparrows-macgonuts-commands-cheat-sheet)

## What does ``macgonuts`` is for?

Expand Down Expand Up @@ -46,7 +47,9 @@ many thanks in advance! :satisfied:

### The spoof command

>Maybe the ``spoof`` command is the command what you arrived here for. With ``spoof`` command you can deceive
><img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/angry-hiss.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="70" />
Maybe the ``spoof`` command is the command what you arrived here for. With ``spoof`` command you can deceive
a host by making it thinks that you are the droid that it was looking for...

If you run:
Expand Down Expand Up @@ -153,7 +156,9 @@ Congrats! Now you are a ``macgonuts spoofing`` master!

### The eavesdrop command

>If you are wanting to do some active sniffing between two points this is the ``macgonuts`` command that you are
><img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/angry-hiss.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="70" />
If you are wanting to do some active sniffing between two points this is the ``macgonuts`` command that you are
looking for...

With ``eavesdrop`` command you are able to simply watch the network traffic or log it to later inspection. You can
Expand Down Expand Up @@ -237,7 +242,9 @@ Congrats again! Welcome to the paradise, now you are a ``macgonuts eavesdrop`` m

### The isolate command

>With the isolate command it is possible to make a specific host an island. Any contact done from anyone in the
><img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/angry-hiss.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="70" />
With the isolate command it is possible to make a specific host an island. Any contact done from anyone in the
local network will be "cut off" by letting that target alone.

If you ask the quick help of the isolate command you will get the following:
Expand Down Expand Up @@ -299,7 +306,9 @@ Congrats! Now you are a ``macgonuts`` troll master by knowing every single thing

### The mayhem command

>If you are only seeking to annoy a network as whole, maybe the mayhem command is the command for you.
><img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/angry-hiss.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="70" />
If you are only seeking to annoy a network as whole, maybe the mayhem command is the command for you.
With mayhem you are able to make `ARP/Neighbor` tables a total mess. As a result the host will be unable
to communicate each other or at least unable to communicate each other without unstability.

Expand Down Expand Up @@ -393,7 +402,9 @@ Congrats! Now you are a layer-2 disorder master by knowing every single detail a

### The dnsspoof command

> If you are finding a way of redirecting some host to another by making this host accept fake name resolutions, dnsspoof
><img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/angry-hiss.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="70" />
If you are finding a way of redirecting some host to another by making this host accept fake name resolutions, dnsspoof
is your command of choice...

Let's take a look at ``dnsspoof`` quick help:
Expand Down Expand Up @@ -539,7 +550,9 @@ proud of you ``Pinocchio``! You nasty busybody... Use it with care!

### The xablau command

>If you are looking around for possible targets to your offensive actions, maybe ``macgonuts`` features
><img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/angry-hiss.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="70" />
If you are looking around for possible targets to your offensive actions, maybe ``macgonuts`` features
one command to do it and, this command is...

<h1 align="center">X A B L A U !</h1>
Expand Down Expand Up @@ -642,7 +655,9 @@ Anyway, if jot down `xablau` is too much for you, you can try its well behaved a

### The caleaboqui command

> If there is someone in your network consuming all `Internet` bandwidth getting in the way your downloads... you can
><img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/angry-hiss.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="70" />
If there is someone in your network consuming all `Internet` bandwidth getting in the way your downloads... you can
drive away this noisy host from your gateway (wait... `_ modprobe -rf euphemism`) err... You can cut off its
`Internet` access and with it rip off all this bandwidth slice all to you :trollface:, :godmode:!

Expand Down Expand Up @@ -775,4 +790,35 @@ Well, `caleaboqui` was picked from a famous `redub` done by a `Brazilian` comedy
"caleaboqui" is a wrong form of "cale a boca" (said by people that talks bad portuguese, or even a slang form) it
does mean `shut up`. If `caleaboqui` is too much for you, I would suggest you `shh` :bowtie: :smirk:

Well, now you master anything about silence, congrats!

[``Back``](#topics)

## Catsparrow's ``macgonuts`` commands cheat sheet

<p align="center">
<img src="https://github.com/rafael-santiago/macgonuts/blob/update-doc/etc/catsparrow.gif" title="Grrrr! C4uTion is now logged in..."
alt="Grrrr! C4uTion is now logged in..." width="320" />
</p>

> "Fifteen men on the dead man's chest -<br>
...Yo-ho-ho, and a bottle of rum!<br>
But one man of her crew alive,<br>
What put to sea with seventy-five." -- Robert Louis Stevenson's (Treasure Island [1883])

Here goes the cheat sheet that can help novice buccaneers in the flying gang of exploit addressing resolution
on IP networks "Yo-ho-ho!" :rofl:

| **Situation** | **Best command to use** |
|:-------------:|:-------------------------:|
| I need to make a host thinks that I am another host, so I can manipulate this traffic somehow | `spoof` |
| I need to capture the session between two hosts into my `LAN` or segmented `LAN` | `eavesdrop` |
| I need to avoid n hosts talk to one | `isolate` |
| I need to spread disorder into my `LAN` by making it unstable | `mayhem` |
| I need to redirect a host to another host through a fake `FQDN` resolution | `dnsspoof` |
| I need to discover possible targets into my `LAN` | `xablau` (or its alias `neighscan`) |
| I need to avoid internet access from a single host or multiple hosts | `caleaboqui` (or its alias `shh`) |
| I need to know what `macgonuts` version I am running | `version` |
| I need some help | `help` |

[``Back``](#topics)
Binary file added etc/angry-hiss.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added etc/catsparrow.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Empty file modified etc/keep_calm_and_caleaboqui.jpg
100755 → 100644
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Empty file modified etc/pegasus_coin.png
100755 → 100644
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 444eb2b

Please sign in to comment.