177cb4d3eSLandon J. Fuller /*- 277cb4d3eSLandon J. Fuller * Copyright (c) 2016 Landon Fuller <landonf@FreeBSD.org> 377cb4d3eSLandon J. Fuller * All rights reserved. 477cb4d3eSLandon J. Fuller * 577cb4d3eSLandon J. Fuller * Redistribution and use in source and binary forms, with or without 677cb4d3eSLandon J. Fuller * modification, are permitted provided that the following conditions 777cb4d3eSLandon J. Fuller * are met: 877cb4d3eSLandon J. Fuller * 1. Redistributions of source code must retain the above copyright 977cb4d3eSLandon J. Fuller * notice, this list of conditions and the following disclaimer, 1077cb4d3eSLandon J. Fuller * without modification. 1177cb4d3eSLandon J. Fuller * 2. Redistributions in binary form must reproduce at minimum a disclaimer 1277cb4d3eSLandon J. Fuller * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any 1377cb4d3eSLandon J. Fuller * redistribution must be conditioned upon including a substantially 1477cb4d3eSLandon J. Fuller * similar Disclaimer requirement for further binary redistribution. 1577cb4d3eSLandon J. Fuller * 1677cb4d3eSLandon J. Fuller * NO WARRANTY 1777cb4d3eSLandon J. Fuller * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 1877cb4d3eSLandon J. Fuller * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 1977cb4d3eSLandon J. Fuller * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY 2077cb4d3eSLandon J. Fuller * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 2177cb4d3eSLandon J. Fuller * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, 2277cb4d3eSLandon J. Fuller * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 2377cb4d3eSLandon J. Fuller * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 2477cb4d3eSLandon J. Fuller * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 2577cb4d3eSLandon J. Fuller * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 2677cb4d3eSLandon J. Fuller * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 2777cb4d3eSLandon J. Fuller * THE POSSIBILITY OF SUCH DAMAGES. 2877cb4d3eSLandon J. Fuller * 2977cb4d3eSLandon J. Fuller * $FreeBSD$ 3077cb4d3eSLandon J. Fuller */ 3177cb4d3eSLandon J. Fuller 3277cb4d3eSLandon J. Fuller #ifndef _BHND_NVRAM_BHND_NVRAM_DATAVAR_H_ 3377cb4d3eSLandon J. Fuller #define _BHND_NVRAM_BHND_NVRAM_DATAVAR_H_ 3477cb4d3eSLandon J. Fuller 3577cb4d3eSLandon J. Fuller #include <sys/param.h> 3677cb4d3eSLandon J. Fuller #include <sys/linker_set.h> 3777cb4d3eSLandon J. Fuller #include <sys/refcount.h> 3877cb4d3eSLandon J. Fuller 3977cb4d3eSLandon J. Fuller #include "bhnd_nvram_io.h" 4077cb4d3eSLandon J. Fuller 4177cb4d3eSLandon J. Fuller #include "bhnd_nvram_data.h" 4277cb4d3eSLandon J. Fuller 4377cb4d3eSLandon J. Fuller /** Registered NVRAM parser class instances. */ 44*58efe686SLandon J. Fuller SET_DECLARE(bhnd_nvram_data_class_set, bhnd_nvram_data_class); 4577cb4d3eSLandon J. Fuller 4677cb4d3eSLandon J. Fuller void *bhnd_nvram_data_generic_find(struct bhnd_nvram_data *nv, 4777cb4d3eSLandon J. Fuller const char *name); 4877cb4d3eSLandon J. Fuller int bhnd_nvram_data_generic_rp_getvar(struct bhnd_nvram_data *nv, 4977cb4d3eSLandon J. Fuller void *cookiep, void *outp, size_t *olen, bhnd_nvram_type otype); 5077cb4d3eSLandon J. Fuller 5177cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_class_desc() */ 5277cb4d3eSLandon J. Fuller typedef const char *(bhnd_nvram_data_op_class_desc)(void); 5377cb4d3eSLandon J. Fuller 5477cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_probe() */ 5577cb4d3eSLandon J. Fuller typedef int (bhnd_nvram_data_op_probe)(struct bhnd_nvram_io *io); 5677cb4d3eSLandon J. Fuller 5777cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_new() */ 5877cb4d3eSLandon J. Fuller typedef int (bhnd_nvram_data_op_new)(struct bhnd_nvram_data *nv, 5977cb4d3eSLandon J. Fuller struct bhnd_nvram_io *io); 6077cb4d3eSLandon J. Fuller 6177cb4d3eSLandon J. Fuller /** Free all resources associated with @p nv. Called by 6277cb4d3eSLandon J. Fuller * bhnd_nvram_data_release() when the reference count reaches zero. */ 6377cb4d3eSLandon J. Fuller typedef void (bhnd_nvram_data_op_free)(struct bhnd_nvram_data *nv); 6477cb4d3eSLandon J. Fuller 6577cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_count() */ 6677cb4d3eSLandon J. Fuller typedef size_t (bhnd_nvram_data_op_count)(struct bhnd_nvram_data *nv); 6777cb4d3eSLandon J. Fuller 6877cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_size() */ 6977cb4d3eSLandon J. Fuller typedef int (bhnd_nvram_data_op_size)(struct bhnd_nvram_data *nv, 7077cb4d3eSLandon J. Fuller size_t *len); 7177cb4d3eSLandon J. Fuller 7277cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_serialize() */ 7377cb4d3eSLandon J. Fuller typedef int (bhnd_nvram_data_op_serialize)( 7477cb4d3eSLandon J. Fuller struct bhnd_nvram_data *nv, void *buf, 7577cb4d3eSLandon J. Fuller size_t *len); 7677cb4d3eSLandon J. Fuller 7777cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_caps() */ 7877cb4d3eSLandon J. Fuller typedef uint32_t (bhnd_nvram_data_op_caps)(struct bhnd_nvram_data *nv); 7977cb4d3eSLandon J. Fuller 8077cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_next() */ 8177cb4d3eSLandon J. Fuller typedef const char *(bhnd_nvram_data_op_next)(struct bhnd_nvram_data *nv, 8277cb4d3eSLandon J. Fuller void **cookiep); 8377cb4d3eSLandon J. Fuller 8477cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_find() */ 8577cb4d3eSLandon J. Fuller typedef void *(bhnd_nvram_data_op_find)(struct bhnd_nvram_data *nv, 8677cb4d3eSLandon J. Fuller const char *name); 8777cb4d3eSLandon J. Fuller 8877cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_getvar_name() */ 8977cb4d3eSLandon J. Fuller typedef const char *(bhnd_nvram_data_op_getvar_name)( 9077cb4d3eSLandon J. Fuller struct bhnd_nvram_data *nv, void *cookiep); 9177cb4d3eSLandon J. Fuller 9277cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_getvar() */ 9377cb4d3eSLandon J. Fuller typedef int (bhnd_nvram_data_op_getvar)(struct bhnd_nvram_data *nv, 9477cb4d3eSLandon J. Fuller void *cookiep, void *buf, size_t *len, 9577cb4d3eSLandon J. Fuller bhnd_nvram_type type); 9677cb4d3eSLandon J. Fuller 9777cb4d3eSLandon J. Fuller /** @see bhnd_nvram_data_getvar_ptr() */ 9877cb4d3eSLandon J. Fuller typedef const void *(bhnd_nvram_data_op_getvar_ptr)( 9977cb4d3eSLandon J. Fuller struct bhnd_nvram_data *nv, void *cookiep, 10077cb4d3eSLandon J. Fuller size_t *len, bhnd_nvram_type *type); 10177cb4d3eSLandon J. Fuller 10277cb4d3eSLandon J. Fuller /** 10377cb4d3eSLandon J. Fuller * NVRAM data class. 10477cb4d3eSLandon J. Fuller */ 10577cb4d3eSLandon J. Fuller struct bhnd_nvram_data_class { 10677cb4d3eSLandon J. Fuller const char *desc; /**< description */ 10777cb4d3eSLandon J. Fuller size_t size; /**< instance size */ 10877cb4d3eSLandon J. Fuller bhnd_nvram_data_op_probe *op_probe; 10977cb4d3eSLandon J. Fuller bhnd_nvram_data_op_new *op_new; 11077cb4d3eSLandon J. Fuller bhnd_nvram_data_op_free *op_free; 11177cb4d3eSLandon J. Fuller bhnd_nvram_data_op_count *op_count; 11277cb4d3eSLandon J. Fuller bhnd_nvram_data_op_size *op_size; 11377cb4d3eSLandon J. Fuller bhnd_nvram_data_op_serialize *op_serialize; 11477cb4d3eSLandon J. Fuller bhnd_nvram_data_op_caps *op_caps; 11577cb4d3eSLandon J. Fuller bhnd_nvram_data_op_next *op_next; 11677cb4d3eSLandon J. Fuller bhnd_nvram_data_op_find *op_find; 11777cb4d3eSLandon J. Fuller bhnd_nvram_data_op_getvar *op_getvar; 11877cb4d3eSLandon J. Fuller bhnd_nvram_data_op_getvar_ptr *op_getvar_ptr; 11977cb4d3eSLandon J. Fuller bhnd_nvram_data_op_getvar_name *op_getvar_name; 12077cb4d3eSLandon J. Fuller }; 12177cb4d3eSLandon J. Fuller 12277cb4d3eSLandon J. Fuller /** 12377cb4d3eSLandon J. Fuller * NVRAM data instance. 12477cb4d3eSLandon J. Fuller */ 12577cb4d3eSLandon J. Fuller struct bhnd_nvram_data { 12677cb4d3eSLandon J. Fuller struct bhnd_nvram_data_class *cls; 12777cb4d3eSLandon J. Fuller volatile u_int refs; 12877cb4d3eSLandon J. Fuller }; 12977cb4d3eSLandon J. Fuller 13077cb4d3eSLandon J. Fuller /* 13177cb4d3eSLandon J. Fuller * Helper macro for BHND_NVRAM_DATA_CLASS_DEFN(). 13277cb4d3eSLandon J. Fuller * 13377cb4d3eSLandon J. Fuller * Declares a bhnd_nvram_data_class method implementation with class name 13477cb4d3eSLandon J. Fuller * _cname and method name _mname 13577cb4d3eSLandon J. Fuller */ 13677cb4d3eSLandon J. Fuller #define BHND_NVRAM_DATA_CLASS_DECL_METHOD(_cname, _mname) \ 13777cb4d3eSLandon J. Fuller static bhnd_nvram_data_op_ ## _mname \ 13877cb4d3eSLandon J. Fuller bhnd_nvram_ ## _cname ## _ ## _mname; \ 13977cb4d3eSLandon J. Fuller 14077cb4d3eSLandon J. Fuller /* 14177cb4d3eSLandon J. Fuller * Helper macro for BHND_NVRAM_DATA_CLASS_DEFN(). 14277cb4d3eSLandon J. Fuller * 14377cb4d3eSLandon J. Fuller * Assign a bhnd_nvram_data_class method implementation with class name 14477cb4d3eSLandon J. Fuller * @p _cname and method name @p _mname 14577cb4d3eSLandon J. Fuller */ 14677cb4d3eSLandon J. Fuller #define BHND_NVRAM_DATA_CLASS_ASSIGN_METHOD(_cname, _mname) \ 14777cb4d3eSLandon J. Fuller .op_ ## _mname = bhnd_nvram_ ## _cname ## _ ## _mname, 14877cb4d3eSLandon J. Fuller 14977cb4d3eSLandon J. Fuller /* 15077cb4d3eSLandon J. Fuller * Helper macro for BHND_NVRAM_DATA_CLASS_DEFN(). 15177cb4d3eSLandon J. Fuller * 15277cb4d3eSLandon J. Fuller * Iterate over all bhnd_nvram_data_class method names, calling 15377cb4d3eSLandon J. Fuller * _macro with the class name _cname as the first argument, and 15477cb4d3eSLandon J. Fuller * a bhnd_nvram_data_class method name as the second. 15577cb4d3eSLandon J. Fuller */ 15677cb4d3eSLandon J. Fuller #define BHND_NVRAM_DATA_CLASS_ITER_METHODS(_cname, _macro) \ 15777cb4d3eSLandon J. Fuller _macro(_cname, probe) \ 15877cb4d3eSLandon J. Fuller _macro(_cname, new) \ 15977cb4d3eSLandon J. Fuller _macro(_cname, free) \ 16077cb4d3eSLandon J. Fuller _macro(_cname, count) \ 16177cb4d3eSLandon J. Fuller _macro(_cname, size) \ 16277cb4d3eSLandon J. Fuller _macro(_cname, serialize) \ 16377cb4d3eSLandon J. Fuller _macro(_cname, caps) \ 16477cb4d3eSLandon J. Fuller _macro(_cname, next) \ 16577cb4d3eSLandon J. Fuller _macro(_cname, find) \ 16677cb4d3eSLandon J. Fuller _macro(_cname, getvar) \ 16777cb4d3eSLandon J. Fuller _macro(_cname, getvar_ptr) \ 16877cb4d3eSLandon J. Fuller _macro(_cname, getvar_name) 16977cb4d3eSLandon J. Fuller 17077cb4d3eSLandon J. Fuller /** 17177cb4d3eSLandon J. Fuller * Define a bhnd_nvram_data_class with class name @p _n and description 17277cb4d3eSLandon J. Fuller * @p _desc, and register with bhnd_nvram_data_class_set. 17377cb4d3eSLandon J. Fuller */ 17477cb4d3eSLandon J. Fuller #define BHND_NVRAM_DATA_CLASS_DEFN(_cname, _desc, _size) \ 17577cb4d3eSLandon J. Fuller BHND_NVRAM_DATA_CLASS_ITER_METHODS(_cname, \ 17677cb4d3eSLandon J. Fuller BHND_NVRAM_DATA_CLASS_DECL_METHOD) \ 17777cb4d3eSLandon J. Fuller \ 17877cb4d3eSLandon J. Fuller struct bhnd_nvram_data_class bhnd_nvram_## _cname ## _class = { \ 17977cb4d3eSLandon J. Fuller .desc = (_desc), \ 18077cb4d3eSLandon J. Fuller .size = (_size), \ 18177cb4d3eSLandon J. Fuller BHND_NVRAM_DATA_CLASS_ITER_METHODS(_cname, \ 18277cb4d3eSLandon J. Fuller BHND_NVRAM_DATA_CLASS_ASSIGN_METHOD) \ 18377cb4d3eSLandon J. Fuller }; \ 18477cb4d3eSLandon J. Fuller \ 18577cb4d3eSLandon J. Fuller DATA_SET(bhnd_nvram_data_class_set, \ 18677cb4d3eSLandon J. Fuller bhnd_nvram_## _cname ## _class); 18777cb4d3eSLandon J. Fuller 18877cb4d3eSLandon J. Fuller #endif /* _BHND_NVRAM_BHND_NVRAM_DATAVAR_H_ */ 189