]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Document CUDA::Handle better 7460/head
authorDaniel Arndt <daniel.arndt@iwr.uni-heidelberg.de>
Tue, 20 Nov 2018 22:03:45 +0000 (23:03 +0100)
committerDaniel Arndt <daniel.arndt@iwr.uni-heidelberg.de>
Tue, 20 Nov 2018 22:19:25 +0000 (23:19 +0100)
include/deal.II/base/cuda.h

index ad74e992849dbb461ee541ad330cba319f3d7076..0e6eafbb7b31286bd1cc04a2f2b0f8599972c045 100644 (file)
@@ -36,13 +36,14 @@ namespace Utilities
   namespace CUDA
   {
     /**
-     * This structure creates, stores, and destroys the handles of the different
-     * CUDA libraries used inside deal.II.
+     * Various CUDA APIs need an object to store internal data. This structure
+     * creates, initializes, stores, and destroys these so-called handles for
+     * the respective CUDA libraries used inside deal.II.
      */
     struct Handle
     {
       /**
-       * Constructor. Create the handles for the different libraries.
+       * Constructor. Initialize the handles for the different libraries.
        */
       Handle();
 
@@ -52,17 +53,25 @@ namespace Utilities
       Handle(Handle const &) = delete;
 
       /**
-       * Destructor. Destroy the handles and free all the memory allocated by
-       * GrowingVectorMemory.
+       * Destructor. Destroy the handles.
        */
       ~Handle();
 
+      /**
+       * Pointer to an opaque cuSolverDN context.
+       * The handle must be passed to every cuSolverDN library function.
+       */
       cusolverDnHandle_t cusolver_dn_handle;
 
+      /**
+       * Pointer to an opaque cuSolverSP context.
+       * The handle must be passed to every cuSolverSP library function.
+       */
       cusolverSpHandle_t cusolver_sp_handle;
 
       /**
-       * Handle to the cuSPARSE library.
+       * Pointer to an opaque cuSPARSE context.
+       * The handle must be passed to every cuSPARSE library function.
        */
       cusparseHandle_t cusparse_handle;
     };

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.