html/man_getlinkinfo.1.html

   1 <!-- manual page source format generated by PolyglotMan v3.0.7, -->
   2 <!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
   3
   4 <HTML>
   5 <HEAD>
   6 <TITLE>Man page for getlinkinfo.1</TITLE>
   7 </HEAD>
   8 <BODY bgcolor=white>
   9 <A HREF="#toc">Table of Contents</A><P>
  10
  11 <H2><A NAME="sect0" HREF="#toc0">Name</A></H2>
  12
  13 <P>
  14 getlinkinfo - get external linkage information
  15
  16 <H2><A NAME="sect1" HREF="#toc1"><B>Synopsis</B></A></H2>
  17
  18 <P>
  19 <B>getlinkinfo</B> <I>configfile</I> <I>infile</I> <I>outfile</I> { <I>infile</I> <I>outfile</I> }*
  20
  21 <H2><A NAME="sect2" HREF="#toc2"><B>Description</B></A></H2>
  22
  23 <P>
  24 The <I>getlinkinfo</I> program uses <I>configfile</I> to determine which
  25 symbols in the fileset formed by all the <I>infile</I> files are
  26 referenced externally to the fileset and marks this information
  27 in annotations. The annotations keep track of what
  28 files are in the fileset at the time because this information
  29 is only valid later for the same fileset without
  30 omissions. This information is used by the libuseful
  31 function unreferenced_outside_fileset(), which automatically
  32 figures out when the information is valid. Note
  33 that as in any other case when multiple files are read in
  34 as one fileset, <I>linksuif</I> must be run on all the inputs
  35 before this pass is run if there is more than a single
  36 input SUIF file.
  37 <P>
  38 It is up to the user of this program to insure that <I>con</I><B>_</B>f<I>igfile</I>
  39 is correct for a given fileset (i.e. that <I>config</I><B>_</B>f<I>ile</I>
  40 contains information for everything else to be linked
  41 in to create the final executable program).
  42 <P>
  43 The format of <I>configfile</I> is currently a text file with the
  44 following format:
  45 <P>
  46 externrefs { <I>symname</I> <I>*</I> }
  47 <P>
  48 where each <I>symname</I> is the name of a symbol which is referenced
  49 externally.
  50
  51 <H2><A NAME="sect3" HREF="#toc3"><B>See</B> <B>Also</B></A></H2>
  52
  53 <P>
  54 <A HREF="man_linksuif.1.html">linksuif(1)</A>
  55
  56
  57 <H2><A NAME="sect4" HREF="#toc4"><B>History</B></A></H2>
  58
  59 <P>
  60 This program was written by Chris Wilson.
  61 <P>
  62
  63 <HR><P>
  64 <A NAME="toc"><B>Table of Contents</B></A><P>
  65 <UL>
  66 <LI><A NAME="toc0" HREF="#sect0">Name</A></LI>
  67 <LI><A NAME="toc1" HREF="#sect1">Synopsis</A></LI>
  68 <LI><A NAME="toc2" HREF="#sect2">Description</A></LI>
  69 <LI><A NAME="toc3" HREF="#sect3">See Also</A></LI>
  70 <LI><A NAME="toc4" HREF="#sect4">History</A></LI>
  71 </UL>
  72 </BODY></HTML>