\hypertarget{group__Eldbus__Basic}{\section{Basic Free\-Desktop.\-Org Methods}
\label{group__Eldbus__Basic}\index{Basic Free\-Desktop.\-Org Methods@{Basic Free\-Desktop.\-Org Methods}}
}
\subsection*{Modules}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Eldbus__FDO__Peer}{org.\-freedesktop.\-D\-Bus.\-Peer}
\item 
\hyperlink{group__Eldbus__FDO__Introspectable}{org.\-freedesktop.\-D\-Bus.\-Introspectable}
\item 
\hyperlink{group__Eldbus__FDO__Properties}{org.\-freedesktop.\-D\-Bus.\-Properties}
\item 
\hyperlink{group__Eldbus__FDO__ObjectManager}{org.\-freedesktop.\-D\-Bus.\-Object\-Manager}
\end{DoxyCompactItemize}
\subsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\hypertarget{group__Eldbus__Basic_ga84aa0fc12f0a7ce5abd656a0622e2070}{\#define \hyperlink{group__Eldbus__Basic_ga84aa0fc12f0a7ce5abd656a0622e2070}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-Q\-U\-E\-S\-T\-\_\-\-F\-L\-A\-G\-\_\-\-A\-L\-L\-O\-W\-\_\-\-R\-E\-P\-L\-A\-C\-E\-M\-E\-N\-T}~0x1}\label{group__Eldbus__Basic_ga84aa0fc12f0a7ce5abd656a0622e2070}

\begin{DoxyCompactList}\small\item\em Allow another service to become the primary owner if requested. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gaa261776755815a45b263fa932cb9e290}{\#define \hyperlink{group__Eldbus__Basic_gaa261776755815a45b263fa932cb9e290}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-Q\-U\-E\-S\-T\-\_\-\-F\-L\-A\-G\-\_\-\-R\-E\-P\-L\-A\-C\-E\-\_\-\-E\-X\-I\-S\-T\-I\-N\-G}~0x2}\label{group__Eldbus__Basic_gaa261776755815a45b263fa932cb9e290}

\begin{DoxyCompactList}\small\item\em Request to replace the current primary owner. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_ga31878c736bc89a712bbcd27699c5b519}{\#define \hyperlink{group__Eldbus__Basic_ga31878c736bc89a712bbcd27699c5b519}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-Q\-U\-E\-S\-T\-\_\-\-F\-L\-A\-G\-\_\-\-D\-O\-\_\-\-N\-O\-T\-\_\-\-Q\-U\-E\-U\-E}~0x4}\label{group__Eldbus__Basic_ga31878c736bc89a712bbcd27699c5b519}

\begin{DoxyCompactList}\small\item\em If we can not become the primary owner do not place us in the queue. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gacf5e700a1223c56f319d6f341e8d5624}{\#define \hyperlink{group__Eldbus__Basic_gacf5e700a1223c56f319d6f341e8d5624}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-Q\-U\-E\-S\-T\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-P\-R\-I\-M\-A\-R\-Y\-\_\-\-O\-W\-N\-E\-R}~1}\label{group__Eldbus__Basic_gacf5e700a1223c56f319d6f341e8d5624}

\begin{DoxyCompactList}\small\item\em Service has become the primary owner of the requested name. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gabcf6ebf2e6dba6278ba827ac55929e81}{\#define \hyperlink{group__Eldbus__Basic_gabcf6ebf2e6dba6278ba827ac55929e81}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-Q\-U\-E\-S\-T\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-I\-N\-\_\-\-Q\-U\-E\-U\-E}~2}\label{group__Eldbus__Basic_gabcf6ebf2e6dba6278ba827ac55929e81}

\begin{DoxyCompactList}\small\item\em Service could not become the primary owner and has been placed in the queue. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gabe0e4d709ea0807ef746bf64f63ca269}{\#define \hyperlink{group__Eldbus__Basic_gabe0e4d709ea0807ef746bf64f63ca269}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-Q\-U\-E\-S\-T\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-E\-X\-I\-S\-T\-S}~3}\label{group__Eldbus__Basic_gabe0e4d709ea0807ef746bf64f63ca269}

\begin{DoxyCompactList}\small\item\em Service is already in the queue. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gac5b2f086733c439f0b96f041d4914a41}{\#define \hyperlink{group__Eldbus__Basic_gac5b2f086733c439f0b96f041d4914a41}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-Q\-U\-E\-S\-T\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-A\-L\-R\-E\-A\-D\-Y\-\_\-\-O\-W\-N\-E\-R}~4}\label{group__Eldbus__Basic_gac5b2f086733c439f0b96f041d4914a41}

\begin{DoxyCompactList}\small\item\em Service is already the primary owner. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gae1a57048225658148a6a6e6245609805}{\#define \hyperlink{group__Eldbus__Basic_gae1a57048225658148a6a6e6245609805}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-L\-E\-A\-S\-E\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-R\-E\-L\-E\-A\-S\-E\-D}~1}\label{group__Eldbus__Basic_gae1a57048225658148a6a6e6245609805}

\begin{DoxyCompactList}\small\item\em Service was released from the given name. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gaac8ea9fbea8ecf4070c65b2e41a7a562}{\#define \hyperlink{group__Eldbus__Basic_gaac8ea9fbea8ecf4070c65b2e41a7a562}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-L\-E\-A\-S\-E\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-N\-O\-N\-\_\-\-E\-X\-I\-S\-T\-E\-N\-T}~2}\label{group__Eldbus__Basic_gaac8ea9fbea8ecf4070c65b2e41a7a562}

\begin{DoxyCompactList}\small\item\em The given name does not exist on the bus. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gaa213f6b15d52a459eb667da820488089}{\#define \hyperlink{group__Eldbus__Basic_gaa213f6b15d52a459eb667da820488089}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-R\-E\-L\-E\-A\-S\-E\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-N\-O\-T\-\_\-\-O\-W\-N\-E\-R}~3}\label{group__Eldbus__Basic_gaa213f6b15d52a459eb667da820488089}

\begin{DoxyCompactList}\small\item\em Service is not an owner of the given name. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gad98b694693668fd25aec92c268885377}{\#define \hyperlink{group__Eldbus__Basic_gad98b694693668fd25aec92c268885377}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-S\-T\-A\-R\-T\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-S\-U\-C\-C\-E\-S\-S}~1}\label{group__Eldbus__Basic_gad98b694693668fd25aec92c268885377}

\begin{DoxyCompactList}\small\item\em Service was auto started. \end{DoxyCompactList}\item 
\hypertarget{group__Eldbus__Basic_gaa48f57c21d1e7f9664139070616b2134}{\#define \hyperlink{group__Eldbus__Basic_gaa48f57c21d1e7f9664139070616b2134}{E\-L\-D\-B\-U\-S\-\_\-\-N\-A\-M\-E\-\_\-\-S\-T\-A\-R\-T\-\_\-\-R\-E\-P\-L\-Y\-\_\-\-A\-L\-R\-E\-A\-D\-Y\-\_\-\-R\-U\-N\-N\-I\-N\-G}~2}\label{group__Eldbus__Basic_gaa48f57c21d1e7f9664139070616b2134}

\begin{DoxyCompactList}\small\item\em Service was already running. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
\hypertarget{group__Eldbus__Basic_gab3a490bdbd834bba18e98b568529befb}{typedef void($\ast$ {\bfseries Eldbus\-\_\-\-Name\-\_\-\-Owner\-\_\-\-Changed\-\_\-\-Cb} )(void $\ast$data, const char $\ast$bus, const char $\ast$old\-\_\-id, const char $\ast$new\-\_\-id)}\label{group__Eldbus__Basic_gab3a490bdbd834bba18e98b568529befb}

\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\hypertarget{group__Eldbus__Basic_gaa2bade82fbf17312ab03440525630ac4}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-name\-\_\-request} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, const char $\ast$bus, unsigned int flags, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_gaa2bade82fbf17312ab03440525630ac4}

\item 
\hypertarget{group__Eldbus__Basic_ga52820add848a209019f3a1ec9cc53fd2}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-name\-\_\-release} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, const char $\ast$bus, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_ga52820add848a209019f3a1ec9cc53fd2}

\item 
\hypertarget{group__Eldbus__Basic_ga7a10838df33293c4cb6710f447a443c2}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-name\-\_\-owner\-\_\-get} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, const char $\ast$bus, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_ga7a10838df33293c4cb6710f447a443c2}

\item 
\hypertarget{group__Eldbus__Basic_gae13a514b8376890f6de581f6c6f437a1}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-name\-\_\-owner\-\_\-has} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, const char $\ast$bus, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_gae13a514b8376890f6de581f6c6f437a1}

\item 
\hypertarget{group__Eldbus__Basic_ga9202e546b288eb4b9431e649b1d6c1e7}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-names\-\_\-list} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_ga9202e546b288eb4b9431e649b1d6c1e7}

\item 
\hypertarget{group__Eldbus__Basic_ga3d24a7e6af0afa3a07a227daeeaa638b}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-names\-\_\-activatable\-\_\-list} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_ga3d24a7e6af0afa3a07a227daeeaa638b}

\item 
\hypertarget{group__Eldbus__Basic_gab4ea9f883c08b46ea90f1bcf2555f8dc}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-hello} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_gab4ea9f883c08b46ea90f1bcf2555f8dc}

\item 
\hypertarget{group__Eldbus__Basic_ga6a47ad76f86d5e7274e4dccdb18d49c0}{\hyperlink{group__Eldbus__Core_ga7a5d4dc070bd925034de6e52c4260be7}{Eldbus\-\_\-\-Pending} $\ast$ {\bfseries eldbus\-\_\-name\-\_\-start} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, const char $\ast$bus, unsigned int flags, Eldbus\-\_\-\-Message\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)}\label{group__Eldbus__Basic_ga6a47ad76f86d5e7274e4dccdb18d49c0}

\item 
void \hyperlink{group__Eldbus__Basic_gaf405114e35fec59c14cef2203e9debd5}{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, const char $\ast$bus, Eldbus\-\_\-\-Name\-\_\-\-Owner\-\_\-\-Changed\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data, \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\-\_\-\-Bool} allow\-\_\-initial\-\_\-call)
\begin{DoxyCompactList}\small\item\em Add a callback to be called when unique id of a bus name changed. \end{DoxyCompactList}\item 
void \hyperlink{group__Eldbus__Basic_gac3c3b6f6b54ed74cfd7cd9b0ab5cfde1}{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-del} (\hyperlink{group__Eldbus__Core_ga5f0557a7e65ed263fcc1678874b8f7e7}{Eldbus\-\_\-\-Connection} $\ast$conn, const char $\ast$bus, Eldbus\-\_\-\-Name\-\_\-\-Owner\-\_\-\-Changed\-\_\-\-Cb cb, const void $\ast$cb\-\_\-data)
\begin{DoxyCompactList}\small\item\em Remove callback added with \hyperlink{group__Eldbus__Basic_gaf405114e35fec59c14cef2203e9debd5}{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add()}. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}


\subsection{Function Documentation}
\hypertarget{group__Eldbus__Basic_gaf405114e35fec59c14cef2203e9debd5}{\index{Basic Free\-Desktop.\-Org Methods@{Basic Free\-Desktop.\-Org Methods}!eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add@{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add}}
\index{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add@{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add}!Basic FreeDesktop.Org Methods@{Basic Free\-Desktop.\-Org Methods}}
\subsubsection[{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add}]{\setlength{\rightskip}{0pt plus 5cm}void eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add (
\begin{DoxyParamCaption}
\item[{{\bf Eldbus\-\_\-\-Connection} $\ast$}]{conn, }
\item[{const char $\ast$}]{bus, }
\item[{Eldbus\-\_\-\-Name\-\_\-\-Owner\-\_\-\-Changed\-\_\-\-Cb}]{cb, }
\item[{const void $\ast$}]{cb\-\_\-data, }
\item[{{\bf Eina\-\_\-\-Bool}}]{allow\-\_\-initial\-\_\-call}
\end{DoxyParamCaption}
)}}\label{group__Eldbus__Basic_gaf405114e35fec59c14cef2203e9debd5}


Add a callback to be called when unique id of a bus name changed. 

This function implicitly calls eldbus\-\_\-name\-\_\-owner\-\_\-get() in order to be able to monitor the name. If the only interest is to receive notifications when the name in fact changes, pass E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E to 
\begin{DoxyParams}{Parameters}
{\em allow\-\_\-initial\-\_\-call} & so your callback will not be called on first retrieval of name owner. If the initial state is important, pass E\-I\-N\-A\-\_\-\-T\-R\-U\-E to this parameter.\\
\hline
{\em conn} & connection \\
\hline
{\em bus} & name of bus \\
\hline
{\em cb} & callback \\
\hline
{\em cb\-\_\-data} & context data \\
\hline
{\em allow\-\_\-initial\-\_\-call} & allow call callback with actual id of the bus \\
\hline
\end{DoxyParams}


References ecore\-\_\-idler\-\_\-add(), eina\-\_\-inlist\-\_\-append(), and E\-I\-N\-A\-\_\-\-I\-N\-L\-I\-S\-T\-\_\-\-G\-E\-T.



Referenced by ethumb\-\_\-client\-\_\-connect().

\hypertarget{group__Eldbus__Basic_gac3c3b6f6b54ed74cfd7cd9b0ab5cfde1}{\index{Basic Free\-Desktop.\-Org Methods@{Basic Free\-Desktop.\-Org Methods}!eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-del@{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-del}}
\index{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-del@{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-del}!Basic FreeDesktop.Org Methods@{Basic Free\-Desktop.\-Org Methods}}
\subsubsection[{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-del}]{\setlength{\rightskip}{0pt plus 5cm}void eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-del (
\begin{DoxyParamCaption}
\item[{{\bf Eldbus\-\_\-\-Connection} $\ast$}]{conn, }
\item[{const char $\ast$}]{bus, }
\item[{Eldbus\-\_\-\-Name\-\_\-\-Owner\-\_\-\-Changed\-\_\-\-Cb}]{cb, }
\item[{const void $\ast$}]{cb\-\_\-data}
\end{DoxyParamCaption}
)}}\label{group__Eldbus__Basic_gac3c3b6f6b54ed74cfd7cd9b0ab5cfde1}


Remove callback added with \hyperlink{group__Eldbus__Basic_gaf405114e35fec59c14cef2203e9debd5}{eldbus\-\_\-name\-\_\-owner\-\_\-changed\-\_\-callback\-\_\-add()}. 


\begin{DoxyParams}{Parameters}
{\em conn} & connection \\
\hline
{\em bus} & name of bus \\
\hline
{\em cb} & callback \\
\hline
{\em cb\-\_\-data} & context data \\
\hline
\end{DoxyParams}


References ecore\-\_\-idler\-\_\-del(), eina\-\_\-hash\-\_\-find(), E\-I\-N\-A\-\_\-\-I\-N\-L\-I\-S\-T\-\_\-\-F\-O\-R\-E\-A\-C\-H, E\-I\-N\-A\-\_\-\-I\-N\-L\-I\-S\-T\-\_\-\-G\-E\-T, eina\-\_\-inlist\-\_\-remove(), eina\-\_\-list\-\_\-append(), and E\-I\-N\-A\-\_\-\-T\-R\-U\-E.

