NAME

       xc - portable IRAF compile/link utility

SYNOPSIS

       xc [flags] files...

DESCRIPTION

       XC  is  a  machine independent utility for compiling and linking IRAF tasks or files.  The XC utility may
       also be used to compile and/or link non-IRAF files and tasks. It can be used to generate fortran from xpp
       or ratfor code, to compile any number of files, and then link them if desired.  XC accepts and maps  IRAF
       virtual  filenames,  but  since it is a standalone bootstrap utility the environment is not passed, hence
       logical directories cannot be used.

       It is suggested that everyone stick with the iraf virtual file name extensions.  These are : .x, .r,  .f,
       .c, .s, .o, .a, .e. The meaning of these is:

            .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.

FLAGS

       -c     Tells xc not to link, i.e., not to create an executable.

       -d     Causes debug messages to be printed during execution.

       -F, -f Do not delete the Fortran translation of an SPP source file.

       -g     Generates debugging information .

       -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.

       -H     Link a host program as with "-h", but include the VOS libraries.

       -A     Force architecture specific include files.

       -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.

       -/flag, -//foo
              Pass flag to host compiler without  further  interpretation.  "-/flag"  becomes  "-foo",  "-//foo"
              becomes "foo".

       -Ddefine
              Pass a -Ddefine flag on to the host compiler.

       -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).

       -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.

       -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.

       -Nh [filename]
              This tells xpp that the foreign definitions in the file specified should be used in preference  to
              standard include files.

       -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.

       -O     Optimize  object  code  produced;  this  is now the default, but this switch is still provided for
              backwards compatibility.

       -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.

       -q     Disable optimization.  Opposite of -O.  Object code will be optimized by default.

       -s     Strips all symbols and debugging information.

       -S     Same as -s for VMS.

       -v     Verbose  mode.   Causes  messages  to  be  printed during execution telling what the xc program is
              doing.

       -w     Suppress warnings.

       -z     Create a non-shareable image (default).

       V      Print XC version identification.

SEE ALSO

       mkpkg(1), generic(1).

AUTHOR

       This manual page was taken from the xc.hlp file in the IRAF sources.

IRAF 2.17                                           June 2021                                              XC(1)