File: warnings.src

package info (click to toggle)
nasm 3.01-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 23,660 kB
  • sloc: ansic: 129,101; asm: 40,471; perl: 8,238; sh: 4,146; makefile: 1,281; xml: 726; python: 582; lisp: 578; sed: 11
file content (872 lines) | stat: -rw-r--r-- 29,530 bytes parent folder | download
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872

\IR{w-all} warning class, \c{all}
\IR{w-bad-pragma} warning class, \c{bad-pragma}
\IR{w-bnd} warning class, \c{bnd}
\IR{w-db-empty} warning class, \c{db-empty}
\IR{w-directive-garbage-eol} warning class, \c{directive-garbage-eol}
\IR{w-ea} warning class, \c{ea}
\IR{w-ea-absolute} warning class, \c{ea-absolute}
\IR{w-ea-dispsize} warning class, \c{ea-dispsize}
\IR{w-environment} warning class, \c{environment}
\IR{w-float} warning class, \c{float}
\IR{w-float-denorm} warning class, \c{float-denorm}
\IR{w-float-overflow} warning class, \c{float-overflow}
\IR{w-float-toolong} warning class, \c{float-toolong}
\IR{w-float-underflow} warning class, \c{float-underflow}
\IR{w-forward} warning class, \c{forward}
\IR{w-hle} warning class, \c{hle}
\IR{w-implicit-abs-deprecated} warning class, \c{implicit-abs-deprecated}
\IR{w-label} warning class, \c{label}
\IR{w-label-orphan} warning class, \c{label-orphan}
\IR{w-label-redef} warning class, \c{label-redef}
\IR{w-label-redef-late} warning class, \c{label-redef-late}
\IR{w-lock} warning class, \c{lock}
\IR{w-macro-def-case-single} warning class, \c{macro-def-case-single}
\IR{w-macro-def-greedy-single} warning class, \c{macro-def-greedy-single}
\IR{w-macro-def-param-single} warning class, \c{macro-def-param-single}
\IR{w-macro-defaults} warning class, \c{macro-defaults}
\IR{w-macro-params-legacy} warning class, \c{macro-params-legacy}
\IR{w-macro-params-multi} warning class, \c{macro-params-multi}
\IR{w-macro-params-single} warning class, \c{macro-params-single}
\IR{w-negative-rep} warning class, \c{negative-rep}
\IR{w-not-my-pragma} warning class, \c{not-my-pragma}
\IR{w-number} warning class, \c{number}
\IR{w-number-deprecated-hex} warning class, \c{number-deprecated-hex}
\IR{w-number-overflow} warning class, \c{number-overflow}
\IR{w-obsolete} warning class, \c{obsolete}
\IR{w-obsolete-nop} warning class, \c{obsolete-nop}
\IR{w-obsolete-removed} warning class, \c{obsolete-removed}
\IR{w-obsolete-valid} warning class, \c{obsolete-valid}
\IR{w-orphan-labels} warning class, \c{orphan-labels}
\IR{w-other} warning class, \c{other}
\IR{w-phase} warning class, \c{phase}
\IR{w-pp} warning class, \c{pp}
\IR{w-pp-else} warning class, \c{pp-else}
\IR{w-pp-else-elif} warning class, \c{pp-else-elif}
\IR{w-pp-else-else} warning class, \c{pp-else-else}
\IR{w-pp-empty-braces} warning class, \c{pp-empty-braces}
\IR{w-pp-environment} warning class, \c{pp-environment}
\IR{w-pp-macro} warning class, \c{pp-macro}
\IR{w-pp-macro-def} warning class, \c{pp-macro-def}
\IR{w-pp-macro-def-case-single} warning class, \c{pp-macro-def-case-single}
\IR{w-pp-macro-def-greedy-single} warning class, \c{pp-macro-def-greedy-single}
\IR{w-pp-macro-def-param-single} warning class, \c{pp-macro-def-param-single}
\IR{w-pp-macro-defaults} warning class, \c{pp-macro-defaults}
\IR{w-pp-macro-params} warning class, \c{pp-macro-params}
\IR{w-pp-macro-params-legacy} warning class, \c{pp-macro-params-legacy}
\IR{w-pp-macro-params-multi} warning class, \c{pp-macro-params-multi}
\IR{w-pp-macro-params-single} warning class, \c{pp-macro-params-single}
\IR{w-pp-macro-redef-multi} warning class, \c{pp-macro-redef-multi}
\IR{w-pp-open} warning class, \c{pp-open}
\IR{w-pp-open-braces} warning class, \c{pp-open-braces}
\IR{w-pp-open-brackets} warning class, \c{pp-open-brackets}
\IR{w-pp-open-string} warning class, \c{pp-open-string}
\IR{w-pp-rep-negative} warning class, \c{pp-rep-negative}
\IR{w-pp-sel-range} warning class, \c{pp-sel-range}
\IR{w-pp-trailing} warning class, \c{pp-trailing}
\IR{w-pragma} warning class, \c{pragma}
\IR{w-pragma-bad} warning class, \c{pragma-bad}
\IR{w-pragma-empty} warning class, \c{pragma-empty}
\IR{w-pragma-na} warning class, \c{pragma-na}
\IR{w-pragma-unknown} warning class, \c{pragma-unknown}
\IR{w-prefix} warning class, \c{prefix}
\IR{w-prefix-badmode-o64} warning class, \c{prefix-badmode-o64}
\IR{w-prefix-bnd} warning class, \c{prefix-bnd}
\IR{w-prefix-hint-dropped} warning class, \c{prefix-hint-dropped}
\IR{w-prefix-hle} warning class, \c{prefix-hle}
\IR{w-prefix-invalid} warning class, \c{prefix-invalid}
\IR{w-prefix-lock} warning class, \c{prefix-lock}
\IR{w-prefix-lock-error} warning class, \c{prefix-lock-error}
\IR{w-prefix-lock-xchg} warning class, \c{prefix-lock-xchg}
\IR{w-prefix-opsize} warning class, \c{prefix-opsize}
\IR{w-prefix-seg} warning class, \c{prefix-seg}
\IR{w-ptr} warning class, \c{ptr}
\IR{w-regsize} warning class, \c{regsize}
\IR{w-reloc} warning class, \c{reloc}
\IR{w-reloc-abs} warning class, \c{reloc-abs}
\IR{w-reloc-abs-byte} warning class, \c{reloc-abs-byte}
\IR{w-reloc-abs-dword} warning class, \c{reloc-abs-dword}
\IR{w-reloc-abs-qword} warning class, \c{reloc-abs-qword}
\IR{w-reloc-abs-word} warning class, \c{reloc-abs-word}
\IR{w-reloc-rel} warning class, \c{reloc-rel}
\IR{w-reloc-rel-byte} warning class, \c{reloc-rel-byte}
\IR{w-reloc-rel-dword} warning class, \c{reloc-rel-dword}
\IR{w-reloc-rel-qword} warning class, \c{reloc-rel-qword}
\IR{w-reloc-rel-word} warning class, \c{reloc-rel-word}
\IR{w-section-alignment-rounded} warning class, \c{section-alignment-rounded}
\IR{w-unknown-pragma} warning class, \c{unknown-pragma}
\IR{w-unknown-warning} warning class, \c{unknown-warning}
\IR{w-user} warning class, \c{user}
\IR{w-warn-stack-empty} warning class, \c{warn-stack-empty}
\IR{w-zeroing} warning class, \c{zeroing}
\IR{w-zext-reloc} warning class, \c{zext-reloc}


\H{warning-classes} Warning Classes

This list shows each warning class that can be
enabled or disabled individually. Each warning containing
a \c{-} character in the name can also be enabled or
disabled as part of a group, named by removing one or more
\c{-}-delimited suffixes.

\S{warnings-classes-on} Enabled by default

\b \I{w-db-empty} \c{db-empty}: no operand for data declaration

\> Warns about a \c{D}\e{x} declaration
with no operands, producing no output.
This is permitted, but often indicative of an error.
See \k{db}.


\b \I{w-ea-absolute} \c{ea-absolute}: absolute address cannot be RIP-relative

\> Warns that an address that is inherently absolute cannot
be generated with RIP-relative encoding using \c{REL},
see \k{default-rel}.


\b \I{w-ea-dispsize} \c{ea-dispsize}: displacement size ignored on absolute address

\> Warns that NASM does not support generating displacements for
inherently absolute addresses that do not match the address size
of the instruction.


\b \I{w-float-overflow} \c{float-overflow}: floating point overflow

\> Warns about floating point underflow.


\b \I{w-float-toolong} \c{float-toolong}: too many digits in floating-point number

\> Warns about too many digits in floating-point numbers.


\b \I{w-forward} \c{forward}: forward reference may have unpredictable results

\> Warns that a forward reference is used which may have
unpredictable results, notably in a \c{RESB}-type
pseudo-instruction. These would be \i\e{critical
expressions} (see \k{crit}) but are permitted in a
handful of cases for compatibility with older
versions of NASM. This warning should be treated as a
severe programming error as the code could break at
any time for any number of reasons.


\b \I{w-implicit-abs-deprecated} \c{implicit-abs-deprecated}: implicit DEFAULT ABS is deprecated

\> Warns that in a future version of NASM, the 64-bit default
addressing form is likely to change from \c{DEFAULT ABS} to
\c{DEFAULT REL}. If absolute addressing is indeed intended, it is
strongly recommended to specify \c{DEFAULT ABS} explicitly.


\b \I{w-label-orphan} \c{label-orphan}: labels alone on lines without trailing \c{:}

\> Warns about source lines which contain no instruction but define
a label without a trailing colon. This is most likely indicative
of a typo, but is technically correct NASM syntax (see \k{syntax}.)


\b \I{w-number-deprecated-hex} \c{number-deprecated-hex}: $ prefix for hexadecimal is deprecated

\> Warns that the \c{$} prefix for hexadecimal numbers is
deprecated, due to the syntactic conflict with \c{$} used
as a symbol escape prefix. This syntax may be disabled by
default in a future version of NASM. Replace \c{$} with \c{0x}
to ensure compatibility with future versions.


\b \I{w-number-overflow} \c{number-overflow}: numeric constant does not fit

\> Covers warnings about numeric constants which
don't fit in 64 bits.


\b \I{w-obsolete-nop} \c{obsolete-nop}: instruction obsolete and is a noop on the target CPU

\> Warns for an instruction which has been removed
from the architecture, but has been architecturally
defined to be a noop for future CPUs.


\b \I{w-obsolete-removed} \c{obsolete-removed}: instruction obsolete and removed on the target CPU

\> Warns for an instruction which has been removed
from the architecture, and is no longer included
in the CPU definition given in the \c{[CPU]}
directive, for example \c{POP CS}, the opcode for
which, \c{0Fh}, instead is an opcode prefix on
CPUs newer than the first generation 8086.


\b \I{w-obsolete-valid} \c{obsolete-valid}: instruction obsolete but valid on the target CPU

\> Warns for an instruction which has been removed
from the architecture, but is still valid on the
specific CPU given in the \c{CPU} directive. Code
using these instructions is most likely not
forward compatible.


\b \I{w-other} \c{other}: any warning not assigned to a specific warning class

\> Specifies any warning not included in any specific warning class.


\b \I{w-pp-else-elif} \c{pp-else-elif}: \c{%elif} after \c{%else}

\> Warns that an \c{%elif}-type directive was encountered
after \c{%else} has already been encounted. As a result, the
content of the \c{%elif} will never be expanded.


\b \I{w-pp-else-else} \c{pp-else-else}: \c{%else} after \c{%else}

\> Warns that a second \c{%else} clause was found for
the same \c{%if} statement. The content of this \c{%else}
clause will never be expanded.


\b \I{w-pp-empty-braces} \c{pp-empty-braces}: empty \c{%\{\}} construct

\> Warns that an empty \c{%\{\}} was encountered.
This expands to a single \c{%} character, which
is normally the \c{%} arithmetic operator.


\b \I{w-pp-environment} \c{pp-environment}: nonexistent environment variable

\> Warns if a nonexistent environment variable
is accessed using the \c{%!} preprocessor
construct (see \k{getenv}.)  Such environment
variables are treated as empty (with this
warning issued) starting in NASM 2.15;
earlier versions of NASM would treat this as
an error.


\b \I{w-pp-macro-def-case-single} \c{pp-macro-def-case-single}: single-line macro defined both case sensitive and insensitive

\> Warns when a single-line macro is defined both case
sensitive and case insensitive.
The new macro
definition will override (shadow) the original one,
although the original macro is not deleted, and will
be re-exposed if the new macro is deleted with
\c{%undef}, or, if the original macro is the case
insensitive one, the macro call is done with a
different case.


\b \I{w-pp-macro-def-greedy-single} \c{pp-macro-def-greedy-single}: single-line macro

\> Warns that a single-line macro is defined which would match a
previously existing greedy definition.  The new macro definition
will override (shadow) the original one, although the original
macro is not deleted, and will be re-exposed if the new macro is
deleted with \c{%undef}, and will be invoked if called with a
parameter count that does not match the new definition.


\b \I{w-pp-macro-defaults} \c{pp-macro-defaults}: macros with more default than optional parameters

\> Warns when a macro has more default parameters than optional parameters.
See \k{mlmacdef} for why one might want to disable this warning.


\b \I{w-pp-macro-params-legacy} \c{pp-macro-params-legacy}: improperly calling multi-line macro for legacy support

\> Warns about \i{multi-line macros} being invoked
with the wrong number of parameters, but for bug-compatibility
with NASM versions older than 2.15, NASM tried to fix up the
parameters to match the legacy behavior and call the macro anyway.
This can happen in certain cases where there are empty arguments
without braces, sometimes as a result of macro expansion.

\> The legacy behavior is quite strange and highly context-dependent,
and can be disabled with:

\c      %pragma preproc sane_empty_expansion true

\> It is highly recommended to use this option in new code.


\b \I{w-pp-macro-params-multi} \c{pp-macro-params-multi}: multi-line macro calls with wrong parameter count

\> Warns about \i{multi-line macros} being invoked
with the wrong number of parameters. See \k{mlmacover} for an
example of why you might want to disable this warning.


\b \I{w-pp-macro-params-single} \c{pp-macro-params-single}: single-line macro calls with wrong parameter count

\> Warns about \i{single-line macros} being invoked
with the wrong number of parameters.


\b \I{w-pp-macro-redef-multi} \c{pp-macro-redef-multi}: redefining multi-line macro

\> Warns that a multi-line macro is being redefined,
without first removing the old definition with
\c{%unmacro}.


\b \I{w-pp-open-braces} \c{pp-open-braces}: unterminated \c{%\{...\}}

\> Warns that a preprocessor parameter
enclosed in braces \c{%\{...\}} lacks the
terminating \c{\}} character.


\b \I{w-pp-open-brackets} \c{pp-open-brackets}: unterminated \c{%[...]}

\> Warns that a preprocessor \c{%[...]} construct
lacks the terminating \c{]} character.


\b \I{w-pp-open-string} \c{pp-open-string}: unterminated string

\> Warns that a quoted string without a closing quotation
mark was encountered during preprocessing.


\b \I{w-pp-rep-negative} \c{pp-rep-negative}: regative \c{%rep} count

\> Warns about a negative count given to the \c{%rep}
preprocessor directive.


\b \I{w-pp-sel-range} \c{pp-sel-range}: \c{%sel()} argument out of range

\> Warns that the \c{%sel()} preprocessor function was passed
a value less than 1 or larger than the number of available
arguments.


\b \I{w-pp-trailing} \c{pp-trailing}: trailing garbage ignored

\> Warns that the preprocessor encountered additional text
where no such text was expected. This can
sometimes be the result of an incorrectly written expression,
or arguments that are inadvertently separated.


\b \I{w-prefix-bnd} \c{prefix-bnd}: invalid \c{BND} prefix

\> Warns about ineffective use of the \c{BND} prefix when the
\c{JMP} instruction is converted to the \c{SHORT} form.
This should be extremely rare since the short \c{JMP} only
is applicable to jumps inside the same module, but if
it is legitimate, it may be necessary to use
\c{bnd jmp dword}.


\b \I{w-prefix-hint-dropped} \c{prefix-hint-dropped}: invalid branch hint prefix dropped

\> Warns that the \c{{PT}} (predict taken) or \c{{PN}}
(predict not taken) branch prediction hint prefixes
are specified on an instruction that does not take
these prefixes. As these prefixes alias the segment
override prefixes, this may be a very serious error,
and therefore NASM will not generate these prefixes.
To force these prefixes to be emitted, use \c{DS} or
\c{CS}, instead, respectively.


\b \I{w-prefix-hle} \c{prefix-hle}: invalid HLE prefix

\> Warns about invalid use of the HLE \c{XACQUIRE} or \c{XRELEASE}
prefixes.


\b \I{w-prefix-invalid} \c{prefix-invalid}: invalid prefix for instruction

\> Warns about an instruction which is only valid with certain
combinations of prefixes. The prefix will still be generated as
requested, but the result may be a completely different
instruction or result in a \c{#UD} trap.


\b \I{w-prefix-lock-error} \c{prefix-lock-error}: \c{LOCK} prefix on unlockable instruction

\> Warns about \c{LOCK} prefixes specified on unlockable instructions.


\b \I{w-prefix-lock-xchg} \c{prefix-lock-xchg}: superfluous \c{LOCK} prefix on \c{XCHG} instruction

\> Warns about a \c{LOCK} prefix added to an \c{XCHG} instruction.
The \c{XCHG} instruction is \e{always} locking, and so this
prefix is not necessary; however, NASM will generate it if
explicitly provided by the user, so this warning indicates that
suboptimal code is being generated.


\b \I{w-prefix-opsize} \c{prefix-opsize}: invalid operand size prefix

\> Warns that an operand prefix (\c{o16}, \c{o32}, \c{o64},
\c{osp}) invalid for the specified instruction has been specified.
The operand prefix will be ignored by the assembler.


\b \I{w-prefix-seg} \c{prefix-seg}: segment prefix ignored in 64-bit mode

\> Warns that an \c{es}, \c{cs}, \c{ss} or \c{ds} segment override
prefix has no effect in 64-bit mode. The prefix will still be
generated as requested.


\b \I{w-ptr} \c{ptr}: non-NASM keyword used in other assemblers

\> Warns about keywords used in other assemblers that
might indicate a mistake in the source code.
Currently only the MASM \c{PTR} keyword is
recognized. If (limited) MASM compatibility is
desired, the \c{%use masm} macro package is
available, see \k{pkg_masm}; however, carefully note
the caveats listed.


\b \I{w-regsize} \c{regsize}: register size specification ignored

\> Warns about a register with implicit size (such as \c{EAX}, which
is always 32 bits) been given an explicit size specification which
is inconsistent with the size of the named register, e.g. \c{WORD
EAX}. \c{DWORD EAX} or \c{WORD AX} are permitted, and do not
trigger this warning. Some registers which \e{do not} imply a
specific size, such as \c{K0}, may need this specification unless
the instruction itself implies the instruction size:

\c      KMOVW K0,[foo]          ; OK: KMOVW = 16 bits
\c      KMOV  WORD K0,[foo]     ; OK: WORD K0 = 16 bits
\c      KMOV  K0,WORD [foo]     ; OK: WORD [foo] = 16 bits
\c      KMOV  K0,[foo]          ; Error: unknown size


\b \I{w-section-alignment-rounded} \c{section-alignment-rounded}: section alignment rounded up

\> Warn if a section alignment is specified which is
not supported by the underlying object format, but
can be rounded up to a supported value.


\b \I{w-user} \c{user}: \c{%warning} directives

\> Controls output of \c{%warning} directives (see \k{pperror}).


\b \I{w-warn-stack-empty} \c{warn-stack-empty}: warning stack empty

\> A \c{[WARNING POP]} directive was executed when
the warning stack is empty. This is treated
as a \c{[WARNING *all]} directive.


\b \I{w-zeroing} \c{zeroing}: \c{RES}\e{x} in initialized section becomes zero

\> A \c{RES}\e{x} directive was used in a section which contains
initialized data, and the output format does not support
this. Instead, this will be replaced with explicit zero
content, which may produce a large output file.


\b \I{w-zext-reloc} \c{zext-reloc}: relocation zero-extended to match output format

\> Warns that a relocation has been zero-extended due
to limitations in the output format.


\S{warnings-classes-err} Enabled and promoted to error by default

\b \I{w-directive-garbage-eol} \c{directive-garbage-eol}: garbage after directive

\> Text was found after a directive. This is a warning so it can be
suppressed, because previous versions of NASM did not check for
this condition.


\b \I{w-label-redef-late} \c{label-redef-late}: label (re)defined during code generation

\> The value of a label changed during the final, code-generation
pass. This may be the result of strange use of the
preprocessor. This is very likely to produce incorrect code and
may end up being an unconditional error in a future
version of NASM.


\b \I{w-pp-macro-def-param-single} \c{pp-macro-def-param-single}: single-line macro defined with and without parameters

\> Warns if the same single-line macro is defined with and without
parameters.  The new macro definition will override (shadow) the
original one, although the original macro is not deleted, and will
be re-exposed if the new macro is deleted with \c{%undef}.


\b \I{w-prefix-badmode-o64} \c{prefix-badmode-o64}: o64 prefix invalid in 16/32-bit mode

\> Warns that an \c{a64} prefix was specified in 16- or 32-bit
mode. If the error is demoted to a warning or suppressed, the
prefix is ignored by the assembler, but is likely to trigger
futher errors.



\S{warnings-classes-off} Disabled by default

\b \I{w-float-denorm} \c{float-denorm}: floating point denormal

\> Warns about denormal floating point constants.


\b \I{w-float-underflow} \c{float-underflow}: floating point underflow

\> Warns about floating point underflow (a nonzero
constant rounded to zero.)


\b \I{w-label-redef} \c{label-redef}: label redefined to an identical value

\> Warns if a label is defined more than once, but the
value is identical. It is an unconditional error to
define the same label more than once to \e{different} values.


\b \I{w-phase} \c{phase}: phase error during stabilization

\> Warns about symbols having changed values during
the second-to-last assembly pass. This is not
inherently fatal, but may be a source of bugs.


\b \I{w-pragma-bad} \c{pragma-bad}: malformed \c{%pragma}

\> Warns about a malformed or otherwise unparsable
\c{%pragma} directive.


\b \I{w-pragma-empty} \c{pragma-empty}: empty \c{%pragma} directive

\> Warns about a \c{%pragma} directive containing nothing.
This is treated identically to \c{%pragma ignore} except
for this optional warning.


\b \I{w-pragma-na} \c{pragma-na}: \c{%pragma} not applicable to this compilation

\> Warns about a \c{%pragma} directive which is not applicable to
this particular assembly session.  This is not yet implemented.


\b \I{w-pragma-unknown} \c{pragma-unknown}: unknown \c{%pragma} facility or directive

\> Warns about an unknown \c{%pragma} directive.
This is not yet implemented for most cases.


\b \I{w-reloc-abs-byte} \c{reloc-abs-byte}: 8-bit absolute section-crossing relocation

\> Warns that an 8-bit absolute relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-reloc-abs-dword} \c{reloc-abs-dword}: 32-bit absolute section-crossing relocation

\> Warns that a 32-bit absolute relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-reloc-abs-qword} \c{reloc-abs-qword}: 64-bit absolute section-crossing relocation

\> Warns that a 64-bit absolute relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-reloc-abs-word} \c{reloc-abs-word}: 16-bit absolute section-crossing relocation

\> Warns that a 16-bit absolute relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-reloc-rel-byte} \c{reloc-rel-byte}: 8-bit relative section-crossing relocation

\> Warns that an 8-bit relative relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-reloc-rel-dword} \c{reloc-rel-dword}: 32-bit relative section-crossing relocation

\> Warns that a 32-bit relative relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-reloc-rel-qword} \c{reloc-rel-qword}: 64-bit relative section-crossing relocation

\> Warns that an 64-bit relative relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-reloc-rel-word} \c{reloc-rel-word}: 16-bit relative section-crossing relocation

\> Warns that a 16-bit relative relocation that could
not be resolved at assembly time was generated in
the output format.

\> This is usually normal, but may not be handled by all
possible target environments


\b \I{w-unknown-warning} \c{unknown-warning}: unknown warning in \c{-W}/\c{-w} or warning directive

\> Warns about a \c{-w} or \c{-W} option or a \c{[WARNING]} directive
that contains an unknown warning name or is otherwise not possible
to process.



\H{warning-groups} Warning Class Groups

Warning class groups are aliases for all warning classes with a common
prefix. This list shows the warnings that are currently
included in specific warning groups.

\b \I{w-all} \c{all}: all possible warnings

\> \c{all} is an group alias for \e{all} warning classes.  Thus, \c{-w+all}
enables all available warnings, and \c{-w-all} disables warnings
entirely (since NASM 2.13).


\b \I{w-ea} \c{ea}: group alias for:

\c      ea-absolute
\c      ea-dispsize

\b \I{w-float} \c{float}: group alias for:

\c      float-denorm
\c      float-overflow
\c      float-toolong
\c      float-underflow

\b \I{w-label} \c{label}: group alias for:

\c      label-orphan
\c      label-redef
\c      label-redef-late

\b \I{w-number} \c{number}: group alias for:

\c      number-deprecated-hex
\c      number-overflow

\b \I{w-obsolete} \c{obsolete}: group alias for:

\c      obsolete-nop
\c      obsolete-removed
\c      obsolete-valid

\b \I{w-pp} \c{pp}: group alias for:

\c      pp-else-elif
\c      pp-else-else
\c      pp-empty-braces
\c      pp-environment
\c      pp-macro-def-case-single
\c      pp-macro-def-greedy-single
\c      pp-macro-def-param-single
\c      pp-macro-defaults
\c      pp-macro-params-legacy
\c      pp-macro-params-multi
\c      pp-macro-params-single
\c      pp-macro-redef-multi
\c      pp-open-braces
\c      pp-open-brackets
\c      pp-open-string
\c      pp-rep-negative
\c      pp-sel-range
\c      pp-trailing

\b \I{w-pp-else} \c{pp-else}: group alias for:

\c      pp-else-elif
\c      pp-else-else

\b \I{w-pp-macro} \c{pp-macro}: group alias for:

\c      pp-macro-def-case-single
\c      pp-macro-def-greedy-single
\c      pp-macro-def-param-single
\c      pp-macro-defaults
\c      pp-macro-params-legacy
\c      pp-macro-params-multi
\c      pp-macro-params-single
\c      pp-macro-redef-multi

\b \I{w-pp-macro-def} \c{pp-macro-def}: group alias for:

\c      pp-macro-def-case-single
\c      pp-macro-def-greedy-single
\c      pp-macro-def-param-single

\b \I{w-pp-macro-params} \c{pp-macro-params}: group alias for:

\c      pp-macro-params-legacy
\c      pp-macro-params-multi
\c      pp-macro-params-single

\b \I{w-pp-open} \c{pp-open}: group alias for:

\c      pp-open-braces
\c      pp-open-brackets
\c      pp-open-string

\b \I{w-pragma} \c{pragma}: group alias for:

\c      pragma-bad
\c      pragma-empty
\c      pragma-na
\c      pragma-unknown

\b \I{w-prefix} \c{prefix}: group alias for:

\c      prefix-badmode-o64
\c      prefix-bnd
\c      prefix-hint-dropped
\c      prefix-hle
\c      prefix-invalid
\c      prefix-lock-error
\c      prefix-lock-xchg
\c      prefix-opsize
\c      prefix-seg

\b \I{w-prefix-lock} \c{prefix-lock}: group alias for:

\c      prefix-lock-error
\c      prefix-lock-xchg

\b \I{w-reloc} \c{reloc}: group alias for:

\c      reloc-abs-byte
\c      reloc-abs-dword
\c      reloc-abs-qword
\c      reloc-abs-word
\c      reloc-rel-byte
\c      reloc-rel-dword
\c      reloc-rel-qword
\c      reloc-rel-word

\b \I{w-reloc-abs} \c{reloc-abs}: group alias for:

\c      reloc-abs-byte
\c      reloc-abs-dword
\c      reloc-abs-qword
\c      reloc-abs-word

\b \I{w-reloc-rel} \c{reloc-rel}: group alias for:

\c      reloc-rel-byte
\c      reloc-rel-dword
\c      reloc-rel-qword
\c      reloc-rel-word


\H{warning-legacy} Warning Class Aliases for Backward Compatiblity

These aliases are defined for compatibility with earlier
versions of NASM.

\b \I{w-bad-pragma} \c{bad-pragma}: malformed \c{%pragma}

\> Alias for \c{pragma-bad}.

\b \I{w-bnd} \c{bnd}: invalid \c{BND} prefix

\> Alias for \c{prefix-bnd}.

\b \I{w-environment} \c{environment}: nonexistent environment variable

\> Alias for \c{pp-environment}.

\b \I{w-hle} \c{hle}: invalid HLE prefix

\> Alias for \c{prefix-hle}.

\b \I{w-lock} \c{lock}: \c{LOCK} prefix on unlockable instruction

\> Alias for \c{prefix-lock-error}.

\b \I{w-macro-def-case-single} \c{macro-def-case-single}: single-line macro defined both case sensitive and insensitive

\> Alias for \c{pp-macro-def-case-single}.

\b \I{w-macro-def-greedy-single} \c{macro-def-greedy-single}: single-line macro

\> Alias for \c{pp-macro-def-greedy-single}.

\b \I{w-macro-def-param-single} \c{macro-def-param-single}: single-line macro defined with and without parameters

\> Alias for \c{pp-macro-def-param-single}.

\b \I{w-macro-defaults} \c{macro-defaults}: macros with more default than optional parameters

\> Alias for \c{pp-macro-defaults}.

\b \I{w-macro-params-legacy} \c{macro-params-legacy}: improperly calling multi-line macro for legacy support

\> Alias for \c{pp-macro-params-legacy}.

\b \I{w-macro-params-multi} \c{macro-params-multi}: multi-line macro calls with wrong parameter count

\> Alias for \c{pp-macro-params-multi}.

\b \I{w-macro-params-single} \c{macro-params-single}: single-line macro calls with wrong parameter count

\> Alias for \c{pp-macro-params-single}.

\b \I{w-negative-rep} \c{negative-rep}: regative \c{%rep} count

\> Alias for \c{pp-rep-negative}.

\b \I{w-not-my-pragma} \c{not-my-pragma}: \c{%pragma} not applicable to this compilation

\> Alias for \c{pragma-na}.

\b \I{w-orphan-labels} \c{orphan-labels}: labels alone on lines without trailing \c{:}

\> Alias for \c{label-orphan}.

\b \I{w-unknown-pragma} \c{unknown-pragma}: unknown \c{%pragma} facility or directive

\> Alias for \c{pragma-unknown}.