screencmd

Send a command to the Screen services

Syntax:

screencmd cmd
            

Runs on:

QNX Neutrino

Options:

The cmd string starts with one of the following commands that can be sent to Screen services:

The apply command takes no other parameters. However, all other commands require the following parameters specified in the remainder of the cmd string:

object

The Screen object that the command is to be perfomed on. Specify the object for the command by indicating the prefix of the object type, followed by the ID of the object. The IDs of the object type can be determined by looking at Screen debug files, such as /dev/screen/mem.

The following Screen objects are supported by this utility, and are listed with their associated prefix:

Screen object Prefix
context ctx-
device dev-
display dpy-
group grp-
pixmap pix-
session ssn-
stream str-
window win-

property_name

The property that's to be applied to the Screen object. All valid properties for each object type are supported by screencmd.

The property is case insensitive, and it's acceptable to provide the property without being prefixed by SCREEN_PROPERTY_. For example, the following commands are equivalent:

screencmd setiv win-1 SCREEN_PROPERTY_ZORDER 1
screencmd setiv win-1 zorder 1
                        
property_value

The value that you want applied to the property. The value depends on the type of command, and the property that you want to set:

Command Property value type and/or format
setcv A string that you want the property set to.
setgp The name of the group that the object should join.
setiv An integer or a comma-separated list of integers that you want the property set to. (e.g., 1280,760)
setllv A long integer that you want the property set to.
setpv The Screen object that you want the property set to. Specify the object in the same way as you did for the object parameter (described before).
>

Description:

The screencmd utility is a command-line tool (must be run as root) that's used to send commands to connect to Screen services. This utility connects to screen as a privileged context, so that it can operate on any window in the system.

To run screencmd:

  1. Ensure that screen is running.
  2. Run screencmd from a shell.

Examples:

Set the SCREEN_PROPERTY_SIZE property to 400x800 on the window object whose ID is 1:

screencmd setiv win-1 size 400,800