~ubuntu-branches/ubuntu/natty/gnome-vfs/natty
» Revision
17
: doc/html/gnome-vfs-20-gnome-vfs-file-info.html
« back to all changes in this revision
Viewing changes to doc/html/gnome-vfs-20-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-20-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.73.2">
7
<link rel="start" 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-20-gnome-vfs-utils.html" title="gnome-vfs-utils">
10
<link rel="next" href="gnome-vfs-20-gnome-vfs-file-size.html" title="GnomeVFSFileSize">
11
<meta name="generator" content="GTK-Doc V1.11 (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-20-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-20-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-20-gnome-vfs-file-info.synopsis" class="shortcut">Top</a>
35
|
36
<a href="#gnome-vfs-20-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-20-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-20-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-20-gnome-vfs-file-info.synopsis"></a><h2>Synopsis</h2>
50
<pre class="synopsis">
51
enum <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileFlags" title="enum GnomeVFSFileFlags">GnomeVFSFileFlags</a>;
52
enum <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileType" title="enum GnomeVFSFileType">GnomeVFSFileType</a>;
53
enum <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoFields" title="enum GnomeVFSFileInfoFields">GnomeVFSFileInfoFields</a>;
54
enum <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions">GnomeVFSFilePermissions</a>;
55
enum <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoOptions" title="enum GnomeVFSFileInfoOptions">GnomeVFSFileInfoOptions</a>;
56
enum <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSSetFileInfoMask" title="enum GnomeVFSSetFileInfoMask">GnomeVFSSetFileInfoMask</a>;
57
<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a>;
58
typedef <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSInodeNumber" title="GnomeVFSInodeNumber">GnomeVFSInodeNumber</a>;
59
<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a>;
60
#define <a class="link" href="gnome-vfs-20-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-20-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-20-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-20-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-20-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-20-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-20-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-20-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-20-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-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * <a class="link" href="gnome-vfs-20-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-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
72
void <a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
73
void <a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
74
const char * <a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);
75
void <a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *dest,
76
const <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *src);
77
<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * <a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *orig);
78
gboolean <a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *a,
79
const <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *b);
80
GList * <a class="link" href="gnome-vfs-20-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-20-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-20-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-20-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-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a>* <a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a> *result);
86
void <a class="link" href="gnome-vfs-20-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-20-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-20-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-20-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-20-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-20-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-20-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-READ--CAPS"></a><span class="term"><code class="literal">GNOME_VFS_PERM_USER_READ</code></span></p></td>
389
<td> Owner has read permission.
390
</td>
391
</tr>
392
<tr>
393
<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>
394
<td> Owner has write permission.
395
</td>
396
</tr>
397
<tr>
398
<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>
399
<td> Owner has execution permission.
400
</td>
401
</tr>
402
<tr>
403
<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>
404
<td> Owner has all permissions.
405
</td>
406
</tr>
407
<tr>
408
<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>
409
<td> Group has read permission.
410
</td>
411
</tr>
412
<tr>
413
<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>
414
<td> Group has write permission.
415
</td>
416
</tr>
417
<tr>
418
<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>
419
<td> Group has execution permission.
420
</td>
421
</tr>
422
<tr>
423
<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>
424
<td> Group has all permissions.
425
</td>
426
</tr>
427
<tr>
428
<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>
429
<td> Others have read permission.
430
</td>
431
</tr>
432
<tr>
433
<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>
434
<td> Others have write permission.
435
</td>
436
</tr>
437
<tr>
438
<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>
439
<td> Others have execution permission.
440
</td>
441
</tr>
442
<tr>
443
<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>
444
<td> Others have all permissions.
445
</td>
446
</tr>
447
<tr>
448
<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>
449
<td> This file is readable for the current client.
450
</td>
451
</tr>
452
<tr>
453
<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>
454
<td> This file is writable for the current client.
455
</td>
456
</tr>
457
<tr>
458
<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>
459
<td> This file is executable for the current client.
460
</td>
461
</tr>
462
</tbody>
463
</table></div>
464
</div>
465
<hr>
466
<div class="refsect2" lang="en">
467
<a name="GnomeVFSFileInfoOptions"></a><h3>enum GnomeVFSFileInfoOptions</h3>
468
<pre class="programlisting">typedef enum {
469
GNOME_VFS_FILE_INFO_DEFAULT = 0,
470
GNOME_VFS_FILE_INFO_GET_MIME_TYPE = 1 << 0,
471
GNOME_VFS_FILE_INFO_FORCE_FAST_MIME_TYPE = 1 << 1,
472
GNOME_VFS_FILE_INFO_FORCE_SLOW_MIME_TYPE = 1 << 2,
473
GNOME_VFS_FILE_INFO_FOLLOW_LINKS = 1 << 3,
474
GNOME_VFS_FILE_INFO_GET_ACCESS_RIGHTS = 1 << 4,
475
GNOME_VFS_FILE_INFO_NAME_ONLY = 1 << 5,
476
GNOME_VFS_FILE_INFO_GET_ACL = 1 << 6,
477
GNOME_VFS_FILE_INFO_GET_SELINUX_CONTEXT = 1 << 7
478
} GnomeVFSFileInfoOptions;
479
</pre>
480
<p>
481
Packed boolean bitfield representing options that can
482
be passed into a <a class="link" href="gnome-vfs-20-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
483
related calls that return file info) and affect the operation
484
of get_file_info.</p>
485
<p>
486
</p>
487
<div class="variablelist"><table border="0">
488
<col align="left" valign="top">
489
<tbody>
490
<tr>
491
<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>
492
<td> default flags
493
</td>
494
</tr>
495
<tr>
496
<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>
497
<td> detect the MIME type
498
</td>
499
</tr>
500
<tr>
501
<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>
502
<td> only use fast MIME type
503
detection (extensions)
504
</td>
505
</tr>
506
<tr>
507
<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>
508
<td> force slow MIME type
509
detection where available (sniffing, algorithmic detection, etc)
510
</td>
511
</tr>
512
<tr>
513
<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>
514
<td> automatically follow symbolic
515
links and retrieve the properties of their target (recommended)
516
</td>
517
</tr>
518
<tr>
519
<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>
520
<td> tries to get data similar
521
to what would return access(2) on a local file system (ie is the
522
file readable, writable and/or executable). Can be really slow on
523
remote file systems
524
</td>
525
</tr>
526
<tr>
527
<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>
528
<td> When reading a directory, only
529
get the filename (if doing so is faster). Useful to e.g. count
530
the number of files.
531
</td>
532
</tr>
533
<tr>
534
<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>
535
<td> get ACLs for the file
536
</td>
537
</tr>
538
<tr>
539
<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>
540
<td>
541
</td>
542
</tr>
543
</tbody>
544
</table></div>
545
</div>
546
<hr>
547
<div class="refsect2" lang="en">
548
<a name="GnomeVFSSetFileInfoMask"></a><h3>enum GnomeVFSSetFileInfoMask</h3>
549
<pre class="programlisting">typedef enum {
550
GNOME_VFS_SET_FILE_INFO_NONE = 0,
551
GNOME_VFS_SET_FILE_INFO_NAME = 1 << 0,
552
GNOME_VFS_SET_FILE_INFO_PERMISSIONS = 1 << 1,
553
GNOME_VFS_SET_FILE_INFO_OWNER = 1 << 2,
554
GNOME_VFS_SET_FILE_INFO_TIME = 1 << 3,
555
GNOME_VFS_SET_FILE_INFO_ACL = 1 << 4,
556
GNOME_VFS_SET_FILE_INFO_SELINUX_CONTEXT = 1 << 5,
557
GNOME_VFS_SET_FILE_INFO_SYMLINK_NAME = 1 << 6
558
} GnomeVFSSetFileInfoMask;
559
</pre>
560
<p>
561
Packed boolean bitfield representing the aspects of the file
562
to be changed in a <a class="link" href="gnome-vfs-20-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>
563
<p>
564
</p>
565
<div class="variablelist"><table border="0">
566
<col align="left" valign="top">
567
<tbody>
568
<tr>
569
<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>
570
<td> don't set any file info fields
571
</td>
572
</tr>
573
<tr>
574
<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>
575
<td> change the name
576
</td>
577
</tr>
578
<tr>
579
<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>
580
<td> change the permissions
581
</td>
582
</tr>
583
<tr>
584
<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>
585
<td> change the file's owner
586
</td>
587
</tr>
588
<tr>
589
<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>
590
<td> change the file's time stamp(s)
591
</td>
592
</tr>
593
<tr>
594
<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>
595
<td> change the file's ACLs
596
</td>
597
</tr>
598
<tr>
599
<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>
600
<td>
601
</td>
602
</tr>
603
<tr>
604
<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>
605
<td> change the file's symlink name
606
</td>
607
</tr>
608
</tbody>
609
</table></div>
610
</div>
611
<hr>
612
<div class="refsect2" lang="en">
613
<a name="GnomeVFSGetFileInfoResult"></a><h3>GnomeVFSGetFileInfoResult</h3>
614
<pre class="programlisting">typedef struct {
615
GnomeVFSURI *uri;
616
GnomeVFSResult result;
617
GnomeVFSFileInfo *file_info;
618
} GnomeVFSGetFileInfoResult;
619
</pre>
620
<p>
621
This data structure encapsulates the details of an individual file
622
info request that was part of a mass file info request launched
623
through <a class="link" href="gnome-vfs-20-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
624
<a class="link" href="gnome-vfs-20-gnome-vfs-async-ops.html#GnomeVFSAsyncGetFileInfoCallback" title="GnomeVFSAsyncGetFileInfoCallback ()"><span class="type">GnomeVFSAsyncGetFileInfoCallback</span></a>.</p>
625
<p>
626
</p>
627
<div class="variablelist"><table border="0">
628
<col align="left" valign="top">
629
<tbody>
630
<tr>
631
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI">GnomeVFSURI</a> *<em class="structfield"><code>uri</code></em>;</span></p></td>
632
<td> The <a class="link" href="gnome-vfs-20-gnome-vfs-uri.html#GnomeVFSURI" title="GnomeVFSURI"><span class="type">GnomeVFSURI</span></a> the file info was requested for.
633
</td>
634
</tr>
635
<tr>
636
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult">GnomeVFSResult</a> <em class="structfield"><code>result</code></em>;</span></p></td>
637
<td> The <a class="link" href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult"><span class="type">GnomeVFSResult</span></a> of the file info request.
638
</td>
639
</tr>
640
<tr>
641
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *<em class="structfield"><code>file_info</code></em>;</span></p></td>
642
<td> The <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> that was retrieved.
643
</td>
644
</tr>
645
</tbody>
646
</table></div>
647
</div>
648
<hr>
649
<div class="refsect2" lang="en">
650
<a name="GnomeVFSInodeNumber"></a><h3>GnomeVFSInodeNumber</h3>
651
<pre class="programlisting">typedef GnomeVFSFileSize GnomeVFSInodeNumber;
652
</pre>
653
<p>
654
Represents the i-node of a file, this is a low level data structure
655
that the operating system uses to hold information about a file.</p>
656
<p>
657
</p>
658
</div>
659
<hr>
660
<div class="refsect2" lang="en">
661
<a name="GnomeVFSFileInfo"></a><h3>GnomeVFSFileInfo</h3>
662
<pre class="programlisting">typedef struct {
663
char *name;
664
665
GnomeVFSFileInfoFields valid_fields;
666
GnomeVFSFileType type;
667
GnomeVFSFilePermissions permissions;
668
669
GnomeVFSFileFlags flags;
670
671
dev_t device;
672
GnomeVFSInodeNumber inode;
673
674
guint link_count;
675
676
guint uid;
677
guint gid;
678
679
GnomeVFSFileSize size;
680
681
GnomeVFSFileSize block_count;
682
683
guint io_block_size;
684
685
time_t atime;
686
time_t mtime;
687
time_t ctime;
688
689
char *symlink_name;
690
691
char *mime_type;
692
693
guint refcount;
694
695
/* File ACLs */
696
GnomeVFSACL *acl;
697
698
/* SELinux security context. -- ascii string, raw format. */
699
char* selinux_context;
700
} GnomeVFSFileInfo;
701
</pre>
702
<p>
703
</p>
704
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
705
<h3 class="title">Note</h3>
706
When doing massive I/O, it is suggested to adhere <em class="parameter"><code>io_block_size</code></em> if applicable.
707
For network file systems, this may be set to very big values allowing
708
parallelization.
709
</div>
710
<p>
711
</p>
712
<p>
713
The GnomeVFSFileInfo structure contains information about a file.</p>
714
<p>
715
</p>
716
<div class="variablelist"><table border="0">
717
<col align="left" valign="top">
718
<tbody>
719
<tr>
720
<td><p><span class="term">char *<em class="structfield"><code>name</code></em>;</span></p></td>
721
<td> A char * specifying the base name of the file (without any path string).
722
</td>
723
</tr>
724
<tr>
725
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoFields" title="enum GnomeVFSFileInfoFields">GnomeVFSFileInfoFields</a> <em class="structfield"><code>valid_fields</code></em>;</span></p></td>
726
<td> <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfoFields" title="enum GnomeVFSFileInfoFields"><span class="type">GnomeVFSFileInfoFields</span></a> specifying which fields of
727
<a class="link" href="gnome-vfs-20-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
728
assumed to be valid, i.e. clients may assume that it is not NULL.
729
</td>
730
</tr>
731
<tr>
732
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileType" title="enum GnomeVFSFileType">GnomeVFSFileType</a> <em class="structfield"><code>type</code></em>;</span></p></td>
733
<td> The <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileType" title="enum GnomeVFSFileType"><span class="type">GnomeVFSFileType</span></a> of the file (i.e. regular, directory, block device, ...)
734
if <em class="parameter"><code>valid_fields</code></em> provides GNOME_VFS_FILE_INFO_FIELDS_TYPE.
735
</td>
736
</tr>
737
<tr>
738
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions">GnomeVFSFilePermissions</a> <em class="structfield"><code>permissions</code></em>;</span></p></td>
739
<td> The <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions"><span class="type">GnomeVFSFilePermissions</span></a> corresponding to the UNIX-like
740
permissions of the file, if <em class="parameter"><code>valid_fields</code></em> provides
741
<a class="link" href="gnome-vfs-20-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
742
<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFilePermissions" title="enum GnomeVFSFilePermissions"><span class="type">GnomeVFSFilePermissions</span></a> corresponding to abstract access
743
concepts (<a class="link" href="gnome-vfs-20-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-20-gnome-vfs-file-info.html#GNOME-VFS-PERM-ACCESS-WRITABLE--CAPS"><span class="type">GNOME_VFS_PERM_ACCESS_WRITABLE</span></a>,
744
and <a class="link" href="gnome-vfs-20-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>
745
provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-PERMISSIONS--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_PERMISSIONS</span></a>.
746
</td>
747
</tr>
748
<tr>
749
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileFlags" title="enum GnomeVFSFileFlags">GnomeVFSFileFlags</a> <em class="structfield"><code>flags</code></em>;</span></p></td>
750
<td> <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileFlags" title="enum GnomeVFSFileFlags"><span class="type">GnomeVFSFileFlags</span></a> providing additional information about the file,
751
for instance whether it is local or a symbolic link, if
752
<em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-FLAGS--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_FLAGS</span></a>.
753
</td>
754
</tr>
755
<tr>
756
<td><p><span class="term">dev_t <em class="structfield"><code>device</code></em>;</span></p></td>
757
<td> Identifies the device the file is located on, if
758
<em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-DEVICE--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_DEVICE</span></a>.
759
</td>
760
</tr>
761
<tr>
762
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSInodeNumber" title="GnomeVFSInodeNumber">GnomeVFSInodeNumber</a> <em class="structfield"><code>inode</code></em>;</span></p></td>
763
<td> Identifies the inode corresponding to the file, if
764
<em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-INODE--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_INODE</span></a>.
765
</td>
766
</tr>
767
<tr>
768
<td><p><span class="term">guint <em class="structfield"><code>link_count</code></em>;</span></p></td>
769
<td> Counts the number of hard links to the file, if
770
<em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-LINK-COUNT--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_LINK_COUNT</span></a>.
771
</td>
772
</tr>
773
<tr>
774
<td><p><span class="term">guint <em class="structfield"><code>uid</code></em>;</span></p></td>
775
<td> The user owning the file, if <em class="parameter"><code>valid_fields</code></em> provides
776
GNOME_VFS_FILE_INFO_FIELDS_IDS.
777
</td>
778
</tr>
779
<tr>
780
<td><p><span class="term">guint <em class="structfield"><code>gid</code></em>;</span></p></td>
781
<td> The user owning the file, if <em class="parameter"><code>valid_fields</code></em> provides
782
GNOME_VFS_FILE_INFO_FIELDS_IDS.
783
</td>
784
</tr>
785
<tr>
786
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize">GnomeVFSFileSize</a> <em class="structfield"><code>size</code></em>;</span></p></td>
787
<td> The size of the file in bytes (a <a class="link" href="gnome-vfs-20-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize"><span class="type">GnomeVFSFileSize</span></a>),
788
if <em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-SIZE--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_SIZE</span></a>.
789
</td>
790
</tr>
791
<tr>
792
<td><p><span class="term"><a class="link" href="gnome-vfs-20-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize">GnomeVFSFileSize</a> <em class="structfield"><code>block_count</code></em>;</span></p></td>
793
<td> The size of the file in file system blocks (a <a class="link" href="gnome-vfs-20-gnome-vfs-file-size.html#GnomeVFSFileSize" title="GnomeVFSFileSize"><span class="type">GnomeVFSFileSize</span></a>),
794
if <em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-BLOCK-COUNT--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_BLOCK_COUNT</span></a>.
795
</td>
796
</tr>
797
<tr>
798
<td><p><span class="term">guint <em class="structfield"><code>io_block_size</code></em>;</span></p></td>
799
<td> The optimal buffer size for reading/writing the file, if
800
<em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-IO-BLOCK-SIZE--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_IO_BLOCK_SIZE</span></a>.
801
</td>
802
</tr>
803
<tr>
804
<td><p><span class="term">time_t <em class="structfield"><code>atime</code></em>;</span></p></td>
805
<td> The time of the last file access, if <em class="parameter"><code>valid_fields</code></em> provides
806
<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-ATIME--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_ATIME</span></a>.
807
</td>
808
</tr>
809
<tr>
810
<td><p><span class="term">time_t <em class="structfield"><code>mtime</code></em>;</span></p></td>
811
<td> The time of the last file contents modification, if <em class="parameter"><code>valid_fields</code></em>
812
provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-MTIME--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_MTIME</span></a>.
813
</td>
814
</tr>
815
<tr>
816
<td><p><span class="term">time_t <em class="structfield"><code>ctime</code></em>;</span></p></td>
817
<td> The time of the last inode change, if <em class="parameter"><code>valid_fields</code></em> provides
818
<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-CTIME--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_CTIME</span></a>.
819
</td>
820
</tr>
821
<tr>
822
<td><p><span class="term">char *<em class="structfield"><code>symlink_name</code></em>;</span></p></td>
823
<td> This is the name of the file this link points to, <em class="parameter"><code>type</code></em>
824
is <a class="link" href="gnome-vfs-20-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>
825
provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-SYMLINK-NAME--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_SYMLINK_NAME</span></a>.
826
</td>
827
</tr>
828
<tr>
829
<td><p><span class="term">char *<em class="structfield"><code>mime_type</code></em>;</span></p></td>
830
<td> This is a char * identifying the type of the file, if
831
<em class="parameter"><code>valid_fields</code></em> provides <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GNOME-VFS-FILE-INFO-FIELDS-MIME-TYPE--CAPS"><span class="type">GNOME_VFS_FILE_INFO_FIELDS_MIME_TYPE</span></a>.
832
</td>
833
</tr>
834
<tr>
835
<td><p><span class="term">guint <em class="structfield"><code>refcount</code></em>;</span></p></td>
836
<td> The reference count of this file info, which is one by default, and
837
that can be increased using <a class="link" href="gnome-vfs-20-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
838
using <a class="link" href="gnome-vfs-20-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
839
is freed and its memory is invalid. Make sure to keep your own
840
reference to a file info if you received it from GnomeVFS, i.e.
841
if you didn't call <a class="link" href="gnome-vfs-20-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.
842
</td>
843
</tr>
844
<tr>
845
<td><p><span class="term">GnomeVFSACL *<em class="structfield"><code>acl</code></em>;</span></p></td>
846
<td>
847
</td>
848
</tr>
849
<tr>
850
<td><p><span class="term">char *<em class="structfield"><code>selinux_context</code></em>;</span></p></td>
851
<td>
852
</td>
853
</tr>
854
</tbody>
855
</table></div>
856
</div>
857
<hr>
858
<div class="refsect2" lang="en">
859
<a name="GNOME-VFS-FILE-INFO-SYMLINK--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SYMLINK()</h3>
860
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SYMLINK(info)</pre>
861
<p>
862
Determines whether a file is a symbolic link given <em class="parameter"><code>info</code></em>.</p>
863
<p>
864
</p>
865
<div class="variablelist"><table border="0">
866
<col align="left" valign="top">
867
<tbody><tr>
868
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
869
<td> GnomeVFSFileInfo struct
870
</td>
871
</tr></tbody>
872
</table></div>
873
</div>
874
<hr>
875
<div class="refsect2" lang="en">
876
<a name="GNOME-VFS-FILE-INFO-SET-SYMLINK--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_SYMLINK()</h3>
877
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_SYMLINK(info, value)</pre>
878
<p>
879
Set the symbolic link field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
880
<p>
881
</p>
882
<div class="variablelist"><table border="0">
883
<col align="left" valign="top">
884
<tbody>
885
<tr>
886
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
887
<td> GnomeVFSFileInfo struct
888
</td>
889
</tr>
890
<tr>
891
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
892
<td> if <code class="literal">TRUE</code>, <em class="parameter"><code>info</code></em> is set to indicate the file is a symbolic link
893
</td>
894
</tr>
895
</tbody>
896
</table></div>
897
</div>
898
<hr>
899
<div class="refsect2" lang="en">
900
<a name="GNOME-VFS-FILE-INFO-LOCAL--CAPS"></a><h3>GNOME_VFS_FILE_INFO_LOCAL()</h3>
901
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_LOCAL(info)</pre>
902
<p>
903
Determines whether a file is local given <em class="parameter"><code>info</code></em>.</p>
904
<p>
905
</p>
906
<div class="variablelist"><table border="0">
907
<col align="left" valign="top">
908
<tbody><tr>
909
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
910
<td> GnomeVFSFileInfo struct
911
</td>
912
</tr></tbody>
913
</table></div>
914
</div>
915
<hr>
916
<div class="refsect2" lang="en">
917
<a name="GNOME-VFS-FILE-INFO-SET-LOCAL--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_LOCAL()</h3>
918
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_LOCAL(info, value)</pre>
919
<p>
920
Set the "local file" field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
921
<p>
922
</p>
923
<div class="variablelist"><table border="0">
924
<col align="left" valign="top">
925
<tbody>
926
<tr>
927
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
928
<td> GnomeVFSFileInfo struct
929
</td>
930
</tr>
931
<tr>
932
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
933
<td> if <code class="literal">TRUE</code>, <em class="parameter"><code>info</code></em> is set to indicate the file is local
934
</td>
935
</tr>
936
</tbody>
937
</table></div>
938
</div>
939
<hr>
940
<div class="refsect2" lang="en">
941
<a name="GNOME-VFS-FILE-INFO-SUID--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SUID()</h3>
942
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SUID(info)</pre>
943
<p>
944
Determines whether a file belongs to the super user.</p>
945
<p>
946
</p>
947
<div class="variablelist"><table border="0">
948
<col align="left" valign="top">
949
<tbody><tr>
950
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
951
<td> GnomeVFSFileInfo struct
952
</td>
953
</tr></tbody>
954
</table></div>
955
</div>
956
<hr>
957
<div class="refsect2" lang="en">
958
<a name="GNOME-VFS-FILE-INFO-SGID--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SGID()</h3>
959
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SGID(info)</pre>
960
<p>
961
Determines whether a file belongs to the super user's group.</p>
962
<p>
963
</p>
964
<div class="variablelist"><table border="0">
965
<col align="left" valign="top">
966
<tbody><tr>
967
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
968
<td> GnomeVFSFileInfo struct
969
</td>
970
</tr></tbody>
971
</table></div>
972
</div>
973
<hr>
974
<div class="refsect2" lang="en">
975
<a name="GNOME-VFS-FILE-INFO-STICKY--CAPS"></a><h3>GNOME_VFS_FILE_INFO_STICKY()</h3>
976
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_STICKY(info)</pre>
977
<p>
978
Determines whether a file has the sticky bit set, given <em class="parameter"><code>info</code></em></p>
979
<p>
980
</p>
981
<div class="variablelist"><table border="0">
982
<col align="left" valign="top">
983
<tbody><tr>
984
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
985
<td> GnomeVFSFileInfo struct
986
</td>
987
</tr></tbody>
988
</table></div>
989
</div>
990
<hr>
991
<div class="refsect2" lang="en">
992
<a name="GNOME-VFS-FILE-INFO-SET-SUID--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_SUID()</h3>
993
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_SUID(info, value)</pre>
994
<p>
995
Set the SUID field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
996
<p>
997
</p>
998
<div class="variablelist"><table border="0">
999
<col align="left" valign="top">
1000
<tbody>
1001
<tr>
1002
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1003
<td> GnomeVFSFileInfo struct
1004
</td>
1005
</tr>
1006
<tr>
1007
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1008
<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
1009
</td>
1010
</tr>
1011
</tbody>
1012
</table></div>
1013
</div>
1014
<hr>
1015
<div class="refsect2" lang="en">
1016
<a name="GNOME-VFS-FILE-INFO-SET-SGID--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_SGID()</h3>
1017
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_SGID(info, value)</pre>
1018
<p>
1019
Set the SGID field in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
1020
<p>
1021
</p>
1022
<div class="variablelist"><table border="0">
1023
<col align="left" valign="top">
1024
<tbody>
1025
<tr>
1026
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1027
<td> GnomeVFSFileInfo struct
1028
</td>
1029
</tr>
1030
<tr>
1031
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1032
<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
1033
</td>
1034
</tr>
1035
</tbody>
1036
</table></div>
1037
</div>
1038
<hr>
1039
<div class="refsect2" lang="en">
1040
<a name="GNOME-VFS-FILE-INFO-SET-STICKY--CAPS"></a><h3>GNOME_VFS_FILE_INFO_SET_STICKY()</h3>
1041
<pre class="programlisting">#define GNOME_VFS_FILE_INFO_SET_STICKY(info, value)</pre>
1042
<p>
1043
Set the sticky bit in <em class="parameter"><code>info</code></em> to <em class="parameter"><code>value</code></em>.</p>
1044
<p>
1045
</p>
1046
<div class="variablelist"><table border="0">
1047
<col align="left" valign="top">
1048
<tbody>
1049
<tr>
1050
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1051
<td> GnomeVFSFileInfo struct
1052
</td>
1053
</tr>
1054
<tr>
1055
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
1056
<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
1057
</td>
1058
</tr>
1059
</tbody>
1060
</table></div>
1061
</div>
1062
<hr>
1063
<div class="refsect2" lang="en">
1064
<a name="gnome-vfs-file-info-new"></a><h3>gnome_vfs_file_info_new ()</h3>
1065
<pre class="programlisting"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * gnome_vfs_file_info_new (void);</pre>
1066
<p>
1067
Allocate and initialize a new <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct.</p>
1068
<p>
1069
</p>
1070
<div class="variablelist"><table border="0">
1071
<col align="left" valign="top">
1072
<tbody><tr>
1073
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1074
<td> a pointer to the newly allocated file information struct.
1075
</td>
1076
</tr></tbody>
1077
</table></div>
1078
</div>
1079
<hr>
1080
<div class="refsect2" lang="en">
1081
<a name="gnome-vfs-file-info-unref"></a><h3>gnome_vfs_file_info_unref ()</h3>
1082
<pre class="programlisting">void gnome_vfs_file_info_unref (<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1083
<p>
1084
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>
1085
<p>
1086
</p>
1087
<div class="variablelist"><table border="0">
1088
<col align="left" valign="top">
1089
<tbody><tr>
1090
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1091
<td> pointer to a file information struct.
1092
</td>
1093
</tr></tbody>
1094
</table></div>
1095
</div>
1096
<hr>
1097
<div class="refsect2" lang="en">
1098
<a name="gnome-vfs-file-info-ref"></a><h3>gnome_vfs_file_info_ref ()</h3>
1099
<pre class="programlisting">void gnome_vfs_file_info_ref (<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1100
<p>
1101
Increment refcount of <em class="parameter"><code>info</code></em> by 1.</p>
1102
<p>
1103
</p>
1104
<div class="variablelist"><table border="0">
1105
<col align="left" valign="top">
1106
<tbody><tr>
1107
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1108
<td> pointer to a file information struct.
1109
</td>
1110
</tr></tbody>
1111
</table></div>
1112
</div>
1113
<hr>
1114
<div class="refsect2" lang="en">
1115
<a name="gnome-vfs-file-info-clear"></a><h3>gnome_vfs_file_info_clear ()</h3>
1116
<pre class="programlisting">void gnome_vfs_file_info_clear (<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1117
<p>
1118
Clear <em class="parameter"><code>info</code></em> so that it's ready to accept new data. This is
1119
supposed to be used when <em class="parameter"><code>info</code></em> already contains meaningful information which
1120
we want to replace.</p>
1121
<p>
1122
</p>
1123
<div class="variablelist"><table border="0">
1124
<col align="left" valign="top">
1125
<tbody><tr>
1126
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1127
<td> pointer to a file information struct.
1128
</td>
1129
</tr></tbody>
1130
</table></div>
1131
</div>
1132
<hr>
1133
<div class="refsect2" lang="en">
1134
<a name="gnome-vfs-file-info-get-mime-type"></a><h3>gnome_vfs_file_info_get_mime_type ()</h3>
1135
<pre class="programlisting">const char * gnome_vfs_file_info_get_mime_type (<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *info);</pre>
1136
<p>
1137
Retrieve MIME type from <em class="parameter"><code>info</code></em>. There is no need to free the return
1138
value.</p>
1139
<p>
1140
</p>
1141
<div class="variablelist"><table border="0">
1142
<col align="left" valign="top">
1143
<tbody>
1144
<tr>
1145
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
1146
<td> a pointer to a file information struct.
1147
</td>
1148
</tr>
1149
<tr>
1150
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1151
<td> a pointer to a string representing the MIME type.
1152
</td>
1153
</tr>
1154
</tbody>
1155
</table></div>
1156
</div>
1157
<hr>
1158
<div class="refsect2" lang="en">
1159
<a name="gnome-vfs-file-info-copy"></a><h3>gnome_vfs_file_info_copy ()</h3>
1160
<pre class="programlisting">void gnome_vfs_file_info_copy (<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *dest,
1161
const <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *src);</pre>
1162
<p>
1163
Copy information from <em class="parameter"><code>src</code></em> into <em class="parameter"><code>dest</code></em>.</p>
1164
<p>
1165
</p>
1166
<div class="variablelist"><table border="0">
1167
<col align="left" valign="top">
1168
<tbody>
1169
<tr>
1170
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1171
<td> pointer to a struct to copy <em class="parameter"><code>src</code></em>'s information into.
1172
</td>
1173
</tr>
1174
<tr>
1175
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
1176
<td> pointer to the information to be copied into <em class="parameter"><code>dest</code></em>.
1177
</td>
1178
</tr>
1179
</tbody>
1180
</table></div>
1181
</div>
1182
<hr>
1183
<div class="refsect2" lang="en">
1184
<a name="gnome-vfs-file-info-dup"></a><h3>gnome_vfs_file_info_dup ()</h3>
1185
<pre class="programlisting"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> * gnome_vfs_file_info_dup (const <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *orig);</pre>
1186
<p>
1187
Duplicates <em class="parameter"><code>orig</code></em> and returns it.</p>
1188
<p>
1189
</p>
1190
<div class="variablelist"><table border="0">
1191
<col align="left" valign="top">
1192
<tbody>
1193
<tr>
1194
<td><p><span class="term"><em class="parameter"><code>orig</code></em> :</span></p></td>
1195
<td> pointer to a file information structure to duplicate.
1196
</td>
1197
</tr>
1198
<tr>
1199
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1200
<td> a new file information struct that duplicates the information in <em class="parameter"><code>orig</code></em>.
1201
</td>
1202
</tr>
1203
</tbody>
1204
</table></div>
1205
</div>
1206
<hr>
1207
<div class="refsect2" lang="en">
1208
<a name="gnome-vfs-file-info-matches"></a><h3>gnome_vfs_file_info_matches ()</h3>
1209
<pre class="programlisting">gboolean gnome_vfs_file_info_matches (const <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *a,
1210
const <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo">GnomeVFSFileInfo</a> *b);</pre>
1211
<p>
1212
Compare the two file info structs, return <code class="literal">TRUE</code> if they match exactly
1213
the same file data.</p>
1214
<p>
1215
</p>
1216
<div class="variablelist"><table border="0">
1217
<col align="left" valign="top">
1218
<tbody>
1219
<tr>
1220
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
1221
<td> first <a class="link" href="gnome-vfs-20-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"><em class="parameter"><code>b</code></em> :</span></p></td>
1226
<td> second <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> struct to compare.
1227
</td>
1228
</tr>
1229
<tr>
1230
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1231
<td> <code class="literal">TRUE</code> if the two <span class="type">GnomeVFSFileInfos</span> match, otherwise return <code class="literal">FALSE</code>.
1232
</td>
1233
</tr>
1234
</tbody>
1235
</table></div>
1236
</div>
1237
<hr>
1238
<div class="refsect2" lang="en">
1239
<a name="gnome-vfs-file-info-list-ref"></a><h3>gnome_vfs_file_info_list_ref ()</h3>
1240
<pre class="programlisting">GList * gnome_vfs_file_info_list_ref (GList *list);</pre>
1241
<p>
1242
Increments the refcount of the items in <em class="parameter"><code>list</code></em> by one.</p>
1243
<p>
1244
</p>
1245
<div class="variablelist"><table border="0">
1246
<col align="left" valign="top">
1247
<tbody>
1248
<tr>
1249
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1250
<td> list of <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1251
</td>
1252
</tr>
1253
<tr>
1254
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1255
<td> <em class="parameter"><code>list</code></em>.
1256
</td>
1257
</tr>
1258
</tbody>
1259
</table></div>
1260
</div>
1261
<hr>
1262
<div class="refsect2" lang="en">
1263
<a name="gnome-vfs-file-info-list-unref"></a><h3>gnome_vfs_file_info_list_unref ()</h3>
1264
<pre class="programlisting">GList * gnome_vfs_file_info_list_unref (GList *list);</pre>
1265
<p>
1266
Decrements the refcount of the items in <em class="parameter"><code>list</code></em> by one.
1267
Note that the list is *not freed* even if each member of the list
1268
is freed.</p>
1269
<p>
1270
</p>
1271
<div class="variablelist"><table border="0">
1272
<col align="left" valign="top">
1273
<tbody>
1274
<tr>
1275
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1276
<td> list of <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1277
</td>
1278
</tr>
1279
<tr>
1280
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1281
<td> <em class="parameter"><code>list</code></em>.
1282
</td>
1283
</tr>
1284
</tbody>
1285
</table></div>
1286
</div>
1287
<hr>
1288
<div class="refsect2" lang="en">
1289
<a name="gnome-vfs-file-info-list-copy"></a><h3>gnome_vfs_file_info_list_copy ()</h3>
1290
<pre class="programlisting">GList * gnome_vfs_file_info_list_copy (GList *list);</pre>
1291
<p>
1292
Creates a duplicate of <em class="parameter"><code>list</code></em>, and references each member of
1293
that list.</p>
1294
<p>
1295
</p>
1296
<div class="variablelist"><table border="0">
1297
<col align="left" valign="top">
1298
<tbody>
1299
<tr>
1300
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1301
<td> list of <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1302
</td>
1303
</tr>
1304
<tr>
1305
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1306
<td> a newly referenced duplicate of <em class="parameter"><code>list</code></em>.
1307
</td>
1308
</tr>
1309
</tbody>
1310
</table></div>
1311
</div>
1312
<hr>
1313
<div class="refsect2" lang="en">
1314
<a name="gnome-vfs-file-info-list-free"></a><h3>gnome_vfs_file_info_list_free ()</h3>
1315
<pre class="programlisting">void gnome_vfs_file_info_list_free (GList *list);</pre>
1316
<p>
1317
Decrements the refcount of each member of <em class="parameter"><code>list</code></em> by one,
1318
and frees the list itself.</p>
1319
<p>
1320
</p>
1321
<div class="variablelist"><table border="0">
1322
<col align="left" valign="top">
1323
<tbody><tr>
1324
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
1325
<td> list of <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSFileInfo" title="GnomeVFSFileInfo"><span class="type">GnomeVFSFileInfo</span></a> elements.
1326
</td>
1327
</tr></tbody>
1328
</table></div>
1329
</div>
1330
<hr>
1331
<div class="refsect2" lang="en">
1332
<a name="gnome-vfs-get-file-info-result-dup"></a><h3>gnome_vfs_get_file_info_result_dup ()</h3>
1333
<pre class="programlisting"><a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a>* gnome_vfs_get_file_info_result_dup
1334
(<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a> *result);</pre>
1335
<p>
1336
Duplicate <em class="parameter"><code>result</code></em>.
1337
</p>
1338
<p>
1339
Note: The internal uri and fileinfo objects are not duplicated
1340
but their refcount is incremented by 1.</p>
1341
<p>
1342
</p>
1343
<div class="variablelist"><table border="0">
1344
<col align="left" valign="top">
1345
<tbody>
1346
<tr>
1347
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1348
<td> a <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult"><span class="type">GnomeVFSGetFileInfoResult</span></a>.
1349
</td>
1350
</tr>
1351
<tr>
1352
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1353
<td> a duplicated version of <em class="parameter"><code>result</code></em>.
1354
1355
</td>
1356
</tr>
1357
</tbody>
1358
</table></div>
1359
<p class="since">Since 2.12</p>
1360
</div>
1361
<hr>
1362
<div class="refsect2" lang="en">
1363
<a name="gnome-vfs-get-file-info-result-free"></a><h3>gnome_vfs_get_file_info_result_free ()</h3>
1364
<pre class="programlisting">void gnome_vfs_get_file_info_result_free (<a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult">GnomeVFSGetFileInfoResult</a> *result);</pre>
1365
<p>
1366
Unrefs the internal uri and fileinfo objects and frees the
1367
memory allocated for <em class="parameter"><code>result</code></em>.</p>
1368
<p>
1369
</p>
1370
<div class="variablelist"><table border="0">
1371
<col align="left" valign="top">
1372
<tbody><tr>
1373
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1374
<td> a <a class="link" href="gnome-vfs-20-gnome-vfs-file-info.html#GnomeVFSGetFileInfoResult" title="GnomeVFSGetFileInfoResult"><span class="type">GnomeVFSGetFileInfoResult</span></a>.
1375
</td>
1376
</tr></tbody>
1377
</table></div>
1378
<p class="since">Since 2.12</p>
1379
</div>
1380
</div>
1381
</div>
1382
<div class="footer">
1383
<hr>
1384
Generated by GTK-Doc V1.11</div>
1385
</body>
1386
</html>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1