1NCARGCC(1NCARG)                  NCAR GRAPHICS                 NCARGCC(1NCARG)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

14       ncargcc  is a script that invokes the C compiler/linker with the proper
15       NCAR Graphics LLU (low-level utility) libraries.   Arguments  presented
16       above  are  associated  with  NCAR  Graphics.   All other arguments and
17       options are identical to the cc command  on  your  particular  machine;
18       arguments that include quoted strings may have to be enclosed in single
19       quotes.
20
21       NOTE: ncargcc cannot be used to compile NCAR Graphics C  programs  that
22       call the HLUs (high-level utilities).  You must use nhlcc instead.  See
23       the nhlcc man page for more information.
24
25       If you don't want to use ncargcc, you can just type it on  the  command
26       line  to  see what gets included in the link line, and then you can add
27       this information to your own Makefile or script.  It  is  important  to
28       note that you must define the macro NeedFuncProto in order for function
29       prototyping to work correctly.
30
31       In order to run ncargcc, you  must  have  your  NCARG_ROOT  environment
32       variable  set  to  the  directory  pathname  where  the  NCAR  Graphics
33       libraries, binaries, and include files were installed.  If you are  not
34       sure  what  NCARG_ROOT  should be set to, please check with your system
35       administrator or the site representative for  NCAR  Graphics.   If  the
36       NCAR Graphics libraries, binaries, and include files were not installed
37       under one root directory, then you will need  to  set  the  environment
38       variables  NCARG_LIB, NCARG_BIN, and NCARG_INCLUDE instead.  Please see
39       "man ncargintro" for more information.
40
41       When ncargcc is invoked with the -ictrans  option  the  resulting  exe‐
42       cutable will, upon invocation, send its metafile output to the transla‐
43       tor ictrans. The environment variable GRAPHCAP must be set to  a  valid
44       graphics output device whenever the executable is executed.
45
46       By  default, ncargcc will load the X11 library when linking your C pro‐
47       gram.  If you try running ncargcc and the compiler  complains  that  it
48       cannot   find   the   library   for   X11,  then  try  running  ncargcc
49       -L/xxx/yyy/zzz program.c where /xxx/yyy/zzz is the path leading to your
50       X11  library.   If  you  do  not have the X11 library, or else you just
51       don't want to link it in, you can use the -noX11 option.
52
53       OPTIONS
54
55       -ngmath
56              Links in the NCAR Graphics ngmath library.
57
58
59       -smooth
60              Link in the "smooth" objects.
61
62
63       -quick Link in the "quick" objects.
64
65
66       -super Link in the "super" objects.
67
68
69       -agupwrtx
70              Link in the "agupwrtx" library.
71
72
73       -ncarbd
74              Use this option for compilers that appear to be  having  trouble
75              initializing  blockdata variables. It will cause a small subrou‐
76              tine to be linked in that helps force the loading  of  blockdata
77              initialization routines.
78
79
80       -ngmathbd
81              Just like with the -ncarbd option, use this option for compilers
82              that appear to be  having  trouble  initializing  Ngmath-related
83              blockdata  variables.  It  will  cause  a small subroutine to be
84              linked in that helps force the loading of Ngmath blockdata  ini‐
85              tialization routines.
86
87              Note: this option doesn't need to be specified separately if you
88              are already including the -ncarbd  and -ngmath options.
89
90
91       -noX11 Do not link in the X library when linking the code.
92
93              By default, ncargf77 will load the X11 library when linking your
94              Fortran program.  This is because the GKS library now has an X11
95              driver.  If you try running ncargf77 and the compiler  complains
96              that  it  cannot  find  the  library  for  X11, then try running
97              ncargf77 -L/xxx/yyy/zzz program.f where /xxx/yyy/zzz is the path
98              leading  to  your  X11  library.   If  you  do  not have the X11
99              library, or else you just don't want it to be  loaded,  you  can
100              use the -noX11 option.
101
102

SEE ALSO

104       Online:         ictrans(1NCARG),    gcaps(1NCARG),    ncargf77(1NCARG),
105       nhlcc(1NCARG), nhlf77(1NCARG), ncargintro(5NCARG)
106
107       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
108

110       Copyright (C) 1987-2002
111       University Corporation for Atmospheric Research
112       The use of this Software is governed by a License Agreement.
113
114
115
116NCAR                             February 1993                 NCARGCC(1NCARG)
Impressum