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 primary goal of the Tnm exten-
sion is to provide a string-based API to access network protocols and services relevant 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 specific management solutions because higher-level interfaces encapsulate the com-
plexity of some of the protocols supported 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.
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 variables:
tnm(library) The path to the scotty library directory. This variable is initialized to the compiled in default. You can overwrite 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 architecture 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 environment variable.
$tnm(library)/site/init.tcl
Site initialization file. Use this file to customize Tnm to your site specific needs.
$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 version 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 par-
ties. 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 documentation for any purpose, pro-
vided that existing copyright notices are retained in all copies and that this notice is included verbatim in any distributions. No written
agreement, 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 SOFTWARE, ITS DOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSI-
BILITY OF SUCH DAMAGE.
THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABIL-
ITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBU-
TORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
SEE ALSO
scotty(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 con-
tributed 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 Tnm(n)