delta/openvswitch.git/utilities/ovs-pki.8.in, branch master

Documentation: Convert multiple manpages to ReST.

2019-12-02T20:35:42+00:00

Tested-by: Numan Siddique 
Acked-by: Numan Siddique 
Signed-off-by: Ben Pfaff

manpages: Include ovs.tmac in most man roots.

2018-10-30T14:24:55+00:00

This allows to not redefine common macroses in every single
file and allowes using things like .EX without warying about
compatibility.
manpages.mk updated automatically.

Files that are already complete pages (i.e. has no *.in sources)
wasn't touched, because this will require additional file
manipulations and changes in makefiles/specs without serious
profit.

Signed-off-by: Ilya Maximets 
Signed-off-by: Ben Pfaff

ovs-pki: add option to suppress generated id in common name

2017-05-04T22:19:45+00:00

For some applications, it is desirable to have full control of
the common name field in generated certificates.  Add a command-line
option to suppress appending " id:" to the user-
specified name.

Signed-off-by: Lance Richardson 
Signed-off-by: Ben Pfaff

ovs-controller: Rename test-controller and do not install or package.

2013-11-03T04:06:45+00:00

Too many users have incorrectly assumed that ovs-controller is a necessary
or desirable part of an Open vSwitch deployment.  This commit should fix
the problem by renaming it test-controller and removing it from the
default install and from packaging.

Signed-off-by: Ben Pfaff

manpages: Put version number instead of date at bottom of page.

2013-01-04T17:02:06+00:00

We're really good about keeping manpages up to date, but terrible at
updating the dates at the bottom of the manpages.  So, instead of using
manually updated dates, this commit switches to using automatically updated
version numbers.

We can only use automatically updated version numbers for manpages that
we preprocess, that is, the manpages whose sources end with ".in".  This
excludes a couple of manpages that don't actually get installed with OVS,
such as the manpages for ovs-ctl and ovsdb-idlc.  This commit doesn't
change those manpages.  It does change the ovs-bugtool manpage to one that
is preprocessed so that we can use the version there.

Signed-off-by: Ben Pfaff 
Acked-by: Ethan Jackson

ovs-pki: Improve manpage style.

2012-08-06T16:36:19+00:00

The usual manpage style is to write metasyntactic variable names in
lowercase, so this commit adopts that consistently.

Signed-off-by: Ben Pfaff

ovs-pki: Remove "online PKI" features and ovs-pki-cgi.

2012-08-06T16:36:19+00:00

Debian bug #683665, Red Hat bug #845350, and CVE-2012-3449 all claim that
ovs-pki's "incoming" directory is a security vulnerability.  I do not think
that this is the case, but I do not know of any users for this feature, so
on balance I prefer to remove it and the ovs-pki-cgi program associated
with it, just to be sure.

CVE-2012-3449.
Bug-report: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=683665
Bug-report: https://bugzilla.redhat.com/show_bug.cgi?id=84535
Reported-by: Andreas Beckmann 
Signed-off-by: Ben Pfaff

docs: Consistently format each form of an option on a separate line.

2012-02-27T17:24:15+00:00

Most options were formatted like this in the manpage:

    -o ARGUMENT
    --option ARGUMENT

but a few were formatted like this:

    -o ARGUMENT | --option ARGUMENT

or even as:

    -o, --option ARGUMENT

The former seems least confusing to me, so switch all of the documentation
to this format.

Signed-off-by: Ben Pfaff

ovs-openflowd: Rename test-openflowd and move to "tests" directory.

2011-06-07T16:40:53+00:00

Too many users thought that they needed to run ovs-openflowd at the same
time as ovs-vswitchd.  I hope that this change discourages them.

doc: Change "-" to "\-" in appropriate places.

2010-06-29T21:29:40+00:00

The newer manpages tend to get this right more often than the old ones,
but there were lots of places that needed to be corrected.