invocation_ar.hss 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. [Main]
  2. Title=ar-tigcc Command-Line Options
  3. [Top]
  4. The <CODE>ar-tigcc</CODE> tool can be used to create archives recognized by
  5. <CODE>ld-tigcc</CODE>. The output format is the format used by
  6. <A HREF="http://www.gnu.org/">GNU</A> <CODE>ar</CODE>, for which this tool is
  7. a replacement. This allows for maximum compatibility between archives and
  8. programs created with different versions of TIGCC.
  9. <BR><BR>
  10. In <CODE>ar-tigcc</CODE>, options and input files may appear in any order in
  11. the command line. Input files can have any file format; they are simply
  12. written into the archive in the order specified in the command line. However,
  13. object files whose format is recognized are searched for exported symbols, so
  14. that <CODE>ar-tigcc</CODE> can create a symbol table for the archive.
  15. <BR><BR>
  16. If no output file name is specified, <CODE>ar-tigcc</CODE> uses the name of
  17. the first input file and appends a <CODE>'.a'</CODE> extension to it. It is
  18. highly recommended that you specify a different name with the
  19. <CODE>'--output'</CODE> option.
  20. <BR><BR>
  21. <CODE>ar-tigcc</CODE> recognizes the following options:
  22. <DL>
  23. <DT><B>-h</B>
  24. <BR><B>--help</B>
  25. <DD>Print a short description of all available options.
  26. <BR><BR>
  27. <DT><B>--version</B>
  28. <DD>Print the version number of the tool and a short copyright notice.
  29. <BR><BR>
  30. <DT><B>--dump</B>
  31. <DD>Display a small dump of the archive file contents. This includes the
  32. members as well as the symbols they export.
  33. <BR><BR>
  34. <DT><B>-o <I>file</I></B>
  35. <BR><B>--output <I>file</I></B>
  36. <BR><B>-rc <I>file</I></B>
  37. <BR><B>-qc <I>file</I></B>
  38. <DD>Write the output to the file named <I>file</I>. Unlike
  39. <CODE>ld-tigcc</CODE>, <CODE>ar-tigcc</CODE> does not append a file extension
  40. to <I>file</I>. <B>'-rc'</B> and <B>'-qc'</B> are recognized for
  41. compatibility with GNU <CODE>ar</CODE>, so that certain command lines work
  42. with GNU <CODE>ar</CODE> as well as <CODE>ar-tigcc</CODE>.
  43. <BR><BR>
  44. <DT><B>--no-names</B>
  45. <DD>Omit the file names of the input files in the archive. The archive will
  46. only contain names of the form <CODE>fl<I>n</I>.o</CODE>, where <I>n</I> is
  47. the index of the file starting at 1. Omitting file names may be a good idea,
  48. especially if you use long file names, since the traditional archive format
  49. imposes a maximum of 15 characters on the length of file names. Otherwise, if
  50. a file name exceeds this maximum, it will be cut off at the 16th character.
  51. The IDE and the <CODE>tigcc</CODE> command line compiler always use this
  52. option.
  53. </DL>