tkined(1)

NAME

tkined - An Interactive Network Editor based on Tk.

SYNOPSIS

tkined ?file1 file2 ...?

DESCRIPTION

Tkined is an interactive editor for creating and maintain
ing network maps. Tkined is programmable and can there
fore be used as a graphical frontend for quite a number of
applications that normally act on a network map (e.g. net
work management systems, network simulators). Applica
tions run as separate processes that communicate with
tkined through a simple protocol. The most common way to
implement a tkined application is to use the network man
agement extension Tnm(n) for the Tool Command Language
Tcl(n) which encapsulated the protocol and provides access
to the editor using the ined(n) Tcl command.

Tkined has evolved from the original ined editor which was
written on top of the Unidraw/Interviews framework. Tkined
in its current form is a set of Tk(1) scripts and some C
code that handles the internal state of tkined objects.

This man page is intended to provide a short overview over
menus provided by the Tkined editor.

FILE MENU

The File menu contains commands to save, load or print
network maps.

Clear Clear the current map.

Open... Load a previously saved map. The saved

map file contains a script of ined com
mands that will reconstruct the map.
Loading a map may also restart tkined
applications.

Merge... Merge a previously saved map into the

current map.

Save... Save the current map to the current file

name. Tkined will write into the file
named noname.tki if you never specified
a different file name.

Save As... Save the current map after choosing a

new file name.

Print... Print or store the current network map

in PostScript format. You are prompted
to enter a print command or to select a
file name which will capture the
PostScript output.

Import... Import a background image. The image

file must have the X11 bitmap format.

History... The editor maintains a history of

recently used map files in
~/.tkined/.history. The history command
allows to open a map file from the list
of recently used tkined maps. This
allows to jump from map to map very
quickly.

New View Create a new view. This looks much like

spawning a new tkined process, but a new
view allows you to copy and paste
between the views and saves some
resources.

Close View Close the tkined view. The tkined pro

cess will exit if you close the last
tkined view.

SELECT MENU

The Select menu contains commands that modify the set of
currently selection objects.

Select All This command selects all objects shown

on the canvas.

Select Neighbours Add all objects linked directly to a

selected object to the current selec
tion.

Select Member Add all member of all selected groups to

the current selection.

Select by Type Add all objects of a given type to the

current selection.

Select by Name Query the user for a regular or glob

style expression and add all objects to
the current selection whose name matches
the expression.

Select by Address Query the user for a regular or glob

style expression and add all objects to
the current selection whose address
matches the expression.

Select by Label Query the user for a regular or glob

style expression and add all objects to
the current selection whose current
label contents matches the expression.

Select by Attribute

Query the user for an attribute and a
regular or glob style expression and add
all objects to the current selection
where the content of the selected
attribute matches the expression.

The Edit menu contains the following commands for editing
maps.

Attribute->Create Create a new attribute for all selected

objects (also avail by Button 3 popup
menu).

Attribute->Delete Delete an attribute from all selected

objects, if existing (also avail by But
ton 3 popup menu).

Attribute->Edit Change an attribute for all selected

objects.

Set Label Set the label of all selected objects

the value of an attribute.

Scale Factor Set the scaling factor of all selected

bar- and stripcharts.

Grid Spacing Set the spacing between grid points in

pixel.

Align to Grid Align the selected objects on the grid.

Objects not selected will not be
touched.

Undo Undo the last change you made. Note that

undo currently cannot undo a delete com
mand. If you are not sure you really
want to delete, use the cut command (see
below).

Redo Redo the last undone change. A sequence

like undo undo redo redo should always
bring you back in the initial state.

Delete Delete the current selection. All

objects will get lost since this command
does not update the undo buffer.

Cut Delete the current selection and place

all deleted objects on the clipboard.
The clipboard is a global buffer shared
by all views. You can use the cut com
mand to copy objects form one view to
another.

Copy Copy the current selection on the clip

board without deleting the objects from
the current view.

Paste Paste the objects stored on the clip

board into the current view.

The Structure menu contains commands to modify the struc
ture of the map.

Bring to Front Bring the selected objects to the front

of the map. Background images ignore
this command.

Send to Back Send the selected objects to the back of

the map.

Group Create a new group object. The current

selection will become the members of the
new group object.

Ungroup Delete a group object. The member of the

group will become visible again or the
group frame will be deleted if the group
is currently expanded.

Collapse Collapse an expanded group to show its

icon. A new group is always initially
collapsed.

Expand Expand a group object so that the member

of the group become visible. The group
itself is shown as a rectangle enclosing
its members.

Join Group This command can be used to add objects

to an existing group. You have to select
the objects to add and the group to add
to. A dialog will ask you to select the
parent group if there are ambiguities.

Leave Group All selected objects will be removed

from any group they belong to.

The Icon menu contains six sub menus allowing to manipu
late the appearance of tkined objects.

Node This sub menu contains all configured

node icons.

Network This sub menu contains all configured

network representations.

Group This sub menu contains icons for group

objects.

Reference This sub menu contains icons for refer

ence objects.

Font The Font sub menu contains symbolic

names for all available fonts.

Color The Color sub menu contains symbolic

names for the colors available. This
sub menu will only appear if you are
working on a color display. Tkined will
map all colors to black if your applica
tion or your saved map expects color
definitions and you are sitting in front
of a monochrome display.

The Options menu allows you to set the page size and ori
entation and offers some checkbuttons to control the lookand-feel of tkined.

Media This sub menu controls the size of the

drawing area.

Orientation Set the orientation of the selected

media. You can choose between landscape
and portrait mode.

Flip Toolbox Toggle the Toolbox appearance (the box

containing the tools to create new
tkined objects) between left and top.

Show Toolbox You can show or hide the tkined toolbox

(the box containing the tools to create
new tkined objects) using the Show Tool
box toggle.

Lock Editor Locking the editor disallows creation

and deletion of objects. You can Unlock
the editor by turning the Lock Editor
switch off again.

Memory Validation If you have compiled and installed the

Tk/Tcl libraries and tkined with the
memory validation define, this toggle
enables/disables memory validation.
Note: Memory validation is very time
consuming and at least not even recom
mended for debugging.

Memory Trace If you have compiled and installed the

Tk/Tcl libraries and tkined with the
memory validation define set, this tog
gles enable/disable of memory allocation
tracing. Trace information is written to
stderr of tkined.

Memory Info If you have compiled and installed the

Tk/Tcl libraries and tkined with the
memory validation define set, this
prints some memory usage statistics to
stderr of tkined.

Strict Motif Toggle tkined's appearance between a

nicer motif-like and strict motif lookand-feel, as done by John within tk.

The Help menu contains some infos about the editor and
some short help texts.

General General information about tkined.

Status Some status information about the edi

tor. This is mainly for maintenance.

Key Bindings A short note about the key bindings

inside the canvas. This may help you to
learn about the various ways to use the
mouse buttons.

CUSTOMIZATION

You can customize the tkined editor to your specific
needs. You may load your own icon bitmaps and define the
width of various network types. All customization is done
using tkined.defaults files, that are very similar to
xrdb(1) files. Since there is no way to access the
defaults database of the server from within tk, the
defaults files are searched along the tkined_path. The
default setting of this path is
TKINED_PATH=.:$HOME/.tkined:/usr/local/lib/tkined1.4.11/site:/usr/local/lib/tkined%TKI_VERSION%. You can add elements to this path by setting the
environment variable TKINED_PATH.

width

height You can specify the default width and

height of the drawing area using the
with and height attribute.

node i You may specify icons to represent

machines for the i-th node menu entry.
The definition consists of two strings.
The first one is the filename of the
bitmap and the second is the name of the
icon as shown in the node menu. A colon
can be used to create a path of sub
menus, e.g. Sun:SparcStation 2.

group i The definition of an icon for a col

lapsed group is done in the same way as
for a node icon.

network i The definition of the i-th network con

sists of the line thickness to use and
the name that appears in the menu.

reference i The definition of an icon for a refer

ence object is done in the same way as
for a node icon.

interpreter i The i-th interpreter is defined by its

file name. It is the responsibility of
the interpreter to define new menus
using the ined create MENU command.

font i The font menu is build using the font

definitions. The i-th menu entry repre
sents font i which must be given as an
X11 font name followed by the name used
in the font menu.

color i The contents of the color menu is given

by an X11 color name and the name for
this color used in the color menu. The
color menu does not appear on monochrome
displays.

SEE ALSO

Tcl(n), Tk(n), scotty(1)

FILES

/usr/local/lib/tkined1.4.11/tkined.defaults
/usr/local/lib/tkined1.4.11/init.tcl
/usr/local/lib/tkined1.4.11/bitmaps/*.xbm
$HOME/.tkined/tkined.defaults
$HOME/.tkined/*.xbm
$HOME/.tkined/.history

AUTHORS

Juergen Schoenwaelder <schoenw@cs.utwente.nl>
Guntram Hueske <hueske@ibr.cs.tu-bs.de>

Tnm tkined(1)