README File for IDE Diskinfo (diskinfo) program for Linux 2.2.6 - 2.2.14 ------------------------------------------------------------------------ Diskinfo gathers information about IDE disks from /proc/ide/ide* and prints it in a nice format to the screen. INSTALLATION ------------ I built diskinfo with all users in mind, simply: 'tar -xzf diskinfo-X.X.tar.gz' 'cd diskinfo-X.X' 'make' the binary executable 'diskinfo' will be in the distribution directory. to install, su to root and do: 'make install' to remove: 'make uninstall' NOTES ----- Currently diskinfo works with Linux kernel 2.2.6 to 2.2.14. I do not know about any of the 2.3.X series, however, when the time comes I wholly intend on upgrading it if need be. Also the man page blows so I included a usage section here: CHANGES ------- 1.1 - 1.2 * Made the file and directory handles somewhat dynamic * Checked for directories before getting and printing 1.2 - 1.3 * Built dynamic data structures to store information and print it all out at once in one location instead of haphazardly * Switched data structures to pointer based structures * Broke out the program into several files (see FILES) 1.3 - 1.4 * Changed the Code to be Objective C (nothing more than moving stuff around a bit) * Updated contact information 1.4 - 1.5 * Removed excessive typesetting stuff from code * Stopped using arbitrary string lengths (okay they were estimations) and now use OS LINE_MAX macro 1.5 - 1.6 * removed the use of OS LINE_MAX macro apparently not many people have the header file. 1.6 - 1.7 * removed the directory check, if the file handle is not there, the structure simply remains empty * removed dynamic string allocation and replaced with an indexed array * added system install/uninstall to make (upon request) * added version print option * added minihelper * updated man page documentation with new options and also cleaned up the man page 1.7 - 1.8 * updated contacted info * updated Makefile 1.8 - 1.9 * Minor formatting changes TODO ---- 1.8 and 1.9 wil mostly be trimming and any possible efficiency changes that can be done. I don't see much there really. 2.0 will be an effort to make diskinfo more dynamic internally. right now it has hard coded filehandles (a lot of them) and instantiates 8 empty data structures upon startup. so the primary goals from 2.X+ will be: - get to procfs without using such a large array - true dynamic structures 1.8 and 1.9 will also remove brain deadisms (e.g calling file pointers different names in different functions is - well dumb) USAGE ----- Simple, currently you can have the following devices on IDE bus systems: '/dev/hda - /dev/hdh' Simply type diskinfo for example: 'diskinfo /dev/hda' Multiple disks may be included like so: 'diskinfo /dev/hda /dev/hdd . . .' MAINTAINER ---------- Jay Fink WWW Home: systhread.net Email: jay.fink@gmail.com LICENSE STYLE ------------- GNU/GPL (see COPYING)