From 300bd9caec89738bd67e086c110493fbf3c056e8 Mon Sep 17 00:00:00 2001 From: Pekka Riikonen Date: Sat, 18 Oct 2003 20:31:06 +0000 Subject: [PATCH] More comments. --- lib/silcclient/silcclient.h | 10 ++++++++++ lib/silccore/silcattrs.h | 15 ++++++++++++++- 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/lib/silcclient/silcclient.h b/lib/silcclient/silcclient.h index e73e7945..49b23729 100644 --- a/lib/silcclient/silcclient.h +++ b/lib/silcclient/silcclient.h @@ -2617,6 +2617,16 @@ const SilcHashTable silc_client_attributes_get(SilcClient client, * You can give the returned buffer as argument to for example * silc_client_get_client_by_id_resolve function. * + * EXAMPLE + * + * Request all attributes + * buffer = silc_client_attributes_request(0); + * + * Request only the following attributes + * buffer = silc_client_attributes_request(SILC_ATTRIBUTE_USER_INFO, + * SILC_ATTRIBUTE_SERVICE, + * SILC_ATTRIBUTE_MOOD, 0); + * ***/ SilcBuffer silc_client_attributes_request(SilcAttribute attribute, ...); diff --git a/lib/silccore/silcattrs.h b/lib/silccore/silcattrs.h index d8e724ae..2c578dbf 100644 --- a/lib/silccore/silcattrs.h +++ b/lib/silccore/silcattrs.h @@ -469,7 +469,20 @@ typedef struct SilcAttributeObjDeviceStruct { * DESCRIPTION * * Data type for public key, certificate or digital signatures. The - * caller must free the data inside the structure. + * caller must free the data inside the structure. The 'type' is one + * of following: "silc-rsa", "silc-dss, "ssh-rsa", "ssh-dss", + * "pgp-sign-rsa", "pgp-sign-dss", "x509v3-sign-rsa", "x509v3-sign-dss". + * See the draft-riikonen-precense-attrs draft for more detailed + * information. The 'type' is NULL when this structure includes a + * digital signature. + * + * In SILC, at least the "silc-rsa" must be supported. In this case + * the key is normal SILC Public key. To verify a signature with the + * SILC Public key, construct the signature data with the + * silc_attribute_get_verify_data and verify the signature with + * for example silc_pkcs_verify_with_hash function. The public key + * to the verification is the `data' and `data_len', and can be decoded + * with silc_pkcs_public_key_decode function. * * SOURCE */ -- 2.43.0