XC(1)

🎀 XC — the IRAF compile/link bestie (man page, section 1) 🎀

okay so like. XC(1), IRAF commands, section 1. she's a portable IRAF compile/link utility and she's literally the moment. 💅

---

✨ NAME ✨

xc — portable IRAF compile/link utility. that's her. that's the whole vibe. 🦋

---

✨ SYNOPSIS ✨

xc [flags] files...

---

✨ DESCRIPTION ✨

so XC is a machine independent utility for compiling and linking IRAF tasks or files. bestie she is versatile. she can also compile and/or link non-IRAF files and tasks, no gatekeeping. 🫶

she can generate fortran from xpp or ratfor code, compile any number of files, and then link them if you want. XC accepts and maps IRAF virtual filenames, but — and this is the part where you gotta listen — since she's a standalone bootstrap utility, the environment is not passed, so logical directories cannot be used. no cap. 💀

It is suggested that everyone stick with the iraf virtual file name extensions. like, everybody. peer pressure but make it helpful. those extensions are: .x, .r, .f, .c, .s, .o, .a, .e. and here's what they mean, in order, iconic to iconic:

• .x — SPP code
• .r — Ratfor code
• .f — Fortran code
• .c — C code
• .s — Macro assembler code
• .o — Object module
• .a — Library file
• .e — Executable Image

XC is available both in the CL and as a standalone task. usage is equivalent in either case, so pick your fighter, she doesn't care. 🌈

---

✨ FLAGS ✨

• -c — tells xc not to link, aka not to create an executable. we're just vibing with the compiling, no final product. 🙈
• -d — causes debug messages to be printed during execution. she's oversharing, let her. 🔥
• -F, -f — do not delete the Fortran translation of an SPP source file. keep the receipts bestie.
• -h — causes the executable to be linked as a host program, i.e., without the IRAF main and without searching the IRAF libraries, unless explicitly referenced on the command line. used to compile and link host (e.g., Fortran) programs which may or may not reference the IRAF libraries. she's going independent. 👑
• -H — link a host program as with -h, but include the VOS libraries. same energy, extra libraries, slay. ⭐
• -A — force architecture specific include files. assertive. we love her.
• -C — link a host program which has a C main. we may need to tweak the command line as a special case here since we normally assume Fortran sources. it's giving special treatment and honestly she earned it. 💖
• -/flag, -//foo — pass flag to host compiler without further interpretation. -/flag becomes -foo, -//foo becomes foo. relay that message verbatim, no editing, no notes. 🎀
• -Ddefine — pass a -Ddefine flag on to the host compiler. simple. clean. delivered. ✨
• -Idir — pass a -Idir flag on to the host compiler. a special case is -Inolibc which disables automatic inclusion of the IRAF LIBC includes (hlib$libc). that's the exception bestie, write it down. 🌸
• -llib, -Ldir — this tells the linker which library files or library directories besides the standard ones to include. these must be either on the current directory, or in an IRAF system library (lib$ or hlib$). the library specification must be immediately after the option as in -lxtools. No other option may follow the 'l' option in the same argument as in -lxtoolsO. like ma'am, do not do that. 😭
• -N — generates the output temp file in /tmp during the link, then moves it to the output directory in one operation when done. for cases such as linking in an NFS-mounted directory, where all the NFS i/o may slow the link down excessively. she's avoiding the lag fr fr. 💜
• -Nh [filename] — this tells xpp that the foreign definitions in the file specified should be used in preference to standard include files. main character definitions only. 👑
• -o — this flag redirects the output of the compile if used in conjunction with -c option, or specifies where the executable or object is to be placed. if not given the first file name is used to obtain the name for the executable or object. so basically, name your baby or she'll name it for you. 🍼
• -O — optimize object code produced; this is now the default, but this switch is still provided for backwards compatibility. she's always been optimizing, the flag is just nostalgia at this point. 🧚
• -p pkgname — load the package environment for the named external package, e.g., xc -c -p noao file.x. if the same package is always specified the environment variable or logical name PKGENV may be defined at the host level to accomplish the same thing. the package name must be specified when doing software development in an external or layered package. mandatory bestie, not optional. 🫶
• -q — disable optimization. opposite of -O. object code will be optimized by default. so like, -q is the "no thoughts head empty" button. 💀
• -w — suppress warnings. forwarded to the compiler and linker. we're ignoring the haters and also the diagnostics. 🙈
• -x — compile and link for debugging. detective mode activated. 🔍
• -z, -e, -t, -T, -s — ignored. provided for backward compatibility. they're just here for the nostalgia, they do nothing, iconic behavior honestly. 💅
• -V — print XC version identification. she'll tell you who she is. ⭐

---

✨ SEE ALSO ✨

mkpkg(1), generic(1). go read those next bestie, they're in the group chat too. 🌈

---

✨ AUTHOR ✨

this manual page was taken from the xc.hlp file in the IRAF sources. credit where credit is due. 💖

---

okay that's the whole page!! this one shipped as IRAF 2.17, dated June 2021, and yes the girlies were thriving that summer. go compile something and text me when it works. bye bestie, slay, periodt 🎀💅✨