home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man1 / cc.1 < prev    next >
Encoding:
Text File  |  1975-06-26  |  3.0 KB  |  128 lines
  1. .th CC I 5/15/74
  2. .sh NAME
  3. cc \*- C compiler
  4. .sh SYNOPSIS
  5. .bd cc
  6. [
  7. .bd \*-c
  8. ] [
  9. .bd \*-p
  10. ] [
  11. .bd \-f
  12. ] [
  13. .bd \*-O
  14. ] [
  15. .bd \*-S
  16. ] [
  17. .bd \*-P
  18. ] file ...
  19. .sh DESCRIPTION
  20. .it Cc
  21. is the UNIX C compiler.
  22. It accepts three types of arguments:
  23. .s3
  24. Arguments whose names end with `.c' are taken to be
  25. C source programs; they are compiled, and
  26. each object program is left on the file
  27. whose name is that of the source with `.o' substituted
  28. for `.c'.
  29. The `.o' file is normally deleted, however, if a single
  30. C program is compiled and loaded all at one go.
  31. .s3
  32. The following flags are interpreted by
  33. .it cc.
  34. See
  35. .it "ld (I)"
  36. for load-time flags.
  37. .s3
  38. .lp +6 5
  39. \fB\*-c\fR    Suppress the loading phase of the compilation, and force
  40. an object file to be produced even if only one program is compiled.
  41. .s3
  42. .lp +6 5
  43. \fB\*-p\fR    Arrange for the compiler to produce code
  44. which counts the number of times each routine is called;
  45. also, if loading takes place, replace the standard startup
  46. routine by one which automatically calls the
  47. .it monitor
  48. subroutine (III)
  49. at the start and arranges to write out a
  50. .it mon.out
  51. file at normal termination of execution of the object program.
  52. An execution profile can then be generated by
  53. use of
  54. .it prof
  55. (I).
  56. .s3
  57. .lp +6 5
  58. \fB\-f\fR    In systems without hardware floating-point,
  59. use a version of the C compiler which handles floating-point
  60. constants and
  61. loads the object program with the floating-point interpreter.
  62. Do not use if the hardware is present.
  63. .s3
  64. .lp +6 5
  65. \fB\*-O\fR    Invoke an
  66. object-code optimizer.
  67. .s3
  68. .lp +6 5
  69. \fB\*-S\fR    Compile the named C programs, and leave the
  70. assembler-language output on corresponding files suffixed `.s'.
  71. .s3
  72. .lp +6 5
  73. \fB\*-P\fR    Run only the macro preprocessor
  74. on the named C programs, and leave the output on corresponding
  75. files suffixed `.i'.
  76. .i0
  77. .dt
  78. .s3
  79. Other arguments
  80. are taken
  81. to be either loader flag arguments, or C-compatible
  82. object programs, typically produced by an earlier
  83. .it cc
  84. run,
  85. or perhaps libraries of C-compatible routines.
  86. These programs, together with the results of any
  87. compilations specified, are loaded (in the order
  88. given) to produce an executable program with name
  89. .bd a.out.
  90. .sh FILES
  91. file.c        input file
  92. .br
  93. file.o        object file
  94. .br
  95. a.out        loaded output
  96. .br
  97. /tmp/ctm?    temporary
  98. .br
  99. /lib/c[01]    compiler
  100. .br
  101. /lib/fc[01]    floating-point compiler
  102. .br
  103. /lib/c2        optional optimizer
  104. .br
  105. /lib/crt0.o    runtime startoff
  106. .br
  107. /lib/mcrt0.o    runtime startoff of profiling
  108. .br
  109. /lib/fcrt0.o    runtime startoff for floating-point interpretation
  110. .br
  111. /lib/libc.a    C library; see section III.
  112. .br
  113. /lib/liba.a    Assembler library used by some routines in libc.a
  114. .sh "SEE ALSO"
  115. ``Programming in C\(em a tutorial,''
  116. C Reference Manual,
  117. monitor (III), prof (I), cdb (I), ld (I).
  118. .sh DIAGNOSTICS
  119. The diagnostics produced by C itself are intended to be
  120. self-explanatory.
  121. Occasional messages may be produced by the assembler
  122. or loader.
  123. Of these, the most mystifying are from the assembler,
  124. in particular ``m,'' which means
  125. a multiply-defined external symbol (function
  126. or data).
  127. .sh BUGS
  128.