From 3242b66fbf8274991d3fbb0d02ca85e1e2ca60b6 Mon Sep 17 00:00:00 2001
From: Russ Allbery <rra@stanford.edu>
Date: Tue, 25 Sep 2007 20:53:53 +0000
Subject: Add a note about error codes and debugging.

---
 kasetkey/kasetkey.pod | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/kasetkey/kasetkey.pod b/kasetkey/kasetkey.pod
index eda9b8c..dcaa8b4 100644
--- a/kasetkey/kasetkey.pod
+++ b/kasetkey/kasetkey.pod
@@ -124,6 +124,14 @@ rcmd.slapshot with:
 
     kasetkey -k /.adminkey -a admin -r -f srvtab -s rcmd.slapshot
 
+=head1 CAVEATS
+
+The error reporting of this program is not great.  If an action fails, run
+it again with the B<-d> flag, which will print out the return status of
+every AFS operation.  You can then pass the failing error code to the
+B<translate_et> program, installed with AFS, to translate the code into an
+error message.
+
 =head1 SEE ALSO
 
 kas(8), kaserver(8), ktutil(8)
-- 
cgit v1.2.3