nut/docs/man/upscli_add_host_cert.txt
2022-06-29 12:37:36 +02:00

40 lines
1.1 KiB
Text

UPSCLI_ADD_HOST_CERT(3)
=======================
NAME
----
upscli_add_host_cert - Register a security rule for an host.
SYNOPSIS
--------
#include <upsclient.h>
void upscli_add_host_cert(const char* hostname, const char* certname,
int certverify, int forcessl);
DESCRIPTION
-----------
The *upscli_add_host_cert()* function register a security rule associated
to the 'hostname'. All connections to this host use this rule.
The rule is composed of the certificate name 'certname 'expected for
the host, 'certverify' if the certificate must be validated for the host
and 'forcessl' if a secured connection must be used to connect to the host.
Note: This call only functions if upsclient has been compiled with NSS
support. If instead it was compiled with OpenSSL support, this function
contains an empty definition and will take no action when called.
RETURN VALUE
------------
*upscli_add_host_cert()* returns no value.
SEE ALSO
--------
linkman:upscli_init[3], linkman:upscli_connect[3], linkman:upscli_ssl[3],
linkman:upscli_strerror[3], linkman:upscli_upserror[3]