From 75ea770af6049db69e0619a0e259a275098fc50f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Tue, 23 Jan 2007 20:35:12 +0000
Subject: [PATCH] Document krb5_data_cmp.

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@20040 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_data.3 | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/lib/krb5/krb5_data.3 b/lib/krb5/krb5_data.3
index 9c55840bb..3da1b29a9 100644
--- a/lib/krb5/krb5_data.3
+++ b/lib/krb5/krb5_data.3
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2003 Kungliga Tekniska Högskolan
+.\" Copyright (c) 2003 - 2005, 2007 Kungliga Tekniska Högskolan
 .\" (Royal Institute of Technology, Stockholm, Sweden).
 .\" All rights reserved.
 .\"
@@ -31,7 +31,7 @@
 .\"
 .\" $Id$
 .\"
-.Dd April 24, 2005
+.Dd Jan 23, 2007
 .Dt KRB5_DATA 3
 .Os HEIMDAL
 .Sh NAME
@@ -43,7 +43,8 @@
 .Nm krb5_data_alloc ,
 .Nm krb5_data_realloc ,
 .Nm krb5_data_copy ,
-.Nm krb5_copy_data
+.Nm krb5_copy_data ,
+.Nm krb5_data_cmp
 .Nd operates on the Kerberos datatype krb5_data
 .Sh LIBRARY
 Kerberos 5 Library (libkrb5, -lkrb5)
@@ -67,6 +68,8 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Fn krb5_data_copy "krb5_data *p" "const void *data" "size_t len"
 .Ft krb5_error_code
 .Fn krb5_copy_data "krb5_context context" "const krb5_data *indata" "krb5_data **outdata"
+.Ft krb5_error_code
+.Fn krb5_data_cmp "const krb5_data *data1" "const krb5_data *data2"
 .Sh DESCRIPTION
 The
 .Li krb5_data
@@ -145,6 +148,11 @@ doesn't contain anything needs to be freed.
 should be freed using
 .Fn krb5_free_data .
 Returns 0 or an error.
+.Pp
+.Fn krb5_data_cmp
+will compare two data object and check if they are the same in a
+simular way as memcmp does it.  The return value can be used for
+sorting.
 .Sh SEE ALSO
 .Xr krb5 3 ,
 .Xr krb5_storage 3 ,