version 2, including all changes.
.
| Rev |
Author |
# |
Line |
| 1 |
perry |
1 |
tkined |
| |
|
2 |
!!!tkined |
| |
|
3 |
NAME |
| |
|
4 |
SYNOPSIS |
| |
|
5 |
DESCRIPTION |
| |
|
6 |
FILE MENU |
| |
|
7 |
SELECT MENU |
| |
|
8 |
CUSTOMIZATION |
| |
|
9 |
SEE ALSO |
| |
|
10 |
FILES |
| |
|
11 |
AUTHORS |
| |
|
12 |
---- |
| |
|
13 |
!!NAME |
| |
|
14 |
|
| |
|
15 |
|
| |
|
16 |
tkined - An Interactive Network Editor based on Tk. |
| |
|
17 |
!!SYNOPSIS |
| |
|
18 |
|
| |
|
19 |
|
| |
|
20 |
__tkined__ ?''file1 file2 ...''? |
| |
|
21 |
|
| |
|
22 |
|
| |
|
23 |
________________________________________________________________________________________________________________________________________ |
| |
|
24 |
!!DESCRIPTION |
| |
|
25 |
|
| |
|
26 |
|
| |
|
27 |
Tkined is an interactive editor for creating and maintaining |
| |
|
28 |
network maps. Tkined is programmable and can therefore be |
| |
|
29 |
used as a graphical frontend for quite a number of |
| |
|
30 |
applications that normally act on a network map (e.g. |
| |
|
31 |
network management systems, network simulators). |
| |
|
32 |
Applications run as separate processes that communicate with |
| |
|
33 |
tkined through a simple protocol. The most common way to |
| |
|
34 |
implement a tkined application is to use the network |
| |
|
35 |
management extension Tnm(n) for the Tool Command Language |
| |
|
36 |
Tcl(n) which encapsulated the protocol and provides access |
| |
|
37 |
to the editor using the ined(n) Tcl command. |
| |
|
38 |
|
| |
|
39 |
|
| |
|
40 |
Tkined has evolved from the original ined editor which was |
| |
|
41 |
written on top of the Unidraw/Interviews framework. Tkined |
| |
|
42 |
in its current form is a set of Tk(1) scripts and some C |
| |
|
43 |
code that handles the internal state of tkined |
| |
|
44 |
objects. |
| |
|
45 |
|
| |
|
46 |
|
| |
|
47 |
This man page is intended to provide a short overview over |
| |
|
48 |
menus provided by the Tkined editor. |
| |
|
49 |
!!FILE MENU |
| |
|
50 |
|
| |
|
51 |
|
| |
|
52 |
The File menu contains commands to save, load or print |
| |
|
53 |
network maps. |
| |
|
54 |
|
| |
|
55 |
|
| |
|
56 |
__Clear__ Clear the current map. |
| |
|
57 |
|
| |
|
58 |
|
| |
|
59 |
__Open...__ Load a previously saved map. The saved map |
| |
|
60 |
file contains a script of ined commands that will |
| |
|
61 |
reconstruct the map. Loading a map may also restart tkined |
| |
|
62 |
applications. |
| |
|
63 |
|
| |
|
64 |
|
| |
|
65 |
__Merge...__ Merge a previously saved map into the |
| |
|
66 |
current map. |
| |
|
67 |
|
| |
|
68 |
|
| |
|
69 |
__Save...__ Save the current map to the current file |
| |
|
70 |
name. Tkined will write into the file named noname.tki if |
| |
|
71 |
you never specified a different file name. |
| |
|
72 |
|
| |
|
73 |
|
| |
|
74 |
__Save As...__ Save the current map after choosing a new |
| |
|
75 |
file name. |
| |
|
76 |
|
| |
|
77 |
|
| |
|
78 |
__Print...__ Print or store the current network map in |
| 2 |
perry |
79 |
!PostScript format. You are prompted to enter a print command |
| |
|
80 |
or to select a file name which will capture the !PostScript |
| 1 |
perry |
81 |
output. |
| |
|
82 |
|
| |
|
83 |
|
| |
|
84 |
__Import...__ Import a background image. The image file |
| |
|
85 |
must have the X11 bitmap format. |
| |
|
86 |
|
| |
|
87 |
|
| |
|
88 |
__History...__ The editor maintains a history of recently |
| |
|
89 |
used map files in ~/.tkined/.history. The history command |
| |
|
90 |
allows to open a map file from the list of recently used |
| |
|
91 |
tkined maps. This allows to jump from map to map very |
| |
|
92 |
quickly. |
| |
|
93 |
|
| |
|
94 |
|
| |
|
95 |
__New View__ Create a new view. This looks much like |
| |
|
96 |
spawning a new tkined process, but a new view allows you to |
| |
|
97 |
copy and paste between the views and saves some |
| |
|
98 |
resources. |
| |
|
99 |
|
| |
|
100 |
|
| |
|
101 |
__Close View__ Close the tkined view. The tkined process |
| |
|
102 |
will exit if you close the last tkined view. |
| |
|
103 |
!!SELECT MENU |
| |
|
104 |
|
| |
|
105 |
|
| |
|
106 |
The Select menu contains commands that modify the set of |
| |
|
107 |
currently selection objects. |
| |
|
108 |
|
| |
|
109 |
|
| |
|
110 |
__Select All__ This command selects all objects shown on |
| |
|
111 |
the canvas. |
| |
|
112 |
|
| |
|
113 |
|
| |
|
114 |
__Select Neighbours__ |
| |
|
115 |
|
| |
|
116 |
|
| |
|
117 |
Add all objects linked directly to a selected object to the |
| |
|
118 |
current selection. |
| |
|
119 |
|
| |
|
120 |
|
| |
|
121 |
__Select Member__ |
| |
|
122 |
|
| |
|
123 |
|
| |
|
124 |
Add all member of all selected groups to the current |
| |
|
125 |
selection. |
| |
|
126 |
|
| |
|
127 |
|
| |
|
128 |
__Select by Type__ |
| |
|
129 |
|
| |
|
130 |
|
| |
|
131 |
Add all objects of a given type to the current |
| |
|
132 |
selection. |
| |
|
133 |
|
| |
|
134 |
|
| |
|
135 |
__Select by Name__ |
| |
|
136 |
|
| |
|
137 |
|
| |
|
138 |
Query the user for a regular or glob style expression and |
| |
|
139 |
add all objects to the current selection whose name matches |
| |
|
140 |
the expression. |
| |
|
141 |
|
| |
|
142 |
|
| |
|
143 |
__Select by Address__ |
| |
|
144 |
|
| |
|
145 |
|
| |
|
146 |
Query the user for a regular or glob style expression and |
| |
|
147 |
add all objects to the current selection whose address |
| |
|
148 |
matches the expression. |
| |
|
149 |
|
| |
|
150 |
|
| |
|
151 |
__Select by Label__ |
| |
|
152 |
|
| |
|
153 |
|
| |
|
154 |
Query the user for a regular or glob style expression and |
| |
|
155 |
add all objects to the current selection whose current label |
| |
|
156 |
contents matches the expression. |
| |
|
157 |
|
| |
|
158 |
|
| |
|
159 |
__Select by Attribute__ |
| |
|
160 |
|
| |
|
161 |
|
| |
|
162 |
Query the user for an attribute and a regular or glob style |
| |
|
163 |
expression and add all objects to the current selection |
| |
|
164 |
where the content of the selected attribute matches the |
| |
|
165 |
expression. |
| |
|
166 |
|
| |
|
167 |
|
| |
|
168 |
The Edit menu contains the following commands for editing |
| |
|
169 |
maps. |
| |
|
170 |
|
| |
|
171 |
|
| |
|
172 |
__Attribute-__ |
| |
|
173 |
|
| |
|
174 |
|
| |
|
175 |
Create a new attribute for all selected objects (also avail |
| |
|
176 |
by Button 3 popup menu). |
| |
|
177 |
|
| |
|
178 |
|
| |
|
179 |
__Attribute-__ |
| |
|
180 |
|
| |
|
181 |
|
| |
|
182 |
Delete an attribute from all selected objects, if existing |
| |
|
183 |
(also avail by Button 3 popup menu). |
| |
|
184 |
|
| |
|
185 |
|
| |
|
186 |
__Attribute-__ |
| |
|
187 |
|
| |
|
188 |
|
| |
|
189 |
Change an attribute for all selected objects. |
| |
|
190 |
|
| |
|
191 |
|
| |
|
192 |
__Set Label__ Set the label of all selected objects the |
| |
|
193 |
value of an attribute. |
| |
|
194 |
|
| |
|
195 |
|
| |
|
196 |
__Scale Factor__ |
| |
|
197 |
|
| |
|
198 |
|
| |
|
199 |
Set the scaling factor of all selected bar- and |
| |
|
200 |
stripcharts. |
| |
|
201 |
|
| |
|
202 |
|
| |
|
203 |
__Grid Spacing__ |
| |
|
204 |
|
| |
|
205 |
|
| |
|
206 |
Set the spacing between grid points in pixel. |
| |
|
207 |
|
| |
|
208 |
|
| |
|
209 |
__Align to Grid__ |
| |
|
210 |
|
| |
|
211 |
|
| |
|
212 |
Align the selected objects on the grid. Objects not selected |
| |
|
213 |
will not be touched. |
| |
|
214 |
|
| |
|
215 |
|
| |
|
216 |
__Undo__ Undo the last change you made. Note that undo |
| |
|
217 |
currently cannot undo a delete command. If you are not sure |
| |
|
218 |
you really want to delete, use the cut command (see |
| |
|
219 |
below). |
| |
|
220 |
|
| |
|
221 |
|
| |
|
222 |
__Redo__ Redo the last undone change. A sequence like |
| |
|
223 |
undo undo redo redo should always bring you back in the |
| |
|
224 |
initial state. |
| |
|
225 |
|
| |
|
226 |
|
| |
|
227 |
__Delete__ Delete the current selection. All objects will |
| |
|
228 |
get lost since this command does not update the undo |
| |
|
229 |
buffer. |
| |
|
230 |
|
| |
|
231 |
|
| |
|
232 |
__Cut__ Delete the current selection and place all |
| |
|
233 |
deleted objects on the clipboard. The clipboard is a global |
| |
|
234 |
buffer shared by all views. You can use the cut command to |
| |
|
235 |
copy objects form one view to another. |
| |
|
236 |
|
| |
|
237 |
|
| |
|
238 |
__Copy__ Copy the current selection on the clipboard |
| |
|
239 |
without deleting the objects from the current |
| |
|
240 |
view. |
| |
|
241 |
|
| |
|
242 |
|
| |
|
243 |
__Paste__ Paste the objects stored on the clipboard into |
| |
|
244 |
the current view. |
| |
|
245 |
|
| |
|
246 |
|
| |
|
247 |
The Structure menu contains commands to modify the structure |
| |
|
248 |
of the map. |
| |
|
249 |
|
| |
|
250 |
|
| |
|
251 |
__Bring to Front__ |
| |
|
252 |
|
| |
|
253 |
|
| |
|
254 |
Bring the selected objects to the front of the map. |
| |
|
255 |
Background images ignore this command. |
| |
|
256 |
|
| |
|
257 |
|
| |
|
258 |
__Send to Back__ |
| |
|
259 |
|
| |
|
260 |
|
| |
|
261 |
Send the selected objects to the back of the |
| |
|
262 |
map. |
| |
|
263 |
|
| |
|
264 |
|
| |
|
265 |
__Group__ Create a new group object. The current |
| |
|
266 |
selection will become the members of the new group |
| |
|
267 |
object. |
| |
|
268 |
|
| |
|
269 |
|
| |
|
270 |
__Ungroup__ Delete a group object. The member of the |
| |
|
271 |
group will become visible again or the group frame will be |
| |
|
272 |
deleted if the group is currently expanded. |
| |
|
273 |
|
| |
|
274 |
|
| |
|
275 |
__Collapse__ Collapse an expanded group to show its icon. |
| |
|
276 |
A new group is always initially collapsed. |
| |
|
277 |
|
| |
|
278 |
|
| |
|
279 |
__Expand__ Expand a group object so that the member of |
| |
|
280 |
the group become visible. The group itself is shown as a |
| |
|
281 |
rectangle enclosing its members. |
| |
|
282 |
|
| |
|
283 |
|
| |
|
284 |
__Join Group__ This command can be used to add objects to |
| |
|
285 |
an existing group. You have to select the objects to add and |
| |
|
286 |
the group to add to. A dialog will ask you to select the |
| |
|
287 |
parent group if there are ambiguities. |
| |
|
288 |
|
| |
|
289 |
|
| |
|
290 |
__Leave Group__ |
| |
|
291 |
|
| |
|
292 |
|
| |
|
293 |
All selected objects will be removed from any group they |
| |
|
294 |
belong to. |
| |
|
295 |
|
| |
|
296 |
|
| |
|
297 |
The Icon menu contains six sub menus allowing to manipulate |
| |
|
298 |
the appearance of tkined objects. |
| |
|
299 |
|
| |
|
300 |
|
| |
|
301 |
__Node__ This sub menu contains all configured node |
| |
|
302 |
icons. |
| |
|
303 |
|
| |
|
304 |
|
| |
|
305 |
__Network__ This sub menu contains all configured network |
| |
|
306 |
representations. |
| |
|
307 |
|
| |
|
308 |
|
| |
|
309 |
__Group__ This sub menu contains icons for group |
| |
|
310 |
objects. |
| |
|
311 |
|
| |
|
312 |
|
| |
|
313 |
__Reference__ This sub menu contains icons for reference |
| |
|
314 |
objects. |
| |
|
315 |
|
| |
|
316 |
|
| |
|
317 |
__Font__ The Font sub menu contains symbolic names for |
| |
|
318 |
all available fonts. |
| |
|
319 |
|
| |
|
320 |
|
| |
|
321 |
__Color__ The Color sub menu contains symbolic names for |
| |
|
322 |
the colors available. This sub menu will only appear if you |
| |
|
323 |
are working on a color display. Tkined will map all colors |
| |
|
324 |
to black if your application or your saved map expects color |
| |
|
325 |
definitions and you are sitting in front of a monochrome |
| |
|
326 |
display. |
| |
|
327 |
|
| |
|
328 |
|
| |
|
329 |
The Options menu allows you to set the page size and |
| |
|
330 |
orientation and offers some checkbuttons to control the |
| |
|
331 |
look-and-feel of tkined. |
| |
|
332 |
|
| |
|
333 |
|
| |
|
334 |
__Media__ This sub menu controls the size of the drawing |
| |
|
335 |
area. |
| |
|
336 |
|
| |
|
337 |
|
| |
|
338 |
__Orientation__ |
| |
|
339 |
|
| |
|
340 |
|
| |
|
341 |
Set the orientation of the selected media. You can choose |
| |
|
342 |
between landscape and portrait mode. |
| |
|
343 |
|
| |
|
344 |
|
| |
|
345 |
__Flip Toolbox__ |
| |
|
346 |
|
| |
|
347 |
|
| |
|
348 |
Toggle the Toolbox appearance (the box containing the tools |
| |
|
349 |
to create new tkined objects) between left and |
| |
|
350 |
top. |
| |
|
351 |
|
| |
|
352 |
|
| |
|
353 |
__Show Toolbox__ |
| |
|
354 |
|
| |
|
355 |
|
| |
|
356 |
You can show or hide the tkined toolbox (the box containing |
| |
|
357 |
the tools to create new tkined objects) using the Show |
| |
|
358 |
Toolbox toggle. |
| |
|
359 |
|
| |
|
360 |
|
| |
|
361 |
__Lock Editor__ |
| |
|
362 |
|
| |
|
363 |
|
| |
|
364 |
Locking the editor disallows creation and deletion of |
| |
|
365 |
objects. You can Unlock the editor by turning the Lock |
| |
|
366 |
Editor switch off again. |
| |
|
367 |
|
| |
|
368 |
|
| |
|
369 |
__Memory Validation__ |
| |
|
370 |
|
| |
|
371 |
|
| |
|
372 |
If you have compiled and installed the Tk/Tcl libraries and |
| |
|
373 |
tkined with the memory validation define, this toggle |
| |
|
374 |
enables/disables memory validation. Note: Memory validation |
| |
|
375 |
is very time consuming and at least not even recommended for |
| |
|
376 |
debugging. |
| |
|
377 |
|
| |
|
378 |
|
| |
|
379 |
__Memory Trace__ |
| |
|
380 |
|
| |
|
381 |
|
| |
|
382 |
If you have compiled and installed the Tk/Tcl libraries and |
| |
|
383 |
tkined with the memory validation define set, this toggles |
| |
|
384 |
enable/disable of memory allocation tracing. Trace |
| |
|
385 |
information is written to stderr of tkined. |
| |
|
386 |
|
| |
|
387 |
|
| |
|
388 |
__Memory Info__ |
| |
|
389 |
|
| |
|
390 |
|
| |
|
391 |
If you have compiled and installed the Tk/Tcl libraries and |
| |
|
392 |
tkined with the memory validation define set, this prints |
| |
|
393 |
some memory usage statistics to stderr of |
| |
|
394 |
tkined. |
| |
|
395 |
|
| |
|
396 |
|
| |
|
397 |
__Strict Motif__ |
| |
|
398 |
|
| |
|
399 |
|
| |
|
400 |
Toggle tkined's appearance between a nicer motif-like and |
| |
|
401 |
strict motif look-and-feel, as done by John within |
| |
|
402 |
tk. |
| |
|
403 |
|
| |
|
404 |
|
| |
|
405 |
The Help menu contains some infos about the editor and some |
| |
|
406 |
short help texts. |
| |
|
407 |
|
| |
|
408 |
|
| |
|
409 |
__General__ General information about |
| |
|
410 |
tkined. |
| |
|
411 |
|
| |
|
412 |
|
| |
|
413 |
__Status__ Some status information about the editor. This |
| |
|
414 |
is mainly for maintenance. |
| |
|
415 |
|
| |
|
416 |
|
| |
|
417 |
__Key Bindings__ |
| |
|
418 |
|
| |
|
419 |
|
| |
|
420 |
A short note about the key bindings inside the canvas. This |
| |
|
421 |
may help you to learn about the various ways to use the |
| |
|
422 |
mouse buttons. |
| |
|
423 |
!!CUSTOMIZATION |
| |
|
424 |
|
| |
|
425 |
|
| |
|
426 |
You can customize the tkined editor to your specific needs. |
| |
|
427 |
You may load your own icon bitmaps and define the width of |
| |
|
428 |
various network types. All customization is done using |
| |
|
429 |
tkined.defaults files, that are very similar to xrdb(1) |
| |
|
430 |
files. Since there is no way to access the defaults database |
| |
|
431 |
of the server from within tk, the defaults files are |
| |
|
432 |
searched in the current directory, ~/.tkined, |
| |
|
433 |
$tkined(library)/site and $tkined(library) in this |
| |
|
434 |
order. |
| |
|
435 |
|
| |
|
436 |
|
| |
|
437 |
__width__ |
| |
|
438 |
|
| |
|
439 |
|
| |
|
440 |
__height__ You can specify the default width and height |
| |
|
441 |
of the drawing area using the with and height |
| |
|
442 |
attribute. |
| |
|
443 |
|
| |
|
444 |
|
| |
|
445 |
__node i__ You may specify icons to represent machines |
| |
|
446 |
for the i-th node menu entry. The definition consists of two |
| |
|
447 |
strings. The first one is the filename of the bitmap and the |
| |
|
448 |
second is the name of the icon as shown in the node menu. A |
| |
|
449 |
colon can be used to create a path of submenus, e.g. |
| 2 |
perry |
450 |
Sun:!SparcStation 2. |
| 1 |
perry |
451 |
|
| |
|
452 |
|
| |
|
453 |
__group i__ The definition of an icon for a collapsed |
| |
|
454 |
group is done in the same way as for a node |
| |
|
455 |
icon. |
| |
|
456 |
|
| |
|
457 |
|
| |
|
458 |
__network i__ The definition of the i-th network consists |
| |
|
459 |
of the line thickness to use and the name that appears in |
| |
|
460 |
the menu. |
| |
|
461 |
|
| |
|
462 |
|
| |
|
463 |
__reference i__ |
| |
|
464 |
|
| |
|
465 |
|
| |
|
466 |
The definition of an icon for a reference object is done in |
| |
|
467 |
the same way as for a node icon. |
| |
|
468 |
|
| |
|
469 |
|
| |
|
470 |
__interpreter i__ |
| |
|
471 |
|
| |
|
472 |
|
| |
|
473 |
The i-th interpreter is defined by its file name. It is the |
| |
|
474 |
responsibility of the interpreter to define new menus using |
| |
|
475 |
the ined create MENU command. |
| |
|
476 |
|
| |
|
477 |
|
| |
|
478 |
__font i__ The font menu is build using the font |
| |
|
479 |
definitions. The i-th menu entry represents font i which |
| |
|
480 |
must be given as an X11 font name followed by the name used |
| |
|
481 |
in the font menu. |
| |
|
482 |
|
| |
|
483 |
|
| |
|
484 |
__color i__ The contents of the color menu is given by an |
| |
|
485 |
X11 color name and the name for this color used in the color |
| |
|
486 |
menu. The color menu does not appear on monochrome |
| |
|
487 |
displays. |
| |
|
488 |
!!SEE ALSO |
| |
|
489 |
|
| |
|
490 |
|
| |
|
491 |
Tcl(n), Tk(n), scotty(1) |
| |
|
492 |
!!FILES |
| |
|
493 |
|
| |
|
494 |
|
| |
|
495 |
/usr/local/lib/tkined1.5.0/tkined.defaults |
| |
|
496 |
|
| |
|
497 |
|
| |
|
498 |
/usr/local/lib/tkined1.5.0/init.tcl |
| |
|
499 |
|
| |
|
500 |
|
| |
|
501 |
/usr/local/lib/tkined1.5.0/bitmaps/*.xbm |
| |
|
502 |
|
| |
|
503 |
|
| |
|
504 |
$HOME/.tkined/tkined.defaults |
| |
|
505 |
|
| |
|
506 |
|
| |
|
507 |
$HOME/.tkined/*.xbm |
| |
|
508 |
|
| |
|
509 |
|
| |
|
510 |
$HOME/.tkined/.history |
| |
|
511 |
!!AUTHORS |
| |
|
512 |
|
| |
|
513 |
|
| |
|
514 |
Juergen Schoenwaelder |
| |
|
515 |
Guntram Hueske |
| |
|
516 |
---- |
