git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@17385 ec53bebd-3082-4978-b11e-865c3cabbd6b
		
			
				
	
	
		
			82 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			82 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.\" Copyright (c) 2003 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.
 | 
						|
.\"
 | 
						|
.\" $Id$
 | 
						|
.\"
 | 
						|
.Dd May  1, 2006
 | 
						|
.Dt KRB5_RD_SAFE 3
 | 
						|
.Os HEIMDAL
 | 
						|
.Sh NAME
 | 
						|
.Nm krb5_rd_safe ,
 | 
						|
.Nm krb5_rd_priv
 | 
						|
.Nd verifies authenticity of messages
 | 
						|
.Sh LIBRARY
 | 
						|
Kerberos 5 Library (libkrb5, -lkrb5)
 | 
						|
.Sh SYNOPSIS
 | 
						|
.In krb5.h
 | 
						|
.Pp
 | 
						|
.Ft krb5_error_code
 | 
						|
.Fn krb5_rd_priv "krb5_context context" "krb5_auth_context auth_context" "const krb5_data *inbuf" "krb5_data *outbuf" "krb5_replay_data *outdata"
 | 
						|
.Ft krb5_error_code
 | 
						|
.Fn krb5_rd_safe "krb5_context context" "krb5_auth_context auth_context" "const krb5_data *inbuf" "krb5_data *outbuf" "krb5_replay_data *outdata"
 | 
						|
.Sh DESCRIPTION
 | 
						|
.Fn krb5_rd_safe
 | 
						|
and
 | 
						|
.Fn krb5_rd_priv
 | 
						|
parses
 | 
						|
.Li KRB-SAFE
 | 
						|
and
 | 
						|
.Li KRB-PRIV
 | 
						|
messages (as generated by
 | 
						|
.Xr krb5_mk_safe 3
 | 
						|
and
 | 
						|
.Xr krb5_mk_priv 3 )
 | 
						|
from
 | 
						|
.Fa inbuf
 | 
						|
and verifies its integrity. The user data part of the message in put
 | 
						|
in
 | 
						|
.Fa outbuf .
 | 
						|
The encryption state, including keyblocks and addresses, is taken from
 | 
						|
.Fa auth_context .
 | 
						|
If the
 | 
						|
.Dv KRB5_AUTH_CONTEXT_RET_SEQUENCE
 | 
						|
or
 | 
						|
.Dv KRB5_AUTH_CONTEXT_RET_TIME
 | 
						|
flags are set in the
 | 
						|
.Fa auth_context
 | 
						|
the sequence number and time are returned in the
 | 
						|
.Fa outdata
 | 
						|
parameter.
 | 
						|
.Sh SEE ALSO
 | 
						|
.Xr krb5_auth_con_init 3 ,
 | 
						|
.Xr krb5_mk_priv 3 ,
 | 
						|
.Xr krb5_mk_safe 3
 |