Retrieves a free character buffer.
#include <sys/types.h>
#include <sys/errno.h>
#include <cblock.hstruct cblock *getcf ( )The getcf kernel service retrieves a character buffer from the list of available ones and returns that buffer's address. The returned character buffer is pinned. If you use the getcf service to get a character buffer, be sure to free the space when you have finished using it. The buffers received from the getcf service should be freed by using the putcf kernel service.
Before starting the getcf service, the caller should request enough clist resources by using the pincf kernel service. The proper use of the getcf service ensures that there are sufficient pinned buffers available to the caller.
If the getcf service indicates that there is no available character buffer, the waitcfree service can be called to wait until a character buffer becomes available.
The getcf service has no parameters.
The getcf kernel service can be called from either the process or interrupt environment.
Upon successful completion, the getcf service returns the address of the allocated character buffer.
A null pointer indicates no buffers are available.