/usr/share/doc/python-pysnmp2/html/asn1.html is in python-pysnmp2 2.0.9-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 | <HTML>
<HEAD>
<TITLE>PySNMP: SNMP message: ASN.1</TITLE>
</HEAD>
<BODY BGCOLOR="#ffffff" TEXT="#000000"
LINK="#0000bb" VLINK="#551a8b" ALINK="#ff0000">
<H3>
SNMP subset of ASN.1 data types
</H3>
<P>
The <STRONG>pysnmp.asn1</STRONG> module implements a set of tools for
handling ASN.1 data types used in SNMP.
</P>
<P>
<DL>
<DT>class <STRONG>INTEGER</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>UNSIGNED32</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>TIMETICKS</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>COUNTER32</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>GAUGE32</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>COUNTER64</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>OPAQUE</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>OCTETSTRING</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>OBJECTID</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>IPADDRESS</STRONG>([<STRONG>value</STRONG>])</DT>
<DT>class <STRONG>NULL</STRONG>([<STRONG>value</STRONG>])</DT>
<DD>
<P>
Instances of these classes represent a value of corresponding ASN.1 type.
The optional <STRONG>value</STRONG> parameter may be used to assign an initial
value.
</P>
</DD>
</DL>
<DL>
<DT>def <STRONG>decode</STRONG>(<STRONG>data</STRONG>)</DT>
<DD>
<P>
The <STRONG>decode</STRONG> function takes an ASN.1 value carried in a
BER-encoded octet-stream <STRONG>data</STRONG>, and decodes it into
a asn1.* object of matching type.
</P>
<P>
A tuple of (<STRONG>asn1_object</STRONG>, <STRONG>rest</STRONG>) is
returned where <STRONG>asn1_object</STRONG> is an instance of one of asn1.py
classes, and the <STRONG>rest</STRONG> is the unprocessed part of input.
</P>
</DD>
</DL>
<DL>
<DT>exception <STRONG>Error</STRONG></DT>
<DD>
<P>
Exception raised on any error in the <STRONG>pysnmp.asn1</STRONG> module
and derivatives. The reason for the exception is passed to the constructor as
a string.
</P>
<P>
See documentation on the <A HREF="error.html">error.General</A> base class for
usage details.
</P>
</DD>
</DL>
<P>
The following exceptions are derived from this class:
</P>
<DL>
<DT>exception <STRONG>UnknownTag</STRONG></DT>
<DD>
<P>
Unknown BER tag passed to an asn1.* method occurred.
</P>
</DD>
</DL>
<DL>
<DT>exception <STRONG>OverFlow</STRONG></DT>
<DD>
<P>
Data item does not fit the BER octet-stream.
</P>
</DD>
</DL>
<DL>
<DT>exception <STRONG>UnderRun</STRONG></DT>
<DD>
<P>
Short BER octet-stream.
</P>
</DD>
</DL>
<DL>
<DT>exception <STRONG>BadEncoding</STRONG></DT>
<DD>
<P>
Malformed BER octet-stream.
</P>
</DD>
</DL>
<DL>
<DT>exception <STRONG>BadArgument</STRONG></DT>
<DD>
<P>
Inappropriate argument given.
</P>
</DD>
</DL>
<DL>
<DT>exception <STRONG>TypeError</STRONG></DT>
<DD>
<P>
Inappropriate type for an ASN.1 object value.
</P>
</DD>
</DL>
<HR><STRONG>Subsections</STRONG>
<P>
<UL>
<LI>Objects of the <A HREF="asn1-integer-objects.html">
<STRONG>asn1.INTEGER</STRONG>,
<STRONG>asn1.UNSIGNED32</STRONG>,
<STRONG>asn1.TIMETICKS</STRONG>,
<STRONG>asn1.COUNTER32</STRONG>,
<STRONG>asn1.COUNTER64</STRONG> and
<STRONG>asn1.GAUGE32</STRONG></A> classes.
<LI>Objects of the<A HREF="asn1-octetstring-objects.html">
<STRONG>OCTETSTRING</STRONG> and
<STRONG>OPAQUE</STRONG></A> classes.
<LI>Objects of the<A HREF="asn1-objectid-objects.html">
<STRONG>OBJECTID</STRONG></A> class.
<LI>Objects of the<A HREF="asn1-ipaddress-objects.html">
<STRONG>IPADDRESS</STRONG></A> class.
<LI>Objects of the<A HREF="asn1-null-objects.html">
<STRONG>NULL</STRONG></A> class.
</UL>
</P>
<HR>
<ADDRESS>
ilya@glas.net
</ADDRESS>
</BODY>
</HTML>
|