summaryrefslogtreecommitdiff
path: root/doc/vtysh.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/vtysh.texi')
-rw-r--r--doc/vtysh.texi52
1 files changed, 30 insertions, 22 deletions
diff --git a/doc/vtysh.texi b/doc/vtysh.texi
index de59f7f7..b4c3fcb7 100644
--- a/doc/vtysh.texi
+++ b/doc/vtysh.texi
@@ -1,5 +1,4 @@
@node VTY shell
-@comment node-name, next, previous, up
@chapter VTY shell
@command{vtysh} is integrated shell of Quagga software.
@@ -14,6 +13,14 @@ authentication settings.
Currently, vtysh.conf has only two commands.
+@menu
+* VTY shell username::
+* VTY shell integrated configuration::
+@end menu
+
+@node VTY shell username
+@section VTY shell username
+
@deffn {Command} {username @var{username} nopassword} {}
With this set, user foo does not need password authentication for user vtysh.
@@ -26,28 +33,29 @@ of unix groups and the --enable-vty-group configure option.
@end deffn
-@deffn {Command} {write-conf daemon} {}
-Instruct daemons to write out their config files when 'write file'
-is issued.
-@end deffn
-@deffn {Command} {write-conf integrated} {}
+@node VTY shell integrated configuration
+@section
+
+@deffn {Command} {service integrated-vtysh-config} {}
Write out integrated Quagga.conf file when 'write file' is issued.
-@end deffn
-This command controls the behaviour of vtysh when it is told
-to write out the configuration. If @command{write-conf integrated} is
-set, the daemon will write out a Quagga.conf with all daemons' commands
-integrated into it. If @command{write-conf daemon} is set, vtysh
-will instruct each daemon to write out their config files.
+This command controls the behaviour of vtysh when it is told to write out
+the configuration. Per default, vtysh will instruct each daemon to write
+out their own config files when @command{write file} is issued. However, if
+@command{service integrated-vtysh-config} is set, when @command{write file}
+is issued, vtysh will instruct the daemons will write out a Quagga.conf with
+all daemons' commands integrated into it.
Vtysh per default behaves as if @command{write-conf daemon} is set. Note
-that both may be set at same time if one wishes to have both
-Quagga.conf and daemon specific files written out. Further, note that the
-daemons are hard-coded to first look for the integrated Quagga.conf
-file before looking for their own file.
-
-We recommend you do not mix the use of the two types of files.
-Further, it is better not to use the integrated Quagga.conf file,
-as any syntax error in it can lead to /all/ of your daemons being unable
-to start up. Per daemon files are more robust as impact of errors in
-configuration are limited to the daemon in whose file the error is made.
+that both may be set at same time if one wishes to have both Quagga.conf and
+daemon specific files written out. Further, note that the daemons are
+hard-coded to first look for the integrated Quagga.conf file before looking
+for their own file.
+
+We recommend you do not mix the use of the two types of files. Further, it
+is better not to use the integrated Quagga.conf file, as any syntax error in
+it can lead to /all/ of your daemons being unable to start up. Per daemon
+files are more robust as impact of errors in configuration are limited to
+the daemon in whose file the error is made.
+
+@end deffn