ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/Convert-BER-XS/XS.pm
(Generate patch)

Comparing Convert-BER-XS/XS.pm (file contents):
Revision 1.33 by root, Sat Apr 20 17:23:21 2019 UTC vs.
Revision 1.62 by root, Thu Feb 6 23:15:44 2020 UTC

8 8
9 my $ber = ber_decode $buf, $Convert::BER::XS::SNMP_PROFILE 9 my $ber = ber_decode $buf, $Convert::BER::XS::SNMP_PROFILE
10 or die "unable to decode SNMP message"; 10 or die "unable to decode SNMP message";
11 11
12 # The above results in a data structure consisting of 12 # The above results in a data structure consisting of
13 # (class, tag, flags, data) 13 # (class, tag, flags, data)
14 # tuples. Below is such a message, SNMPv1 trap 14 # tuples. Below is such a message, SNMPv1 trap
15 # with a Cisco mac change notification. 15 # with a Cisco mac change notification.
16 # Did you know that Cisco is in the news almost 16 # Did you know that Cisco is in the news almost
17 # every week because of some backdoor password 17 # every week because of some backdoor password
18 # or other extremely stupid security bug? 18 # or other extremely stupid security bug?
36 [ ASN_UNIVERSAL, ASN_OCTET_STRING, 0, "...data..." # the value 36 [ ASN_UNIVERSAL, ASN_OCTET_STRING, 0, "...data..." # the value
37 ] 37 ]
38 ] 38 ]
39 ], 39 ],
40 ... 40 ...
41 # let's dump it, for debugging
42
43 ber_dump $ber, $Convert::BER::XS::SNMP_PROFILE;
41 44
42 # let's decode it a bit with some helper functions 45 # let's decode it a bit with some helper functions
43 46
44 my $msg = ber_is_seq $ber 47 my $msg = ber_is_seq $ber
45 or die "SNMP message does not start with a sequence"; 48 or die "SNMP message does not start with a sequence";
66 69
67 my $buf = ber_encode $ber, $Convert::BER::XS::SNMP_PROFILE; 70 my $buf = ber_encode $ber, $Convert::BER::XS::SNMP_PROFILE;
68 71
69=head1 DESCRIPTION 72=head1 DESCRIPTION
70 73
71WARNING: Before release 1.0, the API is not considered stable in any way.
72
73This module implements a I<very> low level BER/DER en-/decoder. 74This module implements a I<very> low level BER/DER en-/decoder.
74 75
75It is tuned for low memory and high speed, while still maintaining some 76It is tuned for low memory and high speed, while still maintaining some
76level of user-friendlyness. 77level of user-friendlyness.
77 78
105 BER_CLASS BER_TAG BER_FLAGS BER_DATA 106 BER_CLASS BER_TAG BER_FLAGS BER_DATA
106 107
107=item C<:const_asn> 108=item C<:const_asn>
108 109
109ASN class values (these are C<0>, C<1>, C<2> and C<3>, respectively - 110ASN class values (these are C<0>, C<1>, C<2> and C<3>, respectively -
110exactly thw two topmost bits from the identifier octet shifted 6 bits to 111exactly the two topmost bits from the identifier octet shifted 6 bits to
111the right): 112the right):
112 113
113 ASN_UNIVERSAL ASN_APPLICATION ASN_CONTEXT ASN_PRIVATE 114 ASN_UNIVERSAL ASN_APPLICATION ASN_CONTEXT ASN_PRIVATE
114 115
115ASN tag values (some of which are aliases, such as C<ASN_OID>). Their 116ASN tag values (some of which are aliases, such as C<ASN_OID>). Their
116numerical value corresponds exactly to the numbers used in BER/X.690. 117numerical value corresponds exactly to the numbers used in BER/X.690.
117 118
118 ASN_BOOLEAN ASN_INTEGER ASN_BIT_STRING ASN_OCTET_STRING ASN_NULL ASN_OBJECT_IDENTIFIER 119 ASN_BOOLEAN ASN_INTEGER ASN_BIT_STRING ASN_OCTET_STRING ASN_NULL ASN_OID
119 ASN_OBJECT_DESCRIPTOR ASN_OID ASN_EXTERNAL ASN_REAL ASN_SEQUENCE ASN_ENUMERATED 120 ASN_OBJECT_IDENTIFIER ASN_OBJECT_DESCRIPTOR ASN_EXTERNAL ASN_REAL ASN_SEQUENCE ASN_ENUMERATED
120 ASN_EMBEDDED_PDV ASN_UTF8_STRING ASN_RELATIVE_OID ASN_SET ASN_NUMERIC_STRING 121 ASN_EMBEDDED_PDV ASN_UTF8_STRING ASN_RELATIVE_OID ASN_SET ASN_NUMERIC_STRING
121 ASN_PRINTABLE_STRING ASN_TELETEX_STRING ASN_T61_STRING ASN_VIDEOTEX_STRING ASN_IA5_STRING 122 ASN_PRINTABLE_STRING ASN_TELETEX_STRING ASN_T61_STRING ASN_VIDEOTEX_STRING ASN_IA5_STRING
122 ASN_ASCII_STRING ASN_UTC_TIME ASN_GENERALIZED_TIME ASN_GRAPHIC_STRING ASN_VISIBLE_STRING 123 ASN_ASCII_STRING ASN_UTC_TIME ASN_GENERALIZED_TIME ASN_GRAPHIC_STRING ASN_VISIBLE_STRING
123 ASN_ISO646_STRING ASN_GENERAL_STRING ASN_UNIVERSAL_STRING ASN_CHARACTER_STRING ASN_BMP_STRING 124 ASN_ISO646_STRING ASN_GENERAL_STRING ASN_UNIVERSAL_STRING ASN_CHARACTER_STRING ASN_BMP_STRING
124 125
141 142
142=item C<:decode> 143=item C<:decode>
143 144
144C<ber_decode> and the match helper functions: 145C<ber_decode> and the match helper functions:
145 146
147 ber_decode ber-decode_prefix
146 ber_decode ber_is ber_is_seq ber_is_int ber_is_oid 148 ber_is ber_is_seq ber_is_int ber_is_oid
149 ber_dump
147 150
148=item C<:encode> 151=item C<:encode>
149 152
150C<ber_encode> and the construction helper functions: 153C<ber_encode> and the construction helper functions:
151 154
152 ber_encode ber_int 155 ber_encode
156 ber_int
153 157
154=back 158=back
155 159
156=head2 ASN.1/BER/DER/... BASICS 160=head2 ASN.1/BER/DER/... BASICS
157 161
253 257
254=head2 DECODING AND ENCODING 258=head2 DECODING AND ENCODING
255 259
256=over 260=over
257 261
258=item $tuple = ber_decoded $bindata[, $profile] 262=item $tuple = ber_decode $bindata[, $profile]
259 263
260Decodes binary BER data in C<$bindata> and returns the resulting BER 264Decodes binary BER data in C<$bindata> and returns the resulting BER
261tuple. Croaks on any decoding error, so the returned C<$tuple> is always 265tuple. Croaks on any decoding error, so the returned C<$tuple> is always
262valid. 266valid.
263 267
276 280
277Example: as above, but use the provided SNMP profile. 281Example: as above, but use the provided SNMP profile.
278 282
279 $tuple = ber_encode $data, $Convert::BER::XS::SNMP_PROFILE; 283 $tuple = ber_encode $data, $Convert::BER::XS::SNMP_PROFILE;
280 284
285=item ($tuple, $bytes) = ber_decode_prefix $bindata[, $profile]
286
287Works like C<ber_decode>, except it doesn't croak when there is data after
288the BER data, but instead returns the decoded value and the number of
289bytes it decoded.
290
291This is useful when you have BER data at the start of a buffer and other
292data after, and you need to find the length.
293
294Also, since BER is self-delimited, this can be used to decode multiple BER
295values joined together.
296
281=item $bindata = ber_encode $tuple[, $profile] 297=item $bindata = ber_encode $tuple[, $profile]
282 298
283Encodes the BER tuple into a BER/DER data structure. AS with 299Encodes the BER tuple into a BER/DER data structure. As with
284Cyber_decode>, an optional profile can be given. 300Cyber_decode>, an optional profile can be given.
285 301
286The encoded data should be both BER and DER ("shortest form") compliant 302The encoded data should be both BER and DER ("shortest form") compliant
287unless the input says otherwise (e.g. it uses constructed strings). 303unless the input says otherwise (e.g. it uses constructed strings).
288 304
391use common::sense; 407use common::sense;
392 408
393use XSLoader (); 409use XSLoader ();
394use Exporter qw(import); 410use Exporter qw(import);
395 411
412use Carp ();
413
396our $VERSION; 414our $VERSION;
397 415
398BEGIN { 416BEGIN {
399 $VERSION = 0.9; 417 $VERSION = 1.21;
400 XSLoader::load __PACKAGE__, $VERSION; 418 XSLoader::load __PACKAGE__, $VERSION;
401} 419}
402 420
403our %EXPORT_TAGS = ( 421our %EXPORT_TAGS = (
404 const_index => [qw( 422 const_index => [qw(
405 BER_CLASS BER_TAG BER_FLAGS BER_DATA 423 BER_CLASS BER_TAG BER_FLAGS BER_DATA
406 )], 424 )],
425 const_asn_class => [qw(
426 ASN_UNIVERSAL ASN_APPLICATION ASN_CONTEXT ASN_PRIVATE
427 )],
407 const_asn => [qw( 428 const_asn_tag => [qw(
408 ASN_BOOLEAN ASN_INTEGER ASN_BIT_STRING ASN_OCTET_STRING ASN_NULL ASN_OBJECT_IDENTIFIER 429 ASN_BOOLEAN ASN_INTEGER ASN_BIT_STRING ASN_OCTET_STRING ASN_NULL ASN_OID ASN_OBJECT_IDENTIFIER
409 ASN_OBJECT_DESCRIPTOR ASN_OID ASN_EXTERNAL ASN_REAL ASN_SEQUENCE ASN_ENUMERATED 430 ASN_OBJECT_DESCRIPTOR ASN_EXTERNAL ASN_REAL ASN_SEQUENCE ASN_ENUMERATED
410 ASN_EMBEDDED_PDV ASN_UTF8_STRING ASN_RELATIVE_OID ASN_SET ASN_NUMERIC_STRING 431 ASN_EMBEDDED_PDV ASN_UTF8_STRING ASN_RELATIVE_OID ASN_SET ASN_NUMERIC_STRING
411 ASN_PRINTABLE_STRING ASN_TELETEX_STRING ASN_T61_STRING ASN_VIDEOTEX_STRING ASN_IA5_STRING 432 ASN_PRINTABLE_STRING ASN_TELETEX_STRING ASN_T61_STRING ASN_VIDEOTEX_STRING ASN_IA5_STRING
412 ASN_ASCII_STRING ASN_UTC_TIME ASN_GENERALIZED_TIME ASN_GRAPHIC_STRING ASN_VISIBLE_STRING 433 ASN_ASCII_STRING ASN_UTC_TIME ASN_GENERALIZED_TIME ASN_GRAPHIC_STRING ASN_VISIBLE_STRING
413 ASN_ISO646_STRING ASN_GENERAL_STRING ASN_UNIVERSAL_STRING ASN_CHARACTER_STRING ASN_BMP_STRING 434 ASN_ISO646_STRING ASN_GENERAL_STRING ASN_UNIVERSAL_STRING ASN_CHARACTER_STRING ASN_BMP_STRING
414
415 ASN_UNIVERSAL ASN_APPLICATION ASN_CONTEXT ASN_PRIVATE
416 )], 435 )],
417 const_ber_type => [qw( 436 const_ber_type => [qw(
418 BER_TYPE_BYTES BER_TYPE_UTF8 BER_TYPE_UCS2 BER_TYPE_UCS4 BER_TYPE_INT 437 BER_TYPE_BYTES BER_TYPE_UTF8 BER_TYPE_UCS2 BER_TYPE_UCS4 BER_TYPE_INT
419 BER_TYPE_OID BER_TYPE_RELOID BER_TYPE_NULL BER_TYPE_BOOL BER_TYPE_REAL 438 BER_TYPE_OID BER_TYPE_RELOID BER_TYPE_NULL BER_TYPE_BOOL BER_TYPE_REAL
420 BER_TYPE_IPADDRESS BER_TYPE_CROAK 439 BER_TYPE_IPADDRESS BER_TYPE_CROAK
422 const_snmp => [qw( 441 const_snmp => [qw(
423 SNMP_IPADDRESS SNMP_COUNTER32 SNMP_GAUGE32 SNMP_UNSIGNED32 442 SNMP_IPADDRESS SNMP_COUNTER32 SNMP_GAUGE32 SNMP_UNSIGNED32
424 SNMP_TIMETICKS SNMP_OPAQUE SNMP_COUNTER64 443 SNMP_TIMETICKS SNMP_OPAQUE SNMP_COUNTER64
425 )], 444 )],
426 decode => [qw( 445 decode => [qw(
427 ber_decode 446 ber_decode ber_decode_prefix
428 ber_is ber_is_seq ber_is_int ber_is_oid 447 ber_is ber_is_seq ber_is_int ber_is_oid
448 ber_dump
429 )], 449 )],
430 encode => [qw( 450 encode => [qw(
431 ber_encode 451 ber_encode
432 ber_int 452 ber_int
433 )], 453 )],
434); 454);
435 455
436our @EXPORT_OK = map @$_, values %EXPORT_TAGS; 456our @EXPORT_OK = map @$_, values %EXPORT_TAGS;
437 457
438$EXPORT_TAGS{all} = \@EXPORT_OK; 458$EXPORT_TAGS{all} = \@EXPORT_OK;
459$EXPORT_TAGS{const_asn} = [map @{ $EXPORT_TAGS{$_} }, qw(const_asn_class const_asn_tag)];
439$EXPORT_TAGS{const} = [map @{ $EXPORT_TAGS{$_} }, qw(const_index const_asn)]; 460$EXPORT_TAGS{const} = [map @{ $EXPORT_TAGS{$_} }, qw(const_index const_asn)];
461
462our $DEFAULT_PROFILE = new Convert::BER::XS::Profile;
463
464$DEFAULT_PROFILE->_set_default;
465
466# additional SNMP application types
467our $SNMP_PROFILE = new Convert::BER::XS::Profile;
468
469$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_IPADDRESS , BER_TYPE_IPADDRESS);
470$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER32 , BER_TYPE_INT);
471$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_UNSIGNED32, BER_TYPE_INT);
472$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_TIMETICKS , BER_TYPE_INT);
473
474# decodes REAL values according to ECMA-63
475# this is pretty strict, except it doesn't catch -0.
476# I don't have access to ISO 6093 (or BS 6727, or ANSI X.3-42)), so this is all guesswork.
477sub _decode_real_decimal {
478 my ($format, $val) = @_;
479
480 $val =~ y/,/./; # probably not in ISO-6093
481
482 if ($format == 1) {
483 $val =~ /^ \ * [+-]? [0-9]+ \z/x
484 or Carp::croak "BER_TYPE_REAL NR1 value not in NR1 format ($val) (X.690 8.5.8)";
485 } elsif ($format == 2) {
486 $val =~ /^ \ * [+-]? (?: [0-9]+\.[0-9]* | [0-9]*\.[0-9]+ ) \z/x
487 or Carp::croak "BER_TYPE_REAL NR2 value not in NR2 format ($val) (X.690 8.5.8)";
488 } elsif ($format == 3) {
489 $val =~ /^ \ * [+-] (?: [0-9]+\.[0-9]* | [0-9]*\.[0-9]+ ) [eE] [+-]? [0-9]+ \z/x
490 or Carp::croak "BER_TYPE_REAL NR3 value not in NR3 format ($val) (X.690 8.5.8)";
491 } else {
492 Carp::croak "BER_TYPE_REAL invalid decimal numerical representation format $format";
493 }
494
495 $val
496}
497
498# this is a mess, but perl's support for floating point formatting is nearly nonexistant
499sub _encode_real_decimal {
500 my ($val, $nvdig) = @_;
501
502 $val = sprintf "%.*G", $nvdig + 1, $val;
503
504 if ($val =~ /E/) {
505 $val =~ s/E(?=[^+-])/E+/;
506 $val =~ s/E/.E/ if $val !~ /\./;
507 $val =~ s/^/+/ unless $val =~ /^-/;
508
509 return "\x03$val" # NR3
510 }
511
512 $val =~ /\./
513 ? "\x02$val" # NR2
514 : "\x01$val" # NR1
515}
516
517=head2 DEBUGGING
518
519To aid debugging, you can call the C<ber_dump> function to print a "nice"
520representation to STDOUT.
521
522=over
523
524=item ber_dump $tuple[, $profile[, $prefix]]
525
526In addition to specifying the BER C<$tuple> to dump, you can also specify
527a C<$profile> and a C<$prefix> string that is printed in front of each line.
528
529If C<$profile> is C<$Convert::BER::XS::SNMP_PROFILE>, then C<ber_dump>
530will try to improve its output for SNMP data.
531
532The output usually contains three columns, the "human readable" tag, the
533BER type used to decode it, and the data value.
534
535This function is somewhat slow and uses a number of heuristics and tricks,
536so it really is only suitable for debug prints.
537
538Example output:
539
540 SEQUENCE
541 | OCTET_STRING bytes 800063784300454045045400000001
542 | OCTET_STRING bytes
543 | CONTEXT (7) CONSTRUCTED
544 | | INTEGER int 1058588941
545 | | INTEGER int 0
546 | | INTEGER int 0
547 | | SEQUENCE
548 | | | SEQUENCE
549 | | | | OID oid 1.3.6.1.2.1.1.3.0
550 | | | | TIMETICKS int 638085796
551
552=back
553
554=cut
555
556# reverse enum, very slow and ugly hack
557sub _re {
558 my ($export_tag, $value) = @_;
559
560 for my $symbol (@{ $EXPORT_TAGS{$export_tag} }) {
561 $value == eval $symbol
562 and return $symbol;
563 }
564
565 "($value)"
566}
567
568$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER64 , BER_TYPE_INT);
569
570sub _ber_dump {
571 my ($ber, $profile, $indent) = @_;
572
573 if (my $seq = ber_is_seq $ber) {
574 printf "%sSEQUENCE\n", $indent;
575 &_ber_dump ($_, $profile, "$indent| ")
576 for @$seq;
577 } else {
578 my $asn = $ber->[BER_CLASS] == ASN_UNIVERSAL;
579
580 my $class = _re const_asn_class => $ber->[BER_CLASS];
581 my $tag = $asn ? _re const_asn_tag => $ber->[BER_TAG] : $ber->[BER_TAG];
582 my $type = _re const_ber_type => $profile->get ($ber->[BER_CLASS], $ber->[BER_TAG]);
583 my $data = $ber->[BER_DATA];
584
585 if ($profile == $SNMP_PROFILE and $ber->[BER_CLASS] == ASN_APPLICATION) {
586 $tag = _re const_snmp => $ber->[BER_TAG];
587 } elsif (!$asn) {
588 $tag = "$class ($tag)";
589 }
590
591 $class =~ s/^ASN_//;
592 $tag =~ s/^(ASN_|SNMP_)//;
593 $type =~ s/^BER_TYPE_//;
594
595 if ($ber->[BER_FLAGS]) {
596 printf "$indent%-16.16s\n", $tag;
597 &_ber_dump ($_, $profile, "$indent| ")
598 for @$data;
599 } else {
600 if ($data =~ y/\x20-\x7e//c / (length $data || 1) > 0.2 or $data =~ /\x00./s) {
601 # assume binary
602 $data = unpack "H*", $data;
603 } else {
604 $data =~ s/[^\x20-\x7e]/./g;
605 $data = "\"$data\"" if $tag =~ /string/i || !length $data;
606 }
607
608 substr $data, 40, 1e9, "..." if 40 < length $data;
609
610 printf "$indent%-16.16s %-6.6s %s\n", $tag, lc $type, $data;
611 }
612 }
613}
614
615sub ber_dump($;$$) {
616 _ber_dump $_[0], $_[1] || $DEFAULT_PROFILE, $_[2];
617}
440 618
441=head1 PROFILES 619=head1 PROFILES
442 620
443While any BER data can be correctly encoded and decoded out of the box, it 621While any BER data can be correctly encoded and decoded out of the box, it
444can be inconvenient to have to manually decode some values into a "better" 622can be inconvenient to have to manually decode some values into a "better"
505 683
506Returns the BER type mapped to the given C<$class>/C<$tag> combination. 684Returns the BER type mapped to the given C<$class>/C<$tag> combination.
507 685
508=back 686=back
509 687
510=head2 BER TYPES 688=head2 BER Types
511 689
512This lists the predefined BER types - you can map any C<CLASS>/C<TAG> 690This lists the predefined BER types. BER types are formatters used
513combination to any C<BER_TYPE_*>. 691internally to format and encode BER values. You can assign any C<BER_TYPE>
692to any C<CLASS>/C<TAG> combination tgo change how that tag is decoded or
693encoded.
514 694
515=over 695=over
516 696
517=item C<BER_TYPE_BYTES> 697=item C<BER_TYPE_BYTES>
518 698
547dot, e.g. C<1.3.6.1.213>. 727dot, e.g. C<1.3.6.1.213>.
548 728
549=item C<BER_TYPE_RELOID> 729=item C<BER_TYPE_RELOID>
550 730
551Same as C<BER_TYPE_OID> but uses relative object identifier 731Same as C<BER_TYPE_OID> but uses relative object identifier
552encoding: ASN.1 has this hack of encoding the first two OID components 732encoding: ASN.1 uses some hack encoding of the first two OID components
553into a single integer in a weird attempt to save an insignificant amount 733into a single integer in a weird attempt to save an insignificant amount
554of space in an otherwise wasteful encoding, and relative OIDs are 734of space in an otherwise wasteful encoding, and relative OIDs are
555basically OIDs without this hack. The practical difference is that the 735basically OIDs without this hack. The practical difference is that the
556second component of an OID can only have the values 1..40, while relative 736second component of an OID can only have the values 1..40, while relative
557OIDs do not have this restriction. 737OIDs do not have this restriction.
595 775
596 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_IPADDRESS , BER_TYPE_IPADDRESS); 776 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_IPADDRESS , BER_TYPE_IPADDRESS);
597 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER32 , BER_TYPE_INT); 777 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER32 , BER_TYPE_INT);
598 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_UNSIGNED32, BER_TYPE_INT); 778 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_UNSIGNED32, BER_TYPE_INT);
599 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_TIMETICKS , BER_TYPE_INT); 779 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_TIMETICKS , BER_TYPE_INT);
600 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_OPAQUE , BER_TYPE_IPADDRESS); 780 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_OPAQUE , BER_TYPE_BYTES);
601 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER64 , BER_TYPE_INT); 781 $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER64 , BER_TYPE_INT);
602 782
603=cut
604
605our $DEFAULT_PROFILE = new Convert::BER::XS::Profile;
606
607$DEFAULT_PROFILE->_set_default;
608
609# additional SNMP application types
610our $SNMP_PROFILE = new Convert::BER::XS::Profile;
611
612$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_IPADDRESS , BER_TYPE_IPADDRESS);
613$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER32 , BER_TYPE_INT);
614$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_UNSIGNED32, BER_TYPE_INT);
615$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_TIMETICKS , BER_TYPE_INT);
616$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_OPAQUE , BER_TYPE_IPADDRESS);
617$SNMP_PROFILE->set (ASN_APPLICATION, SNMP_COUNTER64 , BER_TYPE_INT);
618
6191;
620
621=head2 LIMITATIONS/NOTES 783=head2 LIMITATIONS/NOTES
622 784
623This module can only en-/decode 64 bit signed and unsigned integers, and 785This module can only en-/decode 64 bit signed and unsigned
624only when your perl supports those. 786integers/tags/lengths, and only when your perl supports those. So no UUID
787OIDs for now (unless you map the C<OBJECT IDENTIFIER> tag to something
788other than C<BER_TYPE_OID>).
625 789
626This module does not generally care about ranges, i.e. it will happily 790This module does not generally care about ranges, i.e. it will happily
627de-/encode 64 bit integers into an C<ASN_INTEGER> value, or a negative 791de-/encode 64 bit integers into an C<SNMP_UNSIGNED32> value, or a negative
628number into an C<SNMP_COUNTER64>. 792number into an C<SNMP_COUNTER64>.
629 793
630OBJECT IDENTIFIEERs cannot have unlimited length, although the limit is 794OBJECT IDENTIFIEERs cannot have unlimited length, although the limit is
631much larger than e.g. the one imposed by SNMP or other protocols,a nd is 795much larger than e.g. the one imposed by SNMP or other protocols, and is
632about 4kB. 796about 4kB.
633
634Indefinite length encoding is not supported.
635 797
636Constructed strings are decoded just fine, but there should be a way to 798Constructed strings are decoded just fine, but there should be a way to
637join them for convenience. 799join them for convenience.
638 800
639REAL values are not supported and will currently croak. 801REAL values will always be encoded in decimal form and ssometimes is
640 802forced into a perl "NV" type, potentially losing precision.
641The encoder and decoder tend to accept more formats than should be
642strictly supported.
643
644This module has undergone little to no testing so far.
645 803
646=head2 ITHREADS SUPPORT 804=head2 ITHREADS SUPPORT
647 805
648This module is unlikely to work when the (officially discouraged) ithreads 806This module is unlikely to work in any other than the loading thread when
649are in use. 807the (officially discouraged) ithreads are in use.
650 808
651=head1 AUTHOR 809=head1 AUTHOR
652 810
653 Marc Lehmann <schmorp@schmorp.de> 811 Marc Lehmann <schmorp@schmorp.de>
654 http://software.schmorp.de/pkg/Convert-BER-XS 812 http://software.schmorp.de/pkg/Convert-BER-XS
655 813
656=cut 814=cut
657 815
8161;
817

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines