OrgZephyr/zephyr
OrgZephyr
/
zephyr
mirror of https://github.com/zephyrproject-rtos/zephyr.git
1
0
Fork 0
Code Issues Releases Wiki Activity
zephyr/samples/net/dns_client/README

140 lines
3.2 KiB
Plaintext
Raw Normal View History

samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
DNS Client Application
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
Requirements
------------
* Ethernet LAN for testing purposes.
* Galileo Gen 2 Development Board.
* USB-UART cable: CH340, FTDI 6-pin or equivalent for debugging.
* dnsmasq application. The dnsmasq version used in this sample is:
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
dnsmasq -v
Dnsmasq version 2.75 Copyright (c) 2000-2015 Simon Kelley
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
Building instructions
---------------------
dns: Remove deprecated functionality This commit removes deprecated APIs and replaces them with routines that provide similar functionality without the flexibility originally offered by the deprecated APIs. Removing deprecated routines will help us to be prepared once the new IP stack is ready (ZEP-793). Furthermore, this commit will also help us to move our current DNS Client implementation to the lib/iot directory, as specified by ZEP-847. This commit removes the netz library from the DNS client sample application. UDP functionality is replaced by primitive routines. Specifically, the following changes are applied by this patch: - Remove netz routines - Remove app_buf data structure - Introduce primitive data types in the DNS client code - Introduce primitive network routines - Add a header file containing configurable parameters Jira: ZEP-793 Jira: ZEP-847 Change-Id: I0302133da77308f0cdd9ace2c0265e6b77673ff0 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-09-09 14:14:23 +08:00
* Read src/tcp_config.h, change the IP addresses according to the LAN
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
environment.
* make pristine && make are enough to build this sample.
* Follow the steps indicated here:
https://www.zephyrproject.org/doc/board/galileo.html
to load the binary into the Galileo Dev Board.
Usage
-----
* Open a terminal window and type:
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
dnsmasq -d
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
* Connect the USB-UART cable to the Galileo. Open a terminal and run:
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
screen /dev/ttyUSB0 115200
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
* Connect Galileo to the LAN, Turn on the board.
* The screen terminal window will show:
-----------------------------------------
Domain name: not_a_real_domain_name
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
[fiber:89] DNS Query: OK, ID: 0
[fiber:92] TX: OK
[fiber:97] RX: OK
[fiber:102] DNS Response: ERROR <- :)
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
-----------------------------------------
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Domain name: linuxfoundation.org
[fiber:89] DNS Query: OK, ID: 1
[fiber:92] TX: OK
[fiber:97] RX: OK
****** DNS ANSWER: 0 ******
Response: IP address Size: 4: 140 211 169 4
[fiber:102] DNS Response: OK
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
-----------------------------------------
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Domain name: www.linuxfoundation.org
[fiber:89] DNS Query: OK, ID: 2
[fiber:92] TX: OK
[fiber:97] RX: OK
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
****** DNS ANSWER: 0 ******
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Response: IP address Size: 4: 140 211 169 4
[fiber:102] DNS Response: OK
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
-----------------------------------------
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Domain name: gnu.org
[fiber:89] DNS Query: OK, ID: 3
[fiber:92] TX: OK
[fiber:97] RX: OK
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
****** DNS ANSWER: 0 ******
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Response: IP address Size: 4: 208 118 235 148
[fiber:102] DNS Response: OK
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
-----------------------------------------
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Domain name: www.gnu.org
[fiber:89] DNS Query: OK, ID: 4
[fiber:92] TX: OK
[fiber:97] RX: OK
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
****** DNS ANSWER: 0 ******
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Response: CNAME NO IP address
CNAME: wildebeest.gnu.org
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
****** DNS ANSWER: 1 ******
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Response: IP address Size: 4: 208 118 235 148
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
[fiber:102] DNS Response: OK
-----------------------------------------
Domain name: npr.org
[fiber:89] DNS Query: OK, ID: 5
[fiber:92] TX: OK
[fiber:97] RX: OK
****** DNS ANSWER: 0 ******
Response: IP address Size: 4: 216 35 221 76
[fiber:102] DNS Response: OK
samples/net: DNS client application This sample code shows how to write a DNS client application. Only client functionality is implemented in this sample. The code is self-documented. Read the README file for more information about the network setup. See https://tools.ietf.org/html/rfc1035 for more information about the DNS protocol. Origin: Original Jira: ZEP-500 Jira: ZEP-501 Change-Id: Ibcfa4e392143fdc2258971304d5296d70c1c9423 Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-07-30 06:32:48 +08:00
-----------------------------------------
dns: FIX add README_API file and improve sample code README_API file is added in this patch. Inline code documentation is improved. More test domains are added. The README file is also updated to reflect these changes. Change-Id: Ie670a6559611c6a8d216470e245dbea48369696f Signed-off-by: Flavio Santes <flavio.santes@intel.com>
2016-08-05 00:21:34 +08:00
Domain name: www.npr.org
[fiber:89] DNS Query: OK, ID: 6
[fiber:92] TX: OK
[fiber:97] RX: OK
****** DNS ANSWER: 0 ******
Response: CNAME NO IP address
CNAME: www-cdn.npr.org.edgesuite.net
****** DNS ANSWER: 1 ******
Response: CNAME NO IP address
CNAME: a1723.g.akamai.net
****** DNS ANSWER: 2 ******
Response: IP address Size: 4: 63 80 4 192
****** DNS ANSWER: 3 ******
Response: IP address Size: 4: 63 80 4 161
[fiber:102] DNS Response: OK