Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

a port scanner written in x86 assembly

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 Makefile
Octocat-spinner-32 README
Octocat-spinner-32 asmscan.asm
README
asmscan
Author: Eugene Ma

==========[ 0x0 Introduction ]

        asmscan is a port scanner written entirely in 32-bit x86 assembly, with
both TCP and SYN scanning capabilities. It uses Linux system calls to interface
with the network stack, which makes the code unportable across platforms, but
keeps it completely libc free.

==========[ 0x1 Features ]

- libc free
- compact binary size
- network optimized speed 

==========[ 0x2 Installation ]

You will need nasm.


$ cat Makefile 
asmscan: asmscan.o
	ld -s -o asmscan asmscan.o
asmscan.o: asmscan.asm
	nasm -f elf -o asmscan.o asmscan.asm

==========[ 0x3 Usage ]

$ ./asmscan
Usage: asmscan <target ip>

==========[ 0x4 Operation ]

asmscan implements two modes of operation. 

1. If run by a normal user, asmscan will perform a TCP scan, and attempt to
connect with ports 0-1023.

2. If run with root permissions, asmscan will perform a SYN scan, sending
custom crafted TCP SYN packets to the target host and listening for replies. It
will first send an ICMP ping to calculate the shortest time to wait for replies
from the host.

In both modes, asmscan scans ports in parallel instead of serially. This gives
it speeds that are comparable to those of nmap.

==========[ 0x5 Todo ]

- Allow user to specify a range of ports
- Allow user to specify a range of IP's
- Greater granularity of port state: notify the user if a port is open, closed,
  filtered, or possibly something else.
- Make the binary even smaller
Something went wrong with that request. Please try again.