2 This file is part of GNUnet.
3 (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009 Christian Grothoff (and other contributing authors)
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
23 * @brief Parses and produces uri strings.
24 * @author Igor Wronsky, Christian Grothoff
26 * GNUnet URIs are of the general form "gnunet://MODULE/IDENTIFIER".
27 * The specific structure of "IDENTIFIER" depends on the module and
28 * maybe differenciated into additional subcategories if applicable.
29 * This module only deals with fs identifiers (MODULE = "fs").
32 * This module only parses URIs for the AFS module. The FS URIs fall
33 * into four categories, "chk", "sks", "ksk" and "loc". The first three
34 * categories were named in analogy (!) to Freenet, but they do NOT
35 * work in exactly the same way. They are very similar from the user's
36 * point of view (unique file identifier, subspace, keyword), but the
37 * implementation is rather different in pretty much every detail.
38 * The concrete URI formats are:
42 * First, there are URIs that identify a file. They have the format
43 * "gnunet://fs/chk/HEX1.HEX2.SIZE". These URIs can be used to
44 * download the file. The description, filename, mime-type and other
45 * meta-data is NOT part of the file-URI since a URI uniquely
46 * identifies a resource (and the contents of the file would be the
47 * same even if it had a different description).
51 * The second category identifies entries in a namespace. The format
52 * is "gnunet://fs/sks/NAMESPACE/IDENTIFIER" where the namespace
53 * should be given in HEX. Applications may allow using a nickname
54 * for the namespace if the nickname is not ambiguous. The identifier
55 * can be either an ASCII sequence or a HEX-encoding. If the
56 * identifier is in ASCII but the format is ambiguous and could denote
57 * a HEX-string a "/" is appended to indicate ASCII encoding.
61 * The third category identifies ordinary searches. The format is
62 * "gnunet://fs/ksk/KEYWORD[+KEYWORD]*". Using the "+" syntax
63 * it is possible to encode searches with the boolean "AND" operator.
64 * "+" is used since it indicates a commutative 'and' operation and
65 * is unlikely to be used in a keyword by itself.
69 * The last category identifies a datum on a specific machine. The
70 * format is "gnunet://fs/loc/HEX1.HEX2.SIZE.PEER.SIG.EXPTIME". PEER is
71 * the BinName of the public key of the peer storing the datum. The
72 * signature (SIG) certifies that this peer has this content.
73 * HEX1, HEX2 and SIZE correspond to a 'chk' URI.
77 * The encoding for hexadecimal values is defined in the hashing.c
78 * module in the gnunetutil library and discussed there.
82 #include "gnunet_fs_service.h"
83 #include "gnunet_signatures.h"
94 * Get a unique key from a URI. This is for putting URIs
95 * into HashMaps. The key may change between FS implementations.
97 * @param uri uri to convert to a unique key
98 * @param key wherer to store the unique key
101 GNUNET_FS_uri_to_key (const struct GNUNET_FS_Uri *uri, GNUNET_HashCode * key)
106 *key = uri->data.chk.chk.query;
109 GNUNET_CRYPTO_hash (uri->data.sks.identifier,
110 strlen (uri->data.sks.identifier), key);
113 if (uri->data.ksk.keywordCount > 0)
114 GNUNET_CRYPTO_hash (uri->data.ksk.keywords[0],
115 strlen (uri->data.ksk.keywords[0]), key);
118 GNUNET_CRYPTO_hash (&uri->data.loc.fi,
119 sizeof (struct FileIdentifier) +
120 sizeof (struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded),
124 memset (key, 0, sizeof (GNUNET_HashCode));
131 * Convert keyword URI to a human readable format
132 * (i.e. the search query that was used in the first place)
134 * @param uri ksk uri to convert to a string
135 * @return string with the keywords
138 GNUNET_FS_uri_ksk_to_string_fancy (const struct GNUNET_FS_Uri *uri)
145 unsigned int keywordCount;
147 if ((uri == NULL) || (uri->type != ksk))
152 keywords = uri->data.ksk.keywords;
153 keywordCount = uri->data.ksk.keywordCount;
154 n = keywordCount + 1;
155 for (i = 0; i < keywordCount; i++)
157 keyword = keywords[i];
158 n += strlen (keyword) - 1;
159 if (NULL != strstr (&keyword[1], " "))
161 if (keyword[0] == '+')
164 ret = GNUNET_malloc (n);
166 for (i = 0; i < keywordCount; i++)
168 keyword = keywords[i];
169 if (NULL != strstr (&keyword[1], " "))
172 if (keyword[0] == '+')
173 strcat (ret, keyword);
175 strcat (ret, &keyword[1]);
180 if (keyword[0] == '+')
181 strcat (ret, keyword);
183 strcat (ret, &keyword[1]);
192 * Given a keyword with %-encoding (and possibly quotes to protect
193 * spaces), return a copy of the keyword without %-encoding and
194 * without double-quotes (%22). Also, add a space at the beginning
195 * if there is not a '+'.
197 * @param in string with %-encoding
198 * @param emsg where to store the parser error message (if any)
199 * @return decodded string with leading space (or preserved plus)
202 percent_decode_keyword (const char *in, char **emsg)
210 out = GNUNET_strdup (in);
213 while (out[rpos] != '\0')
215 if (out[rpos] == '%')
217 if (1 != sscanf (&out[rpos + 1], "%2X", &hx))
220 *emsg = GNUNET_strdup (_("`%' must be followed by HEX number"));
225 continue; /* skip double quote */
226 out[wpos++] = (char) hx;
230 out[wpos++] = out[rpos++];
236 ret = GNUNET_strdup (out);
240 /* need to prefix with space */
241 ret = GNUNET_malloc (strlen (out) + 2);
249 #define GNUNET_FS_URI_KSK_PREFIX GNUNET_FS_URI_PREFIX GNUNET_FS_URI_KSK_INFIX
254 * @param s an uri string
255 * @param emsg where to store the parser error message (if any)
256 * @return NULL on error, otherwise the KSK URI
258 static struct GNUNET_FS_Uri *
259 uri_ksk_parse (const char *s, char **emsg)
261 struct GNUNET_FS_Uri *ret;
271 GNUNET_assert (s != NULL);
273 pos = strlen (GNUNET_FS_URI_KSK_PREFIX);
274 if ((slen <= pos) || (0 != strncmp (s, GNUNET_FS_URI_KSK_PREFIX, pos)))
275 return NULL; /* not KSK URI */
276 if ((s[slen - 1] == '+') || (s[pos] == '+'))
279 GNUNET_strdup (_("Malformed KSK URI (must not begin or end with `+')"));
284 for (i = pos; i < slen; i++)
286 if ((s[i] == '%') && (&s[i] == strstr (&s[i], "%22")))
288 saw_quote = (saw_quote + 1) % 2;
292 if ((s[i] == '+') && (saw_quote == 0))
297 *emsg = GNUNET_strdup (_("`++' not allowed in KSK URI"));
304 *emsg = GNUNET_strdup (_("Quotes not balanced in KSK URI"));
308 dup = GNUNET_strdup (s);
309 keywords = GNUNET_malloc (max * sizeof (char *));
310 for (i = slen - 1; i >= pos; i--)
312 if ((s[i] == '%') && (&s[i] == strstr (&s[i], "%22")))
314 saw_quote = (saw_quote + 1) % 2;
318 if ((dup[i] == '+') && (saw_quote == 0))
320 keywords[--max] = percent_decode_keyword (&dup[i + 1], emsg);
321 if (NULL == keywords[max])
326 keywords[--max] = percent_decode_keyword (&dup[pos], emsg);
327 if (NULL == keywords[max])
329 GNUNET_assert (max == 0);
331 ret = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
333 ret->data.ksk.keywordCount = iret;
334 ret->data.ksk.keywords = keywords;
337 for (i = 0; i < max; i++)
338 GNUNET_free_non_null (keywords[i]);
339 GNUNET_free (keywords);
345 #define GNUNET_FS_URI_SKS_PREFIX GNUNET_FS_URI_PREFIX GNUNET_FS_URI_SKS_INFIX
350 * @param s an uri string
351 * @param emsg where to store the parser error message (if any)
352 * @return NULL on error, SKS URI otherwise
354 static struct GNUNET_FS_Uri *
355 uri_sks_parse (const char *s, char **emsg)
357 struct GNUNET_FS_Uri *ret;
358 GNUNET_HashCode namespace;
362 char enc[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)];
364 GNUNET_assert (s != NULL);
366 pos = strlen (GNUNET_FS_URI_SKS_PREFIX);
367 if ((slen <= pos) || (0 != strncmp (s, GNUNET_FS_URI_SKS_PREFIX, pos)))
368 return NULL; /* not an SKS URI */
369 if ((slen < pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)) ||
370 (s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] != '/'))
372 *emsg = GNUNET_strdup (_("Malformed SKS URI"));
375 memcpy (enc, &s[pos], sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded));
376 enc[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] = '\0';
377 if (GNUNET_OK != GNUNET_CRYPTO_hash_from_string (enc, &namespace))
379 *emsg = GNUNET_strdup (_("Malformed SKS URI"));
383 GNUNET_strdup (&s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)]);
384 ret = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
386 ret->data.sks.namespace = namespace;
387 ret->data.sks.identifier = identifier;
391 #define GNUNET_FS_URI_CHK_PREFIX GNUNET_FS_URI_PREFIX GNUNET_FS_URI_CHK_INFIX
397 * @param s an uri string
398 * @param emsg where to store the parser error message (if any)
399 * @return NULL on error, CHK URI otherwise
401 static struct GNUNET_FS_Uri *
402 uri_chk_parse (const char *s, char **emsg)
404 struct GNUNET_FS_Uri *ret;
405 struct FileIdentifier fi;
407 unsigned long long flen;
409 char h1[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)];
410 char h2[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)];
414 GNUNET_assert (s != NULL);
416 pos = strlen (GNUNET_FS_URI_CHK_PREFIX);
417 if ((slen < pos + 2 * sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) + 1) ||
418 (0 != strncmp (s, GNUNET_FS_URI_CHK_PREFIX, pos)))
419 return NULL; /* not a CHK URI */
420 if ((s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] != '.') ||
421 (s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) * 2 - 1] != '.'))
423 *emsg = GNUNET_strdup (_("Malformed CHK URI"));
426 memcpy (h1, &s[pos], sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded));
427 h1[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] = '\0';
428 memcpy (h2, &s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)],
429 sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded));
430 h2[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] = '\0';
432 if ((GNUNET_OK != GNUNET_CRYPTO_hash_from_string (h1, &fi.chk.key)) ||
433 (GNUNET_OK != GNUNET_CRYPTO_hash_from_string (h2, &fi.chk.query)) ||
435 SSCANF (&s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) * 2],
438 *emsg = GNUNET_strdup (_("Malformed CHK URI"));
441 fi.file_length = GNUNET_htonll (flen);
442 ret = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
450 * Convert a character back to the binary value
451 * that it represents (given base64-encoding).
453 * @param a character to convert
454 * @return offset in the "tbl" array
457 c2v (unsigned char a)
459 if ((a >= '0') && (a <= '9'))
461 if ((a >= 'A') && (a <= 'Z'))
462 return (a - 'A' + 10);
463 if ((a >= 'a') && (a <= 'z'))
464 return (a - 'a' + 36);
474 * Convert string back to binary data.
476 * @param input '\\0'-terminated string
477 * @param data where to write binary data
478 * @param size how much data should be converted
479 * @return number of characters processed from input,
483 enc2bin (const char *input, void *data, size_t size)
491 if (((size * 8) % 6) != 0)
493 if (strlen (input) < len)
494 return -1; /* error! */
498 for (pos = 0; pos < size; pos++)
502 bits |= (c2v (input[len++]) << hbits);
505 (((unsigned char *) data)[pos]) = (unsigned char) bits;
514 * Structure that defines how the
515 * contents of a location URI must be
516 * assembled in memory to create or
517 * verify the signature of a location
520 struct LocUriAssembly
522 struct GNUNET_CRYPTO_RsaSignaturePurpose purpose;
524 struct GNUNET_TIME_AbsoluteNBO exptime;
526 struct FileIdentifier fi;
528 struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded peer;
533 #define GNUNET_FS_URI_LOC_PREFIX GNUNET_FS_URI_PREFIX GNUNET_FS_URI_LOC_INFIX
537 * Also verifies validity of the location URI.
539 * @param s an uri string
540 * @param emsg where to store the parser error message (if any)
541 * @return NULL on error, valid LOC URI otherwise
543 static struct GNUNET_FS_Uri *
544 uri_loc_parse (const char *s, char **emsg)
546 struct GNUNET_FS_Uri *uri;
547 char h1[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)];
548 char h2[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)];
551 unsigned long long exptime;
552 unsigned long long flen;
553 struct GNUNET_TIME_Absolute et;
554 struct GNUNET_CRYPTO_RsaSignature sig;
555 struct LocUriAssembly ass;
559 GNUNET_assert (s != NULL);
561 pos = strlen (GNUNET_FS_URI_LOC_PREFIX);
562 if ((slen < pos + 2 * sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) + 1) ||
563 (0 != strncmp (s, GNUNET_FS_URI_LOC_PREFIX, pos)))
564 return NULL; /* not an SKS URI */
565 if ((s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] != '.') ||
566 (s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) * 2 - 1] != '.'))
568 *emsg = GNUNET_strdup (_("SKS URI malformed"));
571 memcpy (h1, &s[pos], sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded));
572 h1[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] = '\0';
573 memcpy (h2, &s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)],
574 sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded));
575 h2[sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) - 1] = '\0';
577 if ((GNUNET_OK != GNUNET_CRYPTO_hash_from_string (h1, &ass.fi.chk.key)) ||
578 (GNUNET_OK != GNUNET_CRYPTO_hash_from_string (h2, &ass.fi.chk.query)) ||
580 SSCANF (&s[pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) * 2],
583 *emsg = GNUNET_strdup (_("SKS URI malformed"));
586 ass.fi.file_length = GNUNET_htonll (flen);
588 npos = pos + sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded) * 2;
589 while ((s[npos] != '\0') && (s[npos] != '.'))
593 *emsg = GNUNET_strdup (_("SKS URI malformed"));
598 enc2bin (&s[npos], &ass.peer,
599 sizeof (struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded));
603 GNUNET_strdup (_("SKS URI malformed (could not decode public key)"));
607 if (s[npos++] != '.')
609 *emsg = GNUNET_strdup (_("SKS URI malformed (could not find signature)"));
612 ret = enc2bin (&s[npos], &sig, sizeof (struct GNUNET_CRYPTO_RsaSignature));
615 *emsg = GNUNET_strdup (_("SKS URI malformed (could not decode signature)"));
619 if (s[npos++] != '.')
621 *emsg = GNUNET_strdup (_("SKS URI malformed"));
624 if (1 != SSCANF (&s[npos], "%llu", &exptime))
628 ("SKS URI malformed (could not parse expiration time)"));
631 ass.purpose.size = htonl (sizeof (struct LocUriAssembly));
632 ass.purpose.purpose = htonl (GNUNET_SIGNATURE_PURPOSE_PEER_PLACEMENT);
633 et.abs_value = exptime;
634 ass.exptime = GNUNET_TIME_absolute_hton (et);
636 GNUNET_CRYPTO_rsa_verify (GNUNET_SIGNATURE_PURPOSE_PEER_PLACEMENT,
637 &ass.purpose, &sig, &ass.peer))
640 GNUNET_strdup (_("SKS URI malformed (signature failed validation)"));
643 uri = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
645 uri->data.loc.fi = ass.fi;
646 uri->data.loc.peer = ass.peer;
647 uri->data.loc.expirationTime = et;
648 uri->data.loc.contentSignature = sig;
657 * Convert a UTF-8 String to a URI.
659 * @param uri string to parse
660 * @param emsg where to store the parser error message (if any)
661 * @return NULL on error
663 struct GNUNET_FS_Uri *
664 GNUNET_FS_uri_parse (const char *uri, char **emsg)
666 struct GNUNET_FS_Uri *ret;
672 if ((NULL != (ret = uri_chk_parse (uri, emsg))) ||
673 (NULL != (ret = uri_ksk_parse (uri, emsg))) ||
674 (NULL != (ret = uri_sks_parse (uri, emsg))) ||
675 (NULL != (ret = uri_loc_parse (uri, emsg))))
678 *emsg = GNUNET_strdup (_("Unrecognized URI type"));
688 * @param uri uri to free
691 GNUNET_FS_uri_destroy (struct GNUNET_FS_Uri *uri)
695 GNUNET_assert (uri != NULL);
699 for (i = 0; i < uri->data.ksk.keywordCount; i++)
700 GNUNET_free (uri->data.ksk.keywords[i]);
701 GNUNET_array_grow (uri->data.ksk.keywords, uri->data.ksk.keywordCount, 0);
704 GNUNET_free (uri->data.sks.identifier);
716 * How many keywords are ANDed in this keyword URI?
718 * @param uri ksk uri to get the number of keywords from
719 * @return 0 if this is not a keyword URI
722 GNUNET_FS_uri_ksk_get_keyword_count (const struct GNUNET_FS_Uri *uri)
724 if (uri->type != ksk)
726 return uri->data.ksk.keywordCount;
731 * Iterate over all keywords in this keyword URI.
733 * @param uri ksk uri to get the keywords from
734 * @param iterator function to call on each keyword
735 * @param iterator_cls closure for iterator
736 * @return -1 if this is not a keyword URI, otherwise number of
737 * keywords iterated over until iterator aborted
740 GNUNET_FS_uri_ksk_get_keywords (const struct GNUNET_FS_Uri *uri,
741 GNUNET_FS_KeywordIterator iterator,
747 if (uri->type != ksk)
749 if (iterator == NULL)
750 return uri->data.ksk.keywordCount;
751 for (i = 0; i < uri->data.ksk.keywordCount; i++)
753 keyword = uri->data.ksk.keywords[i];
754 /* first character of keyword indicates
755 * if it is mandatory or not */
756 if (GNUNET_OK != iterator (iterator_cls, &keyword[1], keyword[0] == '+'))
764 * Add the given keyword to the set of keywords represented by the URI.
765 * Does nothing if the keyword is already present.
767 * @param uri ksk uri to modify
768 * @param keyword keyword to add
769 * @param is_mandatory is this keyword mandatory?
772 GNUNET_FS_uri_ksk_add_keyword (struct GNUNET_FS_Uri *uri, const char *keyword,
779 GNUNET_assert (uri->type == ksk);
780 for (i = 0; i < uri->data.ksk.keywordCount; i++)
782 old = uri->data.ksk.keywords[i];
783 if (0 == strcmp (&old[1], keyword))
786 GNUNET_asprintf (&n, is_mandatory ? "+%s" : " %s", keyword);
787 GNUNET_array_append (uri->data.ksk.keywords, uri->data.ksk.keywordCount, n);
792 * Remove the given keyword from the set of keywords represented by the URI.
793 * Does nothing if the keyword is not present.
795 * @param uri ksk uri to modify
796 * @param keyword keyword to add
799 GNUNET_FS_uri_ksk_remove_keyword (struct GNUNET_FS_Uri *uri,
805 GNUNET_assert (uri->type == ksk);
806 for (i = 0; i < uri->data.ksk.keywordCount; i++)
808 old = uri->data.ksk.keywords[i];
809 if (0 == strcmp (&old[1], keyword))
811 uri->data.ksk.keywords[i] =
812 uri->data.ksk.keywords[uri->data.ksk.keywordCount - 1];
813 GNUNET_array_grow (uri->data.ksk.keywords, uri->data.ksk.keywordCount,
814 uri->data.ksk.keywordCount - 1);
823 * Obtain the identity of the peer offering the data
825 * @param uri the location URI to inspect
826 * @param peer where to store the identify of the peer (presumably) offering the content
827 * @return GNUNET_SYSERR if this is not a location URI, otherwise GNUNET_OK
830 GNUNET_FS_uri_loc_get_peer_identity (const struct GNUNET_FS_Uri *uri,
831 struct GNUNET_PeerIdentity *peer)
833 if (uri->type != loc)
834 return GNUNET_SYSERR;
835 GNUNET_CRYPTO_hash (&uri->data.loc.peer,
836 sizeof (struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded),
843 * Obtain the expiration of the LOC URI.
845 * @param uri location URI to get the expiration from
846 * @return expiration time of the URI
848 struct GNUNET_TIME_Absolute
849 GNUNET_FS_uri_loc_get_expiration (const struct GNUNET_FS_Uri *uri)
851 GNUNET_assert (uri->type == loc);
852 return uri->data.loc.expirationTime;
858 * Obtain the URI of the content itself.
860 * @param uri location URI to get the content URI from
861 * @return NULL if argument is not a location URI
863 struct GNUNET_FS_Uri *
864 GNUNET_FS_uri_loc_get_uri (const struct GNUNET_FS_Uri *uri)
866 struct GNUNET_FS_Uri *ret;
868 if (uri->type != loc)
870 ret = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
872 ret->data.chk = uri->data.loc.fi;
878 * Construct a location URI (this peer will be used for the location).
880 * @param baseUri content offered by the sender
881 * @param cfg configuration information (used to find our hostkey)
882 * @param expiration_time how long will the content be offered?
883 * @return the location URI, NULL on error
885 struct GNUNET_FS_Uri *
886 GNUNET_FS_uri_loc_create (const struct GNUNET_FS_Uri *baseUri,
887 const struct GNUNET_CONFIGURATION_Handle *cfg,
888 struct GNUNET_TIME_Absolute expiration_time)
890 struct GNUNET_FS_Uri *uri;
891 struct GNUNET_CRYPTO_RsaPrivateKey *my_private_key;
892 struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded my_public_key;
894 struct LocUriAssembly ass;
896 if (baseUri->type != chk)
899 GNUNET_CONFIGURATION_get_value_filename (cfg, "GNUNETD", "HOSTKEY",
902 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
903 _("Lacking key configuration settings.\n"));
906 my_private_key = GNUNET_CRYPTO_rsa_key_create_from_file (keyfile);
907 if (my_private_key == NULL)
909 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
910 _("Could not access hostkey file `%s'.\n"), keyfile);
911 GNUNET_free (keyfile);
914 GNUNET_free (keyfile);
915 GNUNET_CRYPTO_rsa_key_get_public (my_private_key, &my_public_key);
916 ass.purpose.size = htonl (sizeof (struct LocUriAssembly));
917 ass.purpose.purpose = htonl (GNUNET_SIGNATURE_PURPOSE_PEER_PLACEMENT);
918 ass.exptime = GNUNET_TIME_absolute_hton (expiration_time);
919 ass.fi = baseUri->data.chk;
920 ass.peer = my_public_key;
921 uri = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
923 uri->data.loc.fi = baseUri->data.chk;
924 uri->data.loc.expirationTime = expiration_time;
925 uri->data.loc.peer = my_public_key;
926 GNUNET_assert (GNUNET_OK ==
927 GNUNET_CRYPTO_rsa_sign (my_private_key, &ass.purpose,
928 &uri->data.loc.contentSignature));
929 GNUNET_CRYPTO_rsa_key_free (my_private_key);
935 * Create an SKS URI from a namespace and an identifier.
937 * @param ns namespace
938 * @param id identifier
939 * @param emsg where to store an error message
940 * @return an FS URI for the given namespace and identifier
942 struct GNUNET_FS_Uri *
943 GNUNET_FS_uri_sks_create (struct GNUNET_FS_Namespace *ns, const char *id,
946 struct GNUNET_FS_Uri *ns_uri;
947 struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded pk;
949 ns_uri = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
951 GNUNET_CRYPTO_rsa_key_get_public (ns->key, &pk);
952 GNUNET_CRYPTO_hash (&pk, sizeof (pk), &ns_uri->data.sks.namespace);
953 ns_uri->data.sks.identifier = GNUNET_strdup (id);
959 * Create an SKS URI from a namespace ID and an identifier.
961 * @param nsid namespace ID
962 * @param id identifier
963 * @return an FS URI for the given namespace and identifier
965 struct GNUNET_FS_Uri *
966 GNUNET_FS_uri_sks_create_from_nsid (GNUNET_HashCode * nsid, const char *id)
968 struct GNUNET_FS_Uri *ns_uri;
970 ns_uri = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
972 ns_uri->data.sks.namespace = *nsid;
973 ns_uri->data.sks.identifier = GNUNET_strdup (id);
979 * Merge the sets of keywords from two KSK URIs.
980 * (useful for merging the canonicalized keywords with
981 * the original keywords for sharing).
983 * @param u1 first uri
984 * @param u2 second uri
985 * @return merged URI, NULL on error
987 struct GNUNET_FS_Uri *
988 GNUNET_FS_uri_ksk_merge (const struct GNUNET_FS_Uri *u1,
989 const struct GNUNET_FS_Uri *u2)
991 struct GNUNET_FS_Uri *ret;
999 if ((u1 == NULL) && (u2 == NULL))
1002 return GNUNET_FS_uri_dup (u2);
1004 return GNUNET_FS_uri_dup (u1);
1005 if ((u1->type != ksk) || (u2->type != ksk))
1010 kc = u1->data.ksk.keywordCount;
1011 kl = GNUNET_malloc ((kc + u2->data.ksk.keywordCount) * sizeof (char *));
1012 for (i = 0; i < u1->data.ksk.keywordCount; i++)
1013 kl[i] = GNUNET_strdup (u1->data.ksk.keywords[i]);
1014 for (i = 0; i < u2->data.ksk.keywordCount; i++)
1016 kp = u2->data.ksk.keywords[i];
1018 for (j = 0; j < u1->data.ksk.keywordCount; j++)
1019 if (0 == strcmp (kp + 1, kl[j] + 1))
1027 kl[kc++] = GNUNET_strdup (kp);
1029 ret = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
1031 ret->data.ksk.keywordCount = kc;
1032 ret->data.ksk.keywords = kl;
1040 * @param uri the URI to duplicate
1041 * @return copy of the URI
1043 struct GNUNET_FS_Uri *
1044 GNUNET_FS_uri_dup (const struct GNUNET_FS_Uri *uri)
1046 struct GNUNET_FS_Uri *ret;
1051 ret = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
1052 memcpy (ret, uri, sizeof (struct GNUNET_FS_Uri));
1056 if (ret->data.ksk.keywordCount >=
1057 GNUNET_MAX_MALLOC_CHECKED / sizeof (char *))
1063 if (ret->data.ksk.keywordCount > 0)
1065 ret->data.ksk.keywords =
1066 GNUNET_malloc (ret->data.ksk.keywordCount * sizeof (char *));
1067 for (i = 0; i < ret->data.ksk.keywordCount; i++)
1068 ret->data.ksk.keywords[i] = GNUNET_strdup (uri->data.ksk.keywords[i]);
1071 ret->data.ksk.keywords = NULL; /* just to be sure */
1074 ret->data.sks.identifier = GNUNET_strdup (uri->data.sks.identifier);
1086 * Create an FS URI from a single user-supplied string of keywords.
1087 * The string is broken up at spaces into individual keywords.
1088 * Keywords that start with "+" are mandatory. Double-quotes can
1089 * be used to prevent breaking up strings at spaces (and also
1090 * to specify non-mandatory keywords starting with "+").
1092 * Keywords must contain a balanced number of double quotes and
1093 * double quotes can not be used in the actual keywords (for
1094 * example, the string '""foo bar""' will be turned into two
1095 * "OR"ed keywords 'foo' and 'bar', not into '"foo bar"'.
1097 * @param keywords the keyword string
1098 * @param emsg where to store an error message
1099 * @return an FS URI for the given keywords, NULL
1100 * if keywords is not legal (i.e. empty).
1102 struct GNUNET_FS_Uri *
1103 GNUNET_FS_uri_ksk_create (const char *keywords, char **emsg)
1106 unsigned int num_Words;
1109 struct GNUNET_FS_Uri *uri;
1113 if (keywords == NULL)
1115 *emsg = GNUNET_strdup (_("No keywords specified!\n"));
1119 searchString = GNUNET_strdup (keywords);
1124 while ('\0' != *pos)
1126 if ((saw_quote == 0) && (isspace ((unsigned char) *pos)))
1130 else if (0 == inWord)
1136 saw_quote = (saw_quote + 1) % 2;
1141 GNUNET_free (searchString);
1142 *emsg = GNUNET_strdup (_("No keywords specified!\n"));
1147 GNUNET_free (searchString);
1148 *emsg = GNUNET_strdup (_("Number of double-quotes not balanced!\n"));
1151 keywordarr = GNUNET_malloc (num_Words * sizeof (char *));
1155 while ('\0' != *pos)
1157 if ((saw_quote == 0) && (isspace ((unsigned char) *pos)))
1162 else if (0 == inWord)
1164 keywordarr[num_Words] = pos;
1169 saw_quote = (saw_quote + 1) % 2;
1173 GNUNET_FS_uri_ksk_create_from_args (num_Words,
1174 (const char **) keywordarr);
1175 GNUNET_free (keywordarr);
1176 GNUNET_free (searchString);
1182 * Create an FS URI from a user-supplied command line of keywords.
1183 * Arguments should start with "+" to indicate mandatory
1186 * @param argc number of keywords
1187 * @param argv keywords (double quotes are not required for
1188 * keywords containing spaces; however, double
1189 * quotes are required for keywords starting with
1190 * "+"); there is no mechanism for having double
1191 * quotes in the actual keywords (if the user
1192 * did specifically specify double quotes, the
1193 * caller should convert each double quote
1194 * into two single quotes).
1195 * @return an FS URI for the given keywords, NULL
1196 * if keywords is not legal (i.e. empty).
1198 struct GNUNET_FS_Uri *
1199 GNUNET_FS_uri_ksk_create_from_args (unsigned int argc, const char **argv)
1202 struct GNUNET_FS_Uri *uri;
1203 const char *keyword;
1211 /* allow URI to be given as one and only keyword and
1212 * handle accordingly */
1214 if ((argc == 1) && (strlen (argv[0]) > strlen (GNUNET_FS_URI_PREFIX)) &&
1216 strncmp (argv[0], GNUNET_FS_URI_PREFIX, strlen (GNUNET_FS_URI_PREFIX)))
1217 && (NULL != (uri = GNUNET_FS_uri_parse (argv[0], &emsg))))
1219 GNUNET_free_non_null (emsg);
1220 uri = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
1222 uri->data.ksk.keywordCount = argc;
1223 uri->data.ksk.keywords = GNUNET_malloc (argc * sizeof (char *));
1224 for (i = 0; i < argc; i++)
1227 if (keyword[0] == '+')
1228 val = GNUNET_strdup (keyword);
1230 GNUNET_asprintf (&val, " %s", keyword);
1241 uri->data.ksk.keywords[i] = val;
1248 * Test if two URIs are equal.
1250 * @param u1 one of the URIs
1251 * @param u2 the other URI
1252 * @return GNUNET_YES if the URIs are equal
1255 GNUNET_FS_uri_test_equal (const struct GNUNET_FS_Uri *u1,
1256 const struct GNUNET_FS_Uri *u2)
1262 GNUNET_assert (u1 != NULL);
1263 GNUNET_assert (u2 != NULL);
1264 if (u1->type != u2->type)
1270 memcmp (&u1->data.chk, &u2->data.chk, sizeof (struct FileIdentifier)))
1275 memcmp (&u1->data.sks.namespace, &u2->data.sks.namespace,
1276 sizeof (GNUNET_HashCode))) &&
1277 (0 == strcmp (u1->data.sks.identifier, u2->data.sks.identifier)))
1282 if (u1->data.ksk.keywordCount != u2->data.ksk.keywordCount)
1284 for (i = 0; i < u1->data.ksk.keywordCount; i++)
1287 for (j = 0; j < u2->data.ksk.keywordCount; j++)
1289 if (0 == strcmp (u1->data.ksk.keywords[i], u2->data.ksk.keywords[j]))
1295 if (ret == GNUNET_NO)
1301 (&u1->data.loc, &u2->data.loc,
1302 sizeof (struct FileIdentifier) +
1303 sizeof (struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded) +
1304 sizeof (struct GNUNET_TIME_Absolute) + sizeof (unsigned short) +
1305 sizeof (unsigned short)) != 0)
1315 * Is this a namespace URI?
1317 * @param uri the uri to check
1318 * @return GNUNET_YES if this is an SKS uri
1321 GNUNET_FS_uri_test_sks (const struct GNUNET_FS_Uri *uri)
1323 return uri->type == sks;
1328 * Get the ID of a namespace from the given
1331 * @param uri the uri to get the namespace ID from
1332 * @param nsid where to store the ID of the namespace
1333 * @return GNUNET_OK on success
1336 GNUNET_FS_uri_sks_get_namespace (const struct GNUNET_FS_Uri *uri,
1337 GNUNET_HashCode * nsid)
1339 if (!GNUNET_FS_uri_test_sks (uri))
1342 return GNUNET_SYSERR;
1344 *nsid = uri->data.sks.namespace;
1350 * Get the content identifier of an SKS URI.
1352 * @param uri the sks uri
1353 * @return NULL on error (not a valid SKS URI)
1356 GNUNET_FS_uri_sks_get_content_id (const struct GNUNET_FS_Uri *uri)
1358 if (!GNUNET_FS_uri_test_sks (uri))
1363 return GNUNET_strdup (uri->data.sks.identifier);
1368 * Convert namespace URI to a human readable format
1369 * (using the namespace description, if available).
1371 * @param cfg configuration to use
1372 * @param uri SKS uri to convert
1373 * @return NULL on error (not an SKS URI)
1376 GNUNET_FS_uri_sks_to_string_fancy (struct GNUNET_CONFIGURATION_Handle *cfg,
1377 const struct GNUNET_FS_Uri *uri)
1382 if (uri->type != sks)
1384 name = GNUNET_PSEUDONYM_id_to_name (cfg, &uri->data.sks.namespace);
1386 return GNUNET_FS_uri_to_string (uri);
1387 GNUNET_asprintf (&ret, "%s: %s", name, uri->data.sks.identifier);
1394 * Is this a keyword URI?
1396 * @param uri the uri
1397 * @return GNUNET_YES if this is a KSK uri
1400 GNUNET_FS_uri_test_ksk (const struct GNUNET_FS_Uri *uri)
1405 if (uri->type == ksk)
1407 for (i=0;i < uri->data.ksk.keywordCount; i++)
1408 GNUNET_assert (uri->data.ksk.keywords[i] != NULL);
1411 return uri->type == ksk;
1416 * Is this a file (or directory) URI?
1418 * @param uri the uri to check
1419 * @return GNUNET_YES if this is a CHK uri
1422 GNUNET_FS_uri_test_chk (const struct GNUNET_FS_Uri *uri)
1424 return uri->type == chk;
1429 * What is the size of the file that this URI
1432 * @param uri the CHK URI to inspect
1433 * @return size of the file as specified in the CHK URI
1436 GNUNET_FS_uri_chk_get_file_size (const struct GNUNET_FS_Uri * uri)
1441 return GNUNET_ntohll (uri->data.chk.file_length);
1443 return GNUNET_ntohll (uri->data.loc.fi.file_length);
1447 return 0; /* unreachable */
1452 * Is this a location URI?
1454 * @param uri the uri to check
1455 * @return GNUNET_YES if this is a LOC uri
1458 GNUNET_FS_uri_test_loc (const struct GNUNET_FS_Uri *uri)
1460 return uri->type == loc;
1465 * Add a keyword as non-mandatory (with ' '-prefix) to the
1466 * given keyword list at offset 'index'. The array is
1467 * guaranteed to be long enough.
1469 * @param s keyword to add
1470 * @param array array to add the keyword to
1471 * @param index offset where to add the keyword
1474 insert_non_mandatory_keyword (const char *s, char **array, int index)
1477 GNUNET_asprintf (&nkword, " %s", /* space to mark as 'non mandatory' */ s);
1478 array[index] = nkword;
1483 * Test if the given keyword 's' is already present in the
1484 * given array, ignoring the '+'-mandatory prefix in the array.
1486 * @param s keyword to test
1487 * @param array keywords to test against, with ' ' or '+' prefix to ignore
1488 * @param array_length length of the array
1489 * @return GNUNET_YES if the keyword exists, GNUNET_NO if not
1492 find_duplicate (const char *s, const char **array, int array_length)
1496 for (j = array_length - 1; j >= 0; j--)
1497 if (0 == strcmp (&array[j][1], s))
1503 normalize_metadata (enum EXTRACTOR_MetaFormat format, const char *data,
1506 uint8_t *free_str = NULL;
1507 uint8_t *str_to_normalize = (uint8_t *) data;
1508 uint8_t *normalized;
1510 if (str_to_normalize == NULL)
1512 /* Don't trust libextractor */
1513 if (format == EXTRACTOR_METAFORMAT_UTF8)
1515 free_str = (uint8_t *) u8_check ((const uint8_t *) data, data_len);
1516 if (free_str == NULL)
1519 format = EXTRACTOR_METAFORMAT_C_STRING;
1521 if (format == EXTRACTOR_METAFORMAT_C_STRING)
1523 free_str = u8_strconv_from_encoding (data, locale_charset (), iconveh_escape_sequence);
1524 if (free_str == NULL)
1528 normalized = u8_tolower (str_to_normalize, strlen ((char *) str_to_normalize), NULL, UNINORM_NFD, NULL, &r_len);
1529 /* free_str is allocated by libunistring internally, use free() */
1530 if (free_str != NULL)
1532 if (normalized != NULL)
1534 /* u8_tolower allocates a non-NULL-terminated string! */
1535 free_str = GNUNET_malloc (r_len + 1);
1536 memcpy (free_str, normalized, r_len);
1537 free_str[r_len] = '\0';
1539 normalized = free_str;
1541 return (char *) normalized;
1545 * Counts the number of UTF-8 characters (not bytes) in the string,
1546 * returns that count.
1549 u8_strcount (const uint8_t *s)
1553 GNUNET_assert (s != NULL);
1556 for (count = 0; s != NULL; count++)
1557 s = u8_next (&c, s);
1563 * Break the filename up by matching [], () and {} pairs to make
1564 * keywords. In case of nesting parentheses only the inner pair counts.
1565 * You can't escape parentheses to scan something like "[blah\{foo]" to
1566 * make a "blah{foo" keyword, this function is only a heuristic!
1568 * @param s string to break down.
1569 * @param array array to fill with enclosed tokens. If NULL, then tokens
1571 * @param index index at which to start filling the array (entries prior
1572 * to it are used to check for duplicates). ignored if array == NULL.
1573 * @return number of tokens counted (including duplicates), or number of
1574 * tokens extracted (excluding duplicates). 0 if there are no
1575 * matching parens in the string (when counting), or when all tokens
1576 * were duplicates (when extracting).
1579 get_keywords_from_parens (const char *s, char **array, int index)
1589 ss = GNUNET_strdup (s);
1590 open_paren = ss - 1;
1591 while (NULL != (open_paren = strpbrk (open_paren + 1, "[{(")))
1595 close_paren = strpbrk (open_paren + 1, "]})");
1596 if (NULL == close_paren)
1598 switch (open_paren[0])
1601 if (']' == close_paren[0])
1605 if ('}' == close_paren[0])
1609 if (')' == close_paren[0])
1615 if (match && (close_paren - open_paren > 1))
1617 tmp = close_paren[0];
1618 close_paren[0] = '\0';
1619 /* Keywords must be at least 3 characters long */
1620 if (u8_strcount ((const uint8_t *) &open_paren[1]) <= 2)
1622 close_paren[0] = tmp;
1628 if (GNUNET_NO == find_duplicate ((const char *) &open_paren[1],
1629 (const char **) array, index + count))
1631 insert_non_mandatory_keyword ((const char *) &open_paren[1], array,
1635 normalized = normalize_metadata (EXTRACTOR_METAFORMAT_UTF8,
1636 &open_paren[1], close_paren - &open_paren[1]);
1637 if (normalized != NULL)
1639 if (GNUNET_NO == find_duplicate ((const char *) normalized,
1640 (const char **) array, index + count))
1642 insert_non_mandatory_keyword ((const char *) normalized, array,
1646 GNUNET_free (normalized);
1651 close_paren[0] = tmp;
1660 * Where to break up keywords
1662 #define TOKENS "_. /-!?#&+@\"\'\\;:,"
1665 * Break the filename up by TOKENS to make
1668 * @param s string to break down.
1669 * @param array array to fill with tokens. If NULL, then tokens are only
1671 * @param index index at which to start filling the array (entries prior
1672 * to it are used to check for duplicates). ignored if array == NULL.
1673 * @return number of tokens (>1) counted (including duplicates), or number of
1674 * tokens extracted (excluding duplicates). 0 if there are no
1675 * separators in the string (when counting), or when all tokens were
1676 * duplicates (when extracting).
1679 get_keywords_from_tokens (const char *s, char **array, int index)
1685 ss = GNUNET_strdup (s);
1686 for (p = strtok (ss, TOKENS); p != NULL; p = strtok (NULL, TOKENS))
1688 /* Keywords must be at least 3 characters long */
1689 if (u8_strcount ((const uint8_t *) p) <= 2)
1694 if (GNUNET_NO == find_duplicate (p, (const char **) array, index + seps))
1696 insert_non_mandatory_keyword (p, array,
1700 normalized = normalize_metadata (EXTRACTOR_METAFORMAT_UTF8,
1702 if (normalized != NULL)
1704 if (GNUNET_NO == find_duplicate ((const char *) normalized,
1705 (const char **) array, index + seps))
1707 insert_non_mandatory_keyword ((const char *) normalized, array,
1711 GNUNET_free (normalized);
1723 * Function called on each value in the meta data.
1724 * Adds it to the URI.
1726 * @param cls URI to update
1727 * @param plugin_name name of the plugin that produced this value;
1728 * special values can be used (i.e. '<zlib>' for zlib being
1729 * used in the main libextractor library and yielding
1731 * @param type libextractor-type describing the meta data
1732 * @param format basic format information about data
1733 * @param data_mime_type mime-type of data (not of the original file);
1734 * can be NULL (if mime-type is not known)
1735 * @param data actual meta-data found
1736 * @param data_len number of bytes in data
1737 * @return 0 (always)
1740 gather_uri_data (void *cls, const char *plugin_name,
1741 enum EXTRACTOR_MetaType type, enum EXTRACTOR_MetaFormat format,
1742 const char *data_mime_type, const char *data, size_t data_len)
1744 struct GNUNET_FS_Uri *uri = cls;
1745 char *normalized_data;
1747 if ((format != EXTRACTOR_METAFORMAT_UTF8) &&
1748 (format != EXTRACTOR_METAFORMAT_C_STRING))
1750 /* Keywords must be at least 3 characters long
1751 * If given non-utf8 string it will, most likely, find it to be invalid,
1752 * and will return the length of its valid part, skipping the keyword.
1753 * If it does - fix the extractor, not this check!
1755 if (u8_strcount ((const uint8_t *) data) <= 2)
1759 normalized_data = normalize_metadata (format, data, data_len);
1760 if (!find_duplicate (data, (const char **) uri->data.ksk.keywords, uri->data.ksk.keywordCount))
1762 insert_non_mandatory_keyword (data,
1763 uri->data.ksk.keywords, uri->data.ksk.keywordCount);
1764 uri->data.ksk.keywordCount++;
1766 if (normalized_data != NULL)
1768 if (!find_duplicate (normalized_data, (const char **) uri->data.ksk.keywords, uri->data.ksk.keywordCount))
1770 insert_non_mandatory_keyword (normalized_data,
1771 uri->data.ksk.keywords, uri->data.ksk.keywordCount);
1772 uri->data.ksk.keywordCount++;
1774 GNUNET_free (normalized_data);
1781 * Construct a keyword-URI from meta-data (take all entries
1782 * in the meta-data and construct one large keyword URI
1783 * that lists all keywords that can be found in the meta-data).
1785 * @param md metadata to use
1786 * @return NULL on error, otherwise a KSK URI
1788 struct GNUNET_FS_Uri *
1789 GNUNET_FS_uri_ksk_create_from_meta_data (const struct GNUNET_CONTAINER_MetaData
1792 struct GNUNET_FS_Uri *ret;
1794 char *full_name = NULL;
1797 int tok_keywords = 0;
1798 int paren_keywords = 0;
1802 ret = GNUNET_malloc (sizeof (struct GNUNET_FS_Uri));
1804 ent = GNUNET_CONTAINER_meta_data_iterate (md, NULL, NULL);
1807 full_name = GNUNET_CONTAINER_meta_data_get_first_by_types (md,
1808 EXTRACTOR_METATYPE_GNUNET_ORIGINAL_FILENAME, -1);
1809 if (NULL != full_name)
1811 filename = full_name;
1812 while (NULL != (ss = strstr (filename, DIR_SEPARATOR_STR)))
1814 tok_keywords = get_keywords_from_tokens (filename, NULL, 0);
1815 paren_keywords = get_keywords_from_parens (filename, NULL, 0);
1817 /* x2 because there might be a normalized variant of every keyword */
1818 ret->data.ksk.keywords = GNUNET_malloc (sizeof (char *) * (ent
1819 + tok_keywords + paren_keywords) * 2);
1820 GNUNET_CONTAINER_meta_data_iterate (md, &gather_uri_data, ret);
1822 if (tok_keywords > 0)
1823 ret->data.ksk.keywordCount += get_keywords_from_tokens (filename,
1824 ret->data.ksk.keywords,
1825 ret->data.ksk.keywordCount);
1826 if (paren_keywords > 0)
1827 ret->data.ksk.keywordCount += get_keywords_from_parens (filename,
1828 ret->data.ksk.keywords,
1829 ret->data.ksk.keywordCount);
1831 GNUNET_free_non_null (full_name);
1837 * In URI-encoding, does the given character
1838 * need to be encoded using %-encoding?
1841 needs_percent (char c)
1844 ((isalnum ((unsigned char) c)) || (c == '-') || (c == '_') ||
1845 (c == '.') || (c == '~')));
1850 * Convert a KSK URI to a string.
1852 * @param uri the URI to convert
1853 * @return NULL on error (i.e. keywordCount == 0)
1856 uri_ksk_to_string (const struct GNUNET_FS_Uri *uri)
1859 unsigned int keywordCount;
1866 const char *keyword;
1868 if (uri->type != ksk)
1870 keywords = uri->data.ksk.keywords;
1871 keywordCount = uri->data.ksk.keywordCount;
1872 n = keywordCount + strlen (GNUNET_FS_URI_PREFIX) +
1873 strlen (GNUNET_FS_URI_KSK_INFIX) + 1;
1874 for (i = 0; i < keywordCount; i++)
1876 keyword = keywords[i];
1877 slen = strlen (keyword);
1879 for (j = 0; j < slen; j++)
1881 if ((j == 0) && (keyword[j] == ' '))
1884 continue; /* skip leading space */
1886 if (needs_percent (keyword[j]))
1887 n += 2; /* will use %-encoding */
1890 ret = GNUNET_malloc (n);
1891 strcpy (ret, GNUNET_FS_URI_PREFIX);
1892 strcat (ret, GNUNET_FS_URI_KSK_INFIX);
1893 wpos = strlen (ret);
1894 for (i = 0; i < keywordCount; i++)
1896 keyword = keywords[i];
1897 slen = strlen (keyword);
1898 for (j = 0; j < slen; j++)
1900 if ((j == 0) && (keyword[j] == ' '))
1901 continue; /* skip leading space */
1902 if (needs_percent (keyword[j]))
1904 sprintf (&ret[wpos], "%%%02X", keyword[j]);
1909 ret[wpos++] = keyword[j];
1912 if (i != keywordCount - 1)
1920 * Convert SKS URI to a string.
1922 * @param uri sks uri to convert
1923 * @return NULL on error
1926 uri_sks_to_string (const struct GNUNET_FS_Uri *uri)
1928 const GNUNET_HashCode *namespace;
1929 const char *identifier;
1931 struct GNUNET_CRYPTO_HashAsciiEncoded ns;
1933 if (uri->type != sks)
1935 namespace = &uri->data.sks.namespace;
1936 identifier = uri->data.sks.identifier;
1937 GNUNET_CRYPTO_hash_to_enc (namespace, &ns);
1938 GNUNET_asprintf (&ret, "%s%s%s/%s", GNUNET_FS_URI_PREFIX,
1939 GNUNET_FS_URI_SKS_INFIX, (const char *) &ns, identifier);
1945 * Convert a CHK URI to a string.
1947 * @param uri chk uri to convert
1948 * @return NULL on error
1951 uri_chk_to_string (const struct GNUNET_FS_Uri *uri)
1953 const struct FileIdentifier *fi;
1955 struct GNUNET_CRYPTO_HashAsciiEncoded keyhash;
1956 struct GNUNET_CRYPTO_HashAsciiEncoded queryhash;
1958 if (uri->type != chk)
1960 fi = &uri->data.chk;
1961 GNUNET_CRYPTO_hash_to_enc (&fi->chk.key, &keyhash);
1962 GNUNET_CRYPTO_hash_to_enc (&fi->chk.query, &queryhash);
1964 GNUNET_asprintf (&ret, "%s%s%s.%s.%llu", GNUNET_FS_URI_PREFIX,
1965 GNUNET_FS_URI_CHK_INFIX, (const char *) &keyhash,
1966 (const char *) &queryhash, GNUNET_ntohll (fi->file_length));
1971 * Convert binary data to a string.
1973 * @param data binary data to convert
1974 * @param size number of bytes in data
1975 * @return converted data
1978 bin2enc (const void *data, size_t size)
1981 * 64 characters for encoding, 6 bits per character
1984 "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_=";
1992 GNUNET_assert (strlen (tbl) == 64);
1994 if (((size * 8) % 6) != 0)
1996 ret = GNUNET_malloc (len + 1);
2001 for (pos = 0; pos < size; pos++)
2003 bits |= ((((const unsigned char *) data)[pos]) << hbits);
2007 ret[len++] = tbl[bits & 63];
2013 ret[len] = tbl[bits & 63];
2019 * Convert a LOC URI to a string.
2021 * @param uri loc uri to convert
2022 * @return NULL on error
2025 uri_loc_to_string (const struct GNUNET_FS_Uri *uri)
2028 struct GNUNET_CRYPTO_HashAsciiEncoded keyhash;
2029 struct GNUNET_CRYPTO_HashAsciiEncoded queryhash;
2033 GNUNET_CRYPTO_hash_to_enc (&uri->data.loc.fi.chk.key, &keyhash);
2034 GNUNET_CRYPTO_hash_to_enc (&uri->data.loc.fi.chk.query, &queryhash);
2036 bin2enc (&uri->data.loc.peer,
2037 sizeof (struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded));
2039 bin2enc (&uri->data.loc.contentSignature,
2040 sizeof (struct GNUNET_CRYPTO_RsaSignature));
2041 GNUNET_asprintf (&ret, "%s%s%s.%s.%llu.%s.%s.%llu", GNUNET_FS_URI_PREFIX,
2042 GNUNET_FS_URI_LOC_INFIX, (const char *) &keyhash,
2043 (const char *) &queryhash,
2044 (unsigned long long) GNUNET_ntohll (uri->data.loc.
2045 fi.file_length), peerId,
2047 (unsigned long long) uri->data.loc.expirationTime.abs_value);
2048 GNUNET_free (peerSig);
2049 GNUNET_free (peerId);
2055 * Convert a URI to a UTF-8 String.
2057 * @param uri uri to convert to a string
2058 * @return the UTF-8 string
2061 GNUNET_FS_uri_to_string (const struct GNUNET_FS_Uri *uri)
2071 return uri_ksk_to_string (uri);
2073 return uri_sks_to_string (uri);
2075 return uri_chk_to_string (uri);
2077 return uri_loc_to_string (uri);
2084 /* end of fs_uri.c */