org.eclipse.linuxtools.lttng.jni/src/org/eclipse/linuxtools/lttng/jni_v2_5/JniTrace_v2_5.java

   1 package org.eclipse.linuxtools.lttng.jni_v2_5;
   2 /*******************************************************************************
   3  * Copyright (c) 2009 Ericsson
   4  *
   5  * All rights reserved. This program and the accompanying materials are
   6  * made available under the terms of the Eclipse Public License v1.0 which
   7  * accompanies this distribution, and is available at
   8  * http://www.eclipse.org/legal/epl-v10.html
   9  *
  10  * Contributors:
  11  *   William Bourque (wbourque@gmail.com) - Initial API and implementation
  12  *******************************************************************************/
  13
  14 import org.eclipse.linuxtools.lttng.jni.JniTrace;
  15 import org.eclipse.linuxtools.lttng.jni.JniTracefile;
  16 import org.eclipse.linuxtools.lttng.jni.common.Jni_C_Pointer_And_Library_Id;
  17 import org.eclipse.linuxtools.lttng.jni.exception.JniException;
  18
  19 /**
  20  * <b><u>JniTrace_v2_5</u></b>
  21  * <p>
  22  * JniTrace version to support Lttng traceformat of version 2.5.<br>
  23  * This class extend abstract class JniTrace with (possibly) version specific implementation (none yet).<br>
  24  *
  25  * It also make sure the correct library is loaded by liblttvlibraryloader.so
  26  * <p>
  27  */
  28 public class JniTrace_v2_5 extends JniTrace {
  29
  30         // This is the dynamic library name that is passed to the library loader (liblttvlibraryloader.so) to load.
  31         // It needs to be a complete name, like "libXYZ.so", unlike java that would take "XYZ". It could also take a complete path.
  32         //      The library need to be accessible, i.e. LD_LIBRARY_PATH need to be set correctly.
  33         private static final String LIBRARY_NAME = "liblttvtraceread-2.5.so"; //$NON-NLS-1$
  34
  35         /*
  36          * Forbid access to the default constructor
  37          */
  38         protected JniTrace_v2_5() {
  39                 super();
  40     }
  41
  42
  43         public JniTrace_v2_5(String newpath) throws JniException {
  44                 super(newpath);
  45         }
  46
  47     public JniTrace_v2_5(String newpath, boolean newPrintDebug) throws JniException {
  48         super(newpath, newPrintDebug);
  49     }
  50
  51
  52     public JniTrace_v2_5(JniTrace_v2_5 oldTrace) {
  53         super(oldTrace);
  54     }
  55
  56     public JniTrace_v2_5(Jni_C_Pointer_And_Library_Id newPtr, boolean newPrintDebug) throws JniException {
  57         super(newPtr, newPrintDebug);
  58     }
  59
  60
  61     /**
  62      * Initialize the C library.<p>
  63      *
  64      * Call the library loader with the .so we wish to load.
  65      *
  66      * @return  True if the load went successful, false otherwise.
  67      */
  68     @Override
  69         public int initializeLibrary() {
  70         return ltt_initializeHandle(LIBRARY_NAME);
  71     }
  72
  73     /**
  74      * Allocate (call constructor for) a new JniTracefile.<p>
  75      *
  76      * This method is made to bypass limitation related to abstract class, see comment in JniTrace
  77      *
  78      * @return JniTracefile     a newly allocated JniTracefile
  79      *
  80      * @see org.eclipse.linuxtools.lttng.jni.JniTrace
  81      */
  82     @Override
  83         public JniTracefile allocateNewJniTracefile(Jni_C_Pointer_And_Library_Id newPtr, JniTrace newParentTrace) throws JniException {
  84         return new JniTracefile_v2_5(newPtr, newParentTrace);
  85     }
  86
  87
  88
  89 }