'\" t
.\"     Title: bird
.\"    Author: Giovanni Mascellani <mascellani@poisson.phc.unipi.it>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 09/18/2019
.\"    Manual: BIRD User Manual
.\"    Source: bird
.\"  Language: English
.\"
.TH "BIRD" "8" "09/18/2019" "bird" "BIRD User Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bird \- BIRD Internet Routing Daemon
.br
birdc \- BIRD Internet Routing Daemon remote control
.br
bird6 \- BIRD Internet Routing Daemon, IPv6 version
.br
birdc6 \- BIRD Internet Routing Daemon remote control, IPv6 version
.SH "SYNOPSIS"
.HP \w'\fBbird\fR\ 'u
\fBbird\fR [\fB\-c\ \fR\fB\fIconfig\-file\fR\fR] [\fB\-d\fR] [\fB\-D\ \fR\fB\fIdebug\-file\fR\fR] [\fB\-p\fR] [\fB\-s\ \fR\fB\fIcontrol\-socket\fR\fR]
.HP \w'\fBbirdc\fR\ 'u
\fBbirdc\fR [\fB\-s\ \fR\fB\fIcontrol\-socket\fR\fR] [\fB\-v\fR] [\fB\-r\fR]
.HP \w'\fBbird6\fR\ 'u
\fBbird6\fR [\fB\-c\ \fR\fB\fIconfig\-file\fR\fR] [\fB\-d\fR] [\fB\-D\ \fR\fB\fIdebug\-file\fR\fR] [\fB\-p\fR] [\fB\-s\ \fR\fB\fIcontrol\-socket\fR\fR]
.HP \w'\fBbirdc6\fR\ 'u
\fBbirdc6\fR [\fB\-s\ \fR\fB\fIcontrol\-socket\fR\fR] [\fB\-v\fR] [\fB\-r\fR]
.SH "DESCRIPTION"
.PP
\fBbird\fR
is an Internet Routing Daemon\&. That is, it sends and receives messages using different protocols in order to discover and exchange routing information with other routing daemons present on the same network\&. It is able to talk the most widely known routing protocols (such as BGPv4, RIPv2, OSPFv2 and OSPFv3), both on IPv4 and IPv6 and it features a very powerful language for route filtering\&.
.PP
\fBbirdc\fR
is a remote control for
\fBbird\fR\&. While
\fBbird\fR
is running, the system administrator can connect to it using
\fBbirdc\fR, to inspect its internal status and reconfigure it\&. The two processes use a Unix socket to communicate\&. Once started,
\fBbird\fR
will give access to an interactive shell: commands can be completed with TAB and help can be requested by pressing the key `?\*(Aq\&. More documentation on the available commands can be foung on the website, see below\&.
.PP
\fBbird6\fR
and
\fBbirdc6\fR
are the exact equivalent for
\fBbird\fR
and
\fBbirdc\fR
for the IPv6 world\&. The accept the same command syntax with the same meaning\&.
.SH "OPTIONS"
.PP
The
\fBbird\fR
and
\fBbird6\fR
are able to receive there options:
.PP
\fB\-c \fR\fB\fIconfig\-file\fR\fR
.RS 4
Use given configuration file instead of the default /etc/bird/bird\&.conf\&.
.RE
.PP
\fB\-d\fR
.RS 4
Enable debug messages and run bird in foreground\&.
.RE
.PP
\fB\-D \fR\fB\fIdebug\-file\fR\fR
.RS 4
Log debugging information to given file instead of standard error\&.
.RE
.PP
\fB\-p\fR
.RS 4
Just parse the config file and exit\&. Return value is zero if the config file is valid, nonzero if there are some errors\&.
.RE
.PP
\fB\-s \fR\fB\fIcontrol\-socket\fR\fR
.RS 4
Use given filename for a socket for communications with the client (remote control), default is /var/run/bird\&.ctl\&.
.RE
.PP
The
\fBbirdc\fR
and
\fBbirdc6\fR
are able to receive there options:
.PP
\fB\-s \fR\fB\fIcontrol\-socket\fR\fR
.RS 4
Use given filename for a socket for communications with the server, default is /var/run/bird\&.ctl\&.
.RE
.PP
\fB\-r\fR
.RS 4
Run
\fBbirdc\fR
in restricted mode: only the `show \&.\&.\&.\*(Aq commands are allowed\&.
.RE
.PP
\fB\-v\fR
.RS 4
Numeric return codes are dumped along with messages, making them easily parsable by a program\&. See the programmer\*(Aqs documentation for information about their meanings\&.
.RE
.SH "FILES"
.PP
/etc/bird/bird\&.conf
.RS 4
The system\-wide configuration file to control the behaviour of
bird\&. See the website for more documentation\&.
.RE
.PP
/etc/bird/bird6\&.conf
.RS 4
The system\-wide configuration file to control the behaviour of
bird6\&. See the website for more documentation\&.
.RE
.SH "SEE ALSO"
.PP
More documentation con be found on the website: http://bird\&.network\&.cz/\&.
.SH "AUTHOR"
.PP
\fBGiovanni Mascellani\fR <\&mascellani@poisson\&.phc\&.unipi\&.it\&>
.RS 4
Wrote this manpage for the Debian system\&.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2010 Giovanni Mascellani
.br
.PP
This manual page was written for the Debian system (and may be used by others)\&.
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
/usr/share/common\-licenses/GPL\&.
.sp