NCARGCC(1NCARG)

💖 NCARGCC 💖

okay so bestie, welcome to NCARGCC(1NCARG) — that's the page number and the manual it lives in (NCAR GRAPHICS, in case you were wondering) — and we're about to make compiling C code for the NCAR Graphics low-level utilities feel like a lil hangout 🫶

🌸 NAME 🌸

ncargcc — the 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, bestie — it calls up the C compiler/linker with all the right NCAR Graphics LLU (that's low-level utility) libraries already in the mix. Every argument up in the synopsis is an NCAR Graphics thing. Everything else you pass works exactly like the cc command on your specific machine, fr fr. Oh and heads up: arguments with quoted strings in them might need to be wrapped in single quotes 💅

NOTE: ncargcc cannot compile NCAR Graphics C programs that call the HLUs (high-level utilities). You have to use nhlcc instead. Go read the nhlcc man page for the tea 🍓

If you don't feel like using ncargcc, that's valid — you can just type it on the command line to peek at what gets included in the link line, then copy that info into your own Makefile or script. Main character DIY energy 👑 But real talk: you must define the macro NeedFuncProto for function prototyping to work correctly. no cap.

Also, to actually run ncargcc, your NCARG_ROOT environment variable has to be set to the directory pathname where the NCAR Graphics libraries, binaries, and include files were installed. Not sure what NCARG_ROOT should be? Ask your system administrator or the site representative for NCAR Graphics — they got you 💜 If the NCAR Graphics libraries, binaries, and include files were not installed under one root directory, then instead you'll need to set the environment variables NCARG_LIB, NCARG_BIN, and NCARG_INCLUDE. Please see man ncargintro for more info ✨

When ncargcc is invoked with the -ictrans option, the resulting executable will, upon invocation, send its metafile output to the translator ictrans. And whenever that executable is executed, the environment variable GRAPHCAP must be set to a valid graphics output device. so like, don't forget that 🙈

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 don't have the X11 library, or 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 one for compilers that appear to be having trouble initializing blockdata variables. It causes 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 for compilers that appear to be having trouble initializing Ngmath-related blockdata variables. It causes 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. so like, save yourself the keystrokes bestie 😌
• -noX11 — do not link in the X library when linking the code 🚫

okay so the page literally says this next part about ncargf77 and Fortran programs, and I'm quoting it exactly, don't come for me 💀

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.

and that's the whole page, bestie 🥳 this was NCAR's February 1993 edition of NCARGCC(1NCARG) — go compile something iconic, ily, bye 💖✨🦋