X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=genevent-new%2FREADME;h=d38633d35cd22797ed87e03abb8d44e2daf45b65;hb=ba899d3dc9f7c730c8bf699617d5f7a22d196f37;hp=ad31d648e4d39986cd3d84184b5c765eca7532bc;hpb=af530af44a375e95f5d0ffcf8da4daa0b05584fb;p=lttv.git
diff --git a/genevent-new/README b/genevent-new/README
index ad31d648..d38633d3 100644
--- a/genevent-new/README
+++ b/genevent-new/README
@@ -12,6 +12,12 @@ There are several files in the directory:
In fact, crc32.tab, parser.c and parser.h are the same files as
those in LTT library.
+Important notes :
+ * Do not put "-" symbols in facilities name.
+ * Use the exact same name for facility xml file and for facility name.
+ * As from genevent 0.17, a standard XML 1.0 description is "required". It must
+ begin with the header.
+
Note about strings :
There are three methods to write strings in genevent, each suitable and
efficient for a particular case. They are explained here from the fastest
@@ -22,7 +28,7 @@ to the slowest.
as string definition.
you must then define it as an array of char :
-
+
Note, however, that you might not want to declare a fixed size for trace size
and unnecessary copy matters.
@@ -44,11 +50,11 @@ to the slowest.
size.
A typical use for this case is filenames in the Linux kernel. The
- dentry strucure has a d_name members, which is a struct qstr containing
+ dentry strucure has a d_name member, which is a struct qstr containing
a unsigned int len and const unsigned char *name.
you must use a sequence to declare this efficiently :
- />
+
3 - The C code presents a \0 terminated string.