Update docs

Author: tg

README.md

@@ -91,10 +91,10 @@ The modules packaged with the utility are listed in the table below.
 | Module    | Description                                                                   |
 | --------- | ----------------------------------------------------------------------------- |
 | `c2-dns`  | Generates a list of current C2 destinations and performs DNS requests to each |
-| `c2-ip`   | Connects to 10 random current C2 IP:port pairs to simulate egress sessions    |
+| `c2-ip`   | Connects to random current C2 IP:port pairs to simulate egress sessions       |
 | `dga`     | Simulates DGA traffic using random labels and top-level domains               |
 | `hijack`  | Tests for DNS hijacking support via ns1.sandbox.alphasoc.xyz                  |
-| `scan`    | Performs a port scan of 10 random RFC 1918 addresses using common ports       |
-| `sink`    | Connects to 10 random sinkholed destinations run by security providers        |
+| `scan`    | Performs a port scan to random RFC 5737 addresses using common ports          |
+| `sink`    | Connects to random sinkholed destinations run by security providers           |
 | `spambot` | Resolves and connects to random Internet SMTP servers to simulate a spam bot  |
 | `tunnel`  | Generates DNS tunneling requests to \*.sandbox.alphasoc.xyz                   |

simulator/scan.go

@@ -10,7 +10,7 @@ import (
 var (
 	scanPorts = []int{21, 22, 23, 25, 80, 88, 111, 135, 139, 143, 389, 443, 445, 1433, 1521, 3306, 3389, 5432, 5900, 6000, 8443}
 
-	// IP ranges are for TEST-NET-[123] networks, as per RFC5737.
+	// IP ranges are for TEST-NET-[123] networks, as per RFC 5737.
 	// These IPs should be safe to scan as they're not assigned.
 	scanIPRanges = []*net.IPNet{
 		{
@@ -72,7 +72,7 @@ func (*PortScan) Simulate(ctx context.Context, extIP net.IP, host string) error
 	return nil
 }
 
-// Hosts returns host:port generated from RFC 1918 addresses.
+// Hosts returns host:port generated from RFC 5737 addresses.
 func (s *PortScan) Hosts(size int) ([]string, error) {
 	var hosts []string
 

simulator/spambot.go

@@ -59,12 +59,12 @@ var domains = []string{
 // Spambot simulator.
 type Spambot struct{}
 
-// NewSpambot creates port scan simulator.
+// NewSpambot creates a Spambot simulator.
 func NewSpambot() *Spambot {
 	return &Spambot{}
 }
 
-// Simulate port scanning for given host.
+// Simulate connects to SMTP server provided in host.
 func (*Spambot) Simulate(ctx context.Context, extIP net.IP, host string) error {
 	d := &net.Dialer{
 		LocalAddr: &net.TCPAddr{IP: extIP},
@@ -78,7 +78,7 @@ func (*Spambot) Simulate(ctx context.Context, extIP net.IP, host string) error {
 	return nil
 }
 
-// Hosts returns host:port generated from RFC 1918 addresses.
+// Hosts returns random SMTP servers.
 func (s *Spambot) Hosts(size int) ([]string, error) {
 	var (
 		hosts []string