test

SunVideo Plus for PCI User's Guide

Running SVC Mode Scripts

After installing the SunVideo Plus card and software, do the following to run SunVideo Compatibility (SVC) mode setup scripts:

  1. Log in as superuser.

  2. Run the following scripts: 

    hostname# svc_install
hostname# svc_devices (install or remove)

    The following table describes the setup scripts.

    Table 3-1 SunVideo Plus Setup Scripts

    Setup Script 

    Description 

    svc_install

    This script creates the SunVideo Compatibility mode XIL pipeline hierarchy for the SunVideo Plus card. 

    svc_devices

    This script creates (svc_devices install) or removes (svc_devices remove) SunVideo Compatibility mode pseudo devices. Pseudo devices are symbolic links from rtvc (SunVideo) devices to o1k (SunVideo Plus) devices. The script places the links into /dev.

    svc_uninstall

    Solaris 2.6 only. Use this script on Solaris 2.6 to remove the svc hierarchy. 

The svc_install Script for Solaris 2.5.1

The svc_install script creates the XIL pipeline hierarchy. The default location for the svc_install script is /opt/SUNWo1kp/bin. The syntax is: 

hostname% svc_install options

The following table lists and describes the svc_install options and defaults.

Table 3-2 svc_install Options and Defaults

svc_install Options

Description 

-s O1KHOME

This is the location of the SunVideo Plus source directory. The default location is /opt/SUNWo1kp.

-t DESTDIR

This is the destination for the SunVideo Compatibility mode pipeline hierarchy. The default location is /opt/SUNWo1kp/svc. DESTDIR does not need to exist. The hierarchy requires approximately 360 Kbytes.

-v

This is Verbose mode which displays status information on stdout. The default does not display information.

-x XILHOME

This is the location of the XIL Imaging Library source directory. The default location is /opt/SUNWits/Graphics-sw/xil.

Typically, you can run the script without any options. You must be logged in as superuser if you do not have write permissions to the DESTDIR directory.

If the svc mode is already installed when svc_install is run, then the previous SVC hierarchy will be removed and then replaced.

You should re-run svc_install any time packages, patches, and so on, are applied to your system that change XIL components.

The svc_install Script for Solaris 2.6

In Solaris 2.5.1, the SVC hierarchy is a separate entity that is enabled/disabled by the user by setting environment variables. In Solaris 2.6, however, the SVC hierarchy is not a separate entity. Installing the SVC mode in Solaris 2.6 replaces the existing XIL 1.3 directory containing device handlers (XIL 1.3 libraries) with a SVC mode one. Therefore, once the svc_install script is run on Solaris 2.6, SVC mode is enabled and is not controlled by setting environment variables. To disable the SVC mode under Solaris 2.6, use the svc_uninstall script.

The syntax is: 

hostname% svc_install options

The following table lists and describes the svc_install options and defaults.

Table 3-3 svc_install Options and Defaults

svc_install Options

Description 

-v

This is Verbose mode which displays status information on stdout.

Typically, you run the script without any options. You must be logged in as superuser. The script modifies /usr/openwin/xil/lib. You should not run this script if this is an NFS mounted directory.

The svc_uninstall Script for Solaris 2.6

The svc_uninstall script removes the SVC mode installed by svc_install and puts back the original XIL device handler directory.

Caution - Caution -

Since the SVC mode replaces the standard XIL 1.3 device handler directory, it is VERY important to run svc_uninstall before any updates (that is, patches, upgrades, or new package installations) are applied to your workstation which will change or add XIL components.

The syntax is: 

hostname% svc_uninstall options

The following table lists and describes the svc_uninstall options and defaults.

Table 3-4 svc_install Options and Defaults

svc_install Options

Description 

-v

This is Verbose mode which displays status information on stdout.

Typically, you run the script without any options. You must be logged in as superuser. The script modifies /usr/openwin/xil/lib. You should not run this script if this is an NFS mounted directory.

The svc_devices Script

The svc_devices script creates and removes SunVideo compatibility mode pseudo devices in /dev. The default location for the svc_devices script is /opt/SUNWo1kp/bin. The install script syntax is: 

hostname% svc_devices install

The remove script syntax is: 

hostname% svc_devices remove

Use svc_devices install to install SunVideo Compatibility mode pseudo devices. Use svc_devices remove to remove SunVideo pseudo devices from the /dev directory.

To select a SunVideo Plus card from a SunVideo application program, use the rtvc pseudo device name, typically /dev/rtvc0.

Note -

If you use pkgrm to remove the SunVideo Plus software, you do not need to first run the svc_devices remove script. The pkgrm script removes all pseudo devices.

Note -

If you move the SunVideo Plus card to a different slot, you must first run svc_devices remove and then run svc_devices install.