Red Hat ENTERPRISE LINUX 4 Manual page 130

122
When you run these programs, you must specify a set of source files as command line arguments.
The conversion programs start out by compiling these files to see what functions they define. The
information gathered about a file
After scanning comes actual conversion. The specified files are all eligible to be converted; any files
they include (whether sources or just headers) are eligible as well.
But not all the eligible files are converted. By default,
source and header files in the current directory. You can specify additional directories whose files
should be converted with the
with the option. A file is converted if it is eligible, its directory name matches one of the
-x
file
specified directory names, and its name within the directory has not been excluded.
Basic conversion with
tions to specify the types of the arguments. The only ones not rewritten are those for varargs functions.
optionally inserts prototype declarations at the beginning of the source file, to make them
protoize
available for any calls that precede the function's definition. Or it can insert prototype declarations
with block scope in the blocks where undeclared functions are called.
Basic conversion with
argument types, and rewriting function definitions to the old-style pre-ISO form.
Both conversion programs print a warning for any function declaration or definition that they can't
convert. You can suppress these warnings with
The output from
protoize
renamed to a name ending with
suffix). If the
.c .save
and
protoize unprotoize
about the functions it uses. So neither of these programs will work until GCC is installed.
Here is a table of the options you can use with
both programs unless otherwise stated.
-B
directory
Look for the file
/usr/local/lib
This option applies only to
-c
compilation-options
Use
compilation-options
special option
-aux-info
Note that the compilation options must be given as a single argument to
. If you want to specify several
unprotoize
compilation options to make them a single word in the shell.
There are certain
wrong kind of output. These include
compilation-options
-C
Rename files to end in
you are converting a C program to C++. This option applies only to
-g
Add explicit global declarations. This means inserting explicit declarations at the beginning of
each source file for each function that is called in the file and was not declared. These declarations
is saved in a file named
foo
-d
directory
consists of rewriting most function definitions and function declara-
protoize
consists of rewriting most function declarations to remove any
unprotoize
or
unprotoize
(for DOS, the saved filename ends in
.save
( for DOS) file already exists, then the source file is simply discarded.
.sav
both depend on GCC itself to scan the program and collect information
in
SYSCALLS.c.X
). This file contains prototype information about standard system functions.
protoize
as the options when running
is always passed in addition, to tell
arguments that you cannot use, because they would produce the
gcc
, they are ignored.
( for DOS-based file systems) instead of
.C .cc
Chapter 4. GCC Command Options
foo
protoize
option. You can also specify particular files to exclude
.
-q
replaces the original source file. The original file is
and
protoize unprotoize
, instead of the usual directory (normally
directory
.
options, you must quote the entire set of
gcc
, , , , and
-g -O -c -S
.
.X
and
unprotoize
without the original
.sav
. Each option works with
to produce the
gcc
to write a file.
gcc .X
If you include these in the
-o
. This is convenient if
.c
.
protoize
convert only
files. The
.X
or
protoize