Manpages

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-control(5), diald-monitor(5)

AUTHOR

Eric Schenk (Eric.Schenk [AT] dna.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.