[lockdev-devel] [PATCH 16/19] remove debugging section from manpage

Ludwig Nussel ludwig.nussel at suse.de
Thu Feb 25 10:02:13 UTC 2010


---
 docs/lockdev.3 |   60 --------------------------------------------------------
 1 files changed, 0 insertions(+), 60 deletions(-)

diff --git a/docs/lockdev.3 b/docs/lockdev.3
index d3638a8..7490cac 100644
--- a/docs/lockdev.3
+++ b/docs/lockdev.3
@@ -78,72 +78,12 @@ locked by an existing process, they return the pid of the process owner
 of the lock. They return a negative number when some kind of error
 happens. Actually they all return only (-1).
 
-.SH DEBUGGING
-The 
-.B API
-has symbols used only for debugging purposis
-.sp
-.BI "int liblockdev_debug"
-.br
-.BI "void liblockdev_incr_debug( void );"
-.br
-.BI "void liblockdev_reset_debug( void );"
-.sp
-which can be used when the liblockdev library is compiled with 
-.B -DDEBUG
-flag as when using 
-.B make install-dbg ,
-which compiles a debug shared library and installs it under
-/usr/local/lib/debug (or /usr/lib/debug).
-.br
-The value of the global integer is set to 1 by the DEBUG define,
-and can be set to a different value passing a flag like 
-.B -DDEBUG=3 
-during compilation of the library, or setting the environment variable
-.B LIBLOCKDEV_DEBUG
-to the wanted value before executing your program.
-.br
-During execution of your program, the flag's value can be changed from
-your program or from another terminal, respectively using the function
-.B liblockdev_incr_debug() ,
-or sending SIGUSR1 to the running process,
-to increment the value of the integer by one, or using the function
-.B liblockdev_reset_debug() ,
-or sending SIGUSR2 to the running process,
-to set to zero the value of the global integer.
-.br
-Direct manipulation of the global integer is strongly deprecated,
-because the data structure of the symbol (actually an integer) could be
-changed later in some way, or even become a macro.
-.sp
-The library prints on stdout some informations like error conditions
-(level of 1), normal termination conditions (2) or function calling (3).
-.sp
-To use the debug shared library, simply define in your environment the
-variable LD_LIBRARY_PATH=/usr/lib/debug (or /usr/local/lib/debug if
-built using make install-dbg) and call gdb or directly your program
-without any need to recompile it. As you can check with ldd, your
-program will load the debug library instead of the normal one.
-.br
-Beware that if your program is setuid or setgid, you must become root to
-let this work, because ld.so ignores the LD_LIBRARY_PATH variable for
-security reasons.
-.sp
-On
-.B Debian GNU/Linux
-systems exists a debug binary package named
-.B liblockdev1-dbg 
-which installs a shared library built with all
-debugging options (and the -DDEBUG flag) into /usr/lib/debug .
-
 .SH FILES
 /var/lock/LCK..<device>
 .br
 /var/lock/LK.<devmajor>.<major>.<minor>
 .br
 /usr/lib/liblockdev.so.1
-.br
-/usr/lib/debug/liblockdev.so.1
 
 .SH HISTORY
 (c) 1997 by Fabrizio Polacco <fab at prosa.it>.
-- 
1.6.4.2




More information about the lockdev-devel mailing list