浏览代码

add out of core API doc

Corentin Salingue 12 年之前
父节点
当前提交
51ab635b7b

+ 1 - 0
doc/doxygen/Makefile.am

@@ -65,6 +65,7 @@ chapters =	\
 	chapters/api/data_interfaces.doxy \
 	chapters/api/data_management.doxy \
 	chapters/api/data_partition.doxy \
+	chapters/api/data_out_of_core.doxy \
 	chapters/api/expert_mode.doxy \
 	chapters/api/explicit_dependencies.doxy \
 	chapters/api/fft_support.doxy \

+ 31 - 0
doc/doxygen/chapters/api/data_out_of_core.doxy

@@ -0,0 +1,31 @@
+/*
+ * This file is part of the StarPU Handbook.
+ * Copyright (C) 2013 Corentin Salingue
+ * See the file version.doxy for copying conditions.
+ */
+
+
+/*! \defgroup API_Out_Of_Core Out Of Core
+
+
+
+\struct disk_ops
+This is a set of functions to manipulate datas on disk.
+
+\fn int starpu_disk_register (struct disk_ops *func, void *parameter, size_t size) 
+\ingroup API_Out_Of_Core
+Register a disk memory node with a set of functions to manipulate datas. <br />
+SUCCESS: return the disk node. <br />
+FAIL: return an error code. <br />
+The \p size must be at least 1 MB !
+
+\fn void starpu_disk_unregister (unsigned node)
+\ingroup API_Out_Of_Core
+Unregister a disk memory node created by the starpu_disk_register function.
+
+\var starpu_disk_stdio_ops
+\ingroup API_Out_Of_Core
+This set uses the stdio library (fwrite, fread...) to read/write on disk. <br />
+<strong>Warning: It creates one file per allocation !</strong> 
+
+*/ 

+ 1 - 0
doc/doxygen/chapters/files.doxy

@@ -12,6 +12,7 @@
 \file starpu.h
 \file starpu_data_filters.h
 \file starpu_data_interfaces.h
+\file starpu_disk.h
 \file starpu_worker.h
 \file starpu_task.h
 \file starpu_task_bundle.h

+ 2 - 2
doc/doxygen/chapters/out_of_core.doxy

@@ -34,8 +34,8 @@ At the end, you have to unregister your disk memory:
 
 \section DiskFunctions Disk functions
 
-You have various ways to use a disk memory node. You have, for instance, the starpu_disk_stdio_ops.
-All structures are in... TODO
+You have various ways to use a disk memory node. You have, for instance, the starpu_disk_stdio_ops. <br />
+All structures are in \ref API_Out_Of_Core .
 
 \section ExampleDiskCopy Example: disk_copy
 

+ 1 - 0
doc/doxygen/doxygen-config.cfg.in

@@ -25,6 +25,7 @@ INPUT                  = @top_srcdir@/doc/doxygen/chapters \
 			 @top_srcdir@/include/starpu_data_filters.h \
 			 @top_srcdir@/include/starpu_data.h \
 			 @top_srcdir@/include/starpu_data_interfaces.h \
+			 @top_srcdir@/include/starpu_disk.h \
 			 @top_srcdir@/include/starpu_deprecated_api.h \
 			 @top_srcdir@/include/starpu_driver.h \
 			 @top_srcdir@/include/starpu_expert.h \

+ 2 - 0
doc/doxygen/refman.tex

@@ -197,6 +197,7 @@ Documentation License”.
 \input{group__API__Data__Management}
 \input{group__API__Data__Interfaces}
 \input{group__API__Data__Partition}
+\input{group__API__Out__Of__Core}
 \input{group__API__Multiformat__Data__Interface}
 \input{group__API__Codelet__And__Tasks}
 \input{group__API__Insert__Task}
@@ -239,6 +240,7 @@ Documentation License”.
 \input{starpu__data__filters_8h}
 \input{starpu__data__interfaces_8h}
 \input{starpu__deprecated__api_8h}
+\input{starpu__disk_8h}
 \input{starpu__driver_8h}
 \input{starpu__expert_8h}
 \input{starpu__fxt_8h}