usr.bin/c89/c89.1

   1 .\"
   2 .\" Copyright (c) 1997 Joerg Wunsch
   3 .\"
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
  16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18 .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
  19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\" "
  28 .Dd September 17, 1997
  29 .Os
  30 .Dt C89 1
  31 .Sh NAME
  32 .Nm c89
  33 .Nd Posix.2 C language compiler
  34 .Sh SYNOPSIS
  35 .Nm c89
  36 .Op Fl c
  37 .Op Fl D Ar name Ns Op Ar =value
  38 .Op ...
  39 .Op Fl E
  40 .Op Fl g
  41 .Op Fl I Ar directory ...
  42 .Op Fl L Ar directory ...
  43 .Op Fl o Ar outfile
  44 .Op Fl O
  45 .Op Fl s
  46 .Op Fl U Ar name ...
  47 .Ar operand ...
  48 .Sh DESCRIPTION
  49 This is the name of the C language compiler as required by the
  50 .St -p1003.2
  51 standard.
  52 .Pp
  53 The
  54 .Nm
  55 compiler accepts the following options:
  56 .Bl -tag -width indent
  57 .It Fl c
  58 Suppress the link-edit phase of the compilation, and do not remove any
  59 object files that are produced.
  60 .It Fl D Ar name Ns Op Ar =value
  61 Define name as if by a C-language
  62 .Ql #define
  63 directive.  If
  64 no
  65 .Ar =value
  66 is given, a value of 1 will be used.  The
  67 .Fl D
  68 option has lower precedence than the
  69 .Fl U
  70 option.  That is, if
  71 .Ar name
  72 is used in both a
  73 .Fl U
  74 and a
  75 .Fl D
  76 option,
  77 .Ar name
  78 will be undefined regardless of the order of the options.  The
  79 .Fl D
  80 option may be specified more than once.
  81 .It Fl E
  82 Copy C-language source files to the standard output, expanding all
  83 preprocessor directives; no compilation will be performed.
  84 .It Fl g
  85 Produce symbolic information in the object or executable files.
  86 .It Fl I Ar directory
  87 Change the algorithm for searching for headers whose names are not
  88 absolute pathnames to look in the directory named by the
  89 .Ar directory
  90 pathname before looking in the usual places.  Thus, headers whose
  91 names are enclosed in double-quotes (\&"\&") will be searched for first
  92 in the directory of the file with the
  93 .Ql #include
  94 line, then in
  95 directories named in
  96 .Fl I
  97 options, and last in the usual places.  For
  98 headers whose names are enclosed in angle brackets (<>), the header
  99 will be searched for only in directories named in
 100 .Fl I
 101 options and then in the usual places.  Directories named in
 102 .Fl I
 103 options shall be searched in the order specified.  The
 104 .Fl I
 105 option may be specified more than once.
 106 .It Fl L Ar directory
 107 Change the algorithm of searching for the libraries named in the
 108 .Fl l
 109 objects to look in the directory named by the
 110 .Ar directory
 111 pathname before looking in the usual places.  Directories named in
 112 .Fl L
 113 options will be searched in the order specified.  The
 114 .Fl L
 115 option may be specified more than once.
 116 .It Fl o Ar outfile
 117 Use the pathname
 118 .Ar outfile ,
 119 instead of the default
 120 .Pa a.out ,
 121 for the executable file produced.
 122 .It Fl O
 123 Optimize the compilation.
 124 .It Fl s
 125 Produce object and/or executable files from which symbolic and other
 126 information not required for proper execution has been removed
 127 (stripped).
 128 .It Fl U Ar name
 129 Remove any initial definition of
 130 .Ar name .
 131 The
 132 .Fl U
 133 option may be specified more than once.
 134 .El
 135 .Pp
 136 An operand is either in the form of a pathname or the form
 137 .Fl l
 138 library.  At least one operand of the pathname form needs to be
 139 specified.  Supported operands are of the form:
 140 .Bl -tag -offset indent -width "-l library"
 141 .It Pa file Ns \&.c
 142 A C-language source file to be compiled and optionally linked.  The
 143 operand must be of this form if the
 144 .Fl c
 145 option is used.
 146 .It Pa file Ns \&.a
 147 A library of object files, as produced by
 148 .Xr ar 1 ,
 149 passed directly to the link editor.
 150 .It Pa file Ns \&.o
 151 An object file produced by
 152 .Nm
 153 .Fl c ,
 154 and passed directly to the link editor.
 155 .It Fl l Pa library
 156 Search the library named
 157 .Dl lib Ns Em library Ns \&.a
 158 A library will be searched when its name is encountered, so the
 159 placement of a
 160 .Fl l
 161 operand is significant.
 162 .El
 163 .Sh SEE ALSO
 164 .Xr ar 1 ,
 165 .Xr cc 1
 166 .Sh STANDARDS
 167 The
 168 .Nm
 169 command is believed to comply with
 170 .St -p1003.2 .