---
name: "dctrl"
section: "1"
platform: "linux"
package: "diald"
version: "0.99.4-9"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/dctrl"
---

# dctrl(1)

graphical diald control utility

## NAME

dctrl - graphical diald control utility

## SYNOPSIS

**/usr/bin/dctrl** \[-title *\<title\>*\] \[-fifo *\<fifo-path\>*\] \[-host *\<host\>* -port *\<port\>*\] \[-i\] \[-animated-icon\] \[-cw\] \[-control-window\] \[-iconic\] \[standard X options\]

## DESCRIPTION

**Dctrl** is used to issue control commands to a running **diald** process, and to monitor the current status of the link. The **diald** process must have been configured with the "fifo" option in order for dctrl to work. See the "diald" and "diald-control" manual pages for further information on the "fifo" option of **diald.** The interface presented by **dctrl** is very simple, and should be easy to understand.

## OPTIONS

- **-title *\<title\>***

  Sets the title used for the **dctrl** window.

- **-fifo *\<fifo-path\>***

  Tell **dctrl** where to find the control fifo for the diald process that you wish to control. By default **dctrl** will use whatever you have configured in /etc/diald/diald.options.

- **-host *\<host\>* -port *\<port\>***

  Tell **dctrl** to connect to the given port on the given host using TCP rather than using a fifo. It is expected that a diald is listening for connections on the port.

- **-i**

  - **-animated-icon**

  These options both tell **dctrl** to make the icon an animated picture displaying a short synopsis of the current state of diald.

- **-cw**

  - **-control-window**

  These options both tell **dctrl** to construct a window named "dctrlIcon" that appears similar to an icon. This window can be swallowed by an AfterStep, Bowman or FVWM module. For example, an AfterStep configuration line to have Wharf swallow dctrl might look like:

-

  \*Wharf dctrl   nil   Swallow "dctrlIcon" dctrl -iconic -geometry +520+23 -cw &

Note that when this option is selected, iconifying the main **dctrl** window simply unmaps that window, leaving the miniature control icon present. Pressing button \<1\> over the control icon will deiconify the main **dctrl** window.

- **-iconic**

  Tell **dctrl** to start up in the iconified state.

- **-dtstatus**

  The *detailed status* window is posted at startup.

- **-tload**

  The *numeric load monitor* window is posted at startup.

- **-gload**

  The *graphical load monitor* window is posted at startup.

- **-pqueue**

  The *paquet queue* window is posted at startup.

- **-dlog**

  The *dialing log* window is posted at startup.

## SEE ALSO

fvwm(1), afterstep(1), bowman(1), diald(1), [diald-examples(5)](/diald-examples/5.md), [diald-control(5)](/diald-control/5.md), [diald-monitor(5)](/diald-monitor/5.md)

## AUTHOR

Eric Schenk (Eric.Schenk@dna.lth.se)

## BUGS

This manual page is really much too abreviated. There should be more discussion about what dctrl will do and how to use it.