11. Installing NASM from source (Unix, MacOS X; Windows - Cygwin;
2   Windows - MinGW; DOS - DJGPP)
32. Installing NASM from source (Windows - MS Visual C++)
43. Installing NASM from source (DOS, Windows, OS/2 - OpenWatcom)
5
6
71. Installing NASM from source (Unix, MacOS X; Windows - Cygwin;
8   Windows - MinGW; DOS - DJGPP)
9================================================================
10
11Installing NASM is pretty straightforward on Unix or Unix-like systems
12with a C compiler, Make, and standard shell tools installed, including
13MinGW for Windows (with MSYS installed) and DJGPP for DOS with the
14appropriate tools.  Perl is not required for compiling unmodified
15sources from a tarball, but is required to build from git or for most
16source modifications.
17
18If you checked out source from git you will need to run autoconf to
19generate configure, otherwise you don't have to.
20
21$ sh autogen.sh
22
23Then run configure to detect your platform settings and generate makefiles.
24
25$ sh configure
26
27You can get information about available configuration options by
28running `sh configure --help`.
29
30If configure fails, please file a bug report with detailed platform
31information at:
32
33    http://www.sf.net/projects/nasm/
34
35If everything went okay, type
36
37$ make
38
39to build NASM, ndisasm and rdoff tools, or
40
41$ make everything
42
43to build the former plus the docs.
44
45You can decrease the size of produces executables by stripping off
46unnecessary information, to achieve this run
47
48$ make strip
49
50If you install to a system-wide location you might need to become
51root:
52
53$ su <enter root password>
54
55then
56
57$ make install
58
59optionally followed by
60
61$ make install_rdf
62
63Or you can
64
65$ make install_everything
66
67to install everything =)
68
69
70Thats it, enjoy!
71
72
732. Installing NASM from source (Windows - MS Visual C++)
74========================================================
75
76The recommended compiler for NASM on Windows is MinGW
77(http://www.mingw.org/), but it is also possible to compile with
78Microsoft Visual C++ (tested with Visual C++ 2005 Express Edition.)
79
80To do so, start the "Visual C++ Command Shell", go to the directory
81where the NASM source code was extracted, and run:
82
83> nmake /f Mkfiles/msvc.mak
84
85We recommend MinGW over Visual C++ 2005 as we have found it to be more
86up to date with regards to C99 compliance, and we are increasingly
87using C99 features in NASM.
88
89
903. Installing NASM from source (DOS, Windows, OS/2 - OpenWatcom)
91================================================================
92
93NASM has been reported to build correctly with OpenWatcom 1.7 on the
94Windows and OS/2 platforms.  In addition, it *should* work under DOS
95with the DOS4GW DOS extender, although the NASM developers recommend
96using DJGPP with the CWSDPMI DOS extender instead.
97
98A WMAKE make file is provided:
99
100> wmake -f Mkfiles\openwcom.mak <platform>
101
102... where <platform> is "dos", "win32" or "os2".
103