RIOT/tests/lwip_sock_udp/README.md

Tests for lwIP's sock_udp port
==============================

This tests the `sock_udp` port of lwIP. There is no network device needed since
a [virtual device](http://doc.riot-os.org/group__sys__netdev__test.html) is
provided at the backend.

These tests test both IPv4 and IPv6 capabilities. They can be activated by
the `LWIP_IPV4` and `LWIP_IPV6` environment variables to a non-zero value.
IPv6 is activated by default:

```sh
make all test
# or
LWIP_IPV6=1 make all test
```

To just test IPv4 set the `LWIP_IPV4` to a non-zero value (IPv6 will be
deactivated automatically):

```sh
LWIP_IPV4=1 make all test
```

To test both set the `LWIP_IPV4` and `LWIP_IPV6` to a non-zero value:

```sh
LWIP_IPV4=1 LWIP_IPV6=1 make all test
```

Since lwIP uses a lot of macro magic to activate/deactivate these capabilities
it is advisable to **test all three configurations individually** (just IPv4,
just IPv6, IPv4/IPv6 dual stack mode).
pkg: provide sock_udp support for lwip 2016-09-02 19:03:35 +02:00			`Tests for lwIP's sock_udp port`
			`==============================`

			This tests the `sock_udp` port of lwIP. There is no network device needed since
netdev2: rename to netdev and remove `gnrc_netdev` With some minor hand-edits I used the following chain of commands: ```sh git rm sys/include/net/gnrc/netdev.h git grep --name-only -i netdev2 \| \ xargs sed -i -e 's/^\(NETDEV\)2\(.\)\( [("]\)/\1\2 \3/g' \ -e 's/\(netdev\)2\(.\)\( \/\\<\)/\1\2 \3/I' \ -e 's/\(netdev\)2/\1/gI' git add -p git commit --amend git ls-tree --full-tree -r HEAD --name-only \| \ grep "netdev2" \| xargs -I'{}' dirname '{}' \| uniq \| \ grep "netdev2" \| while read dir; do new_dir="$(echo "$dir" \| sed "s/netdev2/netdev/g")" git mv -f "$dir" "$new_dir" done git commit --amend git ls-tree --full-tree -r HEAD --name-only \| \ grep "netdev2" \| while read file; do new_file="$(echo "$file" \| sed "s/netdev2/netdev/g")" git mv -f "$file" "$new_file" done git commit --amend git grep --name-only "\<drivers_netdev_netdev\>" \| \ xargs sed -i "s/\<drivers_netdev_netdev\>/drivers_netdev_api/g" git add -p git commit --amend ``` 2017-02-15 13:07:34 +01:00			`a [virtual device](http://doc.riot-os.org/group__sys__netdev__test.html) is`
pkg: provide sock_udp support for lwip 2016-09-02 19:03:35 +02:00			`provided at the backend.`

			`These tests test both IPv4 and IPv6 capabilities. They can be activated by`
			the `LWIP_IPV4` and `LWIP_IPV6` environment variables to a non-zero value.
			`IPv6 is activated by default:`

			```sh
			`make all test`
			`# or`
			`LWIP_IPV6=1 make all test`
			```

			To just test IPv4 set the `LWIP_IPV4` to a non-zero value (IPv6 will be
			`deactivated automatically):`

			```sh
			`LWIP_IPV4=1 make all test`
			```

			To test both set the `LWIP_IPV4` and `LWIP_IPV6` to a non-zero value:

			```sh
			`LWIP_IPV4=1 LWIP_IPV6=1 make all test`
			```

			`Since lwIP uses a lot of macro magic to activate/deactivate these capabilities`
			`it is advisable to test all three configurations individually (just IPv4,`
			`just IPv6, IPv4/IPv6 dual stack mode).`