diff mbox

[v3,08/15] tools: create general interfaces to support psr allocation features

Message ID 1504603957-5389-9-git-send-email-yi.y.sun@linux.intel.com (mailing list archive)
State New, archived
Headers show

Commit Message

Yi Sun Sept. 5, 2017, 9:32 a.m. UTC
This patch creates general interfaces in libxl to support all psr
allocation features.

Add 'LIBXL_HAVE_PSR_GENERIC' to indicate interface change.

Please note, the functionality cannot work until later patches
are applied.

Signed-off-by: Yi Sun <yi.y.sun@linux.intel.com>
---
v3:
    - change 'LIBXL_HAVE_PSR_MBA' to 'LIBXL_HAVE_PSR_GENERIC'.
      (suggested by Roger Pau Monné)
    - 'typedef enum libxl_psr_cbm_type libxl_psr_type;' in libxl.h.
      (suggested by Roger Pau Monné and Wei Liu)
    - change 'libxl_psr_cbm_type' to 'libxl_psr_type' in newly defined
      interfaces.
      (suggested by Roger Pau Monné)
v2:
    - remove '_INFO' in 'libxl_psr_feat_type' and make corresponding
      changes in 'libxl_psr_hw_info'.
      (suggested by Chao Peng)
---
 tools/libxl/libxl.h         | 33 +++++++++++++++++++++++++++++++++
 tools/libxl/libxl_psr.c     | 25 +++++++++++++++++++++++++
 tools/libxl/libxl_types.idl | 22 ++++++++++++++++++++++
 3 files changed, 80 insertions(+)

Comments

Roger Pau Monné Sept. 19, 2017, 10:04 a.m. UTC | #1
On Tue, Sep 05, 2017 at 05:32:30PM +0800, Yi Sun wrote:
> This patch creates general interfaces in libxl to support all psr
> allocation features.
> 
> Add 'LIBXL_HAVE_PSR_GENERIC' to indicate interface change.
> 
> Please note, the functionality cannot work until later patches
> are applied.
> 
> Signed-off-by: Yi Sun <yi.y.sun@linux.intel.com>
> ---
> v3:
>     - change 'LIBXL_HAVE_PSR_MBA' to 'LIBXL_HAVE_PSR_GENERIC'.
>       (suggested by Roger Pau Monné)
>     - 'typedef enum libxl_psr_cbm_type libxl_psr_type;' in libxl.h.
>       (suggested by Roger Pau Monné and Wei Liu)
>     - change 'libxl_psr_cbm_type' to 'libxl_psr_type' in newly defined
>       interfaces.
>       (suggested by Roger Pau Monné)
> v2:
>     - remove '_INFO' in 'libxl_psr_feat_type' and make corresponding
>       changes in 'libxl_psr_hw_info'.
>       (suggested by Chao Peng)
> ---
>  tools/libxl/libxl.h         | 33 +++++++++++++++++++++++++++++++++
>  tools/libxl/libxl_psr.c     | 25 +++++++++++++++++++++++++
>  tools/libxl/libxl_types.idl | 22 ++++++++++++++++++++++
>  3 files changed, 80 insertions(+)
> 
> diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h
> index 484b5b7..9744087 100644
> --- a/tools/libxl/libxl.h
> +++ b/tools/libxl/libxl.h
> @@ -931,6 +931,13 @@ void libxl_mac_copy(libxl_ctx *ctx, libxl_mac *dst, const libxl_mac *src);
>  #define LIBXL_HAVE_PSR_L2_CAT 1
>  
>  /*
> + * LIBXL_HAVE_PSR_GENERIC
> + *
> + * If this is defined, the Memory Bandwidth Allocation feature is supported.

You should also mention that if this is defined the following public
functions are available:

libxl_psr_{set/get}_val
libxl_psr_get_hw_info
libxl_psr_hw_info_list_free

Thanks, Roger.
Yi Sun Sept. 20, 2017, 5:45 a.m. UTC | #2
Per Jan's suggestion, remove people not related to tools/ patches to save
mailbox space.

> On Tue, Sep 05, 2017 at 05:32:30PM +0800, Yi Sun wrote:
> > diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h
> > index 484b5b7..9744087 100644
> > --- a/tools/libxl/libxl.h
> > +++ b/tools/libxl/libxl.h
> > @@ -931,6 +931,13 @@ void libxl_mac_copy(libxl_ctx *ctx, libxl_mac *dst, const libxl_mac *src);
> >  #define LIBXL_HAVE_PSR_L2_CAT 1
> >  
> >  /*
> > + * LIBXL_HAVE_PSR_GENERIC
> > + *
> > + * If this is defined, the Memory Bandwidth Allocation feature is supported.
> 
> You should also mention that if this is defined the following public
> functions are available:
> 
> libxl_psr_{set/get}_val
> libxl_psr_get_hw_info
> libxl_psr_hw_info_list_free
> 
Sure, thanks!

> Thanks, Roger.
Chao Peng Sept. 22, 2017, 7:01 a.m. UTC | #3
On Tue, 2017-09-19 at 11:04 +0100, Roger Pau Monné wrote:
> On Tue, Sep 05, 2017 at 05:32:30PM +0800, Yi Sun wrote:
> > 
> > This patch creates general interfaces in libxl to support all psr
> > allocation features.
> > 
> > Add 'LIBXL_HAVE_PSR_GENERIC' to indicate interface change.
> > 
> > Please note, the functionality cannot work until later patches
> > are applied.
> > 
> > Signed-off-by: Yi Sun <yi.y.sun@linux.intel.com>
> > ---
> > v3:
> >     - change 'LIBXL_HAVE_PSR_MBA' to 'LIBXL_HAVE_PSR_GENERIC'.
> >       (suggested by Roger Pau Monné)
> >     - 'typedef enum libxl_psr_cbm_type libxl_psr_type;' in libxl.h.
> >       (suggested by Roger Pau Monné and Wei Liu)
> >     - change 'libxl_psr_cbm_type' to 'libxl_psr_type' in newly
> > defined
> >       interfaces.
> >       (suggested by Roger Pau Monné)
> > v2:
> >     - remove '_INFO' in 'libxl_psr_feat_type' and make corresponding
> >       changes in 'libxl_psr_hw_info'.
> >       (suggested by Chao Peng)
> > ---
> >  tools/libxl/libxl.h         | 33 +++++++++++++++++++++++++++++++++
> >  tools/libxl/libxl_psr.c     | 25 +++++++++++++++++++++++++
> >  tools/libxl/libxl_types.idl | 22 ++++++++++++++++++++++
> >  3 files changed, 80 insertions(+)
> > 
> > diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h
> > index 484b5b7..9744087 100644
> > --- a/tools/libxl/libxl.h
> > +++ b/tools/libxl/libxl.h
> > @@ -931,6 +931,13 @@ void libxl_mac_copy(libxl_ctx *ctx, libxl_mac
> > *dst, const libxl_mac *src);
> >  #define LIBXL_HAVE_PSR_L2_CAT 1
> >  
> >  /*
> > + * LIBXL_HAVE_PSR_GENERIC
> > + *
> > + * If this is defined, the Memory Bandwidth Allocation feature is
> > supported.
> 
> You should also mention that if this is defined the following public
> functions are available:
> 
> libxl_psr_{set/get}_val
> libxl_psr_get_hw_info
> libxl_psr_hw_info_list_free
> 

I'm just wondering what macro we will use when more PSR generic routines
are needed in the future releases. LIBXL_HAVE_PSR_GENERIC2?

Thanks,
Chao
Wei Liu Sept. 28, 2017, 4:11 p.m. UTC | #4
On Fri, Sep 22, 2017 at 03:01:42PM +0800, Chao Peng wrote:
> On Tue, 2017-09-19 at 11:04 +0100, Roger Pau Monné wrote:
> > On Tue, Sep 05, 2017 at 05:32:30PM +0800, Yi Sun wrote:
> > > 
> > > This patch creates general interfaces in libxl to support all psr
> > > allocation features.
> > > 
> > > Add 'LIBXL_HAVE_PSR_GENERIC' to indicate interface change.
> > > 
> > > Please note, the functionality cannot work until later patches
> > > are applied.
> > > 
> > > Signed-off-by: Yi Sun <yi.y.sun@linux.intel.com>
> > > ---
> > > v3:
> > >     - change 'LIBXL_HAVE_PSR_MBA' to 'LIBXL_HAVE_PSR_GENERIC'.
> > >       (suggested by Roger Pau Monné)
> > >     - 'typedef enum libxl_psr_cbm_type libxl_psr_type;' in libxl.h.
> > >       (suggested by Roger Pau Monné and Wei Liu)
> > >     - change 'libxl_psr_cbm_type' to 'libxl_psr_type' in newly
> > > defined
> > >       interfaces.
> > >       (suggested by Roger Pau Monné)
> > > v2:
> > >     - remove '_INFO' in 'libxl_psr_feat_type' and make corresponding
> > >       changes in 'libxl_psr_hw_info'.
> > >       (suggested by Chao Peng)
> > > ---
> > >  tools/libxl/libxl.h         | 33 +++++++++++++++++++++++++++++++++
> > >  tools/libxl/libxl_psr.c     | 25 +++++++++++++++++++++++++
> > >  tools/libxl/libxl_types.idl | 22 ++++++++++++++++++++++
> > >  3 files changed, 80 insertions(+)
> > > 
> > > diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h
> > > index 484b5b7..9744087 100644
> > > --- a/tools/libxl/libxl.h
> > > +++ b/tools/libxl/libxl.h
> > > @@ -931,6 +931,13 @@ void libxl_mac_copy(libxl_ctx *ctx, libxl_mac
> > > *dst, const libxl_mac *src);
> > >  #define LIBXL_HAVE_PSR_L2_CAT 1
> > >  
> > >  /*
> > > + * LIBXL_HAVE_PSR_GENERIC
> > > + *
> > > + * If this is defined, the Memory Bandwidth Allocation feature is
> > > supported.
> > 
> > You should also mention that if this is defined the following public
> > functions are available:
> > 
> > libxl_psr_{set/get}_val
> > libxl_psr_get_hw_info
> > libxl_psr_hw_info_list_free
> > 
> 
> I'm just wondering what macro we will use when more PSR generic routines
> are needed in the future releases. LIBXL_HAVE_PSR_GENERIC2?

GENERIC2 sounds horrible but if we have to, so be it. But I suppose we
can always think of better names. We shall cross the bridge when we gets
there.
diff mbox

Patch

diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h
index 484b5b7..9744087 100644
--- a/tools/libxl/libxl.h
+++ b/tools/libxl/libxl.h
@@ -931,6 +931,13 @@  void libxl_mac_copy(libxl_ctx *ctx, libxl_mac *dst, const libxl_mac *src);
 #define LIBXL_HAVE_PSR_L2_CAT 1
 
 /*
+ * LIBXL_HAVE_PSR_GENERIC
+ *
+ * If this is defined, the Memory Bandwidth Allocation feature is supported.
+ */
+#define LIBXL_HAVE_PSR_GENERIC 1
+
+/*
  * LIBXL_HAVE_MCA_CAPS
  *
  * If this is defined, setting MCA capabilities for HVM domain is supported.
@@ -2215,6 +2222,32 @@  int libxl_psr_cat_get_info(libxl_ctx *ctx, libxl_psr_cat_info **info,
 int libxl_psr_cat_get_l3_info(libxl_ctx *ctx, libxl_psr_cat_info **info,
                               int *nr);
 void libxl_psr_cat_info_list_free(libxl_psr_cat_info *list, int nr);
+
+typedef enum libxl_psr_cbm_type libxl_psr_type;
+
+/*
+ * Function to set a domain's value. It operates on a single or multiple
+ * target(s) defined in 'target_map'. 'target_map' specifies all the sockets
+ * to be operated on.
+ */
+int libxl_psr_set_val(libxl_ctx *ctx, uint32_t domid,
+                      libxl_psr_type type, libxl_bitmap *target_map,
+                      uint64_t val);
+/*
+ * Function to get a domain's cbm. It operates on a single 'target'.
+ * 'target' specifies which socket to be operated on.
+ */
+int libxl_psr_get_val(libxl_ctx *ctx, uint32_t domid,
+                      libxl_psr_type type, unsigned int target,
+                      uint64_t *val);
+/*
+ * On success, the function returns an array of elements in 'info',
+ * and the length in 'nr'.
+ */
+int libxl_psr_get_hw_info(libxl_ctx *ctx, libxl_psr_hw_info **info,
+                          unsigned int *nr, libxl_psr_feat_type type,
+                          unsigned int lvl);
+void libxl_psr_hw_info_list_free(libxl_psr_hw_info *list, unsigned int nr);
 #endif
 
 /* misc */
diff --git a/tools/libxl/libxl_psr.c b/tools/libxl/libxl_psr.c
index 197505a..4a6978e 100644
--- a/tools/libxl/libxl_psr.c
+++ b/tools/libxl/libxl_psr.c
@@ -428,6 +428,31 @@  void libxl_psr_cat_info_list_free(libxl_psr_cat_info *list, int nr)
     free(list);
 }
 
+int libxl_psr_set_val(libxl_ctx *ctx, uint32_t domid,
+                      libxl_psr_type type, libxl_bitmap *target_map,
+                      uint64_t val)
+{
+    return ERROR_FAIL;
+}
+
+int libxl_psr_get_val(libxl_ctx *ctx, uint32_t domid,
+                      libxl_psr_type type, unsigned int target,
+                      uint64_t *val)
+{
+    return ERROR_FAIL;
+}
+
+int libxl_psr_get_hw_info(libxl_ctx *ctx, libxl_psr_hw_info **info,
+                          unsigned int *nr, libxl_psr_feat_type type,
+                          unsigned int lvl)
+{
+    return ERROR_FAIL;
+}
+
+void libxl_psr_hw_info_list_free(libxl_psr_hw_info *list, unsigned int nr)
+{
+}
+
 /*
  * Local variables:
  * mode: C
diff --git a/tools/libxl/libxl_types.idl b/tools/libxl/libxl_types.idl
index 6e80d36..ab847f8 100644
--- a/tools/libxl/libxl_types.idl
+++ b/tools/libxl/libxl_types.idl
@@ -977,6 +977,7 @@  libxl_psr_cbm_type = Enumeration("psr_cbm_type", [
     (2, "L3_CBM_CODE"),
     (3, "L3_CBM_DATA"),
     (4, "L2_CBM"),
+    (5, "MBA_THRTL"),
     ])
 
 libxl_psr_cat_info = Struct("psr_cat_info", [
@@ -985,3 +986,24 @@  libxl_psr_cat_info = Struct("psr_cat_info", [
     ("cbm_len", uint32),
     ("cdp_enabled", bool),
     ])
+
+libxl_psr_feat_type = Enumeration("psr_feat_type", [
+    (1, "CAT"),
+    (2, "MBA"),
+    ])
+
+libxl_psr_hw_info = Struct("psr_hw_info", [
+    ("id", uint32),
+    ("u", KeyedUnion(None, libxl_psr_feat_type, "type",
+          [("cat", Struct(None, [
+                                    ("cos_max",     uint32),
+                                    ("cbm_len",     uint32),
+                                    ("cdp_enabled", bool),
+                               ])),
+           ("mba", Struct(None, [
+                                    ("cos_max",     uint32),
+                                    ("thrtl_max",   uint32),
+                                    ("linear",      bool),
+                               ])),
+          ]))
+    ], dir=DIR_OUT)