mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-10 03:16:17 +01:00
7eba41346e
- Make GCredentials instance and class structures private so it can't be subclassed and we don't have to worry about ABI compat issues. This also allows us to get rid of the GCredentialsPrivate struct. - Add a GCredentialsType enumeration that is used whenever exchanging pointers with the user. This allows us to support OSes with multiple native credential types. In particular, it allows supporting OSes where the native credential evolves or even changes over time. - Add g_socket_get_credentials() method. - Add tests for g_socket_get_credentials(). Right now this is in the GDBus peer-to-peer test case but we can change that later. - Move GTcpConnection into a separate gtk-doc page as was already half-done with GUnixConnection. Also finish the GUnixConnection move and ensure send_credentials() and receive_credentials() methods are in the docs. Also nuke comment about GTcpConnection being empty compared to its superclass. Signed-off-by: David Zeuthen <davidz@redhat.com>
1190 lines
43 KiB
C
1190 lines
43 KiB
C
/* GIO - GLib Input, Output and Streaming Library
|
|
*
|
|
* Copyright (C) 2006-2007 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General
|
|
* Public License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*
|
|
* Author: Alexander Larsson <alexl@redhat.com>
|
|
*/
|
|
|
|
#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
|
|
#error "Only <gio/gio.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __GIO_ENUMS_H__
|
|
#define __GIO_ENUMS_H__
|
|
|
|
#include <glib-object.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
/**
|
|
* GAppInfoCreateFlags:
|
|
* @G_APP_INFO_CREATE_NONE: No flags.
|
|
* @G_APP_INFO_CREATE_NEEDS_TERMINAL: Application opens in a terminal window.
|
|
* @G_APP_INFO_CREATE_SUPPORTS_URIS: Application supports URI arguments.
|
|
* @G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION: Application supports startup notification. Since 2.26
|
|
*
|
|
* Flags used when creating a #GAppInfo.
|
|
*/
|
|
typedef enum {
|
|
G_APP_INFO_CREATE_NONE = 0, /*< nick=none >*/
|
|
G_APP_INFO_CREATE_NEEDS_TERMINAL = (1 << 0), /*< nick=needs-terminal >*/
|
|
G_APP_INFO_CREATE_SUPPORTS_URIS = (1 << 1), /*< nick=supports-uris >*/
|
|
G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION = (1 << 2) /*< nick=supports-startup-notification >*/
|
|
} GAppInfoCreateFlags;
|
|
|
|
/**
|
|
* GConverterFlags:
|
|
* @G_CONVERTER_NO_FLAGS: No flags.
|
|
* @G_CONVERTER_INPUT_AT_END: At end of input data
|
|
* @G_CONVERTER_FLUSH: Flush data
|
|
*
|
|
* Flags used when calling a g_converter_convert().
|
|
*
|
|
* Since: 2.24
|
|
*/
|
|
typedef enum {
|
|
G_CONVERTER_NO_FLAGS = 0, /*< nick=none >*/
|
|
G_CONVERTER_INPUT_AT_END = (1 << 0), /*< nick=input-at-end >*/
|
|
G_CONVERTER_FLUSH = (1 << 1) /*< nick=flush >*/
|
|
} GConverterFlags;
|
|
|
|
/**
|
|
* GConverterResult:
|
|
* @G_CONVERTER_ERROR: There was an error during conversion.
|
|
* @G_CONVERTER_CONVERTED: Some data was consumed or produced
|
|
* @G_CONVERTER_FINISHED: The conversion is finished
|
|
* @G_CONVERTER_FLUSHED: Flushing is finished
|
|
*
|
|
* Results returned from g_converter_convert().
|
|
*
|
|
* Since: 2.24
|
|
*/
|
|
typedef enum {
|
|
G_CONVERTER_ERROR = 0, /*< nick=error >*/
|
|
G_CONVERTER_CONVERTED = 1, /*< nick=converted >*/
|
|
G_CONVERTER_FINISHED = 2, /*< nick=finished >*/
|
|
G_CONVERTER_FLUSHED = 3 /*< nick=flushed >*/
|
|
} GConverterResult;
|
|
|
|
|
|
/**
|
|
* GDataStreamByteOrder:
|
|
* @G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN: Selects Big Endian byte order.
|
|
* @G_DATA_STREAM_BYTE_ORDER_LITTLE_ENDIAN: Selects Little Endian byte order.
|
|
* @G_DATA_STREAM_BYTE_ORDER_HOST_ENDIAN: Selects endianness based on host machine's architecture.
|
|
*
|
|
* #GDataStreamByteOrder is used to ensure proper endianness of streaming data sources
|
|
* across various machine architectures.
|
|
*
|
|
**/
|
|
typedef enum {
|
|
G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN,
|
|
G_DATA_STREAM_BYTE_ORDER_LITTLE_ENDIAN,
|
|
G_DATA_STREAM_BYTE_ORDER_HOST_ENDIAN
|
|
} GDataStreamByteOrder;
|
|
|
|
|
|
/**
|
|
* GDataStreamNewlineType:
|
|
* @G_DATA_STREAM_NEWLINE_TYPE_LF: Selects "LF" line endings, common on most modern UNIX platforms.
|
|
* @G_DATA_STREAM_NEWLINE_TYPE_CR: Selects "CR" line endings.
|
|
* @G_DATA_STREAM_NEWLINE_TYPE_CR_LF: Selects "CR, LF" line ending, common on Microsoft Windows.
|
|
* @G_DATA_STREAM_NEWLINE_TYPE_ANY: Automatically try to handle any line ending type.
|
|
*
|
|
* #GDataStreamNewlineType is used when checking for or setting the line endings for a given file.
|
|
**/
|
|
typedef enum {
|
|
G_DATA_STREAM_NEWLINE_TYPE_LF,
|
|
G_DATA_STREAM_NEWLINE_TYPE_CR,
|
|
G_DATA_STREAM_NEWLINE_TYPE_CR_LF,
|
|
G_DATA_STREAM_NEWLINE_TYPE_ANY
|
|
} GDataStreamNewlineType;
|
|
|
|
|
|
/**
|
|
* GFileAttributeType:
|
|
* @G_FILE_ATTRIBUTE_TYPE_INVALID: indicates an invalid or uninitalized type.
|
|
* @G_FILE_ATTRIBUTE_TYPE_STRING: a null terminated UTF8 string.
|
|
* @G_FILE_ATTRIBUTE_TYPE_BYTE_STRING: a zero terminated string of non-zero bytes.
|
|
* @G_FILE_ATTRIBUTE_TYPE_BOOLEAN: a boolean value.
|
|
* @G_FILE_ATTRIBUTE_TYPE_UINT32: an unsigned 4-byte/32-bit integer.
|
|
* @G_FILE_ATTRIBUTE_TYPE_INT32: a signed 4-byte/32-bit integer.
|
|
* @G_FILE_ATTRIBUTE_TYPE_UINT64: an unsigned 8-byte/64-bit integer.
|
|
* @G_FILE_ATTRIBUTE_TYPE_INT64: a signed 8-byte/64-bit integer.
|
|
* @G_FILE_ATTRIBUTE_TYPE_OBJECT: a #GObject.
|
|
* @G_FILE_ATTRIBUTE_TYPE_STRINGV: a %NULL terminated char **. Since 2.22
|
|
*
|
|
* The data types for file attributes.
|
|
**/
|
|
typedef enum {
|
|
G_FILE_ATTRIBUTE_TYPE_INVALID = 0,
|
|
G_FILE_ATTRIBUTE_TYPE_STRING,
|
|
G_FILE_ATTRIBUTE_TYPE_BYTE_STRING, /* zero terminated string of non-zero bytes */
|
|
G_FILE_ATTRIBUTE_TYPE_BOOLEAN,
|
|
G_FILE_ATTRIBUTE_TYPE_UINT32,
|
|
G_FILE_ATTRIBUTE_TYPE_INT32,
|
|
G_FILE_ATTRIBUTE_TYPE_UINT64,
|
|
G_FILE_ATTRIBUTE_TYPE_INT64,
|
|
G_FILE_ATTRIBUTE_TYPE_OBJECT,
|
|
G_FILE_ATTRIBUTE_TYPE_STRINGV
|
|
} GFileAttributeType;
|
|
|
|
|
|
/**
|
|
* GFileAttributeInfoFlags:
|
|
* @G_FILE_ATTRIBUTE_INFO_NONE: no flags set.
|
|
* @G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE: copy the attribute values when the file is copied.
|
|
* @G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED: copy the attribute values when the file is moved.
|
|
*
|
|
* Flags specifying the behaviour of an attribute.
|
|
**/
|
|
typedef enum {
|
|
G_FILE_ATTRIBUTE_INFO_NONE = 0,
|
|
G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE = (1 << 0),
|
|
G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED = (1 << 1)
|
|
} GFileAttributeInfoFlags;
|
|
|
|
|
|
/**
|
|
* GFileAttributeStatus:
|
|
* @G_FILE_ATTRIBUTE_STATUS_UNSET: Attribute value is unset (empty).
|
|
* @G_FILE_ATTRIBUTE_STATUS_SET: Attribute value is set.
|
|
* @G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING: Indicates an error in setting the value.
|
|
*
|
|
* Used by g_file_set_attributes_from_info() when setting file attributes.
|
|
**/
|
|
typedef enum {
|
|
G_FILE_ATTRIBUTE_STATUS_UNSET = 0,
|
|
G_FILE_ATTRIBUTE_STATUS_SET,
|
|
G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING
|
|
} GFileAttributeStatus;
|
|
|
|
|
|
/**
|
|
* GFileQueryInfoFlags:
|
|
* @G_FILE_QUERY_INFO_NONE: No flags set.
|
|
* @G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS: Don't follow symlinks.
|
|
*
|
|
* Flags used when querying a #GFileInfo.
|
|
*/
|
|
typedef enum {
|
|
G_FILE_QUERY_INFO_NONE = 0,
|
|
G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS = (1 << 0) /*< nick=nofollow-symlinks >*/
|
|
} GFileQueryInfoFlags;
|
|
|
|
|
|
/**
|
|
* GFileCreateFlags:
|
|
* @G_FILE_CREATE_NONE: No flags set.
|
|
* @G_FILE_CREATE_PRIVATE: Create a file that can only be
|
|
* accessed by the current user.
|
|
* @G_FILE_CREATE_REPLACE_DESTINATION: Replace the destination
|
|
* as if it didn't exist before. Don't try to keep any old
|
|
* permissions, replace instead of following links. This
|
|
* is generally useful if you're doing a "copy over"
|
|
* rather than a "save new version of" replace operation.
|
|
* You can think of it as "unlink destination" before
|
|
* writing to it, although the implementation may not
|
|
* be exactly like that. Since 2.20
|
|
*
|
|
* Flags used when an operation may create a file.
|
|
*/
|
|
typedef enum {
|
|
G_FILE_CREATE_NONE = 0,
|
|
G_FILE_CREATE_PRIVATE = (1 << 0),
|
|
G_FILE_CREATE_REPLACE_DESTINATION = (1 << 1)
|
|
} GFileCreateFlags;
|
|
|
|
|
|
/**
|
|
* GMountMountFlags:
|
|
* @G_MOUNT_MOUNT_NONE: No flags set.
|
|
*
|
|
* Flags used when mounting a mount.
|
|
*/
|
|
typedef enum {
|
|
G_MOUNT_MOUNT_NONE = 0
|
|
} GMountMountFlags;
|
|
|
|
|
|
/**
|
|
* GMountUnmountFlags:
|
|
* @G_MOUNT_UNMOUNT_NONE: No flags set.
|
|
* @G_MOUNT_UNMOUNT_FORCE: Unmount even if there are outstanding
|
|
* file operations on the mount.
|
|
*
|
|
* Flags used when an unmounting a mount.
|
|
*/
|
|
typedef enum {
|
|
G_MOUNT_UNMOUNT_NONE = 0,
|
|
G_MOUNT_UNMOUNT_FORCE = (1 << 0)
|
|
} GMountUnmountFlags;
|
|
|
|
/**
|
|
* GDriveStartFlags:
|
|
* @G_DRIVE_START_NONE: No flags set.
|
|
*
|
|
* Flags used when starting a drive.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
typedef enum {
|
|
G_DRIVE_START_NONE = 0
|
|
} GDriveStartFlags;
|
|
|
|
/**
|
|
* GDriveStartStopType:
|
|
* @G_DRIVE_START_STOP_TYPE_UNKNOWN: Unknown or drive doesn't support
|
|
* start/stop.
|
|
* @G_DRIVE_START_STOP_TYPE_SHUTDOWN: The stop method will physically
|
|
* shut down the drive and e.g. power down the port the drive is
|
|
* attached to.
|
|
* @G_DRIVE_START_STOP_TYPE_NETWORK: The start/stop methods are used
|
|
* for connecting/disconnect to the drive over the network.
|
|
* @G_DRIVE_START_STOP_TYPE_MULTIDISK: The start/stop methods will
|
|
* assemble/disassemble a virtual drive from several physical
|
|
* drives.
|
|
* @G_DRIVE_START_STOP_TYPE_PASSWORD: The start/stop methods will
|
|
* unlock/lock the disk (for example using the ATA <quote>SECURITY
|
|
* UNLOCK DEVICE</quote> command)
|
|
*
|
|
* Enumeration describing how a drive can be started/stopped.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
typedef enum {
|
|
G_DRIVE_START_STOP_TYPE_UNKNOWN,
|
|
G_DRIVE_START_STOP_TYPE_SHUTDOWN,
|
|
G_DRIVE_START_STOP_TYPE_NETWORK,
|
|
G_DRIVE_START_STOP_TYPE_MULTIDISK,
|
|
G_DRIVE_START_STOP_TYPE_PASSWORD
|
|
} GDriveStartStopType;
|
|
|
|
/**
|
|
* GFileCopyFlags:
|
|
* @G_FILE_COPY_NONE: No flags set.
|
|
* @G_FILE_COPY_OVERWRITE: Overwrite any existing files
|
|
* @G_FILE_COPY_BACKUP: Make a backup of any existing files.
|
|
* @G_FILE_COPY_NOFOLLOW_SYMLINKS: Don't follow symlinks.
|
|
* @G_FILE_COPY_ALL_METADATA: Copy all file metadata instead of just default set used for copy (see #GFileInfo).
|
|
* @G_FILE_COPY_NO_FALLBACK_FOR_MOVE: Don't use copy and delete fallback if native move not supported.
|
|
* @G_FILE_COPY_TARGET_DEFAULT_PERMS: Leaves target file with default perms, instead of setting the source file perms.
|
|
*
|
|
* Flags used when copying or moving files.
|
|
*/
|
|
typedef enum {
|
|
G_FILE_COPY_NONE = 0, /*< nick=none >*/
|
|
G_FILE_COPY_OVERWRITE = (1 << 0),
|
|
G_FILE_COPY_BACKUP = (1 << 1),
|
|
G_FILE_COPY_NOFOLLOW_SYMLINKS = (1 << 2),
|
|
G_FILE_COPY_ALL_METADATA = (1 << 3),
|
|
G_FILE_COPY_NO_FALLBACK_FOR_MOVE = (1 << 4),
|
|
G_FILE_COPY_TARGET_DEFAULT_PERMS = (1 << 5)
|
|
} GFileCopyFlags;
|
|
|
|
|
|
/**
|
|
* GFileMonitorFlags:
|
|
* @G_FILE_MONITOR_NONE: No flags set.
|
|
* @G_FILE_MONITOR_WATCH_MOUNTS: Watch for mount events.
|
|
* @G_FILE_MONITOR_SEND_MOVED: Pair DELETED and CREATED events caused
|
|
* by file renames (moves) and send a single G_FILE_MONITOR_EVENT_MOVED
|
|
* event instead (NB: not supported on all backends; the default
|
|
* behaviour -without specifying this flag- is to send single DELETED
|
|
* and CREATED events).
|
|
*
|
|
* Flags used to set what a #GFileMonitor will watch for.
|
|
*/
|
|
typedef enum {
|
|
G_FILE_MONITOR_NONE = 0,
|
|
G_FILE_MONITOR_WATCH_MOUNTS = (1 << 0),
|
|
G_FILE_MONITOR_SEND_MOVED = (1 << 1)
|
|
} GFileMonitorFlags;
|
|
|
|
|
|
/**
|
|
* GFileType:
|
|
* @G_FILE_TYPE_UNKNOWN: File's type is unknown.
|
|
* @G_FILE_TYPE_REGULAR: File handle represents a regular file.
|
|
* @G_FILE_TYPE_DIRECTORY: File handle represents a directory.
|
|
* @G_FILE_TYPE_SYMBOLIC_LINK: File handle represents a symbolic link
|
|
* (Unix systems).
|
|
* @G_FILE_TYPE_SPECIAL: File is a "special" file, such as a socket, fifo,
|
|
* block device, or character device.
|
|
* @G_FILE_TYPE_SHORTCUT: File is a shortcut (Windows systems).
|
|
* @G_FILE_TYPE_MOUNTABLE: File is a mountable location.
|
|
*
|
|
* Indicates the file's on-disk type.
|
|
**/
|
|
typedef enum {
|
|
G_FILE_TYPE_UNKNOWN = 0,
|
|
G_FILE_TYPE_REGULAR,
|
|
G_FILE_TYPE_DIRECTORY,
|
|
G_FILE_TYPE_SYMBOLIC_LINK,
|
|
G_FILE_TYPE_SPECIAL, /* socket, fifo, blockdev, chardev */
|
|
G_FILE_TYPE_SHORTCUT,
|
|
G_FILE_TYPE_MOUNTABLE
|
|
} GFileType;
|
|
|
|
|
|
/**
|
|
* GFilesystemPreviewType:
|
|
* @G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS: Only preview files if user has explicitly requested it.
|
|
* @G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL: Preview files if user has requested preview of "local" files.
|
|
* @G_FILESYSTEM_PREVIEW_TYPE_NEVER: Never preview files.
|
|
*
|
|
* Indicates a hint from the file system whether files should be
|
|
* previewed in a file manager. Returned as the value of the key
|
|
* #G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.
|
|
**/
|
|
typedef enum {
|
|
G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS = 0,
|
|
G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL,
|
|
G_FILESYSTEM_PREVIEW_TYPE_NEVER
|
|
} GFilesystemPreviewType;
|
|
|
|
|
|
/**
|
|
* GFileMonitorEvent:
|
|
* @G_FILE_MONITOR_EVENT_CHANGED: a file changed.
|
|
* @G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT: a hint that this was probably the last change in a set of changes.
|
|
* @G_FILE_MONITOR_EVENT_DELETED: a file was deleted.
|
|
* @G_FILE_MONITOR_EVENT_CREATED: a file was created.
|
|
* @G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED: a file attribute was changed.
|
|
* @G_FILE_MONITOR_EVENT_PRE_UNMOUNT: the file location will soon be unmounted.
|
|
* @G_FILE_MONITOR_EVENT_UNMOUNTED: the file location was unmounted.
|
|
* @G_FILE_MONITOR_EVENT_MOVED: the file was moved.
|
|
*
|
|
* Specifies what type of event a monitor event is.
|
|
**/
|
|
typedef enum {
|
|
G_FILE_MONITOR_EVENT_CHANGED,
|
|
G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT,
|
|
G_FILE_MONITOR_EVENT_DELETED,
|
|
G_FILE_MONITOR_EVENT_CREATED,
|
|
G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED,
|
|
G_FILE_MONITOR_EVENT_PRE_UNMOUNT,
|
|
G_FILE_MONITOR_EVENT_UNMOUNTED,
|
|
G_FILE_MONITOR_EVENT_MOVED
|
|
} GFileMonitorEvent;
|
|
|
|
|
|
/* This enumeration conflicts with GIOError in giochannel.h. However,
|
|
* that is only used as a return value in some deprecated functions.
|
|
* So, we reuse the same prefix for the enumeration values, but call
|
|
* the actual enumeration (which is rarely used) GIOErrorEnum.
|
|
*/
|
|
/**
|
|
* GIOErrorEnum:
|
|
* @G_IO_ERROR_FAILED: Generic error condition for when any operation fails.
|
|
* @G_IO_ERROR_NOT_FOUND: File not found error.
|
|
* @G_IO_ERROR_EXISTS: File already exists error.
|
|
* @G_IO_ERROR_IS_DIRECTORY: File is a directory error.
|
|
* @G_IO_ERROR_NOT_DIRECTORY: File is not a directory.
|
|
* @G_IO_ERROR_NOT_EMPTY: File is a directory that isn't empty.
|
|
* @G_IO_ERROR_NOT_REGULAR_FILE: File is not a regular file.
|
|
* @G_IO_ERROR_NOT_SYMBOLIC_LINK: File is not a symbolic link.
|
|
* @G_IO_ERROR_NOT_MOUNTABLE_FILE: File cannot be mounted.
|
|
* @G_IO_ERROR_FILENAME_TOO_LONG: Filename is too many characters.
|
|
* @G_IO_ERROR_INVALID_FILENAME: Filename is invalid or contains invalid characters.
|
|
* @G_IO_ERROR_TOO_MANY_LINKS: File contains too many symbolic links.
|
|
* @G_IO_ERROR_NO_SPACE: No space left on drive.
|
|
* @G_IO_ERROR_INVALID_ARGUMENT: Invalid argument.
|
|
* @G_IO_ERROR_PERMISSION_DENIED: Permission denied.
|
|
* @G_IO_ERROR_NOT_SUPPORTED: Operation not supported for the current backend.
|
|
* @G_IO_ERROR_NOT_MOUNTED: File isn't mounted.
|
|
* @G_IO_ERROR_ALREADY_MOUNTED: File is already mounted.
|
|
* @G_IO_ERROR_CLOSED: File was closed.
|
|
* @G_IO_ERROR_CANCELLED: Operation was cancelled. See #GCancellable.
|
|
* @G_IO_ERROR_PENDING: Operations are still pending.
|
|
* @G_IO_ERROR_READ_ONLY: File is read only.
|
|
* @G_IO_ERROR_CANT_CREATE_BACKUP: Backup couldn't be created.
|
|
* @G_IO_ERROR_WRONG_ETAG: File's Entity Tag was incorrect.
|
|
* @G_IO_ERROR_TIMED_OUT: Operation timed out.
|
|
* @G_IO_ERROR_WOULD_RECURSE: Operation would be recursive.
|
|
* @G_IO_ERROR_BUSY: File is busy.
|
|
* @G_IO_ERROR_WOULD_BLOCK: Operation would block.
|
|
* @G_IO_ERROR_HOST_NOT_FOUND: Host couldn't be found (remote operations).
|
|
* @G_IO_ERROR_WOULD_MERGE: Operation would merge files.
|
|
* @G_IO_ERROR_FAILED_HANDLED: Operation failed and a helper program has
|
|
* already interacted with the user. Do not display any error dialog.
|
|
* @G_IO_ERROR_TOO_MANY_OPEN_FILES: The current process has too many files
|
|
* open and can't open any more. Duplicate descriptors do count toward
|
|
* this limit. Since 2.20
|
|
* @G_IO_ERROR_NOT_INITIALIZED: The object has not been initialized. Since 2.22
|
|
* @G_IO_ERROR_ADDRESS_IN_USE: The requested address is already in use. Since 2.22
|
|
* @G_IO_ERROR_PARTIAL_INPUT: Need more input to finish operation. Since 2.24
|
|
* @G_IO_ERROR_INVALID_DATA: There input data was invalid. Since 2.24
|
|
* @G_IO_ERROR_DBUS_ERROR: A remote object generated an error that
|
|
* doesn't correspond to a locally registered #GError error
|
|
* domain. Use g_dbus_error_get_remote_error() to extract the D-Bus
|
|
* error name and g_dbus_error_strip_remote_error() to fix up the
|
|
* message so it matches what was received on the wire. Since 2.26.
|
|
*
|
|
* Error codes returned by GIO functions.
|
|
*
|
|
**/
|
|
typedef enum {
|
|
G_IO_ERROR_FAILED,
|
|
G_IO_ERROR_NOT_FOUND,
|
|
G_IO_ERROR_EXISTS,
|
|
G_IO_ERROR_IS_DIRECTORY,
|
|
G_IO_ERROR_NOT_DIRECTORY,
|
|
G_IO_ERROR_NOT_EMPTY,
|
|
G_IO_ERROR_NOT_REGULAR_FILE,
|
|
G_IO_ERROR_NOT_SYMBOLIC_LINK,
|
|
G_IO_ERROR_NOT_MOUNTABLE_FILE,
|
|
G_IO_ERROR_FILENAME_TOO_LONG,
|
|
G_IO_ERROR_INVALID_FILENAME,
|
|
G_IO_ERROR_TOO_MANY_LINKS,
|
|
G_IO_ERROR_NO_SPACE,
|
|
G_IO_ERROR_INVALID_ARGUMENT,
|
|
G_IO_ERROR_PERMISSION_DENIED,
|
|
G_IO_ERROR_NOT_SUPPORTED,
|
|
G_IO_ERROR_NOT_MOUNTED,
|
|
G_IO_ERROR_ALREADY_MOUNTED,
|
|
G_IO_ERROR_CLOSED,
|
|
G_IO_ERROR_CANCELLED,
|
|
G_IO_ERROR_PENDING,
|
|
G_IO_ERROR_READ_ONLY,
|
|
G_IO_ERROR_CANT_CREATE_BACKUP,
|
|
G_IO_ERROR_WRONG_ETAG,
|
|
G_IO_ERROR_TIMED_OUT,
|
|
G_IO_ERROR_WOULD_RECURSE,
|
|
G_IO_ERROR_BUSY,
|
|
G_IO_ERROR_WOULD_BLOCK,
|
|
G_IO_ERROR_HOST_NOT_FOUND,
|
|
G_IO_ERROR_WOULD_MERGE,
|
|
G_IO_ERROR_FAILED_HANDLED,
|
|
G_IO_ERROR_TOO_MANY_OPEN_FILES,
|
|
G_IO_ERROR_NOT_INITIALIZED,
|
|
G_IO_ERROR_ADDRESS_IN_USE,
|
|
G_IO_ERROR_PARTIAL_INPUT,
|
|
G_IO_ERROR_INVALID_DATA,
|
|
G_IO_ERROR_DBUS_ERROR
|
|
} GIOErrorEnum;
|
|
|
|
|
|
/**
|
|
* GAskPasswordFlags:
|
|
* @G_ASK_PASSWORD_NEED_PASSWORD: operation requires a password.
|
|
* @G_ASK_PASSWORD_NEED_USERNAME: operation requires a username.
|
|
* @G_ASK_PASSWORD_NEED_DOMAIN: operation requires a domain.
|
|
* @G_ASK_PASSWORD_SAVING_SUPPORTED: operation supports saving settings.
|
|
* @G_ASK_PASSWORD_ANONYMOUS_SUPPORTED: operation supports anonymous users.
|
|
*
|
|
* #GAskPasswordFlags are used to request specific information from the
|
|
* user, or to notify the user of their choices in an authentication
|
|
* situation.
|
|
**/
|
|
typedef enum {
|
|
G_ASK_PASSWORD_NEED_PASSWORD = (1 << 0),
|
|
G_ASK_PASSWORD_NEED_USERNAME = (1 << 1),
|
|
G_ASK_PASSWORD_NEED_DOMAIN = (1 << 2),
|
|
G_ASK_PASSWORD_SAVING_SUPPORTED = (1 << 3),
|
|
G_ASK_PASSWORD_ANONYMOUS_SUPPORTED = (1 << 4)
|
|
} GAskPasswordFlags;
|
|
|
|
|
|
/**
|
|
* GPasswordSave:
|
|
* @G_PASSWORD_SAVE_NEVER: never save a password.
|
|
* @G_PASSWORD_SAVE_FOR_SESSION: save a password for the session.
|
|
* @G_PASSWORD_SAVE_PERMANENTLY: save a password permanently.
|
|
*
|
|
* #GPasswordSave is used to indicate the lifespan of a saved password.
|
|
*
|
|
* #Gvfs stores passwords in the Gnome keyring when this flag allows it
|
|
* to, and later retrieves it again from there.
|
|
**/
|
|
typedef enum {
|
|
G_PASSWORD_SAVE_NEVER,
|
|
G_PASSWORD_SAVE_FOR_SESSION,
|
|
G_PASSWORD_SAVE_PERMANENTLY
|
|
} GPasswordSave;
|
|
|
|
|
|
/**
|
|
* GMountOperationResult:
|
|
* @G_MOUNT_OPERATION_HANDLED: The request was fulfilled and the
|
|
* user specified data is now available
|
|
* @G_MOUNT_OPERATION_ABORTED: The user requested the mount operation
|
|
* to be aborted
|
|
* @G_MOUNT_OPERATION_UNHANDLED: The request was unhandled (i.e. not
|
|
* implemented)
|
|
*
|
|
* #GMountOperationResult is returned as a result when a request for
|
|
* information is send by the mounting operation.
|
|
**/
|
|
typedef enum {
|
|
G_MOUNT_OPERATION_HANDLED,
|
|
G_MOUNT_OPERATION_ABORTED,
|
|
G_MOUNT_OPERATION_UNHANDLED
|
|
} GMountOperationResult;
|
|
|
|
|
|
/**
|
|
* GOutputStreamSpliceFlags:
|
|
* @G_OUTPUT_STREAM_SPLICE_NONE: Do not close either stream.
|
|
* @G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE: Close the source stream after
|
|
* the splice.
|
|
* @G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET: Close the target stream after
|
|
* the splice.
|
|
*
|
|
* GOutputStreamSpliceFlags determine how streams should be spliced.
|
|
**/
|
|
typedef enum {
|
|
G_OUTPUT_STREAM_SPLICE_NONE = 0,
|
|
G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE = (1 << 0),
|
|
G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET = (1 << 1)
|
|
} GOutputStreamSpliceFlags;
|
|
|
|
|
|
/**
|
|
* GEmblemOrigin:
|
|
* @G_EMBLEM_ORIGIN_UNKNOWN: Emblem of unknown origin
|
|
* @G_EMBLEM_ORIGIN_DEVICE: Emblem adds device-specific information
|
|
* @G_EMBLEM_ORIGIN_LIVEMETADATA: Emblem depicts live metadata, such as "readonly"
|
|
* @G_EMBLEM_ORIGIN_TAG: Emblem comes from a user-defined tag, e.g. set by nautilus (in the future)
|
|
*
|
|
* GEmblemOrigin is used to add information about the origin of the emblem
|
|
* to #GEmblem.
|
|
*
|
|
* Since: 2.18
|
|
*/
|
|
typedef enum {
|
|
G_EMBLEM_ORIGIN_UNKNOWN,
|
|
G_EMBLEM_ORIGIN_DEVICE,
|
|
G_EMBLEM_ORIGIN_LIVEMETADATA,
|
|
G_EMBLEM_ORIGIN_TAG
|
|
} GEmblemOrigin;
|
|
|
|
/**
|
|
* GResolverError:
|
|
* @G_RESOLVER_ERROR_NOT_FOUND: the requested name/address/service was not
|
|
* found
|
|
* @G_RESOLVER_ERROR_TEMPORARY_FAILURE: the requested information could not
|
|
* be looked up due to a network error or similar problem
|
|
* @G_RESOLVER_ERROR_INTERNAL: unknown error
|
|
*
|
|
* An error code used with %G_RESOLVER_ERROR in a #GError returned
|
|
* from a #GResolver routine.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
typedef enum {
|
|
G_RESOLVER_ERROR_NOT_FOUND,
|
|
G_RESOLVER_ERROR_TEMPORARY_FAILURE,
|
|
G_RESOLVER_ERROR_INTERNAL
|
|
} GResolverError;
|
|
|
|
/**
|
|
* GSocketFamily:
|
|
* @G_SOCKET_FAMILY_INVALID: no address family
|
|
* @G_SOCKET_FAMILY_IPV4: the IPv4 family
|
|
* @G_SOCKET_FAMILY_IPV6: the IPv6 family
|
|
* @G_SOCKET_FAMILY_UNIX: the UNIX domain family
|
|
*
|
|
* The protocol family of a #GSocketAddress. (These values are
|
|
* identical to the system defines %AF_INET, %AF_INET6 and %AF_UNIX,
|
|
* if available.)
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
typedef enum {
|
|
G_SOCKET_FAMILY_INVALID,
|
|
#ifdef GLIB_SYSDEF_AF_UNIX
|
|
G_SOCKET_FAMILY_UNIX = GLIB_SYSDEF_AF_UNIX,
|
|
#endif
|
|
G_SOCKET_FAMILY_IPV4 = GLIB_SYSDEF_AF_INET,
|
|
G_SOCKET_FAMILY_IPV6 = GLIB_SYSDEF_AF_INET6
|
|
} GSocketFamily;
|
|
|
|
/**
|
|
* GSocketType:
|
|
* @G_SOCKET_TYPE_INVALID: Type unknown or wrong
|
|
* @G_SOCKET_TYPE_STREAM: Reliable connection-based byte streams (e.g. TCP).
|
|
* @G_SOCKET_TYPE_DATAGRAM: Connectionless, unreliable datagram passing.
|
|
* (e.g. UDP)
|
|
* @G_SOCKET_TYPE_SEQPACKET: Reliable connection-based passing of datagrams
|
|
* of fixed maximum length (e.g. SCTP).
|
|
*
|
|
* Flags used when creating a #GSocket. Some protocols may not implement
|
|
* all the socket types.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_SOCKET_TYPE_INVALID,
|
|
G_SOCKET_TYPE_STREAM,
|
|
G_SOCKET_TYPE_DATAGRAM,
|
|
G_SOCKET_TYPE_SEQPACKET
|
|
} GSocketType;
|
|
|
|
/**
|
|
* GSocketMsgFlags:
|
|
* @G_SOCKET_MSG_NONE: No flags.
|
|
* @G_SOCKET_MSG_OOB: Request to send/receive out of band data.
|
|
* @G_SOCKET_MSG_PEEK: Read data from the socket without removing it from
|
|
* the queue.
|
|
* @G_SOCKET_MSG_DONTROUTE: Don't use a gateway to send out the packet,
|
|
* only send to hosts on directly connected networks.
|
|
*
|
|
* Flags used in g_socket_receive_message() and g_socket_send_message().
|
|
* The flags listed in the enum are some commonly available flags, but the
|
|
* values used for them are the same as on the platform, and any other flags
|
|
* are passed in/out as is. So to use a platform specific flag, just include
|
|
* the right system header and pass in the flag.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_SOCKET_MSG_NONE,
|
|
G_SOCKET_MSG_OOB = GLIB_SYSDEF_MSG_OOB,
|
|
G_SOCKET_MSG_PEEK = GLIB_SYSDEF_MSG_PEEK,
|
|
G_SOCKET_MSG_DONTROUTE = GLIB_SYSDEF_MSG_DONTROUTE
|
|
} GSocketMsgFlags;
|
|
|
|
/**
|
|
* GSocketProtocol:
|
|
* @G_SOCKET_PROTOCOL_UNKNOWN: The protocol type is unknown
|
|
* @G_SOCKET_PROTOCOL_DEFAULT: The default protocol for the family/type
|
|
* @G_SOCKET_PROTOCOL_TCP: TCP over IP
|
|
* @G_SOCKET_PROTOCOL_UDP: UDP over IP
|
|
* @G_SOCKET_PROTOCOL_SCTP: SCTP over IP
|
|
*
|
|
* A protocol identifier is specified when creating a #GSocket, which is a
|
|
* family/type specific identifier, where 0 means the default protocol for
|
|
* the particular family/type.
|
|
*
|
|
* This enum contains a set of commonly available and used protocols. You
|
|
* can also pass any other identifiers handled by the platform in order to
|
|
* use protocols not listed here.
|
|
*
|
|
* Since: 2.22
|
|
*/
|
|
typedef enum {
|
|
G_SOCKET_PROTOCOL_UNKNOWN = -1,
|
|
G_SOCKET_PROTOCOL_DEFAULT = 0,
|
|
G_SOCKET_PROTOCOL_TCP = 6,
|
|
G_SOCKET_PROTOCOL_UDP = 17,
|
|
G_SOCKET_PROTOCOL_SCTP = 132
|
|
} GSocketProtocol;
|
|
|
|
/**
|
|
* GZlibCompressorFormat:
|
|
* @G_ZLIB_COMPRESSOR_FORMAT_ZLIB: deflate compression with zlib header
|
|
* @G_ZLIB_COMPRESSOR_FORMAT_GZIP: gzip file format
|
|
* @G_ZLIB_COMPRESSOR_FORMAT_RAW: deflate compression with no header
|
|
*
|
|
* Used to select the type of data format to use for #GZlibDecompressor
|
|
* and #GZlibCompressor.
|
|
*
|
|
* Since: 2.24
|
|
*/
|
|
typedef enum {
|
|
G_ZLIB_COMPRESSOR_FORMAT_ZLIB,
|
|
G_ZLIB_COMPRESSOR_FORMAT_GZIP,
|
|
G_ZLIB_COMPRESSOR_FORMAT_RAW
|
|
} GZlibCompressorFormat;
|
|
|
|
/**
|
|
* GUnixSocketAddressType:
|
|
* @G_UNIX_SOCKET_ADDRESS_INVALID: invalid
|
|
* @G_UNIX_SOCKET_ADDRESS_ANONYMOUS: anonymous
|
|
* @G_UNIX_SOCKET_ADDRESS_PATH: a filesystem path
|
|
* @G_UNIX_SOCKET_ADDRESS_ABSTRACT: an abstract name
|
|
* @G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED: an abstract name, 0-padded
|
|
* to the full length of a unix socket name
|
|
*
|
|
* The type of name used by a #GUnixSocketAddress.
|
|
* %G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain
|
|
* socket bound to a filesystem path. %G_UNIX_SOCKET_ADDRESS_ANONYMOUS
|
|
* indicates a socket not bound to any name (eg, a client-side socket,
|
|
* or a socket created with socketpair()).
|
|
*
|
|
* For abstract sockets, there are two incompatible ways of naming
|
|
* them: the man pages suggest using the entire <literal>struct
|
|
* sockaddr_un</literal> as the name, padding the unused parts of the
|
|
* %sun_path field with zeroes; this corresponds to
|
|
* %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED. However, many programs
|
|
* instead just use a portion of %sun_path, and pass an appropriate
|
|
* smaller length to bind() or connect(). This is
|
|
* %G_UNIX_SOCKET_ADDRESS_ABSTRACT.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum {
|
|
G_UNIX_SOCKET_ADDRESS_INVALID,
|
|
G_UNIX_SOCKET_ADDRESS_ANONYMOUS,
|
|
G_UNIX_SOCKET_ADDRESS_PATH,
|
|
G_UNIX_SOCKET_ADDRESS_ABSTRACT,
|
|
G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED
|
|
} GUnixSocketAddressType;
|
|
|
|
/**
|
|
* GBusType:
|
|
* @G_BUS_TYPE_STARTER: An alias for the message bus that activated the process, if any.
|
|
* @G_BUS_TYPE_NONE: Not a message bus.
|
|
* @G_BUS_TYPE_SYSTEM: The system-wide message bus.
|
|
* @G_BUS_TYPE_SESSION: The login session message bus.
|
|
*
|
|
* An enumeration for well-known message buses.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_BUS_TYPE_STARTER = -1,
|
|
G_BUS_TYPE_NONE = 0,
|
|
G_BUS_TYPE_SYSTEM = 1,
|
|
G_BUS_TYPE_SESSION = 2
|
|
} GBusType;
|
|
|
|
/**
|
|
* GBusNameOwnerFlags:
|
|
* @G_BUS_NAME_OWNER_FLAGS_NONE: No flags set.
|
|
* @G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT: Allow another message bus connection to claim the the name.
|
|
* @G_BUS_NAME_OWNER_FLAGS_REPLACE: If another message bus connection owns the name and have
|
|
* specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection.
|
|
*
|
|
* Flags used in g_bus_own_name().
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_BUS_NAME_OWNER_FLAGS_NONE = 0, /*< nick=none >*/
|
|
G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT = (1<<0), /*< nick=allow-replacement >*/
|
|
G_BUS_NAME_OWNER_FLAGS_REPLACE = (1<<1) /*< nick=replace >*/
|
|
} GBusNameOwnerFlags;
|
|
|
|
/**
|
|
* GBusNameWatcherFlags:
|
|
* @G_BUS_NAME_WATCHER_FLAGS_NONE: No flags set.
|
|
* @G_BUS_NAME_WATCHER_FLAGS_AUTO_START: If no-one owns the name when
|
|
* beginning to watch the name, ask the bus to launch an owner for the
|
|
* name.
|
|
*
|
|
* Flags used in g_bus_watch_name().
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_BUS_NAME_WATCHER_FLAGS_NONE = 0,
|
|
G_BUS_NAME_WATCHER_FLAGS_AUTO_START = (1<<0)
|
|
} GBusNameWatcherFlags;
|
|
|
|
/**
|
|
* GDBusProxyFlags:
|
|
* @G_DBUS_PROXY_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES: Don't load properties.
|
|
* @G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS: Don't connect to signals on the remote object.
|
|
* @G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START: If not set and the proxy if for a well-known name,
|
|
* then request the bus to launch an owner for the name if no-one owns the name. This flag can
|
|
* only be used in proxies for well-known names.
|
|
*
|
|
* Flags used when constructing an instance of a #GDBusProxy derived class.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_DBUS_PROXY_FLAGS_NONE = 0,
|
|
G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES = (1<<0),
|
|
G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS = (1<<1),
|
|
G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START = (1<<2)
|
|
} GDBusProxyFlags;
|
|
|
|
/**
|
|
* GDBusError:
|
|
* @G_DBUS_ERROR_FAILED:
|
|
* A generic error; "something went wrong" - see the error message for
|
|
* more.
|
|
* @G_DBUS_ERROR_NO_MEMORY:
|
|
* There was not enough memory to complete an operation.
|
|
* @G_DBUS_ERROR_SERVICE_UNKNOWN:
|
|
* The bus doesn't know how to launch a service to supply the bus name
|
|
* you wanted.
|
|
* @G_DBUS_ERROR_NAME_HAS_NO_OWNER:
|
|
* The bus name you referenced doesn't exist (i.e. no application owns
|
|
* it).
|
|
* @G_DBUS_ERROR_NO_REPLY:
|
|
* No reply to a message expecting one, usually means a timeout occurred.
|
|
* @G_DBUS_ERROR_IO_ERROR:
|
|
* Something went wrong reading or writing to a socket, for example.
|
|
* @G_DBUS_ERROR_BAD_ADDRESS:
|
|
* A D-Bus bus address was malformed.
|
|
* @G_DBUS_ERROR_NOT_SUPPORTED:
|
|
* Requested operation isn't supported (like ENOSYS on UNIX).
|
|
* @G_DBUS_ERROR_LIMITS_EXCEEDED:
|
|
* Some limited resource is exhausted.
|
|
* @G_DBUS_ERROR_ACCESS_DENIED:
|
|
* Security restrictions don't allow doing what you're trying to do.
|
|
* @G_DBUS_ERROR_AUTH_FAILED:
|
|
* Authentication didn't work.
|
|
* @G_DBUS_ERROR_NO_SERVER:
|
|
* Unable to connect to server (probably caused by ECONNREFUSED on a
|
|
* socket).
|
|
* @G_DBUS_ERROR_TIMEOUT:
|
|
* Certain timeout errors, possibly ETIMEDOUT on a socket. Note that
|
|
* %G_DBUS_ERROR_NO_REPLY is used for message reply timeouts. Warning:
|
|
* this is confusingly-named given that %G_DBUS_ERROR_TIMED_OUT also
|
|
* exists. We can't fix it for compatibility reasons so just be
|
|
* careful.
|
|
* @G_DBUS_ERROR_NO_NETWORK:
|
|
* No network access (probably ENETUNREACH on a socket).
|
|
* @G_DBUS_ERROR_ADDRESS_IN_USE:
|
|
* Can't bind a socket since its address is in use (i.e. EADDRINUSE).
|
|
* @G_DBUS_ERROR_DISCONNECTED:
|
|
* The connection is disconnected and you're trying to use it.
|
|
* @G_DBUS_ERROR_INVALID_ARGS:
|
|
* Invalid arguments passed to a method call.
|
|
* @G_DBUS_ERROR_FILE_NOT_FOUND:
|
|
* Missing file.
|
|
* @G_DBUS_ERROR_FILE_EXISTS:
|
|
* Existing file and the operation you're using does not silently overwrite.
|
|
* @G_DBUS_ERROR_UNKNOWN_METHOD:
|
|
* Method name you invoked isn't known by the object you invoked it on.
|
|
* @G_DBUS_ERROR_TIMED_OUT:
|
|
* Certain timeout errors, e.g. while starting a service. Warning: this is
|
|
* confusingly-named given that %G_DBUS_ERROR_TIMEOUT also exists. We
|
|
* can't fix it for compatibility reasons so just be careful.
|
|
* @G_DBUS_ERROR_MATCH_RULE_NOT_FOUND:
|
|
* Tried to remove or modify a match rule that didn't exist.
|
|
* @G_DBUS_ERROR_MATCH_RULE_INVALID:
|
|
* The match rule isn't syntactically valid.
|
|
* @G_DBUS_ERROR_SPAWN_EXEC_FAILED:
|
|
* While starting a new process, the exec() call failed.
|
|
* @G_DBUS_ERROR_SPAWN_FORK_FAILED:
|
|
* While starting a new process, the fork() call failed.
|
|
* @G_DBUS_ERROR_SPAWN_CHILD_EXITED:
|
|
* While starting a new process, the child exited with a status code.
|
|
* @G_DBUS_ERROR_SPAWN_CHILD_SIGNALED:
|
|
* While starting a new process, the child exited on a signal.
|
|
* @G_DBUS_ERROR_SPAWN_FAILED:
|
|
* While starting a new process, something went wrong.
|
|
* @G_DBUS_ERROR_SPAWN_SETUP_FAILED:
|
|
* We failed to setup the environment correctly.
|
|
* @G_DBUS_ERROR_SPAWN_CONFIG_INVALID:
|
|
* We failed to setup the config parser correctly.
|
|
* @G_DBUS_ERROR_SPAWN_SERVICE_INVALID:
|
|
* Bus name was not valid.
|
|
* @G_DBUS_ERROR_SPAWN_SERVICE_NOT_FOUND:
|
|
* Service file not found in system-services directory.
|
|
* @G_DBUS_ERROR_SPAWN_PERMISSIONS_INVALID:
|
|
* Permissions are incorrect on the setuid helper.
|
|
* @G_DBUS_ERROR_SPAWN_FILE_INVALID:
|
|
* Service file invalid (Name, User or Exec missing).
|
|
* @G_DBUS_ERROR_SPAWN_NO_MEMORY:
|
|
* Tried to get a UNIX process ID and it wasn't available.
|
|
* @G_DBUS_ERROR_UNIX_PROCESS_ID_UNKNOWN:
|
|
* Tried to get a UNIX process ID and it wasn't available.
|
|
* @G_DBUS_ERROR_INVALID_SIGNATURE:
|
|
* A type signature is not valid.
|
|
* @G_DBUS_ERROR_INVALID_FILE_CONTENT:
|
|
* A file contains invalid syntax or is otherwise broken.
|
|
* @G_DBUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN:
|
|
* Asked for SELinux security context and it wasn't available.
|
|
* @G_DBUS_ERROR_ADT_AUDIT_DATA_UNKNOWN:
|
|
* Asked for ADT audit data and it wasn't available.
|
|
* @G_DBUS_ERROR_OBJECT_PATH_IN_USE:
|
|
* There's already an object with the requested object path.
|
|
*
|
|
* Error codes for the %G_DBUS_ERROR error domain.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
/* Well-known errors in the org.freedesktop.DBus.Error namespace */
|
|
G_DBUS_ERROR_FAILED, /* org.freedesktop.DBus.Error.Failed */
|
|
G_DBUS_ERROR_NO_MEMORY, /* org.freedesktop.DBus.Error.NoMemory */
|
|
G_DBUS_ERROR_SERVICE_UNKNOWN, /* org.freedesktop.DBus.Error.ServiceUnknown */
|
|
G_DBUS_ERROR_NAME_HAS_NO_OWNER, /* org.freedesktop.DBus.Error.NameHasNoOwner */
|
|
G_DBUS_ERROR_NO_REPLY, /* org.freedesktop.DBus.Error.NoReply */
|
|
G_DBUS_ERROR_IO_ERROR, /* org.freedesktop.DBus.Error.IOError */
|
|
G_DBUS_ERROR_BAD_ADDRESS, /* org.freedesktop.DBus.Error.BadAddress */
|
|
G_DBUS_ERROR_NOT_SUPPORTED, /* org.freedesktop.DBus.Error.NotSupported */
|
|
G_DBUS_ERROR_LIMITS_EXCEEDED, /* org.freedesktop.DBus.Error.LimitsExceeded */
|
|
G_DBUS_ERROR_ACCESS_DENIED, /* org.freedesktop.DBus.Error.AccessDenied */
|
|
G_DBUS_ERROR_AUTH_FAILED, /* org.freedesktop.DBus.Error.AuthFailed */
|
|
G_DBUS_ERROR_NO_SERVER, /* org.freedesktop.DBus.Error.NoServer */
|
|
G_DBUS_ERROR_TIMEOUT, /* org.freedesktop.DBus.Error.Timeout */
|
|
G_DBUS_ERROR_NO_NETWORK, /* org.freedesktop.DBus.Error.NoNetwork */
|
|
G_DBUS_ERROR_ADDRESS_IN_USE, /* org.freedesktop.DBus.Error.AddressInUse */
|
|
G_DBUS_ERROR_DISCONNECTED, /* org.freedesktop.DBus.Error.Disconnected */
|
|
G_DBUS_ERROR_INVALID_ARGS, /* org.freedesktop.DBus.Error.InvalidArgs */
|
|
G_DBUS_ERROR_FILE_NOT_FOUND, /* org.freedesktop.DBus.Error.FileNotFound */
|
|
G_DBUS_ERROR_FILE_EXISTS, /* org.freedesktop.DBus.Error.FileExists */
|
|
G_DBUS_ERROR_UNKNOWN_METHOD, /* org.freedesktop.DBus.Error.UnknownMethod */
|
|
G_DBUS_ERROR_TIMED_OUT, /* org.freedesktop.DBus.Error.TimedOut */
|
|
G_DBUS_ERROR_MATCH_RULE_NOT_FOUND, /* org.freedesktop.DBus.Error.MatchRuleNotFound */
|
|
G_DBUS_ERROR_MATCH_RULE_INVALID, /* org.freedesktop.DBus.Error.MatchRuleInvalid */
|
|
G_DBUS_ERROR_SPAWN_EXEC_FAILED, /* org.freedesktop.DBus.Error.Spawn.ExecFailed */
|
|
G_DBUS_ERROR_SPAWN_FORK_FAILED, /* org.freedesktop.DBus.Error.Spawn.ForkFailed */
|
|
G_DBUS_ERROR_SPAWN_CHILD_EXITED, /* org.freedesktop.DBus.Error.Spawn.ChildExited */
|
|
G_DBUS_ERROR_SPAWN_CHILD_SIGNALED, /* org.freedesktop.DBus.Error.Spawn.ChildSignaled */
|
|
G_DBUS_ERROR_SPAWN_FAILED, /* org.freedesktop.DBus.Error.Spawn.Failed */
|
|
G_DBUS_ERROR_SPAWN_SETUP_FAILED, /* org.freedesktop.DBus.Error.Spawn.FailedToSetup */
|
|
G_DBUS_ERROR_SPAWN_CONFIG_INVALID, /* org.freedesktop.DBus.Error.Spawn.ConfigInvalid */
|
|
G_DBUS_ERROR_SPAWN_SERVICE_INVALID, /* org.freedesktop.DBus.Error.Spawn.ServiceNotValid */
|
|
G_DBUS_ERROR_SPAWN_SERVICE_NOT_FOUND, /* org.freedesktop.DBus.Error.Spawn.ServiceNotFound */
|
|
G_DBUS_ERROR_SPAWN_PERMISSIONS_INVALID, /* org.freedesktop.DBus.Error.Spawn.PermissionsInvalid */
|
|
G_DBUS_ERROR_SPAWN_FILE_INVALID, /* org.freedesktop.DBus.Error.Spawn.FileInvalid */
|
|
G_DBUS_ERROR_SPAWN_NO_MEMORY, /* org.freedesktop.DBus.Error.Spawn.NoMemory */
|
|
G_DBUS_ERROR_UNIX_PROCESS_ID_UNKNOWN, /* org.freedesktop.DBus.Error.UnixProcessIdUnknown */
|
|
G_DBUS_ERROR_INVALID_SIGNATURE, /* org.freedesktop.DBus.Error.InvalidSignature */
|
|
G_DBUS_ERROR_INVALID_FILE_CONTENT, /* org.freedesktop.DBus.Error.InvalidFileContent */
|
|
G_DBUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN, /* org.freedesktop.DBus.Error.SELinuxSecurityContextUnknown */
|
|
G_DBUS_ERROR_ADT_AUDIT_DATA_UNKNOWN, /* org.freedesktop.DBus.Error.AdtAuditDataUnknown */
|
|
G_DBUS_ERROR_OBJECT_PATH_IN_USE /* org.freedesktop.DBus.Error.ObjectPathInUse */
|
|
} GDBusError;
|
|
/* Remember to update g_dbus_error_quark() in gdbuserror.c if you extend this enumeration */
|
|
|
|
/**
|
|
* GDBusConnectionFlags:
|
|
* @G_DBUS_CONNECTION_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT: Perform authentication against server.
|
|
* @G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER: Perform authentication against client.
|
|
* @G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS: When
|
|
* authenticating as a server, allow the anonymous authentication
|
|
* method.
|
|
* @G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION: Pass this flag if connecting to a peer that is a
|
|
* message bus. This means that the Hello() method will be invoked as part of the connection setup.
|
|
* @G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING: If set, processing of D-Bus messages is
|
|
* delayed until g_dbus_connection_start_message_processing() is called.
|
|
*
|
|
* Flags used when creating a new #GDBusConnection.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum {
|
|
G_DBUS_CONNECTION_FLAGS_NONE = 0,
|
|
G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT = (1<<0),
|
|
G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER = (1<<1),
|
|
G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS = (1<<2),
|
|
G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION = (1<<3),
|
|
G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING = (1<<4)
|
|
} GDBusConnectionFlags;
|
|
|
|
/**
|
|
* GDBusCapabilityFlags:
|
|
* @G_DBUS_CAPABILITY_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_CAPABILITY_FLAGS_UNIX_FD_PASSING: The connection
|
|
* supports exchanging UNIX file descriptors with the remote peer.
|
|
*
|
|
* Capabilities negotiated with the remote peer.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum {
|
|
G_DBUS_CAPABILITY_FLAGS_NONE = 0,
|
|
G_DBUS_CAPABILITY_FLAGS_UNIX_FD_PASSING = (1<<0)
|
|
} GDBusCapabilityFlags;
|
|
|
|
/**
|
|
* GDBusCallFlags:
|
|
* @G_DBUS_CALL_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_CALL_FLAGS_NO_AUTO_START: The bus must not launch
|
|
* an owner for the destination name in response to this method
|
|
* invocation.
|
|
*
|
|
* Flags used in g_dbus_connection_call() and similar APIs.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum {
|
|
G_DBUS_CALL_FLAGS_NONE = 0,
|
|
G_DBUS_CALL_FLAGS_NO_AUTO_START = (1<<0)
|
|
} GDBusCallFlags;
|
|
|
|
/**
|
|
* GDBusMessageType:
|
|
* @G_DBUS_MESSAGE_TYPE_INVALID: Message is of invalid type.
|
|
* @G_DBUS_MESSAGE_TYPE_METHOD_CALL: Method call.
|
|
* @G_DBUS_MESSAGE_TYPE_METHOD_RETURN: Method reply.
|
|
* @G_DBUS_MESSAGE_TYPE_ERROR: Error reply.
|
|
* @G_DBUS_MESSAGE_TYPE_SIGNAL: Signal emission.
|
|
*
|
|
* Message types used in #GDBusMessage.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum {
|
|
G_DBUS_MESSAGE_TYPE_INVALID,
|
|
G_DBUS_MESSAGE_TYPE_METHOD_CALL,
|
|
G_DBUS_MESSAGE_TYPE_METHOD_RETURN,
|
|
G_DBUS_MESSAGE_TYPE_ERROR,
|
|
G_DBUS_MESSAGE_TYPE_SIGNAL
|
|
} GDBusMessageType;
|
|
|
|
/**
|
|
* GDBusMessageFlags:
|
|
* @G_DBUS_MESSAGE_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED: A reply is not expected.
|
|
* @G_DBUS_MESSAGE_FLAGS_NO_AUTO_START: The bus must not launch an
|
|
* owner for the destination name in response to this message.
|
|
*
|
|
* Message flags used in #GDBusMessage.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum {
|
|
G_DBUS_MESSAGE_FLAGS_NONE = 0,
|
|
G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED = (1<<0),
|
|
G_DBUS_MESSAGE_FLAGS_NO_AUTO_START = (1<<1)
|
|
} GDBusMessageFlags;
|
|
|
|
/**
|
|
* GDBusMessageHeaderField:
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_INVALID: Not a valid header field.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_PATH: The object path.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE: The interface name.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_MEMBER: The method or signal name.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME: The name of the error that occurred.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL: The serial number the message is a reply to.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION: The name the message is intended for.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_SENDER: Unique name of the sender of the message (filled in by the bus).
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE: The signature of the message body.
|
|
* @G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS: The number of UNIX file descriptors that accompany the message.
|
|
*
|
|
* Header fields used in #GDBusMessage.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum {
|
|
G_DBUS_MESSAGE_HEADER_FIELD_INVALID,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_PATH,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_MEMBER,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_SENDER,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE,
|
|
G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS
|
|
} GDBusMessageHeaderField;
|
|
|
|
/**
|
|
* GDBusPropertyInfoFlags:
|
|
* @G_DBUS_PROPERTY_INFO_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_PROPERTY_INFO_FLAGS_READABLE: Property is readable.
|
|
* @G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE: Property is writable.
|
|
*
|
|
* Flags describing the access control of a D-Bus property.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_DBUS_PROPERTY_INFO_FLAGS_NONE = 0,
|
|
G_DBUS_PROPERTY_INFO_FLAGS_READABLE = (1<<0),
|
|
G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE = (1<<1)
|
|
} GDBusPropertyInfoFlags;
|
|
|
|
/**
|
|
* GDBusSubtreeFlags:
|
|
* @G_DBUS_SUBTREE_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES: Method calls to objects not in the enumerated range
|
|
* will still be dispatched. This is useful if you want
|
|
* to dynamically spawn objects in the subtree.
|
|
*
|
|
* Flags passed to g_dbus_connection_register_subtree().
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_DBUS_SUBTREE_FLAGS_NONE = 0,
|
|
G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES = (1<<0)
|
|
} GDBusSubtreeFlags;
|
|
|
|
/**
|
|
* GDBusServerFlags:
|
|
* @G_DBUS_SERVER_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_SERVER_FLAGS_RUN_IN_THREAD: All #GDBusServer::new-connection
|
|
* signals will run in separated dedicated threads (see signal for
|
|
* details).
|
|
* @G_DBUS_SERVER_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS: Allow the anonymous
|
|
* authentication method.
|
|
*
|
|
* Flags used when creating a #GDBusServer.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_DBUS_SERVER_FLAGS_NONE = 0,
|
|
G_DBUS_SERVER_FLAGS_RUN_IN_THREAD = (1<<0),
|
|
G_DBUS_SERVER_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS = (1<<1)
|
|
} GDBusServerFlags;
|
|
|
|
/**
|
|
* GDBusSignalFlags:
|
|
* @G_DBUS_SIGNAL_FLAGS_NONE: No flags set.
|
|
*
|
|
* Flags used when subscribing to signals via g_dbus_connection_signal_subscribe().
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum /*< flags >*/
|
|
{
|
|
G_DBUS_SIGNAL_FLAGS_NONE = 0,
|
|
} GDBusSignalFlags;
|
|
|
|
/**
|
|
* GDBusSendMessageFlags:
|
|
* @G_DBUS_SEND_MESSAGE_FLAGS_NONE: No flags set.
|
|
* @G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL: Do not automatically
|
|
* assign a serial number from the #GDBusConnection object when
|
|
* sending a message.
|
|
*
|
|
* Flags used when sending #GDBusMessage<!-- -->s on a #GDBusConnection.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_DBUS_SEND_MESSAGE_FLAGS_NONE = 0,
|
|
G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL = (1<<0)
|
|
} GDBusSendMessageFlags;
|
|
|
|
/**
|
|
* GCredentialsType:
|
|
* @G_CREDENTIALS_TYPE_INVALID: Indicates an invalid native credential type.
|
|
* @G_CREDENTIALS_TYPE_LINUX_UCRED: The native credentials type is a <type>struct ucred</type>.
|
|
*
|
|
* Enumeration describing different kinds of native credential types.
|
|
*
|
|
* Since: 2.26
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_CREDENTIALS_TYPE_INVALID,
|
|
G_CREDENTIALS_TYPE_LINUX_UCRED
|
|
} GCredentialsType;
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GIO_ENUMS_H__ */
|