/* * ZeroTier One - Network Virtualization Everywhere * Copyright (C) 2011-2017 ZeroTier, Inc. https://www.zerotier.com/ * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * * -- * * You can be released from the requirements of the license by purchasing * a commercial license. Buying such a license is mandatory as soon as you * develop commercial closed-source software that incorporates or links * directly against ZeroTier software without disclosing the source code * of your own application. */ #ifndef ZT_ONESERVICE_HPP #define ZT_ONESERVICE_HPP #include #include #include "../node/InetAddress.hpp" #ifdef ZT_SDK #include "../node/Node.hpp" // Use the virtual netcon endpoint instead of a tun/tap port driver #include "../src/SocketTap.hpp" namespace ZeroTier { typedef SocketTap EthernetTap; } #endif namespace ZeroTier { /** * Local service for ZeroTier One as system VPN/NFV provider */ class OneService { public: /** * Returned by node main if/when it terminates */ enum ReasonForTermination { /** * Instance is still running */ ONE_STILL_RUNNING = 0, /** * Normal shutdown */ ONE_NORMAL_TERMINATION = 1, /** * A serious unrecoverable error has occurred */ ONE_UNRECOVERABLE_ERROR = 2, /** * Your identity has collided with another */ ONE_IDENTITY_COLLISION = 3 }; /** * Local settings for each network */ struct NetworkSettings { /** * Allow this network to configure IP addresses and routes? */ bool allowManaged; /** * Whitelist of addresses that can be configured by this network. * If empty and allowManaged is true, allow all private/pseudoprivate addresses. */ std::vector allowManagedWhitelist; /** * Allow configuration of IPs and routes within global (Internet) IP space? */ bool allowGlobal; /** * Allow overriding of system default routes for "full tunnel" operation? */ bool allowDefault; }; /** * @return Platform default home path or empty string if this platform doesn't have one */ static std::string platformDefaultHomePath(); /** * Create a new instance of the service * * Once created, you must call the run() method to actually start * processing. * * The port is saved to a file in the home path called zerotier-one.port, * which is used by the CLI and can be used to see which port was chosen if * 0 (random port) is picked. * * @param hp Home path * @param port TCP and UDP port for packets and HTTP control (if 0, pick random port) */ static OneService *newInstance(const char *hp,unsigned int port); virtual ~OneService(); /** * Execute the service main I/O loop until terminated * * The terminate() method may be called from a signal handler or another * thread to terminate execution. Otherwise this will not return unless * another condition terminates execution such as a fatal error. */ virtual ReasonForTermination run() = 0; /** * @return Reason for terminating or ONE_STILL_RUNNING if running */ virtual ReasonForTermination reasonForTermination() const = 0; /** * @return Fatal error message or empty string if none */ virtual std::string fatalErrorMessage() const = 0; /** * @return System device name corresponding with a given ZeroTier network ID or empty string if not opened yet or network ID not found */ virtual std::string portDeviceName(uint64_t nwid) const = 0; #ifdef ZT_SDK /** * Leaves a network */ virtual void leave(const char *hp) = 0; /** * Joins a network */ virtual void join(const char *hp) = 0; /** * Returns the homePath given by the client application */ virtual std::string givenHomePath() = 0; /* * Returns a SocketTap that is associated with the given nwid */ virtual EthernetTap * getTap(uint64_t nwid) = 0; /* * Returns a SocketTap that cant function as a route to the specified host */ virtual EthernetTap * getTap(InetAddress &addr) = 0; /* * Returns a pointer to the Node */ virtual Node * getNode() = 0; /* * Delete all SocketTap interfaces */ virtual void removeNets() = 0; #endif /** * Terminate background service (can be called from other threads) */ virtual void terminate() = 0; /** * Get local settings for a network * * @param nwid Network ID * @param settings Buffer to fill with local network settings * @return True if network was found and settings is filled */ virtual bool getNetworkSettings(const uint64_t nwid,NetworkSettings &settings) const = 0; /** * Set local settings for a network * * @param nwid Network ID * @param settings New network local settings * @return True if network was found and setting modified */ virtual bool setNetworkSettings(const uint64_t nwid,const NetworkSettings &settings) = 0; /** * @return True if service is still running */ inline bool isRunning() const { return (this->reasonForTermination() == ONE_STILL_RUNNING); } protected: OneService() {} private: OneService(const OneService &one) {} inline OneService &operator=(const OneService &one) { return *this; } }; } // namespace ZeroTier #endif