<!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="cppModule"></meta>
<meta name="DC.Title" content="Module Management"></meta>
<meta name="abstract" content=""></meta>
<meta name="description" content=""></meta>
<meta name="DC.Format" content="XHTML"></meta>
<meta name="DC.Identifier" content="group__CUDA__MODULE"></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>CUDA Driver API :: 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="../common/scripts/tynt/tynt.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-driver-api/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
v6.5</a></div>
<div class="category"><a href="index.html" title="CUDA Driver API">CUDA Driver API</a></div>
<ul>
<li>
<div class="section-link"><a href="api-sync-behavior.html#api-sync-behavior">1. API synchronization behavior </a></div>
</li>
<li>
<div class="section-link"><a href="stream-sync-behavior.html#stream-sync-behavior">2. Stream synchronization behavior</a></div>
</li>
<li>
<div class="section-link"><a href="modules.html#modules">3. Modules</a></div>
<ul>
<li>
<div class="section-link"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES">3.1. Data types used by CUDA driver</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__ERROR.html#group__CUDA__ERROR">3.2. Error Handling</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__INITIALIZE.html#group__CUDA__INITIALIZE">3.3. Initialization</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__VERSION.html#group__CUDA__VERSION">3.4. Version Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__DEVICE.html#group__CUDA__DEVICE">3.5. Device Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__DEVICE__DEPRECATED.html#group__CUDA__DEVICE__DEPRECATED">3.6. Device Management [DEPRECATED]</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__CTX.html#group__CUDA__CTX">3.7. Context Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__CTX__DEPRECATED.html#group__CUDA__CTX__DEPRECATED">3.8. Context Management [DEPRECATED]</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__MODULE.html#group__CUDA__MODULE">3.9. Module Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__MEM.html#group__CUDA__MEM">3.10. Memory Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__UNIFIED.html#group__CUDA__UNIFIED">3.11. Unified Addressing</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__STREAM.html#group__CUDA__STREAM">3.12. Stream Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__EVENT.html#group__CUDA__EVENT">3.13. Event Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__EXEC.html#group__CUDA__EXEC">3.14. Execution Control</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__EXEC__DEPRECATED.html#group__CUDA__EXEC__DEPRECATED">3.15. Execution Control [DEPRECATED]</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__OCCUPANCY.html#group__CUDA__OCCUPANCY">3.16. Occupancy</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__TEXREF.html#group__CUDA__TEXREF">3.17. Texture Reference Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__TEXREF__DEPRECATED.html#group__CUDA__TEXREF__DEPRECATED">3.18. Texture Reference Management [DEPRECATED]</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__SURFREF.html#group__CUDA__SURFREF">3.19. Surface Reference Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__TEXOBJECT.html#group__CUDA__TEXOBJECT">3.20. Texture Object Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__SURFOBJECT.html#group__CUDA__SURFOBJECT">3.21. Surface Object Management</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__PEER__ACCESS.html#group__CUDA__PEER__ACCESS">3.22. Peer Context Memory Access</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__GRAPHICS.html#group__CUDA__GRAPHICS">3.23. Graphics Interoperability</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__PROFILER.html#group__CUDA__PROFILER">3.24. Profiler Control</a></div>
</li>
<li>
<div class="section-link"><a href="group__CUDA__GL.html#group__CUDA__GL">3.25. OpenGL Interoperability</a></div>
<ul>
<li>
<div class="section-link"><a href="group__CUDA__GL__DEPRECATED.html#group__CUDA__GL__DEPRECATED">3.25.1. OpenGL Interoperability [DEPRECATED]</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="group__CUDA__D3D9.html#group__CUDA__D3D9">3.26. Direct3D 9 Interoperability</a></div>
<ul>
<li>
<div class="section-link"><a href="group__CUDA__D3D9__DEPRECATED.html#group__CUDA__D3D9__DEPRECATED">3.26.1. Direct3D 9 Interoperability [DEPRECATED]</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="group__CUDA__D3D10.html#group__CUDA__D3D10">3.27. Direct3D 10 Interoperability</a></div>
<ul>
<li>
<div class="section-link"><a href="group__CUDA__D3D10__DEPRECATED.html#group__CUDA__D3D10__DEPRECATED">3.27.1. Direct3D 10 Interoperability [DEPRECATED]</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="group__CUDA__D3D11.html#group__CUDA__D3D11">3.28. Direct3D 11 Interoperability</a></div>
<ul>
<li>
<div class="section-link"><a href="group__CUDA__D3D11__DEPRECATED.html#group__CUDA__D3D11__DEPRECATED">3.28.1. Direct3D 11 Interoperability [DEPRECATED]</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="group__CUDA__VDPAU.html#group__CUDA__VDPAU">3.29. VDPAU Interoperability</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="annotated.html#annotated">4. Data Structures</a></div>
<ul>
<li>
<div class="section-link"><a href="structCUDA__ARRAY3D__DESCRIPTOR.html#structCUDA__ARRAY3D__DESCRIPTOR">4.1. CUDA_ARRAY3D_DESCRIPTOR</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__ARRAY__DESCRIPTOR.html#structCUDA__ARRAY__DESCRIPTOR">4.2. CUDA_ARRAY_DESCRIPTOR</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__MEMCPY2D.html#structCUDA__MEMCPY2D">4.3. CUDA_MEMCPY2D</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__MEMCPY3D.html#structCUDA__MEMCPY3D">4.4. CUDA_MEMCPY3D</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__MEMCPY3D__PEER.html#structCUDA__MEMCPY3D__PEER">4.5. CUDA_MEMCPY3D_PEER</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__POINTER__ATTRIBUTE__P2P__TOKENS.html#structCUDA__POINTER__ATTRIBUTE__P2P__TOKENS">4.6. CUDA_POINTER_ATTRIBUTE_P2P_TOKENS</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__RESOURCE__DESC.html#structCUDA__RESOURCE__DESC">4.7. CUDA_RESOURCE_DESC</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__RESOURCE__VIEW__DESC.html#structCUDA__RESOURCE__VIEW__DESC">4.8. CUDA_RESOURCE_VIEW_DESC</a></div>
</li>
<li>
<div class="section-link"><a href="structCUDA__TEXTURE__DESC.html#structCUDA__TEXTURE__DESC">4.9. CUDA_TEXTURE_DESC</a></div>
</li>
<li>
<div class="section-link"><a href="structCUdevprop.html#structCUdevprop">4.10. CUdevprop</a></div>
</li>
<li>
<div class="section-link"><a href="structCUipcEventHandle.html#structCUipcEventHandle">4.11. CUipcEventHandle</a></div>
</li>
<li>
<div class="section-link"><a href="structCUipcMemHandle.html#structCUipcMemHandle">4.12. CUipcMemHandle</a></div>
</li>
</ul>
</li>
<li>
<div class="section-link"><a href="functions.html#functions">5. Data Fields</a></div>
</li>
<li>
<div class="section-link"><a href="deprecated.html#deprecated">6. Deprecated List</a></div>
</li>
<li>
<div class="section-link"><a href="notices-header.html#notices-header">Notices</a></div>
<ul></ul>
</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="breadcrumbs"><a href="group__CUDA__CTX__DEPRECATED.html" shape="rect">< Previous</a> | <a href="group__CUDA__MEM.html" shape="rect">Next ></a></div>
<div id="release-info">CUDA Driver API
(<a href="../../pdf/CUDA_Driver_API.pdf">PDF</a>)
-
v6.5
(<a href="https://developer.nvidia.com/cuda-toolkit-archive">older</a>)
-
Last updated August 1, 2014
-
<a href="mailto:cudatools@nvidia.com?subject=CUDA Toolkit Documentation Feedback: CUDA Driver API">Send Feedback</a>
-
<span class="st_facebook"></span><span class="st_twitter"></span><span class="st_linkedin"></span><span class="st_reddit"></span><span class="st_slashdot"></span><span class="st_tumblr"></span><span class="st_sharethis"></span></div>
</div>
<article id="contents">
<div class="topic reference apiRef apiPackage cppModule" id="group__CUDA__MODULE"><a name="group__CUDA__MODULE" shape="rect">
<!-- --></a><h2 class="topictitle2 cppModule">3.9. Module Management</h2>
<div class="section">
<p>This section describes the module management functions of the low-level CUDA driver application programming interface. </p>
</div>
<h3 class="fake_sectiontitle member_header">Functions</h3>
<dl class="members">
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g3ebcd2ccb772ba9c120937a2d2831b77" shape="rect">cuLinkAddData</a> ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc78e5cb421c428676861189048888958" title="" shape="rect">CUjitInputType</a><span> </span><span class="keyword keyword apiItemName">type</span>, void*<span> </span><span class="keyword keyword apiItemName">data</span>, size_t<span> </span><span class="keyword keyword apiItemName">size</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span>, unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Add an input to a pending linker invocation. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g1224c0fd48d4a683f3ce19997f200a8c" shape="rect">cuLinkAddFile</a> ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc78e5cb421c428676861189048888958" title="" shape="rect">CUjitInputType</a><span> </span><span class="keyword keyword apiItemName">type</span>, const char*<span> </span><span class="keyword keyword apiItemName">path</span>, unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Add a file input to a pending linker invocation. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g818fcd84a4150a997c0bba76fef4e716" shape="rect">cuLinkComplete</a> ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span>, void**<span> </span><span class="keyword keyword apiItemName">cubinOut</span>, size_t*<span> </span><span class="keyword keyword apiItemName">sizeOut</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Complete a pending linker invocation. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" shape="rect">cuLinkCreate</a> ( unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span>, CUlinkState*<span> </span><span class="keyword keyword apiItemName">stateOut</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Creates a pending JIT linker invocation. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" shape="rect">cuLinkDestroy</a> ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Destroys state for a JIT linker invocation. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" shape="rect">cuModuleGetFunction</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gba6128b948022f495706d93bc2cea9c8" title="" shape="rect">CUfunction</a>*<span> </span><span class="keyword keyword apiItemName">hfunc</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Returns a function handle. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" shape="rect">cuModuleGetGlobal</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5e264ce2ad6a38761e7e04921ef771de" title="" shape="rect">CUdeviceptr</a>*<span> </span><span class="keyword keyword apiItemName">dptr</span>, size_t*<span> </span><span class="keyword keyword apiItemName">bytes</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Returns a global pointer from a module. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g71c19dab9374e8481d8d8629a77377b1" shape="rect">cuModuleGetSurfRef</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g7b99472b414f10b2c04dd2530dc7ea76" title="" shape="rect">CUsurfref</a>*<span> </span><span class="keyword keyword apiItemName">pSurfRef</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Returns a handle to a surface reference. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" shape="rect">cuModuleGetTexRef</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gec1e8eb9dc48ad748765d1fcc020d6b5" title="" shape="rect">CUtexref</a>*<span> </span><span class="keyword keyword apiItemName">pTexRef</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Returns a handle to a texture reference. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" shape="rect">cuModuleLoad</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const char*<span> </span><span class="keyword keyword apiItemName">fname</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Loads a compute module. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" shape="rect">cuModuleLoadData</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const void*<span> </span><span class="keyword keyword apiItemName">image</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Load a module's data. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" shape="rect">cuModuleLoadDataEx</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const void*<span> </span><span class="keyword keyword apiItemName">image</span>, unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Load a module's data with options. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" shape="rect">cuModuleLoadFatBinary</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const void*<span> </span><span class="keyword keyword apiItemName">fatCubin</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Load a module's data. </span></dd>
<dt><span class="member_type"><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> </span><span class="member_name"><a href="#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" shape="rect">cuModuleUnload</a> ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span> ) </span></dt>
<dd class="shortdesc"><span></span><span class="desc">Unloads a module. </span></dd>
</dl>
<div class="description">
<h3 class="sectiontitle">Functions</h3>
<dl class="description">
<dt class="description"><a name="group__CUDA__MODULE_1g3ebcd2ccb772ba9c120937a2d2831b77" id="group__CUDA__MODULE_1g3ebcd2ccb772ba9c120937a2d2831b77" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuLinkAddData ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc78e5cb421c428676861189048888958" title="" shape="rect">CUjitInputType</a><span> </span><span class="keyword keyword apiItemName">type</span>, void*<span> </span><span class="keyword keyword apiItemName">data</span>, size_t<span> </span><span class="keyword keyword apiItemName">size</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span>, unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span> ) </span></dt>
<dd class="description">
<div class="section">Add an input to a pending linker invocation. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">state</span></tt></dt>
<dd>A pending linker action. </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">type</span></tt></dt>
<dd>The type of the input data. </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">data</span></tt></dt>
<dd>The input data. PTX must be NULL-terminated. </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">size</span></tt></dt>
<dd>The length of the input data. </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">name</span></tt></dt>
<dd>An optional name for this input in log messages. </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">numOptions</span></tt></dt>
<dd>Size of options. </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">options</span></tt></dt>
<dd>Options to be applied only for this input (overrides options from <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" title="Creates a pending JIT linker invocation." shape="rect">cuLinkCreate</a>).
</dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">optionValues</span></tt></dt>
<dd>Array of option values, each cast to void *.</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e90fd2e63260c6317ba943af0f7e4b8d21" shape="rect">CUDA_ERROR_INVALID_HANDLE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e90b7bd1dd2fb3491c588ce569c02d1a2f" shape="rect">CUDA_ERROR_INVALID_IMAGE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a5bb7f216af3efbea2116ff18253b1a3" shape="rect">CUDA_ERROR_INVALID_PTX</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e94ef545ed5f461db9351f98de98497abf" shape="rect">CUDA_ERROR_NO_BINARY_FOR_GPU</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Ownership of <tt class="ph tt code">data</tt> is retained by the caller. No reference is retained to any inputs after this call returns.
</p>
<p class="p">This method accepts only compiler options, which are used if the data must be compiled from PTX, and does not accept any of
<a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997df326f19e67f00768bff8849a8dc5def5" shape="rect">CU_JIT_WALL_TIME</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d0cfba79ec44e0480a78b132ff158c0ae" shape="rect">CU_JIT_INFO_LOG_BUFFER</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997da770301a8ec6fdfb9abcbd60100beb3c" shape="rect">CU_JIT_ERROR_LOG_BUFFER</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d8e9b9dfcc1ad8fb0f89bbfb04f46e988" shape="rect">CU_JIT_TARGET_FROM_CUCONTEXT</a>, or <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d3bf12ddeaa2a9d64db4d20de537cd596" shape="rect">CU_JIT_TARGET</a>.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" title="Creates a pending JIT linker invocation." shape="rect">cuLinkCreate</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g1224c0fd48d4a683f3ce19997f200a8c" title="Add a file input to a pending linker invocation." shape="rect">cuLinkAddFile</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g818fcd84a4150a997c0bba76fef4e716" title="Complete a pending linker invocation." shape="rect">cuLinkComplete</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" title="Destroys state for a JIT linker invocation." shape="rect">cuLinkDestroy</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g1224c0fd48d4a683f3ce19997f200a8c" id="group__CUDA__MODULE_1g1224c0fd48d4a683f3ce19997f200a8c" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuLinkAddFile ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc78e5cb421c428676861189048888958" title="" shape="rect">CUjitInputType</a><span> </span><span class="keyword keyword apiItemName">type</span>, const char*<span> </span><span class="keyword keyword apiItemName">path</span>, unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span> ) </span></dt>
<dd class="description">
<div class="section">Add a file input to a pending linker invocation. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">state</span></tt></dt>
<dd>A pending linker action </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">type</span></tt></dt>
<dd>The type of the input data </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">path</span></tt></dt>
<dd>Path to the input file </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">numOptions</span></tt></dt>
<dd>Size of options </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">options</span></tt></dt>
<dd>Options to be applied only for this input (overrides options from <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" title="Creates a pending JIT linker invocation." shape="rect">cuLinkCreate</a>)
</dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">optionValues</span></tt></dt>
<dd>Array of option values, each cast to void *</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e93c20ccb3e24d5bf65625b1212fd8f4aa" shape="rect">CUDA_ERROR_FILE_NOT_FOUND</a><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e90fd2e63260c6317ba943af0f7e4b8d21" shape="rect">CUDA_ERROR_INVALID_HANDLE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e90b7bd1dd2fb3491c588ce569c02d1a2f" shape="rect">CUDA_ERROR_INVALID_IMAGE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a5bb7f216af3efbea2116ff18253b1a3" shape="rect">CUDA_ERROR_INVALID_PTX</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e94ef545ed5f461db9351f98de98497abf" shape="rect">CUDA_ERROR_NO_BINARY_FOR_GPU</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>No reference is retained to any inputs after this call returns.</p>
<p class="p">This method accepts only compiler options, which are used if the input must be compiled from PTX, and does not accept any
of <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997df326f19e67f00768bff8849a8dc5def5" shape="rect">CU_JIT_WALL_TIME</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d0cfba79ec44e0480a78b132ff158c0ae" shape="rect">CU_JIT_INFO_LOG_BUFFER</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997da770301a8ec6fdfb9abcbd60100beb3c" shape="rect">CU_JIT_ERROR_LOG_BUFFER</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d8e9b9dfcc1ad8fb0f89bbfb04f46e988" shape="rect">CU_JIT_TARGET_FROM_CUCONTEXT</a>, or <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d3bf12ddeaa2a9d64db4d20de537cd596" shape="rect">CU_JIT_TARGET</a>.
</p>
<p class="p">This method is equivalent to invoking <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g3ebcd2ccb772ba9c120937a2d2831b77" title="Add an input to a pending linker invocation." shape="rect">cuLinkAddData</a> on the contents of the file.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" title="Creates a pending JIT linker invocation." shape="rect">cuLinkCreate</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g3ebcd2ccb772ba9c120937a2d2831b77" title="Add an input to a pending linker invocation." shape="rect">cuLinkAddData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g818fcd84a4150a997c0bba76fef4e716" title="Complete a pending linker invocation." shape="rect">cuLinkComplete</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" title="Destroys state for a JIT linker invocation." shape="rect">cuLinkDestroy</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g818fcd84a4150a997c0bba76fef4e716" id="group__CUDA__MODULE_1g818fcd84a4150a997c0bba76fef4e716" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuLinkComplete ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span>, void**<span> </span><span class="keyword keyword apiItemName">cubinOut</span>, size_t*<span> </span><span class="keyword keyword apiItemName">sizeOut</span> ) </span></dt>
<dd class="description">
<div class="section">Complete a pending linker invocation. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">state</span></tt></dt>
<dd>A pending linker invocation </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">cubinOut</span></tt></dt>
<dd>On success, this will point to the output image </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">sizeOut</span></tt></dt>
<dd>Optional parameter to receive the size of the generated image</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e90fd2e63260c6317ba943af0f7e4b8d21" shape="rect">CUDA_ERROR_INVALID_HANDLE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Completes the pending linker action and returns the cubin image for the linked device code, which can be used with <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>. The cubin is owned by <tt class="ph tt code">state</tt>, so it should be loaded before <tt class="ph tt code">state</tt> is destroyed via <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" title="Destroys state for a JIT linker invocation." shape="rect">cuLinkDestroy</a>. This call does not destroy <tt class="ph tt code">state</tt>.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" title="Creates a pending JIT linker invocation." shape="rect">cuLinkCreate</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g3ebcd2ccb772ba9c120937a2d2831b77" title="Add an input to a pending linker invocation." shape="rect">cuLinkAddData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g1224c0fd48d4a683f3ce19997f200a8c" title="Add a file input to a pending linker invocation." shape="rect">cuLinkAddFile</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" title="Destroys state for a JIT linker invocation." shape="rect">cuLinkDestroy</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" id="group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuLinkCreate ( unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span>, CUlinkState*<span> </span><span class="keyword keyword apiItemName">stateOut</span> ) </span></dt>
<dd class="description">
<div class="section">Creates a pending JIT linker invocation. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">numOptions</span></tt></dt>
<dd>Size of options arrays </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">options</span></tt></dt>
<dd>Array of linker and compiler options </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">optionValues</span></tt></dt>
<dd>Array of option values, each cast to void * </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">stateOut</span></tt></dt>
<dd>On success, this will contain a CUlinkState to specify and complete this action</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>If the call is successful, the caller owns the returned CUlinkState, which should eventually be destroyed with <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" title="Destroys state for a JIT linker invocation." shape="rect">cuLinkDestroy</a>. The device code machine size (32 or 64 bit) will match the calling application.
</p>
<p class="p">Both linker and compiler options may be specified. Compiler options will be applied to inputs to this linker action which
must be compiled from PTX. The options <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997df326f19e67f00768bff8849a8dc5def5" shape="rect">CU_JIT_WALL_TIME</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d8dc284de594cc1504db521869ad47cd9" shape="rect">CU_JIT_INFO_LOG_BUFFER_SIZE_BYTES</a>, and <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gg5527fa8030d5cabedc781a04dbd1997d4e5c6eb78ba970a0b1683ac040044811" shape="rect">CU_JIT_ERROR_LOG_BUFFER_SIZE_BYTES</a> will accumulate data until the CUlinkState is destroyed.
</p>
<p class="p"><tt class="ph tt code">optionValues</tt> must remain valid for the life of the CUlinkState if output options are used. No other references to inputs are maintained
after this call returns.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g3ebcd2ccb772ba9c120937a2d2831b77" title="Add an input to a pending linker invocation." shape="rect">cuLinkAddData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g1224c0fd48d4a683f3ce19997f200a8c" title="Add a file input to a pending linker invocation." shape="rect">cuLinkAddFile</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g818fcd84a4150a997c0bba76fef4e716" title="Complete a pending linker invocation." shape="rect">cuLinkComplete</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" title="Destroys state for a JIT linker invocation." shape="rect">cuLinkDestroy</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" id="group__CUDA__MODULE_1g01b7ae2a34047b05716969af245ce2d9" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuLinkDestroy ( CUlinkState<span> </span><span class="keyword keyword apiItemName">state</span> ) </span></dt>
<dd class="description">
<div class="section">Destroys state for a JIT linker invocation. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">state</span></tt></dt>
<dd>State object for the linker invocation</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e90fd2e63260c6317ba943af0f7e4b8d21" shape="rect">CUDA_ERROR_INVALID_HANDLE</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p></p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g86ca4052a2fab369cb943523908aa80d" title="Creates a pending JIT linker invocation." shape="rect">cuLinkCreate</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" id="group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleGetFunction ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gba6128b948022f495706d93bc2cea9c8" title="" shape="rect">CUfunction</a>*<span> </span><span class="keyword keyword apiItemName">hfunc</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="description">
<div class="section">Returns a function handle. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">hfunc</span></tt></dt>
<dd>- Returned function handle </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">hmod</span></tt></dt>
<dd>- Module to retrieve function from </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">name</span></tt></dt>
<dd>- Name of function to retrieve</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Returns in <tt class="ph tt code">*hfunc</tt> the handle of the function of name <tt class="ph tt code">name</tt> located in module <tt class="ph tt code">hmod</tt>. If no function of that name exists, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction()</a> returns <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a>.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" id="group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleGetGlobal ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5e264ce2ad6a38761e7e04921ef771de" title="" shape="rect">CUdeviceptr</a>*<span> </span><span class="keyword keyword apiItemName">dptr</span>, size_t*<span> </span><span class="keyword keyword apiItemName">bytes</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="description">
<div class="section">Returns a global pointer from a module. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">dptr</span></tt></dt>
<dd>- Returned global device pointer </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">bytes</span></tt></dt>
<dd>- Returned global size in bytes </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">hmod</span></tt></dt>
<dd>- Module to retrieve global from </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">name</span></tt></dt>
<dd>- Name of global to retrieve</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Returns in <tt class="ph tt code">*dptr</tt> and <tt class="ph tt code">*bytes</tt> the base pointer and size of the global of name <tt class="ph tt code">name</tt> located in module <tt class="ph tt code">hmod</tt>. If no variable of that name exists, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal()</a> returns <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a>. Both parameters <tt class="ph tt code">dptr</tt> and <tt class="ph tt code">bytes</tt> are optional. If one of them is NULL, it is ignored.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g71c19dab9374e8481d8d8629a77377b1" id="group__CUDA__MODULE_1g71c19dab9374e8481d8d8629a77377b1" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleGetSurfRef ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g7b99472b414f10b2c04dd2530dc7ea76" title="" shape="rect">CUsurfref</a>*<span> </span><span class="keyword keyword apiItemName">pSurfRef</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="description">
<div class="section">Returns a handle to a surface reference. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">pSurfRef</span></tt></dt>
<dd>- Returned surface reference </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">hmod</span></tt></dt>
<dd>- Module to retrieve surface reference from </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">name</span></tt></dt>
<dd>- Name of surface reference to retrieve</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Returns in <tt class="ph tt code">*pSurfRef</tt> the handle of the surface reference of name <tt class="ph tt code">name</tt> in the module <tt class="ph tt code">hmod</tt>. If no surface reference of that name exists, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g71c19dab9374e8481d8d8629a77377b1" title="Returns a handle to a surface reference." shape="rect">cuModuleGetSurfRef()</a> returns <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a>.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" id="group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleGetTexRef ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gec1e8eb9dc48ad748765d1fcc020d6b5" title="" shape="rect">CUtexref</a>*<span> </span><span class="keyword keyword apiItemName">pTexRef</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span>, const char*<span> </span><span class="keyword keyword apiItemName">name</span> ) </span></dt>
<dd class="description">
<div class="section">Returns a handle to a texture reference. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">pTexRef</span></tt></dt>
<dd>- Returned texture reference </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">hmod</span></tt></dt>
<dd>- Module to retrieve texture reference from </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">name</span></tt></dt>
<dd>- Name of texture reference to retrieve</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Returns in <tt class="ph tt code">*pTexRef</tt> the handle of the texture reference of name <tt class="ph tt code">name</tt> in the module <tt class="ph tt code">hmod</tt>. If no texture reference of that name exists, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef()</a> returns <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a>. This texture reference handle should not be destroyed, since it will be destroyed when the module is unloaded.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g71c19dab9374e8481d8d8629a77377b1" title="Returns a handle to a surface reference." shape="rect">cuModuleGetSurfRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" id="group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleLoad ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const char*<span> </span><span class="keyword keyword apiItemName">fname</span> ) </span></dt>
<dd class="description">
<div class="section">Loads a compute module. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">module</span></tt></dt>
<dd>- Returned module </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">fname</span></tt></dt>
<dd>- Filename of module to load</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a5bb7f216af3efbea2116ff18253b1a3" shape="rect">CUDA_ERROR_INVALID_PTX</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e93c20ccb3e24d5bf65625b1212fd8f4aa" shape="rect">CUDA_ERROR_FILE_NOT_FOUND</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e94ef545ed5f461db9351f98de98497abf" shape="rect">CUDA_ERROR_NO_BINARY_FOR_GPU</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e95ab6c0086a6130b5b895ff15ce841ee6" shape="rect">CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9d8a149ebc98aa90f6417e531fa645043" shape="rect">CUDA_ERROR_SHARED_OBJECT_INIT_FAILED</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Takes a filename <tt class="ph tt code">fname</tt> and loads the corresponding module <tt class="ph tt code">module</tt> into the current context. The CUDA driver API does not attempt to lazily allocate the resources needed by a module; if the
memory for functions and data (constant and global) needed by the module cannot be allocated, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad()</a> fails. The file should be a cubin file as output by <strong class="ph b">nvcc</strong>, or a PTX file either as output by <strong class="ph b">nvcc</strong> or handwritten, or a fatbin file as output by <strong class="ph b">nvcc</strong> from toolchain 4.0 or later.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" id="group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleLoadData ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const void*<span> </span><span class="keyword keyword apiItemName">image</span> ) </span></dt>
<dd class="description">
<div class="section">Load a module's data. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">module</span></tt></dt>
<dd>- Returned module </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">image</span></tt></dt>
<dd>- Module data to load</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a5bb7f216af3efbea2116ff18253b1a3" shape="rect">CUDA_ERROR_INVALID_PTX</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e94ef545ed5f461db9351f98de98497abf" shape="rect">CUDA_ERROR_NO_BINARY_FOR_GPU</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e95ab6c0086a6130b5b895ff15ce841ee6" shape="rect">CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9d8a149ebc98aa90f6417e531fa645043" shape="rect">CUDA_ERROR_SHARED_OBJECT_INIT_FAILED</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Takes a pointer <tt class="ph tt code">image</tt> and loads the corresponding module <tt class="ph tt code">module</tt> into the current context. The pointer may be obtained by mapping a cubin or PTX or fatbin file, passing a cubin or PTX or
fatbin file as a NULL-terminated text string, or incorporating a cubin or fatbin object into the executable resources and
using operating system calls such as Windows <tt class="ph tt code">FindResource()</tt> to obtain the pointer.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" id="group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleLoadDataEx ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const void*<span> </span><span class="keyword keyword apiItemName">image</span>, unsigned int <span> </span><span class="keyword keyword apiItemName">numOptions</span>, <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g5527fa8030d5cabedc781a04dbd1997d" title="" shape="rect">CUjit_option</a>*<span> </span><span class="keyword keyword apiItemName">options</span>, void**<span> </span><span class="keyword keyword apiItemName">optionValues</span> ) </span></dt>
<dd class="description">
<div class="section">Load a module's data with options. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">module</span></tt></dt>
<dd>- Returned module </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">image</span></tt></dt>
<dd>- Module data to load </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">numOptions</span></tt></dt>
<dd>- Number of options </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">options</span></tt></dt>
<dd>- Options for JIT </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">optionValues</span></tt></dt>
<dd>- Option values for JIT</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a5bb7f216af3efbea2116ff18253b1a3" shape="rect">CUDA_ERROR_INVALID_PTX</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e94ef545ed5f461db9351f98de98497abf" shape="rect">CUDA_ERROR_NO_BINARY_FOR_GPU</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e95ab6c0086a6130b5b895ff15ce841ee6" shape="rect">CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9d8a149ebc98aa90f6417e531fa645043" shape="rect">CUDA_ERROR_SHARED_OBJECT_INIT_FAILED</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Takes a pointer <tt class="ph tt code">image</tt> and loads the corresponding module <tt class="ph tt code">module</tt> into the current context. The pointer may be obtained by mapping a cubin or PTX or fatbin file, passing a cubin or PTX or
fatbin file as a NULL-terminated text string, or incorporating a cubin or fatbin object into the executable resources and
using operating system calls such as Windows <tt class="ph tt code">FindResource()</tt> to obtain the pointer. Options are passed as an array via <tt class="ph tt code">options</tt> and any corresponding parameters are passed in <tt class="ph tt code">optionValues</tt>. The number of total options is supplied via <tt class="ph tt code">numOptions</tt>. Any outputs will be returned via <tt class="ph tt code">optionValues</tt>.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" id="group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleLoadFatBinary ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a>*<span> </span><span class="keyword keyword apiItemName">module</span>, const void*<span> </span><span class="keyword keyword apiItemName">fatCubin</span> ) </span></dt>
<dd class="description">
<div class="section">Load a module's data. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">module</span></tt></dt>
<dd>- Returned module </dd>
<dt><tt class="code"><span class="keyword keyword apiItemName">fatCubin</span></tt></dt>
<dd>- Fat binary to load</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a5bb7f216af3efbea2116ff18253b1a3" shape="rect">CUDA_ERROR_INVALID_PTX</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9af1cadbeb21d3a78115ca211ba44c053" shape="rect">CUDA_ERROR_NOT_FOUND</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9264c50688ed110e8476b591befe60c02" shape="rect">CUDA_ERROR_OUT_OF_MEMORY</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e94ef545ed5f461db9351f98de98497abf" shape="rect">CUDA_ERROR_NO_BINARY_FOR_GPU</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e95ab6c0086a6130b5b895ff15ce841ee6" shape="rect">CUDA_ERROR_SHARED_OBJECT_SYMBOL_NOT_FOUND</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9d8a149ebc98aa90f6417e531fa645043" shape="rect">CUDA_ERROR_SHARED_OBJECT_INIT_FAILED</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Takes a pointer <tt class="ph tt code">fatCubin</tt> and loads the corresponding module <tt class="ph tt code">module</tt> into the current context. The pointer represents a fat binary object, which is a collection of different cubin and/or PTX
files, all representing the same device code, but compiled and optimized for different architectures.
</p>
<p class="p">Prior to CUDA 4.0, there was no documented API for constructing and using fat binary objects by programmers. Starting with
CUDA 4.0, fat binary objects can be constructed by providing the -fatbin option to <strong class="ph b">nvcc</strong>. More information can be found in the <strong class="ph b">nvcc</strong> document.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" title="Unloads a module." shape="rect">cuModuleUnload</a></p>
<p class="p"></p>
</div>
</dd>
<dt class="description"><a name="group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" id="group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b" shape="rect">
<!-- --></a><span><a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1gc6c391505e117393cc2558fff6bfc2e9" title="" shape="rect">CUresult</a> cuModuleUnload ( <a href="group__CUDA__TYPES.html#group__CUDA__TYPES_1g9e4ef4dcfba4662b2299acb8d049a1ef" title="" shape="rect">CUmodule</a><span> </span><span class="keyword keyword apiItemName">hmod</span> ) </span></dt>
<dd class="description">
<div class="section">Unloads a module. </div>
<div class="section">
<h6 class="parameter_header">
Parameters
</h6>
<dl class="table-display-params">
<dt><tt class="code"><span class="keyword keyword apiItemName">hmod</span></tt></dt>
<dd>- Module to unload</dd>
</dl>
</div>
<div class="section">
<h6 class="return_header">Returns</h6>
<p class="return"><a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a0eed720f8a87cd1c5fd1c453bc7a03d" shape="rect">CUDA_SUCCESS</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9acf52f132faf29b473cdda6061f0f44a" shape="rect">CUDA_ERROR_DEINITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e98feb999f0af99b4a25ab26b3866f4df8" shape="rect">CUDA_ERROR_NOT_INITIALIZED</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e9a484e9af32c1e9893ff21f0e0191a12d" shape="rect">CUDA_ERROR_INVALID_CONTEXT</a>, <a class="xref" href="group__CUDA__TYPES.html#group__CUDA__TYPES_1ggc6c391505e117393cc2558fff6bfc2e990696c86fcee1f536a1ec7d25867feeb" shape="rect">CUDA_ERROR_INVALID_VALUE</a></p>
</div>
<div class="section">
<h6 class="description_header">Description</h6>
<p>Unloads a module <tt class="ph tt code">hmod</tt> from the current context.
</p>
<p class="p"></p>
<p class="p"></p>
<p class="p">
<div class="note note"><span class="notetitle">Note:</span><p class="p">Note that this function may also return error codes from previous, asynchronous launches.</p>
</div>
</p>
<p class="p"></p>
<p class="p apiDesc_subtitle"><strong class="ph b">See also:</strong></p>
<p class="p see_subsection"><a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1ga52be009b0d4045811b30c965e1cb2cf" title="Returns a function handle." shape="rect">cuModuleGetFunction</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1gf3e43672e26073b1081476dbf47a86ab" title="Returns a global pointer from a module." shape="rect">cuModuleGetGlobal</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9607dcbf911c16420d5264273f2b5608" title="Returns a handle to a texture reference." shape="rect">cuModuleGetTexRef</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3" title="Loads a compute module." shape="rect">cuModuleLoad</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b" title="Load a module's data." shape="rect">cuModuleLoadData</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12" title="Load a module's data with options." shape="rect">cuModuleLoadDataEx</a>, <a class="xref" href="group__CUDA__MODULE.html#group__CUDA__MODULE_1g13a2292b6819f8f86127768334436c3b" title="Load a module's data." shape="rect">cuModuleLoadFatBinary</a></p>
<p class="p"></p>
</div>
</dd>
</dl>
</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></body>
</html>
distrib
>
Mageia
>
5
>
x86_64
>
media
>
nonfree-release
>
by-pkgid
>
d44b02ea46d82d6a48df31bbd1a088f3
>
files
>
1086
