NAME

       gpasm - GNU PIC assembler

SYNOPSIS

       gpasm [options] file

WARNING

       The  information in this man page is an extract from the full documentation of gputils and
       is limited to the meaning of the options.  For complete and current  documentation,  refer
       to "gputils.ps" located in the gputils docs directory.

DESCRIPTION

       gpasm  is an assembler for Microchip (TM) PIC (TM) micro-controllers.  It's intended to be
       compatible with the manufacturer's MPASM assembler.  gpasm is part of gputils.  Check  the
       gputils(1) manpage for details on other GNU PIC utilities.

OPTIONS

       Below  is  a summary of the gpasm options.  gpasm options always supersede any settings in
       the source code.

       -a FMT, --hex-format FMT
              GPASM supports inhx8m, inhx8s, inhx16, and inhx32 hex file  formats.   This  option
              controls which hex file format is used.  The default is inhx32.

       -c, --object
              Output a relocatable object (new COFF format).

       -C, --old-coff
              Output a relocatable object (old COFF format).

       -d, --debug
              Output debug messages.

       -D SYM=VAL, --define SYM=VAL
              Define  SYM  with value VAL. This is equivalent to placing "#define SYM VAL" in the
              source.

       -e [ON|OFF], --expand [ON|OFF]
              Macro expansion in the listing file is controlled using  the  EXPAND  and  NOEXPAND
              directives.   This  option  can force either directive to be ignored.  When "ON" is
              selected the macros are always expanded regardless of  the  presence  of  NOEXPAND.
              Likewise, "OFF" will force macros not to be expanded.

       -g, --debug-info
              Use debug directives for COFF.

       -h, --help
              Show the usage message and exit.

       -i, --ignore-case
              All  user  defined  symbols  and macros are case sensitive.  This option makes them
              case insensitive.

       -I DIR, --include DIR
              The top level assembly file is passed to gpasm  as  an  argument.   This  file  can
              contain  INCLUDE directives.  These directives open the specified file and then its
              contents are assembled.  GPASM searches for these files in the local directory.  If
              the  file  is  not located, the default header path is checked.  Finally, all paths
              specified using this argument are searched.

       -l[12[ce]|14[ce]|16[ce]], --list-chips[=([12[ce]|14[ce]|16[ce]])]
              List supported processors based on various aspects.

       -L, --force-list
              Ignore NOLIST directives.  This forces gpasm to print every line assembled  in  the
              list file output.

       -m, --dump
              Upon  completion of the final pass of assembly, display the contents of instruction
              memory.

       --mpasm-compatible
              This option sets the MPASM compatibility mode.

       -M, --deps
              Output a dependency file.

       -n, --dos
              By default, gpasm generates hex files  using  ISO  format.   However,  some  device
              programmers  required  a  DOS  formatted  file.   This  option  will cause gpasm to
              generate a DOS formatted hex file.

       -o FILE, --output FILE
              Alternate name of the output file.

       -p PROC, --processor PROC
              Select the processor.

       -P FILE, --preprocess FILE
              Write preprocessed asm file to FILE.

       -q, --quiet
              Suppress anything sent to standard output.

       -r RADIX, --radix RADIX
              The supported radices are BIN, DEC, OCT, and HEX.  The default is HEX.

       -u, --absolute
              Use absolute paths.

       -v, --version
              Show the version information and exit.

       -w [0|1|2], --warning [0|1|2]
              This option sets the message  level.  "0"  is  the  default.   It  will  allow  all
              messages,  warnings,  and  errors  to be reported.  "1" will suppress the messages.
              "2" will suppress the messages and warnings.

       -y, --extended
              Enable 18xx extended mode.

SEE ALSO

       gputils(1)

AUTHOR

       Craig Franklin <craigfranklin@users.sourceforge.net>

COPYRIGHT

       Copyright (C) 2002, 2003, 2004, 2005 James Bowman, Craig Franklin

       This program is free software; you can redistribute it and/or modify it under the terms of
       the  GNU  General  Public  License  as  published  by the Free Software Foundation; either
       version 2 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY  WARRANTY;
       without  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program;
       if  not,  write  to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
       USA.