Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OCCTL(8)		    System Manager's Manual		      OCCTL(8)

NAME
       occtl - OpenConnect VPN server control tool

SYNOPSIS
       occtl ['COMMAND']

DESCRIPTION
       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  com-
       mand.

OPTIONS
       -s, --socket-file=FILE
	      Specify  the  server's  occtl  socket  file. This	option is only
	      needed if	you have multiple servers.

       -j, --json
	      Output will be JSON formatted. This option can only be used with
	      non-interactive output, e.g., 'occtl --json show users'.

       -n, --no-pager
	      No pager will be used over output	data.

       --debug
	      Provide more verbose information in some commands.

       -h, --help
	      Display usage information	and exit.

       -v, --version
	      Output version of	program	and exit.

EXIT STATUS
       0      Successful program execution.

       1      The operation failed or the command syntax was not valid.

IMPLEMENTATION NOTES
       This tool uses unix domain sockets to connect to	ocserv.

EXAMPLES
       The tool	can be run interactively when run with no arguments. When  ar-
       guments are given they are interpreted as commands. For example:

	   $ occtl show	users

       Any  command line arguments to be used as options must precede the com-
       mand (if	any), as shown below.

	   $ occtl --json show users

AUTHORS
       Written by Nikos	Mavrogiannopoulos. Many	people have contributed	to it.

REPORTING BUGS
       Issue tracker: https://gitlab.com/openconnect/ocserv/-/issues

COPYRIGHT
       Copyright (C) 2013-2024 Nikos Mavrogiannopoulos and others, all	rights
       reserved.  This	program	is released under the terms of the GNU General
       Public License, version 2.

SEE ALSO
       ocserv(8), ocpasswd(8)

				  April	2024			      OCCTL(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=occtl&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help