SCO OpenServer

getc(D3oddi)

getc, getcb, getcbp, getcf -- read clist buffers

Synopsis

int getc(struct clist cp);

struct cblock getcb(struct clist cp);

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

struct cblock getcf(void);

The getc( ) function removes and returns one character from a clist buffer.

The getcb( ) function removes and returns one cblock from the clist buffer.

The getcbp( ) function removes the specified number of characters from a clist and transfers them to a character buffer.

The getcf( ) function takes a cblock from the freelist and returns a pointer to it.

getc returns the next character in the buffer or -1 if the buffer is empty.

getcb returns a pointer to the first cblock of the clist or NULL if the clist is empty.

getcbp returns the number of characters actually moved (which is less than or equal to n).

getcf returns a pointer to a cblock if available. Otherwise, it returns NULL.

These routines can be used only within character device drivers.

These routines protect their internal critical sections of code using spltty(D3oddi).

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

All

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

DDI drivers are implemented as STREAMS devices and do not use clists so there is no comparable function for DDI drivers.