Imported Upstream version 2.9.7upstream/2.9.7

1 files changed, 24 insertions, 14 deletions

diff --git a/doc/UserGuide b/doc/UserGuide
index 213b367..5d25330 100644
--- a/doc/UserGuide
+++ b/doc/UserGuide
@@ -1,6 +1,6 @@
 
                   IPMIUTIL USER GUIDE 
-                     VERSION 2.9.6
+                     VERSION 2.9.7
          An easy-to-use IPMI server management utility
 
 
@@ -5227,10 +5227,20 @@ exception of drivers:
    or cached at http://ipmiutil.sf.net/kern/imbdrv130.zip 
  * The Microsoft IPMI driver (ipmidrv.sys), which comes with Windows 2003 R2
    and later, is also supported.
-
 It should be noted that the two IPMI drivers should not be installed at the
 same time, since they will interfere with each other.
-So, for some systems or applications, you may need to uninstall the Microsoft
+
+Note that there are several outstanding bug reports against the Microsoft ipmidrv.sys driver which may affect its usage:
+ * ipmidrv.sys does not support systems with 4-byte register spacing
+   https://social.technet.microsoft.com/forums/windowsserver/en-US/223e3a0d-3daa-4141-9c13-3169f766a7d5/win2008-ipmidrvsys-does-not-load-if-register-spacing-4
+ * ipmidrv.sys WBEM access memory leak
+   https://sourceforge.net/p/ipmiutil/support-requests/11/
+   https://social.msdn.microsoft.com/Forums/windowsdesktop/en-US/ca4df181-7fd4-4912-83a0-5896b030e3ca/latest-version-of-microsoft-ipmi-driver-ipmidrvsys?forum=wdk
+ * ipmidrv.sys with Windows 2012 does not work on many IPMI systems
+   This version is more broken than the Win2008 version. 
+If you are affected by any of these issues, you can download and install the imbdrv.sys as described below, but you must also disable the MS ipmidrv.sys.
+
+For some systems or applications, you may need to uninstall the Microsoft
 IPMI driver, like this:
  * start Control Panel/System app
  * go to Hardware tab, start Device Manager
@@ -5240,6 +5250,12 @@ IPMI driver, like this:
  * select Properties
  * on driver tab, click "Uninstall"
  * then reboot.
+If you are running Windows 2012, the Device Manager does not support this,
+so use these steps to disable the Microsoft IPMIDRV:
+ * Start a command prompt with 'Run as administrator'
+ * cd \windows\system32\drivers
+ * move ipmidrv.sys ipmidrv.old
+ * then reboot
 
 How to install Intel IPMI driver from the cached copy at http://ipmiutil.sf.net/kern/imbdrv130.zip 
   Extract imbdrv130.zip to c:\temp or similar
@@ -5263,13 +5279,6 @@ make sure that the Microsoft VC++ Redistributable package is installed
 See http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en
 to download this if needed.
 
-Note that there are two outstanding bug reports against the Microsoft ipmidrv.sys driver which may affect its usage:
- * ipmidrv.sys does not support systems with 4-byte register spacing
-   https://social.technet.microsoft.com/forums/windowsserver/en-US/223e3a0d-3daa-4141-9c13-3169f766a7d5/win2008-ipmidrvsys-does-not-load-if-register-spacing-4
- * ipmidrv.sys WBEM access memory leak
-   https://sourceforge.net/p/ipmiutil/support-requests/11/
-   https://social.msdn.microsoft.com/Forums/windowsdesktop/en-US/ca4df181-7fd4-4912-83a0-5896b030e3ca/latest-version-of-microsoft-ipmi-driver-ipmidrvsys?forum=wdk
-
 
 ----------------------------------
 5.2  WINDOWS BUILD INSTRUCTIONS
@@ -5294,14 +5303,14 @@ A copy of these files is available from
    http://ipmiutil.sf.net/FILES/ipmiutil-contrib.zip
 The above zip contains all of the contributed source used.
 Refer to getopt.c from one of these
-   BSD getopt.c:
+   BSD getopt.c (used by default in ipmiutil.exe):
      http://www.openmash.org/lxr/source/src/getopt.c?c=gsm
    public domain getopt.c:
      http://www.koders.com/c/fid034963469B932D9D87F91C86680EB08DB4DE9AA3.aspx
    GNU LGPL getopt.c:
      http://svn.xiph.org/trunk/ogg-tools/oggsplit/
 Refer to openssl from this link (Apache-style license, not gpl)
-     http://www.openssl.org/source/openssl-0.9.7l.tar.gz.
+     http://www.openssl.org/source/openssl-0.9.8x.tar.gz (used by default)
 
 5.2.3  Copy initial contrib files into ipmiutil
 Below are sample directories where ipmiutil*.tar.gz was unpacked, 
@@ -5356,8 +5365,9 @@ Serial-Over-LAN requires.
 5.3  WINDOWS COMMAND USAGE
 ----------------------------------
  
-Because of the differences in Linux getopt and the getopt used in  
-the Windows build, the order of parameters is more important in Windows. 
+Because of the differences in Linux getopt and the BSD getopt.c used by
+default in  the Windows build, the order of parameters is more important 
+in Windows. 
  
 For example in Linux, the following command usages work, but not in Windows: 
   # ipmiutil cmd 00 20 18 01 -N 192.168.1.154