/LANsCanner

SKY-SEC_LAN_Scanner fork written in C language

Primary LanguageCGNU General Public License v3.0GPL-3.0

SKY-SEC LAN Scanner

by SKY-SEC Cyber Security Team

ForTheBadge made-with-c ForTheBadge built-with-love
ForTheBadge built-by-developers

Table of Contents
  1. About The Project
  2. Usage
  3. References
  4. Contact
  5. To Know More About Us

About The Project

SKY-SEC LAN Scanner is a lightweight and efficient tool designed in C language to identify the IP (Internet Protocol) address and MAC (Media Access Control) addresses of active devices on a network using ARP (Address Resolution Protocol). This project has been developed to provide insights into how ARP-based network tools work while providing a user-friendly interface for network scanning.

(back to top)

What is the purpose?

This tool serves as:

  • A practical example of how ARP-based tools operate under the hood.
  • A network analysis tool for discovering active IP addresses and their associated MAC addresses in a given range.
  • A way to facilitate learning and experimentation with low-level network programming in C.

Usage

How can I run this tool?

Prerequisites:

  • Linux system (the tool uses Linux-specific APIs).
  • Root privileges (required for raw socket operations).
  • C compiler (e.g., gcc).

Steps:

  1. Clone the repository:

    git clone https://github.com/skylab-kulubu/LANsCanner.git  
    cd LANsCanner  
  2. Compile the source code:

    gcc -o LAN_Scanner LANsCanner.c  
  3. Run the tool with the required parameters:

    sudo ./LAN_Scanner <INTERFACE> <START_IP> <END_IP>  

    Parameters:

    • <INTERFACE>: The network interface to use (e.g., eth0, wlan0).
    • <START_IP>: Starting IP address for the scan (e.g., 192.168.1.1).
    • <END_IP>: Ending IP address for the scan (e.g., 192.168.1.255).

    Example:

    sudo ./Lan_Scanner wlan0 192.168.1.1 192.168.1.10  

(back to top)

Examples with Photos

tool_running

The scanner outputs active IP addresses and their corresponding MAC addresses in real time.

(back to top)

References

ARP Request and Reply Using C Socket Programming

(back to top)

Contact

GitHub LinkedIn

GitHub LinkedIn

(back to top)

To Know More About Our Student Branch