~ubuntu-branches/ubuntu/natty/gnome-vfs/natty
» Revision
17
: doc/html/gnome-vfs-2.0-gnome-vfs-file-info.html
« back to all changes in this revision
Viewing changes to doc/html/gnome-vfs-2.0-gnome-vfs-file-info.html
- browse files at revision 17
- compare with another revision
- download diff
- download tarball
- view history from revision 17
- Committer: Bazaar Package Importer
- Author(s): Sebastien Bacher
- Date: 2009-03-17 16:12:58 UTC
- mfrom: (0.2.2 upstream)
- Revision ID: james.westby@ubuntu.com-20090317161258-px3a2czt9g2ktjz3
Tags: 1:2.24.1-0ubuntu1
New upstream version
- files removed:
- doc/html/gnome-vfs-20-gnome-vfs-application-registry.html
- files modified:
- ChangeLog
added
removed
doc/html/gnome-vfs-2.0-gnome-vfs-file-info.html
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html>
3
<head>
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>GnomeVFSFileInfo</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
7
<link rel="home" href="index.html" title="GnomeVFS - Filesystem Abstraction library">
8
<link rel="up" href="data-types.html" title="Basic Data Types">
9
<link rel="prev" href="gnome-vfs-2.0-gnome-vfs-utils.html" title="gnome-vfs-utils">
10
<link rel="next" href="gnome-vfs-2.0-gnome-vfs-file-size.html" title="GnomeVFSFileSize">
11
<meta name="generator" content="GTK-Doc V1.12 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="about.html" title="Introduction to GnomeVFS">
14
<link rel="chapter" href="data-types.html" title="Basic Data Types">
15
<link rel="chapter" href="gnome-vfs-basic-file-ops.html" title="File Operations">
16
<link rel="chapter" href="gnome-vfs-directory-ops.html" title="Directory-Specific Operations">
17
<link rel="chapter" href="gnome-vfs-file-and-dirs-ops.html" title="Advanced File/Directory Operations">
18
<link rel="chapter" href="gnome-vfs-file-async-ops.html" title="Asynchronous Operations">
19
<link rel="chapter" href="volumes.html" title="Volumes and Drives Handling">
20
<link rel="chapter" href="networking.html" title="Networking">
21
<link rel="chapter" href="mime-registry.html" title="MIME Registry">
22
<link rel="chapter" href="modules.html" title="Filesystem Modules">
23
</head>
24
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
25
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
26
<tr valign="middle">
27
<td><a accesskey="p" href="gnome-vfs-2.0-gnome-vfs-utils.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
28
<td><a accesskey="u" href="data-types.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
29
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
30
<th width="100%" align="center">GnomeVFS - Filesystem Abstraction library</th>
31
<td><a accesskey="n" href="gnome-vfs-2.0-gnome-vfs-file-size.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
32
</tr>
33
<tr><td colspan="5" class="shortcuts">
34
<a href="#gnome-vfs-2.0-gnome-vfs-file-info.synopsis" class="shortcut">Top</a>
35
|
36
<a href="#gnome-vfs-2.0-gnome-vfs-file-info.description" class="shortcut">Description</a>
37
</td></tr>
38
</table>
39
<div class="refentry" lang="en">
40
<a name="gnome-vfs-2.0-gnome-vfs-file-info"></a><div class="titlepage"></div>
41
<div class="refnamediv"><table width="100%"><tr>
42
<td valign="top">
43
<h2><span class="refentrytitle"><a name="gnome-vfs-2.0-gnome-vfs-file-info.top_of_page"></a>GnomeVFSFileInfo</span></h2>
44
<p>GnomeVFSFileInfo — stores information about files, GnomeVFS equivalent of stat</p>
45
</td>
46
<td valign="top" align="right"></td>
47
</tr></table></div>
48
<div class="refsynopsisdiv">
49
<a name="gnome-vfs-2.0-gnome-vfs-file-info.synopsis"></a><h2>Synopsis</h2>
50
<pre class="synopsis">
51
enum <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileFlags" title="enum GnomeVFSFileFlags">GnomeVFSFileFlags</a>;
52
enum <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileType" title="enum GnomeVFSFileType">GnomeVFSFileType</a>;
53
enum <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfoFields" title="enum GnomeVFSFileInfoFields">GnomeVFSFileInfoFields</a>;
54
enum <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions">GnomeVFSFilePermissions</a>;
55
enum <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions" title="enum GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a>;
56
enum <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSSetFileInfoMask" title="enum GnomeVFSSetFileInfoMask">GnomeVFSSetFileInfoMask</a>;
57
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a>;
58
typedef <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSInodeNumber" title="GnomeVFSInodeNumber">GnomeVFSInodeNumber</a>;
59
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a>;
60
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SYMLINK:CAPS" title="GNOME_VFS_FILE_INFO_SYMLINK()">GNOME_VFS_FILE_INFO_SYMLINK</a> (info)
61
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SET-SYMLINK:CAPS" title="GNOME_VFS_FILE_INFO_SET_SYMLINK()">GNOME_VFS_FILE_INFO_SET_SYMLINK</a> (info, value)
62
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-LOCAL:CAPS" title="GNOME_VFS_FILE_INFO_LOCAL()">GNOME_VFS_FILE_INFO_LOCAL</a> (info)
63
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SET-LOCAL:CAPS" title="GNOME_VFS_FILE_INFO_SET_LOCAL()">GNOME_VFS_FILE_INFO_SET_LOCAL</a> (info, value)
64
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SUID:CAPS" title="GNOME_VFS_FILE_INFO_SUID()">GNOME_VFS_FILE_INFO_SUID</a> (info)
65
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SGID:CAPS" title="GNOME_VFS_FILE_INFO_SGID()">GNOME_VFS_FILE_INFO_SGID</a> (info)
66
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-STICKY:CAPS" title="GNOME_VFS_FILE_INFO_STICKY()">GNOME_VFS_FILE_INFO_STICKY</a> (info)
67
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SET-SUID:CAPS" title="GNOME_VFS_FILE_INFO_SET_SUID()">GNOME_VFS_FILE_INFO_SET_SUID</a> (info, value)
68
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SET-SGID:CAPS" title="GNOME_VFS_FILE_INFO_SET_SGID()">GNOME_VFS_FILE_INFO_SET_SGID</a> (info, value)
69
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-SET-STICKY:CAPS" title="GNOME_VFS_FILE_INFO_SET_STICKY()">GNOME_VFS_FILE_INFO_SET_STICKY</a> (info, value)
70
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-new" title="gnome_vfs_file_info_new ()">gnome_vfs_file_info_new</a> (void);
71
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-unref" title="gnome_vfs_file_info_unref ()">gnome_vfs_file_info_unref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
72
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-ref" title="gnome_vfs_file_info_ref ()">gnome_vfs_file_info_ref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
73
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-clear" title="gnome_vfs_file_info_clear ()">gnome_vfs_file_info_clear</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
74
const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-get-mime-type" title="gnome_vfs_file_info_get_mime_type ()">gnome_vfs_file_info_get_mime_type</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
75
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-copy" title="gnome_vfs_file_info_copy ()">gnome_vfs_file_info_copy</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *dest,
76
const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *src);
77
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-dup" title="gnome_vfs_file_info_dup ()">gnome_vfs_file_info_dup</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *orig);
78
gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-matches" title="gnome_vfs_file_info_matches ()">gnome_vfs_file_info_matches</a> (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *a,
79
const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *b);
80
GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-list-ref" title="gnome_vfs_file_info_list_ref ()">gnome_vfs_file_info_list_ref</a> (GList *list);
81
GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-list-unref" title="gnome_vfs_file_info_list_unref ()">gnome_vfs_file_info_list_unref</a> (GList *list);
82
GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-list-copy" title="gnome_vfs_file_info_list_copy ()">gnome_vfs_file_info_list_copy</a> (GList *list);
83
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-list-free" title="gnome_vfs_file_info_list_free ()">gnome_vfs_file_info_list_free</a> (GList *list);
84
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a>* <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-get-file-info-result-dup" title="gnome_vfs_get_file_info_result_dup ()">gnome_vfs_get_file_info_result_dup</a>
85
(<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a> *result);
86
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-get-file-info-result-free" title="gnome_vfs_get_file_info_result_free ()">gnome_vfs_get_file_info_result_free</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a> *result);
87
</pre>
88
</div>
89
<div class="refsect1" lang="en">
90
<a name="gnome-vfs-2.0-gnome-vfs-file-info.description"></a><h2>Description</h2>
91
<p>
92
</p>
93
</div>
94
<div class="refsect1" lang="en">
95
<a name="gnome-vfs-2.0-gnome-vfs-file-info.details"></a><h2>Details</h2>
96
<div class="refsect2" lang="en">
97
<a name="GnomeVFSFileFlags"></a><h3>enum GnomeVFSFileFlags</h3>
98
<pre class="programlisting">typedef enum {
99
GNOME_VFS_FILE_FLAGS_NONE = 0,
100
GNOME_VFS_FILE_FLAGS_SYMLINK = 1 << 0,
101
GNOME_VFS_FILE_FLAGS_LOCAL = 1 << 1
102
} GnomeVFSFileFlags;
103
</pre>
104
<p>
105
Packed boolean bitfield representing special
106
flags a <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct can have.</p>
107
<p>
108
</p>
109
<div class="variablelist"><table border="0">
110
<col align="left" valign="top">
111
<tbody>
112
<tr>
113
<td><p><a name="GNOME-VFS-FILE-FLAGS-NONE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_FLAGS_NONE</code></span></p></td>
114
<td> no flags
115
</td>
116
</tr>
117
<tr>
118
<td><p><a name="GNOME-VFS-FILE-FLAGS-SYMLINK:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_FLAGS_SYMLINK</code></span></p></td>
119
<td> whether the file is a symlink.
120
</td>
121
</tr>
122
<tr>
123
<td><p><a name="GNOME-VFS-FILE-FLAGS-LOCAL:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_FLAGS_LOCAL</code></span></p></td>
124
<td> whether the file is on a local filesystem
125
</td>
126
</tr>
127
</tbody>
128
</table></div>
129
</div>
130
<hr>
131
<div class="refsect2" lang="en">
132
<a name="GnomeVFSFileType"></a><h3>enum GnomeVFSFileType</h3>
133
<pre class="programlisting">typedef enum {
134
GNOME_VFS_FILE_TYPE_UNKNOWN,
135
GNOME_VFS_FILE_TYPE_REGULAR,
136
GNOME_VFS_FILE_TYPE_DIRECTORY,
137
GNOME_VFS_FILE_TYPE_FIFO,
138
GNOME_VFS_FILE_TYPE_SOCKET,
139
GNOME_VFS_FILE_TYPE_CHARACTER_DEVICE,
140
GNOME_VFS_FILE_TYPE_BLOCK_DEVICE,
141
GNOME_VFS_FILE_TYPE_SYMBOLIC_LINK
142
} GnomeVFSFileType;
143
</pre>
144
<p>
145
Maps to a <code class="literal">stat</code> mode, and identifies the kind of file represented by a
146
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct, stored in the <code class="literal">type</code> field.</p>
147
<p>
148
</p>
149
<div class="variablelist"><table border="0">
150
<col align="left" valign="top">
151
<tbody>
152
<tr>
153
<td><p><a name="GNOME-VFS-FILE-TYPE-UNKNOWN:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_UNKNOWN</code></span></p></td>
154
<td> The file type is unknown (none of the types below matches).
155
</td>
156
</tr>
157
<tr>
158
<td><p><a name="GNOME-VFS-FILE-TYPE-REGULAR:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_REGULAR</code></span></p></td>
159
<td> The file is a regular file (stat: <code class="literal">S_ISREG</code>).
160
</td>
161
</tr>
162
<tr>
163
<td><p><a name="GNOME-VFS-FILE-TYPE-DIRECTORY:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_DIRECTORY</code></span></p></td>
164
<td> The file is a directory (stat: <code class="literal">S_ISDIR</code>).
165
</td>
166
</tr>
167
<tr>
168
<td><p><a name="GNOME-VFS-FILE-TYPE-FIFO:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_FIFO</code></span></p></td>
169
<td> The file is a FIFO (stat: <code class="literal">S_ISFIFO</code>).
170
</td>
171
</tr>
172
<tr>
173
<td><p><a name="GNOME-VFS-FILE-TYPE-SOCKET:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_SOCKET</code></span></p></td>
174
<td> The file is a socket (stat: <code class="literal">S_ISSOCK</code>).
175
</td>
176
</tr>
177
<tr>
178
<td><p><a name="GNOME-VFS-FILE-TYPE-CHARACTER-DEVICE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_CHARACTER_DEVICE</code></span></p></td>
179
<td> The file is a character device (stat: <code class="literal">S_ISCHR</code>).
180
</td>
181
</tr>
182
<tr>
183
<td><p><a name="GNOME-VFS-FILE-TYPE-BLOCK-DEVICE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_BLOCK_DEVICE</code></span></p></td>
184
<td> The file is a block device (stat: <code class="literal">S_ISBLK</code>).
185
</td>
186
</tr>
187
<tr>
188
<td><p><a name="GNOME-VFS-FILE-TYPE-SYMBOLIC-LINK:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_TYPE_SYMBOLIC_LINK</code></span></p></td>
189
<td> The file is a symbolic link (stat: <code class="literal">S_ISLNK</code>).
190
</td>
191
</tr>
192
</tbody>
193
</table></div>
194
</div>
195
<hr>
196
<div class="refsect2" lang="en">
197
<a name="GnomeVFSFileInfoFields"></a><h3>enum GnomeVFSFileInfoFields</h3>
198
<pre class="programlisting">typedef enum {
199
GNOME_VFS_FILE_INFO_FIELDS_NONE = 0,
200
GNOME_VFS_FILE_INFO_FIELDS_TYPE = 1 << 0,
201
GNOME_VFS_FILE_INFO_FIELDS_PERMISSIONS = 1 << 1,
202
GNOME_VFS_FILE_INFO_FIELDS_FLAGS = 1 << 2,
203
GNOME_VFS_FILE_INFO_FIELDS_DEVICE = 1 << 3,
204
GNOME_VFS_FILE_INFO_FIELDS_INODE = 1 << 4,
205
GNOME_VFS_FILE_INFO_FIELDS_LINK_COUNT = 1 << 5,
206
GNOME_VFS_FILE_INFO_FIELDS_SIZE = 1 << 6,
207
GNOME_VFS_FILE_INFO_FIELDS_BLOCK_COUNT = 1 << 7,
208
GNOME_VFS_FILE_INFO_FIELDS_IO_BLOCK_SIZE = 1 << 8,
209
GNOME_VFS_FILE_INFO_FIELDS_ATIME = 1 << 9,
210
GNOME_VFS_FILE_INFO_FIELDS_MTIME = 1 << 10,
211
GNOME_VFS_FILE_INFO_FIELDS_CTIME = 1 << 11,
212
GNOME_VFS_FILE_INFO_FIELDS_SYMLINK_NAME = 1 << 12,
213
GNOME_VFS_FILE_INFO_FIELDS_MIME_TYPE = 1 << 13,
214
GNOME_VFS_FILE_INFO_FIELDS_ACCESS = 1 << 14,
215
GNOME_VFS_FILE_INFO_FIELDS_IDS = 1 << 15,
216
GNOME_VFS_FILE_INFO_FIELDS_ACL = 1 << 16,
217
GNOME_VFS_FILE_INFO_FIELDS_SELINUX_CONTEXT = 1 << 17
218
} GnomeVFSFileInfoFields;
219
</pre>
220
<p>
221
Flags indicating what fields in a <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct are valid.
222
Name is always assumed valid (how else would you have gotten a
223
FileInfo struct otherwise?)</p>
224
<p>
225
</p>
226
<div class="variablelist"><table border="0">
227
<col align="left" valign="top">
228
<tbody>
229
<tr>
230
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-NONE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_NONE</code></span></p></td>
231
<td> No fields are valid
232
</td>
233
</tr>
234
<tr>
235
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-TYPE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_TYPE</code></span></p></td>
236
<td> Type field is valid
237
</td>
238
</tr>
239
<tr>
240
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-PERMISSIONS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_PERMISSIONS</code></span></p></td>
241
<td> Permissions field is valid
242
</td>
243
</tr>
244
<tr>
245
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-FLAGS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_FLAGS</code></span></p></td>
246
<td> Flags field is valid
247
</td>
248
</tr>
249
<tr>
250
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-DEVICE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_DEVICE</code></span></p></td>
251
<td> Device field is valid
252
</td>
253
</tr>
254
<tr>
255
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-INODE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_INODE</code></span></p></td>
256
<td> Inode field is valid
257
</td>
258
</tr>
259
<tr>
260
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-LINK-COUNT:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_LINK_COUNT</code></span></p></td>
261
<td> Link count field is valid
262
</td>
263
</tr>
264
<tr>
265
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-SIZE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_SIZE</code></span></p></td>
266
<td> Size field is valid
267
</td>
268
</tr>
269
<tr>
270
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-BLOCK-COUNT:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_BLOCK_COUNT</code></span></p></td>
271
<td> Block count field is valid
272
</td>
273
</tr>
274
<tr>
275
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-IO-BLOCK-SIZE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_IO_BLOCK_SIZE</code></span></p></td>
276
<td> I/O Block Size field is valid
277
</td>
278
</tr>
279
<tr>
280
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-ATIME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_ATIME</code></span></p></td>
281
<td> Access time field is valid
282
</td>
283
</tr>
284
<tr>
285
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-MTIME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_MTIME</code></span></p></td>
286
<td> Modification time field is valid
287
</td>
288
</tr>
289
<tr>
290
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-CTIME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_CTIME</code></span></p></td>
291
<td> Creating time field is valid
292
</td>
293
</tr>
294
<tr>
295
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-SYMLINK-NAME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_SYMLINK_NAME</code></span></p></td>
296
<td> Symlink name field is valid
297
</td>
298
</tr>
299
<tr>
300
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-MIME-TYPE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_MIME_TYPE</code></span></p></td>
301
<td> Mime type field is valid
302
</td>
303
</tr>
304
<tr>
305
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-ACCESS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_ACCESS</code></span></p></td>
306
<td> Access bits of the permissions
307
bitfield are valid
308
</td>
309
</tr>
310
<tr>
311
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-IDS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_IDS</code></span></p></td>
312
<td> UID and GID information are valid
313
</td>
314
</tr>
315
<tr>
316
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-ACL:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_ACL</code></span></p></td>
317
<td> ACL field is valid
318
</td>
319
</tr>
320
<tr>
321
<td><p><a name="GNOME-VFS-FILE-INFO-FIELDS-SELINUX-CONTEXT:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FIELDS_SELINUX_CONTEXT</code></span></p></td>
322
<td> SELinux Security context is valid
323
</td>
324
</tr>
325
</tbody>
326
</table></div>
327
</div>
328
<hr>
329
<div class="refsect2" lang="en">
330
<a name="GnomeVFSFilePermissions"></a><h3>enum GnomeVFSFilePermissions</h3>
331
<pre class="programlisting">typedef enum {
332
GNOME_VFS_PERM_SUID = S_ISUID,
333
GNOME_VFS_PERM_SGID = S_ISGID,
334
GNOME_VFS_PERM_STICKY = 01000, /* S_ISVTX not defined on all systems */
335
GNOME_VFS_PERM_USER_READ = S_IRUSR,
336
GNOME_VFS_PERM_USER_WRITE = S_IWUSR,
337
GNOME_VFS_PERM_USER_EXEC = S_IXUSR,
338
GNOME_VFS_PERM_USER_ALL = S_IRUSR | S_IWUSR | S_IXUSR,
339
GNOME_VFS_PERM_GROUP_READ = S_IRGRP,
340
GNOME_VFS_PERM_GROUP_WRITE = S_IWGRP,
341
GNOME_VFS_PERM_GROUP_EXEC = S_IXGRP,
342
GNOME_VFS_PERM_GROUP_ALL = S_IRGRP | S_IWGRP | S_IXGRP,
343
GNOME_VFS_PERM_OTHER_READ = S_IROTH,
344
GNOME_VFS_PERM_OTHER_WRITE = S_IWOTH,
345
GNOME_VFS_PERM_OTHER_EXEC = S_IXOTH,
346
GNOME_VFS_PERM_OTHER_ALL = S_IROTH | S_IWOTH | S_IXOTH,
347
GNOME_VFS_PERM_ACCESS_READABLE = 1 << 16,
348
GNOME_VFS_PERM_ACCESS_WRITABLE = 1 << 17,
349
GNOME_VFS_PERM_ACCESS_EXECUTABLE = 1 << 18
350
} GnomeVFSFilePermissions;
351
</pre>
352
<p>
353
File permissions. Some of these fields correspond to traditional
354
UNIX semantics, others provide more abstract concepts.
355
</p>
356
<p>
357
</p>
358
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
359
<h3 class="title">Note</h3>
360
Some network file systems don't support traditional UNIX semantics but
361
still provide file access control. Thus, if you want to modify the
362
permissions (i.e. do a chmod), you should rely on the traditional
363
fields, but if you just want to determine whether a file or directory
364
can be read from or written to, you should rely on the more
365
abstract <code class="literal">GNOME_VFS_PERM_ACCESS_</code>* fields.
366
</div>
367
<p>
368
</p>
369
<div class="variablelist"><table border="0">
370
<col align="left" valign="top">
371
<tbody>
372
<tr>
373
<td><p><a name="GNOME-VFS-PERM-SUID:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_SUID</code></span></p></td>
374
<td> UID bit
375
</td>
376
</tr>
377
<tr>
378
<td><p><a name="GNOME-VFS-PERM-SGID:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_SGID</code></span></p></td>
379
<td> GID bit
380
</td>
381
</tr>
382
<tr>
383
<td><p><a name="GNOME-VFS-PERM-STICKY:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_STICKY</code></span></p></td>
384
<td> Sticky bit.
385
</td>
386
</tr>
387
<tr>
388
<td><p><a name="GNOME-VFS-PERM-USER-WRITE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_USER_WRITE</code></span></p></td>
389
<td> Owner has write permission.
390
</td>
391
</tr>
392
<tr>
393
<td><p><a name="GNOME-VFS-PERM-USER-EXEC:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_USER_EXEC</code></span></p></td>
394
<td> Owner has execution permission.
395
</td>
396
</tr>
397
<tr>
398
<td><p><a name="GNOME-VFS-PERM-USER-ALL:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_USER_ALL</code></span></p></td>
399
<td> Owner has all permissions.
400
</td>
401
</tr>
402
<tr>
403
<td><p><a name="GNOME-VFS-PERM-GROUP-READ:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_GROUP_READ</code></span></p></td>
404
<td> Group has read permission.
405
</td>
406
</tr>
407
<tr>
408
<td><p><a name="GNOME-VFS-PERM-GROUP-WRITE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_GROUP_WRITE</code></span></p></td>
409
<td> Group has write permission.
410
</td>
411
</tr>
412
<tr>
413
<td><p><a name="GNOME-VFS-PERM-GROUP-EXEC:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_GROUP_EXEC</code></span></p></td>
414
<td> Group has execution permission.
415
</td>
416
</tr>
417
<tr>
418
<td><p><a name="GNOME-VFS-PERM-GROUP-ALL:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_GROUP_ALL</code></span></p></td>
419
<td> Group has all permissions.
420
</td>
421
</tr>
422
<tr>
423
<td><p><a name="GNOME-VFS-PERM-OTHER-READ:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_OTHER_READ</code></span></p></td>
424
<td> Others have read permission.
425
</td>
426
</tr>
427
<tr>
428
<td><p><a name="GNOME-VFS-PERM-OTHER-WRITE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_OTHER_WRITE</code></span></p></td>
429
<td> Others have write permission.
430
</td>
431
</tr>
432
<tr>
433
<td><p><a name="GNOME-VFS-PERM-OTHER-EXEC:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_OTHER_EXEC</code></span></p></td>
434
<td> Others have execution permission.
435
</td>
436
</tr>
437
<tr>
438
<td><p><a name="GNOME-VFS-PERM-OTHER-ALL:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_OTHER_ALL</code></span></p></td>
439
<td> Others have all permissions.
440
</td>
441
</tr>
442
<tr>
443
<td><p><a name="GNOME-VFS-PERM-ACCESS-READABLE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_ACCESS_READABLE</code></span></p></td>
444
<td> This file is readable for the current client.
445
</td>
446
</tr>
447
<tr>
448
<td><p><a name="GNOME-VFS-PERM-ACCESS-WRITABLE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_ACCESS_WRITABLE</code></span></p></td>
449
<td> This file is writable for the current client.
450
</td>
451
</tr>
452
<tr>
453
<td><p><a name="GNOME-VFS-PERM-ACCESS-EXECUTABLE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_ACCESS_EXECUTABLE</code></span></p></td>
454
<td> This file is executable for the current client.
455
</td>
456
</tr>
457
</tbody>
458
</table></div>
459
</div>
460
<hr>
461
<div class="refsect2" lang="en">
462
<a name="GnomeVFSFileInfoOptions"></a><h3>enum GnomeVFSFileInfoOptions</h3>
463
<pre class="programlisting">typedef enum {
464
GNOME_VFS_FILE_INFO_DEFAULT = 0,
465
GNOME_VFS_FILE_INFO_GET_MIME_TYPE = 1 << 0,
466
GNOME_VFS_FILE_INFO_FORCE_FAST_MIME_TYPE = 1 << 1,
467
GNOME_VFS_FILE_INFO_FORCE_SLOW_MIME_TYPE = 1 << 2,
468
GNOME_VFS_FILE_INFO_FOLLOW_LINKS = 1 << 3,
469
GNOME_VFS_FILE_INFO_GET_ACCESS_RIGHTS = 1 << 4,
470
GNOME_VFS_FILE_INFO_NAME_ONLY = 1 << 5,
471
GNOME_VFS_FILE_INFO_GET_ACL = 1 << 6,
472
GNOME_VFS_FILE_INFO_GET_SELINUX_CONTEXT = 1 << 7
473
} GnomeVFSFileInfoOptions;
474
</pre>
475
<p>
476
Packed boolean bitfield representing options that can
477
be passed into a <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info-ops.html#gnome-vfs-get-file-info" title="gnome_vfs_get_file_info ()"><code class="function">gnome_vfs_get_file_info()</code></a> call (or other
478
related calls that return file info) and affect the operation
479
of get_file_info.</p>
480
<p>
481
</p>
482
<div class="variablelist"><table border="0">
483
<col align="left" valign="top">
484
<tbody>
485
<tr>
486
<td><p><a name="GNOME-VFS-FILE-INFO-DEFAULT:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_DEFAULT</code></span></p></td>
487
<td> default flags
488
</td>
489
</tr>
490
<tr>
491
<td><p><a name="GNOME-VFS-FILE-INFO-GET-MIME-TYPE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_GET_MIME_TYPE</code></span></p></td>
492
<td> detect the MIME type
493
</td>
494
</tr>
495
<tr>
496
<td><p><a name="GNOME-VFS-FILE-INFO-FORCE-FAST-MIME-TYPE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FORCE_FAST_MIME_TYPE</code></span></p></td>
497
<td> only use fast MIME type
498
detection (extensions)
499
</td>
500
</tr>
501
<tr>
502
<td><p><a name="GNOME-VFS-FILE-INFO-FORCE-SLOW-MIME-TYPE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FORCE_SLOW_MIME_TYPE</code></span></p></td>
503
<td> force slow MIME type
504
detection where available (sniffing, algorithmic detection, etc)
505
</td>
506
</tr>
507
<tr>
508
<td><p><a name="GNOME-VFS-FILE-INFO-FOLLOW-LINKS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_FOLLOW_LINKS</code></span></p></td>
509
<td> automatically follow symbolic
510
links and retrieve the properties of their target (recommended)
511
</td>
512
</tr>
513
<tr>
514
<td><p><a name="GNOME-VFS-FILE-INFO-GET-ACCESS-RIGHTS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_GET_ACCESS_RIGHTS</code></span></p></td>
515
<td> tries to get data similar
516
to what would return access(2) on a local file system (ie is the
517
file readable, writable and/or executable). Can be really slow on
518
remote file systems
519
</td>
520
</tr>
521
<tr>
522
<td><p><a name="GNOME-VFS-FILE-INFO-NAME-ONLY:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_NAME_ONLY</code></span></p></td>
523
<td> When reading a directory, only
524
get the filename (if doing so is faster). Useful to e.g. count
525
the number of files.
526
</td>
527
</tr>
528
<tr>
529
<td><p><a name="GNOME-VFS-FILE-INFO-GET-ACL:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_GET_ACL</code></span></p></td>
530
<td> get ACLs for the file
531
</td>
532
</tr>
533
<tr>
534
<td><p><a name="GNOME-VFS-FILE-INFO-GET-SELINUX-CONTEXT:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_FILE_INFO_GET_SELINUX_CONTEXT</code></span></p></td>
535
<td>
536
</td>
537
</tr>
538
</tbody>
539
</table></div>
540
</div>
541
<hr>
542
<div class="refsect2" lang="en">
543
<a name="GnomeVFSSetFileInfoMask"></a><h3>enum GnomeVFSSetFileInfoMask</h3>
544
<pre class="programlisting">typedef enum {
545
GNOME_VFS_SET_FILE_INFO_NONE = 0,
546
GNOME_VFS_SET_FILE_INFO_NAME = 1 << 0,
547
GNOME_VFS_SET_FILE_INFO_PERMISSIONS = 1 << 1,
548
GNOME_VFS_SET_FILE_INFO_OWNER = 1 << 2,
549
GNOME_VFS_SET_FILE_INFO_TIME = 1 << 3,
550
GNOME_VFS_SET_FILE_INFO_ACL = 1 << 4,
551
GNOME_VFS_SET_FILE_INFO_SELINUX_CONTEXT = 1 << 5,
552
GNOME_VFS_SET_FILE_INFO_SYMLINK_NAME = 1 << 6
553
} GnomeVFSSetFileInfoMask;
554
</pre>
555
<p>
556
Packed boolean bitfield representing the aspects of the file
557
to be changed in a <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info-ops.html#gnome-vfs-set-file-info" title="gnome_vfs_set_file_info ()"><code class="function">gnome_vfs_set_file_info()</code></a> call.</p>
558
<p>
559
</p>
560
<div class="variablelist"><table border="0">
561
<col align="left" valign="top">
562
<tbody>
563
<tr>
564
<td><p><a name="GNOME-VFS-SET-FILE-INFO-NONE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_NONE</code></span></p></td>
565
<td> don't set any file info fields
566
</td>
567
</tr>
568
<tr>
569
<td><p><a name="GNOME-VFS-SET-FILE-INFO-NAME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_NAME</code></span></p></td>
570
<td> change the name
571
</td>
572
</tr>
573
<tr>
574
<td><p><a name="GNOME-VFS-SET-FILE-INFO-PERMISSIONS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_PERMISSIONS</code></span></p></td>
575
<td> change the permissions
576
</td>
577
</tr>
578
<tr>
579
<td><p><a name="GNOME-VFS-SET-FILE-INFO-OWNER:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_OWNER</code></span></p></td>
580
<td> change the file's owner
581
</td>
582
</tr>
583
<tr>
584
<td><p><a name="GNOME-VFS-SET-FILE-INFO-TIME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_TIME</code></span></p></td>
585
<td> change the file's time stamp(s)
586
</td>
587
</tr>
588
<tr>
589
<td><p><a name="GNOME-VFS-SET-FILE-INFO-ACL:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_ACL</code></span></p></td>
590
<td> change the file's ACLs
591
</td>
592
</tr>
593
<tr>
594
<td><p><a name="GNOME-VFS-SET-FILE-INFO-SELINUX-CONTEXT:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_SELINUX_CONTEXT</code></span></p></td>
595
<td>
596
</td>
597
</tr>
598
<tr>
599
<td><p><a name="GNOME-VFS-SET-FILE-INFO-SYMLINK-NAME:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_SET_FILE_INFO_SYMLINK_NAME</code></span></p></td>
600
<td> change the file's symlink name
601
</td>
602
</tr>
603
</tbody>
604
</table></div>
605
</div>
606
<hr>
607
<div class="refsect2" lang="en">
608
<a name="GnomeVFSGetFileInfoResult"></a><h3>GnomeVFSGetFileInfoResult</h3>
609
<pre class="programlisting">typedef struct {
610
GnomeVFSURI *uri;
611
GnomeVFSResult result;
612
GnomeVFSFileInfo *file_info;
613
} GnomeVFSGetFileInfoResult;
614
</pre>
615
<p>
616
This data structure encapsulates the details of an individual file
617
info request that was part of a mass file info request launched
618
through <a class="link" href="gnome-vfs-2.0-gnome-vfs-async-ops.html#gnome-vfs-async-get-file-info" title="gnome_vfs_async_get_file_info ()"><code class="function">gnome_vfs_async_get_file_info()</code></a>, and is passed to a
619
<span class="type">GnomeVFSAsyncGetFileInfoCallback.</span></p>
620
<p>
621
</p>
622
<div class="variablelist"><table border="0">
623
<col align="left" valign="top">
624
<tbody>
625
<tr>
626
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *<em class="structfield"><code><a name="GnomeVFSGetFileInfoResult.uri"></a>uri</code></em>;</span></p></td>
627
<td> The <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> the file info was requested for.
628
</td>
629
</tr>
630
<tr>
631
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult">GnomeVFSResult</a> <em class="structfield"><code><a name="GnomeVFSGetFileInfoResult.result"></a>result</code></em>;</span></p></td>
632
<td> The <a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult"><span class="type">GnomeVFSResult</span></a> of the file info request.
633
</td>
634
</tr>
635
<tr>
636
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *<em class="structfield"><code><a name="GnomeVFSGetFileInfoResult.file_info"></a>file_info</code></em>;</span></p></td>
637
<td> The <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> that was retrieved.
638
</td>
639
</tr>
640
</tbody>
641
</table></div>
642
</div>
643
<hr>
644
<div class="refsect2" lang="en">
645
<a name="GnomeVFSInodeNumber"></a><h3>GnomeVFSInodeNumber</h3>
646
<pre class="programlisting">typedef GnomeVFSFileSize GnomeVFSInodeNumber;
647
</pre>
648
<p>
649
Represents the i-node of a file, this is a low level data structure
650
that the operating system uses to hold information about a file.</p>
651
<p>
652
</p>
653
</div>
654
<hr>
655
<div class="refsect2" lang="en">
656
<a name="GnomeVFSFileInfo"></a><h3>GnomeVFSFileInfo</h3>
657
<pre class="programlisting">typedef struct {
658
char *name;
659
660
GnomeVFSFileInfoFields valid_fields;
661
GnomeVFSFileType type;
662
GnomeVFSFilePermissions permissions;
663
664
GnomeVFSFileFlags flags;
665
666
dev_t device;
667
GnomeVFSInodeNumber inode;
668
669
guint link_count;
670
671
guint uid;
672
guint gid;
673
674
GnomeVFSFileSize size;
675
676
GnomeVFSFileSize block_count;
677
678
guint io_block_size;
679
680
time_t atime;
681
time_t mtime;
682
time_t ctime;
683
684
char *symlink_name;
685
686
char *mime_type;
687
688
guint refcount;
689
690
/* File ACLs */
691
GnomeVFSACL *acl;
692
693
/* SELinux security context. -- ascii string, raw format. */
694
char* selinux_context;
695
} GnomeVFSFileInfo;
696
</pre>
697
<p>
698
</p>
699
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
700
<h3 class="title">Note</h3>
701
When doing massive I/O, it is suggested to adhere <em class="parameter"><code>io_block_size</code></em> if applicable.
702
For network file systems, this may be set to very big values allowing
703
parallelization.
704
</div>
705
<p>
706
</p>
707
<p>
708
The GnomeVFSFileInfo structure contains information about a file.</p>
709
<p>
710
</p>
711
<div class="variablelist"><table border="0">
712
<col align="left" valign="top">
713
<tbody>
714
<tr>
715
<td><p><span class="term">char *<em class="structfield"><code><a name="GnomeVFSFileInfo.name"></a>name</code></em>;</span></p></td>
716
<td> A char * specifying the base name of the file (without any path string).
717
</td>
718
</tr>
719
<tr>
720
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfoFields" title="enum GnomeVFSFileInfoFields">GnomeVFSFileInfoFields</a> <em class="structfield"><code><a name="GnomeVFSFileInfo.valid_fields"></a>valid_fields</code></em>;</span></p></td>
721
<td> <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfoFields" title="enum GnomeVFSFileInfoFields"><span class="type">GnomeVFSFileInfoFields</span></a> specifying which fields of
722
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> are valid. Note that <em class="parameter"><code>name</code></em> is always
723
assumed to be valid, i.e. clients may assume that it is not NULL.
724
</td>
725
</tr>
726
<tr>
727
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileType" title="enum GnomeVFSFileType">GnomeVFSFileType</a> <em class="structfield"><code><a name="GnomeVFSFileInfo.type"></a>type</code></em>;</span></p></td>
728
<td> The <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileType" title="enum GnomeVFSFileType"><span class="type">GnomeVFSFileType</span></a> of the file (i.e. regular, directory, block device, ...)
729
if <em class="parameter"><code>valid_fields</code></em> provides GNOME_VFS_FILE_INFO_FIELDS_TYPE.
730
</td>
731
</tr>
732
<tr>
733
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions">GnomeVFSFilePermissions</a> <em class="structfield"><code><a name="GnomeVFSFileInfo.permissions"></a>permissions</code></em>;</span></p></td>
734
<td> The <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions"><span class="type">GnomeVFSFilePermissions</span></a> corresponding to the UNIX-like
735
permissions of the file, if <em class="parameter"><code>valid_fields</code></em> provides
736
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-PERMISSIONS:CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_PERMISSIONS</span></a>, and the
737
<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions"><span class="type">GnomeVFSFilePermissions</span></a> corresponding to abstract access
738
concepts (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-PERM-ACCESS-READABLE:CAPS"><span class="type">GNOME_VFS_PERM_ACCESS_READABLE</span></a>, <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-PERM-ACCESS-WRITABLE:CAPS"><span class="type">GNOME_VFS_PERM_ACCESS_WRITABLE</span></a>,
739
and <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-PERM-ACCESS-EXECUTABLE:CAPS"><span class="type">GNOME_VFS_PERM_ACCESS_EXECUTABLE</span></a>) if <em class="parameter"><code>valid_fields</code></em>
740
provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_PERMISSIONS.</span>
741
</td>
742
</tr>
743
<tr>
744
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileFlags" title="enum GnomeVFSFileFlags">GnomeVFSFileFlags</a> <em class="structfield"><code><a name="GnomeVFSFileInfo.flags"></a>flags</code></em>;</span></p></td>
745
<td> <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileFlags" title="enum GnomeVFSFileFlags"><span class="type">GnomeVFSFileFlags</span></a> providing additional information about the file,
746
for instance whether it is local or a symbolic link, if
747
<em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_FLAGS.</span>
748
</td>
749
</tr>
750
<tr>
751
<td><p><span class="term">dev_t <em class="structfield"><code><a name="GnomeVFSFileInfo.device"></a>device</code></em>;</span></p></td>
752
<td> Identifies the device the file is located on, if
753
<em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_DEVICE.</span>
754
</td>
755
</tr>
756
<tr>
757
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSInodeNumber" title="GnomeVFSInodeNumber">GnomeVFSInodeNumber</a> <em class="structfield"><code><a name="GnomeVFSFileInfo.inode"></a>inode</code></em>;</span></p></td>
758
<td> Identifies the inode corresponding to the file, if
759
<em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_INODE.</span>
760
</td>
761
</tr>
762
<tr>
763
<td><p><span class="term">guint <em class="structfield"><code><a name="GnomeVFSFileInfo.link_count"></a>link_count</code></em>;</span></p></td>
764
<td> Counts the number of hard links to the file, if
765
<em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_LINK_COUNT.</span>
766
</td>
767
</tr>
768
<tr>
769
<td><p><span class="term">guint <em class="structfield"><code><a name="GnomeVFSFileInfo.uid"></a>uid</code></em>;</span></p></td>
770
<td> The user owning the file, if <em class="parameter"><code>valid_fields</code></em> provides
771
GNOME_VFS_FILE_INFO_FIELDS_IDS.
772
</td>
773
</tr>
774
<tr>
775
<td><p><span class="term">guint <em class="structfield"><code><a name="GnomeVFSFileInfo.gid"></a>gid</code></em>;</span></p></td>
776
<td> The user owning the file, if <em class="parameter"><code>valid_fields</code></em> provides
777
GNOME_VFS_FILE_INFO_FIELDS_IDS.
778
</td>
779
</tr>
780
<tr>
781
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize">GnomeVFSFileSize</a> <em class="structfield"><code><a name="GnomeVFSFileInfo.size"></a>size</code></em>;</span></p></td>
782
<td> The size of the file in bytes (a <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize"><span class="type">GnomeVFSFileSize</span></a>),
783
if <em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_SIZE.</span>
784
</td>
785
</tr>
786
<tr>
787
<td><p><span class="term"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize">GnomeVFSFileSize</a> <em class="structfield"><code><a name="GnomeVFSFileInfo.block_count"></a>block_count</code></em>;</span></p></td>
788
<td> The size of the file in file system blocks (a <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize"><span class="type">GnomeVFSFileSize</span></a>),
789
if <em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_BLOCK_COUNT.</span>
790
</td>
791
</tr>
792
<tr>
793
<td><p><span class="term">guint <em class="structfield"><code><a name="GnomeVFSFileInfo.io_block_size"></a>io_block_size</code></em>;</span></p></td>
794
<td> The optimal buffer size for reading/writing the file, if
795
<em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_IO_BLOCK_SIZE.</span>
796
</td>
797
</tr>
798
<tr>
799
<td><p><span class="term">time_t <em class="structfield"><code><a name="GnomeVFSFileInfo.atime"></a>atime</code></em>;</span></p></td>
800
<td> The time of the last file access, if <em class="parameter"><code>valid_fields</code></em> provides
801
<span class="type">GNOME_VFS_FILE_INFO_FIELDS_ATIME.</span>
802
</td>
803
</tr>
804
<tr>
805
<td><p><span class="term">time_t <em class="structfield"><code><a name="GnomeVFSFileInfo.mtime"></a>mtime</code></em>;</span></p></td>
806
<td> The time of the last file contents modification, if <em class="parameter"><code>valid_fields</code></em>
807
provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_MTIME.</span>
808
</td>
809
</tr>
810
<tr>
811
<td><p><span class="term">time_t <em class="structfield"><code><a name="GnomeVFSFileInfo.ctime"></a>ctime</code></em>;</span></p></td>
812
<td> The time of the last inode change, if <em class="parameter"><code>valid_fields</code></em> provides
813
<span class="type">GNOME_VFS_FILE_INFO_FIELDS_CTIME.</span>
814
</td>
815
</tr>
816
<tr>
817
<td><p><span class="term">char *<em class="structfield"><code><a name="GnomeVFSFileInfo.symlink_name"></a>symlink_name</code></em>;</span></p></td>
818
<td> This is the name of the file this link points to, <em class="parameter"><code>type</code></em>
819
is <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GNOME-VFS-FILE-FLAGS-SYMLINK:CAPS"><span class="type">GNOME_VFS_FILE_FLAGS_SYMLINK</span></a>, and <em class="parameter"><code>valid_fields</code></em>
820
provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_SYMLINK_NAME.</span>
821
</td>
822
</tr>
823
<tr>
824
<td><p><span class="term">char *<em class="structfield"><code><a name="GnomeVFSFileInfo.mime_type"></a>mime_type</code></em>;</span></p></td>
825
<td> This is a char * identifying the type of the file, if
826
<em class="parameter"><code>valid_fields</code></em> provides <span class="type">GNOME_VFS_FILE_INFO_FIELDS_MIME_TYPE.</span>
827
</td>
828
</tr>
829
<tr>
830
<td><p><span class="term">guint <em class="structfield"><code><a name="GnomeVFSFileInfo.refcount"></a>refcount</code></em>;</span></p></td>
831
<td> The reference count of this file info, which is one by default, and
832
that can be increased using <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-ref" title="gnome_vfs_file_info_ref ()"><code class="function">gnome_vfs_file_info_ref()</code></a> and decreased
833
using <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-unref" title="gnome_vfs_file_info_unref ()"><code class="function">gnome_vfs_file_info_unref()</code></a>. When it drops to zero, the file info
834
is freed and its memory is invalid. Make sure to keep your own
835
reference to a file info if you received it from GnomeVFS, i.e.
836
if you didn't call <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#gnome-vfs-file-info-new" title="gnome_vfs_file_info_new ()"><code class="function">gnome_vfs_file_info_new()</code></a> yourself.
837
</td>
838
</tr>
839
<tr>
840
<td><p><span class="term">GnomeVFSACL *<em class="structfield"><code><a name="GnomeVFSFileInfo.acl"></a>acl</code></em>;</span></p></td>
841
<td>
842
</td>
843
</tr>
844
<tr>
845
<td><p><span class="term">char *<em class="structfield"><code><a name="GnomeVFSFileInfo.selinux_context"></a>selinux_context</code></em>;</span></p></td>
846
<td>
847
</td>
848
</tr>
849
</tbody>
850
</table></div>
851
</div>
852
<hr>
853
<div class="refsect2" lang="en">
854
<a name="GNOME-VFS-FILE-INFO-SYMLINK:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SYMLINK()</h3>
855
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SYMLINK(info)</pre>
856
<p>
857
Determines whether a file is a symbolic link given <em class="parameter"><code>info</code></em>.</p>
858
<p>
859
</p>
860
<div class="variablelist"><table border="0">
861
<col align="left" valign="top">
862
<tbody><tr>
863
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
864
<td> GnomeVFSFileInfo struct
865
</td>
866
</tr></tbody>
867
</table></div>
868
</div>
869
<hr>
870
<div class="refsect2" lang="en">
871
<a name="GNOME-VFS-FILE-INFO-SET-SYMLINK:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_SYMLINK()</h3>
872
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_SYMLINK(info, value)</pre>
873
<p>
874
Set the symbolic link field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
875
<p>
876
</p>
877
<div class="variablelist"><table border="0">
878
<col align="left" valign="top">
879
<tbody>
880
<tr>
881
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
882
<td> GnomeVFSFileInfo struct
883
</td>
884
</tr>
885
<tr>
886
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
887
<td> if <code class="literal">TRUE</code>, <em class="parameter"><code>info</code></em> is set to indicate the file is a symbolic link
888
</td>
889
</tr>
890
</tbody>
891
</table></div>
892
</div>
893
<hr>
894
<div class="refsect2" lang="en">
895
<a name="GNOME-VFS-FILE-INFO-LOCAL:CAPS"></a><h3>GNOME_VFS_FILE_INFO_LOCAL()</h3>
896
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_LOCAL(info)</pre>
897
<p>
898
Determines whether a file is local given <em class="parameter"><code>info</code></em>.</p>
899
<p>
900
</p>
901
<div class="variablelist"><table border="0">
902
<col align="left" valign="top">
903
<tbody><tr>
904
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
905
<td> GnomeVFSFileInfo struct
906
</td>
907
</tr></tbody>
908
</table></div>
909
</div>
910
<hr>
911
<div class="refsect2" lang="en">
912
<a name="GNOME-VFS-FILE-INFO-SET-LOCAL:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_LOCAL()</h3>
913
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_LOCAL(info, value)</pre>
914
<p>
915
Set the "local file" field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
916
<p>
917
</p>
918
<div class="variablelist"><table border="0">
919
<col align="left" valign="top">
920
<tbody>
921
<tr>
922
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
923
<td> GnomeVFSFileInfo struct
924
</td>
925
</tr>
926
<tr>
927
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
928
<td> if <code class="literal">TRUE</code>, <em class="parameter"><code>info</code></em> is set to indicate the file is local
929
</td>
930
</tr>
931
</tbody>
932
</table></div>
933
</div>
934
<hr>
935
<div class="refsect2" lang="en">
936
<a name="GNOME-VFS-FILE-INFO-SUID:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SUID()</h3>
937
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SUID(info)</pre>
938
<p>
939
Determines whether a file belongs to the super user.</p>
940
<p>
941
</p>
942
<div class="variablelist"><table border="0">
943
<col align="left" valign="top">
944
<tbody><tr>
945
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
946
<td> GnomeVFSFileInfo struct
947
</td>
948
</tr></tbody>
949
</table></div>
950
</div>
951
<hr>
952
<div class="refsect2" lang="en">
953
<a name="GNOME-VFS-FILE-INFO-SGID:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SGID()</h3>
954
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SGID(info)</pre>
955
<p>
956
Determines whether a file belongs to the super user's group.</p>
957
<p>
958
</p>
959
<div class="variablelist"><table border="0">
960
<col align="left" valign="top">
961
<tbody><tr>
962
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
963
<td> GnomeVFSFileInfo struct
964
</td>
965
</tr></tbody>
966
</table></div>
967
</div>
968
<hr>
969
<div class="refsect2" lang="en">
970
<a name="GNOME-VFS-FILE-INFO-STICKY:CAPS"></a><h3>GNOME_VFS_FILE_INFO_STICKY()</h3>
971
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_STICKY(info)</pre>
972
<p>
973
Determines whether a file has the sticky bit set, given <em class="parameter"><code>info</code></em></p>
974
<p>
975
</p>
976
<div class="variablelist"><table border="0">
977
<col align="left" valign="top">
978
<tbody><tr>
979
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
980
<td> GnomeVFSFileInfo struct
981
</td>
982
</tr></tbody>
983
</table></div>
984
</div>
985
<hr>
986
<div class="refsect2" lang="en">
987
<a name="GNOME-VFS-FILE-INFO-SET-SUID:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_SUID()</h3>
988
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_SUID(info, value)</pre>
989
<p>
990
Set the SUID field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
991
<p>
992
</p>
993
<div class="variablelist"><table border="0">
994
<col align="left" valign="top">
995
<tbody>
996
<tr>
997
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
998
<td> GnomeVFSFileInfo struct
999
</td>
1000
</tr>
1001
<tr>
1002
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1003
<td> if <code class="literal">TRUE</code>, <em class="parameter"><code>info</code></em> is set to indicate the file belongs to the super user
1004
</td>
1005
</tr>
1006
</tbody>
1007
</table></div>
1008
</div>
1009
<hr>
1010
<div class="refsect2" lang="en">
1011
<a name="GNOME-VFS-FILE-INFO-SET-SGID:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_SGID()</h3>
1012
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_SGID(info, value)</pre>
1013
<p>
1014
Set the SGID field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
1015
<p>
1016
</p>
1017
<div class="variablelist"><table border="0">
1018
<col align="left" valign="top">
1019
<tbody>
1020
<tr>
1021
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1022
<td> GnomeVFSFileInfo struct
1023
</td>
1024
</tr>
1025
<tr>
1026
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1027
<td> if <code class="literal">TRUE</code>, <em class="parameter"><code>info</code></em> is set to indicate the file belongs to the super user's group
1028
</td>
1029
</tr>
1030
</tbody>
1031
</table></div>
1032
</div>
1033
<hr>
1034
<div class="refsect2" lang="en">
1035
<a name="GNOME-VFS-FILE-INFO-SET-STICKY:CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_STICKY()</h3>
1036
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_STICKY(info, value)</pre>
1037
<p>
1038
Set the sticky bit in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
1039
<p>
1040
</p>
1041
<div class="variablelist"><table border="0">
1042
<col align="left" valign="top">
1043
<tbody>
1044
<tr>
1045
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1046
<td> GnomeVFSFileInfo struct
1047
</td>
1048
</tr>
1049
<tr>
1050
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1051
<td> if <code class="literal">TRUE</code>, <em class="parameter"><code>info</code></em> is set to indicate the file has the sticky bit set
1052
</td>
1053
</tr>
1054
</tbody>
1055
</table></div>
1056
</div>
1057
<hr>
1058
<div class="refsect2" lang="en">
1059
<a name="gnome-vfs-file-info-new"></a><h3>gnome_vfs_file_info_new ()</h3>
1060
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * gnome_vfs_file_info_new (void);</pre>
1061
<p>
1062
Allocate and initialize a new <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct.</p>
1063
<p>
1064
</p>
1065
<div class="variablelist"><table border="0">
1066
<col align="left" valign="top">
1067
<tbody><tr>
1068
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1069
<td> a pointer to the newly allocated file information struct.
1070
</td>
1071
</tr></tbody>
1072
</table></div>
1073
</div>
1074
<hr>
1075
<div class="refsect2" lang="en">
1076
<a name="gnome-vfs-file-info-unref"></a><h3>gnome_vfs_file_info_unref ()</h3>
1077
<pre class="programlisting">void gnome_vfs_file_info_unref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1078
<p>
1079
Decreases the refcount of <em class="parameter"><code>info</code></em> by 1. Frees the struct <em class="parameter"><code>info</code></em> if refcount becomes 0.</p>
1080
<p>
1081
</p>
1082
<div class="variablelist"><table border="0">
1083
<col align="left" valign="top">
1084
<tbody><tr>
1085
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1086
<td> pointer to a file information struct.
1087
</td>
1088
</tr></tbody>
1089
</table></div>
1090
</div>
1091
<hr>
1092
<div class="refsect2" lang="en">
1093
<a name="gnome-vfs-file-info-ref"></a><h3>gnome_vfs_file_info_ref ()</h3>
1094
<pre class="programlisting">void gnome_vfs_file_info_ref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1095
<p>
1096
Increment refcount of <em class="parameter"><code>info</code></em> by 1.</p>
1097
<p>
1098
</p>
1099
<div class="variablelist"><table border="0">
1100
<col align="left" valign="top">
1101
<tbody><tr>
1102
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1103
<td> pointer to a file information struct.
1104
</td>
1105
</tr></tbody>
1106
</table></div>
1107
</div>
1108
<hr>
1109
<div class="refsect2" lang="en">
1110
<a name="gnome-vfs-file-info-clear"></a><h3>gnome_vfs_file_info_clear ()</h3>
1111
<pre class="programlisting">void gnome_vfs_file_info_clear (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1112
<p>
1113
Clear <em class="parameter"><code>info</code></em> so that it's ready to accept new data. This is
1114
supposed to be used when <em class="parameter"><code>info</code></em> already contains meaningful information which
1115
we want to replace.</p>
1116
<p>
1117
</p>
1118
<div class="variablelist"><table border="0">
1119
<col align="left" valign="top">
1120
<tbody><tr>
1121
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1122
<td> pointer to a file information struct.
1123
</td>
1124
</tr></tbody>
1125
</table></div>
1126
</div>
1127
<hr>
1128
<div class="refsect2" lang="en">
1129
<a name="gnome-vfs-file-info-get-mime-type"></a><h3>gnome_vfs_file_info_get_mime_type ()</h3>
1130
<pre class="programlisting">const char * gnome_vfs_file_info_get_mime_type (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1131
<p>
1132
Retrieve MIME type from <em class="parameter"><code>info</code></em>. There is no need to free the return
1133
value.</p>
1134
<p>
1135
</p>
1136
<div class="variablelist"><table border="0">
1137
<col align="left" valign="top">
1138
<tbody>
1139
<tr>
1140
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1141
<td> a pointer to a file information struct.
1142
</td>
1143
</tr>
1144
<tr>
1145
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1146
<td> a pointer to a string representing the MIME type.
1147
</td>
1148
</tr>
1149
</tbody>
1150
</table></div>
1151
</div>
1152
<hr>
1153
<div class="refsect2" lang="en">
1154
<a name="gnome-vfs-file-info-copy"></a><h3>gnome_vfs_file_info_copy ()</h3>
1155
<pre class="programlisting">void gnome_vfs_file_info_copy (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *dest,
1156
const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *src);</pre>
1157
<p>
1158
Copy information from <em class="parameter"><code>src</code></em> into <em class="parameter"><code>dest</code></em>.</p>
1159
<p>
1160
</p>
1161
<div class="variablelist"><table border="0">
1162
<col align="left" valign="top">
1163
<tbody>
1164
<tr>
1165
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1166
<td> pointer to a struct to copy <em class="parameter"><code>src</code></em>'s information into.
1167
</td>
1168
</tr>
1169
<tr>
1170
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
1171
<td> pointer to the information to be copied into <em class="parameter"><code>dest</code></em>.
1172
</td>
1173
</tr>
1174
</tbody>
1175
</table></div>
1176
</div>
1177
<hr>
1178
<div class="refsect2" lang="en">
1179
<a name="gnome-vfs-file-info-dup"></a><h3>gnome_vfs_file_info_dup ()</h3>
1180
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * gnome_vfs_file_info_dup (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *orig);</pre>
1181
<p>
1182
Duplicates <em class="parameter"><code>orig</code></em> and returns it.</p>
1183
<p>
1184
</p>
1185
<div class="variablelist"><table border="0">
1186
<col align="left" valign="top">
1187
<tbody>
1188
<tr>
1189
<td><p><span class="term"><em class="parameter"><code>orig</code></em> :</span></p></td>
1190
<td> pointer to a file information structure to duplicate.
1191
</td>
1192
</tr>
1193
<tr>
1194
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1195
<td> a new file information struct that duplicates the information in <em class="parameter"><code>orig</code></em>.
1196
</td>
1197
</tr>
1198
</tbody>
1199
</table></div>
1200
</div>
1201
<hr>
1202
<div class="refsect2" lang="en">
1203
<a name="gnome-vfs-file-info-matches"></a><h3>gnome_vfs_file_info_matches ()</h3>
1204
<pre class="programlisting">gboolean gnome_vfs_file_info_matches (const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *a,
1205
const <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *b);</pre>
1206
<p>
1207
Compare the two file info structs, return <code class="literal">TRUE</code> if they match exactly
1208
the same file data.</p>
1209
<p>
1210
</p>
1211
<div class="variablelist"><table border="0">
1212
<col align="left" valign="top">
1213
<tbody>
1214
<tr>
1215
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
1216
<td> first <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct to compare.
1217
</td>
1218
</tr>
1219
<tr>
1220
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
1221
<td> second <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct to compare.
1222
</td>
1223
</tr>
1224
<tr>
1225
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1226
<td> <code class="literal">TRUE</code> if the two <span class="type">GnomeVFSFileInfos</span> match, otherwise return <code class="literal">FALSE</code>.
1227
</td>
1228
</tr>
1229
</tbody>
1230
</table></div>
1231
</div>
1232
<hr>
1233
<div class="refsect2" lang="en">
1234
<a name="gnome-vfs-file-info-list-ref"></a><h3>gnome_vfs_file_info_list_ref ()</h3>
1235
<pre class="programlisting">GList * gnome_vfs_file_info_list_ref (GList *list);</pre>
1236
<p>
1237
Increments the refcount of the items in <em class="parameter"><code>list</code></em> by one.</p>
1238
<p>
1239
</p>
1240
<div class="variablelist"><table border="0">
1241
<col align="left" valign="top">
1242
<tbody>
1243
<tr>
1244
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1245
<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1246
</td>
1247
</tr>
1248
<tr>
1249
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1250
<td> <em class="parameter"><code>list</code></em>.
1251
</td>
1252
</tr>
1253
</tbody>
1254
</table></div>
1255
</div>
1256
<hr>
1257
<div class="refsect2" lang="en">
1258
<a name="gnome-vfs-file-info-list-unref"></a><h3>gnome_vfs_file_info_list_unref ()</h3>
1259
<pre class="programlisting">GList * gnome_vfs_file_info_list_unref (GList *list);</pre>
1260
<p>
1261
Decrements the refcount of the items in <em class="parameter"><code>list</code></em> by one.
1262
Note that the list is *not freed* even if each member of the list
1263
is freed.</p>
1264
<p>
1265
</p>
1266
<div class="variablelist"><table border="0">
1267
<col align="left" valign="top">
1268
<tbody>
1269
<tr>
1270
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1271
<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1272
</td>
1273
</tr>
1274
<tr>
1275
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1276
<td> <em class="parameter"><code>list</code></em>.
1277
</td>
1278
</tr>
1279
</tbody>
1280
</table></div>
1281
</div>
1282
<hr>
1283
<div class="refsect2" lang="en">
1284
<a name="gnome-vfs-file-info-list-copy"></a><h3>gnome_vfs_file_info_list_copy ()</h3>
1285
<pre class="programlisting">GList * gnome_vfs_file_info_list_copy (GList *list);</pre>
1286
<p>
1287
Creates a duplicate of <em class="parameter"><code>list</code></em>, and references each member of
1288
that list.</p>
1289
<p>
1290
</p>
1291
<div class="variablelist"><table border="0">
1292
<col align="left" valign="top">
1293
<tbody>
1294
<tr>
1295
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1296
<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1297
</td>
1298
</tr>
1299
<tr>
1300
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1301
<td> a newly referenced duplicate of <em class="parameter"><code>list</code></em>.
1302
</td>
1303
</tr>
1304
</tbody>
1305
</table></div>
1306
</div>
1307
<hr>
1308
<div class="refsect2" lang="en">
1309
<a name="gnome-vfs-file-info-list-free"></a><h3>gnome_vfs_file_info_list_free ()</h3>
1310
<pre class="programlisting">void gnome_vfs_file_info_list_free (GList *list);</pre>
1311
<p>
1312
Decrements the refcount of each member of <em class="parameter"><code>list</code></em> by one,
1313
and frees the list itself.</p>
1314
<p>
1315
</p>
1316
<div class="variablelist"><table border="0">
1317
<col align="left" valign="top">
1318
<tbody><tr>
1319
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1320
<td> list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1321
</td>
1322
</tr></tbody>
1323
</table></div>
1324
</div>
1325
<hr>
1326
<div class="refsect2" lang="en">
1327
<a name="gnome-vfs-get-file-info-result-dup"></a><h3>gnome_vfs_get_file_info_result_dup ()</h3>
1328
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a>* gnome_vfs_get_file_info_result_dup
1329
(<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a> *result);</pre>
1330
<p>
1331
Duplicate <em class="parameter"><code>result</code></em>.
1332
</p>
1333
<p>
1334
Note: The internal uri and fileinfo objects are not duplicated
1335
but their refcount is incremented by 1.</p>
1336
<p>
1337
</p>
1338
<div class="variablelist"><table border="0">
1339
<col align="left" valign="top">
1340
<tbody>
1341
<tr>
1342
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1343
<td> a <span class="type">GnomeVFSGetFileInfoResult.</span>
1344
</td>
1345
</tr>
1346
<tr>
1347
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1348
<td> a duplicated version of <em class="parameter"><code>result</code></em>.
1349
1350
</td>
1351
</tr>
1352
</tbody>
1353
</table></div>
1354
<p class="since">Since 2.12</p>
1355
</div>
1356
<hr>
1357
<div class="refsect2" lang="en">
1358
<a name="gnome-vfs-get-file-info-result-free"></a><h3>gnome_vfs_get_file_info_result_free ()</h3>
1359
<pre class="programlisting">void gnome_vfs_get_file_info_result_free (<a class="link" href="gnome-vfs-2.0-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a> *result);</pre>
1360
<p>
1361
Unrefs the internal uri and fileinfo objects and frees the
1362
memory allocated for <em class="parameter"><code>result</code></em>.</p>
1363
<p>
1364
</p>
1365
<div class="variablelist"><table border="0">
1366
<col align="left" valign="top">
1367
<tbody><tr>
1368
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1369
<td> a <span class="type">GnomeVFSGetFileInfoResult.</span>
1370
</td>
1371
</tr></tbody>
1372
</table></div>
1373
<p class="since">Since 2.12</p>
1374
</div>
1375
</div>
1376
</div>
1377
<div class="footer">
1378
<hr>
1379
Generated by GTK-Doc V1.12</div>
1380
</body>
1381
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1