fixPrecomps

fixPrecomps

---

 fixPrecomps -help  fixPrecomps [-checkOnly] [-force] [-relroot   directory   ] [-all   -precompsList   filename   ] [-precomps   filename   ...] [-find_all_precomps] [-gcc2   -gcc3all] [-skipIfMissing] [-output   directory   ] [-precompFlags   flag   ...] 

Description

Compiles header files to improve performance for programs including them. When invoked without arguments, fixPrecomps reads any files in /System/Library/SystemResources/PrecompLists/ in alphanumeric order by filename. Normally this includes phase1.precompList and phase2.precompList . These files are expected to consist of lists of precompiled header filenames to generate. fixPrecomps then runs cc -precomp on the ordinary header files where the precompiled headers are either out-of-date (i.e., have modification times less recent than the ordinary headers) or nonexistent.

The headers listed in the precompList files have filename extensions of either .p or .pp . fixPrecomps finds ordinary headers with the same base filenames but extensions of .h . The .p headers are compiled with GCC Version 2 for use with C and Objective-C programs, while the .pp headers are compiled with GCC Version 2 for C++ and Objective-C++ programs. By default, fixPrecomps compiles headers with GCC Version 3, in which case C/Objective-C precompiled header filenames end in - gcc3.p , and C++/Objective-C++ precompiled header filenames end in - gcc3.pp .

Options/Usage

-all

Uses all files contained in /System/Library/SystemResources/PrecompLists/ . This is the default.

-checkOnly

For each header file listed in the precompList files, prints a status message to standard output indicating whether the precompiled header exists and is up-to-date with the ordinary header.

-find_all_precomps

Requires specification of - all , - precompList or - precomps , but otherwise doesn't appear to do anything.

-force

Produces precompiled headers even if they're up-to-date. Using this flag causes the - checkOnly flag to be ignored.

-gcc2

Applies the command to GCC Version 2 C/Objective-C ( .p ) and C++/Objective-C++ ( .pp ) precompiled headers.

-gcc3all

Applies the command to GCC Version 3 C++/Objective-C++ ( -gcc3.pp ) precompiled headers, as well as to those for C/Objective-C ( -gcc3.p ).

-help

Prints a usage statement to standard error.

-output

Checks for and creates precompiled headers in locations relative to the specified directory. Intermediate directories must already exist, or compilation will fail.

-precompFlags

Specifies additional cc command-line flags to use when compiling headers.

-precompList

Uses only the precompList files specified.

-precomps

Specifies a list of precompiled headers to check or create.

-relroot

Looks for System/Library/SystemResources/PrecompLists/ relative to the specified directory. The default is / .

-skipIfMissing

Compiles precompiled headers if they're out-of-date, but not if they don't exist. Using this flag causes the - checkOnly flag to be ignored.

Location

/usr/bin