Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dtaction(user cmd)					    dtaction(user cmd)

NAME
       dtaction	-- invoke a XCDE action	with specified arguments

SYNOPSIS
       dtaction	  [-contextDir context_dir]    [-execHost host_name]	[-ter-
       mOpts terminal_arguments]    [-user user_name]	 [action_name]	  [ac-
       tion_arg]  [...]

DESCRIPTION
       The  dtaction  utility  allows applications or shell scripts, which are
       otherwise not connected into the	XCDE development environment,  to  in-
       voke action requests.

       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	files.

       The action_args are absolute or relative	pathnames of files.  The util-
       ity passes this list of files on	to the specified action.

       Error dialogs are posted	when the following conditions are detected:

	  o  could not initialize desktop environment

	  o  invalid user or password

	  o  unable to change ID to the	desired	user

	  o  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.

       -execHost host_name
		 The user can use this option to specify an alternative	execu-
		 tion host, host_name, for a command action.  If the action is
		 not  a	 command action, the dtaction utility ignores this op-
		 tion.	The action is attempted	on host_name  instead  of  the
		 hosts	specified  in  the  action's  EXEC_HOST	(see dtaction-
		 file(4)) specification.  An error dialog is posted if	it  is
		 not  possible	to invoke the specified	action on any eligible
		 host.

       -termOpts terminal_arguments
		 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 char-
		 acters	 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 en-
		 sure that they	are reasonable;	in particular,	terminal_argu-
		 ments	does not allow the argument that specifies the command
		 to be run in a	terminal emulator window (that is, -e for  dt-
		 term(1)).

       -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 dia-
		 log  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.

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.

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

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 ac-
		 tion databases.

RESOURCES
       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  er-
       ror, which is redirected	to $HOME/.dt/errorlog.

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

							    dtaction(user cmd)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | STDIN | INPUT FILES | ENVIRONMENT VARIABLES | RESOURCES | ASYNCHRONOUS EVENTS | STDOUT | STDERR | OUTPUT FILES | EXTENDED DESCRIPTION | EXIT STATUS | CONSEQUENCES OF ERRORS | APPLICATION USAGE | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dtaction&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help