1/*-
2 * Copyright (c) 2005 Doug Rabson
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 *	$FreeBSD: src/lib/libgssapi/gss_display_name.c,v 1.1 2005/12/29 14:40:20 dfr Exp $
27 */
28
29#include "mech_locl.h"
30
31/**
32 * Create a representstion of a name suitable for display
33 *
34 * A name that is useful to print to user, not suitable for
35 * authorization. For authorization use gss_authorize_localname(), or
36 * gss_userok().
37 *
38 * @param minor_status minor status code returned
39 * @param input_name name to be converted into a name
40 * @param output_name_buffer output buffer with name, must be released with gss_release_buffer() on success.
41 * @param output_name_type type OID of then name
42 *
43 * @returns GSS major status code
44 *
45 * @ingroup gssapi
46 */
47
48GSSAPI_LIB_FUNCTION OM_uint32 GSSAPI_LIB_CALL
49gss_display_name(OM_uint32 *minor_status,
50    const gss_name_t input_name,
51    gss_buffer_t output_name_buffer,
52    gss_OID *output_name_type)
53{
54	OM_uint32 major_status;
55	struct _gss_name *name = (struct _gss_name *) input_name;
56	struct _gss_mechanism_name *mn;
57
58	_mg_buffer_zero(output_name_buffer);
59	if (output_name_type)
60	    *output_name_type = GSS_C_NO_OID;
61
62	if (name == NULL) {
63		*minor_status = 0;
64		return (GSS_S_BAD_NAME);
65	}
66
67	/*
68	 * If we know it, copy the buffer used to import the name in
69	 * the first place. Otherwise, ask all the MNs in turn if
70	 * they can display the thing.
71	 */
72	if (name->gn_value.value) {
73		output_name_buffer->value = malloc(name->gn_value.length);
74		if (!output_name_buffer->value) {
75			*minor_status = ENOMEM;
76			return (GSS_S_FAILURE);
77		}
78		output_name_buffer->length = name->gn_value.length;
79		memcpy(output_name_buffer->value, name->gn_value.value,
80		    output_name_buffer->length);
81		if (output_name_type)
82			*output_name_type = &name->gn_type;
83
84		*minor_status = 0;
85		return (GSS_S_COMPLETE);
86	} else {
87		HEIM_SLIST_FOREACH(mn, &name->gn_mn, gmn_link) {
88			major_status = mn->gmn_mech->gm_display_name(
89				minor_status, mn->gmn_name,
90				output_name_buffer,
91				output_name_type);
92			if (major_status == GSS_S_COMPLETE)
93				return (GSS_S_COMPLETE);
94		}
95	}
96
97	*minor_status = 0;
98	return (GSS_S_FAILURE);
99}
100