util - add automated ID generation utility

Multiple sub-systems in QEMU may find it useful to generate IDs
for objects that a user may reference via QMP or HMP.  This patch
presents a standardized way to do it, so that automatic ID generation
follows the same rules.

This patch enforces the following rules when generating an ID:

1.) Guarantee no collisions with a user-specified ID
2.) Identify the sub-system the ID belongs to
3.) Guarantee of uniqueness
4.) Spoiling predictability, to avoid creating an assumption
    of object ordering and parsing (i.e., we don't want users to think
    they can guess the next ID based on prior behavior).

The scheme for this is as follows (no spaces):

                # subsys D RR
Reserved char --|    |   | |
Subsystem String ----|   | |
Unique number (64-bit) --| |
Two-digit random number ---|

For example, a generated node-name for the block sub-system may look
like this:

    #block076

The caller of id_generate() is responsible for freeing the generated
node name string with g_free().

Reviewed-by: John Snow <jsnow@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Alberto Garcia <berto@igalia.com>
Signed-off-by: Jeff Cody <jcody@redhat.com>
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
This commit is contained in:
Jeff Cody 2015-10-12 19:36:49 -04:00 committed by Kevin Wolf
parent 7e39d3a2dd
commit a0f1913637
2 changed files with 45 additions and 0 deletions

View file

@ -246,6 +246,14 @@ int64_t qemu_strtosz_suffix_unit(const char *nptr, char **end,
#define STR_OR_NULL(str) ((str) ? (str) : "null")
/* id.c */
typedef enum IdSubSystems {
ID_QDEV,
ID_BLOCK,
ID_MAX /* last element, used as array size */
} IdSubSystems;
char *id_generate(IdSubSystems id);
bool id_wellformed(const char *id);
/* path.c */

View file

@ -26,3 +26,40 @@ bool id_wellformed(const char *id)
}
return true;
}
#define ID_SPECIAL_CHAR '#'
static const char *const id_subsys_str[] = {
[ID_QDEV] = "qdev",
[ID_BLOCK] = "block",
};
/*
* Generates an ID of the form PREFIX SUBSYSTEM NUMBER
* where:
*
* - PREFIX is the reserved character '#'
* - SUBSYSTEM identifies the subsystem creating the ID
* - NUMBER is a decimal number unique within SUBSYSTEM.
*
* Example: "#block146"
*
* Note that these IDs do not satisfy id_wellformed().
*
* The caller is responsible for freeing the returned string with g_free()
*/
char *id_generate(IdSubSystems id)
{
static uint64_t id_counters[ID_MAX];
uint32_t rnd;
assert(id < ID_MAX);
assert(id_subsys_str[id]);
rnd = g_random_int_range(0, 100);
return g_strdup_printf("%c%s%" PRIu64 "%02" PRId32, ID_SPECIAL_CHAR,
id_subsys_str[id],
id_counters[id]++,
rnd);
}