/* SPDX-License-Identifier: GPL-2.0 */
|
#ifndef _SPARC64_MDESC_H
|
#define _SPARC64_MDESC_H
|
|
#include <linux/types.h>
|
#include <linux/cpumask.h>
|
#include <asm/prom.h>
|
|
struct mdesc_handle;
|
|
/* Machine description operations are to be surrounded by grab and
|
* release calls. The mdesc_handle returned from the grab is
|
* the first argument to all of the operational calls that work
|
* on mdescs.
|
*/
|
struct mdesc_handle *mdesc_grab(void);
|
void mdesc_release(struct mdesc_handle *);
|
|
#define MDESC_NODE_NULL (~(u64)0)
|
#define MDESC_MAX_STR_LEN 256
|
|
u64 mdesc_node_by_name(struct mdesc_handle *handle,
|
u64 from_node, const char *name);
|
#define mdesc_for_each_node_by_name(__hdl, __node, __name) \
|
for (__node = mdesc_node_by_name(__hdl, MDESC_NODE_NULL, __name); \
|
(__node) != MDESC_NODE_NULL; \
|
__node = mdesc_node_by_name(__hdl, __node, __name))
|
|
/* Access to property values returned from mdesc_get_property() are
|
* only valid inside of a mdesc_grab()/mdesc_release() sequence.
|
* Once mdesc_release() is called, the memory backed up by these
|
* pointers may reference freed up memory.
|
*
|
* Therefore callers must make copies of any property values
|
* they need.
|
*
|
* These same rules apply to mdesc_node_name().
|
*/
|
const void *mdesc_get_property(struct mdesc_handle *handle,
|
u64 node, const char *name, int *lenp);
|
const char *mdesc_node_name(struct mdesc_handle *hp, u64 node);
|
|
/* MD arc iteration, the standard sequence is:
|
*
|
* unsigned long arc;
|
* mdesc_for_each_arc(arc, handle, node, MDESC_ARC_TYPE_{FWD,BACK}) {
|
* unsigned long target = mdesc_arc_target(handle, arc);
|
* ...
|
* }
|
*/
|
|
#define MDESC_ARC_TYPE_FWD "fwd"
|
#define MDESC_ARC_TYPE_BACK "back"
|
|
u64 mdesc_next_arc(struct mdesc_handle *handle, u64 from,
|
const char *arc_type);
|
#define mdesc_for_each_arc(__arc, __hdl, __node, __type) \
|
for (__arc = mdesc_next_arc(__hdl, __node, __type); \
|
(__arc) != MDESC_NODE_NULL; \
|
__arc = mdesc_next_arc(__hdl, __arc, __type))
|
|
u64 mdesc_arc_target(struct mdesc_handle *hp, u64 arc);
|
|
void mdesc_update(void);
|
|
struct mdesc_notifier_client {
|
void (*add)(struct mdesc_handle *handle, u64 node,
|
const char *node_name);
|
void (*remove)(struct mdesc_handle *handle, u64 node,
|
const char *node_name);
|
const char *node_name;
|
struct mdesc_notifier_client *next;
|
};
|
|
void mdesc_register_notifier(struct mdesc_notifier_client *client);
|
|
union md_node_info {
|
struct vdev_port {
|
u64 id; /* id */
|
u64 parent_cfg_hdl; /* parent config handle */
|
const char *name; /* name (property) */
|
} vdev_port;
|
struct ds_port {
|
u64 id; /* id */
|
} ds_port;
|
};
|
|
u64 mdesc_get_node(struct mdesc_handle *hp, const char *node_name,
|
union md_node_info *node_info);
|
int mdesc_get_node_info(struct mdesc_handle *hp, u64 node,
|
const char *node_name, union md_node_info *node_info);
|
|
void mdesc_fill_in_cpu_data(cpumask_t *mask);
|
void mdesc_populate_present_mask(cpumask_t *mask);
|
void mdesc_get_page_sizes(cpumask_t *mask, unsigned long *pgsz_mask);
|
|
void sun4v_mdesc_init(void);
|
|
#endif
|
