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.