summaryrefslogtreecommitdiffstats
path: root/doc/vtysh.1.in
blob: ba8f3df72021653e9177af43f0d0f950c3b257a1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
.TH VTYSH 1 "27 July 2006" "@PACKAGE_FULLNAME@ VTY shell" "Version @PACKAGE_VERSION@"
.SH NAME
vtysh \- a integrated shell for @PACKAGE_FULLNAME@.
.SH SYNOPSIS
.B vtysh
[
.B \-b
]
.br
.B vtysh
[
.B \-E
] [
.B \-d
.I daemon
]
] [
.B \-c
.I command
]
.SH DESCRIPTION
.B vtysh
is a integrated shell for
.B @PACKAGE_FULLNAME@
routing engine.
.SH OPTIONS
Options available for the
.B vtysh
command:
.IP "\fB\-b, \-\-boot\fP"
Execute boot startup configuration. It makes sense only if integrated config
file is in use (not default in @PACKAGE_FULLNAME@). See Info file
\fB@PACKAGE_NAME@\fR for more info.
.IP "\fB\-c, \-\-command \fIcommand\fP"
Specify command to be executed under batch mode. It behaves like -c option in
any other shell -
.I command
is executed and
.B vtysh
exits.

It's useful for gathering info from @PACKAGE_FULLNAME@ daemons or reconfiguring
daemons from inside shell scripts, etc.
Note that multiple commands may be executed by using more than one
-c option and/or embedding linefeed characters inside the
.I command
string.
.IP "\fB\-d, \-\-daemon \fIdaemon_name\fP"
Specify which daemon to connect to.  By default,
.B vtysh
attempts to connect to all @PACKAGE_FULLNAME@ daemons running on the system.  With this
flag, one can specify a single daemon to connect to instead.  For example,
specifying '-d ospfd' will connect only to ospfd.  This can be particularly
useful inside scripts with -c where the command is targeted for a single daemon.
.IP "\fB\-e, \-\-execute \fIcommand\fP"
Alias for -c. It's here only for compatibility with Zebra routing software and
older Frr versions. This will be removed in future.
.IP "\fB\-E, \-\-echo\fP"
When the -c option is being used, this flag will cause the standard
.B vtysh
prompt and command to be echoed prior to displaying the results.
This is particularly useful to separate the results
when executing multiple commands.
.IP "\fB\-h, \-\-help\fP"
Display a usage message on standard output and exit.
.SH ENVIRONMENT VARIABLES
.IP "\fBVTYSH_PAGER\fR"
This should be the name of the pager to use. Default is \fBmore\fR.
.SH FILES
.TP
.BI @CFG_SYSCONF@/vtysh.conf
The default location of the 
.B vtysh
config file.
.TP
.BI @CFG_SYSCONF@/frr.conf
The default location of the integrated @PACKAGE_FULLNAME@ routing engine config file
if integrated config file is in use (not default).
.TP
.BI ${HOME}/.history_frr
Location of history of commands entered via cli
.SH WARNING
This man page is intended to be a quick reference for command line
options. The definitive document is the Info file \fB@PACKAGE_NAME@\fR.
.SH "SEE ALSO"
.BR bgpd (8),
.BR ripd (8),
.BR ripngd (8),
.BR ospfd (8),
.BR ospf6d (8),
.BR isisd (8),
.BR zebra (8)
.SH BUGS
.B vtysh
eats bugs for breakfast. If you have food for the maintainers try 
.BI @PACKAGE_BUGREPORT@
.SH AUTHORS
See
.BI http://www.zebra.org
and
.BI @PACKAGE_URL@
or the Info file for an accurate list of authors.