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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/* GIO - GLib Input, Output and Streaming Library
*
* Copyright (C) 2008 Benjamin Otte <otte@gnome.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*
* Author: Benjamin Otte <otte@gnome.org>
*/
#ifndef __G_VFS_BACKEND_FTP_H__
#define __G_VFS_BACKEND_FTP_H__
#include <gvfsbackend.h>
#include <gmountspec.h>
#include <gio/gio.h>
G_BEGIN_DECLS
#define G_VFS_FTP_TIMEOUT_IN_SECONDS 30
typedef enum {
G_VFS_FTP_TLS_MODE_NONE, /* plaintext */
G_VFS_FTP_TLS_MODE_IMPLICIT, /* port 990 */
G_VFS_FTP_TLS_MODE_EXPLICIT, /* STARTTLS (RFC 4217) */
} GVfsFtpTlsMode;
typedef enum {
G_VFS_FTP_FEATURE_MDTM,
G_VFS_FTP_FEATURE_SIZE,
G_VFS_FTP_FEATURE_TVFS,
G_VFS_FTP_FEATURE_EPRT,
G_VFS_FTP_FEATURE_EPSV,
G_VFS_FTP_FEATURE_UTF8,
G_VFS_FTP_FEATURE_AUTH_TLS,
G_VFS_FTP_FEATURE_AUTH_SSL,
G_VFS_FTP_FEATURE_CHMOD,
G_VFS_FTP_FEATURE_CHGRP
} GVfsFtpFeature;
#define G_VFS_FTP_FEATURES_DEFAULT (0)
typedef enum {
G_VFS_FTP_SYSTEM_UNKNOWN = 0,
G_VFS_FTP_SYSTEM_UNIX,
G_VFS_FTP_SYSTEM_WINDOWS
} GVfsFtpSystem;
typedef enum {
G_VFS_FTP_METHOD_ANY = 0,
G_VFS_FTP_METHOD_EPSV,
G_VFS_FTP_METHOD_PASV,
G_VFS_FTP_METHOD_PASV_ADDR,
G_VFS_FTP_METHOD_EPRT,
G_VFS_FTP_METHOD_PORT
} GVfsFtpMethod;
typedef enum {
/* server does not allow querying features before login, so we try after
* logging in instead. */
G_VFS_FTP_WORKAROUND_FEAT_AFTER_LOGIN,
} GVfsFtpWorkaround;
/* forward declarations */
typedef struct _GVfsFtpDirCache GVfsFtpDirCache;
typedef struct _GVfsFtpDirFuncs GVfsFtpDirFuncs;
#define G_VFS_TYPE_BACKEND_FTP (g_vfs_backend_ftp_get_type ())
#define G_VFS_BACKEND_FTP(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_VFS_TYPE_BACKEND_FTP, GVfsBackendFtp))
#define G_VFS_BACKEND_FTP_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_VFS_TYPE_BACKEND_FTP, GVfsBackendFtpClass))
#define G_VFS_IS_BACKEND_FTP(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_VFS_TYPE_BACKEND_FTP))
#define G_VFS_IS_BACKEND_FTP_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_VFS_TYPE_BACKEND_FTP))
#define G_VFS_BACKEND_FTP_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_VFS_TYPE_BACKEND_FTP, GVfsBackendFtpClass))
typedef struct _GVfsBackendFtp GVfsBackendFtp;
typedef struct _GVfsBackendFtpClass GVfsBackendFtpClass;
struct _GVfsBackendFtp
{
GVfsBackend backend;
GSocketConnectable * addr;
GSocketClient * connection_factory;
char * user;
gboolean has_initial_user;
char * password; /* password or NULL for anonymous */
char * host_display_name;
/* ftps support */
GVfsFtpTlsMode tls_mode;
GSocketConnectable * server_identity; /* Server identity used for verification */
GTlsCertificate * certificate; /* Initial server certificate */
GTlsCertificateFlags certificate_errors; /* Errors received during TLS handshake */
GMountSource * mount_source; /* Only used during do_mount */
GVfsFtpSystem system; /* the system from the SYST response */
int features; /* GVfsFtpFeatures that are supported */
int workarounds; /* GVfsFtpWorkarounds in use - int because it's atomic */
int method; /* preferred GVfsFtpMethod - int because it's atomic */
/* directory cache */
const GVfsFtpDirFuncs *dir_funcs; /* functions used in directory cache */
GVfsFtpDirCache * dir_cache; /* directory cache */
/* connection collection - accessed from gvfsftptask.c */
GMutex mutex; /* mutex protecting the following variables */
GCond cond; /* cond used to signal tasks waiting on the mutex */
GQueue * queue; /* queue containing the connections */
guint connections; /* current number of connections */
guint busy_connections; /* current number of connections being used for reads/writes */
guint max_connections; /* upper server limit for number of connections - dynamically generated */
};
struct _GVfsBackendFtpClass
{
GVfsBackendClass parent_class;
};
GType g_vfs_backend_ftp_get_type (void) G_GNUC_CONST;
gboolean g_vfs_backend_ftp_has_feature (GVfsBackendFtp * ftp,
GVfsFtpFeature feature);
gboolean g_vfs_backend_ftp_uses_workaround (GVfsBackendFtp * ftp,
GVfsFtpWorkaround workaround);
void g_vfs_backend_ftp_use_workaround (GVfsBackendFtp * ftp,
GVfsFtpWorkaround workaround);
G_END_DECLS
#endif /* __G_VFS_BACKEND_FTP_H__ */
|
