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

@@ -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 ,