summaryrefslogtreecommitdiff
path: root/INSTALL
blob: 461137d57541ec10f8660ecd5f5459803c7680d2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
1. Installing NASM from source (Unix, MacOS X, Windows/Cygwin,
   Windows/MinGW)
2. Installing NASM from source (Windows/MS Visual C++)
3. Installing NASM from source (DOS-Windows-OS/2/OpenWatcom)


1. Installing NASM from source (Unix, MacOS X, Windows/Cygwin, Windows/MinGW)
=============================================================================

Installing NASM is pretty straightforward on Unix or Unix-like systems
with Perl and GNU tools installed, including MinGW for Windows with
MSYS installed.  Perl is optional for compiling unmodified sources
from a tarball, but is required to build from git or for most source
modifications.

If you checked out source from git you will need to run autoconf to
generate configure, otherwise you don't have to.

$ autoheader
$ autoconf

Then run configure to detect your platform settings and generate makefiles.

$ ./configure

You can get information about available configuration options by
running `./configure --help`.

If configure fails, please file a bug report with detailed platform
information at:

    http://www.sf.net/projects/nasm/

If everything went okay, type

$ make

to build NASM, ndisasm and rdoff tools, or

$ make everything

to build the former plus the docs.

You can decrease the size of produces executables by stripping off
unnecessary information, to achieve this run

$ make strip

If you install to a system-wide location you might need to become
root:

$ su <enter root password>

then

$ make install

optionally followed by 

$ make install_rdf

Or you can 

$ make install_everything

to install everything =)


Thats it, enjoy!


2. Installing NASM from source (Windows/MS Visual C++)
======================================================

The recommended compiler for NASM on Windows is MinGW
(http://www.mingw.org), but it is also possible to compile with
Microsoft Visual C++ (tested with Visual C++ 2005 Express Edition.)

To do so, start the "Visual C++ Command Shell", go to the directory
where the NASM source code was extracted, and run:

> nmake /f Mkfiles/msvc.mak

We recommend MinGW over Visual C++ 2005 as we have found it to be more
up to date with regards to C99 compliance, and we are increasingly
using C99 features in NASM.


3. Installing NASM from source (DOS-Windows-OS/2/OpenWatcom)
============================================================

NASM has been reported to build correctly with OpenWatcom 1.7 on and
OS/2 platform.  The NASM developers have not tested this on any other
platforms.

A WMAKE make file is provided:

> wmake -f Mkfiles\openwcom.mak <platform>

... where <platform> is "dos", "win32" or "os2".

NASM is known to NOT compile correctly using OpenWatcom 1.7.1 as a
cross compiler with a Linux host (OpenWatcom bug report 751.)