From 59afdf4a5a30c58338986dae1a7db86529b304b0 Mon Sep 17 00:00:00 2001
From: Levon Kayan <noptrix@nullsecurity.net>
Date: Mon, 13 Apr 2020 17:10:54 +0200
Subject: [PATCH] add README.md and .gitignore.

---
 .gitignore | 22 ++++++++++++++++++++++
 README.md  | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 75 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..8a2b4d0
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,22 @@
+.bash_history
+build.sh
+clean.sh
+*.db
+.DS_Store
+.git
+id_dsa
+id_rsa
+*.key
+*.log
+*.o
+passwd
+*.pyc
+__pycache__
+shadow
+*.swn
+*.swo
+*.swp
+tags
+.vim.session
+.zhistory
+.zsh_history
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8ab376d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# Description
+
+A python tool which scans for HTTP servers and finds given strings in URIs.
+
+# Usage
+
+```
+$ httpgrep -H
+
+--==[ httpfindstr ]==--
+
+usage
+
+  httpfindstr -h <args> -s <arg> [opts] | <misc>
+
+opts
+
+  -h <hosts|file>   - single host or host-range/cidr-range or file containing
+                      hosts, e.g.: foobar.net, 192.168.0.1-192.168.0.254,
+                      192.168.0.0/24, /tmp/hosts.txt
+  -p <port>         - port to connect to (default: 80)
+  -t                - use TLS/SSL to connect to service
+  -u <URI>          - URI to search given strings in, e.g.: /foobar/, /foo.html
+                      (default /)
+  -s <string|file>  - a single string or multile strings in a file to find in
+                      given URIs, e.g. 'tomcat 8', '/tmp/igot0daysforthese.txt'
+  -b <bytes>        - num bytes to read from response. offset == response[0].
+                      (default: 64)
+  -x <threads>      - num threads for concurrent checks (default: 50)
+  -c <seconds>      - num seconds for socket timeout (default: 2.5)
+  -i                - use case-insensitive search
+  -v                - verbose mode (default: quiet)
+
+misc
+
+  -H                - print help
+  -V                - print version information
+```
+
+# Author
+
+noptrix
+
+# Notes
+
+- All of my public stuff you find are officially announced and published via [nullsecurity.net](https://www.nullsecurity.net).
+
+# Disclaimer
+
+We hereby emphasize, that the hacking related stuff found on
+[nullsecurity.net](http://nullsecurity.net) are only for education purposes.
+We are not responsible for any damages. You are responsible for your own
+actions.