blob: cc0d12169d06121e08e183a47b0783d0757620bc [file] [log] [blame]
hassoc0652302004-11-25 19:33:48 +00001.TH BGPD 8 "25 November 2004" "Quagga BGPD daemon" "Version 0.97.3"
paul718e3742002-12-13 20:15:29 +00002.SH NAME
paul00c8dc72004-11-22 18:06:59 +00003bgpd \- a BGPv4, BGPv4\+, BGPv4\- routing engine for use with Quagga routing
hasso246c1352004-08-10 12:00:34 +00004software
paul718e3742002-12-13 20:15:29 +00005
6.SH SYNOPSIS
7.B bgpd
8[
hasso2f04e672004-02-20 18:53:22 +00009.B \-dhrv
hasso246c1352004-08-10 12:00:34 +000010] [
11.B \-f
12.I config-file
13] [
14.B \-i
15.I pid-file
16] [
17.B \-p
18.I bgp-port-number
19] [
hasso246c1352004-08-10 12:00:34 +000020.B \-P
21.I port-number
22] [
23.B \-A
24.I vty-address
25] [
26.B \-u
27.I user
hassoc0652302004-11-25 19:33:48 +000028] [
29.B \-g
30.I group
paul718e3742002-12-13 20:15:29 +000031]
paul718e3742002-12-13 20:15:29 +000032.SH DESCRIPTION
33.B bgpd
34is a routing component that works with the
hasso246c1352004-08-10 12:00:34 +000035.B Quagga
paul718e3742002-12-13 20:15:29 +000036routing engine.
paul718e3742002-12-13 20:15:29 +000037.SH OPTIONS
hasso246c1352004-08-10 12:00:34 +000038Options available for the
39.B bgpd
40command:
paul718e3742002-12-13 20:15:29 +000041.TP
42\fB\-d\fR, \fB\-\-daemon\fR
43Runs in daemon mode, forking and exiting from tty.
paul718e3742002-12-13 20:15:29 +000044.TP
45\fB\-f\fR, \fB\-\-config-file \fR\fIconfig-file\fR
46Specifies the config file to use for startup. If not specified this
47option will likely default to \fB\fI/usr/local/etc/bgpd.conf\fR.
paul718e3742002-12-13 20:15:29 +000048.TP
hassoc0652302004-11-25 19:33:48 +000049\fB\-g\fR, \fB\-\-group \fR\fIgroup\fR
50Specify the group to run as. Default is \fIquagga\fR.
51.TP
paul718e3742002-12-13 20:15:29 +000052\fB\-h\fR, \fB\-\-help\fR
53A brief message.
paul718e3742002-12-13 20:15:29 +000054.TP
55\fB\-i\fR, \fB\-\-pid_file \fR\fIpid-file\fR
56When bgpd starts its process idenifier is written to
57\fB\fIpid-file\fR. The init system uses the recorded PID to stop or
58restart bgpd. The likely default is \fB\fI/var/run/bgpd.pid\fR.
paul718e3742002-12-13 20:15:29 +000059.TP
hassoc0652302004-11-25 19:33:48 +000060\fB\-p\fR, \fB\-\-bgp_port \fR\fIbgp-port-number\fR
paul718e3742002-12-13 20:15:29 +000061Set the port that bgpd will listen to for bgp data.
paul718e3742002-12-13 20:15:29 +000062.TP
63\fB\-P\fR, \fB\-\-vty_port \fR\fIport-number\fR
64Specify the port that the bgpd VTY will listen on. This defaults to
652605, as specified in \fI/etc/services\fR.
paul718e3742002-12-13 20:15:29 +000066.TP
hasso6c110e72003-11-27 13:02:03 +000067\fB\-A\fR, \fB\-\-vty_addr \fR\fIvty-address\fR
68Specify the address that the bgpd VTY will listen on. Default is all
ajs151fe8a2005-04-22 12:56:37 +000069interfaces.
hasso6c110e72003-11-27 13:02:03 +000070.TP
71\fB\-u\fR, \fB\-\-user \fR\fIuser\fR
hassoc0652302004-11-25 19:33:48 +000072Specify the user to run as. Default is \fIquagga\fR.
hasso6c110e72003-11-27 13:02:03 +000073.TP
paul718e3742002-12-13 20:15:29 +000074\fB\-r\fR, \fB\-\-retain\fR
75When the program terminates, retain routes added by \fBbgpd\fR.
paul718e3742002-12-13 20:15:29 +000076.TP
77\fB\-v\fR, \fB\-\-version\fR
78Print the version and exit.
paul718e3742002-12-13 20:15:29 +000079.SH FILES
paul718e3742002-12-13 20:15:29 +000080.TP
81.BI /usr/local/sbin/bgpd
82The default location of the
83.B bgpd
84binary.
paul718e3742002-12-13 20:15:29 +000085.TP
86.BI /usr/local/etc/bgpd.conf
87The default location of the
88.B bgpd
89config file.
paul718e3742002-12-13 20:15:29 +000090.TP
91.BI $(PWD)/bgpd.log
92If the
93.B bgpd
94process is config'd to output logs to a file, then you will find this
95file in the directory where you started \fBbgpd\fR.
paul718e3742002-12-13 20:15:29 +000096.SH WARNING
hasso246c1352004-08-10 12:00:34 +000097This man page is intended to be a quick reference for command line
98options. The definitive document is the Info file \fBQuagga\fR.
paul718e3742002-12-13 20:15:29 +000099.SH DIAGNOSTICS
100The bgpd process may log to standard output, to a VTY, to a log
101file, or through syslog to the system logs. \fBbgpd\fR supports many
102debugging options, see the Info file, or the source for details.
paul718e3742002-12-13 20:15:29 +0000103.SH "SEE ALSO"
hasso246c1352004-08-10 12:00:34 +0000104.BR ripd (8),
105.BR ripngd (8),
106.BR ospfd (8),
107.BR ospf6d (8),
108.BR isisd (8),
109.BR zebra (8),
110.BR vtysh (1)
paul718e3742002-12-13 20:15:29 +0000111.SH BUGS
112.B bgpd
113eats bugs for breakfast. If you have food for the maintainers try
hasso2f04e672004-02-20 18:53:22 +0000114.BI http://bugzilla.quagga.net
hasso246c1352004-08-10 12:00:34 +0000115.SH AUTHORS
116See
117.BI http://www.zebra.org
118and
119.BI http://www.quagga.org
120or the Info file for an accurate list of authors.
paul718e3742002-12-13 20:15:29 +0000121