usr.bin/c99/c99.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: src/usr.bin/c89/c89.1,v 1.4.2.4 2001/08/02 01:11:13 obrien Exp
  27 .\" $FreeBSD: src/usr.bin/c99/c99.1,v 1.3 2004/03/04 20:29:27 josef Exp $
  28 .\" $DragonFly: src/usr.bin/c99/c99.1,v 1.1 2004/07/23 16:32:58 hmp Exp $
  29 .\"
  30 .Dd October 7, 2002
  31 .Os
  32 .Dt C99 1
  33 .Sh NAME
  34 .Nm c99
  35 .Nd standard C language compiler
  36 .Sh SYNOPSIS
  37 .Nm
  38 .Op Fl cEgs
  39 .Op Fl D Ar name Ns Op = Ns Ar value
  40 .Ar ...
  41 .Op Fl I Ar directory ...
  42 .Op Fl L Ar directory ...
  43 .Op Fl o Ar outfile
  44 .Op Fl O Ar optlevel
  45 .Op Fl U Ar name ...
  46 .Ar operand ...
  47 .Sh DESCRIPTION
  48 This is the name of the C language compiler as required by the
  49 .St -p1003.1-2001
  50 standard.
  51 .Pp
  52 The
  53 .Nm
  54 compiler accepts the following options:
  55 .Bl -tag -width indent
  56 .It Fl c
  57 Suppress the link-edit phase of the compilation, and do not remove any
  58 object files that are produced.
  59 .It Fl D Ar name Ns Op = Ns Ar value
  60 Define name as if by a C-language
  61 .Ic #define
  62 directive.
  63 If no
  64 .Dq = Ns Ar value
  65 is given, a value of 1 will be used.
  66 Note that in order to request a
  67 translation as specified by
  68 .St -p1003.1-2001 ,
  69 you need to define
  70 .Dv _POSIX_C_SOURCE=200112L
  71 either in the source or using this option.
  72 The
  73 .Fl D
  74 option has lower precedence than the
  75 .Fl U
  76 option.
  77 That is, if
  78 .Ar name
  79 is used in both a
  80 .Fl U
  81 and a
  82 .Fl D
  83 option,
  84 .Ar name
  85 will be undefined regardless of the order of the options.
  86 The
  87 .Fl D
  88 option may be specified more than once.
  89 .It Fl E
  90 Copy C-language source files to the standard output, expanding all
  91 preprocessor directives; no compilation will be performed.
  92 .It Fl g
  93 Produce symbolic information in the object or executable files.
  94 .It Fl I Ar directory
  95 Change the algorithm for searching for headers whose names are not
  96 absolute pathnames to look in the directory named by the
  97 .Ar directory
  98 pathname before looking in the usual places.
  99 Thus, headers whose
 100 names are enclosed in double-quotes
 101 .Pq Qq
 102 will be searched for first
 103 in the directory of the file with the
 104 .Ic #include
 105 line, then in
 106 directories named in
 107 .Fl I
 108 options, and last in the usual places.
 109 For headers whose names are enclosed in angle brackets
 110 .Pq Aq ,
 111 the header
 112 will be searched for only in directories named in
 113 .Fl I
 114 options and then in the usual places.
 115 Directories named in
 116 .Fl I
 117 options shall be searched in the order specified.
 118 The
 119 .Fl I
 120 option may be specified more than once.
 121 .It Fl L Ar directory
 122 Change the algorithm of searching for the libraries named in the
 123 .Fl l
 124 objects to look in the directory named by the
 125 .Ar directory
 126 pathname before looking in the usual places.
 127 Directories named in
 128 .Fl L
 129 options will be searched in the order specified.
 130 The
 131 .Fl L
 132 option may be specified more than once.
 133 .It Fl o Ar outfile
 134 Use the pathname
 135 .Ar outfile ,
 136 instead of the default
 137 .Pa a.out ,
 138 for the executable file produced.
 139 .It Fl O Ar optlevel
 140 If
 141 .Ar optlevel
 142 is zero, disable all optimizations.
 143 Otherwise, enable optimizations at the specified level.
 144 .It Fl s
 145 Produce object and/or executable files from which symbolic and other
 146 information not required for proper execution has been removed
 147 (stripped).
 148 .It Fl U Ar name
 149 Remove any initial definition of
 150 .Ar name .
 151 The
 152 .Fl U
 153 option may be specified more than once.
 154 .El
 155 .Pp
 156 An operand is either in the form of a pathname or the form
 157 .Fl l
 158 library.
 159 At least one operand of the pathname form needs to be specified.
 160 Supported operands are of the form:
 161 .Bl -tag -offset indent -width ".Fl l Ar library"
 162 .It Ar file Ns Pa .c
 163 A C-language source file to be compiled and optionally linked.
 164 The operand must be of this form if the
 165 .Fl c
 166 option is used.
 167 .It Ar file Ns Pa .a
 168 A library of object files, as produced by
 169 .Xr ar 1 ,
 170 passed directly to the link editor.
 171 .It Ar file Ns Pa .o
 172 An object file produced by
 173 .Nm Fl c ,
 174 and passed directly to the link editor.
 175 .It Fl l Ar library
 176 Search the library named
 177 .Pa lib Ns Ar library Ns Pa .a .
 178 A library will be searched when its name is encountered, so the
 179 placement of a
 180 .Fl l
 181 operand is significant.
 182 .El
 183 .Sh SEE ALSO
 184 .Xr ar 1 ,
 185 .Xr c89 1 ,
 186 .Xr cc 1
 187 .Sh STANDARDS
 188 The
 189 .Nm
 190 utility interface conforms to
 191 .St -p1003.1-2001 .
 192 Since it is a wrapper around
 193 .Tn GCC ,
 194 it is limited to the
 195 .Tn C99
 196 features that
 197 .Tn GCC
 198 actually implements.
 199 See
 200 .Pa http://gcc.gnu.org/gcc-3.4/c99status.html .