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
2019-04-09 17:31:08 +02:00

45 lines
1.2 KiB
Markdown

# Creating a SLIP network interface
The module `slipdev` (Serial line IP) enables the RIOT network stack to
send and receive IP packets over a 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 IPv4 packages and is unnecessarily complicated.
## 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` opens a TAP interface (includes link-layer data) for
a serial interface handling IPv6 packets,
- `tunslip` opens a TUN interface (includes network-layer data)
for a serial interface handling IPv4 packets, and
- `tunslip6` opens a TUN interface (includes network-layer data)
for a serial interface handling IPv6 packets.
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