xcode-select(1) BSD General Commands Manual xcode-select(1)
NAME
xcode-select - Manages the active developer directory for Xcode and BSD
tools.
SYNOPSIS
xcode-select [-h|--help] [-s|--switch <path>] [-p|--print-path]
[-v|--version]
DESCRIPTION
xcode-select controls the location of the developer directory used by
xcrun(1), xcodebuild(1), cc(1), and other Xcode and BSD development
tools. This also controls the locations that are searched for by man(1)
for developer tool manpages.
This allows you to easily switch between different versions of the
Xcode tools and can be used to update the path to the Xcode if it is
moved after installation.
Usage
When multiple Xcode applications are installed on a system (e.g.
/Applications/Xcode.app, containing the latest Xcode, and /Applica-
tions/Xcode-DP.app containing a developer preview) use xcode-select
--switch path/to/Xcode.app to specify the Xcode that you wish to use
for command line developer tools.
After setting a developer directory, all of the xcode-select provided
developer tool shims (see FILES) will automatically invoke the version
of the tool inside the selected developer directory. Your own scripts,
makefiles, and other tools can also use xcrun(1) to easily lookup tools
inside the active developer directory, making it easy to switch them
between different versions of the Xcode tools and allowing them to
function properly on systems where the Xcode application has been
installed to a non-default location.
OPTIONS
-h, --help
Prints the usage message.
-s <path>, --switch <path>
Sets the active developer directory to the given path, for exam-
ple /Applications/Xcode-DP.app. This command must be run with
superuser permissions (see sudo(8)), and will affect all users
on the system. To set the path without superuser permissions or
only for the current shell session, use the DEVELOPER_DIR envi-
ronment variable instead (see ENVIRONMENT).
-p, --print-path
Prints the path to the currently selected developer directory.
This is useful for inspection, but scripts and other tools
should use xcrun(1) to locate tool inside the active developer
directory.
-r, --reset
Unsets any user-specified developer directory, so that the
developer directory will be found via the default search mecha-
nism. This command must be run with superuser permissions (see
sudo(8)), and will affect all users on the system.
-v, --version
Prints xcode-select version information.
--install
Opens a user interface dialog to request automatic installation
of the command line developer tools.
ENVIRONMENT
DEVELOPER_DIR
Overrides the active developer directory. When DEVELOPER_DIR is set,
its value will be used instead of the system-wide active developer
directory.
Note that for historical reason, the developer directory is consid-
ered to be the Developer content directory inside the Xcode applica-
tion (for example /Applications/Xcode.app/Contents/Developer). You
can set the environment variable to either the actual Developer con-
tents directory, or the Xcode application directory -- the
xcode-select provided shims will automatically convert the environ-
ment variable into the full Developer content path.
EXAMPLES
xcode-select --switch /Applications/Xcode.app/Contents/Developer
Select /Applications/Xcode.app/Contents/Developer as the active
developer directory.
xcode-select --switch /Applications/Xcode.app
As above, selects /Applications/Xcode.app/Contents/Developer as the
active developer directory. The Developer content directory is auto-
matically inferred by xcode-select.
/usr/bin/xcodebuild
Runs xcodebuild out of the active developer directory.
/usr/bin/xcrun --find xcodebuild
Use xcrun to locate xcodebuild inside the active developer direc-
tory.
env DEVELOPER_DIR="/Applications/Xcode-DP.app" /usr/bin/xcodebuild
Execute xcodebuild using an alternate developer directory.
FILES
/usr/bin/xcrun
Used to find or run arbitrary commands from the active developer
directory. See xcrun(1) for more information.
/usr/bin/agvtool /usr/bin/desdp /usr/bin/ibtool /usr/bin/ictool
/usr/bin/instruments /usr/bin/iprofiler /usr/bin/opendiff /usr/bin/sdef
/usr/bin/sdp /usr/bin/xcodebuild /usr/bin/xed
Runs the matching Xcode tool from with the active developer direc-
tory.
/usr/bin/BuildStrings /usr/bin/CpMac /usr/bin/DeRez /usr/bin/GetFile-
Info /usr/bin/MergePef /usr/bin/MvMac /usr/bin/ResMerger
/usr/bin/RezDet /usr/bin/RezWack /usr/bin/Rez /usr/bin/SetFile
/usr/bin/SplitForks /usr/bin/UnRezWack /usr/bin/ar /usr/bin/as
/usr/bin/asa /usr/bin/bison /usr/bin/c89 /usr/bin/c99 /usr/bin/clang++
/usr/bin/clang /usr/bin/cmpdylib /usr/bin/codesign_allocate
/usr/bin/cpp /usr/bin/ctags /usr/bin/ctf_insert /usr/bin/dsymutil
/usr/bin/dwarfdump /usr/bin/flex++ /usr/bin/flex /usr/bin/g++
/usr/bin/gatherheaderdoc /usr/bin/gcc /usr/bin/gcov
/usr/bin/git-cvsserver /usr/bin/git-receive-pack /usr/bin/git-shell
/usr/bin/git-upload-archive /usr/bin/git-upload-pack /usr/bin/git
/usr/bin/gm4 /usr/bin/gnumake /usr/bin/gperf /usr/bin/hdxml2manxml
/usr/bin/headerdoc2html /usr/bin/indent /usr/bin/install_name_tool
/usr/bin/ld /usr/bin/lex /usr/bin/libtool /usr/bin/lipo /usr/bin/lldb
/usr/bin/lorder /usr/bin/m4 /usr/bin/make /usr/bin/mig /usr/bin/mkdep
/usr/bin/nasm /usr/bin/ndisasm /usr/bin/nm /usr/bin/nmedit
/usr/bin/otool /usr/bin/pagestuff /usr/bin/ranlib /usr/bin/rebase
/usr/bin/redo_prebinding /usr/bin/resolveLinks /usr/bin/rpcgen
/usr/bin/segedit /usr/bin/size /usr/bin/strings /usr/bin/strip
/usr/bin/svn /usr/bin/svnadmin /usr/bin/svndumpfilter /usr/bin/svnlook
/usr/bin/svnserve /usr/bin/svnsync /usr/bin/svnversion /usr/bin/unifdef
/usr/bin/unifdefall /usr/bin/xml2man /usr/bin/yacc
Runs the matching BSD tool from with the active developer directory.
SEE ALSO
xcrun(1)
HISTORY
The xcode-select command first appeared in Xcode 3.0.
Mac OS X July 30, 2013 xcode-select(1)
Mac OS X 10.9 - Generated Sun Oct 13 13:45:22 CDT 2013