tellxdt3(1) IXI X.desktop 3.5 tellxdt3(1)
NAME
tellxdt3 -- send a Deskshell script to X.desktop and out-
put its results
SYNOPSIS
tellxdt3 [ options ] [ script ]
tellxdt3 [ options ] -
DESCRIPTION
The tellxdt3 command transmits one or more Deskshell
scripts to X.desktop and processes their results.
The options fall into three groups:
Those that control the connection to X.desktop, those that
define the script to be sent, and those that specify the
actions to be taken with the results of the script.
Options are indicated with a dash; some options have
parameters, and the order of options is not significant.
If incompatible options are specified (such as -all and
-name ), then an error is indicated and no script is sent.
Any upper case letter in an option name may be replaced by
its lower case equivalent.
SPECIAL OPTIONS
If any of these options are specified, then they must be
the only option, and there must be no script.
-version
Print the version number of tellxdt3 and exit.
-verboseVersion
Print a verbose form of the version of tellxdt3 and
exit.
-usage, -help
Print a usage message and exit.
CONNECTING TO X.DESKTOP
The following options control the connection to X.desktop.
-display display
Connect to an X.desktop running on the specified
display. If this is not specified, the environment
variable $DISPLAY is used.
-list List all the desktops running on the display, one
per line, on standard output. The only other
option that may be used with this is -display, and
there must be no arguments. The exit code will be
0 on normal termination, or 1 on an error.
Licensed material--property of copyright holder(s) 1
tellxdt3(1) IXI X.desktop 3.5 tellxdt3(1)
-name name
Connect to the X.desktop with the specified name.
-all Connect to all X.desktops. Using this option is
equivalent to repeating the command, specifying
each desktop running on the display in turn, in
some unspecified order. The output to standard
output and standard error will be the catenation of
the outputs from dealing with each desktop; the
status will be the status of dealing with the last
desktop.
If neither -name or -all is specified, then tellxdt3 will
connect to an X.desktop chosen at random.
-wait If X.desktop is not running, then tellxdt3 will
wait for it to start. The default is for an error
to be indicated.
-secure code
The XQP primary security code is set to the speci-
fied (hexadecimal) code.
RESULTS
A deskshell script generates as output a list of strings
and a status. The strings are written to standard output;
each string is surrounded by a prefix string and a suffix
string, and the (affixed) strings are separated by a
delimiter string. Options allow the number of strings to
be written to standard output, and the status to be writ-
ten to standard output or standard error.
The options controlling these features are as follows.
-prefix prefix
Specifies the prefix string (default is none).
-suffix suffix
Specifies the suffix string (default is none).
-delim delim
Specifies the delimiter string (default is a single
newline).
-delimZero
The delimiter string is a zero byte.
-printCount
The count of strings, followed by a newline, is
written in decimal to standard output before the
first string.
-printStatus
The status, possibly followed by a text
Licensed material--property of copyright holder(s) 2
tellxdt3(1) IXI X.desktop 3.5 tellxdt3(1)
description, and followed by a newline, is written
in decimal to standard output before the first
string (and the count if -printCount is used).
-reportStatus
Identical to -printStatus, except that the line is
written to standard error.
-printReturn
Identical to -reportStatus.
-alternateStatus
Generate alternate exit code.
EXIT CODE
The exit code is based on the status code of the last (or
only) script. Either of two rules may be used: the stan-
dard code, or the alternate code (indicated by -alternat-
eStatus ).
Returned status Standard code Alternate code
-------------------------------------------------------
0 0 0
1 to 255 1 c
256 to 511 2 c-256 | 64
512 to 767 3 c-512 | 128
768 to 1023 4 c-768 | 192
-------------------------------------------------------
Error from X.desktop 126 126
Other error 127 127
c indicates the status of the script.
If the exit code would be 126 or 127, it is made 125.
An error from X.desktop is indicated by a return code of
512 or above and no text (as opposed to one zero length
string).
EXAMPLES
tellxdt3 displaydirectory /tmp
This will invoke tellxdt3 with arguments directing it to
display the directory /tmp.
BUGS AND WARNINGS
See release notice in /usr/opt/xdt/release/xdt_3.5.rn
SEE ALSO
X.desktop 3.5 Getting Started Guide
X.desktop 3.5 Reference Guide
X.desktop 3.5 Ideas Guide
COPYRIGHT
IXI Limited, 1988-1993
Licensed material--property of copyright holder(s) 3
tellxdt3(1) IXI X.desktop 3.5 tellxdt3(1)
TRADEMARKS
X.desktop is a trademark of IXI Limited.
X Window System is a trademark of the Massachusetts Insti-
tute of Technology.
Licensed material--property of copyright holder(s) 4