http_listen_host
Starts, stops and retrieves the state of a user-defined HTTP listener
integer http_listen_host
(in interface_address varchar,
in action integer,
[in options vector]);
Description
This function requires dba privileges.
This function is used to start, stop or lookup the state of user-defined HTTP and HTTPS listeners.
The return value is 0 or 1 and indicates state of the listener, 1 for started and 0 for stopped.
Parameters
interface_address – IP address of interface to be
started, stopped or queried for its current state.
action – Can only take one of the following integer values:
- 0 - start
- 1 - stop
- 2 - query state
options – An array of name-value pairs for
setting up a HTTPS listeners. This parameter only used for starting HTTPS
listeners, and nothing more. The available options are:
- https_cv - certificate authority file for verification.
- https_cert - server certificate.
- https_key server private key.
- https_cv_depth - depth of chain for CA verification.
The certificate and key are mandatory for HTTPS listeners, but the
others are optional. They are similar to the SSLCertificate, SSLPrivateKey,
X509ClientVerifyCAFile, X509ClientVerifyDepth Virtuoso INI file settings.
Return Types
The return type is integer, and will be either 0 or 1 to indicate the
state of the listener, 1 for started and 0 for stopped.
Examples
Starting/stopping and state retrival of a listener
SQL> http_listen_host ('127.0.0.1:7780', 0);
SQL> select http_listen_host ('127.0.0.1:7780', 2);
callret
VARCHAR
_______________________________________________________________________________
1
1 Rows. -- 1 msec.
SQL> http_listen_host ('127.0.0.1:7780', 1);
SQL> select http_listen_host ('127.0.0.1:7780', 2);
callret
VARCHAR
_______________________________________________________________________________
0
1 Rows. -- 1 msec.