84 lines
2.6 KiB
Groff
84 lines
2.6 KiB
Groff
.\" $XConsortium: dtexec.man /main/2 1995/07/17 10:50:37 drk $
|
|
.\" *************************************************************************
|
|
.\" **
|
|
.\" ** (c) Copyright 1993,1994 Hewlett-Packard Company
|
|
.\" ** All Rights Reserved.
|
|
.\" **
|
|
.\" ** (c) Copyright 1993,1994 International Business Machines Corp.
|
|
.\" ** All Rights Reserved.
|
|
.\" **
|
|
.\" ** (c) Copyright 1993,1994 Sun Microsystems, Inc.
|
|
.\" ** All Rights Reserved.
|
|
.\" **
|
|
.\" *************************************************************************
|
|
.TH dtexec 1X "17 Jan 1994"
|
|
.BH "17 Jan 1994"
|
|
.\"---
|
|
.SH NAME
|
|
\fBdtexec\fP \(em A "wrapper" program for command lines to
|
|
control when the command exits.
|
|
.sp 1
|
|
.SH SYNOPSIS
|
|
.B dtexec <open_option> <command_line>
|
|
.nf
|
|
.in 10
|
|
.fi
|
|
.sp 1
|
|
.SH DESCRIPTION
|
|
Dtexec is used by the Common Desktop Environment (CDE) when
|
|
executing terminal-based actions. Its'
|
|
purpose is to keep the terminal window
|
|
open after the command terminates in
|
|
the following circumstances:
|
|
.sp 1
|
|
.in 10
|
|
- If the action is of type PERM-TERMINAL.
|
|
.sp 1
|
|
.in 10
|
|
- If the action is of type TERMINAL and
|
|
the command "quickly" exits, which
|
|
indicates that an error occurred.
|
|
.P
|
|
The "open_option" arguments are:
|
|
.sp 1
|
|
.in 10
|
|
1. "-1" - Keep the window open when
|
|
"command_line" terminates.
|
|
.sp 1
|
|
2. "0" - Unmap the terminal window after
|
|
"command_line" terminates.
|
|
.sp 1
|
|
3. "n" - Keep the terminal window mapped if
|
|
"command_line" terminates within "n" seconds of
|
|
starting. The default value is "3" seconds. To
|
|
change the default, set the component's "waitTime"
|
|
or "WaitTime" resource. For example, to change
|
|
the CDE File Manager to wait "5" seconds,
|
|
set the following resource: "Dtfile*waitTime: 5".
|
|
Dtexec does not have any resources.
|
|
.P
|
|
Dtexec's default path is "/usr/dt/bin".
|
|
To change this
|
|
location, set the component's "dtexecPath" or
|
|
"DtexecPath" resource. For example, to change
|
|
the CDE File Manager's dtexec path to
|
|
"/usr/local/bin", set the following resource:
|
|
"Dtfile*dtexecPath: /usr/local/bin".
|
|
|
|
.sp 1
|
|
.SH RETURN VALUE
|
|
\fBdtexec\fP returns 0 if successful; otherwise it returns 1.
|
|
Successful return from dtexec implies system resources were available
|
|
to fork and exec the requested command, not that the requested command
|
|
itself executed successfully.
|
|
.SH NOTES
|
|
.PP
|
|
This program is not normally invoked directly by application
|
|
programs. Normally an application program will link with the
|
|
Desktop Services Library (DtSvc) which will then invoke \fBdtexec\fP
|
|
as needed.
|
|
.PP
|
|
As mentioned above, an application program can set its
|
|
\fIwaitTime\fP and \fIDtexecPath\fP resources to affect the behavior
|
|
of DtSvc library invocations of \fIdtexec\fP.
|