1/*
2 * <krb5/locate_plugin.h>
3 *
4 * Copyright 2006 Massachusetts Institute of Technology.
5 * All Rights Reserved.
6 *
7 * Export of this software from the United States of America may
8 *   require a specific license from the United States Government.
9 *   It is the responsibility of any person or organization contemplating
10 *   export to obtain such a license before exporting.
11 *
12 * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
13 * distribute this software and its documentation for any purpose and
14 * without fee is hereby granted, provided that the above copyright
15 * notice appear in all copies and that both that copyright notice and
16 * this permission notice appear in supporting documentation, and that
17 * the name of M.I.T. not be used in advertising or publicity pertaining
18 * to distribution of the software without specific, written prior
19 * permission.	Furthermore if you modify this software you must label
20 * your software as modified software and not distribute it in such a
21 * fashion that it might be confused with the original M.I.T. software.
22 * M.I.T. makes no representations about the suitability of
23 * this software for any purpose.  It is provided "as is" without express
24 * or implied warranty.
25 *
26 *
27 * Service location plugin definitions for Kerberos 5.
28 */
29
30#ifndef KRB5_LOCATE_PLUGIN_H_INCLUDED
31#define KRB5_LOCATE_PLUGIN_H_INCLUDED
32#include <krb5/krb5.h>
33
34enum locate_service_type {
35    locate_service_kdc = 1,
36    locate_service_master_kdc,
37    locate_service_kadmin,
38    locate_service_krb524,
39    locate_service_kpasswd
40};
41
42typedef struct krb5plugin_service_locate_ftable {
43    int minor_version;		/* currently 0 */
44    /* Per-context setup and teardown.  Returned void* blob is
45       private to the plugin.  */
46    krb5_error_code (*init)(krb5_context, void **);
47    void (*fini)(void *);
48    /* Callback function returns non-zero if the plugin function
49       should quit and return; this may be because of an error, or may
50       indicate we've already contacted the service, whatever.  The
51       lookup function should only return an error if it detects a
52       problem, not if the callback function tells it to quit.  */
53    krb5_error_code (*lookup)(void *,
54			      enum locate_service_type svc, const char *realm,
55			      int socktype, int family,
56			      int (*cbfunc)(void *,int,struct sockaddr *),
57			      void *cbdata);
58} krb5plugin_service_locate_ftable;
59/* extern krb5plugin_service_locate_ftable service_locator; */
60#endif
61