GateD R3_5 Documentation
GateD R3_5 Documentation
The GateD documentation is now all written in
HTML, the HyperText Markup Language. It has been
developed primarily with the NCSA Mosaic for the X Window System
WWW/HTML viewer, but should work with any WWW/HTML
viewer. Mosaic viewers for the X Window System, the Apple Macintosh and for
Microsoft Windows are available from
ftp.ncsa.uiuc.edu in the Mosaic
directory.
If you are reading this file as the README file in a GateD
distribution, it was converted to plain text for the distribution. The
INSTALL file in this directory has also been converted from
HTML to plain text. To view the GateD documentation with an
HTML viewer, point it at doc/main.html.
The GateD web pages at www.gated.org has the latest on-line documentation for the following versions of GateD:
The document consists of the following sections:
GateD is a modular software program consisting of core services, a routing database, and protocol modules supporting multiple routing protocols (RIP versions 1 and 2, DCN HELLO, OSPF version 2, EGP version 2 and BGP version 2 through 4.) GateD was first used to interconnect the NSFNET and the emerging regional networks, and to implement filtered routing based on policy. GateD allows the network administrator to control import and export of routing information by individual protocol, by source and destination autonomous system, source and destination interface, previous hop router, and specific destination address. The network administrator can specify a preference level for each combination of routing information being imported by using a flexible masking capability. Once the preference levels are assigned, GateD makes a decision on which route to use independent of the protocols involved.
GateD is designed to handle dynamic routing with a routing database built from information exchanged by routing protocols.
If you need assistance or have any questions, don't bang your head against the wall. Post to the mailing list. There are many people with GateD experience who may be able to take a moment to help.
When reporting a problem with GateD, several pieces of information will greatly assist in debugging:
It helps to provide this as both the output
of netstat -in (netstat -i -n on BSD 4.2
based systems) and an ifconfig for each interface (ifconfig
-a will work for some versions of SunOS 4 and later.
The Routing table may be listed by using i.e. netstat -rn (netstat -r -n
on BSD 4.2 based systems)
To get this start GateD with -t (which
is short for -tgeneral). Setting tracing options in the config
file will not get all this information because GateD scans the interfaces
before parsing the config file. So you must specify tracing on the command
line.
To get this start GateD and do a "gdc dump" using the gdc utility gated provides.
If it is a RIP problem, turn on RIP tracing, an EGP problem, turn on EGP tracing.
Send Bug reports to either:
gated@gated.merit.edu
There are the main mailing lists for the GateD Project:
To subscribe, send a request to to gated-members-request@gated.merit.edu.
To subscribe, send a request to to gated-people-request@gated.merit.edu.
To subscribe, send a request to to gated-alpha-request@gated.merit.edu.
No subscription possible.
No subscription possible.
No subscription possible.
GateD has code in two source trees:
The Consortium code is released in 3 separate versions:
The Consortium code is developed out of a single library for releases 4, 5, and 6. These releases have the nice features of being "autoconfed" and will adapt more easily to your environment that the public GateD code. You can probably obtain a "no-cost" license to use this code. Please see the next section for details.
The Public GateD code is available for anonymous ftp to all people in the Internet. GateD Public code cannot be redistributed without obtaining a redistribution license for GateD Version 3.
You do not need to be a member to obtain the Public GateD code or to apply for a redistribution license.
anonymous FTP from:
ftp.gated.org pub-research/gated/release.tar.gz
The GateD Public code has been supported by Merit, the GateD Consortium members, grants, and research institutions. This varied group of people have supported making high quality software available to the Internet at no cost for academic and research applications.
Support for GateD Public code has come from:
Merit supports the public domain software development with people and equipment resources.
An example of such generous members are: Hitachi and Digital. Hitachi has created test tools and asked that much of it's code be donated back to the public arena. Digital asked that IPv6 code be available in the public domain.
NSF support a great deal of GateD's early development via the NSFNET projects. In addition, some of the early code was also developed by IBM as part of their contribution to the NSFNET.
The FAA supported the development of the IDRP code for the FAA project. DARPA funded some of the work for the base GateD code.
The CAIRN project has helped develop the BGP-4++ code.
Various Research Institutions are supporting the GateD Consortium development of the public code as Academic Supporting members:
INRIA is specifically supporting the IPv6 operations.
The GateD Consortium code is developed via Commercial companies adding their resources to the Internet. This code is available to the Internet for "Academic and Research" use. Our definition of Academic and Research use includes anyone who wants to use or examine the code, but not use it in a commercial product or commercial service.
You can probably obtain a "no-cost" license to use this code even if you are at a commercial companyif you are:
The Consortium code is released in 3 separate versions:
The Consortium code is developed out of a single library for releases 4 (4.2 and above), 5 and 6. These releases have the nice features of being "autoconfed" and will adapt more easily to your environment that the public GateD code.
Release 4.0 and 4.1 are not "autoconf", but contain additional features for protocols. Please click here for a description of the code additions to GateD-Unicast.
The Consortium GateD code is available for ftp via a web interface at www.gated.org
/http://www.gated.merit.edu/code
which is the Code, Tools and Documents section.
Several versions of GateD are available for ftp. Any source code
for versions of Consortium GateD versions of code
(versions 4, 5, and 6) require a membership id and password.
You can obtain these at "no-cost" by becoming a member of GateD
for any particular version.
We urge you to make sure you are using the latest copy of GateD. GateD Consortium is easy to obtain over the network if you are a GateD member. If you are not a member, it is easy to become a member. Please see the section below.
GateD members can obtain the latest GateD source, tools and documentation from www.gated.merit.edu
If you are planning, to use Gated in a Commercial product or a Internet Service product you should apply one of the following membership categories:
For further details on application forms and membership, click here
If you are planning to use GateD for Academic and Research purposes, you may apply for Academic and Research Membership. This membership is available to those using GateD for research and academic purposes only. Commercial uses include using GateD in a product that is sold as a commercial product or used to provide a commerical service.
Our definition of what constitutes "Academic and Research" purposes is very "broad". Our business is to build and transfer technology. Merit, Inc. is a research institution which transfers technology from Academic and Research to the Internet. The GateD Consortium to support the routing technology in the Internet. Please apply if you think you investigating GateD for:
Please use the Academic and Research license to look at the code prior to becoming a Commercial member. GateD internal's documentation is available for members.
We are trying to add additional tools and monitoring features to GateD.
You can become a
GateD Academic and Research member
by filling out a GateD Membership form on the Gated Web page
at www.gated.org. If you do not have web
connectivity, you can ftp the form and send back the form to
gated@gated.merit.edu.
Further information about GateD may be obtained from the GateD Consortium Home Page with an HTML viewer. The GateD Web pages include:
The GateDaemon Consortium presents a formal structure to support and expand the current successful collaborations already in place to develop GateD functionality.
Membership is open to all organizations interested in supporting and participating in development of internetwork routing protocols. Membership is not a prerequisite for licensing of GateD source code. More information about the GateD Consortium may be obtained from the GateD Consortium Web Page or my e-mail to consortium-interest@gated.org.
The GateD source code, tools and documentation is based on three different product lines: GateD Unicast, GateD Multicast, GateD IPv6. In each of the products, has it's own software base, release dates, and product desciptions.
New GateD Source code, tools and internal documentation is available to GateD members only . Binaries for utilities or on-line documentation is available for anonymous ftp or via the web.
Members of the Academic and Research community can join the the Merit GateD Consortium at no cost by simply filling out a GateD Academic and Research membership.
We are working toward supporting all publically available operating systems as well as those of our members. The Merit GateD Consortium has not accomplished this goal, and looks to the linux, FreeBSD, NETBSD, and other operating system communities for help. can use
This membership simply requires that the member:
The term of each of the Merit GateD Consortiuim licenses is 1 year. However, you may renew for 10 years or more.
A Gold membership spans two product lines and allows for commercial redistribution for both product lines. The other membership categories are in respect to a particular product line. Membership is a requirement for distribution of GateD sources or binaries.
For commerical redistrbution you need to become either a
For redistribution to support a Commerical Internet Service, you need to become either a
Each of the commerical memberships require a fee.
For redistribution of binaries and sources within the Academic and Research community, you may become either an:
The following are the short forms of the copyrights that apply to GateD. If you are reading this document with an HTML viewer, click on them to see the legalese in excruciating detail.
License to use, copy, modify, and distribute this software and its documentation can be obtained from Merit at the University of Michigan.
This package and associated documentation is Copyright (c) 1990,1991,1992,1993,1994,1995 Cornell University., all rights reserved. This software contains code that is Copyright (c) 1988 Regents of the University of California., all rights reserved.;
Note: OSPF_2 code (version 2 with RFC 1583 support) does not require the University of Maryland Copyright.
gated@gated.org