3 * $Id: keycheck.c,v 1.3 2004/04/08 01:36:15 mdw Exp $
5 * Framework for checking consistency of keys
7 * (c) 2001 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of Catacomb.
14 * Catacomb is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * Catacomb is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with Catacomb; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Header files ------------------------------------------------------*/
34 #include <mLib/dstr.h>
38 /*----- Main code ---------------------------------------------------------*/
40 /* --- @keycheck_report@ --- *
42 * Arguments: @keycheck *kc@ = keycheck state
43 * @unsigned sev@ = severity of this report
44 * @const char *msg@ = message to send along
45 * @...@ = things to fill the message in with
47 * Returns: Zero to continue, or nonzero to stop and give up.
49 * Use: Reports a message to the user function.
52 int keycheck_report(keycheck
*kc
, unsigned sev
, const char *msg
, ...)
60 dstr_vputf(&d
, msg
, &ap
);
62 rc
= kc
->func ? kc
->func(sev
, d
.buf
, kc
->p
) : 0;
67 /* --- @keycheck_init@ --- *
69 * Arguments: @keycheck *kc@ = pointer to block to initialize
70 * @int (*func)(unsigned sev, const char *msg, void *p)@ =
71 * handler function for problems
72 * @void *p@ = pointer to give to handler
76 * Use: Initializes a key checking context.
79 void keycheck_init(keycheck
*kc
,
80 int (*func
)(unsigned /*sev*/,
88 for (i
= 0; i
< KCSEV_MAX
; i
++)
92 /* --- @keycheck_allclear@ --- *
94 * Arguments: @keycheck *kc@ = pointer to keycheck context
95 * @unsigned sev@ = minimum severity to care about
97 * Returns: Nonzero if no problems of @sev@ or above were noticed.
100 int keycheck_allclear(keycheck
*kc
, unsigned sev
)
102 while (sev
< KCSEV_MAX
) {
110 /*----- That's all, folks -------------------------------------------------*/