putmsg.2 (2010 09)

putmsg(2) putmsg(2)

No partial message is sent.

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

maximum 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

maximum 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.