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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

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

speciﬁes 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

ﬂag in the crt_attributes

ﬁeld of the crt_frame_buffer_t

structure is

set. Some framebuffer devices supporting

DMA

might restrict alignment of the

various parameters, and are speciﬁed 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 ﬂushing 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 speciﬁed 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 version of the data is transferred to the framebuffer or to control space.

The parameters for the ﬂush are passed in a

crt_flush_t data structure, which

includes the following ﬁelds:

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

information is returned to the calling process in a crt_gcslot_t data structure.

The parameter is deﬁned as crt_gcslot_t *arg;. The crt_gcslot_t data

structure is deﬁned in the ﬁle <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 identiﬁcation constants that can be returned both by the

GCID call and in the

crt_id ﬁeld 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 identiﬁcation constants are returned both by the

GCID call and in the crt_id

ﬁeld of the crt_frame_buffer_t data structure by the GCDESCRIBE call:

HP-UX 11i Version 2: September 2004 − 4 − Hewlett-Packard Company Section 7−−35