Flags

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.

DEFAULT_FLAGS = 0

Default flags.

New in version 2.74.

FLAGS_NONE = 0

Default flags.

Deprecated since version 2.74: Use [flags`Gio`.ApplicationFlags.DEFAULT_FLAGS].

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.

ALLOW_REPLACEMENT = 128

Allow another instance to take over the bus name.

New in version 2.60.

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 the Gio.Application ::command-line signal handler, via Gio.ApplicationCommandLine.getenv().

IS_LAUNCHER = 2

Don’t try to become the primary instance.

REPLACE = 256

Take over from another instance. This flag is usually set by passing --gapplication-replace on the commandline.

New in version 2.60.

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. See Gio.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

New in version 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.

New in version 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_REQUIRE_SAME_USER = 32

When authenticating as a server, require the UID of the peer to be the same as the UID of the server.

New in version 2.68.

AUTHENTICATION_ALLOW_ANONYMOUS = 4

When authenticating as a server, allow the anonymous authentication method.

CROSS_NAMESPACE = 64

When authenticating, try to use protocols that work across a Linux user namespace boundary, even if this reduces interoperability with older D-Bus implementations. This currently affects client-side EXTERNAL authentication, for which this flag makes connections to a server in another user namespace succeed, but causes a deadlock when connecting to a GDBus server older than 2.73.3.

New in version 2.74.

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.

NO_MATCH_RULE = 32

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).

New in version 2.72.

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 the Gio.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 a Gio.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.

AUTHENTICATION_REQUIRE_SAME_USER = 4

Require the UID of the peer to be the same as the UID of the server when authenticating.

New in version 2.68.

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.

Don’t follow symlinks.

TARGET_DEFAULT_MODIFIED_TIME = 64

Use default modification timestamps instead of copying them from the source file.

New in version 2.80.

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. This flag can only be used with Gio.File.replace() and its variants, including Gio.File.replace_contents().

New in version 2.20.

class Gio.FileMeasureFlags(value)

Bases: GObject.GFlags

Flags that can be used with Gio.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. Since GLib 2.78. and similarly to du since GNU Coreutils 9.2, this will ignore the sizes of file types other than regular files and links, as the sizes of other file types are not specified in a standard way.

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: use Gio.FileMonitorFlags.WATCH_MOVES instead.

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 and Gio.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.

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.ResolverNameLookupFlags(value)

Bases: GObject.GFlags

Flags to modify lookup behavior.

New in version 2.60.

DEFAULT = 0

default behavior (same as Gio.Resolver.lookup_by_name())

IPV4_ONLY = 1

only resolve ipv4 addresses

IPV6_ONLY = 2

only resolve ipv6 addresses

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 [class`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 [method`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 [method`Gio`.Settings.bind_with_mapping].

SET = 2

Update the setting when the [class`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 [flags`Gio`.SettingsBindFlags.GET], set the [class`GObject`.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() and Gio.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 and Gio.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.

SEARCH_PATH_FROM_ENVP = 256

if path searching is needed when spawning the subprocess, use the PATH in the launcher environment.

New in version 2.72.

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 describe why a particular certificate was rejected (for example, in Gio.TlsConnection ::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 Gio.TlsCertificateFlags.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.

New in version 2.28.

NO_FLAGS = 0

No flags set.

New in version 2.74.

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

PKCS11_USER = 16

For PKCS #11, the user PIN is required.

New in version 2.70.

RETRY = 2

The password was wrong, and the user should retry.

PKCS11_SECURITY_OFFICER = 32

For PKCS #11, the security officer PIN is required.

New in version 2.70.

MANY_TRIES = 4

Hint to the user that the password has been wrong many times, and the user may not have many chances left.

PKCS11_CONTEXT_SPECIFIC = 64

For PKCS #11, the context-specific PIN is required.

New in version 2.70.

FINAL_TRY = 8

Hint to the user that this is the last try to get this password right.