fuchsia.net

PROTOCOLS

NameLookup

Defined in fuchsia.net/namelookup.fidl

DEPRECATED - Use fuchsia.net.name.Lookup

LookupHostname

Look up a hostname by IP address.

Request

Name	Type
`addr`	`IpAddress`

Response

Name	Type
`result`	`NameLookup_LookupHostname_Result`

LookupIp2

Lookup a list of IP addresses by hostname.

If hostname is an Internationalized Domain Name, it must be encoded as per RFC 3490.

Request

Name	Type
`hostname`	`Hostname`
`options`	`LookupIpOptions2`

Response

Name	Type
`result`	`NameLookup_LookupIp2_Result`

STRUCTS

Ipv4Address

Defined in fuchsia.net/net.fidl

Ipv4Address is expressed in network byte order, so the most significant byte ("127" in the address "127.0.0.1") will be at index 0.

Field	Type	Description	Default
`addr`	`uint8[4]`		No default

Ipv4AddressWithPrefix

Defined in fuchsia.net/net.fidl

An IPv4 address with its subnet prefix length.

Field	Type	Description	Default
`addr`	`Ipv4Address`	The IPv4 address.	No default
`prefix_len`	`uint8`	The prefix length. Must be in the range [0, 32].	No default

Ipv4SocketAddress

Defined in fuchsia.net/socket.fidl

An IPv4 socket address, composed of an IPv4 address and a port.

Inspired by the address definition in the POSIX specification.

Field	Type	Description	Default
`address`	`Ipv4Address`	IPv4 Address.	No default
`port`	`uint16`	Transport-layer port.	No default

Ipv6Address

Defined in fuchsia.net/net.fidl

Ipv6Address is expressed in network byte order, so the most significant byte ("ff" in the address "ff02::1") will be at index 0.

Field	Type	Description	Default
`addr`	`uint8[16]`		No default

Ipv6AddressWithPrefix

Defined in fuchsia.net/net.fidl

An IPv6 address with its subnet prefix length.

Field	Type	Description	Default
`addr`	`Ipv6Address`	The IPv6 address.	No default
`prefix_len`	`uint8`	The prefix length. Must be in the range [0, 128].	No default

Ipv6SocketAddress

Defined in fuchsia.net/socket.fidl

An IPV6 socket address, composed of an IPv6 address, a port, and a scope identifier.

Inspired by the address definition in the POSIX specification.

Field Type Description Default

Field	Type	Description	Default
`address`	`Ipv6Address`	IPv6 Address.	No default
`port`	`uint16`	Transport-layer port.	No default
`zone_index`	`interface_id`	Provides a means to identify to which zone a non-global address belongs. A node may have interfaces attached to different zones of the same scope, for example different link-local zones are disambiguated by the use of a `zone_index` providing the interface identifier. `zone_index` 0 is the default zone. See RFC 4007 for terminology and examples.	No default

address

Ipv6Address

IPv6 Address.

No default

port

uint16

Transport-layer port.

No default

zone_index

interface_id

Provides a means to identify to which zone a non-global address belongs.

A node may have interfaces attached to different zones of the same scope, for example different link-local zones are disambiguated by the use of a zone_index providing the interface identifier.

zone_index 0 is the default zone.

See RFC 4007 for terminology and examples.

No default

MacAddress

Defined in fuchsia.net/net.fidl

A MAC address used to identify a network interface on the data link layer within the network.

Field	Type	Description	Default
`octets`	`uint8[6]`		No default

NameLookup_LookupHostname_Response

Defined in fuchsia.net/namelookup.fidl

Field	Type	Description	Default
`hostname`	`Hostname`		No default

NameLookup_LookupIp2_Response

Defined in fuchsia.net/namelookup.fidl

Field	Type	Description	Default
`result`	`LookupResult`		No default

Subnet

Defined in fuchsia.net/net.fidl

An IP address with its subnet prefix length.

Field	Type	Description	Default
`addr`	`IpAddress`	The IPv4 or IPv6 address.	No default
`prefix_len`	`uint8`	The prefix length of the netmask. E.g. for 192.168.1.0/24, the prefix length is 24, corresponding to a netmask of 255.255.255.0. For Ipv4, prefix_len must be in the range [0, 32]. For Ipv6, prefix_len must be in the range [0, 128].	No default

ENUMS

IpVersion strict

Type: uint32

Defined in fuchsia.net/net.fidl

IpVersion is an IP version.

Name	Value	Description
`V4`	`1`
`V6`	`2`

LookupError strict

Type: uint32

Defined in fuchsia.net/namelookup.fidl

Name	Value	Description
`NOT_FOUND`	`1`	No result was found for this query.
`TRANSIENT`	`2`	The lookup failed, but may succeed at a later time. For instance, the network or DNS server may be unreachable.
`INVALID_ARGS`	`3`	The lookup failed due to an invalid argument (for instance, the hostname was not encoded correctly, or was too long).
`INTERNAL_ERROR`	`4`	The lookup failed due to an internal error.

TABLES

LookupIpOptions2

Defined in fuchsia.net/namelookup.fidl

Lookup operation options.

Ordinal Field Type Description

Ordinal	Field	Type	Description
1	`ipv4_lookup`	`bool`	Include IPv4 results. Defaults to false.
2	`ipv6_lookup`	`bool`	Include IPv6 results. Defaults to false.
3	`sort_addresses`	`bool`	Sort addresses in order of preference. It true, Addresses are sorted according to destination address selection described in RFC 6724 Section 6. Defaults to false.

ipv4_lookup

bool

Include IPv4 results. Defaults to false.

ipv6_lookup

bool

Include IPv6 results. Defaults to false.

sort_addresses

bool

Sort addresses in order of preference.

It true, Addresses are sorted according to destination address selection described in RFC 6724 Section 6.

Defaults to false.

LookupResult

Defined in fuchsia.net/namelookup.fidl

The result of a lookup operation.

Ordinal Field Type Description

Ordinal	Field	Type	Description
1	`addresses`	`vector<IpAddress>`	The IP addresses resulting from a lookup. If sorting was requested, `addresses` is sorted in order of preference, most preferred destination address first.

addresses

vector<IpAddress>

The IP addresses resulting from a lookup.

If sorting was requested, addresses is sorted in order of preference, most preferred destination address first.

UNIONS

InterfaceAddress strict

Defined in fuchsia.net/net.fidl

An address that can be assigned to a network interface.

Ordinal

Variant Type Description

Ordinal
Variant	Type	Description
1	`ipv4`	`Ipv4AddressWithPrefix`	An IPv4 address with the prefix length. The prefix length is necessary to determine the subnet to which an IPv4 address belongs so that the broadcast address can be inferred.
2	`ipv6`	`Ipv6Address`	An IPv6 address. Note that the prefix length is not included because on-link information for IPv6 should be configured statically via a a route or be discovered through NDP messages.

ipv4

Ipv4AddressWithPrefix

An IPv4 address with the prefix length.

The prefix length is necessary to determine the subnet to which an IPv4 address belongs so that the broadcast address can be inferred.

ipv6

Ipv6Address

An IPv6 address.

Note that the prefix length is not included because on-link information for IPv6 should be configured statically via a a route or be discovered through NDP messages.

IpAddress strict

Defined in fuchsia.net/net.fidl

Represents an IP address that may be either v4 or v6.

Ordinal
Variant	Type	Description
1	`ipv4`	`Ipv4Address`
2	`ipv6`	`Ipv6Address`

NameLookup_LookupHostname_Result strict

Defined in fuchsia.net/namelookup.fidl

Ordinal
Variant	Type	Description
1	`response`	`NameLookup_LookupHostname_Response`
2	`err`	`LookupError`

NameLookup_LookupIp2_Result strict

Defined in fuchsia.net/namelookup.fidl

Ordinal
Variant	Type	Description
1	`response`	`NameLookup_LookupIp2_Response`
2	`err`	`LookupError`

SocketAddress strict

Defined in fuchsia.net/socket.fidl

Represents an IP socket address that may be either v4 or v6.

Ordinal
Variant	Type	Description
1	`ipv4`	`Ipv4SocketAddress`
2	`ipv6`	`Ipv6SocketAddress`

CONSTANTS

Name	Value	Type	Description
MAX_HOSTNAME_SIZE	`255`	`uint64`	The maximum length of a hostname, as per RFC 1035 section 2.3.4.

TYPE ALIASES

Name Value Description

Name	Value	Description
Hostname	`string`[`MAX_HOSTNAME_SIZE`]	A hostname. Although the maximum length of a domain or hostname is 255 characters, each label within a name must not be longer than 63 characters as per RFC 1035 section 2.3.4. A label in a host name is the alphanumeric characters or hyphens, seperated by a period (e.g. abc.com has two labels, 'abc' and 'com').
interface_id	`uint64`	A unique non-zero interface identifier.

Hostname

string[MAX_HOSTNAME_SIZE]

A hostname.

Although the maximum length of a domain or hostname is 255 characters, each label within a name must not be longer than 63 characters as per RFC 1035 section 2.3.4. A label in a host name is the alphanumeric characters or hyphens, seperated by a period (e.g. abc.com has two labels, 'abc' and 'com').

interface_id

uint64

A unique non-zero interface identifier.