<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
<meta http-equiv="X-UA-Compatible" content="IE=edge"></meta>
<meta name="copyright" content="(C) Copyright 2005"></meta>
<meta name="DC.rights.owner" content="(C) Copyright 2005"></meta>
<meta name="DC.Type" content="concept"></meta>
<meta name="DC.Title" content="CUDA Installation Guide for Microsoft Windows"></meta>
<meta name="abstract" content="The installation instructions for the CUDA Toolkit on MS-Windows systems."></meta>
<meta name="description" content="The installation instructions for the CUDA Toolkit on MS-Windows systems."></meta>
<meta name="DC.Coverage" content="Installation Guides"></meta>
<meta name="DC.subject" content="CUDA Windows, CUDA Windows requirements, CUDA Windows install, CUDA Windows sample, CUDA Windows install tools, CUDA Windows GPU, CUDA Windows download, CUDA Windows build, CUDA Windows programs, CUDA Windows install verification"></meta>
<meta name="keywords" content="CUDA Windows, CUDA Windows requirements, CUDA Windows install, CUDA Windows sample, CUDA Windows install tools, CUDA Windows GPU, CUDA Windows download, CUDA Windows build, CUDA Windows programs, CUDA Windows install verification"></meta>
<meta name="DC.Format" content="XHTML"></meta>
<meta name="DC.Identifier" content="abstract"></meta>
<link rel="stylesheet" type="text/css" href="../common/formatting/commonltr.css"></link>
<link rel="stylesheet" type="text/css" href="../common/formatting/site.css"></link>
<title>Installation Guide Windows :: CUDA Toolkit Documentation</title>
<!--[if lt IE 9]>
<script src="../common/formatting/html5shiv-printshiv.min.js"></script>
<![endif]-->
<script type="text/javascript" charset="utf-8" src="//assets.adobedtm.com/b92787824f2e0e9b68dc2e993f9bd995339fe417/satelliteLib-7ba51e58dc61bcb0e9311aadd02a0108ab24cc6c.js"></script>
<script type="text/javascript" charset="utf-8" src="../common/formatting/jquery.min.js"></script>
<script type="text/javascript" charset="utf-8" src="../common/formatting/jquery.ba-hashchange.min.js"></script>
<script type="text/javascript" charset="utf-8" src="../common/formatting/jquery.scrollintoview.min.js"></script>
<script type="text/javascript" src="../search/htmlFileList.js"></script>
<script type="text/javascript" src="../search/htmlFileInfoList.js"></script>
<script type="text/javascript" src="../search/nwSearchFnt.min.js"></script>
<script type="text/javascript" src="../search/stemmers/en_stemmer.min.js"></script>
<script type="text/javascript" src="../search/index-1.js"></script>
<script type="text/javascript" src="../search/index-2.js"></script>
<script type="text/javascript" src="../search/index-3.js"></script>
<link rel="canonical" href="http://docs.nvidia.com/cuda/cuda-installation-guide-microsoft-windows/index.html"></link>
<link rel="stylesheet" type="text/css" href="../common/formatting/qwcode.highlight.css"></link>
</head>
<body>
<header id="header"><span id="company">NVIDIA</span><span id="site-title">CUDA Toolkit Documentation</span><form id="search" method="get" action="search">
<input type="text" name="search-text"></input><fieldset id="search-location">
<legend>Search In:</legend>
<label><input type="radio" name="search-type" value="site"></input>Entire Site</label>
<label><input type="radio" name="search-type" value="document"></input>Just This Document</label></fieldset>
<button type="reset">clear search</button>
<button id="submit" type="submit">search</button></form>
</header>
<div id="site-content">
<nav id="site-nav">
<div class="category closed"><a href="../index.html" title="The root of the site.">CUDA Toolkit
v10.1.168</a></div>
<div class="category"><a href="index.html" title="Installation Guide Windows">Installation Guide Windows</a></div>
<ul>
<li>
<div class="section-link"><a href="#introduction">1. Introduction</a></div>
<ul>
<li>
<div class="section-link"><a href="#system-requirements">1.1. System Requirements</a></div>
<ul>
<li>
<div class="section-link"><a href="#x86-32-bit-support">1.1.1. x86 32-bit Support</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="#about-this-document">1.2. About This Document</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="#installing-cuda-development-tools">2. Installing CUDA Development Tools</a></div>
<ul>
<li>
<div class="section-link"><a href="#verify-you-have-cuda-enabled-system">2.1. Verify You Have a CUDA-Capable GPU</a></div>
</li>
<li>
<div class="section-link"><a href="#download-cuda-software">2.2. Download the NVIDIA CUDA Toolkit</a></div>
</li>
<li>
<div class="section-link"><a href="#install-cuda-software">2.3. Install the CUDA Software</a></div>
<ul>
<li>
<div class="section-link"><a href="#uninstall-cuda-software">2.3.1. Uninstalling the CUDA Software</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="#driver-model">2.4. Use a Suitable Driver Model</a></div>
</li>
<li>
<div class="section-link"><a href="#verify-installation">2.5. Verify the Installation</a></div>
<ul>
<li>
<div class="section-link"><a href="#compiling-examples">2.5.1. Running the Compiled Examples</a></div>
</li>
</ul>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="#compiling-cuda-programs">3. Compiling CUDA Programs</a></div>
<ul>
<li>
<div class="section-link"><a href="#compiling-sample-projects">3.1. Compiling Sample Projects</a></div>
</li>
<li>
<div class="section-link"><a href="#sample-projects">3.2. Sample Projects</a></div>
</li>
<li>
<div class="section-link"><a href="#build-customizations">3.3. Build Customizations for New Projects</a></div>
</li>
<li>
<div class="section-link"><a href="#build-customizations-for-existing-projects">3.4. Build Customizations for Existing Projects</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="#additional-considerations">4. Additional Considerations</a></div>
</li>
</ul>
</nav>
<div id="resize-nav"></div>
<nav id="search-results">
<h2>Search Results</h2>
<ol></ol>
</nav>
<div id="contents-container">
<div id="breadcrumbs-container">
<div id="release-info">Installation Guide Windows
(<a href="../../pdf/CUDA_Installation_Guide_Windows.pdf">PDF</a>)
-
v10.1.168
(<a href="https://developer.nvidia.com/cuda-toolkit-archive">older</a>)
-
Last updated April 24, 2019
-
<a href="mailto:CUDAIssues@nvidia.com?subject=CUDA Toolkit Documentation Feedback: Installation Guide Windows">Send Feedback</a></div>
</div>
<article id="contents">
<div class="topic nested0" id="abstract"><a name="abstract" shape="rect">
<!-- --></a><h2 class="title topictitle1"><a href="#abstract" name="abstract" shape="rect">CUDA Installation Guide for Microsoft Windows</a></h2>
<div class="body conbody">
<p class="shortdesc">The installation instructions for the CUDA Toolkit on MS-Windows systems.</p>
</div>
</div>
<div class="topic concept nested0" id="introduction"><a name="introduction" shape="rect">
<!-- --></a><h2 class="title topictitle1"><a href="#introduction" name="introduction" shape="rect">1. Introduction</a></h2>
<div class="body conbody">
<p class="p">CUDA<sup>®</sup> is a parallel computing platform and programming model invented by NVIDIA. It enables dramatic increases in computing performance
by harnessing the power of the graphics processing unit (GPU).
</p>
<div class="p">CUDA was developed with several design goals in mind:
<ul class="ul">
<li class="li">Provide a small set of extensions to standard programming languages, like C, that enable a straightforward implementation
of parallel algorithms. With CUDA C/C++, programmers can focus on the task of parallelization of the algorithms rather than
spending time on their implementation.
</li>
<li class="li">Support heterogeneous computation where applications use both the CPU and GPU. Serial portions of applications are run on
the CPU, and parallel portions are offloaded to the GPU. As such, CUDA can be incrementally applied to existing applications.
The CPU and GPU are treated as separate devices that have their own memory spaces. This configuration also allows simultaneous
computation on the CPU and GPU without contention for memory resources.
</li>
</ul>
CUDA-capable GPUs have hundreds of cores that can collectively run thousands of computing threads. These cores have shared
resources including a register file and a shared memory. The on-chip shared memory allows parallel tasks running on these
cores to share data without sending it over the system memory bus.
</div>
<p class="p">This guide will show you how to install and check the correct operation of the CUDA development tools.</p>
</div>
<div class="topic concept nested1" id="system-requirements"><a name="system-requirements" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#system-requirements" name="system-requirements" shape="rect">1.1. System Requirements</a></h3>
<div class="body conbody">
<div class="p">To use CUDA on your system, you will need the following installed:
<ul class="ul">
<li class="li">A CUDA-capable GPU</li>
<li class="li">A supported version of Microsoft Windows</li>
<li class="li">A supported version of Microsoft Visual Studio</li>
<li class="li">the NVIDIA CUDA Toolkit (available at <a class="xref" href="http://developer.nvidia.com/cuda-downloads" target="_blank" shape="rect">http://developer.nvidia.com/cuda-downloads</a>)
</li>
</ul>
</div>
<p class="p">The next two tables list the currently supported Windows operating systems and compilers.</p>
<div class="tablenoborder"><a name="system-requirements__table_hrp_klk_qk" shape="rect">
<!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="system-requirements__table_hrp_klk_qk" class="table" frame="border" border="1" rules="all">
<caption><span class="tablecap">Table 1. Windows Operating System Support in CUDA <span class="keyword">10.1</span></span></caption>
<thead class="thead" align="left">
<tr class="row">
<th class="entry" align="left" valign="top" width="NaN%" id="d54e148" rowspan="1" colspan="1">Operating System</th>
<th class="entry" align="center" valign="top" width="NaN%" id="d54e151" rowspan="1" colspan="1">Native x86_64</th>
<th class="entry" align="center" valign="top" width="NaN%" id="d54e154" rowspan="1" colspan="1">Cross (x86_32 on x86_64)</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry" align="left" valign="top" width="NaN%" headers="d54e148" rowspan="1" colspan="1">Windows 10</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e151" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e154" rowspan="1" colspan="1">YES</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="NaN%" headers="d54e148" rowspan="1" colspan="1">Windows 8.1</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e151" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e154" rowspan="1" colspan="1">YES</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="NaN%" headers="d54e148" rowspan="1" colspan="1">Windows 7</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e151" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e154" rowspan="1" colspan="1">YES</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="NaN%" headers="d54e148" rowspan="1" colspan="1">Windows Server 2019</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e151" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e154" rowspan="1" colspan="1">NO</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="NaN%" headers="d54e148" rowspan="1" colspan="1">Windows Server 2016</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e151" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e154" rowspan="1" colspan="1">NO</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="NaN%" headers="d54e148" rowspan="1" colspan="1">Windows Server 2012 R2</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e151" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e154" rowspan="1" colspan="1">NO</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder">
<table cellpadding="4" cellspacing="0" summary="" class="table" frame="border" border="1" rules="all">
<caption><span class="tablecap">Table 2. Windows Compiler Support in CUDA <span class="keyword">10.1</span></span></caption>
<thead class="thead" align="left">
<tr class="row">
<th class="entry" valign="top" width="NaN%" id="d54e258" rowspan="1" colspan="1">Compiler*</th>
<th class="entry" valign="top" width="NaN%" id="d54e261" rowspan="1" colspan="1">IDE</th>
<th class="entry" align="center" valign="top" width="NaN%" id="d54e264" rowspan="1" colspan="1">Native x86_64</th>
<th class="entry" align="center" valign="top" width="NaN%" id="d54e267" rowspan="1" colspan="1">Cross (x86_32 on x86_64)</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry" valign="top" width="NaN%" headers="d54e258" rowspan="1" colspan="1">MSVC Version 192x</td>
<td class="entry" valign="top" width="NaN%" headers="d54e261" rowspan="1" colspan="1">Visual Studio 2019 16.x (Preview releases)</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e264" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e267" rowspan="1" colspan="1">NO</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="NaN%" headers="d54e258" rowspan="1" colspan="1">MSVC Version 191x</td>
<td class="entry" valign="top" width="NaN%" headers="d54e261" rowspan="1" colspan="1">Visual Studio 2017 15.x (RTW and all updates)</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e264" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e267" rowspan="1" colspan="1">NO</td>
</tr>
<tr class="row">
<td class="entry" rowspan="2" valign="middle" width="NaN%" headers="d54e258" colspan="1">MSVC Version 1900</td>
<td class="entry" valign="top" width="NaN%" headers="d54e261" rowspan="1" colspan="1">Visual Studio 2015 14.0 (RTW and updates 1, 2, and 3)</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e264" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e267" rowspan="1" colspan="1">NO</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="NaN%" headers="d54e261" rowspan="1" colspan="1">Visual Studio Community 2015</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e264" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e267" rowspan="1" colspan="1">NO</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="NaN%" headers="d54e258" rowspan="1" colspan="1">MSVC Version 1800</td>
<td class="entry" valign="top" width="NaN%" headers="d54e261" rowspan="1" colspan="1">Visual Studio 2013 12.0</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e264" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e267" rowspan="1" colspan="1">YES</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="NaN%" headers="d54e258" rowspan="1" colspan="1">MSVC Version 1700</td>
<td class="entry" valign="top" width="NaN%" headers="d54e261" rowspan="1" colspan="1">Visual Studio 2012 11.0</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e264" rowspan="1" colspan="1">YES</td>
<td class="entry" align="center" valign="top" width="NaN%" headers="d54e267" rowspan="1" colspan="1">YES</td>
</tr>
</tbody>
</table>
</div>
<p class="p">
x86_32 support is limited. See the <a class="xref" href="index.html#x86-32-bit-support" shape="rect">x86 32-bit Support</a> section for details.
</p>
<p class="p">
For more information on MSVC versions, Visual Studio product versions, visit <a class="xref" href="https://dev.to/yumetodo/list-of-mscver-and-mscfullver-8nd" target="_blank" shape="rect">https://dev.to/yumetodo/list-of-mscver-and-mscfullver-8nd</a>.
</p>
</div>
<div class="topic concept nested2" id="x86-32-bit-support"><a name="x86-32-bit-support" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#x86-32-bit-support" name="x86-32-bit-support" shape="rect">x86 32-bit Support</a></h3>
<div class="body conbody">
<p class="p">
Native development using the CUDA Toolkit on x86_32 is unsupported. Deployment and execution of CUDA applications on x86_32
is still supported, but is limited to use with GeForce GPUs.
To create 32-bit CUDA applications, use the cross-development capabilities of the CUDA Toolkit on x86_64.
</p>
<div class="p">
Support for developing and running x86 32-bit applications on x86_64 Windows is limited to use with:
<ul class="ul">
<li class="li">GeForce GPUs</li>
<li class="li">CUDA Driver</li>
<li class="li">CUDA Runtime (cudart)</li>
<li class="li">CUDA Math Library (math.h)</li>
<li class="li">CUDA C++ Compiler (nvcc)</li>
<li class="li">CUDA Development Tools</li>
</ul>
</div>
</div>
</div>
</div>
<div class="topic concept nested1" id="about-this-document"><a name="about-this-document" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#about-this-document" name="about-this-document" shape="rect">1.2. About This Document</a></h3>
<div class="body conbody">
<p class="p">This document is intended for readers familiar with Microsoft Windows operating systems and the Microsoft Visual Studio environment.
You do not need previous experience with CUDA or experience with parallel computation.
</p>
</div>
</div>
</div>
<div class="topic concept nested0" id="installing-cuda-development-tools"><a name="installing-cuda-development-tools" shape="rect">
<!-- --></a><h2 class="title topictitle1"><a href="#installing-cuda-development-tools" name="installing-cuda-development-tools" shape="rect">2. Installing CUDA Development Tools</a></h2>
<div class="body conbody">
<p class="p">
Basic instructions can be found in the <a class="xref" href="http://docs.nvidia.com/cuda/cuda-quick-start-guide/index.html#windows" target="_blank" shape="rect">Quick Start Guide</a>. Read on for more detailed instructions.
</p>
<div class="p">The setup of CUDA development tools on a system running the appropriate version of
Windows consists of a few simple steps:
<ul class="ul">
<li class="li">Verify the system has a CUDA-capable GPU.</li>
<li class="li">Download the NVIDIA CUDA Toolkit.</li>
<li class="li">Install the NVIDIA CUDA Toolkit.</li>
<li class="li">Test that the installed software runs correctly and communicates with the hardware.</li>
</ul>
</div>
</div>
<div class="topic concept nested1" id="verify-you-have-cuda-enabled-system"><a name="verify-you-have-cuda-enabled-system" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#verify-you-have-cuda-enabled-system" name="verify-you-have-cuda-enabled-system" shape="rect">2.1. Verify You Have a CUDA-Capable GPU</a></h3>
<div class="body conbody">
<p class="p">
You can verify that you have a CUDA-capable GPU through the <strong class="ph b">Display Adapters</strong> section in the <strong class="ph b">Windows Device Manager</strong>. Here you will find the vendor name and model of your graphics card(s). If you have an NVIDIA card that is listed in <a class="xref" href="http://developer.nvidia.com/cuda-gpus" target="_blank" shape="rect">http://developer.nvidia.com/cuda-gpus</a>, that GPU is CUDA-capable. The Release Notes for the CUDA Toolkit also contain a list of supported products.
</p>
<div class="p">
The <strong class="ph b">Windows Device Manager</strong> can be opened via the following steps:
<ol class="ol">
<li class="li">
Open a run window from the Start Menu
</li>
<li class="li">
Run:
<pre class="pre screen" xml:space="preserve">control /name Microsoft.DeviceManager</pre></li>
</ol>
</div>
</div>
</div>
<div class="topic concept nested1" id="download-cuda-software"><a name="download-cuda-software" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#download-cuda-software" name="download-cuda-software" shape="rect">2.2. Download the NVIDIA CUDA Toolkit</a></h3>
<div class="body conbody">
<div class="p">The NVIDIA CUDA Toolkit is available at <a class="xref" href="http://developer.nvidia.com/cuda-downloads" target="_blank" shape="rect">http://developer.nvidia.com/cuda-downloads</a>. Choose the platform you are using and one of the following installer formats:
<ol class="ol">
<li class="li">Network Installer: A minimal installer which later downloads packages required for installation. Only the packages selected
during the selection phase of the installer are downloaded. This installer is useful for users who want to minimize download
time.
</li>
<li class="li">Full Installer: An installer which contains all the components of the CUDA Toolkit and does not require any further download.
This installer is useful for systems which lack network access and for enterprise deployment.
</li>
</ol>
</div>
<p class="p">The CUDA Toolkit installs the CUDA driver and tools needed to create, build and run a CUDA application as well as libraries,
header files, CUDA samples source code, and other resources.
</p>
<div class="section">
<h3 class="title sectiontitle">Download Verification</h3>
<p class="p">The download can be verified by comparing the MD5 checksum posted at <a class="xref" href="http://developer.nvidia.com/cuda-downloads/checksums" target="_blank" shape="rect">http://developer.nvidia.com/cuda-downloads/checksums</a> with that of the downloaded file. If either of the checksums differ, the downloaded file is corrupt and needs to be downloaded
again.
</p>
<p class="p">To calculate the MD5 checksum of the downloaded file, follow the instructions at <a class="xref" href="http://support.microsoft.com/kb/889768" target="_blank" shape="rect">http://support.microsoft.com/kb/889768</a>.
</p>
</div>
</div>
</div>
<div class="topic concept nested1" id="install-cuda-software"><a name="install-cuda-software" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#install-cuda-software" name="install-cuda-software" shape="rect">2.3. Install the CUDA Software</a></h3>
<div class="body conbody">
<p class="p">Before installing the toolkit, you should read the <cite class="cite">Release Notes</cite>, as they provide details on installation and software functionality.
</p>
<div class="note note"><span class="notetitle">Note:</span> The driver and toolkit must be installed for CUDA to function. If you have not installed a stand-alone driver, install the
driver from the NVIDIA CUDA Toolkit.
</div>
<div class="note note"><span class="notetitle">Note:</span> The installation may fail if Windows Update starts after the installation has begun. Wait until Windows Update is complete
and then try the installation again.
</div>
<div class="section">
<h3 class="title sectiontitle">Graphical Installation</h3>
<p class="p">Install the CUDA Software by executing the CUDA installer and following the on-screen prompts.</p>
</div>
<div class="section">
<h3 class="title sectiontitle">Silent Installation</h3>
<p class="p">
The installer can be executed in silent mode by executing the package with the <samp class="ph codeph">-s</samp> flag.
Additional parameters can be passed which will install specific subpackages instead of all packages.
See the table below for a list of all the subpackage names.
</p>
<div class="tablenoborder">
<table cellpadding="4" cellspacing="0" summary="" class="table" frame="border" border="1" rules="all">
<caption><span class="tablecap">Table 3. Possible Subpackage Names</span></caption>
<thead class="thead" align="left">
<tr class="row">
<th class="entry" valign="top" width="33.33333333333333%" id="d54e601" rowspan="1" colspan="1">Subpackage Name</th>
<th class="entry" valign="top" width="66.66666666666666%" id="d54e604" rowspan="1" colspan="1">Subpackage Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row gray">
<td class="entry" colspan="2" valign="top" headers="d54e601 d54e604" rowspan="1">Toolkit Subpackages (defaults to C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v<span class="keyword">10.1</span>)
</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvcc_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUDA compiler.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cuobjdump_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Extracts information from cubin files.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvprune_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Prunes host object files and libraries to only contain device code for the specified targets.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cupti_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">The CUDA Profiler Tools Interface for creating profiling and tracing tools that target CUDA applications.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">gpu_library_advisor_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Identifies opportunities to improve application performance by replacing existing CPU libraries with GPU-accelerated versions
of those libraries.
</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">memcheck_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Functional correctness checking suite.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvdisasm_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Extracts information from standalone cubin files.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvprof_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Tool for collecting and viewing CUDA application profiling data from the command-line.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">visual_profiler_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">GUI profiler for CUDA applications.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">visual_studio_integration_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Registers the CUDA plugins with supported and installed versions of Visual Studio. Also installs Nsight Visual Studio Edition
as well as the NVIDIA Tools Extension SDK. This integration allows for CUDA development within Visual Studio.
</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">demo_suite_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Prebuilt demo applications using CUDA.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">documentation_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUDA HTML and PDF documentation files including the CUDA C Programming Guide, CUDA C Best Practices Guide, CUDA library documentation,
etc.
</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cublas_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUBLAS runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cublas_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUBLAS development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cudart_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUDART runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cufft_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUFFT runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cufft_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUFFT development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">curand_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CURAND runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">curand_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CURAND development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cusolver_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUSOLVER runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cusolver_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUSOLVER development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cusparse_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUSPARSE runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">cusparse_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUSPARSE development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvgraph_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">NVIDIA Graph Analytics runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvgraph_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">NVIDIA Graph Analytics development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">npp_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">NPP runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">npp_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">NPP development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvrtc_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">NVRTC runtime libraries.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvrtc_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">NVRTC development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">nvml_dev_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">NVML development libraries and headers.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">occupancy_calculator_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">Excel spreadsheet used to test occupancy scenarios.</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">fortran_examples_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">CUDA Fortran examples.</td>
</tr>
<tr class="row gray">
<td class="entry" colspan="2" valign="top" headers="d54e601 d54e604" rowspan="1">Samples Subpackages (defaults to C:\ProgramData\NVIDIA Corporation\CUDA Samples\v<span class="keyword">10.1</span>)
</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">samples_<span class="keyword">10.1</span></td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">
<p class="p">
Source code for many example CUDA applications using supported versions of Visual Studio.
</p>
<p class="p">
Note: <samp class="ph codeph">C:\ProgramData\</samp> is a hidden folder. It can be made visible within the Windows Explorer options at (Tools | Options).
</p>
</td>
</tr>
<tr class="row gray">
<td class="entry" colspan="2" valign="top" headers="d54e601 d54e604" rowspan="1">Driver Subpackages</td>
</tr>
<tr class="row">
<td class="entry" valign="top" width="33.33333333333333%" headers="d54e601" rowspan="1" colspan="1">Display.Driver</td>
<td class="entry" valign="top" width="66.66666666666666%" headers="d54e604" rowspan="1" colspan="1">The NVIDIA Display Driver. Required to run CUDA applications.</td>
</tr>
</tbody>
</table>
</div>
<div class="p">
For example, to install only the compiler and driver components:
<pre class="pre screen" xml:space="preserve"><PackageName>.exe -s nvcc_<span class="keyword">10.1</span> Display.Driver</pre></div>
</div>
<div class="section">
<h3 class="title sectiontitle">Extracting and Inspecting the Files Manually</h3>
<p class="p">Sometimes it may be desirable to extract or inspect the installable files directly, such as in enterprise deployment, or to
browse the files before installation. The full installation package can be extracted using a decompression tool which supports
the LZMA compression method, such as <a class="xref" href="http://www.7-zip.org/" target="_blank" shape="rect">7-zip</a> or <a class="xref" href="http://www.winzip.com/" target="_blank" shape="rect">WinZip</a>.
</p>
<p class="p">Once extracted, the CUDA Toolkit files will be in the <samp class="ph codeph">CUDAToolkit</samp> folder, and similarily for the CUDA Samples and CUDA Visual Studio Integration. Within each directory is a .dll and .nvi
file that can be ignored as they are not part of the installable files.
</p>
<div class="note note"><span class="notetitle">Note:</span> Accessing the files in this manner does not set up any environment settings, such as variables or Visual Studio integration.
This is intended for enterprise-level deployment.
</div>
</div>
</div>
<div class="topic task nested2" id="uninstall-cuda-software"><a name="uninstall-cuda-software" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#uninstall-cuda-software" name="uninstall-cuda-software" shape="rect">2.3.1. Uninstalling the CUDA Software</a></h3>
<div class="abstract">
<p class="p">All subpackages can be uninstalled through the Windows Control Panel by using the Programs and Features widget.</p>
</div>
</div>
</div>
<div class="topic concept nested1" id="driver-model"><a name="driver-model" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#driver-model" name="driver-model" shape="rect">2.4. Use a Suitable Driver Model</a></h3>
<div class="body conbody">
<p class="p">On Windows 7 and later, the operating system provides two
<dfn class="term">driver models</dfn> under which the NVIDIA Driver may
operate:
</p>
<ul class="ul">
<li class="li">The <dfn class="term">WDDM</dfn> driver model is used for display devices.
</li>
<li class="li">The <a class="xref" href="http://www.nvidia.com/object/software-for-tesla-products.html" target="_blank" shape="rect"><dfn class="term">Tesla Compute Cluster
(TCC)</dfn></a> mode of the NVIDIA Driver is available for
non-display devices such as NVIDIA Tesla GPUs, and the GeForce GTX Titan GPUs; it uses the
Windows <dfn class="term">WDM</dfn> driver model.
</li>
</ul>
<p class="p">The TCC driver mode provides a number of advantages for CUDA
applications on GPUs that support this mode. For example:
</p>
<ul class="ul">
<li class="li">TCC eliminates the timeouts that can occur when running under WDDM
due to the Windows <a class="xref" href="http://msdn.microsoft.com/en-us/library/windows/hardware/ff570087(v=vs.85).aspx" target="_blank" shape="rect">Timeout Detection and Recovery</a>
mechanism for display devices.
</li>
<li class="li">TCC allows the use of CUDA with Windows Remote Desktop, which is
not possible for WDDM devices.
</li>
<li class="li">TCC allows the use of CUDA from within processes running as
Windows services, which is not possible for WDDM devices.
</li>
<li class="li">TCC reduces the latency of CUDA kernel launches.</li>
</ul>
<p class="p">TCC is enabled by default on most recent NVIDIA Tesla GPUs. To
check which driver mode is in use and/or to switch driver modes,
use the <samp class="ph codeph">nvidia-smi</samp> tool that is included with
the NVIDIA Driver installation (see <samp class="ph codeph">nvidia-smi -h</samp>
for details).
</p>
<div class="note note"><span class="notetitle">Note:</span> Keep in mind that when TCC mode is enabled for a particular
GPU, that GPU <em class="ph i">cannot</em> be used as a display device.
</div>
<div class="note note"><span class="notetitle">Note:</span> NVIDIA GeForce GPUs (excluding GeForce GTX Titan GPUs) do not support TCC mode.
</div>
</div>
</div>
<div class="topic concept nested1" id="verify-installation"><a name="verify-installation" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#verify-installation" name="verify-installation" shape="rect">2.5. Verify the Installation</a></h3>
<div class="body conbody">
<p class="p">Before continuing, it is important to verify that the CUDA toolkit can find and communicate correctly with the CUDA-capable
hardware. To do this, you need to compile and run some of the included sample programs.
</p>
</div>
<div class="topic concept nested2" id="compiling-examples"><a name="compiling-examples" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#compiling-examples" name="compiling-examples" shape="rect">2.5.1. Running the Compiled Examples</a></h3>
<div class="body conbody">
<p class="p">The version of the CUDA Toolkit can be checked by running <samp class="ph codeph">nvcc -V</samp> in a
<span class="keyword wintitle">Command Prompt</span> window. You can display a <span class="keyword wintitle">Command
Prompt</span> window by going to:
</p>
<p class="p"><strong class="ph b">Start > All Programs > Accessories > Command Prompt</strong></p>
<div class="p">CUDA Samples include sample programs in <dfn class="term">source</dfn> form. To verify a correct
configuration of the hardware and software, it is highly recommended that you build and run
the <samp class="ph codeph">deviceQuery</samp> sample program. The sample can be built using the provided VS
solution files, and the compiled executable can be located at:
<pre xml:space="preserve">C:\ProgramData\NVIDIA Corporation\CUDA Samples\v<span class="keyword">10.1</span>\bin\win64\Release</pre></div>
<p class="p">This assumes that you used the default installation directory structure. If CUDA is installed and configured correctly, the
output should look similar to <a class="xref" href="index.html#compiling-examples__valid-results-from-sample-cuda-devicequery-program" shape="rect">Figure 1</a>.
</p>
<div class="fig fignone" id="compiling-examples__valid-results-from-sample-cuda-devicequery-program"><a name="compiling-examples__valid-results-from-sample-cuda-devicequery-program" shape="rect">
<!-- --></a><span class="figcap">Figure 1. Valid Results from deviceQuery CUDA Sample</span><br clear="none"></br><div class="imagecenter"><img class="image imagecenter" src="graphics/valid-results-from-sample-cuda-devicequery-program.png" width="550" alt="Valid Results from deviceQuery CUDA Sample."></img></div><br clear="none"></br></div>
<p class="p">The exact appearance and the output lines might be different on your system. The important outcomes are that a device was
found, that the device(s) match what is installed in your system, and that the test passed.
</p>
<p class="p">If a CUDA-capable device and the CUDA Driver are installed but <samp class="ph codeph">deviceQuery</samp> reports that no CUDA-capable devices are present, ensure the deivce and driver are properly installed.
</p>
<p class="p">Running the <samp class="ph codeph">bandwidthTest</samp> program, located in the same directory as <samp class="ph codeph">deviceQuery</samp> above, ensures that the system and the CUDA-capable device are able to communicate correctly. The output should resemble
<a class="xref" href="index.html#compiling-examples__valid-results-from-sample-cuda-bandwidthtest-program" shape="rect">Figure 2</a>.
</p>
<div class="fig fignone" id="compiling-examples__valid-results-from-sample-cuda-bandwidthtest-program"><a name="compiling-examples__valid-results-from-sample-cuda-bandwidthtest-program" shape="rect">
<!-- --></a><span class="figcap">Figure 2. Valid Results from bandwidthTest CUDA Sample</span><br clear="none"></br><div class="imagecenter"><img class="image imagecenter" src="graphics/valid-results-from-sample-cuda-bandwidthtest-program.png" width="550" alt="Valid Results from bandwidthTest CUDA Sample."></img></div><br clear="none"></br></div>
<p class="p">The device name (second line) and the bandwidth numbers vary from system to system. The important items are the second line,
which confirms a CUDA device was found, and the second-to-last line, which confirms that all necessary tests passed.
</p>
<p class="p">If the tests do not pass, make sure you do have a CUDA-capable NVIDIA GPU on your system and make sure it is properly installed.
</p>
<div class="p">To see a graphical representation of what CUDA can do, run the sample Particles executable at <pre xml:space="preserve">C:\ProgramData\NVIDIA Corporation\CUDA Samples\v<span class="keyword">10.1</span>\bin\win64\Release</pre></div>
</div>
</div>
</div>
</div>
<div class="topic concept nested0" id="compiling-cuda-programs"><a name="compiling-cuda-programs" shape="rect">
<!-- --></a><h2 class="title topictitle1"><a href="#compiling-cuda-programs" name="compiling-cuda-programs" shape="rect">3. Compiling CUDA Programs</a></h2>
<div class="body conbody">
<div class="p">The project files in the CUDA Samples have been designed to provide simple, one-click builds of the programs that include
all source code. To build the Windows projects (for release or debug mode), use the provided <samp class="ph codeph">*.sln</samp> solution files for Microsoft Visual Studio 2010, 2012, or 2013. You can use either the solution files located in each of
the examples directories in
<pre xml:space="preserve">C:\ProgramData\NVIDIA Corporation\CUDA Samples\v<span class="keyword">10.1</span>\<category>\<sample_name></pre>
or the global solution files <samp class="ph codeph">Samples*.sln</samp> located in
<pre xml:space="preserve">C:\ProgramData\NVIDIA Corporation\CUDA Samples\v<span class="keyword">10.1</span></pre></div>
<p class="p">CUDA Samples are organized according to <samp class="ph codeph"><category></samp>. Each sample is organized into one of the following folders: (<samp class="ph codeph">0_Simple</samp>, <samp class="ph codeph">1_Utilities</samp>, <samp class="ph codeph">2_Graphics</samp>, <samp class="ph codeph">3_Imaging</samp>, <samp class="ph codeph">4_Finance</samp>, <samp class="ph codeph">5_Simulations</samp>, <samp class="ph codeph">6_Advanced</samp>, <samp class="ph codeph">7_CUDALibraries</samp>).
</p>
</div>
<div class="topic concept nested1" id="compiling-sample-projects"><a name="compiling-sample-projects" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#compiling-sample-projects" name="compiling-sample-projects" shape="rect">3.1. Compiling Sample Projects</a></h3>
<div class="body conbody">
<p class="p">The <samp class="ph codeph">bandwidthTest</samp> project is a good sample project to build and run. It is
located in the <samp class="ph codeph">NVIDIA Corporation\CUDA
Samples\v<span class="keyword">10.1</span>\1_Utilities\bandwidthTest</samp> directory.
</p>
<p class="p"> If you elected to use the default installation location, the output is placed in <samp class="ph codeph">CUDA Samples\v<span class="keyword">10.1</span>\bin\win64\Release</samp>. Build the program using the appropriate solution file and run the executable. If all works correctly, the output should
be similar to <a class="xref" href="index.html#compiling-examples__valid-results-from-sample-cuda-bandwidthtest-program" shape="rect">Figure 2</a>.
</p>
</div>
</div>
<div class="topic concept nested1" id="sample-projects"><a name="sample-projects" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#sample-projects" name="sample-projects" shape="rect">3.2. Sample Projects</a></h3>
<div class="body conbody">
<p class="p">The sample projects come in two configurations: debug and release (where release contains no debugging information) and different
Visual Studio projects.
</p>
<p class="p">A few of the example projects require some additional setup. The <samp class="ph codeph">simpleD3D9</samp> example requires the system to have a Direct3D SDK (June 2010 or later) installed and the Visual C++ directory paths (located
in <span class="ph menucascade"><span class="ph uicontrol">Tools</span> > <span class="ph uicontrol">Options...</span></span>) properly configured. Consult the Direct3D documentation for additional details.
</p>
<p class="p">These sample projects also make use of the <samp class="ph codeph">$CUDA_PATH</samp> environment variable to locate where the CUDA Toolkit and the associated
<samp class="ph codeph">.props</samp> files are.
</p>
<p class="p">The environment variable is set automatically using the Build Customization <samp class="ph codeph">CUDA <span class="keyword">10.1</span>.props</samp>
file, and is installed automatically as part of the CUDA Toolkit installation process.
</p>
<div class="tablenoborder">
<table cellpadding="4" cellspacing="0" summary="" class="table" frame="border" border="1" rules="all">
<caption><span class="tablecap">Table 4. CUDA Visual Studio .props locations</span></caption>
<thead class="thead" align="left">
<tr class="row">
<th class="entry" align="left" valign="top" width="23.52941176470588%" id="d54e1409" rowspan="1" colspan="1">Visual Studio</th>
<th class="entry" align="left" valign="top" width="76.47058823529412%" id="d54e1412" rowspan="1" colspan="1">CUDA <span class="keyword">10.1</span> .props file Install Directory
</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry" align="left" valign="top" width="23.52941176470588%" headers="d54e1409" rowspan="1" colspan="1">Visual Studio 2010</td>
<td class="entry" align="left" valign="top" width="76.47058823529412%" headers="d54e1412" rowspan="1" colspan="1">C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\BuildCustomizations</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="23.52941176470588%" headers="d54e1409" rowspan="1" colspan="1">Visual Studio 2012</td>
<td class="entry" align="left" valign="top" width="76.47058823529412%" headers="d54e1412" rowspan="1" colspan="1">C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V110\BuildCustomizations</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="23.52941176470588%" headers="d54e1409" rowspan="1" colspan="1">Visual Studio 2013</td>
<td class="entry" align="left" valign="top" width="76.47058823529412%" headers="d54e1412" rowspan="1" colspan="1">C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\BuildCustomizations</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="23.52941176470588%" headers="d54e1409" rowspan="1" colspan="1">Visual Studio 2015</td>
<td class="entry" align="left" valign="top" width="76.47058823529412%" headers="d54e1412" rowspan="1" colspan="1">C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140\BuildCustomizations</td>
</tr>
<tr class="row">
<td class="entry" align="left" valign="top" width="23.52941176470588%" headers="d54e1409" rowspan="1" colspan="1">Visual Studio 2017</td>
<td class="entry" align="left" valign="top" width="76.47058823529412%" headers="d54e1412" rowspan="1" colspan="1"><Visual Studio Install Dir>\Common7\IDE\VC\VCTargets\BuildCustomizations</td>
</tr>
</tbody>
</table>
</div>
<p class="p">You can reference this <samp class="ph codeph">CUDA <span class="keyword">10.1</span>.props</samp> file when building your own CUDA applications.
</p>
</div>
</div>
<div class="topic concept nested1" id="build-customizations"><a name="build-customizations" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#build-customizations" name="build-customizations" shape="rect">3.3. Build Customizations for New Projects</a></h3>
<div class="body conbody">
<p class="p">When creating a new CUDA application, the Visual Studio project file must be configured to include CUDA build customizations.
To accomplish this, click File-> New | Project... NVIDIA-> CUDA->, then select a template for your CUDA Toolkit version. For
example, selecting the "CUDA <span class="keyword">10.1</span> Runtime" template will configure your project for use with the CUDA <span class="keyword">10.1</span> Toolkit. The new project is technically a C++ project (.vcxproj) that is preconfigured to use NVIDIA's Build Customizations.
All standard capabilities of Visual Studio C++ projects will be available.
</p>
<p class="p">To specify a custom CUDA Toolkit location, under <strong class="ph b">CUDA C/C++</strong>, select <strong class="ph b">Common</strong>, and set the <strong class="ph b">CUDA Toolkit Custom Dir</strong> field as desired. Note that the selected toolkit must match the version of the Build Customizations.
</p>
</div>
</div>
<div class="topic concept nested1" id="build-customizations-for-existing-projects"><a name="build-customizations-for-existing-projects" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#build-customizations-for-existing-projects" name="build-customizations-for-existing-projects" shape="rect">3.4. Build Customizations for Existing Projects</a></h3>
<div class="body conbody">
<div class="p">When adding CUDA acceleration to existing applications, the relevant Visual Studio
project files must be updated to include CUDA build customizations.
This can be done using one of the following two methods:
<ol class="ol">
<li class="li">Open the Visual Studio project, right click on the project name, and select
<span class="ph uicontrol">Build Customizations...</span>, then select the CUDA Toolkit
version you would like to target.
</li>
<li class="li">Alternatively, you can configure your project always to build with the most
recently installed version of the CUDA Toolkit. First add a CUDA build
customization to your project as above. Then, right click on the project name
and select <span class="ph uicontrol">Properties</span>. Under <span class="ph uicontrol">CUDA
C/C++</span>, select <span class="ph uicontrol">Common</span>, and set the
<span class="ph uicontrol">CUDA Toolkit Custom Dir</span> field to
<samp class="ph codeph">$(CUDA_PATH)</samp> . Note that the <samp class="ph codeph">$(CUDA_PATH)</samp>
environment variable is set by the installer.
</li>
</ol>
</div>
<p class="p">While Option 2 will allow your project to automatically use any new CUDA Toolkit version
you may install in the future, selecting the toolkit version explicitly as in Option 1
is often better in practice, because if there are new CUDA configuration options added
to the build customization rules accompanying the newer toolkit, you would not see those
new options using Option 2.
</p>
<div class="p">If you use the <samp class="ph codeph">$(CUDA_PATH)</samp> environment variable to target a version of
the CUDA Toolkit for building, and you perform an installation or uninstallation of any
version of the CUDA Toolkit, you should validate that the <samp class="ph codeph">$(CUDA_PATH)</samp>
environment variable points to the correct installation directory of the CUDA Toolkit for
your purposes. You can access the value of the <samp class="ph codeph">$(CUDA_PATH)</samp> environment
variable via the following steps:
<ol class="ol">
<li class="li">
Open a run window from the Start Menu
</li>
<li class="li">
Run: <pre xml:space="preserve">control sysdm.cpl</pre></li>
<li class="li">
Select the "Advanced" tab at the top of the window
</li>
<li class="li">
Click "Environment Variables" at the bottom of the window
</li>
</ol>
</div>
<p class="p">
Files which contain CUDA code must be marked as a <samp class="ph codeph">CUDA C/C++</samp> file. This can done when adding the file by right clicking the project you wish to add the file to, selecting <span class="ph uicontrol">Add\New Item</span>, selecting <span class="ph uicontrol">NVIDIA CUDA <span class="keyword">10.1</span>\Code\CUDA C/C++ File</span>, and then selecting the file you wish to add.
</p>
<div class="p"><strong class="ph b">Note for advanced users:</strong> If you wish to try building your project against a newer
CUDA Toolkit without making changes to any of your project files, go to the Visual
Studio command prompt, change the current directory to the location of your
project, and execute a command such as the following:
<pre xml:space="preserve">msbuild <projectname.extension> /t:Rebuild /p:CudaToolkitDir="drive:/path/to/new/toolkit/"</pre></div>
</div>
</div>
</div>
<div class="topic concept nested0" id="additional-considerations"><a name="additional-considerations" shape="rect">
<!-- --></a><h2 class="title topictitle1"><a href="#additional-considerations" name="additional-considerations" shape="rect">4. Additional Considerations</a></h2>
<div class="body conbody">
<p class="p">Now that you have CUDA-capable hardware and the NVIDIA CUDA Toolkit installed, you can examine and enjoy the numerous included
programs. To begin using CUDA to accelerate the performance of your own applications, consult the <cite class="cite">CUDA C Programming Guide</cite>, located in the CUDA Toolkit documentation directory.
</p>
<p class="p">A number of helpful development tools are included in the CUDA Toolkit or are available for download from the NVIDIA Developer
Zone to assist you as you develop your CUDA programs, such as NVIDIA<sup>®</sup> Nsight™ Visual Studio Edition, NVIDIA Visual Profiler, and cuda-memcheck.
</p>
<p class="p">For technical support on programming questions, consult and participate in the developer forums at <a class="xref" href="http://developer.nvidia.com/cuda/" target="_blank" shape="rect">http://developer.nvidia.com/cuda/</a>.
</p>
</div>
</div>
<div class="topic concept nested0" id="notices-header"><a name="notices-header" shape="rect">
<!-- --></a><h2 class="title topictitle1"><a href="#notices-header" name="notices-header" shape="rect">Notices</a></h2>
<div class="topic reference nested1" id="notice"><a name="notice" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#notice" name="notice" shape="rect"></a></h3>
<div class="body refbody">
<div class="section">
<h3 class="title sectiontitle">Notice</h3>
<p class="p">ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND
SEPARATELY, "MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE
WITH RESPECT TO THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS
FOR A PARTICULAR PURPOSE.
</p>
<p class="p">Information furnished is believed to be accurate and reliable. However, NVIDIA Corporation assumes no responsibility for the
consequences of use of such information or for any infringement of patents or other rights of third parties that may result
from its use. No license is granted by implication of otherwise under any patent rights of NVIDIA Corporation. Specifications
mentioned in this publication are subject to change without notice. This publication supersedes and replaces all other information
previously supplied. NVIDIA Corporation products are not authorized as critical components in life support devices or systems
without express written approval of NVIDIA Corporation.
</p>
</div>
</div>
</div>
<div class="topic reference nested1" id="trademarks"><a name="trademarks" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#trademarks" name="trademarks" shape="rect"></a></h3>
<div class="body refbody">
<div class="section">
<h3 class="title sectiontitle">Trademarks</h3>
<p class="p">NVIDIA and the NVIDIA logo are trademarks or registered trademarks of NVIDIA Corporation
in the U.S. and other countries. Other company and product names may be trademarks of
the respective companies with which they are associated.
</p>
</div>
</div>
</div>
<div class="topic reference nested1" id="copyright-past-to-present"><a name="copyright-past-to-present" shape="rect">
<!-- --></a><h3 class="title topictitle2"><a href="#copyright-past-to-present" name="copyright-past-to-present" shape="rect"></a></h3>
<div class="body refbody">
<div class="section">
<h3 class="title sectiontitle">Copyright</h3>
<p class="p">© <span class="ph">2009</span>-<span class="ph">2019</span> NVIDIA
Corporation. All rights reserved.
</p>
<p class="p">This product includes software developed by the Syncro Soft SRL (http://www.sync.ro/).</p>
</div>
</div>
</div>
</div>
<hr id="contents-end"></hr>
</article>
</div>
</div>
<script language="JavaScript" type="text/javascript" charset="utf-8" src="../common/formatting/common.min.js"></script>
<script language="JavaScript" type="text/javascript" charset="utf-8" src="../common/scripts/google-analytics/google-analytics-write.js"></script>
<script language="JavaScript" type="text/javascript" charset="utf-8" src="../common/scripts/google-analytics/google-analytics-tracker.js"></script>
<script type="text/javascript">var switchTo5x=true;</script><script type="text/javascript" src="http://w.sharethis.com/button/buttons.js"></script><script type="text/javascript">stLight.options({publisher: "998dc202-a267-4d8e-bce9-14debadb8d92", doNotHash: false, doNotCopy: false, hashAddressBar: false});</script><script type="text/javascript">_satellite.pageBottom();</script></body>
</html>
distrib
>
Mageia
>
7
>
x86_64
>
media
>
nonfree-updates
>
by-pkgid
>
b86a85131cc739c1c53d0b55840a4328
>
files
>
1455
