perf pmu: Warn about invalid config for all PMUs and configs
[linux-2.6-microblaze.git] / tools / perf / util / pmu.h
index 6b770f1..8807a62 100644 (file)
@@ -19,6 +19,7 @@ enum {
        PERF_PMU_FORMAT_VALUE_CONFIG,
        PERF_PMU_FORMAT_VALUE_CONFIG1,
        PERF_PMU_FORMAT_VALUE_CONFIG2,
+       PERF_PMU_FORMAT_VALUE_CONFIG3,
        PERF_PMU_FORMAT_VALUE_CONFIG_END,
 };
 
@@ -34,7 +35,7 @@ struct perf_pmu_caps {
 };
 
 /**
- * struct perf_pmu - hi
+ * struct perf_pmu
  */
 struct perf_pmu {
        /** @name: The name of the PMU such as "cpu". */
@@ -58,6 +59,13 @@ struct perf_pmu {
         * @selectable: Can the PMU name be selected as if it were an event?
         */
        bool selectable;
+       /**
+        * @is_core: Is the PMU the core CPU PMU? Determined by the name being
+        * "cpu" or by the presence of
+        * <sysfs>/bus/event_source/devices/<name>/cpus. There may be >1 core
+        * PMU on systems like Intel hybrid.
+        */
+       bool is_core;
        /**
         * @is_uncore: Is the PMU not within the CPU core? Determined by the
         * presence of <sysfs>/bus/event_source/devices/<name>/cpumask.
@@ -68,6 +76,15 @@ struct perf_pmu {
         * specific code.
         */
        bool auxtrace;
+       /**
+        * @formats_checked: Only check PMU's formats are valid for
+        * perf_event_attr once.
+        */
+       bool formats_checked;
+       /** @config_masks_present: Are there config format values? */
+       bool config_masks_present;
+       /** @config_masks_computed: Set when masks are lazily computed. */
+       bool config_masks_computed;
        /**
         * @max_precise: Number of levels of :ppp precision supported by the
         * PMU, read from
@@ -111,8 +128,12 @@ struct perf_pmu {
        struct list_head caps;
        /** @list: Element on pmus list in pmu.c. */
        struct list_head list;
-       /** @hybrid_list: Element on perf_pmu__hybrid_pmus. */
-       struct list_head hybrid_list;
+
+       /**
+        * @config_masks: Derived from the PMU's format data, bits that are
+        * valid within the config value.
+        */
+       __u64 config_masks[PERF_PMU_FORMAT_VALUE_CONFIG_END];
 
        /**
         * @missing_features: Features to inhibit when events on this PMU are
@@ -185,12 +206,13 @@ struct perf_pmu_alias {
         * default.
         */
        bool deprecated;
-       /** @pmu_name: The name copied from struct perf_pmu. */
+       /**
+        * @pmu_name: The name copied from the json struct pmu_event. This can
+        * differ from the PMU name as it won't have suffixes.
+        */
        char *pmu_name;
 };
 
-struct perf_pmu *perf_pmu__find(const char *name);
-struct perf_pmu *perf_pmu__find_by_type(unsigned int type);
 void pmu_add_sys_aliases(struct list_head *head, struct perf_pmu *pmu);
 int perf_pmu__config(struct perf_pmu *pmu, struct perf_event_attr *attr,
                     struct list_head *head_terms,
@@ -205,21 +227,30 @@ int perf_pmu__check_alias(struct perf_pmu *pmu, struct list_head *head_terms,
                          struct perf_pmu_info *info);
 struct list_head *perf_pmu__alias(struct perf_pmu *pmu,
                                  struct list_head *head_terms);
-void perf_pmu_error(struct list_head *list, char *name, char const *msg);
+void perf_pmu_error(struct list_head *list, char *name, void *scanner, char const *msg);
 
 int perf_pmu__new_format(struct list_head *list, char *name,
                         int config, unsigned long *bits);
 void perf_pmu__set_format(unsigned long *bits, long from, long to);
-int perf_pmu__format_parse(char *dir, struct list_head *head);
+int perf_pmu__format_parse(int dirfd, struct list_head *head);
 void perf_pmu__del_formats(struct list_head *formats);
 
-struct perf_pmu *perf_pmu__scan(struct perf_pmu *pmu);
-
 bool is_pmu_core(const char *name);
-void print_pmu_events(const struct print_callbacks *print_cb, void *print_state);
-bool pmu_have_event(const char *pname, const char *name);
+bool perf_pmu__supports_legacy_cache(const struct perf_pmu *pmu);
+bool perf_pmu__auto_merge_stats(const struct perf_pmu *pmu);
+bool perf_pmu__have_event(const struct perf_pmu *pmu, const char *name);
+/**
+ * perf_pmu_is_software - is the PMU a software PMU as in it uses the
+ *                        perf_sw_context in the kernel?
+ */
+bool perf_pmu__is_software(const struct perf_pmu *pmu);
+
+FILE *perf_pmu__open_file(struct perf_pmu *pmu, const char *name);
+FILE *perf_pmu__open_file_at(struct perf_pmu *pmu, int dirfd, const char *name);
 
 int perf_pmu__scan_file(struct perf_pmu *pmu, const char *name, const char *fmt, ...) __scanf(3, 4);
+int perf_pmu__scan_file_at(struct perf_pmu *pmu, int dirfd, const char *name,
+                          const char *fmt, ...) __scanf(4, 5);
 
 bool perf_pmu__file_exists(struct perf_pmu *pmu, const char *name);
 
@@ -232,7 +263,6 @@ void pmu_add_cpu_aliases_table(struct list_head *head, struct perf_pmu *pmu,
 char *perf_pmu__getcpuid(struct perf_pmu *pmu);
 const struct pmu_events_table *pmu_events_table__find(void);
 const struct pmu_metrics_table *pmu_metrics_table__find(void);
-bool pmu_uncore_alias_match(const char *pmu_name, const char *name);
 void perf_pmu_free_alias(struct perf_pmu_alias *alias);
 
 int perf_pmu__convert_scale(const char *scale, char **end, double *sval);
@@ -240,22 +270,22 @@ int perf_pmu__convert_scale(const char *scale, char **end, double *sval);
 int perf_pmu__caps_parse(struct perf_pmu *pmu);
 
 void perf_pmu__warn_invalid_config(struct perf_pmu *pmu, __u64 config,
-                                  const char *name);
+                                  const char *name, int config_num,
+                                  const char *config_name);
 void perf_pmu__warn_invalid_formats(struct perf_pmu *pmu);
 
-bool perf_pmu__has_hybrid(void);
 int perf_pmu__match(char *pattern, char *name, char *tok);
 
-int perf_pmu__cpus_match(struct perf_pmu *pmu, struct perf_cpu_map *cpus,
-                        struct perf_cpu_map **mcpus_ptr,
-                        struct perf_cpu_map **ucpus_ptr);
-
 char *pmu_find_real_name(const char *name);
 char *pmu_find_alias_name(const char *name);
 double perf_pmu__cpu_slots_per_cycle(void);
 int perf_pmu__event_source_devices_scnprintf(char *pathname, size_t size);
 int perf_pmu__pathname_scnprintf(char *buf, size_t size,
                                 const char *pmu_name, const char *filename);
-FILE *perf_pmu__open_file(struct perf_pmu *pmu, const char *name);
+int perf_pmu__event_source_devices_fd(void);
+int perf_pmu__pathname_fd(int dirfd, const char *pmu_name, const char *filename, int flags);
+
+struct perf_pmu *perf_pmu__lookup(struct list_head *pmus, int dirfd, const char *lookup_name);
+void perf_pmu__delete(struct perf_pmu *pmu);
 
 #endif /* __PMU_H */