msr_clocks.h

Go to the documentation of this file.

/* msr_clocks.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 MSR_CLOCKS_H_INCLUDE
#define MSR_CLOCKS_H_INCLUDE

#include <stdint.h>

#include "master.h"

#ifdef __cplusplus
extern "C" {
#endif

struct clock_mod {
    uint64_t raw;
    int duty_cycle_enable;
    int duty_cycle;
    //   Value   | Duty Cycle
    // 000b = 0  |  Reserved
    // 001b = 1  |    12.5% (default)
    // 010b = 2  |    25.0%
    // 011b = 3  |    37.5%
    // 100b = 4  |    50.0%
    // 101b = 5  |    63.5%
    // 110b = 6  |    75.0%
    // 111b = 7  |    87.5%
};

struct clocks_data {
    uint64_t **aperf;
    uint64_t **mperf;
    uint64_t **tsc;
};

struct perf_data {
    uint64_t **perf_status;
    uint64_t **perf_ctl;
};

void clocks_storage(struct clocks_data **cd);

void perf_storage(struct perf_data **pd);

void dump_clocks_data_terse_label(FILE *writedest);

void dump_clocks_data_terse(FILE *writedest);

void dump_p_state(FILE *writedest);

void set_p_state(unsigned socket,
                 uint64_t pstate);

void dump_clocks_data_readable(FILE *writedest);

/****************************************/
/* Software Controlled Clock Modulation */
/****************************************/

void dump_clock_mod(struct clock_mod *s,
                    FILE *writedest);

void get_clock_mod(int socket,
                   int core,
                   struct clock_mod *s);

int set_clock_mod(int socket,
                  int core,
                  struct clock_mod *s);

#ifdef __cplusplus
}
#endif
#endif