@@ -28,12 +28,12 @@ For this option you can use Cygwin.
2828Native builds using Visual C++
2929==============================
3030
31- The native builds using Visual C++ have a VC-* prefix.
31+ The native builds using Visual C++ have a ` VC-* ` prefix.
3232
3333Requirement details
3434-------------------
3535
36- In addition to the requirements and instructions listed in INSTALL.md,
36+ In addition to the requirements and instructions listed in ` INSTALL.md ` ,
3737these are required as well:
3838
3939### Perl
@@ -64,22 +64,26 @@ Quick start
6464
6565 4 . Use Visual Studio Developer Command Prompt with administrative privileges,
6666 choosing one of its variants depending on the intended architecture.
67- Or run "cmd" and execute "vcvarsall.bat" with one of the options x86,
68- x86_amd64, x86_arm, x86_arm64, amd64, amd64_x86, amd64_arm, or amd64_arm64.
69- This sets up the environment variables needed for nmake.exe, cl.exe, etc.
67+ Or run ` cmd ` and execute ` vcvarsall.bat ` with one of the options ` x86 ` ,
68+ ` x86_amd64 ` , ` x86_arm ` , ` x86_arm64 ` , ` amd64 ` , ` amd64_x86 ` , ` amd64_arm ` ,
69+ or ` amd64_arm64 ` .
70+ This sets up the environment variables needed for ` nmake.exe ` , ` cl.exe ` ,
71+ etc.
7072 See also
7173 < https://docs.microsoft.com/cpp/build/building-on-the-command-line >
7274
7375 5 . From the root of the OpenSSL source directory enter
74- perl Configure VC-WIN32 if you want 32-bit OpenSSL or
75- perl Configure VC-WIN64A if you want 64-bit OpenSSL or
76- perl Configure to let Configure figure out the platform
76+ - ` perl Configure VC-WIN32 ` if you want 32-bit OpenSSL or
77+ - ` perl Configure VC-WIN64A ` if you want 64-bit OpenSSL or
78+ - ` perl Configure VC-WIN64-ARM ` if you want Windows on Arm (win-arm64)
79+ OpenSSL or
80+ - ` perl Configure ` to let Configure figure out the platform
7781
78- 6 . nmake
82+ 6 . ` nmake `
7983
80- 7 . nmake test
84+ 7 . ` nmake test `
8185
82- 8 . nmake install
86+ 8 . ` nmake install `
8387
8488For the full installation instructions, or if anything goes wrong at any stage,
8589check the INSTALL.md file.
@@ -109,37 +113,37 @@ installation for examples), these fallbacks are used:
109113ALSO NOTE that those directories are usually write protected, even if
110114your account is in the Administrators group. To work around that,
111115start the command prompt by right-clicking on it and choosing "Run as
112- Administrator" before running ' nmake install' . The other solution
116+ Administrator" before running ` nmake install ` . The other solution
113117is, of course, to choose a different set of directories by using
114- --prefix and --openssldir when configuring.
118+ ` --prefix ` and ` --openssldir ` when configuring.
115119
116- Special notes for Universal Windows Platform builds, aka VC-* -UWP
117- --------------------------------------------------------------------
120+ Special notes for Universal Windows Platform builds, aka ` VC-*-UWP `
121+ -------------------------------------------------------------------
118122
119123 - UWP targets only support building the static and dynamic libraries.
120124
121- - You should define the platform type to " uwp" and the target arch via
122- " vcvarsall.bat" before you compile. For example, if you want to build
123- " arm64" builds, you should run " vcvarsall.bat x86_arm64 uwp" .
125+ - You should define the platform type to ` uwp ` and the target arch via
126+ ` vcvarsall.bat ` before you compile. For example, if you want to build
127+ ` arm64 ` builds, you should run ` vcvarsall.bat x86_arm64 uwp ` .
124128
125129Native builds using Embarcadero C++Builder
126130=========================================
127131
128132This toolchain (a descendant of Turbo/Borland C++) is an alternative to MSVC.
129133OpenSSL currently includes an experimental 32-bit configuration targeting the
130- Clang-based compiler (bcc32c.exe) in v10.3.3 Community Edition.
134+ Clang-based compiler (` bcc32c.exe ` ) in v10.3.3 Community Edition.
131135< https://www.embarcadero.com/products/cbuilder/starter >
132136
133137 1 . Install Perl.
134138
135139 2 . Open the RAD Studio Command Prompt.
136140
137141 3 . Go to the root of the OpenSSL source directory and run:
138- perl Configure BC-32 --prefix=%CD%
142+ ` perl Configure BC-32 --prefix=%CD% `
139143
140- 4 . make -N
144+ 4 . ` make -N `
141145
142- 5 . make -N test
146+ 5 . ` make -N test `
143147
144148 6 . Build your program against this OpenSSL:
145149 * Set your include search path to the "include" subdirectory of OpenSSL.
@@ -166,32 +170,38 @@ MinGW offers an alternative way to build native OpenSSL, by cross compilation.
166170
167171 - Perl, at least version 5.10.0, which usually comes pre-installed with MSYS2
168172
169- - make, installed using " pacman -S make" into the MSYS2 environment
173+ - make, installed using ` pacman -S make ` into the MSYS2 environment
170174
171- - MinGW[ 64] compiler: mingw-w64-i686-gcc and/or mingw-w64-x86_64-gcc.
175+ - MinGW[ 64] compiler: ` mingw-w64-i686-gcc ` and/or ` mingw-w64-x86_64-gcc ` .
172176 These compilers must be on your MSYS2 $PATH.
173177 A common error is to not have these on your $PATH.
174178 The MSYS2 version of gcc will not work correctly here.
175179
176180 In the MSYS2 shell do the configuration depending on the target architecture:
177181
178182 ./Configure mingw ...
183+
179184 or
185+
180186 ./Configure mingw64 ...
187+
181188 or
189+
182190 ./Configure ...
183191
184192 for the default architecture.
185193
186- Apart from that, follow the Unix / Linux instructions in INSTALL.md.
194+ Apart from that, follow the Unix / Linux instructions in ` INSTALL.md ` .
187195
188196 * It is also possible to build mingw[ 64] on Linux or Cygwin.
189197
190- In this case configure with the corresponding --cross-compile-prefix= option.
191- For example
198+ In this case configure with the corresponding ` --cross-compile-prefix= `
199+ option. For example
192200
193201 ./Configure mingw --cross-compile-prefix=i686-w64-mingw32- ...
202+
194203 or
204+
195205 ./Configure mingw64 --cross-compile-prefix=x86_64-w64-mingw32- ...
196206
197207 This requires that you've installed the necessary add-on packages for
@@ -203,18 +213,18 @@ Linking native applications
203213This section applies to all native builds.
204214
205215If you link with static OpenSSL libraries then you're expected to
206- additionally link your application with WS2_32.LIB, GDI32.LIB,
207- ADVAPI32.LIB, CRYPT32.LIB and USER32.LIB. Those developing
216+ additionally link your application with ` WS2_32.LIB ` , ` GDI32.LIB ` ,
217+ ` ADVAPI32.LIB ` , ` CRYPT32.LIB ` and ` USER32.LIB ` . Those developing
208218non-interactive service applications might feel concerned about
209- linking with GDI32.LIB and USER32.LIB, as they are justly associated
219+ linking with ` GDI32.LIB ` and ` USER32.LIB ` , as they are justly associated
210220with interactive desktop, which is not available to service
211221processes. The toolkit is designed to detect in which context it's
212222currently executed, GUI, console app or service, and act accordingly,
213223namely whether or not to actually make GUI calls. Additionally those
214- who wish to /DELAYLOAD: GDI32 .DLL and /DELAYLOAD: USER32 .DLL and
224+ who wish to ` /DELAYLOAD:GDI32.DLL ` and ` /DELAYLOAD:USER32.DLL ` and
215225actually keep them off service process should consider implementing
216- and exporting from .exe image in question own _ OPENSSL_isservice not
217- relying on USER32.DLL. E.g., on Windows Vista and later you could:
226+ and exporting from .exe image in question own ` _OPENSSL_isservice ` not
227+ relying on ` USER32.DLL ` . E.g., on Windows Vista and later you could:
218228
219229 __declspec(dllexport) __cdecl BOOL _OPENSSL_isservice(void)
220230 {
@@ -233,7 +243,7 @@ See also the OPENSSL_Applink manual page.
233243Hosted builds using Cygwin
234244==========================
235245
236- Cygwin implements a POSIX/Unix runtime system (cygwin1.dll) on top of the
246+ Cygwin implements a POSIX/Unix runtime system (` cygwin1.dll ` ) on top of the
237247Windows subsystem and provides a Bash shell and GNU tools environment.
238248Consequently, a build of OpenSSL with Cygwin is virtually identical to the
239249Unix procedure.
@@ -249,7 +259,7 @@ To build OpenSSL using Cygwin, you need to:
249259
250260Apart from that, follow the Unix / Linux instructions in INSTALL.md.
251261
252- NOTE: " make test" and normal file operations may fail in directories
253- mounted as text (i.e. mount -t c:\somewhere /home) due to Cygwin
262+ NOTE: ` make test ` and normal file operations may fail in directories
263+ mounted as text (i.e. ` mount -t c:\somewhere /home ` ) due to Cygwin
254264stripping of carriage returns. To avoid this ensure that a binary
255- mount is used, e.g. mount -b c:\somewhere /home.
265+ mount is used, e.g. ` mount -b c:\somewhere /home ` .
0 commit comments