source: lib/trace_parallel.c @ 76291d1

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivelibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since 76291d1 was 76291d1, checked in by Richard Sanger <rsangerarj@…>, 6 years ago

Add a quick mockup of shanes interface using functions for each message

I.e. set a function for MESSAGE_PACKET etc. which only receives packets.

Ported tracestats_parallel to use this interface.

Note it is not yet complete, however should give a feel of how it will work.
And provide a good work around to the thread issues on older machines.

  • Property mode set to 100644
File size: 76.6 KB
Line 
1/*
2 * This file is part of libtrace
3 *
4 * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton,
5 * New Zealand.
6 *
7 * All rights reserved.
8 *
9 * This code has been developed by the University of Waikato WAND
10 * research group. For further information please see http://www.wand.net.nz/
11 *
12 * libtrace is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
16 *
17 * libtrace is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20 * GNU General Public License for more details.
21 *
22 * You should have received a copy of the GNU General Public License
23 * along with libtrace; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
25 *
26 * $Id$
27 *
28 */
29
30
31#define _GNU_SOURCE
32#include "common.h"
33#include "config.h"
34#include <assert.h>
35#include <errno.h>
36#include <fcntl.h>
37#include <stdio.h>
38#include <stdlib.h>
39#include <string.h>
40#include <sys/stat.h>
41#include <sys/types.h>
42#ifndef WIN32
43#include <sys/socket.h>
44#endif
45#include <stdarg.h>
46#include <sys/param.h>
47
48#ifdef HAVE_LIMITS_H
49#  include <limits.h>
50#endif
51
52#ifdef HAVE_SYS_LIMITS_H
53#  include <sys/limits.h>
54#endif
55
56#ifdef HAVE_NET_IF_ARP_H
57#  include <net/if_arp.h>
58#endif
59
60#ifdef HAVE_NET_IF_H
61#  include <net/if.h>
62#endif
63
64#ifdef HAVE_NETINET_IN_H
65#  include <netinet/in.h>
66#endif
67
68#ifdef HAVE_NET_ETHERNET_H
69#  include <net/ethernet.h>
70#endif
71
72#ifdef HAVE_NETINET_IF_ETHER_H
73#  include <netinet/if_ether.h>
74#endif
75
76#include <time.h>
77#ifdef WIN32
78#include <sys/timeb.h>
79#endif
80
81#include "libtrace.h"
82#include "libtrace_int.h"
83
84#ifdef HAVE_PCAP_BPF_H
85#  include <pcap-bpf.h>
86#else
87#  ifdef HAVE_NET_BPF_H
88#    include <net/bpf.h>
89#  endif
90#endif
91
92
93#include "libtrace_int.h"
94#include "format_helper.h"
95#include "rt_protocol.h"
96#include "hash_toeplitz.h"
97
98#include <pthread.h>
99#include <signal.h>
100#include <unistd.h>
101#include <ctype.h>
102
103static inline int delay_tracetime(libtrace_t *libtrace, libtrace_packet_t *packet, libtrace_thread_t *t);
104extern int libtrace_parallel;
105
106struct mem_stats {
107        struct memfail {
108           uint64_t cache_hit;
109           uint64_t ring_hit;
110           uint64_t miss;
111           uint64_t recycled;
112        } readbulk, read, write, writebulk;
113};
114
115// Grrr gcc wants this spelt out
116__thread struct mem_stats mem_hits = {{0},{0},{0},{0}};
117
118static void print_memory_stats() {
119#if 0
120        uint64_t total;
121#if defined(HAVE_PTHREAD_SETNAME_NP) && defined(__linux__)
122        char t_name[50];
123        pthread_getname_np(pthread_self(), t_name, sizeof(t_name));
124
125        fprintf(stderr, "Thread ID#%d - %s\n", (int) pthread_self(), t_name);
126#else
127        fprintf(stderr, "Thread ID#%d\n", (int) pthread_self());
128#endif
129
130        total = mem_hits.read.cache_hit + mem_hits.read.ring_hit + mem_hits.read.miss;
131        if (total) {
132                fprintf(stderr, "\tRead:\n\t---CHits=%"PRIu64"\n\t---RHits=%"PRIu64"\n\t---Misses=%"PRIu64"\n\t---Recycled=%"PRIu64"\n",
133                                mem_hits.read.cache_hit, mem_hits.read.ring_hit, mem_hits.read.miss, mem_hits.read.recycled);
134                fprintf(stderr, "\t---Total=%"PRIu64"\n\t---Miss %%=%f\n",
135                                total, (double) mem_hits.read.miss / (double) total * 100.0);
136        }
137
138        total = mem_hits.readbulk.cache_hit + mem_hits.readbulk.ring_hit + mem_hits.readbulk.miss;
139        if (total) {
140                fprintf(stderr, "\tReadbulk:\n\t---CHits=%"PRIu64"\n\t---RHits=%"PRIu64"\n\t---Misses=%"PRIu64"\n\t---Recycled=%"PRIu64"\n",
141                                mem_hits.readbulk.cache_hit, mem_hits.readbulk.ring_hit, mem_hits.readbulk.miss, mem_hits.readbulk.recycled);
142
143
144                fprintf(stderr, "\t---Total=%"PRIu64"\n\t---Miss %%=%f\n",
145                                total, (double) mem_hits.readbulk.miss / (double) total * 100.0);
146        }
147
148        total = mem_hits.write.cache_hit + mem_hits.write.ring_hit + mem_hits.write.miss;
149        if (total) {
150                fprintf(stderr, "\tWrite:\n\t---CHits=%"PRIu64"\n\t---RHits=%"PRIu64"\n\t---Misses=%"PRIu64"\n\t---Recycled=%"PRIu64"\n",
151                                mem_hits.write.cache_hit, mem_hits.write.ring_hit, mem_hits.write.miss, mem_hits.write.recycled);
152
153                fprintf(stderr, "\t---Total=%"PRIu64"\n\t---Miss %%=%f\n",
154                                total, (double) mem_hits.write.miss / (double) total * 100.0);
155        }
156
157        total = mem_hits.writebulk.cache_hit + mem_hits.writebulk.ring_hit + mem_hits.writebulk.miss;
158        if (total) {
159                fprintf(stderr, "\tWritebulk:\n\t---CHits=%"PRIu64"\n\t---RHits=%"PRIu64"\n\t---Misses=%"PRIu64"\n\t---Recycled=%"PRIu64"\n",
160                                mem_hits.writebulk.cache_hit, mem_hits.writebulk.ring_hit, mem_hits.writebulk.miss, mem_hits.writebulk.recycled);
161
162                fprintf(stderr, "\t---Total=%"PRIu64"\n\t---Miss %%=%f\n",
163                                total, (double) mem_hits.writebulk.miss / (double) total * 100.0);
164        }
165#endif
166}
167
168/*
169 * This can be used once the hasher thread has been started and internally after
170 * verify_configuration.
171 */
172DLLEXPORT bool trace_has_dedicated_hasher(libtrace_t * libtrace)
173{
174        return libtrace->hasher_thread.type == THREAD_HASHER;
175}
176
177DLLEXPORT bool trace_has_reporter(libtrace_t * libtrace)
178{
179        assert(libtrace->state != STATE_NEW);
180        return libtrace->reporter_thread.type == THREAD_REPORTER && libtrace->reporter;
181}
182
183/**
184 * When running the number of perpkt threads in use.
185 * TODO what if the trace is not running yet, or has finished??
186 *
187 * @brief libtrace_perpkt_thread_nb
188 * @param t The trace
189 * @return
190 */
191DLLEXPORT int libtrace_get_perpkt_count(libtrace_t * t) {
192        return t->perpkt_thread_count;
193}
194
195/**
196 * Changes the overall traces state and signals the condition.
197 *
198 * @param trace A pointer to the trace
199 * @param new_state The new state of the trace
200 * @param need_lock Set to true if libtrace_lock is not held, otherwise
201 *        false in the case the lock is currently held by this thread.
202 */
203static inline void libtrace_change_state(libtrace_t *trace,
204        const enum trace_state new_state, const bool need_lock)
205{
206        UNUSED enum trace_state prev_state;
207        if (need_lock)
208                pthread_mutex_lock(&trace->libtrace_lock);
209        prev_state = trace->state;
210        trace->state = new_state;
211
212        if (trace->config.debug_state)
213                fprintf(stderr, "Trace(%s) state changed from %s to %s\n",
214                        trace->uridata, get_trace_state_name(prev_state),
215                        get_trace_state_name(trace->state));
216
217        pthread_cond_broadcast(&trace->perpkt_cond);
218        if (need_lock)
219                pthread_mutex_unlock(&trace->libtrace_lock);
220}
221
222/**
223 * Changes a thread's state and broadcasts the condition variable. This
224 * should always be done when the lock is held.
225 *
226 * Additionally for perpkt threads the state counts are updated.
227 *
228 * @param trace A pointer to the trace
229 * @param t A pointer to the thread to modify
230 * @param new_state The new state of the thread
231 * @param need_lock Set to true if libtrace_lock is not held, otherwise
232 *        false in the case the lock is currently held by this thread.
233 */
234static inline void thread_change_state(libtrace_t *trace, libtrace_thread_t *t,
235        const enum thread_states new_state, const bool need_lock)
236{
237        enum thread_states prev_state;
238        if (need_lock)
239                pthread_mutex_lock(&trace->libtrace_lock);
240        prev_state = t->state;
241        t->state = new_state;
242        if (t->type == THREAD_PERPKT) {
243                --trace->perpkt_thread_states[prev_state];
244                ++trace->perpkt_thread_states[new_state];
245        }
246
247        if (trace->config.debug_state)
248                fprintf(stderr, "Thread %d state changed from %d to %d\n",
249                        (int) t->tid, prev_state, t->state);
250
251        if (trace->perpkt_thread_states[THREAD_FINISHED] == trace->perpkt_thread_count)
252                libtrace_change_state(trace, STATE_FINISHED, false);
253
254        pthread_cond_broadcast(&trace->perpkt_cond);
255        if (need_lock)
256                pthread_mutex_unlock(&trace->libtrace_lock);
257}
258
259/**
260 * This is valid once a trace is initialised
261 *
262 * @return True if the format supports parallel threads.
263 */
264static inline bool trace_supports_parallel(libtrace_t *trace)
265{
266        assert(trace);
267        assert(trace->format);
268        if (trace->format->pstart_input)
269                return true;
270        else
271                return false;
272}
273
274void libtrace_zero_thread(libtrace_thread_t * t) {
275        t->accepted_packets = 0;
276        t->filtered_packets = 0;
277        t->recorded_first = false;
278        t->tracetime_offset_usec = 0;
279        t->user_data = 0;
280        t->format_data = 0;
281        libtrace_zero_ringbuffer(&t->rbuffer);
282        t->trace = NULL;
283        t->ret = NULL;
284        t->type = THREAD_EMPTY;
285        t->perpkt_num = -1;
286}
287
288// Ints are aligned int is atomic so safe to read and write at same time
289// However write must be locked, read doesn't (We never try read before written to table)
290libtrace_thread_t * get_thread_table(libtrace_t *libtrace) {
291        int i = 0;
292        pthread_t tid = pthread_self();
293
294        for (;i<libtrace->perpkt_thread_count ;++i) {
295                if (pthread_equal(tid, libtrace->perpkt_threads[i].tid))
296                        return &libtrace->perpkt_threads[i];
297        }
298        return NULL;
299}
300
301static libtrace_thread_t * get_thread_descriptor(libtrace_t *libtrace) {
302        libtrace_thread_t *ret;
303        if (!(ret = get_thread_table(libtrace))) {
304                pthread_t tid = pthread_self();
305                // Check if we are reporter or something else
306                if (pthread_equal(tid, libtrace->reporter_thread.tid))
307                        ret = &libtrace->reporter_thread;
308                else if (pthread_equal(tid, libtrace->hasher_thread.tid))
309                        ret = &libtrace->hasher_thread;
310                else
311                        ret = NULL;
312        }
313        return ret;
314}
315
316DLLEXPORT void libtrace_make_packet_safe(libtrace_packet_t *pkt) {
317        // Duplicate the packet in standard malloc'd memory and free the
318        // original, This is a 1:1 exchange so is ocache count remains unchanged.
319        if (pkt->buf_control != TRACE_CTRL_PACKET) {
320                libtrace_packet_t *dup;
321                dup = trace_copy_packet(pkt);
322                /* Release the external buffer */
323                trace_fin_packet(pkt);
324                /* Copy the duplicated packet over the existing */
325                memcpy(pkt, dup, sizeof(libtrace_packet_t));
326        }
327}
328
329/**
330 * Makes a libtrace_result_t safe, used when pausing a trace.
331 * This will call libtrace_make_packet_safe if the result is
332 * a packet.
333 */
334DLLEXPORT void libtrace_make_result_safe(libtrace_result_t *res) {
335        if (res->type == RESULT_PACKET) {
336                libtrace_make_packet_safe(res->value.pkt);
337        }
338}
339
340/**
341 * Holds threads in a paused state, until released by broadcasting
342 * the condition mutex.
343 */
344static void trace_thread_pause(libtrace_t *trace, libtrace_thread_t *t) {
345        ASSERT_RET(pthread_mutex_lock(&trace->libtrace_lock), == 0);
346        thread_change_state(trace, t, THREAD_PAUSED, false);
347        while (trace->state == STATE_PAUSED || trace->state == STATE_PAUSING) {
348                ASSERT_RET(pthread_cond_wait(&trace->perpkt_cond, &trace->libtrace_lock), == 0);
349        }
350        thread_change_state(trace, t, THREAD_RUNNING, false);
351        ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
352}
353
354/**
355 * Sends a packet to the user, expects either a valid packet or a TICK packet.
356 *
357 * @param trace The trace
358 * @param t The current thread
359 * @param packet A pointer to the packet storage, which may be set to null upon
360 *               return, or a packet to be finished.
361 * @param tracetime If true packets are delayed to match with tracetime
362 * @return 0 is successful, otherwise if playing back in tracetime
363 *         READ_MESSAGE(-2) can be returned in which case the packet is not sent.
364 *
365 * @note READ_MESSAGE will only be returned if tracetime is true.
366 */
367static inline int dispatch_packet(libtrace_t *trace,
368                                  libtrace_thread_t *t,
369                                  libtrace_packet_t **packet,
370                                  bool tracetime) {
371
372        if ((*packet)->error > 0) {
373                if (tracetime) {
374                        if (delay_tracetime(trace, packet[0], t) == READ_MESSAGE)
375                                return READ_MESSAGE;
376                }
377                t->accepted_packets++;
378                libtrace_generic_t data = {.pkt = *packet};
379                if (trace->callbacks.message_packet)
380                        *packet = (*trace->callbacks.message_packet)(trace, t, data, trace->global_blob, t->user_data);
381                else
382                        *packet = (*trace->per_pkt)(trace, t, MESSAGE_PACKET, data, t);
383                trace_fin_packet(*packet);
384        } else {
385                assert((*packet)->error == READ_TICK);
386                libtrace_generic_t data = {.uint64 = trace_packet_get_order(*packet)};
387                (*trace->per_pkt)(trace, t, MESSAGE_TICK_COUNT, data, t);
388        }
389        return 0;
390}
391
392/**
393 * Sends a batch of packets to the user, expects either a valid packet or a
394 * TICK packet.
395 *
396 * @param trace The trace
397 * @param t The current thread
398 * @param packets [in,out] An array of packets, these may be null upon return
399 * @param nb_packets The total number of packets in the list
400 * @param empty [in,out] A pointer to an integer storing the first empty slot,
401 * upon return this is updated
402 * @param offset [in,out] The offset into the array, upon return this is updated
403 * @param tracetime If true packets are delayed to match with tracetime
404 * @return 0 is successful, otherwise if playing back in tracetime
405 *         READ_MESSAGE(-2) can be returned in which case the packet is not sent.
406 *
407 * @note READ_MESSAGE will only be returned if tracetime is true.
408 */
409static inline int dispatch_packets(libtrace_t *trace,
410                                  libtrace_thread_t *t,
411                                  libtrace_packet_t *packets[],
412                                  int nb_packets, int *empty, int *offset,
413                                  bool tracetime) {
414        for (;*offset < nb_packets; ++*offset) {
415                int ret;
416                ret = dispatch_packet(trace, t, &packets[*offset], tracetime);
417                if (ret == 0) {
418                        /* Move full slots to front as we go */
419                        if (packets[*offset]) {
420                                if (*empty != *offset) {
421                                        packets[*empty] = packets[*offset];
422                                        packets[*offset] = NULL;
423                                }
424                                ++*empty;
425                        }
426                } else {
427                        /* Break early */
428                        assert(ret == READ_MESSAGE);
429                        return READ_MESSAGE;
430                }
431        }
432
433        return 0;
434}
435
436/**
437 * Pauses a per packet thread, messages will not be processed when the thread
438 * is paused.
439 *
440 * This process involves reading packets if a hasher thread is used. As such
441 * this function can fail to pause due to errors when reading in which case
442 * the thread should be stopped instead.
443 *
444 *
445 * @brief trace_perpkt_thread_pause
446 * @return READ_ERROR(-1) or READ_EOF(0) or 1 if successfull
447 */
448static int trace_perpkt_thread_pause(libtrace_t *trace, libtrace_thread_t *t,
449                                     libtrace_packet_t *packets[],
450                                     int nb_packets, int *empty, int *offset) {
451        libtrace_packet_t * packet = NULL;
452
453        /* Let the user thread know we are going to pause */
454        (*trace->per_pkt)(trace, t, MESSAGE_PAUSING, (libtrace_generic_t){0}, t);
455
456        /* Send through any remaining packets (or messages) without delay */
457
458        /* First send those packets already read, as fast as possible
459         * This should never fail or check for messages etc. */
460        ASSERT_RET(dispatch_packets(trace, t, packets, nb_packets, empty,
461                                    offset, false), == 0);
462
463        libtrace_ocache_alloc(&trace->packet_freelist, (void **) &packet, 1, 1);
464        /* If a hasher thread is running, empty input queues so we don't lose data */
465        if (trace_has_dedicated_hasher(trace)) {
466                // The hasher has stopped by this point, so the queue shouldn't be filling
467                while(!libtrace_ringbuffer_is_empty(&t->rbuffer) || t->format_data) {
468                        int ret = trace->pread(trace, t, &packet, 1);
469                        if (ret == 1) {
470                                if (packet->error > 0) {
471                                        store_first_packet(trace, packet, t);
472                                }
473                                ASSERT_RET(dispatch_packet(trace, t, &packet, false), == 0);
474                                if (packet == NULL)
475                                        libtrace_ocache_alloc(&trace->packet_freelist, (void **) &packet, 1, 1);
476                        } else if (ret != READ_MESSAGE) {
477                                /* Ignore messages we pick these up next loop */
478                                assert (ret == READ_EOF || ret == READ_ERROR);
479                                /* Verify no packets are remaining */
480                                /* TODO refactor this sanity check out!! */
481                                while (!libtrace_ringbuffer_is_empty(&t->rbuffer)) {
482                                        ASSERT_RET(trace->pread(trace, t, &packet, 1), <= 0);
483                                        // No packets after this should have any data in them
484                                        assert(packet->error <= 0);
485                                }
486                                libtrace_ocache_free(&trace->packet_freelist, (void **) &packet, 1, 1);
487                                return -1;
488                        }
489                }
490        }
491        libtrace_ocache_free(&trace->packet_freelist, (void **) &packet, 1, 1);
492
493        /* Now we do the actual pause, this returns when we resumed */
494        trace_thread_pause(trace, t);
495        (*trace->per_pkt)(trace, t, MESSAGE_RESUMING, (libtrace_generic_t){0}, t);
496        return 1;
497}
498
499/**
500 * The is the entry point for our packet processing threads.
501 */
502static void* perpkt_threads_entry(void *data) {
503        libtrace_t *trace = (libtrace_t *)data;
504        libtrace_thread_t *t;
505        libtrace_message_t message = {0};
506        libtrace_packet_t *packets[trace->config.burst_size];
507        size_t i;
508        //int ret;
509        /* The current reading position into the packets */
510        int offset = 0;
511        /* The number of packets last read */
512        int nb_packets = 0;
513        /* The offset to the first NULL packet upto offset */
514        int empty = 0;
515
516        /* Wait until trace_pstart has been completed */
517        ASSERT_RET(pthread_mutex_lock(&trace->libtrace_lock), == 0);
518        t = get_thread_table(trace);
519        assert(t);
520        if (trace->state == STATE_ERROR) {
521                thread_change_state(trace, t, THREAD_FINISHED, false);
522                ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
523                pthread_exit(NULL);
524        }
525        ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
526
527        if (trace->format->pregister_thread) {
528                trace->format->pregister_thread(trace, t, !trace_has_dedicated_hasher(trace));
529        }
530
531        /* Fill our buffer with empty packets */
532        memset(&packets, 0, sizeof(void*) * trace->config.burst_size);
533        libtrace_ocache_alloc(&trace->packet_freelist, (void **) packets,
534                              trace->config.burst_size,
535                              trace->config.burst_size);
536
537        /* ~~~~~~~~~~~ Setup complete now we loop ~~~~~~~~~~~~~~~ */
538
539        /* Let the per_packet function know we have started */
540        if (trace->callbacks.message_starting)
541                (*trace->callbacks.message_starting)(trace, t, (libtrace_generic_t){0}, trace->global_blob, t->user_data);
542        else
543                (*trace->per_pkt)(trace, t, MESSAGE_STARTING, (libtrace_generic_t){0}, t);
544
545        if (trace->callbacks.message_resuming)
546                (*trace->callbacks.message_resuming)(trace, t, (libtrace_generic_t){0}, trace->global_blob, t->user_data);
547        else
548                (*trace->per_pkt)(trace, t, MESSAGE_RESUMING, (libtrace_generic_t){0}, t);
549
550        for (;;) {
551
552                if (libtrace_message_queue_try_get(&t->messages, &message) != LIBTRACE_MQ_FAILED) {
553                        int ret;
554                        switch (message.code) {
555                                case MESSAGE_DO_PAUSE: // This is internal
556                                        ret = trace_perpkt_thread_pause(trace, t,
557                                              packets, nb_packets, &empty, &offset);
558                                        if (ret == READ_EOF) {
559                                                goto eof;
560                                        } else if (ret == READ_ERROR) {
561                                                goto error;
562                                        }
563                                        assert(ret == 1);
564                                        continue;
565                                case MESSAGE_DO_STOP: // This is internal
566                                        goto eof;
567                        }
568                        (*trace->per_pkt)(trace, t, message.code, message.data, message.sender);
569                        /* Continue and the empty messages out before packets */
570                        continue;
571                }
572
573
574                /* Do we need to read a new set of packets MOST LIKELY we do */
575                if (offset == nb_packets) {
576                        /* Refill the packet buffer */
577                        if (empty != nb_packets) {
578                                // Refill the empty packets
579                                libtrace_ocache_alloc(&trace->packet_freelist,
580                                                      (void **) &packets[empty],
581                                                      nb_packets - empty,
582                                                      nb_packets - empty);
583                        }
584                        if (!trace->pread) {
585                                assert(packets[0]);
586                                nb_packets = trace_read_packet(trace, packets[0]);
587                                packets[0]->error = nb_packets;
588                                if (nb_packets > 0)
589                                        nb_packets = 1;
590                        } else {
591                                nb_packets = trace->pread(trace, t, packets, trace->config.burst_size);
592                        }
593                        offset = 0;
594                        empty = 0;
595                }
596
597                /* Handle error/message cases */
598                if (nb_packets > 0) {
599                        /* Store the first packet */
600                        if (packets[0]->error > 0) {
601                                store_first_packet(trace, packets[0], t);
602                        }
603                        dispatch_packets(trace, t, packets, nb_packets, &empty,
604                                         &offset, trace->tracetime);
605                } else {
606                        switch (nb_packets) {
607                        case READ_EOF:
608                                goto eof;
609                        case READ_ERROR:
610                                goto error;
611                        case READ_MESSAGE:
612                                nb_packets = 0;
613                                continue;
614                        default:
615                                fprintf(stderr, "Unexpected error %d!!\n", nb_packets);
616                                goto error;
617                        }
618                }
619
620        }
621
622error:
623        message.code = MESSAGE_DO_STOP;
624        message.sender = t;
625        message.data.uint64 = 0;
626        trace_message_perpkts(trace, &message);
627eof:
628        /* ~~~~~~~~~~~~~~ Trace is finished do tear down ~~~~~~~~~~~~~~~~~~~~~ */
629
630        // Let the per_packet function know we have stopped
631        if (trace->callbacks.message_pausing)
632                (*trace->callbacks.message_pausing)(trace, t, (libtrace_generic_t){0}, trace->global_blob, t->user_data);
633        else
634                (*trace->per_pkt)(trace, t, MESSAGE_PAUSING, (libtrace_generic_t){0}, t);
635        if (trace->callbacks.message_stopping)
636                (*trace->callbacks.message_stopping)(trace, t, (libtrace_generic_t){0}, trace->global_blob, t->user_data);
637        else
638                (*trace->per_pkt)(trace, t, MESSAGE_STOPPING, (libtrace_generic_t){0}, t);
639
640
641        // Free any remaining packets
642        for (i = 0; i < trace->config.burst_size; i++) {
643                if (packets[i]) {
644                        libtrace_ocache_free(&trace->packet_freelist, (void **) &packets[i], 1, 1);
645                        packets[i] = NULL;
646                }
647        }
648
649        thread_change_state(trace, t, THREAD_FINISHED, true);
650
651        /* Make sure the reporter sees we have finished */
652        if (trace_has_reporter(trace))
653                trace_post_reporter(trace);
654
655        // Release all ocache memory before unregistering with the format
656        // because this might(it does in DPDK) unlink the formats mempool
657        // causing destroy/finish packet to fail.
658        libtrace_ocache_unregister_thread(&trace->packet_freelist);
659        if (trace->format->punregister_thread) {
660                trace->format->punregister_thread(trace, t);
661        }
662        print_memory_stats();
663
664        pthread_exit(NULL);
665}
666
667/**
668 * The start point for our single threaded hasher thread, this will read
669 * and hash a packet from a data source and queue it against the correct
670 * core to process it.
671 */
672static void* hasher_entry(void *data) {
673        libtrace_t *trace = (libtrace_t *)data;
674        libtrace_thread_t * t;
675        int i;
676        libtrace_packet_t * packet;
677        libtrace_message_t message = {0};
678        int pkt_skipped = 0;
679
680        assert(trace_has_dedicated_hasher(trace));
681        /* Wait until all threads are started and objects are initialised (ring buffers) */
682        ASSERT_RET(pthread_mutex_lock(&trace->libtrace_lock), == 0);
683        t = &trace->hasher_thread;
684        assert(t->type == THREAD_HASHER && pthread_equal(pthread_self(), t->tid));
685        if (trace->state == STATE_ERROR) {
686                thread_change_state(trace, t, THREAD_FINISHED, false);
687                ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
688                pthread_exit(NULL);
689        }
690        ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
691
692        /* We are reading but it is not the parallel API */
693        if (trace->format->pregister_thread) {
694                trace->format->pregister_thread(trace, t, true);
695        }
696
697        /* Read all packets in then hash and queue against the correct thread */
698        while (1) {
699                int thread;
700                if (!pkt_skipped)
701                        libtrace_ocache_alloc(&trace->packet_freelist, (void **) &packet, 1, 1);
702                assert(packet);
703
704                if (libtrace_halt) {
705                        packet->error = 0;
706                        break;
707                }
708
709                // Check for messages that we expect MESSAGE_DO_PAUSE, (internal messages only)
710                if (libtrace_message_queue_try_get(&t->messages, &message) != LIBTRACE_MQ_FAILED) {
711                        switch(message.code) {
712                                case MESSAGE_DO_PAUSE:
713                                        ASSERT_RET(pthread_mutex_lock(&trace->libtrace_lock), == 0);
714                                        thread_change_state(trace, t, THREAD_PAUSED, false);
715                                        pthread_cond_broadcast(&trace->perpkt_cond);
716                                        while (trace->state == STATE_PAUSED || trace->state == STATE_PAUSING) {
717                                                ASSERT_RET(pthread_cond_wait(&trace->perpkt_cond, &trace->libtrace_lock), == 0);
718                                        }
719                                        thread_change_state(trace, t, THREAD_RUNNING, false);
720                                        pthread_cond_broadcast(&trace->perpkt_cond);
721                                        ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
722                                        break;
723                                case MESSAGE_DO_STOP:
724                                        assert(trace->started == false);
725                                        assert(trace->state == STATE_FINISHED);
726                                        /* Mark the current packet as EOF */
727                                        packet->error = 0;
728                                        break;
729                                default:
730                                        fprintf(stderr, "Hasher thread didn't expect message code=%d\n", message.code);
731                        }
732                        pkt_skipped = 1;
733                        continue;
734                }
735
736                if ((packet->error = trace_read_packet(trace, packet)) <1) {
737                        break; /* We are EOF or error'd either way we stop  */
738                }
739
740                /* We are guaranteed to have a hash function i.e. != NULL */
741                trace_packet_set_hash(packet, (*trace->hasher)(packet, trace->hasher_data));
742                thread = trace_packet_get_hash(packet) % trace->perpkt_thread_count;
743                /* Blocking write to the correct queue - I'm the only writer */
744                if (trace->perpkt_threads[thread].state != THREAD_FINISHED) {
745                        uint64_t order = trace_packet_get_order(packet);
746                        libtrace_ringbuffer_write(&trace->perpkt_threads[thread].rbuffer, packet);
747                        if (trace->config.tick_count && order % trace->config.tick_count == 0) {
748                                // Write ticks to everyone else
749                                libtrace_packet_t * pkts[trace->perpkt_thread_count];
750                                memset(pkts, 0, sizeof(void *) * trace->perpkt_thread_count);
751                                libtrace_ocache_alloc(&trace->packet_freelist, (void **) pkts, trace->perpkt_thread_count, trace->perpkt_thread_count);
752                                for (i = 0; i < trace->perpkt_thread_count; i++) {
753                                        pkts[i]->error = READ_TICK;
754                                        trace_packet_set_order(pkts[i], order);
755                                        libtrace_ringbuffer_write(&trace->perpkt_threads[i].rbuffer, pkts[i]);
756                                }
757                        }
758                        pkt_skipped = 0;
759                } else {
760                        assert(!"Dropping a packet!!");
761                        pkt_skipped = 1; // Reuse that packet no one read it
762                }
763        }
764
765        /* Broadcast our last failed read to all threads */
766        for (i = 0; i < trace->perpkt_thread_count; i++) {
767                libtrace_packet_t * bcast;
768                if (i == trace->perpkt_thread_count - 1) {
769                        bcast = packet;
770                } else {
771                        libtrace_ocache_alloc(&trace->packet_freelist, (void **) &bcast, 1, 1);
772                        bcast->error = packet->error;
773                }
774                ASSERT_RET(pthread_mutex_lock(&trace->libtrace_lock), == 0);
775                if (trace->perpkt_threads[i].state != THREAD_FINISHED) {
776                        // Unlock early otherwise we could deadlock
777                        libtrace_ringbuffer_write(&trace->perpkt_threads[i].rbuffer, bcast);
778                }
779                ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
780        }
781
782        // We don't need to free the packet
783        thread_change_state(trace, t, THREAD_FINISHED, true);
784
785        libtrace_ocache_unregister_thread(&trace->packet_freelist);
786        if (trace->format->punregister_thread) {
787                trace->format->punregister_thread(trace, t);
788        }
789        print_memory_stats();
790
791        // TODO remove from TTABLE t sometime
792        pthread_exit(NULL);
793}
794
795/* Our simplest case when a thread becomes ready it can obtain an exclusive
796 * lock to read packets from the underlying trace.
797 */
798static int trace_pread_packet_first_in_first_served(libtrace_t *libtrace,
799                                                    libtrace_thread_t *t,
800                                                    libtrace_packet_t *packets[],
801                                                    size_t nb_packets) {
802        size_t i = 0;
803        //bool tick_hit = false;
804
805        ASSERT_RET(pthread_mutex_lock(&libtrace->libtrace_lock), == 0);
806        /* Read nb_packets */
807        for (i = 0; i < nb_packets; ++i) {
808                if (libtrace_halt) {
809                        break;
810                }
811                packets[i]->error = trace_read_packet(libtrace, packets[i]);
812
813                if (packets[i]->error <= 0) {
814                        /* We'll catch this next time if we have already got packets */
815                        if ( i==0 ) {
816                                ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
817                                return packets[i]->error;
818                        } else {
819                                break;
820                        }
821                }
822                /*
823                if (libtrace->config.tick_count && trace_packet_get_order(packets[i]) % libtrace->config.tick_count == 0) {
824                        tick_hit = true;
825                }*/
826        }
827        // Doing this inside the lock ensures the first packet is always
828        // recorded first
829        if (packets[0]->error > 0) {
830                store_first_packet(libtrace, packets[0], t);
831        }
832        ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
833        /* XXX TODO this needs to be inband with packets, or we don't bother in this case
834        if (tick_hit) {
835                libtrace_message_t tick;
836                tick.additional.uint64 = trace_packet_get_order(packets[i]);
837                tick.code = MESSAGE_TICK;
838                trace_send_message_to_perpkts(libtrace, &tick);
839        } */
840        return i;
841}
842
843/**
844 * For the case that we have a dedicated hasher thread
845 * 1. We read a packet from our buffer
846 * 2. Move that into the packet provided (packet)
847 */
848inline static int trace_pread_packet_hasher_thread(libtrace_t *libtrace,
849                                                   libtrace_thread_t *t,
850                                                   libtrace_packet_t *packets[],
851                                                   size_t nb_packets) {
852        size_t i;
853
854        /* We store the last error message here */
855        if (t->format_data) {
856                return ((libtrace_packet_t *)t->format_data)->error;
857        }
858
859        // Always grab at least one
860        if (packets[0]) // Recycle the old get the new
861                libtrace_ocache_free(&libtrace->packet_freelist, (void **) packets, 1, 1);
862        packets[0] = libtrace_ringbuffer_read(&t->rbuffer);
863
864        if (packets[0]->error <= 0 && packets[0]->error != READ_TICK) {
865                return packets[0]->error;
866        }
867
868        for (i = 1; i < nb_packets; i++) {
869                if (packets[i]) // Recycle the old get the new
870                        libtrace_ocache_free(&libtrace->packet_freelist, (void **) &packets[i], 1, 1);
871                if (!libtrace_ringbuffer_try_read(&t->rbuffer, (void **) &packets[i])) {
872                        packets[i] = NULL;
873                        break;
874                }
875
876                /* We will return an error or EOF the next time around */
877                if (packets[i]->error <= 0 && packets[0]->error != READ_TICK) {
878                        /* The message case will be checked automatically -
879                           However other cases like EOF and error will only be
880                           sent once*/
881                        if (packets[i]->error != READ_MESSAGE) {
882                                assert(t->format_data == NULL);
883                                t->format_data = packets[i];
884                        }
885                        break;
886                }
887        }
888
889        return i;
890}
891
892/**
893 * For the first packet of each queue we keep a copy and note the system
894 * time it was received at.
895 *
896 * This is used for finding the first packet when playing back a trace
897 * in trace time. And can be used by real time applications to print
898 * results out every XXX seconds.
899 */
900void store_first_packet(libtrace_t *libtrace, libtrace_packet_t *packet, libtrace_thread_t *t)
901{
902        if (!t->recorded_first) {
903                libtrace_message_t mesg = {0};
904                struct timeval tv;
905                libtrace_packet_t * dup;
906
907                /* We mark system time against a copy of the packet */
908                gettimeofday(&tv, NULL);
909                dup = trace_copy_packet(packet);
910
911                ASSERT_RET(pthread_spin_lock(&libtrace->first_packets.lock), == 0);
912                libtrace->first_packets.packets[t->perpkt_num].packet = dup;
913                memcpy(&libtrace->first_packets.packets[t->perpkt_num].tv, &tv, sizeof(tv));
914                libtrace->first_packets.count++;
915
916                /* Now update the first */
917                if (libtrace->first_packets.count == 1) {
918                        /* We the first entry hence also the first known packet */
919                        libtrace->first_packets.first = t->perpkt_num;
920                } else {
921                        /* Check if we are newer than the previous 'first' packet */
922                        size_t first = libtrace->first_packets.first;
923                        if (trace_get_seconds(dup) <
924                                trace_get_seconds(libtrace->first_packets.packets[first].packet))
925                                libtrace->first_packets.first = t->perpkt_num;
926                }
927                ASSERT_RET(pthread_spin_unlock(&libtrace->first_packets.lock), == 0);
928
929                mesg.code = MESSAGE_FIRST_PACKET;
930                trace_message_reporter(libtrace, &mesg);
931                trace_message_perpkts(libtrace, &mesg);
932                t->recorded_first = true;
933        }
934}
935
936DLLEXPORT int trace_get_first_packet(libtrace_t *libtrace,
937                                     libtrace_thread_t *t,
938                                     const libtrace_packet_t **packet,
939                                     const struct timeval **tv)
940{
941        void * tmp;
942        int ret = 0;
943
944        if (t) {
945                if (t->type != THREAD_PERPKT || t->trace != libtrace)
946                        return -1;
947        }
948
949        /* Throw away these which we don't use */
950        if (!packet)
951                packet = (const libtrace_packet_t **) &tmp;
952        if (!tv)
953                tv = (const struct timeval **) &tmp;
954
955        ASSERT_RET(pthread_spin_lock(&libtrace->first_packets.lock), == 0);
956        if (t) {
957                /* Get the requested thread */
958                *packet = libtrace->first_packets.packets[t->perpkt_num].packet;
959                *tv = &libtrace->first_packets.packets[t->perpkt_num].tv;
960        } else if (libtrace->first_packets.count) {
961                /* Get the first packet across all threads */
962                *packet = libtrace->first_packets.packets[libtrace->first_packets.first].packet;
963                *tv = &libtrace->first_packets.packets[libtrace->first_packets.first].tv;
964                if (libtrace->first_packets.count == (size_t) libtrace->perpkt_thread_count) {
965                        ret = 1;
966                } else {
967                        struct timeval curr_tv;
968                        // If a second has passed since the first entry we will assume this is the very first packet
969                        gettimeofday(&curr_tv, NULL);
970                        if (curr_tv.tv_sec > (*tv)->tv_sec) {
971                                if(curr_tv.tv_usec > (*tv)->tv_usec || curr_tv.tv_sec - (*tv)->tv_sec > 1) {
972                                        ret = 1;
973                                }
974                        }
975                }
976        } else {
977                *packet = NULL;
978                *tv = NULL;
979        }
980        ASSERT_RET(pthread_spin_unlock(&libtrace->first_packets.lock), == 0);
981        return ret;
982}
983
984
985DLLEXPORT uint64_t tv_to_usec(const struct timeval *tv)
986{
987        return (uint64_t) tv->tv_sec*1000000ull + (uint64_t) tv->tv_usec;
988}
989
990inline static struct timeval usec_to_tv(uint64_t usec)
991{
992        struct timeval tv;
993        tv.tv_sec = usec / 1000000;
994        tv.tv_usec = usec % 1000000;
995        return tv;
996}
997
998/** Similar to delay_tracetime but send messages to all threads periodically */
999static void* reporter_entry(void *data) {
1000        libtrace_message_t message = {0};
1001        libtrace_t *trace = (libtrace_t *)data;
1002        libtrace_thread_t *t = &trace->reporter_thread;
1003
1004        /* Wait until all threads are started */
1005        ASSERT_RET(pthread_mutex_lock(&trace->libtrace_lock), == 0);
1006        if (trace->state == STATE_ERROR) {
1007                thread_change_state(trace, t, THREAD_FINISHED, false);
1008                ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
1009                pthread_exit(NULL);
1010        }
1011        ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
1012
1013        if (trace->format->pregister_thread) {
1014                trace->format->pregister_thread(trace, t, false);
1015        }
1016
1017        (*trace->reporter)(trace, MESSAGE_STARTING, (libtrace_generic_t) {0}, t);
1018        (*trace->reporter)(trace, MESSAGE_RESUMING, (libtrace_generic_t) {0}, t);
1019
1020        while (!trace_has_finished(trace)) {
1021                if (trace->config.reporter_polling) {
1022                        if (libtrace_message_queue_try_get(&t->messages, &message) == LIBTRACE_MQ_FAILED)
1023                                message.code = MESSAGE_POST_REPORTER;
1024                } else {
1025                        libtrace_message_queue_get(&t->messages, &message);
1026                }
1027                switch (message.code) {
1028                        // Check for results
1029                        case MESSAGE_POST_REPORTER:
1030                                trace->combiner.read(trace, &trace->combiner);
1031                                break;
1032                        case MESSAGE_DO_PAUSE:
1033                                assert(trace->combiner.pause);
1034                                trace->combiner.pause(trace, &trace->combiner);
1035                                (*trace->reporter)(trace, MESSAGE_PAUSING, (libtrace_generic_t) {0}, t);
1036                                trace_thread_pause(trace, t);
1037                                (*trace->reporter)(trace, MESSAGE_RESUMING, (libtrace_generic_t) {0}, t);
1038                                break;
1039                default:
1040                        (*trace->reporter)(trace, message.code, message.data, message.sender);
1041                }
1042        }
1043
1044        // Flush out whats left now all our threads have finished
1045        trace->combiner.read_final(trace, &trace->combiner);
1046
1047        // GOODBYE
1048        (*trace->reporter)(trace, MESSAGE_PAUSING, (libtrace_generic_t) {0}, t);
1049        (*trace->reporter)(trace, MESSAGE_STOPPING, (libtrace_generic_t) {0}, t);
1050
1051        thread_change_state(trace, &trace->reporter_thread, THREAD_FINISHED, true);
1052        print_memory_stats();
1053        return NULL;
1054}
1055
1056/** Similar to delay_tracetime but send messages to all threads periodically */
1057static void* keepalive_entry(void *data) {
1058        struct timeval prev, next;
1059        libtrace_message_t message = {0};
1060        libtrace_t *trace = (libtrace_t *)data;
1061        uint64_t next_release;
1062        libtrace_thread_t *t = &trace->keepalive_thread;
1063
1064        /* Wait until all threads are started */
1065        ASSERT_RET(pthread_mutex_lock(&trace->libtrace_lock), == 0);
1066        if (trace->state == STATE_ERROR) {
1067                thread_change_state(trace, t, THREAD_FINISHED, false);
1068                ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
1069                pthread_exit(NULL);
1070        }
1071        ASSERT_RET(pthread_mutex_unlock(&trace->libtrace_lock), == 0);
1072
1073        gettimeofday(&prev, NULL);
1074        message.code = MESSAGE_TICK_INTERVAL;
1075
1076        while (trace->state != STATE_FINISHED) {
1077                fd_set rfds;
1078                next_release = tv_to_usec(&prev) + (trace->config.tick_interval * 1000);
1079                gettimeofday(&next, NULL);
1080                if (next_release > tv_to_usec(&next)) {
1081                        next = usec_to_tv(next_release - tv_to_usec(&next));
1082                        // Wait for timeout or a message
1083                        FD_ZERO(&rfds);
1084                        FD_SET(libtrace_message_queue_get_fd(&t->messages), &rfds);
1085                        if (select(libtrace_message_queue_get_fd(&t->messages)+1, &rfds, NULL, NULL, &next) == 1) {
1086                                libtrace_message_t msg;
1087                                libtrace_message_queue_get(&t->messages, &msg);
1088                                assert(msg.code == MESSAGE_DO_STOP);
1089                                goto done;
1090                        }
1091                }
1092                prev = usec_to_tv(next_release);
1093                if (trace->state == STATE_RUNNING) {
1094                        message.data.uint64 = ((((uint64_t)prev.tv_sec) << 32) +
1095                                               (((uint64_t)prev.tv_usec << 32)/1000000));
1096                        trace_message_perpkts(trace, &message);
1097                }
1098        }
1099done:
1100
1101        thread_change_state(trace, t, THREAD_FINISHED, true);
1102        return NULL;
1103}
1104
1105/**
1106 * Delays a packets playback so the playback will be in trace time.
1107 * This may break early if a message becomes available.
1108 *
1109 * Requires the first packet for this thread to be received.
1110 * @param libtrace  The trace
1111 * @param packet    The packet to delay
1112 * @param t         The current thread
1113 * @return Either READ_MESSAGE(-2) or 0 is successful
1114 */
1115static inline int delay_tracetime(libtrace_t *libtrace, libtrace_packet_t *packet, libtrace_thread_t *t) {
1116        struct timeval curr_tv, pkt_tv;
1117        uint64_t next_release = t->tracetime_offset_usec;
1118        uint64_t curr_usec;
1119
1120        if (!t->tracetime_offset_usec) {
1121                const libtrace_packet_t *first_pkt;
1122                const struct timeval *sys_tv;
1123                int64_t initial_offset;
1124                int stable = trace_get_first_packet(libtrace, NULL, &first_pkt, &sys_tv);
1125                assert(first_pkt);
1126                pkt_tv = trace_get_timeval(first_pkt);
1127                initial_offset = (int64_t)tv_to_usec(sys_tv) - (int64_t)tv_to_usec(&pkt_tv);
1128                /* In the unlikely case offset is 0, change it to 1 */
1129                if (stable)
1130                        t->tracetime_offset_usec = initial_offset ? initial_offset: 1;
1131                next_release = initial_offset;
1132        }
1133        /* next_release == offset */
1134        pkt_tv = trace_get_timeval(packet);
1135        next_release += tv_to_usec(&pkt_tv);
1136        gettimeofday(&curr_tv, NULL);
1137        curr_usec = tv_to_usec(&curr_tv);
1138        if (next_release > curr_usec) {
1139                int ret, mesg_fd = libtrace_message_queue_get_fd(&t->messages);
1140                struct timeval delay_tv = usec_to_tv(next_release-curr_usec);
1141                fd_set rfds;
1142                FD_ZERO(&rfds);
1143                FD_SET(mesg_fd, &rfds);
1144                // We need to wait
1145                ret = select(mesg_fd+1, &rfds, NULL, NULL, &delay_tv);
1146                if (ret == 0) {
1147                        return 0;
1148                } else if (ret > 0) {
1149                        return READ_MESSAGE;
1150                } else {
1151                        assert(!"trace_delay_packet: Unexpected return from select");
1152                }
1153        }
1154        return 0;
1155}
1156
1157/* Discards packets that don't match the filter.
1158 * Discarded packets are emptied and then moved to the end of the packet list.
1159 *
1160 * @param trace       The trace format, containing the filter
1161 * @param packets     An array of packets
1162 * @param nb_packets  The number of valid items in packets
1163 *
1164 * @return The number of packets that passed the filter, which are moved to
1165 *          the start of the packets array
1166 */
1167static inline size_t filter_packets(libtrace_t *trace,
1168                                    libtrace_packet_t **packets,
1169                                    size_t nb_packets) {
1170        size_t offset = 0;
1171        size_t i;
1172
1173        for (i = 0; i < nb_packets; ++i) {
1174                // The filter needs the trace attached to receive the link type
1175                packets[i]->trace = trace;
1176                if (trace_apply_filter(trace->filter, packets[i])) {
1177                        libtrace_packet_t *tmp;
1178                        tmp = packets[offset];
1179                        packets[offset++] = packets[i];
1180                        packets[i] = tmp;
1181                } else {
1182                        trace_fin_packet(packets[i]);
1183                }
1184        }
1185
1186        return offset;
1187}
1188
1189/* Read a batch of packets from the trace into a buffer.
1190 * Note that this function will block until a packet is read (or EOF is reached)
1191 *
1192 * @param libtrace    The trace
1193 * @param t           The thread
1194 * @param packets     An array of packets
1195 * @param nb_packets  The number of empty packets in packets
1196 * @return The number of packets read, 0 on EOF (or an error/message -1,-2).
1197 */
1198static int trace_pread_packet_wrapper(libtrace_t *libtrace,
1199                                      libtrace_thread_t *t,
1200                                      libtrace_packet_t *packets[],
1201                                      size_t nb_packets) {
1202        int i;
1203        assert(nb_packets);
1204        assert(libtrace && "libtrace is NULL in trace_read_packet()");
1205        if (trace_is_err(libtrace))
1206                return -1;
1207        if (!libtrace->started) {
1208                trace_set_err(libtrace, TRACE_ERR_BAD_STATE,
1209                              "You must call libtrace_start() before trace_read_packet()\n");
1210                return -1;
1211        }
1212
1213        if (libtrace->format->pread_packets) {
1214                int ret;
1215                for (i = 0; i < (int) nb_packets; ++i) {
1216                        assert(i[packets]);
1217                        if (!(packets[i]->buf_control==TRACE_CTRL_PACKET ||
1218                              packets[i]->buf_control==TRACE_CTRL_EXTERNAL)) {
1219                                trace_set_err(libtrace,TRACE_ERR_BAD_STATE,
1220                                              "Packet passed to trace_read_packet() is invalid\n");
1221                                return -1;
1222                        }
1223                }
1224                do {
1225                        ret=libtrace->format->pread_packets(libtrace, t,
1226                                                            packets,
1227                                                            nb_packets);
1228                        /* Error, EOF or message? */
1229                        if (ret <= 0) {
1230                                return ret;
1231                        }
1232
1233                        if (libtrace->filter) {
1234                                int remaining;
1235                                remaining = filter_packets(libtrace,
1236                                                           packets, ret);
1237                                t->filtered_packets += ret - remaining;
1238                                ret = remaining;
1239                        }
1240                        for (i = 0; i < ret; ++i) {
1241                                /* We do not mark the packet against the trace,
1242                                 * before hand or after. After breaks DAG meta
1243                                 * packets and before is inefficient */
1244                                //packets[i]->trace = libtrace;
1245                                /* TODO IN FORMAT?? Like traditional libtrace */
1246                                if (libtrace->snaplen>0)
1247                                        trace_set_capture_length(packets[i],
1248                                                        libtrace->snaplen);
1249                                trace_packet_set_order(packets[i], trace_get_erf_timestamp(packets[i]));
1250                        }
1251                } while(ret == 0);
1252                return ret;
1253        }
1254        trace_set_err(libtrace, TRACE_ERR_UNSUPPORTED,
1255                      "This format does not support reading packets\n");
1256        return ~0U;
1257}
1258
1259/* Restarts a parallel trace, this is called from trace_pstart.
1260 * The libtrace lock is held upon calling this function.
1261 * Typically with a parallel trace the threads are not
1262 * killed rather.
1263 */
1264static int trace_prestart(libtrace_t * libtrace, void *global_blob,
1265                          fn_per_pkt per_pkt, fn_reporter reporter) {
1266        int i, err = 0;
1267        if (libtrace->state != STATE_PAUSED) {
1268                trace_set_err(libtrace, TRACE_ERR_BAD_STATE,
1269                        "trace(%s) is not currently paused",
1270                              libtrace->uridata);
1271                return -1;
1272        }
1273
1274        assert(libtrace_parallel);
1275        assert(!libtrace->perpkt_thread_states[THREAD_RUNNING]);
1276
1277        /* Reset first packets */
1278        pthread_spin_lock(&libtrace->first_packets.lock);
1279        for (i = 0; i < libtrace->perpkt_thread_count; ++i) {
1280                assert(!!libtrace->perpkt_threads[i].recorded_first == !!libtrace->first_packets.packets[i].packet);
1281                if (libtrace->first_packets.packets[i].packet) {
1282                        trace_destroy_packet(libtrace->first_packets.packets[i].packet);
1283                        libtrace->first_packets.packets[i].packet = NULL;
1284                        libtrace->first_packets.packets[i].tv.tv_sec = 0;
1285                        libtrace->first_packets.packets[i].tv.tv_usec = 0;
1286                        libtrace->first_packets.count--;
1287                        libtrace->perpkt_threads[i].recorded_first = false;
1288                }
1289        }
1290        assert(libtrace->first_packets.count == 0);
1291        libtrace->first_packets.first = 0;
1292        pthread_spin_unlock(&libtrace->first_packets.lock);
1293
1294        /* Reset delay */
1295        for (i = 0; i < libtrace->perpkt_thread_count; ++i) {
1296                libtrace->perpkt_threads[i].tracetime_offset_usec = 0;
1297        }
1298
1299        /* Reset statistics */
1300        for (i = 0; i < libtrace->perpkt_thread_count; ++i) {
1301                libtrace->perpkt_threads[i].accepted_packets = 0;
1302                libtrace->perpkt_threads[i].filtered_packets = 0;
1303        }
1304        libtrace->accepted_packets = 0;
1305        libtrace->filtered_packets = 0;
1306
1307        /* Update functions if requested */
1308        if (per_pkt)
1309                libtrace->per_pkt = per_pkt;
1310        assert(libtrace->per_pkt);
1311        if (reporter)
1312                libtrace->reporter = reporter;
1313        if(global_blob)
1314                libtrace->global_blob = global_blob;
1315
1316        if (libtrace->perpkt_thread_count > 1 &&
1317            trace_supports_parallel(libtrace) &&
1318            !trace_has_dedicated_hasher(libtrace)) {
1319                err = libtrace->format->pstart_input(libtrace);
1320        } else {
1321                if (libtrace->format->start_input) {
1322                        err = libtrace->format->start_input(libtrace);
1323                }
1324        }
1325
1326        if (err == 0) {
1327                libtrace->started = true;
1328                libtrace_change_state(libtrace, STATE_RUNNING, false);
1329        }
1330        return err;
1331}
1332
1333/**
1334 * @return the number of CPU cores on the machine. -1 if unknown.
1335 */
1336SIMPLE_FUNCTION static int get_nb_cores() {
1337        int numCPU;
1338#ifdef _SC_NPROCESSORS_ONLN
1339        /* Most systems do this now */
1340        numCPU = sysconf(_SC_NPROCESSORS_ONLN);
1341
1342#else
1343        int mib[] = {CTL_HW, HW_AVAILCPU};
1344        size_t len = sizeof(numCPU);
1345
1346        /* get the number of CPUs from the system */
1347        sysctl(mib, 2, &numCPU, &len, NULL, 0);
1348#endif
1349        return numCPU <= 0 ? 1 : numCPU;
1350}
1351
1352/**
1353 * Verifies the configuration and sets default values for any values not
1354 * specified by the user.
1355 */
1356static void verify_configuration(libtrace_t *libtrace) {
1357
1358        if (libtrace->config.hasher_queue_size <= 0)
1359                libtrace->config.hasher_queue_size = 1000;
1360
1361        if (libtrace->config.perpkt_threads <= 0) {
1362                libtrace->perpkt_thread_count = get_nb_cores();
1363                if (libtrace->perpkt_thread_count <= 0)
1364                        // Lets just use one
1365                        libtrace->perpkt_thread_count = 1;
1366        } else {
1367                libtrace->perpkt_thread_count = libtrace->config.perpkt_threads;
1368        }
1369
1370        if (libtrace->config.reporter_thold <= 0)
1371                libtrace->config.reporter_thold = 100;
1372        if (libtrace->config.burst_size <= 0)
1373                libtrace->config.burst_size = 10;
1374        if (libtrace->config.thread_cache_size <= 0)
1375                libtrace->config.thread_cache_size = 20;
1376        if (libtrace->config.cache_size <= 0)
1377                libtrace->config.cache_size = (libtrace->config.hasher_queue_size + 1) * libtrace->perpkt_thread_count;
1378
1379        if (libtrace->config.cache_size <
1380                (libtrace->config.hasher_queue_size + 1) * libtrace->perpkt_thread_count)
1381                fprintf(stderr, "WARNING deadlocks may occur and extra memory allocating buffer sizes (packet_freelist_size) mismatched\n");
1382
1383        if (libtrace->combiner.initialise == NULL && libtrace->combiner.publish == NULL)
1384                libtrace->combiner = combiner_unordered;
1385
1386        /* Figure out if we are using a dedicated hasher thread? */
1387        if (libtrace->hasher && libtrace->perpkt_thread_count > 1) {
1388                libtrace->hasher_thread.type = THREAD_HASHER;
1389        }
1390}
1391
1392/**
1393 * Starts a libtrace_thread, including allocating memory for messaging.
1394 * Threads are expected to wait until the libtrace look is released.
1395 * Hence why we don't init structures until later.
1396 *
1397 * @param trace The trace the thread is associated with
1398 * @param t The thread that is filled when the thread is started
1399 * @param type The type of thread
1400 * @param start_routine The entry location of the thread
1401 * @param perpkt_num The perpkt thread number (should be set -1 if not perpkt)
1402 * @param name For debugging purposes set the threads name (Optional)
1403 *
1404 * @return 0 on success or -1 upon error in which case the libtrace error is set.
1405 *         In this situation the thread structure is zeroed.
1406 */
1407static int trace_start_thread(libtrace_t *trace,
1408                       libtrace_thread_t *t,
1409                       enum thread_types type,
1410                       void *(*start_routine) (void *),
1411                       int perpkt_num,
1412                       const char *name) {
1413#ifdef __linux__
1414        pthread_attr_t attrib;
1415        cpu_set_t cpus;
1416#endif
1417        int ret, i;
1418        assert(t->type == THREAD_EMPTY);
1419        t->trace = trace;
1420        t->ret = NULL;
1421        t->user_data = NULL;
1422        t->type = type;
1423        t->state = THREAD_RUNNING;
1424
1425#ifdef __linux__
1426        CPU_ZERO(&cpus);
1427        for (i = 0; i < get_nb_cores(); i++)
1428                CPU_SET(i, &cpus);
1429        pthread_attr_init(&attrib);
1430        pthread_attr_setaffinity_np(&attrib, sizeof(cpus), &cpus);
1431        ret = pthread_create(&t->tid, &attrib, start_routine, (void *) trace);
1432        pthread_attr_destroy(&attrib);
1433#else
1434        ret = pthread_create(&t->tid, NULL, start_routine, (void *) trace);
1435#endif
1436        if (ret != 0) {
1437                libtrace_zero_thread(t);
1438                trace_set_err(trace, ret, "Failed to create a thread of type=%d\n", type);
1439                return -1;
1440        }
1441        libtrace_message_queue_init(&t->messages, sizeof(libtrace_message_t));
1442        if (trace_has_dedicated_hasher(trace) && type == THREAD_PERPKT) {
1443                libtrace_ringbuffer_init(&t->rbuffer,
1444                                         trace->config.hasher_queue_size,
1445                                         trace->config.hasher_polling?
1446                                                 LIBTRACE_RINGBUFFER_POLLING:
1447                                                 LIBTRACE_RINGBUFFER_BLOCKING);
1448        }
1449#if defined(HAVE_PTHREAD_SETNAME_NP) && defined(__linux__)
1450        if(name)
1451                pthread_setname_np(t->tid, name);
1452#endif
1453        t->perpkt_num = perpkt_num;
1454        return 0;
1455}
1456
1457/** Parses the environment variable LIBTRACE_CONF into the supplied
1458 * configuration structure.
1459 *
1460 * @param[in,out] libtrace The trace from which we determine the URI and set
1461 * the configuration.
1462 *
1463 * We search for 3 environment variables and apply them to the config in the
1464 * following order. Such that the first has the lowest priority.
1465 *
1466 * 1. LIBTRACE_CONF, The global environment configuration
1467 * 2. LIBTRACE_CONF_<FORMAT>, Applied to a given format
1468 * 3. LIBTRACE_CONF_<FORMAT_URI>, Applied the specified trace
1469 *
1470 * E.g.
1471 * - int:eth0 would match LIBTRACE_CONF, LIBTRACE_CONF_INT, LIBTRACE_CONF_INT_ETH0
1472 * - dag:/dev/dag0,0 would match LIBTRACE_CONF, LIBTRACE_CONF_DAG, LIBTRACE_CONF_DAG__DEV_DAG0_0
1473 * - test.erf would match LIBTRACE_CONF, LIBTRACE_CONF_ERF, LIBTRACE_CONF_ERF_TEST_ERF
1474 *
1475 * @note All environment variables names MUST only contian
1476 * [A-Z], [0-9] and [_] (underscore) and not start with a number. Any characters
1477 * outside of this range should be captilised if possible or replaced with an
1478 * underscore.
1479 */
1480static void parse_env_config (libtrace_t *libtrace) {
1481        char env_name[1024] = "LIBTRACE_CONF_";
1482        size_t len = strlen(env_name);
1483        size_t mark = 0;
1484        size_t i;
1485        char * env;
1486
1487        /* Make our compound string */
1488        strncpy(&env_name[len], libtrace->format->name, sizeof(env_name) - len);
1489        len += strlen(libtrace->format->name);
1490        strncpy(&env_name[len], ":", sizeof(env_name) - len);
1491        len += 1;
1492        strncpy(&env_name[len], libtrace->uridata, sizeof(env_name) - len);
1493
1494        /* env names are allowed to be A-Z (CAPS) 0-9 and _ */
1495        for (i = 0; env_name[i] != 0; ++i) {
1496                env_name[i] = toupper(env_name[i]);
1497                if(env_name[i] == ':') {
1498                        mark = i;
1499                }
1500                if (!( (env_name[i] >= 'A' && env_name[i] <= 'Z') ||
1501                       (env_name[i] >= '0' && env_name[i] <= '9') )) {
1502                        env_name[i] = '_';
1503                }
1504        }
1505
1506        /* First apply global env settings LIBTRACE_CONF */
1507        env = getenv("LIBTRACE_CONF");
1508        if (env)
1509        {
1510                printf("Got env %s", env);
1511                trace_set_configuration(libtrace, env);
1512        }
1513
1514        /* Then format settings LIBTRACE_CONF_<FORMAT> */
1515        if (mark != 0) {
1516                env_name[mark] = 0;
1517                env = getenv(env_name);
1518                if (env) {
1519                        trace_set_configuration(libtrace, env);
1520                }
1521                env_name[mark] = '_';
1522        }
1523
1524        /* Finally this specific trace LIBTRACE_CONF_<FORMAT_URI> */
1525        env = getenv(env_name);
1526        if (env) {
1527                trace_set_configuration(libtrace, env);
1528        }
1529}
1530
1531DLLEXPORT int trace_pstart(libtrace_t *libtrace, void* global_blob,
1532                           fn_per_pkt per_pkt, fn_reporter reporter) {
1533        int i;
1534        int ret = -1;
1535        char name[16];
1536        sigset_t sig_before, sig_block_all;
1537        assert(libtrace);
1538
1539        ASSERT_RET(pthread_mutex_lock(&libtrace->libtrace_lock), == 0);
1540        if (trace_is_err(libtrace)) {
1541                goto cleanup_none;
1542        }
1543
1544        if (libtrace->state == STATE_PAUSED) {
1545                ret = trace_prestart(libtrace, global_blob, per_pkt, reporter);
1546                ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1547                return ret;
1548        }
1549
1550        if (libtrace->state != STATE_NEW) {
1551                trace_set_err(libtrace, TRACE_ERR_BAD_STATE, "trace_pstart "
1552                              "should be called on a NEW or PAUSED trace but "
1553                              "instead was called from %s",
1554                              get_trace_state_name(libtrace->state));
1555                goto cleanup_none;
1556        }
1557
1558        /* Store the user defined things against the trace */
1559        libtrace->global_blob = global_blob;
1560        libtrace->per_pkt = per_pkt;
1561        libtrace->reporter = reporter;
1562        /* And zero other fields */
1563        for (i = 0; i < THREAD_STATE_MAX; ++i) {
1564                libtrace->perpkt_thread_states[i] = 0;
1565        }
1566        libtrace->first_packets.first = 0;
1567        libtrace->first_packets.count = 0;
1568        libtrace->first_packets.packets = NULL;
1569        libtrace->perpkt_threads = NULL;
1570        /* Set a global which says we are using a parallel trace. This is
1571         * for backwards compatability due to changes when destroying packets */
1572        libtrace_parallel = 1;
1573
1574        /* Parses configuration passed through environment variables */
1575        parse_env_config(libtrace);
1576        verify_configuration(libtrace);
1577
1578        /* Try start the format - we prefer parallel over single threaded, as
1579         * these formats should support messages better */
1580        if (trace_supports_parallel(libtrace) &&
1581            !trace_has_dedicated_hasher(libtrace)) {
1582                ret = libtrace->format->pstart_input(libtrace);
1583                libtrace->pread = trace_pread_packet_wrapper;
1584        } else {
1585                if (libtrace->format->start_input) {
1586                        ret = libtrace->format->start_input(libtrace);
1587                }
1588                if (libtrace->perpkt_thread_count > 1)
1589                        libtrace->pread = trace_pread_packet_first_in_first_served;
1590                else
1591                        /* Use standard read_packet */
1592                        libtrace->pread = NULL;
1593        }
1594
1595        if (ret != 0) {
1596                goto cleanup_none;
1597        }
1598
1599        /* --- Start all the threads we need --- */
1600        /* Disable signals because it is inherited by the threads we start */
1601        sigemptyset(&sig_block_all);
1602        ASSERT_RET(pthread_sigmask(SIG_SETMASK, &sig_block_all, &sig_before), == 0);
1603
1604        /* If we need a hasher thread start it
1605         * Special Case: If single threaded we don't need a hasher
1606         */
1607        if (trace_has_dedicated_hasher(libtrace)) {
1608                libtrace->hasher_thread.type = THREAD_EMPTY;
1609                ret = trace_start_thread(libtrace, &libtrace->hasher_thread,
1610                                   THREAD_HASHER, hasher_entry, -1,
1611                                   "hasher-thread");
1612                if (ret != 0)
1613                        goto cleanup_started;
1614                libtrace->pread = trace_pread_packet_hasher_thread;
1615        } else {
1616                libtrace->hasher_thread.type = THREAD_EMPTY;
1617        }
1618
1619        /* Start up our perpkt threads */
1620        libtrace->perpkt_threads = calloc(sizeof(libtrace_thread_t),
1621                                          libtrace->perpkt_thread_count);
1622        if (!libtrace->perpkt_threads) {
1623                trace_set_err(libtrace, errno, "trace_pstart "
1624                              "failed to allocate memory.");
1625                goto cleanup_threads;
1626        }
1627        for (i = 0; i < libtrace->perpkt_thread_count; i++) {
1628                snprintf(name, sizeof(name), "perpkt-%d", i);
1629                libtrace_zero_thread(&libtrace->perpkt_threads[i]);
1630                ret = trace_start_thread(libtrace, &libtrace->perpkt_threads[i],
1631                                   THREAD_PERPKT, perpkt_threads_entry, i,
1632                                   name);
1633                if (ret != 0)
1634                        goto cleanup_threads;
1635        }
1636
1637        /* Start the reporter thread */
1638        if (reporter) {
1639                if (libtrace->combiner.initialise)
1640                        libtrace->combiner.initialise(libtrace, &libtrace->combiner);
1641                ret = trace_start_thread(libtrace, &libtrace->reporter_thread,
1642                                   THREAD_REPORTER, reporter_entry, -1,
1643                                   "reporter_thread");
1644                if (ret != 0)
1645                        goto cleanup_threads;
1646        }
1647
1648        /* Start the keepalive thread */
1649        if (libtrace->config.tick_interval > 0) {
1650                ret = trace_start_thread(libtrace, &libtrace->keepalive_thread,
1651                                   THREAD_KEEPALIVE, keepalive_entry, -1,
1652                                   "keepalive_thread");
1653                if (ret != 0)
1654                        goto cleanup_threads;
1655        }
1656
1657        /* Init other data structures */
1658        libtrace->perpkt_thread_states[THREAD_RUNNING] = libtrace->perpkt_thread_count;
1659        ASSERT_RET(pthread_spin_init(&libtrace->first_packets.lock, 0), == 0);
1660        libtrace->first_packets.packets = calloc(libtrace->perpkt_thread_count,
1661                                                 sizeof(*libtrace->first_packets.packets));
1662        if (libtrace->first_packets.packets == NULL) {
1663                trace_set_err(libtrace, errno, "trace_pstart "
1664                              "failed to allocate memory.");
1665                goto cleanup_threads;
1666        }
1667
1668        if (libtrace_ocache_init(&libtrace->packet_freelist,
1669                             (void* (*)()) trace_create_packet,
1670                             (void (*)(void *))trace_destroy_packet,
1671                             libtrace->config.thread_cache_size,
1672                             libtrace->config.cache_size * 4,
1673                             libtrace->config.fixed_count) != 0) {
1674                trace_set_err(libtrace, TRACE_ERR_INIT_FAILED, "trace_pstart "
1675                              "failed to allocate ocache.");
1676                goto cleanup_threads;
1677        }
1678
1679        /* Threads don't start */
1680        libtrace->started = true;
1681        libtrace_change_state(libtrace, STATE_RUNNING, false);
1682
1683        ret = 0;
1684        goto success;
1685cleanup_threads:
1686        if (libtrace->first_packets.packets) {
1687                free(libtrace->first_packets.packets);
1688                libtrace->first_packets.packets = NULL;
1689        }
1690        libtrace_change_state(libtrace, STATE_ERROR, false);
1691        ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1692        if (libtrace->hasher_thread.type == THREAD_HASHER) {
1693                pthread_join(libtrace->hasher_thread.tid, NULL);
1694                libtrace_zero_thread(&libtrace->hasher_thread);
1695        }
1696
1697        if (libtrace->perpkt_threads) {
1698                for (i = 0; i < libtrace->perpkt_thread_count; i++) {
1699                        if (libtrace->perpkt_threads[i].type == THREAD_PERPKT) {
1700                                pthread_join(libtrace->perpkt_threads[i].tid, NULL);
1701                                libtrace_zero_thread(&libtrace->perpkt_threads[i]);
1702                        } else break;
1703                }
1704                free(libtrace->perpkt_threads);
1705                libtrace->perpkt_threads = NULL;
1706        }
1707
1708        if (libtrace->reporter_thread.type == THREAD_REPORTER) {
1709                pthread_join(libtrace->reporter_thread.tid, NULL);
1710                libtrace_zero_thread(&libtrace->reporter_thread);
1711        }
1712
1713        if (libtrace->keepalive_thread.type == THREAD_KEEPALIVE) {
1714                pthread_join(libtrace->keepalive_thread.tid, NULL);
1715                libtrace_zero_thread(&libtrace->keepalive_thread);
1716        }
1717        ASSERT_RET(pthread_mutex_lock(&libtrace->libtrace_lock), == 0);
1718        libtrace_change_state(libtrace, STATE_NEW, false);
1719        assert(libtrace->perpkt_thread_states[THREAD_RUNNING] == 0);
1720        libtrace->perpkt_thread_states[THREAD_FINISHED] = 0;
1721cleanup_started:
1722        if (trace_supports_parallel(libtrace) &&
1723            !trace_has_dedicated_hasher(libtrace)
1724            && libtrace->perpkt_thread_count > 1) {
1725                if (libtrace->format->ppause_input)
1726                        libtrace->format->ppause_input(libtrace);
1727        } else {
1728                if (libtrace->format->pause_input)
1729                        libtrace->format->pause_input(libtrace);
1730        }
1731        ret = -1;
1732success:
1733        ASSERT_RET(pthread_sigmask(SIG_SETMASK, &sig_before, NULL), == 0);
1734cleanup_none:
1735        ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1736        return ret;
1737}
1738
1739DLLEXPORT int trace_set_handler(libtrace_t *libtrace, enum libtrace_messages message, fn_handler handler) {
1740        switch (message) {
1741        case MESSAGE_STARTING:
1742                libtrace->callbacks.message_starting = handler;
1743                return 0;
1744        case MESSAGE_STOPPING:
1745                libtrace->callbacks.message_stopping = handler;
1746                return 0;
1747        case MESSAGE_RESUMING:
1748                libtrace->callbacks.message_resuming = handler;
1749                return 0;
1750        case MESSAGE_PAUSING:
1751                libtrace->callbacks.message_pausing = handler;
1752                return 0;
1753        case MESSAGE_PACKET:
1754                libtrace->callbacks.message_packet = handler;
1755                return 0;
1756        default:
1757                return -1;
1758        }
1759        return -1;
1760}
1761
1762
1763/*
1764 * Pauses a trace, this should only be called by the main thread
1765 * 1. Set started = false
1766 * 2. All perpkt threads are paused waiting on a condition var
1767 * 3. Then call ppause on the underlying format if found
1768 * 4. The traces state is paused
1769 *
1770 * Once done you should be able to modify the trace setup and call pstart again
1771 * TODO handle changing thread numbers
1772 */
1773DLLEXPORT int trace_ppause(libtrace_t *libtrace)
1774{
1775        libtrace_thread_t *t;
1776        int i;
1777        assert(libtrace);
1778
1779        t = get_thread_table(libtrace);
1780        // Check state from within the lock if we are going to change it
1781        ASSERT_RET(pthread_mutex_lock(&libtrace->libtrace_lock), == 0);
1782        if (!libtrace->started || libtrace->state != STATE_RUNNING) {
1783                trace_set_err(libtrace,TRACE_ERR_BAD_STATE, "You must call trace_start() before calling trace_ppause()");
1784                ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1785                return -1;
1786        }
1787
1788        libtrace_change_state(libtrace, STATE_PAUSING, false);
1789        ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1790
1791        // Special case handle the hasher thread case
1792        if (trace_has_dedicated_hasher(libtrace)) {
1793                if (libtrace->config.debug_state)
1794                        fprintf(stderr, "Hasher thread is running, asking it to pause ...");
1795                libtrace_message_t message = {0};
1796                message.code = MESSAGE_DO_PAUSE;
1797                trace_message_thread(libtrace, &libtrace->hasher_thread, &message);
1798                // Wait for it to pause
1799                ASSERT_RET(pthread_mutex_lock(&libtrace->libtrace_lock), == 0);
1800                while (libtrace->hasher_thread.state == THREAD_RUNNING) {
1801                        ASSERT_RET(pthread_cond_wait(&libtrace->perpkt_cond, &libtrace->libtrace_lock), == 0);
1802                }
1803                ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1804                if (libtrace->config.debug_state)
1805                        fprintf(stderr, " DONE\n");
1806        }
1807
1808        if (libtrace->config.debug_state)
1809                fprintf(stderr, "Asking perpkt threads to pause ...");
1810        // Stop threads, skip this one if it's a perpkt
1811        for (i = 0; i < libtrace->perpkt_thread_count; i++) {
1812                if (&libtrace->perpkt_threads[i] != t) {
1813                        libtrace_message_t message = {0};
1814                        message.code = MESSAGE_DO_PAUSE;
1815                        ASSERT_RET(trace_message_thread(libtrace, &libtrace->perpkt_threads[i], &message), != -1);
1816                        if(trace_has_dedicated_hasher(libtrace)) {
1817                                // The hasher has stopped and other threads have messages waiting therefore
1818                                // If the queues are empty the other threads would have no data
1819                                // So send some message packets to simply ask the threads to check
1820                                // We are the only writer since hasher has paused
1821                                libtrace_packet_t *pkt;
1822                                libtrace_ocache_alloc(&libtrace->packet_freelist, (void **) &pkt, 1, 1);
1823                                pkt->error = READ_MESSAGE;
1824                                libtrace_ringbuffer_write(&libtrace->perpkt_threads[i].rbuffer, pkt);
1825                        }
1826                } else {
1827                        fprintf(stderr, "Mapper threads should not be used to pause a trace this could cause any number of problems!!\n");
1828                }
1829        }
1830
1831        if (t) {
1832                // A perpkt is doing the pausing, interesting, fake an extra thread paused
1833                // We rely on the user to *not* return before starting the trace again
1834                thread_change_state(libtrace, t, THREAD_PAUSED, true);
1835        }
1836
1837        // Wait for all threads to pause
1838        ASSERT_RET(pthread_mutex_lock(&libtrace->libtrace_lock), == 0);
1839        while(libtrace->perpkt_thread_states[THREAD_RUNNING]) {
1840                ASSERT_RET(pthread_cond_wait(&libtrace->perpkt_cond, &libtrace->libtrace_lock), == 0);
1841        }
1842        ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1843
1844        if (libtrace->config.debug_state)
1845                fprintf(stderr, " DONE\n");
1846
1847        // Deal with the reporter
1848        if (trace_has_reporter(libtrace)) {
1849                if (libtrace->config.debug_state)
1850                        fprintf(stderr, "Reporter thread is running, asking it to pause ...");
1851                libtrace_message_t message = {0};
1852                message.code = MESSAGE_DO_PAUSE;
1853                trace_message_thread(libtrace, &libtrace->reporter_thread, &message);
1854                // Wait for it to pause
1855                ASSERT_RET(pthread_mutex_lock(&libtrace->libtrace_lock), == 0);
1856                while (libtrace->reporter_thread.state == THREAD_RUNNING) {
1857                        ASSERT_RET(pthread_cond_wait(&libtrace->perpkt_cond, &libtrace->libtrace_lock), == 0);
1858                }
1859                ASSERT_RET(pthread_mutex_unlock(&libtrace->libtrace_lock), == 0);
1860                if (libtrace->config.debug_state)
1861                        fprintf(stderr, " DONE\n");
1862        }
1863
1864        /* Cache values before we pause */
1865        if (libtrace->stats == NULL)
1866                libtrace->stats = trace_create_statistics();
1867        // Save the statistics against the trace
1868        trace_get_statistics(libtrace, NULL);
1869        if (trace_supports_parallel(libtrace) && !trace_has_dedicated_hasher(libtrace) && libtrace->perpkt_thread_count > 1) {
1870                libtrace->started = false;
1871                if (libtrace->format->ppause_input)
1872                        libtrace->format->ppause_input(libtrace);
1873                // TODO What happens if we don't have pause input??
1874        } else {
1875                int err;
1876                err = trace_pause(libtrace);
1877                // We should handle this a bit better
1878                if (err)
1879                        return err;
1880        }
1881
1882        // Only set as paused after the pause has been called on the trace
1883        libtrace_change_state(libtrace, STATE_PAUSED, true);
1884        return 0;
1885}
1886
1887/**
1888 * Stop trace finish prematurely as though it meet an EOF
1889 * This should only be called by the main thread
1890 * 1. Calls ppause
1891 * 2. Sends a message asking for threads to finish
1892 * 3. Releases threads which will pause
1893 */
1894DLLEXPORT int trace_pstop(libtrace_t *libtrace)
1895{
1896        int i, err;
1897        libtrace_message_t message = {0};
1898        assert(libtrace);
1899
1900        // Ensure all threads have paused and the underlying trace format has
1901        // been closed and all packets associated are cleaned up
1902        // Pause will do any state checks for us
1903        err = trace_ppause(libtrace);
1904        if (err)
1905                return err;
1906
1907        // Now send a message asking the threads to stop
1908        // This will be retrieved before trying to read another packet
1909
1910        message.code = MESSAGE_DO_STOP;
1911        trace_message_perpkts(libtrace, &message);
1912        if (trace_has_dedicated_hasher(libtrace))
1913                trace_message_thread(libtrace, &libtrace->hasher_thread, &message);
1914
1915        for (i = 0; i < libtrace->perpkt_thread_count; i++) {
1916                trace_message_thread(libtrace, &libtrace->perpkt_threads[i], &message);
1917        }
1918
1919        /* Now release the threads and let them stop - when the threads finish
1920         * the state will be set to finished */
1921        libtrace_change_state(libtrace, STATE_FINISHING, true);
1922        return 0;
1923}
1924
1925DLLEXPORT int trace_set_hasher(libtrace_t *trace, enum hasher_types type, fn_hasher hasher, void *data) {
1926        int ret = -1;
1927        if ((type == HASHER_CUSTOM && !hasher) || (type == HASHER_BALANCE && hasher)) {
1928                return -1;
1929        }
1930
1931        // Save the requirements
1932        trace->hasher_type = type;
1933        if (hasher) {
1934                trace->hasher = hasher;
1935                trace->hasher_data = data;
1936        } else {
1937                trace->hasher = NULL;
1938                trace->hasher_data = NULL;
1939        }
1940
1941        // Try push this to hardware - NOTE hardware could do custom if
1942        // there is a more efficient way to apply it, in this case
1943        // it will simply grab the function out of libtrace_t
1944        if (trace_supports_parallel(trace) && trace->format->config_input)
1945                ret = trace->format->config_input(trace, TRACE_OPTION_HASHER, &type);
1946
1947        if (ret == -1) {
1948                /* We have to deal with this ourself */
1949                if (!hasher) {
1950                        switch (type)
1951                        {
1952                                case HASHER_CUSTOM:
1953                                case HASHER_BALANCE:
1954                                        return 0;
1955                                case HASHER_BIDIRECTIONAL:
1956                                        trace->hasher = (fn_hasher) toeplitz_hash_packet;
1957                                        trace->hasher_data = calloc(1, sizeof(toeplitz_conf_t));
1958                                        toeplitz_init_config(trace->hasher_data, 1);
1959                                        return 0;
1960                                case HASHER_UNIDIRECTIONAL:
1961                                        trace->hasher = (fn_hasher) toeplitz_hash_packet;
1962                                        trace->hasher_data = calloc(1, sizeof(toeplitz_conf_t));
1963                                        toeplitz_init_config(trace->hasher_data, 0);
1964                                        return 0;
1965                        }
1966                        return -1;
1967                }
1968        } else {
1969                /* If the hasher is hardware we zero out the hasher and hasher
1970                 * data fields - only if we need a hasher do we do this */
1971                trace->hasher = NULL;
1972                trace->hasher_data = NULL;
1973        }
1974
1975        return 0;
1976}
1977
1978// Waits for all threads to finish
1979DLLEXPORT void trace_join(libtrace_t *libtrace) {
1980        int i;
1981
1982        /* Firstly wait for the perpkt threads to finish, since these are
1983         * user controlled */
1984        for (i=0; i< libtrace->perpkt_thread_count; i++) {
1985                ASSERT_RET(pthread_join(libtrace->perpkt_threads[i].tid, NULL), == 0);
1986                // So we must do our best effort to empty the queue - so
1987                // the producer (or any other threads) don't block.
1988                libtrace_packet_t * packet;
1989                assert(libtrace->perpkt_threads[i].state == THREAD_FINISHED);
1990                while(libtrace_ringbuffer_try_read(&libtrace->perpkt_threads[i].rbuffer, (void **) &packet))
1991                        if (packet) // This could be NULL iff the perpkt finishes early
1992                                trace_destroy_packet(packet);
1993        }
1994
1995        /* Now the hasher */
1996        if (trace_has_dedicated_hasher(libtrace)) {
1997                pthread_join(libtrace->hasher_thread.tid, NULL);
1998                assert(libtrace->hasher_thread.state == THREAD_FINISHED);
1999        }
2000
2001        // Now that everything is finished nothing can be touching our
2002        // buffers so clean them up
2003        for (i = 0; i < libtrace->perpkt_thread_count; i++) {
2004                // Its possible 1 packet got added by the reporter (or 1 per any other thread) since we cleaned up
2005                // if they lost timeslice before-during a write
2006                libtrace_packet_t * packet;
2007                while(libtrace_ringbuffer_try_read(&libtrace->perpkt_threads[i].rbuffer, (void **) &packet))
2008                        trace_destroy_packet(packet);
2009                if (trace_has_dedicated_hasher(libtrace)) {
2010                        assert(libtrace_ringbuffer_is_empty(&libtrace->perpkt_threads[i].rbuffer));
2011                        libtrace_ringbuffer_destroy(&libtrace->perpkt_threads[i].rbuffer);
2012                }
2013                // Cannot destroy vector yet, this happens with trace_destroy
2014        }
2015
2016        if (trace_has_reporter(libtrace)) {
2017                pthread_join(libtrace->reporter_thread.tid, NULL);
2018                assert(libtrace->reporter_thread.state == THREAD_FINISHED);
2019        }
2020
2021        // Wait for the tick (keepalive) thread if it has been started
2022        if (libtrace->keepalive_thread.type == THREAD_KEEPALIVE) {
2023                libtrace_message_t msg = {0};
2024                msg.code = MESSAGE_DO_STOP;
2025                trace_message_thread(libtrace, &libtrace->keepalive_thread, &msg);
2026                pthread_join(libtrace->keepalive_thread.tid, NULL);
2027        }
2028
2029        libtrace_change_state(libtrace, STATE_JOINED, true);
2030        print_memory_stats();
2031}
2032
2033DLLEXPORT int libtrace_thread_get_message_count(libtrace_t * libtrace,
2034                                                libtrace_thread_t *t)
2035{
2036        int ret;
2037        if (t == NULL)
2038                t = get_thread_descriptor(libtrace);
2039        if (t == NULL)
2040                return -1;
2041        ret = libtrace_message_queue_count(&t->messages);
2042        return ret < 0 ? 0 : ret;
2043}
2044
2045DLLEXPORT int libtrace_thread_get_message(libtrace_t * libtrace,
2046                                          libtrace_thread_t *t,
2047                                          libtrace_message_t * message)
2048{
2049        int ret;
2050        if (t == NULL)
2051                t = get_thread_descriptor(libtrace);
2052        if (t == NULL)
2053                return -1;
2054        ret = libtrace_message_queue_get(&t->messages, message);
2055        return ret < 0 ? 0 : ret;
2056}
2057
2058DLLEXPORT int libtrace_thread_try_get_message(libtrace_t * libtrace,
2059                                              libtrace_thread_t *t,
2060                                              libtrace_message_t * message)
2061{
2062        if (t == NULL)
2063                t = get_thread_descriptor(libtrace);
2064        if (t == NULL)
2065                return -1;
2066        if (libtrace_message_queue_try_get(&t->messages, message) != LIBTRACE_MQ_FAILED)
2067                return 0;
2068        else
2069                return -1;
2070}
2071
2072DLLEXPORT int trace_message_thread(libtrace_t * libtrace, libtrace_thread_t *t, libtrace_message_t * message)
2073{
2074        int ret;
2075        if (!message->sender)
2076                message->sender = get_thread_descriptor(libtrace);
2077
2078        ret = libtrace_message_queue_put(&t->messages, message);
2079        return ret < 0 ? 0 : ret;
2080}
2081
2082DLLEXPORT int trace_message_reporter(libtrace_t * libtrace, libtrace_message_t * message)
2083{
2084        if (!trace_has_reporter(libtrace) ||
2085            !(libtrace->reporter_thread.state == THREAD_RUNNING
2086              || libtrace->reporter_thread.state == THREAD_PAUSED))
2087                return -1;
2088
2089        return trace_message_thread(libtrace, &libtrace->reporter_thread, message);
2090}
2091
2092DLLEXPORT int trace_post_reporter(libtrace_t *libtrace)
2093{
2094        libtrace_message_t message = {0};
2095        message.code = MESSAGE_POST_REPORTER;
2096        return trace_message_reporter(libtrace, (void *) &message);
2097}
2098
2099DLLEXPORT int trace_message_perpkts(libtrace_t * libtrace, libtrace_message_t * message)
2100{
2101        int i;
2102        int missed = 0;
2103        if (message->sender == NULL)
2104                message->sender = get_thread_descriptor(libtrace);
2105        for (i = 0; i < libtrace->perpkt_thread_count; i++) {
2106                if (libtrace->perpkt_threads[i].state == THREAD_RUNNING ||
2107                    libtrace->perpkt_threads[i].state == THREAD_PAUSED) {
2108                        libtrace_message_queue_put(&libtrace->perpkt_threads[i].messages, message);
2109                } else {
2110                        missed += 1;
2111                }
2112        }
2113        return -missed;
2114}
2115
2116DLLEXPORT void * trace_get_local(libtrace_t *trace)
2117{
2118        return trace->global_blob;
2119}
2120
2121DLLEXPORT void * trace_set_local(libtrace_t *trace, void * data)
2122{
2123        void *ret;
2124        pthread_mutex_lock(&trace->libtrace_lock);
2125        ret = trace->global_blob;
2126        trace->global_blob = data;
2127        pthread_mutex_unlock(&trace->libtrace_lock);
2128        return ret;
2129}
2130
2131DLLEXPORT void * trace_get_tls(libtrace_thread_t *t)
2132{
2133        return t->user_data;
2134}
2135
2136DLLEXPORT void * trace_set_tls(libtrace_thread_t *t, void * data)
2137{
2138        void *ret = t->user_data;
2139        t->user_data = data;
2140        return ret;
2141}
2142
2143/**
2144 * Publishes a result to the reduce queue
2145 * Should only be called by a perpkt thread, i.e. from a perpkt handler
2146 */
2147DLLEXPORT void trace_publish_result(libtrace_t *libtrace, libtrace_thread_t *t, uint64_t key, libtrace_generic_t value, int type) {
2148        libtrace_result_t res;
2149        res.type = type;
2150        res.key = key;
2151        res.value = value;
2152        assert(libtrace->combiner.publish);
2153        libtrace->combiner.publish(libtrace, t->perpkt_num, &libtrace->combiner, &res);
2154        return;
2155}
2156
2157DLLEXPORT void trace_set_combiner(libtrace_t *trace, const libtrace_combine_t *combiner, libtrace_generic_t config){
2158        if (combiner) {
2159                trace->combiner = *combiner;
2160                trace->combiner.configuration = config;
2161        } else {
2162                // No combiner, so don't try use it
2163                memset(&trace->combiner, 0, sizeof(trace->combiner));
2164        }
2165}
2166
2167DLLEXPORT uint64_t trace_packet_get_order(libtrace_packet_t * packet) {
2168        return packet->order;
2169}
2170
2171DLLEXPORT uint64_t trace_packet_get_hash(libtrace_packet_t * packet) {
2172        return packet->hash;
2173}
2174
2175DLLEXPORT void trace_packet_set_order(libtrace_packet_t * packet, uint64_t order) {
2176        packet->order = order;
2177}
2178
2179DLLEXPORT void trace_packet_set_hash(libtrace_packet_t * packet, uint64_t hash) {
2180        packet->hash = hash;
2181}
2182
2183DLLEXPORT bool trace_has_finished(libtrace_t * libtrace) {
2184        return libtrace->state == STATE_FINISHED || libtrace->state == STATE_JOINED;
2185}
2186
2187/**
2188 * @return True if the trace is not running such that it can be configured
2189 */
2190static inline bool trace_is_configurable(libtrace_t *trace) {
2191        return trace->state == STATE_NEW ||
2192                        trace->state == STATE_PAUSED;
2193}
2194
2195DLLEXPORT int trace_set_perpkt_threads(libtrace_t *trace, int nb) {
2196        if (!trace_is_configurable(trace)) return -1;
2197
2198        /* TODO consider allowing an offset from the total number of cores i.e.
2199         * -1 reserve 1 core */
2200        if (nb >= 0) {
2201                trace->config.perpkt_threads = nb;
2202                return 0;
2203        } else {
2204                return -1;
2205        }
2206}
2207
2208DLLEXPORT int trace_set_tick_interval(libtrace_t *trace, size_t millisec) {
2209        if (!trace_is_configurable(trace)) return -1;
2210
2211        trace->config.tick_interval = millisec;
2212        return 0;
2213}
2214
2215DLLEXPORT int trace_set_tick_count(libtrace_t *trace, size_t count) {
2216        if (!trace_is_configurable(trace)) return -1;
2217
2218        trace->config.tick_count = count;
2219        return 0;
2220}
2221
2222DLLEXPORT int trace_set_tracetime(libtrace_t *trace, bool tracetime) {
2223        if (!trace_is_configurable(trace)) return -1;
2224
2225        trace->tracetime = tracetime;
2226        return 0;
2227}
2228
2229DLLEXPORT int trace_set_cache_size(libtrace_t *trace, size_t size) {
2230        if (!trace_is_configurable(trace)) return -1;
2231
2232        trace->config.cache_size = size;
2233        return 0;
2234}
2235
2236DLLEXPORT int trace_set_thread_cache_size(libtrace_t *trace, size_t size) {
2237        if (!trace_is_configurable(trace)) return -1;
2238
2239        trace->config.thread_cache_size = size;
2240        return 0;
2241}
2242
2243DLLEXPORT int trace_set_fixed_count(libtrace_t *trace, bool fixed) {
2244        if (!trace_is_configurable(trace)) return -1;
2245
2246        trace->config.fixed_count = fixed;
2247        return 0;
2248}
2249
2250DLLEXPORT int trace_set_burst_size(libtrace_t *trace, size_t size) {
2251        if (!trace_is_configurable(trace)) return -1;
2252
2253        trace->config.burst_size = size;
2254        return 0;
2255}
2256
2257DLLEXPORT int trace_set_hasher_queue_size(libtrace_t *trace, size_t size) {
2258        if (!trace_is_configurable(trace)) return -1;
2259
2260        trace->config.hasher_queue_size = size;
2261        return 0;
2262}
2263
2264DLLEXPORT int trace_set_hasher_polling(libtrace_t *trace, bool polling) {
2265        if (!trace_is_configurable(trace)) return -1;
2266
2267        trace->config.hasher_polling = polling;
2268        return 0;
2269}
2270
2271DLLEXPORT int trace_set_reporter_polling(libtrace_t *trace, bool polling) {
2272        if (!trace_is_configurable(trace)) return -1;
2273
2274        trace->config.reporter_polling = polling;
2275        return 0;
2276}
2277
2278DLLEXPORT int trace_set_reporter_thold(libtrace_t *trace, size_t thold) {
2279        if (!trace_is_configurable(trace)) return -1;
2280
2281        trace->config.reporter_thold = thold;
2282        return 0;
2283}
2284
2285DLLEXPORT int trace_set_debug_state(libtrace_t *trace, bool debug_state) {
2286        if (!trace_is_configurable(trace)) return -1;
2287
2288        trace->config.debug_state = debug_state;
2289        return 0;
2290}
2291
2292
2293
2294static bool config_bool_parse(char *value, size_t nvalue) {
2295        if (strncmp(value, "true", nvalue) == 0)
2296                return true;
2297        else if (strncmp(value, "false", nvalue) == 0)
2298                return false;
2299        else
2300                return strtoll(value, NULL, 10) != 0;
2301}
2302
2303/* Note update documentation on trace_set_configuration */
2304static void config_string(struct user_configuration *uc, char *key, size_t nkey, char *value, size_t nvalue) {
2305        assert(key);
2306        assert(value);
2307        assert(uc);
2308        if (strncmp(key, "cache_size", nkey) == 0
2309            || strncmp(key, "cs", nkey) == 0) {
2310                uc->cache_size = strtoll(value, NULL, 10);
2311        } else if (strncmp(key, "thread_cache_size", nkey) == 0
2312                   || strncmp(key, "tcs", nkey) == 0) {
2313                uc->thread_cache_size = strtoll(value, NULL, 10);
2314        } else if (strncmp(key, "fixed_count", nkey) == 0
2315                   || strncmp(key, "fc", nkey) == 0) {
2316                uc->fixed_count = config_bool_parse(value, nvalue);
2317        } else if (strncmp(key, "burst_size", nkey) == 0
2318                   || strncmp(key, "bs", nkey) == 0) {
2319                uc->burst_size = strtoll(value, NULL, 10);
2320        } else if (strncmp(key, "tick_interval", nkey) == 0
2321                   || strncmp(key, "ti", nkey) == 0) {
2322                uc->tick_interval = strtoll(value, NULL, 10);
2323        } else if (strncmp(key, "tick_count", nkey) == 0
2324                   || strncmp(key, "tc", nkey) == 0) {
2325                uc->tick_count = strtoll(value, NULL, 10);
2326        } else if (strncmp(key, "perpkt_threads", nkey) == 0
2327                   || strncmp(key, "pt", nkey) == 0) {
2328                uc->perpkt_threads = strtoll(value, NULL, 10);
2329        } else if (strncmp(key, "hasher_queue_size", nkey) == 0
2330                   || strncmp(key, "hqs", nkey) == 0) {
2331                uc->hasher_queue_size = strtoll(value, NULL, 10);
2332        } else if (strncmp(key, "hasher_polling", nkey) == 0
2333                   || strncmp(key, "hp", nkey) == 0) {
2334                uc->hasher_polling = config_bool_parse(value, nvalue);
2335        } else if (strncmp(key, "reporter_polling", nkey) == 0
2336                   || strncmp(key, "rp", nkey) == 0) {
2337                uc->reporter_polling = config_bool_parse(value, nvalue);
2338        } else if (strncmp(key, "reporter_thold", nkey) == 0
2339                   || strncmp(key, "rt", nkey) == 0) {
2340                uc->reporter_thold = strtoll(value, NULL, 10);
2341        } else if (strncmp(key, "debug_state", nkey) == 0
2342                   || strncmp(key, "ds", nkey) == 0) {
2343                uc->debug_state = config_bool_parse(value, nvalue);
2344        } else {
2345                fprintf(stderr, "No matching option %s(=%s), ignoring\n", key, value);
2346        }
2347}
2348
2349DLLEXPORT int trace_set_configuration(libtrace_t *trace, const char *str) {
2350        char *pch;
2351        char key[100];
2352        char value[100];
2353        char *dup;
2354        assert(str);
2355        assert(trace);
2356
2357        if (!trace_is_configurable(trace)) return -1;
2358
2359        dup = strdup(str);
2360        pch = strtok (dup," ,.-");
2361        while (pch != NULL)
2362        {
2363                if (sscanf(pch, "%99[^=]=%99s", key, value) == 2) {
2364                        config_string(&trace->config, key, sizeof(key), value, sizeof(value));
2365                } else {
2366                        fprintf(stderr, "Error parsing option %s\n", pch);
2367                }
2368                pch = strtok (NULL," ,.-");
2369        }
2370        free(dup);
2371
2372        return 0;
2373}
2374
2375DLLEXPORT int trace_set_configuration_file(libtrace_t *trace, FILE *file) {
2376        char line[1024];
2377        if (!trace_is_configurable(trace)) return -1;
2378
2379        while (fgets(line, sizeof(line), file) != NULL)
2380        {
2381                trace_set_configuration(trace, line);
2382        }
2383
2384        if(ferror(file))
2385                return -1;
2386        else
2387                return 0;
2388}
2389
2390DLLEXPORT void trace_free_packet(libtrace_t *libtrace, libtrace_packet_t *packet) {
2391        assert(packet);
2392        /* Always release any resources this might be holding */
2393        trace_fin_packet(packet);
2394        libtrace_ocache_free(&libtrace->packet_freelist, (void **) &packet, 1, 1);
2395}
2396
2397DLLEXPORT libtrace_info_t *trace_get_information(libtrace_t * libtrace) {
2398        if (libtrace->format)
2399                return &libtrace->format->info;
2400        else
2401                return NULL;
2402}
Note: See TracBrowser for help on using the repository browser.