From f86ac6e170eae3f40548627cf5ba1264329d43d3 Mon Sep 17 00:00:00 2001 From: Kay Sievers Date: Mon, 22 Jun 2009 00:32:26 +0200 Subject: [PATCH] libudev: queue - add comments for queue format udev/udev.pc --- libudev/libudev-queue-private.c | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/libudev/libudev-queue-private.c b/libudev/libudev-queue-private.c index 9ae680c38..0427b65a0 100644 --- a/libudev/libudev-queue-private.c +++ b/libudev/libudev-queue-private.c @@ -19,19 +19,22 @@ * * When a new event is queued, its details are appended to the log. * When the event finishes, a second record is appended to the log - * with the same sequence number but a null devpath. + * with the same sequence number but a devpath len of 0. * * Example: - * {1, "/devices/virtual/mem/null" }, - * {2, "/devices/virtual/mem/zero" }, - * {1, "" }, - * Event 2 is still queued, but event 1 has been finished + * { 0x0000000000000001 } + * { 0x0000000000000001, 0x0019, "/devices/virtual/mem/null" }, + * { 0x0000000000000002, 0x001b, "/devices/virtual/mem/random" }, + * { 0x0000000000000001, 0x0000 }, + * { 0x0000000000000003, 0x0019, "/devices/virtual/mem/zero" }, * - * The queue does not grow indefinitely. It is periodically re-created - * to remove finished events. Atomic rename() makes this transparent to readers. + * Events 2 and 3 are still queued, but event 1 has finished. + * + * The queue does not grow indefinitely. It is periodically re-created + * to remove finished events. Atomic rename() makes this transparent to readers. * * The queue file starts with a single sequence number which specifies the - * minimum sequence number in the log that follows. Any events prior to this + * minimum sequence number in the log that follows. Any events prior to this * sequence number have already finished. */ @@ -349,7 +352,7 @@ static int update_queue(struct udev_queue_export *udev_queue_export, return -1; } - /* when the queue files grow too large, they must be garbage collected and rebuilt */ + /* when the queue file grows too large, garbage-collect and rebuild it */ bytes = ftell(udev_queue_export->queue_file) + queue_record_size(devpath_len); /* if we're removing the last event from the queue, that's the best time to rebuild it */ -- 2.30.2