NAME
upscli_init - Initialize upsclient module specifying security properties.
SYNOPSIS
|
Note
|
Two NUT websites
This version of the page reflects NUT release v2.7.4 with codebase commited 0b4bfddbc at 2016-03-09T14:24:11+01:00 Options, features and capabilities in current development (and future releases) are detailed on the main site and may differ from ones described here. |
#include <upsclient.h>int upscli_init(int certverify, const char *certpath,
const char *certname, const char *certpasswd);DESCRIPTION
The upscli_init() function initialize upsclient module and set many SSL-related properties: certverify to 1 makes certificate verification required for all SSL connections and certpath is the location of certificate database.
If compiled with OpenSSL, certpath refers to a .pem file containing certificates and if compiled with NSS, certpath refers to a directory containing database files.
If compiled with NSS and using SSL, you can specify certname the name of the certificate to send to upsd and certpasswd the password used to decrypt certificate private key.
You can call upscli_add_host_cert(3) to register specific host security policy before initialize connections to them.
You must call upscli_cleanup(3) when exiting application.
RETURN VALUE
The upscli_init() function returns 1 on success, or -1 if an error occurs.