\hypertarget{conicconnection_8h}{
\section{conicconnection.h File Reference}
\label{conicconnection_8h}\index{conicconnection.h@{conicconnection.h}}
}


\subsection{Detailed Description}
Con\-Ic\-Connection class. 

Con\-Ic\-Connection class can be used to request for Internet connections. Also it can be used retrieve current statistics, proxies and settings for Internet Access Points (IAPs).\hypertarget{conicconnection_8h_signals}{}\subsection{Gobject signals}\label{conicconnection_8h_signals}
Con\-Ic\-Connection has these gobject signals:\begin{itemize}
\item connection-event\item statistics\end{itemize}


The different signals are listed below as function prototypes for informational purposes. They are implemented as gobject signals.

\char`\"{}connection-event\char`\"{} signal



\begin{Code}\begin{verbatim} void user_function(ConIcConnection *connection, 
                     ConIcConnectionEvent *event,
                     gpointer user_data);
\end{verbatim}\end{Code}



When there's a new connection event for the application (eg. a connection is opened as requested), it sent as connection-event signal. Con\-Ic\-Connection\-Event contains the status, for example CON\_\-IC\_\-STATUS\_\-CONNECTED or CON\_\-IC\_\-STATUS\_\-DISCONNECTED.

\char`\"{}statistics\char`\"{} signal



\begin{Code}\begin{verbatim} void user_function(ConIcConnection *connection, 
                    ConIcStatisticsEvent *event,
                    gpointer user_data);
\end{verbatim}\end{Code}



All statistics are sent using this signal as Con\-Ic\-Statistics event.\hypertarget{conicconnection_8h_properties}{}\subsection{Gobject properties}\label{conicconnection_8h_properties}
Con\-Ic\-Connection has one gobject property:



\begin{Code}\begin{verbatim} "automatic-connection-events"        gboolean              : Read / Write 
\end{verbatim}\end{Code}



If set to true, application will receive connection-events automatically as connections are established and tore down. Normally events are only sent when applications request for a connection, with this all events are received constantly. This makes it possible, for example, to create an application which executes something from the network every time a connection is established.

\begin{Desc}
\item[Note:]Automatic events are not stopped by Internet Connectivity system when \hyperlink{conicconnection_8h_bb166f206248fd0abdba34765250acb4}{con\_\-ic\_\-connection\_\-connect()} is called. The documentation was wrong and has now been updated. \end{Desc}


{\tt \#include $<$glib.h$>$}\par
{\tt \#include $<$glib-object.h$>$}\par
{\tt \#include $<$coniciap.h$>$}\par
\subsection*{Typedefs}
\begin{CompactItemize}
\item 
typedef \_\-Con\-Ic\-Connection \hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection}
\begin{CompactList}\small\item\em Con\-Ic\-Connection object. \item\end{CompactList}\end{CompactItemize}
\subsection*{Enumerations}
\begin{CompactItemize}
\item 
enum \hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}{Con\-Ic\-Connect\-Flags} \{ \hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24874c40ab79091bf8702743f96ca8ddc0}{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-NONE} =  0, 
\hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f248fad43d94f4045ce4ea8cac149221798}{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-AUTOMATICALLY\_\-TRIGGERED} =  1 $<$$<$ 0, 
\hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24de8f91a46c2ce6a416d1aa27836edca8}{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-UNMANAGED} =  1 $<$$<$ 1
 \}
\begin{CompactList}\small\item\em Connection request flags. \item\end{CompactList}\item 
enum \hyperlink{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16}{Con\-Ic\-Proxy\-Mode} \{ \hyperlink{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16e003ea5db3fd457be17ed3d94aff5421}{CON\_\-IC\_\-PROXY\_\-MODE\_\-NONE}, 
\hyperlink{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb1696ef288213387adb6e6299b9e08a70ff}{CON\_\-IC\_\-PROXY\_\-MODE\_\-MANUAL}, 
\hyperlink{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb167d9bb8df0d26af9afcb6c08427c4671c}{CON\_\-IC\_\-PROXY\_\-MODE\_\-AUTO}
 \}
\begin{CompactList}\small\item\em Proxy modes. \item\end{CompactList}\item 
enum \hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}{Con\-Ic\-Proxy\-Protocol} \{ \par
\hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91e67a48e36e51c91a285a5f0b110fcdd3}{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTP}, 
\hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a919fed4818439872d567ce829eea70e211}{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTPS}, 
\hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91cce313785131a935cd72e5344204e89a}{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-FTP}, 
\hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a918efcf2e59805ea2f91ddc0d383abc381}{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-SOCKS}, 
\par
\hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91651b87cb36f629ae88a5a016d90d9960}{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-RTSP}
 \}
\begin{CompactList}\small\item\em Proxy protocol. \item\end{CompactList}\end{CompactItemize}
\subsection*{Functions}
\begin{CompactItemize}
\item 
\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ \hyperlink{conicconnection_8h_2174c69d3329c93a44387903383deac6}{con\_\-ic\_\-connection\_\-new} (void)
\begin{CompactList}\small\item\em Creates new Con\-Ic\-Connection. \item\end{CompactList}\item 
gboolean \hyperlink{conicconnection_8h_bb166f206248fd0abdba34765250acb4}{con\_\-ic\_\-connection\_\-connect} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection, \hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}{Con\-Ic\-Connect\-Flags} flags)
\begin{CompactList}\small\item\em Request for a connection. \item\end{CompactList}\item 
gboolean \hyperlink{conicconnection_8h_bcedb67055aeed2574e2325122ac39c8}{con\_\-ic\_\-connection\_\-connect\_\-by\_\-id} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection, const gchar $\ast$id, \hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}{Con\-Ic\-Connect\-Flags} flags)
\begin{CompactList}\small\item\em Request for a connection using the IAP id. \item\end{CompactList}\item 
gboolean \hyperlink{conicconnection_8h_0fce3bb5d82d215f2a3afc23e01a20aa}{con\_\-ic\_\-connection\_\-disconnect} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection)
\begin{CompactList}\small\item\em Disconnects all IAPs associated with the connection. \item\end{CompactList}\item 
gboolean \hyperlink{conicconnection_8h_88ac3d2814a2a71dd1b8e76e3214be07}{con\_\-ic\_\-connection\_\-disconnect\_\-by\_\-id} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection, const gchar $\ast$id)
\begin{CompactList}\small\item\em Disconnects specific IAP associated with the application. \item\end{CompactList}\item 
gboolean \hyperlink{conicconnection_8h_de81c9621d70c33bf73832b026575782}{con\_\-ic\_\-connection\_\-statistics} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection, const gchar $\ast$id)
\begin{CompactList}\small\item\em Requests statistics for a IAP. \item\end{CompactList}\item 
\hyperlink{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16}{Con\-Ic\-Proxy\-Mode} \hyperlink{conicconnection_8h_ab0baa4b88cb925457b1c7e89d92530d}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-mode} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection)
\begin{CompactList}\small\item\em Get current proxy mode. \item\end{CompactList}\item 
GSList $\ast$ \hyperlink{conicconnection_8h_9d2a0b7792b04798f5b18e166c75f532}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-ignore\_\-hosts} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection)
\begin{CompactList}\small\item\em Get a list of hosts to be ignored. \item\end{CompactList}\item 
const gchar $\ast$ \hyperlink{conicconnection_8h_ba4baa4d45c2436c544bdf8b2d85c70a}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-autoconfig\_\-url} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection)
\begin{CompactList}\small\item\em Get the URL of Auto-Config Proxy. \item\end{CompactList}\item 
const gchar $\ast$ \hyperlink{conicconnection_8h_138161d470b42bcb0792c5711c7da716}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-host} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection, \hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}{Con\-Ic\-Proxy\-Protocol} protocol)
\begin{CompactList}\small\item\em Get proxy host. \item\end{CompactList}\item 
gint \hyperlink{conicconnection_8h_e559a840c96916e6c3d83c9e3dd1963f}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-port} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection, \hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}{Con\-Ic\-Proxy\-Protocol} protocol)
\begin{CompactList}\small\item\em Get proxy port. \item\end{CompactList}\item 
GSList $\ast$ \hyperlink{conicconnection_8h_d861260353726d03efcc33c7fff59285}{con\_\-ic\_\-connection\_\-get\_\-all\_\-iaps} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection)
\begin{CompactList}\small\item\em Get a list of all configured IAPs. \item\end{CompactList}\item 
\hyperlink{coniciap_8h_e2a229cb6d3f9b974258522f95ed65d9}{Con\-Ic\-Iap} $\ast$ \hyperlink{conicconnection_8h_dcd4848e449585fd7fe70735621159c6}{con\_\-ic\_\-connection\_\-get\_\-iap} (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$connection, const gchar $\ast$id)
\begin{CompactList}\small\item\em Retrieve an IAP by id. \item\end{CompactList}\end{CompactItemize}


\subsection{Typedef Documentation}
\hypertarget{conicconnection_8h_c4092500d972afc9a34350526163b382}{
\index{conicconnection.h@{conicconnection.h}!ConIcConnection@{ConIcConnection}}
\index{ConIcConnection@{ConIcConnection}!conicconnection.h@{conicconnection.h}}
\subsubsection[ConIcConnection]{\setlength{\rightskip}{0pt plus 5cm}typedef struct \_\-Con\-Ic\-Connection \hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection}}}
\label{conicconnection_8h_c4092500d972afc9a34350526163b382}


Con\-Ic\-Connection object. 

The contents of the object is private, use only the functions provided by \hyperlink{conicconnection_8h}{conicconnection.h}. 

\subsection{Enumeration Type Documentation}
\hypertarget{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}{
\index{conicconnection.h@{conicconnection.h}!ConIcConnectFlags@{ConIcConnectFlags}}
\index{ConIcConnectFlags@{ConIcConnectFlags}!conicconnection.h@{conicconnection.h}}
\subsubsection[ConIcConnectFlags]{\setlength{\rightskip}{0pt plus 5cm}enum \hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}{Con\-Ic\-Connect\-Flags}}}
\label{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}


Connection request flags. 

With these flags special connection requests can be made. The flags can be ORred.

Normally just use CON\_\-IC\_\-CONNECT\_\-FLAG\_\-NONE. \begin{Desc}
\item[Enumerator: ]\par
\begin{description}
\index{CON_IC_CONNECT_FLAG_NONE@{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-NONE}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_CONNECT_FLAG_NONE@{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-NONE}}\item[{\em 
\hypertarget{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24874c40ab79091bf8702743f96ca8ddc0}{
CON\_\-IC\_\-CONNECT\_\-FLAG\_\-NONE}
\label{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24874c40ab79091bf8702743f96ca8ddc0}
}]No flags set. \index{CON_IC_CONNECT_FLAG_AUTOMATICALLY_TRIGGERED@{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-AUTOMATICALLY\_\-TRIGGERED}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_CONNECT_FLAG_AUTOMATICALLY_TRIGGERED@{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-AUTOMATICALLY\_\-TRIGGERED}}\item[{\em 
\hypertarget{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f248fad43d94f4045ce4ea8cac149221798}{
CON\_\-IC\_\-CONNECT\_\-FLAG\_\-AUTOMATICALLY\_\-TRIGGERED}
\label{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f248fad43d94f4045ce4ea8cac149221798}
}]Connection establishment wasn't started by a user action. 

Instead it was triggered by a timer, or something similar, event from the application. Using this flags means that if a connection isn't already established, the connection request will fail. \index{CON_IC_CONNECT_FLAG_UNMANAGED@{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-UNMANAGED}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_CONNECT_FLAG_UNMANAGED@{CON\_\-IC\_\-CONNECT\_\-FLAG\_\-UNMANAGED}}\item[{\em 
\hypertarget{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24de8f91a46c2ce6a416d1aa27836edca8}{
CON\_\-IC\_\-CONNECT\_\-FLAG\_\-UNMANAGED}
\label{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24de8f91a46c2ce6a416d1aa27836edca8}
}]Process requesting the connection won't be monitored for killing. 

Normally if the process died, it will be automatically detached from the connection. If this flag is set and process dies, the connection won't closed automatically. \end{description}
\end{Desc}

\hypertarget{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16}{
\index{conicconnection.h@{conicconnection.h}!ConIcProxyMode@{ConIcProxyMode}}
\index{ConIcProxyMode@{ConIcProxyMode}!conicconnection.h@{conicconnection.h}}
\subsubsection[ConIcProxyMode]{\setlength{\rightskip}{0pt plus 5cm}enum \hyperlink{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16}{Con\-Ic\-Proxy\-Mode}}}
\label{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16}


Proxy modes. 

\begin{Desc}
\item[Enumerator: ]\par
\begin{description}
\index{CON_IC_PROXY_MODE_NONE@{CON\_\-IC\_\-PROXY\_\-MODE\_\-NONE}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_MODE_NONE@{CON\_\-IC\_\-PROXY\_\-MODE\_\-NONE}}\item[{\em 
\hypertarget{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16e003ea5db3fd457be17ed3d94aff5421}{
CON\_\-IC\_\-PROXY\_\-MODE\_\-NONE}
\label{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16e003ea5db3fd457be17ed3d94aff5421}
}]No proxies set. \index{CON_IC_PROXY_MODE_MANUAL@{CON\_\-IC\_\-PROXY\_\-MODE\_\-MANUAL}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_MODE_MANUAL@{CON\_\-IC\_\-PROXY\_\-MODE\_\-MANUAL}}\item[{\em 
\hypertarget{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb1696ef288213387adb6e6299b9e08a70ff}{
CON\_\-IC\_\-PROXY\_\-MODE\_\-MANUAL}
\label{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb1696ef288213387adb6e6299b9e08a70ff}
}]Manual proxies set. \index{CON_IC_PROXY_MODE_AUTO@{CON\_\-IC\_\-PROXY\_\-MODE\_\-AUTO}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_MODE_AUTO@{CON\_\-IC\_\-PROXY\_\-MODE\_\-AUTO}}\item[{\em 
\hypertarget{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb167d9bb8df0d26af9afcb6c08427c4671c}{
CON\_\-IC\_\-PROXY\_\-MODE\_\-AUTO}
\label{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb167d9bb8df0d26af9afcb6c08427c4671c}
}]Automatic proxy URL set. \end{description}
\end{Desc}

\hypertarget{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}{
\index{conicconnection.h@{conicconnection.h}!ConIcProxyProtocol@{ConIcProxyProtocol}}
\index{ConIcProxyProtocol@{ConIcProxyProtocol}!conicconnection.h@{conicconnection.h}}
\subsubsection[ConIcProxyProtocol]{\setlength{\rightskip}{0pt plus 5cm}enum \hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}{Con\-Ic\-Proxy\-Protocol}}}
\label{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}


Proxy protocol. 

\begin{Desc}
\item[Enumerator: ]\par
\begin{description}
\index{CON_IC_PROXY_PROTOCOL_HTTP@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTP}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_PROTOCOL_HTTP@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTP}}\item[{\em 
\hypertarget{conicconnection_8h_00ac62dd029257a71aa2121931e62a91e67a48e36e51c91a285a5f0b110fcdd3}{
CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTP}
\label{conicconnection_8h_00ac62dd029257a71aa2121931e62a91e67a48e36e51c91a285a5f0b110fcdd3}
}]HTTP proxy protocol. \index{CON_IC_PROXY_PROTOCOL_HTTPS@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTPS}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_PROTOCOL_HTTPS@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTPS}}\item[{\em 
\hypertarget{conicconnection_8h_00ac62dd029257a71aa2121931e62a919fed4818439872d567ce829eea70e211}{
CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-HTTPS}
\label{conicconnection_8h_00ac62dd029257a71aa2121931e62a919fed4818439872d567ce829eea70e211}
}]HTTPS proxy protocol. \index{CON_IC_PROXY_PROTOCOL_FTP@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-FTP}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_PROTOCOL_FTP@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-FTP}}\item[{\em 
\hypertarget{conicconnection_8h_00ac62dd029257a71aa2121931e62a91cce313785131a935cd72e5344204e89a}{
CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-FTP}
\label{conicconnection_8h_00ac62dd029257a71aa2121931e62a91cce313785131a935cd72e5344204e89a}
}]FTP proxy protocol. \index{CON_IC_PROXY_PROTOCOL_SOCKS@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-SOCKS}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_PROTOCOL_SOCKS@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-SOCKS}}\item[{\em 
\hypertarget{conicconnection_8h_00ac62dd029257a71aa2121931e62a918efcf2e59805ea2f91ddc0d383abc381}{
CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-SOCKS}
\label{conicconnection_8h_00ac62dd029257a71aa2121931e62a918efcf2e59805ea2f91ddc0d383abc381}
}]SOCKS proxy protocol. \index{CON_IC_PROXY_PROTOCOL_RTSP@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-RTSP}!conicconnection.h@{conicconnection.h}}\index{conicconnection.h@{conicconnection.h}!CON_IC_PROXY_PROTOCOL_RTSP@{CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-RTSP}}\item[{\em 
\hypertarget{conicconnection_8h_00ac62dd029257a71aa2121931e62a91651b87cb36f629ae88a5a016d90d9960}{
CON\_\-IC\_\-PROXY\_\-PROTOCOL\_\-RTSP}
\label{conicconnection_8h_00ac62dd029257a71aa2121931e62a91651b87cb36f629ae88a5a016d90d9960}
}]RTSP proxy protocol. \end{description}
\end{Desc}



\subsection{Function Documentation}
\hypertarget{conicconnection_8h_bb166f206248fd0abdba34765250acb4}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_connect@{con\_\-ic\_\-connection\_\-connect}}
\index{con_ic_connection_connect@{con\_\-ic\_\-connection\_\-connect}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-connect]{\setlength{\rightskip}{0pt plus 5cm}gboolean con\_\-ic\_\-connection\_\-connect (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection}, \hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}{Con\-Ic\-Connect\-Flags} {\em flags})}}
\label{conicconnection_8h_bb166f206248fd0abdba34765250acb4}


Request for a connection. 

The Internet Connectivity subsystem will choose the best connection based on user settings and input provided by the user.

Answer is sent using the connection-event signal from a Con\-Ic\-Connection object. If the connection establishment succeeded, or there was already a connection established, a CON\_\-IC\_\-STATUS\_\-CONNECTED inside Con\-Ic\-Connection\-Event is sent. If connection establishment failed, a CON\_\-IC\_\-STATUS\_\-DISCONNECTED inside Con\-Ic\-Connection\-Event is sent and error is set accordingly.

Normally this one should be used.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object. \item[{\em flags}]Flags for the request. \end{description}
\end{Desc}
\begin{Desc}
\item[Return values:]
\begin{description}
\item[{\em TRUE}]If no DBUS errors. \item[{\em FALSE}]If a DBUS message couldn't be sent. \end{description}
\end{Desc}
\hypertarget{conicconnection_8h_bcedb67055aeed2574e2325122ac39c8}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_connect_by_id@{con\_\-ic\_\-connection\_\-connect\_\-by\_\-id}}
\index{con_ic_connection_connect_by_id@{con\_\-ic\_\-connection\_\-connect\_\-by\_\-id}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-connect\_\-by\_\-id]{\setlength{\rightskip}{0pt plus 5cm}gboolean con\_\-ic\_\-connection\_\-connect\_\-by\_\-id (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection}, const gchar $\ast$ {\em id}, \hyperlink{conicconnection_8h_d4a41d42a45475bb9c83ec482b253f24}{Con\-Ic\-Connect\-Flags} {\em flags})}}
\label{conicconnection_8h_bcedb67055aeed2574e2325122ac39c8}


Request for a connection using the IAP id. 

The Internet Connectivity subsystem will choose the best connection based on user settings and input provided by the user.

Answer is sent using the connection-event signal from a Con\-Ic\-Connection object. If the connection establishment succeeded, or there was already a connection established, a CON\_\-IC\_\-STATUS\_\-CONNECTED inside Con\-Ic\-Connection\-Event is sent. If connection establishment failed, a CON\_\-IC\_\-STATUS\_\-DISCONNECTED inside Con\-Ic\-Connection\-Event is sent and error is set accordingly.

Normally \hyperlink{conicconnection_8h_bb166f206248fd0abdba34765250acb4}{con\_\-ic\_\-connection\_\-connect()} should be used. Use this one if you want to use a specific connection.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object. \item[{\em flags}]Flags for the request. \item[{\em id}]Id of the requested IAP. \end{description}
\end{Desc}
\begin{Desc}
\item[Return values:]
\begin{description}
\item[{\em TRUE}]If no DBUS errors. \item[{\em FALSE}]If a DBUS message couldn't be sent. \end{description}
\end{Desc}
\hypertarget{conicconnection_8h_0fce3bb5d82d215f2a3afc23e01a20aa}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_disconnect@{con\_\-ic\_\-connection\_\-disconnect}}
\index{con_ic_connection_disconnect@{con\_\-ic\_\-connection\_\-disconnect}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-disconnect]{\setlength{\rightskip}{0pt plus 5cm}gboolean con\_\-ic\_\-connection\_\-disconnect (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection})}}
\label{conicconnection_8h_0fce3bb5d82d215f2a3afc23e01a20aa}


Disconnects all IAPs associated with the connection. 

Normally use this one.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object. \end{description}
\end{Desc}
\begin{Desc}
\item[Return values:]
\begin{description}
\item[{\em TRUE}]If no DBUS errors. \item[{\em FALSE}]If a DBUS message couldn't be sent. \end{description}
\end{Desc}
\hypertarget{conicconnection_8h_88ac3d2814a2a71dd1b8e76e3214be07}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_disconnect_by_id@{con\_\-ic\_\-connection\_\-disconnect\_\-by\_\-id}}
\index{con_ic_connection_disconnect_by_id@{con\_\-ic\_\-connection\_\-disconnect\_\-by\_\-id}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-disconnect\_\-by\_\-id]{\setlength{\rightskip}{0pt plus 5cm}gboolean con\_\-ic\_\-connection\_\-disconnect\_\-by\_\-id (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection}, const gchar $\ast$ {\em id})}}
\label{conicconnection_8h_88ac3d2814a2a71dd1b8e76e3214be07}


Disconnects specific IAP associated with the application. 

Normally use \hyperlink{conicconnection_8h_0fce3bb5d82d215f2a3afc23e01a20aa}{con\_\-ic\_\-connection\_\-disconnect()}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object. \item[{\em id}]Id of the IAP to disconnected. \end{description}
\end{Desc}
\begin{Desc}
\item[Return values:]
\begin{description}
\item[{\em TRUE}]If no DBUS errors. \item[{\em FALSE}]If a DBUS message couldn't be sent. \end{description}
\end{Desc}
\hypertarget{conicconnection_8h_d861260353726d03efcc33c7fff59285}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_get_all_iaps@{con\_\-ic\_\-connection\_\-get\_\-all\_\-iaps}}
\index{con_ic_connection_get_all_iaps@{con\_\-ic\_\-connection\_\-get\_\-all\_\-iaps}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-get\_\-all\_\-iaps]{\setlength{\rightskip}{0pt plus 5cm}GSList$\ast$ con\_\-ic\_\-connection\_\-get\_\-all\_\-iaps (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection})}}
\label{conicconnection_8h_d861260353726d03efcc33c7fff59285}


Get a list of all configured IAPs. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A singly linked list of Con\-Ic\-Iaps or NULL for error. Caller should free all Con\-Ic\-Iaps with g\_\-object\_\-unref() and the list itself with g\_\-slist\_\-free(). \end{Desc}
\hypertarget{conicconnection_8h_dcd4848e449585fd7fe70735621159c6}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_get_iap@{con\_\-ic\_\-connection\_\-get\_\-iap}}
\index{con_ic_connection_get_iap@{con\_\-ic\_\-connection\_\-get\_\-iap}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-get\_\-iap]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{coniciap_8h_e2a229cb6d3f9b974258522f95ed65d9}{Con\-Ic\-Iap}$\ast$ con\_\-ic\_\-connection\_\-get\_\-iap (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection}, const gchar $\ast$ {\em id})}}
\label{conicconnection_8h_dcd4848e449585fd7fe70735621159c6}


Retrieve an IAP by id. 

\begin{Desc}
\item[Returns:]Con\-Ic\-Iap gobject which caller must free with g\_\-object\_\-unref(). \end{Desc}
\hypertarget{conicconnection_8h_ba4baa4d45c2436c544bdf8b2d85c70a}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_get_proxy_autoconfig_url@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-autoconfig\_\-url}}
\index{con_ic_connection_get_proxy_autoconfig_url@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-autoconfig\_\-url}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-get\_\-proxy\_\-autoconfig\_\-url]{\setlength{\rightskip}{0pt plus 5cm}const gchar$\ast$ con\_\-ic\_\-connection\_\-get\_\-proxy\_\-autoconfig\_\-url (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection})}}
\label{conicconnection_8h_ba4baa4d45c2436c544bdf8b2d85c70a}


Get the URL of Auto-Config Proxy. 

It is guaranteed that this function always returns the current and up-to-date settings.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]URL as a string. NULL, if no URL specified. \end{Desc}
\hypertarget{conicconnection_8h_138161d470b42bcb0792c5711c7da716}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_get_proxy_host@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-host}}
\index{con_ic_connection_get_proxy_host@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-host}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-get\_\-proxy\_\-host]{\setlength{\rightskip}{0pt plus 5cm}const gchar$\ast$ con\_\-ic\_\-connection\_\-get\_\-proxy\_\-host (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection}, \hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}{Con\-Ic\-Proxy\-Protocol} {\em protocol})}}
\label{conicconnection_8h_138161d470b42bcb0792c5711c7da716}


Get proxy host. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object \item[{\em protocol}]Protocol, for which the proxy host should be returned \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]hostname of the proxy for the protocol \end{Desc}
\hypertarget{conicconnection_8h_9d2a0b7792b04798f5b18e166c75f532}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_get_proxy_ignore_hosts@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-ignore\_\-hosts}}
\index{con_ic_connection_get_proxy_ignore_hosts@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-ignore\_\-hosts}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-get\_\-proxy\_\-ignore\_\-hosts]{\setlength{\rightskip}{0pt plus 5cm}GSList$\ast$ con\_\-ic\_\-connection\_\-get\_\-proxy\_\-ignore\_\-hosts (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection})}}
\label{conicconnection_8h_9d2a0b7792b04798f5b18e166c75f532}


Get a list of hosts to be ignored. 

Connections to these hosts shouldn't use proxies.

It is guaranteed that this function always returns the current and up-to-date settings. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A GSList of strings, which contain the hosts. Free all strings individually, and the list with g\_\-slist\_\-free(). NULL, if no hosts specified. \end{Desc}
\hypertarget{conicconnection_8h_ab0baa4b88cb925457b1c7e89d92530d}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_get_proxy_mode@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-mode}}
\index{con_ic_connection_get_proxy_mode@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-mode}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-get\_\-proxy\_\-mode]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{conicconnection_8h_8ebf7ac8bc39ca9b3a898edfc007fb16}{Con\-Ic\-Proxy\-Mode} con\_\-ic\_\-connection\_\-get\_\-proxy\_\-mode (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection})}}
\label{conicconnection_8h_ab0baa4b88cb925457b1c7e89d92530d}


Get current proxy mode. 

If proxy mode is CON\_\-IC\_\-PROXY\_\-MODE\_\-NONE, do not use proxies at all.

If proxy mode is CON\_\-IC\_\-PROXY\_\-MODE\_\-MANUAL, use proxies and {\em only\/} use these functions to get the proxy settings:

\begin{itemize}
\item \hyperlink{conicconnection_8h_138161d470b42bcb0792c5711c7da716}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-host()}\item \hyperlink{conicconnection_8h_e559a840c96916e6c3d83c9e3dd1963f}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-port()}\item \hyperlink{conicconnection_8h_9d2a0b7792b04798f5b18e166c75f532}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-ignore\_\-hosts()}\end{itemize}


If proxy mode is CON\_\-IC\_\-PROXY\_\-MODE\_\-AUTO, then {\em only\/} use Proxy Auto-config file specified in $<$\href{http://wp.netscape.com/eng/mozilla/2.0/relnotes/demo/proxy-live.html}{\tt http://wp.netscape.com/eng/mozilla/2.0/relnotes/demo/proxy-live.html}$>$. To get the URL for the file, use this function:

\begin{itemize}
\item \hyperlink{conicconnection_8h_ba4baa4d45c2436c544bdf8b2d85c70a}{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-autoconfig\_\-url()} \end{itemize}
\hypertarget{conicconnection_8h_e559a840c96916e6c3d83c9e3dd1963f}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_get_proxy_port@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-port}}
\index{con_ic_connection_get_proxy_port@{con\_\-ic\_\-connection\_\-get\_\-proxy\_\-port}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-get\_\-proxy\_\-port]{\setlength{\rightskip}{0pt plus 5cm}gint con\_\-ic\_\-connection\_\-get\_\-proxy\_\-port (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection}, \hyperlink{conicconnection_8h_00ac62dd029257a71aa2121931e62a91}{Con\-Ic\-Proxy\-Protocol} {\em protocol})}}
\label{conicconnection_8h_e559a840c96916e6c3d83c9e3dd1963f}


Get proxy port. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object \item[{\em protocol}]Protocol, for which the proxy port should be returned \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]port number of the proxy host for the protocol \end{Desc}
\hypertarget{conicconnection_8h_2174c69d3329c93a44387903383deac6}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_new@{con\_\-ic\_\-connection\_\-new}}
\index{con_ic_connection_new@{con\_\-ic\_\-connection\_\-new}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-new]{\setlength{\rightskip}{0pt plus 5cm}\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection}$\ast$ con\_\-ic\_\-connection\_\-new (void)}}
\label{conicconnection_8h_2174c69d3329c93a44387903383deac6}


Creates new Con\-Ic\-Connection. 

When not needed anymore, release with g\_\-object\_\-unref().

Creating the object does not yet open the connection. Use, for example, \hyperlink{conicconnection_8h_bb166f206248fd0abdba34765250acb4}{con\_\-ic\_\-connection\_\-connect()} to do that.

\begin{Desc}
\item[Returns:]New Con\-Ic\-Connection object. NULL, if the object creation failed. \end{Desc}
\hypertarget{conicconnection_8h_de81c9621d70c33bf73832b026575782}{
\index{conicconnection.h@{conicconnection.h}!con_ic_connection_statistics@{con\_\-ic\_\-connection\_\-statistics}}
\index{con_ic_connection_statistics@{con\_\-ic\_\-connection\_\-statistics}!conicconnection.h@{conicconnection.h}}
\subsubsection[con\_\-ic\_\-connection\_\-statistics]{\setlength{\rightskip}{0pt plus 5cm}gboolean con\_\-ic\_\-connection\_\-statistics (\hyperlink{conicconnection_8h_c4092500d972afc9a34350526163b382}{Con\-Ic\-Connection} $\ast$ {\em connection}, const gchar $\ast$ {\em id})}}
\label{conicconnection_8h_de81c9621d70c33bf73832b026575782}


Requests statistics for a IAP. 

The answer is sent as Con\-Ic\-Statistics in statistics signal.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em connection}]Con\-Ic\-Connection object. \item[{\em id}]Id of the IAP \end{description}
\end{Desc}
\begin{Desc}
\item[Return values:]
\begin{description}
\item[{\em TRUE}]If no DBUS errors. \item[{\em FALSE}]If a DBUS message couldn't be sent. No statistics events will be emitted. \end{description}
\end{Desc}
