2 This file is part of GNUnet.
3 (C) 2001, 2002, 2004, 2005, 2006, 2007, 2009, 2010, 2011 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.
21 * @file fs/gnunet-publish.c
22 * @brief publishing files on GNUnet
23 * @author Christian Grothoff
24 * @author Krista Bennett
25 * @author James Blackwell
26 * @author Igor Wronsky
29 #include "gnunet_fs_service.h"
35 static const struct GNUNET_CONFIGURATION_Handle *cfg;
37 static struct GNUNET_FS_Handle *ctx;
39 static struct GNUNET_FS_PublishContext *pc;
41 static struct GNUNET_CONTAINER_MetaData *meta;
43 static struct GNUNET_FS_Uri *topKeywords;
45 static struct GNUNET_FS_Uri *uri;
47 static struct GNUNET_FS_BlockOptions bo = { {0LL}, 1, 365, 1 };
49 static char *uri_string;
55 static char *pseudonym;
59 static int disable_extractor;
61 static int do_simulate;
63 static int extract_only;
65 static int do_disable_creation_time;
67 static GNUNET_SCHEDULER_TaskIdentifier kill_task;
71 do_stop_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
73 struct GNUNET_FS_PublishContext *p;
79 GNUNET_FS_publish_stop (p);
82 GNUNET_CONTAINER_meta_data_destroy (meta);
90 * Called by FS client to give information about the progress of an
94 * @param info details about the event, specifying the event type
95 * and various bits about the event
96 * @return client-context (for the next progress call
97 * for this operation; should be set to NULL for
98 * SUSPEND and STOPPED events). The value returned
99 * will be passed to future callbacks in the respective
100 * field in the GNUNET_FS_ProgressInfo struct.
103 progress_cb (void *cls, const struct GNUNET_FS_ProgressInfo *info)
107 switch (info->status)
109 case GNUNET_FS_STATUS_PUBLISH_START:
111 case GNUNET_FS_STATUS_PUBLISH_PROGRESS:
114 s = GNUNET_STRINGS_relative_time_to_string (info->value.publish.eta);
116 _("Publishing `%s' at %llu/%llu (%s remaining)\n"),
117 info->value.publish.filename,
118 (unsigned long long) info->value.publish.completed,
119 (unsigned long long) info->value.publish.size, s);
123 case GNUNET_FS_STATUS_PUBLISH_ERROR:
125 _("Error publishing: %s.\n"),
126 info->value.publish.specifics.error.message);
127 if (kill_task != GNUNET_SCHEDULER_NO_TASK)
129 GNUNET_SCHEDULER_cancel (kill_task);
130 kill_task = GNUNET_SCHEDULER_NO_TASK;
132 GNUNET_SCHEDULER_add_continuation (&do_stop_task,
134 GNUNET_SCHEDULER_REASON_PREREQ_DONE);
136 case GNUNET_FS_STATUS_PUBLISH_COMPLETED:
138 _("Publishing `%s' done.\n"), info->value.publish.filename);
139 s = GNUNET_FS_uri_to_string (info->value.publish.specifics.
141 fprintf (stdout, _("URI is `%s'.\n"), s);
143 if (info->value.publish.pctx == NULL)
145 if (kill_task != GNUNET_SCHEDULER_NO_TASK)
147 GNUNET_SCHEDULER_cancel (kill_task);
148 kill_task = GNUNET_SCHEDULER_NO_TASK;
150 GNUNET_SCHEDULER_add_continuation (&do_stop_task,
152 GNUNET_SCHEDULER_REASON_PREREQ_DONE);
155 case GNUNET_FS_STATUS_PUBLISH_STOPPED:
156 GNUNET_break (NULL == pc);
159 fprintf (stderr, _("Unexpected status: %d\n"), info->status);
162 return ""; /* non-null */
167 * Print metadata entries (except binary
168 * metadata and the filename).
171 * @param plugin_name name of the plugin that generated the meta data
172 * @param type type of the meta data
173 * @param format format of data
174 * @param data_mime_type mime type of data
175 * @param data value of the meta data
176 * @param data_size number of bytes in data
180 meta_printer (void *cls,
181 const char *plugin_name,
182 enum EXTRACTOR_MetaType type,
183 enum EXTRACTOR_MetaFormat format,
184 const char *data_mime_type, const char *data, size_t data_size)
186 if ((format != EXTRACTOR_METAFORMAT_UTF8) &&
187 (format != EXTRACTOR_METAFORMAT_C_STRING))
189 if (type == EXTRACTOR_METATYPE_GNUNET_ORIGINAL_FILENAME)
191 fprintf (stdout, "\t%s - %s\n", EXTRACTOR_metatype_to_string (type), data);
197 * Iterator printing keywords
200 * @param keyword the keyword
201 * @param is_mandatory is the keyword mandatory (in a search)
202 * @return GNUNET_OK to continue to iterate, GNUNET_SYSERR to abort
206 keyword_printer (void *cls, const char *keyword, int is_mandatory)
208 fprintf (stdout, "\t%s\n", keyword);
214 * Function called on all entries before the publication. This is
215 * where we perform modifications to the default based on command-line
219 * @param fi the entry in the publish-structure
220 * @param length length of the file or directory
221 * @param m metadata for the file or directory (can be modified)
222 * @param uri pointer to the keywords that will be used for this entry (can be modified)
223 * @param bo block options
224 * @param do_index should we index?
225 * @param client_info pointer to client context set upon creation (can be modified)
226 * @return GNUNET_OK to continue, GNUNET_NO to remove
227 * this entry from the directory, GNUNET_SYSERR
228 * to abort the iteration
231 publish_inspector (void *cls,
232 struct GNUNET_FS_FileInformation *fi,
234 struct GNUNET_CONTAINER_MetaData *m,
235 struct GNUNET_FS_Uri **uri,
236 struct GNUNET_FS_BlockOptions *bo,
237 int *do_index, void **client_info)
241 struct GNUNET_FS_Uri *new_uri;
245 if (NULL != topKeywords)
249 new_uri = GNUNET_FS_uri_ksk_merge (topKeywords, *uri);
250 GNUNET_FS_uri_destroy (*uri);
252 GNUNET_FS_uri_destroy (topKeywords);
262 GNUNET_CONTAINER_meta_data_merge (m, meta);
263 GNUNET_CONTAINER_meta_data_destroy (meta);
266 if (!do_disable_creation_time)
267 GNUNET_CONTAINER_meta_data_add_publication_date (m);
270 fn = GNUNET_CONTAINER_meta_data_get_by_type (m,
271 EXTRACTOR_METATYPE_GNUNET_ORIGINAL_FILENAME);
272 fs = GNUNET_STRINGS_byte_size_fancy (length);
273 fprintf (stdout, _("Meta data for file `%s' (%s)\n"), fn, fs);
274 GNUNET_CONTAINER_meta_data_iterate (m, &meta_printer, NULL);
275 fprintf (stdout, _("Keywords for file `%s' (%s)\n"), fn, fs);
279 GNUNET_FS_uri_ksk_get_keywords (*uri, &keyword_printer, NULL);
280 fprintf (stdout, "\n");
282 if (GNUNET_YES == GNUNET_FS_meta_data_test_for_directory (m))
283 GNUNET_FS_file_information_inspect (fi, &publish_inspector, fi);
289 uri_sks_continuation (void *cls,
290 const struct GNUNET_FS_Uri *ksk_uri, const char *emsg)
294 fprintf (stderr, "%s\n", emsg);
297 GNUNET_FS_uri_destroy (uri);
299 GNUNET_FS_stop (ctx);
305 uri_ksk_continuation (void *cls,
306 const struct GNUNET_FS_Uri *ksk_uri, const char *emsg)
308 struct GNUNET_FS_Namespace *ns;
312 fprintf (stderr, "%s\n", emsg);
315 if (pseudonym != NULL)
317 ns = GNUNET_FS_namespace_create (ctx, pseudonym);
320 fprintf (stderr, _("Failed to create namespace `%s'\n"), pseudonym);
325 GNUNET_FS_publish_sks (ctx,
332 GNUNET_FS_PUBLISH_OPTION_NONE,
333 uri_sks_continuation, NULL);
334 GNUNET_assert (GNUNET_OK == GNUNET_FS_namespace_delete (ns, GNUNET_NO));
338 GNUNET_FS_uri_destroy (uri);
340 GNUNET_FS_stop (ctx);
346 * Main function that will be run by the scheduler.
349 * @param args remaining command-line arguments
350 * @param cfgfile name of the configuration file used (for saving, can be NULL!)
351 * @param c configuration
356 const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *c)
358 struct GNUNET_FS_FileInformation *fi;
359 struct GNUNET_FS_Namespace *namespace;
360 struct EXTRACTOR_PluginList *plugins;
361 struct GNUNET_FS_Uri *keywords;
366 /* check arguments */
367 if ((uri_string != NULL) && (extract_only))
369 printf (_("Cannot extract metadata from a URI!\n"));
373 if (((uri_string == NULL) || (extract_only))
374 && ((args[0] == NULL) || (args[1] != NULL)))
376 printf (_("You must specify one and only one filename for insertion.\n"));
380 if ((uri_string != NULL) && (args[0] != NULL))
382 printf (_("You must NOT specify an URI and a filename.\n"));
386 if (pseudonym != NULL)
391 _("Option `%s' is required when using option `%s'.\n"),
398 { /* ordinary insertion checks */
402 _("Option `%s' makes no sense without option `%s'.\n"),
410 _("Option `%s' makes no sense without option `%s'.\n"),
417 ctx = GNUNET_FS_start (cfg,
420 NULL, GNUNET_FS_FLAGS_NONE, GNUNET_FS_OPTIONS_END);
423 fprintf (stderr, _("Could not initialize `%s' subsystem.\n"), "FS");
428 if (NULL != pseudonym)
430 namespace = GNUNET_FS_namespace_create (ctx, pseudonym);
431 if (NULL == namespace)
433 fprintf (stderr, _("Could not create namespace `%s'\n"), pseudonym);
434 GNUNET_FS_stop (ctx);
439 if (NULL != uri_string)
442 uri = GNUNET_FS_uri_parse (uri_string, &emsg);
445 fprintf (stderr, _("Failed to parse URI: %s\n"), emsg);
447 if (namespace != NULL)
448 GNUNET_FS_namespace_delete (namespace, GNUNET_NO);
449 GNUNET_FS_stop (ctx);
453 GNUNET_FS_publish_ksk (ctx,
458 GNUNET_FS_PUBLISH_OPTION_NONE,
459 &uri_ksk_continuation, NULL);
460 if (namespace != NULL)
461 GNUNET_FS_namespace_delete (namespace, GNUNET_NO);
465 if (!disable_extractor)
467 plugins = EXTRACTOR_plugin_add_defaults (EXTRACTOR_OPTION_DEFAULT_POLICY);
469 GNUNET_CONFIGURATION_get_value_string (cfg, "FS", "EXTRACTORS", &ex))
473 EXTRACTOR_plugin_add_config (plugins, ex,
474 EXTRACTOR_OPTION_DEFAULT_POLICY);
479 GNUNET_assert (NULL != args[0]);
480 if (0 != STAT (args[0], &sbuf))
482 GNUNET_asprintf (&emsg, _("Could not access file: %s\n"), STRERROR (errno));
485 else if (S_ISDIR (sbuf.st_mode))
487 fi = GNUNET_FS_file_information_create_from_directory (ctx,
490 &GNUNET_FS_directory_scanner_default,
498 meta = GNUNET_CONTAINER_meta_data_create ();
499 GNUNET_FS_meta_data_extract_from_file (meta, args[0], plugins);
500 keywords = GNUNET_FS_uri_ksk_create_from_meta_data (meta);
501 fi = GNUNET_FS_file_information_create_from_file (ctx,
505 NULL, !do_insert, &bo);
506 GNUNET_break (fi != NULL);
507 GNUNET_FS_uri_destroy (keywords);
509 EXTRACTOR_plugin_remove_all (plugins);
512 fprintf (stderr, _("Could not publish `%s': %s\n"), args[0], emsg);
514 if (namespace != NULL)
515 GNUNET_FS_namespace_delete (namespace, GNUNET_NO);
516 GNUNET_FS_stop (ctx);
520 GNUNET_FS_file_information_inspect (fi, &publish_inspector, NULL);
523 if (namespace != NULL)
524 GNUNET_FS_namespace_delete (namespace, GNUNET_NO);
525 GNUNET_FS_file_information_destroy (fi, NULL, NULL);
526 GNUNET_FS_stop (ctx);
529 pc = GNUNET_FS_publish_start (ctx,
535 ? GNUNET_FS_PUBLISH_OPTION_SIMULATE_ONLY
536 : GNUNET_FS_PUBLISH_OPTION_NONE);
539 fprintf (stderr, _("Could not start publishing.\n"));
540 GNUNET_FS_stop (ctx);
544 kill_task = GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_FOREVER_REL,
545 &do_stop_task, NULL);
552 * The main function to publish content to GNUnet.
554 * @param argc number of arguments from the command line
555 * @param argv command line arguments
556 * @return 0 ok, 1 on error
559 main (int argc, char *const *argv)
561 static const struct GNUNET_GETOPT_CommandLineOption options[] = {
562 {'a', "anonymity", "LEVEL",
563 gettext_noop ("set the desired LEVEL of sender-anonymity"),
564 1, &GNUNET_GETOPT_set_uint, &bo.anonymity_level},
565 {'d', "disable-creation-time", NULL,
567 ("disable adding the creation time to the metadata of the uploaded file"),
568 0, &GNUNET_GETOPT_set_one, &do_disable_creation_time},
569 {'D', "disable-extractor", NULL,
570 gettext_noop ("do not use libextractor to add keywords or metadata"),
571 0, &GNUNET_GETOPT_set_one, &disable_extractor},
572 {'e', "extract", NULL,
574 ("print list of extracted keywords that would be used, but do not perform upload"),
575 0, &GNUNET_GETOPT_set_one, &extract_only},
576 {'k', "key", "KEYWORD",
578 ("add an additional keyword for the top-level file or directory"
579 " (this option can be specified multiple times)"),
580 1, &GNUNET_FS_getopt_set_keywords, &topKeywords},
581 {'m', "meta", "TYPE:VALUE",
582 gettext_noop ("set the meta-data for the given TYPE to the given VALUE"),
583 1, &GNUNET_FS_getopt_set_metadata, &meta},
584 {'n', "noindex", NULL,
585 gettext_noop ("do not index, perform full insertion (stores entire "
586 "file in encrypted form in GNUnet database)"),
587 0, &GNUNET_GETOPT_set_one, &do_insert},
590 ("specify ID of an updated version to be published in the future"
591 " (for namespace insertions only)"),
592 1, &GNUNET_GETOPT_set_string, &next_id},
593 {'p', "priority", "PRIORITY",
594 gettext_noop ("specify the priority of the content"),
595 1, &GNUNET_GETOPT_set_uint, &bo.content_priority},
596 {'P', "pseudonym", "NAME",
598 ("publish the files under the pseudonym NAME (place file into namespace)"),
599 1, &GNUNET_GETOPT_set_string, &pseudonym},
600 {'r', "replication", "LEVEL",
601 gettext_noop ("set the desired replication LEVEL"),
602 1, &GNUNET_GETOPT_set_uint, &bo.replication_level},
603 {'s', "simulate-only", NULL,
604 gettext_noop ("only simulate the process but do not do any "
605 "actual publishing (useful to compute URIs)"),
606 0, &GNUNET_GETOPT_set_one, &do_simulate},
608 gettext_noop ("set the ID of this version of the publication"
609 " (for namespace insertions only)"),
610 1, &GNUNET_GETOPT_set_string, &this_id},
612 gettext_noop ("URI to be published (can be used instead of passing a "
613 "file to add keywords to the file with the respective URI)"),
614 1, &GNUNET_GETOPT_set_string, &uri_string},
615 {'V', "verbose", NULL,
616 gettext_noop ("be verbose (print progress information)"),
617 0, &GNUNET_GETOPT_set_one, &verbose},
618 GNUNET_GETOPT_OPTION_END
621 GNUNET_FS_year_to_time (GNUNET_FS_get_current_year () + 2);
623 GNUNET_PROGRAM_run (argc, argv, "gnunet-publish [OPTIONS] FILENAME",
625 ("Publish a file or directory on GNUnet"),
626 options, &run, NULL)) ? ret : 1;
629 /* end of gnunet-publish.c */