NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES
#include <exec/chIo.h>int sysRead(void * buf, unsigned int nchar);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
The sysRead() system call reads characters from the system console into the buffer pointed to by buf , until either nchar -1 characters are read, or a newline character is read and not transferred to buf . The characters are echoed on the system console and the string is terminated with a NULL character. If nchar is equal to 1, one character is read, without echo.
The sysWrite() system call attempts to write nchar characters to the system console from the buffer pointed to by buf .
The sysPoll() system call attempts to read one character from the system console into the buffer pointed to by buf . The character is echoed on the system console. The sysPoll() system call is non-blocking.
If successful, sysRead() and sysPoll() return the number of characters actually read, and sysWrite() returns the number of characters actually written. Otherwise, a negative error code is returned.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES