fcc.1 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148
  1. .TH FCC 1
  2. .SH NAME
  3. fcc \- fast CC-compatible C compiler
  4. .SH SYNOPSIS
  5. .B fcc
  6. [
  7. .B \-c
  8. ]
  9. [
  10. .B \-v
  11. ]
  12. [
  13. .B \-vn
  14. ]
  15. [ \fB\-D\fIname\fR ]
  16. [ \fB\-D\fIname\fB=\fIdef\fR ]
  17. [
  18. .BI \-I pathname
  19. ]
  20. [
  21. .B \-w
  22. ]
  23. [
  24. .B \-o
  25. .I outfile
  26. ]
  27. [
  28. .B \-R
  29. ]
  30. [
  31. .BI \-U name
  32. ]
  33. [
  34. .BI -M compiler
  35. ]
  36. .I sourcefile ...
  37. .SH DESCRIPTION
  38. .LP
  39. .I Fcc
  40. is a fast
  41. .B C
  42. compiler. It translates
  43. .B C
  44. programs
  45. into cc(1)-compatible relocatable object modules, and does so in one pass.
  46. Then, if the \fB\-c\fP flag is not given,
  47. .I fcc
  48. offers the object modules to a link-editor,
  49. to create an executable binary.
  50. .LP
  51. .I Fcc
  52. accepts several types of filename arguments. Files with
  53. names ending in
  54. .B .c
  55. are taken to be
  56. .B C
  57. source programs.
  58. They are compiled, and the resulting object module is placed in the current
  59. directory.
  60. The object module is named after its source file, the suffix
  61. .B .o
  62. replacing
  63. .BR .c
  64. in the name of the object.
  65. .LP
  66. Other arguments refer to loader options,
  67. object modules, or object libraries.
  68. Unless the
  69. .B \-c
  70. flag is given, these modules and libraries, together with the results of any
  71. specified compilations, are passed (in the order given) to the
  72. link-editor to produce
  73. an output file named
  74. .IR a.out .
  75. You can specify a name for the executable by using the
  76. .B \-o
  77. option.
  78. .SH OPTIONS
  79. .LP
  80. The \fB\-l\fIlib\fR, \fB\-n\fP, \fB\-N\fP,
  81. \fB\-r\fP, \fB\-s\fP, \fB\-S\fP, and \fB\-u\fP options are
  82. passed to the link-editor program.
  83. The \fB\-u\fP option takes an extra argument.
  84. .IP \fB\-c\fP
  85. .br
  86. Suppress the loading phase of the compilation, and force an object module to
  87. be produced, even if only one program is compiled.
  88. A single object module can be named explicitly using the
  89. .B \-o
  90. option.
  91. .IP \fB\-D\fIname\fR\fB=\fIdef\fR
  92. Define a symbol
  93. .I name
  94. to the
  95. preprocessor, as if by "#define".
  96. .IP \fB\-D\fIname\fR
  97. .br
  98. same as \fB\-D\fIname\fB=1\fR.
  99. .IP \fB\-I\fIpathname\fR
  100. .br
  101. Add
  102. .I pathname
  103. to the list of directories in which to search for
  104. .B #include
  105. files with filenames not beginning with slash.
  106. The compiler first searches for
  107. .B #include
  108. files in the directory containing
  109. .I sourcefile,
  110. then in directories in
  111. .B \-I
  112. options, and finally, in
  113. .I /usr/include.
  114. .IP "\fB\-o \fIoutput\fR"
  115. Name the final output file
  116. .I output.
  117. .IP \fB\-U\fIname\fR
  118. .br
  119. Remove any initial definition of
  120. .I name.
  121. .IP \fB\-v\fP
  122. .br
  123. Verbose. Print the commands as they are executed.
  124. .IP \fB\-vn\fP
  125. .br
  126. Verbose, no execute. Only print the commands, do not execute them.
  127. .IP \fB\-w\fP
  128. suppress warning messages.
  129. .IP \fB\-R\fP
  130. .br
  131. test for more compatibility with Kernighan & Ritchie C [1].
  132. .IP \fB\-M\fIcompiler\fR
  133. .br
  134. use \fIcompiler\fR as C-2 compiler instead of the default.
  135. .LP
  136. Object modules produced by cc(1) and
  137. .I fcc
  138. can be freely mixed, as long as the link-editor is called through
  139. .I fcc.
  140. .SH "SEE ALSO"
  141. .IP [1]
  142. B.W. Kernighan, D. Ritchie, "\fIThe C programming Language\fP", Prentice-Hall Inc., 1978
  143. .IP [2]
  144. E.H. Baalbergen, "\fIThe ACK CEM compiler\fP".
  145. .IP [3]
  146. cc(1) unix manual page.
  147. .SH DIAGNOSTICS
  148. Diagnostics are intended to be self-explanatory.