* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
+ * version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
- * Public License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
*
* Author: Alexander Larsson <alexl@redhat.com>
*/
-#include <config.h>
+#include "config.h"
#include <string.h>
#include "gmountoperation.h"
-#include "gio-marshal.h"
+#include "gioenumtypes.h"
#include "glibintl.h"
+#include "gmarshal-internal.h"
-G_DEFINE_TYPE (GMountOperation, g_mount_operation, G_TYPE_OBJECT);
+
+/**
+ * SECTION:gmountoperation
+ * @short_description: Object used for authentication and user interaction
+ * @include: gio/gio.h
+ *
+ * #GMountOperation provides a mechanism for interacting with the user.
+ * It can be used for authenticating mountable operations, such as loop
+ * mounting files, hard drive partitions or server locations. It can
+ * also be used to ask the user questions or show a list of applications
+ * preventing unmount or eject operations from completing.
+ *
+ * Note that #GMountOperation is used for more than just #GMount
+ * objects – for example it is also used in g_drive_start() and
+ * g_drive_stop().
+ *
+ * Users should instantiate a subclass of this that implements all the
+ * various callbacks to show the required dialogs, such as
+ * #GtkMountOperation. If no user interaction is desired (for example
+ * when automounting filesystems at login time), usually %NULL can be
+ * passed, see each method taking a #GMountOperation for details.
+ *
+ * The term ‘TCRYPT’ is used to mean ‘compatible with TrueCrypt and VeraCrypt’.
+ * [TrueCrypt](https://en.wikipedia.org/wiki/TrueCrypt) is a discontinued system for
+ * encrypting file containers, partitions or whole disks, typically used with Windows.
+ * [VeraCrypt](https://www.veracrypt.fr/) is a maintained fork of TrueCrypt with various
+ * improvements and auditing fixes.
+ */
enum {
ASK_PASSWORD,
ASK_QUESTION,
REPLY,
+ ABORTED,
+ SHOW_PROCESSES,
+ SHOW_UNMOUNT_PROGRESS,
LAST_SIGNAL
};
gboolean anonymous;
GPasswordSave password_save;
int choice;
+ gboolean hidden_volume;
+ gboolean system_volume;
+ guint pim;
};
+enum {
+ PROP_0,
+ PROP_USERNAME,
+ PROP_PASSWORD,
+ PROP_ANONYMOUS,
+ PROP_DOMAIN,
+ PROP_PASSWORD_SAVE,
+ PROP_CHOICE,
+ PROP_IS_TCRYPT_HIDDEN_VOLUME,
+ PROP_IS_TCRYPT_SYSTEM_VOLUME,
+ PROP_PIM
+};
+
+G_DEFINE_TYPE_WITH_PRIVATE (GMountOperation, g_mount_operation, G_TYPE_OBJECT)
+
+static void
+g_mount_operation_set_property (GObject *object,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec)
+{
+ GMountOperation *operation;
+
+ operation = G_MOUNT_OPERATION (object);
+
+ switch (prop_id)
+ {
+ case PROP_USERNAME:
+ g_mount_operation_set_username (operation,
+ g_value_get_string (value));
+ break;
+
+ case PROP_PASSWORD:
+ g_mount_operation_set_password (operation,
+ g_value_get_string (value));
+ break;
+
+ case PROP_ANONYMOUS:
+ g_mount_operation_set_anonymous (operation,
+ g_value_get_boolean (value));
+ break;
+
+ case PROP_DOMAIN:
+ g_mount_operation_set_domain (operation,
+ g_value_get_string (value));
+ break;
+
+ case PROP_PASSWORD_SAVE:
+ g_mount_operation_set_password_save (operation,
+ g_value_get_enum (value));
+ break;
+
+ case PROP_CHOICE:
+ g_mount_operation_set_choice (operation,
+ g_value_get_int (value));
+ break;
+
+ case PROP_IS_TCRYPT_HIDDEN_VOLUME:
+ g_mount_operation_set_is_tcrypt_hidden_volume (operation,
+ g_value_get_boolean (value));
+ break;
+
+ case PROP_IS_TCRYPT_SYSTEM_VOLUME:
+ g_mount_operation_set_is_tcrypt_system_volume (operation,
+ g_value_get_boolean (value));
+ break;
+
+ case PROP_PIM:
+ g_mount_operation_set_pim (operation,
+ g_value_get_uint (value));
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
+ }
+}
+
+
+static void
+g_mount_operation_get_property (GObject *object,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec)
+{
+ GMountOperation *operation;
+ GMountOperationPrivate *priv;
+
+ operation = G_MOUNT_OPERATION (object);
+ priv = operation->priv;
+
+ switch (prop_id)
+ {
+ case PROP_USERNAME:
+ g_value_set_string (value, priv->user);
+ break;
+
+ case PROP_PASSWORD:
+ g_value_set_string (value, priv->password);
+ break;
+
+ case PROP_ANONYMOUS:
+ g_value_set_boolean (value, priv->anonymous);
+ break;
+
+ case PROP_DOMAIN:
+ g_value_set_string (value, priv->domain);
+ break;
+
+ case PROP_PASSWORD_SAVE:
+ g_value_set_enum (value, priv->password_save);
+ break;
+
+ case PROP_CHOICE:
+ g_value_set_int (value, priv->choice);
+ break;
+
+ case PROP_IS_TCRYPT_HIDDEN_VOLUME:
+ g_value_set_boolean (value, priv->hidden_volume);
+ break;
+
+ case PROP_IS_TCRYPT_SYSTEM_VOLUME:
+ g_value_set_boolean (value, priv->system_volume);
+ break;
+
+ case PROP_PIM:
+ g_value_set_uint (value, priv->pim);
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
+ }
+}
+
+
static void
g_mount_operation_finalize (GObject *object)
{
g_free (priv->password);
g_free (priv->user);
g_free (priv->domain);
-
- if (G_OBJECT_CLASS (g_mount_operation_parent_class)->finalize)
- (*G_OBJECT_CLASS (g_mount_operation_parent_class)->finalize) (object);
+
+ G_OBJECT_CLASS (g_mount_operation_parent_class)->finalize (object);
}
static gboolean
-boolean_handled_accumulator (GSignalInvocationHint *ihint,
- GValue *return_accu,
- const GValue *handler_return,
- gpointer dummy)
+reply_non_handled_in_idle (gpointer data)
{
- gboolean continue_emission;
- gboolean signal_handled;
-
- signal_handled = g_value_get_boolean (handler_return);
- g_value_set_boolean (return_accu, signal_handled);
- continue_emission = !signal_handled;
-
- return continue_emission;
+ GMountOperation *op = data;
+
+ g_mount_operation_reply (op, G_MOUNT_OPERATION_UNHANDLED);
+ return G_SOURCE_REMOVE;
}
-static gboolean
+static void
ask_password (GMountOperation *op,
const char *message,
const char *default_user,
const char *default_domain,
- GPasswordFlags flags)
+ GAskPasswordFlags flags)
{
- return FALSE;
+ g_idle_add_full (G_PRIORITY_DEFAULT_IDLE,
+ reply_non_handled_in_idle,
+ g_object_ref (op),
+ g_object_unref);
}
-static gboolean
+static void
ask_question (GMountOperation *op,
const char *message,
const char *choices[])
{
- return FALSE;
+ g_idle_add_full (G_PRIORITY_DEFAULT_IDLE,
+ reply_non_handled_in_idle,
+ g_object_ref (op),
+ g_object_unref);
+}
+
+static void
+show_processes (GMountOperation *op,
+ const gchar *message,
+ GArray *processes,
+ const gchar *choices[])
+{
+ g_idle_add_full (G_PRIORITY_DEFAULT_IDLE,
+ reply_non_handled_in_idle,
+ g_object_ref (op),
+ g_object_unref);
+}
+
+static void
+show_unmount_progress (GMountOperation *op,
+ const gchar *message,
+ gint64 time_left,
+ gint64 bytes_left)
+{
+ /* nothing to do */
}
static void
g_mount_operation_class_init (GMountOperationClass *klass)
{
- GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
-
- g_type_class_add_private (klass, sizeof (GMountOperationPrivate));
-
- gobject_class->finalize = g_mount_operation_finalize;
+ GObjectClass *object_class;
+
+ object_class = G_OBJECT_CLASS (klass);
+ object_class->finalize = g_mount_operation_finalize;
+ object_class->get_property = g_mount_operation_get_property;
+ object_class->set_property = g_mount_operation_set_property;
klass->ask_password = ask_password;
klass->ask_question = ask_question;
+ klass->show_processes = show_processes;
+ klass->show_unmount_progress = show_unmount_progress;
+ /**
+ * GMountOperation::ask-password:
+ * @op: a #GMountOperation requesting a password.
+ * @message: string containing a message to display to the user.
+ * @default_user: string containing the default user name.
+ * @default_domain: string containing the default domain.
+ * @flags: a set of #GAskPasswordFlags.
+ *
+ * Emitted when a mount operation asks the user for a password.
+ *
+ * If the message contains a line break, the first line should be
+ * presented as a heading. For example, it may be used as the
+ * primary text in a #GtkMessageDialog.
+ */
signals[ASK_PASSWORD] =
- g_signal_new (I_("ask_password"),
- G_TYPE_FROM_CLASS (gobject_class),
+ g_signal_new (I_("ask-password"),
+ G_TYPE_FROM_CLASS (object_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GMountOperationClass, ask_password),
- boolean_handled_accumulator, NULL,
- _gio_marshal_BOOLEAN__STRING_STRING_STRING_INT,
- G_TYPE_BOOLEAN, 4,
- G_TYPE_STRING, G_TYPE_STRING, G_TYPE_STRING, G_TYPE_UINT);
-
+ NULL, NULL,
+ _g_cclosure_marshal_VOID__STRING_STRING_STRING_FLAGS,
+ G_TYPE_NONE, 4,
+ G_TYPE_STRING, G_TYPE_STRING, G_TYPE_STRING, G_TYPE_ASK_PASSWORD_FLAGS);
+ g_signal_set_va_marshaller (signals[ASK_PASSWORD],
+ G_TYPE_FROM_CLASS (object_class),
+ _g_cclosure_marshal_VOID__STRING_STRING_STRING_FLAGSv);
+
+ /**
+ * GMountOperation::ask-question:
+ * @op: a #GMountOperation asking a question.
+ * @message: string containing a message to display to the user.
+ * @choices: an array of strings for each possible choice.
+ *
+ * Emitted when asking the user a question and gives a list of
+ * choices for the user to choose from.
+ *
+ * If the message contains a line break, the first line should be
+ * presented as a heading. For example, it may be used as the
+ * primary text in a #GtkMessageDialog.
+ */
signals[ASK_QUESTION] =
- g_signal_new (I_("ask_question"),
- G_TYPE_FROM_CLASS (gobject_class),
+ g_signal_new (I_("ask-question"),
+ G_TYPE_FROM_CLASS (object_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GMountOperationClass, ask_question),
- boolean_handled_accumulator, NULL,
- _gio_marshal_BOOLEAN__STRING_POINTER,
- G_TYPE_BOOLEAN, 2,
- G_TYPE_STRING, G_TYPE_POINTER);
-
+ NULL, NULL,
+ _g_cclosure_marshal_VOID__STRING_BOXED,
+ G_TYPE_NONE, 2,
+ G_TYPE_STRING, G_TYPE_STRV);
+ g_signal_set_va_marshaller (signals[ASK_QUESTION],
+ G_TYPE_FROM_CLASS (object_class),
+ _g_cclosure_marshal_VOID__STRING_BOXEDv);
+
+ /**
+ * GMountOperation::reply:
+ * @op: a #GMountOperation.
+ * @result: a #GMountOperationResult indicating how the request was handled
+ *
+ * Emitted when the user has replied to the mount operation.
+ */
signals[REPLY] =
g_signal_new (I_("reply"),
- G_TYPE_FROM_CLASS (gobject_class),
+ G_TYPE_FROM_CLASS (object_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GMountOperationClass, reply),
NULL, NULL,
- g_cclosure_marshal_VOID__BOOLEAN,
+ NULL,
G_TYPE_NONE, 1,
- G_TYPE_BOOLEAN);
+ G_TYPE_MOUNT_OPERATION_RESULT);
+
+ /**
+ * GMountOperation::aborted:
+ *
+ * Emitted by the backend when e.g. a device becomes unavailable
+ * while a mount operation is in progress.
+ *
+ * Implementations of GMountOperation should handle this signal
+ * by dismissing open password dialogs.
+ *
+ * Since: 2.20
+ */
+ signals[ABORTED] =
+ g_signal_new (I_("aborted"),
+ G_TYPE_FROM_CLASS (object_class),
+ G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GMountOperationClass, aborted),
+ NULL, NULL,
+ NULL,
+ G_TYPE_NONE, 0);
+
+ /**
+ * GMountOperation::show-processes:
+ * @op: a #GMountOperation.
+ * @message: string containing a message to display to the user.
+ * @processes: (element-type GPid): an array of #GPid for processes
+ * blocking the operation.
+ * @choices: an array of strings for each possible choice.
+ *
+ * Emitted when one or more processes are blocking an operation
+ * e.g. unmounting/ejecting a #GMount or stopping a #GDrive.
+ *
+ * Note that this signal may be emitted several times to update the
+ * list of blocking processes as processes close files. The
+ * application should only respond with g_mount_operation_reply() to
+ * the latest signal (setting #GMountOperation:choice to the choice
+ * the user made).
+ *
+ * If the message contains a line break, the first line should be
+ * presented as a heading. For example, it may be used as the
+ * primary text in a #GtkMessageDialog.
+ *
+ * Since: 2.22
+ */
+ signals[SHOW_PROCESSES] =
+ g_signal_new (I_("show-processes"),
+ G_TYPE_FROM_CLASS (object_class),
+ G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GMountOperationClass, show_processes),
+ NULL, NULL,
+ _g_cclosure_marshal_VOID__STRING_BOXED_BOXED,
+ G_TYPE_NONE, 3,
+ G_TYPE_STRING, G_TYPE_ARRAY, G_TYPE_STRV);
+ g_signal_set_va_marshaller (signals[SHOW_PROCESSES],
+ G_TYPE_FROM_CLASS (object_class),
+ _g_cclosure_marshal_VOID__STRING_BOXED_BOXEDv);
+
+ /**
+ * GMountOperation::show-unmount-progress:
+ * @op: a #GMountOperation:
+ * @message: string containing a message to display to the user
+ * @time_left: the estimated time left before the operation completes,
+ * in microseconds, or -1
+ * @bytes_left: the amount of bytes to be written before the operation
+ * completes (or -1 if such amount is not known), or zero if the operation
+ * is completed
+ *
+ * Emitted when an unmount operation has been busy for more than some time
+ * (typically 1.5 seconds).
+ *
+ * When unmounting or ejecting a volume, the kernel might need to flush
+ * pending data in its buffers to the volume stable storage, and this operation
+ * can take a considerable amount of time. This signal may be emitted several
+ * times as long as the unmount operation is outstanding, and then one
+ * last time when the operation is completed, with @bytes_left set to zero.
+ *
+ * Implementations of GMountOperation should handle this signal by
+ * showing an UI notification, and then dismiss it, or show another notification
+ * of completion, when @bytes_left reaches zero.
+ *
+ * If the message contains a line break, the first line should be
+ * presented as a heading. For example, it may be used as the
+ * primary text in a #GtkMessageDialog.
+ *
+ * Since: 2.34
+ */
+ signals[SHOW_UNMOUNT_PROGRESS] =
+ g_signal_new (I_("show-unmount-progress"),
+ G_TYPE_FROM_CLASS (object_class),
+ G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GMountOperationClass, show_unmount_progress),
+ NULL, NULL,
+ _g_cclosure_marshal_VOID__STRING_INT64_INT64,
+ G_TYPE_NONE, 3,
+ G_TYPE_STRING, G_TYPE_INT64, G_TYPE_INT64);
+ g_signal_set_va_marshaller (signals[SHOW_UNMOUNT_PROGRESS],
+ G_TYPE_FROM_CLASS (object_class),
+ _g_cclosure_marshal_VOID__STRING_INT64_INT64v);
+
+ /**
+ * GMountOperation:username:
+ *
+ * The user name that is used for authentication when carrying out
+ * the mount operation.
+ */
+ g_object_class_install_property (object_class,
+ PROP_USERNAME,
+ g_param_spec_string ("username",
+ P_("Username"),
+ P_("The user name"),
+ NULL,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:password:
+ *
+ * The password that is used for authentication when carrying out
+ * the mount operation.
+ */
+ g_object_class_install_property (object_class,
+ PROP_PASSWORD,
+ g_param_spec_string ("password",
+ P_("Password"),
+ P_("The password"),
+ NULL,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:anonymous:
+ *
+ * Whether to use an anonymous user when authenticating.
+ */
+ g_object_class_install_property (object_class,
+ PROP_ANONYMOUS,
+ g_param_spec_boolean ("anonymous",
+ P_("Anonymous"),
+ P_("Whether to use an anonymous user"),
+ FALSE,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:domain:
+ *
+ * The domain to use for the mount operation.
+ */
+ g_object_class_install_property (object_class,
+ PROP_DOMAIN,
+ g_param_spec_string ("domain",
+ P_("Domain"),
+ P_("The domain of the mount operation"),
+ NULL,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:password-save:
+ *
+ * Determines if and how the password information should be saved.
+ */
+ g_object_class_install_property (object_class,
+ PROP_PASSWORD_SAVE,
+ g_param_spec_enum ("password-save",
+ P_("Password save"),
+ P_("How passwords should be saved"),
+ G_TYPE_PASSWORD_SAVE,
+ G_PASSWORD_SAVE_NEVER,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:choice:
+ *
+ * The index of the user's choice when a question is asked during the
+ * mount operation. See the #GMountOperation::ask-question signal.
+ */
+ g_object_class_install_property (object_class,
+ PROP_CHOICE,
+ g_param_spec_int ("choice",
+ P_("Choice"),
+ P_("The users choice"),
+ 0, G_MAXINT, 0,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:is-tcrypt-hidden-volume:
+ *
+ * Whether the device to be unlocked is a TCRYPT hidden volume.
+ * See [the VeraCrypt documentation](https://www.veracrypt.fr/en/Hidden%20Volume.html).
+ *
+ * Since: 2.58
+ */
+ g_object_class_install_property (object_class,
+ PROP_IS_TCRYPT_HIDDEN_VOLUME,
+ g_param_spec_boolean ("is-tcrypt-hidden-volume",
+ P_("TCRYPT Hidden Volume"),
+ P_("Whether to unlock a TCRYPT hidden volume. See https://www.veracrypt.fr/en/Hidden%20Volume.html."),
+ FALSE,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:is-tcrypt-system-volume:
+ *
+ * Whether the device to be unlocked is a TCRYPT system volume.
+ * In this context, a system volume is a volume with a bootloader
+ * and operating system installed. This is only supported for Windows
+ * operating systems. For further documentation, see
+ * [the VeraCrypt documentation](https://www.veracrypt.fr/en/System%20Encryption.html).
+ *
+ * Since: 2.58
+ */
+ g_object_class_install_property (object_class,
+ PROP_IS_TCRYPT_SYSTEM_VOLUME,
+ g_param_spec_boolean ("is-tcrypt-system-volume",
+ P_("TCRYPT System Volume"),
+ P_("Whether to unlock a TCRYPT system volume. Only supported for unlocking Windows system volumes. See https://www.veracrypt.fr/en/System%20Encryption.html."),
+ FALSE,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+ /**
+ * GMountOperation:pim:
+ *
+ * The VeraCrypt PIM value, when unlocking a VeraCrypt volume. See
+ * [the VeraCrypt documentation](https://www.veracrypt.fr/en/Personal%20Iterations%20Multiplier%20(PIM).html).
+ *
+ * Since: 2.58
+ */
+ g_object_class_install_property (object_class,
+ PROP_PIM,
+ g_param_spec_uint ("pim",
+ P_("PIM"),
+ P_("The VeraCrypt PIM value"),
+ 0, G_MAXUINT, 0,
+ G_PARAM_READWRITE|
+ G_PARAM_STATIC_NAME|G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
}
static void
g_mount_operation_init (GMountOperation *operation)
{
- operation->priv = G_TYPE_INSTANCE_GET_PRIVATE (operation,
- G_TYPE_MOUNT_OPERATION,
- GMountOperationPrivate);
+ operation->priv = g_mount_operation_get_instance_private (operation);
}
/**
* g_mount_operation_new:
*
- * Returns: a new #GMountOperation.
+ * Creates a new mount operation.
+ *
+ * Returns: a #GMountOperation.
**/
GMountOperation *
g_mount_operation_new (void)
}
/**
- * g_mount_operation_get_username
- * @op:
+ * g_mount_operation_get_username:
+ * @op: a #GMountOperation.
*
- * Returns:
+ * Get the user name from the mount operation.
+ *
+ * Returns: a string containing the user name.
**/
const char *
g_mount_operation_get_username (GMountOperation *op)
/**
* g_mount_operation_set_username:
- * @op:
+ * @op: a #GMountOperation.
* @username: input username.
- *
+ *
+ * Sets the user name within @op to @username.
**/
void
g_mount_operation_set_username (GMountOperation *op,
g_return_if_fail (G_IS_MOUNT_OPERATION (op));
g_free (op->priv->user);
op->priv->user = g_strdup (username);
+ g_object_notify (G_OBJECT (op), "username");
}
/**
* g_mount_operation_get_password:
- * @op:
- *
- * Returns:
+ * @op: a #GMountOperation.
+ *
+ * Gets a password from the mount operation.
+ *
+ * Returns: a string containing the password within @op.
**/
const char *
g_mount_operation_get_password (GMountOperation *op)
/**
* g_mount_operation_set_password:
- * @op: the given #GMountOperation.
+ * @op: a #GMountOperation.
* @password: password to set.
*
* Sets the mount operation's password to @password.
g_return_if_fail (G_IS_MOUNT_OPERATION (op));
g_free (op->priv->password);
op->priv->password = g_strdup (password);
+ g_object_notify (G_OBJECT (op), "password");
}
/**
* g_mount_operation_get_anonymous:
- * @op:
+ * @op: a #GMountOperation.
+ *
+ * Check to see whether the mount operation is being used
+ * for an anonymous user.
*
* Returns: %TRUE if mount operation is anonymous.
**/
/**
* g_mount_operation_set_anonymous:
- * @op: the given #GMountOperation.
+ * @op: a #GMountOperation.
* @anonymous: boolean value.
*
+ * Sets the mount operation to use an anonymous user if @anonymous is %TRUE.
**/
void
g_mount_operation_set_anonymous (GMountOperation *op,
gboolean anonymous)
{
+ GMountOperationPrivate *priv;
g_return_if_fail (G_IS_MOUNT_OPERATION (op));
- op->priv->anonymous = anonymous;
+ priv = op->priv;
+
+ if (priv->anonymous != anonymous)
+ {
+ priv->anonymous = anonymous;
+ g_object_notify (G_OBJECT (op), "anonymous");
+ }
}
/**
* g_mount_operation_get_domain:
- * @op:
+ * @op: a #GMountOperation.
+ *
+ * Gets the domain of the mount operation.
*
- * Returns: a const string set to the domain.
+ * Returns: a string set to the domain.
**/
const char *
g_mount_operation_get_domain (GMountOperation *op)
/**
* g_mount_operation_set_domain:
- * @op: the given #GMountOperation.
+ * @op: a #GMountOperation.
* @domain: the domain to set.
*
* Sets the mount operation's domain.
g_return_if_fail (G_IS_MOUNT_OPERATION (op));
g_free (op->priv->domain);
op->priv->domain = g_strdup (domain);
+ g_object_notify (G_OBJECT (op), "domain");
}
/**
* g_mount_operation_get_password_save:
- * @op: the given #GMountOperation.
+ * @op: a #GMountOperation.
+ *
+ * Gets the state of saving passwords for the mount operation.
*
- * Returns: #GPasswordSave.
+ * Returns: a #GPasswordSave flag.
**/
GPasswordSave
}
/**
- * g_mount_operation_set_password_save
- * @op:
- * @save: #GPasswordSave
+ * g_mount_operation_set_password_save:
+ * @op: a #GMountOperation.
+ * @save: a set of #GPasswordSave flags.
+ *
+ * Sets the state of saving passwords for the mount operation.
*
**/
void
g_mount_operation_set_password_save (GMountOperation *op,
GPasswordSave save)
{
+ GMountOperationPrivate *priv;
g_return_if_fail (G_IS_MOUNT_OPERATION (op));
- op->priv->password_save = save;
+ priv = op->priv;
+
+ if (priv->password_save != save)
+ {
+ priv->password_save = save;
+ g_object_notify (G_OBJECT (op), "password-save");
+ }
}
/**
* g_mount_operation_get_choice:
- * @op:
+ * @op: a #GMountOperation.
*
- * Returns:
+ * Gets a choice from the mount operation.
+ *
+ * Returns: an integer containing an index of the user's choice from
+ * the choice's list, or `0`.
**/
int
g_mount_operation_get_choice (GMountOperation *op)
/**
* g_mount_operation_set_choice:
- * @op:
- * @choice:
- *
+ * @op: a #GMountOperation.
+ * @choice: an integer.
+ *
+ * Sets a default choice for the mount operation.
**/
void
g_mount_operation_set_choice (GMountOperation *op,
- int choice)
+ int choice)
{
+ GMountOperationPrivate *priv;
+ g_return_if_fail (G_IS_MOUNT_OPERATION (op));
+ priv = op->priv;
+ if (priv->choice != choice)
+ {
+ priv->choice = choice;
+ g_object_notify (G_OBJECT (op), "choice");
+ }
+}
+
+/**
+ * g_mount_operation_get_is_tcrypt_hidden_volume:
+ * @op: a #GMountOperation.
+ *
+ * Check to see whether the mount operation is being used
+ * for a TCRYPT hidden volume.
+ *
+ * Returns: %TRUE if mount operation is for hidden volume.
+ *
+ * Since: 2.58
+ **/
+gboolean
+g_mount_operation_get_is_tcrypt_hidden_volume (GMountOperation *op)
+{
+ g_return_val_if_fail (G_IS_MOUNT_OPERATION (op), FALSE);
+ return op->priv->hidden_volume;
+}
+
+/**
+ * g_mount_operation_set_is_tcrypt_hidden_volume:
+ * @op: a #GMountOperation.
+ * @hidden_volume: boolean value.
+ *
+ * Sets the mount operation to use a hidden volume if @hidden_volume is %TRUE.
+ *
+ * Since: 2.58
+ **/
+void
+g_mount_operation_set_is_tcrypt_hidden_volume (GMountOperation *op,
+ gboolean hidden_volume)
+{
+ GMountOperationPrivate *priv;
+ g_return_if_fail (G_IS_MOUNT_OPERATION (op));
+ priv = op->priv;
+
+ if (priv->hidden_volume != hidden_volume)
+ {
+ priv->hidden_volume = hidden_volume;
+ g_object_notify (G_OBJECT (op), "is-tcrypt-hidden-volume");
+ }
+}
+
+/**
+ * g_mount_operation_get_is_tcrypt_system_volume:
+ * @op: a #GMountOperation.
+ *
+ * Check to see whether the mount operation is being used
+ * for a TCRYPT system volume.
+ *
+ * Returns: %TRUE if mount operation is for system volume.
+ *
+ * Since: 2.58
+ **/
+gboolean
+g_mount_operation_get_is_tcrypt_system_volume (GMountOperation *op)
+{
+ g_return_val_if_fail (G_IS_MOUNT_OPERATION (op), FALSE);
+ return op->priv->system_volume;
+}
+
+/**
+ * g_mount_operation_set_is_tcrypt_system_volume:
+ * @op: a #GMountOperation.
+ * @system_volume: boolean value.
+ *
+ * Sets the mount operation to use a system volume if @system_volume is %TRUE.
+ *
+ * Since: 2.58
+ **/
+void
+g_mount_operation_set_is_tcrypt_system_volume (GMountOperation *op,
+ gboolean system_volume)
+{
+ GMountOperationPrivate *priv;
+ g_return_if_fail (G_IS_MOUNT_OPERATION (op));
+ priv = op->priv;
+
+ if (priv->system_volume != system_volume)
+ {
+ priv->system_volume = system_volume;
+ g_object_notify (G_OBJECT (op), "is-tcrypt-system-volume");
+ }
+}
+
+/**
+ * g_mount_operation_get_pim:
+ * @op: a #GMountOperation.
+ *
+ * Gets a PIM from the mount operation.
+ *
+ * Returns: The VeraCrypt PIM within @op.
+ *
+ * Since: 2.58
+ **/
+guint
+g_mount_operation_get_pim (GMountOperation *op)
+{
+ g_return_val_if_fail (G_IS_MOUNT_OPERATION (op), 0);
+ return op->priv->pim;
+}
+
+/**
+ * g_mount_operation_set_pim:
+ * @op: a #GMountOperation.
+ * @pim: an unsigned integer.
+ *
+ * Sets the mount operation's PIM to @pim.
+ *
+ * Since: 2.58
+ **/
+void
+g_mount_operation_set_pim (GMountOperation *op,
+ guint pim)
+{
+ GMountOperationPrivate *priv;
g_return_if_fail (G_IS_MOUNT_OPERATION (op));
- op->priv->choice = choice;
+ priv = op->priv;
+ if (priv->pim != pim)
+ {
+ priv->pim = pim;
+ g_object_notify (G_OBJECT (op), "pim");
+ }
}
/**
* g_mount_operation_reply:
- * @op: #GMountOperation.
- * @abort: boolean.
+ * @op: a #GMountOperation
+ * @result: a #GMountOperationResult
*
- * Emits the #GMountOperation::Reply signal with the abort flag set to
- * @abort.
+ * Emits the #GMountOperation::reply signal.
**/
void
g_mount_operation_reply (GMountOperation *op,
- gboolean abort)
+ GMountOperationResult result)
{
g_return_if_fail (G_IS_MOUNT_OPERATION (op));
- g_signal_emit (op, signals[REPLY], 0, abort);
+ g_signal_emit (op, signals[REPLY], 0, result);
}
projects / platform / upstream / glib.git / blobdiff