Infinity.DiscoveryAvahi¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37), Infinity.Discovery (7), Infinity.LocalPublisher (2)
Structs:: GObject.ObjectClass (5)

class	`new` (io, manager, creds, sasl_context, sasl_mechanisms)
	`get_keepalive` ()
	`get_security_policy` ()
	`set_keepalive` (keepalive)
	`set_security_policy` (plcy)

Virtual Methods¶

Inherited:: GObject.Object (7), Infinity.Discovery (7), Infinity.LocalPublisher (2)

Properties¶

Name	Type	Flags	Short Description
`credentials`	`Infinity.CertificateCredentials`	r/w	The GnuTLS certificate credentials used for encrypting XMPP streams
`io`	`Infinity.Io`	r/w/co	The IO object used for watching sockets and timeouts
`keepalive`	`Infinity.Keepalive`	r/w	The keepalive settings for new connections
`sasl-context`	`Infinity.SaslContext`	r/w	The SASL context used for authentication
`sasl-mechanisms`	`str`	r/w	The accepted SASL mechanisms for authentication
`security-policy`	`Infinity.XmppConnectionSecurityPolicy`	r/w	How to decide whether to use TLS
`xmpp-manager`	`Infinity.XmppManager`	r/w/co	The XMPP manager to register resolved XMPP connections

Signals¶

Inherited:: GObject.Object (1), Infinity.Discovery (2)

Fields¶

Inherited:: GObject.Object (1), Infinity.Discovery (2)

Name	Type	Access	Description
parent	`GObject.Object`	r

Class Details¶

class Infinity.DiscoveryAvahi(**kwargs)¶

Bases:: GObject.Object, Infinity.Discovery, Infinity.LocalPublisher
Abstract:: No
Structure:: Infinity.DiscoveryAvahiClass

Infinity.DiscoveryAvahi is an opaque data type. You should only access it via the public API functions.

classmethod new(io, manager, creds, sasl_context, sasl_mechanisms)¶

Parameters:

io (Infinity.Io) – A Infinity.Io object used for watching sockets and timeouts.
manager (Infinity.XmppManager) – A Infinity.XmppManager.
creds (Infinity.CertificateCredentials) – The certificate credentials used for GnuTLS encryption.
sasl_context (Infinity.SaslContext) – A SASL context used for authentication.
sasl_mechanisms (str) – A whitespace-separated list of accepted SASL mechanisms, or None.

Returns:

A new Infinity.DiscoveryAvahi.

Return type:

Infinity.DiscoveryAvahi

Created a new Infinity.DiscoveryAvahi object which can be used to publish and discovery Infinote services on the local network. When resolving a Infinity.DiscoveryInfo (which means obtaining a Infinity.XmlConnection for the discovered service) a new Infinity.XmppConnection needs to be created if there is not already one for the destination host in manager. Such connections are created with the creds and sasl_context parameters. These may be None in which case Infinity.XmppConnection uses builtin credentials or a builtin context, respectively.

If this Infinity.DiscoveryAvahi is not used to discover services but only to publish any, then creds, sasl_context and sasl_mechanisms are ignored and can safely set to be None.

sasl_mechanisms specifies allowed mechanisms used for authentication with the server. It can be None, in which case all available mechanisms are accepted.

get_keepalive()¶

Returns:: A Infinity.Keepalive set for new connections, owned by self.
Return type:: Infinity.Keepalive

Returns the keepalive settings that will be used for new connections.

get_security_policy()¶

Returns:: The current security policy.
Return type:: Infinity.XmppConnectionSecurityPolicy

Returns the current security policy used for new Infinity.XmppConnection s.

set_keepalive(keepalive)¶

Parameters:: keepalive (Infinity.Keepalive) – The new keepalive configuration.

Sets the keepalive settings for newly created connections. It does not affect already existing connections.

set_security_policy(plcy)¶

Parameters:: plcy (Infinity.XmppConnectionSecurityPolicy) – The new security policy.

Sets the Infinity.XmppConnectionSecurityPolicy for newly created Infinity.XmppConnection s. It does not affect already existing connections.

Property Details¶

Infinity.DiscoveryAvahi.props.credentials¶

Name:: credentials
Type:: Infinity.CertificateCredentials
Default Value:: None
Flags:: READABLE, WRITABLE

The GnuTLS certificate credentials used for encrypting XMPP streams

Infinity.DiscoveryAvahi.props.io¶

Name:: io
Type:: Infinity.Io
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

The IO object used for watching sockets and timeouts

Infinity.DiscoveryAvahi.props.keepalive¶

Name:: keepalive
Type:: Infinity.Keepalive
Default Value:: None
Flags:: READABLE, WRITABLE

The keepalive settings for new connections

Infinity.DiscoveryAvahi.props.sasl_context¶

Name:: sasl-context
Type:: Infinity.SaslContext
Default Value:: None
Flags:: READABLE, WRITABLE

The SASL context used for authentication

Infinity.DiscoveryAvahi.props.sasl_mechanisms¶

Name:: sasl-mechanisms
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

The accepted SASL mechanisms for authentication

Infinity.DiscoveryAvahi.props.security_policy¶

Name:: security-policy
Type:: Infinity.XmppConnectionSecurityPolicy
Default Value:: Infinity.XmppConnectionSecurityPolicy.BOTH_PREFER_TLS
Flags:: READABLE, WRITABLE

How to decide whether to use TLS

Infinity.DiscoveryAvahi.props.xmpp_manager¶

Name:: xmpp-manager
Type:: Infinity.XmppManager
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

The XMPP manager to register resolved XMPP connections