OSSP CVS Repository

ossp - Difference in ossp-pkg/l2/TODO versions 1.51 and 1.52
Not logged in
[Honeypot]  [Browse]  [Home]  [Login]  [Reports
[Search]  [Ticket]  [Timeline
  [History

ossp-pkg/l2/TODO 1.51 -> 1.52

--- TODO 2001/12/22 22:25:34     1.51
+++ TODO 2002/01/03 11:54:25     1.52
@@ -184,6 +184,31 @@
     Describe whether a channel continues passing data on downstream
     if it somehow fails, and if the data will be corrupt.
 
+- l2_util_fmt_string
+    This can be used like %s, but instead of fetching only a "char *"
+    from the var-args stack, it fetches a "char *" plus a "size_t" and
+    this way allows one to log only a sub-string of a larger string
+    without the need for any temporary buffers, etc.
+    
+- l2_util_fmt_dump:
+    This can be used as "%{type}X" for dumping arbitrary octets. The
+    parameter "type" can be either "text" (the default if only "%X"
+    is used) for dumping the octets as text but with non-printable
+    characters replaced by "\xXX" constructs; "hex" for dumping the
+    octets in hexadecimal as "XX:XX:XX:XX" or "base64" for dumping the
+    octets Base64 encoded. All three are intended for making it easier to
+    produce reasonable L2_LEVEL_DEBUG messages without having to fiddle
+    around with temporary buffers and having to care with non-printable
+    characters.
+
+- formatter example
+    l2_stream_formatter(st, 'D', l2_util_fmt_dump, NULL);
+        :
+    l2_stream_vlog(st, L2_LEVEL_DEBUG, "%{text}D %{hex}D %{base64}D\n",
+        "foo", 12345, "foo\1bar", 7, "foo\1bar", 7, "foo\1bar", 7);
+        :
+    ...produces "foo\x01bar 66:6f:6f:01:62:61:72 Zm9vAWJhcg=="
+
 High-level configuration interface
 ==================================
 Config-File (OSSP):

CVSTrac 2.0.1