/*
 * Copyright (C) 2025 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 perfetto.protos;

// Configuration that allows to boost the priority of the 'traced' or
// 'traced_probs' processes, by changing the scheduler configuration.
// Only supported on Linux and Android the boosted process must have
// 'CAP_SYS_NICE' capability.
message PriorityBoostConfig {
  enum BoostPolicy {
    POLICY_UNSPECIFIED = 0;
    // The default policy (e.g., CFS on Linux). Priority range: [0; 20]
    // priority is interpreted as -(nice), i.e., 1 is slightly higher prio
    // than default 0, 20 is the highest priority.
    // Note: this is the opposite semantic of the cmdline nice, and is done for
    // consistency with POLICY_SCHED_FIFO, so higher number == higher prio.
    POLICY_SCHED_OTHER = 1;
    // The Real-time policy, Priority range: [1; 99]
    POLICY_SCHED_FIFO = 2;
  };
  optional BoostPolicy policy = 1;
  optional uint32 priority = 2;
}