services/core/java/com/android/server/am/LowMemDetector.java

/*
 * Copyright (C) 2019 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.
 */

package com.android.server.am;

import static com.android.internal.app.procstats.ProcessStats.ADJ_MEM_FACTOR_CRITICAL;
import static com.android.internal.app.procstats.ProcessStats.ADJ_MEM_FACTOR_LOW;
import static com.android.internal.app.procstats.ProcessStats.ADJ_MEM_FACTOR_MODERATE;
import static com.android.internal.app.procstats.ProcessStats.ADJ_MEM_FACTOR_NORMAL;
import static com.android.internal.app.procstats.ProcessStats.ADJ_NOTHING;

import android.annotation.IntDef;
import android.os.Trace;

import com.android.internal.annotations.GuardedBy;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

/**
 * Detects low memory using PSI.
 *
 * If the kernel doesn't support PSI, then this class is not available.
 */
public final class LowMemDetector {
    private static final String TAG = "LowMemDetector";
    private final ActivityManagerService mAm;
    private final LowMemThread mLowMemThread;
    private boolean mAvailable;

    private final Object mPressureStateLock = new Object();

    @GuardedBy("mPressureStateLock")
    private int mPressureState = ADJ_MEM_FACTOR_NORMAL;

    public static final int ADJ_MEM_FACTOR_NOTHING = ADJ_NOTHING;

    /* getPressureState return values */
    @IntDef(prefix = { "ADJ_MEM_FACTOR_" }, value = {
        ADJ_MEM_FACTOR_NOTHING,
        ADJ_MEM_FACTOR_NORMAL,
        ADJ_MEM_FACTOR_MODERATE,
        ADJ_MEM_FACTOR_LOW,
        ADJ_MEM_FACTOR_CRITICAL,
    })
    @Retention(RetentionPolicy.SOURCE)
    public @interface MemFactor{}

    LowMemDetector(ActivityManagerService am) {
        mAm = am;
        mLowMemThread = new LowMemThread();
        if (init() != 0) {
            mAvailable = false;
        } else {
            mAvailable = true;
            mLowMemThread.start();
        }
    }

    public boolean isAvailable() {
        return mAvailable;
    }

    /**
     * Returns the current mem factor.
     * Note that getMemFactor returns LowMemDetector.MEM_PRESSURE_XXX
     * which match ProcessStats.ADJ_MEM_FACTOR_XXX values. If they deviate
     * there should be conversion performed here to translate pressure state
     * into memFactor.
     */
    public @MemFactor int getMemFactor() {
        synchronized (mPressureStateLock) {
            return mPressureState;
        }
    }

    private native int init();
    private native int waitForPressure();

    private final class LowMemThread extends Thread {
        private boolean mIsTracingMemCriticalLow;

        LowMemThread() {
            super("LowMemThread");
        }

        public void run() {

            while (true) {
                // sleep waiting for a PSI event
                int newPressureState = waitForPressure();
                // PSI event detected
                boolean isCriticalLowMemory = newPressureState == ADJ_MEM_FACTOR_CRITICAL;
                if (isCriticalLowMemory && !mIsTracingMemCriticalLow) {
                    Trace.traceBegin(Trace.TRACE_TAG_ACTIVITY_MANAGER, "criticalLowMemory");
                } else if (!isCriticalLowMemory && mIsTracingMemCriticalLow) {
                    Trace.traceEnd(Trace.TRACE_TAG_ACTIVITY_MANAGER);
                }
                mIsTracingMemCriticalLow = isCriticalLowMemory;
                if (newPressureState == -1) {
                    // epoll broke, tear this down
                    mAvailable = false;
                    break;
                }
                // got an actual PSI event? let's update lowmem info
                synchronized (mPressureStateLock) {
                    mPressureState = newPressureState;
                }
            }
        }
    }
}