From 655ee2825121e149a9976e562946892efb20aea1 Mon Sep 17 00:00:00 2001 From: hunt Date: Thu, 7 Apr 2005 21:48:47 +0000 Subject: *** empty log message *** --- runtime/docs/html/group__io.html | 98 ++++++++++++++++------------------------ 1 file changed, 38 insertions(+), 60 deletions(-) (limited to 'runtime/docs/html/group__io.html') diff --git a/runtime/docs/html/group__io.html b/runtime/docs/html/group__io.html index 357e250b..76051d30 100644 --- a/runtime/docs/html/group__io.html +++ b/runtime/docs/html/group__io.html @@ -4,32 +4,37 @@ -
Main Page | Modules | Data Structures | Directories | File List | Data Fields | Globals | Related Pages
+
Main Page | Modules | Directories | File List | Globals | Related Pages

I/O

I/O functions. More... + + + + - + - - + + - - + + - +

Defines

+#define STP_LOG_BUF_LEN   2047
 private buffer for _stp_log()

Functions

void dlog (const char *fmt,...)
void _stp_log (const char *fmt,...)
 Logs Data.
void _stp_print (const char *fmt,...)
 Logs Data.
int _stp_netlink_open (void)
 Prints to the trace buffer.
void _stp_print_str (char *str)
 Opens netlink and relayfs connections to stpd.
void _stp_netlink_close (void)
 Prints to the trace buffer.
 Closes netlink and relayfs connections to stpd.

Detailed Description

I/O functions.

Function Documentation

-

+

- + @@ -57,33 +62,34 @@ I/O functions. +Referenced by _stp_list_clear(), _stp_register_jprobes(), _stp_register_kprobes(), _stp_stack_sprint(), _stp_string_init(), _stp_unregister_jprobes(), and _stp_unregister_kprobes().
void _stp_print void _stp_log (  const char *  fmt,

-Prints to the trace buffer. +Logs Data.

-This function uses the same formatting as printk. It currently writes to the system log.

-

Parameters:
+This function prints to the system log if stpd has not connected yet. Otherwise it sends the message immediately to stpd.
Parameters:
fmt A variable number of args.
-

-

Todo:
Needs replaced with something much faster that does not use the system log.
+
Note:
Lines are limited in length by printk buffer. If there is no newline in the format string, then other syslog output could get appended to the SystemTap line.
+
Todo:
Evaluate if this function is necessary.

-Definition at line 43 of file io.c. +Definition at line 29 of file io.c. +

+References STP_LOG_BUF_LEN.

-Referenced by _stp_symbol_print().

-

+

- + - - + + @@ -99,42 +105,26 @@ Referenced by _stp_symbol_print() +Definition at line 103 of file io.c.
void _stp_print_str void _stp_netlink_close ( char *  str void   ) 

-Prints to the trace buffer. -

-This function will write a string to the trace buffer. It currently writes to the system log.

-

Parameters:
- - -
str String.
-
+Closes netlink and relayfs connections to stpd.

-

Todo:
Needs replaced with something much faster that does not use the system log.
+This must be called after all I/O is done, probably at the end of module cleanup.
Returns:
0 on success. -1 if there is a problem establishing a connection.

-Definition at line 60 of file io.c.

-

+

@@ -148,23 +138,11 @@ Definition at line 60 of file +Definition at line 87 of file io.c.
- + - - - - - - - - - - - - - + + + +
void dlog int _stp_netlink_open ( const char *  fmt,
  ...
) void   ) 

-Logs Data. -

-This function is compatible with printk. In fact it currently sends all output to vprintk, after sending "STP: ". This allows us to easily detect SystemTap output in the log file.

-

Parameters:
- - -
fmt A variable number of args.
-
-

-

Bug:
Lines are limited in length by printk buffer. If there is no newline in the format string, then other syslog output could get appended to the SystemTap line.
-

-

Todo:
Either deprecate or redefine this as a way to log debug or status messages, separate from the normal program output.
- +Opens netlink and relayfs connections to stpd.

-Definition at line 25 of file io.c. +This must be called before any I/O is done, probably at the start of module initialization.

-Referenced by _stp_list_clear(), _stp_register_jprobes(), _stp_register_kprobes(), _stp_unregister_jprobes(), and _stp_unregister_kprobes().

-- cgit