Tnm(n) Tnm Tcl Extension Tnm(n)_________________________________________________________________NAME
Tnm - Tcl extensions for network management applications.
_________________________________________________________________DESCRIPTION
The Tnm Tcl extensions has been written to simplify the
development of network management applications. The pri-
mary goal of the Tnm extension is to provide a string-
based API to access network protocols and services rele-
vant for network management applications. Some of the Tcl
commands provided by the Tnm extension are useful for more
general networked applications as well.
A string-based API simplifies the development of site spe-
cific management solutions because higher-level interfaces
encapsulate the complexity of some of the protocols sup-
ported by the Tnm extension. The use of the Tcl language
allows to integrate this extension with the Tk toolkit.
Management applications can thus be prototyped in a cost-
effective and platform independent way.
COMMAND OVERVIEW
Below is a short overview over the Tcl commands provided
the Tnm extension. There are separate man pages for each
command listed below which describes the command and its
options in more detail.
dns Query the Domain Name System of the Internet.
http Send and process HTTP requests.
icmp Send ICMP messages to hosts on the Internet.
ined Access and manipulate tkined objects.
job Invoke Tcl procedures at regular intervals.
mib Load and query SNMP MIB definitions.
netdb Access the local network databases.
ntp Retrieve control variables from NTP peers.
snmp Send SNMP messages to devices on the Internet.
sunrpc Call and probe selected Sun RPC services.
syslog Write messages to the system logger.
udp Send and receive UDP datagrams.
Tnm 1
Tnm(n) Tnm Tcl Extension Tnm(n)ENVIRONMENT VARIABLES
TNM_LIBRARY Path to the Tnm library directory.
TNM_NTPING Path and name of ntping executable.
TNM_STRAPS Path and name of straps executable.
TNM_RCFILE Path and name of the initialization
file.
TCL VARIABLES
The Tnm extension defines the following global Tcl vari-
ables:
tnm(library) The path to the scotty library direc-
tory. This variable is initialized to
the compiled in default. You can over-
write this default by setting the
TNM_LIBRARY environment variable.
tnm(version) The version number of the Tnm extension.
tnm(arch) A string that identifies the architec-
ture and operating system. Note, this
will only work with Tcl version 7.5 and
higher.
tnm(host) The name of the local host executing the
Tcl process.
tnm(user) The name of the user running the Tcl
process.
tnm(mibs) This variable contains a list of SNMP
MIB files that are loaded automatically
if not preceded by a mib load command.
tnm(mibs:core) This variable contains a list of core
SNMP MIB files that are loaded even if
the first mib command is a load command.
FILES
~/.scottyrc Personal initialization file. May be
overwritten by the TNM_RCFILE environ-
ment variable.
$tnm(library)/site/init.tcl
Site initialization file. Use this file
to customize Tnm to your site specific
needs.
Tnm 2
Tnm(n) Tnm Tcl Extension Tnm(n)
$tnm(library)/library/init.tcl
Tnm initialization file. Do not edit.
$tnm(library)/mibs
Archive of MIB and GDMO files.
AVAILABILITY
The Tnm Tcl extension is freely available in source form
via anonymous FTP. The source distribution is available
from:
ftp://ftp.ibr.cs.tu-bs.de/pub/local/tkined/
The Tnm extension is contained in the scotty.tar.gz file
which is a link to the latest public-ally available ver-
sion of this software. Additional information about the
Tnm extension is available on the World Wide Web. The URL
to the home-page of the scotty package is:
http://www.cs.utwente.nl/~schoenw/scotty/
LICENSE
This software is copyrighted by Juergen Schoenwaelder, the
Technical University of Braunschweig, the University of
Twente and other parties. The following terms apply to
all files associated with the software unless explicitly
disclaimed in individual files.
The authors hereby grant permission to use, copy, modify,
distribute, and license this software and its documenta-
tion for any purpose, provided that existing copyright
notices are retained in all copies and that this notice is
included verbatim in any distributions. No written agree-
ment, license, or royalty fee is required for any of the
authorized uses. Modifications to this software may be
copyrighted by their authors and need not follow the
licensing terms described here, provided that the new
terms are clearly indicated on the first page of each file
where they apply.
IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO
ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFT-
WARE, ITS DOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN
IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED
ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
Tnm 3
Tnm(n) Tnm Tcl Extension Tnm(n)
NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
ENHANCEMENTS, OR MODIFICATIONS.
SEE ALSOscotty(1), Tcl(n)AUTHORS
The Tnm extension includes work contributed by students at
the Technical University of Braunschweig. The names of
individuals who provided major contributions are listed on
the man pages for every command. The current version also
includes many improvements and bug fixes contributed by
the user community. Please read the README file contained
in the sources for a more complete list of individuals.
Juergen Schoenwaelder <schoenw@cs.utwente.nl>
Tnm 4