docs/reference/gio/html/gio-GFileAttribute.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>GFileAttribute</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="file_ops.html" title="File Operations">
   9 <link rel="prev" href="GFile.html" title="GFile">
  10 <link rel="next" href="GFileInfo.html" title="GFileInfo">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="GFile.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="file_ops.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GIO Reference Manual</th>
  21 <td><a accesskey="n" href="GFileInfo.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gio-GFileAttribute.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gio-GFileAttribute.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="gio-GFileAttribute"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="gio-GFileAttribute.top_of_page"></a>GFileAttribute</span></h2>
  34 <p>GFileAttribute — Key-Value Paired File Attributes</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="gio-GFileAttribute.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">
  41 #include &lt;gio/gio.h&gt;
  42
  43 enum                <a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType">GFileAttributeType</a>;
  44 enum                <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoFlags" title="enum GFileAttributeInfoFlags">GFileAttributeInfoFlags</a>;
  45 enum                <a class="link" href="gio-GFileAttribute.html#GFileAttributeStatus" title="enum GFileAttributeStatus">GFileAttributeStatus</a>;
  46                     <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo">GFileAttributeInfo</a>;
  47                     <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList">GFileAttributeInfoList</a>;
  48 <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-new" title="g_file_attribute_info_list_new ()">g_file_attribute_info_list_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
  49 <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-ref" title="g_file_attribute_info_list_ref ()">g_file_attribute_info_list_ref</a> (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>);
  50 <span class="returnvalue">void</span>                <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-unref" title="g_file_attribute_info_list_unref ()">g_file_attribute_info_list_unref</a>    (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>);
  51 <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-dup" title="g_file_attribute_info_list_dup ()">g_file_attribute_info_list_dup</a> (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>);
  52 const <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="returnvalue">GFileAttributeInfo</span></a> * <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-lookup" title="g_file_attribute_info_list_lookup ()">g_file_attribute_info_list_lookup</a>
  53                                                         (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>,
  54                                                          <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);
  55 <span class="returnvalue">void</span>                <a class="link" href="gio-GFileAttribute.html#g-file-attribute-info-list-add" title="g_file_attribute_info_list_add ()">g_file_attribute_info_list_add</a>      (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>,
  56                                                          <em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
  57                                                          <em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a> type</code></em>,
  58                                                          <em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoFlags" title="enum GFileAttributeInfoFlags"><span class="type">GFileAttributeInfoFlags</span></a> flags</code></em>);
  59 </pre>
  60 </div>
  61 <div class="refsect1">
  62 <a name="gio-GFileAttribute.description"></a><h2>Description</h2>
  63 <p>
  64 File attributes in GIO consist of a list of key-value pairs.
  65 </p>
  66 <p>
  67 Keys are strings that contain a key namespace and a key name, separated
  68 by a colon, e.g. "namespace:keyname". Namespaces are included to sort
  69 key-value pairs by namespaces for relevance. Keys can be retrived
  70 using wildcards, e.g. "standard::*" will return all of the keys in the
  71 "standard" namespace.
  72 </p>
  73 <p>
  74 The list of possible attributes for a filesystem (pointed to by a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>) is
  75 available as a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a>. This list is queryable by key names
  76 as indicated earlier.
  77 </p>
  78 <p>
  79 Information is stored within the list in <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="type">GFileAttributeInfo</span></a> structures.
  80 The info structure can store different types, listed in the enum
  81 <a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a>. Upon creation of a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="type">GFileAttributeInfo</span></a>, the type will
  82 be set to <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-INVALID:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INVALID</code></a>.
  83 </p>
  84 <p>
  85 Classes that implement <a class="link" href="GFile.html#GFileIface" title="struct GFileIface"><span class="type">GFileIface</span></a> will create a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> and
  86 install default keys and values for their given file system, architecture,
  87 and other possible implementation details (e.g., on a UNIX system, a file
  88 attribute key will be registered for the user id for a given file).
  89 </p>
  90 <p>
  91 </p>
  92 <p>
  93 </p>
  94 <div class="table">
  95 <a name="idp8400800"></a><p class="title"><b>Table 1. GFileAttributes Default Namespaces</b></p>
  96 <div class="table-contents"><table summary="GFileAttributes Default Namespaces" border="1">
  97 <colgroup>
  98 <col>
  99 <col>
 100 </colgroup>
 101 <thead><tr>
 102 <th align="left">Namspace</th>
 103 <th align="left">Description</th>
 104 </tr></thead>
 105 <tbody>
 106 <tr>
 107 <td align="left">"standard"</td>
 108 <td align="left">The "Standard" namespace. General file
 109 information that any application may need should be put in this namespace.
 110 Examples include the file's name, type, and size.</td>
 111 </tr>
 112 <tr>
 113 <td align="left">"etag"</td>
 114 <td align="left">The <a class="link" href="GFile.html#gfile-etag">"Entity Tag"</a>
 115 namespace. Currently, the only key in this namespace is "value", which contains
 116 the value of the current entity tag.</td>
 117 </tr>
 118 <tr>
 119 <td align="left">"id"</td>
 120 <td align="left">The "Identification" namespace. This
 121 namespace is used by file managers and applications that list directories
 122 to check for loops and to uniquely identify files.</td>
 123 </tr>
 124 <tr>
 125 <td align="left">"access"</td>
 126 <td align="left">The "Access" namespace. Used to check
 127 if a user has the proper privilidges to access files and perform
 128 file operations. Keys in this namespace are made to be generic
 129 and easily understood, e.g. the "can_read" key is <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if
 130 the current user has permission to read the file. UNIX permissions and
 131 NTFS ACLs in Windows should be mapped to these values.</td>
 132 </tr>
 133 <tr>
 134 <td align="left">"mountable"</td>
 135 <td align="left">The "Mountable" namespace. Includes
 136 simple boolean keys for checking if a file or path supports mount operations, e.g.
 137 mount, unmount, eject. These are used for files of type <a class="link" href="GFileInfo.html#G-FILE-TYPE-MOUNTABLE:CAPS"><code class="literal">G_FILE_TYPE_MOUNTABLE</code></a>.</td>
 138 </tr>
 139 <tr>
 140 <td align="left">"time"</td>
 141 <td align="left">The "Time" namespace. Includes file
 142 access, changed, created times. </td>
 143 </tr>
 144 <tr>
 145 <td align="left">"unix"</td>
 146 <td align="left">The "Unix" namespace. Includes UNIX-specific
 147 information and may not be available for all files. Examples include
 148 the UNIX "UID", "GID", etc.</td>
 149 </tr>
 150 <tr>
 151 <td align="left">"dos"</td>
 152 <td align="left">The "DOS" namespace. Includes DOS-specific
 153 information and may not be available for all files. Examples include
 154 "is_system" for checking if a file is marked as a system file, and "is_archive"
 155 for checking if a file is marked as an archive file.</td>
 156 </tr>
 157 <tr>
 158 <td align="left">"owner"</td>
 159 <td align="left">The "Owner" namespace. Includes information
 160 about who owns a file. May not be available for all file systems. Examples include
 161 "user" for getting the user name of the file owner. This information is often mapped from
 162 some backend specific data such as a unix UID.</td>
 163 </tr>
 164 <tr>
 165 <td align="left">"thumbnail"</td>
 166 <td align="left">The "Thumbnail" namespace. Includes
 167 information about file thumbnails and their location within the file system. Examples of
 168 keys in this namespace include "path" to get the location of a thumbnail, and "failed"
 169 to check if thumbnailing of the file failed.</td>
 170 </tr>
 171 <tr>
 172 <td align="left">"filesystem"</td>
 173 <td align="left">The "Filesystem" namespace. Gets information
 174 about the file system where a file is located, such as its type, how much
 175 space is left available, and the overall size of the file system.</td>
 176 </tr>
 177 <tr>
 178 <td align="left">"gvfs"</td>
 179 <td align="left">The "GVFS" namespace. Keys in this namespace
 180 contain information about the current GVFS backend in use. </td>
 181 </tr>
 182 <tr>
 183 <td align="left">"xattr"</td>
 184 <td align="left">The "xattr" namespace. Gets information
 185 about extended user attributes. See attr(5). The "user." prefix of the
 186 extended user attribute name is stripped away when constructing keys in
 187 this namespace, e.g. "xattr::mime_type" for the extended attribute with
 188 the name "user.mime_type". Note that this information is only available
 189 if GLib has been built with extended attribute support.</td>
 190 </tr>
 191 <tr>
 192 <td align="left">"xattr-sys"</td>
 193 <td align="left">The "xattr-sys" namespace.
 194 Gets information about extended attributes which are not user-specific.
 195 See attr(5). Note that this information is only available if GLib
 196 has been built with extended attribute support.</td>
 197 </tr>
 198 <tr>
 199 <td align="left">"selinux"</td>
 200 <td align="left">The "SELinux" namespace. Includes
 201 information about the SELinux context of files. Note that this information
 202 is only available if GLib has been built with SELinux support.</td>
 203 </tr>
 204 </tbody>
 205 </table></div>
 206 </div>
 207 <p><br class="table-break">
 208 </p>
 209 <p>
 210 </p>
 211 <p>
 212 Please note that these are not all of the possible namespaces.
 213 More namespaces can be added from GIO modules or by individual applications.
 214 For more information about writing GIO modules, see <a class="link" href="GIOModule.html" title="GIOModule"><span class="type">GIOModule</span></a>.
 215 </p>
 216 <p>
 217
 218 </p>
 219 <p>
 220 </p>
 221 <div class="table">
 222 <a name="idp12192992"></a><p class="title"><b>Table 2. GFileAttributes Built-in Keys and Value Types</b></p>
 223 <div class="table-contents"><table summary="GFileAttributes Built-in Keys and Value Types" border="1">
 224 <colgroup>
 225 <col>
 226 <col>
 227 <col>
 228 </colgroup>
 229 <thead><tr>
 230 <th align="left">Enum Value</th>
 231 <th align="left">Namespace:Key</th>
 232 <th align="left">Value Type</th>
 233 </tr></thead>
 234 <tbody>
 235 <tr>
 236 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-TYPE:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_TYPE"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_TYPE</code></a></td>
 237 <td align="left">standard::type</td>
 238 <td align="left">uint32 (<a class="link" href="GFileInfo.html#GFileType" title="enum GFileType"><span class="type">GFileType</span></a>)</td>
 239 </tr>
 240 <tr>
 241 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-IS-HIDDEN:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN</code></a></td>
 242 <td align="left">standard::is-hidden</td>
 243 <td align="left">boolean</td>
 244 </tr>
 245 <tr>
 246 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-IS-BACKUP:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP</code></a></td>
 247 <td align="left">standard::is-backup</td>
 248 <td align="left">boolean</td>
 249 </tr>
 250 <tr>
 251 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-IS-SYMLINK:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK</code></a></td>
 252 <td align="left">standard::is-symlink</td>
 253 <td align="left">boolean</td>
 254 </tr>
 255 <tr>
 256 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-IS-VIRTUAL:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL</code></a></td>
 257 <td align="left">standard::is-virtual</td>
 258 <td align="left">boolean</td>
 259 </tr>
 260 <tr>
 261 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_NAME"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_NAME</code></a></td>
 262 <td align="left">standard::name</td>
 263 <td align="left">byte string</td>
 264 </tr>
 265 <tr>
 266 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-DISPLAY-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME</code></a></td>
 267 <td align="left">standard::display-name</td>
 268 <td align="left">string</td>
 269 </tr>
 270 <tr>
 271 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-EDIT-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME</code></a></td>
 272 <td align="left">standard::edit-name</td>
 273 <td align="left">string</td>
 274 </tr>
 275 <tr>
 276 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-ICON:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_ICON"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_ICON</code></a></td>
 277 <td align="left">standard::icon</td>
 278 <td align="left">object (<a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a>)</td>
 279 </tr>
 280 <tr>
 281 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-CONTENT-TYPE:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE</code></a></td>
 282 <td align="left">standard::content-type</td>
 283 <td align="left">string</td>
 284 </tr>
 285 <tr>
 286 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-FAST-CONTENT-TYPE:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE</code></a></td>
 287 <td align="left">standard::fast-content-type</td>
 288 <td align="left">string</td>
 289 </tr>
 290 <tr>
 291 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-SIZE:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_SIZE"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_SIZE</code></a></td>
 292 <td align="left">standard::size</td>
 293 <td align="left">uint64</td>
 294 </tr>
 295 <tr>
 296 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-ALLOCATED-SIZE:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE</code></a></td>
 297 <td align="left">standard::allocated-size</td>
 298 <td align="left">uint64</td>
 299 </tr>
 300 <tr>
 301 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-SYMLINK-TARGET:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET</code></a></td>
 302 <td align="left">standard::symlink-target</td>
 303 <td align="left">byte string</td>
 304 </tr>
 305 <tr>
 306 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-TARGET-URI:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_TARGET_URI"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_TARGET_URI</code></a></td>
 307 <td align="left">standard::target-uri</td>
 308 <td align="left">string</td>
 309 </tr>
 310 <tr>
 311 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-SORT-ORDER:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER"><code class="literal">G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER</code></a></td>
 312 <td align="left">standard::sort-order</td>
 313 <td align="left">int32</td>
 314 </tr>
 315 <tr>
 316 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ETAG-VALUE:CAPS" title="G_FILE_ATTRIBUTE_ETAG_VALUE"><code class="literal">G_FILE_ATTRIBUTE_ETAG_VALUE</code></a></td>
 317 <td align="left">etag::value</td>
 318 <td align="left">string</td>
 319 </tr>
 320 <tr>
 321 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ID-FILE:CAPS" title="G_FILE_ATTRIBUTE_ID_FILE"><code class="literal">G_FILE_ATTRIBUTE_ID_FILE</code></a></td>
 322 <td align="left">id::file</td>
 323 <td align="left">string</td>
 324 </tr>
 325 <tr>
 326 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ID-FILESYSTEM:CAPS" title="G_FILE_ATTRIBUTE_ID_FILESYSTEM"><code class="literal">G_FILE_ATTRIBUTE_ID_FILESYSTEM</code></a></td>
 327 <td align="left">id::filesystem</td>
 328 <td align="left">string</td>
 329 </tr>
 330 <tr>
 331 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ACCESS-CAN-READ:CAPS" title="G_FILE_ATTRIBUTE_ACCESS_CAN_READ"><code class="literal">G_FILE_ATTRIBUTE_ACCESS_CAN_READ</code></a></td>
 332 <td align="left">access::can-read</td>
 333 <td align="left">boolean</td>
 334 </tr>
 335 <tr>
 336 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ACCESS-CAN-WRITE:CAPS" title="G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE"><code class="literal">G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE</code></a></td>
 337 <td align="left">access::can-write</td>
 338 <td align="left">boolean</td>
 339 </tr>
 340 <tr>
 341 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ACCESS-CAN-EXECUTE:CAPS" title="G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE"><code class="literal">G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE</code></a></td>
 342 <td align="left">access::can-execute</td>
 343 <td align="left">boolean</td>
 344 </tr>
 345 <tr>
 346 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ACCESS-CAN-DELETE:CAPS" title="G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE"><code class="literal">G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE</code></a></td>
 347 <td align="left">access::can-delete</td>
 348 <td align="left">boolean</td>
 349 </tr>
 350 <tr>
 351 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ACCESS-CAN-TRASH:CAPS" title="G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH"><code class="literal">G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH</code></a></td>
 352 <td align="left">access::can-trash</td>
 353 <td align="left">boolean</td>
 354 </tr>
 355 <tr>
 356 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-ACCESS-CAN-RENAME:CAPS" title="G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME"><code class="literal">G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME</code></a></td>
 357 <td align="left">access::can-rename</td>
 358 <td align="left">boolean</td>
 359 </tr>
 360 <tr>
 361 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-MOUNTABLE-CAN-MOUNT:CAPS" title="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT"><code class="literal">G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT</code></a></td>
 362 <td align="left">mountable::can-mount</td>
 363 <td align="left">boolean</td>
 364 </tr>
 365 <tr>
 366 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-MOUNTABLE-CAN-UNMOUNT:CAPS" title="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT"><code class="literal">G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT</code></a></td>
 367 <td align="left">mountable::can-unmount</td>
 368 <td align="left">boolean</td>
 369 </tr>
 370 <tr>
 371 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-MOUNTABLE-CAN-EJECT:CAPS" title="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT"><code class="literal">G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT</code></a></td>
 372 <td align="left">mountable::can-eject</td>
 373 <td align="left">boolean</td>
 374 </tr>
 375 <tr>
 376 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-MOUNTABLE-UNIX-DEVICE:CAPS" title="G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE"><code class="literal">G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE</code></a></td>
 377 <td align="left">mountable::unix-device</td>
 378 <td align="left">uint32</td>
 379 </tr>
 380 <tr>
 381 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-MOUNTABLE-UNIX-DEVICE-FILE:CAPS" title="G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE"><code class="literal">G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE</code></a></td>
 382 <td align="left">mountable::unix-device-file</td>
 383 <td align="left">string</td>
 384 </tr>
 385 <tr>
 386 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-MOUNTABLE-HAL-UDI:CAPS" title="G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI"><code class="literal">G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI</code></a></td>
 387 <td align="left">mountable::hal-udi</td>
 388 <td align="left">string</td>
 389 </tr>
 390 <tr>
 391 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-MODIFIED:CAPS" title="G_FILE_ATTRIBUTE_TIME_MODIFIED"><code class="literal">G_FILE_ATTRIBUTE_TIME_MODIFIED</code></a></td>
 392 <td align="left">time::modified</td>
 393 <td align="left">uint64</td>
 394 </tr>
 395 <tr>
 396 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-MODIFIED-USEC:CAPS" title="G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC"><code class="literal">G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC</code></a></td>
 397 <td align="left">time::modified-usec</td>
 398 <td align="left">uint32</td>
 399 </tr>
 400 <tr>
 401 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-ACCESS:CAPS" title="G_FILE_ATTRIBUTE_TIME_ACCESS"><code class="literal">G_FILE_ATTRIBUTE_TIME_ACCESS</code></a></td>
 402 <td align="left">time::access</td>
 403 <td align="left">uint64</td>
 404 </tr>
 405 <tr>
 406 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-ACCESS-USEC:CAPS" title="G_FILE_ATTRIBUTE_TIME_ACCESS_USEC"><code class="literal">G_FILE_ATTRIBUTE_TIME_ACCESS_USEC</code></a></td>
 407 <td align="left">time::access-usec</td>
 408 <td align="left">uint32</td>
 409 </tr>
 410 <tr>
 411 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-CHANGED:CAPS" title="G_FILE_ATTRIBUTE_TIME_CHANGED"><code class="literal">G_FILE_ATTRIBUTE_TIME_CHANGED</code></a></td>
 412 <td align="left">time::changed</td>
 413 <td align="left">uint64</td>
 414 </tr>
 415 <tr>
 416 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-CHANGED-USEC:CAPS" title="G_FILE_ATTRIBUTE_TIME_CHANGED_USEC"><code class="literal">G_FILE_ATTRIBUTE_TIME_CHANGED_USEC</code></a></td>
 417 <td align="left">time::changed-usec</td>
 418 <td align="left">uint32</td>
 419 </tr>
 420 <tr>
 421 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-CREATED:CAPS" title="G_FILE_ATTRIBUTE_TIME_CREATED"><code class="literal">G_FILE_ATTRIBUTE_TIME_CREATED</code></a></td>
 422 <td align="left">time::created</td>
 423 <td align="left">uint64</td>
 424 </tr>
 425 <tr>
 426 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-TIME-CREATED-USEC:CAPS" title="G_FILE_ATTRIBUTE_TIME_CREATED_USEC"><code class="literal">G_FILE_ATTRIBUTE_TIME_CREATED_USEC</code></a></td>
 427 <td align="left">time::created-usec</td>
 428 <td align="left">uint32</td>
 429 </tr>
 430 <tr>
 431 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-DEVICE:CAPS" title="G_FILE_ATTRIBUTE_UNIX_DEVICE"><code class="literal">G_FILE_ATTRIBUTE_UNIX_DEVICE</code></a></td>
 432 <td align="left">unix::device</td>
 433 <td align="left">uint32</td>
 434 </tr>
 435 <tr>
 436 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-INODE:CAPS" title="G_FILE_ATTRIBUTE_UNIX_INODE"><code class="literal">G_FILE_ATTRIBUTE_UNIX_INODE</code></a></td>
 437 <td align="left">unix::inode</td>
 438 <td align="left">uint64</td>
 439 </tr>
 440 <tr>
 441 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-MODE:CAPS" title="G_FILE_ATTRIBUTE_UNIX_MODE"><code class="literal">G_FILE_ATTRIBUTE_UNIX_MODE</code></a></td>
 442 <td align="left">unix::mode</td>
 443 <td align="left">uint32</td>
 444 </tr>
 445 <tr>
 446 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-NLINK:CAPS" title="G_FILE_ATTRIBUTE_UNIX_NLINK"><code class="literal">G_FILE_ATTRIBUTE_UNIX_NLINK</code></a></td>
 447 <td align="left">unix::nlink</td>
 448 <td align="left">uint32</td>
 449 </tr>
 450 <tr>
 451 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-UID:CAPS" title="G_FILE_ATTRIBUTE_UNIX_UID"><code class="literal">G_FILE_ATTRIBUTE_UNIX_UID</code></a></td>
 452 <td align="left">unix::uid</td>
 453 <td align="left">uint32</td>
 454 </tr>
 455 <tr>
 456 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-GID:CAPS" title="G_FILE_ATTRIBUTE_UNIX_GID"><code class="literal">G_FILE_ATTRIBUTE_UNIX_GID</code></a></td>
 457 <td align="left">unix::gid</td>
 458 <td align="left">uint32</td>
 459 </tr>
 460 <tr>
 461 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-RDEV:CAPS" title="G_FILE_ATTRIBUTE_UNIX_RDEV"><code class="literal">G_FILE_ATTRIBUTE_UNIX_RDEV</code></a></td>
 462 <td align="left">unix::rdev</td>
 463 <td align="left">uint32</td>
 464 </tr>
 465 <tr>
 466 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-BLOCK-SIZE:CAPS" title="G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE"><code class="literal">G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE</code></a></td>
 467 <td align="left">unix::block-size</td>
 468 <td align="left">uint32</td>
 469 </tr>
 470 <tr>
 471 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-BLOCKS:CAPS" title="G_FILE_ATTRIBUTE_UNIX_BLOCKS"><code class="literal">G_FILE_ATTRIBUTE_UNIX_BLOCKS</code></a></td>
 472 <td align="left">unix::blocks</td>
 473 <td align="left">uint64</td>
 474 </tr>
 475 <tr>
 476 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-UNIX-IS-MOUNTPOINT:CAPS" title="G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT"><code class="literal">G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT</code></a></td>
 477 <td align="left">unix::is-mountpoint</td>
 478 <td align="left">boolean</td>
 479 </tr>
 480 <tr>
 481 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-DOS-IS-ARCHIVE:CAPS" title="G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE"><code class="literal">G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE</code></a></td>
 482 <td align="left">dos::is-archive</td>
 483 <td align="left">boolean</td>
 484 </tr>
 485 <tr>
 486 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-DOS-IS-SYSTEM:CAPS" title="G_FILE_ATTRIBUTE_DOS_IS_SYSTEM"><code class="literal">G_FILE_ATTRIBUTE_DOS_IS_SYSTEM</code></a></td>
 487 <td align="left">dos::is-system</td>
 488 <td align="left">boolean</td>
 489 </tr>
 490 <tr>
 491 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-OWNER-USER:CAPS" title="G_FILE_ATTRIBUTE_OWNER_USER"><code class="literal">G_FILE_ATTRIBUTE_OWNER_USER</code></a></td>
 492 <td align="left">owner::user</td>
 493 <td align="left">string</td>
 494 </tr>
 495 <tr>
 496 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-OWNER-USER-REAL:CAPS" title="G_FILE_ATTRIBUTE_OWNER_USER_REAL"><code class="literal">G_FILE_ATTRIBUTE_OWNER_USER_REAL</code></a></td>
 497 <td align="left">owner::user-real</td>
 498 <td align="left">string</td>
 499 </tr>
 500 <tr>
 501 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-OWNER-GROUP:CAPS" title="G_FILE_ATTRIBUTE_OWNER_GROUP"><code class="literal">G_FILE_ATTRIBUTE_OWNER_GROUP</code></a></td>
 502 <td align="left">owner::group</td>
 503 <td align="left">string</td>
 504 </tr>
 505 <tr>
 506 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-THUMBNAIL-PATH:CAPS" title="G_FILE_ATTRIBUTE_THUMBNAIL_PATH"><code class="literal">G_FILE_ATTRIBUTE_THUMBNAIL_PATH</code></a></td>
 507 <td align="left">thumbnail::path</td>
 508 <td align="left">bytestring</td>
 509 </tr>
 510 <tr>
 511 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-THUMBNAILING-FAILED:CAPS" title="G_FILE_ATTRIBUTE_THUMBNAILING_FAILED"><code class="literal">G_FILE_ATTRIBUTE_THUMBNAILING_FAILED</code></a></td>
 512 <td align="left">thumbnail::failed</td>
 513 <td align="left">boolean</td>
 514 </tr>
 515 <tr>
 516 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-PREVIEW-ICON:CAPS" title="G_FILE_ATTRIBUTE_PREVIEW_ICON"><code class="literal">G_FILE_ATTRIBUTE_PREVIEW_ICON</code></a></td>
 517 <td align="left">preview::icon</td>
 518 <td align="left">object (<a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a>)</td>
 519 </tr>
 520 <tr>
 521 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-SIZE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_SIZE"><code class="literal">G_FILE_ATTRIBUTE_FILESYSTEM_SIZE</code></a></td>
 522 <td align="left">filesystem::size</td>
 523 <td align="left">uint64</td>
 524 </tr>
 525 <tr>
 526 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-FREE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_FREE"><code class="literal">G_FILE_ATTRIBUTE_FILESYSTEM_FREE</code></a></td>
 527 <td align="left">filesystem::free</td>
 528 <td align="left">uint64</td>
 529 </tr>
 530 <tr>
 531 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-USED:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_USED"><code class="literal">G_FILE_ATTRIBUTE_FILESYSTEM_USED</code></a></td>
 532 <td align="left">filesystem::used</td>
 533 <td align="left">uint64</td>
 534 </tr>
 535 <tr>
 536 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-TYPE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_TYPE"><code class="literal">G_FILE_ATTRIBUTE_FILESYSTEM_TYPE</code></a></td>
 537 <td align="left">filesystem::type</td>
 538 <td align="left">string</td>
 539 </tr>
 540 <tr>
 541 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-READONLY:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_READONLY"><code class="literal">G_FILE_ATTRIBUTE_FILESYSTEM_READONLY</code></a></td>
 542 <td align="left">filesystem::readonly</td>
 543 <td align="left">boolean</td>
 544 </tr>
 545 <tr>
 546 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-GVFS-BACKEND:CAPS" title="G_FILE_ATTRIBUTE_GVFS_BACKEND"><code class="literal">G_FILE_ATTRIBUTE_GVFS_BACKEND</code></a></td>
 547 <td align="left">gvfs::backend</td>
 548 <td align="left">string</td>
 549 </tr>
 550 <tr>
 551 <td align="left"><a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-SELINUX-CONTEXT:CAPS" title="G_FILE_ATTRIBUTE_SELINUX_CONTEXT"><code class="literal">G_FILE_ATTRIBUTE_SELINUX_CONTEXT</code></a></td>
 552 <td align="left">selinux::context</td>
 553 <td align="left">string</td>
 554 </tr>
 555 </tbody>
 556 </table></div>
 557 </div>
 558 <p><br class="table-break"></p>
 559 <p>
 560 </p>
 561 <p>
 562 Note that there are no predefined keys in the "xattr" and "xattr-sys"
 563 namespaces. Keys for the "xattr" namespace are constructed by stripping
 564 away the "user." prefix from the extended user attribute, and prepending
 565 "xattr::". Keys for the "xattr-sys" namespace are constructed by
 566 concatenating "xattr-sys::" with the extended attribute name. All extended
 567 attribute values are returned as hex-encoded strings in which bytes outside
 568 the ASCII range are encoded as hexadecimal escape sequences of the form
 569 \x<em class="replaceable"><code>nn</code></em>.
 570 </p>
 571 </div>
 572 <div class="refsect1">
 573 <a name="gio-GFileAttribute.details"></a><h2>Details</h2>
 574 <div class="refsect2">
 575 <a name="GFileAttributeType"></a><h3>enum GFileAttributeType</h3>
 576 <pre class="programlisting">typedef enum {
 577   G_FILE_ATTRIBUTE_TYPE_INVALID = 0,
 578   G_FILE_ATTRIBUTE_TYPE_STRING,
 579   G_FILE_ATTRIBUTE_TYPE_BYTE_STRING, /* zero terminated string of non-zero bytes */
 580   G_FILE_ATTRIBUTE_TYPE_BOOLEAN,
 581   G_FILE_ATTRIBUTE_TYPE_UINT32,
 582   G_FILE_ATTRIBUTE_TYPE_INT32,
 583   G_FILE_ATTRIBUTE_TYPE_UINT64,
 584   G_FILE_ATTRIBUTE_TYPE_INT64,
 585   G_FILE_ATTRIBUTE_TYPE_OBJECT,
 586   G_FILE_ATTRIBUTE_TYPE_STRINGV
 587 } GFileAttributeType;
 588 </pre>
 589 <p>
 590 The data types for file attributes.
 591 </p>
 592 <div class="variablelist"><table border="0">
 593 <col align="left" valign="top">
 594 <tbody>
 595 <tr>
 596 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-INVALID:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INVALID</code></span></p></td>
 597 <td>indicates an invalid or uninitalized type.
 598 </td>
 599 </tr>
 600 <tr>
 601 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-STRING:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_STRING</code></span></p></td>
 602 <td>a null terminated UTF8 string.
 603 </td>
 604 </tr>
 605 <tr>
 606 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-BYTE-STRING:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_BYTE_STRING</code></span></p></td>
 607 <td>a zero terminated string of non-zero bytes.
 608 </td>
 609 </tr>
 610 <tr>
 611 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-BOOLEAN:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_BOOLEAN</code></span></p></td>
 612 <td>a boolean value.
 613 </td>
 614 </tr>
 615 <tr>
 616 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-UINT32:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_UINT32</code></span></p></td>
 617 <td>an unsigned 4-byte/32-bit integer.
 618 </td>
 619 </tr>
 620 <tr>
 621 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-INT32:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INT32</code></span></p></td>
 622 <td>a signed 4-byte/32-bit integer.
 623 </td>
 624 </tr>
 625 <tr>
 626 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-UINT64:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_UINT64</code></span></p></td>
 627 <td>an unsigned 8-byte/64-bit integer.
 628 </td>
 629 </tr>
 630 <tr>
 631 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-INT64:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INT64</code></span></p></td>
 632 <td>a signed 8-byte/64-bit integer.
 633 </td>
 634 </tr>
 635 <tr>
 636 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-OBJECT:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_OBJECT</code></span></p></td>
 637 <td>a <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>.
 638 </td>
 639 </tr>
 640 <tr>
 641 <td><p><a name="G-FILE-ATTRIBUTE-TYPE-STRINGV:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_TYPE_STRINGV</code></span></p></td>
 642 <td>a <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated char **. Since 2.22
 643 </td>
 644 </tr>
 645 </tbody>
 646 </table></div>
 647 </div>
 648 <hr>
 649 <div class="refsect2">
 650 <a name="GFileAttributeInfoFlags"></a><h3>enum GFileAttributeInfoFlags</h3>
 651 <pre class="programlisting">typedef enum {
 652   G_FILE_ATTRIBUTE_INFO_NONE            = 0,
 653   G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE  = (1 &lt;&lt; 0),
 654   G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED = (1 &lt;&lt; 1)
 655 } GFileAttributeInfoFlags;
 656 </pre>
 657 <p>
 658 Flags specifying the behaviour of an attribute.
 659 </p>
 660 <div class="variablelist"><table border="0">
 661 <col align="left" valign="top">
 662 <tbody>
 663 <tr>
 664 <td><p><a name="G-FILE-ATTRIBUTE-INFO-NONE:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_INFO_NONE</code></span></p></td>
 665 <td>no flags set.
 666 </td>
 667 </tr>
 668 <tr>
 669 <td><p><a name="G-FILE-ATTRIBUTE-INFO-COPY-WITH-FILE:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE</code></span></p></td>
 670 <td>copy the attribute values when the file is copied.
 671 </td>
 672 </tr>
 673 <tr>
 674 <td><p><a name="G-FILE-ATTRIBUTE-INFO-COPY-WHEN-MOVED:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED</code></span></p></td>
 675 <td>copy the attribute values when the file is moved.
 676 </td>
 677 </tr>
 678 </tbody>
 679 </table></div>
 680 </div>
 681 <hr>
 682 <div class="refsect2">
 683 <a name="GFileAttributeStatus"></a><h3>enum GFileAttributeStatus</h3>
 684 <pre class="programlisting">typedef enum {
 685   G_FILE_ATTRIBUTE_STATUS_UNSET = 0,
 686   G_FILE_ATTRIBUTE_STATUS_SET,
 687   G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING
 688 } GFileAttributeStatus;
 689 </pre>
 690 <p>
 691 Used by <a class="link" href="GFile.html#g-file-set-attributes-from-info" title="g_file_set_attributes_from_info ()"><code class="function">g_file_set_attributes_from_info()</code></a> when setting file attributes.
 692 </p>
 693 <div class="variablelist"><table border="0">
 694 <col align="left" valign="top">
 695 <tbody>
 696 <tr>
 697 <td><p><a name="G-FILE-ATTRIBUTE-STATUS-UNSET:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_STATUS_UNSET</code></span></p></td>
 698 <td>Attribute value is unset (empty).
 699 </td>
 700 </tr>
 701 <tr>
 702 <td><p><a name="G-FILE-ATTRIBUTE-STATUS-SET:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_STATUS_SET</code></span></p></td>
 703 <td>Attribute value is set.
 704 </td>
 705 </tr>
 706 <tr>
 707 <td><p><a name="G-FILE-ATTRIBUTE-STATUS-ERROR-SETTING:CAPS"></a><span class="term"><code class="literal">G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING</code></span></p></td>
 708 <td>Indicates an error in setting the value.
 709 </td>
 710 </tr>
 711 </tbody>
 712 </table></div>
 713 </div>
 714 <hr>
 715 <div class="refsect2">
 716 <a name="GFileAttributeInfo"></a><h3>GFileAttributeInfo</h3>
 717 <pre class="programlisting">typedef struct {
 718   char                    *name;
 719   GFileAttributeType       type;
 720   GFileAttributeInfoFlags  flags;
 721 } GFileAttributeInfo;
 722 </pre>
 723 <p>
 724 Information about a specific attribute.
 725 </p>
 726 <div class="variablelist"><table border="0">
 727 <col align="left" valign="top">
 728 <tbody>
 729 <tr>
 730 <td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GFileAttributeInfo.name"></a>name</code></em>;</span></p></td>
 731 <td>the name of the attribute.</td>
 732 </tr>
 733 <tr>
 734 <td><p><span class="term"><a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a> <em class="structfield"><code><a name="GFileAttributeInfo.type"></a>type</code></em>;</span></p></td>
 735 <td>the <a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a> type of the attribute.</td>
 736 </tr>
 737 <tr>
 738 <td><p><span class="term"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoFlags" title="enum GFileAttributeInfoFlags"><span class="type">GFileAttributeInfoFlags</span></a> <em class="structfield"><code><a name="GFileAttributeInfo.flags"></a>flags</code></em>;</span></p></td>
 739 <td>a set of <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoFlags" title="enum GFileAttributeInfoFlags"><span class="type">GFileAttributeInfoFlags</span></a>.</td>
 740 </tr>
 741 </tbody>
 742 </table></div>
 743 </div>
 744 <hr>
 745 <div class="refsect2">
 746 <a name="GFileAttributeInfoList"></a><h3>GFileAttributeInfoList</h3>
 747 <pre class="programlisting">typedef struct {
 748   GFileAttributeInfo *infos;
 749   int                 n_infos;
 750 } GFileAttributeInfoList;
 751 </pre>
 752 <p>
 753 Acts as a lightweight registry for possible valid file attributes.
 754 The registry stores Key-Value pair formats as <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="type">GFileAttributeInfo</span></a>s.
 755 </p>
 756 <div class="variablelist"><table border="0">
 757 <col align="left" valign="top">
 758 <tbody>
 759 <tr>
 760 <td><p><span class="term"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="type">GFileAttributeInfo</span></a> *<em class="structfield"><code><a name="GFileAttributeInfoList.infos"></a>infos</code></em>;</span></p></td>
 761 <td>an array of <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="type">GFileAttributeInfo</span></a>s.</td>
 762 </tr>
 763 <tr>
 764 <td><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="GFileAttributeInfoList.n-infos"></a>n_infos</code></em>;</span></p></td>
 765 <td>the number of values in the array.</td>
 766 </tr>
 767 </tbody>
 768 </table></div>
 769 </div>
 770 <hr>
 771 <div class="refsect2">
 772 <a name="g-file-attribute-info-list-new"></a><h3>g_file_attribute_info_list_new ()</h3>
 773 <pre class="programlisting"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * g_file_attribute_info_list_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 774 <p>
 775 Creates a new file attribute info list.
 776 </p>
 777 <div class="variablelist"><table border="0">
 778 <col align="left" valign="top">
 779 <tbody><tr>
 780 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 781 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a>.</td>
 782 </tr></tbody>
 783 </table></div>
 784 </div>
 785 <hr>
 786 <div class="refsect2">
 787 <a name="g-file-attribute-info-list-ref"></a><h3>g_file_attribute_info_list_ref ()</h3>
 788 <pre class="programlisting"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * g_file_attribute_info_list_ref (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>);</pre>
 789 <p>
 790 References a file attribute info list.
 791 </p>
 792 <div class="variablelist"><table border="0">
 793 <col align="left" valign="top">
 794 <tbody>
 795 <tr>
 796 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
 797 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> to reference.</td>
 798 </tr>
 799 <tr>
 800 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 801 <td>
 802 <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.</td>
 803 </tr>
 804 </tbody>
 805 </table></div>
 806 </div>
 807 <hr>
 808 <div class="refsect2">
 809 <a name="g-file-attribute-info-list-unref"></a><h3>g_file_attribute_info_list_unref ()</h3>
 810 <pre class="programlisting"><span class="returnvalue">void</span>                g_file_attribute_info_list_unref    (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>);</pre>
 811 <p>
 812 Removes a reference from the given <em class="parameter"><code>list</code></em>. If the reference count
 813 falls to zero, the <em class="parameter"><code>list</code></em> is deleted.
 814 </p>
 815 <div class="variablelist"><table border="0">
 816 <col align="left" valign="top">
 817 <tbody><tr>
 818 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
 819 <td>The <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> to unreference.</td>
 820 </tr></tbody>
 821 </table></div>
 822 </div>
 823 <hr>
 824 <div class="refsect2">
 825 <a name="g-file-attribute-info-list-dup"></a><h3>g_file_attribute_info_list_dup ()</h3>
 826 <pre class="programlisting"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="returnvalue">GFileAttributeInfoList</span></a> * g_file_attribute_info_list_dup (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>);</pre>
 827 <p>
 828 Makes a duplicate of a file attribute info list.
 829 </p>
 830 <div class="variablelist"><table border="0">
 831 <col align="left" valign="top">
 832 <tbody>
 833 <tr>
 834 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
 835 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> to duplicate.</td>
 836 </tr>
 837 <tr>
 838 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 839 <td>a copy of the given <em class="parameter"><code>list</code></em>.</td>
 840 </tr>
 841 </tbody>
 842 </table></div>
 843 </div>
 844 <hr>
 845 <div class="refsect2">
 846 <a name="g-file-attribute-info-list-lookup"></a><h3>g_file_attribute_info_list_lookup ()</h3>
 847 <pre class="programlisting">const <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="returnvalue">GFileAttributeInfo</span></a> * g_file_attribute_info_list_lookup
 848                                                         (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>,
 849                                                          <em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
 850 <p>
 851 Gets the file attribute with the name <em class="parameter"><code>name</code></em> from <em class="parameter"><code>list</code></em>.
 852 </p>
 853 <div class="variablelist"><table border="0">
 854 <col align="left" valign="top">
 855 <tbody>
 856 <tr>
 857 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
 858 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a>.</td>
 859 </tr>
 860 <tr>
 861 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 862 <td>the name of the attribute to lookup.</td>
 863 </tr>
 864 <tr>
 865 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 866 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfo" title="GFileAttributeInfo"><span class="type">GFileAttributeInfo</span></a> for the <em class="parameter"><code>name</code></em>, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an
 867 attribute isn't found.</td>
 868 </tr>
 869 </tbody>
 870 </table></div>
 871 </div>
 872 <hr>
 873 <div class="refsect2">
 874 <a name="g-file-attribute-info-list-add"></a><h3>g_file_attribute_info_list_add ()</h3>
 875 <pre class="programlisting"><span class="returnvalue">void</span>                g_file_attribute_info_list_add      (<em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a> *list</code></em>,
 876                                                          <em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
 877                                                          <em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a> type</code></em>,
 878                                                          <em class="parameter"><code><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoFlags" title="enum GFileAttributeInfoFlags"><span class="type">GFileAttributeInfoFlags</span></a> flags</code></em>);</pre>
 879 <p>
 880 Adds a new attribute with <em class="parameter"><code>name</code></em> to the <em class="parameter"><code>list</code></em>, setting
 881 its <em class="parameter"><code>type</code></em> and <em class="parameter"><code>flags</code></em>.
 882 </p>
 883 <div class="variablelist"><table border="0">
 884 <col align="left" valign="top">
 885 <tbody>
 886 <tr>
 887 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
 888 <td>a <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList"><span class="type">GFileAttributeInfoList</span></a>.</td>
 889 </tr>
 890 <tr>
 891 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 892 <td>the name of the attribute to add.</td>
 893 </tr>
 894 <tr>
 895 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
 896 <td>the <a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType"><span class="type">GFileAttributeType</span></a> for the attribute.</td>
 897 </tr>
 898 <tr>
 899 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 900 <td>
 901 <a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoFlags" title="enum GFileAttributeInfoFlags"><span class="type">GFileAttributeInfoFlags</span></a> for the attribute.</td>
 902 </tr>
 903 </tbody>
 904 </table></div>
 905 </div>
 906 </div>
 907 <div class="refsect1">
 908 <a name="gio-GFileAttribute.see-also"></a><h2>See Also</h2>
 909 <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>, <a class="link" href="GFileInfo.html" title="GFileInfo"><span class="type">GFileInfo</span></a>
 910 </div>
 911 </div>
 912 <div class="footer">
 913 <hr>
 914           Generated by GTK-Doc V1.18</div>
 915 </body>
 916 </html>