/*
This file is part of GNUnet
- Copyright (C) 2013, 2014 Christian Grothoff (and other contributing authors)
+ Copyright (C) 2013, 2014, 2016 GNUnet e.V.
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
+ Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
*/
/**
- * @file include/gnunet_conversation_service.h
- * @brief API to the conversation service
* @author Simon Dieterle
* @author Andreas Fuchs
* @author Christian Grothoff
*
+ * @file
+ * API to the conversation service
+ *
+ * @defgroup conversation Conversation service
+ * One-to-one voice communication over CADET
*
* NOTE: This API is deliberately deceptively simple; the idea
* is that advanced features (such as answering machines) will
* course provided as part of the basic implementation, as only the
* CONVERSATION service can know for sure who it is that we are
* talking to.
+ *
+ * @{
*/
#ifndef GNUNET_CONVERSATION_SERVICE_H
#define GNUNET_CONVERSATION_SERVICE_H
/**
* Version of the conversation API.
*/
-#define GNUNET_CONVERSATION_VERSION 0x00000003
+#define GNUNET_CONVERSATION_VERSION 0x00000004
/**
* Handle to identify a particular caller. A caller is an entity that
{
/**
- * Version of the phone record, for now always zero. We may
+ * Version of the phone record, for now always one. We may
* use other versions for anonymously hosted phone lines in
* the future.
*/
uint32_t version GNUNET_PACKED;
/**
- * Phone line to use at the peer.
+ * Reserved. In v1. always zero.
*/
- uint32_t line GNUNET_PACKED;
+ uint32_t reserved GNUNET_PACKED;
/**
* Identity of the peer hosting the phone service.
*/
struct GNUNET_PeerIdentity peer;
+ /**
+ * Phone line (CADET port) to connect to.
+ */
+ struct GNUNET_HashCode line_port;
+
};
GNUNET_NETWORK_STRUCT_END
#endif
#endif
+
+/** @} */ /* end of group */