target-s390x/cpu_features.h

   1 /*
   2  * CPU features/facilities helper structs and utility functions for s390
   3  *
   4  * Copyright 2016 IBM Corp.
   5  *
   6  * Author(s): Michael Mueller <mimu@linux.vnet.ibm.com>
   7  *            David Hildenbrand <dahi@linux.vnet.ibm.com>
   8  *
   9  * This work is licensed under the terms of the GNU GPL, version 2 or (at
  10  * your option) any later version. See the COPYING file in the top-level
  11  * directory.
  12  */
  13
  14 #ifndef TARGET_S390X_CPU_FEATURES_H
  15 #define TARGET_S390X_CPU_FEATURES_H
  16
  17 #include "qemu/bitmap.h"
  18 #include "cpu_features_def.h"
  19
  20 /* CPU features are announced via different ways */
  21 typedef enum {
  22     S390_FEAT_TYPE_STFL,
  23     S390_FEAT_TYPE_SCLP_CONF_CHAR,
  24     S390_FEAT_TYPE_SCLP_CONF_CHAR_EXT,
  25     S390_FEAT_TYPE_SCLP_CPU,
  26     S390_FEAT_TYPE_MISC,
  27     S390_FEAT_TYPE_PLO,
  28     S390_FEAT_TYPE_PTFF,
  29     S390_FEAT_TYPE_KMAC,
  30     S390_FEAT_TYPE_KMC,
  31     S390_FEAT_TYPE_KM,
  32     S390_FEAT_TYPE_KIMD,
  33     S390_FEAT_TYPE_KLMD,
  34     S390_FEAT_TYPE_PCKMO,
  35     S390_FEAT_TYPE_KMCTR,
  36     S390_FEAT_TYPE_KMF,
  37     S390_FEAT_TYPE_KMO,
  38     S390_FEAT_TYPE_PCC,
  39     S390_FEAT_TYPE_PPNO,
  40 } S390FeatType;
  41
  42 /* Definition of a CPU feature */
  43 typedef struct {
  44     const char *name;       /* name exposed to the user */
  45     const char *desc;       /* description exposed to the user */
  46     S390FeatType type;      /* feature type (way of indication)*/
  47     int bit;                /* bit within the feature type area (fixed) */
  48 } S390FeatDef;
  49
  50 /* use ordinary bitmap operations to work with features */
  51 typedef unsigned long S390FeatBitmap[BITS_TO_LONGS(S390_FEAT_MAX)];
  52
  53 /* 64bit based bitmap used to init S390FeatBitmap from generated data */
  54 typedef uint64_t S390FeatInit[S390_FEAT_MAX / 64 + 1];
  55
  56 const S390FeatDef *s390_feat_def(S390Feat feat);
  57 S390Feat s390_feat_by_type_and_bit(S390FeatType type, int bit);
  58 void s390_init_feat_bitmap(const S390FeatInit init, S390FeatBitmap bitmap);
  59 void s390_fill_feat_block(const S390FeatBitmap features, S390FeatType type,
  60                           uint8_t *data);
  61 void s390_add_from_feat_block(S390FeatBitmap features, S390FeatType type,
  62                           uint8_t *data);
  63 void s390_feat_bitmap_to_ascii(const S390FeatBitmap features, void *opaque,
  64                                void (*fn)(const char *name, void *opaque));
  65
  66 /* static groups that will never change */
  67 typedef enum {
  68     S390_FEAT_GROUP_PLO,
  69     S390_FEAT_GROUP_TOD_CLOCK_STEERING,
  70     S390_FEAT_GROUP_GEN13_PTFF_ENH,
  71     S390_FEAT_GROUP_MSA,
  72     S390_FEAT_GROUP_MSA_EXT_1,
  73     S390_FEAT_GROUP_MSA_EXT_2,
  74     S390_FEAT_GROUP_MSA_EXT_3,
  75     S390_FEAT_GROUP_MSA_EXT_4,
  76     S390_FEAT_GROUP_MSA_EXT_5,
  77     S390_FEAT_GROUP_MAX,
  78 } S390FeatGroup;
  79
  80 /* Definition of a CPU feature group */
  81 typedef struct {
  82     const char *name;       /* name exposed to the user */
  83     const char *desc;       /* description exposed to the user */
  84     S390FeatBitmap feat;    /* features contained in the group */
  85     S390FeatInit init;      /* used to init feat from generated data */
  86 } S390FeatGroupDef;
  87
  88 const S390FeatGroupDef *s390_feat_group_def(S390FeatGroup group);
  89
  90 #define BE_BIT_NR(BIT) (BIT ^ (BITS_PER_LONG - 1))
  91 #define BE_BIT(BIT) (1ULL < BE_BIT_NR(BIT))
  92
  93 #endif /* TARGET_S390X_CPU_FEATURES_H */