Trait wasmtime_wasi::bindings::sockets::ip_name_lookup::Host

pub trait Host: Send + HostResolveAddressStream {
    // Required method
    fn resolve_addresses(
        &mut self,
        network: Resource<Network>,
        name: String,
    ) -> Result<Resource<ResolveAddressStream>, SocketError>;
}

Required Methods

fn resolve_addresses( &mut self, network: Resource<Network>, name: String, ) -> Result<Resource<ResolveAddressStream>, SocketError>

Resolve an internet host name to a list of IP addresses.

Unicode domain names are automatically converted to ASCII using IDNA encoding. If the input is an IP address string, the address is parsed and returned as-is without making any external requests.

See the wasi-socket proposal README.md for a comparison with getaddrinfo.

This function never blocks. It either immediately fails or immediately returns successfully with a resolve-address-stream that can be used to (asynchronously) fetch the results.

Typical errors

• invalid-argument: name is a syntactically invalid domain name or IP address.

References:

• https://pubs.opengroup.org/onlinepubs/9699919799/functions/getaddrinfo.html
• https://man7.org/linux/man-pages/man3/getaddrinfo.3.html
• https://learn.microsoft.com/en-us/windows/win32/api/ws2tcpip/nf-ws2tcpip-getaddrinfo
• https://man.freebsd.org/cgi/man.cgi?query=getaddrinfo&sektion=3

Implementations on Foreign Types

impl<_T: Host + ?Sized + Send> Host for &mut _T

fn resolve_addresses( &mut self, network: Resource<Network>, name: String, ) -> Result<Resource<ResolveAddressStream>, SocketError>

Resolve an internet host name to a list of IP addresses.

Unicode domain names are automatically converted to ASCII using IDNA encoding. If the input is an IP address string, the address is parsed and returned as-is without making any external requests.

See the wasi-socket proposal README.md for a comparison with getaddrinfo.

This function never blocks. It either immediately fails or immediately returns successfully with a resolve-address-stream that can be used to (asynchronously) fetch the results.

Typical errors

• invalid-argument: name is a syntactically invalid domain name or IP address.

References:

• https://pubs.opengroup.org/onlinepubs/9699919799/functions/getaddrinfo.html
• https://man7.org/linux/man-pages/man3/getaddrinfo.3.html
• https://learn.microsoft.com/en-us/windows/win32/api/ws2tcpip/nf-ws2tcpip-getaddrinfo
• https://man.freebsd.org/cgi/man.cgi?query=getaddrinfo&sektion=3

Implementors

impl<T> Host for WasiImpl<T>

where T: WasiView,