p71924506
/
linux_old1
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Documentation: add UUID/GUID to kernel-api 

Update kernel-doc notation in lib/uuid.c and then add UUID/GUID
function interfaces to kernel-api.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
[jc: tweaked the uuid_is_valid() kerneldoc]
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Randy Dunlap 2017-11-29 12:32:42 -08:00 committed by Jonathan Corbet
parent 3abaa5ccd9
commit d063623b6a
2 changed files with 23 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Documentation/core-api/kernel-api.rst
View File

@ -148,6 +148,12 @@ Sorting
.. kernel-doc:: lib/list_sort.c .. kernel-doc:: lib/list_sort.c
:export: :export:
UUID/GUID
---------
.. kernel-doc:: lib/uuid.c
:export:
Memory Management in Linux Memory Management in Linux
========================== ==========================

34
lib/uuid.c
View File

@ -29,15 +29,14 @@ EXPORT_SYMBOL(uuid_null);
const u8 guid_index[16] = {3,2,1,0,5,4,7,6,8,9,10,11,12,13,14,15}; const u8 guid_index[16] = {3,2,1,0,5,4,7,6,8,9,10,11,12,13,14,15};
const u8 uuid_index[16] = {0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15}; const u8 uuid_index[16] = {0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15};
/*************************************************************** /**
* generate_random_uuid - generate a random UUID
* @uuid: where to put the generated UUID
*
* Random UUID interface * Random UUID interface
* *
* Used here for a Boot ID, but can be useful for other kernel * Used to create a Boot ID or a filesystem UUID/GUID, but can be
* drivers. * useful for other kernel drivers.
***************************************************************/
/*
* Generate random UUID
*/ */
void generate_random_uuid(unsigned char uuid[16]) void generate_random_uuid(unsigned char uuid[16])
{ {
@ -73,16 +72,17 @@ void uuid_gen(uuid_t *bu)
EXPORT_SYMBOL_GPL(uuid_gen); EXPORT_SYMBOL_GPL(uuid_gen);
/** /**
* uuid_is_valid - checks if UUID string valid * uuid_is_valid - checks if a UUID string is valid
* @uuid: UUID string to check * @uuid: UUID string to check
* *
* Description: * Description:
* It checks if the UUID string is following the format: * It checks if the UUID string is following the format:
* xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx * xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
* where x is a hex digit. *
* * where x is a hex digit.
* Return: true if input is valid UUID string. *
*/ * Return: true if input is valid UUID string.
*/
bool uuid_is_valid(const char *uuid) bool uuid_is_valid(const char *uuid)
{ {
unsigned int i; unsigned int i;