… | |
… | |
69 | |
69 | |
70 | my $buf = ber_encode $ber, $Convert::BER::XS::SNMP_PROFILE; |
70 | my $buf = ber_encode $ber, $Convert::BER::XS::SNMP_PROFILE; |
71 | |
71 | |
72 | =head1 DESCRIPTION |
72 | =head1 DESCRIPTION |
73 | |
73 | |
74 | WARNING: Before release 1.0, the API is not considered stable in any way. |
|
|
75 | |
|
|
76 | This module implements a I<very> low level BER/DER en-/decoder. |
74 | This module implements a I<very> low level BER/DER en-/decoder. |
77 | |
75 | |
78 | It is tuned for low memory and high speed, while still maintaining some |
76 | It is tuned for low memory and high speed, while still maintaining some |
79 | level of user-friendlyness. |
77 | level of user-friendlyness. |
80 | |
78 | |
… | |
… | |
414 | use Carp (); |
412 | use Carp (); |
415 | |
413 | |
416 | our $VERSION; |
414 | our $VERSION; |
417 | |
415 | |
418 | BEGIN { |
416 | BEGIN { |
419 | $VERSION = 1.2; |
417 | $VERSION = 1.21; |
420 | XSLoader::load __PACKAGE__, $VERSION; |
418 | XSLoader::load __PACKAGE__, $VERSION; |
421 | } |
419 | } |
422 | |
420 | |
423 | our %EXPORT_TAGS = ( |
421 | our %EXPORT_TAGS = ( |
424 | const_index => [qw( |
422 | const_index => [qw( |
… | |
… | |
473 | $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_UNSIGNED32, BER_TYPE_INT); |
471 | $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_UNSIGNED32, BER_TYPE_INT); |
474 | $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_TIMETICKS , BER_TYPE_INT); |
472 | $SNMP_PROFILE->set (ASN_APPLICATION, SNMP_TIMETICKS , BER_TYPE_INT); |
475 | |
473 | |
476 | # decodes REAL values according to ECMA-63 |
474 | # decodes REAL values according to ECMA-63 |
477 | # this is pretty strict, except it doesn't catch -0. |
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. |
478 | sub _decode_real_decimal { |
477 | sub _decode_real_decimal { |
479 | my ($format, $val) = @_; |
478 | my ($format, $val) = @_; |
480 | |
479 | |
481 | $val =~ y/,/./; |
480 | $val =~ y/,/./; # probably not in ISO-6093 |
482 | |
481 | |
483 | if ($format == 1) { |
482 | if ($format == 1) { |
484 | $val =~ /^ \ * [+-]? [0-9]+ \z/x |
483 | $val =~ /^ \ * [+-]? [0-9]+ \z/x |
485 | or Carp::croak "BER_TYPE_REAL NR1 value not in NR1 format ($val) (X.690 8.5.8, ECMA-63)"; |
484 | or Carp::croak "BER_TYPE_REAL NR1 value not in NR1 format ($val) (X.690 8.5.8)"; |
486 | } elsif ($format == 2) { |
485 | } elsif ($format == 2) { |
487 | $val =~ /^ \ * [+-]? (?: [0-9]+\.[0-9]* | [0-9]*\.[0-9]+ ) \z/x |
486 | $val =~ /^ \ * [+-]? (?: [0-9]+\.[0-9]* | [0-9]*\.[0-9]+ ) \z/x |
488 | or Carp::croak "BER_TYPE_REAL NR2 value not in NR2 format ($val) (X.690 8.5.8, ECMA-63)"; |
487 | or Carp::croak "BER_TYPE_REAL NR2 value not in NR2 format ($val) (X.690 8.5.8)"; |
489 | } elsif ($format == 3) { |
488 | } elsif ($format == 3) { |
490 | $val =~ /^ \ * [+-] (?: [0-9]+\.[0-9]* | [0-9]*\.[0-9]+ ) E [+-][0-9]+ \z/x |
489 | $val =~ /^ \ * [+-] (?: [0-9]+\.[0-9]* | [0-9]*\.[0-9]+ ) [eE] [+-]? [0-9]+ \z/x |
491 | or Carp::croak "BER_TYPE_REAL NR3 value not in NR3 format ($val) (X.690 8.5.8, ECMA-63)"; |
490 | or Carp::croak "BER_TYPE_REAL NR3 value not in NR3 format ($val) (X.690 8.5.8)"; |
492 | } else { |
491 | } else { |
493 | Carp::croak "BER_TYPE_REAL illegal decimal numerical representation format $format"; |
492 | Carp::croak "BER_TYPE_REAL invalid decimal numerical representation format $format"; |
494 | } |
493 | } |
495 | |
494 | |
496 | $val |
495 | $val |
497 | } |
496 | } |
498 | |
497 | |
… | |
… | |
728 | dot, e.g. C<1.3.6.1.213>. |
727 | dot, e.g. C<1.3.6.1.213>. |
729 | |
728 | |
730 | =item C<BER_TYPE_RELOID> |
729 | =item C<BER_TYPE_RELOID> |
731 | |
730 | |
732 | Same as C<BER_TYPE_OID> but uses relative object identifier |
731 | Same as C<BER_TYPE_OID> but uses relative object identifier |
733 | encoding: ASN.1 has this hack of encoding the first two OID components |
732 | encoding: ASN.1 uses some hack encoding of the first two OID components |
734 | into a single integer in a weird attempt to save an insignificant amount |
733 | into a single integer in a weird attempt to save an insignificant amount |
735 | of space in an otherwise wasteful encoding, and relative OIDs are |
734 | of space in an otherwise wasteful encoding, and relative OIDs are |
736 | basically OIDs without this hack. The practical difference is that the |
735 | basically OIDs without this hack. The practical difference is that the |
737 | second component of an OID can only have the values 1..40, while relative |
736 | second component of an OID can only have the values 1..40, while relative |
738 | OIDs do not have this restriction. |
737 | OIDs do not have this restriction. |