SvcScan

Network service scanner application written in C++.

---

Overview

SvcScan is a port scanner that uses TCP network sockets to perform targeted service scanning (C++ 20).

Features

• Multithreaded port scanning
• TCP socket banner grabbing
• SSL/TLS encrypted communications
• HTTP/HTTPS server probing
• Concurrent network connections
• Plain text and JSON scan reports

---

Basic Usage

There are two acceptable usage formats available to pass command-line arguments to the application.

Primary Usage Format

svcscan.exe [OPTIONS] TARGET

Secondary Usage Format

svcscan.exe [OPTIONS] TARGET PORT

---

Available Arguments

All available SvcScan arguments are listed in the following table:

Argument	Type	Description	Default
TARGET	Required	Target address or host name	N/A
-p/--port PORT	Required	Target ports (comma delimited)	N/A
-v, --verbose	Optional	Enable verbose console output	False
-s, --ssl	Optional	Enable SSL/TLS communications	False
-j, --json	Optional	Output the scan results as JSON	False
-o/--output PATH	Optional	Write the scan results to a file	N/A
-t/--timeout MS	Optional	Connection timeout in milliseconds	3500
-T/--threads NUM	Optional	Scanner thread pool thread count	Local thread count
-c/--curl URI	Optional	Send HTTP request and view response	/
-h/-?, --help	Optional	Display the help menu and exit	False

See the usage examples section for more information.

---

Download Options

Automatic Setup (Recommended)

To automatically install and setup SvcScan, use the setup.ps1 PowerShell installer script.

To install SvcScan without first downloading the repository, execute the following code snippet in an administrator PowerShell console to download and execute the setup.ps1 installer:

$Uri = "https://raw.githubusercontent.com/vandavey/SvcScan/main/setup.ps1"
Write-Output (Invoke-WebRequest $Uri -DisableKeepAlive).Content | powershell.exe -

Manual Setup

The entire SvcScan source code repository can be downloaded here.

To download a precompiled standalone executable, select one of the following options:

• Windows-x64
• Windows-x86

---

Usage Examples

Basic Examples

Scan port 80 against localhost:

svcscan.exe -p 80 localhost

Scan ports 22 through 25 against joe-mama:

svcscan.exe joe-mama 22-25

Advanced Examples

Scan ports 443 and 6667 against 192.168.1.1 using an SSL/TLS capable scanner and display verbose scan output:

svcscan.exe -vsp 443,6667 192.168.1.1

Scan ports 80, 443, and 20 through 40 against localhost using a thread pool with 8 threads and set the connection timeout to 4000 milliseconds:

svcscan.exe -t 4000 -T 8 -p 80,443,20-40 localhost

Scan ports 6667 and 6697 against 192.168.1.100 with verbose output displayed and save a JSON scan report to file path svcscan-test.json:

svcscan.exe -vjo svcscan-test.json 192.168.1.100 6667,6697

Send an HTTP or HTTPS GET request to port 80 on 10.0.0.1 to retrieve the contents of resource /admin:

svcscan.exe --ssl --verbose --curl /admin 10.0.0.1 80

The raw HTTP/HTTPS response will be written to the standard output stream if successful.

---

Dependencies

To run the prebuilt application executable, no dependencies are required.

To compile this application, the following Boost C++ libraries and their dependencies must be installed through vcpkg:

• Boost.Algorithm

  Library for various general purpose algorithms.

• Boost.Asio

  Library for networking and other low level I/O functionality.

• Boost.Beast

  Library for HTTP, WebSocket, and networking functionality.

• Boost.Bind

  Library for generating forwarding call wrappers.

• Boost.JSON

  Library for JSON parsing, serialization, and DOM.

---

Remarks

• This application only supports Windows operating systems.
• Please use discretion as this application is still in development.

---

Copyright & Licensing

The SvcScan application source code is available here and licensed under the MIT license.