← Back to branch summary

~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

Viewing changes to docs/reference/gio/xml/gfileattribute.xml

  • Committer: Bazaar Package Importer
  • Author(s): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gio/xml/gfileattribute.xml
5
5
]>
6
6
<refentry id="gio-GFileAttribute">
7
7
<refmeta>
8
 
<refentrytitle role="top_of_page">GFileAttribute</refentrytitle>
 
8
<refentrytitle role="top_of_page" id="gio-GFileAttribute.top_of_page">GFileAttribute</refentrytitle>
9
9
<manvolnum>3</manvolnum>
10
10
<refmiscinfo>GIO Library</refmiscinfo>
11
11
</refmeta>
13
13
<refnamediv>
14
14
<refname>GFileAttribute</refname>
15
15
<refpurpose>Key-Value Paired File Attributes</refpurpose>
16
 
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
17
16
</refnamediv>
18
17
 
19
 
<refsynopsisdiv role="synopsis">
 
18
<refsynopsisdiv id="gio-GFileAttribute.synopsis" role="synopsis">
20
19
<title role="synopsis.title">Synopsis</title>
21
20
 
22
21
<synopsis>
23
22
 
24
23
#include &lt;gio/gio.h&gt;
25
24
 
26
 
 
27
25
enum                <link linkend="GFileAttributeType">GFileAttributeType</link>;
28
26
enum                <link linkend="GFileAttributeInfoFlags">GFileAttributeInfoFlags</link>;
29
27
enum                <link linkend="GFileAttributeStatus">GFileAttributeStatus</link>;
30
28
                    <link linkend="GFileAttributeInfo">GFileAttributeInfo</link>;
31
29
                    <link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link>;
32
 
<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link>* <link linkend="g-file-attribute-info-list-new">g_file_attribute_info_list_new</link>  (void);
33
 
<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link>* <link linkend="g-file-attribute-info-list-ref">g_file_attribute_info_list_ref</link>  (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);
 
30
<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> * <link linkend="g-file-attribute-info-list-new">g_file_attribute_info_list_new</link> (void);
 
31
<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> * <link linkend="g-file-attribute-info-list-ref">g_file_attribute_info_list_ref</link> (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);
34
32
<link linkend="void">void</link>                <link linkend="g-file-attribute-info-list-unref">g_file_attribute_info_list_unref</link>    (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);
35
 
<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link>* <link linkend="g-file-attribute-info-list-dup">g_file_attribute_info_list_dup</link>  (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);
36
 
const <link linkend="GFileAttributeInfo">GFileAttributeInfo</link>* <link linkend="g-file-attribute-info-list-lookup">g_file_attribute_info_list_lookup</link>
 
33
<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> * <link linkend="g-file-attribute-info-list-dup">g_file_attribute_info_list_dup</link> (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);
 
34
const <link linkend="GFileAttributeInfo">GFileAttributeInfo</link> * <link linkend="g-file-attribute-info-list-lookup">g_file_attribute_info_list_lookup</link>
37
35
                                                        (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list,
38
36
                                                         const <link linkend="char">char</link> *name);
39
37
<link linkend="void">void</link>                <link linkend="g-file-attribute-info-list-add">g_file_attribute_info_list_add</link>      (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list,
51
49
 
52
50
 
53
51
 
54
 
<refsect1 role="desc">
 
52
<refsect1 id="gio-GFileAttribute.description" role="desc">
55
53
<title role="desc.title">Description</title>
56
54
<para>
57
55
File attributes in GIO consist of a list of key-value pairs. 
67
65
Values are stored within the list in <link linkend="GFileAttributeValue"><type>GFileAttributeValue</type></link> structures.
68
66
Values can store different types, listed in the enum <link linkend="GFileAttributeType"><type>GFileAttributeType</type></link>.
69
67
Upon creation of a <link linkend="GFileAttributeValue"><type>GFileAttributeValue</type></link>, the type will be set to 
70
 
<link linkend="G-FILE-ATTRIBUTE-TYPE-INVALID:CAPS"><literal>G_FILE_ATTRIBUTE_TYPE_INVALID</literal></link>. 
 
68
<link linkend="G-FILE-ATTRIBUTE-TYPE-INVALID--CAPS"><literal>G_FILE_ATTRIBUTE_TYPE_INVALID</literal></link>. 
71
69
</para>
72
70
<para>
73
71
The list of possible attributes for a filesystem (pointed to by a <link linkend="GFile"><type>GFile</type></link>) is
100
98
<row><entry>"access"</entry><entry>The "Access" namespace. Used to check
101
99
if a user has the proper privilidges to access files and perform
102
100
file operations. Keys in this namespace are made to be generic 
103
 
and easily understood, e.g. the "can_read" key is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if 
 
101
and easily understood, e.g. the "can_read" key is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if 
104
102
the current user has permission to read the file. UNIX permissions and
105
103
NTFS ACLs in Windows should be mapped to these values.</entry></row>
106
104
<row><entry>"mountable"</entry><entry>The "Mountable" namespace. Includes 
107
105
simple boolean keys for checking if a file or path supports mount operations, e.g.
108
 
mount, unmount, eject. These are used for files of type <link linkend="G-FILE-TYPE-MOUNTABLE:CAPS"><literal>G_FILE_TYPE_MOUNTABLE</literal></link>.</entry></row>
 
106
mount, unmount, eject. These are used for files of type <link linkend="G-FILE-TYPE-MOUNTABLE--CAPS"><literal>G_FILE_TYPE_MOUNTABLE</literal></link>.</entry></row>
109
107
<row><entry>"time"</entry><entry>The "Time" namespace. Includes file 
110
108
access, changed, created times. </entry></row>
111
109
<row><entry>"unix"</entry><entry>The "Unix" namespace. Includes UNIX-specific
161
159
<tgroup cols='3' align='left'><thead>
162
160
<row><entry>Enum Value</entry><entry>Namespace:Key</entry><entry>Value Type</entry></row>
163
161
</thead><tbody>
164
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-TYPE:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_TYPE</literal></link></entry><entry>standard::type</entry><entry>uint32 (<link linkend="GFileType"><type>GFileType</type></link>)</entry></row>
165
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-HIDDEN:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN</literal></link></entry><entry>standard::is-hidden</entry><entry>boolean</entry></row>
166
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-BACKUP:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP</literal></link></entry><entry>standard::is-backup</entry><entry>boolean</entry></row>
167
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-SYMLINK:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK</literal></link></entry><entry>standard::is-symlink</entry><entry>boolean</entry></row>
168
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-VIRTUAL:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL</literal></link></entry><entry>standard::is-virtual</entry><entry>boolean</entry></row>
169
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-NAME:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_NAME</literal></link></entry><entry>standard::name</entry><entry>byte string</entry></row>
170
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-DISPLAY-NAME:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME</literal></link></entry><entry>standard::display-name</entry><entry>string</entry></row>
171
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-EDIT-NAME:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME</literal></link></entry><entry>standard::edit-name</entry><entry>string</entry></row>
172
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-ICON:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_ICON</literal></link></entry><entry>standard::icon</entry><entry>object (<link linkend="GIcon"><type>GIcon</type></link>)</entry></row>
173
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-CONTENT-TYPE:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE</literal></link></entry><entry>standard::content-type</entry><entry>string</entry></row>
174
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-FAST-CONTENT-TYPE:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE</literal></link></entry><entry>standard::fast-content-type</entry><entry>string</entry></row>
175
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-SIZE:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_SIZE</literal></link></entry><entry>standard::size</entry><entry>uint64</entry></row>
176
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-SYMLINK-TARGET:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET</literal></link></entry><entry>standard::symlink-target</entry><entry>byte string</entry></row>
177
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-TARGET-URI:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_TARGET_URI</literal></link></entry><entry>standard::target-uri</entry><entry>string</entry></row>
178
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-SORT-ORDER:CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER</literal></link></entry><entry>standard::sort-order</entry><entry>int32</entry></row>
179
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ETAG-VALUE:CAPS"><literal>G_FILE_ATTRIBUTE_ETAG_VALUE</literal></link></entry><entry>etag::value</entry><entry>string</entry></row>
180
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ID-FILE:CAPS"><literal>G_FILE_ATTRIBUTE_ID_FILE</literal></link></entry><entry>id::file</entry><entry>string</entry></row>
181
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ID-FILESYSTEM:CAPS"><literal>G_FILE_ATTRIBUTE_ID_FILESYSTEM</literal></link></entry><entry>id::filesystem</entry><entry>string</entry></row>
182
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-READ:CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_READ</literal></link></entry><entry>access::can-read</entry><entry>boolean</entry></row>
183
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-WRITE:CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE</literal></link></entry><entry>access::can-write</entry><entry>boolean</entry></row>
184
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-EXECUTE:CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE</literal></link></entry><entry>access::can-execute</entry><entry>boolean</entry></row>
185
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-DELETE:CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE</literal></link></entry><entry>access::can-delete</entry><entry>boolean</entry></row>
186
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-TRASH:CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH</literal></link></entry><entry>access::can-trash</entry><entry>boolean</entry></row>
187
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-RENAME:CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME</literal></link></entry><entry>access::can-rename</entry><entry>boolean</entry></row>
188
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-CAN-MOUNT:CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT</literal></link></entry><entry>mountable::can-mount</entry><entry>boolean</entry></row>
189
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-CAN-UNMOUNT:CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT</literal></link></entry><entry>mountable::can-unmount</entry><entry>boolean</entry></row>
190
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-CAN-EJECT:CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT</literal></link></entry><entry>mountable::can-eject</entry><entry>boolean</entry></row>
191
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-UNIX-DEVICE:CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE</literal></link></entry><entry>mountable::unix-device</entry><entry>uint32</entry></row>
192
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-HAL-UDI:CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI</literal></link></entry><entry>mountable::hal-udi</entry><entry>string</entry></row>
193
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-MODIFIED:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_MODIFIED</literal></link></entry><entry>time::modified</entry><entry>uint64</entry></row>
194
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-MODIFIED-USEC:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC</literal></link></entry><entry>time::modified-usec</entry><entry>uint32</entry></row>
195
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-ACCESS:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_ACCESS</literal></link></entry><entry>time::access</entry><entry>uint64</entry></row>
196
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-ACCESS-USEC:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_ACCESS_USEC</literal></link></entry><entry>time::access-usec</entry><entry>uint32</entry></row>
197
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CHANGED:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CHANGED</literal></link></entry><entry>time::changed</entry><entry>uint64</entry></row>
198
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CHANGED-USEC:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CHANGED_USEC</literal></link></entry><entry>time::changed-usec</entry><entry>uint32</entry></row>
199
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CREATED:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CREATED</literal></link></entry><entry>time::created</entry><entry>uint64</entry></row>
200
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CREATED-USEC:CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CREATED_USEC</literal></link></entry><entry>time::created-usec</entry><entry>uint32</entry></row>
201
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-DEVICE:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_DEVICE</literal></link></entry><entry>unix::device</entry><entry>uint32</entry></row>
202
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-INODE:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_INODE</literal></link></entry><entry>unix::inode</entry><entry>uint64</entry></row>
203
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-MODE:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_MODE</literal></link></entry><entry>unix::mode</entry><entry>uint32</entry></row>
204
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-NLINK:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_NLINK</literal></link></entry><entry>unix::nlink</entry><entry>uint32</entry></row>
205
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-UID:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_UID</literal></link></entry><entry>unix::uid</entry><entry>uint32</entry></row>
206
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-GID:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_GID</literal></link></entry><entry>unix::gid</entry><entry>uint32</entry></row>
207
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-RDEV:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_RDEV</literal></link></entry><entry>unix::rdev</entry><entry>uint32</entry></row>
208
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-BLOCK-SIZE:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE</literal></link></entry><entry>unix::block-size</entry><entry>uint32</entry></row>
209
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-BLOCKS:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_BLOCKS</literal></link></entry><entry>unix::blocks</entry><entry>uint64</entry></row>
210
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-IS-MOUNTPOINT:CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT</literal></link></entry><entry>unix::is-mountpoint</entry><entry>boolean</entry></row>
211
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-DOS-IS-ARCHIVE:CAPS"><literal>G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE</literal></link></entry><entry>dos::is-archive</entry><entry>boolean</entry></row>
212
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-DOS-IS-SYSTEM:CAPS"><literal>G_FILE_ATTRIBUTE_DOS_IS_SYSTEM</literal></link></entry><entry>dos::is-system</entry><entry>boolean</entry></row>
213
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-OWNER-USER:CAPS"><literal>G_FILE_ATTRIBUTE_OWNER_USER</literal></link></entry><entry>owner::user</entry><entry>string</entry></row>
214
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-OWNER-USER-REAL:CAPS"><literal>G_FILE_ATTRIBUTE_OWNER_USER_REAL</literal></link></entry><entry>owner::user-real</entry><entry>string</entry></row>
215
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-OWNER-GROUP:CAPS"><literal>G_FILE_ATTRIBUTE_OWNER_GROUP</literal></link></entry><entry>owner::group</entry><entry>string</entry></row>
216
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-THUMBNAIL-PATH:CAPS"><literal>G_FILE_ATTRIBUTE_THUMBNAIL_PATH</literal></link></entry><entry>thumbnail::path</entry><entry>bytestring</entry></row>
217
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-THUMBNAILING-FAILED:CAPS"><literal>G_FILE_ATTRIBUTE_THUMBNAILING_FAILED</literal></link></entry><entry>thumbnail::failed</entry><entry>boolean</entry></row>
218
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-SIZE:CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_SIZE</literal></link></entry><entry>filesystem::size</entry><entry>uint64</entry></row>
219
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-FREE:CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_FREE</literal></link></entry><entry>filesystem::free</entry><entry>uint64</entry></row>
220
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-TYPE:CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_TYPE</literal></link></entry><entry>filesystem::type</entry><entry>string</entry></row>
221
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-READONLY:CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_READONLY</literal></link></entry><entry>filesystem::readonly</entry><entry>boolean</entry></row>
222
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-GVFS-BACKEND:CAPS"><literal>G_FILE_ATTRIBUTE_GVFS_BACKEND</literal></link></entry><entry>gvfs::backend</entry><entry>string</entry></row>
223
 
<row><entry><link linkend="G-FILE-ATTRIBUTE-SELINUX-CONTEXT:CAPS"><literal>G_FILE_ATTRIBUTE_SELINUX_CONTEXT</literal></link></entry><entry>selinux::context</entry><entry>string</entry></row>
 
162
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-TYPE--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_TYPE</literal></link></entry><entry>standard::type</entry><entry>uint32 (<link linkend="GFileType"><type>GFileType</type></link>)</entry></row>
 
163
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-HIDDEN--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN</literal></link></entry><entry>standard::is-hidden</entry><entry>boolean</entry></row>
 
164
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-BACKUP--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP</literal></link></entry><entry>standard::is-backup</entry><entry>boolean</entry></row>
 
165
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-SYMLINK--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK</literal></link></entry><entry>standard::is-symlink</entry><entry>boolean</entry></row>
 
166
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-IS-VIRTUAL--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL</literal></link></entry><entry>standard::is-virtual</entry><entry>boolean</entry></row>
 
167
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-NAME--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_NAME</literal></link></entry><entry>standard::name</entry><entry>byte string</entry></row>
 
168
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-DISPLAY-NAME--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME</literal></link></entry><entry>standard::display-name</entry><entry>string</entry></row>
 
169
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-EDIT-NAME--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME</literal></link></entry><entry>standard::edit-name</entry><entry>string</entry></row>
 
170
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-ICON--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_ICON</literal></link></entry><entry>standard::icon</entry><entry>object (<link linkend="GIcon"><type>GIcon</type></link>)</entry></row>
 
171
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-CONTENT-TYPE--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE</literal></link></entry><entry>standard::content-type</entry><entry>string</entry></row>
 
172
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-FAST-CONTENT-TYPE--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE</literal></link></entry><entry>standard::fast-content-type</entry><entry>string</entry></row>
 
173
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-SIZE--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_SIZE</literal></link></entry><entry>standard::size</entry><entry>uint64</entry></row>
 
174
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-SYMLINK-TARGET--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET</literal></link></entry><entry>standard::symlink-target</entry><entry>byte string</entry></row>
 
175
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-TARGET-URI--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_TARGET_URI</literal></link></entry><entry>standard::target-uri</entry><entry>string</entry></row>
 
176
<row><entry><link linkend="G-FILE-ATTRIBUTE-STANDARD-SORT-ORDER--CAPS"><literal>G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER</literal></link></entry><entry>standard::sort-order</entry><entry>int32</entry></row>
 
177
<row><entry><link linkend="G-FILE-ATTRIBUTE-ETAG-VALUE--CAPS"><literal>G_FILE_ATTRIBUTE_ETAG_VALUE</literal></link></entry><entry>etag::value</entry><entry>string</entry></row>
 
178
<row><entry><link linkend="G-FILE-ATTRIBUTE-ID-FILE--CAPS"><literal>G_FILE_ATTRIBUTE_ID_FILE</literal></link></entry><entry>id::file</entry><entry>string</entry></row>
 
179
<row><entry><link linkend="G-FILE-ATTRIBUTE-ID-FILESYSTEM--CAPS"><literal>G_FILE_ATTRIBUTE_ID_FILESYSTEM</literal></link></entry><entry>id::filesystem</entry><entry>string</entry></row>
 
180
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-READ--CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_READ</literal></link></entry><entry>access::can-read</entry><entry>boolean</entry></row>
 
181
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-WRITE--CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE</literal></link></entry><entry>access::can-write</entry><entry>boolean</entry></row>
 
182
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-EXECUTE--CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE</literal></link></entry><entry>access::can-execute</entry><entry>boolean</entry></row>
 
183
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-DELETE--CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE</literal></link></entry><entry>access::can-delete</entry><entry>boolean</entry></row>
 
184
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-TRASH--CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH</literal></link></entry><entry>access::can-trash</entry><entry>boolean</entry></row>
 
185
<row><entry><link linkend="G-FILE-ATTRIBUTE-ACCESS-CAN-RENAME--CAPS"><literal>G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME</literal></link></entry><entry>access::can-rename</entry><entry>boolean</entry></row>
 
186
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-CAN-MOUNT--CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT</literal></link></entry><entry>mountable::can-mount</entry><entry>boolean</entry></row>
 
187
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-CAN-UNMOUNT--CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT</literal></link></entry><entry>mountable::can-unmount</entry><entry>boolean</entry></row>
 
188
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-CAN-EJECT--CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT</literal></link></entry><entry>mountable::can-eject</entry><entry>boolean</entry></row>
 
189
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-UNIX-DEVICE--CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE</literal></link></entry><entry>mountable::unix-device</entry><entry>uint32</entry></row>
 
190
<row><entry><link linkend="G-FILE-ATTRIBUTE-MOUNTABLE-HAL-UDI--CAPS"><literal>G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI</literal></link></entry><entry>mountable::hal-udi</entry><entry>string</entry></row>
 
191
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-MODIFIED--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_MODIFIED</literal></link></entry><entry>time::modified</entry><entry>uint64</entry></row>
 
192
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-MODIFIED-USEC--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC</literal></link></entry><entry>time::modified-usec</entry><entry>uint32</entry></row>
 
193
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-ACCESS--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_ACCESS</literal></link></entry><entry>time::access</entry><entry>uint64</entry></row>
 
194
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-ACCESS-USEC--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_ACCESS_USEC</literal></link></entry><entry>time::access-usec</entry><entry>uint32</entry></row>
 
195
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CHANGED--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CHANGED</literal></link></entry><entry>time::changed</entry><entry>uint64</entry></row>
 
196
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CHANGED-USEC--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CHANGED_USEC</literal></link></entry><entry>time::changed-usec</entry><entry>uint32</entry></row>
 
197
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CREATED--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CREATED</literal></link></entry><entry>time::created</entry><entry>uint64</entry></row>
 
198
<row><entry><link linkend="G-FILE-ATTRIBUTE-TIME-CREATED-USEC--CAPS"><literal>G_FILE_ATTRIBUTE_TIME_CREATED_USEC</literal></link></entry><entry>time::created-usec</entry><entry>uint32</entry></row>
 
199
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-DEVICE--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_DEVICE</literal></link></entry><entry>unix::device</entry><entry>uint32</entry></row>
 
200
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-INODE--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_INODE</literal></link></entry><entry>unix::inode</entry><entry>uint64</entry></row>
 
201
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-MODE--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_MODE</literal></link></entry><entry>unix::mode</entry><entry>uint32</entry></row>
 
202
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-NLINK--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_NLINK</literal></link></entry><entry>unix::nlink</entry><entry>uint32</entry></row>
 
203
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-UID--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_UID</literal></link></entry><entry>unix::uid</entry><entry>uint32</entry></row>
 
204
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-GID--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_GID</literal></link></entry><entry>unix::gid</entry><entry>uint32</entry></row>
 
205
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-RDEV--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_RDEV</literal></link></entry><entry>unix::rdev</entry><entry>uint32</entry></row>
 
206
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-BLOCK-SIZE--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE</literal></link></entry><entry>unix::block-size</entry><entry>uint32</entry></row>
 
207
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-BLOCKS--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_BLOCKS</literal></link></entry><entry>unix::blocks</entry><entry>uint64</entry></row>
 
208
<row><entry><link linkend="G-FILE-ATTRIBUTE-UNIX-IS-MOUNTPOINT--CAPS"><literal>G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT</literal></link></entry><entry>unix::is-mountpoint</entry><entry>boolean</entry></row>
 
209
<row><entry><link linkend="G-FILE-ATTRIBUTE-DOS-IS-ARCHIVE--CAPS"><literal>G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE</literal></link></entry><entry>dos::is-archive</entry><entry>boolean</entry></row>
 
210
<row><entry><link linkend="G-FILE-ATTRIBUTE-DOS-IS-SYSTEM--CAPS"><literal>G_FILE_ATTRIBUTE_DOS_IS_SYSTEM</literal></link></entry><entry>dos::is-system</entry><entry>boolean</entry></row>
 
211
<row><entry><link linkend="G-FILE-ATTRIBUTE-OWNER-USER--CAPS"><literal>G_FILE_ATTRIBUTE_OWNER_USER</literal></link></entry><entry>owner::user</entry><entry>string</entry></row>
 
212
<row><entry><link linkend="G-FILE-ATTRIBUTE-OWNER-USER-REAL--CAPS"><literal>G_FILE_ATTRIBUTE_OWNER_USER_REAL</literal></link></entry><entry>owner::user-real</entry><entry>string</entry></row>
 
213
<row><entry><link linkend="G-FILE-ATTRIBUTE-OWNER-GROUP--CAPS"><literal>G_FILE_ATTRIBUTE_OWNER_GROUP</literal></link></entry><entry>owner::group</entry><entry>string</entry></row>
 
214
<row><entry><link linkend="G-FILE-ATTRIBUTE-THUMBNAIL-PATH--CAPS"><literal>G_FILE_ATTRIBUTE_THUMBNAIL_PATH</literal></link></entry><entry>thumbnail::path</entry><entry>bytestring</entry></row>
 
215
<row><entry><link linkend="G-FILE-ATTRIBUTE-THUMBNAILING-FAILED--CAPS"><literal>G_FILE_ATTRIBUTE_THUMBNAILING_FAILED</literal></link></entry><entry>thumbnail::failed</entry><entry>boolean</entry></row>
 
216
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-SIZE--CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_SIZE</literal></link></entry><entry>filesystem::size</entry><entry>uint64</entry></row>
 
217
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-FREE--CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_FREE</literal></link></entry><entry>filesystem::free</entry><entry>uint64</entry></row>
 
218
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-TYPE--CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_TYPE</literal></link></entry><entry>filesystem::type</entry><entry>string</entry></row>
 
219
<row><entry><link linkend="G-FILE-ATTRIBUTE-FILESYSTEM-READONLY--CAPS"><literal>G_FILE_ATTRIBUTE_FILESYSTEM_READONLY</literal></link></entry><entry>filesystem::readonly</entry><entry>boolean</entry></row>
 
220
<row><entry><link linkend="G-FILE-ATTRIBUTE-GVFS-BACKEND--CAPS"><literal>G_FILE_ATTRIBUTE_GVFS_BACKEND</literal></link></entry><entry>gvfs::backend</entry><entry>string</entry></row>
 
221
<row><entry><link linkend="G-FILE-ATTRIBUTE-SELINUX-CONTEXT--CAPS"><literal>G_FILE_ATTRIBUTE_SELINUX_CONTEXT</literal></link></entry><entry>selinux::context</entry><entry>string</entry></row>
224
222
</tbody></tgroup></table></para>
225
223
 
226
224
Note that there are no predefined keys in the "xattr" and "xattr-sys" 
232
230
the ASCII range are encoded as hexadecimal escape sequences of the form
233
231
\x<replaceable>nn</replaceable>.</para>
234
232
<para>
235
 
 
236
233
</para>
237
234
</refsect1>
238
235
 
239
 
<refsect1 role="details">
 
236
<refsect1 id="gio-GFileAttribute.details" role="details">
240
237
<title role="details.title">Details</title>
241
 
<refsect2>
242
 
<title><anchor id="GFileAttributeType" role="enum"/>enum GFileAttributeType</title>
243
 
<indexterm><primary>GFileAttributeType</primary></indexterm><programlisting>typedef enum {
 
238
<refsect2 id="GFileAttributeType" role="enum">
 
239
<title>enum GFileAttributeType</title>
 
240
<indexterm zone="GFileAttributeType"><primary sortas="GFileAttributeType">GFileAttributeType</primary></indexterm><programlisting>typedef enum {
244
241
  G_FILE_ATTRIBUTE_TYPE_INVALID = 0,
245
242
  G_FILE_ATTRIBUTE_TYPE_STRING,
246
243
  G_FILE_ATTRIBUTE_TYPE_BYTE_STRING, /* zero terminated string of non-zero bytes */
255
252
<para>
256
253
The data types for file attributes.</para>
257
254
<para>
258
 
 
259
255
</para><variablelist role="enum">
260
 
<varlistentry>
261
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-INVALID:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_INVALID</literal></term>
 
256
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-INVALID--CAPS" role="constant">
 
257
<term><literal>G_FILE_ATTRIBUTE_TYPE_INVALID</literal></term>
262
258
<listitem><simpara> indicates an invalid or uninitalized type.
263
259
</simpara></listitem>
264
260
</varlistentry>
265
 
<varlistentry>
266
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-STRING:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_STRING</literal></term>
 
261
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-STRING--CAPS" role="constant">
 
262
<term><literal>G_FILE_ATTRIBUTE_TYPE_STRING</literal></term>
267
263
<listitem><simpara> a null terminated UTF8 string.
268
264
</simpara></listitem>
269
265
</varlistentry>
270
 
<varlistentry>
271
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-BYTE-STRING:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_BYTE_STRING</literal></term>
 
266
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-BYTE-STRING--CAPS" role="constant">
 
267
<term><literal>G_FILE_ATTRIBUTE_TYPE_BYTE_STRING</literal></term>
272
268
<listitem><simpara> a zero terminated string of non-zero bytes.
273
269
</simpara></listitem>
274
270
</varlistentry>
275
 
<varlistentry>
276
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-BOOLEAN:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_BOOLEAN</literal></term>
 
271
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-BOOLEAN--CAPS" role="constant">
 
272
<term><literal>G_FILE_ATTRIBUTE_TYPE_BOOLEAN</literal></term>
277
273
<listitem><simpara> a boolean value.
278
274
</simpara></listitem>
279
275
</varlistentry>
280
 
<varlistentry>
281
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-UINT32:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_UINT32</literal></term>
 
276
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-UINT32--CAPS" role="constant">
 
277
<term><literal>G_FILE_ATTRIBUTE_TYPE_UINT32</literal></term>
282
278
<listitem><simpara> an unsigned 4-byte/32-bit integer.
283
279
</simpara></listitem>
284
280
</varlistentry>
285
 
<varlistentry>
286
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-INT32:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_INT32</literal></term>
 
281
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-INT32--CAPS" role="constant">
 
282
<term><literal>G_FILE_ATTRIBUTE_TYPE_INT32</literal></term>
287
283
<listitem><simpara> a signed 4-byte/32-bit integer.
288
284
</simpara></listitem>
289
285
</varlistentry>
290
 
<varlistentry>
291
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-UINT64:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_UINT64</literal></term>
 
286
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-UINT64--CAPS" role="constant">
 
287
<term><literal>G_FILE_ATTRIBUTE_TYPE_UINT64</literal></term>
292
288
<listitem><simpara> an unsigned 8-byte/64-bit integer.
293
289
</simpara></listitem>
294
290
</varlistentry>
295
 
<varlistentry>
296
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-INT64:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_INT64</literal></term>
 
291
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-INT64--CAPS" role="constant">
 
292
<term><literal>G_FILE_ATTRIBUTE_TYPE_INT64</literal></term>
297
293
<listitem><simpara> a signed 8-byte/64-bit integer.
298
294
</simpara></listitem>
299
295
</varlistentry>
300
 
<varlistentry>
301
 
<term><anchor id="G-FILE-ATTRIBUTE-TYPE-OBJECT:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_TYPE_OBJECT</literal></term>
 
296
<varlistentry id="G-FILE-ATTRIBUTE-TYPE-OBJECT--CAPS" role="constant">
 
297
<term><literal>G_FILE_ATTRIBUTE_TYPE_OBJECT</literal></term>
302
298
<listitem><simpara> a <link linkend="GObject"><type>GObject</type></link>.
303
299
</simpara></listitem>
304
300
</varlistentry>
305
301
</variablelist></refsect2>
306
 
<refsect2>
307
 
<title><anchor id="GFileAttributeInfoFlags" role="enum"/>enum GFileAttributeInfoFlags</title>
308
 
<indexterm><primary>GFileAttributeInfoFlags</primary></indexterm><programlisting>typedef enum {
309
 
  G_FILE_ATTRIBUTE_INFO_NONE = 0,
310
 
  G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE = 1 &lt;&lt; 0,
311
 
  G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED = 1 &lt;&lt; 1
 
302
<refsect2 id="GFileAttributeInfoFlags" role="enum">
 
303
<title>enum GFileAttributeInfoFlags</title>
 
304
<indexterm zone="GFileAttributeInfoFlags"><primary sortas="GFileAttributeInfoFlags">GFileAttributeInfoFlags</primary></indexterm><programlisting>typedef enum {
 
305
  G_FILE_ATTRIBUTE_INFO_NONE            = 0,
 
306
  G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE  = (1 &lt;&lt; 0),
 
307
  G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED = (1 &lt;&lt; 1)
312
308
} GFileAttributeInfoFlags;
313
309
</programlisting>
314
310
<para>
315
311
Flags specifying the behaviour of an attribute.</para>
316
312
<para>
317
 
 
318
313
</para><variablelist role="enum">
319
 
<varlistentry>
320
 
<term><anchor id="G-FILE-ATTRIBUTE-INFO-NONE:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_INFO_NONE</literal></term>
 
314
<varlistentry id="G-FILE-ATTRIBUTE-INFO-NONE--CAPS" role="constant">
 
315
<term><literal>G_FILE_ATTRIBUTE_INFO_NONE</literal></term>
321
316
<listitem><simpara> no flags set.
322
317
</simpara></listitem>
323
318
</varlistentry>
324
 
<varlistentry>
325
 
<term><anchor id="G-FILE-ATTRIBUTE-INFO-COPY-WITH-FILE:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE</literal></term>
 
319
<varlistentry id="G-FILE-ATTRIBUTE-INFO-COPY-WITH-FILE--CAPS" role="constant">
 
320
<term><literal>G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE</literal></term>
326
321
<listitem><simpara> copy the attribute values when the file is copied.
327
322
</simpara></listitem>
328
323
</varlistentry>
329
 
<varlistentry>
330
 
<term><anchor id="G-FILE-ATTRIBUTE-INFO-COPY-WHEN-MOVED:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED</literal></term>
 
324
<varlistentry id="G-FILE-ATTRIBUTE-INFO-COPY-WHEN-MOVED--CAPS" role="constant">
 
325
<term><literal>G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED</literal></term>
331
326
<listitem><simpara> copy the attribute values when the file is moved.
332
327
</simpara></listitem>
333
328
</varlistentry>
334
329
</variablelist></refsect2>
335
 
<refsect2>
336
 
<title><anchor id="GFileAttributeStatus" role="enum"/>enum GFileAttributeStatus</title>
337
 
<indexterm><primary>GFileAttributeStatus</primary></indexterm><programlisting>typedef enum {
 
330
<refsect2 id="GFileAttributeStatus" role="enum">
 
331
<title>enum GFileAttributeStatus</title>
 
332
<indexterm zone="GFileAttributeStatus"><primary sortas="GFileAttributeStatus">GFileAttributeStatus</primary></indexterm><programlisting>typedef enum {
338
333
  G_FILE_ATTRIBUTE_STATUS_UNSET = 0,
339
334
  G_FILE_ATTRIBUTE_STATUS_SET,
340
335
  G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING
343
338
<para>
344
339
Used by <link linkend="g-file-set-attributes-from-info"><function>g_file_set_attributes_from_info()</function></link> when setting file attributes.</para>
345
340
<para>
346
 
 
347
341
</para><variablelist role="enum">
348
 
<varlistentry>
349
 
<term><anchor id="G-FILE-ATTRIBUTE-STATUS-UNSET:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_STATUS_UNSET</literal></term>
 
342
<varlistentry id="G-FILE-ATTRIBUTE-STATUS-UNSET--CAPS" role="constant">
 
343
<term><literal>G_FILE_ATTRIBUTE_STATUS_UNSET</literal></term>
350
344
<listitem><simpara> Attribute value is unset (empty).
351
345
</simpara></listitem>
352
346
</varlistentry>
353
 
<varlistentry>
354
 
<term><anchor id="G-FILE-ATTRIBUTE-STATUS-SET:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_STATUS_SET</literal></term>
 
347
<varlistentry id="G-FILE-ATTRIBUTE-STATUS-SET--CAPS" role="constant">
 
348
<term><literal>G_FILE_ATTRIBUTE_STATUS_SET</literal></term>
355
349
<listitem><simpara> Attribute value is set.
356
350
</simpara></listitem>
357
351
</varlistentry>
358
 
<varlistentry>
359
 
<term><anchor id="G-FILE-ATTRIBUTE-STATUS-ERROR-SETTING:CAPS" role="constant"/><literal>G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING</literal></term>
 
352
<varlistentry id="G-FILE-ATTRIBUTE-STATUS-ERROR-SETTING--CAPS" role="constant">
 
353
<term><literal>G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING</literal></term>
360
354
<listitem><simpara> Indicates an error in setting the value.
361
355
</simpara></listitem>
362
356
</varlistentry>
363
357
</variablelist></refsect2>
364
 
<refsect2>
365
 
<title><anchor id="GFileAttributeInfo" role="struct"/>GFileAttributeInfo</title>
366
 
<indexterm><primary>GFileAttributeInfo</primary></indexterm><programlisting>typedef struct {
367
 
  char *name;
368
 
  GFileAttributeType type;
369
 
  GFileAttributeInfoFlags flags;
 
358
<refsect2 id="GFileAttributeInfo" role="struct">
 
359
<title>GFileAttributeInfo</title>
 
360
<indexterm zone="GFileAttributeInfo"><primary sortas="GFileAttributeInfo">GFileAttributeInfo</primary></indexterm><programlisting>typedef struct {
 
361
  char                    *name;
 
362
  GFileAttributeType       type;
 
363
  GFileAttributeInfoFlags  flags;
370
364
} GFileAttributeInfo;
371
365
</programlisting>
372
366
<para>
373
367
Information about a specific attribute.</para>
374
368
<para>
375
 
 
376
369
</para><variablelist role="struct">
377
370
<varlistentry>
378
 
<term><link linkend="char">char</link>&nbsp;*<structfield>name</structfield>;</term>
 
371
<term><link linkend="char">char</link>&#160;*<structfield>name</structfield>;</term>
379
372
<listitem><simpara> the name of the attribute.
380
373
</simpara></listitem>
381
374
</varlistentry>
382
375
<varlistentry>
383
 
<term><link linkend="GFileAttributeType">GFileAttributeType</link>&nbsp;<structfield>type</structfield>;</term>
 
376
<term><link linkend="GFileAttributeType">GFileAttributeType</link>&#160;<structfield>type</structfield>;</term>
384
377
<listitem><simpara> the <link linkend="GFileAttributeType"><type>GFileAttributeType</type></link> type of the attribute.
385
378
</simpara></listitem>
386
379
</varlistentry>
387
380
<varlistentry>
388
 
<term><link linkend="GFileAttributeInfoFlags">GFileAttributeInfoFlags</link>&nbsp;<structfield>flags</structfield>;</term>
 
381
<term><link linkend="GFileAttributeInfoFlags">GFileAttributeInfoFlags</link>&#160;<structfield>flags</structfield>;</term>
389
382
<listitem><simpara> a set of <link linkend="GFileAttributeInfoFlags"><type>GFileAttributeInfoFlags</type></link>.
390
383
</simpara></listitem>
391
384
</varlistentry>
392
385
</variablelist></refsect2>
393
 
<refsect2>
394
 
<title><anchor id="GFileAttributeInfoList" role="struct"/>GFileAttributeInfoList</title>
395
 
<indexterm><primary>GFileAttributeInfoList</primary></indexterm><programlisting>typedef struct {
 
386
<refsect2 id="GFileAttributeInfoList" role="struct">
 
387
<title>GFileAttributeInfoList</title>
 
388
<indexterm zone="GFileAttributeInfoList"><primary sortas="GFileAttributeInfoList">GFileAttributeInfoList</primary></indexterm><programlisting>typedef struct {
396
389
  GFileAttributeInfo *infos;
397
 
  int n_infos;
 
390
  int                 n_infos;
398
391
} GFileAttributeInfoList;
399
392
</programlisting>
400
393
<para>
401
394
Acts as a lightweight registry for possible valid file attributes.
402
395
The registry stores Key-Value pair formats as <link linkend="GFileAttributeInfo"><type>GFileAttributeInfo</type></link><!-- -->s.</para>
403
396
<para>
404
 
 
405
397
</para><variablelist role="struct">
406
398
<varlistentry>
407
 
<term><link linkend="GFileAttributeInfo">GFileAttributeInfo</link>&nbsp;*<structfield>infos</structfield>;</term>
 
399
<term><link linkend="GFileAttributeInfo">GFileAttributeInfo</link>&#160;*<structfield>infos</structfield>;</term>
408
400
<listitem><simpara> an array of <link linkend="GFileAttributeInfo"><type>GFileAttributeInfo</type></link><!-- -->s.
409
401
</simpara></listitem>
410
402
</varlistentry>
411
403
<varlistentry>
412
 
<term><link linkend="int">int</link>&nbsp;<structfield>n_infos</structfield>;</term>
 
404
<term><link linkend="int">int</link>&#160;<structfield>n_infos</structfield>;</term>
413
405
<listitem><simpara> the number of values in the array.
414
406
</simpara></listitem>
415
407
</varlistentry>
416
408
</variablelist></refsect2>
417
 
<refsect2>
418
 
<title><anchor id="g-file-attribute-info-list-new" role="function"/>g_file_attribute_info_list_new ()</title>
419
 
<indexterm><primary>g_file_attribute_info_list_new</primary></indexterm><programlisting><link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link>* g_file_attribute_info_list_new  (void);</programlisting>
 
409
<refsect2 id="g-file-attribute-info-list-new" role="function">
 
410
<title>g_file_attribute_info_list_new ()</title>
 
411
<indexterm zone="g-file-attribute-info-list-new"><primary sortas="g_file_attribute_info_list_new">g_file_attribute_info_list_new</primary></indexterm><programlisting><link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> * g_file_attribute_info_list_new (void);</programlisting>
420
412
<para>
421
413
Creates a new file attribute info list.</para>
422
414
<para>
423
 
 
424
415
</para><variablelist role="params">
425
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link>.
 
416
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link>.
426
417
</simpara></listitem></varlistentry>
427
418
</variablelist></refsect2>
428
 
<refsect2>
429
 
<title><anchor id="g-file-attribute-info-list-ref" role="function"/>g_file_attribute_info_list_ref ()</title>
430
 
<indexterm><primary>g_file_attribute_info_list_ref</primary></indexterm><programlisting><link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link>* g_file_attribute_info_list_ref  (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);</programlisting>
 
419
<refsect2 id="g-file-attribute-info-list-ref" role="function">
 
420
<title>g_file_attribute_info_list_ref ()</title>
 
421
<indexterm zone="g-file-attribute-info-list-ref"><primary sortas="g_file_attribute_info_list_ref">g_file_attribute_info_list_ref</primary></indexterm><programlisting><link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> * g_file_attribute_info_list_ref (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);</programlisting>
431
422
<para>
432
423
References a file attribute info list.</para>
433
424
<para>
434
 
 
435
425
</para><variablelist role="params">
436
 
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
426
<varlistentry><term><parameter>list</parameter>&#160;:</term>
437
427
<listitem><simpara> a <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link> to reference.
438
428
</simpara></listitem></varlistentry>
439
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> on error.
 
429
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link> on error.
440
430
</simpara></listitem></varlistentry>
441
431
</variablelist></refsect2>
442
 
<refsect2>
443
 
<title><anchor id="g-file-attribute-info-list-unref" role="function"/>g_file_attribute_info_list_unref ()</title>
444
 
<indexterm><primary>g_file_attribute_info_list_unref</primary></indexterm><programlisting><link linkend="void">void</link>                g_file_attribute_info_list_unref    (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);</programlisting>
 
432
<refsect2 id="g-file-attribute-info-list-unref" role="function">
 
433
<title>g_file_attribute_info_list_unref ()</title>
 
434
<indexterm zone="g-file-attribute-info-list-unref"><primary sortas="g_file_attribute_info_list_unref">g_file_attribute_info_list_unref</primary></indexterm><programlisting><link linkend="void">void</link>                g_file_attribute_info_list_unref    (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);</programlisting>
445
435
<para>
446
436
Removes a reference from the given <parameter>list</parameter>. If the reference count
447
437
falls to zero, the <parameter>list</parameter> is deleted.</para>
448
438
<para>
449
 
 
450
439
</para><variablelist role="params">
451
 
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
440
<varlistentry><term><parameter>list</parameter>&#160;:</term>
452
441
<listitem><simpara> The <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link> to unreference.
453
442
</simpara></listitem></varlistentry>
454
443
</variablelist></refsect2>
455
 
<refsect2>
456
 
<title><anchor id="g-file-attribute-info-list-dup" role="function"/>g_file_attribute_info_list_dup ()</title>
457
 
<indexterm><primary>g_file_attribute_info_list_dup</primary></indexterm><programlisting><link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link>* g_file_attribute_info_list_dup  (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);</programlisting>
 
444
<refsect2 id="g-file-attribute-info-list-dup" role="function">
 
445
<title>g_file_attribute_info_list_dup ()</title>
 
446
<indexterm zone="g-file-attribute-info-list-dup"><primary sortas="g_file_attribute_info_list_dup">g_file_attribute_info_list_dup</primary></indexterm><programlisting><link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> * g_file_attribute_info_list_dup (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list);</programlisting>
458
447
<para>
459
448
Makes a duplicate of a file attribute info list.</para>
460
449
<para>
461
 
 
462
450
</para><variablelist role="params">
463
 
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
451
<varlistentry><term><parameter>list</parameter>&#160;:</term>
464
452
<listitem><simpara> a <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link> to duplicate.
465
453
</simpara></listitem></varlistentry>
466
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a copy of the given <parameter>list</parameter>. 
 
454
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a copy of the given <parameter>list</parameter>. 
467
455
</simpara></listitem></varlistentry>
468
456
</variablelist></refsect2>
469
 
<refsect2>
470
 
<title><anchor id="g-file-attribute-info-list-lookup" role="function"/>g_file_attribute_info_list_lookup ()</title>
471
 
<indexterm><primary>g_file_attribute_info_list_lookup</primary></indexterm><programlisting>const <link linkend="GFileAttributeInfo">GFileAttributeInfo</link>* g_file_attribute_info_list_lookup
 
457
<refsect2 id="g-file-attribute-info-list-lookup" role="function">
 
458
<title>g_file_attribute_info_list_lookup ()</title>
 
459
<indexterm zone="g-file-attribute-info-list-lookup"><primary sortas="g_file_attribute_info_list_lookup">g_file_attribute_info_list_lookup</primary></indexterm><programlisting>const <link linkend="GFileAttributeInfo">GFileAttributeInfo</link> * g_file_attribute_info_list_lookup
472
460
                                                        (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list,
473
461
                                                         const <link linkend="char">char</link> *name);</programlisting>
474
462
<para>
475
463
Gets the file attribute with the name <parameter>name</parameter> from <parameter>list</parameter>.</para>
476
464
<para>
477
 
 
478
465
</para><variablelist role="params">
479
 
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
466
<varlistentry><term><parameter>list</parameter>&#160;:</term>
480
467
<listitem><simpara> a <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link>.
481
468
</simpara></listitem></varlistentry>
482
 
<varlistentry><term><parameter>name</parameter>&nbsp;:</term>
 
469
<varlistentry><term><parameter>name</parameter>&#160;:</term>
483
470
<listitem><simpara> the name of the attribute to lookup.
484
471
</simpara></listitem></varlistentry>
485
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GFileAttributeInfo"><type>GFileAttributeInfo</type></link> for the <parameter>name</parameter>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if an 
 
472
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GFileAttributeInfo"><type>GFileAttributeInfo</type></link> for the <parameter>name</parameter>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if an 
486
473
attribute isn't found.
487
474
</simpara></listitem></varlistentry>
488
475
</variablelist></refsect2>
489
 
<refsect2>
490
 
<title><anchor id="g-file-attribute-info-list-add" role="function"/>g_file_attribute_info_list_add ()</title>
491
 
<indexterm><primary>g_file_attribute_info_list_add</primary></indexterm><programlisting><link linkend="void">void</link>                g_file_attribute_info_list_add      (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list,
 
476
<refsect2 id="g-file-attribute-info-list-add" role="function">
 
477
<title>g_file_attribute_info_list_add ()</title>
 
478
<indexterm zone="g-file-attribute-info-list-add"><primary sortas="g_file_attribute_info_list_add">g_file_attribute_info_list_add</primary></indexterm><programlisting><link linkend="void">void</link>                g_file_attribute_info_list_add      (<link linkend="GFileAttributeInfoList">GFileAttributeInfoList</link> *list,
492
479
                                                         const <link linkend="char">char</link> *name,
493
480
                                                         <link linkend="GFileAttributeType">GFileAttributeType</link> type,
494
481
                                                         <link linkend="GFileAttributeInfoFlags">GFileAttributeInfoFlags</link> flags);</programlisting>
496
483
Adds a new attribute with <parameter>name</parameter> to the <parameter>list</parameter>, setting
497
484
its <parameter>type</parameter> and <parameter>flags</parameter>.</para>
498
485
<para>
499
 
 
500
486
</para><variablelist role="params">
501
 
<varlistentry><term><parameter>list</parameter>&nbsp;:</term>
 
487
<varlistentry><term><parameter>list</parameter>&#160;:</term>
502
488
<listitem><simpara> a <link linkend="GFileAttributeInfoList"><type>GFileAttributeInfoList</type></link>.
503
489
</simpara></listitem></varlistentry>
504
 
<varlistentry><term><parameter>name</parameter>&nbsp;:</term>
 
490
<varlistentry><term><parameter>name</parameter>&#160;:</term>
505
491
<listitem><simpara> the name of the attribute to add.
506
492
</simpara></listitem></varlistentry>
507
 
<varlistentry><term><parameter>type</parameter>&nbsp;:</term>
 
493
<varlistentry><term><parameter>type</parameter>&#160;:</term>
508
494
<listitem><simpara> the <link linkend="GFileAttributeType"><type>GFileAttributeType</type></link> for the attribute.
509
495
</simpara></listitem></varlistentry>
510
 
<varlistentry><term><parameter>flags</parameter>&nbsp;:</term>
 
496
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
511
497
<listitem><simpara> <link linkend="GFileAttributeInfoFlags"><type>GFileAttributeInfoFlags</type></link> for the attribute.
512
498
</simpara></listitem></varlistentry>
513
499
</variablelist></refsect2>
516
502
 
517
503
 
518
504
 
519
 
<refsect1>
 
505
<refsect1 id="gio-GFileAttribute.see-also">
520
506
<title>See Also</title>
521
 
<link linkend="GFile"><type>GFile</type></link>, <link linkend="GFileInfo"><type>GFileInfo</type></link>
 
507
#GFile, <link linkend="GFileInfo"><type>GFileInfo</type></link>
522
508
</refsect1>
523
509
 
524
 
 
525
 
<refsect1><refsect2 /><refsect2 /></refsect1>
526
510
</refentry>