jpayne@69: /* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */
jpayne@69: /*
jpayne@69:  * Copyright 2006 Massachusetts Institute of Technology.
jpayne@69:  * All Rights Reserved.
jpayne@69:  *
jpayne@69:  * Export of this software from the United States of America may
jpayne@69:  *   require a specific license from the United States Government.
jpayne@69:  *   It is the responsibility of any person or organization contemplating
jpayne@69:  *   export to obtain such a license before exporting.
jpayne@69:  *
jpayne@69:  * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
jpayne@69:  * distribute this software and its documentation for any purpose and
jpayne@69:  * without fee is hereby granted, provided that the above copyright
jpayne@69:  * notice appear in all copies and that both that copyright notice and
jpayne@69:  * this permission notice appear in supporting documentation, and that
jpayne@69:  * the name of M.I.T. not be used in advertising or publicity pertaining
jpayne@69:  * to distribution of the software without specific, written prior
jpayne@69:  * permission.  Furthermore if you modify this software you must label
jpayne@69:  * your software as modified software and not distribute it in such a
jpayne@69:  * fashion that it might be confused with the original M.I.T. software.
jpayne@69:  * M.I.T. makes no representations about the suitability of
jpayne@69:  * this software for any purpose.  It is provided "as is" without express
jpayne@69:  * or implied warranty.
jpayne@69:  */
jpayne@69: 
jpayne@69: /*
jpayne@69:  *
jpayne@69:  * Service location plugin definitions for Kerberos 5.
jpayne@69:  */
jpayne@69: 
jpayne@69: #ifndef KRB5_LOCATE_PLUGIN_H_INCLUDED
jpayne@69: #define KRB5_LOCATE_PLUGIN_H_INCLUDED
jpayne@69: #include <krb5/krb5.h>
jpayne@69: 
jpayne@69: enum locate_service_type {
jpayne@69:     locate_service_kdc = 1,
jpayne@69:     locate_service_primary_kdc,
jpayne@69:     locate_service_kadmin,
jpayne@69:     locate_service_krb524,
jpayne@69:     locate_service_kpasswd
jpayne@69: };
jpayne@69: #define locate_service_master_kdc locate_service_primary_kdc
jpayne@69: 
jpayne@69: typedef struct krb5plugin_service_locate_ftable {
jpayne@69:     int minor_version;          /* currently 0 */
jpayne@69:     /* Per-context setup and teardown.  Returned void* blob is
jpayne@69:        private to the plugin.  */
jpayne@69:     krb5_error_code (*init)(krb5_context, void **);
jpayne@69:     void (*fini)(void *);
jpayne@69:     /* Callback function returns non-zero if the plugin function
jpayne@69:        should quit and return; this may be because of an error, or may
jpayne@69:        indicate we've already contacted the service, whatever.  The
jpayne@69:        lookup function should only return an error if it detects a
jpayne@69:        problem, not if the callback function tells it to quit.  */
jpayne@69:     krb5_error_code (*lookup)(void *,
jpayne@69:                               enum locate_service_type svc, const char *realm,
jpayne@69:                               int socktype, int family,
jpayne@69:                               int (*cbfunc)(void *,int,struct sockaddr *),
jpayne@69:                               void *cbdata);
jpayne@69: } krb5plugin_service_locate_ftable;
jpayne@69: /* extern krb5plugin_service_locate_ftable service_locator; */
jpayne@69: #endif