root/lib/libgssapi/gss_display_status.c
/*-
 * SPDX-License-Identifier: BSD-3-Clause
 *
 * Copyright (c) 2005 Doug Rabson
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */
/*
 * Copyright (c) 1998 - 2005 Kungliga Tekniska Högskolan
 * (Royal Institute of Technology, Stockholm, Sweden).
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * 3. Neither the name of the Institute nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */
/*
 * Copyright (c) 1998 - 2005 Kungliga Tekniska Högskolan
 * (Royal Institute of Technology, Stockholm, Sweden).
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * 3. Neither the name of the Institute nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

#include <sys/param.h>
#include <gssapi/gssapi.h>
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <errno.h>

#include "mech_switch.h"
#include "utils.h"

static const char *
calling_error(OM_uint32 v)
{
    static const char *msgs[] = {
        [0] = "",
        [1] = "A required input parameter could not be read.",
        [2] = "A required output parameter could not be written.",
        [3] = "A parameter was malformed",
    };

    v >>= GSS_C_CALLING_ERROR_OFFSET;

    if (v >= nitems(msgs))
        return "unknown calling error";
    else
        return msgs[v];
}

static const char *
routine_error(OM_uint32 v)
{
    static const char *msgs[] = {
        [0] = "Function completed successfully",
        [1] = "An unsupported mechanism was requested",
        [2] = "An invalid name was supplied",
        [3] = "A supplied name was of an unsupported type",
        [4] = "Incorrect channel bindings were supplied",
        [5] = "An invalid status code was supplied",
        [6] = "A token had an invalid MIC",
        [7] = ("No credentials were supplied, "
            "or the credentials were unavailable or inaccessible."),
        [8] = "No context has been established",
        [9] = "A token was invalid",
        [10] = "A credential was invalid",
        [11] =  "The referenced credentials have expired",
        [12] = "The context has expired",
        [13] = "Miscellaneous failure (see text)",
        [14] = "The quality-of-protection requested could not be provide",
        [15] = "The operation is forbidden by local security policy",
        [16] = "The operation or option is not available",
        [17] = "The requested credential element already exists",
        [18] = "The provided name was not a mechanism name.",
    };

    v >>= GSS_C_ROUTINE_ERROR_OFFSET;

    if (v >= nitems(msgs))
        return "unknown routine error";
    else
        return msgs[v];
}

static const char *
supplementary_error(OM_uint32 v)
{
    static const char *msgs[] = {
        [0] = "normal completion",
        [1] = "continuation call to routine required",
        [2] = "duplicate per-message token detected",
        [3] = "timed-out per-message token detected",
        [4] = "reordered (early) per-message token detected",
        [5] = "skipped predecessor token(s) detected",
    };

    v >>= GSS_C_SUPPLEMENTARY_OFFSET;

    if (v >= nitems(msgs))
        return "unknown routine error";
    else
        return msgs[v];
}

struct mg_thread_ctx {
    gss_OID mech;
    OM_uint32 maj_stat;
    OM_uint32 min_stat;
    gss_buffer_desc maj_error;
    gss_buffer_desc min_error;
};
static __thread struct mg_thread_ctx last_error_context;

static OM_uint32
_gss_mg_get_error(const gss_OID mech, OM_uint32 type,
                  OM_uint32 value, gss_buffer_t string)
{
        struct mg_thread_ctx *mg;

        mg = &last_error_context;

        if (mech != NULL && gss_oid_equal(mg->mech, mech) == 0)
                return (GSS_S_BAD_STATUS);

        switch (type) {
        case GSS_C_GSS_CODE: {
                if (value != mg->maj_stat || mg->maj_error.length == 0)
                        break;
                string->value = malloc(mg->maj_error.length);
                string->length = mg->maj_error.length;
                memcpy(string->value, mg->maj_error.value,
                    mg->maj_error.length);
                return (GSS_S_COMPLETE);
        }
        case GSS_C_MECH_CODE: {
                if (value != mg->min_stat || mg->min_error.length == 0)
                        break;
                string->value = malloc(mg->min_error.length);
                string->length = mg->min_error.length;
                memcpy(string->value, mg->min_error.value,
                    mg->min_error.length);
                return (GSS_S_COMPLETE);
        }
        }
        string->value = NULL;
        string->length = 0;
        return (GSS_S_BAD_STATUS);
}

void
_gss_mg_error(struct _gss_mech_switch *m, OM_uint32 maj, OM_uint32 min)
{
        OM_uint32 major_status, minor_status;
        OM_uint32 message_content;
        struct mg_thread_ctx *mg;

        mg = &last_error_context;

        gss_release_buffer(&minor_status, &mg->maj_error);
        gss_release_buffer(&minor_status, &mg->min_error);

        mg->mech = &m->gm_mech_oid;
        mg->maj_stat = maj;
        mg->min_stat = min;

        major_status = m->gm_display_status(&minor_status,
            maj,
            GSS_C_GSS_CODE,
            &m->gm_mech_oid,
            &message_content,
            &mg->maj_error);
        if (GSS_ERROR(major_status)) {
                mg->maj_error.value = NULL;
                mg->maj_error.length = 0;
        }
        major_status = m->gm_display_status(&minor_status,
            min,
            GSS_C_MECH_CODE,
            &m->gm_mech_oid,
            &message_content,
            &mg->min_error);
        if (GSS_ERROR(major_status)) {
                mg->min_error.value = NULL;
                mg->min_error.length = 0;
        }
}

OM_uint32
gss_display_status(OM_uint32 *minor_status,
    OM_uint32 status_value,
    int status_type,
    const gss_OID mech_type,
    OM_uint32 *message_content,
    gss_buffer_t status_string)
{
        OM_uint32 major_status;

        _gss_buffer_zero(status_string);
        *message_content = 0;

        major_status = _gss_mg_get_error(mech_type, status_type,
                                         status_value, status_string);
        if (major_status == GSS_S_COMPLETE) {

                *message_content = 0;
                *minor_status = 0;
                return (GSS_S_COMPLETE);
        }

        *minor_status = 0;
        switch (status_type) {
        case GSS_C_GSS_CODE: {
                char *buf;

                if (GSS_SUPPLEMENTARY_INFO(status_value))
                    asprintf(&buf, "%s", supplementary_error(
                        GSS_SUPPLEMENTARY_INFO(status_value)));
                else
                    asprintf (&buf, "%s %s",
                        calling_error(GSS_CALLING_ERROR(status_value)),
                        routine_error(GSS_ROUTINE_ERROR(status_value)));

                if (buf == NULL)
                        break;

                status_string->length = strlen(buf);
                status_string->value  = buf;

                return (GSS_S_COMPLETE);
        }
        case GSS_C_MECH_CODE: {
                OM_uint32 maj_junk, min_junk;
                gss_buffer_desc oid;
                char *buf;

                maj_junk = gss_oid_to_str(&min_junk, mech_type, &oid);
                if (maj_junk != GSS_S_COMPLETE) {
                        oid.value = strdup("unknown");
                        oid.length = 7;
                }

                asprintf (&buf, "unknown mech-code %lu for mech %.*s",
                          (unsigned long)status_value,
                          (int)oid.length, (char *)oid.value);
                if (maj_junk == GSS_S_COMPLETE)
                        gss_release_buffer(&min_junk, &oid);

                if (buf == NULL)
                    break;

                status_string->length = strlen(buf);
                status_string->value  = buf;

                return (GSS_S_COMPLETE);
        }
        }
        _gss_buffer_zero(status_string);
        return (GSS_S_BAD_STATUS);
}

void
_gss_mg_collect_error(gss_OID mech, OM_uint32 maj, OM_uint32 min)
{
        struct _gss_mech_switch *m;

        m = _gss_find_mech_switch(mech);
        if (m != NULL)
                _gss_mg_error(m, maj, min);
}