~ubuntu-branches/ubuntu/raring/gnutls26/raring

« back to all changes in this revision

Viewing changes to doc/reference/tmpl/libtasn1.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek
  • Date: 2011-05-20 13:07:18 UTC
  • mfrom: (12.1.11 sid)
  • Revision ID: james.westby@ubuntu.com-20110520130718-db41dybbanzfvlji
Tags: 2.10.5-1ubuntu1
* Merge from Debian unstable, remaining changes:
  - Fix build failure with --no-add-needed.
  - Build for multiarch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!-- ##### SECTION Title ##### -->
2
 
libtasn1
3
 
 
4
 
<!-- ##### SECTION Short_Description ##### -->
5
 
 
6
 
 
7
 
<!-- ##### SECTION Long_Description ##### -->
8
 
<para>
9
 
 
10
 
</para>
11
 
 
12
 
 
13
 
<!-- ##### SECTION See_Also ##### -->
14
 
<para>
15
 
 
16
 
</para>
17
 
 
18
 
 
19
 
<!-- ##### SECTION Stability_Level ##### -->
20
 
 
21
 
 
22
 
<!-- ##### SECTION Image ##### -->
23
 
 
24
 
 
25
 
<!-- ##### MACRO ASN1_API ##### -->
26
 
<para>
27
 
 
28
 
</para>
29
 
 
30
 
 
31
 
 
32
 
<!-- ##### MACRO ASN1_VERSION ##### -->
33
 
<para>
34
 
 
35
 
</para>
36
 
 
37
 
 
38
 
 
39
 
<!-- ##### TYPEDEF asn1_retCode ##### -->
40
 
<para>
41
 
 
42
 
</para>
43
 
 
44
 
 
45
 
<!-- ##### MACRO ASN1_SUCCESS ##### -->
46
 
<para>
47
 
 
48
 
</para>
49
 
 
50
 
 
51
 
 
52
 
<!-- ##### MACRO ASN1_FILE_NOT_FOUND ##### -->
53
 
<para>
54
 
 
55
 
</para>
56
 
 
57
 
 
58
 
 
59
 
<!-- ##### MACRO ASN1_ELEMENT_NOT_FOUND ##### -->
60
 
<para>
61
 
 
62
 
</para>
63
 
 
64
 
 
65
 
 
66
 
<!-- ##### MACRO ASN1_IDENTIFIER_NOT_FOUND ##### -->
67
 
<para>
68
 
 
69
 
</para>
70
 
 
71
 
 
72
 
 
73
 
<!-- ##### MACRO ASN1_DER_ERROR ##### -->
74
 
<para>
75
 
 
76
 
</para>
77
 
 
78
 
 
79
 
 
80
 
<!-- ##### MACRO ASN1_VALUE_NOT_FOUND ##### -->
81
 
<para>
82
 
 
83
 
</para>
84
 
 
85
 
 
86
 
 
87
 
<!-- ##### MACRO ASN1_GENERIC_ERROR ##### -->
88
 
<para>
89
 
 
90
 
</para>
91
 
 
92
 
 
93
 
 
94
 
<!-- ##### MACRO ASN1_VALUE_NOT_VALID ##### -->
95
 
<para>
96
 
 
97
 
</para>
98
 
 
99
 
 
100
 
 
101
 
<!-- ##### MACRO ASN1_TAG_ERROR ##### -->
102
 
<para>
103
 
 
104
 
</para>
105
 
 
106
 
 
107
 
 
108
 
<!-- ##### MACRO ASN1_TAG_IMPLICIT ##### -->
109
 
<para>
110
 
 
111
 
</para>
112
 
 
113
 
 
114
 
 
115
 
<!-- ##### MACRO ASN1_ERROR_TYPE_ANY ##### -->
116
 
<para>
117
 
 
118
 
</para>
119
 
 
120
 
 
121
 
 
122
 
<!-- ##### MACRO ASN1_SYNTAX_ERROR ##### -->
123
 
<para>
124
 
 
125
 
</para>
126
 
 
127
 
 
128
 
 
129
 
<!-- ##### MACRO ASN1_MEM_ERROR ##### -->
130
 
<para>
131
 
 
132
 
</para>
133
 
 
134
 
 
135
 
 
136
 
<!-- ##### MACRO ASN1_MEM_ALLOC_ERROR ##### -->
137
 
<para>
138
 
 
139
 
</para>
140
 
 
141
 
 
142
 
 
143
 
<!-- ##### MACRO ASN1_DER_OVERFLOW ##### -->
144
 
<para>
145
 
 
146
 
</para>
147
 
 
148
 
 
149
 
 
150
 
<!-- ##### MACRO ASN1_NAME_TOO_LONG ##### -->
151
 
<para>
152
 
 
153
 
</para>
154
 
 
155
 
 
156
 
 
157
 
<!-- ##### MACRO ASN1_ARRAY_ERROR ##### -->
158
 
<para>
159
 
 
160
 
</para>
161
 
 
162
 
 
163
 
 
164
 
<!-- ##### MACRO ASN1_ELEMENT_NOT_EMPTY ##### -->
165
 
<para>
166
 
 
167
 
</para>
168
 
 
169
 
 
170
 
 
171
 
<!-- ##### MACRO ASN1_PRINT_NAME ##### -->
172
 
<para>
173
 
 
174
 
</para>
175
 
 
176
 
 
177
 
 
178
 
<!-- ##### MACRO ASN1_PRINT_NAME_TYPE ##### -->
179
 
<para>
180
 
 
181
 
</para>
182
 
 
183
 
 
184
 
 
185
 
<!-- ##### MACRO ASN1_PRINT_NAME_TYPE_VALUE ##### -->
186
 
<para>
187
 
 
188
 
</para>
189
 
 
190
 
 
191
 
 
192
 
<!-- ##### MACRO ASN1_PRINT_ALL ##### -->
193
 
<para>
194
 
 
195
 
</para>
196
 
 
197
 
 
198
 
 
199
 
<!-- ##### MACRO ASN1_CLASS_UNIVERSAL ##### -->
200
 
<para>
201
 
 
202
 
</para>
203
 
 
204
 
 
205
 
 
206
 
<!-- ##### MACRO ASN1_CLASS_APPLICATION ##### -->
207
 
<para>
208
 
 
209
 
</para>
210
 
 
211
 
 
212
 
 
213
 
<!-- ##### MACRO ASN1_CLASS_CONTEXT_SPECIFIC ##### -->
214
 
<para>
215
 
 
216
 
</para>
217
 
 
218
 
 
219
 
 
220
 
<!-- ##### MACRO ASN1_CLASS_PRIVATE ##### -->
221
 
<para>
222
 
 
223
 
</para>
224
 
 
225
 
 
226
 
 
227
 
<!-- ##### MACRO ASN1_CLASS_STRUCTURED ##### -->
228
 
<para>
229
 
 
230
 
</para>
231
 
 
232
 
 
233
 
 
234
 
<!-- ##### MACRO ASN1_TAG_BOOLEAN ##### -->
235
 
<para>
236
 
 
237
 
</para>
238
 
 
239
 
 
240
 
 
241
 
<!-- ##### MACRO ASN1_TAG_INTEGER ##### -->
242
 
<para>
243
 
 
244
 
</para>
245
 
 
246
 
 
247
 
 
248
 
<!-- ##### MACRO ASN1_TAG_SEQUENCE ##### -->
249
 
<para>
250
 
 
251
 
</para>
252
 
 
253
 
 
254
 
 
255
 
<!-- ##### MACRO ASN1_TAG_SET ##### -->
256
 
<para>
257
 
 
258
 
</para>
259
 
 
260
 
 
261
 
 
262
 
<!-- ##### MACRO ASN1_TAG_OCTET_STRING ##### -->
263
 
<para>
264
 
 
265
 
</para>
266
 
 
267
 
 
268
 
 
269
 
<!-- ##### MACRO ASN1_TAG_BIT_STRING ##### -->
270
 
<para>
271
 
 
272
 
</para>
273
 
 
274
 
 
275
 
 
276
 
<!-- ##### MACRO ASN1_TAG_UTCTime ##### -->
277
 
<para>
278
 
 
279
 
</para>
280
 
 
281
 
 
282
 
 
283
 
<!-- ##### MACRO ASN1_TAG_GENERALIZEDTime ##### -->
284
 
<para>
285
 
 
286
 
</para>
287
 
 
288
 
 
289
 
 
290
 
<!-- ##### MACRO ASN1_TAG_OBJECT_ID ##### -->
291
 
<para>
292
 
 
293
 
</para>
294
 
 
295
 
 
296
 
 
297
 
<!-- ##### MACRO ASN1_TAG_ENUMERATED ##### -->
298
 
<para>
299
 
 
300
 
</para>
301
 
 
302
 
 
303
 
 
304
 
<!-- ##### MACRO ASN1_TAG_NULL ##### -->
305
 
<para>
306
 
 
307
 
</para>
308
 
 
309
 
 
310
 
 
311
 
<!-- ##### MACRO ASN1_TAG_GENERALSTRING ##### -->
312
 
<para>
313
 
 
314
 
</para>
315
 
 
316
 
 
317
 
 
318
 
<!-- ##### TYPEDEF node_asn ##### -->
319
 
<para>
320
 
 
321
 
</para>
322
 
 
323
 
 
324
 
<!-- ##### TYPEDEF ASN1_TYPE ##### -->
325
 
<para>
326
 
 
327
 
</para>
328
 
 
329
 
 
330
 
<!-- ##### MACRO ASN1_TYPE_EMPTY ##### -->
331
 
<para>
332
 
 
333
 
</para>
334
 
 
335
 
 
336
 
 
337
 
<!-- ##### TYPEDEF ASN1_ARRAY_TYPE ##### -->
338
 
<para>
339
 
 
340
 
</para>
341
 
 
342
 
 
343
 
<!-- ##### MACRO ASN1_MAX_NAME_SIZE ##### -->
344
 
<para>
345
 
 
346
 
</para>
347
 
 
348
 
 
349
 
 
350
 
<!-- ##### MACRO ASN1_MAX_ERROR_DESCRIPTION_SIZE ##### -->
351
 
<para>
352
 
 
353
 
</para>
354
 
 
355
 
 
356
 
 
357
 
<!-- ##### FUNCTION asn1_parser2tree ##### -->
358
 
<para>
359
 
 
360
 
</para>
361
 
 
362
 
@file_name: 
363
 
@definitions: 
364
 
@errorDescription: 
365
 
@Returns: 
366
 
 
367
 
 
368
 
<!-- ##### FUNCTION asn1_parser2array ##### -->
369
 
<para>
370
 
 
371
 
</para>
372
 
 
373
 
@inputFileName: 
374
 
@outputFileName: 
375
 
@vectorName: 
376
 
@errorDescription: 
377
 
@Returns: 
378
 
 
379
 
 
380
 
<!-- ##### FUNCTION asn1_array2tree ##### -->
381
 
<para>
382
 
 
383
 
</para>
384
 
 
385
 
@array: 
386
 
@definitions: 
387
 
@errorDescription: 
388
 
@Returns: 
389
 
 
390
 
 
391
 
<!-- ##### FUNCTION asn1_print_structure ##### -->
392
 
<para>
393
 
 
394
 
</para>
395
 
 
396
 
@out: 
397
 
@structure: 
398
 
@name: 
399
 
@mode: 
400
 
 
401
 
 
402
 
<!-- ##### FUNCTION asn1_create_element ##### -->
403
 
<para>
404
 
 
405
 
</para>
406
 
 
407
 
@definitions: 
408
 
@source_name: 
409
 
@element: 
410
 
@Returns: 
411
 
 
412
 
 
413
 
<!-- ##### FUNCTION asn1_delete_structure ##### -->
414
 
<para>
415
 
 
416
 
</para>
417
 
 
418
 
@structure: 
419
 
@Returns: 
420
 
 
421
 
 
422
 
<!-- ##### FUNCTION asn1_delete_element ##### -->
423
 
<para>
424
 
 
425
 
</para>
426
 
 
427
 
@structure: 
428
 
@element_name: 
429
 
@Returns: 
430
 
 
431
 
 
432
 
<!-- ##### FUNCTION asn1_write_value ##### -->
433
 
<para>
434
 
 
435
 
</para>
436
 
 
437
 
@node_root: 
438
 
@name: 
439
 
@ivalue: 
440
 
@len: 
441
 
@Returns: 
442
 
 
443
 
 
444
 
<!-- ##### FUNCTION asn1_read_value ##### -->
445
 
<para>
446
 
 
447
 
</para>
448
 
 
449
 
@root: 
450
 
@name: 
451
 
@ivalue: 
452
 
@len: 
453
 
@Returns: 
454
 
 
455
 
 
456
 
<!-- ##### FUNCTION asn1_number_of_elements ##### -->
457
 
<para>
458
 
 
459
 
</para>
460
 
 
461
 
@element: 
462
 
@name: 
463
 
@num: 
464
 
@Returns: 
465
 
 
466
 
 
467
 
<!-- ##### FUNCTION asn1_der_coding ##### -->
468
 
<para>
469
 
 
470
 
</para>
471
 
 
472
 
@element: 
473
 
@name: 
474
 
@ider: 
475
 
@len: 
476
 
@ErrorDescription: 
477
 
@Returns: 
478
 
 
479
 
 
480
 
<!-- ##### FUNCTION asn1_der_decoding ##### -->
481
 
<para>
482
 
 
483
 
</para>
484
 
 
485
 
@element: 
486
 
@ider: 
487
 
@len: 
488
 
@errorDescription: 
489
 
@Returns: 
490
 
 
491
 
 
492
 
<!-- ##### FUNCTION asn1_der_decoding_element ##### -->
493
 
<para>
494
 
 
495
 
</para>
496
 
 
497
 
@structure: 
498
 
@elementName: 
499
 
@ider: 
500
 
@len: 
501
 
@errorDescription: 
502
 
@Returns: 
503
 
 
504
 
 
505
 
<!-- ##### FUNCTION asn1_der_decoding_startEnd ##### -->
506
 
<para>
507
 
 
508
 
</para>
509
 
 
510
 
@element: 
511
 
@ider: 
512
 
@len: 
513
 
@name_element: 
514
 
@start: 
515
 
@end: 
516
 
@Returns: 
517
 
 
518
 
 
519
 
<!-- ##### FUNCTION asn1_expand_any_defined_by ##### -->
520
 
<para>
521
 
 
522
 
</para>
523
 
 
524
 
@definitions: 
525
 
@element: 
526
 
@Returns: 
527
 
 
528
 
 
529
 
<!-- ##### FUNCTION asn1_expand_octet_string ##### -->
530
 
<para>
531
 
 
532
 
</para>
533
 
 
534
 
@definitions: 
535
 
@element: 
536
 
@octetName: 
537
 
@objectName: 
538
 
@Returns: 
539
 
 
540
 
 
541
 
<!-- ##### FUNCTION asn1_read_tag ##### -->
542
 
<para>
543
 
 
544
 
</para>
545
 
 
546
 
@root: 
547
 
@name: 
548
 
@tagValue: 
549
 
@classValue: 
550
 
@Returns: 
551
 
 
552
 
 
553
 
<!-- ##### FUNCTION asn1_find_structure_from_oid ##### -->
554
 
<para>
555
 
 
556
 
</para>
557
 
 
558
 
@definitions: 
559
 
@oidValue: 
560
 
@Returns: 
561
 
 
562
 
 
563
 
<!-- ##### FUNCTION asn1_check_version ##### -->
564
 
<para>
565
 
 
566
 
</para>
567
 
 
568
 
@req_version: 
569
 
@Returns: 
570
 
 
571
 
 
572
 
<!-- ##### FUNCTION asn1_strerror ##### -->
573
 
<para>
574
 
 
575
 
</para>
576
 
 
577
 
@error: 
578
 
@Returns: 
579
 
 
580
 
 
581
 
<!-- ##### FUNCTION asn1_perror ##### -->
582
 
<para>
583
 
 
584
 
</para>
585
 
 
586
 
@error: 
587
 
 
588
 
 
589
 
<!-- ##### FUNCTION asn1_get_tag_der ##### -->
590
 
<para>
591
 
 
592
 
</para>
593
 
 
594
 
@der: 
595
 
@der_len: 
596
 
@cls: 
597
 
@len: 
598
 
@tag: 
599
 
@Returns: 
600
 
 
601
 
 
602
 
<!-- ##### FUNCTION asn1_octet_der ##### -->
603
 
<para>
604
 
 
605
 
</para>
606
 
 
607
 
@str: 
608
 
@str_len: 
609
 
@der: 
610
 
@der_len: 
611
 
 
612
 
 
613
 
<!-- ##### FUNCTION asn1_get_octet_der ##### -->
614
 
<para>
615
 
 
616
 
</para>
617
 
 
618
 
@der: 
619
 
@der_len: 
620
 
@ret_len: 
621
 
@str: 
622
 
@str_size: 
623
 
@str_len: 
624
 
@Returns: 
625
 
 
626
 
 
627
 
<!-- ##### FUNCTION asn1_bit_der ##### -->
628
 
<para>
629
 
 
630
 
</para>
631
 
 
632
 
@str: 
633
 
@bit_len: 
634
 
@der: 
635
 
@der_len: 
636
 
 
637
 
 
638
 
<!-- ##### FUNCTION asn1_get_bit_der ##### -->
639
 
<para>
640
 
 
641
 
</para>
642
 
 
643
 
@der: 
644
 
@der_len: 
645
 
@ret_len: 
646
 
@str: 
647
 
@str_size: 
648
 
@bit_len: 
649
 
@Returns: 
650
 
 
651
 
 
652
 
<!-- ##### FUNCTION asn1_get_length_der ##### -->
653
 
<para>
654
 
 
655
 
</para>
656
 
 
657
 
@der: 
658
 
@der_len: 
659
 
@len: 
660
 
@Returns: 
661
 
 
662
 
 
663
 
<!-- ##### FUNCTION asn1_get_length_ber ##### -->
664
 
<para>
665
 
 
666
 
</para>
667
 
 
668
 
@ber: 
669
 
@ber_len: 
670
 
@len: 
671
 
@Returns: 
672
 
 
673
 
 
674
 
<!-- ##### FUNCTION asn1_length_der ##### -->
675
 
<para>
676
 
 
677
 
</para>
678
 
 
679
 
@len: 
680
 
@ans: 
681
 
@ans_len: 
682
 
 
683
 
 
684
 
<!-- ##### FUNCTION asn1_find_node ##### -->
685
 
<para>
686
 
 
687
 
</para>
688
 
 
689
 
@pointer: 
690
 
@name: 
691
 
@Returns: 
692
 
 
693
 
 
694
 
<!-- ##### FUNCTION asn1_copy_node ##### -->
695
 
<para>
696
 
 
697
 
</para>
698
 
 
699
 
@dst: 
700
 
@dst_name: 
701
 
@src: 
702
 
@src_name: 
703
 
@Returns: 
704
 
 
705
 
 
706
 
<!-- ##### MACRO LIBTASN1_VERSION ##### -->
707
 
<para>
708
 
 
709
 
</para>
710
 
 
711
 
 
712
 
 
713
 
<!-- ##### MACRO MAX_NAME_SIZE ##### -->
714
 
<para>
715
 
 
716
 
</para>
717
 
 
718
 
 
719
 
 
720
 
<!-- ##### MACRO MAX_ERROR_DESCRIPTION_SIZE ##### -->
721
 
<para>
722
 
 
723
 
</para>
724
 
 
725
 
 
726
 
 
727
 
<!-- ##### FUNCTION libtasn1_strerror ##### -->
728
 
<para>
729
 
 
730
 
</para>
731
 
 
732
 
@error: 
733
 
@Returns: 
734
 
 
735
 
 
736
 
<!-- ##### FUNCTION libtasn1_perror ##### -->
737
 
<para>
738
 
 
739
 
</para>
740
 
 
741
 
@error: 
742
 
 
743