d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
0129d4cd2c
freebsd-skq/usr.sbin/ofwdump/ofw_util.h

51 lines
2.0 KiB
C
Raw Normal View History

Add a utility to examine the OpenFirmware device tree (on sparc64). This allows access to detailed machine configuration information, and should be especially useful to gather information for driver-related bug reports.
2002-10-18 15:37:15 +00:00
/*-
* Copyright (c) 2002 by Thomas Moestl <tmm@FreeBSD.org>.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
* INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
* USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* $FreeBSD$
*/
#ifndef OFW_UTIL_H
#define OFW_UTIL_H
#include <dev/ofw/openfirm.h>
- Change ofwdump(8) to use sysexits(3) exit codes. - Make the code use the new OFIOCMAXVALUE instead of defining the maximum length of property values locally. - Move the application specific parts from ofw_util.c to ofwdump.c in order to make ofw_util.c more library-like. While ofw_dump_properties() could be made non-specific to ofwdump(8) it's currently optimized for use in ofwdump(8) and making it a library-like function would just complicate the code unnecessarily. - Minor clean-up in ofw_util.c, e.g. make its use of getopt(3) the way it's described in style(9), make its usage() static, etc. - Add a comment in ofw_util.c about why it doesn't call usage() when neither the "-a" option nor a node-name where given. - Add ofw_optnode() and ofw_setprop(), helper functions for the OFIOCGETOPTNODE and OFIOCSET ioctls respectively, to ofw_util.[c,h]. - Be consistent with the use of 'const' in ofw_util.[c,h] and add 'const' to the function arguments that are acutally const but weren't declared as such. - Mark WARNS=6 clean. Approved by: tmm
2004-05-22 16:51:11 +00:00
int ofw_open(int);
Add a utility to examine the OpenFirmware device tree (on sparc64). This allows access to detailed machine configuration information, and should be especially useful to gather information for driver-related bug reports.
2002-10-18 15:37:15 +00:00
void ofw_close(int);
phandle_t ofw_root(int);
- Change ofwdump(8) to use sysexits(3) exit codes. - Make the code use the new OFIOCMAXVALUE instead of defining the maximum length of property values locally. - Move the application specific parts from ofw_util.c to ofwdump.c in order to make ofw_util.c more library-like. While ofw_dump_properties() could be made non-specific to ofwdump(8) it's currently optimized for use in ofwdump(8) and making it a library-like function would just complicate the code unnecessarily. - Minor clean-up in ofw_util.c, e.g. make its use of getopt(3) the way it's described in style(9), make its usage() static, etc. - Add a comment in ofw_util.c about why it doesn't call usage() when neither the "-a" option nor a node-name where given. - Add ofw_optnode() and ofw_setprop(), helper functions for the OFIOCGETOPTNODE and OFIOCSET ioctls respectively, to ofw_util.[c,h]. - Be consistent with the use of 'const' in ofw_util.[c,h] and add 'const' to the function arguments that are acutally const but weren't declared as such. - Mark WARNS=6 clean. Approved by: tmm
2004-05-22 16:51:11 +00:00
phandle_t ofw_optnode(int);
Add a utility to examine the OpenFirmware device tree (on sparc64). This allows access to detailed machine configuration information, and should be especially useful to gather information for driver-related bug reports.
2002-10-18 15:37:15 +00:00
phandle_t ofw_peer(int, phandle_t);
phandle_t ofw_child(int, phandle_t);
- Change ofwdump(8) to use sysexits(3) exit codes. - Make the code use the new OFIOCMAXVALUE instead of defining the maximum length of property values locally. - Move the application specific parts from ofw_util.c to ofwdump.c in order to make ofw_util.c more library-like. While ofw_dump_properties() could be made non-specific to ofwdump(8) it's currently optimized for use in ofwdump(8) and making it a library-like function would just complicate the code unnecessarily. - Minor clean-up in ofw_util.c, e.g. make its use of getopt(3) the way it's described in style(9), make its usage() static, etc. - Add a comment in ofw_util.c about why it doesn't call usage() when neither the "-a" option nor a node-name where given. - Add ofw_optnode() and ofw_setprop(), helper functions for the OFIOCGETOPTNODE and OFIOCSET ioctls respectively, to ofw_util.[c,h]. - Be consistent with the use of 'const' in ofw_util.[c,h] and add 'const' to the function arguments that are acutally const but weren't declared as such. - Mark WARNS=6 clean. Approved by: tmm
2004-05-22 16:51:11 +00:00
phandle_t ofw_finddevice(int, const char *);
Add a utility to examine the OpenFirmware device tree (on sparc64). This allows access to detailed machine configuration information, and should be especially useful to gather information for driver-related bug reports.
2002-10-18 15:37:15 +00:00
int ofw_firstprop(int, phandle_t, char *, int);
- Change ofwdump(8) to use sysexits(3) exit codes. - Make the code use the new OFIOCMAXVALUE instead of defining the maximum length of property values locally. - Move the application specific parts from ofw_util.c to ofwdump.c in order to make ofw_util.c more library-like. While ofw_dump_properties() could be made non-specific to ofwdump(8) it's currently optimized for use in ofwdump(8) and making it a library-like function would just complicate the code unnecessarily. - Minor clean-up in ofw_util.c, e.g. make its use of getopt(3) the way it's described in style(9), make its usage() static, etc. - Add a comment in ofw_util.c about why it doesn't call usage() when neither the "-a" option nor a node-name where given. - Add ofw_optnode() and ofw_setprop(), helper functions for the OFIOCGETOPTNODE and OFIOCSET ioctls respectively, to ofw_util.[c,h]. - Be consistent with the use of 'const' in ofw_util.[c,h] and add 'const' to the function arguments that are acutally const but weren't declared as such. - Mark WARNS=6 clean. Approved by: tmm
2004-05-22 16:51:11 +00:00
int ofw_nextprop(int, phandle_t, const char *, char *, int);
Add a utility to examine the OpenFirmware device tree (on sparc64). This allows access to detailed machine configuration information, and should be especially useful to gather information for driver-related bug reports.
2002-10-18 15:37:15 +00:00
int ofw_getprop(int, phandle_t, const char *, void *, int);
- Change ofwdump(8) to use sysexits(3) exit codes. - Make the code use the new OFIOCMAXVALUE instead of defining the maximum length of property values locally. - Move the application specific parts from ofw_util.c to ofwdump.c in order to make ofw_util.c more library-like. While ofw_dump_properties() could be made non-specific to ofwdump(8) it's currently optimized for use in ofwdump(8) and making it a library-like function would just complicate the code unnecessarily. - Minor clean-up in ofw_util.c, e.g. make its use of getopt(3) the way it's described in style(9), make its usage() static, etc. - Add a comment in ofw_util.c about why it doesn't call usage() when neither the "-a" option nor a node-name where given. - Add ofw_optnode() and ofw_setprop(), helper functions for the OFIOCGETOPTNODE and OFIOCSET ioctls respectively, to ofw_util.[c,h]. - Be consistent with the use of 'const' in ofw_util.[c,h] and add 'const' to the function arguments that are acutally const but weren't declared as such. - Mark WARNS=6 clean. Approved by: tmm
2004-05-22 16:51:11 +00:00
int ofw_setprop(int, phandle_t, const char *, const void *, int);
Autosize the property buffer instead of limiting it to 8192, and exiting if a property happens to be larger.
2003-06-11 18:44:26 +00:00
int ofw_getproplen(int, phandle_t, const char *);
int ofw_getprop_alloc(int, phandle_t, const char *, void **, int *,
int);
Add a utility to examine the OpenFirmware device tree (on sparc64). This allows access to detailed machine configuration information, and should be especially useful to gather information for driver-related bug reports.
2002-10-18 15:37:15 +00:00
#endif /* OFW_UTIL_H */
Reference in New Issue Copy Permalink