Initializes a RobotRaconteurNode instance to default configuration for a secure server and client node. More...

#include <NodeSetup.h>

Inheritance diagram for RobotRaconteur::SecureServerNodeSetup:

Public Member Functions
	SecureServerNodeSetup (const boost::shared_ptr< RobotRaconteurNode > &node, const std::vector< boost::shared_ptr< ServiceFactory > > &service_types, const std::string &node_name, uint16_t tcp_port=0, uint32_t flags=RobotRaconteurNodeSetupFlags_SECURE_SERVER_DEFAULT)
	Construct a new SecureServerNodeSetup and initialize specified RobotRaconteurNode without command line options.
	SecureServerNodeSetup (const std::vector< boost::shared_ptr< ServiceFactory > > &service_types, const std::string &node_name, uint16_t tcp_port=0, uint32_t flags=RobotRaconteurNodeSetupFlags_SECURE_SERVER_DEFAULT)
	Construct a new SecureServerNodeSetup and initialize the singleton RobotRaconteurNode without command line options.
	SecureServerNodeSetup (const boost::shared_ptr< RobotRaconteurNode > &node, const std::vector< boost::shared_ptr< ServiceFactory > > &service_types, const std::string &node_name, uint16_t tcp_port, int argc, char *argv[])
	Construct a new SecureServerNodeSetup and initialize specified RobotRaconteurNode with command line options.
	SecureServerNodeSetup (const std::vector< boost::shared_ptr< ServiceFactory > > &service_types, const std::string &node_name, uint16_t tcp_port, int argc, char *argv[])
	Construct a new SecureServerNodeSetup and initialize the singleton RobotRaconteurNode with command line options.
	SecureServerNodeSetup (const boost::shared_ptr< RobotRaconteurNode > &node, const std::vector< boost::shared_ptr< ServiceFactory > > &service_types, const std::string &node_name, uint16_t tcp_port, const std::vector< std::string > &args)
	Construct a new SecureServerNodeSetup and initialize specified RobotRaconteurNode with command line options.
	SecureServerNodeSetup (const std::vector< boost::shared_ptr< ServiceFactory > > &service_types, const std::string &node_name, uint16_t tcp_port, const std::vector< std::string > &args)
	Construct a new SecureServerNodeSetup and initialize the singleton RobotRaconteurNode with command line options.
boost::shared_ptr< LocalTransport >	GetLocalTransport ()
	Get the LocalTransport.
boost::shared_ptr< TcpTransport >	GetTcpTransport ()
	Get the TcpTransport.
boost::shared_ptr< HardwareTransport >	GetHardwareTransport ()
	Get the HardwareTransport.
boost::shared_ptr< IntraTransport >	GetIntraTransport ()
	Get the IntraTransport.
boost::shared_ptr< CommandLineConfigParser >	GetCommandLineConfig ()
	Get the command line config parser object used to configure node.
void	ReleaseNode ()
	Release the node from lifecycle management.

Detailed Description

Initializes a RobotRaconteurNode instance to default configuration for a secure server and client node.

SecureServerNodeSetup is a subclass of RobotRaconteurNodeSetup providing default configuration for a secure RobotRaconteurNode instance that is used as a server to accept incoming client connections and to initiate client connections. SecureServerNodeSetup is identical to ServerNodeSetup, except that it requires TLS for all network communication.

ServerNodeSetup requires a NodeName, and a TCP port if LocalTransport and TcpTransport are enabled (default behavior).

See Command Line Options for more information on available command line options.

Note: String table and HardwareTransport are disabled by default. They can be enabled using command line options.

By default, the configuration will do the following:

Configure logging level from environmental variable or command line options. Defaults to INFO if not specified
Configure tap if specified in command line options
Register service types passed to service_types
Start LocalTransport (default enabled)
1. Configure the node to use the specified NodeName, and load the NodeID from the filesystem based based on the NodeName. NodeID will be automatically generated if not previously used.
  1. If "public" option is set, the transport will listen for all local users (default disabled)
2. Start the LocalTransport server to listen for incoming connections with the specified NodeName and NodeID
3. Start LocalTransport discovery announce and listening (default enabled)
1. Disable Message Format Version 4 (default enabled) and/or String Table (default disabled) if specified on command line
Start TcpTransport (default enabled)
1. Start the TcpTransport server to listen for incoming connections on specified port or using the port sharer (default enabled using specified port)
2. Disable Message Format Version 4 (default enabled) and/or String Table (default disabled) if specified in flags or command line
3. Start TcpTranport discovery announce and listening (default enabled)
4. Load TLS certificate and set if TLS is specified on command line (default enabled, required)
5. Process WebSocket origin command line options
Start HardwareTransport (default disabled)
1. Disable Message Format Version 4 (default enabled) and/or String Table (default disabled) if specified in flags or command line
Start IntraTransport (default disabled)
1. Enable IntraTransport server to listen for incoming clients (default enabled)
2. Disable Message Format Version 4 (default enabled) and/or String Table (default disabled) if specified in flags or command line
Disable timeouts if specified in flags or command line (default timeouts normal)

Most users will not need to be concerned with these details, and can simply use the default configuration.

Constructor & Destructor Documentation

◆ SecureServerNodeSetup() [1/6]

RobotRaconteur::SecureServerNodeSetup::SecureServerNodeSetup	(	const boost::shared_ptr< RobotRaconteurNode > &	node,
		const std::vector< boost::shared_ptr< ServiceFactory > > &	service_types,
		const std::string &	node_name,
		uint16_t	tcp_port = 0,
		uint32_t	flags = RobotRaconteurNodeSetupFlags_SECURE_SERVER_DEFAULT )

Construct a new SecureServerNodeSetup and initialize specified RobotRaconteurNode without command line options.

service_types may be ROBOTRACONTEUR_SERVICE_TYPES if "robotraconteur_generated.h" is included.

Parameters

node	The node to configure and manage lifecycle
service_types	The service types to register
node_name	The node name for LocalTransport and RobotRaconteurNode
tcp_port	The port to listen on for TcpTransport
flags	The node configuration flags

◆ SecureServerNodeSetup() [2/6]

RobotRaconteur::SecureServerNodeSetup::SecureServerNodeSetup	(	const std::vector< boost::shared_ptr< ServiceFactory > > &	service_types,
		const std::string &	node_name,
		uint16_t	tcp_port = 0,
		uint32_t	flags = RobotRaconteurNodeSetupFlags_SECURE_SERVER_DEFAULT )

Construct a new SecureServerNodeSetup and initialize the singleton RobotRaconteurNode without command line options.

Configures RobotRaconteurNode::s() and manages its lifecycle

service_types may be ROBOTRACONTEUR_SERVICE_TYPES if "robotraconteur_generated.h" is included.

Parameters

service_types	The service types to register
node_name	The node name for LocalTransport and RobotRaconteurNode
tcp_port	The port to listen on for TcpTransport
flags	The node configuration flags

◆ SecureServerNodeSetup() [3/6]

RobotRaconteur::SecureServerNodeSetup::SecureServerNodeSetup	(	const boost::shared_ptr< RobotRaconteurNode > &	node,
		const std::vector< boost::shared_ptr< ServiceFactory > > &	service_types,
		const std::string &	node_name,
		uint16_t	tcp_port,
		int	argc,
		char *	argv[] )

Construct a new SecureServerNodeSetup and initialize specified RobotRaconteurNode with command line options.

service_types may be ROBOTRACONTEUR_SERVICE_TYPES if "robotraconteur_generated.h" is included.

See Command Line Options for more information on available command line options.

Parameters

node	The node to configure and manage lifecycle
service_types	The service types to register
node_name	The node name for LocalTransport and RobotRaconteurNode
tcp_port	The port to listen on for TcpTransport
argc	The number of command line arguments in argv vector
argv	The command line argument vector

◆ SecureServerNodeSetup() [4/6]

RobotRaconteur::SecureServerNodeSetup::SecureServerNodeSetup	(	const std::vector< boost::shared_ptr< ServiceFactory > > &	service_types,
		const std::string &	node_name,
		uint16_t	tcp_port,
		int	argc,
		char *	argv[] )

Construct a new SecureServerNodeSetup and initialize the singleton RobotRaconteurNode with command line options.

service_types may be ROBOTRACONTEUR_SERVICE_TYPES if "robotraconteur_generated.h" is included.

See Command Line Options for more information on available command line options.

Parameters

service_types	The service types to register
node_name	The node name for LocalTransport and RobotRaconteurNode
tcp_port	The port to listen on for TcpTransport
argc	The number of command line arguments in argv vector
argv	The command line argument vector

◆ SecureServerNodeSetup() [5/6]

RobotRaconteur::SecureServerNodeSetup::SecureServerNodeSetup	(	const boost::shared_ptr< RobotRaconteurNode > &	node,
		const std::vector< boost::shared_ptr< ServiceFactory > > &	service_types,
		const std::string &	node_name,
		uint16_t	tcp_port,
		const std::vector< std::string > &	args )

Construct a new SecureServerNodeSetup and initialize specified RobotRaconteurNode with command line options.

service_types may be ROBOTRACONTEUR_SERVICE_TYPES if "robotraconteur_generated.h" is included.

See Command Line Options for more information on available command line options.

Parameters

node	The node to configure and manage lifecycle
service_types	The service types to register
node_name	The node name for LocalTransport and RobotRaconteurNode
tcp_port	The port to listen on for TcpTransport
args	The command line options as a string vector

◆ SecureServerNodeSetup() [6/6]

RobotRaconteur::SecureServerNodeSetup::SecureServerNodeSetup	(	const std::vector< boost::shared_ptr< ServiceFactory > > &	service_types,
		const std::string &	node_name,
		uint16_t	tcp_port,
		const std::vector< std::string > &	args )

Construct a new SecureServerNodeSetup and initialize the singleton RobotRaconteurNode with command line options.

service_types may be ROBOTRACONTEUR_SERVICE_TYPES if "robotraconteur_generated.h" is included.

See Command Line Options for more information on available command line options.

Parameters

service_types	The service types to register
node_name	The node name for LocalTransport and RobotRaconteurNode
tcp_port	The port to listen on for TcpTransport
args	The command line options as a string vector

Member Function Documentation

◆ GetCommandLineConfig()

boost::shared_ptr< CommandLineConfigParser > RobotRaconteur::RobotRaconteurNodeSetup::GetCommandLineConfig ( )

inherited

Get the command line config parser object used to configure node.

Returns: RR_SHARED_PTR<CommandLineConfigParser> The command line config parser

◆ GetHardwareTransport()

boost::shared_ptr< HardwareTransport > RobotRaconteur::RobotRaconteurNodeSetup::GetHardwareTransport ( )

inherited

Get the HardwareTransport.

Will be null if HardwareTransport is not specified in flags

Note: Hardware transport is not enabled by default

Returns: RR_SHARED_PTR<HardwareTransport> The HardwareTransport object

◆ GetIntraTransport()

boost::shared_ptr< IntraTransport > RobotRaconteur::RobotRaconteurNodeSetup::GetIntraTransport ( )

inherited

Get the IntraTransport.

Will be null if IntraTransport is not specified in flags

Returns: RR_SHARED_PTR<IntraTransport> The IntraTransport object

◆ GetLocalTransport()

boost::shared_ptr< LocalTransport > RobotRaconteur::RobotRaconteurNodeSetup::GetLocalTransport ( )

inherited

Get the LocalTransport.

Will be null if LocalTransport is not specified in flags

Returns: RR_SHARED_PTR<LocalTransport> The LocalTransport object

◆ GetTcpTransport()

boost::shared_ptr< TcpTransport > RobotRaconteur::RobotRaconteurNodeSetup::GetTcpTransport ( )

inherited

Get the TcpTransport.

Will be null if TcpTransport is not specified in flags

Returns: RR_SHARED_PTR<TcpTransport> The TcpTransport object

◆ ReleaseNode()

void RobotRaconteur::RobotRaconteurNodeSetup::ReleaseNode ( )

inherited

Release the node from lifecycle management.

If called, RobotRaconteurNode::Shutdown() will not be called when the node setup instance is destroyed

The documentation for this class was generated from the following file:

/builddir/build/BUILD/robotraconteur-1.2.8-build/RobotRaconteur-1.2.8-Source/RobotRaconteurCore/include/RobotRaconteur/NodeSetup.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ SecureServerNodeSetup() [1/6]

◆ SecureServerNodeSetup() [2/6]

◆ SecureServerNodeSetup() [3/6]

◆ SecureServerNodeSetup() [4/6]

◆ SecureServerNodeSetup() [5/6]

◆ SecureServerNodeSetup() [6/6]

Member Function Documentation

◆ GetCommandLineConfig()

◆ GetHardwareTransport()

◆ GetIntraTransport()

◆ GetLocalTransport()

◆ GetTcpTransport()

◆ ReleaseNode()