/usr/include/x86_64-linux-gnu/aj_peer.h is in liballjoyntcl-dev-1504 15.04b-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 | #ifndef _AJ_PEER_H
#define _AJ_PEER_H
/**
* @file aj_peer.h
* @defgroup aj_peer Implementation of org.alljoyn.Bus.Peer Object
* @{
*/
/******************************************************************************
* Copyright AllSeen Alliance. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
******************************************************************************/
#include "aj_target.h"
#include "aj_msg.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* Handle an exchange guids message
*
* @param msg The exchange guids message
* @param reply The guids reply message
*
* @return Return AJ_Status
* - AJ_OK if successfully handled
* - AJ_ERR_RESOURCES if the arguments are too big to marshal into the message buffer
* - AJ_ERR_WRITE if there was a write failure
* - AJ_ERR_UNEXPECTED if any of the argument types in the signature is not a basic type
*/
AJ_Status AJ_PeerHandleExchangeGUIDs(AJ_Message* msg, AJ_Message* reply);
/**
* Handle an exchange guids reply message
*
* @param msg The exchange guids reply
*
* @return Return AJ_Status
* - AJ_OK if successfully handled
* - AJ_ERR_UNMARSHAL if the message was badly formed
* - AJ_ERR_RESOURCES if the message header is too big to unmarshal into the attached buffer
* - AJ_ERR_TIMEOUT if there was no message to unmarshal within the timeout period
* - AJ_ERR_READ if there was a read failure
*/
AJ_Status AJ_PeerHandleExchangeGUIDsReply(AJ_Message* msg);
/**
* Handle a gen session key message
*
* @param msg The gen session key message
* @param reply The gen session key reply message
*
* @return Return AJ_Status
*/
AJ_Status AJ_PeerHandleGenSessionKey(AJ_Message* msg, AJ_Message* reply);
/**
* Handle a gen session key reply message
*
* @param msg The gen session key reply message
*
* @return Return AJ_Status
*/
AJ_Status AJ_PeerHandleGenSessionKeyReply(AJ_Message* msg);
/**
* Handle an exchange group keys message
*
* @param msg The exchange group keys message
* @param reply The group keys reply message
*
* @return Return AJ_Status
*/
AJ_Status AJ_PeerHandleExchangeGroupKeys(AJ_Message* msg, AJ_Message* reply);
/**
* Handle an exchange group keys reply message
*
* @param msg The exchange group keys reply message
*
* @return Return AJ_Status
*/
AJ_Status AJ_PeerHandleExchangeGroupKeysReply(AJ_Message* msg);
/**
* Callback function prototype for the function called when an authentication completes or fails.
*
* @param context The context provided when AJ_PeerAuthenticate() was called.
* @param status A status code indicating if the authentication was succesful
* - AJ_OK indicates the authentication succeeded
* - AJ_ERR_SECURITY indicates the authentication failed
* - AJ_ERR_TIMEOUT indciates the authentication timed-out
*/
typedef void (*AJ_PeerAuthenticateCallback)(const void* context, AJ_Status status);
/**
* Initiate a secure connection to a remote peer authenticating if necessary.
*
* @param bus The bus attachment
* @param peerName The bus name of the remove peer to secure.
* @param callback A function to be called when the authentication completes
* @param cbContext A caller provided context to pass to the callback function
*
* @return Return AJ_Status
* - AJ_OK if the request was sent
* - An error status otherwise
*/
AJ_Status AJ_PeerAuthenticate(AJ_BusAttachment* bus, const char* peerName, AJ_PeerAuthenticateCallback callback, void* cbContext);
/**
* Handle an exchange suites message
*
* @param msg The exchange suites message
* @param reply The exchange suites reply message
*
* @return Return AJ_Status
* - AJ_OK if successful
* - AJ_ERR_RESOURCES if resource error or authentication in progress
* - AJ_ERR_SECURITY if generic security violation
*/
AJ_Status AJ_PeerHandleExchangeSuites(AJ_Message* msg, AJ_Message* reply);
/**
* Handle an exchange suites reply message
*
* @param msg The exchange suites reply message
*
* @return Return AJ_Status
* - AJ_OK if successful
* - AJ_ERR_RESOURCES if resource error or authentication in progress
* - AJ_ERR_SECURITY if generic security violation
*/
AJ_Status AJ_PeerHandleExchangeSuitesReply(AJ_Message* msg);
/**
* Handle a key exchange message
*
* @param msg The key exchange message
* @param reply The key exchange reply message
*
* @return Return AJ_Status
* - AJ_OK if successful
* - AJ_ERR_RESOURCES if resource error or authentication in progress
* - AJ_ERR_SECURITY if generic security violation
*/
AJ_Status AJ_PeerHandleKeyExchange(AJ_Message* msg, AJ_Message* reply);
/**
* Handle a key exchange reply message
*
* @param msg The key exchange reply message
*
* @return Return AJ_Status
* - AJ_OK if successful
* - AJ_ERR_RESOURCES if resource error or authentication in progress
* - AJ_ERR_SECURITY if generic security violation
*/
AJ_Status AJ_PeerHandleKeyExchangeReply(AJ_Message* msg);
/**
* Handle a key authentication message
*
* @param msg The key authentication message
* @param reply The key authentication reply message
*
* @return Return AJ_Status
* - AJ_OK if successful
* - AJ_ERR_RESOURCES if resource error or authentication in progress
* - AJ_ERR_SECURITY if generic security violation
*/
AJ_Status AJ_PeerHandleKeyAuthentication(AJ_Message* msg, AJ_Message* reply);
/**
* Handle a key authentication reply message
*
* @param msg The key authentication reply message
*
* @return Return AJ_Status
* - AJ_OK if successful
* - AJ_ERR_RESOURCES if resource error or authentication in progress
* - AJ_ERR_SECURITY if generic security violation
*/
AJ_Status AJ_PeerHandleKeyAuthenticationReply(AJ_Message* msg);
/**
* Clear the authentication handshake context
*/
void AJ_ClearAuthContext();
#ifdef __cplusplus
}
#endif
/**
* @}
*/
#endif
|