← Back to branch summary

~ubuntu-branches/ubuntu/wily/net-snmp/wily-proposed

« back to all changes in this revision

Viewing changes to README.win32

  • Committer: Bazaar Package Importer
  • Author(s): Chuck Short
  • Date: 2010-06-28 14:59:36 UTC
  • mfrom: (1.2.3 upstream) (1.1.12 sid)
  • Revision ID: james.westby@ubuntu.com-20100628145936-cbiallic69pn044g
Tags: 5.4.3~dfsg-1ubuntu1
https://launchpad.net/bugs/104738
https://launchpad.net/bugs/254261
https://launchpad.net/bugs/250459
https://launchpad.net/bugs/589056
https://launchpad.net/bugs/573391
https://launchpad.net/bugs/533603
* Merge from debian unstable.  Remaining changes:
  - Set Ubuntu maintainer address.
  - net-snmp-config: Use bash. (LP: #104738)
  - Removed multiuser option when calling update-rc.d. (LP: #254261)
  - debian/snmpd.init: LSBify the init script.
  - debian/patches/52_fix_snmpcmd_1_typo.patch: Adjust a typo in snmpcmd.1
    (LP: #250459)
  - debian/snmpd.postinst: source debconf before doing work, LP: #589056
  - debian/snmp.preinst, debian/snmp.prerm: kill any/all processes owned by
    snmp user before install/uninstall, LP: #573391
  - Add apport hook (LP: #533603):
  - debian/{snmp,snmpd}.apport: Added.
  - debian/control: Build-depends on dh-apport.
  - debian/rules: 
    + Add --with apport.
    + override_dh_apport to install hook on snmpd package only.
 * Dropped patches:
   - debian/patches/99-fix-ubuntu-div0.patch: Fix dvision by zero.. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.win32
70
70
 
71
71
  -  All Visual Studio project (.dsp) files are cleaned, and 
72
72
     a) Generate code to use Multi-Threaded DLL (/MD) "C" run-time library;
73
 
     b) Provide the same preprocesor defines (WIN32,_CONSOLE,_MBCS);
 
73
     b) Provide the same preprocessor defines (WIN32,_CONSOLE,_MBCS);
74
74
     c) Remove unnecessary references to GDI, ODBC, and "C" libraries;
75
75
     d) Debug versions build source browsing and debugging information;
76
76
     e) Provide consistent include search paths.
135
135
Limitations
136
136
-----------
137
137
 
138
 
- For an unknown reason, linkUp/Down generic traps are not received from the 
139
 
  Windows SNMP RFC1156Agent extension.  The DLL has an exported function called
140
 
  Mib2DLLEntry, but the use for this function is not known so this may or may 
141
 
  not be related.  Other extensions are able to send traps without any issues.
142
 
 
143
138
- When using HP Insight Agents, some parts of the enterprises.232 tree are not
144
139
  accessible.  The cause of this is not known.
145
140
 
146
 
- sysUpTime.0 does not report the correct uptime for the agent.  This is
147
 
  because the Windows extension checks for the uptime of the SNMP service,
148
 
  which is not running when Net-SNMP is running.
 
141
- When using winExtDLL, there is an offset of up to one second between the
 
142
  value of the sysUpTime varbind included in the traps generated by SNMP
 
143
  extension DLLs (e.g. linkUp and linkDown) and the value of the sysUpTime
 
144
  varbind included in traps generated by Net-SNMP itself (e.g. coldStart).
 
145
 
 
146
- When using winExtDLL, hrSystemUptime.0 reports the system uptime in thousands
 
147
  of a second instead of hundreds of a second. This is well known behavior of
 
148
  the Microsoft DLL that implements this MIB object. For more information,
 
149
  see also https://connect.microsoft.com/onecare/feedback/ViewFeedback.aspx?FeedbackID=504908.
149
150
 
150
151
 
151
152
Enabling the Windows SNMP extension agents
188
189
service and then run snmpd.exe from the command line with winExtDLL 
189
190
debugging enabled using (all on one line):
190
191
 
191
 
 snmpd.exe -I-udp,udpTable,tcp,tcpTable,icmp,ip,interfaces,system_mib,
 
192
 snmpd.exe -Lo -I-udp,udpTable,tcp,tcpTable,icmp,ip,interfaces,system_mib,
192
193
 sysORTable -DwinExtDLL
193
194
 
194
195
The Windows DLL snmpmib.dll (SNMPMIB) contains SNMP traffic statistics
234
235
Compiling Net-SNMP with the winExtDLL extension (MSVC)
235
236
------------------------------------------------------
236
237
 
237
 
Microsoft PSDK required.
 
238
When building with MSVC 6, the Microsoft Platform SDK is required.
238
239
 
239
240
Configure / nmake:
240
241
 
242
243
 
243
244
Workspace:
244
245
 
245
 
-modify win32\net-snmp\net-snmp-config.h and add:
 
246
-in file win32\net-snmp\net-snmp-config.h modify
 
247
 /* #undef USING_WINEXTDLL_MODULE */ into the following:
246
248
 #define USING_WINEXTDLL_MODULE 1
247
249
 
248
 
-modify win32\netsnmpmibssdk\netsnmpmibssdk.dsp:
249
 
 uncomment winExtDLL lines
250
 
 
251
 
 add to lines that contain # ADD LIB32 (line that contains iphlpapi.lib): 
252
 
  MgmtAPI.lib snmpapi.lib 
253
 
 
254
 
 add near the bottom of the file:
255
 
 
256
 
  # Begin Source File
257
 
 
258
 
  SOURCE=..\..\agent\mibgroup\winExtDLL.c
259
 
  # End Source File
260
 
 
261
 
 
262
 
-This extension requires the PSDK including the Snmp.h header file.
263
 
 Including Snmp.h will conflict with existing Net-SNMP defines for
264
 
 ASN_OCTETSTRING etc.  To resolve this, create a copy of Snmp.h in
265
 
 the PSDK include/ folder called Snmp-winExtDLL.h and change all
266
 
 occurances of ASN_ to MS_ASN_
267
 
 
268
250
 
269
251
***************************************************************************
270
252
*
281
263
default TCP/IP port of 162.
282
264
 
283
265
It is not a requirement to install the Net-SNMP agent (snmpd) or trap receiver
284
 
(snmptrapd).  All the command line utilties such as snmpget.exe, snmpset.exe 
 
266
(snmptrapd).  All the command line utilities such as snmpget.exe, snmpset.exe 
285
267
and the Perl modules will work without the Net-SNMP services.  All the 
286
268
utilities will work against any SNMP agent.
287
269
 
368
350
            The above will enable proxy, pass and pass_persist support.  See the
369
351
            snmpd man page for more information on the -I switch.
370
352
 
371
 
            If you are forwarding a section of the tree that is not immplemented
 
353
            If you are forwarding a section of the tree that is not implemented
372
354
            in Net-SNMP such as 'host', you do not need to use the -I switch as
373
355
            Net-SNMP will forward the request.  This may cause issues in the 
374
356
            future if newer versions of Net-SNMP implement the section of the
1296
1278
 
1297
1279
./configure \
1298
1280
        --with-mib-modules="host agentx disman/event-mib examples/example" \
1299
 
        --with-out-mib-modules=host/hr_network --with-libs="-lws2_32" \
 
1281
        --with-out-mib-modules=host/hr_network \
1300
1282
        --disable-embedded-perl --without-perl-modules \
1301
1283
 
1302
1284
If you want to use SNMPv3 auth and privacy features, add:
1378
1360
        --with-mib-modules="agentx disman/event-mib examples/example" \
1379
1361
        --disable-embedded-perl --without-perl-modules \
1380
1362
 
1381
 
    [Sorry. the host resources MIB is not supported by MinGW]
1382
 
 
 
1363
    Note: while the Net-SNMP implementation of the host resources MIB is not
 
1364
    supported when using MinGW, winExtDLL is supported. Via winExtDLL you can
 
1365
    use Microsoft's implementation of the host resources MIB.
1383
1366
 
1384
1367
4.1. If you want to use IPv6 transports, add:
1385
1368
        --enable-ipv6 --with-transports="TCPIPv6 UDPIPv6" \
1756
1739
 
1757
1740
David Perkins, Joe Marzot, Wes Hardaker, Niels Baggesen, Dave Shield,
1758
1741
Robert Story, Suvrit Sra, Mike Slifcak, Latha Prabhu, Nikolai Devereaux,
1759
 
Alex Burger, Bernhard Penz, and Andy Smith.
 
1742
Alex Burger, Bernhard Penz, Andy Smith and Bart Van Assche.
1760
1743