You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
libsxmp/man/sxhub_setsslserts.3

64 lines
1.7 KiB
Groff

.TH SXHUB_SETSSLSERTS 3 "20 July 2015" "SXMP" "SXMP Library Manual"
.SH NAME
sxhub_setsslserts \- Setup root public certificate to check up, and also setups key and public certificate used for connections set
.br
.SH SYNOPSIS
.B #include <sxmp/sxmp.h>
.sp
int sxhub_setsslserts(sxhub_t *ssys, const char *rootca,
const char *certpem, const char *certkey);
.br
.sp
.SH DESCRIPTION
.B sxhub_setsslserts
will setup root public certificate and private key and public certificate used to run connections set.
This is required always, see below for more information.
.br
.sp
This function just set a pathname of the certificates for
.BI ssys
where
.BI rootca
is a pathname to the public X.509 certificate
.BI certpem
is a your own X.509 certificate and
.BI certkey
is a your own key for this certificate. Therefore,
.BI certpem
and
.BI certkey
might be a single file.
.br
.SH RETURN VALUE
Will return 0 on success or errors below.
.br
.SH ERRORS
.B EINVAL
Invalid pointer given.
.br
.B ENOMEM
There are no available memory for operation.
.br
.SH BUGS
None known yet, but name is historically wrong it should be called sxhub_setsslcerts, btw there are many
code was written with this mistake.
.SH EXAMPLE
None.
.SH APPLICATION USAGE
Call this function *always* before linking a connection. Non master link will always avoid non-root certificate and key,
since you will required to pass it via call.
.SH RATIONALE
None.
.SH SEE ALSO
.BI sxlink_connect(3)
,
.BI sxlink_master_accept(3)
.SH COPYRIGHT
This software licensed under GNU LGPL v3. See COPYING for further details.
.br
(c) Askele Group 2013-2015 <http://askele.com>
.SH AUTHOR
Alexander Vdolainen (vdo@askele.com)