From 9bcda56048fc7aa5c5c5ea2ea2949f6135e9e810 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Mon, 14 Apr 2003 08:38:24 +0000
Subject: [PATCH] document kafs_set_verbose

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@11998 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/kafs/kafs.3 | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/lib/kafs/kafs.3 b/lib/kafs/kafs.3
index 3348095e7..8611ef06d 100644
--- a/lib/kafs/kafs.3
+++ b/lib/kafs/kafs.3
@@ -40,6 +40,7 @@
 .Nm k_unlog ,
 .Nm k_setpag ,
 .Nm k_afs_cell_of_file ,
+.Nm kafs_set_verbose ,
 .Nm kafs_settoken_rxkad ,
 .Nm kafs_settoken ,
 .Nm krb_afslog ,
@@ -62,6 +63,8 @@ AFS cache manager access library (libkafs, -lkafs)
 .Fn k_setpag "void"
 .Ft int
 .Fn k_unlog "void"
+.Ft void
+.Fn kafs_set_verbose "void (*func)(void *, const char *, int)" "void *"
 .Ft int
 .Fn kafs_settoken_rxkad "const char *cell" "struct ClearToken *token" "void *ticket" "size_t ticket_len"
 .Ft int
@@ -83,6 +86,16 @@ called before
 .Fn k_hasafs
 is called, or if it fails.
 .Pp
+.Fn kafs_set_verbose
+set a log function that will be called each time the kafs library does
+something important so that the application using libkafs can output
+verbose logging.
+Calling the function
+.Fa kafs_set_verbose
+with the function argument set to
+.Dv NULL
+will stop libkafs from calling the logging function (if set).
+.Pp
 .Fn kafs_settoken_rxkad
 set
 .Li rxkad