net-snmp 3.26.3 → 3.28.0

package/.claude/skills/publish-release/SKILL.md

@@ -1,68 +0,0 @@
----
-name: publish-release
-description: Publish the currently-committed release by pushing master to origin, publishing to npm, tagging the commit with the package.json version, and pushing the tag. Use when the user asks to "publish the release", "push and publish", or invokes /publish-release. Stops immediately on any failure.
----
-
-# Publish Release
-
-## When to use
-
-- After `/prepare-release` and the release commit have both been completed — this skill assumes the release commit (version bump + README entry + fix) is already `HEAD` on `master`.
-- User asks to publish / ship / release to npm.
-- User invokes `/publish-release`.
-
-Run after `/prepare-release` + `/git-commit`, never in place of them. This skill does not run lint, tests, or modify any files.
-
-## Workflow
-
-Run steps in order. **If any step fails, stop immediately, report the failure, and do not proceed.** There is no rollback — each step is externally observable (a push, a publish, a tag on origin), so a mid-flight failure leaves the release in a partial state the user will need to reason about. Be explicit about which steps succeeded and which did not.
-
-### 1. Pre-flight checks (parallel)
-
-- `git rev-parse --abbrev-ref HEAD` — confirm the current branch is `master`. If not, stop and ask the user.
-- `git status --short` — confirm the working tree is clean. If not, stop — the release commit must already exist as `HEAD`, with nothing else pending.
-- Read the current version from `package.json` (this becomes the tag name).
-- `git tag --list <version>` — confirm the tag does not already exist locally. If it does, stop.
-- `git ls-remote --tags origin refs/tags/<version>` — confirm the tag does not already exist on the remote. If it does, stop.
-- `git log -1 --format=%s` — capture the subject of the HEAD commit for the summary.
-
-### 2. Push master to origin
-
-Run `git push origin master`. **Stop on non-zero exit.** Report the output.
-
-### 3. Publish to npm
-
-Run `npm publish`. **Stop on non-zero exit.**
-
-Notes:
-- If the registry prompts for a one-time password (2FA OTP), relay the prompt to the user and wait for their input. Do not attempt to bypass 2FA.
-- If the registry rejects with `403` or `You do not have permission`, stop and surface the full error — the user may need to `npm login` or check their credentials.
-- If the registry rejects with `You cannot publish over the previously published versions`, stop — the version was not bumped correctly upstream of this skill.
-
-### 4. Tag the release
-
-Tags in this repo are bare version numbers (no `v` prefix) — verified against the existing tag list.
-
-Run `git tag <version>` where `<version>` is the exact value read from `package.json` in step 1 (e.g., `3.26.2`, not `v3.26.2`).
-
-**Stop on non-zero exit.**
-
-### 5. Push the tag
-
-Run `git push origin <version>`. **Stop on non-zero exit.**
-
-### 6. Summary
-
-Report to the user, concisely:
-- The version that was published.
-- Confirmation of: master pushed, npm publish succeeded, tag created, tag pushed.
-- The release commit subject (from pre-flight).
-- The npm package URL, if it can be derived from `package.json` name (`https://www.npmjs.com/package/<name>`).
-
-## Things to watch for
-
-- If step 2 (push master) succeeds but step 3 (npm publish) fails, the commit is on GitHub but not on npm. Do not tag — the user must either resolve the npm issue and re-run publish, or roll back the push.
-- If step 3 (npm publish) succeeds but step 4 (tag) or step 5 (tag push) fails, the package is on npm but not tagged. Surface this clearly — the user needs to manually create / push the tag, and an un-tagged published release is a fix-it-now situation, not something to leave for later.
-- Never use `--force`, `--no-verify`, or any flag that bypasses checks, even to recover from a mid-flight failure. Always ask the user.
-- Never create or push tags for versions other than the one in `package.json`.
-- Never run this skill on a branch other than `master` without explicit user confirmation.

package/.github/FUNDING.yml

@@ -1 +0,0 @@
-github: [markabrahams]

package/.travis.yml

@@ -1,13 +0,0 @@
-language: node_js
-node_js:
-  - lts/*
-  - 20
-  - 18
-  - 16
-  - 14
-  - 12
-  - 10
-  - 8
-
-script:
-  - npm run lint

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