uistat(1)

NAME

uistat − display and control user-level interrupt vectors and processes

SYNOPSIS

uistat [ -d vector ] [-f vector]

DESCRIPTION

Without options, uistat prints information about all interrupt vectors currently allocated, defined, or connected via the iconnect(2) and ienable(2) system services. For each interrupt connection in the system, the vector number, process ID, and status is displayed to stdout. For user-level interrupt routines, the status will be either iconnected or ienabled. In addition to iconnected or ienabled, the status of ivec may also appear for interrupt vectors that were allocated through a previous iconnect(2) system service call with the ICON_IVEC option. For interrupt vectors that have been allocated, but not defined for a user-level interrupt routine, the status will be only ivec. In this case, no process ID will be displayed.

The -d option may be used to disconnect a process from the interrupt, where the vector parameter specifies the interrupt vector number to be disconnected. The specified interrupt connection definition will be removed, and if the connected process is in the ienabled state, that process will be disconnected from the interrupt. As a result, the disconnected process will return from the ienable(2) system service call. To use this option, the user must be super-user or must have the ACC_USERINT access bit set, if access vectors are enabled. See the ienable(2) man page for more details.

The -f option may be used to deallocate an interrupt vector that was allocated by a ICON_IVEC iconnect () system service call and is currently in an ivec only state. In order for the -f option to succeed, the vector must not currently also be in a ienabled or iconnected state. To use this option, the user must be super-user or must have the ACC_USERINT access bit set, if access vectors are enabled.

DIAGNOSTICS

If /bin/uistat encounters an error, it will output a message indicating the reason for the failure.

FILES

/unixsystem namelist
/dev/kmemmemory

Museum