DTACTION(1)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💅 dtaction (user cmd) 💅

okay so bestie, this is the manual for dtaction(user cmd) — the XCDE action launcher thing — and we’re gonna make it make sense. It’s literally here so apps or shell scripts that aren’t plugged into the XCDE development environment can still invoke action requests. slay. ✨

💖 NAME 💖

dtaction — invoke a XCDE action with specified arguments.

✨ SYNOPSIS ✨

       dtaction [-contextDir context_dir]  [-execHost host_name]  [-termOpts
       terminal_arguments]  [-user user_name]  [action_name]  [action_arg]
       [...]

🦋 DESCRIPTION 🦋

The dtaction utility lets applications or shell scripts that are not otherwise connected into the XCDE development environment invoke action requests. it’s giving bridge energy, fr fr.

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. How action_name and action_args are interpreted 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 files. iykyk.

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

🎀 OPTIONS 🎀

The following options are available:

  • -contextDir context_dir — 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. lowkey handy.
  • -execHost host_name — 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. no cap.
  • -termOpts terminal_arguments — This option lets the user 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, -e for dtterm(1)).
bestie, do not try to sneak -e in there — the page literally says terminal_arguments does not allow the argument that specifies the command to be run in a terminal emulator window.
  • -user user_name — 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. main character energy, but with auth.

🌸 OPERANDS 🌸

The following operands are supported:

  • action_name — The name of the action to be invoked.
  • action_arg — The absolute or relative file names of files.

🧚 STDIN 🧚

Not used. literally nope.

🍓 INPUT FILES 🍓

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). periodt.

🌈 ENVIRONMENT VARIABLES 🌈

The following environment variable affects the execution of dtaction:

  • DTDATABASESEARCHPATH — A comma-separated list of directories (with optional host: prefix) that tells the action service where to find the action databases. 💖

⭐ RESOURCES ⭐

None. no cap, there are none.

🦋 ASYNCHRONOUS EVENTS 🦋

The dtaction utility takes the standard action for all signals.

💜 STDOUT 💜

Not used.

💀 STDERR 💀

The dtaction utility writes diagnostic error messages to standard error, which is redirected to $HOME/.dt/errorlog. so check there if things get messy, bestie.

👑 OUTPUT FILES 👑

None.

🎀 EXTENDED DESCRIPTION 🎀

None.

🔥 EXIT STATUS 🔥

The following exit values are returned:

  • 0 — Successful completion.
  • >0 — An invocation error was detected.

🙈 CONSEQUENCES OF ERRORS 🙈

Default.

🫶 APPLICATION USAGE 🫶

None.

🧚 EXAMPLES 🧚

None.

🌟 SEE ALSO 🌟

dtactionfile(4), dtterm(1), dtaction(1).

okay that’s the whole page — the footer didn’t hand me a separate source/version/date line beyond the manual name, so here’s your cute sign-off instead: stay iconic, bestie 🫶✨💖

📦 where this page comes from