From 30e6e2365a11a25375f50aad4072f6e4a9b68d4c Mon Sep 17 00:00:00 2001
From: Robert Jeutter <robert.jeutter@gmx.de>
Date: Wed, 12 Jan 2022 20:23:55 +0100
Subject: [PATCH] add whois

---
 README.md      |  2 +-
 tools/whois.md | 24 ++++++++++++++++++++++++
 2 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 tools/whois.md

diff --git a/README.md b/README.md
index d231653..14c3e45 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@ Hint: code snippets which are in `<...>` should be replaced by own variables
     - [ ] bluesnarfer
     - [ ] btscanner
     - [ ] traceroute
-    - [ ] whois
+    - [x] whois
   - Sniffing/Pawning
     - [x] [Bettercap](tools/bettercap.md)
     - [x] [Kismet](tools/kismet.md)
diff --git a/tools/whois.md b/tools/whois.md
new file mode 100644
index 0000000..7ef29da
--- /dev/null
+++ b/tools/whois.md
@@ -0,0 +1,24 @@
+# Whois
+This package provides a commandline client for the WHOIS (RFC 3912) protocol, which queries online servers for information such as contact details for domains and IP address assignments. It can intelligently select the appropriate WHOIS server for most queries.
+
+The package also contains `mkpasswd`, a features-rich front end to the password encryption function crypt(3).
+
+To install: `sudo apt install whois`
+
+## whois 
+Client for the whois directory service
+```bash
+# show help page
+whois --help
+# Usage: whois [OPTION]... OBJECT...
+whois google.com
+```
+
+## mkpasswd
+Overfeatured front end to crypt(3)
+```bash
+# show help page
+mkpasswd -h
+# Usage: mkpasswd [OPTIONS]... [PASSWORD [SALT]]
+mkpasswd -S secretsalt -R 12 -P superstrongpassword1234
+```
\ No newline at end of file