Bug 204449 - UUID(3) man page page lacks return value information
Summary: UUID(3) man page page lacks return value information
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-11-10 20:10 UTC by Michael Cress
Modified: 2018-04-10 18:55 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Michael Cress 2015-11-10 20:10:50 UTC
"man 3 uuid" lists many functions relating to UUIDs. Most of these functions have a void return type in the function signature, with the result of the call being passed to a uint32_t *status found in the function parameters. The meaning of these status values are documented in the Return Values sections.

For those functions whose signatures return an int32_t or uint16_t, no information is listed regarding their meaning. The specific functions that require return value documentation are:

1.) int32_t uuid_compare(const	uuid_t *uuid1, const uuid_t *uuid2, uint32_t *status);

2.) int32_t uuid_equal(const uuid_t *uuid1, const uuid_t *uuid2, uint32_t *status);

3.) uint16_t uuid_hash(const uuid_t *uuid, uint32_t *status);

4.) int32_t uuid_is_nil(const uuid_t *uuid, uint32_t *status);

This information can also be viewed online at https://www.freebsd.org/cgi/man.cgi?query=uuid