{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Goal","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"While ","type":"text"},{"text":"tun","type":"text","marks":[{"type":"code"}]},{"text":" comes standard with Linux, it's often considered hard to use under Windows. This tutorial will show that that it isn't.","type":"text"}]}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"legacy-content","text":"","parameters":{"nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"atlassian-macro-output-type":{"value":"BLOCK"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Excerpt"}}},"content":[{"type":"paragraph","content":[{"text":"tun","type":"text","marks":[{"type":"code"}]},{"text":" is a handy little thing which allows you to write an application which emulates a physical interface. That is, when your kernel sends IP packets to this \"virtual\" interface, it's ","type":"text"},{"text":"your application","type":"text","marks":[{"type":"em"}]},{"text":" that receives them, not some piece of hardware. Similarly, your application can inject IP packets into the kernel as if they came from a regular (e.g. Ethernet) interface.","type":"text"}]},{"type":"paragraph","content":[{"text":"The kernel has no clue that it's not a physical interface, and so you can do everything you're used to: assign IP addresses, manage gateways and routing, and apply firewall rules.","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"gliffy","parameters":{"macroParams":{"name":{"value":"tun_basic"}},"macroMetadata":{"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://confluence-connect.gliffy.net/diagram/image/placeHolder.png?name=tun_basic"}}],"title":"Gliffy Diagram"}}}},{"type":"paragraph","content":[{"text":"It's a great tool for messing with (and learning about) the protocol stack shipped with your operating system, or to build a ","type":"text"},{"text":"Virtual Private Network","type":"text","marks":[{"type":"link","attrs":{"href":"http://openvpn.net/"}}]},{"text":". Yet, in the world on low-power wireless devices, ","type":"text"},{"text":"tun","type":"text","marks":[{"type":"code"}]},{"text":" comes in handy when connecting your low-power mesh to the internet, as described in the ","type":"text"},{"text":"Your 6LoWPAN mesh on the Internet","type":"text","marks":[{"type":"link","attrs":{"href":"https://openwsn.atlassian.net/wiki/spaces/OW/pages/688220"}}]},{"text":" tutorial.","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"gliffy","parameters":{"macroParams":{"name":{"value":"tun_motes"}},"macroMetadata":{"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://confluence-connect.gliffy.net/diagram/image/placeHolder.png?name=tun_motes"}}],"title":"Gliffy Diagram"}}}},{"type":"paragraph","content":[{"text":"This is a step-by-step hands-on tutorial, which will have you install, use and understand ","type":"text"},{"text":"tun","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}],"version":1},"cxhtml":"BLOCK

tun is a handy little thing which allows you to write an application which emulates a physical interface. That is, when your kernel sends IP packets to this "virtual" interface, it's your application that receives them, not some piece of hardware. Similarly, your application can inject IP packets into the kernel as if they came from a regular (e.g. Ethernet) interface.

The kernel has no clue that it's not a physical interface, and so you can do everything you're used to: assign IP addresses, manage gateways and routing, and apply firewall rules.

tun_basic

It's a great tool for messing with (and learning about) the protocol stack shipped with your operating system, or to build a Virtual Private Network. Yet, in the world on low-power wireless devices, tun comes in handy when connecting your low-power mesh to the internet, as described in the tutorial.

tun_motes

This is a step-by-step hands-on tutorial, which will have you install, use and understand tun.

"}}},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{"all":{"value":"true"}},"macroMetadata":{"schemaVersion":{"value":"2"},"title":"Child pages"}}}}],"version":1}

tun/tap in Windows