sdbus-c++ 1.2.0
High-level C++ D-Bus library based on systemd D-Bus implementation
IConnection.h File Reference
#include <sdbus-c++/TypeTraits.h>
#include <string>
#include <memory>
#include <chrono>
#include <cstdint>
#include <optional>

Go to the source code of this file.

Classes

class  sdbus::IConnection
 
struct  sdbus::IConnection::PollData
 

Functions

std::unique_ptr< sdbus::IConnectionsdbus::createConnection ()
 Creates/opens D-Bus system bus connection. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createConnection (const std::string &name)
 Creates/opens D-Bus system bus connection with a name. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createDefaultBusConnection ()
 Creates/opens D-Bus session bus connection when in a user context, and a system bus connection, otherwise. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createDefaultBusConnection (const std::string &name)
 Creates/opens D-Bus session bus connection with a name when in a user context, and a system bus connection with a name, otherwise. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createSystemBusConnection ()
 Creates/opens D-Bus system bus connection. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createSystemBusConnection (const std::string &name)
 Creates/opens D-Bus system bus connection with a name. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createSessionBusConnection ()
 Creates/opens D-Bus session bus connection. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createSessionBusConnection (const std::string &name)
 Creates/opens D-Bus session bus connection with a name. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createSessionBusConnectionWithAddress (const std::string &address)
 Creates/opens D-Bus session bus connection at a custom address. More...
 
std::unique_ptr< sdbus::IConnectionsdbus::createRemoteSystemBusConnection (const std::string &host)
 Creates/opens D-Bus system connection on a remote host using ssh. More...
 

Detailed Description

(C) 2016 - 2021 KISTLER INSTRUMENTE AG, Winterthur, Switzerland (C) 2016 - 2022 Stanislav Angelovic stani.nosp@m.slav.nosp@m..ange.nosp@m.lovi.nosp@m.c@pro.nosp@m.tonm.nosp@m.ail.c.nosp@m.om

Created on: Nov 8, 2016 Project: sdbus-c++ Description: High-level D-Bus IPC C++ library based on sd-bus

This file is part of sdbus-c++.

sdbus-c++ is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 2.1 of the License, or (at your option) any later version.

sdbus-c++ 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with sdbus-c++. If not, see http://www.gnu.org/licenses/.

Function Documentation

◆ createConnection() [1/2]

std::unique_ptr< sdbus::IConnection > sdbus::createConnection ( )

Creates/opens D-Bus system bus connection.

Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createConnection() [2/2]

std::unique_ptr< sdbus::IConnection > sdbus::createConnection ( const std::string &  name)

Creates/opens D-Bus system bus connection with a name.

Parameters
[in]nameName to request on the connection after its opening
Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createDefaultBusConnection() [1/2]

std::unique_ptr< sdbus::IConnection > sdbus::createDefaultBusConnection ( )

Creates/opens D-Bus session bus connection when in a user context, and a system bus connection, otherwise.

Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createDefaultBusConnection() [2/2]

std::unique_ptr< sdbus::IConnection > sdbus::createDefaultBusConnection ( const std::string &  name)

Creates/opens D-Bus session bus connection with a name when in a user context, and a system bus connection with a name, otherwise.

Parameters
[in]nameName to request on the connection after its opening
Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createRemoteSystemBusConnection()

std::unique_ptr< sdbus::IConnection > sdbus::createRemoteSystemBusConnection ( const std::string &  host)

Creates/opens D-Bus system connection on a remote host using ssh.

Parameters
[in]hostName of the host to connect
Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createSessionBusConnection() [1/2]

std::unique_ptr< sdbus::IConnection > sdbus::createSessionBusConnection ( )

Creates/opens D-Bus session bus connection.

Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createSessionBusConnection() [2/2]

std::unique_ptr< sdbus::IConnection > sdbus::createSessionBusConnection ( const std::string &  name)

Creates/opens D-Bus session bus connection with a name.

Parameters
[in]nameName to request on the connection after its opening
Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createSessionBusConnectionWithAddress()

std::unique_ptr< sdbus::IConnection > sdbus::createSessionBusConnectionWithAddress ( const std::string &  address)

Creates/opens D-Bus session bus connection at a custom address.

Parameters
[in]address";"-separated list of addresses of bus brokers to try to connect
Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

Consult manual pages for sd_bus_set_address of the underlying sd-bus library for more information.

◆ createSystemBusConnection() [1/2]

std::unique_ptr< sdbus::IConnection > sdbus::createSystemBusConnection ( )

Creates/opens D-Bus system bus connection.

Returns
Connection instance
Exceptions
sdbus::Errorin case of failure

◆ createSystemBusConnection() [2/2]

std::unique_ptr< sdbus::IConnection > sdbus::createSystemBusConnection ( const std::string &  name)

Creates/opens D-Bus system bus connection with a name.

Parameters
[in]nameName to request on the connection after its opening
Returns
Connection instance
Exceptions
sdbus::Errorin case of failure