Mercurial > audlegacy
annotate src/audacious/vfs.c @ 2540:6b2743b54fd7 trunk
[svn] - update options printout
author | nenolod |
---|---|
date | Sat, 17 Feb 2007 02:30:32 -0800 |
parents | c3d5ac206052 |
children | 07b990906823 |
rev | line source |
---|---|
2313 | 1 /* Audacious |
2 * Copyright (c) 2006-2007 William Pitcock | |
3 * | |
4 * This program is free software; you can redistribute it and/or modify | |
5 * it under the terms of the GNU General Public License as published by | |
6 * the Free Software Foundation; under version 2 of the License. | |
7 * | |
8 * This program is distributed in the hope that it will be useful, | |
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
11 * GNU General Public License for more details. | |
12 * | |
13 * You should have received a copy of the GNU General Public License | |
14 * along with this program; if not, write to the Free Software | |
15 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. | |
16 */ | |
17 | |
18 #include "vfs.h" | |
19 #include <stdio.h> | |
20 | |
21 #include <unistd.h> | |
22 #include <sys/stat.h> | |
23 #include <sys/types.h> | |
24 | |
2336 | 25 #include <string.h> |
26 | |
2416
0fd7f4f969ad
[svn] integrated urldecode.* from libaudacious into audacious directory, made separate ui_fileopener.*
mf0102
parents:
2381
diff
changeset
|
27 #include "urldecode.h" |
2313 | 28 |
29 static GList *vfs_transports = NULL; | |
30 | |
31 #ifdef VFS_DEBUG | |
32 # define DBG(x, args...) g_print(x, ## args); | |
33 #else | |
34 # define DBG(x, args...) | |
35 #endif | |
36 | |
37 /** | |
38 * vfs_register_transport: | |
39 * @vtable: The #VFSConstructor vtable to register. | |
40 * | |
41 * Registers a #VFSConstructor vtable with the VFS system. | |
42 * | |
43 * Return value: TRUE on success, FALSE on failure. | |
44 **/ | |
45 gboolean | |
46 vfs_register_transport(VFSConstructor *vtable) | |
47 { | |
48 vfs_transports = g_list_append(vfs_transports, vtable); | |
49 | |
50 return TRUE; | |
51 } | |
52 | |
53 /** | |
54 * vfs_fopen: | |
55 * @path: The path or URI to open. | |
56 * @mode: The preferred access privileges (not guaranteed). | |
57 * | |
58 * Opens a stream from a VFS transport using a #VFSConstructor. | |
59 * | |
60 * Return value: On success, a #VFSFile object representing the stream. | |
61 **/ | |
62 VFSFile * | |
63 vfs_fopen(const gchar * path, | |
64 const gchar * mode) | |
65 { | |
66 VFSFile *file; | |
67 VFSConstructor *vtable = NULL; | |
68 GList *node; | |
69 gchar *decpath; | |
70 | |
71 if (!path || !mode) | |
72 return NULL; | |
73 | |
2381
d49913587458
[svn] - changes to the nature of URI handling in the VFS subsystem, will be
nenolod
parents:
2376
diff
changeset
|
74 decpath = g_strdup(path); |
2313 | 75 |
2335
e80c9dfc93aa
[svn] - g_strsplit() wraps strsplit(3), and thus has different results on
nenolod
parents:
2313
diff
changeset
|
76 for (node = vfs_transports; node != NULL; node = g_list_next(node)) |
2313 | 77 { |
2534 | 78 VFSConstructor *vtptr = (VFSConstructor *) node->data; |
2313 | 79 |
2533
ab335d4391df
[svn] - don't return a bogus vtable for an unregistered URI scheme
nenolod
parents:
2416
diff
changeset
|
80 if (!strncasecmp(decpath, vtptr->uri_id, strlen(vtptr->uri_id))) |
ab335d4391df
[svn] - don't return a bogus vtable for an unregistered URI scheme
nenolod
parents:
2416
diff
changeset
|
81 { |
ab335d4391df
[svn] - don't return a bogus vtable for an unregistered URI scheme
nenolod
parents:
2416
diff
changeset
|
82 vtable = vtptr; |
2335
e80c9dfc93aa
[svn] - g_strsplit() wraps strsplit(3), and thus has different results on
nenolod
parents:
2313
diff
changeset
|
83 break; |
2533
ab335d4391df
[svn] - don't return a bogus vtable for an unregistered URI scheme
nenolod
parents:
2416
diff
changeset
|
84 } |
2313 | 85 } |
86 | |
87 /* no transport vtable has been registered, bail. */ | |
88 if (vtable == NULL) | |
89 return NULL; | |
90 | |
2381
d49913587458
[svn] - changes to the nature of URI handling in the VFS subsystem, will be
nenolod
parents:
2376
diff
changeset
|
91 file = vtable->vfs_fopen_impl(decpath, mode); |
2313 | 92 |
93 if (file == NULL) | |
94 return NULL; | |
95 | |
96 file->uri = g_strdup(path); | |
97 file->base = vtable; | |
98 | |
99 g_free(decpath); | |
100 | |
101 return file; | |
102 } | |
103 | |
104 /** | |
105 * vfs_fclose: | |
106 * @file: A #VFSFile object to destroy. | |
107 * | |
108 * Closes a VFS stream and destroys a #VFSFile object. | |
109 * | |
110 * Return value: -1 on failure, 0 on success. | |
111 **/ | |
112 gint | |
113 vfs_fclose(VFSFile * file) | |
114 { | |
115 gint ret = 0; | |
116 | |
117 if (file == NULL) | |
118 return -1; | |
119 | |
120 if (file->base->vfs_fclose_impl(file) != 0) | |
121 ret = -1; | |
122 | |
123 if (file->uri != NULL) | |
124 g_free(file->uri); | |
125 | |
126 g_free(file); | |
127 | |
128 return ret; | |
129 } | |
130 | |
131 /** | |
132 * vfs_fread: | |
133 * @ptr: A pointer to the destination buffer. | |
134 * @size: The size of each element to read. | |
135 * @nmemb: The number of elements to read. | |
136 * @file: #VFSFile object that represents the VFS stream. | |
137 * | |
138 * Reads from a VFS stream. | |
139 * | |
140 * Return value: The amount of elements succesfully read. | |
141 **/ | |
142 size_t | |
143 vfs_fread(gpointer ptr, | |
144 size_t size, | |
145 size_t nmemb, | |
146 VFSFile * file) | |
147 { | |
148 if (file == NULL) | |
149 return 0; | |
150 | |
151 return file->base->vfs_fread_impl(ptr, size, nmemb, file); | |
152 } | |
153 | |
154 /** | |
155 * vfs_fwrite: | |
156 * @ptr: A const pointer to the source buffer. | |
157 * @size: The size of each element to write. | |
158 * @nmemb: The number of elements to write. | |
159 * @file: #VFSFile object that represents the VFS stream. | |
160 * | |
161 * Writes to a VFS stream. | |
162 * | |
163 * Return value: The amount of elements succesfully written. | |
164 **/ | |
165 size_t | |
166 vfs_fwrite(gconstpointer ptr, | |
167 size_t size, | |
168 size_t nmemb, | |
169 VFSFile * file) | |
170 { | |
171 if (file == NULL) | |
172 return 0; | |
173 | |
174 return file->base->vfs_fwrite_impl(ptr, size, nmemb, file); | |
175 } | |
176 | |
177 /** | |
178 * vfs_getc: | |
179 * @stream: #VFSFile object that represents the VFS stream. | |
180 * | |
181 * Reads a character from a VFS stream. | |
182 * | |
183 * Return value: On success, a character. Otherwise, -1. | |
184 **/ | |
185 gint | |
186 vfs_getc(VFSFile *stream) | |
187 { | |
188 if (stream == NULL) | |
189 return -1; | |
190 | |
191 return stream->base->vfs_getc_impl(stream); | |
192 } | |
193 | |
194 /** | |
195 * vfs_ungetc: | |
196 * @c: The character to push back. | |
197 * @stream: #VFSFile object that represents the VFS stream. | |
198 * | |
199 * Pushes a character back to the VFS stream. | |
200 * | |
201 * Return value: On success, 0. Otherwise, -1. | |
202 **/ | |
203 gint | |
204 vfs_ungetc(gint c, VFSFile *stream) | |
205 { | |
206 if (stream == NULL) | |
207 return -1; | |
208 | |
209 return stream->base->vfs_ungetc_impl(c, stream); | |
210 } | |
211 | |
212 /** | |
213 * vfs_fseek: | |
214 * @file: #VFSFile object that represents the VFS stream. | |
215 * @offset: The offset to seek to. | |
216 * @whence: Whether or not the seek is absolute or not. | |
217 * | |
218 * Seeks through a VFS stream. | |
219 * | |
220 * Return value: On success, 1. Otherwise, 0. | |
221 **/ | |
222 gint | |
223 vfs_fseek(VFSFile * file, | |
224 glong offset, | |
225 gint whence) | |
226 { | |
227 if (file == NULL) | |
228 return 0; | |
229 | |
230 return file->base->vfs_fseek_impl(file, offset, whence); | |
231 } | |
232 | |
233 /** | |
234 * vfs_rewind: | |
235 * @file: #VFSFile object that represents the VFS stream. | |
236 * | |
237 * Rewinds a VFS stream. | |
238 **/ | |
239 void | |
240 vfs_rewind(VFSFile * file) | |
241 { | |
242 if (file == NULL) | |
243 return; | |
244 | |
245 file->base->vfs_rewind_impl(file); | |
246 } | |
247 | |
248 /** | |
249 * vfs_ftell: | |
250 * @file: #VFSFile object that represents the VFS stream. | |
251 * | |
252 * Returns the current position in the VFS stream's buffer. | |
253 * | |
254 * Return value: On success, the current position. Otherwise, -1. | |
255 **/ | |
256 glong | |
257 vfs_ftell(VFSFile * file) | |
258 { | |
259 if (file == NULL) | |
260 return -1; | |
261 | |
262 return file->base->vfs_ftell_impl(file); | |
263 } | |
264 | |
265 /** | |
266 * vfs_feof: | |
267 * @file: #VFSFile object that represents the VFS stream. | |
268 * | |
269 * Returns whether or not the VFS stream has reached EOF. | |
270 * | |
271 * Return value: On success, whether or not the VFS stream is at EOF. Otherwise, FALSE. | |
272 **/ | |
273 gboolean | |
274 vfs_feof(VFSFile * file) | |
275 { | |
276 if (file == NULL) | |
277 return FALSE; | |
278 | |
279 return (gboolean) file->base->vfs_feof_impl(file); | |
280 } | |
281 | |
282 /** | |
283 * vfs_truncate: | |
284 * @file: #VFSFile object that represents the VFS stream. | |
285 * @length: The length to truncate at. | |
286 * | |
287 * Truncates a VFS stream to a certain size. | |
288 * | |
289 * Return value: On success, 0. Otherwise, -1. | |
290 **/ | |
291 gint | |
292 vfs_truncate(VFSFile * file, glong length) | |
293 { | |
294 if (file == NULL) | |
295 return -1; | |
296 | |
297 return file->base->vfs_truncate_impl(file, length); | |
298 } | |
299 | |
300 /** | |
2376
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
301 * vfs_get_metadata: |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
302 * @file: #VFSFile object that represents the VFS stream. |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
303 * @field: The string constant field name to get. |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
304 * |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
305 * Returns metadata about the stream. |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
306 * |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
307 * Return value: On success, a copy of the value of the |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
308 * field. Otherwise, NULL. |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
309 **/ |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
310 gchar * |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
311 vfs_get_metadata(VFSFile * file, const gchar * field) |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
312 { |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
313 if (file == NULL) |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
314 return NULL; |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
315 |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
316 if (file->base->vfs_get_metadata_impl) |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
317 return file->base->vfs_get_metadata_impl(file, field); |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
318 return NULL; |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
319 } |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
320 |
e1513290ee3c
[svn] Add a VFSFile method for getting metadata associated with the file.
iabervon
parents:
2370
diff
changeset
|
321 /** |
2313 | 322 * vfs_file_test: |
323 * @path: A path to test. | |
324 * @test: A GFileTest to run. | |
325 * | |
326 * Wrapper for g_file_test(). | |
327 * | |
328 * Return value: The result of g_file_test(). | |
329 **/ | |
330 gboolean | |
331 vfs_file_test(const gchar * path, GFileTest test) | |
332 { | |
333 return g_file_test(path, test); | |
334 } | |
335 | |
336 /** | |
337 * vfs_is_writeable: | |
338 * @path: A path to test. | |
339 * | |
340 * Tests if a file is writeable. | |
341 * | |
342 * Return value: TRUE if the file is writeable, otherwise FALSE. | |
343 **/ | |
344 gboolean | |
345 vfs_is_writeable(const gchar * path) | |
346 { | |
347 struct stat info; | |
348 | |
349 if (stat(path, &info) == -1) | |
350 return FALSE; | |
351 | |
352 return (info.st_mode & S_IWUSR); | |
353 } |