src/daemon/dlt_daemon_common.h

   1 /**\r
   2  * @licence app begin@\r
   3  * Copyright (C) 2012  BMW AG\r
   4  *\r
   5  * This file is part of GENIVI Project Dlt - Diagnostic Log and Trace console apps.\r
   6  *\r
   7  * Contributions are licensed to the GENIVI Alliance under one or more\r
   8  * Contribution License Agreements.\r
   9  *\r
  10  * \copyright\r
  11  * This Source Code Form is subject to the terms of the\r
  12  * Mozilla Public License, v. 2.0. If a  copy of the MPL was not distributed with\r
  13  * this file, You can obtain one at http://mozilla.org/MPL/2.0/.\r
  14  *\r
  15  *\r
  16  * \author Alexander Wenzel <alexander.aw.wenzel@bmw.de> BMW 2011-2012\r
  17  *\r
  18  * \file dlt_daemon_common.h\r
  19  * For further information see http://www.genivi.org/.\r
  20  * @licence end@\r
  21  */\r
  22 \r
  23 \r
  24 /*******************************************************************************\r
  25 **                                                                            **\r
  26 **  SRC-MODULE: dlt_daemon_common.h                                           **\r
  27 **                                                                            **\r
  28 **  TARGET    : linux                                                         **\r
  29 **                                                                            **\r
  30 **  PROJECT   : DLT                                                           **\r
  31 **                                                                            **\r
  32 **  AUTHOR    : Alexander Wenzel Alexander.AW.Wenzel@bmw.de                   **\r
  33 **              Markus Klein                                                  **\r
  34 **                                                                            **\r
  35 **  PURPOSE   :                                                               **\r
  36 **                                                                            **\r
  37 **  REMARKS   :                                                               **\r
  38 **                                                                            **\r
  39 **  PLATFORM DEPENDANT [yes/no]: yes                                          **\r
  40 **                                                                            **\r
  41 **  TO BE CHANGED BY USER [yes/no]: no                                        **\r
  42 **                                                                            **\r
  43 *******************************************************************************/\r
  44 \r
  45 /*******************************************************************************\r
  46 **                      Author Identity                                       **\r
  47 ********************************************************************************\r
  48 **                                                                            **\r
  49 ** Initials     Name                       Company                            **\r
  50 ** --------     -------------------------  ---------------------------------- **\r
  51 **  aw          Alexander Wenzel           BMW                                **\r
  52 **  mk          Markus Klein               Fraunhofer ESK                     **\r
  53 *******************************************************************************/\r
  54 \r
  55 /*******************************************************************************\r
  56 **                      Revision Control History                              **\r
  57 *******************************************************************************/\r
  58 \r
  59 /*\r
  60  * $LastChangedRevision: 1670 $\r
  61  * $LastChangedDate: 2011-04-08 15:12:06 +0200 (Fr, 08. Apr 2011) $\r
  62  * $LastChangedBy$\r
  63  Initials    Date         Comment\r
  64  aw          15.02.2010   initial\r
  65  */\r
  66 \r
  67 #ifndef DLT_DAEMON_COMMON_H\r
  68 #define DLT_DAEMON_COMMON_H\r
  69 \r
  70 /**\r
  71   \defgroup daemonapi DLT Daemon API\r
  72   \addtogroup daemonapi\r
  73   \{\r
  74 */\r
  75 \r
  76 #include <limits.h>\r
  77 #include <semaphore.h>\r
  78 #include "dlt_common.h"\r
  79 #include "dlt_user.h"\r
  80 \r
  81 #ifdef __cplusplus\r
  82 extern "C" {\r
  83 #endif\r
  84 \r
  85 #define DLT_DAEMON_RINGBUFFER_MIN_SIZE    500000 /**< Ring buffer size for storing log messages while no client is connected */\r
  86 #define DLT_DAEMON_RINGBUFFER_MAX_SIZE  10000000 /**< Ring buffer size for storing log messages while no client is connected */\r
  87 #define DLT_DAEMON_RINGBUFFER_STEP_SIZE   500000 /**< Ring buffer size for storing log messages while no client is connected */\r
  88 \r
  89 #define DLT_DAEMON_STORE_TO_BUFFER -2   /**< Constant value to identify the command "store to buffer" */\r
  90 \r
  91 /* Use a semaphore or mutex from your OS to prevent concurrent access to the DLT buffer. */\r
  92 \r
  93 #define DLT_DAEMON_SEM_LOCK() { sem_wait(&dlt_daemon_mutex); }\r
  94 #define DLT_DAEMON_SEM_FREE() { sem_post(&dlt_daemon_mutex); }\r
  95 extern sem_t dlt_daemon_mutex;\r
  96 \r
  97 \r
  98 /**\r
  99  * The parameters of a daemon application.\r
 100  */\r
 101 typedef struct\r
 102 {\r
 103         char  apid[DLT_ID_SIZE];                  /**< application id */\r
 104         pid_t pid;                   /**< process id of user application */\r
 105         int user_handle;    /**< connection handle for connection to user application */\r
 106         char *application_description; /**< context description */\r
 107         int num_contexts; /**< number of contexts for this application */\r
 108 } DltDaemonApplication;\r
 109 \r
 110 /**\r
 111  * The parameters of a daemon context.\r
 112  */\r
 113 typedef struct\r
 114 {\r
 115         char apid[DLT_ID_SIZE];               /**< application id */\r
 116         char ctid[DLT_ID_SIZE];                 /**< context id */\r
 117         int8_t log_level;               /**< the current log level of the context */\r
 118         int8_t trace_status;    /**< the current trace status of the context */\r
 119         int log_level_pos;  /**< offset of context in context field on user application */\r
 120         int user_handle;    /**< connection handle for connection to user application */\r
 121         char *context_description; /**< context description */\r
 122 } DltDaemonContext;\r
 123 \r
 124 /**\r
 125  * The parameters of a daemon.\r
 126  */\r
 127 typedef struct\r
 128 {\r
 129         int num_contexts;               /**< Total number of all contexts in all applications */\r
 130         DltDaemonContext *contexts;         /**< Pointer to contexts */\r
 131         int num_applications;                   /**< Number of available application */\r
 132         DltDaemonApplication *applications; /**< Pointer to applications */\r
 133         int8_t default_log_level;          /**< Default log level (of daemon) */\r
 134         int8_t default_trace_status;       /**< Default trace status (of daemon) */\r
 135         int message_buffer_overflow;   /**< Set to one, if buffer overflow has occured, zero otherwise */\r
 136         int runtime_context_cfg_loaded;         /**< Set to one, if runtime context configuration has been loaded, zero otherwise */\r
 137         char ecuid[DLT_ID_SIZE];       /**< ECU ID of daemon */\r
 138         int sendserialheader;          /**< 1: send serial header; 0 don't send serial header */\r
 139         int timingpackets;              /**< 1: send continous timing packets; 0 don't send continous timing packets */\r
 140         DltBuffer client_ringbuffer; /**< Ring-buffer for storing received logs while no client connection is available */\r
 141         char runtime_application_cfg[PATH_MAX + 1]; /**< Path and filename of persistent application configuration. Set to path max, as it specifies a full path*/\r
 142         char runtime_context_cfg[PATH_MAX + 1]; /**< Path and filename of persistent context configuration */\r
 143         char runtime_configuration[PATH_MAX + 1]; /**< Path and filename of persistent configuration */\r
 144     DltUserLogMode mode;        /**< Mode used for tracing: off, external, internal, both */\r
 145     char state;                         /**< state for tracing: 0 = no client connected, 1 = client connected */\r
 146 } DltDaemon;\r
 147 \r
 148 /**\r
 149  * Initialise the dlt daemon structure\r
 150  * This function must be called before using further dlt daemon structure\r
 151  * @param daemon pointer to dlt daemon structure\r
 152  * @param runtime_directory Directory of persistent configuration\r
 153  * @param verbose if set to true verbose information is printed out.\r
 154  * @return negative value if there was an error\r
 155  */\r
 156 int dlt_daemon_init(DltDaemon *daemon,const char *runtime_directory,int verbose);\r
 157 /**\r
 158  * De-Initialise the dlt daemon structure\r
 159  * @param daemon pointer to dlt daemon structure\r
 160  * @param verbose if set to true verbose information is printed out.\r
 161  * @return negative value if there was an error\r
 162  */\r
 163 int dlt_daemon_free(DltDaemon *daemon,int verbose);\r
 164 \r
 165 /**\r
 166  * Add (new) application to internal application management\r
 167  * @param daemon pointer to dlt daemon structure\r
 168  * @param apid pointer to application id\r
 169  * @param pid process id of user application\r
 170  * @param description description of application\r
 171  * @param verbose if set to true verbose information is printed out.\r
 172  * @return Pointer to added context, null pointer on error\r
 173  */\r
 174 DltDaemonApplication* dlt_daemon_application_add(DltDaemon *daemon,char *apid,pid_t pid,char *description, int verbose);\r
 175 /**\r
 176  * Delete application from internal application management\r
 177  * @param daemon pointer to dlt daemon structure\r
 178  * @param application pointer to application to be deleted\r
 179  * @param verbose if set to true verbose information is printed out.\r
 180  * @return negative value if there was an error\r
 181  */\r
 182 int dlt_daemon_application_del(DltDaemon *daemon, DltDaemonApplication *application, int verbose);\r
 183 /**\r
 184  * Find application with specific application id\r
 185  * @param daemon pointer to dlt daemon structure\r
 186  * @param apid pointer to application id\r
 187  * @param verbose if set to true verbose information is printed out.\r
 188  * @return Pointer to application, null pointer on error or not found\r
 189  */\r
 190 DltDaemonApplication* dlt_daemon_application_find(DltDaemon *daemon,char *apid,int verbose);\r
 191 /**\r
 192  * Load applications from file to internal context management\r
 193  * @param daemon pointer to dlt daemon structure\r
 194  * @param filename name of file to be used for loading\r
 195  * @param verbose if set to true verbose information is printed out.\r
 196  * @return negative value if there was an error\r
 197  */\r
 198 int dlt_daemon_applications_load(DltDaemon *daemon,const char *filename, int verbose);\r
 199 /**\r
 200  * Save applications from internal context management to file\r
 201  * @param daemon pointer to dlt daemon structure\r
 202  * @param filename name of file to be used for saving\r
 203  * @param verbose if set to true verbose information is printed out.\r
 204  * @return negative value if there was an error\r
 205  */\r
 206 int dlt_daemon_applications_save(DltDaemon *daemon,const char *filename, int verbose);\r
 207 /**\r
 208  * Invalidate all applications fd, if fd is reused\r
 209  * @param daemon pointer to dlt daemon structure\r
 210  * @param fd file descriptor\r
 211  * @param verbose if set to true verbose information is printed out.\r
 212  * @return negative value if there was an error\r
 213  */\r
 214 int dlt_daemon_applications_invalidate_fd(DltDaemon *daemon,int fd,int verbose);\r
 215 /**\r
 216  * Clear all applications in internal application management\r
 217  * @param daemon pointer to dlt daemon structure\r
 218  * @param verbose if set to true verbose information is printed out.\r
 219  * @return negative value if there was an error\r
 220  */\r
 221 int dlt_daemon_applications_clear(DltDaemon *daemon,int verbose);\r
 222 \r
 223 /**\r
 224  * Add (new) context to internal context management\r
 225  * @param daemon pointer to dlt daemon structure\r
 226  * @param apid pointer to application id\r
 227  * @param ctid pointer to context id\r
 228  * @param log_level log level of context\r
 229  * @param trace_status trace status of context\r
 230  * @param log_level_pos offset of context in context field on user application\r
 231  * @param user_handle connection handle for connection to user application\r
 232  * @param description description of context\r
 233  * @param verbose if set to true verbose information is printed out.\r
 234  * @return Pointer to added context, null pointer on error\r
 235  */\r
 236 DltDaemonContext* dlt_daemon_context_add(DltDaemon *daemon,char *apid,char *ctid,int8_t log_level,int8_t trace_status,int log_level_pos, int user_handle,char *description,int verbose);\r
 237 /**\r
 238  * Delete context from internal context management\r
 239  * @param daemon pointer to dlt daemon structure\r
 240  * @param context pointer to context to be deleted\r
 241  * @param verbose if set to true verbose information is printed out.\r
 242  * @return negative value if there was an error\r
 243  */\r
 244 int dlt_daemon_context_del(DltDaemon *daemon, DltDaemonContext* context, int verbose);\r
 245 /**\r
 246  * Find context with specific application id and context id\r
 247  * @param daemon pointer to dlt daemon structure\r
 248  * @param apid pointer to application id\r
 249  * @param ctid pointer to context id\r
 250  * @param verbose if set to true verbose information is printed out.\r
 251  * @return Pointer to context, null pointer on error or not found\r
 252  */\r
 253 DltDaemonContext* dlt_daemon_context_find(DltDaemon *daemon,char *apid,char *ctid,int verbose);\r
 254 /**\r
 255  * Invalidate all contexts fd, if fd is reused\r
 256  * @param daemon pointer to dlt daemon structure\r
 257  * @param fd file descriptor\r
 258  * @param verbose if set to true verbose information is printed out.\r
 259  * @return negative value if there was an error\r
 260  */\r
 261 int dlt_daemon_contexts_invalidate_fd(DltDaemon *daemon,int fd,int verbose);\r
 262 /**\r
 263  * Clear all contexts in internal context management\r
 264  * @param daemon pointer to dlt daemon structure\r
 265  * @param verbose if set to true verbose information is printed out.\r
 266  * @return negative value if there was an error\r
 267  */\r
 268 int dlt_daemon_contexts_clear(DltDaemon *daemon,int verbose);\r
 269 /**\r
 270  * Load contexts from file to internal context management\r
 271  * @param daemon pointer to dlt daemon structure\r
 272  * @param filename name of file to be used for loading\r
 273  * @param verbose if set to true verbose information is printed out.\r
 274  * @return negative value if there was an error\r
 275  */\r
 276 int dlt_daemon_contexts_load(DltDaemon *daemon,const char *filename, int verbose);\r
 277 /**\r
 278  * Save contexts from internal context management to file\r
 279  * @param daemon pointer to dlt daemon structure\r
 280  * @param filename name of file to be used for saving\r
 281  * @param verbose if set to true verbose information is printed out.\r
 282  * @return negative value if there was an error\r
 283  */\r
 284 int dlt_daemon_contexts_save(DltDaemon *daemon,const char *filename, int verbose);\r
 285 /**\r
 286  * Load persistant configuration\r
 287  * @param daemon pointer to dlt daemon structure\r
 288  * @param filename name of file to be used for loading\r
 289  * @param verbose if set to true verbose information is printed out.\r
 290  * @return negative value if there was an error\r
 291  */\r
 292 int dlt_daemon_configuration_load(DltDaemon *daemon,const char *filename, int verbose);\r
 293 /**\r
 294  * Save configuration persistantly\r
 295  * @param daemon pointer to dlt daemon structure\r
 296  * @param filename name of file to be used for saving\r
 297  * @param verbose if set to true verbose information is printed out.\r
 298  * @return negative value if there was an error\r
 299  */\r
 300 int dlt_daemon_configuration_save(DltDaemon *daemon,const char *filename, int verbose);\r
 301 \r
 302 \r
 303 /**\r
 304  * Send user message DLT_USER_MESSAGE_LOG_LEVEL to user application\r
 305  * @param daemon pointer to dlt daemon structure\r
 306  * @param context pointer to context for response\r
 307  * @param verbose if set to true verbose information is printed out.\r
 308  * @return negative value if there was an error\r
 309  */\r
 310 int dlt_daemon_user_send_log_level(DltDaemon *daemon,DltDaemonContext *context, int verbose);\r
 311 \r
 312 /**\r
 313  * Send user message DLT_USER_MESSAGE_LOG_STATE to user application\r
 314  * @param daemon pointer to dlt daemon structure\r
 315  * @param app pointer to application for response\r
 316  * @param verbose if set to true verbose information is printed out.\r
 317  * @return negative value if there was an error\r
 318  */\r
 319 int dlt_daemon_user_send_log_state(DltDaemon *daemon,DltDaemonApplication *app,int verbose);\r
 320 \r
 321 /**\r
 322  * Send user messages to all user applications using default context, or trace status\r
 323  * to update those values\r
 324  * @param daemon pointer to dlt daemon structure\r
 325  * @param verbose if set to true verbose information is printed out.\r
 326  */\r
 327 void dlt_daemon_user_send_default_update(DltDaemon *daemon, int verbose);\r
 328 \r
 329 /**\r
 330  * Send user messages to all user applications the log status\r
 331  * everytime the client is connected or disconnected.\r
 332  * @param daemon pointer to dlt daemon structure\r
 333  * @param verbose if set to true verbose information is printed out.\r
 334  */\r
 335 void dlt_daemon_user_send_all_log_state(DltDaemon *daemon, int verbose);\r
 336 \r
 337 /**\r
 338  * Process received control message from dlt client\r
 339  * @param sock connection handle used for sending response\r
 340  * @param daemon pointer to dlt daemon structure\r
 341  * @param msg pointer to received control message\r
 342  * @param verbose if set to true verbose information is printed out.\r
 343  */\r
 344 int dlt_daemon_control_process_control(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 345 /**\r
 346  * Generate response to control message from dlt client\r
 347  * @param sock connection handle used for sending response\r
 348  * @param daemon pointer to dlt daemon structure\r
 349  * @param service_id service id of control message\r
 350  * @param status status of response (e.g. ok, not supported, error)\r
 351  * @param verbose if set to true verbose information is printed out.\r
 352  */\r
 353 void dlt_daemon_control_service_response(int sock, DltDaemon *daemon, uint32_t service_id, int8_t status, int verbose);\r
 354 /**\r
 355  * Send out response message to dlt client\r
 356  * @param sock connection handle used for sending response\r
 357  * @param daemon pointer to dlt daemon structure\r
 358  * @param msg pointer to response message\r
 359  * @param appid pointer to application id to be used in response message\r
 360  * @param contid pointer to context id to be used in response message\r
 361  * @param verbose if set to true verbose information is printed out.\r
 362  */\r
 363 void dlt_daemon_control_send_control_message(int sock, DltDaemon *daemon, DltMessage *msg, char* appid, char* contid, int verbose);\r
 364 \r
 365 /**\r
 366  * Process and generate response to received sw injection control message\r
 367  * @param sock connection handle used for sending response\r
 368  * @param daemon pointer to dlt daemon structure\r
 369  * @param msg pointer to received sw injection control message\r
 370  * @param verbose if set to true verbose information is printed out.\r
 371  */\r
 372 void dlt_daemon_control_callsw_cinjection(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 373 /**\r
 374  * Process and generate response to received set log level control message\r
 375  * @param sock connection handle used for sending response\r
 376  * @param daemon pointer to dlt daemon structure\r
 377  * @param msg pointer to received control message\r
 378  * @param verbose if set to true verbose information is printed out.\r
 379  */\r
 380 void dlt_daemon_control_set_log_level(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 381 /**\r
 382  * Process and generate response to received set trace status control message\r
 383  * @param sock connection handle used for sending response\r
 384  * @param daemon pointer to dlt daemon structure\r
 385  * @param msg pointer to received control message\r
 386  * @param verbose if set to true verbose information is printed out.\r
 387  */\r
 388 void dlt_daemon_control_set_trace_status(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 389 /**\r
 390  * Process and generate response to received set default log level control message\r
 391  * @param sock connection handle used for sending response\r
 392  * @param daemon pointer to dlt daemon structure\r
 393  * @param msg pointer to received control message\r
 394  * @param verbose if set to true verbose information is printed out.\r
 395  */\r
 396 void dlt_daemon_control_set_default_log_level(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 397 /**\r
 398  * Process and generate response to received set default trace status control message\r
 399  * @param sock connection handle used for sending response\r
 400  * @param daemon pointer to dlt daemon structure\r
 401  * @param msg pointer to received control message\r
 402  * @param verbose if set to true verbose information is printed out.\r
 403  */\r
 404 void dlt_daemon_control_set_default_trace_status(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 405 /**\r
 406  * Process and generate response to set timing packets control message\r
 407  * @param sock connection handle used for sending response\r
 408  * @param daemon pointer to dlt daemon structure\r
 409  * @param msg pointer to received control message\r
 410  * @param verbose if set to true verbose information is printed out.\r
 411  */\r
 412 void dlt_daemon_control_set_timing_packets(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 413 /**\r
 414  * Process and generate response to received get software version control message\r
 415  * @param sock connection handle used for sending response\r
 416  * @param daemon pointer to dlt daemon structure\r
 417  * @param verbose if set to true verbose information is printed out.\r
 418  */\r
 419 void dlt_daemon_control_get_software_version(int sock, DltDaemon *daemon, int verbose);\r
 420 /**\r
 421  * Process and generate response to received get default log level control message\r
 422  * @param sock connection handle used for sending response\r
 423  * @param daemon pointer to dlt daemon structure\r
 424  * @param verbose if set to true verbose information is printed out.\r
 425  */\r
 426 void dlt_daemon_control_get_default_log_level(int sock, DltDaemon *daemon, int verbose);\r
 427 /**\r
 428  * Process and generate response to received get log info control message\r
 429  * @param sock connection handle used for sending response\r
 430  * @param daemon pointer to dlt daemon structure\r
 431  * @param msg pointer to received control message\r
 432  * @param verbose if set to true verbose information is printed out.\r
 433  */\r
 434 void dlt_daemon_control_get_log_info(int sock, DltDaemon *daemon, DltMessage *msg, int verbose);\r
 435 /**\r
 436  * Process and generate response to message buffer overflow control message\r
 437  * @param sock connection handle used for sending response\r
 438  * @param daemon pointer to dlt daemon structure\r
 439  * @param verbose if set to true verbose information is printed out.\r
 440  */\r
 441 void dlt_daemon_control_message_buffer_overflow(int sock, DltDaemon *daemon, int verbose);\r
 442 /**\r
 443  * Process reset to factory default control message\r
 444  * @param daemon pointer to dlt daemon structure\r
 445  * @param filename name of file containing the runtime defaults for applications\r
 446  * @param filename1 name of file containing the runtime defaults for contexts\r
 447  * @param verbose if set to true verbose information is printed out.\r
 448  */\r
 449 void dlt_daemon_control_reset_to_factory_default(DltDaemon *daemon,const char *filename, const char *filename1, int verbose);\r
 450 /**\r
 451  * Send time control message\r
 452  * @param sock connection handle used for sending response\r
 453  * @param daemon pointer to dlt daemon structure\r
 454  * @param verbose if set to true verbose information is printed out.\r
 455  */\r
 456 void dlt_daemon_control_message_time(int sock, DltDaemon *daemon, int verbose);\r
 457 \r
 458 /**\r
 459  * Send ECU version information\r
 460  * @param sock connection handle used for sending response\r
 461  * @param daemon pointer to dlt daemon structure\r
 462  * @param version string containing the version information\r
 463  * @param verbose if set to true verbose information is printed out.\r
 464  */\r
 465 void dlt_daemon_control_send_ecu_version(int sock, DltDaemon *daemon, const char *version, int verbose);\r
 466 #ifdef __cplusplus\r
 467 }\r
 468 #endif\r
 469 \r
 470 /**\r
 471   \}\r
 472 */\r
 473 \r
 474 #endif /* DLT_DAEMON_COMMON_H */\r