2008-07-01 08:32:35 +02:00
/* GIO - GLib Input, Output and Streaming Library
2008-09-02 21:05:58 +02:00
*
2008-07-01 08:32:35 +02:00
* 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
2017-05-27 18:21:30 +02:00
* version 2.1 of the License , or ( at your option ) any later version .
2008-07-01 08:32:35 +02:00
*
* 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
2014-01-23 12:58:29 +01:00
* Public License along with this library ; if not , see < http : //www.gnu.org/licenses/>.
2008-07-01 08:32:35 +02:00
*
* Author : Alexander Larsson < alexl @ redhat . com >
*/
2012-12-28 05:43:14 +01:00
# ifndef __GIO_ENUMS_H__
# define __GIO_ENUMS_H__
2008-07-01 08:32:35 +02:00
# if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
# error "Only <gio / gio.h> can be included directly."
# endif
# 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 .
2010-07-10 23:57:45 +02:00
* @ G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION : Application supports startup notification . Since 2.26
2008-07-01 08:32:35 +02:00
*
* Flags used when creating a # GAppInfo .
*/
typedef enum {
2010-07-10 23:57:45 +02:00
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 >*/
2008-07-01 08:32:35 +02:00
} GAppInfoCreateFlags ;
2009-11-18 13:14:13 +01:00
/**
* 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 >*/
2009-12-01 19:42:09 +01:00
G_CONVERTER_FLUSH = ( 1 < < 1 ) /*< nick=flush >*/
2009-11-18 13:14:13 +01:00
} 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 {
2009-12-01 19:42:09 +01:00
G_CONVERTER_ERROR = 0 , /*< nick=error >*/
2009-11-18 13:14:13 +01:00
G_CONVERTER_CONVERTED = 1 , /*< nick=converted >*/
G_CONVERTER_FINISHED = 2 , /*< nick=finished >*/
2009-12-01 19:42:09 +01:00
G_CONVERTER_FLUSHED = 3 /*< nick=flushed >*/
2009-11-18 13:14:13 +01:00
} GConverterResult ;
2008-07-01 08:32:35 +02:00
/**
* 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 .
2008-09-02 21:05:58 +02:00
*
2008-07-01 08:32:35 +02:00
* # 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 :
2020-06-12 15:02:30 +02:00
* @ G_FILE_ATTRIBUTE_TYPE_INVALID : indicates an invalid or uninitialized type .
2008-07-01 08:32:35 +02:00
* @ 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 .
2009-06-22 19:25:32 +02:00
* @ G_FILE_ATTRIBUTE_TYPE_STRINGV : a % NULL terminated char * * . Since 2.22
2008-07-01 08:32:35 +02:00
*
* 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 ,
2009-06-22 19:25:32 +02:00
G_FILE_ATTRIBUTE_TYPE_OBJECT ,
G_FILE_ATTRIBUTE_TYPE_STRINGV
2008-07-01 08:32:35 +02:00
} 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 .
2009-02-18 15:49:25 +01:00
* @ 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
2010-06-04 17:07:05 +02:00
* is generally useful if you ' re doing a " copy over "
2009-02-18 15:49:25 +01:00
* 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
2020-07-27 17:35:38 +02:00
* be exactly like that . This flag can only be used with
* g_file_replace ( ) and its variants , including g_file_replace_contents ( ) .
* Since 2.20
2008-07-01 08:32:35 +02:00
*
* Flags used when an operation may create a file .
*/
typedef enum {
G_FILE_CREATE_NONE = 0 ,
2009-02-18 15:49:25 +01:00
G_FILE_CREATE_PRIVATE = ( 1 < < 0 ) ,
G_FILE_CREATE_REPLACE_DESTINATION = ( 1 < < 1 )
2008-07-01 08:32:35 +02:00
} GFileCreateFlags ;
2013-07-28 19:41:17 +02:00
/**
* GFileMeasureFlags :
* @ G_FILE_MEASURE_NONE : No flags set .
* @ G_FILE_MEASURE_REPORT_ANY_ERROR : Report any error encountered
* while traversing the directory tree . Normally errors are only
* reported for the toplevel file .
* @ G_FILE_MEASURE_APPARENT_SIZE : Tally usage based on apparent file
* sizes . Normally , the block - size is used , if available , as this is a
* more accurate representation of disk space used .
2014-03-03 00:20:37 +01:00
* Compare with ` du - - apparent - size ` .
2013-07-28 19:41:17 +02:00
* @ G_FILE_MEASURE_NO_XDEV : Do not cross mount point boundaries .
2014-03-03 00:20:37 +01:00
* Compare with ` du - x ` .
2013-07-28 19:41:17 +02:00
*
* Flags that can be used with g_file_measure_disk_usage ( ) .
*
* Since : 2.38
* */
typedef enum {
G_FILE_MEASURE_NONE = 0 ,
G_FILE_MEASURE_REPORT_ANY_ERROR = ( 1 < < 1 ) ,
G_FILE_MEASURE_APPARENT_SIZE = ( 1 < < 2 ) ,
G_FILE_MEASURE_NO_XDEV = ( 1 < < 3 )
} GFileMeasureFlags ;
2008-07-01 08:32:35 +02:00
/**
* GMountMountFlags :
* @ G_MOUNT_MOUNT_NONE : No flags set .
*
* Flags used when mounting a mount .
*/
2012-01-15 00:34:56 +01:00
typedef enum /*< flags >*/ {
2008-07-01 08:32:35 +02:00
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 ;
2009-06-15 16:53:41 +02:00
/**
* GDriveStartFlags :
* @ G_DRIVE_START_NONE : No flags set .
*
* Flags used when starting a drive .
*
* Since : 2.22
*/
2012-01-15 00:34:56 +01:00
typedef enum /*< flags >*/ {
2009-06-15 16:53:41 +02:00
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 ;
2008-07-01 08:32:35 +02:00
/**
* 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 .
2008-09-22 01:53:40 +02:00
* @ G_FILE_COPY_TARGET_DEFAULT_PERMS : Leaves target file with default perms , instead of setting the source file perms .
2008-07-01 08:32:35 +02:00
*
* 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 ) ,
2008-09-22 01:53:40 +02:00
G_FILE_COPY_NO_FALLBACK_FOR_MOVE = ( 1 < < 4 ) ,
G_FILE_COPY_TARGET_DEFAULT_PERMS = ( 1 < < 5 )
2008-07-01 08:32:35 +02:00
} GFileCopyFlags ;
/**
* GFileMonitorFlags :
* @ G_FILE_MONITOR_NONE : No flags set .
* @ G_FILE_MONITOR_WATCH_MOUNTS : Watch for mount events .
2010-02-18 15:40:13 +01:00
* @ 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
2016-08-08 15:49:26 +02:00
* and CREATED events ) . Deprecated since 2.46 : use
2015-01-12 20:59:35 +01:00
* % G_FILE_MONITOR_WATCH_MOVES instead .
2009-11-19 00:59:14 +01:00
* @ G_FILE_MONITOR_WATCH_HARD_LINKS : Watch for changes to the file made
2012-12-19 14:22:23 +01:00
* via another hard link . Since 2.36 .
2015-01-12 20:59:35 +01:00
* @ G_FILE_MONITOR_WATCH_MOVES : Watch for rename operations on a
* monitored directory . This causes % G_FILE_MONITOR_EVENT_RENAMED ,
* % G_FILE_MONITOR_EVENT_MOVED_IN and % G_FILE_MONITOR_EVENT_MOVED_OUT
2016-08-08 15:49:26 +02:00
* events to be emitted when possible . Since : 2.46 .
2008-07-01 08:32:35 +02:00
*
* Flags used to set what a # GFileMonitor will watch for .
*/
typedef enum {
2009-11-19 00:59:14 +01:00
G_FILE_MONITOR_NONE = 0 ,
G_FILE_MONITOR_WATCH_MOUNTS = ( 1 < < 0 ) ,
G_FILE_MONITOR_SEND_MOVED = ( 1 < < 1 ) ,
2015-01-12 20:59:35 +01:00
G_FILE_MONITOR_WATCH_HARD_LINKS = ( 1 < < 2 ) ,
G_FILE_MONITOR_WATCH_MOVES = ( 1 < < 3 )
2008-07-01 08:32:35 +02:00
} 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 .
2018-08-24 10:57:20 +02:00
*
* On Windows systems a file will never have % G_FILE_TYPE_SYMBOLIC_LINK type ;
* use # GFileInfo and % G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK to determine
* whether a file is a symlink or not . This is due to the fact that NTFS does
* not have a single filesystem object type for symbolic links - it has
* files that symlink to files , and directories that symlink to directories .
* # GFileType enumeration cannot precisely represent this important distinction ,
* which is why all Windows symlinks will continue to be reported as
* % G_FILE_TYPE_REGULAR or % G_FILE_TYPE_DIRECTORY .
2008-07-01 08:32:35 +02:00
* */
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 .
2015-01-12 20:59:35 +01:00
* @ G_FILE_MONITOR_EVENT_MOVED : the file was moved - - only sent if the
* ( deprecated ) % G_FILE_MONITOR_SEND_MOVED flag is set
* @ G_FILE_MONITOR_EVENT_RENAMED : the file was renamed within the
* current directory - - only sent if the % G_FILE_MONITOR_WATCH_MOVES
2016-08-08 15:49:26 +02:00
* flag is set . Since : 2.46 .
2015-01-12 20:59:35 +01:00
* @ G_FILE_MONITOR_EVENT_MOVED_IN : the file was moved into the
* monitored directory from another location - - only sent if the
2016-08-08 15:49:26 +02:00
* % G_FILE_MONITOR_WATCH_MOVES flag is set . Since : 2.46 .
2015-01-12 20:59:35 +01:00
* @ G_FILE_MONITOR_EVENT_MOVED_OUT : the file was moved out of the
* monitored directory to another location - - only sent if the
2016-08-08 15:49:26 +02:00
* % G_FILE_MONITOR_WATCH_MOVES flag is set . Since : 2.46
2008-07-01 08:32:35 +02:00
*
* 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 ,
2010-02-18 15:40:13 +01:00
G_FILE_MONITOR_EVENT_UNMOUNTED ,
2015-01-12 20:59:35 +01:00
G_FILE_MONITOR_EVENT_MOVED ,
G_FILE_MONITOR_EVENT_RENAMED ,
G_FILE_MONITOR_EVENT_MOVED_IN ,
G_FILE_MONITOR_EVENT_MOVED_OUT
2008-07-01 08:32:35 +02:00
} 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 :
2014-03-20 14:25:19 +01:00
* @ G_IO_ERROR_FAILED : Generic error condition for when an operation fails
* and no more specific # GIOErrorEnum value is defined .
2012-02-03 17:39:27 +01:00
* @ G_IO_ERROR_NOT_FOUND : File not found .
* @ G_IO_ERROR_EXISTS : File already exists .
* @ G_IO_ERROR_IS_DIRECTORY : File is a directory .
2008-07-01 08:32:35 +02:00
* @ 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 .
2014-03-21 21:54:04 +01:00
* @ G_IO_ERROR_NOT_SUPPORTED : Operation ( or one of its parameters ) not supported
2008-07-01 08:32:35 +02:00
* @ 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 .
2010-06-04 17:07:05 +02:00
* @ G_IO_ERROR_FAILED_HANDLED : Operation failed and a helper program has
2009-01-08 02:32:15 +01:00
* already interacted with the user . Do not display any error dialog .
2010-06-04 17:07:05 +02:00
* @ 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
2009-01-08 02:32:15 +01:00
* this limit . Since 2.20
2009-05-14 15:26:37 +02:00
* @ 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
2009-10-20 14:12:31 +02:00
* @ G_IO_ERROR_PARTIAL_INPUT : Need more input to finish operation . Since 2.24
2013-01-10 12:16:47 +01:00
* @ G_IO_ERROR_INVALID_DATA : The input data was invalid . Since 2.24
2010-05-06 20:13:59 +02:00
* @ 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 .
2010-04-28 21:39:56 +02:00
* @ G_IO_ERROR_HOST_UNREACHABLE : Host unreachable . Since 2.26
* @ G_IO_ERROR_NETWORK_UNREACHABLE : Network unreachable . Since 2.26
* @ G_IO_ERROR_CONNECTION_REFUSED : Connection refused . Since 2.26
* @ G_IO_ERROR_PROXY_FAILED : Connection to proxy server failed . Since 2.26
* @ G_IO_ERROR_PROXY_AUTH_FAILED : Proxy authentication failed . Since 2.26
* @ G_IO_ERROR_PROXY_NEED_AUTH : Proxy server needs authentication . Since 2.26
* @ G_IO_ERROR_PROXY_NOT_ALLOWED : Proxy connection is not allowed by ruleset .
* Since 2.26
2012-11-29 20:12:25 +01:00
* @ G_IO_ERROR_BROKEN_PIPE : Broken pipe . Since 2.36
2011-08-19 16:23:12 +02:00
* @ G_IO_ERROR_CONNECTION_CLOSED : Connection closed by peer . Note that this
* is the same code as % G_IO_ERROR_BROKEN_PIPE ; before 2.44 some
* " connection closed " errors returned % G_IO_ERROR_BROKEN_PIPE , but others
* returned % G_IO_ERROR_FAILED . Now they should all return the same
* value , which has this more logical name . Since 2.44 .
2014-12-02 13:50:51 +01:00
* @ G_IO_ERROR_NOT_CONNECTED : Transport endpoint is not connected . Since 2.44
2015-07-02 12:32:34 +02:00
* @ G_IO_ERROR_MESSAGE_TOO_LARGE : Message too large . Since 2.48 .
2008-07-01 08:32:35 +02:00
*
* Error codes returned by GIO functions .
*
2014-03-20 14:25:19 +01:00
* Note that this domain may be extended in future GLib releases . In
* general , new error codes either only apply to new APIs , or else
2011-08-19 16:23:12 +02:00
* replace % G_IO_ERROR_FAILED in cases that were not explicitly
2014-03-20 14:25:19 +01:00
* distinguished before . You should therefore avoid writing code like
* | [ < ! - - language = " C " - - >
* if ( g_error_matches ( error , G_IO_ERROR , G_IO_ERROR_FAILED ) )
* {
* // Assume that this is EPRINTERONFIRE
* . . .
* }
* ] |
* but should instead treat all unrecognized error codes the same as
* # G_IO_ERROR_FAILED .
2019-01-04 11:48:26 +01:00
*
* See also # GPollableReturn for a cheaper way of returning
* % G_IO_ERROR_WOULD_BLOCK to callers without allocating a # GError .
2008-07-01 08:32:35 +02:00
* */
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 ,
2009-01-08 02:32:15 +01:00
G_IO_ERROR_FAILED_HANDLED ,
2009-05-14 15:26:37 +02:00
G_IO_ERROR_TOO_MANY_OPEN_FILES ,
G_IO_ERROR_NOT_INITIALIZED ,
2009-10-20 14:12:31 +02:00
G_IO_ERROR_ADDRESS_IN_USE ,
G_IO_ERROR_PARTIAL_INPUT ,
2010-05-06 20:13:59 +02:00
G_IO_ERROR_INVALID_DATA ,
2010-04-28 21:39:56 +02:00
G_IO_ERROR_DBUS_ERROR ,
G_IO_ERROR_HOST_UNREACHABLE ,
G_IO_ERROR_NETWORK_UNREACHABLE ,
G_IO_ERROR_CONNECTION_REFUSED ,
G_IO_ERROR_PROXY_FAILED ,
G_IO_ERROR_PROXY_AUTH_FAILED ,
G_IO_ERROR_PROXY_NEED_AUTH ,
2012-11-29 20:12:25 +01:00
G_IO_ERROR_PROXY_NOT_ALLOWED ,
2011-08-19 16:23:12 +02:00
G_IO_ERROR_BROKEN_PIPE ,
2014-12-02 14:29:11 +01:00
G_IO_ERROR_CONNECTION_CLOSED = G_IO_ERROR_BROKEN_PIPE ,
2015-07-02 12:32:34 +02:00
G_IO_ERROR_NOT_CONNECTED ,
2016-04-17 10:04:13 +02:00
G_IO_ERROR_MESSAGE_TOO_LARGE
2008-07-01 08:32:35 +02:00
} 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 .
2018-03-09 00:40:17 +01:00
* @ G_ASK_PASSWORD_TCRYPT : operation takes TCRYPT parameters ( Since : 2.58 )
2008-07-01 08:32:35 +02:00
*
* # GAskPasswordFlags are used to request specific information from the
* user , or to notify the user of their choices in an authentication
* situation .
* */
typedef enum {
2018-03-09 00:40:17 +01:00
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 ) ,
G_ASK_PASSWORD_TCRYPT = ( 1 < < 5 ) ,
2008-07-01 08:32:35 +02:00
} 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 .
2008-09-02 21:05:58 +02:00
*
2008-07-01 08:32:35 +02:00
* # 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 :
2008-09-02 21:05:58 +02:00
* @ G_MOUNT_OPERATION_HANDLED : The request was fulfilled and the
2008-07-21 04:46:54 +02:00
* user specified data is now available
2008-09-02 21:05:58 +02:00
* @ G_MOUNT_OPERATION_ABORTED : The user requested the mount operation
2008-07-21 04:46:54 +02:00
* to be aborted
2008-09-02 21:05:58 +02:00
* @ G_MOUNT_OPERATION_UNHANDLED : The request was unhandled ( i . e . not
2008-07-21 04:46:54 +02:00
* implemented )
2008-09-02 21:05:58 +02:00
*
* # GMountOperationResult is returned as a result when a request for
2008-07-21 04:46:54 +02:00
* information is send by the mounting operation .
2008-07-01 08:32:35 +02:00
* */
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 .
2008-09-02 21:05:58 +02:00
* @ G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE : Close the source stream after
2008-07-21 04:46:54 +02:00
* the splice .
2008-09-02 21:05:58 +02:00
* @ G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET : Close the target stream after
2008-07-21 04:46:54 +02:00
* the splice .
2008-07-01 08:32:35 +02:00
*
* 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 ;
2010-08-13 10:10:48 +02:00
/**
* GIOStreamSpliceFlags :
* @ G_IO_STREAM_SPLICE_NONE : Do not close either stream .
* @ G_IO_STREAM_SPLICE_CLOSE_STREAM1 : Close the first stream after
* the splice .
* @ G_IO_STREAM_SPLICE_CLOSE_STREAM2 : Close the second stream after
* the splice .
* @ G_IO_STREAM_SPLICE_WAIT_FOR_BOTH : Wait for both splice operations to finish
* before calling the callback .
*
* GIOStreamSpliceFlags determine how streams should be spliced .
2010-12-13 17:42:11 +01:00
*
* Since : 2.28
2010-08-13 10:10:48 +02:00
* */
typedef enum {
G_IO_STREAM_SPLICE_NONE = 0 ,
G_IO_STREAM_SPLICE_CLOSE_STREAM1 = ( 1 < < 0 ) ,
G_IO_STREAM_SPLICE_CLOSE_STREAM2 = ( 1 < < 1 ) ,
2010-12-16 10:57:18 +01:00
G_IO_STREAM_SPLICE_WAIT_FOR_BOTH = ( 1 < < 2 )
2010-08-13 10:10:48 +02:00
} GIOStreamSpliceFlags ;
2008-08-04 19:19:30 +02:00
/**
* GEmblemOrigin :
* @ G_EMBLEM_ORIGIN_UNKNOWN : Emblem of unknown origin
2009-05-18 13:02:11 +02:00
* @ G_EMBLEM_ORIGIN_DEVICE : Emblem adds device - specific information
2008-09-02 21:05:58 +02:00
* @ G_EMBLEM_ORIGIN_LIVEMETADATA : Emblem depicts live metadata , such as " readonly "
2008-08-04 19:19:30 +02:00
* @ 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 ;
2008-12-29 18:53:47 +01:00
/**
* GResolverError :
2009-05-28 00:20:08 +02:00
* @ 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
2008-12-29 18:53:47 +01:00
* @ G_RESOLVER_ERROR_INTERNAL : unknown error
*
* An error code used with % G_RESOLVER_ERROR in a # GError returned
* from a # GResolver routine .
2009-05-28 00:20:08 +02:00
*
* Since : 2.22
2008-12-29 18:53:47 +01:00
*/
typedef enum {
G_RESOLVER_ERROR_NOT_FOUND ,
G_RESOLVER_ERROR_TEMPORARY_FAILURE ,
G_RESOLVER_ERROR_INTERNAL
} GResolverError ;
2011-12-21 21:38:23 +01:00
Add support for MX, TXT, NS and SOA records to GResolver
* Add resolver functions for looking up DNS records of
various types. Currently implemented: MX, TXT, SOA, SRV, NS
* Return records as GVariant tuples.
* Make the GSrvTarget lookups a wrapper over this new
functionality.
* Rework the resolver test so that it has support for
looking up MX, NS, SOA, TXT records, and uses GOptionContext
https://bugzilla.gnome.org/show_bug.cgi?id=672944
2012-04-04 17:13:10 +02:00
/**
* GResolverRecordType :
2019-04-26 13:12:31 +02:00
* @ G_RESOLVER_RECORD_SRV : look up DNS SRV records for a domain
* @ G_RESOLVER_RECORD_MX : look up DNS MX records for a domain
* @ G_RESOLVER_RECORD_TXT : look up DNS TXT records for a name
* @ G_RESOLVER_RECORD_SOA : look up DNS SOA records for a zone
* @ G_RESOLVER_RECORD_NS : look up DNS NS records for a domain
Add support for MX, TXT, NS and SOA records to GResolver
* Add resolver functions for looking up DNS records of
various types. Currently implemented: MX, TXT, SOA, SRV, NS
* Return records as GVariant tuples.
* Make the GSrvTarget lookups a wrapper over this new
functionality.
* Rework the resolver test so that it has support for
looking up MX, NS, SOA, TXT records, and uses GOptionContext
https://bugzilla.gnome.org/show_bug.cgi?id=672944
2012-04-04 17:13:10 +02:00
*
* The type of record that g_resolver_lookup_records ( ) or
* g_resolver_lookup_records_async ( ) should retrieve . The records are returned
* as lists of # GVariant tuples . Each record type has different values in
* the variant tuples returned .
*
* % G_RESOLVER_RECORD_SRV records are returned as variants with the signature
2019-04-26 13:15:55 +02:00
* ` ( qqqs ) ` , containing a ` guint16 ` with the priority , a ` guint16 ` with the
* weight , a ` guint16 ` with the port , and a string of the hostname .
Add support for MX, TXT, NS and SOA records to GResolver
* Add resolver functions for looking up DNS records of
various types. Currently implemented: MX, TXT, SOA, SRV, NS
* Return records as GVariant tuples.
* Make the GSrvTarget lookups a wrapper over this new
functionality.
* Rework the resolver test so that it has support for
looking up MX, NS, SOA, TXT records, and uses GOptionContext
https://bugzilla.gnome.org/show_bug.cgi?id=672944
2012-04-04 17:13:10 +02:00
*
* % G_RESOLVER_RECORD_MX records are returned as variants with the signature
2019-04-26 13:15:55 +02:00
* ` ( qs ) ` , representing a ` guint16 ` with the preference , and a string containing
Add support for MX, TXT, NS and SOA records to GResolver
* Add resolver functions for looking up DNS records of
various types. Currently implemented: MX, TXT, SOA, SRV, NS
* Return records as GVariant tuples.
* Make the GSrvTarget lookups a wrapper over this new
functionality.
* Rework the resolver test so that it has support for
looking up MX, NS, SOA, TXT records, and uses GOptionContext
https://bugzilla.gnome.org/show_bug.cgi?id=672944
2012-04-04 17:13:10 +02:00
* the mail exchanger hostname .
*
* % G_RESOLVER_RECORD_TXT records are returned as variants with the signature
2019-04-26 13:18:02 +02:00
* ` ( as ) ` , representing an array of the strings in the text record . Note : Most TXT
* records only contain a single string , but
* [ RFC 1035 ] ( https : //tools.ietf.org/html/rfc1035#section-3.3.14) does allow a
* record to contain multiple strings . The RFC which defines the interpretation
* of a specific TXT record will likely require concatenation of multiple
* strings if they are present , as with
* [ RFC 7208 ] ( https : //tools.ietf.org/html/rfc7208#section-3.3).
Add support for MX, TXT, NS and SOA records to GResolver
* Add resolver functions for looking up DNS records of
various types. Currently implemented: MX, TXT, SOA, SRV, NS
* Return records as GVariant tuples.
* Make the GSrvTarget lookups a wrapper over this new
functionality.
* Rework the resolver test so that it has support for
looking up MX, NS, SOA, TXT records, and uses GOptionContext
https://bugzilla.gnome.org/show_bug.cgi?id=672944
2012-04-04 17:13:10 +02:00
*
* % G_RESOLVER_RECORD_SOA records are returned as variants with the signature
2019-04-26 13:15:55 +02:00
* ` ( ssuuuuu ) ` , representing a string containing the primary name server , a
* string containing the administrator , the serial as a ` guint32 ` , the refresh
* interval as a ` guint32 ` , the retry interval as a ` guint32 ` , the expire timeout
* as a ` guint32 ` , and the TTL as a ` guint32 ` .
Add support for MX, TXT, NS and SOA records to GResolver
* Add resolver functions for looking up DNS records of
various types. Currently implemented: MX, TXT, SOA, SRV, NS
* Return records as GVariant tuples.
* Make the GSrvTarget lookups a wrapper over this new
functionality.
* Rework the resolver test so that it has support for
looking up MX, NS, SOA, TXT records, and uses GOptionContext
https://bugzilla.gnome.org/show_bug.cgi?id=672944
2012-04-04 17:13:10 +02:00
*
* % G_RESOLVER_RECORD_NS records are returned as variants with the signature
2019-04-26 13:15:55 +02:00
* ` ( s ) ` , representing a string of the hostname of the name server .
Add support for MX, TXT, NS and SOA records to GResolver
* Add resolver functions for looking up DNS records of
various types. Currently implemented: MX, TXT, SOA, SRV, NS
* Return records as GVariant tuples.
* Make the GSrvTarget lookups a wrapper over this new
functionality.
* Rework the resolver test so that it has support for
looking up MX, NS, SOA, TXT records, and uses GOptionContext
https://bugzilla.gnome.org/show_bug.cgi?id=672944
2012-04-04 17:13:10 +02:00
*
* Since : 2.34
*/
typedef enum {
G_RESOLVER_RECORD_SRV = 1 ,
G_RESOLVER_RECORD_MX ,
G_RESOLVER_RECORD_TXT ,
G_RESOLVER_RECORD_SOA ,
G_RESOLVER_RECORD_NS
} GResolverRecordType ;
2011-12-21 21:38:23 +01:00
/**
* GResourceError :
* @ G_RESOURCE_ERROR_NOT_FOUND : no file was found at the requested path
* @ G_RESOURCE_ERROR_INTERNAL : unknown error
*
* An error code used with % G_RESOURCE_ERROR in a # GError returned
* from a # GResource routine .
*
* Since : 2.32
*/
typedef enum {
G_RESOURCE_ERROR_NOT_FOUND ,
G_RESOURCE_ERROR_INTERNAL
} GResourceError ;
/**
* GResourceFlags :
* @ G_RESOURCE_FLAGS_NONE : No flags set .
* @ G_RESOURCE_FLAGS_COMPRESSED : The file is compressed .
*
* GResourceFlags give information about a particular file inside a resource
* bundle .
2012-01-15 00:40:25 +01:00
*
* Since : 2.32
2011-12-21 21:38:23 +01:00
* */
typedef enum {
G_RESOURCE_FLAGS_NONE = 0 ,
G_RESOURCE_FLAGS_COMPRESSED = ( 1 < < 0 )
} GResourceFlags ;
/**
* GResourceLookupFlags :
* @ G_RESOURCE_LOOKUP_FLAGS_NONE : No flags set .
*
* GResourceLookupFlags determine how resource path lookups are handled .
2012-01-15 00:40:25 +01:00
*
* Since : 2.32
2011-12-21 21:38:23 +01:00
* */
2012-01-15 00:34:56 +01:00
typedef enum /*< flags >*/ {
2012-01-19 16:18:05 +01:00
G_RESOURCE_LOOKUP_FLAGS_NONE = 0
2011-12-21 21:38:23 +01:00
} GResourceLookupFlags ;
2008-07-01 08:32:35 +02:00
2008-12-12 19:13:55 +01:00
/**
* 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 . )
2009-05-28 00:20:08 +02:00
*
* Since : 2.22
2008-12-12 19:13:55 +01:00
*/
typedef enum {
G_SOCKET_FAMILY_INVALID ,
G_SOCKET_FAMILY_UNIX = GLIB_SYSDEF_AF_UNIX ,
G_SOCKET_FAMILY_IPV4 = GLIB_SYSDEF_AF_INET ,
G_SOCKET_FAMILY_IPV6 = GLIB_SYSDEF_AF_INET6
} GSocketFamily ;
2009-05-14 15:26:37 +02:00
/**
* GSocketType :
* @ G_SOCKET_TYPE_INVALID : Type unknown or wrong
* @ G_SOCKET_TYPE_STREAM : Reliable connection - based byte streams ( e . g . TCP ) .
2009-05-28 00:20:08 +02:00
* @ 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 ) .
2009-05-14 15:26:37 +02:00
*
2009-05-28 00:20:08 +02:00
* Flags used when creating a # GSocket . Some protocols may not implement
* all the socket types .
2009-05-14 15:26:37 +02:00
*
* Since : 2.22
*/
typedef enum
{
G_SOCKET_TYPE_INVALID ,
G_SOCKET_TYPE_STREAM ,
G_SOCKET_TYPE_DATAGRAM ,
2009-05-25 12:47:12 +02:00
G_SOCKET_TYPE_SEQPACKET
2009-05-14 15:26:37 +02:00
} GSocketType ;
/**
* GSocketMsgFlags :
2009-05-18 13:02:11 +02:00
* @ G_SOCKET_MSG_NONE : No flags .
2009-05-14 15:26:37 +02:00
* @ G_SOCKET_MSG_OOB : Request to send / receive out of band data .
2009-05-28 00:20:08 +02:00
* @ 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 .
2009-05-14 15:26:37 +02:00
*
2009-05-28 00:20:08 +02:00
* 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 .
2009-05-14 15:26:37 +02:00
*
* Since : 2.22
*/
2012-03-12 21:43:15 +01:00
typedef enum /*< flags >*/
2009-05-14 15:26:37 +02:00
{
2009-05-18 13:02:11 +02:00
G_SOCKET_MSG_NONE ,
2009-05-14 15:26:37 +02:00
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 ;
2009-05-20 12:01:29 +02:00
/**
* GSocketProtocol :
* @ G_SOCKET_PROTOCOL_UNKNOWN : The protocol type is unknown
* @ G_SOCKET_PROTOCOL_DEFAULT : The default protocol for the family / type
2009-05-28 00:20:08 +02:00
* @ G_SOCKET_PROTOCOL_TCP : TCP over IP
2009-05-20 12:01:29 +02:00
* @ G_SOCKET_PROTOCOL_UDP : UDP over IP
* @ G_SOCKET_PROTOCOL_SCTP : SCTP over IP
*
2009-05-28 00:20:08 +02:00
* 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 .
2009-05-20 12:01:29 +02:00
*
* 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 ;
2009-11-19 17:20:20 +01:00
/**
* GZlibCompressorFormat :
2009-11-30 04:54:16 +01:00
* @ 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
2009-11-19 17:20:20 +01:00
*
* Used to select the type of data format to use for # GZlibDecompressor
* and # GZlibCompressor .
*
* Since : 2.24
*/
typedef enum {
2009-11-24 13:02:05 +01:00
G_ZLIB_COMPRESSOR_FORMAT_ZLIB ,
G_ZLIB_COMPRESSOR_FORMAT_GZIP ,
G_ZLIB_COMPRESSOR_FORMAT_RAW
2009-11-19 17:20:20 +01:00
} GZlibCompressorFormat ;
2010-04-20 23:23:49 +02:00
/**
* 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
2014-03-03 00:20:37 +01:00
* them ; the man pages suggest using the entire ` struct sockaddr_un `
* 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
2010-04-20 23:23:49 +02:00
* % 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 ;
2010-05-06 20:13:59 +02:00
/**
* GBusType :
2010-05-14 00:04:48 +02:00
* @ G_BUS_TYPE_STARTER : An alias for the message bus that activated the process , if any .
2010-06-11 21:45:18 +02:00
* @ G_BUS_TYPE_NONE : Not a message bus .
2010-05-06 20:13:59 +02:00
* @ G_BUS_TYPE_SYSTEM : The system - wide message bus .
2010-05-14 00:04:48 +02:00
* @ G_BUS_TYPE_SESSION : The login session message bus .
2010-05-06 20:13:59 +02:00
*
2010-05-14 00:04:48 +02:00
* An enumeration for well - known message buses .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum
{
2010-06-11 21:45:18 +02:00
G_BUS_TYPE_STARTER = - 1 ,
G_BUS_TYPE_NONE = 0 ,
2010-05-06 20:13:59 +02:00
G_BUS_TYPE_SYSTEM = 1 ,
2010-05-14 00:04:48 +02:00
G_BUS_TYPE_SESSION = 2
2010-05-06 20:13:59 +02:00
} GBusType ;
/**
* GBusNameOwnerFlags :
* @ G_BUS_NAME_OWNER_FLAGS_NONE : No flags set .
2012-08-19 05:15:58 +02:00
* @ G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT : Allow another message bus connection to claim the name .
2010-05-06 20:13:59 +02:00
* @ 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 .
2017-06-19 13:41:53 +02:00
* @ G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE : If another message bus connection owns the name , immediately
* return an error from g_bus_own_name ( ) rather than entering the waiting queue for that name . ( Since 2.54 )
2010-05-06 20:13:59 +02:00
*
* Flags used in g_bus_own_name ( ) .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum
{
G_BUS_NAME_OWNER_FLAGS_NONE = 0 , /*< nick=none >*/
G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT = ( 1 < < 0 ) , /*< nick=allow-replacement >*/
2017-06-19 13:41:53 +02:00
G_BUS_NAME_OWNER_FLAGS_REPLACE = ( 1 < < 1 ) , /*< nick=replace >*/
G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE = ( 1 < < 2 ) /*< nick=do-not-queue >*/
2010-05-06 20:13:59 +02:00
} GBusNameOwnerFlags ;
2017-06-19 13:36:11 +02:00
/* When adding new flags, their numeric values must currently match those
* used in the D - Bus Specification . */
2010-05-06 20:13:59 +02:00
/**
* 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 ( ) .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
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 .
2015-10-08 18:50:26 +02:00
* @ G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START : If the proxy is for a well - known name ,
* do not ask the bus to launch an owner during proxy initialization or a method call .
* This flag is only meaningful in proxies for well - known names .
2017-03-16 14:50:19 +01:00
* @ G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES : If set , the property value for any __invalidated property__ will be ( asynchronously ) retrieved upon receiving the [ ` PropertiesChanged ` ] ( http : //dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties) D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32.
2013-10-03 20:26:18 +02:00
* @ G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION : If the proxy is for a well - known name ,
* do not ask the bus to launch an owner during proxy initialization , but allow it to be
* autostarted by a method call . This flag is only meaningful in proxies for well - known names ,
2015-10-08 18:50:26 +02:00
* and only if % G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is not also specified .
2015-11-27 17:41:47 +01:00
* @ G_DBUS_PROXY_FLAGS_NO_MATCH_RULE : Don ' t actually send the AddMatch D - Bus
* call for this signal subscription . This gives you more control
* over which match rules you add ( but you must add them manually ) . ( Since : 2.72 )
2010-05-06 20:13:59 +02:00
*
* Flags used when constructing an instance of a # GDBusProxy derived class .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum
{
2010-06-11 21:45:18 +02:00
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 ) ,
2012-02-08 18:46:04 +01:00
G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START = ( 1 < < 2 ) ,
2013-10-03 20:26:18 +02:00
G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES = ( 1 < < 3 ) ,
2015-11-27 17:41:47 +01:00
G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION = ( 1 < < 4 ) ,
G_DBUS_PROXY_FLAGS_NO_MATCH_RULE GLIB_AVAILABLE_ENUMERATOR_IN_2_72 = ( 1 < < 5 )
2010-05-06 20:13:59 +02:00
} 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 .
2014-04-09 16:14:11 +02:00
* @ G_DBUS_ERROR_UNKNOWN_OBJECT :
* Object you invoked a method on isn ' t known . Since 2.42
* @ G_DBUS_ERROR_UNKNOWN_INTERFACE :
* Interface you invoked a method on isn ' t known by the object . Since 2.42
* @ G_DBUS_ERROR_UNKNOWN_PROPERTY :
* Property you tried to access isn ' t known by the object . Since 2.42
* @ G_DBUS_ERROR_PROPERTY_READ_ONLY :
* Property you tried to set is read - only . Since 2.42
2010-05-06 20:13:59 +02:00
* @ 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 .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
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 */
2014-04-09 16:14:11 +02:00
G_DBUS_ERROR_OBJECT_PATH_IN_USE , /* org.freedesktop.DBus.Error.ObjectPathInUse */
G_DBUS_ERROR_UNKNOWN_OBJECT , /* org.freedesktop.DBus.Error.UnknownObject */
G_DBUS_ERROR_UNKNOWN_INTERFACE , /* org.freedesktop.DBus.Error.UnknownInterface */
G_DBUS_ERROR_UNKNOWN_PROPERTY , /* org.freedesktop.DBus.Error.UnknownProperty */
2014-04-29 13:21:41 +02:00
G_DBUS_ERROR_PROPERTY_READ_ONLY /* org.freedesktop.DBus.Error.PropertyReadOnly */
2010-05-06 20:13:59 +02:00
} GDBusError ;
2010-05-06 22:02:08 +02:00
/* Remember to update g_dbus_error_quark() in gdbuserror.c if you extend this enumeration */
2010-05-06 20:13:59 +02:00
/**
* 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 .
2010-06-30 17:43:42 +02:00
* @ 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 .
2020-12-15 14:00:28 +01:00
* @ G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER : When authenticating
* as a server , require the UID of the peer to be the same as the UID of the server . ( Since : 2.68 )
2010-05-06 20:13:59 +02:00
*
* Flags used when creating a new # GDBusConnection .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
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 ) ,
2010-06-30 17:43:42 +02:00
G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION = ( 1 < < 3 ) ,
2020-12-15 14:00:28 +01:00
G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING = ( 1 < < 4 ) ,
2021-03-10 20:51:50 +01:00
G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER GLIB_AVAILABLE_ENUMERATOR_IN_2_68 = ( 1 < < 5 )
2010-05-06 20:13:59 +02:00
} 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 .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum {
G_DBUS_CAPABILITY_FLAGS_NONE = 0 ,
2010-06-04 17:07:05 +02:00
G_DBUS_CAPABILITY_FLAGS_UNIX_FD_PASSING = ( 1 < < 0 )
2010-05-06 20:13:59 +02:00
} GDBusCapabilityFlags ;
/**
2010-05-10 17:47:08 +02:00
* GDBusCallFlags :
* @ G_DBUS_CALL_FLAGS_NONE : No flags set .
* @ G_DBUS_CALL_FLAGS_NO_AUTO_START : The bus must not launch
2010-05-06 20:13:59 +02:00
* an owner for the destination name in response to this method
* invocation .
2014-11-04 12:54:00 +01:00
* @ G_DBUS_CALL_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION : the caller is prepared to
* wait for interactive authorization . Since 2.46 .
2010-05-06 20:13:59 +02:00
*
2010-05-10 17:47:08 +02:00
* Flags used in g_dbus_connection_call ( ) and similar APIs .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum {
2010-05-10 17:47:08 +02:00
G_DBUS_CALL_FLAGS_NONE = 0 ,
2014-11-04 12:54:00 +01:00
G_DBUS_CALL_FLAGS_NO_AUTO_START = ( 1 < < 0 ) ,
G_DBUS_CALL_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION = ( 1 < < 1 )
2010-05-10 17:47:08 +02:00
} GDBusCallFlags ;
2011-10-20 14:12:26 +02:00
/* (1<<31) is reserved for internal use by GDBusConnection, do not use it. */
2010-05-06 20:13:59 +02:00
/**
* 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 .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
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 .
2014-11-04 12:54:00 +01:00
* @ G_DBUS_MESSAGE_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION : If set on a method
* call , this flag means that the caller is prepared to wait for interactive
* authorization . Since 2.46 .
2010-05-06 20:13:59 +02:00
*
* Message flags used in # GDBusMessage .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum {
G_DBUS_MESSAGE_FLAGS_NONE = 0 ,
G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED = ( 1 < < 0 ) ,
2014-11-04 12:54:00 +01:00
G_DBUS_MESSAGE_FLAGS_NO_AUTO_START = ( 1 < < 1 ) ,
G_DBUS_MESSAGE_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION = ( 1 < < 2 )
2010-05-06 20:13:59 +02:00
} 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 .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
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 .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum
{
G_DBUS_PROPERTY_INFO_FLAGS_NONE = 0 ,
G_DBUS_PROPERTY_INFO_FLAGS_READABLE = ( 1 < < 0 ) ,
2010-06-04 17:07:05 +02:00
G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE = ( 1 < < 1 )
2010-05-06 20:13:59 +02:00
} 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 ( ) .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum
{
G_DBUS_SUBTREE_FLAGS_NONE = 0 ,
2010-06-04 17:07:05 +02:00
G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES = ( 1 < < 0 )
2010-05-06 20:13:59 +02:00
} 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 .
2020-12-15 14:00:28 +01:00
* @ G_DBUS_SERVER_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER : Require the UID of the
* peer to be the same as the UID of the server when authenticating . ( Since : 2.68 )
2010-05-06 20:13:59 +02:00
*
* Flags used when creating a # GDBusServer .
2010-05-06 22:02:08 +02:00
*
* Since : 2.26
2010-05-06 20:13:59 +02:00
*/
typedef enum
{
G_DBUS_SERVER_FLAGS_NONE = 0 ,
G_DBUS_SERVER_FLAGS_RUN_IN_THREAD = ( 1 < < 0 ) ,
2020-12-15 14:00:28 +01:00
G_DBUS_SERVER_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS = ( 1 < < 1 ) ,
2021-03-10 20:51:50 +01:00
G_DBUS_SERVER_FLAGS_AUTHENTICATION_REQUIRE_SAME_USER GLIB_AVAILABLE_ENUMERATOR_IN_2_68 = ( 1 < < 2 )
2010-05-06 20:13:59 +02:00
} GDBusServerFlags ;
2010-07-19 21:03:00 +02:00
/**
* GDBusSignalFlags :
* @ G_DBUS_SIGNAL_FLAGS_NONE : No flags set .
2010-11-06 03:07:07 +01:00
* @ G_DBUS_SIGNAL_FLAGS_NO_MATCH_RULE : Don ' t actually send the AddMatch
2011-03-24 09:37:21 +01:00
* D - Bus call for this signal subscription . This gives you more control
2010-11-06 03:07:07 +01:00
* over which match rules you add ( but you must add them manually ) .
2013-04-08 08:13:10 +02:00
* @ G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE : Match first arguments that
* contain a bus or interface name with the given namespace .
* @ G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_PATH : Match first arguments that
* contain an object path that is either equivalent to the given path ,
* or one of the paths is a subpath of the other .
2010-07-19 21:03:00 +02:00
*
* Flags used when subscribing to signals via g_dbus_connection_signal_subscribe ( ) .
*
* Since : 2.26
*/
typedef enum /*< flags >*/
{
2010-11-06 03:07:07 +01:00
G_DBUS_SIGNAL_FLAGS_NONE = 0 ,
2013-04-08 08:13:10 +02:00
G_DBUS_SIGNAL_FLAGS_NO_MATCH_RULE = ( 1 < < 0 ) ,
G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE = ( 1 < < 1 ) ,
G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_PATH = ( 1 < < 2 )
2010-07-19 21:03:00 +02:00
} GDBusSignalFlags ;
2010-07-19 22:07:57 +02:00
/**
* GDBusSendMessageFlags :
* @ G_DBUS_SEND_MESSAGE_FLAGS_NONE : No flags set .
2010-07-19 23:03:07 +02:00
* @ G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL : Do not automatically
* assign a serial number from the # GDBusConnection object when
* sending a message .
2010-07-19 22:07:57 +02:00
*
2014-04-16 23:56:02 +02:00
* Flags used when sending # GDBusMessages on a # GDBusConnection .
2010-07-19 22:07:57 +02:00
*
* Since : 2.26
*/
2010-07-19 23:03:07 +02:00
typedef enum
2010-07-19 22:07:57 +02:00
{
G_DBUS_SEND_MESSAGE_FLAGS_NONE = 0 ,
2010-07-19 23:03:07 +02:00
G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL = ( 1 < < 0 )
2010-07-19 22:07:57 +02:00
} GDBusSendMessageFlags ;
2011-10-20 14:12:26 +02:00
/* (1<<31) is reserved for internal use by GDBusConnection, do not use it. */
2010-07-19 22:07:57 +02:00
2010-07-20 20:02:14 +02:00
/**
* GCredentialsType :
* @ G_CREDENTIALS_TYPE_INVALID : Indicates an invalid native credential type .
2020-04-21 15:29:47 +02:00
* @ G_CREDENTIALS_TYPE_LINUX_UCRED : The native credentials type is a ` struct ucred ` .
* @ G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED : The native credentials type is a ` struct cmsgcred ` .
* @ G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED : The native credentials type is a ` struct sockpeercred ` . Added in 2.30 .
* @ G_CREDENTIALS_TYPE_SOLARIS_UCRED : The native credentials type is a ` ucred_t ` . Added in 2.40 .
2020-04-21 15:31:19 +02:00
* @ G_CREDENTIALS_TYPE_NETBSD_UNPCBID : The native credentials type is a ` struct unpcbid ` . Added in 2.42 .
2018-02-18 15:26:54 +01:00
* @ G_CREDENTIALS_TYPE_APPLE_XUCRED : The native credentials type is a ` struct xucred ` . Added in 2.66 .
2022-01-19 17:35:45 +01:00
* @ G_CREDENTIALS_TYPE_WIN32_PID : The native credentials type is a PID ` DWORD ` . Added in 2.72 .
2010-07-20 20:02:14 +02:00
*
* Enumeration describing different kinds of native credential types .
*
* Since : 2.26
*/
typedef enum
{
G_CREDENTIALS_TYPE_INVALID ,
2010-09-09 20:10:01 +02:00
G_CREDENTIALS_TYPE_LINUX_UCRED ,
2011-05-27 15:51:08 +02:00
G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED ,
2013-09-19 22:09:38 +02:00
G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED ,
2014-09-29 17:25:11 +02:00
G_CREDENTIALS_TYPE_SOLARIS_UCRED ,
2018-02-18 15:26:54 +01:00
G_CREDENTIALS_TYPE_NETBSD_UNPCBID ,
G_CREDENTIALS_TYPE_APPLE_XUCRED ,
2022-01-19 17:35:45 +01:00
G_CREDENTIALS_TYPE_WIN32_PID ,
2010-07-20 20:02:14 +02:00
} GCredentialsType ;
2010-08-04 19:32:19 +02:00
/**
* GDBusMessageByteOrder :
* @ G_DBUS_MESSAGE_BYTE_ORDER_BIG_ENDIAN : The byte order is big endian .
* @ G_DBUS_MESSAGE_BYTE_ORDER_LITTLE_ENDIAN : The byte order is little endian .
*
* Enumeration used to describe the byte order of a D - Bus message .
*
* Since : 2.26
*/
typedef enum
{
G_DBUS_MESSAGE_BYTE_ORDER_BIG_ENDIAN = ' B ' ,
G_DBUS_MESSAGE_BYTE_ORDER_LITTLE_ENDIAN = ' l '
} GDBusMessageByteOrder ;
2010-10-06 19:08:26 +02:00
/**
* GApplicationFlags :
* @ G_APPLICATION_FLAGS_NONE : Default
2010-10-23 20:43:36 +02:00
* @ G_APPLICATION_IS_SERVICE : Run as a service . In this mode , registration
2013-02-21 15:58:32 +01:00
* fails if the service is already running , and the application
* will initially wait up to 10 seconds for an initial activation
* message to arrive .
2010-10-23 00:40:13 +02:00
* @ G_APPLICATION_IS_LAUNCHER : Don ' t try to become the primary instance .
2011-03-04 05:34:49 +01:00
* @ G_APPLICATION_HANDLES_OPEN : This application handles opening files ( in
2011-03-04 18:10:06 +01:00
* the primary instance ) . Note that this flag only affects the default
* implementation of local_command_line ( ) , and has no effect if
* % G_APPLICATION_HANDLES_COMMAND_LINE is given .
* See g_application_run ( ) for details .
2010-10-23 20:43:36 +02:00
* @ G_APPLICATION_HANDLES_COMMAND_LINE : This application handles command line
2011-03-04 18:10:06 +01:00
* arguments ( in the primary instance ) . Note that this flag only affect
* the default implementation of local_command_line ( ) .
* See g_application_run ( ) for details .
2010-10-29 04:49:12 +02:00
* @ G_APPLICATION_SEND_ENVIRONMENT : Send the environment of the
2011-03-04 05:34:49 +01:00
* launching process to the primary instance . Set this flag if your
* application is expected to behave differently depending on certain
* environment variables . For instance , an editor might be expected
2016-02-18 02:09:22 +01:00
* to use the ` GIT_COMMITTER_NAME ` environment variable
2011-03-04 18:10:06 +01:00
* when editing a git commit message . The environment is available
* to the # GApplication : : command - line signal handler , via
* g_application_command_line_getenv ( ) .
2011-04-10 13:51:55 +02:00
* @ G_APPLICATION_NON_UNIQUE : Make no attempts to do any of the typical
2012-03-03 17:31:05 +01:00
* single - instance application negotiation , even if the application
* ID is given . The application neither attempts to become the
* owner of the application ID nor does it check if an existing
* owner already exists . Everything occurs in the local process .
* Since : 2.30 .
2015-02-03 14:09:44 +01:00
* @ G_APPLICATION_CAN_OVERRIDE_APP_ID : Allow users to override the
* application ID from the command line with ` - - gapplication - app - id ` .
* Since : 2.48
2018-08-18 21:35:33 +02:00
* @ G_APPLICATION_ALLOW_REPLACEMENT : Allow another instance to take over
* the bus name . Since : 2.60
* @ G_APPLICATION_REPLACE : Take over from another instance . This flag is
* usually set by passing ` - - gapplication - replace ` on the commandline .
* Since : 2.60
2010-10-06 19:08:26 +02:00
*
* Flags used to define the behaviour of a # GApplication .
*
2011-02-08 02:04:20 +01:00
* Since : 2.28
2010-10-06 19:08:26 +02:00
* */
typedef enum
{
G_APPLICATION_FLAGS_NONE ,
2010-10-09 23:24:09 +02:00
G_APPLICATION_IS_SERVICE = ( 1 < < 0 ) ,
G_APPLICATION_IS_LAUNCHER = ( 1 < < 1 ) ,
2010-10-06 19:08:26 +02:00
2010-10-09 23:24:09 +02:00
G_APPLICATION_HANDLES_OPEN = ( 1 < < 2 ) ,
2010-10-29 04:49:12 +02:00
G_APPLICATION_HANDLES_COMMAND_LINE = ( 1 < < 3 ) ,
2011-04-10 13:51:55 +02:00
G_APPLICATION_SEND_ENVIRONMENT = ( 1 < < 4 ) ,
2015-02-03 14:09:44 +01:00
G_APPLICATION_NON_UNIQUE = ( 1 < < 5 ) ,
2018-08-18 21:35:33 +02:00
G_APPLICATION_CAN_OVERRIDE_APP_ID = ( 1 < < 6 ) ,
G_APPLICATION_ALLOW_REPLACEMENT = ( 1 < < 7 ) ,
G_APPLICATION_REPLACE = ( 1 < < 8 )
2010-10-06 19:08:26 +02:00
} GApplicationFlags ;
2009-12-21 20:50:32 +01:00
/**
* GTlsError :
2010-12-06 12:43:59 +01:00
* @ G_TLS_ERROR_UNAVAILABLE : No TLS provider is available
2009-12-21 20:50:32 +01:00
* @ G_TLS_ERROR_MISC : Miscellaneous TLS error
2019-01-08 12:34:36 +01:00
* @ G_TLS_ERROR_BAD_CERTIFICATE : The certificate presented could not
* be parsed or failed validation .
2009-12-21 20:50:32 +01:00
* @ G_TLS_ERROR_NOT_TLS : The TLS handshake failed because the
* peer does not seem to be a TLS server .
* @ G_TLS_ERROR_HANDSHAKE : The TLS handshake failed because the
* peer ' s certificate was not acceptable .
* @ G_TLS_ERROR_CERTIFICATE_REQUIRED : The TLS handshake failed because
* the server requested a client - side certificate , but none was
2010-12-06 11:04:13 +01:00
* provided . See g_tls_connection_set_certificate ( ) .
2009-12-21 20:50:32 +01:00
* @ G_TLS_ERROR_EOF : The TLS connection was closed without proper
* notice , which may indicate an attack . See
* g_tls_connection_set_require_close_notify ( ) .
2018-07-27 17:52:42 +02:00
* @ G_TLS_ERROR_INAPPROPRIATE_FALLBACK : The TLS handshake failed
* because the client sent the fallback SCSV , indicating a protocol
* downgrade attack . Since : 2.60
2021-09-04 02:13:21 +02:00
* @ G_TLS_ERROR_BAD_CERTIFICATE_PASSWORD : The certificate failed
* to load because a password was incorrect . Since : 2.72
2009-12-21 20:50:32 +01:00
*
* An error code used with % G_TLS_ERROR in a # GError returned from a
* TLS - related routine .
*
* Since : 2.28
*/
typedef enum {
2010-12-06 12:43:59 +01:00
G_TLS_ERROR_UNAVAILABLE ,
2009-12-21 20:50:32 +01:00
G_TLS_ERROR_MISC ,
G_TLS_ERROR_BAD_CERTIFICATE ,
G_TLS_ERROR_NOT_TLS ,
G_TLS_ERROR_HANDSHAKE ,
G_TLS_ERROR_CERTIFICATE_REQUIRED ,
2018-07-27 17:52:42 +02:00
G_TLS_ERROR_EOF ,
2021-09-04 02:13:21 +02:00
G_TLS_ERROR_INAPPROPRIATE_FALLBACK ,
G_TLS_ERROR_BAD_CERTIFICATE_PASSWORD
2009-12-21 20:50:32 +01:00
} GTlsError ;
/**
* GTlsCertificateFlags :
* @ G_TLS_CERTIFICATE_UNKNOWN_CA : The signing certificate authority is
* not known .
* @ G_TLS_CERTIFICATE_BAD_IDENTITY : The certificate does not match the
* expected identity of the site that it was retrieved from .
* @ G_TLS_CERTIFICATE_NOT_ACTIVATED : The certificate ' s activation time
* is still in the future
* @ G_TLS_CERTIFICATE_EXPIRED : The certificate has expired
* @ G_TLS_CERTIFICATE_REVOKED : The certificate has been revoked
2011-06-06 16:22:40 +02:00
* according to the # GTlsConnection ' s certificate revocation list .
2009-12-21 20:50:32 +01:00
* @ G_TLS_CERTIFICATE_INSECURE : The certificate ' s algorithm is
* considered insecure .
* @ G_TLS_CERTIFICATE_GENERIC_ERROR : Some other error occurred validating
* the certificate
* @ G_TLS_CERTIFICATE_VALIDATE_ALL : the combination of all of the above
* flags
*
* A set of flags describing TLS certification validation . This can be
2021-08-04 21:57:05 +02:00
* used to describe why a particular certificate was rejected ( for
* example , in # GTlsConnection : : accept - certificate ) .
*
* GLib guarantees that if certificate verification fails , at least one
* flag will be set , but it does not guarantee that all possible flags
* will be set . Accordingly , you may not safely decide to ignore any
* particular type of error . For example , it would be incorrect to mask
* % G_TLS_CERTIFICATE_EXPIRED if you want to allow expired certificates ,
* because this could potentially be the only error flag set even if
* other problems exist with the certificate .
2009-12-21 20:50:32 +01:00
*
* Since : 2.28
*/
typedef enum {
G_TLS_CERTIFICATE_UNKNOWN_CA = ( 1 < < 0 ) ,
G_TLS_CERTIFICATE_BAD_IDENTITY = ( 1 < < 1 ) ,
G_TLS_CERTIFICATE_NOT_ACTIVATED = ( 1 < < 2 ) ,
G_TLS_CERTIFICATE_EXPIRED = ( 1 < < 3 ) ,
G_TLS_CERTIFICATE_REVOKED = ( 1 < < 4 ) ,
G_TLS_CERTIFICATE_INSECURE = ( 1 < < 5 ) ,
G_TLS_CERTIFICATE_GENERIC_ERROR = ( 1 < < 6 ) ,
G_TLS_CERTIFICATE_VALIDATE_ALL = 0x007f
} GTlsCertificateFlags ;
/**
* GTlsAuthenticationMode :
* @ G_TLS_AUTHENTICATION_NONE : client authentication not required
* @ G_TLS_AUTHENTICATION_REQUESTED : client authentication is requested
* @ G_TLS_AUTHENTICATION_REQUIRED : client authentication is required
*
* The client authentication mode for a # GTlsServerConnection .
*
* Since : 2.28
*/
typedef enum {
G_TLS_AUTHENTICATION_NONE ,
G_TLS_AUTHENTICATION_REQUESTED ,
G_TLS_AUTHENTICATION_REQUIRED
} GTlsAuthenticationMode ;
2020-06-25 14:40:34 +02:00
/**
* GTlsChannelBindingType :
* @ G_TLS_CHANNEL_BINDING_TLS_UNIQUE :
* [ ` tls - unique ` ] ( https : //tools.ietf.org/html/rfc5929#section-3) binding
* type
* @ G_TLS_CHANNEL_BINDING_TLS_SERVER_END_POINT :
* [ ` tls - server - end - point ` ] ( https : //tools.ietf.org/html/rfc5929#section-4)
* binding type
*
* The type of TLS channel binding data to retrieve from # GTlsConnection
* or # GDtlsConnection , as documented by RFC 5929. The
* [ ` tls - unique - for - telnet ` ] ( https : //tools.ietf.org/html/rfc5929#section-5)
* binding type is not currently implemented .
*
* Since : 2.66
*/
GLIB_AVAILABLE_TYPE_IN_2_66
typedef enum {
G_TLS_CHANNEL_BINDING_TLS_UNIQUE ,
G_TLS_CHANNEL_BINDING_TLS_SERVER_END_POINT
} GTlsChannelBindingType ;
/**
* GTlsChannelBindingError :
* @ G_TLS_CHANNEL_BINDING_ERROR_NOT_IMPLEMENTED : Either entire binding
* retrieval facility or specific binding type is not implemented in the
* TLS backend .
* @ G_TLS_CHANNEL_BINDING_ERROR_INVALID_STATE : The handshake is not yet
* complete on the connection which is a strong requirement for any existing
* binding type .
* @ G_TLS_CHANNEL_BINDING_ERROR_NOT_AVAILABLE : Handshake is complete but
* binding data is not available . That normally indicates the TLS
* implementation failed to provide the binding data . For example , some
* implementations do not provide a peer certificate for resumed connections .
* @ G_TLS_CHANNEL_BINDING_ERROR_NOT_SUPPORTED : Binding type is not supported
* on the current connection . This error could be triggered when requesting
* ` tls - server - end - point ` binding data for a certificate which has no hash
* function or uses multiple hash functions .
* @ G_TLS_CHANNEL_BINDING_ERROR_GENERAL_ERROR : Any other backend error
* preventing binding data retrieval .
*
* An error code used with % G_TLS_CHANNEL_BINDING_ERROR in a # GError to
* indicate a TLS channel binding retrieval error .
*
* Since : 2.66
*/
GLIB_AVAILABLE_TYPE_IN_2_66
typedef enum {
G_TLS_CHANNEL_BINDING_ERROR_NOT_IMPLEMENTED ,
G_TLS_CHANNEL_BINDING_ERROR_INVALID_STATE ,
G_TLS_CHANNEL_BINDING_ERROR_NOT_AVAILABLE ,
G_TLS_CHANNEL_BINDING_ERROR_NOT_SUPPORTED ,
G_TLS_CHANNEL_BINDING_ERROR_GENERAL_ERROR
} GTlsChannelBindingError ;
2009-12-21 20:50:32 +01:00
/**
* GTlsRehandshakeMode :
* @ G_TLS_REHANDSHAKE_NEVER : Never allow rehandshaking
* @ G_TLS_REHANDSHAKE_SAFELY : Allow safe rehandshaking only
* @ G_TLS_REHANDSHAKE_UNSAFELY : Allow unsafe rehandshaking
*
* When to allow rehandshaking . See
* g_tls_connection_set_rehandshake_mode ( ) .
*
* Since : 2.28
2018-11-21 05:04:56 +01:00
*
* Deprecated : 2.60 . Changing the rehandshake mode is no longer
* required for compatibility . Also , rehandshaking has been removed
* from the TLS protocol in TLS 1.3 .
2009-12-21 20:50:32 +01:00
*/
typedef enum {
G_TLS_REHANDSHAKE_NEVER ,
G_TLS_REHANDSHAKE_SAFELY ,
G_TLS_REHANDSHAKE_UNSAFELY
2019-05-27 20:50:09 +02:00
} GTlsRehandshakeMode GLIB_DEPRECATED_TYPE_IN_2_60 ;
2009-12-21 20:50:32 +01:00
2011-08-04 08:54:55 +02:00
/**
* GTlsPasswordFlags :
* @ G_TLS_PASSWORD_NONE : No flags
* @ G_TLS_PASSWORD_RETRY : The password was wrong , and the user should retry .
* @ G_TLS_PASSWORD_MANY_TRIES : Hint to the user that the password has been
* wrong many times , and the user may not have many chances left .
* @ G_TLS_PASSWORD_FINAL_TRY : Hint to the user that this is the last try to get
* this password right .
2021-05-29 17:14:20 +02:00
* @ G_TLS_PASSWORD_PKCS11_USER : For PKCS # 11 , the user PIN is required .
* Since : 2.70 .
* @ G_TLS_PASSWORD_PKCS11_SECURITY_OFFICER : For PKCS # 11 , the security officer
* PIN is required . Since : 2.70 .
* @ G_TLS_PASSWORD_PKCS11_CONTEXT_SPECIFIC : For PKCS # 11 , the context - specific
* PIN is required . Since : 2.70 .
2011-08-04 08:54:55 +02:00
*
* Various flags for the password .
*
* Since : 2.30
*/
typedef enum _GTlsPasswordFlags
{
G_TLS_PASSWORD_NONE = 0 ,
G_TLS_PASSWORD_RETRY = 1 < < 1 ,
G_TLS_PASSWORD_MANY_TRIES = 1 < < 2 ,
2021-05-29 17:14:20 +02:00
G_TLS_PASSWORD_FINAL_TRY = 1 < < 3 ,
G_TLS_PASSWORD_PKCS11_USER = 1 < < 4 ,
G_TLS_PASSWORD_PKCS11_SECURITY_OFFICER = 1 < < 5 ,
G_TLS_PASSWORD_PKCS11_CONTEXT_SPECIFIC = 1 < < 6
2011-08-04 08:54:55 +02:00
} GTlsPasswordFlags ;
/**
* GTlsInteractionResult :
* @ G_TLS_INTERACTION_UNHANDLED : The interaction was unhandled ( i . e . not
* implemented ) .
2011-08-13 14:03:53 +02:00
* @ G_TLS_INTERACTION_HANDLED : The interaction completed , and resulting data
* is available .
* @ G_TLS_INTERACTION_FAILED : The interaction has failed , or was cancelled .
* and the operation should be aborted .
2011-08-04 08:54:55 +02:00
*
* # GTlsInteractionResult is returned by various functions in # GTlsInteraction
* when finishing an interaction request .
*
* Since : 2.30
*/
typedef enum {
2011-08-13 14:03:53 +02:00
G_TLS_INTERACTION_UNHANDLED ,
2011-08-04 08:54:55 +02:00
G_TLS_INTERACTION_HANDLED ,
2011-08-13 14:03:53 +02:00
G_TLS_INTERACTION_FAILED
2011-08-04 08:54:55 +02:00
} GTlsInteractionResult ;
2011-04-08 21:14:47 +02:00
/**
2011-04-13 22:33:51 +02:00
* GDBusInterfaceSkeletonFlags :
* @ G_DBUS_INTERFACE_SKELETON_FLAGS_NONE : No flags set .
* @ G_DBUS_INTERFACE_SKELETON_FLAGS_HANDLE_METHOD_INVOCATIONS_IN_THREAD : Each method invocation is handled in
2011-04-08 21:14:47 +02:00
* a thread dedicated to the invocation . This means that the method implementation can use blocking IO
* without blocking any other part of the process . It also means that the method implementation must
* use locking to access data structures used by other threads .
*
2011-04-13 22:33:51 +02:00
* Flags describing the behavior of a # GDBusInterfaceSkeleton instance .
2011-04-08 21:14:47 +02:00
*
* Since : 2.30
*/
typedef enum
{
2011-04-13 22:33:51 +02:00
G_DBUS_INTERFACE_SKELETON_FLAGS_NONE = 0 ,
G_DBUS_INTERFACE_SKELETON_FLAGS_HANDLE_METHOD_INVOCATIONS_IN_THREAD = ( 1 < < 0 )
} GDBusInterfaceSkeletonFlags ;
2011-04-08 21:14:47 +02:00
/**
* GDBusObjectManagerClientFlags :
* @ G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_NONE : No flags set .
* @ G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_DO_NOT_AUTO_START : If not set and the
* manager is 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 managers for well - known names .
*
* Flags used when constructing a # GDBusObjectManagerClient .
*
* Since : 2.30
*/
typedef enum
{
G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_NONE = 0 ,
2011-06-09 20:17:52 +02:00
G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_DO_NOT_AUTO_START = ( 1 < < 0 )
2011-04-08 21:14:47 +02:00
} GDBusObjectManagerClientFlags ;
2011-08-04 08:54:55 +02:00
/**
* GTlsDatabaseVerifyFlags :
* @ G_TLS_DATABASE_VERIFY_NONE : No verification flags
*
* Flags for g_tls_database_verify_chain ( ) .
*
* Since : 2.30
*/
2012-01-15 00:34:56 +01:00
typedef enum /*< flags >*/ {
2011-08-04 21:47:07 +02:00
G_TLS_DATABASE_VERIFY_NONE = 0
2011-08-04 08:54:55 +02:00
} GTlsDatabaseVerifyFlags ;
/**
* GTlsDatabaseLookupFlags :
* @ G_TLS_DATABASE_LOOKUP_NONE : No lookup flags
* @ G_TLS_DATABASE_LOOKUP_KEYPAIR : Restrict lookup to certificates that have
* a private key .
*
2017-11-07 14:38:58 +01:00
* Flags for g_tls_database_lookup_certificate_for_handle ( ) ,
2012-02-19 16:51:09 +01:00
* g_tls_database_lookup_certificate_issuer ( ) ,
* and g_tls_database_lookup_certificates_issued_by ( ) .
2011-08-04 08:54:55 +02:00
*
* Since : 2.30
*/
typedef enum {
G_TLS_DATABASE_LOOKUP_NONE = 0 ,
2011-08-04 21:47:07 +02:00
G_TLS_DATABASE_LOOKUP_KEYPAIR = 1
2011-08-04 08:54:55 +02:00
} GTlsDatabaseLookupFlags ;
2012-11-28 22:01:21 +01:00
/**
* GTlsCertificateRequestFlags :
* @ G_TLS_CERTIFICATE_REQUEST_NONE : No flags
*
* Flags for g_tls_interaction_request_certificate ( ) ,
* g_tls_interaction_request_certificate_async ( ) , and
* g_tls_interaction_invoke_request_certificate ( ) .
*
* Since : 2.40
*/
typedef enum {
G_TLS_CERTIFICATE_REQUEST_NONE = 0
} GTlsCertificateRequestFlags ;
2021-04-28 23:08:00 +02:00
/**
* GTlsProtocolVersion :
* @ G_TLS_PROTOCOL_VERSION_UNKNOWN : No protocol version or unknown protocol version
* @ G_TLS_PROTOCOL_VERSION_SSL_3_0 : SSL 3.0 , which is insecure and should not be used
* @ G_TLS_PROTOCOL_VERSION_TLS_1_0 : TLS 1.0 , which is insecure and should not be used
* @ G_TLS_PROTOCOL_VERSION_TLS_1_1 : TLS 1.1 , which is insecure and should not be used
* @ G_TLS_PROTOCOL_VERSION_TLS_1_2 : TLS 1.2 , defined by [ RFC 5246 ] ( https : //datatracker.ietf.org/doc/html/rfc5246)
* @ G_TLS_PROTOCOL_VERSION_TLS_1_3 : TLS 1.3 , defined by [ RFC 8446 ] ( https : //datatracker.ietf.org/doc/html/rfc8446)
* @ G_TLS_PROTOCOL_VERSION_DTLS_1_0 : DTLS 1.0 , which is insecure and should not be used
* @ G_TLS_PROTOCOL_VERSION_DTLS_1_2 : DTLS 1.2 , defined by [ RFC 6347 ] ( https : //datatracker.ietf.org/doc/html/rfc6347)
*
* The TLS or DTLS protocol version used by a # GTlsConnection or
* # GDtlsConnection . The integer values of these versions are sequential
* to ensure newer known protocol versions compare greater than older
* known versions . Any known DTLS protocol version will compare greater
* than any SSL or TLS protocol version . The protocol version may be
* % G_TLS_PROTOCOL_VERSION_UNKNOWN if the TLS backend supports a newer
* protocol version that GLib does not yet know about . This means that
* it ' s possible for an unknown DTLS protocol version to compare less
* than the TLS protocol versions .
*
* Since : 2.70
*/
typedef enum {
G_TLS_PROTOCOL_VERSION_UNKNOWN = 0 ,
G_TLS_PROTOCOL_VERSION_SSL_3_0 = 1 ,
G_TLS_PROTOCOL_VERSION_TLS_1_0 = 2 ,
G_TLS_PROTOCOL_VERSION_TLS_1_1 = 3 ,
G_TLS_PROTOCOL_VERSION_TLS_1_2 = 4 ,
G_TLS_PROTOCOL_VERSION_TLS_1_3 = 5 ,
G_TLS_PROTOCOL_VERSION_DTLS_1_0 = 201 ,
G_TLS_PROTOCOL_VERSION_DTLS_1_2 = 202 ,
} GTlsProtocolVersion ;
2011-08-26 15:27:19 +02:00
/**
* GIOModuleScopeFlags :
2012-02-18 12:10:00 +01:00
* @ G_IO_MODULE_SCOPE_NONE : No module scan flags
* @ G_IO_MODULE_SCOPE_BLOCK_DUPLICATES : When using this scope to load or
2011-08-26 15:27:19 +02:00
* scan modules , automatically block a modules which has the same base
* basename as previously loaded module .
*
* Flags for use with g_io_module_scope_new ( ) .
*
* Since : 2.30
*/
typedef enum {
G_IO_MODULE_SCOPE_NONE ,
G_IO_MODULE_SCOPE_BLOCK_DUPLICATES
} GIOModuleScopeFlags ;
2010-08-20 19:04:19 +02:00
/**
* GSocketClientEvent :
* @ G_SOCKET_CLIENT_RESOLVING : The client is doing a DNS lookup .
* @ G_SOCKET_CLIENT_RESOLVED : The client has completed a DNS lookup .
* @ G_SOCKET_CLIENT_CONNECTING : The client is connecting to a remote
* host ( either a proxy or the destination server ) .
* @ G_SOCKET_CLIENT_CONNECTED : The client has connected to a remote
* host .
* @ G_SOCKET_CLIENT_PROXY_NEGOTIATING : The client is negotiating
* with a proxy to connect to the destination server .
* @ G_SOCKET_CLIENT_PROXY_NEGOTIATED : The client has negotiated
* with the proxy server .
* @ G_SOCKET_CLIENT_TLS_HANDSHAKING : The client is performing a
* TLS handshake .
* @ G_SOCKET_CLIENT_TLS_HANDSHAKED : The client has performed a
* TLS handshake .
* @ G_SOCKET_CLIENT_COMPLETE : The client is done with a particular
* # GSocketConnectable .
*
* Describes an event occurring on a # GSocketClient . See the
* # GSocketClient : : event signal for more details .
*
* Additional values may be added to this type in the future .
*
* Since : 2.32
*/
typedef enum {
G_SOCKET_CLIENT_RESOLVING ,
G_SOCKET_CLIENT_RESOLVED ,
G_SOCKET_CLIENT_CONNECTING ,
G_SOCKET_CLIENT_CONNECTED ,
G_SOCKET_CLIENT_PROXY_NEGOTIATING ,
G_SOCKET_CLIENT_PROXY_NEGOTIATED ,
G_SOCKET_CLIENT_TLS_HANDSHAKING ,
G_SOCKET_CLIENT_TLS_HANDSHAKED ,
G_SOCKET_CLIENT_COMPLETE
} GSocketClientEvent ;
2014-10-09 15:54:43 +02:00
/**
* GSocketListenerEvent :
* @ G_SOCKET_LISTENER_BINDING : The listener is about to bind a socket .
* @ G_SOCKET_LISTENER_BOUND : The listener has bound a socket .
* @ G_SOCKET_LISTENER_LISTENING : The listener is about to start
* listening on this socket .
* @ G_SOCKET_LISTENER_LISTENED : The listener is now listening on
* this socket .
*
* Describes an event occurring on a # GSocketListener . See the
* # GSocketListener : : event signal for more details .
*
* Additional values may be added to this type in the future .
*
* Since : 2.46
*/
typedef enum {
G_SOCKET_LISTENER_BINDING ,
G_SOCKET_LISTENER_BOUND ,
G_SOCKET_LISTENER_LISTENING ,
G_SOCKET_LISTENER_LISTENED
} GSocketListenerEvent ;
2012-04-18 23:21:13 +02:00
/**
* GTestDBusFlags :
* @ G_TEST_DBUS_NONE : No flags .
*
* Flags to define future # GTestDBus behaviour .
*
* Since : 2.34
*/
typedef enum /*< flags >*/ {
2012-06-12 10:35:52 +02:00
G_TEST_DBUS_NONE = 0
2012-04-18 23:21:13 +02:00
} GTestDBusFlags ;
2012-05-17 20:37:17 +02:00
/**
* GSubprocessFlags :
* @ G_SUBPROCESS_FLAGS_NONE : No flags .
* @ G_SUBPROCESS_FLAGS_STDIN_PIPE : create a pipe for the stdin of the
* spawned process that can be accessed with
* g_subprocess_get_stdin_pipe ( ) .
* @ G_SUBPROCESS_FLAGS_STDIN_INHERIT : stdin is inherited from the
* calling process .
* @ G_SUBPROCESS_FLAGS_STDOUT_PIPE : create a pipe for the stdout of the
* spawned process that can be accessed with
* g_subprocess_get_stdout_pipe ( ) .
* @ G_SUBPROCESS_FLAGS_STDOUT_SILENCE : silence the stdout of the spawned
2018-02-08 17:39:32 +01:00
* process ( ie : redirect to ` / dev / null ` ) .
2012-05-17 20:37:17 +02:00
* @ G_SUBPROCESS_FLAGS_STDERR_PIPE : create a pipe for the stderr of the
* spawned process that can be accessed with
* g_subprocess_get_stderr_pipe ( ) .
* @ G_SUBPROCESS_FLAGS_STDERR_SILENCE : silence the stderr of the spawned
2018-02-08 17:39:32 +01:00
* process ( ie : redirect to ` / dev / null ` ) .
2012-05-17 20:37:17 +02:00
* @ G_SUBPROCESS_FLAGS_STDERR_MERGE : merge the stderr of the spawned
* process with whatever the stdout happens to be . This is a good way
* of directing both streams to a common log file , for example .
* @ G_SUBPROCESS_FLAGS_INHERIT_FDS : spawned processes will inherit the
* file descriptors of their parent , unless those descriptors have
* been explicitly marked as close - on - exec . This flag has no effect
* over the " standard " file descriptors ( stdin , stdout , stderr ) .
2021-11-17 13:27:46 +01:00
* @ G_SUBPROCESS_FLAGS_SEARCH_PATH_FROM_ENVP : if path searching is
* needed when spawning the subprocess , use the ` PATH ` in the launcher
* environment . ( Since : 2.72 )
2012-05-17 20:37:17 +02:00
*
* Flags to define the behaviour of a # GSubprocess .
*
2018-02-08 17:39:32 +01:00
* Note that the default for stdin is to redirect from ` / dev / null ` . For
2012-05-17 20:37:17 +02:00
* stdout and stderr the default are for them to inherit the
* corresponding descriptor from the calling process .
*
* Note that it is a programmer error to mix ' incompatible ' flags . For
* example , you may not request both % G_SUBPROCESS_FLAGS_STDOUT_PIPE and
* % G_SUBPROCESS_FLAGS_STDOUT_SILENCE .
*
2014-02-10 09:49:52 +01:00
* Since : 2.40
2012-05-17 20:37:17 +02:00
* */
typedef enum {
G_SUBPROCESS_FLAGS_NONE = 0 ,
G_SUBPROCESS_FLAGS_STDIN_PIPE = ( 1u < < 0 ) ,
G_SUBPROCESS_FLAGS_STDIN_INHERIT = ( 1u < < 1 ) ,
G_SUBPROCESS_FLAGS_STDOUT_PIPE = ( 1u < < 2 ) ,
G_SUBPROCESS_FLAGS_STDOUT_SILENCE = ( 1u < < 3 ) ,
G_SUBPROCESS_FLAGS_STDERR_PIPE = ( 1u < < 4 ) ,
G_SUBPROCESS_FLAGS_STDERR_SILENCE = ( 1u < < 5 ) ,
G_SUBPROCESS_FLAGS_STDERR_MERGE = ( 1u < < 6 ) ,
2021-11-17 13:27:46 +01:00
G_SUBPROCESS_FLAGS_INHERIT_FDS = ( 1u < < 7 ) ,
G_SUBPROCESS_FLAGS_SEARCH_PATH_FROM_ENVP = ( 1u < < 8 )
2012-05-17 20:37:17 +02:00
} GSubprocessFlags ;
2014-06-15 15:42:31 +02:00
/**
* GNotificationPriority :
* @ G_NOTIFICATION_PRIORITY_LOW : for notifications that do not require
* immediate attention - typically used for contextual background
* information , such as contact birthdays or local weather
* @ G_NOTIFICATION_PRIORITY_NORMAL : the default priority , to be used for the
* majority of notifications ( for example email messages , software updates ,
* completed download / sync operations )
* @ G_NOTIFICATION_PRIORITY_HIGH : for events that require more attention ,
* usually because responses are time - sensitive ( for example chat and SMS
* messages or alarms )
* @ G_NOTIFICATION_PRIORITY_URGENT : for urgent notifications , or notifications
* that require a response in a short space of time ( for example phone calls
* or emergency warnings )
*
* Priority levels for # GNotifications .
*
* Since : 2.42
*/
typedef enum {
G_NOTIFICATION_PRIORITY_NORMAL ,
G_NOTIFICATION_PRIORITY_LOW ,
G_NOTIFICATION_PRIORITY_HIGH ,
G_NOTIFICATION_PRIORITY_URGENT
} GNotificationPriority ;
2014-04-16 16:39:12 +02:00
/**
* GNetworkConnectivity :
* @ G_NETWORK_CONNECTIVITY_LOCAL : The host is not configured with a
* route to the Internet ; it may or may not be connected to a local
* network .
* @ G_NETWORK_CONNECTIVITY_LIMITED : The host is connected to a network , but
* does not appear to be able to reach the full Internet , perhaps
* due to upstream network problems .
* @ G_NETWORK_CONNECTIVITY_PORTAL : The host is behind a captive portal and
* cannot reach the full Internet .
* @ G_NETWORK_CONNECTIVITY_FULL : The host is connected to a network , and
* appears to be able to reach the full Internet .
*
* The host ' s network connectivity state , as reported by # GNetworkMonitor .
*
2014-12-10 18:39:21 +01:00
* Since : 2.44
2014-04-16 16:39:12 +02:00
*/
typedef enum {
G_NETWORK_CONNECTIVITY_LOCAL = 1 ,
G_NETWORK_CONNECTIVITY_LIMITED = 2 ,
G_NETWORK_CONNECTIVITY_PORTAL = 3 ,
G_NETWORK_CONNECTIVITY_FULL = 4
} GNetworkConnectivity ;
2019-01-04 11:48:26 +01:00
/**
* GPollableReturn :
* @ G_POLLABLE_RETURN_FAILED : Generic error condition for when an operation fails .
* @ G_POLLABLE_RETURN_OK : The operation was successfully finished .
* @ G_POLLABLE_RETURN_WOULD_BLOCK : The operation would block .
*
* Return value for various IO operations that signal errors via the
* return value and not necessarily via a # GError .
*
* This enum exists to be able to return errors to callers without having to
* allocate a # GError . Allocating # GErrors can be quite expensive for
* regularly happening errors like % G_IO_ERROR_WOULD_BLOCK .
*
* In case of % G_POLLABLE_RETURN_FAILED a # GError should be set for the
* operation to give details about the error that happened .
*
* Since : 2.60
*/
typedef enum {
G_POLLABLE_RETURN_FAILED = 0 ,
G_POLLABLE_RETURN_OK = 1 ,
G_POLLABLE_RETURN_WOULD_BLOCK = - G_IO_ERROR_WOULD_BLOCK
} GPollableReturn ;
2019-07-25 15:52:09 +02:00
/**
* GMemoryMonitorWarningLevel :
* @ G_MEMORY_MONITOR_WARNING_LEVEL_LOW : Memory on the device is low , processes
* should free up unneeded resources ( for example , in - memory caches ) so they can
* be used elsewhere .
* @ G_MEMORY_MONITOR_WARNING_LEVEL_MEDIUM : Same as @ G_MEMORY_MONITOR_WARNING_LEVEL_LOW
* but the device has even less free memory , so processes should try harder to free
* up unneeded resources . If your process does not need to stay running , it is a
* good time for it to quit .
* @ G_MEMORY_MONITOR_WARNING_LEVEL_CRITICAL : The system will soon start terminating
* processes to reclaim memory , including background processes .
*
* Memory availability warning levels .
*
* Note that because new values might be added , it is recommended that applications check
* # GMemoryMonitorWarningLevel as ranges , for example :
2019-12-18 12:27:27 +01:00
* | [ < ! - - language = " C " - - >
2019-07-25 15:52:09 +02:00
* if ( warning_level > G_MEMORY_MONITOR_WARNING_LEVEL_LOW )
* drop_caches ( ) ;
2019-12-18 12:27:27 +01:00
* ] |
2019-07-25 15:52:09 +02:00
*
* Since : 2.64
*/
typedef enum {
G_MEMORY_MONITOR_WARNING_LEVEL_LOW = 50 ,
G_MEMORY_MONITOR_WARNING_LEVEL_MEDIUM = 100 ,
G_MEMORY_MONITOR_WARNING_LEVEL_CRITICAL = 255
} GMemoryMonitorWarningLevel ;
2008-07-01 08:32:35 +02:00
G_END_DECLS
# endif /* __GIO_ENUMS_H__ */