/usr/dt/share/man/cat1/dtexec.1(/usr/dt/share/man/cat1/dtexec.1)
dtexec(1) USER COMMANDS dtexec(1)
NAME
dtexec - execute command-based action
SYNOPSIS
dtexec [-open open_option ] [ -ttprocid procid ] [ -tmp
tmpfile ] cmd [ cmd_arg ... ]
DESCRIPTION
TED uses the dtexec utility to execute COMMAND actions. In
normal usage, TED automatically invokes dtexec when it is
needed. TED users and administrators do not need to
interact directly with dtexec.
The primary argument for dtexec is the name of a command to
execute and any command-line options or arguments for that
command. There are several important services that dtexec
provides for the commands that it executes. These services
are controlled via the options specified in the ``OPTIONS''
section in this document.
OPTIONS
The following options are available:
-open open_option
The -open option tells dtexec whether it
should continue to run or exit after the
command terminates.
The valid values for open_option are:
-1 (default) continue to execute
after cmd terminates.
0 exit as soon as cmd terminates.
n continue to execute if cmd ter-
minates within n seconds of
starting.
The values -1 and n are typically used
when COMMAND actions are executed in a
terminal emulator to control the lifetime
of the terminal window.
-ttprocid procid
The dtexec command uses the -ttprocid
option to send ToolTalk messages back to
the application that invoked the COMMAND
action. These messages are used to convey
status information (for example, the com-
mand has terminated).
Unix System LaboratoLast change: 1 August 1995 1
dtexec(1) USER COMMANDS dtexec(1)
-tmp tmpfile The -tmp option names a temporary file
that dtexec removes after cmd terminates
if either no -ttprocid option is supplied
or contact is lost with the specified pro-
cid. In normal usage, the parent process
that starts dtexec, performs this cleanup.
This option can be issued multiple times,
once for each tmp file present. Typi-
cally, tmpfile also appears as a cmd_arg.
EXIT STATUS
The following exit values are returned:
0 Implies all system resources were available to fork
and exec the requested command, not that the
requested command executed successfully.
1 An error occurred.
APPLICATION USAGE
Normally, application programs do not directly invoke this
program. Normally, an application program links with the
action service, which then invokes dtexec as needed. Appli-
cations should use the waitTime resource to configure the
value of the -open_option and the DtexecPath resource to
configure the location of dtexec.
If cmd writes to stderr, the error messages are time stamped
and redirected to the user's errorlog file
($HOME/.dt/errorlog) when open_option is 0. If open_option
is set otherwise, the error messages are typically displayed
in the terminal window.
SEE ALSO
dtaction(1), dtactionfile(4).
Unix System LaboratoLast change: 1 August 1995 2
See also dtexec(1)
Man(1) output converted with
man2html