HP-UX Reference (11i v3 07/02) - 2 System Calls (vol 5)

putmsg(2) putmsg(2)

RETURN VALUE

putmsg() and putpmsg() return the following values:

0 Successful completion.

-1 Error. errno is set to indicate the error.

ERRORS

On failure, errno may be set to one of the following values:

[EAGAIN] A non-priority message was speciﬁed, the

O_NONBLOCK ﬂag is set, and the stream write

queue is full due to internal ﬂow control conditions, or buffers could not be allocated for the

message that was to be created.

[EBADF] ﬁldes is not a valid ﬁle descriptor open for writing.

[EINTR] A signal was caught during

putmsg()

or putpmsg().

[EINVAL] An undeﬁned value is speciﬁed in ﬂags,orﬂags is set to

RS_HIPRI or MSG_HIPRI and

no control part is supplied, or the stream or multiplexor referenced by ﬁldes is linked

(directly or indirectly) downstream from a multiplexor, or ﬂags is set to

MSG_HIPRI and

band is non-zero (for putpmsg() only).

[EIO] See [EPIPE].

[ENOSTR] A stream is not associated with ﬁldes.

[ENXIO] A hangup condition was generated downstream for the speciﬁed stream.

[EPIPE] The ﬁldes argument refers to a STREAMS-based pipe and the other end of the pipe is

closed. A

SIGPIPE signal is generated for the calling process.

[ERANGE] The size of the data part of the message does not fall within the range speciﬁed by the max-

imum and minimum packet sizes of the topmost STREAMS module. This value is also

returned if the control part of the message is larger than the maximum conﬁgured size of

the control part of a message, or if the data part of the message is larger than the max-

imum conﬁgured size of the data part of a message.

In addition, putmsg() and putpmsg() will fail if the stream head had processed an asynchronous error

before the call. In this case, the value of errno does not reﬂect the result of

putmsg() or putpmsg()

but reﬂects the prior error.