SYSNEWS(2) — NEWS-OS Programmer’s Manual

NAME

sysnews − control system

SYNOPSIS

#include <machine/sysnews.h>

sysnews(ctrltype, arg1, arg2, arg3, arg4)
int ctrltype, arg1, arg2, arg3, arg4;

DESCRIPTION

The sysnews is an interface to control the NEWS hardware and NEWS-OS specific features. This system call is used for cache control and address error recovery. Ths sysnews system call uses the values defined in the header <machine/sysnews.h>. The user can specify the control type in ctrltype, and its necessary supplementary arguments in arg1, ..., arg4. The followings can be used as ctrltype.

NEWS_CACHECTRL
Declare whether to use cache in the specified area (in the unit of a page) or not. The format is as follows: sysnews(NEWS_CACHECTRL, addr, count, cacheable)

NEWS_CACHEFLUSH
Flush the instruction cache or data cache in the specified area. The format is as follows: sysnews(NEWS_CACHEFLUSH, addr, count, whichcache)

NEWS_FIXADE
Request the kernel to recover when an address error occures. The format is as follows: sysnews(NEWS_FIXADE, flag)

NEWS_MACHID
Expanded interface of gethostid(2). The format is as follows: #include <machine/machid.h>
sysnews(NEWS_MACHID, machid_buf)
struct machid∗machid_buf;

RETRUN VALUE

When an error has occured, the value −1 is returned and errono is set to indicate an error.

ERROR

If one of the followings is true, systnews will fail.

[EFAULT] Cannot access the address passed in an argument.

[EINVAL] Invalid ctrltype or an argument.

Museum