-LRN: harmonize dirmetascanner, plus fixing compile errors on GNU
authorChristian Grothoff <christian@grothoff.org>
Sun, 15 Jan 2012 11:59:08 +0000 (11:59 +0000)
committerChristian Grothoff <christian@grothoff.org>
Sun, 15 Jan 2012 11:59:08 +0000 (11:59 +0000)
src/fs/Makefile.am
src/fs/fs_dirmetascan.c
src/include/gnunet_fs_service.h

index cbf63f335a377262b4ab7a5ff4b408c2b4bb777a..2a8a8c8963af835dae9146164e3318337aaccc7f 100644 (file)
@@ -27,6 +27,7 @@ noinst_LIBRARIES = libgnunetfstest.a
 libgnunetfs_la_SOURCES = \
   fs_api.c fs_api.h fs.h \
   fs_directory.c \
+  fs_dirmetascan.c \
   fs_download.c \
   fs_file_information.c \
   fs_getopt.c \
index fd8ab15c44488b2f4dfe3da3352d6a8b1c08b6dc..b9e400c0033a30b2f8150c2c609dc72177be40bc 100644 (file)
-/*\r
-     This file is part of GNUnet\r
-     (C) 2005-2012 Christian Grothoff (and other contributing authors)\r
-\r
-     GNUnet is free software; you can redistribute it and/or modify\r
-     it under the terms of the GNU General Public License as published\r
-     by the Free Software Foundation; either version 2, or (at your\r
-     option) any later version.\r
-\r
-     GNUnet is distributed in the hope that it will be useful, but\r
-     WITHOUT ANY WARRANTY; without even the implied warranty of\r
-     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\r
-     General Public License for more details.\r
-\r
-     You should have received a copy of the GNU General Public License\r
-     along with GNUnet; see the file COPYING.  If not, write to the\r
-     Free Software Foundation, Inc., 59 Temple Place - Suite 330,\r
-     Boston, MA 02111-1307, USA.\r
-*/\r
-\r
-#include "platform.h"\r
-#include "gnunet_fs_service.h"\r
-#include "gnunet_scheduler_lib.h"\r
-\r
-/**\r
- * Entry for each unique keyword to track how often\r
- * it occured.  Contains the keyword and the counter.\r
- */\r
-struct KeywordCounter\r
-{\r
-\r
-  /**\r
-   * Keyword that was found.\r
-   */\r
-  const char *value;\r
-\r
-  /**\r
-   * How many files have this keyword?\r
-   */\r
-  unsigned int count;\r
-\r
-  /**\r
-   * This is a doubly-linked list\r
-   */\r
-  struct KeywordCounter *prev;\r
-\r
-  /**\r
-   * This is a doubly-linked list\r
-   */\r
-  struct KeywordCounter *next;\r
-};\r
-\r
-/**\r
- * Aggregate information we keep for meta data in each directory.\r
- */\r
-struct MetaCounter\r
-{\r
-  /**\r
-   * The actual meta data.\r
-   */\r
-  const char *data;\r
-\r
-  /**\r
-   * Number of bytes in 'data'.\r
-   */\r
-  size_t data_size;\r
-\r
-  /**\r
-   * Name of the plugin that provided that piece of metadata\r
-   */\r
-  const char *plugin_name;\r
-\r
-  /**\r
-   * Type of the data\r
-   */\r
-  enum EXTRACTOR_MetaType type;\r
-\r
-  /**\r
-   * Format of the data\r
-   */\r
-  enum EXTRACTOR_MetaFormat format;\r
-\r
-  /**\r
-   * MIME-type of the metadata itself\r
-   */\r
-  const char *data_mime_type;\r
-\r
-  /**\r
-   * How many files have meta entries matching this value?\r
-   * (type and format do not have to match).\r
-   */\r
-  unsigned int count;\r
-\r
-  /**\r
-   * This is a doubly-linked list\r
-   */\r
-  struct MetaCounter *prev;\r
-\r
-  /**\r
-   * This is a doubly-linked list\r
-   */\r
-  struct MetaCounter *next;\r
-};\r
-\r
-struct AddDirContext;\r
-\r
-/**\r
- * A structure used to hold a pointer to the tree item that is being\r
- * processed.\r
- * Needed to avoid changing the context for every recursive call.\r
- */\r
-struct AddDirStack\r
-{\r
-  /**\r
-   * Context pointer\r
-   */\r
-  struct AddDirContext *adc;\r
-\r
-  /**\r
-   * Parent directory\r
-   */\r
-  struct ShareTreeItem *parent;\r
-};\r
-\r
-/**\r
- * Execution context for 'add_dir'\r
- * Owned by the initiator thread.\r
- */\r
-struct AddDirContext\r
-{\r
-  /**\r
-   * After the scan is finished, it will contain a pointer to the\r
-   * top-level directory entry in the directory tree built by the\r
-   * scanner.\r
-   */\r
-  struct ShareTreeItem *toplevel;\r
-\r
-  /**\r
-   * Expanded filename (as given by the scan initiator).\r
-   * The scanner thread stores a copy here, and frees it when it finishes.\r
-   */\r
-  char *filename_expanded;\r
-\r
-  /**\r
-   * A pipe end to read signals from.\r
-   * Owned by the initiator thread.\r
-   */\r
-  const struct GNUNET_DISK_FileHandle *stop_read;\r
-\r
-  /**\r
-   * 1 if the scanner should stop, 0 otherwise. Set in response\r
-   * to communication errors or when the initiator wants the scanning\r
-   * process to stop.\r
-   */\r
-  char do_stop;\r
-\r
-  /**\r
-   * Handle of the pipe end into which the progress messages are written\r
-   * The pipe is owned by the initiator thread, and there's no way to\r
-   * close this end without having access to the pipe, so it won't\r
-   * be closed by the scanner thread.\r
-   * The initiator MUST keep it alive until the scanner thread is finished.\r
-   */\r
-  const struct GNUNET_DISK_FileHandle *progress_write;\r
-\r
-\r
-  /**\r
-   * List of libextractor plugins to use for extracting.\r
-   * Initialized when the scan starts, removed when it finishes.\r
-   */\r
-  struct EXTRACTOR_PluginList *plugins;\r
-};\r
-\r
-/**\r
- * An opaque structure a pointer to which is returned to the\r
- * caller to be used to control the scanner.\r
- */\r
-struct GNUNET_FS_DirScanner\r
-{\r
-  /**\r
-   * A pipe end to read signals from.\r
-   * Owned by the initiator thread.\r
-   */\r
-  const struct GNUNET_DISK_FileHandle *stop_write;\r
-  \r
-  /**\r
-   * A pipe transfer signals to the scanner.\r
-   * Owned by the initiator thread.\r
-   */\r
-  struct GNUNET_DISK_PipeHandle *stop_pipe;\r
-\r
- /**\r
-  * A thread object for the scanner thread.\r
-  * Owned by the initiator thread.\r
-  */\r
-#if WINDOWS\r
-  HANDLE thread;\r
-#else\r
-  pthread_t thread;\r
-#endif\r
-\r
- /**\r
-  * A task for reading progress messages from the scanner.\r
-  */\r
-  GNUNET_SCHEDULER_TaskIdentifier progress_read_task;\r
-\r
- /**\r
-  * The end of the pipe that is used to read progress messages.\r
-  */\r
-  const struct GNUNET_DISK_FileHandle *progress_read;\r
-\r
- /**\r
-  * The pipe that is used to read progress messages.\r
-  * Owned (along with both of its ends) by the initiator thread.\r
-  * Only closed after the scanner thread is finished.\r
-  */\r
-  struct GNUNET_DISK_PipeHandle *progress_pipe;\r
-\r
- /**\r
-  * The function that will be called every time there's a progress\r
-  * message.\r
-  */\r
-  GNUNET_FS_DirScannerProgressCallback progress_callback;\r
-\r
- /**\r
-  * A closure for progress_callback.\r
-  */\r
-  void *cls;\r
-\r
- /**\r
-  * A pointer to the context of the scanner.\r
-  * Owned by the initiator thread.\r
-  * Initiator thread shouldn't touch it until the scanner thread\r
-  * is finished.\r
-  */\r
-  struct AddDirContext *adc;\r
-};\r
-\r
-/**\r
- * A structure that forms a singly-linked list that serves as a stack\r
- * for metadata-processing function.\r
- */\r
-struct ProcessMetadataStackItem\r
-{\r
- /**\r
-  * A pointer to metadata-processing context.\r
-  * The same in every stack item.\r
-  */\r
-  struct ProcessMetadataContext *ctx;\r
-\r
- /**\r
-  * This is a singly-linked list. A pointer to its end is kept, and\r
-  * this pointer is used to walk it backwards.\r
-  */\r
-  struct ProcessMetadataStackItem *parent;\r
-\r
-  /**\r
-   * Map from the hash over the keyword to an 'struct KeywordCounter *'\r
-   * counter that says how often this keyword was\r
-   * encountered in the current directory.\r
-   */\r
-  struct GNUNET_CONTAINER_MultiHashMap *keywordcounter;\r
-\r
-  /**\r
-   * Map from the hash over the metadata to an 'struct MetaCounter *'\r
-   * counter that says how often this metadata was\r
-   * encountered in the current directory.\r
-   */\r
-  struct GNUNET_CONTAINER_MultiHashMap *metacounter;\r
-\r
-  /**\r
-   * Number of files in the current directory.\r
-   */\r
-  unsigned int dir_entry_count;\r
-\r
-  /**\r
-   * Keywords to exclude from using for KSK since they'll be associated\r
-   * with the parent as well.  NULL for nothing blocked.\r
-   */\r
-  struct GNUNET_FS_Uri *exclude_ksk;\r
-\r
- /**\r
-  * A share tree item that is being processed.\r
-  */\r
-  struct ShareTreeItem *item;\r
-\r
- /**\r
-  * Set to GNUNET_YES to indicate that the directory pointer by 'item'\r
-  * was processed, and we should move on to the next.\r
-  * Otherwise the directory will be recursed into.\r
-  */\r
-  int end_directory;\r
-\r
-};\r
-\r
-/**\r
- * The structure to keep the state of metadata processing\r
- */\r
-struct ProcessMetadataContext\r
-{\r
- /**\r
-  * The top of the stack.\r
-  */\r
-  struct ProcessMetadataStackItem *stack;\r
-\r
- /**\r
-  * Callback to invoke when processing is finished\r
-  */\r
-  GNUNET_SCHEDULER_Task cb;\r
-\r
- /**\r
-  * Closure for 'cb'\r
-  */\r
-  void *cls;\r
-\r
- /**\r
-  * Toplevel directory item of the tree to process.\r
-  */\r
-  struct ShareTreeItem *toplevel;\r
-};\r
-\r
-/**\r
- * Called every now and then by the scanner.\r
- * Checks the synchronization privitive.\r
- * Returns 1 if the scanner should stop, 0 otherwise.\r
- */\r
-static int\r
-should_stop (struct AddDirContext *adc)\r
-{\r
-  errno = 0;\r
-  char c;\r
-  if (GNUNET_DISK_file_read_non_blocking (adc->stop_read, &c, 1) == 1\r
-      || errno != EAGAIN)\r
-  {\r
-    adc->do_stop = 1;\r
-  }\r
-  return adc->do_stop;\r
-}\r
-\r
-/**\r
- * Write progress message.\r
- * Format is:\r
- * <reason><filename length><filename><directory flag>\r
- * If filename is NULL, filename is not written, and its length\r
- * is written as 0, and nothing else is written. It signals the initiator\r
- * thread that the scanner is finished, and that it can now join its thread.\r
- *\r
- * Also checks if the initiator thread wants the scanner to stop,\r
- * Returns 1 to stop scanning (if the signal was received, or\r
- * if the pipe was broken somehow), 0 otherwise.\r
- */\r
-static int\r
-write_progress (struct AddDirContext *adc, const char *filename,\r
-    char is_directory, enum GNUNET_DirScannerProgressUpdateReason reason)\r
-{\r
-  size_t filename_len;\r
-  ssize_t wr;\r
-  size_t total_write;\r
-  if ((adc->do_stop || should_stop (adc)) && reason != GNUNET_DIR_SCANNER_ASKED_TO_STOP\r
-      && reason != GNUNET_DIR_SCANNER_FINISHED)\r
-    return 1;\r
-  total_write = 0;\r
-  wr = 1;\r
-  while ((wr > 0 || errno == EAGAIN) && total_write < sizeof (reason))\r
-  {\r
-    wr = GNUNET_DISK_file_write_blocking (adc->progress_write,\r
-      &((char *)&reason)[total_write], sizeof (reason) - total_write);\r
-    if (wr > 0)\r
-      total_write += wr;\r
-  }\r
-  if (sizeof (reason) != total_write)\r
-    return adc->do_stop = 1;\r
-  if (filename)\r
-    filename_len = strlen (filename) + 1;\r
-  else\r
-    filename_len = 0;\r
-  total_write = 0;\r
-  wr = 1;\r
-  while ((wr > 0 || errno == EAGAIN) && total_write < sizeof (size_t))\r
-  {\r
-    wr = GNUNET_DISK_file_write_blocking (adc->progress_write,\r
-      &((char *)&filename_len)[total_write], sizeof (size_t) - total_write);\r
-    if (wr > 0)\r
-      total_write += wr;\r
-  }\r
-  if (sizeof (size_t) != total_write)\r
-    return adc->do_stop = 1;\r
-  if (filename)\r
-  {\r
-    total_write = 0;\r
-    wr = 1;\r
-    while ((wr > 0 || errno == EAGAIN) && total_write < filename_len)\r
-    {\r
-      wr = GNUNET_DISK_file_write_blocking (adc->progress_write,\r
-        &((char *)filename)[total_write], filename_len - total_write);\r
-      if (wr > 0)\r
-        total_write += wr;\r
-    }\r
-    if (filename_len != total_write)\r
-      return adc->do_stop = 1;\r
-    total_write = 0;\r
-    wr = 1;\r
-    while ((wr > 0 || errno == EAGAIN) && total_write < sizeof (char))\r
-    {\r
-      wr = GNUNET_DISK_file_write_blocking (adc->progress_write,\r
-        &((char *)&is_directory)[total_write], sizeof (char) - total_write);\r
-      if (wr > 0)\r
-        total_write += wr;\r
-    }\r
-    if (sizeof (char) != total_write)\r
-      return adc->do_stop = 1;\r
-  }\r
-  return 0;\r
-}\r
-\r
-/**\r
- * Add the given keyword to the\r
- * keyword statistics tracker.\r
- *\r
- * @param cls closure (user-defined)\r
- * @param keyword the keyword to count\r
- * @param is_mandatory ignored\r
- * @return always GNUNET_OK\r
- */\r
-static int\r
-add_to_keyword_counter (void *cls, const char *keyword, int is_mandatory)\r
-{\r
-  struct GNUNET_CONTAINER_MultiHashMap *mcm = cls;\r
-  struct KeywordCounter *cnt, *first_cnt;\r
-  GNUNET_HashCode hc;\r
-  size_t klen;\r
-\r
-  klen = strlen (keyword) + 1;\r
-  GNUNET_CRYPTO_hash (keyword, klen - 1, &hc);\r
-  /* Since the map might contain multiple values per keyword, we only\r
-   * store one value, and attach all other to it, forming a linked list.\r
-   * Somewhat easier than retrieving multiple items via callback.\r
-   */\r
-  first_cnt = GNUNET_CONTAINER_multihashmap_get (mcm, &hc);\r
-  for (cnt = first_cnt; cnt && strcmp (cnt->value, keyword) != 0; cnt = cnt->next);\r
-  if (cnt == NULL)\r
-  {\r
-    cnt = GNUNET_malloc (sizeof (struct KeywordCounter) + klen);\r
-    cnt->value = (const char *) &cnt[1];\r
-    memcpy (&cnt[1], keyword, klen);\r
-    if (first_cnt != NULL)\r
-    {\r
-      if (first_cnt->prev != NULL)\r
-      {\r
-        first_cnt->prev->next = cnt;\r
-        cnt->prev = first_cnt->prev;\r
-      }\r
-      first_cnt->prev = cnt;\r
-      cnt->next = first_cnt;\r
-    }\r
-    else\r
-      GNUNET_CONTAINER_multihashmap_put (mcm, &hc, cnt,\r
-          GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE);\r
-  }\r
-  cnt->count++;\r
-  return GNUNET_OK;\r
-}\r
-\r
-/**\r
- * Type of a function that libextractor calls for each\r
- * meta data item found.\r
- *\r
- * @param cls the container multihashmap to update\r
- * @param plugin_name name of the plugin that produced this value;\r
- *        special values can be used (i.e. '&lt;zlib&gt;' for zlib being\r
- *        used in the main libextractor library and yielding\r
- *        meta data).\r
- * @param type libextractor-type describing the meta data\r
- * @param format basic format information about data\r
- * @param data_mime_type mime-type of data (not of the original file);\r
- *        can be NULL (if mime-type is not known)\r
- * @param data actual meta-data found\r
- * @param data_len number of bytes in data\r
- * @return GNUNET_OK to continue extracting / iterating\r
- */\r
-static int\r
-add_to_meta_counter (void *cls, const char *plugin_name,\r
-                enum EXTRACTOR_MetaType type, enum EXTRACTOR_MetaFormat format,\r
-                const char *data_mime_type, const char *data, size_t data_len)\r
-{\r
-  struct GNUNET_CONTAINER_MultiHashMap *map = cls;\r
-  GNUNET_HashCode key;\r
-  struct MetaCounter *cnt, *first_cnt;\r
-\r
-  GNUNET_CRYPTO_hash (data, data_len, &key);\r
-  first_cnt = GNUNET_CONTAINER_multihashmap_get (map, &key);\r
-  for (cnt = first_cnt; cnt\r
-      && cnt->data_size != data_len\r
-      && memcmp (cnt->data, data, cnt->data_size) != 0; cnt = cnt->next);\r
-  if (cnt == NULL)\r
-  {\r
-    cnt = GNUNET_malloc (sizeof (struct MetaCounter));\r
-    cnt->data = data;\r
-    cnt->data_size = data_len;\r
-    cnt->plugin_name = plugin_name;\r
-    cnt->type = type;\r
-    cnt->format = format;\r
-    cnt->data_mime_type = data_mime_type;\r
-\r
-    if (first_cnt != NULL)\r
-    {\r
-      if (first_cnt->prev != NULL)\r
-      {\r
-        first_cnt->prev->next = cnt;\r
-        cnt->prev = first_cnt->prev;\r
-      }\r
-      first_cnt->prev = cnt;\r
-      cnt->next = first_cnt;\r
-    }\r
-    else\r
-      GNUNET_CONTAINER_multihashmap_put (map, &key, cnt,\r
-          GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE);\r
-  }\r
-  cnt->count++;\r
-  return 0;\r
-}\r
-\r
-/**\r
- * Allocates a struct ShareTreeItem and adds it to its parent.\r
- */\r
-static struct ShareTreeItem *\r
-make_item (struct ShareTreeItem *parent)\r
-{\r
-  struct ShareTreeItem *item;\r
-  item = GNUNET_malloc (sizeof (struct ShareTreeItem));\r
-\r
-  item->parent = parent;\r
-  if (parent)\r
-    GNUNET_CONTAINER_DLL_insert (parent->children_head, parent->children_tail,\r
-        item);\r
-  return item;\r
-}\r
-\r
-/**\r
- * Extract metadata from a file and add it to the share tree\r
- *\r
- * @param adc context to modify\r
- * @param filename name of the file to process\r
- */\r
-static void\r
-extract_file (struct AddDirStack *ads, const char *filename)\r
-{\r
-  struct ShareTreeItem *item;\r
-  const char *short_fn;\r
-\r
-  item = make_item (ads->parent);\r
-\r
-  GNUNET_DISK_file_size (filename, &item->file_size, GNUNET_YES);\r
-  item->is_directory = GNUNET_NO;\r
-\r
-  item->meta = GNUNET_CONTAINER_meta_data_create ();\r
-  GNUNET_FS_meta_data_extract_from_file (item->meta, filename,\r
-      ads->adc->plugins);\r
-  GNUNET_CONTAINER_meta_data_delete (item->meta, EXTRACTOR_METATYPE_FILENAME,\r
-      NULL, 0);\r
-  short_fn = GNUNET_STRINGS_get_short_name (filename);\r
-\r
-  item->filename = GNUNET_strdup (filename);\r
-  item->short_filename = GNUNET_strdup (short_fn);\r
-\r
-  GNUNET_CONTAINER_meta_data_insert (item->meta, "<libgnunetfs>",\r
-                                     EXTRACTOR_METATYPE_FILENAME,\r
-                                     EXTRACTOR_METAFORMAT_UTF8, "text/plain",\r
-                                     short_fn, strlen (short_fn) + 1);\r
-}\r
-\r
-/**\r
- * Remove the keyword from the ksk URI.\r
- *\r
- * @param cls the ksk uri\r
- * @param keyword the word to remove\r
- * @param is_mandatory ignored\r
- * @return always GNUNET_OK\r
- */\r
-static int\r
-remove_keyword (void *cls, const char *keyword, int is_mandatory)\r
-{\r
-  struct GNUNET_FS_Uri *ksk = cls;\r
-\r
-  GNUNET_FS_uri_ksk_remove_keyword (ksk, keyword);\r
-  return GNUNET_OK;\r
-}\r
-\r
-/**\r
- * Remove keywords from current directory's children, if they are\r
- * in the exluded keywords list of that directory.\r
- *\r
- * @param cls the ksk uri\r
- * @param keyword the word to remove\r
- * @param is_mandatory ignored\r
- * @return always GNUNET_OK\r
- */\r
-static int\r
-remove_keywords (struct ProcessMetadataStackItem *stack, struct ShareTreeItem *dir)\r
-{\r
-  struct ShareTreeItem *item;\r
-\r
-  for (item = dir->children_head; item; item = item->next)\r
-  {\r
-    if (stack->exclude_ksk != NULL)\r
-      GNUNET_FS_uri_ksk_get_keywords (stack->exclude_ksk, &remove_keyword, item->ksk_uri);\r
-  }\r
-  return GNUNET_OK;\r
-}\r
-\r
-/**\r
- * Context passed to 'migrate_and_drop'.\r
- */\r
-struct KeywordProcessContext\r
-{\r
-  /**\r
-   * All the keywords we migrated to the parent.\r
-   */\r
-  struct GNUNET_FS_Uri *ksk;\r
-\r
-  /**\r
-   * How often does a keyword have to occur to be\r
-   * migrated to the parent?\r
-   */\r
-  unsigned int threshold;\r
-};\r
-\r
-/**\r
- * Context passed to 'migrate_and_drop'.\r
- */\r
-struct MetaProcessContext\r
-{\r
-  /**\r
-   * All the metadata we copy to the parent.\r
-   */\r
-  struct GNUNET_CONTAINER_MetaData *meta;\r
-\r
-  /**\r
-   * How often does a metadata have to occur to be\r
-   * migrated to the parent?\r
-   */\r
-  unsigned int threshold;\r
-};\r
-\r
-\r
-/**\r
- * Move "frequent" keywords over to the\r
- * target ksk uri, free the counters.\r
- *\r
- */\r
-static int\r
-migrate_and_drop (void *cls, const GNUNET_HashCode * key, void *value)\r
-{\r
-  struct KeywordProcessContext *kpc = cls;\r
-  struct KeywordCounter *counter = value;\r
-\r
-  if (counter->count >= kpc->threshold && counter->count > 1)\r
-  {\r
-    GNUNET_FS_uri_ksk_add_keyword (kpc->ksk, counter->value, GNUNET_NO);\r
-  }\r
-  GNUNET_free (counter);\r
-  return GNUNET_YES;\r
-}\r
-/**\r
- * Copy "frequent" metadata items over to the\r
- * target metadata container, free the counters.\r
- *\r
- */\r
-static int\r
-migrate_and_drop_metadata (void *cls, const GNUNET_HashCode * key, void *value)\r
-{\r
-  struct MetaProcessContext *mpc = cls;\r
-  struct MetaCounter *counter = value;\r
-\r
-  if (counter->count >= mpc->threshold && counter->count > 1)\r
-  {\r
-    GNUNET_CONTAINER_meta_data_insert (mpc->meta,\r
-                                   counter->plugin_name,\r
-                                   counter->type,\r
-                                   counter->format,\r
-                                   counter->data_mime_type, counter->data,\r
-                                   counter->data_size);\r
-  }\r
-  GNUNET_free (counter);\r
-  return GNUNET_YES;\r
-}\r
-\r
-/**\r
- * Go over the collected keywords from all entries in the\r
- * directory and push common keywords up one level (by\r
- * adding it to the returned struct). Do the same for metadata.\r
- * Destroys keywordcounter and metacoutner for current directory.\r
- *\r
- * @param adc collection of child meta data\r
- * @param exclude_ksk pointer to where moveable keywords will be stored\r
- * @param copy_meta pointer to where copyable metadata will be stored\r
- */\r
-static void\r
-process_keywords_and_metadata (struct ProcessMetadataStackItem *stack,\r
-    struct GNUNET_FS_Uri **exclude_ksk,\r
-    struct GNUNET_CONTAINER_MetaData **copy_meta)\r
-{\r
-  struct KeywordProcessContext kpc;\r
-  struct MetaProcessContext mpc;\r
-  struct GNUNET_CONTAINER_MetaData *tmp;\r
-\r
-  /* Surprisingly, it's impossible to create a ksk with 0 keywords directly.\r
-   * But we can create one from an empty metadata set\r
-   */\r
-  tmp = GNUNET_CONTAINER_meta_data_create ();\r
-  kpc.ksk = GNUNET_FS_uri_ksk_create_from_meta_data (tmp);\r
-  GNUNET_CONTAINER_meta_data_destroy (tmp);\r
-  mpc.meta = GNUNET_CONTAINER_meta_data_create ();\r
-\r
-  kpc.threshold = mpc.threshold = (stack->dir_entry_count + 1) / 2; /* 50% */\r
-\r
-  GNUNET_CONTAINER_multihashmap_iterate (stack->keywordcounter,\r
-      &migrate_and_drop, &kpc);\r
-  GNUNET_CONTAINER_multihashmap_iterate (stack->metacounter,\r
-      &migrate_and_drop_metadata, &mpc);\r
-\r
-  GNUNET_CONTAINER_multihashmap_destroy (stack->keywordcounter);\r
-  GNUNET_CONTAINER_multihashmap_destroy (stack->metacounter);\r
-  *exclude_ksk = kpc.ksk;\r
-  *copy_meta = mpc.meta;\r
-}\r
-\r
-/**\r
- * Function called by the directory iterator to\r
- * (recursively) add all of the files in the\r
- * directory to the tree.\r
- * Called by the directory scanner to initiate the\r
- * scan.\r
- * TODO: find a way to make it non-recursive.\r
- *\r
- * @param cls the 'struct AddDirStack *' we're in\r
- * @param filename file or directory to scan\r
- */\r
-static int\r
-scan_directory (void *cls, const char *filename)\r
-{\r
-  struct AddDirStack *ads = cls, recurse_ads;\r
-  struct AddDirContext *adc = ads->adc;\r
-  struct stat sbuf;\r
-  struct ShareTreeItem *item;\r
-  const char *short_fn;\r
-  int do_stop = 0;\r
-\r
-  /* Wrap up fast */\r
-  if (adc->do_stop)\r
-    return GNUNET_SYSERR;\r
-\r
-  /* If the file doesn't exist (or is not statable for any other reason,\r
-   * skip it, and report it.\r
-   */\r
-  if (0 != STAT (filename, &sbuf))\r
-  {\r
-    do_stop = write_progress (adc, filename, S_ISDIR (sbuf.st_mode),\r
-      GNUNET_DIR_SCANNER_DOES_NOT_EXIST);\r
-    return GNUNET_OK;\r
-  }\r
-\r
-  /* Report the progress */\r
-  do_stop = write_progress (adc, filename, S_ISDIR (sbuf.st_mode),\r
-    GNUNET_DIR_SCANNER_NEW_FILE);\r
-  if (do_stop)\r
-  {\r
-    /* We were asked to stop, acknowledge that and return */\r
-    do_stop = write_progress (adc, filename, S_ISDIR (sbuf.st_mode),\r
-      GNUNET_DIR_SCANNER_ASKED_TO_STOP);\r
-    return GNUNET_SYSERR;\r
-  }\r
-\r
-  if (!S_ISDIR (sbuf.st_mode))\r
-    extract_file (ads, filename);\r
-  else\r
-  {\r
-    item = make_item (ads->parent);\r
-    item->meta = GNUNET_CONTAINER_meta_data_create ();\r
-\r
-    item->is_directory = GNUNET_YES;\r
-\r
-    recurse_ads.adc = adc;\r
-    recurse_ads.parent = item;\r
-\r
-    /* recurse into directory */\r
-    GNUNET_DISK_directory_scan (filename, &scan_directory, &recurse_ads);\r
-\r
-    short_fn = GNUNET_STRINGS_get_short_name (filename);\r
-\r
-    item->filename = GNUNET_strdup (filename);\r
-    item->short_filename = GNUNET_strdup (short_fn);\r
-\r
-    if (ads->parent == NULL)\r
-    {\r
-      /* we're finished with the scan, make sure caller gets the top-level\r
-       * directory pointer\r
-       */\r
-      adc->toplevel = item;\r
-    }\r
-  }\r
-  return GNUNET_OK;\r
-}\r
-\r
-/**\r
- * Signals the scanner to finish the scan as fast as possible.\r
- * Does not block.\r
- * Can close the pipe if asked to, but that is only used by the\r
- * internal call to this function during cleanup. The client\r
- * must understand the consequences of closing the pipe too early.\r
- *\r
- * @param ds directory scanner structure\r
- * @param close_pipe GNUNET_YES to close\r
- */\r
-void\r
-GNUNET_FS_directory_scan_finish (struct GNUNET_FS_DirScanner *ds,\r
-    int close_pipe)\r
-{\r
-  char c = 1;\r
-  GNUNET_DISK_file_write (ds->stop_write, &c, 1);\r
-\r
-  if (close_pipe)\r
-  {\r
-    if (ds->progress_read_task != GNUNET_SCHEDULER_NO_TASK)\r
-    {\r
-      GNUNET_SCHEDULER_cancel (ds->progress_read_task);\r
-      ds->progress_read_task = GNUNET_SCHEDULER_NO_TASK;\r
-    }\r
-    GNUNET_DISK_pipe_close_end (ds->progress_pipe, GNUNET_DISK_PIPE_END_READ);\r
-    ds->progress_read = NULL;\r
-  }\r
-}\r
-\r
-/**\r
- * Signals the scanner thread to finish (in case it isn't finishing\r
- * already) and joins the scanner thread. Closes the pipes, frees the\r
- * scanner contexts (both of them), returns the results of the scan.\r
- * Results are valid (and have to be freed) even if the scanner had\r
- * an error or was rushed to finish prematurely.\r
- * Blocks until the scanner is finished.\r
- *\r
- * @param ds directory scanner structure\r
- * @return the results of the scan (a directory tree)\r
- */\r
-struct ShareTreeItem *\r
-GNUNET_FS_directory_scan_cleanup (struct GNUNET_FS_DirScanner *ds)\r
-{\r
-  struct ShareTreeItem *result;\r
-\r
-  GNUNET_FS_directory_scan_finish (ds, GNUNET_YES);\r
-#if WINDOWS\r
-  WaitForSingleObject (ds->thread, INFINITE);\r
-  CloseHandle (ds->thread);\r
-#else\r
-  pthread_join (ds->thread, NULL);\r
-  pthread_detach (ds->thread);\r
-#endif\r
-\r
-  GNUNET_DISK_pipe_close (ds->stop_pipe);\r
-  GNUNET_DISK_pipe_close (ds->progress_pipe);\r
-  result = ds->adc->toplevel;\r
-  GNUNET_free (ds->adc);\r
-  GNUNET_free (ds);\r
-  return result;\r
-}\r
-\r
-/**\r
- * The function from which the scanner thread starts\r
- */\r
-#if WINDOWS\r
-static DWORD\r
-#else\r
-static int\r
-#endif\r
-run_directory_scan_thread (struct AddDirContext *adc)\r
-{\r
-  struct AddDirStack ads;\r
-  ads.adc = adc;\r
-  ads.parent = NULL;\r
-  scan_directory (&ads, adc->filename_expanded);\r
-  GNUNET_free (adc->filename_expanded);\r
-  if (adc->plugins != NULL)\r
-    EXTRACTOR_plugin_remove_all (adc->plugins);\r
-  /* Tell the initiator that we're finished, it can now join the thread */\r
-  write_progress (adc, NULL, 0, GNUNET_DIR_SCANNER_FINISHED);\r
-  return 0;\r
-}\r
-\r
-/**\r
- * Called every time there is data to read from the scanner.\r
- * Calls the scanner progress handler.\r
- *\r
- * @param cls the closure (directory scanner object)\r
- * @param tc task context in which the task is running\r
- */\r
-static void\r
-read_progress_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)\r
-{\r
-  struct GNUNET_FS_DirScanner *ds;\r
-  int end_it = 0;\r
-  enum GNUNET_DirScannerProgressUpdateReason reason;\r
-  ssize_t rd;\r
-  ssize_t total_read;\r
-\r
-  size_t filename_len;\r
-  char is_directory;\r
-  char *filename;\r
-\r
-  ds = cls;\r
-\r
-  ds->progress_read_task = GNUNET_SCHEDULER_NO_TASK;\r
-\r
-  if (!(tc->reason & GNUNET_SCHEDULER_REASON_READ_READY))\r
-  {\r
-    ds->progress_callback (ds->cls, ds, NULL, 0, GNUNET_DIR_SCANNER_SHUTDOWN);\r
-    return;\r
-  }\r
-\r
-  /* Read one message. If message is malformed or can't be read, end the scanner */\r
-  total_read = rd = GNUNET_DISK_file_read (ds->progress_read, &reason, sizeof (reason));\r
-  while (rd > 0 && total_read < sizeof (reason))\r
-  {\r
-    rd = GNUNET_DISK_file_read (ds->progress_read,\r
-        &((char *) &reason)[total_read],\r
-        sizeof (reason) - total_read);\r
-    if (rd > 0)\r
-      total_read += rd;\r
-  }\r
-  if (total_read != sizeof (reason)\r
-      || reason <= GNUNET_DIR_SCANNER_FIRST\r
-      || reason >= GNUNET_DIR_SCANNER_LAST)\r
-  {\r
-    end_it = 1;\r
-    reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;\r
-  }\r
-\r
-  if (!end_it)\r
-  {\r
-    total_read = rd = GNUNET_DISK_file_read (ds->progress_read, &filename_len,\r
-        sizeof (size_t));\r
-    while (rd > 0 && total_read < sizeof (size_t))\r
-    {\r
-      rd = GNUNET_DISK_file_read (ds->progress_read,\r
-          &((char *) &filename_len)[total_read],\r
-          sizeof (size_t) - total_read);\r
-      if (rd > 0)\r
-        total_read += rd;\r
-    }\r
-    if (rd != sizeof (size_t))\r
-    {\r
-      end_it = 1;\r
-      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;\r
-    }\r
-  }\r
-  if (!end_it)\r
-  {\r
-    if (filename_len == 0)\r
-      end_it = 1;\r
-    else if (filename_len > MAX_PATH)\r
-    {\r
-      end_it = 1;\r
-      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;\r
-    }\r
-  }\r
-  if (!end_it)\r
-  {\r
-    filename = GNUNET_malloc (filename_len);\r
-    total_read = rd = GNUNET_DISK_file_read (ds->progress_read, filename,\r
-        filename_len);\r
-    while (rd > 0 && total_read < filename_len)\r
-    {\r
-      rd = GNUNET_DISK_file_read (ds->progress_read, &filename[total_read],\r
-          filename_len - total_read);\r
-      if (rd > 0)\r
-        total_read += rd;\r
-    }\r
-    if (rd != filename_len)\r
-    {\r
-      GNUNET_free (filename);\r
-      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;\r
-      end_it = 1;\r
-    }\r
-  }\r
-  if (!end_it && filename_len > 0)\r
-  {\r
-    total_read = rd = GNUNET_DISK_file_read (ds->progress_read, &is_directory,\r
-        sizeof (char));\r
-    while (rd > 0 && total_read < sizeof (char))\r
-    {\r
-      rd = GNUNET_DISK_file_read (ds->progress_read, &(&is_directory)[total_read],\r
-          sizeof (char) - total_read);\r
-      if (rd > 0)\r
-        total_read += rd;\r
-    }\r
-    if (rd != sizeof (char))\r
-    {\r
-      GNUNET_free (filename);\r
-      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;\r
-      end_it = 1;\r
-    }\r
-  }\r
-  if (!end_it)\r
-  {\r
-    end_it = ds->progress_callback (ds->cls, ds, (const char *) filename, is_directory, reason);\r
-    GNUNET_free (filename);\r
-    if (!end_it)\r
-    {\r
-      ds->progress_read_task = GNUNET_SCHEDULER_add_read_file (\r
-          GNUNET_TIME_UNIT_FOREVER_REL, ds->progress_read, &read_progress_task,\r
-          cls);\r
-    }\r
-  }\r
-  else\r
-  {\r
-    ds->progress_callback (ds->cls, ds, NULL, 0, reason);\r
-  }\r
-}\r
-\r
-\r
-/**\r
- * Start a directory scanner thread.\r
- *\r
- * @param filename name of the directory to scan\r
- * @param GNUNET_YES to not to run libextractor on files (only build a tree)\r
- * @param ex if not NULL, must be a list of extra plugins for extractor\r
- * @param cb the callback to call when there are scanning progress messages\r
- * @param cls closure for 'cb'\r
- * @return directory scanner object to be used for controlling the scanner\r
- */\r
-struct GNUNET_FS_DirScanner *\r
-GNUNET_FS_directory_scan_start (const char *filename,\r
-    int disable_extractor, const char *ex,\r
-    GNUNET_FS_DirScannerProgressCallback cb, void *cls)\r
-{\r
-  struct stat sbuf;\r
-  struct AddDirContext *adc;\r
-  char *filename_expanded;\r
-  struct GNUNET_FS_DirScanner *ds;\r
-  struct GNUNET_DISK_PipeHandle *progress_pipe;\r
-  int ok;\r
-\r
-  if (0 != STAT (filename, &sbuf))\r
-    return NULL;\r
-  /* TODO: consider generalizing this for files too! */\r
-  if (!S_ISDIR (sbuf.st_mode))\r
-  {\r
-    GNUNET_break (0);\r
-    return NULL;\r
-  }\r
-  /* scan_directory() is guaranteed to be given expanded filenames,\r
-   * so expand we will!\r
-   */\r
-  filename_expanded = GNUNET_STRINGS_filename_expand (filename);\r
-  if (filename_expanded == NULL)\r
-    return NULL;\r
-\r
-  progress_pipe = GNUNET_DISK_pipe (GNUNET_NO, GNUNET_NO, GNUNET_NO, GNUNET_NO);\r
-  if (progress_pipe == NULL)\r
-  {\r
-    GNUNET_free (filename_expanded);\r
-    return NULL;\r
-  }\r
-\r
-  adc = GNUNET_malloc (sizeof (struct AddDirContext));\r
-\r
-  ds = GNUNET_malloc (sizeof (struct GNUNET_FS_DirScanner));\r
-\r
-  ds->adc = adc;\r
-\r
-  ds->stop_pipe = GNUNET_DISK_pipe (GNUNET_NO, GNUNET_NO, GNUNET_NO, GNUNET_NO);\r
-  if (ds->stop_pipe == NULL)\r
-  {\r
-    GNUNET_free (adc);\r
-    GNUNET_free (ds);\r
-    GNUNET_free (filename_expanded);\r
-    GNUNET_DISK_pipe_close (progress_pipe);\r
-    return NULL;\r
-  }\r
-  ds->stop_write = GNUNET_DISK_pipe_handle (ds->stop_pipe,\r
-      GNUNET_DISK_PIPE_END_WRITE);\r
-  adc->stop_read = GNUNET_DISK_pipe_handle (ds->stop_pipe,\r
-      GNUNET_DISK_PIPE_END_READ);\r
-\r
-  adc->plugins = NULL;\r
-  if (!disable_extractor)\r
-  {\r
-    adc->plugins = EXTRACTOR_plugin_add_defaults (\r
-        EXTRACTOR_OPTION_DEFAULT_POLICY);\r
-    if (ex && strlen (ex) > 0)\r
-      adc->plugins = EXTRACTOR_plugin_add_config (adc->plugins, ex,\r
-          EXTRACTOR_OPTION_DEFAULT_POLICY);\r
-  }\r
-\r
-  adc->filename_expanded = filename_expanded;\r
-  adc->progress_write = GNUNET_DISK_pipe_handle (progress_pipe,\r
-      GNUNET_DISK_PIPE_END_WRITE);\r
-\r
-\r
-  ds->progress_read = GNUNET_DISK_pipe_handle (progress_pipe,\r
-      GNUNET_DISK_PIPE_END_READ);\r
-\r
-#if WINDOWS\r
-  ds->thread = CreateThread (NULL, 0,\r
-      (LPTHREAD_START_ROUTINE) &run_directory_scan_thread, (LPVOID) adc,\r
-      0, NULL);\r
-  ok = ds->thread != NULL;\r
-#else\r
-  ok = !pthread_create (&ds->thread, NULL, &run_directory_scan_thread,\r
-      (void *) adc);\r
-#endif\r
-  if (!ok)\r
-  {\r
-    GNUNET_free (adc);\r
-    GNUNET_free (filename_expanded);\r
-    GNUNET_DISK_pipe_close (progress_pipe);\r
-    GNUNET_free (ds);\r
-    return NULL;\r
-  }\r
-\r
-  ds->progress_callback = cb;\r
-  ds->cls = cls;\r
-  ds->adc = adc;\r
-  ds->progress_pipe = progress_pipe;\r
-\r
-  ds->progress_read_task = GNUNET_SCHEDULER_add_read_file (\r
-      GNUNET_TIME_UNIT_FOREVER_REL, ds->progress_read, &read_progress_task,\r
-      ds);\r
-\r
-  return ds;\r
-}\r
-\r
-/**\r
- * Task that post-processes the share item tree.\r
- * This processing has to be done in the main thread, because\r
- * it requires access to libgcrypt's hashing functions, and\r
- * libgcrypt is not thread-safe without some special magic.\r
- *\r
- * @param cls top of the stack\r
- * @param tc task context\r
- */\r
-static void\r
-trim_share_tree_task (void *cls,\r
-  const struct GNUNET_SCHEDULER_TaskContext *tc)\r
-{\r
-  struct ProcessMetadataStackItem *stack = cls;\r
-  struct ProcessMetadataStackItem *next = stack;\r
-  /* FIXME: figure out what to do when tc says we're shutting down */\r
-\r
-  /* item == NULL means that we've just finished going over the children of\r
-   * current directory.\r
-   */\r
-  if (stack->item == NULL)\r
-  {\r
-    if (stack->parent->item != NULL)\r
-    {\r
-      /* end of a directory */\r
-      struct GNUNET_FS_Uri *ksk;\r
-\r
-      /* use keyword and metadata counters to create lists of keywords to move\r
-       * and metadata to copy.\r
-       */\r
-      process_keywords_and_metadata (stack, &stack->parent->exclude_ksk, &stack->parent->item->meta);\r
-\r
-      /* create keywords from metadata (copies all text-metadata as keywords,\r
-       * AND parses the directory name we've just added, producing even more\r
-       * keywords.\r
-       * then merge these keywords with the ones moved from children.\r
-       */\r
-      ksk = GNUNET_FS_uri_ksk_create_from_meta_data (stack->parent->item->meta);\r
-      stack->parent->item->ksk_uri = GNUNET_FS_uri_ksk_merge (ksk, stack->parent->exclude_ksk);\r
-      GNUNET_FS_uri_destroy (ksk);\r
-\r
-      /* remove moved keywords from children (complete the move) */\r
-      remove_keywords (stack->parent, stack->parent->item);\r
-      GNUNET_FS_uri_destroy (stack->parent->exclude_ksk);\r
-\r
-      /* go up the stack */\r
-      next = stack->parent;\r
-      GNUNET_free (stack);\r
-      next->end_directory = GNUNET_YES;\r
-    }\r
-    else\r
-    {\r
-      /* we've just finished processing the toplevel directory */\r
-      struct ProcessMetadataContext *ctx = stack->ctx;\r
-      next = NULL;\r
-      GNUNET_SCHEDULER_add_continuation (ctx->cb, ctx->cls,\r
-          GNUNET_SCHEDULER_REASON_PREREQ_DONE);\r
-      GNUNET_free (stack->parent);\r
-      GNUNET_free (stack);\r
-      GNUNET_free (ctx);\r
-    }\r
-  }\r
-  else if (stack->item->is_directory\r
-      && !stack->end_directory\r
-      && stack->item->children_head != NULL)\r
-  {\r
-    /* recurse into subdirectory */\r
-    next = GNUNET_malloc (sizeof (struct ProcessMetadataStackItem));\r
-    next->ctx = stack->ctx;\r
-    next->item = stack->item->children_head;\r
-    next->keywordcounter = GNUNET_CONTAINER_multihashmap_create (1024);\r
-    next->metacounter = GNUNET_CONTAINER_multihashmap_create (1024);\r
-    next->dir_entry_count = 0;\r
-    next->parent = stack;\r
-  }\r
-  else\r
-  {\r
-    /* process a child entry (a file or a directory) and move to the next one*/\r
-    if (stack->item->is_directory)\r
-      stack->end_directory = GNUNET_NO;\r
-    stack->dir_entry_count++;\r
-    GNUNET_CONTAINER_meta_data_iterate (stack->item->meta, &add_to_meta_counter, stack->metacounter);\r
-\r
-    if (stack->item->is_directory)\r
-    {\r
-      char *user = getenv ("USER");\r
-      if ((user == NULL) || (0 != strncasecmp (user, stack->item->short_filename, strlen(user))))\r
-      {\r
-        /* only use filename if it doesn't match $USER */\r
-        GNUNET_CONTAINER_meta_data_insert (stack->item->meta, "<libgnunetfs>",\r
-                                          EXTRACTOR_METATYPE_FILENAME,\r
-                                          EXTRACTOR_METAFORMAT_UTF8,\r
-                                          "text/plain", stack->item->short_filename,\r
-                                          strlen (stack->item->short_filename) + 1);\r
-        GNUNET_CONTAINER_meta_data_insert (stack->item->meta, "<libgnunetfs>",\r
-                                          EXTRACTOR_METATYPE_GNUNET_ORIGINAL_FILENAME,\r
-                                          EXTRACTOR_METAFORMAT_UTF8,\r
-                                          "text/plain", stack->item->short_filename,\r
-                                          strlen (stack->item->short_filename) + 1);\r
-      }\r
-    }\r
-\r
-    stack->item->ksk_uri = GNUNET_FS_uri_ksk_create_from_meta_data (stack->item->meta);\r
-    GNUNET_FS_uri_ksk_get_keywords (stack->item->ksk_uri, &add_to_keyword_counter, stack->keywordcounter);\r
-    stack->item = stack->item->next;\r
-  }\r
-  /* Call this task again later, if there are more entries to process */\r
-  if (next)\r
-    GNUNET_SCHEDULER_add_continuation (&trim_share_tree_task, next,\r
-        GNUNET_SCHEDULER_REASON_PREREQ_DONE);\r
-}\r
-\r
-/**\r
- * Process a share item tree, moving frequent keywords up and\r
- * copying frequent metadata up.\r
- *\r
- * @param toplevel toplevel directory in the tree, returned by the scanner\r
- * @param cb called after processing is done\r
- * @param cls closure for 'cb'\r
- */\r
-struct ProcessMetadataContext *\r
-GNUNET_FS_trim_share_tree (struct ShareTreeItem *toplevel,\r
-    GNUNET_SCHEDULER_Task cb, void *cls)\r
-{\r
-  struct ProcessMetadataContext *ret;\r
-\r
-  if (toplevel == NULL)\r
-  {\r
-    struct GNUNET_SCHEDULER_TaskContext tc;\r
-    tc.reason = GNUNET_SCHEDULER_REASON_PREREQ_DONE;\r
-    cb (cls, &tc);\r
-    return NULL;\r
-  }\r
-\r
-  ret = GNUNET_malloc (sizeof (struct ProcessMetadataContext));\r
-  ret->toplevel = toplevel;\r
-  ret->stack = GNUNET_malloc (sizeof (struct ProcessMetadataStackItem));\r
-  ret->stack->ctx = ret;\r
-  ret->stack->item = toplevel;\r
-  ret->stack->keywordcounter = GNUNET_CONTAINER_multihashmap_create (1024);\r
-  ret->stack->metacounter = GNUNET_CONTAINER_multihashmap_create (1024);\r
-  ret->stack->dir_entry_count = 0;\r
-  ret->stack->end_directory = GNUNET_NO;\r
-\r
-  /* dummy stack entry that tells us we're at the top of the stack */\r
-  ret->stack->parent = GNUNET_malloc (sizeof (struct ProcessMetadataStackItem));\r
-  ret->stack->parent->ctx = ret;\r
-\r
-  ret->cb = cb;\r
-  ret->cls = cls;\r
-\r
-  GNUNET_SCHEDULER_add_continuation (&trim_share_tree_task, ret->stack,\r
-    GNUNET_SCHEDULER_REASON_PREREQ_DONE);\r
-  return ret;\r
-}
\ No newline at end of file
+/*
+     This file is part of GNUnet
+     (C) 2005-2012 Christian Grothoff (and other contributing authors)
+
+     GNUnet is free software; you can redistribute it and/or modify
+     it under the terms of the GNU General Public License as published
+     by the Free Software Foundation; either version 2, or (at your
+     option) any later version.
+
+     GNUnet is distributed in the hope that it will be useful, but
+     WITHOUT ANY WARRANTY; without even the implied warranty of
+     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+     General Public License for more details.
+
+     You should have received a copy of the GNU General Public License
+     along with GNUnet; see the file COPYING.  If not, write to the
+     Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+     Boston, MA 02111-1307, USA.
+*/
+
+#include "platform.h"
+#include "gnunet_fs_service.h"
+#include "gnunet_scheduler_lib.h"
+#include <pthread.h>
+
+/**
+ * Entry for each unique keyword to track how often
+ * it occured.  Contains the keyword and the counter.
+ */
+struct KeywordCounter
+{
+
+  /**
+   * Keyword that was found.
+   */
+  const char *value;
+
+  /**
+   * How many files have this keyword?
+   */
+  unsigned int count;
+
+  /**
+   * This is a doubly-linked list
+   */
+  struct KeywordCounter *prev;
+
+  /**
+   * This is a doubly-linked list
+   */
+  struct KeywordCounter *next;
+};
+
+/**
+ * Aggregate information we keep for meta data in each directory.
+ */
+struct MetaCounter
+{
+  /**
+   * The actual meta data.
+   */
+  const char *data;
+
+  /**
+   * Number of bytes in 'data'.
+   */
+  size_t data_size;
+
+  /**
+   * Name of the plugin that provided that piece of metadata
+   */
+  const char *plugin_name;
+
+  /**
+   * Type of the data
+   */
+  enum EXTRACTOR_MetaType type;
+
+  /**
+   * Format of the data
+   */
+  enum EXTRACTOR_MetaFormat format;
+
+  /**
+   * MIME-type of the metadata itself
+   */
+  const char *data_mime_type;
+
+  /**
+   * How many files have meta entries matching this value?
+   * (type and format do not have to match).
+   */
+  unsigned int count;
+
+  /**
+   * This is a doubly-linked list
+   */
+  struct MetaCounter *prev;
+
+  /**
+   * This is a doubly-linked list
+   */
+  struct MetaCounter *next;
+};
+
+struct AddDirContext;
+
+/**
+ * A structure used to hold a pointer to the tree item that is being
+ * processed.
+ * Needed to avoid changing the context for every recursive call.
+ */
+struct AddDirStack
+{
+  /**
+   * Context pointer
+   */
+  struct AddDirContext *adc;
+
+  /**
+   * Parent directory
+   */
+  struct GNUNET_FS_ShareTreeItem *parent;
+};
+
+/**
+ * Execution context for 'add_dir'
+ * Owned by the initiator thread.
+ */
+struct AddDirContext
+{
+  /**
+   * After the scan is finished, it will contain a pointer to the
+   * top-level directory entry in the directory tree built by the
+   * scanner.
+   */
+  struct GNUNET_FS_ShareTreeItem *toplevel;
+
+  /**
+   * Expanded filename (as given by the scan initiator).
+   * The scanner thread stores a copy here, and frees it when it finishes.
+   */
+  char *filename_expanded;
+
+  /**
+   * A pipe end to read signals from.
+   * Owned by the initiator thread.
+   */
+  const struct GNUNET_DISK_FileHandle *stop_read;
+
+  /**
+   * 1 if the scanner should stop, 0 otherwise. Set in response
+   * to communication errors or when the initiator wants the scanning
+   * process to stop.
+   */
+  char do_stop;
+
+  /**
+   * Handle of the pipe end into which the progress messages are written
+   * The pipe is owned by the initiator thread, and there's no way to
+   * close this end without having access to the pipe, so it won't
+   * be closed by the scanner thread.
+   * The initiator MUST keep it alive until the scanner thread is finished.
+   */
+  const struct GNUNET_DISK_FileHandle *progress_write;
+
+
+  /**
+   * List of libextractor plugins to use for extracting.
+   * Initialized when the scan starts, removed when it finishes.
+   */
+  struct EXTRACTOR_PluginList *plugins;
+};
+
+/**
+ * An opaque structure a pointer to which is returned to the
+ * caller to be used to control the scanner.
+ */
+struct GNUNET_FS_DirScanner
+{
+  /**
+   * A pipe end to read signals from.
+   * Owned by the initiator thread.
+   */
+  const struct GNUNET_DISK_FileHandle *stop_write;
+  
+  /**
+   * A pipe transfer signals to the scanner.
+   * Owned by the initiator thread.
+   */
+  struct GNUNET_DISK_PipeHandle *stop_pipe;
+
+ /**
+  * A thread object for the scanner thread.
+  * Owned by the initiator thread.
+  */
+#if WINDOWS
+  HANDLE thread;
+#else
+  pthread_t thread;
+#endif
+
+ /**
+  * A task for reading progress messages from the scanner.
+  */
+  GNUNET_SCHEDULER_TaskIdentifier progress_read_task;
+
+ /**
+  * The end of the pipe that is used to read progress messages.
+  */
+  const struct GNUNET_DISK_FileHandle *progress_read;
+
+ /**
+  * The pipe that is used to read progress messages.
+  * Owned (along with both of its ends) by the initiator thread.
+  * Only closed after the scanner thread is finished.
+  */
+  struct GNUNET_DISK_PipeHandle *progress_pipe;
+
+ /**
+  * The function that will be called every time there's a progress
+  * message.
+  */
+  GNUNET_FS_DirScannerProgressCallback progress_callback;
+
+ /**
+  * A closure for progress_callback.
+  */
+  void *cls;
+
+ /**
+  * A pointer to the context of the scanner.
+  * Owned by the initiator thread.
+  * Initiator thread shouldn't touch it until the scanner thread
+  * is finished.
+  */
+  struct AddDirContext *adc;
+};
+
+/**
+ * A structure that forms a singly-linked list that serves as a stack
+ * for metadata-processing function.
+ */
+struct ProcessMetadataStackItem
+{
+ /**
+  * A pointer to metadata-processing context.
+  * The same in every stack item.
+  */
+  struct GNUNET_FS_ProcessMetadataContext *ctx;
+
+ /**
+  * This is a singly-linked list. A pointer to its end is kept, and
+  * this pointer is used to walk it backwards.
+  */
+  struct ProcessMetadataStackItem *parent;
+
+  /**
+   * Map from the hash over the keyword to an 'struct KeywordCounter *'
+   * counter that says how often this keyword was
+   * encountered in the current directory.
+   */
+  struct GNUNET_CONTAINER_MultiHashMap *keywordcounter;
+
+  /**
+   * Map from the hash over the metadata to an 'struct MetaCounter *'
+   * counter that says how often this metadata was
+   * encountered in the current directory.
+   */
+  struct GNUNET_CONTAINER_MultiHashMap *metacounter;
+
+  /**
+   * Number of files in the current directory.
+   */
+  unsigned int dir_entry_count;
+
+  /**
+   * Keywords to exclude from using for KSK since they'll be associated
+   * with the parent as well.  NULL for nothing blocked.
+   */
+  struct GNUNET_FS_Uri *exclude_ksk;
+
+ /**
+  * A share tree item that is being processed.
+  */
+  struct GNUNET_FS_ShareTreeItem *item;
+
+ /**
+  * Set to GNUNET_YES to indicate that the directory pointer by 'item'
+  * was processed, and we should move on to the next.
+  * Otherwise the directory will be recursed into.
+  */
+  int end_directory;
+
+};
+
+/**
+ * The structure to keep the state of metadata processing
+ */
+struct GNUNET_FS_ProcessMetadataContext
+{
+ /**
+  * The top of the stack.
+  */
+  struct ProcessMetadataStackItem *stack;
+
+ /**
+  * Callback to invoke when processing is finished
+  */
+  GNUNET_SCHEDULER_Task cb;
+
+ /**
+  * Closure for 'cb'
+  */
+  void *cls;
+
+ /**
+  * Toplevel directory item of the tree to process.
+  */
+  struct GNUNET_FS_ShareTreeItem *toplevel;
+};
+
+/**
+ * Called every now and then by the scanner.
+ * Checks the synchronization privitive.
+ * Returns 1 if the scanner should stop, 0 otherwise.
+ */
+static int
+should_stop (struct AddDirContext *adc)
+{
+  errno = 0;
+  char c;
+  if (GNUNET_DISK_file_read_non_blocking (adc->stop_read, &c, 1) == 1
+      || errno != EAGAIN)
+  {
+    adc->do_stop = 1;
+  }
+  return adc->do_stop;
+}
+
+/**
+ * Write progress message.
+ * Format is:
+ * <reason><filename length><filename><directory flag>
+ * If filename is NULL, filename is not written, and its length
+ * is written as 0, and nothing else is written. It signals the initiator
+ * thread that the scanner is finished, and that it can now join its thread.
+ *
+ * Also checks if the initiator thread wants the scanner to stop,
+ * Returns 1 to stop scanning (if the signal was received, or
+ * if the pipe was broken somehow), 0 otherwise.
+ */
+static int
+write_progress (struct AddDirContext *adc, const char *filename,
+    char is_directory, enum GNUNET_FS_DirScannerProgressUpdateReason reason)
+{
+  size_t filename_len;
+  ssize_t wr;
+  size_t total_write;
+  if ((adc->do_stop || should_stop (adc)) && reason != GNUNET_DIR_SCANNER_ASKED_TO_STOP
+      && reason != GNUNET_DIR_SCANNER_FINISHED)
+    return 1;
+  total_write = 0;
+  wr = 1;
+  while ((wr > 0 || errno == EAGAIN) && total_write < sizeof (reason))
+  {
+    wr = GNUNET_DISK_file_write_blocking (adc->progress_write,
+      &((char *)&reason)[total_write], sizeof (reason) - total_write);
+    if (wr > 0)
+      total_write += wr;
+  }
+  if (sizeof (reason) != total_write)
+    return adc->do_stop = 1;
+  if (filename)
+    filename_len = strlen (filename) + 1;
+  else
+    filename_len = 0;
+  total_write = 0;
+  wr = 1;
+  while ((wr > 0 || errno == EAGAIN) && total_write < sizeof (size_t))
+  {
+    wr = GNUNET_DISK_file_write_blocking (adc->progress_write,
+      &((char *)&filename_len)[total_write], sizeof (size_t) - total_write);
+    if (wr > 0)
+      total_write += wr;
+  }
+  if (sizeof (size_t) != total_write)
+    return adc->do_stop = 1;
+  if (filename)
+  {
+    total_write = 0;
+    wr = 1;
+    while ((wr > 0 || errno == EAGAIN) && total_write < filename_len)
+    {
+      wr = GNUNET_DISK_file_write_blocking (adc->progress_write,
+        &((char *)filename)[total_write], filename_len - total_write);
+      if (wr > 0)
+        total_write += wr;
+    }
+    if (filename_len != total_write)
+      return adc->do_stop = 1;
+    total_write = 0;
+    wr = 1;
+    while ((wr > 0 || errno == EAGAIN) && total_write < sizeof (char))
+    {
+      wr = GNUNET_DISK_file_write_blocking (adc->progress_write,
+        &((char *)&is_directory)[total_write], sizeof (char) - total_write);
+      if (wr > 0)
+        total_write += wr;
+    }
+    if (sizeof (char) != total_write)
+      return adc->do_stop = 1;
+  }
+  return 0;
+}
+
+/**
+ * Add the given keyword to the
+ * keyword statistics tracker.
+ *
+ * @param cls closure (user-defined)
+ * @param keyword the keyword to count
+ * @param is_mandatory ignored
+ * @return always GNUNET_OK
+ */
+static int
+add_to_keyword_counter (void *cls, const char *keyword, int is_mandatory)
+{
+  struct GNUNET_CONTAINER_MultiHashMap *mcm = cls;
+  struct KeywordCounter *cnt, *first_cnt;
+  GNUNET_HashCode hc;
+  size_t klen;
+
+  klen = strlen (keyword) + 1;
+  GNUNET_CRYPTO_hash (keyword, klen - 1, &hc);
+  /* Since the map might contain multiple values per keyword, we only
+   * store one value, and attach all other to it, forming a linked list.
+   * Somewhat easier than retrieving multiple items via callback.
+   */
+  first_cnt = GNUNET_CONTAINER_multihashmap_get (mcm, &hc);
+  for (cnt = first_cnt; cnt && strcmp (cnt->value, keyword) != 0; cnt = cnt->next);
+  if (cnt == NULL)
+  {
+    cnt = GNUNET_malloc (sizeof (struct KeywordCounter) + klen);
+    cnt->value = (const char *) &cnt[1];
+    memcpy (&cnt[1], keyword, klen);
+    if (first_cnt != NULL)
+    {
+      if (first_cnt->prev != NULL)
+      {
+        first_cnt->prev->next = cnt;
+        cnt->prev = first_cnt->prev;
+      }
+      first_cnt->prev = cnt;
+      cnt->next = first_cnt;
+    }
+    else
+      GNUNET_CONTAINER_multihashmap_put (mcm, &hc, cnt,
+          GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE);
+  }
+  cnt->count++;
+  return GNUNET_OK;
+}
+
+/**
+ * Type of a function that libextractor calls for each
+ * meta data item found.
+ *
+ * @param cls the container multihashmap to update
+ * @param plugin_name name of the plugin that produced this value;
+ *        special values can be used (i.e. '&lt;zlib&gt;' for zlib being
+ *        used in the main libextractor library and yielding
+ *        meta data).
+ * @param type libextractor-type describing the meta data
+ * @param format basic format information about data
+ * @param data_mime_type mime-type of data (not of the original file);
+ *        can be NULL (if mime-type is not known)
+ * @param data actual meta-data found
+ * @param data_len number of bytes in data
+ * @return GNUNET_OK to continue extracting / iterating
+ */
+static int
+add_to_meta_counter (void *cls, const char *plugin_name,
+                enum EXTRACTOR_MetaType type, enum EXTRACTOR_MetaFormat format,
+                const char *data_mime_type, const char *data, size_t data_len)
+{
+  struct GNUNET_CONTAINER_MultiHashMap *map = cls;
+  GNUNET_HashCode key;
+  struct MetaCounter *cnt, *first_cnt;
+
+  GNUNET_CRYPTO_hash (data, data_len, &key);
+  first_cnt = GNUNET_CONTAINER_multihashmap_get (map, &key);
+  for (cnt = first_cnt; cnt
+      && cnt->data_size != data_len
+      && memcmp (cnt->data, data, cnt->data_size) != 0; cnt = cnt->next);
+  if (cnt == NULL)
+  {
+    cnt = GNUNET_malloc (sizeof (struct MetaCounter));
+    cnt->data = data;
+    cnt->data_size = data_len;
+    cnt->plugin_name = plugin_name;
+    cnt->type = type;
+    cnt->format = format;
+    cnt->data_mime_type = data_mime_type;
+
+    if (first_cnt != NULL)
+    {
+      if (first_cnt->prev != NULL)
+      {
+        first_cnt->prev->next = cnt;
+        cnt->prev = first_cnt->prev;
+      }
+      first_cnt->prev = cnt;
+      cnt->next = first_cnt;
+    }
+    else
+      GNUNET_CONTAINER_multihashmap_put (map, &key, cnt,
+          GNUNET_CONTAINER_MULTIHASHMAPOPTION_MULTIPLE);
+  }
+  cnt->count++;
+  return 0;
+}
+
+/**
+ * Allocates a struct GNUNET_FS_ShareTreeItem and adds it to its parent.
+ */
+static struct GNUNET_FS_ShareTreeItem *
+make_item (struct GNUNET_FS_ShareTreeItem *parent)
+{
+  struct GNUNET_FS_ShareTreeItem *item;
+  item = GNUNET_malloc (sizeof (struct GNUNET_FS_ShareTreeItem));
+
+  item->parent = parent;
+  if (parent)
+    GNUNET_CONTAINER_DLL_insert (parent->children_head, parent->children_tail,
+        item);
+  return item;
+}
+
+/**
+ * Extract metadata from a file and add it to the share tree
+ *
+ * @param adc context to modify
+ * @param filename name of the file to process
+ */
+static void
+extract_file (struct AddDirStack *ads, const char *filename)
+{
+  struct GNUNET_FS_ShareTreeItem *item;
+  const char *short_fn;
+
+  item = make_item (ads->parent);
+
+  GNUNET_DISK_file_size (filename, &item->file_size, GNUNET_YES);
+  item->is_directory = GNUNET_NO;
+
+  item->meta = GNUNET_CONTAINER_meta_data_create ();
+  GNUNET_FS_meta_data_extract_from_file (item->meta, filename,
+      ads->adc->plugins);
+  GNUNET_CONTAINER_meta_data_delete (item->meta, EXTRACTOR_METATYPE_FILENAME,
+      NULL, 0);
+  short_fn = GNUNET_STRINGS_get_short_name (filename);
+
+  item->filename = GNUNET_strdup (filename);
+  item->short_filename = GNUNET_strdup (short_fn);
+
+  GNUNET_CONTAINER_meta_data_insert (item->meta, "<libgnunetfs>",
+                                     EXTRACTOR_METATYPE_FILENAME,
+                                     EXTRACTOR_METAFORMAT_UTF8, "text/plain",
+                                     short_fn, strlen (short_fn) + 1);
+}
+
+/**
+ * Remove the keyword from the ksk URI.
+ *
+ * @param cls the ksk uri
+ * @param keyword the word to remove
+ * @param is_mandatory ignored
+ * @return always GNUNET_OK
+ */
+static int
+remove_keyword (void *cls, const char *keyword, int is_mandatory)
+{
+  struct GNUNET_FS_Uri *ksk = cls;
+
+  GNUNET_FS_uri_ksk_remove_keyword (ksk, keyword);
+  return GNUNET_OK;
+}
+
+/**
+ * Remove keywords from current directory's children, if they are
+ * in the exluded keywords list of that directory.
+ *
+ * @param cls the ksk uri
+ * @param keyword the word to remove
+ * @param is_mandatory ignored
+ * @return always GNUNET_OK
+ */
+static int
+remove_keywords (struct ProcessMetadataStackItem *stack, struct GNUNET_FS_ShareTreeItem *dir)
+{
+  struct GNUNET_FS_ShareTreeItem *item;
+
+  for (item = dir->children_head; item; item = item->next)
+  {
+    if (stack->exclude_ksk != NULL)
+      GNUNET_FS_uri_ksk_get_keywords (stack->exclude_ksk, &remove_keyword, item->ksk_uri);
+  }
+  return GNUNET_OK;
+}
+
+/**
+ * Context passed to 'migrate_and_drop'.
+ */
+struct KeywordProcessContext
+{
+  /**
+   * All the keywords we migrated to the parent.
+   */
+  struct GNUNET_FS_Uri *ksk;
+
+  /**
+   * How often does a keyword have to occur to be
+   * migrated to the parent?
+   */
+  unsigned int threshold;
+};
+
+/**
+ * Context passed to 'migrate_and_drop'.
+ */
+struct MetaProcessContext
+{
+  /**
+   * All the metadata we copy to the parent.
+   */
+  struct GNUNET_CONTAINER_MetaData *meta;
+
+  /**
+   * How often does a metadata have to occur to be
+   * migrated to the parent?
+   */
+  unsigned int threshold;
+};
+
+
+/**
+ * Move "frequent" keywords over to the
+ * target ksk uri, free the counters.
+ *
+ */
+static int
+migrate_and_drop (void *cls, const GNUNET_HashCode * key, void *value)
+{
+  struct KeywordProcessContext *kpc = cls;
+  struct KeywordCounter *counter = value;
+
+  if (counter->count >= kpc->threshold && counter->count > 1)
+  {
+    GNUNET_FS_uri_ksk_add_keyword (kpc->ksk, counter->value, GNUNET_NO);
+  }
+  GNUNET_free (counter);
+  return GNUNET_YES;
+}
+/**
+ * Copy "frequent" metadata items over to the
+ * target metadata container, free the counters.
+ *
+ */
+static int
+migrate_and_drop_metadata (void *cls, const GNUNET_HashCode * key, void *value)
+{
+  struct MetaProcessContext *mpc = cls;
+  struct MetaCounter *counter = value;
+
+  if (counter->count >= mpc->threshold && counter->count > 1)
+  {
+    GNUNET_CONTAINER_meta_data_insert (mpc->meta,
+                                   counter->plugin_name,
+                                   counter->type,
+                                   counter->format,
+                                   counter->data_mime_type, counter->data,
+                                   counter->data_size);
+  }
+  GNUNET_free (counter);
+  return GNUNET_YES;
+}
+
+/**
+ * Go over the collected keywords from all entries in the
+ * directory and push common keywords up one level (by
+ * adding it to the returned struct). Do the same for metadata.
+ * Destroys keywordcounter and metacoutner for current directory.
+ *
+ * @param adc collection of child meta data
+ * @param exclude_ksk pointer to where moveable keywords will be stored
+ * @param copy_meta pointer to where copyable metadata will be stored
+ */
+static void
+process_keywords_and_metadata (struct ProcessMetadataStackItem *stack,
+    struct GNUNET_FS_Uri **exclude_ksk,
+    struct GNUNET_CONTAINER_MetaData **copy_meta)
+{
+  struct KeywordProcessContext kpc;
+  struct MetaProcessContext mpc;
+  struct GNUNET_CONTAINER_MetaData *tmp;
+
+  /* Surprisingly, it's impossible to create a ksk with 0 keywords directly.
+   * But we can create one from an empty metadata set
+   */
+  tmp = GNUNET_CONTAINER_meta_data_create ();
+  kpc.ksk = GNUNET_FS_uri_ksk_create_from_meta_data (tmp);
+  GNUNET_CONTAINER_meta_data_destroy (tmp);
+  mpc.meta = GNUNET_CONTAINER_meta_data_create ();
+
+  kpc.threshold = mpc.threshold = (stack->dir_entry_count + 1) / 2; /* 50% */
+
+  GNUNET_CONTAINER_multihashmap_iterate (stack->keywordcounter,
+      &migrate_and_drop, &kpc);
+  GNUNET_CONTAINER_multihashmap_iterate (stack->metacounter,
+      &migrate_and_drop_metadata, &mpc);
+
+  GNUNET_CONTAINER_multihashmap_destroy (stack->keywordcounter);
+  GNUNET_CONTAINER_multihashmap_destroy (stack->metacounter);
+  *exclude_ksk = kpc.ksk;
+  *copy_meta = mpc.meta;
+}
+
+/**
+ * Function called by the directory iterator to
+ * (recursively) add all of the files in the
+ * directory to the tree.
+ * Called by the directory scanner to initiate the
+ * scan.
+ * TODO: find a way to make it non-recursive.
+ *
+ * @param cls the 'struct AddDirStack *' we're in
+ * @param filename file or directory to scan
+ */
+static int
+scan_directory (void *cls, const char *filename)
+{
+  struct AddDirStack *ads = cls, recurse_ads;
+  struct AddDirContext *adc = ads->adc;
+  struct stat sbuf;
+  struct GNUNET_FS_ShareTreeItem *item;
+  const char *short_fn;
+  int do_stop = 0;
+
+  /* Wrap up fast */
+  if (adc->do_stop)
+    return GNUNET_SYSERR;
+
+  /* If the file doesn't exist (or is not statable for any other reason,
+   * skip it, and report it.
+   */
+  if (0 != STAT (filename, &sbuf))
+  {
+    do_stop = write_progress (adc, filename, S_ISDIR (sbuf.st_mode),
+      GNUNET_DIR_SCANNER_DOES_NOT_EXIST);
+    return GNUNET_OK;
+  }
+
+  /* Report the progress */
+  do_stop = write_progress (adc, filename, S_ISDIR (sbuf.st_mode),
+    GNUNET_DIR_SCANNER_NEW_FILE);
+  if (do_stop)
+  {
+    /* We were asked to stop, acknowledge that and return */
+    do_stop = write_progress (adc, filename, S_ISDIR (sbuf.st_mode),
+      GNUNET_DIR_SCANNER_ASKED_TO_STOP);
+    return GNUNET_SYSERR;
+  }
+
+  if (!S_ISDIR (sbuf.st_mode))
+    extract_file (ads, filename);
+  else
+  {
+    item = make_item (ads->parent);
+    item->meta = GNUNET_CONTAINER_meta_data_create ();
+
+    item->is_directory = GNUNET_YES;
+
+    recurse_ads.adc = adc;
+    recurse_ads.parent = item;
+
+    /* recurse into directory */
+    GNUNET_DISK_directory_scan (filename, &scan_directory, &recurse_ads);
+
+    short_fn = GNUNET_STRINGS_get_short_name (filename);
+
+    item->filename = GNUNET_strdup (filename);
+    item->short_filename = GNUNET_strdup (short_fn);
+
+    if (ads->parent == NULL)
+    {
+      /* we're finished with the scan, make sure caller gets the top-level
+       * directory pointer
+       */
+      adc->toplevel = item;
+    }
+  }
+  return GNUNET_OK;
+}
+
+/**
+ * Signals the scanner to finish the scan as fast as possible.
+ * Does not block.
+ * Can close the pipe if asked to, but that is only used by the
+ * internal call to this function during cleanup. The client
+ * must understand the consequences of closing the pipe too early.
+ *
+ * @param ds directory scanner structure
+ * @param close_pipe GNUNET_YES to close
+ */
+void
+GNUNET_FS_directory_scan_finish (struct GNUNET_FS_DirScanner *ds,
+    int close_pipe)
+{
+  char c = 1;
+  GNUNET_DISK_file_write (ds->stop_write, &c, 1);
+
+  if (close_pipe)
+  {
+    if (ds->progress_read_task != GNUNET_SCHEDULER_NO_TASK)
+    {
+      GNUNET_SCHEDULER_cancel (ds->progress_read_task);
+      ds->progress_read_task = GNUNET_SCHEDULER_NO_TASK;
+    }
+    GNUNET_DISK_pipe_close_end (ds->progress_pipe, GNUNET_DISK_PIPE_END_READ);
+    ds->progress_read = NULL;
+  }
+}
+
+/**
+ * Signals the scanner thread to finish (in case it isn't finishing
+ * already) and joins the scanner thread. Closes the pipes, frees the
+ * scanner contexts (both of them), returns the results of the scan.
+ * Results are valid (and have to be freed) even if the scanner had
+ * an error or was rushed to finish prematurely.
+ * Blocks until the scanner is finished.
+ *
+ * @param ds directory scanner structure
+ * @return the results of the scan (a directory tree)
+ */
+struct GNUNET_FS_ShareTreeItem *
+GNUNET_FS_directory_scan_cleanup (struct GNUNET_FS_DirScanner *ds)
+{
+  struct GNUNET_FS_ShareTreeItem *result;
+
+  GNUNET_FS_directory_scan_finish (ds, GNUNET_YES);
+#if WINDOWS
+  WaitForSingleObject (ds->thread, INFINITE);
+  CloseHandle (ds->thread);
+#else
+  pthread_join (ds->thread, NULL);
+  pthread_detach (ds->thread);
+#endif
+
+  GNUNET_DISK_pipe_close (ds->stop_pipe);
+  GNUNET_DISK_pipe_close (ds->progress_pipe);
+  result = ds->adc->toplevel;
+  GNUNET_free (ds->adc);
+  GNUNET_free (ds);
+  return result;
+}
+
+/**
+ * The function from which the scanner thread starts
+ */
+#if WINDOWS
+static DWORD
+#else
+static void *
+#endif
+run_directory_scan_thread (void *cls)
+{
+  struct AddDirContext *adc = cls;
+  struct AddDirStack ads;
+  ads.adc = adc;
+  ads.parent = NULL;
+  scan_directory (&ads, adc->filename_expanded);
+  GNUNET_free (adc->filename_expanded);
+  if (adc->plugins != NULL)
+    EXTRACTOR_plugin_remove_all (adc->plugins);
+  /* Tell the initiator that we're finished, it can now join the thread */
+  write_progress (adc, NULL, 0, GNUNET_DIR_SCANNER_FINISHED);
+  return 0;
+}
+
+/**
+ * Called every time there is data to read from the scanner.
+ * Calls the scanner progress handler.
+ *
+ * @param cls the closure (directory scanner object)
+ * @param tc task context in which the task is running
+ */
+static void
+read_progress_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
+{
+  struct GNUNET_FS_DirScanner *ds;
+  int end_it = 0;
+  enum GNUNET_FS_DirScannerProgressUpdateReason reason;
+  ssize_t rd;
+  ssize_t total_read;
+
+  size_t filename_len;
+  char is_directory;
+  char *filename;
+
+  ds = cls;
+
+  ds->progress_read_task = GNUNET_SCHEDULER_NO_TASK;
+
+  if (!(tc->reason & GNUNET_SCHEDULER_REASON_READ_READY))
+  {
+    ds->progress_callback (ds->cls, ds, NULL, 0, GNUNET_DIR_SCANNER_SHUTDOWN);
+    return;
+  }
+
+  /* Read one message. If message is malformed or can't be read, end the scanner */
+  total_read = rd = GNUNET_DISK_file_read (ds->progress_read, &reason, sizeof (reason));
+  while (rd > 0 && total_read < sizeof (reason))
+  {
+    rd = GNUNET_DISK_file_read (ds->progress_read,
+        &((char *) &reason)[total_read],
+        sizeof (reason) - total_read);
+    if (rd > 0)
+      total_read += rd;
+  }
+  if (total_read != sizeof (reason)
+      || reason <= GNUNET_DIR_SCANNER_FIRST
+      || reason >= GNUNET_DIR_SCANNER_LAST)
+  {
+    end_it = 1;
+    reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;
+  }
+
+  if (!end_it)
+  {
+    total_read = rd = GNUNET_DISK_file_read (ds->progress_read, &filename_len,
+        sizeof (size_t));
+    while (rd > 0 && total_read < sizeof (size_t))
+    {
+      rd = GNUNET_DISK_file_read (ds->progress_read,
+          &((char *) &filename_len)[total_read],
+          sizeof (size_t) - total_read);
+      if (rd > 0)
+        total_read += rd;
+    }
+    if (rd != sizeof (size_t))
+    {
+      end_it = 1;
+      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;
+    }
+  }
+  if (!end_it)
+  {
+    if (filename_len == 0)
+      end_it = 1;
+    else if (filename_len > PATH_MAX)
+    {
+      end_it = 1;
+      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;
+    }
+  }
+  if (!end_it)
+  {
+    filename = GNUNET_malloc (filename_len);
+    total_read = rd = GNUNET_DISK_file_read (ds->progress_read, filename,
+        filename_len);
+    while (rd > 0 && total_read < filename_len)
+    {
+      rd = GNUNET_DISK_file_read (ds->progress_read, &filename[total_read],
+          filename_len - total_read);
+      if (rd > 0)
+        total_read += rd;
+    }
+    if (rd != filename_len)
+    {
+      GNUNET_free (filename);
+      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;
+      end_it = 1;
+    }
+  }
+  if (!end_it && filename_len > 0)
+  {
+    total_read = rd = GNUNET_DISK_file_read (ds->progress_read, &is_directory,
+        sizeof (char));
+    while (rd > 0 && total_read < sizeof (char))
+    {
+      rd = GNUNET_DISK_file_read (ds->progress_read, &(&is_directory)[total_read],
+          sizeof (char) - total_read);
+      if (rd > 0)
+        total_read += rd;
+    }
+    if (rd != sizeof (char))
+    {
+      GNUNET_free (filename);
+      reason = GNUNET_DIR_SCANNER_PROTOCOL_ERROR;
+      end_it = 1;
+    }
+  }
+  if (!end_it)
+  {
+    end_it = ds->progress_callback (ds->cls, ds, (const char *) filename, is_directory, reason);
+    GNUNET_free (filename);
+    if (!end_it)
+    {
+      ds->progress_read_task = GNUNET_SCHEDULER_add_read_file (
+          GNUNET_TIME_UNIT_FOREVER_REL, ds->progress_read, &read_progress_task,
+          cls);
+    }
+  }
+  else
+  {
+    ds->progress_callback (ds->cls, ds, NULL, 0, reason);
+  }
+}
+
+
+/**
+ * Start a directory scanner thread.
+ *
+ * @param filename name of the directory to scan
+ * @param GNUNET_YES to not to run libextractor on files (only build a tree)
+ * @param ex if not NULL, must be a list of extra plugins for extractor
+ * @param cb the callback to call when there are scanning progress messages
+ * @param cls closure for 'cb'
+ * @return directory scanner object to be used for controlling the scanner
+ */
+struct GNUNET_FS_DirScanner *
+GNUNET_FS_directory_scan_start (const char *filename,
+    int disable_extractor, const char *ex,
+    GNUNET_FS_DirScannerProgressCallback cb, void *cls)
+{
+  struct stat sbuf;
+  struct AddDirContext *adc;
+  char *filename_expanded;
+  struct GNUNET_FS_DirScanner *ds;
+  struct GNUNET_DISK_PipeHandle *progress_pipe;
+  int ok;
+
+  if (0 != STAT (filename, &sbuf))
+    return NULL;
+  /* TODO: consider generalizing this for files too! */
+  if (!S_ISDIR (sbuf.st_mode))
+  {
+    GNUNET_break (0);
+    return NULL;
+  }
+  /* scan_directory() is guaranteed to be given expanded filenames,
+   * so expand we will!
+   */
+  filename_expanded = GNUNET_STRINGS_filename_expand (filename);
+  if (filename_expanded == NULL)
+    return NULL;
+
+  progress_pipe = GNUNET_DISK_pipe (GNUNET_NO, GNUNET_NO, GNUNET_NO, GNUNET_NO);
+  if (progress_pipe == NULL)
+  {
+    GNUNET_free (filename_expanded);
+    return NULL;
+  }
+
+  adc = GNUNET_malloc (sizeof (struct AddDirContext));
+
+  ds = GNUNET_malloc (sizeof (struct GNUNET_FS_DirScanner));
+
+  ds->adc = adc;
+
+  ds->stop_pipe = GNUNET_DISK_pipe (GNUNET_NO, GNUNET_NO, GNUNET_NO, GNUNET_NO);
+  if (ds->stop_pipe == NULL)
+  {
+    GNUNET_free (adc);
+    GNUNET_free (ds);
+    GNUNET_free (filename_expanded);
+    GNUNET_DISK_pipe_close (progress_pipe);
+    return NULL;
+  }
+  ds->stop_write = GNUNET_DISK_pipe_handle (ds->stop_pipe,
+      GNUNET_DISK_PIPE_END_WRITE);
+  adc->stop_read = GNUNET_DISK_pipe_handle (ds->stop_pipe,
+      GNUNET_DISK_PIPE_END_READ);
+
+  adc->plugins = NULL;
+  if (!disable_extractor)
+  {
+    adc->plugins = EXTRACTOR_plugin_add_defaults (
+        EXTRACTOR_OPTION_DEFAULT_POLICY);
+    if (ex && strlen (ex) > 0)
+      adc->plugins = EXTRACTOR_plugin_add_config (adc->plugins, ex,
+          EXTRACTOR_OPTION_DEFAULT_POLICY);
+  }
+
+  adc->filename_expanded = filename_expanded;
+  adc->progress_write = GNUNET_DISK_pipe_handle (progress_pipe,
+      GNUNET_DISK_PIPE_END_WRITE);
+
+
+  ds->progress_read = GNUNET_DISK_pipe_handle (progress_pipe,
+      GNUNET_DISK_PIPE_END_READ);
+
+#if WINDOWS
+  ds->thread = CreateThread (NULL, 0,
+      (LPTHREAD_START_ROUTINE) &run_directory_scan_thread, (LPVOID) adc,
+      0, NULL);
+  ok = ds->thread != NULL;
+#else
+  ok = !pthread_create (&ds->thread, NULL, &run_directory_scan_thread,
+      (void *) adc);
+#endif
+  if (!ok)
+  {
+    GNUNET_free (adc);
+    GNUNET_free (filename_expanded);
+    GNUNET_DISK_pipe_close (progress_pipe);
+    GNUNET_free (ds);
+    return NULL;
+  }
+
+  ds->progress_callback = cb;
+  ds->cls = cls;
+  ds->adc = adc;
+  ds->progress_pipe = progress_pipe;
+
+  ds->progress_read_task = GNUNET_SCHEDULER_add_read_file (
+      GNUNET_TIME_UNIT_FOREVER_REL, ds->progress_read, &read_progress_task,
+      ds);
+
+  return ds;
+}
+
+/**
+ * Task that post-processes the share item tree.
+ * This processing has to be done in the main thread, because
+ * it requires access to libgcrypt's hashing functions, and
+ * libgcrypt is not thread-safe without some special magic.
+ *
+ * @param cls top of the stack
+ * @param tc task context
+ */
+static void
+trim_share_tree_task (void *cls,
+  const struct GNUNET_SCHEDULER_TaskContext *tc)
+{
+  struct ProcessMetadataStackItem *stack = cls;
+  struct ProcessMetadataStackItem *next = stack;
+  /* FIXME: figure out what to do when tc says we're shutting down */
+
+  /* item == NULL means that we've just finished going over the children of
+   * current directory.
+   */
+  if (stack->item == NULL)
+  {
+    if (stack->parent->item != NULL)
+    {
+      /* end of a directory */
+      struct GNUNET_FS_Uri *ksk;
+
+      /* use keyword and metadata counters to create lists of keywords to move
+       * and metadata to copy.
+       */
+      process_keywords_and_metadata (stack, &stack->parent->exclude_ksk, &stack->parent->item->meta);
+
+      /* create keywords from metadata (copies all text-metadata as keywords,
+       * AND parses the directory name we've just added, producing even more
+       * keywords.
+       * then merge these keywords with the ones moved from children.
+       */
+      ksk = GNUNET_FS_uri_ksk_create_from_meta_data (stack->parent->item->meta);
+      stack->parent->item->ksk_uri = GNUNET_FS_uri_ksk_merge (ksk, stack->parent->exclude_ksk);
+      GNUNET_FS_uri_destroy (ksk);
+
+      /* remove moved keywords from children (complete the move) */
+      remove_keywords (stack->parent, stack->parent->item);
+      GNUNET_FS_uri_destroy (stack->parent->exclude_ksk);
+
+      /* go up the stack */
+      next = stack->parent;
+      GNUNET_free (stack);
+      next->end_directory = GNUNET_YES;
+    }
+    else
+    {
+      /* we've just finished processing the toplevel directory */
+      struct GNUNET_FS_ProcessMetadataContext *ctx = stack->ctx;
+      next = NULL;
+      GNUNET_SCHEDULER_add_continuation (ctx->cb, ctx->cls,
+          GNUNET_SCHEDULER_REASON_PREREQ_DONE);
+      GNUNET_free (stack->parent);
+      GNUNET_free (stack);
+      GNUNET_free (ctx);
+    }
+  }
+  else if (stack->item->is_directory
+      && !stack->end_directory
+      && stack->item->children_head != NULL)
+  {
+    /* recurse into subdirectory */
+    next = GNUNET_malloc (sizeof (struct ProcessMetadataStackItem));
+    next->ctx = stack->ctx;
+    next->item = stack->item->children_head;
+    next->keywordcounter = GNUNET_CONTAINER_multihashmap_create (1024);
+    next->metacounter = GNUNET_CONTAINER_multihashmap_create (1024);
+    next->dir_entry_count = 0;
+    next->parent = stack;
+  }
+  else
+  {
+    /* process a child entry (a file or a directory) and move to the next one*/
+    if (stack->item->is_directory)
+      stack->end_directory = GNUNET_NO;
+    stack->dir_entry_count++;
+    GNUNET_CONTAINER_meta_data_iterate (stack->item->meta, &add_to_meta_counter, stack->metacounter);
+
+    if (stack->item->is_directory)
+    {
+      char *user = getenv ("USER");
+      if ((user == NULL) || (0 != strncasecmp (user, stack->item->short_filename, strlen(user))))
+      {
+        /* only use filename if it doesn't match $USER */
+        GNUNET_CONTAINER_meta_data_insert (stack->item->meta, "<libgnunetfs>",
+                                          EXTRACTOR_METATYPE_FILENAME,
+                                          EXTRACTOR_METAFORMAT_UTF8,
+                                          "text/plain", stack->item->short_filename,
+                                          strlen (stack->item->short_filename) + 1);
+        GNUNET_CONTAINER_meta_data_insert (stack->item->meta, "<libgnunetfs>",
+                                          EXTRACTOR_METATYPE_GNUNET_ORIGINAL_FILENAME,
+                                          EXTRACTOR_METAFORMAT_UTF8,
+                                          "text/plain", stack->item->short_filename,
+                                          strlen (stack->item->short_filename) + 1);
+      }
+    }
+
+    stack->item->ksk_uri = GNUNET_FS_uri_ksk_create_from_meta_data (stack->item->meta);
+    GNUNET_FS_uri_ksk_get_keywords (stack->item->ksk_uri, &add_to_keyword_counter, stack->keywordcounter);
+    stack->item = stack->item->next;
+  }
+  /* Call this task again later, if there are more entries to process */
+  if (next)
+    GNUNET_SCHEDULER_add_continuation (&trim_share_tree_task, next,
+        GNUNET_SCHEDULER_REASON_PREREQ_DONE);
+}
+
+/**
+ * Process a share item tree, moving frequent keywords up and
+ * copying frequent metadata up.
+ *
+ * @param toplevel toplevel directory in the tree, returned by the scanner
+ * @param cb called after processing is done
+ * @param cls closure for 'cb'
+ */
+struct GNUNET_FS_ProcessMetadataContext *
+GNUNET_FS_trim_share_tree (struct GNUNET_FS_ShareTreeItem *toplevel,
+    GNUNET_SCHEDULER_Task cb, void *cls)
+{
+  struct GNUNET_FS_ProcessMetadataContext *ret;
+
+  if (toplevel == NULL)
+  {
+    struct GNUNET_SCHEDULER_TaskContext tc;
+    tc.reason = GNUNET_SCHEDULER_REASON_PREREQ_DONE;
+    cb (cls, &tc);
+    return NULL;
+  }
+
+  ret = GNUNET_malloc (sizeof (struct GNUNET_FS_ProcessMetadataContext));
+  ret->toplevel = toplevel;
+  ret->stack = GNUNET_malloc (sizeof (struct ProcessMetadataStackItem));
+  ret->stack->ctx = ret;
+  ret->stack->item = toplevel;
+  ret->stack->keywordcounter = GNUNET_CONTAINER_multihashmap_create (1024);
+  ret->stack->metacounter = GNUNET_CONTAINER_multihashmap_create (1024);
+  ret->stack->dir_entry_count = 0;
+  ret->stack->end_directory = GNUNET_NO;
+
+  /* dummy stack entry that tells us we're at the top of the stack */
+  ret->stack->parent = GNUNET_malloc (sizeof (struct ProcessMetadataStackItem));
+  ret->stack->parent->ctx = ret;
+
+  ret->cb = cb;
+  ret->cls = cls;
+
+  GNUNET_SCHEDULER_add_continuation (&trim_share_tree_task, ret->stack,
+    GNUNET_SCHEDULER_REASON_PREREQ_DONE);
+  return ret;
+}
index ec353de8ecfe1683f547472c3695adcbfdb0fa07..48fef170b1841824e7cf9b7bffd5de2bbd3b10a1 100644 (file)
@@ -2692,7 +2692,7 @@ GNUNET_FS_directory_builder_finish (struct GNUNET_FS_DirectoryBuilder *bld,
 
 /* ******************** DirScanner API *********************** */
 
-enum GNUNET_DirScannerProgressUpdateReason
+enum GNUNET_FS_DirScannerProgressUpdateReason
 {
   GNUNET_DIR_SCANNER_FIRST = 0,
   GNUNET_DIR_SCANNER_NEW_FILE = 1,
@@ -2707,40 +2707,40 @@ enum GNUNET_DirScannerProgressUpdateReason
 
 typedef int (* GNUNET_FS_DirScannerProgressCallback) (
     void *cls, struct GNUNET_FS_DirScanner *ds, const char *filename,
-    char is_directory, enum GNUNET_DirScannerProgressUpdateReason reason);
+    char is_directory, enum GNUNET_FS_DirScannerProgressUpdateReason reason);
 
 /**
  * A node of a directory tree (produced by dirscanner)
  */
-struct ShareTreeItem
+struct GNUNET_FS_ShareTreeItem
 {
   /**
    * This is a doubly-linked list
    */
-  struct ShareTreeItem *prev;
+  struct GNUNET_FS_ShareTreeItem *prev;
 
   /**
    * This is a doubly-linked list
    */
-  struct ShareTreeItem *next;
+  struct GNUNET_FS_ShareTreeItem *next;
 
   /**
    * This is a doubly-linked tree
    * NULL for top-level entries.
    */
-  struct ShareTreeItem *parent;
+  struct GNUNET_FS_ShareTreeItem *parent;
 
   /**
    * This is a doubly-linked tree
    * NULL for files and empty directories
    */
-  struct ShareTreeItem *children_head;
+  struct GNUNET_FS_ShareTreeItem *children_head;
 
   /**
    * This is a doubly-linked tree
    * NULL for files and empty directories
    */
-  struct ShareTreeItem *children_tail;
+  struct GNUNET_FS_ShareTreeItem *children_tail;
 
   /**
    * Metadata for this file or directory
@@ -2801,7 +2801,7 @@ GNUNET_FS_directory_scan_finish (struct GNUNET_FS_DirScanner *ds,
  * @param ds directory scanner structure
  * @return the results of the scan (a directory tree)
  */
-struct ShareTreeItem *
+struct GNUNET_FS_ShareTreeItem *
 GNUNET_FS_directory_scan_cleanup (struct GNUNET_FS_DirScanner *ds);
 
 /**
@@ -2821,7 +2821,7 @@ GNUNET_FS_directory_scan_start (const char *filename,
 
 
 /* opaque */
-struct ProcessMetadataContext;
+struct GNUNET_FS_ProcessMetadataContext;
 
 /**
  * Process a share item tree, moving frequent keywords up and
@@ -2831,8 +2831,8 @@ struct ProcessMetadataContext;
  * @param cb called after processing is done
  * @param cls closure for 'cb'
  */
-struct ProcessMetadataContext *
-GNUNET_FS_trim_share_tree (struct ShareTreeItem *toplevel,
+struct GNUNET_FS_ProcessMetadataContext *
+GNUNET_FS_trim_share_tree (struct GNUNET_FS_ShareTreeItem *toplevel,
     GNUNET_SCHEDULER_Task cb, void *cls);