Corrected log_severity_before as part of reviewing the code.

This commit is contained in:
Joel Sherrill
1998-08-27 18:28:17 +00:00
parent 9c79229d33
commit c5568160cb

View File

@@ -508,6 +508,12 @@ int log_severity_before(
@subheading STATUS CODES: @subheading STATUS CODES:
@table @b @table @b
@item 0
The severity of @code{s1} is less than that of @code{s2}.
@item 1
The severity of @code{s1} is greater than or equal that of @code{s2}.
@item EINVAL @item EINVAL
The value of either s1 or s2 exceeds @code{LOG_SEVERITY_MAX}. The value of either s1 or s2 exceeds @code{LOG_SEVERITY_MAX}.
@@ -515,20 +521,23 @@ The value of either s1 or s2 exceeds @code{LOG_SEVERITY_MAX}.
@subheading DESCRIPTION: @subheading DESCRIPTION:
The @code{log_severity_before} function shall compare the severity order The @code{log_severity_before} function compares the severity order
of the @code{s1} and @code{s2} arguments. Severity values ordered of the @code{s1} and @code{s2} arguments. If @code{s1} is of
according to this function shall be according to decreasing severity. severity greater than or equal to that of @code{s2}, then this
function returns 1. Otherwise, it returns 0.
If @code{s1} is ordered before or is equal to @code{s2} then the ordering If either @code{s1} or @code{s2} specify invalid severity values, the
predicate shall return 1, otherwise the predicate shall return 0. If return value of @code{log_severity_before} is unspecified.
either @code{s1} or @code{s2} specify invalid severity values, the return
value of @code{log_severity_before} is unspecified.
@subheading NOTES: @subheading NOTES:
The @code{_POSIX_LOGGING} feature flag is defined to indicate The @code{_POSIX_LOGGING} feature flag is defined to indicate
this service is available. this service is available.
The POSIX specification of the return value for this function is ambiguous.
If @code{EINVAL} is equal to 1 in an implementation, then the application
can not distinguish between greater than and an error condition.
@page @page
@subsection log_facilityemptyset - Manipulate log facility sets @subsection log_facilityemptyset - Manipulate log facility sets