Index Index for
Section 8
Index Alphabetical
listing for G
Index Bottom of
page		 

gated(8)


NAME

  gated - gateway routing daemon


SYNOPSIS

  /usr/sbin/gated  [-c] [-C] [-n] [-N] [-t trace_options]
     [-f config_file] [trace_file]


FLAGS

  -c  Specifies that gated parse the configuration file for syntax, then
      exit.  If there are no errors, gated leaves a dump file in
      /usr/tmp/gated_dump.

      You do not need root privileges to use the -c option.  However, if you
      do not have root privileges, gated might not be able to read the kernel
      forwarding table and interface configuration.  The -c option implies -
      tgeneral.	 All trace_option clauses in the configuration file are
      ignored.

  -C  Specifies that gated parse the configuration file for syntax errors.
      If no errors occur, gated exits with a status 0.	Otherwise, it exits
      with a status 1.

      You do not need root privileges to use the -C option.  However, if you
      do not have root privileges, gated might not be able to read the kernel
      forwarding table and interface configuration.

  -n  Specifies that gated not modify the kernel forwarding table.  This is
      used for testing gated  configurations with actual routing data.

  -N  Specifies that gated run as a user process.  Normally, if tracing to
      stderr is not specified and if the parent process is not init, gated
      runs as a daemon process.	 This allows the use of an /etc/inittab-like
      method of invoking gated.

  -t trace_options
      Specifies a comma-separated list of trace options to be enabled on
      startup.	If no flags are specified, general is assumed.	No space is
      allowed between this option and its arguments.

      Use this to trace events that take place before the configuration file
      is parsed, such as determining the interface configuration and reading
      routes from the kernel.

      See gated.conf(4) for valid trace options and a more detailed
      explanation of tracing.

  -f config_file
      Specifies an alternate configuration file. By default, gated uses
      /etc/gated.conf.

      If a trace file is specified on the command line, or no trace flags are
      specified on the command line, gated detaches from the terminal and
      runs in the background.  If trace flags are specified without
      specifying a trace file, gated assumes that tracing is desired to
      stderr and remains in the foreground.


DESCRIPTION

  The gated routing daemon is based on Release 3.5 from the Cornell
  GateDaemon Project.  The gated daemon replaces routed and egpup, and
  currently handles the RIP, BGP, EGP, HELLO, and OSPF routing protocols.
  The gated process can be configured to perform all routing protocols or any
  subset of them.

  SIGNAL PROCESSING


  You can use the following signals to control gated:

  SIGHUP    Causes gated to reread the configuration file.  The gated daemon
	    first performs a clean-up of all allocated policy structures. All
	    BGP and EGP peers are flagged for deletion and the configuration
	    file is reparsed.

	    If the reparse is successful, any BGP and EGP peers that are no
	    longer in the configuration are shut down, and new peers are
	    started. Gated attempts to determine if changes to existing peers
	    require a shutdown and restart. OSPF is not capable of
	    reconfiguring, it is shutdown and restarted during a
	    reconfiguration. This may have an adverse impact on the routing
	    system.

	    It should also be possible to enable/disable any protocol without
	    restarting gated.

  SIGINT    Causes gated to write the current state of all tasks, timers,
	    protocols, and tables to the /usr/tmp/gated_dump file.

	    On systems supporting fork(), this is done by forking a
	    subprocess to dump the table information.  This does not affect
	    gated's routing functions.	On systems where memory management
	    does not support copy-on-write, fork() causes the gated address
	    space to be duplicated; this might cause a noticeable impact on
	    the system.	 On systems not supporting fork(), the main process
	    immediately processes the dump, which might impact gated's
	    routing functions.

  SIGTERM   Causes gated to shut down.	All tasks and protocols are asked to
	    shutdown. Most terminate immediately, except EGP peers, which
	    waits for confirmation.  You might have to send SIGTERM once or
	    twice if it this process takes too long to shut down.

	    All protocol routes are removed from the kernel forwarding table
	    on receipt of a SIGTERM. Interface routes, routes with RTF_STATIC
	    set (from the route command where supported) and static routes
	    specifying retain will remain. To terminate gated with the
	    exterior routes intact, use SIGKILL.

  SIGUSR1   Causes gated to close the trace file.  A subsequent SIGUSR1
	    reopens the trace file.  This allows the file to be moved
	    regularly.

	    You cannot use SIGUSR1 if a trace file has not been specified or
	    if tracing is being performed to stderr.

  SIGUSR2   Causes gated to rescan the kernel interface list for changes.


FILES

  /usr/tmp/gated_dump
      Contains gated status information.

  /etc/gated.conf
      Contains the gated configuration information.

  /var/run/gated.pid
      Contains the gated process id (PID).


RELATED INFORMATION

  Commands: arp(8), gdc(8), ifconfig(8), netstat(1), ospf_monitor(8),
  ripquery(8), routed(8), route(8)

  Functions:  fork(2)

  Files: gated.conf(4), gated.proto(4), gated.control(4)

Index Index for
Section 8
Index Alphabetical
listing for G
Index Top of
page