1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/dist/tools/tunslip/README.md

44 lines
1.2 KiB
Markdown
Raw Normal View History

2015-03-23 14:24:50 +01:00
Creating a SLIP network interface
=================================
2017-07-18 14:39:03 +02:00
The module `slipdev` (Serial line IP) enables the RIOT network stack to
2015-03-23 14:24:50 +01:00
communicate IP packets over the serial interface. This collection of tools
originally from Contiki [1] enables Linux to interpret this data. Though there
is a tool for such operations on Linux (`slattach`) it is only able to handle
2016-09-19 12:09:46 +02:00
IPv4 packages and is unnecessarily complicated.
2015-03-23 14:24:50 +01:00
# Installation
Just install them using
``` {.sh}
make
sudo make install
```
By default they are installed to the `/usr/local/bin` directory, you can however
change that by setting the PREFIX environment variable
``` {.sh}
export PREFIX=${HOME}/.local
make
sudo make install
```
# Usage
`tapslip6` allows you to open a TAP interface (includes link-layer data) for
a serial interace handling IPv6 data,
`tunslip` allows you to open a TUN interface (includes only network-layer data)
for a serial interace handling IPv4 data, and
`tunslip6` allows you to open a TUN interface (includes only network-layer data)
for a serial interace handling IPv6 data.
For more information use the help feature of the tools
``` {.sh}
tapslip -h
tunslip -h
tunslip6 -h
```
[1] https://github.com/contiki-os/contiki/tree/a4206273a5a491949f9e565e343f31908173c998/tools