Index for Section 9

Alphabetical listing for C

Bottom of page

CURSOR_ON_OFF(9r)
NAME
  CURSOR_ON_OFF - Graphics: Turns the cursor associated with a specific
  screen on or off

SYNOPSIS
  #include sys/ioctl.h
  #include sys/workstation.h

  ioctl(
	  int gfx_fd,
	  unsigned long CURSOR_ON_OFF,
	  void *ws_driver_structure_pointer );

ARGUMENTS
  gfx_fd
      Specifies the file descriptor of the graphics device-special file (by
      convention /dev/ws0) that the open system call returns when the server
      is initialized. The server uses this file descriptor in subsequent
      ioctl calls to the Workstation Subsystem.

  CURSOR_ON_OFF
      Specifies the ioctl command used to access the ws_cursor_control
      structure in /usr/sys/include/sys/workstation.h.

  ws_driver_structure_pointer
      Specifies a pointer to the ws_cursor_control structure defined in
      /usr/sys/include/sys/workstation.h.

DESCRIPTION
  The CURSOR_ON_OFF ioctl command turns the cursor on or off for the screen
  that is described in the ws_cursor_control structure.	 The
  ws_cursor_control structure is defined in
  /usr/sys/include/sys/workstation.h and pointed to by the
  *ws_driver_structure_pointer argument.

RESTRICTIONS
  The graphics subsystem supports only one workstation per machine.

RETURN VALUES
  If successful, the CURSOR_ON_OFF ioctl command returns 0 (zero). If
  unsuccessful, it returns -1.







EXAMPLE
  The following example shows how the generic VGA DDX issues the
  CURSOR_ON_OFF ioctl command from the genInitVGA routine:

       void genInitVGA(int index)
       {
	   ws_cursor_control cc;

       .
       .
       .

	  /*
	   *  Turn off the cursor
	   */

	   cc.screen = index;
	   cc.control = CURSOR_OFF;

	   if (ioctl(wsFd, CURSOR_ON_OFF, &cc) == -1) {
	       ErrorF( "error enabling/disabling cursor\n");
	       exit(1);
	   }

FILES
  /usr/sys/include/sys/ioctl.h

  /usr/sys/include/sys/workstation.h

SEE ALSO
  ioctl Commands: GET_DEPTH_INFO(9r), MAP_SCREEN_AT_DEPTH(9r),
  VIDEO_ON_OFF(9r)

Index for Section 9

Alphabetical listing for C

Top of page