Flags¶
Gio.AppInfoCreateFlags
Gio.ApplicationFlags
Gio.AskPasswordFlags
Gio.BusNameOwnerFlags
Gio.BusNameWatcherFlags
Gio.ConverterFlags
Gio.DBusCallFlags
Gio.DBusCapabilityFlags
Gio.DBusConnectionFlags
Gio.DBusInterfaceSkeletonFlags
Gio.DBusMessageFlags
Gio.DBusObjectManagerClientFlags
Gio.DBusPropertyInfoFlags
Gio.DBusProxyFlags
Gio.DBusSendMessageFlags
Gio.DBusServerFlags
Gio.DBusSignalFlags
Gio.DBusSubtreeFlags
Gio.DriveStartFlags
Gio.FileAttributeInfoFlags
Gio.FileCopyFlags
Gio.FileCreateFlags
Gio.FileMeasureFlags
Gio.FileMonitorFlags
Gio.FileQueryInfoFlags
Gio.IOStreamSpliceFlags
Gio.MountMountFlags
Gio.MountUnmountFlags
Gio.OutputStreamSpliceFlags
Gio.ResourceFlags
Gio.ResourceLookupFlags
Gio.SettingsBindFlags
Gio.SocketMsgFlags
Gio.SubprocessFlags
Gio.TestDBusFlags
Gio.TlsCertificateFlags
Gio.TlsDatabaseVerifyFlags
Gio.TlsPasswordFlags
Details¶
-
class
Gio.
AppInfoCreateFlags
(value)¶ Bases:
GObject.GFlags
Flags used when creating a
Gio.AppInfo
.-
NONE
= 0¶ No flags.
-
NEEDS_TERMINAL
= 1¶ Application opens in a terminal window.
-
SUPPORTS_URIS
= 2¶ Application supports URI arguments.
-
SUPPORTS_STARTUP_NOTIFICATION
= 4¶ Application supports startup notification.
New in version 2.26.
-
-
class
Gio.
ApplicationFlags
(value)¶ Bases:
GObject.GFlags
Flags used to define the behaviour of a
Gio.Application
.New in version 2.28.
-
FLAGS_NONE
= 0¶ Default
-
IS_SERVICE
= 1¶ Run as a service. In this mode, registration fails if the service is already running, and the application will initially wait up to 10 seconds for an initial activation message to arrive.
-
SEND_ENVIRONMENT
= 16¶ Send the environment of the 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 to use the
GIT_COMMITTER_NAME
environment variable when editing a git commit message. The environment is available to theGio.Application
::command-line
signal handler, viaGio.ApplicationCommandLine.getenv
().
-
IS_LAUNCHER
= 2¶ Don’t try to become the primary instance.
-
NON_UNIQUE
= 32¶ Make no attempts to do any of the typical 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.
New in version 2.30.
-
HANDLES_OPEN
= 4¶ This application handles opening files (in the primary instance). Note that this flag only affects the default implementation of local_command_line(), and has no effect if
Gio.ApplicationFlags.HANDLES_COMMAND_LINE
is given. SeeGio.Application.run
() for details.
-
CAN_OVERRIDE_APP_ID
= 64¶ Allow users to override the application ID from the command line with
--gapplication-app-id
.New in version 2.48.
-
HANDLES_COMMAND_LINE
= 8¶ This application handles command line arguments (in the primary instance). Note that this flag only affect the default implementation of local_command_line(). See
Gio.Application.run
() for details.
-
-
class
Gio.
AskPasswordFlags
(value)¶ Bases:
GObject.GFlags
Gio.AskPasswordFlags
are used to request specific information from the user, or to notify the user of their choices in an authentication situation.-
NEED_PASSWORD
= 1¶ operation requires a password.
-
ANONYMOUS_SUPPORTED
= 16¶ operation supports anonymous users.
-
NEED_USERNAME
= 2¶ operation requires a username.
-
TCRYPT
= 32¶ operation takes TCRYPT parameters (Since: 2.58)
-
NEED_DOMAIN
= 4¶ operation requires a domain.
-
SAVING_SUPPORTED
= 8¶ operation supports saving settings.
-
-
class
Gio.
BusNameOwnerFlags
(value)¶ Bases:
GObject.GFlags
Flags used in
Gio.bus_own_name
().New in version 2.26.
-
NONE
= 0¶ No flags set.
-
ALLOW_REPLACEMENT
= 1¶ Allow another message bus connection to claim the name.
-
REPLACE
= 2¶ If another message bus connection owns the name and have specified
Gio.BusNameOwnerFlags.ALLOW_REPLACEMENT
, then take the name from the other connection.
-
DO_NOT_QUEUE
= 4¶ If another message bus connection owns the name, immediately return an error from
Gio.bus_own_name
() rather than entering the waiting queue for that name. (Since 2.54)
-
-
class
Gio.
BusNameWatcherFlags
(value)¶ Bases:
GObject.GFlags
Flags used in
Gio.bus_watch_name
().New in version 2.26.
-
NONE
= 0¶ No flags set.
-
AUTO_START
= 1¶ If no-one owns the name when beginning to watch the name, ask the bus to launch an owner for the name.
-
-
class
Gio.
ConverterFlags
(value)¶ Bases:
GObject.GFlags
Flags used when calling a
Gio.Converter.convert
().New in version 2.24.
-
NONE
= 0¶ No flags.
-
INPUT_AT_END
= 1¶ At end of input data
-
FLUSH
= 2¶ Flush data
-
-
class
Gio.
DBusCallFlags
(value)¶ Bases:
GObject.GFlags
Flags used in
Gio.DBusConnection.call
() and similar APIs.New in version 2.26.
-
NONE
= 0¶ No flags set.
-
NO_AUTO_START
= 1¶ The bus must not launch an owner for the destination name in response to this method invocation.
-
ALLOW_INTERACTIVE_AUTHORIZATION
= 2¶ the caller is prepared to wait for interactive authorization.
New in version 2.46.
-
-
class
Gio.
DBusCapabilityFlags
(value)¶ Bases:
GObject.GFlags
Capabilities negotiated with the remote peer.
New in version 2.26.
-
NONE
= 0¶ No flags set.
-
UNIX_FD_PASSING
= 1¶ The connection supports exchanging UNIX file descriptors with the remote peer.
-
-
class
Gio.
DBusConnectionFlags
(value)¶ Bases:
GObject.GFlags
Flags used when creating a new
Gio.DBusConnection
.New in version 2.26.
-
NONE
= 0¶ No flags set.
-
AUTHENTICATION_CLIENT
= 1¶ Perform authentication against server.
-
DELAY_MESSAGE_PROCESSING
= 16¶ If set, processing of D-Bus messages is delayed until
Gio.DBusConnection.start_message_processing
() is called.
-
AUTHENTICATION_SERVER
= 2¶ Perform authentication against client.
-
AUTHENTICATION_ALLOW_ANONYMOUS
= 4¶ When authenticating as a server, allow the anonymous authentication method.
-
MESSAGE_BUS_CONNECTION
= 8¶ 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.
-
-
class
Gio.
DBusInterfaceSkeletonFlags
(value)¶ Bases:
GObject.GFlags
Flags describing the behavior of a
Gio.DBusInterfaceSkeleton
instance.New in version 2.30.
-
NONE
= 0¶ No flags set.
-
HANDLE_METHOD_INVOCATIONS_IN_THREAD
= 1¶ Each method invocation is handled in 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.
-
-
class
Gio.
DBusMessageFlags
(value)¶ Bases:
GObject.GFlags
Message flags used in
Gio.DBusMessage
.New in version 2.26.
-
NONE
= 0¶ No flags set.
-
NO_REPLY_EXPECTED
= 1¶ A reply is not expected.
-
NO_AUTO_START
= 2¶ The bus must not launch an owner for the destination name in response to this message.
-
ALLOW_INTERACTIVE_AUTHORIZATION
= 4¶ If set on a method call, this flag means that the caller is prepared to wait for interactive authorization.
New in version 2.46.
-
-
class
Gio.
DBusObjectManagerClientFlags
(value)¶ Bases:
GObject.GFlags
Flags used when constructing a
Gio.DBusObjectManagerClient
.New in version 2.30.
-
NONE
= 0¶ No flags set.
-
DO_NOT_AUTO_START
= 1¶ 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.
-
-
class
Gio.
DBusPropertyInfoFlags
(value)¶ Bases:
GObject.GFlags
Flags describing the access control of a D-Bus property.
New in version 2.26.
-
NONE
= 0¶ No flags set.
-
READABLE
= 1¶ Property is readable.
-
WRITABLE
= 2¶ Property is writable.
-
-
class
Gio.
DBusProxyFlags
(value)¶ Bases:
GObject.GFlags
Flags used when constructing an instance of a
Gio.DBusProxy
derived class.New in version 2.26.
-
NONE
= 0¶ No flags set.
-
DO_NOT_LOAD_PROPERTIES
= 1¶ Don’t load properties.
-
DO_NOT_AUTO_START_AT_CONSTRUCTION
= 16¶ 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, and only if
Gio.DBusProxyFlags.DO_NOT_AUTO_START
is not also specified.
-
DO_NOT_CONNECT_SIGNALS
= 2¶ Don’t connect to signals on the remote object.
-
DO_NOT_AUTO_START
= 4¶ 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.
-
GET_INVALIDATED_PROPERTIES
= 8¶ If set, the property value for any __invalidated property__ will be (asynchronously) retrieved upon receiving the PropertiesChanged D-Bus signal and the property will not cause emission of the
Gio.DBusProxy
::g-properties-changed
signal. When the value is received theGio.DBusProxy
::g-properties-changed
signal is emitted for the property along with the retrieved value.New in version 2.32.
-
-
class
Gio.
DBusSendMessageFlags
(value)¶ Bases:
GObject.GFlags
Flags used when sending
Gio.DBusMessages
on aGio.DBusConnection
.New in version 2.26.
-
NONE
= 0¶ No flags set.
-
PRESERVE_SERIAL
= 1¶ Do not automatically assign a serial number from the
Gio.DBusConnection
object when sending a message.
-
-
class
Gio.
DBusServerFlags
(value)¶ Bases:
GObject.GFlags
Flags used when creating a
Gio.DBusServer
.New in version 2.26.
-
NONE
= 0¶ No flags set.
-
RUN_IN_THREAD
= 1¶ All
Gio.DBusServer
::new-connection
signals will run in separated dedicated threads (see signal for details).
-
AUTHENTICATION_ALLOW_ANONYMOUS
= 2¶ Allow the anonymous authentication method.
-
-
class
Gio.
DBusSignalFlags
(value)¶ Bases:
GObject.GFlags
Flags used when subscribing to signals via
Gio.DBusConnection.signal_subscribe
().New in version 2.26.
-
NONE
= 0¶ No flags set.
-
NO_MATCH_RULE
= 1¶ 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).
-
MATCH_ARG0_NAMESPACE
= 2¶ Match first arguments that contain a bus or interface name with the given namespace.
-
MATCH_ARG0_PATH
= 4¶ 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.
-
-
class
Gio.
DBusSubtreeFlags
(value)¶ Bases:
GObject.GFlags
Flags passed to
Gio.DBusConnection.register_subtree
().New in version 2.26.
-
NONE
= 0¶ No flags set.
-
DISPATCH_TO_UNENUMERATED_NODES
= 1¶ 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.
-
-
class
Gio.
DriveStartFlags
(value)¶ Bases:
GObject.GFlags
Flags used when starting a drive.
New in version 2.22.
-
NONE
= 0¶ No flags set.
-
-
class
Gio.
FileAttributeInfoFlags
(value)¶ Bases:
GObject.GFlags
Flags specifying the behaviour of an attribute.
-
NONE
= 0¶ no flags set.
-
COPY_WITH_FILE
= 1¶ copy the attribute values when the file is copied.
-
COPY_WHEN_MOVED
= 2¶ copy the attribute values when the file is moved.
-
-
class
Gio.
FileCopyFlags
(value)¶ Bases:
GObject.GFlags
Flags used when copying or moving files.
-
NONE
= 0¶ No flags set.
-
OVERWRITE
= 1¶ Overwrite any existing files
-
NO_FALLBACK_FOR_MOVE
= 16¶ Don’t use copy and delete fallback if native move not supported.
-
BACKUP
= 2¶ Make a backup of any existing files.
-
TARGET_DEFAULT_PERMS
= 32¶ Leaves target file with default perms, instead of setting the source file perms.
-
NOFOLLOW_SYMLINKS
= 4¶ Don’t follow symlinks.
-
ALL_METADATA
= 8¶ Copy all file metadata instead of just default set used for copy (see
Gio.FileInfo
).
-
-
class
Gio.
FileCreateFlags
(value)¶ Bases:
GObject.GFlags
Flags used when an operation may create a file.
-
NONE
= 0¶ No flags set.
-
PRIVATE
= 1¶ Create a file that can only be accessed by the current user.
-
REPLACE_DESTINATION
= 2¶ Replace the destination as if it didn’t exist before. Don’t try to keep any old permissions, replace instead of following links. This is generally useful if you’re doing a “copy over” rather than a “save new version of” replace operation. You can think of it as “unlink destination” before writing to it, although the implementation may not be exactly like that.
New in version 2.20.
-
-
class
Gio.
FileMeasureFlags
(value)¶ Bases:
GObject.GFlags
Flags that can be used with g_file_measure_disk_usage().
New in version 2.38.
-
NONE
= 0¶ No flags set.
-
REPORT_ANY_ERROR
= 2¶ Report any error encountered while traversing the directory tree. Normally errors are only reported for the toplevel file.
-
APPARENT_SIZE
= 4¶ 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. Compare with
du --apparent-size
.
-
NO_XDEV
= 8¶ Do not cross mount point boundaries. Compare with
du -x
.
-
-
class
Gio.
FileMonitorFlags
(value)¶ Bases:
GObject.GFlags
Flags used to set what a
Gio.FileMonitor
will watch for.-
NONE
= 0¶ No flags set.
-
WATCH_MOUNTS
= 1¶ Watch for mount events.
-
SEND_MOVED
= 2¶ Pair DELETED and CREATED events caused by file renames (moves) and send a single
Gio.FileMonitorEvent.MOVED
event instead (NB: not supported on all backends; the default behaviour -without specifying this flag- is to send single DELETED and CREATED events). Deprecated since 2.46: useGio.FileMonitorFlags.WATCH_MOVES
instead.
-
WATCH_HARD_LINKS
= 4¶ Watch for changes to the file made via another hard link.
New in version 2.36.
-
WATCH_MOVES
= 8¶ Watch for rename operations on a monitored directory. This causes
Gio.FileMonitorEvent.RENAMED
,Gio.FileMonitorEvent.MOVED_IN
andGio.FileMonitorEvent.MOVED_OUT
events to be emitted when possible.New in version 2.46.
-
-
class
Gio.
FileQueryInfoFlags
(value)¶ Bases:
GObject.GFlags
Flags used when querying a
Gio.FileInfo
.-
NONE
= 0¶ No flags set.
-
NOFOLLOW_SYMLINKS
= 1¶ Don’t follow symlinks.
-
-
class
Gio.
IOStreamSpliceFlags
(value)¶ Bases:
GObject.GFlags
Gio.IOStreamSpliceFlags
determine how streams should be spliced.New in version 2.28.
-
NONE
= 0¶ Do not close either stream.
-
CLOSE_STREAM1
= 1¶ Close the first stream after the splice.
-
CLOSE_STREAM2
= 2¶ Close the second stream after the splice.
-
WAIT_FOR_BOTH
= 4¶ Wait for both splice operations to finish before calling the callback.
-
-
class
Gio.
MountMountFlags
(value)¶ Bases:
GObject.GFlags
Flags used when mounting a mount.
-
NONE
= 0¶ No flags set.
-
-
class
Gio.
MountUnmountFlags
(value)¶ Bases:
GObject.GFlags
Flags used when an unmounting a mount.
-
NONE
= 0¶ No flags set.
-
FORCE
= 1¶ Unmount even if there are outstanding file operations on the mount.
-
-
class
Gio.
OutputStreamSpliceFlags
(value)¶ Bases:
GObject.GFlags
Gio.OutputStreamSpliceFlags
determine how streams should be spliced.-
NONE
= 0¶ Do not close either stream.
-
CLOSE_SOURCE
= 1¶ Close the source stream after the splice.
-
CLOSE_TARGET
= 2¶ Close the target stream after the splice.
-
-
class
Gio.
ResourceFlags
(value)¶ Bases:
GObject.GFlags
Gio.ResourceFlags
give information about a particular file inside a resource bundle.New in version 2.32.
-
NONE
= 0¶ No flags set.
-
COMPRESSED
= 1¶ The file is compressed.
-
-
class
Gio.
ResourceLookupFlags
(value)¶ Bases:
GObject.GFlags
Gio.ResourceLookupFlags
determine how resource path lookups are handled.New in version 2.32.
-
NONE
= 0¶ No flags set.
-
-
class
Gio.
SettingsBindFlags
(value)¶ Bases:
GObject.GFlags
Flags used when creating a binding. These flags determine in which direction the binding works. The default is to synchronize in both directions.
-
DEFAULT
= 0¶ Equivalent to
G_SETTINGS_BIND_GET|G_SETTINGS_BIND_SET
-
GET
= 1¶ Update the
GObject.Object
property when the setting changes. It is an error to use this flag if the property is not writable.
-
INVERT_BOOLEAN
= 16¶ When passed to
Gio.Settings.bind
(), uses a pair of mapping functions that invert the boolean value when mapping between the setting and the property. The setting and property must both be booleans. You cannot pass this flag to g_settings_bind_with_mapping().
-
SET
= 2¶ Update the setting when the
GObject.Object
property changes. It is an error to use this flag if the property is not readable.
-
NO_SENSITIVITY
= 4¶ Do not try to bind a “sensitivity” property to the writability of the setting
-
GET_NO_CHANGES
= 8¶ When set in addition to
Gio.SettingsBindFlags.GET
, set theGObject.Object
property value initially from the setting, but do not listen for changes of the setting
-
-
class
Gio.
SocketMsgFlags
(value)¶ Bases:
GObject.GFlags
Flags used in
Gio.Socket.receive_message
() andGio.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.New in version 2.22.
-
NONE
= 0¶ No flags.
-
OOB
= 1¶ Request to send/receive out of band data.
-
PEEK
= 2¶ Read data from the socket without removing it from the queue.
-
DONTROUTE
= 4¶ Don’t use a gateway to send out the packet, only send to hosts on directly connected networks.
-
-
class
Gio.
SubprocessFlags
(value)¶ Bases:
GObject.GFlags
Flags to define the behaviour of a
Gio.Subprocess
.Note that the default for stdin is to redirect from
/dev/null
. For 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
Gio.SubprocessFlags.STDOUT_PIPE
andGio.SubprocessFlags.STDOUT_SILENCE
.New in version 2.40.
-
NONE
= 0¶ No flags.
-
STDIN_PIPE
= 1¶ create a pipe for the stdin of the spawned process that can be accessed with
Gio.Subprocess.get_stdin_pipe
().
-
INHERIT_FDS
= 128¶ 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).
-
STDERR_PIPE
= 16¶ create a pipe for the stderr of the spawned process that can be accessed with
Gio.Subprocess.get_stderr_pipe
().
-
STDIN_INHERIT
= 2¶ stdin is inherited from the calling process.
-
STDERR_SILENCE
= 32¶ silence the stderr of the spawned process (ie: redirect to
/dev/null
).
-
STDOUT_PIPE
= 4¶ create a pipe for the stdout of the spawned process that can be accessed with
Gio.Subprocess.get_stdout_pipe
().
-
STDERR_MERGE
= 64¶ 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.
-
STDOUT_SILENCE
= 8¶ silence the stdout of the spawned process (ie: redirect to
/dev/null
).
-
-
class
Gio.
TestDBusFlags
(value)¶ Bases:
GObject.GFlags
Flags to define future
Gio.TestDBus
behaviour.New in version 2.34.
-
NONE
= 0¶ No flags.
-
-
class
Gio.
TlsCertificateFlags
(value)¶ Bases:
GObject.GFlags
A set of flags describing TLS certification validation. This can be used to set which validation steps to perform (eg, with
Gio.TlsClientConnection.set_validation_flags
()), or to describe why a particular certificate was rejected (eg, inGio.TlsConnection
::accept-certificate
).New in version 2.28.
-
UNKNOWN_CA
= 1¶ The signing certificate authority is not known.
-
VALIDATE_ALL
= 127¶ the combination of all of the above flags
-
REVOKED
= 16¶ The certificate has been revoked according to the
Gio.TlsConnection
’s certificate revocation list.
-
BAD_IDENTITY
= 2¶ The certificate does not match the expected identity of the site that it was retrieved from.
-
INSECURE
= 32¶ The certificate’s algorithm is considered insecure.
-
NOT_ACTIVATED
= 4¶ The certificate’s activation time is still in the future
-
GENERIC_ERROR
= 64¶ Some other error occurred validating the certificate
-
EXPIRED
= 8¶ The certificate has expired
-
-
class
Gio.
TlsDatabaseVerifyFlags
(value)¶ Bases:
GObject.GFlags
Flags for
Gio.TlsDatabase.verify_chain
().New in version 2.30.
-
NONE
= 0¶ No verification flags
-
-
class
Gio.
TlsPasswordFlags
(value)¶ Bases:
GObject.GFlags
Various flags for the password.
New in version 2.30.
-
NONE
= 0¶ No flags
-
RETRY
= 2¶ The password was wrong, and the user should retry.
-
MANY_TRIES
= 4¶ Hint to the user that the password has been wrong many times, and the user may not have many chances left.
-
FINAL_TRY
= 8¶ Hint to the user that this is the last try to get this password right.
-