Merge pull request mageddo#606 from mageddo/readme-docs

updating readme running it examples

Author: mageddo

README.md

@@ -22,31 +22,57 @@ Checkout the [full list of features][4] with examples
 ### Basic running it 
 
 You can run DPS as native binary downloading the latest [binaries releases][2] 
-or via docker looking at [Dockerhub images][3].
+or via docker looking at [Dockerhub images][3]. See [complete running it][5] documentation for running on 
+Mac, Windows, Docker, etc.
 
 Basic running it on Linux or Mac
+
 ```bash
-sudo ./dns-proxy-server
+sudo ./dns-proxy-server --server-port 5555
 ```
 
-Then you can solve from pre-configured entries (conf/config.json): 
+Solving docker containers:
 ```bash
-$ ping dps-sample.dev
-PING dps-sample.dev (192.168.0.254) 56(84) bytes of data.
+$ docker run --rm --hostname nginx.dev nginx
+
+$ nslookup -po=5555 nginx.dev 127.0.0.1
+172.17.0.3
 ```
 
-Also solve Docker containers:
+Solving from pre-configured entries (conf/config.json):
 ```bash
-$ docker run --rm --hostname nginx.dev nginx
+$ nslookup -po=5555 dps-sample.dev 127.0.0.1
+192.168.0.254
+```
+
+Solving from Internet
+```bash
+$ nslookup -po=5555 google.com 127.0.0.1
+142.250.79.174
+```
+
+Solving stub hostnames like nip.io or sslip.io
+```bash
+$ nslookup -po=5555 machine-1.192.168.0.1.stub 127.0.0.1
+192.168.0.1
+```
+
+Solving host machine IP
+```bash
+$ nslookup -po=5555 host.docker 127.0.0.1
+172.22.230.67
+```
+
+Solving all subdomains to a specific docker container
+
+```bash
+$ docker run --rm --hostname .nginx.dev nginx
 
-$ ping nginx.dev
-PING nginx.dev (172.17.0.4) 56(84) bytes of data.
-64 bytes from 172.17.0.4 (172.17.0.4): icmp_seq=1 ttl=64 time=0.043 ms
-64 bytes from 172.17.0.4 (172.17.0.4): icmp_seq=2 ttl=64 time=0.022 ms
+$ nslookup -po=5555 site1.nginx.dev 127.0.0.1
+172.17.0.3
 ```
 
-See [complete running it][5] documentation for running on Mac, Windows, Docker, etc.
-also check the [samples][9] to learn by pratice.
+Check more [samples][9] to learn by practice.
 
 ### Documents
 * [Full documentation](http://mageddo.github.io/dns-proxy-server/)

RELEASE-NOTES.md

@@ -1,5 +1,5 @@
 ## 3.32.3
-* Ignoring containers which fails to inspect. #599
+* Ignoring containers which fails to inspect, credits to @defung . #599
 
 ## 3.32.2
 * Exposing Stub Solver domain config, see the docs. #545