https://github.com/vimpunk/natpp
(Going to be an) Asio integrated C++17 port mapping library (supports NATPMP and [soon] UPnP)
https://github.com/vimpunk/natpp
Last synced: 8 months ago
JSON representation
(Going to be an) Asio integrated C++17 port mapping library (supports NATPMP and [soon] UPnP)
- Host: GitHub
- URL: https://github.com/vimpunk/natpp
- Owner: vimpunk
- License: mit
- Created: 2018-07-21T23:09:14.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-08-05T20:39:17.000Z (almost 8 years ago)
- Last Synced: 2025-03-29T01:02:15.351Z (about 1 year ago)
- Language: C++
- Homepage:
- Size: 22.5 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# natpp
This library lets you create [port mappings](https://en.wikipedia.org/wiki/Port_forwarding) using
the well established Asio C++ networking library.
## Asio
This library integrates deeply with the Asio framework by providing an IO service backend and corresponding IO
object classes for each protocol type. Currently it only works with the standalone version of Asio, but support for independent Asio sources (i.e. standalone or Boost) is in the plans.
## Work-in-progress note
Since this library is work-in-progress, currently it only supports the [NATPMP protocol](https://en.wikipedia.org/wiki/NAT_Port_Mapping_Protocol).
However, support for [UPnP port forwarding](https://en.wikipedia.org/wiki/Universal_Plug_and_Play#NAT_traversal) is in the works and should land soon.
## Usage
```c++
#include
#include
int main()
{
asio::io_context io;
nat::natpmp natpmp(io);
natpmp.async_public_address([](nat::error_code error, asio::ip::address addr) {
if(!error) {
// TODO print addr
}
});
nat::port_mapping mapping;
mapping.private_port = 55555;
mapping.public_port = 55555;
mapping.duration = std::chrono::hours(2);
natpmp.async_request_mapping(mapping,
[](nat::error_code error, nat::port_mapping mapping) {
if(!error) {
// TODO print mapping
}
});
io.run();
}
```