package proto.daemon.v1

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc AS (ASRequest, ASResponse)

  daemon.proto:29

  Return information about an AS.

  message ASRequest

  daemon.proto:143

  • uint64 isd_as = 1

    ISD-AS of the AS information is requested about. The 0 value can be used to discover the ISD-AS number of the local AS.

  message ASResponse

  daemon.proto:149

  • uint64 isd_as = 1

    ISD-AS of the AS information was requested about.

  • bool core = 2

    Indicates whether the local AS is core.

  • uint32 mtu = 3

    The maximum transmission unit (MTU) in the local AS.

• rpc DRKeyASHost (DRKeyASHostRequest, DRKeyASHostResponse)

  daemon.proto:39

  DRKeyASHost returns a key that matches the request.

  message DRKeyASHostRequest

  daemon.proto:225

  • optional google.protobuf.Timestamp val_time = 1

    Point in time where requested key is valid.

  • drkey.v1.Protocol protocol_id = 2

    Protocol value.

  • uint64 src_ia = 3

    Src ISD-AS of the requested DRKey.

  • uint64 dst_ia = 4

    Dst ISD-AS of the requested DRKey.

  • string dst_host = 5

    Dst Host of the request DRKey.

  message DRKeyASHostResponse

  daemon.proto:238

  • optional google.protobuf.Timestamp epoch_begin = 1

    Begin of validity period of DRKey.

  • optional google.protobuf.Timestamp epoch_end = 2

    End of validity period of DRKey.

  • bytes key = 3

    Level2 key.

• rpc DRKeyHostAS (DRKeyHostASRequest, DRKeyHostASResponse)

  daemon.proto:41

  DRKeyHostAS returns a key that matches the request.

  message DRKeyHostASRequest

  daemon.proto:203

  • optional google.protobuf.Timestamp val_time = 1

    Point in time where requested key is valid.

  • drkey.v1.Protocol protocol_id = 2

    Protocol value.

  • uint64 src_ia = 3

    Src ISD-AS of the requested DRKey.

  • uint64 dst_ia = 4

    Dst ISD-AS of the requested DRKey.

  • string src_host = 5

    Src Host of the request DRKey.

  message DRKeyHostASResponse

  daemon.proto:216

  • optional google.protobuf.Timestamp epoch_begin = 1

    Begin of validity period of DRKey.

  • optional google.protobuf.Timestamp epoch_end = 2

    End of validity period of DRKey.

  • bytes key = 3

    Level2 key.

• rpc DRKeyHostHost (DRKeyHostHostRequest, DRKeyHostHostResponse)

  daemon.proto:43

  DRKeyHostHost returns a key that matches the request.

  message DRKeyHostHostRequest

  daemon.proto:247

  • optional google.protobuf.Timestamp val_time = 1

    Point in time where requested key is valid.

  • drkey.v1.Protocol protocol_id = 2

    Protocol value.

  • uint64 src_ia = 3

    Src ISD-AS of the requested DRKey.

  • uint64 dst_ia = 4

    Dst ISD-AS of the requested DRKey.

  • string src_host = 5

    Src Host of the request DRKey.

  • string dst_host = 6

    Dst Host of the request DRKey.

  message DRKeyHostHostResponse

  daemon.proto:262

  • optional google.protobuf.Timestamp epoch_begin = 1

    Begin of validity period of DRKey.

  • optional google.protobuf.Timestamp epoch_end = 2

    End of validity period of DRKey.

  • bytes key = 3

    Level2 key.

• rpc Interfaces (InterfacesRequest, InterfacesResponse)

  daemon.proto:32

  Return the underlay addresses associated with the specified interfaces.

  message InterfacesRequest

  daemon.proto:158

  (message has no fields)

  message InterfacesResponse

  daemon.proto:160

  • map<uint64, Interface> interfaces = 1

    Map from SCION interface IDs in the local AS to interface details.

• rpc NotifyInterfaceDown (NotifyInterfaceDownRequest, NotifyInterfaceDownResponse)

  daemon.proto:37

  Inform the SCION Daemon of a revocation.

  message NotifyInterfaceDownRequest

  daemon.proto:194

  • uint64 isd_as = 1

    ISD-AS the failing interface belongs to.

  • uint64 id = 2

    ID of the failing interface.

  message NotifyInterfaceDownResponse

  daemon.proto:201

  (message has no fields)

• rpc Paths (PathsRequest, PathsResponse)

  daemon.proto:27

  Return a set of paths to the requested destination.

  message PathsRequest

  daemon.proto:46

  • uint64 source_isd_as = 1

    ISD-AS of the source of the path request.

  • uint64 destination_isd_as = 2

    ISD-AS of the destination of the path request.

  • bool refresh = 3

    Choose to fetch fresh paths for this request instead of having the server reply from its cache.

  • bool hidden = 4

    Request hidden paths instead of standard paths.

  message PathsResponse

  daemon.proto:58

  • repeated Path paths = 1

    List of paths found by the daemon.

• rpc Services (ServicesRequest, ServicesResponse)

  daemon.proto:35

  Return the underlay addresses associated with the specified services.

  message ServicesRequest

  daemon.proto:170

  (message has no fields)

  message ServicesResponse

  daemon.proto:172

  • map<string, ListService> services = 1

    Map from service names to known services.

Used in: Path

• bytes auth_phvf = 1

  AuthPHVF is the authenticator use to calculate the PHVF.

• bytes auth_lhvf = 2

  AuthLHVF is the authenticator use to calculate the LHVF.

Used in: Path

• float latitude = 1

  Latitude of the geographic coordinate, in the WGS 84 datum.

• float longitude = 2

  Longitude of the geographic coordinate, in the WGS 84 datum.

• string address = 3

  Civic address of the location.

Used in: InterfacesResponse, Path

• optional Underlay address = 1

  Underlay address to exit through the interface.

Used in: Path

• LINK_TYPE_UNSPECIFIED = 0

  Unspecified link type.

• LINK_TYPE_DIRECT = 1

  Direct physical connection.

• LINK_TYPE_MULTI_HOP = 2

  Connection with local routing/switching.

• LINK_TYPE_OPEN_NET = 3

  Connection overlaid over publicly routed Internet.

Used in: ServicesResponse

• repeated Service services = 1

  Services is the list of services.

Used in: PathsResponse

• bytes raw = 1

  The raw data-plane path.

• optional Interface interface = 2

  Interface for exiting the local AS using this path.

• repeated PathInterface interfaces = 3

  The list of interfaces the path is composed of.

• uint32 mtu = 4

  The maximum transmission unit (MTU) on the path.

• optional google.protobuf.Timestamp expiration = 5

  The point in time when this path expires. In seconds since UNIX epoch.

• repeated google.protobuf.Duration latency = 6

  Latency lists the latencies between any two consecutive interfaces. Entry i describes the latency between interface i and i+1. Consequently, there are N-1 entries for N interfaces. A negative value indicates that the AS did not announce a latency for this hop.

• repeated uint64 bandwidth = 7

  Bandwidth lists the bandwidth between any two consecutive interfaces, in Kbit/s. Entry i describes the bandwidth between interfaces i and i+1. A 0-value indicates that the AS did not announce a bandwidth for this hop.

• repeated GeoCoordinates geo = 8

  Geo lists the geographical position of the border routers along the path. Entry i describes the position of the router for interface i. A 0-value indicates that the AS did not announce a position for this router.

• repeated LinkType link_type = 9

  LinkType contains the announced link type of inter-domain links. Entry i describes the link between interfaces 2*i and 2*i+1.

• repeated uint32 internal_hops = 10

  InternalHops lists the number of AS internal hops for the ASes on path. Entry i describes the hop between interfaces 2*i+1 and 2*i+2 in the same AS. Consequently, there are no entries for the first and last ASes, as these are not traversed completely by the path.

• repeated string notes = 11

  Notes contains the notes added by ASes on the path, in the order of occurrence. Entry i is the note of AS i on the path.

• optional EpicAuths epic_auths = 12

  EpicAuths contains the EPIC authenticators used to calculate the PHVF and LHVF.

Used in: Path

• uint64 isd_as = 1

  ISD-AS the interface belongs to.

• uint64 id = 2

  ID of the interface in the AS.

Used in: ListService

• string uri = 1

  Address of the service instance, in RFC 3986 format.

Address of an underlay socket.

Used in: Interface

• string address = 1

  The underlay address in standard IP:port notation (e.g., 192.0.2.1:10000 or [2001:db8::1]:10000). The underlay is UDP/IP.