From ec3adb99dc0737af898466891cc89363d9ed1cd3 Mon Sep 17 00:00:00 2001
From: Jorge Matricali <jorgematricali@gmail.com>
Date: Tue, 6 Jun 2017 00:49:07 -0300
Subject: [PATCH] + Update README.md + Shields + Examples usages

---
 README.md | 49 ++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 48 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 59079f3..c611322 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
+[![license](https://img.shields.io/github/license/jorge-matricali/brutekrag.svg)](https://jorge-matricali.mit-license.org/2014-2017) [![GitHub contributors](https://img.shields.io/github/contributors/jorge-matricali/brutekrag.svg)](https://github.com/jorge-matricali/brutekrag/graphs/contributors)
+[![PyPI](https://img.shields.io/pypi/dm/brutekrag.svg)](https://pypi.python.org/pypi/brutekrag)
+
 # brutekrag
 SSH brute force using dictionary attack. Written in _Python_.
 _brute krag_ means "brute force" in afrikáans
@@ -18,5 +21,49 @@ pip install brutekrag
 ```
 Then you can do
 ```bash
-brutekrag --help
+$ brutekrag --help
+
+usage: brutekrag [-h] [-t TARGET] [-T TARGETS] [-pF PASSWORDS] [-uF USERS]
+                 [-sF SINGLE] [--separator SEPARATOR] [-p PORT] [-u USER]
+                 [-P PASSWORD] [--timeout TIMEOUT]
+
+      _                _       _
+     | |              | |     | |
+     | |__  _ __ _   _| |_ ___| | ___ __ __ _  __ _
+     | '_ \| '__| | | | __/ _ \ |/ / '__/ _` |/ _` |
+     | |_) | |  | |_| | ||  __/   <| | | (_| | (_| |
+     |_.__/|_|   \__,_|\__\___|_|\_\_|  \__,_|\__, |
+            OpenSSH Brute forcer tool 0.2.0    __/ |
+          (c) Copyright 2014 Jorge Matricali  |___/
+
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -t TARGET, --target TARGET
+                        Target hostname or IPv4.
+  -T TARGETS, --targets TARGETS
+                        Targets file that containas one hostname or IPv4 per line.
+  -pF PASSWORDS, --passwords PASSWORDS
+                        Path to password dictionary file. One password per line.
+  -uF USERS, --users USERS
+                        Path to users list file. One user per line.
+  -sF SINGLE, --single SINGLE
+                        Path to a file that contains a combination of both username and password. One combination per line, separated by space character by default.
+  --separator SEPARATOR
+                        Custom username/password separator. It's should be used in conjunction with -sF.
+  -p PORT, --port PORT  Target port (default 22).
+  -u USER, --user USER  Single user bruteforce.
+  -P PASSWORD, --password PASSWORD
+                        Single password bruteforce.
+  --timeout TIMEOUT     Connection timeout (in seconds, 1 default).
+```
+
+## Example usages
+```bash
+# One target, one user, many passwords
+brutekrag -t 10.10.0.14 --user root --passwords passwords.txt
+# Many targets, one user, empty password
+brutekrag -T targets.txt --user root --password ''
+# One target, many pre-made combinations of user and password
+brutekrag -t 192.168.0.1 --single combined.txt
 ```