GNU Info

(nasm.info)Section 2.1.22

---

Next: Section 2.2 Prev: Section 2.1.21 Up: Section 2.1

---

Enter node , (file) or (file)node

2.1.22. The `NASMENV' Environment Variable
------------------------------------------

   If you define an environment variable called `NASMENV', the program
will interpret it as a list of extra command-line options, which are
processed before the real command line. You can use this to define
standard search directories for include files, by putting `-i' options
in the `NASMENV' variable.

   The value of the variable is split up at white space, so that the
value `-s -ic:\nasmlib' will be treated as two separate options.
However, that means that the value `-dNAME="my name"' won't do what you
might want, because it will be split at the space and the NASM
command-line processing will get confused by the two nonsensical words
`-dNAME="my' and `name"'.

   To get round this, NASM provides a feature whereby, if you begin the
`NASMENV' environment variable with some character that isn't a minus
sign, then NASM will treat this character as the separator character for
options. So setting the `NASMENV' variable to the value
`!-s!-ic:\nasmlib' is equivalent to setting it to `-s -ic:\nasmlib',
but `!-dNAME="my name"' will work.

   This environment variable was previously called `NASM'. This was
changed with version 0.98.31.