gateway: etags added to prefix discovery protobuf (scionproto#4461)

Etags can be used so as not to transfer large prefix sets over and over
again.

Etags may or may not be supported by a particular gateway
implementation. This change is fully forward and backward compatible.
Implementations that do not support etags should just ignore the field.

Author: sustrik

pkg/proto/gateway/prefix.pb.go

@@ -23,12 +23,22 @@ service IPPrefixesService {
     rpc Prefixes(PrefixesRequest) returns (PrefixesResponse) {}
 }
 
-message PrefixesRequest {}
+message PrefixesRequest {
+    // Etag is the hash of the prefix set currently used by the requester.
+    // This value must not be calculated by the client. Instead it should
+    // be copied from the previous response. If there was no previous response
+    // set this field to empty string.
+    string etag = 1;
+}
 
 message PrefixesResponse {
     // Prefixes are the prefixes that are reachable via the Gateway that
-    // responds.
+    // responds. If the etag in the request is the same as the etag in
+    // the response this field must be empty.
     repeated Prefix prefixes = 1;
+    // Etag is the hash of the returned prefix set. The servers that don't
+    // support etags must return an empty string in this field.
+    string etag = 2;
 }
 
 message Prefix {