WebSVN – computer_asset_manager_v1 – Diff – /modules/attributes/dmidecode2array.php

 <?php
+/*
+ * Trims a value, then compares it to several 'null' possibilities
+ * if it is a null, returns empty string, otherwise returns value
+ */
 function cleanUpDMIValue( $value ) {
    $value = trim( $value );
    switch (strtolower( $value )) {
       case 'unknown':
+      case 'unspecified' :
       case 'not available':
+      case 'to be filled by o.e.m.':
       case 'not specified': return '';
+   }
    return $value;
+}
 /*
- * Read value from hash, return $outputKey\tvalue from hash
+ * Read value from array of hash, return array of "$outputKey\tvalue" for each entry found
+ * If nothing found, returns empty array
+ * if $unique is true, returns first non-empty value found
- * Or, empty string if not found
+ * if $outputKey is not defined, uses $key
  */
-function getDMIInformation( $data, $type, $handle, $key, $outputKey = '' ) {
+function getDMIInformation( $data, $type, $key, $outputKey = '', $unique = true ) {
+   $return = array();
+   foreach ( $data[$type] as $handle ) {
-   if ( isset( $data[$type][$handle][$key]) ) {
+      if ( isset( $handle[$key]) ) {
-      $a = cleanUpDMIValue( $data[$type][$handle][$key] );
+         $a = cleanUpDMIValue( $handle[$key] );
-      if ( $a )
+         if ( $a ) {
-         return ( $outputKey ? $outputKey : $key ) . "\t" . $a;
+            $return[] = ( $outputKey ? $outputKey : $key ) . "\t" . $a;
+            if ( $unique ) {
+               return $return;
+            }
+         }
+      }
+   }
-   return '';
+   return $return;
+}
+/*
+ * adds $value to array
+ * if $value is scalar, simply adds it
+ * if $value is array, adds every row
+ * returns modified array
+ */
+function addData( $array, $value ) {
+   if ( $value ) {
+      switch (gettype( $value ) ) {
+         case 'array' : foreach ( $value as $thisVal ) {
+                           $array[] = $thisVal;
+                        }
+                        break;
+         case 'boolean' :
+         case 'integer' :
+         case 'double'  :
+         case 'string'  : $array[] = $value;
+      } // switch
+   }
+   return $array;
+} //addData
 /*
  * Function will take an array of lines representing the output of a dmidecode file
  * and pick and choose the values we want to put into CAMP attributes.
  * It will return an array of key/value pairs to be added into the attributes table
+ *
+ * NOTE: this is a summary of values we decided to store. dmidecode files have a lot of
+ * additional information we chose not to include
+ *
  */
 function dmidecode2array( $contents ) {
-// allows us to group the dmi types by function
+// allows us to group the dmi types by function. not implemented
 $dmiGroups = array(
       "bios" => "0,13",
       "system" => "1,12,15,23,32",
       "baseboard" => "2,10,41",
       "chassis" => "3",
       "cache" => "7",
       "connector" => "8",
       "slot" => "9"
 );
-// This contains the standard DMI types, ie no OEM stuff
+// This contains the standard DMI types, ie no OEM stuff. For reference, not used in code
 $standardDMITypes = array(
       "0" => "BIOS",
       "1" => "System",
       "2" => "Baseboard",
       "40" => "Additional Information",
       "41" => "Onboard Devices Extended Information",
       "42" => "Management Controller Host Interface"
 );
-   // verify this is something we can work with
+   // verify this is something we can work with, First line should be the version of dmidecode found
-   preg_match('/dmidecode ([0-9.]+)/', $contents[0], $results);
+   if ( preg_match('/dmidecode ([0-9.]+)/', $contents[0], $results) ) {
-   #if ( $results[1] != "3.0" ) {
+      $dmidecodeVersion = $results[1];
+   } else {
-   #   return "This is only verified with dmidecode v3.0, v$results[1] found\n";
+      return "Not a valid dmidecode file";
-   #}
+   }
    // first, let's parse it into a hash
    $currentHandle = '';
    $currentType;
    $data = array();
    for ( $i = 0; $i < count($contents); $i++ ) {
          $data[$currentType][$currentHandle][$outputArray[1]] = $outputArray[2];
+      }
+   }
    # well, we have at least one entry, so let's go
    $return = array();
-   // get info on the actual machine
+   // manufacturer info
-   $temp = &getDMIInformation( $data, '1','0x0100','Manufacturer' );
+   $return = addData( $return, getDMIInformation( $data, '1','Manufacturer' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '1','0x0100','Product Name', 'Model' );
+   $return = addData( $return, getDMIInformation( $data, '1','Product Name', 'Model' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '1','0x0100','Serial Number' );
+   $return = addData( $return, getDMIInformation( $data, '1','Serial Number' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '1','0x0100','UUID' );
+   $return = addData( $return, getDMIInformation( $data, '1','UUID' ) );
-   if ( $temp ) $return[] = $temp;
-   // firmware information
+   // physical machine
-   $temp = &getDMIInformation( $data, '0','0x0000','Vendor', 'Firmware Vendor' );
+   $return = addData( $return, getDMIInformation( $data, '3','Type', 'Enclosure Type' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '0','0x0000','Release Date', 'Firmware Release' );
+   $return = addData( $return, getDMIInformation( $data, '3','Asset Tag', 'Enclosure Asset Tag' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '0','0x0000','Version', 'Firmware Version' );
+   $return = addData( $return, getDMIInformation( $data, '3','Height', 'Enclosure Height' ) );
-   if ( $temp ) $return[] = $temp;
+   // firmware version
-   $temp = &getDMIInformation( $data, '0','0x0000','Firmware Revision', 'Firmware Revision' );
+   $return = addData( $return, getDMIInformation( $data, '0','Vendor', 'Firmware Vendor' ) );
-   if ( $temp ) $return[] = $temp;
-   // physical size
-   $temp = &getDMIInformation( $data, '3','0x0300','Type', 'Enclosure Type' );
+   $return = addData( $return, getDMIInformation( $data, '0','Release Date', 'Firmware Release' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '3','0x0300','Asset Tag', 'Enclosure Asset Tag' );
+   $return = addData( $return, getDMIInformation( $data, '0','Version', 'Firmware Version' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '3','0x0300','Height', 'Enclosure Height' );
+   $return = addData( $return, getDMIInformation( $data, '0','Firmware Revision', 'Firmware Revision' ) );
-   if ( $temp ) $return[] = $temp;
-   // processor information
+   // processor information. NOTE: assumes all sockets populated and all processors the saem
-   if ( isset( $data['4'] ) )
+   if ( isset( $data['4'] ) ) // count the number of sockets
-      $return[] = "CPU Count\t" . count( $data['4'] ); // fails if there are unpopulated slots or disabled ones
+      $return[] = "CPU Count\t" . count( $data['4'] );
-   $temp = &getDMIInformation( $data, '4','0x0400','Family', 'CPU Family' );
+   $return = addData( $return, getDMIInformation( $data, '4','Family', 'CPU Family' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '4','0x0400','Manufacturer', 'CPU Manufacturer' );
+   $return = addData( $return, getDMIInformation( $data, '4','Manufacturer', 'CPU Manufacturer' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '4','0x0400','Version', 'CPU Version' );
+   $return = addData( $return, getDMIInformation( $data, '4','Version', 'CPU Version' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '4','0x0400','Current Speed', 'CPU Speed' );
+   $return = addData( $return, getDMIInformation( $data, '4','Current Speed', 'CPU Speed' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '4','0x0400','Core Count', 'CPU Cores (ea)' );
+   $return = addData( $return, getDMIInformation( $data, '4','Core Count', 'CPU Cores (ea)' ) );
-   if ( $temp ) $return[] = $temp;
-   $temp = &getDMIInformation( $data, '4','0x0400','Thread Count', 'CPU Threads (ea)' );
+   $return = addData( $return, getDMIInformation( $data, '4','Thread Count', 'CPU Threads (ea)' ) );
-   if ( $temp ) $return[] = $temp;
+   /*
+    * memory information. We want details on each slot for this, so we have to go through each entry, one at a time.
+    * For readability, we also want to take several values and turn them into one human
+    * readable string for each socket. So, we go through each entry in the memory socket, determine if it is populated
-   // memory information
+    * then concat it together for a pretty output
+    */
    if ( isset( $data['17'] ) ) {
       $return[] = "Memory Slots\t" . count( $data['17'] );
-      $totalRAM = 0;
+      $totalRAM = 0; // we'll accumulate the total size as we find slots populated
-      foreach ( $data['17'] as $entry ) {
+      foreach ( $data['17'] as $entry ) { // type 17 has one entry for every DIMM slot
-         $mem = array();
+         $mem = array(); // fill this up with the values we want to turn into a string, then we'll implode it into the string
          $mem[] = trim($entry['Locator'] ? $entry['Locator'] : ($entry['Bank Locator'] ? $entry['Bank Locator'] : '' ));
          if ( $entry['Size'] == 'No Module Installed' ) {
             $mem[] = 'Unpopulated';
          } else {
-            $mem[] = trim($entry['Size']);
+            $mem[] = trim($entry['Size']); // size can be kilo, meg, gig, tera, so convert it to mega
             if ( preg_match('/(\d+)\s+(GB|MB|TB|kb)/i', $entry['Size'] , $outputArray) ) {
                switch ( strtolower( $outputArray[2] ) ) {
                   case 'gb' :
                            $outputArray[1] *= 1024;
                            break;
          $return[] = "Memory\t" . implode( ', ', $mem );
+      }
       $return[] = "Memory Total\t$totalRAM MB";
+   }
+   /*
+    * power supplies. Most workstations will not even have an entry here, but for servers we will have details on each individual
+    * power supply, including the part number, serial number, etc..., so like memory, we want a detailed listing with a human
-   // power supplies
+    * readable string for each psu
+    */
    if ( isset( $data['39'] ) ) {
       $return[] = "Power Supply Count\t" . count( $data['39'] );
       foreach ( $data['39'] as $entry ) {
          if ( preg_match('/^Present/i', $entry['Status'] ) ) {
             $psu = array();
             $return[] = "Power Supply\t" . implode( ', ', $psu );
+         }
+      }
+   }
    return array( $return );
+}  // dmidecode2array
-}
 $filename = $argv[1];
 if ( $filename ) {
    $contents = file( $filename, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES );
    $out = dmidecode2array( $contents );

Subversion Repositories computer_asset_manager_v1

(root)/modules/attributes/dmidecode2array.php – Rev 98 → 99