Skip to content
/ knock Public

A simple port knocker. Given a host, looks up its port sequence and knocks on it.

License

Notifications You must be signed in to change notification settings

jahed/knock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NAME
  knock - a simple port knocker

SYNOPSIS
  ./knock <host>

DESCRIPTION
  Given a host, looks up its port sequence and knocks on it.

  Version:   v2.2.1
  Homepage:  https://github.com/jahed/knock
  Donate:    https://jahed.dev/donate

OPTIONS
  <host>
    Target host. Where you want to knock. Must exist in config file.

  -c, --config <config>
    Config file location. Defaults to ~/.config/knock/hosts.json.

  -h, --help
    Prints this help message.

  --version
    Prints the version.

CONFIG
  The config file must have the following structure:

  {
    "example.com": ["1000", "2000", "3000"]
  }

  Such that executing:

    ./knock --config ./knock.json example.com

  Will knock on example.com at ports 1000 then 2000 then 3000.

DEPENDENCIES
  Required
    ncat    https://nmap.org/ncat/
    Bash    https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29

COPYRIGHT
  Copyright (C) 2022 Jahed Ahmed

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as published by
  the Free Software Foundation, either version 3 of the License, or any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <https://www.gnu.org/licenses/>.