man page(1) manual page
Table of Contents

_________________________________________________________________

NAME

tkined - An Interactive Network Editor based on Tk.

SYNOPSIS

tkined ?file1 file2 ...?
_________________________________________________________________

DESCRIPTION

Tkined is an interactive editor for creating and maintaining network maps. Tkined is programmable and can therefore be used as a graphical frontend for quite a number of applications that normally act on a network map (e.g. network management systems, network simulators). Applications 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 management 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 commands 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 process 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 selection.

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 Button 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 command. 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 command to copy objects form one view to another.

Copy
Copy the current selection on the clipboard without deleting the objects from the current view.

Paste
Paste the objects stored on the clipboard into the current view.

The Structure menu contains commands to modify the structure 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 manipulate 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 reference 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 application 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 orientation 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 Toolbox 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 recommended for debugging.

Memory Trace
If you have compiled and installed the Tk/Tcl libraries and tkined with the memory validation define set, this toggles 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 look-and-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 editor. 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.5/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 submenus, e.g. Sun:SparcStation 2.

group i
The definition of an icon for a collapsed group is done in the same way as for a node icon.

network i
The definition of the i-th network consists of the line thickness to use and the name that appears in the menu.

reference i
The definition of an icon for a reference 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 represents 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.5/tkined.defaults
/usr/local/lib/tkined1.4.5/init.tcl
/usr/local/lib/tkined1.4.5/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>


Table of Contents