mirror of
				https://git.proxmox.com/git/mirror_frr
				synced 2025-11-04 10:07:04 +00:00 
			
		
		
		
	This adds "@tcp" as new choice on the -z option present in zebra and the protocol daemons. The --enable-tcp-zebra option on configure is no longer needed, both UNIX and TCP socket support is always available. Note that @tcp should not be used by default (e.g. in an init script), and --enable-tcp-zebra should never have been in any distro package builds, because **** TCP-ZEBRA IS A SECURITY PROBLEM **** It allows arbitrary local users to mess with the routing table and inject bogus data -- and also ZAPI is not designed to be robust against attacks. Signed-off-by: David Lamparter <equinox@opensourcerouting.org>
		
			
				
	
	
		
			136 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			136 lines
		
	
	
		
			3.2 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.TH PIM 8 "10 December 2008" "@PACKAGE_FULLNAME@ PIM daemon" "Version @PACKAGE_VERSION@"
 | 
						|
.SH NAME
 | 
						|
pimd \- a PIM routing for use with @PACKAGE_FULLNAME@.
 | 
						|
.SH SYNOPSIS
 | 
						|
.B pimd
 | 
						|
[
 | 
						|
.B \-dhvZ
 | 
						|
] [
 | 
						|
.B \-f
 | 
						|
.I config-file
 | 
						|
] [
 | 
						|
.B \-i
 | 
						|
.I pid-file
 | 
						|
] [
 | 
						|
.B \-z
 | 
						|
.I path
 | 
						|
] [
 | 
						|
.B \-P
 | 
						|
.I port-number
 | 
						|
] [
 | 
						|
.B \-A
 | 
						|
.I vty-address
 | 
						|
] [
 | 
						|
.B \-u
 | 
						|
.I user
 | 
						|
] [
 | 
						|
.B \-g
 | 
						|
.I group
 | 
						|
] [
 | 
						|
.B \-M
 | 
						|
.I module:options
 | 
						|
]
 | 
						|
.SH DESCRIPTION
 | 
						|
.B pimd
 | 
						|
is a protocol-independent multicast component that works with the
 | 
						|
.B @PACKAGE_FULLNAME@
 | 
						|
Routing Suite.
 | 
						|
.SH OPTIONS
 | 
						|
Options available for the
 | 
						|
.B pimd
 | 
						|
command:
 | 
						|
.TP
 | 
						|
\fB\-d\fR, \fB\-\-daemon\fR
 | 
						|
Runs in daemon mode, forking and exiting from tty.
 | 
						|
.TP
 | 
						|
\fB\-f\fR, \fB\-\-config-file \fR\fIconfig-file\fR 
 | 
						|
Specifies the config file to use for startup. If not specified this
 | 
						|
option will default to \fB\fI@CFG_SYSCONF@/pimd.conf\fR.
 | 
						|
.TP
 | 
						|
\fB\-g\fR, \fB\-\-group \fR\fIgroup\fR
 | 
						|
Specify the group to run as. Default is \fI@enable_group@\fR.
 | 
						|
.TP
 | 
						|
\fB\-h\fR, \fB\-\-help\fR
 | 
						|
A brief message.
 | 
						|
.TP
 | 
						|
\fB\-i\fR, \fB\-\-pid_file \fR\fIpid-file\fR
 | 
						|
When pimd starts its process identifier is written to
 | 
						|
\fB\fIpid-file\fR.  The init system uses the recorded PID to stop or
 | 
						|
restart pimd.  The default is \fB\fI@CFG_STATE@/pimd.pid\fR.
 | 
						|
.TP
 | 
						|
\fB\-z\fR, \fB\-\-socket \fR\fIpath\fR
 | 
						|
Specify the socket path for contacting the zebra daemon.
 | 
						|
The default is \fB\fI@CFG_STATE@/zserv.api\fR.  The value of this option
 | 
						|
must be the same as the one given when starting zebra.  Refer to the \fBzebra
 | 
						|
(8)\fR man page for more information.
 | 
						|
.TP
 | 
						|
\fB\-P\fR, \fB\-\-vty_port \fR\fIport-number\fR 
 | 
						|
Specify the port that the pimd VTY will listen on. This defaults to
 | 
						|
2611, as specified in \fB\fI/etc/services\fR.
 | 
						|
.TP
 | 
						|
\fB\-A\fR, \fB\-\-vty_addr \fR\fIvty-address\fR
 | 
						|
Specify the address that the pimd VTY will listen on. Default is all
 | 
						|
interfaces.
 | 
						|
.TP
 | 
						|
\fB\-u\fR, \fB\-\-user \fR\fIuser\fR
 | 
						|
Specify the user to run as. Default is \fI@enable_user@\fR.
 | 
						|
.TP
 | 
						|
\fB\-M\fR, \fB\-\-module \fR\fImodule:options\fR
 | 
						|
Load a module at startup.  May be specified more than once.
 | 
						|
There are currently no such modules for
 | 
						|
\fBpimd\fR in the base package.
 | 
						|
.TP
 | 
						|
\fB\-v\fR, \fB\-\-version\fR
 | 
						|
Print the version and exit.
 | 
						|
.TP
 | 
						|
\fB\-Z\fR, \fB\-\-debug_zclient\fR
 | 
						|
Enable logging information for zclient debugging.
 | 
						|
.SH FILES
 | 
						|
.TP
 | 
						|
.BI @CFG_SBIN@/pimd
 | 
						|
The default location of the 
 | 
						|
.B pimd
 | 
						|
binary.
 | 
						|
.TP
 | 
						|
.BI @CFG_SYSCONF@/pimd.conf
 | 
						|
The default location of the 
 | 
						|
.B pimd
 | 
						|
config file.
 | 
						|
.TP
 | 
						|
.BI @CFG_STATE@/pimd.pid
 | 
						|
The default location of the 
 | 
						|
.B pimd
 | 
						|
pid file.
 | 
						|
.TP
 | 
						|
.BI @CFG_STATE@/zserv.api
 | 
						|
The default location of the 
 | 
						|
.B zebra
 | 
						|
unix socket file.
 | 
						|
.TP
 | 
						|
.BI $(PWD)/pimd.log 
 | 
						|
If the 
 | 
						|
.B pimd
 | 
						|
process is config'd to output logs to a file, then you will find this
 | 
						|
file in the directory where you started \fBpimd\fR.
 | 
						|
.SH WARNING
 | 
						|
This man page is intended to be a quick reference for command line
 | 
						|
options.
 | 
						|
.SH DIAGNOSTICS
 | 
						|
The pimd process may log to standard output, to a VTY, to a log
 | 
						|
file, or through syslog to the system logs.
 | 
						|
.SH "SEE ALSO"
 | 
						|
.BR zebra (8),
 | 
						|
.BR vtysh (1)
 | 
						|
.SH BUGS
 | 
						|
\fBpimd\fR is in early development at the moment and is not ready for
 | 
						|
production use.
 | 
						|
 | 
						|
.B pimd
 | 
						|
eats bugs for breakfast. If you have food for the maintainers try
 | 
						|
.BI https://github.com/udhos/qpimd
 | 
						|
.SH AUTHORS
 | 
						|
See
 | 
						|
.BI https://github.com/udhos/qpimd
 | 
						|
for an accurate list of authors.
 | 
						|
 |