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.
102 lines
2.7 KiB
Groff
102 lines
2.7 KiB
Groff
.TH CONNECTION_MASTER_LINK 3 "20 July 2015" "SXMP" "SXMP Library Manual"
|
|
.SH NAME
|
|
connection_master_link \- Create a connection on already accept TCP connection on the master side.
|
|
.br
|
|
connection_link \- Create connection to the master.
|
|
.br
|
|
connection_close \- Close connection.
|
|
.SH SYNOPSIS
|
|
.B #include <sxmp/sxmp.h>
|
|
.sp
|
|
conn_t *connection_master_link(sxhub_t *ssys, int sck, struct in_addr *addr);
|
|
|
|
conn_t *connection_link(sxhub_t *ssys, const char *host,
|
|
int port, const char *SSL_cert, const char *login,
|
|
const char *passwd);
|
|
|
|
int connection_close(conn_t *co);
|
|
|
|
.br
|
|
.sp
|
|
.SH DESCRIPTION
|
|
.B connection_master_link
|
|
will create a connection link based on
|
|
.B ssys
|
|
connections set with already accepted socket fd
|
|
.B sck
|
|
and set ip address of this connection pointed by
|
|
.B addr.
|
|
If
|
|
.B addr
|
|
is NULL, peer address will not set.
|
|
.br
|
|
.B connection_link
|
|
will create a connection link to the master side based on
|
|
.B ssys
|
|
connections set to the master side pointed via hostname or ip address in nul terminated string
|
|
.B host
|
|
running on port number
|
|
.B port
|
|
and send a X.509 certificate located on pathname pointed by
|
|
.B SSL_cert
|
|
trying to authorizated with username pointed by
|
|
.B login
|
|
and password pointed by
|
|
.B passwd
|
|
.br
|
|
.B connection_close
|
|
will close connection pointed by
|
|
.B co
|
|
destroying all allocated structures, including connection link itself.
|
|
.br
|
|
.SH RETURN VALUE
|
|
Upon successful completion, the functions
|
|
.B connection_master_link
|
|
and
|
|
.B connection_link
|
|
will return a valid pointer to the newly created connection link. Otherwise NULL will be returned and
|
|
.B errno will be set with appropriate error.
|
|
.B connection_close
|
|
will return
|
|
.B SNE_SUCCESS
|
|
on successful case, otherwise it will return an error described below.
|
|
.SH ERRORS
|
|
.B SNE_FAILED
|
|
will be returned in case of bad params given.
|
|
.br
|
|
.B SNE_ENOMEM
|
|
will be returned if there are no memory available.
|
|
.br
|
|
.B SNE_BADPROTO
|
|
will be returned if other side has an invalid protocol.
|
|
.B SNE_EPERM
|
|
will be returned if permission was denied.
|
|
.br
|
|
.B SNE_LINKERROR
|
|
or
|
|
.B SNE_LINKBROKEN
|
|
will be returned if connection link is broken i.e. SSL read or write was failed due to the broken TCP connection.
|
|
.br
|
|
.SH BUGS
|
|
Not known yet.
|
|
.SH EXAMPLE
|
|
None.
|
|
.SH APPLICATION USAGE
|
|
None.
|
|
.SH RATIONALE
|
|
Using connection_link on master side with initialized connections set for master functionality will cause memory leaks, use different connections set structure if you need this functionality on the masters side.
|
|
.SH SEE ALSO
|
|
.BI sxhub_setsslserts(3)
|
|
,
|
|
.BI sxhub_create(3)
|
|
,
|
|
.BI sxhub_destroy(3)
|
|
,
|
|
.BI sxmp_init(3)
|
|
.SH COPYRIGHT
|
|
This is a proprietary software. See COPYING for further details.
|
|
.br
|
|
(c) Askele Group 2013-2015 <http://askele.com>
|
|
.SH AUTHOR
|
|
Alexander Vdolainen (vdo@askele.com)
|