aboutsummaryrefslogtreecommitdiff
path: root/src/fs/gnunet-fs-gtk_download-save-as.h
blob: d5b4d0511abd813524920418d5298290443b9a07 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
/*
     This file is part of GNUnet.
     (C) 2010 Christian Grothoff (and other contributing authors)

     GNUnet is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published
     by the Free Software Foundation; either version 2, or (at your
     option) any later version.

     GNUnet is distributed in the hope that it will be useful, but
     WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     General Public License for more details.

     You should have received a copy of the GNU General Public License
     along with GNUnet; see the file COPYING.  If not, write to the
     Free Software Foundation, Inc., 59 Temple Place - Suite 330,
     Boston, MA 02111-1307, USA.
*/

/**
 * @file src/fs/gnunet-fs-gtk_download-save-as.h
 * @brief functions for downloading
 * @author Christian Grothoff
 */
#ifndef GNUNET_FS_GTK_DOWNLOAD_SAVE_AS_H
#define GNUNET_FS_GTK_DOWNLOAD_SAVE_AS_H

#include "gnunet-fs-gtk_common.h"


/**
 * Information we keep for a download.
 */
struct DownloadContext;


/**
 * Information we keep for a download.
 */
struct DownloadContext
{
  /**
   * URI for the download.
   */
  struct GNUNET_FS_Uri *uri;

  /**
   * Meta data.
   */
  struct GNUNET_CONTAINER_MetaData *meta;

  /**
   * Mime type.
   */
  char *mime;

  /**
   * Suggested filename, or NULL.
   */
  char *filename;

  /**
   * Row reference (if URI was found by search, or
   * part of directory, etc.); otherwise NULL (download by URI).
   */
  GtkTreeRowReference *rr;

  /**
   * Associated search result, or NULL.
   */
  struct GNUNET_FS_SearchResult *sr;

  /**
   * Is this a recursive download?
   */
  int is_recursive;

  /**
   * Desired (default) anonymity level.
   */
  int anonymity;

  /**
   * Tab where this download is currently on display.
   * (this is the same as sr->tab, but sr is opaque here).
   */
  struct SearchTab *tab;

};


/**
 * Actually start the download that is specified by the given download
 * context and its options.  Will add a download entry to the
 * respective tree model and trigger a start of the download using the
 * FS-API.
 *
 * @param dc download context of the download to execute
 */
void
GNUNET_FS_GTK_download_context_start_download (struct DownloadContext *dc);


/**
 * Open the 'save as' dialog for a download.  Calls
 * 'GNUNET_FS_GTK_download_context_start_download' when the dialog is
 * complete.  Will release the 'dc' resources if the dialog is
 * cancelled.
 *
 * @param dc download context for the file/directory 
 */
void
GNUNET_FS_GTK_open_download_as_dialog (struct DownloadContext *dc);


#endif