Basic Commands

There are five routing daemons in use, and there is one manager daemon. These daemons may be located on separate machines from the manager daemon. Each of these daemons will listen on a particular port for incoming VTY connections. The routing daemons are:

The following sections discuss commands common to all the routing daemons.

Config Commands Commands used in config files
Common Invocation Options Starting the daemons
Virtual Terminal Interfaces Interacting with the daemons

Config Commands

Basic Config Commands Some of the generic config commands
Sample Config File An example config file

In a config file, you can write the debugging options, a vty's password, routing daemon configurations, a logfile name, and so forth. This information forms the initial command set for a routing beast as it is starting.

Config files are generally found in:


Each of the daemons has its own config file. For example, zebra's default config file name is:


The daemon name plus .conf is the default config file name. You can specify a config file using the -f or --config-file options when starting the daemon.

Basic Config Commands

Sample Config File

Below is sample configuration of the zebra daemon.

     ! Zebra configuration file
     hostname Router
     password zebra
     enable password zebra
     log stdout
! and # are comment characters. If the first character of the word is one of comment characters then, from the rest of the line will be ignored as a comment.
     password zebra!password

If a comment character is not the first character of the word, it's a normal character. So above ! will not be regarded as a comment and the password is set to zebra!password.

Common Invocation Options

These options are common to all Zebra Daemons.

Virtual Terminal Interfaces

VTY - Virtual Terminal [aka TeletYpe] Interface is a command line interface (CLI) to change and/or view the current configuration.

VTY Overview Basics about VTYs
VTY Modes Basics about VTYs
VTY CLI Commands Basics about VTYs

VTY Overview

VTY stands for Virtual TeletYpe interface. It means you can connect to the daemon via the telnet protocol. To enable a VTY interface, you have to setup a VTY password. If there is no VTY password, one cannot connect to the VTY interface at all.

     % telnet localhost 2601
     Connected to localhost.
     Escape character is '^]'.
     Hello, this is zebra (version 0.88)
     Copyright 1997-2000 Kunihiro Ishiguro
     User Access Verification
     Password: XXXXX
     Router> ?
       enable            Turn on privileged commands
       exit              Exit current mode and down to previous mode
       help              Description of the interactive help system
       list              Print command list
       show              Show running system information
       who               Display who is on a vty
     Router> enable
     Password: XXXXX
     Router# configure terminal
     Router(config)# interface eth0
     Router(config-if)# ip address
     Router(config-if)# ^Z

   ? is very useful for looking up commands.

VTY Modes

There are three basic VTY modes:
VTY View Mode Mode for read-only interaction
VTY Enable Mode Mode for read-write interaction
VTY Other Modes Special modes (tftp, etc)

There are commands that may be restricted to specific VTY modes.

VTY View Mode

This mode is for read-only access to the CLI. One may exit the mode by leaving the system, or by entering `enable' mode.

VTY Enable Mode

this mode is for read-write access to the cli. one may exit the mode by leaving the system, or by escaping to view mode.

VTY Other Modes

This page is for describing other modes.

VTY CLI Commands

Commands that you may use at the command-line are described in the following three subsubsections.

CLI Movement Commands Commands for moving the cursor about
CLI Editing Commands Commands for changing text
CLI Advanced Commands Other commands, session management and so

CLI Movement Commands

These commands are used for moving the CLI cursor. The <C> character means press the Control Key.

CLI Editing Commands

These commands are used for editing text on a line. The <C> character means press the Control Key.

CLI Advanced Commands

There are several additional CLI commands for command line completions, insta-help, and VTY session management.

This file documents the GNU Zebra software which manages common TCP/IP routing protocols.

This is Edition 0.1, last updated 5 July 2000 of `The GNU Zebra Manual', for Zebra Version 0.88.

Copyright (C) 1999, 2000 Kunihiro Ishiguro

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by Kunihiro Ishiguro.