DtlsConnection

---

Object Hierarchy:

Description:

Content:

Properties:

• public abstract string[] advertised_protocols { owned get; set; }
  The list of application-layer protocols that the connection advertises that it is willing to speak.
• public abstract DatagramBased base_socket { owned get; construct; }
  The DatagramBased that the connection wraps.
• public abstract TlsCertificate certificate { get; set; }
  The connection's certificate; see set_certificate.
• public abstract string ciphersuite_name { owned get; }
  The name of the DTLS ciphersuite in use.
• public abstract TlsDatabase database { get; set; }
  The certificate database to use when verifying this TLS connection.
• public abstract TlsInteraction interaction { get; set; }
  A TlsInteraction object to be used when the connection or certificate database need to interact with the user.
• public abstract string negotiated_protocol { get; }
  The application-layer protocol negotiated during the TLS handshake.
• public abstract TlsCertificate peer_certificate { get; }
  The connection's peer's certificate, after the TLS handshake has completed or failed.
• public abstract TlsCertificateFlags peer_certificate_errors { get; }
  The errors noticed while verifying peer_certificate.
• public abstract TlsProtocolVersion protocol_version { get; }
  The DTLS protocol version in use.
• public abstract TlsRehandshakeMode rehandshake_mode { get; set construct; }
  The rehandshaking mode.
• public abstract bool require_close_notify { get; set construct; }
  Whether or not proper TLS close notification is required.

Methods:

• public bool close (Cancellable? cancellable = null) throws Error
  Close the DTLS connection.
• public async bool close_async (int io_priority = DEFAULT, Cancellable? cancellable = null) throws Error
  Asynchronously close the DTLS connection.
• public bool emit_accept_certificate (TlsCertificate peer_cert, TlsCertificateFlags errors)
  Used by DtlsConnection implementations to emit the accept_certificate signal.
• public unowned TlsCertificate? get_certificate ()
  Gets this's certificate, as set by set_certificate.
• public virtual bool get_channel_binding_data (TlsChannelBindingType type, out unowned ByteArray data) throws TlsChannelBindingError
  Query the TLS backend for TLS channel binding data of type for this.
• public string? get_ciphersuite_name ()
  Returns the name of the current DTLS ciphersuite, or null if the connection has not handshaked or has been closed.
• public unowned TlsDatabase? get_database ()
  Gets the certificate database that this uses to verify peer certificates.
• public unowned TlsInteraction? get_interaction ()
  Get the object that will be used to interact with the user.
• public abstract unowned string? get_negotiated_protocol ()
  Gets the name of the application-layer protocol negotiated during the handshake.
• public unowned TlsCertificate? get_peer_certificate ()
  Gets this's peer's certificate after the handshake has completed or failed.
• public TlsCertificateFlags get_peer_certificate_errors ()
  Gets the errors associated with validating this's peer's certificate, after the handshake has completed or failed.
• public TlsProtocolVersion get_protocol_version ()
  Returns the current DTLS protocol version, which may be g_tls_protocol_version_unknown if the connection has not handshaked, or has been closed, or if the TLS backend has implemented a protocol version that is not a recognized TlsProtocolVersion.
• public TlsRehandshakeMode get_rehandshake_mode ()
  Gets this rehandshaking mode.
• public bool get_require_close_notify ()
  Tests whether or not this expects a proper TLS close notification when the connection is closed.
• public abstract bool handshake (Cancellable? cancellable = null) throws Error
  Attempts a TLS handshake on this.
• public abstract async bool handshake_async (int io_priority = DEFAULT, Cancellable? cancellable = null) throws Error
  Asynchronously performs a TLS handshake on this.
• public abstract void set_advertised_protocols (string[]? protocols)
  Sets the list of application-layer protocols to advertise that the caller is willing to speak on this connection.
• public void set_certificate (TlsCertificate certificate)
  This sets the certificate that this will present to its peer during the TLS handshake.
• public void set_database (TlsDatabase? database)
  Sets the certificate database that is used to verify peer certificates.
• public void set_interaction (TlsInteraction? interaction)
  Set the object that will be used to interact with the user.
• public void set_rehandshake_mode (TlsRehandshakeMode mode)
  Since GLib 2.64, changing the rehandshake mode is no longer supported and will have no effect.
• public void set_require_close_notify (bool require_close_notify)
  Sets whether or not this expects a proper TLS close notification before the connection is closed.
• public abstract bool shutdown (bool shutdown_read, bool shutdown_write, Cancellable? cancellable = null) throws Error
  Shut down part or all of a DTLS connection.
• public abstract async bool shutdown_async (bool shutdown_read, bool shutdown_write, int io_priority = DEFAULT, Cancellable? cancellable = null) throws Error
  Asynchronously shut down part or all of the DTLS connection.

Signals:

• public virtual signal bool accept_certificate (TlsCertificate peer_cert, TlsCertificateFlags errors)
  Emitted during the TLS handshake after the peer certificate has been received.

Inherited Members: