/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */

/*
 * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */
/*
 * Copyright (c) 2018, Joyent, Inc. All rights reserved.
 */

#ifndef _TOPO_PARSE_H
#define _TOPO_PARSE_H

#include <sys/types.h>
#include <libxml/parser.h>
#include <libnvpair.h>
#include <fm/libtopo.h>
#include <fm/topo_mod.h>

#ifdef  __cplusplus
extern "C" {
#endif

#define TOPO_DTD_PATH   "/usr/share/lib/xml/dtd/topology.dtd.1"

/*
 * Plenty of room to hold string representation of an instance
 * number
 */
#define MAXINSTSTRLEN   64

/*
 * Forward declaration
 */
struct tf_rdata;
struct tf_info;

/*
 * This structure summarizes an enumerator as described by an xml
 * topology file.
 */
typedef struct tf_edata {
        char *te_name;          /* name of the enumerator, if any */
        topo_stability_t te_stab; /* stability of the enumerator, if any */
        topo_version_t te_vers;         /* version of the enumerator, if any */
} tf_edata_t;

/* properties and dependents off of an instance or a range */
typedef struct tf_pad {
        int tpad_pgcnt;         /* number of property-groups of node */
        int tpad_dcnt;          /* number of dependents groups of node */
        nvlist_t **tpad_pgs;    /* property-groups as nvlists */
        struct tf_rdata *tpad_child; /* children ranges */
        struct tf_rdata *tpad_sibs; /* sibling ranges */
} tf_pad_t;

typedef struct tf_idata {
        struct tf_idata *ti_next; /* next instance */
        topo_instance_t ti_i;   /* hard instance */
        tnode_t *ti_tn;         /* topology node representing the instance */
        tf_pad_t *ti_pad;       /* properties and dependents */
} tf_idata_t;

/*
 * This structure summarizes a topology node range as described by a
 * topology file.
 */
typedef struct tf_rdata {
        struct tf_rdata *rd_next; /* for linking a group of tf_rdatas */
        int rd_cnt;             /* number of tf_rdatas in the list */
        struct tf_info *rd_finfo; /* pointer back to .xml file details */
        topo_mod_t *rd_mod;     /* pointer to loaded enumerator */
        tnode_t *rd_pn;         /* parent topology node */
        char *rd_name;          /* node name */
        int rd_min;             /* minimum instance number of node */
        int rd_max;             /* maximum instance number of node */
        tf_edata_t *rd_einfo;   /* enumerator information, if any */
        struct tf_idata *rd_instances; /* hard instances */
        tf_pad_t *rd_pad;       /* properties and dependents */
} tf_rdata_t;

/*
 * While we're parsing we need a handy way to pass around the data
 * related to what we're currently parsing, what topology nodes may be
 * affected, etc.
 */
typedef struct tf_info {
        char *tf_scheme;        /* scheme of topology in file */
        /* UUID ? */
        uint_t tf_flags;        /* behavior modifiers (see values below) */
        xmlDocPtr tf_xdoc;      /* the parsed xml doc */
        tf_rdata_t *tf_rd;      /* data for forming topology nodes */
} tf_info_t;

#define TF_LIVE         0x1     /* Parsing should create topology nodes */
#define TF_BIN          0x2     /* Parsing should create intermediate binary */
#define TF_PROPMAP      0x4     /* XML file loaded from a propmap element */

/*
 * We store properties using nvlists as an intermediate form.  The
 * following defines are names for fields in this intermediate form.
 */
#define INV_IMMUTE      "prop-immutable"
#define INV_PGRP_ALLPROPS "propgrp-props"
#define INV_PGRP_NAME   "propgrp-name"
#define INV_PGRP_NPROP  "propgrp-numprops"
#define INV_PGRP_NMSTAB "propgrp-name-stability"
#define INV_PGRP_DSTAB  "propgrp-data-stability"
#define INV_PGRP_VER    "propgrp-version"
#define INV_PNAME       "prop-name"
#define INV_PVAL        "prop-val"
#define INV_PVALTYPE    "prop-valtype"

/*
 * Valid .xml element and attribute names
 */
#define Argitem "argitem"
#define Argval "argval"
#define Children "children"
#define Dependents "dependents"
#define Double  "double"
#define Facility        "facility"
#define FMRI "fmri"
#define FMRI_Arr "fmri_array"
#define Grouping "grouping"
#define Immutable "immutable"
#define Indicator       "indicator"
#define Instance "instance"
#define Int32 "int32"
#define Int32_Arr "int32_array"
#define Int64 "int64"
#define Int64_Arr "int64_array"
#define Ipmi    "ipmi"
#define Mutable "mutable"
#define Name "name"
#define Nonvolatile "nonvolatile"
#define Propitem "propitem"
#define Propname "propname"
#define Proptype "proptype"
#define Provider "provider"
#define Range "range"
#define Scheme "scheme"
#define Set "set"
#define Setlist "setlist"
#define Sensor  "sensor"
#define Siblings "siblings"
#define Static "static"
#define String "string"
#define String_Arr "string_array"
#define Topology "topology"
#define Type "type"
#define UInt32 "uint32"
#define UInt32_Arr "uint32_array"
#define UInt64 "uint64"
#define UInt64_Arr "uint64_array"
#define Value "value"
#define Verify "verify"
#define Version "version"
#define Min "min"
#define Max "max"

#define Enum_meth "enum-method"
#define Prop_meth "propmethod"
#define Propgrp "propgroup"
#define Propval "propval"
#define Propmap "propmap"

#define Node "node"
#define Hc "hc"

#define True "true"
#define False "false"

#define Namestab "name-stability"
#define Datastab "data-stability"

#define Evolving "Evolving"
#define External "External"
#define Internal "Internal"
#define Obsolete "Obsolete"
#define Private "Private"
#define Stable "Stable"
#define Standard "Standard"
#define Unstable "Unstable"

extern tf_idata_t *tf_idata_lookup(tf_idata_t *, topo_instance_t);
extern tf_rdata_t *tf_rdata_new(topo_mod_t *,
    tf_info_t *, xmlNodePtr, tnode_t *);
extern tf_idata_t *tf_idata_new(topo_mod_t *, topo_instance_t, tnode_t *);
extern tf_info_t *topo_xml_read(topo_mod_t *, const char *, const char *);
extern tf_info_t *tf_info_new(topo_mod_t *, xmlDocPtr, xmlChar *);
extern tf_pad_t *tf_pad_new(topo_mod_t *, int, int);
extern void topo_xml_cleanup(topo_mod_t *, tf_info_t *);
extern void tf_rdata_free(topo_mod_t *, tf_rdata_t *);
extern void tf_edata_free(topo_mod_t *, tf_edata_t *);
extern void tf_idata_free(topo_mod_t *, tf_idata_t *);
extern void tf_info_free(topo_mod_t *, tf_info_t *);
extern void tf_pad_free(topo_mod_t *, tf_pad_t *);
extern int topo_xml_range_process(topo_mod_t *, xmlNodePtr, tf_rdata_t *);
extern int topo_xml_enum(topo_mod_t *, tf_info_t *, tnode_t *);
extern int tf_idata_insert(tf_idata_t **, tf_idata_t *);
extern int xmlattr_to_int(topo_mod_t *, xmlNodePtr, const char *, uint64_t *);
extern int xmlattr_to_stab(topo_mod_t *, xmlNodePtr, const char *,
    topo_stability_t *);

#ifdef  __cplusplus
}
#endif

#endif  /* _TOPO_PARSE_H */