mirror of
https://github.com/Unidata/netcdf-c.git
synced 2024-11-21 03:13:42 +08:00
Added Windows NetCDF webpage/documentation to built-in documentation generated by Doxygen.
This commit is contained in:
Ward Fisher
parent
eda91aa9cf
commit
30cfeb7acc
@ -573,6 +573,7 @@ INPUT = \
|
||||
@abs_top_srcdir@/man4/tutorial.doc \
|
||||
@abs_top_srcdir@/man4/install.doc \
|
||||
@abs_top_srcdir@/man4/dispatch.doc \
|
||||
@abs_top_srcdir@/man4/win_netcdf.doc \
|
||||
@abs_top_srcdir@/man4/guide.doc \
|
||||
@abs_top_srcdir@/man4/types.doc \
|
||||
@abs_top_srcdir@/man4/notes.doc \
|
||||
|
||||
@ -19,6 +19,7 @@ Hartnett, and Dennis Heimbigner
|
||||
<p>Learn more about netCDF:
|
||||
- \ref getting
|
||||
- \ref building
|
||||
- \ref windows
|
||||
- \ref tutorial
|
||||
- \ref user_guide
|
||||
|
||||
|
||||
133
man4/win_netcdf.doc
Normal file
133
man4/win_netcdf.doc
Normal file
@ -0,0 +1,133 @@
|
||||
/** \file
|
||||
Instructions for building NetCDF on Windows.
|
||||
|
||||
\page windows NetCDF on Windows
|
||||
|
||||
|
||||
<A NAME="win_netcdf" ID="win_netcdf"></A>
|
||||
<h1>NetCDF for Windows (Current Release: 4.2.1.1)</h1>
|
||||
|
||||
<ul>
|
||||
<li><A HREF="#overview">Overview</A></li>
|
||||
<li><A HREF="#binaries">Windows NetCDF Binaries</A></li>
|
||||
<li><A HREF="#compiling">Compiling Windows NetCDF from source for Windows</A></li>
|
||||
<li><A HREF="#compnotes">Compilation Notes & Gotchas</A></li>
|
||||
</ul>
|
||||
|
||||
</p>
|
||||
<h2><A name="Overview"></A>Overview</h2>
|
||||
</p>
|
||||
Starting with the NetCDF 4.2.1 release, we are happy to provide official Windows and Visual Studio support. Please note that while our goal is full functionality, there will undoubtedly be a number of fixes required as the Windows version begins to see wider adoption. We provide binary downloads for shared and static Windows libraries, as well as instructions for compiling libraries using the MSYS/MinGW environment.</p>
|
||||
|
||||
The current NetCDF build for Windows supports NetCDF Classic, NetCDF-4, HDF5, DAP and Diskless functionality.</p>
|
||||
|
||||
Currently, Visual-Studio based builds are not supported, but CMake support is being actively developed. Cygwin builds are also supported; for Cygwin environments, follow the MSYS/MinGW instrunctions.
|
||||
</p>
|
||||
|
||||
<h1>Getting NetCDF Libraries for Windows</h1>
|
||||
|
||||
These libraries can be used with Visual Studio projects. The libraries themselves were tested with Visual Studio 2010. These downloads contain the libraries, the dependent libraries which they were built against, the netcdf utilities (ncgen, ncdump). <br>
|
||||
<h2 style="font-size: larger;"><A name="binaries"></A>Windows NetCDF 4.2.1.1 Binaries</h2>
|
||||
<ul>
|
||||
<li>Windows libraries (shared and static):</li>
|
||||
<table cellpadding=5 border="1">
|
||||
<tr>
|
||||
<td></td>
|
||||
<th>32-bit libraries</th>
|
||||
<th>64-bit libraries</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td colspan=3><center>Static (.a, .lib) Libraries</center></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NetCDF 2/3 Only, No DAP</td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc3_32_static.zip">nc3_32_static.zip</A></td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc3_64_static.zip">nc3_64_static.zip</A></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NetCDF-4, HDF5, No DAP</td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_32_static.zip">nc4_32_static.zip</A></td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_64_static.zip">nc4_64_static.zip</A></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NetCDF-4, HDF5, DAP</td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_dap_32_static.zip">nc4_dap_32_static.zip</A></td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_dap_64_static.zip">nc4_dap_64_static.zip</A></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td colspan=3><center>Dynamic (.dll) Libraries</center></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NetCDF 2/3 Only, No DAP</td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc3_32_dll.zip">nc3_32_dll.zip</A></td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc3_64_dll.zip">nc3_64_dll.zip</A></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NetCDF-4, HDF5, No DAP</td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_32_dll.zip">nc4_32_dll.zip</A></td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_64_dll.zip">nc4_64_dll.zip</A></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NetCDF-4, HDF5, DAP</td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_dap_32_dll.zip">nc4_dap_32_dll.zip</A></td>
|
||||
<td><A HREF="http://www.unidata.ucar.edu/netcdf/win_netcdf/nc4_dap_64_dll.zip">nc4_dap_64_dll.zip</A></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
|
||||
</ul>
|
||||
<h3 style="font-size: larger;"><A name="compiling"></A>Compiling Windows NetCDF 4.2.1.1 from Source</h3>
|
||||
<ol>
|
||||
<li>Install the latest MSYS/MinGW environment for your Windows machine:</li>
|
||||
<ul>
|
||||
<li><A HREF=http://www.mingw.org/wiki/MSYS>http://www.mingw.org/wiki/MSYS</A></li>
|
||||
<i>Note: Configuring a 64-bit MinGW environment is non-trivial. Consider one of our binary downloads instead.</i>
|
||||
</ul>
|
||||
|
||||
<li><A HREF="http://www.unidata.ucar.edu/downloads/netcdf">Download the latest NetCDF source code (4.2.1.1).</A></li>
|
||||
<li>Install the NetCDF dependencies (as needed):</li>
|
||||
<i>These libraries are optional, and are only required if you want the functionality they provide.</i>
|
||||
<ul>
|
||||
<li>HDF5 & SZip: <A HREF="http://www.hdfgroup.org/HDF5/release/obtain5.html">http://www.hdfgroup.org/HDF5/release/obtain5.html</A></li>
|
||||
<li>ZLib:
|
||||
<ul>
|
||||
<li>Source: <A HREF="http://zlib.net/">http://zlib.net/</A></li>
|
||||
<li>Official Windows Library binaries: <A HREF="http://www.winimage.com/zLibDll/index.html">http://www.winimage.com/zLibDll/index.html</A></li>
|
||||
</ul>
|
||||
<li>libcurl: <A HREF="http://curl.haxx.se/download.html">http://curl.haxx.se/download.html</A></li>
|
||||
</ul>
|
||||
|
||||
<li>Configure & Build NetCDF:</li>
|
||||
<ul>
|
||||
<li>'./configure --[desired options] \ <br> CFLAGS="-fno-stack-check -fno-stack-protector -mno-stack-arg-probe -I[path to dependency include files] " \ <br>LDFLAGS="-L[path to dependency library files]"'</li>
|
||||
<I>Note that the first 3 'CFLAGS' arguments are used to prevent 'unresolved external symbol' errors when using the resulting libnetcdf with Visual Studio.</I>
|
||||
<li>'make'</li>
|
||||
<li>'make check'</li>
|
||||
</ul>
|
||||
<li>The final libraries are located in [NetCDF Root]/liblib/.libs</li>
|
||||
<i>Note: To use static libraries in Visual Studio, you may rename the .a files as .lib files. For Visual Studio 2010 (and possibly previous versions), this is not strictly necessary.</i>
|
||||
</ol>
|
||||
|
||||
<h1><A name="CompNotes"></A>Compilation Notes and Gotchas</h1>
|
||||
|
||||
Building Visual Studio compatible NetCDF under Windows is a fairly complex process. We will eventually mitigate this complexity by integrating CMake-based builds into NetCDF. For the time being, we recommend you download our <A HREF="#binaries">binary</A> packages. If, for whatever reason, these binaries will not work for you, please be aware of the following when building NetCDF for Windows:</p>
|
||||
|
||||
<ul>
|
||||
<li>Two versions of any dependency libraries may be required:</li>
|
||||
<ul>
|
||||
<li>MSYS/MinGW compatible version, linked against at libnetcdf compile time.</li>
|
||||
<I>These are not necessary if using the libraries downloaded above.</I>
|
||||
<li>Visual Studio compatible version, used at compile/runtime for your Visual Studio project.</li>
|
||||
</ul>
|
||||
<li>As outlined above, you must use the following CFLAGS when configuring NetCDF:</li>
|
||||
<ul>
|
||||
<li>-fno-stack-check</li>
|
||||
<li>-fno-stack-protector</li>
|
||||
<li>-mno-stack-arg-probe</li>
|
||||
</ul>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
*/
|
||||
Loading…
Reference in New Issue
Block a user