gio/gfileinfo.h

   1 /* GIO - GLib Input, Output and Streaming Library
   2  *
   3  * Copyright (C) 2006-2007 Red Hat, Inc.
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2.1 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General
  16  * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
  17  *
  18  * Author: Alexander Larsson <alexl@redhat.com>
  19  */
  20
  21 #ifndef __G_FILE_INFO_H__
  22 #define __G_FILE_INFO_H__
  23
  24 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
  25 #error "Only <gio/gio.h> can be included directly."
  26 #endif
  27
  28 #include <gio/giotypes.h>
  29
  30 G_BEGIN_DECLS
  31
  32 #define G_TYPE_FILE_INFO         (g_file_info_get_type ())
  33 #define G_FILE_INFO(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_FILE_INFO, GFileInfo))
  34 #define G_FILE_INFO_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_FILE_INFO, GFileInfoClass))
  35 #define G_IS_FILE_INFO(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_FILE_INFO))
  36 #define G_IS_FILE_INFO_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_FILE_INFO))
  37 #define G_FILE_INFO_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_FILE_INFO, GFileInfoClass))
  38
  39 /**
  40  * GFileInfo:
  41  *
  42  * Stores information about a file system object referenced by a #GFile.
  43  **/
  44 typedef struct _GFileInfoClass   GFileInfoClass;
  45
  46
  47 /* Common Attributes:  */
  48 /**
  49  * G_FILE_ATTRIBUTE_STANDARD_TYPE:
  50  *
  51  * A key in the "standard" namespace for storing file types.
  52  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
  53  * The value for this key should contain a #GFileType.
  54  **/
  55 #define G_FILE_ATTRIBUTE_STANDARD_TYPE "standard::type"                     /* uint32 (GFileType) */
  56
  57 /**
  58  * G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN:
  59  *
  60  * A key in the "standard" namespace for checking if a file is hidden.
  61  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
  62  **/
  63 #define G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN "standard::is-hidden"           /* boolean */
  64
  65 /**
  66  * G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP:
  67  *
  68  * A key in the "standard" namespace for checking if a file is a backup file.
  69  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
  70  **/
  71 #define G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP "standard::is-backup"           /* boolean */
  72
  73 /**
  74  * G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK:
  75  *
  76  * A key in the "standard" namespace for checking if the file is a symlink.
  77  * Typically the actual type is something else, if we followed the symlink
  78  * to get the type.
  79  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
  80  **/
  81 #define G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK "standard::is-symlink"         /* boolean */
  82
  83 /**
  84  * G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL:
  85  *
  86  * A key in the "standard" namespace for checking if a file is virtual.
  87  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
  88  **/
  89 #define G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL "standard::is-virtual"         /* boolean */
  90
  91 /**
  92  * G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE:
  93  *
  94  * A key in the "standard" namespace for checking if a file is
  95  * volatile. This is meant for opaque, non-POSIX-like backends to
  96  * indicate that the URI is not persistent. Applications should look
  97  * at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI.
  98  *
  99  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 100  *
 101  * Since: 2.46
 102  **/
 103 #define G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE "standard::is-volatile"      /* boolean */
 104
 105 /**
 106  * G_FILE_ATTRIBUTE_STANDARD_NAME:
 107  *
 108  * A key in the "standard" namespace for getting the name of the file.
 109  * The name is the on-disk filename which may not be in any known encoding,
 110  * and can thus not be generally displayed as is.
 111  * Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the
 112  * name in a user interface.
 113  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
 114  **/
 115 #define G_FILE_ATTRIBUTE_STANDARD_NAME "standard::name"                     /* byte string */
 116
 117 /**
 118  * G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME:
 119  *
 120  * A key in the "standard" namespace for getting the display name of the file.
 121  * A display name is guaranteed to be in UTF8 and can thus be displayed in
 122  * the UI.
 123  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 124  **/
 125 #define G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME "standard::display-name"     /* string */
 126
 127 /**
 128  * G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME:
 129  *
 130  * A key in the "standard" namespace for edit name of the file.
 131  * An edit name is similar to the display name, but it is meant to be
 132  * used when you want to rename the file in the UI. The display name
 133  * might contain information you don't want in the new filename (such as
 134  * "(invalid unicode)" if the filename was in an invalid encoding).
 135  *
 136  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 137  **/
 138 #define G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME "standard::edit-name"           /* string */
 139
 140 /**
 141  * G_FILE_ATTRIBUTE_STANDARD_COPY_NAME:
 142  *
 143  * A key in the "standard" namespace for getting the copy name of the file.
 144  * The copy name is an optional version of the name. If available it's always
 145  * in UTF8, and corresponds directly to the original filename (only transcoded to
 146  * UTF8). This is useful if you want to copy the file to another filesystem that
 147  * might have a different encoding. If the filename is not a valid string in the
 148  * encoding selected for the filesystem it is in then the copy name will not be set.
 149  *
 150  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 151  **/
 152 #define G_FILE_ATTRIBUTE_STANDARD_COPY_NAME "standard::copy-name"           /* string */
 153
 154 /**
 155  * G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION:
 156  *
 157  * A key in the "standard" namespace for getting the description of the file.
 158  * The description is a utf8 string that describes the file, generally containing
 159  * the filename, but can also contain furter information. Example descriptions
 160  * could be "filename (on hostname)" for a remote file or "filename (in trash)"
 161  * for a file in the trash. This is useful for instance as the window title
 162  * when displaying a directory or for a bookmarks menu.
 163  *
 164  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 165  **/
 166 #define G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION "standard::description"        /* string */
 167
 168 /**
 169  * G_FILE_ATTRIBUTE_STANDARD_ICON:
 170  *
 171  * A key in the "standard" namespace for getting the icon for the file.
 172  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
 173  * The value for this key should contain a #GIcon.
 174  **/
 175 #define G_FILE_ATTRIBUTE_STANDARD_ICON "standard::icon"                     /* object (GIcon) */
 176
 177 /**
 178  * G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON:
 179  *
 180  * A key in the "standard" namespace for getting the symbolic icon for the file.
 181  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
 182  * The value for this key should contain a #GIcon.
 183  *
 184  * Since: 2.34
 185  **/
 186 #define G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON "standard::symbolic-icon"   /* object (GIcon) */
 187
 188 /**
 189  * G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE:
 190  *
 191  * A key in the "standard" namespace for getting the content type of the file.
 192  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 193  * The value for this key should contain a valid content type.
 194  **/
 195 #define G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE "standard::content-type"     /* string */
 196
 197 /**
 198  * G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE:
 199  *
 200  * A key in the "standard" namespace for getting the fast content type.
 201  * The fast content type isn't as reliable as the regular one, as it
 202  * only uses the filename to guess it, but it is faster to calculate than the
 203  * regular content type.
 204  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 205  *
 206  **/
 207 #define G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE "standard::fast-content-type" /* string */
 208
 209 /**
 210  * G_FILE_ATTRIBUTE_STANDARD_SIZE:
 211  *
 212  * A key in the "standard" namespace for getting the file's size (in bytes).
 213  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
 214  **/
 215 #define G_FILE_ATTRIBUTE_STANDARD_SIZE "standard::size"                     /* uint64 */
 216
 217 /**
 218  * G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE:
 219  *
 220  * A key in the "standard" namespace for getting the amount of disk space
 221  * that is consumed by the file (in bytes).  This will generally be larger
 222  * than the file size (due to block size overhead) but can occasionally be
 223  * smaller (for example, for sparse files).
 224  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
 225  *
 226  * Since: 2.20
 227  **/
 228 #define G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE "standard::allocated-size" /* uint64 */
 229
 230 /**
 231  * G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET:
 232  *
 233  * A key in the "standard" namespace for getting the symlink target, if the file
 234  * is a symlink. Corresponding #GFileAttributeType is
 235  * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
 236  **/
 237 #define G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET "standard::symlink-target" /* byte string */
 238
 239 /**
 240  * G_FILE_ATTRIBUTE_STANDARD_TARGET_URI:
 241  *
 242  * A key in the "standard" namespace for getting the target URI for the file, in
 243  * the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files.
 244  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 245  **/
 246 #define G_FILE_ATTRIBUTE_STANDARD_TARGET_URI "standard::target-uri"         /* string */
 247
 248 /**
 249  * G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER:
 250  *
 251  * A key in the "standard" namespace for setting the sort order of a file.
 252  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32.
 253  * An example use would be in file managers, which would use this key
 254  * to set the order files are displayed. Files with smaller sort order
 255  * should be sorted first, and files without sort order as if sort order
 256  * was zero.
 257  **/
 258 #define G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER "standard::sort-order"         /* int32  */
 259
 260 /* Entity tags, used to avoid missing updates on save */
 261
 262 /**
 263  * G_FILE_ATTRIBUTE_ETAG_VALUE:
 264  *
 265  * A key in the "etag" namespace for getting the value of the file's
 266  * entity tag. Corresponding #GFileAttributeType is
 267  * %G_FILE_ATTRIBUTE_TYPE_STRING.
 268  **/
 269 #define G_FILE_ATTRIBUTE_ETAG_VALUE "etag::value"                 /* string */
 270
 271 /* File identifier, for e.g. avoiding loops when doing recursive
 272  * directory scanning
 273  */
 274
 275 /**
 276  * G_FILE_ATTRIBUTE_ID_FILE:
 277  *
 278  * A key in the "id" namespace for getting a file identifier.
 279  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 280  * An example use would be during listing files, to avoid recursive
 281  * directory scanning.
 282  **/
 283 #define G_FILE_ATTRIBUTE_ID_FILE "id::file"                     /* string */
 284
 285 /**
 286  * G_FILE_ATTRIBUTE_ID_FILESYSTEM:
 287  *
 288  * A key in the "id" namespace for getting the file system identifier.
 289  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 290  * An example use would be during drag and drop to see if the source
 291  * and target are on the same filesystem (default to move) or not (default
 292  * to copy).
 293  **/
 294 #define G_FILE_ATTRIBUTE_ID_FILESYSTEM "id::filesystem"         /* string */
 295
 296 /* Calculated Access Rights for current user */
 297
 298 /**
 299  * G_FILE_ATTRIBUTE_ACCESS_CAN_READ:
 300  *
 301  * A key in the "access" namespace for getting read privileges.
 302  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 303  * This attribute will be %TRUE if the user is able to read the file.
 304  **/
 305 #define G_FILE_ATTRIBUTE_ACCESS_CAN_READ "access::can-read"       /* boolean */
 306
 307 /**
 308  * G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE:
 309  *
 310  * A key in the "access" namespace for getting write privileges.
 311  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 312  * This attribute will be %TRUE if the user is able to write to the file.
 313  **/
 314 #define G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE "access::can-write"     /* boolean */
 315
 316 /**
 317  * G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE:
 318  *
 319  * A key in the "access" namespace for getting execution privileges.
 320  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 321  * This attribute will be %TRUE if the user is able to execute the file.
 322  **/
 323 #define G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE "access::can-execute" /* boolean */
 324
 325 /**
 326  * G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE:
 327  *
 328  * A key in the "access" namespace for checking deletion privileges.
 329  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 330  * This attribute will be %TRUE if the user is able to delete the file.
 331  **/
 332 #define G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE "access::can-delete"   /* boolean */
 333
 334 /**
 335  * G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH:
 336  *
 337  * A key in the "access" namespace for checking trashing privileges.
 338  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 339  * This attribute will be %TRUE if the user is able to move the file to
 340  * the trash.
 341  **/
 342 #define G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH "access::can-trash"     /* boolean */
 343
 344 /**
 345  * G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME:
 346  *
 347  * A key in the "access" namespace for checking renaming privileges.
 348  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 349  * This attribute will be %TRUE if the user is able to rename the file.
 350  **/
 351 #define G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME "access::can-rename"   /* boolean */
 352
 353 /* TODO: Should we have special version for directories? can_enumerate, etc */
 354
 355 /* Mountable attributes */
 356
 357 /**
 358  * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT:
 359  *
 360  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable.
 361  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 362  **/
 363 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT "mountable::can-mount"     /* boolean */
 364
 365 /**
 366  * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT:
 367  *
 368  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE)  is unmountable.
 369  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 370  **/
 371 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT "mountable::can-unmount" /* boolean */
 372
 373 /**
 374  * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT:
 375  *
 376  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected.
 377  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 378  **/
 379 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT "mountable::can-eject"     /* boolean */
 380
 381 /**
 382  * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE:
 383  *
 384  * A key in the "mountable" namespace for getting the unix device.
 385  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 386  **/
 387 #define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE "mountable::unix-device" /* uint32 */
 388
 389 /**
 390  * G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE:
 391  *
 392  * A key in the "mountable" namespace for getting the unix device file.
 393  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 394  *
 395  * Since: 2.22
 396  **/
 397 #define G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE "mountable::unix-device-file" /* string */
 398
 399 /**
 400  * G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI:
 401  *
 402  * A key in the "mountable" namespace for getting the HAL UDI for the mountable
 403  * file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 404  **/
 405 #define G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI "mountable::hal-udi"         /* string */
 406
 407 /**
 408  * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START:
 409  *
 410  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started.
 411  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 412  *
 413  * Since: 2.22
 414  */
 415 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START "mountable::can-start"     /* boolean */
 416
 417 /**
 418  * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED:
 419  *
 420  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started
 421  * degraded.
 422  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 423  *
 424  * Since: 2.22
 425  */
 426 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED "mountable::can-start-degraded"     /* boolean */
 427
 428 /**
 429  * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP:
 430  *
 431  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped.
 432  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 433  *
 434  * Since: 2.22
 435  */
 436 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP "mountable::can-stop"      /* boolean */
 437
 438 /**
 439  * G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE:
 440  *
 441  * A key in the "mountable" namespace for getting the #GDriveStartStopType.
 442  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 443  *
 444  * Since: 2.22
 445  */
 446 #define G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE "mountable::start-stop-type" /* uint32 (GDriveStartStopType) */
 447
 448 /**
 449  * G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL:
 450  *
 451  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled.
 452  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 453  *
 454  * Since: 2.22
 455  */
 456 #define G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL "mountable::can-poll"      /* boolean */
 457
 458 /**
 459  * G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC:
 460  *
 461  * A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE)
 462  * is automatically polled for media.
 463  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 464  *
 465  * Since: 2.22
 466  */
 467 #define G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC "mountable::is-media-check-automatic"      /* boolean */
 468
 469 /* Time attributes */
 470
 471 /**
 472  * G_FILE_ATTRIBUTE_TIME_MODIFIED:
 473  *
 474  * A key in the "time" namespace for getting the time the file was last
 475  * modified. Corresponding #GFileAttributeType is
 476  * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
 477  * file was modified, in seconds since the UNIX epoch.
 478  **/
 479 #define G_FILE_ATTRIBUTE_TIME_MODIFIED "time::modified"           /* uint64 */
 480
 481 /**
 482  * G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC:
 483  *
 484  * A key in the "time" namespace for getting the microseconds of the time
 485  * the file was last modified. This should be used in conjunction with
 486  * #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
 487  * %G_FILE_ATTRIBUTE_TYPE_UINT32.
 488  **/
 489 #define G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC "time::modified-usec" /* uint32 */
 490
 491 /**
 492  * G_FILE_ATTRIBUTE_TIME_ACCESS:
 493  *
 494  * A key in the "time" namespace for getting the time the file was last
 495  * accessed. Corresponding #GFileAttributeType is
 496  * %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
 497  * file was last accessed, in seconds since the UNIX epoch.
 498  **/
 499 #define G_FILE_ATTRIBUTE_TIME_ACCESS "time::access"               /* uint64 */
 500
 501 /**
 502  * G_FILE_ATTRIBUTE_TIME_ACCESS_USEC:
 503  *
 504  * A key in the "time" namespace for getting the microseconds of the time
 505  * the file was last accessed. This should be used in conjunction with
 506  * #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
 507  * %G_FILE_ATTRIBUTE_TYPE_UINT32.
 508  **/
 509 #define G_FILE_ATTRIBUTE_TIME_ACCESS_USEC "time::access-usec"     /* uint32 */
 510
 511 /**
 512  * G_FILE_ATTRIBUTE_TIME_CHANGED:
 513  *
 514  * A key in the "time" namespace for getting the time the file was last
 515  * changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
 516  * and contains the time since the file was last changed, in seconds since the
 517  * UNIX epoch.
 518  *
 519  * This corresponds to the traditional UNIX ctime.
 520  **/
 521 #define G_FILE_ATTRIBUTE_TIME_CHANGED "time::changed"             /* uint64 */
 522
 523 /**
 524  * G_FILE_ATTRIBUTE_TIME_CHANGED_USEC:
 525  *
 526  * A key in the "time" namespace for getting the microseconds of the time
 527  * the file was last changed. This should be used in conjunction with
 528  * #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
 529  * %G_FILE_ATTRIBUTE_TYPE_UINT32.
 530  **/
 531 #define G_FILE_ATTRIBUTE_TIME_CHANGED_USEC "time::changed-usec"   /* uint32 */
 532
 533 /**
 534  * G_FILE_ATTRIBUTE_TIME_CREATED:
 535  *
 536  * A key in the "time" namespace for getting the time the file was created.
 537  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
 538  * and contains the time since the file was created, in seconds since the UNIX
 539  * epoch.
 540  *
 541  * This corresponds to the NTFS ctime.
 542  **/
 543 #define G_FILE_ATTRIBUTE_TIME_CREATED "time::created"             /* uint64 */
 544
 545 /**
 546  * G_FILE_ATTRIBUTE_TIME_CREATED_USEC:
 547  *
 548  * A key in the "time" namespace for getting the microseconds of the time
 549  * the file was created. This should be used in conjunction with
 550  * #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
 551  * %G_FILE_ATTRIBUTE_TYPE_UINT32.
 552  **/
 553 #define G_FILE_ATTRIBUTE_TIME_CREATED_USEC "time::created-usec"   /* uint32 */
 554
 555 /* Unix specific attributes */
 556
 557 /**
 558  * G_FILE_ATTRIBUTE_UNIX_DEVICE:
 559  *
 560  * A key in the "unix" namespace for getting the device id of the device the
 561  * file is located on (see stat() documentation). This attribute is only
 562  * available for UNIX file systems. Corresponding #GFileAttributeType is
 563  * %G_FILE_ATTRIBUTE_TYPE_UINT32.
 564  **/
 565 #define G_FILE_ATTRIBUTE_UNIX_DEVICE "unix::device"               /* uint32 */
 566
 567 /**
 568  * G_FILE_ATTRIBUTE_UNIX_INODE:
 569  *
 570  * A key in the "unix" namespace for getting the inode of the file.
 571  * This attribute is only available for UNIX file systems. Corresponding
 572  * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
 573  **/
 574 #define G_FILE_ATTRIBUTE_UNIX_INODE "unix::inode"                 /* uint64 */
 575
 576 /**
 577  * G_FILE_ATTRIBUTE_UNIX_MODE:
 578  *
 579  * A key in the "unix" namespace for getting the mode of the file
 580  * (e.g. whether the file is a regular file, symlink, etc). See lstat()
 581  * documentation. This attribute is only available for UNIX file systems.
 582  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 583  **/
 584 #define G_FILE_ATTRIBUTE_UNIX_MODE "unix::mode"                   /* uint32 */
 585
 586 /**
 587  * G_FILE_ATTRIBUTE_UNIX_NLINK:
 588  *
 589  * A key in the "unix" namespace for getting the number of hard links
 590  * for a file. See lstat() documentation. This attribute is only available
 591  * for UNIX file systems. Corresponding #GFileAttributeType is
 592  * %G_FILE_ATTRIBUTE_TYPE_UINT32.
 593  **/
 594 #define G_FILE_ATTRIBUTE_UNIX_NLINK "unix::nlink"                 /* uint32 */
 595
 596 /**
 597  * G_FILE_ATTRIBUTE_UNIX_UID:
 598  *
 599  * A key in the "unix" namespace for getting the user ID for the file.
 600  * This attribute is only available for UNIX file systems.
 601  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 602  **/
 603 #define G_FILE_ATTRIBUTE_UNIX_UID "unix::uid"                     /* uint32 */
 604
 605 /**
 606  * G_FILE_ATTRIBUTE_UNIX_GID:
 607  *
 608  * A key in the "unix" namespace for getting the group ID for the file.
 609  * This attribute is only available for UNIX file systems.
 610  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 611  **/
 612 #define G_FILE_ATTRIBUTE_UNIX_GID "unix::gid"                     /* uint32 */
 613
 614 /**
 615  * G_FILE_ATTRIBUTE_UNIX_RDEV:
 616  *
 617  * A key in the "unix" namespace for getting the device ID for the file
 618  * (if it is a special file). See lstat() documentation. This attribute
 619  * is only available for UNIX file systems. Corresponding #GFileAttributeType
 620  * is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 621  **/
 622 #define G_FILE_ATTRIBUTE_UNIX_RDEV "unix::rdev"                   /* uint32 */
 623
 624 /**
 625  * G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE:
 626  *
 627  * A key in the "unix" namespace for getting the block size for the file
 628  * system. This attribute is only available for UNIX file systems.
 629  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 630  **/
 631 #define G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE "unix::block-size"       /* uint32 */
 632
 633 /**
 634  * G_FILE_ATTRIBUTE_UNIX_BLOCKS:
 635  *
 636  * A key in the "unix" namespace for getting the number of blocks allocated
 637  * for the file. This attribute is only available for UNIX file systems.
 638  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.
 639  **/
 640 #define G_FILE_ATTRIBUTE_UNIX_BLOCKS "unix::blocks"               /* uint64 */
 641
 642 /**
 643  * G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT:
 644  *
 645  * A key in the "unix" namespace for checking if the file represents a
 646  * UNIX mount point. This attribute is %TRUE if the file is a UNIX mount
 647  * point. Since 2.58, `/` is considered to be a mount point.
 648  * This attribute is only available for UNIX file systems.
 649  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 650  **/
 651 #define G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT "unix::is-mountpoint" /* boolean */
 652
 653 /* DOS specific attributes */
 654
 655 /**
 656  * G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE:
 657  *
 658  * A key in the "dos" namespace for checking if the file's archive flag
 659  * is set. This attribute is %TRUE if the archive flag is set. This attribute
 660  * is only available for DOS file systems. Corresponding #GFileAttributeType
 661  * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 662  **/
 663 #define G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE "dos::is-archive"         /* boolean */
 664
 665 /**
 666  * G_FILE_ATTRIBUTE_DOS_IS_SYSTEM:
 667  *
 668  * A key in the "dos" namespace for checking if the file's backup flag
 669  * is set. This attribute is %TRUE if the backup flag is set. This attribute
 670  * is only available for DOS file systems. Corresponding #GFileAttributeType
 671  * is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 672  **/
 673 #define G_FILE_ATTRIBUTE_DOS_IS_SYSTEM "dos::is-system"           /* boolean */
 674
 675 /* Owner attributes */
 676
 677 /**
 678  * G_FILE_ATTRIBUTE_OWNER_USER:
 679  *
 680  * A key in the "owner" namespace for getting the user name of the
 681  * file's owner. Corresponding #GFileAttributeType is
 682  * %G_FILE_ATTRIBUTE_TYPE_STRING.
 683  **/
 684 #define G_FILE_ATTRIBUTE_OWNER_USER "owner::user"                 /* string */
 685
 686 /**
 687  * G_FILE_ATTRIBUTE_OWNER_USER_REAL:
 688  *
 689  * A key in the "owner" namespace for getting the real name of the
 690  * user that owns the file. Corresponding #GFileAttributeType is
 691  * %G_FILE_ATTRIBUTE_TYPE_STRING.
 692  **/
 693 #define G_FILE_ATTRIBUTE_OWNER_USER_REAL "owner::user-real"       /* string */
 694
 695 /**
 696  * G_FILE_ATTRIBUTE_OWNER_GROUP:
 697  *
 698  * A key in the "owner" namespace for getting the file owner's group.
 699  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 700  **/
 701 #define G_FILE_ATTRIBUTE_OWNER_GROUP "owner::group"               /* string */
 702
 703 /* Thumbnails */
 704
 705 /**
 706  * G_FILE_ATTRIBUTE_THUMBNAIL_PATH:
 707  *
 708  * A key in the "thumbnail" namespace for getting the path to the thumbnail
 709  * image. Corresponding #GFileAttributeType is
 710  * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
 711  **/
 712 #define G_FILE_ATTRIBUTE_THUMBNAIL_PATH "thumbnail::path"         /* bytestring */
 713 /**
 714  * G_FILE_ATTRIBUTE_THUMBNAILING_FAILED:
 715  *
 716  * A key in the "thumbnail" namespace for checking if thumbnailing failed.
 717  * This attribute is %TRUE if thumbnailing failed. Corresponding
 718  * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 719  **/
 720 #define G_FILE_ATTRIBUTE_THUMBNAILING_FAILED "thumbnail::failed"         /* boolean */
 721 /**
 722  * G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID:
 723  *
 724  * A key in the "thumbnail" namespace for checking whether the thumbnail is outdated.
 725  * This attribute is %TRUE if the thumbnail is up-to-date with the file it represents,
 726  * and %FALSE if the file has been modified since the thumbnail was generated.
 727  *
 728  * If %G_FILE_ATTRIBUTE_THUMBNAILING_FAILED is %TRUE and this attribute is %FALSE,
 729  * it indicates that thumbnailing may be attempted again and may succeed.
 730  *
 731  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 732  *
 733  * Since: 2.40
 734  */
 735 #define G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID "thumbnail::is-valid"        /* boolean */
 736
 737 /* Preview */
 738
 739 /**
 740  * G_FILE_ATTRIBUTE_PREVIEW_ICON:
 741  *
 742  * A key in the "preview" namespace for getting a #GIcon that can be
 743  * used to get preview of the file. For example, it may be a low
 744  * resolution thumbnail without metadata. Corresponding
 745  * #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.  The value
 746  * for this key should contain a #GIcon.
 747  *
 748  * Since: 2.20
 749  **/
 750 #define G_FILE_ATTRIBUTE_PREVIEW_ICON "preview::icon"         /* object (GIcon) */
 751
 752 /* File system info (for g_file_get_filesystem_info) */
 753
 754 /**
 755  * G_FILE_ATTRIBUTE_FILESYSTEM_SIZE:
 756  *
 757  * A key in the "filesystem" namespace for getting the total size (in bytes) of the file system,
 758  * used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType
 759  * is %G_FILE_ATTRIBUTE_TYPE_UINT64.
 760  **/
 761 #define G_FILE_ATTRIBUTE_FILESYSTEM_SIZE "filesystem::size"                       /* uint64 */
 762
 763 /**
 764  * G_FILE_ATTRIBUTE_FILESYSTEM_FREE:
 765  *
 766  * A key in the "filesystem" namespace for getting the number of bytes of free space left on the
 767  * file system. Corresponding #GFileAttributeType is
 768  * %G_FILE_ATTRIBUTE_TYPE_UINT64.
 769  **/
 770 #define G_FILE_ATTRIBUTE_FILESYSTEM_FREE "filesystem::free"                       /* uint64 */
 771
 772 /**
 773  * G_FILE_ATTRIBUTE_FILESYSTEM_USED:
 774  *
 775  * A key in the "filesystem" namespace for getting the number of bytes of used on the
 776  * file system. Corresponding #GFileAttributeType is
 777  * %G_FILE_ATTRIBUTE_TYPE_UINT64.
 778  *
 779  * Since: 2.32
 780  */
 781 #define G_FILE_ATTRIBUTE_FILESYSTEM_USED "filesystem::used"                       /* uint64 */
 782
 783 /**
 784  * G_FILE_ATTRIBUTE_FILESYSTEM_TYPE:
 785  *
 786  * A key in the "filesystem" namespace for getting the file system's type.
 787  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 788  **/
 789 #define G_FILE_ATTRIBUTE_FILESYSTEM_TYPE "filesystem::type"                       /* string */
 790
 791 /**
 792  * G_FILE_ATTRIBUTE_FILESYSTEM_READONLY:
 793  *
 794  * A key in the "filesystem" namespace for checking if the file system
 795  * is read only. Is set to %TRUE if the file system is read only.
 796  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 797  **/
 798 #define G_FILE_ATTRIBUTE_FILESYSTEM_READONLY "filesystem::readonly"               /* boolean */
 799
 800 /**
 801  * G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW:
 802  *
 803  * A key in the "filesystem" namespace for hinting a file manager
 804  * application whether it should preview (e.g. thumbnail) files on the
 805  * file system. The value for this key contain a
 806  * #GFilesystemPreviewType.
 807  **/
 808 #define G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW "filesystem::use-preview"        /* uint32 (GFilesystemPreviewType) */
 809
 810 /**
 811  * G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE:
 812  *
 813  * A key in the "filesystem" namespace for checking if the file system
 814  * is remote. Is set to %TRUE if the file system is remote.
 815  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
 816  **/
 817 #define G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE "filesystem::remote"                   /* boolean */
 818
 819 /**
 820  * G_FILE_ATTRIBUTE_GVFS_BACKEND:
 821  *
 822  * A key in the "gvfs" namespace that gets the name of the current
 823  * GVFS backend in use. Corresponding #GFileAttributeType is
 824  * %G_FILE_ATTRIBUTE_TYPE_STRING.
 825  **/
 826 #define G_FILE_ATTRIBUTE_GVFS_BACKEND "gvfs::backend"             /* string */
 827
 828 /**
 829  * G_FILE_ATTRIBUTE_SELINUX_CONTEXT:
 830  *
 831  * A key in the "selinux" namespace for getting the file's SELinux
 832  * context. Corresponding #GFileAttributeType is
 833  * %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only
 834  * available if GLib has been built with SELinux support.
 835  **/
 836 #define G_FILE_ATTRIBUTE_SELINUX_CONTEXT "selinux::context"       /* string */
 837
 838 /**
 839  * G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT:
 840  *
 841  * A key in the "trash" namespace.  When requested against
 842  * `trash:///` returns the number of (toplevel) items in the trash folder.
 843  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
 844  **/
 845 #define G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT "trash::item-count"     /* uint32 */
 846
 847 /**
 848  * G_FILE_ATTRIBUTE_TRASH_ORIG_PATH:
 849  *
 850  * A key in the "trash" namespace.  When requested against
 851  * items in `trash:///`, will return the original path to the file before it
 852  * was trashed. Corresponding #GFileAttributeType is
 853  * %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.
 854  *
 855  * Since: 2.24
 856  **/
 857 #define G_FILE_ATTRIBUTE_TRASH_ORIG_PATH "trash::orig-path"     /* byte string */
 858
 859 /**
 860  * G_FILE_ATTRIBUTE_TRASH_DELETION_DATE:
 861  *
 862  * A key in the "trash" namespace.  When requested against
 863  * items in `trash:///`, will return the date and time when the file
 864  * was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss.
 865  * Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
 866  *
 867  * Since: 2.24
 868  **/
 869 #define G_FILE_ATTRIBUTE_TRASH_DELETION_DATE "trash::deletion-date"  /* string */
 870
 871 /**
 872  * G_FILE_ATTRIBUTE_RECENT_MODIFIED:
 873  *
 874  * A key in the "recent" namespace for getting time, when the metadata for the
 875  * file in `recent:///` was last changed. Corresponding #GFileAttributeType is
 876  * %G_FILE_ATTRIBUTE_TYPE_INT64.
 877  *
 878  * Since: 2.52
 879  **/
 880 #define G_FILE_ATTRIBUTE_RECENT_MODIFIED "recent::modified"          /* int64 (time_t) */
 881
 882 GLIB_AVAILABLE_IN_ALL
 883 GType              g_file_info_get_type                  (void) G_GNUC_CONST;
 884
 885 GLIB_AVAILABLE_IN_ALL
 886 GFileInfo *        g_file_info_new                       (void);
 887 GLIB_AVAILABLE_IN_ALL
 888 GFileInfo *        g_file_info_dup                       (GFileInfo  *other);
 889 GLIB_AVAILABLE_IN_ALL
 890 void               g_file_info_copy_into                 (GFileInfo  *src_info,
 891                                                           GFileInfo  *dest_info);
 892 GLIB_AVAILABLE_IN_ALL
 893 gboolean           g_file_info_has_attribute             (GFileInfo  *info,
 894                                                           const char *attribute);
 895 GLIB_AVAILABLE_IN_ALL
 896 gboolean           g_file_info_has_namespace             (GFileInfo  *info,
 897                                                           const char *name_space);
 898 GLIB_AVAILABLE_IN_ALL
 899 char **            g_file_info_list_attributes           (GFileInfo  *info,
 900                                                           const char *name_space);
 901 GLIB_AVAILABLE_IN_ALL
 902 gboolean           g_file_info_get_attribute_data        (GFileInfo  *info,
 903                                                           const char *attribute,
 904                                                           GFileAttributeType *type,
 905                                                           gpointer   *value_pp,
 906                                                           GFileAttributeStatus *status);
 907 GLIB_AVAILABLE_IN_ALL
 908 GFileAttributeType g_file_info_get_attribute_type        (GFileInfo  *info,
 909                                                           const char *attribute);
 910 GLIB_AVAILABLE_IN_ALL
 911 void               g_file_info_remove_attribute          (GFileInfo  *info,
 912                                                           const char *attribute);
 913 GLIB_AVAILABLE_IN_ALL
 914 GFileAttributeStatus g_file_info_get_attribute_status    (GFileInfo  *info,
 915                                                           const char *attribute);
 916 GLIB_AVAILABLE_IN_ALL
 917 gboolean           g_file_info_set_attribute_status      (GFileInfo  *info,
 918                                                           const char *attribute,
 919                                                           GFileAttributeStatus status);
 920 GLIB_AVAILABLE_IN_ALL
 921 char *             g_file_info_get_attribute_as_string   (GFileInfo  *info,
 922                                                           const char *attribute);
 923 GLIB_AVAILABLE_IN_ALL
 924 const char *       g_file_info_get_attribute_string      (GFileInfo  *info,
 925                                                           const char *attribute);
 926 GLIB_AVAILABLE_IN_ALL
 927 const char *       g_file_info_get_attribute_byte_string (GFileInfo  *info,
 928                                                           const char *attribute);
 929 GLIB_AVAILABLE_IN_ALL
 930 gboolean           g_file_info_get_attribute_boolean     (GFileInfo  *info,
 931                                                           const char *attribute);
 932 GLIB_AVAILABLE_IN_ALL
 933 guint32            g_file_info_get_attribute_uint32      (GFileInfo  *info,
 934                                                           const char *attribute);
 935 GLIB_AVAILABLE_IN_ALL
 936 gint32             g_file_info_get_attribute_int32       (GFileInfo  *info,
 937                                                           const char *attribute);
 938 GLIB_AVAILABLE_IN_ALL
 939 guint64            g_file_info_get_attribute_uint64      (GFileInfo  *info,
 940                                                           const char *attribute);
 941 GLIB_AVAILABLE_IN_ALL
 942 gint64             g_file_info_get_attribute_int64       (GFileInfo  *info,
 943                                                           const char *attribute);
 944 GLIB_AVAILABLE_IN_ALL
 945 GObject *          g_file_info_get_attribute_object      (GFileInfo  *info,
 946                                                           const char *attribute);
 947 GLIB_AVAILABLE_IN_ALL
 948 char **            g_file_info_get_attribute_stringv     (GFileInfo  *info,
 949                                                           const char *attribute);
 950
 951 GLIB_AVAILABLE_IN_ALL
 952 void               g_file_info_set_attribute             (GFileInfo  *info,
 953                                                           const char *attribute,
 954                                                           GFileAttributeType type,
 955                                                           gpointer    value_p);
 956 GLIB_AVAILABLE_IN_ALL
 957 void               g_file_info_set_attribute_string      (GFileInfo  *info,
 958                                                           const char *attribute,
 959                                                           const char *attr_value);
 960 GLIB_AVAILABLE_IN_ALL
 961 void               g_file_info_set_attribute_byte_string (GFileInfo  *info,
 962                                                           const char *attribute,
 963                                                           const char *attr_value);
 964 GLIB_AVAILABLE_IN_ALL
 965 void               g_file_info_set_attribute_boolean     (GFileInfo  *info,
 966                                                           const char *attribute,
 967                                                           gboolean    attr_value);
 968 GLIB_AVAILABLE_IN_ALL
 969 void               g_file_info_set_attribute_uint32      (GFileInfo  *info,
 970                                                           const char *attribute,
 971                                                           guint32     attr_value);
 972 GLIB_AVAILABLE_IN_ALL
 973 void               g_file_info_set_attribute_int32       (GFileInfo  *info,
 974                                                           const char *attribute,
 975                                                           gint32      attr_value);
 976 GLIB_AVAILABLE_IN_ALL
 977 void               g_file_info_set_attribute_uint64      (GFileInfo  *info,
 978                                                           const char *attribute,
 979                                                           guint64     attr_value);
 980 GLIB_AVAILABLE_IN_ALL
 981 void               g_file_info_set_attribute_int64       (GFileInfo  *info,
 982                                                           const char *attribute,
 983                                                           gint64      attr_value);
 984 GLIB_AVAILABLE_IN_ALL
 985 void               g_file_info_set_attribute_object      (GFileInfo  *info,
 986                                                           const char *attribute,
 987                                                           GObject    *attr_value);
 988 GLIB_AVAILABLE_IN_ALL
 989 void               g_file_info_set_attribute_stringv     (GFileInfo  *info,
 990                                                           const char *attribute,
 991                                                           char      **attr_value);
 992
 993 GLIB_AVAILABLE_IN_ALL
 994 void               g_file_info_clear_status              (GFileInfo  *info);
 995
 996 /* Helper getters: */
 997 GLIB_AVAILABLE_IN_2_36
 998 GDateTime *       g_file_info_get_deletion_date      (GFileInfo         *info);
 999 GLIB_AVAILABLE_IN_ALL
1000 GFileType         g_file_info_get_file_type          (GFileInfo         *info);
1001 GLIB_AVAILABLE_IN_ALL
1002 gboolean          g_file_info_get_is_hidden          (GFileInfo         *info);
1003 GLIB_AVAILABLE_IN_ALL
1004 gboolean          g_file_info_get_is_backup          (GFileInfo         *info);
1005 GLIB_AVAILABLE_IN_ALL
1006 gboolean          g_file_info_get_is_symlink         (GFileInfo         *info);
1007 GLIB_AVAILABLE_IN_ALL
1008 const char *      g_file_info_get_name               (GFileInfo         *info);
1009 GLIB_AVAILABLE_IN_ALL
1010 const char *      g_file_info_get_display_name       (GFileInfo         *info);
1011 GLIB_AVAILABLE_IN_ALL
1012 const char *      g_file_info_get_edit_name          (GFileInfo         *info);
1013 GLIB_AVAILABLE_IN_ALL
1014 GIcon *           g_file_info_get_icon               (GFileInfo         *info);
1015 GLIB_AVAILABLE_IN_ALL
1016 GIcon *           g_file_info_get_symbolic_icon      (GFileInfo         *info);
1017 GLIB_AVAILABLE_IN_ALL
1018 const char *      g_file_info_get_content_type       (GFileInfo         *info);
1019 GLIB_AVAILABLE_IN_ALL
1020 goffset           g_file_info_get_size               (GFileInfo         *info);
1021 GLIB_AVAILABLE_IN_ALL
1022 void              g_file_info_get_modification_time  (GFileInfo         *info,
1023                                                       GTimeVal          *result);
1024 GLIB_AVAILABLE_IN_ALL
1025 const char *      g_file_info_get_symlink_target     (GFileInfo         *info);
1026 GLIB_AVAILABLE_IN_ALL
1027 const char *      g_file_info_get_etag               (GFileInfo         *info);
1028 GLIB_AVAILABLE_IN_ALL
1029 gint32            g_file_info_get_sort_order         (GFileInfo         *info);
1030
1031 GLIB_AVAILABLE_IN_ALL
1032 void              g_file_info_set_attribute_mask     (GFileInfo         *info,
1033                                                       GFileAttributeMatcher *mask);
1034 GLIB_AVAILABLE_IN_ALL
1035 void              g_file_info_unset_attribute_mask   (GFileInfo         *info);
1036
1037 /* Helper setters: */
1038 GLIB_AVAILABLE_IN_ALL
1039 void              g_file_info_set_file_type          (GFileInfo         *info,
1040                                                       GFileType          type);
1041 GLIB_AVAILABLE_IN_ALL
1042 void              g_file_info_set_is_hidden          (GFileInfo         *info,
1043                                                       gboolean           is_hidden);
1044 GLIB_AVAILABLE_IN_ALL
1045 void              g_file_info_set_is_symlink         (GFileInfo         *info,
1046                                                       gboolean           is_symlink);
1047 GLIB_AVAILABLE_IN_ALL
1048 void              g_file_info_set_name               (GFileInfo         *info,
1049                                                       const char        *name);
1050 GLIB_AVAILABLE_IN_ALL
1051 void              g_file_info_set_display_name       (GFileInfo         *info,
1052                                                       const char        *display_name);
1053 GLIB_AVAILABLE_IN_ALL
1054 void              g_file_info_set_edit_name          (GFileInfo         *info,
1055                                                       const char        *edit_name);
1056 GLIB_AVAILABLE_IN_ALL
1057 void              g_file_info_set_icon               (GFileInfo         *info,
1058                                                       GIcon             *icon);
1059 GLIB_AVAILABLE_IN_ALL
1060 void              g_file_info_set_symbolic_icon      (GFileInfo         *info,
1061                                                       GIcon             *icon);
1062 GLIB_AVAILABLE_IN_ALL
1063 void              g_file_info_set_content_type       (GFileInfo         *info,
1064                                                       const char        *content_type);
1065 GLIB_AVAILABLE_IN_ALL
1066 void              g_file_info_set_size               (GFileInfo         *info,
1067                                                       goffset            size);
1068 GLIB_AVAILABLE_IN_ALL
1069 void              g_file_info_set_modification_time  (GFileInfo         *info,
1070                                                       GTimeVal          *mtime);
1071 GLIB_AVAILABLE_IN_ALL
1072 void              g_file_info_set_symlink_target     (GFileInfo         *info,
1073                                                       const char        *symlink_target);
1074 GLIB_AVAILABLE_IN_ALL
1075 void              g_file_info_set_sort_order         (GFileInfo         *info,
1076                                                       gint32             sort_order);
1077
1078 #define G_TYPE_FILE_ATTRIBUTE_MATCHER (g_file_attribute_matcher_get_type ())
1079 GLIB_AVAILABLE_IN_ALL
1080 GType g_file_attribute_matcher_get_type (void) G_GNUC_CONST;
1081
1082 GLIB_AVAILABLE_IN_ALL
1083 GFileAttributeMatcher *g_file_attribute_matcher_new            (const char            *attributes);
1084 GLIB_AVAILABLE_IN_ALL
1085 GFileAttributeMatcher *g_file_attribute_matcher_ref            (GFileAttributeMatcher *matcher);
1086 GLIB_AVAILABLE_IN_ALL
1087 void                   g_file_attribute_matcher_unref          (GFileAttributeMatcher *matcher);
1088 GLIB_AVAILABLE_IN_ALL
1089 GFileAttributeMatcher *g_file_attribute_matcher_subtract       (GFileAttributeMatcher *matcher,
1090                                                                 GFileAttributeMatcher *subtract);
1091 GLIB_AVAILABLE_IN_ALL
1092 gboolean               g_file_attribute_matcher_matches        (GFileAttributeMatcher *matcher,
1093                                                                 const char            *attribute);
1094 GLIB_AVAILABLE_IN_ALL
1095 gboolean               g_file_attribute_matcher_matches_only   (GFileAttributeMatcher *matcher,
1096                                                                 const char            *attribute);
1097 GLIB_AVAILABLE_IN_ALL
1098 gboolean               g_file_attribute_matcher_enumerate_namespace (GFileAttributeMatcher *matcher,
1099                                                                      const char            *ns);
1100 GLIB_AVAILABLE_IN_ALL
1101 const char *           g_file_attribute_matcher_enumerate_next (GFileAttributeMatcher *matcher);
1102 GLIB_AVAILABLE_IN_2_32
1103 char *                 g_file_attribute_matcher_to_string      (GFileAttributeMatcher *matcher);
1104
1105 G_END_DECLS
1106
1107 #endif /* __G_FILE_INFO_H__ */