dbusutil

Documentation

Index

• Variables
• func MockConnections(system, session func() (*dbus.Conn, error)) (restore func())
• func MockOnlySessionBusAvailable(conn *dbus.Conn) (restore func())
• func MockOnlySystemBusAvailable(conn *dbus.Conn) (restore func())
• func SessionBusPrivate() (*dbus.Conn, error)

Variables

var SessionBus = func() (*dbus.Conn, error) {
	if isSessionBusLikelyPresent() {
		return dbus.SessionBus()
	}
	return nil, fmt.Errorf("cannot find session bus")
}

SessionBus is like dbus.SessionBus but it avoids auto-starting a new dbus-daemon when a bus is not already available.

The go-dbus package will launch a session bus instance on demand when none is present, something we do not want to do. In all contexts where there is a need

to use the session bus, we expect session bus daemon to have been started and

managed by the corresponding user session manager.

This function is mockable by either MockConnections or MockOnlySessionBusAvailable.

var SystemBus = func() (*dbus.Conn, error) {
	return dbus.SystemBus()
}

SystemBus is like dbus.SystemBus and is provided for completeness.

This function is mockable by either MockConnections or MockOnlySystemBusAvailable.

Functions

func MockConnections

func MockConnections(system, session func() (*dbus.Conn, error)) (restore func())

MockConnections mocks the connection functions system and session buses.

func MockOnlySessionBusAvailable

func MockOnlySessionBusAvailable(conn *dbus.Conn) (restore func())

MockOnlySessionBusAvailable makes SessionBus return the given connection.

In addition calling SystemBus will panic.

func MockOnlySystemBusAvailable

func MockOnlySystemBusAvailable(conn *dbus.Conn) (restore func())

MockOnlySystemBusAvailable makes SystemBus return the given connection.

In addition calling SessionBus will panic.

func SessionBusPrivate

func SessionBusPrivate() (*dbus.Conn, error)

SessionBusPrivate opens a connection to the D-Bus session bus independent of the default shared connection.