mirror of
https://github.com/intel/isa-l.git
synced 2025-09-06 06:10:54 +02:00
8045bee170
NASM version 2.14.01 supports all x86 ISA in this library. Since this version has been out since 2018, it is safe to only permit the library to be compiled with this minimum version, as announced in issue #297. Signed-off-by: Pablo de Lara <pablo.de.lara.guarch@intel.com>
62 lines
2.0 KiB
Markdown
62 lines
2.0 KiB
Markdown
# ISA-L Build Details
|
|
|
|
## Build tools
|
|
|
|
NASM: For x86-64 builds it is highly recommended to get an up-to-date version of
|
|
[nasm] that can understand the latest instruction sets.
|
|
Minimum version of NASM is 2.14.01, supporting all the ISA needed for the library.
|
|
The configure or make tools can check for this minimum version.
|
|
|
|
checking for nasm... yes
|
|
checking for modern nasm... yes
|
|
|
|
If an appropriate nasm is not available from your distro, it is simple to build
|
|
from source or download an executable from [nasm].
|
|
|
|
git clone --depth=10 https://github.com/netwide-assembler/nasm
|
|
cd nasm
|
|
./autogen.sh
|
|
./configure
|
|
make
|
|
sudo make install
|
|
|
|
## Windows Build Environment Details
|
|
|
|
The windows dynamic and static libraries can be built with the nmake tool on the
|
|
windows command line when appropriate paths and tools are setup as follows.
|
|
|
|
### Download nasm and put into path
|
|
|
|
Download and install [nasm] and add location to path.
|
|
|
|
set PATH=%PATH%;C:\Program Files\NASM
|
|
|
|
### Setup compiler environment
|
|
|
|
Install compiler and run environment setup script.
|
|
|
|
Compilers for windows usually have a batch file to setup environment variables
|
|
for the command line called `vcvarsall.bat` or `compilervars.bat` or a link to
|
|
run these. For Visual Studio this may be as follows for Community edition.
|
|
|
|
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat x64
|
|
|
|
For the Intel compiler the path is typically as follows where yyyy, x, zzz
|
|
represent the version.
|
|
|
|
C:\Program Files (x86)\IntelSWTools\system_studio_for_windows_yyyy.x.zzz\compilers_and_libraries_yyyy\bin\compilervars.bat intel64
|
|
|
|
### Build ISA-L libs and copy to appropriate place
|
|
|
|
Run `nmake /f Makefile.nmake`
|
|
|
|
This should build isa-l.dll, isa-l.lib and isa-l_static.lib. You may want to
|
|
copy the libs to a system directory in the dynamic linking path such as
|
|
`C:\windows\system32` or to a project directory.
|
|
|
|
To build a simple program with a static library.
|
|
|
|
cl /Fe: test.exe test.c isa-l_static.lib
|
|
|
|
[nasm]: https://www.nasm.us
|