\hypertarget{group__Ecore__Con__SSL__Group}{\section{Ecore Connection S\+S\+L Functions}
\label{group__Ecore__Con__SSL__Group}\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
}


Functions that operate on Ecore connection objects pertaining to S\+S\+L.  


\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Ecore__Con__SSL__Group_gaa5d2328b414bd5ffb01466b853c45709}{ecore\+\_\+con\+\_\+ssl\+\_\+available\+\_\+get} (void)
\begin{DoxyCompactList}\small\item\em Returns if S\+S\+L support is available. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Ecore__Con__SSL__Group_ga3294828c19a38913d0f9c5c5aff55ebb}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cert\+\_\+add} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj, const char $\ast$cert)
\begin{DoxyCompactList}\small\item\em Add an ssl certificate for use in ecore\+\_\+con functions. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Ecore__Con__SSL__Group_gabbe0ebeb3476ec127189daac87f0ca30}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+privkey\+\_\+add} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj, const char $\ast$key\+\_\+file)
\begin{DoxyCompactList}\small\item\em Add an ssl private key for use in ecore\+\_\+con functions. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Ecore__Con__SSL__Group_ga13db8718a5ce29e31b6e8cd8efeed3e7}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+crl\+\_\+add} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj, const char $\ast$crl\+\_\+file)
\begin{DoxyCompactList}\small\item\em Add an ssl C\+R\+L for use in ecore\+\_\+con functions. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Ecore__Con__SSL__Group_gada17e3b9022fc710a4d235f3c45b1dfa}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cafile\+\_\+add} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj, const char $\ast$ca\+\_\+file)
\begin{DoxyCompactList}\small\item\em Add an ssl C\+A file for use in ecore\+\_\+con functions. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} void \hyperlink{group__Ecore__Con__SSL__Group_ga2fbf3430cf98dfdd2a7d5e384edf56c4}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj)
\begin{DoxyCompactList}\small\item\em Enable certificate verification on a server object. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} void \hyperlink{group__Ecore__Con__SSL__Group_ga4232e0374d4e134b0f97e52f8e92cf2e}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+basic} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj)
\begin{DoxyCompactList}\small\item\em Enable hostname-\/based certificate verification on a server object. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} void \hyperlink{group__Ecore__Con__SSL__Group_ga748a19f336e02cf2b89566de304197d0}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj, const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Set the hostname to verify against in certificate verification. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} const char $\ast$ \hyperlink{group__Ecore__Con__SSL__Group_ga1f864cccb1d466d99c50d8b5cf0a240c}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+get} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get the hostname to verify against in certificate verification. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Ecore__Con__SSL__Group_gae2013a54a47f6e168fb5049204d5ceed}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+upgrade} (Ecore\+\_\+\+Con\+\_\+\+Server $\ast$obj, Ecore\+\_\+\+Con\+\_\+\+Type ssl\+\_\+type)
\begin{DoxyCompactList}\small\item\em Upgrade a connection to a specified level of encryption. \end{DoxyCompactList}\item 
\hyperlink{group__Eina__Types__Group_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Ecore__Con__SSL__Group_ga97c04d6932b161b25ae43fe9a6f807e4}{ecore\+\_\+con\+\_\+ssl\+\_\+client\+\_\+upgrade} (Ecore\+\_\+\+Con\+\_\+\+Client $\ast$obj, Ecore\+\_\+\+Con\+\_\+\+Type ssl\+\_\+type)
\begin{DoxyCompactList}\small\item\em Upgrade a connection to a specified level of encryption. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Functions that operate on Ecore connection objects pertaining to S\+S\+L. 



\subsection{Function Documentation}
\hypertarget{group__Ecore__Con__SSL__Group_gaa5d2328b414bd5ffb01466b853c45709}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+available\+\_\+get@{ecore\+\_\+con\+\_\+ssl\+\_\+available\+\_\+get}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+available\+\_\+get@{ecore\+\_\+con\+\_\+ssl\+\_\+available\+\_\+get}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+available\+\_\+get}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} int ecore\+\_\+con\+\_\+ssl\+\_\+available\+\_\+get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_gaa5d2328b414bd5ffb01466b853c45709}


Returns if S\+S\+L support is available. 

\begin{DoxyReturn}{Returns}
1 if S\+S\+L is available and provided by gnutls, 2 if provided by openssl, 0 if it is not available. 
\end{DoxyReturn}


Referenced by ecore\+\_\+ipc\+\_\+ssl\+\_\+available\+\_\+get().

\hypertarget{group__Ecore__Con__SSL__Group_ga3294828c19a38913d0f9c5c5aff55ebb}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cert\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cert\+\_\+add}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cert\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cert\+\_\+add}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cert\+\_\+add}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Eina\+\_\+\+Bool} ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cert\+\_\+add (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj, }
\item[{const char $\ast$}]{cert}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_ga3294828c19a38913d0f9c5c5aff55ebb}


Add an ssl certificate for use in ecore\+\_\+con functions. 

Use this function to add a S\+S\+L P\+E\+M certificate. Simply specify the cert here to use it in the server object for connecting or listening. If there is an error loading the certificate, an error will automatically be logged. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
{\em cert} & The path to the certificate. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E} if the file cannot be loaded, otherwise {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+U\+E}. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{ecore_con_server_example_8c-example}{ecore\+\_\+con\+\_\+server\+\_\+example.\+c}.\end{Desc}


References E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+L\+O\+A\+D\+\_\+\+C\+E\+R\+T, E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+U\+S\+E\+\_\+\+M\+I\+X\+E\+D, E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Ecore__Con__SSL__Group_gabbe0ebeb3476ec127189daac87f0ca30}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+privkey\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+privkey\+\_\+add}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+privkey\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+privkey\+\_\+add}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+privkey\+\_\+add}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Eina\+\_\+\+Bool} ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+privkey\+\_\+add (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj, }
\item[{const char $\ast$}]{key\+\_\+file}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_gabbe0ebeb3476ec127189daac87f0ca30}


Add an ssl private key for use in ecore\+\_\+con functions. 

Use this function to add a S\+S\+L P\+E\+M private key Simply specify the key file here to use it in the server object for connecting or listening. If there is an error loading the key, an error will automatically be logged. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
{\em key\+\_\+file} & The path to the key file. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E} if the file cannot be loaded, otherwise {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+U\+E}. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{ecore_con_server_example_8c-example}{ecore\+\_\+con\+\_\+server\+\_\+example.\+c}.\end{Desc}


References E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+L\+O\+A\+D\+\_\+\+C\+E\+R\+T, E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+U\+S\+E\+\_\+\+M\+I\+X\+E\+D, E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Ecore__Con__SSL__Group_ga13db8718a5ce29e31b6e8cd8efeed3e7}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+crl\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+crl\+\_\+add}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+crl\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+crl\+\_\+add}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+crl\+\_\+add}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Eina\+\_\+\+Bool} ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+crl\+\_\+add (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj, }
\item[{const char $\ast$}]{crl\+\_\+file}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_ga13db8718a5ce29e31b6e8cd8efeed3e7}


Add an ssl C\+R\+L for use in ecore\+\_\+con functions. 

Use this function to add a S\+S\+L P\+E\+M C\+R\+L file Simply specify the C\+R\+L file here to use it in the server object for connecting or listening. If there is an error loading the C\+R\+L, an error will automatically be logged. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
{\em crl\+\_\+file} & The path to the C\+R\+L file. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E} if the file cannot be loaded, otherwise {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+U\+E}. 
\end{DoxyReturn}


References E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+L\+O\+A\+D\+\_\+\+C\+E\+R\+T, E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+U\+S\+E\+\_\+\+M\+I\+X\+E\+D, E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Ecore__Con__SSL__Group_gada17e3b9022fc710a4d235f3c45b1dfa}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cafile\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cafile\+\_\+add}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cafile\+\_\+add@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cafile\+\_\+add}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cafile\+\_\+add}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Eina\+\_\+\+Bool} ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+cafile\+\_\+add (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj, }
\item[{const char $\ast$}]{ca\+\_\+file}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_gada17e3b9022fc710a4d235f3c45b1dfa}


Add an ssl C\+A file for use in ecore\+\_\+con functions. 

Use this function to add a S\+S\+L P\+E\+M C\+A file. Simply specify the file here to use it in the server object for connecting or listening. If there is an error loading the C\+As, an error will automatically be logged. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
{\em ca\+\_\+file} & The path to the C\+A file. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E} if the file cannot be loaded, otherwise {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+U\+E}. 
\end{DoxyReturn}
\begin{DoxyNote}{Note}
since 1.\+2, this function can load directores 
\end{DoxyNote}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{ecore_con_client_example_8c-example}{ecore\+\_\+con\+\_\+client\+\_\+example.\+c}.\end{Desc}


References E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+L\+O\+A\+D\+\_\+\+C\+E\+R\+T, E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+U\+S\+E\+\_\+\+M\+I\+X\+E\+D, E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Ecore__Con__SSL__Group_ga2fbf3430cf98dfdd2a7d5e384edf56c4}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify}]{\setlength{\rightskip}{0pt plus 5cm}void ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_ga2fbf3430cf98dfdd2a7d5e384edf56c4}


Enable certificate verification on a server object. 

Call this function on a server object before main loop has started to enable verification of certificates against loaded certificates. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
\end{DoxyParams}
\begin{Desc}
\item[Examples\+: ]\par
\hyperlink{ecore_con_client_example_8c-example}{ecore\+\_\+con\+\_\+client\+\_\+example.\+c}.\end{Desc}


References E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Ecore__Con__SSL__Group_ga4232e0374d4e134b0f97e52f8e92cf2e}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+basic@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+basic}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+basic@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+basic}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+basic}]{\setlength{\rightskip}{0pt plus 5cm}void ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+basic (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_ga4232e0374d4e134b0f97e52f8e92cf2e}


Enable hostname-\/based certificate verification on a server object. 

Call this function on a server object before main loop has started to enable verification of certificates using O\+N\+L\+Y their hostnames. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
\end{DoxyParams}
\begin{DoxyNote}{Note}
This function has no effect when used on a listening server created by ecore\+\_\+con\+\_\+server\+\_\+add 
\end{DoxyNote}
\begin{DoxySince}{Since}
1.\+1 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Ecore__Con__SSL__Group_ga748a19f336e02cf2b89566de304197d0}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set}]{\setlength{\rightskip}{0pt plus 5cm}void ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj, }
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_ga748a19f336e02cf2b89566de304197d0}


Set the hostname to verify against in certificate verification. 

Sometimes the certificate hostname will not match the hostname that you are connecting to, and will instead match a different name. An example of this is that if you connect to talk.\+google.\+com to use Google Talk, you receive Google's certificate for gmail.\+com. This certificate should be trusted, and so you must call this function with \char`\"{}gmail.\+com\char`\"{} as {\ttfamily name}. See R\+F\+C2818 for more details. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
{\em name} & The hostname to verify against \\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\+2 
\end{DoxySince}
\hypertarget{group__Ecore__Con__SSL__Group_ga1f864cccb1d466d99c50d8b5cf0a240c}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+get@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+get}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+get@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+get}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+get}]{\setlength{\rightskip}{0pt plus 5cm}const char $\ast$ ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+get (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_ga1f864cccb1d466d99c50d8b5cf0a240c}


Get the hostname to verify against in certificate verification. 

This function returns the name which will be used to validate the S\+S\+L certificate common name (C\+N) or alt name (subject\+Alt\+Name). It will default to the {\ttfamily name} param in \hyperlink{group__Ecore__Con__Server__Group_gae3d7391f7da5e0f748d7b6804d010b2f}{ecore\+\_\+con\+\_\+server\+\_\+connect()}, but can be changed with \hyperlink{group__Ecore__Con__SSL__Group_ga748a19f336e02cf2b89566de304197d0}{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+verify\+\_\+name\+\_\+set()}. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The hostname which will be used 
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+2 
\end{DoxySince}
\hypertarget{group__Ecore__Con__SSL__Group_gae2013a54a47f6e168fb5049204d5ceed}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+upgrade@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+upgrade}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+upgrade@{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+upgrade}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+upgrade}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Eina\+\_\+\+Bool} ecore\+\_\+con\+\_\+ssl\+\_\+server\+\_\+upgrade (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Server $\ast$}]{obj, }
\item[{Ecore\+\_\+\+Con\+\_\+\+Type}]{ssl\+\_\+type}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_gae2013a54a47f6e168fb5049204d5ceed}


Upgrade a connection to a specified level of encryption. 

Use this function to begin an S\+S\+L handshake on a connection (S\+T\+A\+R\+T\+T\+L\+S or similar). Once the upgrade has been completed, an E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+E\+R\+V\+E\+R\+\_\+\+U\+P\+G\+R\+A\+D\+E event will be emitted. The connection should be treated as disconnected until the next event. 
\begin{DoxyParams}{Parameters}
{\em svr} & The server object \\
\hline
{\em ssl\+\_\+type} & The S\+S\+L connection type (O\+N\+L\+Y). \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E} if the connection cannot be upgraded, otherwise {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+U\+E}. 
\end{DoxyReturn}
\begin{DoxyNote}{Note}
This function is N\+E\+V\+E\+R to be used on a server object created with ecore\+\_\+con\+\_\+server\+\_\+add 
\end{DoxyNote}
\begin{DoxyWarning}{Warning}
Setting a wrong value for {\ttfamily compl\+\_\+type} W\+I\+L\+L mess up your program. 
\end{DoxyWarning}
\begin{DoxySince}{Since}
1.\+1 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Ecore__Con__SSL__Group_ga97c04d6932b161b25ae43fe9a6f807e4}{\index{Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}!ecore\+\_\+con\+\_\+ssl\+\_\+client\+\_\+upgrade@{ecore\+\_\+con\+\_\+ssl\+\_\+client\+\_\+upgrade}}
\index{ecore\+\_\+con\+\_\+ssl\+\_\+client\+\_\+upgrade@{ecore\+\_\+con\+\_\+ssl\+\_\+client\+\_\+upgrade}!Ecore Connection S\+S\+L Functions@{Ecore Connection S\+S\+L Functions}}
\subsubsection[{ecore\+\_\+con\+\_\+ssl\+\_\+client\+\_\+upgrade}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Eina\+\_\+\+Bool} ecore\+\_\+con\+\_\+ssl\+\_\+client\+\_\+upgrade (
\begin{DoxyParamCaption}
\item[{Ecore\+\_\+\+Con\+\_\+\+Client $\ast$}]{obj, }
\item[{Ecore\+\_\+\+Con\+\_\+\+Type}]{ssl\+\_\+type}
\end{DoxyParamCaption}
)}}\label{group__Ecore__Con__SSL__Group_ga97c04d6932b161b25ae43fe9a6f807e4}


Upgrade a connection to a specified level of encryption. 

Use this function to begin an S\+S\+L handshake on a connection (S\+T\+A\+R\+T\+T\+L\+S or similar). Once the upgrade has been completed, an E\+C\+O\+R\+E\+\_\+\+C\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+C\+L\+I\+E\+N\+T\+\_\+\+U\+P\+G\+R\+A\+D\+E event will be emitted. The connection should be treated as disconnected until the next event. 
\begin{DoxyParams}{Parameters}
{\em cl} & The client object \\
\hline
{\em ssl\+\_\+type} & The S\+S\+L connection type (O\+N\+L\+Y). \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E} if the connection cannot be upgraded, otherwise {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+U\+E}. 
\end{DoxyReturn}
\begin{DoxyWarning}{Warning}
Setting a wrong value for {\ttfamily compl\+\_\+type} W\+I\+L\+L mess up your program. 
\end{DoxyWarning}
\begin{DoxySince}{Since}
1.\+1 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

