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