Initial revision

4 files changed, 1490 insertions, 0 deletions

diff --git a/cmd/GPL b/cmd/GPL
new file mode 100644
index 0000000..cde4efd
--- /dev/null
+++ b/cmd/GPL
@@ -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);
+}