cpuid.h

Go to the documentation of this file.

/* cpuid.h
 *
 * Copyright (c) 2011-2016, Lawrence Livermore National Security, LLC.
 * LLNL-CODE-645430
 *
 * Produced at Lawrence Livermore National Laboratory
 * Written by  Barry Rountree, rountree@llnl.gov
 *             Scott Walker,   walker91@llnl.gov
 *             Kathleen Shoga, shoga1@llnl.gov
 *
 * All rights reserved.
 *
 * This file is part of libmsr.
 *
 * libmsr is free software: you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License as published by the Free
 * Software Foundation, either version 3 of the License, or (at your option)
 * any later version.
 *
 * libmsr is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with libmsr. If not, see <http://www.gnu.org/licenses/>.
 *
 * This material is based upon work supported by the U.S. Department of
 * Energy's Lawrence Livermore National Laboratory. Office of Science, under
 * Award number DE-AC52-07NA27344.
 *
 */

#ifndef CPUID_H_INCLUDE
#define CPUID_H_INCLUDE

#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>

#ifdef __cplusplus
extern "C" {
#endif

#define MASK_RANGE(m,n) ((((uint64_t)1<<((m)-(n)+1))-1)<<(n))

#define MASK_VAL(x,m,n) (((uint64_t)(x)&MASK_RANGE((m),(n)))>>(n))

void cpuid(uint64_t leaf,
           uint64_t *rax,
           uint64_t *rbx,
           uint64_t *rcx,
           uint64_t *rdx);

void cpuid_detect_core_conf(uint64_t *coresPerSocket,
                            uint64_t *hyperThreads,
                            uint64_t *sockets,
                            int *HTenabled);

void cpuid_get_model(uint64_t *model);

void cpuidInput_rax_rcx(uint64_t leafa,
                        uint64_t leafc,
                        uint64_t *rax,
                        uint64_t *rbx,
                        uint64_t *rcx,
                        uint64_t *rdx);

bool cpuid_mperf_and_aperf_avail(void);

bool cpuid_timestamp_counter_avail(void);

/*****************************************/
/* Performance Monitoring Counters (PMC) */
/*****************************************/

int cpuid_num_pmc(void);

/*****************************************/
/* Performance Event Select (PerfEvtSel) */
/* (0x186, 0x187, 0x188, 0x189)          */
/*****************************************/

int cpuid_num_perfevtsel(void);

/***************************/
/* PERF_GLOBAL_CTL (0x38f) */
/***************************/

bool cpuid_perf_global_ctrl_EN_PMC(void);

bool cpuid_perf_global_ctrl_EN_FIXED_CTRnum(void);

/***************/
/* MISC_ENABLE */
/***************/

bool cpuid_misc_enable_TurboModeDisable(void);

bool cpuid_misc_enable_xTPRMessageDisable(void);

bool cpuid_misc_enable_XDbitDisable(void);

/*************/
/* CLOCK_MOD */
/*************/

bool cpuid_enable_ExtendedClockMod(void);

/*********************/
/* THERMAL Functions */
/*********************/

bool cpuid_therm_status_enable_ThermalThresholds(void);

bool cpuid_therm_status_enable_PowerLimitNotify(void);

bool cpuid_therm_status_enable_DigitalReadout(void);

bool cpuid_therm_interrupt_enable_PowerLimitNotify(void);

bool cpuid_pkg_therm_enable_status_and_interrupt(void);

/************************/
/* General Machine Info */
/************************/

uint64_t cpuid_MaxLeaf(void);

void cpuid_printVendorID(void);

int cpuid_pkg_MaxPhysicalProcessorCores(void);

int cpuid_pkg_MaxLogicalProcessors(void);

int cpuid_num_fixed_counters(void);

int cpuid_width_fixed_counters(void);

#ifdef __cplusplus
}
#endif
#endif