Schlagwort-Archive: Linux

Wake On LAN

13. November 2017 DonMatteo Schreibe einen Kommentar

Wake on LAN (WOL) ist ein 1995 von AMD in Zusammenarbeit mit Hewlett-Packard veröffentlichter Standard, um ausgeschaltete Computer über die Netzwerkkarte zu starten, diese ACPI unterstützen. Allgemeine Voraussetzung für WOL ist, dass die Netzwerkkarte über den Standby-Strom des Netzteils weiterhin mit Strom versorgt wird, auch wenn der Computer ausgeschaltet ist.

Die Netzwerkkarte wartet auf ein so genanntes Magic Packet, bei dessen Empfang der Computer eingeschaltet wird. Das Datenpaket ist entweder direkt an die Netzwerkkarte adressiert oder wird als Broadcast verschickt. Es enthält sechsmal in Folge den hexadezimalen Wert FF; unmittelbar danach erscheint die ununterbrochene 16-malige Wiederholung der MAC-Adresse der Netzwerkkarte des jeweiligen Zielsystems.

GNU/Linux bietet ein CLI Command um ein Computer zu starten.


/usr/bin/wakeonlan -p 7 -i 10.199.3.19 00:11:22:33:44:55

1 2	/usr/bin/wakeonlan -p 7 -i 10.199.3.19 00:11:22:33:44:55

Ubuntu und Debian lässt Computer mit wakeonlan erwachen.


wakeonlan 00:00:33:44:55:66
Sending magic packet to 255.255.255.255:9 with 00:22:33:44:55:66

wakeonlan 00:00:33:44:55:66

Sending magic packet to 255.255.255.255:9 with 00:22:33:44:55:66

Synology hat mit synonet in der Busybox Shell sein eigenes Tool.


synonet --wake xx:xx:xx:xx:xx ethX

1 2	synonet --wake xx:xx:xx:xx:xx ethX

Fedora wiederum weckt mit ether-wake, auch CentOS und Red Hat.


sudo ether-wake -i eno1 00:11:22:33:44:55

1 2	sudo ether-wake -i eno1 00:11:22:33:44:55

wobei mit -i eno1 hier das Ethernet Interface gemeint ist.

Windows hat kein WOL Onboard, ein zuverlässiges WOL bietet hier WakeMeOnLan von Nirsoft.

Da auch Mac OSX standardmäßig mit Python kommt, kann man sich eines Scripts behelfen, die folgenden Zeilen ermöglicht ein Wake On LAN auf dem Mac.


#!/usr/bin/env python

import socket
import sys

if len(sys.argv) < 3:
    print "Usage: wake.py <IP> <MAC>   (example: 192.168.1.255 00:11:22:33:44:55)"
    sys.exit(1)

mac = sys.argv[2]
data = ''.join(['FF' * 6, mac.replace(':', '') * 16])
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
sock.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
sock.sendto(data.decode("hex"), (sys.argv[1], 9))

#!/usr/bin/env python

import socket

import sys

if len(sys.argv) < 3:

print "Usage: wake.py <IP> <MAC> (example: 192.168.1.255 00:11:22:33:44:55)"

sys.exit(1)

mac = sys.argv[2]

data = ''.join(['FF' * 6, mac.replace(':', '') * 16])

sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)

sock.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)

sock.sendto(data.decode("hex"), (sys.argv[1], 9))

Den Script speichern und aus dem OSX Terminal ausführen.


python wake.py 192.168.1.255 00:11:22:33:44:55

1 2	python wake.py 192.168.1.255 00:11:22:33:44:55

Linux

KVM Hypervisor auf CentOS7

12. November 2017 DonMatteo 2 Kommentare

KVM ist eine Open-Source Hardware Virtualisierungssoftware, mit dieser Linux-basierte und Windows-basierte virtuelle Maschinen gleichzeitig ausgeführt werden können. KVM wird als Kernel-basierte Virtuelle Maschine bezeichnet und ist eine alternative zu VMware ESXi und Xen, dabei wird durch die Installation des KVM-Pakets das KVM-Modul in den aktuellen Kernel geladen und aus einer Linux-Maschine ein Hypervisor gebildet.

In diesem Beitrag wird gezeigt, wie ein KVM Hypervisor auf CentOS 7.x und RHEL 7.x installiert wird, um danach virtuelle Maschinen zu installieren.

INSTALLATION

Bevor man mit der KVM-Installation fortfährt, überprüft man ob die CPU des Systems die Hardware-Virtualisierung unterstützt. Dazu folgendes Command ausführen in der root Shell


grep -E '(vmx|svm)' /proc/cpuinfo

1 2	grep -E '(vmx\|svm)' /proc/cpuinfo

Es sollte in der Ausgabe das Wort vmx oder svm erscheinen, ansonsten unterstützt die CPU keine Virtualisierung. Möglicherweise lohnt sich ein gang in das System BIOS um die VT-x Boot Einstellung zu aktivieren.

Die KVM-Pakete und die zugehörigen Module werden installiert.


yum install -y qemu-kvm qemu-img virt-manager libvirt libvirt-python libvirt-client virt-install virt-viewer bridge-utils

1 2	yum install -y qemu-kvm qemu-img virt-manager libvirt libvirt-python libvirt-client virt-install virt-viewer bridge-utils

Der KVM Service kann nun aktiviert und gestartet werden.


systemctl enable libvirtd
systemctl start libvirtd

systemctl enable libvirtd

systemctl start libvirtd

Wir überprüfen ob die KVM Module auch wirklich gestartet wurden.


lsmod | grep kvm
kvm_intel             162153  0
kvm                   525409  1 kvm_intel

lsmod | grep kvm

kvm_intel 162153 0

kvm 525409 1 kvm_intel

Falls eine Minimal CentOS 7 oder RHEL 7 Installation vorliegt, startet der virt-manager nicht, wir müssen also noch X-Window installieren.


yum install -y "@X Window System" xorg-x11-xauth xorg-x11-fonts-* xorg-x11-utils

1 2	yum install -y "@X Window System" xorg-x11-xauth xorg-x11-fonts-* xorg-x11-utils

Starte den Server neu und versuche dann, den virtual manager zu starten.


virt-manager

1 2	virt-manager

Bevor wir beginnen VMs zu deployen, erstellen wir zunächst ein Bridge Interface. Die Bridge-Schnittstelle ist erforderlich, wenn man zum Hypervisor von ausserhalb des Netzwerks auf virtuelle Maschinen zugreifen möchte. In unserem Beispiel heisst das Ethernet Interface ifcfg-eth0.


cd /etc/sysconfig/network-scripts/
cp ifcfg-eth0 ifcfg-br0

cd /etc/sysconfig/network-scripts/

cp ifcfg-eth0 ifcfg-br0

Bearbeite nun die Interface-Datei ifcfg-eth0 und trage folgendes ein:


vi ifcfg-eth0

TYPE=Ethernet
NM_CONTROLLED="no"
BOOTPROTO=static
DEVICE=eth0
ONBOOT=yes
BRIDGE=br0

vi ifcfg-eth0

TYPE=Ethernet

NM_CONTROLLED="no"

BOOTPROTO=static

DEVICE=eth0

ONBOOT=yes

BRIDGE=br0

Bearbeite die Bridge-Datei ifcfg-br0 und lege folgendes fest:


vi ifcfg-br0

TYPE=Bridge
NM_CONTROLLED="no"
BOOTPROTO=static
DEVICE=br0
ONBOOT=yes
IPADDR=192.168.91.40
NETMASK=255.255.255.0
GATEWAY=192.168.91.1
DNS1=192.168.91.50

vi ifcfg-br0

TYPE=Bridge

NM_CONTROLLED="no"

BOOTPROTO=static

DEVICE=br0

ONBOOT=yes

IPADDR=192.168.91.40

NETMASK=255.255.255.0

GATEWAY=192.168.91.1

DNS1=192.168.91.50

Starte den Netzwerkdienst neu um die Bridge zu aktivieren.


systemctl restart network

1 2	systemctl restart network

Überprüfe das Bridge Interface mit dem folgenden Befehl:


ip addr show br0

1 2	ip addr show br0

Wer es lieber den Network-Manager machen lässt, der kann das Bridge Interface wie folgt erzeugen:


nmcli c add type bridge autoconnect yes con-name br0 ifname br0
nmcli c modify br0 ipv4.addresses 192.168.91.40/24 ipv4.method manual
nmcli c modify br0 ipv4.gateway 192.168.91.1
nmcli c modify br0 ipv4.dns 192.168.91.50
nmcli c delete eth0
nmcli c add type bridge-slave autoconnect yes con-name eth0 ifname eth0 master br0
reboot
ip a

nmcli c add type bridge autoconnect yes con-name br0 ifname br0

nmcli c modify br0 ipv4.addresses 192.168.91.40/24 ipv4.method manual

nmcli c modify br0 ipv4.gateway 192.168.91.1

nmcli c modify br0 ipv4.dns 192.168.91.50

nmcli c delete eth0

nmcli c add type bridge-slave autoconnect yes con-name eth0 ifname eth0 master br0

reboot

ip a

Virtuelle Maschinen können nun entweder über die Befehlszeile mit dem Befehl virt-install oder über das GUI virt-manager erzeugt werden.

Im GUI gehe hierzu auf die Option Datei und klicke auf New virtual Maschine.

Die virtuelle Maschine wird nun mit Hilfe des Wizard erzeugt.

Virtuelle Maschinen aus der Befehlszeile erstellen:


virt-install --name=Ubuntu-16-04 --file=/var/lib/libvirt/images/ubuntu16-04.dsk --file-size=20 --nonsparse --graphics spice --vcpus=2 --ram=2048 --cdrom=ubuntu-16.04-server-amd64.iso --network bridge=br0 --os-type=linux --os-variant=generic
Starting install...
Allocating 'ubuntu16-04.dsk'               | 20 GB 00:00:00
Creating domain...

virt-install --name=Ubuntu-16-04 --file=/var/lib/libvirt/images/ubuntu16-04.dsk --file-size=20 --nonsparse --graphics spice --vcpus=2 --ram=2048 --cdrom=ubuntu-16.04-server-amd64.iso --network bridge=br0 --os-type=linux --os-variant=generic

Starting install...

Allocating 'ubuntu16-04.dsk' | 20 GB 00:00:00

Creating domain...

Aus dem virtual Manager werden die VMs hochgefahren und verwaltet, es wird der Status und die Systemlast angezeigt, ähnlich wie man es von vSphere kennt.

Weiter ist virt-manager aus Cygwin in Windows 10 ausführbar, hierzu muss Cygwin64 mit dem Xorg-Server und virt-manager installiert sein, mit dem virt-manager verbindet man zum KVM Hypervisor.

Abbildung: Cygwin virt-manager Verindung

Linux

systemd-resolved

22. September 2017 DonMatteo Schreibe einen Kommentar

Ubuntu nutzt im Standard das resolvconf-Programm um die Konfiguration für die lokale DNS Auflösung vorzunehmen. Das resolvconf-Paket umfasst eine einfache Datenbank und eine Laufzeit zur dynamischen Änderung von Nameserver-Informationen. Normalerweise wird das Programm resolvconf über eine Netzwerkschnittstelle ausgeführt, um Routinen wie ifup, ifdown, NetworkManager, dhclient und pppd, oder lokale Nameserver wie dnsmasq zu pushen um die Nameserver-Informationen zu updaten.

Kommen auf einem Host statische IP Adressen und DNS Einträge zur Anwendung, sollte unter Ubuntu das resolvconf-Paket deaktiviert werden, damit nicht automatisch die DNS Konfiguration aus dem dnsmasq daemon vorgenommen wird, die Konfiguration die man in /etc/resolv.conf und /etc/network/interfaces editiert hat, werden sonst durch das resolvconf-Programm wieder überschrieben.

resolvconf deaktivieren


resolvconf --disable-updates

1 2	resolvconf --disable-updates

resolvconf aus boot level deaktivieren und das Programm beenden.


systemctl disable systemd-resolved.service
service systemd-resolved stop

systemctl disable systemd-resolved.service

service systemd-resolved stop

Den Network Manager anpassen mit default DNS.


vi /etc/NetworkManager/NetworkManager.conf
..
dns=default
..

vi /etc/NetworkManager/NetworkManager.conf

dns=default

Den Symlink resolv.conf unter /etc entfernen.


rm /etc/resolv.conf

1 2	rm /etc/resolv.conf

und eine neue resolv.conf Datei mit den Nameserver erstellen. in diesem Beispiel sind es die Google Public DNS.

In einem lokalen Netzwerk, oder einer ADS sollten die internen Nameserver genutzt werden.


vi /etc/resolv.conf

nameserver 8.8.8.8
nameserver 8.8.4.4

vi /etc/resolv.conf

nameserver 8.8.8.8

nameserver 8.8.4.4

Die resolv.conf Datei des systemd Konfigurationsprogramm löschen.


rm /etc/systemd/resolved.conf

1 2	rm /etc/systemd/resolved.conf

Änderung der Konfiguration ausführen.


service network-manager restart

1 2	service network-manager restart

Die Nameserver können auch in der Interface Konfiguration eingetragen werden.


vi /etc/network/interfaces

auto lo
iface lo inet loopback

auto ens160
iface ens160 inet static
  address 10.10.0.8
  gateway 10.10.0.1
  netmask 255.255.255.0
  network 10.10.0.0
  broadcast 10.10.0.255
  dns-nameservers 8.8.8.8 8.8.4.4
  dns-search my.local

vi /etc/network/interfaces

auto lo

iface lo inet loopback

auto ens160

iface ens160 inet static

address 10.10.0.8

gateway 10.10.0.1

netmask 255.255.255.0

network 10.10.0.0

broadcast 10.10.0.255

dns-nameservers 8.8.8.8 8.8.4.4

dns-search my.local

Die Interface Bezeichnung (ens160) kann abweichen und muss der des jeweiligen Host entsprechen.

Die Datei /etc/resolv.conf sollte keineswegs fehlen.

Um die geänderte Netzwerk Konfiguration zu aktivieren muss diese in den Speicher eingelesen werden.


/etc/init.d/networking restart

1 2	/etc/init.d/networking restart

Troubleshooting

Viele Netzwerk Probleme beruhen auf fehlerhaften DNS oder falscher Konfiguration der resolver. In einem Heimnetzwerk gibt es oft keine internen DNS, dabei kann der Router oder die Firewall als Nameserver genutzt werden, wie beispielsweise die FRITZ!Box. Grundsätzlich sollte sichergestellt werden, das die eingesetzte Firewall über ein DNS Cache verfügt, bei semiprofessionellen Firewalls wie die FortiGate verfügt nicht jedes Modell über einen solchen Cache. Bei Open Source basierten Firewalls hingegen bieten die meisten über DNS forwarder oder dnsmasq als Cache.

Nach Änderungen der Nameserver bei Windows sollte der DNS Cache zurückgesetzt werden. Eingabeaufforderung öffnen.


ipconfig /flushdns

1 2	ipconfig /flushdns

Bei Linux kann der DNS Cache zurückgesetzt werden, mit eines der folgenden commands, je nachdem welcher Dienst installiert ist.


sudo /etc/init.d/nscd restart
service nscd restart
service nscd reload
sudo /etc/init.d/dnsmasq restart
service dnsmasq restart
rndc reload

sudo /etc/init.d/nscd restart

service nscd restart

service nscd reload

sudo /etc/init.d/dnsmasq restart

service dnsmasq restart

rndc reload

Im Mac OS X Terminal als root.


lookupd -flushcache

1 2	lookupd -flushcache

Ist kein interner DNS vorhanden, können die Nameserver des jeweiligen Internet Provider eingesetzt werden, bei Swisscom sind es folgende.


cns7.bluewin.ch, 195.186.1.162
cns8.bluewin.ch, 195.186.4.162

cns7.bluewin.ch, 195.186.1.162

cns8.bluewin.ch, 195.186.4.162

Beispiel einer Nameserver abfrage seines Providers unter Windows.


C:\> nslookup -type=ns green.ch
Server:  dns1.agrinet.ch
Address:  81.221.250.11

Nicht autorisierende Antwort:
green.ch        nameserver = dns2.agrinet.ch
green.ch        nameserver = dns1.agrinet.ch

dns1.agrinet.ch internet address = 81.221.250.11

C:\> nslookup -type=ns green.ch

Server: dns1.agrinet.ch

Address: 81.221.250.11

Nicht autorisierende Antwort:

green.ch nameserver = dns2.agrinet.ch

green.ch nameserver = dns1.agrinet.ch

dns1.agrinet.ch internet address = 81.221.250.11

Beispiel Nameserver lookup query bei Linux.


~$ host -t ns green.ch
green.ch name server dns1.agrinet.ch.
green.ch name server dns2.agrinet.ch.

~$ host dns1.agrinet.ch & host dns2.agrinet.ch
dns1.agrinet.ch has address 81.221.250.11
dns2.agrinet.ch has address 81.221.252.11
dns2.agrinet.ch has IPv6 address 2a01:2a8:2001:252::11

~$ host -t ns green.ch

green.ch name server dns1.agrinet.ch.

green.ch name server dns2.agrinet.ch.

~$ host dns1.agrinet.ch & host dns2.agrinet.ch

dns1.agrinet.ch has address 81.221.250.11

dns2.agrinet.ch has address 81.221.252.11

dns2.agrinet.ch has IPv6 address 2a01:2a8:2001:252::11

Ein Ping -n1 löst Adressen zu Hostnamen auf mit Parameter -a und -4 für IPv4 Adresse.


C:\> ping -4 -n 1 -a www.google.com

Ping wird ausgeführt für www.google.com [216.58.201.4] mit 32 Bytes Daten:
Antwort von 216.58.201.4: Bytes=32 Zeit=32ms TTL=50

Ping-Statistik für 216.58.201.4:
    Pakete: Gesendet = 1, Empfangen = 1, Verloren = 0
    (0% Verlust),
Ca. Zeitangaben in Millisek.:
    Minimum = 32ms, Maximum = 32ms, Mittelwert = 32ms

C:\> ping -4 -n 1 -a www.google.com

Ping wird ausgeführt für www.google.com [216.58.201.4] mit 32 Bytes Daten:

Antwort von 216.58.201.4: Bytes=32 Zeit=32ms TTL=50

Ping-Statistik für 216.58.201.4:

Pakete: Gesendet = 1, Empfangen = 1, Verloren = 0

(0% Verlust),

Ca. Zeitangaben in Millisek.:

Minimum = 32ms, Maximum = 32ms, Mittelwert = 32ms

DevOps

Check Python Version

6. September 2017 DonMatteo Schreibe einen Kommentar

Check Python Version and query OS Platform using Python.


#!/usr/bin/python

import platform
import sys

def linux_distribution():
  try:
    return platform.linux_distribution()
  except:
    return "N/A"

print("""Python version: %s
Distribution: %s
OS: %s
System: %s
Machine: %s
Platform: %s
uname: %s
version: %s
""" % (
sys.version.split('\n'),
str(platform.dist()),
linux_distribution(),
platform.system(),
platform.machine(),
platform.platform(),
platform.uname(),
platform.version(),
))

#!/usr/bin/python

import platform

import sys

def linux_distribution():

try:

return platform.linux_distribution()

except:

return "N/A"

print("""Python version: %s

Distribution: %s

OS: %s

System: %s

Machine: %s

Platform: %s

uname: %s

version: %s

""" % (

sys.version.split('\n'),

str(platform.dist()),

linux_distribution(),

platform.system(),

platform.machine(),

platform.platform(),

platform.uname(),

platform.version(),

))

Python should output the entire OS environment.


#!/usr/bin/env python

import os

for param in os.environ.keys():
    print "%20s %s" % (param,os.environ[param])

#!/usr/bin/env python

import os

for param in os.environ.keys():

print "%20s %s" % (param,os.environ[param])

Linux

Google-Suche im Linux Terminal

24. August 2017 koma Schreibe einen Kommentar

Google-Suche ist die am meisten verwendete Suchmaschine im World Wide Web ( WWW ), um Informationen von Millionen von Servern im Internet zu sammeln.

Viele nutzen hauptsächlich die Google-Suche über ein grafischen Webbrowser. Für die Kommandozeilen-Geeks die Aufgaben im Terminal bewältigen möchten, war der Zugriff auf die Google-Suche bis anhin nicht möglich, mit dem Befehlszeilen-Tool Googler ist dies nun möglich.

Googler von Arun Prakash Jana, ist ein leistungsstarkes Kommandozeilen-Tool auf der Basis von Python, für den Zugriff auf Google (Web & News) und die Google-Site-Suche im Linux-Terminal. Googler ist für die Script Verarbeitung und Automatisation vielseitig einsetzbar.

INSTALLATION

Die Installation auf Ubuntu kann direkt aus dem Repository gemacht werden.


sudo add-apt-repository ppa:twodopeshaggy/jarun
sudo apt-get update
sudo apt-get install googler

sudo add-apt-repository ppa:twodopeshaggy/jarun

sudo apt-get update

sudo apt-get install googler

Eine andere alternative um die neuste Googler Version von herunterzuladen und zu installieren.


cd /tmp
wget -c https://github.com/jarun/googler/archive/v3.3.tar.gz
tar -xzvf v3.3.tar.gz
cd googler-3.3
sudo make install 
cd auto-completion/bash/
sudo cp googler-completion.bash /etc/bash_completion.d/

cd /tmp

wget -c https://github.com/jarun/googler/archive/v3.3.tar.gz

tar -xzvf v3.3.tar.gz

cd googler-3.3

sudo make install

cd auto-completion/bash/

sudo cp googler-completion.bash /etc/bash_completion.d/

Python 3 ist erforderlich um googler nutzen zu können. Auf Ubuntu 16.04 ist Python per Standard installiert, ansonsten wird Python 3 wie folgt installiert.


sudo apt-get install -y python3-pip
sudo apt-get install build-essential libssl-dev libffi-dev python-dev

sudo apt-get install -y python3-pip

sudo apt-get install build-essential libssl-dev libffi-dev python-dev

Python Version überprüfen.


python3 -V

1 2	python3 -V

Python 3 und Googler Installation für CentOS.


yum install yum-utils
yum-builddep python
cd /tmp
curl -O https://www.python.org/ftp/python/3.6.1/Python-3.6.1.tgz
tar -xzf Python-3.6.1.tgz
cd Python-3.6.1
./configure
make
make install
sudo curl -o /usr/local/bin/googler https://raw.githubusercontent.com/jarun/googler/v3.3/googler && sudo chmod +x /usr/local/bin/googler

yum install yum-utils

yum-builddep python

cd /tmp

curl -O https://www.python.org/ftp/python/3.6.1/Python-3.6.1.tgz

tar -xzf Python-3.6.1.tgz

cd Python-3.6.1

./configure

make

make install

sudo curl -o /usr/local/bin/googler https://raw.githubusercontent.com/jarun/googler/v3.3/googler && sudo chmod +x /usr/local/bin/googler

Die Google Suche aus dem Linux Terminal.
$ googler -n 5 mojito recipe to self made

Der omniprompt dient zur Eingabe von optionen.
Ein ? gibt hilfe aus, mit n geht es zur nächsten Seite.


Features

 * Google Search, Google Site Search, Google News
 * Fast and clean (no ads, stray URLs or clutter), custom color
 * Navigate result pages from omniprompt, open URLs in browser
 * Effortless keyword-based site search with googler @t add-on
 * Search and option completion scripts for Bash, Zsh and Fish
 * Fetch n results in a go, start at the n<sup>th</sup> result
 * Disable automatic spelling correction and search exact keywords
 * Specify duration, country/domain (default: worldwide/.com), language
 * Google keywords (e.g. filetype:mime, site:somesite.com) support
 * Open the first result directly in browser (as in I'm Feeling Lucky)
 * Non-stop searches: fire new searches at omniprompt without exiting
 * HTTPS proxy, User Agent, TLS 1.2 (default) support
 * Comprehensive documentation, man page with handy usage examples
 * Minimal dependencies

Features

* Google Search, Google Site Search, Google News

* Fast and clean (no ads, stray URLs or clutter), custom color

* Navigate result pages from omniprompt, open URLs in browser

* Effortless keyword-based site search with googler @t add-on

* Search and option completion scripts for Bash, Zsh and Fish

* Fetch n results in a go, start at the nth result

* Disable automatic spelling correction and search exact keywords

* Specify duration, country/domain (default: worldwide/.com), language

* Google keywords (e.g. filetype:mime, site:somesite.com) support

* Open the first result directly in browser (as in I'm Feeling Lucky)

* Non-stop searches: fire new searches at omniprompt without exiting

* HTTPS proxy, User Agent, TLS 1.2 (default) support

* Comprehensive documentation, man page with handy usage examples

* Minimal dependencies