Struct gio::SrvTarget

#[repr(transparent)]
pub struct SrvTarget { /* private fields */ }

SRV (service) records are used by some network protocols to provide service-specific aliasing and load-balancing. For example, XMPP (Jabber) uses SRV records to locate the XMPP server for a domain; rather than connecting directly to “example.com” or assuming a specific server hostname like “xmpp.example.com”, an XMPP client would look up the “xmpp-client” SRV record for “example.com”, and then connect to whatever host was pointed to by that record.

You can use ResolverExt::lookup_service() or ResolverExt::lookup_service_async() to find the GSrvTargets for a given service. However, if you are simply planning to connect to the remote service, you can use NetworkService’s SocketConnectable interface and not need to worry about SrvTarget at all.

Implementations

impl SrvTarget

pub fn new(hostname: &str, port: u16, priority: u16, weight: u16) -> SrvTarget

Creates a new SrvTarget with the given parameters.

You should not need to use this; normally GSrvTargets are created by Resolver.

hostname

the host that the service is running on

port

the port that the service is running on

priority

the target’s priority

weight

the target’s weight

Returns

a new SrvTarget.

pub fn hostname(&mut self) -> GString

Gets self’s hostname (in ASCII form; if you are going to present this to the user, you should use g_hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use g_hostname_to_unicode() to convert it if it does.)

Returns

self’s hostname

pub fn port(&mut self) -> u16

Gets self’s port

Returns

self’s port

pub fn priority(&mut self) -> u16

Gets self’s priority. You should not need to look at this; Resolver already sorts the targets according to the algorithm in RFC 2782.

Returns

self’s priority

pub fn weight(&mut self) -> u16

Gets self’s weight. You should not need to look at this; Resolver already sorts the targets according to the algorithm in RFC 2782.

Returns

self’s weight

Trait Implementations

impl Clone for SrvTarget

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SrvTarget

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

Formats the value using the given formatter.

impl Hash for SrvTarget

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl Ord for SrvTarget

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<SrvTarget> for SrvTarget

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<SrvTarget> for SrvTarget

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

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for SrvTarget

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for SrvTarget

impl StructuralEq for SrvTarget

impl StructuralPartialEq for SrvTarget