0000815: sigwaitinfo() equivalence to sigwait() needs additional exception

Austin Group Defect Tracker

Aardvark Mark IV

Viewing Issue Simple Details [ Jump to Notes ]

[ Issue History ] [ Print ]

Category

Severity

Type

Date Submitted

Last Update

0000815

[1003.1(2013)/Issue7+TC1] System Interfaces

Editorial

Error

2014-01-14 12:22

2019-06-10 08:54

Reporter

geoffclare

View Status

public

Assigned To

Priority

normal

Resolution

Accepted

Status

Closed

Name

Geoff Clare

Organization

The Open Group

User Reference

Section

sigtimedwait

Page Number

1966

Line Number

63001

Interp Status

---

Final Accepted Text

Summary

0000815: sigwaitinfo() equivalence to sigwait() needs additional exception

Description

The sigtimedwait() page says:

    The sigwaitinfo() function shall be equivalent to the sigwait()
    function if the info argument is NULL. If the info argument is
    non-NULL, the sigwaitinfo() function shall be equivalent to
    sigwait(), except that the selected signal number shall be stored
    in the si_signo member, and the cause of the signal shall be
    stored in the si_code member.

These equivalence statements do not take into account the difference
in return value and error reporting method between sigwaitinfo() and
sigwait(): sigwaitinfo() returns a signal number on success and -1
on failure with errno set; sigwait() returns 0 on success and an
error number on failure.

(This difference also applies to sigtimedwait(), but that will
automatically be corrected by fixing the description of sigwaitinfo(),
via the equivalence statement in the first paragraph.)

Desired Action

Change:

The sigwaitinfo() function shall be equivalent to the sigwait() function if the info argument is NULL. If the info argument is non-NULL, the sigwaitinfo() function shall be equivalent to sigwait(), except that the selected signal number ...

to:

The sigwaitinfo() function shall be equivalent to the sigwait() function, except that the return value and the error reporting method are different (see RETURN VALUE), and that if the info argument is non-NULL, the selected signal number ...

Tags

tc2-2008

Attached Files

Relationships

There are no notes attached to this issue.

Issue History
Date Modified	Username	Field	Change
2014-01-14 12:22	geoffclare	New Issue
2014-01-14 12:22	geoffclare	Name	=> Geoff Clare
2014-01-14 12:22	geoffclare	Organization	=> The Open Group
2014-01-14 12:22	geoffclare	Section	=> sigtimedwait
2014-01-14 12:22	geoffclare	Page Number	=> 1966
2014-01-14 12:22	geoffclare	Line Number	=> 63001
2014-01-14 12:22	geoffclare	Interp Status	=> ---
2014-01-15 10:37	geoffclare	Desired Action Updated
2014-03-13 15:55	Don Cragun	Status	New => Resolved
2014-03-13 15:55	Don Cragun	Resolution	Open => Accepted
2014-03-13 15:57	nick	Tag Attached: tc2-2008
2019-06-10 08:54	agadmin	Status	Resolved => Closed

Mantis 1.1.6[^]