|
|
This manual page is part of Xcode Tools version 3.2To obtain these tools:
If you are running a version of Xcode Tools other than 3.2, view the documentation locally:
Reading manual pagesManual pages are intended as a quick reference for people who already understand a technology.
|
xcrun
xcrun -- run or locate development tools
SYNOPSIS
xcrun [-sdk SDK] -find <tool_name>
xcrun [-sdk SDK] [-log] <tool_name> [<tool_arguments>]
<tool_name> [<tool_arguments>]
DESCRIPTION
xcrun provides a means locate or invoke coexistence- and platform-aware developer tools from the com-mand-line, command-line,
mand-line, without requiring users to modify makefiles or otherwise take laborious or inconvenient mea-sures measures
sures to adopt Xcode's multiple tool chains.
xcode-select is used to specify which installation of Xcode is used, and may be overridden by the
DEVELOPER_DIR environment variable.
The SDK defaults to the current OS SDK, and can be specified by SDKROOT environment variable or the
-sdk flag (which takes precedences over SDKROOT).
USAGE
The first usage returns the full path to the found tool_name.
The second usage executes tool_name with the given tool_arguments.
The last syntax is when xcrun replaces any of the standard UNIX developer tools (typically in
/usr/bin). In this case, xcrun will use its tool name to locate the corresponding tool within evalu-ated evaluated
ated DEVELOPER_DIR and SDK.
If the tool is not named xcrun , tool_arguments are not parsed by xcrun.
OPTIONS
-verbose
display information about how the redirected path is constructed.
-no-cache
don't consult the cache when looking up values. In effect, causes the cache to be refreshed.
-sdk SDK
specifies which SDK to use. Overrides any SDKROOT set in the environment.
-log print the full command line that is invoked.
-find
print the full path to the tool.
ENVIRONMENT
DEVELOPER_DIR - specifies the search path for locating the current developer tools (overrides
xcode-select default).
SDKROOT - specifies the SDK to use; overriden by the command line -sdk flag.
xcrun_log - same as specifying -log
xcrun_nocache - same as specifying -no-cache
xcrun_verbose - same as specifying -verbose
DIAGNOSTICS
When xcrun is invoked with the name xcrun , the flags -log and -verbose are useful debugging aids. The
flag -no-cache can be used to bypass cache lookup.
When xcrun as taken the place of another tool, the arguments are those of the tool replaced, and the
various xcrun flags can't be used. In this case, use the specific environment variables instead.
SEE ALSO
xcodebuild -find Xcode coexistence
|
The way to report a problem with this manual page depends on the type of problem: