[GNUnet-SVN] r10763 - in gnunet: . doc/man src/include

[gnunet]

Author: grothoff
Date: 2010-04-02 22:22:08 +0200 (Fri, 02 Apr 2010)
New Revision: 10763

Modified:
   gnunet/TODO
   gnunet/doc/man/gnunet-download.1
   gnunet/src/include/gnunet_fs_service.h
Log:
update

Modified: gnunet/TODO
===================================================================
--- gnunet/TODO 2010-04-02 20:21:58 UTC (rev 10762)
+++ gnunet/TODO 2010-04-02 20:22:08 UTC (rev 10763)
@@ -21,19 +21,18 @@
     Also, core does not seem to actually decrement the number of active
     sessions even if no connections exist for a while! (likely related...)
   - transport reports bw quota violations on slow systems (core or
-    transport issue?)
+    transport issue? tracking issue or actual violation?)
 * DATASTORE: [CG]
   - utilization can (easily, restart?) go out of control (very large), causing
     content expiration job to go crazy and delete everything!
 * FS: [CG]
-  - gnunet-publish uses 'NULL' for the file name when
-    publishing a directory (!)
+  - EASY BUGS:
+    + gnunet-download does not terminate when done (stop missing!)
   - on some systems, keyword search does not find locally published content
     (need testcase of command-line tools! - also good to cover getopt API!)
     [could be related to datastore issue above!]
   - 2-peer download is still too slow (why?)
   - advanced FS API parts
-    + pick correct filenames for recursive downloads (mkdir, .gnd)
     + support recursive download even if filename is NULL and we hence
       do not generate files on disk (use temp_filename)
     + bound parallelism (# fs downloads)

Modified: gnunet/doc/man/gnunet-download.1
===================================================================
--- gnunet/doc/man/gnunet-download.1    2010-04-02 20:21:58 UTC (rev 10762)
+++ gnunet/doc/man/gnunet-download.1    2010-04-02 20:22:08 UTC (rev 10763)
@@ -34,7 +34,7 @@
 set the maximum number of parallel downloads that is allowed.  More parallel 
downloads can, to some extent, improve the overall time to download content.  
However, parallel downloads also take more memory.  The specified number is the 
number of files that are downloaded in parallel, not the number of blocks that 
are concurrently requested.  As a result, the number only matters for recursive 
downloads.  The default value is 32.
 .TP
 \fB\-R\fR, \fB\-\-recursive\fR
-download directories recursively (and in parallel); note that the URI must 
belong to a GNUnet directory and that the filename given must end with a '/' 
\-\- otherwise, only the file corresponding to the URI will be downloaded.
+download directories recursively (and in parallel); note that the URI must 
belong to a GNUnet directory and that the filename given must end with a '/' 
\-\- otherwise, only the file corresponding to the URI will be downloaded.  
Note that in addition to using '-R', you must also specify a filename ending in 
'.gnd' so that the code realizes that the top-level file is a directory (since 
we have no meta data).
 .TP
 \fB\-v\fR, \fB\-\-version\fR
 print the version number

Modified: gnunet/src/include/gnunet_fs_service.h
===================================================================
--- gnunet/src/include/gnunet_fs_service.h      2010-04-02 20:21:58 UTC (rev 
10762)
+++ gnunet/src/include/gnunet_fs_service.h      2010-04-02 20:22:08 UTC (rev 
10763)
@@ -2376,6 +2376,16 @@
 
 
 /**
+ * Suggest a filename based on given metadata.
+ * 
+ * @param md given meta data
+ * @return NULL if meta data is useless for suggesting a filename
+ */
+char *
+GNUNET_FS_meta_data_suggest_filename (const struct GNUNET_CONTAINER_MetaData 
*md);
+
+
+/**
  * Function used to process entries in a directory.
  *
  * @param cls closure