IP_QueueWrite

Cogent API and Utilities: Version 4.1
Prev |  | Next

# `IP_QueueWrite`

`IP_QueueWrite` -- writes a message to a queue.

## Syntax

``int IP_QueueWrite`(int qid, void* msg, int length, int priority);`

## Arguments

`qid`

  A queue ID.

`msg`

  The message buffer to be sent to the queue.

`length`

  The length in bytes of `msg`.

`priority`

  The priority of this message.

## Returns

`0` on success, or `-1` on failure and `errno` is set.

## Description

This function writes a message to the queue specified by `qid`. Higher `priority` numbers are treated as having a higher priority. Priority ordering is not currently implemented. A single write to the queue is limited by the operating system. Queue messages transmitted in a single write will never be broken apart or concatenated with other messages.

## See Also

Cascade QueueServer Functions, `IP_QueueRead`

Prev | Home | Next
`IP_QueueWait` | Up | `IP_Receive`

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.