putpmsg System Call

Purpose

Sends a priority message on a stream.

Syntax

#include <stropts.h>

int putpmsg (fd, ctlptr,
dataptr, band, flags)
int  fd;
struct strbuf * ctlptr;
struct strbuf * dataptr;
int  band;
int  flags;

Description

The putpmsg system call is identical to the putmsg system call except that it sends a priority message. All information except for flag settings are found in the description for the putmsg system call. The differences in the flag settings are noted in the error codes section.

This system call is part of STREAMS Kernel Extensions.

Parameters

Item Description
fd Specifies a file descriptor referencing an open stream.
ctlptr Holds the control part of the message.
dataptr Holds the data part of the message.
band Indicates the priority band.
flags Indicates the priority type of message to be sent. Acceptable values are:
MSG_BAND
Sends a non-priority message.
MSG_HIPRI
Sends a priority message.

Error Codes

The putpmsg system call is unsuccessful under the following conditions: