SCO OpenServer

putc(D3oddi)

putc, putcb, putcbp, putcf -- write to clists

Synopsis

int putc(int c, struct clist cp);

int putcb(struct cblock cbp, struct clist cp);

int putcbp(struct clist cp, char buf, int n);

void putcf(struct cblock cbp);

Description

The putc( ) function adds one character to the clist buffer.

The putcb( ) function adds the cblock to the clist buffer.

The putcbp( ) function appends the specified number of characters from the character buffer to the clist. If the current cblock does not have room for these characters, putcbp gets new cblocks from the free list as needed.

The putcf( ) function frees the specified cblock.

Arguments

c: Character to be added to the clist buffer.
cp: Pointer to the clist buffer.
cbp: Pointer to the cblock.
buf: Character buffer from which to read characters.
n: Number of characters to read.

Return values

putc returns 0 if it places the specified character in the buffer, or it returns -1 if there is no free space.

putcb always returns 0.

putcbp returns the number of characters put in the clist. If no clists are available, getcbp issues a CONFIG: error message using cmn_err(D3oddi) and returns the number of characters actually stored.

putcf has no return value.

Usage

These functions can be used only with character device drivers. They protect their internal critical sections of code using spltty(D3oddi).

Context and synchronization

Non-blockable, interrupt, user, or blockable context.

Hardware applicability

All

Version applicability

oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6, 6mp

SVR5 DDI compatibility

This function is not supported for DDI drivers, where serial drivers are implemented as STREAMS devices and do not use clists and cblocks.

References

cmn_err(D3oddi), getc(D3oddi), spltty(D3oddi)