vna(7) —
NAME
vna − UnTerminal video network adapter
DESCRIPTION
The UnTerminal video network adapter (VNA) is composed of two separate pieces: the keyboard (see keyboard(7)) and the display. The keyboard interface is discussed separately in keyboard(7). The display is functionally equivalent to display(7) except for the differences described in this entry.
Ioctl Calls
The following ioctls can be used with the VNA adapter:
KDDISPTYPE
This ioctl returns the following structure, which is pointed to with the argument that is passed:
struct kd_disparam {
long type;/∗ display type ∗/
char *addr;/∗ display memory address ∗/
ushort ioaddr [ MKDIOADDR ]; /∗ valid I/O addresses ∗/
};
The type member indicates the type of display and will be one of the following:
| KD_HERCULES | 2 |
| KD_VGA | 5 |
The addr member indicates the physical address of the display. This address corresponds to switch settings on the board and typically ranges from 0xF00,000 to 0xFF0,000. The ioaddr member contains the global keyboard/display port list that is used for direct ins and outs to the UnTerminal remote station.
KDMAPDISP
This call allows one to have direct access to the display and I/O ports. It is especially useful in providing a way to do nonportable but fast graphics on the display. The following structure, defined in <sys/kd.h>, is pointed to by the argument to the ioctl:
struct kd_memloc {
char*vaddr;/∗ virtual address to map to∗/
char*physaddr; /∗ physical address to map from ∗/
longlength;/∗ size in bytes to map ∗/
longioflg;/∗ enable I/O addresses if non-zero ∗/
};
The vaddr argument is the linear address in the process where the display buffer will appear. This address must be on a page (4K byte) boundary. The physaddr argument is the physical address of the UnTerminal remote station. It should correspond to the addr value returned by the ioctl KDDISPTYPE. The length argument is the size of the display buffer that will be mapped in. It must be a multiple of 4K bytes. The ioflg argument tells whether (1) or not (0) to enable the global keyboard/display ports for direct access to the I/O ports similar to the KDENABIO and KDDISABIO ioctls.
The memory that had existed at address vaddr for length bytes will be irretrievably deleted, and the current contents of the display buffer will be placed at those locations. It is necessary for the virtual terminal to be in process (VT_PROCESS) mode and for the display device to be in KD_GRAPHICS mode. One way of allocating the virtual memory in the user’s address space that will be mapped to the screen is to call malloc requesting (length + 4096) bytes. Then using the address that malloc returns, round it up to the next page (4K byte) boundary and use the result as vaddr.
The ioctl will fail if the virtual terminal is not in process mode or if the display is not in KD_GRAPHICS mode [EACCES]. It will fail if any of the arguments are out of range or not properly aligned [EFAULT]. It will fail if the display is already mapped to [EIO].
FILES
/dev/vna*
SEE ALSO
stty(1), console(7), display(7), iolp(7), iona(7), keyboard(7), termio(7), vt(7).
ioctl(2) in the INTERACTIVE SDS Guide and Programmer’s Reference Manual.
ADDED VALUE
This entry, supplied by INTERACTIVE Systems Corporation, is an extension of UNIX System V.
\*U — Version 1.0