package clearcut.connectivity

Get desktop application:
View/edit binary Protocol Buffers messages

Represents the generation of an Android Packet Filter program.

Used in: IpConnectivityEvent

• optional int64 lifetime = 1

  Lifetime of the program in seconds.

• optional int32 filtered_ras = 2

  Number of RAs filtered by the APF program.

• optional int32 current_ras = 3

  Total number of RAs to filter currently tracked by ApfFilter. Can be more than filtered_ras if all available program size was exhausted.

• optional int32 program_length = 4

  Length of the APF program in bytes.

• optional bool drop_multicast = 5

  True if the APF program is dropping multicast and broadcast traffic.

• optional bool has_ipv4_addr = 6

  True if the interface on which APF runs has an IPv4 address.

Represents Router Advertisement listening statistics for an interface with Android Packet Filter enabled.

Used in: IpConnectivityEvent

• optional int64 duration_ms = 1

  The time interval in milliseconds these stastistics cover.

• optional int32 received_ras = 2

  The total number of received RAs.

• optional int32 matching_ras = 3

  The total number of received RAs that matched a known RA.

• optional int32 dropped_ras = 5

  The total number of received RAs ignored due to the MAX_RAS limit.

• optional int32 zero_lifetime_ras = 6

  The total number of received RAs with an effective lifetime of 0 seconds. Effective lifetime for APF is the minimum of all lifetimes in a RA.

• optional int32 parse_errors = 7

  The total number of received RAs that could not be parsed.

• optional int32 program_updates = 8

  The total number of APF program updates triggered by an RA reception.

• optional int32 max_program_size = 9

  The maximum APF program size in byte advertised by hardware.

Represents a DHCP event on a single interface, which can be a DHCPClient state transition or a response packet parsing error. This message is associated to android.net.metrics.DhcpClientEvent and android.net.metrics.DhcpErrorEvent.

Used in: IpConnectivityEvent

• optional string if_name = 1

  The interface name (wlan, rmnet, lo, ...) on which the event happened.

• oneof value

  • string state_transition = 2

    The name of a state in the DhcpClient state machine, represented by the inner classes of android.net.dhcp.DhcpClient.

  • int32 error_code = 3

    The error code of a DHCP error, represented by constants defined in android.net.metrics.DhcpErrorEvent.

• optional int32 duration_ms = 4

  Lifetime duration in milliseconds of a DhcpClient state, or transition time in milliseconds between specific pairs of DhcpClient's states. Only populated when state_transition is populated.

Logs DNS lookup latencies. Repeated fields must have the same length. This message is associated to android.net.metrics.DnsEvent.

Used in: IpConnectivityEvent

• optional NetworkId network_id = 1

  The id of the network on which the DNS lookups took place.

• repeated int32 event_types = 2

  The types of the DNS lookups, as defined in android.net.metrics.DnsEvent.

• repeated int32 return_codes = 3

  The return values of the DNS resolver for each DNS lookups.

• repeated int32 latencies_ms = 4

  The time it took for each DNS lookups to complete.

Logs changes in the system default network. Changes can be 1) acquiring a default network with no previous default, 2) a switch of the system default network to a new default network, 3) a loss of the system default network. This message is associated to android.net.metrics.DefaultNetworkEvent.

Used in: IpConnectivityEvent

• optional NetworkId network_id = 1

  A value of 0 means this is a loss of the system default network.

• optional NetworkId previous_network_id = 2

  A value of 0 means there was no previous default network.

• optional DefaultNetworkEvent.IPSupport previous_network_ip_support = 3

  Best available information about IP support of the previous network when disconnecting or switching to a new default network.

• repeated int32 transport_types = 4

  The transport types of the new default network, represented by TRANSPORT_* constants as defined in NetworkCapabilities.

Whether the network supports IPv4, IPv6, or both.

Used in: DefaultNetworkEvent

• NONE = 0

• IPV4 = 1

• IPV6 = 2

• DUAL = 3

Represents one of the IP connectivity event defined in this file. Next tag: 12

Used in: IpConnectivityLog

• optional int64 time_ms = 1

  Time in ms when the event was recorded.

• oneof event

  Event type.

  • DefaultNetworkEvent default_network_event = 2

    An event about the system default network.

  • IpReachabilityEvent ip_reachability_event = 3

    An IP reachability probe event.

  • NetworkEvent network_event = 4

    A network lifecycle event.

  • DNSLookupBatch dns_lookup_batch = 5

    A batch of DNS lookups.

  • DHCPEvent dhcp_event = 6

    A DHCP client event or DHCP receive error.

  • IpProvisioningEvent ip_provisioning_event = 7

    An IP provisioning event.

  • ValidationProbeEvent validation_probe_event = 8

    A network validation probe event.

  • ApfProgramEvent apf_program_event = 9

    An Android Packet Filter program event.

  • ApfStatistics apf_statistics = 10

    An Android Packet Filter statistics event.

  • RaEvent ra_event = 11

    An RA packet reception event.

The information about IP connectivity events.

• repeated IpConnectivityEvent events = 1

  An array of IP connectivity events.

• optional int32 dropped_events = 2

  The number of events that had to be dropped due to a full buffer.

Represents an IP provisioning event in IpManager and how long the provisioning action took. This message is associated to android.net.metrics.IpManagerEvent.

Used in: IpConnectivityEvent

• optional string if_name = 1

  The interface name (wlan, rmnet, lo, ...) on which the probe was sent.

• optional int32 event_type = 2

  The code of the IP provisioning event, represented by constants defined in android.net.metrics.IpManagerEvent.

• optional int32 latency_ms = 3

  The duration of the provisioning action that resulted in this event.

Logs IpReachabilityMonitor probe events and NUD_FAILED events. This message is associated to android.net.metrics.IpReachabilityEvent.

Used in: IpConnectivityEvent

• optional string if_name = 1

  The interface name (wlan, rmnet, lo, ...) on which the probe was sent.

• optional int32 event_type = 2

  The event type code of the probe, represented by constants defined in android.net.metrics.IpReachabilityEvent.

Logs NetworkMonitor and ConnectivityService events related to the state of a network: connection, evaluation, validation, lingering, and disconnection. This message is associated to android.net.metrics.NetworkEvent.

Used in: IpConnectivityEvent

• optional NetworkId network_id = 1

  The id of the network on which this event happened.

• optional int32 event_type = 2

  The type of network event, represented by NETWORK_* constants defined in android.net.metrics.NetworkEvent.

• optional int32 latency_ms = 3

  Only valid after finishing evaluating a network for Internet connectivity. The time it took for this evaluation to complete.

NetworkId represents the id given by the system to a physical network on the Android device. It is used to relates events to each other for devices with multiple networks (WiFi, 4G, ...).

Used in: DNSLookupBatch, DefaultNetworkEvent, NetworkEvent, ValidationProbeEvent

• optional int32 network_id = 1

  Every network gets assigned a network_id on creation based on order of creation. Thus network_id N is assigned to the network created directly after network N-1. Thus there is no PII involved here. Zero means no network. The value 0 is never assigned to a network.

Represents the reception of a Router Advertisement packet for an interface with Android Packet Filter enabled.

All lifetime values are expressed in seconds. The default value for an option lifetime that was not present in the RA option list is -1. The lifetime of an option (e.g., the Prefix Information Option) is the minimum lifetime of all such options in the packet.

Used in: IpConnectivityEvent

• optional int64 router_lifetime = 1

  The value of the router lifetime in the RA packet.

• optional int64 prefix_valid_lifetime = 2

  Prefix valid lifetime from the prefix information option.

• optional int64 prefix_preferred_lifetime = 3

  Prefix preferred lifetime from the prefix information option.

• optional int64 route_info_lifetime = 4

  Route info lifetime.

• optional int64 rdnss_lifetime = 5

  Recursive DNS server lifetime.

• optional int64 dnssl_lifetime = 6

  DNS search list lifetime.

Logs individual captive portal probing events that are performed when evaluating or reevaluating networks for Internet connectivity. This message is associated to android.net.metrics.ValidationProbeEvent.

Used in: IpConnectivityEvent

• optional NetworkId network_id = 1

  The id of the network for which the probe was sent.

• optional int32 latency_ms = 2

  The time it took for that probe to complete or time out.

• optional int32 probe_type = 3

  The type of portal probe, represented by PROBE_* constants defined in android.net.metrics.ValidationProbeEvent.

• optional int32 probe_result = 4

  The http code result of the probe test.