udev_queue

udev_queue — access to currently active events

Synopsis

struct              udev_queue;
struct udev_queue * udev_queue_ref                      (struct udev_queue *udev_queue);
void                udev_queue_unref                    (struct udev_queue *udev_queue);
struct udev *       udev_queue_get_udev                 (struct udev_queue *udev_queue);
struct udev_queue * udev_queue_new                      (struct udev *udev);
int                 udev_queue_get_udev_is_active       (struct udev_queue *udev_queue);
int                 udev_queue_get_queue_is_empty       (struct udev_queue *udev_queue);
int                 udev_queue_get_seqnum_is_finished   (struct udev_queue *udev_queue,
                                                         long int seqnum);
int                 udev_queue_get_seqnum_sequence_is_finished
                                                        (struct udev_queue *udev_queue,
                                                         long int start,
                                                         long int end);
struct udev_list_entry * udev_queue_get_queued_list_entry
                                                        (struct udev_queue *udev_queue);
struct udev_list_entry * udev_queue_get_failed_list_entry
                                                        (struct udev_queue *udev_queue);
unsigned long long int  udev_queue_get_kernel_seqnum    (struct udev_queue *udev_queue);
unsigned long long int  udev_queue_get_udev_seqnum      (struct udev_queue *udev_queue);

Description

The udev daemon processes event asynchronously. All events which do not have interdependencies are run in parallel. This exports the current state of the event processing queue, and the currently event sequence numbers from the kernel and the udev daemon.

Details

struct udev_queue

struct udev_queue;

Opaque object representing the current event queue in the udev daemon.


udev_queue_ref ()

struct udev_queue * udev_queue_ref                      (struct udev_queue *udev_queue);

Take a reference of a udev queue context.

udev_queue :

udev queue context

Returns :

the same udev queue context.

udev_queue_unref ()

void                udev_queue_unref                    (struct udev_queue *udev_queue);

Drop a reference of a udev queue context. If the refcount reaches zero, the resources of the queue context will be released.

udev_queue :

udev queue context

udev_queue_get_udev ()

struct udev *       udev_queue_get_udev                 (struct udev_queue *udev_queue);

Retrieve the udev library context the queue context was created with.

udev_queue :

udev queue context

Returns :

the udev library context.

udev_queue_new ()

struct udev_queue * udev_queue_new                      (struct udev *udev);

The initial refcount is 1, and needs to be decremented to release the resources of the udev queue context.

udev :

udev library context

Returns :

the udev queue context, or NULL on error.

udev_queue_get_udev_is_active ()

int                 udev_queue_get_udev_is_active       (struct udev_queue *udev_queue);

udev_queue :

udev queue context

Returns :

a flag indicating if udev is active.

udev_queue_get_queue_is_empty ()

int                 udev_queue_get_queue_is_empty       (struct udev_queue *udev_queue);

udev_queue :

udev queue context

Returns :

a flag indicating if udev is currently handling events.

udev_queue_get_seqnum_is_finished ()

int                 udev_queue_get_seqnum_is_finished   (struct udev_queue *udev_queue,
                                                         long int seqnum);

udev_queue :

udev queue context

seqnum :

sequence number

Returns :

a flag indicating if the given sequence number is handled.

udev_queue_get_seqnum_sequence_is_finished ()

int                 udev_queue_get_seqnum_sequence_is_finished
                                                        (struct udev_queue *udev_queue,
                                                         long int start,
                                                         long int end);

udev_queue :

udev queue context

start :

first event sequence number

end :

last event sequence number

Returns :

if any of the sequence numbers in the given range is currently active.

udev_queue_get_queued_list_entry ()

struct udev_list_entry * udev_queue_get_queued_list_entry
                                                        (struct udev_queue *udev_queue);

udev_queue :

udev queue context

Returns :

the first entry of the list of queued events.

udev_queue_get_failed_list_entry ()

struct udev_list_entry * udev_queue_get_failed_list_entry
                                                        (struct udev_queue *udev_queue);

udev_queue :

udev queue context

Returns :

the first entry of the list of recorded failed events.

udev_queue_get_kernel_seqnum ()

unsigned long long int  udev_queue_get_kernel_seqnum    (struct udev_queue *udev_queue);

Returns :

the current kernel event sequence number.

udev_queue_get_udev_seqnum ()

unsigned long long int  udev_queue_get_udev_seqnum      (struct udev_queue *udev_queue);

Returns :

the last known udev event sequence number.