manpagez: man pages & more
man xcrun(1)
Home | html | info | man
xcrun(1)                  BSD General Commands Manual                 xcrun(1)


NAME

     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 to locate or invoke coexistence- and platform-
     aware developer tools from the command-line, without requiring users to
     modify makefiles or otherwise take inconvenient measures to support mul-
     tiple Xcode tool chains.

     The tool 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 boot system OS SDK, and can be specified by the
     SDKROOT environment variable or the -sdk option (which takes precedences
     over SDKROOT).

   Usages
     The first usage returns the full path to the found tool_name.

     The second usage executes tool_name with tool_arguments.

     The third usage is when xcrun is used as a replacement for any of the
     standard UNIX developer tools (typically in /usr/bin).  In this case,
     xcrun will use the name of the tool it's replacing ( tool_name ) to
     locate the corresponding tool within evaluated DEVELOPER_DIR and SDK.

     If the tool is not named xcrun , as in the third usage, then
     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 entry to be refreshed.

     -kill-cache
           Removes the cache.  Causes all values to be re-cached.

     -sdk SDK
           Specifies which SDK to use.  Overrides any SDKROOT set in the envi-
           ronment.

     -log  Print the full command line that is invoked.

     -find
           Print the full path to the tool.

   Environment Variables
     The following environment variables affect the execution of xcrun:

     DEVELOPER_DIR   Specifies the search path for locating the current devel-
                     oper tools (overrides xcode-select default).

     SDKROOT         Specifies the SDK to use; overriden by the command line
                     -sdk option.

     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 options -log and -verbose
     are useful debugging aids.  The option -no-cache can be used to bypass
     cache lookup, but often at a significant cost in performance.

     When xcrun has taken the place of another tool, the arguments are those
     of the tool replaced, and the various xcrun options can't be used.  In
     this case, use the specific environment variables instead.



SEE ALSO

     xcodebuild -find

     Xcode coexistence

Mac OS X                         June 14, 2011                        Mac OS X

Mac OS X 10.8 - Generated Mon Aug 20 16:33:56 CDT 2012
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.