NAME

       ncargcc - Command for compiling C code that uses the NCAR Graphics low-level utilities

SYNOPSIS

       ncargcc  [-ngmath]  [-smooth] [-quick] [-super] [-agupwrtx] [-ncarbd] ...  [-ngmathbd] ...
       [-noX11] ...

DESCRIPTION

       ncargcc is a script that invokes the C compiler/linker with the proper NCAR  Graphics  LLU
       (low-level  utility)  libraries.   Arguments  presented  above  are  associated  with NCAR
       Graphics.  All other arguments and options  are  identical  to  the  cc  command  on  your
       particular  machine;  arguments  that  include  quoted  strings may have to be enclosed in
       single quotes.

       NOTE: ncargcc cannot be used to compile NCAR Graphics C programs that call the HLUs (high-
       level  utilities).   You  must  use  nhlcc  instead.   See  the  nhlcc  man  page for more
       information.

       If you don't want to use ncargcc, you can just type it on the command  line  to  see  what
       gets included in the link line, and then you can add this information to your own Makefile
       or script.  It is important to note that you must define the macro NeedFuncProto in  order
       for function prototyping to work correctly.

       In  order  to  run  ncargcc, you must have your NCARG_ROOT environment variable set to the
       directory pathname where the NCAR Graphics libraries, binaries,  and  include  files  were
       installed.   If  you are not sure what NCARG_ROOT should be set to, please check with your
       system administrator or the site representative for NCAR Graphics.  If the  NCAR  Graphics
       libraries,  binaries,  and include files were not installed under one root directory, then
       you will need to set the environment variables  NCARG_LIB,  NCARG_BIN,  and  NCARG_INCLUDE
       instead.  Please see "man ncargintro" for more information.

       When  ncargcc  is  invoked  with  the  -ictrans option the resulting executable will, upon
       invocation, send its metafile output to the translator ictrans. The  environment  variable
       GRAPHCAP  must  be  set  to  a  valid  graphics  output  device whenever the executable is
       executed.

       By default, ncargcc will load the X11 library when linking your C  program.   If  you  try
       running  ncargcc  and the compiler complains that it cannot find the library for X11, then
       try running ncargcc -L/xxx/yyy/zzz program.c where /xxx/yyy/zzz is  the  path  leading  to
       your X11 library.  If you do not have the X11 library, or else you just don't want to link
       it in, you can use the -noX11 option.

       OPTIONS

       -ngmath
              Links in the NCAR Graphics ngmath library.

       -smooth
              Link in the "smooth" objects.

       -quick Link in the "quick" objects.

       -super Link in the "super" objects.

       -agupwrtx
              Link in the "agupwrtx" library.

       -ncarbd
              Use this option for  compilers  that  appear  to  be  having  trouble  initializing
              blockdata  variables.  It  will cause a small subroutine to be linked in that helps
              force the loading of blockdata initialization routines.

       -ngmathbd
              Just like with the -ncarbd option, use this option for compilers that appear to  be
              having  trouble  initializing  Ngmath-related  blockdata variables. It will cause a
              small subroutine to be linked in that helps force the loading of  Ngmath  blockdata
              initialization routines.

              Note:  this  option  doesn't  need  to  be  specified separately if you are already
              including the -ncarbd  and -ngmath options.

       -noX11 Do not link in the X library when linking the code.

              By default, ncargf77 will load the X11 library when linking your  Fortran  program.
              This is because the GKS library now has an X11 driver.  If you try running ncargf77
              and the compiler complains that it cannot  find  the  library  for  X11,  then  try
              running ncargf77 -L/xxx/yyy/zzz program.f where /xxx/yyy/zzz is the path leading to
              your X11 library.  If you do not have the X11 library, or else you just don't  want
              it to be loaded, you can use the -noX11 option.

SEE ALSO

       Online:   ictrans(1NCARG), gcaps(1NCARG), ncargf77(1NCARG), nhlcc(1NCARG), nhlf77(1NCARG),
       ncargintro(5NCARG)

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2002
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.