GIO Extensions: libxfce4util Reference Manual

GIO Extensions

GIO Extensions — various extensions to GIO

Functions

gboolean	xfce_g_file_metadata_is_supported ()
gchar *	xfce_g_file_create_checksum ()
gboolean	xfce_g_file_set_trusted ()
gboolean	xfce_g_file_is_trusted ()

Includes

#include <libxfce4util/libxfce4util.h>

Description

Common used functions for I/O that are not provided by the Glib library

Functions

xfce_g_file_metadata_is_supported ()

gboolean
xfce_g_file_metadata_is_supported (GFile *file);

Checks if GVFS-metadata is available for the file provided.

Parameters

file

a GFile.

Returns

TRUE is GVFS-metadata is supported, FALSE otherwise.

Since: 4.17

xfce_g_file_create_checksum ()

gchar *
xfce_g_file_create_checksum (GFile *file,
                             GCancellable *cancellable,
                             GError **error);

Generates an SHA-256 hash of the file .

Parameters

file	a GFile.
cancellable	optional GCancellable object, `NULL` to ignore.	[nullable]
error	a GError.	[nullable]

Returns

Checksum of the file . If file read fails, returns NULL. Free with g_free().

[transfer full][nullable]

Since: 4.17

xfce_g_file_set_trusted ()

gboolean
xfce_g_file_set_trusted (GFile *file,
                         gboolean is_trusted,
                         GCancellable *cancellable,
                         GError **error);

Sets the "safety flag" on if is_trusted .

Safety flag is a new concept introduced in XFCE 4.17. It is basically an additional execution flag stored in GVFS-metadata. Unlike the execution flag (+x), it is safe to assume that this flag did not come from foreign location (for example, by downloading an tar archive) and is set by user.

The checksum of the file is stored, and would be considered "on" only if checksum matches with the file on execution.

Parameters

file	a GFile.
is_trusted	TRUE if trusted, FALSE if not
cancellable	optional GCancellable object, `NULL` to ignore.	[nullable]
error	a GError.	[nullable]

Returns

TRUE on success, FALSE on error.

Since: 4.17

xfce_g_file_is_trusted ()

gboolean
xfce_g_file_is_trusted (GFile *file,
                        GCancellable *cancellable,
                        GError **error);

Compares the checksum stored in safety flag with the actual file. If it matches, it is considered safe.

Read the documentation of xfce_g_file_set_trusted() for details.

Parameters

file	a GFile.
cancellable	optional GCancellable object, `NULL` to ignore.	[nullable]
error	a GError.	[nullable]

Returns

TRUE if safety flag is verified or not supported. FALSE otherwise.

Since: 4.17