sysWrite(2K)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES

NAME

sysRead, sysWrite, sysPoll- Read characters from the system console; Write characters to the system console; Poll characters from the system console

SYNOPSIS

#include <exec/chIo.h>

int sysRead(void * buf, unsigned int nchar);
int sysWrite(void * buf, unsigned int nchar);
int sysPoll(void * buf);

DESCRIPTION

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 will be 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 will be echoed on the system console. The sysPoll system call is non-blocking.

RETURN VALUE

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.

ERRORS

[K_EFAULT]

Some of the arguments provided are outside the caller's address space.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

ChorusOS 4.0  Last Revised December 1999

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES