snmp_api.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 1996-2017 The Squid Software Foundation and contributors
3  *
4  * Squid software is distributed under GPLv2+ license and includes
5  * contributions from numerous individuals and organizations.
6  * Please see the COPYING and CONTRIBUTORS files for details.
7  */
8 
9 /**********************************************************************
10  *
11  * Copyright 1997 by Carnegie Mellon University
12  *
13  * All Rights Reserved
14  *
15  * Permission to use, copy, modify, and distribute this software and its
16  * documentation for any purpose and without fee is hereby granted,
17  * provided that the above copyright notice appear in all copies and that
18  * both that copyright notice and this permission notice appear in
19  * supporting documentation, and that the name of CMU not be
20  * used in advertising or publicity pertaining to distribution of the
21  * software without specific, written prior permission.
22  *
23  * CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
24  * ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
25  * CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
26  * ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
27  * WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
28  * ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
29  * SOFTWARE.
30  *
31  **********************************************************************/
32 
33 #include "squid.h"
34 
35 #if HAVE_UNISTD_H
36 #include <unistd.h>
37 #endif
38 #if HAVE_STDLIB_H
39 #include <stdlib.h>
40 #endif
41 #if HAVE_SYS_TYPES_H
42 #include <sys/types.h>
43 #endif
44 #if HAVE_CTYPE_H
45 #include <ctype.h>
46 #endif
47 #if HAVE_GNUMALLOC_H
48 #include <gnumalloc.h>
49 #elif HAVE_MALLOC_H
50 #include <malloc.h>
51 #endif
52 #if HAVE_MEMORY_H
53 #include <memory.h>
54 #endif
55 #if HAVE_STRING_H
56 #include <string.h>
57 #endif
58 #if HAVE_STRINGS_H
59 #include <strings.h>
60 #endif
61 #if HAVE_BSTRING_H
62 #include <bstring.h>
63 #endif
64 #if HAVE_SYS_SOCKET_H
65 #include <sys/socket.h>
66 #endif
67 #if HAVE_NETINET_IN_H
68 #include <netinet/in.h>
69 #endif
70 #if HAVE_ARPA_INET_H
71 #include <arpa/inet.h>
72 #endif
73 #if HAVE_SYS_TIME_H
74 #include <sys/time.h>
75 #endif
76 #if HAVE_NETDB_H
77 #include <netdb.h>
78 #endif
79 
80 #include "asn1.h"
81 #include "snmp.h"
82 
83 #include "snmp-internal.h"
84 #include "snmp_error.h"
85 #include "snmp_impl.h"
86 #include "snmp_msg.h"
87 #include "snmp_pdu.h"
88 #include "snmp_session.h"
89 #include "snmp_vars.h"
90 
91 #include "snmp_api.h"
92 #include "snmp_api_error.h"
93 #include "snmp_api_util.h"
94 
95 #include "util.h"
96 
97 /**********************************************************************/
98 
99 /*
100  * Takes a session and a pdu and serializes the ASN PDU into the area
101  * pointed to by packet. out_length is the size of the data area available.
102  * Returns the length of the encoded packet in out_length. If an error
103  * occurs, -1 is returned. If all goes well, 0 is returned.
104  */
105 int
106 snmp_build(session, pdu, packet, out_length)
107 struct snmp_session *session;
108 struct snmp_pdu *pdu;
109 u_char *packet;
110 int *out_length;
111 {
112  u_char *bufp;
113 
114  bufp = snmp_msg_Encode(packet, out_length,
115  session->community, session->community_len,
116  session->Version,
117  pdu);
118  snmplib_debug(8, "LIBSNMP: snmp_build(): Packet len %d (requid %d)\n",
119  *out_length, pdu->reqid);
120 
121  if (bufp == NULL)
122  return (-1);
123 
124  return (0);
125 }
126 
127 /*
128  * Parses the packet received on the input session, and places the data into
129  * the input pdu. length is the length of the input packet. If any errors
130  * are encountered, NULL is returned. If not, the community is.
131  */
132 u_char *
133 snmp_parse(struct snmp_session * session,
134  struct snmp_pdu * pdu,
135  u_char * data,
136  int length)
137 {
138  u_char Community[128];
139  u_char *bufp;
140  int CommunityLen = 128;
141 
142  /* Decode the entire message. */
143  data = snmp_msg_Decode(data, &length,
144  Community, &CommunityLen,
145  &session->Version, pdu);
146  if (data == NULL)
147  return (NULL);
148 
149  bufp = (u_char *) xmalloc(CommunityLen + 1);
150  if (bufp == NULL)
151  return (NULL);
152 
153  strncpy((char *) bufp, (char *) Community, CommunityLen);
154  bufp[CommunityLen] = '\0';
155 
156  session->community = bufp;
157  session->community_len = CommunityLen;
158 
159  return (bufp);
160 }
161 
SQUIDCEXTERN void snmplib_debug(int, const char *,...) PRINTF_FORMAT_ARG2
Definition: snmplib_debug.c:21
u_char * snmp_msg_Decode(u_char *, int *, u_char *, int *, int *, struct snmp_pdu *)
Definition: snmp_msg.c:252
u_char * snmp_msg_Encode(u_char *, int *, u_char *, int, int, struct snmp_pdu *)
Definition: snmp_msg.c:133
void const char HLPCB void * data
Definition: stub_helper.cc:16
u_char * snmp_parse(struct snmp_session *session, struct snmp_pdu *pdu, u_char *data, int length)
Definition: snmp_api.c:133
#define xmalloc
int snmp_build(struct snmp_session *session, struct snmp_pdu *pdu, u_char *packet, int *out_length)
Definition: snmp_api.c:106
u_char * community
Definition: snmp_session.h:39
int reqid
Definition: snmp_pdu.h:54
#define NULL
Definition: types.h:166

 

Introduction

Documentation

Support

Miscellaneous

Web Site Translations

Mirrors