Index for Section 1

Alphabetical listing for D

Bottom of page

dtexec(1)
CDE
NAME
  dtexec - execute command-based action

SYNOPSIS
  dtexec [-open open_option] [-ttprocid procid] [-tmp tmpfile] cmd [cmd_arg
  ...]

OPTIONS
  The following options are available:

  -open open_option
      The -open option tells dtexec to continue or exit, after the command
      terminates.

      The valid values for open_option are:

      -1      Continue to execute after cmd terminates. This is the default
	      value.

      o	      Exit as soon as cmd terminates.

      n	      Continue to execute if cmd terminates 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 the status information (for example, the command has
      terminated).

  -tmp tmpfile
      The -tmp option names a temporary file that dtexec removes after cmd
      terminates, when no -ttprocid option is supplied or when contact is
      lost with the specified procid. In normal usage, the parent process
      that starts dtexec performs this cleanup.	 This option can be issued
      many times, once for each tmp file present. Typically, tmpfile also
      appears as a cmd_arg.

DESCRIPTION
  CDE uses the dtexec utility to execute COMMAND actions. In normal usage,
  CDE automatically invokes dtexec when it is needed. CDE users and
  administrators do not need to interact directly with the dtexec utility.

  The primary argument for dtexecutility 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 utiltiy provides for the commands
  that it executes. These services are controlled via the options specified
  above.

APPLICATION USAGE
  Normally, application programs do not directly invoke this program.  The
  application program links with the action service, which then invokes
  dtexec as needed. Applications should use the waitTime resource to
  configure the value of the open_option and the DtexecPath resource to
  configure the location of dtexec utility.

  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.

EXIT STATUS
  The following exit values are returned:

  0   Implies all system resources were available to fork and execute the
      requested command. It does not imply that the requested command
      executed successfully.

  1   An error occurred.

SEE ALSO
  dtaction(1), dtactionfile(4)

Index for Section 1

Alphabetical listing for D

Top of page