Skip to content

Commit

Permalink
Updated .gitignore and checked spelling
Browse files Browse the repository at this point in the history
  • Loading branch information
e3prom committed Jan 13, 2020
1 parent 74bfcc7 commit 45c9927
Show file tree
Hide file tree
Showing 7 changed files with 40 additions and 39 deletions.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,8 @@ Cargo.lock
# local configuration files
*.local.con

# editors
.vscode/

# documentation
docs/_build
2 changes: 1 addition & 1 deletion docs/api/intro.rst
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ can take over a Master router.
To query **rVRRPd** for information, such as the current role of a
running VRRP virtual router, a simple HTTP GET request can be made
to a specific resource path. If the query can be honored, the API
will return a `JSON <https://en.wikipedia.org/wiki/JSON>`_ formated
will return a `JSON <https://en.wikipedia.org/wiki/JSON>`_ formatted
body response with all the attributes and values corresponding to
your query.

Expand Down
2 changes: 1 addition & 1 deletion docs/api/reference.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,5 @@ API Reference
=============

.. todo::
The API is still under **active** development. The reference documention will
The API is still under **active** development. The reference documentation will
be available when the API will be stable and ready for production use.
8 changes: 4 additions & 4 deletions docs/config/install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ a stable release of the daemon and its utilities:

Building Dependencies
^^^^^^^^^^^^^^^^^^^^^
To build **rVRRPd** from source you must have several programs and libraries installed on your system (preferrably system-wide):
To build **rVRRPd** from source you must have several programs and libraries installed on your system (preferably system-wide):
* Rust `Cargo <https://doc.rust-lang.org/cargo/getting-started/installation.html>`_ (v1.33.0 or later), \
to build the project and its related dependencies (crates).
* The `OpenSSL <https://www.openssl.org/>`_ development headers
Expand Down Expand Up @@ -126,7 +126,7 @@ using the ``-m1`` and ``-m2`` switches, respectively.

.. warning::

The daemon requires root privileges to run succesfully. The daemon must
The daemon requires root privileges to run successfully. The daemon must
have access to raw sockets, and to privileged kernel functions to create
virtual interfaces, IP addresses and routes.

Expand All @@ -142,7 +142,7 @@ Binary Package Installation
---------------------------
**rVRRPd** could also be installed directly from binaries packages.
This is the recommended way of installing the VRRP daemon for production uses
as we are testing every executables for stability prior to shipping the
as we are testing every executable for stability prior to shipping the
releases to the public.

Getting Binary Archives
Expand Down Expand Up @@ -198,7 +198,7 @@ Running
^^^^^^^
.. warning::

The daemon requires root privileges to run succesfully. The daemon must
The daemon requires root privileges to run successfully. The daemon must
have access to raw sockets, and to privileged kernel functions to create
virtual interfaces, IP addresses and routes.

Expand Down
4 changes: 2 additions & 2 deletions docs/config/intro.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ use the Client API extensively.
The **rVRRPd** daemon runs one ``virtual-router`` per ``interface, group``
pair, which means you can configure the same VRRP groups id or
``virtual-router`` id across several physical interfaces. The daemon can
scale to hundreads if not thousands of active virtual-routers if the CPU
scale to hundreds if not thousands of active virtual-routers if the CPU
and memory resources permit.

The initial :ref:`developer <developers>` of **rVRRPd** has chosen to build the daemon
Expand All @@ -41,7 +41,7 @@ without the hassles commonly found in commercial solutions.

This project wouldn't be live without the dedication of its developers, and
the open source community. Any `contributions <https://github.com/e3prom/rVRRPd>`_
are greatly welcome, and will help us developping new features and a more
are greatly welcome, and will help us developing new features and a more
stable and secure implementation.

.. _developers:
Expand Down
52 changes: 26 additions & 26 deletions docs/config/reference.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ General Directives
debug
^^^^^
:Description: The verbose or debugging level.
:Value type: decimal
:Value type: Decimal
:Default: 0

The ``debug`` directive sets the debugging (or verbosity) level
Expand All @@ -25,7 +25,7 @@ debug
time_zone
^^^^^^^^^
:Description: The timestamps reference time zone
:Value type: string
:Value type: String
:Default: local

The ``time_zone`` directive sets the reference time zone for
Expand All @@ -41,7 +41,7 @@ time_zone
time_format
^^^^^^^^^^^
:Description: The timestamps time format
:Value type: string
:Value type: String
:Default: disabled

The ``time_format`` directive sets the reference time format for
Expand All @@ -50,13 +50,13 @@ time_format
Possible values are:
* ``disabled`` for no particular time format (use the default
time format)
* ``short`` for a shorthened, more concise time format
* ``short`` for a shortened, more concise time format
* ``rfc2822`` for the standard `RFC2822 <https://tools.ietf.org/html/rfc2822>`_, Internet Time Format

pid
^^^
:Description: The daemon's PID file path
:Value type: string
:Value type: String
:Default: /var/run/rvrrpd.pid

The ``pid`` directive sets the full or relative path to the daemon's
Expand All @@ -65,7 +65,7 @@ pid
working_dir
^^^^^^^^^^^
:Description: The daemon's working directory
:Value type: string
:Value type: String
:Default: /tmp

The ``working_dir`` directive sets the daemon's working directory.
Expand All @@ -74,7 +74,7 @@ working_dir
main_log
^^^^^^^^
:Description: Path to the daemon's main log file
:Value type: string
:Value type: String
:Default: /var/log/rvrrpd.log

The ``main_log`` directive sets the path to the daemon's main log file.
Expand All @@ -93,7 +93,7 @@ error_log
client_api
^^^^^^^^^^
:Description: Client API interface type
:Value type: string
:Value type: String
:Default: http

The ``client_api`` directive sets the Client API interface type.
Expand All @@ -111,7 +111,7 @@ Virtual Routers Directives
group
^^^^^^
:Description: Virtual Router Group ID (VRID)
:Value type: integer
:Value type: Integer
:Default: *none*

The ``group`` directive sets the VRRP group id or virtual-router id (VRID).
Expand All @@ -124,7 +124,7 @@ group
interface
^^^^^^^^^
:Description: Interface to run VRRP on
:Value type: string
:Value type: String
:Default: *none*

The ``interface`` directive sets the VRRP virtual-router's interface.
Expand All @@ -133,7 +133,7 @@ interface
vip
^^^
:Description: Virtual IP Address
:Value type: string
:Value type: String
:Default: *none*

The ``vip`` directive sets the VRRP standby address or virtual-router
Expand All @@ -142,7 +142,7 @@ vip
priority
^^^^^^^^
:Description: Virtual Router Priority
:Value type: integer
:Value type: Integer
:Default: 100

The ``priority`` directive sets the virtual-router VRRP priority.
Expand All @@ -155,7 +155,7 @@ priority
preemption
^^^^^^^^^^
:Description: Preemption Support
:Value type: boolean
:Value type: Boolean
:Default: false

The ``preemption`` directive sets if preemption is enabled. By default,
Expand All @@ -172,7 +172,7 @@ preemption
auth_type
^^^^^^^^^
:Description: Authentication Type
:Value type: string
:Value type: String
:Default: *none*

The ``auth_type`` directive sets the VRRP group's authentication type.
Expand All @@ -184,17 +184,17 @@ auth_type
Valid values are:
* ``rfc2338-simple`` for `RFC2338 <https://tools.ietf.org/html/rfc2338>`_
Simple Password Authentication.
* ``p0-t8-sha256`` for prioprietary P0 Authentication. Uses a
SHA256 HMAC of the VRRP messsages. This type provides both messages
* ``p0-t8-sha256`` for proprietary P0 Authentication. Uses a
SHA256 HMAC of the VRRP messages. This type provides both messages
authentication and integrity.
* ``p1-t8-shake256`` for prioprietary P1 Authentication. Uses the
* ``p1-t8-shake256`` for proprietary P1 Authentication. Uses the
SHAKE256 Extendable-Output Function (XOF). This type provides both
messages authentication and integrity.

auth_secret
^^^^^^^^^^^
:Description: Authentication Secret
:Value type: string
:Value type: String
:Default: *none*

The ``auth_secret`` directive sets the VRRP group's authentication secret
Expand All @@ -209,7 +209,7 @@ auth_secret
rfc3768
^^^^^^^
:Description: RFC3768 Compatibility Warning Flag
:Value type: boolean
:Value type: Boolean
:Default: true

The ``rfc3768`` directive allow you to force the compatibility flag.
Expand All @@ -234,7 +234,7 @@ rfc3768
netdrv
^^^^^^
:Description: Network Driver
:Value type: string
:Value type: String
:Default: ioctl

The ``netdrv`` directive specify which network driver to uses for the
Expand Down Expand Up @@ -262,7 +262,7 @@ netdrv
vifname
^^^^^^^^
:Description: Virtual Interface Name
:Value type: string
:Value type: String
:Default: standby\<*group-id*\>

The ``vifname`` directive sets the virtual-router's virtual interface name.
Expand All @@ -273,7 +273,7 @@ vifname
socket_filter
^^^^^^^^^^^^^
:Description: Socket Filter Support
:Value type: string
:Value type: String
:Default: true

The ``socket_filter`` directive allow you to enable or disable the
Expand All @@ -296,7 +296,7 @@ API Directives
users
^^^^^
:Description: API Users
:Value type: list of strings
:Value type: List of Strings
:Default: *none*

The ``users`` directive lists the user accounts authorized for the
Expand All @@ -306,7 +306,7 @@ users
secret
^^^^^^
:Description: API Secret
:Value type: string
:Value type: String
:Default: 128-bits random number

The ``secret`` directive sets the API secret. This secret is used for
Expand All @@ -331,7 +331,7 @@ secret
host
^^^^
:Description: Listening Host
:Value type: string
:Value type: String
:Default: 0.0.0.0:7080

The ``host`` directive sets the IP address(es) and port for the
Expand All @@ -345,7 +345,7 @@ host
tls
^^^
:Description: Transport Layer Security (TLS) Support
:Value type: boolean
:Value type: Boolean
:Default: false

The ``tls`` directive allow you to enable or disable support for
Expand Down
8 changes: 3 additions & 5 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,16 +16,16 @@ Networking (SDN) applications.

Features
--------
rVRRPd supports a number of innovative features, some of which allow for a more efficient and secure operation of the protocol:
rVRRPd supports a number of innovative features:
- Secure software architecture leveraging the `Rust <https://www.rust-lang.org/>`_ programming language
- Highly scalable; up to several hundreads of concurrent VRRP groups
- Highly scalable; up to several hundreds of concurrent VRRP groups
- Supports standard `RFC3768 <https://tools.ietf.org/html/rfc3768>`_ and \
`RFC2338 <https://tools.ietf.org/html/rfc2338>`_, ``Simple Password`` authentication
- Supports additional :ref:`proprietary authentication
<config/reference:auth_type>` methods
- Supports multiple operating systems and processors architectures
- Provides a RESTful Client Application Programming Interface (API)
- Provides a plaintext HTTP or SSL/TLS HTTPS interface to the Client API
- Provides a plain-text HTTP or SSL/TLS HTTPS interface to the Client API
- Leverages additional features such as ``macvlan`` and \
``Linux Socket Filters``

Expand Down Expand Up @@ -74,5 +74,3 @@ responses.
Additional resources
--------------------
* `Github Repository <https://github.com/e3prom/rVRRPd>`_
* :ref:`genindex`
* :ref:`search`

0 comments on commit 45c9927

Please sign in to comment.