net-snmp 3.27.0 → 3.28.1

package/.vscode/launch.json

@@ -1,249 +0,0 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP community get",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-get.js",
-            "args": ["-v", "2c", "-c", "public", "-s", "1162", "127.0.0.1", "1.3.6.1.2.1.31.1.1.1.6.1"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP user get",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-get.js",
-            "args": [
-                "-d",
-                "-v",
-                "3",
-                "-l",
-                "authPriv",
-                "-u",
-                "wilma",
-                "-a",
-                "sha",
-                "-A",
-                "illhavesomeauth",
-                "-x",
-                "des",
-                "-X",
-                "andsomepriv",
-                "127.0.0.1",
-                "1.3.6.1.2.1.1.1.0"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP community get bulk",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-get-bulk.js",
-            "args": ["-v", "2c", "-c", "public", "-o", "1", "-r", "20", "127.0.0.1", "1.3.6.1.2.1.1.9", "1.3.6.1.2.1.2"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP community subtree",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-subtree.js",
-            "args": ["-v", "2c", "-c", "public", "127.0.0.1", "1.3.6.1.6.3.16.1.5.2.1.6.9"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP community walk",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-walk.js",
-            "args": ["-v", "2c", "-c", "public", "127.0.0.1", "1.3.6.1.6.3.16.1.5.2.1.6.9"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP user walk",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-walk.js",
-            "args": ["-v", "3", "-u", "noauth", "-l", "noAuthNoPriv", "127.0.0.1", "1.3.6.1.6.3.16.1.5"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP community set",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-set.js",
-            "args": ["-v", "2c", "-c", "private", "127.0.0.1", "1.3.6.1.2.1.1.7.0", "Integer", "40"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP community trap",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-trap.js",
-            "args": ["-v", "2c", "-c", "public", "127.0.0.1", "1.3.6.1.6.3.1.1.5.1"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP user trap",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-trap.js",
-            "args": [
-                "-e",
-                "0x010203040a",
-                "-v",
-                "3",
-                "-u",
-                "barney",
-                "-l",
-                "authPriv",
-                "-a",
-                "sha",
-                "-A",
-                "illhavesomeauth",
-                "-x",
-                "aes",
-                "-X",
-                "andsomepriv",
-                "127.0.0.1",
-                "1.3.6.1.6.3.1.1.5.1"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP user inform",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-inform.js",
-            "args": [
-                "-v",
-                "3",
-                "-u",
-                "informerpriv",
-                "-l",
-                "authPriv",
-                "-a",
-                "md5",
-                "-A",
-                "testing123",
-                "-x",
-                "des",
-                "-X",
-                "testing123",
-                "127.0.0.1",
-                "1.3.6.1.6.3.1.1.5.1"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP user table columns",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-table-columns.js",
-            "args": [
-                "-v",
-                "3",
-                "-u",
-                "wilma",
-                "-l",
-                "authPriv",
-                "-a",
-                "sha",
-                "-A",
-                "illhavesomeauth",
-                "-x",
-                "des",
-                "-X",
-                "andsomepriv",
-                "127.0.0.1",
-                "1.3.6.1.2.1.2.2",
-                "2"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP receiver",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-receiver.js",
-            "args": ["-p", "162"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "Receiver LCD",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/receiver-lcd.js"
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "AgentX subagent",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/agentx-subagent.js",
-            "args": ["-d"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP agent",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-agent.js",
-            "args": [
-                //"-d",
-                "-p",
-                "1161"
-            ]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "MIB parser",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/mib-parser.js",
-            "args": ["-n", "-p", "1161"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "SNMP proxy",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/snmp-proxy.js",
-            "args": ["-p", "1161"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "test",
-            "skipFiles": ["<node_internals>/**"],
-            "program": "${workspaceFolder}/example/test.js",
-            "args": ["-p", "1161"]
-        },
-        {
-            "type": "node",
-            "request": "attach",
-            "name": "SNMP attach",
-            "port": 9222,
-            "skipFiles": ["<node_internals>/**"]
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "Mocha",
-            "program": "${workspaceFolder}/node_modules/mocha/bin/mocha.js",
-            "args": [
-                "--timeout",
-                "999999",
-                "--colors",
-                "${workspaceFolder}/test/**/*.test.js" // Adjust the test file pattern
-            ],
-            "internalConsoleOptions": "openOnSessionStart",
-            "cwd": "${workspaceFolder}",
-            "skipFiles": ["<node_internals>/**"]
-        }
-    ]
-}

package/eslint.config.js

@@ -1,98 +0,0 @@
-module.exports = [
-    {
-        files: ['**/*.js'],
-        languageOptions: {
-            ecmaVersion: 2020,
-            sourceType: 'module',
-            globals: {
-                // Browser globals
-                window: 'readonly',
-                document: 'readonly',
-                navigator: 'readonly',
-
-                // Node.js globals
-                require: 'readonly',
-                module: 'readonly',
-                process: 'readonly',
-                __dirname: 'readonly',
-                __filename: 'readonly',
-                console: 'readonly',
-                exports: 'readonly',
-                Buffer: 'readonly',
-                setInterval: 'readonly',
-                setTimeout: 'readonly',
-                clearInterval: 'readonly',
-                clearTimeout: 'readonly',
-                setImmediate: 'readonly',
-                clearImmediate: 'readonly',
-
-                // Mocha globals
-                describe: 'readonly',
-                it: 'readonly',
-                xit: 'readonly',
-                before: 'readonly',
-                after: 'readonly',
-                beforeEach: 'readonly',
-                afterEach: 'readonly',
-
-                // ES6 globals
-                Promise: 'readonly',
-                Set: 'readonly',
-                Map: 'readonly',
-
-                // User-defined globals
-                $: 'readonly',
-                System: 'readonly',
-                expect: 'readonly',
-            },
-        },
-        linterOptions: {
-            reportUnusedDisableDirectives: true,
-        },
-        rules: {
-            'accessor-pairs': 'error',
-            'arrow-spacing': 'error',
-            'brace-style': ['error', '1tbs', { allowSingleLine: true }],
-            camelcase: ['error', { properties: 'never' }],
-            'comma-spacing': ['error', { before: false, after: true }],
-            'eol-last': ['error', 'always'],
-            'key-spacing': ['error', { beforeColon: false, afterColon: true, mode: 'minimum' }],
-            'keyword-spacing': ['error', {}],
-            'no-cond-assign': 'error',
-            'no-console': ['off', { allow: ['warn', 'error'] }],
-            'no-constant-condition': ['error', { checkLoops: false }],
-            'no-eval': 'error',
-            'no-fallthrough': 'off',
-            'no-mixed-spaces-and-tabs': 'error',
-            'no-restricted-globals': ['error', 'event'],
-            'no-restricted-syntax': [
-                'error',
-                {
-                    selector:
-                        "*:not(ExpressionStatement) > CallExpression[callee.property.name='sort']:not([callee.object.type='CallExpression']):not([callee.object.type='ArrayExpression']):not([callee.object.name='mongoUtil'])",
-                    message:
-                        'Restricted Array Mutation: Use `array.slice().sort(...)` if mutation was not intended, otherwise place on own line.',
-                },
-                {
-                    selector:
-                        "*:not(ExpressionStatement) > CallExpression[callee.property.name='reverse']:not([callee.object.type='CallExpression']):not([callee.object.type='ArrayExpression'])",
-                    message:
-                        'Restricted Array Mutation: Use `array.slice().reverse(...)` if mutation was not intended, otherwise place on own line.',
-                },
-                {
-                    selector: "*:not(ExpressionStatement) > CallExpression[callee.property.name='push']",
-                    message:
-                        'Restricted Array Mutation: `array.push(...)` returns push count, not array reference, place statement on own line.',
-                },
-            ],
-            'no-undef': 'error',
-            'no-unused-expressions': 'error',
-            'no-unused-vars': ['error', { vars: 'all', args: 'none' }],
-            'no-useless-escape': 'off',
-            'no-with': 'error',
-            'padding-line-between-statements': ['error', { blankLine: 'always', prev: '*', next: 'function' }],
-            semi: ['error', 'always'],
-            'space-before-blocks': ['error', 'always'],
-        },
-    },
-];

package/example/test.js

@@ -1,70 +0,0 @@
-/* eslint-disable no-unused-vars */
-
-var snmp = require ("../");
-var getopts = require ("getopts");
-
-var options = getopts(process.argv.slice(2));
-var providers;
-var mibDir = '/var/tmp/mibs/';
-
-var counter64 = function (num) {
-    var buf = Buffer.alloc (4);
-    buf.writeUInt32BE (num);
-    return buf;
-};
-
-var snmpOptions = {
-    disableAuthorization: options.n,
-    port: options.p,
-    engineID: options.e,
-    debug: options.d
-};
-
-var callback = function (error, data) {
-    if ( error ) {
-        console.error (error);
-    } else {
-        console.log (data.pdu.varbinds[0].oid);
-    }
-};
-
-var store = snmp.createModuleStore ();
-var agent = snmp.createAgent (snmpOptions, callback);
-var mib = agent.getMib ();
-
-var authorizer = agent.getAuthorizer ();
-authorizer.addCommunity ("public");
-
-// IF-MIB load and providers registration
-store.loadFromFile (mibDir + "IANAifType-MIB.mib");
-store.loadFromFile (mibDir + "IF-MIB.mib");
-store.loadFromFile (mibDir + "HOST-RESOURCES-MIB.MIB");
-store.loadFromFile (mibDir + "IANA-PRINTER-MIB.mib");
-store.loadFromFile (mibDir + "IANA-CHARSET-MIB.mib");
-store.loadFromFile (mibDir + "PRINTER-MIBv1.mib");
-store.loadFromFile (mibDir + "JOB-MONITORING-MIB-RFC.mib");
-store.loadFromFile (mibDir + "NETSURE-MIB-001-B.mib");
-
-// const mibModuleOid = store.translate('1.3.6.1.4.1', snmp.OidFormat.module);
-// console.log('mibModuleOid: ', mibModuleOid);
-// const mibOid = store.translate('Job-Monitoring-MIB::jmJobTable', snmp.OidFormat.oid);
-// console.log('mibOid: ', mibOid);
-console.log(store.translate('Job-Monitoring-MIB::jmJobTable', snmp.OidFormat.oid));
-console.log(store.translate('Job-Monitoring-MIB::jmJobTable', snmp.OidFormat.path));
-console.log(store.translate('1.3.6.1.4.1.2699.1.1.1.3.1', snmp.OidFormat.path));
-console.log(store.translate('1.3.6.1.4.1.2699.1.1.1.3.1', snmp.OidFormat.module));
-console.log(store.translate('iso.org.dod.internet.private.enterprises.pwg.mibs.jobmonMIB.jobmonMIBObjects.jmJob.jmJobTable', snmp.OidFormat.oid));
-console.log(store.translate('iso.org.dod.internet.private.enterprises.pwg.mibs.jobmonMIB.jobmonMIBObjects.jmJob.jmJobTable', snmp.OidFormat.module));
-
-// ifNumber
-// Scalar type - setScalarValue() and getScalarValue() are the entire API for these
-
-// console.log("All modules: ", JSON.stringify(modules, '', 2));
-// const jobModule = store.getModule('Job-Monitoring-MIB');
-// console.log('jobModule: ', JSON.stringify(jobModule, null, 2));
-
-// print IF-MIB
-// const ifModule = store.getModule('IF-MIB');
-// console.log('ifModule: ', JSON.stringify(ifModule, null, 2));
-const nsModule = store.getModule('NETSURE-MIB-001-B');
-console.log('nsModule: ', JSON.stringify(nsModule, null, 2));

package/test/README-test-coverage.md

@@ -1,76 +0,0 @@
-# SNMPv3 Authentication Failure Handling Test Coverage (RFC 3414 §3.2)
-
-This document describes the test coverage added for PR #289 which implements RFC 3414 §3.2 compliant SNMPv3 authentication failure handling.
-
-## Test File: `snmpv3-auth-failures.test.js`
-
-### Coverage Areas
-
-#### 1. Report PDU Generation
-- ✅ Tests Report PDU creation with `UNKNOWN_USER_NAME` for unknown users
-- ✅ Tests Report PDU creation with `WRONG_DIGESTS` for authentication level mismatches  
-- ✅ Tests Report PDU creation with `UNKNOWN_ENGINE_ID` for discovery requests
-- ✅ Verifies original message ID preservation in Report PDUs
-- ✅ Validates correct security parameters in Report PDUs
-- ✅ Tests graceful handling of missing/invalid error types
-
-#### 2. USM Statistics Counter Compliance
-- ✅ Verifies correct USM statistics OIDs (`1.3.6.1.6.3.15.1.1.X.0`)
-- ✅ Tests proper Counter32 type and value (1) in varbinds
-- ✅ Maps all RFC 3414 error types to correct OID suffixes
-
-#### 3. Reportable Flag Handling
-- ✅ Tests reportable flag setting and retrieval
-- ✅ Validates message flag bit manipulation (bit 2 = reportable)
-
-#### 4. Integration Testing
-- ✅ Tests receiver/authorizer setup with known users
-- ✅ Validates integration with existing authentication framework
-
-#### 5. Edge Cases
-- ✅ Empty user name handling
-- ✅ Authentication parameters in messages
-- ✅ Privacy parameters in messages
-- ✅ Error type constant definitions
-
-### RFC 3414 §3.2 Compliance Verification
-
-The tests verify compliance with specific RFC 3414 requirements:
-
-| RFC Section | Requirement | Test Coverage |
-|------------|-------------|---------------|
-| §3.2 Step 4 | Use `usmStatsUnknownUserNames` for unknown users | ✅ |
-| §3.2 Step 5 | Use `usmStatsWrongDigests` for security level mismatches | ✅ |
-| Discovery | Use `usmStatsUnknownEngineIDs` for engine discovery | ✅ |
-| Report PDU | Include correct Counter32 OID and value | ✅ |
-| Message ID | Preserve original message ID in reports | ✅ |
-| Security | Use empty security parameters in reports | ✅ |
-
-### Test Strategy
-
-The tests use a mock-based approach since many internal classes (`UsmErrorType`, `Authorizer`, etc.) are not exported by the module. This approach:
-
-1. **Mirrors actual implementation** - Uses the same constants and logic as PR #289
-2. **Tests public interface** - Works with exported functions like `createReceiver`
-3. **Validates RFC compliance** - Ensures correct OID construction and counter values
-4. **Covers edge cases** - Tests error conditions and boundary cases
-
-### Usage
-
-Run the specific tests:
-```bash
-npm test -- --grep "SNMPv3 Authentication Failure Handling"
-```
-
-Run all tests to ensure no regressions:
-```bash
-npm test
-```
-
-### Benefits
-
-These tests provide:
-- **Regression prevention** - Catches changes that break RFC compliance
-- **Documentation** - Shows how the authentication failure handling works
-- **Quality assurance** - Ensures proper error reporting to SNMP managers
-- **Maintenance confidence** - Allows safe refactoring of authentication code