aboutsummaryrefslogtreecommitdiff
path: root/src/fs
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2011-08-29 10:19:43 +0000
committerChristian Grothoff <christian@grothoff.org>2011-08-29 10:19:43 +0000
commitcddbdf5b928c68ab71b40c950b9f01ea68a9fbdb (patch)
treeb704e00a3af618b2cd174a7f89514eaebd82a1cf /src/fs
parentbb4fc4f4007988874f910d4de5492f9629301641 (diff)
downloadgnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.tar.gz
gnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.zip
run indent twice, it alternates between two 'canonical' forms, also run whitespace remover
Diffstat (limited to 'src/fs')
-rw-r--r--src/fs/fs.c56
-rw-r--r--src/fs/fs.h48
-rw-r--r--src/fs/fs_directory.c8
-rw-r--r--src/fs/fs_download.c26
-rw-r--r--src/fs/fs_file_information.c4
-rw-r--r--src/fs/fs_misc.c2
-rw-r--r--src/fs/fs_namespace.c20
-rw-r--r--src/fs/fs_publish.c16
-rw-r--r--src/fs/fs_search.c10
-rw-r--r--src/fs/fs_tree.c12
-rw-r--r--src/fs/fs_tree.h14
-rw-r--r--src/fs/fs_unindex.c4
-rw-r--r--src/fs/fs_uri.c10
-rw-r--r--src/fs/gnunet-download.c2
-rw-r--r--src/fs/gnunet-publish.c2
-rw-r--r--src/fs/gnunet-search.c4
-rw-r--r--src/fs/gnunet-service-fs.c14
-rw-r--r--src/fs/gnunet-service-fs.h8
-rw-r--r--src/fs/gnunet-service-fs_cp.c12
-rw-r--r--src/fs/gnunet-service-fs_cp.h4
-rw-r--r--src/fs/gnunet-service-fs_lc.c4
-rw-r--r--src/fs/gnunet-service-fs_pe.c8
-rw-r--r--src/fs/gnunet-service-fs_pe.h2
-rw-r--r--src/fs/gnunet-service-fs_pr.c14
-rw-r--r--src/fs/gnunet-service-fs_pr.h8
-rw-r--r--src/fs/gnunet-service-fs_push.c10
-rw-r--r--src/fs/gnunet-service-fs_put.c6
-rw-r--r--src/fs/gnunet-unindex.c2
-rw-r--r--src/fs/perf_gnunet_service_fs_p2p_trust.c2
-rw-r--r--src/fs/test_fs_download_persistence.c4
-rw-r--r--src/fs/test_fs_publish_persistence.c4
-rw-r--r--src/fs/test_fs_search_persistence.c4
-rw-r--r--src/fs/test_fs_unindex_persistence.c4
33 files changed, 174 insertions, 174 deletions
diff --git a/src/fs/fs.c b/src/fs/fs.c
index fc1388a04..93971075a 100644
--- a/src/fs/fs.c
+++ b/src/fs/fs.c
@@ -213,7 +213,7 @@ GNUNET_FS_make_top (struct GNUNET_FS_Handle *h, SuspendSignalFunction ssf,
213 213
214/** 214/**
215 * Destroy a top-level activity entry. 215 * Destroy a top-level activity entry.
216 * 216 *
217 * @param h global fs handle 217 * @param h global fs handle
218 * @param top top level activity entry 218 * @param top top level activity entry
219 */ 219 */
@@ -250,7 +250,7 @@ struct FileInfo
250 * @param offset offset to read from; it is possible 250 * @param offset offset to read from; it is possible
251 * that the caller might need to go backwards 251 * that the caller might need to go backwards
252 * a bit at times 252 * a bit at times
253 * @param max maximum number of bytes that should be 253 * @param max maximum number of bytes that should be
254 * copied to buf; readers are not allowed 254 * copied to buf; readers are not allowed
255 * to provide less data unless there is an error; 255 * to provide less data unless there is an error;
256 * a value of "0" will be used at the end to allow 256 * a value of "0" will be used at the end to allow
@@ -333,7 +333,7 @@ GNUNET_FS_make_file_reader_context_ (const char *filename)
333 * @param offset offset to read from; it is possible 333 * @param offset offset to read from; it is possible
334 * that the caller might need to go backwards 334 * that the caller might need to go backwards
335 * a bit at times 335 * a bit at times
336 * @param max maximum number of bytes that should be 336 * @param max maximum number of bytes that should be
337 * copied to buf; readers are not allowed 337 * copied to buf; readers are not allowed
338 * to provide less data unless there is an error; 338 * to provide less data unless there is an error;
339 * a value of "0" will be used at the end to allow 339 * a value of "0" will be used at the end to allow
@@ -363,7 +363,7 @@ GNUNET_FS_data_reader_copy_ (void *cls, uint64_t offset, size_t max, void *buf,
363 * (for serialization/deserialization). 363 * (for serialization/deserialization).
364 * 364 *
365 * @param h master context 365 * @param h master context
366 * @param ext component of the path 366 * @param ext component of the path
367 * @param ent entity identifier (or emtpy string for the directory) 367 * @param ent entity identifier (or emtpy string for the directory)
368 * @return NULL on error 368 * @return NULL on error
369 */ 369 */
@@ -394,7 +394,7 @@ get_serialization_file_name (struct GNUNET_FS_Handle *h, const char *ext,
394 * parent operation. 394 * parent operation.
395 * 395 *
396 * @param h master context 396 * @param h master context
397 * @param ext component of the path 397 * @param ext component of the path
398 * @param uni name of the parent operation 398 * @param uni name of the parent operation
399 * @param ent entity identifier (or emtpy string for the directory) 399 * @param ent entity identifier (or emtpy string for the directory)
400 * @return NULL on error 400 * @return NULL on error
@@ -424,7 +424,7 @@ get_serialization_file_name_in_dir (struct GNUNET_FS_Handle *h, const char *ext,
424 * Return a read handle for deserialization. 424 * Return a read handle for deserialization.
425 * 425 *
426 * @param h master context 426 * @param h master context
427 * @param ext component of the path 427 * @param ext component of the path
428 * @param ent entity identifier (or emtpy string for the directory) 428 * @param ent entity identifier (or emtpy string for the directory)
429 * @return NULL on error 429 * @return NULL on error
430 */ 430 */
@@ -447,7 +447,7 @@ get_read_handle (struct GNUNET_FS_Handle *h, const char *ext, const char *ent)
447 * Return a write handle for serialization. 447 * Return a write handle for serialization.
448 * 448 *
449 * @param h master context 449 * @param h master context
450 * @param ext component of the path 450 * @param ext component of the path
451 * @param ent entity identifier (or emtpy string for the directory) 451 * @param ent entity identifier (or emtpy string for the directory)
452 * @return NULL on error 452 * @return NULL on error
453 */ 453 */
@@ -474,7 +474,7 @@ get_write_handle (struct GNUNET_FS_Handle *h, const char *ext, const char *ent)
474 * Return a write handle for serialization. 474 * Return a write handle for serialization.
475 * 475 *
476 * @param h master context 476 * @param h master context
477 * @param ext component of the path 477 * @param ext component of the path
478 * @param uni name of parent 478 * @param uni name of parent
479 * @param ent entity identifier (or emtpy string for the directory) 479 * @param ent entity identifier (or emtpy string for the directory)
480 * @return NULL on error 480 * @return NULL on error
@@ -499,8 +499,8 @@ get_write_handle_in_dir (struct GNUNET_FS_Handle *h, const char *ext,
499 * Remove serialization/deserialization file from disk. 499 * Remove serialization/deserialization file from disk.
500 * 500 *
501 * @param h master context 501 * @param h master context
502 * @param ext component of the path 502 * @param ext component of the path
503 * @param ent entity identifier 503 * @param ent entity identifier
504 */ 504 */
505void 505void
506GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext, 506GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext,
@@ -527,9 +527,9 @@ GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext,
527 * Remove serialization/deserialization file from disk. 527 * Remove serialization/deserialization file from disk.
528 * 528 *
529 * @param h master context 529 * @param h master context
530 * @param ext component of the path 530 * @param ext component of the path
531 * @param uni parent name 531 * @param uni parent name
532 * @param ent entity identifier 532 * @param ent entity identifier
533 */ 533 */
534static void 534static void
535remove_sync_file_in_dir (struct GNUNET_FS_Handle *h, const char *ext, 535remove_sync_file_in_dir (struct GNUNET_FS_Handle *h, const char *ext,
@@ -556,8 +556,8 @@ remove_sync_file_in_dir (struct GNUNET_FS_Handle *h, const char *ext,
556 * Remove serialization/deserialization directory from disk. 556 * Remove serialization/deserialization directory from disk.
557 * 557 *
558 * @param h master context 558 * @param h master context
559 * @param ext component of the path 559 * @param ext component of the path
560 * @param uni unique name of parent 560 * @param uni unique name of parent
561 */ 561 */
562void 562void
563GNUNET_FS_remove_sync_dir_ (struct GNUNET_FS_Handle *h, const char *ext, 563GNUNET_FS_remove_sync_dir_ (struct GNUNET_FS_Handle *h, const char *ext,
@@ -891,7 +891,7 @@ deserialize_file_information (struct GNUNET_FS_Handle *h, const char *filename)
891 * Given a serialization name (full absolute path), return the 891 * Given a serialization name (full absolute path), return the
892 * basename of the file (without the path), which must only 892 * basename of the file (without the path), which must only
893 * consist of the 6 random characters. 893 * consist of the 6 random characters.
894 * 894 *
895 * @param fullname name to extract the basename from 895 * @param fullname name to extract the basename from
896 * @return copy of the basename, NULL on error 896 * @return copy of the basename, NULL on error
897 */ 897 */
@@ -926,7 +926,7 @@ get_serialization_short_name (const char *fullname)
926 * is enabled and returns NULL if not. 926 * is enabled and returns NULL if not.
927 * 927 *
928 * @param h master context 928 * @param h master context
929 * @param ext component of the path 929 * @param ext component of the path
930 * @return NULL on errror 930 * @return NULL on errror
931 */ 931 */
932static char * 932static char *
@@ -961,7 +961,7 @@ make_serialization_file_name (struct GNUNET_FS_Handle *h, const char *ext)
961 * is enabled and returns NULL if not. 961 * is enabled and returns NULL if not.
962 * 962 *
963 * @param h master context 963 * @param h master context
964 * @param ext component of the path 964 * @param ext component of the path
965 * @param uni name of parent 965 * @param uni name of parent
966 * @return NULL on errror 966 * @return NULL on errror
967 */ 967 */
@@ -1396,7 +1396,7 @@ cleanup:
1396 * on disk. Note that all internal FS-operations that change 1396 * on disk. Note that all internal FS-operations that change
1397 * publishing structs should already call "sync" internally, 1397 * publishing structs should already call "sync" internally,
1398 * so this function is likely not useful for clients. 1398 * so this function is likely not useful for clients.
1399 * 1399 *
1400 * @param pc the struct to sync 1400 * @param pc the struct to sync
1401 */ 1401 */
1402void 1402void
@@ -1463,7 +1463,7 @@ cleanup:
1463 * on disk. Note that all internal FS-operations that change 1463 * on disk. Note that all internal FS-operations that change
1464 * publishing structs should already call "sync" internally, 1464 * publishing structs should already call "sync" internally,
1465 * so this function is likely not useful for clients. 1465 * so this function is likely not useful for clients.
1466 * 1466 *
1467 * @param uc the struct to sync 1467 * @param uc the struct to sync
1468 */ 1468 */
1469void 1469void
@@ -1516,7 +1516,7 @@ cleanup:
1516 1516
1517/** 1517/**
1518 * Serialize a download request. 1518 * Serialize a download request.
1519 * 1519 *
1520 * @param wh the 'struct GNUNET_BIO_WriteHandle*' 1520 * @param wh the 'struct GNUNET_BIO_WriteHandle*'
1521 * @param dr the 'struct DownloadRequest' 1521 * @param dr the 'struct DownloadRequest'
1522 * @return GNUNET_YES on success, GNUNET_NO on error 1522 * @return GNUNET_YES on success, GNUNET_NO on error
@@ -1545,7 +1545,7 @@ write_download_request (struct GNUNET_BIO_WriteHandle *wh,
1545 1545
1546/** 1546/**
1547 * Read a download request tree. 1547 * Read a download request tree.
1548 * 1548 *
1549 * @param rh stream to read from 1549 * @param rh stream to read from
1550 * @return value the 'struct DownloadRequest', NULL on error 1550 * @return value the 'struct DownloadRequest', NULL on error
1551 */ 1551 */
@@ -1646,7 +1646,7 @@ get_download_sync_filename (struct GNUNET_FS_DownloadContext *dc,
1646 * on disk. Note that all internal FS-operations that change 1646 * on disk. Note that all internal FS-operations that change
1647 * publishing structs should already call "sync" internally, 1647 * publishing structs should already call "sync" internally,
1648 * so this function is likely not useful for clients. 1648 * so this function is likely not useful for clients.
1649 * 1649 *
1650 * @param dc the struct to sync 1650 * @param dc the struct to sync
1651 */ 1651 */
1652void 1652void
@@ -1748,7 +1748,7 @@ cleanup:
1748 * on disk. Note that all internal FS-operations that change 1748 * on disk. Note that all internal FS-operations that change
1749 * publishing structs should already call "sync" internally, 1749 * publishing structs should already call "sync" internally,
1750 * so this function is likely not useful for clients. 1750 * so this function is likely not useful for clients.
1751 * 1751 *
1752 * @param sr the struct to sync 1752 * @param sr the struct to sync
1753 */ 1753 */
1754void 1754void
@@ -1825,7 +1825,7 @@ cleanup:
1825 * on disk. Note that all internal FS-operations that change 1825 * on disk. Note that all internal FS-operations that change
1826 * publishing structs should already call "sync" internally, 1826 * publishing structs should already call "sync" internally,
1827 * so this function is likely not useful for clients. 1827 * so this function is likely not useful for clients.
1828 * 1828 *
1829 * @param sc the struct to sync 1829 * @param sc the struct to sync
1830 */ 1830 */
1831void 1831void
@@ -2022,7 +2022,7 @@ deserialize_download (struct GNUNET_FS_Handle *h,
2022 2022
2023 2023
2024/** 2024/**
2025 * Deserialize a search. 2025 * Deserialize a search.
2026 * 2026 *
2027 * @param h overall context 2027 * @param h overall context
2028 * @param rh file to deserialize from 2028 * @param rh file to deserialize from
@@ -2165,7 +2165,7 @@ cleanup:
2165 * resume the download (put it in the queue). Does this 2165 * resume the download (put it in the queue). Does this
2166 * recursively for the top-level download and all child 2166 * recursively for the top-level download and all child
2167 * downloads. 2167 * downloads.
2168 * 2168 *
2169 * @param dc download to resume 2169 * @param dc download to resume
2170 */ 2170 */
2171static void 2171static void
@@ -2511,7 +2511,7 @@ signal_search_resume (struct GNUNET_FS_SearchContext *sc)
2511 2511
2512 2512
2513/** 2513/**
2514 * Deserialize a search. 2514 * Deserialize a search.
2515 * 2515 *
2516 * @param h overall context 2516 * @param h overall context
2517 * @param rh file to deserialize from 2517 * @param rh file to deserialize from
@@ -2700,7 +2700,7 @@ deserialization_master (const char *master_path, GNUNET_FileNameCallback proc,
2700 * Setup a connection to the file-sharing service. 2700 * Setup a connection to the file-sharing service.
2701 * 2701 *
2702 * @param cfg configuration to use 2702 * @param cfg configuration to use
2703 * @param client_name unique identifier for this client 2703 * @param client_name unique identifier for this client
2704 * @param upcb function to call to notify about FS actions 2704 * @param upcb function to call to notify about FS actions
2705 * @param upcb_cls closure for upcb 2705 * @param upcb_cls closure for upcb
2706 * @param flags specific attributes for fs-operations 2706 * @param flags specific attributes for fs-operations
diff --git a/src/fs/fs.h b/src/fs/fs.h
index 11cfc755e..1629af852 100644
--- a/src/fs/fs.h
+++ b/src/fs/fs.h
@@ -465,7 +465,7 @@ struct GNUNET_FS_FileInformation
465 char *emsg; 465 char *emsg;
466 466
467 /** 467 /**
468 * Name of the file or directory (must be an absolute path). 468 * Name of the file or directory (must be an absolute path).
469 */ 469 */
470 char *filename; 470 char *filename;
471 471
@@ -779,7 +779,7 @@ GNUNET_FS_dequeue_ (struct GNUNET_FS_QueueEntry *qh);
779 * @param offset offset to read from; it is possible 779 * @param offset offset to read from; it is possible
780 * that the caller might need to go backwards 780 * that the caller might need to go backwards
781 * a bit at times 781 * a bit at times
782 * @param max maximum number of bytes that should be 782 * @param max maximum number of bytes that should be
783 * copied to buf; readers are not allowed 783 * copied to buf; readers are not allowed
784 * to provide less data unless there is an error; 784 * to provide less data unless there is an error;
785 * a value of "0" will be used at the end to allow 785 * a value of "0" will be used at the end to allow
@@ -811,7 +811,7 @@ GNUNET_FS_make_file_reader_context_ (const char *filename);
811 * @param offset offset to read from; it is possible 811 * @param offset offset to read from; it is possible
812 * that the caller might need to go backwards 812 * that the caller might need to go backwards
813 * a bit at times 813 * a bit at times
814 * @param max maximum number of bytes that should be 814 * @param max maximum number of bytes that should be
815 * copied to buf; readers are not allowed 815 * copied to buf; readers are not allowed
816 * to provide less data unless there is an error; 816 * to provide less data unless there is an error;
817 * a value of "0" will be used at the end to allow 817 * a value of "0" will be used at the end to allow
@@ -909,7 +909,7 @@ GNUNET_FS_download_start_task_ (void *cls,
909 909
910 910
911/** 911/**
912 * Fill in all of the generic fields for 912 * Fill in all of the generic fields for
913 * an unindex event and call the callback. 913 * an unindex event and call the callback.
914 * 914 *
915 * @param pi structure to fill in 915 * @param pi structure to fill in
@@ -973,8 +973,8 @@ GNUNET_FS_search_start_probe_ (struct GNUNET_FS_SearchResult *sr);
973 * Remove serialization/deserialization file from disk. 973 * Remove serialization/deserialization file from disk.
974 * 974 *
975 * @param h master context 975 * @param h master context
976 * @param ext component of the path 976 * @param ext component of the path
977 * @param ent entity identifier 977 * @param ent entity identifier
978 */ 978 */
979void 979void
980GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext, 980GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext,
@@ -985,8 +985,8 @@ GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext,
985 * Remove serialization/deserialization directory from disk. 985 * Remove serialization/deserialization directory from disk.
986 * 986 *
987 * @param h master context 987 * @param h master context
988 * @param ext component of the path 988 * @param ext component of the path
989 * @param uni unique name of parent 989 * @param uni unique name of parent
990 */ 990 */
991void 991void
992GNUNET_FS_remove_sync_dir_ (struct GNUNET_FS_Handle *h, const char *ext, 992GNUNET_FS_remove_sync_dir_ (struct GNUNET_FS_Handle *h, const char *ext,
@@ -998,7 +998,7 @@ GNUNET_FS_remove_sync_dir_ (struct GNUNET_FS_Handle *h, const char *ext,
998 * on disk. Note that all internal FS-operations that change 998 * on disk. Note that all internal FS-operations that change
999 * file information data should already call "sync" internally, 999 * file information data should already call "sync" internally,
1000 * so this function is likely not useful for clients. 1000 * so this function is likely not useful for clients.
1001 * 1001 *
1002 * @param fi the struct to sync 1002 * @param fi the struct to sync
1003 */ 1003 */
1004void 1004void
@@ -1009,7 +1009,7 @@ GNUNET_FS_file_information_sync_ (struct GNUNET_FS_FileInformation *f);
1009 * on disk. Note that all internal FS-operations that change 1009 * on disk. Note that all internal FS-operations that change
1010 * publishing structs should already call "sync" internally, 1010 * publishing structs should already call "sync" internally,
1011 * so this function is likely not useful for clients. 1011 * so this function is likely not useful for clients.
1012 * 1012 *
1013 * @param pc the struct to sync 1013 * @param pc the struct to sync
1014 */ 1014 */
1015void 1015void
@@ -1020,7 +1020,7 @@ GNUNET_FS_publish_sync_ (struct GNUNET_FS_PublishContext *pc);
1020 * on disk. Note that all internal FS-operations that change 1020 * on disk. Note that all internal FS-operations that change
1021 * publishing structs should already call "sync" internally, 1021 * publishing structs should already call "sync" internally,
1022 * so this function is likely not useful for clients. 1022 * so this function is likely not useful for clients.
1023 * 1023 *
1024 * @param uc the struct to sync 1024 * @param uc the struct to sync
1025 */ 1025 */
1026void 1026void
@@ -1031,7 +1031,7 @@ GNUNET_FS_unindex_sync_ (struct GNUNET_FS_UnindexContext *uc);
1031 * on disk. Note that all internal FS-operations that change 1031 * on disk. Note that all internal FS-operations that change
1032 * publishing structs should already call "sync" internally, 1032 * publishing structs should already call "sync" internally,
1033 * so this function is likely not useful for clients. 1033 * so this function is likely not useful for clients.
1034 * 1034 *
1035 * @param sc the struct to sync 1035 * @param sc the struct to sync
1036 */ 1036 */
1037void 1037void
@@ -1042,7 +1042,7 @@ GNUNET_FS_search_sync_ (struct GNUNET_FS_SearchContext *sc);
1042 * on disk. Note that all internal FS-operations that change 1042 * on disk. Note that all internal FS-operations that change
1043 * publishing structs should already call "sync" internally, 1043 * publishing structs should already call "sync" internally,
1044 * so this function is likely not useful for clients. 1044 * so this function is likely not useful for clients.
1045 * 1045 *
1046 * @param sr the struct to sync 1046 * @param sr the struct to sync
1047 */ 1047 */
1048void 1048void
@@ -1053,7 +1053,7 @@ GNUNET_FS_search_result_sync_ (struct GNUNET_FS_SearchResult *sr);
1053 * on disk. Note that all internal FS-operations that change 1053 * on disk. Note that all internal FS-operations that change
1054 * publishing structs should already call "sync" internally, 1054 * publishing structs should already call "sync" internally,
1055 * so this function is likely not useful for clients. 1055 * so this function is likely not useful for clients.
1056 * 1056 *
1057 * @param dc the struct to sync 1057 * @param dc the struct to sync
1058 */ 1058 */
1059void 1059void
@@ -1147,7 +1147,7 @@ GNUNET_FS_make_top (struct GNUNET_FS_Handle *h, SuspendSignalFunction ssf,
1147 1147
1148/** 1148/**
1149 * Destroy a top-level activity entry. 1149 * Destroy a top-level activity entry.
1150 * 1150 *
1151 * @param h global fs handle 1151 * @param h global fs handle
1152 * @param top top level activity entry 1152 * @param top top level activity entry
1153 */ 1153 */
@@ -1660,7 +1660,7 @@ enum BlockRequestState
1660 BRS_RECONSTRUCT_UP = 3, 1660 BRS_RECONSTRUCT_UP = 3,
1661 1661
1662 /** 1662 /**
1663 * We've determined the real, desired CHK for this block 1663 * We've determined the real, desired CHK for this block
1664 * (full tree reconstruction failed), request is now pending. 1664 * (full tree reconstruction failed), request is now pending.
1665 * If the CHK that bubbled up through reconstruction did match 1665 * If the CHK that bubbled up through reconstruction did match
1666 * the top-level request, the state machine for the subtree 1666 * the top-level request, the state machine for the subtree
@@ -1672,7 +1672,7 @@ enum BlockRequestState
1672 * We've successfully downloaded this block, but the children 1672 * We've successfully downloaded this block, but the children
1673 * still need to be either downloaded or verified (download 1673 * still need to be either downloaded or verified (download
1674 * request propagates down). If the download fails, the 1674 * request propagates down). If the download fails, the
1675 * state machine for this block may move to 1675 * state machine for this block may move to
1676 * BRS_DOWNLOAD_ERROR instead. 1676 * BRS_DOWNLOAD_ERROR instead.
1677 */ 1677 */
1678 BRS_DOWNLOAD_DOWN = 5, 1678 BRS_DOWNLOAD_DOWN = 5,
@@ -2127,7 +2127,7 @@ struct IndexStartMessage
2127struct IndexInfoMessage 2127struct IndexInfoMessage
2128{ 2128{
2129 /** 2129 /**
2130 * Message type will be 2130 * Message type will be
2131 * GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_ENTRY. 2131 * GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_ENTRY.
2132 */ 2132 */
2133 struct GNUNET_MessageHeader header; 2133 struct GNUNET_MessageHeader header;
@@ -2160,7 +2160,7 @@ struct UnindexMessage
2160{ 2160{
2161 2161
2162 /** 2162 /**
2163 * Message type will be 2163 * Message type will be
2164 * GNUNET_MESSAGE_TYPE_FS_UNINDEX. 2164 * GNUNET_MESSAGE_TYPE_FS_UNINDEX.
2165 */ 2165 */
2166 struct GNUNET_MessageHeader header; 2166 struct GNUNET_MessageHeader header;
@@ -2186,13 +2186,13 @@ struct SearchMessage
2186{ 2186{
2187 2187
2188 /** 2188 /**
2189 * Message type will be 2189 * Message type will be
2190 * GNUNET_MESSAGE_TYPE_FS_START_SEARCH. 2190 * GNUNET_MESSAGE_TYPE_FS_START_SEARCH.
2191 */ 2191 */
2192 struct GNUNET_MessageHeader header; 2192 struct GNUNET_MessageHeader header;
2193 2193
2194 /** 2194 /**
2195 * Bitmask with options. Zero for no options, one for loopback-only. 2195 * Bitmask with options. Zero for no options, one for loopback-only.
2196 * Other bits are currently not defined. 2196 * Other bits are currently not defined.
2197 */ 2197 */
2198 int32_t options GNUNET_PACKED; 2198 int32_t options GNUNET_PACKED;
@@ -2216,7 +2216,7 @@ struct SearchMessage
2216 * or similar blunt actions in order to avoid exposing ourselves). 2216 * or similar blunt actions in order to avoid exposing ourselves).
2217 * <p> 2217 * <p>
2218 * If the request is for an SBLOCK, this is the identity of the 2218 * If the request is for an SBLOCK, this is the identity of the
2219 * pseudonym to which the SBLOCK belongs. 2219 * pseudonym to which the SBLOCK belongs.
2220 * <p> 2220 * <p>
2221 * If the request is for a KBLOCK, "target" must be all zeros. 2221 * If the request is for a KBLOCK, "target" must be all zeros.
2222 */ 2222 */
@@ -2346,7 +2346,7 @@ struct PutMessage
2346 uint32_t type GNUNET_PACKED; 2346 uint32_t type GNUNET_PACKED;
2347 2347
2348 /** 2348 /**
2349 * When does this result expire? 2349 * When does this result expire?
2350 */ 2350 */
2351 struct GNUNET_TIME_AbsoluteNBO expiration; 2351 struct GNUNET_TIME_AbsoluteNBO expiration;
2352 2352
@@ -2362,7 +2362,7 @@ struct PutMessage
2362struct MigrationStopMessage 2362struct MigrationStopMessage
2363{ 2363{
2364 /** 2364 /**
2365 * Message type will be 2365 * Message type will be
2366 * GNUNET_MESSAGE_TYPE_FS_MIGRATION_STOP. 2366 * GNUNET_MESSAGE_TYPE_FS_MIGRATION_STOP.
2367 */ 2367 */
2368 struct GNUNET_MessageHeader header; 2368 struct GNUNET_MessageHeader header;
diff --git a/src/fs/fs_directory.c b/src/fs/fs_directory.c
index 61ed1586f..f43fe14a7 100644
--- a/src/fs/fs_directory.c
+++ b/src/fs/fs_directory.c
@@ -72,7 +72,7 @@ GNUNET_FS_meta_data_test_for_directory (const struct GNUNET_CONTAINER_MetaData
72/** 72/**
73 * Set the MIMETYPE information for the given 73 * Set the MIMETYPE information for the given
74 * metadata to "application/gnunet-directory". 74 * metadata to "application/gnunet-directory".
75 * 75 *
76 * @param md metadata to add mimetype to 76 * @param md metadata to add mimetype to
77 */ 77 */
78void 78void
@@ -124,7 +124,7 @@ struct GetFullDataClosure
124 * used in the main libextractor library and yielding 124 * used in the main libextractor library and yielding
125 * meta data). 125 * meta data).
126 * @param type libextractor-type describing the meta data 126 * @param type libextractor-type describing the meta data
127 * @param format basic format information about data 127 * @param format basic format information about data
128 * @param data_mime_type mime-type of data (not of the original file); 128 * @param data_mime_type mime-type of data (not of the original file);
129 * can be NULL (if mime-type is not known) 129 * can be NULL (if mime-type is not known)
130 * @param data actual meta-data found 130 * @param data actual meta-data found
@@ -341,7 +341,7 @@ struct GNUNET_FS_DirectoryBuilder
341 341
342/** 342/**
343 * Create a directory builder. 343 * Create a directory builder.
344 * 344 *
345 * @param mdir metadata for the directory 345 * @param mdir metadata for the directory
346 */ 346 */
347struct GNUNET_FS_DirectoryBuilder * 347struct GNUNET_FS_DirectoryBuilder *
@@ -362,7 +362,7 @@ GNUNET_FS_directory_builder_create (const struct GNUNET_CONTAINER_MetaData
362 362
363/** 363/**
364 * Add an entry to a directory. 364 * Add an entry to a directory.
365 * 365 *
366 * @param bld directory to extend 366 * @param bld directory to extend
367 * @param uri uri of the entry (must not be a KSK) 367 * @param uri uri of the entry (must not be a KSK)
368 * @param md metadata of the entry 368 * @param md metadata of the entry
diff --git a/src/fs/fs_download.c b/src/fs/fs_download.c
index 89de277da..ba4461986 100644
--- a/src/fs/fs_download.c
+++ b/src/fs/fs_download.c
@@ -59,7 +59,7 @@ is_recursive_download (struct GNUNET_FS_DownloadContext *dc)
59 * Given the offset of a block (with respect to the DBLOCKS) and its 59 * Given the offset of a block (with respect to the DBLOCKS) and its
60 * depth, return the offset where we would store this block in the 60 * depth, return the offset where we would store this block in the
61 * file. 61 * file.
62 * 62 *
63 * @param fsize overall file size 63 * @param fsize overall file size
64 * @param off offset of the block in the file 64 * @param off offset of the block in the file
65 * @param depth depth of the block in the tree, 0 for DBLOCK 65 * @param depth depth of the block in the tree, 0 for DBLOCK
@@ -134,8 +134,8 @@ GNUNET_FS_download_make_status_ (struct GNUNET_FS_ProgressInfo *pi,
134 134
135/** 135/**
136 * We're ready to transmit a search request to the 136 * We're ready to transmit a search request to the
137 * file-sharing service. Do it. If there is 137 * file-sharing service. Do it. If there is
138 * more than one request pending, try to send 138 * more than one request pending, try to send
139 * multiple or request another transmission. 139 * multiple or request another transmission.
140 * 140 *
141 * @param cls closure 141 * @param cls closure
@@ -204,7 +204,7 @@ process_result_with_request (void *cls, const GNUNET_HashCode * key,
204 * We've found a matching block without downloading it. 204 * We've found a matching block without downloading it.
205 * Encrypt it and pass it to our "receive" function as 205 * Encrypt it and pass it to our "receive" function as
206 * if we had received it from the network. 206 * if we had received it from the network.
207 * 207 *
208 * @param dc download in question 208 * @param dc download in question
209 * @param chk request this relates to 209 * @param chk request this relates to
210 * @param dr request details 210 * @param dr request details
@@ -543,7 +543,7 @@ try_match_block (struct GNUNET_FS_DownloadContext *dc,
543 * used in the main libextractor library and yielding 543 * used in the main libextractor library and yielding
544 * meta data). 544 * meta data).
545 * @param type libextractor-type describing the meta data 545 * @param type libextractor-type describing the meta data
546 * @param format basic format information about data 546 * @param format basic format information about data
547 * @param data_mime_type mime-type of data (not of the original file); 547 * @param data_mime_type mime-type of data (not of the original file);
548 * can be NULL (if mime-type is not known) 548 * can be NULL (if mime-type is not known)
549 * @param data actual meta-data found 549 * @param data actual meta-data found
@@ -1057,7 +1057,7 @@ process_result_with_request (void *cls, const GNUNET_HashCode * key,
1057 dc->completed += app; 1057 dc->completed += app;
1058 1058
1059 /* do recursive download if option is set and either meta data 1059 /* do recursive download if option is set and either meta data
1060 * says it is a directory or if no meta data is given AND filename 1060 * says it is a directory or if no meta data is given AND filename
1061 * ends in '.gnd' (top-level case) */ 1061 * ends in '.gnd' (top-level case) */
1062 if (is_recursive_download (dc)) 1062 if (is_recursive_download (dc))
1063 GNUNET_FS_directory_list_contents (prc->size, pt, off, 1063 GNUNET_FS_directory_list_contents (prc->size, pt, off,
@@ -1242,8 +1242,8 @@ receive_results (void *cls, const struct GNUNET_MessageHeader *msg)
1242 1242
1243/** 1243/**
1244 * We're ready to transmit a search request to the 1244 * We're ready to transmit a search request to the
1245 * file-sharing service. Do it. If there is 1245 * file-sharing service. Do it. If there is
1246 * more than one request pending, try to send 1246 * more than one request pending, try to send
1247 * multiple or request another transmission. 1247 * multiple or request another transmission.
1248 * 1248 *
1249 * @param cls closure 1249 * @param cls closure
@@ -1495,7 +1495,7 @@ deactivate_fs_download (void *cls)
1495 * @param depth depth of the current entry, 0 are the DBLOCKs, 1495 * @param depth depth of the current entry, 0 are the DBLOCKs,
1496 * top level block is 'dc->treedepth - 1' 1496 * top level block is 'dc->treedepth - 1'
1497 * @param dr_offset offset in the original file this block maps to 1497 * @param dr_offset offset in the original file this block maps to
1498 * (as in, offset of the first byte of the first DBLOCK 1498 * (as in, offset of the first byte of the first DBLOCK
1499 * in the subtree rooted in the returned download request tree) 1499 * in the subtree rooted in the returned download request tree)
1500 * @param file_start_offset desired starting offset for the download 1500 * @param file_start_offset desired starting offset for the download
1501 * in the original file; requesting tree should not contain 1501 * in the original file; requesting tree should not contain
@@ -1616,7 +1616,7 @@ get_next_block (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1616 * 1616 *
1617 * This function checks if the content on disk matches 1617 * This function checks if the content on disk matches
1618 * the expected content based on the URI. 1618 * the expected content based on the URI.
1619 * 1619 *
1620 * @param cls closure 1620 * @param cls closure
1621 * @param chk content hash key for the block 1621 * @param chk content hash key for the block
1622 * @param offset offset of the block 1622 * @param offset offset of the block
@@ -1658,7 +1658,7 @@ reconstruct_cb (void *cls, const struct ContentHashKey *chk, uint64_t offset,
1658 case BRS_CHK_SET: 1658 case BRS_CHK_SET:
1659 if (0 == memcmp (chk, &dr->chk, sizeof (struct ContentHashKey))) 1659 if (0 == memcmp (chk, &dr->chk, sizeof (struct ContentHashKey)))
1660 { 1660 {
1661 /* block matches, hence tree below matches; 1661 /* block matches, hence tree below matches;
1662 * this request is done! */ 1662 * this request is done! */
1663 dr->state = BRS_DOWNLOAD_UP; 1663 dr->state = BRS_DOWNLOAD_UP;
1664 /* calculate how many bytes of payload this block 1664 /* calculate how many bytes of payload this block
@@ -1816,7 +1816,7 @@ GNUNET_FS_download_start_task_ (void *cls,
1816 /* already done entirely, party! */ 1816 /* already done entirely, party! */
1817 if (dc->rfh != NULL) 1817 if (dc->rfh != NULL)
1818 { 1818 {
1819 /* avoid hanging on to file handle longer than 1819 /* avoid hanging on to file handle longer than
1820 * necessary */ 1820 * necessary */
1821 GNUNET_DISK_file_close (dc->rfh); 1821 GNUNET_DISK_file_close (dc->rfh);
1822 dc->rfh = NULL; 1822 dc->rfh = NULL;
@@ -1851,7 +1851,7 @@ GNUNET_FS_download_start_task_ (void *cls,
1851 { 1851 {
1852 if (dc->rfh != NULL) 1852 if (dc->rfh != NULL)
1853 { 1853 {
1854 /* avoid hanging on to file handle longer than 1854 /* avoid hanging on to file handle longer than
1855 * necessary */ 1855 * necessary */
1856 GNUNET_DISK_file_close (dc->rfh); 1856 GNUNET_DISK_file_close (dc->rfh);
1857 dc->rfh = NULL; 1857 dc->rfh = NULL;
diff --git a/src/fs/fs_file_information.c b/src/fs/fs_file_information.c
index a67b22036..fadcfea05 100644
--- a/src/fs/fs_file_information.c
+++ b/src/fs/fs_file_information.c
@@ -227,7 +227,7 @@ GNUNET_FS_file_information_create_from_data (struct GNUNET_FS_Handle *h,
227 * @param h handle to the file sharing subsystem 227 * @param h handle to the file sharing subsystem
228 * @param client_info initial value for the client-info value for this entry 228 * @param client_info initial value for the client-info value for this entry
229 * @param length length of the file 229 * @param length length of the file
230 * @param reader function that can be used to obtain the data for the file 230 * @param reader function that can be used to obtain the data for the file
231 * @param reader_cls closure for "reader" 231 * @param reader_cls closure for "reader"
232 * @param keywords under which keywords should this file be available 232 * @param keywords under which keywords should this file be available
233 * directly; can be NULL 233 * directly; can be NULL
@@ -592,7 +592,7 @@ GNUNET_FS_file_information_create_empty_directory (struct GNUNET_FS_Handle *h,
592 * 592 *
593 * @param dir the directory 593 * @param dir the directory
594 * @param ent the entry to add; the entry must not have been 594 * @param ent the entry to add; the entry must not have been
595 * added to any other directory at this point and 595 * added to any other directory at this point and
596 * must not include "dir" in its structure 596 * must not include "dir" in its structure
597 * @return GNUNET_OK on success, GNUNET_SYSERR on error 597 * @return GNUNET_OK on success, GNUNET_SYSERR on error
598 */ 598 */
diff --git a/src/fs/fs_misc.c b/src/fs/fs_misc.c
index 3a8260d05..6bd4e59f8 100644
--- a/src/fs/fs_misc.c
+++ b/src/fs/fs_misc.c
@@ -30,7 +30,7 @@
30 30
31/** 31/**
32 * Suggest a filename based on given metadata. 32 * Suggest a filename based on given metadata.
33 * 33 *
34 * @param md given meta data 34 * @param md given meta data
35 * @return NULL if meta data is useless for suggesting a filename 35 * @return NULL if meta data is useless for suggesting a filename
36 */ 36 */
diff --git a/src/fs/fs_namespace.c b/src/fs/fs_namespace.c
index 236e8d59b..7475896a8 100644
--- a/src/fs/fs_namespace.c
+++ b/src/fs/fs_namespace.c
@@ -36,7 +36,7 @@
36 * Return the name of the directory in which we store 36 * Return the name of the directory in which we store
37 * our local namespaces (or rather, their public keys). 37 * our local namespaces (or rather, their public keys).
38 * 38 *
39 * @param h global fs handle 39 * @param h global fs handle
40 * @return NULL on error, otherwise the name of the directory 40 * @return NULL on error, otherwise the name of the directory
41 */ 41 */
42static char * 42static char *
@@ -61,7 +61,7 @@ get_namespace_directory (struct GNUNET_FS_Handle *h)
61 * Return the name of the directory in which we store 61 * Return the name of the directory in which we store
62 * the update information graph for the given local namespace. 62 * the update information graph for the given local namespace.
63 * 63 *
64 * @param ns namespace handle 64 * @param ns namespace handle
65 * @return NULL on error, otherwise the name of the directory 65 * @return NULL on error, otherwise the name of the directory
66 */ 66 */
67static char * 67static char *
@@ -87,7 +87,7 @@ get_update_information_directory (struct GNUNET_FS_Namespace *ns)
87 87
88/** 88/**
89 * Write the namespace update node graph to a file. 89 * Write the namespace update node graph to a file.
90 * 90 *
91 * @param ns namespace to dump 91 * @param ns namespace to dump
92 */ 92 */
93static void 93static void
@@ -134,7 +134,7 @@ END:
134 134
135/** 135/**
136 * Read the namespace update node graph from a file. 136 * Read the namespace update node graph from a file.
137 * 137 *
138 * @param ns namespace to read 138 * @param ns namespace to read
139 */ 139 */
140static void 140static void
@@ -280,7 +280,7 @@ struct AdvertisementContext
280 280
281/** 281/**
282 * Disconnect from the datastore. 282 * Disconnect from the datastore.
283 * 283 *
284 * @param cls datastore handle 284 * @param cls datastore handle
285 * @param tc scheduler context 285 * @param tc scheduler context
286 */ 286 */
@@ -375,7 +375,7 @@ advertisement_cont (void *cls, int success, const char *msg)
375 375
376 376
377/** 377/**
378 * Publish an advertismement for a namespace. 378 * Publish an advertismement for a namespace.
379 * 379 *
380 * @param h handle to the file sharing subsystem 380 * @param h handle to the file sharing subsystem
381 * @param ksk_uri keywords to use for advertisment 381 * @param ksk_uri keywords to use for advertisment
@@ -965,7 +965,7 @@ struct FindTreeClosure
965 * head of an tree if it is in the 'tree_array' under its respective 965 * head of an tree if it is in the 'tree_array' under its respective
966 * 'tree_id'. 966 * 'tree_id'.
967 * 967 *
968 * In short, we're trying to find the smallest number of tree to 968 * In short, we're trying to find the smallest number of tree to
969 * cover a directed graph. 969 * cover a directed graph.
970 * 970 *
971 * @param cls closure (of type 'struct FindTreeClosure') 971 * @param cls closure (of type 'struct FindTreeClosure')
@@ -988,7 +988,7 @@ find_trees (void *cls, const GNUNET_HashCode * key, void *value)
988 return GNUNET_YES; /* circular */ 988 return GNUNET_YES; /* circular */
989 GNUNET_assert (nsn->tree_id < fc->tree_array_size); 989 GNUNET_assert (nsn->tree_id < fc->tree_array_size);
990 if (fc->tree_array[nsn->tree_id] != nsn) 990 if (fc->tree_array[nsn->tree_id] != nsn)
991 return GNUNET_YES; /* part of "another" (directed) TREE, 991 return GNUNET_YES; /* part of "another" (directed) TREE,
992 * and not root of it, end trace */ 992 * and not root of it, end trace */
993 if (nsn->tree_id == fc->id) 993 if (nsn->tree_id == fc->id)
994 return GNUNET_YES; /* that's our own root (can this be?) */ 994 return GNUNET_YES; /* that's our own root (can this be?) */
@@ -1015,12 +1015,12 @@ find_trees (void *cls, const GNUNET_HashCode * key, void *value)
1015 * produce an update. Namespace updates form a graph where each node 1015 * produce an update. Namespace updates form a graph where each node
1016 * has a name. Each node can have any number of URI/meta-data entries 1016 * has a name. Each node can have any number of URI/meta-data entries
1017 * which can each be linked to other nodes. Cycles are possible. 1017 * which can each be linked to other nodes. Cycles are possible.
1018 * 1018 *
1019 * Calling this function with "next_id" NULL will cause the library to 1019 * Calling this function with "next_id" NULL will cause the library to
1020 * call "ip" with a root for each strongly connected component of the 1020 * call "ip" with a root for each strongly connected component of the
1021 * graph (a root being a node from which all other nodes in the Tree 1021 * graph (a root being a node from which all other nodes in the Tree
1022 * are reachable). 1022 * are reachable).
1023 * 1023 *
1024 * Calling this function with "next_id" being the name of a node will 1024 * Calling this function with "next_id" being the name of a node will
1025 * cause the library to call "ip" with all children of the node. Note 1025 * cause the library to call "ip" with all children of the node. Note
1026 * that cycles within the final tree are possible (including self-loops). 1026 * that cycles within the final tree are possible (including self-loops).
diff --git a/src/fs/fs_publish.c b/src/fs/fs_publish.c
index 94641e934..b286d41ca 100644
--- a/src/fs/fs_publish.c
+++ b/src/fs/fs_publish.c
@@ -38,7 +38,7 @@
38 38
39 39
40/** 40/**
41 * Fill in all of the generic fields for 41 * Fill in all of the generic fields for
42 * a publish event and call the callback. 42 * a publish event and call the callback.
43 * 43 *
44 * @param pi structure to fill in 44 * @param pi structure to fill in
@@ -216,7 +216,7 @@ signal_publish_error (struct GNUNET_FS_FileInformation *p,
216 216
217/** 217/**
218 * Datastore returns from reservation cancel request. 218 * Datastore returns from reservation cancel request.
219 * 219 *
220 * @param cls the 'struct GNUNET_FS_PublishContext' 220 * @param cls the 'struct GNUNET_FS_PublishContext'
221 * @param success success code (not used) 221 * @param success success code (not used)
222 * @param msg error message (typically NULL, not used) 222 * @param msg error message (typically NULL, not used)
@@ -371,7 +371,7 @@ block_reader (void *cls, uint64_t offset, size_t max, void *buf, char **emsg)
371 { 371 {
372 pt_size = GNUNET_MIN (max, p->data.file.file_size - offset); 372 pt_size = GNUNET_MIN (max, p->data.file.file_size - offset);
373 if (pt_size == 0) 373 if (pt_size == 0)
374 return 0; /* calling reader with pt_size==0 374 return 0; /* calling reader with pt_size==0
375 * might free buf, so don't! */ 375 * might free buf, so don't! */
376 if (pt_size != 376 if (pt_size !=
377 p->data.file.reader (p->data.file.reader_cls, offset, pt_size, buf, 377 p->data.file.reader (p->data.file.reader_cls, offset, pt_size, buf,
@@ -441,7 +441,7 @@ encode_cont (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
441 * or (on error) "GNUNET_FS_tree_encode_finish". 441 * or (on error) "GNUNET_FS_tree_encode_finish".
442 * 442 *
443 * @param cls closure 443 * @param cls closure
444 * @param chk content hash key for the block 444 * @param chk content hash key for the block
445 * @param offset offset of the block in the file 445 * @param offset offset of the block in the file
446 * @param depth depth of the block in the file, 0 for DBLOCK 446 * @param depth depth of the block in the file, 0 for DBLOCK
447 * @param type type of the block (IBLOCK or DBLOCK) 447 * @param type type of the block (IBLOCK or DBLOCK)
@@ -1059,7 +1059,7 @@ GNUNET_FS_publish_signal_suspend_ (void *cls)
1059/** 1059/**
1060 * We have gotten a reply for our space reservation request. 1060 * We have gotten a reply for our space reservation request.
1061 * Either fail (insufficient space) or start publishing for good. 1061 * Either fail (insufficient space) or start publishing for good.
1062 * 1062 *
1063 * @param cls the 'struct GNUNET_FS_PublishContext*' 1063 * @param cls the 'struct GNUNET_FS_PublishContext*'
1064 * @param success positive reservation ID on success 1064 * @param success positive reservation ID on success
1065 * @param msg error message on error, otherwise NULL 1065 * @param msg error message on error, otherwise NULL
@@ -1096,9 +1096,9 @@ finish_reserve (void *cls, int success, const char *msg)
1096 * @param namespace namespace to publish the file in, NULL for no namespace 1096 * @param namespace namespace to publish the file in, NULL for no namespace
1097 * @param nid identifier to use for the publishd content in the namespace 1097 * @param nid identifier to use for the publishd content in the namespace
1098 * (can be NULL, must be NULL if namespace is NULL) 1098 * (can be NULL, must be NULL if namespace is NULL)
1099 * @param nuid update-identifier that will be used for future updates 1099 * @param nuid update-identifier that will be used for future updates
1100 * (can be NULL, must be NULL if namespace or nid is NULL) 1100 * (can be NULL, must be NULL if namespace or nid is NULL)
1101 * @param options options for the publication 1101 * @param options options for the publication
1102 * @return context that can be used to control the publish operation 1102 * @return context that can be used to control the publish operation
1103 */ 1103 */
1104struct GNUNET_FS_PublishContext * 1104struct GNUNET_FS_PublishContext *
@@ -1206,7 +1206,7 @@ fip_signal_stop (void *cls, struct GNUNET_FS_FileInformation *fi,
1206 1206
1207 1207
1208/** 1208/**
1209 * Stop an upload. Will abort incomplete uploads (but 1209 * Stop an upload. Will abort incomplete uploads (but
1210 * not remove blocks that have already been publishd) or 1210 * not remove blocks that have already been publishd) or
1211 * simply clean up the state for completed uploads. 1211 * simply clean up the state for completed uploads.
1212 * Must NOT be called from within the event callback! 1212 * Must NOT be called from within the event callback!
diff --git a/src/fs/fs_search.c b/src/fs/fs_search.c
index 0c47eb173..10cce3f1f 100644
--- a/src/fs/fs_search.c
+++ b/src/fs/fs_search.c
@@ -62,7 +62,7 @@ GNUNET_FS_search_make_status_ (struct GNUNET_FS_ProgressInfo *pi,
62/** 62/**
63 * Check if the given result is identical 63 * Check if the given result is identical
64 * to the given URI. 64 * to the given URI.
65 * 65 *
66 * @param cls points to the URI we check against 66 * @param cls points to the URI we check against
67 * @param key not used 67 * @param key not used
68 * @param value a "struct GNUNET_FS_SearchResult" who's URI we 68 * @param value a "struct GNUNET_FS_SearchResult" who's URI we
@@ -85,7 +85,7 @@ test_result_present (void *cls, const GNUNET_HashCode * key, void *value)
85/** 85/**
86 * We've found a new CHK result. Let the client 86 * We've found a new CHK result. Let the client
87 * know about it. 87 * know about it.
88 * 88 *
89 * @param sc the search context 89 * @param sc the search context
90 * @param sr the specific result 90 * @param sr the specific result
91 */ 91 */
@@ -107,7 +107,7 @@ notify_client_chk_result (struct GNUNET_FS_SearchContext *sc,
107/** 107/**
108 * We've found new information about an existing CHK result. Let the 108 * We've found new information about an existing CHK result. Let the
109 * client know about it. 109 * client know about it.
110 * 110 *
111 * @param sc the search context 111 * @param sc the search context
112 * @param sr the specific result 112 * @param sr the specific result
113 */ 113 */
@@ -151,7 +151,7 @@ struct GetResultContext
151/** 151/**
152 * Check if the given result is identical to the given URI and if so 152 * Check if the given result is identical to the given URI and if so
153 * return it. 153 * return it.
154 * 154 *
155 * @param cls a "struct GetResultContext" 155 * @param cls a "struct GetResultContext"
156 * @param key not used 156 * @param key not used
157 * @param value a "struct GNUNET_FS_SearchResult" who's URI we 157 * @param value a "struct GNUNET_FS_SearchResult" who's URI we
@@ -1379,7 +1379,7 @@ GNUNET_FS_search_start (struct GNUNET_FS_Handle *h,
1379 1379
1380 1380
1381/** 1381/**
1382 * Pause search. 1382 * Pause search.
1383 * 1383 *
1384 * @param sc context for the search that should be paused 1384 * @param sc context for the search that should be paused
1385 */ 1385 */
diff --git a/src/fs/fs_tree.c b/src/fs/fs_tree.c
index 58d0f0127..60e80efbb 100644
--- a/src/fs/fs_tree.c
+++ b/src/fs/fs_tree.c
@@ -100,7 +100,7 @@ struct GNUNET_FS_TreeEncoder
100 * In-memory cache of the current CHK tree. 100 * In-memory cache of the current CHK tree.
101 * This struct will contain the CHK values 101 * This struct will contain the CHK values
102 * from the root to the currently processed 102 * from the root to the currently processed
103 * node in the tree as identified by 103 * node in the tree as identified by
104 * "current_depth" and "publish_offset". 104 * "current_depth" and "publish_offset".
105 * The "chktree" will be initially NULL, 105 * The "chktree" will be initially NULL,
106 * then allocated to a sufficient number of 106 * then allocated to a sufficient number of
@@ -176,8 +176,8 @@ GNUNET_FS_tree_compute_tree_size (unsigned int depth)
176 * 176 *
177 * @param depth depth of the IBlock in the tree, 0 would be a DBLOCK, 177 * @param depth depth of the IBlock in the tree, 0 would be a DBLOCK,
178 * must be > 0 (this function is for IBLOCKs only!) 178 * must be > 0 (this function is for IBLOCKs only!)
179 * @param end_offset current offset in the payload (!) of the overall file, 179 * @param end_offset current offset in the payload (!) of the overall file,
180 * must be > 0 (since this function is called at the 180 * must be > 0 (since this function is called at the
181 * end of a block). 181 * end of a block).
182 * @return size of the corresponding IBlock 182 * @return size of the corresponding IBlock
183 */ 183 */
@@ -264,7 +264,7 @@ GNUNET_FS_tree_calculate_block_size (uint64_t fsize, uint64_t offset,
264 * @param cls closure for reader, proc, progress and cont 264 * @param cls closure for reader, proc, progress and cont
265 * @param reader function to call to read plaintext data 265 * @param reader function to call to read plaintext data
266 * @param proc function to call on each encrypted block 266 * @param proc function to call on each encrypted block
267 * @param progress function to call with progress information 267 * @param progress function to call with progress information
268 * @param cont function to call when done 268 * @param cont function to call when done
269 */ 269 */
270struct GNUNET_FS_TreeEncoder * 270struct GNUNET_FS_TreeEncoder *
@@ -298,7 +298,7 @@ GNUNET_FS_tree_encoder_create (struct GNUNET_FS_Handle *h, uint64_t size,
298 * 298 *
299 * @param depth depth of the IBlock in the tree (aka overall 299 * @param depth depth of the IBlock in the tree (aka overall
300 * number of tree levels minus depth); 0 == DBlock 300 * number of tree levels minus depth); 0 == DBlock
301 * @param end_offset current offset in the overall file, 301 * @param end_offset current offset in the overall file,
302 * at the *beginning* of the block for DBLOCKs (depth==0), 302 * at the *beginning* of the block for DBLOCKs (depth==0),
303 * otherwise at the *end* of the block (exclusive) 303 * otherwise at the *end* of the block (exclusive)
304 * @return (array of CHKs') offset in the above IBlock 304 * @return (array of CHKs') offset in the above IBlock
@@ -421,7 +421,7 @@ GNUNET_FS_tree_encoder_next (struct GNUNET_FS_TreeEncoder *te)
421/** 421/**
422 * Clean up a tree encoder and return information 422 * Clean up a tree encoder and return information
423 * about the resulting URI or an error message. 423 * about the resulting URI or an error message.
424 * 424 *
425 * @param te the tree encoder to clean up 425 * @param te the tree encoder to clean up
426 * @param uri set to the resulting URI (if encoding finished) 426 * @param uri set to the resulting URI (if encoding finished)
427 * @param emsg set to an error message (if an error occured 427 * @param emsg set to an error message (if an error occured
diff --git a/src/fs/fs_tree.h b/src/fs/fs_tree.h
index b39a47cd3..56c32a390 100644
--- a/src/fs/fs_tree.h
+++ b/src/fs/fs_tree.h
@@ -35,7 +35,7 @@
35#include "fs.h" 35#include "fs.h"
36 36
37/** 37/**
38 * Compute the depth of the CHK tree. 38 * Compute the depth of the CHK tree.
39 * 39 *
40 * @param flen file length for which to compute the depth 40 * @param flen file length for which to compute the depth
41 * @return depth of the tree, always > 0. A depth of 1 means only a DBLOCK. 41 * @return depth of the tree, always > 0. A depth of 1 means only a DBLOCK.
@@ -133,7 +133,7 @@ typedef void (*GNUNET_FS_TreeProgressCallback) (void *cls, uint64_t offset,
133 * @param cls closure for reader, proc, progress and cont 133 * @param cls closure for reader, proc, progress and cont
134 * @param reader function to call to read plaintext data 134 * @param reader function to call to read plaintext data
135 * @param proc function to call on each encrypted block 135 * @param proc function to call on each encrypted block
136 * @param progress function to call with progress information 136 * @param progress function to call with progress information
137 * @param cont function to call when done 137 * @param cont function to call when done
138 * @return tree encoder context 138 * @return tree encoder context
139 */ 139 */
@@ -146,8 +146,8 @@ GNUNET_FS_tree_encoder_create (struct GNUNET_FS_Handle *h, uint64_t size,
146 146
147 147
148/** 148/**
149 * Encrypt the next block of the file (and 149 * Encrypt the next block of the file (and
150 * call proc and progress accordingly; or 150 * call proc and progress accordingly; or
151 * of course "cont" if we have already completed 151 * of course "cont" if we have already completed
152 * encoding of the entire file). 152 * encoding of the entire file).
153 * 153 *
@@ -160,7 +160,7 @@ GNUNET_FS_tree_encoder_next (struct GNUNET_FS_TreeEncoder *te);
160/** 160/**
161 * Clean up a tree encoder and return information 161 * Clean up a tree encoder and return information
162 * about the resulting URI or an error message. 162 * about the resulting URI or an error message.
163 * 163 *
164 * @param te the tree encoder to clean up 164 * @param te the tree encoder to clean up
165 * @param uri set to the resulting URI (if encoding finished) 165 * @param uri set to the resulting URI (if encoding finished)
166 * @param emsg set to an error message (if an error occured 166 * @param emsg set to an error message (if an error occured
@@ -179,7 +179,7 @@ GNUNET_FS_tree_encoder_finish (struct GNUNET_FS_TreeEncoder *te,
179/** 179/**
180 * Get data that would be needed to resume 180 * Get data that would be needed to resume
181 * the encoding later. 181 * the encoding later.
182 * 182 *
183 * @param te encoding to resume 183 * @param te encoding to resume
184 * @param data set to the resume data 184 * @param data set to the resume data
185 * @param size set to the size of the resume data 185 * @param size set to the size of the resume data
@@ -192,7 +192,7 @@ GNUNET_FS_tree_encoder_resume_get_data (const struct GNUNET_FS_TreeEncoder *te,
192/** 192/**
193 * Reset tree encoder to point previously 193 * Reset tree encoder to point previously
194 * obtained for resuming. 194 * obtained for resuming.
195 * 195 *
196 * @param te encoding to resume 196 * @param te encoding to resume
197 * @param data the resume data 197 * @param data the resume data
198 * @param size the size of the resume data 198 * @param size the size of the resume data
diff --git a/src/fs/fs_unindex.c b/src/fs/fs_unindex.c
index a992c5ff6..a37a39a78 100644
--- a/src/fs/fs_unindex.c
+++ b/src/fs/fs_unindex.c
@@ -68,7 +68,7 @@ unindex_reader (void *cls, uint64_t offset, size_t max, void *buf, char **emsg)
68 68
69 69
70/** 70/**
71 * Fill in all of the generic fields for 71 * Fill in all of the generic fields for
72 * an unindex event and call the callback. 72 * an unindex event and call the callback.
73 * 73 *
74 * @param pi structure to fill in 74 * @param pi structure to fill in
@@ -443,7 +443,7 @@ GNUNET_FS_unindex_signal_suspend_ (void *cls)
443 * @param h handle to the file sharing subsystem 443 * @param h handle to the file sharing subsystem
444 * @param filename file to unindex 444 * @param filename file to unindex
445 * @param cctx initial value for the client context 445 * @param cctx initial value for the client context
446 * @return NULL on error, otherwise handle 446 * @return NULL on error, otherwise handle
447 */ 447 */
448struct GNUNET_FS_UnindexContext * 448struct GNUNET_FS_UnindexContext *
449GNUNET_FS_unindex_start (struct GNUNET_FS_Handle *h, const char *filename, 449GNUNET_FS_unindex_start (struct GNUNET_FS_Handle *h, const char *filename,
diff --git a/src/fs/fs_uri.c b/src/fs/fs_uri.c
index 206a8adca..b654b2a81 100644
--- a/src/fs/fs_uri.c
+++ b/src/fs/fs_uri.c
@@ -125,7 +125,7 @@ GNUNET_FS_uri_to_key (const struct GNUNET_FS_Uri *uri, GNUNET_HashCode * key)
125 * Convert keyword URI to a human readable format 125 * Convert keyword URI to a human readable format
126 * (i.e. the search query that was used in the first place) 126 * (i.e. the search query that was used in the first place)
127 * 127 *
128 * @param uri ksk uri to convert to a string 128 * @param uri ksk uri to convert to a string
129 * @return string with the keywords 129 * @return string with the keywords
130 */ 130 */
131char * 131char *
@@ -187,7 +187,7 @@ GNUNET_FS_uri_ksk_to_string_fancy (const struct GNUNET_FS_Uri *uri)
187 * spaces), return a copy of the keyword without %-encoding and 187 * spaces), return a copy of the keyword without %-encoding and
188 * without double-quotes (%22). Also, add a space at the beginning 188 * without double-quotes (%22). Also, add a space at the beginning
189 * if there is not a '+'. 189 * if there is not a '+'.
190 * 190 *
191 * @param in string with %-encoding 191 * @param in string with %-encoding
192 * @param emsg where to store the parser error message (if any) 192 * @param emsg where to store the parser error message (if any)
193 * @return decodded string with leading space (or preserved plus) 193 * @return decodded string with leading space (or preserved plus)
@@ -971,7 +971,7 @@ GNUNET_FS_uri_sks_create_from_nsid (GNUNET_HashCode * nsid, const char *id)
971 971
972/** 972/**
973 * Canonicalize a keyword. 973 * Canonicalize a keyword.
974 * 974 *
975 * @param in input string (the keyword) 975 * @param in input string (the keyword)
976 * @return canonicalized keyword 976 * @return canonicalized keyword
977 */ 977 */
@@ -1049,7 +1049,7 @@ canonicalize_keyword (const char *in)
1049 * as decapitalization and removal of certain characters. 1049 * as decapitalization and removal of certain characters.
1050 * (useful for search). 1050 * (useful for search).
1051 * 1051 *
1052 * @param uri the URI to canonicalize 1052 * @param uri the URI to canonicalize
1053 * @return canonicalized version of the URI, NULL on error 1053 * @return canonicalized version of the URI, NULL on error
1054 */ 1054 */
1055struct GNUNET_FS_Uri * 1055struct GNUNET_FS_Uri *
@@ -1568,7 +1568,7 @@ GNUNET_FS_uri_test_loc (const struct GNUNET_FS_Uri *uri)
1568 * used in the main libextractor library and yielding 1568 * used in the main libextractor library and yielding
1569 * meta data). 1569 * meta data).
1570 * @param type libextractor-type describing the meta data 1570 * @param type libextractor-type describing the meta data
1571 * @param format basic format information about data 1571 * @param format basic format information about data
1572 * @param data_mime_type mime-type of data (not of the original file); 1572 * @param data_mime_type mime-type of data (not of the original file);
1573 * can be NULL (if mime-type is not known) 1573 * can be NULL (if mime-type is not known)
1574 * @param data actual meta-data found 1574 * @param data actual meta-data found
diff --git a/src/fs/gnunet-download.c b/src/fs/gnunet-download.c
index 748a8f09c..f38805c2b 100644
--- a/src/fs/gnunet-download.c
+++ b/src/fs/gnunet-download.c
@@ -75,7 +75,7 @@ shutdown_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
75 75
76 76
77/** 77/**
78 * Called by FS client to give information about the progress of an 78 * Called by FS client to give information about the progress of an
79 * operation. 79 * operation.
80 * 80 *
81 * @param cls closure 81 * @param cls closure
diff --git a/src/fs/gnunet-publish.c b/src/fs/gnunet-publish.c
index 7edad6979..9cfdfe6a5 100644
--- a/src/fs/gnunet-publish.c
+++ b/src/fs/gnunet-publish.c
@@ -87,7 +87,7 @@ do_stop_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
87 87
88 88
89/** 89/**
90 * Called by FS client to give information about the progress of an 90 * Called by FS client to give information about the progress of an
91 * operation. 91 * operation.
92 * 92 *
93 * @param cls closure 93 * @param cls closure
diff --git a/src/fs/gnunet-search.c b/src/fs/gnunet-search.c
index eb5345833..3a30f6c2b 100644
--- a/src/fs/gnunet-search.c
+++ b/src/fs/gnunet-search.c
@@ -62,7 +62,7 @@ static int local_only;
62 * used in the main libextractor library and yielding 62 * used in the main libextractor library and yielding
63 * meta data). 63 * meta data).
64 * @param type libextractor-type describing the meta data 64 * @param type libextractor-type describing the meta data
65 * @param format basic format information about data 65 * @param format basic format information about data
66 * @param data_mime_type mime-type of data (not of the original file); 66 * @param data_mime_type mime-type of data (not of the original file);
67 * can be NULL (if mime-type is not known) 67 * can be NULL (if mime-type is not known)
68 * @param data actual meta-data found 68 * @param data actual meta-data found
@@ -117,7 +117,7 @@ clean_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
117 117
118 118
119/** 119/**
120 * Called by FS client to give information about the progress of an 120 * Called by FS client to give information about the progress of an
121 * operation. 121 * operation.
122 * 122 *
123 * @param cls closure 123 * @param cls closure
diff --git a/src/fs/gnunet-service-fs.c b/src/fs/gnunet-service-fs.c
index 0457607d5..2e3c7742f 100644
--- a/src/fs/gnunet-service-fs.c
+++ b/src/fs/gnunet-service-fs.c
@@ -24,7 +24,7 @@
24 * @author Christian Grothoff 24 * @author Christian Grothoff
25 * 25 *
26 * To use: 26 * To use:
27 * - consider re-issue GSF_dht_lookup_ after non-DHT reply received 27 * - consider re-issue GSF_dht_lookup_ after non-DHT reply received
28 * - implement 'SUPPORT_DELAYS' 28 * - implement 'SUPPORT_DELAYS'
29 * 29 *
30 */ 30 */
@@ -59,7 +59,7 @@
59 59
60 60
61/** 61/**
62 * How quickly do we age cover traffic? At the given 62 * How quickly do we age cover traffic? At the given
63 * time interval, remaining cover traffic counters are 63 * time interval, remaining cover traffic counters are
64 * decremented by 1/16th. 64 * decremented by 1/16th.
65 */ 65 */
@@ -106,13 +106,13 @@ struct GNUNET_LOAD_Value *GSF_rt_entry_lifetime;
106double GSF_current_priorities; 106double GSF_current_priorities;
107 107
108/** 108/**
109 * How many query messages have we received 'recently' that 109 * How many query messages have we received 'recently' that
110 * have not yet been claimed as cover traffic? 110 * have not yet been claimed as cover traffic?
111 */ 111 */
112unsigned int GSF_cover_query_count; 112unsigned int GSF_cover_query_count;
113 113
114/** 114/**
115 * How many content messages have we received 'recently' that 115 * How many content messages have we received 'recently' that
116 * have not yet been claimed as cover traffic? 116 * have not yet been claimed as cover traffic?
117 */ 117 */
118unsigned int GSF_cover_content_count; 118unsigned int GSF_cover_content_count;
@@ -192,8 +192,8 @@ GSF_update_datastore_delay_ (struct GNUNET_TIME_Absolute start)
192/** 192/**
193 * Test if the DATABASE (GET) load on this peer is too high 193 * Test if the DATABASE (GET) load on this peer is too high
194 * to even consider processing the query at 194 * to even consider processing the query at
195 * all. 195 * all.
196 * 196 *
197 * @return GNUNET_YES if the load is too high to do anything (load high) 197 * @return GNUNET_YES if the load is too high to do anything (load high)
198 * GNUNET_NO to process normally (load normal) 198 * GNUNET_NO to process normally (load normal)
199 * GNUNET_SYSERR to process for free (load low) 199 * GNUNET_SYSERR to process for free (load low)
@@ -311,7 +311,7 @@ handle_p2p_get (void *cls, const struct GNUNET_PeerIdentity *other,
311/** 311/**
312 * We're done with the local lookup, now consider 312 * We're done with the local lookup, now consider
313 * P2P processing (depending on request options and 313 * P2P processing (depending on request options and
314 * result status). Also signal that we can now 314 * result status). Also signal that we can now
315 * receive more request information from the client. 315 * receive more request information from the client.
316 * 316 *
317 * @param cls the client doing the request ('struct GNUNET_SERVER_Client') 317 * @param cls the client doing the request ('struct GNUNET_SERVER_Client')
diff --git a/src/fs/gnunet-service-fs.h b/src/fs/gnunet-service-fs.h
index bee814318..ef2eebc8d 100644
--- a/src/fs/gnunet-service-fs.h
+++ b/src/fs/gnunet-service-fs.h
@@ -137,13 +137,13 @@ extern struct GNUNET_LOAD_Value *GSF_rt_entry_lifetime;
137extern double GSF_current_priorities; 137extern double GSF_current_priorities;
138 138
139/** 139/**
140 * How many query messages have we received 'recently' that 140 * How many query messages have we received 'recently' that
141 * have not yet been claimed as cover traffic? 141 * have not yet been claimed as cover traffic?
142 */ 142 */
143extern unsigned int GSF_cover_query_count; 143extern unsigned int GSF_cover_query_count;
144 144
145/** 145/**
146 * How many content messages have we received 'recently' that 146 * How many content messages have we received 'recently' that
147 * have not yet been claimed as cover traffic? 147 * have not yet been claimed as cover traffic?
148 */ 148 */
149extern unsigned int GSF_cover_content_count; 149extern unsigned int GSF_cover_content_count;
@@ -161,8 +161,8 @@ extern int GSF_enable_randomized_delays;
161/** 161/**
162 * Test if the DATABASE (GET) load on this peer is too high 162 * Test if the DATABASE (GET) load on this peer is too high
163 * to even consider processing the query at 163 * to even consider processing the query at
164 * all. 164 * all.
165 * 165 *
166 * @return GNUNET_YES if the load is too high to do anything (load high) 166 * @return GNUNET_YES if the load is too high to do anything (load high)
167 * GNUNET_NO to process normally (load normal) 167 * GNUNET_NO to process normally (load normal)
168 * GNUNET_SYSERR to process for free (load low) 168 * GNUNET_SYSERR to process for free (load low)
diff --git a/src/fs/gnunet-service-fs_cp.c b/src/fs/gnunet-service-fs_cp.c
index 96d906c5b..527ca7677 100644
--- a/src/fs/gnunet-service-fs_cp.c
+++ b/src/fs/gnunet-service-fs_cp.c
@@ -364,7 +364,7 @@ update_atsi (struct GSF_ConnectedPeer *cp,
364 364
365/** 365/**
366 * Return the performance data record for the given peer 366 * Return the performance data record for the given peer
367 * 367 *
368 * @param cp peer to query 368 * @param cp peer to query
369 * @return performance data record for the peer 369 * @return performance data record for the peer
370 */ 370 */
@@ -818,7 +818,7 @@ transmit_delayed_now (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
818 818
819/** 819/**
820 * Get the randomized delay a response should be subjected to. 820 * Get the randomized delay a response should be subjected to.
821 * 821 *
822 * @return desired delay 822 * @return desired delay
823 */ 823 */
824static struct GNUNET_TIME_Relative 824static struct GNUNET_TIME_Relative
@@ -844,7 +844,7 @@ get_randomized_delay ()
844 * Handle a reply to a pending request. Also called if a request 844 * Handle a reply to a pending request. Also called if a request
845 * expires (then with data == NULL). The handler may be called 845 * expires (then with data == NULL). The handler may be called
846 * many times (depending on the request type), but will not be 846 * many times (depending on the request type), but will not be
847 * called during or after a call to GSF_pending_request_cancel 847 * called during or after a call to GSF_pending_request_cancel
848 * and will also not be called anymore after a call signalling 848 * and will also not be called anymore after a call signalling
849 * expiration. 849 * expiration.
850 * 850 *
@@ -997,7 +997,7 @@ change_host_trust (struct GSF_ConnectedPeer *cp, int value)
997/** 997/**
998 * We've received a request with the specified priority. Bound it 998 * We've received a request with the specified priority. Bound it
999 * according to how much we trust the given peer. 999 * according to how much we trust the given peer.
1000 * 1000 *
1001 * @param prio_in requested priority 1001 * @param prio_in requested priority
1002 * @param cp the peer making the request 1002 * @param cp the peer making the request
1003 * @return effective priority 1003 * @return effective priority
@@ -1333,7 +1333,7 @@ GSF_handle_p2p_query_ (const struct GNUNET_PeerIdentity *other,
1333 * Function called if there has been a timeout trying to satisfy 1333 * Function called if there has been a timeout trying to satisfy
1334 * a transmission request. 1334 * a transmission request.
1335 * 1335 *
1336 * @param cls the 'struct GSF_PeerTransmitHandle' of the request 1336 * @param cls the 'struct GSF_PeerTransmitHandle' of the request
1337 * @param tc scheduler context 1337 * @param tc scheduler context
1338 */ 1338 */
1339static void 1339static void
@@ -1717,7 +1717,7 @@ create_migration_stop_message (void *cls, size_t size, void *buf)
1717/** 1717/**
1718 * Ask a peer to stop migrating data to us until the given point 1718 * Ask a peer to stop migrating data to us until the given point
1719 * in time. 1719 * in time.
1720 * 1720 *
1721 * @param cp peer to ask 1721 * @param cp peer to ask
1722 * @param block_time until when to block 1722 * @param block_time until when to block
1723 */ 1723 */
diff --git a/src/fs/gnunet-service-fs_cp.h b/src/fs/gnunet-service-fs_cp.h
index 3f25363f1..0f22b0280 100644
--- a/src/fs/gnunet-service-fs_cp.h
+++ b/src/fs/gnunet-service-fs_cp.h
@@ -308,7 +308,7 @@ GSF_handle_p2p_query_ (const struct GNUNET_PeerIdentity *other,
308 308
309/** 309/**
310 * Return the performance data record for the given peer 310 * Return the performance data record for the given peer
311 * 311 *
312 * @param cp peer to query 312 * @param cp peer to query
313 * @return performance data record for the peer 313 * @return performance data record for the peer
314 */ 314 */
@@ -319,7 +319,7 @@ GSF_get_peer_performance_data_ (struct GSF_ConnectedPeer *cp);
319/** 319/**
320 * Ask a peer to stop migrating data to us until the given point 320 * Ask a peer to stop migrating data to us until the given point
321 * in time. 321 * in time.
322 * 322 *
323 * @param cp peer to ask 323 * @param cp peer to ask
324 * @param block_time until when to block 324 * @param block_time until when to block
325 */ 325 */
diff --git a/src/fs/gnunet-service-fs_lc.c b/src/fs/gnunet-service-fs_lc.c
index 6460d4f13..a7e78a6ed 100644
--- a/src/fs/gnunet-service-fs_lc.c
+++ b/src/fs/gnunet-service-fs_lc.c
@@ -209,7 +209,7 @@ client_request_destroy (void *cls,
209 * Handle a reply to a pending request. Also called if a request 209 * Handle a reply to a pending request. Also called if a request
210 * expires (then with data == NULL). The handler may be called 210 * expires (then with data == NULL). The handler may be called
211 * many times (depending on the request type), but will not be 211 * many times (depending on the request type), but will not be
212 * called during or after a call to GSF_pending_request_cancel 212 * called during or after a call to GSF_pending_request_cancel
213 * and will also not be called anymore after a call signalling 213 * and will also not be called anymore after a call signalling
214 * expiration. 214 * expiration.
215 * 215 *
@@ -217,7 +217,7 @@ client_request_destroy (void *cls,
217 * @param eval evaluation of the result 217 * @param eval evaluation of the result
218 * @param pr handle to the original pending request 218 * @param pr handle to the original pending request
219 * @param reply_anonymity_level anonymity level for the reply, UINT32_MAX for "unknown" 219 * @param reply_anonymity_level anonymity level for the reply, UINT32_MAX for "unknown"
220 * @param expiration when does 'data' expire? 220 * @param expiration when does 'data' expire?
221 * @param type type of the block 221 * @param type type of the block
222 * @param data response data, NULL on request expiration 222 * @param data response data, NULL on request expiration
223 * @param data_len number of bytes in data 223 * @param data_len number of bytes in data
diff --git a/src/fs/gnunet-service-fs_pe.c b/src/fs/gnunet-service-fs_pe.c
index d1a8a1163..1ed7085c4 100644
--- a/src/fs/gnunet-service-fs_pe.c
+++ b/src/fs/gnunet-service-fs_pe.c
@@ -31,7 +31,7 @@
31 31
32 32
33/** 33/**
34 * List of GSF_PendingRequests this request plan 34 * List of GSF_PendingRequests this request plan
35 * participates with. 35 * participates with.
36 */ 36 */
37struct PendingRequestList; 37struct PendingRequestList;
@@ -67,7 +67,7 @@ struct GSF_RequestPlanReference
67 67
68 68
69/** 69/**
70 * List of GSF_PendingRequests this request plan 70 * List of GSF_PendingRequests this request plan
71 * participates with. 71 * participates with.
72 */ 72 */
73struct PendingRequestList 73struct PendingRequestList
@@ -228,7 +228,7 @@ plan (struct PeerPlan *pp, struct GSF_RequestPlan *rp)
228 gettext_noop ("# average retransmission delay (ms)"), 228 gettext_noop ("# average retransmission delay (ms)"),
229 total_delay * 1000LL / plan_count, GNUNET_NO); 229 total_delay * 1000LL / plan_count, GNUNET_NO);
230 prd = GSF_pending_request_get_data_ (rp->prl_head->pr); 230 prd = GSF_pending_request_get_data_ (rp->prl_head->pr);
231 // FIXME: calculate 'rp->priority'! 231 // FIXME: calculate 'rp->priority'!
232 if (rp->transmission_counter < 32) 232 if (rp->transmission_counter < 32)
233 delay = 233 delay =
234 GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 234 GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS,
@@ -533,7 +533,7 @@ GSF_plan_add_ (struct GSF_ConnectedPeer *cp, struct GSF_PendingRequest *pr)
533 * Notify the plan about a peer being no longer available; 533 * Notify the plan about a peer being no longer available;
534 * destroy all entries associated with this peer. 534 * destroy all entries associated with this peer.
535 * 535 *
536 * @param cp connected peer 536 * @param cp connected peer
537 */ 537 */
538void 538void
539GSF_plan_notify_peer_disconnect_ (const struct GSF_ConnectedPeer *cp) 539GSF_plan_notify_peer_disconnect_ (const struct GSF_ConnectedPeer *cp)
diff --git a/src/fs/gnunet-service-fs_pe.h b/src/fs/gnunet-service-fs_pe.h
index 23787908e..3ae9904a6 100644
--- a/src/fs/gnunet-service-fs_pe.h
+++ b/src/fs/gnunet-service-fs_pe.h
@@ -43,7 +43,7 @@ GSF_plan_add_ (struct GSF_ConnectedPeer *cp, struct GSF_PendingRequest *pr);
43 * Notify the plan about a peer being no longer available; 43 * Notify the plan about a peer being no longer available;
44 * destroy all entries associated with this peer. 44 * destroy all entries associated with this peer.
45 * 45 *
46 * @param cp connected peer 46 * @param cp connected peer
47 */ 47 */
48void 48void
49GSF_plan_notify_peer_disconnect_ (const struct GSF_ConnectedPeer *cp); 49GSF_plan_notify_peer_disconnect_ (const struct GSF_ConnectedPeer *cp);
diff --git a/src/fs/gnunet-service-fs_pr.c b/src/fs/gnunet-service-fs_pr.c
index e5cb1f03c..a1fc60bd9 100644
--- a/src/fs/gnunet-service-fs_pr.c
+++ b/src/fs/gnunet-service-fs_pr.c
@@ -254,7 +254,7 @@ refresh_bloomfilter (struct GSF_PendingRequest *pr)
254 254
255 255
256/** 256/**
257 * Create a new pending request. 257 * Create a new pending request.
258 * 258 *
259 * @param options request options 259 * @param options request options
260 * @param type type of the block that is being requested 260 * @param type type of the block that is being requested
@@ -384,7 +384,7 @@ GSF_pending_request_create_ (enum GSF_PendingRequestOptions options,
384 384
385/** 385/**
386 * Obtain the public data associated with a pending request 386 * Obtain the public data associated with a pending request
387 * 387 *
388 * @param pr pending request 388 * @param pr pending request
389 * @return associated public data 389 * @return associated public data
390 */ 390 */
@@ -399,7 +399,7 @@ GSF_pending_request_get_data_ (struct GSF_PendingRequest *pr)
399 * Test if two pending requests are compatible (would generate 399 * Test if two pending requests are compatible (would generate
400 * the same query modulo filters and should thus be processed 400 * the same query modulo filters and should thus be processed
401 * jointly). 401 * jointly).
402 * 402 *
403 * @param pra a pending request 403 * @param pra a pending request
404 * @param pra another pending request 404 * @param pra another pending request
405 * @return GNUNET_OK if the requests are compatible 405 * @return GNUNET_OK if the requests are compatible
@@ -957,8 +957,8 @@ put_migration_continuation (void *cls, int success, const char *msg)
957/** 957/**
958 * Test if the DATABASE (PUT) load on this peer is too high 958 * Test if the DATABASE (PUT) load on this peer is too high
959 * to even consider processing the query at 959 * to even consider processing the query at
960 * all. 960 * all.
961 * 961 *
962 * @return GNUNET_YES if the load is too high to do anything (load high) 962 * @return GNUNET_YES if the load is too high to do anything (load high)
963 * GNUNET_NO to process normally (load normal or low) 963 * GNUNET_NO to process normally (load normal or low)
964 */ 964 */
@@ -1089,7 +1089,7 @@ GSF_dht_lookup_ (struct GSF_PendingRequest *pr)
1089 1089
1090/** 1090/**
1091 * Task that issues a warning if the datastore lookup takes too long. 1091 * Task that issues a warning if the datastore lookup takes too long.
1092 * 1092 *
1093 * @param cls the 'struct GSF_PendingRequest' 1093 * @param cls the 'struct GSF_PendingRequest'
1094 * @param tc task context 1094 * @param tc task context
1095 */ 1095 */
@@ -1110,7 +1110,7 @@ warn_delay_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1110 1110
1111/** 1111/**
1112 * Task that issues a warning if the datastore lookup takes too long. 1112 * Task that issues a warning if the datastore lookup takes too long.
1113 * 1113 *
1114 * @param cls the 'struct GSF_PendingRequest' 1114 * @param cls the 'struct GSF_PendingRequest'
1115 * @param tc task context 1115 * @param tc task context
1116 */ 1116 */
diff --git a/src/fs/gnunet-service-fs_pr.h b/src/fs/gnunet-service-fs_pr.h
index b68989be7..03fc047fb 100644
--- a/src/fs/gnunet-service-fs_pr.h
+++ b/src/fs/gnunet-service-fs_pr.h
@@ -153,7 +153,7 @@ struct GSF_PendingRequestData
153 * Handle a reply to a pending request. Also called if a request 153 * Handle a reply to a pending request. Also called if a request
154 * expires (then with data == NULL). The handler may be called 154 * expires (then with data == NULL). The handler may be called
155 * many times (depending on the request type), but will not be 155 * many times (depending on the request type), but will not be
156 * called during or after a call to GSF_pending_request_cancel 156 * called during or after a call to GSF_pending_request_cancel
157 * and will also not be called anymore after a call signalling 157 * and will also not be called anymore after a call signalling
158 * expiration. 158 * expiration.
159 * 159 *
@@ -180,7 +180,7 @@ typedef void (*GSF_PendingRequestReplyHandler) (void *cls,
180 180
181 181
182/** 182/**
183 * Create a new pending request. 183 * Create a new pending request.
184 * 184 *
185 * @param options request options 185 * @param options request options
186 * @param type type of the block that is being requested 186 * @param type type of the block that is being requested
@@ -232,7 +232,7 @@ GSF_pending_request_update_ (struct GSF_PendingRequest *pr,
232 232
233/** 233/**
234 * Obtain the public data associated with a pending request 234 * Obtain the public data associated with a pending request
235 * 235 *
236 * @param pr pending request 236 * @param pr pending request
237 * @return associated public data 237 * @return associated public data
238 */ 238 */
@@ -244,7 +244,7 @@ GSF_pending_request_get_data_ (struct GSF_PendingRequest *pr);
244 * Test if two pending requests are compatible (would generate 244 * Test if two pending requests are compatible (would generate
245 * the same query modulo filters and should thus be processed 245 * the same query modulo filters and should thus be processed
246 * jointly). 246 * jointly).
247 * 247 *
248 * @param pra a pending request 248 * @param pra a pending request
249 * @param pra another pending request 249 * @param pra another pending request
250 * @return GNUNET_OK if the requests are compatible 250 * @return GNUNET_OK if the requests are compatible
diff --git a/src/fs/gnunet-service-fs_push.c b/src/fs/gnunet-service-fs_push.c
index fb05366af..acdba81f0 100644
--- a/src/fs/gnunet-service-fs_push.c
+++ b/src/fs/gnunet-service-fs_push.c
@@ -34,7 +34,7 @@
34#define DEBUG_FS_MIGRATION GNUNET_NO 34#define DEBUG_FS_MIGRATION GNUNET_NO
35 35
36/** 36/**
37 * How long must content remain valid for us to consider it for migration? 37 * How long must content remain valid for us to consider it for migration?
38 * If content will expire too soon, there is clearly no point in pushing 38 * If content will expire too soon, there is clearly no point in pushing
39 * it to other peers. This value gives the threshold for migration. Note 39 * it to other peers. This value gives the threshold for migration. Note
40 * that if this value is increased, the migration testcase may need to be 40 * that if this value is increased, the migration testcase may need to be
@@ -65,7 +65,7 @@ struct MigrationReadyBlock
65 GNUNET_HashCode query; 65 GNUNET_HashCode query;
66 66
67 /** 67 /**
68 * When does this block expire? 68 * When does this block expire?
69 */ 69 */
70 struct GNUNET_TIME_Absolute expiration; 70 struct GNUNET_TIME_Absolute expiration;
71 71
@@ -313,7 +313,7 @@ count_targets (struct MigrationReadyBlock *block)
313 313
314/** 314/**
315 * Check if sending this block to this peer would 315 * Check if sending this block to this peer would
316 * be a good idea. 316 * be a good idea.
317 * 317 *
318 * @param peer target peer 318 * @param peer target peer
319 * @param block the block 319 * @param block the block
@@ -419,7 +419,7 @@ find_content (struct MigrationReadyPeer *mrp)
419/** 419/**
420 * Task that is run periodically to obtain blocks for content 420 * Task that is run periodically to obtain blocks for content
421 * migration 421 * migration
422 * 422 *
423 * @param cls unused 423 * @param cls unused
424 * @param tc scheduler context (also unused) 424 * @param tc scheduler context (also unused)
425 */ 425 */
@@ -539,7 +539,7 @@ process_migration_content (void *cls, const GNUNET_HashCode * key, size_t size,
539/** 539/**
540 * Task that is run periodically to obtain blocks for content 540 * Task that is run periodically to obtain blocks for content
541 * migration 541 * migration
542 * 542 *
543 * @param cls unused 543 * @param cls unused
544 * @param tc scheduler context (also unused) 544 * @param tc scheduler context (also unused)
545 */ 545 */
diff --git a/src/fs/gnunet-service-fs_put.c b/src/fs/gnunet-service-fs_put.c
index 4b4925d22..5771b5665 100644
--- a/src/fs/gnunet-service-fs_put.c
+++ b/src/fs/gnunet-service-fs_put.c
@@ -82,7 +82,7 @@ static struct PutOperator operators[] = {
82 82
83/** 83/**
84 * Task that is run periodically to obtain blocks for DHT PUTs. 84 * Task that is run periodically to obtain blocks for DHT PUTs.
85 * 85 *
86 * @param cls type of blocks to gather 86 * @param cls type of blocks to gather
87 * @param tc scheduler context (unused) 87 * @param tc scheduler context (unused)
88 */ 88 */
@@ -93,7 +93,7 @@ gather_dht_put_blocks (void *cls,
93 93
94/** 94/**
95 * Task that is run periodically to obtain blocks for DHT PUTs. 95 * Task that is run periodically to obtain blocks for DHT PUTs.
96 * 96 *
97 * @param cls type of blocks to gather 97 * @param cls type of blocks to gather
98 * @param tc scheduler context (unused) 98 * @param tc scheduler context (unused)
99 */ 99 */
@@ -169,7 +169,7 @@ process_dht_put_content (void *cls, const GNUNET_HashCode * key, size_t size,
169 169
170/** 170/**
171 * Task that is run periodically to obtain blocks for DHT PUTs. 171 * Task that is run periodically to obtain blocks for DHT PUTs.
172 * 172 *
173 * @param cls type of blocks to gather 173 * @param cls type of blocks to gather
174 * @param tc scheduler context (unused) 174 * @param tc scheduler context (unused)
175 */ 175 */
diff --git a/src/fs/gnunet-unindex.c b/src/fs/gnunet-unindex.c
index d52956a75..25560ca10 100644
--- a/src/fs/gnunet-unindex.c
+++ b/src/fs/gnunet-unindex.c
@@ -61,7 +61,7 @@ shutdown_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
61} 61}
62 62
63/** 63/**
64 * Called by FS client to give information about the progress of an 64 * Called by FS client to give information about the progress of an
65 * operation. 65 * operation.
66 * 66 *
67 * @param cls closure 67 * @param cls closure
diff --git a/src/fs/perf_gnunet_service_fs_p2p_trust.c b/src/fs/perf_gnunet_service_fs_p2p_trust.c
index 3432714b3..6140bb74f 100644
--- a/src/fs/perf_gnunet_service_fs_p2p_trust.c
+++ b/src/fs/perf_gnunet_service_fs_p2p_trust.c
@@ -37,7 +37,7 @@
37 * Download speed of type `seeder 1' was 757 KiB/s 37 * Download speed of type `seeder 1' was 757 KiB/s
38 * Download speed of type `seeder 2' was 613 KiB/s 38 * Download speed of type `seeder 2' was 613 KiB/s
39 * Download speed of type `leach` was 539 KiB/s 39 * Download speed of type `leach` was 539 KiB/s
40 * 40 *
41 * - 10 MB, 3 peers, without delays: 41 * - 10 MB, 3 peers, without delays:
42 * Download speed of type `seeder 1' was 1784 KiB/s 42 * Download speed of type `seeder 1' was 1784 KiB/s
43 * Download speed of type `seeder 2' was 1604 KiB/s 43 * Download speed of type `seeder 2' was 1604 KiB/s
diff --git a/src/fs/test_fs_download_persistence.c b/src/fs/test_fs_download_persistence.c
index c7a0a8b7c..c26a60978 100644
--- a/src/fs/test_fs_download_persistence.c
+++ b/src/fs/test_fs_download_persistence.c
@@ -138,8 +138,8 @@ restart_fs_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
138 138
139 139
140/** 140/**
141 * Consider scheduling the restart-task. 141 * Consider scheduling the restart-task.
142 * Only runs the restart task once per event 142 * Only runs the restart task once per event
143 * category. 143 * category.
144 * 144 *
145 * @param ev type of the event to consider 145 * @param ev type of the event to consider
diff --git a/src/fs/test_fs_publish_persistence.c b/src/fs/test_fs_publish_persistence.c
index 704c2a4c0..eab0aa650 100644
--- a/src/fs/test_fs_publish_persistence.c
+++ b/src/fs/test_fs_publish_persistence.c
@@ -112,8 +112,8 @@ restart_fs_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
112 112
113 113
114/** 114/**
115 * Consider scheduling the restart-task. 115 * Consider scheduling the restart-task.
116 * Only runs the restart task once per event 116 * Only runs the restart task once per event
117 * category. 117 * category.
118 * 118 *
119 * @param ev type of the event to consider 119 * @param ev type of the event to consider
diff --git a/src/fs/test_fs_search_persistence.c b/src/fs/test_fs_search_persistence.c
index 6eb18dafb..335b1bee3 100644
--- a/src/fs/test_fs_search_persistence.c
+++ b/src/fs/test_fs_search_persistence.c
@@ -102,8 +102,8 @@ restart_fs_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
102 102
103 103
104/** 104/**
105 * Consider scheduling the restart-task. 105 * Consider scheduling the restart-task.
106 * Only runs the restart task once per event 106 * Only runs the restart task once per event
107 * category. 107 * category.
108 * 108 *
109 * @param ev type of the event to consider 109 * @param ev type of the event to consider
diff --git a/src/fs/test_fs_unindex_persistence.c b/src/fs/test_fs_unindex_persistence.c
index e81400817..69623ac7c 100644
--- a/src/fs/test_fs_unindex_persistence.c
+++ b/src/fs/test_fs_unindex_persistence.c
@@ -108,8 +108,8 @@ restart_fs_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
108 108
109 109
110/** 110/**
111 * Consider scheduling the restart-task. 111 * Consider scheduling the restart-task.
112 * Only runs the restart task once per event 112 * Only runs the restart task once per event
113 * category. 113 * category.
114 * 114 *
115 * @param ev type of the event to consider 115 * @param ev type of the event to consider