X-Git-Url: http://git.silcnet.org/gitweb/?p=website.git;a=blobdiff_plain;f=docs%2Ftoolkit%2Fmanual%2Fsilcasn1-silc_asn1_encode.html;fp=docs%2Ftoolkit%2Fmanual%2Fsilcasn1-silc_asn1_encode.html;h=f42f0d69ce5b1a0c3cc73a024c4c35f3acb86e2c;hp=0000000000000000000000000000000000000000;hb=80b80cef93d9dff6acc4bc8e3a522c55fcdc3fca;hpb=43e53f529ca5c7d2ddb7cee8e76e273631e6f1e2 diff --git a/docs/toolkit/manual/silcasn1-silc_asn1_encode.html b/docs/toolkit/manual/silcasn1-silc_asn1_encode.html new file mode 100644 index 0000000..f42f0d6 --- /dev/null +++ b/docs/toolkit/manual/silcasn1-silc_asn1_encode.html @@ -0,0 +1,292 @@ + + + + + + + + + + + + + + + + + + + +
Copyright © 2001 - 2007 SILC Project
+ SILC Project Website
+ SILC Toolkit Reference Manual
+ Index
+ + +
+ + + + + + + + + + + + + + +
+ + + +
+
+ + + +SILC Toolkit Reference Manual
+ + +SILC Crypto Library
+    Introduction to SILC RNG
+    SILC RNG Interface
+    SILC Cipher API
+    SILC PKCS API
+    SILC Public Key API
+    SILC PKCS #1 API
+    SILC Hash Interface
+    SILC HMAC Interface
+SILC Core Library
+    SILC Authentication Interface
+    SILC Message Interface
+    SILC Channel Interface
+    SILC Command Interface
+    SILC Notify Interface
+    SILC Status Types
+    SILC Modes
+    SILC ID Interface
+    SILC Argument Interface
+    SILC Attributes Interface
+    Packet Engine Interface
+    SILC Public Key Payload Interface
+SILC Key Exchange Library
+    SILC SKE Interface
+    SILC Connection Authentication Interface
+SILC VCard Library
+    SILC VCard Interface
+SILC Math Library
+    SILC MP Interface
+    SILC Math Interface
+SILC Client Library
+    Using SILC Client Library Tutorial
+    Arguments for command_reply Client Operation
+    SilcStatus Error Arguments in command_reply Client Operation
+    Arguments for notify Client Operation
+    Unicode and UTF-8 Strings in Client Library
+    Client Library Interface Reference
+    Client Entry Interface Reference
+SILC ASN.1 Library
+    SILC ASN.1 Interface
+    SILC BER interface
+SILC HTTP Library
+    SILC HTTP Server Interface
+    SILC HTTP PHP Translator
+SILC Utility Library
+    Basic Types and Definitions
+    Data Buffer Interface
+    Data Buffer Format Interface
+    Hash Table Interface
+    Memory Allocation Interface
+    Data Stack (memory pool) Interface
+    Finite State Machine Interface
+    Thread Interface
+    Mutual Exclusion Lock Interface
+    Condition Variable Interface
+    Atomic Operations Interface
+    Network (TCP and UDP) Interface
+    Scheduler Interface
+    Asynchronous Operation Interface
+    Abstract Stream Interface
+    Socket Stream Interface
+    File Descriptor Stream Interface
+    File Utility Functions
+    String Utility Interface
+    Snprintf Interface
+    UTF-8 String Interface
+    Stringprep Interface
+    Utility Functions
+    List Interface
+    Dynamic List Interface
+    MIME Interface
+    Time Utility Functions
+    Logging Interface
+    Config File Interface
+SILC Key Repository Library
+    SILC SKR Interface
+SILC Application Utility Library
+    SILC Application Utilities
+    SILC ID Cache Interface
+SILC SFTP Library
+    SILC SFTP Interface
+    SFTP Filesystems Interface
+ +
+Resource Links +
+SILC Project Website
+SILC Protocol Documentation
+SILC White Paper
+SILC FAQs
+ +
+



+
+
+ + + + +
+
+ +Function silc_asn1_encode

+ + +SYNOPSIS + +

+    SilcBool silc_asn1_encode(SilcAsn1 asn1, SilcBuffer dest, ...);
+
+
+DESCRIPTION + +

+    Encodes ASN.1 encoded buffer into `dest', from variable argument
+    list of ASN.1 types.  The variable argument list forms the ASN.1
+    trees and nodes that are encoded into the `dest'.  By default, the
+    memory for `dest' is allocated from the `asn1', and the buffer becomes
+    invalid either by calling silc_asn1_free, silc_asn1_uninit, or when
+    silc_asn1_encode is called for the next time.
+
+    If the SILC_ASN1_OPTS macro with SILC_ASN1_ALLOC option is given then
+    the `dest' is dynamically allocated and caller must free it by itself.
+    Alternatively if SILC_ASN1_ACCUMUL is given then memory is accumulated
+    from `asn1' for `dest' and it is freed only when silc_asn1_free or
+    silc_asn1_uninit is called.  Next call to silc_asn1_encode will not
+    cancel the previous result, but will accumulate more memory for new
+    result.
+
+    The variable argument list is constructed by using various
+    macros, for example SILC_ASN1_SEQUENCE, etc.  The variable argument
+    list must always be ended with SILC_ASN1_END type.
+
+    If encoding is successful this returns TRUE, FALSE on error.
+
+
+EXAMPLE + +

+    silc_asn1_encode(asn1, buf,
+                     SILC_ASN1_SEQUENCE,
+                       SILC_ASN1_BOOLEAN(bool_val),
+                       SILC_ASN1_OCTET_STRING(string, string_len),
+                       SILC_ASN1_SEQUENCE_T(0, 2),
+                         SILC_ASN1_BOOLEAN_T(SILC_ASN1_EXPLICIT, 100, foo),
+                       SILC_ASN1_END,
+                       SILC_ASN1_OCTET_STRING_T(0, 1, string2, string2_len),
+                     SILC_ASN1_END, SILC_ASN1_END);
+
+    Creates ASN.1 tree that looks something like:
+
+    buf ::= SEQUENCE {
+      bool_val      BOOLEAN,
+      string        OCTET-STRING,
+               [2]  SEQUENCE {
+                      foo   [100] EXPLICIT BOOLEAN }
+      string2  [1]  OCTET-STRING }
+
+
+



+
+
+ + + + +
+
+ +ASN.1 Interface
+SilcAsn1
+SilcAsn1Struct
+SilcAsn1Options
+SilcAsn1Tag
+silc_asn1_alloc
+silc_asn1_free
+silc_asn1_init
+silc_asn1_uninit
+silc_asn1_encode
+silc_asn1_decode
+SILC_ASN1_OPTS
+SILC_ASN1_ANY
+SILC_ASN1_ANY_PRIMITIVE
+SILC_ASN1_SEQUENCE
+SILC_ASN1_SET
+SILC_ASN1_SEQUENCE_OF
+SILC_ASN1_SET_OF
+SILC_ASN1_CHOICE
+SILC_ASN1_BOOLEAN
+SILC_ASN1_INT
+SILC_ASN1_SHORT_INT
+SILC_ASN1_ENUM
+SILC_ASN1_BIT_STRING
+SILC_ASN1_NULL
+SILC_ASN1_OID
+SILC_ASN1_OCTET_STRING
+SILC_ASN1_UTF8_STRING
+SILC_ASN1_NUMERIC_STRING
+SILC_ASN1_PRINTABLE_STRING
+SILC_ASN1_TELETEX_STRING
+SILC_ASN1_IA5_STRING
+SILC_ASN1_VISIBLE_STRING
+SILC_ASN1_UNIVERSAL_STRING
+SILC_ASN1_BMP_STRING
+SILC_ASN1_UNRESTRICTED_STRING
+SILC_ASN1_GENERAL_STRING
+SILC_ASN1_UTC_TIME
+SILC_ASN1_GEN_TIME
+SILC_ASN1_END
+
+ +



+
+
+ + + +
+ + + + + + +
Copyright © 2001 - 2007 SILC Project
+ SILC Project Website
+ SILC Toolkit Reference Manual
+ Index
+ + +