{"record":{"id":"c3edefa5d2f88bb5","repo":"aeron-io/aeron","slug":"name-greater-than-max-size-of-maxvalue-value","errorCode":null,"errorMessage":"${name} greater than max size of ${maxValue}: ${value}","messagePattern":"(.+?) greater than max size of (.+?): (.+?)","errorType":"validation","errorClass":"ConfigurationException","httpStatus":null,"severity":"error","filePath":"aeron-driver/src/main/java/io/aeron/driver/Configuration.java","lineNumber":2669,"sourceCode":"     * @param srcAddress to be used for the identity.\n     * @return a source identity string for a given address.\n     */\n    public static String sourceIdentity(final InetSocketAddress srcAddress)\n    {\n        return srcAddress.getHostString() + ':' + srcAddress.getPort();\n    }\n\n    static void validateValueRange(final long value, final long minValue, final long maxValue, final String name)\n    {\n        if (value < minValue)\n        {\n            throw new ConfigurationException(\n                name + \" less than min size of \" + minValue + \": \" + value);\n        }\n\n        if (value > maxValue)\n        {\n            throw new ConfigurationException(\n                name + \" greater than max size of \" + maxValue + \": \" + value);\n        }\n    }\n}\n","sourceCodeStart":2651,"sourceCodeEnd":2674,"githubUrl":"https://github.com/aeron-io/aeron/blob/6d60124e15e35c11b49ba2e3c2c2858a09a18803/aeron-driver/src/main/java/io/aeron/driver/Configuration.java#L2651-L2674","documentation":"Generic upper-bound check in Aeron driver Configuration.validateValueRange: a named long configuration value exceeds its allowed maximum. Thrown as ConfigurationException during configuration validation.","triggerScenarios":"Any driver configuration value routed through validateValueRange set above its documented maximum, e.g. an oversized buffer length or window, via context setters or aeron.driver.* system properties.","commonSituations":"Developers set very large term buffer or file sizes (e.g. trying 1GB terms) exceeding Aeron's max limits, or unit mistakes like passing bytes where an already-byte value times 1024 is computed again.","solutions":["Lower the value to within the stated max in the message","Check the corresponding MAX_* constant in Configuration for the exact ceiling","Verify units (bytes vs KB/MB) to avoid accidental overflow of the limit"],"exampleFix":"// before\nctx.termBufferLength(4L * 1024 * 1024 * 1024); // exceeds max -> ConfigurationException\n// after\nctx.termBufferLength(1L * 1024 * 1024 * 1024); // within allowed range","handlingStrategy":"validation","validationCode":"if (value > Configuration.maxValueFor(name)) { throw new IllegalArgumentException(name + \" above maximum\"); } // or compare against the documented MAX_* constant","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Compare against Configuration's MAX_* constants before setting","Double-check byte/KB/MB units","Prefer defaults when unsure"],"tags":["configuration","validation","bounds","aeron-driver"],"backgroundTag":"value-out-of-range","analyzedSha":"6d60124e15e35c11b49ba2e3c2c2858a09a18803","analyzedAt":"2026-09-12T11:17:07.683Z","contentChangedAt":"2026-09-12T11:17:07.683Z","schemaVersion":2},"datasetVersion":"2026-09-15T23:17:13.987Z"}