listing for D
dtaction - invoke a CDE action with specified arguments
dtaction [-contextDir context_dir] [-execHost host_name] [-termOpts
terminal_arguments] [-user user_name] action_name [action_arg]...
The following options are available:
If the definition of action_name does not define a current working
directory [see CWD in dtactionfile(4)] for command actions, the user
can use this option to specify a default directory context.
The user can use this option to specify an alternative execution host,
host_name, for a command action. If the action is not a command action,
the dtaction utility ignores this option. The action is attempted on
host_name instead of the hosts specified in the action's EXEC_HOST
[(see dtactionfile(4)] specification. An error dialog is posted if it
is not possible to invoke the specified action on any eligible host.
This option allows the user to specify arguments intended for the
terminal emulator that is provided for command actions that are not of
type NO_STDIO. If there are white-space characters in the
terminal_arguments string, that string must be quoted to protect it
from the shell. These arguments are passed unchanged to the terminal
emulator. The user must ensure that they are reasonable; in particular,
terminal_arguments does not allow the argument that specifies the
command to be run in a terminal emulator window; that is, you cannot
use -e program_argument as described in dtterm(1).
The -user option allows a user to specify a user name. If dtaction is
not currently running as that user, a prompt dialog collects the
indicated user password, or the root user password. Once a valid
password is entered, the dtaction utility changes so that it is running
as the requested user and then initiates the requested action.
The following operands are supported:
The name of the action to be invoked.
The absolute or relative names of files.
The dtaction utility allows applications or shell scripts, which are
otherwise not connected into the CDE development environment, to invoke
The action called action_name is invoked with the action_arg provided on
the command line. A single action_name is required; the user may provide
any number of action_args. Interpretation of the action_name and
action_args depends on the definition of the action in the action database
[see dtactionfile(4)]. The action may be defined in one of the system
action database files, or in one of the user's private action database
The action_args are absolute or relative pathnames of files. The utility
passes this list of files on to the specified action.
Error dialogs are posted when the following conditions are detected:
· Could not initialize desktop environment
· Invalid user or password
· Unable to change ID to the desired user
· No action name specified
The dtaction utility writes diagnostic error messages to standard error,
which is redirected to $HOME/.dt/errorlog.
The dtaction utility takes the standard action for all signals.
CONSEQUENCES OF ERRORS
The following environment variable affects the execution of dtaction:
A comma-separated list of directories (with optional host: prefix) that
tells the action service where to find the action databases.
The following exit values are returned:
0 Successful completion.
>0 An invocation error was detected.
The input files named as action_arg arguments are absolute or relative
names of files.
The action database files found on DTDATABASESEARCHPATH conform to the
format specified in dtactionfile(4).
listing for D