| 9 |
9 |
| 10 <tabs> |
10 <tabs> |
| 11 <tab title="Unix / Linux"> |
11 <tab title="Unix / Linux"> |
| 12 <procedure> |
12 <procedure> |
| 13 <step> |
13 <step> |
| 14 Download the latest source archive from <a href="https://sourceforge.net/projects/ucx/files/">Source Forge</a> |
14 Download the latest source archive from |
| 15 and extract it somewhere on your machine. |
15 <a href="https://sourceforge.net/projects/ucx/files/">Source Forge</a> and extract it somewhere on your machine. |
| 16 You can also use the command line to do this. |
16 You can also use the command line to do this. |
| 17 <code-block lang="sh"> |
17 <code-block lang="sh"> |
| 18 wget https://sourceforge.net/projects/ucx/files/ucx-latest.tar.gz |
18 wget https://sourceforge.net/projects/ucx/files/ucx-latest.tar.gz |
| 19 tar -xzf ucx-latest.tar.gz |
19 tar -xzf ucx-latest.tar.gz |
| 20 cd ucx-latest |
20 cd ucx-latest |
| 35 </procedure> |
35 </procedure> |
| 36 </tab> |
36 </tab> |
| 37 <tab title="Windows"> |
37 <tab title="Windows"> |
| 38 <procedure> |
38 <procedure> |
| 39 <step> |
39 <step> |
| 40 Download the latest source archive from <a href="https://sourceforge.net/projects/ucx/files/">Source Forge</a> |
40 Download the latest source archive from |
| 41 and extract it somewhere on your machine. |
41 <a href="https://sourceforge.net/projects/ucx/files/">Source Forge</a> and extract it somewhere on your machine. |
| 42 </step> |
42 </step> |
| 43 <step> |
43 <step> |
| 44 Navigate to the folder named <code>msvc</code> in the extracted directory structure. |
44 Navigate to the folder named <code>msvc</code> in the extracted directory structure. |
| 45 </step> |
45 </step> |
| 46 <step> |
46 <step> |
| 47 Open the contained <code>ucx.sln</code> in Visual Studio and build the solution. |
47 Open the contained <code>ucx.sln</code> in Visual Studio and build the solution. |
| 48 </step> |
48 </step> |
| |
49 <step> |
| |
50 The libucx project in the solution will produce a libucx.lib that can be used for static linking |
| |
51 and the libucx_dll project will produce a libucx.dll and a libucx.dll.lib import lib for dynamic linking. |
| |
52 </step> |
| 49 </procedure> |
53 </procedure> |
| |
54 <note> |
| |
55 For native Windows projects it is recommended to statically link UCX. |
| |
56 </note> |
| 50 </tab> |
57 </tab> |
| 51 </tabs> |
58 </tabs> |
| 52 |
59 |
| 53 ## Compile Time Options |
60 ## Compile Time Options |
| 54 |
61 |
| 73 always use an own implementation. |
80 always use an own implementation. |
| 74 <tip> |
81 <tip> |
| 75 This macro is defined when you use the <code>--disable-szmul-builtin</code> |
82 This macro is defined when you use the <code>--disable-szmul-builtin</code> |
| 76 option during configuration, so you do not need to define it manually. |
83 option during configuration, so you do not need to define it manually. |
| 77 </tip> |
84 </tip> |
| |
85 </td> |
| |
86 </tr> |
| |
87 <tr> |
| |
88 <td>CX_WINDLL</td> |
| |
89 <td> |
| |
90 Define this macro during compilation of the project that is <emphasis>using</emphasis> |
| |
91 UCX as a Windows DLL to import the symbols. |
| |
92 In general it is recommended to use UCX as a static library under Windows, though. |
| |
93 </td> |
| |
94 </tr> |
| |
95 <tr> |
| |
96 <td>CX_WINDLL_EXPORT</td> |
| |
97 <td> |
| |
98 Define this macro during compilation of UCX to export symbols for a Windows DLL. |
| |
99 <tip>The Visual Studio Solution does that automatically.</tip> |
| 78 </td> |
100 </td> |
| 79 </tr> |
101 </tr> |
| 80 </table> |
102 </table> |
| 81 |
103 |
| 82 ### Small Buffer Optimizations |
104 ### Small Buffer Optimizations |