diff options
Diffstat (limited to 'cmd')
-rw-r--r-- | cmd/GPL | 272 | ||||
-rw-r--r-- | cmd/Makefile | 20 | ||||
-rw-r--r-- | cmd/lsbus.c | 492 | ||||
-rw-r--r-- | cmd/systool.c | 706 |
4 files changed, 1490 insertions, 0 deletions
@@ -0,0 +1,272 @@ + + The GNU General Public License (GPL) + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your freedom to + share and change it. By contrast, the GNU General Public License is + intended to guarantee your freedom to share and change free software--to + make sure the software is free for all its users. This General Public + License applies to most of the Free Software Foundation's software and to + any other program whose authors commit to using it. (Some other Free + Software Foundation software is covered by the GNU Library General Public + License instead.) You can apply it to your programs, too. + + When we speak of free software, we are referring to freedom, not price. + Our General Public Licenses are designed to make sure that you have the + freedom to distribute copies of free software (and charge for this service + if you wish), that you receive source code or can get it if you want it, + that you can change the software or use pieces of it in new free programs; + and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid anyone to + deny you these rights or to ask you to surrender the rights. These + restrictions translate to certain responsibilities for you if you + distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether gratis or + for a fee, you must give the recipients all the rights that you have. You + must make sure that they, too, receive or can get the source code. And you + must show them these terms so they know their rights. + + We protect your rights with two steps: (1) copyright the software, and (2) + offer you this license which gives you legal permission to copy, + distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain that + everyone understands that there is no warranty for this free software. If + the software is modified by someone else and passed on, we want its + recipients to know that what they have is not the original, so that any + problems introduced by others will not reflect on the original authors' + reputations. + + Finally, any free program is threatened constantly by software patents. We + wish to avoid the danger that redistributors of a free program will + individually obtain patent licenses, in effect making the program + proprietary. To prevent this, we have made it clear that any patent must + be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and + modification follow. + + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains a + notice placed by the copyright holder saying it may be distributed under + the terms of this General Public License. The "Program", below, refers to + any such program or work, and a "work based on the Program" means either + the Program or any derivative work under copyright law: that is to say, a + work containing the Program or a portion of it, either verbatim or with + modifications and/or translated into another language. (Hereinafter, + translation is included without limitation in the term "modification".) + Each licensee is addressed as "you". + + Activities other than copying, distribution and modification are not + covered by this License; they are outside its scope. The act of running + the Program is not restricted, and the output from the Program is covered + only if its contents constitute a work based on the Program (independent + of having been made by running the Program). Whether that is true depends + on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's source + code as you receive it, in any medium, provided that you conspicuously and + appropriately publish on each copy an appropriate copyright notice and + disclaimer of warranty; keep intact all the notices that refer to this + License and to the absence of any warranty; and give any other recipients + of the Program a copy of this License along with the Program. + + You may charge a fee for the physical act of transferring a copy, and you + may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion of it, + thus forming a work based on the Program, and copy and distribute such + modifications or work under the terms of Section 1 above, provided that + you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices stating + that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in whole + or in part contains or is derived from the Program or any part thereof, + to be licensed as a whole at no charge to all third parties under the + terms of this License. + + c) If the modified program normally reads commands interactively when + run, you must cause it, when started running for such interactive use in + the most ordinary way, to print or display an announcement including an + appropriate copyright notice and a notice that there is no warranty (or + else, saying that you provide a warranty) and that users may + redistribute the program under these conditions, and telling the user + how to view a copy of this License. (Exception: if the Program itself is + interactive but does not normally print such an announcement, your work + based on the Program is not required to print an announcement.) + + These requirements apply to the modified work as a whole. If identifiable + sections of that work are not derived from the Program, and can be + reasonably considered independent and separate works in themselves, then + this License, and its terms, do not apply to those sections when you + distribute them as separate works. But when you distribute the same + sections as part of a whole which is a work based on the Program, the + distribution of the whole must be on the terms of this License, whose + permissions for other licensees extend to the entire whole, and thus to + each and every part regardless of who wrote it. + + Thus, it is not the intent of this section to claim rights or contest your + rights to work written entirely by you; rather, the intent is to exercise + the right to control the distribution of derivative or collective works + based on the Program. + + In addition, mere aggregation of another work not based on the Program + with the Program (or with a work based on the Program) on a volume of a + storage or distribution medium does not bring the other work under the + scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, under + Section 2) in object code or executable form under the terms of Sections 1 + and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable source + code, which must be distributed under the terms of Sections 1 and 2 + above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three years, to + give any third party, for a charge no more than your cost of physically + performing source distribution, a complete machine-readable copy of the + corresponding source code, to be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer to + distribute corresponding source code. (This alternative is allowed only + for noncommercial distribution and only if you received the program in + object code or executable form with such an offer, in accord with + Subsection b above.) + + The source code for a work means the preferred form of the work for making + modifications to it. For an executable work, complete source code means + all the source code for all modules it contains, plus any associated + interface definition files, plus the scripts used to control compilation + and installation of the executable. However, as a special exception, the + source code distributed need not include anything that is normally + distributed (in either source or binary form) with the major components + (compiler, kernel, and so on) of the operating system on which the + executable runs, unless that component itself accompanies the executable. + + If distribution of executable or object code is made by offering access to + copy from a designated place, then offering equivalent access to copy the + source code from the same place counts as distribution of the source code, + even though third parties are not compelled to copy the source along with + the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program except + as expressly provided under this License. Any attempt otherwise to copy, + modify, sublicense or distribute the Program is void, and will + automatically terminate your rights under this License. However, parties + who have received copies, or rights, from you under this License will not + have their licenses terminated so long as such parties remain in full + compliance. + + 5. You are not required to accept this License, since you have not signed + it. However, nothing else grants you permission to modify or distribute + the Program or its derivative works. These actions are prohibited by law + if you do not accept this License. Therefore, by modifying or distributing + the Program (or any work based on the Program), you indicate your + acceptance of this License to do so, and all its terms and conditions for + copying, distributing or modifying the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the + Program), the recipient automatically receives a license from the original + licensor to copy, distribute or modify the Program subject to these terms + and conditions. You may not impose any further restrictions on the + recipients' exercise of the rights granted herein. You are not responsible + for enforcing compliance by third parties to this License. + + 7. If, as a consequence of a court judgment or allegation of patent + infringement or for any other reason (not limited to patent issues), + conditions are imposed on you (whether by court order, agreement or + otherwise) that contradict the conditions of this License, they do not + excuse you from the conditions of this License. If you cannot distribute + so as to satisfy simultaneously your obligations under this License and + any other pertinent obligations, then as a consequence you may not + distribute the Program at all. For example, if a patent license would not + permit royalty-free redistribution of the Program by all those who receive + copies directly or indirectly through you, then the only way you could + satisfy both it and this License would be to refrain entirely from + distribution of the Program. + + If any portion of this section is held invalid or unenforceable under any + particular circumstance, the balance of the section is intended to apply + and the section as a whole is intended to apply in other circumstances. + + It is not the purpose of this section to induce you to infringe any + patents or other property right claims or to contest validity of any such + claims; this section has the sole purpose of protecting the integrity of + the free software distribution system, which is implemented by public + license practices. Many people have made generous contributions to the + wide range of software distributed through that system in reliance on + consistent application of that system; it is up to the author/donor to + decide if he or she is willing to distribute software through any other + system and a licensee cannot impose that choice. + + This section is intended to make thoroughly clear what is believed to be a + consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in certain + countries either by patents or by copyrighted interfaces, the original + copyright holder who places the Program under this License may add an + explicit geographical distribution limitation excluding those countries, + so that distribution is permitted only in or among countries not thus + excluded. In such case, this License incorporates the limitation as if + written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions of + the General Public License from time to time. Such new versions will be + similar in spirit to the present version, but may differ in detail to + address new problems or concerns. + + Each version is given a distinguishing version number. If the Program + specifies a version number of this License which applies to it and "any + later version", you have the option of following the terms and conditions + either of that version or of any later version published by the Free + Software Foundation. If the Program does not specify a version number of + this License, you may choose any version ever published by the Free + Software Foundation. + + 10. If you wish to incorporate parts of the Program into other free + programs whose distribution conditions are different, write to the author + to ask for permission. For software which is copyrighted by the Free + Software Foundation, write to the Free Software Foundation; we sometimes + make exceptions for this. Our decision will be guided by the two goals of + preserving the free status of all derivatives of our free software and of + promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY + FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN + OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES + PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED + OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS + TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE + PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, + REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING + WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR + REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, + INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES + ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT + LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES + SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE + WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN + ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + diff --git a/cmd/Makefile b/cmd/Makefile new file mode 100644 index 0000000..d53677e --- /dev/null +++ b/cmd/Makefile @@ -0,0 +1,20 @@ +# System utilities makefile + +CC=gcc + +CFLAGS=-g -Wall +INCLUDE=../include +LIB=../lib + +RM=rm -f + +all: lsbus systool + +lsbus: lsbus.c + $(CC) $(CFLAGS) -I$(INCLUDE) -o lsbus lsbus.c -lsysfs -L$(LIB) + +systool: systool.c + $(CC) $(CFLAGS) -I$(INCLUDE) -o systool systool.c -lsysfs -L$(LIB) + +clean: + $(RM) *.o *~ lsbus systool diff --git a/cmd/lsbus.c b/cmd/lsbus.c new file mode 100644 index 0000000..bd4676f --- /dev/null +++ b/cmd/lsbus.c @@ -0,0 +1,492 @@ +/* + * lsbus.c + * + * Utility to list bus devices + * + * Copyright (C) 2003 International Business Machines, Inc. + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the + * Free Software Foundation version 2 of the License. + * + * This program is distributed in the hope that it will be useful, but + * WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * General Public License for more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <string.h> +#include <mntent.h> +#include <dirent.h> +#include <sys/stat.h> +#include <fcntl.h> +#include <errno.h> +#include <ctype.h> + +#include "libsysfs.h" + +/* Command Options */ +static int show_options = 0; /* bitmask of show options */ +static char *attr_to_show = NULL; /* print value for this attribute */ +static char *bus_device = NULL; /* print only this bus device */ + +#define SHOW_ATTRIBUTES 0x01 /* show attributes command option */ +#define SHOW_ATTRIBUTE_VALUE 0x02 /* show an attribute value option */ +#define SHOW_DEVICES 0x04 /* show only devices option */ +#define SHOW_DRIVERS 0x08 /* show only drivers option */ +#define SHOW_ALL_ATTRIB_VALUES 0x10 /* show all attributes with values */ + +#define SHOW_ALL 0xff + +static char cmd_options[] = "aA:dDhv"; + +/* + * binary_files - defines existing sysfs binary files that should be printed + * in hex. + */ +static char *binary_files[] = { + "config", + "data" +}; + +static int binfiles = 2; + +/** + * usage: prints utility usage. + */ +void usage(void) +{ + fprintf(stdout, "Usage: lsbus [<options> bus [device]]\n"); + fprintf(stdout, "\t-a\t\t\tShow attributes\n"); + fprintf(stdout, "\t-d\t\t\tShow only devices\n"); + fprintf(stdout, "\t-h\t\t\tShow usage\n"); + fprintf(stdout, "\t-v\t\t\tShow all attributes with values\n"); + fprintf(stdout, "\t-A <attribute_name>\tShow attribute value\n"); + fprintf(stdout, "\t-D\t\t\tShow only drivers\n"); +} + +/** + * remove_end_newline: removes newline on the end of an attribute value + * @value: string to remove newline from + */ +void remove_end_newline(char *value) +{ + char *p = value + (strlen(value) - 1); + + if (p != NULL && *p == '\n') + *p = '\0'; +} + +/** + * print_device_children: prints out device subdirs. + * @sdir: print this directory's subdirectories/children. + */ +void print_device_children(struct sysfs_directory *sdir) +{ + if (sdir != NULL) { + fprintf(stdout, "\tChildren:\n"); + if (sdir->subdirs != NULL) { + char dirname[SYSFS_NAME_LEN]; + struct sysfs_directory *cur = sdir->subdirs; + + while (cur != NULL) { + if ((sysfs_get_name_from_path(cur->path, + dirname, SYSFS_NAME_LEN)) == 0) + fprintf(stdout, "\t\t%s\n", dirname); + else + fprintf(stdout, "\t\t%s\n", cur->path); + cur = cur->next; + } + } + if (sdir->links != NULL) { + struct sysfs_link *curl = sdir->links; + + while(curl != NULL) { + fprintf(stdout, "\t\t%s\n", curl->name); + curl = curl->next; + } + } + } +} + +/** + * isbinaryvalue: checks to see if attribute is binary or not. + * @attr: attribute to check. + * returns 1 if binary or 0 if not. + */ +int isbinaryvalue(struct sysfs_attribute *attr) +{ + char attrname[SYSFS_NAME_LEN]; + int i; + + if (attr == NULL || attr->value == NULL) + return 0; + if ((sysfs_get_name_from_path(attr->path, attrname, SYSFS_NAME_LEN)) + != 0) + return 0; + + for (i = 0; i < binfiles; i++) + if ((strcmp(attrname, binary_files[i])) == 0) + return 1; + + return 0; +} + +/** + * print_attribute_value: prints out single attribute value. + * @attr: attricute to print. + */ +void print_attribute_value(struct sysfs_attribute *attr) +{ + if (attr == NULL) + return; + + if (attr->method & SYSFS_METHOD_SHOW) { + if (isbinaryvalue(attr) != 0) { + int i; + fprintf(stdout, "\t: "); + for (i = 0; i < attr->len; i++) { + if (!(i %16)) { + fprintf(stdout, "\n\t\t\t"); + } else if (!(i %8)) + fprintf(stdout, " "); + fprintf(stdout, "%02x ", + (unsigned char)attr->value[i]); + } + fprintf(stdout, "\n"); + + } else if (attr->value != NULL && strlen(attr->value) > 0) { + remove_end_newline(attr->value); + fprintf(stdout, "\t: %s\n", attr->value); + } else + fprintf(stdout, "\n"); + } else { + fprintf(stdout, "\t: store method only\n"); + } +} + +/** + * print_attribute: prints out a single attribute + * @attr: attribute to print. + */ +void print_attribute(struct sysfs_attribute *attr) +{ + char attrname[SYSFS_NAME_LEN]; + + if (attr == NULL) + return; + + if ((sysfs_get_name_from_path(attr->path, attrname, SYSFS_NAME_LEN)) + != 0) + return; + + if (show_options & SHOW_ALL_ATTRIB_VALUES) { + fprintf(stdout, "\t\t%s", attrname); + print_attribute_value(attr); + + } else if ((show_options & SHOW_ATTRIBUTES) || ((show_options + & SHOW_ATTRIBUTE_VALUE) && (strcmp(attrname, attr_to_show) + == 0))) { + fprintf (stdout, "\t\t%s", attrname); + if (show_options & SHOW_ATTRIBUTE_VALUE && attr->value != NULL + && (strcmp(attrname, attr_to_show)) == 0) { + print_attribute_value(attr); + } else { + fprintf(stdout, "\n"); + } + } +} + +/** + * print_device_attributes: prints out device attributes. + * @sdir: print this directory's attributes/files. + */ +void print_device_attributes(struct sysfs_directory *sdir) +{ + if (sdir != NULL && sdir->attributes != NULL) { + struct sysfs_attribute *cur = sdir->attributes; + + fprintf (stdout, "\tAttributes:\n"); + while (cur != NULL) { + print_attribute(cur); + cur = cur->next; + } + } +} + +/** + * print_device: prints out device information. + * @device: device to print. + */ +void print_device(struct sysfs_device *device) +{ + if (device != NULL && device->directory != NULL) { + fprintf (stdout, " %s %s\n", device->bus_id, device->name); + if (device->directory->subdirs != NULL + || device->directory->links != NULL) + print_device_children(device->directory); + if (device->directory->attributes != NULL && (show_options + & (SHOW_ATTRIBUTES | SHOW_ATTRIBUTE_VALUE + | SHOW_ALL_ATTRIB_VALUES))) + print_device_attributes(device->directory); + if (device->driver != NULL) + fprintf (stdout, "\tDriver: %s\n", + device->driver->name); + } +} + +/** + * print_driver_attributes: prints out driver attributes . + * @driver: print this driver's attributes. + */ +void print_driver_attributes(struct sysfs_driver *driver) +{ + if (driver != NULL && driver->directory != NULL) { + struct sysfs_directory *sdir = driver->directory; + + if (sdir->attributes != NULL) { + struct sysfs_attribute *cur = sdir->attributes; + + fprintf (stdout, "\t%s Attributes:\n", driver->name); + while (cur != NULL) { + print_attribute(cur); + cur = cur->next; + } + } + } +} + +/** + * print_driver_devices: prints out devices under driver. + * @driver: print devices bound to this driver. + */ +void print_driver_devices(struct sysfs_driver *driver) +{ + if (driver != NULL && driver->directory != NULL) { + struct sysfs_directory *sdir = driver->directory; + + if (sdir->links != NULL) { + struct sysfs_link *cur = sdir->links; + + fprintf (stdout, "\tDevices:\n"); + while (cur != NULL) { + fprintf(stdout, "\t\t%s\n", cur->name); + cur = cur->next; + } + } + } +} + +/** + * print_driver: prints out driver information. + * @driver: driver to print. + */ +void print_driver(struct sysfs_driver *driver) +{ + struct sysfs_directory *sdir = NULL; + + if (driver != NULL) { + fprintf (stdout, " %s\n", driver->name); + sdir = driver->directory; + if (sdir != NULL) { + if (sdir->links != NULL) + print_driver_devices(driver); + if(sdir->attributes != NULL && (show_options + & (SHOW_ATTRIBUTES | SHOW_ATTRIBUTE_VALUE + | SHOW_ALL_ATTRIB_VALUES))) + print_driver_attributes(driver); + } + } +} + +/** + * print_default_bus: prints out everything on a bus. + * @busname: bus to print. + * returns 0 with success or 1 with error. + */ +int print_sysfs_bus(char *busname) +{ + struct sysfs_bus *bus = NULL; + struct sysfs_device *curdev = NULL; + struct sysfs_driver *curdrv = NULL; + + if (busname == NULL) { + errno = EINVAL; + return 1; + } + bus = sysfs_open_bus(busname); + if (bus == NULL) { + fprintf(stderr, "Error opening bus %s\n", busname); + return 1; + } + + fprintf(stdout, "Bus: %s\n", busname); + if (bus->devices != NULL && (show_options & SHOW_DEVICES)) { + curdev = bus->devices; + if (bus_device == NULL) + fprintf(stdout, "Devices:\n"); + while (curdev != NULL) { + if (bus_device == NULL || (strcmp(bus_device, + curdev->bus_id) == 0)) + print_device(curdev); + curdev = curdev->next; + } + } + if (bus->drivers != NULL && (show_options & SHOW_DRIVERS)) { + curdrv = bus->drivers; + fprintf(stdout, "Drivers:\n"); + while (curdrv != NULL) { + print_driver(curdrv); + curdrv = curdrv->next; + } + } + sysfs_close_bus(bus); + return 0; +} + +/** + * print_sysfs_buses: prints out supported buses. + * @buses: list of supported system buses. + * returns 0 with success or 1 with error. + */ +int print_sysfs_buses(void) +{ + struct sysfs_directory *busdir = NULL, *current = NULL; + char busname[SYSFS_NAME_LEN]; + char buspath[SYSFS_PATH_MAX]; + int ret = 0; + + /* get sysfs mount point */ + if ((sysfs_get_mnt_path(buspath, SYSFS_PATH_MAX) != 0)) { + perror("sysfs_get_mnt_path"); + fprintf(stderr, "Error getting sysfs mount path - exiting\n"); + exit(1); + } + strcat(buspath, SYSFS_BUS_DIR); + busdir = sysfs_open_directory(buspath); + if (busdir == NULL) { + fprintf(stderr, "Error opening sysfs bus directory at %s\n", + buspath); + return 1; + } + if ((sysfs_read_directory(busdir)) != 0) { + fprintf(stderr, "Error reading sysfs bus directory at %s\n", + buspath); + sysfs_close_directory(busdir); + return 1; + } + + fprintf(stdout, "Supported sysfs buses:\n"); + current = busdir->subdirs; + while (current != NULL) { + if ((sysfs_get_name_from_path(current->path, busname, + SYSFS_NAME_LEN)) != 0) { + sysfs_close_directory(busdir); + return 1; + } + fprintf(stdout, "\t%s\n", busname); + current = current->next; + } + sysfs_close_directory(busdir); + return ret; +} + +/* MAIN */ +int main(int argc, char *argv[]) +{ + char *bus_to_print = NULL; + int retval = 0; + int opt; + extern int optind; + extern char *optarg; + + while((opt = getopt(argc, argv, cmd_options)) != EOF) { + switch(opt) { + case 'a': + show_options |= SHOW_ATTRIBUTES; + break; + case 'A': + if ((strlen(optarg) + 1) > SYSFS_NAME_LEN) { + fprintf(stderr, + "Attribute name %s is too long\n", + optarg); + exit(1); + } + attr_to_show = optarg; + show_options |= SHOW_ATTRIBUTE_VALUE; + break; + case 'd': + show_options |= SHOW_DEVICES; + break; + case 'D': + show_options |= SHOW_DRIVERS; + break; + case 'h': + usage(); + exit(0); + break; + case 'v': + show_options |= SHOW_ALL_ATTRIB_VALUES; + break; + default: + usage(); + exit(1); + } + } + argc -= optind; + argv += optind; + + switch(argc) { + case 0: + break; + case 1: + /* get bus to view */ + if ((strlen(*argv)+1) < SYSFS_NAME_LEN) + bus_to_print = *argv; + else + fprintf(stderr, + "Invalid argument: busname too long\n"); + break; + case 2: + /* get bus and device to view */ + if ((strlen(argv[0])) < SYSFS_NAME_LEN && (strlen(argv[1])) + < SYSFS_NAME_LEN) { + bus_to_print = argv[0]; + bus_device = argv[1]; + show_options |= SHOW_DEVICES; + } else { + fprintf(stderr, + "Invalid argument: bus or device name too long\n"); + exit(1); + } + break; + default: + usage(); + exit(1); + } + + if (bus_to_print == NULL && (show_options & (SHOW_ATTRIBUTES + | SHOW_ATTRIBUTE_VALUE | SHOW_DEVICES | SHOW_DRIVERS + | SHOW_ALL_ATTRIB_VALUES))) { + fprintf(stderr, "Please specify a bus\n"); + usage(); + exit(1); + } + /* default is to print devices */ + if (!(show_options & (SHOW_DEVICES | SHOW_DRIVERS))) + show_options |= SHOW_DEVICES; + + if (bus_to_print != NULL) + retval = print_sysfs_bus(bus_to_print); + else + retval = print_sysfs_buses(); + + exit(retval); +} diff --git a/cmd/systool.c b/cmd/systool.c new file mode 100644 index 0000000..60c8d67 --- /dev/null +++ b/cmd/systool.c @@ -0,0 +1,706 @@ +/* + * systool.c + * + * Sysfs utility to list buses, classes, and devices + * + * Copyright (C) 2003 International Business Machines, Inc. + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the + * Free Software Foundation version 2 of the License. + * + * This program is distributed in the hope that it will be useful, but + * WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * General Public License for more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <string.h> +#include <mntent.h> +#include <dirent.h> +#include <sys/stat.h> +#include <fcntl.h> +#include <errno.h> +#include <ctype.h> + +#include "libsysfs.h" + +/* Command Options */ +static int show_options = 0; /* bitmask of show options */ +static char *attribute_to_show = NULL; /* show value for this attribute */ +static char *device_to_show = NULL; /* show only this bus device */ + +#define SHOW_ATTRIBUTES 0x01 /* show attributes command option */ +#define SHOW_ATTRIBUTE_VALUE 0x02 /* show an attribute value option */ +#define SHOW_DEVICES 0x04 /* show only devices option */ +#define SHOW_DRIVERS 0x08 /* show only drivers option */ +#define SHOW_ALL_ATTRIB_VALUES 0x10 /* show all attributes with values */ + +#define SHOW_ALL 0xff + +static char cmd_options[] = "aA:b:c:dDhr:v"; + +/* + * binary_files - defines existing sysfs binary files. These files will be + * printed in hex. + */ +static char *binary_files[] = { + "config", + "data" +}; + +static int binfiles = 2; + +/** + * usage: prints utility usage. + */ +void usage(void) +{ + fprintf(stdout, "Usage: systool [<options> [device]]\n"); + fprintf(stdout, "\t-a\t\t\tShow attributes\n"); + fprintf(stdout, "\t-b <bus_name>\t\tShow a specific bus\n"); + fprintf(stdout, "\t-c <class_name>\t\tShow a specific class\n"); + fprintf(stdout, "\t-d\t\t\tShow only devices\n"); + fprintf(stdout, "\t-h\t\t\tShow usage\n"); + fprintf(stdout, + "\t-r <root_device>\tShow a specific root device tree\n"); + fprintf(stdout, "\t-v\t\t\tShow all attributes with values\n"); + fprintf(stdout, "\t-A <attribute_name>\tShow attribute value\n"); + fprintf(stdout, "\t-D\t\t\tShow only drivers\n"); +} + +/** + * indent: called before printing a line, it adds indent to the line up to + * level passed in. + * @level: number of spaces to indent. + */ +void indent(int level) +{ + int i; + + for (i = 0; i <= level; i++) + fprintf(stdout, " "); +} + +/** + * remove_end_newline: removes newline on the end of an attribute value + * @value: string to remove newline from + */ +void remove_end_newline(char *value) +{ + char *p = value + (strlen(value) - 1); + + if (p != NULL && *p == '\n') + *p = '\0'; +} + +/** + * show_device_children: prints out device subdirs. + * @sdir: print this directory's subdirectories/children. + */ +void show_device_children(struct sysfs_directory *sdir, int level) +{ + if (sdir != NULL) { + indent(level); + fprintf(stdout, "Children:\n"); + if (sdir->subdirs != NULL) { + char dirname[SYSFS_NAME_LEN]; + struct sysfs_directory *cur = sdir->subdirs; + + while (cur != NULL) { + indent(level+4); + if ((sysfs_get_name_from_path(cur->path, + dirname, SYSFS_NAME_LEN)) == 0) + fprintf(stdout, "%s\n", dirname); + else + fprintf(stdout, "%s\n", cur->path); + cur = cur->next; + } + } + if (sdir->links != NULL) { + struct sysfs_link *curl = sdir->links; + + while (curl != NULL) { + indent(level+4); + fprintf(stdout, "%s\n", curl->name); + curl = curl->next; + } + } + } +} + +/** + * isbinaryvalue: checks to see if attribute is binary or not. + * @attr: attribute to check. + * returns 1 if binary, 0 if not. + */ +int isbinaryvalue(struct sysfs_attribute *attr) +{ + char attrname[SYSFS_NAME_LEN]; + int i; + + if (attr == NULL || attr->value == NULL) + return 0; + + if ((sysfs_get_name_from_path(attr->path, attrname, SYSFS_NAME_LEN)) + != 0) + return 0; + + for (i = 0; i < binfiles; i++) + if ((strcmp(attrname, binary_files[i])) == 0) + return 1; + + return 0; +} + +/** + * show_attribute_value: prints out single attribute value. + * @attr: attricute to print. + */ +void show_attribute_value(struct sysfs_attribute *attr, int level) +{ + if (attr == NULL) + return; + + if (attr->method & SYSFS_METHOD_SHOW) { + if (isbinaryvalue(attr) != 0) { + int i; + fprintf(stdout, "\t: "); + for (i = 0; i < attr->len; i++) { + if (!(i %16)) { + fprintf(stdout, "\n"); + indent(level+8); + } else if (!(i %8)) + fprintf(stdout, " "); + fprintf(stdout, "%02x ", + (unsigned char)attr->value[i]); + } + fprintf(stdout, "\n"); + + } else if (attr->value != NULL && strlen(attr->value) > 0) { + remove_end_newline(attr->value); + fprintf(stdout, "\t: %s\n", attr->value); + } else + fprintf(stdout, "\n"); + } else { + fprintf(stdout, "\t: store method only\n"); + } +} + +/** + * show_attribute: prints out a single attribute + * @attr: attribute to print. + */ +void show_attribute(struct sysfs_attribute *attr, int level) +{ + char attrname[SYSFS_NAME_LEN]; + + if (attr == NULL) + return; + + if ((sysfs_get_name_from_path(attr->path, attrname, SYSFS_NAME_LEN)) + != 0) + return; + + if (show_options & SHOW_ALL_ATTRIB_VALUES) { + indent(level); + fprintf(stdout, "%s", attrname); + show_attribute_value(attr, level); + + } else if ((show_options & SHOW_ATTRIBUTES) || ((show_options + & SHOW_ATTRIBUTE_VALUE) && (strcmp(attrname, attribute_to_show) + == 0))) { + indent(level); + fprintf (stdout, "%s", attrname); + if (show_options & SHOW_ATTRIBUTE_VALUE && attr->value + != NULL && (strcmp(attrname, attribute_to_show)) == 0) + show_attribute_value(attr, level); + + else + fprintf(stdout, "\n"); + } +} + +/** + * show_attributes: prints out a directory's attributes. + * @sdir: print this directory's attributes/files. + */ +void show_attributes(struct sysfs_directory *sdir, int level) +{ + if (sdir != NULL && sdir->attributes != NULL) { + struct sysfs_attribute *cur = sdir->attributes; + + indent(level); + fprintf (stdout, "Attributes:\n"); + while (cur != NULL) { + show_attribute(cur, (level+4)); + cur = cur->next; + } + } +} + +/** + * show_device: prints out device information. + * @device: device to print. + */ +void show_device(struct sysfs_device *device, int level) +{ + if (device != NULL && device->directory != NULL) { + indent(level); + fprintf (stdout, "%s %s\n", device->bus_id, device->name); + if (device->directory->subdirs != NULL + || device->directory->links != NULL) + show_device_children(device->directory, (level+4)); + if (device->directory->attributes != NULL && (show_options + & (SHOW_ATTRIBUTES | SHOW_ATTRIBUTE_VALUE + | SHOW_ALL_ATTRIB_VALUES))) + show_attributes(device->directory, (level+4)); + if (device->driver != NULL) { + indent(level+4); + fprintf (stdout, "Driver: %s\n", + device->driver->name); + } + } +} + +/** + * show_root_device: prints out sys/devices device information. + * @device: device to print. + */ +void show_root_device(struct sysfs_device *device, int level) +{ + if (device != NULL && device->directory != NULL) { + indent(level); + fprintf (stdout, "%s %s\n", device->bus_id, device->name); + if (device->directory->attributes != NULL && (show_options + & (SHOW_ATTRIBUTES | SHOW_ATTRIBUTE_VALUE + | SHOW_ALL_ATTRIB_VALUES))) + show_attributes(device->directory, (level+4)); + } +} + +/** + * show_driver_attributes: prints out driver attributes . + * @driver: print this driver's attributes. + */ +void show_driver_attributes(struct sysfs_driver *driver, int level) +{ + if (driver != NULL && driver->directory != NULL) { + struct sysfs_directory *sdir = driver->directory; + + if (sdir->attributes != NULL) { + struct sysfs_attribute *cur = sdir->attributes; + + indent(level); + fprintf (stdout, "%s Attributes:\n", driver->name); + while (cur != NULL) { + show_attribute(cur, (level+4)); + cur = cur->next; + } + } + } +} + +/** + * show_driver_devices: prints out devices under driver. + * @driver: print devices bound to this driver. + */ +void show_driver_devices(struct sysfs_driver *driver, int level) +{ + if (driver != NULL && driver->directory != NULL) { + struct sysfs_directory *sdir = driver->directory; + + if (sdir->links != NULL) { + struct sysfs_link *cur = sdir->links; + + indent(level); + fprintf (stdout, "Devices:\n"); + while (cur != NULL) { + indent(level+4); + fprintf (stdout, "%s\n", cur->name); + cur = cur->next; + } + } + } +} + +/** + * show_driver: prints out driver information. + * @driver: driver to print. + */ +void show_driver(struct sysfs_driver *driver, int level) +{ + struct sysfs_directory *sdir = NULL; + + if (driver != NULL) { + indent(level); + fprintf (stdout, "%s\n", driver->name); + sdir = driver->directory; + if (sdir != NULL) { + if (sdir->links != NULL) + show_driver_devices(driver, (level+4)); + if(sdir->attributes != NULL && (show_options + & (SHOW_ATTRIBUTES | SHOW_ATTRIBUTE_VALUE + | SHOW_ALL_ATTRIB_VALUES))) + show_driver_attributes(driver, (level+4)); + } + } +} + +/** + * show_device_tree: prints out device tree. + * @root: root device + */ +void show_device_tree(struct sysfs_device *root, int level) +{ + if (root != NULL) { + struct sysfs_device *cur = NULL; + + if (device_to_show == NULL || (strcmp(device_to_show, + root->bus_id) == 0)) { + show_root_device(root, level); + } + cur = root->children; + while (cur != NULL) { + show_device_tree(cur, (level+6)); + cur = cur->next; + } + } +} + +/** + * show_sysfs_bus: prints out everything on a bus. + * @busname: bus to print. + * returns 0 with success or 1 with error. + */ +int show_sysfs_bus(char *busname) +{ + struct sysfs_bus *bus = NULL; + struct sysfs_device *curdev = NULL; + struct sysfs_driver *curdrv = NULL; + + if (busname == NULL) { + errno = EINVAL; + return 1; + } + bus = sysfs_open_bus(busname); + if (bus == NULL) { + fprintf(stderr, "Error opening bus %s\n", busname); + return 1; + } + + fprintf(stdout, "Bus: %s\n", busname); + if (bus->devices != NULL && (show_options & SHOW_DEVICES)) { + curdev = bus->devices; + if (device_to_show == NULL) + fprintf(stdout, "Devices:\n"); + while (curdev != NULL) { + if (device_to_show == NULL || (strcmp(device_to_show, + curdev->bus_id) == 0)) + show_device(curdev, 2); + curdev = curdev->next; + } + } + if (bus->drivers != NULL && (show_options & SHOW_DRIVERS)) { + curdrv = bus->drivers; + fprintf(stdout, "Drivers:\n"); + while (curdrv != NULL) { + show_driver(curdrv, 2); + curdrv = curdrv->next; + } + } + sysfs_close_bus(bus); + return 0; +} + +/** + * show_class_device: prints out class device. + * @dev: class device to print. + */ +void show_class_device(struct sysfs_class_device *dev, int level) +{ + struct sysfs_directory *cur = NULL; + char dirname[SYSFS_NAME_LEN]; + + if (dev != NULL) { + indent(level); + fprintf(stdout, "%s\n", dev->name); + if (dev->directory != NULL && (show_options + & (SHOW_ATTRIBUTES | SHOW_ATTRIBUTE_VALUE + | SHOW_ALL_ATTRIB_VALUES))) { + show_attributes(dev->directory, (level+4)); + cur = dev->directory->subdirs; + while (cur != NULL) { + if ((sysfs_get_name_from_path(cur->path, + dirname, SYSFS_NAME_LEN)) == 0) { + indent(level+4); + fprintf(stdout, "%s\n", dirname); + } + show_attributes(cur, (level+4)); + cur = cur->next; + } + } + if (dev->sysdevice != NULL && (show_options & SHOW_DEVICES)) + show_device(dev->sysdevice, (level+4)); + if (dev->driver != NULL && (show_options & SHOW_DRIVERS)) + show_driver(dev->driver, (level+4)); + } +} + +/** + * show_sysfs_class: prints out sysfs class and all its devices. + * @classname: class to print. + * returns 0 with success and 1 with error. + */ +int show_sysfs_class(char *classname) +{ + struct sysfs_class *cls = NULL; + struct sysfs_class_device *cur = NULL; + + if (classname == NULL) { + errno = EINVAL; + return 1; + } + cls = sysfs_open_class(classname); + if (cls == NULL) { + fprintf(stderr, "Error opening class %s\n", classname); + return 1; + } + fprintf(stdout, "Class: %s\n", classname); + if (cls->devices != NULL) { + cur = cls->devices; + if (device_to_show == NULL) + fprintf(stdout, "Class Devices:\n"); + while (cur != NULL) { + if (device_to_show == NULL || (strcmp(device_to_show, + cur->name) == 0)) + show_class_device(cur, 2); + cur = cur->next; + } + } + + sysfs_close_class(cls); + return 0; +} + +/** + * show_sysfs_root: prints out sysfs root device tree + * @rootname: device root to print. + * returns 0 with success and 1 with error. + */ +int show_sysfs_root(char *rootname) +{ + struct sysfs_device *root = NULL; + char path[SYSFS_PATH_MAX]; + + if (rootname == NULL) { + errno = EINVAL; + return 1; + } + if (sysfs_get_mnt_path(path, SYSFS_PATH_MAX) != 0) { + perror("sysfs_get_mnt_path"); + fprintf(stderr, "Error getting sysfs mount point\n"); + exit(1); + } + + strcat(path, SYSFS_DEVICES_DIR); + strcat(path, "/"); + strcat(path, rootname); + root = sysfs_open_device_tree(path); + if (root == NULL) { + fprintf(stderr, "Error opening root device %s\n", rootname); + return 1; + } + fprintf(stdout, "Root Device Tree: %s\n", rootname); + show_device_tree(root, 2); + sysfs_close_device_tree(root); + + return 0; +} + +/** + * show_subdirectories: prints all subdirectory names at path + * @path: sysfs path where subdirs are. + * returns 0 with success or 1 with error. + */ +int show_subdirectories(char *path, int level) +{ + struct sysfs_directory *dir = NULL, *current = NULL; + char name[SYSFS_NAME_LEN]; + int ret = 0; + + dir = sysfs_open_directory(path); + if (dir == NULL) { + fprintf(stderr, "Error opening sysfs directory at %s\n", path); + return 1; + } + if ((sysfs_read_directory(dir)) != 0) { + fprintf(stderr, "Error reading sysfs directory at %s\n", path); + sysfs_close_directory(dir); + return 1; + } + + current = dir->subdirs; + while (current != NULL) { + if ((sysfs_get_name_from_path(current->path, name, + SYSFS_NAME_LEN)) != 0) { + sysfs_close_directory(dir); + return 1; + } + indent(level); + fprintf(stdout, "%s\n", name); + current = current->next; + } + sysfs_close_directory(dir); + return ret; +} + +/** + * show_default_info: prints current buses, classes, and root devices + * supported by sysfs. + * returns 0 with success or 1 with error. + */ +int show_default_info(void) +{ + char sysfs_root[SYSFS_PATH_MAX]; + char path_to_print[SYSFS_PATH_MAX]; + int retval = 0; + + /* get sysfs mount point */ + if (sysfs_get_mnt_path(sysfs_root, SYSFS_PATH_MAX) != 0) { + perror("sysfs_get_mnt_path"); + fprintf(stderr, "Error getting sysfs mount point\n"); + exit(1); + } + strcpy(path_to_print, sysfs_root); + + /* print supported buses */ + strcat(path_to_print, SYSFS_BUS_DIR); + fprintf(stdout, "Supported sysfs buses:\n"); + retval = show_subdirectories(path_to_print, 4); + + if (retval == 0) { + /* print supported classes */ + strcpy(path_to_print, sysfs_root); + strcat(path_to_print, SYSFS_CLASS_DIR); + fprintf(stdout, "Supported sysfs classes:\n"); + retval = show_subdirectories(path_to_print, 4); + } + + if (retval == 0) { + /* print supported root devices */ + strcpy(path_to_print, sysfs_root); + strcat(path_to_print, SYSFS_DEVICES_DIR); + fprintf(stdout, "Supported sysfs root devices:\n"); + retval = show_subdirectories(path_to_print, 4); + } + + return retval; +} + +/* MAIN */ +int main(int argc, char *argv[]) +{ + char *show_bus = NULL; + char *show_class = NULL; + char *show_root = NULL; + int retval = 0; + int opt; + extern int optind; + extern char *optarg; + + while((opt = getopt(argc, argv, cmd_options)) != EOF) { + switch(opt) { + case 'a': + show_options |= SHOW_ATTRIBUTES; + break; + case 'A': + if ((strlen(optarg) + 1) > SYSFS_NAME_LEN) { + fprintf(stderr, + "Attribute name %s is too long\n", + optarg); + exit(1); + } + attribute_to_show = optarg; + show_options |= SHOW_ATTRIBUTE_VALUE; + break; + case 'b': + show_bus = optarg; + break; + case 'c': + show_class = optarg; + break; + case 'd': + show_options |= SHOW_DEVICES; + break; + case 'D': + show_options |= SHOW_DRIVERS; + break; + case 'h': + usage(); + exit(0); + break; + case 'r': + show_root = optarg; + break; + case 'v': + show_options |= SHOW_ALL_ATTRIB_VALUES; + break; + default: + usage(); + exit(1); + } + } + argc -= optind; + argv += optind; + + switch(argc) { + case 0: + break; + case 1: + /* get bus to view */ + if ((strlen(*argv)) < SYSFS_NAME_LEN) { + device_to_show = *argv; + show_options |= SHOW_DEVICES; + } else { + fprintf(stderr, + "Invalid argument - device name too long\n"); + exit(1); + } + break; + default: + usage(); + exit(1); + } + + if ((show_bus == NULL && show_class == NULL && show_root == NULL) + && (show_options & (SHOW_ATTRIBUTES | SHOW_ATTRIBUTE_VALUE + | SHOW_DEVICES | SHOW_DRIVERS | SHOW_ALL_ATTRIB_VALUES))) { + fprintf(stderr, + "Please specify a bus, class, or root device\n"); + usage(); + exit(1); + } + /* default is to print devices */ + if (!(show_options & (SHOW_DEVICES | SHOW_DRIVERS))) + show_options |= SHOW_DEVICES; + + if (show_bus != NULL) + retval = show_sysfs_bus(show_bus); + if (show_class != NULL) + retval = show_sysfs_class(show_class); + if (show_root != NULL) + retval = show_sysfs_root(show_root); + + if (show_bus == NULL && show_class == NULL && show_root == NULL) + retval = show_default_info(); + + exit(retval); +} |