Top |
GDBusConnection * | connection | Read / Write / Construct Only |
gboolean | disable-modules | Read / Write / Construct Only |
gboolean | enable-tcrypt | Read / Write / Construct Only |
gboolean | force-load-modules | Read / Write / Construct Only |
UDisksMountMonitor * | mount-monitor | Read |
GDBusObjectManagerServer * | object-manager | Read |
gboolean | uninstalled | Read / Write / Construct Only |
char * | uuid | Read / Write |
UDisksDaemon * udisks_daemon_new (GDBusConnection *connection
,gboolean disable_modules
,gboolean force_load_modules
,gboolean uninstalled
,gboolean enable_tcrypt
);
Create a new daemon object for exporting objects on connection
.
connection |
A GDBusConnection. |
|
disable_modules |
Indicates whether modules should never be activated. |
|
force_load_modules |
Activate modules on startup (for debugging purposes). |
|
uninstalled |
Loads modules from the build directory (for debugging purposes). |
|
enable_tcrypt |
Checks whether devices could be TCRYPT encrypted. |
GDBusConnection *
udisks_daemon_get_connection (UDisksDaemon *daemon
);
Gets the D-Bus connection used by daemon
.
GDBusObjectManagerServer *
udisks_daemon_get_object_manager (UDisksDaemon *daemon
);
Gets the D-Bus object manager used by daemon
.
UDisksMountMonitor *
udisks_daemon_get_mount_monitor (UDisksDaemon *daemon
);
Gets the mount monitor used by daemon
.
UDisksCrypttabMonitor *
udisks_daemon_get_crypttab_monitor (UDisksDaemon *daemon
);
Gets the crypttab monitor used by daemon
.
UDisksLinuxProvider *
udisks_daemon_get_linux_provider (UDisksDaemon *daemon
);
Gets the Linux Provider, if any.
PolkitAuthority *
udisks_daemon_get_authority (UDisksDaemon *daemon
);
Gets the PolicyKit authority used by daemon
.
A PolkitAuthority instance or NULL
if the polkit
authority is not available. Do not free, the object is owned by
daemon
.
UDisksState *
udisks_daemon_get_state (UDisksDaemon *daemon
);
Gets the state object used by daemon
.
gboolean
udisks_daemon_get_disable_modules (UDisksDaemon *daemon
);
Gets daemon
setting whether modules should never be loaded.
gboolean
udisks_daemon_get_force_load_modules (UDisksDaemon *daemon
);
Gets daemon
setting whether modules should be activated upon start.
UDisksModuleManager *
udisks_daemon_get_module_manager (UDisksDaemon *daemon
);
Gets the module manager used by daemon
.
UDisksConfigManager *
udisks_daemon_get_config_manager (UDisksDaemon *daemon
);
Gets the config manager used by daemon
.
gboolean
udisks_daemon_get_enable_tcrypt (UDisksDaemon *daemon
);
Gets daemon
setting whether devices should be tested for being TCRYPT
encrypted.
gboolean
udisks_daemon_get_uninstalled (UDisksDaemon *daemon
);
Gets daemon
setting whether the modules should be loaded from the build
directory.
UDisksUtabMonitor *
udisks_daemon_get_utab_monitor (UDisksDaemon *daemon
);
Gets the utab monitor used by daemon
.
gchar * udisks_daemon_get_parent_for_tracking (UDisksDaemon *daemon
,const gchar *path
,gchar **uuid
);
Finds parent block device and returns its object path and UUID.
If the return value is NULL
, the value of uuid
has not been changed.
daemon |
A UDisksDaemon. |
|
path |
object path of a child to find parent of |
|
uuid |
a pointer to return parent UUID string |
gpointer (*UDisksDaemonWaitFuncGeneric) (UDisksDaemon *daemon
,gpointer user_data
);
Type for callback function used with udisks_daemon_wait_for_object_sync()
.
daemon |
A UDisksDaemon. |
|
user_data |
The gpointer passed to |
NULL
if the object to wait for was not found, otherwise a full reference to a UDisksObject.
[transfer full]
UDisksObject * udisks_daemon_wait_for_object_sync (UDisksDaemon *daemon
,UDisksDaemonWaitFuncObject wait_func
,gpointer user_data
,GDestroyNotify user_data_free_func
,guint timeout_seconds
,GError **error
);
Blocks the calling thread until an object picked by wait_func
is
available or until timeout_seconds
has passed (in which case the
function fails with UDISKS_ERROR_TIMED_OUT
).
Note that wait_func
will be called from time to time - for example
if there is a device event.
daemon |
A UDisksDaemon. |
|
wait_func |
Function to check for desired object. |
|
user_data |
User data to pass to |
|
user_data_free_func |
Function to free |
[allow-none] |
timeout_seconds |
Maximum time to wait for the object (in seconds) or 0 to never wait. |
|
error |
Return location for error or |
[allow-none] |
GList *
udisks_daemon_get_objects (UDisksDaemon *daemon
);
Gets all D-Bus objects exported by daemon
.
A list of UDisksObject instances. The returned list should be freed with g_list_free()
after each element has been freed with g_object_unref()
.
[transfer full][element-type UDisksObject]
UDisksObject * udisks_daemon_find_object (UDisksDaemon *daemon
,const gchar *object_path
);
Finds an exported object with the object path given by object_path
.
UDisksObject * udisks_daemon_find_block (UDisksDaemon *daemon
,dev_t block_device_number
);
Finds a block device with the number given by block_device_number
.
UDisksObject * udisks_daemon_find_block_by_device_file (UDisksDaemon *daemon
,const gchar *device_file
);
Finds a block device with device file given by device_file
.
UDisksObject * udisks_daemon_find_block_by_sysfs_path (UDisksDaemon *daemon
,const gchar *sysfs_path
);
Finds a block device with a sysfs path given by sysfs_path
.
UDisksBaseJob * udisks_daemon_launch_simple_job (UDisksDaemon *daemon
,UDisksObject *object
,const gchar *job_operation
,uid_t job_started_by_uid
,GCancellable *cancellable
);
Launches a new simple job.
The returned object will be exported on the bus until the “completed” signal is emitted on the object. It is not valid to use the returned object after this signal fires.
daemon |
A UDisksDaemon. |
|
object |
A UDisksObject to add to the job or |
[allow-none] |
job_operation |
The operation for the job. |
|
job_started_by_uid |
The user who started the job. |
|
cancellable |
A GCancellable or |
UDisksBaseJob * udisks_daemon_launch_spawned_job (UDisksDaemon *daemon
,UDisksObject *object
,const gchar *job_operation
,uid_t job_started_by_uid
,GCancellable *cancellable
,uid_t run_as_uid
,uid_t run_as_euid
,const gchar *input_string
,const gchar *command_line_format
,...
);
Launches a new job for command_line_format
.
The job is not started automatically! Use udisks_spawned_job_start()
to start
the job after “spawned-job-completed” or
“completed” signals are connected (to get notified when the job is
done). This is to prevent a race condition with the spawned process
terminating before the signals are connected in which case the signal
handlers are never triggered.
The returned object will be exported on the bus until the “completed” signal is emitted on the object. It is not valid to use the returned object after this signal fires.
daemon |
A UDisksDaemon. |
|
object |
A UDisksObject to add to the job or |
[allow-none] |
job_operation |
The operation for the job. |
|
job_started_by_uid |
The user who started the job. |
|
cancellable |
A GCancellable or |
|
run_as_uid |
The uid_t to run the command as. |
|
run_as_euid |
The effective uid_t to run the command as. |
|
input_string |
A string to write to stdin of the spawned program or |
|
command_line_format |
printf()-style format for the command line to spawn. |
|
... |
Arguments for |
gboolean udisks_daemon_launch_spawned_job_sync (UDisksDaemon *daemon
,UDisksObject *object
,const gchar *job_operation
,uid_t job_started_by_uid
,GCancellable *cancellable
,uid_t run_as_uid
,uid_t run_as_euid
,gint *out_status
,gchar **out_message
,const gchar *input_string
,const gchar *command_line_format
,...
);
Like udisks_daemon_launch_spawned_job()
but blocks the calling
thread until the job completes.
daemon |
A UDisksDaemon. |
|
object |
A UDisksObject to add to the job or |
[allow-none] |
job_operation |
The operation for the job. |
|
job_started_by_uid |
The user who started the job. |
|
cancellable |
A GCancellable or |
|
run_as_uid |
The uid_t to run the command as. |
|
run_as_euid |
The effective uid_t to run the command as. |
|
input_string |
A string to write to stdin of the spawned program or |
|
out_status |
Return location for the |
|
out_message |
Return location for the |
|
command_line_format |
printf()-style format for the command line to spawn. |
|
... |
Arguments for |
UDisksBaseJob * udisks_daemon_launch_spawned_job_gstring (UDisksDaemon *daemon
,UDisksObject *object
,const gchar *job_operation
,uid_t job_started_by_uid
,GCancellable *cancellable
,uid_t run_as_uid
,uid_t run_as_euid
,GString *input_string
,const gchar *command_line_format
,...
);
Launches a new job for command_line_format
.
The job is not started automatically! Use udisks_spawned_job_start()
to start
the job after “spawned-job-completed” or
“completed” signals are connected (to get notified when the job is
done). This is to prevent a race condition with the spawned process
terminating before the signals are connected in which case the signal
handlers are never triggered.
The returned object will be exported on the bus until the “completed” signal is emitted on the object. It is not valid to use the returned object after this signal fires.
This function is the same as udisks_daemon_launch_spawned_job, with the only difference that it takes a GString and is therefore able to handle binary inputs that contain '\0' bytes.
daemon |
A UDisksDaemon. |
|
object |
A UDisksObject to add to the job or |
[allow-none] |
job_operation |
The operation for the job. |
|
job_started_by_uid |
The user who started the job. |
|
cancellable |
A GCancellable or |
|
run_as_uid |
The uid_t to run the command as. |
|
run_as_euid |
The effective uid_t to run the command as. |
|
input_string |
A string to write to stdin of the spawned program or |
|
command_line_format |
printf()-style format for the command line to spawn. |
|
... |
Arguments for |
gboolean udisks_daemon_launch_spawned_job_gstring_sync (UDisksDaemon *daemon
,UDisksObject *object
,const gchar *job_operation
,uid_t job_started_by_uid
,GCancellable *cancellable
,uid_t run_as_uid
,uid_t run_as_euid
,gint *out_status
,gchar **out_message
,GString *input_string
,const gchar *command_line_format
,...
);
Like udisks_daemon_launch_spawned_job()
but blocks the calling
thread until the job completes.
This function is the same as udisks_daemon_launch_spawned_job_sync, with the only difference that it takes a GString and is therefore able to handle binary inputs that contain '\0' bytes.
daemon |
A UDisksDaemon. |
|
object |
A UDisksObject to add to the job or |
[allow-none] |
job_operation |
The operation for the job. |
|
job_started_by_uid |
The user who started the job. |
|
cancellable |
A GCancellable or |
|
run_as_uid |
The uid_t to run the command as. |
|
run_as_euid |
The effective uid_t to run the command as. |
|
input_string |
A string to write to stdin of the spawned program or |
|
out_status |
Return location for the |
|
out_message |
Return location for the |
|
command_line_format |
printf()-style format for the command line to spawn. |
|
... |
Arguments for |
UDisksBaseJob * udisks_daemon_launch_threaded_job (UDisksDaemon *daemon
,UDisksObject *object
,const gchar *job_operation
,uid_t job_started_by_uid
,UDisksThreadedJobFunc job_func
,gpointer user_data
,GDestroyNotify user_data_free_func
,GCancellable *cancellable
);
Launches a new job by running job_func
in a new dedicated thread.
The job is not started automatically! Use udisks_threaded_job_start()
to
start the job after “threaded-job-completed” or
“completed” signals are connected (to get notified when the job is
done). This is to prevent a race condition with the job_func
finishing
before the signals are connected in which case the signal handlers are never
triggered.
Long-running jobs should periodically check cancellable
to see if
they have been cancelled.
The returned object will be exported on the bus until the “completed” signal is emitted on the object. It is not valid to use the returned object after this signal fires.
daemon |
A UDisksDaemon. |
|
object |
A UDisksObject to add to the job or |
[allow-none] |
job_operation |
The operation for the job. |
|
job_started_by_uid |
The user who started the job. |
|
job_func |
The function to run in another thread. |
|
user_data |
User data to pass to |
|
user_data_free_func |
Function to free |
|
cancellable |
A GCancellable or |
gboolean udisks_daemon_launch_threaded_job_sync (UDisksDaemon *daemon
,UDisksObject *object
,const gchar *job_operation
,uid_t job_started_by_uid
,UDisksThreadedJobFunc job_func
,gpointer user_data
,GDestroyNotify user_data_free_func
,GCancellable *cancellable
,GError **error
);
Like udisks_daemon_launch_threaded_job()
but blocks the calling
thread until the job completes.
daemon |
A UDisksDaemon. |
|
object |
A UDisksObject to add to the job or |
[allow-none] |
job_operation |
The operation for the job. |
|
job_started_by_uid |
The user who started the job. |
|
job_func |
The function to run in another thread. |
|
user_data |
User data to pass to |
|
user_data_free_func |
Function to free |
|
cancellable |
A GCancellable or |
|
error |
The GError set by the UDisksThreadedJobFunc. |
const gchar *
udisks_daemon_get_uuid (UDisksDaemon *daemon
);
Gets the UUID string specific to this daemon
instance.
typedef struct _UDisksDaemon UDisksDaemon;
The UDisksDaemon structure contains only private data and should only be accessed using the provided API.
“connection”
property “connection” GDBusConnection *
The GDBusConnection the daemon is for.
Owner: UDisksDaemon
Flags: Read / Write / Construct Only
“disable-modules”
property “disable-modules” gboolean
Whether modules should be disabled
Owner: UDisksDaemon
Flags: Read / Write / Construct Only
Default value: FALSE
“enable-tcrypt”
property “enable-tcrypt” gboolean
Whether devices should be tested for being TCRYPT encrypted.
Owner: UDisksDaemon
Flags: Read / Write / Construct Only
Default value: FALSE
“force-load-modules”
property “force-load-modules” gboolean
Whether modules should be activated upon startup
Owner: UDisksDaemon
Flags: Read / Write / Construct Only
Default value: FALSE
“mount-monitor”
property“mount-monitor” UDisksMountMonitor *
The UDisksMountMonitor used by the daemon
Owner: UDisksDaemon
Flags: Read
“object-manager”
property “object-manager” GDBusObjectManagerServer *
The GDBusObjectManager used by the daemon
Owner: UDisksDaemon
Flags: Read
“uninstalled”
property “uninstalled” gboolean
Loads modules from the build directory.
Owner: UDisksDaemon
Flags: Read / Write / Construct Only
Default value: FALSE