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, unless
039: * an alternate (non-standard) port is suppied in the constructor.
040: */
041:
042: public class SNMPTrapSenderInterface {
043: public static final int SNMP_TRAP_PORT = 162;
044:
045: private int remotePort;
046: private DatagramSocket dSocket;
047:
048: /**
049: * Construct a new trap sender object to send traps to remote SNMP hosts.
050: */
051:
052: public SNMPTrapSenderInterface() throws SocketException {
053: this (SNMP_TRAP_PORT);
054: }
055:
056: /**
057: * Construct a new trap sender object to send traps to remote SNMP hosts, sending to
058: * the specified remote port.
059: */
060:
061: public SNMPTrapSenderInterface(int remotePort)
062: throws SocketException {
063: this .remotePort = remotePort;
064: dSocket = new DatagramSocket();
065: }
066:
067: /**
068: * Send the supplied SNMPv1 trap pdu to the specified host, using the supplied version number
069: * and community name. Use version = 0 for SNMP version 1, or version = 1 for enhanced
070: * capabilities provided through RFC 1157.
071: */
072:
073: public void sendTrap(int version, InetAddress hostAddress,
074: String community, SNMPv1TrapPDU pdu) throws IOException {
075: SNMPMessage message = new SNMPMessage(version, community, pdu);
076:
077: byte[] messageEncoding = message.getBEREncoding();
078:
079: /*
080: System.out.println("Request Message bytes:");
081:
082: for (int i = 0; i < messageEncoding.length; ++i)
083: System.out.print(hexByte(messageEncoding[i]) + " ");
084: */
085:
086: DatagramPacket outPacket = new DatagramPacket(messageEncoding,
087: messageEncoding.length, hostAddress, remotePort);
088:
089: /*
090: System.out.println("Message bytes length (out): " + outPacket.getLength());
091:
092: System.out.println("Message bytes (out):");
093: for (int i = 0; i < messageEncoding.length; ++i)
094: {
095: System.out.print(hexByte(messageEncoding[i]) + " ");
096: }
097: System.out.println("\n");
098: */
099:
100: dSocket.send(outPacket);
101:
102: }
103:
104: /**
105: * Send the supplied trap pdu to the specified host, using the supplied community name and
106: * using 0 for the version field in the SNMP message (corresponding to SNMP version 1).
107: */
108:
109: public void sendTrap(InetAddress hostAddress, String community,
110: SNMPv1TrapPDU pdu) throws IOException {
111: int version = 0;
112:
113: sendTrap(version, hostAddress, community, pdu);
114: }
115:
116: /**
117: * Send the supplied SNMPv2 trap pdu to the specified host, using the supplied version number
118: * and community name.
119: */
120:
121: public void sendTrap(int version, InetAddress hostAddress,
122: String community, SNMPv2TrapPDU pdu) throws IOException {
123: SNMPMessage message = new SNMPMessage(version, community, pdu);
124:
125: byte[] messageEncoding = message.getBEREncoding();
126:
127: /*
128: System.out.println("Request Message bytes:");
129:
130: for (int i = 0; i < messageEncoding.length; ++i)
131: System.out.print(hexByte(messageEncoding[i]) + " ");
132: */
133:
134: DatagramPacket outPacket = new DatagramPacket(messageEncoding,
135: messageEncoding.length, hostAddress, remotePort);
136:
137: /*
138: System.out.println("Message bytes length (out): " + outPacket.getLength());
139:
140: System.out.println("Message bytes (out):");
141: for (int i = 0; i < messageEncoding.length; ++i)
142: {
143: System.out.print(hexByte(messageEncoding[i]) + " ");
144: }
145: System.out.println("\n");
146: */
147:
148: dSocket.send(outPacket);
149:
150: }
151:
152: /**
153: * Send the supplied trap pdu to the specified host, using the supplied community name and
154: * using 1 for the version field in the SNMP message.
155: */
156:
157: public void sendTrap(InetAddress hostAddress, String community,
158: SNMPv2TrapPDU pdu) throws IOException {
159: int version = 1;
160:
161: sendTrap(version, hostAddress, community, pdu);
162: }
163:
164: private String hexByte(byte b) {
165: int pos = b;
166: if (pos < 0)
167: pos += 256;
168: String returnString = new String();
169: returnString += Integer.toHexString(pos / 16);
170: returnString += Integer.toHexString(pos % 16);
171: return returnString;
172: }
173:
174: private String getHex(byte theByte) {
175: int b = theByte;
176:
177: if (b < 0)
178: b += 256;
179:
180: String returnString = new String(Integer.toHexString(b));
181:
182: // add leading 0 if needed
183: if (returnString.length() % 2 == 1)
184: returnString = "0" + returnString;
185:
186: return returnString;
187: }
188:
189: }
|