HP-UX Reference (11i v2 07/12) - 7 Device (Special) Files, 9 General Information, Index (vol 10)

f
framebuf(7) framebuf(7)
The skipcount parameter allows the user to refresh a portion of a window image
that the user has stored in memory for those cases where only a portion of the image
needs to be refreshed. The window image is then a superset of the rectangle being
updated, and might thus have different dimensions. The
skipcount specifies the
portion of the row in the larger window image that is excluded from the rectangle.
Thus,
linelength plus skipcount would be the number of bytes in each row of
the larger window image array.
If a particular framebuffer device supports this system call, the CRT_DMA_OUTPUT
flag in the crt_attributes
field of the crt_frame_buffer_t
structure is
set. Some framebuffer devices supporting DMA might restrict alignment of the vari-
ous parameters, and are specified in the DEPENDENCIES section below. The kernel
ensures that these restrictions are obeyed, and if they are not the system call will fail
and set
errno to [EINVAL].
It is the responsibility of the application to guarantee that the system’s physical
memory is up-to-date by flushing the processor’s data cache. One should use the
GCDMA_DATAFLUSH
ioctl to ensure that the data is consistent before initiating a
DMA transfer.
GCDMA_DATAFLUSH
Flush the specified data from the processor’s data cache to the system’s main memory.
This system call is intended to be used before DMA to ensure that an up-to-date ver-
sion of the data is transferred to the framebuffer or to control space.
The parameters for the flush are passed in a
crt_flush_t data structure, which
includes the following fields:
char *flush_addr; /* Starting address of data
to be flushed */
int flush_len; /* Number of bytes to flush */
The kernel ensures that the flush_len bytes starting at flush_addr are con-
sistent in main memory with respect to the cache.
GCSLOT Provide pertinent information about the calling process’s participation in the system-
wide graphics locking mechanism (see the discussion under GCLOCK above). The
GCSLOT request does not carry out any actual locking functionality. The lock infor-
mation is returned to the calling process in a crt_gcslot_t data structure. The
parameter is defined as crt_gcslot_t *arg;. The crt_gcslot_t data struc-
ture is defined in the file <sys/framebuf.h>
.
GCSTATIC_MAP Prevent the Internal Terminal Emulator (ITE) from modifying the device’s color map.
GCVARIABLE_MAP
Allow the Internal Terminal Emulator (ITE) to modify the device’s color map.
DEPENDENCIES
Series 700/800
When requesting GCMAP, the parameter arg is ignored and should be set to 0.
All supported ITEs ignore the frame buffer lock for output.
Series 700
Among the device identification constants that can be returned both by the
GCID call and in the
crt_id field of the crt_frame_buffer_t data structure by the GCDESCRIBE call are:
S9000_ID_98705
S9000_ID_98736
S9000_ID_A1659A
S9000_ID_A1439A
If a memory-mapped graphics co-processor is available, it is mapped in with other graphics regions as
the result of a GCMAP call, and its address is recorded as the last entry in the crt region array
returned by the GCDESCRIBE call.
Series 800
The following device identification constants are returned both by the GCID call and in the crt_id
HP-UX 11i Version 2: December 2007 Update − 4 − Hewlett-Packard Company 51