001: /*
002: * SNMP Package
003: *
004: * Copyright (C) 2004, Jonathan Sevy <jsevy@mcs.drexel.edu>
005: *
006: * This is free software. Redistribution and use in source and binary forms, with
007: * or without modification, are permitted provided that the following conditions
008: * are met:
009: *
010: * 1. Redistributions of source code must retain the above copyright notice, this
011: * list of conditions and the following disclaimer.
012: * 2. Redistributions in binary form must reproduce the above copyright notice,
013: * this list of conditions and the following disclaimer in the documentation
014: * and/or other materials provided with the distribution.
015: * 3. The name of the author may not be used to endorse or promote products
016: * derived from this software without specific prior written permission.
017: *
018: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
019: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
020: * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
021: * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
022: * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
023: * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
024: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
025: * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
026: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
027: *
028: */
029:
030: package snmp;
031:
032: import java.io.*;
033: import java.net.*;
034:
035: /**
036: * The class SNMPTrapSenderInterface implements an interface for sending SNMPv1 and SNMPv2 trap messages to a
037: * remote SNMP manager. The approach is that from version 1 of SNMP, using no encryption of data.
038: * Communication occurs via UDP, using port 162, the standard SNMP trap port, as the destination port.
039: */
040:
041: public class SNMPTrapSenderInterface {
042: public static final int SNMP_TRAP_PORT = 162;
043:
044: private DatagramSocket dSocket;
045:
046: /**
047: * Construct a new trap sender object to send traps to remote SNMP hosts.
048: */
049:
050: public SNMPTrapSenderInterface() throws SocketException {
051: dSocket = new DatagramSocket();
052: }
053:
054: /**
055: * Construct a new trap sender object to send traps to remote SNMP hosts, binding to
056: * the specified local port.
057: */
058:
059: public SNMPTrapSenderInterface(int localPort)
060: throws SocketException {
061: dSocket = new DatagramSocket(localPort);
062: }
063:
064: /**
065: * Send the supplied SNMPv1 trap pdu to the specified host, using the supplied version number
066: * and community name. Use version = 0 for SNMP version 1, or version = 1 for enhanced
067: * capabilities provided through RFC 1157.
068: */
069:
070: public void sendTrap(int version, InetAddress hostAddress,
071: String community, SNMPv1TrapPDU pdu) throws IOException {
072: SNMPMessage message = new SNMPMessage(version, community, pdu);
073:
074: byte[] messageEncoding = message.getBEREncoding();
075:
076: /*
077: System.out.println("Request Message bytes:");
078:
079: for (int i = 0; i < messageEncoding.length; ++i)
080: System.out.print(hexByte(messageEncoding[i]) + " ");
081: */
082:
083: DatagramPacket outPacket = new DatagramPacket(messageEncoding,
084: messageEncoding.length, hostAddress, SNMP_TRAP_PORT);
085:
086: /*
087: System.out.println("Message bytes length (out): " + outPacket.getLength());
088:
089: System.out.println("Message bytes (out):");
090: for (int i = 0; i < messageEncoding.length; ++i)
091: {
092: System.out.print(hexByte(messageEncoding[i]) + " ");
093: }
094: System.out.println("\n");
095: */
096:
097: dSocket.send(outPacket);
098:
099: }
100:
101: /**
102: * Send the supplied trap pdu to the specified host, using the supplied community name and
103: * using 0 for the version field in the SNMP message (corresponding to SNMP version 1).
104: */
105:
106: public void sendTrap(InetAddress hostAddress, String community,
107: SNMPv1TrapPDU pdu) throws IOException {
108: int version = 0;
109:
110: sendTrap(version, hostAddress, community, pdu);
111: }
112:
113: /**
114: * Send the supplied SNMPv2 trap pdu to the specified host, using the supplied version number
115: * and community name.
116: */
117:
118: public void sendTrap(int version, InetAddress hostAddress,
119: String community, SNMPv2TrapPDU pdu) throws IOException {
120: SNMPMessage message = new SNMPMessage(version, community, pdu);
121:
122: byte[] messageEncoding = message.getBEREncoding();
123:
124: /*
125: System.out.println("Request Message bytes:");
126:
127: for (int i = 0; i < messageEncoding.length; ++i)
128: System.out.print(hexByte(messageEncoding[i]) + " ");
129: */
130:
131: DatagramPacket outPacket = new DatagramPacket(messageEncoding,
132: messageEncoding.length, hostAddress, SNMP_TRAP_PORT);
133:
134: /*
135: System.out.println("Message bytes length (out): " + outPacket.getLength());
136:
137: System.out.println("Message bytes (out):");
138: for (int i = 0; i < messageEncoding.length; ++i)
139: {
140: System.out.print(hexByte(messageEncoding[i]) + " ");
141: }
142: System.out.println("\n");
143: */
144:
145: dSocket.send(outPacket);
146:
147: }
148:
149: /**
150: * Send the supplied trap pdu to the specified host, using the supplied community name and
151: * using 1 for the version field in the SNMP message.
152: */
153:
154: public void sendTrap(InetAddress hostAddress, String community,
155: SNMPv2TrapPDU pdu) throws IOException {
156: int version = 1;
157:
158: sendTrap(version, hostAddress, community, pdu);
159: }
160:
161: private String hexByte(byte b) {
162: int pos = b;
163: if (pos < 0)
164: pos += 256;
165: String returnString = new String();
166: returnString += Integer.toHexString(pos / 16);
167: returnString += Integer.toHexString(pos % 16);
168: return returnString;
169: }
170:
171: private String getHex(byte theByte) {
172: int b = theByte;
173:
174: if (b < 0)
175: b += 256;
176:
177: String returnString = new String(Integer.toHexString(b));
178:
179: // add leading 0 if needed
180: if (returnString.length() % 2 == 1)
181: returnString = "0" + returnString;
182:
183: return returnString;
184: }
185:
186: }
|