Skip to contentSkip to conversation

Doc: Update README

PATCH Mathieu Desnoyers 2 participants 4 messages Apr 25, 2016 – Apr 26, 2016 4 messages not in the archive

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): [email protected]

#1 lore raw
Quoted 19 lines · ----- On Apr 25, 2016, at 3:08 PM, Michael Jeanson [email protected] wrote:

---
README.md | 14 +++++++++-----

1 file changed, 9 insertions(+), 5 deletions(-)
README.md +1 -1
index a2d9e63..728c103 100644
@@ -33,7 +33,7 @@ compile the Git repository tree:
 
 ### Optional dependencies
 
-Optional packages to build LTTng-tools man pages:
+Optional packages to build LTTng-ust man pages:
 
  - **[AsciiDoc](http://www.methods.co.nz/asciidoc/) >= 8.4.5**
    (previous versions may work, but were not tested)

README.md This package contains the following elements: · line 228

Quoted 8 lines
README.md +1 -4
@@ -225,15 +225,19 @@ This package contains the following elements:
    It _has_ to be preloaded in order to hijack calls. In contrast,
    `liblttng-ust` may be linked at build time.
  - `liblttng-ust-java`: a simple library that uses JNI to allow tracing
-    in Java programs.
-  - `liblttng-ust-jul`: a package that includes a JNI library and a JAR
-    library to provide an LTTng-UST logging back-end for Java application
-    using Java Util Logging.
+    in Java programs. (Deprecated)

Is it really deprecated ?

Mathieu

Quoted 17 lines
README.md +7 -1
+  - `liblttng-ust-java-agent`: a package that includes a JNI library and a
+    JAR library to provide an LTTng-UST logging back-end for Java
+    applications using Java Util Logging or Log4j.
  - `liblttng-ust-libc-wrapper`: an example library that can be
    preloaded to instrument some calls to libc (currently `malloc()` and
    `free()`) and to POSIX threads (mutexes currently instrumented) in
    any program without need to recompile it.
+  - `liblttng-ust-python-agent`: a library used by python-lttngust to allow
+    tracing in Python applications.
  - `libringbuffer`: the ring buffer implementation used within LTTng-UST.
+  - `python-lttngust`: a package to provide an LTTng-UST logging back-end
+    for Python applications using the standard logging framework.
  - `snprintf`: an asynchronous signal-safe version of `snprintf()`.
  - `tests`: various test programs.
  - `tools`: home of `lttng-gen-tp`.
--

2.7.4

Signature · 7 lines
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com
_______________________________________________
lttng-dev mailing list
[email protected]
https://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev

A message that is not in the archive (sent off-list or not yet received): [email protected]

#3 lore raw
Quoted 18 lines · ----- On Apr 25, 2016, at 3:53 PM, Mathieu Desnoyers…
Quoted 16 lines · ----- On Apr 25, 2016, at 3:08 PM, Michael Jeanson [email protected] wrote:

---
README.md | 14 +++++++++-----

1 file changed, 9 insertions(+), 5 deletions(-)
README.md +1 -1
index a2d9e63..728c103 100644
@@ -33,7 +33,7 @@ compile the Git repository tree:
 
 ### Optional dependencies
 
-Optional packages to build LTTng-tools man pages:
+Optional packages to build LTTng-ust man pages:
 
Quoted 13 lines

README.md This package contains the following elements: · line 228

Quoted 11 lines
README.md +1 -4
  - **[AsciiDoc](http://www.methods.co.nz/asciidoc/) >= 8.4.5**
    (previous versions may work, but were not tested)
@@ -225,15 +225,19 @@ This package contains the following elements:
    It _has_ to be preloaded in order to hijack calls. In contrast,
    `liblttng-ust` may be linked at build time.
  - `liblttng-ust-java`: a simple library that uses JNI to allow tracing
-    in Java programs.
-  - `liblttng-ust-jul`: a package that includes a JNI library and a JAR
-    library to provide an LTTng-UST logging back-end for Java application
-    using Java Util Logging.
+    in Java programs. (Deprecated)

Is it really deprecated ?

Well, you tell me but I was lead to believe it would be removed once the java agent was stable and feature complete. As far as I know, it is untested and not even built in the CI.

Quoted 21 lines

Mathieu

Quoted 16 lines
README.md +7 -1
+  - `liblttng-ust-java-agent`: a package that includes a JNI library and a
+    JAR library to provide an LTTng-UST logging back-end for Java
+    applications using Java Util Logging or Log4j.
  - `liblttng-ust-libc-wrapper`: an example library that can be
    preloaded to instrument some calls to libc (currently `malloc()` and
    `free()`) and to POSIX threads (mutexes currently instrumented) in
    any program without need to recompile it.
+  - `liblttng-ust-python-agent`: a library used by python-lttngust to allow
+    tracing in Python applications.
  - `libringbuffer`: the ring buffer implementation used within LTTng-UST.
+  - `python-lttngust`: a package to provide an LTTng-UST logging back-end
+    for Python applications using the standard logging framework.
  - `snprintf`: an asynchronous signal-safe version of `snprintf()`.
  - `tests`: various test programs.
  - `tools`: home of `lttng-gen-tp`.
--
Quoted 1 line

2.7.4

Quoted 4 lines

--
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com

_______________________________________________
lttng-dev mailing list
[email protected]
https://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev

A message that is not in the archive (sent off-list or not yet received): [email protected]

#5 lore raw
Quoted 35 lines · ----- On Apr 25, 2016, at 4:06 PM, Michael Jeanson [email protected] wrote:

----- On Apr 25, 2016, at 3:53 PM, Mathieu Desnoyers

Quoted 18 lines · [email protected] wrote:
Quoted 16 lines · ----- On Apr 25, 2016, at 3:08 PM, Michael Jeanson [email protected] wrote:

---
README.md | 14 +++++++++-----

1 file changed, 9 insertions(+), 5 deletions(-)
README.md +1 -1
index a2d9e63..728c103 100644
@@ -33,7 +33,7 @@ compile the Git repository tree:
 
 ### Optional dependencies
 
-Optional packages to build LTTng-tools man pages:
+Optional packages to build LTTng-ust man pages:
 
Quoted 13 lines

README.md This package contains the following elements: · line 228

Quoted 11 lines
README.md +1 -4
  - **[AsciiDoc](http://www.methods.co.nz/asciidoc/) >= 8.4.5**
    (previous versions may work, but were not tested)
@@ -225,15 +225,19 @@ This package contains the following elements:
    It _has_ to be preloaded in order to hijack calls. In contrast,
    `liblttng-ust` may be linked at build time.
  - `liblttng-ust-java`: a simple library that uses JNI to allow tracing
-    in Java programs.
-  - `liblttng-ust-jul`: a package that includes a JNI library and a JAR
-    library to provide an LTTng-UST logging back-end for Java application
-    using Java Util Logging.
+    in Java programs. (Deprecated)

Is it really deprecated ?

Quoted 3 lines

Well, you tell me but I was lead to believe it would be removed once the java agent was stable and feature complete. As far as I know, it is untested and not even built in the CI.

This JNI interface is probably faster than going through the JUL/log4j agents. Therefore, there appears to be legitimate use-cases for it. If tests/CI integration are missing, we should eventually add those.

But AFAIK, it is not deprecated.

Thanks,

Mathieu

Quoted 26 lines
Quoted 26 lines

Mathieu

Quoted 16 lines
README.md +7 -1
+  - `liblttng-ust-java-agent`: a package that includes a JNI library and a
+    JAR library to provide an LTTng-UST logging back-end for Java
+    applications using Java Util Logging or Log4j.
  - `liblttng-ust-libc-wrapper`: an example library that can be
    preloaded to instrument some calls to libc (currently `malloc()` and
    `free()`) and to POSIX threads (mutexes currently instrumented) in
    any program without need to recompile it.
+  - `liblttng-ust-python-agent`: a library used by python-lttngust to allow
+    tracing in Python applications.
  - `libringbuffer`: the ring buffer implementation used within LTTng-UST.
+  - `python-lttngust`: a package to provide an LTTng-UST logging back-end
+    for Python applications using the standard logging framework.
  - `snprintf`: an asynchronous signal-safe version of `snprintf()`.
  - `tests`: various test programs.
  - `tools`: home of `lttng-gen-tp`.
--
Quoted 1 line

2.7.4

--
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com

Signature · 7 lines
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com
_______________________________________________
lttng-dev mailing list
[email protected]
https://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev

A message that is not in the archive (sent off-list or not yet received): [email protected]

#7 lore raw
Quoted 41 lines · ----- On Apr 25, 2016, at 4:11 PM, Mathieu Desnoyers…
Quoted 35 lines · ----- On Apr 25, 2016, at 4:06 PM, Michael Jeanson [email protected] wrote:

----- On Apr 25, 2016, at 3:53 PM, Mathieu Desnoyers

Quoted 18 lines · [email protected] wrote:
Quoted 16 lines · ----- On Apr 25, 2016, at 3:08 PM, Michael Jeanson [email protected] wrote:

---
README.md | 14 +++++++++-----

1 file changed, 9 insertions(+), 5 deletions(-)
README.md +1 -1
index a2d9e63..728c103 100644
@@ -33,7 +33,7 @@ compile the Git repository tree:
 
 ### Optional dependencies
 
-Optional packages to build LTTng-tools man pages:
+Optional packages to build LTTng-ust man pages:
 
Quoted 13 lines

README.md This package contains the following elements: · line 228

Quoted 11 lines
README.md +1 -4
  - **[AsciiDoc](http://www.methods.co.nz/asciidoc/) >= 8.4.5**
    (previous versions may work, but were not tested)
@@ -225,15 +225,19 @@ This package contains the following elements:
    It _has_ to be preloaded in order to hijack calls. In contrast,
    `liblttng-ust` may be linked at build time.
  - `liblttng-ust-java`: a simple library that uses JNI to allow tracing
-    in Java programs.
-  - `liblttng-ust-jul`: a package that includes a JNI library and a JAR
-    library to provide an LTTng-UST logging back-end for Java application
-    using Java Util Logging.
+    in Java programs. (Deprecated)

Is it really deprecated ?

Quoted 3 lines

Well, you tell me but I was lead to believe it would be removed once the java agent was stable and feature complete. As far as I know, it is untested and not even built in the CI.

Quoted 6 lines

This JNI interface is probably faster than going through the JUL/log4j agents. Therefore, there appears to be legitimate use-cases for it. If tests/CI integration
are missing, we should eventually add those.

But AFAIK, it is not deprecated.

merging this patch, but removing the "(Deprecated)".

This is going into master, 2.8, and 2.7 (with changes).

Thanks,

Mathieu

Quoted 40 lines

Thanks,

Mathieu

Quoted 22 lines
Quoted 22 lines

Mathieu

Quoted 17 lines
README.md +7 -1
+  - `liblttng-ust-java-agent`: a package that includes a JNI library and a
+    JAR library to provide an LTTng-UST logging back-end for Java
+    applications using Java Util Logging or Log4j.
  - `liblttng-ust-libc-wrapper`: an example library that can be
    preloaded to instrument some calls to libc (currently `malloc()` and
    `free()`) and to POSIX threads (mutexes currently instrumented) in
    any program without need to recompile it.
+  - `liblttng-ust-python-agent`: a library used by python-lttngust to allow
+    tracing in Python applications.
  - `libringbuffer`: the ring buffer implementation used within LTTng-UST.
+  - `python-lttngust`: a package to provide an LTTng-UST logging back-end
+    for Python applications using the standard logging framework.
  - `snprintf`: an asynchronous signal-safe version of `snprintf()`.
  - `tests`: various test programs.
  - `tools`: home of `lttng-gen-tp`.
--

2.7.4

Quoted 4 lines
Quoted 4 lines

--
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com

--
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com
_______________________________________________
lttng-dev mailing list
[email protected]
https://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev

Signature · 7 lines
Mathieu Desnoyers
EfficiOS Inc.
http://www.efficios.com
_______________________________________________
lttng-dev mailing list
[email protected]
https://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev