xref: /minix3/crypto/external/bsd/heimdal/dist/lib/krb5/krb5_mk_safe.3 (revision ebfedea0ce5bbe81e252ddf32d732e40fb633fae)
1*ebfedea0SLionel Sambuc.\"	$NetBSD: krb5_mk_safe.3,v 1.1.1.2 2011/04/14 14:09:23 elric Exp $
2*ebfedea0SLionel Sambuc.\"
3*ebfedea0SLionel Sambuc.\" Copyright (c) 2003 Kungliga Tekniska Högskolan
4*ebfedea0SLionel Sambuc.\" (Royal Institute of Technology, Stockholm, Sweden).
5*ebfedea0SLionel Sambuc.\" All rights reserved.
6*ebfedea0SLionel Sambuc.\"
7*ebfedea0SLionel Sambuc.\" Redistribution and use in source and binary forms, with or without
8*ebfedea0SLionel Sambuc.\" modification, are permitted provided that the following conditions
9*ebfedea0SLionel Sambuc.\" are met:
10*ebfedea0SLionel Sambuc.\"
11*ebfedea0SLionel Sambuc.\" 1. Redistributions of source code must retain the above copyright
12*ebfedea0SLionel Sambuc.\"    notice, this list of conditions and the following disclaimer.
13*ebfedea0SLionel Sambuc.\"
14*ebfedea0SLionel Sambuc.\" 2. Redistributions in binary form must reproduce the above copyright
15*ebfedea0SLionel Sambuc.\"    notice, this list of conditions and the following disclaimer in the
16*ebfedea0SLionel Sambuc.\"    documentation and/or other materials provided with the distribution.
17*ebfedea0SLionel Sambuc.\"
18*ebfedea0SLionel Sambuc.\" 3. Neither the name of the Institute nor the names of its contributors
19*ebfedea0SLionel Sambuc.\"    may be used to endorse or promote products derived from this software
20*ebfedea0SLionel Sambuc.\"    without specific prior written permission.
21*ebfedea0SLionel Sambuc.\"
22*ebfedea0SLionel Sambuc.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
23*ebfedea0SLionel Sambuc.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24*ebfedea0SLionel Sambuc.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25*ebfedea0SLionel Sambuc.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
26*ebfedea0SLionel Sambuc.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27*ebfedea0SLionel Sambuc.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28*ebfedea0SLionel Sambuc.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29*ebfedea0SLionel Sambuc.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30*ebfedea0SLionel Sambuc.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31*ebfedea0SLionel Sambuc.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32*ebfedea0SLionel Sambuc.\" SUCH DAMAGE.
33*ebfedea0SLionel Sambuc.\"
34*ebfedea0SLionel Sambuc.\" Id
35*ebfedea0SLionel Sambuc.\"
36*ebfedea0SLionel Sambuc.Dd May  1, 2006
37*ebfedea0SLionel Sambuc.Dt KRB5_MK_SAFE 3
38*ebfedea0SLionel Sambuc.Os
39*ebfedea0SLionel Sambuc.Sh NAME
40*ebfedea0SLionel Sambuc.Nm krb5_mk_safe ,
41*ebfedea0SLionel Sambuc.Nm krb5_mk_priv
42*ebfedea0SLionel Sambuc.Nd generates integrity protected and/or encrypted messages
43*ebfedea0SLionel Sambuc.Sh LIBRARY
44*ebfedea0SLionel SambucKerberos 5 Library (libkrb5, -lkrb5)
45*ebfedea0SLionel Sambuc.Sh SYNOPSIS
46*ebfedea0SLionel Sambuc.In krb5/krb5.h
47*ebfedea0SLionel Sambuc.Pp
48*ebfedea0SLionel Sambuc.Ft krb5_error_code
49*ebfedea0SLionel Sambuc.Fn krb5_mk_priv "krb5_context context" "krb5_auth_context auth_context" "const krb5_data *userdata" "krb5_data *outbuf" "krb5_replay_data *outdata"
50*ebfedea0SLionel Sambuc.Ft krb5_error_code
51*ebfedea0SLionel Sambuc.Fn krb5_mk_safe "krb5_context context" "krb5_auth_context auth_context" "const krb5_data *userdata" "krb5_data *outbuf" "krb5_replay_data *outdata"
52*ebfedea0SLionel Sambuc.Sh DESCRIPTION
53*ebfedea0SLionel Sambuc.Fn krb5_mk_safe
54*ebfedea0SLionel Sambucand
55*ebfedea0SLionel Sambuc.Fn krb5_mk_priv
56*ebfedea0SLionel Sambucformats
57*ebfedea0SLionel Sambuc.Li KRB-SAFE
58*ebfedea0SLionel Sambuc(integrity protected)
59*ebfedea0SLionel Sambucand
60*ebfedea0SLionel Sambuc.Li KRB-PRIV
61*ebfedea0SLionel Sambuc(also encrypted)
62*ebfedea0SLionel Sambucmessages into
63*ebfedea0SLionel Sambuc.Fa outbuf .
64*ebfedea0SLionel SambucThe actual message data is taken from
65*ebfedea0SLionel Sambuc.Fa userdata .
66*ebfedea0SLionel SambucIf the
67*ebfedea0SLionel Sambuc.Dv KRB5_AUTH_CONTEXT_DO_SEQUENCE
68*ebfedea0SLionel Sambucor
69*ebfedea0SLionel Sambuc.Dv KRB5_AUTH_CONTEXT_DO_TIME
70*ebfedea0SLionel Sambucflags are set in the
71*ebfedea0SLionel Sambuc.Fa auth_context ,
72*ebfedea0SLionel Sambucsequence numbers and time stamps are generated.
73*ebfedea0SLionel SambucIf the
74*ebfedea0SLionel Sambuc.Dv KRB5_AUTH_CONTEXT_RET_SEQUENCE
75*ebfedea0SLionel Sambucor
76*ebfedea0SLionel Sambuc.Dv KRB5_AUTH_CONTEXT_RET_TIME
77*ebfedea0SLionel Sambucflags are set
78*ebfedea0SLionel Sambucthey are also returned in the
79*ebfedea0SLionel Sambuc.Fa outdata
80*ebfedea0SLionel Sambucparameter.
81*ebfedea0SLionel Sambuc.Sh SEE ALSO
82*ebfedea0SLionel Sambuc.Xr krb5_auth_con_init 3 ,
83*ebfedea0SLionel Sambuc.Xr krb5_rd_priv 3 ,
84*ebfedea0SLionel Sambuc.Xr krb5_rd_safe 3
85