Struct DtlsServerConnection

Source

pub struct DtlsServerConnection { /* private fields */ }

Expand description

GDtlsServerConnection is the server-side subclass of DtlsConnection, representing a server-side DTLS connection.

§Properties

§`authentication-mode`

The #GTlsAuthenticationMode for the server. This can be changed before calling g_dtls_connection_handshake() if you want to rehandshake with a different mode from the initial handshake.

Readable | Writeable

DtlsConnection

§`advertised-protocols`

The list of application-layer protocols that the connection advertises that it is willing to speak. See g_dtls_connection_set_advertised_protocols().

Readable | Writeable

§`base-socket`

The #GDatagramBased that the connection wraps. Note that this may be any implementation of #GDatagramBased, not just a #GSocket.

Readable | Writeable | Construct Only

§`certificate`

The connection’s certificate; see g_dtls_connection_set_certificate().

Readable | Writeable

§`ciphersuite-name`

The name of the DTLS ciphersuite in use. See g_dtls_connection_get_ciphersuite_name().

Readable

§`database`

The certificate database to use when verifying this TLS connection. If no certificate database is set, then the default database will be used. See g_tls_backend_get_default_database().

When using a non-default database, #GDtlsConnection must fall back to using the #GTlsDatabase to perform certificate verification using g_tls_database_verify_chain(), which means certificate verification will not be able to make use of TLS session context. This may be less secure. For example, if you create your own #GTlsDatabase that just wraps the default #GTlsDatabase, you might expect that you have not changed anything, but this is not true because you may have altered the behavior of #GDtlsConnection by causing it to use g_tls_database_verify_chain(). See the documentation of g_tls_database_verify_chain() for more details on specific security checks that may not be performed. Accordingly, setting a non-default database is discouraged except for specialty applications with unusual security requirements.

Readable | Writeable

§`interaction`

A #GTlsInteraction object to be used when the connection or certificate database need to interact with the user. This will be used to prompt the user for passwords where necessary.

Readable | Writeable

§`negotiated-protocol`

The application-layer protocol negotiated during the TLS handshake. See g_dtls_connection_get_negotiated_protocol().

Readable

§`peer-certificate`

The connection’s peer’s certificate, after the TLS handshake has completed or failed. Note in particular that this is not yet set during the emission of #GDtlsConnection::accept-certificate.

(You can watch for a #GObject::notify signal on this property to detect when a handshake has occurred.)

Readable

§`peer-certificate-errors`

The errors noticed while verifying #GDtlsConnection:peer-certificate. Normally this should be 0, but it may not be if #GDtlsClientConnection:validation-flags is not TlsCertificateFlags::VALIDATE_ALL, or if #GDtlsConnection::accept-certificate overrode the default behavior.

GLib guarantees that if certificate verification fails, at least one error will be set, but it does not guarantee that all possible errors will be set. Accordingly, you may not safely decide to ignore any particular type of error. For example, it would be incorrect to mask TlsCertificateFlags::EXPIRED if you want to allow expired certificates, because this could potentially be the only error flag set even if other problems exist with the certificate.

Readable

§`protocol-version`

The DTLS protocol version in use. See g_dtls_connection_get_protocol_version().

Readable

§`rehandshake-mode`

The rehandshaking mode. See g_dtls_connection_set_rehandshake_mode().

Readable | Writeable | Construct

§`require-close-notify`

Whether or not proper TLS close notification is required. See g_dtls_connection_set_require_close_notify().

Readable | Writeable | Construct

§Implements

DtlsServerConnectionExt, DatagramBasedExt, DtlsConnectionExt, DatagramBasedExtManual

GLib type: GObject with reference counted clone semantics.

Struct DtlsServerConnectionCopy item path

§Properties

§authentication-mode

DtlsConnection

§advertised-protocols

§base-socket

§certificate

§ciphersuite-name

§database

§interaction

§negotiated-protocol

§peer-certificate

§peer-certificate-errors

§protocol-version

§rehandshake-mode

§require-close-notify

§Implements

Implementations§

impl DtlsServerConnection

pub const NONE: Option<&'static DtlsServerConnection> = None

pub fn new( base_socket: &impl IsA<DatagramBased>, certificate: Option<&impl IsA<TlsCertificate>>, ) -> Result<DtlsServerConnection, Error>

§base_socket

§certificate

§Returns

Trait Implementations§

impl Clone for DtlsServerConnection

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl Debug for DtlsServerConnection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl HasParamSpec for DtlsServerConnection

type ParamSpec = ParamSpecObject

type SetValue = DtlsServerConnection

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, DtlsServerConnection>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for DtlsServerConnection

fn hash<H>(&self, state: &mut H)where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

impl Ord for DtlsServerConnection

fn cmp(&self, other: &Self) -> Ordering

fn max(self, other: Self) -> Selfwhere Self: Sized,

fn min(self, other: Self) -> Selfwhere Self: Sized,

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized,

impl<OT: ObjectType> PartialEq<OT> for DtlsServerConnection

fn eq(&self, other: &OT) -> bool

fn ne(&self, other: &Rhs) -> bool

impl<OT: ObjectType> PartialOrd<OT> for DtlsServerConnection

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

fn lt(&self, other: &Rhs) -> bool

fn le(&self, other: &Rhs) -> bool

fn gt(&self, other: &Rhs) -> bool

fn ge(&self, other: &Rhs) -> bool

impl StaticType for DtlsServerConnection

fn static_type() -> Type

impl Eq for DtlsServerConnection

impl IsA<DatagramBased> for DtlsServerConnection

impl IsA<DtlsConnection> for DtlsServerConnection

Auto Trait Implementations§

impl Freeze for DtlsServerConnection

impl RefUnwindSafe for DtlsServerConnection

impl !Send for DtlsServerConnection

impl !Sync for DtlsServerConnection

impl Unpin for DtlsServerConnection

impl UnwindSafe for DtlsServerConnection

Blanket Implementations§

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> Cast for Twhere T: ObjectType,

fn upcast<T>(self) -> Twhere T: ObjectType, Self: IsA<T>,

fn upcast_ref<T>(&self) -> &Twhere T: ObjectType, Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self>where T: ObjectType, Self: MayDowncastTo<T>,

fn downcast_ref<T>(&self) -> Option<&T>where T: ObjectType, Self: MayDowncastTo<T>,

fn dynamic_cast<T>(self) -> Result<T, Self>where T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T>where T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> Twhere T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &Twhere T: ObjectType,

Struct DtlsServerConnection

§`authentication-mode`

§`advertised-protocols`

§`base-socket`

§`certificate`

§`ciphersuite-name`

§`database`

§`interaction`

§`negotiated-protocol`

§`peer-certificate`

§`peer-certificate-errors`

§`protocol-version`

§`rehandshake-mode`

§`require-close-notify`

§`base_socket`

§`certificate`

fn hash<H>(&self, state: &mut H)
where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

fn max(self, other: Self) -> Self
where Self: Sized,

fn min(self, other: Self) -> Self
where Self: Sized,

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<T> Cast for T
where T: ObjectType,

fn upcast<T>(self) -> T
where T: ObjectType, Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T
where T: ObjectType, Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self>
where T: ObjectType, Self: MayDowncastTo<T>,

fn downcast_ref<T>(&self) -> Option<&T>
where T: ObjectType, Self: MayDowncastTo<T>,

fn dynamic_cast<T>(self) -> Result<T, Self>
where T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T>
where T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T
where T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T
where T: ObjectType,

impl<T> CloneToUninit for T
where T: Clone,

impl<O> DatagramBasedExt for O
where O: IsA<DatagramBased>,

impl<O> DatagramBasedExtManual for O
where O: IsA<DatagramBased>,

fn create_source<F, C>( &self, condition: IOCondition, cancellable: Option<&C>, name: Option<&str>, priority: Priority, func: F, ) -> Source
where F: FnMut(&Self, IOCondition) -> ControlFlow + 'static, C: IsA<Cancellable>,

impl<O> DtlsConnectionExt for O
where O: IsA<DtlsConnection>,

impl<O> DtlsServerConnectionExt for O
where O: IsA<DtlsServerConnection>,

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,