/*
 * Copyright (C) 2017 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

syntax = "proto2";

package android.net;

option java_multiple_files = true;

import "frameworks/base/core/proto/android/net/networkcapabilities.proto";
import "frameworks/base/core/proto/android/privacy.proto";

/**
 * An android.net.NetworkRequest object.
 */
message NetworkRequestProto {
    option (.android.msg_privacy).dest = DEST_AUTOMATIC;

    enum Type {
        TYPE_UNKNOWN = 0;
        // Only used by applications. When an application creates a
        // NetworkRequest, it does not have a type; the type is set by the
        // system depending on the method used to file the request
        // (requestNetwork, registerNetworkCallback, etc.).
        TYPE_NONE = 1;
        // The framework will issue callbacks about any and all networks that
        // match the specified NetworkCapabilities.
        TYPE_LISTEN = 2;
        // A hybrid of the two designed such that the framework will issue
        // callbacks for the single, highest scoring current network (if any)
        // that matches the capabilities of the default Internet request
        // (mDefaultRequest), but which cannot cause the framework to either
        // create or retain the existence of any specific network. Note that
        // from the point of view of the request matching code, TRACK_DEFAULT is
        // identical to REQUEST: its special behaviour is not due to different
        // semantics, but to the fact that the system will only ever create a
        // TRACK_DEFAULT with capabilities that are identical to the default
        // request's capabilities, thus causing it to share fate in every way
        // with the default request.
        TYPE_TRACK_DEFAULT = 3;
        // Capable of causing a specific network to be created first (e.g. a
        // telephony DUN request), the framework will issue callbacks about the
        // single, highest scoring current network (if any) that matches the
        // specified NetworkCapabilities.
        TYPE_REQUEST = 4;
        // Like REQUEST but does not cause any networks to retain the
        // NET_CAPABILITY_FOREGROUND capability. A network with no foreground
        // requests is in the background. A network that has one or more
        // background requests and loses its last foreground request to a
        // higher-scoring network will not go into the background immediately,
        // but will linger and go into the background after the linger timeout.
        TYPE_BACKGROUND_REQUEST = 5;
        // Like TRACK_DEFAULT, but tracks the system default network, instead of
        // the default network of the calling application.
        TYPE_TRACK_SYSTEM_DEFAULT = 6;
    }
    // The type of the request. This is only used by the system and is always
    // NONE elsewhere.
    optional Type type = 1;
    // Identifies the request.
    optional int32 request_id = 2;
    // Set for legacy requests and the default.
    optional int32 legacy_type = 3;
    optional NetworkCapabilitiesProto network_capabilities = 4;
}