From 055719b7b931c21576d778257a6b0f9c2964ece7 Mon Sep 17 00:00:00 2001 From: Alexander Amelkin Date: Fri, 3 Jul 2020 23:09:42 +0300 Subject: [PATCH] doc: Update INSTALL with Windows info The documentation now contains instructions on how to build on Windows. The instructions have been verified and added to a continous integration workflow with the previous commit, so Windows buildability will from now on be automatically verified. Resolves: ipmitool/ipmitool#148 (ipmitool for win with FreeIPMI) ipmitool/ipmitool#200 (windows build error) ipmitool/ipmitool#201 (windows build error) ipmitool/ipmitool#203 (no lanplus on windows) Signed-off-by: Alexander Amelkin --- INSTALL | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/INSTALL b/INSTALL index 7bc7fa5..df77525 100644 --- a/INSTALL +++ b/INSTALL @@ -22,6 +22,7 @@ project is tested automatically to build cleanly for the following - Ubuntu 18.04 Bionic Beaver - Ubuntu 20.04 Focal Fossa - MacOS X 10.15 Catalina + - Microsoft Windows Server 2019 It is also known to build successfully on Ubuntu 14.04 and Fedora 31, but that is not automatically verified. @@ -47,6 +48,18 @@ recommended to do the following before building: $ export LDFLAGS="-L/usr/local/opt/openssl@1.1/lib" $ export CPPFLAGS="-I/usr/local/opt/openssl@1.1/include" + To prepare for buildin in Windows it is recommended to use Chocolatey +and do the following using PowerShell: + + PS C:\ipmitool> choco install cygwin -y + PS C:\ipmitool> choco install cyg-get -y + PS C:\ipmitool> cyg-get gcc-g++ make automake autoconf ` + # m4 libtool libncurses-devel libreadline-devel libssl-devel ` + # unix2dos wget + PS C:\ipmitool> $env:path="C:\tools\cygwin\usr\bin;$env:path" + PS C:\ipmitool> $env:path="C:\tools\cygwin\bin;$env:path" + PS C:\ipmitool> dos2unix bootstrap configure.ac csv-revision + Basic Installation ================== @@ -55,6 +68,9 @@ install this package: ./bootstrap && ./configure && make && sudo make install + For Windows the above command must be run inside a cygwin bash +shell. + The following more-detailed instructions are generic; see the `README' file for instructions specific to this package. Some packages provide this `INSTALL' file but do not implement all of the