Added occtl.8

doc/Makefile.am

@@ -2,13 +2,18 @@ EXTRA_DIST = design.dia sample.config scripts/ocserv-script sample.passwd \
 	systemd/ocserv.service systemd/ocserv.socket \
 	dbus/org.infradead.ocserv.conf
 
-dist_man_MANS = ocserv.8 ocpasswd.8
+dist_man_MANS = ocserv.8 ocpasswd.8 occtl.8
 
 ocserv.8: ../src/ocserv-args.def
 	-sed 's/@subheading \(.*\)/@*\n@var{\1}\n@*/' $< > "$<".tmp && \
 	@AUTOGEN@ -L../src -DMAN_SECTION=8 -Tagman-cmd.tpl "$<".tmp && \
 	rm -f "$<".tmp
 
+occtl.8: ../src/occtl-args.def
+	-sed 's/@subheading \(.*\)/@*\n@var{\1}\n@*/' $< > "$<".tmp && \
+	@AUTOGEN@ -L../src -DMAN_SECTION=8 -Tagman-cmd.tpl "$<".tmp && \
+	rm -f "$<".tmp
+
 ocpasswd.8: ../src/ocpasswd-args.def
 	-sed 's/@subheading \(.*\)/@*\n@var{\1}\n@*/' $< > "$<".tmp && \
 	@AUTOGEN@ -L../src -DMAN_SECTION=8 -Tagman-cmd.tpl "$<".tmp && \

src/Makefile.am

@@ -4,6 +4,7 @@ AM_CPPFLAGS = -I$(srcdir)/../gl/ -I$(builddir)/../gl/ \
 	-I$(srcdir)/ -I$(builddir)/../ $(LIBOPTS_CFLAGS) \
 	$(LIBPROTOBUF_C_CFLAGS) $(LIBDBUS_CFLAGS)
 
+EXTRA_DIST = occtl-args.def
 BUILT_SOURCES = ocpasswd-args.c ocpasswd-args.h \
 	ocserv-args.c ocserv-args.h ipc.pb-c.c ipc.pb-c.h
 

src/occtl-args.def

@@ -0,0 +1,60 @@
+AutoGen Definitions options;
+prog-name     = occtl;
+prog-title    = "OpenConnect VPN server control";
+prog-desc     = "OpenConnect VPN server control.";
+disable-save;
+no-xlate = opt;
+gnu-usage;
+config-header = config.h;
+long-opts;
+no-misuse-usage;
+short-usage   = "Usage: occtl [options] [command]\nocctl --help for usage instructions.\n";
+explain       = "";
+#include version.inc
+
+detail  = "Openconnect VPN server control (occtl) is a tool to control
+the ocserv VPN server. It uses D-BUS to connect to ocserv.";
+
+copyright = {
+    date  = "2014";
+    owner = "Red Hat";
+    author = "Nikos Mavrogiannopoulos";
+    eaddr  = "openconnect-devel@lists.infradead.org";
+    type  = gplv2;
+};
+
+help-value    = h;
+
+
+doc-section = {
+  ds-type = 'SYNOPSIS';
+  ds-format = 'texi';
+  ds-text   = <<-_EOT_
+Openconnect VPN server control (occtl) is a tool to control
+the ocserv VPN server. It uses D-BUS to connect to ocserv.
+_EOT_;
+};
+
+doc-section = {
+  ds-type = 'DESCRIPTION';
+  ds-format = 'texi';
+  ds-text   = <<-_EOT_
+This a control tool that can be used to send commands to ocserv. When
+called without any arguments the tool can be used interactively, where 
+each command is entered on a command prompt; alternatively the tool
+can be called with the command specified as parameter. In the latter
+case the tool's exit code will reflect the successful execution of
+the command.
+_EOT_;
+};
+
+doc-section = {
+  ds-type = 'IMPLEMENTATION NOTES';
+  ds-format = 'texi';
+  ds-text   = <<-_EOT_
+This tool uses D-BUS to connect to ocserv thus the D-BUS access controls
+should be used to prevent potentially dangerous commands to be sent
+to ocserv by unprivileged users.
+_EOT_;
+};
+

src/occtl-cache.c

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2013 Red Hat
+ * Copyright (C) 2014 Red Hat
  *
  * Author: Nikos Mavrogiannopoulos
  *

src/occtl-pager.c

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2013 Red Hat
+ * Copyright (C) 2014 Red Hat
  *
  * Author: Nikos Mavrogiannopoulos
  *

src/occtl-time.c

@@ -7,7 +7,7 @@
  * Michael K. Johnson.
  *
  * Changes by Albert Cahalan, 2002.
- * Modified for occtl by Nikos Mavrogiannopoulos, 2013.
+ * Modified for occtl by Nikos Mavrogiannopoulos, 2014.
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public

src/occtl.c

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2013 Red Hat
+ * Copyright (C) 2014 Red Hat
  *
  * Author: Nikos Mavrogiannopoulos
  *