diff options
author | Christian Grothoff <christian@grothoff.org> | 2011-08-29 10:19:43 +0000 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2011-08-29 10:19:43 +0000 |
commit | cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb (patch) | |
tree | b704e00a3af618b2cd174a7f89514eaebd82a1cf /src/fs | |
parent | bb4fc4f4007988874f910d4de5492f9629301641 (diff) | |
download | gnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.tar.gz gnunet-cddbdf5b928c68ab71b40c950b9f01ea68a9fbdb.zip |
run indent twice, it alternates between two 'canonical' forms, also run whitespace remover
Diffstat (limited to 'src/fs')
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 | */ |
505 | void | 505 | void |
506 | GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext, | 506 | GNUNET_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 | */ |
534 | static void | 534 | static void |
535 | remove_sync_file_in_dir (struct GNUNET_FS_Handle *h, const char *ext, | 535 | remove_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 | */ |
562 | void | 562 | void |
563 | GNUNET_FS_remove_sync_dir_ (struct GNUNET_FS_Handle *h, const char *ext, | 563 | GNUNET_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 | */ |
932 | static char * | 932 | static 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 | */ |
1402 | void | 1402 | void |
@@ -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 | */ |
1469 | void | 1469 | void |
@@ -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 | */ |
1652 | void | 1652 | void |
@@ -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 | */ |
1754 | void | 1754 | void |
@@ -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 | */ |
1831 | void | 1831 | void |
@@ -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 | */ |
2171 | static void | 2171 | static 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 | */ |
979 | void | 979 | void |
980 | GNUNET_FS_remove_sync_file_ (struct GNUNET_FS_Handle *h, const char *ext, | 980 | GNUNET_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 | */ |
991 | void | 991 | void |
992 | GNUNET_FS_remove_sync_dir_ (struct GNUNET_FS_Handle *h, const char *ext, | 992 | GNUNET_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 | */ |
1004 | void | 1004 | void |
@@ -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 | */ |
1015 | void | 1015 | void |
@@ -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 | */ |
1026 | void | 1026 | void |
@@ -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 | */ |
1037 | void | 1037 | void |
@@ -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 | */ |
1048 | void | 1048 | void |
@@ -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 | */ |
1059 | void | 1059 | void |
@@ -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 | |||
2127 | struct IndexInfoMessage | 2127 | struct 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 | |||
2362 | struct MigrationStopMessage | 2362 | struct 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 | */ |
78 | void | 78 | void |
@@ -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 | */ |
347 | struct GNUNET_FS_DirectoryBuilder * | 347 | struct 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 | */ |
42 | static char * | 42 | static 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 | */ |
67 | static char * | 67 | static 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 | */ |
93 | static void | 93 | static 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 | */ |
140 | static void | 140 | static 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 | */ |
1104 | struct GNUNET_FS_PublishContext * | 1104 | struct 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 | */ |
270 | struct GNUNET_FS_TreeEncoder * | 270 | struct 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 | */ |
448 | struct GNUNET_FS_UnindexContext * | 448 | struct GNUNET_FS_UnindexContext * |
449 | GNUNET_FS_unindex_start (struct GNUNET_FS_Handle *h, const char *filename, | 449 | GNUNET_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 | */ |
131 | char * | 131 | char * |
@@ -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 | */ |
1055 | struct GNUNET_FS_Uri * | 1055 | struct 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; | |||
106 | double GSF_current_priorities; | 106 | double 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 | */ |
112 | unsigned int GSF_cover_query_count; | 112 | unsigned 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 | */ |
118 | unsigned int GSF_cover_content_count; | 118 | unsigned 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; | |||
137 | extern double GSF_current_priorities; | 137 | extern 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 | */ |
143 | extern unsigned int GSF_cover_query_count; | 143 | extern 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 | */ |
149 | extern unsigned int GSF_cover_content_count; | 149 | extern 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 | */ |
824 | static struct GNUNET_TIME_Relative | 824 | static 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 | */ |
1339 | static void | 1339 | static 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 | */ |
37 | struct PendingRequestList; | 37 | struct 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 | */ |
73 | struct PendingRequestList | 73 | struct 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 | */ |
538 | void | 538 | void |
539 | GSF_plan_notify_peer_disconnect_ (const struct GSF_ConnectedPeer *cp) | 539 | GSF_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 | */ |
48 | void | 48 | void |
49 | GSF_plan_notify_peer_disconnect_ (const struct GSF_ConnectedPeer *cp); | 49 | GSF_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 |