{"Entry":{"collection":"guc","key":"ssl_library","name":"ssl_library","aliases":[],"metadata":{"baseline":false,"boot_human":"Not specified","boot_val":null,"category":"Preset Options","category_zh":"","changed_in":["14"],"changes":[{"documentation_changed":false,"fields":{},"from":"11","status":"added","to":"12"},{"documentation_changed":false,"fields":{"short_desc":{"from":"Name of the SSL library.","to":"Shows the name of the SSL library."}},"from":"13","status":"changed","to":"14"}],"content_hash":"e620387151a6c22b3f27d1002a654307c3053fbb95c768a9927180ef4d03e85d","context":"","default_changed_in":[],"default_history":[{"from":"12","to":"19","value":"OpenSSL"}],"editorial":{"advice":{"olap":"Not tunable. Use ssl_library to verify format, build, or resource assumptions on analytical nodes and keep every read/write candidate compatible.","oltp":"Not tunable. Record ssl_library as a deployment/capability fact; if it is unexpected, fix the binary, initdb, or database-creation process rather than trying SET.","small":"Not tunable. Preserve it in inventory and incident reports; do not custom-build or rebuild merely to change it without a demonstrated compatibility need."},"mechanism":["Shows the name of the SSL library. It is read-only and cannot be changed with SET or configuration-file edits.","It reports the SSL implementation linked into the server, which helps diagnose provider-specific TLS behavior.","Interpret it with server_version, server_version_num, server_encoding. Applications and operations tooling may read ssl_library for capability or environment detection, but cannot SET it; cross-cluster comparisons must account for build, initdb, and current-database differences."],"pitfalls":["Trying to change read-only ssl_library with SET or a configuration file.","Assuming every cluster, database, or vendor build reports the same value.","Ignoring the value in file-format or feature-compatibility checks.","Treating reported metadata as a performance target instead of an environment fact."],"references":[{"title":"PostgreSQL 19 Beta 4: ssl_library","url":"https://www.postgresql.org/docs/19/runtime-config-preset.html#GUC-SSL-LIBRARY"},{"title":"PostgreSQL 19 release notes","url":"https://www.postgresql.org/docs/19/release-19.html"}],"related":["server_version","server_version_num","server_encoding","integer_datetimes","debug_assertions","block_size"],"summary":"ssl_library shows the name of the SSL library. It is read-only metadata in PG12–18, not a runtime tuning control."},"enumvals":[],"first_version":"12","group":"Preset Options","group_slug":"preset","imported_at":"2026-09-27T17:57:32.024587+08:00","intro_commit":{"authored_at":"2018-06-26T10:19:35+02:00","discussion":[],"hash":"98efa76fe313f62f84b94cd1f46c913c221b41fe","subject":"Add ssl_library preset parameter","url":"https://git.postgresql.org/gitweb/?p=postgresql.git;a=commit;h=98efa76fe313f62f84b94cd1f46c913c221b41fe"},"key":"ssl_library","last_version":"20","max_val":"","min_val":"","name":"ssl_library","position":375,"present_in":["12","13","14","15","16","17","18","19","20"],"short_desc":"Reports the name of the SSL library that this PostgreSQL server was built with (even if SSL is not currently configured or in use on this instance), for example OpenSSL, or an empty string if none.","short_desc_zh":"","source_rev":"english-manuals:71fafbc8558ea84c9570193767258b5762ae216073c27369c5fa3c52b9f1e8d3","unit":"","vartype":"string"}},"Definition":{"Collection":"guc","Key":"ssl_library","SourceDatabase":"center","Version":"18","SourceTable":"guc","SourceKey":"ssl_library","SourceRevision":"english-manuals:71fafbc8558ea84c9570193767258b5762ae216073c27369c5fa3c52b9f1e8d3","Facts":{"boot_val":"OpenSSL","category":"Preset Options","context":"internal","description":"Reports the name of the SSL library that this PostgreSQL server was built with (even if SSL is not currently configured or in use on this instance), for example OpenSSL, or an empty string if none.","doc":{"anchor":"GUC-SSL-LIBRARY","file":"runtime-config-preset.html","lang":"en","sha256":"4dbfec727b9cee838adefb8a766217748d91ab90190b452a58cec737459582ce","slug":"18"},"documented":true,"enumvals":null,"extra_desc":null,"lang":"en","max_val":null,"metadata_version":"18","min_val":null,"name":"ssl_library","short_desc":"Shows the name of the SSL library.","source":"pg-settings-source-snapshot","unit":null,"vartype":"string"},"ManualEvidence":{"doc":{"anchor":"GUC-SSL-LIBRARY","file":"runtime-config-preset.html","lang":"en","sha256":"4dbfec727b9cee838adefb8a766217748d91ab90190b452a58cec737459582ce","slug":"18"}},"MeasuredEvidence":{"metadata_version":"18"}},"Text":{"Collection":"guc","Key":"ssl_library","SourceDatabase":"center","Version":"18","Locale":"en","Title":"ssl_library","Summary":"Reports the name of the SSL library that this PostgreSQL server was built with (even if SSL is not currently configured or in use on this instance), for example OpenSSL, or an empty string if none.","BodyHTML":"\u003cp\u003eReports the name of the SSL library that this PostgreSQL server was built with (even if SSL is not currently configured or in use on this instance), for example OpenSSL, or an empty string if none.\u003c/p\u003e","SourceRevision":"english-manuals:71fafbc8558ea84c9570193767258b5762ae216073c27369c5fa3c52b9f1e8d3","ContentHash":"1d17e82c9aa58f8cd26ea1662e6c3d06c089f192ec7faf97b94c7acb67f3ec0a","Payload":{"description":"Reports the name of the SSL library that this PostgreSQL server was built with (even if SSL is not currently configured or in use on this instance), for example OpenSSL, or an empty string if none."}},"RequestedLocale":"zh-Hans","Fallback":true,"Versions":["12","13","14","15","16","17","18","19","20"],"Locales":["en"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}