Skip to content

Latest commit

 

History

History
112 lines (74 loc) · 4.02 KB

README.md

File metadata and controls

112 lines (74 loc) · 4.02 KB
Raw

ps.sh

Made with Bash Maintenance open issues closed issues license

ps.sh is a bash script that automates the process of service discovery on specified target hosts. The aim of the scripts is reducing scan time, increasing scan efficiency and automating the workflow.

Resource

Features

  • Automated port scanning using various workflows:
    • nmap2nmap: Use Nmap for both port discovery and service discovery.
    • naabu2nmap: Use Naabu for port discovery, followed by Nmap for service discovery.
    • masscan2nmap: Use Masscan for port discovery, followed by Nmap for service discovery.
  • Service discovery to identify open services on the detected ports.
  • Multiple target support - Scan a single target or a list of targets.
  • Script auto-update support to keep the script and its dependencies up-to-date.

Installation

To install ps.sh:

  • ... with curl:

     bash -c "$(curl -fsSL https://raw.githubusercontent.com/enenumxela/ps.sh/main/ps.sh)" -- --setup-script

  • ...with wget:

     bash -c "$(wget -qO- https://raw.githubusercontent.com/enenumxela/ps.sh/main/ps.sh)" -- --setup-script

Usage

To display this script's help message, use the -h flag:

ps.sh -h

Here's what the help message looks like:


                                          _
                          _ __  ___   ___| |__
                         | '_ \/ __| / __| '_ \
                         | |_) \__  _\__ \ | | |
                         | .__/|___(_)___/_| |_|
                         |_|              v1.0.0

              ---====| A Service Discovery Script |====---
                      ---====| with <3... |====---
               ---====| ...by Alex (@enenumxela) |====---

USAGE:
  ps.sh [OPTIONS]

OPTIONS:

 INPUT:
  -t, --target 				target IP
  -l, --list 				target IPs list file

 WORKFLOW:
  -w, --workflow 			discovery workflow (default: nmap2nmap)
      --workflows 			list supported workflows

 OUPUT:
  -k, --keep 				keep each workflow's step results
  -O, --output-directory 		output directory path (default: $PWD)

 SETUP:
      --setup-script 			setup ps.sh (install|update)
      --setup-dependencies 		setup ps.sh dependencies

 HELP:
  -h, --help 				display this help message

Contributing

We welcome contributions! Feel free to submit Pull Requests or report Issues. For more details, check out the contribution guidelines.

Licensing

This utility is licensed under the MIT license. You are free to use, modify, and distribute it, as long as you follow the terms of the license. You can find the full license text in the repository - Full MIT license text.

Credits

Contributors

A huge thanks to all the contributors who have helped make ps.sh what it is today!

contributors

Dependencies

masscan ◇ naabu ◇ nmap