killeroo/powerping

Advanced command-line ping tool

PowerPing - Advanced Windows Ping

Small improved command line ICMP ping program.

Downloads

Stable releases can be downloaded [here]

Features

• Basic ping functionality
• Coloured output
• Display options
• ICMP packet customisation
• Scanning
• Flooding
• ICMP packet capture (/listen)
• IP location lookup
• Whois lookup
• Graphing

Future features:

• Traceroute
• Tunnelling
• IPv6/ICMPv6

Arguments:

Ping Options:
    --infinite      [--t]            Ping the target until stopped (Ctrl-C to stop)
    --ipv4          [--4]            Force using IPv4
    --random        [--rng]          Generates random ICMP message
    --dontfrag      [--df]           Set 'Don't Fragment' flag
    --buffer        [--rb]  number   Sets recieve buffer size (default is 5096)
    --beep          [--b]   number   Beep on timeout (1) or on reply (2)
    --count         [--c]   number   Number of pings to send
    --timeout       [--w]   number   Time to wait for reply (in milliseconds)
    --ttl           [--i]   number   Time To Live for packet
    --interval      [--in]  number   Interval between each ping (in milliseconds)
    --type          [--pt]  number   Use custom ICMP type
    --code          [--pc]  number   Use custom ICMP code value
    --size          [--s]   number   Set size (in bytes) of packet (overwrites packet message)
    --message       [--m]   message  Ping packet message
    --timing        [--ti]  timing   Timing levels:
                                        0 - Paranoid    4 - Nimble
                                        1 - Sneaky      5 - Speedy
                                        2 - Quiet       6 - Insane
                                        3 - Polite      7 - Random

Display Options:
    --shorthand     [--sh]           Show less detailed replies
    --displaymsg    [--dm]           Display ICMP message contents
    --timestamp     [--ts]           Display timestamps (add 'UTC' for Coordinated Universal Time)
    --fulltimestamp [--fts]          Display full timestamps with localised date and time
    --nocolor       [--nc]           No colour
    --symbols       [--sym]          Renders replies and timeouts as ASCII symbols (add '1' for alt theme)
    --requests      [--r]            Show request packets
    --notimeouts    [--nt]           Don't display timeout messages
    --quiet         [--q]            No output (only affects normal ping)
    --resolve       [--res]          Resolve hostname of response address from DNS
    --inputaddr     [--ia]           Show input address instead of revolved one
    --checksum      [--chk]          Display checksum of packet
    --requireinput  [--ri]           Always ask for user input upon completion 
    --limit         [--l]   number   Limits output to just replies (1), requests (2) or summary(3)
    --decimals      [--dp]  number   Num of decimal places to use (0 to 3)

Modes:
    --scan          [--sc]  address  Network scanning, specify range "127.0.0.1-55"
                                     (listen command without address will listen on all local network adapters)
    --flood         [--fl]  address  Send high volume of pings to address
    --graph         [--g]   address  Graph view
    --location      [--loc] address  Location info for an address
    --listen        [--li]  address  Listen for ICMP packets on an address
    --listen        [--li]           Listen for ICMP packets on all local network adapters
    --whois                 address  Whois lookup for an address
    --whoami                         Location info for current host

Others:
    --log           [--f]   path     Logs the ping output to a file 
    --help          [--?]            Displays this help message
    --version       [--v]            Shows version and build information

Example usage:

 powerping 8.8.8.8                    -     Send ping to google DNS with default values (3000ms timeout, 5 pings)
 powerping github.com --w 500 --t     -     Send pings indefinitely to github.com with a 500ms timeout     
 powerping --w 500 --t github.com     -     Address can also be specified at the end
 
 powerping 127.0.0.1 --m Meow         -     Send ping with packet message "Meow" to loopback address
 powerping 127.0.0.1 --pt 3 --pc 2    -     Send ping with ICMP type 3 (dest unreachable) and code 2
 
 powerping 8.8.8.8 /c 5 -w 500 --sh   -     Different argument switches (/, - or --) can be used in any combination
 powerping google.com /ti Paranoid    -     Sends using the 'Paranoid' timing option
 powerping google.com /ti 1           -     Same as above

License

License under the MIT License:

Copyright (c) 2024 Matthew Carney [email protected]

Note:

Requires Elevated Rights (Administrator) to Run (more info here)

Screenshots

powerping's Issues

Catch IO and General Exceptions while waiting for a ICMP reply

Scan and Loc arguments arent working

Port PowerPing to other platforms

• Restructure project for dotnet and .net4.5 builds
• Create Bash build script for building project with .netcore
• Create Bash build script for building project with mono
• Batch script for building standard windows binary
• Travis CI yml script for .netcore and mono (couple of versions of each) (could use previous build script)
• Add platform/build info to version text (also remove build date)
• Make sure file versions persist with .net core builds
• Installers for each build platform

Startup mischecks for inputted address

if (attributes.Address != "") throw new FormatException();
Is a false positive check, should be:
if (attributes.Address == "") throw new FormatException();

Add general dns address resolution to location lookup

Fix Control C event handler

Event C handler currently not working properly, works with delay/lag

Responsiveness tested in:

• Sending Normally (requires more testing)
• Graph
• Flood (requires more testing)
• Scan

Build for lower .net version

or for client profile

Add more screenshots

Add more screenshots to repository and readme.md

<1ms time being displayed after Timout

Seems to only occur after a timeout has occured and seems to stop after another timeout has occured, could be an error with timer or display function

Add Icon

Add scan option

Fix loc reverse logic in program.cs

Add graph

Add args loop

Add basic tests

• http://www.c-sharpcorner.com/UploadFile/7ca517/unit-test-with-console-application/

• https://msdn.microsoft.com/en-us/library/ms182532.aspx

• https://www.codeproject.com/Articles/17652/How-to-Test-Console-Applications

• Arguments testing

• Basic functionality testing

Update help message from readme

Clean up scan

Check input and proper address finding in program.cs
Add to readme and help

Make sure correct address type is returned on DNS lookup

Make sure address returned from lookup is correct IP version.
Currently crashes when returned address is IPv6 (tries to send IPv4)
Check look up code in ping add sanity check

Look into TravisCI support

Complete Scan and Flood multithread implementation

Add tunneling

Background: https://en.wikipedia.org/wiki/ICMP_tunnel
UI: https://stackoverflow.com/a/7464499
Encryption: https://stackoverflow.com/a/10177020
https://www.codeproject.com/Articles/14150/Encrypt-and-Decrypt-Data-with-C

Different tunnel features:

• Simple UDP or TCP over ICMP
• Stagnography and packet spam while tunneling
• Simple messaging app

Add IPv6 support

Can maybe be done by changing port type depending on IP Version ping property (that would need to be added)

Add no input to location lookup commands

Add option to change packet size

Add option to show location of address while pinging

Get location once at start of ping sequence and go from there

Add PingStatus enum to PingResults

Also display number of error ICMPs to results (look at .net implementation)

Top of columns persisting in graph view

Top of columns of a specific size (over about 500ms) are persistently being drawn on screen, is either due to:

• Inadequate height being used in Graph.Clear()
• Column arrays not being set properly in Graph.CreateColumn

Add option to toggle colour

Quicker DNS resolve method?

https://stackoverflow.com/questions/38987309/c-how-to-set-dns-resolve-timeout

Add argument to send ICMP with a supplied type

Add icmp_seq info to timeout

for example

request timed out for icmp_seq=3

Display statistics closes when invoked with control-c

Changes for safe cross platform code

• Remove path specific characters ('/', '')
• Start using Enviroment.NewLine instead of \n

Add version command

Change over license from Apache to MIT

In program.cs

Invalid arguments being accepted

Stop this from being accepted

Return console cursor position to under graph on control c

Add argument to add shorthand time stamp

Display time stamp along with reply Eg 13:45:00

Add multithread support

Extend ping.cs with IDisposable

Application crashes when ping is running and pc goes to to sleep

SocketException thrown due to buffer overload?
Solution could be to move socket.sendto into try catch (check if this cause any adverse effects) maybe by changing:

Ping.cs

// Send ping request
timer.Start();
sock.SendTo(packet.getBytes(), packetSize, SocketFlags.None, iep);
sent++;

try
{
	// Try recieve ping response
	byte[] buffer = new byte[1024];
	recv = sock.ReceiveFrom(buffer, ref ep);
	timer.Stop();

	// Display reply packet
	ICMP response = new ICMP(buffer, recv);
	displayReplyPacket(response, ep, index);
	recieved++;

}

To:

try
{
	// Send ping request
	timer.Start();
	sock.SendTo(packet.getBytes(), packetSize, SocketFlags.None, iep);
	sent++;

	// Try recieve ping response
	byte[] buffer = new byte[1024];
	recv = sock.ReceiveFrom(buffer, ref ep);
	timer.Stop();

	// Display reply packet
	ICMP response = new ICMP(buffer, recv);
	displayReplyPacket(response, ep, index);
	recieved++;

}

Add --location and --whoami argument to help message

make sure ping isn't sent if either arguments are used

Add traceroute function

Add source address option

How to

            SetSocketOption(SocketOptionLevel.Udp, SocketOptionName.NoChecksum, 1);
            sock.Bind((EndPoint)new IPEndPoint(attrs.Source, 0));

Improve statistics

• Display stats while ping is running by pressing a key
• Add more stats
• Make sure percentage lost is working

Switch to using Async for sending and recieving packets

• Should implement async callbacks: https://docs.microsoft.com/en-us/dotnet/api/system.net.sockets.socket.beginreceive?view=netframework-4.7.2
• Refactor sendICMP

Add .NET core support

Add time to live (TTL) argument

Add support for Colorful.Console

Avoid blocking addresses containing '-'s