blob: e680ddb238d31ce2e9de2372cb9aef46efdd0d72 [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[
Lou Bergerac6ff462016-05-17 07:10:37 -04009.B \-dhrSv
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
ajsa0e64a62005-04-22 13:14:49 +000056When bgpd starts its process identifier is written to
paul718e3742002-12-13 20:15:29 +000057\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
Lou Bergerac6ff462016-05-17 07:10:37 -040077\fB\-S\fR, \fB\-\-skip_runas\fR
78Skip setting the process effective user and group.
79.TP
paul718e3742002-12-13 20:15:29 +000080\fB\-v\fR, \fB\-\-version\fR
81Print the version and exit.
paul718e3742002-12-13 20:15:29 +000082.SH FILES
paul718e3742002-12-13 20:15:29 +000083.TP
84.BI /usr/local/sbin/bgpd
85The default location of the
86.B bgpd
87binary.
paul718e3742002-12-13 20:15:29 +000088.TP
89.BI /usr/local/etc/bgpd.conf
90The default location of the
91.B bgpd
92config file.
paul718e3742002-12-13 20:15:29 +000093.TP
94.BI $(PWD)/bgpd.log
95If the
96.B bgpd
97process is config'd to output logs to a file, then you will find this
98file in the directory where you started \fBbgpd\fR.
paul718e3742002-12-13 20:15:29 +000099.SH WARNING
hasso246c1352004-08-10 12:00:34 +0000100This man page is intended to be a quick reference for command line
101options. The definitive document is the Info file \fBQuagga\fR.
paul718e3742002-12-13 20:15:29 +0000102.SH DIAGNOSTICS
103The bgpd process may log to standard output, to a VTY, to a log
104file, or through syslog to the system logs. \fBbgpd\fR supports many
105debugging options, see the Info file, or the source for details.
paul718e3742002-12-13 20:15:29 +0000106.SH "SEE ALSO"
hasso246c1352004-08-10 12:00:34 +0000107.BR ripd (8),
108.BR ripngd (8),
109.BR ospfd (8),
110.BR ospf6d (8),
111.BR isisd (8),
Timo Teräsb1887c82017-01-24 16:42:19 +0200112.BR nhrpd (8),
hasso246c1352004-08-10 12:00:34 +0000113.BR zebra (8),
114.BR vtysh (1)
paul718e3742002-12-13 20:15:29 +0000115.SH BUGS
116.B bgpd
117eats bugs for breakfast. If you have food for the maintainers try
hasso2f04e672004-02-20 18:53:22 +0000118.BI http://bugzilla.quagga.net
hasso246c1352004-08-10 12:00:34 +0000119.SH AUTHORS
120See
121.BI http://www.zebra.org
122and
Denis Ovsienko2bbd71a2009-06-01 20:07:46 +0400123.BI http://www.quagga.net
hasso246c1352004-08-10 12:00:34 +0000124or the Info file for an accurate list of authors.
paul718e3742002-12-13 20:15:29 +0000125